pi-crew 0.1.30 → 0.1.32

package/src/extension/registration/commands.ts

@@ -1,208 +1,208 @@
-import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@mariozechner/pi-coding-agent";
-import { loadConfig } from "../../config/config.ts";
-import { handleTeamTool } from "../team-tool.ts";
-import { piTeamsHelp } from "../help.ts";
-import { handleTeamManagerCommand } from "../team-manager-command.ts";
-import { loadRunManifestById } from "../../state/state-store.ts";
-import type { TeamRunManifest } from "../../state/types.ts";
-import { readCrewAgents } from "../../runtime/crew-agent-records.ts";
-import { AnimatedMascot } from "../../ui/mascot.ts";
-import { RunDashboard, type RunDashboardSelection } from "../../ui/run-dashboard.ts";
-import { DurableTextViewer } from "../../ui/transcript-viewer.ts";
-import { commandText, notifyCommandResult, parseRunArgs, parseScalar, pushUnset, setNestedConfig } from "./command-utils.ts";
-import { openTranscriptViewer, selectAgentTask } from "./viewers.ts";
-import { printTimings, time } from "../../utils/timings.ts";
-
-export interface RegisterTeamCommandsDeps {
-	startForegroundRun: (ctx: ExtensionContext, runner: (signal?: AbortSignal) => Promise<void>, runId?: string) => void;
-	openLiveSidebar: (ctx: ExtensionContext, runId: string) => void;
-	getManifestCache: (cwd: string) => { list(max?: number): TeamRunManifest[] };
-}
-
-export function registerTeamCommands(pi: ExtensionAPI, deps: RegisterTeamCommandsDeps): void {
-	pi.registerCommand("teams", {
-		description: "List pi-crew teams, workflows, and agents",
-		handler: async (_args: string, ctx: ExtensionCommandContext) => {
-			const result = await handleTeamTool({ action: "list" }, ctx);
-			await notifyCommandResult(ctx, commandText(result));
-		},
-	});
-
-	pi.registerCommand("team-run", {
-		description: "Manually start a pi-crew run (agent may also use the team tool autonomously)",
-		handler: async (args: string, ctx: ExtensionCommandContext) => {
-			const result = await handleTeamTool(parseRunArgs(args), { ...ctx, startForegroundRun: (runner, runId) => deps.startForegroundRun(ctx as ExtensionContext, runner, runId), onRunStarted: (runId) => deps.openLiveSidebar(ctx as ExtensionContext, runId) });
-			await notifyCommandResult(ctx, commandText(result));
-		},
-	});
-
-	for (const [name, action, description] of [
-		["team-status", "status", "Show pi-crew run status"],
-		["team-resume", "resume", "Resume a pi-crew run by re-queueing failed/cancelled/skipped/running tasks"],
-		["team-summary", "summary", "Show pi-crew run summary"],
-		["team-events", "events", "Show full pi-crew event log for a run"],
-		["team-artifacts", "artifacts", "List pi-crew artifacts for a run"],
-		["team-worktrees", "worktrees", "List pi-crew worktrees for a run"],
-		["team-export", "export", "Export a pi-crew run bundle to artifacts/export"],
-		["team-cancel", "cancel", "Cancel a pi-crew run"],
-	] as const) {
-		pi.registerCommand(name, { description, handler: async (args: string, ctx: ExtensionCommandContext) => {
-			const runId = args.trim() || undefined;
-			const result = await handleTeamTool({ action, runId }, ctx);
-			await notifyCommandResult(ctx, commandText(result));
-		} });
-	}
-
-	pi.registerCommand("team-api", {
-		description: "Run safe pi-crew API interop operations: <runId> <operation> [key=value]",
-		handler: async (args: string, ctx: ExtensionCommandContext) => {
-			const tokens = args.trim().split(/\s+/).filter(Boolean);
-			const runId = tokens.find((token) => !token.includes("=") && !token.startsWith("--"));
-			const operation = tokens.find((token) => token !== runId && !token.includes("=") && !token.startsWith("--")) ?? "read-manifest";
-			const config: Record<string, unknown> = { operation };
-			for (const token of tokens.filter((item) => item.includes("="))) {
-				const [key, ...rest] = token.split("=");
-				if (key) config[key] = parseScalar(rest.join("="));
-			}
-			const result = await handleTeamTool({ action: "api", runId, config }, ctx);
-			await notifyCommandResult(ctx, commandText(result));
-		},
-	});
-
-	pi.registerCommand("team-imports", { description: "List imported pi-crew run bundles", handler: async (_args: string, ctx: ExtensionCommandContext) => {
-		const result = await handleTeamTool({ action: "imports" }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-import", { description: "Import a pi-crew run-export.json bundle into local imports", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		const pathArg = tokens.find((token) => !token.startsWith("--"));
-		const scope = tokens.includes("--user") ? "user" : "project";
-		const result = await handleTeamTool({ action: "import", config: { path: pathArg, scope } }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-prune", { description: "Prune old finished pi-crew runs, keeping the newest N", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		const keepToken = tokens.find((token) => token.startsWith("--keep="));
-		const keep = keepToken ? Number.parseInt(keepToken.slice("--keep=".length), 10) : undefined;
-		const result = await handleTeamTool({ action: "prune", keep, confirm: tokens.includes("--confirm") }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-forget", { description: "Forget a pi-crew run by deleting its state and artifacts", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		const runId = tokens.find((token) => !token.startsWith("--"));
-		const result = await handleTeamTool({ action: "forget", runId, force: tokens.includes("--force"), confirm: tokens.includes("--confirm") }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-cleanup", { description: "Clean up pi-crew worktrees for a run", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		const runId = tokens.find((token) => !token.startsWith("--"));
-		const result = await handleTeamTool({ action: "cleanup", runId, force: tokens.includes("--force") }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-manager", { description: "Open a simple pi-crew interactive manager", handler: handleTeamManagerCommand });
-
-	pi.registerCommand("team-result", { description: "Open a pi-crew agent result viewer: <runId> [taskId]", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const [runId, rawTaskId] = args.trim().split(/\s+/).filter(Boolean);
-		const selected = await selectAgentTask(ctx, runId, rawTaskId);
-		const loaded = selected ? loadRunManifestById(ctx.cwd, selected.runId) : undefined;
-		if (ctx.hasUI && loaded) {
-			const agent = readCrewAgents(loaded.manifest).find((item) => item.taskId === selected?.taskId || item.id === selected?.taskId) ?? readCrewAgents(loaded.manifest)[0];
-			const text = agent?.resultArtifactPath ? commandText(await handleTeamTool({ action: "api", runId: selected!.runId, config: { operation: "read-agent-output", agentId: agent.taskId, maxBytes: 64_000 } }, ctx)) : "(no result)";
-			await ctx.ui.custom<undefined>((_tui, theme, _keybindings, done) => new DurableTextViewer("pi-crew result", `${selected!.runId}:${agent?.taskId ?? "unknown"}`, text.split(/\r?\n/), theme, done), { overlay: true, overlayOptions: { width: "90%", maxHeight: "85%", anchor: "center" } });
-			return;
-		}
-		const result = await handleTeamTool({ action: "api", runId, config: { operation: "read-agent-output", agentId: rawTaskId, maxBytes: 64_000 } }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-transcript", { description: "Open a pi-crew transcript viewer: <runId> [taskId]", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const [runId, taskId] = args.trim().split(/\s+/).filter(Boolean);
-		if (await openTranscriptViewer(ctx, runId, taskId)) return;
-		const result = await handleTeamTool({ action: "api", runId, config: { operation: "read-agent-transcript", agentId: taskId } }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-dashboard", { description: "Open a pi-crew run dashboard overlay", handler: async (_args: string, ctx: ExtensionCommandContext) => {
-		for (;;) {
-			const runs = deps.getManifestCache(ctx.cwd).list(50);
-			const uiConfig = loadConfig(ctx.cwd).config.ui;
-			const rightPanel = uiConfig?.dashboardPlacement !== "center";
-			const width = rightPanel ? Math.min(90, Math.max(40, uiConfig?.dashboardWidth ?? 56)) : "90%";
-			const selection = await ctx.ui.custom<RunDashboardSelection | undefined>((_tui, theme, _keybindings, done) => new RunDashboard(runs, done, theme, { placement: rightPanel ? "right" : "center", showModel: uiConfig?.showModel, showTokens: uiConfig?.showTokens, showTools: uiConfig?.showTools }), { overlay: true, overlayOptions: rightPanel ? { width, minWidth: 40, maxHeight: "100%", anchor: "top-right", offsetX: 0, offsetY: 0, margin: { top: 0, right: 0, bottom: 0, left: 0 } } : { width, maxHeight: "90%", anchor: "center", margin: 2 } });
-			if (!selection) return;
-			if (selection.action === "reload") continue;
-			if (selection.action === "agent-transcript" && await openTranscriptViewer(ctx, selection.runId)) continue;
-			const result = selection.action === "api" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-manifest" } }, ctx) : selection.action === "agents" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "agent-dashboard" } }, ctx) : selection.action === "agent-events" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-agent-events", limit: 50 } }, ctx) : selection.action === "agent-output" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-agent-output", maxBytes: 32_000 } }, ctx) : selection.action === "agent-transcript" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-agent-transcript" } }, ctx) : await handleTeamTool({ action: selection.action, runId: selection.runId }, ctx);
-			await notifyCommandResult(ctx, commandText(result));
-			return;
-		}
-	} });
-
-	pi.registerCommand("team-mascot", { description: "Show an animated mascot splash", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		if (!ctx.hasUI) return;
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		const uiConfig = loadConfig(ctx.cwd).config.ui;
-		const styleArg = tokens.find((t) => t === "cat" || t === "armin");
-		const effectArg = tokens.find((t) => ["random", "none", "typewriter", "scanline", "rain", "fade", "crt", "glitch", "dissolve"].includes(t));
-		const style = (styleArg as "cat" | "armin" | undefined) ?? uiConfig?.mascotStyle ?? "cat";
-		const effect = (effectArg as "random" | "none" | "typewriter" | "scanline" | "rain" | "fade" | "crt" | "glitch" | "dissolve" | undefined) ?? uiConfig?.mascotEffect ?? "random";
-		await ctx.ui.custom<undefined>((tui, theme, _keybindings, done) => new AnimatedMascot(theme, () => done(undefined), { frameIntervalMs: style === "armin" ? 33 : 180, autoCloseMs: 7000, requestRender: () => (tui as { requestRender?: () => void }).requestRender?.(), style, effect }), { overlay: true, overlayOptions: { width: style === "armin" ? 48 : 62, maxHeight: "85%", anchor: "center" } });
-	} });
-
-	pi.registerCommand("team-init", { description: "Initialize project-local pi-crew directories and gitignore entries", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		const result = await handleTeamTool({ action: "init", config: { copyBuiltins: tokens.includes("--copy-builtins"), overwrite: tokens.includes("--overwrite") } }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-autonomy", { description: "Show or toggle pi-crew autonomous delegation policy: status|on|off", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		const mode = tokens[0]?.toLowerCase();
-		const config = mode === "on" ? { profile: "suggested", enabled: true, injectPolicy: true } : mode === "off" ? { profile: "manual", enabled: false } : mode === "manual" || mode === "suggested" || mode === "assisted" || mode === "aggressive" ? { profile: mode, enabled: mode !== "manual", injectPolicy: mode !== "manual" } : { preferAsyncForLongTasks: tokens.includes("--prefer-async") ? true : undefined, allowWorktreeSuggestion: tokens.includes("--no-worktree-suggest") ? false : undefined };
-		const result = await handleTeamTool({ action: "autonomy", config }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-config", { description: "Show or update pi-crew config. Use key=value [--project] to update.", handler: async (args: string, ctx: ExtensionCommandContext) => {
-		const tokens = args.trim().split(/\s+/).filter(Boolean);
-		if (tokens.length === 0) {
-			const result = await handleTeamTool({ action: "config" }, ctx);
-			await notifyCommandResult(ctx, commandText(result));
-			return;
-		}
-		const config: Record<string, unknown> = { scope: tokens.includes("--project") ? "project" : "user" };
-		for (const token of tokens) {
-			if (token.startsWith("--unset=")) {
-				pushUnset(config, token.slice("--unset=".length));
-				continue;
-			}
-			if (!token.includes("=")) continue;
-			const [key, ...rest] = token.split("=");
-			if (!key) continue;
-			const raw = rest.join("=");
-			if (raw === "unset" || raw === "null") pushUnset(config, key);
-			else setNestedConfig(config, key, parseScalar(raw));
-		}
-		const result = await handleTeamTool({ action: "config", config }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	for (const [name, action, description] of [
-		["team-validate", "validate", "Validate pi-crew agents, teams, and workflows"],
-		["team-doctor", "doctor", "Check pi-crew installation and discovery readiness"],
-	] as const) pi.registerCommand(name, { description, handler: async (_args: string, ctx: ExtensionCommandContext) => {
-		const result = await handleTeamTool({ action }, ctx);
-		await notifyCommandResult(ctx, commandText(result));
-	} });
-
-	pi.registerCommand("team-help", { description: "Show pi-crew command help", handler: async (_args: string, ctx: ExtensionCommandContext) => {
-		await notifyCommandResult(ctx, piTeamsHelp());
-	} });
-	time("register.commands");
-	printTimings();
-}
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { loadConfig } from "../../config/config.ts";
+import { handleTeamTool } from "../team-tool.ts";
+import { piTeamsHelp } from "../help.ts";
+import { handleTeamManagerCommand } from "../team-manager-command.ts";
+import { loadRunManifestById } from "../../state/state-store.ts";
+import type { TeamRunManifest } from "../../state/types.ts";
+import { readCrewAgents } from "../../runtime/crew-agent-records.ts";
+import { AnimatedMascot } from "../../ui/mascot.ts";
+import { RunDashboard, type RunDashboardSelection } from "../../ui/run-dashboard.ts";
+import { DurableTextViewer } from "../../ui/transcript-viewer.ts";
+import { commandText, notifyCommandResult, parseRunArgs, parseScalar, pushUnset, setNestedConfig } from "./command-utils.ts";
+import { openTranscriptViewer, selectAgentTask } from "./viewers.ts";
+import { printTimings, time } from "../../utils/timings.ts";
+
+export interface RegisterTeamCommandsDeps {
+	startForegroundRun: (ctx: ExtensionContext, runner: (signal?: AbortSignal) => Promise<void>, runId?: string) => void;
+	openLiveSidebar: (ctx: ExtensionContext, runId: string) => void;
+	getManifestCache: (cwd: string) => { list(max?: number): TeamRunManifest[] };
+}
+
+export function registerTeamCommands(pi: ExtensionAPI, deps: RegisterTeamCommandsDeps): void {
+	pi.registerCommand("teams", {
+		description: "List pi-crew teams, workflows, and agents",
+		handler: async (_args: string, ctx: ExtensionCommandContext) => {
+			const result = await handleTeamTool({ action: "list" }, ctx);
+			await notifyCommandResult(ctx, commandText(result));
+		},
+	});
+
+	pi.registerCommand("team-run", {
+		description: "Manually start a pi-crew run (agent may also use the team tool autonomously)",
+		handler: async (args: string, ctx: ExtensionCommandContext) => {
+			const result = await handleTeamTool(parseRunArgs(args), { ...ctx, startForegroundRun: (runner, runId) => deps.startForegroundRun(ctx as ExtensionContext, runner, runId), onRunStarted: (runId) => deps.openLiveSidebar(ctx as ExtensionContext, runId) });
+			await notifyCommandResult(ctx, commandText(result));
+		},
+	});
+
+	for (const [name, action, description] of [
+		["team-status", "status", "Show pi-crew run status"],
+		["team-resume", "resume", "Resume a pi-crew run by re-queueing failed/cancelled/skipped/running tasks"],
+		["team-summary", "summary", "Show pi-crew run summary"],
+		["team-events", "events", "Show full pi-crew event log for a run"],
+		["team-artifacts", "artifacts", "List pi-crew artifacts for a run"],
+		["team-worktrees", "worktrees", "List pi-crew worktrees for a run"],
+		["team-export", "export", "Export a pi-crew run bundle to artifacts/export"],
+		["team-cancel", "cancel", "Cancel a pi-crew run"],
+	] as const) {
+		pi.registerCommand(name, { description, handler: async (args: string, ctx: ExtensionCommandContext) => {
+			const runId = args.trim() || undefined;
+			const result = await handleTeamTool({ action, runId }, ctx);
+			await notifyCommandResult(ctx, commandText(result));
+		} });
+	}
+
+	pi.registerCommand("team-api", {
+		description: "Run safe pi-crew API interop operations: <runId> <operation> [key=value]",
+		handler: async (args: string, ctx: ExtensionCommandContext) => {
+			const tokens = args.trim().split(/\s+/).filter(Boolean);
+			const runId = tokens.find((token) => !token.includes("=") && !token.startsWith("--"));
+			const operation = tokens.find((token) => token !== runId && !token.includes("=") && !token.startsWith("--")) ?? "read-manifest";
+			const config: Record<string, unknown> = { operation };
+			for (const token of tokens.filter((item) => item.includes("="))) {
+				const [key, ...rest] = token.split("=");
+				if (key) config[key] = parseScalar(rest.join("="));
+			}
+			const result = await handleTeamTool({ action: "api", runId, config }, ctx);
+			await notifyCommandResult(ctx, commandText(result));
+		},
+	});
+
+	pi.registerCommand("team-imports", { description: "List imported pi-crew run bundles", handler: async (_args: string, ctx: ExtensionCommandContext) => {
+		const result = await handleTeamTool({ action: "imports" }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-import", { description: "Import a pi-crew run-export.json bundle into local imports", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		const pathArg = tokens.find((token) => !token.startsWith("--"));
+		const scope = tokens.includes("--user") ? "user" : "project";
+		const result = await handleTeamTool({ action: "import", config: { path: pathArg, scope } }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-prune", { description: "Prune old finished pi-crew runs, keeping the newest N", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		const keepToken = tokens.find((token) => token.startsWith("--keep="));
+		const keep = keepToken ? Number.parseInt(keepToken.slice("--keep=".length), 10) : undefined;
+		const result = await handleTeamTool({ action: "prune", keep, confirm: tokens.includes("--confirm") }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-forget", { description: "Forget a pi-crew run by deleting its state and artifacts", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		const runId = tokens.find((token) => !token.startsWith("--"));
+		const result = await handleTeamTool({ action: "forget", runId, force: tokens.includes("--force"), confirm: tokens.includes("--confirm") }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-cleanup", { description: "Clean up pi-crew worktrees for a run", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		const runId = tokens.find((token) => !token.startsWith("--"));
+		const result = await handleTeamTool({ action: "cleanup", runId, force: tokens.includes("--force") }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-manager", { description: "Open a simple pi-crew interactive manager", handler: handleTeamManagerCommand });
+
+	pi.registerCommand("team-result", { description: "Open a pi-crew agent result viewer: <runId> [taskId]", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const [runId, rawTaskId] = args.trim().split(/\s+/).filter(Boolean);
+		const selected = await selectAgentTask(ctx, runId, rawTaskId);
+		const loaded = selected ? loadRunManifestById(ctx.cwd, selected.runId) : undefined;
+		if (ctx.hasUI && loaded) {
+			const agent = readCrewAgents(loaded.manifest).find((item) => item.taskId === selected?.taskId || item.id === selected?.taskId) ?? readCrewAgents(loaded.manifest)[0];
+			const text = agent?.resultArtifactPath ? commandText(await handleTeamTool({ action: "api", runId: selected!.runId, config: { operation: "read-agent-output", agentId: agent.taskId, maxBytes: 64_000 } }, ctx)) : "(no result)";
+			await ctx.ui.custom<undefined>((_tui, theme, _keybindings, done) => new DurableTextViewer("pi-crew result", `${selected!.runId}:${agent?.taskId ?? "unknown"}`, text.split(/\r?\n/), theme, done), { overlay: true, overlayOptions: { width: "90%", maxHeight: "85%", anchor: "center" } });
+			return;
+		}
+		const result = await handleTeamTool({ action: "api", runId, config: { operation: "read-agent-output", agentId: rawTaskId, maxBytes: 64_000 } }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-transcript", { description: "Open a pi-crew transcript viewer: <runId> [taskId]", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const [runId, taskId] = args.trim().split(/\s+/).filter(Boolean);
+		if (await openTranscriptViewer(ctx, runId, taskId)) return;
+		const result = await handleTeamTool({ action: "api", runId, config: { operation: "read-agent-transcript", agentId: taskId } }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-dashboard", { description: "Open a pi-crew run dashboard overlay", handler: async (_args: string, ctx: ExtensionCommandContext) => {
+		for (;;) {
+			const runs = deps.getManifestCache(ctx.cwd).list(50);
+			const uiConfig = loadConfig(ctx.cwd).config.ui;
+			const rightPanel = uiConfig?.dashboardPlacement !== "center";
+			const width = rightPanel ? Math.min(90, Math.max(40, uiConfig?.dashboardWidth ?? 56)) : "90%";
+			const selection = await ctx.ui.custom<RunDashboardSelection | undefined>((_tui, theme, _keybindings, done) => new RunDashboard(runs, done, theme, { placement: rightPanel ? "right" : "center", showModel: uiConfig?.showModel, showTokens: uiConfig?.showTokens, showTools: uiConfig?.showTools }), { overlay: true, overlayOptions: rightPanel ? { width, minWidth: 40, maxHeight: "100%", anchor: "top-right", offsetX: 0, offsetY: 0, margin: { top: 0, right: 0, bottom: 0, left: 0 } } : { width, maxHeight: "90%", anchor: "center", margin: 2 } });
+			if (!selection) return;
+			if (selection.action === "reload") continue;
+			if (selection.action === "agent-transcript" && await openTranscriptViewer(ctx, selection.runId)) continue;
+			const result = selection.action === "api" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-manifest" } }, ctx) : selection.action === "agents" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "agent-dashboard" } }, ctx) : selection.action === "agent-events" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-agent-events", limit: 50 } }, ctx) : selection.action === "agent-output" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-agent-output", maxBytes: 32_000 } }, ctx) : selection.action === "agent-transcript" ? await handleTeamTool({ action: "api", runId: selection.runId, config: { operation: "read-agent-transcript" } }, ctx) : await handleTeamTool({ action: selection.action, runId: selection.runId }, ctx);
+			await notifyCommandResult(ctx, commandText(result));
+			return;
+		}
+	} });
+
+	pi.registerCommand("team-mascot", { description: "Show an animated mascot splash", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		if (!ctx.hasUI) return;
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		const uiConfig = loadConfig(ctx.cwd).config.ui;
+		const styleArg = tokens.find((t) => t === "cat" || t === "armin");
+		const effectArg = tokens.find((t) => ["random", "none", "typewriter", "scanline", "rain", "fade", "crt", "glitch", "dissolve"].includes(t));
+		const style = (styleArg as "cat" | "armin" | undefined) ?? uiConfig?.mascotStyle ?? "cat";
+		const effect = (effectArg as "random" | "none" | "typewriter" | "scanline" | "rain" | "fade" | "crt" | "glitch" | "dissolve" | undefined) ?? uiConfig?.mascotEffect ?? "random";
+		await ctx.ui.custom<undefined>((tui, theme, _keybindings, done) => new AnimatedMascot(theme, () => done(undefined), { frameIntervalMs: style === "armin" ? 33 : 180, autoCloseMs: 7000, requestRender: () => (tui as { requestRender?: () => void }).requestRender?.(), style, effect }), { overlay: true, overlayOptions: { width: style === "armin" ? 48 : 62, maxHeight: "85%", anchor: "center" } });
+	} });
+
+	pi.registerCommand("team-init", { description: "Initialize project-local pi-crew directories and gitignore entries", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		const result = await handleTeamTool({ action: "init", config: { copyBuiltins: tokens.includes("--copy-builtins"), overwrite: tokens.includes("--overwrite") } }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-autonomy", { description: "Show or toggle pi-crew autonomous delegation policy: status|on|off", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		const mode = tokens[0]?.toLowerCase();
+		const config = mode === "on" ? { profile: "suggested", enabled: true, injectPolicy: true } : mode === "off" ? { profile: "manual", enabled: false } : mode === "manual" || mode === "suggested" || mode === "assisted" || mode === "aggressive" ? { profile: mode, enabled: mode !== "manual", injectPolicy: mode !== "manual" } : { preferAsyncForLongTasks: tokens.includes("--prefer-async") ? true : undefined, allowWorktreeSuggestion: tokens.includes("--no-worktree-suggest") ? false : undefined };
+		const result = await handleTeamTool({ action: "autonomy", config }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-config", { description: "Show or update pi-crew config. Use key=value [--project] to update.", handler: async (args: string, ctx: ExtensionCommandContext) => {
+		const tokens = args.trim().split(/\s+/).filter(Boolean);
+		if (tokens.length === 0) {
+			const result = await handleTeamTool({ action: "config" }, ctx);
+			await notifyCommandResult(ctx, commandText(result));
+			return;
+		}
+		const config: Record<string, unknown> = { scope: tokens.includes("--project") ? "project" : "user" };
+		for (const token of tokens) {
+			if (token.startsWith("--unset=")) {
+				pushUnset(config, token.slice("--unset=".length));
+				continue;
+			}
+			if (!token.includes("=")) continue;
+			const [key, ...rest] = token.split("=");
+			if (!key) continue;
+			const raw = rest.join("=");
+			if (raw === "unset" || raw === "null") pushUnset(config, key);
+			else setNestedConfig(config, key, parseScalar(raw));
+		}
+		const result = await handleTeamTool({ action: "config", config }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	for (const [name, action, description] of [
+		["team-validate", "validate", "Validate pi-crew agents, teams, and workflows"],
+		["team-doctor", "doctor", "Check pi-crew installation and discovery readiness"],
+	] as const) pi.registerCommand(name, { description, handler: async (_args: string, ctx: ExtensionCommandContext) => {
+		const result = await handleTeamTool({ action }, ctx);
+		await notifyCommandResult(ctx, commandText(result));
+	} });
+
+	pi.registerCommand("team-help", { description: "Show pi-crew command help", handler: async (_args: string, ctx: ExtensionCommandContext) => {
+		await notifyCommandResult(ctx, piTeamsHelp());
+	} });
+	time("register.commands");
+	printTimings();
+}

package/src/extension/registration/compaction-guard.ts

@@ -0,0 +1,125 @@
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { listRecentRuns } from "../run-index.ts";
+import type { ArtifactDescriptor, TeamRunManifest } from "../../state/types.ts";
+
+export interface RegisterCompactionGuardOptions {
+	foregroundControllers: Set<AbortController>;
+}
+
+const TRIGGER_RATIO = 0.75;
+const HARD_RATIO = 0.95;
+const DEFAULT_CONTEXT_WINDOW = 200_000;
+const MAX_ARTIFACT_INDEX_RUNS = 10;
+const MAX_ARTIFACT_INDEX_ITEMS = 80;
+
+function contextWindow(ctx: { model?: { contextWindow?: number } }): number {
+	const value = ctx.model?.contextWindow;
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : DEFAULT_CONTEXT_WINDOW;
+}
+
+function usageRatio(ctx: { getContextUsage(): { tokens: number | null } | undefined; model?: { contextWindow?: number } }): number | undefined {
+	const tokens = ctx.getContextUsage()?.tokens;
+	if (tokens === null || tokens === undefined || !Number.isFinite(tokens)) return undefined;
+	return tokens / contextWindow(ctx);
+}
+
+interface CrewArtifactIndexEntry {
+	runId: string;
+	status: TeamRunManifest["status"];
+	team: string;
+	workflow?: string;
+	goal: string;
+	artifact: Pick<ArtifactDescriptor, "kind" | "path" | "producer" | "sizeBytes" | "createdAt">;
+}
+
+function collectCrewArtifactIndex(cwd: string): CrewArtifactIndexEntry[] {
+	const entries: CrewArtifactIndexEntry[] = [];
+	for (const run of listRecentRuns(cwd, MAX_ARTIFACT_INDEX_RUNS)) {
+		for (const artifact of run.artifacts) {
+			entries.push({
+				runId: run.runId,
+				status: run.status,
+				team: run.team,
+				workflow: run.workflow,
+				goal: run.goal,
+				artifact: {
+					kind: artifact.kind,
+					path: artifact.path,
+					producer: artifact.producer,
+					sizeBytes: artifact.sizeBytes,
+					createdAt: artifact.createdAt,
+				},
+			});
+			if (entries.length >= MAX_ARTIFACT_INDEX_ITEMS) return entries;
+		}
+	}
+	return entries;
+}
+
+function formatCrewArtifactIndex(entries: CrewArtifactIndexEntry[]): string {
+	if (!entries.length) return "";
+	const lines = ["", "# pi-crew artifact index", "Preserve these run artifact references in the compaction summary:"];
+	for (const entry of entries) {
+		lines.push(`- ${entry.artifact.kind}: ${entry.artifact.path} (run=${entry.runId}, status=${entry.status}, team=${entry.team}, workflow=${entry.workflow ?? "none"}, producer=${entry.artifact.producer})`);
+	}
+	return lines.join("\n");
+}
+
+export function registerCompactionGuard(pi: ExtensionAPI, options: RegisterCompactionGuardOptions): void {
+	let pendingCompactReason: string | null = null;
+	let compactionInProgress = false;
+
+	const startCompact = (ctx: ExtensionContext, reason: string): void => {
+		if (compactionInProgress) return;
+		compactionInProgress = true;
+		const artifactIndex = collectCrewArtifactIndex(ctx.cwd);
+		if (artifactIndex.length > 0) {
+			pi.appendEntry("crew:artifact-index", {
+				reason,
+				createdAt: new Date().toISOString(),
+				artifacts: artifactIndex,
+			});
+		}
+		ctx.compact({
+			customInstructions: `Prioritize keeping pi-crew run state, task results, artifact references, run IDs, and next actions. Keep completed-task detail concise.${formatCrewArtifactIndex(artifactIndex)}`,
+			onComplete: () => {
+				compactionInProgress = false;
+				ctx.ui.notify(reason === "deferred" ? "Deferred compaction completed" : "Auto-compacted context during team run", "info");
+			},
+			onError: (error) => {
+				compactionInProgress = false;
+				ctx.ui.notify(`${reason === "deferred" ? "Deferred" : "Auto"} compaction failed: ${error.message}`, "error");
+			},
+		});
+	};
+
+	// Phase 1.2: Defer compaction during foreground runs unless context is critically full.
+	pi.on("session_before_compact", async (_event, ctx) => {
+		if (options.foregroundControllers.size === 0) return;
+		const ratio = usageRatio(ctx);
+		if (ratio !== undefined && ratio >= HARD_RATIO) {
+			ctx.ui.notify("Compaction allowed despite foreground run: context is critically full", "warning");
+			return;
+		}
+		pendingCompactReason = "deferred-during-foreground-run";
+		ctx.ui.notify("Compaction deferred: foreground team run in progress", "info");
+		return { cancel: true };
+	});
+
+	// Phase 2.1: Proactive compaction with dynamic threshold based on model context window.
+	pi.on("turn_end", (_event, ctx) => {
+		if (compactionInProgress) return;
+		if (options.foregroundControllers.size === 0 && pendingCompactReason) {
+			pendingCompactReason = null;
+			startCompact(ctx, "deferred");
+			return;
+		}
+		const ratio = usageRatio(ctx);
+		if (ratio === undefined || ratio < TRIGGER_RATIO) return;
+		if (options.foregroundControllers.size > 0) {
+			pendingCompactReason = "threshold-during-foreground-run";
+			return;
+		}
+		startCompact(ctx, "threshold");
+	});
+}

package/src/extension/registration/subagent-tools.ts

@@ -4,6 +4,7 @@ import type { TeamToolParamsValue } from "../../schema/team-tool-schema.ts";
 import { handleTeamTool } from "../team-tool.ts";
 import { checkSubagentSpawnPermission, currentCrewRole } from "../../runtime/role-permission.ts";
 import { readPersistedSubagentRecord, savePersistedSubagentRecord, type SubagentManager, type SubagentSpawnOptions } from "../../subagents/manager.ts";
+import { loadConfig } from "../../config/config.ts";
 import { logInternalError } from "../../utils/internal-error.ts";
 import { __test__subagentSpawnParams, formatSubagentRecord, readSubagentRunResult, refreshPersistedSubagentRecord, subagentToolResult } from "./subagent-helpers.ts";
 
@@ -34,10 +35,22 @@ export function registerSubagentTools(pi: ExtensionAPI, subagentManager: Subagen
 			if (!options.prompt.trim()) return subagentToolResult("Agent requires prompt.", {}, true);
 			const runner = async (spawnOptions: SubagentSpawnOptions, childSignal?: AbortSignal) => handleTeamTool({ action: "run", agent: spawnOptions.type, goal: spawnOptions.prompt, model: spawnOptions.model, async: spawnOptions.background, config: spawnOptions.maxTurns ? { runtime: { maxTurns: spawnOptions.maxTurns } } : undefined } as TeamToolParamsValue, spawnOptions.background ? { ...ctx, signal: childSignal } : { ...ctx, signal: childSignal });
 			const record = subagentManager.spawn(options, runner, options.background ? undefined : signal);
-			if (options.background || record.status === "queued") return subagentToolResult([`Agent ${record.status === "queued" ? "queued" : "started"}.`, `Agent ID: ${record.id}`, `Type: ${record.type}`, `Description: ${record.description}`, "Use get_subagent_result to retrieve output. Do not duplicate this agent's work."].join("\n"), { agentId: record.id, status: record.status });
+			if (options.background || record.status === "queued") {
+				// Phase 1.1a: Terminate turn for background queued — no LLM follow-up needed.
+				// Phase 1.6: Record was terminated for telemetry.
+				record.terminated = true;
+				savePersistedSubagentRecord(ctx.cwd, record);
+				return { ...subagentToolResult([`Agent ${record.status === "queued" ? "queued" : "started"}.`, `Agent ID: ${record.id}`, `Type: ${record.type}`, `Description: ${record.description}`, "Use get_subagent_result to retrieve output. Do not duplicate this agent's work."].join("\n"), { agentId: record.id, status: record.status }), terminate: true };
+			}
 			await record.promise;
 			const output = readSubagentRunResult(ctx, record) ?? record.result ?? "No output.";
-			return subagentToolResult([`Agent ${record.id} ${record.status}.`, "", output].join("\n"), { agentId: record.id, runId: record.runId, status: record.status }, record.status === "failed" || record.status === "error");
+			const foregroundResult = subagentToolResult([`Agent ${record.id} ${record.status}.`, "", output].join("\n"), { agentId: record.id, runId: record.runId, status: record.status }, record.status === "failed" || record.status === "error");
+			if (loadConfig(ctx.cwd).config.tools?.terminateOnForeground === true) {
+				record.terminated = true;
+				savePersistedSubagentRecord(ctx.cwd, record);
+				return { ...foregroundResult, terminate: true };
+			}
+			return foregroundResult;
 		},
 	};
 
@@ -99,12 +112,18 @@ export function registerSubagentTools(pi: ExtensionAPI, subagentManager: Subagen
 	const crewAgentTool: ToolDefinition = { ...agentTool, name: "crew_agent", label: "Crew Agent", description: "Launch a real pi-crew subagent using a conflict-safe pi-crew-specific tool name.", promptSnippet: "Use crew_agent when you need pi-crew subagents and another extension may own the generic Agent tool." };
 	const crewAgentResultTool: ToolDefinition = { ...getSubagentResultTool, name: "crew_agent_result", label: "Get Crew Agent Result", description: "Check status and retrieve results from a pi-crew subagent using the conflict-safe tool name." };
 	const crewAgentSteerTool: ToolDefinition = { ...steerSubagentTool, name: "crew_agent_steer", label: "Steer Crew Agent", description: "Send a steering note to a pi-crew subagent using the conflict-safe tool name." };
-	for (const extraTool of [crewAgentTool, crewAgentResultTool, crewAgentSteerTool]) pi.registerTool(extraTool);
-	for (const extraTool of [agentTool, getSubagentResultTool, steerSubagentTool]) {
-		try {
-			pi.registerTool(extraTool);
-		} catch (error) {
-			logInternalError("register.duplicate-tool", error, `tool=${extraTool.name}`);
+	const toolConfig = loadConfig(process.cwd()).config.tools;
+	const enableSteer = toolConfig?.enableSteer !== false;
+	const enableClaudeStyleAliases = toolConfig?.enableClaudeStyleAliases !== false;
+
+	for (const extraTool of enableSteer ? [crewAgentTool, crewAgentResultTool, crewAgentSteerTool] : [crewAgentTool, crewAgentResultTool]) pi.registerTool(extraTool);
+	if (enableClaudeStyleAliases) {
+		for (const extraTool of enableSteer ? [agentTool, getSubagentResultTool, steerSubagentTool] : [agentTool, getSubagentResultTool]) {
+			try {
+				pi.registerTool(extraTool);
+			} catch (error) {
+				logInternalError("register.duplicate-tool", error, `tool=${extraTool.name}`);
+			}
 		}
 	}
 }