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
@@ -8,7 +8,7 @@ import type { GateStep, PolicyShape, GateProfile } from '../src/core/gates.js';
8
8
  const runCommandMock = vi.hoisted(() => vi.fn());
9
9
 
10
10
  vi.mock('../src/core/git.js', () => ({
11
- runCommand: runCommandMock
11
+ runCommand: runCommandMock,
12
12
  }));
13
13
 
14
14
  // Re-import after mock
@@ -23,14 +23,14 @@ describe('parallel gate execution', () => {
23
23
  execution: {
24
24
  retry_policy: { transient_max_retries: 0, transient_error_codes: [] },
25
25
  env_allowlist: [],
26
- default_step_timeout_seconds: 60
26
+ default_step_timeout_seconds: 60,
27
27
  },
28
28
  testing: {
29
29
  coverage: {
30
30
  minimums: { line: 0, branch: 0 },
31
- targets: { line: 1, branch: 1 }
32
- }
33
- }
31
+ targets: { line: 1, branch: 1 },
32
+ },
33
+ },
34
34
  };
35
35
 
36
36
  beforeEach(async () => {
@@ -52,7 +52,7 @@ describe('parallel gate execution', () => {
52
52
  const steps: GateStep[] = [
53
53
  { name: 'lint', cmd: ['eslint', '.'], parallel_group: 'static' },
54
54
  { name: 'typecheck', cmd: ['tsc', '--noEmit'], parallel_group: 'static' },
55
- { name: 'test', cmd: ['vitest', 'run'], depends_on: ['lint', 'typecheck'] }
55
+ { name: 'test', cmd: ['vitest', 'run'], depends_on: ['lint', 'typecheck'] },
56
56
  ];
57
57
 
58
58
  const waves = buildExecutionWaves(steps);
@@ -64,7 +64,7 @@ describe('parallel gate execution', () => {
64
64
  it('GIVEN no parallel config THEN each step is its own wave', () => {
65
65
  const steps: GateStep[] = [
66
66
  { name: 'lint', cmd: ['eslint', '.'] },
67
- { name: 'test', cmd: ['vitest', 'run'] }
67
+ { name: 'test', cmd: ['vitest', 'run'] },
68
68
  ];
69
69
 
70
70
  const waves = buildExecutionWaves(steps);
@@ -77,7 +77,7 @@ describe('parallel gate execution', () => {
77
77
  const steps: GateStep[] = [
78
78
  { name: 'step1', cmd: ['echo', '1'] },
79
79
  { name: 'step2', cmd: ['echo', '2'], depends_on: ['step1'] },
80
- { name: 'step3', cmd: ['echo', '3'], depends_on: ['step2'] }
80
+ { name: 'step3', cmd: ['echo', '3'], depends_on: ['step2'] },
81
81
  ];
82
82
 
83
83
  const waves = buildExecutionWaves(steps);
@@ -92,7 +92,11 @@ describe('parallel gate execution', () => {
92
92
  { name: 'lint', cmd: ['eslint'], parallel_group: 'checks' },
93
93
  { name: 'typecheck', cmd: ['tsc'], parallel_group: 'checks' },
94
94
  { name: 'unit_test', cmd: ['vitest'], depends_on: ['lint', 'typecheck'] },
95
- { name: 'integration', cmd: ['vitest', '--integration'], depends_on: ['lint', 'typecheck'] }
95
+ {
96
+ name: 'integration',
97
+ cmd: ['vitest', '--integration'],
98
+ depends_on: ['lint', 'typecheck'],
99
+ },
96
100
  ];
97
101
 
98
102
  const waves = buildExecutionWaves(steps);
@@ -115,9 +119,9 @@ describe('parallel gate execution', () => {
115
119
  fast: [
116
120
  { name: 'lint', cmd: ['lint-cmd'], parallel_group: 'static' },
117
121
  { name: 'typecheck', cmd: ['typecheck-cmd'], parallel_group: 'static' },
118
- { name: 'test', cmd: ['test-cmd'], depends_on: ['lint', 'typecheck'] }
119
- ]
120
- }
122
+ { name: 'test', cmd: ['test-cmd'], depends_on: ['lint', 'typecheck'] },
123
+ ],
124
+ },
121
125
  };
122
126
 
123
127
  const service = new GateExecutionService(new CoverageThresholdPolicy());
@@ -129,7 +133,7 @@ describe('parallel gate execution', () => {
129
133
  policy: defaultPolicy,
130
134
  worktreePath: tempDir,
131
135
  logDirectory: logDir,
132
- evidenceDirectory: evidenceDir
136
+ evidenceDirectory: evidenceDir,
133
137
  });
134
138
 
135
139
  expect(result['overall']).toBe('pass');
@@ -153,9 +157,9 @@ describe('parallel gate execution', () => {
153
157
  fast: [
154
158
  { name: 'lint', cmd: ['lint-cmd'], parallel_group: 'static' },
155
159
  { name: 'typecheck', cmd: ['typecheck-cmd'], parallel_group: 'static' },
156
- { name: 'test', cmd: ['test-cmd'], depends_on: ['lint', 'typecheck'] }
157
- ]
158
- }
160
+ { name: 'test', cmd: ['test-cmd'], depends_on: ['lint', 'typecheck'] },
161
+ ],
162
+ },
159
163
  };
160
164
 
161
165
  const service = new GateExecutionService(new CoverageThresholdPolicy());
@@ -167,7 +171,7 @@ describe('parallel gate execution', () => {
167
171
  policy: defaultPolicy,
168
172
  worktreePath: tempDir,
169
173
  logDirectory: logDir,
170
- evidenceDirectory: evidenceDir
174
+ evidenceDirectory: evidenceDir,
171
175
  });
172
176
 
173
177
  expect(result['overall']).toBe('fail');
@@ -189,9 +193,9 @@ describe('parallel gate execution', () => {
189
193
  modes: {
190
194
  fast: [
191
195
  { name: 'lint', cmd: ['lint-cmd'] },
192
- { name: 'test', cmd: ['test-cmd'] }
193
- ]
194
- }
196
+ { name: 'test', cmd: ['test-cmd'] },
197
+ ],
198
+ },
195
199
  };
196
200
 
197
201
  const service = new GateExecutionService(new CoverageThresholdPolicy());
@@ -203,7 +207,7 @@ describe('parallel gate execution', () => {
203
207
  policy: defaultPolicy,
204
208
  worktreePath: tempDir,
205
209
  logDirectory: logDir,
206
- evidenceDirectory: evidenceDir
210
+ evidenceDirectory: evidenceDir,
207
211
  });
208
212
 
209
213
  expect(result['overall']).toBe('pass');
@@ -224,9 +228,9 @@ describe('parallel gate execution', () => {
224
228
  modes: {
225
229
  fast: [
226
230
  { name: 'lint', cmd: ['lint-cmd'] },
227
- { name: 'test', cmd: ['test-cmd'] }
228
- ]
229
- }
231
+ { name: 'test', cmd: ['test-cmd'] },
232
+ ],
233
+ },
230
234
  };
231
235
 
232
236
  const service = new GateExecutionService(new CoverageThresholdPolicy());
@@ -238,7 +242,7 @@ describe('parallel gate execution', () => {
238
242
  policy: defaultPolicy,
239
243
  worktreePath: tempDir,
240
244
  logDirectory: logDir,
241
- evidenceDirectory: evidenceDir
245
+ evidenceDirectory: evidenceDir,
242
246
  });
243
247
 
244
248
  expect(result['overall']).toBe('fail');
@@ -246,15 +250,21 @@ describe('parallel gate execution', () => {
246
250
  });
247
251
 
248
252
  it('GIVEN all parallel steps fail WHEN gate runs THEN all failures captured in evidence', async () => {
249
- runCommandMock.mockResolvedValue({ code: 1, signal: null, stdout: '', stderr: 'fail', timeout: false });
253
+ runCommandMock.mockResolvedValue({
254
+ code: 1,
255
+ signal: null,
256
+ stdout: '',
257
+ stderr: 'fail',
258
+ timeout: false,
259
+ });
250
260
 
251
261
  const profile: GateProfile = {
252
262
  modes: {
253
263
  fast: [
254
264
  { name: 'lint', cmd: ['lint-cmd'], parallel_group: 'static' },
255
- { name: 'typecheck', cmd: ['typecheck-cmd'], parallel_group: 'static' }
256
- ]
257
- }
265
+ { name: 'typecheck', cmd: ['typecheck-cmd'], parallel_group: 'static' },
266
+ ],
267
+ },
258
268
  };
259
269
 
260
270
  const service = new GateExecutionService(new CoverageThresholdPolicy());
@@ -266,7 +276,7 @@ describe('parallel gate execution', () => {
266
276
  policy: defaultPolicy,
267
277
  worktreePath: tempDir,
268
278
  logDirectory: logDir,
269
- evidenceDirectory: evidenceDir
279
+ evidenceDirectory: evidenceDir,
270
280
  });
271
281
 
272
282
  expect(result['overall']).toBe('fail');
@@ -276,15 +286,21 @@ describe('parallel gate execution', () => {
276
286
  });
277
287
 
278
288
  it('GIVEN parallel steps WHEN evidence written THEN timing metadata present', async () => {
279
- runCommandMock.mockResolvedValue({ code: 0, signal: null, stdout: '', stderr: '', timeout: false });
289
+ runCommandMock.mockResolvedValue({
290
+ code: 0,
291
+ signal: null,
292
+ stdout: '',
293
+ stderr: '',
294
+ timeout: false,
295
+ });
280
296
 
281
297
  const profile: GateProfile = {
282
298
  modes: {
283
299
  fast: [
284
300
  { name: 'lint', cmd: ['lint-cmd'], parallel_group: 'static' },
285
- { name: 'typecheck', cmd: ['typecheck-cmd'], parallel_group: 'static' }
286
- ]
287
- }
301
+ { name: 'typecheck', cmd: ['typecheck-cmd'], parallel_group: 'static' },
302
+ ],
303
+ },
288
304
  };
289
305
 
290
306
  const service = new GateExecutionService(new CoverageThresholdPolicy());
@@ -296,7 +312,7 @@ describe('parallel gate execution', () => {
296
312
  policy: defaultPolicy,
297
313
  worktreePath: tempDir,
298
314
  logDirectory: logDir,
299
- evidenceDirectory: evidenceDir
315
+ evidenceDirectory: evidenceDir,
300
316
  });
301
317
 
302
318
  const stepResults = result['step_results'] as Array<Record<string, unknown>>;
@@ -2,24 +2,24 @@ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
2
  import { PatchService } from '../src/application/services/patch-service.js';
3
3
 
4
4
  vi.mock('../src/core/git.js', () => ({
5
- runGit: vi.fn()
5
+ runGit: vi.fn(),
6
6
  }));
7
7
  vi.mock('../src/core/patch.js', () => ({
8
8
  parseUnifiedDiff: vi.fn(() => []),
9
- touchedPathsFromDiff: vi.fn(() => [])
9
+ touchedPathsFromDiff: vi.fn(() => []),
10
10
  }));
11
11
  vi.mock('../src/core/path-rules.js', () => ({
12
12
  normalizeRepoPath: vi.fn(async (_root: string, p: string) => p),
13
13
  anyAreaMatch: vi.fn(() => false),
14
- sortResourcesDeterministically: vi.fn((r: string[]) => [...new Set(r)].sort())
14
+ sortResourcesDeterministically: vi.fn((r: string[]) => [...new Set(r)].sort()),
15
15
  }));
16
16
  vi.mock('../src/core/qa-index.js', () => ({
17
17
  buildQaIndex: vi.fn(() => ({ version: 1, tests: [] })),
18
- makeRequiredTests: vi.fn(() => [])
18
+ makeRequiredTests: vi.fn(() => []),
19
19
  }));
20
20
  vi.mock('../src/core/fs.js', () => ({
21
21
  readJson: vi.fn(async () => null),
22
- atomicWriteJson: vi.fn(async () => undefined)
22
+ atomicWriteJson: vi.fn(async () => undefined),
23
23
  }));
24
24
 
25
25
  import { runGit } from '../src/core/git.js';
@@ -27,18 +27,20 @@ import { parseUnifiedDiff, touchedPathsFromDiff } from '../src/core/patch.js';
27
27
  import { anyAreaMatch, normalizeRepoPath } from '../src/core/path-rules.js';
28
28
  import { readJson } from '../src/core/fs.js';
29
29
 
30
- function makePort(overrides: Partial<{
31
- plan: unknown;
32
- enforcePlan: boolean;
33
- enforceAllowedAreas: boolean;
34
- allowedAreas: string[];
35
- forbiddenAreas: string[];
36
- protectedAreas: string[];
37
- heldLocks: string[];
38
- openapi: string;
39
- events: string;
40
- db: string;
41
- }> = {}) {
30
+ function makePort(
31
+ overrides: Partial<{
32
+ plan: unknown;
33
+ enforcePlan: boolean;
34
+ enforceAllowedAreas: boolean;
35
+ allowedAreas: string[];
36
+ forbiddenAreas: string[];
37
+ protectedAreas: string[];
38
+ heldLocks: string[];
39
+ openapi: string;
40
+ events: string;
41
+ db: string;
42
+ }> = {},
43
+ ) {
42
44
  const o = {
43
45
  plan: null as unknown,
44
46
  enforcePlan: true,
@@ -50,7 +52,7 @@ function makePort(overrides: Partial<{
50
52
  openapi: 'none',
51
53
  events: 'none',
52
54
  db: 'none',
53
- ...overrides
55
+ ...overrides,
54
56
  };
55
57
 
56
58
  return {
@@ -59,28 +61,38 @@ function makePort(overrides: Partial<{
59
61
  patch_policy: { enforce_plan: o.enforcePlan, enforce_allowed_areas: o.enforceAllowedAreas },
60
62
  path_rules: { matching: 'repo_prefix', allow_symlink_traversal: false },
61
63
  locks: {
62
- contract_to_resource: { openapi: 'openapi', events: 'events', db: 'db' }
64
+ contract_to_resource: { openapi: 'openapi', events: 'events', db: 'db' },
63
65
  },
64
- protected_areas: o.protectedAreas
66
+ protected_areas: o.protectedAreas,
67
+ })),
68
+ getGatesConfig: vi.fn(() => ({
69
+ profiles: { default: { modes: { fast: [], full: [], merge: [] } } },
65
70
  })),
66
- getGatesConfig: vi.fn(() => ({ profiles: { default: { modes: { fast: [], full: [], merge: [] } } } })),
67
71
  planPath: vi.fn(() => '/repo/.aop/features/f1/plan.json'),
68
72
  qaIndexPath: vi.fn(() => '/repo/.aop/features/f1/qa_test_index.json'),
69
73
  worktreePath: vi.fn(() => '/worktree/f1'),
70
74
  readState: vi.fn(async () => ({ frontMatter: { locks: { held: o.heldLocks } } })),
71
75
  validateSchema: vi.fn(async () => ({ valid: true })),
72
- updateState: vi.fn(async (_id: string, _v: unknown, cb: (fm: object, body: string) => Promise<{ frontMatter?: object; body?: string }>) => {
73
- return await cb({}, '');
74
- }),
76
+ updateState: vi.fn(
77
+ async (
78
+ _id: string,
79
+ _v: unknown,
80
+ cb: (fm: object, body: string) => Promise<{ frontMatter?: object; body?: string }>,
81
+ ) => {
82
+ return await cb({}, '');
83
+ },
84
+ ),
75
85
  __plan: o.plan,
76
86
  __openapi: o.openapi,
77
87
  __events: o.events,
78
- __db: o.db
88
+ __db: o.db,
79
89
  };
80
90
  }
81
91
 
82
92
  describe('PatchService', () => {
83
- beforeEach(() => { vi.clearAllMocks(); });
93
+ beforeEach(() => {
94
+ vi.clearAllMocks();
95
+ });
84
96
 
85
97
  describe('loadAcceptedPlan', () => {
86
98
  it('GIVEN_enforce_plan_true_and_no_plan_file_WHEN_loadAcceptedPlan_called_THEN_throws_PLAN_REQUIRED', async () => {
@@ -88,7 +100,7 @@ describe('PatchService', () => {
88
100
  const port = makePort({ enforcePlan: true });
89
101
  const svc = new PatchService(port);
90
102
  await expect(svc.loadAcceptedPlan('f1')).rejects.toMatchObject({
91
- normalizedResponse: expect.objectContaining({ ok: false })
103
+ normalizedResponse: expect.objectContaining({ ok: false }),
92
104
  });
93
105
  });
94
106
 
@@ -114,28 +126,36 @@ describe('PatchService', () => {
114
126
  it('GIVEN_openapi_modify_WHEN_requiredResourcesForPlan_THEN_includes_openapi_resource', () => {
115
127
  const port = makePort();
116
128
  const svc = new PatchService(port);
117
- const result = svc.requiredResourcesForPlan({ contracts: { openapi: 'modify', events: 'none', db: 'none' } });
129
+ const result = svc.requiredResourcesForPlan({
130
+ contracts: { openapi: 'modify', events: 'none', db: 'none' },
131
+ });
118
132
  expect(result).toContain('openapi');
119
133
  });
120
134
 
121
135
  it('GIVEN_events_modify_WHEN_requiredResourcesForPlan_THEN_includes_events_resource', () => {
122
136
  const port = makePort();
123
137
  const svc = new PatchService(port);
124
- const result = svc.requiredResourcesForPlan({ contracts: { openapi: 'none', events: 'modify', db: 'none' } });
138
+ const result = svc.requiredResourcesForPlan({
139
+ contracts: { openapi: 'none', events: 'modify', db: 'none' },
140
+ });
125
141
  expect(result).toContain('events');
126
142
  });
127
143
 
128
144
  it('GIVEN_db_migration_WHEN_requiredResourcesForPlan_THEN_includes_db_resource', () => {
129
145
  const port = makePort();
130
146
  const svc = new PatchService(port);
131
- const result = svc.requiredResourcesForPlan({ contracts: { openapi: 'none', events: 'none', db: 'migration' } });
147
+ const result = svc.requiredResourcesForPlan({
148
+ contracts: { openapi: 'none', events: 'none', db: 'migration' },
149
+ });
132
150
  expect(result).toContain('db');
133
151
  });
134
152
 
135
153
  it('GIVEN_no_contracts_WHEN_requiredResourcesForPlan_THEN_returns_empty', () => {
136
154
  const port = makePort();
137
155
  const svc = new PatchService(port);
138
- const result = svc.requiredResourcesForPlan({ contracts: { openapi: 'none', events: 'none', db: 'none' } });
156
+ const result = svc.requiredResourcesForPlan({
157
+ contracts: { openapi: 'none', events: 'none', db: 'none' },
158
+ });
139
159
  expect(result).toHaveLength(0);
140
160
  });
141
161
  });
@@ -144,14 +164,20 @@ describe('PatchService', () => {
144
164
  it('GIVEN_all_required_locks_held_WHEN_assertPlanLocksHeld_THEN_resolves_without_error', async () => {
145
165
  const port = makePort({ heldLocks: ['openapi'] });
146
166
  const svc = new PatchService(port);
147
- await expect(svc.assertPlanLocksHeld('f1', { contracts: { openapi: 'modify', events: 'none', db: 'none' } })).resolves.toBeUndefined();
167
+ await expect(
168
+ svc.assertPlanLocksHeld('f1', {
169
+ contracts: { openapi: 'modify', events: 'none', db: 'none' },
170
+ }),
171
+ ).resolves.toBeUndefined();
148
172
  });
149
173
 
150
174
  it('GIVEN_required_lock_not_held_WHEN_assertPlanLocksHeld_THEN_throws_LOCK_NOT_HELD', async () => {
151
175
  const port = makePort({ heldLocks: [] });
152
176
  const svc = new PatchService(port);
153
177
  await expect(
154
- svc.assertPlanLocksHeld('f1', { contracts: { openapi: 'modify', events: 'none', db: 'none' } })
178
+ svc.assertPlanLocksHeld('f1', {
179
+ contracts: { openapi: 'modify', events: 'none', db: 'none' },
180
+ }),
155
181
  ).rejects.toMatchObject({ normalizedResponse: expect.objectContaining({ ok: false }) });
156
182
  });
157
183
  });
@@ -163,9 +189,13 @@ describe('PatchService', () => {
163
189
  vi.mocked(anyAreaMatch).mockReturnValue(true);
164
190
  const port = makePort({ forbiddenAreas: ['src'] });
165
191
  const svc = new PatchService(port);
166
- const plan = { allowed_areas: [], forbidden_areas: ['src'], files: { create: ['src/evil.ts'], modify: [], delete: [] } };
192
+ const plan = {
193
+ allowed_areas: [],
194
+ forbidden_areas: ['src'],
195
+ files: { create: ['src/evil.ts'], modify: [], delete: [] },
196
+ };
167
197
  await expect(svc.validatePatchPaths('f1', [] as never, plan)).rejects.toMatchObject({
168
- normalizedResponse: expect.objectContaining({ ok: false })
198
+ normalizedResponse: expect.objectContaining({ ok: false }),
169
199
  });
170
200
  });
171
201
 
@@ -175,8 +205,14 @@ describe('PatchService', () => {
175
205
  vi.mocked(anyAreaMatch).mockReturnValue(false);
176
206
  const port = makePort({ enforceAllowedAreas: true, allowedAreas: ['lib'] });
177
207
  const svc = new PatchService(port);
178
- await expect(svc.validatePatchPaths('f1', [] as never, { allowed_areas: ['lib'], forbidden_areas: [], files: { create: [], modify: [], delete: [] } })).rejects.toMatchObject({
179
- normalizedResponse: expect.objectContaining({ ok: false })
208
+ await expect(
209
+ svc.validatePatchPaths('f1', [] as never, {
210
+ allowed_areas: ['lib'],
211
+ forbidden_areas: [],
212
+ files: { create: [], modify: [], delete: [] },
213
+ }),
214
+ ).rejects.toMatchObject({
215
+ normalizedResponse: expect.objectContaining({ ok: false }),
180
216
  });
181
217
  });
182
218
 
@@ -186,9 +222,13 @@ describe('PatchService', () => {
186
222
  vi.mocked(anyAreaMatch).mockReturnValue(false);
187
223
  const port = makePort();
188
224
  const svc = new PatchService(port);
189
- const plan = { allowed_areas: [], forbidden_areas: [], files: { create: ['src/other.ts'], modify: [], delete: [] } };
225
+ const plan = {
226
+ allowed_areas: [],
227
+ forbidden_areas: [],
228
+ files: { create: ['src/other.ts'], modify: [], delete: [] },
229
+ };
190
230
  await expect(svc.validatePatchPaths('f1', [] as never, plan)).rejects.toMatchObject({
191
- normalizedResponse: expect.objectContaining({ ok: false })
231
+ normalizedResponse: expect.objectContaining({ ok: false }),
192
232
  });
193
233
  });
194
234
 
@@ -198,7 +238,11 @@ describe('PatchService', () => {
198
238
  vi.mocked(anyAreaMatch).mockReturnValue(false);
199
239
  const port = makePort();
200
240
  const svc = new PatchService(port);
201
- const plan = { allowed_areas: [], forbidden_areas: [], files: { create: ['src/file.ts'], modify: [], delete: [] } };
241
+ const plan = {
242
+ allowed_areas: [],
243
+ forbidden_areas: [],
244
+ files: { create: ['src/file.ts'], modify: [], delete: [] },
245
+ };
202
246
  const result = await svc.validatePatchPaths('f1', [] as never, plan);
203
247
  expect(result).toEqual(['src/file.ts']);
204
248
  });
@@ -206,27 +250,57 @@ describe('PatchService', () => {
206
250
 
207
251
  describe('repoApplyPatch', () => {
208
252
  it('GIVEN_git_apply_fails_WHEN_repoApplyPatch_THEN_throws_GIT_FAILURE', async () => {
209
- vi.mocked(readJson).mockResolvedValue({ allowed_areas: [], forbidden_areas: [], files: { create: [], modify: [], delete: [] }, contracts: { openapi: 'none', events: 'none', db: 'none' }, gate_profile: 'default' });
253
+ vi.mocked(readJson).mockResolvedValue({
254
+ allowed_areas: [],
255
+ forbidden_areas: [],
256
+ files: { create: [], modify: [], delete: [] },
257
+ contracts: { openapi: 'none', events: 'none', db: 'none' },
258
+ gate_profile: 'default',
259
+ });
210
260
  vi.mocked(parseUnifiedDiff).mockReturnValue([]);
211
261
  vi.mocked(touchedPathsFromDiff).mockReturnValue([]);
212
- vi.mocked(runGit).mockResolvedValue({ code: 1, signal: null, stdout: '', stderr: 'apply failed', timeout: false });
262
+ vi.mocked(runGit).mockResolvedValue({
263
+ code: 1,
264
+ signal: null,
265
+ stdout: '',
266
+ stderr: 'apply failed',
267
+ timeout: false,
268
+ });
213
269
  const port = makePort({ heldLocks: [] });
214
270
  const svc = new PatchService(port);
215
271
  await expect(svc.repoApplyPatch('f1', 'diff --git a/f b/f\n')).rejects.toMatchObject({
216
- normalizedResponse: expect.objectContaining({ ok: false })
272
+ normalizedResponse: expect.objectContaining({ ok: false }),
217
273
  });
218
274
  });
219
275
 
220
276
  it('GIVEN_git_apply_succeeds_WHEN_repoApplyPatch_THEN_returns_changed_files', async () => {
221
- vi.mocked(readJson).mockResolvedValue({ allowed_areas: [], forbidden_areas: [], files: { create: ['src/a.ts'], modify: [], delete: [] }, contracts: { openapi: 'none', events: 'none', db: 'none' }, gate_profile: 'default' });
277
+ vi.mocked(readJson).mockResolvedValue({
278
+ allowed_areas: [],
279
+ forbidden_areas: [],
280
+ files: { create: ['src/a.ts'], modify: [], delete: [] },
281
+ contracts: { openapi: 'none', events: 'none', db: 'none' },
282
+ gate_profile: 'default',
283
+ });
222
284
  vi.mocked(parseUnifiedDiff).mockReturnValue([]);
223
285
  vi.mocked(touchedPathsFromDiff).mockReturnValue(['src/a.ts']);
224
286
  vi.mocked(normalizeRepoPath).mockResolvedValue('src/a.ts');
225
287
  vi.mocked(anyAreaMatch).mockReturnValue(false);
226
288
  vi.mocked(runGit)
227
289
  .mockResolvedValueOnce({ code: 0, signal: null, stdout: '', stderr: '', timeout: false }) // apply
228
- .mockResolvedValueOnce({ code: 0, signal: null, stdout: 'M src/a.ts\n', stderr: '', timeout: false }) // status
229
- .mockResolvedValueOnce({ code: 0, signal: null, stdout: 'src/a.ts\n', stderr: '', timeout: false }); // diff
290
+ .mockResolvedValueOnce({
291
+ code: 0,
292
+ signal: null,
293
+ stdout: 'M src/a.ts\n',
294
+ stderr: '',
295
+ timeout: false,
296
+ }) // status
297
+ .mockResolvedValueOnce({
298
+ code: 0,
299
+ signal: null,
300
+ stdout: 'src/a.ts\n',
301
+ stderr: '',
302
+ timeout: false,
303
+ }); // diff
230
304
  const port = makePort({ heldLocks: [] });
231
305
  const svc = new PatchService(port);
232
306
  const result = await svc.repoApplyPatch('f1', 'diff --git a/src/a.ts b/src/a.ts\n');
@@ -235,7 +309,13 @@ describe('PatchService', () => {
235
309
  });
236
310
 
237
311
  it('GIVEN_qa_index_validation_fails_WHEN_repoApplyPatch_THEN_throws_INTERNAL_ERROR', async () => {
238
- vi.mocked(readJson).mockResolvedValue({ allowed_areas: [], forbidden_areas: [], files: { create: [], modify: [], delete: [] }, contracts: { openapi: 'none', events: 'none', db: 'none' }, gate_profile: 'default' });
312
+ vi.mocked(readJson).mockResolvedValue({
313
+ allowed_areas: [],
314
+ forbidden_areas: [],
315
+ files: { create: [], modify: [], delete: [] },
316
+ contracts: { openapi: 'none', events: 'none', db: 'none' },
317
+ gate_profile: 'default',
318
+ });
239
319
  vi.mocked(parseUnifiedDiff).mockReturnValue([]);
240
320
  vi.mocked(touchedPathsFromDiff).mockReturnValue([]);
241
321
  vi.mocked(runGit)
@@ -246,7 +326,7 @@ describe('PatchService', () => {
246
326
  port.validateSchema.mockResolvedValue({ valid: false });
247
327
  const svc = new PatchService(port);
248
328
  await expect(svc.repoApplyPatch('f1', '')).rejects.toMatchObject({
249
- normalizedResponse: expect.objectContaining({ ok: false })
329
+ normalizedResponse: expect.objectContaining({ ok: false }),
250
330
  });
251
331
  });
252
332
  });