@os-eco/overstory-cli 0.6.4 → 0.6.6

package/src/commands/costs.test.ts

@@ -22,7 +22,7 @@ import { costsCommand } from "./costs.ts";
 function makeMetrics(overrides: Partial<SessionMetrics> = {}): SessionMetrics {
 	return {
 		agentName: "builder-1",
-		beadId: "task-001",
+		taskId: "task-001",
 		capability: "builder",
 		startedAt: new Date().toISOString(),
 		completedAt: new Date().toISOString(),
@@ -142,8 +142,8 @@ describe("costsCommand", () => {
 		test("outputs valid JSON array with sessions", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1" }));
-			store.recordSession(makeMetrics({ agentName: "scout-1", beadId: "t2", capability: "scout" }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1" }));
+			store.recordSession(makeMetrics({ agentName: "scout-1", taskId: "t2", capability: "scout" }));
 			store.close();
 
 			await costsCommand(["--json"]);
@@ -160,7 +160,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					inputTokens: 100,
 					outputTokens: 50,
 					cacheReadTokens: 30,
@@ -187,7 +187,7 @@ describe("costsCommand", () => {
 		test("JSON output returns empty array when no sessions match", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1" }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1" }));
 			store.close();
 
 			await costsCommand(["--json", "--agent", "nonexistent"]);
@@ -203,7 +203,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					capability: "builder",
 					inputTokens: 100,
 				}),
@@ -211,7 +211,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "scout-1",
-					beadId: "t2",
+					taskId: "t2",
 					capability: "scout",
 					inputTokens: 50,
 				}),
@@ -238,7 +238,7 @@ describe("costsCommand", () => {
 		test("shows Cost Summary header", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1" }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1" }));
 			store.close();
 
 			await costsCommand([]);
@@ -250,7 +250,7 @@ describe("costsCommand", () => {
 		test("shows column headers", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1" }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1" }));
 			store.close();
 
 			await costsCommand([]);
@@ -270,7 +270,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					capability: "builder",
 				}),
 			);
@@ -286,7 +286,7 @@ describe("costsCommand", () => {
 		test("shows separator line", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1" }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1" }));
 			store.close();
 
 			await costsCommand([]);
@@ -298,7 +298,7 @@ describe("costsCommand", () => {
 		test("shows Total row", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1" }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1" }));
 			store.close();
 
 			await costsCommand([]);
@@ -329,7 +329,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					inputTokens: 12345,
 					outputTokens: 5678,
 				}),
@@ -349,7 +349,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					estimatedCostUsd: 0.42,
 				}),
 			);
@@ -367,7 +367,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					inputTokens: 0,
 					outputTokens: 0,
 					cacheReadTokens: 0,
@@ -389,7 +389,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					estimatedCostUsd: null,
 				}),
 			);
@@ -408,8 +408,8 @@ describe("costsCommand", () => {
 		test("filters sessions by agent name", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1", inputTokens: 100 }));
-			store.recordSession(makeMetrics({ agentName: "scout-1", beadId: "t2", inputTokens: 200 }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1", inputTokens: 100 }));
+			store.recordSession(makeMetrics({ agentName: "scout-1", taskId: "t2", inputTokens: 200 }));
 			store.close();
 
 			await costsCommand(["--json", "--agent", "builder-1"]);
@@ -423,7 +423,7 @@ describe("costsCommand", () => {
 		test("returns empty for non-existent agent", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "builder-1", beadId: "t1" }));
+			store.recordSession(makeMetrics({ agentName: "builder-1", taskId: "t1" }));
 			store.close();
 
 			await costsCommand(["--json", "--agent", "nonexistent"]);
@@ -441,12 +441,12 @@ describe("costsCommand", () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
 			store.recordSession(
-				makeMetrics({ agentName: "builder-1", beadId: "task-001", runId: "run-2026-01-01" }),
+				makeMetrics({ agentName: "builder-1", taskId: "task-001", runId: "run-2026-01-01" }),
 			);
 			store.recordSession(
 				makeMetrics({
 					agentName: "scout-1",
-					beadId: "task-002",
+					taskId: "task-002",
 					capability: "scout",
 					runId: "run-other",
 				}),
@@ -465,7 +465,7 @@ describe("costsCommand", () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
 			store.recordSession(
-				makeMetrics({ agentName: "builder-1", beadId: "t1", runId: "run-2026-01-01" }),
+				makeMetrics({ agentName: "builder-1", taskId: "t1", runId: "run-2026-01-01" }),
 			);
 			store.close();
 
@@ -484,7 +484,7 @@ describe("costsCommand", () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
 			store.recordSession(
-				makeMetrics({ agentName: "builder-1", beadId: "t1", capability: "builder" }),
+				makeMetrics({ agentName: "builder-1", taskId: "t1", capability: "builder" }),
 			);
 			store.close();
 
@@ -498,7 +498,7 @@ describe("costsCommand", () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
 			store.recordSession(
-				makeMetrics({ agentName: "builder-1", beadId: "t1", capability: "builder" }),
+				makeMetrics({ agentName: "builder-1", taskId: "t1", capability: "builder" }),
 			);
 			store.close();
 
@@ -514,7 +514,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					capability: "builder",
 					inputTokens: 1000,
 				}),
@@ -522,7 +522,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-2",
-					beadId: "t2",
+					taskId: "t2",
 					capability: "builder",
 					inputTokens: 2000,
 				}),
@@ -530,7 +530,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "scout-1",
-					beadId: "t3",
+					taskId: "t3",
 					capability: "scout",
 					inputTokens: 500,
 				}),
@@ -548,10 +548,10 @@ describe("costsCommand", () => {
 		test("shows correct session count per capability", async () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
-			store.recordSession(makeMetrics({ agentName: "b1", beadId: "t1", capability: "builder" }));
-			store.recordSession(makeMetrics({ agentName: "b2", beadId: "t2", capability: "builder" }));
-			store.recordSession(makeMetrics({ agentName: "b3", beadId: "t3", capability: "builder" }));
-			store.recordSession(makeMetrics({ agentName: "s1", beadId: "t4", capability: "scout" }));
+			store.recordSession(makeMetrics({ agentName: "b1", taskId: "t1", capability: "builder" }));
+			store.recordSession(makeMetrics({ agentName: "b2", taskId: "t2", capability: "builder" }));
+			store.recordSession(makeMetrics({ agentName: "b3", taskId: "t3", capability: "builder" }));
+			store.recordSession(makeMetrics({ agentName: "s1", taskId: "t4", capability: "scout" }));
 			store.close();
 
 			await costsCommand(["--json", "--by-capability"]);
@@ -584,7 +584,7 @@ describe("costsCommand", () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
 			for (let i = 0; i < 10; i++) {
-				store.recordSession(makeMetrics({ agentName: `agent-${i}`, beadId: `t-${i}` }));
+				store.recordSession(makeMetrics({ agentName: `agent-${i}`, taskId: `t-${i}` }));
 			}
 			store.close();
 
@@ -599,7 +599,7 @@ describe("costsCommand", () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
 			for (let i = 0; i < 25; i++) {
-				store.recordSession(makeMetrics({ agentName: `agent-${i}`, beadId: `t-${i}` }));
+				store.recordSession(makeMetrics({ agentName: `agent-${i}`, taskId: `t-${i}` }));
 			}
 			store.close();
 
@@ -620,7 +620,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					inputTokens: 0,
 					outputTokens: 0,
 					cacheReadTokens: 0,
@@ -644,7 +644,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					estimatedCostUsd: null,
 				}),
 			);
@@ -664,7 +664,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					cacheReadTokens: 8000,
 					cacheCreationTokens: 901,
 				}),
@@ -684,7 +684,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "builder-1",
-					beadId: "t1",
+					taskId: "t1",
 					inputTokens: 100,
 					outputTokens: 50,
 					estimatedCostUsd: 0.1,
@@ -693,7 +693,7 @@ describe("costsCommand", () => {
 			store.recordSession(
 				makeMetrics({
 					agentName: "scout-1",
-					beadId: "t2",
+					taskId: "t2",
 					capability: "scout",
 					inputTokens: 200,
 					outputTokens: 100,
@@ -716,10 +716,10 @@ describe("costsCommand", () => {
 			const dbPath = join(tempDir, ".overstory", "metrics.db");
 			const store = createMetricsStore(dbPath);
 			store.recordSession(
-				makeMetrics({ agentName: "builder-1", beadId: "t1", capability: "builder" }),
+				makeMetrics({ agentName: "builder-1", taskId: "t1", capability: "builder" }),
 			);
 			store.recordSession(
-				makeMetrics({ agentName: "builder-2", beadId: "t2", capability: "builder" }),
+				makeMetrics({ agentName: "builder-2", taskId: "t2", capability: "builder" }),
 			);
 			store.close();
 
@@ -759,7 +759,7 @@ describe("costsCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
-				beadId: "task-001",
+				taskId: "task-001",
 				tmuxSession: "tmux-001",
 				state: "working",
 				pid: 12345,
@@ -815,7 +815,7 @@ describe("costsCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
-				beadId: "task-001",
+				taskId: "task-001",
 				tmuxSession: "tmux-001",
 				state: "working",
 				pid: 12345,
@@ -879,7 +879,7 @@ describe("costsCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
-				beadId: "task-001",
+				taskId: "task-001",
 				tmuxSession: "tmux-001",
 				state: "working",
 				pid: 12345,
@@ -897,7 +897,7 @@ describe("costsCommand", () => {
 				capability: "scout",
 				worktreePath: "/tmp/wt2",
 				branchName: "feat/task2",
-				beadId: "task-002",
+				taskId: "task-002",
 				tmuxSession: "tmux-002",
 				state: "working",
 				pid: 12346,
@@ -956,7 +956,7 @@ describe("costsCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
-				beadId: "task-001",
+				taskId: "task-001",
 				tmuxSession: "tmux-001",
 				state: "working",
 				pid: 12345,

package/src/commands/costs.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory costs [--agent <name>] [--run <id>] [--by-capability] [--last <n>] [--self] [--json]
+ * CLI command: ov costs [--agent <name>] [--run <id>] [--by-capability] [--last <n>] [--self] [--json]
  *
  * Shows token/cost analysis and breakdown for agent sessions.
  * Data source: metrics.db via createMetricsStore().

package/src/commands/dashboard.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory dashboard [--interval <ms>] [--all]
+ * CLI command: ov dashboard [--interval <ms>] [--all]
  *
  * Rich terminal dashboard using raw ANSI escape codes (zero runtime deps).
  * Polls existing data sources and renders multi-panel layout with agent status,
@@ -402,7 +402,7 @@ async function loadDashboardData(
  * Render the header bar (line 1).
  */
 function renderHeader(width: number, interval: number, currentRunId?: string | null): string {
-	const left = color.bold(`overstory dashboard v${PKG_VERSION}`);
+	const left = color.bold(`ov dashboard v${PKG_VERSION}`);
 	const now = new Date().toLocaleTimeString();
 	const scope = currentRunId ? ` [run: ${currentRunId.slice(0, 8)}]` : " [all runs]";
 	const right = `${now}${scope} | refresh: ${interval}ms`;
@@ -438,15 +438,15 @@ function getStateColor(state: string): ColorFn {
 function getStateIcon(state: string): string {
 	switch (state) {
 		case "working":
-			return "●";
+			return ">";
 		case "booting":
-			return "◐";
+			return "-";
 		case "stalled":
-			return "⚠";
+			return "!";
 		case "zombie":
-			return "○";
+			return "x";
 		case "completed":
-			return "✓";
+			return "x";
 		default:
 			return "?";
 	}
@@ -470,7 +470,7 @@ function renderAgentPanel(
 	output += `${CURSOR.cursorTo(startRow, 1)}${headerLine}${headerPadding}${BOX.vertical}\n`;
 
 	// Column headers
-	const colHeaders = `${BOX.vertical} St Name            Capability    State      Bead ID          Duration  Tmux ${BOX.vertical}`;
+	const colHeaders = `${BOX.vertical} St Name            Capability    State      Task ID          Duration  Tmux ${BOX.vertical}`;
 	output += `${CURSOR.cursorTo(startRow + 1, 1)}${colHeaders}\n`;
 
 	// Separator
@@ -500,7 +500,7 @@ function renderAgentPanel(
 		const name = pad(truncate(agent.agentName, 15), 15);
 		const capability = pad(truncate(agent.capability, 12), 12);
 		const state = pad(agent.state, 10);
-		const beadId = pad(truncate(agent.beadId, 16), 16);
+		const taskId = pad(truncate(agent.taskId, 16), 16);
 		const endTime =
 			agent.state === "completed" || agent.state === "zombie"
 				? new Date(agent.lastActivity).getTime()
@@ -508,9 +508,9 @@ function renderAgentPanel(
 		const duration = formatDuration(endTime - new Date(agent.startedAt).getTime());
 		const durationPadded = pad(duration, 9);
 		const tmuxAlive = data.status.tmuxSessions.some((s) => s.name === agent.tmuxSession);
-		const tmuxDot = tmuxAlive ? color.green("●") : color.red("○");
+		const tmuxDot = tmuxAlive ? color.green(">") : color.red("x");
 
-		const line = `${BOX.vertical} ${stateColor(icon)}  ${name} ${capability} ${stateColor(state)} ${beadId} ${durationPadded} ${tmuxDot}    ${BOX.vertical}`;
+		const line = `${BOX.vertical} ${stateColor(icon)}  ${name} ${capability} ${stateColor(state)} ${taskId} ${durationPadded} ${tmuxDot}    ${BOX.vertical}`;
 		output += `${CURSOR.cursorTo(startRow + 3 + i, 1)}${line}\n`;
 	}
 

package/src/commands/doctor.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory doctor [options]
+ * CLI command: ov doctor [options]
  *
  * Runs health checks on overstory subsystems and reports problems.
  */
@@ -77,10 +77,10 @@ function printHumanReadable(
 
 				const icon =
 					check.status === "pass"
-						? color.green("✔")
+						? color.green("-")
 						: check.status === "warn"
-							? color.yellow("⚠")
-							: color.red("✘");
+							? color.yellow("!")
+							: color.red("x");
 
 				w(`  ${icon} ${check.message}\n`);
 

package/src/commands/errors.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory errors [--agent <name>] [--run <id>] [--json] [--since <ts>] [--until <ts>] [--limit <n>]
+ * CLI command: ov errors [--agent <name>] [--run <id>] [--json] [--since <ts>] [--until <ts>] [--limit <n>]
  *
  * Shows aggregated error-level events across all agents.
  * Errors can be filtered by agent name, run ID, or time range.

package/src/commands/feed.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory feed [--follow] [--agent <name>...] [--run <id>]
+ * CLI command: ov feed [--follow] [--agent <name>...] [--run <id>]
  *              [--since <ts>] [--limit <n>] [--interval <ms>] [--json]
  *
  * Unified real-time event stream across all agents — like `tail -f` for the fleet.

package/src/commands/group.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory group create|status|add|remove|list
+ * CLI command: ov group create|status|add|remove|list
  *
  * Manages TaskGroups for batch work coordination. Groups track collections
  * of beads issues and auto-close when all member issues are closed.
@@ -297,7 +297,7 @@ function printGroupProgress(progress: TaskGroupProgress): void {
 }
 
 /**
- * Create the Commander command for `overstory group`.
+ * Create the Commander command for `ov group`.
  */
 export function createGroupCommand(): Command {
 	const cmd = new Command("group").description("Manage task groups for batch coordination");
@@ -472,7 +472,7 @@ export function createGroupCommand(): Command {
 }
 
 /**
- * Entry point for `overstory group <subcommand>`.
+ * Entry point for `ov group <subcommand>`.
  */
 export async function groupCommand(args: string[]): Promise<void> {
 	const cmd = createGroupCommand();

package/src/commands/hooks.test.ts

@@ -22,13 +22,13 @@ const SAMPLE_HOOKS = {
 		SessionStart: [
 			{
 				matcher: "",
-				hooks: [{ type: "command", command: "overstory prime --agent orchestrator" }],
+				hooks: [{ type: "command", command: "ov prime --agent orchestrator" }],
 			},
 		],
 		Stop: [
 			{
 				matcher: "",
-				hooks: [{ type: "command", command: "overstory log session-end --agent orchestrator" }],
+				hooks: [{ type: "command", command: "ov log session-end --agent orchestrator" }],
 			},
 		],
 	},
@@ -106,7 +106,7 @@ describe("hooks install", () => {
 		const content = await Bun.file(targetPath).text();
 		const parsed = JSON.parse(content) as Record<string, unknown>;
 		expect(parsed.hooks).toBeDefined();
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 	});
 
 	test("preserves existing non-hooks keys in settings.local.json", async () => {
@@ -182,7 +182,7 @@ describe("hooks install", () => {
 		// Existing user hook is preserved
 		expect(content).toContain("user-hook");
 		// Overstory hooks are added
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 	});
 
 	test("throws when .overstory/hooks.json does not exist", async () => {
@@ -284,7 +284,7 @@ describe("hooks install merge behavior", () => {
 		// User's PreToolUse hook preserved
 		expect(content).toContain("user-write-hook");
 		// Overstory's SessionStart hook added
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 		// Both event types present
 		expect(parsed.hooks.PreToolUse).toBeDefined();
 		expect(parsed.hooks.SessionStart).toBeDefined();
@@ -361,7 +361,7 @@ describe("hooks install merge behavior", () => {
 		const parsed = JSON.parse(content) as { hooks: Record<string, unknown[]> };
 		expect(parsed.hooks.SessionStart).toBeDefined();
 		expect(parsed.hooks.Stop).toBeDefined();
-		expect(content).toContain("overstory prime");
+		expect(content).toContain("ov prime");
 	});
 
 	describe("mergeHooksByEventType unit tests", () => {
@@ -424,7 +424,7 @@ describe("hooks status", () => {
 		const output = await captureStdout(() => hooksCommand(["status"]));
 		expect(output).toContain("present");
 		expect(output).toContain("no");
-		expect(output).toContain("overstory hooks install");
+		expect(output).toContain("ov hooks install");
 	});
 
 	test("reports installed:true when hooks present in .claude/", async () => {

package/src/commands/hooks.ts

@@ -1,13 +1,13 @@
 /**
- * CLI command: overstory hooks install|uninstall|status
+ * CLI command: ov hooks install|uninstall|status
  *
  * Manages orchestrator hooks in .claude/settings.local.json.
- * Hooks are sourced from .overstory/hooks.json (generated by overstory init).
+ * Hooks are sourced from .overstory/hooks.json (generated by ov init).
  *
  * This keeps the canonical hook configuration in .overstory/ while placing
  * a minimal copy in .claude/ only when the user explicitly opts in.
- * Running `overstory init` alone does NOT modify .claude/ — the user must
- * run `overstory hooks install` as a separate step.
+ * Running `ov init` alone does NOT modify .claude/ — the user must
+ * run `ov hooks install` as a separate step.
  */
 
 import { mkdir, unlink } from "node:fs/promises";
@@ -80,7 +80,7 @@ async function installHooks(force: boolean): Promise<void> {
 	const sourcePath = join(projectRoot, ".overstory", "hooks.json");
 	const sourceFile = Bun.file(sourcePath);
 	if (!(await sourceFile.exists())) {
-		throw new ValidationError("No hooks.json found in .overstory/. Run 'overstory init' first.", {
+		throw new ValidationError("No hooks.json found in .overstory/. Run 'ov init' first.", {
 			field: "source",
 		});
 	}
@@ -199,7 +199,7 @@ async function statusHooks(json: boolean): Promise<void> {
 			`Hooks installed (.claude/settings.local.json): ${installed ? "yes" : "no"}\n`,
 		);
 		if (!installed && sourceExists) {
-			process.stdout.write(`\nRun 'overstory hooks install' to install.\n`);
+			process.stdout.write(`\nRun 'ov hooks install' to install.\n`);
 		}
 	}
 }
@@ -234,7 +234,7 @@ export function createHooksCommand(): Command {
 }
 
 /**
- * Entry point for `overstory hooks <subcommand>`.
+ * Entry point for `ov hooks <subcommand>`.
  */
 export async function hooksCommand(args: string[]): Promise<void> {
 	const cmd = createHooksCommand();

package/src/commands/init.test.ts

@@ -20,6 +20,10 @@ const AGENT_DEF_FILES = [
 	"supervisor.md",
 	"coordinator.md",
 	"monitor.md",
+	"issue-reviews.md",
+	"pr-reviews.md",
+	"prioritize.md",
+	"release.md",
 ];
 
 /** Resolve the source agents directory (same logic as init.ts). */
@@ -46,7 +50,7 @@ describe("initCommand: agent-defs deployment", () => {
 		await cleanupTempDir(tempDir);
 	});
 
-	test("creates .overstory/agent-defs/ with all 8 agent definition files", async () => {
+	test("creates .overstory/agent-defs/ with all 12 agent definition files", async () => {
 		await initCommand({});
 
 		const agentDefsDir = join(tempDir, ".overstory", "agent-defs");
@@ -100,7 +104,7 @@ describe("initCommand: agent-defs deployment", () => {
 		const stopHooks = parsed.hooks.Stop[0].hooks;
 
 		expect(stopHooks.length).toBe(2);
-		expect(stopHooks[0].command).toContain("overstory log session-end");
+		expect(stopHooks[0].command).toContain("ov log session-end");
 		expect(stopHooks[1].command).toBe("mulch learn");
 	});