@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.
- package/CHANGELOG.md +138 -0
- package/agents/advisor.md +2 -2
- package/agents/architect.md +11 -33
- package/agents/debugger.md +13 -54
- package/agents/git-committer.md +18 -42
- package/agents/implementer.md +14 -36
- package/agents/investigator.md +12 -63
- package/agents/reviewer.md +16 -44
- package/agents/security-auditor.md +22 -56
- package/agents/spec-reviewer.md +13 -53
- package/agents/verifier.md +14 -33
- package/bin/drahtbank.mjs +4 -0
- package/dist/agents/advisor.md +2 -2
- package/dist/agents/architect.md +11 -33
- package/dist/agents/debugger.md +13 -54
- package/dist/agents/git-committer.md +18 -42
- package/dist/agents/implementer.md +14 -36
- package/dist/agents/investigator.md +12 -63
- package/dist/agents/reviewer.md +16 -44
- package/dist/agents/security-auditor.md +22 -56
- package/dist/agents/spec-reviewer.md +13 -53
- package/dist/agents/verifier.md +14 -33
- package/dist/bundle/chunks/anthropic-messages-G57VPNTF.js +6 -0
- package/dist/bundle/chunks/anthropic.js +1 -1
- package/dist/bundle/chunks/azure-openai-responses-AYUCZ5WN.js +2 -0
- package/dist/bundle/chunks/bedrock-converse-stream.js +31 -28
- package/dist/bundle/chunks/chunk-2JZLKNZ4.js +3 -0
- package/dist/bundle/chunks/chunk-3GDEPGTR.js +16 -0
- package/dist/bundle/chunks/chunk-5JW3NSTV.js +2 -0
- package/dist/bundle/chunks/{chunk-KVH4HR57.js → chunk-6WESOD4H.js} +1 -1
- package/dist/bundle/chunks/chunk-76YNMQ57.js +2 -0
- package/dist/bundle/chunks/chunk-AC3MSTC6.js +2 -0
- package/dist/bundle/chunks/chunk-ACLWH5WQ.js +2 -0
- package/dist/bundle/chunks/chunk-BL72B6LV.js +82 -0
- package/dist/bundle/chunks/chunk-CLKG6K6Z.js +7 -0
- package/dist/bundle/chunks/chunk-DN7SM3LX.js +479 -0
- package/dist/bundle/chunks/{chunk-D6TMD5Q2.js → chunk-DOUMZTXH.js} +10 -10
- package/dist/bundle/chunks/chunk-DQ4G4IS4.js +20 -0
- package/dist/bundle/chunks/chunk-E4VZJRJ2.js +9 -0
- package/dist/bundle/chunks/chunk-FOYIPAAD.js +6 -0
- package/dist/bundle/chunks/chunk-FXCTQRNN.js +2 -0
- package/dist/bundle/chunks/chunk-GBFVS2SF.js +12 -0
- package/dist/bundle/chunks/chunk-GQXRTK54.js +20 -0
- package/dist/bundle/chunks/chunk-IGO52ZOY.js +132 -0
- package/dist/bundle/chunks/chunk-IT4RIOZD.js +2 -0
- package/dist/bundle/chunks/chunk-JJKPUMH2.js +1424 -0
- package/dist/bundle/chunks/chunk-JNWRE5F4.js +2 -0
- package/dist/bundle/chunks/chunk-KSGHCBHT.js +2 -0
- package/dist/bundle/chunks/chunk-LO6CVU2L.js +6 -0
- package/dist/bundle/chunks/chunk-MBFTIGLS.js +2 -0
- package/dist/bundle/chunks/chunk-N26RGV3K.js +11 -0
- package/dist/bundle/chunks/{chunk-KPO5375S.js → chunk-RCRGGYLW.js} +1 -1
- package/dist/bundle/chunks/chunk-UCJ7FLSO.js +166 -0
- package/dist/bundle/chunks/chunk-USCN7R2E.js +2 -0
- package/dist/bundle/chunks/chunk-WFHH5SX6.js +4 -0
- package/dist/bundle/chunks/chunk-WYWBXNDO.js +6 -0
- package/dist/bundle/chunks/chunk-ZRPAOMVB.js +2 -0
- package/dist/bundle/chunks/{cli-PYJB6AQ3.js → cli-HTUB6WOG.js} +6 -6
- package/dist/bundle/chunks/cloudflare-workers-ai-system-one-RRSO6OXX.js +2 -0
- package/dist/bundle/chunks/codemode-worker.js +188 -21
- package/dist/bundle/chunks/execute-UUPNZJJG.js +31 -0
- package/dist/bundle/chunks/github-copilot.js +1 -1
- package/dist/bundle/chunks/google-generative-ai-VJSS5EBX.js +2 -0
- package/dist/bundle/chunks/google-vertex-K23DBWTT.js +2 -0
- package/dist/bundle/chunks/https-proxy-agent-WQIRL24U.js +13 -0
- package/dist/bundle/chunks/image-resize-worker.js +1 -1
- package/dist/bundle/chunks/lib-ULKZYRGD.js +9 -0
- package/dist/bundle/chunks/{llama-cpp-classify-EJ5XMSQL.js → llama-cpp-classify-3VDXTYVJ.js} +3 -3
- package/dist/bundle/chunks/mistral-conversations-SKVQJGFZ.js +5 -0
- package/dist/bundle/chunks/{multipart-parser-AZP5BX2W.js → multipart-parser-HMCXZ4BD.js} +1 -1
- package/dist/bundle/chunks/node-DXZFQBEO.js +16 -0
- package/dist/bundle/chunks/{node-C2JGH2OB.js → node-LBZLUIBE.js} +1 -1
- package/dist/bundle/chunks/openai-chatgpt.js +1 -1
- package/dist/bundle/chunks/openai-codex-responses-LV4RIZL3.js +10 -0
- package/dist/bundle/chunks/openai-codex.js +1 -1
- package/dist/bundle/chunks/openai-completions-PUIR2V25.js +7 -0
- package/dist/bundle/chunks/openai-decisions-2DJLSYQF.js +5 -0
- package/dist/bundle/chunks/openai-responses-6ESQOXAF.js +4 -0
- package/dist/bundle/chunks/opencode-go.js +1 -1
- package/dist/bundle/chunks/openrouter-images-TVXBMY3V.js +2 -0
- package/dist/bundle/chunks/pi-messages-XS7FDWQI.js +8 -0
- package/dist/bundle/chunks/runtime-IB3XQ7E3.js +2 -0
- package/dist/bundle/chunks/runtime-LB35PK4J.js +3 -0
- package/dist/bundle/chunks/settings-manager-YNY5F4RU.js +2 -0
- package/dist/bundle/chunks/src-KDGO7EGF.js +4 -0
- package/dist/bundle/chunks/typesafe-system-one-67GAWZXE.js +2 -0
- package/dist/bundle/chunks/virtual-modules-U4CBGVMI.js +2 -0
- package/dist/bundle/cli-runtime.js +1 -1
- package/dist/bundle/index.js +1 -1
- package/dist/bundle/rpc-entry.js +1 -1
- package/dist/cli/args.d.ts +2 -1
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +30 -8
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/credential-print.d.ts.map +1 -1
- package/dist/cli/credential-print.js +4 -4
- package/dist/cli/credential-print.js.map +1 -1
- package/dist/config.d.ts +18 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +44 -6
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session.d.ts +65 -8
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +240 -102
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +20 -13
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/bash-executor.d.ts.map +1 -1
- package/dist/core/bash-executor.js +42 -52
- package/dist/core/bash-executor.js.map +1 -1
- package/dist/core/bug-report.d.ts +9 -1
- package/dist/core/bug-report.d.ts.map +1 -1
- package/dist/core/builtins/completion-checks.d.ts +3 -0
- package/dist/core/builtins/completion-checks.d.ts.map +1 -0
- package/dist/core/builtins/completion-checks.js +142 -0
- package/dist/core/builtins/completion-checks.js.map +1 -0
- package/dist/core/builtins/duet.d.ts.map +1 -1
- package/dist/core/builtins/duet.js +7 -5
- package/dist/core/builtins/duet.js.map +1 -1
- package/dist/core/builtins/git-safety.d.ts +3 -0
- package/dist/core/builtins/git-safety.d.ts.map +1 -0
- package/dist/core/builtins/git-safety.js +34 -0
- package/dist/core/builtins/git-safety.js.map +1 -0
- package/dist/core/builtins/index.d.ts.map +1 -1
- package/dist/core/builtins/index.js +4 -0
- package/dist/core/builtins/index.js.map +1 -1
- package/dist/core/client-identity.d.ts +8 -0
- package/dist/core/client-identity.d.ts.map +1 -0
- package/dist/core/client-identity.js +15 -0
- package/dist/core/client-identity.js.map +1 -0
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +1 -2
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +2 -2
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +20 -15
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/compaction/utils.d.ts +6 -0
- package/dist/core/compaction/utils.d.ts.map +1 -1
- package/dist/core/compaction/utils.js +7 -8
- package/dist/core/compaction/utils.js.map +1 -1
- package/dist/core/export-html/index.d.ts.map +1 -1
- package/dist/core/export-html/index.js +2 -0
- package/dist/core/export-html/index.js.map +1 -1
- package/dist/core/export-html/template.html +1 -0
- package/dist/core/export-html/template.js +23 -17
- package/dist/core/export-html/tool-renderer.d.ts +3 -3
- package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
- package/dist/core/export-html/tool-renderer.js +5 -3
- package/dist/core/export-html/tool-renderer.js.map +1 -1
- package/dist/core/export-html/vendor/marked-cjk-friendly.min.js +6 -0
- package/dist/core/export-html/vendor/marked.min.js +30 -29
- package/dist/core/extensions/index.d.ts +1 -1
- package/dist/core/extensions/index.d.ts.map +1 -1
- package/dist/core/extensions/index.js.map +1 -1
- package/dist/core/extensions/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +7 -0
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +6 -2
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +16 -4
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +61 -7
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/extensions/virtual-modules.d.ts.map +1 -1
- package/dist/core/extensions/virtual-modules.js +2 -0
- package/dist/core/extensions/virtual-modules.js.map +1 -1
- package/dist/core/key-id-schema.d.ts +6 -0
- package/dist/core/key-id-schema.d.ts.map +1 -0
- package/dist/core/key-id-schema.js +16 -0
- package/dist/core/key-id-schema.js.map +1 -0
- package/dist/core/keybindings-schema.d.ts +4 -0
- package/dist/core/keybindings-schema.d.ts.map +1 -0
- package/dist/core/keybindings-schema.js +16 -0
- package/dist/core/keybindings-schema.js.map +1 -0
- package/dist/core/keybindings.d.ts +242 -75
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +30 -23
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/mcp-servers.d.ts +22 -0
- package/dist/core/mcp-servers.d.ts.map +1 -1
- package/dist/core/mcp-servers.js +72 -11
- package/dist/core/mcp-servers.js.map +1 -1
- package/dist/core/model-config.d.ts +1623 -74
- package/dist/core/model-config.d.ts.map +1 -1
- package/dist/core/model-config.js +70 -184
- package/dist/core/model-config.js.map +1 -1
- package/dist/core/model-registry.d.ts +3 -1
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +4 -0
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts +56 -43
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +253 -358
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +19 -10
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/nested-tool-calls.d.ts +1 -0
- package/dist/core/nested-tool-calls.d.ts.map +1 -1
- package/dist/core/nested-tool-calls.js +1 -0
- package/dist/core/nested-tool-calls.js.map +1 -1
- package/dist/core/package-manager.js +3 -3
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/polyphase/keyword.js +1 -1
- package/dist/core/polyphase/keyword.js.map +1 -1
- package/dist/core/polyphase/model-selection.d.ts.map +1 -1
- package/dist/core/polyphase/model-selection.js +15 -7
- package/dist/core/polyphase/model-selection.js.map +1 -1
- package/dist/core/polyphase/workflow/prelude.d.ts +2 -0
- package/dist/core/polyphase/workflow/prelude.d.ts.map +1 -1
- package/dist/core/polyphase/workflow/prelude.js +12 -16
- package/dist/core/polyphase/workflow/prelude.js.map +1 -1
- package/dist/core/polyphase/workflow/runtime.d.ts.map +1 -1
- package/dist/core/polyphase/workflow/runtime.js +2 -1
- package/dist/core/polyphase/workflow/runtime.js.map +1 -1
- package/dist/core/project-trust.d.ts.map +1 -1
- package/dist/core/project-trust.js +2 -1
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/prompt-templates.d.ts.map +1 -1
- package/dist/core/prompt-templates.js +7 -2
- package/dist/core/prompt-templates.js.map +1 -1
- package/dist/core/provider-composer.d.ts +2 -1
- package/dist/core/provider-composer.d.ts.map +1 -1
- package/dist/core/provider-composer.js +13 -0
- package/dist/core/provider-composer.js.map +1 -1
- package/dist/core/radius.d.ts +2 -0
- package/dist/core/radius.d.ts.map +1 -1
- package/dist/core/radius.js +2 -0
- package/dist/core/radius.js.map +1 -1
- package/dist/core/remote-catalog-provider.d.ts +12 -1
- package/dist/core/remote-catalog-provider.d.ts.map +1 -1
- package/dist/core/remote-catalog-provider.js +84 -24
- package/dist/core/remote-catalog-provider.js.map +1 -1
- package/dist/core/resource-loader.d.ts +3 -0
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +7 -4
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/sdk.d.ts +13 -4
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +27 -15
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/settings-defaults.d.ts +65 -0
- package/dist/core/settings-defaults.d.ts.map +1 -0
- package/dist/core/settings-defaults.js +66 -0
- package/dist/core/settings-defaults.js.map +1 -0
- package/dist/core/settings-manager.d.ts +17 -178
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +86 -57
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/settings-schema.d.ts +269 -0
- package/dist/core/settings-schema.d.ts.map +1 -0
- package/dist/core/settings-schema.js +318 -0
- package/dist/core/settings-schema.js.map +1 -0
- package/dist/core/skills.d.ts +4 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +6 -1
- package/dist/core/skills.js.map +1 -1
- package/dist/core/system-prompt.d.ts +6 -0
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +10 -5
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +3 -5
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/grep.d.ts +8 -0
- package/dist/core/tools/grep.d.ts.map +1 -1
- package/dist/core/tools/grep.js +19 -7
- package/dist/core/tools/grep.js.map +1 -1
- package/dist/core/tools/index.d.ts +2 -0
- package/dist/core/tools/index.d.ts.map +1 -1
- package/dist/core/tools/index.js +2 -0
- package/dist/core/tools/index.js.map +1 -1
- package/dist/core/tools/output-accumulator.d.ts.map +1 -1
- package/dist/core/tools/output-accumulator.js +4 -10
- package/dist/core/tools/output-accumulator.js.map +1 -1
- package/dist/core/tools/path-utils.d.ts +1 -1
- package/dist/core/tools/path-utils.d.ts.map +1 -1
- package/dist/core/tools/path-utils.js +6 -6
- package/dist/core/tools/path-utils.js.map +1 -1
- package/dist/core/tools/read.d.ts +13 -0
- package/dist/core/tools/read.d.ts.map +1 -1
- package/dist/core/tools/read.js +32 -2
- package/dist/core/tools/read.js.map +1 -1
- package/dist/core/tools/render-utils.d.ts +20 -0
- package/dist/core/tools/render-utils.d.ts.map +1 -1
- package/dist/core/tools/render-utils.js +67 -0
- package/dist/core/tools/render-utils.js.map +1 -1
- package/dist/core/tools/renderers/bash.d.ts.map +1 -1
- package/dist/core/tools/renderers/bash.js +7 -35
- package/dist/core/tools/renderers/bash.js.map +1 -1
- package/dist/core/tools/renderers/edit.d.ts.map +1 -1
- package/dist/core/tools/renderers/edit.js +5 -4
- package/dist/core/tools/renderers/edit.js.map +1 -1
- package/dist/core/tools/renderers/index.d.ts +2 -2
- package/dist/core/tools/renderers/index.d.ts.map +1 -1
- package/dist/core/tools/renderers/index.js.map +1 -1
- package/dist/core/tools/renderers/read.d.ts.map +1 -1
- package/dist/core/tools/renderers/read.js +7 -11
- package/dist/core/tools/renderers/read.js.map +1 -1
- package/dist/extensions/codemode/execute.d.ts.map +1 -1
- package/dist/extensions/codemode/execute.js +391 -80
- package/dist/extensions/codemode/execute.js.map +1 -1
- package/dist/extensions/codemode/index.d.ts.map +1 -1
- package/dist/extensions/codemode/index.js +3 -1
- package/dist/extensions/codemode/index.js.map +1 -1
- package/dist/extensions/codemode/renderer.d.ts +2 -2
- package/dist/extensions/codemode/renderer.d.ts.map +1 -1
- package/dist/extensions/codemode/renderer.js +9 -3
- package/dist/extensions/codemode/renderer.js.map +1 -1
- package/dist/extensions/codemode/tool.d.ts +22 -21
- package/dist/extensions/codemode/tool.d.ts.map +1 -1
- package/dist/extensions/codemode/tool.js +96 -123
- package/dist/extensions/codemode/tool.js.map +1 -1
- package/dist/extensions/llama/provider.d.ts.map +1 -1
- package/dist/extensions/llama/provider.js +34 -11
- package/dist/extensions/llama/provider.js.map +1 -1
- package/dist/extensions/mcp/cli.d.ts.map +1 -1
- package/dist/extensions/mcp/cli.js +27 -33
- package/dist/extensions/mcp/cli.js.map +1 -1
- package/dist/extensions/mcp/config.d.ts +15 -3
- package/dist/extensions/mcp/config.d.ts.map +1 -1
- package/dist/extensions/mcp/config.js +49 -12
- package/dist/extensions/mcp/config.js.map +1 -1
- package/dist/extensions/mcp/index.d.ts +4 -1
- package/dist/extensions/mcp/index.d.ts.map +1 -1
- package/dist/extensions/mcp/index.js +279 -129
- package/dist/extensions/mcp/index.js.map +1 -1
- package/dist/extensions/mcp/oauth.d.ts +21 -11
- package/dist/extensions/mcp/oauth.d.ts.map +1 -1
- package/dist/extensions/mcp/oauth.js +166 -45
- package/dist/extensions/mcp/oauth.js.map +1 -1
- package/dist/extensions/mcp/resources.d.ts +3 -10
- package/dist/extensions/mcp/resources.d.ts.map +1 -1
- package/dist/extensions/mcp/resources.js +4 -5
- package/dist/extensions/mcp/resources.js.map +1 -1
- package/dist/extensions/mcp/runtime.d.ts +7 -7
- package/dist/extensions/mcp/runtime.d.ts.map +1 -1
- package/dist/extensions/mcp/runtime.js +31 -45
- package/dist/extensions/mcp/runtime.js.map +1 -1
- package/dist/extensions/mcp/tools.d.ts +7 -5
- package/dist/extensions/mcp/tools.d.ts.map +1 -1
- package/dist/extensions/mcp/tools.js +87 -29
- package/dist/extensions/mcp/tools.js.map +1 -1
- package/dist/extensions/mcp/ui.d.ts +3 -3
- package/dist/extensions/mcp/ui.d.ts.map +1 -1
- package/dist/extensions/mcp/ui.js +18 -6
- package/dist/extensions/mcp/ui.js.map +1 -1
- package/dist/extensions/tool-search/tool.d.ts +0 -2
- package/dist/extensions/tool-search/tool.d.ts.map +1 -1
- package/dist/extensions/tool-search/tool.js +2 -4
- package/dist/extensions/tool-search/tool.js.map +1 -1
- package/dist/hooks/checks/checks-runtime.cjs +215 -0
- package/dist/hooks/checks/git-safety.cjs +198 -0
- package/dist/hooks/checks/git-safety.d.cts +1 -0
- package/dist/hooks/gsd/draht-post-task.js +78 -39
- package/dist/hooks/gsd/draht-quality-gate.js +210 -122
- package/dist/hooks/gsd/package.json +3 -0
- package/dist/index.d.ts +5 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -2
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +11 -3
- package/dist/main.js.map +1 -1
- package/dist/modes/interactive/components/auth-url.d.ts +14 -0
- package/dist/modes/interactive/components/auth-url.d.ts.map +1 -0
- package/dist/modes/interactive/components/auth-url.js +37 -0
- package/dist/modes/interactive/components/auth-url.js.map +1 -0
- package/dist/modes/interactive/components/bash-execution.d.ts +5 -1
- package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/bash-execution.js +17 -14
- package/dist/modes/interactive/components/bash-execution.js.map +1 -1
- package/dist/modes/interactive/components/branch-summary-message.d.ts +2 -1
- package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/branch-summary-message.js +5 -2
- package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
- package/dist/modes/interactive/components/compaction-summary-message.d.ts +2 -1
- package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/compaction-summary-message.js +5 -2
- package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
- package/dist/modes/interactive/components/custom-entry.d.ts +3 -1
- package/dist/modes/interactive/components/custom-entry.d.ts.map +1 -1
- package/dist/modes/interactive/components/custom-entry.js +8 -2
- package/dist/modes/interactive/components/custom-entry.js.map +1 -1
- package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/custom-message.js +1 -0
- package/dist/modes/interactive/components/custom-message.js.map +1 -1
- package/dist/modes/interactive/components/login-dialog.d.ts +3 -0
- package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
- package/dist/modes/interactive/components/login-dialog.js +38 -10
- package/dist/modes/interactive/components/login-dialog.js.map +1 -1
- package/dist/modes/interactive/components/oauth-selector.d.ts +8 -2
- package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/oauth-selector.js +24 -21
- package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
- package/dist/modes/interactive/components/radius-login-selector.d.ts +15 -0
- package/dist/modes/interactive/components/radius-login-selector.d.ts.map +1 -0
- package/dist/modes/interactive/components/radius-login-selector.js +85 -0
- package/dist/modes/interactive/components/radius-login-selector.js.map +1 -0
- package/dist/modes/interactive/components/settings-selector.d.ts +3 -3
- package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/settings-selector.js +9 -8
- package/dist/modes/interactive/components/settings-selector.js.map +1 -1
- package/dist/modes/interactive/components/skill-invocation-message.d.ts +2 -1
- package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/skill-invocation-message.js +5 -2
- package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
- package/dist/modes/interactive/components/status-indicator.d.ts +1 -1
- package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
- package/dist/modes/interactive/components/status-indicator.js +2 -2
- package/dist/modes/interactive/components/status-indicator.js.map +1 -1
- package/dist/modes/interactive/components/tool-execution.d.ts +12 -13
- package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/tool-execution.js +32 -45
- package/dist/modes/interactive/components/tool-execution.js.map +1 -1
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +2 -9
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/user-message.js +5 -4
- package/dist/modes/interactive/components/user-message.js.map +1 -1
- package/dist/modes/interactive/interactive-mode.d.ts +43 -48
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +362 -278
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/interactive/program-status-reporter.d.ts +34 -0
- package/dist/modes/interactive/program-status-reporter.d.ts.map +1 -0
- package/dist/modes/interactive/program-status-reporter.js +110 -0
- package/dist/modes/interactive/program-status-reporter.js.map +1 -0
- package/dist/modes/interactive/theme/dark.json +1 -1
- package/dist/modes/interactive/theme/light.json +1 -1
- package/dist/modes/interactive/theme/system-theme.d.ts +2 -1
- package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -1
- package/dist/modes/interactive/theme/system-theme.js +16 -5
- package/dist/modes/interactive/theme/system-theme.js.map +1 -1
- package/dist/modes/interactive/theme/theme-schema.d.ts +28 -0
- package/dist/modes/interactive/theme/theme-schema.d.ts.map +1 -0
- package/dist/modes/interactive/theme/theme-schema.js +105 -0
- package/dist/modes/interactive/theme/theme-schema.js.map +1 -0
- package/dist/modes/interactive/theme/theme-tokens.d.ts +257 -0
- package/dist/modes/interactive/theme/theme-tokens.d.ts.map +1 -0
- package/dist/modes/interactive/theme/theme-tokens.js +94 -0
- package/dist/modes/interactive/theme/theme-tokens.js.map +1 -0
- package/dist/modes/interactive/theme/theme.d.ts +13 -16
- package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
- package/dist/modes/interactive/theme/theme.js +22 -29
- package/dist/modes/interactive/theme/theme.js.map +1 -1
- package/dist/modes/print-mode.d.ts.map +1 -1
- package/dist/modes/print-mode.js +4 -0
- package/dist/modes/print-mode.js.map +1 -1
- package/dist/package-manager-cli.d.ts.map +1 -1
- package/dist/package-manager-cli.js +26 -1
- package/dist/package-manager-cli.js.map +1 -1
- package/dist/prompts/commands/atomic-commit.md +8 -6
- package/dist/prompts/commands/brainstorm.md +5 -149
- package/dist/prompts/commands/create-verification-skill.md +8 -48
- package/dist/prompts/commands/discuss-phase.md +6 -10
- package/dist/prompts/commands/execute-phase.md +18 -45
- package/dist/prompts/commands/fix.md +16 -128
- package/dist/prompts/commands/grill.md +6 -53
- package/dist/prompts/commands/init-project.md +13 -18
- package/dist/prompts/commands/map-codebase.md +3 -3
- package/dist/prompts/commands/new-project.md +12 -17
- package/dist/prompts/commands/next-milestone.md +4 -8
- package/dist/prompts/commands/orchestrate-loop.md +12 -12
- package/dist/prompts/commands/orchestrate.md +12 -11
- package/dist/prompts/commands/pause-work.md +1 -1
- package/dist/prompts/commands/plan-phase.md +15 -37
- package/dist/prompts/commands/quick.md +11 -64
- package/dist/prompts/commands/resolve-conflicts.md +2 -15
- package/dist/prompts/commands/triage.md +3 -14
- package/dist/prompts/commands/verify-work.md +15 -63
- package/dist/prompts/commands/why.md +18 -118
- package/dist/skills/atomic-reasoning/SKILL.md +6 -105
- package/dist/skills/blast-radius/SKILL.md +1 -1
- package/dist/skills/epistemics/SKILL.md +12 -87
- package/dist/skills/explainers/SKILL.md +1 -1
- package/dist/skills/typescript-discipline/SKILL.md +12 -42
- package/dist/skills/typescript-discipline/references/patterns.md +25 -266
- package/dist/skills/unslop/SKILL.md +14 -105
- package/dist/utils/ansi.d.ts +8 -0
- package/dist/utils/ansi.d.ts.map +1 -1
- package/dist/utils/ansi.js +30 -11
- package/dist/utils/ansi.js.map +1 -1
- package/dist/utils/clipboard-command.d.ts.map +1 -1
- package/dist/utils/clipboard-command.js +3 -0
- package/dist/utils/clipboard-command.js.map +1 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +18 -12
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/draht-user-agent.d.ts +1 -0
- package/dist/utils/draht-user-agent.d.ts.map +1 -1
- package/dist/utils/draht-user-agent.js +3 -2
- package/dist/utils/draht-user-agent.js.map +1 -1
- package/dist/utils/image-convert.d.ts +12 -0
- package/dist/utils/image-convert.d.ts.map +1 -1
- package/dist/utils/image-convert.js +45 -6
- package/dist/utils/image-convert.js.map +1 -1
- package/dist/utils/image-resize-core.d.ts +12 -0
- package/dist/utils/image-resize-core.d.ts.map +1 -1
- package/dist/utils/image-resize-core.js +5 -0
- package/dist/utils/image-resize-core.js.map +1 -1
- package/dist/utils/image-resize-worker.js +3 -2
- package/dist/utils/image-resize-worker.js.map +1 -1
- package/dist/utils/image-resize.d.ts.map +1 -1
- package/dist/utils/image-resize.js +9 -10
- package/dist/utils/image-resize.js.map +1 -1
- package/dist/utils/output-files.d.ts +15 -0
- package/dist/utils/output-files.d.ts.map +1 -0
- package/dist/utils/output-files.js +30 -0
- package/dist/utils/output-files.js.map +1 -0
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +43 -13
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/syntax-highlight.d.ts.map +1 -1
- package/dist/utils/syntax-highlight.js +6 -1
- package/dist/utils/syntax-highlight.js.map +1 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +4 -3
- package/dist/utils/tools-manager.js.map +1 -1
- package/docs/cli-integration.md +1 -1
- package/docs/cli.md +30 -26
- package/docs/codemode.md +230 -0
- package/docs/compaction.md +5 -5
- package/docs/containerization.md +1 -1
- package/docs/custom-provider.md +53 -1
- package/docs/docs.json +17 -1
- package/docs/drahtbank.md +163 -0
- package/docs/environment-variables.md +5 -2
- package/docs/extensions.md +143 -13
- package/docs/index.md +1 -1
- package/docs/json.md +3 -3
- package/docs/keybindings.md +9 -5
- package/docs/llama-cpp.md +9 -2
- package/docs/mcp.md +59 -3
- package/docs/message-types.md +22 -4
- package/docs/models-configuration.md +187 -0
- package/docs/models.md +67 -4
- package/docs/nvidia-rtx-llama-cpp.md +96 -0
- package/docs/providers.md +70 -5
- package/docs/sdk.md +1 -1
- package/docs/settings.md +10 -8
- package/docs/terminal-setup.md +14 -0
- package/docs/themes.md +4 -2
- package/docs/tui.md +71 -1
- package/docs/usage.md +1 -1
- package/docs/windows.md +16 -2
- package/eval/drahtbank/adapters.d.mts +35 -0
- package/eval/drahtbank/adapters.mjs +192 -0
- package/eval/drahtbank/bank.d.mts +141 -0
- package/eval/drahtbank/bank.mjs +515 -0
- package/eval/drahtbank/cases-v2.d.mts +28 -0
- package/eval/drahtbank/cases-v2.mjs +164 -0
- package/eval/drahtbank/cases.d.mts +17 -0
- package/eval/drahtbank/cases.mjs +198 -0
- package/eval/drahtbank/cli.mjs +120 -0
- package/eval/drahtbank/grading-v2.d.mts +26 -0
- package/eval/drahtbank/grading-v2.mjs +227 -0
- package/eval/drahtbank/isolated-tools.ts +223 -0
- package/eval/drahtbank/isolation-worker.mjs +53 -0
- package/eval/drahtbank/isolation.d.mts +52 -0
- package/eval/drahtbank/isolation.mjs +345 -0
- package/eval/drahtbank/runtime-checks.d.mts +15 -0
- package/eval/drahtbank/runtime-checks.mjs +187 -0
- package/examples/extensions/dynamic-resources/dynamic.json +1 -1
- package/examples/extensions/minimal-mode.ts +4 -5
- package/examples/extensions/overlay-test.ts +2 -2
- package/examples/extensions/plan-mode/index.ts +6 -2
- package/examples/extensions/subagent/index.ts +4 -6
- package/hooks/checks/checks-runtime.cjs +215 -0
- package/hooks/checks/git-safety.cjs +198 -0
- package/hooks/checks/git-safety.d.cts +1 -0
- package/hooks/gsd/draht-post-task.js +78 -39
- package/hooks/gsd/draht-quality-gate.js +210 -122
- package/hooks/gsd/package.json +3 -0
- package/package.json +21 -16
- package/prompts/commands/atomic-commit.md +8 -6
- package/prompts/commands/brainstorm.md +5 -149
- package/prompts/commands/create-verification-skill.md +8 -48
- package/prompts/commands/discuss-phase.md +6 -10
- package/prompts/commands/execute-phase.md +18 -45
- package/prompts/commands/fix.md +16 -128
- package/prompts/commands/grill.md +6 -53
- package/prompts/commands/init-project.md +13 -18
- package/prompts/commands/map-codebase.md +3 -3
- package/prompts/commands/new-project.md +12 -17
- package/prompts/commands/next-milestone.md +4 -8
- package/prompts/commands/orchestrate-loop.md +12 -12
- package/prompts/commands/orchestrate.md +12 -11
- package/prompts/commands/pause-work.md +1 -1
- package/prompts/commands/plan-phase.md +15 -37
- package/prompts/commands/quick.md +11 -64
- package/prompts/commands/resolve-conflicts.md +2 -15
- package/prompts/commands/triage.md +3 -14
- package/prompts/commands/verify-work.md +15 -63
- package/prompts/commands/why.md +18 -118
- package/schemas/keybindings.schema.json +433 -0
- package/schemas/models.schema.json +1190 -0
- package/schemas/settings.schema.json +849 -0
- package/schemas/theme.schema.json +365 -0
- package/skills/atomic-reasoning/SKILL.md +6 -105
- package/skills/blast-radius/SKILL.md +1 -1
- package/skills/epistemics/SKILL.md +12 -87
- package/skills/explainers/SKILL.md +1 -1
- package/skills/typescript-discipline/SKILL.md +12 -42
- package/skills/typescript-discipline/references/patterns.md +25 -266
- package/skills/unslop/SKILL.md +14 -105
- package/dist/bundle/chunks/anthropic-messages-GAKYXF65.js +0 -6
- package/dist/bundle/chunks/azure-openai-responses-ZIXMK6JO.js +0 -2
- package/dist/bundle/chunks/chunk-2E5VODES.js +0 -2
- package/dist/bundle/chunks/chunk-2VAF4XJI.js +0 -146
- package/dist/bundle/chunks/chunk-4TVQYRQY.js +0 -2
- package/dist/bundle/chunks/chunk-6MSE6LZ3.js +0 -6
- package/dist/bundle/chunks/chunk-6ZJKIMU7.js +0 -2
- package/dist/bundle/chunks/chunk-736QBNUZ.js +0 -12
- package/dist/bundle/chunks/chunk-7TYCZN4Z.js +0 -137
- package/dist/bundle/chunks/chunk-BXSHCX3G.js +0 -11
- package/dist/bundle/chunks/chunk-GVXA72ZA.js +0 -2
- package/dist/bundle/chunks/chunk-I5OKY6RH.js +0 -11
- package/dist/bundle/chunks/chunk-IWTUBX6V.js +0 -4
- package/dist/bundle/chunks/chunk-KU5HAKZL.js +0 -4
- package/dist/bundle/chunks/chunk-MO3SCGBN.js +0 -18
- package/dist/bundle/chunks/chunk-N2QZNJT6.js +0 -65
- package/dist/bundle/chunks/chunk-PGJAHC3R.js +0 -107
- package/dist/bundle/chunks/chunk-QVFELZW2.js +0 -312
- package/dist/bundle/chunks/chunk-RZKPFWMH.js +0 -42
- package/dist/bundle/chunks/chunk-SDRCE6OP.js +0 -2
- package/dist/bundle/chunks/chunk-SVNWI7EV.js +0 -8
- package/dist/bundle/chunks/chunk-TIA2T6EO.js +0 -3
- package/dist/bundle/chunks/chunk-TOWVIJ2O.js +0 -1623
- package/dist/bundle/chunks/chunk-XBUEMKIY.js +0 -2
- package/dist/bundle/chunks/chunk-ZA4QNPJY.js +0 -82
- package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +0 -2
- package/dist/bundle/chunks/execute-6N7T7VLY.js +0 -18
- package/dist/bundle/chunks/google-generative-ai-RPUPQ6PM.js +0 -2
- package/dist/bundle/chunks/google-vertex-EZES5QVQ.js +0 -2
- package/dist/bundle/chunks/https-proxy-agent-O2PVUIOI.js +0 -13
- package/dist/bundle/chunks/lib-XOG5PI3Y.js +0 -9
- package/dist/bundle/chunks/mistral-conversations-AOYGU43Y.js +0 -5
- package/dist/bundle/chunks/node-LQ52KV6B.js +0 -16
- package/dist/bundle/chunks/openai-codex-responses-M2Y77JEQ.js +0 -10
- package/dist/bundle/chunks/openai-completions-A4OKYOYV.js +0 -7
- package/dist/bundle/chunks/openai-responses-6IXV53T3.js +0 -3
- package/dist/bundle/chunks/openrouter-images-LYV4NKFM.js +0 -2
- package/dist/bundle/chunks/pi-messages-KKMEUT3Z.js +0 -8
- package/dist/bundle/chunks/runtime-363BOYEO.js +0 -3
- package/dist/bundle/chunks/runtime-D3KV73AE.js +0 -2
- package/dist/bundle/chunks/settings-manager-GEOZJXFQ.js +0 -2
- package/dist/bundle/chunks/src-TIBHS42X.js +0 -4
- package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +0 -2
- package/dist/bundle/chunks/virtual-modules-RLC4Y5MX.js +0 -2
- package/dist/core/provider-attribution.d.ts +0 -4
- package/dist/core/provider-attribution.d.ts.map +0 -1
- package/dist/core/provider-attribution.js +0 -72
- package/dist/core/provider-attribution.js.map +0 -1
- package/dist/experimental/micro/api.d.ts +0 -81
- package/dist/experimental/micro/api.d.ts.map +0 -1
- package/dist/experimental/micro/api.js +0 -2
- package/dist/experimental/micro/api.js.map +0 -1
- package/dist/experimental/micro/main.d.ts +0 -3
- package/dist/experimental/micro/main.d.ts.map +0 -1
- package/dist/experimental/micro/main.js +0 -21
- package/dist/experimental/micro/main.js.map +0 -1
- package/dist/experimental/micro/models.d.ts +0 -11
- package/dist/experimental/micro/models.d.ts.map +0 -1
- package/dist/experimental/micro/models.js +0 -95
- package/dist/experimental/micro/models.js.map +0 -1
- package/dist/experimental/micro/runtime.d.ts +0 -12
- package/dist/experimental/micro/runtime.d.ts.map +0 -1
- package/dist/experimental/micro/runtime.js +0 -465
- package/dist/experimental/micro/runtime.js.map +0 -1
- package/dist/experimental/micro/sessions.d.ts +0 -10
- package/dist/experimental/micro/sessions.d.ts.map +0 -1
- package/dist/experimental/micro/sessions.js +0 -41
- package/dist/experimental/micro/sessions.js.map +0 -1
- package/dist/experimental/micro/tools.d.ts +0 -10
- package/dist/experimental/micro/tools.d.ts.map +0 -1
- package/dist/experimental/micro/tools.js +0 -96
- package/dist/experimental/micro/tools.js.map +0 -1
- package/dist/experimental/micro/tui.d.ts +0 -3
- package/dist/experimental/micro/tui.d.ts.map +0 -1
- package/dist/experimental/micro/tui.js +0 -510
- package/dist/experimental/micro/tui.js.map +0 -1
- package/dist/experimental/mini/main.d.ts +0 -7
- package/dist/experimental/mini/main.d.ts.map +0 -1
- package/dist/experimental/mini/main.js +0 -21
- package/dist/experimental/mini/main.js.map +0 -1
- package/dist/experimental/mini/server/entry.d.ts +0 -3
- package/dist/experimental/mini/server/entry.d.ts.map +0 -1
- package/dist/experimental/mini/server/entry.js +0 -11
- package/dist/experimental/mini/server/entry.js.map +0 -1
- package/dist/experimental/mini/server/run.d.ts +0 -13
- package/dist/experimental/mini/server/run.d.ts.map +0 -1
- package/dist/experimental/mini/server/run.js +0 -150
- package/dist/experimental/mini/server/run.js.map +0 -1
- package/dist/experimental/mini/shared/protocol.d.ts +0 -127
- package/dist/experimental/mini/shared/protocol.d.ts.map +0 -1
- package/dist/experimental/mini/shared/protocol.js +0 -13
- package/dist/experimental/mini/shared/protocol.js.map +0 -1
- package/dist/experimental/mini/shared/rpc.d.ts +0 -49
- package/dist/experimental/mini/shared/rpc.d.ts.map +0 -1
- package/dist/experimental/mini/shared/rpc.js +0 -171
- package/dist/experimental/mini/shared/rpc.js.map +0 -1
- package/dist/experimental/mini/shared/transport.d.ts +0 -35
- package/dist/experimental/mini/shared/transport.d.ts.map +0 -1
- package/dist/experimental/mini/shared/transport.js +0 -94
- package/dist/experimental/mini/shared/transport.js.map +0 -1
- package/dist/experimental/mini/tui/run.d.ts +0 -9
- package/dist/experimental/mini/tui/run.d.ts.map +0 -1
- package/dist/experimental/mini/tui/run.js +0 -62
- package/dist/experimental/mini/tui/run.js.map +0 -1
- package/dist/experimental/mini/tui/session.d.ts +0 -26
- package/dist/experimental/mini/tui/session.d.ts.map +0 -1
- package/dist/experimental/mini/tui/session.js +0 -94
- package/dist/experimental/mini/tui/session.js.map +0 -1
- package/dist/experimental/mini/tui/view.d.ts +0 -10
- package/dist/experimental/mini/tui/view.d.ts.map +0 -1
- package/dist/experimental/mini/tui/view.js +0 -461
- package/dist/experimental/mini/tui/view.js.map +0 -1
- package/dist/experimental/mini/worker/entry.d.ts +0 -3
- package/dist/experimental/mini/worker/entry.d.ts.map +0 -1
- package/dist/experimental/mini/worker/entry.js +0 -10
- package/dist/experimental/mini/worker/entry.js.map +0 -1
- package/dist/experimental/mini/worker/lane-service.d.ts +0 -44
- package/dist/experimental/mini/worker/lane-service.d.ts.map +0 -1
- package/dist/experimental/mini/worker/lane-service.js +0 -97
- package/dist/experimental/mini/worker/lane-service.js.map +0 -1
- package/dist/experimental/mini/worker/models-service.d.ts +0 -19
- package/dist/experimental/mini/worker/models-service.d.ts.map +0 -1
- package/dist/experimental/mini/worker/models-service.js +0 -136
- package/dist/experimental/mini/worker/models-service.js.map +0 -1
- package/dist/experimental/mini/worker/run.d.ts +0 -14
- package/dist/experimental/mini/worker/run.d.ts.map +0 -1
- package/dist/experimental/mini/worker/run.js +0 -88
- package/dist/experimental/mini/worker/run.js.map +0 -1
- package/dist/modes/interactive/theme/theme-json.d.ts +0 -85
- package/dist/modes/interactive/theme/theme-json.d.ts.map +0 -1
- package/dist/modes/interactive/theme/theme-json.js +0 -132
- package/dist/modes/interactive/theme/theme-json.js.map +0 -1
- package/dist/modes/interactive/theme/theme-schema.json +0 -361
- /package/dist/bundle/chunks/{chunk-ZZD35WKM.js → chunk-MOOADNVS.js} +0 -0
|
@@ -0,0 +1,365 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "https://raw.githubusercontent.com/draht-dev/draht/main/packages/coding-agent/schemas/theme.schema.json",
|
|
4
|
+
"$comment": "This file is generated from TypeScript source. Do not edit it manually; run npm run generate:schemas.",
|
|
5
|
+
"type": "object",
|
|
6
|
+
"required": [
|
|
7
|
+
"name",
|
|
8
|
+
"colors"
|
|
9
|
+
],
|
|
10
|
+
"properties": {
|
|
11
|
+
"$schema": {
|
|
12
|
+
"type": "string",
|
|
13
|
+
"description": "JSON schema reference"
|
|
14
|
+
},
|
|
15
|
+
"name": {
|
|
16
|
+
"type": "string",
|
|
17
|
+
"pattern": "^[^/]+$",
|
|
18
|
+
"description": "Theme name. Must not contain '/' because it is reserved for automatic light/dark theme settings."
|
|
19
|
+
},
|
|
20
|
+
"appearance": {
|
|
21
|
+
"anyOf": [
|
|
22
|
+
{
|
|
23
|
+
"type": "string",
|
|
24
|
+
"const": "dark"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"type": "string",
|
|
28
|
+
"const": "light"
|
|
29
|
+
}
|
|
30
|
+
],
|
|
31
|
+
"description": "Background the theme is designed for. Detected from the theme colors when omitted."
|
|
32
|
+
},
|
|
33
|
+
"vars": {
|
|
34
|
+
"type": "object",
|
|
35
|
+
"patternProperties": {
|
|
36
|
+
"^.*$": {
|
|
37
|
+
"$ref": "#/$defs/ColorValue"
|
|
38
|
+
}
|
|
39
|
+
},
|
|
40
|
+
"description": "Reusable color variables"
|
|
41
|
+
},
|
|
42
|
+
"colors": {
|
|
43
|
+
"type": "object",
|
|
44
|
+
"required": [
|
|
45
|
+
"accent",
|
|
46
|
+
"border",
|
|
47
|
+
"borderAccent",
|
|
48
|
+
"borderMuted",
|
|
49
|
+
"success",
|
|
50
|
+
"error",
|
|
51
|
+
"warning",
|
|
52
|
+
"muted",
|
|
53
|
+
"dim",
|
|
54
|
+
"text",
|
|
55
|
+
"thinkingText",
|
|
56
|
+
"selectedBg",
|
|
57
|
+
"userMessageBg",
|
|
58
|
+
"userMessageText",
|
|
59
|
+
"customMessageBg",
|
|
60
|
+
"customMessageText",
|
|
61
|
+
"customMessageLabel",
|
|
62
|
+
"toolPendingBg",
|
|
63
|
+
"toolSuccessBg",
|
|
64
|
+
"toolErrorBg",
|
|
65
|
+
"toolTitle",
|
|
66
|
+
"toolOutput",
|
|
67
|
+
"mdHeading",
|
|
68
|
+
"mdLink",
|
|
69
|
+
"mdLinkUrl",
|
|
70
|
+
"mdCode",
|
|
71
|
+
"mdCodeBlock",
|
|
72
|
+
"mdCodeBlockBorder",
|
|
73
|
+
"mdQuote",
|
|
74
|
+
"mdQuoteBorder",
|
|
75
|
+
"mdHr",
|
|
76
|
+
"mdListBullet",
|
|
77
|
+
"toolDiffAdded",
|
|
78
|
+
"toolDiffRemoved",
|
|
79
|
+
"toolDiffContext",
|
|
80
|
+
"syntaxComment",
|
|
81
|
+
"syntaxKeyword",
|
|
82
|
+
"syntaxFunction",
|
|
83
|
+
"syntaxVariable",
|
|
84
|
+
"syntaxString",
|
|
85
|
+
"syntaxNumber",
|
|
86
|
+
"syntaxType",
|
|
87
|
+
"syntaxOperator",
|
|
88
|
+
"syntaxPunctuation",
|
|
89
|
+
"thinkingOff",
|
|
90
|
+
"thinkingMinimal",
|
|
91
|
+
"thinkingLow",
|
|
92
|
+
"thinkingMedium",
|
|
93
|
+
"thinkingHigh",
|
|
94
|
+
"thinkingXhigh",
|
|
95
|
+
"bashMode"
|
|
96
|
+
],
|
|
97
|
+
"properties": {
|
|
98
|
+
"accent": {
|
|
99
|
+
"$ref": "#/$defs/ColorValue",
|
|
100
|
+
"description": "Primary accent color (logo, selected items, cursor)"
|
|
101
|
+
},
|
|
102
|
+
"border": {
|
|
103
|
+
"$ref": "#/$defs/ColorValue",
|
|
104
|
+
"description": "Normal borders"
|
|
105
|
+
},
|
|
106
|
+
"borderAccent": {
|
|
107
|
+
"$ref": "#/$defs/ColorValue",
|
|
108
|
+
"description": "Highlighted borders"
|
|
109
|
+
},
|
|
110
|
+
"borderMuted": {
|
|
111
|
+
"$ref": "#/$defs/ColorValue",
|
|
112
|
+
"description": "Subtle borders"
|
|
113
|
+
},
|
|
114
|
+
"success": {
|
|
115
|
+
"$ref": "#/$defs/ColorValue",
|
|
116
|
+
"description": "Success states"
|
|
117
|
+
},
|
|
118
|
+
"error": {
|
|
119
|
+
"$ref": "#/$defs/ColorValue",
|
|
120
|
+
"description": "Error states"
|
|
121
|
+
},
|
|
122
|
+
"warning": {
|
|
123
|
+
"$ref": "#/$defs/ColorValue",
|
|
124
|
+
"description": "Warning states"
|
|
125
|
+
},
|
|
126
|
+
"muted": {
|
|
127
|
+
"$ref": "#/$defs/ColorValue",
|
|
128
|
+
"description": "Secondary/dimmed text"
|
|
129
|
+
},
|
|
130
|
+
"dim": {
|
|
131
|
+
"$ref": "#/$defs/ColorValue",
|
|
132
|
+
"description": "Very dimmed text (more subtle than muted)"
|
|
133
|
+
},
|
|
134
|
+
"text": {
|
|
135
|
+
"$ref": "#/$defs/ColorValue",
|
|
136
|
+
"description": "Default text color (usually empty string)"
|
|
137
|
+
},
|
|
138
|
+
"thinkingText": {
|
|
139
|
+
"$ref": "#/$defs/ColorValue",
|
|
140
|
+
"description": "Thinking block text color"
|
|
141
|
+
},
|
|
142
|
+
"scrollbarTrack": {
|
|
143
|
+
"$ref": "#/$defs/ColorValue",
|
|
144
|
+
"description": "Fullscreen scrollbar track foreground (falls back to muted when omitted)"
|
|
145
|
+
},
|
|
146
|
+
"scrollbarThumb": {
|
|
147
|
+
"$ref": "#/$defs/ColorValue",
|
|
148
|
+
"description": "Fullscreen scrollbar thumb foreground (falls back to text when omitted)"
|
|
149
|
+
},
|
|
150
|
+
"selectedBg": {
|
|
151
|
+
"$ref": "#/$defs/ColorValue",
|
|
152
|
+
"description": "Selected item background"
|
|
153
|
+
},
|
|
154
|
+
"searchMatchBg": {
|
|
155
|
+
"$ref": "#/$defs/ColorValue",
|
|
156
|
+
"description": "Transcript search match background and current-match text (falls back to selectedBg when omitted)"
|
|
157
|
+
},
|
|
158
|
+
"searchMatchText": {
|
|
159
|
+
"$ref": "#/$defs/ColorValue",
|
|
160
|
+
"description": "Transcript search match text and current-match background (falls back to text when omitted)"
|
|
161
|
+
},
|
|
162
|
+
"userMessageBg": {
|
|
163
|
+
"$ref": "#/$defs/ColorValue",
|
|
164
|
+
"description": "User message background"
|
|
165
|
+
},
|
|
166
|
+
"userMessageText": {
|
|
167
|
+
"$ref": "#/$defs/ColorValue",
|
|
168
|
+
"description": "User message text color"
|
|
169
|
+
},
|
|
170
|
+
"customMessageBg": {
|
|
171
|
+
"$ref": "#/$defs/ColorValue",
|
|
172
|
+
"description": "Custom message background (hook-injected messages)"
|
|
173
|
+
},
|
|
174
|
+
"customMessageText": {
|
|
175
|
+
"$ref": "#/$defs/ColorValue",
|
|
176
|
+
"description": "Custom message text color"
|
|
177
|
+
},
|
|
178
|
+
"customMessageLabel": {
|
|
179
|
+
"$ref": "#/$defs/ColorValue",
|
|
180
|
+
"description": "Custom message type label color"
|
|
181
|
+
},
|
|
182
|
+
"toolPendingBg": {
|
|
183
|
+
"$ref": "#/$defs/ColorValue",
|
|
184
|
+
"description": "Tool execution box (pending state)"
|
|
185
|
+
},
|
|
186
|
+
"toolSuccessBg": {
|
|
187
|
+
"$ref": "#/$defs/ColorValue",
|
|
188
|
+
"description": "Tool execution box (success state)"
|
|
189
|
+
},
|
|
190
|
+
"toolErrorBg": {
|
|
191
|
+
"$ref": "#/$defs/ColorValue",
|
|
192
|
+
"description": "Tool execution box (error state)"
|
|
193
|
+
},
|
|
194
|
+
"toolTitle": {
|
|
195
|
+
"$ref": "#/$defs/ColorValue",
|
|
196
|
+
"description": "Tool execution box title color"
|
|
197
|
+
},
|
|
198
|
+
"toolOutput": {
|
|
199
|
+
"$ref": "#/$defs/ColorValue",
|
|
200
|
+
"description": "Tool execution box output text color"
|
|
201
|
+
},
|
|
202
|
+
"mdHeading": {
|
|
203
|
+
"$ref": "#/$defs/ColorValue",
|
|
204
|
+
"description": "Markdown heading text"
|
|
205
|
+
},
|
|
206
|
+
"mdLink": {
|
|
207
|
+
"$ref": "#/$defs/ColorValue",
|
|
208
|
+
"description": "Markdown link text"
|
|
209
|
+
},
|
|
210
|
+
"mdLinkUrl": {
|
|
211
|
+
"$ref": "#/$defs/ColorValue",
|
|
212
|
+
"description": "Markdown link URL"
|
|
213
|
+
},
|
|
214
|
+
"mdCode": {
|
|
215
|
+
"$ref": "#/$defs/ColorValue",
|
|
216
|
+
"description": "Markdown inline code"
|
|
217
|
+
},
|
|
218
|
+
"mdCodeBlock": {
|
|
219
|
+
"$ref": "#/$defs/ColorValue",
|
|
220
|
+
"description": "Markdown code block content"
|
|
221
|
+
},
|
|
222
|
+
"mdCodeBlockBorder": {
|
|
223
|
+
"$ref": "#/$defs/ColorValue",
|
|
224
|
+
"description": "Markdown code block fences"
|
|
225
|
+
},
|
|
226
|
+
"mdQuote": {
|
|
227
|
+
"$ref": "#/$defs/ColorValue",
|
|
228
|
+
"description": "Markdown blockquote text"
|
|
229
|
+
},
|
|
230
|
+
"mdQuoteBorder": {
|
|
231
|
+
"$ref": "#/$defs/ColorValue",
|
|
232
|
+
"description": "Markdown blockquote border"
|
|
233
|
+
},
|
|
234
|
+
"mdHr": {
|
|
235
|
+
"$ref": "#/$defs/ColorValue",
|
|
236
|
+
"description": "Markdown horizontal rule"
|
|
237
|
+
},
|
|
238
|
+
"mdListBullet": {
|
|
239
|
+
"$ref": "#/$defs/ColorValue",
|
|
240
|
+
"description": "Markdown list bullets/numbers"
|
|
241
|
+
},
|
|
242
|
+
"toolDiffAdded": {
|
|
243
|
+
"$ref": "#/$defs/ColorValue",
|
|
244
|
+
"description": "Added lines in tool diffs"
|
|
245
|
+
},
|
|
246
|
+
"toolDiffRemoved": {
|
|
247
|
+
"$ref": "#/$defs/ColorValue",
|
|
248
|
+
"description": "Removed lines in tool diffs"
|
|
249
|
+
},
|
|
250
|
+
"toolDiffContext": {
|
|
251
|
+
"$ref": "#/$defs/ColorValue",
|
|
252
|
+
"description": "Context lines in tool diffs"
|
|
253
|
+
},
|
|
254
|
+
"syntaxComment": {
|
|
255
|
+
"$ref": "#/$defs/ColorValue",
|
|
256
|
+
"description": "Syntax highlighting: comments"
|
|
257
|
+
},
|
|
258
|
+
"syntaxKeyword": {
|
|
259
|
+
"$ref": "#/$defs/ColorValue",
|
|
260
|
+
"description": "Syntax highlighting: keywords"
|
|
261
|
+
},
|
|
262
|
+
"syntaxFunction": {
|
|
263
|
+
"$ref": "#/$defs/ColorValue",
|
|
264
|
+
"description": "Syntax highlighting: function names"
|
|
265
|
+
},
|
|
266
|
+
"syntaxVariable": {
|
|
267
|
+
"$ref": "#/$defs/ColorValue",
|
|
268
|
+
"description": "Syntax highlighting: variable names"
|
|
269
|
+
},
|
|
270
|
+
"syntaxString": {
|
|
271
|
+
"$ref": "#/$defs/ColorValue",
|
|
272
|
+
"description": "Syntax highlighting: string literals"
|
|
273
|
+
},
|
|
274
|
+
"syntaxNumber": {
|
|
275
|
+
"$ref": "#/$defs/ColorValue",
|
|
276
|
+
"description": "Syntax highlighting: number literals"
|
|
277
|
+
},
|
|
278
|
+
"syntaxType": {
|
|
279
|
+
"$ref": "#/$defs/ColorValue",
|
|
280
|
+
"description": "Syntax highlighting: type names"
|
|
281
|
+
},
|
|
282
|
+
"syntaxOperator": {
|
|
283
|
+
"$ref": "#/$defs/ColorValue",
|
|
284
|
+
"description": "Syntax highlighting: operators"
|
|
285
|
+
},
|
|
286
|
+
"syntaxPunctuation": {
|
|
287
|
+
"$ref": "#/$defs/ColorValue",
|
|
288
|
+
"description": "Syntax highlighting: punctuation"
|
|
289
|
+
},
|
|
290
|
+
"thinkingOff": {
|
|
291
|
+
"$ref": "#/$defs/ColorValue",
|
|
292
|
+
"description": "Thinking level border: off"
|
|
293
|
+
},
|
|
294
|
+
"thinkingMinimal": {
|
|
295
|
+
"$ref": "#/$defs/ColorValue",
|
|
296
|
+
"description": "Thinking level border: minimal"
|
|
297
|
+
},
|
|
298
|
+
"thinkingLow": {
|
|
299
|
+
"$ref": "#/$defs/ColorValue",
|
|
300
|
+
"description": "Thinking level border: low"
|
|
301
|
+
},
|
|
302
|
+
"thinkingMedium": {
|
|
303
|
+
"$ref": "#/$defs/ColorValue",
|
|
304
|
+
"description": "Thinking level border: medium"
|
|
305
|
+
},
|
|
306
|
+
"thinkingHigh": {
|
|
307
|
+
"$ref": "#/$defs/ColorValue",
|
|
308
|
+
"description": "Thinking level border: high"
|
|
309
|
+
},
|
|
310
|
+
"thinkingXhigh": {
|
|
311
|
+
"$ref": "#/$defs/ColorValue",
|
|
312
|
+
"description": "Thinking level border: xhigh"
|
|
313
|
+
},
|
|
314
|
+
"thinkingMax": {
|
|
315
|
+
"$ref": "#/$defs/ColorValue",
|
|
316
|
+
"description": "Thinking level border: max (falls back to thinkingXhigh when omitted)"
|
|
317
|
+
},
|
|
318
|
+
"bashMode": {
|
|
319
|
+
"$ref": "#/$defs/ColorValue",
|
|
320
|
+
"description": "Editor border color in bash mode"
|
|
321
|
+
}
|
|
322
|
+
},
|
|
323
|
+
"description": "Theme color definitions (scrollbar, thinkingMax, and search highlight colors are optional and use compatible fallbacks)",
|
|
324
|
+
"additionalProperties": false
|
|
325
|
+
},
|
|
326
|
+
"export": {
|
|
327
|
+
"type": "object",
|
|
328
|
+
"properties": {
|
|
329
|
+
"pageBg": {
|
|
330
|
+
"$ref": "#/$defs/ColorValue",
|
|
331
|
+
"description": "Page background color"
|
|
332
|
+
},
|
|
333
|
+
"cardBg": {
|
|
334
|
+
"$ref": "#/$defs/ColorValue",
|
|
335
|
+
"description": "Card/container background color"
|
|
336
|
+
},
|
|
337
|
+
"infoBg": {
|
|
338
|
+
"$ref": "#/$defs/ColorValue",
|
|
339
|
+
"description": "Info sections background (system prompt, notices)"
|
|
340
|
+
}
|
|
341
|
+
},
|
|
342
|
+
"description": "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
|
|
343
|
+
"additionalProperties": false
|
|
344
|
+
}
|
|
345
|
+
},
|
|
346
|
+
"title": "draht Coding Agent Theme",
|
|
347
|
+
"description": "Theme schema for draht coding agent",
|
|
348
|
+
"additionalProperties": false,
|
|
349
|
+
"$defs": {
|
|
350
|
+
"ColorValue": {
|
|
351
|
+
"anyOf": [
|
|
352
|
+
{
|
|
353
|
+
"type": "string",
|
|
354
|
+
"description": "Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default"
|
|
355
|
+
},
|
|
356
|
+
{
|
|
357
|
+
"type": "integer",
|
|
358
|
+
"minimum": 0,
|
|
359
|
+
"maximum": 255,
|
|
360
|
+
"description": "256-color palette index (0-255)"
|
|
361
|
+
}
|
|
362
|
+
]
|
|
363
|
+
}
|
|
364
|
+
}
|
|
365
|
+
}
|
|
@@ -1,115 +1,16 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: atomic-reasoning
|
|
3
|
-
description: Decompose work into
|
|
3
|
+
description: Decompose complex work into coherent, independently verifiable units when planning dependencies, parallel implementation, or atomic commits.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Atomic Reasoning
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
Use decomposition when it helps coordinate or verify the work. Small tasks can be implemented directly; this skill does not open every command or require a written plan.
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
For each unit, identify its intended outcome, dependencies, affected scope, and proving checks. Keep changes together when splitting them would leave an incoherent intermediate state. Split unrelated outcomes. A unit may span files or layers when one behavior requires them; neither a time estimate nor a file count determines atomicity.
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
Use `draht-tools graph-context <files>` and `graph-impact <files>` when the repository has a map and dependency boundaries are unclear. Structural clusters are evidence about coupling, not a rule that each task must fit one cluster.
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
Resolve uncertainty that could invalidate later work early. Parallelize units with independent ownership and explicit integration points. Give each subagent the outcome, scope, constraints, and acceptance checks; a blocker requires investigation, not automatic subdivision.
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
- What does this change do? What is its singular purpose?
|
|
18
|
-
- What observable outcome does it produce?
|
|
19
|
-
- Does it complete a thought, or is it half of one?
|
|
20
|
-
|
|
21
|
-
If you can't state the purpose in one sentence, the unit is not yet atomic — keep decomposing.
|
|
22
|
-
|
|
23
|
-
### 2. Validate Independence
|
|
24
|
-
- Can this be done without touching unrelated features?
|
|
25
|
-
- Does it depend on other units, or is it standalone?
|
|
26
|
-
- Which files does it touch? Are those files coupled to anything outside this unit's concern?
|
|
27
|
-
- If applied alone, would the codebase still build/run?
|
|
28
|
-
|
|
29
|
-
If the answer to "would it build alone" is *no*, the unit is too small — pair it with the dependency. If the answer to "does it touch unrelated concerns" is *yes*, the unit is too big — split it.
|
|
30
|
-
|
|
31
|
-
### 3. Verify Correctness
|
|
32
|
-
- What test or check would prove this unit works?
|
|
33
|
-
- What inputs → what expected outputs or state changes?
|
|
34
|
-
- What edge cases or failure modes exist?
|
|
35
|
-
|
|
36
|
-
If you can't name the proving test, you don't yet understand what "correct" means for this unit. Define it before building.
|
|
37
|
-
|
|
38
|
-
## How to Apply
|
|
39
|
-
|
|
40
|
-
### Before planning a feature
|
|
41
|
-
For each observable user-visible outcome:
|
|
42
|
-
1. State the logical component (what must be true for the user?)
|
|
43
|
-
2. Validate independence (which artifacts prove this? can it be built standalone?)
|
|
44
|
-
3. Verify correctness (what scenarios prove it works?)
|
|
45
|
-
|
|
46
|
-
### Validate a decomposition against the living map
|
|
47
|
-
Run `draht-tools graph-context <file...>` on each unit's files: a unit whose files share one cluster/bounded context is atomic; a unit spanning multiple contexts should be split along the boundary.
|
|
48
|
-
|
|
49
|
-
### Before splitting a commit
|
|
50
|
-
For each file in the diff:
|
|
51
|
-
1. State the logical component (what does this change accomplish?)
|
|
52
|
-
2. Validate independence (would this build alone? does it mix concerns?)
|
|
53
|
-
3. Verify correctness (is the change complete? does it leave a coherent intermediate state?)
|
|
54
|
-
|
|
55
|
-
### Before fixing a bug
|
|
56
|
-
1. State the logical component (what is the observed failure? what should happen vs what does?)
|
|
57
|
-
2. Validate independence (which components are involved? can we isolate it?)
|
|
58
|
-
3. Verify correctness (what test reproduces it reliably? what would prove it fixed?)
|
|
59
|
-
|
|
60
|
-
### Before refactoring
|
|
61
|
-
1. State the logical component (what structural change are you making?)
|
|
62
|
-
2. Validate independence (which behaviour-equivalence test proves this is a refactor, not a rewrite?)
|
|
63
|
-
3. Verify correctness (all tests stay green after the change?)
|
|
64
|
-
|
|
65
|
-
## Atomicity Heuristics
|
|
66
|
-
|
|
67
|
-
A unit is atomic if:
|
|
68
|
-
- ✅ It can be described in one sentence
|
|
69
|
-
- ✅ It can be built or applied in 2–5 minutes of focused work
|
|
70
|
-
- ✅ It can be verified by ONE test or check
|
|
71
|
-
- ✅ It touches ONE concern in the codebase
|
|
72
|
-
- ✅ All files in the atomic unit belong to one bounded context (or explicitly cross a documented boundary) — confirm with `draht-tools graph-context`
|
|
73
|
-
- ✅ It produces ONE commit (or one TDD red→green→refactor trio)
|
|
74
|
-
- ✅ Its `<files>` list contains specific paths, not "all relevant files"
|
|
75
|
-
- ✅ Its outcome is a concrete state change, not "improve X"
|
|
76
|
-
|
|
77
|
-
If any of these fail, decompose further.
|
|
78
|
-
|
|
79
|
-
## Order by Risk
|
|
80
|
-
|
|
81
|
-
Decomposition tells you the units; it doesn't tell you which to do first. When the units are independent, sequence is a lever — use it to fail cheaply.
|
|
82
|
-
|
|
83
|
-
Score each unit by **uncertainty** (has this codebase done it before?) × **blast radius** (how many other units become invalid if this one is wrong?). Do the highest-scoring unit first; push boilerplate last. Boilerplate never invalidates the plan — the risky, unfamiliar unit regularly does, and you want to discover that before you've built everything downstream of it.
|
|
84
|
-
|
|
85
|
-
*Example:* a feature needs a third-party webhook and a settings screen. Both are atomic. Prove the webhook round-trip first — if the contract isn't what you assumed, the settings screen you'd have built on top of it was wasted. *Prevents:* sinking effort into work that a later, riskier unit turns out to obsolete.
|
|
86
|
-
|
|
87
|
-
## Anti-Patterns — STOP
|
|
88
|
-
|
|
89
|
-
- **"Improve performance"** — not atomic. Pick one metric, one bottleneck, one change.
|
|
90
|
-
- **"Refactor the X module"** — not atomic. Pick one structural change with one behaviour-equivalence proof.
|
|
91
|
-
- **"Add error handling"** — not atomic. Pick one error case, one handler, one test.
|
|
92
|
-
- **"Wire up the Y feature"** — not atomic. Decompose into the components, the data flow, and the integration.
|
|
93
|
-
- **"And also fix the related bug while I'm there"** — that's a different atomic unit. Different commit.
|
|
94
|
-
|
|
95
|
-
## Relationship to TDD
|
|
96
|
-
|
|
97
|
-
Atomicity and TDD reinforce each other:
|
|
98
|
-
- TDD's RED phase forces you to name the proving test (Question 3) before building
|
|
99
|
-
- Atomic units fit naturally inside one RED → GREEN → REFACTOR cycle
|
|
100
|
-
- A test that requires changes in multiple unrelated files means the unit is not atomic
|
|
101
|
-
|
|
102
|
-
## Relationship to /atomic-commit
|
|
103
|
-
|
|
104
|
-
`/atomic-commit` is this skill applied to the git history: each commit is one atomic unit. The questions are the same; the artifact is a commit instead of a plan task.
|
|
105
|
-
|
|
106
|
-
## Relationship to subagent dispatch
|
|
107
|
-
|
|
108
|
-
Subagents work best on atomic units. When dispatching:
|
|
109
|
-
- Each subagent task should answer the three questions inside its prompt
|
|
110
|
-
- Parallel dispatch is only safe when units are genuinely independent (Question 2)
|
|
111
|
-
- A subagent returning `STATUS: BLOCKED — complexity` often means the unit wasn't atomic — split it.
|
|
112
|
-
|
|
113
|
-
## Output
|
|
114
|
-
|
|
115
|
-
This skill produces *thought*, not files. The artifact is a clearer plan / commit / fix scope before any code is written.
|
|
16
|
+
A commit should express one coherent change when commits are authorized. Testing and decomposition do not independently authorize commits. The `red:`, `green:`, and `refactor:` conventions apply when recording TDD phases.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: blast-radius
|
|
3
|
-
description:
|
|
3
|
+
description: Find what a change could break beyond the diff and prove the one fact its safety rests on by running real code — use when asked what a change could break, or before shipping one you distrust. Not the uncertainty × blast-radius ordering heuristic in planning commands.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Blast Radius
|
|
@@ -1,99 +1,24 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: epistemics
|
|
3
|
-
description:
|
|
3
|
+
description: Calibrate historical or uncertain investigation findings, distinguish evidence from inference, and report source coverage and gaps.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Epistemics
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
Cite evidence for claims about history or intent. Code demonstrates behavior; motivation requires a decision record, commit/PR discussion, source comment, or other relevant evidence. When those are absent, label the inference.
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
Use these tiers when they help communicate uncertainty:
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
- **Direct:** a cited explicit statement from a source in a position to know.
|
|
13
|
+
- **Supported:** independent indirect sources converge; explain that support without presenting it as an explicit statement.
|
|
14
|
+
- **Inferred:** a plausible interpretation of evidence; state the inference and what it rests on.
|
|
15
|
+
- **Speculative:** an unresolved hypothesis, separate from established findings.
|
|
16
|
+
- **Unknown:** evidence was unavailable or searches did not resolve the question.
|
|
13
17
|
|
|
14
|
-
|
|
18
|
+
Treat the user's suggested explanation as a candidate. Seek evidence that could contradict the leading interpretation. Surface conflicting sources instead of choosing a tidier narrative. Repeated code can reflect convention or copying; it does not establish intent by itself.
|
|
15
19
|
|
|
16
|
-
|
|
20
|
+
Distinguish a search with no result from a source that was not searched. A null result means no evidence was found within the stated scope, not that no evidence exists. Report material gaps; do not invent a gap to satisfy a report template.
|
|
17
21
|
|
|
18
|
-
|
|
22
|
+
For an investigation report, include a concise **Sources Consulted** summary with relevant queries, coverage, null results, and unavailable sources. Scope source collection to the question; do not require every service or evidence category for every answer. Follow any caller-specified report format.
|
|
19
23
|
|
|
20
|
-
|
|
21
|
-
- A PR description: "Switching to cursor pagination because offset scans time out past 100k rows" (PR #212).
|
|
22
|
-
- An ADR title and context section naming the decision and its forcing constraint.
|
|
23
|
-
- A `.planning/STATE.md` `## Decisions` line, dated and attributed.
|
|
24
|
-
2. **Supported** — multiple independent indirect sources converge on the same reading. Phrase as fact with all citations, and say the support is convergent, not explicit.
|
|
25
|
-
- A commit message names the symptom and the linked issue describes the incident it fixed.
|
|
26
|
-
- An inline comment names an upstream constraint and the dependency's changelog confirms it existed at that date.
|
|
27
|
-
3. **Inferred** — one plausible reading of circumstantial evidence. Phrase with hedged vocabulary and show the inference chain: "Given A and B, C is likely because D."
|
|
28
|
-
- The retry wrapper landed two days after a revert of the same call site — consistent with a reaction to a production failure, but nothing says so.
|
|
29
|
-
4. **Speculative** — a hypothesis the evidence neither supports nor rules out. Belongs only in a hypotheses section, phrased as a candidate, never in findings.
|
|
30
|
-
5. **Unknown** — the searches ran and came up empty, or the source that would know is unavailable. Reported explicitly, never silently omitted.
|
|
31
|
-
|
|
32
|
-
## Phrasing Guide
|
|
33
|
-
|
|
34
|
-
Confidence-carrying words assert knowledge of intent. Each one demands a citation immediately adjacent:
|
|
35
|
-
|
|
36
|
-
- "because", "the reason is", "was designed to", "fixes", "the team decided"
|
|
37
|
-
|
|
38
|
-
Hedge words mark inference and are the only vocabulary allowed for tier 3:
|
|
39
|
-
|
|
40
|
-
- "appears to", "likely", "suggests", "is consistent with", "one reading is"
|
|
41
|
-
|
|
42
|
-
Banned words: "obviously", "clearly", "of course", "just". And replace "I think" with "the evidence suggests" — the reader needs the evidence's confidence, not yours.
|
|
43
|
-
|
|
44
|
-
## Never Cite Code as Evidence of Its Own Intent
|
|
45
|
-
|
|
46
|
-
Code is mechanics; motivation is external. "The cache exists to reduce latency" cited to the cache implementation is circular — the code proves a cache exists, not why anyone wanted one. A performance rationale needs a source outside the code: a commit message, a benchmark in the PR, a decision record. Without one, it is an Inferred claim wearing a fact's clothes.
|
|
47
|
-
|
|
48
|
-
## Null Results Are Evidence; Skipped Searches Are Blind Spots
|
|
49
|
-
|
|
50
|
-
- A **null result** — "searched the review record for pagination discussion across the file's full history; nothing found" — is a data point. It rules readings out and belongs in the report.
|
|
51
|
-
- A **skipped search** is a blind spot. It rules nothing out and must be reported as a gap, not dressed up as a null result.
|
|
52
|
-
|
|
53
|
-
The reader cannot tell the two apart unless the report distinguishes them. Always state what was searched (queries verbatim) so an empty result is meaningful.
|
|
54
|
-
|
|
55
|
-
## Contradictions Are Findings
|
|
56
|
-
|
|
57
|
-
When two sources disagree — the commit message says performance, the linked ticket says a correctness bug — surface both with their citations. Do not pick the tidier narrative, do not average them into a vague middle. The historical record contradicts itself more often than it lies consistently, and the contradiction is usually the most informative thing the investigation found.
|
|
58
|
-
|
|
59
|
-
## The Sycophancy Trap
|
|
60
|
-
|
|
61
|
-
When the question embeds a hypothesis — "why did we switch to X, was it performance?" — the embedded guess is a candidate to check independently, not a conclusion to confirm. Search for evidence that would support it AND evidence that would contradict it, at equal effort.
|
|
62
|
-
|
|
63
|
-
> **The user's guess is a prompt for investigation, not a conclusion to validate.**
|
|
64
|
-
|
|
65
|
-
## Anti-Rationalization
|
|
66
|
-
|
|
67
|
-
- Never retrofit intent: "this must have been for scalability" is storytelling unless a source says so.
|
|
68
|
-
- A consistent pattern across files may be a deliberate convention — or copy-paste of the first instance. Investigate the origin, don't infer policy from repetition.
|
|
69
|
-
- Absence of evidence is not evidence of absence: "no discussion found" supports "we found no discussion", not "there was no discussion".
|
|
70
|
-
|
|
71
|
-
## The Coverage-Map Contract
|
|
72
|
-
|
|
73
|
-
Every findings report ends with a **Sources Consulted** map: one line per evidence category, including the empty ones. A category may be skipped only with a written justification, and only two justifications are valid:
|
|
74
|
-
|
|
75
|
-
1. **Unavailable in this runtime** — the source cannot be searched here. That is a coverage gap, not a choice, and is reported as one.
|
|
76
|
-
2. **Provably irrelevant, not probably.** A build-time script with no runtime path provably cannot appear in runtime error tracking. "It's feature code, error tracking won't have anything" is a probability judgment, not a proof — search it.
|
|
77
|
-
|
|
78
|
-
## Calibration Checklist
|
|
79
|
-
|
|
80
|
-
Before finalizing any findings report:
|
|
81
|
-
|
|
82
|
-
- Does every factual claim have a citation adjacent to it?
|
|
83
|
-
- Is every uncited claim phrased with tier-3 hedge vocabulary and filed in an inference section?
|
|
84
|
-
- Is any claim citing code as evidence of its own intent?
|
|
85
|
-
- Is the gaps section present and specific? **If no gaps are mentioned, that's suspicious** — every real investigation has them.
|
|
86
|
-
|
|
87
|
-
## Failure Modes
|
|
88
|
-
|
|
89
|
-
- **Confident storytelling** — a plausible narrative assembled from mechanics and phrased as history. The most common failure, and the hardest to spot from inside.
|
|
90
|
-
- **Citing code as evidence of its own intent** — circular sourcing dressed as citation.
|
|
91
|
-
- **Recency bias** — explaining the current shape as one decision when it is an accretion of many. Trace back through the history; the first version's rationale is usually not the current version's.
|
|
92
|
-
- **Sycophantic confirmation** — finding only the evidence that agrees with the asker's framing.
|
|
93
|
-
- **Skipping the gaps section** — shipping a coverage map with no empties is claiming a completeness no investigation has.
|
|
94
|
-
|
|
95
|
-
## Relationship to verification-gate
|
|
96
|
-
|
|
97
|
-
`verification-gate` governs claims about **present** state that a command can prove — run the command, read the output, then claim. Epistemics governs claims about **historical intent** that no command can prove: there is nothing to run, so the discipline is to tier and cite instead. The two compose; neither substitutes for the other.
|
|
98
|
-
|
|
99
|
-
One fixed-format carve-out: `verify-work`'s observed/derived/assumed labels and its verdict-first UAT ordering are fixed report formats — epistemics governs historical-intent claims and never rewords those labels or that ordering.
|
|
24
|
+
Use `verification-gate` for present-state claims that can be checked by execution. Preserve `verify-work`'s observed/derived/assumed labels and verdict-first ordering when that command is selected.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: explainers
|
|
3
|
-
description:
|
|
3
|
+
description: Choose prose, a Mermaid diagram, or a self-contained HTML explainer for agent output, built only from cited evidence. Use when output describes dependencies, call paths, sequences or state, or the user asks for a diagram.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Explainers
|