pi-crew 0.9.50 → 0.9.52

package/src/ui/snapshot-types.ts

@@ -1,90 +0,0 @@
-import type { CrewAgentRecord } from "../runtime/crew-agent-runtime.ts";
-import type { TeamEvent } from "../state/event-log.ts";
-import type { TeamRunManifest, TeamTaskState } from "../state/types.ts";
-import type { DwfPhaseState } from "./dwf-phase-display.ts";
-
-export interface RunUiProgress {
-	total: number;
-	completed: number;
-	running: number;
-	failed: number;
-	queued: number;
-	waiting?: number;
-	cancelled?: number;
-	skipped?: number;
-	needsAttention?: number;
-}
-
-export interface RunUiUsage {
-	tokensIn: number;
-	tokensOut: number;
-	toolUses: number;
-}
-
-export interface RunUiMailbox {
-	inboxUnread: number;
-	outboxPending: number;
-	needsAttention: number;
-	/** Urgent steering messages count. Default 0. */
-	steerUnread?: number;
-	/** Follow-up / continuation messages count. Default 0. */
-	followUpUnread?: number;
-	/** Response / reply messages count. Default 0. */
-	responseUnread?: number;
-	/** Generic messages count. Default 0. */
-	messageUnread?: number;
-	/** True when counts come from bounded tail reads and older messages may be omitted. */
-	approximate?: boolean;
-}
-
-export interface RunUiGroupJoin {
-	requestId: string;
-	messageId: string;
-	partial: boolean;
-	ack: "pending" | "acknowledged";
-}
-
-export interface RunUiSnapshot {
-	runId: string;
-	cwd: string;
-	fetchedAt: number;
-	signature: string;
-	/**
-	 * 1.6 / 1.7 — per-slice signatures so dashboard panes can short-circuit
-	 * their own render when the slice they care about hasn't changed:
-	 *
-	 *     if (snapshot.sliceSignatures?.tasks === lastTaskSig) return cached;
-	 *
-	 * Optional for backwards-compat; consumers fall back to the full
-	 * `signature` when the field is missing.
-	 */
-	sliceSignatures?: {
-		tasks: string;
-		agents: string;
-		mailbox: string;
-		progress: string;
-		events: string;
-	};
-	manifest: TeamRunManifest;
-	tasks: TeamTaskState[];
-	agents: CrewAgentRecord[];
-	progress: RunUiProgress;
-	usage: RunUiUsage;
-	mailbox: RunUiMailbox;
-	groupJoins?: RunUiGroupJoin[];
-	/** Structured cancellation reason from run.cancelled event data, when available. */
-	cancellationReason?: string;
-	/** DWF phase state derived from `recentEvents`. Null/absent for non-DWF runs. */
-	dwfPhaseState?: DwfPhaseState | null;
-	recentEvents: TeamEvent[];
-	recentOutputLines: string[];
-}
-
-export interface RunSnapshotCache {
-	get(runId: string): RunUiSnapshot | undefined;
-	refresh(runId: string): RunUiSnapshot;
-	refreshIfStale(runId: string): RunUiSnapshot;
-	invalidate(runId?: string): void;
-	snapshotsByKey(): Map<string, RunUiSnapshot>;
-	dispose?(): void;
-}

package/src/ui/spinner.ts

@@ -1,17 +0,0 @@
-export const SUBAGENT_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const;
-export const SUBAGENT_SPINNER_FRAME_MS = 160;
-
-export function spinnerBucket(now = Date.now(), frameMs = SUBAGENT_SPINNER_FRAME_MS): number {
-	return Math.floor(now / Math.max(1, frameMs));
-}
-
-function hashKey(key: string): number {
-	let hash = 0;
-	for (let index = 0; index < key.length; index += 1) hash = (hash * 31 + key.charCodeAt(index)) >>> 0;
-	return hash;
-}
-
-export function spinnerFrame(key = "", now = Date.now()): string {
-	const offset = key ? hashKey(key) % SUBAGENT_SPINNER_FRAMES.length : 0;
-	return SUBAGENT_SPINNER_FRAMES[(spinnerBucket(now) + offset) % SUBAGENT_SPINNER_FRAMES.length] ?? SUBAGENT_SPINNER_FRAMES[0];
-}

package/src/ui/status-colors.ts

@@ -1,143 +0,0 @@
-import type { CrewTheme, CrewThemeColor } from "./theme-adapter.ts";
-
-export type RunStatus =
-	| "queued"
-	| "running"
-	| "waiting"
-	| "completed"
-	| "failed"
-	| "cancelled"
-	| "stopped"
-	| "blocked"
-	| "stale"
-	| "needs_attention"
-	| (string & {});
-
-export function colorForStatus(status: RunStatus): CrewThemeColor {
-	switch (status) {
-		case "running":
-			return "accent";
-		case "waiting":
-			return "muted";
-		case "completed":
-			return "success";
-		case "failed":
-		case "stale":
-			return "error";
-		case "cancelled":
-		case "blocked":
-		case "stopped":
-			return "warning";
-		case "needs_attention":
-			return "warning";
-		case "queued":
-		default:
-			return "dim";
-	}
-}
-
-export function iconForStatus(status: RunStatus, options?: { runningGlyph?: string }): string {
-	const glyph = options?.runningGlyph ?? "▶";
-	switch (status) {
-		case "completed":
-			return "✓";
-		case "failed":
-		case "stale":
-			return "✗";
-		case "cancelled":
-		case "stopped":
-			return "■";
-		case "running":
-			return glyph;
-		case "waiting":
-			return "⏳";
-		case "queued":
-			return "◦";
-		case "blocked":
-			return "⏸";
-		case "needs_attention":
-			return "⚠";
-		default:
-			return "·";
-	}
-}
-
-/** @internal */
-function colorForActivity(activityState: string | undefined): CrewThemeColor {
-	if (activityState === "needs_attention") return "warning";
-	if (activityState === "stale") return "error";
-	return "dim";
-}
-
-export function applyStatusColor(theme: CrewTheme, status: RunStatus, text: string): string {
-	return theme.fg(colorForStatus(status), text);
-}
-
-/**
- * Shared glyph→color map for status glyphs embedded in rendered lines.
- * Consolidates the duplicated `statusGlyphColor` (widget-renderer.ts) and
- * `iconColor` (live-run-sidebar.ts) maps into a single source of truth.
- *
- * Covers ALL status glyphs, including the two previously-missing ones:
- *   ⏳ (waiting) → muted, ⚠ (needs_attention) → warning
- * and the braille spinner range U+2800–U+28FF (⠁–⣿) → accent (V-3).
- */
-function glyphColor(glyph: string): CrewThemeColor {
-	// Braille Patterns block (U+2800–U+28FF) — running animation frames.
-	const code = glyph.codePointAt(0) ?? 0;
-	if (code >= 0x2800 && code <= 0x28ff) return "accent";
-	switch (glyph) {
-		case "✓":
-			return "success";
-		case "✗":
-			return "error";
-		case "■":
-		case "⏸":
-		case "⚠":
-			return "warning";
-		case "⏳":
-			return "muted";
-		case "◦":
-		case "·":
-			return "dim";
-		case "▶":
-		default:
-			return "accent";
-	}
-}
-
-/**
- * Status glyph characters used in the fast-path check.
- */
-const STATUS_GLYPH_CHARS = "\u2713\u2717\u25a0\u23f8\u25e6\u00b7\u25b6\u23f3\u26a0";
-
-/**
- * Colorize status glyphs embedded in a rendered line. Wraps every status glyph
- * (✓ ✗ ■ ⏸ ⏳ ⚠ ◦ · ▶ and braille spinner frames ⠁–⣿) in the appropriate theme
- * color, leaving surrounding text untouched.
- *
- * Replaces the duplicated per-module glyph colorizers in widget-renderer.ts
- * and live-run-sidebar.ts with a single shared helper (F-1, F-2, V-3).
- */
-export function colorizeStatusGlyphs(line: string, theme: CrewTheme): string {
-	// Fast path: skip regex if line contains no status glyphs at all.
-	let hasGlyph = false;
-	for (let i = 0; i < STATUS_GLYPH_CHARS.length; i++) {
-		if (line.indexOf(STATUS_GLYPH_CHARS[i]) !== -1) {
-			hasGlyph = true;
-			break;
-		}
-	}
-	if (!hasGlyph) {
-		// Check for braille range (U+2800–U+28FF)
-		for (let i = 0; i < line.length; i++) {
-			const cp = line.codePointAt(i)!;
-			if (cp >= 0x2800 && cp <= 0x28ff) {
-				hasGlyph = true;
-				break;
-			}
-		}
-	}
-	if (!hasGlyph) return line;
-	return line.replace(/[✓✗■⏸◦·▶⏳⚠]|[\u2800-\u28FF]/g, (glyph) => theme.fg(glyphColor(glyph), glyph));
-}

package/src/ui/syntax-highlight.ts

@@ -1,136 +0,0 @@
-/**
- * Syntax highlighting for pi-crew UI.
- *
- * Uses cli-highlight (sync) with the active Pi theme's syntax colors.
- * Falls back to plain text (theme.fg on every line) if the language is
- * unsupported or highlighting fails.
- */
-import { highlight, supportsLanguage } from "cli-highlight";
-import type { CrewTheme } from "./theme-adapter.ts";
-import { asCrewTheme } from "./theme-adapter.ts";
-
-// ── cli-highlight theme bridge ──────────────────────────────────────────
-
-function buildCliTheme(theme: CrewTheme): Record<string, (text: string) => string> {
-	return {
-		keyword: (text) => theme.fg("syntaxKeyword", text),
-		built_in: (text) => theme.fg("syntaxType", text),
-		literal: (text) => theme.fg("syntaxNumber", text),
-		number: (text) => theme.fg("syntaxNumber", text),
-		string: (text) => theme.fg("syntaxString", text),
-		comment: (text) => theme.fg("syntaxComment", text),
-		function: (text) => theme.fg("syntaxFunction", text),
-		title: (text) => theme.fg("syntaxFunction", text),
-		class: (text) => theme.fg("syntaxType", text),
-		type: (text) => theme.fg("syntaxType", text),
-		attr: (text) => theme.fg("syntaxVariable", text),
-		variable: (text) => theme.fg("syntaxVariable", text),
-		params: (text) => theme.fg("syntaxVariable", text),
-		operator: (text) => theme.fg("syntaxOperator", text),
-		punctuation: (text) => theme.fg("syntaxPunctuation", text),
-	};
-}
-
-function hlCliSync(code: string, language: string | undefined, theme: CrewTheme): string {
-	if (!language) {
-		return code
-			.split("\n")
-			.map((line) => theme.fg("mdCodeBlock", line))
-			.join("\n");
-	}
-	try {
-		return highlight(code, {
-			language,
-			ignoreIllegals: true,
-			theme: buildCliTheme(theme),
-		}).trimEnd();
-	} catch {
-		return code
-			.split("\n")
-			.map((line) => theme.fg("mdCodeBlock", line))
-			.join("\n");
-	}
-}
-
-// ── Language detection ──────────────────────────────────────────────────
-
-export const languageMap: Record<string, string> = {
-	ts: "typescript",
-	tsx: "typescript",
-	js: "javascript",
-	jsx: "javascript",
-	mjs: "javascript",
-	cjs: "javascript",
-	py: "python",
-	md: "markdown",
-	markdown: "markdown",
-	json: "json",
-	yml: "yaml",
-	yaml: "yaml",
-	toml: "yaml",
-	html: "html",
-	htm: "html",
-	css: "css",
-	scss: "scss",
-	sass: "sass",
-	bash: "bash",
-	sh: "bash",
-	zsh: "bash",
-	fish: "bash",
-	ps1: "powershell",
-	sql: "sql",
-	rust: "rust",
-	rb: "ruby",
-	go: "go",
-	java: "java",
-	kt: "kotlin",
-	cpp: "cpp",
-	cc: "cpp",
-	cxx: "cpp",
-	hpp: "cpp",
-	c: "c",
-	h: "c",
-	cs: "csharp",
-	php: "php",
-};
-
-/** @internal */
-function detectLanguageFromPath(filePath: string): string | undefined {
-	const ext = filePath.split(".").pop()?.toLowerCase();
-	if (!ext) return undefined;
-	return languageMap[ext];
-}
-
-// ── Public API ──────────────────────────────────────────────────────────
-
-export function highlightCode(code: string, language: string | undefined, themeLike: unknown = undefined): string {
-	const theme = asCrewTheme(themeLike);
-	const validLanguage = language && supportsLanguage(language) ? language : undefined;
-	return hlCliSync(code, validLanguage, theme);
-}
-
-export function highlightJson(payload: string, themeLike: unknown = undefined): string {
-	const theme = asCrewTheme(themeLike);
-	try {
-		return highlight(payload, {
-			language: "json",
-			ignoreIllegals: true,
-			theme: buildCliTheme(theme),
-		}).trimEnd();
-	} catch {
-		try {
-			const parsed = JSON.parse(payload);
-			return JSON.stringify(parsed, null, 2)
-				.split("\n")
-				.map((line) => theme.fg("mdCodeBlock", line))
-				.join("\n");
-		} catch {
-			return payload
-				.split("\n")
-				.map((line) => theme.fg("mdCodeBlock", line))
-				.join("\n");
-		}
-	}
-}
-
-export { detectLanguageFromPath };

package/src/ui/terminal-status.ts

@@ -1,269 +0,0 @@
-/**
- * Terminal tab title + Ghostty native progress bar.
- *
- * Distilled from pi-status (Thinkscape — `source/pi-status/src/index.ts`):
- * two UI channels pi-crew didn't use before, both surviving subprocess and
- * visible even when the TUI isn't in focus:
- *
- * 1. **Tab title** via `ctx.ui.setTitle()` — shows a one-line crew run summary
- *    (e.g. "π-crew · 2 active · explorer, executor"). Cheap, works in any
- *    terminal. pi-status restores the title on idle with an exponential
- *    back-off re-assert loop (pi itself re-sets the title on some events).
- * 2. **Ghostty OSC 9;4** native progress bar — written to `/dev/tty` (a
- *    separate channel from pi's TUI, so it works even when pi runs in a
- *    subprocess). state 3 = indeterminate pulsing while runs are active;
- *    state 1 value 100 = green completion flash; state 0 = clear. Compatible
- *    with all libghostty-based terminals (Ghostty, cmux, muxy).
- *
- * All writes are BEST-EFFORT: `/dev/tty` may be absent (non-interactive /
- * subagent / CI context) and `setTitle` may be unavailable — failures are
- * swallowed and never surface to the user. This module is purely additive:
- * it cannot regress existing behavior because nothing depends on it.
- *
- * Lifecycle (wired from register.ts via runEventBus + turn events):
- *   - run active (running/queued/planning) → title "π-crew · N active · <roles>",
- *     Ghostty state 3 (indeterminate).
- *   - run just completed → Ghostty state 1/100 (green flash), schedule clear.
- *   - idle (no active runs) → restore pi's natural title, Ghostty state 0.
- *
- * @module terminal-status
- */
-
-import { writeFileSync } from "node:fs";
-import { listLiveAgents } from "../runtime/live-agent-manager.ts";
-
-/**
- * Minimal UI surface this module needs. Deliberately narrower than
- * `ExtensionContext["ui"]` so it's trivial to mock in tests (dependency
- * inversion: depend only on what you use).
- */
-export interface TerminalStatusUi {
-	hasUI: boolean;
-	ui: { setTitle(title: string): void };
-}
-
-/** Ghostty OSC 9;4 progress states. */
-export const GHOSTTY_PROGRESS = {
-	CLEAR: 0, // remove the progress indicator
-	SET: 1, // set explicit progress (0-100)
-	ERROR: 2, // error state
-	INDETERMINATE: 3, // pulsing/working animation
-} as const;
-
-/** Title prefix so the source is identifiable in the tab. */
-const TITLE_PREFIX = "π-crew";
-/** Separator between summary segments. */
-const SEP = " · ";
-/** Max roles listed in the title (keep it short for narrow tabs). */
-const MAX_TITLE_ROLES = 3;
-
-/** Idle-reassert backoff bounds (mirrors pi-status, clamped). */
-const IDLE_REASSERT_START_MS = 200;
-const IDLE_REASSERT_MAX_MS = 5000;
-/** How long the green completion flash stays before clearing. */
-const COMPLETE_FLASH_MS = 1500;
-
-/** Injected for tests (defaults write to the real /dev/tty). */
-export type GhosttyWriter = (seq: string) => void;
-
-let ghosttyWriter: GhosttyWriter | undefined;
-
-/**
- * Set the raw-sequence writer (test seam). Pass `undefined` to restore the
- * default `/dev/tty` writer. Tests inject a buffer-capturing fn.
- */
-export function setGhosttyWriterForTest(writer: GhosttyWriter | undefined): void {
-	ghosttyWriter = writer;
-}
-
-function defaultGhosttyWriter(seq: string): void {
-	try {
-		writeFileSync("/dev/tty", seq);
-	} catch {
-		// /dev/tty unavailable (non-interactive, subagent, CI, or Windows) — no-op.
-		// This is expected in most automated contexts; never surface it.
-	}
-}
-
-function writeGhostty(seq: string): void {
-	(ghosttyWriter ?? defaultGhosttyWriter)(seq);
-}
-
-/**
- * Emit a Ghostty OSC 9;4 progress sequence.
- * Format: `\x1b]9;4;<state>[;<value>]\x07`
- */
-export function setGhosttyProgress(state: number, value?: number): void {
-	const args = value !== undefined ? `${state};${value}` : `${state}`;
-	writeGhostty(`\x1b]9;4;${args}\x07`);
-}
-
-/** Indeterminate pulsing — use while crew runs are active. */
-export function ghosttyWorking(): void {
-	setGhosttyProgress(GHOSTTY_PROGRESS.INDETERMINATE);
-}
-
-/** Green completion flash at 100% — use when a run finishes successfully. */
-export function ghosttyComplete(): void {
-	setGhosttyProgress(GHOSTTY_PROGRESS.SET, 100);
-}
-
-/** Clear the progress indicator. */
-export function ghosttyClear(): void {
-	setGhosttyProgress(GHOSTTY_PROGRESS.CLEAR);
-}
-
-/**
- * Build the crew run-summary title segment from live agents.
- * Returns "" when no agents are live (so the title can be restored).
- */
-export function buildCrewTitleSegment(cwd?: string): string {
-	const live = listLiveAgents();
-	if (live.length === 0) return "";
-	// Distinct roles across active agents, in stable order.
-	const roles: string[] = [];
-	const seen = new Set<string>();
-	for (const handle of live) {
-		const role = handle.role || handle.agent || "agent";
-		if (!seen.has(role)) {
-			seen.add(role);
-			roles.push(role);
-		}
-	}
-	const shown = roles.slice(0, MAX_TITLE_ROLES);
-	const more = roles.length > shown.length ? ` +${roles.length - shown.length}` : "";
-	return `${TITLE_PREFIX}${SEP}${live.length} active${SEP}${shown.join(", ")}${more}`;
-}
-
-/** Idle title — what we restore when no runs are active. */
-export function buildIdleTitle(): string {
-	return TITLE_PREFIX;
-}
-
-/**
- * Set the terminal tab title if the UI supports it. Best-effort.
- */
-export function setTerminalTitle(ctx: TerminalStatusUi, title: string): void {
-	if (!ctx.hasUI) return;
-	try {
-		ctx.ui.setTitle(title);
-	} catch {
-		// setTitle unavailable or failed — swallow (purely cosmetic).
-	}
-}
-
-interface TerminalStatusState {
-	/** Idle re-assert timer (mirrors pi-status backoff). */
-	idleTimer: ReturnType<typeof setTimeout> | undefined;
-	/** Whether we currently show an "active" title (so we know to restore). */
-	showingActive: boolean;
-	/** Completion-flash clear timer. */
-	flashTimer: ReturnType<typeof setTimeout> | undefined;
-	/** True after dispose() — stop all timers/writes. */
-	destroyed: boolean;
-}
-
-/**
- * Terminal status controller. Owns the title + Ghostty progress lifecycle.
- *
- * The controller is a small stateful object (no class hierarchy) so it can be
- * constructed per-session in register.ts and disposed cleanly. It exposes
- * `onRunsActive()`, `onRunCompleted()`, `onIdle()` entry points that the
- * runEventBus + turn handlers call.
- */
-export interface TerminalStatusController {
-	onRunsActive(): void;
-	onRunCompleted(): void;
-	onIdle(): void;
-	dispose(): void;
-}
-
-export function createTerminalStatusController(ctx: TerminalStatusUi): TerminalStatusController {
-	const state: TerminalStatusState = {
-		idleTimer: undefined,
-		showingActive: false,
-		flashTimer: undefined,
-		destroyed: false,
-	};
-
-	const clearIdleTimer = (): void => {
-		if (state.idleTimer) {
-			clearTimeout(state.idleTimer);
-			state.idleTimer = undefined;
-		}
-	};
-	const clearFlashTimer = (): void => {
-		if (state.flashTimer) {
-			clearTimeout(state.flashTimer);
-			state.flashTimer = undefined;
-		}
-	};
-
-	/**
-	 * Idle re-assert loop: pi itself re-sets the title on some events
-	 * (session_info_changed, model_select, rebinds), so a single setTitle
-	 * is not durable. Re-assert on an exponential backoff until the next
-	 * activity. (Pattern from pi-status scheduleIdleReassert.)
-	 */
-	const scheduleIdleReassert = (delay: number): void => {
-		if (state.destroyed || state.showingActive) return;
-		clearIdleTimer();
-		state.idleTimer = setTimeout(() => {
-			if (state.destroyed || state.showingActive) return;
-			setTerminalTitle(ctx, buildIdleTitle());
-			scheduleIdleReassert(Math.min(delay * 2, IDLE_REASSERT_MAX_MS));
-		}, delay);
-		// Unref so this recursive backoff timer never keeps the event loop alive
-		// (critical on SIGTERM where dispose() is not reached → process hang).
-		state.idleTimer.unref?.();
-	};
-
-	return {
-		onRunsActive(): void {
-			if (state.destroyed) return;
-			clearIdleTimer();
-			clearFlashTimer();
-			state.showingActive = true;
-			const segment = buildCrewTitleSegment();
-			if (segment) setTerminalTitle(ctx, segment);
-			ghosttyWorking();
-		},
-		onRunCompleted(): void {
-			if (state.destroyed) return;
-			clearFlashTimer();
-			ghosttyComplete();
-			// Clear the green flash after a short beat, then re-evaluate.
-			state.flashTimer = setTimeout(() => {
-				if (state.destroyed) return;
-				state.flashTimer = undefined;
-				// If still active, resume indeterminate; else go idle.
-				if (listLiveAgents().length > 0) {
-					ghosttyWorking();
-				} else {
-					ghosttyClear();
-				}
-			}, COMPLETE_FLASH_MS);
-			// Unref so the one-shot flash clear never blocks process exit.
-			state.flashTimer.unref?.();
-		},
-		onIdle(): void {
-			if (state.destroyed) return;
-			state.showingActive = false;
-			clearFlashTimer();
-			ghosttyClear();
-			setTerminalTitle(ctx, buildIdleTitle());
-			scheduleIdleReassert(IDLE_REASSERT_START_MS);
-		},
-		dispose(): void {
-			state.destroyed = true;
-			clearIdleTimer();
-			clearFlashTimer();
-			// Best-effort: clear the Ghostty progress so we don't leave a stale bar.
-			try {
-				ghosttyClear();
-			} catch {
-				// swallow
-			}
-		},
-	};
-}