agent-bober 0.11.6 → 0.15.0

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 (570) hide show
  1. package/CHANGELOG.md +311 -0
  2. package/README.md +124 -9
  3. package/agents/bober-architect.md +38 -0
  4. package/agents/bober-code-reviewer.md +236 -0
  5. package/agents/bober-curator.md +37 -0
  6. package/agents/bober-deployer.md +267 -0
  7. package/agents/bober-diagnoser.md +289 -0
  8. package/agents/bober-evaluator.md +127 -1
  9. package/agents/bober-generator.md +122 -3
  10. package/agents/bober-planner.md +293 -32
  11. package/agents/bober-postmortemer.md +185 -0
  12. package/agents/bober-researcher.md +38 -0
  13. package/dist/cli/commands/approve.d.ts +17 -0
  14. package/dist/cli/commands/approve.d.ts.map +1 -0
  15. package/dist/cli/commands/approve.js +64 -0
  16. package/dist/cli/commands/approve.js.map +1 -0
  17. package/dist/cli/commands/audit-show.d.ts +14 -0
  18. package/dist/cli/commands/audit-show.d.ts.map +1 -0
  19. package/dist/cli/commands/audit-show.js +85 -0
  20. package/dist/cli/commands/audit-show.js.map +1 -0
  21. package/dist/cli/commands/config.d.ts +10 -0
  22. package/dist/cli/commands/config.d.ts.map +1 -0
  23. package/dist/cli/commands/config.js +73 -0
  24. package/dist/cli/commands/config.js.map +1 -0
  25. package/dist/cli/commands/eval.js +6 -6
  26. package/dist/cli/commands/eval.js.map +1 -1
  27. package/dist/cli/commands/graph.d.ts +8 -0
  28. package/dist/cli/commands/graph.d.ts.map +1 -0
  29. package/dist/cli/commands/graph.js +219 -0
  30. package/dist/cli/commands/graph.js.map +1 -0
  31. package/dist/cli/commands/impact.d.ts +19 -0
  32. package/dist/cli/commands/impact.d.ts.map +1 -0
  33. package/dist/cli/commands/impact.js +191 -0
  34. package/dist/cli/commands/impact.js.map +1 -0
  35. package/dist/cli/commands/incident.d.ts +19 -0
  36. package/dist/cli/commands/incident.d.ts.map +1 -0
  37. package/dist/cli/commands/incident.js +324 -0
  38. package/dist/cli/commands/incident.js.map +1 -0
  39. package/dist/cli/commands/init.js +82 -3
  40. package/dist/cli/commands/init.js.map +1 -1
  41. package/dist/cli/commands/list-approvals.d.ts +16 -0
  42. package/dist/cli/commands/list-approvals.d.ts.map +1 -0
  43. package/dist/cli/commands/list-approvals.js +57 -0
  44. package/dist/cli/commands/list-approvals.js.map +1 -0
  45. package/dist/cli/commands/onboard.d.ts +3 -0
  46. package/dist/cli/commands/onboard.d.ts.map +1 -0
  47. package/dist/cli/commands/onboard.js +190 -0
  48. package/dist/cli/commands/onboard.js.map +1 -0
  49. package/dist/cli/commands/plan.d.ts +12 -0
  50. package/dist/cli/commands/plan.d.ts.map +1 -1
  51. package/dist/cli/commands/plan.js +232 -37
  52. package/dist/cli/commands/plan.js.map +1 -1
  53. package/dist/cli/commands/playbook.d.ts +17 -0
  54. package/dist/cli/commands/playbook.d.ts.map +1 -0
  55. package/dist/cli/commands/playbook.js +123 -0
  56. package/dist/cli/commands/playbook.js.map +1 -0
  57. package/dist/cli/commands/postmortem.d.ts +12 -0
  58. package/dist/cli/commands/postmortem.d.ts.map +1 -0
  59. package/dist/cli/commands/postmortem.js +67 -0
  60. package/dist/cli/commands/postmortem.js.map +1 -0
  61. package/dist/cli/commands/reject.d.ts +17 -0
  62. package/dist/cli/commands/reject.d.ts.map +1 -0
  63. package/dist/cli/commands/reject.js +52 -0
  64. package/dist/cli/commands/reject.js.map +1 -0
  65. package/dist/cli/commands/rollback.d.ts +21 -0
  66. package/dist/cli/commands/rollback.d.ts.map +1 -0
  67. package/dist/cli/commands/rollback.js +90 -0
  68. package/dist/cli/commands/rollback.js.map +1 -0
  69. package/dist/cli/commands/run.d.ts +9 -0
  70. package/dist/cli/commands/run.d.ts.map +1 -1
  71. package/dist/cli/commands/run.js +31 -2
  72. package/dist/cli/commands/run.js.map +1 -1
  73. package/dist/cli/commands/sprint.d.ts.map +1 -1
  74. package/dist/cli/commands/sprint.js +8 -8
  75. package/dist/cli/commands/sprint.js.map +1 -1
  76. package/dist/cli/commands/telemetry.d.ts +16 -0
  77. package/dist/cli/commands/telemetry.d.ts.map +1 -0
  78. package/dist/cli/commands/telemetry.js +152 -0
  79. package/dist/cli/commands/telemetry.js.map +1 -0
  80. package/dist/cli/commands/worktree.d.ts +12 -0
  81. package/dist/cli/commands/worktree.d.ts.map +1 -0
  82. package/dist/cli/commands/worktree.js +57 -0
  83. package/dist/cli/commands/worktree.js.map +1 -0
  84. package/dist/cli/index.js +73 -2
  85. package/dist/cli/index.js.map +1 -1
  86. package/dist/config/defaults.d.ts.map +1 -1
  87. package/dist/config/defaults.js +27 -0
  88. package/dist/config/defaults.js.map +1 -1
  89. package/dist/config/index.d.ts +1 -1
  90. package/dist/config/index.d.ts.map +1 -1
  91. package/dist/config/index.js +4 -0
  92. package/dist/config/index.js.map +1 -1
  93. package/dist/config/loader.d.ts.map +1 -1
  94. package/dist/config/loader.js +18 -1
  95. package/dist/config/loader.js.map +1 -1
  96. package/dist/config/schema.d.ts +1016 -96
  97. package/dist/config/schema.d.ts.map +1 -1
  98. package/dist/config/schema.js +147 -0
  99. package/dist/config/schema.js.map +1 -1
  100. package/dist/contracts/eval-result.d.ts +38 -38
  101. package/dist/contracts/index.d.ts +2 -2
  102. package/dist/contracts/index.d.ts.map +1 -1
  103. package/dist/contracts/index.js +8 -4
  104. package/dist/contracts/index.js.map +1 -1
  105. package/dist/contracts/spec.d.ts +335 -40
  106. package/dist/contracts/spec.d.ts.map +1 -1
  107. package/dist/contracts/spec.js +210 -18
  108. package/dist/contracts/spec.js.map +1 -1
  109. package/dist/contracts/sprint-contract.d.ts +155 -88
  110. package/dist/contracts/sprint-contract.d.ts.map +1 -1
  111. package/dist/contracts/sprint-contract.js +176 -29
  112. package/dist/contracts/sprint-contract.js.map +1 -1
  113. package/dist/evaluators/builtin/api-check.js +1 -1
  114. package/dist/evaluators/builtin/api-check.js.map +1 -1
  115. package/dist/graph/artifact-store.d.ts +14 -0
  116. package/dist/graph/artifact-store.d.ts.map +1 -0
  117. package/dist/graph/artifact-store.js +100 -0
  118. package/dist/graph/artifact-store.js.map +1 -0
  119. package/dist/graph/cli.d.ts +49 -0
  120. package/dist/graph/cli.d.ts.map +1 -0
  121. package/dist/graph/cli.js +140 -0
  122. package/dist/graph/cli.js.map +1 -0
  123. package/dist/graph/client.d.ts +64 -0
  124. package/dist/graph/client.d.ts.map +1 -0
  125. package/dist/graph/client.js +216 -0
  126. package/dist/graph/client.js.map +1 -0
  127. package/dist/graph/fallback.d.ts +13 -0
  128. package/dist/graph/fallback.d.ts.map +1 -0
  129. package/dist/graph/fallback.js +57 -0
  130. package/dist/graph/fallback.js.map +1 -0
  131. package/dist/graph/hook-handler.d.ts +50 -0
  132. package/dist/graph/hook-handler.d.ts.map +1 -0
  133. package/dist/graph/hook-handler.js +217 -0
  134. package/dist/graph/hook-handler.js.map +1 -0
  135. package/dist/graph/incidents.d.ts +59 -0
  136. package/dist/graph/incidents.d.ts.map +1 -0
  137. package/dist/graph/incidents.js +22 -0
  138. package/dist/graph/incidents.js.map +1 -0
  139. package/dist/graph/mcp-client.d.ts +51 -0
  140. package/dist/graph/mcp-client.d.ts.map +1 -0
  141. package/dist/graph/mcp-client.js +285 -0
  142. package/dist/graph/mcp-client.js.map +1 -0
  143. package/dist/graph/onboarding-composer.d.ts +30 -0
  144. package/dist/graph/onboarding-composer.d.ts.map +1 -0
  145. package/dist/graph/onboarding-composer.js +275 -0
  146. package/dist/graph/onboarding-composer.js.map +1 -0
  147. package/dist/graph/pipeline-lifecycle.d.ts +86 -0
  148. package/dist/graph/pipeline-lifecycle.d.ts.map +1 -0
  149. package/dist/graph/pipeline-lifecycle.js +329 -0
  150. package/dist/graph/pipeline-lifecycle.js.map +1 -0
  151. package/dist/graph/preflight-budgets.d.ts +52 -0
  152. package/dist/graph/preflight-budgets.d.ts.map +1 -0
  153. package/dist/graph/preflight-budgets.js +78 -0
  154. package/dist/graph/preflight-budgets.js.map +1 -0
  155. package/dist/graph/preflight-injector.d.ts +116 -0
  156. package/dist/graph/preflight-injector.d.ts.map +1 -0
  157. package/dist/graph/preflight-injector.js +538 -0
  158. package/dist/graph/preflight-injector.js.map +1 -0
  159. package/dist/graph/prereq.d.ts +12 -0
  160. package/dist/graph/prereq.d.ts.map +1 -0
  161. package/dist/graph/prereq.js +61 -0
  162. package/dist/graph/prereq.js.map +1 -0
  163. package/dist/graph/prompts.d.ts +42 -0
  164. package/dist/graph/prompts.d.ts.map +1 -0
  165. package/dist/graph/prompts.js +80 -0
  166. package/dist/graph/prompts.js.map +1 -0
  167. package/dist/graph/sandbox.d.ts +19 -0
  168. package/dist/graph/sandbox.d.ts.map +1 -0
  169. package/dist/graph/sandbox.js +25 -0
  170. package/dist/graph/sandbox.js.map +1 -0
  171. package/dist/graph/token-usage.d.ts +21 -0
  172. package/dist/graph/token-usage.d.ts.map +1 -0
  173. package/dist/graph/token-usage.js +22 -0
  174. package/dist/graph/token-usage.js.map +1 -0
  175. package/dist/graph/types.d.ts +129 -0
  176. package/dist/graph/types.d.ts.map +1 -0
  177. package/dist/graph/types.js +12 -0
  178. package/dist/graph/types.js.map +1 -0
  179. package/dist/incident/orchestrator.d.ts +168 -0
  180. package/dist/incident/orchestrator.d.ts.map +1 -0
  181. package/dist/incident/orchestrator.js +279 -0
  182. package/dist/incident/orchestrator.js.map +1 -0
  183. package/dist/incident/playbook-search.d.ts +67 -0
  184. package/dist/incident/playbook-search.d.ts.map +1 -0
  185. package/dist/incident/playbook-search.js +288 -0
  186. package/dist/incident/playbook-search.js.map +1 -0
  187. package/dist/incident/postmortem.d.ts +44 -0
  188. package/dist/incident/postmortem.d.ts.map +1 -0
  189. package/dist/incident/postmortem.js +486 -0
  190. package/dist/incident/postmortem.js.map +1 -0
  191. package/dist/incident/resolution-verify.d.ts +186 -0
  192. package/dist/incident/resolution-verify.d.ts.map +1 -0
  193. package/dist/incident/resolution-verify.js +210 -0
  194. package/dist/incident/resolution-verify.js.map +1 -0
  195. package/dist/incident/rollback.d.ts +137 -0
  196. package/dist/incident/rollback.d.ts.map +1 -0
  197. package/dist/incident/rollback.js +328 -0
  198. package/dist/incident/rollback.js.map +1 -0
  199. package/dist/incident/timeline.d.ts +147 -0
  200. package/dist/incident/timeline.d.ts.map +1 -0
  201. package/dist/incident/timeline.js +452 -0
  202. package/dist/incident/timeline.js.map +1 -0
  203. package/dist/incident/types.d.ts +335 -0
  204. package/dist/incident/types.d.ts.map +1 -0
  205. package/dist/incident/types.js +158 -0
  206. package/dist/incident/types.js.map +1 -0
  207. package/dist/index.d.ts +3 -3
  208. package/dist/index.d.ts.map +1 -1
  209. package/dist/index.js +3 -3
  210. package/dist/index.js.map +1 -1
  211. package/dist/mcp/event-stream.d.ts +46 -0
  212. package/dist/mcp/event-stream.d.ts.map +1 -0
  213. package/dist/mcp/event-stream.js +421 -0
  214. package/dist/mcp/event-stream.js.map +1 -0
  215. package/dist/mcp/external-client.d.ts +38 -0
  216. package/dist/mcp/external-client.d.ts.map +1 -0
  217. package/dist/mcp/external-client.js +121 -0
  218. package/dist/mcp/external-client.js.map +1 -0
  219. package/dist/mcp/run-manager.d.ts +74 -9
  220. package/dist/mcp/run-manager.d.ts.map +1 -1
  221. package/dist/mcp/run-manager.js +127 -31
  222. package/dist/mcp/run-manager.js.map +1 -1
  223. package/dist/mcp/server.d.ts.map +1 -1
  224. package/dist/mcp/server.js +56 -0
  225. package/dist/mcp/server.js.map +1 -1
  226. package/dist/mcp/tools/abort-run.d.ts +2 -0
  227. package/dist/mcp/tools/abort-run.d.ts.map +1 -0
  228. package/dist/mcp/tools/abort-run.js +62 -0
  229. package/dist/mcp/tools/abort-run.js.map +1 -0
  230. package/dist/mcp/tools/anchor.js +1 -1
  231. package/dist/mcp/tools/anchor.js.map +1 -1
  232. package/dist/mcp/tools/approve-checkpoint.d.ts +2 -0
  233. package/dist/mcp/tools/approve-checkpoint.d.ts.map +1 -0
  234. package/dist/mcp/tools/approve-checkpoint.js +70 -0
  235. package/dist/mcp/tools/approve-checkpoint.js.map +1 -0
  236. package/dist/mcp/tools/brownfield.js +1 -1
  237. package/dist/mcp/tools/brownfield.js.map +1 -1
  238. package/dist/mcp/tools/contracts.js +2 -2
  239. package/dist/mcp/tools/contracts.js.map +1 -1
  240. package/dist/mcp/tools/eval.js +8 -8
  241. package/dist/mcp/tools/eval.js.map +1 -1
  242. package/dist/mcp/tools/get-project-state.d.ts +2 -0
  243. package/dist/mcp/tools/get-project-state.d.ts.map +1 -0
  244. package/dist/mcp/tools/get-project-state.js +107 -0
  245. package/dist/mcp/tools/get-project-state.js.map +1 -0
  246. package/dist/mcp/tools/get-run-status.d.ts +2 -0
  247. package/dist/mcp/tools/get-run-status.d.ts.map +1 -0
  248. package/dist/mcp/tools/get-run-status.js +40 -0
  249. package/dist/mcp/tools/get-run-status.js.map +1 -0
  250. package/dist/mcp/tools/graph-schemas.d.ts +100 -0
  251. package/dist/mcp/tools/graph-schemas.d.ts.map +1 -0
  252. package/dist/mcp/tools/graph-schemas.js +39 -0
  253. package/dist/mcp/tools/graph-schemas.js.map +1 -0
  254. package/dist/mcp/tools/graph.d.ts +19 -0
  255. package/dist/mcp/tools/graph.d.ts.map +1 -0
  256. package/dist/mcp/tools/graph.js +263 -0
  257. package/dist/mcp/tools/graph.js.map +1 -0
  258. package/dist/mcp/tools/incident.d.ts +2 -0
  259. package/dist/mcp/tools/incident.d.ts.map +1 -0
  260. package/dist/mcp/tools/incident.js +246 -0
  261. package/dist/mcp/tools/incident.js.map +1 -0
  262. package/dist/mcp/tools/index.d.ts +38 -18
  263. package/dist/mcp/tools/index.d.ts.map +1 -1
  264. package/dist/mcp/tools/index.js +74 -18
  265. package/dist/mcp/tools/index.js.map +1 -1
  266. package/dist/mcp/tools/list-active-runs.d.ts +2 -0
  267. package/dist/mcp/tools/list-active-runs.d.ts.map +1 -0
  268. package/dist/mcp/tools/list-active-runs.js +35 -0
  269. package/dist/mcp/tools/list-active-runs.js.map +1 -0
  270. package/dist/mcp/tools/list-pending-approvals.d.ts +2 -0
  271. package/dist/mcp/tools/list-pending-approvals.d.ts.map +1 -0
  272. package/dist/mcp/tools/list-pending-approvals.js +40 -0
  273. package/dist/mcp/tools/list-pending-approvals.js.map +1 -0
  274. package/dist/mcp/tools/list-projects.d.ts +2 -0
  275. package/dist/mcp/tools/list-projects.d.ts.map +1 -0
  276. package/dist/mcp/tools/list-projects.js +101 -0
  277. package/dist/mcp/tools/list-projects.js.map +1 -0
  278. package/dist/mcp/tools/list-specs.d.ts +2 -0
  279. package/dist/mcp/tools/list-specs.d.ts.map +1 -0
  280. package/dist/mcp/tools/list-specs.js +48 -0
  281. package/dist/mcp/tools/list-specs.js.map +1 -0
  282. package/dist/mcp/tools/plan.d.ts.map +1 -1
  283. package/dist/mcp/tools/plan.js +40 -14
  284. package/dist/mcp/tools/plan.js.map +1 -1
  285. package/dist/mcp/tools/playbook.d.ts +2 -0
  286. package/dist/mcp/tools/playbook.d.ts.map +1 -0
  287. package/dist/mcp/tools/playbook.js +104 -0
  288. package/dist/mcp/tools/playbook.js.map +1 -0
  289. package/dist/mcp/tools/postmortem.d.ts +2 -0
  290. package/dist/mcp/tools/postmortem.d.ts.map +1 -0
  291. package/dist/mcp/tools/postmortem.js +75 -0
  292. package/dist/mcp/tools/postmortem.js.map +1 -0
  293. package/dist/mcp/tools/react.js +1 -1
  294. package/dist/mcp/tools/react.js.map +1 -1
  295. package/dist/mcp/tools/reject-checkpoint.d.ts +2 -0
  296. package/dist/mcp/tools/reject-checkpoint.d.ts.map +1 -0
  297. package/dist/mcp/tools/reject-checkpoint.js +79 -0
  298. package/dist/mcp/tools/reject-checkpoint.js.map +1 -0
  299. package/dist/mcp/tools/rollback.d.ts +2 -0
  300. package/dist/mcp/tools/rollback.d.ts.map +1 -0
  301. package/dist/mcp/tools/rollback.js +78 -0
  302. package/dist/mcp/tools/rollback.js.map +1 -0
  303. package/dist/mcp/tools/run-in-worktree.d.ts +2 -0
  304. package/dist/mcp/tools/run-in-worktree.d.ts.map +1 -0
  305. package/dist/mcp/tools/run-in-worktree.js +90 -0
  306. package/dist/mcp/tools/run-in-worktree.js.map +1 -0
  307. package/dist/mcp/tools/run.js +1 -1
  308. package/dist/mcp/tools/run.js.map +1 -1
  309. package/dist/mcp/tools/solidity.js +1 -1
  310. package/dist/mcp/tools/solidity.js.map +1 -1
  311. package/dist/mcp/tools/sprint.d.ts.map +1 -1
  312. package/dist/mcp/tools/sprint.js +11 -11
  313. package/dist/mcp/tools/sprint.js.map +1 -1
  314. package/dist/mcp/tools/status.d.ts.map +1 -1
  315. package/dist/mcp/tools/status.js +11 -0
  316. package/dist/mcp/tools/status.js.map +1 -1
  317. package/dist/mcp/tools/subscribe-events.d.ts +2 -0
  318. package/dist/mcp/tools/subscribe-events.d.ts.map +1 -0
  319. package/dist/mcp/tools/subscribe-events.js +48 -0
  320. package/dist/mcp/tools/subscribe-events.js.map +1 -0
  321. package/dist/mcp/tools/unsubscribe-events.d.ts +2 -0
  322. package/dist/mcp/tools/unsubscribe-events.d.ts.map +1 -0
  323. package/dist/mcp/tools/unsubscribe-events.js +45 -0
  324. package/dist/mcp/tools/unsubscribe-events.js.map +1 -0
  325. package/dist/orchestrator/agent-loader.d.ts +16 -0
  326. package/dist/orchestrator/agent-loader.d.ts.map +1 -1
  327. package/dist/orchestrator/agent-loader.js +16 -0
  328. package/dist/orchestrator/agent-loader.js.map +1 -1
  329. package/dist/orchestrator/architect-agent.d.ts.map +1 -1
  330. package/dist/orchestrator/architect-agent.js +37 -8
  331. package/dist/orchestrator/architect-agent.js.map +1 -1
  332. package/dist/orchestrator/checkpoints/audit.d.ts +128 -0
  333. package/dist/orchestrator/checkpoints/audit.d.ts.map +1 -0
  334. package/dist/orchestrator/checkpoints/audit.js +272 -0
  335. package/dist/orchestrator/checkpoints/audit.js.map +1 -0
  336. package/dist/orchestrator/checkpoints/feedback-router.d.ts +213 -0
  337. package/dist/orchestrator/checkpoints/feedback-router.d.ts.map +1 -0
  338. package/dist/orchestrator/checkpoints/feedback-router.js +438 -0
  339. package/dist/orchestrator/checkpoints/feedback-router.js.map +1 -0
  340. package/dist/orchestrator/checkpoints/index.d.ts +11 -0
  341. package/dist/orchestrator/checkpoints/index.d.ts.map +1 -0
  342. package/dist/orchestrator/checkpoints/index.js +12 -0
  343. package/dist/orchestrator/checkpoints/index.js.map +1 -0
  344. package/dist/orchestrator/checkpoints/mechanisms/cli.d.ts +35 -0
  345. package/dist/orchestrator/checkpoints/mechanisms/cli.d.ts.map +1 -0
  346. package/dist/orchestrator/checkpoints/mechanisms/cli.js +153 -0
  347. package/dist/orchestrator/checkpoints/mechanisms/cli.js.map +1 -0
  348. package/dist/orchestrator/checkpoints/mechanisms/disk.d.ts +34 -0
  349. package/dist/orchestrator/checkpoints/mechanisms/disk.d.ts.map +1 -0
  350. package/dist/orchestrator/checkpoints/mechanisms/disk.js +139 -0
  351. package/dist/orchestrator/checkpoints/mechanisms/disk.js.map +1 -0
  352. package/dist/orchestrator/checkpoints/mechanisms/pr.d.ts +141 -0
  353. package/dist/orchestrator/checkpoints/mechanisms/pr.d.ts.map +1 -0
  354. package/dist/orchestrator/checkpoints/mechanisms/pr.js +445 -0
  355. package/dist/orchestrator/checkpoints/mechanisms/pr.js.map +1 -0
  356. package/dist/orchestrator/checkpoints/noop.d.ts +12 -0
  357. package/dist/orchestrator/checkpoints/noop.d.ts.map +1 -0
  358. package/dist/orchestrator/checkpoints/noop.js +13 -0
  359. package/dist/orchestrator/checkpoints/noop.js.map +1 -0
  360. package/dist/orchestrator/checkpoints/registry.d.ts +48 -0
  361. package/dist/orchestrator/checkpoints/registry.d.ts.map +1 -0
  362. package/dist/orchestrator/checkpoints/registry.js +89 -0
  363. package/dist/orchestrator/checkpoints/registry.js.map +1 -0
  364. package/dist/orchestrator/checkpoints/renderers/_util.d.ts +50 -0
  365. package/dist/orchestrator/checkpoints/renderers/_util.d.ts.map +1 -0
  366. package/dist/orchestrator/checkpoints/renderers/_util.js +137 -0
  367. package/dist/orchestrator/checkpoints/renderers/_util.js.map +1 -0
  368. package/dist/orchestrator/checkpoints/renderers/code-review.d.ts +15 -0
  369. package/dist/orchestrator/checkpoints/renderers/code-review.d.ts.map +1 -0
  370. package/dist/orchestrator/checkpoints/renderers/code-review.js +66 -0
  371. package/dist/orchestrator/checkpoints/renderers/code-review.js.map +1 -0
  372. package/dist/orchestrator/checkpoints/renderers/curator-briefing.d.ts +15 -0
  373. package/dist/orchestrator/checkpoints/renderers/curator-briefing.d.ts.map +1 -0
  374. package/dist/orchestrator/checkpoints/renderers/curator-briefing.js +40 -0
  375. package/dist/orchestrator/checkpoints/renderers/curator-briefing.js.map +1 -0
  376. package/dist/orchestrator/checkpoints/renderers/eval-result.d.ts +15 -0
  377. package/dist/orchestrator/checkpoints/renderers/eval-result.d.ts.map +1 -0
  378. package/dist/orchestrator/checkpoints/renderers/eval-result.js +54 -0
  379. package/dist/orchestrator/checkpoints/renderers/eval-result.js.map +1 -0
  380. package/dist/orchestrator/checkpoints/renderers/generator-diff.d.ts +49 -0
  381. package/dist/orchestrator/checkpoints/renderers/generator-diff.d.ts.map +1 -0
  382. package/dist/orchestrator/checkpoints/renderers/generator-diff.js +154 -0
  383. package/dist/orchestrator/checkpoints/renderers/generator-diff.js.map +1 -0
  384. package/dist/orchestrator/checkpoints/renderers/pipeline-summary.d.ts +15 -0
  385. package/dist/orchestrator/checkpoints/renderers/pipeline-summary.d.ts.map +1 -0
  386. package/dist/orchestrator/checkpoints/renderers/pipeline-summary.js +59 -0
  387. package/dist/orchestrator/checkpoints/renderers/pipeline-summary.js.map +1 -0
  388. package/dist/orchestrator/checkpoints/renderers/plan.d.ts +15 -0
  389. package/dist/orchestrator/checkpoints/renderers/plan.d.ts.map +1 -0
  390. package/dist/orchestrator/checkpoints/renderers/plan.js +34 -0
  391. package/dist/orchestrator/checkpoints/renderers/plan.js.map +1 -0
  392. package/dist/orchestrator/checkpoints/renderers/registry.d.ts +43 -0
  393. package/dist/orchestrator/checkpoints/renderers/registry.d.ts.map +1 -0
  394. package/dist/orchestrator/checkpoints/renderers/registry.js +83 -0
  395. package/dist/orchestrator/checkpoints/renderers/registry.js.map +1 -0
  396. package/dist/orchestrator/checkpoints/renderers/research.d.ts +15 -0
  397. package/dist/orchestrator/checkpoints/renderers/research.d.ts.map +1 -0
  398. package/dist/orchestrator/checkpoints/renderers/research.js +39 -0
  399. package/dist/orchestrator/checkpoints/renderers/research.js.map +1 -0
  400. package/dist/orchestrator/checkpoints/renderers/sprint-contract.d.ts +20 -0
  401. package/dist/orchestrator/checkpoints/renderers/sprint-contract.d.ts.map +1 -0
  402. package/dist/orchestrator/checkpoints/renderers/sprint-contract.js +57 -0
  403. package/dist/orchestrator/checkpoints/renderers/sprint-contract.js.map +1 -0
  404. package/dist/orchestrator/checkpoints/renderers/sprint-summary.d.ts +15 -0
  405. package/dist/orchestrator/checkpoints/renderers/sprint-summary.d.ts.map +1 -0
  406. package/dist/orchestrator/checkpoints/renderers/sprint-summary.js +38 -0
  407. package/dist/orchestrator/checkpoints/renderers/sprint-summary.js.map +1 -0
  408. package/dist/orchestrator/checkpoints/sites.d.ts +22 -0
  409. package/dist/orchestrator/checkpoints/sites.d.ts.map +1 -0
  410. package/dist/orchestrator/checkpoints/sites.js +57 -0
  411. package/dist/orchestrator/checkpoints/sites.js.map +1 -0
  412. package/dist/orchestrator/checkpoints/types.d.ts +51 -0
  413. package/dist/orchestrator/checkpoints/types.d.ts.map +1 -0
  414. package/dist/orchestrator/checkpoints/types.js +9 -0
  415. package/dist/orchestrator/checkpoints/types.js.map +1 -0
  416. package/dist/orchestrator/code-reviewer-agent.d.ts +50 -0
  417. package/dist/orchestrator/code-reviewer-agent.d.ts.map +1 -0
  418. package/dist/orchestrator/code-reviewer-agent.js +283 -0
  419. package/dist/orchestrator/code-reviewer-agent.js.map +1 -0
  420. package/dist/orchestrator/context-handoff.d.ts +484 -224
  421. package/dist/orchestrator/context-handoff.d.ts.map +1 -1
  422. package/dist/orchestrator/context-handoff.js +32 -12
  423. package/dist/orchestrator/context-handoff.js.map +1 -1
  424. package/dist/orchestrator/curator-agent.d.ts.map +1 -1
  425. package/dist/orchestrator/curator-agent.js +63 -12
  426. package/dist/orchestrator/curator-agent.js.map +1 -1
  427. package/dist/orchestrator/deploy/classify.d.ts +31 -0
  428. package/dist/orchestrator/deploy/classify.d.ts.map +1 -0
  429. package/dist/orchestrator/deploy/classify.js +109 -0
  430. package/dist/orchestrator/deploy/classify.js.map +1 -0
  431. package/dist/orchestrator/deploy/execute.d.ts +45 -0
  432. package/dist/orchestrator/deploy/execute.d.ts.map +1 -0
  433. package/dist/orchestrator/deploy/execute.js +146 -0
  434. package/dist/orchestrator/deploy/execute.js.map +1 -0
  435. package/dist/orchestrator/deploy/executor.d.ts +22 -0
  436. package/dist/orchestrator/deploy/executor.d.ts.map +1 -0
  437. package/dist/orchestrator/deploy/executor.js +31 -0
  438. package/dist/orchestrator/deploy/executor.js.map +1 -0
  439. package/dist/orchestrator/deploy/index.d.ts +21 -0
  440. package/dist/orchestrator/deploy/index.d.ts.map +1 -0
  441. package/dist/orchestrator/deploy/index.js +21 -0
  442. package/dist/orchestrator/deploy/index.js.map +1 -0
  443. package/dist/orchestrator/deploy/resolve.d.ts +51 -0
  444. package/dist/orchestrator/deploy/resolve.d.ts.map +1 -0
  445. package/dist/orchestrator/deploy/resolve.js +53 -0
  446. package/dist/orchestrator/deploy/resolve.js.map +1 -0
  447. package/dist/orchestrator/deploy/spawn.d.ts +60 -0
  448. package/dist/orchestrator/deploy/spawn.d.ts.map +1 -0
  449. package/dist/orchestrator/deploy/spawn.js +62 -0
  450. package/dist/orchestrator/deploy/spawn.js.map +1 -0
  451. package/dist/orchestrator/deploy/types.d.ts +98 -0
  452. package/dist/orchestrator/deploy/types.d.ts.map +1 -0
  453. package/dist/orchestrator/deploy/types.js +39 -0
  454. package/dist/orchestrator/deploy/types.js.map +1 -0
  455. package/dist/orchestrator/evaluator-agent.d.ts.map +1 -1
  456. package/dist/orchestrator/evaluator-agent.js +23 -10
  457. package/dist/orchestrator/evaluator-agent.js.map +1 -1
  458. package/dist/orchestrator/generator-agent.d.ts.map +1 -1
  459. package/dist/orchestrator/generator-agent.js +24 -11
  460. package/dist/orchestrator/generator-agent.js.map +1 -1
  461. package/dist/orchestrator/model-resolver.d.ts.map +1 -1
  462. package/dist/orchestrator/model-resolver.js +4 -2
  463. package/dist/orchestrator/model-resolver.js.map +1 -1
  464. package/dist/orchestrator/observability/index.d.ts +12 -0
  465. package/dist/orchestrator/observability/index.d.ts.map +1 -0
  466. package/dist/orchestrator/observability/index.js +12 -0
  467. package/dist/orchestrator/observability/index.js.map +1 -0
  468. package/dist/orchestrator/observability/merge.d.ts +73 -0
  469. package/dist/orchestrator/observability/merge.d.ts.map +1 -0
  470. package/dist/orchestrator/observability/merge.js +110 -0
  471. package/dist/orchestrator/observability/merge.js.map +1 -0
  472. package/dist/orchestrator/pipeline.d.ts +28 -0
  473. package/dist/orchestrator/pipeline.d.ts.map +1 -1
  474. package/dist/orchestrator/pipeline.js +223 -30
  475. package/dist/orchestrator/pipeline.js.map +1 -1
  476. package/dist/orchestrator/planner-agent.d.ts +21 -1
  477. package/dist/orchestrator/planner-agent.d.ts.map +1 -1
  478. package/dist/orchestrator/planner-agent.js +16 -6
  479. package/dist/orchestrator/planner-agent.js.map +1 -1
  480. package/dist/orchestrator/research-agent.d.ts.map +1 -1
  481. package/dist/orchestrator/research-agent.js +46 -9
  482. package/dist/orchestrator/research-agent.js.map +1 -1
  483. package/dist/orchestrator/tools/handlers.d.ts +2 -0
  484. package/dist/orchestrator/tools/handlers.d.ts.map +1 -1
  485. package/dist/orchestrator/tools/handlers.js +1 -1
  486. package/dist/orchestrator/tools/handlers.js.map +1 -1
  487. package/dist/orchestrator/tools/index.d.ts +84 -1
  488. package/dist/orchestrator/tools/index.d.ts.map +1 -1
  489. package/dist/orchestrator/tools/index.js +164 -1
  490. package/dist/orchestrator/tools/index.js.map +1 -1
  491. package/dist/orchestrator/worktree.d.ts +18 -0
  492. package/dist/orchestrator/worktree.d.ts.map +1 -0
  493. package/dist/orchestrator/worktree.js +129 -0
  494. package/dist/orchestrator/worktree.js.map +1 -0
  495. package/dist/providers/anthropic.d.ts +8 -1
  496. package/dist/providers/anthropic.d.ts.map +1 -1
  497. package/dist/providers/anthropic.js +86 -5
  498. package/dist/providers/anthropic.js.map +1 -1
  499. package/dist/providers/factory.d.ts.map +1 -1
  500. package/dist/providers/factory.js +35 -2
  501. package/dist/providers/factory.js.map +1 -1
  502. package/dist/providers/google.d.ts.map +1 -1
  503. package/dist/providers/google.js +5 -0
  504. package/dist/providers/google.js.map +1 -1
  505. package/dist/providers/index.d.ts +1 -1
  506. package/dist/providers/index.d.ts.map +1 -1
  507. package/dist/providers/index.js.map +1 -1
  508. package/dist/providers/openai.d.ts.map +1 -1
  509. package/dist/providers/openai.js +4 -0
  510. package/dist/providers/openai.js.map +1 -1
  511. package/dist/providers/types.d.ts +25 -2
  512. package/dist/providers/types.d.ts.map +1 -1
  513. package/dist/state/approval-state.d.ts +74 -0
  514. package/dist/state/approval-state.d.ts.map +1 -0
  515. package/dist/state/approval-state.js +127 -0
  516. package/dist/state/approval-state.js.map +1 -0
  517. package/dist/state/history.d.ts.map +1 -1
  518. package/dist/state/history.js +3 -3
  519. package/dist/state/history.js.map +1 -1
  520. package/dist/state/index.d.ts +3 -0
  521. package/dist/state/index.d.ts.map +1 -1
  522. package/dist/state/index.js +4 -1
  523. package/dist/state/index.js.map +1 -1
  524. package/dist/state/plan-state.js +1 -1
  525. package/dist/state/plan-state.js.map +1 -1
  526. package/dist/state/review-state.d.ts +15 -0
  527. package/dist/state/review-state.d.ts.map +1 -0
  528. package/dist/state/review-state.js +51 -0
  529. package/dist/state/review-state.js.map +1 -0
  530. package/dist/state/run-state.d.ts +39 -0
  531. package/dist/state/run-state.d.ts.map +1 -0
  532. package/dist/state/run-state.js +101 -0
  533. package/dist/state/run-state.js.map +1 -0
  534. package/dist/state/sprint-state.d.ts +9 -2
  535. package/dist/state/sprint-state.d.ts.map +1 -1
  536. package/dist/state/sprint-state.js +25 -11
  537. package/dist/state/sprint-state.js.map +1 -1
  538. package/dist/telemetry/emit.d.ts +41 -0
  539. package/dist/telemetry/emit.d.ts.map +1 -0
  540. package/dist/telemetry/emit.js +65 -0
  541. package/dist/telemetry/emit.js.map +1 -0
  542. package/dist/utils/git.d.ts +27 -0
  543. package/dist/utils/git.d.ts.map +1 -1
  544. package/dist/utils/git.js +50 -0
  545. package/dist/utils/git.js.map +1 -1
  546. package/hooks/hooks.json +17 -1
  547. package/hooks/session-start +42 -0
  548. package/package.json +6 -2
  549. package/scripts/check-prereqs.sh +12 -0
  550. package/scripts/e2e-graph-smoke.sh +167 -0
  551. package/scripts/graph-hook.mjs +151 -0
  552. package/scripts/migrate-specs.mjs +127 -0
  553. package/scripts/run-kpi-gate.mjs +245 -0
  554. package/scripts/sync-skills.mjs +99 -0
  555. package/skills/bober.code-review/SKILL.md +186 -0
  556. package/skills/bober.debug/SKILL.md +300 -0
  557. package/skills/bober.deploy/SKILL.md +262 -0
  558. package/skills/bober.diagnose/SKILL.md +254 -0
  559. package/skills/bober.graph/SKILL.md +85 -0
  560. package/skills/bober.impact/SKILL.md +101 -0
  561. package/skills/bober.incident/SKILL.md +245 -0
  562. package/skills/bober.onboard/SKILL.md +84 -0
  563. package/skills/bober.plan/SKILL.md +51 -0
  564. package/skills/bober.plan/references/spec-schema.md +31 -4
  565. package/skills/bober.postmortem/SKILL.md +231 -0
  566. package/skills/bober.run/SKILL.md +41 -7
  567. package/skills/bober.runbook/SKILL.md +335 -0
  568. package/skills/bober.sprint/SKILL.md +6 -259
  569. package/skills/bober.using-bober/SKILL.md +133 -0
  570. package/skills/bober.verify/SKILL.md +143 -0
@@ -1,101 +1,396 @@
1
1
  import { z } from "zod";
2
- export declare const PrioritySchema: z.ZodEnum<["must", "should", "could"]>;
2
+ /**
3
+ * Threshold at which a spec must be marked needs-clarification rather than
4
+ * proceeding to sprint decomposition. Mirrors the planner agent's autonomous
5
+ * mode rule. Scores are 0..10 inclusive.
6
+ */
7
+ export declare const AMBIGUITY_BLOCK_THRESHOLD = 7;
8
+ export declare const PrioritySchema: z.ZodEnum<["must-have", "should-have", "nice-to-have"]>;
3
9
  export type Priority = z.infer<typeof PrioritySchema>;
10
+ export declare const EstimatedComplexitySchema: z.ZodEnum<["low", "medium", "high"]>;
11
+ export type EstimatedComplexity = z.infer<typeof EstimatedComplexitySchema>;
12
+ /**
13
+ * Lifecycle of a plan spec.
14
+ *
15
+ * - `draft` — planner just emitted, no sprints run yet
16
+ * - `needs-clarification` — planner refused to fully decompose: ambiguityScore
17
+ * >= 7 OR open questions remain. The pipeline will not run sprints from
18
+ * this spec until status flips to `ready`.
19
+ * - `ready` — clarifications resolved (or never needed), pipeline may proceed
20
+ * - `in-progress` — at least one sprint has started
21
+ * - `completed` — all sprints finished
22
+ * - `abandoned` — planner or user explicitly dropped this spec
23
+ */
24
+ export declare const PlanSpecStatusSchema: z.ZodEnum<["draft", "needs-clarification", "ready", "in-progress", "completed", "abandoned"]>;
25
+ export type PlanSpecStatus = z.infer<typeof PlanSpecStatusSchema>;
26
+ export declare const PlanSpecModeSchema: z.ZodEnum<["greenfield", "brownfield"]>;
27
+ export type PlanSpecMode = z.infer<typeof PlanSpecModeSchema>;
28
+ /**
29
+ * Categories the planner uses to group clarifying questions. Matches the
30
+ * categories listed in `.claude/agents/bober-planner.md` Phase 2.
31
+ */
32
+ export declare const ClarificationCategorySchema: z.ZodEnum<["scope", "user-personas", "data-model", "tech-constraints", "design-ux", "integrations", "non-functional", "error-handling", "integration-risk", "pattern-conflict", "regression-risk", "other"]>;
33
+ export type ClarificationCategory = z.infer<typeof ClarificationCategorySchema>;
34
+ export declare const ClarificationOptionSchema: z.ZodObject<{
35
+ /** Short label shown to the user (e.g. "A", "B", "Custom") */
36
+ label: z.ZodString;
37
+ /** What this option means in plain English */
38
+ description: z.ZodString;
39
+ }, "strip", z.ZodTypeAny, {
40
+ description: string;
41
+ label: string;
42
+ }, {
43
+ description: string;
44
+ label: string;
45
+ }>;
46
+ export type ClarificationOption = z.infer<typeof ClarificationOptionSchema>;
47
+ export declare const ClarificationQuestionSchema: z.ZodObject<{
48
+ questionId: z.ZodString;
49
+ category: z.ZodEnum<["scope", "user-personas", "data-model", "tech-constraints", "design-ux", "integrations", "non-functional", "error-handling", "integration-risk", "pattern-conflict", "regression-risk", "other"]>;
50
+ /** The question itself — should end with a "?" */
51
+ question: z.ZodString;
52
+ /** Optional multiple-choice options, including an "Other" escape hatch */
53
+ options: z.ZodOptional<z.ZodArray<z.ZodObject<{
54
+ /** Short label shown to the user (e.g. "A", "B", "Custom") */
55
+ label: z.ZodString;
56
+ /** What this option means in plain English */
57
+ description: z.ZodString;
58
+ }, "strip", z.ZodTypeAny, {
59
+ description: string;
60
+ label: string;
61
+ }, {
62
+ description: string;
63
+ label: string;
64
+ }>, "many">>;
65
+ /** Planner's recommended answer based on codebase evidence */
66
+ recommendation: z.ZodOptional<z.ZodString>;
67
+ /**
68
+ * How much this question contributes to the overall ambiguityScore.
69
+ * Useful for the user to know which questions matter most to resolve.
70
+ */
71
+ ambiguityWeight: z.ZodOptional<z.ZodNumber>;
72
+ }, "strip", z.ZodTypeAny, {
73
+ questionId: string;
74
+ category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
75
+ question: string;
76
+ options?: {
77
+ description: string;
78
+ label: string;
79
+ }[] | undefined;
80
+ recommendation?: string | undefined;
81
+ ambiguityWeight?: number | undefined;
82
+ }, {
83
+ questionId: string;
84
+ category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
85
+ question: string;
86
+ options?: {
87
+ description: string;
88
+ label: string;
89
+ }[] | undefined;
90
+ recommendation?: string | undefined;
91
+ ambiguityWeight?: number | undefined;
92
+ }>;
93
+ export type ClarificationQuestion = z.infer<typeof ClarificationQuestionSchema>;
94
+ export declare const ResolvedClarificationSchema: z.ZodObject<{
95
+ questionId: z.ZodString;
96
+ /** The user-supplied answer (free-form, may reference an option label) */
97
+ answer: z.ZodString;
98
+ /** ISO 8601 timestamp when the answer was recorded */
99
+ resolvedAt: z.ZodString;
100
+ /** Who answered: "user" (interactive) or "planner" (autonomous self-answer) */
101
+ resolvedBy: z.ZodDefault<z.ZodEnum<["user", "planner"]>>;
102
+ }, "strip", z.ZodTypeAny, {
103
+ questionId: string;
104
+ answer: string;
105
+ resolvedAt: string;
106
+ resolvedBy: "planner" | "user";
107
+ }, {
108
+ questionId: string;
109
+ answer: string;
110
+ resolvedAt: string;
111
+ resolvedBy?: "planner" | "user" | undefined;
112
+ }>;
113
+ export type ResolvedClarification = z.infer<typeof ResolvedClarificationSchema>;
4
114
  export declare const FeatureSpecSchema: z.ZodObject<{
5
- id: z.ZodString;
115
+ featureId: z.ZodString;
6
116
  title: z.ZodString;
7
117
  description: z.ZodString;
8
- priority: z.ZodEnum<["must", "should", "could"]>;
9
- estimatedSprints: z.ZodNumber;
118
+ priority: z.ZodEnum<["must-have", "should-have", "nice-to-have"]>;
10
119
  acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
120
+ dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
121
+ estimatedComplexity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
122
+ /** Legacy field kept for backward compat — prefer estimatedComplexity */
123
+ estimatedSprints: z.ZodOptional<z.ZodNumber>;
11
124
  }, "strip", z.ZodTypeAny, {
12
125
  description: string;
13
- id: string;
14
126
  title: string;
15
- priority: "must" | "should" | "could";
16
- estimatedSprints: number;
127
+ featureId: string;
128
+ priority: "must-have" | "should-have" | "nice-to-have";
17
129
  acceptanceCriteria: string[];
130
+ dependencies: string[];
131
+ estimatedComplexity?: "medium" | "low" | "high" | undefined;
132
+ estimatedSprints?: number | undefined;
18
133
  }, {
19
134
  description: string;
20
- id: string;
21
135
  title: string;
22
- priority: "must" | "should" | "could";
23
- estimatedSprints: number;
136
+ featureId: string;
137
+ priority: "must-have" | "should-have" | "nice-to-have";
24
138
  acceptanceCriteria: string[];
139
+ dependencies?: string[] | undefined;
140
+ estimatedComplexity?: "medium" | "low" | "high" | undefined;
141
+ estimatedSprints?: number | undefined;
25
142
  }>;
26
143
  export type FeatureSpec = z.infer<typeof FeatureSpecSchema>;
27
144
  export declare const PlanSpecSchema: z.ZodObject<{
28
- id: z.ZodString;
145
+ specId: z.ZodString;
146
+ version: z.ZodDefault<z.ZodNumber>;
29
147
  title: z.ZodString;
30
148
  description: z.ZodString;
31
- projectType: z.ZodString;
32
- techStack: z.ZodArray<z.ZodString, "many">;
149
+ status: z.ZodEnum<["draft", "needs-clarification", "ready", "in-progress", "completed", "abandoned"]>;
150
+ mode: z.ZodEnum<["greenfield", "brownfield"]>;
33
151
  features: z.ZodArray<z.ZodObject<{
34
- id: z.ZodString;
152
+ featureId: z.ZodString;
35
153
  title: z.ZodString;
36
154
  description: z.ZodString;
37
- priority: z.ZodEnum<["must", "should", "could"]>;
38
- estimatedSprints: z.ZodNumber;
155
+ priority: z.ZodEnum<["must-have", "should-have", "nice-to-have"]>;
39
156
  acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
157
+ dependencies: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
158
+ estimatedComplexity: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
159
+ /** Legacy field kept for backward compat — prefer estimatedComplexity */
160
+ estimatedSprints: z.ZodOptional<z.ZodNumber>;
40
161
  }, "strip", z.ZodTypeAny, {
41
162
  description: string;
42
- id: string;
43
163
  title: string;
44
- priority: "must" | "should" | "could";
45
- estimatedSprints: number;
164
+ featureId: string;
165
+ priority: "must-have" | "should-have" | "nice-to-have";
46
166
  acceptanceCriteria: string[];
167
+ dependencies: string[];
168
+ estimatedComplexity?: "medium" | "low" | "high" | undefined;
169
+ estimatedSprints?: number | undefined;
47
170
  }, {
48
171
  description: string;
49
- id: string;
50
172
  title: string;
51
- priority: "must" | "should" | "could";
52
- estimatedSprints: number;
173
+ featureId: string;
174
+ priority: "must-have" | "should-have" | "nice-to-have";
53
175
  acceptanceCriteria: string[];
176
+ dependencies?: string[] | undefined;
177
+ estimatedComplexity?: "medium" | "low" | "high" | undefined;
178
+ estimatedSprints?: number | undefined;
54
179
  }>, "many">;
55
- nonFunctional: z.ZodArray<z.ZodString, "many">;
56
- constraints: z.ZodArray<z.ZodString, "many">;
180
+ assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
181
+ outOfScope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
182
+ /**
183
+ * Self-rated ambiguity 0..10. >= AMBIGUITY_BLOCK_THRESHOLD must result in
184
+ * status === "needs-clarification" with at least one open question.
185
+ */
186
+ ambiguityScore: z.ZodOptional<z.ZodNumber>;
187
+ /** Open questions awaiting user answer. Empty when status is ready/completed. */
188
+ clarificationQuestions: z.ZodDefault<z.ZodArray<z.ZodObject<{
189
+ questionId: z.ZodString;
190
+ category: z.ZodEnum<["scope", "user-personas", "data-model", "tech-constraints", "design-ux", "integrations", "non-functional", "error-handling", "integration-risk", "pattern-conflict", "regression-risk", "other"]>;
191
+ /** The question itself — should end with a "?" */
192
+ question: z.ZodString;
193
+ /** Optional multiple-choice options, including an "Other" escape hatch */
194
+ options: z.ZodOptional<z.ZodArray<z.ZodObject<{
195
+ /** Short label shown to the user (e.g. "A", "B", "Custom") */
196
+ label: z.ZodString;
197
+ /** What this option means in plain English */
198
+ description: z.ZodString;
199
+ }, "strip", z.ZodTypeAny, {
200
+ description: string;
201
+ label: string;
202
+ }, {
203
+ description: string;
204
+ label: string;
205
+ }>, "many">>;
206
+ /** Planner's recommended answer based on codebase evidence */
207
+ recommendation: z.ZodOptional<z.ZodString>;
208
+ /**
209
+ * How much this question contributes to the overall ambiguityScore.
210
+ * Useful for the user to know which questions matter most to resolve.
211
+ */
212
+ ambiguityWeight: z.ZodOptional<z.ZodNumber>;
213
+ }, "strip", z.ZodTypeAny, {
214
+ questionId: string;
215
+ category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
216
+ question: string;
217
+ options?: {
218
+ description: string;
219
+ label: string;
220
+ }[] | undefined;
221
+ recommendation?: string | undefined;
222
+ ambiguityWeight?: number | undefined;
223
+ }, {
224
+ questionId: string;
225
+ category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
226
+ question: string;
227
+ options?: {
228
+ description: string;
229
+ label: string;
230
+ }[] | undefined;
231
+ recommendation?: string | undefined;
232
+ ambiguityWeight?: number | undefined;
233
+ }>, "many">>;
234
+ /** Question/answer history, both autonomous self-answers and user inputs */
235
+ resolvedClarifications: z.ZodDefault<z.ZodArray<z.ZodObject<{
236
+ questionId: z.ZodString;
237
+ /** The user-supplied answer (free-form, may reference an option label) */
238
+ answer: z.ZodString;
239
+ /** ISO 8601 timestamp when the answer was recorded */
240
+ resolvedAt: z.ZodString;
241
+ /** Who answered: "user" (interactive) or "planner" (autonomous self-answer) */
242
+ resolvedBy: z.ZodDefault<z.ZodEnum<["user", "planner"]>>;
243
+ }, "strip", z.ZodTypeAny, {
244
+ questionId: string;
245
+ answer: string;
246
+ resolvedAt: string;
247
+ resolvedBy: "planner" | "user";
248
+ }, {
249
+ questionId: string;
250
+ answer: string;
251
+ resolvedAt: string;
252
+ resolvedBy?: "planner" | "user" | undefined;
253
+ }>, "many">>;
254
+ techStack: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
255
+ techNotes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
256
+ nonFunctionalRequirements: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
257
+ constraints: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
258
+ sprints: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
259
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
57
260
  createdAt: z.ZodString;
58
261
  updatedAt: z.ZodString;
262
+ completedAt: z.ZodOptional<z.ZodString>;
59
263
  }, "strip", z.ZodTypeAny, {
264
+ mode: "greenfield" | "brownfield";
265
+ status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
60
266
  description: string;
61
- id: string;
267
+ specId: string;
268
+ version: number;
62
269
  title: string;
63
- projectType: string;
64
- techStack: string[];
65
270
  features: {
66
271
  description: string;
67
- id: string;
68
272
  title: string;
69
- priority: "must" | "should" | "could";
70
- estimatedSprints: number;
273
+ featureId: string;
274
+ priority: "must-have" | "should-have" | "nice-to-have";
71
275
  acceptanceCriteria: string[];
276
+ dependencies: string[];
277
+ estimatedComplexity?: "medium" | "low" | "high" | undefined;
278
+ estimatedSprints?: number | undefined;
279
+ }[];
280
+ assumptions: string[];
281
+ outOfScope: string[];
282
+ clarificationQuestions: {
283
+ questionId: string;
284
+ category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
285
+ question: string;
286
+ options?: {
287
+ description: string;
288
+ label: string;
289
+ }[] | undefined;
290
+ recommendation?: string | undefined;
291
+ ambiguityWeight?: number | undefined;
72
292
  }[];
73
- nonFunctional: string[];
293
+ resolvedClarifications: {
294
+ questionId: string;
295
+ answer: string;
296
+ resolvedAt: string;
297
+ resolvedBy: "planner" | "user";
298
+ }[];
299
+ techStack: string[];
300
+ nonFunctionalRequirements: unknown[];
74
301
  constraints: string[];
75
302
  createdAt: string;
76
303
  updatedAt: string;
304
+ ambiguityScore?: number | undefined;
305
+ techNotes?: Record<string, unknown> | undefined;
306
+ sprints?: unknown[] | undefined;
307
+ metadata?: Record<string, unknown> | undefined;
308
+ completedAt?: string | undefined;
77
309
  }, {
310
+ mode: "greenfield" | "brownfield";
311
+ status: "draft" | "needs-clarification" | "ready" | "in-progress" | "completed" | "abandoned";
78
312
  description: string;
79
- id: string;
313
+ specId: string;
80
314
  title: string;
81
- projectType: string;
82
- techStack: string[];
83
315
  features: {
84
316
  description: string;
85
- id: string;
86
317
  title: string;
87
- priority: "must" | "should" | "could";
88
- estimatedSprints: number;
318
+ featureId: string;
319
+ priority: "must-have" | "should-have" | "nice-to-have";
89
320
  acceptanceCriteria: string[];
321
+ dependencies?: string[] | undefined;
322
+ estimatedComplexity?: "medium" | "low" | "high" | undefined;
323
+ estimatedSprints?: number | undefined;
90
324
  }[];
91
- nonFunctional: string[];
92
- constraints: string[];
93
325
  createdAt: string;
94
326
  updatedAt: string;
327
+ version?: number | undefined;
328
+ assumptions?: string[] | undefined;
329
+ outOfScope?: string[] | undefined;
330
+ ambiguityScore?: number | undefined;
331
+ clarificationQuestions?: {
332
+ questionId: string;
333
+ category: "other" | "scope" | "user-personas" | "data-model" | "tech-constraints" | "design-ux" | "integrations" | "non-functional" | "error-handling" | "integration-risk" | "pattern-conflict" | "regression-risk";
334
+ question: string;
335
+ options?: {
336
+ description: string;
337
+ label: string;
338
+ }[] | undefined;
339
+ recommendation?: string | undefined;
340
+ ambiguityWeight?: number | undefined;
341
+ }[] | undefined;
342
+ resolvedClarifications?: {
343
+ questionId: string;
344
+ answer: string;
345
+ resolvedAt: string;
346
+ resolvedBy?: "planner" | "user" | undefined;
347
+ }[] | undefined;
348
+ techStack?: string[] | undefined;
349
+ techNotes?: Record<string, unknown> | undefined;
350
+ nonFunctionalRequirements?: unknown[] | undefined;
351
+ constraints?: string[] | undefined;
352
+ sprints?: unknown[] | undefined;
353
+ metadata?: Record<string, unknown> | undefined;
354
+ completedAt?: string | undefined;
95
355
  }>;
96
356
  export type PlanSpec = z.infer<typeof PlanSpecSchema>;
357
+ export interface CreateSpecOptions {
358
+ mode?: PlanSpecMode;
359
+ status?: PlanSpecStatus;
360
+ ambiguityScore?: number;
361
+ clarificationQuestions?: ClarificationQuestion[];
362
+ assumptions?: string[];
363
+ outOfScope?: string[];
364
+ techStack?: string[];
365
+ }
97
366
  /**
98
367
  * Create a new plan specification with sensible defaults.
99
368
  */
100
- export declare function createSpec(title: string, description: string, features: Omit<FeatureSpec, "id">[]): PlanSpec;
369
+ export declare function createSpec(title: string, description: string, features: Omit<FeatureSpec, "featureId">[], options?: CreateSpecOptions): PlanSpec;
370
+ /**
371
+ * Return true when the spec has unresolved clarification questions.
372
+ *
373
+ * NOTE: This checks question state only, NOT spec.status — `status` is
374
+ * downstream of this. If you want "is the pipeline blocked?", check
375
+ * `spec.status === "needs-clarification" || hasOpenClarifications(spec)`
376
+ * instead, or use `isPipelineReady(spec)`.
377
+ */
378
+ export declare function hasOpenClarifications(spec: PlanSpec): boolean;
379
+ /**
380
+ * Return true when the pipeline is allowed to run sprints from this spec.
381
+ * Combines the explicit status check with the question-resolution check.
382
+ */
383
+ export declare function isPipelineReady(spec: PlanSpec): boolean;
384
+ /**
385
+ * Return the questions that haven't been answered yet.
386
+ */
387
+ export declare function getOpenClarifications(spec: PlanSpec): ClarificationQuestion[];
388
+ /**
389
+ * Record an answer to a clarification question. Returns a new spec — does
390
+ * not mutate. If this answer was the last open question, the spec status
391
+ * flips from `needs-clarification` to `ready`.
392
+ *
393
+ * Throws if the questionId doesn't exist on the spec.
394
+ */
395
+ export declare function resolveClarification(spec: PlanSpec, questionId: string, answer: string, resolvedBy?: ResolvedClarification["resolvedBy"]): PlanSpec;
101
396
  //# sourceMappingURL=spec.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/contracts/spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,cAAc,wCAAsC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAItD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,GAClC,QAAQ,CAoBV"}
1
+ {"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/contracts/spec.ts"],"names":[],"mappings":"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"}