agentic-orchestrator 0.1.2 → 0.1.4

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 (300) hide show
  1. package/.claude/settings.local.json +15 -0
  2. package/CLAUDE.md +126 -0
  3. package/README.md +166 -25
  4. package/agentic/orchestrator/adapters.yaml +3 -0
  5. package/agentic/orchestrator/gates.yaml +47 -0
  6. package/agentic/orchestrator/policy.yaml +89 -0
  7. package/agentic/orchestrator/schemas/adapters.schema.json +12 -0
  8. package/agentic/orchestrator/schemas/gates.schema.json +6 -1
  9. package/agentic/orchestrator/schemas/index.schema.json +14 -0
  10. package/agentic/orchestrator/schemas/multi-project.schema.json +41 -0
  11. package/agentic/orchestrator/schemas/policy.schema.json +449 -52
  12. package/agentic/orchestrator/schemas/state.schema.json +16 -0
  13. package/agentic/orchestrator/tools/catalog.json +68 -0
  14. package/agentic/orchestrator/tools/schemas/input/cost.get.input.schema.json +10 -0
  15. package/agentic/orchestrator/tools/schemas/input/cost.record.input.schema.json +13 -0
  16. package/agentic/orchestrator/tools/schemas/input/feature.send_message.input.schema.json +11 -0
  17. package/agentic/orchestrator/tools/schemas/input/performance.get_analytics.input.schema.json +10 -0
  18. package/agentic/orchestrator/tools/schemas/input/performance.record_outcome.input.schema.json +18 -0
  19. package/agentic/orchestrator/tools/schemas/output/cost.get.output.schema.json +13 -0
  20. package/agentic/orchestrator/tools/schemas/output/cost.record.output.schema.json +13 -0
  21. package/agentic/orchestrator/tools/schemas/output/feature.ready_to_merge.output.schema.json +7 -0
  22. package/agentic/orchestrator/tools/schemas/output/feature.send_message.output.schema.json +23 -0
  23. package/agentic/orchestrator/tools/schemas/output/performance.get_analytics.output.schema.json +46 -0
  24. package/agentic/orchestrator/tools/schemas/output/performance.record_outcome.output.schema.json +10 -0
  25. package/agentic/orchestrator/tools.md +5 -0
  26. package/apps/control-plane/scripts/validate-architecture-rules.mjs +28 -2
  27. package/apps/control-plane/scripts/validate-docker-mcp-contract.mjs +12 -0
  28. package/apps/control-plane/scripts/validate-mcp-contracts.ts +92 -0
  29. package/apps/control-plane/src/application/adapters/adapter-registry.ts +169 -0
  30. package/apps/control-plane/src/application/multi-project-loader.ts +119 -0
  31. package/apps/control-plane/src/application/services/activity-monitor-service.ts +199 -0
  32. package/apps/control-plane/src/application/services/cost-tracking-service.ts +82 -0
  33. package/apps/control-plane/src/application/services/dependency-scheduler-service.ts +86 -0
  34. package/apps/control-plane/src/application/services/feature-deletion-service.ts +8 -7
  35. package/apps/control-plane/src/application/services/gate-interpolation-service.ts +15 -0
  36. package/apps/control-plane/src/application/services/gate-service.ts +38 -2
  37. package/apps/control-plane/src/application/services/instance-isolation-service.ts +18 -0
  38. package/apps/control-plane/src/application/services/issue-tracker-service.ts +469 -0
  39. package/apps/control-plane/src/application/services/merge-service.ts +67 -3
  40. package/apps/control-plane/src/application/services/notifier-service.ts +295 -0
  41. package/apps/control-plane/src/application/services/performance-analytics-service.ts +122 -0
  42. package/apps/control-plane/src/application/services/plan-service.ts +51 -0
  43. package/apps/control-plane/src/application/services/pr-monitor-service.ts +262 -0
  44. package/apps/control-plane/src/application/services/reactions-service.ts +175 -0
  45. package/apps/control-plane/src/application/services/reporting-service.ts +17 -2
  46. package/apps/control-plane/src/application/services/run-lease-service.ts +16 -38
  47. package/apps/control-plane/src/application/tools/tool-metadata.ts +4 -1
  48. package/apps/control-plane/src/cli/aop.ts +1 -1
  49. package/apps/control-plane/src/cli/attach-command-handler.ts +120 -0
  50. package/apps/control-plane/src/cli/cleanup-command-handler.ts +190 -0
  51. package/apps/control-plane/src/cli/cli-argument-parser.ts +69 -3
  52. package/apps/control-plane/src/cli/dashboard-command-handler.ts +57 -0
  53. package/apps/control-plane/src/cli/help-command-handler.ts +163 -0
  54. package/apps/control-plane/src/cli/init-command-handler.ts +609 -0
  55. package/apps/control-plane/src/cli/resume-command-handler.ts +1 -0
  56. package/apps/control-plane/src/cli/retry-command-handler.ts +138 -0
  57. package/apps/control-plane/src/cli/run-command-handler.ts +115 -3
  58. package/apps/control-plane/src/cli/send-command-handler.ts +65 -0
  59. package/apps/control-plane/src/cli/status-command-handler.ts +102 -2
  60. package/apps/control-plane/src/cli/types.ts +26 -1
  61. package/apps/control-plane/src/core/constants.ts +8 -2
  62. package/apps/control-plane/src/core/error-codes.ts +3 -1
  63. package/apps/control-plane/src/core/gates.ts +170 -50
  64. package/apps/control-plane/src/core/kernel.ts +280 -5
  65. package/apps/control-plane/src/core/path-layout.ts +12 -0
  66. package/apps/control-plane/src/core/tool-caller.ts +36 -0
  67. package/apps/control-plane/src/core/workspace-hooks.ts +87 -0
  68. package/apps/control-plane/src/interfaces/cli/bootstrap.ts +258 -9
  69. package/apps/control-plane/src/providers/providers.ts +235 -14
  70. package/apps/control-plane/src/supervisor/build-wave-executor.ts +129 -8
  71. package/apps/control-plane/src/supervisor/qa-wave-executor.ts +123 -5
  72. package/apps/control-plane/src/supervisor/run-coordinator.ts +143 -6
  73. package/apps/control-plane/src/supervisor/runtime.ts +135 -6
  74. package/apps/control-plane/src/supervisor/types.ts +12 -21
  75. package/apps/control-plane/src/supervisor/worker-decision-loop.ts +8 -0
  76. package/apps/control-plane/test/activity-monitor.spec.ts +294 -0
  77. package/apps/control-plane/test/adapter-registry.spec.ts +132 -0
  78. package/apps/control-plane/test/batch-operations.spec.ts +112 -0
  79. package/apps/control-plane/test/bootstrap-attach.spec.ts +102 -0
  80. package/apps/control-plane/test/bootstrap-edge-cases.spec.ts +252 -0
  81. package/apps/control-plane/test/bootstrap.spec.ts +560 -0
  82. package/apps/control-plane/test/cleanup-command.spec.ts +301 -0
  83. package/apps/control-plane/test/cli-helpers.spec.ts +404 -1
  84. package/apps/control-plane/test/cli.unit.spec.ts +182 -1
  85. package/apps/control-plane/test/collision-queue.spec.ts +104 -1
  86. package/apps/control-plane/test/core-utils.spec.ts +175 -2
  87. package/apps/control-plane/test/cost-tracking.spec.ts +143 -0
  88. package/apps/control-plane/test/dashboard-api.integration.spec.ts +247 -0
  89. package/apps/control-plane/test/dashboard-client.spec.ts +116 -0
  90. package/apps/control-plane/test/dashboard-command.spec.ts +103 -0
  91. package/apps/control-plane/test/dependency-scheduler.spec.ts +189 -0
  92. package/apps/control-plane/test/epoch-tracking.spec.ts +4 -4
  93. package/apps/control-plane/test/feature-deletion-service.spec.ts +422 -0
  94. package/apps/control-plane/test/feature-lifecycle.spec.ts +202 -0
  95. package/apps/control-plane/test/git-spawn-error.spec.ts +24 -0
  96. package/apps/control-plane/test/incremental-gates.spec.ts +137 -0
  97. package/apps/control-plane/test/init-wizard.spec.ts +506 -0
  98. package/apps/control-plane/test/instance-isolation.spec.ts +83 -0
  99. package/apps/control-plane/test/issue-tracker.spec.ts +890 -0
  100. package/apps/control-plane/test/kernel.coverage.spec.ts +3 -5
  101. package/apps/control-plane/test/kernel.coverage2.spec.ts +871 -0
  102. package/apps/control-plane/test/kernel.spec.ts +13 -11
  103. package/apps/control-plane/test/lock-service.spec.ts +508 -0
  104. package/apps/control-plane/test/mcp-helpers.spec.ts +176 -0
  105. package/apps/control-plane/test/mcp.spec.ts +50 -15
  106. package/apps/control-plane/test/merge-service.spec.ts +67 -4
  107. package/apps/control-plane/test/multi-project.spec.ts +372 -0
  108. package/apps/control-plane/test/notifier-service.spec.ts +388 -0
  109. package/apps/control-plane/test/parallel-gates.spec.ts +312 -0
  110. package/apps/control-plane/test/patch-service.spec.ts +253 -0
  111. package/apps/control-plane/test/performance-analytics.spec.ts +338 -0
  112. package/apps/control-plane/test/planning-wave-executor.spec.ts +168 -0
  113. package/apps/control-plane/test/pr-monitor.spec.ts +385 -0
  114. package/apps/control-plane/test/providers.spec.ts +344 -1
  115. package/apps/control-plane/test/reactions.spec.ts +392 -0
  116. package/apps/control-plane/test/resume-command.spec.ts +390 -0
  117. package/apps/control-plane/test/run-coordinator.spec.ts +481 -2
  118. package/apps/control-plane/test/schema-date-time.spec.ts +46 -0
  119. package/apps/control-plane/test/service-retry-paths.spec.ts +30 -0
  120. package/apps/control-plane/test/services.spec.ts +95 -2
  121. package/apps/control-plane/test/session-management.spec.ts +450 -0
  122. package/apps/control-plane/test/spec-ingestion.spec.ts +190 -0
  123. package/apps/control-plane/test/supervisor-collaborators.spec.ts +699 -2
  124. package/apps/control-plane/test/supervisor.spec.ts +36 -30
  125. package/apps/control-plane/test/supervisor.unit.spec.ts +405 -0
  126. package/apps/control-plane/test/worker-decision-loop.spec.ts +57 -0
  127. package/apps/control-plane/test/workspace-hooks.spec.ts +177 -0
  128. package/apps/control-plane/vitest.config.ts +21 -5
  129. package/dist/apps/control-plane/application/adapters/adapter-registry.d.ts +44 -0
  130. package/dist/apps/control-plane/application/adapters/adapter-registry.js +76 -0
  131. package/dist/apps/control-plane/application/adapters/adapter-registry.js.map +1 -0
  132. package/dist/apps/control-plane/application/multi-project-loader.d.ts +31 -0
  133. package/dist/apps/control-plane/application/multi-project-loader.js +82 -0
  134. package/dist/apps/control-plane/application/multi-project-loader.js.map +1 -0
  135. package/dist/apps/control-plane/application/services/activity-monitor-service.d.ts +43 -0
  136. package/dist/apps/control-plane/application/services/activity-monitor-service.js +132 -0
  137. package/dist/apps/control-plane/application/services/activity-monitor-service.js.map +1 -0
  138. package/dist/apps/control-plane/application/services/cost-tracking-service.d.ts +28 -0
  139. package/dist/apps/control-plane/application/services/cost-tracking-service.js +48 -0
  140. package/dist/apps/control-plane/application/services/cost-tracking-service.js.map +1 -0
  141. package/dist/apps/control-plane/application/services/dependency-scheduler-service.d.ts +26 -0
  142. package/dist/apps/control-plane/application/services/dependency-scheduler-service.js +75 -0
  143. package/dist/apps/control-plane/application/services/dependency-scheduler-service.js.map +1 -0
  144. package/dist/apps/control-plane/application/services/feature-deletion-service.d.ts +2 -0
  145. package/dist/apps/control-plane/application/services/feature-deletion-service.js +6 -7
  146. package/dist/apps/control-plane/application/services/feature-deletion-service.js.map +1 -1
  147. package/dist/apps/control-plane/application/services/gate-interpolation-service.d.ts +7 -0
  148. package/dist/apps/control-plane/application/services/gate-interpolation-service.js +7 -0
  149. package/dist/apps/control-plane/application/services/gate-interpolation-service.js.map +1 -0
  150. package/dist/apps/control-plane/application/services/gate-service.js +32 -2
  151. package/dist/apps/control-plane/application/services/gate-service.js.map +1 -1
  152. package/dist/apps/control-plane/application/services/instance-isolation-service.d.ts +11 -0
  153. package/dist/apps/control-plane/application/services/instance-isolation-service.js +17 -0
  154. package/dist/apps/control-plane/application/services/instance-isolation-service.js.map +1 -0
  155. package/dist/apps/control-plane/application/services/issue-tracker-service.d.ts +65 -0
  156. package/dist/apps/control-plane/application/services/issue-tracker-service.js +358 -0
  157. package/dist/apps/control-plane/application/services/issue-tracker-service.js.map +1 -0
  158. package/dist/apps/control-plane/application/services/merge-service.d.ts +4 -0
  159. package/dist/apps/control-plane/application/services/merge-service.js +44 -2
  160. package/dist/apps/control-plane/application/services/merge-service.js.map +1 -1
  161. package/dist/apps/control-plane/application/services/notifier-service.d.ts +74 -0
  162. package/dist/apps/control-plane/application/services/notifier-service.js +212 -0
  163. package/dist/apps/control-plane/application/services/notifier-service.js.map +1 -0
  164. package/dist/apps/control-plane/application/services/performance-analytics-service.d.ts +39 -0
  165. package/dist/apps/control-plane/application/services/performance-analytics-service.js +75 -0
  166. package/dist/apps/control-plane/application/services/performance-analytics-service.js.map +1 -0
  167. package/dist/apps/control-plane/application/services/plan-service.d.ts +1 -0
  168. package/dist/apps/control-plane/application/services/plan-service.js +53 -0
  169. package/dist/apps/control-plane/application/services/plan-service.js.map +1 -1
  170. package/dist/apps/control-plane/application/services/pr-monitor-service.d.ts +44 -0
  171. package/dist/apps/control-plane/application/services/pr-monitor-service.js +192 -0
  172. package/dist/apps/control-plane/application/services/pr-monitor-service.js.map +1 -0
  173. package/dist/apps/control-plane/application/services/reactions-service.d.ts +67 -0
  174. package/dist/apps/control-plane/application/services/reactions-service.js +114 -0
  175. package/dist/apps/control-plane/application/services/reactions-service.js.map +1 -0
  176. package/dist/apps/control-plane/application/services/reporting-service.d.ts +1 -0
  177. package/dist/apps/control-plane/application/services/reporting-service.js +13 -2
  178. package/dist/apps/control-plane/application/services/reporting-service.js.map +1 -1
  179. package/dist/apps/control-plane/application/services/run-lease-service.d.ts +2 -0
  180. package/dist/apps/control-plane/application/services/run-lease-service.js +14 -38
  181. package/dist/apps/control-plane/application/services/run-lease-service.js.map +1 -1
  182. package/dist/apps/control-plane/application/tools/tool-metadata.js +3 -1
  183. package/dist/apps/control-plane/application/tools/tool-metadata.js.map +1 -1
  184. package/dist/apps/control-plane/cli/aop.d.ts +1 -1
  185. package/dist/apps/control-plane/cli/aop.js +1 -1
  186. package/dist/apps/control-plane/cli/attach-command-handler.d.ts +12 -0
  187. package/dist/apps/control-plane/cli/attach-command-handler.js +98 -0
  188. package/dist/apps/control-plane/cli/attach-command-handler.js.map +1 -0
  189. package/dist/apps/control-plane/cli/cleanup-command-handler.d.ts +12 -0
  190. package/dist/apps/control-plane/cli/cleanup-command-handler.js +162 -0
  191. package/dist/apps/control-plane/cli/cleanup-command-handler.js.map +1 -0
  192. package/dist/apps/control-plane/cli/cli-argument-parser.js +73 -3
  193. package/dist/apps/control-plane/cli/cli-argument-parser.js.map +1 -1
  194. package/dist/apps/control-plane/cli/dashboard-command-handler.d.ts +7 -0
  195. package/dist/apps/control-plane/cli/dashboard-command-handler.js +45 -0
  196. package/dist/apps/control-plane/cli/dashboard-command-handler.js.map +1 -0
  197. package/dist/apps/control-plane/cli/help-command-handler.d.ts +8 -0
  198. package/dist/apps/control-plane/cli/help-command-handler.js +146 -0
  199. package/dist/apps/control-plane/cli/help-command-handler.js.map +1 -0
  200. package/dist/apps/control-plane/cli/init-command-handler.d.ts +26 -0
  201. package/dist/apps/control-plane/cli/init-command-handler.js +517 -0
  202. package/dist/apps/control-plane/cli/init-command-handler.js.map +1 -0
  203. package/dist/apps/control-plane/cli/resume-command-handler.js +1 -1
  204. package/dist/apps/control-plane/cli/resume-command-handler.js.map +1 -1
  205. package/dist/apps/control-plane/cli/retry-command-handler.d.ts +8 -0
  206. package/dist/apps/control-plane/cli/retry-command-handler.js +111 -0
  207. package/dist/apps/control-plane/cli/retry-command-handler.js.map +1 -0
  208. package/dist/apps/control-plane/cli/run-command-handler.d.ts +5 -0
  209. package/dist/apps/control-plane/cli/run-command-handler.js +82 -3
  210. package/dist/apps/control-plane/cli/run-command-handler.js.map +1 -1
  211. package/dist/apps/control-plane/cli/send-command-handler.d.ts +8 -0
  212. package/dist/apps/control-plane/cli/send-command-handler.js +55 -0
  213. package/dist/apps/control-plane/cli/send-command-handler.js.map +1 -0
  214. package/dist/apps/control-plane/cli/status-command-handler.d.ts +12 -1
  215. package/dist/apps/control-plane/cli/status-command-handler.js +55 -2
  216. package/dist/apps/control-plane/cli/status-command-handler.js.map +1 -1
  217. package/dist/apps/control-plane/cli/types.d.ts +26 -1
  218. package/dist/apps/control-plane/cli/types.js +15 -1
  219. package/dist/apps/control-plane/cli/types.js.map +1 -1
  220. package/dist/apps/control-plane/core/constants.d.ts +6 -0
  221. package/dist/apps/control-plane/core/constants.js +8 -2
  222. package/dist/apps/control-plane/core/constants.js.map +1 -1
  223. package/dist/apps/control-plane/core/error-codes.d.ts +2 -0
  224. package/dist/apps/control-plane/core/error-codes.js +3 -1
  225. package/dist/apps/control-plane/core/error-codes.js.map +1 -1
  226. package/dist/apps/control-plane/core/gates.d.ts +4 -0
  227. package/dist/apps/control-plane/core/gates.js +140 -43
  228. package/dist/apps/control-plane/core/gates.js.map +1 -1
  229. package/dist/apps/control-plane/core/kernel.d.ts +50 -1
  230. package/dist/apps/control-plane/core/kernel.js +220 -7
  231. package/dist/apps/control-plane/core/kernel.js.map +1 -1
  232. package/dist/apps/control-plane/core/path-layout.d.ts +3 -0
  233. package/dist/apps/control-plane/core/path-layout.js +9 -0
  234. package/dist/apps/control-plane/core/path-layout.js.map +1 -1
  235. package/dist/apps/control-plane/core/tool-caller.d.ts +32 -0
  236. package/dist/apps/control-plane/core/tool-caller.js +2 -0
  237. package/dist/apps/control-plane/core/tool-caller.js.map +1 -0
  238. package/dist/apps/control-plane/core/workspace-hooks.d.ts +20 -0
  239. package/dist/apps/control-plane/core/workspace-hooks.js +69 -0
  240. package/dist/apps/control-plane/core/workspace-hooks.js.map +1 -0
  241. package/dist/apps/control-plane/interfaces/cli/bootstrap.js +245 -9
  242. package/dist/apps/control-plane/interfaces/cli/bootstrap.js.map +1 -1
  243. package/dist/apps/control-plane/providers/providers.d.ts +42 -3
  244. package/dist/apps/control-plane/providers/providers.js +216 -5
  245. package/dist/apps/control-plane/providers/providers.js.map +1 -1
  246. package/dist/apps/control-plane/supervisor/build-wave-executor.d.ts +3 -0
  247. package/dist/apps/control-plane/supervisor/build-wave-executor.js +115 -6
  248. package/dist/apps/control-plane/supervisor/build-wave-executor.js.map +1 -1
  249. package/dist/apps/control-plane/supervisor/qa-wave-executor.d.ts +3 -0
  250. package/dist/apps/control-plane/supervisor/qa-wave-executor.js +109 -5
  251. package/dist/apps/control-plane/supervisor/qa-wave-executor.js.map +1 -1
  252. package/dist/apps/control-plane/supervisor/run-coordinator.d.ts +15 -0
  253. package/dist/apps/control-plane/supervisor/run-coordinator.js +132 -6
  254. package/dist/apps/control-plane/supervisor/run-coordinator.js.map +1 -1
  255. package/dist/apps/control-plane/supervisor/runtime.d.ts +3 -0
  256. package/dist/apps/control-plane/supervisor/runtime.js +110 -6
  257. package/dist/apps/control-plane/supervisor/runtime.js.map +1 -1
  258. package/dist/apps/control-plane/supervisor/types.d.ts +9 -16
  259. package/dist/apps/control-plane/supervisor/types.js.map +1 -1
  260. package/dist/apps/control-plane/supervisor/worker-decision-loop.d.ts +3 -0
  261. package/dist/apps/control-plane/supervisor/worker-decision-loop.js +5 -0
  262. package/dist/apps/control-plane/supervisor/worker-decision-loop.js.map +1 -1
  263. package/eslint.config.mjs +2 -1
  264. package/package.json +12 -2
  265. package/packages/web-dashboard/next-env.d.ts +5 -0
  266. package/packages/web-dashboard/next.config.js +7 -0
  267. package/packages/web-dashboard/package.json +26 -0
  268. package/packages/web-dashboard/src/app/api/actions/route.ts +64 -0
  269. package/packages/web-dashboard/src/app/api/events/route.ts +51 -0
  270. package/packages/web-dashboard/src/app/api/features/[id]/checkout/route.ts +256 -0
  271. package/packages/web-dashboard/src/app/api/features/[id]/diff/route.ts +10 -0
  272. package/packages/web-dashboard/src/app/api/features/[id]/evidence/[artifact]/route.ts +25 -0
  273. package/packages/web-dashboard/src/app/api/features/[id]/review/route.ts +63 -0
  274. package/packages/web-dashboard/src/app/api/features/[id]/route.ts +16 -0
  275. package/packages/web-dashboard/src/app/api/projects/route.ts +31 -0
  276. package/packages/web-dashboard/src/app/api/status/route.ts +15 -0
  277. package/packages/web-dashboard/src/app/globals.css +2 -0
  278. package/packages/web-dashboard/src/app/layout.tsx +15 -0
  279. package/packages/web-dashboard/src/app/page.tsx +393 -0
  280. package/packages/web-dashboard/src/lib/aop-client.ts +244 -0
  281. package/packages/web-dashboard/src/lib/multi-project-config.ts +116 -0
  282. package/packages/web-dashboard/src/lib/orchestrator-tools.ts +284 -0
  283. package/packages/web-dashboard/src/lib/types.ts +58 -0
  284. package/packages/web-dashboard/tsconfig.json +40 -0
  285. package/packages/web-dashboard/vitest.config.ts +6 -0
  286. package/spec-files/completed/agentic_orchestrator_feature_gaps_closure_spec.md +1764 -0
  287. package/spec-files/outstanding/agentic_orchestrator_enterprise_governance_dashboard_spec.md +348 -0
  288. package/spec-files/outstanding/agentic_orchestrator_knowledge_canary_spec.md +344 -0
  289. package/spec-files/outstanding/agentic_orchestrator_observability_integrity_diagnostics_spec.md +374 -0
  290. package/spec-files/outstanding/agentic_orchestrator_performance_improvements_spec.md +1059 -0
  291. package/spec-files/outstanding/agentic_orchestrator_planning_review_quality_spec.md +466 -0
  292. package/spec-files/outstanding/agentic_orchestrator_quality_adoption_execution_spec.md +198 -0
  293. package/spec-files/outstanding/agentic_orchestrator_validator_hardening_spec.md +365 -0
  294. package/spec-files/progress.md +481 -52
  295. /package/spec-files/{agentic_orchestrator_cli_delete_command_spec.md → completed/agentic_orchestrator_cli_delete_command_spec.md} +0 -0
  296. /package/spec-files/{agentic_orchestrator_dot_aop_generated_artifacts_spec.md → completed/agentic_orchestrator_dot_aop_generated_artifacts_spec.md} +0 -0
  297. /package/spec-files/{agentic_orchestrator_mcp_formalization_spec.md → completed/agentic_orchestrator_mcp_formalization_spec.md} +0 -0
  298. /package/spec-files/{agentic_orchestrator_oop_refactor_spec.md → completed/agentic_orchestrator_oop_refactor_spec.md} +0 -0
  299. /package/spec-files/{agentic_orchestrator_single_global_orchestrator_spec.md → completed/agentic_orchestrator_single_global_orchestrator_spec.md} +0 -0
  300. /package/spec-files/{agentic_orchestrator_spec.md → completed/agentic_orchestrator_spec.md} +0 -0
@@ -0,0 +1,560 @@
1
+ import fs from 'node:fs/promises';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
5
+
6
+ // ── hoisted mocks ─────────────────────────────────────────────────────────────
7
+
8
+ const ensureLoadedMock = vi.hoisted(() => vi.fn(async () => undefined));
9
+ const createToolingRuntimeMock = vi.hoisted(() => vi.fn(async () => ({ runtime: 'ok' })));
10
+ const resolveToolClientMock = vi.hoisted(() => vi.fn());
11
+ const toolCallMock = vi.hoisted(() => vi.fn(async () => ({ ok: true, data: {} })));
12
+ const readlineQuestionMock = vi.hoisted(() => vi.fn(async () => ''));
13
+ const readlineCloseMock = vi.hoisted(() => vi.fn());
14
+
15
+ vi.mock('node:readline/promises', () => ({
16
+ default: {
17
+ createInterface: vi.fn(() => ({
18
+ question: readlineQuestionMock,
19
+ close: readlineCloseMock
20
+ }))
21
+ }
22
+ }));
23
+
24
+ vi.mock('../src/core/kernel.js', () => {
25
+ class AopKernel {
26
+ private readonly repoRoot: string;
27
+
28
+ constructor(repoRoot: string) {
29
+ this.repoRoot = repoRoot;
30
+ }
31
+
32
+ async ensureLoaded() {
33
+ await ensureLoadedMock();
34
+ }
35
+
36
+ getRepoRoot() {
37
+ return this.repoRoot;
38
+ }
39
+
40
+ getAgentsConfig() {
41
+ return {};
42
+ }
43
+
44
+ getRbacPolicy() {
45
+ return {};
46
+ }
47
+
48
+ getPolicySnapshot() {
49
+ return {};
50
+ }
51
+
52
+ setProvider() {
53
+ // no-op for CLI tests
54
+ }
55
+ }
56
+
57
+ return { AopKernel };
58
+ });
59
+
60
+ vi.mock('../src/mcp/runtime-factory.js', () => ({
61
+ createToolingRuntime: createToolingRuntimeMock,
62
+ resolveToolClient: resolveToolClientMock
63
+ }));
64
+
65
+ vi.mock('../src/cli/init-command-handler.js', () => ({
66
+ InitCommandHandler: vi.fn().mockImplementation(() => ({
67
+ execute: vi.fn(async () => ({
68
+ ok: true,
69
+ data: {
70
+ command: 'init',
71
+ created: [],
72
+ updated: [],
73
+ skipped: [],
74
+ validation_warnings: [],
75
+ next_steps: []
76
+ }
77
+ }))
78
+ }))
79
+ }));
80
+
81
+ vi.mock('../src/cli/dashboard-command-handler.js', () => ({
82
+ DashboardCommandHandler: vi.fn().mockImplementation(() => ({
83
+ execute: vi.fn(async () => ({ ok: true, data: { message: 'started', port: 3000 } }))
84
+ }))
85
+ }));
86
+
87
+ vi.mock('../src/cli/run-command-handler.js', () => ({
88
+ RunCommandHandler: vi.fn().mockImplementation(() => ({
89
+ execute: vi.fn(async () => ({ ok: true, data: { status: 'running' } }))
90
+ }))
91
+ }));
92
+
93
+ vi.mock('../src/cli/resume-command-handler.js', () => ({
94
+ ResumeCommandHandler: vi.fn().mockImplementation(() => ({
95
+ execute: vi.fn(async () => ({ ok: true, data: { resumed: false } }))
96
+ }))
97
+ }));
98
+
99
+ // ── helpers ───────────────────────────────────────────────────────────────────
100
+
101
+ function asJsonWrites(spy: ReturnType<typeof vi.spyOn>): unknown[] {
102
+ return spy.mock.calls.flatMap((call) => {
103
+ try {
104
+ const arg = call[0];
105
+ if (typeof arg === 'string') {
106
+ return [JSON.parse(arg)];
107
+ }
108
+ return [];
109
+ } catch {
110
+ return [];
111
+ }
112
+ });
113
+ }
114
+
115
+ async function writeMultiProjectYaml(dir: string, content: string): Promise<void> {
116
+ const configDir = path.join(dir, 'agentic', 'orchestrator');
117
+ await fs.mkdir(configDir, { recursive: true });
118
+ await fs.writeFile(path.join(configDir, 'multi-project.yaml'), content, 'utf8');
119
+ }
120
+
121
+ async function writeSchemaFile(dir: string): Promise<void> {
122
+ const schemasDir = path.join(dir, 'agentic', 'orchestrator', 'schemas');
123
+ await fs.mkdir(schemasDir, { recursive: true });
124
+ const repoRoot = path.resolve(import.meta.dirname, '../../../');
125
+ const srcSchema = path.join(repoRoot, 'agentic', 'orchestrator', 'schemas', 'multi-project.schema.json');
126
+ const destSchema = path.join(schemasDir, 'multi-project.schema.json');
127
+ await fs.copyFile(srcSchema, destSchema);
128
+ }
129
+
130
+ // ── tests ─────────────────────────────────────────────────────────────────────
131
+
132
+ describe('bootstrap runCli', () => {
133
+ let stdoutSpy: ReturnType<typeof vi.spyOn>;
134
+
135
+ beforeEach(() => {
136
+ resolveToolClientMock.mockReturnValue({ call: toolCallMock });
137
+ toolCallMock.mockClear();
138
+ ensureLoadedMock.mockClear();
139
+ createToolingRuntimeMock.mockClear();
140
+ stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
141
+ });
142
+
143
+ afterEach(() => {
144
+ stdoutSpy.mockRestore();
145
+ vi.clearAllMocks();
146
+ });
147
+
148
+ it('GIVEN_stop_command_WHEN_executed_THEN_returns_stop_not_implemented_yet', async () => {
149
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
150
+ const code = await runCli(['stop'], { cwd: '/tmp', env: process.env });
151
+
152
+ const writes = asJsonWrites(stdoutSpy);
153
+ expect(code).toBe(0);
154
+ expect(writes[0]).toMatchObject({ ok: true, data: { status: 'stop_not_implemented_yet' } });
155
+ });
156
+
157
+ it('GIVEN_delete_command_with_feature_id_and_yes_WHEN_executed_THEN_calls_toolClient', async () => {
158
+ toolCallMock.mockResolvedValueOnce({ ok: true, data: { deleted: true } });
159
+
160
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
161
+ const code = await runCli(['delete', '--feature-id', 'feat_x', '--yes'], {
162
+ cwd: '/tmp',
163
+ env: process.env
164
+ });
165
+
166
+ const writes = asJsonWrites(stdoutSpy);
167
+ expect(code).toBe(0);
168
+ expect(toolCallMock).toHaveBeenCalled();
169
+ expect(writes[0]).toMatchObject({ ok: true, data: { command: 'delete' } });
170
+ });
171
+
172
+ it('GIVEN_retry_command_with_feature_id_no_force_WHEN_executed_THEN_runs_gate_retry_without_reset', async () => {
173
+ toolCallMock
174
+ .mockResolvedValueOnce({ ok: true, data: { front_matter: { version: 1, status: 'qa' } } })
175
+ .mockResolvedValueOnce({ ok: true, data: { overall: 'pass' } });
176
+
177
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
178
+ const code = await runCli(['retry', '--feature-id', 'feat_x'], {
179
+ cwd: '/tmp',
180
+ env: process.env
181
+ });
182
+
183
+ const writes = asJsonWrites(stdoutSpy);
184
+ expect(code).toBe(0);
185
+ expect(writes[0]).toMatchObject({
186
+ ok: true,
187
+ data: { feature_id: 'feat_x', retry_count_reset: false, retry_executed: true }
188
+ });
189
+ expect(toolCallMock).toHaveBeenCalled();
190
+ });
191
+
192
+ it('GIVEN_send_command_with_feature_id_and_message_WHEN_executed_THEN_calls_toolClient_and_returns_ok', async () => {
193
+ toolCallMock.mockResolvedValueOnce({ ok: true, data: { queued: true } });
194
+
195
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
196
+ const code = await runCli(['send', '--feature-id', 'feat_x', '--message', 'hello'], {
197
+ cwd: '/tmp',
198
+ env: process.env
199
+ });
200
+
201
+ const writes = asJsonWrites(stdoutSpy);
202
+ expect(code).toBe(0);
203
+ expect(toolCallMock).toHaveBeenCalled();
204
+ expect(writes[0]).toMatchObject({ ok: true, data: { command: 'send' } });
205
+ });
206
+
207
+ it('GIVEN_attach_command_without_feature_id_WHEN_executed_THEN_returns_exit_code_1', async () => {
208
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
209
+ const code = await runCli(['attach'], { cwd: '/tmp', env: process.env });
210
+ // attach without feature_id should fail with an error
211
+ expect(code).toBe(1);
212
+ });
213
+
214
+ it('GIVEN_cleanup_command_dry_run_WHEN_executed_THEN_returns_would_clean_and_cleaned', async () => {
215
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
216
+ const code = await runCli(['cleanup', '--dry-run'], { cwd: '/tmp', env: process.env });
217
+
218
+ const writes = asJsonWrites(stdoutSpy);
219
+ expect(code).toBe(0);
220
+ expect(writes[0]).toMatchObject({
221
+ ok: true,
222
+ data: expect.objectContaining({ would_clean: expect.any(Array), cleaned: expect.any(Array) })
223
+ });
224
+ });
225
+
226
+ it('GIVEN_unknown_command_WHEN_executed_THEN_returns_exit_code_1_with_error', async () => {
227
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
228
+ const code = await runCli(['unknown-command'], { cwd: '/tmp', env: process.env });
229
+
230
+ const writes = asJsonWrites(stdoutSpy);
231
+ expect(code).toBe(1);
232
+ expect(writes[0]).toMatchObject({
233
+ ok: false,
234
+ error: expect.objectContaining({ message: expect.stringContaining('unknown-command') })
235
+ });
236
+ });
237
+
238
+ it('GIVEN_init_command_WHEN_executed_THEN_returns_ok', async () => {
239
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
240
+ const code = await runCli(['init'], { cwd: '/tmp', env: process.env });
241
+
242
+ const writes = asJsonWrites(stdoutSpy);
243
+ expect(code).toBe(0);
244
+ expect(writes[0]).toMatchObject({ ok: true, data: { command: 'init' } });
245
+ });
246
+
247
+ it('GIVEN_dashboard_command_WHEN_executed_THEN_returns_ok', async () => {
248
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
249
+ const code = await runCli(['dashboard'], { cwd: '/tmp', env: process.env });
250
+
251
+ const writes = asJsonWrites(stdoutSpy);
252
+ expect(code).toBe(0);
253
+ expect(writes[0]).toMatchObject({ ok: true, data: { port: 3000 } });
254
+ });
255
+
256
+ it('GIVEN_run_command_WHEN_executed_THEN_returns_ok', async () => {
257
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
258
+ const code = await runCli(['run'], { cwd: '/tmp', env: process.env });
259
+
260
+ const writes = asJsonWrites(stdoutSpy);
261
+ expect(code).toBe(0);
262
+ expect(writes[0]).toMatchObject({ ok: true, data: { status: 'running' } });
263
+ });
264
+
265
+ it('GIVEN_resume_command_WHEN_executed_THEN_returns_ok', async () => {
266
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
267
+ const code = await runCli(['resume'], { cwd: '/tmp', env: process.env });
268
+
269
+ const writes = asJsonWrites(stdoutSpy);
270
+ expect(code).toBe(0);
271
+ expect(writes[0]).toMatchObject({ ok: true, data: { resumed: false } });
272
+ });
273
+
274
+ it('GIVEN_ensureLoaded_throws_WHEN_run_command_executed_THEN_returns_exit_code_1', async () => {
275
+ ensureLoadedMock.mockRejectedValueOnce(
276
+ Object.assign(new Error('config load failed'), { code: 'CONFIG_LOAD_ERROR' })
277
+ );
278
+
279
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
280
+ const code = await runCli(['run'], { cwd: '/tmp', env: process.env });
281
+
282
+ const writes = asJsonWrites(stdoutSpy);
283
+ expect(code).toBe(1);
284
+ expect(writes[0]).toMatchObject({ ok: false, error: expect.objectContaining({ message: 'config load failed' }) });
285
+ });
286
+
287
+ it('GIVEN_project_flag_with_no_multi_project_yaml_WHEN_executed_THEN_returns_exit_code_1', async () => {
288
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
289
+ // /tmp has no multi-project.yaml
290
+ const code = await runCli(['status', '--project', 'alpha'], { cwd: '/tmp', env: process.env });
291
+
292
+ const writes = asJsonWrites(stdoutSpy);
293
+ expect(code).toBe(1);
294
+ expect(writes[0]).toMatchObject({
295
+ ok: false,
296
+ error: expect.objectContaining({ message: expect.stringContaining('multi-project.yaml') })
297
+ });
298
+ });
299
+ });
300
+
301
+ describe('bootstrap runCli status --all with multi-project yaml', () => {
302
+ let tmpDir: string;
303
+ let stdoutSpy: ReturnType<typeof vi.spyOn>;
304
+
305
+ beforeEach(async () => {
306
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'aop-bootstrap-'));
307
+ await writeSchemaFile(tmpDir);
308
+ resolveToolClientMock.mockReturnValue({ call: toolCallMock });
309
+ toolCallMock.mockResolvedValue({ ok: true, data: { features: [] } });
310
+ ensureLoadedMock.mockClear();
311
+ createToolingRuntimeMock.mockClear();
312
+ stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
313
+ });
314
+
315
+ afterEach(async () => {
316
+ stdoutSpy.mockRestore();
317
+ vi.clearAllMocks();
318
+ await fs.rm(tmpDir, { recursive: true, force: true });
319
+ });
320
+
321
+ it('GIVEN_multi_project_yaml_with_2_projects_WHEN_status_all_THEN_aggregates_both_project_statuses', async () => {
322
+ const proj1 = path.join(tmpDir, 'proj1');
323
+ const proj2 = path.join(tmpDir, 'proj2');
324
+ await fs.mkdir(proj1, { recursive: true });
325
+ await fs.mkdir(proj2, { recursive: true });
326
+
327
+ await writeMultiProjectYaml(
328
+ tmpDir,
329
+ `
330
+ version: "1.0"
331
+ projects:
332
+ - name: proj1
333
+ path: ${proj1}
334
+ - name: proj2
335
+ path: ${proj2}
336
+ `
337
+ );
338
+
339
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
340
+ const code = await runCli(['status', '--all'], { cwd: tmpDir, env: process.env });
341
+
342
+ const writes = asJsonWrites(stdoutSpy);
343
+ expect(code).toBe(0);
344
+ expect(writes[0]).toMatchObject({
345
+ ok: true,
346
+ data: {
347
+ projects: expect.arrayContaining([
348
+ expect.objectContaining({ name: 'proj1' }),
349
+ expect.objectContaining({ name: 'proj2' })
350
+ ])
351
+ }
352
+ });
353
+ });
354
+
355
+ it('GIVEN_multi_project_yaml_where_one_project_errors_WHEN_status_all_THEN_aggregate_includes_error_entry', async () => {
356
+ const projGood = path.join(tmpDir, 'proj-good');
357
+ await fs.mkdir(projGood, { recursive: true });
358
+
359
+ await writeMultiProjectYaml(
360
+ tmpDir,
361
+ `
362
+ version: "1.0"
363
+ projects:
364
+ - name: proj-good
365
+ path: ${projGood}
366
+ - name: proj-bad
367
+ path: /nonexistent/path/that/will/fail
368
+ `
369
+ );
370
+
371
+ // First project succeeds, second causes ensureLoaded to fail
372
+ ensureLoadedMock
373
+ .mockResolvedValueOnce(undefined)
374
+ .mockRejectedValueOnce(Object.assign(new Error('project load error'), { code: 'CONFIG_LOAD_ERROR' }));
375
+
376
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
377
+ const code = await runCli(['status', '--all'], { cwd: tmpDir, env: process.env });
378
+
379
+ const writes = asJsonWrites(stdoutSpy);
380
+ expect(code).toBe(0);
381
+ const aggregate = writes[0] as { ok: boolean; data: { projects: Array<{ name: string; status: unknown }> } };
382
+ expect(aggregate.ok).toBe(true);
383
+ expect(aggregate.data.projects).toHaveLength(2);
384
+ const badProject = aggregate.data.projects.find((p) => p.name === 'proj-bad');
385
+ expect(badProject?.status).toMatchObject({ ok: false });
386
+ });
387
+ });
388
+
389
+ describe('bootstrap multi-project selection branches', () => {
390
+ let tmpDir: string;
391
+ let stdoutSpy: ReturnType<typeof vi.spyOn>;
392
+
393
+ beforeEach(async () => {
394
+ tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'aop-bootstrap-sel-'));
395
+ await writeSchemaFile(tmpDir);
396
+ resolveToolClientMock.mockReturnValue({ call: toolCallMock });
397
+ toolCallMock.mockResolvedValue({ ok: true, data: { features: [] } });
398
+ ensureLoadedMock.mockClear();
399
+ createToolingRuntimeMock.mockClear();
400
+ stdoutSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
401
+ });
402
+
403
+ afterEach(async () => {
404
+ stdoutSpy.mockRestore();
405
+ vi.clearAllMocks();
406
+ await fs.rm(tmpDir, { recursive: true, force: true });
407
+ });
408
+
409
+ it('GIVEN_single_project_multi_yaml_WHEN_status_no_project_flag_THEN_auto_selects_only_project', async () => {
410
+ const proj1 = path.join(tmpDir, 'proj1');
411
+ await fs.mkdir(proj1, { recursive: true });
412
+ await writeMultiProjectYaml(tmpDir, `version: "1.0"\nprojects:\n - name: proj1\n path: ${proj1}\n`);
413
+
414
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
415
+ const code = await runCli(['status'], { cwd: tmpDir, env: process.env });
416
+ expect(code).toBe(0);
417
+ });
418
+
419
+ it('GIVEN_multi_project_yaml_where_cwd_matches_project_path_WHEN_status_THEN_auto_selects_cwd_project', async () => {
420
+ const proj1 = path.join(tmpDir, 'proj1');
421
+ const proj2 = path.join(tmpDir, 'proj2');
422
+ await fs.mkdir(proj1, { recursive: true });
423
+ await fs.mkdir(proj2, { recursive: true });
424
+ await writeMultiProjectYaml(
425
+ tmpDir,
426
+ `version: "1.0"\nprojects:\n - name: proj1\n path: ${proj1}\n - name: proj2\n path: ${proj2}\n`
427
+ );
428
+
429
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
430
+ // cwd is inside proj1 → selectProjectByCwd should match proj1
431
+ const code = await runCli(['status'], { cwd: proj1, env: process.env });
432
+ expect(code).toBe(0);
433
+ });
434
+
435
+ it('GIVEN_multi_project_yaml_with_default_project_WHEN_status_and_cwd_no_match_THEN_uses_default', async () => {
436
+ const proj1 = path.join(tmpDir, 'proj1');
437
+ const proj2 = path.join(tmpDir, 'proj2');
438
+ await fs.mkdir(proj1, { recursive: true });
439
+ await fs.mkdir(proj2, { recursive: true });
440
+ await writeMultiProjectYaml(
441
+ tmpDir,
442
+ `version: "1.0"\nprojects:\n - name: proj1\n path: ${proj1}\n - name: proj2\n path: ${proj2}\ndefaults:\n default_project: proj1\n`
443
+ );
444
+
445
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
446
+ // cwd is tmpDir itself (not a project path) → no cwd match → uses default_project
447
+ const code = await runCli(['status'], { cwd: tmpDir, env: process.env });
448
+ expect(code).toBe(0);
449
+ });
450
+
451
+ it('GIVEN_multi_project_yaml_no_default_and_no_tty_WHEN_status_THEN_returns_exit_code_1', async () => {
452
+ const proj1 = path.join(tmpDir, 'proj1');
453
+ const proj2 = path.join(tmpDir, 'proj2');
454
+ await fs.mkdir(proj1, { recursive: true });
455
+ await fs.mkdir(proj2, { recursive: true });
456
+ await writeMultiProjectYaml(
457
+ tmpDir,
458
+ `version: "1.0"\nprojects:\n - name: proj1\n path: ${proj1}\n - name: proj2\n path: ${proj2}\n`
459
+ );
460
+
461
+ // Mock stdin/stdout to simulate non-TTY environment
462
+ const origStdinIsTTY = process.stdin.isTTY;
463
+ const origStdoutIsTTY = process.stdout.isTTY;
464
+ Object.defineProperty(process.stdin, 'isTTY', { value: false, configurable: true });
465
+ Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true });
466
+
467
+ try {
468
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
469
+ // cwd is tmpDir itself (no project match, no default, non-TTY) → exit code 1
470
+ const code = await runCli(['status'], { cwd: tmpDir, env: process.env });
471
+ expect(code).toBe(1);
472
+ } finally {
473
+ Object.defineProperty(process.stdin, 'isTTY', { value: origStdinIsTTY, configurable: true });
474
+ Object.defineProperty(process.stdout, 'isTTY', { value: origStdoutIsTTY, configurable: true });
475
+ }
476
+ });
477
+
478
+ it('GIVEN_project_flag_and_project_not_found_WHEN_run_THEN_returns_exit_code_1', async () => {
479
+ const proj1 = path.join(tmpDir, 'proj1');
480
+ await fs.mkdir(proj1, { recursive: true });
481
+ await writeMultiProjectYaml(tmpDir, `version: "1.0"\nprojects:\n - name: proj1\n path: ${proj1}\n`);
482
+
483
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
484
+ const code = await runCli(['status', '--project', 'nonexistent'], { cwd: tmpDir, env: process.env });
485
+ expect(code).toBe(1);
486
+ });
487
+
488
+ it('GIVEN_help_command_WHEN_run_THEN_prints_help_and_returns_0', async () => {
489
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
490
+ const code = await runCli(['help'], { cwd: tmpDir, env: process.env });
491
+ expect(code).toBe(0);
492
+ const helpText = stdoutSpy.mock.calls.map((c) => c[0]).join('');
493
+ expect(helpText).toContain('Commands:');
494
+ });
495
+
496
+ it('GIVEN_help_command_with_subcommand_WHEN_run_THEN_prints_command_detail', async () => {
497
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
498
+ const code = await runCli(['help', 'run'], { cwd: tmpDir, env: process.env });
499
+ expect(code).toBe(0);
500
+ });
501
+
502
+ it('GIVEN_tty_with_multiple_projects_WHEN_user_selects_valid_project_THEN_returns_0', async () => {
503
+ const proj1 = path.join(tmpDir, 'proj1');
504
+ const proj2 = path.join(tmpDir, 'proj2');
505
+ await fs.mkdir(proj1, { recursive: true });
506
+ await fs.mkdir(proj2, { recursive: true });
507
+ await writeMultiProjectYaml(
508
+ tmpDir,
509
+ `version: "1.0"\nprojects:\n - name: proj1\n path: ${proj1}\n - name: proj2\n path: ${proj2}\n`
510
+ );
511
+
512
+ // Simulate TTY and user entering '1' to select first project
513
+ readlineQuestionMock.mockResolvedValueOnce('1');
514
+ const origStdinIsTTY = process.stdin.isTTY;
515
+ const origStdoutIsTTY = process.stdout.isTTY;
516
+ Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
517
+ Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
518
+
519
+ try {
520
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
521
+ // cwd doesn't match any project path, no default → TTY → prompts user
522
+ const code = await runCli(['status'], { cwd: tmpDir, env: process.env });
523
+ expect(code).toBe(0);
524
+ expect(readlineQuestionMock).toHaveBeenCalled();
525
+ } finally {
526
+ Object.defineProperty(process.stdin, 'isTTY', { value: origStdinIsTTY, configurable: true });
527
+ Object.defineProperty(process.stdout, 'isTTY', { value: origStdoutIsTTY, configurable: true });
528
+ readlineQuestionMock.mockReset();
529
+ }
530
+ });
531
+
532
+ it('GIVEN_tty_with_multiple_projects_WHEN_user_enters_invalid_number_THEN_returns_1', async () => {
533
+ const proj1 = path.join(tmpDir, 'proj1');
534
+ const proj2 = path.join(tmpDir, 'proj2');
535
+ await fs.mkdir(proj1, { recursive: true });
536
+ await fs.mkdir(proj2, { recursive: true });
537
+ await writeMultiProjectYaml(
538
+ tmpDir,
539
+ `version: "1.0"\nprojects:\n - name: proj1\n path: ${proj1}\n - name: proj2\n path: ${proj2}\n`
540
+ );
541
+
542
+ // Simulate TTY and user entering 'abc' (invalid number)
543
+ readlineQuestionMock.mockResolvedValueOnce('abc');
544
+ const origStdinIsTTY = process.stdin.isTTY;
545
+ const origStdoutIsTTY = process.stdout.isTTY;
546
+ Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
547
+ Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
548
+
549
+ try {
550
+ const { runCli } = await import('../src/interfaces/cli/bootstrap.js');
551
+ const code = await runCli(['status'], { cwd: tmpDir, env: process.env });
552
+ // Invalid selection → null returned → exit code 1
553
+ expect(code).toBe(1);
554
+ } finally {
555
+ Object.defineProperty(process.stdin, 'isTTY', { value: origStdinIsTTY, configurable: true });
556
+ Object.defineProperty(process.stdout, 'isTTY', { value: origStdoutIsTTY, configurable: true });
557
+ readlineQuestionMock.mockReset();
558
+ }
559
+ });
560
+ });