@os-eco/overstory-cli 0.7.0 → 0.7.2

package/src/commands/log.ts

@@ -176,6 +176,23 @@ async function resolveTranscriptPath(
 	logsBase: string,
 	agentName: string,
 ): Promise<string | null> {
+	// Check SessionStore for a runtime-provided transcript path
+	try {
+		const { store } = openSessionStore(join(projectRoot, ".overstory"));
+		try {
+			const session = store.getByName(agentName);
+			if (session?.transcriptPath) {
+				if (await Bun.file(session.transcriptPath).exists()) {
+					return session.transcriptPath;
+				}
+			}
+		} finally {
+			store.close();
+		}
+	} catch {
+		// Non-fatal: fall through to legacy resolution
+	}
+
 	// Check cached path first
 	const cachePath = join(logsBase, agentName, ".transcript-path");
 	const cacheFile = Bun.file(cachePath);
@@ -194,6 +211,17 @@ async function resolveTranscriptPath(
 	const directPath = join(claudeProjectsDir, projectKey, `${sessionId}.jsonl`);
 	if (await Bun.file(directPath).exists()) {
 		await Bun.write(cachePath, directPath);
+		// Save discovered path to SessionStore for future lookups
+		try {
+			const { store: writeStore } = openSessionStore(join(projectRoot, ".overstory"));
+			try {
+				writeStore.updateTranscriptPath(agentName, directPath);
+			} finally {
+				writeStore.close();
+			}
+		} catch {
+			// Non-fatal: cache write failure should not break transcript resolution
+		}
 		return directPath;
 	}
 
@@ -205,6 +233,17 @@ async function resolveTranscriptPath(
 			const candidate = join(claudeProjectsDir, project, `${sessionId}.jsonl`);
 			if (await Bun.file(candidate).exists()) {
 				await Bun.write(cachePath, candidate);
+				// Save discovered path to SessionStore for future lookups
+				try {
+					const { store: writeStore } = openSessionStore(join(projectRoot, ".overstory"));
+					try {
+						writeStore.updateTranscriptPath(agentName, candidate);
+					} finally {
+						writeStore.close();
+					}
+				} catch {
+					// Non-fatal: cache write failure should not break transcript resolution
+				}
 				return candidate;
 			}
 		}

package/src/commands/mail.test.ts

@@ -773,6 +773,7 @@ describe("mailCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 				{
 					id: "session-builder-1",
@@ -791,6 +792,7 @@ describe("mailCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 				{
 					id: "session-builder-2",
@@ -809,6 +811,7 @@ describe("mailCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 				{
 					id: "session-scout-1",
@@ -827,6 +830,7 @@ describe("mailCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			];
 
@@ -1147,6 +1151,7 @@ describe("mailCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				});
 			}
 

package/src/commands/monitor.ts

@@ -16,7 +16,6 @@
 import { mkdir } 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";
@@ -111,8 +110,21 @@ async function startMonitor(opts: { json: boolean; attach: boolean }): Promise<v
 			store.updateState(MONITOR_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, "monitor", "sonnet");
+		const runtime = getRuntime(undefined, config);
+
 		// Deploy monitor-specific hooks to the project root's .claude/ directory.
-		await deployHooks(projectRoot, MONITOR_NAME, "monitor");
+		await runtime.deployConfig(projectRoot, undefined, {
+			agentName: MONITOR_NAME,
+			capability: "monitor",
+			worktreePath: projectRoot,
+		});
 
 		// Create monitor identity if first run
 		const identityBaseDir = join(projectRoot, ".overstory", "agents");
@@ -129,15 +141,6 @@ async function startMonitor(opts: { json: boolean; attach: boolean }): Promise<v
 			});
 		}
 
-		// 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 resolvedModel = resolveModel(config, manifest, "monitor", "sonnet");
-		const runtime = getRuntime(undefined, config);
-
 		// Spawn tmux session at project root with Claude Code (interactive mode).
 		const agentDefPath = join(projectRoot, ".overstory", "agent-defs", "monitor.md");
 		const agentDefFile = Bun.file(agentDefPath);
@@ -179,6 +182,7 @@ async function startMonitor(opts: { json: boolean; attach: boolean }): Promise<v
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		store.upsert(session);

package/src/commands/nudge.test.ts

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

package/src/commands/prime.test.ts

@@ -167,6 +167,7 @@ recentTasks:
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			];
 
@@ -204,6 +205,7 @@ recentTasks:
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			];
 

package/src/commands/prime.ts

@@ -38,6 +38,8 @@ const OVERSTORY_GITIGNORE = `# Wildcard+whitelist: ignore everything, whitelist
 export interface PrimeOptions {
 	agent?: string;
 	compact?: boolean;
+	/** Override the instruction path referenced in agent activation context. Defaults to ".claude/CLAUDE.md". */
+	instructionPath?: string;
 }
 
 /**
@@ -138,6 +140,7 @@ async function healGitignore(overstoryDir: string): Promise<void> {
 export async function primeCommand(opts: PrimeOptions): Promise<void> {
 	const agentName = opts.agent ?? null;
 	const compact = opts.compact ?? false;
+	const instructionPath = opts.instructionPath ?? ".claude/CLAUDE.md";
 
 	// 1. Load config
 	const config = await loadConfig(process.cwd());
@@ -161,7 +164,7 @@ export async function primeCommand(opts: PrimeOptions): Promise<void> {
 	// 4. Output context (orchestrator or agent)
 	if (agentName !== null) {
 		// === Agent priming ===
-		await outputAgentContext(config, agentName, compact, expertiseOutput);
+		await outputAgentContext(config, agentName, compact, expertiseOutput, instructionPath);
 	} else {
 		// === Orchestrator priming ===
 		await outputOrchestratorContext(config, compact, expertiseOutput);
@@ -176,6 +179,7 @@ async function outputAgentContext(
 	agentName: string,
 	compact: boolean,
 	expertiseOutput: string | null,
+	instructionPath: string,
 ): Promise<void> {
 	const sections: string[] = [];
 
@@ -226,7 +230,7 @@ async function outputAgentContext(
 	if (boundSession) {
 		sections.push("\n## Activation");
 		sections.push(`You have a bound task: **${boundSession.taskId}**`);
-		sections.push("Read your overlay at `.claude/CLAUDE.md` and begin working immediately.");
+		sections.push(`Read your overlay at \`${instructionPath}\` and begin working immediately.`);
 		sections.push("Do not wait for dispatch mail. Your assignment was bound at spawn time.");
 	}
 

package/src/commands/run.test.ts

@@ -79,6 +79,7 @@ function makeSession(overrides: Partial<AgentSession> = {}): AgentSession {
 		lastActivity: "2026-02-13T10:30:00.000Z",
 		escalationLevel: 0,
 		stalledSince: null,
+		transcriptPath: null,
 		...overrides,
 	};
 }

package/src/commands/sling.test.ts

@@ -369,6 +369,7 @@ function makeBeaconOpts(overrides?: Partial<BeaconOptions>): BeaconOptions {
 		taskId: "overstory-abc",
 		parentAgent: null,
 		depth: 0,
+		instructionPath: ".claude/CLAUDE.md",
 		...overrides,
 	};
 }
@@ -409,12 +410,20 @@ describe("buildBeacon", () => {
 		const opts = makeBeaconOpts({ agentName: "scout-1", taskId: "overstory-xyz" });
 		const beacon = buildBeacon(opts);
 
-		expect(beacon).toContain("read .claude/CLAUDE.md");
+		expect(beacon).toContain(`read ${opts.instructionPath}`);
 		expect(beacon).toContain("mulch prime");
 		expect(beacon).toContain("ov mail check --agent scout-1");
 		expect(beacon).toContain("begin task overstory-xyz");
 	});
 
+	test("uses custom instructionPath in startup instructions", () => {
+		const opts = makeBeaconOpts({ instructionPath: "AGENTS.md" });
+		const beacon = buildBeacon(opts);
+
+		expect(beacon).toContain("read AGENTS.md");
+		expect(beacon).not.toContain(".claude/CLAUDE.md");
+	});
+
 	test("uses agent name in mail check command", () => {
 		const beacon = buildBeacon(makeBeaconOpts({ agentName: "reviewer-beta" }));
 
@@ -1001,6 +1010,7 @@ function makeAutoDispatchOpts(overrides?: Partial<AutoDispatchOptions>): AutoDis
 		capability: "builder",
 		specPath: "/path/to/spec.md",
 		parentAgent: "lead-alpha",
+		instructionPath: ".claude/CLAUDE.md",
 		...overrides,
 	};
 }
@@ -1013,6 +1023,7 @@ describe("buildAutoDispatch", () => {
 			capability: "builder",
 			specPath: "/path/to/spec.md",
 			parentAgent: "lead-alpha",
+			instructionPath: ".claude/CLAUDE.md",
 		});
 		expect(dispatch.from).toBe("lead-alpha");
 		expect(dispatch.to).toBe("builder-1");
@@ -1027,6 +1038,7 @@ describe("buildAutoDispatch", () => {
 			capability: "lead",
 			specPath: null,
 			parentAgent: null,
+			instructionPath: ".claude/CLAUDE.md",
 		});
 		expect(dispatch.from).toBe("orchestrator");
 		expect(dispatch.body).toContain("No spec file");
@@ -1039,6 +1051,7 @@ describe("buildAutoDispatch", () => {
 			capability: "scout",
 			specPath: null,
 			parentAgent: "lead-alpha",
+			instructionPath: ".claude/CLAUDE.md",
 		});
 		expect(dispatch.body).toContain("scout");
 	});
@@ -1050,6 +1063,7 @@ describe("buildAutoDispatch", () => {
 			capability: "builder",
 			specPath: "/abs/path/to/spec.md",
 			parentAgent: "lead-alpha",
+			instructionPath: ".claude/CLAUDE.md",
 		});
 		expect(dispatch.body).toContain("/abs/path/to/spec.md");
 	});

package/src/commands/sling.ts

@@ -20,7 +20,6 @@
 
 import { mkdir } from "node:fs/promises";
 import { join, resolve } from "node:path";
-import { deployHooks } from "../agents/hooks-deployer.ts";
 import { createIdentity, loadIdentity } from "../agents/identity.ts";
 import { createManifestLoader, resolveModel } from "../agents/manifest.ts";
 import { writeOverlay } from "../agents/overlay.ts";
@@ -132,6 +131,7 @@ export interface AutoDispatchOptions {
 	capability: string;
 	specPath: string | null;
 	parentAgent: string | null;
+	instructionPath: string;
 }
 
 /**
@@ -154,7 +154,7 @@ export function buildAutoDispatch(opts: AutoDispatchOptions): {
 	const body = [
 		`You have been assigned task ${opts.taskId} as a ${opts.capability} agent.`,
 		specLine,
-		`Read your overlay at .claude/CLAUDE.md and begin immediately.`,
+		`Read your overlay at ${opts.instructionPath} and begin immediately.`,
 	].join(" ");
 
 	return {
@@ -174,6 +174,7 @@ export interface BeaconOptions {
 	taskId: string;
 	parentAgent: string | null;
 	depth: number;
+	instructionPath: string;
 }
 
 /**
@@ -198,7 +199,7 @@ export function buildBeacon(opts: BeaconOptions): string {
 	const parts = [
 		`[OVERSTORY] ${opts.agentName} (${opts.capability}) ${timestamp} task:${opts.taskId}`,
 		`Depth: ${opts.depth} | Parent: ${parent}`,
-		`Startup: read .claude/CLAUDE.md, run mulch prime, check mail (ov mail check --agent ${opts.agentName}), then begin task ${opts.taskId}`,
+		`Startup: read ${opts.instructionPath}, run mulch prime, check mail (ov mail check --agent ${opts.agentName}), then begin task ${opts.taskId}`,
 	];
 	return parts.join(" — ");
 }
@@ -289,7 +290,7 @@ export function checkParentAgentLimit(
  *
  * When parentAgent is null, the caller is the coordinator or a human.
  * Only "lead" capability is allowed in that case. All other capabilities
- * (builder, scout, reviewer, merger) must be spawned by a lead or supervisor
+ * (builder, scout, reviewer, merger) must be spawned by a lead
  * that passes --parent.
  *
  * @param parentAgent - The --parent flag value (null = coordinator/human)
@@ -629,8 +630,11 @@ export async function slingCommand(taskId: string, opts: SlingOptions): Promise<
 			trackerName: resolvedBackend,
 		};
 
+		// Resolve runtime before writeOverlay so we can pass runtime.instructionPath
+		const runtime = getRuntime(opts.runtime, config);
+
 		try {
-			await writeOverlay(worktreePath, overlayConfig, config.project.root);
+			await writeOverlay(worktreePath, overlayConfig, config.project.root, runtime.instructionPath);
 		} catch (err) {
 			// Clean up the orphaned worktree created in step 7 (overstory-p4st)
 			try {
@@ -646,8 +650,16 @@ export async function slingCommand(taskId: string, opts: SlingOptions): Promise<
 			throw err;
 		}
 
-		// 9. Deploy hooks config (capability-specific guards)
-		await deployHooks(worktreePath, name, capability, config.project.qualityGates);
+		// 9. Resolve runtime + model (needed for deployConfig, spawn, and beacon)
+		const resolvedModel = resolveModel(config, manifest, capability, agentDef.model);
+
+		// 9a. Deploy hooks config (capability-specific guards)
+		await runtime.deployConfig(worktreePath, undefined, {
+			agentName: name,
+			capability,
+			worktreePath,
+			qualityGates: config.project.qualityGates,
+		});
 
 		// 9b. Send auto-dispatch mail so it exists when SessionStart hook fires.
 		// This eliminates the race where coordinator sends dispatch AFTER agent boots.
@@ -657,6 +669,7 @@ export async function slingCommand(taskId: string, opts: SlingOptions): Promise<
 			capability,
 			specPath: absoluteSpecPath,
 			parentAgent,
+			instructionPath: runtime.instructionPath,
 		});
 		const mailStore = createMailStore(join(overstoryDir, "mail.db"));
 		try {
@@ -701,8 +714,6 @@ export async function slingCommand(taskId: string, opts: SlingOptions): Promise<
 
 		// 12. Create tmux session running claude in interactive mode
 		const tmuxSessionName = `overstory-${config.project.name}-${name}`;
-		const resolvedModel = resolveModel(config, manifest, capability, agentDef.model);
-		const runtime = getRuntime(opts.runtime, config);
 		const spawnCmd = runtime.buildSpawnCommand({
 			model: resolvedModel.model,
 			permissionMode: "bypass",
@@ -740,6 +751,7 @@ export async function slingCommand(taskId: string, opts: SlingOptions): Promise<
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		store.upsert(session);
@@ -765,6 +777,7 @@ export async function slingCommand(taskId: string, opts: SlingOptions): Promise<
 			taskId,
 			parentAgent,
 			depth,
+			instructionPath: runtime.instructionPath,
 		});
 		await sendKeys(tmuxSessionName, beacon);
 
@@ -780,20 +793,30 @@ export async function slingCommand(taskId: string, opts: SlingOptions): Promise<
 		// screen (detectReady returns "ready"), resend the beacon. Claude Code's TUI
 		// sometimes consumes the Enter keystroke during late initialization, swallowing
 		// the beacon text entirely (overstory-3271).
-		const verifyAttempts = 5;
-		for (let v = 0; v < verifyAttempts; v++) {
-			await Bun.sleep(2_000);
-			const paneContent = await capturePaneContent(tmuxSessionName);
-			if (paneContent) {
-				const readyState = runtime.detectReady(paneContent);
-				if (readyState.phase !== "ready") {
-					break; // Agent is processing — beacon was received
+		//
+		// Skipped for runtimes that return false from requiresBeaconVerification().
+		// Pi's TUI idle and processing states are indistinguishable via detectReady
+		// (both show "pi v..." header and the token-usage status bar), so the loop
+		// would incorrectly conclude the beacon was not received and spam duplicate
+		// startup messages.
+		const needsVerification =
+			!runtime.requiresBeaconVerification || runtime.requiresBeaconVerification();
+		if (needsVerification) {
+			const verifyAttempts = 5;
+			for (let v = 0; v < verifyAttempts; v++) {
+				await Bun.sleep(2_000);
+				const paneContent = await capturePaneContent(tmuxSessionName);
+				if (paneContent) {
+					const readyState = runtime.detectReady(paneContent);
+					if (readyState.phase !== "ready") {
+						break; // Agent is processing — beacon was received
+					}
 				}
+				// Still at welcome/idle screen — resend beacon
+				await sendKeys(tmuxSessionName, beacon);
+				await Bun.sleep(1_000);
+				await sendKeys(tmuxSessionName, ""); // Follow-up Enter
 			}
-			// Still at welcome/idle screen — resend beacon
-			await sendKeys(tmuxSessionName, beacon);
-			await Bun.sleep(1_000);
-			await sendKeys(tmuxSessionName, ""); // Follow-up Enter
 		}
 
 		// 14. Output result

package/src/commands/status.test.ts

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

package/src/commands/stop.test.ts

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

package/src/commands/supervisor.ts

@@ -15,7 +15,6 @@
 import { mkdir } 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";
@@ -137,8 +136,21 @@ async function startSupervisor(opts: {
 			store.updateState(opts.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, "supervisor", "opus");
+		const runtime = getRuntime(undefined, config);
+
 		// Deploy supervisor-specific hooks to the project root's .claude/ directory.
-		await deployHooks(projectRoot, opts.name, "supervisor");
+		await runtime.deployConfig(projectRoot, undefined, {
+			agentName: opts.name,
+			capability: "supervisor",
+			worktreePath: projectRoot,
+		});
 
 		// Create supervisor identity if first run
 		const identityBaseDir = join(projectRoot, ".overstory", "agents");
@@ -155,15 +167,6 @@ async function startSupervisor(opts: {
 			});
 		}
 
-		// 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 resolvedModel = resolveModel(config, manifest, "supervisor", "opus");
-		const runtime = getRuntime(undefined, config);
-
 		// Spawn tmux session at project root with Claude Code (interactive mode).
 		// Inject the supervisor base definition via --append-system-prompt.
 		const tmuxSession = `overstory-${config.project.name}-supervisor-${opts.name}`;
@@ -225,6 +228,7 @@ async function startSupervisor(opts: {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		};
 
 		store.upsert(session);
@@ -442,7 +446,7 @@ async function statusSupervisor(opts: { name?: string; json: boolean }): Promise
  * Create the Commander command for `ov supervisor`.
  */
 export function createSupervisorCommand(): Command {
-	const cmd = new Command("supervisor").description("Manage per-project supervisor agents");
+	const cmd = new Command("supervisor").description("[DEPRECATED] Per-project supervisor agent");
 
 	cmd
 		.command("start")
@@ -460,6 +464,9 @@ export function createSupervisorCommand(): Command {
 				depth: string;
 				json?: boolean;
 			}) => {
+				console.error(
+					"[DEPRECATED] ov supervisor is deprecated. Use 'ov sling --capability lead' instead.",
+				);
 				await startSupervisor({
 					task: opts.task,
 					name: opts.name,

package/src/commands/trace.test.ts

@@ -551,6 +551,7 @@ describe("traceCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 			sessionStore.close();
 

package/src/commands/worktree.test.ts

@@ -79,6 +79,7 @@ describe("worktreeCommand", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 			...overrides,
 		};
 	}
@@ -167,6 +168,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			]);
 
@@ -214,6 +216,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			]);
 
@@ -308,6 +311,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			]);
 
@@ -363,6 +367,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			]);
 
@@ -401,6 +406,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			]);
 
@@ -455,6 +461,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: new Date().toISOString(),
+					transcriptPath: null,
 				},
 			]);
 
@@ -616,6 +623,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 				{
 					id: "session-2",
@@ -634,6 +642,7 @@ describe("worktreeCommand", () => {
 					lastActivity: new Date().toISOString(),
 					escalationLevel: 0,
 					stalledSince: null,
+					transcriptPath: null,
 				},
 			]);
 

package/src/config.ts

@@ -64,6 +64,14 @@ export const DEFAULT_CONFIG: OverstoryConfig = {
 	},
 	runtime: {
 		default: "claude",
+		pi: {
+			provider: "anthropic",
+			modelMap: {
+				opus: "anthropic/claude-opus-4-6",
+				sonnet: "anthropic/claude-sonnet-4-6",
+				haiku: "anthropic/claude-haiku-4-5",
+			},
+		},
 	},
 };
 
@@ -635,6 +643,27 @@ function validateConfig(config: OverstoryConfig): void {
 		);
 	}
 
+	// runtime.pi: validate provider and modelMap if present
+	if (config.runtime?.pi) {
+		const pi = config.runtime.pi;
+		if (!pi.provider || typeof pi.provider !== "string") {
+			throw new ValidationError("runtime.pi.provider must be a non-empty string", {
+				field: "runtime.pi.provider",
+				value: pi.provider,
+			});
+		}
+		if (pi.modelMap && typeof pi.modelMap === "object") {
+			for (const [alias, qualified] of Object.entries(pi.modelMap)) {
+				if (!qualified || typeof qualified !== "string") {
+					throw new ValidationError(`runtime.pi.modelMap.${alias} must be a non-empty string`, {
+						field: `runtime.pi.modelMap.${alias}`,
+						value: qualified,
+					});
+				}
+			}
+		}
+	}
+
 	// models: validate each value — accepts aliases and provider-prefixed refs
 	const validAliases = ["sonnet", "opus", "haiku"];
 	const toolHeavyRoles = ["builder", "scout"];