pi-crew 0.9.16 → 0.9.18

package/src/extension/autonomous-policy.ts

@@ -1,6 +1,6 @@
 import type { BeforeAgentStartEvent, ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { effectiveAutonomousConfig, loadConfig, type PiTeamsAutonomousConfig } from "../config/config.ts";
 import { allAgents, discoverAgents } from "../agents/discover-agents.ts";
+import { effectiveAutonomousConfig, loadConfig, type PiTeamsAutonomousConfig } from "../config/config.ts";
 import { allTeams, discoverTeams } from "../teams/discover-teams.ts";
 import { allWorkflows, discoverWorkflows } from "../workflows/discover-workflows.ts";
 
@@ -12,27 +12,29 @@ const DEFAULT_MAGIC_KEYWORDS: Record<string, string[]> = {
 };
 
 const BULLET_OR_NUMBERED_TASK_RE = /^\s*(?:[-*•]|\d+[.)])\s+\S+/;
-const ACTIONABLE_TASK_TERMS: readonly string[] = Array.from(new Set([
-	"implement",
-	"refactor",
-	"migrate",
-	"fix",
-	"add",
-	"update",
-	"test",
-	"review",
-	"research",
-	"analyze",
-	"document",
-	"docs",
-	"sửa",
-	"thêm",
-	"cập nhật",
-	"kiểm thử",
-	"nghiên cứu",
-	"phân tích",
-	"viết docs",
-]));
+const ACTIONABLE_TASK_TERMS: readonly string[] = Array.from(
+	new Set([
+		"implement",
+		"refactor",
+		"migrate",
+		"fix",
+		"add",
+		"update",
+		"test",
+		"review",
+		"research",
+		"analyze",
+		"document",
+		"docs",
+		"sửa",
+		"thêm",
+		"cập nhật",
+		"kiểm thử",
+		"nghiên cứu",
+		"phân tích",
+		"viết docs",
+	]),
+);
 
 function mergeMagicKeywords(configured: Record<string, string[]> | undefined): Record<string, string[]> {
 	return { ...DEFAULT_MAGIC_KEYWORDS, ...(configured ?? {}) };
@@ -49,7 +51,9 @@ function actionableLineCount(prompt: string): number {
 function hasTaskListSignal(prompt: string): boolean {
 	const lower = prompt.toLowerCase();
 	const bulletCount = prompt.split(/\r?\n/).filter((line) => BULLET_OR_NUMBERED_TASK_RE.test(line)).length;
-	const explicitList = ["các task", "danh sách task", "todo", "tasks sau", "task list", "làm lần lượt"].some((term) => lower.includes(term));
+	const explicitList = ["các task", "danh sách task", "todo", "tasks sau", "task list", "làm lần lượt"].some((term) =>
+		lower.includes(term),
+	);
 	return bulletCount >= 3 || actionableLineCount(prompt) >= 2 || (explicitList && bulletCount >= 2);
 }
 
@@ -69,9 +73,10 @@ export function buildAutonomousPolicy(prompt: string, config: PiTeamsAutonomousC
 	const asyncGuidance = effective.preferAsyncForLongTasks
 		? "For long-running team runs, prefer async: true unless the user needs immediate foreground progress."
 		: "Use async: true only when the task is clearly long-running or the user asks for background execution.";
-	const worktreeGuidance = effective.allowWorktreeSuggestion === false
-		? "Do not suggest worktree mode unless the user explicitly asks for it."
-		: "Consider workspaceMode: 'worktree' for parallel or risky code-changing work in clean git repositories.";
+	const worktreeGuidance =
+		effective.allowWorktreeSuggestion === false
+			? "Do not suggest worktree mode unless the user explicitly asks for it."
+			: "Consider workspaceMode: 'worktree' for parallel or risky code-changing work in clean git repositories.";
 	return [
 		"# pi-crew Delegation Policy (MANDATORY)",
 		"",
@@ -83,7 +88,7 @@ export function buildAutonomousPolicy(prompt: string, config: PiTeamsAutonomousC
 		"| Task characteristic | Delegate? | Method |",
 		"|---|---|---|",
 		"| Read/edit 1-2 files, simple question | NO | Do it directly |",
-		"| User explicitly says \"do it yourself\" / \"no team\" | NO | Do it directly |",
+		'| User explicitly says "do it yourself" / "no team" | NO | Do it directly |',
 		"| Destructive action (delete/prune/forget) | NO | Ask for confirmation first |",
 		"| Research / deep-read / source audit / \"nghiên cứu\" | YES | `team action='research'` |",
 		"| Multi-file implementation / feature / refactor | YES | `team action='run', team='implementation'` |",
@@ -109,7 +114,9 @@ export function buildAutonomousPolicy(prompt: string, config: PiTeamsAutonomousC
 		"",
 		asyncGuidance,
 		worktreeGuidance,
-		intents.length > 0 ? `Detected pi-crew routing signals/intents in the user prompt: ${intents.join(", ")}. Consider the matching team workflow if appropriate.` : "No explicit pi-crew routing signal was detected; decide based on complexity, risk, task-list structure, and conflict potential.",
+		intents.length > 0
+			? `Detected pi-crew routing signals/intents in the user prompt: ${intents.join(", ")}. Consider the matching team workflow if appropriate.`
+			: "No explicit pi-crew routing signal was detected; decide based on complexity, risk, task-list structure, and conflict potential.",
 	].join("\n");
 }
 
@@ -135,35 +142,68 @@ function capLines(lines: string[], maxChars: number): string[] {
 }
 
 export function buildResourceRoutingGuidance(cwd: string, maxChars = 5000): string {
-	const teams = allTeams(discoverTeams(cwd)).sort((a, b) => sourcePriority(a.source) - sourcePriority(b.source)).slice(0, 12);
-	const workflows = allWorkflows(discoverWorkflows(cwd)).sort((a, b) => sourcePriority(a.source) - sourcePriority(b.source)).slice(0, 12);
-	const agents = allAgents(discoverAgents(cwd)).sort((a, b) => sourcePriority(a.source) - sourcePriority(b.source)).slice(0, 16);
+	const teams = allTeams(discoverTeams(cwd))
+		.sort((a, b) => sourcePriority(a.source) - sourcePriority(b.source))
+		.slice(0, 12);
+	const workflows = allWorkflows(discoverWorkflows(cwd))
+		.sort((a, b) => sourcePriority(a.source) - sourcePriority(b.source))
+		.slice(0, 12);
+	const agents = allAgents(discoverAgents(cwd))
+		.sort((a, b) => sourcePriority(a.source) - sourcePriority(b.source))
+		.slice(0, 16);
 	const lines = [
 		"# pi-crew Available Resources",
 		"Use project-scoped resources over user/builtin resources when names overlap.",
 		"Teams:",
-		...(teams.length ? teams.map((team) => `- ${team.name} (${team.source}): ${team.description}; defaultWorkflow=${team.defaultWorkflow ?? "default"}; roles=${team.roles.map((role) => `${role.name}->${role.agent}`).join(", ") || "none"}${team.routing?.triggers?.length ? `; triggers=${team.routing.triggers.join(",")}` : ""}${team.routing?.useWhen?.length ? `; useWhen=${team.routing.useWhen.join(";")}` : ""}`) : ["- (none)"]),
+		...(teams.length
+			? teams.map(
+					(team) =>
+						`- ${team.name} (${team.source}): ${team.description}; defaultWorkflow=${team.defaultWorkflow ?? "default"}; roles=${team.roles.map((role) => `${role.name}->${role.agent}`).join(", ") || "none"}${team.routing?.triggers?.length ? `; triggers=${team.routing.triggers.join(",")}` : ""}${team.routing?.useWhen?.length ? `; useWhen=${team.routing.useWhen.join(";")}` : ""}`,
+				)
+			: ["- (none)"]),
 		"Workflows:",
-		...(workflows.length ? workflows.map((workflow) => `- ${workflow.name} (${workflow.source}): ${workflow.description}; steps=${workflow.steps.map((step) => `${step.id}:${step.role}`).join(", ") || "none"}`) : ["- (none)"]),
+		...(workflows.length
+			? workflows.map(
+					(workflow) =>
+						`- ${workflow.name} (${workflow.source}): ${workflow.description}; steps=${workflow.steps.map((step) => `${step.id}:${step.role}`).join(", ") || "none"}`,
+				)
+			: ["- (none)"]),
 		"Agents:",
-		...(agents.length ? agents.map((agent) => `- ${agent.name} (${agent.source}): ${agent.description}${agent.routing?.triggers?.length ? `; triggers=${agent.routing.triggers.join(",")}` : ""}${agent.routing?.useWhen?.length ? `; useWhen=${agent.routing.useWhen.join(";")}` : ""}${agent.routing?.avoidWhen?.length ? `; avoidWhen=${agent.routing.avoidWhen.join(";")}` : ""}${agent.routing?.cost ? `; cost=${agent.routing.cost}` : ""}${agent.routing?.category ? `; category=${agent.routing.category}` : ""}`) : ["- (none)"]),
+		...(agents.length
+			? agents.map(
+					(agent) =>
+						`- ${agent.name} (${agent.source}): ${agent.description}${agent.routing?.triggers?.length ? `; triggers=${agent.routing.triggers.join(",")}` : ""}${agent.routing?.useWhen?.length ? `; useWhen=${agent.routing.useWhen.join(";")}` : ""}${agent.routing?.avoidWhen?.length ? `; avoidWhen=${agent.routing.avoidWhen.join(";")}` : ""}${agent.routing?.cost ? `; cost=${agent.routing.cost}` : ""}${agent.routing?.category ? `; category=${agent.routing.category}` : ""}`,
+				)
+			: ["- (none)"]),
 	];
 	return capLines(lines, maxChars).join("\n");
 }
 
-export function appendAutonomousPolicy(systemPrompt: string, userPrompt: string, config: PiTeamsAutonomousConfig = {}, cwd?: string): string {
+export function appendAutonomousPolicy(
+	systemPrompt: string,
+	userPrompt: string,
+	config: PiTeamsAutonomousConfig = {},
+	cwd?: string,
+): string {
 	const resourceGuidance = cwd ? `\n\n${buildResourceRoutingGuidance(cwd)}` : "";
 	return `${systemPrompt}\n\n${buildAutonomousPolicy(userPrompt, config)}${resourceGuidance}`;
 }
 
 export function registerAutonomousPolicy(pi: ExtensionAPI): void {
 	pi.on("before_agent_start", (event: BeforeAgentStartEvent) => {
-		const options = (event as BeforeAgentStartEvent & { systemPromptOptions?: { cwd?: unknown } }).systemPromptOptions ?? {};
+		const options =
+			(
+				event as BeforeAgentStartEvent & {
+					systemPromptOptions?: { cwd?: unknown };
+				}
+			).systemPromptOptions ?? {};
 		const cwd = typeof options.cwd === "string" ? options.cwd : undefined;
 		const loaded = loadConfig(cwd);
 		const autonomous = effectiveAutonomousConfig(loaded.config.autonomous);
 		if (!autonomous.enabled) return undefined;
 		if (!autonomous.injectPolicy) return undefined;
-		return { systemPrompt: appendAutonomousPolicy(event.systemPrompt, event.prompt, autonomous, cwd) };
+		return {
+			systemPrompt: appendAutonomousPolicy(event.systemPrompt, event.prompt, autonomous, cwd),
+		};
 	});
 }

package/src/extension/command-completions.ts

@@ -10,19 +10,20 @@
  * requiring the user to memorize long generated IDs.
  */
 import type { AutocompleteItem } from "@earendil-works/pi-tui";
-import { listRecentRuns } from "./run-index.ts";
-import { discoverTeams, allTeams } from "../teams/discover-teams.ts";
-import { discoverWorkflows, allWorkflows } from "../workflows/discover-workflows.ts";
-import { discoverAgents, allAgents } from "../agents/discover-agents.ts";
+import { allAgents, discoverAgents } from "../agents/discover-agents.ts";
 import type { TeamRunManifest } from "../state/types.ts";
+import { allTeams, discoverTeams } from "../teams/discover-teams.ts";
+import { allWorkflows, discoverWorkflows } from "../workflows/discover-workflows.ts";
+import { listRecentRuns } from "./run-index.ts";
 
 const MAX_RUN_SUGGESTIONS = 15;
 
 function filterByPrefix(items: AutocompleteItem[], prefix: string): AutocompleteItem[] | null {
 	const trimmed = prefix.trim();
-	const filtered = trimmed === ""
-		? items
-		: items.filter((item) => item.value.startsWith(trimmed) || item.label.toLowerCase().includes(trimmed.toLowerCase()));
+	const filtered =
+		trimmed === ""
+			? items
+			: items.filter((item) => item.value.startsWith(trimmed) || item.label.toLowerCase().includes(trimmed.toLowerCase()));
 	return filtered.length > 0 ? filtered.slice(0, MAX_RUN_SUGGESTIONS) : null;
 }
 
@@ -67,7 +68,7 @@ export function suggestRunIds(_prefix: string, cwd?: string): AutocompleteItem[]
 export async function suggestTaskIds(runId: string, prefix: string, cwd?: string): Promise<AutocompleteItem[] | null> {
 	const resolvedCwd = cwd ?? process.cwd();
 	// Dynamic import to avoid pulling state-store into the hot command-registration path.
-		// LAZY: defer dynamic import of ../state/state-store.ts to its call site.
+	// LAZY: defer dynamic import of ../state/state-store.ts to its call site.
 	const { loadRunManifestById } = await import("../state/state-store.ts");
 	const loaded = loadRunManifestById(resolvedCwd, runId);
 	if (!loaded) return null;

package/src/extension/context-status-injection.ts

@@ -33,10 +33,10 @@
 
 import type { AgentMessage } from "@earendil-works/pi-agent-core";
 import type { Message } from "@earendil-works/pi-ai";
-import type { ExtensionAPI, ContextEvent } from "@earendil-works/pi-coding-agent";
-import { collectInFlightRuns } from "./registration/compaction-guard.ts";
-import { extractSessionId } from "../utils/session-utils.ts";
+import type { ContextEvent, ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { TeamRunManifest } from "../state/types.ts";
+import { extractSessionId } from "../utils/session-utils.ts";
+import { collectInFlightRuns } from "./registration/compaction-guard.ts";
 
 /** Sentinel that marks an injected ambient-status user message. */
 export const AMBIENT_STATUS_SENTINEL = "[pi-crew ambient status";
@@ -64,7 +64,9 @@ function runAge(createdAt?: string, updatedAt?: string): string {
 		if (Number.isFinite(created)) {
 			return `, running ${humanizeMs(Date.now() - created)}`;
 		}
-	} catch { /* ignore malformed timestamps */ }
+	} catch {
+		/* ignore malformed timestamps */
+	}
 	return "";
 }
 
@@ -84,8 +86,7 @@ function humanizeMs(ms: number): string {
  */
 export function formatAmbientStatus(runs: TeamRunManifest[]): string {
 	if (runs.length === 0) return "";
-	const truncate = (s: string, n: number): string =>
-		s.length > n ? `${s.slice(0, n - 1)}…` : s;
+	const truncate = (s: string, n: number): string => (s.length > n ? `${s.slice(0, n - 1)}…` : s);
 	const lines: string[] = [
 		`${AMBIENT_STATUS_SENTINEL} — environmental context, not a user request]`,
 		`${runs.length} pi-crew run${runs.length === 1 ? "" : "s"} in flight:`,
@@ -99,7 +100,9 @@ export function formatAmbientStatus(runs: TeamRunManifest[]): string {
 	if (runs.length > MAX_INLINE_RUNS) {
 		lines.push(`• …and ${runs.length - MAX_INLINE_RUNS} more`);
 	}
-	lines.push("Inspect/join via the `team` tool: action=\"status\" (list), action=\"wait\" (join running), action=\"summary\"/action=\"get\" (results).");
+	lines.push(
+		'Inspect/join via the `team` tool: action="status" (list), action="wait" (join running), action="summary"/action="get" (results).',
+	);
 	return lines.join("\n");
 }
 
@@ -163,10 +166,7 @@ export function handleContextEvent(event: ContextEvent, cwd: string, sessionId?:
  * Pass `enabled: false` (from `runtime.reliability.ambientStatusInjection`) to
  * disable the feature without unwiring the handler.
  */
-export function registerContextStatusInjection(
-	pi: ExtensionAPI,
-	opts: { enabled?: boolean } = {},
-): void {
+export function registerContextStatusInjection(pi: ExtensionAPI, opts: { enabled?: boolean } = {}): void {
 	if (opts.enabled === false) return;
 	pi.on("context", (event: ContextEvent, ctx: unknown): AmbientContextResult | undefined => {
 		// crew state is per-project; use the session ctx cwd when available,
@@ -176,7 +176,9 @@ export function registerContextStatusInjection(
 		const cwd =
 			typeof ctx === "object" && ctx !== null && typeof (ctx as { cwd?: unknown }).cwd === "string"
 				? (ctx as { cwd: string }).cwd
-				: typeof process.cwd === "function" ? process.cwd() : ".";
+				: typeof process.cwd === "function"
+					? process.cwd()
+					: ".";
 		const sessionId = extractSessionId(ctx);
 		return handleContextEvent(event, cwd, sessionId);
 	});

package/src/extension/crew-autocomplete.ts

@@ -12,11 +12,7 @@
  * slash-command, file (`@`), and command-argument completion all keep working
  * unchanged.
  */
-import type {
-	AutocompleteItem,
-	AutocompleteProvider,
-	AutocompleteSuggestions,
-} from "@earendil-works/pi-tui";
+import type { AutocompleteItem, AutocompleteProvider, AutocompleteSuggestions } from "@earendil-works/pi-tui";
 import { CREW_PHRASES } from "./crew-input-router.ts";
 
 /** Max phrases to suggest. */
@@ -68,9 +64,7 @@ export function suggestCrewPhrases(query: string): AutocompleteItem[] {
  * a crew natural-language trigger, returns phrase suggestions; otherwise
  * delegates to `current`.
  */
-export function createCrewAutocompleteProvider(
-	current: AutocompleteProvider,
-): AutocompleteProvider {
+export function createCrewAutocompleteProvider(current: AutocompleteProvider): AutocompleteProvider {
 	return {
 		async getSuggestions(
 			lines: string[],
@@ -115,11 +109,7 @@ export function createCrewAutocompleteProvider(
 			return current.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
 		},
 
-		shouldTriggerFileCompletion(
-			lines: string[],
-			cursorLine: number,
-			cursorCol: number,
-		): boolean {
+		shouldTriggerFileCompletion(lines: string[], cursorLine: number, cursorCol: number): boolean {
 			// Suppress file-completion trigger inside a crew phrase so the
 			// editor doesn't pop a file list over our phrase suggestions.
 			if (cursorLine === 0) {
@@ -132,8 +122,10 @@ export function createCrewAutocompleteProvider(
 }
 
 /** Register the crew autocomplete provider on a Pi UI context. Safe to call once. */
-export function registerCrewAutocomplete(
-	ctx: { ui?: { addAutocompleteProvider?: (factory: (current: AutocompleteProvider) => AutocompleteProvider) => void } },
-): void {
+export function registerCrewAutocomplete(ctx: {
+	ui?: {
+		addAutocompleteProvider?: (factory: (current: AutocompleteProvider) => AutocompleteProvider) => void;
+	};
+}): void {
 	ctx.ui?.addAutocompleteProvider?.((current) => createCrewAutocompleteProvider(current));
 }

package/src/extension/crew-cleanup.ts

@@ -1,6 +1,7 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { logInternalError } from "../utils/internal-error.ts";
 import { cleanupAllTrackedTempDirs } from "../runtime/pi-args.ts";
+import { logInternalError } from "../utils/internal-error.ts";
+
 // NOTE: globalProgressTracker import kept for documentation but not directly used
 // since we don't have agent IDs to untrack. Actual progress clearing should be
 // handled by the progress tracker itself on shutdown.

package/src/extension/crew-shortcuts.ts

@@ -50,7 +50,7 @@ const CREW_SHORTCUTS: ReadonlyArray<ShortcutRegistration> = [
 		// (avoids pulling the full commands.ts dependency tree into every
 		// process that imports this module, e.g. the unit test).
 		handler: async (ctx) => {
-		// LAZY: defer dynamic import of ./registration/commands.ts to its call site.
+			// LAZY: defer dynamic import of ./registration/commands.ts to its call site.
 			const { openTeamSettingsOverlay } = await import("./registration/commands.ts");
 			await openTeamSettingsOverlay(ctx);
 		},
@@ -61,7 +61,7 @@ const CREW_SHORTCUTS: ReadonlyArray<ShortcutRegistration> = [
 		// Lazy-import so the heavy UI module chain (RunDashboard etc.) is only
 		// loaded on first use, not at extension load.
 		handler: async (ctx) => {
-		// LAZY: defer dynamic import of ./registration/commands.ts to its call site.
+			// LAZY: defer dynamic import of ./registration/commands.ts to its call site.
 			const { openTeamDashboard } = await import("./registration/commands.ts");
 			await openTeamDashboard(ctx);
 		},
@@ -72,11 +72,14 @@ const CREW_SHORTCUTS: ReadonlyArray<ShortcutRegistration> = [
  * Register all crew keyboard shortcuts on a Pi instance. Safe to call once at
  * extension load. No-ops when `registerShortcut` is unavailable (older Pi).
  */
-export function registerCrewShortcuts(
-	pi: { registerShortcut?: (shortcut: KeyId, options: { description?: string; handler: ShortcutHandler }) => void },
-): void {
+export function registerCrewShortcuts(pi: {
+	registerShortcut?: (shortcut: KeyId, options: { description?: string; handler: ShortcutHandler }) => void;
+}): void {
 	for (const sc of CREW_SHORTCUTS) {
-		pi.registerShortcut?.(sc.key, { description: sc.description, handler: sc.handler });
+		pi.registerShortcut?.(sc.key, {
+			description: sc.description,
+			handler: sc.handler,
+		});
 	}
 }