lsd-pi 1.0.0 → 1.1.0

package/src/resources/extensions/gsd/collision-diagnostics.ts

@@ -1,332 +0,0 @@
-/**
- * Collision Diagnostics Module
- *
- * Bridges NamespacedRegistry collision data and NamespacedResolver ambiguous
- * resolution into a classified diagnostic taxonomy. Provides two functions:
- * - analyzeCollisions: Scans registry and resolver state to produce classified diagnostics
- * - doctorReport: Formats diagnostics into human-readable output with severity and remediation
- *
- * This module implements R010 (collision reporting) and R011 (doctor advice) for the
- * namespaced component system.
- */
-
-import type { NamespacedRegistry, RegistryDiagnostic } from './namespaced-registry.js';
-import type { NamespacedResolver, ResolutionResult } from './namespaced-resolver.js';
-
-// ============================================================================
-// Type Definitions
-// ============================================================================
-
-/**
- * Classification of collision type.
- * - canonical-conflict: Two plugins registered the same canonical name (hard error)
- * - shorthand-overlap: Same bare name exists in multiple namespaces (ambiguity)
- * - alias-conflict: Alias shadows a canonical name or bare component name
- */
-export type CollisionClass = 'canonical-conflict' | 'shorthand-overlap' | 'alias-conflict';
-
-/**
- * Severity level for diagnostics.
- * - error: Hard collision that prevents correct resolution
- * - warning: Ambiguity that may cause surprising behavior
- */
-export type DiagnosticSeverity = 'error' | 'warning';
-
-/**
- * A classified diagnostic with full context for remediation.
- */
-export interface ClassifiedDiagnostic {
-	/** The collision classification */
-	class: CollisionClass;
-
-	/** Severity level */
-	severity: DiagnosticSeverity;
-
-	/** All canonical names involved in the collision */
-	involvedCanonicalNames: string[];
-
-	/** File paths to the conflicting components */
-	filePaths: string[];
-
-	/** Human-readable remediation advice */
-	remediation: string;
-
-	/** Optional: the bare name causing ambiguity (shorthand-overlap only) */
-	ambiguousBareName?: string;
-
-	/** Optional: the alias string (alias-conflict only) */
-	alias?: string;
-
-	/** Optional: the canonical name the alias points to (alias-conflict only) */
-	aliasTarget?: string;
-
-	/** Optional: type of alias conflict */
-	aliasConflictType?: 'shadows-canonical' | 'shadows-bare-name';
-}
-
-/**
- * Doctor report with summary statistics and formatted entries.
- */
-export interface DoctorReport {
-	/** Summary counts by class */
-	summary: {
-		/** Total diagnostics */
-		total: number;
-		/** Canonical conflicts (errors) */
-		canonicalConflicts: number;
-		/** Shorthand overlaps (warnings) */
-		shorthandOverlaps: number;
-		/** Alias conflicts (warnings) */
-		aliasConflicts: number;
-	};
-
-	/** Formatted report entries */
-	entries: string[];
-}
-
-// ============================================================================
-// Implementation
-// ============================================================================
-
-/**
- * Analyze a registry and resolver to produce classified diagnostics.
- *
- * This function:
- * 1. Reads registry.getDiagnostics() for canonical conflicts (→ error severity)
- * 2. Groups registry.getAll() by bare component.name
- * 3. For groups with 2+ entries, calls resolver.resolve(bareName) to confirm ambiguity
- * 4. Produces warning diagnostics for ambiguous shorthand resolution
- *
- * @param registry - The namespaced registry to analyze
- * @param resolver - The resolver to test ambiguity
- * @returns Array of classified diagnostics
- */
-export function analyzeCollisions(
-	registry: NamespacedRegistry,
-	resolver: NamespacedResolver
-): ClassifiedDiagnostic[] {
-	const diagnostics: ClassifiedDiagnostic[] = [];
-
-	// Step 1: Process canonical conflicts from registry diagnostics
-	const registryDiagnostics = registry.getDiagnostics();
-	for (const diag of registryDiagnostics) {
-		if (diag.type === 'collision') {
-			diagnostics.push({
-				class: 'canonical-conflict',
-				severity: 'error',
-				involvedCanonicalNames: [diag.collision.canonicalName],
-				filePaths: [diag.collision.winnerPath, diag.collision.loserPath],
-				remediation: `Canonical name "${diag.collision.canonicalName}" registered multiple times. ` +
-					`The first registration (${diag.collision.winnerSource ?? 'unknown source'}) ` +
-					`took precedence over subsequent registration (${diag.collision.loserSource ?? 'unknown source'}). ` +
-					`Rename one of the conflicting components to resolve.`,
-			});
-		}
-	}
-
-	// Step 2: Find shorthand overlaps by grouping components by bare name
-	const components = registry.getAll();
-	const byBareName = new Map<string, typeof components>();
-
-	for (const component of components) {
-		const bareName = component.name;
-		if (!byBareName.has(bareName)) {
-			byBareName.set(bareName, []);
-		}
-		byBareName.get(bareName)!.push(component);
-	}
-
-	// Step 3: For groups with 2+ entries, check if resolver confirms ambiguity
-	for (const [bareName, candidates] of byBareName) {
-		if (candidates.length >= 2) {
-			// Use resolver to confirm ambiguity
-			const result = resolver.resolve(bareName);
-
-			if (result.resolution === 'ambiguous') {
-				// This is a shorthand overlap
-				const canonicalNames = candidates.map(c => c.canonicalName);
-				const filePaths = candidates.map(c => c.filePath);
-
-				diagnostics.push({
-					class: 'shorthand-overlap',
-					severity: 'warning',
-					involvedCanonicalNames: canonicalNames,
-					filePaths,
-					remediation: formatShorthandRemediation(bareName, canonicalNames),
-					ambiguousBareName: bareName,
-				});
-			}
-			// If resolution is 'shorthand' or 'local-first', the overlap is resolved
-			// unambiguously by the resolver, so we don't warn
-		}
-	}
-
-	// Step 4: Check for alias conflicts
-	const aliases = registry.getAliases();
-	const canonicalNamesSet = new Set(components.map(c => c.canonicalName));
-
-	for (const [alias, targetCanonical] of aliases) {
-		// Check if alias shadows a canonical name
-		// (This can happen if a component was registered AFTER the alias was created)
-		if (canonicalNamesSet.has(alias)) {
-			const shadowedComponent = components.find(c => c.canonicalName === alias);
-			const aliasedComponent = components.find(c => c.canonicalName === targetCanonical);
-
-			diagnostics.push({
-				class: 'alias-conflict',
-				severity: 'warning',
-				involvedCanonicalNames: [alias, targetCanonical],
-				filePaths: [
-					shadowedComponent?.filePath ?? '<unknown>',
-					aliasedComponent?.filePath ?? '<unknown>',
-				],
-				remediation: formatAliasShadowsCanonicalRemediation(alias, targetCanonical),
-				alias,
-				aliasTarget: targetCanonical,
-				aliasConflictType: 'shadows-canonical',
-			});
-			continue; // Skip further checks for this alias
-		}
-
-		// Check if alias shadows a bare name (matches component.name in any namespace)
-		const matchingBareNames = components.filter(c => c.name === alias);
-		if (matchingBareNames.length > 0) {
-			const filePaths = matchingBareNames.map(c => c.filePath);
-			const aliasedComponent = components.find(c => c.canonicalName === targetCanonical);
-			if (aliasedComponent) filePaths.push(aliasedComponent.filePath);
-
-			diagnostics.push({
-				class: 'alias-conflict',
-				severity: 'warning',
-				involvedCanonicalNames: [targetCanonical, ...matchingBareNames.map(c => c.canonicalName)],
-				filePaths,
-				remediation: formatAliasShadowsBareNameRemediation(alias, targetCanonical, matchingBareNames.map(c => c.canonicalName)),
-				alias,
-				aliasTarget: targetCanonical,
-				aliasConflictType: 'shadows-bare-name',
-			});
-		}
-	}
-
-	return diagnostics;
-}
-
-/**
- * Format remediation advice for shorthand overlap.
- *
- * @param bareName - The ambiguous bare name
- * @param canonicalNames - All canonical names that match
- * @returns Human-readable remediation message
- */
-function formatShorthandRemediation(bareName: string, canonicalNames: string[]): string {
-	const suggestions = canonicalNames
-		.map(cn => `\`${cn}\``)
-		.join(', ');
-
-	return `Bare name "${bareName}" is ambiguous across ${canonicalNames.length} namespaces. ` +
-		`Use a canonical name (${suggestions}) to avoid ambiguity.`;
-}
-
-/**
- * Format remediation advice for alias shadowing a canonical name.
- *
- * @param alias - The alias that shadows a canonical name
- * @param targetCanonical - The canonical name the alias points to
- * @returns Human-readable remediation message
- */
-function formatAliasShadowsCanonicalRemediation(alias: string, targetCanonical: string): string {
-	return `Alias "${alias}" shadows an existing canonical name. ` +
-		`The alias points to "${targetCanonical}", but resolving "${alias}" will now match the component, not the alias. ` +
-		`Consider rename or remove the alias to avoid confusion.`;
-}
-
-/**
- * Format remediation advice for alias shadowing a bare name.
- *
- * @param alias - The alias that shadows bare names
- * @param targetCanonical - The canonical name the alias points to
- * @param shadowedCanonicals - The canonical names whose bare names are shadowed
- * @returns Human-readable remediation message
- */
-function formatAliasShadowsBareNameRemediation(
-	alias: string,
-	targetCanonical: string,
-	shadowedCanonicals: string[]
-): string {
-	const shadowed = shadowedCanonicals.map(cn => `\`${cn}\``).join(', ');
-	return `Alias "${alias}" shadows ${shadowedCanonicals.length} component(s) with the same bare name (${shadowed}). ` +
-		`Resolving "${alias}" will use the alias (pointing to "${targetCanonical}"), not shorthand resolution. ` +
-		`Use canonical names to be explicit, or rename the alias if this is unintended.`;
-}
-
-/**
- * Format diagnostics into a human-readable doctor report.
- *
- * Each diagnostic is formatted with:
- * - Severity icon (❌ error / ⚠️ warning)
- * - Description of the issue
- * - Involved file paths
- * - Remediation advice
- *
- * @param diagnostics - Array of classified diagnostics
- * @returns Doctor report with summary and formatted entries
- */
-export function doctorReport(diagnostics: ClassifiedDiagnostic[]): DoctorReport {
-	const summary = {
-		total: diagnostics.length,
-		canonicalConflicts: diagnostics.filter(d => d.class === 'canonical-conflict').length,
-		shorthandOverlaps: diagnostics.filter(d => d.class === 'shorthand-overlap').length,
-		aliasConflicts: diagnostics.filter(d => d.class === 'alias-conflict').length,
-	};
-
-	const entries = diagnostics.map(diagnostic => formatDiagnosticEntry(diagnostic));
-
-	return { summary, entries };
-}
-
-/**
- * Format a single diagnostic entry for display.
- *
- * @param diagnostic - The diagnostic to format
- * @returns Formatted string entry
- */
-function formatDiagnosticEntry(diagnostic: ClassifiedDiagnostic): string {
-	const icon = diagnostic.severity === 'error' ? '❌' : '⚠️';
-	const lines: string[] = [];
-
-	// Header with severity and class
-	lines.push(`${icon} ${diagnostic.class.toUpperCase()}`);
-
-	// Description
-	if (diagnostic.class === 'canonical-conflict') {
-		lines.push(`   Canonical name conflict: ${diagnostic.involvedCanonicalNames[0]}`);
-	} else if (diagnostic.class === 'alias-conflict') {
-		if (diagnostic.aliasConflictType === 'shadows-canonical') {
-			lines.push(`   Alias "${diagnostic.alias}" shadows canonical name (points to ${diagnostic.aliasTarget})`);
-		} else {
-			lines.push(`   Alias "${diagnostic.alias}" shadows bare name (points to ${diagnostic.aliasTarget})`);
-		}
-	} else {
-		lines.push(`   Shorthand overlap: "${diagnostic.ambiguousBareName}" matches ${diagnostic.involvedCanonicalNames.length} components`);
-	}
-
-	// File paths
-	lines.push('   Files:');
-	for (const path of diagnostic.filePaths) {
-		lines.push(`     - ${path}`);
-	}
-
-	// Remediation
-	lines.push(`   Remediation: ${diagnostic.remediation}`);
-
-	return lines.join('\n');
-}
-
-// ============================================================================
-// Exports
-// ============================================================================
-
-export default {
-	analyzeCollisions,
-	doctorReport,
-};

package/src/resources/extensions/gsd/commands/catalog.ts

@@ -1,359 +0,0 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-
-import { loadRegistry } from "../workflow-templates.js";
-import { resolveProjectRoot } from "../worktree.js";
-
-const gsdHome = process.env.LSD_HOME || join(homedir(), ".lsd");
-
-export interface GsdCommandDefinition {
-  cmd: string;
-  desc: string;
-}
-
-type CompletionMap = Record<string, readonly GsdCommandDefinition[]>;
-
-export const GSD_COMMAND_DESCRIPTION =
-  "GSD — Lucent Software Developer: /gsd help|start|templates|next|auto|stop|pause|status|widget|visualize|queue|quick|discuss|capture|triage|dispatch|history|undo|undo-task|reset-slice|rate|skip|export|cleanup|mode|prefs|config|keys|hooks|run-hook|skill-health|doctor|logs|forensics|changelog|migrate|remote|steer|knowledge|new-milestone|parallel|cmux|park|unpark|init|setup|inspect|extensions|update|fast|mcp|rethink";
-
-export const TOP_LEVEL_SUBCOMMANDS: readonly GsdCommandDefinition[] = [
-  { cmd: "help", desc: "Categorized command reference with descriptions" },
-  { cmd: "next", desc: "Explicit step mode (same as /gsd)" },
-  { cmd: "auto", desc: "Autonomous mode — research, plan, execute, commit, repeat" },
-  { cmd: "stop", desc: "Stop auto mode gracefully" },
-  { cmd: "pause", desc: "Pause auto-mode (preserves state, /gsd auto to resume)" },
-  { cmd: "status", desc: "Progress dashboard" },
-  { cmd: "widget", desc: "Cycle widget: full → small → min → off" },
-  { cmd: "visualize", desc: "Open 10-tab workflow visualizer (progress, timeline, deps, metrics, health, agent, changes, knowledge, captures, export)" },
-  { cmd: "queue", desc: "Queue and reorder future milestones" },
-  { cmd: "quick", desc: "Execute a quick task without full planning overhead" },
-  { cmd: "discuss", desc: "Discuss architecture and decisions" },
-  { cmd: "capture", desc: "Fire-and-forget thought capture" },
-  { cmd: "changelog", desc: "Show categorized release notes" },
-  { cmd: "triage", desc: "Manually trigger triage of pending captures" },
-  { cmd: "dispatch", desc: "Dispatch a specific phase directly" },
-  { cmd: "history", desc: "View execution history" },
-  { cmd: "undo", desc: "Revert last completed unit" },
-  { cmd: "undo-task", desc: "Reset a specific task's completion state (DB + markdown)" },
-  { cmd: "reset-slice", desc: "Reset a slice and all its tasks (DB + markdown)" },
-  { cmd: "rate", desc: "Rate last unit's model tier (over/ok/under) — improves adaptive routing" },
-  { cmd: "skip", desc: "Prevent a unit from auto-mode dispatch" },
-  { cmd: "export", desc: "Export milestone/slice results" },
-  { cmd: "cleanup", desc: "Remove merged branches or snapshots" },
-  { cmd: "mode", desc: "Switch workflow mode (solo/team)" },
-  { cmd: "prefs", desc: "Manage preferences (model selection, timeouts, etc.)" },
-  { cmd: "config", desc: "Set API keys for external tools" },
-  { cmd: "keys", desc: "API key manager — list, add, remove, test, rotate, doctor" },
-  { cmd: "hooks", desc: "Show configured post-unit and pre-dispatch hooks" },
-  { cmd: "run-hook", desc: "Manually trigger a specific hook" },
-  { cmd: "skill-health", desc: "Skill lifecycle dashboard" },
-  { cmd: "doctor", desc: "Runtime health checks with auto-fix" },
-  { cmd: "logs", desc: "Browse activity logs, debug logs, and metrics" },
-  { cmd: "forensics", desc: "Examine execution logs" },
-  { cmd: "init", desc: "Project init wizard — detect, configure, bootstrap .gsd/" },
-  { cmd: "setup", desc: "Global setup status and configuration" },
-  { cmd: "migrate", desc: "Migrate a v1 .planning directory to .gsd format" },
-  { cmd: "remote", desc: "Control remote auto-mode" },
-  { cmd: "steer", desc: "Hard-steer plan documents during execution" },
-  { cmd: "inspect", desc: "Show SQLite DB diagnostics" },
-  { cmd: "knowledge", desc: "Add persistent project knowledge (rule, pattern, or lesson)" },
-  { cmd: "new-milestone", desc: "Create a milestone from a specification document (headless)" },
-  { cmd: "parallel", desc: "Parallel milestone orchestration (start, status, stop, merge, watch)" },
-  { cmd: "cmux", desc: "Manage cmux integration (status, sidebar, notifications, splits)" },
-  { cmd: "park", desc: "Park a milestone — skip without deleting" },
-  { cmd: "unpark", desc: "Reactivate a parked milestone" },
-  { cmd: "update", desc: "Update GSD to the latest version" },
-  { cmd: "start", desc: "Start a workflow template (bugfix, spike, feature, etc.)" },
-  { cmd: "templates", desc: "List available workflow templates" },
-  { cmd: "extensions", desc: "Manage extensions (list, enable, disable, info)" },
-  { cmd: "fast", desc: "Toggle OpenAI service tier (on/off/flex/status)" },
-  { cmd: "mcp", desc: "MCP server status and connectivity check (status, check <server>)" },
-  { cmd: "rethink", desc: "Conversational project reorganization — reorder, park, discard, add milestones" },
-  { cmd: "workflow", desc: "Custom workflow lifecycle (new, run, list, validate, pause, resume)" },
-];
-
-const NESTED_COMPLETIONS: CompletionMap = {
-  auto: [
-    { cmd: "--verbose", desc: "Show detailed execution output" },
-    { cmd: "--debug", desc: "Enable debug logging" },
-  ],
-  next: [
-    { cmd: "--verbose", desc: "Show detailed step output" },
-    { cmd: "--dry-run", desc: "Preview next step without executing" },
-    { cmd: "--debug", desc: "Enable debug logging" },
-  ],
-  widget: [
-    { cmd: "full", desc: "Full widget display" },
-    { cmd: "small", desc: "Compact widget display" },
-    { cmd: "min", desc: "Minimal widget display" },
-    { cmd: "off", desc: "Hide widget" },
-  ],
-  mode: [
-    { cmd: "global", desc: "Edit global workflow mode" },
-    { cmd: "project", desc: "Edit project-specific workflow mode" },
-  ],
-  parallel: [
-    { cmd: "start", desc: "Start parallel milestone orchestration" },
-    { cmd: "status", desc: "Show parallel worker statuses" },
-    { cmd: "stop", desc: "Stop all parallel workers" },
-    { cmd: "pause", desc: "Pause a specific worker" },
-    { cmd: "resume", desc: "Resume a paused worker" },
-    { cmd: "merge", desc: "Merge completed milestone branches" },
-    { cmd: "watch", desc: "Live TUI dashboard monitoring all workers" },
-  ],
-  setup: [
-    { cmd: "llm", desc: "Configure LLM provider settings" },
-    { cmd: "search", desc: "Configure web search provider" },
-    { cmd: "remote", desc: "Configure remote integrations" },
-    { cmd: "keys", desc: "Manage API keys" },
-    { cmd: "prefs", desc: "Configure global preferences" },
-  ],
-  logs: [
-    { cmd: "debug", desc: "List or view debug log files" },
-    { cmd: "tail", desc: "Show last N activity log summaries" },
-    { cmd: "clear", desc: "Remove old activity and debug logs" },
-  ],
-  keys: [
-    { cmd: "list", desc: "Show key status dashboard" },
-    { cmd: "add", desc: "Add a key for a provider" },
-    { cmd: "remove", desc: "Remove a key" },
-    { cmd: "test", desc: "Validate key(s) with API call" },
-    { cmd: "rotate", desc: "Replace an existing key" },
-    { cmd: "doctor", desc: "Health check all keys" },
-  ],
-  prefs: [
-    { cmd: "global", desc: "Edit global preferences file" },
-    { cmd: "project", desc: "Edit project preferences file" },
-    { cmd: "status", desc: "Show effective preferences" },
-    { cmd: "wizard", desc: "Interactive preferences wizard" },
-    { cmd: "setup", desc: "First-time preferences setup" },
-    { cmd: "import-claude", desc: "Import settings from Claude Code" },
-  ],
-  remote: [
-    { cmd: "slack", desc: "Configure Slack integration" },
-    { cmd: "discord", desc: "Configure Discord integration" },
-    { cmd: "status", desc: "Show remote connection status" },
-    { cmd: "disconnect", desc: "Disconnect remote integrations" },
-  ],
-  history: [
-    { cmd: "--cost", desc: "Show cost breakdown per entry" },
-    { cmd: "--phase", desc: "Filter by phase type" },
-    { cmd: "--model", desc: "Filter by model used" },
-    { cmd: "10", desc: "Show last 10 entries" },
-    { cmd: "20", desc: "Show last 20 entries" },
-    { cmd: "50", desc: "Show last 50 entries" },
-  ],
-  export: [
-    { cmd: "--json", desc: "Export as JSON" },
-    { cmd: "--markdown", desc: "Export as Markdown" },
-    { cmd: "--html", desc: "Export as HTML" },
-    { cmd: "--html --all", desc: "Export all milestones as HTML" },
-  ],
-  cleanup: [
-    { cmd: "branches", desc: "Remove merged milestone and legacy branches" },
-    { cmd: "snapshots", desc: "Remove old execution snapshots" },
-    { cmd: "worktrees", desc: "Remove merged/safe-to-delete worktrees" },
-    { cmd: "projects", desc: "Audit orphaned ~/.gsd/projects/ state directories" },
-    { cmd: "projects --fix", desc: "Delete orphaned project state directories (cannot be undone)" },
-  ],
-  knowledge: [
-    { cmd: "rule", desc: "Add a project rule (always/never do X)" },
-    { cmd: "pattern", desc: "Add a code pattern to follow" },
-    { cmd: "lesson", desc: "Record a lesson learned" },
-  ],
-  start: [
-    { cmd: "bugfix", desc: "Triage, fix, test, and ship a bug fix" },
-    { cmd: "small-feature", desc: "Lightweight feature with optional discussion" },
-    { cmd: "spike", desc: "Research, prototype, and document findings" },
-    { cmd: "hotfix", desc: "Minimal: fix it, test it, ship it" },
-    { cmd: "refactor", desc: "Inventory, plan waves, migrate, verify" },
-    { cmd: "security-audit", desc: "Scan, triage, remediate, re-scan" },
-    { cmd: "dep-upgrade", desc: "Assess, upgrade, fix breaks, verify" },
-    { cmd: "full-project", desc: "Complete GSD workflow with full ceremony" },
-    { cmd: "resume", desc: "Resume an in-progress workflow" },
-    { cmd: "--list", desc: "List all available templates" },
-    { cmd: "--dry-run", desc: "Preview workflow without executing" },
-  ],
-  templates: [
-    { cmd: "info", desc: "Show detailed template info" },
-  ],
-  extensions: [
-    { cmd: "list", desc: "List all extensions and their status" },
-    { cmd: "enable", desc: "Enable a disabled extension" },
-    { cmd: "disable", desc: "Disable an extension" },
-    { cmd: "info", desc: "Show extension details" },
-  ],
-  fast: [
-    { cmd: "on", desc: "Priority tier (2x cost, faster)" },
-    { cmd: "off", desc: "Disable service tier" },
-    { cmd: "flex", desc: "Flex tier (0.5x cost, slower)" },
-    { cmd: "status", desc: "Show current service tier setting" },
-  ],
-  mcp: [
-    { cmd: "status", desc: "Show all MCP server statuses (default)" },
-    { cmd: "check", desc: "Detailed status for a specific server" },
-  ],
-  doctor: [
-    { cmd: "fix", desc: "Auto-fix detected issues" },
-    { cmd: "heal", desc: "AI-driven deep healing" },
-    { cmd: "audit", desc: "Run health audit without fixing" },
-    { cmd: "--dry-run", desc: "Show what --fix would change without applying" },
-    { cmd: "--json", desc: "Output report as JSON (CI/tooling friendly)" },
-    { cmd: "--build", desc: "Include slow build health check (npm run build)" },
-    { cmd: "--test", desc: "Include slow test health check (npm test)" },
-  ],
-  dispatch: [
-    { cmd: "research", desc: "Run research phase" },
-    { cmd: "plan", desc: "Run planning phase" },
-    { cmd: "execute", desc: "Run execution phase" },
-    { cmd: "complete", desc: "Run completion phase" },
-    { cmd: "reassess", desc: "Reassess current progress" },
-    { cmd: "uat", desc: "Run user acceptance testing" },
-    { cmd: "replan", desc: "Replan the current slice" },
-  ],
-  rate: [
-    { cmd: "over", desc: "Model was overqualified for this task" },
-    { cmd: "ok", desc: "Model was appropriate for this task" },
-    { cmd: "under", desc: "Model was underqualified for this task" },
-  ],
-  workflow: [
-    { cmd: "new", desc: "Create a new workflow definition (via skill)" },
-    { cmd: "run", desc: "Create a run and start auto-mode" },
-    { cmd: "list", desc: "List workflow runs" },
-    { cmd: "validate", desc: "Validate a workflow definition YAML" },
-    { cmd: "pause", desc: "Pause custom workflow auto-mode" },
-    { cmd: "resume", desc: "Resume paused custom workflow auto-mode" },
-  ],
-};
-
-function filterOptions(
-  partial: string,
-  options: readonly GsdCommandDefinition[],
-  prefix = "",
-) {
-  const normalizedPrefix = prefix ? `${prefix} ` : "";
-  return options
-    .filter((option) => option.cmd.startsWith(partial))
-    .map((option) => ({
-      value: `${normalizedPrefix}${option.cmd}`,
-      label: option.cmd,
-      description: option.desc,
-    }));
-}
-
-function getExtensionCompletions(prefix: string, action: string) {
-  try {
-    const extDir = join(gsdHome, "agent", "extensions");
-    const ids: Array<{ id: string; name: string }> = [];
-    for (const entry of readdirSync(extDir, { withFileTypes: true })) {
-      if (!entry.isDirectory()) continue;
-      const manifestPath = join(extDir, entry.name, "extension-manifest.json");
-      if (!existsSync(manifestPath)) continue;
-      try {
-        const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
-        if (typeof manifest?.id === "string") {
-          ids.push({ id: manifest.id, name: manifest.name ?? manifest.id });
-        }
-      } catch {
-        // ignore malformed manifests
-      }
-    }
-    return ids
-      .filter((entry) => entry.id.startsWith(prefix))
-      .map((entry) => ({
-        value: `extensions ${action} ${entry.id}`,
-        label: entry.id,
-        description: entry.name,
-      }));
-  } catch {
-    return [];
-  }
-}
-
-export function getGsdArgumentCompletions(prefix: string) {
-  const hasTrailingSpace = prefix.endsWith(" ");
-  const parts = prefix.trim().split(/\s+/);
-  if (hasTrailingSpace && parts.length >= 1) {
-    parts.push("");
-  }
-
-  if (parts.length <= 1) {
-    return filterOptions(parts[0] ?? "", TOP_LEVEL_SUBCOMMANDS);
-  }
-
-  const [command, subcommand = "", third = ""] = parts;
-
-  if (command === "cmux") {
-    if (parts.length <= 2) {
-      return filterOptions(subcommand, [
-        { cmd: "status", desc: "Show cmux detection, prefs, and capabilities" },
-        { cmd: "on", desc: "Enable cmux integration" },
-        { cmd: "off", desc: "Disable cmux integration" },
-        { cmd: "notifications", desc: "Toggle cmux desktop notifications" },
-        { cmd: "sidebar", desc: "Toggle cmux sidebar metadata" },
-        { cmd: "splits", desc: "Toggle cmux visual subagent splits" },
-        { cmd: "browser", desc: "Toggle future browser integration flag" },
-      ], "cmux");
-    }
-    if (parts.length <= 3 && ["notifications", "sidebar", "splits", "browser"].includes(subcommand)) {
-      return filterOptions(third, [
-        { cmd: "on", desc: "Enable this cmux area" },
-        { cmd: "off", desc: "Disable this cmux area" },
-      ], `cmux ${subcommand}`);
-    }
-    return [];
-  }
-
-  if (command === "templates" && subcommand === "info" && parts.length <= 3) {
-    try {
-      const registry = loadRegistry();
-      return Object.entries(registry.templates)
-        .filter(([id]) => id.startsWith(third))
-        .map(([id, entry]) => ({
-          value: `templates info ${id}`,
-          label: id,
-          description: entry.description,
-        }));
-    } catch {
-      return [];
-    }
-  }
-
-  if (command === "extensions" && parts.length === 3 && ["enable", "disable", "info"].includes(subcommand)) {
-    return getExtensionCompletions(third, subcommand);
-  }
-
-  if (command === "undo" && parts.length <= 2) {
-    return [{ value: "undo --force", label: "--force", description: "Skip confirmation prompt" }];
-  }
-
-  // Workflow definition-name completion for `workflow run <name>` and `workflow validate <name>`
-  if (command === "workflow" && (subcommand === "run" || subcommand === "validate") && parts.length <= 3) {
-    try {
-      const defsDir = join(resolveProjectRoot(process.cwd()), ".gsd", "workflow-defs");
-      if (existsSync(defsDir)) {
-        return readdirSync(defsDir)
-          .filter((f) => f.endsWith(".yaml") && f.startsWith(third))
-          .map((f) => {
-            const name = f.replace(/\.yaml$/, "");
-            return {
-              value: `workflow ${subcommand} ${name}`,
-              label: name,
-              description: `Workflow definition: ${name}`,
-            };
-          });
-      }
-    } catch {
-      // ignore filesystem errors during completion
-    }
-    return [];
-  }
-
-  const nested = NESTED_COMPLETIONS[command];
-  if (nested && parts.length <= 2) {
-    return filterOptions(subcommand, nested, command);
-  }
-
-  return [];
-}