@draht/coding-agent 2026.3.11-1 → 2026.3.25-1

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [2026.3.14] - 2026-03-14
+
+### Added
+
+- built-in terminal notification on agent turn end
+
+### Changed
+
+- fix(coding-agent): use getAgentDir() in example extensions (#2009)
+- Export the structured mapping contract through the public GSD entrypoint
+- Add typed extraction results to GSD domain mapping
+- consolidate quality gate fixture helpers
+- Cover strict-mode TypeScript error detection
+- add TypeScript-error quality gate scenario
+- Cover passing and failing test-suite outcomes
+- add failing test-suite quality gate scenario
+- Create a real-hook quality gate test harness
+- add real quality gate hook harness test
+- verify phase 21 lifecycle execution logs
+- add failing phase 21 execution log verification test
+- exercise phase 21 lifecycle task commit flow
+- add failing phase 21 lifecycle commit flow test
+- define mapCodebase structured extraction contract
+- build phase 21 lifecycle workspace fixture
+- add failing phase 21 lifecycle fixture test
+- reduce duplicated domain fixture assertions
+- Create a stable domain fixture codebase
+- replace gsd structure checks with runtime loading coverage
+- specify stable GSD domain fixture exports
+- add gsd extension runtime loading spec
+- extract reusable temp git repo setup steps
+- Implement the shared git repo helper
+- specify isolated temp git repo helper behavior
+
+### Fixed
+
+- add stdin support to all draht-tools write commands
+- add cmux support to notify example extension
+- add stdin support to create-quick-plan and fix plan prompts to pipe actual content
+- use conventional commit prefixes instead of TDD annotations in prompt templates
+- restore phase 21 verification baseline
+- The draht-tools create-plan command now reads stdin content when piped
+- handle date-based version suffixes in changelog parsing
+- change default update instruction to bun add -g
+
 ## [2026.3.11] - 2026-03-11
 
 ### Added

package/README.md

@@ -7,7 +7,7 @@
 
 Draht is a minimal terminal coding harness. Adapt it to your workflows, not the other way around, without having to fork and modify internals. Extend it with TypeScript [Extensions](#extensions), [Skills](#skills), [Prompt Templates](#prompt-templates), and [Themes](#themes). Put your extensions, skills, prompt templates, and themes in [Draht Packages](#draht-packages) and share them with others via npm or git.
 
-Draht ships with powerful defaults but skips features like sub agents and plan mode. Instead, you can ask draht to build what you want or install a third party package that matches your workflow.
+Draht ships with powerful defaults but skips features like sub agents and plan mode. Instead, you can ask draht to build what you want or install a third party draht package that matches your workflow.
 
 Draht runs in four modes: interactive, print or JSON, RPC for process integration, and an SDK for embedding in your own apps.
 
@@ -65,7 +65,7 @@ Then just talk to draht. By default, draht gives the model four tools: `read`, `
 
 ## Providers & Models
 
-For each built-in provider,draht maintains a list of tool-capable models, updated with every release. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or Ctrl+L).
+For each built-in provider, draht maintains a list of tool-capable models, updated with every release. Authenticate via subscription (`/login`) or API key, then select any model from that provider via `/model` (or Ctrl+L).
 
 **Subscriptions:**
 - Anthropic Claude Pro/Max
@@ -145,10 +145,10 @@ Type `/` in the editor to trigger commands. [Extensions](#extensions) can regist
 | `/copy` | Copy last assistant message to clipboard |
 | `/export [file]` | Export session to HTML file |
 | `/share` | Upload as private GitHub gist with shareable HTML link |
-| `/reload` | Reload extensions, skills, prompts, context files (themes hot-reload automatically) |
+| `/reload` | Reload keybindings, extensions, skills, prompts, and context files (themes hot-reload automatically) |
 | `/hotkeys` | Show all keyboard shortcuts |
 | `/changelog` | Display version history |
-| `/quit`, `/exit` | Quitdraht |
+| `/quit`, `/exit` | Quit draht |
 
 ### Keyboard Shortcuts
 
@@ -172,12 +172,12 @@ See `/hotkeys` for the full list. Customize via `~/.draht/agent/keybindings.json
 
 Submit messages while the agent is working:
 
-- **Enter** queues a *steering* message, delivered after current tool execution (interrupts remaining tools)
+- **Enter** queues a *steering* message, delivered after the current assistant turn finishes executing its tool calls
 - **Alt+Enter** queues a *follow-up* message, delivered only after the agent finishes all work
 - **Escape** aborts and restores queued messages to editor
 - **Alt+Up** retrieves queued messages back to editor
 
-On Windows Terminal, `Alt+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so pi can receive the follow-up shortcut.
+On Windows Terminal, `Alt+Enter` is fullscreen by default. Remap it in [docs/terminal-setup.md](docs/terminal-setup.md) so draht can receive the follow-up shortcut.
 
 Configure delivery in [settings](docs/settings.md): `steeringMode` and `followUpMode` can be `"one-at-a-time"` (default, waits for response) or `"all"` (delivers all queued at once). `transport` selects provider transport preference (`"sse"`, `"websocket"`, or `"auto"`) for providers that support multiple transports.
 
@@ -196,6 +196,7 @@ draht -c                  # Continue most recent session
 draht -r                  # Browse and select from past sessions
 draht --no-session        # Ephemeral mode (don't save)
 draht --session <path>    # Use specific session file or ID
+draht --fork <path>       # Fork specific session file or ID into a new session
 ```
 
 ### Branching
@@ -210,6 +211,8 @@ draht --session <path>    # Use specific session file or ID
 
 **`/fork`** - Create a new session file from the current branch. Opens a selector, copies history up to the selected point, and places that message in the editor for modification.
 
+**`--fork <path|id>`** - Fork an existing session file or partial session UUID directly from the CLI. This copies the full source session into a new session file in the current project.
+
 ### Compaction
 
 Long sessions can exhaust context windows. Compaction summarizes older messages while keeping recent ones.
@@ -262,7 +265,7 @@ Review this code for bugs, security issues, and performance problems.
 Focus on: {{focus}}
 ```
 
-Place in `~/.draht/agent/prompts/`, `.draht/prompts/`, or a [pi package](#draht-packages) to share with others. See [docs/prompt-templates.md](docs/prompt-templates.md).
+Place in `~/.draht/agent/prompts/`, `.draht/prompts/`, or a [draht package](#draht-packages) to share with others. See [docs/prompt-templates.md](docs/prompt-templates.md).
 
 ### Skills
 
@@ -278,19 +281,19 @@ Use this skill when the user asks about X.
 2. Then that
 ```
 
-Place in `~/.draht/agent/skills/`, `~/.agents/skills/`, `.draht/skills/`, or `.agents/skills/` (from `cwd` up through parent directories) or a [pi package](#draht-packages) to share with others. See [docs/skills.md](docs/skills.md).
+Place in `~/.draht/agent/skills/`, `~/.agents/skills/`, `.draht/skills/`, or `.agents/skills/` (from `cwd` up through parent directories) or a [draht package](#draht-packages) to share with others. See [docs/skills.md](docs/skills.md).
 
 ### Extensions
 
 <p align="center"><img src="docs/images/doom-extension.png" alt="Doom Extension" width="600"></p>
 
-TypeScript modules that extenddraht with custom tools, commands, keyboard shortcuts, event handlers, and UI components.
+TypeScript modules that extend draht with custom tools, commands, keyboard shortcuts, event handlers, and UI components.
 
 ```typescript
 export default function (draht: ExtensionAPI) {
- draht.registerTool({ name: "deploy", ... });
- draht.registerCommand("stats", { ... });
- draht.on("tool_call", async (event, ctx) => { ... });
+  draht.registerTool({ name: "deploy", ... });
+  draht.registerCommand("stats", { ... });
+  draht.on("tool_call", async (event, ctx) => { ... });
 }
 ```
 
@@ -304,17 +307,17 @@ export default function (draht: ExtensionAPI) {
 - Git checkpointing and auto-commit
 - SSH and sandbox execution
 - MCP server integration
-- Makedraht look like Claude Code
+- Make draht look like Claude Code
 - Games while waiting (yes, Doom runs)
 - ...anything you can dream up
 
-Place in `~/.draht/agent/extensions/`, `.draht/extensions/`, or a [pi package](#draht-packages) to share with others. See [docs/extensions.md](docs/extensions.md) and [examples/extensions/](examples/extensions/).
+Place in `~/.draht/agent/extensions/`, `.draht/extensions/`, or a [draht package](#draht-packages) to share with others. See [docs/extensions.md](docs/extensions.md) and [examples/extensions/](examples/extensions/).
 
 ### Themes
 
-Built-in: `dark`, `light`. Themes hot-reload: modify the active theme file anddraht immediately applies changes.
+Built-in: `dark`, `light`. Themes hot-reload: modify the active theme file and draht immediately applies changes.
 
-Place in `~/.draht/agent/themes/`, `.draht/themes/`, or a [pi package](#draht-packages) to share with others. See [docs/themes.md](docs/themes.md).
+Place in `~/.draht/agent/themes/`, `.draht/themes/`, or a [draht package](#draht-packages) to share with others. See [docs/themes.md](docs/themes.md).
 
 ### Draht Packages
 
@@ -334,12 +337,13 @@ draht install https://github.com/user/repo@v1      # tag or commit
 draht install ssh://git@github.com/user/repo
 draht install ssh://git@github.com/user/repo@v1    # tag or commit
 draht remove npm:@foo/draht-tools
+draht uninstall npm:@foo/draht-tools          # alias for remove
 draht list
 draht update                               # skips pinned packages
 draht config                               # enable/disable extensions, skills, prompts, themes
 ```
 
-Packages install to `~/.draht/agent/git/` (git) or global npm. Use `-l` for project-local installs (`.draht/git/`, `.draht/npm/`).
+Packages install to `~/.draht/agent/git/` (git) or global npm. Use `-l` for project-local installs (`.draht/git/`, `.draht/npm/`). If you use a Node version manager and want package installs to reuse a stable npm context, set `npmCommand` in `settings.json`, for example `["mise", "exec", "node@20", "--", "npm"]`.
 
 Create a package by adding a `draht` key to `package.json`:
 
@@ -356,7 +360,7 @@ Create a package by adding a `draht` key to `package.json`:
 }
 ```
 
-Without a `draht` manifest,draht auto-discovers from conventional directories (`extensions/`, `skills/`, `prompts/`, `themes/`).
+Without a `draht` manifest, pi auto-discovers from conventional directories (`extensions/`, `skills/`, `prompts/`, `themes/`).
 
 See [docs/packages.md](docs/packages.md).
 
@@ -396,11 +400,11 @@ See [docs/rpc.md](docs/rpc.md) for the protocol.
 
 ## Philosophy
 
-Draht is aggressively extensible so it doesn't have to dictate your workflow. Features that other tools bake in can be built with [extensions](#extensions), [skills](#skills), or installed from third-party [pi packages](#draht-packages). This keeps the core minimal while letting you shapedraht to fit how you work.
+Draht is aggressively extensible so it doesn't have to dictate your workflow. Features that other tools bake in can be built with [extensions](#extensions), [skills](#skills), or installed from third-party [draht packages](#draht-packages). This keeps the core minimal while letting you shape draht to fit how you work.
 
-**No MCP.** Build CLI tools with READMEs (see [Skills](#skills)), or build an extension that adds MCP support. [Why?](https://mariozechner.at/posts/2025-11-02-what-if-you-dont-need-mcp/)
+**No MCP.** Build CLI tools with READMEs (see [Skills](#skills)), or build an extension that adds MCP support.
 
-**No sub-agents.** There's many ways to do this. Spawndraht instances via tmux, or build your own with [extensions](#extensions), or install a package that does it your way.
+**No sub-agents.** There's many ways to do this. Spawn draht instances via tmux, or build your own with [extensions](#extensions), or install a package that does it your way.
 
 **No permission popups.** Run in a container, or build your own confirmation flow with [extensions](#extensions) inline with your environment and security requirements.
 
@@ -410,7 +414,7 @@ Draht is aggressively extensible so it doesn't have to dictate your workflow. Fe
 
 **No background bash.** Use tmux. Full observability, direct interaction.
 
-Read the [blog post](https://mariozechner.at/posts/2025-11-30-pi-coding-agent/) for the full rationale.
+
 
 ---
 
@@ -423,11 +427,12 @@ draht [options] [@files...] [messages...]
 ### Package Commands
 
 ```bash
-draht install <source> [-l]    # Install package, -l for project-local
-draht remove <source> [-l]     # Remove package
-draht update [source]          # Update packages (skips pinned)
-draht list                     # List installed packages
-draht config                   # Enable/disable package resources
+draht install <source> [-l]     # Install package, -l for project-local
+draht remove <source> [-l]      # Remove package
+draht uninstall <source> [-l]   # Alias for remove
+draht update [source]           # Update packages (skips pinned)
+draht list                      # List installed packages
+draht config                    # Enable/disable package resources
 ```
 
 ### Modes
@@ -440,6 +445,12 @@ draht config                   # Enable/disable package resources
 | `--mode rpc` | RPC mode for process integration (see [docs/rpc.md](docs/rpc.md)) |
 | `--export <in> [out]` | Export session to HTML |
 
+In print mode, pi also reads piped stdin and merges it into the initial prompt:
+
+```bash
+cat README.md | draht -p "Summarize this text"
+```
+
 ### Model Options
 
 | Option | Description |
@@ -458,6 +469,7 @@ draht config                   # Enable/disable package resources
 | `-c`, `--continue` | Continue most recent session |
 | `-r`, `--resume` | Browse and select session |
 | `--session <path>` | Use specific session file or partial UUID |
+| `--fork <path>` | Fork specific session file or partial UUID into a new session |
 | `--session-dir <dir>` | Custom session storage directory |
 | `--no-session` | Ephemeral mode (don't save) |
 
@@ -514,6 +526,9 @@ draht "List all .ts files in src/"
 # Non-interactive
 draht -p "Summarize this codebase"
 
+# Non-interactive with piped stdin
+cat README.md | draht -p "Summarize this text"
+
 # Different model
 draht --provider openai --model gpt-4o "Help me refactor"
 
@@ -557,6 +572,6 @@ MIT
 
 ## See Also
 
-- [@draht/ai](https://www.npmjs.com/package/@draht/ai): Core LLM toolkit
-- [@draht/agent-core](https://www.npmjs.com/package/@draht/agent-core): Agent framework
-- [@draht/tui](https://www.npmjs.com/package/@draht/tui): Terminal UI components
+- [@draht/ai](../ai): Core LLM toolkit
+- [@draht/agent-core](../agent): Agent framework
+- [@draht/tui](../tui): Terminal UI components

package/bin/draht-tools.cjs

@@ -305,7 +305,8 @@ commands["phase-info"] = function (n) {
 };
 
 // --- save-context ---
-commands["save-context"] = function (n, ...rest) {
+// Supports stdin: echo "content" | draht-tools save-context N
+commands["save-context"] = async function (n, ...rest) {
 	const num = parseInt(n, 10);
 	if (!num) { console.error("Usage: draht-tools save-context N"); process.exit(1); }
 
@@ -314,7 +315,22 @@ commands["save-context"] = function (n, ...rest) {
 	ensureDir(dir);
 
 	const contextPath = path.join(dir, `${padNum(num)}-CONTEXT.md`);
-	if (fs.existsSync(contextPath)) {
+
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	if (stdinContent) {
+		writeMd(contextPath, stdinContent);
+		console.log(`Created: ${contextPath}`);
+	} else if (fs.existsSync(contextPath)) {
 		console.log(`Context already exists at ${contextPath}`);
 		console.log("Edit it directly or pass content via stdin.");
 	} else {
@@ -372,7 +388,8 @@ commands["load-phase-context"] = function (n) {
 };
 
 // --- create-plan ---
-commands["create-plan"] = function (n, p, ...titleWords) {
+// Supports stdin: echo "content" | draht-tools create-plan N P [title]
+commands["create-plan"] = async function (n, p, ...titleWords) {
 	const phaseNum = parseInt(n, 10);
 	const planNum = parseInt(p, 10);
 	if (!phaseNum || !planNum) { console.error("Usage: draht-tools create-plan N P [title]"); process.exit(1); }
@@ -384,7 +401,24 @@ commands["create-plan"] = function (n, p, ...titleWords) {
 	const title = titleWords.join(" ") || `Plan ${planNum}`;
 	const planPath = path.join(dir, `${padNum(phaseNum)}-${padNum(planNum)}-PLAN.md`);
 
-	const tmpl = `---
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	let content;
+	if (stdinContent) {
+		// Use stdin content directly
+		content = stdinContent;
+	} else {
+		// Generate template
+		content = `---
 phase: ${phaseNum}
 plan: ${planNum}
 depends_on: []
@@ -417,7 +451,9 @@ must_haves:
 ---
 Created: ${timestamp()}
 `;
-	writeMd(planPath, tmpl);
+	}
+
+	writeMd(planPath, content);
 	console.log(`Created: ${planPath}`);
 };
 
@@ -547,7 +583,8 @@ commands["commit-task"] = function (n, p, t, ...desc) {
 };
 
 // --- write-summary ---
-commands["write-summary"] = function (n, p) {
+// Supports stdin: echo "content" | draht-tools write-summary N P
+commands["write-summary"] = async function (n, p) {
 	const phaseNum = parseInt(n, 10);
 	const planNum = parseInt(p, 10);
 	if (!phaseNum || !planNum) { console.error("Usage: draht-tools write-summary N P"); process.exit(1); }
@@ -556,8 +593,26 @@ commands["write-summary"] = function (n, p) {
 	if (!phaseDir) { console.error(`Phase ${phaseNum} not found`); process.exit(1); }
 
 	const summaryPath = path.join(phaseDir, `${padNum(phaseNum)}-${padNum(planNum)}-SUMMARY.md`);
-	const tmpl = `# Phase ${phaseNum}, Plan ${planNum} Summary\n\n## Completed Tasks\n| # | Task | Status | Commit |\n|---|------|--------|--------|\n| 1 | [task] | ✅ Done | [hash] |\n\n## Files Changed\n- [files]\n\n## Verification Results\n- [results]\n\n## Notes\n[deviations, decisions]\n\n---\nCompleted: ${timestamp()}\n`;
-	writeMd(summaryPath, tmpl);
+
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	let content;
+	if (stdinContent) {
+		content = stdinContent;
+	} else {
+		content = `# Phase ${phaseNum}, Plan ${planNum} Summary\n\n## Completed Tasks\n| # | Task | Status | Commit |\n|---|------|--------|--------|\n| 1 | [task] | ✅ Done | [hash] |\n\n## Files Changed\n- [files]\n\n## Verification Results\n- [results]\n\n## Notes\n[deviations, decisions]\n\n---\nCompleted: ${timestamp()}\n`;
+	}
+
+	writeMd(summaryPath, content);
 	console.log(`Created: ${summaryPath}`);
 };
 
@@ -628,17 +683,35 @@ commands["extract-deliverables"] = function (n) {
 };
 
 // --- create-fix-plan ---
-commands["create-fix-plan"] = function (n, p, ...issueWords) {
+// Supports stdin: echo "content" | draht-tools create-fix-plan N P [issue]
+commands["create-fix-plan"] = async function (n, p, ...issueWords) {
 	const phaseNum = parseInt(n, 10);
 	const planNum = parseInt(p, 10);
 	if (!phaseNum || !planNum) { console.error("Usage: draht-tools create-fix-plan N P [issue]"); process.exit(1); }
 
 	const slug = getPhaseSlug(phaseNum) || `phase-${phaseNum}`;
 	const dir = planningPath("phases", `${padNum(phaseNum)}-${slug}`);
+	ensureDir(dir);
 	const issue = issueWords.join(" ") || "Fix identified issues";
 
 	const fixPath = path.join(dir, `${padNum(phaseNum)}-${padNum(planNum)}-FIX-PLAN.md`);
-	const tmpl = `---
+
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	let content;
+	if (stdinContent) {
+		content = stdinContent;
+	} else {
+		content = `---
 gap_closure: true
 fixes_plan: ${planNum}
 issue: "${issue}"
@@ -662,12 +735,15 @@ ${issue}
 ---
 Created: ${timestamp()}
 `;
-	writeMd(fixPath, tmpl);
+	}
+
+	writeMd(fixPath, content);
 	console.log(`Created: ${fixPath}`);
 };
 
 // --- write-uat ---
-commands["write-uat"] = function (n) {
+// Supports stdin: echo "content" | draht-tools write-uat N
+commands["write-uat"] = async function (n) {
 	const num = parseInt(n, 10);
 	if (!num) { console.error("Usage: draht-tools write-uat N"); process.exit(1); }
 
@@ -675,8 +751,26 @@ commands["write-uat"] = function (n) {
 	if (!phaseDir) { console.error(`Phase ${num} not found`); process.exit(1); }
 
 	const uatPath = path.join(phaseDir, `${padNum(num)}-UAT.md`);
-	const tmpl = `# Phase ${num} User Acceptance Testing\n\n## Test Date: ${dateStamp()}\n\n## Results\n| # | Deliverable | Status | Notes |\n|---|-------------|--------|-------|\n| 1 | [description] | ✅ Pass | |\n\n## Summary\n- Passed: X/Y\n- Failed: 0/Y\n- Skipped: 0/Y\n\n## Fix Plans Created\n(none)\n`;
-	writeMd(uatPath, tmpl);
+
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	let content;
+	if (stdinContent) {
+		content = stdinContent;
+	} else {
+		content = `# Phase ${num} User Acceptance Testing\n\n## Test Date: ${dateStamp()}\n\n## Results\n| # | Deliverable | Status | Notes |\n|---|-------------|--------|-------|\n| 1 | [description] | ✅ Pass | |\n\n## Summary\n- Passed: X/Y\n- Failed: 0/Y\n- Skipped: 0/Y\n\n## Fix Plans Created\n(none)\n`;
+	}
+
+	writeMd(uatPath, content);
 	console.log(`Created: ${uatPath}`);
 };
 
@@ -691,7 +785,8 @@ commands["next-quick-number"] = function () {
 };
 
 // --- create-quick-plan ---
-commands["create-quick-plan"] = function (n, ...descWords) {
+// Supports stdin: echo "content" | draht-tools create-quick-plan NNN [desc]
+commands["create-quick-plan"] = async function (n, ...descWords) {
 	const num = padNum(parseInt(n, 10), 3);
 	const desc = descWords.join(" ") || "Quick task";
 	const slug = slugify(desc);
@@ -699,13 +794,34 @@ commands["create-quick-plan"] = function (n, ...descWords) {
 	ensureDir(dir);
 
 	const planPath = path.join(dir, `${num}-PLAN.md`);
-	const tmpl = `# Quick Task ${num}: ${desc}\n\n## Tasks\n\n<task type="auto">\n  <n>[Task]</n>\n  <files>[files]</files>\n  <action>[instructions]</action>\n  <verify>[verify]</verify>\n  <done>[done]</done>\n</task>\n\n---\nCreated: ${timestamp()}\n`;
-	writeMd(planPath, tmpl);
+
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	let content;
+	if (stdinContent) {
+		// Use stdin content directly
+		content = stdinContent;
+	} else {
+		// Generate template
+		content = `# Quick Task ${num}: ${desc}\n\n## Tasks\n\n<task type="auto">\n  <n>[Task]</n>\n  <files>[files]</files>\n  <action>[instructions]</action>\n  <verify>[verify]</verify>\n  <done>[done]</done>\n</task>\n\n---\nCreated: ${timestamp()}\n`;
+	}
+
+	writeMd(planPath, content);
 	console.log(`Created: ${planPath}`);
 };
 
 // --- write-quick-summary ---
-commands["write-quick-summary"] = function (n) {
+// Supports stdin: echo "content" | draht-tools write-quick-summary NNN
+commands["write-quick-summary"] = async function (n) {
 	const num = padNum(parseInt(n, 10), 3);
 	const dir = planningPath("quick");
 	if (!fs.existsSync(dir)) { console.error("No quick tasks directory"); process.exit(1); }
@@ -713,8 +829,26 @@ commands["write-quick-summary"] = function (n) {
 	if (!match) { console.error(`Quick task ${num} not found`); process.exit(1); }
 
 	const summaryPath = path.join(dir, match, `${num}-SUMMARY.md`);
-	const tmpl = `# Quick Task ${num} Summary\n\n## Tasks Completed\n| # | Task | Status | Commit |\n|---|------|--------|--------|\n| 1 | [task] | ✅ Done | [hash] |\n\n## Files Changed\n- [files]\n\n---\nCompleted: ${timestamp()}\n`;
-	writeMd(summaryPath, tmpl);
+
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	let content;
+	if (stdinContent) {
+		content = stdinContent;
+	} else {
+		content = `# Quick Task ${num} Summary\n\n## Tasks Completed\n| # | Task | Status | Commit |\n|---|------|--------|--------|\n| 1 | [task] | ✅ Done | [hash] |\n\n## Files Changed\n- [files]\n\n---\nCompleted: ${timestamp()}\n`;
+	}
+
+	writeMd(summaryPath, content);
 	console.log(`Created: ${summaryPath}`);
 };
 
@@ -826,7 +960,8 @@ commands["commit-docs"] = function (...msg) {
 };
 
 // --- research-phase ---
-commands["research-phase"] = function (n) {
+// Supports stdin: echo "content" | draht-tools research-phase N
+commands["research-phase"] = async function (n) {
 	const num = parseInt(n, 10);
 	if (!num) { console.error("Usage: draht-tools research-phase N"); process.exit(1); }
 
@@ -835,10 +970,28 @@ commands["research-phase"] = function (n) {
 	ensureDir(dir);
 
 	const resPath = path.join(dir, `${padNum(num)}-RESEARCH.md`);
-	const tmpl = `# Phase ${num} Research\n\nGenerated: ${timestamp()}\n\n## Best Practices\n[Fill in]\n\n## Patterns & Anti-Patterns\n[Fill in]\n\n## Library Recommendations\n[Fill in]\n\n## Edge Cases & Gotchas\n[Fill in]\n`;
-	writeMd(resPath, tmpl);
+
+	// Check for stdin content (piped input)
+	let stdinContent = "";
+	if (!process.stdin.isTTY) {
+		stdinContent = await new Promise((resolve) => {
+			let data = "";
+			process.stdin.setEncoding("utf-8");
+			process.stdin.on("data", (chunk) => { data += chunk; });
+			process.stdin.on("end", () => { resolve(data.trim()); });
+		});
+	}
+
+	let content;
+	if (stdinContent) {
+		content = stdinContent;
+	} else {
+		content = `# Phase ${num} Research\n\nGenerated: ${timestamp()}\n\n## Best Practices\n[Fill in]\n\n## Patterns & Anti-Patterns\n[Fill in]\n\n## Library Recommendations\n[Fill in]\n\n## Edge Cases & Gotchas\n[Fill in]\n`;
+	}
+
+	writeMd(resPath, content);
 	console.log(`Created: ${resPath}`);
-	console.log("→ Fill in research findings, then plan the phase.");
+	if (!stdinContent) console.log("→ Fill in research findings, then plan the phase.");
 };
 
 // ============================================================================
@@ -902,11 +1055,13 @@ Version: 1.0.0
 // Dispatch
 const [cmd, ...args] = process.argv.slice(2);
 
-if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
-	commands.help();
-} else if (commands[cmd]) {
-	commands[cmd](...args);
-} else {
-	console.error(`Unknown command: ${cmd}\nRun: draht-tools help`);
-	process.exit(1);
-}
+(async () => {
+	if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+		commands.help();
+	} else if (commands[cmd]) {
+		await commands[cmd](...args);
+	} else {
+		console.error(`Unknown command: ${cmd}\nRun: draht-tools help`);
+		process.exit(1);
+	}
+})();

package/dist/bun/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bun/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nprocess.title = \"draht\";\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nawait import(\"./register-bedrock.js\");\nawait import(\"../cli.js\");\n"]}

package/dist/bun/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+process.title = "draht";
+process.emitWarning = (() => { });
+await import("./register-bedrock.js");
+await import("../cli.js");
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/bun/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":";AACA,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;AACxB,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAA+B,CAAC;AAE/D,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;AACtC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nprocess.title = \"draht\";\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nawait import(\"./register-bedrock.js\");\nawait import(\"../cli.js\");\n"]}

package/dist/bun/register-bedrock.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register-bedrock.d.ts.map

package/dist/bun/register-bedrock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-bedrock.d.ts","sourceRoot":"","sources":["../../src/bun/register-bedrock.ts"],"names":[],"mappings":"","sourcesContent":["import { setBedrockProviderModule } from \"@draht/ai\";\nimport { bedrockProviderModule } from \"@draht/ai/bedrock-provider\";\n\nsetBedrockProviderModule(bedrockProviderModule);\n"]}

package/dist/bun/register-bedrock.js

@@ -0,0 +1,4 @@
+import { setBedrockProviderModule } from "@draht/ai";
+import { bedrockProviderModule } from "@draht/ai/bedrock-provider";
+setBedrockProviderModule(bedrockProviderModule);
+//# sourceMappingURL=register-bedrock.js.map

package/dist/bun/register-bedrock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-bedrock.js","sourceRoot":"","sources":["../../src/bun/register-bedrock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,wBAAwB,CAAC,qBAAqB,CAAC,CAAC","sourcesContent":["import { setBedrockProviderModule } from \"@draht/ai\";\nimport { bedrockProviderModule } from \"@draht/ai/bedrock-provider\";\n\nsetBedrockProviderModule(bedrockProviderModule);\n"]}

package/dist/cli/args.d.ts

@@ -18,6 +18,7 @@ export interface Args {
     mode?: Mode;
     noSession?: boolean;
     session?: string;
+    fork?: string;
     sessionDir?: string;
     models?: string[];
     tools?: ToolName[];