@os-eco/overstory-cli 0.6.4 → 0.6.6

package/src/commands/mail.test.ts

@@ -761,7 +761,7 @@ describe("mailCommand", () => {
 					capability: "coordinator",
 					worktreePath: "/worktrees/orchestrator",
 					branchName: "main",
-					beadId: "bead-001",
+					taskId: "bead-001",
 					tmuxSession: "overstory-test-orchestrator",
 					state: "working" as const,
 					pid: 12345,
@@ -779,7 +779,7 @@ describe("mailCommand", () => {
 					capability: "builder",
 					worktreePath: "/worktrees/builder-1",
 					branchName: "builder-1",
-					beadId: "bead-002",
+					taskId: "bead-002",
 					tmuxSession: "overstory-test-builder-1",
 					state: "working" as const,
 					pid: 12346,
@@ -797,7 +797,7 @@ describe("mailCommand", () => {
 					capability: "builder",
 					worktreePath: "/worktrees/builder-2",
 					branchName: "builder-2",
-					beadId: "bead-003",
+					taskId: "bead-003",
 					tmuxSession: "overstory-test-builder-2",
 					state: "working" as const,
 					pid: 12347,
@@ -815,7 +815,7 @@ describe("mailCommand", () => {
 					capability: "scout",
 					worktreePath: "/worktrees/scout-1",
 					branchName: "scout-1",
-					beadId: "bead-004",
+					taskId: "bead-004",
 					tmuxSession: "overstory-test-scout-1",
 					state: "working" as const,
 					pid: 12348,
@@ -1135,7 +1135,7 @@ describe("mailCommand", () => {
 						| "monitor",
 					worktreePath: `/worktrees/${session.agentName}`,
 					branchName: session.agentName,
-					beadId: `bead-${idx}`,
+					taskId: `bead-${idx}`,
 					tmuxSession: `overstory-test-${session.agentName}`,
 					state: "working" as const,
 					pid: 10000 + idx,
@@ -1175,7 +1175,7 @@ describe("mailCommand", () => {
 			]);
 
 			// Verify warning on stderr
-			expect(stderrOutput).toContain("WARNING");
+			expect(stderrOutput).toContain("Warning:");
 			expect(stderrOutput).toContain("NO reviewer sessions found");
 			expect(stderrOutput).toContain("lead-1");
 			expect(stderrOutput).toContain("2 builder(s)");
@@ -1208,7 +1208,7 @@ describe("mailCommand", () => {
 			]);
 
 			// Verify note on stderr
-			expect(stderrOutput).toContain("NOTE");
+			expect(stderrOutput).toContain("Note:");
 			expect(stderrOutput).toContain("Only 1 reviewer(s) for 3 builder(s)");
 			expect(stderrOutput).toContain("review-verified");
 		});

package/src/commands/mail.ts

@@ -373,7 +373,7 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 				);
 			} else {
 				process.stdout.write(
-					`📢 Broadcast sent to ${recipients.length} recipient${recipients.length === 1 ? "" : "s"} (${to})\n`,
+					`Broadcast sent to ${recipients.length} recipient${recipients.length === 1 ? "" : "s"} (${to})\n`,
 				);
 				for (let i = 0; i < recipients.length; i++) {
 					const recipient = recipients[i];
@@ -429,7 +429,7 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 		if (opts.json) {
 			process.stdout.write(`${JSON.stringify({ id })}\n`);
 		} else {
-			process.stdout.write(`✉️  Sent message ${id} to ${to}\n`);
+			process.stdout.write(`Sent message ${id} to ${to}\n`);
 		}
 
 		// Auto-nudge: write a pending nudge marker instead of sending tmux keys.
@@ -449,11 +449,28 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 			});
 			if (!opts.json) {
 				process.stdout.write(
-					`📢 Queued nudge for "${to}" (${nudgeReason}, delivered on next prompt)\n`,
+					`Queued nudge for "${to}" (${nudgeReason}, delivered on next prompt)\n`,
 				);
 			}
 		}
 
+		// For dispatch messages, also send an immediate tmux nudge.
+		// Dispatch targets newly spawned agents that may be idle at the welcome
+		// screen where file-based nudges can't reach (no hook fires on idle agents).
+		// The I/O corruption concern (overstory-ii1o) only applies during active
+		// tool execution — newly spawned agents are idle, so sendKeys is safe.
+		if (type === "dispatch") {
+			try {
+				const { nudgeAgent } = await import("./nudge.ts");
+				const nudgeMessage = `[DISPATCH] ${subject}: ${body.slice(0, 500)}`;
+				// Small delay to let the agent's TUI stabilize after sling
+				await Bun.sleep(3_000);
+				await nudgeAgent(cwd, to, nudgeMessage, true); // force=true to skip debounce
+			} catch {
+				// Non-fatal: the file-based nudge is the fallback
+			}
+		}
+
 		// Reviewer coverage check for merge_ready (advisory warning)
 		if (type === "merge_ready") {
 			try {
@@ -469,13 +486,13 @@ async function handleSend(opts: SendOpts, cwd: string): Promise<void> {
 					);
 					if (myBuilders.length > 0 && myReviewers.length === 0) {
 						process.stderr.write(
-							`\n⚠️  WARNING: merge_ready sent but NO reviewer sessions found for "${from}".\n` +
-								`⚠️  ${myBuilders.length} builder(s) completed without review. This violates the review-before-merge requirement.\n` +
-								`⚠️  Spawn reviewers for each builder before merge. See REVIEW_SKIP in agents/lead.md.\n\n`,
+							`\nWarning: merge_ready sent but NO reviewer sessions found for "${from}".\n` +
+								`${myBuilders.length} builder(s) completed without review. This violates the review-before-merge requirement.\n` +
+								`Spawn reviewers for each builder before merge. See REVIEW_SKIP in agents/lead.md.\n\n`,
 						);
 					} else if (myReviewers.length > 0 && myReviewers.length < myBuilders.length) {
 						process.stderr.write(
-							`\n⚠️  NOTE: Only ${myReviewers.length} reviewer(s) for ${myBuilders.length} builder(s). Ensure all builder work is review-verified.\n\n`,
+							`\nNote: Only ${myReviewers.length} reviewer(s) for ${myBuilders.length} builder(s). Ensure all builder work is review-verified.\n\n`,
 						);
 					}
 				} finally {
@@ -528,7 +545,7 @@ async function handleCheck(opts: CheckOpts, cwd: string): Promise<void> {
 
 			// Prepend a priority banner if there's a pending nudge
 			if (pendingNudge) {
-				const banner = `🚨 PRIORITY: ${pendingNudge.reason} message from ${pendingNudge.from} — "${pendingNudge.subject}"\n\n`;
+				const banner = `PRIORITY: ${pendingNudge.reason} message from ${pendingNudge.from} — "${pendingNudge.subject}"\n\n`;
 				process.stdout.write(banner);
 			}
 
@@ -544,7 +561,7 @@ async function handleCheck(opts: CheckOpts, cwd: string): Promise<void> {
 				process.stdout.write("No new messages.\n");
 			} else {
 				process.stdout.write(
-					`📬 ${messages.length} new message${messages.length === 1 ? "" : "s"}:\n\n`,
+					`${messages.length} new message${messages.length === 1 ? "" : "s"}:\n\n`,
 				);
 				for (const msg of messages) {
 					process.stdout.write(`${formatMessage(msg)}\n\n`);
@@ -617,7 +634,7 @@ function handleReply(id: string, opts: ReplyOpts, cwd: string): void {
 		if (opts.json) {
 			process.stdout.write(`${JSON.stringify({ id: replyId })}\n`);
 		} else {
-			process.stdout.write(`✉️  Reply sent: ${replyId}\n`);
+			process.stdout.write(`Reply sent: ${replyId}\n`);
 		}
 	} finally {
 		client.close();
@@ -677,7 +694,7 @@ export async function mailCommand(args: string[]): Promise<void> {
 	const root = await resolveProjectRoot(process.cwd());
 
 	const program = new Command();
-	program.name("overstory mail").description("Agent messaging system").exitOverride();
+	program.name("ov mail").description("Agent messaging system").exitOverride();
 
 	program
 		.command("send")

package/src/commands/merge.test.ts

@@ -207,7 +207,7 @@ merge:
 
 			const parsed = JSON.parse(output);
 			expect(parsed.agentName).toBe("my-builder");
-			expect(parsed.beadId).toBe("bead-xyz");
+			expect(parsed.taskId).toBe("bead-xyz");
 		});
 	});
 
@@ -264,13 +264,13 @@ merge:
 			const queue = createMergeQueue(queuePath);
 			queue.enqueue({
 				branchName: branch1,
-				beadId: "bead-001",
+				taskId: "bead-001",
 				agentName: "agent1",
 				filesModified: [`src/${branch1}.ts`],
 			});
 			queue.enqueue({
 				branchName: branch2,
-				beadId: "bead-002",
+				taskId: "bead-002",
 				agentName: "agent2",
 				filesModified: [`src/${branch2}.ts`],
 			});
@@ -306,13 +306,13 @@ merge:
 			const queue = createMergeQueue(queuePath);
 			queue.enqueue({
 				branchName: branch1,
-				beadId: "bead-100",
+				taskId: "bead-100",
 				agentName: "builder1",
 				filesModified: [`src/${branch1}.ts`],
 			});
 			queue.enqueue({
 				branchName: branch2,
-				beadId: "bead-200",
+				taskId: "bead-200",
 				agentName: "builder2",
 				filesModified: [`src/${branch2}.ts`],
 			});
@@ -351,7 +351,7 @@ merge:
 			const queue = createMergeQueue(queuePath);
 			queue.enqueue({
 				branchName: branch1,
-				beadId: "bead-300",
+				taskId: "bead-300",
 				agentName: "builder3",
 				filesModified: [`src/${branch1}.ts`],
 			});
@@ -449,13 +449,13 @@ merge:
 			const queue = createMergeQueue(queuePath);
 			queue.enqueue({
 				branchName: branch1,
-				beadId: "bead-into-all-1",
+				taskId: "bead-into-all-1",
 				agentName: "agent1",
 				filesModified: [`src/${branch1}.ts`],
 			});
 			queue.enqueue({
 				branchName: branch2,
-				beadId: "bead-into-all-2",
+				taskId: "bead-into-all-2",
 				agentName: "agent2",
 				filesModified: [`src/${branch2}.ts`],
 			});

package/src/commands/merge.ts

@@ -1,14 +1,14 @@
 /**
- * CLI command: overstory merge
+ * CLI command: ov merge
  *
  * Merges agent branches back to the canonical branch using
  * the merge queue and tiered conflict resolver.
  *
  * Usage:
- *   overstory merge --branch <name>   Merge a specific branch
- *   overstory merge --all             Merge all pending branches
- *   overstory merge --dry-run         Check for conflicts without merging
- *   overstory merge --json            Output results as JSON
+ *   ov merge --branch <name>   Merge a specific branch
+ *   ov merge --all             Merge all pending branches
+ *   ov merge --dry-run         Check for conflicts without merging
+ *   ov merge --json            Output results as JSON
  */
 
 import { join } from "node:path";
@@ -29,7 +29,7 @@ export interface MergeOptions {
 
 /**
  * Extract agent name from a branch following the overstory naming convention.
- * Pattern: overstory/{agentName}/{beadId}
+ * Pattern: overstory/{agentName}/{taskId}
  * Falls back to "unknown" if the pattern does not match.
  */
 function parseAgentName(branchName: string): string {
@@ -41,8 +41,8 @@ function parseAgentName(branchName: string): string {
 }
 
 /**
- * Extract bead ID from a branch following the overstory naming convention.
- * Pattern: overstory/{agentName}/{beadId}
+ * Extract task ID from a branch following the overstory naming convention.
+ * Pattern: overstory/{agentName}/{taskId}
  * Falls back to "unknown" if the pattern does not match.
  */
 function parseBeadId(branchName: string): string {
@@ -89,7 +89,7 @@ function formatResult(result: MergeResult): string {
 	const statusIcon = result.success ? "Merged" : "Failed";
 	const lines: string[] = [
 		`Merging branch: ${result.entry.branchName}`,
-		`   Agent: ${result.entry.agentName} | Task: ${result.entry.beadId}`,
+		`   Agent: ${result.entry.agentName} | Task: ${result.entry.taskId}`,
 		`   Files: ${result.entry.filesModified.length} modified`,
 		`   Result: ${statusIcon} (tier: ${result.tier})`,
 	];
@@ -109,7 +109,7 @@ function formatResult(result: MergeResult): string {
 function formatDryRun(entry: MergeEntry): string {
 	const lines: string[] = [
 		`[dry-run] Branch: ${entry.branchName}`,
-		`   Agent: ${entry.agentName} | Task: ${entry.beadId}`,
+		`   Agent: ${entry.agentName} | Task: ${entry.taskId}`,
 		`   Status: ${entry.status}`,
 		`   Files: ${entry.filesModified.length} modified`,
 	];
@@ -124,7 +124,7 @@ function formatDryRun(entry: MergeEntry): string {
 }
 
 /**
- * Entry point for `overstory merge [flags]`.
+ * Entry point for `ov merge [flags]`.
  *
  * @param opts - Command options
  */
@@ -136,7 +136,7 @@ export async function mergeCommand(opts: MergeOptions): Promise<void> {
 	const json = opts.json ?? false;
 
 	if (!branchName && !all) {
-		throw new ValidationError("Either --branch <name> or --all is required for overstory merge", {
+		throw new ValidationError("Either --branch <name> or --all is required for ov merge", {
 			field: "branch|all",
 		});
 	}
@@ -176,7 +176,7 @@ export async function mergeCommand(opts: MergeOptions): Promise<void> {
 /**
  * Handle merging a specific branch.
  * If the branch is not in the queue, creates a new entry by detecting
- * agent name, bead ID, and modified files from git.
+ * agent name, task ID, and modified files from git.
  */
 async function handleBranch(
 	branchName: string,
@@ -211,12 +211,12 @@ async function handleBranch(
 		}
 
 		const agentName = parseAgentName(branchName);
-		const beadId = parseBeadId(branchName);
+		const taskId = parseBeadId(branchName);
 		const filesModified = await detectModifiedFiles(repoRoot, canonicalBranch, branchName);
 
 		entry = queue.enqueue({
 			branchName,
-			beadId,
+			taskId,
 			agentName,
 			filesModified,
 		});

package/src/commands/metrics.test.ts

@@ -54,7 +54,7 @@ describe("metricsCommand", () => {
 	function makeSession(overrides: Partial<SessionMetrics> = {}): SessionMetrics {
 		return {
 			agentName: "test-agent",
-			beadId: "bead-001",
+			taskId: "bead-001",
 			capability: "builder",
 			startedAt: new Date(Date.now() - 120_000).toISOString(),
 			completedAt: new Date().toISOString(),
@@ -151,7 +151,7 @@ describe("metricsCommand", () => {
 		const out = output();
 
 		// Check summary stats
-		expect(out).toContain("📈 Session Metrics");
+		expect(out).toContain("Session Metrics");
 		expect(out).toContain("Total sessions: 3");
 		expect(out).toContain("Completed: 2");
 		expect(out).toContain("Avg duration:");
@@ -177,7 +177,7 @@ describe("metricsCommand", () => {
 		store.recordSession(
 			makeSession({
 				agentName: "test-builder",
-				beadId: "bead-123",
+				taskId: "bead-123",
 				capability: "builder",
 			}),
 		);
@@ -190,7 +190,7 @@ describe("metricsCommand", () => {
 		const parsed = JSON.parse(out.trim()) as { sessions: SessionMetrics[] };
 		expect(parsed.sessions).toHaveLength(1);
 		expect(parsed.sessions[0]?.agentName).toBe("test-builder");
-		expect(parsed.sessions[0]?.beadId).toBe("bead-123");
+		expect(parsed.sessions[0]?.taskId).toBe("bead-123");
 		expect(parsed.sessions[0]?.capability).toBe("builder");
 	});
 
@@ -203,7 +203,7 @@ describe("metricsCommand", () => {
 			store.recordSession(
 				makeSession({
 					agentName: `agent-${i}`,
-					beadId: `bead-${i}`,
+					taskId: `bead-${i}`,
 					startedAt: new Date(Date.now() - (5 - i) * 1000).toISOString(),
 				}),
 			);
@@ -227,7 +227,7 @@ describe("metricsCommand", () => {
 			store.recordSession(
 				makeSession({
 					agentName: `agent-${i}`,
-					beadId: `bead-${i}`,
+					taskId: `bead-${i}`,
 				}),
 			);
 		}
@@ -363,7 +363,7 @@ describe("formatDuration helper", () => {
 	function makeSession(durationMs: number): SessionMetrics {
 		return {
 			agentName: "test-agent",
-			beadId: "bead-001",
+			taskId: "bead-001",
 			capability: "builder",
 			startedAt: new Date(Date.now() - durationMs).toISOString(),
 			completedAt: new Date().toISOString(),

package/src/commands/metrics.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory metrics [--last <n>] [--json]
+ * CLI command: ov metrics [--last <n>] [--json]
  *
  * Shows metrics summary from SQLite store: session durations, success rates,
  * merge tier distribution, agent utilization.
@@ -63,7 +63,7 @@ async function executeMetrics(opts: MetricsOpts): Promise<void> {
 			return;
 		}
 
-		process.stdout.write("📈 Session Metrics\n");
+		process.stdout.write("Session Metrics\n");
 		process.stdout.write(`${"═".repeat(60)}\n\n`);
 
 		// Summary stats
@@ -107,7 +107,7 @@ async function executeMetrics(opts: MetricsOpts): Promise<void> {
 			const status = s.completedAt ? "done" : "running";
 			const duration = formatDuration(s.durationMs);
 			process.stdout.write(
-				`  ${s.agentName} [${s.capability}] ${s.beadId} | ${status} | ${duration}\n`,
+				`  ${s.agentName} [${s.capability}] ${s.taskId} | ${status} | ${duration}\n`,
 			);
 		}
 	} finally {

package/src/commands/monitor.test.ts

@@ -39,14 +39,14 @@ describe("buildMonitorBeacon", () => {
 		expect(beacon).toContain("mulch prime");
 	});
 
-	test("contains startup instruction: overstory status --json", () => {
+	test("contains startup instruction: ov status --json", () => {
 		const beacon = buildMonitorBeacon();
-		expect(beacon).toContain("overstory status --json");
+		expect(beacon).toContain("ov status --json");
 	});
 
-	test("contains startup instruction: overstory mail check --agent monitor", () => {
+	test("contains startup instruction: ov mail check --agent monitor", () => {
 		const beacon = buildMonitorBeacon();
-		expect(beacon).toContain("overstory mail check --agent monitor");
+		expect(beacon).toContain("ov mail check --agent monitor");
 	});
 
 	test("contains startup instruction: patrol loop", () => {
@@ -86,7 +86,7 @@ describe("monitorCommand", () => {
 		stdoutSpy.mockRestore();
 	});
 
-	test("--help prints help text containing 'overstory monitor'", async () => {
+	test("--help prints help text containing 'monitor'", async () => {
 		await monitorCommand(["--help"]);
 		const output = stdoutWrites.join("");
 		expect(output).toContain("monitor");

package/src/commands/monitor.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory monitor start|stop|status
+ * CLI command: ov monitor start|stop|status
  *
  * Manages the persistent Tier 2 monitor agent lifecycle. The monitor runs
  * at the project root (NOT in a worktree), continuously patrols the agent
@@ -9,7 +9,7 @@
  * Unlike regular agents spawned by sling, the monitor:
  * - Has no worktree (operates on the main working tree)
  * - Has no bead assignment (it monitors, not implements)
- * - Has no overlay CLAUDE.md (context comes via overstory status + mail)
+ * - Has no overlay CLAUDE.md (context comes via ov status + mail)
  * - Persists across patrol cycles
  */
 
@@ -46,7 +46,7 @@ export function buildMonitorBeacon(): string {
 	const parts = [
 		`[OVERSTORY] ${MONITOR_NAME} (monitor/tier-2) ${timestamp}`,
 		"Depth: 0 | Parent: none | Role: continuous fleet patrol",
-		`Startup: run mulch prime, check fleet (overstory status --json), check mail (overstory mail check --agent ${MONITOR_NAME}), then begin patrol loop`,
+		`Startup: run mulch prime, check fleet (ov status --json), check mail (ov mail check --agent ${MONITOR_NAME}), then begin patrol loop`,
 	];
 	return parts.join(" — ");
 }
@@ -156,7 +156,7 @@ async function startMonitor(opts: { json: boolean; attach: boolean }): Promise<v
 			capability: "monitor",
 			worktreePath: projectRoot, // Monitor uses project root, not a worktree
 			branchName: config.project.canonicalBranch, // Operates on canonical branch
-			beadId: "", // No specific bead assignment
+			taskId: "", // No specific bead assignment
 			tmuxSession,
 			state: "booting",
 			pid,
@@ -356,7 +356,7 @@ export function createMonitorCommand(): Command {
 }
 
 /**
- * Entry point for `overstory monitor <subcommand>`.
+ * Entry point for `ov monitor <subcommand>`.
  */
 export async function monitorCommand(args: string[]): Promise<void> {
 	const cmd = createMonitorCommand();

package/src/commands/nudge.test.ts

@@ -46,7 +46,7 @@ function makeSession(overrides: Partial<AgentSession> = {}): AgentSession {
 		capability: "builder",
 		worktreePath: "/tmp/wt",
 		branchName: "overstory/test-agent/task-1",
-		beadId: "task-1",
+		taskId: "task-1",
 		tmuxSession: "overstory-test-agent",
 		state: "working",
 		pid: 12345,

package/src/commands/nudge.ts

@@ -283,7 +283,7 @@ export async function nudgeAgent(
 export async function nudgeCommand(args: string[]): Promise<void> {
 	const program = new Command();
 	program
-		.name("overstory nudge")
+		.name("ov nudge")
 		.description("Send a text nudge to an agent")
 		.argument("<agent-name>", "Name of the agent to nudge")
 		.argument("[message...]", "Text to send (default: check mail prompt)")

package/src/commands/prime.test.ts

@@ -134,7 +134,7 @@ expertiseDomains:
   - typescript
   - testing
 recentTasks:
-  - beadId: task-001
+  - taskId: task-001
     summary: "Implemented feature X"
     completedAt: "2026-01-10T12:00:00Z"
 `,
@@ -161,7 +161,7 @@ recentTasks:
 					capability: "builder",
 					worktreePath: join(tempDir, ".overstory", "worktrees", "active-builder"),
 					branchName: "overstory/active-builder/task-001",
-					beadId: "task-001",
+					taskId: "task-001",
 					tmuxSession: "overstory-active-builder",
 					state: "working",
 					pid: 12345,
@@ -198,7 +198,7 @@ recentTasks:
 					capability: "builder",
 					worktreePath: join(tempDir, ".overstory", "worktrees", "completed-builder"),
 					branchName: "overstory/completed-builder/task-002",
-					beadId: "task-002",
+					taskId: "task-002",
 					tmuxSession: "overstory-completed-builder",
 					state: "completed",
 					pid: null,
@@ -233,7 +233,7 @@ recentTasks:
 				`${JSON.stringify(
 					{
 						agentName: "recovery-agent",
-						beadId: "task-003",
+						taskId: "task-003",
 						sessionId: "session-003",
 						timestamp: new Date().toISOString(),
 						progressSummary: "Implemented initial tests for prime command",
@@ -361,7 +361,7 @@ recentTasks: []
 
 	describe("Gitignore auto-heal", () => {
 		const expectedGitignore = `# Wildcard+whitelist: ignore everything, whitelist tracked files
-# Auto-healed by overstory prime on each session start
+# Auto-healed by ov prime on each session start
 *
 !.gitignore
 !config.yaml

package/src/commands/prime.ts

@@ -1,5 +1,5 @@
 /**
- * `overstory prime` command.
+ * `ov prime` command.
  *
  * Loads context for the orchestrator or a specific agent and outputs it
  * to stdout for injection into Claude Code's context via hooks.
@@ -24,7 +24,7 @@ import { getCurrentSessionName } from "../worktree/tmux.ts";
  * Wildcard+whitelist pattern: ignore everything except tracked config files.
  */
 const OVERSTORY_GITIGNORE = `# Wildcard+whitelist: ignore everything, whitelist tracked files
-# Auto-healed by overstory prime on each session start
+# Auto-healed by ov prime on each session start
 *
 !.gitignore
 !config.yaml
@@ -65,7 +65,7 @@ function formatMetrics(sessions: SessionMetrics[]): string {
 		const status = s.completedAt !== null ? "completed" : "in-progress";
 		const duration = s.durationMs > 0 ? ` (${Math.round(s.durationMs / 1000)}s)` : "";
 		const merge = s.mergeResult !== null ? ` [${s.mergeResult}]` : "";
-		lines.push(`- ${s.agentName} (${s.capability}): ${s.beadId} — ${status}${duration}${merge}`);
+		lines.push(`- ${s.agentName} (${s.capability}): ${s.taskId} — ${status}${duration}${merge}`);
 	}
 	return lines.join("\n");
 }
@@ -86,7 +86,7 @@ function formatIdentity(identity: AgentIdentity): string {
 	if (identity.recentTasks.length > 0) {
 		lines.push("Recent tasks:");
 		for (const task of identity.recentTasks) {
-			lines.push(`  - ${task.beadId}: ${task.summary} (${task.completedAt})`);
+			lines.push(`  - ${task.taskId}: ${task.summary} (${task.completedAt})`);
 		}
 	}
 
@@ -184,7 +184,7 @@ async function outputAgentContext(
 	const overstoryDir = join(config.project.root, ".overstory");
 	const { store } = openSessionStore(overstoryDir);
 	let sessionExists = false;
-	let boundSession: { beadId: string } | null = null;
+	let boundSession: { taskId: string } | null = null;
 	try {
 		const agentSession = store.getByName(agentName);
 		sessionExists = agentSession !== null;
@@ -192,9 +192,9 @@ async function outputAgentContext(
 			agentSession &&
 			agentSession.state !== "completed" &&
 			agentSession.state !== "zombie" &&
-			agentSession.beadId
+			agentSession.taskId
 		) {
-			boundSession = { beadId: agentSession.beadId };
+			boundSession = { taskId: agentSession.taskId };
 		}
 	} finally {
 		store.close();
@@ -226,7 +226,7 @@ async function outputAgentContext(
 	// Activation context: if agent has a bound task, inject it
 	if (boundSession) {
 		sections.push("\n## Activation");
-		sections.push(`You have a bound task: **${boundSession.beadId}**`);
+		sections.push(`You have a bound task: **${boundSession.taskId}**`);
 		sections.push("Read your overlay at `.claude/CLAUDE.md` and begin working immediately.");
 		sections.push("Do not wait for dispatch mail. Your assignment was bound at spawn time.");
 	}

package/src/commands/replay.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory replay [--run <id>] [--agent <name>...] [--json]
+ * CLI command: ov replay [--run <id>] [--agent <name>...] [--json]
  *              [--since <ts>] [--until <ts>] [--limit <n>]
  *
  * Shows an interleaved chronological replay of events across multiple agents.

package/src/commands/run.test.ts

@@ -68,7 +68,7 @@ function makeSession(overrides: Partial<AgentSession> = {}): AgentSession {
 		capability: "builder",
 		worktreePath: "/tmp/worktrees/test-agent",
 		branchName: "overstory/test-agent/task-1",
-		beadId: "task-1",
+		taskId: "task-1",
 		tmuxSession: "overstory-test-agent",
 		state: "working",
 		pid: 12345,

package/src/commands/run.ts

@@ -354,13 +354,13 @@ export function createRunCommand(): Command {
 }
 
 export async function runCommand(args: string[]): Promise<void> {
-	const program = new Command("overstory").exitOverride().configureOutput({
+	const program = new Command("ov").exitOverride().configureOutput({
 		writeOut: (str) => process.stdout.write(str),
 		writeErr: (str) => process.stderr.write(str),
 	});
 	program.addCommand(createRunCommand());
 	try {
-		await program.parseAsync(["node", "overstory", "run", ...args]);
+		await program.parseAsync(["node", "ov", "run", ...args]);
 	} catch (err: unknown) {
 		if (err instanceof CommanderError) {
 			if (err.code === "commander.helpDisplayed" || err.code === "commander.version") return;