@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,511 +0,0 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * Real iOS agent-device latency benchmark.
4
- *
5
- * Compares the compatibility fresh-session JD workflow with the trusted warm
6
- * path that reuses one exact active JD interaction. It never invents baseline
7
- * data and never runs without an explicitly selected --device. Every selected
8
- * profile performs one warmup followed by at least three measured runs.
9
- *
10
- * Fresh-session profile:
11
- * inventory -> open -> search/evidence -> screenshot -> close, for every run
12
- *
13
- * Reused-session profile:
14
- * open once -> repeated search/evidence batches without screenshot -> close once
15
- *
16
- * Example:
17
- * bun scripts/benchmark-ios-agent-device.ts \
18
- * --repo-id repo_... --device "iPhone" --query "宽楦男鞋" \
19
- * --search-selector 'type="SearchField"' --submit-selector 'label="搜索"' \
20
- * --result-text "宽楦男鞋" --profile both --runs 5 --json
21
- */
22
- import { performance } from 'perf_hooks';
23
- import { resolve } from 'path';
24
- import { executeIosAgentDeviceAction } from '../src/runtime/plugins/ios-agent-device';
25
- import { resolveControllerHome } from '../src/cli/repositories/controller-home';
26
-
27
- type EvidenceTier = 'exact_wait' | 'scoped_snapshot' | 'full_snapshot' | 'unknown';
28
- export type BenchmarkProfile = 'fresh_session' | 'reused_session';
29
-
30
- export interface NumericSummary {
31
- count: number;
32
- min: number;
33
- p50: number;
34
- p95: number;
35
- max: number;
36
- mean: number;
37
- }
38
-
39
- interface PhaseTimings {
40
- targetSelection?: number;
41
- open?: number;
42
- targetDiscovery?: number;
43
- interactionAndEvidence?: number;
44
- screenshot?: number;
45
- close?: number;
46
- total?: number;
47
- }
48
-
49
- export interface IosBenchmarkSample {
50
- index: number;
51
- warmup: boolean;
52
- profile: BenchmarkProfile;
53
- totalMs: number;
54
- harnessOverheadMs?: number;
55
- tier: EvidenceTier;
56
- sessionReused: boolean;
57
- sessionKept: boolean;
58
- screenshotCaptured: boolean;
59
- deviceInventoryRequests: number;
60
- accessibilitySnapshotRequests: number;
61
- nativeBatchRequests: number;
62
- nativeBatchSteps: number;
63
- staleRefRecovery: boolean;
64
- exactWaitFallback: boolean;
65
- runnerRoundTrips?: number;
66
- providerWallClockMs?: number;
67
- phaseTimingsMs?: PhaseTimings;
68
- }
69
-
70
- export interface IosBenchmarkProfileReport {
71
- profile: BenchmarkProfile;
72
- warmupCount: number;
73
- measuredRunCount: number;
74
- setup?: { openMs: number };
75
- cleanup?: { closeMs: number; completed: boolean };
76
- measured: Record<string, unknown>;
77
- samples: IosBenchmarkSample[];
78
- }
79
-
80
- const JD_BUNDLE_ID = 'com.360buy.jdmobile';
81
-
82
- function rounded(value: number): number {
83
- return Math.round(value * 100) / 100;
84
- }
85
-
86
- export function percentile(values: number[], percentileValue: number): number {
87
- if (values.length === 0) return 0;
88
- const sorted = [...values].sort((left, right) => left - right);
89
- const rank = Math.max(0, Math.min(1, percentileValue)) * (sorted.length - 1);
90
- const lower = Math.floor(rank);
91
- const upper = Math.ceil(rank);
92
- if (lower === upper) return sorted[lower]!;
93
- const weight = rank - lower;
94
- return sorted[lower]! * (1 - weight) + sorted[upper]! * weight;
95
- }
96
-
97
- export function summarize(values: number[]): NumericSummary {
98
- if (values.length === 0) return { count: 0, min: 0, p50: 0, p95: 0, max: 0, mean: 0 };
99
- return {
100
- count: values.length,
101
- min: rounded(Math.min(...values)),
102
- p50: rounded(percentile(values, 0.5)),
103
- p95: rounded(percentile(values, 0.95)),
104
- max: rounded(Math.max(...values)),
105
- mean: rounded(values.reduce((sum, value) => sum + value, 0) / values.length),
106
- };
107
- }
108
-
109
- function option(name: string): string | undefined {
110
- const index = process.argv.indexOf(`--${name}`);
111
- return index >= 0 ? process.argv[index + 1] : undefined;
112
- }
113
-
114
- function hasFlag(name: string): boolean {
115
- return process.argv.includes(`--${name}`);
116
- }
117
-
118
- function integerOption(name: string, fallback: number, minimum: number, maximum: number): number {
119
- const raw = option(name);
120
- if (raw === undefined) return fallback;
121
- const value = Number(raw);
122
- if (!Number.isInteger(value) || value < minimum || value > maximum) {
123
- throw new Error(`--${name} must be an integer between ${minimum} and ${maximum}`);
124
- }
125
- return value;
126
- }
127
-
128
- function requiredOption(name: string): string {
129
- const value = option(name)?.trim();
130
- if (!value) throw new Error(`--${name} is required`);
131
- return value;
132
- }
133
-
134
- function selectedProfiles(): BenchmarkProfile[] {
135
- const value = (option('profile') ?? 'both').trim().toLowerCase();
136
- if (value === 'both') return ['fresh_session', 'reused_session'];
137
- if (value === 'fresh' || value === 'fresh_session') return ['fresh_session'];
138
- if (value === 'warm' || value === 'reused' || value === 'reused_session') return ['reused_session'];
139
- throw new Error('--profile must be fresh, warm, or both');
140
- }
141
-
142
- function stringRecord(value: unknown): Record<string, unknown> | undefined {
143
- return value && typeof value === 'object' && !Array.isArray(value)
144
- ? value as Record<string, unknown>
145
- : undefined;
146
- }
147
-
148
- function findCost(value: unknown): { wallClockMs?: number; runnerRoundTrips?: number } {
149
- if (Array.isArray(value)) {
150
- for (const item of value) {
151
- const found = findCost(item);
152
- if (found.wallClockMs !== undefined || found.runnerRoundTrips !== undefined) return found;
153
- }
154
- return {};
155
- }
156
- const record = stringRecord(value);
157
- if (!record) return {};
158
- const cost = stringRecord(record.cost);
159
- if (cost) {
160
- return {
161
- wallClockMs: typeof cost.wallClockMs === 'number' ? cost.wallClockMs : undefined,
162
- runnerRoundTrips: typeof cost.runnerRoundTrips === 'number' ? cost.runnerRoundTrips : undefined,
163
- };
164
- }
165
- for (const child of Object.values(record)) {
166
- const found = findCost(child);
167
- if (found.wallClockMs !== undefined || found.runnerRoundTrips !== undefined) return found;
168
- }
169
- return {};
170
- }
171
-
172
- function sampleFromResult(
173
- profile: BenchmarkProfile,
174
- index: number,
175
- warmup: boolean,
176
- totalMs: number,
177
- result: Record<string, unknown>,
178
- ): IosBenchmarkSample {
179
- const executionPlan = stringRecord(result.executionPlan) ?? {};
180
- const phaseTimingsMs = stringRecord(executionPlan.timingsMs) as PhaseTimings | undefined;
181
- const providerTotal = phaseTimingsMs?.total;
182
- const cost = findCost(result);
183
- return {
184
- index,
185
- warmup,
186
- profile,
187
- totalMs: rounded(totalMs),
188
- harnessOverheadMs: typeof providerTotal === 'number'
189
- ? rounded(Math.max(0, totalMs - providerTotal))
190
- : undefined,
191
- tier: typeof executionPlan.accessibilityEvidenceTier === 'string'
192
- ? executionPlan.accessibilityEvidenceTier as EvidenceTier
193
- : 'unknown',
194
- sessionReused: executionPlan.sessionReused === true,
195
- sessionKept: executionPlan.sessionKept === true,
196
- screenshotCaptured: executionPlan.screenshotCaptured === true,
197
- deviceInventoryRequests: Number(executionPlan.deviceInventoryRequests ?? 0),
198
- accessibilitySnapshotRequests: Number(executionPlan.accessibilitySnapshotRequests ?? 0),
199
- nativeBatchRequests: Number(executionPlan.nativeBatchRequests ?? 0),
200
- nativeBatchSteps: Number(executionPlan.nativeBatchSteps ?? 0),
201
- staleRefRecovery: executionPlan.staleRefRecovery === true,
202
- exactWaitFallback: executionPlan.exactWaitFallback === true,
203
- runnerRoundTrips: cost.runnerRoundTrips,
204
- providerWallClockMs: cost.wallClockMs,
205
- phaseTimingsMs,
206
- };
207
- }
208
-
209
- const PHASE_NAMES: Array<keyof PhaseTimings> = [
210
- 'targetSelection',
211
- 'open',
212
- 'targetDiscovery',
213
- 'interactionAndEvidence',
214
- 'screenshot',
215
- 'close',
216
- 'total',
217
- ];
218
-
219
- export function summarizeProfileSamples(samples: IosBenchmarkSample[]): Record<string, unknown> {
220
- const measured = samples.filter((sample) => !sample.warmup);
221
- const phaseTimingsMs = Object.fromEntries(PHASE_NAMES.map((phase) => [
222
- phase,
223
- summarize(measured.flatMap((sample) => {
224
- const value = sample.phaseTimingsMs?.[phase];
225
- return typeof value === 'number' ? [value] : [];
226
- })),
227
- ]));
228
- const byTier = Object.fromEntries(
229
- [...new Set(measured.map((sample) => sample.tier))].map((tier) => [
230
- tier,
231
- {
232
- totalMs: summarize(measured.filter((sample) => sample.tier === tier).map((sample) => sample.totalMs)),
233
- providerWallClockMs: summarize(measured
234
- .filter((sample) => sample.tier === tier && sample.providerWallClockMs !== undefined)
235
- .map((sample) => sample.providerWallClockMs!)),
236
- runnerRoundTrips: summarize(measured
237
- .filter((sample) => sample.tier === tier && sample.runnerRoundTrips !== undefined)
238
- .map((sample) => sample.runnerRoundTrips!)),
239
- },
240
- ]),
241
- );
242
- return {
243
- totalMs: summarize(measured.map((sample) => sample.totalMs)),
244
- harnessOverheadMs: summarize(measured
245
- .filter((sample) => sample.harnessOverheadMs !== undefined)
246
- .map((sample) => sample.harnessOverheadMs!)),
247
- deviceInventoryRequests: summarize(measured.map((sample) => sample.deviceInventoryRequests)),
248
- accessibilitySnapshotRequests: summarize(measured.map((sample) => sample.accessibilitySnapshotRequests)),
249
- nativeBatchRequests: summarize(measured.map((sample) => sample.nativeBatchRequests)),
250
- nativeBatchSteps: summarize(measured.map((sample) => sample.nativeBatchSteps)),
251
- runnerRoundTrips: summarize(measured
252
- .filter((sample) => sample.runnerRoundTrips !== undefined)
253
- .map((sample) => sample.runnerRoundTrips!)),
254
- phaseTimingsMs,
255
- byTier,
256
- invariants: {
257
- allSessionsReused: measured.length > 0 && measured.every((sample) => sample.sessionReused),
258
- allScreenshotsSkipped: measured.length > 0 && measured.every((sample) => !sample.screenshotCaptured),
259
- allInventorySkipped: measured.length > 0 && measured.every((sample) => sample.deviceInventoryRequests === 0),
260
- maxNativeBatchRequests: measured.length > 0 ? Math.max(...measured.map((sample) => sample.nativeBatchRequests)) : 0,
261
- },
262
- };
263
- }
264
-
265
- export function compareProfileReports(
266
- fresh: IosBenchmarkProfileReport | undefined,
267
- reused: IosBenchmarkProfileReport | undefined,
268
- ): Record<string, unknown> | undefined {
269
- if (!fresh || !reused) return undefined;
270
- const freshTotal = (fresh.measured.totalMs as NumericSummary).p50;
271
- const reusedTotal = (reused.measured.totalMs as NumericSummary).p50;
272
- const freshP95 = (fresh.measured.totalMs as NumericSummary).p95;
273
- const reusedP95 = (reused.measured.totalMs as NumericSummary).p95;
274
- return {
275
- p50SavedMs: rounded(freshTotal - reusedTotal),
276
- p95SavedMs: rounded(freshP95 - reusedP95),
277
- p50Speedup: reusedTotal > 0 ? rounded(freshTotal / reusedTotal) : null,
278
- p95Speedup: reusedP95 > 0 ? rounded(freshP95 / reusedP95) : null,
279
- note: 'Fresh-session includes per-run inventory/open/screenshot/close; reused-session excludes one-time setup and cleanup from measured search latency.',
280
- };
281
- }
282
-
283
- function usage(): string {
284
- return [
285
- 'Usage: bun scripts/benchmark-ios-agent-device.ts --repo-id <id> --device <name> --query <text> [options]',
286
- '',
287
- 'Required:',
288
- ' --repo-id <id> Repository id used for Controller-owned interaction state',
289
- ' --device <name> Exact connected physical iPhone or booted Simulator name',
290
- ' --query <text> Non-sensitive product-information query',
291
- '',
292
- 'Evidence targeting:',
293
- ' --search-selector <value> Stable selector; preferred over snapshot-scoped refs',
294
- ' --search-target <ref> Cached accessibility ref fallback',
295
- ' --submit-selector <value> Stable submit selector',
296
- ' --submit-target <ref> Cached submit ref fallback',
297
- ' --result-text <text> Exact text wait',
298
- ' --result-selector <value> Exact selector wait',
299
- ' --result-scope <value> Scoped snapshot fallback',
300
- ' --snapshot-depth <1..20> Snapshot depth, default 8',
301
- '',
302
- 'Execution:',
303
- ' --profile <fresh|warm|both> Profiles to measure, default both',
304
- ' --runs <3..20> Measured runs per profile after one warmup, default 3',
305
- ' --timeout-ms <ms> Absolute timeout per action, default 60000',
306
- ' --controller-home <path> Defaults to FORGE_CONTROLLER_HOME/XDG state or ~/.forge/controller',
307
- ' --repo-root <path> Defaults to current working directory',
308
- ' --relaunch Relaunch JD for each fresh run and the warm-profile setup open',
309
- ' --json Emit machine-readable JSON',
310
- ].join('\n');
311
- }
312
-
313
- interface BenchmarkContext {
314
- controllerHome: string;
315
- repoId: string;
316
- repoRoot: string;
317
- device: string;
318
- query: string;
319
- timeoutMs: number;
320
- relaunch: boolean;
321
- runs: number;
322
- baseArgs: Record<string, unknown>;
323
- runNonce: string;
324
- }
325
-
326
- async function executeAction(
327
- context: BenchmarkContext,
328
- actionId: string,
329
- suffix: string,
330
- args: Record<string, unknown>,
331
- ): Promise<Record<string, unknown>> {
332
- return executeIosAgentDeviceAction({
333
- controllerHome: context.controllerHome,
334
- repoId: context.repoId,
335
- repoRoot: context.repoRoot,
336
- pluginId: 'ios',
337
- actionId,
338
- requestId: `ios-latency-benchmark-${context.runNonce}-${suffix}`,
339
- args,
340
- timeoutMs: context.timeoutMs,
341
- origin: { surface: 'local-ui', actor: 'ios-latency-benchmark' },
342
- });
343
- }
344
-
345
- async function executeSearchSample(
346
- context: BenchmarkContext,
347
- profile: BenchmarkProfile,
348
- index: number,
349
- args: Record<string, unknown>,
350
- ): Promise<IosBenchmarkSample> {
351
- const startedAt = performance.now();
352
- const result = await executeAction(context, 'agent_device_jd_search', `${profile}-${index}`, args);
353
- return sampleFromResult(profile, index, index === 0, performance.now() - startedAt, result);
354
- }
355
-
356
- async function runFreshSessionProfile(context: BenchmarkContext): Promise<IosBenchmarkProfileReport> {
357
- const samples: IosBenchmarkSample[] = [];
358
- for (let index = 0; index <= context.runs; index += 1) {
359
- samples.push(await executeSearchSample(context, 'fresh_session', index, {
360
- ...context.baseArgs,
361
- relaunch: context.relaunch,
362
- keep_session: false,
363
- capture_screenshot: true,
364
- }));
365
- }
366
- return {
367
- profile: 'fresh_session',
368
- warmupCount: 1,
369
- measuredRunCount: context.runs,
370
- measured: summarizeProfileSamples(samples),
371
- samples,
372
- };
373
- }
374
-
375
- async function runReusedSessionProfile(context: BenchmarkContext): Promise<IosBenchmarkProfileReport> {
376
- const openStartedAt = performance.now();
377
- const opened = await executeAction(context, 'agent_device_open', 'warm-open', {
378
- app: JD_BUNDLE_ID,
379
- device: context.device,
380
- relaunch: context.relaunch,
381
- });
382
- const openMs = rounded(performance.now() - openStartedAt);
383
- const interaction = stringRecord(opened.interaction);
384
- const interactionId = typeof interaction?.interactionId === 'string' ? interaction.interactionId : undefined;
385
- if (!interactionId) throw new Error('agent_device_open did not return an interaction_id');
386
-
387
- const samples: IosBenchmarkSample[] = [];
388
- let closeMs = 0;
389
- let cleanupCompleted = false;
390
- try {
391
- for (let index = 0; index <= context.runs; index += 1) {
392
- samples.push(await executeSearchSample(context, 'reused_session', index, {
393
- ...context.baseArgs,
394
- interaction_id: interactionId,
395
- keep_session: true,
396
- capture_screenshot: false,
397
- relaunch: false,
398
- }));
399
- }
400
- } finally {
401
- const closeStartedAt = performance.now();
402
- try {
403
- await executeAction(context, 'agent_device_close', 'warm-close', { interaction_id: interactionId });
404
- cleanupCompleted = true;
405
- } finally {
406
- closeMs = rounded(performance.now() - closeStartedAt);
407
- }
408
- }
409
- return {
410
- profile: 'reused_session',
411
- warmupCount: 1,
412
- measuredRunCount: context.runs,
413
- setup: { openMs },
414
- cleanup: { closeMs, completed: cleanupCompleted },
415
- measured: summarizeProfileSamples(samples),
416
- samples,
417
- };
418
- }
419
-
420
- export async function runBenchmark(): Promise<Record<string, unknown>> {
421
- if (hasFlag('help')) {
422
- console.log(usage());
423
- return { help: true };
424
- }
425
- const repoId = requiredOption('repo-id');
426
- const device = requiredOption('device');
427
- const query = requiredOption('query');
428
- const runs = integerOption('runs', 3, 3, 20);
429
- const timeoutMs = integerOption('timeout-ms', 60_000, 1_000, 600_000);
430
- const snapshotDepth = integerOption('snapshot-depth', 8, 1, 20);
431
- const repoRoot = resolve(option('repo-root') ?? process.cwd());
432
- const controllerHome = resolveControllerHome(option('controller-home'));
433
- const baseArgs: Record<string, unknown> = { device, query, snapshot_depth: snapshotDepth };
434
- for (const [flag, key] of [
435
- ['search-selector', 'search_selector'],
436
- ['search-target', 'search_target'],
437
- ['submit-selector', 'submit_selector'],
438
- ['submit-target', 'submit_target'],
439
- ['result-text', 'result_text'],
440
- ['result-selector', 'result_selector'],
441
- ['result-scope', 'result_scope'],
442
- ] as const) {
443
- const value = option(flag)?.trim();
444
- if (value) baseArgs[key] = value;
445
- }
446
- const profiles = selectedProfiles();
447
- const context: BenchmarkContext = {
448
- controllerHome,
449
- repoId,
450
- repoRoot,
451
- device,
452
- query,
453
- timeoutMs,
454
- relaunch: hasFlag('relaunch'),
455
- runs,
456
- baseArgs,
457
- runNonce: `${Date.now()}-${process.pid}`,
458
- };
459
-
460
- const reports: Partial<Record<BenchmarkProfile, IosBenchmarkProfileReport>> = {};
461
- for (const profile of profiles) {
462
- reports[profile] = profile === 'fresh_session'
463
- ? await runFreshSessionProfile(context)
464
- : await runReusedSessionProfile(context);
465
- }
466
- const comparison = compareProfileReports(reports.fresh_session, reports.reused_session);
467
- return {
468
- schemaVersion: 2,
469
- kind: 'ios_agent_device_latency_benchmark',
470
- generatedAt: new Date().toISOString(),
471
- environment: {
472
- repoId,
473
- device,
474
- relaunch: context.relaunch,
475
- profiles,
476
- measuredRunsPerProfile: runs,
477
- warmupsPerProfile: 1,
478
- timeoutMs,
479
- evidenceInputs: {
480
- hasSearchSelector: typeof baseArgs.search_selector === 'string',
481
- hasSearchTarget: typeof baseArgs.search_target === 'string',
482
- hasSubmitSelector: typeof baseArgs.submit_selector === 'string',
483
- hasSubmitTarget: typeof baseArgs.submit_target === 'string',
484
- hasResultText: typeof baseArgs.result_text === 'string',
485
- hasResultSelector: typeof baseArgs.result_selector === 'string',
486
- resultScope: baseArgs.result_scope ?? null,
487
- snapshotDepth,
488
- },
489
- },
490
- profiles: reports,
491
- ...(comparison ? { comparison } : {}),
492
- note: 'Results are actual provider executions. No historical or unavailable device data is synthesized. Fresh-session and reused-session have intentionally different setup, screenshot, and cleanup costs.',
493
- };
494
- }
495
-
496
- if (import.meta.main) {
497
- try {
498
- const report = await runBenchmark();
499
- if (!('help' in report)) {
500
- if (hasFlag('json')) console.log(JSON.stringify(report, null, 2));
501
- else {
502
- console.log('iOS agent-device latency benchmark');
503
- console.log(JSON.stringify({ profiles: report.profiles, comparison: report.comparison }, null, 2));
504
- }
505
- }
506
- } catch (error) {
507
- console.error(error instanceof Error ? error.message : String(error));
508
- console.error('\n' + usage());
509
- process.exitCode = 1;
510
- }
511
- }
@@ -1,117 +0,0 @@
1
- #!/usr/bin/env bash
2
- set -euo pipefail
3
-
4
- ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
5
- BUN_BIN="${BUN_BIN:-bun}"
6
- LABEL="${FORGE_MCP_BENCH_LABEL:-host-runtime-direct}"
7
- PORT="${FORGE_MCP_BENCH_PORT:-18765}"
8
- ITERATIONS="${FORGE_MCP_BENCH_ITERATIONS:-50}"
9
- CONNECT_ITERATIONS="${FORGE_MCP_BENCH_CONNECT_ITERATIONS:-30}"
10
-
11
- for value in "$PORT" "$ITERATIONS" "$CONNECT_ITERATIONS"; do
12
- if ! [[ "$value" =~ ^[0-9]+$ ]] || [[ "$value" == "0" ]]; then
13
- echo "benchmark:mcp-host requires positive integer port/iteration values" >&2
14
- exit 2
15
- fi
16
- done
17
- if (( PORT < 1024 || PORT > 65535 )); then
18
- echo "FORGE_MCP_BENCH_PORT must be between 1024 and 65535" >&2
19
- exit 2
20
- fi
21
-
22
- TMP_ROOT="$(mktemp -d "${TMPDIR:-/tmp}/forge-mcp-host-bench.XXXXXX")"
23
- CONTROLLER_HOME="$TMP_ROOT/controller-home"
24
- REGISTER_JSON="$TMP_ROOT/repository.json"
25
- INSTALL_JSON="$TMP_ROOT/runtime-install.json"
26
- READY_JSON="$TMP_ROOT/runtime-ready.json"
27
- STEADY_JSON="$TMP_ROOT/steady.json"
28
- CONNECT_JSON="$TMP_ROOT/connect.json"
29
- RUNTIME_PID=""
30
-
31
- cleanup() {
32
- if [[ -n "$RUNTIME_PID" ]] && kill -0 "$RUNTIME_PID" 2>/dev/null; then
33
- kill "$RUNTIME_PID" 2>/dev/null || true
34
- for _ in $(seq 1 20); do
35
- kill -0 "$RUNTIME_PID" 2>/dev/null || break
36
- sleep 0.1
37
- done
38
- kill -9 "$RUNTIME_PID" 2>/dev/null || true
39
- fi
40
- for _ in $(seq 1 5); do
41
- rm -rf "$TMP_ROOT" 2>/dev/null && return 0
42
- sleep 0.1
43
- done
44
- rm -rf "$TMP_ROOT" 2>/dev/null || true
45
- }
46
- trap cleanup EXIT INT TERM
47
-
48
- TOKEN="$(node -e "process.stdout.write(require('crypto').randomBytes(32).toString('hex'))")"
49
- export FORGE_MCP_TOKEN="$TOKEN"
50
- export FORGE_MCP_BENCH_TOKEN="$TOKEN"
51
-
52
- cd "$ROOT"
53
- "$BUN_BIN" bin/forge.mjs repo register "$ROOT" \
54
- --controller-home "$CONTROLLER_HOME" \
55
- --json > "$REGISTER_JSON"
56
- REPO_ID="$(node -e "const x=require(process.argv[1]); const id=x?.repository?.repoId; if(!id) process.exit(2); process.stdout.write(id)" "$REGISTER_JSON")"
57
-
58
- "$BUN_BIN" bin/forge.mjs runtime service install-package \
59
- --controller-home "$CONTROLLER_HOME" \
60
- --host 127.0.0.1 \
61
- --port "$PORT" \
62
- --portable > "$INSTALL_JSON"
63
- RUNTIME_PID="$(node -e "const x=require(process.argv[1]); const pid=x?.pid; if(!Number.isInteger(pid)||pid<=0) process.exit(2); process.stdout.write(String(pid))" "$INSTALL_JSON")"
64
-
65
- curl --fail --silent --show-error \
66
- --retry 30 --retry-delay 1 --retry-connrefused \
67
- "http://127.0.0.1:${PORT}/ready" > "$READY_JSON"
68
-
69
- "$BUN_BIN" run benchmark:mcp-transport -- \
70
- --endpoint "http://127.0.0.1:${PORT}/mcp" \
71
- --label "$LABEL" \
72
- --repo-id "$REPO_ID" \
73
- --tool rh_status \
74
- --iterations "$ITERATIONS" \
75
- --warmup 3 \
76
- --timing-log "$CONTROLLER_HOME/audit/mcp-timings.jsonl" > "$STEADY_JSON"
77
-
78
- "$BUN_BIN" run benchmark:mcp-transport -- \
79
- --endpoint "http://127.0.0.1:${PORT}/mcp" \
80
- --label "$LABEL" \
81
- --repo-id "$REPO_ID" \
82
- --tool rh_status \
83
- --iterations "$CONNECT_ITERATIONS" \
84
- --warmup 0 \
85
- --include-connect \
86
- --timing-log "$CONTROLLER_HOME/audit/mcp-timings.jsonl" > "$CONNECT_JSON"
87
-
88
- node - "$STEADY_JSON" "$CONNECT_JSON" "$READY_JSON" <<'NODE'
89
- const fs = require('fs');
90
- const os = require('os');
91
- const path = require('path');
92
- const [steadyPath, connectPath, readyPath] = process.argv.slice(2);
93
- const steady = JSON.parse(fs.readFileSync(steadyPath, 'utf8'));
94
- const connect = JSON.parse(fs.readFileSync(connectPath, 'utf8'));
95
- const ready = JSON.parse(fs.readFileSync(readyPath, 'utf8'));
96
- const report = {
97
- schemaVersion: 1,
98
- generatedAt: new Date().toISOString(),
99
- host: {
100
- platform: process.platform,
101
- arch: process.arch,
102
- cpuCount: os.cpus().length,
103
- totalMemoryBytes: os.totalmem(),
104
- },
105
- ready,
106
- steady,
107
- connectInclusive: connect,
108
- };
109
- const text = `${JSON.stringify(report, null, 2)}\n`;
110
- const output = process.env.FORGE_MCP_BENCH_OUTPUT?.trim();
111
- if (output) {
112
- const target = path.resolve(output);
113
- fs.mkdirSync(path.dirname(target), { recursive: true });
114
- fs.writeFileSync(target, text, 'utf8');
115
- }
116
- process.stdout.write(text);
117
- NODE