@os-eco/overstory-cli 0.6.11 → 0.7.2

package/src/agents/guard-rules.ts

@@ -0,0 +1,97 @@
+/**
+ * Shared guard rule constants for overstory agent hook generation.
+ *
+ * Pure data module — named exports only, no logic. These constants are the
+ * single source of truth for tool names, bash patterns, and safe prefixes
+ * used when generating PreToolUse guards in hooks-deployer.ts.
+ */
+
+/**
+ * Claude Code native team/task tools that bypass overstory orchestration.
+ * All overstory agents must use `overstory sling` for delegation, not these.
+ */
+export const NATIVE_TEAM_TOOLS = [
+	"Task",
+	"TeamCreate",
+	"TeamDelete",
+	"SendMessage",
+	"TaskCreate",
+	"TaskUpdate",
+	"TaskList",
+	"TaskGet",
+	"TaskOutput",
+	"TaskStop",
+];
+
+/**
+ * Tools that require human interaction and block indefinitely in non-interactive
+ * tmux sessions. Agents run non-interactively and must never call these tools.
+ * Use overstory mail (--type question) to escalate to the orchestrator instead.
+ */
+export const INTERACTIVE_TOOLS = ["AskUserQuestion", "EnterPlanMode", "EnterWorktree"];
+
+/** Tools that non-implementation agents must not use. */
+export const WRITE_TOOLS = ["Write", "Edit", "NotebookEdit"];
+
+/**
+ * Bash commands that modify files and must be blocked for non-implementation agents.
+ * Each pattern is a regex fragment used inside a grep -qE check.
+ */
+export const DANGEROUS_BASH_PATTERNS = [
+	"sed\\s+-i",
+	"sed\\s+--in-place",
+	"echo\\s+.*>",
+	"printf\\s+.*>",
+	"cat\\s+.*>",
+	"tee\\s",
+	"\\bvim\\b",
+	"\\bnano\\b",
+	"\\bvi\\b",
+	"\\bmv\\s",
+	"\\bcp\\s",
+	"\\brm\\s",
+	"\\bmkdir\\s",
+	"\\btouch\\s",
+	"\\bchmod\\s",
+	"\\bchown\\s",
+	">>",
+	"\\bgit\\s+add\\b",
+	"\\bgit\\s+commit\\b",
+	"\\bgit\\s+merge\\b",
+	"\\bgit\\s+push\\b",
+	"\\bgit\\s+reset\\b",
+	"\\bgit\\s+checkout\\b",
+	"\\bgit\\s+rebase\\b",
+	"\\bgit\\s+stash\\b",
+	"\\bnpm\\s+install\\b",
+	"\\bbun\\s+install\\b",
+	"\\bbun\\s+add\\b",
+	// Runtime eval flags — bypass shell pattern guards by executing JS/Python directly
+	"\\bbun\\s+-e\\b",
+	"\\bbun\\s+--eval\\b",
+	"\\bnode\\s+-e\\b",
+	"\\bnode\\s+--eval\\b",
+	"\\bdeno\\s+eval\\b",
+	"\\bpython3?\\s+-c\\b",
+	"\\bperl\\s+-e\\b",
+	"\\bruby\\s+-e\\b",
+];
+
+/**
+ * Bash commands that are always safe for non-implementation agents.
+ * If a command starts with any of these prefixes, it bypasses the dangerous command check.
+ * This whitelist is checked BEFORE the blocklist.
+ */
+export const SAFE_BASH_PREFIXES = [
+	"ov ",
+	"overstory ",
+	"bd ",
+	"sd ",
+	"git status",
+	"git log",
+	"git diff",
+	"git show",
+	"git blame",
+	"git branch",
+	"mulch ",
+];

package/src/agents/hooks-deployer.ts

@@ -3,6 +3,13 @@ import { dirname, join } from "node:path";
 import { DEFAULT_QUALITY_GATES } from "../config.ts";
 import { AgentError } from "../errors.ts";
 import type { QualityGate } from "../types.ts";
+import {
+	DANGEROUS_BASH_PATTERNS,
+	INTERACTIVE_TOOLS,
+	NATIVE_TEAM_TOOLS,
+	SAFE_BASH_PREFIXES,
+	WRITE_TOOLS,
+} from "./guard-rules.ts";
 
 /**
  * Capabilities that must never modify project files.
@@ -31,96 +38,6 @@ const COORDINATION_CAPABILITIES = new Set(["coordinator", "supervisor", "monitor
  */
 const COORDINATION_SAFE_PREFIXES = ["git add", "git commit"];
 
-/**
- * Claude Code native team/task tools that bypass overstory orchestration.
- * All overstory agents must use `overstory sling` for delegation, not these.
- */
-const NATIVE_TEAM_TOOLS = [
-	"Task",
-	"TeamCreate",
-	"TeamDelete",
-	"SendMessage",
-	"TaskCreate",
-	"TaskUpdate",
-	"TaskList",
-	"TaskGet",
-	"TaskOutput",
-	"TaskStop",
-];
-
-/**
- * Tools that require human interaction and block indefinitely in non-interactive
- * tmux sessions. Agents run non-interactively and must never call these tools.
- * Use overstory mail (--type question) to escalate to the orchestrator instead.
- */
-const INTERACTIVE_TOOLS = ["AskUserQuestion", "EnterPlanMode", "EnterWorktree"];
-
-/** Tools that non-implementation agents must not use. */
-const WRITE_TOOLS = ["Write", "Edit", "NotebookEdit"];
-
-/**
- * Bash commands that modify files and must be blocked for non-implementation agents.
- * Each pattern is a regex fragment used inside a grep -qE check.
- */
-const DANGEROUS_BASH_PATTERNS = [
-	"sed\\s+-i",
-	"sed\\s+--in-place",
-	"echo\\s+.*>",
-	"printf\\s+.*>",
-	"cat\\s+.*>",
-	"tee\\s",
-	"\\bvim\\b",
-	"\\bnano\\b",
-	"\\bvi\\b",
-	"\\bmv\\s",
-	"\\bcp\\s",
-	"\\brm\\s",
-	"\\bmkdir\\s",
-	"\\btouch\\s",
-	"\\bchmod\\s",
-	"\\bchown\\s",
-	">>",
-	"\\bgit\\s+add\\b",
-	"\\bgit\\s+commit\\b",
-	"\\bgit\\s+merge\\b",
-	"\\bgit\\s+push\\b",
-	"\\bgit\\s+reset\\b",
-	"\\bgit\\s+checkout\\b",
-	"\\bgit\\s+rebase\\b",
-	"\\bgit\\s+stash\\b",
-	"\\bnpm\\s+install\\b",
-	"\\bbun\\s+install\\b",
-	"\\bbun\\s+add\\b",
-	// Runtime eval flags — bypass shell pattern guards by executing JS/Python directly
-	"\\bbun\\s+-e\\b",
-	"\\bbun\\s+--eval\\b",
-	"\\bnode\\s+-e\\b",
-	"\\bnode\\s+--eval\\b",
-	"\\bdeno\\s+eval\\b",
-	"\\bpython3?\\s+-c\\b",
-	"\\bperl\\s+-e\\b",
-	"\\bruby\\s+-e\\b",
-];
-
-/**
- * Bash commands that are always safe for non-implementation agents.
- * If a command starts with any of these prefixes, it bypasses the dangerous command check.
- * This whitelist is checked BEFORE the blocklist.
- */
-const SAFE_BASH_PREFIXES = [
-	"ov ",
-	"overstory ",
-	"bd ",
-	"sd ",
-	"git status",
-	"git log",
-	"git diff",
-	"git show",
-	"git blame",
-	"git branch",
-	"mulch ",
-];
-
 /**
  * Extract command prefixes from quality gate configurations.
  *

package/src/agents/overlay.test.ts

@@ -265,7 +265,7 @@ describe("generateOverlay", () => {
 		expect(output).not.toContain("bun run lint");
 	});
 
-	test("scout completion section includes bd close and mail send", async () => {
+	test("scout completion section includes sd close and mail send", async () => {
 		const config = makeConfig({
 			capability: "scout",
 			agentName: "recon-1",
@@ -274,7 +274,7 @@ describe("generateOverlay", () => {
 		});
 		const output = await generateOverlay(config);
 
-		expect(output).toContain("bd close overstory-task1");
+		expect(output).toContain("sd close overstory-task1");
 		expect(output).toContain("ov mail send --to lead-alpha");
 	});
 
@@ -426,14 +426,14 @@ describe("generateOverlay", () => {
 		expect(output).not.toContain("Quality Gates");
 	});
 
-	test("default trackerCli renders as bd in quality gates", async () => {
+	test("default trackerCli renders as sd in quality gates", async () => {
 		const config = makeConfig({ capability: "builder", taskId: "overstory-task1" });
 		const output = await generateOverlay(config);
 
-		expect(output).toContain("bd close overstory-task1");
+		expect(output).toContain("sd close overstory-task1");
 	});
 
-	test("custom trackerCli replaces bd in quality gates", async () => {
+	test("custom trackerCli replaces sd in quality gates", async () => {
 		const config = makeConfig({
 			capability: "builder",
 			trackerCli: "sd",
@@ -489,11 +489,11 @@ describe("generateOverlay", () => {
 		expect(output).not.toContain("{{TRACKER_NAME}}");
 	});
 
-	test("defaults backward-compatible: no trackerCli/trackerName produces bd/beads", async () => {
+	test("defaults: no trackerCli/trackerName produces sd/seeds", async () => {
 		const config = makeConfig({ capability: "builder", taskId: "overstory-back" });
 		const output = await generateOverlay(config);
 
-		expect(output).toContain("bd close overstory-back");
+		expect(output).toContain("sd close overstory-back");
 	});
 
 	test("dispatch overrides: skipReview injects SKIP REVIEW directive for leads", async () => {
@@ -736,6 +736,29 @@ describe("writeOverlay", () => {
 		const exists = await Bun.file(outputPath).exists();
 		expect(exists).toBe(true);
 	});
+
+	test("writes to custom instruction path when provided", async () => {
+		const worktreePath = join(tempDir, "worktree");
+		const config = makeConfig();
+		await writeOverlay(worktreePath, config, "/nonexistent-canonical-root", "AGENTS.md");
+		const outputPath = join(worktreePath, "AGENTS.md");
+		expect(await Bun.file(outputPath).exists()).toBe(true);
+		expect(await Bun.file(join(worktreePath, ".claude", "CLAUDE.md")).exists()).toBe(false);
+	});
+
+	test("custom instruction path creates necessary subdirectories", async () => {
+		const worktreePath = join(tempDir, "worktree");
+		const config = makeConfig();
+		await writeOverlay(
+			worktreePath,
+			config,
+			"/nonexistent-canonical-root",
+			".pi/instructions/AGENT.md",
+		);
+		expect(await Bun.file(join(worktreePath, ".pi", "instructions", "AGENT.md")).exists()).toBe(
+			true,
+		);
+	});
 });
 
 describe("isCanonicalRoot", () => {

package/src/agents/overlay.ts

@@ -182,7 +182,7 @@ function formatQualityGates(config: OverlayConfig): string {
 			"Before reporting completion:",
 			"",
 			`1. **Record mulch learnings:** \`ml record <domain> --type <convention|pattern|reference> --description "..."\` — capture reusable knowledge from your work`,
-			`2. **Close issue:** \`${config.trackerCli ?? "bd"} close ${config.taskId} --reason "summary of findings"\``,
+			`2. **Close issue:** \`${config.trackerCli ?? "sd"} close ${config.taskId} --reason "summary of findings"\``,
 			`3. **Send results:** \`ov mail send --to ${config.parentAgent ?? "coordinator"} --subject "done" --body "Summary" --type result --agent ${config.agentName}\``,
 			"",
 			"You are a read-only agent. Do NOT commit, modify files, or run quality gates.",
@@ -207,7 +207,7 @@ function formatQualityGates(config: OverlayConfig): string {
 		`${gateLines.length + 1}. **Commit:** all changes committed to your branch (${config.branchName})`,
 		`${gateLines.length + 2}. **Record mulch learnings:** \`ml record <domain> --type <convention|pattern|failure|decision> --description "..." --outcome-status success --outcome-agent ${config.agentName}\` — capture insights from your work`,
 		`${gateLines.length + 3}. **Signal completion:** send \`worker_done\` mail to ${config.parentAgent ?? "coordinator"}: \`ov mail send --to ${config.parentAgent ?? "coordinator"} --subject "Worker done: ${config.taskId}" --body "Quality gates passed." --type worker_done --agent ${config.agentName}\``,
-		`${gateLines.length + 4}. **Close issue:** \`${config.trackerCli ?? "bd"} close ${config.taskId} --reason "summary of changes"\``,
+		`${gateLines.length + 4}. **Close issue:** \`${config.trackerCli ?? "sd"} close ${config.taskId} --reason "summary of changes"\``,
 		"",
 		"Do NOT push to the canonical branch. Your work will be merged by the",
 		"coordinator via `ov merge`.",
@@ -225,7 +225,7 @@ function formatConstraints(config: OverlayConfig): string {
 			"",
 			"- You are **read-only**: do NOT modify, create, or delete any files",
 			"- Do NOT commit, push, or make any git state changes",
-			`- Report completion via \`${config.trackerCli ?? "bd"} close\` AND \`ov mail send --type result\``,
+			`- Report completion via \`${config.trackerCli ?? "sd"} close\` AND \`ov mail send --type result\``,
 			"- If you encounter a blocking issue, send mail with `--priority urgent --type error`",
 		].join("\n");
 	}
@@ -238,7 +238,7 @@ function formatConstraints(config: OverlayConfig): string {
 		"- Only modify files in your File Scope",
 		`- Commit only to your branch: ${config.branchName}`,
 		"- Never push to the canonical branch",
-		`- Report completion via \`${config.trackerCli ?? "bd"} close\` AND \`ov mail send --type result\``,
+		`- Report completion via \`${config.trackerCli ?? "sd"} close\` AND \`ov mail send --type result\``,
 		"- If you encounter a blocking issue, send mail with `--priority urgent --type error`",
 	].join("\n");
 }
@@ -318,7 +318,7 @@ export async function generateOverlay(config: OverlayConfig): Promise<string> {
 		"{{QUALITY_GATE_STEPS}}": formatQualityGatesSteps(config.qualityGates),
 		"{{QUALITY_GATE_BASH}}": formatQualityGatesBash(config.qualityGates),
 		"{{QUALITY_GATE_CAPABILITIES}}": formatQualityGatesCapabilities(config.qualityGates),
-		"{{TRACKER_CLI}}": config.trackerCli ?? "bd",
+		"{{TRACKER_CLI}}": config.trackerCli ?? "sd",
 		"{{TRACKER_NAME}}": config.trackerName ?? "seeds",
 	};
 
@@ -369,6 +369,7 @@ export async function writeOverlay(
 	worktreePath: string,
 	config: OverlayConfig,
 	canonicalRoot: string,
+	instructionPath = ".claude/CLAUDE.md",
 ): Promise<void> {
 	// Guard: never write agent overlays to the canonical project root.
 	// The project root's .claude/CLAUDE.md belongs to the orchestrator/user.
@@ -383,13 +384,13 @@ export async function writeOverlay(
 	}
 
 	const content = await generateOverlay(config);
-	const claudeDir = join(worktreePath, ".claude");
-	const outputPath = join(claudeDir, "CLAUDE.md");
+	const outputPath = join(worktreePath, instructionPath);
+	const outputDir = dirname(outputPath);
 
 	try {
-		await mkdir(claudeDir, { recursive: true });
+		await mkdir(outputDir, { recursive: true });
 	} catch (err) {
-		throw new AgentError(`Failed to create .claude/ directory at: ${claudeDir}`, {
+		throw new AgentError(`Failed to create directory for instruction file at: ${outputDir}`, {
 			agentName: config.agentName,
 			cause: err instanceof Error ? err : undefined,
 		});

package/src/commands/agents.test.ts

@@ -108,6 +108,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		store.upsert(session);
@@ -140,6 +141,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		const scout: AgentSession = {
@@ -159,6 +161,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		store.upsert(builder);
@@ -191,6 +194,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		const completed: AgentSession = {
@@ -210,6 +214,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:02:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		store.upsert(working);

package/src/commands/clean.test.ts

@@ -159,6 +159,7 @@ describe("--all", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -303,6 +304,7 @@ describe("individual flags", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -424,6 +426,7 @@ describe("synthetic session-end events", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 			...overrides,
 		};
 	}

package/src/commands/completions.ts

@@ -356,7 +356,7 @@ export const COMMANDS: readonly CommandDef[] = [
 	},
 	{
 		name: "supervisor",
-		desc: "Per-project supervisor agent",
+		desc: "[DEPRECATED] Per-project supervisor agent",
 		flags: [
 			{ name: "--json", desc: "JSON output" },
 			{ name: "--help", desc: "Show help" },

package/src/commands/coordinator.test.ts

@@ -297,6 +297,7 @@ function makeCoordinatorSession(overrides: Partial<AgentSession> = {}): AgentSes
 		lastActivity: new Date().toISOString(),
 		escalationLevel: 0,
 		stalledSince: null,
+		transcriptPath: null,
 		...overrides,
 	};
 }

package/src/commands/coordinator.ts

@@ -15,13 +15,13 @@
 import { mkdir, unlink } from "node:fs/promises";
 import { join } from "node:path";
 import { Command } from "commander";
-import { deployHooks } from "../agents/hooks-deployer.ts";
 import { createIdentity, loadIdentity } from "../agents/identity.ts";
 import { createManifestLoader, resolveModel } from "../agents/manifest.ts";
 import { loadConfig } from "../config.ts";
 import { AgentError, ValidationError } from "../errors.ts";
 import { jsonOutput } from "../json.ts";
 import { printHint, printSuccess, printWarning } from "../logging/color.ts";
+import { getRuntime } from "../runtimes/registry.ts";
 import { openSessionStore } from "../sessions/compat.ts";
 import { createRunStore } from "../sessions/store.ts";
 import { resolveBackend, trackerCliName } from "../tracker/factory.ts";
@@ -62,6 +62,7 @@ export interface CoordinatorDeps {
 		sendKeys: (name: string, keys: string) => Promise<void>;
 		waitForTuiReady: (
 			name: string,
+			detectReady: (paneContent: string) => import("../runtimes/types.ts").ReadyState,
 			timeoutMs?: number,
 			pollIntervalMs?: number,
 		) => Promise<boolean>;
@@ -318,13 +319,26 @@ async function startCoordinator(
 			store.updateState(COORDINATOR_NAME, "completed");
 		}
 
+		// Resolve model and runtime early (needed for deployConfig and spawn)
+		const manifestLoader = createManifestLoader(
+			join(projectRoot, config.agents.manifestPath),
+			join(projectRoot, config.agents.baseDir),
+		);
+		const manifest = await manifestLoader.load();
+		const resolvedModel = resolveModel(config, manifest, "coordinator", "opus");
+		const runtime = getRuntime(undefined, config);
+
 		// Deploy hooks to the project root so the coordinator gets event logging,
 		// mail check --inject, and activity tracking via the standard hook pipeline.
 		// The ENV_GUARD prefix on all hooks (both template and generated guards)
 		// ensures they only activate when OVERSTORY_AGENT_NAME is set (i.e. for
 		// the coordinator's tmux session), so the user's own Claude Code session
 		// at the project root is unaffected.
-		await deployHooks(projectRoot, COORDINATOR_NAME, "coordinator");
+		await runtime.deployConfig(projectRoot, undefined, {
+			agentName: COORDINATOR_NAME,
+			capability: "coordinator",
+			worktreePath: projectRoot,
+		});
 
 		// Create coordinator identity if first run
 		const identityBaseDir = join(projectRoot, ".overstory", "agents");
@@ -341,14 +355,6 @@ async function startCoordinator(
 			});
 		}
 
-		// Resolve model from config > manifest > fallback
-		const manifestLoader = createManifestLoader(
-			join(projectRoot, config.agents.manifestPath),
-			join(projectRoot, config.agents.baseDir),
-		);
-		const manifest = await manifestLoader.load();
-		const { model, env } = resolveModel(config, manifest, "coordinator", "opus");
-
 		// Preflight: verify tmux is installed before attempting to spawn.
 		// Without this check, a missing tmux leads to cryptic errors later.
 		await tmux.ensureTmuxAvailable();
@@ -359,15 +365,22 @@ async function startCoordinator(
 		// (overstory-gaio, overstory-0kwf).
 		const agentDefPath = join(projectRoot, ".overstory", "agent-defs", "coordinator.md");
 		const agentDefFile = Bun.file(agentDefPath);
-		let claudeCmd = `claude --model ${model} --permission-mode bypassPermissions`;
+		let appendSystemPrompt: string | undefined;
 		if (await agentDefFile.exists()) {
-			const agentDef = await agentDefFile.text();
-			// Single-quote the content for safe shell expansion (only escape single quotes)
-			const escaped = agentDef.replace(/'/g, "'\\''");
-			claudeCmd += ` --append-system-prompt '${escaped}'`;
+			appendSystemPrompt = await agentDefFile.text();
 		}
-		const pid = await tmux.createSession(tmuxSession, projectRoot, claudeCmd, {
-			...env,
+		const spawnCmd = runtime.buildSpawnCommand({
+			model: resolvedModel.model,
+			permissionMode: "bypass",
+			cwd: projectRoot,
+			appendSystemPrompt,
+			env: {
+				...runtime.buildEnv(resolvedModel),
+				OVERSTORY_AGENT_NAME: COORDINATOR_NAME,
+			},
+		});
+		const pid = await tmux.createSession(tmuxSession, projectRoot, spawnCmd, {
+			...runtime.buildEnv(resolvedModel),
 			OVERSTORY_AGENT_NAME: COORDINATOR_NAME,
 		});
 
@@ -392,12 +405,15 @@ async function startCoordinator(
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		store.upsert(session);
 
 		// Wait for Claude Code TUI to render before sending input
-		const tuiReady = await tmux.waitForTuiReady(tmuxSession);
+		const tuiReady = await tmux.waitForTuiReady(tmuxSession, (content) =>
+			runtime.detectReady(content),
+		);
 		if (!tuiReady) {
 			// Session may have died — check liveness before proceeding
 			const alive = await tmux.isSessionAlive(tmuxSession);

package/src/commands/costs.test.ts

@@ -303,7 +303,7 @@ describe("costsCommand", () => {
 			await costsCommand([]);
 			const out = output();
 
-			expect(out).toContain("=".repeat(70));
+			expect(out).toContain("\u2500".repeat(70));
 		});
 
 		test("shows Total row", async () => {
@@ -780,6 +780,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 			sessionStore.close();
 
@@ -836,6 +837,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 			sessionStore.close();
 
@@ -900,6 +902,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 			sessionStore.upsert({
 				id: "sess-002",
@@ -918,6 +921,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 			sessionStore.close();
 
@@ -977,6 +981,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 			sessionStore.close();