agentic-orchestrator 0.1.6 → 0.1.8

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 (438) hide show
  1. package/.prettierignore +10 -0
  2. package/.prettierrc.json +24 -0
  3. package/CLAUDE.md +3 -2
  4. package/README.md +71 -48
  5. package/agentic/orchestrator/defaults/policy.defaults.yaml +1 -1
  6. package/agentic/orchestrator/prompts/planner.system.md +1 -0
  7. package/agentic/orchestrator/schemas/agents.schema.json +5 -22
  8. package/agentic/orchestrator/schemas/gates.schema.json +4 -19
  9. package/agentic/orchestrator/schemas/index.schema.json +3 -14
  10. package/agentic/orchestrator/schemas/multi-project.schema.json +2 -8
  11. package/agentic/orchestrator/schemas/plan.schema.json +6 -26
  12. package/agentic/orchestrator/schemas/policy.schema.json +19 -81
  13. package/agentic/orchestrator/schemas/policy.user.schema.json +1 -5
  14. package/agentic/orchestrator/schemas/qa_test_index.schema.json +5 -29
  15. package/agentic/orchestrator/schemas/state.schema.json +11 -61
  16. package/agentic/orchestrator/tools/catalog.json +33 -164
  17. package/agentic/orchestrator/tools/schemas/input/evidence.latest.input.schema.json +1 -3
  18. package/agentic/orchestrator/tools/schemas/input/feature.delete.input.schema.json +1 -5
  19. package/agentic/orchestrator/tools/schemas/input/feature.get_context.input.schema.json +1 -3
  20. package/agentic/orchestrator/tools/schemas/input/feature.init.input.schema.json +1 -4
  21. package/agentic/orchestrator/tools/schemas/input/feature.log_append.input.schema.json +1 -5
  22. package/agentic/orchestrator/tools/schemas/input/feature.ready_to_merge.input.schema.json +1 -6
  23. package/agentic/orchestrator/tools/schemas/input/feature.state_get.input.schema.json +1 -3
  24. package/agentic/orchestrator/tools/schemas/input/feature.state_patch.input.schema.json +1 -5
  25. package/agentic/orchestrator/tools/schemas/input/gates.run.input.schema.json +1 -5
  26. package/agentic/orchestrator/tools/schemas/input/locks.acquire.input.schema.json +1 -5
  27. package/agentic/orchestrator/tools/schemas/input/locks.release.input.schema.json +1 -5
  28. package/agentic/orchestrator/tools/schemas/input/performance.record_outcome.input.schema.json +10 -1
  29. package/agentic/orchestrator/tools/schemas/input/plan.get.input.schema.json +1 -3
  30. package/agentic/orchestrator/tools/schemas/input/plan.submit.input.schema.json +1 -5
  31. package/agentic/orchestrator/tools/schemas/input/plan.update.input.schema.json +1 -6
  32. package/agentic/orchestrator/tools/schemas/input/qa.test_index_get.input.schema.json +1 -3
  33. package/agentic/orchestrator/tools/schemas/input/qa.test_index_update.input.schema.json +1 -6
  34. package/agentic/orchestrator/tools/schemas/input/repo.apply_patch.input.schema.json +1 -5
  35. package/agentic/orchestrator/tools/schemas/input/repo.diff.input.schema.json +1 -3
  36. package/agentic/orchestrator/tools/schemas/input/repo.diff_bundle.input.schema.json +1 -3
  37. package/agentic/orchestrator/tools/schemas/input/repo.ensure_worktree.input.schema.json +1 -4
  38. package/agentic/orchestrator/tools/schemas/input/repo.read_file.input.schema.json +1 -4
  39. package/agentic/orchestrator/tools/schemas/input/repo.search.input.schema.json +1 -4
  40. package/agentic/orchestrator/tools/schemas/input/repo.status.input.schema.json +1 -3
  41. package/agentic/orchestrator/tools/schemas/input/report.feature_summary.input.schema.json +1 -3
  42. package/agentic/orchestrator/tools/schemas/output/collisions.scan.output.schema.json +1 -3
  43. package/agentic/orchestrator/tools/schemas/output/evidence.latest.output.schema.json +1 -4
  44. package/agentic/orchestrator/tools/schemas/output/feature.delete.output.schema.json +4 -20
  45. package/agentic/orchestrator/tools/schemas/output/feature.discover_specs.output.schema.json +2 -7
  46. package/agentic/orchestrator/tools/schemas/output/feature.get_context.output.schema.json +1 -8
  47. package/agentic/orchestrator/tools/schemas/output/feature.init.output.schema.json +1 -5
  48. package/agentic/orchestrator/tools/schemas/output/feature.log_append.output.schema.json +1 -5
  49. package/agentic/orchestrator/tools/schemas/output/feature.ready_to_merge.output.schema.json +1 -6
  50. package/agentic/orchestrator/tools/schemas/output/feature.state_get.output.schema.json +1 -4
  51. package/agentic/orchestrator/tools/schemas/output/feature.state_patch.output.schema.json +1 -5
  52. package/agentic/orchestrator/tools/schemas/output/gates.list.output.schema.json +2 -7
  53. package/agentic/orchestrator/tools/schemas/output/gates.run.output.schema.json +1 -8
  54. package/agentic/orchestrator/tools/schemas/output/locks.acquire.output.schema.json +1 -7
  55. package/agentic/orchestrator/tools/schemas/output/locks.release.output.schema.json +1 -5
  56. package/agentic/orchestrator/tools/schemas/output/performance.get_analytics.output.schema.json +22 -2
  57. package/agentic/orchestrator/tools/schemas/output/plan.get.output.schema.json +1 -4
  58. package/agentic/orchestrator/tools/schemas/output/plan.submit.output.schema.json +1 -5
  59. package/agentic/orchestrator/tools/schemas/output/plan.update.output.schema.json +1 -5
  60. package/agentic/orchestrator/tools/schemas/output/qa.test_index_get.output.schema.json +1 -5
  61. package/agentic/orchestrator/tools/schemas/output/qa.test_index_update.output.schema.json +1 -4
  62. package/agentic/orchestrator/tools/schemas/output/repo.apply_patch.output.schema.json +1 -6
  63. package/agentic/orchestrator/tools/schemas/output/repo.diff.output.schema.json +1 -4
  64. package/agentic/orchestrator/tools/schemas/output/repo.diff_bundle.output.schema.json +1 -7
  65. package/agentic/orchestrator/tools/schemas/output/repo.ensure_worktree.output.schema.json +1 -6
  66. package/agentic/orchestrator/tools/schemas/output/repo.read_file.output.schema.json +1 -5
  67. package/agentic/orchestrator/tools/schemas/output/repo.search.output.schema.json +1 -5
  68. package/agentic/orchestrator/tools/schemas/output/repo.status.output.schema.json +1 -5
  69. package/agentic/orchestrator/tools/schemas/output/report.dashboard.output.schema.json +1 -4
  70. package/apps/control-plane/scripts/validate-architecture-rules.mjs +16 -5
  71. package/apps/control-plane/scripts/validate-docker-mcp-contract.mjs +30 -8
  72. package/apps/control-plane/scripts/validate-mcp-contracts.ts +13 -7
  73. package/apps/control-plane/src/application/adapters/adapter-registry.ts +35 -15
  74. package/apps/control-plane/src/application/multi-project-loader.ts +27 -10
  75. package/apps/control-plane/src/application/services/activity-monitor-service.ts +26 -14
  76. package/apps/control-plane/src/application/services/collision-queue-service.ts +31 -17
  77. package/apps/control-plane/src/application/services/cost-tracking-service.ts +23 -16
  78. package/apps/control-plane/src/application/services/dependency-scheduler-service.ts +12 -4
  79. package/apps/control-plane/src/application/services/feature-deletion-service.ts +94 -58
  80. package/apps/control-plane/src/application/services/feature-lifecycle-service.ts +19 -13
  81. package/apps/control-plane/src/application/services/feature-state-service.ts +29 -19
  82. package/apps/control-plane/src/application/services/gate-interpolation-service.ts +7 -2
  83. package/apps/control-plane/src/application/services/gate-service.ts +64 -41
  84. package/apps/control-plane/src/application/services/instance-isolation-service.ts +1 -1
  85. package/apps/control-plane/src/application/services/issue-tracker-service.ts +49 -38
  86. package/apps/control-plane/src/application/services/lock-service.ts +75 -49
  87. package/apps/control-plane/src/application/services/merge-service.ts +91 -50
  88. package/apps/control-plane/src/application/services/notifier-service.ts +42 -20
  89. package/apps/control-plane/src/application/services/patch-service.ts +73 -44
  90. package/apps/control-plane/src/application/services/performance-analytics-service.ts +8 -6
  91. package/apps/control-plane/src/application/services/plan-service.ts +148 -89
  92. package/apps/control-plane/src/application/services/policy-loader-service.ts +10 -4
  93. package/apps/control-plane/src/application/services/pr-monitor-service.ts +33 -14
  94. package/apps/control-plane/src/application/services/qa-index-service.ts +20 -16
  95. package/apps/control-plane/src/application/services/reactions-service.ts +30 -15
  96. package/apps/control-plane/src/application/services/reporting-service.ts +16 -12
  97. package/apps/control-plane/src/application/services/run-lease-service.ts +138 -81
  98. package/apps/control-plane/src/application/tools/tool-metadata.ts +5 -5
  99. package/apps/control-plane/src/application/tools/tool-router.ts +6 -3
  100. package/apps/control-plane/src/cli/aop.ts +2 -2
  101. package/apps/control-plane/src/cli/attach-command-handler.ts +9 -9
  102. package/apps/control-plane/src/cli/cleanup-command-handler.ts +16 -11
  103. package/apps/control-plane/src/cli/cli-argument-parser.ts +6 -3
  104. package/apps/control-plane/src/cli/dashboard-command-handler.ts +28 -8
  105. package/apps/control-plane/src/cli/delete-command-handler.ts +7 -7
  106. package/apps/control-plane/src/cli/env-file.ts +115 -0
  107. package/apps/control-plane/src/cli/help-command-handler.ts +61 -32
  108. package/apps/control-plane/src/cli/init-command-handler.ts +182 -56
  109. package/apps/control-plane/src/cli/io.ts +7 -3
  110. package/apps/control-plane/src/cli/resume-command-handler.ts +21 -13
  111. package/apps/control-plane/src/cli/retry-command-handler.ts +12 -11
  112. package/apps/control-plane/src/cli/run-command-handler.ts +12 -8
  113. package/apps/control-plane/src/cli/send-command-handler.ts +6 -6
  114. package/apps/control-plane/src/cli/spec-ingestion-service.ts +14 -8
  115. package/apps/control-plane/src/cli/spec-input-resolver.ts +6 -1
  116. package/apps/control-plane/src/cli/spec-utils.ts +2 -2
  117. package/apps/control-plane/src/cli/status-command-handler.ts +13 -12
  118. package/apps/control-plane/src/cli/tooling.ts +3 -3
  119. package/apps/control-plane/src/cli/types.ts +1 -1
  120. package/apps/control-plane/src/core/collisions.ts +27 -10
  121. package/apps/control-plane/src/core/constants.ts +13 -7
  122. package/apps/control-plane/src/core/error-codes.ts +1 -1
  123. package/apps/control-plane/src/core/fs.ts +11 -5
  124. package/apps/control-plane/src/core/gates.ts +53 -27
  125. package/apps/control-plane/src/core/git.ts +18 -6
  126. package/apps/control-plane/src/core/kernel.ts +513 -227
  127. package/apps/control-plane/src/core/patch.ts +7 -3
  128. package/apps/control-plane/src/core/path-layout.ts +5 -1
  129. package/apps/control-plane/src/core/path-rules.ts +19 -5
  130. package/apps/control-plane/src/core/qa-index.ts +26 -12
  131. package/apps/control-plane/src/core/response.ts +9 -6
  132. package/apps/control-plane/src/core/schemas.ts +29 -10
  133. package/apps/control-plane/src/core/tool-caller.ts +1 -1
  134. package/apps/control-plane/src/core/workspace-hooks.ts +5 -5
  135. package/apps/control-plane/src/index.ts +3 -9
  136. package/apps/control-plane/src/interfaces/cli/bootstrap.ts +79 -35
  137. package/apps/control-plane/src/mcp/kernel-tool-executor.ts +7 -3
  138. package/apps/control-plane/src/mcp/mcp-server-adapter.ts +12 -10
  139. package/apps/control-plane/src/mcp/operation-ledger.ts +18 -8
  140. package/apps/control-plane/src/mcp/protocol-contract.ts +2 -2
  141. package/apps/control-plane/src/mcp/runtime-factory.ts +15 -6
  142. package/apps/control-plane/src/mcp/token-auth-verifier.ts +3 -2
  143. package/apps/control-plane/src/mcp/token-claims-validator.ts +11 -7
  144. package/apps/control-plane/src/mcp/tool-authorizer.ts +1 -3
  145. package/apps/control-plane/src/mcp/tool-client.ts +17 -5
  146. package/apps/control-plane/src/mcp/tool-contract-validator.ts +17 -8
  147. package/apps/control-plane/src/mcp/tool-registry-loader.ts +7 -3
  148. package/apps/control-plane/src/mcp/tool-runtime.ts +66 -39
  149. package/apps/control-plane/src/mcp/tools-markdown-generator.ts +6 -1
  150. package/apps/control-plane/src/providers/providers.ts +137 -54
  151. package/apps/control-plane/src/supervisor/build-wave-executor.ts +44 -25
  152. package/apps/control-plane/src/supervisor/planning-wave-executor.ts +46 -33
  153. package/apps/control-plane/src/supervisor/prompt-bundle-loader.ts +1 -1
  154. package/apps/control-plane/src/supervisor/qa-wave-executor.ts +38 -23
  155. package/apps/control-plane/src/supervisor/run-coordinator.ts +71 -36
  156. package/apps/control-plane/src/supervisor/runtime.ts +59 -35
  157. package/apps/control-plane/src/supervisor/session-orchestrator.ts +48 -31
  158. package/apps/control-plane/src/supervisor/types.ts +22 -7
  159. package/apps/control-plane/src/supervisor/worker-decision-loop.ts +30 -20
  160. package/apps/control-plane/test/activity-monitor.spec.ts +54 -30
  161. package/apps/control-plane/test/adapter-registry.spec.ts +5 -5
  162. package/apps/control-plane/test/aop.spec.ts +4 -4
  163. package/apps/control-plane/test/batch-operations.spec.ts +20 -18
  164. package/apps/control-plane/test/bootstrap-attach.spec.ts +52 -19
  165. package/apps/control-plane/test/bootstrap-edge-cases.spec.ts +58 -27
  166. package/apps/control-plane/test/bootstrap.spec.ts +72 -40
  167. package/apps/control-plane/test/cleanup-command.spec.ts +86 -32
  168. package/apps/control-plane/test/cli-helpers.spec.ts +119 -66
  169. package/apps/control-plane/test/cli.spec.ts +1 -1
  170. package/apps/control-plane/test/cli.unit.spec.ts +226 -167
  171. package/apps/control-plane/test/collision-queue.spec.ts +49 -40
  172. package/apps/control-plane/test/collisions.spec.ts +30 -30
  173. package/apps/control-plane/test/core-utils.spec.ts +29 -15
  174. package/apps/control-plane/test/cost-tracking.spec.ts +38 -22
  175. package/apps/control-plane/test/dashboard-api.integration.spec.ts +68 -36
  176. package/apps/control-plane/test/dashboard-client.spec.ts +18 -12
  177. package/apps/control-plane/test/dashboard-command.spec.ts +11 -7
  178. package/apps/control-plane/test/delete-command-handler.spec.ts +49 -41
  179. package/apps/control-plane/test/dependency-scheduler.spec.ts +47 -20
  180. package/apps/control-plane/test/epoch-tracking.spec.ts +9 -9
  181. package/apps/control-plane/test/feature-deletion-service.spec.ts +60 -52
  182. package/apps/control-plane/test/feature-lifecycle.spec.ts +36 -17
  183. package/apps/control-plane/test/gates.spec.ts +101 -81
  184. package/apps/control-plane/test/git-spawn-error.spec.ts +1 -1
  185. package/apps/control-plane/test/helpers.ts +10 -6
  186. package/apps/control-plane/test/incremental-gates.spec.ts +59 -20
  187. package/apps/control-plane/test/init-wizard.spec.ts +328 -68
  188. package/apps/control-plane/test/instance-isolation.spec.ts +43 -10
  189. package/apps/control-plane/test/issue-tracker.spec.ts +368 -128
  190. package/apps/control-plane/test/kernel-collision-replay.spec.ts +50 -29
  191. package/apps/control-plane/test/kernel.branches.spec.ts +64 -40
  192. package/apps/control-plane/test/kernel.coverage.spec.ts +85 -49
  193. package/apps/control-plane/test/kernel.coverage2.spec.ts +109 -65
  194. package/apps/control-plane/test/kernel.spec.ts +134 -51
  195. package/apps/control-plane/test/lock-service.spec.ts +92 -68
  196. package/apps/control-plane/test/mcp-helpers.spec.ts +53 -39
  197. package/apps/control-plane/test/mcp.spec.ts +231 -115
  198. package/apps/control-plane/test/merge-service.spec.ts +142 -94
  199. package/apps/control-plane/test/multi-project.spec.ts +28 -22
  200. package/apps/control-plane/test/notifier-service.spec.ts +136 -92
  201. package/apps/control-plane/test/parallel-gates.spec.ts +51 -35
  202. package/apps/control-plane/test/patch-service.spec.ts +128 -48
  203. package/apps/control-plane/test/performance-analytics.spec.ts +99 -63
  204. package/apps/control-plane/test/plan-service.spec.ts +50 -39
  205. package/apps/control-plane/test/planning-wave-executor.spec.ts +95 -71
  206. package/apps/control-plane/test/policy-loader-service.spec.ts +41 -19
  207. package/apps/control-plane/test/pr-monitor.spec.ts +113 -64
  208. package/apps/control-plane/test/providers.spec.ts +208 -104
  209. package/apps/control-plane/test/qa-index-service.spec.ts +31 -33
  210. package/apps/control-plane/test/qa-index.spec.ts +58 -61
  211. package/apps/control-plane/test/reactions.spec.ts +88 -45
  212. package/apps/control-plane/test/response.spec.ts +5 -5
  213. package/apps/control-plane/test/resume-command.spec.ts +121 -80
  214. package/apps/control-plane/test/run-coordinator.spec.ts +205 -136
  215. package/apps/control-plane/test/schema-date-time.spec.ts +49 -41
  216. package/apps/control-plane/test/service-retry-paths.spec.ts +77 -57
  217. package/apps/control-plane/test/services.spec.ts +147 -129
  218. package/apps/control-plane/test/session-management.spec.ts +136 -74
  219. package/apps/control-plane/test/spec-ingestion.spec.ts +23 -21
  220. package/apps/control-plane/test/spec-input-resolver.spec.ts +11 -10
  221. package/apps/control-plane/test/supervisor-collaborators.spec.ts +168 -121
  222. package/apps/control-plane/test/supervisor.calltool.spec.ts +21 -18
  223. package/apps/control-plane/test/supervisor.spec.ts +67 -43
  224. package/apps/control-plane/test/supervisor.unit.spec.ts +195 -126
  225. package/apps/control-plane/test/token-auth-verifier.spec.ts +29 -14
  226. package/apps/control-plane/test/tool-registry-loader.spec.ts +51 -27
  227. package/apps/control-plane/test/tool-runtime.spec.ts +63 -46
  228. package/apps/control-plane/test/worker-decision-loop.spec.ts +143 -122
  229. package/apps/control-plane/test/workspace-hooks.spec.ts +61 -23
  230. package/apps/control-plane/tsconfig.build.json +2 -7
  231. package/apps/control-plane/tsconfig.json +1 -5
  232. package/apps/control-plane/vitest.config.ts +7 -7
  233. package/config/agentic/orchestrator/adapters.yaml +3 -0
  234. package/config/agentic/orchestrator/agents.yaml +14 -0
  235. package/config/agentic/orchestrator/gates.yaml +28 -0
  236. package/config/agentic/orchestrator/policy.yaml +22 -0
  237. package/config/agentic/orchestrator/prompts/builder.system.md +1 -0
  238. package/config/agentic/orchestrator/prompts/planner.system.md +16 -0
  239. package/config/agentic/orchestrator/prompts/qa.system.md +1 -0
  240. package/dist/apps/control-plane/application/adapters/adapter-registry.js +12 -5
  241. package/dist/apps/control-plane/application/adapters/adapter-registry.js.map +1 -1
  242. package/dist/apps/control-plane/application/multi-project-loader.js +26 -9
  243. package/dist/apps/control-plane/application/multi-project-loader.js.map +1 -1
  244. package/dist/apps/control-plane/application/services/activity-monitor-service.js +7 -7
  245. package/dist/apps/control-plane/application/services/activity-monitor-service.js.map +1 -1
  246. package/dist/apps/control-plane/application/services/collision-queue-service.js +7 -7
  247. package/dist/apps/control-plane/application/services/collision-queue-service.js.map +1 -1
  248. package/dist/apps/control-plane/application/services/cost-tracking-service.js +6 -8
  249. package/dist/apps/control-plane/application/services/cost-tracking-service.js.map +1 -1
  250. package/dist/apps/control-plane/application/services/dependency-scheduler-service.js.map +1 -1
  251. package/dist/apps/control-plane/application/services/feature-deletion-service.js +37 -29
  252. package/dist/apps/control-plane/application/services/feature-deletion-service.js.map +1 -1
  253. package/dist/apps/control-plane/application/services/feature-lifecycle-service.js +10 -10
  254. package/dist/apps/control-plane/application/services/feature-lifecycle-service.js.map +1 -1
  255. package/dist/apps/control-plane/application/services/feature-state-service.js +11 -11
  256. package/dist/apps/control-plane/application/services/feature-state-service.js.map +1 -1
  257. package/dist/apps/control-plane/application/services/gate-interpolation-service.js +3 -1
  258. package/dist/apps/control-plane/application/services/gate-interpolation-service.js.map +1 -1
  259. package/dist/apps/control-plane/application/services/gate-service.js +26 -26
  260. package/dist/apps/control-plane/application/services/gate-service.js.map +1 -1
  261. package/dist/apps/control-plane/application/services/instance-isolation-service.js +1 -1
  262. package/dist/apps/control-plane/application/services/instance-isolation-service.js.map +1 -1
  263. package/dist/apps/control-plane/application/services/issue-tracker-service.js +25 -15
  264. package/dist/apps/control-plane/application/services/issue-tracker-service.js.map +1 -1
  265. package/dist/apps/control-plane/application/services/lock-service.js +32 -32
  266. package/dist/apps/control-plane/application/services/lock-service.js.map +1 -1
  267. package/dist/apps/control-plane/application/services/merge-service.js +41 -27
  268. package/dist/apps/control-plane/application/services/merge-service.js.map +1 -1
  269. package/dist/apps/control-plane/application/services/notifier-service.js +29 -15
  270. package/dist/apps/control-plane/application/services/notifier-service.js.map +1 -1
  271. package/dist/apps/control-plane/application/services/patch-service.js +21 -19
  272. package/dist/apps/control-plane/application/services/patch-service.js.map +1 -1
  273. package/dist/apps/control-plane/application/services/performance-analytics-service.js +4 -4
  274. package/dist/apps/control-plane/application/services/performance-analytics-service.js.map +1 -1
  275. package/dist/apps/control-plane/application/services/plan-service.js +33 -33
  276. package/dist/apps/control-plane/application/services/plan-service.js.map +1 -1
  277. package/dist/apps/control-plane/application/services/policy-loader-service.js.map +1 -1
  278. package/dist/apps/control-plane/application/services/pr-monitor-service.js +23 -11
  279. package/dist/apps/control-plane/application/services/pr-monitor-service.js.map +1 -1
  280. package/dist/apps/control-plane/application/services/qa-index-service.js +11 -11
  281. package/dist/apps/control-plane/application/services/qa-index-service.js.map +1 -1
  282. package/dist/apps/control-plane/application/services/reactions-service.js +13 -9
  283. package/dist/apps/control-plane/application/services/reactions-service.js.map +1 -1
  284. package/dist/apps/control-plane/application/services/reporting-service.js +11 -9
  285. package/dist/apps/control-plane/application/services/reporting-service.js.map +1 -1
  286. package/dist/apps/control-plane/application/services/run-lease-service.js +34 -33
  287. package/dist/apps/control-plane/application/services/run-lease-service.js.map +1 -1
  288. package/dist/apps/control-plane/application/tools/tool-metadata.js +2 -2
  289. package/dist/apps/control-plane/application/tools/tool-router.js.map +1 -1
  290. package/dist/apps/control-plane/cli/attach-command-handler.js +9 -9
  291. package/dist/apps/control-plane/cli/cleanup-command-handler.js +11 -9
  292. package/dist/apps/control-plane/cli/cleanup-command-handler.js.map +1 -1
  293. package/dist/apps/control-plane/cli/cli-argument-parser.js +4 -3
  294. package/dist/apps/control-plane/cli/cli-argument-parser.js.map +1 -1
  295. package/dist/apps/control-plane/cli/dashboard-command-handler.js +23 -7
  296. package/dist/apps/control-plane/cli/dashboard-command-handler.js.map +1 -1
  297. package/dist/apps/control-plane/cli/delete-command-handler.js +7 -7
  298. package/dist/apps/control-plane/cli/env-file.d.ts +4 -0
  299. package/dist/apps/control-plane/cli/env-file.js +89 -0
  300. package/dist/apps/control-plane/cli/env-file.js.map +1 -0
  301. package/dist/apps/control-plane/cli/help-command-handler.js +58 -30
  302. package/dist/apps/control-plane/cli/help-command-handler.js.map +1 -1
  303. package/dist/apps/control-plane/cli/init-command-handler.js +97 -37
  304. package/dist/apps/control-plane/cli/init-command-handler.js.map +1 -1
  305. package/dist/apps/control-plane/cli/io.js +2 -2
  306. package/dist/apps/control-plane/cli/io.js.map +1 -1
  307. package/dist/apps/control-plane/cli/resume-command-handler.js +9 -9
  308. package/dist/apps/control-plane/cli/resume-command-handler.js.map +1 -1
  309. package/dist/apps/control-plane/cli/retry-command-handler.js +12 -11
  310. package/dist/apps/control-plane/cli/retry-command-handler.js.map +1 -1
  311. package/dist/apps/control-plane/cli/run-command-handler.js +12 -8
  312. package/dist/apps/control-plane/cli/run-command-handler.js.map +1 -1
  313. package/dist/apps/control-plane/cli/send-command-handler.js +6 -6
  314. package/dist/apps/control-plane/cli/spec-ingestion-service.js +10 -8
  315. package/dist/apps/control-plane/cli/spec-ingestion-service.js.map +1 -1
  316. package/dist/apps/control-plane/cli/spec-input-resolver.js.map +1 -1
  317. package/dist/apps/control-plane/cli/spec-utils.js.map +1 -1
  318. package/dist/apps/control-plane/cli/status-command-handler.js +8 -8
  319. package/dist/apps/control-plane/cli/status-command-handler.js.map +1 -1
  320. package/dist/apps/control-plane/cli/tooling.js +1 -1
  321. package/dist/apps/control-plane/core/collisions.js +11 -8
  322. package/dist/apps/control-plane/core/collisions.js.map +1 -1
  323. package/dist/apps/control-plane/core/constants.js +13 -7
  324. package/dist/apps/control-plane/core/constants.js.map +1 -1
  325. package/dist/apps/control-plane/core/error-codes.js +1 -1
  326. package/dist/apps/control-plane/core/fs.js.map +1 -1
  327. package/dist/apps/control-plane/core/gates.d.ts +2 -2
  328. package/dist/apps/control-plane/core/gates.js +26 -19
  329. package/dist/apps/control-plane/core/gates.js.map +1 -1
  330. package/dist/apps/control-plane/core/git.js +3 -3
  331. package/dist/apps/control-plane/core/git.js.map +1 -1
  332. package/dist/apps/control-plane/core/kernel.d.ts +1 -0
  333. package/dist/apps/control-plane/core/kernel.js +134 -81
  334. package/dist/apps/control-plane/core/kernel.js.map +1 -1
  335. package/dist/apps/control-plane/core/patch.js +7 -3
  336. package/dist/apps/control-plane/core/patch.js.map +1 -1
  337. package/dist/apps/control-plane/core/path-layout.d.ts +1 -0
  338. package/dist/apps/control-plane/core/path-layout.js +4 -1
  339. package/dist/apps/control-plane/core/path-layout.js.map +1 -1
  340. package/dist/apps/control-plane/core/path-rules.js +3 -1
  341. package/dist/apps/control-plane/core/path-rules.js.map +1 -1
  342. package/dist/apps/control-plane/core/qa-index.js +5 -5
  343. package/dist/apps/control-plane/core/qa-index.js.map +1 -1
  344. package/dist/apps/control-plane/core/response.js +3 -3
  345. package/dist/apps/control-plane/core/response.js.map +1 -1
  346. package/dist/apps/control-plane/core/schemas.js +10 -6
  347. package/dist/apps/control-plane/core/schemas.js.map +1 -1
  348. package/dist/apps/control-plane/core/workspace-hooks.js +3 -3
  349. package/dist/apps/control-plane/index.d.ts +1 -1
  350. package/dist/apps/control-plane/index.js +1 -1
  351. package/dist/apps/control-plane/index.js.map +1 -1
  352. package/dist/apps/control-plane/interfaces/cli/bootstrap.js +40 -23
  353. package/dist/apps/control-plane/interfaces/cli/bootstrap.js.map +1 -1
  354. package/dist/apps/control-plane/mcp/kernel-tool-executor.js +1 -1
  355. package/dist/apps/control-plane/mcp/kernel-tool-executor.js.map +1 -1
  356. package/dist/apps/control-plane/mcp/mcp-server-adapter.js +6 -7
  357. package/dist/apps/control-plane/mcp/mcp-server-adapter.js.map +1 -1
  358. package/dist/apps/control-plane/mcp/operation-ledger.js +5 -5
  359. package/dist/apps/control-plane/mcp/operation-ledger.js.map +1 -1
  360. package/dist/apps/control-plane/mcp/protocol-contract.js +2 -2
  361. package/dist/apps/control-plane/mcp/runtime-factory.js +2 -2
  362. package/dist/apps/control-plane/mcp/runtime-factory.js.map +1 -1
  363. package/dist/apps/control-plane/mcp/token-auth-verifier.js +1 -1
  364. package/dist/apps/control-plane/mcp/token-auth-verifier.js.map +1 -1
  365. package/dist/apps/control-plane/mcp/token-claims-validator.js +5 -5
  366. package/dist/apps/control-plane/mcp/token-claims-validator.js.map +1 -1
  367. package/dist/apps/control-plane/mcp/tool-authorizer.js +1 -3
  368. package/dist/apps/control-plane/mcp/tool-authorizer.js.map +1 -1
  369. package/dist/apps/control-plane/mcp/tool-client.js +2 -2
  370. package/dist/apps/control-plane/mcp/tool-client.js.map +1 -1
  371. package/dist/apps/control-plane/mcp/tool-contract-validator.js +3 -3
  372. package/dist/apps/control-plane/mcp/tool-contract-validator.js.map +1 -1
  373. package/dist/apps/control-plane/mcp/tool-registry-loader.js +1 -1
  374. package/dist/apps/control-plane/mcp/tool-registry-loader.js.map +1 -1
  375. package/dist/apps/control-plane/mcp/tool-runtime.js +17 -17
  376. package/dist/apps/control-plane/mcp/tool-runtime.js.map +1 -1
  377. package/dist/apps/control-plane/mcp/tools-markdown-generator.js +6 -1
  378. package/dist/apps/control-plane/mcp/tools-markdown-generator.js.map +1 -1
  379. package/dist/apps/control-plane/providers/providers.d.ts +3 -2
  380. package/dist/apps/control-plane/providers/providers.js +81 -39
  381. package/dist/apps/control-plane/providers/providers.js.map +1 -1
  382. package/dist/apps/control-plane/supervisor/build-wave-executor.js +12 -12
  383. package/dist/apps/control-plane/supervisor/build-wave-executor.js.map +1 -1
  384. package/dist/apps/control-plane/supervisor/planning-wave-executor.js +19 -16
  385. package/dist/apps/control-plane/supervisor/planning-wave-executor.js.map +1 -1
  386. package/dist/apps/control-plane/supervisor/prompt-bundle-loader.js +1 -1
  387. package/dist/apps/control-plane/supervisor/qa-wave-executor.js +13 -13
  388. package/dist/apps/control-plane/supervisor/qa-wave-executor.js.map +1 -1
  389. package/dist/apps/control-plane/supervisor/run-coordinator.js +37 -20
  390. package/dist/apps/control-plane/supervisor/run-coordinator.js.map +1 -1
  391. package/dist/apps/control-plane/supervisor/runtime.js +25 -21
  392. package/dist/apps/control-plane/supervisor/runtime.js.map +1 -1
  393. package/dist/apps/control-plane/supervisor/session-orchestrator.js +29 -23
  394. package/dist/apps/control-plane/supervisor/session-orchestrator.js.map +1 -1
  395. package/dist/apps/control-plane/supervisor/types.d.ts +3 -3
  396. package/dist/apps/control-plane/supervisor/types.js.map +1 -1
  397. package/dist/apps/control-plane/supervisor/worker-decision-loop.js +14 -16
  398. package/dist/apps/control-plane/supervisor/worker-decision-loop.js.map +1 -1
  399. package/eslint.config.mjs +20 -20
  400. package/example-configurations/README.md +1 -1
  401. package/example-configurations/java/agents.yaml +3 -3
  402. package/example-configurations/java/policy.yaml +1 -1
  403. package/example-configurations/node/agents.yaml +3 -3
  404. package/example-configurations/node/policy.yaml +1 -1
  405. package/package.json +10 -5
  406. package/packages/web-dashboard/next.config.js +2 -2
  407. package/packages/web-dashboard/src/app/api/actions/route.ts +25 -9
  408. package/packages/web-dashboard/src/app/api/events/route.ts +20 -6
  409. package/packages/web-dashboard/src/app/api/features/[id]/checkout/route.ts +88 -37
  410. package/packages/web-dashboard/src/app/api/features/[id]/evidence/[artifact]/route.ts +8 -5
  411. package/packages/web-dashboard/src/app/api/features/[id]/review/route.ts +27 -9
  412. package/packages/web-dashboard/src/app/api/features/[id]/route.ts +5 -2
  413. package/packages/web-dashboard/src/app/api/projects/route.ts +5 -5
  414. package/packages/web-dashboard/src/app/globals.css +10 -2
  415. package/packages/web-dashboard/src/app/page.tsx +100 -37
  416. package/packages/web-dashboard/src/lib/aop-client.ts +68 -37
  417. package/packages/web-dashboard/src/lib/multi-project-config.ts +28 -7
  418. package/packages/web-dashboard/src/lib/orchestrator-tools.ts +59 -36
  419. package/packages/web-dashboard/tsconfig.json +3 -11
  420. package/scripts/nx-safe.mjs +10 -10
  421. package/spec-files/completed/agentic_orchestrator_cli_delete_command_spec.md +5 -0
  422. package/spec-files/completed/agentic_orchestrator_feature_gaps_closure_spec.md +189 -90
  423. package/spec-files/completed/agentic_orchestrator_init_policy_ux_simplification_spec.md +49 -16
  424. package/spec-files/completed/agentic_orchestrator_mcp_formalization_spec.md +24 -1
  425. package/spec-files/completed/agentic_orchestrator_single_global_orchestrator_spec.md +9 -0
  426. package/spec-files/completed/agentic_orchestrator_spec.md +171 -75
  427. package/spec-files/completed/agentic_orchestrator_validator_hardening_spec.md +25 -17
  428. package/spec-files/outstanding/agentic_orchestrator_artifact_database_publishing_spec.md +40 -5
  429. package/spec-files/outstanding/agentic_orchestrator_enterprise_governance_dashboard_spec.md +23 -12
  430. package/spec-files/outstanding/agentic_orchestrator_knowledge_canary_spec.md +16 -4
  431. package/spec-files/outstanding/agentic_orchestrator_observability_integrity_diagnostics_spec.md +42 -2
  432. package/spec-files/outstanding/agentic_orchestrator_performance_improvements_spec.md +209 -130
  433. package/spec-files/outstanding/agentic_orchestrator_planning_review_quality_spec.md +56 -3
  434. package/spec-files/outstanding/agentic_orchestrator_productization_commercial_spec.md +77 -10
  435. package/spec-files/outstanding/agentic_orchestrator_provider_auth_bootstrap_spec.md +384 -0
  436. package/spec-files/outstanding/agentic_orchestrator_quality_adoption_execution_spec.md +29 -14
  437. package/spec-files/progress.md +186 -175
  438. package/tsconfig.json +2 -8
@@ -22,14 +22,14 @@ function makeQaIndex() {
22
22
  {
23
23
  start_line: 1,
24
24
  end_line: 1,
25
- change_type: 'modify'
26
- }
25
+ change_type: 'modify',
26
+ },
27
27
  ],
28
28
  required_tests: ['default:fast:test'],
29
29
  status: 'pending',
30
- last_run_at: '2026-02-28T12:00:00Z'
31
- }
32
- ]
30
+ last_run_at: '2026-02-28T12:00:00Z',
31
+ },
32
+ ],
33
33
  };
34
34
  }
35
35
 
@@ -44,8 +44,8 @@ describe('Schema date-time enforcement', () => {
44
44
  ...index,
45
45
  runtime_sessions: {
46
46
  ...index.runtime_sessions,
47
- started_at: '2026-02-30T25:61:61Z'
48
- }
47
+ started_at: '2026-02-30T25:61:61Z',
48
+ },
49
49
  };
50
50
  const startedAtValidation = await kernel.validateSchema('index.schema.json', startedAtInvalid);
51
51
  expect(startedAtValidation.valid).toBe(false);
@@ -53,9 +53,9 @@ describe('Schema date-time enforcement', () => {
53
53
  expect.arrayContaining([
54
54
  expect.objectContaining({
55
55
  keyword: 'format',
56
- instancePath: '/runtime_sessions/started_at'
57
- })
58
- ])
56
+ instancePath: '/runtime_sessions/started_at',
57
+ }),
58
+ ]),
59
59
  );
60
60
 
61
61
  const leaseInvalid = {
@@ -63,9 +63,9 @@ describe('Schema date-time enforcement', () => {
63
63
  runtime_sessions: {
64
64
  ...index.runtime_sessions,
65
65
  last_heartbeat_at: 'bad-timestamp',
66
- lease_expires_at: '2026-01-01 12:00:00'
66
+ lease_expires_at: '2026-01-01 12:00:00',
67
67
  },
68
- updated_at: 'not-a-date'
68
+ updated_at: 'not-a-date',
69
69
  };
70
70
  const leaseValidation = await kernel.validateSchema('index.schema.json', leaseInvalid);
71
71
  expect(leaseValidation.valid).toBe(false);
@@ -73,17 +73,17 @@ describe('Schema date-time enforcement', () => {
73
73
  expect.arrayContaining([
74
74
  expect.objectContaining({
75
75
  keyword: 'format',
76
- instancePath: '/runtime_sessions/last_heartbeat_at'
76
+ instancePath: '/runtime_sessions/last_heartbeat_at',
77
77
  }),
78
78
  expect.objectContaining({
79
79
  keyword: 'format',
80
- instancePath: '/runtime_sessions/lease_expires_at'
80
+ instancePath: '/runtime_sessions/lease_expires_at',
81
81
  }),
82
82
  expect.objectContaining({
83
83
  keyword: 'format',
84
- instancePath: '/updated_at'
85
- })
86
- ])
84
+ instancePath: '/updated_at',
85
+ }),
86
+ ]),
87
87
  );
88
88
 
89
89
  const qaInvalid = makeQaIndex();
@@ -94,9 +94,9 @@ describe('Schema date-time enforcement', () => {
94
94
  expect.arrayContaining([
95
95
  expect.objectContaining({
96
96
  keyword: 'format',
97
- instancePath: '/items/0/last_run_at'
98
- })
99
- ])
97
+ instancePath: '/items/0/last_run_at',
98
+ }),
99
+ ]),
100
100
  );
101
101
 
102
102
  const qaValid = await kernel.validateSchema('qa_test_index.schema.json', makeQaIndex());
@@ -111,21 +111,29 @@ describe('Schema date-time enforcement', () => {
111
111
  await expect(
112
112
  kernel.writeIndex({
113
113
  ...index,
114
- updated_at: 'invalid-datetime'
115
- })
114
+ updated_at: 'invalid-datetime',
115
+ }),
116
116
  ).rejects.toMatchObject({
117
117
  normalizedResponse: {
118
118
  error: {
119
- code: 'index_validation_failed'
120
- }
121
- }
119
+ code: 'index_validation_failed',
120
+ },
121
+ },
122
122
  });
123
123
 
124
124
  await writeFeatureSpec(repoRoot, 'feature_dt');
125
- const init = await kernel.invoke('feature.init', { feature_id: 'feature_dt' }, { actor_type: 'orchestrator', actor_id: 'dt' });
125
+ const init = await kernel.invoke(
126
+ 'feature.init',
127
+ { feature_id: 'feature_dt' },
128
+ { actor_type: 'orchestrator', actor_id: 'dt' },
129
+ );
126
130
  expect(init.ok).toBe(true);
127
131
 
128
- const state = await kernel.invoke('feature.state_get', { feature_id: 'feature_dt' }, { actor_type: 'orchestrator', actor_id: 'dt' });
132
+ const state = await kernel.invoke(
133
+ 'feature.state_get',
134
+ { feature_id: 'feature_dt' },
135
+ { actor_type: 'orchestrator', actor_id: 'dt' },
136
+ );
129
137
  expect(state.ok).toBe(true);
130
138
 
131
139
  await expect(
@@ -133,16 +141,16 @@ describe('Schema date-time enforcement', () => {
133
141
  'feature_dt',
134
142
  {
135
143
  ...state.data.front_matter,
136
- last_updated: '2026-13-55T25:00:00Z'
144
+ last_updated: '2026-13-55T25:00:00Z',
137
145
  },
138
- state.data.body
139
- )
146
+ state.data.body,
147
+ ),
140
148
  ).rejects.toMatchObject({
141
149
  normalizedResponse: {
142
150
  error: {
143
- code: 'state_validation_failed'
144
- }
145
- }
151
+ code: 'state_validation_failed',
152
+ },
153
+ },
146
154
  });
147
155
 
148
156
  const qaPath = path.join(repoRoot, '.aop', 'features', 'feature_dt', 'qa_test_index.json');
@@ -154,7 +162,7 @@ describe('Schema date-time enforcement', () => {
154
162
  const qaRead = await kernel.invoke(
155
163
  'qa.test_index_get',
156
164
  { feature_id: 'feature_dt' },
157
- { actor_type: 'qa', actor_id: 'dt' }
165
+ { actor_type: 'qa', actor_id: 'dt' },
158
166
  );
159
167
  expect(qaRead.ok).toBe(false);
160
168
  expect(qaRead.error.code).toBe('internal_error');
@@ -162,9 +170,9 @@ describe('Schema date-time enforcement', () => {
162
170
  expect.arrayContaining([
163
171
  expect.objectContaining({
164
172
  keyword: 'format',
165
- instancePath: '/items/0/last_run_at'
166
- })
167
- ])
173
+ instancePath: '/items/0/last_run_at',
174
+ }),
175
+ ]),
168
176
  );
169
177
  });
170
178
  });
@@ -176,7 +184,7 @@ describe('isStrictRfc3339DateTime additional branches', () => {
176
184
  const index = await kernel.readIndex();
177
185
  const result = await kernel.validateSchema('index.schema.json', {
178
186
  ...index,
179
- runtime_sessions: { ...index.runtime_sessions, started_at: '2026-02-30T12:00:00Z' }
187
+ runtime_sessions: { ...index.runtime_sessions, started_at: '2026-02-30T12:00:00Z' },
180
188
  });
181
189
  expect(result.valid).toBe(false);
182
190
  });
@@ -187,7 +195,7 @@ describe('isStrictRfc3339DateTime additional branches', () => {
187
195
  const index = await kernel.readIndex();
188
196
  const result = await kernel.validateSchema('index.schema.json', {
189
197
  ...index,
190
- runtime_sessions: { ...index.runtime_sessions, started_at: '2026-01-15T24:00:00Z' }
198
+ runtime_sessions: { ...index.runtime_sessions, started_at: '2026-01-15T24:00:00Z' },
191
199
  });
192
200
  expect(result.valid).toBe(false);
193
201
  });
@@ -198,7 +206,7 @@ describe('isStrictRfc3339DateTime additional branches', () => {
198
206
  const index = await kernel.readIndex();
199
207
  const result = await kernel.validateSchema('index.schema.json', {
200
208
  ...index,
201
- runtime_sessions: { ...index.runtime_sessions, started_at: '2026-01-15T12:00:00+24:00' }
209
+ runtime_sessions: { ...index.runtime_sessions, started_at: '2026-01-15T12:00:00+24:00' },
202
210
  });
203
211
  expect(result.valid).toBe(false);
204
212
  });
@@ -209,7 +217,7 @@ describe('isStrictRfc3339DateTime additional branches', () => {
209
217
  const index = await kernel.readIndex();
210
218
  const result = await kernel.validateSchema('index.schema.json', {
211
219
  ...index,
212
- runtime_sessions: { ...index.runtime_sessions, started_at: '2026-01-00T12:00:00Z' }
220
+ runtime_sessions: { ...index.runtime_sessions, started_at: '2026-01-00T12:00:00Z' },
213
221
  });
214
222
  expect(result.valid).toBe(false);
215
223
  });
@@ -1,11 +1,11 @@
1
1
  import { beforeEach, describe, expect, it, vi } from 'vitest';
2
2
 
3
3
  vi.mock('../src/core/gates.js', () => ({
4
- runGateMode: vi.fn()
4
+ runGateMode: vi.fn(),
5
5
  }));
6
6
 
7
7
  vi.mock('../src/core/git.js', () => ({
8
- runGit: vi.fn()
8
+ runGit: vi.fn(),
9
9
  }));
10
10
 
11
11
  import { FeatureStateService } from '../src/application/services/feature-state-service.js';
@@ -29,7 +29,7 @@ function commandResult(overrides: Partial<Awaited<ReturnType<typeof runGit>>> =
29
29
  stdout: '',
30
30
  stderr: '',
31
31
  timeout: false,
32
- ...overrides
32
+ ...overrides,
33
33
  };
34
34
  }
35
35
 
@@ -43,24 +43,25 @@ describe('Decomposition retry paths', () => {
43
43
  frontMatter: {
44
44
  feature_id: 'feature_retry',
45
45
  version: 1,
46
- status: STATUS.BUILDING
46
+ status: STATUS.BUILDING,
47
47
  },
48
- body: 'initial body'
48
+ body: 'initial body',
49
49
  };
50
50
 
51
51
  const service = new FeatureStateService({
52
- withFeatureLock: async <T>(_featureId: string, operation: () => Promise<T>) => await operation(),
52
+ withFeatureLock: async <T>(_featureId: string, operation: () => Promise<T>) =>
53
+ await operation(),
53
54
  readState: async () => clone(state),
54
55
  writeState: async (_featureId: string, frontMatter: AnyRecord, body?: string) => {
55
56
  state.frontMatter = clone(frontMatter);
56
57
  state.body = body ?? state.body;
57
- }
58
+ },
58
59
  });
59
60
 
60
61
  await expect(
61
62
  service.featureStatePatch('feature_retry', 0, {
62
- front_matter: { status: STATUS.QA }
63
- })
63
+ front_matter: { status: STATUS.QA },
64
+ }),
64
65
  ).rejects.toMatchObject({
65
66
  normalizedResponse: {
66
67
  error: {
@@ -68,22 +69,22 @@ describe('Decomposition retry paths', () => {
68
69
  details: {
69
70
  expected_version: 0,
70
71
  actual_version: 1,
71
- retryable: true
72
- }
73
- }
74
- }
72
+ retryable: true,
73
+ },
74
+ },
75
+ },
75
76
  });
76
77
 
77
78
  const retry = await service.featureStatePatch('feature_retry', 1, {
78
- front_matter: { status: STATUS.QA }
79
+ front_matter: { status: STATUS.QA },
79
80
  });
80
81
 
81
82
  expect(retry).toMatchObject({
82
83
  data: {
83
84
  feature_id: 'feature_retry',
84
85
  version: 2,
85
- status: STATUS.QA
86
- }
86
+ status: STATUS.QA,
87
+ },
87
88
  });
88
89
  expect(state.frontMatter.version).toBe(2);
89
90
  expect(state.frontMatter.status).toBe(STATUS.QA);
@@ -98,11 +99,11 @@ describe('Decomposition retry paths', () => {
98
99
  gate_profile: 'default',
99
100
  gates: {
100
101
  fast: GATE_RESULT.NA,
101
- full: GATE_RESULT.NA
102
+ full: GATE_RESULT.NA,
102
103
  },
103
- evidence: {}
104
+ evidence: {},
104
105
  },
105
- body: 'state body'
106
+ body: 'state body',
106
107
  };
107
108
 
108
109
  vi.mocked(runGateMode)
@@ -112,7 +113,7 @@ describe('Decomposition retry paths', () => {
112
113
  evidence_path: '/repo/.aop/features/feature_gate_retry/evidence/gate-fast-1.json',
113
114
  latest_path: '/repo/.aop/features/feature_gate_retry/evidence/latest-fast.json',
114
115
  coverage: { line: 0.7, branch: 0.72 },
115
- thresholds: { coverage_line_min: 0.8, coverage_branch_min: 0.8 }
116
+ thresholds: { coverage_line_min: 0.8, coverage_branch_min: 0.8 },
116
117
  })
117
118
  .mockResolvedValueOnce({
118
119
  overall: 'pass',
@@ -120,7 +121,7 @@ describe('Decomposition retry paths', () => {
120
121
  evidence_path: '/repo/.aop/features/feature_gate_retry/evidence/gate-fast-2.json',
121
122
  latest_path: '/repo/.aop/features/feature_gate_retry/evidence/latest-fast.json',
122
123
  coverage: { line: 0.9, branch: 0.91 },
123
- thresholds: { coverage_line_min: 0.8, coverage_branch_min: 0.8 }
124
+ thresholds: { coverage_line_min: 0.8, coverage_branch_min: 0.8 },
124
125
  });
125
126
 
126
127
  const service = new GateService({
@@ -129,10 +130,10 @@ describe('Decomposition retry paths', () => {
129
130
  profiles: {
130
131
  default: {
131
132
  modes: {
132
- fast: [{ name: 'fast-check', cmd: ['npm', 'test'] }]
133
- }
134
- }
135
- }
133
+ fast: [{ name: 'fast-check', cmd: ['npm', 'test'] }],
134
+ },
135
+ },
136
+ },
136
137
  }),
137
138
  getPolicySnapshot: () => ({ testing: {}, execution: {} }),
138
139
  readState: async () => clone(state),
@@ -144,14 +145,14 @@ describe('Decomposition retry paths', () => {
144
145
  state.frontMatter = {
145
146
  ...state.frontMatter,
146
147
  ...(next.frontMatter ?? {}),
147
- version: state.frontMatter.version + 1
148
+ version: state.frontMatter.version + 1,
148
149
  };
149
150
  state.body = next.body ?? state.body;
150
151
  return clone(state.frontMatter);
151
152
  },
152
153
  worktreePath: (featureId: string) => `/repo/.worktrees/${featureId}`,
153
154
  logsPath: (featureId: string) => `/repo/.aop/features/${featureId}/logs`,
154
- evidencePath: (featureId: string) => `/repo/.aop/features/${featureId}/evidence`
155
+ evidencePath: (featureId: string) => `/repo/.aop/features/${featureId}/evidence`,
155
156
  });
156
157
 
157
158
  await expect(service.gatesRun('feature_gate_retry', null, 'fast')).rejects.toMatchObject({
@@ -160,13 +161,13 @@ describe('Decomposition retry paths', () => {
160
161
  code: ERROR_CODES.COVERAGE_BELOW_MINIMUM,
161
162
  details: {
162
163
  retryable: true,
163
- requires_human: false
164
- }
164
+ requires_human: false,
165
+ },
165
166
  },
166
167
  evidence: {
167
- log_path: '.aop/features/feature_gate_retry/evidence/latest-fast.json'
168
- }
169
- }
168
+ log_path: '.aop/features/feature_gate_retry/evidence/latest-fast.json',
169
+ },
170
+ },
170
171
  });
171
172
 
172
173
  expect(state.frontMatter.status).toBe(STATUS.BLOCKED);
@@ -179,7 +180,7 @@ describe('Decomposition retry paths', () => {
179
180
  feature_id: 'feature_gate_retry',
180
181
  mode: 'fast',
181
182
  overall: 'pass',
182
- evidence_path: '.aop/features/feature_gate_retry/evidence/gate-fast-2.json'
183
+ evidence_path: '.aop/features/feature_gate_retry/evidence/gate-fast-2.json',
183
184
  });
184
185
  expect(state.frontMatter.status).toBe(STATUS.QA);
185
186
  expect(state.frontMatter.gates.fast).toBe(GATE_RESULT.PASS);
@@ -193,21 +194,21 @@ describe('Decomposition retry paths', () => {
193
194
  status: STATUS.READY_TO_MERGE,
194
195
  gates: {
195
196
  fast: GATE_RESULT.PASS,
196
- full: GATE_RESULT.PASS
197
+ full: GATE_RESULT.PASS,
197
198
  },
198
199
  locks: {
199
- held: ['openapi', 'db_migrations']
200
+ held: ['openapi', 'db_migrations'],
200
201
  },
201
- evidence: {}
202
+ evidence: {},
202
203
  },
203
- body: '# State'
204
+ body: '# State',
204
205
  };
205
206
 
206
207
  let index: AnyRecord = {
207
208
  version: 7,
208
209
  active: ['feature_merge_retry'],
209
210
  blocked: ['feature_merge_retry'],
210
- merged: []
211
+ merged: [],
211
212
  };
212
213
 
213
214
  const locksRelease = vi.fn(async () => ({ data: { released: true } }));
@@ -241,13 +242,13 @@ describe('Decomposition retry paths', () => {
241
242
  getPolicySnapshot: () => ({
242
243
  merge_policy: {
243
244
  allowed_strategies: ['merge_commit', 'squash', 'rebase'],
244
- require_user_approval: false
245
+ require_user_approval: false,
245
246
  },
246
247
  required_modes: ['fast'],
247
248
  required_merge_mode: 'full',
248
249
  worktree: {
249
- base_branch: 'main'
250
- }
250
+ base_branch: 'main',
251
+ },
251
252
  }),
252
253
  featurePath: (featureId: string) => `/repo/.aop/features/${featureId}`,
253
254
  readState: async () => clone(state),
@@ -260,7 +261,7 @@ describe('Decomposition retry paths', () => {
260
261
  state.frontMatter = {
261
262
  ...state.frontMatter,
262
263
  ...(next.frontMatter ?? {}),
263
- version: state.frontMatter.version + 1
264
+ version: state.frontMatter.version + 1,
264
265
  };
265
266
  state.body = next.body ?? state.body;
266
267
  return clone(state.frontMatter);
@@ -270,30 +271,35 @@ describe('Decomposition retry paths', () => {
270
271
  readIndex: async () => clone(index),
271
272
  writeIndex: async (nextIndex: AnyRecord) => {
272
273
  index = clone(nextIndex);
273
- }
274
+ },
274
275
  });
275
276
 
276
277
  await expect(
277
- service.featureReadyToMerge('feature_merge_retry', 'merge retry', 'merge_commit', null)
278
+ service.featureReadyToMerge('feature_merge_retry', 'merge retry', 'merge_commit', null),
278
279
  ).rejects.toMatchObject({
279
280
  normalizedResponse: {
280
281
  error: {
281
282
  code: ERROR_CODES.GIT_FAILURE,
282
283
  details: {
283
284
  retryable: true,
284
- requires_human: true
285
- }
286
- }
287
- }
285
+ requires_human: true,
286
+ },
287
+ },
288
+ },
288
289
  });
289
290
 
290
- const retry = await service.featureReadyToMerge('feature_merge_retry', 'merge retry', 'merge_commit', null);
291
+ const retry = await service.featureReadyToMerge(
292
+ 'feature_merge_retry',
293
+ 'merge retry',
294
+ 'merge_commit',
295
+ null,
296
+ );
291
297
 
292
298
  expect(retry.data).toMatchObject({
293
299
  feature_id: 'feature_merge_retry',
294
300
  merge_sha: 'abc123',
295
301
  merge_strategy: 'merge_commit',
296
- status: STATUS.MERGED
302
+ status: STATUS.MERGED,
297
303
  });
298
304
  expect(state.frontMatter.status).toBe(STATUS.MERGED);
299
305
  expect(state.frontMatter.version).toBe(5);
@@ -306,30 +312,44 @@ describe('Decomposition retry paths', () => {
306
312
 
307
313
  describe('FeatureStateService branch coverage', () => {
308
314
  it('GIVEN_frontMatter_with_non_numeric_version_WHEN_updateState_called_THEN_version_starts_from_1', async () => {
309
- const state = { frontMatter: { feature_id: 'f1', status: STATUS.PLANNING, version: 'not-a-number' as unknown as number }, body: '' };
315
+ const state = {
316
+ frontMatter: {
317
+ feature_id: 'f1',
318
+ status: STATUS.PLANNING,
319
+ version: 'not-a-number' as unknown as number,
320
+ },
321
+ body: '',
322
+ };
310
323
  const service = new FeatureStateService({
311
324
  withFeatureLock: async <T>(_id: string, op: () => Promise<T>) => await op(),
312
325
  readState: async () => ({ ...state }),
313
- writeState: async (_id: string, fm: Record<string, unknown>) => { state.frontMatter = fm as typeof state.frontMatter; }
326
+ writeState: async (_id: string, fm: Record<string, unknown>) => {
327
+ state.frontMatter = fm as typeof state.frontMatter;
328
+ },
314
329
  });
315
330
 
316
- const result = await service.featureStatePatch('f1', null, { front_matter: { status: STATUS.PLANNING } });
331
+ const result = await service.featureStatePatch('f1', null, {
332
+ front_matter: { status: STATUS.PLANNING },
333
+ });
317
334
  // version should be 0 (non-numeric read) + 1 = 1
318
335
  expect(result.data.version).toBe(1);
319
336
  });
320
337
 
321
338
  it('GIVEN_illegal_status_transition_WHEN_updateState_called_THEN_throws_INVALID_STATUS_TRANSITION', async () => {
322
- const state = { frontMatter: { feature_id: 'f1', status: STATUS.MERGED, version: 1 }, body: '' };
339
+ const state = {
340
+ frontMatter: { feature_id: 'f1', status: STATUS.MERGED, version: 1 },
341
+ body: '',
342
+ };
323
343
  const service = new FeatureStateService({
324
344
  withFeatureLock: async <T>(_id: string, op: () => Promise<T>) => await op(),
325
345
  readState: async () => ({ ...state }),
326
- writeState: vi.fn()
346
+ writeState: vi.fn(),
327
347
  });
328
348
 
329
349
  await expect(
330
- service.featureStatePatch('f1', null, { front_matter: { status: STATUS.PLANNING } })
350
+ service.featureStatePatch('f1', null, { front_matter: { status: STATUS.PLANNING } }),
331
351
  ).rejects.toMatchObject({
332
- normalizedResponse: { error: { code: ERROR_CODES.INVALID_STATUS_TRANSITION } }
352
+ normalizedResponse: { error: { code: ERROR_CODES.INVALID_STATUS_TRANSITION } },
333
353
  });
334
354
  });
335
355
  });