@os-eco/overstory-cli 0.6.4 → 0.6.6

package/src/commands/init.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory init [--force]
+ * CLI command: ov init [--force]
  *
  * Scaffolds the `.overstory/` directory in the current project with:
  * - config.yaml (serialized from DEFAULT_CONFIG)
@@ -296,7 +296,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory prime --agent orchestrator",
+							command: "ov prime --agent orchestrator",
 						},
 					],
 				},
@@ -307,7 +307,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory mail check --inject --agent orchestrator",
+							command: "ov mail check --inject --agent orchestrator",
 						},
 					],
 				},
@@ -328,7 +328,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: `${toolNameExtract} overstory log tool-start --agent orchestrator --tool-name "$TOOL_NAME"`,
+							command: `${toolNameExtract} ov log tool-start --agent orchestrator --tool-name "$TOOL_NAME"`,
 						},
 					],
 				},
@@ -339,7 +339,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: `${toolNameExtract} overstory log tool-end --agent orchestrator --tool-name "$TOOL_NAME"`,
+							command: `${toolNameExtract} ov log tool-end --agent orchestrator --tool-name "$TOOL_NAME"`,
 						},
 					],
 				},
@@ -360,7 +360,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory log session-end --agent orchestrator",
+							command: "ov log session-end --agent orchestrator",
 						},
 						{
 							type: "command",
@@ -375,7 +375,7 @@ function buildHooksJson(): string {
 					hooks: [
 						{
 							type: "command",
-							command: "overstory prime --agent orchestrator --compact",
+							command: "ov prime --agent orchestrator --compact",
 						},
 					],
 				},
@@ -450,11 +450,11 @@ CREATE TABLE IF NOT EXISTS sessions (
 /**
  * Content for .overstory/.gitignore — runtime state that should not be tracked.
  * Uses wildcard+whitelist pattern: ignore everything, whitelist tracked files.
- * Auto-healed by overstory prime on each session start.
+ * Auto-healed by ov prime on each session start.
  * Config files (config.yaml, agent-manifest.json, hooks.json) remain tracked.
  */
 export 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
@@ -476,13 +476,13 @@ Overstory turns a single Claude Code session into a multi-agent team by spawning
 
 ## Key Commands
 
-- \`overstory init\`          — Initialize this directory
-- \`overstory status\`        — Show active agents and state
-- \`overstory sling <id>\`    — Spawn a worker agent
-- \`overstory mail check\`    — Check agent messages
-- \`overstory merge\`         — Merge agent work back
-- \`overstory dashboard\`     — Live TUI monitoring
-- \`overstory doctor\`        — Run health checks
+- \`ov init\`          — Initialize this directory
+- \`ov status\`        — Show active agents and state
+- \`ov sling <id>\`    — Spawn a worker agent
+- \`ov mail check\`    — Check agent messages
+- \`ov merge\`         — Merge agent work back
+- \`ov dashboard\`     — Live TUI monitoring
+- \`ov doctor\`        — Run health checks
 
 ## Structure
 
@@ -526,7 +526,7 @@ function printCreated(relativePath: string): void {
 }
 
 /**
- * Entry point for `overstory init [--force]`.
+ * Entry point for `ov init [--force]`.
  *
  * Scaffolds the .overstory/ directory structure in the current working directory.
  *
@@ -636,6 +636,6 @@ export async function initCommand(opts: InitOptions): Promise<void> {
 	}
 
 	process.stdout.write("\nDone.\n");
-	process.stdout.write("  Next: run `overstory hooks install` to enable Claude Code hooks.\n");
-	process.stdout.write("  Then: run `overstory status` to see the current state.\n");
+	process.stdout.write("  Next: run `ov hooks install` to enable Claude Code hooks.\n");
+	process.stdout.write("  Then: run `ov status` to see the current state.\n");
 }

package/src/commands/inspect.test.ts

@@ -39,7 +39,7 @@ function makeEvent(overrides: Partial<InsertEvent> = {}): InsertEvent {
 function makeMetrics(overrides: Partial<SessionMetrics> = {}): SessionMetrics {
 	return {
 		agentName: "builder-1",
-		beadId: "overstory-001",
+		taskId: "overstory-001",
 		capability: "builder",
 		startedAt: new Date().toISOString(),
 		completedAt: null,
@@ -142,7 +142,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -174,7 +174,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -210,7 +210,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -229,7 +229,7 @@ describe("inspectCommand", () => {
 			expect(data.session.agentName).toBe("builder-1");
 			expect(data.session.capability).toBe("builder");
 			expect(data.session.state).toBe("working");
-			expect(data.session.beadId).toBe("overstory-001");
+			expect(data.session.taskId).toBe("overstory-001");
 			expect(data.timeSinceLastActivity).toBeGreaterThan(4000);
 			expect(data.timeSinceLastActivity).toBeLessThan(10000);
 		});
@@ -246,7 +246,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -285,7 +285,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -320,7 +320,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -355,7 +355,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -399,7 +399,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -442,7 +442,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -491,7 +491,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -528,7 +528,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -564,7 +564,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -601,7 +601,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,
@@ -639,7 +639,7 @@ describe("inspectCommand", () => {
 				capability: "builder",
 				worktreePath: "/tmp/wt",
 				branchName: "overstory/builder-1/test",
-				beadId: "overstory-001",
+				taskId: "overstory-001",
 				tmuxSession: "overstory-test-builder-1",
 				state: "working",
 				pid: 12345,

package/src/commands/inspect.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory inspect <agent-name>
+ * CLI command: ov inspect <agent-name>
  *
  * Deep per-agent inspection aggregating data from EventStore, SessionStore,
  * MetricsStore, and tmux capture-pane.
@@ -35,15 +35,15 @@ function formatDuration(ms: number): string {
 function getStateIcon(state: AgentSession["state"]): string {
 	switch (state) {
 		case "booting":
-			return `${color.yellow("⏳")}`; // Yellow hourglass
+			return color.green("-");
 		case "working":
-			return `${color.green("●")}`; // Green circle
+			return color.cyan(">");
 		case "stalled":
-			return `${color.yellow("⚠")}`; // Yellow warning
+			return color.yellow("!");
 		case "completed":
-			return `${color.blue("✓")}`; // Blue checkmark
+			return color.dim("x");
 		case "zombie":
-			return `${color.red("☠")}`; // Red skull
+			return color.dim("x");
 		default:
 			return "?";
 	}
@@ -252,31 +252,31 @@ export function printInspectData(data: InspectData): void {
 	const w = process.stdout.write.bind(process.stdout);
 	const { session } = data;
 
-	w(`\n🔍 Agent Inspection: ${session.agentName}\n`);
+	w(`\nAgent Inspection: ${session.agentName}\n`);
 	w(`${"═".repeat(80)}\n\n`);
 
 	// Agent state and metadata
 	const stateIcon = getStateIcon(session.state);
 	w(`${stateIcon} State: ${session.state}\n`);
-	w(`⏱  Last activity: ${formatDuration(data.timeSinceLastActivity)} ago\n`);
-	w(`🎯 Task: ${session.beadId}\n`);
-	w(`🔧 Capability: ${session.capability}\n`);
-	w(`🌿 Branch: ${session.branchName}\n`);
+	w(`Last activity: ${formatDuration(data.timeSinceLastActivity)} ago\n`);
+	w(`Task: ${session.taskId}\n`);
+	w(`Capability: ${session.capability}\n`);
+	w(`Branch: ${session.branchName}\n`);
 	if (session.parentAgent) {
-		w(`👤 Parent: ${session.parentAgent} (depth: ${session.depth})\n`);
+		w(`Parent: ${session.parentAgent} (depth: ${session.depth})\n`);
 	}
-	w(`📅 Started: ${session.startedAt}\n`);
-	w(`💻 Tmux: ${session.tmuxSession}\n`);
+	w(`Started: ${session.startedAt}\n`);
+	w(`Tmux: ${session.tmuxSession}\n`);
 	w("\n");
 
 	// Current file
 	if (data.currentFile) {
-		w(`📝 Current file: ${data.currentFile}\n\n`);
+		w(`Current file: ${data.currentFile}\n\n`);
 	}
 
 	// Token usage
 	if (data.tokenUsage) {
-		w("💰 Token Usage\n");
+		w("Token Usage\n");
 		w(`${"─".repeat(80)}\n`);
 		w(`  Input:         ${data.tokenUsage.inputTokens.toLocaleString()}\n`);
 		w(`  Output:        ${data.tokenUsage.outputTokens.toLocaleString()}\n`);
@@ -293,7 +293,7 @@ export function printInspectData(data: InspectData): void {
 
 	// Tool usage statistics (top 10)
 	if (data.toolStats.length > 0) {
-		w("🛠  Tool Usage (Top 10)\n");
+		w("Tool Usage (Top 10)\n");
 		w(`${"─".repeat(80)}\n`);
 		const top10 = data.toolStats.slice(0, 10);
 		for (const stat of top10) {
@@ -306,7 +306,7 @@ export function printInspectData(data: InspectData): void {
 
 	// Recent tool calls
 	if (data.recentToolCalls.length > 0) {
-		w(`📊 Recent Tool Calls (last ${data.recentToolCalls.length})\n`);
+		w(`Recent Tool Calls (last ${data.recentToolCalls.length})\n`);
 		w(`${"─".repeat(80)}\n`);
 		for (const call of data.recentToolCalls) {
 			const time = new Date(call.timestamp).toLocaleTimeString();
@@ -322,7 +322,7 @@ export function printInspectData(data: InspectData): void {
 
 	// tmux output
 	if (data.tmuxOutput) {
-		w("📺 Live Tmux Output\n");
+		w("Live Tmux Output\n");
 		w(`${"─".repeat(80)}\n`);
 		w(`${data.tmuxOutput}\n`);
 		w(`${"─".repeat(80)}\n`);

package/src/commands/log.test.ts

@@ -218,7 +218,7 @@ describe("logCommand", () => {
 			capability: "builder",
 			worktreePath: "/tmp/test",
 			branchName: "test-branch",
-			beadId: "bead-001",
+			taskId: "bead-001",
 			tmuxSession: "test-tmux",
 			state: "working",
 			pid: 12345,
@@ -273,7 +273,7 @@ describe("logCommand", () => {
 			capability: "scout",
 			worktreePath: "/tmp/metrics",
 			branchName: "metrics-branch",
-			beadId: "bead-002",
+			taskId: "bead-002",
 			tmuxSession: "metrics-tmux",
 			state: "working",
 			pid: 54321,
@@ -299,7 +299,7 @@ describe("logCommand", () => {
 
 		expect(metrics).toHaveLength(1);
 		expect(metrics[0]?.agentName).toBe("metrics-agent");
-		expect(metrics[0]?.beadId).toBe("bead-002");
+		expect(metrics[0]?.taskId).toBe("bead-002");
 		expect(metrics[0]?.capability).toBe("scout");
 		expect(metrics[0]?.parentAgent).toBe("parent-agent");
 	});
@@ -313,7 +313,7 @@ describe("logCommand", () => {
 			capability: "coordinator",
 			worktreePath: tempDir,
 			branchName: "main",
-			beadId: "",
+			taskId: "",
 			tmuxSession: "overstory-coordinator",
 			state: "working",
 			pid: 11111,
@@ -352,7 +352,7 @@ describe("logCommand", () => {
 			capability: "monitor",
 			worktreePath: tempDir,
 			branchName: "main",
-			beadId: "",
+			taskId: "",
 			tmuxSession: "overstory-monitor",
 			state: "working",
 			pid: 22222,
@@ -389,7 +389,7 @@ describe("logCommand", () => {
 				capability: "coordinator",
 				worktreePath: tempDir,
 				branchName: "main",
-				beadId: "",
+				taskId: "",
 				tmuxSession: "overstory-coordinator",
 				state: "working",
 				pid: 11111,
@@ -446,7 +446,7 @@ describe("logCommand", () => {
 				capability: "coordinator",
 				worktreePath: tempDir,
 				branchName: "main",
-				beadId: "",
+				taskId: "",
 				tmuxSession: "overstory-coordinator-no-run",
 				state: "working",
 				pid: 11112,
@@ -476,7 +476,7 @@ describe("logCommand", () => {
 				capability: "builder",
 				worktreePath: tempDir,
 				branchName: "builder-branch",
-				beadId: "bead-builder-001",
+				taskId: "bead-builder-001",
 				tmuxSession: "overstory-builder",
 				state: "working",
 				pid: 11113,
@@ -530,7 +530,7 @@ describe("logCommand", () => {
 				capability: "coordinator",
 				worktreePath: tempDir,
 				branchName: "main",
-				beadId: "",
+				taskId: "",
 				tmuxSession: "overstory-coordinator-completed",
 				state: "working",
 				pid: 11114,
@@ -583,7 +583,7 @@ describe("logCommand", () => {
 			capability: "lead",
 			worktreePath: tempDir,
 			branchName: "lead-alpha-branch",
-			beadId: "bead-lead-001",
+			taskId: "bead-lead-001",
 			tmuxSession: "overstory-lead-alpha",
 			state: "working",
 			pid: 33333,
@@ -623,7 +623,7 @@ describe("logCommand", () => {
 			capability: "builder",
 			worktreePath: tempDir,
 			branchName: "builder-beta-branch",
-			beadId: "bead-builder-001",
+			taskId: "bead-builder-001",
 			tmuxSession: "overstory-builder-beta",
 			state: "working",
 			pid: 44444,
@@ -665,7 +665,7 @@ describe("logCommand", () => {
 			capability: "builder",
 			worktreePath: "/tmp/activity",
 			branchName: "activity-branch",
-			beadId: "bead-003",
+			taskId: "bead-003",
 			tmuxSession: "activity-tmux",
 			state: "working",
 			pid: 99999,
@@ -704,7 +704,7 @@ describe("logCommand", () => {
 			capability: "builder",
 			worktreePath: "/tmp/booting",
 			branchName: "booting-branch",
-			beadId: "bead-004",
+			taskId: "bead-004",
 			tmuxSession: "booting-tmux",
 			state: "booting",
 			pid: 11111,
@@ -789,7 +789,7 @@ describe("logCommand", () => {
 			capability: "builder",
 			worktreePath: tempDir,
 			branchName: "mulch-fail-branch",
-			beadId: "bead-mulch-001",
+			taskId: "bead-mulch-001",
 			tmuxSession: "overstory-mulch-fail",
 			state: "working",
 			pid: 55555,
@@ -828,7 +828,7 @@ describe("logCommand", () => {
 			capability: "coordinator",
 			worktreePath: tempDir,
 			branchName: "main",
-			beadId: "",
+			taskId: "",
 			tmuxSession: "overstory-coordinator-mulch",
 			state: "working",
 			pid: 66666,
@@ -875,7 +875,7 @@ describe("logCommand", () => {
 			mulchClient: client,
 			agentName: "test-builder",
 			capability: "builder",
-			beadId: "bead-123",
+			taskId: "bead-123",
 			mailDbPath,
 			parentAgent: "parent-lead",
 			projectRoot: tempDir,
@@ -908,7 +908,7 @@ describe("logCommand", () => {
 			mulchClient: client,
 			agentName: "test-builder",
 			capability: "builder",
-			beadId: "bead-456",
+			taskId: "bead-456",
 			mailDbPath,
 			parentAgent: "parent-lead",
 			projectRoot: tempDir,
@@ -940,7 +940,7 @@ describe("logCommand", () => {
 			mulchClient: client,
 			agentName: "test-builder",
 			capability: "builder",
-			beadId: null,
+			taskId: null,
 			mailDbPath,
 			parentAgent: null,
 			projectRoot: tempDir,
@@ -968,7 +968,7 @@ describe("logCommand", () => {
 			mulchClient: client,
 			agentName: "test-builder",
 			capability: "builder",
-			beadId: null,
+			taskId: null,
 			mailDbPath,
 			parentAgent: null,
 			projectRoot: tempDir,
@@ -1047,7 +1047,7 @@ describe("logCommand", () => {
 			mulchClient: client,
 			agentName: "insight-agent",
 			capability: "builder",
-			beadId: "bead-insight",
+			taskId: "bead-insight",
 			mailDbPath,
 			parentAgent: "parent-agent",
 			projectRoot: tempDir,
@@ -1127,7 +1127,7 @@ describe("logCommand", () => {
 			mulchClient: client,
 			agentName: "mail-insight-agent",
 			capability: "scout",
-			beadId: "bead-mail",
+			taskId: "bead-mail",
 			mailDbPath,
 			parentAgent: "parent-agent",
 			projectRoot: tempDir,

package/src/commands/log.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory log <event> --agent <name> [--stdin]
+ * CLI command: ov log <event> --agent <name> [--stdin]
  *
  * Called by Pre/PostToolUse and Stop hooks.
  * Events: tool-start, tool-end, session-end.
@@ -227,7 +227,7 @@ export async function autoRecordExpertise(params: {
 	mulchClient: MulchClient;
 	agentName: string;
 	capability: string;
-	beadId: string | null;
+	taskId: string | null;
 	mailDbPath: string;
 	parentAgent: string | null;
 	projectRoot: string;
@@ -247,7 +247,7 @@ export async function autoRecordExpertise(params: {
 				type: "reference",
 				description: `${params.capability} agent ${params.agentName} completed work in this domain. Files: ${filesList}`,
 				tags: ["auto-session-end", params.capability],
-				evidenceBead: params.beadId ?? undefined,
+				evidenceBead: params.taskId ?? undefined,
 			});
 			recordedDomains.push(domain);
 		} catch {
@@ -286,7 +286,7 @@ export async function autoRecordExpertise(params: {
 					type: insight.type,
 					description: insight.description,
 					tags: insight.tags,
-					evidenceBead: params.beadId ?? undefined,
+					evidenceBead: params.taskId ?? undefined,
 				});
 				if (!recordedDomains.includes(insight.domain)) {
 					recordedDomains.push(insight.domain);
@@ -503,14 +503,14 @@ async function runLog(opts: {
 			// Look up agent session for identity update and metrics recording
 			{
 				const agentSession = getAgentSession(config.project.root, opts.agent);
-				const beadId = agentSession?.beadId ?? null;
+				const taskId = agentSession?.taskId ?? null;
 
 				// Update agent identity with completed session
 				const identityBaseDir = join(config.project.root, ".overstory", "agents");
 				try {
 					await updateIdentity(identityBaseDir, opts.agent, {
 						sessionsCompleted: 1,
-						completedTask: beadId ? { beadId, summary: `Completed task ${beadId}` } : undefined,
+						completedTask: taskId ? { taskId, summary: `Completed task ${taskId}` } : undefined,
 					});
 				} catch {
 					// Non-fatal: identity may not exist for this agent
@@ -542,7 +542,7 @@ async function runLog(opts: {
 				if (agentSession) {
 					// Auto-complete the current run when the coordinator exits.
 					// This handles the case where the user closes the tmux window
-					// without running `overstory coordinator stop`.
+					// without running `ov coordinator stop`.
 					if (agentSession.capability === "coordinator") {
 						try {
 							const currentRunPath = join(config.project.root, ".overstory", "current-run.txt");
@@ -601,7 +601,7 @@ async function runLog(opts: {
 
 						metricsStore.recordSession({
 							agentName: opts.agent,
-							beadId: agentSession.beadId,
+							taskId: agentSession.taskId,
 							capability: agentSession.capability,
 							startedAt: agentSession.startedAt,
 							completedAt: now,
@@ -632,7 +632,7 @@ async function runLog(opts: {
 								mulchClient,
 								agentName: opts.agent,
 								capability: agentSession.capability,
-								beadId,
+								taskId,
 								mailDbPath,
 								parentAgent: agentSession.parentAgent,
 								projectRoot: config.project.root,
@@ -710,7 +710,7 @@ export function createLogCommand(): Command {
 }
 
 /**
- * Entry point for `overstory log <event> --agent <name>`.
+ * Entry point for `ov log <event> --agent <name>`.
  */
 export async function logCommand(args: string[]): Promise<void> {
 	const cmd = createLogCommand();

package/src/commands/logs.ts

@@ -1,5 +1,5 @@
 /**
- * CLI command: overstory logs [--agent <name>] [--level <level>] [--since <time>] [--until <time>] [--limit <n>] [--follow] [--json]
+ * CLI command: ov logs [--agent <name>] [--level <level>] [--since <time>] [--until <time>] [--limit <n>] [--follow] [--json]
  *
  * Queries NDJSON log files from .overstory/logs/{agent-name}/{session-timestamp}/events.ndjson
  * and presents a unified timeline view.