PR #4526 需要维护者确认：iOS Simulator 跨任务工程构建的架构边界

[MagicLizi]

PR：#4526
Head：e0457363dcc2b784b6ef6f6379da8c75ada9f872
作者：horizon554

这次改了什么

内嵌 iOS Simulator 的 build_app 新增可选 projectDir：任务 A 可显式指定外部工程 / worktree B 来构建，再用 A 的设备安装、启动和调试。省略参数时仍用当前任务目录。构建缓存、artifact 来源和 Cindy Mobile Metro 检查切到所选目录；任务身份、设备 route、控制授权和 artifact 实例归属仍属于 A。托管 worktree 复用现有 runtime lease，回收或任务取消时终止操作。

为何需要维护者确认（arch）

这不是同结构内的实现替换。

1. 跨包 MCP / 数据契约：packages/lizi-mcps 的 build_app 增加 projectDir；Host artifact 新增 project 摘要（目录名、目录 fingerprint、相对 container 路径）。旧 Host 会拒绝不认识的参数，配套插件 Manual 仍是 draft。
2. 模块边界：Host 构建路径接到 worktree runtime lease / recycle 事件，把模拟器构建与托管 worktree 回收协调绑在一起。
3. 权限半径：构建来源从“当前任务目录”扩大到用户明确指定的任意本地目录（仍走现有任务执行权限，不是新的文件系统沙箱）。

请维护者直接在 PR 上 Approve；若需要作者修改，请 Request Changes。

产品门（不 hold）

product 因标题 feat 触发，但 Renderer 只改了既有静态契约测试的格式匹配，touchesUi=false，没有外观、布局、文案或交互流向变化。用户可见的是 Agent/MCP 可选参数，不是产品 UI。

建议核对

• 省略 projectDir 是否完全保持原行为。
• 外部目录是否只改构建来源，不转移任务 / 设备所有权。
• containerPath 是否仍限制在所选工程内。
• 租约是否只保护托管 worktree，并在源目录 I/O 结束后释放。
• 配套插件 Manual 的发布顺序是否可接受。

---

关联 PR:#4526(作者 @horizon554);本 issue 由 review-pr 流程自动创建,用于先讨论该 PR 涉及的技术架构调整,维护者确认后 PR 会恢复推进。

[dash-s-cindy]

判断：该变更值得推进，建议维护者在 #4526 Approve；不需要因 Renderer/UI 产品门禁阻塞。它为内嵌 iOS Simulator 的 build_app 增加可选 projectDir，使任务 A 可以明确选择外部工程或 worktree B 构建，再使用 A 的模拟器完成安装、启动和调试。省略参数时仍使用 A 的工作目录，核心用户价值和兼容性边界清晰。

进一步检查发现，当前 main 快照 40f087c99c849e93af97363d0e874531e97781fc 尚未包含该能力（源码搜索未发现 packages/lizi-mcps 中的 build_app.projectDir 实现），因此 #4526 确实是待合入的新能力，而不是已发布修复或重复报告。

证据与边界

• MCP/Host 契约新增可选 projectDir，artifact 增加工程摘要；这是跨包契约变更，但调用方省略参数时保持原行为。
• PR 描述的实现边界是：构建缓存、artifact 来源和 Cindy Mobile Metro 检查使用所选工程 B；任务身份、设备 route、控制授权和 artifact 实例归属仍属于 A。PR 明确不切换任务目录、不转移设备所有权、不支持外部 Simulator.app 工作流，也不新增文件系统沙箱。
• 路径按 realpath 解析；containerPath 必须位于所选工程内。PR 回归覆盖绝对/相对目录、非法目录、软链接别名缓存复用和 container 越界。
• 托管 worktree 使用既有 runtime lease 和回收协调；PR 声明不会把 B 纳入 A 的目录删除范围，并在源目录 I/O 完成后释放租约。共享 B 的构建互斥、回收和取消顺序均有测试覆盖。
• PR 报告 pnpm test:unit:related 通过，Host/MCP/授权定向测试 188 项通过，另有 19 项源码契约测试通过；错误参数、缺失调用、错误顺序等反例被拒绝。未完成的验证包括真实 Host/MCP 的 Xcode 构建、内嵌 viewer、安装和启动验收，Windows 也未在本地实跑。
• 该能力扩大了构建来源：用户明确指定的本地目录仍以现有任务执行权限运行，Xcode build scripts 继续使用当前 macOS 用户身份，不能将其表述为新的文件系统隔离能力。这是应在文档和发布说明中明确的权限事实，而不是当前必须收窄行为的理由。

PR 早期 Greptile 审查曾指出：托管 worktree 资源锁等待无法及时响应取消，可能使任务取消或 Host dispose 延迟至锁超时。当前 PR head 已补充 7 项取消回归，覆盖资源锁竞争、预先取消、刚取得锁和超时边界，并声称该问题已修复。合并前应确认最新 CI/代码 review 确实针对 head e0457363dcc2b784b6ef6f6379da8c75ada9f872 验证了取消优先、锁释放和不继续构建；无需据此另行扩大架构范围。

建议行动

1. 维护者在 #4526 Approve，允许 PR 继续自动审查和合并；本 Issue 的架构确认目的已满足。
2. 合并前确认最新 CI、相关单测/typecheck、DCO 和 diff 检查；重点复核默认 A、显式 B、再次省略回到 A，以及取消/回收期间的租约释放。
3. 合并后补做一次真实 macOS Host/MCP/Xcode smoke：外部 .xcodeproj/.xcworkspace 构建、artifact 返回、安装、启动、调试，以及任务 A/B 归属和 container 越界失败路径。PR 当前仅以 mock/CoreSimulator 单测证明这些边界，不能替代真实验收。
4. 依赖发布按 PR 记录的顺序执行：先发布包含该 Host 能力的稳定版，再对配套插件 Manual PR makecindy/cindy-official-plugins#114 做实机验收和发布。旧 Host 会拒绝未知参数，因此不应让插件 Manual 先于 Host 能力进入可用发布渠道。

相关记录

• #2899：已建立当前 iOS Simulator 构建的规范化 worktree 缓存、不可变 artifact 生命周期、回收和租约相关基础；feat(ios-simulator): 支持在当前任务构建外部工程和 worktree #4526 在该边界上增加可选外部工程来源，并复用既有生命周期机制。
• #2958：此前对 perf(ios-simulator): 构建链路优化（arch 预检 + 缓存复用 + 回收） #2899 的架构确认记录，说明该模块对构建缓存、回收和生命周期调整采用维护者显式确认流程；可作为本次确认方式的直接先例。
• #2494：涉及 iOS Simulator Host 资源释放、租约和 capability teardown 的既有工作；与本 PR 不同，但支持“资源所有权和清理必须保持在 Host 生命周期边界内”的设计方向。

[MagicLizi]

维护者确认已通过,讨论结束,PR 恢复正常推进。关联 PR:#4526(https://github.com/makecindy/cindy/pull/4526)。本 issue 由 review-pr 流程自动关闭。