@draht/coding-agent 2026.7.13 → 2026.9.5-1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +241 -0
- package/README.md +47 -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/bun/cli.js +2 -0
- package/dist/bun/cli.js.map +1 -1
- package/dist/cli/args.d.ts +10 -0
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +80 -3
- 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/config-selector.js +1 -1
- package/dist/cli/config-selector.js.map +1 -1
- package/dist/cli/credential-print.d.ts +23 -0
- package/dist/cli/credential-print.d.ts.map +1 -0
- package/dist/cli/credential-print.js +117 -0
- package/dist/cli/credential-print.js.map +1 -0
- package/dist/cli/list-models.d.ts +2 -2
- package/dist/cli/list-models.d.ts.map +1 -1
- package/dist/cli/list-models.js +3 -3
- package/dist/cli/list-models.js.map +1 -1
- package/dist/cli/startup-ui.js +1 -1
- package/dist/cli/startup-ui.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 +90 -30
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts +4 -7
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +24 -9
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +87 -27
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +337 -154
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts +20 -104
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +104 -260
- 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/cache-stats.d.ts +2 -2
- package/dist/core/cache-stats.d.ts.map +1 -1
- package/dist/core/cache-stats.js +1 -1
- package/dist/core/cache-stats.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 +9 -3
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +16 -14
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +24 -3
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +96 -30
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/compaction/utils.d.ts +1 -1
- package/dist/core/compaction/utils.d.ts.map +1 -1
- package/dist/core/compaction/utils.js +6 -17
- package/dist/core/compaction/utils.js.map +1 -1
- package/dist/core/context-windows.d.ts +7 -0
- package/dist/core/context-windows.d.ts.map +1 -0
- package/dist/core/context-windows.js +35 -0
- package/dist/core/context-windows.js.map +1 -0
- 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 +101 -23
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +19 -3
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +117 -2
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +236 -9
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/extensions/wrapper.d.ts.map +1 -1
- package/dist/core/extensions/wrapper.js +22 -3
- package/dist/core/extensions/wrapper.js.map +1 -1
- package/dist/core/footer-data-provider.d.ts +10 -0
- package/dist/core/footer-data-provider.d.ts.map +1 -1
- package/dist/core/footer-data-provider.js +1 -1
- package/dist/core/footer-data-provider.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 +18 -3
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +12 -3
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/model-config.d.ts +542 -0
- package/dist/core/model-config.d.ts.map +1 -0
- package/dist/core/model-config.js +247 -0
- package/dist/core/model-config.js.map +1 -0
- package/dist/core/model-registry.d.ts +19 -124
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +56 -727
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts +7 -6
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +74 -27
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +89 -0
- package/dist/core/model-runtime.d.ts.map +1 -0
- package/dist/core/model-runtime.js +451 -0
- package/dist/core/model-runtime.js.map +1 -0
- package/dist/core/models-store.d.ts +17 -0
- package/dist/core/models-store.d.ts.map +1 -0
- package/dist/core/models-store.js +46 -0
- package/dist/core/models-store.js.map +1 -0
- 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 +41 -45
- 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/prompt-templates.d.ts +1 -0
- package/dist/core/prompt-templates.d.ts.map +1 -1
- package/dist/core/prompt-templates.js +4 -4
- package/dist/core/prompt-templates.js.map +1 -1
- package/dist/core/provider-composer.d.ts +55 -0
- package/dist/core/provider-composer.d.ts.map +1 -0
- package/dist/core/provider-composer.js +375 -0
- package/dist/core/provider-composer.js.map +1 -0
- package/dist/core/radius.d.ts +2 -0
- package/dist/core/radius.d.ts.map +1 -0
- package/dist/core/radius.js +2 -0
- package/dist/core/radius.js.map +1 -0
- package/dist/core/remote-catalog-provider.d.ts +5 -0
- package/dist/core/remote-catalog-provider.d.ts.map +1 -0
- package/dist/core/remote-catalog-provider.js +115 -0
- package/dist/core/remote-catalog-provider.js.map +1 -0
- package/dist/core/resource-loader.d.ts +36 -0
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +159 -27
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/runtime-credentials.d.ts +15 -0
- package/dist/core/runtime-credentials.d.ts.map +1 -0
- package/dist/core/runtime-credentials.js +35 -0
- package/dist/core/runtime-credentials.js.map +1 -0
- 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 +3 -6
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +25 -22
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-manager.d.ts +74 -7
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +169 -34
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-manager.d.ts +22 -1
- 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 +10 -21
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/tools/bash.d.ts +3 -1
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +39 -7
- 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/tools/read.js +1 -1
- package/dist/core/tools/read.js.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.js +3 -1
- package/dist/core/tools/tool-definition-wrapper.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/core/usage-totals.d.ts +19 -0
- package/dist/core/usage-totals.d.ts.map +1 -0
- package/dist/core/usage-totals.js +52 -0
- package/dist/core/usage-totals.js.map +1 -0
- package/dist/extensions/index.d.ts +3 -0
- package/dist/extensions/index.d.ts.map +1 -0
- package/dist/extensions/index.js +7 -0
- package/dist/extensions/index.js.map +1 -0
- package/dist/extensions/llama/client.d.ts +61 -0
- package/dist/extensions/llama/client.d.ts.map +1 -0
- package/dist/extensions/llama/client.js +300 -0
- package/dist/extensions/llama/client.js.map +1 -0
- package/dist/extensions/llama/huggingface.d.ts +23 -0
- package/dist/extensions/llama/huggingface.d.ts.map +1 -0
- package/dist/extensions/llama/huggingface.js +139 -0
- package/dist/extensions/llama/huggingface.js.map +1 -0
- package/dist/extensions/llama/index.d.ts +3 -0
- package/dist/extensions/llama/index.d.ts.map +1 -0
- package/dist/extensions/llama/index.js +208 -0
- package/dist/extensions/llama/index.js.map +1 -0
- package/dist/extensions/llama/provider.d.ts +10 -0
- package/dist/extensions/llama/provider.d.ts.map +1 -0
- package/dist/extensions/llama/provider.js +111 -0
- package/dist/extensions/llama/provider.js.map +1 -0
- package/dist/extensions/llama/ui.d.ts +42 -0
- package/dist/extensions/llama/ui.d.ts.map +1 -0
- package/dist/extensions/llama/ui.js +400 -0
- package/dist/extensions/llama/ui.js.map +1 -0
- 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 +4 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -3
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +305 -61
- package/dist/main.js.map +1 -1
- package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/assistant-message.js +22 -10
- package/dist/modes/interactive/components/assistant-message.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/custom-editor.js +1 -1
- package/dist/modes/interactive/components/custom-editor.js.map +1 -1
- package/dist/modes/interactive/components/custom-message.d.ts +3 -1
- package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
- package/dist/modes/interactive/components/custom-message.js +9 -2
- package/dist/modes/interactive/components/custom-message.js.map +1 -1
- package/dist/modes/interactive/components/extension-editor.d.ts +1 -2
- package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-editor.js +16 -46
- package/dist/modes/interactive/components/extension-editor.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/footer.d.ts.map +1 -1
- package/dist/modes/interactive/components/footer.js +24 -23
- package/dist/modes/interactive/components/footer.js.map +1 -1
- package/dist/modes/interactive/components/login-dialog.d.ts +5 -5
- package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
- package/dist/modes/interactive/components/login-dialog.js +17 -8
- package/dist/modes/interactive/components/login-dialog.js.map +1 -1
- package/dist/modes/interactive/components/model-selector.d.ts +11 -4
- package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/model-selector.js +74 -41
- package/dist/modes/interactive/components/model-selector.js.map +1 -1
- package/dist/modes/interactive/components/oauth-selector.d.ts +4 -4
- package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/oauth-selector.js +14 -25
- package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
- package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/scoped-models-selector.js +22 -13
- package/dist/modes/interactive/components/scoped-models-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 +25 -2
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +68 -17
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/external-editor.d.ts +12 -0
- package/dist/modes/interactive/external-editor.d.ts.map +1 -0
- package/dist/modes/interactive/external-editor.js +37 -0
- package/dist/modes/interactive/external-editor.js.map +1 -0
- package/dist/modes/interactive/interactive-mode.d.ts +107 -10
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +763 -285
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-client.d.ts +4 -0
- package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-client.js +7 -0
- package/dist/modes/rpc/rpc-client.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +185 -9
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +79 -1
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/package-manager-cli.d.ts.map +1 -1
- package/dist/package-manager-cli.js +67 -5
- package/dist/package-manager-cli.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-native.d.ts +1 -0
- package/dist/utils/clipboard-native.d.ts.map +1 -1
- package/dist/utils/clipboard-native.js.map +1 -1
- package/dist/utils/clipboard.d.ts +2 -0
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +53 -9
- 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/dist/utils/version-check.d.ts.map +1 -1
- package/dist/utils/version-check.js +3 -1
- package/dist/utils/version-check.js.map +1 -1
- package/docs/attachable-sessions.md +79 -0
- package/docs/compaction.md +29 -24
- package/docs/containerization.md +23 -23
- package/docs/custom-provider.md +66 -32
- package/docs/development.md +9 -9
- package/docs/docs.json +6 -2
- package/docs/duet.md +42 -0
- package/docs/environment-variables.md +88 -0
- package/docs/extensions.md +278 -65
- package/docs/index.md +12 -10
- package/docs/json.md +12 -8
- package/docs/keybindings.md +8 -5
- package/docs/llama-cpp.md +99 -0
- package/docs/models.md +19 -8
- package/docs/packages.md +43 -42
- package/docs/prompt-templates.md +5 -4
- package/docs/providers.md +45 -11
- package/docs/quickstart.md +33 -33
- package/docs/rpc.md +190 -19
- package/docs/sdk.md +18 -15
- package/docs/security.md +18 -18
- package/docs/session-format.md +53 -15
- package/docs/sessions.md +17 -14
- package/docs/settings.md +26 -19
- 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 +46 -31
- package/docs/usage.md +53 -63
- package/docs/windows.md +2 -2
- package/examples/extensions/custom-compaction.ts +4 -0
- package/examples/extensions/custom-provider-anthropic/index.ts +9 -3
- package/examples/extensions/custom-provider-anthropic/package.json +1 -1
- package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
- package/examples/extensions/custom-provider-qwen-cli/package.json +1 -1
- package/examples/extensions/gondolin/package.json +2 -2
- package/examples/extensions/handoff.ts +9 -1
- package/examples/extensions/kimi-deferred-tools.ts +61 -0
- package/examples/extensions/message-renderer.ts +2 -2
- package/examples/extensions/overlay-qa-tests.ts +3 -3
- package/examples/extensions/sandbox/package.json +1 -1
- package/examples/extensions/summarize.ts +3 -0
- package/examples/extensions/with-deps/package.json +1 -1
- package/examples/sdk/02-custom-model.ts +5 -8
- package/examples/sdk/09-api-keys-and-oauth.ts +15 -31
- package/examples/sdk/12-full-control.ts +9 -12
- package/hooks/gsd/draht-quality-gate.js +3 -3
- package/package.json +14 -11
- 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/core/provider-display-names.d.ts +0 -2
- package/dist/core/provider-display-names.d.ts.map +0 -1
- package/dist/core/provider-display-names.js +0 -36
- package/dist/core/provider-display-names.js.map +0 -1
- 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
|
@@ -0,0 +1,294 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CheckpointManager — working-tree snapshot capture and durable storage (Phase 41).
|
|
3
|
+
*
|
|
4
|
+
* Captures git snapshots of the working tree via a temporary index
|
|
5
|
+
* (`GIT_INDEX_FILE` + `add -A` + `write-tree` + `commit-tree`) and anchors
|
|
6
|
+
* them at `refs/draht/checkpoints/<session-id>/<entry-id>` so they are
|
|
7
|
+
* GC-proof and invisible to the user's git workflow: the user's index,
|
|
8
|
+
* `HEAD`, stash, and reflog are never touched, and `git stash` is never used.
|
|
9
|
+
*
|
|
10
|
+
* Metadata lives in a sidecar JSONL next to the session file
|
|
11
|
+
* (`<session-file>.checkpoints.jsonl`).
|
|
12
|
+
*/
|
|
13
|
+
/** Ref namespace for checkpoint snapshots: `refs/draht/checkpoints/<session-id>/<entry-id>`. */
|
|
14
|
+
export declare const CHECKPOINT_REF_PREFIX = "refs/draht/checkpoints";
|
|
15
|
+
/**
|
|
16
|
+
* Ref-name segment marking a pre-rewind safety snapshot. Keeps safety refs out
|
|
17
|
+
* of the plain `<session-id>/<entry-id>` name space so capturing one can never
|
|
18
|
+
* overwrite the checkpoint already anchored for that entry.
|
|
19
|
+
*/
|
|
20
|
+
export declare const SAFETY_REF_SEGMENT = "pre-rewind";
|
|
21
|
+
/** One sidecar line: metadata for a single captured checkpoint. */
|
|
22
|
+
export interface CheckpointRecord {
|
|
23
|
+
/** Session entry id the snapshot is keyed to. */
|
|
24
|
+
entryId: string;
|
|
25
|
+
/** Fully-qualified git ref anchoring the snapshot commit. */
|
|
26
|
+
ref: string;
|
|
27
|
+
/** Tree hash of the snapshot commit (dedup anchor). */
|
|
28
|
+
treeHash: string;
|
|
29
|
+
/** ISO-8601 capture time. */
|
|
30
|
+
timestamp: string;
|
|
31
|
+
/** Number of files differing from HEAD at capture time. */
|
|
32
|
+
dirtyFileCount: number;
|
|
33
|
+
/**
|
|
34
|
+
* Unique id for this individual snapshot, stable for the life of the
|
|
35
|
+
* sidecar. `entryId` is *not* unique — a pre-rewind safety snapshot shares
|
|
36
|
+
* it with the checkpoint it is keyed to, and two rewinds from the same leaf
|
|
37
|
+
* produce two safety snapshots under the same `entryId` — so this is what
|
|
38
|
+
* makes every recovery point independently addressable (see
|
|
39
|
+
* `getRecoveryPoint`). Optional only for sidecars written before it existed.
|
|
40
|
+
*/
|
|
41
|
+
recoveryId?: string;
|
|
42
|
+
/** `"safety"` for pre-rewind snapshots, `"checkpoint"` for turn captures. */
|
|
43
|
+
kind?: "checkpoint" | "safety";
|
|
44
|
+
}
|
|
45
|
+
export type CheckpointCaptureStatus = "created" | "deduplicated" | "disabled" | "failed";
|
|
46
|
+
export interface CheckpointCaptureResult {
|
|
47
|
+
status: CheckpointCaptureStatus;
|
|
48
|
+
/** Set when status is "created". */
|
|
49
|
+
record?: CheckpointRecord;
|
|
50
|
+
/** Set when status is "disabled" or "failed". */
|
|
51
|
+
reason?: string;
|
|
52
|
+
}
|
|
53
|
+
export interface CheckpointManagerOptions {
|
|
54
|
+
/** Directory whose containing git repository is snapshotted. */
|
|
55
|
+
cwd: string;
|
|
56
|
+
/** Session id used to namespace refs. */
|
|
57
|
+
sessionId: string;
|
|
58
|
+
/** Session file path; the sidecar lives next to it. */
|
|
59
|
+
sessionFile: string;
|
|
60
|
+
/**
|
|
61
|
+
* Called with each newly captured checkpoint, before `captureIfChanged`
|
|
62
|
+
* returns. The extension runner uses this to dispatch `checkpoint_created`
|
|
63
|
+
* (R42-RWD.8). Deduplicated captures and pre-rewind safety snapshots do not
|
|
64
|
+
* fire it — only real, new turn checkpoints do.
|
|
65
|
+
*/
|
|
66
|
+
onCaptured?: (record: CheckpointRecord) => void | Promise<void>;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Outcome of a working-tree restore.
|
|
70
|
+
*
|
|
71
|
+
* - `restored` — the tree now matches the target snapshot.
|
|
72
|
+
* - `unchanged` — the tree already matched it; nothing was written or deleted.
|
|
73
|
+
* - `rolled-back` — the restore failed part-way and the tree was returned to
|
|
74
|
+
* the pre-rewind safety snapshot.
|
|
75
|
+
* - `unrecoverable` — the restore failed *and* the rollback failed; both refs
|
|
76
|
+
* are reported on the result so no state is lost.
|
|
77
|
+
* - `disabled` — the cwd is not inside a git repository.
|
|
78
|
+
* - `failed` — the restore could not start; nothing was mutated.
|
|
79
|
+
*/
|
|
80
|
+
export type CheckpointRestoreStatus = "restored" | "unchanged" | "rolled-back" | "unrecoverable" | "disabled" | "failed";
|
|
81
|
+
export interface CheckpointRestoreOptions {
|
|
82
|
+
/** Entry id whose checkpoint the working tree is restored to. */
|
|
83
|
+
targetEntryId: string;
|
|
84
|
+
/**
|
|
85
|
+
* Current session leaf. The pre-rewind safety snapshot is recorded against
|
|
86
|
+
* it, so rewinding back to this entry redoes the abandoned state.
|
|
87
|
+
*/
|
|
88
|
+
currentEntryId: string;
|
|
89
|
+
/**
|
|
90
|
+
* Invoked after each individual path is written or deleted. Progress seam
|
|
91
|
+
* for the UI, and the failure-injection seam for tests: throwing from it
|
|
92
|
+
* aborts the restore and triggers the rollback to the safety snapshot.
|
|
93
|
+
*/
|
|
94
|
+
onPathRestored?: (path: string) => void | Promise<void>;
|
|
95
|
+
}
|
|
96
|
+
export interface CheckpointRestoreResult {
|
|
97
|
+
status: CheckpointRestoreStatus;
|
|
98
|
+
/** Paths written out of the target snapshot and kept. */
|
|
99
|
+
restored: string[];
|
|
100
|
+
/** Paths deleted because the target snapshot does not contain them. */
|
|
101
|
+
deleted: string[];
|
|
102
|
+
/** The pre-rewind safety snapshot, once one could be captured. */
|
|
103
|
+
safety?: CheckpointRecord;
|
|
104
|
+
/** The checkpoint that was restored to, once it could be resolved. */
|
|
105
|
+
target?: CheckpointRecord;
|
|
106
|
+
/** Why the restore did not complete. Set for every status but `restored`/`unchanged`. */
|
|
107
|
+
reason?: string;
|
|
108
|
+
/** Why the rollback failed. Only ever set together with status `unrecoverable`. */
|
|
109
|
+
rollbackReason?: string;
|
|
110
|
+
}
|
|
111
|
+
export interface CheckpointRewindOptions extends CheckpointRestoreOptions {
|
|
112
|
+
/**
|
|
113
|
+
* Moves the conversation leaf (`AgentSession.navigateTree`). Invoked only
|
|
114
|
+
* after the file restore has succeeded — see R42-RWD.5.
|
|
115
|
+
*/
|
|
116
|
+
navigate: () => void | Promise<void>;
|
|
117
|
+
}
|
|
118
|
+
export interface CheckpointRewindResult {
|
|
119
|
+
/** Result of the file half. */
|
|
120
|
+
restore: CheckpointRestoreResult;
|
|
121
|
+
/** Whether `navigate()` ran — i.e. whether the file restore succeeded. */
|
|
122
|
+
navigated: boolean;
|
|
123
|
+
/** Set when `navigate()` itself threw; the files are already restored. */
|
|
124
|
+
navigateReason?: string;
|
|
125
|
+
}
|
|
126
|
+
export interface CheckpointPruneOptions {
|
|
127
|
+
/** Delete refs whose snapshot commit is older than this. Default: 30. */
|
|
128
|
+
retentionDays?: number;
|
|
129
|
+
/** Keep at most this many newest refs per session namespace. Default: unlimited. */
|
|
130
|
+
maxPerSession?: number;
|
|
131
|
+
/** Report what would be deleted without deleting. */
|
|
132
|
+
dryRun?: boolean;
|
|
133
|
+
/** Clock override for tests. */
|
|
134
|
+
now?: Date;
|
|
135
|
+
}
|
|
136
|
+
export interface CheckpointPruneResult {
|
|
137
|
+
/** Total checkpoint refs found in the repository. */
|
|
138
|
+
examined: number;
|
|
139
|
+
/** Refs deleted (or, with dryRun, refs that would be deleted). */
|
|
140
|
+
deleted: string[];
|
|
141
|
+
}
|
|
142
|
+
/** Path of the checkpoint metadata sidecar for a session file. */
|
|
143
|
+
export declare function checkpointSidecarPath(sessionFile: string): string;
|
|
144
|
+
/**
|
|
145
|
+
* Name of the in-progress marker, written inside the repository's git
|
|
146
|
+
* directory (per worktree, like the rest of git's own state) so it is found
|
|
147
|
+
* again from any session that opens the same tree.
|
|
148
|
+
*/
|
|
149
|
+
export declare const RESTORE_MARKER_FILE = "draht-restore-in-progress.json";
|
|
150
|
+
/** A restore that started and never finished — a crash or a kill mid-restore. */
|
|
151
|
+
export interface InterruptedRestore {
|
|
152
|
+
/** Absolute path of the marker file, so a message can tell the user what to delete. */
|
|
153
|
+
markerPath: string;
|
|
154
|
+
/** Ref of the pre-rewind safety snapshot that recovers the tree. Empty when the marker is unreadable. */
|
|
155
|
+
safetyRef: string;
|
|
156
|
+
/** Recovery id addressing that safety snapshot through `getRecoveryPoint`. */
|
|
157
|
+
safetyRecoveryId?: string;
|
|
158
|
+
/** Ref of the snapshot the interrupted restore was moving towards. */
|
|
159
|
+
targetRef?: string;
|
|
160
|
+
targetEntryId?: string;
|
|
161
|
+
currentEntryId?: string;
|
|
162
|
+
/** ISO-8601 start time of the interrupted restore. */
|
|
163
|
+
startedAt?: string;
|
|
164
|
+
}
|
|
165
|
+
/** The message shown when a previous restore is found to have been interrupted. */
|
|
166
|
+
export declare function describeInterruptedRestore(marker: InterruptedRestore): string;
|
|
167
|
+
/** Read all valid records from a sidecar file. Malformed lines are skipped. */
|
|
168
|
+
export declare function readCheckpointSidecar(sidecarPath: string): CheckpointRecord[];
|
|
169
|
+
/**
|
|
170
|
+
* Copy sidecar records for preserved entry ids from one session file's
|
|
171
|
+
* sidecar to another's (used by /fork and /clone). Returns the number of
|
|
172
|
+
* records copied. Refs are copied verbatim — they keep pointing at the
|
|
173
|
+
* source session's namespace, which stays anchored in the repository.
|
|
174
|
+
*/
|
|
175
|
+
export declare function propagateCheckpointSidecar(sourceSessionFile: string, targetSessionFile: string, preservedEntryIds: ReadonlySet<string>): number;
|
|
176
|
+
export declare class CheckpointManager {
|
|
177
|
+
private readonly cwd;
|
|
178
|
+
private readonly sessionId;
|
|
179
|
+
private readonly sidecarPath;
|
|
180
|
+
private readonly onCaptured?;
|
|
181
|
+
constructor(options: CheckpointManagerOptions);
|
|
182
|
+
/**
|
|
183
|
+
* Capture a snapshot of the working tree keyed to the given session entry
|
|
184
|
+
* id, unless the tree hash equals the previous checkpoint's (dedup).
|
|
185
|
+
* Never throws for expected conditions: non-git cwds report "disabled",
|
|
186
|
+
* git failures report "failed".
|
|
187
|
+
*/
|
|
188
|
+
captureIfChanged(entryId: string): Promise<CheckpointCaptureResult>;
|
|
189
|
+
/**
|
|
190
|
+
* Snapshot the working tree into a throwaway index and return its tree
|
|
191
|
+
* hash. A private index keeps `add -A` off the user's real index entirely,
|
|
192
|
+
* and `add -A` honours `.gitignore` for *untracked* files, so ignored files
|
|
193
|
+
* never enter a snapshot — and therefore can never be restored or deleted
|
|
194
|
+
* by a rewind.
|
|
195
|
+
*
|
|
196
|
+
* The throwaway index is seeded from the user's real one first. Ignore
|
|
197
|
+
* rules never apply to a path git already tracks, so seeding is what keeps
|
|
198
|
+
* a tracked-but-ignored file (`git add -f secret.env` with `secret.env` in
|
|
199
|
+
* `.gitignore`) inside the snapshot: from an empty index every path looks
|
|
200
|
+
* untracked, and such files silently fell out of every snapshot while
|
|
201
|
+
* restores still reported success.
|
|
202
|
+
*/
|
|
203
|
+
private writeTreeSnapshot;
|
|
204
|
+
/**
|
|
205
|
+
* Copy the user's index into the throwaway one so its tracked set carries
|
|
206
|
+
* over. Read-only with respect to the real index — it is copied, never
|
|
207
|
+
* written back, and `git rev-parse --git-path index` resolves the effective
|
|
208
|
+
* index (split-index links resolve against the git dir, so a copy still
|
|
209
|
+
* reads). Falls back to `read-tree HEAD`, whose tracked set is the next
|
|
210
|
+
* best answer, and to an empty index when HEAD is unborn — where nothing is
|
|
211
|
+
* tracked and empty is the correct answer.
|
|
212
|
+
*/
|
|
213
|
+
private seedSnapshotIndex;
|
|
214
|
+
/** Whether a ref already exists, without throwing for the common "it does not" case. */
|
|
215
|
+
private refExists;
|
|
216
|
+
/** Absolute path of this repository's in-progress restore marker. */
|
|
217
|
+
private restoreMarkerPath;
|
|
218
|
+
/** Anchor a tree behind a commit at `ref` so it survives GC. */
|
|
219
|
+
private anchorTree;
|
|
220
|
+
/** Append the sidecar record for an anchored snapshot. */
|
|
221
|
+
private recordSnapshot;
|
|
222
|
+
/**
|
|
223
|
+
* Capture the pre-rewind safety snapshot (R42-RWD.3). Unlike
|
|
224
|
+
* `captureIfChanged` this never dedups — the rewind must always have an
|
|
225
|
+
* anchored ref to roll back to — and it never reuses the plain checkpoint
|
|
226
|
+
* ref name, so an existing checkpoint for the same entry id is preserved.
|
|
227
|
+
* The record is keyed to the current leaf so that rewinding back to it is
|
|
228
|
+
* a redo of the abandoned state.
|
|
229
|
+
*/
|
|
230
|
+
private captureSafetySnapshot;
|
|
231
|
+
/**
|
|
232
|
+
* Restore the working tree to the checkpoint recorded for `targetEntryId`
|
|
233
|
+
* (R42-RWD.3, R42-RWD.4).
|
|
234
|
+
*
|
|
235
|
+
* Ordering is fixed: a safety snapshot of the current tree is captured and
|
|
236
|
+
* anchored *before* anything is mutated, then the two snapshot trees are
|
|
237
|
+
* diffed and only the differing paths are touched — differing paths are
|
|
238
|
+
* checked out of the target snapshot, paths absent from it are deleted.
|
|
239
|
+
* Deliberately not `git stash apply` and not `git checkout -- .`: both
|
|
240
|
+
* clobber untracked and ignored state. Ignored files are never in a
|
|
241
|
+
* snapshot, so they are never in the diff and never touched.
|
|
242
|
+
*
|
|
243
|
+
* Before the first mutation the diff is checked for the cases where that
|
|
244
|
+
* reasoning does not hold, and the whole restore is refused (`failed`,
|
|
245
|
+
* nothing touched) rather than applied part-way:
|
|
246
|
+
* - a path to delete that is, or contains, a nested git repository;
|
|
247
|
+
* - a path to create that already exists on disk yet is in no snapshot;
|
|
248
|
+
* - ignore rules that differ between the snapshots while deletions pend.
|
|
249
|
+
* A refusal is recoverable, a deletion is not.
|
|
250
|
+
*
|
|
251
|
+
* Any failure after the first mutation rolls the tree back to the safety
|
|
252
|
+
* snapshot; if that rollback also fails, both refs are reported on the
|
|
253
|
+
* result rather than left implicit. An in-progress marker in the git dir
|
|
254
|
+
* names the safety ref for as long as the tree is being mutated, so an
|
|
255
|
+
* interrupted restore is never silent. Never throws.
|
|
256
|
+
*/
|
|
257
|
+
restore(options: CheckpointRestoreOptions): Promise<CheckpointRestoreResult>;
|
|
258
|
+
/**
|
|
259
|
+
* Restore files and then move the conversation leaf, in that order
|
|
260
|
+
* (R42-RWD.5). `navigate` runs only once the file restore has succeeded,
|
|
261
|
+
* so a caller cannot move the leaf ahead of the working tree. Never throws.
|
|
262
|
+
*/
|
|
263
|
+
rewind(options: CheckpointRewindOptions): Promise<CheckpointRewindResult>;
|
|
264
|
+
/** Files in the snapshot that differ from HEAD; the whole tree when HEAD is unborn. */
|
|
265
|
+
private countDirtyFiles;
|
|
266
|
+
/** All sidecar records for this session, in capture order. */
|
|
267
|
+
list(): CheckpointRecord[];
|
|
268
|
+
/** Latest record for an entry id, if any. */
|
|
269
|
+
get(entryId: string): CheckpointRecord | undefined;
|
|
270
|
+
/**
|
|
271
|
+
* The one snapshot with this recovery id. `get` answers "the newest
|
|
272
|
+
* snapshot for this entry", which by design shadows older ones — two
|
|
273
|
+
* rewinds from the same leaf record two safety snapshots under the same
|
|
274
|
+
* entry id. This addresses a single snapshot, so no recovery point is ever
|
|
275
|
+
* unreachable, and `restore` accepts a recovery id wherever it accepts an
|
|
276
|
+
* entry id.
|
|
277
|
+
*/
|
|
278
|
+
getRecoveryPoint(recoveryId: string): CheckpointRecord | undefined;
|
|
279
|
+
/** Every pre-rewind safety snapshot, oldest first — the undo history of `/rewind`. */
|
|
280
|
+
listSafetySnapshots(): CheckpointRecord[];
|
|
281
|
+
/**
|
|
282
|
+
* The marker left behind by a restore that never finished, if there is one
|
|
283
|
+
* (D5). Call it at startup to tell the user which ref recovers their tree;
|
|
284
|
+
* `restore` refuses while it is present. Clearing it is the user's decision
|
|
285
|
+
* (`clearInterruptedRestore`), because only they know whether the tree is
|
|
286
|
+
* the way they want it.
|
|
287
|
+
*/
|
|
288
|
+
static findInterruptedRestore(cwd: string): Promise<InterruptedRestore | undefined>;
|
|
289
|
+
/** Acknowledge an interrupted restore, re-enabling `restore`. Returns whether a marker was cleared. */
|
|
290
|
+
static clearInterruptedRestore(cwd: string): Promise<boolean>;
|
|
291
|
+
/** Delete checkpoint refs per the retention policy. Repo-wide, all sessions. */
|
|
292
|
+
static pruneRepository(cwd: string, options?: CheckpointPruneOptions): Promise<CheckpointPruneResult>;
|
|
293
|
+
}
|
|
294
|
+
//# sourceMappingURL=checkpoint-manager.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../../src/core/checkpoints/checkpoint-manager.ts"],"names":[],"mappings":"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"}
|