@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
@@ -224,19 +224,8 @@ active_slug_or_empty() {
224
224
  plan_slug_from_path "$active_plan"
225
225
  }
226
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
227
  require_finish_ready() {
239
- local contract_file="" review_file="" checks_file=".ai/harness/checks/latest.json" checks_error=""
228
+ local contract_file="" checks_file=".ai/harness/checks/latest.json" checks_error=""
240
229
 
241
230
  [[ -x "scripts/contract-worktree.sh" ]] || fail "scripts/contract-worktree.sh is missing or not executable"
242
231
  [[ -x "scripts/verify-sprint.sh" ]] || fail "scripts/verify-sprint.sh is missing or not executable"
@@ -245,27 +234,11 @@ require_finish_ready() {
245
234
  if declare -F workflow_active_contract >/dev/null 2>&1; then
246
235
  contract_file="$(workflow_active_contract 2>/dev/null || true)"
247
236
  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
237
  if declare -F workflow_checks_file >/dev/null 2>&1; then
252
238
  checks_file="$(workflow_checks_file)"
253
239
  fi
254
240
 
255
241
  [[ -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
242
 
270
243
  run_cmd bash "scripts/verify-sprint.sh"
271
244
  if [[ "$DRY_RUN" -eq 1 ]]; then
@@ -273,7 +246,7 @@ require_finish_ready() {
273
246
  fi
274
247
 
275
248
  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
249
+ if ! checks_error="$(workflow_checks_pass "$checks_file" "$contract_file")"; then
277
250
  fail "$checks_error"
278
251
  fi
279
252
  elif ! grep -Eq '"status"[[:space:]]*:[[:space:]]*"pass"' "$checks_file"; then
@@ -69,24 +69,6 @@ read_contract_status() {
69
69
  awk '/^> \*\*Status\*\*:/ {sub(/^.*> \*\*Status\*\*: */, ""); gsub(/\r/, ""); print; exit}' "$file" | xargs
70
70
  }
71
71
 
72
- read_contract_review_file() {
73
- local file="$1"
74
- local line=""
75
- local value=""
76
-
77
- line="$(grep -m 1 -E '^> \*\*Review File\*\*:' "$file" || true)"
78
- [[ -n "$line" ]] || return 0
79
-
80
- if [[ "$line" == *\`* ]]; then
81
- value="${line#*\`}"
82
- value="${value%%\`*}"
83
- else
84
- value="${line#*> **Review File**:}"
85
- fi
86
-
87
- printf '%s' "$value" | tr -d '\r' | sed -E 's/^[[:space:]]+//; s/[[:space:]]+$//'
88
- }
89
-
90
72
  read_contract_task_profile() {
91
73
  local file="$1"
92
74
  awk '/^> \*\*Task Profile\*\*:/ {sub(/^.*> \*\*Task Profile\*\*:[[:space:]]*/, ""); gsub(/\r/, ""); print; exit}' "$file" | xargs
@@ -130,36 +112,6 @@ contract_allowed_paths() {
130
112
  '
131
113
  }
132
114
 
133
- review_recommends_pass() {
134
- local review_file="$1"
135
- [[ -n "$review_file" && -f "$review_file" ]] || return 1
136
- grep -Eq '^> \*\*Recommendation\*\*:[[:space:]]*pass[[:space:]]*$' "$review_file"
137
- }
138
-
139
- review_score() {
140
- local review_file="$1"
141
- local dimension="$2"
142
-
143
- [[ -n "$review_file" && -f "$review_file" ]] || return 1
144
-
145
- awk -F'|' -v wanted="$dimension" '
146
- function trim(s) {
147
- gsub(/^[[:space:]]+/, "", s)
148
- gsub(/[[:space:]]+$/, "", s)
149
- return s
150
- }
151
- BEGIN { wanted = tolower(wanted) }
152
- /^\|/ {
153
- dim = tolower(trim($2))
154
- score = trim($3)
155
- if (dim == wanted && match(score, /[0-9]+/)) {
156
- print substr(score, RSTART, RLENGTH)
157
- exit
158
- }
159
- }
160
- ' "$review_file"
161
- }
162
-
163
115
  update_contract_status() {
164
116
  local file="$1"
165
117
  local status="$2"
@@ -385,14 +337,9 @@ declare -a contain_patterns=()
385
337
  declare -a files_not_exist=()
386
338
  declare -a not_contain_paths=()
387
339
  declare -a not_contain_patterns=()
388
- declare -a qa_dimensions=()
389
- declare -a qa_mins=()
390
- declare -a manual_checks=()
391
340
 
392
341
  section=""
393
342
  pending_path=""
394
- pending_dimension=""
395
- review_file="$(read_contract_review_file "$contract_file" || true)"
396
343
  task_profile="$(read_contract_task_profile "$contract_file" || true)"
397
344
  declare -a allowed_paths=()
398
345
  while IFS= read -r allowed_path; do
@@ -443,21 +390,10 @@ while IFS= read -r raw_line; do
443
390
  pending_path=""
444
391
  continue
445
392
  ;;
446
- qa_scores:)
447
- section="qa_scores"
448
- pending_path=""
449
- pending_dimension=""
450
- continue
451
- ;;
452
- manual_checks:)
453
- section="manual_checks"
454
- pending_path=""
455
- continue
456
- ;;
457
393
  esac
458
394
 
459
395
  case "$section" in
460
- files_exist|commands_succeed|files_not_exist|artifacts_exist|manual_checks)
396
+ files_exist|commands_succeed|files_not_exist|artifacts_exist)
461
397
  if [[ "$trimmed" =~ ^-[[:space:]]*(.+)$ ]]; then
462
398
  item="$(strip_quotes "${BASH_REMATCH[1]}")"
463
399
  [[ -n "$item" ]] || continue
@@ -467,8 +403,6 @@ while IFS= read -r raw_line; do
467
403
  commands_succeed+=("$item")
468
404
  elif [[ "$section" == "artifacts_exist" ]]; then
469
405
  artifacts_exist+=("$item")
470
- elif [[ "$section" == "manual_checks" ]]; then
471
- manual_checks+=("$item")
472
406
  else
473
407
  files_not_exist+=("$item")
474
408
  fi
@@ -497,19 +431,6 @@ while IFS= read -r raw_line; do
497
431
  fi
498
432
  fi
499
433
  ;;
500
- qa_scores)
501
- if [[ "$trimmed" =~ ^-[[:space:]]*dimension:[[:space:]]*(.+)$ ]]; then
502
- pending_dimension="$(strip_quotes "${BASH_REMATCH[1]}")"
503
- elif [[ "$trimmed" =~ ^dimension:[[:space:]]*(.+)$ ]]; then
504
- pending_dimension="$(strip_quotes "${BASH_REMATCH[1]}")"
505
- elif [[ "$trimmed" =~ ^min:[[:space:]]*([0-9]+)$ ]]; then
506
- if [[ -n "$pending_dimension" ]]; then
507
- qa_dimensions+=("$pending_dimension")
508
- qa_mins+=("${BASH_REMATCH[1]}")
509
- pending_dimension=""
510
- fi
511
- fi
512
- ;;
513
434
  esac
514
435
  done <<< "$yaml_block"
515
436
  if ((${#tests_pass[@]} || ${#commands_succeed[@]})); then
@@ -602,37 +523,6 @@ if ((${#commands_succeed[@]})); then
602
523
  done
603
524
  fi
604
525
 
605
- if ((${#qa_dimensions[@]})); then
606
- for idx in "${!qa_dimensions[@]}"; do
607
- dimension="${qa_dimensions[$idx]}"
608
- min_score="${qa_mins[$idx]}"
609
- score="$(review_score "$review_file" "$dimension" || true)"
610
-
611
- if [[ "$score" =~ ^[0-9]+$ && "$score" -ge "$min_score" ]]; then
612
- pass "qa_scores" "$dimension" "qa_scores: $dimension ${score}/${min_score}"
613
- else
614
- fail "qa_scores" "$dimension" "qa_scores: $dimension score ${score:-missing} < $min_score"
615
- fi
616
- done
617
- fi
618
-
619
- if ((${#manual_checks[@]})); then
620
- for check in "${manual_checks[@]}"; do
621
- case "$check" in
622
- "Evaluator review file recommends pass")
623
- if review_recommends_pass "$review_file"; then
624
- pass "manual_checks" "$check" "manual_checks: $check"
625
- else
626
- fail "manual_checks" "$check" "manual_checks: $check"
627
- fi
628
- ;;
629
- *)
630
- fail "manual_checks" "$check" "manual_checks unsupported: $check"
631
- ;;
632
- esac
633
- done
634
- fi
635
-
636
526
  if ((${#contain_paths[@]})); then
637
527
  for idx in "${!contain_paths[@]}"; do
638
528
  path="${contain_paths[$idx]}"
@@ -20,54 +20,6 @@ json_escape() {
20
20
  printf '%s' "$value"
21
21
  }
22
22
 
23
- review_card_field() {
24
- local file="$1"
25
- local label="$2"
26
- [[ -n "$file" && -f "$file" ]] || return 1
27
- awk -v wanted="$label" '
28
- function trim(s) {
29
- gsub(/^[[:space:]]+/, "", s)
30
- gsub(/[[:space:]]+$/, "", s)
31
- return s
32
- }
33
- BEGIN { wanted = tolower(wanted) }
34
- /^##[[:space:]]+Human Review Card[[:space:]]*$/ { in_section = 1; next }
35
- in_section && /^##[[:space:]]+/ { exit }
36
- !in_section { next }
37
- /^[[:space:]]*-[[:space:]]*/ {
38
- line = $0
39
- sub(/^[[:space:]]*-[[:space:]]*/, "", line)
40
- key = line
41
- sub(/:.*/, "", key)
42
- key = tolower(trim(key))
43
- if (key == wanted) {
44
- sub(/^[^:]*:[[:space:]]*/, "", line)
45
- print trim(line)
46
- exit
47
- }
48
- }
49
- ' "$file"
50
- }
51
-
52
- normalize_status_token() {
53
- local value="$1"
54
- value="$(printf '%s' "$value" | sed -E 's/[;,].*$//; s/[[:space:]].*$//; s/^[[:space:]]+//; s/[[:space:]]+$//' | tr '[:upper:]' '[:lower:]')"
55
- printf '%s' "$value"
56
- }
57
-
58
- field_has_concrete_value() {
59
- local value="$1"
60
- local token
61
- token="$(normalize_status_token "$value")"
62
- [[ -n "$token" ]] || return 1
63
- case "$token" in
64
- tbd|todo|n/a|na|none|unknown|unavailable|pending|...)
65
- return 1
66
- ;;
67
- esac
68
- return 0
69
- }
70
-
71
23
  read_contract_task_profile() {
72
24
  local file="$1"
73
25
  awk '/^> \*\*Task Profile\*\*:/ {sub(/^.*> \*\*Task Profile\*\*:[[:space:]]*/, ""); gsub(/\r/, ""); print; exit}' "$file" | xargs
@@ -304,25 +256,14 @@ if [[ -f ".ai/hooks/lib/workflow-state.sh" ]]; then
304
256
  # shellcheck source=/dev/null
305
257
  . ".ai/hooks/lib/workflow-state.sh"
306
258
  contract_file="$(workflow_active_contract || true)"
307
- review_file="$(workflow_active_review || true)"
308
259
  checks_file="$(workflow_checks_file)"
309
260
  else
310
261
  contract_file="$(find tasks/contracts -maxdepth 1 -name '*.contract.md' -type f 2>/dev/null | sort | head -n 1)"
311
- if [[ -n "$contract_file" ]]; then
312
- contract_slug="$(basename "$contract_file" | sed -E 's/\.contract\.md$//')"
313
- review_file="tasks/reviews/${contract_slug}.review.md"
314
- else
315
- review_file=""
316
- fi
317
262
  checks_file=".ai/harness/checks/latest.json"
318
263
  fi
319
264
  if [[ -z "$contract_file" || ! -f "$contract_file" ]]; then
320
265
  contract_file="$(active_plan_declared_path "Task Contract" || active_plan_declared_path "Sprint Contract" || true)"
321
266
  fi
322
- if [[ -z "$review_file" || ! -f "$review_file" ]]; then
323
- review_file="$(active_plan_declared_path "Task Review" || active_plan_declared_path "Sprint Review" || true)"
324
- fi
325
-
326
267
  [[ -n "$contract_file" && -f "$contract_file" ]] || { echo "No active sprint contract found" >&2; exit 1; }
327
268
 
328
269
  generated_at="$(date '+%Y-%m-%dT%H:%M:%S%z')"
@@ -378,74 +319,9 @@ if [[ -n "$contract_output" ]]; then
378
319
  printf '%s\n' "$contract_output"
379
320
  fi
380
321
 
381
- review_status="fail"
382
- review_message="Task review recommends pass and Human Review Card verdict is pass."
383
- review_card_verdict=""
384
- review_card_external=""
385
- review_card_change_type=""
386
- review_card_rollback=""
387
- if [[ -z "$review_file" || ! -f "$review_file" ]]; then
388
- review_message="Missing task review file."
389
- echo "Missing task review file" >&2
390
- else
391
- review_card_verdict="$(normalize_status_token "$(review_card_field "$review_file" "Verdict" || true)")"
392
- review_card_external="$(review_card_field "$review_file" "External acceptance" || true)"
393
- review_card_change_type="$(normalize_status_token "$(review_card_field "$review_file" "Change type" || true)")"
394
- review_card_rollback="$(review_card_field "$review_file" "Rollback" || true)"
395
- fi
396
-
397
- if [[ -n "$review_file" && -f "$review_file" ]]; then
398
- if ! grep -Eq '^> \*\*Recommendation\*\*:[[:space:]]*pass([[:space:]]*)$' "$review_file"; then
399
- review_message="Task review does not recommend pass."
400
- echo "Task review does not recommend pass" >&2
401
- elif [[ -z "$review_card_verdict" ]]; then
402
- review_message="Task review is missing Human Review Card verdict."
403
- echo "Task review is missing Human Review Card verdict" >&2
404
- elif [[ "$review_card_verdict" != "pass" ]]; then
405
- review_message="Human Review Card verdict is not pass: $review_card_verdict"
406
- echo "Human Review Card verdict is not pass: $review_card_verdict" >&2
407
- elif [[ -n "$task_profile" && "$review_card_change_type" != "$task_profile" ]]; then
408
- review_message="Human Review Card change type does not match task_profile: ${review_card_change_type:-missing} != $task_profile"
409
- echo "$review_message" >&2
410
- elif ! field_has_concrete_value "$review_card_rollback"; then
411
- review_message="Human Review Card rollback is missing or not concrete."
412
- echo "$review_message" >&2
413
- else
414
- review_status="pass"
415
- fi
416
- fi
417
-
418
- external_status="missing"
419
- external_reviewer=""
420
- external_source=""
421
- external_message="External acceptance status is unavailable."
422
- if declare -F workflow_external_acceptance_status >/dev/null 2>&1; then
423
- external_row="$(workflow_external_acceptance_status "$review_file")"
424
- IFS=$'\t' read -r external_status external_reviewer external_source external_message <<< "$external_row"
425
- fi
426
- card_external_status="$(normalize_status_token "$review_card_external")"
427
- case "$external_status" in
428
- missing|unavailable|"")
429
- case "$card_external_status" in
430
- pass|manual_override|not_required)
431
- external_status="$card_external_status"
432
- external_message="Human Review Card external acceptance: $review_card_external"
433
- ;;
434
- esac
435
- ;;
436
- esac
437
-
438
322
  status="fail"
439
323
  exit_code=1
440
- case "$external_status" in
441
- pass|manual_override|not_required)
442
- external_gate="pass"
443
- ;;
444
- *)
445
- external_gate="fail"
446
- ;;
447
- esac
448
- if [[ "$contract_exit" -eq 0 && "$review_status" == "pass" && "$external_gate" == "pass" && "$allowed_paths_status" == "pass" ]]; then
324
+ if [[ "$contract_exit" -eq 0 && "$allowed_paths_status" == "pass" ]]; then
449
325
  status="pass"
450
326
  exit_code=0
451
327
  fi
@@ -456,10 +332,6 @@ fi
456
332
  if [[ -z "$failure_class" && "$status" != "pass" ]]; then
457
333
  if [[ "$contract_exit" -ne 0 ]]; then
458
334
  failure_class="contract"
459
- elif [[ "$review_status" != "pass" ]]; then
460
- failure_class="review"
461
- elif [[ "$external_gate" != "pass" ]]; then
462
- failure_class="external_acceptance"
463
335
  elif [[ "$allowed_paths_status" != "pass" ]]; then
464
336
  failure_class="allowed_paths"
465
337
  else
@@ -467,9 +339,9 @@ if [[ -z "$failure_class" && "$status" != "pass" ]]; then
467
339
  fi
468
340
  fi
469
341
  if [[ "$status" == "pass" ]]; then
470
- next_step="finish contract worktree or archive completed task"
342
+ next_step="perform a fresh semantic impact review, then finish contract worktree or archive completed task"
471
343
  else
472
- next_step="resolve failing contract, review, external acceptance, or allowed_paths gate"
344
+ next_step="resolve failing contract or allowed_paths evidence"
473
345
  fi
474
346
  handoff_current_exists=false
475
347
  handoff_resume_exists=false
@@ -492,17 +364,6 @@ if command -v jq >/dev/null 2>&1 && jq -e . "$contract_report" >/dev/null 2>&1;
492
364
  --arg contract_status "$([[ "$contract_exit" -eq 0 ]] && printf pass || printf fail)" \
493
365
  --arg contract_command "$contract_command" \
494
366
  --argjson contract_exit "$contract_exit" \
495
- --arg review_file "${review_file:-}" \
496
- --arg review_status "$review_status" \
497
- --arg review_message "$review_message" \
498
- --arg review_card_verdict "$review_card_verdict" \
499
- --arg review_card_change_type "$review_card_change_type" \
500
- --arg review_card_external "$review_card_external" \
501
- --arg review_card_rollback "$review_card_rollback" \
502
- --arg external_status "$external_status" \
503
- --arg external_reviewer "$external_reviewer" \
504
- --arg external_source "$external_source" \
505
- --arg external_message "$external_message" \
506
367
  --arg worktree "$worktree_path" \
507
368
  --arg branch "$branch_name" \
508
369
  --arg diff_base_ref "$diff_base_ref" \
@@ -538,8 +399,6 @@ if command -v jq >/dev/null 2>&1 && jq -e . "$contract_report" >/dev/null 2>&1;
538
399
  ],
539
400
  guards: [
540
401
  {name: "contract", status: $contract_status},
541
- {name: "review", status: $review_status},
542
- {name: "external_acceptance", status: $external_status},
543
402
  {name: "allowed_paths", status: ($allowed_paths_check.status // "unavailable")}
544
403
  ],
545
404
  handoffs: [
@@ -563,23 +422,6 @@ if command -v jq >/dev/null 2>&1 && jq -e . "$contract_report" >/dev/null 2>&1;
563
422
  report: ($contract_report[0] // {}),
564
423
  task_profile: $task_profile,
565
424
  allowed_paths: $allowed_paths
566
- },
567
- review: {
568
- file: $review_file,
569
- status: $review_status,
570
- message: $review_message,
571
- card: {
572
- verdict: $review_card_verdict,
573
- change_type: $review_card_change_type,
574
- external_acceptance: $review_card_external,
575
- rollback: $review_card_rollback
576
- }
577
- },
578
- external_acceptance: {
579
- status: $external_status,
580
- reviewer: $external_reviewer,
581
- source: $external_source,
582
- message: $external_message
583
425
  }
584
426
  }' > "$checks_report"
585
427
  else
@@ -617,8 +459,6 @@ else
617
459
  ],
618
460
  "guards": [
619
461
  {"name": "contract", "status": "$([[ "$contract_exit" -eq 0 ]] && printf pass || printf fail)"},
620
- {"name": "review", "status": "$(json_escape "$review_status")"},
621
- {"name": "external_acceptance", "status": "$(json_escape "$external_status")"},
622
462
  {"name": "allowed_paths", "status": "$(json_escape "$allowed_paths_status")"}
623
463
  ],
624
464
  "handoffs": [
@@ -644,23 +484,6 @@ else
644
484
  "exit_code": $contract_exit,
645
485
  "task_profile": "$(json_escape "$task_profile")",
646
486
  "allowed_paths": []
647
- },
648
- "review": {
649
- "file": "$(json_escape "${review_file:-}")",
650
- "status": "$(json_escape "$review_status")",
651
- "message": "$(json_escape "$review_message")",
652
- "card": {
653
- "verdict": "$(json_escape "$review_card_verdict")",
654
- "change_type": "$(json_escape "$review_card_change_type")",
655
- "external_acceptance": "$(json_escape "$review_card_external")",
656
- "rollback": "$(json_escape "$review_card_rollback")"
657
- }
658
- },
659
- "external_acceptance": {
660
- "status": "$(json_escape "$external_status")",
661
- "reviewer": "$(json_escape "$external_reviewer")",
662
- "source": "$(json_escape "$external_source")",
663
- "message": "$(json_escape "$external_message")"
664
487
  }
665
488
  }
666
489
  EOF_CHECKS
@@ -65,6 +65,10 @@ export type WorkflowContract = {
65
65
  helpers: {
66
66
  runtimeDirectory?: string;
67
67
  compatibilityDirectory?: string;
68
+ /** Legacy manifest field retained for installed contract compatibility. */
69
+ dir?: string;
70
+ /** Legacy runtime-source discriminator still present in v1 manifests. */
71
+ runtimeSource?: string;
68
72
  scripts: string[];
69
73
  };
70
74
  artifacts: {
@@ -185,7 +189,7 @@ export function getHelperScripts(contract: WorkflowContract): string[] {
185
189
  }
186
190
 
187
191
  export function getHelperRuntimeDir(contract: WorkflowContract): string {
188
- return contract.helpers.dir ?? "scripts";
192
+ return contract.helpers.runtimeDirectory ?? contract.helpers.dir ?? contract.helpers.compatibilityDirectory ?? "scripts";
189
193
  }
190
194
 
191
195
  export function getRequiredDirectories(contract: WorkflowContract): string[] {
@@ -66,7 +66,7 @@ Complete this inventory before implementation. If any line is unknown, keep the
66
66
 
67
67
  - **State/progress path**:
68
68
  - **Verification evidence**:
69
- - **Evaluator rubric**:
69
+ - **Impact review**:
70
70
  - **Stop condition**:
71
71
  - **Rollback surface**:
72
72
 
@@ -6,19 +6,15 @@
6
6
  > **Notes File**: {{NOTES_FILE}}
7
7
  > **Checks File**: {{CHECKS_FILE}}
8
8
  > **Last Updated**: {{TIMESTAMP}}
9
- > **Recommendation**: fail
9
+ > **Summary**:
10
10
 
11
- ## Human Review Card
11
+ ## Semantic Impact Review
12
12
 
13
- - Verdict: pending
14
- - Change type: code-change | docs-only | ledger-closeout | migration | eval-only | delegated-run
15
- - Intended files changed:
16
- - Actual files changed:
17
- - Commands passed:
18
- - External acceptance: unavailable
19
- - Residual risks:
20
- - Reviewer action required: inspect diff and card
21
- - Rollback:
13
+ - User intent:
14
+ - Affected domains and downstream consumers:
15
+ - State transitions and persistence/restart impact:
16
+ - Missing impact areas or uncertainty:
17
+ - Residual risks and recovery:
22
18
 
23
19
  ## Mode Evidence
24
20
 
@@ -28,26 +24,14 @@
28
24
 
29
25
  ## Verification Evidence
30
26
 
31
- - Waza `/check` run:
27
+ - Focused/full checks:
32
28
  - Commands run:
33
29
  - Manual checks:
34
30
  - Supporting artifacts:
35
31
  - Implementation notes reviewed:
36
32
  - Run snapshot:
37
33
 
38
- ## External Acceptance Advice
39
-
40
- > **External Acceptance**: unavailable
41
- > **External Reviewer**:
42
- > **External Source**:
43
- > **External Started**:
44
- > **External Completed**:
45
-
46
- - P1 blockers:
47
- - P2 advisories:
48
- - Acceptance checklist:
49
-
50
- ## Behavior Diff Notes
34
+ ## Scenario Evidence
51
35
 
52
36
  - ...
53
37
 
@@ -55,15 +39,6 @@
55
39
 
56
40
  - ...
57
41
 
58
- ## Scorecard
59
-
60
- | Dimension | Score | Notes |
61
- |-----------|-------|-------|
62
- | Functionality | 0/10 | |
63
- | Product depth | 0/10 | |
64
- | Design quality | 0/10 | |
65
- | Code quality | 0/10 | |
66
-
67
42
  ## Failing Items
68
43
 
69
44
  - ...
@@ -99,7 +99,6 @@
99
99
  "verify-contract.sh",
100
100
  "summarize-failures.sh",
101
101
  "verify-sprint.sh",
102
- "harness-trace-grade.sh",
103
102
  "sprint-backlog.sh",
104
103
  "check-task-sync.sh",
105
104
  "check-deploy-sql-order.sh",
@@ -112,8 +111,6 @@
112
111
  "select-agent-context-blocks.sh",
113
112
  "ensure-task-workflow.sh",
114
113
  "check-task-workflow.sh",
115
- "maintenance-triage.sh",
116
- "heartbeat-triage.sh",
117
114
  "switch-plan.sh",
118
115
  "workflow-contract.ts",
119
116
  "inspect-project-state.ts",
@@ -164,7 +161,6 @@
164
161
  ".ai/harness/local-jobs",
165
162
  ".ai/harness/controller",
166
163
  ".ai/harness/edit-sessions",
167
- ".ai/harness/triage",
168
164
  "docs/architecture",
169
165
  "docs/architecture/domains",
170
166
  "docs/architecture/modules",
@@ -204,7 +200,6 @@
204
200
  "scripts/verify-contract.sh",
205
201
  "scripts/summarize-failures.sh",
206
202
  "scripts/verify-sprint.sh",
207
- "scripts/harness-trace-grade.sh",
208
203
  "scripts/sprint-backlog.sh",
209
204
  "scripts/check-task-sync.sh",
210
205
  "scripts/check-deploy-sql-order.sh",
@@ -216,8 +211,6 @@
216
211
  "scripts/select-agent-context-blocks.sh",
217
212
  "scripts/ensure-task-workflow.sh",
218
213
  "scripts/check-task-workflow.sh",
219
- "scripts/maintenance-triage.sh",
220
- "scripts/heartbeat-triage.sh",
221
214
  "scripts/switch-plan.sh",
222
215
  "scripts/workflow-contract.ts",
223
216
  "scripts/inspect-project-state.ts",
@@ -246,7 +239,6 @@
246
239
  "docs/reference-configs/agentic-development-flow.md",
247
240
  "docs/reference-configs/external-tooling.md",
248
241
  "docs/reference-configs/sprint-contracts.md",
249
- "docs/reference-configs/heartbeat-triage.md",
250
242
  "docs/reference-configs/handoff-protocol.md",
251
243
  "docs/reference-configs/document-generation.md",
252
244
  "docs/reference-configs/global-working-rules.md",
@@ -271,9 +263,7 @@
271
263
  ".ai/harness/worktrees/",
272
264
  ".ai/harness/runs/.gitkeep",
273
265
  ".ai/harness/local-jobs/",
274
- ".ai/harness/controller/",
275
- ".ai/harness/triage/.gitkeep",
276
- ".ai/harness/triage/inbox.md"
266
+ ".ai/harness/controller/"
277
267
  ]
278
268
  },
279
269
  "documents": {
@@ -519,15 +509,16 @@
519
509
  "scripts/check-context-files.sh",
520
510
  "scripts/check-deploy-sql-order.sh",
521
511
  "scripts/check-skill-version.ts",
522
- "scripts/check-task-sync.sh",
523
- "scripts/check-task-workflow.sh",
524
- "scripts/codex-handoff-resume.sh",
512
+ "scripts/check-task-sync.sh",
513
+ "scripts/check-task-workflow.sh",
514
+ "scripts/harness-trace-grade.sh",
515
+ "scripts/codex-handoff-resume.sh",
525
516
  "scripts/context-contract-sync.sh",
526
- "scripts/contract-run.ts",
527
- "scripts/contract-worktree.sh",
528
- "scripts/ensure-task-workflow.sh",
529
- "scripts/heartbeat-triage.sh",
530
- "scripts/inspect-project-state.ts",
517
+ "scripts/contract-run.ts",
518
+ "scripts/contract-worktree.sh",
519
+ "scripts/ensure-task-workflow.sh",
520
+ "scripts/heartbeat-triage.sh",
521
+ "scripts/inspect-project-state.ts",
531
522
  "scripts/maintenance-triage.sh",
532
523
  "scripts/migrate-project-template.sh",
533
524
  "scripts/migrate-workflow-docs.ts",