@draht/coding-agent 2026.10.20 → 2026.10.23-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 (744) hide show
  1. package/CHANGELOG.md +138 -0
  2. package/agents/advisor.md +2 -2
  3. package/agents/architect.md +11 -33
  4. package/agents/debugger.md +13 -54
  5. package/agents/git-committer.md +18 -42
  6. package/agents/implementer.md +14 -36
  7. package/agents/investigator.md +12 -63
  8. package/agents/reviewer.md +16 -44
  9. package/agents/security-auditor.md +22 -56
  10. package/agents/spec-reviewer.md +13 -53
  11. package/agents/verifier.md +14 -33
  12. package/bin/drahtbank.mjs +4 -0
  13. package/dist/agents/advisor.md +2 -2
  14. package/dist/agents/architect.md +11 -33
  15. package/dist/agents/debugger.md +13 -54
  16. package/dist/agents/git-committer.md +18 -42
  17. package/dist/agents/implementer.md +14 -36
  18. package/dist/agents/investigator.md +12 -63
  19. package/dist/agents/reviewer.md +16 -44
  20. package/dist/agents/security-auditor.md +22 -56
  21. package/dist/agents/spec-reviewer.md +13 -53
  22. package/dist/agents/verifier.md +14 -33
  23. package/dist/bundle/chunks/anthropic-messages-G57VPNTF.js +6 -0
  24. package/dist/bundle/chunks/anthropic.js +1 -1
  25. package/dist/bundle/chunks/azure-openai-responses-AYUCZ5WN.js +2 -0
  26. package/dist/bundle/chunks/bedrock-converse-stream.js +31 -28
  27. package/dist/bundle/chunks/chunk-2JZLKNZ4.js +3 -0
  28. package/dist/bundle/chunks/chunk-3GDEPGTR.js +16 -0
  29. package/dist/bundle/chunks/chunk-5JW3NSTV.js +2 -0
  30. package/dist/bundle/chunks/{chunk-KVH4HR57.js → chunk-6WESOD4H.js} +1 -1
  31. package/dist/bundle/chunks/chunk-76YNMQ57.js +2 -0
  32. package/dist/bundle/chunks/chunk-AC3MSTC6.js +2 -0
  33. package/dist/bundle/chunks/chunk-ACLWH5WQ.js +2 -0
  34. package/dist/bundle/chunks/chunk-BL72B6LV.js +82 -0
  35. package/dist/bundle/chunks/chunk-CLKG6K6Z.js +7 -0
  36. package/dist/bundle/chunks/chunk-DN7SM3LX.js +479 -0
  37. package/dist/bundle/chunks/{chunk-D6TMD5Q2.js → chunk-DOUMZTXH.js} +10 -10
  38. package/dist/bundle/chunks/chunk-DQ4G4IS4.js +20 -0
  39. package/dist/bundle/chunks/chunk-E4VZJRJ2.js +9 -0
  40. package/dist/bundle/chunks/chunk-FOYIPAAD.js +6 -0
  41. package/dist/bundle/chunks/chunk-FXCTQRNN.js +2 -0
  42. package/dist/bundle/chunks/chunk-GBFVS2SF.js +12 -0
  43. package/dist/bundle/chunks/chunk-GQXRTK54.js +20 -0
  44. package/dist/bundle/chunks/chunk-IGO52ZOY.js +132 -0
  45. package/dist/bundle/chunks/chunk-IT4RIOZD.js +2 -0
  46. package/dist/bundle/chunks/chunk-JJKPUMH2.js +1424 -0
  47. package/dist/bundle/chunks/chunk-JNWRE5F4.js +2 -0
  48. package/dist/bundle/chunks/chunk-KSGHCBHT.js +2 -0
  49. package/dist/bundle/chunks/chunk-LO6CVU2L.js +6 -0
  50. package/dist/bundle/chunks/chunk-MBFTIGLS.js +2 -0
  51. package/dist/bundle/chunks/chunk-N26RGV3K.js +11 -0
  52. package/dist/bundle/chunks/{chunk-KPO5375S.js → chunk-RCRGGYLW.js} +1 -1
  53. package/dist/bundle/chunks/chunk-UCJ7FLSO.js +166 -0
  54. package/dist/bundle/chunks/chunk-USCN7R2E.js +2 -0
  55. package/dist/bundle/chunks/chunk-WFHH5SX6.js +4 -0
  56. package/dist/bundle/chunks/chunk-WYWBXNDO.js +6 -0
  57. package/dist/bundle/chunks/chunk-ZRPAOMVB.js +2 -0
  58. package/dist/bundle/chunks/{cli-PYJB6AQ3.js → cli-HTUB6WOG.js} +6 -6
  59. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-RRSO6OXX.js +2 -0
  60. package/dist/bundle/chunks/codemode-worker.js +188 -21
  61. package/dist/bundle/chunks/execute-UUPNZJJG.js +31 -0
  62. package/dist/bundle/chunks/github-copilot.js +1 -1
  63. package/dist/bundle/chunks/google-generative-ai-VJSS5EBX.js +2 -0
  64. package/dist/bundle/chunks/google-vertex-K23DBWTT.js +2 -0
  65. package/dist/bundle/chunks/https-proxy-agent-WQIRL24U.js +13 -0
  66. package/dist/bundle/chunks/image-resize-worker.js +1 -1
  67. package/dist/bundle/chunks/lib-ULKZYRGD.js +9 -0
  68. package/dist/bundle/chunks/{llama-cpp-classify-EJ5XMSQL.js → llama-cpp-classify-3VDXTYVJ.js} +3 -3
  69. package/dist/bundle/chunks/mistral-conversations-SKVQJGFZ.js +5 -0
  70. package/dist/bundle/chunks/{multipart-parser-AZP5BX2W.js → multipart-parser-HMCXZ4BD.js} +1 -1
  71. package/dist/bundle/chunks/node-DXZFQBEO.js +16 -0
  72. package/dist/bundle/chunks/{node-C2JGH2OB.js → node-LBZLUIBE.js} +1 -1
  73. package/dist/bundle/chunks/openai-chatgpt.js +1 -1
  74. package/dist/bundle/chunks/openai-codex-responses-LV4RIZL3.js +10 -0
  75. package/dist/bundle/chunks/openai-codex.js +1 -1
  76. package/dist/bundle/chunks/openai-completions-PUIR2V25.js +7 -0
  77. package/dist/bundle/chunks/openai-decisions-2DJLSYQF.js +5 -0
  78. package/dist/bundle/chunks/openai-responses-6ESQOXAF.js +4 -0
  79. package/dist/bundle/chunks/opencode-go.js +1 -1
  80. package/dist/bundle/chunks/openrouter-images-TVXBMY3V.js +2 -0
  81. package/dist/bundle/chunks/pi-messages-XS7FDWQI.js +8 -0
  82. package/dist/bundle/chunks/runtime-IB3XQ7E3.js +2 -0
  83. package/dist/bundle/chunks/runtime-LB35PK4J.js +3 -0
  84. package/dist/bundle/chunks/settings-manager-YNY5F4RU.js +2 -0
  85. package/dist/bundle/chunks/src-KDGO7EGF.js +4 -0
  86. package/dist/bundle/chunks/typesafe-system-one-67GAWZXE.js +2 -0
  87. package/dist/bundle/chunks/virtual-modules-U4CBGVMI.js +2 -0
  88. package/dist/bundle/cli-runtime.js +1 -1
  89. package/dist/bundle/index.js +1 -1
  90. package/dist/bundle/rpc-entry.js +1 -1
  91. package/dist/cli/args.d.ts +2 -1
  92. package/dist/cli/args.d.ts.map +1 -1
  93. package/dist/cli/args.js +30 -8
  94. package/dist/cli/args.js.map +1 -1
  95. package/dist/cli/credential-print.d.ts.map +1 -1
  96. package/dist/cli/credential-print.js +4 -4
  97. package/dist/cli/credential-print.js.map +1 -1
  98. package/dist/config.d.ts +18 -1
  99. package/dist/config.d.ts.map +1 -1
  100. package/dist/config.js +44 -6
  101. package/dist/config.js.map +1 -1
  102. package/dist/core/agent-session.d.ts +65 -8
  103. package/dist/core/agent-session.d.ts.map +1 -1
  104. package/dist/core/agent-session.js +240 -102
  105. package/dist/core/agent-session.js.map +1 -1
  106. package/dist/core/auth-storage.d.ts.map +1 -1
  107. package/dist/core/auth-storage.js +20 -13
  108. package/dist/core/auth-storage.js.map +1 -1
  109. package/dist/core/bash-executor.d.ts.map +1 -1
  110. package/dist/core/bash-executor.js +42 -52
  111. package/dist/core/bash-executor.js.map +1 -1
  112. package/dist/core/bug-report.d.ts +9 -1
  113. package/dist/core/bug-report.d.ts.map +1 -1
  114. package/dist/core/builtins/completion-checks.d.ts +3 -0
  115. package/dist/core/builtins/completion-checks.d.ts.map +1 -0
  116. package/dist/core/builtins/completion-checks.js +142 -0
  117. package/dist/core/builtins/completion-checks.js.map +1 -0
  118. package/dist/core/builtins/duet.d.ts.map +1 -1
  119. package/dist/core/builtins/duet.js +7 -5
  120. package/dist/core/builtins/duet.js.map +1 -1
  121. package/dist/core/builtins/git-safety.d.ts +3 -0
  122. package/dist/core/builtins/git-safety.d.ts.map +1 -0
  123. package/dist/core/builtins/git-safety.js +34 -0
  124. package/dist/core/builtins/git-safety.js.map +1 -0
  125. package/dist/core/builtins/index.d.ts.map +1 -1
  126. package/dist/core/builtins/index.js +4 -0
  127. package/dist/core/builtins/index.js.map +1 -1
  128. package/dist/core/client-identity.d.ts +8 -0
  129. package/dist/core/client-identity.d.ts.map +1 -0
  130. package/dist/core/client-identity.js +15 -0
  131. package/dist/core/client-identity.js.map +1 -0
  132. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  133. package/dist/core/compaction/branch-summarization.js +1 -2
  134. package/dist/core/compaction/branch-summarization.js.map +1 -1
  135. package/dist/core/compaction/compaction.d.ts +2 -2
  136. package/dist/core/compaction/compaction.d.ts.map +1 -1
  137. package/dist/core/compaction/compaction.js +20 -15
  138. package/dist/core/compaction/compaction.js.map +1 -1
  139. package/dist/core/compaction/utils.d.ts +6 -0
  140. package/dist/core/compaction/utils.d.ts.map +1 -1
  141. package/dist/core/compaction/utils.js +7 -8
  142. package/dist/core/compaction/utils.js.map +1 -1
  143. package/dist/core/export-html/index.d.ts.map +1 -1
  144. package/dist/core/export-html/index.js +2 -0
  145. package/dist/core/export-html/index.js.map +1 -1
  146. package/dist/core/export-html/template.html +1 -0
  147. package/dist/core/export-html/template.js +23 -17
  148. package/dist/core/export-html/tool-renderer.d.ts +3 -3
  149. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  150. package/dist/core/export-html/tool-renderer.js +5 -3
  151. package/dist/core/export-html/tool-renderer.js.map +1 -1
  152. package/dist/core/export-html/vendor/marked-cjk-friendly.min.js +6 -0
  153. package/dist/core/export-html/vendor/marked.min.js +30 -29
  154. package/dist/core/extensions/index.d.ts +1 -1
  155. package/dist/core/extensions/index.d.ts.map +1 -1
  156. package/dist/core/extensions/index.js.map +1 -1
  157. package/dist/core/extensions/loader.d.ts.map +1 -1
  158. package/dist/core/extensions/loader.js +7 -0
  159. package/dist/core/extensions/loader.js.map +1 -1
  160. package/dist/core/extensions/runner.d.ts +6 -2
  161. package/dist/core/extensions/runner.d.ts.map +1 -1
  162. package/dist/core/extensions/runner.js +16 -4
  163. package/dist/core/extensions/runner.js.map +1 -1
  164. package/dist/core/extensions/types.d.ts +61 -7
  165. package/dist/core/extensions/types.d.ts.map +1 -1
  166. package/dist/core/extensions/types.js.map +1 -1
  167. package/dist/core/extensions/virtual-modules.d.ts.map +1 -1
  168. package/dist/core/extensions/virtual-modules.js +2 -0
  169. package/dist/core/extensions/virtual-modules.js.map +1 -1
  170. package/dist/core/key-id-schema.d.ts +6 -0
  171. package/dist/core/key-id-schema.d.ts.map +1 -0
  172. package/dist/core/key-id-schema.js +16 -0
  173. package/dist/core/key-id-schema.js.map +1 -0
  174. package/dist/core/keybindings-schema.d.ts +4 -0
  175. package/dist/core/keybindings-schema.d.ts.map +1 -0
  176. package/dist/core/keybindings-schema.js +16 -0
  177. package/dist/core/keybindings-schema.js.map +1 -0
  178. package/dist/core/keybindings.d.ts +242 -75
  179. package/dist/core/keybindings.d.ts.map +1 -1
  180. package/dist/core/keybindings.js +30 -23
  181. package/dist/core/keybindings.js.map +1 -1
  182. package/dist/core/mcp-servers.d.ts +22 -0
  183. package/dist/core/mcp-servers.d.ts.map +1 -1
  184. package/dist/core/mcp-servers.js +72 -11
  185. package/dist/core/mcp-servers.js.map +1 -1
  186. package/dist/core/model-config.d.ts +1623 -74
  187. package/dist/core/model-config.d.ts.map +1 -1
  188. package/dist/core/model-config.js +70 -184
  189. package/dist/core/model-config.js.map +1 -1
  190. package/dist/core/model-registry.d.ts +3 -1
  191. package/dist/core/model-registry.d.ts.map +1 -1
  192. package/dist/core/model-registry.js +4 -0
  193. package/dist/core/model-registry.js.map +1 -1
  194. package/dist/core/model-resolver.d.ts +56 -43
  195. package/dist/core/model-resolver.d.ts.map +1 -1
  196. package/dist/core/model-resolver.js +253 -358
  197. package/dist/core/model-resolver.js.map +1 -1
  198. package/dist/core/model-runtime.d.ts.map +1 -1
  199. package/dist/core/model-runtime.js +19 -10
  200. package/dist/core/model-runtime.js.map +1 -1
  201. package/dist/core/nested-tool-calls.d.ts +1 -0
  202. package/dist/core/nested-tool-calls.d.ts.map +1 -1
  203. package/dist/core/nested-tool-calls.js +1 -0
  204. package/dist/core/nested-tool-calls.js.map +1 -1
  205. package/dist/core/package-manager.js +3 -3
  206. package/dist/core/package-manager.js.map +1 -1
  207. package/dist/core/polyphase/keyword.js +1 -1
  208. package/dist/core/polyphase/keyword.js.map +1 -1
  209. package/dist/core/polyphase/model-selection.d.ts.map +1 -1
  210. package/dist/core/polyphase/model-selection.js +15 -7
  211. package/dist/core/polyphase/model-selection.js.map +1 -1
  212. package/dist/core/polyphase/workflow/prelude.d.ts +2 -0
  213. package/dist/core/polyphase/workflow/prelude.d.ts.map +1 -1
  214. package/dist/core/polyphase/workflow/prelude.js +12 -16
  215. package/dist/core/polyphase/workflow/prelude.js.map +1 -1
  216. package/dist/core/polyphase/workflow/runtime.d.ts.map +1 -1
  217. package/dist/core/polyphase/workflow/runtime.js +2 -1
  218. package/dist/core/polyphase/workflow/runtime.js.map +1 -1
  219. package/dist/core/project-trust.d.ts.map +1 -1
  220. package/dist/core/project-trust.js +2 -1
  221. package/dist/core/project-trust.js.map +1 -1
  222. package/dist/core/prompt-templates.d.ts.map +1 -1
  223. package/dist/core/prompt-templates.js +7 -2
  224. package/dist/core/prompt-templates.js.map +1 -1
  225. package/dist/core/provider-composer.d.ts +2 -1
  226. package/dist/core/provider-composer.d.ts.map +1 -1
  227. package/dist/core/provider-composer.js +13 -0
  228. package/dist/core/provider-composer.js.map +1 -1
  229. package/dist/core/radius.d.ts +2 -0
  230. package/dist/core/radius.d.ts.map +1 -1
  231. package/dist/core/radius.js +2 -0
  232. package/dist/core/radius.js.map +1 -1
  233. package/dist/core/remote-catalog-provider.d.ts +12 -1
  234. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  235. package/dist/core/remote-catalog-provider.js +84 -24
  236. package/dist/core/remote-catalog-provider.js.map +1 -1
  237. package/dist/core/resource-loader.d.ts +3 -0
  238. package/dist/core/resource-loader.d.ts.map +1 -1
  239. package/dist/core/resource-loader.js +7 -4
  240. package/dist/core/resource-loader.js.map +1 -1
  241. package/dist/core/sdk.d.ts +13 -4
  242. package/dist/core/sdk.d.ts.map +1 -1
  243. package/dist/core/sdk.js +27 -15
  244. package/dist/core/sdk.js.map +1 -1
  245. package/dist/core/settings-defaults.d.ts +65 -0
  246. package/dist/core/settings-defaults.d.ts.map +1 -0
  247. package/dist/core/settings-defaults.js +66 -0
  248. package/dist/core/settings-defaults.js.map +1 -0
  249. package/dist/core/settings-manager.d.ts +17 -178
  250. package/dist/core/settings-manager.d.ts.map +1 -1
  251. package/dist/core/settings-manager.js +86 -57
  252. package/dist/core/settings-manager.js.map +1 -1
  253. package/dist/core/settings-schema.d.ts +269 -0
  254. package/dist/core/settings-schema.d.ts.map +1 -0
  255. package/dist/core/settings-schema.js +318 -0
  256. package/dist/core/settings-schema.js.map +1 -0
  257. package/dist/core/skills.d.ts +4 -1
  258. package/dist/core/skills.d.ts.map +1 -1
  259. package/dist/core/skills.js +6 -1
  260. package/dist/core/skills.js.map +1 -1
  261. package/dist/core/system-prompt.d.ts +6 -0
  262. package/dist/core/system-prompt.d.ts.map +1 -1
  263. package/dist/core/system-prompt.js +10 -5
  264. package/dist/core/system-prompt.js.map +1 -1
  265. package/dist/core/tools/bash.d.ts.map +1 -1
  266. package/dist/core/tools/bash.js +3 -5
  267. package/dist/core/tools/bash.js.map +1 -1
  268. package/dist/core/tools/grep.d.ts +8 -0
  269. package/dist/core/tools/grep.d.ts.map +1 -1
  270. package/dist/core/tools/grep.js +19 -7
  271. package/dist/core/tools/grep.js.map +1 -1
  272. package/dist/core/tools/index.d.ts +2 -0
  273. package/dist/core/tools/index.d.ts.map +1 -1
  274. package/dist/core/tools/index.js +2 -0
  275. package/dist/core/tools/index.js.map +1 -1
  276. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  277. package/dist/core/tools/output-accumulator.js +4 -10
  278. package/dist/core/tools/output-accumulator.js.map +1 -1
  279. package/dist/core/tools/path-utils.d.ts +1 -1
  280. package/dist/core/tools/path-utils.d.ts.map +1 -1
  281. package/dist/core/tools/path-utils.js +6 -6
  282. package/dist/core/tools/path-utils.js.map +1 -1
  283. package/dist/core/tools/read.d.ts +13 -0
  284. package/dist/core/tools/read.d.ts.map +1 -1
  285. package/dist/core/tools/read.js +32 -2
  286. package/dist/core/tools/read.js.map +1 -1
  287. package/dist/core/tools/render-utils.d.ts +20 -0
  288. package/dist/core/tools/render-utils.d.ts.map +1 -1
  289. package/dist/core/tools/render-utils.js +67 -0
  290. package/dist/core/tools/render-utils.js.map +1 -1
  291. package/dist/core/tools/renderers/bash.d.ts.map +1 -1
  292. package/dist/core/tools/renderers/bash.js +7 -35
  293. package/dist/core/tools/renderers/bash.js.map +1 -1
  294. package/dist/core/tools/renderers/edit.d.ts.map +1 -1
  295. package/dist/core/tools/renderers/edit.js +5 -4
  296. package/dist/core/tools/renderers/edit.js.map +1 -1
  297. package/dist/core/tools/renderers/index.d.ts +2 -2
  298. package/dist/core/tools/renderers/index.d.ts.map +1 -1
  299. package/dist/core/tools/renderers/index.js.map +1 -1
  300. package/dist/core/tools/renderers/read.d.ts.map +1 -1
  301. package/dist/core/tools/renderers/read.js +7 -11
  302. package/dist/core/tools/renderers/read.js.map +1 -1
  303. package/dist/extensions/codemode/execute.d.ts.map +1 -1
  304. package/dist/extensions/codemode/execute.js +391 -80
  305. package/dist/extensions/codemode/execute.js.map +1 -1
  306. package/dist/extensions/codemode/index.d.ts.map +1 -1
  307. package/dist/extensions/codemode/index.js +3 -1
  308. package/dist/extensions/codemode/index.js.map +1 -1
  309. package/dist/extensions/codemode/renderer.d.ts +2 -2
  310. package/dist/extensions/codemode/renderer.d.ts.map +1 -1
  311. package/dist/extensions/codemode/renderer.js +9 -3
  312. package/dist/extensions/codemode/renderer.js.map +1 -1
  313. package/dist/extensions/codemode/tool.d.ts +22 -21
  314. package/dist/extensions/codemode/tool.d.ts.map +1 -1
  315. package/dist/extensions/codemode/tool.js +96 -123
  316. package/dist/extensions/codemode/tool.js.map +1 -1
  317. package/dist/extensions/llama/provider.d.ts.map +1 -1
  318. package/dist/extensions/llama/provider.js +34 -11
  319. package/dist/extensions/llama/provider.js.map +1 -1
  320. package/dist/extensions/mcp/cli.d.ts.map +1 -1
  321. package/dist/extensions/mcp/cli.js +27 -33
  322. package/dist/extensions/mcp/cli.js.map +1 -1
  323. package/dist/extensions/mcp/config.d.ts +15 -3
  324. package/dist/extensions/mcp/config.d.ts.map +1 -1
  325. package/dist/extensions/mcp/config.js +49 -12
  326. package/dist/extensions/mcp/config.js.map +1 -1
  327. package/dist/extensions/mcp/index.d.ts +4 -1
  328. package/dist/extensions/mcp/index.d.ts.map +1 -1
  329. package/dist/extensions/mcp/index.js +279 -129
  330. package/dist/extensions/mcp/index.js.map +1 -1
  331. package/dist/extensions/mcp/oauth.d.ts +21 -11
  332. package/dist/extensions/mcp/oauth.d.ts.map +1 -1
  333. package/dist/extensions/mcp/oauth.js +166 -45
  334. package/dist/extensions/mcp/oauth.js.map +1 -1
  335. package/dist/extensions/mcp/resources.d.ts +3 -10
  336. package/dist/extensions/mcp/resources.d.ts.map +1 -1
  337. package/dist/extensions/mcp/resources.js +4 -5
  338. package/dist/extensions/mcp/resources.js.map +1 -1
  339. package/dist/extensions/mcp/runtime.d.ts +7 -7
  340. package/dist/extensions/mcp/runtime.d.ts.map +1 -1
  341. package/dist/extensions/mcp/runtime.js +31 -45
  342. package/dist/extensions/mcp/runtime.js.map +1 -1
  343. package/dist/extensions/mcp/tools.d.ts +7 -5
  344. package/dist/extensions/mcp/tools.d.ts.map +1 -1
  345. package/dist/extensions/mcp/tools.js +87 -29
  346. package/dist/extensions/mcp/tools.js.map +1 -1
  347. package/dist/extensions/mcp/ui.d.ts +3 -3
  348. package/dist/extensions/mcp/ui.d.ts.map +1 -1
  349. package/dist/extensions/mcp/ui.js +18 -6
  350. package/dist/extensions/mcp/ui.js.map +1 -1
  351. package/dist/extensions/tool-search/tool.d.ts +0 -2
  352. package/dist/extensions/tool-search/tool.d.ts.map +1 -1
  353. package/dist/extensions/tool-search/tool.js +2 -4
  354. package/dist/extensions/tool-search/tool.js.map +1 -1
  355. package/dist/hooks/checks/checks-runtime.cjs +215 -0
  356. package/dist/hooks/checks/git-safety.cjs +198 -0
  357. package/dist/hooks/checks/git-safety.d.cts +1 -0
  358. package/dist/hooks/gsd/draht-post-task.js +78 -39
  359. package/dist/hooks/gsd/draht-quality-gate.js +210 -122
  360. package/dist/hooks/gsd/package.json +3 -0
  361. package/dist/index.d.ts +5 -4
  362. package/dist/index.d.ts.map +1 -1
  363. package/dist/index.js +3 -2
  364. package/dist/index.js.map +1 -1
  365. package/dist/main.d.ts.map +1 -1
  366. package/dist/main.js +11 -3
  367. package/dist/main.js.map +1 -1
  368. package/dist/modes/interactive/components/auth-url.d.ts +14 -0
  369. package/dist/modes/interactive/components/auth-url.d.ts.map +1 -0
  370. package/dist/modes/interactive/components/auth-url.js +37 -0
  371. package/dist/modes/interactive/components/auth-url.js.map +1 -0
  372. package/dist/modes/interactive/components/bash-execution.d.ts +5 -1
  373. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  374. package/dist/modes/interactive/components/bash-execution.js +17 -14
  375. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  376. package/dist/modes/interactive/components/branch-summary-message.d.ts +2 -1
  377. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
  378. package/dist/modes/interactive/components/branch-summary-message.js +5 -2
  379. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
  380. package/dist/modes/interactive/components/compaction-summary-message.d.ts +2 -1
  381. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
  382. package/dist/modes/interactive/components/compaction-summary-message.js +5 -2
  383. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
  384. package/dist/modes/interactive/components/custom-entry.d.ts +3 -1
  385. package/dist/modes/interactive/components/custom-entry.d.ts.map +1 -1
  386. package/dist/modes/interactive/components/custom-entry.js +8 -2
  387. package/dist/modes/interactive/components/custom-entry.js.map +1 -1
  388. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  389. package/dist/modes/interactive/components/custom-message.js +1 -0
  390. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  391. package/dist/modes/interactive/components/login-dialog.d.ts +3 -0
  392. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  393. package/dist/modes/interactive/components/login-dialog.js +38 -10
  394. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  395. package/dist/modes/interactive/components/oauth-selector.d.ts +8 -2
  396. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  397. package/dist/modes/interactive/components/oauth-selector.js +24 -21
  398. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  399. package/dist/modes/interactive/components/radius-login-selector.d.ts +15 -0
  400. package/dist/modes/interactive/components/radius-login-selector.d.ts.map +1 -0
  401. package/dist/modes/interactive/components/radius-login-selector.js +85 -0
  402. package/dist/modes/interactive/components/radius-login-selector.js.map +1 -0
  403. package/dist/modes/interactive/components/settings-selector.d.ts +3 -3
  404. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  405. package/dist/modes/interactive/components/settings-selector.js +9 -8
  406. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  407. package/dist/modes/interactive/components/skill-invocation-message.d.ts +2 -1
  408. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  409. package/dist/modes/interactive/components/skill-invocation-message.js +5 -2
  410. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  411. package/dist/modes/interactive/components/status-indicator.d.ts +1 -1
  412. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
  413. package/dist/modes/interactive/components/status-indicator.js +2 -2
  414. package/dist/modes/interactive/components/status-indicator.js.map +1 -1
  415. package/dist/modes/interactive/components/tool-execution.d.ts +12 -13
  416. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  417. package/dist/modes/interactive/components/tool-execution.js +32 -45
  418. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  419. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  420. package/dist/modes/interactive/components/tree-selector.js +2 -9
  421. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  422. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  423. package/dist/modes/interactive/components/user-message.js +5 -4
  424. package/dist/modes/interactive/components/user-message.js.map +1 -1
  425. package/dist/modes/interactive/interactive-mode.d.ts +43 -48
  426. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  427. package/dist/modes/interactive/interactive-mode.js +362 -278
  428. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  429. package/dist/modes/interactive/program-status-reporter.d.ts +34 -0
  430. package/dist/modes/interactive/program-status-reporter.d.ts.map +1 -0
  431. package/dist/modes/interactive/program-status-reporter.js +110 -0
  432. package/dist/modes/interactive/program-status-reporter.js.map +1 -0
  433. package/dist/modes/interactive/theme/dark.json +1 -1
  434. package/dist/modes/interactive/theme/light.json +1 -1
  435. package/dist/modes/interactive/theme/system-theme.d.ts +2 -1
  436. package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -1
  437. package/dist/modes/interactive/theme/system-theme.js +16 -5
  438. package/dist/modes/interactive/theme/system-theme.js.map +1 -1
  439. package/dist/modes/interactive/theme/theme-schema.d.ts +28 -0
  440. package/dist/modes/interactive/theme/theme-schema.d.ts.map +1 -0
  441. package/dist/modes/interactive/theme/theme-schema.js +105 -0
  442. package/dist/modes/interactive/theme/theme-schema.js.map +1 -0
  443. package/dist/modes/interactive/theme/theme-tokens.d.ts +257 -0
  444. package/dist/modes/interactive/theme/theme-tokens.d.ts.map +1 -0
  445. package/dist/modes/interactive/theme/theme-tokens.js +94 -0
  446. package/dist/modes/interactive/theme/theme-tokens.js.map +1 -0
  447. package/dist/modes/interactive/theme/theme.d.ts +13 -16
  448. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  449. package/dist/modes/interactive/theme/theme.js +22 -29
  450. package/dist/modes/interactive/theme/theme.js.map +1 -1
  451. package/dist/modes/print-mode.d.ts.map +1 -1
  452. package/dist/modes/print-mode.js +4 -0
  453. package/dist/modes/print-mode.js.map +1 -1
  454. package/dist/package-manager-cli.d.ts.map +1 -1
  455. package/dist/package-manager-cli.js +26 -1
  456. package/dist/package-manager-cli.js.map +1 -1
  457. package/dist/prompts/commands/atomic-commit.md +8 -6
  458. package/dist/prompts/commands/brainstorm.md +5 -149
  459. package/dist/prompts/commands/create-verification-skill.md +8 -48
  460. package/dist/prompts/commands/discuss-phase.md +6 -10
  461. package/dist/prompts/commands/execute-phase.md +18 -45
  462. package/dist/prompts/commands/fix.md +16 -128
  463. package/dist/prompts/commands/grill.md +6 -53
  464. package/dist/prompts/commands/init-project.md +13 -18
  465. package/dist/prompts/commands/map-codebase.md +3 -3
  466. package/dist/prompts/commands/new-project.md +12 -17
  467. package/dist/prompts/commands/next-milestone.md +4 -8
  468. package/dist/prompts/commands/orchestrate-loop.md +12 -12
  469. package/dist/prompts/commands/orchestrate.md +12 -11
  470. package/dist/prompts/commands/pause-work.md +1 -1
  471. package/dist/prompts/commands/plan-phase.md +15 -37
  472. package/dist/prompts/commands/quick.md +11 -64
  473. package/dist/prompts/commands/resolve-conflicts.md +2 -15
  474. package/dist/prompts/commands/triage.md +3 -14
  475. package/dist/prompts/commands/verify-work.md +15 -63
  476. package/dist/prompts/commands/why.md +18 -118
  477. package/dist/skills/atomic-reasoning/SKILL.md +6 -105
  478. package/dist/skills/blast-radius/SKILL.md +1 -1
  479. package/dist/skills/epistemics/SKILL.md +12 -87
  480. package/dist/skills/explainers/SKILL.md +1 -1
  481. package/dist/skills/typescript-discipline/SKILL.md +12 -42
  482. package/dist/skills/typescript-discipline/references/patterns.md +25 -266
  483. package/dist/skills/unslop/SKILL.md +14 -105
  484. package/dist/utils/ansi.d.ts +8 -0
  485. package/dist/utils/ansi.d.ts.map +1 -1
  486. package/dist/utils/ansi.js +30 -11
  487. package/dist/utils/ansi.js.map +1 -1
  488. package/dist/utils/clipboard-command.d.ts.map +1 -1
  489. package/dist/utils/clipboard-command.js +3 -0
  490. package/dist/utils/clipboard-command.js.map +1 -1
  491. package/dist/utils/clipboard.d.ts.map +1 -1
  492. package/dist/utils/clipboard.js +18 -12
  493. package/dist/utils/clipboard.js.map +1 -1
  494. package/dist/utils/draht-user-agent.d.ts +1 -0
  495. package/dist/utils/draht-user-agent.d.ts.map +1 -1
  496. package/dist/utils/draht-user-agent.js +3 -2
  497. package/dist/utils/draht-user-agent.js.map +1 -1
  498. package/dist/utils/image-convert.d.ts +12 -0
  499. package/dist/utils/image-convert.d.ts.map +1 -1
  500. package/dist/utils/image-convert.js +45 -6
  501. package/dist/utils/image-convert.js.map +1 -1
  502. package/dist/utils/image-resize-core.d.ts +12 -0
  503. package/dist/utils/image-resize-core.d.ts.map +1 -1
  504. package/dist/utils/image-resize-core.js +5 -0
  505. package/dist/utils/image-resize-core.js.map +1 -1
  506. package/dist/utils/image-resize-worker.js +3 -2
  507. package/dist/utils/image-resize-worker.js.map +1 -1
  508. package/dist/utils/image-resize.d.ts.map +1 -1
  509. package/dist/utils/image-resize.js +9 -10
  510. package/dist/utils/image-resize.js.map +1 -1
  511. package/dist/utils/output-files.d.ts +15 -0
  512. package/dist/utils/output-files.d.ts.map +1 -0
  513. package/dist/utils/output-files.js +30 -0
  514. package/dist/utils/output-files.js.map +1 -0
  515. package/dist/utils/shell.d.ts.map +1 -1
  516. package/dist/utils/shell.js +43 -13
  517. package/dist/utils/shell.js.map +1 -1
  518. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  519. package/dist/utils/syntax-highlight.js +6 -1
  520. package/dist/utils/syntax-highlight.js.map +1 -1
  521. package/dist/utils/tools-manager.d.ts.map +1 -1
  522. package/dist/utils/tools-manager.js +4 -3
  523. package/dist/utils/tools-manager.js.map +1 -1
  524. package/docs/cli-integration.md +1 -1
  525. package/docs/cli.md +30 -26
  526. package/docs/codemode.md +230 -0
  527. package/docs/compaction.md +5 -5
  528. package/docs/containerization.md +1 -1
  529. package/docs/custom-provider.md +53 -1
  530. package/docs/docs.json +17 -1
  531. package/docs/drahtbank.md +163 -0
  532. package/docs/environment-variables.md +5 -2
  533. package/docs/extensions.md +143 -13
  534. package/docs/index.md +1 -1
  535. package/docs/json.md +3 -3
  536. package/docs/keybindings.md +9 -5
  537. package/docs/llama-cpp.md +9 -2
  538. package/docs/mcp.md +59 -3
  539. package/docs/message-types.md +22 -4
  540. package/docs/models-configuration.md +187 -0
  541. package/docs/models.md +67 -4
  542. package/docs/nvidia-rtx-llama-cpp.md +96 -0
  543. package/docs/providers.md +70 -5
  544. package/docs/sdk.md +1 -1
  545. package/docs/settings.md +10 -8
  546. package/docs/terminal-setup.md +14 -0
  547. package/docs/themes.md +4 -2
  548. package/docs/tui.md +71 -1
  549. package/docs/usage.md +1 -1
  550. package/docs/windows.md +16 -2
  551. package/eval/drahtbank/adapters.d.mts +35 -0
  552. package/eval/drahtbank/adapters.mjs +192 -0
  553. package/eval/drahtbank/bank.d.mts +141 -0
  554. package/eval/drahtbank/bank.mjs +515 -0
  555. package/eval/drahtbank/cases-v2.d.mts +28 -0
  556. package/eval/drahtbank/cases-v2.mjs +164 -0
  557. package/eval/drahtbank/cases.d.mts +17 -0
  558. package/eval/drahtbank/cases.mjs +198 -0
  559. package/eval/drahtbank/cli.mjs +120 -0
  560. package/eval/drahtbank/grading-v2.d.mts +26 -0
  561. package/eval/drahtbank/grading-v2.mjs +227 -0
  562. package/eval/drahtbank/isolated-tools.ts +223 -0
  563. package/eval/drahtbank/isolation-worker.mjs +53 -0
  564. package/eval/drahtbank/isolation.d.mts +52 -0
  565. package/eval/drahtbank/isolation.mjs +345 -0
  566. package/eval/drahtbank/runtime-checks.d.mts +15 -0
  567. package/eval/drahtbank/runtime-checks.mjs +187 -0
  568. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  569. package/examples/extensions/minimal-mode.ts +4 -5
  570. package/examples/extensions/overlay-test.ts +2 -2
  571. package/examples/extensions/plan-mode/index.ts +6 -2
  572. package/examples/extensions/subagent/index.ts +4 -6
  573. package/hooks/checks/checks-runtime.cjs +215 -0
  574. package/hooks/checks/git-safety.cjs +198 -0
  575. package/hooks/checks/git-safety.d.cts +1 -0
  576. package/hooks/gsd/draht-post-task.js +78 -39
  577. package/hooks/gsd/draht-quality-gate.js +210 -122
  578. package/hooks/gsd/package.json +3 -0
  579. package/package.json +21 -16
  580. package/prompts/commands/atomic-commit.md +8 -6
  581. package/prompts/commands/brainstorm.md +5 -149
  582. package/prompts/commands/create-verification-skill.md +8 -48
  583. package/prompts/commands/discuss-phase.md +6 -10
  584. package/prompts/commands/execute-phase.md +18 -45
  585. package/prompts/commands/fix.md +16 -128
  586. package/prompts/commands/grill.md +6 -53
  587. package/prompts/commands/init-project.md +13 -18
  588. package/prompts/commands/map-codebase.md +3 -3
  589. package/prompts/commands/new-project.md +12 -17
  590. package/prompts/commands/next-milestone.md +4 -8
  591. package/prompts/commands/orchestrate-loop.md +12 -12
  592. package/prompts/commands/orchestrate.md +12 -11
  593. package/prompts/commands/pause-work.md +1 -1
  594. package/prompts/commands/plan-phase.md +15 -37
  595. package/prompts/commands/quick.md +11 -64
  596. package/prompts/commands/resolve-conflicts.md +2 -15
  597. package/prompts/commands/triage.md +3 -14
  598. package/prompts/commands/verify-work.md +15 -63
  599. package/prompts/commands/why.md +18 -118
  600. package/schemas/keybindings.schema.json +433 -0
  601. package/schemas/models.schema.json +1190 -0
  602. package/schemas/settings.schema.json +849 -0
  603. package/schemas/theme.schema.json +365 -0
  604. package/skills/atomic-reasoning/SKILL.md +6 -105
  605. package/skills/blast-radius/SKILL.md +1 -1
  606. package/skills/epistemics/SKILL.md +12 -87
  607. package/skills/explainers/SKILL.md +1 -1
  608. package/skills/typescript-discipline/SKILL.md +12 -42
  609. package/skills/typescript-discipline/references/patterns.md +25 -266
  610. package/skills/unslop/SKILL.md +14 -105
  611. package/dist/bundle/chunks/anthropic-messages-GAKYXF65.js +0 -6
  612. package/dist/bundle/chunks/azure-openai-responses-ZIXMK6JO.js +0 -2
  613. package/dist/bundle/chunks/chunk-2E5VODES.js +0 -2
  614. package/dist/bundle/chunks/chunk-2VAF4XJI.js +0 -146
  615. package/dist/bundle/chunks/chunk-4TVQYRQY.js +0 -2
  616. package/dist/bundle/chunks/chunk-6MSE6LZ3.js +0 -6
  617. package/dist/bundle/chunks/chunk-6ZJKIMU7.js +0 -2
  618. package/dist/bundle/chunks/chunk-736QBNUZ.js +0 -12
  619. package/dist/bundle/chunks/chunk-7TYCZN4Z.js +0 -137
  620. package/dist/bundle/chunks/chunk-BXSHCX3G.js +0 -11
  621. package/dist/bundle/chunks/chunk-GVXA72ZA.js +0 -2
  622. package/dist/bundle/chunks/chunk-I5OKY6RH.js +0 -11
  623. package/dist/bundle/chunks/chunk-IWTUBX6V.js +0 -4
  624. package/dist/bundle/chunks/chunk-KU5HAKZL.js +0 -4
  625. package/dist/bundle/chunks/chunk-MO3SCGBN.js +0 -18
  626. package/dist/bundle/chunks/chunk-N2QZNJT6.js +0 -65
  627. package/dist/bundle/chunks/chunk-PGJAHC3R.js +0 -107
  628. package/dist/bundle/chunks/chunk-QVFELZW2.js +0 -312
  629. package/dist/bundle/chunks/chunk-RZKPFWMH.js +0 -42
  630. package/dist/bundle/chunks/chunk-SDRCE6OP.js +0 -2
  631. package/dist/bundle/chunks/chunk-SVNWI7EV.js +0 -8
  632. package/dist/bundle/chunks/chunk-TIA2T6EO.js +0 -3
  633. package/dist/bundle/chunks/chunk-TOWVIJ2O.js +0 -1623
  634. package/dist/bundle/chunks/chunk-XBUEMKIY.js +0 -2
  635. package/dist/bundle/chunks/chunk-ZA4QNPJY.js +0 -82
  636. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +0 -2
  637. package/dist/bundle/chunks/execute-6N7T7VLY.js +0 -18
  638. package/dist/bundle/chunks/google-generative-ai-RPUPQ6PM.js +0 -2
  639. package/dist/bundle/chunks/google-vertex-EZES5QVQ.js +0 -2
  640. package/dist/bundle/chunks/https-proxy-agent-O2PVUIOI.js +0 -13
  641. package/dist/bundle/chunks/lib-XOG5PI3Y.js +0 -9
  642. package/dist/bundle/chunks/mistral-conversations-AOYGU43Y.js +0 -5
  643. package/dist/bundle/chunks/node-LQ52KV6B.js +0 -16
  644. package/dist/bundle/chunks/openai-codex-responses-M2Y77JEQ.js +0 -10
  645. package/dist/bundle/chunks/openai-completions-A4OKYOYV.js +0 -7
  646. package/dist/bundle/chunks/openai-responses-6IXV53T3.js +0 -3
  647. package/dist/bundle/chunks/openrouter-images-LYV4NKFM.js +0 -2
  648. package/dist/bundle/chunks/pi-messages-KKMEUT3Z.js +0 -8
  649. package/dist/bundle/chunks/runtime-363BOYEO.js +0 -3
  650. package/dist/bundle/chunks/runtime-D3KV73AE.js +0 -2
  651. package/dist/bundle/chunks/settings-manager-GEOZJXFQ.js +0 -2
  652. package/dist/bundle/chunks/src-TIBHS42X.js +0 -4
  653. package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +0 -2
  654. package/dist/bundle/chunks/virtual-modules-RLC4Y5MX.js +0 -2
  655. package/dist/core/provider-attribution.d.ts +0 -4
  656. package/dist/core/provider-attribution.d.ts.map +0 -1
  657. package/dist/core/provider-attribution.js +0 -72
  658. package/dist/core/provider-attribution.js.map +0 -1
  659. package/dist/experimental/micro/api.d.ts +0 -81
  660. package/dist/experimental/micro/api.d.ts.map +0 -1
  661. package/dist/experimental/micro/api.js +0 -2
  662. package/dist/experimental/micro/api.js.map +0 -1
  663. package/dist/experimental/micro/main.d.ts +0 -3
  664. package/dist/experimental/micro/main.d.ts.map +0 -1
  665. package/dist/experimental/micro/main.js +0 -21
  666. package/dist/experimental/micro/main.js.map +0 -1
  667. package/dist/experimental/micro/models.d.ts +0 -11
  668. package/dist/experimental/micro/models.d.ts.map +0 -1
  669. package/dist/experimental/micro/models.js +0 -95
  670. package/dist/experimental/micro/models.js.map +0 -1
  671. package/dist/experimental/micro/runtime.d.ts +0 -12
  672. package/dist/experimental/micro/runtime.d.ts.map +0 -1
  673. package/dist/experimental/micro/runtime.js +0 -465
  674. package/dist/experimental/micro/runtime.js.map +0 -1
  675. package/dist/experimental/micro/sessions.d.ts +0 -10
  676. package/dist/experimental/micro/sessions.d.ts.map +0 -1
  677. package/dist/experimental/micro/sessions.js +0 -41
  678. package/dist/experimental/micro/sessions.js.map +0 -1
  679. package/dist/experimental/micro/tools.d.ts +0 -10
  680. package/dist/experimental/micro/tools.d.ts.map +0 -1
  681. package/dist/experimental/micro/tools.js +0 -96
  682. package/dist/experimental/micro/tools.js.map +0 -1
  683. package/dist/experimental/micro/tui.d.ts +0 -3
  684. package/dist/experimental/micro/tui.d.ts.map +0 -1
  685. package/dist/experimental/micro/tui.js +0 -510
  686. package/dist/experimental/micro/tui.js.map +0 -1
  687. package/dist/experimental/mini/main.d.ts +0 -7
  688. package/dist/experimental/mini/main.d.ts.map +0 -1
  689. package/dist/experimental/mini/main.js +0 -21
  690. package/dist/experimental/mini/main.js.map +0 -1
  691. package/dist/experimental/mini/server/entry.d.ts +0 -3
  692. package/dist/experimental/mini/server/entry.d.ts.map +0 -1
  693. package/dist/experimental/mini/server/entry.js +0 -11
  694. package/dist/experimental/mini/server/entry.js.map +0 -1
  695. package/dist/experimental/mini/server/run.d.ts +0 -13
  696. package/dist/experimental/mini/server/run.d.ts.map +0 -1
  697. package/dist/experimental/mini/server/run.js +0 -150
  698. package/dist/experimental/mini/server/run.js.map +0 -1
  699. package/dist/experimental/mini/shared/protocol.d.ts +0 -127
  700. package/dist/experimental/mini/shared/protocol.d.ts.map +0 -1
  701. package/dist/experimental/mini/shared/protocol.js +0 -13
  702. package/dist/experimental/mini/shared/protocol.js.map +0 -1
  703. package/dist/experimental/mini/shared/rpc.d.ts +0 -49
  704. package/dist/experimental/mini/shared/rpc.d.ts.map +0 -1
  705. package/dist/experimental/mini/shared/rpc.js +0 -171
  706. package/dist/experimental/mini/shared/rpc.js.map +0 -1
  707. package/dist/experimental/mini/shared/transport.d.ts +0 -35
  708. package/dist/experimental/mini/shared/transport.d.ts.map +0 -1
  709. package/dist/experimental/mini/shared/transport.js +0 -94
  710. package/dist/experimental/mini/shared/transport.js.map +0 -1
  711. package/dist/experimental/mini/tui/run.d.ts +0 -9
  712. package/dist/experimental/mini/tui/run.d.ts.map +0 -1
  713. package/dist/experimental/mini/tui/run.js +0 -62
  714. package/dist/experimental/mini/tui/run.js.map +0 -1
  715. package/dist/experimental/mini/tui/session.d.ts +0 -26
  716. package/dist/experimental/mini/tui/session.d.ts.map +0 -1
  717. package/dist/experimental/mini/tui/session.js +0 -94
  718. package/dist/experimental/mini/tui/session.js.map +0 -1
  719. package/dist/experimental/mini/tui/view.d.ts +0 -10
  720. package/dist/experimental/mini/tui/view.d.ts.map +0 -1
  721. package/dist/experimental/mini/tui/view.js +0 -461
  722. package/dist/experimental/mini/tui/view.js.map +0 -1
  723. package/dist/experimental/mini/worker/entry.d.ts +0 -3
  724. package/dist/experimental/mini/worker/entry.d.ts.map +0 -1
  725. package/dist/experimental/mini/worker/entry.js +0 -10
  726. package/dist/experimental/mini/worker/entry.js.map +0 -1
  727. package/dist/experimental/mini/worker/lane-service.d.ts +0 -44
  728. package/dist/experimental/mini/worker/lane-service.d.ts.map +0 -1
  729. package/dist/experimental/mini/worker/lane-service.js +0 -97
  730. package/dist/experimental/mini/worker/lane-service.js.map +0 -1
  731. package/dist/experimental/mini/worker/models-service.d.ts +0 -19
  732. package/dist/experimental/mini/worker/models-service.d.ts.map +0 -1
  733. package/dist/experimental/mini/worker/models-service.js +0 -136
  734. package/dist/experimental/mini/worker/models-service.js.map +0 -1
  735. package/dist/experimental/mini/worker/run.d.ts +0 -14
  736. package/dist/experimental/mini/worker/run.d.ts.map +0 -1
  737. package/dist/experimental/mini/worker/run.js +0 -88
  738. package/dist/experimental/mini/worker/run.js.map +0 -1
  739. package/dist/modes/interactive/theme/theme-json.d.ts +0 -85
  740. package/dist/modes/interactive/theme/theme-json.d.ts.map +0 -1
  741. package/dist/modes/interactive/theme/theme-json.js +0 -132
  742. package/dist/modes/interactive/theme/theme-json.js.map +0 -1
  743. package/dist/modes/interactive/theme/theme-schema.json +0 -361
  744. /package/dist/bundle/chunks/{chunk-ZZD35WKM.js → chunk-MOOADNVS.js} +0 -0
@@ -1,10 +1,10 @@
1
1
  ---
2
- description: "Generate a committed project-local verify-<app> skill that drives the real app the way a user does and captures proof artifacts — proven end to end once before handover"
2
+ description: "Generate a project-local verify-<app> skill that drives the real app the way a user does and captures proof artifacts — proven end to end once before handover"
3
3
  ---
4
4
 
5
5
  # /create-verification-skill
6
6
 
7
- Every serious project needs a scripted way to drive the real app and prove behaviour: launch it, exercise a feature the way a user would, and capture evidence. This command generates that as a committed project-local skill — `.draht/skills/verify-<app>/` — tailored to the repo, so verification is a versioned repo asset instead of per-session improvisation.
7
+ Create a project-local `.draht/skills/verify-<app>/` skill that launches the real application, exercises user-visible behavior, and captures reusable evidence.
8
8
 
9
9
  ## Usage
10
10
  ```
@@ -23,11 +23,11 @@ Answer these from the codebase and only ask the user what you cannot observe:
23
23
 
24
24
  - **Surface:** what does a user actually touch? A web UI, a CLI/TUI, a desktop app, an API, a mobile app, a library? A repo can have several; pick the primary one and note the rest.
25
25
  - **Run:** how does the app start locally? Prefer the repo's own documented dev command (package scripts, Makefile, README quickstart). Note ports, env vars, seed data, auth.
26
- - **Drive:** how can an agent interact with it programmatically? Existing harnesses first — Playwright/Cypress specs, expect scripts, PTY helpers, curl-able endpoints, a debug port. Only then pick a generic recipe: a browser debug port (CDP) for web and Electron, a tmux/PTY harness for CLI and TUI, plain HTTP for services. Every recipe must run through plain shell commands — assume the runtime ships no browser-automation or app-control tooling of its own.
26
+ - **Drive:** how can an agent interact with it programmatically? Existing harnesses first — Playwright/Cypress specs, expect scripts, PTY helpers, curl-able endpoints, a debug port. Only then pick a generic recipe: a browser debug port (CDP) for web and Electron, a tmux/PTY harness for CLI and TUI, plain HTTP for services. Use the host's supported automation tools or a repository harness; include a shell-based fallback only when needed. Respect repository command restrictions.
27
27
  - **Observe:** what evidence can be captured? Screenshots, terminal transcripts, response bodies, logs, exit codes, DB state.
28
28
  - **Isolate:** can two instances run side by side (ports, data dirs, profiles)? If not, say so in the generated skill: refusing to double-drive a shared instance beats corrupting the user's session.
29
29
 
30
- If the checkout doesn't build or start as-is, fix that first (or report it precisely) before generating; a skill written against a broken base teaches wrong steps. When an irrelevant missing asset blocks startup (a static dir the API never serves, a sample config), the generated skill may create it, clearly marked as verification scaffolding, and remove it in cleanup.
30
+ If the checkout doesn't build or start as-is, resolve in-scope prerequisites or report the blocker precisely before claiming the skill verified; a skill written against a broken base teaches wrong steps. When an irrelevant missing asset blocks startup (a static dir the API never serves, a sample config), the generated skill may create it, clearly marked as verification scaffolding, and remove it in cleanup.
31
31
 
32
32
  ### 2 — Generate the skill
33
33
 
@@ -44,7 +44,7 @@ Frontmatter is `name: verify-<app>` plus a `description` that names the app, the
44
44
 
45
45
  ### 3 — Seed the feature map
46
46
 
47
- Create a `features/` directory inside the generated skill dir, holding `features/README.md` plus one file per user-facing feature you can identify (aim for the top 3-5 to start, from routes, commands, menus, or docs). The README carries the baseline preconditions (launch target, disposable data location, seed data, the Doctor requirement), the driving conventions (stable handles over positions, commands taken literally, restore mutated fixtures, never remove proof artifacts), the proof and skip-reporting rules (record the feature ID and entry point with every artifact; report an unreachable path with the attempted command and the unmet precondition; never report a skipped entry point as verified through a different path), and an index linking every feature file.
47
+ Create a `features/` directory inside the generated skill dir, holding `features/README.md` plus one file per user-facing feature you can identify (start with the relevant user paths identified from routes, commands, menus, or docs). The README carries the baseline preconditions (launch target, disposable data location, seed data, the Doctor requirement), the driving conventions (stable handles over positions, commands taken literally, restore mutated fixtures, never remove proof artifacts), the proof and skip-reporting rules (record the feature ID and entry point with every artifact; report an unreachable path with the attempted command and the unmet precondition; never report a skipped entry point as verified through a different path), and an index linking every feature file.
48
48
 
49
49
  Each feature file starts with an H1 title and one paragraph of user-visible behaviour, then exactly four H2 sections in this order:
50
50
 
@@ -53,56 +53,16 @@ Each feature file starts with an H1 title and one paragraph of user-visible beha
53
53
  3. `Driving it with <harness>` — starts with `Preconditions:`, then labelled bullets pairing each user action with an exact command and its observable result.
54
54
  4. `Gotchas` — traps that can waste or invalidate a verification run.
55
55
 
56
- Keep implementation details out of the map: name only user paths, stable handles, required state, commands, and observable proof. A condensed example entry:
57
-
58
- ```markdown
59
- # Create a note
60
-
61
- Create note lets a user save a titled note and confirm it from a second view.
62
-
63
- ## Sub-features
64
-
65
- - `create-save` persists a title and body.
66
-
67
- ## How to get to it (user POV)
68
-
69
- - Choose the `New note` button in the browser toolbar.
70
-
71
- ## Driving it with the CDP harness
72
-
73
- Preconditions:
74
-
75
- - Notes is healthy at `http://127.0.0.1:4173` and no note is titled `Release checklist`.
76
-
77
- - **Open editor.** Choose `New note`. Click the button with accessible name `New note`. A form named `Note editor` appears.
78
- - **Save note.** Fill `Title` with `Release checklist`, choose `Save note`. A status named `Note saved` appears.
79
- - **Proof.** Reopen the note from `All notes`; screenshot to `artifacts/create-note/list.png`. The list shows `Release checklist`.
80
-
81
- ## Gotchas
82
-
83
- - A save status alone is insufficient proof. Reopen the note from the list.
84
- ```
85
-
56
+ Keep implementation details out of the map: name only user paths, stable handles, required state, commands, and observable proof.
86
57
  The map is the repo's maintained verification source; a proof that drives one convenient entry point is incomplete when the map lists others.
87
58
 
88
59
  ### 4 — Prove the generated skill before handing it over
89
60
 
90
61
  Run its own instructions end to end once: launch, doctor, drive ONE mapped feature (one is enough — the map exists so later runs can cover the rest), capture evidence, clean up. After cleanup, confirm the evidence still exists at the named location — a cleanup that eats the proof fails this step. Fix what fails, and run the generated cleanup after every failed iteration too, so broken attempts don't strand processes and ports. A generated skill that was never executed is a draft, not a deliverable.
91
62
 
92
- ### 5 — Commit and hand over
63
+ ### 5 — Hand over
93
64
 
94
- The generated skill versions with the app it verifies: commit `.draht/skills/verify-<app>/` (skill, feature map, helpers) to the target repo. Then tell the user two things:
65
+ Keep the skill, feature map, and helpers with the application. Commit only when authorized. Report the verified feature and evidence location, plus these maintenance notes:
95
66
 
96
67
  - `/verify-work` picks it up: when a `verify-<app>` skill exists, the phase verifier drives one mapped feature and captures its evidence instead of stopping at the test suite.
97
68
  - The map stays honest only if it changes with the app: a change that adds or reshapes a user-facing feature updates the matching feature file in the same change. A map entry the app has outgrown is worse than none — it teaches wrong steps with confidence.
98
-
99
- ## Failure Modes — STOP
100
-
101
- Stop immediately if you catch yourself:
102
-
103
- - Writing recipes against an app you never started — generate from observed behaviour, not from reading the code
104
- - Trusting a dry-run or test mode by its name instead of observing what it actually skips
105
- - Proving a feature through a test-only endpoint or internal setter instead of the real user path
106
- - Driving an instance this run did not start
107
- - Writing a cleanup that deletes the proof artifacts
108
- - Handing over a skill whose own instructions were never executed end to end
@@ -13,26 +13,22 @@ Capture implementation decisions before planning a phase.
13
13
 
14
14
  Phase: $1
15
15
 
16
- ## Atomic Reasoning
17
-
18
- Decompose the work into independently verifiable units before acting; the `atomic-reasoning` skill holds the full discipline — load it when the decomposition is not obvious.
19
-
20
16
  ## Steps
21
17
  1. Run `draht-tools phase-info $1` to load phase context
22
18
  2. Identify gray areas based on what's being built
23
- 3. Present the whole frontier of open decisions in one numbered round — every question whose prerequisites are settled, each with a recommended answer the user can accept by number; defer questions that depend on still-open answers to the next round. Environment facts are your job, never the user's — dispatch a subagent and only hold back the questions downstream of it.
19
+ 3. Ask about material unresolved decisions, grouping related questions and offering recommendations. Obtain repository facts directly; proceed with independent work while waiting.
24
20
  4. If `.planning/DOMAIN.md` exists, load it and validate discovered terms against the glossary. Add any new domain terms found during discussion.
25
- 5. Record decisions with `draht-tools save-context $1` — label each entry **decided** (the user explicitly chose) or **assumed** (you inferred from context). An answer accepted by number counts as decided. Assumed entries are flagged for confirmation; a plan built on an unlabeled assumption fails silently later.
26
- 6. Commit: `draht-tools commit-docs "capture phase $1 context"`
21
+ 5. Record decisions with `draht-tools save-context $1` — label each entry **decided** (the user explicitly chose) or **assumed** (you inferred from context). An answer accepted by number counts as decided. State material assumptions and clarify those that would change scope or correctness.
22
+ 6. If committing is authorized: `draht-tools commit-docs "capture phase $1 context"`
27
23
 
28
24
  ## Workflow
29
- This is one step in the per-phase cycle. Each step runs in its own session (`/new` between steps):
25
+ This is one step in the per-phase cycle. A fresh session between steps is optional:
30
26
 
31
27
  ```
32
- /discuss-phase N → /new → /plan-phase N → /new → /execute-phase N → /new → /verify-work N → /new → /discuss-phase N+1 → ...
28
+ /discuss-phase N → /plan-phase N → /execute-phase N → /verify-work N → /discuss-phase N+1 → ...
33
29
  ```
34
30
 
35
- After completing this command, tell the user to start a new session and run `/plan-phase $1`.
31
+ After completing this command, identify `/plan-phase $1` as the next step.
36
32
  Do NOT suggest `/next-milestone` — that is only after ALL phases in the milestone are verified.
37
33
 
38
34
  ## Gray Area Categories
@@ -14,15 +14,9 @@ Execute all plans in a phase with atomic commits, parallelizing independent plan
14
14
  Phase: $1
15
15
  Arguments: $ARGUMENTS
16
16
 
17
- ## Red Flags — STOP
17
+ ## Execution prerequisites
18
18
 
19
- STOP and report to the user instead of proceeding if **any** of these is true:
20
-
21
- - Any plan file contains placeholder text: `[TBD]`, `[files]`, `[description]`, "appropriate error handling", "similar to Task N", or empty `<test>` / `<action>` / `<verify>` / `<done>` sections
22
- - A plan has zero `<task>` elements
23
- - `.planning/DOMAIN.md` is absent on a non-greenfield project
24
- - The working tree is dirty with changes unrelated to this phase
25
- - A subagent returns `STATUS: BLOCKED` — never retry blindly; report and ask the user
19
+ Validate plans before execution and honor pre-execute hook failures. Preserve unrelated work. An implementation blocker stops that task; a review blocker follows the bounded correction loop below.
26
20
 
27
21
  ## RLM Routing for Oversize Inputs (`rlm: true`)
28
22
 
@@ -33,12 +27,6 @@ A plan's YAML frontmatter may declare `rlm: true` (alongside `phase`, `plan`, `d
33
27
  - If `rlm_query` is unavailable in the session (the `@draht/rlm-agent` extension isn't installed for this project), fall back to reading the file directly and note this in the task's `STATUS` report rather than failing the task.
34
28
  - When dispatching Stage 1 (Implementer) below for a plan with `rlm: true`, carry this instruction into the subagent's prompt so it actually reaches the agent doing the reading — the orchestrator itself does not read task input files.
35
29
 
36
- ## Atomic Reasoning
37
-
38
- Decompose the work into independently verifiable units before acting; the `atomic-reasoning` skill holds the full discipline — load it when the decomposition is not obvious.
39
-
40
- Within each group of independent plans, dispatch the riskiest plan first (highest uncertainty × blast radius) — its failure invalidates the rest of the phase most cheaply, before effort has been sunk into work it would obsolete.
41
-
42
30
  ## Steps
43
31
  1. Run `draht-tools discover-plans $1` to find and order plans
44
32
  2. Run `draht-tools validate-plans $1` — if any plan has placeholders or missing sections, STOP and fix the plan first
@@ -46,8 +34,8 @@ Within each group of independent plans, dispatch the riskiest plan first (highes
46
34
  4. **Per-plan execution loop.** For each plan (parallel where independent, sequential where dependent), iterate over its `<task>` elements with a **three-stage** dispatch:
47
35
 
48
36
  ### Stage 1 — Implementer
49
- Use the `subagent` tool in **single mode** with the `implementer` agent. Prompt includes the full plan content + the TDD cycle instructions (template below). Read the final `STATUS:` line:
50
- - `DONE` → **re-derive before trusting**: a `DONE` that does not quote its verification output (test counts, command output) is treated as `DONE_WITH_CONCERNS` — run the task's `<verify>` step yourself and read the result before Stage 2. Subagent claims are inputs, not verdicts.
37
+ Use the `subagent` tool in **single mode** with the `implementer` agent. Prompt identifies the current task and includes the full plan as context + the TDD cycle instructions (template below). Read the final `STATUS:` line:
38
+ - `DONE` → inspect the actual verification evidence and checked state. Reuse results only if the relevant inputs and environment are unchanged; run missing, stale, or insufficient verification before Stage 2.
51
39
  - `DONE_WITH_CONCERNS` → if concerns are correctness-related, re-dispatch with a fix instruction; otherwise note and proceed.
52
40
  - `NEEDS_CONTEXT` → provide the missing info and re-dispatch.
53
41
  - `BLOCKED` → STOP, report to the user.
@@ -56,77 +44,62 @@ Within each group of independent plans, dispatch the riskiest plan first (highes
56
44
  Use the `subagent` tool with the `spec-reviewer` agent. ONLY checks "does the diff cover exactly what the spec asked for". Prompt includes the task XML and the diff range.
57
45
  - `DONE` → go to Stage 3.
58
46
  - `DONE_WITH_CONCERNS` → note and proceed.
47
+ - `NEEDS_CONTEXT` → supply the missing spec, diff, or context and repeat this review; do not advance.
59
48
  - `BLOCKED` → re-dispatch implementer with the "Required Fixes" list; repeat Stage 1+2 until `DONE`. Never proceed to Stage 3 with a non-compliant diff. **Hard cap: 3 implementer re-dispatches per task (across Stage 2 and Stage 3 combined)** — at the cap, record the task as failed and STOP; report the disagreement to the user.
60
49
 
61
50
  ### Stage 3 — Reviewer (code quality)
62
- Use the `subagent` tool with the `reviewer` agent for code-quality review. Spec compliance is already ✅.
51
+ Use the `subagent` tool with the `reviewer` agent for code-quality review. Spec compliance is already confirmed; do not repeat the full spec audit, but escalate any discovered mismatch as `Must fix` for spec re-review.
63
52
  - `DONE` → task complete; move to next task.
64
53
  - `DONE_WITH_CONCERNS` → log `Should fix` items; if any are correctness-critical, re-dispatch implementer.
65
- - `BLOCKED` → `Must fix` issues exist; re-dispatch implementer with the issue list. Repeat until `DONE` — subject to the same **hard cap of 3 re-dispatches per task**; at the cap, record the task as failed and STOP.
54
+ - `NEEDS_CONTEXT` → supply the missing diff or context and repeat this review; do not advance.
55
+ - `BLOCKED` → `Must fix` issues exist; re-dispatch implementer with the issue list. Repeat all three stages until `DONE` — subject to the same **hard cap of 3 re-dispatches per task**; at the cap, record the task as failed and STOP.
66
56
 
67
57
  5. After all plans complete, run `draht-tools verify-phase $1` yourself (not the subagent)
68
58
  6. Run `draht-tools update-state` yourself
69
- 7. Final commit: `draht-tools commit-docs "complete phase $1 execution"`
70
- 8. After execution, tell the user to start a new session and run `/verify-work $1`.
59
+ 7. If committing is authorized, final documentation commit: `draht-tools commit-docs "complete phase $1 execution"`
60
+ 8. After execution, identify `/verify-work $1` as the next step; a fresh session is optional.
71
61
 
72
62
  ## Subagent Task Template (Stage 1: implementer)
73
63
 
74
64
  Each implementer subagent receives a task like:
75
65
 
76
66
  ```
77
- Execute this plan. Here is the full plan content:
67
+ Execute only task <task-name>. The full plan below is context; do not execute later tasks before the orchestrator completes this task's reviews:
78
68
 
79
69
  <paste full plan XML here>
80
70
 
81
- For each <task> in the plan, follow this TDD cycle:
71
+ For the assigned <task>, follow its test requirements and this TDD cycle where applicable. Commit the phases only when the user has authorized commits:
82
72
  1. RED — Write failing tests from <test>. Run the test runner, confirm they FAIL. Commit with: git add <test-files> && git commit -m "red: <description>"
83
73
  2. GREEN — Write minimal implementation from <action> to make tests pass. Run tests, confirm PASS. Commit with: git add <files> && git commit -m "green: <task name>"
84
74
  3. REFACTOR — Apply <refactor> improvements if any. Tests must stay green after each change. Commit with: git add <files> && git commit -m "refactor: <description>"
85
75
  4. VERIFY — Run the <verify> step, confirm <done> criteria are met.
86
76
 
87
- Domain rules: Use ubiquitous language from .planning/DOMAIN.md (read it). Do not import across bounded context boundaries.
88
- Comment discipline: comments exist ONLY for constraints the code cannot express — a protocol quirk, a deliberate deviation, a non-obvious invariant. If code needs comments to be understood, rewrite the code until it doesn't. Never narrate steps, restate the diff, or leave "removed X" / "this handles Y" breadcrumbs. Comment density above the surrounding file's norm is a defect — fix it before committing. A heavily-commented solution signals the design is wrong: redesign, don't annotate.
77
+ Use established project terms and documented boundaries; read relevant domain context when present.
78
+ Comments explain non-obvious constraints or rationale; avoid step narration and diff restatements.
89
79
  Checkpoint handling: type="auto" → execute silently. type="checkpoint:human-verify" → stop and report back what was built. type="checkpoint:decision" → stop and report the options.
90
80
  RLM routing: if this plan's frontmatter has `rlm: true`, use the `rlm_query` tool instead of reading directly any task input file at or above ~200KB (see "RLM Routing for Oversize Inputs" above for the full rule and fallback behavior).
91
81
 
92
- Evidence rule: quote the decisive output of every test run and <verify> step in your report (pass/fail counts, exit codes, error text). Unquoted claims will be re-run by the orchestrator. If a plan instruction contradicts what you find in the code, stop and report NEEDS_CONTEXT — do not silently obey either side.
82
+ Evidence rule: report decisive commands, working directories, outcomes, and the code/configuration state checked. A bare success status is insufficient; missing or stale evidence must be verified. If a plan instruction contradicts what you find in the code, stop and report NEEDS_CONTEXT — do not silently obey either side.
93
83
 
94
84
  End your response with `STATUS: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED` per the agent contract.
95
85
 
96
86
  Important: Do NOT run draht, draht-tools, draht help, or pi commands. Use only standard tools (read, bash, edit, write, grep, find, ls).
97
87
  ```
98
88
 
99
- ## Two-Stage Review Rationale
100
-
101
- - **Spec compliance prevents over/under-building.** The spec-reviewer catches drift before quality review masks it.
102
- - **Code quality runs only after spec ✅.** Never accept "close enough" on spec compliance.
103
- - **Tasks within a plan are sequential** — review loop completes before next task starts.
104
-
105
89
  ## Parallelization Rules
106
90
  - Plans sharing no files and having no dependency edges can run in parallel
107
91
  - Inside a plan, tasks run sequentially with the three-stage loop
108
92
  - Maximum parallel subagents: follow the subagent tool limits (max 8 tasks, 4 concurrent)
109
93
  - If a parallel subagent fails, report which plan failed and continue with independent plans
110
94
 
111
- ## TDD Rules
112
- - Never write implementation before a failing test exists
113
- - If a test passes immediately after being written, it is not testing the right thing — fix it
114
- - Red → Green → Refactor is not optional; skipping steps invalidates the safety net
115
- - Each TDD phase gets its own commit so the history is auditable
116
-
117
- ## Domain Rules
118
- - All identifiers (class names, method names, variables) must use the ubiquitous language from `.planning/DOMAIN.md`
119
- - Do not import across bounded context boundaries directly — use domain events or ACL adapters
120
- - If implementation reveals a missing domain term, stop and update DOMAIN.md before continuing
121
-
122
95
  ## Workflow
123
- This is one step in the per-phase cycle. Each step runs in its own session (`/new` between steps):
96
+ This is one step in the per-phase cycle. Start a fresh session when context limits make it useful:
124
97
 
125
98
  ```
126
- /discuss-phase N → /new → /plan-phase N → /new → /execute-phase N → /new → /verify-work N → /new → /discuss-phase N+1 → ...
99
+ /discuss-phase N → /plan-phase N → /execute-phase N → /verify-work N → /discuss-phase N+1 → ...
127
100
  ```
128
101
 
129
- After completing this command, tell the user to start a new session and run `/verify-work $1`.
102
+ After completing this command, identify `/verify-work $1` as the next step; a fresh session is optional.
130
103
  Do NOT suggest `/next-milestone` — that is only after ALL phases in the milestone are verified.
131
104
 
132
105
  ## Flags
@@ -4,146 +4,34 @@ description: "Diagnose and fix a bug with a 4-phase systematic debugging protoco
4
4
 
5
5
  # /fix
6
6
 
7
- Diagnose and fix a bug using the **four-phase systematic debugging protocol**: root cause investigation → pattern analysis → ranked hypotheses & testing → implementation with a reproducing test.
8
-
9
- ## Usage
10
- ```
11
- /fix [description of what's broken]
12
- ```
13
-
14
7
  Issue: $ARGUMENTS
15
8
 
16
- ## The Iron Law
17
-
18
- > **NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.**
19
-
20
- Symptom fixes are failure. If you find yourself proposing a "quick fix for now, investigate later", STOP and return to Phase 1.
21
-
22
- ## The Report Is a Symptom, Not a Diagnosis
23
-
24
- **Procedure:** Restate the failure as observable behavior — "X happens when Y; expected Z" — before touching anything. If the user names a cause ("the cache is stale"), treat it as Hypothesis #0: it enters the Phase 3 ranking like any other hypothesis and does not skip Phase 1.
25
-
26
- **Example:** "fix the stale cache bug" — Phase 1 traces the data flow and finds the cache is fine; the query behind it silently drops a filter. The fix lands in the query.
27
-
28
- **Prevents:** shipping a correct fix to the wrong component.
29
-
30
- Not every why is a bug: if the user is asking why the code is *shaped* the way it is — intent, history, design rationale — and nothing is misbehaving, route to `/why` instead. `/fix` answers defects; `/why` answers intent. When Phase 1 needs design intent (is this behaviour a decision or an accident?), consult `/why` and feed its Preserve/Avoid constraints into the hypothesis ranking. A `/triage` verdict ending in `[triage:bug]` or `[triage:performance]` is a ready entry here: take the linked tracker issue as the report and treat triage's cause-trace findings as ranked-hypothesis material — labeled hypotheses, not a diagnosis.
31
-
32
- ## Red Flags — STOP
33
-
34
- Stop immediately if you catch yourself:
35
- - Proposing "quick fixes for now, investigate later"
36
- - Attempting multiple changes simultaneously
37
- - Skipping a reproducing test before fixing
38
- - Proposing solutions before understanding data flow
39
- - Reading code to build a causal theory before a red-capable reproduction command exists
40
- - Making "one more fix attempt" after already trying 2+
41
- - Watching each fix reveal new problems elsewhere
42
-
43
- After **3 failed fix attempts**, STOP. This is a **hard cap**, not advice — an architectural problem, not a hypothesis problem. Report back to the user — do not try a 4th fix. Before reporting, append one dated line to `.planning/STATE.md` under `## Lessons`: what was tried and why it failed, so the next session doesn't repeat the same three attempts.
44
-
45
- ## Atomic Reasoning
9
+ Investigate and repair the reported defect within the requested scope. Historical design questions belong in `/why`; a triage trace supplies hypotheses, not an already-confirmed diagnosis.
46
10
 
47
- Decompose the work into independently verifiable units before acting; the `atomic-reasoning` skill holds the full discipline — load it when the decomposition is not obvious.
11
+ ## Investigation
48
12
 
49
- ## The Four Phases
13
+ Read the relevant source, errors, configuration, and history. Restate observed versus expected behavior and identify a command that can expose the symptom. Code inspection and hypotheses may precede reproduction; distinguish a candidate cause from a demonstrated one.
50
14
 
51
- ### Phase 1 — Root Cause Investigation (before ANY fix)
52
-
53
- Use the `subagent` tool in **single mode** with the `debugger` agent. Prompt:
15
+ Use the `debugger` agent when a separate investigation is useful. Pass the issue, relevant code/context, and this scope:
54
16
 
55
17
  ```
56
- Investigate this issue using Phase 1 root-cause discipline. Do NOT fix anything — only diagnose.
57
-
58
- Issue: $ARGUMENTS
59
-
60
- Walk through these steps and report on each:
61
- 1. Read the error message / stack trace carefully — exact line numbers, exact file paths.
62
- 2. Build a reproduction loop — ONE command that goes red on this bug. This step is the heart of the diagnosis; spend disproportionate effort here. Work down the ladder and take the first rung that reaches the bug:
63
- - failing test at whatever seam reaches the bug (unit, integration, e2e)
64
- - HTTP request script against a running dev server
65
- - CLI invocation on a fixture input, output diffed against a known-good snapshot
66
- - headless browser script asserting on DOM / console / network
67
- - replay of a captured payload, trace, or event log through the code path in isolation
68
- - throwaway harness: a minimal subset of the system (mocked deps) exercising the bug path in one call
69
- - property/fuzz loop: hundreds of random inputs when the output is only sometimes wrong
70
- - bisection harness: automate "checkout state X, run the check" so `git bisect run` can drive it
71
- - differential loop: the same input through old vs new version (or two configs), outputs diffed
72
- - last resort, human-in-the-loop: exact numbered steps for the user to run by hand, output pasted back
73
- Flaky bugs: the goal is a HIGHER reproduction rate, not a clean repro — loop the trigger 100x, add stress, narrow timing windows until it fails often enough to debug against.
74
- Exit checklist — all four must hold before you continue: (a) ONE named command (a test invocation, a script path, a curl); (b) you have ALREADY RUN it at least once; (c) your report shows the invocation AND its output (secrets redacted); (d) it asserts the user's EXACT symptom — able to go red on this bug and green once fixed, not merely "runs without erroring".
75
- Self-interrupt: if you catch yourself reading code to build a causal theory before this command exists, STOP — anchoring on the first plausible idea is the exact failure this protocol prevents. No red-capable command, no steps 4-6.
76
- If you genuinely cannot build a loop: list what you tried, name what you need (environment access, a captured artifact such as a log dump or recording, or permission to add temporary instrumentation), and end with STATUS: NEEDS_CONTEXT rather than guessing.
77
- 3. Check recent changes — `git log --oneline -20` and `git diff HEAD~5` against affected files.
78
- 4. Trace data flow upward until you find the source. Fix at source, not at symptom.
79
- 5. State the root cause as one sentence: "X happens because Y at <file:line>."
80
- 6. Label every statement in your report: observed (you ran it and saw it), derived (follows necessarily from evidence), or assumed (unchecked — say what would check it). A root cause resting on an assumption is a hypothesis, not a diagnosis.
81
-
82
- End your response with `STATUS: DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED`.
83
- Do NOT run draht, draht-tools, or pi commands.
18
+ Diagnose this issue; do not apply a production fix. Read the affected path and build a reproduction when feasible. Report the supported cause or labeled hypotheses, relevant files, reproduction command/output, and any missing evidence. Respect any read-only restriction, including on test or instrumentation edits.
19
+ Do not run interactive draht or pi sessions.
20
+ End with exactly one: STATUS: DONE, STATUS: DONE_WITH_CONCERNS, STATUS: NEEDS_CONTEXT, or STATUS: BLOCKED.
84
21
  ```
85
22
 
86
- If `BLOCKED` or `NEEDS_CONTEXT`: provide the missing info and re-dispatch.
87
-
88
- ### Phase 2 — Pattern Analysis
89
-
90
- 1. Find working examples in the codebase that do the same kind of thing correctly
91
- 2. Read those references completely — not skimmed
92
- 3. List every difference between the working code and the broken code
93
- 4. Note dependencies the working version assumes
94
-
95
- If Phase 2 reveals a different root cause, go back to Phase 1.
96
-
97
- ### Phase 3 — Ranked Hypotheses
98
-
99
- 1. Generate **3-5 ranked falsifiable hypotheses** before testing any of them. A single hypothesis anchors you to the first plausible idea — ranking forces the alternatives into view.
100
- 2. Each hypothesis must state its prediction: "If X is the cause, then changing Y will make the bug disappear / changing Z will make it worse." If you cannot state the prediction, it is a vibe — discard it or sharpen it.
101
- 3. If the user named a cause, it is **Hypothesis #0** and enters the ranking with the others — ranked on evidence, not privileged for being first.
102
- 4. Show the ranked list to the user before testing. Domain knowledge re-ranks instantly ("we just deployed a change to #3") and rules hypotheses out for free. Do not block waiting for a reply — proceed in ranked order if none comes.
103
- 5. Test in rank order, one hypothesis at a time. Design the **smallest possible change** that would prove or falsify the prediction — one variable, one line if possible — and re-run the Phase 1 reproduction command to read the verdict.
104
- - **Prediction confirmed** → proceed to Phase 4 with this cause.
105
- - **Falsified** → revert the probe, record which prediction failed, move to the next hypothesis. Do not pile changes on top.
106
- 6. When a probe needs logging, prefer one debugger/REPL inspection over ten log lines; if you must log, tag every line with one unique session prefix, e.g. `[DEBUG-a4f2]`, and never "log everything and grep".
107
- 7. If after 3 falsified hypotheses you are still failing, STOP. Question the architecture, not the ranking. Report to the user.
108
-
109
- ### Phase 4 — Implementation
110
-
111
- Comment discipline: the fix ships no narration — comments exist ONLY for constraints the code cannot express: a protocol quirk, a deliberate deviation, a non-obvious invariant. If code needs comments to be understood, rewrite the code until it doesn't. Never narrate steps, restate the diff, or leave "removed X" / "this handles Y" breadcrumbs. Comment density above the surrounding file's norm is a defect — fix it before committing. A heavily-commented solution signals the design is wrong: redesign, don't annotate.
112
-
113
- 1. **Write the reproducing test FIRST.** Seed it from the Phase 1 reproduction command — the loop that already goes red is the test's skeleton; port its scenario and its symptom assertion to the right test seam. Confirm it FAILS for the right reason.
114
- - Commit: `git add <test-files> && git commit -m "red: reproduce <bug>"`
115
-
116
- 2. **Apply the single fix** from Phase 3. No other changes.
117
- - Failing test now PASSES.
118
- - Full test suite — no regressions.
119
- - Commit: `git add <files> && git commit -m "green: fix <bug>"`
120
-
121
- 3. **Refactor (optional)** — only if clear improvement, no behaviour change. Tests stay green.
122
- - Commit: `git add <files> && git commit -m "refactor: <description>"`
23
+ - If `NEEDS_CONTEXT`, provide available missing information and retry within the budget.
24
+ - If `BLOCKED`, report the blocker and evidence; do not keep retrying.
25
+ - At most 3 re-dispatches or failed repair attempts; stop with a concise record when that bound is reached. It does not establish that the architecture is wrong.
123
26
 
124
- 4. **Verify the original symptom is gone** — run the user-level reproduction.
27
+ Test plausible causes with discriminating observations or small experiments. Use the number of hypotheses the evidence warrants. Remove unsuccessful probes rather than layering speculative changes. When reproduction is unavailable, continue useful read-only investigation and identify what prevents confirmation.
125
28
 
126
- 5. **Sweep instrumentation** — grep your `[DEBUG-` prefix across the tree; the fix is not done until the grep returns nothing. Tagged probes die here; untagged probes survive to pollute production.
29
+ ## Repair
127
30
 
128
- 6. **Update state**: `draht-tools update-state`
31
+ Apply a focused fix once the evidence supports it. Preserve a regression check: observe it fail for the intended reason before the repair, then pass afterward where a test seam exists. Explain any inability to establish that evidence. Run the original reproduction when available, relevant regression checks, and project-required validation; do not automatically run every available command.
129
32
 
130
- ## Rationalization Table
33
+ Remove temporary instrumentation and avoid unrelated cleanup. Delegate the implementation to `implementer` only when useful, with the issue, scope, evidence, checks, and the same STATUS contract.
131
34
 
132
- | Excuse | Reality |
133
- |--------|---------|
134
- | "Simple bug, skip the process" | Simple bugs have root causes too. The process is fast. |
135
- | "It's an emergency, no time" | Systematic debugging is *faster* than thrashing. |
136
- | "I'll write the test after I confirm the fix" | Untested fixes don't stick. |
137
- | "I'll just try things and see what works" | Can't isolate what worked. Creates new bugs. |
138
- | "I already manually tested it" | A reproducing test is the only durable proof. |
139
- | "The user already told me the cause" | The reporter saw the symptom. Their diagnosis is Hypothesis #0, not a finding. |
140
- | "The fix passed, so my diagnosis was right" | Fixes can mask. Verify the causal chain, not just the symptom's absence. |
141
- | "I can't reproduce it, but the cause is obvious from the code" | Reading code yields theories, not verdicts. No red-capable command, no diagnosis — report NEEDS_CONTEXT and name what's missing. |
35
+ Commit only when authorized. For recorded TDD phases use plain Git with explicit paths and `red:`, `green:`, `refactor:` subjects; never route source commits through docs-only tooling. Update GSD state only for an active GSD task.
142
36
 
143
- ## Rules
144
- - Always reproduce before fixing
145
- - One bug, one fix, one commit series
146
- - Fix at source, not symptom
147
- - 3 failed attempts ⇒ architecture problem, stop and discuss
148
- - If the root cause spans multiple files, explain the chain in the commit message
149
- - Final report order: verdict first (fixed / not fixed, root cause in one sentence), then evidence (reproducing test red→green, suite results), then risk (what the fix could regress, what stays assumed)
37
+ Report the verdict and supported cause first, decisive commands/results next, then residual risk and missing evidence. A completion claim requires checks that cover the current state; reuse recorded results only when their inputs and environment remain unchanged.
@@ -4,63 +4,16 @@ description: "Grill any subject in whole-frontier question rounds — output for
4
4
 
5
5
  # /grill
6
6
 
7
- Interrogate the subject relentlessly until you reach a shared understanding. A grill has no fixed outcome: it can end in a refined spec, a ticket list, a decision record, plain notes, or nothing but the conversation. The output form is chosen at the end, never presumed at the start.
8
-
9
- `/brainstorm` remains the project-creation entry (hard gate → spec → `/new-project` or `/init-project`); `/grill` presumes nothing about where the conversation lands.
10
-
11
- ## Usage
12
- ```
13
- /grill [subject]
14
- ```
15
-
16
7
  Subject: $ARGUMENTS
17
8
 
18
- > **Tool note**: For environment facts, use the `subagent` tool with the `architect` agent — read-only fact-finding; never block the current round on it.
19
-
20
- ## The Design Tree
21
-
22
- Map the subject as a **design tree**: every decision branches into the decisions that hang off it. The **frontier** is every decision whose prerequisites are already settled — the questions you can ask now without guessing at answers you haven't heard yet.
23
-
24
- ## Rounds
25
-
26
- 1. **Orient without blocking.** Skim what the subject names before round 1: files mentioned in it, `.planning/` if present, recent git history. Dispatch fact-finders for anything deeper — do not hold the first round for them.
27
- 2. **Ask the WHOLE frontier in one message.** Number every question, foundational → detailed, and give each one a recommended answer:
28
-
29
- ```
30
- **Q1 — <title>**: <body; may offer options>
31
- *Recommended:* <your recommended answer>
32
-
33
- ---
34
-
35
- **Q2 — <title>**: <body>
36
- *Recommended:* <your recommended answer>
37
- ```
38
-
39
- 3. **Defer dependent questions.** A question whose answer depends on another question still open this round belongs to a later round — asking it now means guessing at an answer you haven't heard.
40
- 4. **Let the user answer by number.** "1 yes, 2: B, 4 later" is a complete reply. Anything accepted by number or answered explicitly is **decided**. A recommendation acted on without confirmation is **assumed** and stays flagged until the user confirms it.
41
- 5. **Recompute and repeat.** Every answer reshapes the tree: settled decisions push the frontier outward and unblock the questions that hung off them. Recompute the frontier and ask the next round.
42
-
43
- ## Facts Are Your Job
44
-
45
- Finding facts is your job, never the user's. When a frontier question needs an environment fact — filesystem, git history, code structure, existing docs — dispatch a fact-finder instead of asking. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait; ask the rest of the frontier now. Decisions belong to the user: put each one to them and wait.
46
-
47
- ## Done
48
-
49
- The grill is done when the frontier is empty: every branch of the tree visited, nothing left silently assumed. Present the decided-vs-assumed summary, then — and only then — ask which artifact to produce:
9
+ Stress-test the subject through focused questions about assumptions, evidence, trade-offs, and failure modes. The result may be a refined idea, decision, spec, ticket list, or simply a clearer conversation; do not presume a GSD handoff.
50
10
 
51
- 1. **Refined spec** → `.planning/specs/YYYY-MM-DD-<slug>-design.md`. When it describes a project to build, offer to hand off to `/new-project` or `/init-project`.
52
- 2. **Ticket list** → `.planning/tickets/YYYY-MM-DD-<slug>.md`
53
- 3. **Decision record** → `.planning/decisions/YYYY-MM-DD-<slug>.md`
54
- 4. **Plain notes** → a file the user names
11
+ Read the relevant context before asking for repository facts. Use the `architect` agent for independent read-only fact-finding when useful; continue questions that do not depend on it.
55
12
 
56
- Whatever form is chosen, write the artifact through the `unslop` skill; the user's own words in quoted decisions stay verbatim.
13
+ Group related open decisions and ask the questions whose answers would change the result. Offer a recommendation with its trade-off when helpful. Defer questions that depend on unresolved answers. Preserve what the user decided, label assumptions, and follow new evidence that challenges the leading approach.
57
14
 
58
- When no `.planning/` directory exists, every mode becomes a standalone file the user names. "No artifact" is a valid answer — sometimes the conversation was the point. Never start implementing or invoke a planning command without the user's explicit go-ahead.
15
+ Continue while useful unresolved questions remain and the user wants deeper examination. There is no requirement to enumerate every imaginable branch or empty a fixed question tree. Respect requests to stop, narrow scope, or proceed with authorized work.
59
16
 
60
- ## Anti-Patterns — STOP
17
+ End with the decisions, consequential assumptions, remaining risks, and recommended next action. Produce the artifact the user requested; otherwise a chat summary is sufficient. Use project conventions for files, and `.planning/` only when that workflow is selected. Follow `unslop` for prose and preserve quoted user decisions exactly.
61
18
 
62
- - **Dribbling questions one at a time** — a serial interview hides the decision tree and wastes rounds; ask the whole frontier, numbered, with recommended answers
63
- - **Asking the user for facts the environment can answer** — filesystem, git history, and code structure are yours to look up
64
- - **Blocking a whole round on a running fact-finder** — only the questions downstream of it wait; ask the rest now
65
- - **Presuming the outcome at round 1** — deciding early that this "is" a spec narrows the questioning to spec-shaped answers
66
- - **Acting on the result before the user confirms shared understanding** — an empty frontier ends the questioning; only the user's confirmation ends the grill
19
+ A request to discuss alone does not authorize implementation. When the user subsequently asks to implement, use that authorization without requiring another ceremonial approval.
@@ -16,15 +16,11 @@ Focus: $ARGUMENTS
16
16
  Use this when you have an existing codebase and want to add structured planning.
17
17
  For greenfield projects, use `/new-project` instead.
18
18
 
19
- ## Atomic Reasoning
20
-
21
- Decompose the work into independently verifiable units before acting; the `atomic-reasoning` skill holds the full discipline — load it when the decomposition is not obvious.
22
-
23
19
  ## Steps
24
20
  1. Run `draht-tools init` to check preconditions (git repo, etc.)
25
21
  2. Run `draht-tools map-codebase` to build a structural map of the existing code
26
- 3. Analyze the codebase map to understand architecture, tech stack, and conventions
27
- 4. Deep questioning phase (3-7 rounds — each round asks the whole frontier: settled-prerequisite questions only, numbered, each with a recommended answer):
22
+ 3. Read `.planning/codebase/GRAPH_REPORT.md` and query relevant files/concepts with `draht-tools graph-context` and `graph-query`; do not load the full MAP.json
23
+ 4. Clarify material gaps in the problem, scope, constraints, and success criteria; use existing answers and repository evidence before asking:
28
24
  - What is this project? Who uses it?
29
25
  - What are the current pain points or goals?
30
26
  - What is MVP vs aspirational scope?
@@ -43,32 +39,31 @@ Decompose the work into independently verifiable units before acting; the `atomi
43
39
  - `## Coverage Goals` — target coverage percentage and which paths are critical
44
40
  - `## Testing Levels` — what is tested at unit level vs integration vs e2e, with examples
45
41
  - `## Excluded` — what is explicitly not tested and why (config files, generated code, etc.)
46
- 9. Optional research phase via `draht-tools research`
42
+ 9. If research is needed before defining requirements, investigate the open questions and save findings with sources under `.planning/research/<topic>.md`
47
43
  10. Run `draht-tools create-requirements` with v1/v2/out-of-scope (map requirements to bounded contexts)
48
44
  11. Run `draht-tools create-roadmap` with phases
49
45
  12. Run `draht-tools init-state`
50
- 13. Git commit via `draht-tools commit-docs "initialize project planning"`
46
+ 13. If committing is authorized, use `draht-tools commit-docs "initialize project planning"`
51
47
 
52
48
  ## Workflow
53
- After project initialization, phases are executed one at a time in new sessions:
49
+ After project initialization, phases are executed one at a time in dependency order:
54
50
 
55
51
  ```
56
- /init-project → /new → /discuss-phase 1 → /new → /plan-phase 1 → /new → /execute-phase 1 → /new → /verify-work 1
57
- → /new → /discuss-phase 2 → /new → /plan-phase 2 → /new → /execute-phase 2 → /new → /verify-work 2
52
+ /init-project → /discuss-phase 1 → /plan-phase 1 → /execute-phase 1 → /verify-work 1
53
+ → /discuss-phase 2 → /plan-phase 2 → /execute-phase 2 → /verify-work 2
58
54
  → ... (repeat for all phases in the milestone)
59
- → /new → /next-milestone (only after ALL phases are complete)
55
+ → /next-milestone (only after ALL phases are complete)
60
56
  ```
61
57
 
62
- Each step runs in its own session (`/new` between steps). Do NOT suggest `/next-milestone` until every phase in the milestone is verified.
58
+ A fresh session between steps is optional. Do NOT suggest `/next-milestone` until every phase in the milestone is verified.
63
59
 
64
60
  ## Rules
65
- - Ask the whole frontier per round — numbered, each with a recommended answer; the user replies by number, and accepted-by-number counts as decided
61
+ - Group related questions and ask only those that change a material decision.
66
62
  - Questions that depend on still-open answers wait for a later round
67
- - Finding facts is your job, never the user's — dispatch a subagent for anything the environment can answer and keep asking the rest of the frontier while it runs
63
+ - Investigate repository facts directly; delegate independent research when useful.
68
64
  - Follow threads based on answers
69
65
  - Use examples ("Like Stripe Checkout, or custom?")
70
- - Confirm, don't assume
71
- - When the focus names a solution ("migrate to X"), ask what problem it solves — the existing code may admit a smaller answer
72
- - 3-7 follow-up rounds typical
66
+ - Distinguish user decisions from reasonable implementation assumptions; clarify only blocking ambiguity
67
+ - Respect explicit requirements; clarify the intended outcome when it is unclear.
73
68
  - Respect what already exists — do not propose rewriting working code
74
69
  - Stop when you have: current state, goals, MVP scope, constraints, success criteria