agentplane 0.3.7 → 0.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (625) hide show
  1. package/assets/AGENTS.md +11 -1
  2. package/assets/RUNNER.md +17 -0
  3. package/bin/agentplane.js +16 -7
  4. package/bin/framework-dev-contract.d.ts +6 -0
  5. package/bin/framework-dev-contract.js +13 -0
  6. package/bin/stale-dist-policy.js +6 -1
  7. package/dist/.build-manifest.json +694 -339
  8. package/dist/adapters/task-backend/task-backend-adapter.d.ts +3 -1
  9. package/dist/adapters/task-backend/task-backend-adapter.d.ts.map +1 -1
  10. package/dist/adapters/task-backend/task-backend-adapter.js +13 -0
  11. package/dist/backends/task-backend/local-backend-doc.d.ts +5 -0
  12. package/dist/backends/task-backend/local-backend-doc.d.ts.map +1 -0
  13. package/dist/backends/task-backend/local-backend-doc.js +98 -0
  14. package/dist/backends/task-backend/local-backend-read.d.ts +7 -0
  15. package/dist/backends/task-backend/local-backend-read.d.ts.map +1 -0
  16. package/dist/backends/task-backend/local-backend-read.js +186 -0
  17. package/dist/backends/task-backend/local-backend-state.d.ts +17 -0
  18. package/dist/backends/task-backend/local-backend-state.d.ts.map +1 -0
  19. package/dist/backends/task-backend/local-backend-state.js +50 -0
  20. package/dist/backends/task-backend/local-backend-write.d.ts +15 -0
  21. package/dist/backends/task-backend/local-backend-write.d.ts.map +1 -0
  22. package/dist/backends/task-backend/local-backend-write.js +254 -0
  23. package/dist/backends/task-backend/local-backend.d.ts +4 -2
  24. package/dist/backends/task-backend/local-backend.d.ts.map +1 -1
  25. package/dist/backends/task-backend/local-backend.js +26 -403
  26. package/dist/backends/task-backend/redmine/backend-cache-doc.d.ts +40 -0
  27. package/dist/backends/task-backend/redmine/backend-cache-doc.d.ts.map +1 -0
  28. package/dist/backends/task-backend/redmine/backend-cache-doc.js +178 -0
  29. package/dist/backends/task-backend/redmine/backend-report.d.ts +10 -0
  30. package/dist/backends/task-backend/redmine/backend-report.d.ts.map +1 -0
  31. package/dist/backends/task-backend/redmine/backend-report.js +43 -0
  32. package/dist/backends/task-backend/redmine/backend-sync.d.ts +67 -0
  33. package/dist/backends/task-backend/redmine/backend-sync.d.ts.map +1 -0
  34. package/dist/backends/task-backend/redmine/backend-sync.js +367 -0
  35. package/dist/backends/task-backend/redmine/mapping.d.ts +2 -1
  36. package/dist/backends/task-backend/redmine/mapping.d.ts.map +1 -1
  37. package/dist/backends/task-backend/redmine/mapping.js +12 -2
  38. package/dist/backends/task-backend/redmine/parse.d.ts +2 -1
  39. package/dist/backends/task-backend/redmine/parse.d.ts.map +1 -1
  40. package/dist/backends/task-backend/redmine/parse.js +5 -3
  41. package/dist/backends/task-backend/redmine/state.d.ts +2 -0
  42. package/dist/backends/task-backend/redmine/state.d.ts.map +1 -1
  43. package/dist/backends/task-backend/redmine/state.js +15 -1
  44. package/dist/backends/task-backend/redmine-backend.d.ts +5 -2
  45. package/dist/backends/task-backend/redmine-backend.d.ts.map +1 -1
  46. package/dist/backends/task-backend/redmine-backend.js +88 -536
  47. package/dist/backends/task-backend/shared/constants.d.ts +2 -1
  48. package/dist/backends/task-backend/shared/constants.d.ts.map +1 -1
  49. package/dist/backends/task-backend/shared/doc.d.ts.map +1 -1
  50. package/dist/backends/task-backend/shared/doc.js +25 -39
  51. package/dist/backends/task-backend/shared/export.d.ts +2 -9
  52. package/dist/backends/task-backend/shared/export.d.ts.map +1 -1
  53. package/dist/backends/task-backend/shared/export.js +73 -8
  54. package/dist/backends/task-backend/shared/normalize.d.ts +5 -1
  55. package/dist/backends/task-backend/shared/normalize.d.ts.map +1 -1
  56. package/dist/backends/task-backend/shared/normalize.js +166 -0
  57. package/dist/backends/task-backend/shared/record.d.ts +1 -1
  58. package/dist/backends/task-backend/shared/record.d.ts.map +1 -1
  59. package/dist/backends/task-backend/shared/record.js +7 -2
  60. package/dist/backends/task-backend/shared/types.d.ts +38 -36
  61. package/dist/backends/task-backend/shared/types.d.ts.map +1 -1
  62. package/dist/backends/task-backend/shared.d.ts +2 -2
  63. package/dist/backends/task-backend/shared.d.ts.map +1 -1
  64. package/dist/backends/task-backend/shared.js +1 -1
  65. package/dist/backends/task-backend.d.ts +1 -1
  66. package/dist/backends/task-backend.d.ts.map +1 -1
  67. package/dist/backends/task-backend.js +1 -1
  68. package/dist/backends/task-index.d.ts +2 -2
  69. package/dist/backends/task-index.d.ts.map +1 -1
  70. package/dist/backends/task-index.js +9 -6
  71. package/dist/cli/bootstrap-guide.d.ts +2 -2
  72. package/dist/cli/bootstrap-guide.d.ts.map +1 -1
  73. package/dist/cli/bootstrap-guide.js +10 -10
  74. package/dist/cli/command-guide.d.ts.map +1 -1
  75. package/dist/cli/command-guide.js +11 -9
  76. package/dist/cli/command-invocations.d.ts +4 -0
  77. package/dist/cli/command-invocations.d.ts.map +1 -0
  78. package/dist/cli/command-invocations.js +35 -0
  79. package/dist/cli/command-snippets.d.ts +12 -8
  80. package/dist/cli/command-snippets.d.ts.map +1 -1
  81. package/dist/cli/command-snippets.js +14 -8
  82. package/dist/cli/exit-codes.d.ts.map +1 -1
  83. package/dist/cli/exit-codes.js +1 -0
  84. package/dist/cli/group-command.d.ts +18 -0
  85. package/dist/cli/group-command.d.ts.map +1 -0
  86. package/dist/cli/group-command.js +45 -0
  87. package/dist/cli/output.d.ts +29 -0
  88. package/dist/cli/output.d.ts.map +1 -1
  89. package/dist/cli/output.js +76 -0
  90. package/dist/cli/prompts.d.ts.map +1 -1
  91. package/dist/cli/prompts.js +5 -1
  92. package/dist/cli/run-cli/command-catalog/core.d.ts.map +1 -1
  93. package/dist/cli/run-cli/command-catalog/core.js +38 -29
  94. package/dist/cli/run-cli/command-catalog/lifecycle.d.ts.map +1 -1
  95. package/dist/cli/run-cli/command-catalog/lifecycle.js +9 -6
  96. package/dist/cli/run-cli/command-catalog/project.d.ts +1 -1
  97. package/dist/cli/run-cli/command-catalog/project.d.ts.map +1 -1
  98. package/dist/cli/run-cli/command-catalog/project.js +8 -6
  99. package/dist/cli/run-cli/command-catalog/shared.d.ts +12 -3
  100. package/dist/cli/run-cli/command-catalog/shared.d.ts.map +1 -1
  101. package/dist/cli/run-cli/command-catalog/shared.js +6 -3
  102. package/dist/cli/run-cli/command-catalog/task.d.ts +1 -1
  103. package/dist/cli/run-cli/command-catalog/task.d.ts.map +1 -1
  104. package/dist/cli/run-cli/command-catalog/task.js +46 -11
  105. package/dist/cli/run-cli/command-catalog.d.ts +11 -1
  106. package/dist/cli/run-cli/command-catalog.d.ts.map +1 -1
  107. package/dist/cli/run-cli/command-catalog.js +29 -0
  108. package/dist/cli/run-cli/commands/config.d.ts.map +1 -1
  109. package/dist/cli/run-cli/commands/config.js +52 -6
  110. package/dist/cli/run-cli/commands/core/agent-profiles.d.ts +34 -0
  111. package/dist/cli/run-cli/commands/core/agent-profiles.d.ts.map +1 -0
  112. package/dist/cli/run-cli/commands/core/agent-profiles.js +97 -0
  113. package/dist/cli/run-cli/commands/core/agents.d.ts +7 -0
  114. package/dist/cli/run-cli/commands/core/agents.d.ts.map +1 -0
  115. package/dist/cli/run-cli/commands/core/agents.js +97 -0
  116. package/dist/cli/run-cli/commands/core/preflight.d.ts +10 -0
  117. package/dist/cli/run-cli/commands/core/preflight.d.ts.map +1 -0
  118. package/dist/cli/run-cli/commands/core/preflight.js +286 -0
  119. package/dist/cli/run-cli/commands/core/quickstart.d.ts +8 -0
  120. package/dist/cli/run-cli/commands/core/quickstart.d.ts.map +1 -0
  121. package/dist/cli/run-cli/commands/core/quickstart.js +43 -0
  122. package/dist/cli/run-cli/commands/core/role.d.ts +9 -0
  123. package/dist/cli/run-cli/commands/core/role.d.ts.map +1 -0
  124. package/dist/cli/run-cli/commands/core/role.js +128 -0
  125. package/dist/cli/run-cli/commands/core.d.ts +4 -24
  126. package/dist/cli/run-cli/commands/core.d.ts.map +1 -1
  127. package/dist/cli/run-cli/commands/core.js +4 -630
  128. package/dist/cli/run-cli/error-guidance.js +10 -0
  129. package/dist/cli/run-cli/globals.d.ts +5 -2
  130. package/dist/cli/run-cli/globals.d.ts.map +1 -1
  131. package/dist/cli/run-cli/globals.js +82 -86
  132. package/dist/cli/run-cli.d.ts.map +1 -1
  133. package/dist/cli/run-cli.js +137 -100
  134. package/dist/cli/run-cli.test-helpers.d.ts +21 -0
  135. package/dist/cli/run-cli.test-helpers.d.ts.map +1 -1
  136. package/dist/cli/run-cli.test-helpers.js +88 -4
  137. package/dist/cli/spec/help.d.ts +10 -2
  138. package/dist/cli/spec/help.d.ts.map +1 -1
  139. package/dist/cli/spec/help.js +7 -5
  140. package/dist/cli/spec/registry.d.ts +27 -1
  141. package/dist/cli/spec/registry.d.ts.map +1 -1
  142. package/dist/cli/spec/registry.js +98 -25
  143. package/dist/commands/backend/sync.command.d.ts +3 -5
  144. package/dist/commands/backend/sync.command.d.ts.map +1 -1
  145. package/dist/commands/backend/sync.command.js +9 -12
  146. package/dist/commands/backend.d.ts.map +1 -1
  147. package/dist/commands/backend.js +8 -7
  148. package/dist/commands/branch/base.command.d.ts +2 -3
  149. package/dist/commands/branch/base.command.d.ts.map +1 -1
  150. package/dist/commands/branch/base.command.js +8 -12
  151. package/dist/commands/branch/base.d.ts.map +1 -1
  152. package/dist/commands/branch/base.js +11 -7
  153. package/dist/commands/branch/cleanup-merged.d.ts.map +1 -1
  154. package/dist/commands/branch/cleanup-merged.js +9 -8
  155. package/dist/commands/branch/remove.d.ts.map +1 -1
  156. package/dist/commands/branch/remove.js +4 -3
  157. package/dist/commands/branch/status.d.ts.map +1 -1
  158. package/dist/commands/branch/status.js +4 -3
  159. package/dist/commands/branch/work-start.d.ts.map +1 -1
  160. package/dist/commands/branch/work-start.js +48 -5
  161. package/dist/commands/cleanup/merged.command.d.ts +2 -3
  162. package/dist/commands/cleanup/merged.command.d.ts.map +1 -1
  163. package/dist/commands/cleanup/merged.command.js +8 -12
  164. package/dist/commands/docs/cli.command.js +2 -2
  165. package/dist/commands/doctor/runtime.js +1 -1
  166. package/dist/commands/doctor/workflow.d.ts.map +1 -1
  167. package/dist/commands/doctor/workflow.js +10 -1
  168. package/dist/commands/finish.spec.d.ts.map +1 -1
  169. package/dist/commands/finish.spec.js +7 -0
  170. package/dist/commands/guard/guard.command.d.ts +3 -3
  171. package/dist/commands/guard/guard.command.d.ts.map +1 -1
  172. package/dist/commands/guard/guard.command.js +9 -14
  173. package/dist/commands/guard/impl/commands.d.ts +2 -0
  174. package/dist/commands/guard/impl/commands.d.ts.map +1 -1
  175. package/dist/commands/guard/impl/commands.js +55 -7
  176. package/dist/commands/guard/impl/policy.d.ts +1 -0
  177. package/dist/commands/guard/impl/policy.d.ts.map +1 -1
  178. package/dist/commands/guard/impl/policy.js +9 -6
  179. package/dist/commands/hooks/hooks.command.d.ts +3 -3
  180. package/dist/commands/hooks/hooks.command.d.ts.map +1 -1
  181. package/dist/commands/hooks/hooks.command.js +9 -11
  182. package/dist/commands/pr/check.d.ts.map +1 -1
  183. package/dist/commands/pr/check.js +90 -18
  184. package/dist/commands/pr/integrate/cmd.d.ts.map +1 -1
  185. package/dist/commands/pr/integrate/cmd.js +31 -3
  186. package/dist/commands/pr/integrate/internal/cleanup.d.ts +12 -0
  187. package/dist/commands/pr/integrate/internal/cleanup.d.ts.map +1 -0
  188. package/dist/commands/pr/integrate/internal/cleanup.js +46 -0
  189. package/dist/commands/pr/integrate/internal/finalize.d.ts +4 -0
  190. package/dist/commands/pr/integrate/internal/finalize.d.ts.map +1 -1
  191. package/dist/commands/pr/integrate/internal/finalize.js +34 -40
  192. package/dist/commands/pr/integrate/internal/merge.d.ts +6 -0
  193. package/dist/commands/pr/integrate/internal/merge.d.ts.map +1 -1
  194. package/dist/commands/pr/integrate/internal/merge.js +92 -0
  195. package/dist/commands/pr/integrate/internal/prepare.d.ts +1 -0
  196. package/dist/commands/pr/integrate/internal/prepare.d.ts.map +1 -1
  197. package/dist/commands/pr/integrate/internal/prepare.js +1 -0
  198. package/dist/commands/pr/integrate/verify.d.ts.map +1 -1
  199. package/dist/commands/pr/integrate/verify.js +4 -3
  200. package/dist/commands/pr/note.d.ts.map +1 -1
  201. package/dist/commands/pr/note.js +3 -2
  202. package/dist/commands/pr/open.d.ts.map +1 -1
  203. package/dist/commands/pr/open.js +9 -12
  204. package/dist/commands/pr/pr.command.d.ts +3 -4
  205. package/dist/commands/pr/pr.command.d.ts.map +1 -1
  206. package/dist/commands/pr/pr.command.js +6 -11
  207. package/dist/commands/pr/update.d.ts.map +1 -1
  208. package/dist/commands/pr/update.js +5 -10
  209. package/dist/commands/recipes/cache.command.d.ts +3 -4
  210. package/dist/commands/recipes/cache.command.d.ts.map +1 -1
  211. package/dist/commands/recipes/cache.command.js +8 -26
  212. package/dist/commands/recipes/impl/apply.d.ts +1 -1
  213. package/dist/commands/recipes/impl/apply.d.ts.map +1 -1
  214. package/dist/commands/recipes/impl/apply.js +1 -1
  215. package/dist/commands/recipes/impl/commands/explain.js +1 -1
  216. package/dist/commands/recipes/impl/commands/install.d.ts.map +1 -1
  217. package/dist/commands/recipes/impl/commands/install.js +1 -2
  218. package/dist/commands/recipes/impl/installed-recipes.d.ts +1 -1
  219. package/dist/commands/recipes/impl/installed-recipes.d.ts.map +1 -1
  220. package/dist/commands/recipes/impl/installed-recipes.js +1 -2
  221. package/dist/commands/recipes/impl/manifest.d.ts.map +1 -1
  222. package/dist/commands/recipes/impl/manifest.js +0 -10
  223. package/dist/commands/recipes/impl/project-installed-recipes.d.ts +1 -1
  224. package/dist/commands/recipes/impl/project-installed-recipes.d.ts.map +1 -1
  225. package/dist/commands/recipes/impl/project-installed-recipes.js +1 -2
  226. package/dist/commands/recipes/impl/resolver.d.ts +1 -1
  227. package/dist/commands/recipes/impl/resolver.d.ts.map +1 -1
  228. package/dist/commands/recipes/impl/resolver.js +26 -16
  229. package/dist/commands/recipes/impl/scenario.d.ts.map +1 -1
  230. package/dist/commands/recipes/impl/scenario.js +80 -0
  231. package/dist/commands/recipes/impl/types.d.ts +27 -13
  232. package/dist/commands/recipes/impl/types.d.ts.map +1 -1
  233. package/dist/commands/recipes/recipes.command.d.ts +3 -4
  234. package/dist/commands/recipes/recipes.command.d.ts.map +1 -1
  235. package/dist/commands/recipes/recipes.command.js +8 -34
  236. package/dist/commands/recipes.d.ts +4 -4
  237. package/dist/commands/recipes.d.ts.map +1 -1
  238. package/dist/commands/recipes.js +3 -3
  239. package/dist/commands/recipes.test-helpers.d.ts +17 -0
  240. package/dist/commands/recipes.test-helpers.d.ts.map +1 -1
  241. package/dist/commands/recipes.test-helpers.js +56 -2
  242. package/dist/commands/release/apply.command.d.ts.map +1 -1
  243. package/dist/commands/release/apply.command.js +77 -56
  244. package/dist/commands/release/plan.command.d.ts.map +1 -1
  245. package/dist/commands/release/plan.command.js +7 -3
  246. package/dist/commands/release/release.command.d.ts +3 -3
  247. package/dist/commands/release/release.command.d.ts.map +1 -1
  248. package/dist/commands/release/release.command.js +9 -11
  249. package/dist/commands/release.test-helpers.d.ts +20 -0
  250. package/dist/commands/release.test-helpers.d.ts.map +1 -0
  251. package/dist/commands/release.test-helpers.js +37 -0
  252. package/dist/commands/runtime.command.d.ts +7 -7
  253. package/dist/commands/runtime.command.d.ts.map +1 -1
  254. package/dist/commands/runtime.command.js +29 -33
  255. package/dist/commands/scenario/execute.command.d.ts +8 -0
  256. package/dist/commands/scenario/execute.command.d.ts.map +1 -0
  257. package/dist/commands/scenario/execute.command.js +117 -0
  258. package/dist/commands/scenario/impl/commands.d.ts.map +1 -1
  259. package/dist/commands/scenario/impl/commands.js +45 -32
  260. package/dist/commands/scenario/run.command.js +2 -2
  261. package/dist/commands/scenario/scenario.command.d.ts +3 -4
  262. package/dist/commands/scenario/scenario.command.d.ts.map +1 -1
  263. package/dist/commands/scenario/scenario.command.js +8 -26
  264. package/dist/commands/shared/git-context.d.ts +1 -0
  265. package/dist/commands/shared/git-context.d.ts.map +1 -1
  266. package/dist/commands/shared/git-context.js +4 -2
  267. package/dist/commands/shared/git-ops.d.ts +1 -0
  268. package/dist/commands/shared/git-ops.d.ts.map +1 -1
  269. package/dist/commands/shared/git-ops.js +13 -0
  270. package/dist/commands/shared/operator-pipeline.d.ts +10 -0
  271. package/dist/commands/shared/operator-pipeline.d.ts.map +1 -0
  272. package/dist/commands/shared/operator-pipeline.js +16 -0
  273. package/dist/commands/shared/pr-meta.d.ts +32 -12
  274. package/dist/commands/shared/pr-meta.d.ts.map +1 -1
  275. package/dist/commands/shared/pr-meta.js +49 -14
  276. package/dist/commands/shared/reconcile-check.d.ts.map +1 -1
  277. package/dist/commands/shared/reconcile-check.js +28 -3
  278. package/dist/commands/shared/task-backend.d.ts +10 -6
  279. package/dist/commands/shared/task-backend.d.ts.map +1 -1
  280. package/dist/commands/shared/task-backend.js +99 -25
  281. package/dist/commands/shared/task-handoff.d.ts +64 -0
  282. package/dist/commands/shared/task-handoff.d.ts.map +1 -0
  283. package/dist/commands/shared/task-handoff.js +151 -0
  284. package/dist/commands/shared/task-mutation.d.ts +36 -0
  285. package/dist/commands/shared/task-mutation.d.ts.map +1 -0
  286. package/dist/commands/shared/task-mutation.js +67 -0
  287. package/dist/commands/shared/task-store.d.ts +5 -1
  288. package/dist/commands/shared/task-store.d.ts.map +1 -1
  289. package/dist/commands/shared/task-store.js +72 -92
  290. package/dist/commands/task/add.d.ts.map +1 -1
  291. package/dist/commands/task/add.js +41 -39
  292. package/dist/commands/task/block.d.ts.map +1 -1
  293. package/dist/commands/task/block.js +31 -110
  294. package/dist/commands/task/close-duplicate.d.ts.map +1 -1
  295. package/dist/commands/task/close-duplicate.js +0 -7
  296. package/dist/commands/task/close-noop.d.ts.map +1 -1
  297. package/dist/commands/task/close-noop.js +0 -21
  298. package/dist/commands/task/close-shared.d.ts +0 -2
  299. package/dist/commands/task/close-shared.d.ts.map +1 -1
  300. package/dist/commands/task/close-shared.js +25 -55
  301. package/dist/commands/task/comment.d.ts.map +1 -1
  302. package/dist/commands/task/comment.js +48 -37
  303. package/dist/commands/task/derive.d.ts.map +1 -1
  304. package/dist/commands/task/derive.js +14 -7
  305. package/dist/commands/task/doc.command.d.ts.map +1 -1
  306. package/dist/commands/task/doc.command.js +7 -6
  307. package/dist/commands/task/doc.d.ts.map +1 -1
  308. package/dist/commands/task/doc.js +58 -62
  309. package/dist/commands/task/finish-shared.d.ts +60 -0
  310. package/dist/commands/task/finish-shared.d.ts.map +1 -0
  311. package/dist/commands/task/finish-shared.js +181 -0
  312. package/dist/commands/task/finish.d.ts +1 -0
  313. package/dist/commands/task/finish.d.ts.map +1 -1
  314. package/dist/commands/task/finish.js +79 -210
  315. package/dist/commands/task/handoff-record.command.d.ts +17 -0
  316. package/dist/commands/task/handoff-record.command.d.ts.map +1 -0
  317. package/dist/commands/task/handoff-record.command.js +140 -0
  318. package/dist/commands/task/handoff-show.command.d.ts +8 -0
  319. package/dist/commands/task/handoff-show.command.d.ts.map +1 -0
  320. package/dist/commands/task/handoff-show.command.js +77 -0
  321. package/dist/commands/task/handoff.command.d.ts +7 -0
  322. package/dist/commands/task/handoff.command.d.ts.map +1 -0
  323. package/dist/commands/task/handoff.command.js +21 -0
  324. package/dist/commands/task/handoff.shared.d.ts +39 -0
  325. package/dist/commands/task/handoff.shared.d.ts.map +1 -0
  326. package/dist/commands/task/handoff.shared.js +134 -0
  327. package/dist/commands/task/hosted-close.command.d.ts +9 -0
  328. package/dist/commands/task/hosted-close.command.d.ts.map +1 -0
  329. package/dist/commands/task/hosted-close.command.js +190 -0
  330. package/dist/commands/task/hosted-merge-sync.d.ts +40 -0
  331. package/dist/commands/task/hosted-merge-sync.d.ts.map +1 -0
  332. package/dist/commands/task/hosted-merge-sync.js +277 -0
  333. package/dist/commands/task/list.d.ts.map +1 -1
  334. package/dist/commands/task/list.js +7 -24
  335. package/dist/commands/task/new.d.ts.map +1 -1
  336. package/dist/commands/task/new.js +26 -6
  337. package/dist/commands/task/next.d.ts.map +1 -1
  338. package/dist/commands/task/next.js +10 -28
  339. package/dist/commands/task/normalize.command.d.ts +1 -0
  340. package/dist/commands/task/normalize.command.d.ts.map +1 -1
  341. package/dist/commands/task/normalize.command.js +12 -0
  342. package/dist/commands/task/normalize.d.ts +1 -0
  343. package/dist/commands/task/normalize.d.ts.map +1 -1
  344. package/dist/commands/task/normalize.js +21 -9
  345. package/dist/commands/task/plan.command.d.ts +3 -4
  346. package/dist/commands/task/plan.command.d.ts.map +1 -1
  347. package/dist/commands/task/plan.command.js +6 -12
  348. package/dist/commands/task/plan.d.ts.map +1 -1
  349. package/dist/commands/task/plan.js +96 -103
  350. package/dist/commands/task/reclaim.command.d.ts +11 -0
  351. package/dist/commands/task/reclaim.command.d.ts.map +1 -0
  352. package/dist/commands/task/reclaim.command.js +102 -0
  353. package/dist/commands/task/resume-context.command.d.ts +9 -0
  354. package/dist/commands/task/resume-context.command.d.ts.map +1 -0
  355. package/dist/commands/task/resume-context.command.js +60 -0
  356. package/dist/commands/task/run-cancel.command.d.ts +6 -0
  357. package/dist/commands/task/run-cancel.command.d.ts.map +1 -0
  358. package/dist/commands/task/run-cancel.command.js +45 -0
  359. package/dist/commands/task/run-cancel.spec.d.ts +7 -0
  360. package/dist/commands/task/run-cancel.spec.d.ts.map +1 -0
  361. package/dist/commands/task/run-cancel.spec.js +20 -0
  362. package/dist/commands/task/run-resume.command.d.ts +6 -0
  363. package/dist/commands/task/run-resume.command.d.ts.map +1 -0
  364. package/dist/commands/task/run-resume.command.js +55 -0
  365. package/dist/commands/task/run-resume.spec.d.ts +7 -0
  366. package/dist/commands/task/run-resume.spec.d.ts.map +1 -0
  367. package/dist/commands/task/run-resume.spec.js +20 -0
  368. package/dist/commands/task/run-retry.command.d.ts +6 -0
  369. package/dist/commands/task/run-retry.command.d.ts.map +1 -0
  370. package/dist/commands/task/run-retry.command.js +56 -0
  371. package/dist/commands/task/run-retry.spec.d.ts +7 -0
  372. package/dist/commands/task/run-retry.spec.d.ts.map +1 -0
  373. package/dist/commands/task/run-retry.spec.js +20 -0
  374. package/dist/commands/task/run-show.command.d.ts +6 -0
  375. package/dist/commands/task/run-show.command.d.ts.map +1 -0
  376. package/dist/commands/task/run-show.command.js +133 -0
  377. package/dist/commands/task/run-show.spec.d.ts +8 -0
  378. package/dist/commands/task/run-show.spec.d.ts.map +1 -0
  379. package/dist/commands/task/run-show.spec.js +44 -0
  380. package/dist/commands/task/run-tail.command.d.ts +6 -0
  381. package/dist/commands/task/run-tail.command.d.ts.map +1 -0
  382. package/dist/commands/task/run-tail.command.js +26 -0
  383. package/dist/commands/task/run-tail.spec.d.ts +8 -0
  384. package/dist/commands/task/run-tail.spec.d.ts.map +1 -0
  385. package/dist/commands/task/run-tail.spec.js +51 -0
  386. package/dist/commands/task/run-trace.command.d.ts +6 -0
  387. package/dist/commands/task/run-trace.command.d.ts.map +1 -0
  388. package/dist/commands/task/run-trace.command.js +25 -0
  389. package/dist/commands/task/run-trace.spec.d.ts +7 -0
  390. package/dist/commands/task/run-trace.spec.d.ts.map +1 -0
  391. package/dist/commands/task/run-trace.spec.js +31 -0
  392. package/dist/commands/task/run.command.d.ts +6 -0
  393. package/dist/commands/task/run.command.d.ts.map +1 -0
  394. package/dist/commands/task/run.command.js +74 -0
  395. package/dist/commands/task/run.spec.d.ts +7 -0
  396. package/dist/commands/task/run.spec.d.ts.map +1 -0
  397. package/dist/commands/task/run.spec.js +26 -0
  398. package/dist/commands/task/scaffold.d.ts.map +1 -1
  399. package/dist/commands/task/scaffold.js +4 -2
  400. package/dist/commands/task/scrub.d.ts.map +1 -1
  401. package/dist/commands/task/scrub.js +27 -24
  402. package/dist/commands/task/search.d.ts.map +1 -1
  403. package/dist/commands/task/search.js +21 -31
  404. package/dist/commands/task/set-status.d.ts.map +1 -1
  405. package/dist/commands/task/set-status.js +36 -152
  406. package/dist/commands/task/shared/dependencies.d.ts +4 -4
  407. package/dist/commands/task/shared/dependencies.d.ts.map +1 -1
  408. package/dist/commands/task/shared/dependencies.js +10 -2
  409. package/dist/commands/task/shared/docs.d.ts +6 -1
  410. package/dist/commands/task/shared/docs.d.ts.map +1 -1
  411. package/dist/commands/task/shared/docs.js +13 -0
  412. package/dist/commands/task/shared/listing.d.ts +16 -2
  413. package/dist/commands/task/shared/listing.d.ts.map +1 -1
  414. package/dist/commands/task/shared/listing.js +56 -0
  415. package/dist/commands/task/shared/transition-command.d.ts +15 -0
  416. package/dist/commands/task/shared/transition-command.d.ts.map +1 -0
  417. package/dist/commands/task/shared/transition-command.js +43 -0
  418. package/dist/commands/task/shared/transitions.d.ts +39 -0
  419. package/dist/commands/task/shared/transitions.d.ts.map +1 -1
  420. package/dist/commands/task/shared/transitions.js +62 -1
  421. package/dist/commands/task/shared/workflow-transition-service.d.ts +75 -0
  422. package/dist/commands/task/shared/workflow-transition-service.d.ts.map +1 -0
  423. package/dist/commands/task/shared/workflow-transition-service.js +226 -0
  424. package/dist/commands/task/shared.d.ts +5 -3
  425. package/dist/commands/task/shared.d.ts.map +1 -1
  426. package/dist/commands/task/shared.js +5 -3
  427. package/dist/commands/task/show.d.ts.map +1 -1
  428. package/dist/commands/task/show.js +37 -3
  429. package/dist/commands/task/start.d.ts.map +1 -1
  430. package/dist/commands/task/start.js +33 -119
  431. package/dist/commands/task/task.command.d.ts +3 -4
  432. package/dist/commands/task/task.command.d.ts.map +1 -1
  433. package/dist/commands/task/task.command.js +22 -37
  434. package/dist/commands/task/verify-record.d.ts.map +1 -1
  435. package/dist/commands/task/verify-record.js +16 -141
  436. package/dist/commands/task/verify.command.d.ts.map +1 -1
  437. package/dist/commands/task/verify.command.js +7 -6
  438. package/dist/commands/task.test-helpers.d.ts +13 -0
  439. package/dist/commands/task.test-helpers.d.ts.map +1 -0
  440. package/dist/commands/task.test-helpers.js +65 -0
  441. package/dist/commands/upgrade/materialize.d.ts +28 -0
  442. package/dist/commands/upgrade/materialize.d.ts.map +1 -0
  443. package/dist/commands/upgrade/materialize.js +154 -0
  444. package/dist/commands/upgrade/plan.d.ts +18 -0
  445. package/dist/commands/upgrade/plan.d.ts.map +1 -0
  446. package/dist/commands/upgrade/plan.js +219 -0
  447. package/dist/commands/upgrade/policy.d.ts +24 -0
  448. package/dist/commands/upgrade/policy.d.ts.map +1 -0
  449. package/dist/commands/upgrade/policy.js +182 -0
  450. package/dist/commands/upgrade/report.d.ts.map +1 -1
  451. package/dist/commands/upgrade/report.js +7 -5
  452. package/dist/commands/upgrade.d.ts.map +1 -1
  453. package/dist/commands/upgrade.js +154 -642
  454. package/dist/commands/workflow.command.d.ts +3 -4
  455. package/dist/commands/workflow.command.d.ts.map +1 -1
  456. package/dist/commands/workflow.command.js +8 -25
  457. package/dist/ports/task-backend-port.d.ts +3 -1
  458. package/dist/ports/task-backend-port.d.ts.map +1 -1
  459. package/dist/runner/adapters/codex.d.ts +9 -0
  460. package/dist/runner/adapters/codex.d.ts.map +1 -0
  461. package/dist/runner/adapters/codex.js +414 -0
  462. package/dist/runner/adapters/custom.d.ts +12 -0
  463. package/dist/runner/adapters/custom.d.ts.map +1 -0
  464. package/dist/runner/adapters/custom.js +512 -0
  465. package/dist/runner/adapters/index.d.ts +8 -0
  466. package/dist/runner/adapters/index.d.ts.map +1 -0
  467. package/dist/runner/adapters/index.js +15 -0
  468. package/dist/runner/adapters/recipe-run-profile.d.ts +8 -0
  469. package/dist/runner/adapters/recipe-run-profile.d.ts.map +1 -0
  470. package/dist/runner/adapters/recipe-run-profile.js +53 -0
  471. package/dist/runner/adapters/shared.d.ts +45 -0
  472. package/dist/runner/adapters/shared.d.ts.map +1 -0
  473. package/dist/runner/adapters/shared.js +58 -0
  474. package/dist/runner/artifacts.d.ts +31 -0
  475. package/dist/runner/artifacts.d.ts.map +1 -0
  476. package/dist/runner/artifacts.js +153 -0
  477. package/dist/runner/codex-approval-probe.d.ts +23 -0
  478. package/dist/runner/codex-approval-probe.d.ts.map +1 -0
  479. package/dist/runner/codex-approval-probe.js +55 -0
  480. package/dist/runner/codex-smoke.d.ts +11 -0
  481. package/dist/runner/codex-smoke.d.ts.map +1 -0
  482. package/dist/runner/codex-smoke.js +45 -0
  483. package/dist/runner/config.d.ts +6 -0
  484. package/dist/runner/config.d.ts.map +1 -0
  485. package/dist/runner/config.js +15 -0
  486. package/dist/runner/context/base-prompts.d.ts +10 -0
  487. package/dist/runner/context/base-prompts.d.ts.map +1 -0
  488. package/dist/runner/context/base-prompts.js +255 -0
  489. package/dist/runner/context/recipe-context.d.ts +17 -0
  490. package/dist/runner/context/recipe-context.d.ts.map +1 -0
  491. package/dist/runner/context/recipe-context.js +48 -0
  492. package/dist/runner/context/task-context.d.ts +24 -0
  493. package/dist/runner/context/task-context.d.ts.map +1 -0
  494. package/dist/runner/context/task-context.js +266 -0
  495. package/dist/runner/index.d.ts +12 -0
  496. package/dist/runner/index.d.ts.map +1 -0
  497. package/dist/runner/index.js +11 -0
  498. package/dist/runner/policy-decision.d.ts +12 -0
  499. package/dist/runner/policy-decision.d.ts.map +1 -0
  500. package/dist/runner/policy-decision.js +89 -0
  501. package/dist/runner/policy-display.d.ts +4 -0
  502. package/dist/runner/policy-display.d.ts.map +1 -0
  503. package/dist/runner/policy-display.js +41 -0
  504. package/dist/runner/process-supervision.d.ts +48 -0
  505. package/dist/runner/process-supervision.d.ts.map +1 -0
  506. package/dist/runner/process-supervision.js +490 -0
  507. package/dist/runner/result-manifest-policy.d.ts +9 -0
  508. package/dist/runner/result-manifest-policy.d.ts.map +1 -0
  509. package/dist/runner/result-manifest-policy.js +96 -0
  510. package/dist/runner/result-manifest.d.ts +30 -0
  511. package/dist/runner/result-manifest.d.ts.map +1 -0
  512. package/dist/runner/result-manifest.js +322 -0
  513. package/dist/runner/run-id.d.ts +2 -0
  514. package/dist/runner/run-id.d.ts.map +1 -0
  515. package/dist/runner/run-id.js +3 -0
  516. package/dist/runner/run-repository.d.ts +51 -0
  517. package/dist/runner/run-repository.d.ts.map +1 -0
  518. package/dist/runner/run-repository.js +222 -0
  519. package/dist/runner/task-run-paths.d.ts +19 -0
  520. package/dist/runner/task-run-paths.d.ts.map +1 -0
  521. package/dist/runner/task-run-paths.js +25 -0
  522. package/dist/runner/task-state.d.ts +9 -0
  523. package/dist/runner/task-state.d.ts.map +1 -0
  524. package/dist/runner/task-state.js +354 -0
  525. package/dist/runner/test-helpers.d.ts +30 -0
  526. package/dist/runner/test-helpers.d.ts.map +1 -0
  527. package/dist/runner/test-helpers.js +97 -0
  528. package/dist/runner/trace-artifacts.d.ts +14 -0
  529. package/dist/runner/trace-artifacts.d.ts.map +1 -0
  530. package/dist/runner/trace-artifacts.js +80 -0
  531. package/dist/runner/trace.d.ts +10 -0
  532. package/dist/runner/trace.d.ts.map +1 -0
  533. package/dist/runner/trace.js +37 -0
  534. package/dist/runner/types.d.ts +317 -0
  535. package/dist/runner/types.d.ts.map +1 -0
  536. package/dist/runner/types.js +3 -0
  537. package/dist/runner/usecases/scenario-materialize-task.d.ts +29 -0
  538. package/dist/runner/usecases/scenario-materialize-task.d.ts.map +1 -0
  539. package/dist/runner/usecases/scenario-materialize-task.js +151 -0
  540. package/dist/runner/usecases/task-run-inspect.d.ts +41 -0
  541. package/dist/runner/usecases/task-run-inspect.d.ts.map +1 -0
  542. package/dist/runner/usecases/task-run-inspect.js +74 -0
  543. package/dist/runner/usecases/task-run-lifecycle-cancel.d.ts +10 -0
  544. package/dist/runner/usecases/task-run-lifecycle-cancel.d.ts.map +1 -0
  545. package/dist/runner/usecases/task-run-lifecycle-cancel.js +172 -0
  546. package/dist/runner/usecases/task-run-lifecycle-replay.d.ts +18 -0
  547. package/dist/runner/usecases/task-run-lifecycle-replay.d.ts.map +1 -0
  548. package/dist/runner/usecases/task-run-lifecycle-replay.js +128 -0
  549. package/dist/runner/usecases/task-run-lifecycle-shared.d.ts +45 -0
  550. package/dist/runner/usecases/task-run-lifecycle-shared.d.ts.map +1 -0
  551. package/dist/runner/usecases/task-run-lifecycle-shared.js +172 -0
  552. package/dist/runner/usecases/task-run-lifecycle.d.ts +4 -0
  553. package/dist/runner/usecases/task-run-lifecycle.d.ts.map +1 -0
  554. package/dist/runner/usecases/task-run-lifecycle.js +2 -0
  555. package/dist/runner/usecases/task-run.d.ts +32 -0
  556. package/dist/runner/usecases/task-run.d.ts.map +1 -0
  557. package/dist/runner/usecases/task-run.js +278 -0
  558. package/dist/shared/agent-emoji.d.ts.map +1 -1
  559. package/dist/shared/agent-emoji.js +1 -0
  560. package/dist/shared/errors.d.ts +1 -1
  561. package/dist/shared/errors.d.ts.map +1 -1
  562. package/dist/shared/guards.d.ts.map +1 -1
  563. package/dist/shared/guards.js +1 -0
  564. package/dist/shared/repo-cli-version.d.ts.map +1 -1
  565. package/dist/shared/repo-cli-version.js +7 -5
  566. package/dist/shared/task-doc-conflicts.d.ts +12 -0
  567. package/dist/shared/task-doc-conflicts.d.ts.map +1 -0
  568. package/dist/shared/task-doc-conflicts.js +40 -0
  569. package/dist/shared/task-doc-state.d.ts +10 -0
  570. package/dist/shared/task-doc-state.d.ts.map +1 -0
  571. package/dist/shared/task-doc-state.js +15 -0
  572. package/dist/test-helpers/fs.d.ts +2 -0
  573. package/dist/test-helpers/fs.d.ts.map +1 -0
  574. package/dist/test-helpers/fs.js +9 -0
  575. package/dist/usecases/context/resolve-context.d.ts +2 -0
  576. package/dist/usecases/context/resolve-context.d.ts.map +1 -1
  577. package/dist/usecases/context/resolve-context.js +4 -1
  578. package/dist/usecases/task/task-list-usecase.d.ts.map +1 -1
  579. package/dist/usecases/task/task-list-usecase.js +2 -8
  580. package/dist/workflow-runtime/fix.d.ts +9 -1
  581. package/dist/workflow-runtime/fix.d.ts.map +1 -1
  582. package/dist/workflow-runtime/fix.js +9 -1
  583. package/package.json +3 -2
  584. package/dist/backends/task-backend.test-helpers.d.ts +0 -4
  585. package/dist/backends/task-backend.test-helpers.d.ts.map +0 -1
  586. package/dist/backends/task-backend.test-helpers.js +0 -33
  587. package/dist/cli/run-cli/catalog.d.ts +0 -7
  588. package/dist/cli/run-cli/catalog.d.ts.map +0 -1
  589. package/dist/cli/run-cli/catalog.js +0 -22
  590. package/dist/cli/run-cli.core.pr-flow.test-helpers.d.ts +0 -3
  591. package/dist/cli/run-cli.core.pr-flow.test-helpers.d.ts.map +0 -1
  592. package/dist/cli/run-cli.core.pr-flow.test-helpers.js +0 -41
  593. package/dist/cli/run-cli.core.tasks.test-helpers.d.ts +0 -2
  594. package/dist/cli/run-cli.core.tasks.test-helpers.d.ts.map +0 -1
  595. package/dist/cli/run-cli.core.tasks.test-helpers.js +0 -6
  596. package/dist/commands/block.command.d.ts +0 -4
  597. package/dist/commands/block.command.d.ts.map +0 -1
  598. package/dist/commands/block.command.js +0 -2
  599. package/dist/commands/doctor.command.d.ts +0 -3
  600. package/dist/commands/doctor.command.d.ts.map +0 -1
  601. package/dist/commands/doctor.command.js +0 -2
  602. package/dist/commands/finish.command.d.ts +0 -4
  603. package/dist/commands/finish.command.d.ts.map +0 -1
  604. package/dist/commands/finish.command.js +0 -2
  605. package/dist/commands/recipes/install.command.d.ts +0 -3
  606. package/dist/commands/recipes/install.command.d.ts.map +0 -1
  607. package/dist/commands/recipes/install.command.js +0 -2
  608. package/dist/commands/start.command.d.ts +0 -4
  609. package/dist/commands/start.command.d.ts.map +0 -1
  610. package/dist/commands/start.command.js +0 -2
  611. package/dist/commands/task/list.command.d.ts +0 -4
  612. package/dist/commands/task/list.command.d.ts.map +0 -1
  613. package/dist/commands/task/list.command.js +0 -2
  614. package/dist/commands/task/next.command.d.ts +0 -4
  615. package/dist/commands/task/next.command.d.ts.map +0 -1
  616. package/dist/commands/task/next.command.js +0 -2
  617. package/dist/commands/task/search.command.d.ts +0 -4
  618. package/dist/commands/task/search.command.d.ts.map +0 -1
  619. package/dist/commands/task/search.command.js +0 -2
  620. package/dist/commands/task/show.command.d.ts +0 -4
  621. package/dist/commands/task/show.command.d.ts.map +0 -1
  622. package/dist/commands/task/show.command.js +0 -2
  623. package/dist/commands/verify.command.d.ts +0 -4
  624. package/dist/commands/verify.command.d.ts.map +0 -1
  625. package/dist/commands/verify.command.js +0 -2
@@ -1,7 +1,9 @@
1
1
  export { dedupeStrings } from "../../shared/strings.js";
2
- export { decodeEscapedTaskTextNewlines, nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, } from "./shared/docs.js";
2
+ export { decodeEscapedTaskTextNewlines, nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, resolveWritableDocSections, } from "./shared/docs.js";
3
3
  export { normalizeDependsOnInput, normalizeTaskStatus, toStringArray, requiresVerify, type PrimaryTagResolution, type TaskTagPolicy, readTaskTagPolicy, resolvePrimaryTagFromConfig, requiresVerifyStepsByPrimary, requiresVerificationByPrimary, resolvePrimaryTag, warnIfUnknownOwner, } from "./shared/tags.js";
4
4
  export { type DependencyState, dependencyWarningMessages, ensureTaskDependsOnGraphIsAcyclic, resolveTaskDependencyState, buildDependencyState, formatTaskLine, } from "./shared/dependencies.js";
5
- export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, resolveCommentCommitWarning, requireStructuredComment, enforceStatusCommitPolicy, resolveStatusCommitPolicyWarning, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, } from "./shared/transitions.js";
6
- export { type TaskListFilters, parseTaskListFilters, handleTaskListWarnings, taskTextBlob, } from "./shared/listing.js";
5
+ export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, emitTransitionWarnings, resolveCommentCommitWarning, requireStructuredComment, prepareTaskTransitionComment, resolveTaskTransitionExecutorAgent, runTaskTransitionCommentCommit, enforceStatusCommitPolicy, resolveStatusCommitPolicyWarning, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, } from "./shared/transitions.js";
6
+ export { buildTaskStatusTransition, executeTaskStatusTransitionRequest, buildTaskVerificationTransition, executeTaskVerificationTransitionRequest, readDeferredTaskTransitionWarnings, type TaskTransitionWrite, type TaskStatusTransitionDependencyPolicy, type TaskStatusTransitionCommentCommitPolicy, type ExecuteTaskStatusTransitionRequest, type TaskStatusTransitionExecution, type ExecuteTaskVerificationTransitionRequest, type TaskVerificationTransitionExecution, } from "./shared/workflow-transition-service.js";
7
+ export { applyTaskStatusTransitionCommand } from "./shared/transition-command.js";
8
+ export { type TaskListFilters, parseTaskListFilters, handleTaskListWarnings, queryTaskProjection, type QueryTaskProjectionResult, taskTextBlob, } from "./shared/listing.js";
7
9
  //# sourceMappingURL=shared.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,6BAA6B,EAC7B,MAAM,EACN,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,eAAe,EACpB,yBAAyB,EACzB,iCAAiC,EACjC,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,qCAAqC,EACrC,mBAAmB,EACnB,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,EAChC,6BAA6B,EAC7B,cAAc,EACd,cAAc,EACd,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,KAAK,eAAe,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,GACb,MAAM,qBAAqB,CAAC"}
1
+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/task/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,6BAA6B,EAC7B,MAAM,EACN,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,oCAAoC,EACpC,kCAAkC,EAClC,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,iBAAiB,EACjB,2BAA2B,EAC3B,4BAA4B,EAC5B,6BAA6B,EAC7B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,eAAe,EACpB,yBAAyB,EACzB,iCAAiC,EACjC,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,4BAA4B,EAC5B,qCAAqC,EACrC,mBAAmB,EACnB,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,kCAAkC,EAClC,8BAA8B,EAC9B,yBAAyB,EACzB,gCAAgC,EAChC,6BAA6B,EAC7B,cAAc,EACd,cAAc,EACd,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,yBAAyB,EACzB,kCAAkC,EAClC,+BAA+B,EAC/B,wCAAwC,EACxC,kCAAkC,EAClC,KAAK,mBAAmB,EACxB,KAAK,oCAAoC,EACzC,KAAK,uCAAuC,EAC5C,KAAK,kCAAkC,EACvC,KAAK,6BAA6B,EAClC,KAAK,wCAAwC,EAC7C,KAAK,mCAAmC,GACzC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EACL,KAAK,eAAe,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,YAAY,GACb,MAAM,qBAAqB,CAAC"}
@@ -1,6 +1,8 @@
1
1
  export { dedupeStrings } from "../../shared/strings.js";
2
- export { decodeEscapedTaskTextNewlines, nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, } from "./shared/docs.js";
2
+ export { decodeEscapedTaskTextNewlines, nowIso, normalizeTaskDocVersion, taskObservationSectionName, extractTaskObservationSection, VERIFY_STEPS_PLACEHOLDER, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, extractDocSection, isVerifyStepsFilled, isDocSectionFilled, ensureAgentFilledRequiredDocSections, normalizeVerificationSectionLayout, resolveWritableDocSections, } from "./shared/docs.js";
3
3
  export { normalizeDependsOnInput, normalizeTaskStatus, toStringArray, requiresVerify, readTaskTagPolicy, resolvePrimaryTagFromConfig, requiresVerifyStepsByPrimary, requiresVerificationByPrimary, resolvePrimaryTag, warnIfUnknownOwner, } from "./shared/tags.js";
4
4
  export { dependencyWarningMessages, ensureTaskDependsOnGraphIsAcyclic, resolveTaskDependencyState, buildDependencyState, formatTaskLine, } from "./shared/dependencies.js";
5
- export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, resolveCommentCommitWarning, requireStructuredComment, enforceStatusCommitPolicy, resolveStatusCommitPolicyWarning, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, } from "./shared/transitions.js";
6
- export { parseTaskListFilters, handleTaskListWarnings, taskTextBlob, } from "./shared/listing.js";
5
+ export { appendTaskEvent, ensurePlanApprovedIfRequired, ensureVerificationSatisfiedIfRequired, isTransitionAllowed, ensureStatusTransitionAllowed, ensureCommentCommitAllowed, emitTransitionWarnings, resolveCommentCommitWarning, requireStructuredComment, prepareTaskTransitionComment, resolveTaskTransitionExecutorAgent, runTaskTransitionCommentCommit, enforceStatusCommitPolicy, resolveStatusCommitPolicyWarning, isMajorStatusCommitTransition, readHeadCommit, readCommitInfo, defaultCommitEmojiForStatus, } from "./shared/transitions.js";
6
+ export { buildTaskStatusTransition, executeTaskStatusTransitionRequest, buildTaskVerificationTransition, executeTaskVerificationTransitionRequest, readDeferredTaskTransitionWarnings, } from "./shared/workflow-transition-service.js";
7
+ export { applyTaskStatusTransitionCommand } from "./shared/transition-command.js";
8
+ export { parseTaskListFilters, handleTaskListWarnings, queryTaskProjection, taskTextBlob, } from "./shared/listing.js";
@@ -1 +1 @@
1
- {"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/task/show.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BlB"}
1
+ {"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/task/show.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AA4BnC,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsClB"}
@@ -1,11 +1,35 @@
1
- import { validateTaskDocMetadata } from "@agentplaneorg/core";
1
+ import { parseTaskReadme, taskReadmePath, validateTaskDocMetadata } from "@agentplaneorg/core";
2
+ import { readFile } from "node:fs/promises";
3
+ import path from "node:path";
2
4
  import { mapBackendError } from "../../cli/error-map.js";
3
5
  import { CliError } from "../../shared/errors.js";
4
6
  import { loadCommandContext, loadTaskFromContext, taskDataToFrontmatter, } from "../shared/task-backend.js";
7
+ async function detectLocalTaskMetadataErrors(ctx, taskId) {
8
+ if (ctx.backendId !== "local")
9
+ return null;
10
+ const readmePath = taskReadmePath(path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.workflow_dir), taskId);
11
+ try {
12
+ const text = await readFile(readmePath, "utf8");
13
+ const parsed = parseTaskReadme(text);
14
+ const frontmatter = {
15
+ ...parsed.frontmatter,
16
+ id: typeof parsed.frontmatter.id === "string" && parsed.frontmatter.id.trim().length > 0
17
+ ? parsed.frontmatter.id
18
+ : taskId,
19
+ };
20
+ const metadataErrors = validateTaskDocMetadata(frontmatter);
21
+ return metadataErrors.length > 0 ? metadataErrors : null;
22
+ }
23
+ catch {
24
+ return null;
25
+ }
26
+ }
5
27
  export async function cmdTaskShow(opts) {
28
+ let ctx = null;
6
29
  try {
7
- const ctx = opts.ctx ??
8
- (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
30
+ ctx =
31
+ opts.ctx ??
32
+ (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
9
33
  const task = await loadTaskFromContext({ ctx, taskId: opts.taskId });
10
34
  const frontmatter = taskDataToFrontmatter(task);
11
35
  if (ctx.backendId === "local") {
@@ -22,6 +46,16 @@ export async function cmdTaskShow(opts) {
22
46
  return 0;
23
47
  }
24
48
  catch (err) {
49
+ if (!(err instanceof CliError) && ctx) {
50
+ const metadataErrors = await detectLocalTaskMetadataErrors(ctx, opts.taskId);
51
+ if (metadataErrors && metadataErrors.length > 0) {
52
+ throw new CliError({
53
+ exitCode: 3,
54
+ code: "E_VALIDATION",
55
+ message: `Invalid task README metadata: ${metadataErrors.join("; ")}`,
56
+ });
57
+ }
58
+ }
25
59
  if (err instanceof CliError)
26
60
  throw err;
27
61
  throw mapBackendError(err, {
@@ -1 +1 @@
1
- {"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAyEnC,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkLlB"}
1
+ {"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/task/start.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA4DpF,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IACnC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoFlB"}
@@ -1,13 +1,9 @@
1
1
  import { mapBackendError } from "../../cli/error-map.js";
2
- import { infoMessage, successMessage, warnMessage } from "../../cli/output.js";
3
- import { formatCommentBodyForCommit } from "../../shared/comment-format.js";
2
+ import { successMessage } from "../../cli/output.js";
4
3
  import { CliError } from "../../shared/errors.js";
5
- import { commitFromComment } from "../guard/index.js";
6
4
  import { ensureActionApproved } from "../shared/approval-requirements.js";
7
- import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
8
- import { appendTaskCommentIntent, appendTaskEventIntent, backendIsLocalFileBackend, getTaskStore, mutateTaskStore, setTaskFieldsIntent, touchTaskDocMetaIntent, } from "../shared/task-store.js";
9
- import { readDirectWorkLock } from "../../shared/direct-work-lock.js";
10
- import { appendTaskEvent, ensurePlanApprovedIfRequired, ensureCommentCommitAllowed, ensureStatusTransitionAllowed, extractTaskObservationSection, defaultCommitEmojiForStatus, extractDocSection, isVerifyStepsFilled, normalizeTaskDocVersion, nowIso, requiresVerifyStepsByPrimary, requireStructuredComment, resolveTaskDependencyState, resolvePrimaryTag, taskObservationSectionName, toStringArray, } from "./shared.js";
5
+ import { loadCommandContext } from "../shared/task-backend.js";
6
+ import { applyTaskStatusTransitionCommand, ensurePlanApprovedIfRequired, extractTaskObservationSection, defaultCommitEmojiForStatus, extractDocSection, isVerifyStepsFilled, normalizeTaskDocVersion, nowIso, prepareTaskTransitionComment, requiresVerifyStepsByPrimary, requireStructuredComment, runTaskTransitionCommentCommit, taskObservationSectionName, toStringArray, } from "./shared.js";
11
7
  function assertStartDocRequirements(task, config) {
12
8
  if (config.agents?.approvals?.require_plan === true)
13
9
  return;
@@ -58,141 +54,59 @@ export async function cmdStart(opts) {
58
54
  }
59
55
  const { prefix, min_chars: minChars } = ctx.config.tasks.comments.start;
60
56
  requireStructuredComment(opts.body, prefix, minChars);
61
- const useStore = backendIsLocalFileBackend(ctx);
62
- const store = useStore ? getTaskStore(ctx) : null;
63
- const task = useStore
64
- ? await store.get(opts.taskId)
65
- : await loadTaskFromContext({ ctx, taskId: opts.taskId });
66
- if (!useStore) {
67
- assertStartDocRequirements(task, ctx.config);
68
- ensurePlanApprovedIfRequired(task, ctx.config);
69
- }
70
- const currentStatus = String(task.status || "TODO").toUpperCase();
71
- if (!useStore) {
72
- ensureStatusTransitionAllowed({
73
- currentStatus,
74
- nextStatus: "DOING",
75
- force: opts.force,
76
- });
77
- }
78
- ensureCommentCommitAllowed({
57
+ const preparedComment = prepareTaskTransitionComment({
58
+ body: opts.body,
79
59
  enabled: opts.commitFromComment,
80
60
  config: ctx.config,
81
- action: "start",
82
- confirmed: opts.confirmStatusCommit,
83
- quiet: opts.quiet,
84
- statusFrom: currentStatus,
85
- statusTo: "DOING",
86
61
  });
87
- if (!opts.force) {
88
- const dep = await resolveTaskDependencyState(task, ctx.taskBackend);
89
- if (dep.missing.length > 0 || dep.incomplete.length > 0) {
90
- if (!opts.quiet) {
91
- if (dep.missing.length > 0) {
92
- process.stderr.write(`${warnMessage(`missing deps: ${dep.missing.join(", ")}`)}\n`);
93
- }
94
- if (dep.incomplete.length > 0) {
95
- process.stderr.write(`${warnMessage(`incomplete deps: ${dep.incomplete.join(", ")}`)}\n`);
96
- }
97
- }
98
- throw new CliError({
99
- exitCode: 2,
100
- code: "E_USAGE",
101
- message: `Task is not ready: ${task.id} (use --force to override)`,
102
- });
103
- }
104
- }
105
- const formattedComment = opts.commitFromComment
106
- ? formatCommentBodyForCommit(opts.body, ctx.config)
107
- : null;
108
- const commentBody = formattedComment ?? opts.body;
109
- const existingComments = Array.isArray(task.comments)
110
- ? task.comments.filter((item) => !!item && typeof item.author === "string" && typeof item.body === "string")
111
- : [];
112
- const commentsValue = [
113
- ...existingComments,
114
- { author: opts.author, body: commentBody },
115
- ];
62
+ const commentBody = preparedComment.commentBody ?? opts.body;
116
63
  const at = nowIso();
117
- let currentStatusForCommit = currentStatus;
118
- let primaryTagForCommit = resolvePrimaryTag(toStringArray(task.tags), ctx).primary;
119
- await (useStore
120
- ? mutateTaskStore(store, opts.taskId, (current) => {
64
+ const transition = await applyTaskStatusTransitionCommand({
65
+ ctx,
66
+ taskId: opts.taskId,
67
+ quiet: opts.quiet,
68
+ build: (current) => {
121
69
  assertStartDocRequirements(current, ctx.config);
122
70
  ensurePlanApprovedIfRequired(current, ctx.config);
123
- const currentStatus = String(current.status || "TODO").toUpperCase();
124
- currentStatusForCommit = currentStatus;
125
- primaryTagForCommit = resolvePrimaryTag(toStringArray(current.tags), ctx).primary;
126
- ensureStatusTransitionAllowed({
127
- currentStatus,
128
- nextStatus: "DOING",
129
- force: opts.force,
130
- });
131
- return [
132
- setTaskFieldsIntent({ status: "DOING" }),
133
- appendTaskCommentIntent({ author: opts.author, body: commentBody }),
134
- appendTaskEventIntent({
135
- type: "status",
136
- at,
137
- author: opts.author,
138
- from: currentStatus,
139
- to: "DOING",
140
- note: commentBody,
141
- }),
142
- touchTaskDocMetaIntent({
143
- updatedBy: opts.author,
144
- version: normalizeTaskDocVersion(current.doc_version),
145
- }),
146
- ];
147
- })
148
- : ctx.taskBackend.writeTask({
149
- ...task,
150
- status: "DOING",
151
- comments: commentsValue,
152
- events: appendTaskEvent(task, {
153
- type: "status",
71
+ return {
154
72
  at,
155
- author: opts.author,
156
- from: currentStatus,
157
- to: "DOING",
73
+ toStatus: "DOING",
74
+ eventAuthor: opts.author,
75
+ updatedBy: opts.author,
158
76
  note: commentBody,
159
- }),
160
- doc_version: normalizeTaskDocVersion(task.doc_version),
161
- doc_updated_at: at,
162
- doc_updated_by: opts.author,
163
- }));
77
+ comment: { author: opts.author, body: commentBody },
78
+ force: opts.force,
79
+ dependencyPolicy: { kind: "require-ready" },
80
+ commentCommitPolicy: {
81
+ enabled: opts.commitFromComment,
82
+ action: "start",
83
+ confirmed: opts.confirmStatusCommit,
84
+ quiet: opts.quiet,
85
+ },
86
+ };
87
+ },
88
+ });
164
89
  let commitInfo = null;
165
90
  if (opts.commitFromComment) {
166
- if (!opts.quiet) {
167
- process.stdout.write(`${infoMessage("task marked DOING; creating commit from start comment")}\n`);
168
- }
169
- const mode = ctx.config.workflow_mode;
170
- let executorAgent = opts.author;
171
- if (mode === "direct") {
172
- const lock = await readDirectWorkLock(ctx.resolvedProject.agentplaneDir);
173
- const lockAgent = lock?.task_id === opts.taskId ? (lock.agent?.trim() ?? "") : "";
174
- if (lockAgent)
175
- executorAgent = lockAgent;
176
- }
177
- commitInfo = await commitFromComment({
91
+ commitInfo = await runTaskTransitionCommentCommit({
178
92
  ctx,
179
93
  cwd: opts.cwd,
180
94
  rootOverride: opts.rootOverride,
181
95
  taskId: opts.taskId,
182
- primaryTag: primaryTagForCommit,
183
- executorAgent,
96
+ primaryTag: transition.primaryTag,
184
97
  author: opts.author,
185
- statusFrom: currentStatusForCommit,
98
+ statusFrom: transition.execution.currentStatus,
186
99
  statusTo: "DOING",
187
100
  commentBody: opts.body,
188
- formattedComment,
101
+ formattedComment: preparedComment.formattedComment,
189
102
  emoji: opts.commitEmoji ?? defaultCommitEmojiForStatus("DOING"),
190
103
  allow: opts.commitAllow,
191
104
  autoAllow: opts.commitAutoAllow || opts.commitAllow.length === 0,
192
105
  allowTasks: opts.commitAllowTasks,
193
106
  requireClean: opts.commitRequireClean,
194
107
  quiet: opts.quiet,
195
- config: ctx.config,
108
+ progressMessage: "task marked DOING; creating commit from start comment",
109
+ resolveExecutorAgent: true,
196
110
  });
197
111
  }
198
112
  if (!opts.quiet) {
@@ -1,8 +1,7 @@
1
1
  import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
2
- type TaskGroupParsed = {
3
- cmd: string[];
4
- };
2
+ import { type GroupCommandParsed } from "../../cli/group-command.js";
3
+ type TaskGroupParsed = GroupCommandParsed;
5
4
  export declare const taskSpec: CommandSpec<TaskGroupParsed>;
6
- export declare const runTask: CommandHandler<TaskGroupParsed>;
5
+ export declare const runTask: CommandHandler<GroupCommandParsed>;
7
6
  export {};
8
7
  //# sourceMappingURL=task.command.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"task.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/task.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAItF,KAAK,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AA6BzC,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,eAAe,CA8BjD,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,eAAe,CAWnD,CAAC"}
1
+ {"version":3,"file":"task.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/task.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AACpC,KAAK,eAAe,GAAG,kBAAkB,CAAC;AAE1C,eAAO,MAAM,QAAQ,EAAE,WAAW,CAAC,eAAe,CA8CjD,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,cAAc,CAAC,kBAAkB,CAOtD,CAAC"}
@@ -1,31 +1,4 @@
1
- import { usageError } from "../../cli/spec/errors.js";
2
- import { suggestOne } from "../../cli/spec/suggest.js";
3
- const TASK_SUBCOMMANDS = [
4
- "add",
5
- "close-duplicate",
6
- "close-noop",
7
- "comment",
8
- "derive",
9
- "doc",
10
- "export",
11
- "lint",
12
- "list",
13
- "migrate",
14
- "migrate-doc",
15
- "new",
16
- "next",
17
- "normalize",
18
- "plan",
19
- "rebuild-index",
20
- "scrub",
21
- "search",
22
- "set-status",
23
- "show",
24
- "start-ready",
25
- "update",
26
- "verify",
27
- "verify-show",
28
- ];
1
+ import { loadDirectSubcommandNames, parseGroupCommand, throwGroupCommandUsage, } from "../../cli/group-command.js";
29
2
  export const taskSpec = {
30
3
  id: ["task"],
31
4
  group: "Task",
@@ -54,18 +27,30 @@ export const taskSpec = {
54
27
  cmd: "agentplane task verify-show <task-id>",
55
28
  why: "Show Verify Steps before running checks.",
56
29
  },
30
+ {
31
+ cmd: "agentplane task run <task-id>",
32
+ why: "Run an existing task through the shared runner flow.",
33
+ },
34
+ {
35
+ cmd: 'agentplane task handoff record <task-id> --from CODER --reason "Paused for handoff"',
36
+ why: "Persist a first-class handoff snapshot.",
37
+ },
38
+ {
39
+ cmd: 'agentplane task hosted-close --event-json "$GITHUB_EVENT_PATH"',
40
+ why: "Apply deterministic task closure from a merged hosted PR event on an automation branch.",
41
+ },
42
+ {
43
+ cmd: "agentplane task resume-context <task-id>",
44
+ why: "Inspect deterministic recovery context before resuming or retrying a run.",
45
+ },
57
46
  ],
58
- parse: (raw) => ({ cmd: (raw.args.cmd ?? []) }),
47
+ parse: (raw) => parseGroupCommand(raw),
59
48
  };
60
- export const runTask = (_ctx, p) => {
61
- const input = p.cmd.join(" ");
62
- const suggestion = suggestOne(input, [...TASK_SUBCOMMANDS]);
63
- const suffix = suggestion ? ` Did you mean: ${suggestion}?` : "";
64
- const message = p.cmd.length === 0 ? "Missing subcommand." : `Unknown subcommand: ${p.cmd[0]}.`;
65
- throw usageError({
49
+ export const runTask = async (_ctx, p) => {
50
+ throwGroupCommandUsage({
66
51
  spec: taskSpec,
52
+ cmd: p.cmd,
53
+ subcommands: await loadDirectSubcommandNames(["task"]),
67
54
  command: "task",
68
- message: `${message}${suffix}`,
69
- context: { command: "task" },
70
55
  });
71
56
  };
@@ -1 +1 @@
1
- {"version":3,"file":"verify-record.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-record.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAqBnC,KAAK,WAAW,GAAG,IAAI,GAAG,cAAc,CAAC;AA0RzC,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAElB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAElB"}
1
+ {"version":3,"file":"verify-record.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify-record.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AASpF,KAAK,WAAW,GAAG,IAAI,GAAG,cAAc,CAAC;AA+IzC,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAElB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAElB"}
@@ -1,54 +1,12 @@
1
- import { createHash } from "node:crypto";
2
1
  import { readFile } from "node:fs/promises";
3
2
  import path from "node:path";
4
- import { ensureDocSections, setMarkdownSection } from "@agentplaneorg/core";
5
3
  import { mapBackendError, mapCoreError } from "../../cli/error-map.js";
6
4
  import { backendNotSupportedMessage, successMessage } from "../../cli/output.js";
7
5
  import { CliError } from "../../shared/errors.js";
8
6
  import { ensureReconciledBeforeMutation } from "../shared/reconcile-check.js";
9
- import { loadCommandContext, loadTaskFromContext, } from "../shared/task-backend.js";
10
- import { appendTaskEventIntent, backendIsLocalFileBackend, getTaskStore, setTaskFieldsIntent, setTaskSectionIntent, touchTaskDocMetaIntent, } from "../shared/task-store.js";
11
- import { appendTaskEvent, decodeEscapedTaskTextNewlines, extractDocSection, normalizeTaskDocVersion, normalizeVerificationSectionLayout, nowIso, VERIFICATION_RESULTS_BEGIN, VERIFICATION_RESULTS_END, } from "./shared.js";
12
- function appendBetweenMarkers(sectionText, entryText, version) {
13
- const ensured = normalizeVerificationSectionLayout(sectionText, version);
14
- const beginIdx = ensured.indexOf(VERIFICATION_RESULTS_BEGIN);
15
- const endIdx = ensured.indexOf(VERIFICATION_RESULTS_END);
16
- if (beginIdx === -1 || endIdx === -1 || endIdx <= beginIdx) {
17
- throw new Error("Verification results markers are malformed");
18
- }
19
- const beforeEnd = ensured.slice(0, endIdx).trimEnd();
20
- const afterEnd = ensured.slice(endIdx).trimStart();
21
- const entry = entryText.trimEnd();
22
- const parts = [
23
- beforeEnd,
24
- ...(beforeEnd.endsWith(VERIFICATION_RESULTS_BEGIN) ? [] : [""]),
25
- entry,
26
- "",
27
- afterEnd,
28
- ];
29
- return parts.join("\n").trimEnd();
30
- }
31
- function renderVerificationEntry(opts) {
32
- const lines = [
33
- `#### ${opts.at} — VERIFY — ${opts.state}`,
34
- "",
35
- `By: ${opts.by}`,
36
- "",
37
- `Note: ${opts.note}`,
38
- ];
39
- const verifyStepsRef = (opts.verifyStepsRef ?? "").trim();
40
- if (verifyStepsRef) {
41
- lines.push("", `VerifyStepsRef: ${verifyStepsRef}`);
42
- }
43
- const details = (opts.details ?? "").trim();
44
- if (details) {
45
- lines.push("", "Details:", "", details);
46
- }
47
- return `${lines.join("\n").trimEnd()}\n`;
48
- }
49
- function sha256Hex(text) {
50
- return createHash("sha256").update(text, "utf8").digest("hex");
51
- }
7
+ import { loadCommandContext } from "../shared/task-backend.js";
8
+ import { applyTaskMutation } from "../shared/task-mutation.js";
9
+ import { decodeEscapedTaskTextNewlines, executeTaskVerificationTransitionRequest, nowIso, } from "./shared.js";
52
10
  async function recordVerificationResult(opts) {
53
11
  const ctx = opts.ctx ??
54
12
  (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
@@ -63,108 +21,25 @@ async function recordVerificationResult(opts) {
63
21
  message: backendNotSupportedMessage("task docs"),
64
22
  });
65
23
  }
66
- const useStore = backendIsLocalFileBackend(ctx);
67
- const store = useStore ? getTaskStore(ctx) : null;
68
- const task = useStore ? null : await loadTaskFromContext({ ctx, taskId: opts.taskId });
69
24
  const at = nowIso();
70
- if (useStore) {
71
- await store.mutate(opts.taskId, (current) => {
72
- const existingDoc = String(current.doc ?? "");
73
- const baseDoc = ensureDocSections(existingDoc, config.tasks.doc.required_sections);
74
- const verificationSection = extractDocSection(baseDoc, "Verification") ?? "";
75
- const verifySteps = extractDocSection(baseDoc, "Verify Steps");
76
- const verifyStepsHash = verifySteps
77
- ? sha256Hex(verifySteps.replaceAll("\r\n", "\n").trim())
78
- : null;
79
- const docVersion = normalizeTaskDocVersion(current.doc_version);
80
- const verifyStepsRef = [
81
- `doc_version=${String(docVersion)}`,
82
- `doc_updated_at=${String(current.doc_updated_at ?? "missing")}`,
83
- `excerpt_hash=sha256:${verifyStepsHash ?? "missing"}`,
84
- ].join(", ");
85
- const entry = renderVerificationEntry({
25
+ await applyTaskMutation({
26
+ ctx,
27
+ taskId: opts.taskId,
28
+ build: async (current) => {
29
+ const execution = executeTaskVerificationTransitionRequest({
30
+ task: current,
86
31
  at,
87
- state: opts.state,
88
32
  by: opts.by,
89
33
  note: opts.note,
34
+ state: opts.state,
90
35
  details: opts.details ?? null,
91
- verifyStepsRef,
36
+ doc: (typeof current.doc === "string" ? current.doc : "") ||
37
+ (await backend.getTaskDoc(current.id)),
38
+ requiredSections: config.tasks.doc.required_sections,
92
39
  });
93
- const nextVerification = appendBetweenMarkers(verificationSection, entry, docVersion);
94
- return [
95
- setTaskFieldsIntent({
96
- status: opts.state === "needs_rework" ? "DOING" : current.status,
97
- commit: opts.state === "needs_rework" ? null : (current.commit ?? null),
98
- verification: {
99
- state: opts.state,
100
- updated_at: at,
101
- updated_by: opts.by,
102
- note: opts.note,
103
- },
104
- }),
105
- setTaskSectionIntent({
106
- section: "Verification",
107
- text: nextVerification,
108
- requiredSections: config.tasks.doc.required_sections,
109
- }),
110
- appendTaskEventIntent({
111
- type: "verify",
112
- at,
113
- author: opts.by,
114
- state: opts.state,
115
- note: opts.note,
116
- }),
117
- touchTaskDocMetaIntent({ updatedBy: opts.by }),
118
- ];
119
- });
120
- }
121
- else {
122
- const remoteTask = task;
123
- const existingDoc = (typeof remoteTask.doc === "string" ? remoteTask.doc : "") ||
124
- (await backend.getTaskDoc(remoteTask.id));
125
- const baseDoc = ensureDocSections(existingDoc ?? "", config.tasks.doc.required_sections);
126
- const verificationSection = extractDocSection(baseDoc, "Verification") ?? "";
127
- const verifySteps = extractDocSection(baseDoc, "Verify Steps");
128
- const verifyStepsHash = verifySteps
129
- ? sha256Hex(verifySteps.replaceAll("\r\n", "\n").trim())
130
- : null;
131
- const docVersion = normalizeTaskDocVersion(remoteTask.doc_version);
132
- const verifyStepsRef = [
133
- `doc_version=${String(docVersion)}`,
134
- `doc_updated_at=${String(remoteTask.doc_updated_at ?? "missing")}`,
135
- `excerpt_hash=sha256:${verifyStepsHash ?? "missing"}`,
136
- ].join(", ");
137
- const entry = renderVerificationEntry({
138
- at,
139
- state: opts.state,
140
- by: opts.by,
141
- note: opts.note,
142
- details: opts.details ?? null,
143
- verifyStepsRef,
144
- });
145
- const nextVerification = appendBetweenMarkers(verificationSection, entry, docVersion);
146
- const nextDoc = ensureDocSections(setMarkdownSection(baseDoc, "Verification", nextVerification), config.tasks.doc.required_sections);
147
- await backend.writeTask({
148
- ...remoteTask,
149
- status: opts.state === "needs_rework" ? "DOING" : remoteTask.status,
150
- commit: opts.state === "needs_rework" ? null : (remoteTask.commit ?? null),
151
- doc: nextDoc,
152
- doc_updated_by: opts.by,
153
- events: appendTaskEvent(remoteTask, {
154
- type: "verify",
155
- at,
156
- author: opts.by,
157
- state: opts.state,
158
- note: opts.note,
159
- }),
160
- verification: {
161
- state: opts.state,
162
- updated_at: at,
163
- updated_by: opts.by,
164
- note: opts.note,
165
- },
166
- });
167
- }
40
+ return { intents: execution.intents };
41
+ },
42
+ });
168
43
  if (!opts.quiet) {
169
44
  const readmePath = path.join(resolved.gitRoot, config.paths.workflow_dir, opts.taskId, "README.md");
170
45
  const relReadmePath = path.relative(resolved.gitRoot, readmePath);
@@ -1 +1 @@
1
- {"version":3,"file":"verify.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAYxD,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpF"}
1
+ {"version":3,"file":"verify.command.d.ts","sourceRoot":"","sources":["../../../src/commands/task/verify.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGtE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAYxD,CAAC;AAEF,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM1F"}
@@ -1,4 +1,4 @@
1
- import { usageError } from "../../cli/spec/errors.js";
1
+ import { loadDirectSubcommandNames, throwGroupCommandUsage } from "../../cli/group-command.js";
2
2
  export const taskVerifySpec = {
3
3
  id: ["task", "verify"],
4
4
  group: "Task",
@@ -12,9 +12,10 @@ export const taskVerifySpec = {
12
12
  subcommand: typeof raw.args.subcommand === "string" ? raw.args.subcommand : undefined,
13
13
  }),
14
14
  };
15
- export function runTaskVerify(_ctx, p) {
16
- if (!p.subcommand) {
17
- throw usageError({ spec: taskVerifySpec, message: "Missing subcommand." });
18
- }
19
- throw usageError({ spec: taskVerifySpec, message: `Unknown subcommand: ${p.subcommand}` });
15
+ export async function runTaskVerify(_ctx, p) {
16
+ throwGroupCommandUsage({
17
+ spec: taskVerifySpec,
18
+ cmd: p.subcommand ? [p.subcommand] : [],
19
+ subcommands: await loadDirectSubcommandNames(["task", "verify"]),
20
+ });
20
21
  }
@@ -0,0 +1,13 @@
1
+ import { defaultConfig, type ResolvedProject } from "@agentplaneorg/core";
2
+ import type { TaskBackend, TaskData } from "../backends/task-backend.js";
3
+ import type { CommandContext } from "./shared/task-backend.js";
4
+ export declare function makeTaskFixture(overrides?: Partial<TaskData>): TaskData;
5
+ export declare function makeTaskBackendDouble(overrides?: Partial<TaskBackend>): TaskBackend;
6
+ export declare function makeTaskCommandContext(opts?: {
7
+ taskBackend?: TaskBackend;
8
+ overrides?: Partial<CommandContext>;
9
+ configureConfig?: (config: ReturnType<typeof defaultConfig>) => void;
10
+ git?: CommandContext["git"];
11
+ resolvedProject?: ResolvedProject;
12
+ }): CommandContext;
13
+ //# sourceMappingURL=task.test-helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task.test-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/task.test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,wBAAgB,eAAe,CAAC,SAAS,GAAE,OAAO,CAAC,QAAQ,CAAM,GAAG,QAAQ,CAiB3E;AAED,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAuBvF;AAED,wBAAgB,sBAAsB,CACpC,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,KAAK,IAAI,CAAC;IACrE,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;CAC9B,GACL,cAAc,CAwBhB"}