@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
@@ -1,150 +0,0 @@
1
- #!/usr/bin/env bash
2
- set -euo pipefail
3
-
4
- ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
5
- cd "$ROOT"
6
-
7
- PACKAGE_VERSION="$(node -e 'const fs=require("node:fs"); const pkg=JSON.parse(fs.readFileSync("package.json","utf8")); console.log(pkg.version)')"
8
- TMP_DIR="$(mktemp -d)"
9
- trap 'rm -rf "$TMP_DIR"' EXIT
10
-
11
- CLEAN_HOME="$TMP_DIR/home"
12
- CONTROLLER_HOME="$TMP_DIR/controller-home"
13
- XDG_STATE_HOME_DIR="$TMP_DIR/xdg-state"
14
- NPM_CACHE_DIR="$TMP_DIR/npm-cache"
15
- mkdir -p "$CLEAN_HOME" "$XDG_STATE_HOME_DIR" "$NPM_CACHE_DIR"
16
- export HOME="$CLEAN_HOME"
17
- export FORGE_CONTROLLER_HOME="$CONTROLLER_HOME"
18
- export XDG_STATE_HOME="$XDG_STATE_HOME_DIR"
19
- export npm_config_cache="$NPM_CACHE_DIR"
20
- unset BUN_INSTALL
21
- # The hosting immutable Runtime may be older than the package under test. Its
22
- # build identity must not override the installed tarball's package version.
23
- unset FORGE_BUILD_VERSION
24
-
25
- if [[ -e "$FORGE_CONTROLLER_HOME" ]]; then
26
- echo "[tarball-smoke] ERROR: isolated Controller Home must start empty: $FORGE_CONTROLLER_HOME" >&2
27
- exit 1
28
- fi
29
-
30
- if [[ "$#" -gt 0 ]]; then
31
- TARBALL_PATH="$(cd "$(dirname "$1")" && pwd)/$(basename "$1")"
32
- if [[ ! -f "$TARBALL_PATH" ]]; then
33
- echo "[tarball-smoke] ERROR: tarball not found: $TARBALL_PATH" >&2
34
- exit 1
35
- fi
36
- TARBALL="$(basename "$TARBALL_PATH")"
37
- else
38
- PACK_OUTPUT="$(npm pack --silent --pack-destination "$TMP_DIR")"
39
- TARBALL="$(printf '%s\n' "$PACK_OUTPUT" | awk '/\.tgz$/ { name=$0 } END { print name }')"
40
- if [[ -z "$TARBALL" ]]; then
41
- echo "[tarball-smoke] ERROR: npm pack did not report a tarball filename" >&2
42
- printf '%s\n' "$PACK_OUTPUT" >&2
43
- exit 1
44
- fi
45
- TARBALL_PATH="$TMP_DIR/$TARBALL"
46
- fi
47
- APP_DIR="$TMP_DIR/app"
48
- TARGET_REPO="$TMP_DIR/target-repo"
49
-
50
- mkdir -p "$APP_DIR" "$TARGET_REPO"
51
- git -C "$TARGET_REPO" init -q
52
-
53
- cd "$APP_DIR"
54
- printf '{"private":true,"name":"forge-tarball-smoke","version":"0.0.0"}
55
- ' > package.json
56
- npm install "$TARBALL_PATH" --omit=optional --ignore-scripts --no-audit --no-fund >/dev/null
57
-
58
- CLI="$APP_DIR/node_modules/.bin/forge"
59
- HOOK="$APP_DIR/node_modules/.bin/forge-hook"
60
-
61
- VERSION="$("$CLI" --version)"
62
- if [[ "$VERSION" != "$PACKAGE_VERSION" ]]; then
63
- echo "[tarball-smoke] ERROR: forge --version returned $VERSION, expected $PACKAGE_VERSION" >&2
64
- exit 1
65
- fi
66
-
67
- (cd "$TARGET_REPO" && "$CLI" status --json >"$TMP_DIR/status.json")
68
- "$CLI" adopt --repo "$TARGET_REPO" --dry-run --json >"$TMP_DIR/adopt-plan.json"
69
- node - "$TMP_DIR/adopt-plan.json" <<'JS_EOF'
70
- const fs = require('node:fs');
71
- const path = process.argv[2];
72
- const plan = JSON.parse(fs.readFileSync(path, 'utf8'));
73
- if (plan.protocol !== 1 || plan.command !== "adopt" || plan.apply !== false) {
74
- console.error("[tarball-smoke] ERROR: packaged adopt dry-run did not return protocol v1 plan JSON");
75
- process.exit(1);
76
- }
77
- JS_EOF
78
-
79
- if ! "$CLI" run check-task-workflow --help >/dev/null; then
80
- echo "[tarball-smoke] ERROR: packaged 'forge run check-task-workflow --help' failed (run dispatcher / helper lookup / bin startup broken)" >&2
81
- exit 1
82
- fi
83
- printf '{"prompt":"review release readiness"}\n' | "$HOOK" prompt-guard-decide >/dev/null
84
-
85
- SETUP_OUTPUT="$TMP_DIR/setup-open.txt"
86
- "$CLI" setup open --controller mcp --tunnel none --capability computer.observe.v1 --json >"$SETUP_OUTPUT"
87
- for marker in \
88
- "forge setup: open" \
89
- "Primary controller: mcp" \
90
- "Install the user-level Forge Runtime" \
91
- "forge runtime service install-package --controller-home"; do
92
- if ! grep -Fq "$marker" "$SETUP_OUTPUT"; then
93
- echo "[tarball-smoke] ERROR: packaged setup did not expose expected bootstrap marker: $marker" >&2
94
- cat "$SETUP_OUTPUT" >&2
95
- exit 1
96
- fi
97
- done
98
-
99
- case "$(uname -s)" in
100
- Darwin)
101
- if ! grep -Eq 'Platform: macos/[^;]+; service=launchd' "$SETUP_OUTPUT"; then
102
- echo "[tarball-smoke] ERROR: macOS packaged bootstrap did not select launchd" >&2
103
- cat "$SETUP_OUTPUT" >&2
104
- exit 1
105
- fi
106
- ;;
107
- Linux)
108
- if ! grep -Eq 'Platform: (linux|wsl2)/[^;]+; service=(systemd-user|portable)' "$SETUP_OUTPUT"; then
109
- echo "[tarball-smoke] ERROR: Linux packaged bootstrap did not select systemd-user or the explicit portable fallback" >&2
110
- cat "$SETUP_OUTPUT" >&2
111
- exit 1
112
- fi
113
- ;;
114
- esac
115
-
116
- COMPUTER_STATUS="$TMP_DIR/computer-status.json"
117
- "$CLI" computer status --controller-home "$FORGE_CONTROLLER_HOME" --json >"$COMPUTER_STATUS"
118
- node - "$COMPUTER_STATUS" <<'JS_EOF'
119
- const fs = require('node:fs');
120
- const path = process.argv[2];
121
- const status = JSON.parse(fs.readFileSync(path, 'utf8'));
122
- if (status.schemaVersion !== 1 || status.product !== 'computer' || !Array.isArray(status.capabilities)) {
123
- console.error('[tarball-smoke] ERROR: packaged Computer status did not expose the capability-level contract');
124
- process.exit(1);
125
- }
126
- if (status.ready !== true) {
127
- const blockers = status.capabilities.filter((entry) => entry.ready !== true);
128
- if (blockers.length === 0 || blockers.some((entry) => typeof entry.reason !== 'string' || entry.reason.trim().length === 0)) {
129
- console.error('[tarball-smoke] ERROR: non-ready Computer status lacked a precise capability blocker');
130
- process.exit(1);
131
- }
132
- }
133
- JS_EOF
134
-
135
- if [[ -d "$FORGE_CONTROLLER_HOME" ]] && grep -RIlF "$ROOT" "$FORGE_CONTROLLER_HOME" 2>/dev/null | grep -q .; then
136
- echo "[tarball-smoke] ERROR: packaged Controller state captured the Forge source checkout path" >&2
137
- exit 1
138
- fi
139
-
140
- CLI_REALPATH="$(node -e 'const fs=require("node:fs"); console.log(fs.realpathSync(process.argv[1]))' "$CLI")"
141
- APP_REALPATH="$(node -e 'const fs=require("node:fs"); console.log(fs.realpathSync(process.argv[1]))' "$APP_DIR")"
142
- case "$CLI_REALPATH" in
143
- "$APP_REALPATH"/*) ;;
144
- *)
145
- echo "[tarball-smoke] ERROR: packaged forge executable resolved outside isolated install: $CLI_REALPATH" >&2
146
- exit 1
147
- ;;
148
- esac
149
-
150
- echo "[tarball-smoke] OK: ${TARBALL} installs under isolated HOME/Controller Home and packaged CLI bins start without Bun."
@@ -1,147 +0,0 @@
1
- #!/usr/bin/env bash
2
- set -euo pipefail
3
-
4
- ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
5
- cd "$ROOT"
6
-
7
- usage() {
8
- cat <<'EOF'
9
- Usage: scripts/package-source-archive.sh [output.zip]
10
-
11
- Build a portable source archive from the current working tree.
12
- The archive excludes rebuildable dependencies, Git metadata, and machine-local runtime state.
13
- EOF
14
- }
15
-
16
- fail() {
17
- echo "source-archive: $*" >&2
18
- exit 1
19
- }
20
-
21
- normalize_path() {
22
- local value="${1#./}"
23
- printf '%s\n' "${value%/}"
24
- }
25
-
26
- is_allowed_ai_path() {
27
- case "$1" in
28
- .ai/context/*) return 0 ;;
29
- .ai/hooks/*) return 0 ;;
30
- .ai/harness/brain-manifest.json) return 0 ;;
31
- .ai/harness/policy.json) return 0 ;;
32
- .ai/harness/workflow-contract.json) return 0 ;;
33
- .ai/harness/*/.gitkeep) return 0 ;;
34
- .ai/harness/*/*/.gitkeep) return 0 ;;
35
- *) return 1 ;;
36
- esac
37
- }
38
-
39
- should_include() {
40
- local path
41
- path="$(normalize_path "$1")"
42
- [[ -n "$path" ]] || return 1
43
-
44
- case "$path" in
45
- node_modules|node_modules/*) return 1 ;;
46
- .git|.git/*) return 1 ;;
47
- .codegraph|.codegraph/*) return 1 ;;
48
- _ops|_ops/*) return 1 ;;
49
- coverage|coverage/*) return 1 ;;
50
- artifacts|artifacts/*) return 1 ;;
51
- autoresearch|autoresearch/*) return 1 ;;
52
- .DS_Store|*/.DS_Store) return 1 ;;
53
- *.log|*.tgz|*.tar.gz|*.zip) return 1 ;;
54
- SOURCE_ARCHIVE_MANIFEST.sha256) return 1 ;;
55
- .ai|.ai/*)
56
- is_allowed_ai_path "$path"
57
- return
58
- ;;
59
- *)
60
- return 0
61
- ;;
62
- esac
63
- }
64
-
65
- copy_path() {
66
- local rel="$1"
67
- local source="$ROOT/$rel"
68
- local target="$STAGE_ROOT/$rel"
69
-
70
- if [[ -L "$source" ]]; then
71
- fail "symlink is not allowed in source archive: $rel"
72
- fi
73
- if [[ -d "$source" ]]; then
74
- return 0
75
- fi
76
- if [[ ! -f "$source" ]]; then
77
- fail "missing source file: $rel"
78
- fi
79
-
80
- mkdir -p "$(dirname "$target")"
81
- cp "$source" "$target"
82
- }
83
-
84
- build_manifest() {
85
- local manifest="$STAGE_ROOT/SOURCE_ARCHIVE_MANIFEST.sha256"
86
- : >"$manifest"
87
- while IFS= read -r rel; do
88
- [[ -n "$rel" ]] || continue
89
- local file="${rel#./}"
90
- [[ "$file" == "SOURCE_ARCHIVE_MANIFEST.sha256" ]] && continue
91
- shasum -a 256 "$file"
92
- done < <(
93
- cd "$STAGE_ROOT"
94
- find . -type f | LC_ALL=C sort
95
- ) >>"$manifest"
96
- }
97
-
98
- if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
99
- usage
100
- exit 0
101
- fi
102
-
103
- if [[ $# -gt 1 ]]; then
104
- usage >&2
105
- exit 2
106
- fi
107
-
108
- TIMESTAMP="$(date '+%Y%m%d-%H%M%S')"
109
- ARCHIVE_STEM="forge-source-${TIMESTAMP}"
110
- OUTPUT="${1:-$ROOT/artifacts/source-archives/${ARCHIVE_STEM}.zip}"
111
- [[ "$OUTPUT" == *.zip ]] || OUTPUT="${OUTPUT}.zip"
112
- [[ "$OUTPUT" == /* ]] || OUTPUT="$ROOT/$OUTPUT"
113
-
114
- mkdir -p "$(dirname "$OUTPUT")"
115
- [[ ! -e "$OUTPUT" ]] || fail "output already exists: $OUTPUT"
116
-
117
- STAGE_PARENT="$(mktemp -d "${TMPDIR:-/tmp}/forge-source-archive.XXXXXX")"
118
- trap 'rm -rf "$STAGE_PARENT"' EXIT
119
- STAGE_ROOT="$STAGE_PARENT/$ARCHIVE_STEM"
120
- mkdir -p "$STAGE_ROOT"
121
-
122
- included_count=0
123
- while IFS= read -r -d '' rel; do
124
- rel="$(normalize_path "$rel")"
125
- should_include "$rel" || continue
126
- copy_path "$rel"
127
- included_count=$((included_count + 1))
128
- done < <(git ls-files --cached --others --exclude-standard -z)
129
-
130
- (( included_count > 0 )) || fail "no files selected for archive"
131
-
132
- build_manifest
133
-
134
- (
135
- cd "$STAGE_PARENT"
136
- zip -qr "$OUTPUT" "$ARCHIVE_STEM"
137
- )
138
-
139
- if unzip -Z -1 "$OUTPUT" | rg -q '(^|/)node_modules/'; then
140
- fail "archive unexpectedly contains node_modules"
141
- fi
142
- if unzip -Z -1 "$OUTPUT" | rg -q '(^|/)\.git/'; then
143
- fail "archive unexpectedly contains .git"
144
- fi
145
-
146
- echo "source archive ready: $OUTPUT"
147
- echo "included files: $included_count + SOURCE_ARCHIVE_MANIFEST.sha256"
@@ -1,39 +0,0 @@
1
- # Public release allowlist. Directory entries are recursive.
2
- .gitignore
3
- .npmignore
4
- .github/
5
- .agents/
6
- AGENTS.md
7
- CLAUDE.md
8
- LICENSE
9
- CHANGELOG.md
10
- CONTRIBUTING.md
11
- SECURITY.md
12
- SUPPORT.md
13
- CODE_OF_CONDUCT.md
14
- NOTICE
15
- THIRD_PARTY_NOTICES.md
16
- README.md
17
- README.en.md
18
- README.zh-CN.md
19
- README.ja.md
20
- README.es.md
21
- README.fr.md
22
- SKILL.md
23
- agents/
24
- assets/
25
- bun.lock
26
- install.ps1
27
- install.sh
28
- package.json
29
- package-lock.json
30
- docs/README.md
31
- docs/tutorials/
32
- docs/operations/releasing.md
33
- docs/operations/releasing.zh-CN.md
34
- docs/operations/github-repository.md
35
- docs/operations/homebrew.md
36
- docs/wiki/
37
- scripts/
38
- src/
39
- tsconfig.json
@@ -1,174 +0,0 @@
1
- #!/usr/bin/env bun
2
- import { spawnSync } from "node:child_process";
3
- import {
4
- copyFileSync,
5
- existsSync,
6
- lstatSync,
7
- mkdirSync,
8
- mkdtempSync,
9
- readFileSync,
10
- readdirSync,
11
- realpathSync,
12
- } from "node:fs";
13
- import { tmpdir } from "node:os";
14
- import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
15
- import { fileURLToPath } from "node:url";
16
-
17
- const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
18
- const manifest = process.env.FORGE_PUBLIC_MANIFEST
19
- ? resolve(process.env.FORGE_PUBLIC_MANIFEST)
20
- : join(root, "scripts/public-release-files.txt");
21
-
22
- function fail(message: string): never {
23
- throw new Error(`public export: ${message}`);
24
- }
25
-
26
- function inside(base: string, candidate: string): boolean {
27
- const value = relative(base, candidate);
28
- return value === "" || (!value.startsWith(`..${sep}`) && value !== ".." && !isAbsolute(value));
29
- }
30
-
31
- function normalized(path: string): string {
32
- return path.replaceAll("\\", "/").replace(/^\.\//, "");
33
- }
34
-
35
- function forbidden(path: string): boolean {
36
- const value = normalized(path);
37
- const roots = [
38
- ".git",
39
- ".ai",
40
- ".claude",
41
- ".codex",
42
- ".forge",
43
- "tasks",
44
- "coverage",
45
- "artifacts",
46
- "autoresearch",
47
- "docs/researches",
48
- ];
49
- return (
50
- roots.some((entry) => value === entry || value.startsWith(`${entry}/`)) ||
51
- /^docs\/forge-.*-file-manifest\.sha256$/.test(value) ||
52
- /\.(?:log|tgz|tar\.gz|pem|key)$/.test(value)
53
- );
54
- }
55
-
56
- function manifestEntries(): string[] {
57
- if (!existsSync(manifest)) fail(`manifest not found: ${manifest}`);
58
- return readFileSync(manifest, "utf-8")
59
- .split("\n")
60
- .map((line) => line.replace(/#.*$/, "").trim())
61
- .filter(Boolean)
62
- .map((entry) => {
63
- if (isAbsolute(entry)) fail(`absolute manifest entry is forbidden: ${entry}`);
64
- if (entry.split("/").includes("..")) fail(`parent traversal is forbidden: ${entry}`);
65
- return entry;
66
- });
67
- }
68
-
69
- function selectedFiles(): string[] {
70
- const files = new Set<string>();
71
- for (const entry of manifestEntries()) {
72
- const result = spawnSync(
73
- "git",
74
- ["ls-files", "--cached", "--others", "--exclude-standard", "--", entry],
75
- { cwd: root, encoding: "utf-8" },
76
- );
77
- if (result.status !== 0) fail(`git ls-files failed for ${entry}: ${result.stderr.trim()}`);
78
- const directoryEntry = entry.endsWith("/");
79
- for (const line of result.stdout.split("\n")) {
80
- const file = normalized(line.trim());
81
- if (!file) continue;
82
- if (!existsSync(join(root, file))) {
83
- if (directoryEntry) continue;
84
- fail(`selected file disappeared: ${file}`);
85
- }
86
- files.add(file);
87
- }
88
- }
89
- const result = [...files].sort();
90
- if (result.length === 0) fail("manifest selected no files");
91
- return result;
92
- }
93
-
94
- function copyFiles(output: string, files: string[]): void {
95
- for (const file of files) {
96
- if (forbidden(file)) fail(`forbidden file selected: ${file}`);
97
- const source = join(root, file);
98
- if (!existsSync(source)) fail(`selected file disappeared: ${file}`);
99
- const stat = lstatSync(source);
100
- if (stat.isDirectory()) continue;
101
- if (stat.isSymbolicLink()) {
102
- const target = realpathSync(source);
103
- if (!inside(root, target)) fail(`symlink escapes repository: ${file} -> ${target}`);
104
- } else if (!stat.isFile()) {
105
- fail(`unsupported file type selected: ${file}`);
106
- }
107
- const target = join(output, file);
108
- mkdirSync(dirname(target), { recursive: true });
109
- copyFileSync(source, target);
110
- }
111
- }
112
-
113
- function walk(directory: string): string[] {
114
- const result: string[] = [];
115
- for (const entry of readdirSync(directory, { withFileTypes: true })) {
116
- const path = join(directory, entry.name);
117
- if (entry.isDirectory()) result.push(...walk(path));
118
- else if (entry.isFile()) result.push(path);
119
- else fail(`non-regular file in export: ${path}`);
120
- }
121
- return result;
122
- }
123
-
124
- function scan(output: string): void {
125
- for (const required of ["LICENSE", "NOTICE", "THIRD_PARTY_NOTICES.md", "package.json", "package-lock.json", "README.md", "README.en.md", "src", "scripts"]) {
126
- if (!existsSync(join(output, required))) fail(`required public file missing: ${required}`);
127
- }
128
- for (const blocked of [".git", ".ai", ".claude", ".codex", ".forge", "tasks", "coverage", "artifacts", "autoresearch"]) {
129
- if (existsSync(join(output, blocked))) fail(`runtime/internal path leaked: ${blocked}`);
130
- }
131
-
132
- const ignoredScanners = new Set([
133
- "scripts/public-release.ts",
134
- "scripts/check-public-export.sh",
135
- "scripts/check-open-source-tracked-surface.sh",
136
- ]);
137
- const patterns: Array<[string, RegExp]> = [
138
- ["macOS personal path detected", /(?<![A-Za-z0-9._-])\/Users\/[^/\s"'`]+/],
139
- ["Linux personal path detected", /(?<![A-Za-z0-9._-])\/home\/[^/\s"'`]+/],
140
- ["private key detected", /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/],
141
- ["AWS access key detected", /AKIA[0-9A-Z]{16}/],
142
- ["GitHub token detected", /gh[pousr]_[A-Za-z0-9_]{20,}/],
143
- ["OpenAI-style secret detected", /(?<![A-Za-z0-9])sk-[A-Za-z0-9_-]{20,}/],
144
- ["real repository binding detected", /repo_[0-9a-f]{24,}/],
145
- ["real checkout binding detected", /checkout_[0-9a-f]{16,}/],
146
- ];
147
-
148
- for (const path of walk(output)) {
149
- const rel = normalized(relative(output, path));
150
- if (forbidden(rel)) fail(`runtime, key, or package snapshot file detected: ${rel}`);
151
- if (ignoredScanners.has(rel) || basename(rel).endsWith(".svg")) continue;
152
- const bytes = readFileSync(path);
153
- if (bytes.includes(0)) continue;
154
- const text = bytes.toString("utf-8");
155
- for (const [label, pattern] of patterns) {
156
- if (pattern.test(text)) fail(`${label}: ${rel}`);
157
- }
158
- }
159
- }
160
-
161
- const requestedOutput = process.argv[2];
162
- const output = requestedOutput
163
- ? resolve(requestedOutput)
164
- : mkdtempSync(join(tmpdir(), "forge-public-"));
165
- if (requestedOutput) {
166
- if (existsSync(output)) fail(`output already exists: ${output}`);
167
- mkdirSync(output, { recursive: true });
168
- }
169
- if (output === root || inside(output, root)) fail("output must not replace or contain the source repository");
170
-
171
- const files = selectedFiles();
172
- copyFiles(output, files);
173
- scan(output);
174
- console.log(`public export ready: ${output} (${files.length} files)`);
@@ -1,27 +0,0 @@
1
- #!/usr/bin/env bash
2
- set -euo pipefail
3
-
4
- ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
5
- cd "$ROOT"
6
-
7
- CHANNEL="${1:-latest}"
8
- NPM_RELEASE_REGISTRY="${NPM_RELEASE_REGISTRY:-https://registry.npmjs.org/}"
9
- if [[ "$CHANNEL" != "latest" && "$CHANNEL" != "next" ]]; then
10
- echo "usage: $0 latest|next" >&2
11
- exit 2
12
- fi
13
-
14
- node scripts/check-release-version.mjs --channel "$CHANNEL" --require-tag
15
- bash scripts/check-npm-release.sh
16
- TARBALL_PATH="$(cat .ai/harness/artifacts/release/latest-tarball.txt)"
17
- if [[ ! -f "$TARBALL_PATH" ]]; then
18
- echo "[release] reusable tarball missing: $TARBALL_PATH" >&2
19
- exit 1
20
- fi
21
- echo "[release] publish registry: ${NPM_RELEASE_REGISTRY}"
22
- if [[ "${NPM_RELEASE_BOOTSTRAP:-0}" == "1" ]]; then
23
- echo "[release] bootstrap publication: disabling provenance for this one-time local publish"
24
- npm publish "$TARBALL_PATH" --tag "$CHANNEL" --access public --registry "$NPM_RELEASE_REGISTRY" --provenance=false
25
- else
26
- npm publish "$TARBALL_PATH" --tag "$CHANNEL" --access public --registry "$NPM_RELEASE_REGISTRY"
27
- fi