@tea-agent/loop-agent 0.41.1-beta.0 → 0.42.0-next.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 (273) hide show
  1. package/CHANGELOG.md +61 -207
  2. package/dist/adapters/context-transfer/optional-pi-handoff.js +31 -0
  3. package/dist/adapters/context-transfer/pi-session.js +61 -0
  4. package/dist/application/dag/generate-task-dag.js +19 -75
  5. package/dist/application/task-lifecycle/advance.js +5 -24
  6. package/dist/application/task-lifecycle/observe.js +17 -171
  7. package/dist/application/task-lifecycle/plan-transitions.js +7 -42
  8. package/dist/application/task-lifecycle/recommendations.js +2 -13
  9. package/dist/build-stamp.json +3 -3
  10. package/dist/cli/command-definitions.js +12 -7
  11. package/dist/cli/program.js +23 -6
  12. package/dist/commands/client-recovery.js +0 -3
  13. package/dist/commands/dag-artifact.js +284 -0
  14. package/dist/commands/dag-context.js +184 -0
  15. package/dist/commands/dag-rerun.js +206 -1
  16. package/dist/commands/init.js +1 -27
  17. package/dist/commands/task-advance.js +0 -19
  18. package/dist/executors/dag-pi-executor.js +266 -3792
  19. package/dist/executors/pi-executor.js +4 -15
  20. package/dist/executors/pi-sdk-executor.js +3 -0
  21. package/dist/executors/shell-executor.js +217 -945
  22. package/dist/executors/shell-write-guard.js +0 -7
  23. package/dist/{worker → infrastructure}/console/app-data.js +4 -0
  24. package/dist/infrastructure/console/artifact-revision-store.js +430 -0
  25. package/dist/infrastructure/console/context-export-store.js +160 -0
  26. package/dist/infrastructure/console/dir-lock.js +132 -0
  27. package/dist/infrastructure/console/operation-store.js +197 -0
  28. package/dist/infrastructure/harness/artifact-store.js +10 -1
  29. package/dist/infrastructure/harness/atomic-write.js +12 -2
  30. package/dist/shared/context-transfer/artifact-revision.js +172 -0
  31. package/dist/shared/context-transfer.js +418 -0
  32. package/dist/shared/dag-failure-category.js +0 -12
  33. package/dist/shared/openspec-spec.js +4 -70
  34. package/dist/shared/operator/capabilities.js +14 -7
  35. package/dist/shared/operator/safe-run-summary.js +1 -0
  36. package/dist/shared/path-safety.js +93 -0
  37. package/dist/shared/preview.js +28 -4
  38. package/dist/task/config-types.js +9 -35
  39. package/dist/task/contract/adopt.js +0 -4
  40. package/dist/task/contract/import-revision.js +0 -4
  41. package/dist/task/contract/project.js +0 -3
  42. package/dist/task/contract/schema.js +1 -2
  43. package/dist/task/frontend-project-capability.js +20 -203
  44. package/dist/task/runtime.js +2 -5
  45. package/dist/task/source-prepare/build-draft.js +3 -3
  46. package/dist/task/source-prepare/fragment-inventory.js +9 -15
  47. package/dist/task/source-prepare/prepare.js +1 -89
  48. package/dist/task/source-prepare/semantic-intake.js +2 -6
  49. package/dist/task/source-references.js +1 -22
  50. package/dist/task/task-demand-routing.js +3 -0
  51. package/dist/worker/console/chat/chat-event-store.js +2 -2
  52. package/dist/worker/console/chat/pi-runtime.js +3 -2
  53. package/dist/worker/console/chat/resource-preferences-store.js +1 -1
  54. package/dist/worker/console/chat/routes.js +13 -4
  55. package/dist/worker/console/chat/semantic-activity.js +12 -11
  56. package/dist/worker/console/chat/session-stats.js +96 -0
  57. package/dist/worker/console/chat/session-store.js +1 -1
  58. package/dist/worker/console/chat/turn-process.js +28 -4
  59. package/dist/worker/console/chat/user-questions.js +1 -1
  60. package/dist/worker/console/console-update-runtime.js +1 -1
  61. package/dist/worker/console/context-transfer-diagnostics.js +198 -0
  62. package/dist/worker/console/dag-confirmation.js +1 -1
  63. package/dist/worker/console/dag-execution-receipt.js +1 -1
  64. package/dist/worker/console/doctor.js +1 -1
  65. package/dist/worker/console/draft-store.js +1 -1
  66. package/dist/worker/console/human-gate-token.js +1 -1
  67. package/dist/worker/console/index.js +3 -6
  68. package/dist/worker/console/interview/assessment.js +1 -1
  69. package/dist/worker/console/interview/session.js +1 -1
  70. package/dist/worker/console/operation-runner.js +45 -4
  71. package/dist/worker/console/operation-sse.js +1 -1
  72. package/dist/worker/console/operation-wait.js +1 -1
  73. package/dist/worker/console/operator-actions.js +107 -168
  74. package/dist/worker/console/operator-surface-health.js +1 -1
  75. package/dist/worker/console/operator-user-error.js +169 -0
  76. package/dist/worker/console/pi-plugins.js +60 -1
  77. package/dist/worker/console/routes.js +637 -8
  78. package/dist/worker/console/security.js +35 -0
  79. package/dist/worker/console/server.js +6 -6
  80. package/dist/worker/console/static/assets/{abnfDiagram-N423BO3Z-Bho4we4c.js → abnfDiagram-N423BO3Z-DZZ8m3PO.js} +1 -1
  81. package/dist/worker/console/static/assets/{arc-TBDkTeK0.js → arc-D6PvaVd-.js} +1 -1
  82. package/dist/worker/console/static/assets/{architectureDiagram-T3A2C74G-BF_fZrn2.js → architectureDiagram-T3A2C74G-B_OTOiI8.js} +1 -1
  83. package/dist/worker/console/static/assets/{blockDiagram-VBNYF7ZC-CCnPgUe2.js → blockDiagram-VBNYF7ZC-Bv6rqHBg.js} +1 -1
  84. package/dist/worker/console/static/assets/{c4Diagram-5PPSVZJV-BCYZJLAT.js → c4Diagram-5PPSVZJV-B8eHr0oz.js} +1 -1
  85. package/dist/worker/console/static/assets/channel-BU5gOilw.js +1 -0
  86. package/dist/worker/console/static/assets/{chunk-2GRJ4B5K-D8K6adhU.js → chunk-2GRJ4B5K-DYwR0im2.js} +1 -1
  87. package/dist/worker/console/static/assets/{chunk-2Q5K7J3B-DkT1Q78b.js → chunk-2Q5K7J3B-D2WPGqXt.js} +1 -1
  88. package/dist/worker/console/static/assets/{chunk-5RXB4S5H-DuhvpIr7.js → chunk-5RXB4S5H-CQISJ_I7.js} +1 -1
  89. package/dist/worker/console/static/assets/{chunk-5VM5RSS4-BnK6dC49.js → chunk-5VM5RSS4-C0o2Du1e.js} +1 -1
  90. package/dist/worker/console/static/assets/{chunk-6Q2QTUOP-DPz__z7r.js → chunk-6Q2QTUOP-4f8kr-U7.js} +1 -1
  91. package/dist/worker/console/static/assets/{chunk-GF5L2VYU-0kkppM2j.js → chunk-GF5L2VYU-D_OWvXzX.js} +1 -1
  92. package/dist/worker/console/static/assets/{chunk-JWPE2WC7-BB41iK5t.js → chunk-JWPE2WC7-CasdPz5X.js} +1 -1
  93. package/dist/worker/console/static/assets/{chunk-KBJHAD2P-CiVrxKHU.js → chunk-KBJHAD2P-Cj8lRrla.js} +1 -1
  94. package/dist/worker/console/static/assets/{chunk-RYQCIY6F-C2h9Xje1.js → chunk-RYQCIY6F-CUvD1FSd.js} +1 -1
  95. package/dist/worker/console/static/assets/{chunk-XXDRQBXY-3iOSHdbM.js → chunk-XXDRQBXY-CqLw_eqB.js} +1 -1
  96. package/dist/worker/console/static/assets/classDiagram-JCYQIIEL-DIzKJGHr.js +1 -0
  97. package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE-DIzKJGHr.js +1 -0
  98. package/dist/worker/console/static/assets/{cose-bilkent-JH36ORCC-BN3A7tkk.js → cose-bilkent-JH36ORCC-ku-WqJPx.js} +1 -1
  99. package/dist/worker/console/static/assets/{cynefin-VYW2F7L2-CTuBy0Or.js → cynefin-VYW2F7L2-Bq_PYDhl.js} +1 -1
  100. package/dist/worker/console/static/assets/{cynefinDiagram-MW4NZA55-wb6tUlMN.js → cynefinDiagram-MW4NZA55-BiGZV641.js} +1 -1
  101. package/dist/worker/console/static/assets/{dagre-VZM6K2ZE-GP1Ivx8B.js → dagre-VZM6K2ZE-C4JRlglF.js} +1 -1
  102. package/dist/worker/console/static/assets/{diagram-7IWD3JNH-ejrcK6L0.js → diagram-7IWD3JNH-B0dNeWYG.js} +1 -1
  103. package/dist/worker/console/static/assets/{diagram-B4RE2ZJO-YFkCCvUU.js → diagram-B4RE2ZJO-Cj35YvYM.js} +1 -1
  104. package/dist/worker/console/static/assets/{diagram-LBJQPF4R-B4rrvIaL.js → diagram-LBJQPF4R-uzQoJ2-8.js} +1 -1
  105. package/dist/worker/console/static/assets/{diagram-Q27KOJAE-C-YIZcUf.js → diagram-Q27KOJAE-D1a-Buoz.js} +1 -1
  106. package/dist/worker/console/static/assets/{diagram-UB23O5K3-BPF5wcL1.js → diagram-UB23O5K3-XjRrLRSs.js} +1 -1
  107. package/dist/worker/console/static/assets/{ebnfDiagram-BXEA7PRR-CU5SzXjO.js → ebnfDiagram-BXEA7PRR-Da_O24cW.js} +1 -1
  108. package/dist/worker/console/static/assets/{erDiagram-JOGREHBK-CpL414DE.js → erDiagram-JOGREHBK-BLJ8jrYU.js} +1 -1
  109. package/dist/worker/console/static/assets/{flowDiagram-UKHOOZJN-MrhLzNau.js → flowDiagram-UKHOOZJN-B9GrLjM0.js} +1 -1
  110. package/dist/worker/console/static/assets/{ganttDiagram-PKOTCBZU-Bg4qFuUo.js → ganttDiagram-PKOTCBZU-CeJ0TqiK.js} +1 -1
  111. package/dist/worker/console/static/assets/{gitGraphDiagram-DS77QQ5N-ColxSXLR.js → gitGraphDiagram-DS77QQ5N-Bm2eNNFX.js} +1 -1
  112. package/dist/worker/console/static/assets/index-H9rFJiGL.css +1 -0
  113. package/dist/worker/console/static/assets/index-xwu9GxEc.js +451 -0
  114. package/dist/worker/console/static/assets/{infoDiagram-6WML65LV-Czvtm6gc.js → infoDiagram-6WML65LV-DB26i3d8.js} +1 -1
  115. package/dist/worker/console/static/assets/{ishikawaDiagram-WSZJBQD7-B7Xp8HyJ.js → ishikawaDiagram-WSZJBQD7-BOGRyeZT.js} +1 -1
  116. package/dist/worker/console/static/assets/{journeyDiagram-NVQOT4AX-DWYZcvph.js → journeyDiagram-NVQOT4AX-CZRoBO_6.js} +1 -1
  117. package/dist/worker/console/static/assets/{kanban-definition-27J2QSJJ-KTLZRUjx.js → kanban-definition-27J2QSJJ-qlWhJyoB.js} +1 -1
  118. package/dist/worker/console/static/assets/{linear-_Exn7bfl.js → linear-CfUiDDB3.js} +1 -1
  119. package/dist/worker/console/static/assets/{mermaid.core-Cxg8kX8V.js → mermaid.core-BQe6fpqj.js} +5 -5
  120. package/dist/worker/console/static/assets/{mindmap-definition-FAOFIHXS-oKrlo2Bt.js → mindmap-definition-FAOFIHXS-zFzWHw64.js} +1 -1
  121. package/dist/worker/console/static/assets/{pegDiagram-VL7TDLO6-XAeteiNd.js → pegDiagram-VL7TDLO6-DFGUqjZO.js} +1 -1
  122. package/dist/worker/console/static/assets/{pieDiagram-7S7Q4E2Y-BTf1K-lp.js → pieDiagram-7S7Q4E2Y-BB5i0l8Z.js} +1 -1
  123. package/dist/worker/console/static/assets/{quadrantDiagram-CIZ2JOQS-C0IlY0Jf.js → quadrantDiagram-CIZ2JOQS-obbVZ_X5.js} +1 -1
  124. package/dist/worker/console/static/assets/{railroadDiagram-AXF67PYL-BVbKtZhW.js → railroadDiagram-AXF67PYL-BwdaNzc1.js} +1 -1
  125. package/dist/worker/console/static/assets/{requirementDiagram-LRYGKXZP-C5e4JFcr.js → requirementDiagram-LRYGKXZP-CkTJaugh.js} +1 -1
  126. package/dist/worker/console/static/assets/{sankeyDiagram-W5VNT64P-Cz30hc29.js → sankeyDiagram-W5VNT64P-BwJ-hIgq.js} +1 -1
  127. package/dist/worker/console/static/assets/{sequenceDiagram-SI44F4Z6-DS33n6d0.js → sequenceDiagram-SI44F4Z6-BzSgmm7w.js} +1 -1
  128. package/dist/worker/console/static/assets/{sizeCapture-X5ZJPWSS-46w7v-9T.js → sizeCapture-X5ZJPWSS-Bn3oj5Q1.js} +1 -1
  129. package/dist/worker/console/static/assets/{stateDiagram-OKZ733FA-pbcD5SsZ.js → stateDiagram-OKZ733FA-dxhGtL8K.js} +1 -1
  130. package/dist/worker/console/static/assets/stateDiagram-v2-UEYNNEHI-Cld2qK9v.js +1 -0
  131. package/dist/worker/console/static/assets/{swimlanes-SLNWSIFB-DuivYBSj.js → swimlanes-SLNWSIFB-BLpEInya.js} +2 -2
  132. package/dist/worker/console/static/assets/swimlanesDiagram-ULZ7WXOC-TIHpiT7w.js +8 -0
  133. package/dist/worker/console/static/assets/{timeline-definition-Z64GVDOM-Cb9VZVIl.js → timeline-definition-Z64GVDOM-ChJGYcXy.js} +1 -1
  134. package/dist/worker/console/static/assets/{vennDiagram-T6HMQDX7-D2-mfOgR.js → vennDiagram-T6HMQDX7-DK-qjRer.js} +1 -1
  135. package/dist/worker/console/static/assets/{wardleyDiagram-T6FBY63Y-DeS2aC76.js → wardleyDiagram-T6FBY63Y-3qeaWAg-.js} +1 -1
  136. package/dist/worker/console/static/assets/{xychartDiagram-ELKLHX3M-WGsrFjxH.js → xychartDiagram-ELKLHX3M-CootlyP9.js} +1 -1
  137. package/dist/worker/console/static/index.html +7 -2
  138. package/dist/worker/console/static-src/app/useOperatorActions.js +3 -2
  139. package/dist/worker/console/static-src/app/useRunProgress.js +9 -2
  140. package/dist/worker/console/static-src/operator-chat/dag-progress-link.js +22 -0
  141. package/dist/worker/console/static-src/operator-chat/useChatSessions.js +2 -0
  142. package/dist/worker/console/static-src/operator-chat/useChatThread.js +6 -0
  143. package/dist/worker/console/static-src/operator-chat/useRuntimeControls.js +28 -3
  144. package/dist/worker/console/static-src/pages/tasks/run-panel-progress.js +106 -0
  145. package/dist/worker/console/static-src/shell/console-update-reload.js +25 -0
  146. package/dist/worker/console/workspace-context.js +28 -112
  147. package/dist/worker/console/workspace-registry.js +2 -2
  148. package/dist/worker/continuation/worker-continuation.js +278 -0
  149. package/dist/worker/observability/read-model.js +4 -0
  150. package/dist/worker/observe/health.js +1 -1
  151. package/dist/worker/observe/node-transparency.js +572 -0
  152. package/dist/worker/observe/routes.js +51 -1
  153. package/dist/worker/observe/static/api.js +69 -5
  154. package/dist/worker/observe/static/dag-context-reason-labels.d.ts +9 -0
  155. package/dist/worker/observe/static/dag-context-reason-labels.js +120 -0
  156. package/dist/worker/observe/static/dag-node-purpose.js +0 -5
  157. package/dist/worker/observe/static/state.js +3 -1
  158. package/dist/worker/observe/static/styles.css +1037 -126
  159. package/dist/worker/observe/static/views/dag-inspector.js +1217 -65
  160. package/dist/worker/observe/static/views/session-timeline.js +121 -25
  161. package/dist/worker/outcomes/adapters.js +19 -0
  162. package/dist/worker/outcomes/types.js +1 -0
  163. package/dist/worker/pool/attempt-lease.js +97 -66
  164. package/dist/worker/pool/begin-attempt-with-lease.js +1 -0
  165. package/dist/worker/pool/reconcile.js +46 -1
  166. package/dist/worker/pool/run-store.js +2 -0
  167. package/dist/worker/pool/state-projection.js +2 -0
  168. package/dist/worker/task-spec/workflow-routing.js +8 -3
  169. package/dist/workflows/dag/artifact-bindings.js +149 -0
  170. package/dist/workflows/dag/artifact-revision-schema-registry.js +31 -0
  171. package/dist/workflows/dag/backend-test-result-contract.js +1 -1
  172. package/dist/workflows/dag/budget-enforcement.js +10 -0
  173. package/dist/workflows/dag/context-receipt.js +305 -0
  174. package/dist/workflows/dag/context-transfer/context-bundle.js +423 -0
  175. package/dist/workflows/dag/context-transfer/operator-actions.js +61 -0
  176. package/dist/workflows/dag/context-transfer/renderers.js +93 -0
  177. package/dist/workflows/dag/contract-validator-registrations.js +2 -1
  178. package/dist/workflows/dag/frontend-implementation-contract.js +162 -932
  179. package/dist/workflows/dag/frontend-plan-render.js +1 -2
  180. package/dist/workflows/dag/frontend-prewrite-gate.js +349 -255
  181. package/dist/workflows/dag/frontend-recovery-plan.js +10 -17
  182. package/dist/workflows/dag/frontend-recovery-run.js +20 -33
  183. package/dist/workflows/dag/frontend-repair.js +432 -1
  184. package/dist/workflows/dag/frontend-review-context.js +15 -261
  185. package/dist/workflows/dag/frontend-verification-trace.js +24 -249
  186. package/dist/workflows/dag/frontend-worktree-diff.js +17 -250
  187. package/dist/workflows/dag/frontend-writer-rollback.js +32 -0
  188. package/dist/workflows/dag/init-hybrid.js +640 -685
  189. package/dist/workflows/dag/interrupt-request.js +0 -7
  190. package/dist/workflows/dag/node-execution.js +116 -759
  191. package/dist/workflows/dag/path-safety.js +1 -0
  192. package/dist/workflows/dag/prompt.js +30 -38
  193. package/dist/workflows/dag/report.js +1 -37
  194. package/dist/workflows/dag/rerun-feedback.js +1 -256
  195. package/dist/workflows/dag/rerun-plan.js +557 -11
  196. package/dist/workflows/dag/rerun-run.js +601 -38
  197. package/dist/workflows/dag/rerun-task.js +0 -29
  198. package/dist/workflows/dag/retry-policy.js +104 -214
  199. package/dist/workflows/dag/runner.js +142 -430
  200. package/dist/workflows/dag/scheduler.js +16 -114
  201. package/dist/workflows/dag/skill-snapshot.js +17 -0
  202. package/dist/workflows/dag/types.js +195 -246
  203. package/dist/workflows/dag/validate.js +12 -28
  204. package/docs/architecture/runtime-boundaries.md +6 -6
  205. package/docs/architecture/worker-and-feature.md +1 -1
  206. package/docs/init-surface.manifest.json +12 -30
  207. package/docs/skills/vetted-skill-registry.md +2 -4
  208. package/docs/templates/README.md +0 -2
  209. package/docs/templates/agent-dag-report.schema.json +2 -8
  210. package/docs/templates/agent-dag.schema.json +33 -1
  211. package/docs/templates/frontend-implementation-contract.schema.json +1 -4
  212. package/docs/templates/product-line/task.yaml +1 -1
  213. package/harness.json +3 -3
  214. package/package.json +3 -1
  215. package/skills/frontend-bounded-implement/SKILL.md +14 -15
  216. package/skills/frontend-design-review/SKILL.md +41 -22
  217. package/skills/frontend-implementation/SKILL.md +52 -0
  218. package/skills/frontend-implementation/references/code-standards.md +33 -0
  219. package/skills/frontend-implementation/references/design-spec.md +56 -0
  220. package/skills/frontend-implementation/references/node-contracts.md +31 -0
  221. package/skills/frontend-review/SKILL.md +15 -20
  222. package/skills/frontend-review/references/review-findings.md +7 -6
  223. package/skills/frontend-verification/SKILL.md +1 -1
  224. package/skills/loop-agent/references/command-reference.md +6 -1
  225. package/skills/loop-agent/references/hybrid-dag.md +2 -2
  226. package/dist/commands/dag-follow-up.js +0 -138
  227. package/dist/executors/pi-read-budget-policy.js +0 -239
  228. package/dist/worker/console/frontend-human-decision-adapter.js +0 -19
  229. package/dist/worker/console/frontend-split-operation-adapter.js +0 -20
  230. package/dist/worker/console/operation-store.js +0 -389
  231. package/dist/worker/console/static/assets/channel-bnXW0U3C.js +0 -1
  232. package/dist/worker/console/static/assets/classDiagram-JCYQIIEL-rZpq_twR.js +0 -1
  233. package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE-rZpq_twR.js +0 -1
  234. package/dist/worker/console/static/assets/index-D3CC4eUz.css +0 -1
  235. package/dist/worker/console/static/assets/index-DLt4ZFvD.js +0 -437
  236. package/dist/worker/console/static/assets/stateDiagram-v2-UEYNNEHI-zBMYiUyi.js +0 -1
  237. package/dist/worker/console/static/assets/swimlanesDiagram-ULZ7WXOC-d_rms-5i.js +0 -8
  238. package/dist/worker/console/static-src/active-run-badge.js +0 -17
  239. package/dist/worker/materialize/frontend-split-task-materializer.js +0 -72
  240. package/dist/workflows/dag/dag-retry-schema.js +0 -138
  241. package/dist/workflows/dag/frontend-closeout.js +0 -221
  242. package/dist/workflows/dag/frontend-design-policy.js +0 -400
  243. package/dist/workflows/dag/frontend-human-decision.js +0 -182
  244. package/dist/workflows/dag/frontend-provider-capability-matrix.js +0 -159
  245. package/dist/workflows/dag/frontend-read-budgets.js +0 -12
  246. package/dist/workflows/dag/frontend-recovery-capsule.js +0 -455
  247. package/dist/workflows/dag/frontend-recovery-controller.js +0 -202
  248. package/dist/workflows/dag/frontend-recovery-lineage.js +0 -178
  249. package/dist/workflows/dag/frontend-review-findings.js +0 -270
  250. package/dist/workflows/dag/frontend-shadow-dual-write.js +0 -914
  251. package/dist/workflows/dag/frontend-shape-capsule-store.js +0 -191
  252. package/dist/workflows/dag/frontend-shape-facts.js +0 -409
  253. package/dist/workflows/dag/frontend-shape.js +0 -427
  254. package/dist/workflows/dag/frontend-source-fidelity-ledger.js +0 -108
  255. package/dist/workflows/dag/frontend-split-application-service.js +0 -203
  256. package/dist/workflows/dag/frontend-split-orchestrator.js +0 -899
  257. package/dist/workflows/dag/frontend-typed-event-store.js +0 -452
  258. package/dist/workflows/dag/frontend-typed-event-transaction.js +0 -180
  259. package/dist/workflows/dag/frontend-writer-admission.js +0 -285
  260. package/dist/workflows/dag/frontend-writer-status.js +0 -256
  261. package/dist/workflows/dag/recovery-lease.js +0 -80
  262. package/docs/templates/frontend-implementation-dag.json +0 -89
  263. package/docs/templates/spec-registry.schema.json +0 -45
  264. package/skills/frontend-bounded-implement/references/code-standards.md +0 -19
  265. package/skills/frontend-contract/SKILL.md +0 -23
  266. package/skills/frontend-contract/references/contract-protocol.md +0 -34
  267. package/skills/frontend-plan/SKILL.md +0 -26
  268. package/skills/frontend-plan/references/decision-contract.md +0 -37
  269. package/skills/frontend-plan/references/design-decisions.md +0 -17
  270. package/skills/frontend-scout/SKILL.md +0 -25
  271. package/skills/frontend-scout/references/design-evidence.md +0 -16
  272. package/skills/frontend-scout/references/scout-evidence.md +0 -23
  273. /package/dist/{worker → infrastructure}/console/repo-fingerprint.js +0 -0
@@ -1,389 +0,0 @@
1
- import { randomBytes } from "node:crypto";
2
- import path from "node:path";
3
- import { assertFrontendSplitProjectionSuccessor, frontendSplitProjectionSchema, } from "../../workflows/dag/frontend-split-application-service.js";
4
- import { buildFrontendHumanDecisionProjection, consumeFrontendHumanDecision, materializeFrontendHumanDecision, parseFrontendHumanDecisionProjection, parseFrontendHumanDecisionReceipt, } from "../../workflows/dag/frontend-human-decision.js";
5
- import { buildFrontendSplitAggregateCloseout, computeFrontendSplitDigest, finalizeFrontendSplitAggregate, frontendCommittedFactRefSchema, frontendSplitChildCloseoutFactsSchema, initializeFrontendSplitParent, } from "../../workflows/dag/frontend-split-orchestrator.js";
6
- import { frontendCloseoutFactsSchema, frontendTestHandoffSchema, } from "../../workflows/dag/frontend-closeout.js";
7
- import { listJsonFiles, readJsonIfExists, sha256Json, writeSecureJson, } from "./app-data.js";
8
- export const TERMINAL_OPERATION_STATES = new Set(["succeeded", "failed", "timed-out", "restarting"]);
9
- function operationFile(appData, operationId) {
10
- return path.join(appData.operations, `${operationId}.json`);
11
- }
12
- function requestIndexFile(appData, clientRequestId) {
13
- const safe = clientRequestId.replace(/[^a-zA-Z0-9._-]+/g, "_").slice(0, 180);
14
- return path.join(appData.operations, `req-${safe}.json`);
15
- }
16
- export function computeActionPayloadHash(action, actionParams) {
17
- return sha256Json({ action, actionParams });
18
- }
19
- export function newOperationId() {
20
- return `op_${randomBytes(12).toString("hex")}`;
21
- }
22
- const sharedWriteChains = new Map();
23
- export class OperationStore {
24
- appData;
25
- /** Shared per-store-root, per-key write lock. Multiple OperationStore instances
26
- * in one worker process must observe the same CAS critical section. */
27
- writeChains;
28
- constructor(appData) {
29
- this.appData = appData;
30
- const root = path.resolve(appData.operations);
31
- let chains = sharedWriteChains.get(root);
32
- if (!chains) {
33
- chains = new Map();
34
- sharedWriteChains.set(root, chains);
35
- }
36
- this.writeChains = chains;
37
- }
38
- serialize(key, op) {
39
- const prev = this.writeChains.get(key) ?? Promise.resolve();
40
- const next = prev.then(op, op);
41
- this.writeChains.set(key, next.then(() => undefined, () => undefined));
42
- return next;
43
- }
44
- async create(input) {
45
- const clientRequestId = input.clientRequestId.trim();
46
- if (!clientRequestId) {
47
- throw new Error("clientRequestId is required for mutation operations");
48
- }
49
- const payloadHash = computeActionPayloadHash(input.action, input.actionParams);
50
- return this.serialize(`req:${clientRequestId}`, async () => {
51
- const indexPath = requestIndexFile(this.appData, clientRequestId);
52
- const existingIndex = await readJsonIfExists(indexPath);
53
- if (existingIndex) {
54
- const existing = await this.get(existingIndex.operationId);
55
- if (existing) {
56
- if (existing.payloadHash === payloadHash) {
57
- return { kind: "idempotent", operation: existing };
58
- }
59
- return {
60
- kind: "conflict",
61
- code: "REQUEST_ID_REUSE_CONFLICT",
62
- message: `clientRequestId ${clientRequestId} was reused with a different payload`,
63
- existing,
64
- };
65
- }
66
- }
67
- const operationId = newOperationId();
68
- const now = new Date().toISOString();
69
- const operation = {
70
- schemaVersion: 1,
71
- operationId,
72
- clientRequestId,
73
- action: input.action,
74
- actionParams: input.actionParams,
75
- payloadHash,
76
- state: "queued",
77
- createdAt: now,
78
- revision: 1,
79
- taskId: input.taskId,
80
- cliArgs: input.cliArgs,
81
- ...(input.externalCommand
82
- ? { externalCommand: input.externalCommand }
83
- : {}),
84
- };
85
- await writeSecureJson(operationFile(this.appData, operationId), operation);
86
- await writeSecureJson(indexPath, { operationId, payloadHash });
87
- return { kind: "created", operation };
88
- });
89
- }
90
- /**
91
- * Idempotently materialize a split child/integration operation with a
92
- * caller-specified deterministic operationId (from the split manifest).
93
- * Unlike create() (random op_<hex> id) and save/update (no create), this is
94
- * the durable cross-restart idempotency boundary for the production
95
- * FrontendSplitTaskMaterializer backend: an existing operation file with the
96
- * same taskId + payloadHash is returned as {created:false}; any drift fails
97
- * closed instead of overwriting or silently diverging.
98
- */
99
- async ensureSplitMaterializedOperation(input) {
100
- return this.serialize(input.operationId, async () => {
101
- const existing = await this.get(input.operationId);
102
- if (existing) {
103
- if (existing.taskId !== input.taskId ||
104
- existing.payloadHash !== input.payloadHash) {
105
- throw new Error("frontend split operation materialization payload drift");
106
- }
107
- return { operation: existing, created: false };
108
- }
109
- const now = new Date().toISOString();
110
- const operation = {
111
- schemaVersion: 1,
112
- operationId: input.operationId,
113
- clientRequestId: `split:${input.operationId}`,
114
- action: input.action,
115
- actionParams: input.actionParams,
116
- payloadHash: input.payloadHash,
117
- state: "queued",
118
- createdAt: now,
119
- revision: 1,
120
- taskId: input.taskId,
121
- ...(input.cliArgs ? { cliArgs: input.cliArgs } : {}),
122
- };
123
- await writeSecureJson(operationFile(this.appData, input.operationId), operation);
124
- return { operation, created: true };
125
- });
126
- }
127
- async get(operationId) {
128
- return readJsonIfExists(operationFile(this.appData, operationId));
129
- }
130
- async save(operation) {
131
- return this.serialize(operation.operationId, async () => {
132
- const current = await this.get(operation.operationId);
133
- if (current?.revision !== undefined && operation.revision !== current.revision)
134
- throw new Error("operation revision may not be changed by save");
135
- if (operation.frontendHumanDecision !== undefined || current?.frontendHumanDecision !== undefined) {
136
- if (!current || JSON.stringify(operation) !== JSON.stringify(current))
137
- throw new Error("human-decision projection may only be mutated by canonical CAS");
138
- return current;
139
- }
140
- if (operation.frontendSplit !== undefined || current?.frontendSplit !== undefined) {
141
- if (!current || JSON.stringify(operation) !== JSON.stringify(current))
142
- throw new Error("split projection may only be mutated by compareAndSwapFrontendSplit");
143
- return current;
144
- }
145
- await writeSecureJson(operationFile(this.appData, operation.operationId), operation);
146
- return operation;
147
- });
148
- }
149
- async update(operationId, patch) {
150
- return this.serialize(operationId, async () => {
151
- const current = await this.get(operationId);
152
- if (!current) {
153
- throw new Error(`operation not found: ${operationId}`);
154
- }
155
- if ("frontendHumanDecision" in patch || (current.frontendHumanDecision !== undefined && ("state" in patch || "frontendExecution" in patch)))
156
- throw new Error("human-decision projection may only be mutated by canonical CAS");
157
- if ("frontendSplit" in patch || "revision" in patch || (current.frontendSplit !== undefined && ("state" in patch || "frontendExecution" in patch)))
158
- throw new Error("split projection may only be mutated by compareAndSwapFrontendSplit");
159
- const next = {
160
- ...current,
161
- ...patch,
162
- operationId: current.operationId,
163
- schemaVersion: 1,
164
- clientRequestId: current.clientRequestId,
165
- payloadHash: current.payloadHash,
166
- action: current.action,
167
- createdAt: current.createdAt,
168
- };
169
- await writeSecureJson(operationFile(this.appData, operationId), next);
170
- return next;
171
- });
172
- }
173
- async materializeFrontendHumanDecision(input) {
174
- return this.serialize(input.operationId, async () => {
175
- const current = await this.get(input.operationId);
176
- if (!current || current.revision === undefined || current.revision !== input.expectedRecordRevision) {
177
- const fallback = current?.frontendHumanDecision ?? buildFrontendHumanDecisionProjection({ status: "active", operationId: input.operationId, runId: input.envelope.runId, revision: Math.max(1, input.expectedRecordRevision) });
178
- return { outcome: "rejected", reason: "record revision conflict or legacy record", projection: fallback };
179
- }
180
- const projection = current.frontendHumanDecision ?? buildFrontendHumanDecisionProjection({ status: "active", operationId: current.operationId, runId: input.envelope.runId, revision: current.revision });
181
- const result = materializeFrontendHumanDecision({ projection, envelope: input.envelope, expectedRecordRevision: input.expectedRecordRevision, expectedProjectionDigest: input.expectedProjectionDigest });
182
- if (result.outcome !== "applied")
183
- return result;
184
- const record = { ...current, revision: result.projection.revision, frontendHumanDecision: result.projection, state: "running" };
185
- await writeSecureJson(operationFile(this.appData, current.operationId), record);
186
- return result;
187
- });
188
- }
189
- async consumeFrontendHumanDecision(input) {
190
- return this.serialize(input.operationId, async () => {
191
- const current = await this.get(input.operationId);
192
- if (!current || current.revision === undefined || !current.frontendHumanDecision) {
193
- const fallback = buildFrontendHumanDecisionProjection({ status: "active", operationId: input.operationId, runId: input.receipt.runId, revision: Math.max(1, input.expectedRecordRevision) });
194
- return { outcome: "rejected", reason: "record has no mutable human-decision projection", projection: fallback };
195
- }
196
- const projection = parseFrontendHumanDecisionProjection(current.frontendHumanDecision);
197
- if (current.revision !== input.expectedRecordRevision)
198
- return { outcome: "rejected", reason: "record revision conflict", projection };
199
- const result = consumeFrontendHumanDecision({ projection, receipt: input.receipt, expectedRecordRevision: input.expectedRecordRevision, expectedProjectionDigest: input.expectedProjectionDigest, currentTargetDigest: input.currentTargetDigest, now: input.now });
200
- if (result.outcome !== "applied")
201
- return result;
202
- const record = { ...current, revision: result.projection.revision, frontendHumanDecision: result.projection };
203
- await writeSecureJson(operationFile(this.appData, current.operationId), record);
204
- return result;
205
- });
206
- }
207
- async initializeFrontendHumanApprovedSplit(input) {
208
- return this.serialize(input.operationId, async () => {
209
- const current = await this.get(input.operationId);
210
- const fallback = current?.frontendHumanDecision ?? buildFrontendHumanDecisionProjection({ status: "active", operationId: input.operationId, runId: input.receipt.runId, revision: Math.max(1, input.expectedRecordRevision) });
211
- if (!current || current.revision === undefined || current.revision !== input.expectedRecordRevision || !current.frontendHumanDecision || !current.frontendExecution || current.frontendSplit)
212
- return { outcome: "rejected", reason: "record is not an authoritative pending single-task split", projection: fallback };
213
- const humanProjection = parseFrontendHumanDecisionProjection(current.frontendHumanDecision);
214
- if (humanProjection.status !== "blocked-human" || humanProjection.envelope.kind !== "split-materialization-approval" || humanProjection.digest !== input.expectedProjectionDigest)
215
- return { outcome: "rejected", reason: "pending split envelope conflict", projection: humanProjection };
216
- const receipt = parseFrontendHumanDecisionReceipt(input.receipt);
217
- if (receipt.kind !== "split-materialization-approval")
218
- return { outcome: "rejected", reason: "receipt is not a split approval", projection: humanProjection };
219
- if (JSON.stringify(current.frontendExecution) !== JSON.stringify(input.execution) || input.execution.kind !== "single-task")
220
- return { outcome: "rejected", reason: "single-task execution conflict", projection: humanProjection };
221
- const consumed = consumeFrontendHumanDecision({ projection: humanProjection, receipt, expectedRecordRevision: input.expectedRecordRevision, expectedProjectionDigest: input.expectedProjectionDigest, currentTargetDigest: input.currentTargetDigest, now: input.now });
222
- if (consumed.outcome !== "applied")
223
- return consumed;
224
- const initialized = initializeFrontendSplitParent({
225
- execution: input.execution,
226
- manifest: input.manifest,
227
- expectedOperationRevision: input.execution.operationRevision,
228
- successorOperationRevision: consumed.projection.revision,
229
- envelopeTargetDigest: humanProjection.envelope.targetDigest,
230
- activeWriterOperationId: input.activeWriterOperationId,
231
- activeProviderOperationId: input.activeProviderOperationId,
232
- authorization: { mode: "human", envelope: humanProjection.envelope, receipt },
233
- });
234
- if (initialized.outcome !== "applied")
235
- return { outcome: "rejected", reason: initialized.reason, projection: humanProjection };
236
- const splitProjection = frontendSplitProjectionSchema.parse({ revision: consumed.projection.revision, execution: initialized.execution, manifest: input.manifest, parent: initialized.parent });
237
- const { frontendExecution: _singleTask, ...withoutSingleTask } = current;
238
- const record = { ...withoutSingleTask, revision: consumed.projection.revision, frontendHumanDecision: consumed.projection, frontendSplit: splitProjection, state: "running" };
239
- await writeSecureJson(operationFile(this.appData, current.operationId), record);
240
- return { outcome: "applied", projection: splitProjection, humanDecision: consumed.projection };
241
- });
242
- }
243
- async compareAndSwapFrontendSplit(input) {
244
- return this.serialize(input.operationId, async () => {
245
- const current = await this.get(input.operationId);
246
- if (!current || current.revision === undefined || current.revision !== input.expectedRevision)
247
- return { outcome: "conflict" };
248
- const currentProjection = current.frontendSplit;
249
- if (currentProjection) {
250
- if (currentProjection.execution.digest !== input.expectedExecutionDigest || currentProjection.parent.digest !== input.expectedParentDigest)
251
- return { outcome: "conflict" };
252
- }
253
- else if (input.expectedExecutionDigest || input.expectedParentDigest)
254
- return { outcome: "conflict" };
255
- const next = currentProjection
256
- ? assertFrontendSplitProjectionSuccessor(currentProjection, input.next)
257
- : frontendSplitProjectionSchema.parse(input.next);
258
- if (next.revision !== current.revision + 1 || next.parent.operationId !== input.operationId)
259
- throw new Error("split CAS next revision or operation binding mismatch");
260
- const state = next.parent.operationState === "success" ? "succeeded" : next.parent.operationTerminal !== undefined ? "failed" : current.state;
261
- const record = { ...current, revision: next.revision, frontendSplit: next, state };
262
- await writeSecureJson(operationFile(this.appData, input.operationId), record);
263
- return { outcome: "applied", projection: next };
264
- });
265
- }
266
- async loadChildCloseoutFacts(input) {
267
- const factsDir = input.closeoutRef.ref;
268
- const facts = await readJsonIfExists(path.join(factsDir, "frontend-closeout-facts.json"));
269
- if (facts === undefined)
270
- return frontendSplitChildCloseoutFactsSchema.parse({ childId: input.childId, residualRisks: [], frontendTestHandoffRef: undefined });
271
- const parsedFacts = frontendCloseoutFactsSchema.parse(facts);
272
- if (computeFrontendSplitDigest(parsedFacts) !== input.closeoutRef.digest)
273
- throw new Error(`child closeout facts digest mismatch: ${input.childId}`);
274
- const handoff = await readJsonIfExists(path.join(factsDir, "frontend-test-handoff.json"));
275
- const frontendTestHandoffRef = handoff === undefined ? undefined : computeFrontendSplitDigest(frontendTestHandoffSchema.parse(handoff));
276
- return frontendSplitChildCloseoutFactsSchema.parse({ childId: input.childId, residualRisks: parsedFacts.residualRisks ?? [], frontendTestHandoffRef });
277
- }
278
- async settleFrontendSplitAggregate(input) {
279
- return this.serialize(input.operationId, async () => {
280
- const record = await this.get(input.operationId);
281
- if (!record || record.revision === undefined || record.revision !== input.expectedRevision || !record.frontendSplit)
282
- return { outcome: "conflict" };
283
- const authoritative = frontendSplitProjectionSchema.parse(record.frontendSplit);
284
- if (authoritative.parent.operationId !== input.operationId
285
- || authoritative.revision !== input.expectedRevision
286
- || authoritative.execution.digest !== input.expectedExecutionDigest
287
- || authoritative.parent.digest !== input.expectedParentDigest
288
- || authoritative.manifest.digest !== input.expectedManifestDigest
289
- || authoritative.candidateBinding?.digest !== input.expectedCandidateBindingDigest
290
- || authoritative.integrationBinding?.digest !== input.expectedIntegrationBindingDigest)
291
- return { outcome: "conflict" };
292
- if (!authoritative.candidateBinding)
293
- return { outcome: "conflict" };
294
- const expectedAggregate = buildFrontendSplitAggregateCloseout(authoritative.parent, authoritative.manifest, authoritative.candidateBinding, authoritative.integrationBinding, input.childCloseoutFacts);
295
- if (JSON.stringify(expectedAggregate) !== JSON.stringify(input.aggregate))
296
- return { outcome: "conflict" };
297
- const transaction = await input.prepareAggregate({
298
- operationId: authoritative.parent.operationId,
299
- aggregate: expectedAggregate,
300
- });
301
- try {
302
- const committedRef = frontendCommittedFactRefSchema.parse(transaction.committedRef);
303
- const finalized = finalizeFrontendSplitAggregate(authoritative.parent, expectedAggregate, committedRef);
304
- const next = assertFrontendSplitProjectionSuccessor(authoritative, { ...authoritative, revision: authoritative.revision + 1, parent: finalized.parent, execution: finalized.execution, aggregateCloseout: { value: expectedAggregate, committedRef } });
305
- const nextRecord = { ...record, revision: next.revision, frontendSplit: next, state: "succeeded" };
306
- await transaction.commit({
307
- parentRecordPath: operationFile(this.appData, record.operationId),
308
- parentRecord: nextRecord,
309
- });
310
- return { outcome: "applied", projection: next };
311
- }
312
- catch (error) {
313
- await transaction.rollback();
314
- throw error;
315
- }
316
- });
317
- }
318
- async initializeFrontendSplit(expectedRevision, projectionValue) {
319
- const projection = frontendSplitProjectionSchema.parse(projectionValue);
320
- return this.serialize(projection.parent.operationId, async () => {
321
- const current = await this.get(projection.parent.operationId);
322
- if (!current || current.revision === undefined || current.revision !== expectedRevision || current.frontendSplit !== undefined || projection.revision !== expectedRevision + 1)
323
- return { outcome: "conflict" };
324
- const record = { ...current, revision: projection.revision, frontendSplit: projection };
325
- await writeSecureJson(operationFile(this.appData, current.operationId), record);
326
- return { outcome: "applied", projection };
327
- });
328
- }
329
- async list() {
330
- const files = await listJsonFiles(this.appData.operations);
331
- const ops = [];
332
- for (const file of files) {
333
- const base = path.basename(file);
334
- if (base.startsWith("req-"))
335
- continue;
336
- const rec = await readJsonIfExists(file);
337
- if (rec?.operationId)
338
- ops.push(rec);
339
- }
340
- ops.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
341
- return ops;
342
- }
343
- /**
344
- * On Console boot: any non-terminal operation that cannot be proven still
345
- * running becomes needs-reconcile (never invent succeeded/failed).
346
- */
347
- async reconcileOnBoot(options) {
348
- const isAlive = options?.isProcessAlive ??
349
- ((pid) => {
350
- try {
351
- process.kill(pid, 0);
352
- return true;
353
- }
354
- catch {
355
- return false;
356
- }
357
- });
358
- const changed = [];
359
- for (const op of await this.list()) {
360
- if (TERMINAL_OPERATION_STATES.has(op.state))
361
- continue;
362
- if (op.state === "needs-reconcile")
363
- continue;
364
- let next;
365
- if (op.state === "running" &&
366
- typeof op.pid === "number" &&
367
- isAlive(op.pid, op.processStartIdentity)) {
368
- // still running — leave as-is
369
- continue;
370
- }
371
- // queued/starting/running without proven process → needs-reconcile
372
- next = await this.update(op.operationId, {
373
- state: "needs-reconcile",
374
- errorCode: "OPERATION_NEEDS_RECONCILE",
375
- errorMessage: "Console restart or lost process evidence; operation needs reconcile (not cancelled)",
376
- });
377
- changed.push(next);
378
- }
379
- return changed;
380
- }
381
- }
382
- export function isTerminalOperationState(state) {
383
- return TERMINAL_OPERATION_STATES.has(state);
384
- }
385
- export function clipPreview(text, max = 4096) {
386
- if (text.length <= max)
387
- return text;
388
- return `${text.slice(0, max)}\n…[truncated ${text.length - max} chars]`;
389
- }
@@ -1 +0,0 @@
1
- import{ag as o,ah as n}from"./mermaid.core-Cxg8kX8V.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};
@@ -1 +0,0 @@
1
- import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-0kkppM2j.js";import{_ as i}from"./mermaid.core-Cxg8kX8V.js";import"./chunk-5VM5RSS4-BnK6dC49.js";import"./chunk-XXDRQBXY-3iOSHdbM.js";import"./chunk-KBJHAD2P-CiVrxKHU.js";import"./chunk-2GRJ4B5K-D8K6adhU.js";import"./index-DLt4ZFvD.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};
@@ -1 +0,0 @@
1
- import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-0kkppM2j.js";import{_ as i}from"./mermaid.core-Cxg8kX8V.js";import"./chunk-5VM5RSS4-BnK6dC49.js";import"./chunk-XXDRQBXY-3iOSHdbM.js";import"./chunk-KBJHAD2P-CiVrxKHU.js";import"./chunk-2GRJ4B5K-D8K6adhU.js";import"./index-DLt4ZFvD.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};