@moretea-labs/forge 1.6.0 → 1.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (469) hide show
  1. package/AGENTS.md +4 -0
  2. package/CHANGELOG.md +39 -0
  3. package/CLAUDE.md +4 -0
  4. package/README.md +2 -2
  5. package/README.zh-CN.md +1 -1
  6. package/SKILL.md +2 -2
  7. package/THIRD_PARTY_NOTICES.md +1 -1
  8. package/agents/openai.yaml +1 -1
  9. package/assets/hooks/hook-input.sh +11 -8
  10. package/assets/hooks/lib/session-state.sh +10 -7
  11. package/assets/hooks/lib/workflow-state.sh +13 -177
  12. package/assets/hooks/post-tool-observer.sh +8 -2
  13. package/assets/hooks/prompt-guard.sh +5 -81
  14. package/assets/hooks/session-start-context.sh +56 -1
  15. package/assets/partials/05-workflow.partial.md +1 -1
  16. package/assets/partials-agents/02-operating-mode.partial.md +2 -0
  17. package/assets/partials-agents/03-orchestration.partial.md +1 -1
  18. package/assets/plugin-registry.v1.json +3 -3
  19. package/assets/reference-configs/document-generation.md +1 -1
  20. package/assets/reference-configs/harness-overview.md +1 -1
  21. package/assets/reference-configs/sprint-contracts.md +3 -3
  22. package/assets/skill-version.json +2 -2
  23. package/assets/templates/contract.template.md +2 -7
  24. package/assets/templates/helpers/capture-plan.sh +2 -2
  25. package/assets/templates/helpers/check-architecture-sync.sh +17 -0
  26. package/assets/templates/helpers/check-task-workflow.sh +4 -4
  27. package/assets/templates/helpers/contract-worktree.sh +1 -21
  28. package/assets/templates/helpers/ensure-task-workflow.sh +11 -36
  29. package/assets/templates/helpers/inspect-project-state.ts +8 -6
  30. package/assets/templates/helpers/migrate-project-template.sh +22 -45
  31. package/assets/templates/helpers/migrate-workflow-docs.ts +9 -7
  32. package/assets/templates/helpers/new-plan.sh +1 -1
  33. package/assets/templates/helpers/plan-to-todo.sh +12 -37
  34. package/assets/templates/helpers/ship-worktrees.sh +2 -29
  35. package/assets/templates/helpers/verify-contract.sh +1 -111
  36. package/assets/templates/helpers/verify-sprint.sh +3 -180
  37. package/assets/templates/helpers/workflow-contract.ts +5 -1
  38. package/assets/templates/plan.template.md +1 -1
  39. package/assets/templates/review.template.md +9 -34
  40. package/assets/workflow-contract.v1.json +10 -19
  41. package/docs/README.md +10 -10
  42. package/docs/architecture/CURRENT.md +178 -0
  43. package/docs/architecture/EVOLUTION.md +42 -0
  44. package/docs/architecture/current/README.md +4 -156
  45. package/docs/architecture/decisions/20260803-release-identity-binding-and-exit-policy.md +2 -2
  46. package/docs/architecture/decisions/20260823-immediate-controller-relay.md +53 -0
  47. package/docs/architecture/decisions/20260826-browser-runtime-v2.md +73 -0
  48. package/docs/architecture/history/README.md +7 -0
  49. package/docs/architecture/{chatgpt-handoff-facade.md → history/chatgpt-handoff-facade.md} +4 -0
  50. package/docs/architecture/{global-hook-runtime.md → history/global-hook-runtime.md} +7 -3
  51. package/docs/architecture/{ios-semantic-automation-provider-v2.md → history/ios-semantic-automation-provider-v2.md} +6 -2
  52. package/docs/architecture/history.md +3 -34
  53. package/docs/architecture/index.md +15 -98
  54. package/docs/architecture/modules/controller-runtime/transport-lifecycle.md +1 -1
  55. package/docs/architecture/reviews/2026-08-22-semantic-harness-convergence-acceptance.md +39 -0
  56. package/docs/architecture/versions/1.6.md +38 -0
  57. package/docs/architecture/versions/1.7.md +41 -0
  58. package/docs/forge-chatgpt-browser-engine.md +2 -2
  59. package/docs/forge-chatgpt-mcp-setup.md +4 -28
  60. package/docs/forge-chatgpt-supervised-automation.md +3 -3
  61. package/docs/forge-github-issue-launcher.md +1 -1
  62. package/docs/forge-plugin-management.md +1 -1
  63. package/docs/forge-runtime-self-healing-loop.md +1 -1
  64. package/docs/operations/controller-browser-plugin.md +26 -6
  65. package/docs/operations/controller-performance-and-502.md +143 -0
  66. package/docs/operations/controller-reliability-runbook.md +1 -1
  67. package/docs/operations/features.md +2 -2
  68. package/docs/operations/github-repository.md +1 -1
  69. package/docs/operations/homebrew.md +2 -2
  70. package/docs/operations/mcp-tool-exposure.md +5 -3
  71. package/docs/wiki/Architecture.md +6 -6
  72. package/docs/wiki/Implementation.md +2 -2
  73. package/docs/wiki/Integrations.md +2 -2
  74. package/docs/wiki/Work-Lifecycle.md +1 -1
  75. package/package.json +33 -11
  76. package/scripts/activate-source-baseline.ts +17 -13
  77. package/scripts/architecture-event.ts +2 -820
  78. package/scripts/architecture-queue.sh +2 -645
  79. package/scripts/archive-architecture-request.sh +2 -242
  80. package/scripts/archive-workflow.sh +1 -291
  81. package/scripts/benchmark-background-check-overlap.ts +228 -0
  82. package/scripts/benchmark-mcp-host.sh +117 -0
  83. package/scripts/benchmark-mcp-transport.ts +170 -0
  84. package/scripts/benchmark-quality-harness.ts +146 -0
  85. package/scripts/benchmark-route-session-concurrency.ts +207 -6
  86. package/scripts/benchmark-thin-harness-mcp-e2e.ts +7 -1
  87. package/scripts/benchmark-typescript-navigation.ts +186 -0
  88. package/scripts/benchmark-work-efficiency.ts +334 -0
  89. package/scripts/capability-config.ts +2 -392
  90. package/scripts/capability-resolver.ts +2 -503
  91. package/scripts/capture-plan.sh +1 -332
  92. package/scripts/check-agent-tooling.sh +2 -1558
  93. package/scripts/check-architecture-sync.sh +2 -371
  94. package/scripts/check-brain-manifest.sh +2 -253
  95. package/scripts/check-context-files.sh +2 -47
  96. package/scripts/check-deploy-sql-order.sh +2 -115
  97. package/scripts/check-mcp-compatibility.ts +14 -0
  98. package/scripts/check-runtime-architecture.mjs +349 -79
  99. package/scripts/check-skill-version.ts +3 -191
  100. package/scripts/check-source-duplication.mjs +61 -0
  101. package/scripts/check-stable-baseline.ts +92 -0
  102. package/scripts/check-task-sync.sh +2 -63
  103. package/scripts/check-task-workflow.sh +2 -1000
  104. package/scripts/codex-handoff-resume.sh +2 -267
  105. package/scripts/context-contract-sync.sh +2 -514
  106. package/scripts/contract-run.ts +2 -463
  107. package/scripts/contract-worktree.sh +1 -722
  108. package/scripts/ensure-task-workflow.sh +1 -1225
  109. package/scripts/host-temporary-cloud-mcp-e2e.sh +265 -0
  110. package/scripts/inspect-project-state.ts +4 -279
  111. package/scripts/install-standalone-recovery.ts +24 -0
  112. package/scripts/lib/project-init-lib.sh +22 -46
  113. package/scripts/lib/run-forge-helper.sh +19 -0
  114. package/scripts/lib/run-forge-helper.ts +26 -0
  115. package/scripts/migrate-project-template.sh +1 -1189
  116. package/scripts/migrate-workflow-docs.ts +4 -412
  117. package/scripts/new-plan.sh +1 -180
  118. package/scripts/new-spec.sh +1 -47
  119. package/scripts/new-sprint.sh +1 -46
  120. package/scripts/plan-to-todo.sh +1 -796
  121. package/scripts/prepare-codex-handoff.sh +2 -201
  122. package/scripts/prepare-handoff.sh +1 -78
  123. package/scripts/refresh-current-status.sh +2 -467
  124. package/scripts/run-governed-gate.ts +5 -1
  125. package/scripts/select-agent-context-blocks.sh +2 -64
  126. package/scripts/ship-worktrees.sh +1 -558
  127. package/scripts/smoke-ios-physical-device.ts +4 -2
  128. package/scripts/smoke-runtime-recovery.ts +1 -35
  129. package/scripts/smoke-schedule-engine.ts +1 -20
  130. package/scripts/sprint-backlog.sh +1 -834
  131. package/scripts/stage-runtime-release.ts +2 -1
  132. package/scripts/summarize-failures.sh +2 -123
  133. package/scripts/switch-plan.sh +1 -150
  134. package/scripts/sync-brain-docs.sh +2 -379
  135. package/scripts/sync-generated-authority.mjs +175 -0
  136. package/scripts/verify-contract.sh +2 -703
  137. package/scripts/verify-forge-runtime.sh +0 -1
  138. package/scripts/verify-sprint.sh +1 -677
  139. package/scripts/workflow-contract.ts +4 -205
  140. package/scripts/workstream-sync.sh +2 -261
  141. package/src/cli/agent-jobs/executor-health.ts +1 -1
  142. package/src/cli/commands/init-hook.ts +3 -3
  143. package/src/cli/commands/mcp.ts +9 -5
  144. package/src/cli/commands/plugin.ts +12 -3
  145. package/src/cli/commands/recovery.ts +25 -3
  146. package/src/cli/commands/runtime.ts +55 -3
  147. package/src/cli/commands/security.ts +12 -1
  148. package/src/cli/commands/setup-profile.ts +31 -21
  149. package/src/cli/controller/check-runner.ts +113 -5
  150. package/src/cli/controller/composite-result.ts +1 -1
  151. package/src/cli/controller/context/focus.ts +51 -0
  152. package/src/cli/controller/context/instruction-context.ts +114 -0
  153. package/src/cli/controller/context/known-paths.ts +76 -0
  154. package/src/cli/controller/context/query-planning.ts +110 -0
  155. package/src/cli/controller/context/rule-resolution.ts +532 -0
  156. package/src/cli/controller/context/source-materializer.ts +278 -0
  157. package/src/cli/controller/context/structural.ts +16 -0
  158. package/src/cli/controller/context/types.ts +286 -0
  159. package/src/cli/controller/context-pack.ts +828 -487
  160. package/src/cli/controller/launch-agents.ts +77 -2
  161. package/src/cli/controller/operational-plan.ts +2 -2
  162. package/src/cli/controller/work-mode.ts +6 -4
  163. package/src/cli/editing/edit-session.ts +60 -7
  164. package/src/cli/github/contracts.ts +16 -0
  165. package/src/cli/github/github.ts +135 -16
  166. package/src/cli/github/session.ts +2 -1
  167. package/src/cli/installer/managed-entries.ts +15 -1
  168. package/src/cli/local-bridge/console-automations.ts +54 -78
  169. package/src/cli/local-bridge/console-view-models.ts +1 -35
  170. package/src/cli/local-bridge/facade-api.ts +37 -264
  171. package/src/cli/local-bridge/frontend/src/App.tsx +3 -3
  172. package/src/cli/local-bridge/frontend/src/features/automations/AutomationsView.tsx +23 -13
  173. package/src/cli/local-bridge/frontend/src/features/capabilities/CapabilitiesView.tsx +37 -4
  174. package/src/cli/local-bridge/frontend/src/features/overview/OverviewView.tsx +6 -4
  175. package/src/cli/local-bridge/frontend/src/lib/api.ts +1 -6
  176. package/src/cli/local-bridge/frontend/src/lib/routes.ts +1 -1
  177. package/src/cli/local-bridge/frontend/src/shell/Sidebar.tsx +2 -2
  178. package/src/cli/local-bridge/frontend/src/styles.css +1 -1
  179. package/src/cli/local-bridge/frontend/src/types.ts +5 -8
  180. package/src/cli/local-bridge/job-store.ts +1 -490
  181. package/src/cli/local-bridge/server.ts +2 -515
  182. package/src/cli/local-bridge/ui-dist/app.css +1 -1
  183. package/src/cli/local-bridge/ui-dist/app.js +3703 -3757
  184. package/src/cli/mcp/auth.ts +5 -5
  185. package/src/cli/mcp/instructions.ts +3 -2
  186. package/src/cli/mcp/legacy-tool-service.ts +10 -222
  187. package/src/cli/mcp/multi-repository.ts +16 -5
  188. package/src/cli/mcp/oauth.ts +175 -26
  189. package/src/cli/mcp/post-finalize-work-attribution.ts +150 -0
  190. package/src/cli/mcp/repository-tools.ts +282 -146
  191. package/src/cli/mcp/server.ts +586 -116
  192. package/src/cli/mcp/tool-capability-cache.ts +1 -1
  193. package/src/cli/mcp/tool-contract.ts +14 -0
  194. package/src/cli/mcp/toolset-selection.ts +1 -1
  195. package/src/cli/mcp/toolset.ts +44 -7
  196. package/src/cli/mcp/transports/http.ts +124 -14
  197. package/src/cli/mcp/transports/session-registry.ts +43 -5
  198. package/src/cli/mcp/types.ts +3 -3
  199. package/src/cli/repositories/command-classifier.ts +103 -21
  200. package/src/cli/repositories/command-executor.ts +78 -526
  201. package/src/cli/repositories/command-process.ts +108 -0
  202. package/src/cli/repositories/command-scope.ts +99 -41
  203. package/src/cli/repositories/controller-home.ts +7 -8
  204. package/src/cli/repositories/git-command-executor.ts +2 -0
  205. package/src/cli/repositories/locks.ts +53 -16
  206. package/src/cli/repositories/repository-snapshot.ts +124 -0
  207. package/src/cli/repositories/selected-path-actions.ts +17 -9
  208. package/src/cli/repositories/structured-git.ts +118 -6
  209. package/src/cli/repository/inspector.ts +563 -65
  210. package/src/cli/repository/session-cache.ts +58 -17
  211. package/src/cli/v81-entry.ts +1 -4
  212. package/src/effects/fs-transaction.ts +85 -17
  213. package/src/runtime/context/codegraph-read-provider.ts +233 -2
  214. package/src/runtime/context/codegraph-sidecar.cjs +74 -40
  215. package/src/runtime/context/generic-lsp-provider.ts +355 -0
  216. package/src/runtime/context/lsp-client.ts +283 -0
  217. package/src/runtime/context/semantic-navigation-contract.ts +61 -0
  218. package/src/runtime/context/semantic-navigation.ts +223 -0
  219. package/src/runtime/context/swift-navigation.ts +565 -0
  220. package/src/runtime/context/typescript-navigation.ts +226 -0
  221. package/src/runtime/control-plane/dispatch-priority.ts +28 -0
  222. package/src/runtime/control-plane/execution/direct-edit-work-completion.ts +48 -16
  223. package/src/runtime/control-plane/execution/edit-validation-coordinator.ts +86 -24
  224. package/src/runtime/control-plane/execution/repository-work-attribution.ts +106 -0
  225. package/src/runtime/control-plane/execution/retained-work-resume.ts +203 -0
  226. package/src/runtime/control-plane/execution/session-store.ts +18 -0
  227. package/src/runtime/control-plane/execution/verification-evidence.ts +58 -3
  228. package/src/runtime/control-plane/execution/work-completion-authority.ts +58 -0
  229. package/src/runtime/control-plane/execution/work-evidence-policy.ts +200 -0
  230. package/src/runtime/control-plane/execution/work-execution-support.ts +386 -0
  231. package/src/runtime/control-plane/execution/work-finalization-service.ts +1913 -0
  232. package/src/runtime/control-plane/execution/work-handle-authority.ts +96 -0
  233. package/src/runtime/control-plane/execution/work-handle-store.ts +27 -2
  234. package/src/runtime/control-plane/execution/work-lifecycle-audit.ts +258 -0
  235. package/src/runtime/control-plane/execution/work-operation-service.ts +468 -0
  236. package/src/runtime/control-plane/execution/work-path-scope.ts +37 -0
  237. package/src/runtime/control-plane/execution/work-preparation-service.ts +479 -0
  238. package/src/runtime/control-plane/execution/work-process-evidence.ts +129 -0
  239. package/src/runtime/control-plane/execution/work-remote-delivery.ts +215 -0
  240. package/src/runtime/control-plane/execution/work-task-receipt.ts +22 -18
  241. package/src/runtime/control-plane/execution/work-terminal-cleanup.ts +156 -11
  242. package/src/runtime/control-plane/execution/work-validation-reconciler.ts +22 -14
  243. package/src/runtime/control-plane/execution/work-verification-context.ts +56 -0
  244. package/src/runtime/control-plane/execution/work-verification-service.ts +388 -0
  245. package/src/runtime/control-plane/execution/work-verification-snapshot.ts +90 -9
  246. package/src/runtime/control-plane/facade/capability-registry.ts +129 -25
  247. package/src/runtime/control-plane/facade/controller-round-relay.ts +1118 -0
  248. package/src/runtime/control-plane/facade/controller-session-store.ts +302 -12
  249. package/src/runtime/control-plane/facade/goal-workloop-access.ts +17 -1
  250. package/src/runtime/control-plane/facade/goal-workloop.ts +928 -190
  251. package/src/runtime/control-plane/facade/index.ts +3 -0
  252. package/src/runtime/control-plane/facade/plan-contract-store.ts +275 -42
  253. package/src/runtime/control-plane/facade/repository-work-admission.ts +147 -0
  254. package/src/runtime/control-plane/facade/requirement-authority.ts +83 -0
  255. package/src/runtime/control-plane/facade/semantic-admission.ts +205 -0
  256. package/src/runtime/control-plane/facade/suggested-actions.ts +5 -1
  257. package/src/runtime/control-plane/facade/types.ts +90 -10
  258. package/src/runtime/control-plane/facade/work-contract-store.ts +157 -261
  259. package/src/runtime/control-plane/facade/work-state-machine.ts +250 -0
  260. package/src/runtime/control-plane/generated-cache-retention.ts +271 -0
  261. package/src/runtime/control-plane/global-scheduler/config.ts +44 -0
  262. package/src/runtime/control-plane/global-scheduler/dispatch-capacity.ts +80 -0
  263. package/src/runtime/control-plane/global-scheduler/durable-admission.ts +46 -0
  264. package/src/runtime/control-plane/global-scheduler/maintenance.ts +152 -0
  265. package/src/runtime/control-plane/global-scheduler/projection-refresh.ts +84 -0
  266. package/src/runtime/control-plane/global-scheduler/reconciliation.ts +3 -3
  267. package/src/runtime/control-plane/global-scheduler/scheduler.ts +278 -543
  268. package/src/runtime/control-plane/global-scheduler/source-scan.ts +59 -0
  269. package/src/runtime/control-plane/global-scheduler/state.ts +88 -0
  270. package/src/runtime/control-plane/global-scheduler/worker-attachment.ts +57 -0
  271. package/src/runtime/control-plane/global-scheduler/worker-exit-decision.ts +38 -0
  272. package/src/runtime/control-plane/global-scheduler/worker-exit-reconciler.ts +175 -0
  273. package/src/runtime/control-plane/global-scheduler/worker-launch.ts +111 -0
  274. package/src/runtime/control-plane/global-scheduler/worker-lifecycle-store.ts +64 -0
  275. package/src/runtime/control-plane/global-scheduler/worker-lifecycle.ts +150 -0
  276. package/src/runtime/control-plane/global-scheduler/worker-process.ts +119 -0
  277. package/src/runtime/control-plane/global-scheduler/worker-stderr.ts +60 -0
  278. package/src/runtime/control-plane/launcher/chatgpt-work-binding-store.ts +63 -0
  279. package/src/runtime/control-plane/launcher/chatgpt-work-continuation.ts +365 -117
  280. package/src/runtime/control-plane/launcher/launch-reservation-store.ts +89 -0
  281. package/src/runtime/control-plane/launcher/thin-launcher.ts +244 -11
  282. package/src/runtime/control-plane/persistence/controller-home-migration.ts +487 -0
  283. package/src/runtime/control-plane/persistence/requirement-store.ts +0 -12
  284. package/src/runtime/control-plane/persistence/sqlite-store.ts +33 -2
  285. package/src/runtime/control-plane/release-retention.ts +62 -2
  286. package/src/runtime/control-plane/repo-actor/registry.ts +4 -2
  287. package/src/runtime/control-plane/routing/route-policy.ts +24 -21
  288. package/src/runtime/control-plane/routing/workspace-admission.ts +70 -0
  289. package/src/runtime/control-plane/runtime-status-client.ts +0 -2
  290. package/src/runtime/diagnostics/mcp-timing.ts +13 -0
  291. package/src/runtime/diagnostics/mcp-transport-benchmark.ts +129 -0
  292. package/src/runtime/diagnostics/performance.ts +24 -1
  293. package/src/runtime/evidence/event-ledger.ts +1 -1
  294. package/src/runtime/evidence/process-check-execution.ts +18 -0
  295. package/src/runtime/execution/jobs/child-reference.ts +6 -2
  296. package/src/runtime/execution/jobs/store.ts +58 -4
  297. package/src/runtime/execution/jobs/types.ts +1 -1
  298. package/src/runtime/execution/managed-workspace.ts +203 -1
  299. package/src/runtime/execution/process-runtime/check-facade.ts +51 -4
  300. package/src/runtime/execution/process-runtime/check-result.ts +88 -0
  301. package/src/runtime/execution/process-runtime/check-runner-sidecar.ts +7 -1
  302. package/src/runtime/execution/process-runtime/check-scheduling.ts +114 -0
  303. package/src/runtime/execution/process-runtime/command-facade.ts +367 -40
  304. package/src/runtime/execution/process-runtime/gc.ts +38 -6
  305. package/src/runtime/execution/process-runtime/lightweight-managed.ts +1201 -0
  306. package/src/runtime/execution/process-runtime/persisted-check.ts +51 -5
  307. package/src/runtime/execution/process-runtime/resource-claims.ts +10 -6
  308. package/src/runtime/execution/process-runtime/runtime.ts +53 -3
  309. package/src/runtime/execution/process-runtime/store.ts +1 -0
  310. package/src/runtime/execution/process-runtime/types.ts +4 -12
  311. package/src/runtime/execution/thin-harness/async-process.ts +12 -2
  312. package/src/runtime/execution/thin-harness/search-worker.ts +54 -5
  313. package/src/runtime/execution/work-activity.ts +21 -0
  314. package/src/runtime/execution/workers/executor.ts +18 -61
  315. package/src/runtime/gateway/mcp/execution-tools.ts +35 -1852
  316. package/src/runtime/gateway/mcp/legacy-ios-tool-adapter.ts +61 -0
  317. package/src/runtime/gateway/mcp/process-tools.ts +83 -37
  318. package/src/runtime/gateway/mcp/router.ts +186 -84
  319. package/src/runtime/gateway/mcp/runtime-tool-definitions.ts +565 -0
  320. package/src/runtime/gateway/mcp/runtime-tools.ts +2378 -1947
  321. package/src/runtime/plugins/app-store-connect-adapter.ts +216 -47
  322. package/src/runtime/plugins/browser-adapter.ts +2662 -829
  323. package/src/runtime/plugins/browser-automation-service.ts +10 -0
  324. package/src/runtime/plugins/browser-handoff-host.ts +2 -25
  325. package/src/runtime/plugins/browser-handoff.ts +110 -5
  326. package/src/runtime/plugins/browser-macos-bridge.ts +701 -63
  327. package/src/runtime/plugins/browser-manifest-surface.ts +603 -0
  328. package/src/runtime/plugins/browser-native-session-service.ts +222 -0
  329. package/src/runtime/plugins/browser-node-bridge.ts +6 -34
  330. package/src/runtime/plugins/browser-provider-registry.ts +109 -0
  331. package/src/runtime/plugins/browser-runtime-contract.ts +154 -0
  332. package/src/runtime/plugins/browser-runtime.ts +193 -0
  333. package/src/runtime/plugins/browser-session-authority.ts +332 -0
  334. package/src/runtime/plugins/browser-session-store.ts +121 -0
  335. package/src/runtime/plugins/browser-session-types.ts +98 -0
  336. package/src/runtime/plugins/capability-authorization-grants.ts +354 -0
  337. package/src/runtime/plugins/desktop-operator-registration.ts +10 -4
  338. package/src/runtime/plugins/external-adapter.ts +358 -3
  339. package/src/runtime/plugins/external-unix-socket.ts +7 -1
  340. package/src/runtime/plugins/first-party-registry.ts +2 -0
  341. package/src/runtime/plugins/github-adapter.ts +125 -0
  342. package/src/runtime/plugins/ios/agent-device-provider.ts +1 -1
  343. package/src/runtime/plugins/ios/agent-device-typed-provider.ts +52 -9
  344. package/src/runtime/plugins/ios/remote-xpc-hid.ts +1171 -0
  345. package/src/runtime/plugins/ios-adapter.ts +106 -16
  346. package/src/runtime/plugins/ios-agent-device.ts +234 -64
  347. package/src/runtime/plugins/ios-physical-device.ts +1143 -392
  348. package/src/runtime/plugins/lightweight-action.ts +153 -0
  349. package/src/runtime/plugins/local-system-adapter.ts +123 -6
  350. package/src/runtime/plugins/macos-capability-broker.ts +47 -9
  351. package/src/runtime/plugins/plugin-action-sidecar.ts +59 -0
  352. package/src/runtime/plugins/plugin-management-adapter.ts +49 -8
  353. package/src/runtime/plugins/resend-adapter.ts +1 -1
  354. package/src/runtime/plugins/store.ts +330 -33
  355. package/src/runtime/plugins/types.ts +38 -3
  356. package/src/runtime/plugins/xiaohongshu-publish.ts +515 -0
  357. package/src/runtime/projections/git-status-sampler.ts +16 -16
  358. package/src/runtime/projections/materialized-view.ts +28 -10
  359. package/src/runtime/recovery/maintenance-executor.ts +426 -25
  360. package/src/runtime/root/mcp-transport.ts +180 -10
  361. package/src/runtime/root/package-connector-service.ts +230 -10
  362. package/src/runtime/root/package-runtime-release.ts +143 -17
  363. package/src/runtime/root/package-runtime-service.ts +461 -22
  364. package/src/runtime/root/release-manifest.ts +144 -18
  365. package/src/runtime/root/release-materialize.ts +125 -32
  366. package/src/runtime/root/release-store.ts +48 -11
  367. package/src/runtime/root/runtime.ts +23 -5
  368. package/src/runtime/root/service.ts +100 -29
  369. package/src/runtime/root/types.ts +12 -0
  370. package/src/runtime/safe-tooling/ios-development.ts +321 -63
  371. package/src/runtime/shared/trusted-executable.ts +62 -0
  372. package/src/runtime/shared/trusted-node-executable.ts +48 -0
  373. package/src/runtime/standalone-recovery/core.ts +1079 -240
  374. package/src/runtime/standalone-recovery/entry.ts +100 -24
  375. package/src/runtime/standalone-recovery/installer.ts +20 -4
  376. package/src/runtime/standalone-recovery/service-labels.ts +2 -0
  377. package/src/runtime/standalone-recovery/watchdog-heartbeat.ts +160 -0
  378. package/src/runtime/workflow/schedules/browser-probe.ts +81 -3
  379. package/src/runtime/workflow/schedules/engine.ts +364 -202
  380. package/src/runtime/workflow/schedules/github-issue-watch.ts +158 -0
  381. package/src/runtime/workflow/schedules/settlement.ts +64 -17
  382. package/src/runtime/workflow/schedules/store.ts +209 -19
  383. package/src/runtime/workflow/schedules/types.ts +2 -4
  384. package/src/runtime/workflow/schedules/work-continuation.ts +26 -13
  385. package/src/testing/test-governance.ts +8 -40
  386. package/assets/reference-configs/heartbeat-triage.md +0 -57
  387. package/assets/templates/helpers/harness-trace-grade.sh +0 -150
  388. package/assets/templates/helpers/heartbeat-triage.sh +0 -361
  389. package/assets/templates/helpers/maintenance-triage.sh +0 -167
  390. package/docs/architecture/current/approved-target-architecture.zh-CN.md +0 -1501
  391. package/docs/architecture/current/architecture-invariants.md +0 -331
  392. package/docs/architecture/current/automation-and-schedule-engine.md +0 -459
  393. package/docs/architecture/current/codegraph-context-provider.md +0 -238
  394. package/docs/architecture/current/control-plane-authority-inventory.md +0 -94
  395. package/docs/architecture/current/controller-repository-decoupling.md +0 -148
  396. package/docs/architecture/current/dispatch-and-agent-strategy.md +0 -373
  397. package/docs/architecture/current/entity-model.md +0 -612
  398. package/docs/architecture/current/external-plugin-governance.md +0 -396
  399. package/docs/architecture/current/failure-recovery.md +0 -447
  400. package/docs/architecture/current/governance.md +0 -213
  401. package/docs/architecture/current/human-interaction-plane.md +0 -87
  402. package/docs/architecture/current/implementation-status.md +0 -128
  403. package/docs/architecture/current/job-and-run-lifecycle.md +0 -413
  404. package/docs/architecture/current/legacy-governance.md +0 -58
  405. package/docs/architecture/current/local-workspace-target-grants.md +0 -70
  406. package/docs/architecture/current/migration-roadmap.md +0 -105
  407. package/docs/architecture/current/multi-repository-execution.md +0 -371
  408. package/docs/architecture/current/operations-runbook.md +0 -45
  409. package/docs/architecture/current/peer-supercontroller-runtime.md +0 -32
  410. package/docs/architecture/current/personal-assistant-plugin-baseline.md +0 -206
  411. package/docs/architecture/current/repository-access-modes.md +0 -102
  412. package/docs/architecture/current/route-policy.md +0 -15
  413. package/docs/architecture/current/route-session-concurrency.md +0 -85
  414. package/docs/architecture/current/runtime-architecture-simplification.md +0 -214
  415. package/docs/architecture/current/runtime-directory-map.md +0 -49
  416. package/docs/architecture/current/runtime-health-and-resource-lifecycle.md +0 -85
  417. package/docs/architecture/current/scheduler-and-resource-claims.md +0 -422
  418. package/docs/architecture/current/session-aware-execution-and-authorization.md +0 -77
  419. package/docs/architecture/current/system-overview.md +0 -169
  420. package/docs/architecture/current/target-requirements-traceability.md +0 -202
  421. package/docs/architecture/current/thin-harness-governance-policy.md +0 -32
  422. package/docs/architecture/current/thin-harness-v1.md +0 -321
  423. package/docs/architecture/current/verification-and-release-gates.md +0 -391
  424. package/docs/forge-autonomous-goal-loop.md +0 -9
  425. package/docs/forge-provider-configuration.md +0 -7
  426. package/docs/operations/chatgpt-personal-assistant-runtime.md +0 -93
  427. package/docs/operations/gmail-assistant-routines.md +0 -186
  428. package/docs/operations/personal-assistant-operator-guide.md +0 -61
  429. package/docs/operations/provider-configuration.md +0 -31
  430. package/scripts/harness-trace-grade.sh +0 -150
  431. package/scripts/heartbeat-triage.sh +0 -361
  432. package/scripts/maintenance-triage.sh +0 -167
  433. package/src/cli/local-bridge/frontend/src/features/settings/SettingsView.tsx +0 -2
  434. package/src/cli/repositories/goal-registry.ts +0 -239
  435. package/src/runtime/assistant/action-proposals.ts +0 -279
  436. package/src/runtime/assistant/intent.ts +0 -395
  437. package/src/runtime/assistant/model-provider.ts +0 -460
  438. package/src/runtime/assistant/openapi.ts +0 -223
  439. package/src/runtime/assistant/policy.ts +0 -89
  440. package/src/runtime/assistant/readiness.ts +0 -258
  441. package/src/runtime/assistant/routine-runtime.ts +0 -477
  442. package/src/runtime/assistant/schedule-binding.ts +0 -171
  443. package/src/runtime/assistant/standing-grants.ts +0 -375
  444. package/src/runtime/assistant/store.ts +0 -243
  445. package/src/runtime/assistant/types.ts +0 -135
  446. package/src/runtime/control-plane/goal-loop/config-facade.ts +0 -700
  447. package/src/runtime/control-plane/goal-loop/config-store.ts +0 -570
  448. package/src/runtime/control-plane/goal-loop/config-types.ts +0 -213
  449. package/src/runtime/control-plane/goal-loop/executor-router.ts +0 -109
  450. package/src/runtime/control-plane/goal-loop/failure-taxonomy.ts +0 -149
  451. package/src/runtime/control-plane/goal-loop/goal-contract-store.ts +0 -304
  452. package/src/runtime/control-plane/goal-loop/goal-loop-engine.ts +0 -1001
  453. package/src/runtime/control-plane/goal-loop/handoff-packet.ts +0 -160
  454. package/src/runtime/control-plane/goal-loop/index.ts +0 -13
  455. package/src/runtime/control-plane/goal-loop/local-tools.ts +0 -290
  456. package/src/runtime/control-plane/goal-loop/policy-gates.ts +0 -203
  457. package/src/runtime/control-plane/goal-loop/provider-dispatch.ts +0 -93
  458. package/src/runtime/control-plane/goal-loop/provider-registry.ts +0 -545
  459. package/src/runtime/control-plane/goal-loop/types.ts +0 -378
  460. package/src/runtime/control-plane/startup-recovery.ts +0 -198
  461. package/src/runtime/gateway/mcp/resource-policy.ts +0 -186
  462. package/src/runtime/personal-assistant/gmail-triage-manager.ts +0 -231
  463. package/src/runtime/personal-assistant/reporting-runtime.ts +0 -344
  464. package/src/runtime/personal-assistant/triage-runtime.ts +0 -748
  465. package/src/runtime/workflow/findings/store.ts +0 -204
  466. package/src/runtime/workflow/findings/types.ts +0 -58
  467. package/src/runtime/workflow/portfolio/engine.ts +0 -20
  468. package/src/runtime/workflow/portfolio/store.ts +0 -185
  469. package/src/runtime/workflow/portfolio/types.ts +0 -29
@@ -1,561 +1,4 @@
1
1
  #!/bin/bash
2
2
  set -euo pipefail
3
-
4
3
  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
5
- if REPO_ROOT="$(git -C "$SCRIPT_DIR/.." rev-parse --show-toplevel 2>/dev/null)"; then
6
- :
7
- elif [[ "$SCRIPT_DIR" == */.ai/harness/scripts ]]; then
8
- REPO_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
9
- else
10
- REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
11
- fi
12
- cd "$REPO_ROOT"
13
-
14
- usage() {
15
- cat <<'USAGE_EOF'
16
- Usage:
17
- scripts/ship-worktrees.sh [--target <branch>] [--remote <name>] [--slug <slug>] [--ready] [--dry-run]
18
- scripts/ship-worktrees.sh --local-merge [--target <branch>] [--slug <slug>] [--dry-run]
19
- scripts/ship-worktrees.sh --cleanup-merged [--target <branch>] [--slug <slug>] [--discard-scaffold-only] [--dry-run]
20
-
21
- Default mode validates finished contract worktrees, commits them through
22
- contract-worktree finish --no-merge, pushes their codex/* branches, and opens
23
- draft PRs. It does not fast-forward main by default.
24
- USAGE_EOF
25
- }
26
-
27
- json_escape() {
28
- local value="$1"
29
- value="${value//\\/\\\\}"
30
- value="${value//\"/\\\"}"
31
- value="${value//$'\n'/\\n}"
32
- value="${value//$'\r'/\\r}"
33
- value="${value//$'\t'/\\t}"
34
- printf '%s' "$value"
35
- }
36
-
37
- policy_get() {
38
- local jq_path="$1"
39
- local default_value="${2:-}"
40
- local value=""
41
-
42
- if [[ -f ".ai/harness/policy.json" ]] && command -v jq >/dev/null 2>&1; then
43
- value="$(jq -r "$jq_path // empty" ".ai/harness/policy.json" 2>/dev/null || true)"
44
- if [[ -n "$value" ]]; then
45
- printf '%s' "$value"
46
- return 0
47
- fi
48
- fi
49
-
50
- printf '%s' "$default_value"
51
- }
52
-
53
- normalize_slug() {
54
- printf '%s' "$1" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//; s/-{2,}/-/g'
55
- }
56
-
57
- plan_slug_from_path() {
58
- local plan_file="$1"
59
- local base slug
60
- base="$(basename "$plan_file")"
61
- slug="$(printf '%s' "$base" | sed -E 's/^plan-[0-9]{8}-[0-9]{4}-//; s/\.md$//')"
62
- normalize_slug "${slug:-contract-task}"
63
- }
64
-
65
- is_linked_worktree() {
66
- local git_dir
67
- git_dir="$(git rev-parse --git-dir 2>/dev/null || true)"
68
- [[ "$git_dir" == *".git/worktrees/"* ]]
69
- }
70
-
71
- current_branch() {
72
- git branch --show-current 2>/dev/null || true
73
- }
74
-
75
- load_workflow_state() {
76
- if [[ -f ".ai/hooks/lib/workflow-state.sh" ]]; then
77
- # shellcheck source=/dev/null
78
- . ".ai/hooks/lib/workflow-state.sh"
79
- fi
80
- }
81
-
82
- run_cmd() {
83
- echo "[Ship] $*"
84
- if [[ "$DRY_RUN" -eq 1 ]]; then
85
- return 0
86
- fi
87
- "$@"
88
- }
89
-
90
- fail() {
91
- echo "ship-worktrees: $*" >&2
92
- exit 1
93
- }
94
-
95
- list_contract_worktrees() {
96
- local branch_prefix="$1"
97
- git worktree list --porcelain | awk -v prefix="refs/heads/${branch_prefix}" '
98
- $1 == "worktree" { path = $2; next }
99
- $1 == "branch" && index($2, prefix) == 1 {
100
- branch = $2
101
- sub(/^refs\/heads\//, "", branch)
102
- print branch "\t" path
103
- }
104
- '
105
- }
106
-
107
- dirty_paths_for_worktree() {
108
- local worktree="$1"
109
- {
110
- git -C "$worktree" diff --name-only
111
- git -C "$worktree" diff --cached --name-only
112
- git -C "$worktree" ls-files --others --exclude-standard
113
- } | sed '/^$/d' | sort -u
114
- }
115
-
116
- is_scaffold_path() {
117
- local path="$1"
118
- case "$path" in
119
- tasks/todos.md|plans/plan-*.md|tasks/contracts/*.contract.md|tasks/reviews/*.review.md|tasks/notes/*.notes.md|.ai/harness/active-plan|.ai/harness/active-worktree|.claude/.active-plan|.ai/harness/worktrees/*.json)
120
- return 0
121
- ;;
122
- esac
123
- return 1
124
- }
125
-
126
- non_scaffold_dirty_paths() {
127
- local worktree="$1" path
128
- while IFS= read -r path; do
129
- [[ -n "$path" ]] || continue
130
- is_scaffold_path "$path" || printf '%s\n' "$path"
131
- done < <(dirty_paths_for_worktree "$worktree")
132
- }
133
-
134
- print_dirty_paths() {
135
- local worktree="$1"
136
- dirty_paths_for_worktree "$worktree" | sed 's/^/ - /' >&2
137
- }
138
-
139
- fail_dirty_merged_worktree() {
140
- local branch="$1" path="$2" non_scaffold
141
- echo "ship-worktrees: dirty merged linked worktree: $branch at $path" >&2
142
- echo "ship-worktrees: branch ancestry only proves committed changes are in $TARGET_BRANCH; these worktree changes are still outside $TARGET_BRANCH." >&2
143
- echo "ship-worktrees: pick/apply/commit useful changes before cleanup; do not use tgz, reset --hard, git clean, or stash as closeout." >&2
144
- echo "ship-worktrees: dirty paths:" >&2
145
- print_dirty_paths "$path"
146
-
147
- non_scaffold="$(non_scaffold_dirty_paths "$path")"
148
- if [[ -z "$non_scaffold" ]]; then
149
- echo "ship-worktrees: if these are generated plan/contract/review/notes scaffold only, rerun with --discard-scaffold-only." >&2
150
- else
151
- echo "ship-worktrees: --discard-scaffold-only is blocked by non-scaffold paths:" >&2
152
- printf '%s\n' "$non_scaffold" | sed 's/^/ - /' >&2
153
- fi
154
- return 1
155
- }
156
-
157
- discard_scaffold_dirty_paths() {
158
- local worktree="$1" path
159
- local tracked_paths=()
160
- local untracked_paths=()
161
-
162
- while IFS= read -r path; do
163
- [[ -n "$path" ]] || continue
164
- if git -C "$worktree" ls-files --error-unmatch -- "$path" >/dev/null 2>&1; then
165
- tracked_paths+=("$path")
166
- else
167
- untracked_paths+=("$path")
168
- fi
169
- done < <(dirty_paths_for_worktree "$worktree")
170
-
171
- if [[ "${#tracked_paths[@]}" -gt 0 ]]; then
172
- run_cmd git -C "$worktree" reset -- "${tracked_paths[@]}"
173
- run_cmd git -C "$worktree" checkout -- "${tracked_paths[@]}"
174
- fi
175
-
176
- for path in "${untracked_paths[@]}"; do
177
- if [[ "$DRY_RUN" -eq 1 ]]; then
178
- echo "[Ship] would remove scaffold file: $worktree/$path"
179
- else
180
- rm -f "$worktree/$path"
181
- fi
182
- done
183
-
184
- if [[ "$DRY_RUN" -eq 1 ]]; then
185
- echo "[Ship] Would discard scaffold-only changes in $worktree"
186
- else
187
- echo "[Ship] Discarded scaffold-only changes in $worktree"
188
- fi
189
- }
190
-
191
- guard_dirty_merged_worktree() {
192
- local branch="$1" path="$2" non_scaffold
193
- [[ -z "$(git -C "$path" status --porcelain=v1 --untracked-files=all)" ]] && return 0
194
-
195
- if [[ "$DISCARD_SCAFFOLD_ONLY" -eq 0 ]]; then
196
- fail_dirty_merged_worktree "$branch" "$path"
197
- return 1
198
- fi
199
-
200
- non_scaffold="$(non_scaffold_dirty_paths "$path")"
201
- if [[ -n "$non_scaffold" ]]; then
202
- echo "ship-worktrees: refusing --discard-scaffold-only for dirty merged linked worktree with non-scaffold paths: $branch at $path" >&2
203
- printf '%s\n' "$non_scaffold" | sed 's/^/ - /' >&2
204
- return 1
205
- fi
206
-
207
- discard_scaffold_dirty_paths "$path"
208
- }
209
-
210
- active_plan_or_empty() {
211
- local active_plan=""
212
- if declare -F get_active_plan >/dev/null 2>&1; then
213
- active_plan="$(get_active_plan 2>/dev/null || true)"
214
- elif [[ -f ".ai/harness/active-plan" ]]; then
215
- active_plan="$(cat ".ai/harness/active-plan" 2>/dev/null | xargs)"
216
- fi
217
- printf '%s' "$active_plan"
218
- }
219
-
220
- active_slug_or_empty() {
221
- local active_plan
222
- active_plan="$(active_plan_or_empty)"
223
- [[ -n "$active_plan" ]] || return 0
224
- plan_slug_from_path "$active_plan"
225
- }
226
-
227
- review_recommends_pass_fallback() {
228
- local review_file="$1"
229
- grep -Eq '^> \*\*Recommendation\*\*:[[:space:]]*pass([[:space:]]*)$' "$review_file"
230
- }
231
-
232
- external_acceptance_pass_fallback() {
233
- local review_file="$1"
234
- grep -Eq '^> \*\*External Acceptance\*\*:[[:space:]]*(pass|manual_override)([[:space:]]*)$' "$review_file" \
235
- && grep -Eq '^-?[[:space:]]*P1 blockers:[[:space:]]*none([[:space:]]*)$' "$review_file"
236
- }
237
-
238
- require_finish_ready() {
239
- local contract_file="" review_file="" checks_file=".ai/harness/checks/latest.json" checks_error=""
240
-
241
- [[ -x "scripts/contract-worktree.sh" ]] || fail "scripts/contract-worktree.sh is missing or not executable"
242
- [[ -x "scripts/verify-sprint.sh" ]] || fail "scripts/verify-sprint.sh is missing or not executable"
243
-
244
- load_workflow_state
245
- if declare -F workflow_active_contract >/dev/null 2>&1; then
246
- contract_file="$(workflow_active_contract 2>/dev/null || true)"
247
- fi
248
- if declare -F workflow_active_review >/dev/null 2>&1; then
249
- review_file="$(workflow_active_review 2>/dev/null || true)"
250
- fi
251
- if declare -F workflow_checks_file >/dev/null 2>&1; then
252
- checks_file="$(workflow_checks_file)"
253
- fi
254
-
255
- [[ -n "$contract_file" && -f "$contract_file" ]] || fail "active sprint contract is missing"
256
- [[ -n "$review_file" && -f "$review_file" ]] || fail "active sprint review is missing"
257
-
258
- if declare -F workflow_review_recommends_pass >/dev/null 2>&1; then
259
- workflow_review_recommends_pass "$review_file" || fail "$review_file does not recommend pass"
260
- else
261
- review_recommends_pass_fallback "$review_file" || fail "$review_file does not recommend pass"
262
- fi
263
-
264
- if declare -F workflow_external_acceptance_pass >/dev/null 2>&1; then
265
- workflow_external_acceptance_pass "$review_file" || fail "$review_file has no passing external acceptance"
266
- else
267
- external_acceptance_pass_fallback "$review_file" || fail "$review_file has no passing external acceptance"
268
- fi
269
-
270
- run_cmd bash "scripts/verify-sprint.sh"
271
- if [[ "$DRY_RUN" -eq 1 ]]; then
272
- return 0
273
- fi
274
-
275
- if declare -F workflow_checks_pass >/dev/null 2>&1; then
276
- if ! checks_error="$(workflow_checks_pass "$checks_file" "$contract_file" "$review_file")"; then
277
- fail "$checks_error"
278
- fi
279
- elif ! grep -Eq '"status"[[:space:]]*:[[:space:]]*"pass"' "$checks_file"; then
280
- fail "structured checks are not passing in $checks_file"
281
- fi
282
- }
283
-
284
- finish_contract_worktree() {
285
- local merge_mode="$1"
286
- require_finish_ready
287
- if [[ "$merge_mode" == "local" ]]; then
288
- run_cmd bash "scripts/contract-worktree.sh" finish --target "$TARGET_BRANCH"
289
- else
290
- run_cmd bash "scripts/contract-worktree.sh" finish --no-merge --target "$TARGET_BRANCH"
291
- fi
292
- }
293
-
294
- pr_title_for_branch() {
295
- local branch="$1"
296
- local active_plan title
297
- active_plan="$(active_plan_or_empty)"
298
- if [[ -n "$active_plan" && -f "$active_plan" ]]; then
299
- title="$(awk '/^# / { sub(/^# /, ""); print; exit }' "$active_plan" | sed -E 's/^Plan:[[:space:]]*//')"
300
- fi
301
- title="${title:-Ship ${branch}}"
302
- printf '%s' "$title"
303
- }
304
-
305
- pr_body_for_branch() {
306
- local branch="$1"
307
- cat <<EOF_BODY
308
- Automated forge ship for \`${branch}\`.
309
-
310
- Checks:
311
- - Forge /review review artifact recommends pass.
312
- - External acceptance is recorded in the sprint review.
313
- - \`bash scripts/verify-sprint.sh\` passed before \`contract-worktree.sh finish --no-merge\`.
314
-
315
- This PR intentionally does not merge \`${TARGET_BRANCH}\` locally.
316
- EOF_BODY
317
- }
318
-
319
- push_branch() {
320
- local branch="$1"
321
- git remote get-url "$REMOTE_NAME" >/dev/null 2>&1 || fail "remote not found: $REMOTE_NAME"
322
- run_cmd git push -u "$REMOTE_NAME" "$branch"
323
- }
324
-
325
- create_or_report_pr() {
326
- local branch="$1"
327
- local gh_bin existing title body output status
328
- local args=()
329
- gh_bin="${FORGE_GH_BIN:-gh}"
330
- command -v "$gh_bin" >/dev/null 2>&1 || fail "gh is required for default PR ship mode"
331
-
332
- existing="$("$gh_bin" pr list --base "$TARGET_BRANCH" --head "$branch" --json url --jq '.[0].url // ""' 2>/dev/null || true)"
333
- if [[ -n "$existing" ]]; then
334
- echo "[Ship] PR already exists for $branch: $existing"
335
- return 0
336
- fi
337
-
338
- title="$(pr_title_for_branch "$branch")"
339
- body="$(pr_body_for_branch "$branch")"
340
- args=(pr create --base "$TARGET_BRANCH" --head "$branch" --title "$title" --body "$body")
341
- if [[ "$DRAFT_PR" -eq 1 ]]; then
342
- args+=(--draft)
343
- fi
344
-
345
- echo "[Ship] $gh_bin ${args[*]}"
346
- if [[ "$DRY_RUN" -eq 1 ]]; then
347
- return 0
348
- fi
349
-
350
- if output="$("$gh_bin" "${args[@]}" 2>&1)"; then
351
- [[ -z "$output" ]] || printf '%s\n' "$output"
352
- return 0
353
- fi
354
-
355
- status=$?
356
- existing="$("$gh_bin" pr list --base "$TARGET_BRANCH" --head "$branch" --json url --jq '.[0].url // ""' 2>/dev/null || true)"
357
- if [[ -n "$existing" ]]; then
358
- echo "[Ship] PR already exists for $branch after create failure: $existing"
359
- return 0
360
- fi
361
-
362
- [[ -z "$output" ]] || printf '%s\n' "$output" >&2
363
- fail "gh pr create failed for $branch (exit $status)"
364
- }
365
-
366
- ship_linked_pr() {
367
- local branch
368
- branch="$(current_branch)"
369
- [[ -n "$branch" ]] || fail "detached HEAD is not supported"
370
- [[ "$branch" != "$TARGET_BRANCH" ]] || fail "refusing to ship target branch as linked worktree"
371
- case "$branch" in
372
- "$BRANCH_PREFIX"*) ;;
373
- *) fail "linked ship expects branch prefix $BRANCH_PREFIX, got $branch" ;;
374
- esac
375
-
376
- finish_contract_worktree "pr"
377
- push_branch "$branch"
378
- create_or_report_pr "$branch"
379
- }
380
-
381
- ship_linked_local_merge() {
382
- local branch
383
- branch="$(current_branch)"
384
- [[ -n "$branch" ]] || fail "detached HEAD is not supported"
385
- [[ "$branch" != "$TARGET_BRANCH" ]] || fail "refusing to local-merge target branch as linked worktree"
386
- finish_contract_worktree "local"
387
- }
388
-
389
- ship_primary_dirty_pr() {
390
- local status active_slug base_slug branch message
391
- status="$(git status --porcelain=v1 --untracked-files=all)"
392
- [[ -n "$status" ]] || return 0
393
-
394
- [[ "$(current_branch)" == "$TARGET_BRANCH" ]] || fail "main closeout must start from $TARGET_BRANCH"
395
- active_slug="$(active_slug_or_empty)"
396
- base_slug="${SLUG_OVERRIDE:-$active_slug}"
397
- [[ -n "$base_slug" ]] || fail "main worktree has changes; pass --slug or keep an active plan so ship can name the closeout branch"
398
- base_slug="$(normalize_slug "$base_slug")"
399
- branch="${BRANCH_PREFIX}${base_slug}-main-closeout"
400
- message="chore(ship): close out ${base_slug}"
401
-
402
- if git show-ref --verify --quiet "refs/heads/$branch"; then
403
- fail "closeout branch already exists: $branch"
404
- fi
405
-
406
- run_cmd git switch -c "$branch"
407
- run_cmd git add -A
408
- run_cmd git commit -m "$message"
409
- push_branch "$branch"
410
- create_or_report_pr "$branch"
411
- }
412
-
413
- ship_primary_pr() {
414
- local branch path shipped=0
415
- local child_args=()
416
- [[ "$DRY_RUN" -eq 1 ]] && child_args+=(--dry-run)
417
- [[ "$DRAFT_PR" -eq 0 ]] && child_args+=(--ready)
418
- while IFS=$'\t' read -r branch path; do
419
- [[ -n "$branch" && -n "$path" ]] || continue
420
- [[ "$(cd "$path" && pwd -P)" != "$(pwd -P)" ]] || continue
421
- echo "[Ship] Shipping linked worktree $branch at $path with PR mode"
422
- (cd "$path" && bash "scripts/ship-worktrees.sh" --target "$TARGET_BRANCH" --remote "$REMOTE_NAME" "${child_args[@]}")
423
- shipped=1
424
- done < <(list_contract_worktrees "$BRANCH_PREFIX")
425
-
426
- ship_primary_dirty_pr
427
-
428
- if [[ "$shipped" -eq 0 && -z "$(git status --porcelain=v1 --untracked-files=all)" ]]; then
429
- echo "[Ship] Nothing to ship."
430
- fi
431
- }
432
-
433
- ship_primary_local_merge() {
434
- local branch path slug shipped=0
435
- local child_args=()
436
- [[ "$DRY_RUN" -eq 1 ]] && child_args+=(--dry-run)
437
- while IFS=$'\t' read -r branch path; do
438
- [[ -n "$branch" && -n "$path" ]] || continue
439
- [[ "$(cd "$path" && pwd -P)" != "$(pwd -P)" ]] || continue
440
- slug="${branch#${BRANCH_PREFIX}}"
441
- echo "[Ship] Shipping linked worktree $branch at $path with local merge mode"
442
- (cd "$path" && bash "scripts/ship-worktrees.sh" --local-merge --target "$TARGET_BRANCH" "${child_args[@]}")
443
- run_cmd bash "scripts/contract-worktree.sh" cleanup --slug "$slug" --target "$TARGET_BRANCH"
444
- shipped=1
445
- done < <(list_contract_worktrees "$BRANCH_PREFIX")
446
-
447
- if [[ "$shipped" -eq 0 ]]; then
448
- echo "[Ship] No linked contract worktrees found for local merge."
449
- fi
450
- }
451
-
452
- cleanup_merged() {
453
- local branch path slug cleaned=0
454
- ! is_linked_worktree || fail "--cleanup-merged must run from the target primary worktree"
455
-
456
- while IFS=$'\t' read -r branch path; do
457
- [[ -n "$branch" && -n "$path" ]] || continue
458
- slug="${branch#${BRANCH_PREFIX}}"
459
- if git merge-base --is-ancestor "$branch" "$TARGET_BRANCH" >/dev/null 2>&1; then
460
- guard_dirty_merged_worktree "$branch" "$path" || exit 1
461
- if [[ "$DRY_RUN" -eq 1 ]]; then
462
- run_cmd bash "scripts/contract-worktree.sh" cleanup --slug "$slug" --target "$TARGET_BRANCH" --dry-run
463
- else
464
- run_cmd bash "scripts/contract-worktree.sh" cleanup --slug "$slug" --target "$TARGET_BRANCH"
465
- fi
466
- cleaned=1
467
- else
468
- echo "[Ship] Skipped unmerged branch: $branch"
469
- fi
470
- done < <(list_contract_worktrees "$BRANCH_PREFIX")
471
-
472
- if [[ "$cleaned" -eq 0 ]]; then
473
- echo "[Ship] No merged contract worktrees to clean."
474
- fi
475
- }
476
-
477
- MODE="pr"
478
- TARGET_BRANCH=""
479
- REMOTE_NAME="origin"
480
- SLUG_OVERRIDE=""
481
- DRAFT_PR=1
482
- DRY_RUN=0
483
- DISCARD_SCAFFOLD_ONLY=0
484
-
485
- while [[ $# -gt 0 ]]; do
486
- case "$1" in
487
- --target)
488
- [[ -n "${2:-}" ]] || fail "--target requires a value"
489
- TARGET_BRANCH="$2"
490
- shift 2
491
- ;;
492
- --remote)
493
- [[ -n "${2:-}" ]] || fail "--remote requires a value"
494
- REMOTE_NAME="$2"
495
- shift 2
496
- ;;
497
- --slug)
498
- [[ -n "${2:-}" ]] || fail "--slug requires a value"
499
- SLUG_OVERRIDE="$(normalize_slug "$2")"
500
- shift 2
501
- ;;
502
- --ready)
503
- DRAFT_PR=0
504
- shift
505
- ;;
506
- --draft)
507
- DRAFT_PR=1
508
- shift
509
- ;;
510
- --dry-run)
511
- DRY_RUN=1
512
- shift
513
- ;;
514
- --local-merge)
515
- MODE="local-merge"
516
- shift
517
- ;;
518
- --cleanup-merged)
519
- MODE="cleanup-merged"
520
- shift
521
- ;;
522
- --discard-scaffold-only)
523
- DISCARD_SCAFFOLD_ONLY=1
524
- shift
525
- ;;
526
- --help|-h)
527
- usage
528
- exit 0
529
- ;;
530
- *)
531
- fail "unknown argument: $1"
532
- ;;
533
- esac
534
- done
535
-
536
- git rev-parse --is-inside-work-tree >/dev/null 2>&1 || fail "not inside a git repository"
537
- TARGET_BRANCH="${TARGET_BRANCH:-$(policy_get '.worktree_strategy.merge_back.target' 'main')}"
538
- BRANCH_PREFIX="$(policy_get '.worktree_strategy.branch_prefix' 'codex/')"
539
-
540
- case "$MODE" in
541
- pr)
542
- if is_linked_worktree; then
543
- ship_linked_pr
544
- else
545
- ship_primary_pr
546
- fi
547
- ;;
548
- local-merge)
549
- if is_linked_worktree; then
550
- ship_linked_local_merge
551
- else
552
- ship_primary_local_merge
553
- fi
554
- ;;
555
- cleanup-merged)
556
- cleanup_merged
557
- ;;
558
- *)
559
- fail "unsupported mode: $MODE"
560
- ;;
561
- esac
4
+ exec "$SCRIPT_DIR/lib/run-forge-helper.sh" "ship-worktrees.sh" "$@"
@@ -24,7 +24,6 @@ if (!/^[A-Za-z0-9][A-Za-z0-9.-]+$/.test(bundleId) || !bundleId.includes('.') ||
24
24
  throw new Error('FORGE_IOS_DEVICE_SMOKE_BUNDLE_ID must be an exact bundle identifier, not a URL or deep link.');
25
25
  }
26
26
 
27
- delete process.env.FORGE_IOS_DEVICE_RUNNER_URL;
28
27
 
29
28
  const common = {
30
29
  controllerHome,
@@ -51,6 +50,7 @@ try {
51
50
  entry.identifier === deviceSelector || entry.udid === deviceSelector || entry.name === deviceSelector);
52
51
  if (matches.length !== 1) throw new Error(`Expected exactly one physical iPhone for selector ${deviceSelector}; found ${matches.length}.`);
53
52
  const device = matches[0]!;
53
+ const info = await invoke('physical_device_info', { device: device.identifier });
54
54
  const apps = await invoke('physical_device_apps', { device: device.identifier, bundle_id: bundleId });
55
55
  const installed = Array.isArray(apps.apps) ? apps.apps as Array<Record<string, unknown>> : [];
56
56
  if (installed.length !== 1) throw new Error(`The exact bundle identifier ${bundleId} is not installed on the selected iPhone.`);
@@ -97,7 +97,9 @@ try {
97
97
  version: app.version,
98
98
  },
99
99
  launchStatus: interaction?.status,
100
- uiAutomation: opened.uiAutomation,
100
+ controlPlane: opened.controlPlane,
101
+ coreDeviceCapabilities: info.capabilities,
102
+ screenViewingURLAvailable: typeof info.screenViewingURL === 'string',
101
103
  screenshot: {
102
104
  created: true,
103
105
  width: width ? Number(width) : undefined,
@@ -25,8 +25,6 @@ import {
25
25
  } from '../src/runtime/execution/process-runtime';
26
26
  import { executionIdentityForRepository } from '../src/runtime/control-plane/execution/execution-identity';
27
27
  import { createSchedule } from '../src/runtime/workflow/schedules/store';
28
- import { createPortfolioWorkflow } from '../src/runtime/workflow/portfolio/store';
29
- import { recordCandidateFinding } from '../src/runtime/workflow/findings/store';
30
28
  import { assertAutomatedOperationAllowed } from '../src/runtime/control-plane/governance/external-effects';
31
29
 
32
30
  const root = mkdtempSync(join(tmpdir(), 'forge-recovery-smoke-'));
@@ -169,38 +167,9 @@ try {
169
167
  const scheduleB = createSchedule(controllerHome, scheduleInput);
170
168
  assert(scheduleA.scheduleId === scheduleB.scheduleId, 'Schedule requestId was not idempotent');
171
169
 
172
- const portfolioInput = {
173
- name: 'portfolio-idempotency', requestId: 'portfolio-idempotency', failurePolicy: 'stop' as const,
174
- steps: [{ stepId: 'one', repoId: repository.repoId, operation: 'controller_context', dependsOn: [], priority: 'P2' as const, resourceClaims: [], status: 'pending' as const }],
175
- };
176
- const portfolioA = createPortfolioWorkflow(controllerHome, portfolioInput);
177
- const portfolioB = createPortfolioWorkflow(controllerHome, portfolioInput);
178
- assert(portfolioA.workflowId === portfolioB.workflowId, 'Portfolio requestId was not idempotent');
179
-
180
- const candidateA = recordCandidateFinding(controllerHome, {
181
- repoId: repository.repoId, requestId: 'candidate-observation-1', semanticKey: 'frequent-502:mcp-timeout',
182
- title: 'Frequent MCP 502', summary: 'Observed during bounded triage.', evidence: { source: 'schedule', reference: 'OCC-1' },
183
- });
184
- const candidateB = recordCandidateFinding(controllerHome, {
185
- repoId: repository.repoId, requestId: 'candidate-observation-2', semanticKey: 'frequent-502:mcp-timeout',
186
- title: 'Frequent MCP 502', summary: 'Observed again.', evidence: { source: 'schedule', reference: 'OCC-2' },
187
- });
188
- assert(candidateA.findingId === candidateB.findingId && candidateB.observationCount === 2, 'candidate finding was not deduplicated');
189
170
  let automaticIssueBlocked = false;
190
171
  try { assertAutomatedOperationAllowed('create_issue'); } catch { automaticIssueBlocked = true; }
191
- assert(automaticIssueBlocked, 'Schedule/Portfolio could create an Issue without candidate promotion');
192
-
193
- let cycleRejected = false;
194
- try {
195
- createPortfolioWorkflow(controllerHome, {
196
- name: 'cycle', requestId: 'portfolio-cycle', failurePolicy: 'stop',
197
- steps: [
198
- { stepId: 'a', repoId: repository.repoId, operation: 'controller_context', dependsOn: ['b'], priority: 'P2', resourceClaims: [], status: 'pending' },
199
- { stepId: 'b', repoId: repository.repoId, operation: 'controller_context', dependsOn: ['a'], priority: 'P2', resourceClaims: [], status: 'pending' },
200
- ],
201
- });
202
- } catch { cycleRejected = true; }
203
- assert(cycleRejected, 'Portfolio dependency cycle was accepted');
172
+ assert(automaticIssueBlocked, 'Kernel automation could create an Issue without an explicit external-effect path');
204
173
 
205
174
  console.log(JSON.stringify({
206
175
  status: 'ok',
@@ -208,10 +177,7 @@ try {
208
177
  processRecovered,
209
178
  replacementController: replacement.controllerId,
210
179
  scheduleId: scheduleA.scheduleId,
211
- portfolioWorkflowId: portfolioA.workflowId,
212
- candidateFindingDeduplicated: candidateB.observationCount,
213
180
  automaticIssueBlocked,
214
- portfolioCycleRejected: cycleRejected,
215
181
  executionJobCount: listExecutionJobs(controllerHome, repository.repoId, 20).length,
216
182
  }, null, 2));
217
183
  } finally {
@@ -6,7 +6,6 @@ import { registerRepository } from '../src/cli/repositories/registry';
6
6
  import { listHandoffItems } from '../src/runtime/control-plane/facade/handoff-inbox-store';
7
7
  import { listExecutionJobs } from '../src/runtime/execution/jobs/store';
8
8
  import { evaluateSchedule } from '../src/runtime/workflow/schedules/engine';
9
- import { recordCandidateFinding } from '../src/runtime/workflow/findings/store';
10
9
  import { createSchedule, getSchedule, getScheduleDecision } from '../src/runtime/workflow/schedules/store';
11
10
 
12
11
  const root = mkdtempSync(join(tmpdir(), 'forge-schedule-smoke-'));
@@ -119,20 +118,6 @@ try {
119
118
  'missing historical dependency checkpoint fired',
120
119
  );
121
120
 
122
- recordCandidateFinding(controllerHome, {
123
- repoId: repository.repoId,
124
- requestId: 'schedule-candidate-1',
125
- semanticKey: 'schedule:condition',
126
- title: 'Condition finding',
127
- evidence: { source: 'smoke' },
128
- });
129
- recordCandidateFinding(controllerHome, {
130
- repoId: repository.repoId,
131
- requestId: 'schedule-candidate-2',
132
- semanticKey: 'schedule:condition',
133
- title: 'Condition finding',
134
- evidence: { source: 'smoke' },
135
- });
136
121
  const conditionSchedule = createSchedule(controllerHome, {
137
122
  ...semanticBase,
138
123
  requestId: 'schedule-condition',
@@ -140,11 +125,7 @@ try {
140
125
  trigger: {
141
126
  type: 'condition',
142
127
  everyMinutes: 1,
143
- condition: {
144
- kind: 'candidate_observation_threshold',
145
- semanticKey: 'schedule:condition',
146
- observationThreshold: 2,
147
- },
128
+ condition: { kind: 'repository_clean' },
148
129
  },
149
130
  });
150
131
  const conditionOccurrence = await evaluateSchedule(controllerHome, conditionSchedule);