@moretea-labs/forge 1.5.1 → 1.7.0

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 (434) hide show
  1. package/AGENTS.md +2 -0
  2. package/CHANGELOG.md +46 -0
  3. package/CLAUDE.md +2 -0
  4. package/DESIGN.md +7 -2
  5. package/README.md +4 -4
  6. package/README.zh-CN.md +2 -2
  7. package/SKILL.md +2 -2
  8. package/THIRD_PARTY_NOTICES.md +1 -1
  9. package/agents/openai.yaml +1 -1
  10. package/assets/hooks/hook-input.sh +11 -8
  11. package/assets/hooks/lib/session-state.sh +10 -7
  12. package/assets/hooks/lib/workflow-state.sh +13 -177
  13. package/assets/hooks/post-tool-observer.sh +8 -2
  14. package/assets/hooks/pre-edit-guard.sh +8 -39
  15. package/assets/hooks/prompt-guard.sh +7 -83
  16. package/assets/hooks/session-start-context.sh +56 -1
  17. package/assets/partials/05-workflow.partial.md +1 -1
  18. package/assets/partials-agents/03-orchestration.partial.md +1 -1
  19. package/assets/plugin-registry.v1.json +54 -3
  20. package/assets/reference-configs/document-generation.md +1 -1
  21. package/assets/reference-configs/harness-overview.md +1 -1
  22. package/assets/reference-configs/hook-operations.md +1 -1
  23. package/assets/reference-configs/sprint-contracts.md +3 -3
  24. package/assets/skill-version.json +2 -2
  25. package/assets/templates/contract.template.md +2 -7
  26. package/assets/templates/helpers/capture-plan.sh +2 -2
  27. package/assets/templates/helpers/check-task-workflow.sh +4 -4
  28. package/assets/templates/helpers/contract-worktree.sh +1 -21
  29. package/assets/templates/helpers/ensure-task-workflow.sh +13 -38
  30. package/assets/templates/helpers/migrate-project-template.sh +22 -45
  31. package/assets/templates/helpers/new-plan.sh +1 -1
  32. package/assets/templates/helpers/plan-to-todo.sh +12 -37
  33. package/assets/templates/helpers/ship-worktrees.sh +2 -29
  34. package/assets/templates/helpers/sprint-backlog.sh +6 -6
  35. package/assets/templates/helpers/verify-contract.sh +1 -111
  36. package/assets/templates/helpers/verify-sprint.sh +3 -180
  37. package/assets/templates/plan.template.md +1 -1
  38. package/assets/templates/review.template.md +9 -34
  39. package/assets/workflow-contract.v1.json +10 -19
  40. package/docs/README.md +10 -10
  41. package/docs/architecture/CURRENT.md +170 -0
  42. package/docs/architecture/EVOLUTION.md +42 -0
  43. package/docs/architecture/current/README.md +4 -156
  44. package/docs/architecture/decisions/20260803-release-identity-binding-and-exit-policy.md +2 -2
  45. package/docs/architecture/decisions/20260823-immediate-controller-relay.md +53 -0
  46. package/docs/architecture/decisions/20260826-browser-runtime-v2.md +73 -0
  47. package/docs/architecture/history/README.md +7 -0
  48. package/docs/architecture/{chatgpt-handoff-facade.md → history/chatgpt-handoff-facade.md} +4 -0
  49. package/docs/architecture/{global-hook-runtime.md → history/global-hook-runtime.md} +7 -3
  50. package/docs/architecture/{ios-semantic-automation-provider-v2.md → history/ios-semantic-automation-provider-v2.md} +6 -2
  51. package/docs/architecture/history.md +3 -34
  52. package/docs/architecture/index.md +15 -98
  53. package/docs/architecture/modules/controller-runtime/transport-lifecycle.md +1 -1
  54. package/docs/architecture/reviews/2026-08-22-semantic-harness-convergence-acceptance.md +39 -0
  55. package/docs/architecture/versions/1.6.md +38 -0
  56. package/docs/architecture/versions/1.7.md +41 -0
  57. package/docs/forge-chatgpt-browser-engine.md +2 -2
  58. package/docs/forge-chatgpt-mcp-setup.md +4 -28
  59. package/docs/forge-chatgpt-supervised-automation.md +3 -3
  60. package/docs/forge-github-issue-launcher.md +1 -1
  61. package/docs/forge-runtime-self-healing-loop.md +1 -1
  62. package/docs/operations/controller-browser-plugin.md +38 -22
  63. package/docs/operations/controller-performance-and-502.md +124 -0
  64. package/docs/operations/controller-reliability-runbook.md +1 -1
  65. package/docs/operations/features.md +3 -3
  66. package/docs/operations/github-repository.md +1 -1
  67. package/docs/operations/homebrew.md +2 -2
  68. package/docs/operations/mcp-tool-exposure.md +5 -3
  69. package/docs/tutorials/01-install-and-start.md +1 -1
  70. package/docs/tutorials/01-install-and-start.zh-CN.md +1 -1
  71. package/docs/wiki/Architecture.md +6 -6
  72. package/docs/wiki/Implementation.md +2 -2
  73. package/docs/wiki/Installation.md +1 -1
  74. package/docs/wiki/Integrations.md +2 -2
  75. package/docs/wiki/Quick-Start.md +1 -1
  76. package/docs/wiki/Work-Lifecycle.md +1 -1
  77. package/package.json +29 -10
  78. package/scripts/activate-source-baseline.ts +17 -13
  79. package/scripts/benchmark-background-check-overlap.ts +228 -0
  80. package/scripts/benchmark-mcp-host.sh +117 -0
  81. package/scripts/benchmark-mcp-transport.ts +170 -0
  82. package/scripts/benchmark-quality-harness.ts +146 -0
  83. package/scripts/benchmark-route-session-concurrency.ts +207 -6
  84. package/scripts/benchmark-thin-harness-mcp-e2e.ts +7 -1
  85. package/scripts/benchmark-typescript-navigation.ts +186 -0
  86. package/scripts/benchmark-work-efficiency.ts +334 -0
  87. package/scripts/capture-plan.sh +3 -3
  88. package/scripts/check-agent-tooling.sh +8 -35
  89. package/scripts/check-architecture-sync.sh +17 -86
  90. package/scripts/check-mcp-compatibility.ts +14 -0
  91. package/scripts/check-public-docs.sh +14 -1
  92. package/scripts/check-runtime-architecture.mjs +107 -64
  93. package/scripts/check-stable-baseline.ts +92 -0
  94. package/scripts/check-task-workflow.sh +4 -4
  95. package/scripts/contract-worktree.sh +1 -21
  96. package/scripts/ensure-task-workflow.sh +22 -55
  97. package/scripts/host-temporary-cloud-mcp-e2e.sh +265 -0
  98. package/scripts/install-standalone-recovery.ts +24 -0
  99. package/scripts/lib/project-init-lib.sh +15 -44
  100. package/scripts/migrate-chatgpt-automation-schedules.ts +64 -0
  101. package/scripts/migrate-project-template.sh +23 -1179
  102. package/scripts/new-plan.sh +1 -1
  103. package/scripts/plan-to-todo.sh +11 -36
  104. package/scripts/run-governed-gate.ts +2 -1
  105. package/scripts/ship-worktrees.sh +2 -29
  106. package/scripts/smoke-ios-physical-device.ts +4 -2
  107. package/scripts/smoke-runtime-recovery.ts +1 -35
  108. package/scripts/smoke-schedule-engine.ts +1 -20
  109. package/scripts/sprint-backlog.sh +1 -1
  110. package/scripts/verify-contract.sh +1 -111
  111. package/scripts/verify-forge-runtime.sh +0 -1
  112. package/scripts/verify-sprint.sh +3 -180
  113. package/scripts/workflow-contract.ts +1 -5
  114. package/src/cli/commands/chatgpt.ts +31 -2
  115. package/src/cli/commands/init-hook.ts +3 -3
  116. package/src/cli/commands/mcp.ts +9 -5
  117. package/src/cli/commands/plugin.ts +37 -10
  118. package/src/cli/commands/recovery.ts +25 -3
  119. package/src/cli/commands/runtime.ts +55 -3
  120. package/src/cli/commands/security.ts +12 -1
  121. package/src/cli/commands/setup-profile.ts +31 -21
  122. package/src/cli/controller/check-runner.ts +106 -3
  123. package/src/cli/controller/composite-result.ts +1 -1
  124. package/src/cli/controller/context/focus.ts +51 -0
  125. package/src/cli/controller/context/instruction-context.ts +114 -0
  126. package/src/cli/controller/context/known-paths.ts +76 -0
  127. package/src/cli/controller/context/query-planning.ts +110 -0
  128. package/src/cli/controller/context/rule-resolution.ts +532 -0
  129. package/src/cli/controller/context/source-materializer.ts +278 -0
  130. package/src/cli/controller/context/structural.ts +16 -0
  131. package/src/cli/controller/context/types.ts +286 -0
  132. package/src/cli/controller/context-pack.ts +898 -430
  133. package/src/cli/controller/launch-agents.ts +77 -2
  134. package/src/cli/controller/operational-plan.ts +2 -2
  135. package/src/cli/controller/work-mode.ts +6 -4
  136. package/src/cli/editing/edit-session.ts +60 -7
  137. package/src/cli/github/github.ts +133 -0
  138. package/src/cli/hook/prompt-guard-decision.ts +17 -18
  139. package/src/cli/hook/prompt-intents.ts +1 -1
  140. package/src/cli/installer/managed-entries.ts +15 -1
  141. package/src/cli/local-bridge/console-automations.ts +225 -67
  142. package/src/cli/local-bridge/console-view-models.ts +3 -35
  143. package/src/cli/local-bridge/facade-api.ts +2 -217
  144. package/src/cli/local-bridge/frontend/src/App.tsx +3 -3
  145. package/src/cli/local-bridge/frontend/src/features/automations/AutomationsView.tsx +153 -3
  146. package/src/cli/local-bridge/frontend/src/features/capabilities/CapabilitiesView.tsx +37 -4
  147. package/src/cli/local-bridge/frontend/src/features/overview/OverviewView.tsx +183 -3
  148. package/src/cli/local-bridge/frontend/src/features/repositories/RepositoriesView.tsx +1 -1
  149. package/src/cli/local-bridge/frontend/src/features/work/WorkView.tsx +4 -3
  150. package/src/cli/local-bridge/frontend/src/lib/api.ts +18 -11
  151. package/src/cli/local-bridge/frontend/src/lib/routes.ts +1 -1
  152. package/src/cli/local-bridge/frontend/src/shell/CommandBar.tsx +1 -1
  153. package/src/cli/local-bridge/frontend/src/shell/Sidebar.tsx +4 -3
  154. package/src/cli/local-bridge/frontend/src/styles.css +27 -11
  155. package/src/cli/local-bridge/frontend/src/types.ts +8 -7
  156. package/src/cli/local-bridge/job-store.ts +1 -490
  157. package/src/cli/local-bridge/server.ts +29 -532
  158. package/src/cli/local-bridge/ui-dist/app.css +1 -1
  159. package/src/cli/local-bridge/ui-dist/app.js +5101 -4967
  160. package/src/cli/mcp/auth.ts +5 -5
  161. package/src/cli/mcp/instructions.ts +3 -2
  162. package/src/cli/mcp/legacy-tool-service.ts +0 -189
  163. package/src/cli/mcp/multi-repository.ts +16 -5
  164. package/src/cli/mcp/oauth.ts +175 -26
  165. package/src/cli/mcp/paths.ts +8 -2
  166. package/src/cli/mcp/repository-tools.ts +356 -101
  167. package/src/cli/mcp/server.ts +625 -54
  168. package/src/cli/mcp/tool-capability-cache.ts +1 -1
  169. package/src/cli/mcp/toolset-selection.ts +1 -1
  170. package/src/cli/mcp/toolset.ts +42 -5
  171. package/src/cli/mcp/transports/http.ts +125 -15
  172. package/src/cli/mcp/transports/session-registry.ts +67 -5
  173. package/src/cli/mcp/types.ts +3 -3
  174. package/src/cli/repositories/command-classifier.ts +209 -14
  175. package/src/cli/repositories/command-executor.ts +55 -521
  176. package/src/cli/repositories/command-process.ts +108 -0
  177. package/src/cli/repositories/command-scope.ts +99 -41
  178. package/src/cli/repositories/controller-home.ts +7 -8
  179. package/src/cli/repositories/git-command-executor.ts +2 -0
  180. package/src/cli/repositories/locks.ts +53 -16
  181. package/src/cli/repositories/repository-snapshot.ts +121 -0
  182. package/src/cli/repositories/safe-patch.ts +6 -4
  183. package/src/cli/repositories/selected-path-actions.ts +17 -9
  184. package/src/cli/repositories/structured-git.ts +110 -10
  185. package/src/cli/repository/inspector.ts +565 -62
  186. package/src/cli/repository/session-cache.ts +58 -17
  187. package/src/cli/v81-entry.ts +1 -4
  188. package/src/effects/fs-transaction.ts +85 -17
  189. package/src/runtime/context/codegraph-read-provider.ts +233 -2
  190. package/src/runtime/context/codegraph-sidecar.cjs +74 -40
  191. package/src/runtime/context/generic-lsp-provider.ts +355 -0
  192. package/src/runtime/context/lsp-client.ts +283 -0
  193. package/src/runtime/context/semantic-navigation.ts +275 -0
  194. package/src/runtime/context/swift-navigation.ts +565 -0
  195. package/src/runtime/context/typescript-navigation.ts +226 -0
  196. package/src/runtime/control-plane/dispatch-priority.ts +28 -0
  197. package/src/runtime/control-plane/execution/direct-edit-work-completion.ts +196 -2
  198. package/src/runtime/control-plane/execution/edit-validation-coordinator.ts +86 -24
  199. package/src/runtime/control-plane/execution/execution-identity.ts +65 -14
  200. package/src/runtime/control-plane/execution/session-store.ts +18 -0
  201. package/src/runtime/control-plane/execution/validation.ts +15 -2
  202. package/src/runtime/control-plane/execution/verification-evidence.ts +58 -3
  203. package/src/runtime/control-plane/execution/work-handle-store.ts +27 -2
  204. package/src/runtime/control-plane/execution/work-lifecycle-audit.ts +258 -0
  205. package/src/runtime/control-plane/execution/work-remote-delivery.ts +215 -0
  206. package/src/runtime/control-plane/execution/work-task-receipt.ts +54 -11
  207. package/src/runtime/control-plane/execution/work-terminal-cleanup.ts +175 -8
  208. package/src/runtime/control-plane/execution/work-validation-reconciler.ts +28 -21
  209. package/src/runtime/control-plane/execution/work-verification-snapshot.ts +87 -9
  210. package/src/runtime/control-plane/facade/capability-registry.ts +129 -25
  211. package/src/runtime/control-plane/facade/controller-round-relay.ts +991 -0
  212. package/src/runtime/control-plane/facade/controller-session-store.ts +144 -14
  213. package/src/runtime/control-plane/facade/goal-workloop-access.ts +9 -2
  214. package/src/runtime/control-plane/facade/goal-workloop.ts +885 -105
  215. package/src/runtime/control-plane/facade/index.ts +1 -0
  216. package/src/runtime/control-plane/facade/plan-contract-store.ts +211 -26
  217. package/src/runtime/control-plane/facade/requirement-board.ts +24 -8
  218. package/src/runtime/control-plane/facade/semantic-admission.ts +205 -0
  219. package/src/runtime/control-plane/facade/suggested-actions.ts +5 -1
  220. package/src/runtime/control-plane/facade/types.ts +55 -11
  221. package/src/runtime/control-plane/facade/work-contract-store.ts +204 -73
  222. package/src/runtime/control-plane/generated-cache-retention.ts +271 -0
  223. package/src/runtime/control-plane/global-scheduler/config.ts +44 -0
  224. package/src/runtime/control-plane/global-scheduler/dispatch-capacity.ts +80 -0
  225. package/src/runtime/control-plane/global-scheduler/durable-admission.ts +46 -0
  226. package/src/runtime/control-plane/global-scheduler/maintenance.ts +145 -0
  227. package/src/runtime/control-plane/global-scheduler/projection-refresh.ts +84 -0
  228. package/src/runtime/control-plane/global-scheduler/reconciliation.ts +3 -3
  229. package/src/runtime/control-plane/global-scheduler/scheduler.ts +273 -542
  230. package/src/runtime/control-plane/global-scheduler/source-scan.ts +59 -0
  231. package/src/runtime/control-plane/global-scheduler/state.ts +88 -0
  232. package/src/runtime/control-plane/global-scheduler/worker-attachment.ts +57 -0
  233. package/src/runtime/control-plane/global-scheduler/worker-exit-decision.ts +38 -0
  234. package/src/runtime/control-plane/global-scheduler/worker-exit-reconciler.ts +175 -0
  235. package/src/runtime/control-plane/global-scheduler/worker-launch.ts +111 -0
  236. package/src/runtime/control-plane/global-scheduler/worker-lifecycle-store.ts +64 -0
  237. package/src/runtime/control-plane/global-scheduler/worker-lifecycle.ts +150 -0
  238. package/src/runtime/control-plane/global-scheduler/worker-process.ts +119 -0
  239. package/src/runtime/control-plane/global-scheduler/worker-stderr.ts +60 -0
  240. package/src/runtime/control-plane/launcher/chatgpt-work-binding-store.ts +50 -0
  241. package/src/runtime/control-plane/launcher/chatgpt-work-continuation.ts +642 -51
  242. package/src/runtime/control-plane/launcher/launch-reservation-store.ts +40 -0
  243. package/src/runtime/control-plane/launcher/thin-launcher.ts +194 -10
  244. package/src/runtime/control-plane/persistence/controller-home-migration.ts +487 -0
  245. package/src/runtime/control-plane/persistence/requirement-store.ts +15 -11
  246. package/src/runtime/control-plane/persistence/sqlite-store.ts +33 -2
  247. package/src/runtime/control-plane/release-retention.ts +62 -2
  248. package/src/runtime/control-plane/routing/route-policy.ts +7 -16
  249. package/src/runtime/control-plane/runtime-status-client.ts +0 -2
  250. package/src/runtime/diagnostics/mcp-timing.ts +19 -0
  251. package/src/runtime/diagnostics/mcp-transport-benchmark.ts +129 -0
  252. package/src/runtime/diagnostics/performance.ts +24 -1
  253. package/src/runtime/evidence/event-ledger.ts +1 -1
  254. package/src/runtime/execution/jobs/store.ts +58 -4
  255. package/src/runtime/execution/jobs/types.ts +1 -1
  256. package/src/runtime/execution/managed-workspace.ts +203 -1
  257. package/src/runtime/execution/process-runtime/check-facade.ts +52 -14
  258. package/src/runtime/execution/process-runtime/check-result.ts +63 -2
  259. package/src/runtime/execution/process-runtime/check-scheduling.ts +114 -0
  260. package/src/runtime/execution/process-runtime/command-facade.ts +346 -40
  261. package/src/runtime/execution/process-runtime/gc.ts +98 -12
  262. package/src/runtime/execution/process-runtime/lightweight-managed.ts +1184 -0
  263. package/src/runtime/execution/process-runtime/persisted-check.ts +57 -6
  264. package/src/runtime/execution/process-runtime/resource-claims.ts +97 -8
  265. package/src/runtime/execution/process-runtime/runtime.ts +59 -4
  266. package/src/runtime/execution/process-runtime/store.ts +7 -0
  267. package/src/runtime/execution/process-runtime/types.ts +2 -0
  268. package/src/runtime/execution/thin-harness/async-process.ts +12 -2
  269. package/src/runtime/execution/thin-harness/search-worker.ts +54 -5
  270. package/src/runtime/execution/workers/executor.ts +0 -48
  271. package/src/runtime/gateway/mcp/execution-tools.ts +1219 -126
  272. package/src/runtime/gateway/mcp/process-tools.ts +83 -37
  273. package/src/runtime/gateway/mcp/router.ts +185 -83
  274. package/src/runtime/gateway/mcp/runtime-tool-definitions.ts +546 -0
  275. package/src/runtime/gateway/mcp/runtime-tools.ts +2555 -1616
  276. package/src/runtime/model-clients/deepseek-adapter.ts +0 -32
  277. package/src/runtime/plugins/app-store-connect-adapter.ts +123 -19
  278. package/src/runtime/plugins/browser-adapter.ts +2925 -318
  279. package/src/runtime/plugins/browser-automation-service.ts +10 -0
  280. package/src/runtime/plugins/browser-handoff-host.ts +6 -31
  281. package/src/runtime/plugins/browser-handoff.ts +92 -5
  282. package/src/runtime/plugins/browser-macos-bridge.ts +586 -45
  283. package/src/runtime/plugins/browser-node-bridge.ts +6 -34
  284. package/src/runtime/plugins/browser-provider-registry.ts +109 -0
  285. package/src/runtime/plugins/browser-runtime-contract.ts +152 -0
  286. package/src/runtime/plugins/browser-runtime.ts +183 -0
  287. package/src/runtime/plugins/browser-session-authority.ts +332 -0
  288. package/src/runtime/plugins/capability-authorization-grants.ts +354 -0
  289. package/src/runtime/plugins/desktop-operator-registration.ts +15 -12
  290. package/src/runtime/plugins/external-adapter.ts +324 -3
  291. package/src/runtime/plugins/external-registration.ts +84 -5
  292. package/src/runtime/plugins/external-unix-socket.ts +7 -1
  293. package/src/runtime/plugins/first-party-registry.ts +4 -2
  294. package/src/runtime/plugins/github-adapter.ts +125 -0
  295. package/src/runtime/plugins/gmail-adapter.ts +28 -2
  296. package/src/runtime/plugins/ios/agent-device-provider.ts +1 -1
  297. package/src/runtime/plugins/ios/agent-device-typed-provider.ts +52 -9
  298. package/src/runtime/plugins/ios/remote-xpc-hid.ts +1171 -0
  299. package/src/runtime/plugins/ios-adapter.ts +106 -16
  300. package/src/runtime/plugins/ios-agent-device.ts +234 -64
  301. package/src/runtime/plugins/ios-physical-device.ts +1143 -392
  302. package/src/runtime/plugins/lightweight-action.ts +153 -0
  303. package/src/runtime/plugins/local-system-adapter.ts +125 -8
  304. package/src/runtime/plugins/macos-capability-broker.ts +55 -9
  305. package/src/runtime/plugins/plugin-action-sidecar.ts +59 -0
  306. package/src/runtime/plugins/plugin-management-adapter.ts +181 -0
  307. package/src/runtime/plugins/resend-adapter.ts +1 -1
  308. package/src/runtime/plugins/store.ts +366 -24
  309. package/src/runtime/plugins/types.ts +39 -2
  310. package/src/runtime/plugins/xiaohongshu-publish.ts +515 -0
  311. package/src/runtime/projections/git-status-sampler.ts +16 -16
  312. package/src/runtime/projections/materialized-view.ts +28 -10
  313. package/src/runtime/recovery/actions.ts +0 -10
  314. package/src/runtime/recovery/classifier.ts +0 -9
  315. package/src/runtime/recovery/maintenance-executor.ts +415 -18
  316. package/src/runtime/recovery/probe.ts +0 -1
  317. package/src/runtime/recovery/types.ts +0 -1
  318. package/src/runtime/root/mcp-transport.ts +180 -10
  319. package/src/runtime/root/package-connector-service.ts +186 -8
  320. package/src/runtime/root/package-runtime-release.ts +143 -17
  321. package/src/runtime/root/package-runtime-service.ts +430 -22
  322. package/src/runtime/root/release-manifest.ts +7 -2
  323. package/src/runtime/root/release-materialize.ts +162 -19
  324. package/src/runtime/root/release-store.ts +48 -11
  325. package/src/runtime/root/runtime.ts +23 -5
  326. package/src/runtime/root/service.ts +100 -27
  327. package/src/runtime/root/types.ts +2 -0
  328. package/src/runtime/safe-tooling/index.ts +0 -1
  329. package/src/runtime/safe-tooling/ios-development.ts +321 -63
  330. package/src/runtime/safe-tooling/types.ts +0 -30
  331. package/src/runtime/shared/trusted-executable.ts +62 -0
  332. package/src/runtime/shared/trusted-node-executable.ts +48 -0
  333. package/src/runtime/standalone-recovery/core.ts +702 -94
  334. package/src/runtime/standalone-recovery/entry.ts +99 -23
  335. package/src/runtime/standalone-recovery/installer.ts +19 -3
  336. package/src/runtime/standalone-recovery/service-labels.ts +2 -0
  337. package/src/runtime/standalone-recovery/watchdog-heartbeat.ts +160 -0
  338. package/src/runtime/workflow/schedules/browser-probe.ts +258 -0
  339. package/src/runtime/workflow/schedules/chatgpt-automation-migration.ts +40 -0
  340. package/src/runtime/workflow/schedules/engine.ts +509 -80
  341. package/src/runtime/workflow/schedules/github-issue-watch.ts +158 -0
  342. package/src/runtime/workflow/schedules/settlement.ts +48 -4
  343. package/src/runtime/workflow/schedules/store.ts +131 -10
  344. package/src/runtime/workflow/schedules/types.ts +6 -3
  345. package/src/runtime/workflow/schedules/work-continuation.ts +120 -34
  346. package/src/testing/test-governance.ts +8 -40
  347. package/assets/reference-configs/heartbeat-triage.md +0 -57
  348. package/assets/templates/helpers/harness-trace-grade.sh +0 -150
  349. package/assets/templates/helpers/heartbeat-triage.sh +0 -361
  350. package/assets/templates/helpers/maintenance-triage.sh +0 -167
  351. package/bin/forge-desktop-helper.mjs +0 -204
  352. package/docs/architecture/current/approved-target-architecture.zh-CN.md +0 -1501
  353. package/docs/architecture/current/architecture-invariants.md +0 -331
  354. package/docs/architecture/current/automation-and-schedule-engine.md +0 -453
  355. package/docs/architecture/current/codegraph-context-provider.md +0 -226
  356. package/docs/architecture/current/control-plane-authority-inventory.md +0 -94
  357. package/docs/architecture/current/controller-repository-decoupling.md +0 -148
  358. package/docs/architecture/current/dispatch-and-agent-strategy.md +0 -354
  359. package/docs/architecture/current/entity-model.md +0 -592
  360. package/docs/architecture/current/external-plugin-governance.md +0 -396
  361. package/docs/architecture/current/failure-recovery.md +0 -447
  362. package/docs/architecture/current/governance.md +0 -213
  363. package/docs/architecture/current/human-interaction-plane.md +0 -87
  364. package/docs/architecture/current/implementation-status.md +0 -128
  365. package/docs/architecture/current/job-and-run-lifecycle.md +0 -413
  366. package/docs/architecture/current/legacy-governance.md +0 -58
  367. package/docs/architecture/current/local-workspace-target-grants.md +0 -70
  368. package/docs/architecture/current/migration-roadmap.md +0 -105
  369. package/docs/architecture/current/multi-repository-execution.md +0 -371
  370. package/docs/architecture/current/operations-runbook.md +0 -45
  371. package/docs/architecture/current/peer-supercontroller-runtime.md +0 -32
  372. package/docs/architecture/current/personal-assistant-plugin-baseline.md +0 -206
  373. package/docs/architecture/current/repository-access-modes.md +0 -102
  374. package/docs/architecture/current/route-policy.md +0 -15
  375. package/docs/architecture/current/route-session-concurrency.md +0 -85
  376. package/docs/architecture/current/runtime-architecture-simplification.md +0 -214
  377. package/docs/architecture/current/runtime-directory-map.md +0 -49
  378. package/docs/architecture/current/runtime-health-and-resource-lifecycle.md +0 -85
  379. package/docs/architecture/current/scheduler-and-resource-claims.md +0 -422
  380. package/docs/architecture/current/session-aware-execution-and-authorization.md +0 -77
  381. package/docs/architecture/current/system-overview.md +0 -144
  382. package/docs/architecture/current/target-requirements-traceability.md +0 -202
  383. package/docs/architecture/current/thin-harness-governance-policy.md +0 -32
  384. package/docs/architecture/current/thin-harness-v1.md +0 -311
  385. package/docs/architecture/current/verification-and-release-gates.md +0 -391
  386. package/docs/forge-autonomous-goal-loop.md +0 -9
  387. package/docs/forge-provider-configuration.md +0 -7
  388. package/docs/operations/chatgpt-personal-assistant-runtime.md +0 -83
  389. package/docs/operations/controller-desktop-plugin.md +0 -112
  390. package/docs/operations/gmail-assistant-routines.md +0 -186
  391. package/docs/operations/personal-assistant-operator-guide.md +0 -61
  392. package/docs/operations/provider-configuration.md +0 -31
  393. package/scripts/harness-trace-grade.sh +0 -150
  394. package/scripts/heartbeat-triage.sh +0 -361
  395. package/scripts/maintenance-triage.sh +0 -167
  396. package/src/cli/local-bridge/frontend/src/features/settings/SettingsView.tsx +0 -2
  397. package/src/cli/repositories/goal-registry.ts +0 -239
  398. package/src/runtime/assistant/action-proposals.ts +0 -279
  399. package/src/runtime/assistant/intent.ts +0 -395
  400. package/src/runtime/assistant/model-provider.ts +0 -460
  401. package/src/runtime/assistant/openapi.ts +0 -223
  402. package/src/runtime/assistant/policy.ts +0 -89
  403. package/src/runtime/assistant/readiness.ts +0 -258
  404. package/src/runtime/assistant/routine-runtime.ts +0 -477
  405. package/src/runtime/assistant/schedule-binding.ts +0 -171
  406. package/src/runtime/assistant/standing-grants.ts +0 -375
  407. package/src/runtime/assistant/store.ts +0 -243
  408. package/src/runtime/assistant/types.ts +0 -135
  409. package/src/runtime/control-plane/goal-loop/config-facade.ts +0 -700
  410. package/src/runtime/control-plane/goal-loop/config-store.ts +0 -570
  411. package/src/runtime/control-plane/goal-loop/config-types.ts +0 -213
  412. package/src/runtime/control-plane/goal-loop/executor-router.ts +0 -109
  413. package/src/runtime/control-plane/goal-loop/failure-taxonomy.ts +0 -149
  414. package/src/runtime/control-plane/goal-loop/goal-contract-store.ts +0 -304
  415. package/src/runtime/control-plane/goal-loop/goal-loop-engine.ts +0 -1001
  416. package/src/runtime/control-plane/goal-loop/handoff-packet.ts +0 -160
  417. package/src/runtime/control-plane/goal-loop/index.ts +0 -13
  418. package/src/runtime/control-plane/goal-loop/local-tools.ts +0 -290
  419. package/src/runtime/control-plane/goal-loop/policy-gates.ts +0 -203
  420. package/src/runtime/control-plane/goal-loop/provider-dispatch.ts +0 -93
  421. package/src/runtime/control-plane/goal-loop/provider-registry.ts +0 -545
  422. package/src/runtime/control-plane/goal-loop/types.ts +0 -378
  423. package/src/runtime/control-plane/startup-recovery.ts +0 -198
  424. package/src/runtime/gateway/mcp/resource-policy.ts +0 -186
  425. package/src/runtime/personal-assistant/gmail-triage-manager.ts +0 -231
  426. package/src/runtime/personal-assistant/reporting-runtime.ts +0 -344
  427. package/src/runtime/personal-assistant/triage-runtime.ts +0 -748
  428. package/src/runtime/plugins/desktop-adapter.ts +0 -374
  429. package/src/runtime/safe-tooling/browser-safe.ts +0 -133
  430. package/src/runtime/workflow/findings/store.ts +0 -204
  431. package/src/runtime/workflow/findings/types.ts +0 -58
  432. package/src/runtime/workflow/portfolio/engine.ts +0 -20
  433. package/src/runtime/workflow/portfolio/store.ts +0 -185
  434. package/src/runtime/workflow/portfolio/types.ts +0 -29
@@ -1,239 +0,0 @@
1
- import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'fs';
2
- import { dirname, join } from 'path';
3
- import { listControllerChecks, runControllerCheck, type ControllerCheckResult } from '../controller/check-runner';
4
- import { repositoryGitStatus } from './structured-git';
5
- import type { RepositoryRecord } from './types';
6
-
7
- export interface RepositoryGoal {
8
- id: string;
9
- title: string;
10
- status: 'active' | 'paused' | 'done';
11
- checks: string[];
12
- notes?: string;
13
- updatedAt: string;
14
- createdAt: string;
15
- lastRunId?: string;
16
- lastRunStatus?: RepositoryGoalRun['status'];
17
- }
18
-
19
- export interface RepositoryGoalRegistry {
20
- schemaVersion: 1;
21
- goals: RepositoryGoal[];
22
- }
23
-
24
- export interface RepositoryStuckTrace {
25
- code: string;
26
- severity: 'info' | 'warning' | 'error';
27
- message: string;
28
- next: string;
29
- evidence?: Record<string, unknown>;
30
- }
31
-
32
- export interface RepositoryStuckDiagnosis {
33
- repoId: string;
34
- checkoutId: string;
35
- generatedAt: string;
36
- git: ReturnType<typeof repositoryGitStatus>;
37
- activeGoals: RepositoryGoal[];
38
- likelyBlocked: boolean;
39
- blockers: RepositoryStuckTrace[];
40
- }
41
-
42
- export interface RepositoryGoalRun {
43
- schemaVersion: 1;
44
- runId: string;
45
- repoId: string;
46
- checkoutId: string;
47
- goalId: string;
48
- title: string;
49
- status: 'succeeded' | 'failed' | 'blocked' | 'skipped';
50
- startedAt: string;
51
- finishedAt: string;
52
- gitBefore: ReturnType<typeof repositoryGitStatus>;
53
- gitAfter: ReturnType<typeof repositoryGitStatus>;
54
- checks: Array<{
55
- checkId: string;
56
- status: 'passed' | 'failed' | 'missing' | 'skipped';
57
- summary: string;
58
- artifactPath?: string;
59
- }>;
60
- diagnosis: RepositoryStuckDiagnosis;
61
- next: string[];
62
- }
63
-
64
- export interface RepositoryGoalRunResult {
65
- run: RepositoryGoalRun;
66
- path: string;
67
- registry: RepositoryGoalRegistry;
68
- }
69
-
70
- const REGISTRY_PATH = '.forge/goals.json';
71
- const RUNS_ROOT = '.forge/goal-runs';
72
- const MAX_RUNS = 100;
73
-
74
- function now(): string {
75
- return new Date().toISOString();
76
- }
77
-
78
- function registryPath(repository: RepositoryRecord): string {
79
- return join(repository.canonicalRoot, REGISTRY_PATH);
80
- }
81
-
82
- function runsRoot(repository: RepositoryRecord): string {
83
- return join(repository.canonicalRoot, RUNS_ROOT);
84
- }
85
-
86
- function runPath(repository: RepositoryRecord, runId: string): string {
87
- return join(runsRoot(repository), `${runId}.json`);
88
- }
89
-
90
- function slug(value: string): string {
91
- const normalized = value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
92
- return normalized || `goal-${Date.now()}`;
93
- }
94
-
95
- function writeJson(path: string, value: unknown): void {
96
- mkdirSync(dirname(path), { recursive: true });
97
- writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, 'utf-8');
98
- }
99
-
100
- export function readRepositoryGoalRegistry(repository: RepositoryRecord): RepositoryGoalRegistry {
101
- const absolute = registryPath(repository);
102
- if (!existsSync(absolute)) return { schemaVersion: 1, goals: [] };
103
- const parsed = JSON.parse(readFileSync(absolute, 'utf-8')) as Partial<RepositoryGoalRegistry>;
104
- return { schemaVersion: 1, goals: Array.isArray(parsed.goals) ? parsed.goals : [] };
105
- }
106
-
107
- function writeRepositoryGoalRegistry(repository: RepositoryRecord, registry: RepositoryGoalRegistry): void {
108
- writeJson(registryPath(repository), registry);
109
- }
110
-
111
- export function upsertRepositoryGoal(repository: RepositoryRecord, input: { id?: unknown; title?: unknown; status?: unknown; checks?: unknown; notes?: unknown }): { path: string; goal: RepositoryGoal; registry: RepositoryGoalRegistry } {
112
- const registry = readRepositoryGoalRegistry(repository);
113
- const title = String(input.title ?? '').trim();
114
- const id = String(input.id ?? '').trim() || slug(title);
115
- if (!id) throw new Error('REPOSITORY_GOAL_ID_REQUIRED: id or title is required');
116
- const statusValue = String(input.status ?? 'active');
117
- const status = (['active', 'paused', 'done'].includes(statusValue) ? statusValue : 'active') as RepositoryGoal['status'];
118
- const checks = Array.isArray(input.checks) ? input.checks.map((item) => String(item).trim()).filter(Boolean) : [];
119
- const existing = registry.goals.find((goal) => goal.id === id);
120
- const at = now();
121
- const goal: RepositoryGoal = {
122
- id,
123
- title: title || existing?.title || id,
124
- status,
125
- checks: checks.length > 0 ? checks : existing?.checks ?? [],
126
- notes: typeof input.notes === 'string' ? input.notes : existing?.notes,
127
- createdAt: existing?.createdAt ?? at,
128
- updatedAt: at,
129
- lastRunId: existing?.lastRunId,
130
- lastRunStatus: existing?.lastRunStatus,
131
- };
132
- registry.goals = [goal, ...registry.goals.filter((entry) => entry.id !== id)].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
133
- writeRepositoryGoalRegistry(repository, registry);
134
- return { path: REGISTRY_PATH, goal, registry };
135
- }
136
-
137
- function availableCheckIds(repository: RepositoryRecord): Set<string> {
138
- try { return new Set(listControllerChecks(repository.canonicalRoot).map((check) => check.id)); }
139
- catch (_error) { return new Set(); }
140
- }
141
-
142
- export function diagnoseRepositoryStuckState(repository: RepositoryRecord): RepositoryStuckDiagnosis {
143
- const generatedAt = now();
144
- const git = repositoryGitStatus(repository);
145
- const activeGoals = readRepositoryGoalRegistry(repository).goals.filter((goal) => goal.status === 'active');
146
- const blockers: RepositoryStuckDiagnosis['blockers'] = [];
147
- const dirtyLines = git.porcelain.split(/\r?\n/).filter((line) => line && !line.startsWith('## '));
148
- if (dirtyLines.length > 0) blockers.push({ code: 'DIRTY_WORKTREE', severity: 'warning', message: `${dirtyLines.length} dirty Git path(s) are present.`, next: 'Run repository_git_diff, then repository_git_commit or revert selected paths.', evidence: { staged: git.staged, unstaged: git.unstaged, untracked: git.untracked } });
149
- if (activeGoals.length === 0) blockers.push({ code: 'NO_ACTIVE_GOAL', severity: 'info', message: 'No active repository goal is registered.', next: 'Create one with repository_goal_upsert so agent work has a durable target.' });
150
- if (!git.branch) blockers.push({ code: 'DETACHED_HEAD', severity: 'error', message: 'Checkout is not on a named branch.', next: 'Use repository_git_create_branch or repository_git_switch_branch before continuing edits.' });
151
- const checks = availableCheckIds(repository);
152
- for (const goal of activeGoals) {
153
- const missing = goal.checks.filter((check) => !checks.has(check));
154
- if (missing.length > 0) blockers.push({ code: 'MISSING_GOAL_CHECKS', severity: 'warning', message: `Goal ${goal.id} references missing check(s): ${missing.join(', ')}`, next: 'Update the goal checks or add them to .forge/checks.json/package scripts.', evidence: { goalId: goal.id, missing } });
155
- }
156
- return { repoId: repository.repoId, checkoutId: repository.activeCheckoutId, generatedAt, git, activeGoals, likelyBlocked: blockers.some((blocker) => blocker.severity !== 'info'), blockers };
157
- }
158
-
159
- function selectedGoal(repository: RepositoryRecord, goalId: unknown): RepositoryGoal | undefined {
160
- const goals = readRepositoryGoalRegistry(repository).goals;
161
- const requested = typeof goalId === 'string' ? goalId.trim() : '';
162
- if (requested) return goals.find((goal) => goal.id === requested);
163
- return goals.find((goal) => goal.status === 'active');
164
- }
165
-
166
- function checkSummary(result: ControllerCheckResult): string {
167
- return `${result.check.id}: ${result.ok ? 'passed' : 'failed'} (${result.status}${result.timedOut ? ', timed out' : ''})`;
168
- }
169
-
170
- function pruneRuns(repository: RepositoryRecord): void {
171
- const root = runsRoot(repository);
172
- if (!existsSync(root)) return;
173
- const files = readdirSync(root).filter((name) => name.endsWith('.json')).sort().reverse();
174
- for (const file of files.slice(MAX_RUNS)) {
175
- try { writeFileSync(join(root, file), readFileSync(join(root, file))); }
176
- catch (_error) { /* best effort no-op; avoid destructive cleanup here */ }
177
- }
178
- }
179
-
180
- export function runRepositoryGoal(repository: RepositoryRecord, input: { goalId?: unknown; runChecks?: unknown } = {}): RepositoryGoalRunResult {
181
- const goal = selectedGoal(repository, input.goalId);
182
- if (!goal) throw new Error('REPOSITORY_GOAL_NOT_FOUND: no active or requested goal exists');
183
- if (goal.status !== 'active') throw new Error(`REPOSITORY_GOAL_NOT_ACTIVE: ${goal.id} is ${goal.status}`);
184
- const startedAt = now();
185
- const runId = `GOAL-${Date.now()}-${goal.id.replace(/[^a-zA-Z0-9._-]+/g, '-').slice(0, 48)}`;
186
- const gitBefore = repositoryGitStatus(repository);
187
- const diagnosis = diagnoseRepositoryStuckState(repository);
188
- const checks: RepositoryGoalRun['checks'] = [];
189
- const knownChecks = availableCheckIds(repository);
190
- if (goal.checks.length === 0) {
191
- checks.push({ checkId: '(none)', status: 'skipped', summary: 'Goal has no checks configured.' });
192
- } else if (input.runChecks !== true) {
193
- checks.push(...goal.checks.map((checkId) => ({ checkId, status: 'skipped' as const, summary: 'Checks were not executed; pass run_checks=true to run them.' })));
194
- } else {
195
- for (const checkId of goal.checks) {
196
- if (!knownChecks.has(checkId)) {
197
- checks.push({ checkId, status: 'missing', summary: `Check not found: ${checkId}` });
198
- continue;
199
- }
200
- try {
201
- const check = runControllerCheck(repository.canonicalRoot, checkId);
202
- checks.push({ checkId, status: check.ok ? 'passed' : 'failed', summary: checkSummary(check), artifactPath: check.artifactPath });
203
- } catch (error) {
204
- checks.push({ checkId, status: 'failed', summary: error instanceof Error ? error.message : String(error) });
205
- }
206
- }
207
- }
208
- const gitAfter = repositoryGitStatus(repository);
209
- const hardBlockers = diagnosis.blockers.filter((blocker) => blocker.severity === 'error');
210
- const failedChecks = checks.filter((check) => check.status === 'failed' || check.status === 'missing');
211
- const status: RepositoryGoalRun['status'] = hardBlockers.length > 0 ? 'blocked' : failedChecks.length > 0 ? 'failed' : 'succeeded';
212
- const finishedAt = now();
213
- const next = [
214
- ...diagnosis.blockers.map((blocker) => blocker.next),
215
- ...(failedChecks.length > 0 ? ['Inspect failed check artifacts, patch the failures, and re-run repository_goal_run.'] : []),
216
- ...(gitAfter.clean ? ['No dirty worktree changes remain after this goal run.'] : ['Review repository_git_diff and commit or revert current changes.']),
217
- ];
218
- const run: RepositoryGoalRun = { schemaVersion: 1, runId, repoId: repository.repoId, checkoutId: repository.activeCheckoutId, goalId: goal.id, title: goal.title, status, startedAt, finishedAt, gitBefore, gitAfter, checks, diagnosis, next: [...new Set(next)] };
219
- writeJson(runPath(repository, runId), run);
220
- const registry = readRepositoryGoalRegistry(repository);
221
- registry.goals = registry.goals.map((entry) => entry.id === goal.id ? { ...entry, lastRunId: runId, lastRunStatus: status, updatedAt: finishedAt } : entry);
222
- writeRepositoryGoalRegistry(repository, registry);
223
- pruneRuns(repository);
224
- return { run, path: `${RUNS_ROOT}/${runId}.json`, registry };
225
- }
226
-
227
- export function listRepositoryGoalRuns(repository: RepositoryRecord, limit = 20): RepositoryGoalRun[] {
228
- const root = runsRoot(repository);
229
- if (!existsSync(root)) return [];
230
- return readdirSync(root)
231
- .filter((name) => name.endsWith('.json'))
232
- .sort()
233
- .reverse()
234
- .slice(0, Math.max(1, Math.min(Math.trunc(limit), MAX_RUNS)))
235
- .flatMap((name) => {
236
- try { return [JSON.parse(readFileSync(join(root, name), 'utf-8')) as RepositoryGoalRun]; }
237
- catch (_error) { return []; }
238
- });
239
- }
@@ -1,279 +0,0 @@
1
- import { randomUUID } from 'crypto';
2
- import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'fs';
3
- import { dirname, join } from 'path';
4
- import type { RepositoryRecord } from '../../cli/repositories/types';
5
- import { withControllerLock, withControllerLockAsync } from '../../cli/repositories/locks';
6
- import { findExecutionJob } from '../execution/jobs/store';
7
- import { appendRuntimeEvent } from '../evidence/event-ledger';
8
- import { getAssistantPluginManifest, submitAssistantPluginAction } from '../plugins/store';
9
-
10
- export type AssistantActionProposalStatus =
11
- | 'proposed'
12
- | 'approved'
13
- | 'rejected'
14
- | 'executed'
15
- | 'failed'
16
- | 'expired';
17
-
18
- export interface AssistantActionProposal {
19
- schemaVersion: 1;
20
- proposalId: string;
21
- routineId: string;
22
- runId: string;
23
- pluginId: string;
24
- actionId: string;
25
- arguments: Record<string, unknown>;
26
- evidenceMessageIds: string[];
27
- context?: { sender?: string; subject?: string; protected?: boolean };
28
- reason: string;
29
- confidence: number;
30
- risk: 'remote_write' | 'destructive';
31
- executable: boolean;
32
- status: AssistantActionProposalStatus;
33
- expiresAt: string;
34
- executionJobId?: string;
35
- standingGrantId?: string;
36
- rejectionReason?: string;
37
- error?: string;
38
- createdAt: string;
39
- updatedAt: string;
40
- }
41
-
42
- export interface AssistantActionProposalInput {
43
- pluginId: string;
44
- actionId: string;
45
- arguments?: Record<string, unknown>;
46
- evidenceMessageIds: string[];
47
- context?: { sender?: string; subject?: string; protected?: boolean };
48
- reason: string;
49
- confidence?: number;
50
- risk?: 'remote_write' | 'destructive';
51
- executable?: boolean;
52
- expiresInHours?: number;
53
- }
54
-
55
- interface ProposalStore {
56
- schemaVersion: 1;
57
- updatedAt: string;
58
- proposals: AssistantActionProposal[];
59
- }
60
-
61
- function now(): string { return new Date().toISOString(); }
62
- function proposalsPath(repoRoot: string): string { return join(repoRoot, '.forge', 'assistant', 'action-proposals.json'); }
63
-
64
- function readStore(repoRoot: string): ProposalStore {
65
- const path = proposalsPath(repoRoot);
66
- if (!existsSync(path)) return { schemaVersion: 1, updatedAt: now(), proposals: [] };
67
- try {
68
- const parsed = JSON.parse(readFileSync(path, 'utf-8')) as Partial<ProposalStore>;
69
- return {
70
- schemaVersion: 1,
71
- updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : now(),
72
- proposals: Array.isArray(parsed.proposals) ? parsed.proposals as AssistantActionProposal[] : [],
73
- };
74
- } catch {
75
- return { schemaVersion: 1, updatedAt: now(), proposals: [] };
76
- }
77
- }
78
-
79
- function writeStore(repoRoot: string, store: ProposalStore): void {
80
- const path = proposalsPath(repoRoot);
81
- mkdirSync(dirname(path), { recursive: true });
82
- const tmp = `${path}.${process.pid}.${Date.now()}.tmp`;
83
- writeFileSync(tmp, `${JSON.stringify({ ...store, schemaVersion: 1, updatedAt: now() }, null, 2)}\n`, 'utf-8');
84
- renameSync(tmp, path);
85
- }
86
-
87
- function refreshStatus(controllerHome: string, proposal: AssistantActionProposal): AssistantActionProposal {
88
- if (!proposal.executionJobId || !['approved', 'proposed'].includes(proposal.status)) return proposal;
89
- const job = findExecutionJob(controllerHome, proposal.executionJobId);
90
- if (!job) return proposal;
91
- if (job.status === 'succeeded') return { ...proposal, status: 'executed', updatedAt: now() };
92
- if (['failed', 'timed_out', 'cancelled', 'orphaned', 'stale', 'human_attention_required'].includes(job.status)) {
93
- return { ...proposal, status: 'failed', error: job.error?.message ?? `Execution Job ended as ${job.status}`, updatedAt: now() };
94
- }
95
- return proposal;
96
- }
97
-
98
- function expire(proposal: AssistantActionProposal): AssistantActionProposal {
99
- if (proposal.status === 'proposed' && Date.parse(proposal.expiresAt) <= Date.now()) {
100
- return { ...proposal, status: 'expired', updatedAt: now() };
101
- }
102
- return proposal;
103
- }
104
-
105
- export function createAssistantActionProposals(
106
- controllerHome: string,
107
- repository: RepositoryRecord,
108
- input: { routineId: string; runId: string; proposals: AssistantActionProposalInput[] },
109
- ): AssistantActionProposal[] {
110
- return withControllerLock(controllerHome, { scope: 'repository', repoId: repository.repoId }, `assistant-proposals:${input.runId}`, () => {
111
- const store = readStore(repository.canonicalRoot);
112
- const existing = store.proposals.filter((entry) => entry.runId === input.runId);
113
- if (existing.length > 0) return existing;
114
- const at = now();
115
- const proposals = input.proposals.slice(0, 100).map((proposal) => ({
116
- schemaVersion: 1 as const,
117
- proposalId: `proposal-${Date.now()}-${randomUUID().slice(0, 8)}`,
118
- routineId: input.routineId,
119
- runId: input.runId,
120
- pluginId: proposal.pluginId,
121
- actionId: proposal.actionId,
122
- arguments: proposal.arguments ?? {},
123
- evidenceMessageIds: [...new Set(proposal.evidenceMessageIds)].slice(0, 50),
124
- context: proposal.context ? {
125
- sender: typeof proposal.context.sender === 'string' ? proposal.context.sender.slice(0, 500) : undefined,
126
- subject: typeof proposal.context.subject === 'string' ? proposal.context.subject.slice(0, 1_000) : undefined,
127
- protected: proposal.context.protected === true,
128
- } : undefined,
129
- reason: proposal.reason,
130
- confidence: Math.max(0, Math.min(1, proposal.confidence ?? 0.5)),
131
- risk: proposal.risk ?? 'remote_write',
132
- executable: proposal.executable !== false,
133
- status: 'proposed' as const,
134
- expiresAt: new Date(Date.now() + Math.max(1, Math.min(24 * 30, proposal.expiresInHours ?? 72)) * 60 * 60_000).toISOString(),
135
- createdAt: at,
136
- updatedAt: at,
137
- }));
138
- store.proposals = [...proposals, ...store.proposals].slice(0, 2_000);
139
- writeStore(repository.canonicalRoot, store);
140
- for (const proposal of proposals) {
141
- appendRuntimeEvent(controllerHome, {
142
- repoId: repository.repoId,
143
- entityType: 'assistant-action-proposal',
144
- entityId: proposal.proposalId,
145
- eventType: 'assistant_action_proposed',
146
- requestId: proposal.runId,
147
- revision: 1,
148
- data: { pluginId: proposal.pluginId, actionId: proposal.actionId, risk: proposal.risk, executable: proposal.executable },
149
- });
150
- }
151
- return proposals;
152
- }, 10_000);
153
- }
154
-
155
- export function listAssistantActionProposals(
156
- controllerHome: string,
157
- repository: RepositoryRecord,
158
- input: { status?: AssistantActionProposalStatus; limit?: number } = {},
159
- ): { proposals: AssistantActionProposal[] } {
160
- const store = readStore(repository.canonicalRoot);
161
- let changed = false;
162
- store.proposals = store.proposals.map((proposal) => {
163
- const next = refreshStatus(controllerHome, expire(proposal));
164
- if (next.status !== proposal.status || next.updatedAt !== proposal.updatedAt) changed = true;
165
- return next;
166
- });
167
- if (changed) writeStore(repository.canonicalRoot, store);
168
- const limit = Math.max(1, Math.min(500, Math.trunc(input.limit ?? 100)));
169
- return {
170
- proposals: store.proposals
171
- .filter((proposal) => !input.status || proposal.status === input.status)
172
- .sort((left, right) => right.createdAt.localeCompare(left.createdAt))
173
- .slice(0, limit),
174
- };
175
- }
176
-
177
- export function getAssistantActionProposal(
178
- controllerHome: string,
179
- repository: RepositoryRecord,
180
- proposalId: string,
181
- ): AssistantActionProposal {
182
- const proposal = listAssistantActionProposals(controllerHome, repository, { limit: 500 }).proposals
183
- .find((entry) => entry.proposalId === proposalId);
184
- if (!proposal) throw new Error(`ASSISTANT_ACTION_PROPOSAL_NOT_FOUND: ${proposalId}`);
185
- return proposal;
186
- }
187
-
188
- export function rejectAssistantActionProposal(
189
- controllerHome: string,
190
- repository: RepositoryRecord,
191
- proposalId: string,
192
- reason?: string,
193
- ): AssistantActionProposal {
194
- return withControllerLock(controllerHome, { scope: 'repository', repoId: repository.repoId }, `assistant-proposal-reject:${proposalId}`, () => {
195
- const store = readStore(repository.canonicalRoot);
196
- const proposal = store.proposals.find((entry) => entry.proposalId === proposalId);
197
- if (!proposal) throw new Error(`ASSISTANT_ACTION_PROPOSAL_NOT_FOUND: ${proposalId}`);
198
- if (proposal.executionJobId) throw new Error('ASSISTANT_ACTION_PROPOSAL_ALREADY_SUBMITTED');
199
- if (proposal.status === 'rejected') return proposal;
200
- if (proposal.status !== 'proposed') throw new Error(`ASSISTANT_ACTION_PROPOSAL_NOT_REJECTABLE: ${proposal.status}`);
201
- proposal.status = 'rejected';
202
- proposal.rejectionReason = reason?.trim() || 'Rejected by user.';
203
- proposal.updatedAt = now();
204
- writeStore(repository.canonicalRoot, store);
205
- appendRuntimeEvent(controllerHome, {
206
- repoId: repository.repoId,
207
- entityType: 'assistant-action-proposal',
208
- entityId: proposal.proposalId,
209
- eventType: 'assistant_action_rejected',
210
- requestId: proposal.runId,
211
- revision: 1,
212
- data: { reason: proposal.rejectionReason },
213
- });
214
- return proposal;
215
- }, 10_000);
216
- }
217
-
218
- export async function approveAssistantActionProposal(
219
- controllerHome: string,
220
- repository: RepositoryRecord,
221
- input: {
222
- proposalId: string;
223
- requestId: string;
224
- confirmationText?: string;
225
- origin?: { surface: 'mcp' | 'local-ui' | 'standing-grant'; actor: string };
226
- standingGrantId?: string;
227
- },
228
- ): Promise<AssistantActionProposal> {
229
- return withControllerLockAsync(controllerHome, { scope: 'repository', repoId: repository.repoId }, `assistant-proposal-approve:${input.proposalId}`, async () => {
230
- const store = readStore(repository.canonicalRoot);
231
- const proposal = store.proposals.find((entry) => entry.proposalId === input.proposalId);
232
- if (!proposal) throw new Error(`ASSISTANT_ACTION_PROPOSAL_NOT_FOUND: ${input.proposalId}`);
233
- const refreshed = expire(proposal);
234
- Object.assign(proposal, refreshed);
235
- if (proposal.executionJobId) return refreshStatus(controllerHome, proposal);
236
- if (proposal.status !== 'proposed') throw new Error(`ASSISTANT_ACTION_PROPOSAL_NOT_APPROVABLE: ${proposal.status}`);
237
- if (!proposal.executable) throw new Error('ASSISTANT_ACTION_PROPOSAL_NOT_EXECUTABLE');
238
- const manifest = getAssistantPluginManifest(controllerHome, repository, proposal.pluginId);
239
- const action = manifest.actions.find((entry) => entry.actionId === proposal.actionId);
240
- if (!action) throw new Error(`PLUGIN_ACTION_NOT_FOUND: ${proposal.pluginId}/${proposal.actionId}`);
241
- if (action.confirmation === 'strong_confirmation' && input.confirmationText !== action.requiredConfirmationText) {
242
- throw new Error(`ASSISTANT_ACTION_STRONG_CONFIRMATION_REQUIRED: ${action.requiredConfirmationText}`);
243
- }
244
- const submitted = await submitAssistantPluginAction(controllerHome, repository, {
245
- pluginId: proposal.pluginId,
246
- actionId: proposal.actionId,
247
- requestId: input.requestId.trim() || `assistant-proposal:${proposal.proposalId}`,
248
- args: proposal.arguments,
249
- confirmAuthorization: true,
250
- confirmationText: input.confirmationText,
251
- origin: {
252
- surface: input.origin?.surface ?? 'local-ui',
253
- actor: input.origin?.actor ?? 'assistant-action-approval',
254
- correlationId: proposal.proposalId,
255
- },
256
- });
257
- proposal.status = 'approved';
258
- proposal.executionJobId = submitted.job.jobId;
259
- proposal.standingGrantId = input.standingGrantId;
260
- proposal.updatedAt = now();
261
- writeStore(repository.canonicalRoot, store);
262
- appendRuntimeEvent(controllerHome, {
263
- repoId: repository.repoId,
264
- entityType: 'assistant-action-proposal',
265
- entityId: proposal.proposalId,
266
- eventType: 'assistant_action_approved',
267
- requestId: input.requestId,
268
- revision: 1,
269
- data: {
270
- executionJobId: proposal.executionJobId,
271
- pluginId: proposal.pluginId,
272
- actionId: proposal.actionId,
273
- standingGrantId: proposal.standingGrantId,
274
- surface: input.origin?.surface ?? 'local-ui',
275
- },
276
- });
277
- return proposal;
278
- }, 10_000);
279
- }