@draht/coding-agent 2026.7.13 → 2026.9.5-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 (614) hide show
  1. package/CHANGELOG.md +241 -0
  2. package/README.md +47 -2
  3. package/agents/debugger.md +12 -1
  4. package/agents/git-committer.md +1 -0
  5. package/agents/implementer.md +20 -0
  6. package/agents/investigator.md +75 -0
  7. package/agents/reviewer.md +7 -0
  8. package/agents/spec-reviewer.md +66 -0
  9. package/agents/verifier.md +4 -3
  10. package/bin/draht-tools.cjs +472 -41
  11. package/dist/agents/debugger.md +12 -1
  12. package/dist/agents/git-committer.md +1 -0
  13. package/dist/agents/implementer.md +20 -0
  14. package/dist/agents/investigator.md +75 -0
  15. package/dist/agents/reviewer.md +7 -0
  16. package/dist/agents/spec-reviewer.md +66 -0
  17. package/dist/agents/verifier.md +4 -3
  18. package/dist/bun/cli.js +2 -0
  19. package/dist/bun/cli.js.map +1 -1
  20. package/dist/cli/args.d.ts +10 -0
  21. package/dist/cli/args.d.ts.map +1 -1
  22. package/dist/cli/args.js +80 -3
  23. package/dist/cli/args.js.map +1 -1
  24. package/dist/cli/attach-mode.d.ts +61 -0
  25. package/dist/cli/attach-mode.d.ts.map +1 -1
  26. package/dist/cli/attach-mode.js +243 -5
  27. package/dist/cli/attach-mode.js.map +1 -1
  28. package/dist/cli/config-selector.js +1 -1
  29. package/dist/cli/config-selector.js.map +1 -1
  30. package/dist/cli/credential-print.d.ts +23 -0
  31. package/dist/cli/credential-print.d.ts.map +1 -0
  32. package/dist/cli/credential-print.js +117 -0
  33. package/dist/cli/credential-print.js.map +1 -0
  34. package/dist/cli/list-models.d.ts +2 -2
  35. package/dist/cli/list-models.d.ts.map +1 -1
  36. package/dist/cli/list-models.js +3 -3
  37. package/dist/cli/list-models.js.map +1 -1
  38. package/dist/cli/startup-ui.js +1 -1
  39. package/dist/cli/startup-ui.js.map +1 -1
  40. package/dist/config.d.ts +9 -0
  41. package/dist/config.d.ts.map +1 -1
  42. package/dist/config.js +31 -4
  43. package/dist/config.js.map +1 -1
  44. package/dist/core/agent-session-runtime.d.ts +17 -1
  45. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  46. package/dist/core/agent-session-runtime.js +90 -30
  47. package/dist/core/agent-session-runtime.js.map +1 -1
  48. package/dist/core/agent-session-services.d.ts +4 -7
  49. package/dist/core/agent-session-services.d.ts.map +1 -1
  50. package/dist/core/agent-session-services.js +24 -9
  51. package/dist/core/agent-session-services.js.map +1 -1
  52. package/dist/core/agent-session.d.ts +87 -27
  53. package/dist/core/agent-session.d.ts.map +1 -1
  54. package/dist/core/agent-session.js +337 -154
  55. package/dist/core/agent-session.js.map +1 -1
  56. package/dist/core/auth-storage.d.ts +20 -104
  57. package/dist/core/auth-storage.d.ts.map +1 -1
  58. package/dist/core/auth-storage.js +104 -260
  59. package/dist/core/auth-storage.js.map +1 -1
  60. package/dist/core/builtins/checkpoints.d.ts +20 -0
  61. package/dist/core/builtins/checkpoints.d.ts.map +1 -0
  62. package/dist/core/builtins/checkpoints.js +161 -0
  63. package/dist/core/builtins/checkpoints.js.map +1 -0
  64. package/dist/core/builtins/duet.d.ts +26 -0
  65. package/dist/core/builtins/duet.d.ts.map +1 -0
  66. package/dist/core/builtins/duet.js +660 -0
  67. package/dist/core/builtins/duet.js.map +1 -0
  68. package/dist/core/builtins/index.d.ts.map +1 -1
  69. package/dist/core/builtins/index.js +7 -1
  70. package/dist/core/builtins/index.js.map +1 -1
  71. package/dist/core/builtins/subagent.d.ts +24 -4
  72. package/dist/core/builtins/subagent.d.ts.map +1 -1
  73. package/dist/core/builtins/subagent.js +278 -35
  74. package/dist/core/builtins/subagent.js.map +1 -1
  75. package/dist/core/cache-stats.d.ts +2 -2
  76. package/dist/core/cache-stats.d.ts.map +1 -1
  77. package/dist/core/cache-stats.js +1 -1
  78. package/dist/core/cache-stats.js.map +1 -1
  79. package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
  80. package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
  81. package/dist/core/checkpoints/checkpoint-cli.js +78 -0
  82. package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
  83. package/dist/core/checkpoints/checkpoint-manager.d.ts +294 -0
  84. package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
  85. package/dist/core/checkpoints/checkpoint-manager.js +865 -0
  86. package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
  87. package/dist/core/checkpoints/rewind.d.ts +141 -0
  88. package/dist/core/checkpoints/rewind.d.ts.map +1 -0
  89. package/dist/core/checkpoints/rewind.js +246 -0
  90. package/dist/core/checkpoints/rewind.js.map +1 -0
  91. package/dist/core/compaction/branch-summarization.d.ts +9 -3
  92. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  93. package/dist/core/compaction/branch-summarization.js +16 -14
  94. package/dist/core/compaction/branch-summarization.js.map +1 -1
  95. package/dist/core/compaction/compaction.d.ts +24 -3
  96. package/dist/core/compaction/compaction.d.ts.map +1 -1
  97. package/dist/core/compaction/compaction.js +96 -30
  98. package/dist/core/compaction/compaction.js.map +1 -1
  99. package/dist/core/compaction/utils.d.ts +1 -1
  100. package/dist/core/compaction/utils.d.ts.map +1 -1
  101. package/dist/core/compaction/utils.js +6 -17
  102. package/dist/core/compaction/utils.js.map +1 -1
  103. package/dist/core/context-windows.d.ts +7 -0
  104. package/dist/core/context-windows.d.ts.map +1 -0
  105. package/dist/core/context-windows.js +35 -0
  106. package/dist/core/context-windows.js.map +1 -0
  107. package/dist/core/extensions/index.d.ts +1 -1
  108. package/dist/core/extensions/index.d.ts.map +1 -1
  109. package/dist/core/extensions/index.js.map +1 -1
  110. package/dist/core/extensions/loader.d.ts.map +1 -1
  111. package/dist/core/extensions/loader.js +101 -23
  112. package/dist/core/extensions/loader.js.map +1 -1
  113. package/dist/core/extensions/runner.d.ts +19 -3
  114. package/dist/core/extensions/runner.d.ts.map +1 -1
  115. package/dist/core/extensions/runner.js +117 -2
  116. package/dist/core/extensions/runner.js.map +1 -1
  117. package/dist/core/extensions/types.d.ts +236 -9
  118. package/dist/core/extensions/types.d.ts.map +1 -1
  119. package/dist/core/extensions/types.js.map +1 -1
  120. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  121. package/dist/core/extensions/wrapper.js +22 -3
  122. package/dist/core/extensions/wrapper.js.map +1 -1
  123. package/dist/core/footer-data-provider.d.ts +10 -0
  124. package/dist/core/footer-data-provider.d.ts.map +1 -1
  125. package/dist/core/footer-data-provider.js +1 -1
  126. package/dist/core/footer-data-provider.js.map +1 -1
  127. package/dist/core/http-dispatcher.d.ts.map +1 -1
  128. package/dist/core/http-dispatcher.js +7 -0
  129. package/dist/core/http-dispatcher.js.map +1 -1
  130. package/dist/core/index.d.ts +1 -1
  131. package/dist/core/index.d.ts.map +1 -1
  132. package/dist/core/index.js.map +1 -1
  133. package/dist/core/keybindings.d.ts +18 -3
  134. package/dist/core/keybindings.d.ts.map +1 -1
  135. package/dist/core/keybindings.js +12 -3
  136. package/dist/core/keybindings.js.map +1 -1
  137. package/dist/core/model-config.d.ts +542 -0
  138. package/dist/core/model-config.d.ts.map +1 -0
  139. package/dist/core/model-config.js +247 -0
  140. package/dist/core/model-config.js.map +1 -0
  141. package/dist/core/model-registry.d.ts +19 -124
  142. package/dist/core/model-registry.d.ts.map +1 -1
  143. package/dist/core/model-registry.js +56 -727
  144. package/dist/core/model-registry.js.map +1 -1
  145. package/dist/core/model-resolver.d.ts +7 -6
  146. package/dist/core/model-resolver.d.ts.map +1 -1
  147. package/dist/core/model-resolver.js +74 -27
  148. package/dist/core/model-resolver.js.map +1 -1
  149. package/dist/core/model-runtime.d.ts +89 -0
  150. package/dist/core/model-runtime.d.ts.map +1 -0
  151. package/dist/core/model-runtime.js +451 -0
  152. package/dist/core/model-runtime.js.map +1 -0
  153. package/dist/core/models-store.d.ts +17 -0
  154. package/dist/core/models-store.d.ts.map +1 -0
  155. package/dist/core/models-store.js +46 -0
  156. package/dist/core/models-store.js.map +1 -0
  157. package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
  158. package/dist/core/multi-agent/permission-gate.js +4 -3
  159. package/dist/core/multi-agent/permission-gate.js.map +1 -1
  160. package/dist/core/multi-agent/worktree.d.ts +2 -0
  161. package/dist/core/multi-agent/worktree.d.ts.map +1 -1
  162. package/dist/core/multi-agent/worktree.js +2 -2
  163. package/dist/core/multi-agent/worktree.js.map +1 -1
  164. package/dist/core/package-manager.d.ts +7 -1
  165. package/dist/core/package-manager.d.ts.map +1 -1
  166. package/dist/core/package-manager.js +41 -45
  167. package/dist/core/package-manager.js.map +1 -1
  168. package/dist/core/permission-relay/index.d.ts +19 -0
  169. package/dist/core/permission-relay/index.d.ts.map +1 -0
  170. package/dist/core/permission-relay/index.js +49 -0
  171. package/dist/core/permission-relay/index.js.map +1 -0
  172. package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
  173. package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
  174. package/dist/core/permission-relay/relay-ui-context.js +788 -0
  175. package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
  176. package/dist/core/permission-relay/types.d.ts +222 -0
  177. package/dist/core/permission-relay/types.d.ts.map +1 -0
  178. package/dist/core/permission-relay/types.js +15 -0
  179. package/dist/core/permission-relay/types.js.map +1 -0
  180. package/dist/core/pi-manifest.d.ts +14 -0
  181. package/dist/core/pi-manifest.d.ts.map +1 -0
  182. package/dist/core/pi-manifest.js +35 -0
  183. package/dist/core/pi-manifest.js.map +1 -0
  184. package/dist/core/project-trust.js +2 -2
  185. package/dist/core/project-trust.js.map +1 -1
  186. package/dist/core/prompt-templates.d.ts +1 -0
  187. package/dist/core/prompt-templates.d.ts.map +1 -1
  188. package/dist/core/prompt-templates.js +4 -4
  189. package/dist/core/prompt-templates.js.map +1 -1
  190. package/dist/core/provider-composer.d.ts +55 -0
  191. package/dist/core/provider-composer.d.ts.map +1 -0
  192. package/dist/core/provider-composer.js +375 -0
  193. package/dist/core/provider-composer.js.map +1 -0
  194. package/dist/core/radius.d.ts +2 -0
  195. package/dist/core/radius.d.ts.map +1 -0
  196. package/dist/core/radius.js +2 -0
  197. package/dist/core/radius.js.map +1 -0
  198. package/dist/core/remote-catalog-provider.d.ts +5 -0
  199. package/dist/core/remote-catalog-provider.d.ts.map +1 -0
  200. package/dist/core/remote-catalog-provider.js +115 -0
  201. package/dist/core/remote-catalog-provider.js.map +1 -0
  202. package/dist/core/resource-loader.d.ts +36 -0
  203. package/dist/core/resource-loader.d.ts.map +1 -1
  204. package/dist/core/resource-loader.js +159 -27
  205. package/dist/core/resource-loader.js.map +1 -1
  206. package/dist/core/runtime-credentials.d.ts +15 -0
  207. package/dist/core/runtime-credentials.d.ts.map +1 -0
  208. package/dist/core/runtime-credentials.js +35 -0
  209. package/dist/core/runtime-credentials.js.map +1 -0
  210. package/dist/core/sandbox/bash-operations.d.ts +149 -0
  211. package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
  212. package/dist/core/sandbox/bash-operations.js +163 -0
  213. package/dist/core/sandbox/bash-operations.js.map +1 -0
  214. package/dist/core/sandbox/env.d.ts +83 -0
  215. package/dist/core/sandbox/env.d.ts.map +1 -0
  216. package/dist/core/sandbox/env.js +123 -0
  217. package/dist/core/sandbox/env.js.map +1 -0
  218. package/dist/core/sandbox/executor.d.ts +104 -0
  219. package/dist/core/sandbox/executor.d.ts.map +1 -0
  220. package/dist/core/sandbox/executor.js +92 -0
  221. package/dist/core/sandbox/executor.js.map +1 -0
  222. package/dist/core/sandbox/index.d.ts +36 -0
  223. package/dist/core/sandbox/index.d.ts.map +1 -0
  224. package/dist/core/sandbox/index.js +36 -0
  225. package/dist/core/sandbox/index.js.map +1 -0
  226. package/dist/core/sandbox/linux.d.ts +121 -0
  227. package/dist/core/sandbox/linux.d.ts.map +1 -0
  228. package/dist/core/sandbox/linux.js +260 -0
  229. package/dist/core/sandbox/linux.js.map +1 -0
  230. package/dist/core/sandbox/policy.d.ts +142 -0
  231. package/dist/core/sandbox/policy.d.ts.map +1 -0
  232. package/dist/core/sandbox/policy.js +297 -0
  233. package/dist/core/sandbox/policy.js.map +1 -0
  234. package/dist/core/sandbox/real-path.d.ts +112 -0
  235. package/dist/core/sandbox/real-path.d.ts.map +1 -0
  236. package/dist/core/sandbox/real-path.js +158 -0
  237. package/dist/core/sandbox/real-path.js.map +1 -0
  238. package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
  239. package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
  240. package/dist/core/sandbox/seatbelt-profile.js +239 -0
  241. package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
  242. package/dist/core/sandbox/seatbelt.d.ts +95 -0
  243. package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
  244. package/dist/core/sandbox/seatbelt.js +154 -0
  245. package/dist/core/sandbox/seatbelt.js.map +1 -0
  246. package/dist/core/sandbox/self-test.d.ts +109 -0
  247. package/dist/core/sandbox/self-test.d.ts.map +1 -0
  248. package/dist/core/sandbox/self-test.js +369 -0
  249. package/dist/core/sandbox/self-test.js.map +1 -0
  250. package/dist/core/sandbox/spawn.d.ts +33 -0
  251. package/dist/core/sandbox/spawn.d.ts.map +1 -0
  252. package/dist/core/sandbox/spawn.js +87 -0
  253. package/dist/core/sandbox/spawn.js.map +1 -0
  254. package/dist/core/sdk.d.ts +3 -6
  255. package/dist/core/sdk.d.ts.map +1 -1
  256. package/dist/core/sdk.js +25 -22
  257. package/dist/core/sdk.js.map +1 -1
  258. package/dist/core/session-manager.d.ts +74 -7
  259. package/dist/core/session-manager.d.ts.map +1 -1
  260. package/dist/core/session-manager.js +169 -34
  261. package/dist/core/session-manager.js.map +1 -1
  262. package/dist/core/settings-manager.d.ts +22 -1
  263. package/dist/core/settings-manager.d.ts.map +1 -1
  264. package/dist/core/settings-manager.js +36 -16
  265. package/dist/core/settings-manager.js.map +1 -1
  266. package/dist/core/skills.d.ts +3 -1
  267. package/dist/core/skills.d.ts.map +1 -1
  268. package/dist/core/skills.js +19 -6
  269. package/dist/core/skills.js.map +1 -1
  270. package/dist/core/slash-commands.d.ts.map +1 -1
  271. package/dist/core/slash-commands.js +1 -0
  272. package/dist/core/slash-commands.js.map +1 -1
  273. package/dist/core/soak/soak-log.d.ts +298 -0
  274. package/dist/core/soak/soak-log.d.ts.map +1 -0
  275. package/dist/core/soak/soak-log.js +660 -0
  276. package/dist/core/soak/soak-log.js.map +1 -0
  277. package/dist/core/soak/soak-reader.d.ts +60 -0
  278. package/dist/core/soak/soak-reader.d.ts.map +1 -0
  279. package/dist/core/soak/soak-reader.js +106 -0
  280. package/dist/core/soak/soak-reader.js.map +1 -0
  281. package/dist/core/socket-server/discovery.d.ts +78 -1
  282. package/dist/core/socket-server/discovery.d.ts.map +1 -1
  283. package/dist/core/socket-server/discovery.js +356 -37
  284. package/dist/core/socket-server/discovery.js.map +1 -1
  285. package/dist/core/socket-server/index.d.ts +10 -4
  286. package/dist/core/socket-server/index.d.ts.map +1 -1
  287. package/dist/core/socket-server/index.js +6 -3
  288. package/dist/core/socket-server/index.js.map +1 -1
  289. package/dist/core/socket-server/permission-delivery.d.ts +125 -0
  290. package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
  291. package/dist/core/socket-server/permission-delivery.js +152 -0
  292. package/dist/core/socket-server/permission-delivery.js.map +1 -0
  293. package/dist/core/socket-server/permission-registry.d.ts +301 -0
  294. package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
  295. package/dist/core/socket-server/permission-registry.js +410 -0
  296. package/dist/core/socket-server/permission-registry.js.map +1 -0
  297. package/dist/core/socket-server/permission-relay.d.ts +81 -0
  298. package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
  299. package/dist/core/socket-server/permission-relay.js +528 -0
  300. package/dist/core/socket-server/permission-relay.js.map +1 -0
  301. package/dist/core/socket-server/safe-text.d.ts +83 -0
  302. package/dist/core/socket-server/safe-text.d.ts.map +1 -0
  303. package/dist/core/socket-server/safe-text.js +277 -0
  304. package/dist/core/socket-server/safe-text.js.map +1 -0
  305. package/dist/core/socket-server/session-integration.d.ts +65 -2
  306. package/dist/core/socket-server/session-integration.d.ts.map +1 -1
  307. package/dist/core/socket-server/session-integration.js +434 -32
  308. package/dist/core/socket-server/session-integration.js.map +1 -1
  309. package/dist/core/socket-server/socket-client.d.ts +21 -2
  310. package/dist/core/socket-server/socket-client.d.ts.map +1 -1
  311. package/dist/core/socket-server/socket-client.js +52 -1
  312. package/dist/core/socket-server/socket-client.js.map +1 -1
  313. package/dist/core/socket-server/socket-server.d.ts +152 -1
  314. package/dist/core/socket-server/socket-server.d.ts.map +1 -1
  315. package/dist/core/socket-server/socket-server.js +775 -26
  316. package/dist/core/socket-server/socket-server.js.map +1 -1
  317. package/dist/core/socket-server/types.d.ts +106 -2
  318. package/dist/core/socket-server/types.d.ts.map +1 -1
  319. package/dist/core/socket-server/types.js +13 -1
  320. package/dist/core/socket-server/types.js.map +1 -1
  321. package/dist/core/system-prompt.d.ts.map +1 -1
  322. package/dist/core/system-prompt.js +10 -21
  323. package/dist/core/system-prompt.js.map +1 -1
  324. package/dist/core/tools/bash.d.ts +3 -1
  325. package/dist/core/tools/bash.d.ts.map +1 -1
  326. package/dist/core/tools/bash.js +39 -7
  327. package/dist/core/tools/bash.js.map +1 -1
  328. package/dist/core/tools/edit.d.ts.map +1 -1
  329. package/dist/core/tools/edit.js +17 -2
  330. package/dist/core/tools/edit.js.map +1 -1
  331. package/dist/core/tools/find.d.ts +3 -0
  332. package/dist/core/tools/find.d.ts.map +1 -1
  333. package/dist/core/tools/find.js +11 -18
  334. package/dist/core/tools/find.js.map +1 -1
  335. package/dist/core/tools/read.js +1 -1
  336. package/dist/core/tools/read.js.map +1 -1
  337. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  338. package/dist/core/tools/tool-definition-wrapper.js +3 -1
  339. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  340. package/dist/core/trust-manager.d.ts +6 -4
  341. package/dist/core/trust-manager.d.ts.map +1 -1
  342. package/dist/core/trust-manager.js +55 -21
  343. package/dist/core/trust-manager.js.map +1 -1
  344. package/dist/core/usage-totals.d.ts +19 -0
  345. package/dist/core/usage-totals.d.ts.map +1 -0
  346. package/dist/core/usage-totals.js +52 -0
  347. package/dist/core/usage-totals.js.map +1 -0
  348. package/dist/extensions/index.d.ts +3 -0
  349. package/dist/extensions/index.d.ts.map +1 -0
  350. package/dist/extensions/index.js +7 -0
  351. package/dist/extensions/index.js.map +1 -0
  352. package/dist/extensions/llama/client.d.ts +61 -0
  353. package/dist/extensions/llama/client.d.ts.map +1 -0
  354. package/dist/extensions/llama/client.js +300 -0
  355. package/dist/extensions/llama/client.js.map +1 -0
  356. package/dist/extensions/llama/huggingface.d.ts +23 -0
  357. package/dist/extensions/llama/huggingface.d.ts.map +1 -0
  358. package/dist/extensions/llama/huggingface.js +139 -0
  359. package/dist/extensions/llama/huggingface.js.map +1 -0
  360. package/dist/extensions/llama/index.d.ts +3 -0
  361. package/dist/extensions/llama/index.d.ts.map +1 -0
  362. package/dist/extensions/llama/index.js +208 -0
  363. package/dist/extensions/llama/index.js.map +1 -0
  364. package/dist/extensions/llama/provider.d.ts +10 -0
  365. package/dist/extensions/llama/provider.d.ts.map +1 -0
  366. package/dist/extensions/llama/provider.js +111 -0
  367. package/dist/extensions/llama/provider.js.map +1 -0
  368. package/dist/extensions/llama/ui.d.ts +42 -0
  369. package/dist/extensions/llama/ui.d.ts.map +1 -0
  370. package/dist/extensions/llama/ui.js +400 -0
  371. package/dist/extensions/llama/ui.js.map +1 -0
  372. package/dist/extensions/stub-provider/index.d.ts +9 -0
  373. package/dist/extensions/stub-provider/index.d.ts.map +1 -0
  374. package/dist/extensions/stub-provider/index.js +13 -0
  375. package/dist/extensions/stub-provider/index.js.map +1 -0
  376. package/dist/extensions/stub-provider/provider.d.ts +77 -0
  377. package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
  378. package/dist/extensions/stub-provider/provider.js +193 -0
  379. package/dist/extensions/stub-provider/provider.js.map +1 -0
  380. package/dist/hooks/gsd/draht-quality-gate.js +3 -3
  381. package/dist/index.d.ts +4 -3
  382. package/dist/index.d.ts.map +1 -1
  383. package/dist/index.js +3 -3
  384. package/dist/index.js.map +1 -1
  385. package/dist/main.d.ts.map +1 -1
  386. package/dist/main.js +305 -61
  387. package/dist/main.js.map +1 -1
  388. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  389. package/dist/modes/interactive/components/assistant-message.js +22 -10
  390. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  391. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  392. package/dist/modes/interactive/components/config-selector.js +3 -2
  393. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  394. package/dist/modes/interactive/components/custom-editor.js +1 -1
  395. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  396. package/dist/modes/interactive/components/custom-message.d.ts +3 -1
  397. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  398. package/dist/modes/interactive/components/custom-message.js +9 -2
  399. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  400. package/dist/modes/interactive/components/extension-editor.d.ts +1 -2
  401. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  402. package/dist/modes/interactive/components/extension-editor.js +16 -46
  403. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  404. package/dist/modes/interactive/components/extension-selector.d.ts +49 -0
  405. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  406. package/dist/modes/interactive/components/extension-selector.js +202 -5
  407. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  408. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  409. package/dist/modes/interactive/components/footer.js +24 -23
  410. package/dist/modes/interactive/components/footer.js.map +1 -1
  411. package/dist/modes/interactive/components/login-dialog.d.ts +5 -5
  412. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  413. package/dist/modes/interactive/components/login-dialog.js +17 -8
  414. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  415. package/dist/modes/interactive/components/model-selector.d.ts +11 -4
  416. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  417. package/dist/modes/interactive/components/model-selector.js +74 -41
  418. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  419. package/dist/modes/interactive/components/oauth-selector.d.ts +4 -4
  420. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  421. package/dist/modes/interactive/components/oauth-selector.js +14 -25
  422. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  423. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  424. package/dist/modes/interactive/components/scoped-models-selector.js +22 -13
  425. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  426. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  427. package/dist/modes/interactive/components/session-selector.js +10 -2
  428. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  429. package/dist/modes/interactive/components/settings-selector.d.ts +2 -0
  430. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  431. package/dist/modes/interactive/components/settings-selector.js +10 -0
  432. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  433. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  434. package/dist/modes/interactive/components/tool-execution.js +10 -1
  435. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  436. package/dist/modes/interactive/components/tree-selector.d.ts +25 -2
  437. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  438. package/dist/modes/interactive/components/tree-selector.js +68 -17
  439. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  440. package/dist/modes/interactive/external-editor.d.ts +12 -0
  441. package/dist/modes/interactive/external-editor.d.ts.map +1 -0
  442. package/dist/modes/interactive/external-editor.js +37 -0
  443. package/dist/modes/interactive/external-editor.js.map +1 -0
  444. package/dist/modes/interactive/interactive-mode.d.ts +107 -10
  445. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  446. package/dist/modes/interactive/interactive-mode.js +763 -285
  447. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  448. package/dist/modes/rpc/rpc-client.d.ts +4 -0
  449. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  450. package/dist/modes/rpc/rpc-client.js +7 -0
  451. package/dist/modes/rpc/rpc-client.js.map +1 -1
  452. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  453. package/dist/modes/rpc/rpc-mode.js +185 -9
  454. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  455. package/dist/modes/rpc/rpc-types.d.ts +79 -1
  456. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  457. package/dist/modes/rpc/rpc-types.js.map +1 -1
  458. package/dist/package-manager-cli.d.ts.map +1 -1
  459. package/dist/package-manager-cli.js +67 -5
  460. package/dist/package-manager-cli.js.map +1 -1
  461. package/dist/prompts/commands/atomic-commit.md +1 -12
  462. package/dist/prompts/commands/brainstorm.md +12 -15
  463. package/dist/prompts/commands/create-verification-skill.md +108 -0
  464. package/dist/prompts/commands/discuss-phase.md +3 -14
  465. package/dist/prompts/commands/execute-phase.md +3 -11
  466. package/dist/prompts/commands/fix.md +41 -18
  467. package/dist/prompts/commands/grill.md +66 -0
  468. package/dist/prompts/commands/init-project.md +5 -15
  469. package/dist/prompts/commands/map-codebase.md +1 -13
  470. package/dist/prompts/commands/new-project.md +5 -15
  471. package/dist/prompts/commands/next-milestone.md +1 -13
  472. package/dist/prompts/commands/orchestrate.md +1 -1
  473. package/dist/prompts/commands/pause-work.md +1 -13
  474. package/dist/prompts/commands/plan-phase.md +2 -11
  475. package/dist/prompts/commands/progress.md +0 -13
  476. package/dist/prompts/commands/quick.md +3 -11
  477. package/dist/prompts/commands/resolve-conflicts.md +71 -0
  478. package/dist/prompts/commands/resume-work.md +0 -13
  479. package/dist/prompts/commands/review.md +4 -13
  480. package/dist/prompts/commands/triage.md +159 -0
  481. package/dist/prompts/commands/verify-work.md +4 -14
  482. package/dist/prompts/commands/why.md +135 -0
  483. package/dist/skills/atomic-reasoning/SKILL.md +115 -0
  484. package/dist/skills/blast-radius/SKILL.md +55 -0
  485. package/dist/skills/epistemics/SKILL.md +99 -0
  486. package/dist/skills/hexagon-animation/SKILL.md +49 -0
  487. package/dist/skills/hexagon-animation/generate.mjs +81 -0
  488. package/dist/skills/hexagon-animation/template.html +361 -0
  489. package/dist/skills/typescript-discipline/SKILL.md +50 -0
  490. package/dist/skills/typescript-discipline/references/patterns.md +294 -0
  491. package/dist/skills/unslop/SKILL.md +101 -0
  492. package/dist/utils/canonical-path.d.ts +28 -0
  493. package/dist/utils/canonical-path.d.ts.map +1 -0
  494. package/dist/utils/canonical-path.js +90 -0
  495. package/dist/utils/canonical-path.js.map +1 -0
  496. package/dist/utils/child-process.d.ts +12 -1
  497. package/dist/utils/child-process.d.ts.map +1 -1
  498. package/dist/utils/child-process.js +25 -8
  499. package/dist/utils/child-process.js.map +1 -1
  500. package/dist/utils/clipboard-native.d.ts +1 -0
  501. package/dist/utils/clipboard-native.d.ts.map +1 -1
  502. package/dist/utils/clipboard-native.js.map +1 -1
  503. package/dist/utils/clipboard.d.ts +2 -0
  504. package/dist/utils/clipboard.d.ts.map +1 -1
  505. package/dist/utils/clipboard.js +53 -9
  506. package/dist/utils/clipboard.js.map +1 -1
  507. package/dist/utils/exif-orientation.d.ts.map +1 -1
  508. package/dist/utils/exif-orientation.js +2 -3
  509. package/dist/utils/exif-orientation.js.map +1 -1
  510. package/dist/utils/paths.d.ts +2 -7
  511. package/dist/utils/paths.d.ts.map +1 -1
  512. package/dist/utils/paths.js +13 -15
  513. package/dist/utils/paths.js.map +1 -1
  514. package/dist/utils/shell.d.ts.map +1 -1
  515. package/dist/utils/shell.js +6 -4
  516. package/dist/utils/shell.js.map +1 -1
  517. package/dist/utils/tools-manager.d.ts.map +1 -1
  518. package/dist/utils/tools-manager.js +3 -5
  519. package/dist/utils/tools-manager.js.map +1 -1
  520. package/dist/utils/version-check.d.ts.map +1 -1
  521. package/dist/utils/version-check.js +3 -1
  522. package/dist/utils/version-check.js.map +1 -1
  523. package/docs/attachable-sessions.md +79 -0
  524. package/docs/compaction.md +29 -24
  525. package/docs/containerization.md +23 -23
  526. package/docs/custom-provider.md +66 -32
  527. package/docs/development.md +9 -9
  528. package/docs/docs.json +6 -2
  529. package/docs/duet.md +42 -0
  530. package/docs/environment-variables.md +88 -0
  531. package/docs/extensions.md +278 -65
  532. package/docs/index.md +12 -10
  533. package/docs/json.md +12 -8
  534. package/docs/keybindings.md +8 -5
  535. package/docs/llama-cpp.md +99 -0
  536. package/docs/models.md +19 -8
  537. package/docs/packages.md +43 -42
  538. package/docs/prompt-templates.md +5 -4
  539. package/docs/providers.md +45 -11
  540. package/docs/quickstart.md +33 -33
  541. package/docs/rpc.md +190 -19
  542. package/docs/sdk.md +18 -15
  543. package/docs/security.md +18 -18
  544. package/docs/session-format.md +53 -15
  545. package/docs/sessions.md +17 -14
  546. package/docs/settings.md +26 -19
  547. package/docs/shell-aliases.md +2 -2
  548. package/docs/skills.md +12 -11
  549. package/docs/terminal-setup.md +12 -12
  550. package/docs/termux.md +6 -6
  551. package/docs/themes.md +11 -11
  552. package/docs/tmux.md +4 -4
  553. package/docs/tui.md +46 -31
  554. package/docs/usage.md +53 -63
  555. package/docs/windows.md +2 -2
  556. package/examples/extensions/custom-compaction.ts +4 -0
  557. package/examples/extensions/custom-provider-anthropic/index.ts +9 -3
  558. package/examples/extensions/custom-provider-anthropic/package.json +1 -1
  559. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  560. package/examples/extensions/custom-provider-qwen-cli/package.json +1 -1
  561. package/examples/extensions/gondolin/package.json +2 -2
  562. package/examples/extensions/handoff.ts +9 -1
  563. package/examples/extensions/kimi-deferred-tools.ts +61 -0
  564. package/examples/extensions/message-renderer.ts +2 -2
  565. package/examples/extensions/overlay-qa-tests.ts +3 -3
  566. package/examples/extensions/sandbox/package.json +1 -1
  567. package/examples/extensions/summarize.ts +3 -0
  568. package/examples/extensions/with-deps/package.json +1 -1
  569. package/examples/sdk/02-custom-model.ts +5 -8
  570. package/examples/sdk/09-api-keys-and-oauth.ts +15 -31
  571. package/examples/sdk/12-full-control.ts +9 -12
  572. package/hooks/gsd/draht-quality-gate.js +3 -3
  573. package/package.json +14 -11
  574. package/prompts/commands/atomic-commit.md +1 -12
  575. package/prompts/commands/brainstorm.md +12 -15
  576. package/prompts/commands/create-verification-skill.md +108 -0
  577. package/prompts/commands/discuss-phase.md +3 -14
  578. package/prompts/commands/execute-phase.md +3 -11
  579. package/prompts/commands/fix.md +41 -18
  580. package/prompts/commands/grill.md +66 -0
  581. package/prompts/commands/init-project.md +5 -15
  582. package/prompts/commands/map-codebase.md +1 -13
  583. package/prompts/commands/new-project.md +5 -15
  584. package/prompts/commands/next-milestone.md +1 -13
  585. package/prompts/commands/orchestrate.md +1 -1
  586. package/prompts/commands/pause-work.md +1 -13
  587. package/prompts/commands/plan-phase.md +2 -11
  588. package/prompts/commands/progress.md +0 -13
  589. package/prompts/commands/quick.md +3 -11
  590. package/prompts/commands/resolve-conflicts.md +71 -0
  591. package/prompts/commands/resume-work.md +0 -13
  592. package/prompts/commands/review.md +4 -13
  593. package/prompts/commands/triage.md +159 -0
  594. package/prompts/commands/verify-work.md +4 -14
  595. package/prompts/commands/why.md +135 -0
  596. package/skills/atomic-reasoning/SKILL.md +115 -0
  597. package/skills/blast-radius/SKILL.md +55 -0
  598. package/skills/epistemics/SKILL.md +99 -0
  599. package/skills/hexagon-animation/SKILL.md +49 -0
  600. package/skills/hexagon-animation/generate.mjs +81 -0
  601. package/skills/hexagon-animation/template.html +361 -0
  602. package/skills/typescript-discipline/SKILL.md +50 -0
  603. package/skills/typescript-discipline/references/patterns.md +294 -0
  604. package/skills/unslop/SKILL.md +101 -0
  605. package/dist/core/provider-display-names.d.ts +0 -2
  606. package/dist/core/provider-display-names.d.ts.map +0 -1
  607. package/dist/core/provider-display-names.js +0 -36
  608. package/dist/core/provider-display-names.js.map +0 -1
  609. package/dist/prompts/agents/build.md +0 -86
  610. package/dist/prompts/agents/plan.md +0 -79
  611. package/dist/prompts/agents/verify.md +0 -69
  612. package/prompts/agents/build.md +0 -86
  613. package/prompts/agents/plan.md +0 -79
  614. package/prompts/agents/verify.md +0 -69
@@ -0,0 +1,294 @@
1
+ # TypeScript patterns
2
+
3
+ Worked don't/do examples for each rule in the table in `SKILL.md`. The principles behind them are language-agnostic; the syntax here is TypeScript's.
4
+
5
+ ## Branded types
6
+
7
+ Brand primitives so they can't be mixed up. Validate once at creation; downstream code trusts the type.
8
+
9
+ ```ts
10
+ type AgentId = string & { readonly __brand: "AgentId" };
11
+
12
+ function parseAgentId(input: string): AgentId {
13
+ if (!isUUID(input)) throw new Error(`Invalid agent id: ${input}`);
14
+ return input as AgentId;
15
+ }
16
+
17
+ function focusAgent(id: AgentId): void {
18
+ /* input is trusted */
19
+ }
20
+ ```
21
+
22
+ Match the `readonly __brand: 'X'` shape; don't invent a new convention.
23
+
24
+ ## Discriminated unions
25
+
26
+ If a bug forces the question "wait, can this combination actually happen?", the type is too loose. Model variants with a literal discriminant: every variant shares the field name and each variant's value is unique, so impossible combos can't be represented.
27
+
28
+ ```ts
29
+ // Don't. Boolean + optionals lets contradictory states exist.
30
+ type DiffState = { loading: boolean; diff?: GitDiff; error?: string };
31
+
32
+ // Do. Only valid states exist.
33
+ type DiffState =
34
+ | { kind: "loading" }
35
+ | { kind: "ready"; diff: GitDiff }
36
+ | { kind: "error"; error: string };
37
+ ```
38
+
39
+ Pick one discriminant name (`kind`, `type`, `tag`) per codebase and stick to it.
40
+
41
+ ## Constructive modeling
42
+
43
+ Build the type from parts that are all legal instead of restricting a loose type with runtime checks. Adding is easier than subtracting.
44
+
45
+ Non-empty, via a variadic tuple:
46
+
47
+ ```ts
48
+ type NonEmpty<T> = [T, ...T[]];
49
+
50
+ // Don't: T[] plus a length check every caller must repeat
51
+ function pickWinner(entries: string[]): string {
52
+ if (entries.length === 0) throw new Error("no entries");
53
+ return entries[Math.floor(Math.random() * entries.length)];
54
+ }
55
+
56
+ // Do: an empty value of the type can't exist
57
+ function pickWinner(entries: NonEmpty<string>): string {
58
+ return entries[Math.floor(Math.random() * entries.length)];
59
+ }
60
+ ```
61
+
62
+ Where a plain `T[]` arrives, narrow once with a guard. The fact then travels in the type:
63
+
64
+ ```ts
65
+ const isNonEmpty = <T>(arr: T[]): arr is NonEmpty<T> => arr.length > 0;
66
+ ```
67
+
68
+ Even length, as pairs — TypeScript has no refinement types (no `arr.length % 2 === 0` at the type level), and you don't need one:
69
+
70
+ ```ts
71
+ type Pairs<T> = [T, T][];
72
+ ```
73
+
74
+ A time range, as start plus duration:
75
+
76
+ ```ts
77
+ // Don't: a comment holds the invariant
78
+ type TimeRange = { start: Date; end: Date }; // start <= end
79
+
80
+ // Do: a negative range can't be written; derive end when needed
81
+ type TimeRange = { start: Date; durationMs: number };
82
+ ```
83
+
84
+ Keep `durationMs` a plain number; brand it (per Branded types) only if a raw number could plausibly be passed where a duration is expected, not by reflex. A `Pairs<T>` is an even-length list under the interpretation you give it, the same way `{ start, durationMs }` is a range. Pick the representation that makes the bad state unconstructable, then expose the reading you need on top (`pairs.flat()`, a `rangeEnd()` helper).
85
+
86
+ ## Simplest total type
87
+
88
+ Don't strengthen everything. Keep `T[]` while every operation on it is total:
89
+
90
+ ```ts
91
+ const sum = (xs: number[]) => xs.reduce((a, b) => a + b, 0); // [] is 0, fine
92
+ ```
93
+
94
+ Strengthen when the loose type forces a lie at a use site. The tells are `!`, `arr[0] as T`, and a "should never happen" throw:
95
+
96
+ ```ts
97
+ // Don't: partiality smuggled past the compiler
98
+ function newestSession(sessions: Session[]): Session {
99
+ return sessions.at(0)!;
100
+ }
101
+
102
+ // Do: strengthen the input; the assertion disappears
103
+ function newestSession(sessions: NonEmpty<Session>): Session {
104
+ return sessions[0];
105
+ }
106
+ ```
107
+
108
+ Weakening the result to `Session | undefined` is the other total signature. Either way the empty case lands at the call site — the one place that knows what empty means.
109
+
110
+ ## `unknown` over `any`
111
+
112
+ `any` disables type checking for everything it touches. External data is always `unknown`; narrow before use.
113
+
114
+ ```ts
115
+ // Don't
116
+ function handle(input: any) {
117
+ return input.foo.bar;
118
+ }
119
+
120
+ // Do
121
+ function handle(input: unknown) {
122
+ if (typeof input === "object" && input !== null && "foo" in input) {
123
+ // narrowed; the compiler verifies the access
124
+ }
125
+ }
126
+ ```
127
+
128
+ External sources include RPC payloads, `JSON.parse`, IPC, file contents, environment variables, and database results.
129
+
130
+ ## No `as` casts
131
+
132
+ Every `as` is a potential runtime crash. Cast only after validation has verified the claim — and the validation itself narrows without casting, or it proves nothing:
133
+
134
+ ```ts
135
+ // Don't
136
+ const user = data as User;
137
+
138
+ // Do. Earn the cast at the boundary; the checks narrow via typeof and `in`.
139
+ function parseUser(data: unknown): User {
140
+ if (typeof data !== "object" || data === null) {
141
+ throw new Error("expected object");
142
+ }
143
+ if (!("id" in data) || typeof data.id !== "string") {
144
+ throw new Error("expected string id");
145
+ }
146
+ // ... validate the remaining fields the same way
147
+ return data as User; // earned: every field was checked above
148
+ }
149
+ ```
150
+
151
+ When refactoring an `as` out of existing code, identify why the compiler can't infer:
152
+
153
+ - Missing discriminant: add one, switch to a discriminated union.
154
+ - Overly wide source type (e.g. `Record<string, unknown>`): narrow it.
155
+ - Untyped boundary: add a parse function or schema.
156
+ - Genuinely inexpressible: use a branded type or `satisfies`.
157
+
158
+ ## Narrowing hierarchy
159
+
160
+ From best to last-resort:
161
+
162
+ 1. **Discriminated union switch / if.** The compiler narrows automatically.
163
+ 2. **`in` operator.** `"key" in obj` narrows to the variants containing that key.
164
+ 3. **`typeof` / `instanceof`.** For primitives and class instances.
165
+ 4. **User-defined type guard.** When the above aren't enough.
166
+ 5. **`as` cast.** Only after validation.
167
+
168
+ ```ts
169
+ function area(s: Shape): number {
170
+ if ("radius" in s) return Math.PI * s.radius ** 2; // narrowed to circle
171
+ return s.width * s.height; // narrowed to rect
172
+ }
173
+ ```
174
+
175
+ ## Type guards
176
+
177
+ A guard must actually verify the claim. A lying guard is worse than `as` because the bug hides behind a name that says it's safe.
178
+
179
+ ```ts
180
+ function isCircle(s: Shape): s is Shape & { kind: "circle" } {
181
+ return s.kind === "circle";
182
+ }
183
+ ```
184
+
185
+ Prefer discriminant narrowing when possible — a guard adds a layer the reader has to follow.
186
+
187
+ ## Exhaustiveness
188
+
189
+ In default arms, assign the discriminant to a `never`-typed local. The compiler errors if a new variant is added without handling.
190
+
191
+ ```ts
192
+ // Value-returning switch
193
+ function area(s: Shape): number {
194
+ switch (s.kind) {
195
+ case "circle":
196
+ return Math.PI * s.radius ** 2;
197
+ case "rect":
198
+ return s.width * s.height;
199
+ default: {
200
+ const _exhaustive: never = s;
201
+ return _exhaustive;
202
+ }
203
+ }
204
+ }
205
+
206
+ // Void switch
207
+ function handle(s: Shape): void {
208
+ switch (s.kind) {
209
+ case "circle":
210
+ drawCircle(s);
211
+ break;
212
+ case "rect":
213
+ drawRect(s);
214
+ break;
215
+ default: {
216
+ const _exhaustive: never = s;
217
+ void _exhaustive;
218
+ }
219
+ }
220
+ }
221
+ ```
222
+
223
+ Return-style in value-returning switches; void-style in statement switches.
224
+
225
+ ## `satisfies` over `as`
226
+
227
+ `satisfies` validates without widening literal types.
228
+
229
+ ```ts
230
+ // Don't. Widens, loses literal types.
231
+ const config = { theme: "dark", cols: 3 } as Config;
232
+
233
+ // Do. Validates AND preserves literal types.
234
+ const config = { theme: "dark", cols: 3 } satisfies Config;
235
+ // config.theme is "dark" (literal), not string
236
+ ```
237
+
238
+ ## Boundary validation
239
+
240
+ Validate once where data crosses in; trust types inside. Scattered validation is noisy, redundant, and gives a false sense of safety.
241
+
242
+ - **At boundaries** (CLI args, config files, env vars, network payloads, database rows): parse into a named domain type, return errors, handle defensively.
243
+ - **Inside the system:** typed data, error propagation, no re-validation. No redundant null checks deep in call chains when the boundary already validated.
244
+ - **Across the boundary:** expose domain concepts, not the wire format — don't re-export transport, storage, or framework types through the public surface.
245
+ - **Wire formats** (proto, JSON-RPC): parse with unknown fields ignored so forward-compatible changes don't break old clients. **Persisted JSON:** versioned blob with a try/catch around the parse.
246
+ - Keep business logic in pure functions the boundary shell calls: parse functions as pure transforms from raw bytes to typed state, so the logic tests without the framework.
247
+
248
+ ## Schema-derived types
249
+
250
+ When a `.proto`, OpenAPI spec, GraphQL schema, or database migration already defines a shape, derive from the generated types instead of duplicating them.
251
+
252
+ ```ts
253
+ // Don't. Duplicate shape, drifts when the schema changes.
254
+ type CheckSummary = {
255
+ totalCount: number;
256
+ checks: { name: string; status: string }[];
257
+ };
258
+ function renderChecks(s: CheckSummary) {
259
+ /* ... */
260
+ }
261
+
262
+ // Do. Derive from the generated schema type.
263
+ import type { ChecksMessage } from "<generated module>";
264
+ function renderChecks(s: Pick<ChecksMessage, "totalCount" | "checks">) {
265
+ /* ... */
266
+ }
267
+ ```
268
+
269
+ Reach for `Pick`, `Omit`, `Parameters`, `ReturnType`, `Awaited`, `typeof` before writing a new interface.
270
+
271
+ ## Object args
272
+
273
+ ```ts
274
+ // Don't. Swap two args, still compiles.
275
+ openFile(uri, {
276
+ startLineNumber: 10,
277
+ startColumn: 1,
278
+ endLineNumber: 10,
279
+ endColumn: 1,
280
+ });
281
+
282
+ // Do. Order-independent, self-documenting.
283
+ openFile({
284
+ uri,
285
+ selection: {
286
+ startLineNumber: 10,
287
+ startColumn: 1,
288
+ endLineNumber: 10,
289
+ endColumn: 1,
290
+ },
291
+ });
292
+ ```
293
+
294
+ Skip on hot paths: per-frame render, tokenizers, parsers, anything in a tight loop where the allocation cost matters.
@@ -0,0 +1,101 @@
1
+ ---
2
+ name: unslop
3
+ description: Cut AI tells from prose deliverables the agent produces — docs, READMEs, reports, summaries, UAT reports, handoff documents, commit bodies, PR descriptions, client-facing text — then add voice back so the result is neither slop nor sterile. Use when writing or substantially editing any prose deliverable, or when the user says "unslop", "de-AI-ify", "sounds like AI", "make it sound human", or asks to clean up slop. Covers German prose by analogy (Füllwörter, Werbesprache, Anglizismen). Never applies to code, code comments, quoted output or evidence, machine-parsed formats (commit subjects, STATUS lines, frontmatter), or draht's own prompt and skill corpus.
4
+ ---
5
+
6
+ # Unslop
7
+
8
+ An editing pass over prose the agent produces. Run it while the deliverable is being written — as the report, doc, or handoff takes shape — never as a sweep over a repository. The job has two halves: cut the tells, then put voice back. Sterile prose is as recognizable as sloppy prose.
9
+
10
+ ## Scope
11
+
12
+ Unslop governs prose draht produces: docs, READMEs, reports, UAT reports, summaries, handoff documents, specs, commit bodies, PR descriptions, client-facing text.
13
+
14
+ It never applies to code, identifiers, or code comments, and never to user-authored text uninvited. Draht's own prompts and skills are not a target: the corpus legitimately uses em dashes and bold lead-ins as house style. This skill governs work products, not the toolchain's instruction files.
15
+
16
+ Edit only text you are producing or were asked to edit. Never rewrite quoted command output, error messages, evidence, or the user's own words. Fixed formats stay fixed: conventional-commit subject lines, red:/green:/refactor: prefixes, STATUS: lines, frontmatter, verdict-first report ordering.
17
+
18
+ ## Process
19
+
20
+ 1. Scan the text for the patterns below.
21
+ 2. Rewrite. Preserve meaning and register.
22
+ 3. Add voice back — register-aware (see Adding Voice).
23
+ 4. Self-audit: ask "What makes this obviously AI generated?" and fix the remaining tells.
24
+
25
+ ## Patterns
26
+
27
+ Every entry pairs the tell with its fix.
28
+
29
+ ### Content
30
+
31
+ - **Puffery and promotional language.** "pivotal moment", "testament to", "evolving landscape", "groundbreaking", "vibrant", "renowned", "stunning". Cut it; state what happened.
32
+ - **Superficial -ing phrases.** "highlighting...", "ensuring...", "showcasing...", "fostering...". Delete, or expand into a real statement with a real source.
33
+ - **Vague attributions.** "Experts believe", "reports suggest", "some argue". Name the source or delete. In a report this means citing the command or file, not "tests suggest".
34
+
35
+ ### Language
36
+
37
+ - **AI vocabulary** (English-calibrated): additionally, crucial, delve, enduring, enhance, fostering, garner, interplay, intricate, landscape (abstract), pivotal, showcase, tapestry (abstract), testament, underscore, vibrant. Use the plain word.
38
+ - **Fancy ways to say "is".** "serves as", "stands as", "boasts", "features". Say "is" or "has".
39
+ - **"Not just X, but Y."** State the point directly.
40
+ - **Rule of three.** Ideas forced into groups of three. Use the natural number.
41
+ - **Synonym cycling.** Protagonist, main character, central figure, hero in one paragraph. Pick one term and repeat it — repeating the established name is precision, not monotony.
42
+ - **False ranges.** "from X to Y" where X and Y sit on no meaningful scale. List the items directly.
43
+
44
+ ### Style
45
+
46
+ - **Dash moderation.** An em dash is punctuation, not a tell. Three per paragraph is. Do not chain them, do not let dashes replace every comma and period; vary the connective.
47
+ - **Colon crutches.** A colon is for a list or an example, not a mid-sentence connector. Rewrite so the point stands on its own.
48
+ - **Boldface spam.** Don't bold every noun, proper name, or acronym.
49
+ - **Inline-header lists.** The tell is a bold label and colon restating the line. A bold lead-in ending in a period, naming the item, followed by genuinely new detail is fine.
50
+ - **Headings** (English-only rule): sentence case, not title case.
51
+ - **Decorative emojis.** Remove from headings and bullets.
52
+ - **Curly quotes.** Replace with straight quotes.
53
+
54
+ ### Communication Artifacts
55
+
56
+ The group most relevant to reports and handoffs.
57
+
58
+ - **Chatbot phrases.** "I hope this helps!", "Let me know if...", "Certainly!", "Found the smoking gun!". Remove.
59
+ - **Cutoff disclaimers.** "While specific details are limited...". Find the fact or drop the sentence.
60
+ - **Sycophancy.** "Great question!", "You're absolutely right!". Respond directly.
61
+
62
+ ### Filler
63
+
64
+ - **Filler phrases** (English-calibrated). "In order to" becomes "To". "Due to the fact that" becomes "Because". "It is important to note that" gets deleted.
65
+ - **Hedging stacks.** "could potentially possibly be argued that it might" becomes "may".
66
+ - **Generic conclusions.** "The future looks bright." State the specific plan or fact, or end one sentence earlier.
67
+
68
+ ### Jargon
69
+
70
+ - **Abstract metaphor nouns.** Substrate, wedge, vector, nexus, bedrock, modality, paradigm, north star, flywheel, endgame. These sound technical but hide a plainer concrete word: "substrate" becomes "base", "wedge in" becomes "add", "north star" / "flywheel" / "endgame" become the plain phrase. Pick the concrete word.
71
+ - **Carve-out.** A term defined in .planning/DOMAIN.md or established in the project's vocabulary is never slop — the ubiquitous-language rule wins over this list.
72
+
73
+ ### Plain Speech
74
+
75
+ - **Name the mechanism, not the feeling.** "the database stays close at hand" names a feeling; "a column rename fails the build" names a mechanism. Restate every claim as a concrete instruction, fact, or number — or cut it. If the sentence could appear unchanged in another project's docs, it says nothing about this one. Cut it.
76
+ - **One idea per sentence.** If the reader has to backtrack to parse a sentence, split it or drop clauses.
77
+ - **Active voice with a named actor.** "queries are validated" becomes "the compiler validates queries". Passive is fine only when the actor is unknown or genuinely irrelevant.
78
+ - **Cut adverbs, or use the measured number.** "significantly improves" becomes the measured delta. An adverb propping up a weak verb means the verb is wrong.
79
+ - **Prefer the plain word** (English-calibrated). "utilize" becomes "use", "leverage" becomes "use", "facilitate" becomes "help", "numerous" becomes "many", "in the event that" becomes "if".
80
+
81
+ ## Adding Voice
82
+
83
+ Removing patterns is half the job — voiceless prose is just as obviously machine-made. Register decides how much voice returns:
84
+
85
+ - **Docs and READMEs**: have opinions and react to facts instead of neutrally listing pros and cons; vary rhythm (short sentences, then longer ones that take their time); use "I" when it fits; be specific.
86
+ - **Reports, UAT reports, handoffs, client-facing text**: stay factual and concrete. Specificity is the voice there — name the file, the count, the command. No filler warmth, no manufactured mess.
87
+
88
+ ## German Prose
89
+
90
+ The word lists above are English-calibrated. The discipline generalizes to German by category, not by translated catalog:
91
+
92
+ - **Füllwörter**: "im Grunde genommen", "quasi", "sozusagen" — streichen.
93
+ - **Werbesprache**: "innovativ", "ganzheitlich", "im heutigen digitalen Zeitalter", "spielt eine entscheidende Rolle" — sagen, was passiert ist.
94
+ - **Anglizismen-Slop**: "leveragen", "alignen" where a German word exists — use the German word.
95
+ - "nicht nur X, sondern auch Y" is the "not just X, but Y" tell verbatim: state the point directly.
96
+ - Style and format tells (dash chaining, bold spam, decorative emojis, curly quotes) and communication artifacts (chatbot phrases, disclaimers, sycophancy) are language-independent.
97
+ - The sentence-case-headings rule is English-only — German headings follow German orthography.
98
+
99
+ ## Self-Audit
100
+
101
+ Before delivering, ask once more: "What makes this obviously AI generated?" Fix what you find.
@@ -1,2 +0,0 @@
1
- export declare const BUILT_IN_PROVIDER_DISPLAY_NAMES: Record<string, string>;
2
- //# sourceMappingURL=provider-display-names.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"provider-display-names.d.ts","sourceRoot":"","sources":["../../src/core/provider-display-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkClE,CAAC"}
@@ -1,36 +0,0 @@
1
- export const BUILT_IN_PROVIDER_DISPLAY_NAMES = {
2
- anthropic: "Anthropic",
3
- "amazon-bedrock": "Amazon Bedrock",
4
- "ant-ling": "Ant Ling",
5
- "azure-openai-responses": "Azure OpenAI Responses",
6
- cerebras: "Cerebras",
7
- "cloudflare-ai-gateway": "Cloudflare AI Gateway",
8
- "cloudflare-workers-ai": "Cloudflare Workers AI",
9
- deepseek: "DeepSeek",
10
- fireworks: "Fireworks",
11
- google: "Google Gemini",
12
- "google-vertex": "Google Vertex AI",
13
- groq: "Groq",
14
- huggingface: "Hugging Face",
15
- "kimi-coding": "Kimi For Coding",
16
- mistral: "Mistral",
17
- minimax: "MiniMax",
18
- "minimax-cn": "MiniMax (China)",
19
- moonshotai: "Moonshot AI",
20
- "moonshotai-cn": "Moonshot AI (China)",
21
- nvidia: "NVIDIA NIM",
22
- opencode: "OpenCode Zen",
23
- "opencode-go": "OpenCode Go",
24
- openai: "OpenAI",
25
- openrouter: "OpenRouter",
26
- together: "Together AI",
27
- "vercel-ai-gateway": "Vercel AI Gateway",
28
- xai: "xAI",
29
- zai: "ZAI Coding Plan (Global)",
30
- "zai-coding-cn": "ZAI Coding Plan (China)",
31
- xiaomi: "Xiaomi MiMo",
32
- "xiaomi-token-plan-cn": "Xiaomi MiMo Token Plan (China)",
33
- "xiaomi-token-plan-ams": "Xiaomi MiMo Token Plan (Amsterdam)",
34
- "xiaomi-token-plan-sgp": "Xiaomi MiMo Token Plan (Singapore)",
35
- };
36
- //# sourceMappingURL=provider-display-names.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"provider-display-names.js","sourceRoot":"","sources":["../../src/core/provider-display-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAA2B;IACtE,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,gBAAgB;IAClC,UAAU,EAAE,UAAU;IACtB,wBAAwB,EAAE,wBAAwB;IAClD,QAAQ,EAAE,UAAU;IACpB,uBAAuB,EAAE,uBAAuB;IAChD,uBAAuB,EAAE,uBAAuB;IAChD,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,eAAe;IACvB,eAAe,EAAE,kBAAkB;IACnC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,iBAAiB;IAChC,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,iBAAiB;IAC/B,UAAU,EAAE,aAAa;IACzB,eAAe,EAAE,qBAAqB;IACtC,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,aAAa;IACvB,mBAAmB,EAAE,mBAAmB;IACxC,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,0BAA0B;IAC/B,eAAe,EAAE,yBAAyB;IAC1C,MAAM,EAAE,aAAa;IACrB,sBAAsB,EAAE,gCAAgC;IACxD,uBAAuB,EAAE,oCAAoC;IAC7D,uBAAuB,EAAE,oCAAoC;CAC7D,CAAC","sourcesContent":["export const BUILT_IN_PROVIDER_DISPLAY_NAMES: Record<string, string> = {\n\tanthropic: \"Anthropic\",\n\t\"amazon-bedrock\": \"Amazon Bedrock\",\n\t\"ant-ling\": \"Ant Ling\",\n\t\"azure-openai-responses\": \"Azure OpenAI Responses\",\n\tcerebras: \"Cerebras\",\n\t\"cloudflare-ai-gateway\": \"Cloudflare AI Gateway\",\n\t\"cloudflare-workers-ai\": \"Cloudflare Workers AI\",\n\tdeepseek: \"DeepSeek\",\n\tfireworks: \"Fireworks\",\n\tgoogle: \"Google Gemini\",\n\t\"google-vertex\": \"Google Vertex AI\",\n\tgroq: \"Groq\",\n\thuggingface: \"Hugging Face\",\n\t\"kimi-coding\": \"Kimi For Coding\",\n\tmistral: \"Mistral\",\n\tminimax: \"MiniMax\",\n\t\"minimax-cn\": \"MiniMax (China)\",\n\tmoonshotai: \"Moonshot AI\",\n\t\"moonshotai-cn\": \"Moonshot AI (China)\",\n\tnvidia: \"NVIDIA NIM\",\n\topencode: \"OpenCode Zen\",\n\t\"opencode-go\": \"OpenCode Go\",\n\topenai: \"OpenAI\",\n\topenrouter: \"OpenRouter\",\n\ttogether: \"Together AI\",\n\t\"vercel-ai-gateway\": \"Vercel AI Gateway\",\n\txai: \"xAI\",\n\tzai: \"ZAI Coding Plan (Global)\",\n\t\"zai-coding-cn\": \"ZAI Coding Plan (China)\",\n\txiaomi: \"Xiaomi MiMo\",\n\t\"xiaomi-token-plan-cn\": \"Xiaomi MiMo Token Plan (China)\",\n\t\"xiaomi-token-plan-ams\": \"Xiaomi MiMo Token Plan (Amsterdam)\",\n\t\"xiaomi-token-plan-sgp\": \"Xiaomi MiMo Token Plan (Singapore)\",\n};\n"]}
@@ -1,86 +0,0 @@
1
- ---
2
- description: "Execution agent that implements plans precisely"
3
- ---
4
-
5
- # Draht Build Agent
6
-
7
- You are an execution agent. Your job is to implement plans precisely.
8
-
9
- ## Core Rules
10
- 1. Read the plan FIRST — it is your instruction set
11
- 2. Execute tasks in order, one at a time
12
- 3. VERIFY each task before moving to the next
13
- 4. Commit after each task: `draht commit-task N P T "description"`
14
- 5. If verification fails, fix it before continuing
15
- 6. Never skip a verify step — that's how quality dies
16
- 7. If a plan instruction contradicts what you find in the code, STOP and report `NEEDS_CONTEXT` — do not silently obey either side
17
-
18
- ## Evidence, Not Plausibility
19
-
20
- A step is done when you have watched it be done.
21
-
22
- **Procedure:**
23
- 1. "Verified" means you ran the command and read the output in this session — not that the code looks right.
24
- 2. Quote the decisive line of output in your summary: test counts, exit codes, the actual error text.
25
- 3. If you did not run it, write "not verified" — never let a plausible claim wear a verified claim's clothes.
26
-
27
- **Example:** after implementing a parser, "bun test parser: 14 pass, 0 fail" is evidence; "the parser now handles all cases" is a guess in a suit.
28
-
29
- **Prevents:** reporting a green build nobody ever ran.
30
-
31
- ## Competence Mimics
32
-
33
- These feel like progress and are not:
34
-
35
- | Looks like competence | Is actually |
36
- |---|---|
37
- | A test that passes on first run | Probably asserts nothing — break the code, watch it fail (red first) |
38
- | A large diff | Unreviewable risk; the plan asked for the minimal green change |
39
- | "Refactored while I was in there" | Scope drift that hides which change broke what |
40
- | A confident summary of a file you skimmed | A guess — read it or say you didn't |
41
- | Silencing a failing check to keep moving | Deleting the only warning you'll get |
42
- | Obeying the plan where it contradicts the code | The code is reality — report the conflict |
43
-
44
- ## Tools Available
45
- - `draht read-plan N P` — read the plan to execute
46
- - `draht commit-task N P T "desc"` — atomic commit per task
47
- - `draht write-summary N P` — write completion summary
48
- - `draht verify-phase N` — check phase completion
49
- - `draht update-state` — update STATE.md
50
-
51
- ## Process (TDD-First)
52
- 1. Read plan: `draht read-plan N P`
53
- 2. For each <task>:
54
- a. Read the <test> block — write the test code FIRST (expect RED — tests should fail)
55
- b. Read the <action> — implement to make tests GREEN
56
- c. Read the <refactor> — clean up while keeping tests green
57
- d. Run the <verify> step
58
- e. If verify passes: `draht commit-task N P T "task name"`
59
- f. If verify fails: fix and retry (max 3 attempts)
60
- g. If a task has no <test> block, write a test anyway before implementing
61
- 3. After all tasks: `draht write-summary N P`
62
- 4. Fill in the summary with actual commits, files changed, notes
63
- 5. After all plans in phase: `draht verify-phase N`
64
-
65
- ## Summary Format
66
- Verdict first (what state is the plan in), then evidence (quoted verify output per task), then remaining risk (what you did not verify, labeled as such). Never bury a failed task under completed ones.
67
-
68
- ## Checkpoint Handling
69
- - `type="auto"` → execute silently
70
- - `type="checkpoint:human-verify"` → STOP, show what was built, ask for confirmation
71
- - `type="checkpoint:decision"` → STOP, present options, wait for choice
72
-
73
- ## On Failure
74
- If a task fails 3 times:
75
- 1. Document what went wrong in the summary
76
- 2. Mark task as failed
77
- 3. Continue to next task (unless it depends on the failed one)
78
- 4. Note the failure for fix planning
79
-
80
- ## Send Gate — run before finishing
81
-
82
- 1. **Asked** — did you build what the plan's <done> describes, not just what its literal steps said?
83
- 2. **Evidence** — does every "done" claim quote the output that proves it, with unrun checks labeled "not verified"?
84
- 3. **Attacked** — did each test fail before the implementation made it pass?
85
- 4. **Ordered** — verdict first, evidence second, remaining risk last?
86
- 5. **Wrongness** — if this work is broken, where is it most likely — and did you run that path?
@@ -1,79 +0,0 @@
1
- ---
2
- description: "Planning agent that creates atomic, executable plans"
3
- ---
4
-
5
- # Draht Plan Agent
6
-
7
- You are a planning agent. Your job is to create atomic, executable plans.
8
-
9
- ## Core Rules
10
- 1. Plans are prompts — they tell the executor EXACTLY what to build
11
- 2. Each task must be atomic (one clear action, one verify step)
12
- 3. Maximum 5 tasks per plan
13
- 4. Goal-backward: start from "what must be TRUE" not "what should we build"
14
- 5. Every task needs <verify> and <done> — no ambiguity
15
- 6. A task is atomic only if its <verify> can fail while every other task passes — if two tasks can only be checked together, they are one task
16
- 7. Every assumption a plan rests on gets an explicit `Assumes:` line (with how to confirm it) in the plan header — unwritten assumptions become the executor's bugs
17
-
18
- ## Read the Goal Beneath the Goal
19
-
20
- The phase description says what to build; the plan must capture what must become true.
21
-
22
- **Procedure:**
23
- 1. Restate the phase goal as the change in the user's world: "after this phase, a user can X."
24
- 2. If the goal names a mechanism ("add Redis caching"), find the outcome behind it ("p95 under 200ms") and plan toward the outcome — the mechanism is a candidate, not a requirement.
25
- 3. If you cannot state the outcome, the phase is not plannable yet — report `NEEDS_CONTEXT` instead of planning the mechanism.
26
-
27
- **Example:** "add retry logic to the sync job" → the outcome is "syncs recover from transient failures without human help." That truth may need idempotency more than retries; a plan built on the literal words ships retries that double-write.
28
-
29
- **Prevents:** precisely executing the wrong plan.
30
-
31
- ## Risk-First Ordering
32
-
33
- Not all tasks deserve equal effort or the same position in the sequence.
34
-
35
- **Procedure:**
36
- 1. For each observable truth, score uncertainty (has this codebase done it before?) and blast radius (how much of the plan is invalid if it's wrong?).
37
- 2. Order plans and tasks so the highest uncertainty × blast-radius truth is proven first.
38
- 3. Boilerplate goes last — it never invalidates a plan; the risky part regularly does.
39
-
40
- **Example:** a phase needs a third-party webhook plus a settings UI. The webhook contract is the risk: plan 1 proves an end-to-end webhook round-trip; the UI waits.
41
-
42
- **Prevents:** discovering in task 9 that the foundation under tasks 1–8 cannot work.
43
-
44
- ## Tools Available
45
- - `draht load-phase-context N` — gather all context for a phase
46
- - `draht create-plan N P "title"` — create plan template
47
- - `draht validate-plans N` — check plans for completeness
48
- - `draht research-phase N` — create research template
49
- - `draht commit-docs "message"` — commit planning docs
50
-
51
- ## Process
52
- 1. Load all context: `draht load-phase-context N`
53
- 2. State the goal as an outcome
54
- 3. List 3-7 observable truths that must be TRUE
55
- 4. Map truths to files/endpoints/artifacts
56
- 5. Group into plans of 2-5 tasks each
57
- 6. Write plans using XML task format
58
- 7. Validate: `draht validate-plans N`
59
-
60
- ## XML Task Format
61
- ```xml
62
- <task type="auto">
63
- <n>Short task name</n>
64
- <files>path/to/files</files>
65
- <action>Precise instructions. No ambiguity.</action>
66
- <verify>Command or check to verify</verify>
67
- <done>What "done" looks like from user perspective</done>
68
- </task>
69
- ```
70
-
71
- Task types: auto, checkpoint:human-verify, checkpoint:decision
72
-
73
- ## Send Gate — run before finishing
74
-
75
- 1. **Asked** — do the plans produce the outcome behind the request, not just its literal words?
76
- 2. **Evidence** — is every claim about the codebase something you read, with assumptions written as `Assumes:` lines?
77
- 3. **Attacked** — did you try to break your own decomposition (a truth with no task, a task with no independent check)?
78
- 4. **Ordered** — does the riskiest truth get proven first?
79
- 5. **Wrongness** — if these plans fail, where is it most likely — and does a task check exactly there?