@draht/coding-agent 2026.4.26 → 2026.6.11

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 (621) hide show
  1. package/CHANGELOG.md +43 -0
  2. package/bin/draht-tools.cjs +3809 -1
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/cli.js +4 -2
  5. package/dist/bun/cli.js.map +1 -1
  6. package/dist/bun/restore-sandbox-env.d.ts +13 -0
  7. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  8. package/dist/bun/restore-sandbox-env.js +32 -0
  9. package/dist/bun/restore-sandbox-env.js.map +1 -0
  10. package/dist/cli/args.d.ts +9 -4
  11. package/dist/cli/args.d.ts.map +1 -1
  12. package/dist/cli/args.js +88 -35
  13. package/dist/cli/args.js.map +1 -1
  14. package/dist/cli/config-selector.d.ts +2 -2
  15. package/dist/cli/config-selector.d.ts.map +1 -1
  16. package/dist/cli/config-selector.js +1 -1
  17. package/dist/cli/config-selector.js.map +1 -1
  18. package/dist/cli/file-processor.d.ts.map +1 -1
  19. package/dist/cli/file-processor.js +2 -3
  20. package/dist/cli/file-processor.js.map +1 -1
  21. package/dist/cli/initial-message.d.ts +1 -1
  22. package/dist/cli/initial-message.d.ts.map +1 -1
  23. package/dist/cli/initial-message.js.map +1 -1
  24. package/dist/cli/list-models.d.ts +1 -1
  25. package/dist/cli/list-models.d.ts.map +1 -1
  26. package/dist/cli/list-models.js +7 -1
  27. package/dist/cli/list-models.js.map +1 -1
  28. package/dist/cli/project-trust.d.ts +10 -0
  29. package/dist/cli/project-trust.d.ts.map +1 -0
  30. package/dist/cli/project-trust.js +48 -0
  31. package/dist/cli/project-trust.js.map +1 -0
  32. package/dist/cli/session-picker.d.ts +1 -1
  33. package/dist/cli/session-picker.d.ts.map +1 -1
  34. package/dist/cli/session-picker.js.map +1 -1
  35. package/dist/cli/startup-ui.d.ts +16 -0
  36. package/dist/cli/startup-ui.d.ts.map +1 -0
  37. package/dist/cli/startup-ui.js +112 -0
  38. package/dist/cli/startup-ui.js.map +1 -0
  39. package/dist/cli.d.ts.map +1 -1
  40. package/dist/cli.js +7 -4
  41. package/dist/cli.js.map +1 -1
  42. package/dist/config.d.ts +23 -13
  43. package/dist/config.d.ts.map +1 -1
  44. package/dist/config.js +264 -62
  45. package/dist/config.js.map +1 -1
  46. package/dist/core/agent-session-runtime.d.ts +45 -9
  47. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  48. package/dist/core/agent-session-runtime.js +100 -33
  49. package/dist/core/agent-session-runtime.js.map +1 -1
  50. package/dist/core/agent-session-services.d.ts +6 -4
  51. package/dist/core/agent-session-services.d.ts.map +1 -1
  52. package/dist/core/agent-session-services.js +7 -4
  53. package/dist/core/agent-session-services.js.map +1 -1
  54. package/dist/core/agent-session.d.ts +47 -31
  55. package/dist/core/agent-session.d.ts.map +1 -1
  56. package/dist/core/agent-session.js +470 -443
  57. package/dist/core/agent-session.js.map +1 -1
  58. package/dist/core/auth-guidance.d.ts +5 -0
  59. package/dist/core/auth-guidance.d.ts.map +1 -0
  60. package/dist/core/auth-guidance.js +21 -0
  61. package/dist/core/auth-guidance.js.map +1 -0
  62. package/dist/core/auth-storage.d.ts +10 -1
  63. package/dist/core/auth-storage.d.ts.map +1 -1
  64. package/dist/core/auth-storage.js +27 -6
  65. package/dist/core/auth-storage.js.map +1 -1
  66. package/dist/core/bash-executor.d.ts +1 -15
  67. package/dist/core/bash-executor.d.ts.map +1 -1
  68. package/dist/core/bash-executor.js +10 -24
  69. package/dist/core/bash-executor.js.map +1 -1
  70. package/dist/core/builtins/subagent.d.ts.map +1 -1
  71. package/dist/core/builtins/subagent.js +1 -2
  72. package/dist/core/builtins/subagent.js.map +1 -1
  73. package/dist/core/compaction/branch-summarization.d.ts +6 -4
  74. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  75. package/dist/core/compaction/branch-summarization.js +9 -3
  76. package/dist/core/compaction/branch-summarization.js.map +1 -1
  77. package/dist/core/compaction/compaction.d.ts +5 -5
  78. package/dist/core/compaction/compaction.d.ts.map +1 -1
  79. package/dist/core/compaction/compaction.js +43 -37
  80. package/dist/core/compaction/compaction.js.map +1 -1
  81. package/dist/core/compaction/index.d.ts +3 -3
  82. package/dist/core/compaction/index.d.ts.map +1 -1
  83. package/dist/core/compaction/index.js.map +1 -1
  84. package/dist/core/compaction/utils.d.ts +1 -1
  85. package/dist/core/compaction/utils.d.ts.map +1 -1
  86. package/dist/core/compaction/utils.js +1 -1
  87. package/dist/core/compaction/utils.js.map +1 -1
  88. package/dist/core/exec.d.ts.map +1 -1
  89. package/dist/core/exec.js.map +1 -1
  90. package/dist/core/experimental.d.ts +2 -0
  91. package/dist/core/experimental.d.ts.map +1 -0
  92. package/dist/core/experimental.js +4 -0
  93. package/dist/core/experimental.js.map +1 -0
  94. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  95. package/dist/core/export-html/ansi-to-html.js +1 -1
  96. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  97. package/dist/core/export-html/index.d.ts +1 -1
  98. package/dist/core/export-html/index.d.ts.map +1 -1
  99. package/dist/core/export-html/index.js +13 -11
  100. package/dist/core/export-html/index.js.map +1 -1
  101. package/dist/core/export-html/template.css +69 -4
  102. package/dist/core/export-html/template.js +231 -57
  103. package/dist/core/export-html/tool-renderer.d.ts +0 -6
  104. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  105. package/dist/core/export-html/tool-renderer.js +15 -2
  106. package/dist/core/export-html/tool-renderer.js.map +1 -1
  107. package/dist/core/extensions/index.d.ts +8 -8
  108. package/dist/core/extensions/index.d.ts.map +1 -1
  109. package/dist/core/extensions/index.js.map +1 -1
  110. package/dist/core/extensions/loader.d.ts +3 -3
  111. package/dist/core/extensions/loader.d.ts.map +1 -1
  112. package/dist/core/extensions/loader.js +27 -35
  113. package/dist/core/extensions/loader.js.map +1 -1
  114. package/dist/core/extensions/runner.d.ts +30 -12
  115. package/dist/core/extensions/runner.d.ts.map +1 -1
  116. package/dist/core/extensions/runner.js +215 -32
  117. package/dist/core/extensions/runner.js.map +1 -1
  118. package/dist/core/extensions/types.d.ts +163 -35
  119. package/dist/core/extensions/types.d.ts.map +1 -1
  120. package/dist/core/extensions/types.js.map +1 -1
  121. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  122. package/dist/core/extensions/wrapper.js +2 -2
  123. package/dist/core/extensions/wrapper.js.map +1 -1
  124. package/dist/core/footer-data-provider.d.ts +7 -1
  125. package/dist/core/footer-data-provider.d.ts.map +1 -1
  126. package/dist/core/footer-data-provider.js +78 -54
  127. package/dist/core/footer-data-provider.js.map +1 -1
  128. package/dist/core/http-dispatcher.d.ts +21 -0
  129. package/dist/core/http-dispatcher.d.ts.map +1 -0
  130. package/dist/core/http-dispatcher.js +48 -0
  131. package/dist/core/http-dispatcher.js.map +1 -0
  132. package/dist/core/index.d.ts +9 -8
  133. package/dist/core/index.d.ts.map +1 -1
  134. package/dist/core/index.js +2 -1
  135. package/dist/core/index.js.map +1 -1
  136. package/dist/core/keybindings.d.ts +66 -1
  137. package/dist/core/keybindings.d.ts.map +1 -1
  138. package/dist/core/keybindings.js +56 -1
  139. package/dist/core/keybindings.js.map +1 -1
  140. package/dist/core/model-registry.d.ts +22 -4
  141. package/dist/core/model-registry.d.ts.map +1 -1
  142. package/dist/core/model-registry.js +216 -44
  143. package/dist/core/model-registry.js.map +1 -1
  144. package/dist/core/model-resolver.d.ts +2 -1
  145. package/dist/core/model-resolver.d.ts.map +1 -1
  146. package/dist/core/model-resolver.js +48 -21
  147. package/dist/core/model-resolver.js.map +1 -1
  148. package/dist/core/output-guard.d.ts +1 -0
  149. package/dist/core/output-guard.d.ts.map +1 -1
  150. package/dist/core/output-guard.js +52 -22
  151. package/dist/core/output-guard.js.map +1 -1
  152. package/dist/core/package-manager.d.ts +17 -2
  153. package/dist/core/package-manager.d.ts.map +1 -1
  154. package/dist/core/package-manager.js +363 -121
  155. package/dist/core/package-manager.js.map +1 -1
  156. package/dist/core/project-trust.d.ts +15 -0
  157. package/dist/core/project-trust.d.ts.map +1 -0
  158. package/dist/core/project-trust.js +58 -0
  159. package/dist/core/project-trust.js.map +1 -0
  160. package/dist/core/prompt-templates.d.ts +13 -11
  161. package/dist/core/prompt-templates.d.ts.map +1 -1
  162. package/dist/core/prompt-templates.js +67 -76
  163. package/dist/core/prompt-templates.js.map +1 -1
  164. package/dist/core/provider-attribution.d.ts +4 -0
  165. package/dist/core/provider-attribution.d.ts.map +1 -0
  166. package/dist/core/provider-attribution.js +72 -0
  167. package/dist/core/provider-attribution.js.map +1 -0
  168. package/dist/core/provider-display-names.d.ts +2 -0
  169. package/dist/core/provider-display-names.d.ts.map +1 -0
  170. package/dist/core/provider-display-names.js +36 -0
  171. package/dist/core/provider-display-names.js.map +1 -0
  172. package/dist/core/resolve-config-value.d.ts +9 -1
  173. package/dist/core/resolve-config-value.d.ts.map +1 -1
  174. package/dist/core/resolve-config-value.js +134 -11
  175. package/dist/core/resolve-config-value.js.map +1 -1
  176. package/dist/core/resource-loader.d.ts +34 -14
  177. package/dist/core/resource-loader.d.ts.map +1 -1
  178. package/dist/core/resource-loader.js +165 -76
  179. package/dist/core/resource-loader.js.map +1 -1
  180. package/dist/core/sdk.d.ts +26 -10
  181. package/dist/core/sdk.d.ts.map +1 -1
  182. package/dist/core/sdk.js +45 -16
  183. package/dist/core/sdk.js.map +1 -1
  184. package/dist/core/session-manager.d.ts +11 -12
  185. package/dist/core/session-manager.d.ts.map +1 -1
  186. package/dist/core/session-manager.js +245 -132
  187. package/dist/core/session-manager.js.map +1 -1
  188. package/dist/core/settings-manager.d.ts +52 -5
  189. package/dist/core/settings-manager.d.ts.map +1 -1
  190. package/dist/core/settings-manager.js +202 -38
  191. package/dist/core/settings-manager.js.map +1 -1
  192. package/dist/core/skills.d.ts +10 -10
  193. package/dist/core/skills.d.ts.map +1 -1
  194. package/dist/core/skills.js +13 -35
  195. package/dist/core/skills.js.map +1 -1
  196. package/dist/core/slash-commands.d.ts +1 -1
  197. package/dist/core/slash-commands.d.ts.map +1 -1
  198. package/dist/core/slash-commands.js +7 -4
  199. package/dist/core/slash-commands.js.map +1 -1
  200. package/dist/core/source-info.d.ts +1 -1
  201. package/dist/core/source-info.d.ts.map +1 -1
  202. package/dist/core/source-info.js.map +1 -1
  203. package/dist/core/system-prompt.d.ts +4 -4
  204. package/dist/core/system-prompt.d.ts.map +1 -1
  205. package/dist/core/system-prompt.js +14 -10
  206. package/dist/core/system-prompt.js.map +1 -1
  207. package/dist/core/telemetry.d.ts +3 -0
  208. package/dist/core/telemetry.d.ts.map +1 -0
  209. package/dist/core/telemetry.js +9 -0
  210. package/dist/core/telemetry.js.map +1 -0
  211. package/dist/core/tools/bash.d.ts +11 -16
  212. package/dist/core/tools/bash.d.ts.map +1 -1
  213. package/dist/core/tools/bash.js +162 -177
  214. package/dist/core/tools/bash.js.map +1 -1
  215. package/dist/core/tools/edit-diff.d.ts +3 -1
  216. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  217. package/dist/core/tools/edit-diff.js +11 -3
  218. package/dist/core/tools/edit-diff.js.map +1 -1
  219. package/dist/core/tools/edit.d.ts +22 -24
  220. package/dist/core/tools/edit.d.ts.map +1 -1
  221. package/dist/core/tools/edit.js +199 -111
  222. package/dist/core/tools/edit.js.map +1 -1
  223. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  224. package/dist/core/tools/file-mutation-queue.js +27 -12
  225. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  226. package/dist/core/tools/find.d.ts +7 -18
  227. package/dist/core/tools/find.d.ts.map +1 -1
  228. package/dist/core/tools/find.js +134 -95
  229. package/dist/core/tools/find.js.map +1 -1
  230. package/dist/core/tools/grep.d.ts +11 -30
  231. package/dist/core/tools/grep.d.ts.map +1 -1
  232. package/dist/core/tools/grep.js +23 -12
  233. package/dist/core/tools/grep.js.map +1 -1
  234. package/dist/core/tools/index.d.ts +26 -101
  235. package/dist/core/tools/index.d.ts.map +1 -1
  236. package/dist/core/tools/index.js +78 -52
  237. package/dist/core/tools/index.js.map +1 -1
  238. package/dist/core/tools/ls.d.ts +6 -15
  239. package/dist/core/tools/ls.d.ts.map +1 -1
  240. package/dist/core/tools/ls.js +12 -17
  241. package/dist/core/tools/ls.js.map +1 -1
  242. package/dist/core/tools/output-accumulator.d.ts +52 -0
  243. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  244. package/dist/core/tools/output-accumulator.js +184 -0
  245. package/dist/core/tools/output-accumulator.js.map +1 -0
  246. package/dist/core/tools/path-utils.d.ts +2 -0
  247. package/dist/core/tools/path-utils.d.ts.map +1 -1
  248. package/dist/core/tools/path-utils.js +40 -22
  249. package/dist/core/tools/path-utils.js.map +1 -1
  250. package/dist/core/tools/read.d.ts +7 -18
  251. package/dist/core/tools/read.d.ts.map +1 -1
  252. package/dist/core/tools/read.js +100 -36
  253. package/dist/core/tools/read.js.map +1 -1
  254. package/dist/core/tools/render-utils.d.ts +5 -2
  255. package/dist/core/tools/render-utils.d.ts.map +1 -1
  256. package/dist/core/tools/render-utils.js +18 -2
  257. package/dist/core/tools/render-utils.js.map +1 -1
  258. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  259. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  260. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  261. package/dist/core/tools/truncate.d.ts.map +1 -1
  262. package/dist/core/tools/truncate.js +12 -2
  263. package/dist/core/tools/truncate.js.map +1 -1
  264. package/dist/core/tools/write.d.ts +5 -14
  265. package/dist/core/tools/write.d.ts.map +1 -1
  266. package/dist/core/tools/write.js +27 -46
  267. package/dist/core/tools/write.js.map +1 -1
  268. package/dist/core/trust-manager.d.ts +31 -0
  269. package/dist/core/trust-manager.d.ts.map +1 -0
  270. package/dist/core/trust-manager.js +187 -0
  271. package/dist/core/trust-manager.js.map +1 -0
  272. package/dist/index.d.ts +31 -29
  273. package/dist/index.d.ts.map +1 -1
  274. package/dist/index.js +9 -8
  275. package/dist/index.js.map +1 -1
  276. package/dist/main.d.ts +5 -1
  277. package/dist/main.d.ts.map +1 -1
  278. package/dist/main.js +170 -87
  279. package/dist/main.js.map +1 -1
  280. package/dist/migrations.d.ts +2 -2
  281. package/dist/migrations.d.ts.map +1 -1
  282. package/dist/migrations.js +127 -5
  283. package/dist/migrations.js.map +1 -1
  284. package/dist/modes/index.d.ts +5 -5
  285. package/dist/modes/index.d.ts.map +1 -1
  286. package/dist/modes/index.js.map +1 -1
  287. package/dist/modes/interactive/components/assistant-message.d.ts +2 -0
  288. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  289. package/dist/modes/interactive/components/assistant-message.js +14 -0
  290. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  291. package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
  292. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  293. package/dist/modes/interactive/components/bash-execution.js +3 -3
  294. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  295. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  296. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  297. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  298. package/dist/modes/interactive/components/config-selector.d.ts +4 -4
  299. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  300. package/dist/modes/interactive/components/config-selector.js +38 -11
  301. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  302. package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
  303. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  304. package/dist/modes/interactive/components/countdown-timer.js +2 -2
  305. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  306. package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
  307. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  308. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  309. package/dist/modes/interactive/components/custom-message.d.ts +2 -2
  310. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  311. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  312. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  313. package/dist/modes/interactive/components/diff.js.map +1 -1
  314. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  315. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  316. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  317. package/dist/modes/interactive/components/extension-editor.js +14 -6
  318. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  319. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  320. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  321. package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
  322. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  323. package/dist/modes/interactive/components/extension-selector.js +8 -3
  324. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  325. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  326. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  327. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  328. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  329. package/dist/modes/interactive/components/footer.d.ts +2 -1
  330. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  331. package/dist/modes/interactive/components/footer.js +23 -7
  332. package/dist/modes/interactive/components/footer.js.map +1 -1
  333. package/dist/modes/interactive/components/index.d.ts +33 -31
  334. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  335. package/dist/modes/interactive/components/index.js +2 -0
  336. package/dist/modes/interactive/components/index.js.map +1 -1
  337. package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
  338. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  339. package/dist/modes/interactive/components/keybinding-hints.js +19 -5
  340. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  341. package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
  342. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  343. package/dist/modes/interactive/components/login-dialog.js +46 -11
  344. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  345. package/dist/modes/interactive/components/model-selector.d.ts +2 -2
  346. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  347. package/dist/modes/interactive/components/model-selector.js +8 -5
  348. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  349. package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
  350. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  351. package/dist/modes/interactive/components/oauth-selector.js +93 -25
  352. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  353. package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
  354. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  355. package/dist/modes/interactive/components/scoped-models-selector.js +45 -30
  356. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  357. package/dist/modes/interactive/components/session-selector.d.ts +2 -1
  358. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  359. package/dist/modes/interactive/components/session-selector.js +20 -7
  360. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  361. package/dist/modes/interactive/components/settings-selector.d.ts +13 -0
  362. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  363. package/dist/modes/interactive/components/settings-selector.js +113 -4
  364. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  365. package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
  366. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  367. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  368. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  369. package/dist/modes/interactive/components/thinking-selector.js +1 -1
  370. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  371. package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
  372. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  373. package/dist/modes/interactive/components/tool-execution.js +57 -14
  374. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  375. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  376. package/dist/modes/interactive/components/tree-selector.js +18 -9
  377. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  378. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  379. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  380. package/dist/modes/interactive/components/trust-selector.js +91 -0
  381. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  382. package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
  383. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  384. package/dist/modes/interactive/components/user-message-selector.js +8 -7
  385. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  386. package/dist/modes/interactive/components/user-message.d.ts +1 -0
  387. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  388. package/dist/modes/interactive/components/user-message.js +8 -7
  389. package/dist/modes/interactive/components/user-message.js.map +1 -1
  390. package/dist/modes/interactive/interactive-mode.d.ts +68 -13
  391. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  392. package/dist/modes/interactive/interactive-mode.js +1100 -319
  393. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  394. package/dist/modes/interactive/theme/dark.json +5 -4
  395. package/dist/modes/interactive/theme/light.json +5 -4
  396. package/dist/modes/interactive/theme/theme.d.ts +22 -3
  397. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  398. package/dist/modes/interactive/theme/theme.js +160 -105
  399. package/dist/modes/interactive/theme/theme.js.map +1 -1
  400. package/dist/modes/print-mode.d.ts.map +1 -1
  401. package/dist/modes/print-mode.js +40 -20
  402. package/dist/modes/print-mode.js.map +1 -1
  403. package/dist/modes/rpc/rpc-client.d.ts +11 -1
  404. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  405. package/dist/modes/rpc/rpc-client.js +73 -8
  406. package/dist/modes/rpc/rpc-client.js.map +1 -1
  407. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  408. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  409. package/dist/modes/rpc/rpc-mode.js +96 -30
  410. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  411. package/dist/modes/rpc/rpc-types.d.ts +16 -4
  412. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  413. package/dist/modes/rpc/rpc-types.js.map +1 -1
  414. package/dist/package-manager-cli.d.ts +6 -2
  415. package/dist/package-manager-cli.d.ts.map +1 -1
  416. package/dist/package-manager-cli.js +396 -21
  417. package/dist/package-manager-cli.js.map +1 -1
  418. package/dist/prompts/commands/atomic-commit.md +12 -0
  419. package/dist/prompts/commands/execute-phase.md +48 -17
  420. package/dist/prompts/commands/fix.md +86 -23
  421. package/dist/prompts/commands/map-codebase.md +17 -3
  422. package/dist/prompts/commands/orchestrate.md +31 -6
  423. package/dist/prompts/commands/plan-phase.md +39 -6
  424. package/dist/prompts/commands/quick.md +36 -6
  425. package/dist/prompts/commands/review.md +28 -11
  426. package/dist/prompts/commands/verify-work.md +34 -17
  427. package/dist/utils/ansi.d.ts +2 -0
  428. package/dist/utils/ansi.d.ts.map +1 -0
  429. package/dist/utils/ansi.js +52 -0
  430. package/dist/utils/ansi.js.map +1 -0
  431. package/dist/utils/changelog.d.ts +2 -1
  432. package/dist/utils/changelog.d.ts.map +1 -1
  433. package/dist/utils/changelog.js +78 -0
  434. package/dist/utils/changelog.js.map +1 -1
  435. package/dist/utils/child-process.d.ts +5 -1
  436. package/dist/utils/child-process.d.ts.map +1 -1
  437. package/dist/utils/child-process.js +10 -0
  438. package/dist/utils/child-process.js.map +1 -1
  439. package/dist/utils/clipboard-image.d.ts.map +1 -1
  440. package/dist/utils/clipboard-image.js +2 -2
  441. package/dist/utils/clipboard-image.js.map +1 -1
  442. package/dist/utils/clipboard-native.d.ts +3 -1
  443. package/dist/utils/clipboard-native.d.ts.map +1 -1
  444. package/dist/utils/clipboard-native.js +14 -8
  445. package/dist/utils/clipboard-native.js.map +1 -1
  446. package/dist/utils/clipboard.d.ts.map +1 -1
  447. package/dist/utils/clipboard.js +84 -45
  448. package/dist/utils/clipboard.js.map +1 -1
  449. package/dist/utils/deprecation.d.ts +4 -0
  450. package/dist/utils/deprecation.d.ts.map +1 -0
  451. package/dist/utils/deprecation.js +13 -0
  452. package/dist/utils/deprecation.js.map +1 -0
  453. package/dist/utils/exif-orientation.d.ts +1 -1
  454. package/dist/utils/exif-orientation.d.ts.map +1 -1
  455. package/dist/utils/exif-orientation.js.map +1 -1
  456. package/dist/utils/fs-watch.d.ts +5 -0
  457. package/dist/utils/fs-watch.d.ts.map +1 -0
  458. package/dist/utils/fs-watch.js +25 -0
  459. package/dist/utils/fs-watch.js.map +1 -0
  460. package/dist/utils/git.d.ts.map +1 -1
  461. package/dist/utils/git.js +54 -22
  462. package/dist/utils/git.js.map +1 -1
  463. package/dist/utils/html.d.ts +7 -0
  464. package/dist/utils/html.d.ts.map +1 -0
  465. package/dist/utils/html.js +40 -0
  466. package/dist/utils/html.js.map +1 -0
  467. package/dist/utils/image-convert.d.ts.map +1 -1
  468. package/dist/utils/image-convert.js.map +1 -1
  469. package/dist/utils/image-resize-core.d.ts +30 -0
  470. package/dist/utils/image-resize-core.d.ts.map +1 -0
  471. package/dist/utils/image-resize-core.js +124 -0
  472. package/dist/utils/image-resize-core.js.map +1 -0
  473. package/dist/utils/image-resize-worker.d.ts +2 -0
  474. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  475. package/dist/utils/image-resize-worker.js +31 -0
  476. package/dist/utils/image-resize-worker.js.map +1 -0
  477. package/dist/utils/image-resize.d.ts +7 -27
  478. package/dist/utils/image-resize.d.ts.map +1 -1
  479. package/dist/utils/image-resize.js +75 -115
  480. package/dist/utils/image-resize.js.map +1 -1
  481. package/dist/utils/json.d.ts +3 -0
  482. package/dist/utils/json.d.ts.map +1 -0
  483. package/dist/utils/json.js +7 -0
  484. package/dist/utils/json.js.map +1 -0
  485. package/dist/utils/mime.d.ts +1 -0
  486. package/dist/utils/mime.d.ts.map +1 -1
  487. package/dist/utils/mime.js +59 -16
  488. package/dist/utils/mime.js.map +1 -1
  489. package/dist/utils/open-browser.d.ts +9 -0
  490. package/dist/utils/open-browser.d.ts.map +1 -0
  491. package/dist/utils/open-browser.js +22 -0
  492. package/dist/utils/open-browser.js.map +1 -0
  493. package/dist/utils/paths.d.ts +25 -1
  494. package/dist/utils/paths.d.ts.map +1 -1
  495. package/dist/utils/paths.js +75 -2
  496. package/dist/utils/paths.js.map +1 -1
  497. package/dist/utils/pi-user-agent.d.ts +2 -0
  498. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  499. package/dist/utils/pi-user-agent.js +5 -0
  500. package/dist/utils/pi-user-agent.js.map +1 -0
  501. package/dist/utils/shell.d.ts +10 -6
  502. package/dist/utils/shell.d.ts.map +1 -1
  503. package/dist/utils/shell.js +35 -26
  504. package/dist/utils/shell.js.map +1 -1
  505. package/dist/utils/syntax-highlight.d.ts +12 -0
  506. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  507. package/dist/utils/syntax-highlight.js +118 -0
  508. package/dist/utils/syntax-highlight.js.map +1 -0
  509. package/dist/utils/tools-manager.d.ts.map +1 -1
  510. package/dist/utils/tools-manager.js +86 -10
  511. package/dist/utils/tools-manager.js.map +1 -1
  512. package/dist/utils/version-check.d.ts +15 -0
  513. package/dist/utils/version-check.d.ts.map +1 -0
  514. package/dist/utils/version-check.js +82 -0
  515. package/dist/utils/version-check.js.map +1 -0
  516. package/dist/utils/windows-self-update.d.ts +3 -0
  517. package/dist/utils/windows-self-update.d.ts.map +1 -0
  518. package/dist/utils/windows-self-update.js +77 -0
  519. package/dist/utils/windows-self-update.js.map +1 -0
  520. package/docs/compaction.md +12 -12
  521. package/docs/containerization.md +111 -0
  522. package/docs/custom-provider.md +187 -47
  523. package/docs/development.md +5 -5
  524. package/docs/docs.json +156 -0
  525. package/docs/extensions.md +465 -71
  526. package/docs/index.md +82 -0
  527. package/docs/json.md +4 -4
  528. package/docs/keybindings.md +23 -1
  529. package/docs/models.md +119 -17
  530. package/docs/packages.md +17 -9
  531. package/docs/prompt-templates.md +30 -2
  532. package/docs/providers.md +83 -22
  533. package/docs/quickstart.md +165 -0
  534. package/docs/rpc.md +41 -10
  535. package/docs/sdk.md +68 -50
  536. package/docs/security.md +55 -0
  537. package/docs/{session.md → session-format.md} +11 -11
  538. package/docs/sessions.md +145 -0
  539. package/docs/settings.md +61 -11
  540. package/docs/skills.md +16 -17
  541. package/docs/terminal-setup.md +44 -2
  542. package/docs/termux.md +4 -4
  543. package/docs/themes.md +3 -3
  544. package/docs/tmux.md +4 -2
  545. package/docs/tui.md +44 -4
  546. package/docs/usage.md +305 -0
  547. package/examples/extensions/border-status-editor.ts +145 -0
  548. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  549. package/examples/extensions/custom-header.ts +1 -1
  550. package/examples/extensions/custom-provider-anthropic/index.ts +1 -1
  551. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  552. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  553. package/examples/extensions/custom-provider-gitlab-duo/index.ts +55 -4
  554. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  555. package/examples/extensions/custom-provider-gitlab-duo/test.ts +1 -1
  556. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  557. package/examples/extensions/doom-overlay/index.ts +1 -1
  558. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  559. package/examples/extensions/dynamic-tools.ts +2 -2
  560. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  561. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  562. package/examples/extensions/gondolin/index.ts +531 -0
  563. package/examples/extensions/gondolin/package-lock.json +185 -0
  564. package/examples/extensions/gondolin/package.json +19 -0
  565. package/examples/extensions/handoff.ts +50 -12
  566. package/examples/extensions/input-transform-streaming.ts +39 -0
  567. package/examples/extensions/interactive-shell.ts +1 -1
  568. package/examples/extensions/notify.ts +2 -9
  569. package/examples/extensions/overlay-qa-tests.ts +240 -138
  570. package/examples/extensions/overlay-test.ts +7 -4
  571. package/examples/extensions/plan-mode/utils.ts +1 -1
  572. package/examples/extensions/preset.ts +36 -3
  573. package/examples/extensions/project-trust.ts +64 -0
  574. package/examples/extensions/prompt-customizer.ts +97 -0
  575. package/examples/extensions/provider-payload.ts +4 -0
  576. package/examples/extensions/qna.ts +1 -1
  577. package/examples/extensions/question.ts +2 -2
  578. package/examples/extensions/questionnaire.ts +2 -2
  579. package/examples/extensions/reload-runtime.ts +1 -1
  580. package/examples/extensions/sandbox/index.ts +4 -4
  581. package/examples/extensions/sandbox/package-lock.json +5 -5
  582. package/examples/extensions/sandbox/package.json +2 -2
  583. package/examples/extensions/shutdown-command.ts +1 -1
  584. package/examples/extensions/snake.ts +1 -1
  585. package/examples/extensions/space-invaders.ts +1 -1
  586. package/examples/extensions/structured-output.ts +65 -0
  587. package/examples/extensions/subagent/index.ts +51 -28
  588. package/examples/extensions/summarize.ts +1 -1
  589. package/examples/extensions/tic-tac-toe.ts +1008 -0
  590. package/examples/extensions/titlebar-spinner.ts +2 -2
  591. package/examples/extensions/todo.ts +2 -2
  592. package/examples/extensions/tool-override.ts +1 -1
  593. package/examples/extensions/tools.ts +5 -0
  594. package/examples/extensions/truncated-tool.ts +1 -1
  595. package/examples/extensions/with-deps/index.ts +1 -1
  596. package/examples/extensions/with-deps/package-lock.json +2 -2
  597. package/examples/extensions/with-deps/package.json +3 -3
  598. package/examples/extensions/working-indicator.ts +123 -0
  599. package/examples/extensions/working-message-test.ts +25 -0
  600. package/examples/sdk/01-minimal.ts +14 -10
  601. package/examples/sdk/02-custom-model.ts +12 -8
  602. package/examples/sdk/03-custom-prompt.ts +32 -17
  603. package/examples/sdk/04-skills.ts +5 -2
  604. package/examples/sdk/05-tools.ts +23 -31
  605. package/examples/sdk/06-extensions.ts +14 -8
  606. package/examples/sdk/07-context-files.ts +5 -3
  607. package/examples/sdk/08-prompt-templates.ts +5 -2
  608. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  609. package/examples/sdk/10-settings.ts +8 -6
  610. package/examples/sdk/11-sessions.ts +4 -0
  611. package/examples/sdk/12-full-control.ts +13 -17
  612. package/package.json +15 -7
  613. package/prompts/commands/atomic-commit.md +12 -0
  614. package/prompts/commands/execute-phase.md +48 -17
  615. package/prompts/commands/fix.md +86 -23
  616. package/prompts/commands/map-codebase.md +17 -3
  617. package/prompts/commands/orchestrate.md +31 -6
  618. package/prompts/commands/plan-phase.md +39 -6
  619. package/prompts/commands/quick.md +36 -6
  620. package/prompts/commands/review.md +28 -11
  621. package/prompts/commands/verify-work.md +34 -17
@@ -13,6 +13,19 @@ Create atomic execution plans for a roadmap phase, using subagents for parallel
13
13
 
14
14
  Phase: $1
15
15
 
16
+ ## Red Flags — STOP
17
+
18
+ A plan is only as good as the tasks inside it. STOP and revise instead of saving if **any** of these is true:
19
+
20
+ - Any task contains placeholder text: `[TBD]`, `[files]`, `[description]`, "appropriate error handling", "similar to Task N", `...` in code positions
21
+ - A task's `<test>` section names no concrete test cases (e.g., "test the function" with no inputs/outputs)
22
+ - A task's `<files>` section lists no concrete file paths
23
+ - A task takes more than ~5 minutes — break it down further
24
+ - The plan introduces new domain terms that are NOT in `.planning/DOMAIN.md` — update DOMAIN.md first
25
+ - A plan touches more than one bounded context without explicit ACL — split per context
26
+
27
+ Run `draht-tools validate-plans $1` after saving. Fix any issues it reports before commit.
28
+
16
29
  ## Atomic Reasoning
17
30
 
18
31
  Before creating plans, decompose this phase goal into atomic reasoning units:
@@ -39,22 +52,42 @@ Before creating plans, decompose this phase goal into atomic reasoning units:
39
52
  e. Break into plan groups of 2-5 tasks each
40
53
  4. Identify which plans are independent (no shared files, no dependency edges)
41
54
  5. **Delegate plan creation to subagents:**
42
- - For independent plans: use the `subagent` tool in **parallel mode** with `architect` agents, one per plan. Each task should include the phase context, the specific observable truths, target files, and the XML task format (below).
55
+ - For independent plans: use the `subagent` tool in **parallel mode** with `architect` agents, one per plan.
43
56
  - For dependent plans: create them sequentially, each via a **single** `subagent` call to `architect`, passing the outputs of predecessor plans as context.
44
57
  - Each subagent task must include:
45
58
  - The phase context summary (paste it — subagents cannot run draht-tools)
46
59
  - The specific observable truths this plan must satisfy
47
60
  - The target files/artifacts
48
61
  - The XML task format specification (below)
49
- - Instruction to output the plan as XML (you will save it via `draht-tools create-plan`)
62
+ - The **delimiter convention** (below) so the orchestrator can split plan content from the `STATUS:` footer
63
+
64
+ ### Architect Output Delimiter Convention
65
+
66
+ The architect agent appends a `STATUS:` footer per the standard agent contract. For `/plan-phase`, we pipe the architect's plan output to `create-plan` as a file — we must NOT include the `STATUS:` line in the saved plan.
50
67
 
51
- 6. Collect all plan outputs from subagents
52
- 7. Save each plan by piping the subagent's output into `draht-tools create-plan`:
68
+ Include this in every architect prompt:
53
69
  ```
54
- echo 'plan content from subagent' | draht-tools create-plan $1 P [title]
70
+ Output your plan as XML, followed by a line containing exactly `---END-PLAN---`, followed by your final `STATUS: ...` line.
71
+
72
+ The orchestrator splits your output on `---END-PLAN---` and saves only the plan content. The STATUS line is read for control flow but not saved.
73
+ ```
74
+
75
+ 6. **Collect and split outputs.** For each architect's output:
76
+ - Split on `---END-PLAN---`
77
+ - Plan content = everything BEFORE the delimiter (trimmed)
78
+ - Status line = everything AFTER (the `STATUS:` line)
79
+ - Branch on status:
80
+ - `DONE` / `DONE_WITH_CONCERNS` → save the plan
81
+ - `NEEDS_CONTEXT` → provide missing info and re-dispatch
82
+ - `BLOCKED` → STOP, report; do not save a partial plan
83
+
84
+ 7. Save each plan by piping the split plan content into `draht-tools create-plan`:
85
+ ```
86
+ printf '%s' "$plan_content" | draht-tools create-plan $1 P [title]
55
87
  ```
56
88
  The content must contain real task details (files, actions, tests) — NOT placeholder brackets. If `create-plan` is called without stdin, it writes a useless template.
57
- 8. Validate: `draht-tools validate-plans $1`
89
+
90
+ 8. Validate: `draht-tools validate-plans $1` — if it exits non-zero, fix the offending plan before commit.
58
91
  9. Commit: `draht-tools commit-docs "create phase $1 plans"`
59
92
 
60
93
  ## Plan Format
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Execute a small ad-hoc task with tracking"
2
+ description: "Execute a small ad-hoc task with tracking (implementer + TDD + optional spec-reviewer pass)"
3
3
  ---
4
4
 
5
5
  # /quick
@@ -34,8 +34,10 @@ Before executing, decompose this task into atomic reasoning units:
34
34
  echo 'plan content here' | draht-tools create-quick-plan NNN "$ARGUMENTS"
35
35
  ```
36
36
  The plan content must include: a `# Quick Task NNN: title` heading, a `## Tasks` section with one or more `<task>` XML blocks containing real file paths, real actions, and real verification steps — NOT placeholders like `[files]`.
37
- 3. **Delegate execution to subagent**: Use the `subagent` tool in **single mode** with the `implementer` agent:
38
- "Execute this task: $ARGUMENTS
37
+
38
+ 3. **Stage 1 — Implementer.** Use the `subagent` tool in **single mode** with the `implementer` agent:
39
+ ```
40
+ Execute this task: $ARGUMENTS
39
41
 
40
42
  Follow the TDD cycle:
41
43
  - RED — Write a failing test that describes the desired behaviour
@@ -44,7 +46,35 @@ Before executing, decompose this task into atomic reasoning units:
44
46
  Exception: skip the TDD cycle only for pure config or documentation-only tasks that have no testable behaviour.
45
47
 
46
48
  After completion, report: files changed, tests written, and verification results.
47
- Do NOT run draht, draht-tools, draht help, or pi commands — use only standard tools."
48
49
 
49
- 4. Write summary: `draht-tools write-quick-summary NNN`
50
- 5. Update state: `draht-tools update-state`
50
+ End your response with `STATUS: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED` per the agent contract.
51
+
52
+ Do NOT run draht, draht-tools, draht help, or pi commands — use only standard tools.
53
+ ```
54
+
55
+ Read the final `STATUS:` line:
56
+ - `DONE` → go to Stage 2 (or skip Stage 2 for pure-config / pure-docs).
57
+ - `DONE_WITH_CONCERNS` → log; if correctness, re-dispatch; otherwise continue.
58
+ - `NEEDS_CONTEXT` → provide missing info and re-dispatch.
59
+ - `BLOCKED` → STOP, report.
60
+
61
+ 4. **Stage 2 — Spec-reviewer (skip for pure-config / pure-docs).** Use the `subagent` tool with the `spec-reviewer` agent. Prompt:
62
+ ```
63
+ Review the diff for quick task NNN against `.planning/quick/NNN-*-PLAN.md`. ONLY check spec compliance — does the diff implement exactly what the plan's <test>/<action>/<done> sections asked, no more, no less?
64
+
65
+ End with `STATUS: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED`.
66
+ ```
67
+ - `DONE` → go to Stage 3.
68
+ - `BLOCKED` → re-dispatch implementer with Required Fixes. Repeat until `DONE`.
69
+
70
+ 5. **Stage 3 — Reviewer (optional code-quality pass).** For non-trivial quick tasks (more than one file, or domain code), use the `subagent` tool with the `reviewer` agent. Otherwise skip.
71
+ - `DONE` → task complete.
72
+ - `BLOCKED` → re-dispatch implementer with Must-fix list.
73
+
74
+ 6. Write summary: `draht-tools write-quick-summary NNN`
75
+ 7. Update state: `draht-tools update-state`
76
+
77
+ ## When to skip Stage 3
78
+ - Pure config (tsconfig, biome, formatter)
79
+ - Docs-only edits
80
+ - Single-line obvious changes (typo, version bump)
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Code review and security audit of recent changes"
2
+ description: "Code review and security audit of recent changes (parallel reviewer + security-auditor + optional spec-reviewer)"
3
3
  ---
4
4
 
5
5
  # /review
@@ -25,7 +25,7 @@ Before reviewing, decompose code changes into atomic reasoning units:
25
25
  3. **Verify correctness** — Is this change correct? Type-safe? Secure? Does it follow conventions? What could go wrong?
26
26
 
27
27
  **Synthesize review strategy:**
28
- - Group changes by concern (correctness, security, style)
28
+ - Group changes by concern (correctness, security, style, spec compliance)
29
29
  - Prioritize findings (critical, important, minor)
30
30
  - Identify patterns across multiple files
31
31
  - Check domain language compliance and bounded context boundaries
@@ -35,13 +35,30 @@ Before reviewing, decompose code changes into atomic reasoning units:
35
35
  - If argument given: use those files/directories/description as scope
36
36
  - If no argument: run `git diff --stat` and `git diff --cached --stat` to find changes
37
37
  2. Determine the list of changed files and produce a scope summary
38
- 3. **Delegate to subagents in parallel:**
38
+ 3. **Detect spec context.** Look for a relevant plan:
39
+ - If `$ARGUMENTS` mentions a phase/task/plan number → load that PLAN.md
40
+ - If `.planning/STATE.md` references an in-progress phase → check its plans for tasks matching the diff
41
+ - If no plan applies → spec-reviewer is skipped
42
+ 4. **Delegate to subagents in parallel:**
39
43
  Use the `subagent` tool in **parallel mode** with these tasks:
40
- - `reviewer` agent: "Review the following code changes for correctness, type safety, conventions, and potential issues. Scope: <scope summary and file list>. Read each changed file to understand the changes. For each finding: cite the exact file and line, explain the issue, suggest the fix. Prioritize: Critical (must fix) > Important (should fix) > Minor (style/optional). Do NOT run draht, draht-tools, or pi commands."
41
- - `security-auditor` agent: "Audit the following code changes for security vulnerabilities. Scope: <scope summary and file list>. Read each changed file. Check for: injection risks, auth bypasses, secrets in code, unsafe deserialization, path traversal, prototype pollution. Report findings with severity, file, line, and recommendation. Do NOT run draht, draht-tools, or pi commands."
42
-
43
- 4. Collect and merge results from both subagents
44
- 5. Produce a unified, prioritized findings report:
45
- - **Critical** — must fix before merge (security, data loss, crashes)
46
- - **Important** — should fix (bugs, type issues, missing error handling)
47
- - **Minor** — style, naming, or optional improvements
44
+ - `reviewer` agent: "Review the following code changes for correctness, type safety, conventions, and potential issues. Scope: <scope summary and file list>. Read each changed file. For each finding: cite the exact file and line, explain the issue, suggest the fix. Prioritize: Critical / Important / Minor. End with `STATUS: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED`. Do NOT run draht, draht-tools, or pi commands."
45
+ - `security-auditor` agent: "Audit the following code changes for security vulnerabilities. Scope: <scope summary and file list>. Check injection, auth bypass, secrets, unsafe deserialization, path traversal, prototype pollution. Report severity / file / line / fix. End with `STATUS: ...`. Do NOT run draht, draht-tools, or pi commands."
46
+ - **(If spec context exists)** `spec-reviewer` agent: "Review the diff against plan at <plan file path>. ONLY spec compliance — does the diff implement exactly what the <test>/<action>/<done> sections asked? Flag omissions and over-builds. End with `STATUS: ...`."
47
+
48
+ 5. Read each subagent's final `STATUS:` line.
49
+ 6. Collect and merge results.
50
+ 7. Produce a unified, prioritized findings report:
51
+ - **Critical** — must fix before merge (security `BLOCKED`, spec gaps for required deliverables, correctness issues that cause data loss / crashes)
52
+ - **Important** — should fix (bugs, type issues, spec over-builds, missing error handling)
53
+ - **Minor** — style, naming, optional improvements
54
+
55
+ ## Reading STATUS
56
+ - Any `STATUS: BLOCKED` → its findings escalate to Critical in the merged report
57
+ - `STATUS: NEEDS_CONTEXT` → provide missing info and re-dispatch that one agent
58
+ - `STATUS: DONE` / `DONE_WITH_CONCERNS` are normal terminal states
59
+
60
+ ## Rules
61
+ - Cite file paths and line numbers precisely
62
+ - Do not restate the diff — focus on findings
63
+ - If no issues found, state that explicitly
64
+ - spec-reviewer only runs when a spec exists — ad-hoc reviews skip it
@@ -1,10 +1,10 @@
1
1
  ---
2
- description: "Acceptance testing of completed phase work"
2
+ description: "Acceptance testing of completed phase work (parallel verifier + security-auditor + reviewer + spec-reviewer)"
3
3
  ---
4
4
 
5
5
  # /verify-work
6
6
 
7
- Walk through acceptance testing of completed phase work, using subagents for parallel verification.
7
+ Walk through acceptance testing of completed phase work, using subagents for parallel verification — including a spec-compliance pass against the phase's plan files.
8
8
 
9
9
  ## Usage
10
10
  ```
@@ -23,30 +23,47 @@ Before verifying, decompose phase acceptance into atomic reasoning units:
23
23
  3. **Verify correctness** — What tests prove it works? What edge cases must pass? What security concerns exist?
24
24
 
25
25
  **Synthesize verification strategy:**
26
- - Group parallel verification tasks (test suite, security audit, code review, domain compliance)
27
- - Map each deliverable to specific test scenarios and acceptance criteria
26
+ - Group parallel verification tasks (test suite, security audit, code review, spec compliance, domain compliance)
27
+ - Map each deliverable to its plan file (the spec)
28
28
  - Identify critical vs optional checks
29
29
  - Plan fix strategies for potential failures
30
30
 
31
31
  ## Steps
32
32
  1. Run `draht-tools extract-deliverables $1` to get testable items
33
- 2. **Run parallel verification via subagents:**
33
+ 2. Discover the phase's plan files (`.planning/phases/<N>-*/<N>-NN-PLAN.md`). Each plan is the spec the spec-reviewer evaluates against.
34
+ 3. **Run parallel verification via subagents:**
34
35
  Use the `subagent` tool in **parallel mode** with these tasks:
35
- - `verifier` agent: "Run the full test suite for this project. Check package.json for the test command. Record pass/fail counts. Then run any available lint and typecheck commands (e.g. npm run check, npm run lint, npx tsc --noEmit). Report all results with error details. Do NOT run draht, draht-tools, or pi commands."
36
- - `security-auditor` agent: "Audit the recent code changes (use git log and git diff to find them). Check for injection risks, auth bypasses, secrets in code, unsafe patterns. Report findings by severity. Do NOT run draht, draht-tools, or pi commands."
37
- - `reviewer` agent: "Review the recent code changes (use git log and git diff). Check domain language compliance against `.planning/DOMAIN.md` if it exists — scan for identifiers not in the glossary and cross-context boundary violations. Report findings. Do NOT run draht, draht-tools, or pi commands."
38
-
39
- 3. Collect results from all subagents
40
- 4. Walk user through each deliverable one at a time, incorporating findings from the parallel checks
41
- 5. Record results (pass/fail/partially/skip)
42
- 6. For failures: diagnose and create fix plans via `draht-tools create-fix-plan $1 P`
36
+ - `verifier` agent: "Run the full test suite for this project. Check package.json for the test command. Record pass/fail counts. Then run any available lint and typecheck commands (e.g. npm run check, npm run lint, npx tsc --noEmit). Report all results with error details. End with `STATUS: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED`. Do NOT run draht, draht-tools, or pi commands."
37
+ - `security-auditor` agent: "Audit the recent code changes (use git log and git diff, scoped to this phase's commits). Check for injection risks, auth bypasses, secrets in code, unsafe patterns. Report findings by severity. End with `STATUS: ...`. Do NOT run draht, draht-tools, or pi commands."
38
+ - `reviewer` agent: "Review the recent code changes for this phase. Check domain language compliance against `.planning/DOMAIN.md` if it exists — scan for identifiers not in the glossary and cross-context boundary violations. Report Must fix / Should fix / Consider. End with `STATUS: ...`. Do NOT run draht, draht-tools, or pi commands."
39
+ - `spec-reviewer` agent: "Phase-level spec compliance check for phase $1. The phase has these plan files (each is a spec): <list of .planning/phases/<N>-*/<N>-NN-PLAN.md paths>. For each plan, evaluate whether the phase's commits implement exactly what the plan's <task> elements asked — no missing tasks, no over-builds. Use git log and git diff against the phase commit range. Output a per-plan compliance verdict with omissions and over-builds. End with `STATUS: ...`."
40
+
41
+ 4. **Read each subagent's `STATUS:` line.** Treat the phase as failed if any of these is `BLOCKED`:
42
+ - `verifier` (tests / lint / typecheck failed)
43
+ - `security-auditor` (Critical or High findings)
44
+ - `spec-reviewer` (any plan non-compliant)
45
+ - `reviewer` (Must-fix correctness issues)
46
+
47
+ 5. Collect results and walk user through each deliverable, incorporating findings.
48
+ 6. Record results (pass/fail/partially/skip).
49
+ 7. For failures: diagnose and create fix plans via `draht-tools create-fix-plan $1 P`
43
50
  - Fix plans MUST include a reproducing test that demonstrates the failure before any implementation
44
- 7. Write UAT report: `draht-tools write-uat $1`
45
- - Report must include: test health summary (pass/fail/coverage), security audit results, domain model status (any glossary violations), deliverable results
46
- 8. If all passed: mark phase complete.
51
+ - Spec-reviewer omissions become explicit fix-plan tasks (one task per omission)
52
+ 8. Write UAT report: `draht-tools write-uat $1`
53
+ - Report must include: test health summary (pass/fail/coverage), security audit results, **spec compliance summary per plan**, domain model status (any glossary violations), deliverable results
54
+ 9. If all passed: mark phase complete.
47
55
  - If more phases remain in the milestone: tell the user to start a new session and run `/discuss-phase N+1`.
48
56
  - If ALL phases in the milestone are complete: tell the user to start a new session and run `/next-milestone`.
49
- 9. If failures: route to `execute-phase $1 --gaps-only`
57
+ 10. If failures: route to `execute-phase $1 --gaps-only`
58
+
59
+ ## Why a phase-level spec-reviewer
60
+
61
+ `/execute-phase` already runs spec-reviewer **per task** before the next task starts. The phase-level pass here catches things the per-task loop can miss:
62
+ - A whole plan was skipped (no implementer ever ran on it)
63
+ - A task's commit was reverted or rebased away
64
+ - Out-of-scope drift that accumulated across multiple tasks
65
+
66
+ Cheap insurance — the diff and plans already exist; the agent maps one to the other.
50
67
 
51
68
  ## Workflow
52
69
  This is the last step in the per-phase cycle. Each step runs in its own session (`/new` between steps):