@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,223 @@
1
+ import { strict as assert } from 'node:assert';
2
+ import { mkdtempSync, rmSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { createHash } from 'node:crypto';
6
+ import { createMcpHttpSessionRegistry } from '../adapters/mcp/transports/http';
7
+ import { authenticatedFacadeControllerIdentity } from '../adapters/mcp/runtime-gateway/controller-authority-adapter';
8
+ import { readExecutionSession, startExecutionSession } from '../src/runtime/control-plane/execution/session-store';
9
+ import {
10
+ bindControllerSessionBinding,
11
+ claimControllerSession,
12
+ getControllerRoundRelay,
13
+ releaseControllerSession,
14
+ type ControllerHost,
15
+ } from '../packages/kernel/controller/api/index';
16
+ import { createWorkContract } from '../packages/kernel/work/api/index';
17
+ import { upsertProcessControllerBinding } from '../adapters/controller-process/binding-store';
18
+ import { runSchedulerAutonomousContinuationReconciliation } from '../src/runtime/control-plane/global-scheduler/autonomous-continuation';
19
+ import { WorkflowSupervisorControlPlane } from '../supervisor/control-plane';
20
+ import { SUPERVISOR_BLOCK_END, SUPERVISOR_BLOCK_START } from '../supervisor/protocol';
21
+ import { WorkflowSupervisorStore } from '../supervisor/store';
22
+
23
+ const root = mkdtempSync(join(tmpdir(), 'forge-unattended-transport-recovery-'));
24
+ const controllerHome = join(root, 'controller');
25
+ const repoId = 'repo-unattended-recovery';
26
+ const workId = 'work-unattended-recovery';
27
+ const oldTransportSessionId = 'mcp-transport-old';
28
+ const newTransportSessionId = 'mcp-transport-new';
29
+ const principalId = 'chatgpt-controller';
30
+
31
+ const validators = {
32
+ completionContract: async () => ({ valid: true, reason: 'ok' }),
33
+ userBlockerPolicy: async () => ({ valid: true, reason: 'ok' }),
34
+ };
35
+ const supervisor = () => new WorkflowSupervisorControlPlane(new WorkflowSupervisorStore(controllerHome), validators);
36
+
37
+ function block(action: 'CONTINUE' | 'DONE', effectId: string, checkpoint: string, conversationId: string, taskId: string): string {
38
+ return `${SUPERVISOR_BLOCK_START}\n${JSON.stringify({
39
+ action,
40
+ source_effect_id: effectId,
41
+ checkpoint,
42
+ reason: action === 'DONE' ? 'complete' : 'continue',
43
+ evidence: ['unattended-transport-recovery-smoke'],
44
+ conversation_id: conversationId,
45
+ task_id: taskId,
46
+ supervisor_state: action === 'DONE' ? 'done' : 'running',
47
+ active_scope: `goal:${taskId}`,
48
+ })}\n${SUPERVISOR_BLOCK_END}`;
49
+ }
50
+
51
+ try {
52
+ // 1) Durable execution is created independently of an MCP stream.
53
+ startExecutionSession(controllerHome, {
54
+ sessionId: oldTransportSessionId,
55
+ principalId,
56
+ controllerInstanceId: 'runtime-before-restart',
57
+ });
58
+
59
+ let transportCloseCount = 0;
60
+ const registry = createMcpHttpSessionRegistry<
61
+ { close(): void },
62
+ { sessionId: string; controllerHome: string }
63
+ >();
64
+ registry.register({
65
+ sessionId: oldTransportSessionId,
66
+ transport: { close: () => { transportCloseCount += 1; } },
67
+ toolContext: { sessionId: oldTransportSessionId, controllerHome },
68
+ route: '/mcp',
69
+ principalId,
70
+ connectionId: 'connection-before-disconnect',
71
+ clientIdentity: 'chatgpt-client',
72
+ });
73
+ await registry.close(oldTransportSessionId, 'transport_close');
74
+ assert.equal(transportCloseCount, 1);
75
+
76
+ // 2) Transport loss must not invalidate execution authority. Reading through a
77
+ // new runtime instance also exercises restart recovery of the durable session.
78
+ const recoveredExecution = readExecutionSession(controllerHome, {
79
+ sessionId: oldTransportSessionId,
80
+ principalId,
81
+ controllerInstanceId: 'runtime-after-restart',
82
+ });
83
+ assert.ok(recoveredExecution);
84
+ assert.equal(recoveredExecution.controllerInstanceId, 'runtime-after-restart');
85
+ assert.equal(recoveredExecution.invalidatedAt, undefined);
86
+
87
+ // 3) A newly authenticated transport can explicitly carry the prior session
88
+ // only on the bounded rollover path. The new transport remains the request
89
+ // binding; the old session is merely the compatibility authority carrier.
90
+ const rolloverIdentity = authenticatedFacadeControllerIdentity({
91
+ principalId,
92
+ sessionId: newTransportSessionId,
93
+ controllerInstanceId: 'runtime-after-restart',
94
+ controllerType: 'chatgpt',
95
+ } as any, {
96
+ session_id: oldTransportSessionId,
97
+ }, { allowTransportSessionRollover: true });
98
+ assert.equal(rolloverIdentity.sessionId, newTransportSessionId);
99
+ assert.equal(rolloverIdentity.transportSessionId, newTransportSessionId);
100
+ assert.equal(rolloverIdentity.controllerAuthorityId, oldTransportSessionId);
101
+ assert.equal(rolloverIdentity.authorityViaSessionCompatibility, true);
102
+
103
+ // 4) Scheduler liveness owns unattended Work wake-up. Repeated reconciliation
104
+ // of the same durable state must never duplicate provider dispatch.
105
+ createWorkContract({ controllerHome, repoId }, {
106
+ workId,
107
+ repoId,
108
+ objective: 'Continue without manual user wake-ups.',
109
+ acceptanceCriteria: ['The Work resumes from durable authority.'],
110
+ allowedPaths: [],
111
+ forbiddenPaths: [],
112
+ checks: [],
113
+ constraints: {},
114
+ requestedBy: 'chatgpt',
115
+ dispatchState: 'running',
116
+ baseRevision: 'abc123',
117
+ } as Parameters<typeof createWorkContract>[1]);
118
+
119
+ const store = { controllerHome, repoId };
120
+ const controllerAuthorityId = oldTransportSessionId;
121
+ const owner = claimControllerSession(store, {
122
+ workId,
123
+ controllerId: principalId,
124
+ // This section proves the generic retained-provider wake path. ChatGPT is
125
+ // intentionally covered by the Workflow Supervisor section below and must
126
+ // not silently fall back to direct provider dispatch when its daemon is down.
127
+ controllerType: 'claude',
128
+ sessionId: oldTransportSessionId,
129
+ authorityDigest: createHash('sha256').update(controllerAuthorityId).digest('hex'),
130
+ principalId,
131
+ controllerInstanceId: 'runtime-before-restart',
132
+ leaseMs: 60_000,
133
+ });
134
+ const binding = upsertProcessControllerBinding(store, {
135
+ workId,
136
+ sessionId: owner.sessionId,
137
+ controllerType: 'claude',
138
+ executable: 'claude',
139
+ launchArgs: [],
140
+ });
141
+ bindControllerSessionBinding(store, { workId, sessionId: owner.sessionId, binding: binding.binding });
142
+ releaseControllerSession(store, workId, owner.controllerId);
143
+
144
+ let providerDispatches = 0;
145
+ const host: ControllerHost = {
146
+ resume: async () => {
147
+ providerDispatches += 1;
148
+ return { accepted: true, dispatchId: `dispatch-${providerDispatches}` };
149
+ },
150
+ };
151
+ const schedulerInput = {
152
+ controllerHome,
153
+ nowMs: Date.parse('2026-09-22T12:00:00.000Z'),
154
+ repositories: [{ repoId, canonicalRoot: root, localRoot: root }],
155
+ dependencies: {
156
+ authorizeWake: () => undefined,
157
+ boundaryForWork: () => ({ status: 'not_eligible' as const }),
158
+ hostForBinding: () => host,
159
+ },
160
+ };
161
+ const firstWake = await runSchedulerAutonomousContinuationReconciliation(schedulerInput);
162
+ assert.equal(firstWake.dispatched, 1);
163
+ const duplicateWake = await runSchedulerAutonomousContinuationReconciliation(schedulerInput);
164
+ assert.equal(duplicateWake.dispatched, 0);
165
+ assert.equal(providerDispatches, 1);
166
+ assert.equal(getControllerRoundRelay(store, workId)?.status, 'dispatched');
167
+
168
+ // 5) Workflow Supervisor state is durable across process/control-plane
169
+ // reconstruction. Ten CONTINUE rounds publish exactly one successor each, and
170
+ // replaying the same completion never creates a second effect.
171
+ const taskId = 'unattended-transport-recovery-task';
172
+ const conversationId = '77777777-8888-9999-aaaa-bbbbbbbbbbbb';
173
+ const conversationUrl = `https://chatgpt.com/c/${conversationId}`;
174
+ let control = supervisor();
175
+ control.registerTask({
176
+ taskId,
177
+ conversationId,
178
+ conversationUrl,
179
+ objective: 'Continue autonomously across reconnects and runtime restarts.',
180
+ completionContract: {},
181
+ continuationPolicy: { active_scope: `goal:${taskId}` },
182
+ userBlockerPolicy: {},
183
+ });
184
+ let effect = control.reserveEnrollment(taskId);
185
+ control.observeEffect({ effectId: effect.effectId, observationId: 'round-0-applied', outcome: 'applied' });
186
+
187
+ for (let round = 1; round <= 10; round += 1) {
188
+ control = supervisor();
189
+ const response = block('CONTINUE', effect.effectId, `checkpoint-${round}`, conversationId, taskId);
190
+ const advanced = await control.browserObserveAssistant({ conversationId, conversationUrl, responseText: response });
191
+ assert.ok(advanced.successorEffect);
192
+ const replay = await control.browserObserveAssistant({ conversationId, conversationUrl, responseText: response });
193
+ assert.equal(replay.successorEffect?.effectId, advanced.successorEffect.effectId);
194
+ assert.equal(replay.deduplicated, true);
195
+ effect = advanced.successorEffect;
196
+ control.observeEffect({
197
+ effectId: effect.effectId,
198
+ observationId: `round-${round}-applied`,
199
+ outcome: 'applied',
200
+ });
201
+ }
202
+
203
+ control = supervisor();
204
+ const done = await control.browserObserveAssistant({
205
+ conversationId,
206
+ conversationUrl,
207
+ responseText: block('DONE', effect.effectId, 'complete', conversationId, taskId),
208
+ });
209
+ assert.equal(done.terminal, true);
210
+ assert.equal(control.browserTasks().length, 0);
211
+
212
+ console.log(JSON.stringify({
213
+ status: 'ok',
214
+ transportDisconnectedWithoutExecutionInvalidation: true,
215
+ reconnectUsedExplicitRolloverAuthority: true,
216
+ runtimeRestartRecoveredExecution: true,
217
+ schedulerProviderDispatches: providerDispatches,
218
+ unattendedContinuationRounds: 10,
219
+ duplicateSuccessorEffects: 0,
220
+ }, null, 2));
221
+ } finally {
222
+ rmSync(root, { recursive: true, force: true });
223
+ }
@@ -0,0 +1,232 @@
1
+ #!/usr/bin/env bun
2
+ import { strict as assert } from 'node:assert';
3
+ import { execFileSync, spawnSync } from 'node:child_process';
4
+ import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
5
+ import { tmpdir } from 'node:os';
6
+ import { join } from 'node:path';
7
+ import { fileURLToPath } from 'node:url';
8
+ import { ensureControllerHome } from '../src/cli/repositories/controller-home';
9
+ import { registerRepository } from '../src/cli/repositories/registry';
10
+ import {
11
+ beginControllerRoundProviderDispatch,
12
+ beginInitialControllerRoundDispatch,
13
+ finishControllerRoundRelayDispatch,
14
+ getControllerRoundRelay,
15
+ } from '../packages/kernel/controller/api/index';
16
+ import { claimControllerSession, releaseControllerSession } from '../src/runtime/control-plane/facade/controller-session-store';
17
+ import { createWorkContract } from '../src/runtime/control-plane/facade/work-contract-store';
18
+ import { createHandoffItem } from '../src/runtime/control-plane/facade/handoff-inbox-store';
19
+ import { listUserRequests } from '../packages/kernel/identity/api/index';
20
+ import {
21
+ createWorkContinuationSchedule,
22
+ handoffResolvedContinuationEventName,
23
+ resolveHandoffAndTriggerContinuation,
24
+ } from '../src/runtime/workflow/schedules/work-continuation';
25
+ import { listOccurrences } from '../src/runtime/workflow/schedules/store';
26
+
27
+ const WORK_ID = 'WORK-USER-REQUEST-PROCESS-RESTART';
28
+ const HANDOFF_ID = 'HND-USER-REQUEST-PROCESS-RESTART';
29
+ const ORIGINAL_OCCURRENCE_ID = 'occ-user-request-original-lineage';
30
+ const META = 'user-request-continuation-meta.json';
31
+
32
+ interface Meta {
33
+ repoId: string;
34
+ scheduleId: string;
35
+ authorityId: string;
36
+ firstOccurrenceId?: string;
37
+ }
38
+
39
+ function arg(name: string): string | undefined {
40
+ const index = process.argv.indexOf(name);
41
+ return index >= 0 ? process.argv[index + 1] : undefined;
42
+ }
43
+
44
+ function metaPath(root: string): string {
45
+ return join(root, META);
46
+ }
47
+
48
+ function readMeta(root: string): Meta {
49
+ return JSON.parse(readFileSync(metaPath(root), 'utf8')) as Meta;
50
+ }
51
+
52
+ function writeMeta(root: string, meta: Meta): void {
53
+ writeFileSync(metaPath(root), JSON.stringify(meta, null, 2), 'utf8');
54
+ }
55
+
56
+ function initRepository(root: string): string {
57
+ const repoRoot = join(root, 'repo');
58
+ mkdirSync(repoRoot, { recursive: true });
59
+ execFileSync('git', ['init', '-q', '-b', 'main'], { cwd: repoRoot });
60
+ execFileSync('git', ['config', 'user.email', 'user-request-smoke@example.test'], { cwd: repoRoot });
61
+ execFileSync('git', ['config', 'user.name', 'UserRequest Smoke'], { cwd: repoRoot });
62
+ writeFileSync(join(repoRoot, 'README.md'), 'user request continuation smoke\n');
63
+ execFileSync('git', ['add', '.'], { cwd: repoRoot });
64
+ execFileSync('git', ['commit', '-qm', 'fixture'], { cwd: repoRoot });
65
+ return repoRoot;
66
+ }
67
+
68
+ async function runPhase(root: string, phase: string): Promise<void> {
69
+ const controllerHome = ensureControllerHome(join(root, 'controller'));
70
+
71
+ if (phase === 'setup') {
72
+ const repoRoot = initRepository(root);
73
+ const repository = registerRepository({ path: repoRoot, controllerHome, displayName: 'user-request-continuation-smoke' });
74
+ const store = { controllerHome, repoId: repository.repoId };
75
+ createWorkContract(store, {
76
+ workId: WORK_ID,
77
+ repoId: repository.repoId,
78
+ checkoutId: repository.activeCheckoutId,
79
+ objective: 'Resume the exact continuation lineage after one genuine UserRequest is resolved.',
80
+ acceptanceCriteria: ['One resolution rearms the same occurrence and replay creates no second occurrence.'],
81
+ allowedPaths: [],
82
+ forbiddenPaths: [],
83
+ checks: [],
84
+ constraints: { workspaceMode: 'current' },
85
+ requestedBy: 'chatgpt',
86
+ dispatchState: 'running',
87
+ });
88
+ const owner = claimControllerSession(store, {
89
+ workId: WORK_ID,
90
+ controllerId: 'user-request-smoke-controller',
91
+ controllerType: 'chatgpt',
92
+ sessionId: 'user-request-smoke-session',
93
+ principalId: 'user-request-smoke-controller',
94
+ controllerInstanceId: 'runtime-before-user-resolution',
95
+ leaseMs: 60_000,
96
+ });
97
+ const relay = beginInitialControllerRoundDispatch(store, {
98
+ workId: WORK_ID,
99
+ occurrenceId: ORIGINAL_OCCURRENCE_ID,
100
+ identity: {
101
+ controllerId: owner.controllerId,
102
+ controllerType: owner.controllerType,
103
+ principalId: owner.principalId!,
104
+ controllerInstanceId: owner.controllerInstanceId!,
105
+ sessionId: owner.sessionId,
106
+ },
107
+ });
108
+ const started = beginControllerRoundProviderDispatch(store, {
109
+ workId: WORK_ID,
110
+ authorityId: relay.authorityId!,
111
+ expectedUpdatedAt: relay.updatedAt,
112
+ });
113
+ const eventName = handoffResolvedContinuationEventName(HANDOFF_ID);
114
+ const schedule = createWorkContinuationSchedule(controllerHome, repository.repoId, {
115
+ workId: WORK_ID,
116
+ controllerType: 'chatgpt',
117
+ triggerType: 'repository-event',
118
+ eventName,
119
+ shadowMode: true,
120
+ cooldownMinutes: 0,
121
+ }).schedule;
122
+ createHandoffItem(store, {
123
+ id: HANDOFF_ID,
124
+ repoId: repository.repoId,
125
+ workId: WORK_ID,
126
+ title: 'Resolve one genuine user blocker',
127
+ severity: 'needs_review',
128
+ creationReason: 'missing_authorization',
129
+ reason: 'The provider requires a user-owned authorization step.',
130
+ summary: 'Resume the exact continuation after the user action.',
131
+ currentState: { repoId: repository.repoId, workId: WORK_ID, statusSummary: 'waiting for user authorization' },
132
+ attemptedActions: [],
133
+ evidenceRefs: [],
134
+ recommendedDecision: 'Resolve the authorization blocker.',
135
+ recommendedPrompt: 'Resolve the blocker and resume the exact continuation.',
136
+ suggestedNextActions: [],
137
+ });
138
+ finishControllerRoundRelayDispatch(store, {
139
+ workId: WORK_ID,
140
+ ok: false,
141
+ waitForUser: true,
142
+ handoffId: HANDOFF_ID,
143
+ providerDispatchEffectId: started.providerDispatchEffectId,
144
+ error: 'CHATGPT_AUTOMATION_LOGIN_REQUIRED',
145
+ });
146
+ releaseControllerSession(store, WORK_ID, owner.controllerId);
147
+ const waiting = getControllerRoundRelay(store, WORK_ID);
148
+ assert.equal(waiting?.status, 'waiting_for_user');
149
+ assert.equal(waiting?.occurrenceId, ORIGINAL_OCCURRENCE_ID);
150
+ assert.equal(waiting?.authorityId, relay.authorityId);
151
+ const requests = listUserRequests(controllerHome, 'pending');
152
+ assert.equal(requests.length, 1);
153
+ assert.equal(requests[0]?.presentation?.legacyHandoffId, HANDOFF_ID);
154
+ writeMeta(root, { repoId: repository.repoId, scheduleId: schedule.scheduleId, authorityId: relay.authorityId! });
155
+ return;
156
+ }
157
+
158
+ const meta = readMeta(root);
159
+ const store = { controllerHome, repoId: meta.repoId };
160
+
161
+ if (phase === 'resolve') {
162
+ const resolved = await resolveHandoffAndTriggerContinuation(controllerHome, meta.repoId, HANDOFF_ID, {
163
+ decision: 'authorization completed',
164
+ resolver: 'user-request-smoke-user',
165
+ });
166
+ assert.equal(resolved.item.status, 'resolved');
167
+ assert.equal(resolved.continuationOccurrences.length, 1);
168
+ assert.equal(resolved.continuationOccurrences[0]?.scheduleId, meta.scheduleId);
169
+ const relay = getControllerRoundRelay(store, WORK_ID);
170
+ assert.equal(relay?.status, 'dispatching');
171
+ assert.equal(relay?.occurrenceId, ORIGINAL_OCCURRENCE_ID);
172
+ assert.equal(relay?.authorityId, meta.authorityId);
173
+ const occurrences = listOccurrences(controllerHome, meta.repoId, meta.scheduleId);
174
+ assert.equal(occurrences.length, 1);
175
+ assert.equal(occurrences[0]?.triggerContext?.data?.controllerRoundOccurrenceId, ORIGINAL_OCCURRENCE_ID);
176
+ const requests = listUserRequests(controllerHome, 'resolved');
177
+ assert.equal(requests.length, 1);
178
+ assert.equal(requests[0]?.resolution?.decision, 'authorization completed');
179
+ writeMeta(root, { ...meta, firstOccurrenceId: occurrences[0]!.occurrenceId });
180
+ return;
181
+ }
182
+
183
+ if (phase === 'replay') {
184
+ assert.ok(meta.firstOccurrenceId);
185
+ const replay = await resolveHandoffAndTriggerContinuation(controllerHome, meta.repoId, HANDOFF_ID, {
186
+ decision: 'authorization completed',
187
+ resolver: 'user-request-smoke-user',
188
+ });
189
+ assert.equal(replay.item.status, 'resolved');
190
+ const relay = getControllerRoundRelay(store, WORK_ID);
191
+ assert.equal(relay?.status, 'dispatching');
192
+ assert.equal(relay?.occurrenceId, ORIGINAL_OCCURRENCE_ID);
193
+ assert.equal(relay?.authorityId, meta.authorityId);
194
+ const occurrences = listOccurrences(controllerHome, meta.repoId, meta.scheduleId);
195
+ assert.equal(occurrences.length, 1);
196
+ assert.equal(occurrences[0]?.occurrenceId, meta.firstOccurrenceId);
197
+ assert.equal(listUserRequests(controllerHome, 'resolved').length, 1);
198
+ return;
199
+ }
200
+
201
+ throw new Error(`UNKNOWN_PHASE:${phase}`);
202
+ }
203
+
204
+ async function main(): Promise<void> {
205
+ const phase = arg('--phase');
206
+ const rootArg = arg('--root');
207
+ if (phase) {
208
+ if (!rootArg) throw new Error('--root is required with --phase');
209
+ await runPhase(rootArg, phase);
210
+ return;
211
+ }
212
+ const root = mkdtempSync(join(tmpdir(), 'forge-user-request-continuation-restart-'));
213
+ const script = fileURLToPath(import.meta.url);
214
+ try {
215
+ for (const nextPhase of ['setup', 'resolve', 'replay']) {
216
+ const child = spawnSync(process.execPath, [script, '--phase', nextPhase, '--root', root], {
217
+ cwd: process.cwd(),
218
+ encoding: 'utf8',
219
+ stdio: ['ignore', 'pipe', 'pipe'],
220
+ });
221
+ assert.equal(child.status, 0, `phase ${nextPhase} failed\nstdout:\n${child.stdout ?? ''}\nstderr:\n${child.stderr ?? ''}`);
222
+ }
223
+ console.log('[user-request-continuation-process-restart-smoke] OK');
224
+ } finally {
225
+ if (existsSync(root)) rmSync(root, { recursive: true, force: true });
226
+ }
227
+ }
228
+
229
+ main().catch((error) => {
230
+ console.error(error instanceof Error ? error.stack ?? error.message : String(error));
231
+ process.exitCode = 1;
232
+ });
@@ -0,0 +1,92 @@
1
+ import { strict as assert } from 'node:assert';
2
+ import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join, resolve } from 'node:path';
5
+ import { WorkflowSupervisorControlPlane } from '../supervisor/control-plane';
6
+ import { SUPERVISOR_BLOCK_END, SUPERVISOR_BLOCK_START } from '../supervisor/protocol';
7
+ import { WORKFLOW_SUPERVISOR_MIN_TURN_INTERVAL_MS, WorkflowSupervisorStore } from '../supervisor/store';
8
+ import { NativeMessageDecoder, encodeNativeMessage } from '../supervisor/native-messaging/protocol';
9
+ import { renderWorkflowSupervisorNativeManifest } from '../supervisor/native-messaging/manifest';
10
+ import { ALLOWED_BROWSER_METHODS } from '../supervisor/native-messaging/host';
11
+ import { WorkflowSupervisorEphemeralDiscovery } from '../supervisor/server';
12
+
13
+ const home = mkdtempSync(join(tmpdir(), 'forge-supervisor-chrome-'));
14
+ try {
15
+ let mechanicalNowMs = Date.now();
16
+ const turnAdvanceMs = WORKFLOW_SUPERVISOR_MIN_TURN_INTERVAL_MS + 1_000;
17
+ const control = new WorkflowSupervisorControlPlane(new WorkflowSupervisorStore(home, { now: () => mechanicalNowMs }), { completionContract: async () => ({ valid: true, reason: 'ok' }), userBlockerPolicy: async () => ({ valid: true, reason: 'ok' }) });
18
+ const conversationId = 'WEB:11111111-2222-3333-4444-555555555555';
19
+ const conversationUrl = `https://chatgpt.com/c/${conversationId}`;
20
+ control.registerTask({ taskId: 'task-1', conversationId, conversationUrl, objective: 'Keep implementing the original Forge goal.', completionContract: {}, continuationPolicy: {}, userBlockerPolicy: {} });
21
+ const enrollment = control.reserveEnrollment('task-1');
22
+ assert.equal(control.browserTasks().length, 1);
23
+ let poll = control.browserPoll({ conversationId, conversationUrl });
24
+ assert.equal(poll.command?.mode, 'send'); assert.equal(poll.command?.effectId, enrollment.effectId);
25
+ assert.equal(control.browserBeginEffect({ conversationId, conversationUrl, effectId: enrollment.effectId, dispatchId: 'dispatch-1', dispatchGeneration: poll.command!.dispatchGeneration, evidence: { latest_user_text: '', latest_assistant_response: '' } }).started, true);
26
+ poll = control.browserPoll({ conversationId, conversationUrl }); assert.equal(poll.command?.mode, 'reconcile');
27
+ control.browserObserveEffect({ conversationId, conversationUrl, effectId: enrollment.effectId, observationId: 'observed-1', outcome: 'applied', evidence: { exact: true } });
28
+ const response = `Work remains.\n${SUPERVISOR_BLOCK_START}\n${JSON.stringify({ action: 'CONTINUE', source_effect_id: enrollment.effectId, checkpoint: 'step 4', reason: 'more work', evidence: ['receipt'], conversation_id: conversationId, task_id: 'task-1', supervisor_state: 'running', active_scope: 'goal:task-1' })}\n${SUPERVISOR_BLOCK_END}`;
29
+ const observed = await control.browserObserveAssistant({ conversationId, conversationUrl, responseText: response });
30
+ assert.equal(observed.action, 'CONTINUE'); assert.ok(observed.successorEffect);
31
+ mechanicalNowMs += turnAdvanceMs;
32
+ poll = control.browserPoll({ conversationId, conversationUrl }); assert.equal(poll.command?.effectId, observed.successorEffect?.effectId); assert.equal(poll.command?.mode, 'send');
33
+ const projectRoutePoll = control.browserPoll({ conversationId, conversationUrl: `https://chatgpt.com/g/not-the-same/c/${conversationId}` });
34
+ assert.equal(projectRoutePoll.command?.effectId, observed.successorEffect?.effectId);
35
+ assert.equal(projectRoutePoll.command?.mode, 'send');
36
+
37
+ const doneConversationId = 'aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee';
38
+ const doneConversationUrl = `https://chatgpt.com/c/${doneConversationId}`;
39
+ control.registerTask({ taskId: 'task-done', conversationId: doneConversationId, conversationUrl: doneConversationUrl, objective: 'Finish once.', completionContract: {}, continuationPolicy: {}, userBlockerPolicy: {} });
40
+ const doneEffect = control.reserveEnrollment('task-done');
41
+ const donePoll = control.browserPoll({ conversationId: doneConversationId, conversationUrl: doneConversationUrl });
42
+ control.browserBeginEffect({ conversationId: doneConversationId, conversationUrl: doneConversationUrl, effectId: doneEffect.effectId, dispatchId: 'dispatch-done', dispatchGeneration: donePoll.command!.dispatchGeneration, evidence: { latest_user_text: '', latest_assistant_response: '' } });
43
+ control.browserObserveEffect({ conversationId: doneConversationId, conversationUrl: doneConversationUrl, effectId: doneEffect.effectId, observationId: 'observed-done', outcome: 'applied' });
44
+ const doneResponse = `${SUPERVISOR_BLOCK_START}\n${JSON.stringify({ action: 'DONE', source_effect_id: doneEffect.effectId, checkpoint: 'done', reason: 'complete', evidence: ['receipt'], conversation_id: doneConversationId, task_id: 'task-done', supervisor_state: 'done', active_scope: 'goal:task-done' })}\n${SUPERVISOR_BLOCK_END}`;
45
+ assert.equal((await control.browserObserveAssistant({ conversationId: doneConversationId, conversationUrl: doneConversationUrl, responseText: doneResponse })).terminal, true);
46
+ assert.equal(control.browserTasks().some((task) => task.taskId === 'task-done'), false);
47
+
48
+ const decoder = new NativeMessageDecoder(); const framed = encodeNativeMessage({ id: 'a', method: 'health', params: {} });
49
+ assert.deepEqual(decoder.push(framed.subarray(0, 3)), []); assert.deepEqual(decoder.push(framed.subarray(3)), [{ id: 'a', method: 'health', params: {} }]);
50
+ const manifest = JSON.parse(renderWorkflowSupervisorNativeManifest({ executablePath: '/tmp/forge-workflow-supervisor-host', extensionId: 'a'.repeat(32) }));
51
+ assert.equal(manifest.allowed_origins[0], `chrome-extension://${'a'.repeat(32)}/`);
52
+
53
+ const discovery = new WorkflowSupervisorEphemeralDiscovery();
54
+ const discovered = discovery.update([
55
+ { conversation_id: conversationId, canonical_url: conversationUrl, title: ' Avela development ' },
56
+ { conversation_id: conversationId, canonical_url: conversationUrl, title: 'duplicate tab' },
57
+ { conversation_id: doneConversationId, canonical_url: doneConversationUrl },
58
+ ]);
59
+ assert.equal(discovered.conversations.length, 2);
60
+ assert.deepEqual(discovered.conversations[0], { conversationId, canonicalUrl: conversationUrl, title: 'Avela development' });
61
+ assert.equal(discovery.get().conversations[1]?.canonicalUrl, doneConversationUrl);
62
+ assert.equal(control.browserTasks().length, 1);
63
+ assert.equal(ALLOWED_BROWSER_METHODS.has('browser_discovery'), true);
64
+ assert.equal(ALLOWED_BROWSER_METHODS.has('browser_discovery_update'), true);
65
+ assert.equal(ALLOWED_BROWSER_METHODS.has('computer_extension_claim'), true);
66
+ assert.equal(ALLOWED_BROWSER_METHODS.has('browser_poll'), false);
67
+ assert.equal(ALLOWED_BROWSER_METHODS.has('browser_begin_effect'), false);
68
+ assert.throws(() => discovery.update([{ conversation_id: conversationId, canonical_url: 'https://example.com/c/not-chatgpt' }]), /CHATGPT_URL_INVALID/);
69
+
70
+ const coreSource = readFileSync(resolve('adapters/computer/chrome-extension/core.js'), 'utf8');
71
+ new Function(coreSource)();
72
+ const browserCore = (globalThis as unknown as { ForgeComputerChatgptCore: { parseConversation(value: string): { conversationId: string; canonicalUrl: string } | null } }).ForgeComputerChatgptCore;
73
+ assert.equal(browserCore.parseConversation(conversationUrl)?.conversationId, conversationId);
74
+ assert.equal(browserCore.parseConversation(`https://example.com/c/${conversationId}`), null);
75
+ const extensionManifest = JSON.parse(readFileSync(resolve('adapters/computer/chrome-extension/manifest.json'), 'utf8')) as { permissions?: string[] };
76
+ assert.equal(extensionManifest.permissions?.includes('storage'), false);
77
+ const backgroundSource = readFileSync(resolve('adapters/computer/chrome-extension/background.js'), 'utf8');
78
+ assert.ok(backgroundSource.includes('const PROVIDER_INSTANCE_ID = randomId()'));
79
+ assert.equal(backgroundSource.includes('chrome.storage'), false);
80
+ assert.ok(backgroundSource.includes("nativeRpc('computer_extension_heartbeat'"));
81
+ assert.ok(backgroundSource.includes('providerInstanceId: instanceId'));
82
+ assert.ok(backgroundSource.includes("nativeRpc('computer_extension_claim', { provider_instance_id: instanceId })"));
83
+ assert.ok(backgroundSource.includes("nativeRpc('computer_extension_complete', { provider_instance_id: instanceId"));
84
+ assert.ok(backgroundSource.includes('chrome.runtime.connectNative'));
85
+ assert.ok(backgroundSource.includes('chrome.tabs.create({ url, active: false }'));
86
+ for (const forbidden of ['browser_begin_effect', 'browser_observe_effect', 'browser_poll', 'browser_tasks', 'browser_observe_assistant', 'task_register', 'reserve_enrollment']) assert.equal(backgroundSource.includes(forbidden), false);
87
+ const contentSource = readFileSync(resolve('adapters/computer/chrome-extension/content.js'), 'utf8');
88
+ assert.ok(contentSource.includes('forge-computer-chatgpt-snapshot'));
89
+ assert.ok(contentSource.includes('forge-computer-chatgpt-dispatch'));
90
+ assert.ok(contentSource.includes('new MutationObserver(notify).observe'));
91
+ console.log('[workflow-supervisor-chrome-smoke] OK');
92
+ } finally { rmSync(home, { recursive: true, force: true }); }