@moretea-labs/forge 1.8.0 → 1.8.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 (528) hide show
  1. package/AGENTS.md +70 -7
  2. package/CHANGELOG.md +14 -0
  3. package/CLAUDE.md +17 -2
  4. package/CONTRIBUTING.md +3 -2
  5. package/THIRD_PARTY_NOTICES.md +1 -1
  6. package/adapters/chatgpt/browser-delivery-host.ts +7 -1
  7. package/adapters/chatgpt/browser-delivery-runtime.ts +529 -56
  8. package/adapters/chatgpt/controller-binding-store.ts +101 -22
  9. package/adapters/chatgpt/controller-round-host.ts +15 -25
  10. package/adapters/chatgpt/controller-round-settlement-store.ts +58 -4
  11. package/adapters/chatgpt/provider-delivery.ts +228 -1
  12. package/adapters/chatgpt/work-conversation-binding-store.ts +79 -53
  13. package/adapters/computer/chatgpt-extension-target.ts +463 -0
  14. package/adapters/computer/chatgpt-target-router.ts +103 -0
  15. package/adapters/computer/chrome-extension/background.js +385 -0
  16. package/adapters/computer/chrome-extension/content.js +378 -0
  17. package/adapters/computer/chrome-extension/core.js +24 -0
  18. package/adapters/computer/chrome-extension/manifest.json +30 -0
  19. package/adapters/computer/desktop-operator-discovery.ts +11 -31
  20. package/adapters/computer/interaction-target-authority.ts +142 -18
  21. package/adapters/mcp/auth.ts +0 -1
  22. package/adapters/mcp/instructions.ts +5 -4
  23. package/adapters/mcp/multi-repository.ts +3 -19
  24. package/adapters/mcp/oauth.ts +73 -0
  25. package/adapters/mcp/paths.ts +4 -1
  26. package/adapters/mcp/runtime-gateway/automation-receipt-adapter.ts +87 -0
  27. package/adapters/mcp/runtime-gateway/bounded-result-runtime.ts +62 -0
  28. package/adapters/mcp/runtime-gateway/cognition-settlement.ts +201 -0
  29. package/adapters/mcp/runtime-gateway/context-adapter.ts +411 -73
  30. package/adapters/mcp/runtime-gateway/context-pack-sidecar.ts +91 -0
  31. package/adapters/mcp/runtime-gateway/controller-authority-adapter.ts +20 -5
  32. package/adapters/mcp/runtime-gateway/core-capability-adapter.ts +258 -0
  33. package/adapters/mcp/runtime-gateway/engineering-preconditions.ts +10 -27
  34. package/adapters/mcp/runtime-gateway/engineering-tool-contract.ts +15 -0
  35. package/adapters/mcp/runtime-gateway/execution-tools.ts +8 -42
  36. package/adapters/mcp/runtime-gateway/gateway-execution-adapter.ts +2 -1
  37. package/adapters/mcp/runtime-gateway/plugin-adapter.ts +117 -45
  38. package/adapters/mcp/runtime-gateway/process-tools.ts +190 -22
  39. package/adapters/mcp/runtime-gateway/protected-computer-adapter.ts +16 -4
  40. package/adapters/mcp/runtime-gateway/recovery-adapter.ts +69 -52
  41. package/adapters/mcp/runtime-gateway/repository-compat-adapter.ts +4 -35
  42. package/adapters/mcp/runtime-gateway/result-adapter.ts +10 -4
  43. package/adapters/mcp/runtime-gateway/router.ts +18 -504
  44. package/adapters/mcp/runtime-gateway/routing-policy.ts +499 -0
  45. package/adapters/mcp/runtime-gateway/runtime-observation-adapter.ts +14 -65
  46. package/adapters/mcp/runtime-gateway/runtime-readiness-observation.ts +218 -0
  47. package/adapters/mcp/runtime-gateway/runtime-tool-definitions.ts +113 -173
  48. package/adapters/mcp/runtime-gateway/runtime-tools.ts +15 -5
  49. package/adapters/mcp/runtime-gateway/scheduler-adapter.ts +1 -0
  50. package/adapters/mcp/runtime-gateway/shared-adapter.ts +20 -0
  51. package/adapters/mcp/runtime-gateway/status-inbox-adapter.ts +358 -266
  52. package/adapters/mcp/runtime-gateway/typescript-navigation-sidecar.ts +136 -0
  53. package/adapters/mcp/runtime-gateway/work-adapter.ts +261 -3122
  54. package/adapters/mcp/runtime-gateway/work-controller-operations.ts +257 -0
  55. package/adapters/mcp/runtime-gateway/work-detail-projection.ts +60 -0
  56. package/adapters/mcp/runtime-gateway/work-input-wire-migration.ts +246 -0
  57. package/adapters/mcp/runtime-gateway/work-learning-operations.ts +145 -0
  58. package/adapters/mcp/runtime-gateway/work-list-projection.ts +38 -0
  59. package/adapters/mcp/runtime-gateway/work-plan-operations.ts +382 -0
  60. package/adapters/mcp/runtime-gateway/work-repair-adapter.ts +308 -0
  61. package/adapters/mcp/runtime-gateway/work-requirement-operations.ts +148 -0
  62. package/adapters/mcp/runtime-gateway/work-semantic-operations.ts +263 -0
  63. package/adapters/mcp/runtime-gateway/work-workflow-operations.ts +113 -0
  64. package/adapters/mcp/runtime-gateway/workflow-supervisor-adapter.ts +156 -0
  65. package/adapters/mcp/server.ts +67 -23
  66. package/adapters/mcp/setup.ts +1 -3
  67. package/adapters/mcp/tool-mapping/legacy-tool-service.ts +44 -170
  68. package/adapters/mcp/tool-mapping/post-finalize-work-attribution.ts +4 -9
  69. package/adapters/mcp/tool-mapping/repository-tools.ts +133 -142
  70. package/adapters/mcp/toolset-names.ts +5 -0
  71. package/adapters/mcp/toolset.ts +6 -5
  72. package/adapters/mcp/transports/http-observation.ts +365 -0
  73. package/adapters/mcp/transports/http.ts +154 -677
  74. package/adapters/mcp/transports/oauth-http.ts +322 -0
  75. package/adapters/mcp/transports/session-registry.ts +6 -0
  76. package/adapters/mcp/tunnels/openai-secure-tunnel.ts +89 -5
  77. package/assets/plugin-registry.v1.json +6 -4
  78. package/assets/reference-configs/agentic-development-flow.md +25 -0
  79. package/assets/reference-configs/global-working-rules.md +19 -0
  80. package/assets/skill-version.json +2 -2
  81. package/docs/architecture/CURRENT.md +111 -41
  82. package/docs/architecture/decisions/20260803-release-identity-binding-and-exit-policy.md +14 -5
  83. package/docs/architecture/decisions/20260823-immediate-controller-relay.md +6 -3
  84. package/docs/architecture/decisions/20260907-assistant-learning-loop.md +2 -0
  85. package/docs/architecture/decisions/20260907-controller-round-transition-policy.md +19 -4
  86. package/docs/architecture/decisions/20260916-workflow-supervisor-authority.md +249 -0
  87. package/docs/architecture/decisions/20260917-cognitive-memory-foundation.md +82 -0
  88. package/docs/architecture/decisions/20260918-stable-candidate-release-lifecycle.md +221 -0
  89. package/docs/architecture/decisions/20260919-autonomous-work-liveness.md +62 -0
  90. package/docs/architecture/decisions/20260924-thin-semantic-working-context.md +72 -0
  91. package/docs/architecture/decisions/20261001-supervisor-turn-authority.md +237 -0
  92. package/docs/architecture/decisions/20261005-forge-v3-desktop-client-boundary.md +77 -0
  93. package/docs/architecture/domains/verification.md +1 -0
  94. package/docs/architecture/domains/workflow-engine.md +6 -0
  95. package/docs/architecture/modules/controller-runtime/transport-lifecycle.md +1 -1
  96. package/docs/forge-plugin-management.md +2 -2
  97. package/docs/operations/controller-performance-and-502.md +17 -0
  98. package/docs/operations/controller-reliability-runbook.md +2 -2
  99. package/docs/operations/features.md +1 -1
  100. package/docs/operations/features.zh-CN.md +1 -1
  101. package/docs/operations/homebrew.md +2 -2
  102. package/docs/operations/mcp-tool-exposure.md +2 -0
  103. package/docs/operations/releasing.md +2 -0
  104. package/docs/operations/standalone-disaster-recovery.md +14 -6
  105. package/docs/wiki/Implementation.md +1 -1
  106. package/package.json +25 -14
  107. package/packages/kernel/cognition/api/index.ts +6 -0
  108. package/packages/kernel/cognition/application/activation-service.ts +451 -0
  109. package/packages/kernel/cognition/application/consolidation-service.ts +185 -0
  110. package/packages/kernel/cognition/application/legacy-experience-adapter.ts +38 -0
  111. package/packages/kernel/cognition/application/memory-service.ts +64 -0
  112. package/packages/kernel/cognition/domain/learning.ts +106 -0
  113. package/packages/kernel/cognition/domain/memory.ts +254 -0
  114. package/packages/kernel/controller/api/index.ts +1 -0
  115. package/packages/kernel/controller/application/continuation-service.ts +281 -0
  116. package/packages/kernel/controller/application/controller-round-service.ts +12 -0
  117. package/packages/kernel/controller/domain/controller-round-transition-policy.ts +242 -21
  118. package/packages/kernel/controller/domain/controller-round.ts +4 -1
  119. package/packages/kernel/controller/domain/execution-quality.ts +3 -1
  120. package/packages/kernel/controller/infrastructure/controller-round-store.ts +689 -103
  121. package/packages/kernel/controller/infrastructure/controller-session-store.ts +297 -71
  122. package/packages/kernel/controller/ports/controller-host.ts +2 -0
  123. package/packages/kernel/identity/api/index.ts +10 -0
  124. package/packages/kernel/identity/domain/activity-projection.ts +43 -0
  125. package/packages/kernel/identity/domain/capability-broker.ts +60 -0
  126. package/packages/kernel/identity/domain/grant.ts +72 -0
  127. package/packages/kernel/identity/domain/owned-resource.ts +116 -0
  128. package/packages/kernel/identity/domain/user-request.ts +93 -0
  129. package/packages/kernel/identity/infrastructure/activity-projection-store.ts +77 -0
  130. package/packages/kernel/identity/infrastructure/capability-broker.ts +81 -0
  131. package/packages/kernel/identity/infrastructure/grant-store.ts +284 -0
  132. package/packages/kernel/identity/infrastructure/owned-resource-store.ts +259 -0
  133. package/packages/kernel/identity/infrastructure/user-request-store.ts +182 -0
  134. package/packages/kernel/scheduler/api/index.ts +0 -2
  135. package/packages/kernel/scheduler/application/schedule-service.ts +3 -0
  136. package/packages/kernel/scheduler/application/settlement.ts +0 -15
  137. package/packages/kernel/scheduler/domain/schedule.ts +87 -0
  138. package/packages/kernel/scheduler/infrastructure/schedule-store.ts +153 -133
  139. package/packages/kernel/work/api/index.ts +3 -2
  140. package/packages/kernel/work/application/work-service.ts +17 -42
  141. package/packages/kernel/work/domain/current-task-lineage.ts +104 -0
  142. package/packages/kernel/work/domain/engineering-design.ts +10 -5
  143. package/packages/kernel/work/domain/engineering-profile.ts +8 -12
  144. package/packages/kernel/work/domain/evaluation-promotion-receipt.ts +186 -0
  145. package/packages/kernel/work/domain/execution-concurrency.ts +19 -26
  146. package/packages/kernel/work/domain/execution-snapshot.ts +0 -31
  147. package/packages/kernel/work/domain/implementation-review.ts +14 -331
  148. package/packages/kernel/work/domain/objective-graph.ts +119 -0
  149. package/packages/kernel/work/domain/project-engineering-contract.ts +23 -1
  150. package/packages/kernel/work/domain/repository-completion-receipt.ts +1 -1
  151. package/packages/kernel/work/domain/state-machine.ts +25 -63
  152. package/packages/kernel/work/domain/types.ts +57 -51
  153. package/packages/kernel/work/infrastructure/work-contract-store.ts +819 -728
  154. package/packages/kernel/work/ports/work-contract-store.ts +5 -2
  155. package/packages/plugin-runtime/browser/session-authority.ts +2 -1
  156. package/packages/plugin-runtime/computer/chatgpt-identity.ts +24 -0
  157. package/packages/plugin-runtime/computer/conversation-target.ts +143 -0
  158. package/packages/plugin-runtime/computer/index.ts +2 -0
  159. package/packages/plugin-runtime/computer/target-authority.ts +26 -1
  160. package/packages/plugin-runtime/external/unix-jsonl-transport.ts +142 -18
  161. package/packages/protocols/computer/contract.ts +27 -1
  162. package/scripts/activate-source-baseline.ts +7 -9
  163. package/scripts/canary-controller-semantic-wait.ts +12 -24
  164. package/scripts/check-mcp-compatibility.ts +48 -136
  165. package/scripts/check-runtime-architecture.mjs +622 -217
  166. package/scripts/forge-local-recovery-helper.mjs +93 -15
  167. package/scripts/lib/project-init-lib.sh +3 -0
  168. package/scripts/open-source-audit-allowlist.txt +1 -2
  169. package/scripts/run-bounded-command.mjs +5 -0
  170. package/scripts/run-governed-gate.ts +0 -1
  171. package/scripts/run-mobile-monitor-bridge.ts +0 -1
  172. package/scripts/smoke-control-plane-failure-domain.ts +94 -0
  173. package/scripts/smoke-mcp-http-runtime.ts +5 -0
  174. package/scripts/smoke-runtime-recovery.ts +12 -43
  175. package/scripts/smoke-schedule-engine.ts +23 -15
  176. package/scripts/smoke-unattended-transport-recovery.ts +223 -0
  177. package/scripts/smoke-user-request-continuation-restart.ts +232 -0
  178. package/scripts/smoke-workflow-supervisor-chrome-adapter.ts +92 -0
  179. package/scripts/smoke-workflow-supervisor-process-restart.ts +276 -0
  180. package/scripts/smoke-workflow-supervisor-restart-recovery.ts +150 -0
  181. package/scripts/smoke-workflow-supervisor.ts +103 -0
  182. package/scripts/verify-forge-runtime.sh +2 -1
  183. package/src/cli/agent-jobs/executor-health.ts +11 -34
  184. package/src/cli/agent-jobs/integration.ts +18 -49
  185. package/src/cli/agent-jobs/job-manager.ts +7 -3
  186. package/src/cli/commands/brain-assistant.ts +27 -13
  187. package/src/cli/commands/brain.ts +13 -15
  188. package/src/cli/commands/chatgpt.ts +1 -163
  189. package/src/cli/commands/recovery.ts +135 -121
  190. package/src/cli/commands/runtime.ts +3 -3
  191. package/src/cli/commands/setup-profile.ts +8 -0
  192. package/src/cli/controller/check-runner.ts +13 -2
  193. package/src/cli/controller/completion-backlog.ts +3 -3
  194. package/src/cli/controller/completion-orchestrator.ts +4 -43
  195. package/src/cli/controller/completion-target.ts +3 -72
  196. package/src/cli/controller/context/source-materializer.ts +81 -100
  197. package/src/cli/controller/context-pack.ts +10 -8
  198. package/src/cli/controller/execution-completion.ts +4 -7
  199. package/src/cli/controller/execution-policy.ts +36 -153
  200. package/src/cli/controller/governance.ts +2 -3
  201. package/src/cli/controller/issue-store.ts +4 -99
  202. package/src/cli/controller/launch-agents.ts +59 -18
  203. package/src/cli/controller/operational-plan.ts +24 -51
  204. package/src/cli/controller/runtime-config.ts +5 -1
  205. package/src/cli/controller/stuck-state-migration.ts +2 -3
  206. package/src/cli/controller/systemd-user.ts +39 -1
  207. package/src/cli/editing/edit-session.ts +1 -7
  208. package/src/cli/local-bridge/console-automations.ts +18 -13
  209. package/src/cli/local-bridge/console-view-models.ts +3 -12
  210. package/src/cli/local-bridge/facade-api.ts +64 -191
  211. package/src/cli/local-bridge/server.ts +24 -147
  212. package/src/cli/local-bridge/types.ts +0 -1
  213. package/src/cli/mcp/oauth-client-retirement.ts +74 -0
  214. package/src/cli/repositories/command-executor.ts +29 -23
  215. package/src/cli/repositories/command-scope.ts +35 -16
  216. package/src/cli/repositories/controller-home.ts +48 -0
  217. package/src/cli/repositories/ephemeral-workspace.ts +20 -30
  218. package/src/cli/repositories/git-command-executor.ts +2 -2
  219. package/src/cli/repositories/registry.ts +77 -11
  220. package/src/cli/repositories/structured-git.ts +62 -2
  221. package/src/cli/repository/session-cache.ts +92 -6
  222. package/src/runtime/context/assistant-context.ts +20 -7
  223. package/src/runtime/context/assistant-work-context.ts +89 -27
  224. package/src/runtime/context/automatic-learning.ts +565 -0
  225. package/src/runtime/context/cognitive-attention.ts +173 -0
  226. package/src/runtime/context/cognitive-skill-canary.ts +158 -0
  227. package/src/runtime/context/context-closure.ts +46 -9
  228. package/src/runtime/context/context-pack-process.ts +103 -0
  229. package/src/runtime/context/context-plane.ts +1 -9
  230. package/src/runtime/context/direct-controller-learning.ts +298 -0
  231. package/src/runtime/context/semantic-navigation-contract.ts +9 -0
  232. package/src/runtime/context/semantic-navigation.ts +6 -34
  233. package/src/runtime/context/typescript-navigation-process.ts +145 -0
  234. package/src/runtime/context/typescript-navigation.ts +89 -3
  235. package/src/runtime/control-plane/cleanup-artifact-retention.ts +212 -9
  236. package/src/runtime/control-plane/concurrency/work-execution-concurrency.ts +9 -47
  237. package/src/runtime/control-plane/execution/controller-authority-recovery.ts +34 -4
  238. package/src/runtime/control-plane/execution/edit-validation-coordinator.ts +29 -20
  239. package/src/runtime/control-plane/execution/execution-identity.ts +23 -3
  240. package/src/runtime/control-plane/execution/repository-work-attribution.ts +7 -30
  241. package/src/runtime/control-plane/execution/retained-work-resume.ts +206 -199
  242. package/src/runtime/control-plane/execution/session-store.ts +31 -1
  243. package/src/runtime/control-plane/execution/validation.ts +6 -8
  244. package/src/runtime/control-plane/execution/work-authority-reconciler.ts +13 -42
  245. package/src/runtime/control-plane/execution/work-check-evidence.ts +137 -0
  246. package/src/runtime/control-plane/execution/work-completion-authority.ts +30 -85
  247. package/src/runtime/control-plane/execution/work-delivery-service.ts +497 -0
  248. package/src/runtime/control-plane/execution/work-evidence-policy.ts +12 -50
  249. package/src/runtime/control-plane/execution/work-execution-support.ts +50 -149
  250. package/src/runtime/control-plane/execution/work-handle-authority.ts +188 -109
  251. package/src/runtime/control-plane/execution/work-handle-store.ts +19 -43
  252. package/src/runtime/control-plane/execution/work-head-settlement.ts +53 -20
  253. package/src/runtime/control-plane/execution/work-lifecycle-audit.ts +52 -29
  254. package/src/runtime/control-plane/execution/work-operation-service.ts +43 -27
  255. package/src/runtime/control-plane/execution/work-preparation-service.ts +126 -266
  256. package/src/runtime/control-plane/execution/work-remote-delivery.ts +2 -3
  257. package/src/runtime/control-plane/execution/work-revision-diff.ts +39 -0
  258. package/src/runtime/control-plane/execution/work-terminal-cleanup.ts +173 -186
  259. package/src/runtime/control-plane/execution/work-validation-reconciler.ts +28 -84
  260. package/src/runtime/control-plane/execution/work-verification-service.ts +406 -50
  261. package/src/runtime/control-plane/execution/work-verification-snapshot.ts +5 -1
  262. package/src/runtime/control-plane/facade/capability-registry.ts +362 -37
  263. package/src/runtime/control-plane/facade/check-normalization.ts +3 -9
  264. package/src/runtime/control-plane/facade/codex-delegation.ts +10 -11
  265. package/src/runtime/control-plane/facade/controller-connection.ts +135 -0
  266. package/src/runtime/control-plane/facade/goal-workloop-access.ts +1 -20
  267. package/src/runtime/control-plane/facade/goal-workloop.ts +281 -1753
  268. package/src/runtime/control-plane/facade/handoff-inbox-application.ts +12 -25
  269. package/src/runtime/control-plane/facade/handoff-inbox-store.ts +256 -52
  270. package/src/runtime/control-plane/facade/index.ts +0 -1
  271. package/src/runtime/control-plane/facade/operation-digest.ts +12 -15
  272. package/src/runtime/control-plane/facade/plan-contract-store.ts +451 -991
  273. package/src/runtime/control-plane/facade/policy-gate.ts +0 -23
  274. package/src/runtime/control-plane/facade/repository-work-admission.ts +12 -22
  275. package/src/runtime/control-plane/facade/requirement-authority.ts +102 -199
  276. package/src/runtime/control-plane/facade/requirement-board.ts +3 -3
  277. package/src/runtime/control-plane/facade/rh-work-operation-contract.ts +51 -14
  278. package/src/runtime/control-plane/facade/self-healing-loop.ts +18 -53
  279. package/src/runtime/control-plane/facade/suggested-actions.ts +15 -18
  280. package/src/runtime/control-plane/facade/types.ts +49 -108
  281. package/src/runtime/control-plane/facade/work-continuation.ts +8 -8
  282. package/src/runtime/control-plane/generated-cache-retention.ts +97 -1
  283. package/src/runtime/control-plane/global-scheduler/autonomous-continuation.ts +248 -0
  284. package/src/runtime/control-plane/global-scheduler/durable-admission.ts +1 -1
  285. package/src/runtime/control-plane/global-scheduler/maintenance.ts +239 -112
  286. package/src/runtime/control-plane/global-scheduler/reconciliation.ts +2 -1
  287. package/src/runtime/control-plane/global-scheduler/scheduler.ts +66 -40
  288. package/src/runtime/control-plane/global-scheduler/wake-signal.ts +42 -2
  289. package/src/runtime/control-plane/governance/access-policy.ts +19 -2
  290. package/src/runtime/control-plane/governance/authorization.ts +20 -3
  291. package/src/runtime/control-plane/launcher/chatgpt-round-continuation.ts +63 -300
  292. package/src/runtime/control-plane/launcher/chatgpt-work-continuation.ts +28 -300
  293. package/src/runtime/control-plane/launcher/local-conversation-controller.ts +238 -0
  294. package/src/runtime/control-plane/launcher/provider-mcp-bootstrap.ts +5 -2
  295. package/src/runtime/control-plane/launcher/thin-launcher.ts +96 -240
  296. package/src/runtime/control-plane/persistence/cognition-store.ts +820 -0
  297. package/src/runtime/control-plane/persistence/experience-store.ts +162 -29
  298. package/src/runtime/control-plane/persistence/requirement-store.ts +216 -74
  299. package/src/runtime/control-plane/persistence/sqlite-store.ts +113 -6
  300. package/src/runtime/control-plane/release-retention.ts +135 -47
  301. package/src/runtime/control-plane/repository-namespace-retention.ts +2 -2
  302. package/src/runtime/control-plane/runtime-cleanup.ts +290 -21
  303. package/src/runtime/control-plane/workspace/project-onboarding.ts +80 -0
  304. package/src/runtime/control-plane/workspace/semantic-sync-service.ts +19 -5
  305. package/src/runtime/control-plane/workspace/workspace-store.ts +169 -0
  306. package/src/runtime/diagnostics/incident-repair.ts +313 -146
  307. package/src/runtime/diagnostics/mcp-timing.ts +114 -0
  308. package/src/runtime/evidence/artifact-store.ts +158 -40
  309. package/src/runtime/evidence/evidence-store.ts +112 -8
  310. package/src/runtime/evidence/output-handle-index.ts +225 -0
  311. package/src/runtime/evidence/result-store.ts +158 -44
  312. package/src/runtime/execution/jobs/store.ts +3 -4
  313. package/src/runtime/execution/managed-workspace.ts +57 -0
  314. package/src/runtime/execution/process-runtime/check-facade.ts +1 -1
  315. package/src/runtime/execution/process-runtime/check-result-retention.ts +2 -2
  316. package/src/runtime/execution/process-runtime/check-result.ts +105 -1
  317. package/src/runtime/execution/process-runtime/check-runner-sidecar.ts +18 -8
  318. package/src/runtime/execution/process-runtime/command-facade.ts +79 -27
  319. package/src/runtime/execution/process-runtime/gc.ts +15 -2
  320. package/src/runtime/execution/process-runtime/handle-index.ts +176 -0
  321. package/src/runtime/execution/process-runtime/host-command-lane.ts +139 -0
  322. package/src/runtime/execution/process-runtime/index.ts +3 -0
  323. package/src/runtime/execution/process-runtime/lightweight-managed.ts +251 -72
  324. package/src/runtime/execution/process-runtime/persisted-check.ts +3 -3
  325. package/src/runtime/execution/process-runtime/process-runner-entry.ts +47 -5
  326. package/src/runtime/execution/process-runtime/process-scope.ts +160 -0
  327. package/src/runtime/execution/process-runtime/resource-claims.ts +65 -61
  328. package/src/runtime/execution/process-runtime/runtime.ts +35 -2
  329. package/src/runtime/execution/process-runtime/store.ts +30 -2
  330. package/src/runtime/execution/process-runtime/types.ts +6 -1
  331. package/src/runtime/execution/workers/executor.ts +2 -6
  332. package/src/runtime/platform/service-inventory.ts +130 -0
  333. package/src/runtime/platform/service-manager.ts +8 -0
  334. package/src/runtime/plugins/action-application.ts +85 -28
  335. package/src/runtime/plugins/app-store-connect-adapter.ts +38 -14
  336. package/src/runtime/plugins/browser-adapter.ts +757 -34
  337. package/src/runtime/plugins/browser-automation-service.ts +23 -3
  338. package/src/runtime/plugins/browser-macos-bridge.ts +321 -29
  339. package/src/runtime/plugins/browser-manifest-surface.ts +45 -11
  340. package/src/runtime/plugins/browser-native-session-service.ts +63 -13
  341. package/src/runtime/plugins/browser-registration.ts +16 -0
  342. package/src/runtime/plugins/browser-runtime.ts +14 -1
  343. package/src/runtime/plugins/browser-session-authority.ts +2 -2
  344. package/src/runtime/plugins/browser-session-store.ts +46 -76
  345. package/src/runtime/plugins/capability-authorization-grants.ts +258 -62
  346. package/src/runtime/plugins/computer-chatgpt-browser-adapter-installer.ts +219 -0
  347. package/src/runtime/plugins/computer-chatgpt-macos-target.ts +891 -0
  348. package/src/runtime/plugins/computer-registration.ts +222 -11
  349. package/src/runtime/plugins/desktop-operator-external-policy.ts +36 -4
  350. package/src/runtime/plugins/desktop-operator-registration.ts +12 -4
  351. package/src/runtime/plugins/external-adapter.ts +42 -6
  352. package/src/runtime/plugins/external-registration.ts +21 -1
  353. package/src/runtime/plugins/gmail-adapter.ts +23 -2
  354. package/src/runtime/plugins/google-calendar-adapter.ts +2 -2
  355. package/src/runtime/plugins/google-shared.ts +14 -7
  356. package/src/runtime/plugins/google-tasks-adapter.ts +2 -2
  357. package/src/runtime/plugins/ios-adapter.ts +1 -1
  358. package/src/runtime/plugins/lightweight-action.ts +208 -2
  359. package/src/runtime/plugins/local-system-adapter.ts +12 -2
  360. package/src/runtime/plugins/managed-process-adapter.ts +12 -5
  361. package/src/runtime/plugins/plugin-action-sidecar.ts +17 -13
  362. package/src/runtime/plugins/plugin-management-adapter.ts +1 -1
  363. package/src/runtime/plugins/store.ts +602 -428
  364. package/src/runtime/plugins/types.ts +20 -0
  365. package/src/runtime/plugins/xiaohongshu-publish.ts +16 -0
  366. package/src/runtime/projections/invalidation.ts +7 -3
  367. package/src/runtime/projections/materialized-view.ts +80 -36
  368. package/src/runtime/recovery/actions.ts +3 -3
  369. package/src/runtime/recovery/capability-action-application.ts +46 -45
  370. package/src/runtime/recovery/lifecycle-inventory.ts +29 -29
  371. package/src/runtime/recovery/maintenance-executor.ts +374 -123
  372. package/src/runtime/recovery/store.ts +29 -11
  373. package/src/runtime/release/release-coordinator.ts +296 -0
  374. package/src/runtime/release/release-session.ts +716 -0
  375. package/src/runtime/release/release-state-migration.ts +25 -0
  376. package/src/runtime/resources/leases/store.ts +56 -25
  377. package/src/runtime/root/computer-composition.ts +191 -6
  378. package/src/runtime/root/controller-progression-composition.ts +192 -0
  379. package/src/runtime/root/controller-round-composition.ts +20 -1
  380. package/src/runtime/root/deployment-topology.ts +106 -0
  381. package/src/runtime/root/entry.ts +4 -3
  382. package/src/runtime/root/known-good-recovery.ts +184 -0
  383. package/src/runtime/root/local-bridge.ts +0 -1
  384. package/src/runtime/root/mcp-transport.ts +111 -18
  385. package/src/runtime/root/ownership.ts +261 -9
  386. package/src/runtime/root/package-connector-service.ts +105 -19
  387. package/src/runtime/root/package-runtime-release.ts +117 -18
  388. package/src/runtime/root/package-runtime-service.ts +17 -11
  389. package/src/runtime/root/release-execution-canary.ts +44 -12
  390. package/src/runtime/root/release-loader.ts +90 -8
  391. package/src/runtime/root/release-manifest.ts +80 -6
  392. package/src/runtime/root/release-materialize.ts +372 -28
  393. package/src/runtime/root/release-store.ts +395 -36
  394. package/src/runtime/root/runtime-lane.ts +191 -0
  395. package/src/runtime/root/runtime.ts +159 -27
  396. package/src/runtime/root/scheduled-controller-composition.ts +28 -3
  397. package/src/runtime/root/service-runner.ts +2 -2
  398. package/src/runtime/root/service.ts +36 -33
  399. package/src/runtime/root/status.ts +48 -0
  400. package/src/runtime/root/types.ts +32 -3
  401. package/src/runtime/root/workflow-supervisor-composition.ts +493 -0
  402. package/src/runtime/root/workflow-supervisor-runtime.ts +209 -0
  403. package/src/runtime/root/write-fence.ts +50 -2
  404. package/src/runtime/safe-tooling/google-credential-store.ts +76 -21
  405. package/src/runtime/safe-tooling/google-oauth-broker.ts +25 -7
  406. package/src/runtime/safe-tooling/workspace-auth.ts +1 -1
  407. package/src/runtime/shared/bounded-child-supervisor.ts +9 -1
  408. package/src/runtime/shared/process-environment.ts +20 -9
  409. package/src/runtime/shared/response-budget.ts +1 -3
  410. package/src/runtime/standalone-recovery/controller-home-migration.ts +16 -24
  411. package/src/runtime/standalone-recovery/core.ts +3702 -342
  412. package/src/runtime/standalone-recovery/entry.ts +469 -39
  413. package/src/runtime/standalone-recovery/installer.ts +262 -148
  414. package/src/runtime/standalone-recovery/mcp-server.ts +29 -193
  415. package/src/runtime/standalone-recovery/operation-lock.ts +1 -1
  416. package/src/runtime/standalone-recovery/performance.ts +54 -16
  417. package/src/runtime/standalone-recovery/release.ts +53 -5
  418. package/src/runtime/standalone-recovery/service-labels.ts +5 -2
  419. package/src/runtime/standalone-recovery/watchdog-heartbeat.ts +5 -2
  420. package/src/runtime/workflow/schedules/browser-probe.ts +17 -6
  421. package/src/runtime/workflow/schedules/chatgpt-automation-migration.ts +10 -3
  422. package/src/runtime/workflow/schedules/engine.ts +138 -172
  423. package/src/runtime/workflow/schedules/work-continuation.ts +44 -5
  424. package/src/runtime/workflows/runtime.ts +15 -19
  425. package/src/testing/test-governance.ts +5 -1
  426. package/supervisor/chatgpt-conversation.ts +23 -0
  427. package/supervisor/client.ts +201 -0
  428. package/supervisor/control-plane.ts +868 -0
  429. package/supervisor/entry.ts +15 -0
  430. package/supervisor/forge-validators.ts +80 -0
  431. package/supervisor/index.ts +5 -0
  432. package/supervisor/native-browser-adapter.ts +786 -0
  433. package/supervisor/native-messaging/host.ts +39 -0
  434. package/supervisor/native-messaging/manifest.ts +26 -0
  435. package/supervisor/native-messaging/protocol.ts +27 -0
  436. package/supervisor/paths.ts +18 -0
  437. package/supervisor/protocol.ts +202 -0
  438. package/supervisor/server.ts +404 -0
  439. package/supervisor/store.ts +1451 -0
  440. package/supervisor/tsconfig.json +8 -0
  441. package/supervisor/types.ts +255 -0
  442. package/adapters/chatgpt/controller-host.ts +0 -119
  443. package/adapters/mcp/controller-round-compatibility.ts +0 -184
  444. package/adapters/mcp/frozen-client-semantic-compatibility.ts +0 -292
  445. package/adapters/mcp/runtime-gateway/work-compat-adapter.ts +0 -502
  446. package/packages/kernel/progression/api/index.ts +0 -2
  447. package/packages/kernel/progression/application/projector.ts +0 -211
  448. package/packages/kernel/progression/domain/types.ts +0 -116
  449. package/packages/kernel/progression/index.ts +0 -1
  450. package/packages/kernel/scheduler/application/continuation-service.ts +0 -212
  451. package/packages/kernel/scheduler/domain/continuation.ts +0 -38
  452. package/packages/kernel/scheduler/infrastructure/continuation-dispatch-store.ts +0 -38
  453. package/packages/kernel/work/domain/admission-policy.ts +0 -34
  454. package/scripts/benchmark-background-check-overlap.ts +0 -228
  455. package/scripts/benchmark-computer-hotpath.ts +0 -255
  456. package/scripts/benchmark-controller-hotpath.ts +0 -212
  457. package/scripts/benchmark-controller-round2.ts +0 -191
  458. package/scripts/benchmark-ios-agent-device.ts +0 -511
  459. package/scripts/benchmark-mcp-host.sh +0 -117
  460. package/scripts/benchmark-mcp-transport.ts +0 -169
  461. package/scripts/benchmark-operational-memory-activation.ts +0 -235
  462. package/scripts/benchmark-operational-shadow.ts +0 -28
  463. package/scripts/benchmark-quality-harness.ts +0 -146
  464. package/scripts/benchmark-route-session-concurrency.ts +0 -915
  465. package/scripts/benchmark-thin-harness-gateway-ab.ts +0 -632
  466. package/scripts/benchmark-thin-harness-mcp-e2e.ts +0 -498
  467. package/scripts/benchmark-thin-harness.ts +0 -251
  468. package/scripts/benchmark-typescript-navigation.ts +0 -186
  469. package/scripts/benchmark-work-efficiency.ts +0 -334
  470. package/scripts/build-controller-ui.ts +0 -28
  471. package/scripts/check-npm-release.sh +0 -32
  472. package/scripts/check-public-release-surface.sh +0 -19
  473. package/scripts/check-release-published.sh +0 -57
  474. package/scripts/check-release-readiness.sh +0 -37
  475. package/scripts/check-release-version.mjs +0 -74
  476. package/scripts/check-tarball-install-smoke.sh +0 -150
  477. package/scripts/package-source-archive.sh +0 -147
  478. package/scripts/public-release-files.txt +0 -39
  479. package/scripts/public-release.ts +0 -174
  480. package/scripts/publish-release-tarball.sh +0 -27
  481. package/scripts/route-nl-vs-ts-eval.ts +0 -679
  482. package/scripts/stage-runtime-release.ts +0 -44
  483. package/src/cli/controller/progress.ts +0 -656
  484. package/src/cli/controller/work-mode.ts +0 -181
  485. package/src/cli/local-bridge/console-assets.ts +0 -17
  486. package/src/cli/local-bridge/dashboard.ts +0 -17
  487. package/src/cli/local-bridge/frontend/src/App.tsx +0 -10
  488. package/src/cli/local-bridge/frontend/src/components/Button.tsx +0 -1
  489. package/src/cli/local-bridge/frontend/src/components/DetailPane.tsx +0 -3
  490. package/src/cli/local-bridge/frontend/src/components/SearchField.tsx +0 -1
  491. package/src/cli/local-bridge/frontend/src/components/SectionHeader.tsx +0 -1
  492. package/src/cli/local-bridge/frontend/src/components/Segmented.tsx +0 -1
  493. package/src/cli/local-bridge/frontend/src/components/StatusText.tsx +0 -3
  494. package/src/cli/local-bridge/frontend/src/design/icons.tsx +0 -11
  495. package/src/cli/local-bridge/frontend/src/design/tokens.css +0 -8
  496. package/src/cli/local-bridge/frontend/src/features/automations/AutomationsView.tsx +0 -153
  497. package/src/cli/local-bridge/frontend/src/features/capabilities/CapabilitiesView.tsx +0 -37
  498. package/src/cli/local-bridge/frontend/src/features/overview/OverviewView.tsx +0 -183
  499. package/src/cli/local-bridge/frontend/src/features/repositories/RepositoriesView.tsx +0 -2
  500. package/src/cli/local-bridge/frontend/src/features/system/SystemView.tsx +0 -2
  501. package/src/cli/local-bridge/frontend/src/features/work/WorkView.tsx +0 -4
  502. package/src/cli/local-bridge/frontend/src/lib/api.ts +0 -30
  503. package/src/cli/local-bridge/frontend/src/lib/format.ts +0 -4
  504. package/src/cli/local-bridge/frontend/src/lib/routes.ts +0 -7
  505. package/src/cli/local-bridge/frontend/src/main.tsx +0 -1
  506. package/src/cli/local-bridge/frontend/src/shell/AppShell.tsx +0 -1
  507. package/src/cli/local-bridge/frontend/src/shell/CommandBar.tsx +0 -2
  508. package/src/cli/local-bridge/frontend/src/shell/Sidebar.tsx +0 -4
  509. package/src/cli/local-bridge/frontend/src/styles.css +0 -28
  510. package/src/cli/local-bridge/frontend/src/types.ts +0 -15
  511. package/src/cli/local-bridge/frontend/src/vite-env.d.ts +0 -1
  512. package/src/cli/local-bridge/frontend/vite.config.ts +0 -27
  513. package/src/cli/local-bridge/ui-dist/app.css +0 -1
  514. package/src/cli/local-bridge/ui-dist/app.js +0 -11228
  515. package/src/runtime/control-plane/execution/content-equivalent-commit-authority.ts +0 -169
  516. package/src/runtime/control-plane/execution/direct-canonical-work-reconciliation.ts +0 -85
  517. package/src/runtime/control-plane/execution/direct-edit-work-completion.ts +0 -655
  518. package/src/runtime/control-plane/execution/work-finalization-service.ts +0 -2850
  519. package/src/runtime/control-plane/execution/work-path-scope.ts +0 -37
  520. package/src/runtime/control-plane/execution/work-task-receipt.ts +0 -468
  521. package/src/runtime/control-plane/facade/controller-round-relay.ts +0 -3
  522. package/src/runtime/control-plane/facade/work-admission-policy.ts +0 -142
  523. package/src/runtime/control-plane/facade/work-implementation-review.ts +0 -2
  524. package/src/runtime/control-plane/facade/work-state-machine.ts +0 -2
  525. package/src/runtime/control-plane/facade/work-task-projection.ts +0 -66
  526. package/src/runtime/control-plane/routing/index.ts +0 -1
  527. package/src/runtime/control-plane/routing/route-policy.ts +0 -401
  528. package/src/runtime/control-plane/routing/workspace-admission.ts +0 -70
@@ -0,0 +1,104 @@
1
+ import type { ScopeRef } from '../../identity/api/index';
2
+ import { semanticScopeRefForWork, type WorkContract } from './types';
3
+
4
+ export interface CurrentTaskSemanticProjection {
5
+ schemaVersion: 1;
6
+ workId: string;
7
+ objective: string;
8
+ semanticScope: ScopeRef;
9
+ lifecycleRole: 'primary' | 'execution_child';
10
+ requirementId?: string;
11
+ planId?: string;
12
+ planStepId?: string;
13
+ parentWorkId?: string;
14
+ /** Objective graph metadata is projected for clients but never expands exact current-task authority. */
15
+ semanticParentWorkId?: string;
16
+ dependsOnWorkIds: string[];
17
+ predecessorWorkId?: string;
18
+ supersedes: string[];
19
+ supersededBy?: string;
20
+ }
21
+
22
+ /**
23
+ * Exact semantic identity for the task currently being executed.
24
+ * Broader Requirement/Plan membership is descriptive lineage metadata only.
25
+ */
26
+ export function currentTaskSemanticProjectionForWork(work: WorkContract): CurrentTaskSemanticProjection {
27
+ return {
28
+ schemaVersion: 1,
29
+ workId: work.workId,
30
+ objective: work.objective,
31
+ semanticScope: semanticScopeRefForWork(work),
32
+ lifecycleRole: work.lifecycleRole ?? 'primary',
33
+ ...(work.requirementId?.trim() ? { requirementId: work.requirementId.trim() } : {}),
34
+ ...(work.planId?.trim() ? { planId: work.planId.trim() } : {}),
35
+ ...(work.planStepId?.trim() ? { planStepId: work.planStepId.trim() } : {}),
36
+ ...(work.parentWorkId?.trim() ? { parentWorkId: work.parentWorkId.trim() } : {}),
37
+ ...(work.semanticParentWorkId?.trim() ? { semanticParentWorkId: work.semanticParentWorkId.trim() } : {}),
38
+ dependsOnWorkIds: [...new Set((work.dependsOnWorkIds ?? []).map((id) => id.trim()).filter(Boolean))].sort(),
39
+ ...(work.predecessorWorkId?.trim() ? { predecessorWorkId: work.predecessorWorkId.trim() } : {}),
40
+ supersedes: [...new Set((work.supersedes ?? []).map((id) => id.trim()).filter(Boolean))].sort(),
41
+ ...(work.supersededBy?.trim() ? { supersededBy: work.supersededBy.trim() } : {}),
42
+ };
43
+ }
44
+
45
+ /**
46
+ * Derive only explicit Work lineage. Broad Requirement/Plan membership is
47
+ * deliberately ignored because it is Goal scope, not current-task authority.
48
+ */
49
+ export function currentTaskLineageWorkIds(
50
+ originWorkIds: readonly string[],
51
+ contracts: readonly WorkContract[],
52
+ ): Set<string> {
53
+ const byId = new Map(contracts.map((contract) => [contract.workId, contract] as const));
54
+ const forward = new Set(originWorkIds.map((id) => id.trim()).filter((id) => id && byId.has(id)));
55
+
56
+ // Expand only *forward* from the exact origin(s). A child may include its
57
+ // parent as ancestry later, but that parent must never become a new forward
58
+ // seed that pulls sibling children into the current task.
59
+ let expanded = true;
60
+ while (expanded) {
61
+ expanded = false;
62
+ for (const work of contracts) {
63
+ if (forward.has(work.workId)) {
64
+ const explicitSuccessor = work.supersededBy?.trim();
65
+ if (explicitSuccessor && byId.has(explicitSuccessor) && !forward.has(explicitSuccessor)) {
66
+ forward.add(explicitSuccessor);
67
+ expanded = true;
68
+ }
69
+ continue;
70
+ }
71
+ const parentWorkId = work.parentWorkId?.trim();
72
+ const predecessorWorkId = work.predecessorWorkId?.trim();
73
+ const supersedes = (work.supersedes ?? []).map((id) => id.trim()).filter(Boolean);
74
+ if (
75
+ (parentWorkId && forward.has(parentWorkId))
76
+ || (predecessorWorkId && forward.has(predecessorWorkId))
77
+ || supersedes.some((id) => forward.has(id))
78
+ ) {
79
+ forward.add(work.workId);
80
+ expanded = true;
81
+ }
82
+ }
83
+ }
84
+
85
+ // Preserve explicit ancestry for audit/fencing, but never use ancestors as
86
+ // descendant-expansion seeds. That keeps fork siblings independent.
87
+ const linked = new Set(forward);
88
+ const upstream = [...forward];
89
+ while (upstream.length > 0) {
90
+ const work = byId.get(upstream.pop()!);
91
+ if (!work) continue;
92
+ const ancestors = [
93
+ work.parentWorkId,
94
+ work.predecessorWorkId,
95
+ ...(work.supersedes ?? []),
96
+ ].map((id) => id?.trim()).filter((id): id is string => Boolean(id));
97
+ for (const id of ancestors) {
98
+ if (!byId.has(id) || linked.has(id)) continue;
99
+ linked.add(id);
100
+ upstream.push(id);
101
+ }
102
+ }
103
+ return linked;
104
+ }
@@ -31,8 +31,8 @@ export const ENGINEERING_DECISION_AREAS = [
31
31
  ] as const;
32
32
  export type EngineeringDecisionArea = (typeof ENGINEERING_DECISION_AREAS)[number];
33
33
  export type EngineeringCritiqueDecision = 'approved' | 'changes_required' | 'blocked';
34
- export type EngineeringBlockerClassification = 'same_root_cause' | 'unrelated';
35
- export type EngineeringBlockerAction = 'return_to_design' | 'linked_work';
34
+ export type EngineeringBlockerClassification = 'same_root_cause' | 'same_root_cause_scope_extension' | 'unrelated';
35
+ export type EngineeringBlockerAction = 'return_to_design' | 'extend_candidate' | 'linked_work';
36
36
 
37
37
  const MAX_ITEMS = 64;
38
38
  const MAX_TEXT = 2_000;
@@ -256,15 +256,20 @@ export function buildEngineeringBlockerDispositionReceipt(input: {
256
256
  rationale: string;
257
257
  recordedAt: string;
258
258
  }): EngineeringBlockerDispositionReceipt {
259
- if (!['same_root_cause', 'unrelated'].includes(input.classification)) throw new Error('ENGINEERING_BLOCKER_CLASSIFICATION_INVALID');
259
+ if (!['same_root_cause', 'same_root_cause_scope_extension', 'unrelated'].includes(input.classification)) throw new Error('ENGINEERING_BLOCKER_CLASSIFICATION_INVALID');
260
260
  const linkedWorkId = input.linkedWorkId?.trim() || undefined;
261
+ const sameRootCause = input.classification !== 'unrelated';
261
262
  if (input.classification === 'unrelated' && !linkedWorkId) throw new Error('ENGINEERING_BLOCKER_LINKED_WORK_REQUIRED');
262
- if (input.classification === 'same_root_cause' && linkedWorkId) throw new Error('ENGINEERING_BLOCKER_LINKED_WORK_FORBIDDEN');
263
+ if (sameRootCause && linkedWorkId) throw new Error('ENGINEERING_BLOCKER_LINKED_WORK_FORBIDDEN');
263
264
  const core = {
264
265
  sourceRevision: text(input.sourceRevision, 'ENGINEERING_BLOCKER_SOURCE_REQUIRED'),
265
266
  blockerId: text(input.blockerId, 'ENGINEERING_BLOCKER_ID_REQUIRED'),
266
267
  classification: input.classification,
267
- action: input.classification === 'same_root_cause' ? 'return_to_design' as const : 'linked_work' as const,
268
+ action: input.classification === 'same_root_cause'
269
+ ? 'return_to_design' as const
270
+ : input.classification === 'same_root_cause_scope_extension'
271
+ ? 'extend_candidate' as const
272
+ : 'linked_work' as const,
268
273
  semanticScopeKeys: list(input.semanticScopeKeys ?? [], 'ENGINEERING_BLOCKER_SCOPE_INVALID', false),
269
274
  ...(linkedWorkId ? { linkedWorkId: text(linkedWorkId, 'ENGINEERING_BLOCKER_LINKED_WORK_INVALID') } : {}),
270
275
  rationale: text(input.rationale, 'ENGINEERING_BLOCKER_RATIONALE_REQUIRED'),
@@ -73,7 +73,9 @@ const PROFILES: Record<EngineeringRiskClass, EngineeringWorkProfile> = {
73
73
  schemaVersion: 1,
74
74
  profileVersion: ENGINEERING_WORK_PROFILE_VERSION,
75
75
  riskClass: 'high',
76
- admissionEnforcement: 'enforce',
76
+ // Engineering evidence is useful model/project guidance, never a Kernel
77
+ // mutation-admission authority. Safety/resource admission lives elsewhere.
78
+ admissionEnforcement: 'observe',
77
79
  evidenceRequirements: requirement('required', 'required', 'required', 'required', 'required', 'conditional', 'required', 'conditional', 'required'),
78
80
  admissionEvidence: ['project_contract', 'context_closure', 'product_dod', 'design_decision', 'independent_critique'],
79
81
  completionEvidence: ['focused_validation', 'fresh_review'],
@@ -82,7 +84,7 @@ const PROFILES: Record<EngineeringRiskClass, EngineeringWorkProfile> = {
82
84
  schemaVersion: 1,
83
85
  profileVersion: ENGINEERING_WORK_PROFILE_VERSION,
84
86
  riskClass: 'critical',
85
- admissionEnforcement: 'enforce',
87
+ admissionEnforcement: 'observe',
86
88
  evidenceRequirements: requirement('required', 'required', 'required', 'required', 'required', 'required', 'required', 'required', 'required'),
87
89
  admissionEvidence: ['project_contract', 'context_closure', 'product_dod', 'design_decision', 'independent_critique', 'semantic_tools'],
88
90
  completionEvidence: ['focused_validation', 'real_journey', 'fresh_review'],
@@ -208,16 +210,10 @@ export function evaluateEngineeringAdmission(input: {
208
210
  receipt: EngineeringContextReceipt;
209
211
  mutation: boolean;
210
212
  }): { allowed: true } | { allowed: false; code: string; missing: EngineeringEvidenceKind[] } {
211
- if (!input.mutation || input.profile.admissionEnforcement === 'observe') return { allowed: true };
212
- if (input.receipt.sourceIdentity.kind === 'unknown') {
213
- return { allowed: false, code: 'ENGINEERING_SOURCE_IDENTITY_REQUIRED', missing: input.receipt.missingAdmissionEvidence };
214
- }
215
- if (input.receipt.designState === 'revisit_required') {
216
- return { allowed: false, code: 'ENGINEERING_DESIGN_REVISIT_REQUIRED', missing: ['design_decision', 'independent_critique'] };
217
- }
218
- if (input.receipt.missingAdmissionEvidence.length > 0) {
219
- return { allowed: false, code: 'ENGINEERING_ADMISSION_EVIDENCE_REQUIRED', missing: input.receipt.missingAdmissionEvidence };
220
- }
213
+ // Forge records these receipts for model judgment, audit, and project-level
214
+ // acceptance. It must not prescribe an engineering methodology before a
215
+ // mutation. Source/CAS/security/resource safety is enforced by capabilities.
216
+ void input;
221
217
  return { allowed: true };
222
218
  }
223
219
 
@@ -0,0 +1,186 @@
1
+ import { createHash } from 'crypto';
2
+ import type { WorkImplementationReviewEvidenceIdentity } from './implementation-review';
3
+
4
+ export const EVALUATION_PROMOTION_RECEIPT_SCHEMA = 'forge-evaluation-promotion-receipt/v1' as const;
5
+ export const EVALUATION_PROMOTION_RECEIPT_AUTHORITY = 'evaluation_evidence_only' as const;
6
+ export const EVALUATION_CANDIDATE_IDENTITY_SCHEMA = 'forge-candidate-identity/v1' as const;
7
+
8
+ export interface EvaluationPromotionCandidateIdentity {
9
+ schemaVersion: typeof EVALUATION_CANDIDATE_IDENTITY_SCHEMA;
10
+ candidateId: string;
11
+ versionLabel: string;
12
+ artifactDigest: string;
13
+ sourceRevision?: string;
14
+ executionSurface: 'public_cli' | 'public_mcp';
15
+ }
16
+
17
+ export interface EvaluationPromotionReceipt {
18
+ schemaVersion: typeof EVALUATION_PROMOTION_RECEIPT_SCHEMA;
19
+ authority: typeof EVALUATION_PROMOTION_RECEIPT_AUTHORITY;
20
+ receiptId: string;
21
+ baseline: EvaluationPromotionCandidateIdentity;
22
+ candidate: EvaluationPromotionCandidateIdentity;
23
+ evidence: {
24
+ paired: {
25
+ protocolDigest: string;
26
+ environmentFingerprint: string;
27
+ pairCount: number;
28
+ evidenceDigest: string;
29
+ };
30
+ shadow: {
31
+ protocolDigest: string;
32
+ pairedScenarioCount: number;
33
+ evidenceDigest: string;
34
+ };
35
+ certification?: {
36
+ manifestDigest: string;
37
+ };
38
+ };
39
+ }
40
+
41
+ export type EvaluationPromotionReceiptCore = Omit<EvaluationPromotionReceipt, 'receiptId'>;
42
+
43
+ function requiredText(value: unknown, field: string): string {
44
+ const normalized = typeof value === 'string' ? value.trim() : '';
45
+ if (!normalized) throw new Error(`EVALUATION_PROMOTION_RECEIPT_${field.toUpperCase()}_REQUIRED`);
46
+ return normalized;
47
+ }
48
+
49
+ function nonNegativeInteger(value: unknown, field: string): number {
50
+ if (!Number.isInteger(value) || Number(value) < 0) {
51
+ throw new Error(`EVALUATION_PROMOTION_RECEIPT_${field.toUpperCase()}_INVALID`);
52
+ }
53
+ return Number(value);
54
+ }
55
+
56
+ function candidateIdentity(value: unknown, field: 'baseline' | 'candidate'): EvaluationPromotionCandidateIdentity {
57
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
58
+ throw new Error(`EVALUATION_PROMOTION_RECEIPT_${field.toUpperCase()}_REQUIRED`);
59
+ }
60
+ const input = value as Record<string, unknown>;
61
+ if (input.schemaVersion !== EVALUATION_CANDIDATE_IDENTITY_SCHEMA) {
62
+ throw new Error(`EVALUATION_PROMOTION_RECEIPT_${field.toUpperCase()}_SCHEMA_INVALID`);
63
+ }
64
+ if (input.executionSurface !== 'public_cli' && input.executionSurface !== 'public_mcp') {
65
+ throw new Error(`EVALUATION_PROMOTION_RECEIPT_${field.toUpperCase()}_SURFACE_INVALID`);
66
+ }
67
+ const sourceRevision = typeof input.sourceRevision === 'string' && input.sourceRevision.trim()
68
+ ? input.sourceRevision.trim()
69
+ : undefined;
70
+ return {
71
+ schemaVersion: EVALUATION_CANDIDATE_IDENTITY_SCHEMA,
72
+ candidateId: requiredText(input.candidateId, `${field}_candidate_id`),
73
+ versionLabel: requiredText(input.versionLabel, `${field}_version_label`),
74
+ artifactDigest: requiredText(input.artifactDigest, `${field}_artifact_digest`),
75
+ ...(sourceRevision ? { sourceRevision } : {}),
76
+ executionSurface: input.executionSurface,
77
+ };
78
+ }
79
+
80
+ function receiptCore(value: unknown): EvaluationPromotionReceiptCore {
81
+ if (!value || typeof value !== 'object' || Array.isArray(value)) {
82
+ throw new Error('EVALUATION_PROMOTION_RECEIPT_INVALID');
83
+ }
84
+ const input = value as Record<string, unknown>;
85
+ if (input.schemaVersion !== EVALUATION_PROMOTION_RECEIPT_SCHEMA) {
86
+ throw new Error('EVALUATION_PROMOTION_RECEIPT_SCHEMA_INVALID');
87
+ }
88
+ if (input.authority !== EVALUATION_PROMOTION_RECEIPT_AUTHORITY) {
89
+ throw new Error('EVALUATION_PROMOTION_RECEIPT_AUTHORITY_INVALID');
90
+ }
91
+ if (!input.evidence || typeof input.evidence !== 'object' || Array.isArray(input.evidence)) {
92
+ throw new Error('EVALUATION_PROMOTION_RECEIPT_EVIDENCE_REQUIRED');
93
+ }
94
+ const evidence = input.evidence as Record<string, unknown>;
95
+ if (!evidence.paired || typeof evidence.paired !== 'object' || Array.isArray(evidence.paired)) {
96
+ throw new Error('EVALUATION_PROMOTION_RECEIPT_PAIRED_REQUIRED');
97
+ }
98
+ if (!evidence.shadow || typeof evidence.shadow !== 'object' || Array.isArray(evidence.shadow)) {
99
+ throw new Error('EVALUATION_PROMOTION_RECEIPT_SHADOW_REQUIRED');
100
+ }
101
+ const paired = evidence.paired as Record<string, unknown>;
102
+ const shadow = evidence.shadow as Record<string, unknown>;
103
+ let certification: EvaluationPromotionReceipt['evidence']['certification'];
104
+ if (evidence.certification !== undefined) {
105
+ if (!evidence.certification || typeof evidence.certification !== 'object' || Array.isArray(evidence.certification)) {
106
+ throw new Error('EVALUATION_PROMOTION_RECEIPT_CERTIFICATION_INVALID');
107
+ }
108
+ certification = {
109
+ manifestDigest: requiredText(
110
+ (evidence.certification as Record<string, unknown>).manifestDigest,
111
+ 'certification_manifest_digest',
112
+ ),
113
+ };
114
+ }
115
+ return {
116
+ schemaVersion: EVALUATION_PROMOTION_RECEIPT_SCHEMA,
117
+ authority: EVALUATION_PROMOTION_RECEIPT_AUTHORITY,
118
+ baseline: candidateIdentity(input.baseline, 'baseline'),
119
+ candidate: candidateIdentity(input.candidate, 'candidate'),
120
+ evidence: {
121
+ paired: {
122
+ protocolDigest: requiredText(paired.protocolDigest, 'paired_protocol_digest'),
123
+ environmentFingerprint: requiredText(paired.environmentFingerprint, 'paired_environment_fingerprint'),
124
+ pairCount: nonNegativeInteger(paired.pairCount, 'paired_pair_count'),
125
+ evidenceDigest: requiredText(paired.evidenceDigest, 'paired_evidence_digest'),
126
+ },
127
+ shadow: {
128
+ protocolDigest: requiredText(shadow.protocolDigest, 'shadow_protocol_digest'),
129
+ pairedScenarioCount: nonNegativeInteger(shadow.pairedScenarioCount, 'shadow_paired_scenario_count'),
130
+ evidenceDigest: requiredText(shadow.evidenceDigest, 'shadow_evidence_digest'),
131
+ },
132
+ ...(certification ? { certification } : {}),
133
+ },
134
+ };
135
+ }
136
+
137
+ function receiptIdentity(core: EvaluationPromotionReceiptCore): string {
138
+ const digest = createHash('sha256')
139
+ .update(EVALUATION_PROMOTION_RECEIPT_SCHEMA)
140
+ .update('\0')
141
+ .update(JSON.stringify(core))
142
+ .digest('hex');
143
+ return `evaluation-promotion:sha256:${digest}`;
144
+ }
145
+
146
+ function deepFreeze<T>(value: T): T {
147
+ if (value && typeof value === 'object' && !Object.isFrozen(value)) {
148
+ for (const nested of Object.values(value as Record<string, unknown>)) deepFreeze(nested);
149
+ Object.freeze(value);
150
+ }
151
+ return value;
152
+ }
153
+
154
+ /**
155
+ * Identity constructor only. Eligibility authority remains in evaluation/.
156
+ * Callers outside the evaluator must not treat this helper as proof that A/B,
157
+ * shadow, or certification gates ran.
158
+ */
159
+ export function buildEvaluationPromotionReceipt(coreInput: EvaluationPromotionReceiptCore): EvaluationPromotionReceipt {
160
+ const core = receiptCore(coreInput);
161
+ return deepFreeze({ ...core, receiptId: receiptIdentity(core) });
162
+ }
163
+
164
+ export function validateEvaluationPromotionReceipt(value: unknown): EvaluationPromotionReceipt {
165
+ const core = receiptCore(value);
166
+ const receiptId = requiredText((value as Record<string, unknown>).receiptId, 'receipt_id');
167
+ const expected = receiptIdentity(core);
168
+ if (receiptId !== expected) throw new Error('EVALUATION_PROMOTION_RECEIPT_ID_INVALID');
169
+ return deepFreeze({ ...core, receiptId });
170
+ }
171
+
172
+ export function evaluationPromotionReceiptArchitectureEvidence(
173
+ value: unknown,
174
+ expectedSourceRevision: string,
175
+ ): WorkImplementationReviewEvidenceIdentity {
176
+ const receipt = validateEvaluationPromotionReceipt(value);
177
+ const sourceRevision = receipt.candidate.sourceRevision?.trim() ?? '';
178
+ const expected = expectedSourceRevision.trim();
179
+ if (!expected || !sourceRevision || sourceRevision !== expected) {
180
+ throw new Error(`EVALUATION_PROMOTION_RECEIPT_CANDIDATE_SOURCE_MISMATCH: expected=${expected || 'missing'} actual=${sourceRevision || 'missing'}`);
181
+ }
182
+ return {
183
+ evidenceId: receipt.receiptId,
184
+ digest: receipt.receiptId.slice('evaluation-promotion:'.length),
185
+ };
186
+ }
@@ -3,7 +3,6 @@ import type { WorkContract } from './types';
3
3
 
4
4
  export type WorkExecutionLane = 'read' | 'review' | 'isolated_write' | 'integration_write' | 'external_effect';
5
5
  export type WorkExecutionIsolation = 'shared' | 'isolated';
6
- export type WorkExecutionControllerRole = 'mutable_owner' | 'reviewer';
7
6
  export type WorkExecutionResourceMode = 'read' | 'write' | 'exclusive';
8
7
 
9
8
  export interface WorkExecutionResourceIntent {
@@ -14,13 +13,11 @@ export interface WorkExecutionResourceIntent {
14
13
  export type WorkExecutionWakeTrigger =
15
14
  | { kind: 'work_terminal'; workId: string }
16
15
  | { kind: 'resource_release'; resourceKeys: string[] }
17
- | { kind: 'controller_release'; workId: string }
18
16
  | { kind: 'scheduler_capacity'; capacityKey: string }
19
17
  | { kind: 'work_contract_change'; workId: string };
20
18
 
21
19
  export interface WorkExecutionConcurrencyBlocker {
22
20
  code:
23
- | 'reviewer_mutation_forbidden'
24
21
  | 'same_semantic_scope_mutation'
25
22
  | 'shared_mutation_lane_conflict'
26
23
  | 'integration_target_conflict'
@@ -44,7 +41,6 @@ export interface WorkExecutionConcurrencyContract {
44
41
  resourceIntents: WorkExecutionResourceIntent[];
45
42
  blockers: WorkExecutionConcurrencyBlocker[];
46
43
  isolation: WorkExecutionIsolation;
47
- controllerRole: WorkExecutionControllerRole;
48
44
  }
49
45
 
50
46
  export interface WorkExecutionConcurrencyInput {
@@ -81,7 +77,7 @@ function fallbackMutationClass(work: WorkContract): EngineeringMutationClass {
81
77
  || work.workKind === 'reconciliation'
82
78
  || work.workKind === 'superseded') return 'readonly';
83
79
  if (work.workKind === 'local_effect' || work.workKind === 'remote_effect') return 'external_effect';
84
- if (work.worktreePolicy.required || work.constraints.workspaceMode === 'isolated' || work.constraints.requireWorktree === true) {
80
+ if (work.worktreePolicy.required || work.constraints.workspaceMode === 'isolated') {
85
81
  return 'isolated_write';
86
82
  }
87
83
  return 'integration_write';
@@ -94,7 +90,20 @@ function semanticScopeKeys(work: WorkContract): string[] {
94
90
  return [`work:${work.workId}`];
95
91
  }
96
92
 
97
- function defaultLane(work: WorkContract, mutationClass: EngineeringMutationClass): WorkExecutionLane {
93
+ function defaultLane(
94
+ work: WorkContract,
95
+ mutationClass: EngineeringMutationClass,
96
+ resourceIntents: readonly WorkExecutionResourceIntent[],
97
+ requestedLane?: WorkExecutionLane,
98
+ ): WorkExecutionLane {
99
+ const hasMutableResourceIntent = resourceIntents.some((intent) => intent.mode !== 'read');
100
+ if (hasMutableResourceIntent && (!requestedLane || !workExecutionLaneMutates(requestedLane))) {
101
+ if (mutationClass === 'external_effect') return 'external_effect';
102
+ return work.worktreePolicy.required || work.constraints.workspaceMode === 'isolated'
103
+ ? 'isolated_write'
104
+ : 'integration_write';
105
+ }
106
+ if (requestedLane) return requestedLane;
98
107
  if (work.workKind === 'read_only_review') return 'review';
99
108
  if (mutationClass === 'readonly') return 'read';
100
109
  return mutationClass;
@@ -105,6 +114,7 @@ export function buildWorkExecutionConcurrencyContract(
105
114
  input: WorkExecutionConcurrencyInput = {},
106
115
  ): WorkExecutionConcurrencyContract {
107
116
  const mutationClass = work.engineeringContext?.semanticScope?.mutationClass ?? fallbackMutationClass(work);
117
+ const resourceIntents = normalizedResourceIntents(input.resourceIntents ?? []);
108
118
  return {
109
119
  schemaVersion: 1,
110
120
  workId: work.workId,
@@ -112,13 +122,12 @@ export function buildWorkExecutionConcurrencyContract(
112
122
  observedWorkUpdatedAt: work.updatedAt,
113
123
  semanticScopeKeys: semanticScopeKeys(work),
114
124
  mutationClass,
115
- lane: input.lane ?? defaultLane(work, mutationClass),
116
- resourceIntents: normalizedResourceIntents(input.resourceIntents ?? []),
125
+ lane: defaultLane(work, mutationClass, resourceIntents, input.lane),
126
+ resourceIntents,
117
127
  blockers: [...(input.blockers ?? [])],
118
- isolation: work.worktreePolicy.required || work.constraints.workspaceMode === 'isolated' || work.constraints.requireWorktree === true
128
+ isolation: work.worktreePolicy.required || work.constraints.workspaceMode === 'isolated'
119
129
  ? 'isolated'
120
130
  : 'shared',
121
- controllerRole: work.workKind === 'read_only_review' ? 'reviewer' : 'mutable_owner',
122
131
  };
123
132
  }
124
133
 
@@ -145,25 +154,11 @@ function sharedMutableResourceKeys(
145
154
  return mutableResourceKeys(left).filter((key) => rightKeys.has(key));
146
155
  }
147
156
 
148
- function invalidReviewerBlocker(contract: WorkExecutionConcurrencyContract): WorkExecutionConcurrencyBlocker | undefined {
149
- if (contract.controllerRole !== 'reviewer'
150
- || (!workExecutionLaneMutates(contract.lane) && mutableResourceKeys(contract).length === 0)) return undefined;
151
- return {
152
- code: 'reviewer_mutation_forbidden',
153
- disposition: 'invalid',
154
- semanticScopeKeys: contract.semanticScopeKeys,
155
- resourceKeys: mutableResourceKeys(contract),
156
- wakeTrigger: { kind: 'work_contract_change', workId: contract.workId },
157
- };
158
- }
159
-
160
157
  export function evaluateWorkExecutionCompatibility(
161
158
  candidate: WorkExecutionConcurrencyContract,
162
159
  active: readonly WorkExecutionConcurrencyContract[],
163
160
  ): WorkExecutionCompatibilityDecision {
164
161
  const blockers: WorkExecutionConcurrencyBlocker[] = [];
165
- const reviewerBlocker = invalidReviewerBlocker(candidate);
166
- if (reviewerBlocker) blockers.push(reviewerBlocker);
167
162
  if (candidate.lane === 'external_effect' && mutableResourceKeys(candidate).length === 0) {
168
163
  blockers.push({
169
164
  code: 'external_effect_target_unknown',
@@ -178,8 +173,6 @@ export function evaluateWorkExecutionCompatibility(
178
173
 
179
174
  for (const current of active) {
180
175
  if (current.workId === candidate.workId) continue;
181
- const currentReviewerBlocker = invalidReviewerBlocker(current);
182
- if (currentReviewerBlocker) continue;
183
176
  if (!workExecutionLaneMutates(current.lane)) continue;
184
177
 
185
178
  const overlap = scopesOverlap(candidate, current);
@@ -1,33 +1,2 @@
1
1
  /** Immutable access-policy value captured by a Work contract. */
2
2
  export type WorkAccessMode = 'request' | 'full_access';
3
-
4
- export type WorkRouteExecutionMode = 'direct_control' | 'goal_workloop' | 'handoff_only';
5
- export type WorkRouteMode = 'direct_edit' | 'bounded_work' | 'quick_agent' | 'issue_task';
6
- export type WorkRouteExecutionPath = 'fast' | 'durable';
7
- export type WorkRouteExecutorKind = 'direct_edit' | 'local_cli' | 'remote_api' | 'cloud_agent' | 'external_controller' | 'handoff_only';
8
- export type WorkRouteApprovalState = 'approval_not_required' | 'normal_authorization_required' | 'strong_confirmation_required' | 'blocked_by_policy';
9
-
10
- export interface WorkRouteReason {
11
- code: string;
12
- message: string;
13
- }
14
-
15
- /** Persistence-safe snapshot of a routing decision. The routing engine remains outside Kernel. */
16
- export interface WorkRouteDecisionSnapshot {
17
- executionMode: WorkRouteExecutionMode;
18
- executorKind: WorkRouteExecutorKind;
19
- selectedProviderId: string | null;
20
- workMode: WorkRouteMode;
21
- executionPath: WorkRouteExecutionPath;
22
- requiresWork: boolean;
23
- requiresApproval: boolean;
24
- requiresIsolation: boolean;
25
- requiresRecovery: boolean;
26
- createHandoff: boolean;
27
- waitForUser: boolean;
28
- approvalState: WorkRouteApprovalState;
29
- alternatives: string[];
30
- reasons: WorkRouteReason[];
31
- inputFingerprint: string;
32
- policyVersion: string;
33
- }