agentplane 0.1.9 → 0.2.1

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 (645) hide show
  1. package/README.md +4 -4
  2. package/assets/AGENTS.md +281 -70
  3. package/assets/agents/CODER.json +1 -0
  4. package/assets/agents/INTEGRATOR.json +1 -0
  5. package/assets/agents/ORCHESTRATOR.json +1 -0
  6. package/assets/agents/PLANNER.json +1 -0
  7. package/assets/agents/TESTER.json +1 -0
  8. package/dist/backends/task-backend/load.d.ts +13 -0
  9. package/dist/backends/task-backend/load.d.ts.map +1 -0
  10. package/dist/backends/task-backend/load.js +58 -0
  11. package/dist/backends/task-backend/local-backend.d.ts +28 -0
  12. package/dist/backends/task-backend/local-backend.d.ts.map +1 -0
  13. package/dist/backends/task-backend/local-backend.js +335 -0
  14. package/dist/backends/task-backend/redmine/client.d.ts +8 -0
  15. package/dist/backends/task-backend/redmine/client.d.ts.map +1 -0
  16. package/dist/backends/task-backend/redmine/client.js +60 -0
  17. package/dist/backends/task-backend/redmine/comments.d.ts +12 -0
  18. package/dist/backends/task-backend/redmine/comments.d.ts.map +1 -0
  19. package/dist/backends/task-backend/redmine/comments.js +54 -0
  20. package/dist/backends/task-backend/redmine/fields.d.ts +9 -0
  21. package/dist/backends/task-backend/redmine/fields.d.ts.map +1 -0
  22. package/dist/backends/task-backend/redmine/fields.js +38 -0
  23. package/dist/backends/task-backend/redmine/mapping.d.ts +20 -0
  24. package/dist/backends/task-backend/redmine/mapping.d.ts.map +1 -0
  25. package/dist/backends/task-backend/redmine/mapping.js +114 -0
  26. package/dist/backends/task-backend/redmine/parse.d.ts +3 -0
  27. package/dist/backends/task-backend/redmine/parse.d.ts.map +1 -0
  28. package/dist/backends/task-backend/redmine/parse.js +27 -0
  29. package/dist/backends/task-backend/redmine/remote.d.ts +19 -0
  30. package/dist/backends/task-backend/redmine/remote.d.ts.map +1 -0
  31. package/dist/backends/task-backend/redmine/remote.js +82 -0
  32. package/dist/backends/task-backend/redmine-backend.d.ts +80 -0
  33. package/dist/backends/task-backend/redmine-backend.d.ts.map +1 -0
  34. package/dist/backends/task-backend/redmine-backend.js +505 -0
  35. package/dist/backends/task-backend/shared/concurrency.d.ts +3 -0
  36. package/dist/backends/task-backend/shared/concurrency.d.ts.map +1 -0
  37. package/dist/backends/task-backend/shared/concurrency.js +21 -0
  38. package/dist/backends/task-backend/shared/constants.d.ts +4 -0
  39. package/dist/backends/task-backend/shared/constants.d.ts.map +1 -0
  40. package/dist/backends/task-backend/shared/constants.js +4 -0
  41. package/dist/backends/task-backend/shared/doc.d.ts +11 -0
  42. package/dist/backends/task-backend/shared/doc.d.ts.map +1 -0
  43. package/dist/backends/task-backend/shared/doc.js +78 -0
  44. package/dist/backends/task-backend/shared/errors.d.ts +10 -0
  45. package/dist/backends/task-backend/shared/errors.d.ts.map +1 -0
  46. package/dist/backends/task-backend/shared/errors.js +18 -0
  47. package/dist/backends/task-backend/shared/events.d.ts +3 -0
  48. package/dist/backends/task-backend/shared/events.d.ts.map +1 -0
  49. package/dist/backends/task-backend/shared/events.js +29 -0
  50. package/dist/backends/task-backend/shared/export.d.ts +15 -0
  51. package/dist/backends/task-backend/shared/export.d.ts.map +1 -0
  52. package/dist/backends/task-backend/shared/export.js +60 -0
  53. package/dist/backends/task-backend/shared/id.d.ts +13 -0
  54. package/dist/backends/task-backend/shared/id.d.ts.map +1 -0
  55. package/dist/backends/task-backend/shared/id.js +17 -0
  56. package/dist/backends/task-backend/shared/normalize.d.ts +8 -0
  57. package/dist/backends/task-backend/shared/normalize.d.ts.map +1 -0
  58. package/dist/backends/task-backend/shared/normalize.js +54 -0
  59. package/dist/backends/task-backend/shared/record.d.ts +4 -0
  60. package/dist/backends/task-backend/shared/record.d.ts.map +1 -0
  61. package/dist/backends/task-backend/shared/record.js +53 -0
  62. package/dist/backends/task-backend/shared/strings.d.ts +4 -0
  63. package/dist/backends/task-backend/shared/strings.d.ts.map +1 -0
  64. package/dist/backends/task-backend/shared/strings.js +21 -0
  65. package/dist/backends/task-backend/shared/types.d.ts +84 -0
  66. package/dist/backends/task-backend/shared/types.d.ts.map +1 -0
  67. package/dist/backends/task-backend/shared/types.js +1 -0
  68. package/dist/backends/task-backend/shared.d.ts +11 -0
  69. package/dist/backends/task-backend/shared.d.ts.map +1 -0
  70. package/dist/backends/task-backend/shared.js +9 -0
  71. package/dist/backends/task-backend.d.ts +4 -204
  72. package/dist/backends/task-backend.d.ts.map +1 -1
  73. package/dist/backends/task-backend.js +4 -1366
  74. package/dist/backends/task-index.js +2 -2
  75. package/dist/cli/archive.d.ts +0 -2
  76. package/dist/cli/archive.d.ts.map +1 -1
  77. package/dist/cli/archive.js +1 -2
  78. package/dist/cli/command-guide.d.ts.map +1 -1
  79. package/dist/cli/command-guide.js +25 -8
  80. package/dist/cli/parse/lifecycle.d.ts +64 -0
  81. package/dist/cli/parse/lifecycle.d.ts.map +1 -0
  82. package/dist/cli/parse/lifecycle.js +280 -0
  83. package/dist/cli/run-cli/command-catalog.d.ts +16 -0
  84. package/dist/cli/run-cli/command-catalog.d.ts.map +1 -0
  85. package/dist/cli/run-cli/command-catalog.js +204 -0
  86. package/dist/cli/run-cli/commands/config.d.ts +20 -0
  87. package/dist/cli/run-cli/commands/config.d.ts.map +1 -0
  88. package/dist/cli/run-cli/commands/config.js +130 -0
  89. package/dist/cli/run-cli/commands/core.d.ts +14 -0
  90. package/dist/cli/run-cli/commands/core.d.ts.map +1 -0
  91. package/dist/cli/run-cli/commands/core.js +144 -0
  92. package/dist/cli/run-cli/commands/ide.d.ts +13 -0
  93. package/dist/cli/run-cli/commands/ide.d.ts.map +1 -0
  94. package/dist/cli/run-cli/commands/ide.js +67 -0
  95. package/dist/cli/run-cli/commands/init/base-branch.d.ts +9 -0
  96. package/dist/cli/run-cli/commands/init/base-branch.d.ts.map +1 -0
  97. package/dist/cli/run-cli/commands/init/base-branch.js +11 -0
  98. package/dist/cli/run-cli/commands/init/conflicts.d.ts +11 -0
  99. package/dist/cli/run-cli/commands/init/conflicts.d.ts.map +1 -0
  100. package/dist/cli/run-cli/commands/init/conflicts.js +42 -0
  101. package/dist/cli/run-cli/commands/init/git.d.ts +8 -0
  102. package/dist/cli/run-cli/commands/init/git.d.ts.map +1 -0
  103. package/dist/cli/run-cli/commands/init/git.js +12 -0
  104. package/dist/cli/run-cli/commands/init/ide-sync.d.ts +9 -0
  105. package/dist/cli/run-cli/commands/init/ide-sync.d.ts.map +1 -0
  106. package/dist/cli/run-cli/commands/init/ide-sync.js +18 -0
  107. package/dist/cli/run-cli/commands/init/recipes.d.ts +2 -0
  108. package/dist/cli/run-cli/commands/init/recipes.d.ts.map +1 -0
  109. package/dist/cli/run-cli/commands/init/recipes.js +11 -0
  110. package/dist/cli/run-cli/commands/init/write-agents.d.ts +11 -0
  111. package/dist/cli/run-cli/commands/init/write-agents.d.ts.map +1 -0
  112. package/dist/cli/run-cli/commands/init/write-agents.js +30 -0
  113. package/dist/cli/run-cli/commands/init/write-config.d.ts +15 -0
  114. package/dist/cli/run-cli/commands/init/write-config.d.ts.map +1 -0
  115. package/dist/cli/run-cli/commands/init/write-config.js +45 -0
  116. package/dist/cli/run-cli/commands/init.d.ts +21 -0
  117. package/dist/cli/run-cli/commands/init.d.ts.map +1 -0
  118. package/dist/cli/run-cli/commands/init.js +332 -0
  119. package/dist/cli/run-cli/registry.run.d.ts +4 -0
  120. package/dist/cli/run-cli/registry.run.d.ts.map +1 -0
  121. package/dist/cli/run-cli/registry.run.js +19 -0
  122. package/dist/cli/run-cli.d.ts.map +1 -1
  123. package/dist/cli/run-cli.js +182 -2463
  124. package/dist/cli/spec/docs-render.d.ts +3 -0
  125. package/dist/cli/spec/docs-render.d.ts.map +1 -0
  126. package/dist/cli/spec/docs-render.js +118 -0
  127. package/dist/cli/spec/errors.d.ts +9 -0
  128. package/dist/cli/spec/errors.d.ts.map +1 -0
  129. package/dist/cli/spec/errors.js +18 -0
  130. package/dist/cli/spec/help-render.d.ts +43 -0
  131. package/dist/cli/spec/help-render.d.ts.map +1 -0
  132. package/dist/cli/spec/help-render.js +185 -0
  133. package/dist/cli/spec/help.d.ts +10 -0
  134. package/dist/cli/spec/help.d.ts.map +1 -0
  135. package/dist/cli/spec/help.js +64 -0
  136. package/dist/cli/spec/parse.d.ts +8 -0
  137. package/dist/cli/spec/parse.d.ts.map +1 -0
  138. package/dist/cli/spec/parse.js +188 -0
  139. package/dist/cli/spec/registry.d.ts +12 -0
  140. package/dist/cli/spec/registry.d.ts.map +1 -0
  141. package/dist/cli/spec/registry.js +47 -0
  142. package/dist/cli/spec/spec.d.ts +76 -0
  143. package/dist/cli/spec/spec.d.ts.map +1 -0
  144. package/dist/cli/spec/spec.js +1 -0
  145. package/dist/cli/spec/suggest.d.ts +2 -0
  146. package/dist/cli/spec/suggest.d.ts.map +1 -0
  147. package/dist/cli/spec/suggest.js +45 -0
  148. package/dist/commands/backend/sync.command.d.ts +12 -0
  149. package/dist/commands/backend/sync.command.d.ts.map +1 -0
  150. package/dist/commands/backend/sync.command.js +79 -0
  151. package/dist/commands/backend.d.ts +21 -8
  152. package/dist/commands/backend.d.ts.map +1 -1
  153. package/dist/commands/backend.js +28 -165
  154. package/dist/commands/block.command.d.ts +19 -0
  155. package/dist/commands/block.command.d.ts.map +1 -0
  156. package/dist/commands/block.command.js +143 -0
  157. package/dist/commands/branch/base.command.d.ts +20 -0
  158. package/dist/commands/branch/base.command.d.ts.map +1 -0
  159. package/dist/commands/branch/base.command.js +110 -0
  160. package/dist/commands/branch/base.d.ts +19 -0
  161. package/dist/commands/branch/base.d.ts.map +1 -0
  162. package/dist/commands/branch/base.js +114 -0
  163. package/dist/commands/branch/cleanup-merged.d.ts +11 -0
  164. package/dist/commands/branch/cleanup-merged.d.ts.map +1 -0
  165. package/dist/commands/branch/cleanup-merged.js +141 -0
  166. package/dist/commands/branch/index.d.ts +6 -59
  167. package/dist/commands/branch/index.d.ts.map +1 -1
  168. package/dist/commands/branch/index.js +6 -513
  169. package/dist/commands/branch/internal/archive-pr.d.ts +2 -0
  170. package/dist/commands/branch/internal/archive-pr.d.ts.map +1 -0
  171. package/dist/commands/branch/internal/archive-pr.js +17 -0
  172. package/dist/commands/branch/internal/work-validate.d.ts +3 -0
  173. package/dist/commands/branch/internal/work-validate.d.ts.map +1 -0
  174. package/dist/commands/branch/internal/work-validate.js +27 -0
  175. package/dist/commands/branch/remove.command.d.ts +10 -0
  176. package/dist/commands/branch/remove.command.d.ts.map +1 -0
  177. package/dist/commands/branch/remove.command.js +63 -0
  178. package/dist/commands/branch/remove.d.ts +9 -0
  179. package/dist/commands/branch/remove.d.ts.map +1 -0
  180. package/dist/commands/branch/remove.js +65 -0
  181. package/dist/commands/branch/status.command.d.ts +8 -0
  182. package/dist/commands/branch/status.command.d.ts.map +1 -0
  183. package/dist/commands/branch/status.command.js +36 -0
  184. package/dist/commands/branch/status.d.ts +7 -0
  185. package/dist/commands/branch/status.d.ts.map +1 -0
  186. package/dist/commands/branch/status.js +60 -0
  187. package/dist/commands/branch/work-start.command.d.ts +11 -0
  188. package/dist/commands/branch/work-start.command.d.ts.map +1 -0
  189. package/dist/commands/branch/work-start.command.js +80 -0
  190. package/dist/commands/branch/work-start.d.ts +11 -0
  191. package/dist/commands/branch/work-start.d.ts.map +1 -0
  192. package/dist/commands/branch/work-start.js +120 -0
  193. package/dist/commands/cleanup/merged.command.d.ts +17 -0
  194. package/dist/commands/cleanup/merged.command.d.ts.map +1 -0
  195. package/dist/commands/cleanup/merged.command.js +75 -0
  196. package/dist/commands/commit.command.d.ts +6 -0
  197. package/dist/commands/commit.command.d.ts.map +1 -0
  198. package/dist/commands/commit.command.js +24 -0
  199. package/dist/commands/commit.spec.d.ts +18 -0
  200. package/dist/commands/commit.spec.d.ts.map +1 -0
  201. package/dist/commands/commit.spec.js +119 -0
  202. package/dist/commands/docs/cli.command.d.ts +9 -0
  203. package/dist/commands/docs/cli.command.d.ts.map +1 -0
  204. package/dist/commands/docs/cli.command.js +51 -0
  205. package/dist/commands/finish.command.d.ts +28 -0
  206. package/dist/commands/finish.command.d.ts.map +1 -0
  207. package/dist/commands/finish.command.js +237 -0
  208. package/dist/commands/guard/clean.command.d.ts +7 -0
  209. package/dist/commands/guard/clean.command.d.ts.map +1 -0
  210. package/dist/commands/guard/clean.command.js +14 -0
  211. package/dist/commands/guard/commit.command.d.ts +19 -0
  212. package/dist/commands/guard/commit.command.d.ts.map +1 -0
  213. package/dist/commands/guard/commit.command.js +132 -0
  214. package/dist/commands/guard/guard.command.d.ts +5 -0
  215. package/dist/commands/guard/guard.command.d.ts.map +1 -0
  216. package/dist/commands/guard/guard.command.js +21 -0
  217. package/dist/commands/guard/impl/allow.d.ts +18 -0
  218. package/dist/commands/guard/impl/allow.d.ts.map +1 -0
  219. package/dist/commands/guard/impl/allow.js +77 -0
  220. package/dist/commands/guard/impl/close-message.d.ts +16 -0
  221. package/dist/commands/guard/impl/close-message.d.ts.map +1 -0
  222. package/dist/commands/guard/impl/close-message.js +156 -0
  223. package/dist/commands/guard/impl/commands.d.ts +32 -0
  224. package/dist/commands/guard/impl/commands.d.ts.map +1 -0
  225. package/dist/commands/guard/impl/commands.js +191 -0
  226. package/dist/commands/guard/impl/comment-commit.d.ts +25 -0
  227. package/dist/commands/guard/impl/comment-commit.d.ts.map +1 -0
  228. package/dist/commands/guard/impl/comment-commit.js +137 -0
  229. package/dist/commands/guard/impl/env.d.ts +10 -0
  230. package/dist/commands/guard/impl/env.d.ts.map +1 -0
  231. package/dist/commands/guard/impl/env.js +12 -0
  232. package/dist/commands/guard/impl/policy.d.ts +19 -0
  233. package/dist/commands/guard/impl/policy.d.ts.map +1 -0
  234. package/dist/commands/guard/impl/policy.js +46 -0
  235. package/dist/commands/guard/index.d.ts +4 -87
  236. package/dist/commands/guard/index.d.ts.map +1 -1
  237. package/dist/commands/guard/index.js +4 -481
  238. package/dist/commands/guard/suggest-allow.command.d.ts +7 -0
  239. package/dist/commands/guard/suggest-allow.command.d.ts.map +1 -0
  240. package/dist/commands/guard/suggest-allow.command.js +28 -0
  241. package/dist/commands/hooks/hooks.command.d.ts +5 -0
  242. package/dist/commands/hooks/hooks.command.d.ts.map +1 -0
  243. package/dist/commands/hooks/hooks.command.js +18 -0
  244. package/dist/commands/hooks/index.d.ts.map +1 -1
  245. package/dist/commands/hooks/index.js +36 -81
  246. package/dist/commands/hooks/install.command.d.ts +7 -0
  247. package/dist/commands/hooks/install.command.d.ts.map +1 -0
  248. package/dist/commands/hooks/install.command.js +14 -0
  249. package/dist/commands/hooks/run.command.d.ts +9 -0
  250. package/dist/commands/hooks/run.command.d.ts.map +1 -0
  251. package/dist/commands/hooks/run.command.js +39 -0
  252. package/dist/commands/hooks/uninstall.command.d.ts +7 -0
  253. package/dist/commands/hooks/uninstall.command.d.ts.map +1 -0
  254. package/dist/commands/hooks/uninstall.command.js +16 -0
  255. package/dist/commands/integrate.command.d.ts +14 -0
  256. package/dist/commands/integrate.command.d.ts.map +1 -0
  257. package/dist/commands/integrate.command.js +61 -0
  258. package/dist/commands/pr/check.d.ts +8 -0
  259. package/dist/commands/pr/check.d.ts.map +1 -0
  260. package/dist/commands/pr/check.js +78 -0
  261. package/dist/commands/pr/index.d.ts +5 -45
  262. package/dist/commands/pr/index.d.ts.map +1 -1
  263. package/dist/commands/pr/index.js +5 -857
  264. package/dist/commands/pr/integrate/artifacts.d.ts +14 -0
  265. package/dist/commands/pr/integrate/artifacts.d.ts.map +1 -0
  266. package/dist/commands/pr/integrate/artifacts.js +45 -0
  267. package/dist/commands/pr/integrate/cmd.d.ts +14 -0
  268. package/dist/commands/pr/integrate/cmd.d.ts.map +1 -0
  269. package/dist/commands/pr/integrate/cmd.js +150 -0
  270. package/dist/commands/pr/integrate/internal/finalize.d.ts +25 -0
  271. package/dist/commands/pr/integrate/internal/finalize.d.ts.map +1 -0
  272. package/dist/commands/pr/integrate/internal/finalize.js +86 -0
  273. package/dist/commands/pr/integrate/internal/merge.d.ts +40 -0
  274. package/dist/commands/pr/integrate/internal/merge.d.ts.map +1 -0
  275. package/dist/commands/pr/integrate/internal/merge.js +138 -0
  276. package/dist/commands/pr/integrate/internal/prepare.d.ts +33 -0
  277. package/dist/commands/pr/integrate/internal/prepare.d.ts.map +1 -0
  278. package/dist/commands/pr/integrate/internal/prepare.js +142 -0
  279. package/dist/commands/pr/integrate/internal/worktree.d.ts +14 -0
  280. package/dist/commands/pr/integrate/internal/worktree.d.ts.map +1 -0
  281. package/dist/commands/pr/integrate/internal/worktree.js +51 -0
  282. package/dist/commands/pr/integrate/verify.d.ts +22 -0
  283. package/dist/commands/pr/integrate/verify.d.ts.map +1 -0
  284. package/dist/commands/pr/integrate/verify.js +60 -0
  285. package/dist/commands/pr/integrate.d.ts +2 -0
  286. package/dist/commands/pr/integrate.d.ts.map +1 -0
  287. package/dist/commands/pr/integrate.js +1 -0
  288. package/dist/commands/pr/internal/pr-paths.d.ts +29 -0
  289. package/dist/commands/pr/internal/pr-paths.d.ts.map +1 -0
  290. package/dist/commands/pr/internal/pr-paths.js +38 -0
  291. package/dist/commands/pr/internal/review-template.d.ts +9 -0
  292. package/dist/commands/pr/internal/review-template.d.ts.map +1 -0
  293. package/dist/commands/pr/internal/review-template.js +62 -0
  294. package/dist/commands/pr/note.d.ts +10 -0
  295. package/dist/commands/pr/note.d.ts.map +1 -0
  296. package/dist/commands/pr/note.js +50 -0
  297. package/dist/commands/pr/open.d.ts +10 -0
  298. package/dist/commands/pr/open.d.ts.map +1 -0
  299. package/dist/commands/pr/open.js +80 -0
  300. package/dist/commands/pr/pr.command.d.ts +33 -0
  301. package/dist/commands/pr/pr.command.d.ts.map +1 -0
  302. package/dist/commands/pr/pr.command.js +172 -0
  303. package/dist/commands/pr/update.d.ts +8 -0
  304. package/dist/commands/pr/update.d.ts.map +1 -0
  305. package/dist/commands/pr/update.js +103 -0
  306. package/dist/commands/ready.command.d.ts +8 -0
  307. package/dist/commands/ready.command.d.ts.map +1 -0
  308. package/dist/commands/ready.command.js +28 -0
  309. package/dist/commands/recipes/cache-prune.command.d.ts +6 -0
  310. package/dist/commands/recipes/cache-prune.command.d.ts.map +1 -0
  311. package/dist/commands/recipes/cache-prune.command.js +30 -0
  312. package/dist/commands/recipes/cache.command.d.ts +6 -0
  313. package/dist/commands/recipes/cache.command.d.ts.map +1 -0
  314. package/dist/commands/recipes/cache.command.js +37 -0
  315. package/dist/commands/recipes/explain.command.d.ts +7 -0
  316. package/dist/commands/recipes/explain.command.d.ts.map +1 -0
  317. package/dist/commands/recipes/explain.command.js +10 -0
  318. package/dist/commands/recipes/impl/apply.d.ts +16 -0
  319. package/dist/commands/recipes/impl/apply.d.ts.map +1 -0
  320. package/dist/commands/recipes/impl/apply.js +97 -0
  321. package/dist/commands/recipes/impl/archive.d.ts +2 -0
  322. package/dist/commands/recipes/impl/archive.d.ts.map +1 -0
  323. package/dist/commands/recipes/impl/archive.js +19 -0
  324. package/dist/commands/recipes/impl/commands/cache-prune.d.ts +7 -0
  325. package/dist/commands/recipes/impl/commands/cache-prune.d.ts.map +1 -0
  326. package/dist/commands/recipes/impl/commands/cache-prune.js +94 -0
  327. package/dist/commands/recipes/impl/commands/explain.d.ts +6 -0
  328. package/dist/commands/recipes/impl/commands/explain.d.ts.map +1 -0
  329. package/dist/commands/recipes/impl/commands/explain.js +88 -0
  330. package/dist/commands/recipes/impl/commands/info.d.ts +6 -0
  331. package/dist/commands/recipes/impl/commands/info.d.ts.map +1 -0
  332. package/dist/commands/recipes/impl/commands/info.js +58 -0
  333. package/dist/commands/recipes/impl/commands/install.d.ts +11 -0
  334. package/dist/commands/recipes/impl/commands/install.d.ts.map +1 -0
  335. package/dist/commands/recipes/impl/commands/install.js +212 -0
  336. package/dist/commands/recipes/impl/commands/list-remote.d.ts +7 -0
  337. package/dist/commands/recipes/impl/commands/list-remote.d.ts.map +1 -0
  338. package/dist/commands/recipes/impl/commands/list-remote.js +53 -0
  339. package/dist/commands/recipes/impl/commands/list.d.ts +7 -0
  340. package/dist/commands/recipes/impl/commands/list.d.ts.map +1 -0
  341. package/dist/commands/recipes/impl/commands/list.js +38 -0
  342. package/dist/commands/recipes/impl/commands/remove.d.ts +6 -0
  343. package/dist/commands/recipes/impl/commands/remove.d.ts.map +1 -0
  344. package/dist/commands/recipes/impl/commands/remove.js +35 -0
  345. package/dist/commands/recipes/impl/commands.d.ts +8 -0
  346. package/dist/commands/recipes/impl/commands.d.ts.map +1 -0
  347. package/dist/commands/recipes/impl/commands.js +7 -0
  348. package/dist/commands/recipes/impl/constants.d.ts +13 -0
  349. package/dist/commands/recipes/impl/constants.d.ts.map +1 -0
  350. package/dist/commands/recipes/impl/constants.js +16 -0
  351. package/dist/commands/recipes/impl/format.d.ts +2 -0
  352. package/dist/commands/recipes/impl/format.d.ts.map +1 -0
  353. package/dist/commands/recipes/impl/format.js +9 -0
  354. package/dist/commands/recipes/impl/index.d.ts +12 -0
  355. package/dist/commands/recipes/impl/index.d.ts.map +1 -0
  356. package/dist/commands/recipes/impl/index.js +150 -0
  357. package/dist/commands/recipes/impl/installed-recipes.d.ts +4 -0
  358. package/dist/commands/recipes/impl/installed-recipes.d.ts.map +1 -0
  359. package/dist/commands/recipes/impl/installed-recipes.js +58 -0
  360. package/dist/commands/recipes/impl/manifest.d.ts +4 -0
  361. package/dist/commands/recipes/impl/manifest.d.ts.map +1 -0
  362. package/dist/commands/recipes/impl/manifest.js +43 -0
  363. package/dist/commands/recipes/impl/normalize.d.ts +5 -0
  364. package/dist/commands/recipes/impl/normalize.d.ts.map +1 -0
  365. package/dist/commands/recipes/impl/normalize.js +50 -0
  366. package/dist/commands/recipes/impl/paths.d.ts +13 -0
  367. package/dist/commands/recipes/impl/paths.d.ts.map +1 -0
  368. package/dist/commands/recipes/impl/paths.js +27 -0
  369. package/dist/commands/recipes/impl/project.d.ts +8 -0
  370. package/dist/commands/recipes/impl/project.d.ts.map +1 -0
  371. package/dist/commands/recipes/impl/project.js +23 -0
  372. package/dist/commands/recipes/impl/scenario.d.ts +16 -0
  373. package/dist/commands/recipes/impl/scenario.d.ts.map +1 -0
  374. package/dist/commands/recipes/impl/scenario.js +128 -0
  375. package/dist/commands/recipes/impl/types.d.ts +107 -0
  376. package/dist/commands/recipes/impl/types.d.ts.map +1 -0
  377. package/dist/commands/recipes/impl/types.js +1 -0
  378. package/dist/commands/recipes/info.command.d.ts +7 -0
  379. package/dist/commands/recipes/info.command.d.ts.map +1 -0
  380. package/dist/commands/recipes/info.command.js +10 -0
  381. package/dist/commands/recipes/install.command.d.ts +12 -0
  382. package/dist/commands/recipes/install.command.d.ts.map +1 -0
  383. package/dist/commands/recipes/install.command.js +161 -0
  384. package/dist/commands/recipes/list-remote.command.d.ts +6 -0
  385. package/dist/commands/recipes/list-remote.command.d.ts.map +1 -0
  386. package/dist/commands/recipes/list-remote.command.js +46 -0
  387. package/dist/commands/recipes/list.command.d.ts +6 -0
  388. package/dist/commands/recipes/list.command.d.ts.map +1 -0
  389. package/dist/commands/recipes/list.command.js +39 -0
  390. package/dist/commands/recipes/recipes.command.d.ts +6 -0
  391. package/dist/commands/recipes/recipes.command.d.ts.map +1 -0
  392. package/dist/commands/recipes/recipes.command.js +45 -0
  393. package/dist/commands/recipes/remove.command.d.ts +7 -0
  394. package/dist/commands/recipes/remove.command.d.ts.map +1 -0
  395. package/dist/commands/recipes/remove.command.js +10 -0
  396. package/dist/commands/recipes.d.ts +7 -81
  397. package/dist/commands/recipes.d.ts.map +1 -1
  398. package/dist/commands/recipes.js +6 -1457
  399. package/dist/commands/scenario/impl/commands.d.ts +19 -0
  400. package/dist/commands/scenario/impl/commands.d.ts.map +1 -0
  401. package/dist/commands/scenario/impl/commands.js +336 -0
  402. package/dist/commands/scenario/impl/report.d.ts +30 -0
  403. package/dist/commands/scenario/impl/report.d.ts.map +1 -0
  404. package/dist/commands/scenario/impl/report.js +99 -0
  405. package/dist/commands/scenario/info.command.d.ts +8 -0
  406. package/dist/commands/scenario/info.command.d.ts.map +1 -0
  407. package/dist/commands/scenario/info.command.js +27 -0
  408. package/dist/commands/scenario/list.command.d.ts +5 -0
  409. package/dist/commands/scenario/list.command.d.ts.map +1 -0
  410. package/dist/commands/scenario/list.command.js +9 -0
  411. package/dist/commands/scenario/run.command.d.ts +8 -0
  412. package/dist/commands/scenario/run.command.d.ts.map +1 -0
  413. package/dist/commands/scenario/run.command.js +27 -0
  414. package/dist/commands/scenario/scenario.command.d.ts +6 -0
  415. package/dist/commands/scenario/scenario.command.d.ts.map +1 -0
  416. package/dist/commands/scenario/scenario.command.js +37 -0
  417. package/dist/commands/scenario.d.ts +1 -6
  418. package/dist/commands/scenario.d.ts.map +1 -1
  419. package/dist/commands/scenario.js +1 -501
  420. package/dist/commands/shared/git-context.d.ts +23 -0
  421. package/dist/commands/shared/git-context.d.ts.map +1 -0
  422. package/dist/commands/shared/git-context.js +140 -0
  423. package/dist/commands/shared/policy-deny.d.ts +3 -0
  424. package/dist/commands/shared/policy-deny.d.ts.map +1 -0
  425. package/dist/commands/shared/policy-deny.js +12 -0
  426. package/dist/commands/shared/task-backend.d.ts +17 -5
  427. package/dist/commands/shared/task-backend.d.ts.map +1 -1
  428. package/dist/commands/shared/task-backend.js +34 -5
  429. package/dist/commands/shared/task-store.d.ts +16 -0
  430. package/dist/commands/shared/task-store.d.ts.map +1 -0
  431. package/dist/commands/shared/task-store.js +142 -0
  432. package/dist/commands/start.command.d.ts +19 -0
  433. package/dist/commands/start.command.d.ts.map +1 -0
  434. package/dist/commands/start.command.js +143 -0
  435. package/dist/commands/sync.command.d.ts +6 -0
  436. package/dist/commands/sync.command.d.ts.map +1 -0
  437. package/dist/commands/sync.command.js +57 -0
  438. package/dist/commands/task/add.command.d.ts +18 -0
  439. package/dist/commands/task/add.command.d.ts.map +1 -0
  440. package/dist/commands/task/add.command.js +157 -0
  441. package/dist/commands/task/add.d.ts +13 -3
  442. package/dist/commands/task/add.d.ts.map +1 -1
  443. package/dist/commands/task/add.js +21 -126
  444. package/dist/commands/task/block.d.ts +2 -2
  445. package/dist/commands/task/block.d.ts.map +1 -1
  446. package/dist/commands/task/block.js +13 -9
  447. package/dist/commands/task/comment.command.d.ts +10 -0
  448. package/dist/commands/task/comment.command.d.ts.map +1 -0
  449. package/dist/commands/task/comment.command.js +57 -0
  450. package/dist/commands/task/comment.d.ts +2 -0
  451. package/dist/commands/task/comment.d.ts.map +1 -1
  452. package/dist/commands/task/comment.js +10 -7
  453. package/dist/commands/task/derive.command.d.ts +13 -0
  454. package/dist/commands/task/derive.command.d.ts.map +1 -0
  455. package/dist/commands/task/derive.command.js +94 -0
  456. package/dist/commands/task/derive.d.ts +13 -0
  457. package/dist/commands/task/derive.d.ts.map +1 -0
  458. package/dist/commands/task/derive.js +71 -0
  459. package/dist/commands/task/doc-set.command.d.ts +12 -0
  460. package/dist/commands/task/doc-set.command.d.ts.map +1 -0
  461. package/dist/commands/task/doc-set.command.js +82 -0
  462. package/dist/commands/task/doc-show.command.d.ts +10 -0
  463. package/dist/commands/task/doc-show.command.d.ts.map +1 -0
  464. package/dist/commands/task/doc-show.command.js +54 -0
  465. package/dist/commands/task/doc.command.d.ts +7 -0
  466. package/dist/commands/task/doc.command.d.ts.map +1 -0
  467. package/dist/commands/task/doc.command.js +22 -0
  468. package/dist/commands/task/doc.d.ts +9 -6
  469. package/dist/commands/task/doc.d.ts.map +1 -1
  470. package/dist/commands/task/doc.js +61 -113
  471. package/dist/commands/task/export.command.d.ts +6 -0
  472. package/dist/commands/task/export.command.d.ts.map +1 -0
  473. package/dist/commands/task/export.command.js +17 -0
  474. package/dist/commands/task/export.d.ts +2 -0
  475. package/dist/commands/task/export.d.ts.map +1 -1
  476. package/dist/commands/task/export.js +7 -9
  477. package/dist/commands/task/finish.d.ts +5 -4
  478. package/dist/commands/task/finish.d.ts.map +1 -1
  479. package/dist/commands/task/finish.js +50 -17
  480. package/dist/commands/task/index.d.ts +14 -13
  481. package/dist/commands/task/index.d.ts.map +1 -1
  482. package/dist/commands/task/index.js +13 -13
  483. package/dist/commands/task/lint.command.d.ts +5 -0
  484. package/dist/commands/task/lint.command.d.ts.map +1 -0
  485. package/dist/commands/task/lint.command.js +11 -0
  486. package/dist/commands/task/list.command.d.ts +9 -0
  487. package/dist/commands/task/list.command.d.ts.map +1 -0
  488. package/dist/commands/task/list.command.js +68 -0
  489. package/dist/commands/task/list.d.ts +6 -2
  490. package/dist/commands/task/list.d.ts.map +1 -1
  491. package/dist/commands/task/list.js +12 -15
  492. package/dist/commands/task/migrate-doc.command.d.ts +9 -0
  493. package/dist/commands/task/migrate-doc.command.d.ts.map +1 -0
  494. package/dist/commands/task/migrate-doc.command.js +65 -0
  495. package/dist/commands/task/migrate-doc.d.ts +3 -3
  496. package/dist/commands/task/migrate-doc.d.ts.map +1 -1
  497. package/dist/commands/task/migrate-doc.js +40 -47
  498. package/dist/commands/task/migrate.command.d.ts +10 -0
  499. package/dist/commands/task/migrate.command.d.ts.map +1 -0
  500. package/dist/commands/task/migrate.command.js +50 -0
  501. package/dist/commands/task/migrate.d.ts +5 -1
  502. package/dist/commands/task/migrate.d.ts.map +1 -1
  503. package/dist/commands/task/migrate.js +10 -44
  504. package/dist/commands/task/new.command.d.ts +6 -0
  505. package/dist/commands/task/new.command.d.ts.map +1 -0
  506. package/dist/commands/task/new.command.js +13 -0
  507. package/dist/commands/task/new.d.ts +13 -4
  508. package/dist/commands/task/new.d.ts.map +1 -1
  509. package/dist/commands/task/new.js +30 -92
  510. package/dist/commands/task/new.spec.d.ts +4 -0
  511. package/dist/commands/task/new.spec.d.ts.map +1 -0
  512. package/dist/commands/task/new.spec.js +79 -0
  513. package/dist/commands/task/next.command.d.ts +9 -0
  514. package/dist/commands/task/next.command.d.ts.map +1 -0
  515. package/dist/commands/task/next.command.js +89 -0
  516. package/dist/commands/task/next.d.ts +4 -1
  517. package/dist/commands/task/next.d.ts.map +1 -1
  518. package/dist/commands/task/next.js +15 -16
  519. package/dist/commands/task/normalize.command.d.ts +9 -0
  520. package/dist/commands/task/normalize.command.d.ts.map +1 -0
  521. package/dist/commands/task/normalize.command.js +39 -0
  522. package/dist/commands/task/normalize.d.ts +4 -1
  523. package/dist/commands/task/normalize.d.ts.map +1 -1
  524. package/dist/commands/task/normalize.js +18 -31
  525. package/dist/commands/task/plan-approve.command.d.ts +10 -0
  526. package/dist/commands/task/plan-approve.command.d.ts.map +1 -0
  527. package/dist/commands/task/plan-approve.command.js +54 -0
  528. package/dist/commands/task/plan-reject.command.d.ts +10 -0
  529. package/dist/commands/task/plan-reject.command.d.ts.map +1 -0
  530. package/dist/commands/task/plan-reject.command.js +59 -0
  531. package/dist/commands/task/plan-set.command.d.ts +11 -0
  532. package/dist/commands/task/plan-set.command.d.ts.map +1 -0
  533. package/dist/commands/task/plan-set.command.js +76 -0
  534. package/dist/commands/task/plan.d.ts +23 -10
  535. package/dist/commands/task/plan.d.ts.map +1 -1
  536. package/dist/commands/task/plan.js +182 -177
  537. package/dist/commands/task/ready.d.ts +2 -0
  538. package/dist/commands/task/ready.d.ts.map +1 -1
  539. package/dist/commands/task/ready.js +4 -6
  540. package/dist/commands/task/scaffold.command.d.ts +12 -0
  541. package/dist/commands/task/scaffold.command.d.ts.map +1 -0
  542. package/dist/commands/task/scaffold.command.js +73 -0
  543. package/dist/commands/task/scaffold.d.ts +7 -3
  544. package/dist/commands/task/scaffold.d.ts.map +1 -1
  545. package/dist/commands/task/scaffold.js +57 -67
  546. package/dist/commands/task/scrub.command.d.ts +11 -0
  547. package/dist/commands/task/scrub.command.d.ts.map +1 -0
  548. package/dist/commands/task/scrub.command.js +72 -0
  549. package/dist/commands/task/scrub.d.ts +6 -3
  550. package/dist/commands/task/scrub.d.ts.map +1 -1
  551. package/dist/commands/task/scrub.js +12 -68
  552. package/dist/commands/task/search.command.d.ts +11 -0
  553. package/dist/commands/task/search.command.d.ts.map +1 -0
  554. package/dist/commands/task/search.command.js +101 -0
  555. package/dist/commands/task/search.d.ts +5 -1
  556. package/dist/commands/task/search.d.ts.map +1 -1
  557. package/dist/commands/task/search.js +14 -23
  558. package/dist/commands/task/set-status.command.d.ts +21 -0
  559. package/dist/commands/task/set-status.command.d.ts.map +1 -0
  560. package/dist/commands/task/set-status.command.js +171 -0
  561. package/dist/commands/task/set-status.d.ts +2 -0
  562. package/dist/commands/task/set-status.d.ts.map +1 -1
  563. package/dist/commands/task/set-status.js +14 -8
  564. package/dist/commands/task/shared.d.ts +5 -0
  565. package/dist/commands/task/shared.d.ts.map +1 -1
  566. package/dist/commands/task/shared.js +50 -0
  567. package/dist/commands/task/show.command.d.ts +8 -0
  568. package/dist/commands/task/show.command.d.ts.map +1 -0
  569. package/dist/commands/task/show.command.js +19 -0
  570. package/dist/commands/task/show.d.ts +2 -0
  571. package/dist/commands/task/show.d.ts.map +1 -1
  572. package/dist/commands/task/show.js +5 -7
  573. package/dist/commands/task/start.d.ts +2 -2
  574. package/dist/commands/task/start.d.ts.map +1 -1
  575. package/dist/commands/task/start.js +48 -11
  576. package/dist/commands/task/update.command.d.ts +18 -0
  577. package/dist/commands/task/update.command.d.ts.map +1 -0
  578. package/dist/commands/task/update.command.js +141 -0
  579. package/dist/commands/task/update.d.ts +13 -3
  580. package/dist/commands/task/update.d.ts.map +1 -1
  581. package/dist/commands/task/update.js +31 -122
  582. package/dist/commands/task/verify-ok.command.d.ts +13 -0
  583. package/dist/commands/task/verify-ok.command.d.ts.map +1 -0
  584. package/dist/commands/task/verify-ok.command.js +83 -0
  585. package/dist/commands/task/verify-record.d.ts +30 -8
  586. package/dist/commands/task/verify-record.d.ts.map +1 -1
  587. package/dist/commands/task/verify-record.js +107 -117
  588. package/dist/commands/task/verify-rework.command.d.ts +13 -0
  589. package/dist/commands/task/verify-rework.command.d.ts.map +1 -0
  590. package/dist/commands/task/verify-rework.command.js +83 -0
  591. package/dist/commands/task/verify-show.command.d.ts +9 -0
  592. package/dist/commands/task/verify-show.command.d.ts.map +1 -0
  593. package/dist/commands/task/verify-show.command.js +38 -0
  594. package/dist/commands/task/verify.command.d.ts +7 -0
  595. package/dist/commands/task/verify.command.d.ts.map +1 -0
  596. package/dist/commands/task/verify.command.js +20 -0
  597. package/dist/commands/upgrade.command.d.ts +6 -0
  598. package/dist/commands/upgrade.command.d.ts.map +1 -0
  599. package/dist/commands/upgrade.command.js +104 -0
  600. package/dist/commands/upgrade.d.ts +19 -2
  601. package/dist/commands/upgrade.d.ts.map +1 -1
  602. package/dist/commands/upgrade.js +281 -85
  603. package/dist/commands/verify.command.d.ts +16 -0
  604. package/dist/commands/verify.command.d.ts.map +1 -0
  605. package/dist/commands/verify.command.js +113 -0
  606. package/dist/commands/workflow.d.ts +4 -6
  607. package/dist/commands/workflow.d.ts.map +1 -1
  608. package/dist/commands/workflow.js +4 -7
  609. package/dist/meta/release.d.ts +2 -0
  610. package/dist/meta/release.d.ts.map +1 -0
  611. package/dist/meta/release.js +50 -0
  612. package/dist/policy/evaluate.d.ts +3 -0
  613. package/dist/policy/evaluate.d.ts.map +1 -0
  614. package/dist/policy/evaluate.js +27 -0
  615. package/dist/policy/result.d.ts +7 -0
  616. package/dist/policy/result.d.ts.map +1 -0
  617. package/dist/policy/result.js +21 -0
  618. package/dist/policy/rules/allowlist.d.ts +3 -0
  619. package/dist/policy/rules/allowlist.d.ts.map +1 -0
  620. package/dist/policy/rules/allowlist.js +30 -0
  621. package/dist/policy/rules/branch-pr-base.d.ts +3 -0
  622. package/dist/policy/rules/branch-pr-base.d.ts.map +1 -0
  623. package/dist/policy/rules/branch-pr-base.js +43 -0
  624. package/dist/policy/rules/clean-tree.d.ts +3 -0
  625. package/dist/policy/rules/clean-tree.d.ts.map +1 -0
  626. package/dist/policy/rules/clean-tree.js +19 -0
  627. package/dist/policy/rules/commit-subject.d.ts +3 -0
  628. package/dist/policy/rules/commit-subject.d.ts.map +1 -0
  629. package/dist/policy/rules/commit-subject.js +33 -0
  630. package/dist/policy/rules/protected-paths.d.ts +3 -0
  631. package/dist/policy/rules/protected-paths.d.ts.map +1 -0
  632. package/dist/policy/rules/protected-paths.js +53 -0
  633. package/dist/policy/types.d.ts +38 -0
  634. package/dist/policy/types.d.ts.map +1 -0
  635. package/dist/policy/types.js +1 -0
  636. package/dist/shared/write-if-changed.d.ts +3 -0
  637. package/dist/shared/write-if-changed.d.ts.map +1 -0
  638. package/dist/shared/write-if-changed.js +25 -0
  639. package/package.json +3 -3
  640. package/dist/cli/help.d.ts +0 -2
  641. package/dist/cli/help.d.ts.map +0 -1
  642. package/dist/cli/help.js +0 -127
  643. package/dist/commands/task/verify.d.ts +0 -2
  644. package/dist/commands/task/verify.d.ts.map +0 -1
  645. package/dist/commands/task/verify.js +0 -1
@@ -1,481 +1,4 @@
1
- import { extractTaskSuffix, getStagedFiles, getUnstagedFiles, loadConfig, resolveBaseBranch, resolveProject, validateCommitSubject, } from "@agentplaneorg/core";
2
- import { mapCoreError } from "../../cli/error-map.js";
3
- import { invalidValueMessage, successMessage } from "../../cli/output.js";
4
- import { CliError } from "../../shared/errors.js";
5
- import { formatCommentBodyForCommit, normalizeCommentBodyForCommit, } from "../../shared/comment-format.js";
6
- import { gitPathIsUnderPrefix, normalizeGitPathPrefix } from "../../shared/git-path.js";
7
- import { execFileAsync } from "../shared/git.js";
8
- import { gitCurrentBranch } from "../shared/git-ops.js";
9
- import { getProtectedPathOverride, protectedPathKindForFile, } from "../../shared/protected-paths.js";
10
- import { parseGitLogHashSubject } from "../../shared/git-log.js";
11
- function parseNullSeparatedPaths(stdout) {
12
- const text = Buffer.isBuffer(stdout) ? stdout.toString("utf8") : stdout;
13
- return text
14
- .split("\0")
15
- .map((entry) => entry.trim())
16
- .filter((entry) => entry.length > 0);
17
- }
18
- export function buildGitCommitEnv(opts) {
19
- return {
20
- ...process.env,
21
- AGENTPLANE_TASK_ID: opts.taskId,
22
- AGENTPLANE_ALLOW_TASKS: opts.allowTasks ? "1" : "0",
23
- AGENTPLANE_ALLOW_BASE: opts.allowBase ? "1" : "0",
24
- AGENTPLANE_ALLOW_POLICY: opts.allowPolicy ? "1" : "0",
25
- AGENTPLANE_ALLOW_CONFIG: opts.allowConfig ? "1" : "0",
26
- AGENTPLANE_ALLOW_HOOKS: opts.allowHooks ? "1" : "0",
27
- AGENTPLANE_ALLOW_CI: opts.allowCI ? "1" : "0",
28
- };
29
- }
30
- export function suggestAllowPrefixes(paths) {
31
- const out = new Set();
32
- for (const filePath of paths) {
33
- if (!filePath)
34
- continue;
35
- const idx = filePath.lastIndexOf("/");
36
- if (idx <= 0)
37
- out.add(filePath);
38
- else
39
- out.add(filePath.slice(0, idx));
40
- }
41
- return [...out].toSorted((a, b) => a.localeCompare(b));
42
- }
43
- export const GUARD_COMMIT_USAGE = "Usage: agentplane guard commit <task-id> -m <message> --allow <path> [--allow <path>...] [--auto-allow] [--allow-tasks] [--allow-base] [--allow-policy] [--allow-config] [--allow-hooks] [--allow-ci] [--require-clean] [--quiet]";
44
- export const GUARD_COMMIT_USAGE_EXAMPLE = 'agentplane guard commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard" --allow packages/agentplane';
45
- export const COMMIT_USAGE = "Usage: agentplane commit <task-id> -m <message>";
46
- export const COMMIT_USAGE_EXAMPLE = 'agentplane commit 202602030608-F1Q8AB -m "✨ F1Q8AB task: implement allowlist guard"';
47
- async function guardCommitCheck(opts) {
48
- const resolved = await resolveProject({
49
- cwd: opts.cwd,
50
- rootOverride: opts.rootOverride ?? null,
51
- });
52
- const loaded = await loadConfig(resolved.agentplaneDir);
53
- const policy = validateCommitSubject({
54
- subject: opts.message,
55
- taskId: opts.taskId,
56
- genericTokens: loaded.config.commit.generic_tokens,
57
- });
58
- if (!policy.ok) {
59
- throw new CliError({ exitCode: 5, code: "E_GIT", message: policy.errors.join("\n") });
60
- }
61
- const staged = await getStagedFiles({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
62
- if (staged.length === 0) {
63
- throw new CliError({
64
- exitCode: 5,
65
- code: "E_GIT",
66
- message: "No staged files (git index empty)",
67
- });
68
- }
69
- if (opts.allow.length === 0) {
70
- throw new CliError({
71
- exitCode: 5,
72
- code: "E_GIT",
73
- message: "Provide at least one --allow <path> prefix",
74
- });
75
- }
76
- const allow = opts.allow.map((prefix) => normalizeGitPathPrefix(prefix));
77
- const tasksPath = loaded.config.paths.tasks_path;
78
- if (opts.requireClean) {
79
- const unstaged = await getUnstagedFiles({
80
- cwd: opts.cwd,
81
- rootOverride: opts.rootOverride ?? null,
82
- });
83
- if (unstaged.length > 0) {
84
- throw new CliError({ exitCode: 5, code: "E_GIT", message: "Working tree is dirty" });
85
- }
86
- }
87
- if (loaded.config.workflow_mode === "branch_pr") {
88
- const baseBranch = await resolveBaseBranch({
89
- cwd: opts.cwd,
90
- rootOverride: opts.rootOverride ?? null,
91
- cliBaseOpt: null,
92
- mode: loaded.config.workflow_mode,
93
- });
94
- if (!baseBranch) {
95
- throw new CliError({
96
- exitCode: 2,
97
- code: "E_USAGE",
98
- message: "Base branch could not be resolved (use `agentplane branch base set`).",
99
- });
100
- }
101
- const currentBranch = await gitCurrentBranch(resolved.gitRoot);
102
- const tasksStaged = staged.includes(tasksPath);
103
- const nonTasks = staged.filter((entry) => entry !== tasksPath);
104
- if (tasksStaged && currentBranch !== baseBranch) {
105
- throw new CliError({
106
- exitCode: 5,
107
- code: "E_GIT",
108
- message: `${tasksPath} commits are allowed only on ${baseBranch} in branch_pr mode`,
109
- });
110
- }
111
- if (nonTasks.length > 0 && currentBranch === baseBranch && !opts.allowBase) {
112
- throw new CliError({
113
- exitCode: 5,
114
- code: "E_GIT",
115
- message: `Code commits are forbidden on ${baseBranch} in branch_pr mode`,
116
- });
117
- }
118
- }
119
- for (const filePath of staged) {
120
- const kind = protectedPathKindForFile({ filePath, tasksPath });
121
- if (kind === "tasks" && !opts.allowTasks) {
122
- throw new CliError({
123
- exitCode: 5,
124
- code: "E_GIT",
125
- message: `Staged file is forbidden by default: ${filePath} (use --allow-tasks to override)`,
126
- });
127
- }
128
- if (kind && kind !== "tasks") {
129
- const override = getProtectedPathOverride(kind);
130
- const allowed = (kind === "policy" && opts.allowPolicy) ||
131
- (kind === "config" && opts.allowConfig) ||
132
- (kind === "hooks" && opts.allowHooks) ||
133
- (kind === "ci" && opts.allowCI);
134
- if (!allowed) {
135
- throw new CliError({
136
- exitCode: 5,
137
- code: "E_GIT",
138
- message: `Staged file is protected by default: ${filePath} (use ${override.cliFlag} to override)`,
139
- });
140
- }
141
- }
142
- if (!allow.some((prefix) => gitPathIsUnderPrefix(filePath, prefix))) {
143
- throw new CliError({
144
- exitCode: 5,
145
- code: "E_GIT",
146
- message: `Staged file is outside allowlist: ${filePath}`,
147
- });
148
- }
149
- }
150
- }
151
- export async function gitStatusChangedPaths(opts) {
152
- const resolved = await resolveProject({
153
- cwd: opts.cwd,
154
- rootOverride: opts.rootOverride ?? null,
155
- });
156
- const optsExec = {
157
- cwd: resolved.gitRoot,
158
- encoding: "buffer",
159
- maxBuffer: 10 * 1024 * 1024,
160
- };
161
- const [unstaged, staged, untracked] = await Promise.all([
162
- execFileAsync("git", ["diff", "--name-only", "-z"], optsExec),
163
- execFileAsync("git", ["diff", "--name-only", "--cached", "-z"], optsExec),
164
- execFileAsync("git", ["ls-files", "--others", "--exclude-standard", "-z"], optsExec),
165
- ]);
166
- const files = [
167
- ...parseNullSeparatedPaths(unstaged.stdout),
168
- ...parseNullSeparatedPaths(staged.stdout),
169
- ...parseNullSeparatedPaths(untracked.stdout),
170
- ];
171
- return [...new Set(files)].toSorted((a, b) => a.localeCompare(b));
172
- }
173
- export async function ensureGitClean(opts) {
174
- const staged = await getStagedFiles({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
175
- if (staged.length > 0) {
176
- throw new CliError({ exitCode: 5, code: "E_GIT", message: "Working tree has staged changes" });
177
- }
178
- const unstaged = await getUnstagedFiles({
179
- cwd: opts.cwd,
180
- rootOverride: opts.rootOverride ?? null,
181
- });
182
- if (unstaged.length > 0) {
183
- throw new CliError({
184
- exitCode: 5,
185
- code: "E_GIT",
186
- message: "Working tree has unstaged changes",
187
- });
188
- }
189
- }
190
- async function stageAllowlist(opts) {
191
- const resolved = await resolveProject({
192
- cwd: opts.cwd,
193
- rootOverride: opts.rootOverride ?? null,
194
- });
195
- const changed = await gitStatusChangedPaths({ cwd: opts.cwd, rootOverride: opts.rootOverride });
196
- if (changed.length === 0) {
197
- throw new CliError({
198
- exitCode: 2,
199
- code: "E_USAGE",
200
- message: "No changes to stage (working tree clean)",
201
- });
202
- }
203
- const allow = opts.allow.map((prefix) => normalizeGitPathPrefix(prefix));
204
- const denied = new Set();
205
- if (!opts.allowTasks)
206
- denied.add(opts.tasksPath);
207
- const staged = [];
208
- for (const filePath of changed) {
209
- if (denied.has(filePath))
210
- continue;
211
- if (allow.some((prefix) => gitPathIsUnderPrefix(filePath, prefix))) {
212
- staged.push(filePath);
213
- }
214
- }
215
- const unique = [...new Set(staged)].toSorted((a, b) => a.localeCompare(b));
216
- if (unique.length === 0) {
217
- throw new CliError({
218
- exitCode: 2,
219
- code: "E_USAGE",
220
- message: "No changes matched allowed prefixes (use --commit-auto-allow or update --commit-allow)",
221
- });
222
- }
223
- // `git add <pathspec>` is not reliable for staging deletes/renames across versions/configs.
224
- // `-A -- <pathspec...>` makes the allowlist staging semantics deterministic.
225
- await execFileAsync("git", ["add", "-A", "--", ...unique], { cwd: resolved.gitRoot });
226
- return unique;
227
- }
228
- function deriveCommitMessageFromComment(opts) {
229
- const raw = (opts.formattedComment ?? formatCommentBodyForCommit(opts.body, opts.config))
230
- .trim()
231
- .replaceAll(/\s+/g, " ");
232
- if (!raw) {
233
- throw new CliError({
234
- exitCode: 2,
235
- code: "E_USAGE",
236
- message: "Comment body is required to build a commit message from the task comment",
237
- });
238
- }
239
- const summary = raw.replace(/^(start|blocked|verified):\s+/i, "").trim();
240
- if (!summary) {
241
- throw new CliError({
242
- exitCode: 2,
243
- code: "E_USAGE",
244
- message: "Comment body is required to build a commit message from the task comment",
245
- });
246
- }
247
- const prefix = opts.emoji.trim();
248
- if (!prefix) {
249
- throw new CliError({
250
- exitCode: 2,
251
- code: "E_USAGE",
252
- message: "Emoji prefix is required when deriving commit messages from task comments",
253
- });
254
- }
255
- const suffix = extractTaskSuffix(opts.taskId);
256
- if (!suffix) {
257
- throw new CliError({
258
- exitCode: 2,
259
- code: "E_USAGE",
260
- message: invalidValueMessage("task id", opts.taskId, "valid task id"),
261
- });
262
- }
263
- return `${prefix} ${suffix} task: ${summary}`;
264
- }
265
- function deriveCommitBodyFromComment(opts) {
266
- const lines = [
267
- `Task: ${opts.taskId}`,
268
- ...(opts.author ? [`Agent: ${opts.author}`] : []),
269
- ...(opts.statusFrom && opts.statusTo ? [`Status: ${opts.statusFrom} -> ${opts.statusTo}`] : []),
270
- `Comment: ${normalizeCommentBodyForCommit(opts.formattedComment || opts.commentBody)}`,
271
- ];
272
- return lines.join("\n").trimEnd();
273
- }
274
- export async function commitFromComment(opts) {
275
- let allowPrefixes = opts.allow.map((prefix) => prefix.trim()).filter(Boolean);
276
- if (opts.autoAllow && allowPrefixes.length === 0) {
277
- const changed = await gitStatusChangedPaths({ cwd: opts.cwd, rootOverride: opts.rootOverride });
278
- const tasksPath = opts.config.paths.tasks_path;
279
- // Auto-allow is for ergonomic status commits. It must never silently
280
- // broaden into policy/config/CI changes (those require explicit intent).
281
- const eligible = changed.filter((filePath) => {
282
- const kind = protectedPathKindForFile({ filePath, tasksPath });
283
- if (!kind)
284
- return true;
285
- if (kind === "tasks")
286
- return opts.allowTasks;
287
- return false;
288
- });
289
- allowPrefixes = suggestAllowPrefixes(eligible);
290
- }
291
- if (allowPrefixes.length === 0) {
292
- throw new CliError({
293
- exitCode: 2,
294
- code: "E_USAGE",
295
- message: "Provide at least one --commit-allow prefix or enable --commit-auto-allow",
296
- });
297
- }
298
- const staged = await stageAllowlist({
299
- cwd: opts.cwd,
300
- rootOverride: opts.rootOverride,
301
- allow: allowPrefixes,
302
- allowTasks: opts.allowTasks,
303
- tasksPath: opts.config.paths.tasks_path,
304
- });
305
- const message = deriveCommitMessageFromComment({
306
- taskId: opts.taskId,
307
- body: opts.commentBody,
308
- emoji: opts.emoji,
309
- formattedComment: opts.formattedComment,
310
- config: opts.config,
311
- });
312
- const formattedComment = opts.formattedComment ?? formatCommentBodyForCommit(opts.commentBody, opts.config);
313
- const body = deriveCommitBodyFromComment({
314
- taskId: opts.taskId,
315
- author: opts.author,
316
- statusFrom: opts.statusFrom,
317
- statusTo: opts.statusTo,
318
- commentBody: opts.commentBody,
319
- formattedComment,
320
- });
321
- await guardCommitCheck({
322
- cwd: opts.cwd,
323
- rootOverride: opts.rootOverride,
324
- taskId: opts.taskId,
325
- message,
326
- allow: allowPrefixes,
327
- allowBase: false,
328
- allowTasks: opts.allowTasks,
329
- allowPolicy: false,
330
- allowConfig: false,
331
- allowHooks: false,
332
- allowCI: false,
333
- requireClean: opts.requireClean,
334
- quiet: opts.quiet,
335
- });
336
- const resolved = await resolveProject({
337
- cwd: opts.cwd,
338
- rootOverride: opts.rootOverride ?? null,
339
- });
340
- // Never allow base-branch code commits implicitly from comment-driven commits.
341
- // Base overrides must be explicit via the `commit` command's --allow-base flag.
342
- const env = buildGitCommitEnv({
343
- taskId: opts.taskId,
344
- allowTasks: opts.allowTasks,
345
- allowBase: false,
346
- allowPolicy: false,
347
- allowConfig: false,
348
- allowHooks: false,
349
- allowCI: false,
350
- });
351
- await execFileAsync("git", ["commit", "-m", message, "-m", body], { cwd: resolved.gitRoot, env });
352
- const { stdout } = await execFileAsync("git", ["log", "-1", "--pretty=%H%x00%s"], {
353
- cwd: resolved.gitRoot,
354
- });
355
- const { hash, subject } = parseGitLogHashSubject(stdout);
356
- if (!opts.quiet) {
357
- process.stdout.write(`${successMessage("committed", `${hash?.slice(0, 12) ?? ""} ${subject ?? ""}`.trim(), `staged=${staged.join(", ")}`)}\n`);
358
- }
359
- return { hash, message: subject, staged };
360
- }
361
- export async function cmdGuardClean(opts) {
362
- try {
363
- const staged = await getStagedFiles({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
364
- if (staged.length > 0) {
365
- throw new CliError({
366
- exitCode: 5,
367
- code: "E_GIT",
368
- message: "Staged files exist",
369
- });
370
- }
371
- if (!opts.quiet) {
372
- process.stdout.write(`${successMessage("index clean", undefined, "no staged files")}\n`);
373
- }
374
- return 0;
375
- }
376
- catch (err) {
377
- if (err instanceof CliError)
378
- throw err;
379
- throw mapCoreError(err, { command: "guard clean", root: opts.rootOverride ?? null });
380
- }
381
- }
382
- export async function cmdGuardSuggestAllow(opts) {
383
- try {
384
- const staged = await getStagedFiles({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null });
385
- if (staged.length === 0) {
386
- throw new CliError({
387
- exitCode: 2,
388
- code: "E_USAGE",
389
- message: "No staged files (git index empty)",
390
- });
391
- }
392
- const prefixes = suggestAllowPrefixes(staged);
393
- if (opts.format === "args") {
394
- const args = prefixes.map((p) => `--allow ${p}`).join(" ");
395
- process.stdout.write(`${args}\n`);
396
- }
397
- else {
398
- for (const prefix of prefixes)
399
- process.stdout.write(`${prefix}\n`);
400
- }
401
- return 0;
402
- }
403
- catch (err) {
404
- throw mapCoreError(err, { command: "guard suggest-allow", root: opts.rootOverride ?? null });
405
- }
406
- }
407
- export async function cmdGuardCommit(opts) {
408
- try {
409
- await guardCommitCheck(opts);
410
- if (!opts.quiet)
411
- process.stdout.write("OK\n");
412
- return 0;
413
- }
414
- catch (err) {
415
- if (err instanceof CliError)
416
- throw err;
417
- throw mapCoreError(err, { command: "guard commit", root: opts.rootOverride ?? null });
418
- }
419
- }
420
- export async function cmdCommit(opts) {
421
- try {
422
- let allow = opts.allow;
423
- if (opts.autoAllow && allow.length === 0) {
424
- const staged = await getStagedFiles({
425
- cwd: opts.cwd,
426
- rootOverride: opts.rootOverride ?? null,
427
- });
428
- const prefixes = suggestAllowPrefixes(staged);
429
- if (prefixes.length === 0) {
430
- throw new CliError({
431
- exitCode: 5,
432
- code: "E_GIT",
433
- message: "No staged files (git index empty)",
434
- });
435
- }
436
- allow = prefixes;
437
- }
438
- await guardCommitCheck({
439
- cwd: opts.cwd,
440
- rootOverride: opts.rootOverride,
441
- taskId: opts.taskId,
442
- message: opts.message,
443
- allow,
444
- allowBase: opts.allowBase,
445
- allowTasks: opts.allowTasks,
446
- allowPolicy: opts.allowPolicy,
447
- allowConfig: opts.allowConfig,
448
- allowHooks: opts.allowHooks,
449
- allowCI: opts.allowCI,
450
- requireClean: opts.requireClean,
451
- quiet: opts.quiet,
452
- });
453
- const resolved = await resolveProject({
454
- cwd: opts.cwd,
455
- rootOverride: opts.rootOverride ?? null,
456
- });
457
- const env = buildGitCommitEnv({
458
- taskId: opts.taskId,
459
- allowTasks: opts.allowTasks,
460
- allowBase: opts.allowBase,
461
- allowPolicy: opts.allowPolicy,
462
- allowConfig: opts.allowConfig,
463
- allowHooks: opts.allowHooks,
464
- allowCI: opts.allowCI,
465
- });
466
- await execFileAsync("git", ["commit", "-m", opts.message], { cwd: resolved.gitRoot, env });
467
- if (!opts.quiet) {
468
- const { stdout } = await execFileAsync("git", ["log", "-1", "--pretty=%H%x00%s"], {
469
- cwd: resolved.gitRoot,
470
- });
471
- const { hash, subject } = parseGitLogHashSubject(stdout);
472
- process.stdout.write(`${successMessage("committed", `${hash?.slice(0, 12) ?? ""} ${subject ?? ""}`.trim())}\n`);
473
- }
474
- return 0;
475
- }
476
- catch (err) {
477
- if (err instanceof CliError)
478
- throw err;
479
- throw mapCoreError(err, { command: "commit", root: opts.rootOverride ?? null });
480
- }
481
- }
1
+ export { buildGitCommitEnv } from "./impl/env.js";
2
+ export { ensureGitClean, gitStatusChangedPaths, suggestAllowPrefixes } from "./impl/allow.js";
3
+ export { commitFromComment } from "./impl/comment-commit.js";
4
+ export { cmdCommit, cmdGuardClean, cmdGuardCommit, cmdGuardSuggestAllow } from "./impl/commands.js";
@@ -0,0 +1,7 @@
1
+ import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
2
+ export type GuardSuggestAllowParsed = {
3
+ format: "lines" | "args";
4
+ };
5
+ export declare const guardSuggestAllowSpec: CommandSpec<GuardSuggestAllowParsed>;
6
+ export declare const runGuardSuggestAllow: CommandHandler<GuardSuggestAllowParsed>;
7
+ //# sourceMappingURL=suggest-allow.command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"suggest-allow.command.d.ts","sourceRoot":"","sources":["../../../src/commands/guard/suggest-allow.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,uBAAuB,GAAG;IAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAA;CAAE,CAAC;AAEnE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,uBAAuB,CAmBtE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,uBAAuB,CAMxE,CAAC"}
@@ -0,0 +1,28 @@
1
+ import { cmdGuardSuggestAllow } from "./index.js";
2
+ export const guardSuggestAllowSpec = {
3
+ id: ["guard", "suggest-allow"],
4
+ group: "Guard",
5
+ summary: "Suggest minimal --allow prefixes based on staged files.",
6
+ options: [
7
+ {
8
+ kind: "string",
9
+ name: "format",
10
+ valueHint: "<lines|args>",
11
+ choices: ["lines", "args"],
12
+ default: "lines",
13
+ description: "Output format (default: lines).",
14
+ },
15
+ ],
16
+ examples: [
17
+ { cmd: "agentplane guard suggest-allow", why: "Print prefixes, one per line." },
18
+ { cmd: "agentplane guard suggest-allow --format args", why: "Print as --allow ... args." },
19
+ ],
20
+ parse: (raw) => ({ format: (raw.opts.format ?? "lines") }),
21
+ };
22
+ export const runGuardSuggestAllow = async (ctx, p) => {
23
+ return await cmdGuardSuggestAllow({
24
+ cwd: ctx.cwd,
25
+ rootOverride: ctx.rootOverride,
26
+ format: p.format,
27
+ });
28
+ };
@@ -0,0 +1,5 @@
1
+ import type { CommandHandler, CommandSpec } from "../../cli/spec/spec.js";
2
+ export type HooksGroupParsed = Record<string, never>;
3
+ export declare const hooksSpec: CommandSpec<HooksGroupParsed>;
4
+ export declare const runHooks: CommandHandler<HooksGroupParsed>;
5
+ //# sourceMappingURL=hooks.command.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.command.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/hooks.command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1E,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAErD,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAYnD,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,gBAAgB,CAGrD,CAAC"}
@@ -0,0 +1,18 @@
1
+ import { usageError } from "../../cli/spec/errors.js";
2
+ export const hooksSpec = {
3
+ id: ["hooks"],
4
+ group: "Hooks",
5
+ summary: "Manage and run git hooks installed by agentplane.",
6
+ synopsis: ["agentplane hooks <command> [args] [options]"],
7
+ validateRaw: (raw) => {
8
+ if (raw.extra.length > 0) {
9
+ throw usageError({ spec: hooksSpec, message: `Unknown subcommand: ${raw.extra[0]}` });
10
+ }
11
+ throw usageError({ spec: hooksSpec, message: "Missing subcommand." });
12
+ },
13
+ parse: () => ({}),
14
+ };
15
+ export const runHooks = () => {
16
+ // Unreachable (validateRaw always throws).
17
+ return Promise.resolve(2);
18
+ };
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AAgG5E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2IlB"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hooks/index.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,UAAU,mDAAoD,CAAC;AAgG5E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2FlB"}