@os-eco/overstory-cli 0.7.0 → 0.7.3

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

@@ -9,13 +9,14 @@
  */
 
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdtemp, rm } from "node:fs/promises";
+import { mkdtemp } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { ValidationError } from "../errors.ts";
 import { createEventStore } from "../events/store.ts";
 import { stripAnsi } from "../logging/color.ts";
 import { createSessionStore } from "../sessions/store.ts";
+import { cleanupTempDir } from "../test-helpers.ts";
 import type { InsertEvent } from "../types.ts";
 import { traceCommand } from "./trace.ts";
 
@@ -66,7 +67,7 @@ describe("traceCommand", () => {
 	afterEach(async () => {
 		process.stdout.write = originalWrite;
 		process.chdir(originalCwd);
-		await rm(tempDir, { recursive: true, force: true });
+		await cleanupTempDir(tempDir);
 	});
 
 	function output(): string {
@@ -551,6 +552,7 @@ describe("traceCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 			sessionStore.close();
 

package/src/commands/watch.test.ts

@@ -1,7 +1,8 @@
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdtemp, rm } from "node:fs/promises";
+import { mkdtemp } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { cleanupTempDir } from "../test-helpers.ts";
 import { watchCommand } from "./watch.ts";
 
 /**
@@ -66,7 +67,7 @@ describe("watchCommand", () => {
 		process.stderr.write = originalStderrWrite;
 		process.exitCode = originalExitCode;
 		process.chdir(originalCwd);
-		await rm(tempDir, { recursive: true, force: true });
+		await cleanupTempDir(tempDir);
 	});
 
 	function output(): string {

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

@@ -1,5 +1,5 @@
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdir, mkdtemp, realpath, rm } from "node:fs/promises";
+import { mkdir, mkdtemp, realpath } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { DEFAULT_CONFIG, DEFAULT_QUALITY_GATES, loadConfig, resolveProjectRoot } from "./config.ts";
@@ -14,7 +14,7 @@ describe("loadConfig", () => {
 	});
 
 	afterEach(async () => {
-		await rm(tempDir, { recursive: true, force: true });
+		await cleanupTempDir(tempDir);
 	});
 
 	async function writeConfig(yaml: string): Promise<void> {
@@ -428,7 +428,7 @@ describe("validateConfig", () => {
 	});
 
 	afterEach(async () => {
-		await rm(tempDir, { recursive: true, force: true });
+		await cleanupTempDir(tempDir);
 	});
 
 	async function writeConfig(yaml: string): Promise<void> {

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"];

package/src/doctor/agents.test.ts

@@ -6,9 +6,10 @@
  */
 
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdir, mkdtemp, rm } from "node:fs/promises";
+import { mkdir, mkdtemp } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { cleanupTempDir } from "../test-helpers.ts";
 import type { OverstoryConfig } from "../types.ts";
 import { checkAgents } from "./agents.ts";
 
@@ -74,7 +75,7 @@ describe("checkAgents", () => {
 	});
 
 	afterEach(async () => {
-		await rm(tempDir, { recursive: true, force: true });
+		await cleanupTempDir(tempDir);
 	});
 
 	test("fails when manifest is missing", async () => {

package/src/doctor/consistency.test.ts

@@ -207,6 +207,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -243,6 +244,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -278,6 +280,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -314,6 +317,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -353,6 +357,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -426,6 +431,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 
 		store.upsert({
@@ -445,6 +451,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -481,6 +488,7 @@ describe("checkConsistency", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 		}
 
@@ -501,6 +509,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 
@@ -535,6 +544,7 @@ describe("checkConsistency", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 
 			store.upsert({
@@ -554,6 +564,7 @@ describe("checkConsistency", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				transcriptPath: null,
 			});
 		}
 		store.close();
@@ -597,6 +608,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 
 		store.upsert({
@@ -616,6 +628,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 
 		// Lead-2 has builders only (bad)
@@ -636,6 +649,7 @@ describe("checkConsistency", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			transcriptPath: null,
 		});
 		store.close();
 

package/src/doctor/logs.test.ts

@@ -6,9 +6,10 @@
  */
 
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { cleanupTempDir } from "../test-helpers.ts";
 import type { OverstoryConfig } from "../types.ts";
 import { checkLogs } from "./logs.ts";
 
@@ -77,7 +78,7 @@ describe("checkLogs", () => {
 	});
 
 	afterEach(async () => {
-		await rm(tempDir, { recursive: true, force: true });
+		await cleanupTempDir(tempDir);
 	});
 
 	test("warns when logs/ directory does not exist", async () => {

package/src/doctor/structure.test.ts

@@ -6,9 +6,10 @@
  */
 
 import { afterEach, beforeEach, describe, expect, test } from "bun:test";
-import { mkdir, mkdtemp, rm, utimes } from "node:fs/promises";
+import { mkdir, mkdtemp, utimes } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { cleanupTempDir } from "../test-helpers.ts";
 import type { OverstoryConfig } from "../types.ts";
 import { checkStructure } from "./structure.ts";
 
@@ -73,7 +74,7 @@ describe("checkStructure", () => {
 	});
 
 	afterEach(async () => {
-		await rm(tempDir, { recursive: true, force: true });
+		await cleanupTempDir(tempDir);
 	});
 
 	test("fails when .overstory/ directory does not exist", async () => {

package/src/e2e/init-sling-lifecycle.test.ts

@@ -27,7 +27,6 @@ const EXPECTED_AGENT_DEFS = [
 	"monitor.md",
 	"reviewer.md",
 	"scout.md",
-	"supervisor.md",
 ];
 
 describe("E2E: init→sling lifecycle on external project", () => {
@@ -77,7 +76,7 @@ describe("E2E: init→sling lifecycle on external project", () => {
 		const gitignoreFile = Bun.file(join(overstoryDir, ".gitignore"));
 		expect(await gitignoreFile.exists()).toBe(true);
 
-		// agent-defs/ contains all 8 agent definition files
+		// agent-defs/ contains all 7 agent definition files (supervisor deprecated)
 		const agentDefsDir = join(overstoryDir, "agent-defs");
 		const agentDefFiles = (await readdir(agentDefsDir)).filter((f) => f.endsWith(".md")).sort();
 		expect(agentDefFiles).toEqual(EXPECTED_AGENT_DEFS);
@@ -109,7 +108,7 @@ describe("E2E: init→sling lifecycle on external project", () => {
 		expect(config.project.name).toBeTruthy();
 	});
 
-	test("manifest loads successfully with all 8 agents", async () => {
+	test("manifest loads successfully with all 7 agents (supervisor deprecated)", async () => {
 		await initCommand({});
 
 		const manifestPath = join(tempDir, ".overstory", "agent-manifest.json");
@@ -118,7 +117,7 @@ describe("E2E: init→sling lifecycle on external project", () => {
 
 		const manifest = await loader.load();
 
-		// All 8 agents present
+		// All 7 agents present (supervisor removed: deprecated, use lead instead)
 		const agentNames = Object.keys(manifest.agents).sort();
 		expect(agentNames).toEqual([
 			"builder",
@@ -128,7 +127,6 @@ describe("E2E: init→sling lifecycle on external project", () => {
 			"monitor",
 			"reviewer",
 			"scout",
-			"supervisor",
 		]);
 
 		// Each agent has a valid file reference

package/src/index.ts

@@ -45,7 +45,7 @@ import { OverstoryError, WorktreeError } from "./errors.ts";
 import { jsonError } from "./json.ts";
 import { brand, chalk, muted, setQuiet } from "./logging/color.ts";
 
-export const VERSION = "0.7.0";
+export const VERSION = "0.7.3";
 
 const rawArgs = process.argv.slice(2);
 
@@ -96,6 +96,7 @@ const COMMANDS = [
 	"costs",
 	"metrics",
 	"upgrade",
+	"completions",
 ];
 
 function editDistance(a: string, b: string): number {
@@ -254,6 +255,7 @@ program
 	.option("--force-hierarchy", "Bypass hierarchy validation")
 	.option("--max-agents <n>", "Max children per lead (overrides config)")
 	.option("--skip-review", "Skip review phase for lead agents")
+	.option("--no-scout-check", "Suppress the parentHasScouts scout-before-build warning")
 	.option("--dispatch-max-agents <n>", "Per-lead max agents ceiling (injected into overlay)")
 	.option("--runtime <name>", "Runtime adapter (default: config or claude)")
 	.option("--json", "Output result as JSON")

package/src/logging/color.ts

@@ -10,7 +10,7 @@ import chalk from "chalk";
 // --- Brand palette (os-eco brand colors) ---
 
 /** Forest green — Overstory primary brand color. */
-export const brand = chalk.rgb(27, 94, 32);
+export const brand = chalk.rgb(46, 125, 50);
 
 /** Amber — highlights, warnings. */
 export const accent = chalk.rgb(255, 183, 77);

package/src/logging/format.test.ts

@@ -0,0 +1,110 @@
+import { describe, expect, test } from "bun:test";
+import type { StoredEvent } from "../types.ts";
+import { stripAnsi } from "./color.ts";
+import { formatEventLine, numericPriorityColor } from "./format.ts";
+
+// Minimal StoredEvent fixture for testing formatEventLine
+const BASE_EVENT: StoredEvent = {
+	id: 1,
+	runId: "run-001",
+	agentName: "agent1",
+	sessionId: null,
+	eventType: "tool_start",
+	level: "info",
+	toolName: "bash",
+	toolArgs: null,
+	toolDurationMs: null,
+	data: null,
+	createdAt: "2024-01-15T10:30:45.000Z",
+};
+
+describe("numericPriorityColor", () => {
+	test("returns a function for priority 1", () => {
+		const fn = numericPriorityColor(1);
+		expect(typeof fn).toBe("function");
+		// Function must accept a string and return a string
+		expect(typeof fn("x")).toBe("string");
+	});
+
+	test("returns a function for priority 2", () => {
+		const fn = numericPriorityColor(2);
+		expect(typeof fn).toBe("function");
+		expect(typeof fn("x")).toBe("string");
+	});
+
+	test("priority 3 is identity (returns input unchanged)", () => {
+		const fn = numericPriorityColor(3);
+		// Priority 3 = normal = (text) => text, always identity regardless of chalk level
+		expect(fn("x")).toBe("x");
+		expect(fn("hello world")).toBe("hello world");
+	});
+
+	test("returns a function for priority 4", () => {
+		const fn = numericPriorityColor(4);
+		expect(typeof fn).toBe("function");
+		expect(typeof fn("x")).toBe("string");
+	});
+
+	test("unknown priority returns identity function", () => {
+		const fn = numericPriorityColor(99);
+		expect(typeof fn).toBe("function");
+		expect(fn("x")).toBe("x");
+	});
+
+	test("all priority functions preserve input text (visible content after strip)", () => {
+		for (const p of [1, 2, 3, 4]) {
+			const fn = numericPriorityColor(p);
+			expect(stripAnsi(fn("hello"))).toBe("hello");
+		}
+	});
+});
+
+describe("formatEventLine", () => {
+	test("returns a non-empty string", () => {
+		const colorMap = new Map<string, (t: string) => string>();
+		const result = formatEventLine(BASE_EVENT, colorMap);
+		expect(result.length).toBeGreaterThan(0);
+	});
+
+	test("includes agent name in the result", () => {
+		const colorMap = new Map<string, (t: string) => string>();
+		const result = formatEventLine(BASE_EVENT, colorMap);
+		// Strip ANSI so we can do plain text comparison
+		expect(stripAnsi(result)).toContain("agent1");
+	});
+
+	test("includes time portion (10:30:45) in the result", () => {
+		const colorMap = new Map<string, (t: string) => string>();
+		const result = formatEventLine(BASE_EVENT, colorMap);
+		expect(stripAnsi(result)).toContain("10:30:45");
+	});
+
+	test("result does NOT end with a newline", () => {
+		const colorMap = new Map<string, (t: string) => string>();
+		const result = formatEventLine(BASE_EVENT, colorMap);
+		expect(result.endsWith("\n")).toBe(false);
+	});
+
+	test("error level result is a non-empty string", () => {
+		const colorMap = new Map<string, (t: string) => string>();
+		const errorEvent: StoredEvent = { ...BASE_EVENT, level: "error" };
+		const result = formatEventLine(errorEvent, colorMap);
+		expect(result.length).toBeGreaterThan(0);
+		expect(result.endsWith("\n")).toBe(false);
+	});
+
+	test("uses color from colorMap when agent is registered", () => {
+		const blueColor = (t: string) => `\x1b[34m${t}\x1b[39m`;
+		const colorMap = new Map<string, (t: string) => string>([["agent1", blueColor]]);
+		const result = formatEventLine(BASE_EVENT, colorMap);
+		// The colored agent name should appear in the output
+		expect(result).toContain("\x1b[34m");
+	});
+
+	test("falls back to gray when agent is not in colorMap", () => {
+		const colorMap = new Map<string, (t: string) => string>();
+		// Should not throw — gray fallback is used
+		const result = formatEventLine(BASE_EVENT, colorMap);
+		expect(result.length).toBeGreaterThan(0);
+	});
+});

package/src/logging/format.ts

@@ -8,7 +8,7 @@
 import type { StoredEvent } from "../types.ts";
 import type { ColorFn } from "./color.ts";
 import { color, noColor } from "./color.ts";
-import { AGENT_COLORS } from "./theme.ts";
+import { AGENT_COLORS, eventLabel } from "./theme.ts";
 
 // === Duration ===
 
@@ -175,6 +175,25 @@ export function priorityColor(priority: string): ColorFn {
 	}
 }
 
+/**
+ * Returns a color function for a numeric tracker priority.
+ * 1=urgent (red), 2=high (yellow), 3=normal (identity), 4=low (dim)
+ */
+export function numericPriorityColor(priority: number): ColorFn {
+	switch (priority) {
+		case 1:
+			return color.red;
+		case 2:
+			return color.yellow;
+		case 3:
+			return (text: string) => text;
+		case 4:
+			return color.dim;
+		default:
+			return (text: string) => text;
+	}
+}
+
 /**
  * Returns a color function for a log level string.
  * debug=gray, info=blue, warn=yellow, error=red
@@ -212,3 +231,25 @@ export function logLevelLabel(level: string): string {
 			return level.slice(0, 3).toUpperCase();
 	}
 }
+
+/**
+ * Format a single event as a compact feed line.
+ * Returns the formatted string WITHOUT a trailing newline.
+ * Used by both ov feed and the dashboard Feed panel.
+ */
+export function formatEventLine(event: StoredEvent, colorMap: Map<string, ColorFn>): string {
+	const timeStr = formatAbsoluteTime(event.createdAt);
+	const label = eventLabel(event.eventType);
+	const levelColorFn =
+		event.level === "error" ? color.red : event.level === "warn" ? color.yellow : null;
+	const applyLevel = (text: string) => (levelColorFn ? levelColorFn(text) : text);
+	const detail = buildEventDetail(event, 60);
+	const detailSuffix = detail ? ` ${color.dim(detail)}` : "";
+	const agentColorFn = colorMap.get(event.agentName) ?? color.gray;
+	const agentLabel = ` ${agentColorFn(event.agentName.padEnd(15))}`;
+	return (
+		`${color.dim(timeStr)} ` +
+		`${applyLevel(label.color(color.bold(label.compact)))}` +
+		`${agentLabel}${detailSuffix}`
+	);
+}