@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/commands-v2/handlers/team.js

@@ -0,0 +1,549 @@
+/**
+ * Team Commands for REPL V2
+ *
+ * Commands for managing multi-agent teams.
+ */
+import pc from 'picocolors';
+import { TeamOverlayV2 } from '../../ui/overlay/impl/team-overlay-v2.js';
+import { CustomAgentFormOverlayV2 } from '../../ui/overlay/impl/custom-agent-form-overlay-v2.js';
+import { ArtifactOverlayV2, ArtifactDetailOverlayV2 } from '../../ui/overlay/index.js';
+import { ROLE_METADATA, PREDEFINED_ROLE_IDS } from '../../multi-agent/index.js';
+import { loadCustomAgents, createCustomAgentDefinition, addCustomAgent, removeCustomAgent, } from '../../multi-agent/custom-agents.js';
+import { getCurrentProject } from '../../tools/project-db.js';
+import { getSessionRegistry } from '../../multi-agent/session-registry.js';
+import { saveCurrentTeam, saveCurrentSession } from './session.js';
+// =============================================================================
+// Helper: Save team roster + session (ensures session file exists for /resume)
+// =============================================================================
+/**
+ * Save team state and also persist the default agent's session.
+ * This ensures a `current-{prefix}.json` file exists even when
+ * the only change was an /add or /remove — making the session
+ * visible to the startup restore flow and /resume overlay.
+ */
+function saveTeamAndSession(team, ctx) {
+    saveCurrentTeam(team);
+    // Also save the session so it shows up in /resume
+    const defaultAgent = team.get('default')?.agent ?? ctx.agent;
+    if (defaultAgent) {
+        void saveCurrentSession(defaultAgent.serialize());
+    }
+}
+// =============================================================================
+// Helper: Sync team roster to session registry
+// =============================================================================
+function syncTeamRoster(team) {
+    try {
+        const registry = getSessionRegistry();
+        if (registry) {
+            const agents = team.getAll();
+            registry.updateAgents(agents.map((a) => ({
+                id: a.id,
+                displayName: a.displayName,
+                mascot: a.mascot,
+            })));
+        }
+    }
+    catch {
+        // Best effort
+    }
+}
+// =============================================================================
+// Helper: Format Team Status
+// =============================================================================
+function formatTeamStatus(team) {
+    const lines = [];
+    const agents = team.getAll();
+    lines.push(pc.bold(`Team: ${team.name}`));
+    lines.push(pc.dim(`─`.repeat(40)));
+    for (const agent of agents) {
+        const isActive = agent.id === team.activeAgentId;
+        const isCoordinator = agent.id === team.coordinatorId;
+        const prefix = isActive ? pc.green('▶') : ' ';
+        const label = agent.getFullLabel();
+        const badges = [];
+        if (isActive)
+            badges.push(pc.green('active'));
+        if (isCoordinator)
+            badges.push(pc.yellow('coordinator'));
+        const badgeStr = badges.length > 0 ? ` ${pc.dim('[')}${badges.join(pc.dim(', '))}${pc.dim(']')}` : '';
+        lines.push(`${prefix} ${label}${badgeStr}`);
+        if (agent.description) {
+            lines.push(`   ${pc.dim(agent.description)}`);
+        }
+    }
+    lines.push(pc.dim(`─`.repeat(40)));
+    lines.push(pc.dim(`${String(agents.length)} agent${agents.length !== 1 ? 's' : ''} in team`));
+    return lines;
+}
+// =============================================================================
+// /team Command
+// =============================================================================
+// Generate role list dynamically from PREDEFINED_ROLE_IDS (excluding 'default')
+const AVAILABLE_ROLES = PREDEFINED_ROLE_IDS.filter((r) => r !== 'default').join(', ');
+export const teamCommand = {
+    name: 'team',
+    description: 'Manage multi-agent team',
+    details: `Open team overlay or use subcommands: status, add <role> [id], remove <id>, switch <id>
+Roles: ${AVAILABLE_ROLES}. Switch with $agent prefix (e.g., $arch)`,
+    async execute(args, ctx) {
+        const team = ctx.team;
+        if (!team) {
+            ctx.ui.print({ type: 'warning', message: 'Multi-agent team not initialized' });
+            return true;
+        }
+        const trimmedArgs = args.trim().toLowerCase();
+        const [subcommand, ...rest] = trimmedArgs.split(/\s+/);
+        const arg = rest.join(' ');
+        // Handle subcommands
+        switch (subcommand) {
+            case '':
+                // No args - open overlay
+                return openTeamOverlay(ctx, team);
+            case 'status': {
+                // Quick status view
+                const lines = formatTeamStatus(team);
+                for (const line of lines) {
+                    ctx.ui.print({ type: 'info', message: line });
+                }
+                return true;
+            }
+            case 'add':
+                return handleAddAgent(ctx, team, arg);
+            case 'remove':
+            case 'rm':
+                return handleRemoveAgent(ctx, team, arg);
+            case 'switch':
+            case 'sw':
+                return handleSwitchAgent(ctx, team, arg);
+            case 'coordinator':
+            case 'coord':
+                return handleSetCoordinator(ctx, team, arg);
+            default:
+                // Unknown subcommand - maybe it's a role to add?
+                if (subcommand in ROLE_METADATA && subcommand !== 'default') {
+                    return handleAddAgent(ctx, team, subcommand);
+                }
+                ctx.ui.print({ type: 'error', message: `Unknown subcommand: ${subcommand}` });
+                ctx.ui.print({ type: 'info', message: 'Use /team for the team management overlay' });
+                return true;
+        }
+    },
+};
+// =============================================================================
+// Subcommand Handlers
+// =============================================================================
+async function openTeamOverlay(ctx, team) {
+    const overlay = new TeamOverlayV2(team);
+    const result = await ctx.ui.showOverlay(overlay);
+    if (result?.action === 'switch' && result.agentId) {
+        try {
+            if (ctx.switchAgent) {
+                await ctx.switchAgent(result.agentId);
+            }
+            const agent = team.get(result.agentId);
+            ctx.ui.print({
+                type: 'success',
+                message: `Switched to ${agent?.getFullLabel() ?? result.agentId}`,
+            });
+        }
+        catch (err) {
+            ctx.ui.print({
+                type: 'error',
+                message: `Failed to switch: ${err instanceof Error ? err.message : 'Unknown error'}`,
+            });
+        }
+    }
+    else if (result?.action === 'add' && result.role) {
+        try {
+            const requestedId = result.customId ?? result.role;
+            const agent = await team.addAgentFromRole(result.role, result.customId, result.modelTier);
+            // Detect cross-terminal collision (agent got a different ID)
+            if (agent.id !== requestedId) {
+                ctx.ui.print({
+                    type: 'info',
+                    message: `Agent '${requestedId}' is active in another terminal. Using '${agent.id}' instead.`,
+                });
+            }
+            syncTeamRoster(team);
+            saveTeamAndSession(team, ctx);
+            ctx.ui.print({
+                type: 'success',
+                message: `Added ${agent.getFullLabel()} to team`,
+            });
+            if (result.customId) {
+                ctx.ui.print({
+                    type: 'info',
+                    message: `Use $${agent.id} to switch to this agent`,
+                });
+            }
+        }
+        catch (err) {
+            ctx.ui.print({
+                type: 'error',
+                message: `Failed to add agent: ${err instanceof Error ? err.message : 'Unknown error'}`,
+            });
+        }
+    }
+    else if (result?.action === 'compact' && result.agentId) {
+        // Per-agent compaction
+        const teamAgent = team.get(result.agentId);
+        if (!teamAgent) {
+            ctx.ui.print({
+                type: 'error',
+                message: `Agent '${result.agentId}' not found`,
+            });
+        }
+        else if (!teamAgent.agent) {
+            ctx.ui.print({
+                type: 'warning',
+                message: `Agent '${result.agentId}' has no context to compact`,
+            });
+        }
+        else {
+            ctx.ui.print({
+                type: 'info',
+                message: `Compacting ${teamAgent.getFullLabel()}'s context...`,
+            });
+            try {
+                // Use the agent's compact method
+                await teamAgent.agent.compact();
+                ctx.ui.print({
+                    type: 'success',
+                    message: `Compacted ${teamAgent.getFullLabel()}'s context`,
+                });
+            }
+            catch (err) {
+                ctx.ui.print({
+                    type: 'error',
+                    message: `Failed to compact: ${err instanceof Error ? err.message : 'Unknown error'}`,
+                });
+            }
+        }
+    }
+    else if (result?.action === 'create-custom') {
+        // Custom agent creation
+        await handleCreateCustomAgent(ctx, team);
+    }
+    else if (result?.action === 'remove' && result.agentId) {
+        // Remove agent from team
+        const agentId = result.agentId;
+        const agent = team.get(agentId);
+        const label = agent?.getFullLabel() ?? agentId;
+        const isCustom = result.role === 'custom';
+        const wasActive = team.activeAgentId === agentId;
+        const removed = team.removeAgent(agentId);
+        if (removed) {
+            syncTeamRoster(team);
+            saveTeamAndSession(team, ctx);
+            // If the removed agent was active, team switches to default — update footer
+            if (wasActive) {
+                ctx.ui.setActiveTeamAgent(null);
+            }
+            // Also remove from custom-agents.json if it's a custom agent
+            if (isCustom) {
+                const currentProject = getCurrentProject();
+                if (currentProject?.path) {
+                    removeCustomAgent(currentProject.path, agentId);
+                }
+            }
+            ctx.ui.print({ type: 'success', message: `Removed ${label} from team` });
+        }
+        else {
+            ctx.ui.print({ type: 'error', message: `Failed to remove ${label}` });
+        }
+    }
+    else if (result?.action === 'change-tier' && result.agentId && result.modelTier) {
+        // Change agent's model tier
+        const agentId = result.agentId;
+        const newTier = result.modelTier;
+        try {
+            const agent = await team.changeAgentTier(agentId, newTier);
+            ctx.ui.print({
+                type: 'success',
+                message: `Changed ${agent.getFullLabel()} to ${newTier} model`,
+            });
+            // If this is the active agent, update the REPL's reference
+            if (agentId === team.activeAgentId && agent.agent && ctx.restoreAgent) {
+                ctx.restoreAgent(agent.agent);
+            }
+        }
+        catch (err) {
+            ctx.ui.print({
+                type: 'error',
+                message: `Failed to change tier: ${err instanceof Error ? err.message : 'Unknown error'}`,
+            });
+        }
+    }
+    return true;
+}
+async function handleCreateCustomAgent(ctx, team) {
+    // Check for project context
+    const currentProject = getCurrentProject();
+    if (!currentProject?.path) {
+        ctx.ui.print({
+            type: 'warning',
+            message: 'Select a project first to create custom agents',
+        });
+        return;
+    }
+    const projectPath = currentProject.path;
+    // Load existing custom agents for duplicate check
+    const existingCustomAgents = loadCustomAgents(projectPath);
+    const teamAgentIds = team.getAgentIds();
+    // Show custom agent form
+    const formOverlay = new CustomAgentFormOverlayV2({
+        existingCustomAgents,
+        teamAgentIds,
+    });
+    const formResult = await ctx.ui.showOverlay(formOverlay);
+    // User cancelled
+    if (!formResult || formResult.cancelled || !formResult.agent) {
+        return;
+    }
+    // Create the custom agent definition
+    const agentData = formResult.agent;
+    const agentDef = createCustomAgentDefinition(agentData.id, agentData.displayName, agentData.specialty, agentData.personality, existingCustomAgents, agentData.toolConfig, agentData.enabledSkills, agentData.modelTier);
+    // Save to project
+    try {
+        addCustomAgent(projectPath, agentDef);
+    }
+    catch (err) {
+        ctx.ui.print({
+            type: 'error',
+            message: `Failed to save custom agent: ${err instanceof Error ? err.message : 'Unknown error'}`,
+        });
+        return;
+    }
+    // Add to team
+    try {
+        const requestedId = agentDef.id;
+        const teamAgent = await team.addCustomAgent(agentDef);
+        // Detect cross-terminal collision
+        if (teamAgent.id !== requestedId) {
+            ctx.ui.print({
+                type: 'info',
+                message: `Agent '${requestedId}' is active in another terminal. Using '${teamAgent.id}' instead.`,
+            });
+        }
+        syncTeamRoster(team);
+        saveTeamAndSession(team, ctx);
+        ctx.ui.print({
+            type: 'success',
+            message: `Created ${teamAgent.getFullLabel()}`,
+        });
+        ctx.ui.print({
+            type: 'info',
+            message: `Use $${teamAgent.id} to switch to this agent`,
+        });
+    }
+    catch (err) {
+        ctx.ui.print({
+            type: 'error',
+            message: `Failed to add custom agent to team: ${err instanceof Error ? err.message : 'Unknown error'}`,
+        });
+    }
+}
+async function handleAddAgent(ctx, team, args) {
+    // Parse: /team add <role> [custom-id]
+    const parts = args.trim().split(/\s+/);
+    const roleName = parts[0];
+    const customId = parts[1]; // Optional custom ID
+    if (!roleName) {
+        ctx.ui.print({ type: 'error', message: 'Usage: /team add <role> [custom-id]' });
+        ctx.ui.print({
+            type: 'info',
+            message: `Available roles: ${Object.keys(ROLE_METADATA).filter(r => r !== 'default').join(', ')}`,
+        });
+        ctx.ui.print({
+            type: 'info',
+            message: 'Example: /team add arch my-architect',
+        });
+        return true;
+    }
+    if (!(roleName in ROLE_METADATA) || roleName === 'default') {
+        ctx.ui.print({ type: 'error', message: `Unknown role: ${roleName}` });
+        ctx.ui.print({
+            type: 'info',
+            message: `Available roles: ${Object.keys(ROLE_METADATA).filter(r => r !== 'default').join(', ')}`,
+        });
+        return true;
+    }
+    const role = roleName;
+    // Check if the agent ID (custom or role name) already exists
+    const agentId = customId || role;
+    if (team.has(agentId)) {
+        ctx.ui.print({ type: 'warning', message: `Agent '${agentId}' already exists in team` });
+        return true;
+    }
+    try {
+        const requestedId = customId || role;
+        const agent = await team.addAgentFromRole(role, customId);
+        // Detect cross-terminal collision (agent got a different ID)
+        if (agent.id !== requestedId) {
+            ctx.ui.print({
+                type: 'info',
+                message: `Agent '${requestedId}' is active in another terminal. Using '${agent.id}' instead.`,
+            });
+        }
+        syncTeamRoster(team);
+        saveTeamAndSession(team, ctx);
+        ctx.ui.print({
+            type: 'success',
+            message: `Added ${agent.getFullLabel()} to team`,
+        });
+        if (customId) {
+            ctx.ui.print({
+                type: 'info',
+                message: `Use $${agent.id} to switch to this agent`,
+            });
+        }
+    }
+    catch (err) {
+        ctx.ui.print({
+            type: 'error',
+            message: `Failed to add agent: ${err instanceof Error ? err.message : 'Unknown error'}`,
+        });
+    }
+    return true;
+}
+function handleRemoveAgent(ctx, team, agentId) {
+    if (!agentId) {
+        ctx.ui.print({ type: 'error', message: 'Usage: /team remove <agent-id>' });
+        return true;
+    }
+    if (agentId === 'default') {
+        ctx.ui.print({ type: 'error', message: 'Cannot remove the default agent' });
+        return true;
+    }
+    if (!team.has(agentId)) {
+        ctx.ui.print({ type: 'error', message: `Agent '${agentId}' not found in team` });
+        return true;
+    }
+    const agent = team.get(agentId);
+    const label = agent?.getFullLabel() ?? agentId;
+    const wasActive = team.activeAgentId === agentId;
+    const removed = team.removeAgent(agentId);
+    if (removed) {
+        syncTeamRoster(team);
+        saveTeamAndSession(team, ctx);
+        // If the removed agent was active, team switches to default — update footer
+        if (wasActive) {
+            ctx.ui.setActiveTeamAgent(null);
+        }
+        ctx.ui.print({ type: 'success', message: `Removed ${label} from team` });
+    }
+    else {
+        ctx.ui.print({ type: 'error', message: `Failed to remove ${label}` });
+    }
+    return true;
+}
+async function handleSwitchAgent(ctx, team, agentId) {
+    if (!agentId) {
+        ctx.ui.print({ type: 'error', message: 'Usage: /team switch <agent-id>' });
+        ctx.ui.print({
+            type: 'info',
+            message: `Available agents: ${team.getAgentIds().join(', ')}`,
+        });
+        return true;
+    }
+    if (!team.has(agentId)) {
+        ctx.ui.print({ type: 'error', message: `Agent '${agentId}' not found in team` });
+        ctx.ui.print({
+            type: 'info',
+            message: `Available agents: ${team.getAgentIds().join(', ')}`,
+        });
+        return true;
+    }
+    try {
+        if (ctx.switchAgent) {
+            await ctx.switchAgent(agentId);
+        }
+        const agent = team.get(agentId);
+        ctx.ui.print({
+            type: 'success',
+            message: `Switched to ${agent?.getFullLabel() ?? agentId}`,
+        });
+    }
+    catch (err) {
+        ctx.ui.print({
+            type: 'error',
+            message: `Failed to switch: ${err instanceof Error ? err.message : 'Unknown error'}`,
+        });
+    }
+    return true;
+}
+function handleSetCoordinator(ctx, team, agentId) {
+    if (!agentId) {
+        // Clear coordinator
+        if (team.coordinatorId) {
+            team.setCoordinator(undefined);
+            ctx.ui.print({ type: 'success', message: 'Cleared coordinator' });
+        }
+        else {
+            ctx.ui.print({ type: 'info', message: 'No coordinator is set' });
+            ctx.ui.print({ type: 'info', message: 'Usage: /team coordinator <agent-id>' });
+        }
+        return true;
+    }
+    if (agentId === 'none' || agentId === 'clear') {
+        team.setCoordinator(undefined);
+        ctx.ui.print({ type: 'success', message: 'Cleared coordinator' });
+        return true;
+    }
+    if (!team.has(agentId)) {
+        ctx.ui.print({ type: 'error', message: `Agent '${agentId}' not found in team` });
+        return true;
+    }
+    team.setCoordinator(agentId);
+    const agent = team.get(agentId);
+    ctx.ui.print({
+        type: 'success',
+        message: `Set ${agent?.getFullLabel() ?? agentId} as coordinator`,
+    });
+    return true;
+}
+// =============================================================================
+// /artifact Command
+// =============================================================================
+export const artifactCommand = {
+    name: 'artifact',
+    description: 'View team artifacts',
+    details: `Browse and view artifacts shared by team agents. Artifacts are named pieces of work
+(designs, plans, reviews, decisions, notes) that agents can publish and reference.`,
+    examples: [
+        { code: '/artifact', description: 'Browse all artifacts' },
+    ],
+    interactions: [
+        'Tab cycles: All → Design → Plan → Review → Decision → Note',
+        '↑/↓ or j/k to navigate',
+        '/ to search',
+        'Enter to view artifact',
+        'Esc to go back or close',
+    ],
+    async execute(_args, ctx) {
+        // Loop: show list → detail → back to list (until user cancels list or Ctrl+C from detail)
+        let showList = true;
+        while (showList) {
+            // Show artifact list (inline overlay)
+            const listOverlay = new ArtifactOverlayV2();
+            const listResult = await ctx.ui.showOverlay(listOverlay);
+            // User cancelled the list (Esc/Ctrl+C) - exit
+            if (!listResult?.selectedArtifact || listResult.cancelled) {
+                showList = false;
+                continue;
+            }
+            // Show selected artifact in fullscreen detail overlay
+            const detailOverlay = new ArtifactDetailOverlayV2(listResult.selectedArtifact);
+            const detailResult = await ctx.ui.showOverlay(detailOverlay);
+            // Ctrl+C from detail - exit completely
+            // Esc/q from detail (goBack=true) - loop back to show list again
+            showList = detailResult?.goBack === true;
+        }
+        return true;
+    },
+};
+// =============================================================================
+// Export
+// =============================================================================
+export const teamCommands = [teamCommand, artifactCommand];

package/dist/commands-v2/handlers/terminals.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Terminals Command Handler
+ *
+ * Shows active terminal sessions for multi-terminal awareness.
+ * Opens an interactive overlay when sessions exist, falls back to info message otherwise.
+ */
+import type { CommandHandlerV2 } from '../types.js';
+export declare const terminalsCommand: CommandHandlerV2;
+export declare const terminalsCommands: CommandHandlerV2[];

package/dist/commands-v2/handlers/terminals.js

@@ -0,0 +1,34 @@
+/**
+ * Terminals Command Handler
+ *
+ * Shows active terminal sessions for multi-terminal awareness.
+ * Opens an interactive overlay when sessions exist, falls back to info message otherwise.
+ */
+import { getSessionRegistry } from '../../multi-agent/session-registry.js';
+import { TerminalsOverlayV2 } from '../../ui/overlay/impl/terminals-overlay-v2.js';
+export const terminalsCommand = {
+    name: 'terminals',
+    aliases: ['sessions'],
+    description: 'Show active terminal sessions',
+    details: 'Lists all CLI instances currently running on this machine. Useful for seeing which terminals are active and what agents they are running.',
+    examples: [
+        { code: '/terminals', description: 'List all active terminal sessions' },
+        { code: '/sessions', description: 'Alias for /terminals' },
+    ],
+    async execute(_args, ctx) {
+        const registry = getSessionRegistry();
+        if (!registry) {
+            ctx.ui.print({ type: 'info', message: 'Session registry not available.' });
+            return true;
+        }
+        const sessions = registry.getActiveSessions();
+        if (sessions.length === 0) {
+            ctx.ui.print({ type: 'info', message: 'No active terminal sessions.' });
+            return true;
+        }
+        const overlay = new TerminalsOverlayV2();
+        await ctx.ui.showOverlay(overlay);
+        return true;
+    },
+};
+export const terminalsCommands = [terminalsCommand];

package/dist/commands-v2/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Commands V2 Module
+ *
+ * Command system for the new TerminalUI-based REPL.
+ */
+export type { CommandContextV2, CommandHandlerV2, CommandResultV2, CommandExample } from './types.js';
+export { registerCommand, registerCommands, getCommand, executeCommand, getCommandNames, hasCommand, clearCommands, getAutocompleteCommands, getHelpCommands, } from './registry.js';
+export { allCommands } from './handlers/index.js';
+export { coreCommands } from './handlers/core.js';
+export { settingsCommands } from './handlers/settings.js';
+export { contextCommands } from './handlers/context.js';
+export { projectCommands } from './handlers/project.js';
+export { debugCommands } from './handlers/debug.js';
+export { sessionCommands, saveCurrentSession, loadProjectSession, hasCurrentProjectSession, hasRecentSession, getMostRecentSession, checkpointBeforeSwitch, loadAndRestoreSession, archiveCurrentSession, refreshProjectContext, getProjectAnchors, saveCurrentTeam, loadCurrentTeam, hasCurrentTeam, deleteCurrentTeam, type ProjectContextRefreshResult, convertMessagesToItems, } from './handlers/session.js';

package/dist/commands-v2/index.js

@@ -0,0 +1,18 @@
+/**
+ * Commands V2 Module
+ *
+ * Command system for the new TerminalUI-based REPL.
+ */
+// Registry
+export { registerCommand, registerCommands, getCommand, executeCommand, getCommandNames, hasCommand, clearCommands, getAutocompleteCommands, getHelpCommands, } from './registry.js';
+// All handlers
+export { allCommands } from './handlers/index.js';
+// Individual handler modules (for selective imports)
+export { coreCommands } from './handlers/core.js';
+export { settingsCommands } from './handlers/settings.js';
+export { contextCommands } from './handlers/context.js';
+export { projectCommands } from './handlers/project.js';
+export { debugCommands } from './handlers/debug.js';
+export { sessionCommands, saveCurrentSession, loadProjectSession, hasCurrentProjectSession, hasRecentSession, getMostRecentSession, checkpointBeforeSwitch, loadAndRestoreSession, archiveCurrentSession, refreshProjectContext, getProjectAnchors, 
+// Team persistence
+saveCurrentTeam, loadCurrentTeam, hasCurrentTeam, deleteCurrentTeam, convertMessagesToItems, } from './handlers/session.js';

package/dist/commands-v2/registry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Command Registry for REPL V2
+ *
+ * Central registry for all V2 command handlers.
+ * Handles command resolution (including aliases) and execution.
+ */
+import type { CommandHandlerV2, CommandContextV2, CommandResultV2 } from './types.js';
+/**
+ * Register a command handler.
+ */
+export declare function registerCommand(handler: CommandHandlerV2): void;
+/**
+ * Register multiple command handlers.
+ */
+export declare function registerCommands(handlerList: CommandHandlerV2[]): void;
+/**
+ * Get a command handler by name or alias.
+ */
+export declare function getCommand(nameOrAlias: string): CommandHandlerV2 | undefined;
+/**
+ * Execute a command by name or alias.
+ *
+ * @returns true to continue, false to exit, null if command not found
+ */
+export declare function executeCommand(nameOrAlias: string, args: string, ctx: CommandContextV2): Promise<CommandResultV2>;
+/**
+ * Get all registered command names (excluding aliases).
+ */
+export declare function getCommandNames(): string[];
+/**
+ * Check if a command exists (by name or alias).
+ */
+export declare function hasCommand(nameOrAlias: string): boolean;
+/**
+ * Clear all registered commands (for testing).
+ */
+export declare function clearCommands(): void;
+/**
+ * Get all commands formatted for autocomplete.
+ * Filters out internal/tool commands (those with underscores or camelCase).
+ */
+export declare function getAutocompleteCommands(): {
+    command: string;
+    description: string;
+}[];
+/**
+ * Get all commands formatted for help display.
+ */
+export declare function getHelpCommands(): {
+    name: string;
+    description: string;
+}[];