@os-eco/overstory-cli 0.6.11 → 0.7.2

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/metrics.test.ts

@@ -443,7 +443,7 @@ describe("formatDuration helper", () => {
 		expect(out).toContain("1h 2m");
 	});
 
-	test("3600000ms formats as 1h 0m", async () => {
+	test("3600000ms formats as 1h", async () => {
 		const dbPath = join(tempDir, ".overstory", "metrics.db");
 		const store = createMetricsStore(dbPath);
 		store.recordSession(makeSession(3_600_000));
@@ -452,6 +452,6 @@ describe("formatDuration helper", () => {
 		await metricsCommand([]);
 		const out = output();
 
-		expect(out).toContain("1h 0m");
+		expect(out).toContain("1h");
 	});
 });

package/src/commands/metrics.ts

@@ -9,6 +9,8 @@ import { join } from "node:path";
 import { Command } from "commander";
 import { loadConfig } from "../config.ts";
 import { jsonOutput } from "../json.ts";
+import { formatDuration } from "../logging/format.ts";
+import { renderHeader } from "../logging/theme.ts";
 import { createMetricsStore } from "../metrics/store.ts";
 
 interface MetricsOpts {
@@ -16,21 +18,6 @@ interface MetricsOpts {
 	json?: boolean;
 }
 
-/**
- * Format milliseconds as human-readable duration.
- */
-function formatDuration(ms: number): string {
-	if (ms === 0) return "0s";
-	const seconds = Math.floor(ms / 1000);
-	if (seconds < 60) return `${seconds}s`;
-	const minutes = Math.floor(seconds / 60);
-	const remainSec = seconds % 60;
-	if (minutes < 60) return `${minutes}m ${remainSec}s`;
-	const hours = Math.floor(minutes / 60);
-	const remainMin = minutes % 60;
-	return `${hours}h ${remainMin}m`;
-}
-
 async function executeMetrics(opts: MetricsOpts): Promise<void> {
 	const limit = opts.last ? Number.parseInt(opts.last, 10) : 20;
 	const json = opts.json ?? false;
@@ -64,8 +51,7 @@ async function executeMetrics(opts: MetricsOpts): Promise<void> {
 			return;
 		}
 
-		process.stdout.write("Session Metrics\n");
-		process.stdout.write(`${"═".repeat(60)}\n\n`);
+		process.stdout.write(`${renderHeader("Session Metrics")}\n\n`);
 
 		// Summary stats
 		const completed = sessions.filter((s) => s.completedAt !== null);

package/src/commands/monitor.ts

@@ -16,13 +16,13 @@
 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";
 import { AgentError, ValidationError } from "../errors.ts";
 import { jsonOutput } from "../json.ts";
 import { printHint, printSuccess } from "../logging/color.ts";
+import { getRuntime } from "../runtimes/registry.ts";
 import { openSessionStore } from "../sessions/compat.ts";
 import type { AgentSession } from "../types.ts";
 import { createSession, isSessionAlive, killSession, sendKeys } from "../worktree/tmux.ts";
@@ -110,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");
@@ -128,25 +141,25 @@ 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 { model, env } = resolveModel(config, manifest, "monitor", "sonnet");
-
 		// 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);
-		let claudeCmd = `claude --model ${model} --permission-mode bypassPermissions`;
+		let appendSystemPrompt: string | undefined;
 		if (await agentDefFile.exists()) {
-			const agentDef = await agentDefFile.text();
-			const escaped = agentDef.replace(/'/g, "'\\''");
-			claudeCmd += ` --append-system-prompt '${escaped}'`;
+			appendSystemPrompt = await agentDefFile.text();
 		}
-		const pid = await createSession(tmuxSession, projectRoot, claudeCmd, {
-			...env,
+		const spawnCmd = runtime.buildSpawnCommand({
+			model: resolvedModel.model,
+			permissionMode: "bypass",
+			cwd: projectRoot,
+			appendSystemPrompt,
+			env: {
+				...runtime.buildEnv(resolvedModel),
+				OVERSTORY_AGENT_NAME: MONITOR_NAME,
+			},
+		});
+		const pid = await createSession(tmuxSession, projectRoot, spawnCmd, {
+			...runtime.buildEnv(resolvedModel),
 			OVERSTORY_AGENT_NAME: MONITOR_NAME,
 		});
 
@@ -169,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/replay.test.ts

@@ -228,7 +228,7 @@ describe("replayCommand", () => {
 			await replayCommand(["--run", "run-001"]);
 			const out = output();
 
-			expect(out).toContain("=".repeat(70));
+			expect(out).toContain("─".repeat(70));
 		});
 
 		test("shows event count", async () => {
@@ -742,7 +742,7 @@ describe("replayCommand", () => {
 			const out = output();
 
 			expect(out).not.toContain(longValue);
-			expect(out).toContain("...");
+			expect(out).toContain("…");
 		});
 	});
 });

package/src/commands/replay.ts

@@ -12,135 +12,16 @@ import { loadConfig } from "../config.ts";
 import { ValidationError } from "../errors.ts";
 import { createEventStore } from "../events/store.ts";
 import { jsonOutput } from "../json.ts";
-import type { ColorFn } from "../logging/color.ts";
 import { color } from "../logging/color.ts";
-import type { EventType, StoredEvent } from "../types.ts";
-
-/** Labels and colors for each event type. */
-const EVENT_LABELS: Record<EventType, { label: string; color: ColorFn }> = {
-	tool_start: { label: "TOOL START", color: color.blue },
-	tool_end: { label: "TOOL END  ", color: color.blue },
-	session_start: { label: "SESSION  +", color: color.green },
-	session_end: { label: "SESSION  -", color: color.yellow },
-	mail_sent: { label: "MAIL SENT ", color: color.cyan },
-	mail_received: { label: "MAIL RECV ", color: color.cyan },
-	spawn: { label: "SPAWN     ", color: color.magenta },
-	error: { label: "ERROR     ", color: color.red },
-	custom: { label: "CUSTOM    ", color: color.gray },
-};
-
-/** Color functions assigned to agents in order of first appearance. */
-const AGENT_COLORS: readonly ColorFn[] = [
-	color.blue,
-	color.green,
-	color.yellow,
-	color.cyan,
-	color.magenta,
-];
-
-/**
- * Format a relative time string from a timestamp.
- * Returns strings like "2m ago", "1h ago", "3d ago".
- */
-function formatRelativeTime(timestamp: string): string {
-	const eventTime = new Date(timestamp).getTime();
-	const now = Date.now();
-	const diffMs = now - eventTime;
-
-	if (diffMs < 0) return "just now";
-
-	const seconds = Math.floor(diffMs / 1000);
-	if (seconds < 60) return `${seconds}s ago`;
-
-	const minutes = Math.floor(seconds / 60);
-	if (minutes < 60) return `${minutes}m ago`;
-
-	const hours = Math.floor(minutes / 60);
-	if (hours < 24) return `${hours}h ago`;
-
-	const days = Math.floor(hours / 24);
-	return `${days}d ago`;
-}
-
-/**
- * Format an absolute time from an ISO timestamp.
- * Returns "HH:MM:SS" portion.
- */
-function formatAbsoluteTime(timestamp: string): string {
-	const match = /T(\d{2}:\d{2}:\d{2})/.exec(timestamp);
-	if (match?.[1]) {
-		return match[1];
-	}
-	return timestamp;
-}
-
-/**
- * Format the date portion of an ISO timestamp.
- * Returns "YYYY-MM-DD".
- */
-function formatDate(timestamp: string): string {
-	const match = /^(\d{4}-\d{2}-\d{2})/.exec(timestamp);
-	if (match?.[1]) {
-		return match[1];
-	}
-	return "";
-}
-
-/**
- * Build a detail string for a timeline event based on its type and fields.
- */
-function buildEventDetail(event: StoredEvent): string {
-	const parts: string[] = [];
-
-	if (event.toolName) {
-		parts.push(`tool=${event.toolName}`);
-	}
-
-	if (event.toolDurationMs !== null) {
-		parts.push(`duration=${event.toolDurationMs}ms`);
-	}
-
-	if (event.data) {
-		try {
-			const parsed: unknown = JSON.parse(event.data);
-			if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
-				const data = parsed as Record<string, unknown>;
-				for (const [key, value] of Object.entries(data)) {
-					if (value !== null && value !== undefined) {
-						const strValue = typeof value === "string" ? value : JSON.stringify(value);
-						// Truncate long values
-						const truncated = strValue.length > 80 ? `${strValue.slice(0, 77)}...` : strValue;
-						parts.push(`${key}=${truncated}`);
-					}
-				}
-			}
-		} catch {
-			// data is not valid JSON; show it raw if short enough
-			if (event.data.length <= 80) {
-				parts.push(event.data);
-			}
-		}
-	}
-
-	return parts.join(" ");
-}
-
-/**
- * Assign a stable color function to each agent based on order of first appearance.
- */
-function buildAgentColorMap(events: StoredEvent[]): Map<string, ColorFn> {
-	const colorMap = new Map<string, ColorFn>();
-	for (const event of events) {
-		if (!colorMap.has(event.agentName)) {
-			const colorIndex = colorMap.size % AGENT_COLORS.length;
-			const agentColorFn = AGENT_COLORS[colorIndex];
-			if (agentColorFn !== undefined) {
-				colorMap.set(event.agentName, agentColorFn);
-			}
-		}
-	}
-	return colorMap;
-}
+import {
+	buildAgentColorMap,
+	buildEventDetail,
+	formatAbsoluteTime,
+	formatDate,
+	formatRelativeTime,
+} from "../logging/format.ts";
+import { eventLabel, renderHeader } from "../logging/theme.ts";
+import type { StoredEvent } from "../types.ts";
 
 /**
  * Print events as an interleaved timeline with ANSI colors and agent labels.
@@ -148,8 +29,7 @@ function buildAgentColorMap(events: StoredEvent[]): Map<string, ColorFn> {
 function printReplay(events: StoredEvent[], useAbsoluteTime: boolean): void {
 	const w = process.stdout.write.bind(process.stdout);
 
-	w(`${color.bold("Replay")}\n`);
-	w(`${"=".repeat(70)}\n`);
+	w(`${renderHeader("Replay")}\n`);
 
 	if (events.length === 0) {
 		w(`${color.dim("No events found.")}\n`);
@@ -176,10 +56,7 @@ function printReplay(events: StoredEvent[], useAbsoluteTime: boolean): void {
 			? formatAbsoluteTime(event.createdAt)
 			: formatRelativeTime(event.createdAt);
 
-		const eventInfo = EVENT_LABELS[event.eventType] ?? {
-			label: event.eventType.padEnd(10),
-			color: color.gray,
-		};
+		const label = eventLabel(event.eventType);
 
 		const levelColorFn =
 			event.level === "error" ? color.red : event.level === "warn" ? color.yellow : null;
@@ -193,7 +70,7 @@ function printReplay(events: StoredEvent[], useAbsoluteTime: boolean): void {
 
 		w(
 			`${color.dim(timeStr.padStart(10))} ` +
-				`${applyLevel(eventInfo.color(color.bold(eventInfo.label)))}` +
+				`${applyLevel(label.color(color.bold(label.full)))}` +
 				`${agentLabel}${detailSuffix}\n`,
 		);
 	}

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/run.ts

@@ -17,24 +17,11 @@ import { loadConfig } from "../config.ts";
 import { ValidationError } from "../errors.ts";
 import { jsonError, jsonOutput } from "../json.ts";
 import { accent, printError, printHint, printSuccess } from "../logging/color.ts";
+import { formatDuration } from "../logging/format.ts";
+import { renderHeader, separator } from "../logging/theme.ts";
 import { createRunStore, createSessionStore } from "../sessions/store.ts";
 import type { AgentSession, Run } from "../types.ts";
 
-/**
- * Format milliseconds as human-readable duration.
- */
-function formatDuration(ms: number): string {
-	if (ms === 0) return "0s";
-	const seconds = Math.floor(ms / 1000);
-	if (seconds < 60) return `${seconds}s`;
-	const minutes = Math.floor(seconds / 60);
-	const remainSec = seconds % 60;
-	if (minutes < 60) return `${minutes}m ${remainSec}s`;
-	const hours = Math.floor(minutes / 60);
-	const remainMin = minutes % 60;
-	return `${hours}h ${remainMin}m`;
-}
-
 /**
  * Get the path to the current-run.txt file.
  */
@@ -109,8 +96,7 @@ async function showCurrentRun(overstoryDir: string, json: boolean): Promise<void
 			return;
 		}
 
-		process.stdout.write("Current Run\n");
-		process.stdout.write(`${"=".repeat(50)}\n`);
+		process.stdout.write(`${renderHeader("Current Run")}\n`);
 		process.stdout.write(`  ID:       ${accent(run.id)}\n`);
 		process.stdout.write(`  Status:   ${run.status}\n`);
 		process.stdout.write(`  Started:  ${run.startedAt}\n`);
@@ -151,12 +137,11 @@ async function listRuns(overstoryDir: string, limit: number, json: boolean): Pro
 			return;
 		}
 
-		process.stdout.write("Recent Runs\n");
-		process.stdout.write(`${"=".repeat(70)}\n`);
+		process.stdout.write(`${renderHeader("Recent Runs")}\n`);
 		process.stdout.write(
 			`${"ID".padEnd(36)} ${"Status".padEnd(10)} ${"Agents".padEnd(7)} Duration\n`,
 		);
-		process.stdout.write(`${"-".repeat(70)}\n`);
+		process.stdout.write(`${separator()}\n`);
 
 		for (const run of runs) {
 			const id = accent(run.id.length > 35 ? `${run.id.slice(0, 32)}...` : run.id.padEnd(36));
@@ -245,8 +230,7 @@ async function showRun(overstoryDir: string, runId: string, json: boolean): Prom
 			return;
 		}
 
-		process.stdout.write("Run Details\n");
-		process.stdout.write(`${"=".repeat(60)}\n`);
+		process.stdout.write(`${renderHeader("Run Details")}\n`);
 		process.stdout.write(`  ID:       ${accent(run.id)}\n`);
 		process.stdout.write(`  Status:   ${run.status}\n`);
 		process.stdout.write(`  Started:  ${run.startedAt}\n`);
@@ -258,7 +242,7 @@ async function showRun(overstoryDir: string, runId: string, json: boolean): Prom
 
 		if (agents.length > 0) {
 			process.stdout.write(`\nAgents (${agents.length}):\n`);
-			process.stdout.write(`${"-".repeat(60)}\n`);
+			process.stdout.write(`${separator()}\n`);
 			for (const agent of agents) {
 				const agentDuration = formatAgentDuration(agent);
 				process.stdout.write(

package/src/commands/sling.test.ts

@@ -1,6 +1,8 @@
 import { describe, expect, test } from "bun:test";
 import { resolveModel, resolveProviderEnv } from "../agents/manifest.ts";
 import { HierarchyError } from "../errors.ts";
+import { ClaudeRuntime } from "../runtimes/claude.ts";
+import { getRuntime } from "../runtimes/registry.ts";
 import type { AgentManifest, OverstoryConfig } from "../types.ts";
 import {
 	type AutoDispatchOptions,
@@ -367,6 +369,7 @@ function makeBeaconOpts(overrides?: Partial<BeaconOptions>): BeaconOptions {
 		taskId: "overstory-abc",
 		parentAgent: null,
 		depth: 0,
+		instructionPath: ".claude/CLAUDE.md",
 		...overrides,
 	};
 }
@@ -407,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" }));
 
@@ -999,6 +1010,7 @@ function makeAutoDispatchOpts(overrides?: Partial<AutoDispatchOptions>): AutoDis
 		capability: "builder",
 		specPath: "/path/to/spec.md",
 		parentAgent: "lead-alpha",
+		instructionPath: ".claude/CLAUDE.md",
 		...overrides,
 	};
 }
@@ -1011,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");
@@ -1025,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");
@@ -1037,6 +1051,7 @@ describe("buildAutoDispatch", () => {
 			capability: "scout",
 			specPath: null,
 			parentAgent: "lead-alpha",
+			instructionPath: ".claude/CLAUDE.md",
 		});
 		expect(dispatch.body).toContain("scout");
 	});
@@ -1048,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");
 	});
@@ -1080,3 +1096,54 @@ describe("buildAutoDispatch", () => {
  * Integration coverage: The beacon loop has been validated through production
  * agent spawns. Failure mode is agents stuck at welcome screen (overstory-3271).
  */
+
+describe("sling runtime integration", () => {
+	test("runtime.buildSpawnCommand produces identical command to old hardcoded string", () => {
+		const runtime = getRuntime("claude");
+		const cmd = runtime.buildSpawnCommand({
+			model: "sonnet",
+			permissionMode: "bypass",
+			cwd: "/tmp/worktree",
+			env: {},
+		});
+		expect(cmd).toBe("claude --model sonnet --permission-mode bypassPermissions");
+	});
+
+	test("runtime.buildSpawnCommand with opus model", () => {
+		const runtime = getRuntime("claude");
+		const cmd = runtime.buildSpawnCommand({
+			model: "opus",
+			permissionMode: "bypass",
+			cwd: "/tmp/worktree",
+			env: {},
+		});
+		expect(cmd).toBe("claude --model opus --permission-mode bypassPermissions");
+	});
+
+	test("runtime.buildEnv returns empty object for native model", () => {
+		const runtime = new ClaudeRuntime();
+		const env = runtime.buildEnv({ model: "sonnet" });
+		expect(env).toEqual({});
+	});
+
+	test("runtime.buildEnv passes through provider env vars", () => {
+		const runtime = new ClaudeRuntime();
+		const env = runtime.buildEnv({
+			model: "sonnet",
+			env: { ANTHROPIC_BASE_URL: "https://example.com" },
+		});
+		expect(env).toEqual({ ANTHROPIC_BASE_URL: "https://example.com" });
+	});
+
+	test("runtime.detectReady returns ready for idle Claude prompt", () => {
+		const runtime = new ClaudeRuntime();
+		const state = runtime.detectReady('Try "hello world"\n\nbypass permissions');
+		expect(state.phase).toBe("ready");
+	});
+
+	test("runtime.detectReady returns loading when agent is processing", () => {
+		const runtime = new ClaudeRuntime();
+		const state = runtime.detectReady("Running tool: Read\nbypass permissions");
+		expect(state.phase).toBe("loading");
+	});
+});