@draht/coding-agent 2026.7.30 → 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.
- package/CHANGELOG.md +154 -0
- package/README.md +46 -2
- package/agents/debugger.md +12 -1
- package/agents/git-committer.md +1 -0
- package/agents/implementer.md +20 -0
- package/agents/investigator.md +75 -0
- package/agents/reviewer.md +7 -0
- package/agents/spec-reviewer.md +66 -0
- package/agents/verifier.md +4 -3
- package/bin/draht-tools.cjs +472 -41
- package/dist/agents/debugger.md +12 -1
- package/dist/agents/git-committer.md +1 -0
- package/dist/agents/implementer.md +20 -0
- package/dist/agents/investigator.md +75 -0
- package/dist/agents/reviewer.md +7 -0
- package/dist/agents/spec-reviewer.md +66 -0
- package/dist/agents/verifier.md +4 -3
- package/dist/cli/args.d.ts +10 -0
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +69 -2
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/attach-mode.d.ts +61 -0
- package/dist/cli/attach-mode.d.ts.map +1 -1
- package/dist/cli/attach-mode.js +243 -5
- package/dist/cli/attach-mode.js.map +1 -1
- package/dist/cli/credential-print.d.ts +1 -1
- package/dist/cli/credential-print.d.ts.map +1 -1
- package/dist/cli/credential-print.js +5 -4
- package/dist/cli/credential-print.js.map +1 -1
- package/dist/config.d.ts +9 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +31 -4
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +17 -1
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +87 -30
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts +1 -1
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +1 -0
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +35 -16
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +149 -64
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts +5 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +72 -15
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/builtins/checkpoints.d.ts +20 -0
- package/dist/core/builtins/checkpoints.d.ts.map +1 -0
- package/dist/core/builtins/checkpoints.js +161 -0
- package/dist/core/builtins/checkpoints.js.map +1 -0
- package/dist/core/builtins/duet.d.ts +26 -0
- package/dist/core/builtins/duet.d.ts.map +1 -0
- package/dist/core/builtins/duet.js +660 -0
- package/dist/core/builtins/duet.js.map +1 -0
- package/dist/core/builtins/index.d.ts.map +1 -1
- package/dist/core/builtins/index.js +7 -1
- package/dist/core/builtins/index.js.map +1 -1
- package/dist/core/builtins/subagent.d.ts +24 -4
- package/dist/core/builtins/subagent.d.ts.map +1 -1
- package/dist/core/builtins/subagent.js +278 -35
- package/dist/core/builtins/subagent.js.map +1 -1
- package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
- package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-cli.js +78 -0
- package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts +294 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.js +865 -0
- package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
- package/dist/core/checkpoints/rewind.d.ts +141 -0
- package/dist/core/checkpoints/rewind.d.ts.map +1 -0
- package/dist/core/checkpoints/rewind.js +246 -0
- package/dist/core/checkpoints/rewind.js.map +1 -0
- package/dist/core/compaction/branch-summarization.d.ts +1 -1
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +9 -4
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +5 -0
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +25 -4
- package/dist/core/compaction/compaction.js.map +1 -1
- 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 +83 -20
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +13 -2
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +37 -2
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +189 -6
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/http-dispatcher.d.ts.map +1 -1
- package/dist/core/http-dispatcher.js +7 -0
- package/dist/core/http-dispatcher.js.map +1 -1
- package/dist/core/index.d.ts +1 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/keybindings.d.ts +5 -0
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +1 -0
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/model-registry.d.ts +3 -2
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +8 -8
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +34 -7
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +7 -1
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +30 -10
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
- package/dist/core/multi-agent/permission-gate.js +4 -3
- package/dist/core/multi-agent/permission-gate.js.map +1 -1
- package/dist/core/multi-agent/worktree.d.ts +2 -0
- package/dist/core/multi-agent/worktree.d.ts.map +1 -1
- package/dist/core/multi-agent/worktree.js +2 -2
- package/dist/core/multi-agent/worktree.js.map +1 -1
- package/dist/core/package-manager.d.ts +7 -1
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +21 -44
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/permission-relay/index.d.ts +19 -0
- package/dist/core/permission-relay/index.d.ts.map +1 -0
- package/dist/core/permission-relay/index.js +49 -0
- package/dist/core/permission-relay/index.js.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.js +788 -0
- package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
- package/dist/core/permission-relay/types.d.ts +222 -0
- package/dist/core/permission-relay/types.d.ts.map +1 -0
- package/dist/core/permission-relay/types.js +15 -0
- package/dist/core/permission-relay/types.js.map +1 -0
- package/dist/core/pi-manifest.d.ts +14 -0
- package/dist/core/pi-manifest.d.ts.map +1 -0
- package/dist/core/pi-manifest.js +35 -0
- package/dist/core/pi-manifest.js.map +1 -0
- package/dist/core/project-trust.js +2 -2
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/resource-loader.d.ts +21 -0
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +101 -24
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/sandbox/bash-operations.d.ts +149 -0
- package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
- package/dist/core/sandbox/bash-operations.js +163 -0
- package/dist/core/sandbox/bash-operations.js.map +1 -0
- package/dist/core/sandbox/env.d.ts +83 -0
- package/dist/core/sandbox/env.d.ts.map +1 -0
- package/dist/core/sandbox/env.js +123 -0
- package/dist/core/sandbox/env.js.map +1 -0
- package/dist/core/sandbox/executor.d.ts +104 -0
- package/dist/core/sandbox/executor.d.ts.map +1 -0
- package/dist/core/sandbox/executor.js +92 -0
- package/dist/core/sandbox/executor.js.map +1 -0
- package/dist/core/sandbox/index.d.ts +36 -0
- package/dist/core/sandbox/index.d.ts.map +1 -0
- package/dist/core/sandbox/index.js +36 -0
- package/dist/core/sandbox/index.js.map +1 -0
- package/dist/core/sandbox/linux.d.ts +121 -0
- package/dist/core/sandbox/linux.d.ts.map +1 -0
- package/dist/core/sandbox/linux.js +260 -0
- package/dist/core/sandbox/linux.js.map +1 -0
- package/dist/core/sandbox/policy.d.ts +142 -0
- package/dist/core/sandbox/policy.d.ts.map +1 -0
- package/dist/core/sandbox/policy.js +297 -0
- package/dist/core/sandbox/policy.js.map +1 -0
- package/dist/core/sandbox/real-path.d.ts +112 -0
- package/dist/core/sandbox/real-path.d.ts.map +1 -0
- package/dist/core/sandbox/real-path.js +158 -0
- package/dist/core/sandbox/real-path.js.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.js +239 -0
- package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
- package/dist/core/sandbox/seatbelt.d.ts +95 -0
- package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt.js +154 -0
- package/dist/core/sandbox/seatbelt.js.map +1 -0
- package/dist/core/sandbox/self-test.d.ts +109 -0
- package/dist/core/sandbox/self-test.d.ts.map +1 -0
- package/dist/core/sandbox/self-test.js +369 -0
- package/dist/core/sandbox/self-test.js.map +1 -0
- package/dist/core/sandbox/spawn.d.ts +33 -0
- package/dist/core/sandbox/spawn.d.ts.map +1 -0
- package/dist/core/sandbox/spawn.js +87 -0
- package/dist/core/sandbox/spawn.js.map +1 -0
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +3 -1
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-manager.d.ts +60 -1
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +53 -6
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-manager.d.ts +21 -0
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +36 -16
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/skills.d.ts +3 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +19 -6
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +1 -0
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/soak/soak-log.d.ts +298 -0
- package/dist/core/soak/soak-log.d.ts.map +1 -0
- package/dist/core/soak/soak-log.js +660 -0
- package/dist/core/soak/soak-log.js.map +1 -0
- package/dist/core/soak/soak-reader.d.ts +60 -0
- package/dist/core/soak/soak-reader.d.ts.map +1 -0
- package/dist/core/soak/soak-reader.js +106 -0
- package/dist/core/soak/soak-reader.js.map +1 -0
- package/dist/core/socket-server/discovery.d.ts +78 -1
- package/dist/core/socket-server/discovery.d.ts.map +1 -1
- package/dist/core/socket-server/discovery.js +356 -37
- package/dist/core/socket-server/discovery.js.map +1 -1
- package/dist/core/socket-server/index.d.ts +10 -4
- package/dist/core/socket-server/index.d.ts.map +1 -1
- package/dist/core/socket-server/index.js +6 -3
- package/dist/core/socket-server/index.js.map +1 -1
- package/dist/core/socket-server/permission-delivery.d.ts +125 -0
- package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
- package/dist/core/socket-server/permission-delivery.js +152 -0
- package/dist/core/socket-server/permission-delivery.js.map +1 -0
- package/dist/core/socket-server/permission-registry.d.ts +301 -0
- package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
- package/dist/core/socket-server/permission-registry.js +410 -0
- package/dist/core/socket-server/permission-registry.js.map +1 -0
- package/dist/core/socket-server/permission-relay.d.ts +81 -0
- package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
- package/dist/core/socket-server/permission-relay.js +528 -0
- package/dist/core/socket-server/permission-relay.js.map +1 -0
- package/dist/core/socket-server/safe-text.d.ts +83 -0
- package/dist/core/socket-server/safe-text.d.ts.map +1 -0
- package/dist/core/socket-server/safe-text.js +277 -0
- package/dist/core/socket-server/safe-text.js.map +1 -0
- package/dist/core/socket-server/session-integration.d.ts +65 -2
- package/dist/core/socket-server/session-integration.d.ts.map +1 -1
- package/dist/core/socket-server/session-integration.js +434 -32
- package/dist/core/socket-server/session-integration.js.map +1 -1
- package/dist/core/socket-server/socket-client.d.ts +21 -2
- package/dist/core/socket-server/socket-client.d.ts.map +1 -1
- package/dist/core/socket-server/socket-client.js +52 -1
- package/dist/core/socket-server/socket-client.js.map +1 -1
- package/dist/core/socket-server/socket-server.d.ts +152 -1
- package/dist/core/socket-server/socket-server.d.ts.map +1 -1
- package/dist/core/socket-server/socket-server.js +775 -26
- package/dist/core/socket-server/socket-server.js.map +1 -1
- package/dist/core/socket-server/types.d.ts +106 -2
- package/dist/core/socket-server/types.d.ts.map +1 -1
- package/dist/core/socket-server/types.js +13 -1
- package/dist/core/socket-server/types.js.map +1 -1
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +8 -9
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/tools/bash.d.ts +1 -1
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +5 -2
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +17 -2
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/find.d.ts +3 -0
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +11 -18
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/trust-manager.d.ts +6 -4
- package/dist/core/trust-manager.d.ts.map +1 -1
- package/dist/core/trust-manager.js +55 -21
- package/dist/core/trust-manager.js.map +1 -1
- package/dist/extensions/index.d.ts.map +1 -1
- package/dist/extensions/index.js +5 -1
- package/dist/extensions/index.js.map +1 -1
- package/dist/extensions/llama/provider.d.ts.map +1 -1
- package/dist/extensions/llama/provider.js +5 -1
- package/dist/extensions/llama/provider.js.map +1 -1
- package/dist/extensions/stub-provider/index.d.ts +9 -0
- package/dist/extensions/stub-provider/index.d.ts.map +1 -0
- package/dist/extensions/stub-provider/index.js +13 -0
- package/dist/extensions/stub-provider/index.js.map +1 -0
- package/dist/extensions/stub-provider/provider.d.ts +77 -0
- package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
- package/dist/extensions/stub-provider/provider.js +193 -0
- package/dist/extensions/stub-provider/provider.js.map +1 -0
- package/dist/hooks/gsd/draht-quality-gate.js +3 -3
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +242 -45
- package/dist/main.js.map +1 -1
- package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/config-selector.js +3 -2
- package/dist/modes/interactive/components/config-selector.js.map +1 -1
- package/dist/modes/interactive/components/extension-selector.d.ts +49 -0
- package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-selector.js +202 -5
- package/dist/modes/interactive/components/extension-selector.js.map +1 -1
- package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/session-selector.js +10 -2
- package/dist/modes/interactive/components/session-selector.js.map +1 -1
- package/dist/modes/interactive/components/settings-selector.d.ts +2 -0
- package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/settings-selector.js +10 -0
- package/dist/modes/interactive/components/settings-selector.js.map +1 -1
- package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/tool-execution.js +10 -1
- package/dist/modes/interactive/components/tool-execution.js.map +1 -1
- package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +21 -5
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/interactive-mode.d.ts +97 -3
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +394 -24
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +165 -7
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +68 -1
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/prompts/commands/atomic-commit.md +1 -12
- package/dist/prompts/commands/brainstorm.md +12 -15
- package/dist/prompts/commands/create-verification-skill.md +108 -0
- package/dist/prompts/commands/discuss-phase.md +3 -14
- package/dist/prompts/commands/execute-phase.md +3 -11
- package/dist/prompts/commands/fix.md +41 -18
- package/dist/prompts/commands/grill.md +66 -0
- package/dist/prompts/commands/init-project.md +5 -15
- package/dist/prompts/commands/map-codebase.md +1 -13
- package/dist/prompts/commands/new-project.md +5 -15
- package/dist/prompts/commands/next-milestone.md +1 -13
- package/dist/prompts/commands/orchestrate.md +1 -1
- package/dist/prompts/commands/pause-work.md +1 -13
- package/dist/prompts/commands/plan-phase.md +2 -11
- package/dist/prompts/commands/progress.md +0 -13
- package/dist/prompts/commands/quick.md +3 -11
- package/dist/prompts/commands/resolve-conflicts.md +71 -0
- package/dist/prompts/commands/resume-work.md +0 -13
- package/dist/prompts/commands/review.md +4 -13
- package/dist/prompts/commands/triage.md +159 -0
- package/dist/prompts/commands/verify-work.md +4 -14
- package/dist/prompts/commands/why.md +135 -0
- package/dist/skills/atomic-reasoning/SKILL.md +115 -0
- package/dist/skills/blast-radius/SKILL.md +55 -0
- package/dist/skills/epistemics/SKILL.md +99 -0
- package/dist/skills/hexagon-animation/SKILL.md +49 -0
- package/dist/skills/hexagon-animation/generate.mjs +81 -0
- package/dist/skills/hexagon-animation/template.html +361 -0
- package/dist/skills/typescript-discipline/SKILL.md +50 -0
- package/dist/skills/typescript-discipline/references/patterns.md +294 -0
- package/dist/skills/unslop/SKILL.md +101 -0
- package/dist/utils/canonical-path.d.ts +28 -0
- package/dist/utils/canonical-path.d.ts.map +1 -0
- package/dist/utils/canonical-path.js +90 -0
- package/dist/utils/canonical-path.js.map +1 -0
- package/dist/utils/child-process.d.ts +12 -1
- package/dist/utils/child-process.d.ts.map +1 -1
- package/dist/utils/child-process.js +25 -8
- package/dist/utils/child-process.js.map +1 -1
- package/dist/utils/clipboard.d.ts +1 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +22 -2
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/exif-orientation.d.ts.map +1 -1
- package/dist/utils/exif-orientation.js +2 -3
- package/dist/utils/exif-orientation.js.map +1 -1
- package/dist/utils/paths.d.ts +2 -7
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +13 -15
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +6 -4
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +3 -5
- package/dist/utils/tools-manager.js.map +1 -1
- package/docs/attachable-sessions.md +79 -0
- package/docs/compaction.md +21 -21
- package/docs/containerization.md +23 -23
- package/docs/custom-provider.md +16 -16
- package/docs/development.md +9 -9
- package/docs/docs.json +6 -2
- package/docs/duet.md +42 -0
- package/docs/extensions.md +58 -58
- package/docs/index.md +10 -10
- package/docs/json.md +7 -7
- package/docs/keybindings.md +6 -5
- package/docs/llama-cpp.md +6 -6
- package/docs/models.md +6 -6
- package/docs/packages.md +43 -43
- package/docs/prompt-templates.md +4 -4
- package/docs/providers.md +12 -12
- package/docs/quickstart.md +32 -32
- package/docs/rpc.md +83 -12
- package/docs/sdk.md +15 -15
- package/docs/security.md +18 -18
- package/docs/session-format.md +35 -13
- package/docs/sessions.md +17 -14
- package/docs/settings.md +25 -18
- package/docs/shell-aliases.md +2 -2
- package/docs/skills.md +12 -11
- package/docs/terminal-setup.md +12 -12
- package/docs/termux.md +6 -6
- package/docs/themes.md +11 -11
- package/docs/tmux.md +4 -4
- package/docs/tui.md +5 -5
- package/docs/usage.md +50 -50
- package/docs/windows.md +2 -2
- package/examples/extensions/overlay-qa-tests.ts +3 -3
- package/hooks/gsd/draht-quality-gate.js +3 -3
- package/package.json +11 -10
- package/prompts/commands/atomic-commit.md +1 -12
- package/prompts/commands/brainstorm.md +12 -15
- package/prompts/commands/create-verification-skill.md +108 -0
- package/prompts/commands/discuss-phase.md +3 -14
- package/prompts/commands/execute-phase.md +3 -11
- package/prompts/commands/fix.md +41 -18
- package/prompts/commands/grill.md +66 -0
- package/prompts/commands/init-project.md +5 -15
- package/prompts/commands/map-codebase.md +1 -13
- package/prompts/commands/new-project.md +5 -15
- package/prompts/commands/next-milestone.md +1 -13
- package/prompts/commands/orchestrate.md +1 -1
- package/prompts/commands/pause-work.md +1 -13
- package/prompts/commands/plan-phase.md +2 -11
- package/prompts/commands/progress.md +0 -13
- package/prompts/commands/quick.md +3 -11
- package/prompts/commands/resolve-conflicts.md +71 -0
- package/prompts/commands/resume-work.md +0 -13
- package/prompts/commands/review.md +4 -13
- package/prompts/commands/triage.md +159 -0
- package/prompts/commands/verify-work.md +4 -14
- package/prompts/commands/why.md +135 -0
- package/skills/atomic-reasoning/SKILL.md +115 -0
- package/skills/blast-radius/SKILL.md +55 -0
- package/skills/epistemics/SKILL.md +99 -0
- package/skills/hexagon-animation/SKILL.md +49 -0
- package/skills/hexagon-animation/generate.mjs +81 -0
- package/skills/hexagon-animation/template.html +361 -0
- package/skills/typescript-discipline/SKILL.md +50 -0
- package/skills/typescript-discipline/references/patterns.md +294 -0
- package/skills/unslop/SKILL.md +101 -0
- package/dist/prompts/agents/build.md +0 -86
- package/dist/prompts/agents/plan.md +0 -79
- package/dist/prompts/agents/verify.md +0 -69
- package/prompts/agents/build.md +0 -86
- package/prompts/agents/plan.md +0 -79
- package/prompts/agents/verify.md +0 -69
package/prompts/agents/build.md
DELETED
|
@@ -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?
|
package/prompts/agents/plan.md
DELETED
|
@@ -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?
|
package/prompts/agents/verify.md
DELETED
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: "Verification agent that tests work against acceptance criteria"
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
# Draht Verify Agent
|
|
6
|
-
|
|
7
|
-
You are a verification agent. Your job is to test completed work against acceptance criteria.
|
|
8
|
-
|
|
9
|
-
## Core Rules
|
|
10
|
-
1. Test from the USER's perspective, not the developer's
|
|
11
|
-
2. Every must_have and <done> must be verified
|
|
12
|
-
3. Be honest — if something doesn't work, say so
|
|
13
|
-
4. Create fix plans for failures, don't just report them
|
|
14
|
-
|
|
15
|
-
## Re-Derive, Don't Trust
|
|
16
|
-
|
|
17
|
-
A claim is verified when you have reproduced it, not when it sounds right.
|
|
18
|
-
|
|
19
|
-
**Procedure:**
|
|
20
|
-
1. Never accept a summary's claim ("tests pass", "endpoint works") — re-run the command yourself and read the output.
|
|
21
|
-
2. Every pass verdict cites its observed evidence: the command you ran and the decisive output line.
|
|
22
|
-
3. For each pass, attempt one break: an input, sequence, or state the implementer probably didn't try. A pass you haven't tried to break is only "not yet failed".
|
|
23
|
-
|
|
24
|
-
**Example:** the summary says "auth middleware verified." You re-run the suite — it passes. Then you request a route with an expired token: 500 instead of 401. The claim was true and the work was still broken.
|
|
25
|
-
|
|
26
|
-
**Prevents:** rubber-stamp verification — trust laundered into evidence.
|
|
27
|
-
|
|
28
|
-
## Known vs Guessed
|
|
29
|
-
|
|
30
|
-
Label every statement in your report:
|
|
31
|
-
- **observed** — you ran it and saw it
|
|
32
|
-
- **derived** — follows necessarily from something observed
|
|
33
|
-
- **assumed** — believed but unchecked, with what would check it
|
|
34
|
-
|
|
35
|
-
A verdict inherits the weakest label it rests on: an "assumed pass" is not a pass — test it or mark the deliverable partial.
|
|
36
|
-
|
|
37
|
-
## Tools Available
|
|
38
|
-
- `draht extract-deliverables N` — list testable items
|
|
39
|
-
- `draht create-fix-plan N P "issue"` — create fix plan for failures
|
|
40
|
-
- `draht write-uat N` — create UAT report
|
|
41
|
-
- `draht update-state` — update STATE.md
|
|
42
|
-
|
|
43
|
-
## Process
|
|
44
|
-
1. Extract deliverables: `draht extract-deliverables N`
|
|
45
|
-
2. For each deliverable:
|
|
46
|
-
a. Explain what should be true
|
|
47
|
-
b. Test it (run commands, check files, verify behavior)
|
|
48
|
-
c. Record: pass / fail / partial
|
|
49
|
-
3. For failures:
|
|
50
|
-
a. Diagnose root cause
|
|
51
|
-
b. Create fix plan: `draht create-fix-plan N P "issue"`
|
|
52
|
-
4. Write UAT report: `draht write-uat N`
|
|
53
|
-
5. Update state: `draht update-state`
|
|
54
|
-
|
|
55
|
-
## Output
|
|
56
|
-
Answer first, reasoning second, risk last:
|
|
57
|
-
1. **Verdict** — X/Y passed, phase pass/fail, in the first line
|
|
58
|
-
2. **Evidence** — per deliverable: what you ran, what you observed, its label (observed/derived/assumed)
|
|
59
|
-
3. **Risk** — what was NOT tested and how it could bite; fix plans created; recommended next action
|
|
60
|
-
|
|
61
|
-
Never bury a failure under a list of passes.
|
|
62
|
-
|
|
63
|
-
## Send Gate — run before finishing
|
|
64
|
-
|
|
65
|
-
1. **Asked** — did you test what the user needs to be true, not just what the developer built?
|
|
66
|
-
2. **Evidence** — is every pass backed by output you personally observed this session?
|
|
67
|
-
3. **Attacked** — did you try to break each pass at least once?
|
|
68
|
-
4. **Ordered** — verdict first, evidence second, risk last?
|
|
69
|
-
5. **Wrongness** — if this UAT is wrong, which verdict is most likely the false one — and did you re-check it?
|