monomind 1.9.16 → 1.10.0

package/packages/@monomind/cli/dist/src/commands/route.js

@@ -1,939 +0,0 @@
-/**
- * CLI Route Command
- * Intelligent task-to-agent routing using Q-Learning
- *
- * Features:
- * - Q-Learning based agent selection
- * - Semantic task understanding
- * - Confidence scoring
- * - Learning from feedback
- *
- * github.com/nokhodian/monomind
- */
-import { output } from '../output.js';
-import { createQLearningRouter, isRuvectorAvailable, } from '../ruvector/index.js';
-/**
- * Available agent types for routing
- */
-const AGENT_TYPES = [
-    { id: 'coder', name: 'Coder', description: 'Implements features and writes code', capabilities: ['coding', 'implementation', 'refactoring'], priority: 1 },
-    { id: 'tester', name: 'Tester', description: 'Creates tests and validates functionality', capabilities: ['testing', 'validation', 'quality'], priority: 2 },
-    { id: 'reviewer', name: 'Reviewer', description: 'Reviews code quality and security', capabilities: ['review', 'security', 'best-practices'], priority: 3 },
-    { id: 'architect', name: 'Architect', description: 'Designs system architecture', capabilities: ['design', 'architecture', 'planning'], priority: 4 },
-    { id: 'researcher', name: 'Researcher', description: 'Researches requirements and patterns', capabilities: ['research', 'analysis', 'documentation'], priority: 5 },
-    { id: 'optimizer', name: 'Optimizer', description: 'Optimizes performance and efficiency', capabilities: ['optimization', 'performance', 'profiling'], priority: 6 },
-    { id: 'debugger', name: 'Debugger', description: 'Debugs issues and fixes bugs', capabilities: ['debugging', 'troubleshooting', 'fixing'], priority: 7 },
-    { id: 'documenter', name: 'Documenter', description: 'Creates and updates documentation', capabilities: ['documentation', 'writing', 'explaining'], priority: 8 },
-];
-// ============================================================================
-// Router Singleton
-// ============================================================================
-let routerInstance = null;
-let routerInitialized = false;
-/**
- * Get or create the router instance
- */
-async function getRouter() {
-    if (!routerInstance) {
-        routerInstance = createQLearningRouter();
-    }
-    if (!routerInitialized) {
-        await routerInstance.initialize();
-        routerInitialized = true;
-    }
-    return routerInstance;
-}
-/**
- * Get agent type by route name
- */
-function getAgentType(route) {
-    return AGENT_TYPES.find(a => a.id === route);
-}
-// ============================================================================
-// Route Subcommand
-// ============================================================================
-const routeTaskCommand = {
-    name: 'task',
-    description: 'Route a task to the optimal agent using Q-Learning',
-    options: [
-        {
-            name: 'q-learning',
-            short: 'q',
-            description: 'Use Q-Learning for agent selection (default: true)',
-            type: 'boolean',
-            default: true,
-        },
-        {
-            name: 'agent',
-            short: 'a',
-            description: 'Force specific agent (bypasses Q-Learning)',
-            type: 'string',
-        },
-        {
-            name: 'explore',
-            short: 'e',
-            description: 'Enable exploration (random selection chance)',
-            type: 'boolean',
-            default: true,
-        },
-        {
-            name: 'json',
-            short: 'j',
-            description: 'Output in JSON format',
-            type: 'boolean',
-            default: false,
-        },
-    ],
-    examples: [
-        { command: 'monomind route task "implement authentication"', description: 'Route task to best agent' },
-        { command: 'monomind route task "write unit tests" --q-learning', description: 'Use Q-Learning routing' },
-        { command: 'monomind route task "review code" --agent reviewer', description: 'Force specific agent' },
-    ],
-    action: async (ctx) => {
-        const taskDescription = ctx.args[0];
-        const forceAgent = ctx.flags.agent;
-        const useExploration = ctx.flags.explore;
-        const jsonOutput = ctx.flags.json;
-        if (!taskDescription) {
-            output.printError('Task description is required');
-            output.writeln(output.dim('Usage: monomind route task "task description"'));
-            return { success: false, exitCode: 1 };
-        }
-        const spinner = output.createSpinner({ text: 'Analyzing task...', spinner: 'dots' });
-        spinner.start();
-        try {
-            if (forceAgent) {
-                // Bypass Q-Learning, use specified agent
-                const agent = getAgentType(forceAgent) ||
-                    AGENT_TYPES.find(a => a.name.toLowerCase() === forceAgent.toLowerCase());
-                if (!agent) {
-                    spinner.fail(`Agent "${forceAgent}" not found`);
-                    output.writeln();
-                    output.writeln('Available agents:');
-                    output.printList(AGENT_TYPES.map(a => `${output.highlight(a.id)} - ${a.description}`));
-                    return { success: false, exitCode: 1 };
-                }
-                spinner.succeed(`Routed to ${agent.name}`);
-                if (jsonOutput) {
-                    output.printJson({
-                        task: taskDescription,
-                        agentId: agent.id,
-                        agentName: agent.name,
-                        confidence: 1.0,
-                        method: 'forced',
-                    });
-                }
-                else {
-                    output.writeln();
-                    output.printBox([
-                        `Task: ${taskDescription}`,
-                        `Agent: ${output.highlight(agent.name)} (${agent.id})`,
-                        `Confidence: ${output.success('100%')} (forced)`,
-                        `Description: ${agent.description}`,
-                    ].join('\n'), 'Routing Result');
-                }
-                return { success: true, data: { agentId: agent.id, agentName: agent.name } };
-            }
-            // Use Q-Learning routing
-            const router = await getRouter();
-            const result = router.route(taskDescription, useExploration);
-            const agent = getAgentType(result.route) || AGENT_TYPES[0];
-            spinner.succeed(`Routed to ${agent.name}`);
-            if (jsonOutput) {
-                output.printJson({
-                    task: taskDescription,
-                    agentId: result.route,
-                    agentName: agent.name,
-                    confidence: result.confidence,
-                    qValues: result.qValues,
-                    explored: result.explored,
-                    alternatives: result.alternatives.map(a => ({
-                        agentId: a.route,
-                        agentName: getAgentType(a.route)?.name || a.route,
-                        score: a.score,
-                    })),
-                });
-            }
-            else {
-                output.writeln();
-                const confidence = result.confidence ?? 0;
-                // Use bound methods to preserve `this` context when calling output methods
-                const confidenceColor = confidence >= 0.7
-                    ? (text) => output.success(text)
-                    : confidence >= 0.4
-                        ? (text) => output.warning(text)
-                        : (text) => output.error(text);
-                const qValues = result.qValues || [0];
-                const maxQValue = Math.max(...qValues);
-                const capabilities = agent.capabilities || [];
-                const alternatives = result.alternatives || [];
-                output.printBox([
-                    `Task: ${taskDescription}`,
-                    ``,
-                    `Agent: ${output.highlight(agent.name)} (${result.route})`,
-                    `Confidence: ${confidenceColor(`${(confidence * 100).toFixed(1)}%`)}`,
-                    `Q-Value: ${maxQValue.toFixed(3)}`,
-                    `Exploration: ${result.explored ? output.warning('Yes') : 'No'}`,
-                    ``,
-                    `Description: ${agent.description}`,
-                    `Capabilities: ${capabilities.join(', ')}`,
-                ].join('\n'), 'Q-Learning Routing');
-                if (alternatives.length > 0) {
-                    output.writeln();
-                    output.writeln(output.bold('Alternatives:'));
-                    output.printTable({
-                        columns: [
-                            { key: 'agent', header: 'Agent', width: 20 },
-                            { key: 'score', header: 'Score', width: 12, align: 'right' },
-                        ],
-                        data: alternatives.map(a => ({
-                            agent: getAgentType(a.route)?.name || a.route,
-                            score: (a.score ?? 0).toFixed(3),
-                        })),
-                    });
-                }
-            }
-            return { success: true, data: { agentId: result.route, result } };
-        }
-        catch (error) {
-            spinner.fail('Routing failed');
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// List Agents Subcommand
-// ============================================================================
-const listAgentsCommand = {
-    name: 'list-agents',
-    aliases: ['agents', 'ls'],
-    description: 'List all available agent types for routing',
-    options: [
-        {
-            name: 'json',
-            short: 'j',
-            description: 'Output in JSON format',
-            type: 'boolean',
-            default: false,
-        },
-    ],
-    examples: [
-        { command: 'monomind route list-agents', description: 'List all agents' },
-        { command: 'monomind route agents --json', description: 'List agents as JSON' },
-    ],
-    action: async (ctx) => {
-        const jsonOutput = ctx.flags.json;
-        try {
-            if (jsonOutput) {
-                output.printJson(AGENT_TYPES);
-            }
-            else {
-                output.writeln();
-                output.writeln(output.bold('Available Agent Types'));
-                output.writeln(output.dim('Ordered by priority (highest first)'));
-                output.writeln();
-                output.printTable({
-                    columns: [
-                        { key: 'id', header: 'ID', width: 15 },
-                        { key: 'name', header: 'Name', width: 15 },
-                        { key: 'priority', header: 'Priority', width: 10, align: 'right' },
-                        { key: 'description', header: 'Description', width: 45 },
-                    ],
-                    data: AGENT_TYPES.map(a => ({
-                        id: output.highlight(a.id),
-                        name: a.name,
-                        priority: String(a.priority),
-                        description: a.description,
-                    })),
-                });
-                output.writeln();
-                output.writeln(output.dim(`Total: ${AGENT_TYPES.length} agent types`));
-            }
-            return { success: true, data: AGENT_TYPES };
-        }
-        catch (error) {
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// Stats Subcommand
-// ============================================================================
-const statsCommand = {
-    name: 'stats',
-    description: 'Show Q-Learning router statistics',
-    options: [
-        {
-            name: 'json',
-            short: 'j',
-            description: 'Output in JSON format',
-            type: 'boolean',
-            default: false,
-        },
-    ],
-    examples: [
-        { command: 'monomind route stats', description: 'Show routing statistics' },
-    ],
-    action: async (ctx) => {
-        const jsonOutput = ctx.flags.json;
-        try {
-            const router = await getRouter();
-            const stats = router.getStats();
-            const ruvectorAvailable = await isRuvectorAvailable();
-            const ruvectorStatus = {
-                available: ruvectorAvailable,
-                wasmAccelerated: stats.useNative === 1,
-                backend: stats.useNative === 1 ? 'ruvector-native' : 'fallback',
-            };
-            if (jsonOutput) {
-                output.printJson({ stats, ruvector: ruvectorStatus });
-            }
-            else {
-                output.writeln();
-                output.writeln(output.bold('Q-Learning Router Statistics'));
-                output.writeln();
-                output.printTable({
-                    columns: [
-                        { key: 'metric', header: 'Metric', width: 25 },
-                        { key: 'value', header: 'Value', width: 20, align: 'right' },
-                    ],
-                    data: [
-                        { metric: 'Update Count', value: String(stats.updateCount) },
-                        { metric: 'Q-Table Size', value: String(stats.qTableSize) },
-                        { metric: 'Step Count', value: String(stats.stepCount) },
-                        { metric: 'Epsilon', value: stats.epsilon.toFixed(4) },
-                        { metric: 'Avg TD Error', value: stats.avgTDError.toFixed(4) },
-                        { metric: 'Native Backend', value: stats.useNative === 1 ? 'Yes' : 'No' },
-                    ],
-                });
-                output.writeln();
-                output.writeln(output.bold('RuVector Status'));
-                output.printList([
-                    `Available: ${ruvectorStatus.available ? output.success('Yes') : output.warning('No (using fallback)')}`,
-                    `WASM Accelerated: ${ruvectorStatus.wasmAccelerated ? output.success('Yes') : 'No'}`,
-                    `Backend: ${ruvectorStatus.backend}`,
-                ]);
-            }
-            return { success: true, data: { stats, ruvector: ruvectorStatus } };
-        }
-        catch (error) {
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// Feedback Subcommand
-// ============================================================================
-const feedbackCommand = {
-    name: 'feedback',
-    description: 'Provide feedback on a routing decision',
-    options: [
-        {
-            name: 'task',
-            short: 't',
-            description: 'Task description (context for learning)',
-            type: 'string',
-            required: true,
-        },
-        {
-            name: 'agent',
-            short: 'a',
-            description: 'Agent that was used',
-            type: 'string',
-            required: true,
-        },
-        {
-            name: 'reward',
-            short: 'r',
-            description: 'Reward value (-1 to 1, where 1 is best)',
-            type: 'number',
-            default: 0.8,
-        },
-        {
-            name: 'next-task',
-            short: 'n',
-            description: 'Next task description (for multi-step learning)',
-            type: 'string',
-        },
-    ],
-    examples: [
-        { command: 'monomind route feedback -t "implement auth" -a coder -r 0.9', description: 'Positive feedback' },
-        { command: 'monomind route feedback -t "write tests" -a tester -r -0.5', description: 'Negative feedback' },
-    ],
-    action: async (ctx) => {
-        const taskDescription = ctx.flags.task;
-        const agentId = ctx.flags.agent;
-        const reward = ctx.flags.reward;
-        const nextTask = ctx.flags['next-task'];
-        if (!taskDescription || !agentId) {
-            output.printError('Task description and agent are required');
-            return { success: false, exitCode: 1 };
-        }
-        // Validate agent
-        const agent = getAgentType(agentId);
-        if (!agent) {
-            output.printError(`Unknown agent: ${agentId}`);
-            output.writeln('Available agents:');
-            output.printList(AGENT_TYPES.map(a => a.id));
-            return { success: false, exitCode: 1 };
-        }
-        try {
-            const router = await getRouter();
-            const clampedReward = Math.max(-1, Math.min(1, reward));
-            const tdError = router.update(taskDescription, agentId, clampedReward, nextTask);
-            output.printSuccess(`Feedback recorded for agent "${agent.name}"`);
-            output.writeln();
-            output.printBox([
-                `Task: ${taskDescription}`,
-                `Agent: ${agent.name} (${agentId})`,
-                `Reward: ${clampedReward >= 0 ? output.success(clampedReward.toFixed(2)) : output.error(clampedReward.toFixed(2))}`,
-                `TD Error: ${Math.abs(tdError).toFixed(4)}`,
-                nextTask ? `Next Task: ${nextTask}` : '',
-            ].filter(Boolean).join('\n'), 'Feedback Recorded');
-            return { success: true, data: { tdError } };
-        }
-        catch (error) {
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// Reset Subcommand
-// ============================================================================
-const resetCommand = {
-    name: 'reset',
-    description: 'Reset the Q-Learning router state',
-    options: [
-        {
-            name: 'force',
-            short: 'f',
-            description: 'Force reset without confirmation',
-            type: 'boolean',
-            default: false,
-        },
-    ],
-    examples: [
-        { command: 'monomind route reset', description: 'Reset router state' },
-        { command: 'monomind route reset --force', description: 'Force reset' },
-    ],
-    action: async (ctx) => {
-        const force = ctx.flags.force;
-        if (!force && ctx.interactive) {
-            output.printWarning('This will reset all learned Q-values and statistics.');
-            output.writeln(output.dim('Use --force to skip this confirmation.'));
-            return { success: false, exitCode: 1 };
-        }
-        try {
-            const router = await getRouter();
-            router.reset();
-            output.printSuccess('Q-Learning router state has been reset');
-            return { success: true };
-        }
-        catch (error) {
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// Export/Import Subcommands
-// ============================================================================
-const exportCommand = {
-    name: 'export',
-    description: 'Export Q-table for persistence',
-    options: [
-        {
-            name: 'file',
-            short: 'f',
-            description: 'Output file path (outputs to stdout if not specified)',
-            type: 'string',
-        },
-    ],
-    examples: [
-        { command: 'monomind route export', description: 'Export Q-table to stdout' },
-        { command: 'monomind route export -f qtable.json', description: 'Export to file' },
-    ],
-    action: async (ctx) => {
-        const filePath = ctx.flags.file;
-        try {
-            const router = await getRouter();
-            const data = router.export();
-            if (filePath) {
-                // Containment check — without it, --file /etc/cron.d/x writes
-                // attacker-controlled JSON anywhere the CLI can write.
-                const path = await import('node:path');
-                const projectRoot = path.resolve(process.cwd());
-                const fullPath = path.resolve(process.cwd(), filePath);
-                if (!fullPath.startsWith(projectRoot + path.sep) && fullPath !== projectRoot) {
-                    output.printError(`File path must resolve within the project directory: ${projectRoot}`);
-                    return { success: false, exitCode: 1 };
-                }
-                if (!/\.json$/i.test(fullPath)) {
-                    output.printError('File must end in .json');
-                    return { success: false, exitCode: 1 };
-                }
-                const fs = await import('node:fs/promises');
-                await fs.writeFile(fullPath, JSON.stringify(data, null, 2));
-                output.printSuccess(`Q-table exported to ${fullPath}`);
-            }
-            else {
-                output.printJson(data);
-            }
-            return { success: true, data };
-        }
-        catch (error) {
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-const importCommand = {
-    name: 'import',
-    description: 'Import Q-table from file',
-    options: [
-        {
-            name: 'file',
-            short: 'f',
-            description: 'Input file path',
-            type: 'string',
-            required: true,
-        },
-    ],
-    examples: [
-        { command: 'monomind route import -f qtable.json', description: 'Import Q-table from file' },
-    ],
-    action: async (ctx) => {
-        const filePath = ctx.flags.file;
-        if (!filePath) {
-            output.printError('File path is required');
-            return { success: false, exitCode: 1 };
-        }
-        try {
-            // Containment + extension whitelist + size cap. Without these,
-            // --file /proc/self/environ leaks process env into the Q-table import,
-            // and a planted multi-GB JSON OOM-kills the process on readFile.
-            const path = await import('node:path');
-            const projectRoot = path.resolve(process.cwd());
-            const fullPath = path.resolve(process.cwd(), filePath);
-            if (!fullPath.startsWith(projectRoot + path.sep) && fullPath !== projectRoot) {
-                output.printError(`File path must resolve within the project directory: ${projectRoot}`);
-                return { success: false, exitCode: 1 };
-            }
-            if (!/\.json$/i.test(fullPath)) {
-                output.printError('File must end in .json');
-                return { success: false, exitCode: 1 };
-            }
-            const fs = await import('node:fs/promises');
-            const stat = await fs.stat(fullPath);
-            if (stat.size > 50 * 1024 * 1024) {
-                output.printError(`File too large: ${stat.size} bytes (max 50MB)`);
-                return { success: false, exitCode: 1 };
-            }
-            const content = await fs.readFile(fullPath, 'utf-8');
-            const data = JSON.parse(content);
-            const router = await getRouter();
-            router.import(data);
-            output.printSuccess(`Q-table imported from ${fullPath}`);
-            output.writeln(output.dim(`Loaded ${Object.keys(data).length} state entries`));
-            return { success: true };
-        }
-        catch (error) {
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// Coverage-Aware Routing Subcommand
-// ============================================================================
-const coverageRouteCommand = {
-    name: 'coverage',
-    aliases: ['cov'],
-    description: 'Route tasks based on test coverage analysis (ADR-017)',
-    options: [
-        {
-            name: 'path',
-            short: 'p',
-            description: 'Path to analyze for coverage',
-            type: 'string',
-        },
-        {
-            name: 'threshold',
-            short: 't',
-            description: 'Coverage threshold percentage (default: 80)',
-            type: 'number',
-            default: 80,
-        },
-        {
-            name: 'suggest',
-            short: 's',
-            description: 'Get suggestions for improving coverage',
-            type: 'boolean',
-            default: false,
-        },
-        {
-            name: 'gaps',
-            short: 'g',
-            description: 'List coverage gaps with agent assignments',
-            type: 'boolean',
-            default: false,
-        },
-        {
-            name: 'json',
-            short: 'j',
-            description: 'Output in JSON format',
-            type: 'boolean',
-            default: false,
-        },
-    ],
-    examples: [
-        { command: 'monomind route coverage', description: 'Analyze coverage and suggest routing' },
-        { command: 'monomind route coverage --suggest', description: 'Get improvement suggestions' },
-        { command: 'monomind route coverage --gaps', description: 'List coverage gaps by agent' },
-        { command: 'monomind route coverage -p src/auth -t 90', description: 'Analyze specific path with threshold' },
-    ],
-    action: async (ctx) => {
-        const path = ctx.flags.path || '';
-        const threshold = ctx.flags.threshold || 80;
-        const suggestMode = ctx.flags.suggest;
-        const gapsMode = ctx.flags.gaps;
-        const jsonOutput = ctx.flags.json;
-        const spinner = output.createSpinner({ text: 'Analyzing coverage...', spinner: 'dots' });
-        spinner.start();
-        try {
-            // Lazy load coverage router
-            const { coverageRoute, coverageSuggest, coverageGaps } = await import('../ruvector/coverage-router.js');
-            if (gapsMode) {
-                // List coverage gaps with agent assignments
-                const result = await coverageGaps({ threshold, groupByAgent: true });
-                spinner.succeed(`Found ${result.totalGaps} coverage gaps`);
-                if (jsonOutput) {
-                    output.printJson(result);
-                }
-                else {
-                    output.writeln();
-                    output.writeln(output.bold('Coverage Gaps by Agent'));
-                    output.writeln(output.dim(result.summary));
-                    output.writeln();
-                    if (Object.keys(result.byAgent).length > 0) {
-                        for (const [agent, files] of Object.entries(result.byAgent)) {
-                            output.writeln(`${output.highlight(agent)} (${files.length} files)`);
-                            for (const file of files.slice(0, 5)) {
-                                output.writeln(`  ${output.dim('•')} ${file}`);
-                            }
-                            if (files.length > 5) {
-                                output.writeln(output.dim(`    ... and ${files.length - 5} more`));
-                            }
-                            output.writeln();
-                        }
-                    }
-                    else {
-                        output.printSuccess('No coverage gaps found!');
-                    }
-                    output.writeln();
-                    output.writeln(output.bold('Top Gaps:'));
-                    output.printTable({
-                        columns: [
-                            { key: 'file', header: 'File', width: 50 },
-                            { key: 'coverage', header: 'Coverage', width: 12, align: 'right' },
-                            { key: 'gap', header: 'Gap', width: 10, align: 'right' },
-                            { key: 'agent', header: 'Agent', width: 15 },
-                        ],
-                        data: result.gaps.slice(0, 10).map(g => ({
-                            file: g.file.length > 48 ? '...' + g.file.slice(-45) : g.file,
-                            coverage: `${g.currentCoverage.toFixed(1)}%`,
-                            gap: `${g.gap.toFixed(1)}%`,
-                            agent: g.suggestedAgent,
-                        })),
-                    });
-                }
-                return { success: true, data: result };
-            }
-            if (suggestMode || path) {
-                // Suggest improvements for path
-                const result = await coverageSuggest(path || '.', { threshold, limit: 20 });
-                spinner.succeed(`Found ${result.suggestions.length} coverage suggestions`);
-                if (jsonOutput) {
-                    output.printJson(result);
-                }
-                else {
-                    output.writeln();
-                    output.writeln(output.bold('Coverage Improvement Suggestions'));
-                    output.writeln(output.dim(`Path: ${result.path}, Threshold: ${threshold}%`));
-                    output.writeln();
-                    if (result.suggestions.length === 0) {
-                        output.printSuccess('All files meet coverage threshold!');
-                    }
-                    else {
-                        output.writeln(`Total Gap: ${output.warning(`${result.totalGap.toFixed(1)}%`)}`);
-                        output.writeln(`Estimated Effort: ${output.dim(`${result.estimatedEffort.toFixed(1)} hours`)}`);
-                        output.writeln();
-                        output.printTable({
-                            columns: [
-                                { key: 'file', header: 'File', width: 45 },
-                                { key: 'current', header: 'Current', width: 10, align: 'right' },
-                                { key: 'target', header: 'Target', width: 10, align: 'right' },
-                                { key: 'priority', header: 'Priority', width: 10, align: 'right' },
-                            ],
-                            data: result.suggestions.slice(0, 15).map(s => ({
-                                file: s.file.length > 43 ? '...' + s.file.slice(-40) : s.file,
-                                current: `${s.currentCoverage.toFixed(1)}%`,
-                                target: `${s.targetCoverage.toFixed(1)}%`,
-                                priority: String(s.priority),
-                            })),
-                        });
-                        // Show test suggestions for top file
-                        if (result.suggestions.length > 0 && result.suggestions[0].suggestedTests.length > 0) {
-                            output.writeln();
-                            output.writeln(output.bold('Suggested Tests for Top Priority File:'));
-                            output.printList(result.suggestions[0].suggestedTests);
-                        }
-                    }
-                }
-                return { success: true, data: result };
-            }
-            // Default: Route based on coverage analysis
-            const routeResult = await coverageRoute('', { threshold });
-            spinner.succeed('Coverage analysis complete');
-            if (jsonOutput) {
-                output.printJson(routeResult);
-            }
-            else {
-                output.writeln();
-                output.writeln(output.bold('Coverage-Aware Routing'));
-                output.writeln();
-                const actionColors = {
-                    'add-tests': (s) => output.error(s),
-                    'review-coverage': (s) => output.warning(s),
-                    'prioritize': (s) => output.error(s),
-                    'skip': (s) => output.success(s),
-                };
-                const colorFn = actionColors[routeResult.action] || ((s) => s);
-                output.printBox([
-                    `Action: ${colorFn(routeResult.action.toUpperCase())}`,
-                    `Priority: ${routeResult.priority}/10`,
-                    `Impact Score: ${routeResult.impactScore}%`,
-                    `Estimated Effort: ${routeResult.estimatedEffort} hours`,
-                    ``,
-                    `Test Types: ${routeResult.testTypes.join(', ')}`,
-                    `Target Files: ${routeResult.targetFiles.length}`,
-                ].join('\n'), 'Coverage Analysis');
-                if (routeResult.targetFiles.length > 0) {
-                    output.writeln();
-                    output.writeln(output.bold('Target Files:'));
-                    output.printList(routeResult.targetFiles.slice(0, 5).map(f => f.length > 60 ? '...' + f.slice(-57) : f));
-                    if (routeResult.targetFiles.length > 5) {
-                        output.writeln(output.dim(`  ... and ${routeResult.targetFiles.length - 5} more`));
-                    }
-                }
-                if (routeResult.gaps.length > 0) {
-                    output.writeln();
-                    output.writeln(output.bold('Coverage Gaps:'));
-                    output.printTable({
-                        columns: [
-                            { key: 'file', header: 'File', width: 40 },
-                            { key: 'current', header: 'Current', width: 10, align: 'right' },
-                            { key: 'gap', header: 'Gap', width: 10, align: 'right' },
-                        ],
-                        data: routeResult.gaps.slice(0, 5).map(g => ({
-                            file: g.file.length > 38 ? '...' + g.file.slice(-35) : g.file,
-                            current: `${g.currentCoverage.toFixed(1)}%`,
-                            gap: `${g.gap.toFixed(1)}%`,
-                        })),
-                    });
-                }
-            }
-            return { success: true, data: routeResult };
-        }
-        catch (error) {
-            spinner.fail('Coverage analysis failed');
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// Semantic Route Subcommand (RouteLayer — cosine similarity)
-// ============================================================================
-const semanticRouteCommand = {
-    name: 'semantic',
-    aliases: ['sem'],
-    description: 'Route a task to the optimal agent using cosine similarity (RouteLayer)',
-    options: [
-        {
-            name: 'task',
-            short: 't',
-            description: 'Task description to route',
-            type: 'string',
-            required: true,
-        },
-        {
-            name: 'debug',
-            short: 'd',
-            description: 'Include all route scores in the output',
-            type: 'boolean',
-            default: false,
-        },
-        {
-            name: 'json',
-            short: 'j',
-            description: 'Output in JSON format',
-            type: 'boolean',
-            default: false,
-        },
-    ],
-    examples: [
-        { command: 'monomind route semantic -t "audit the API for injection risks"', description: 'Semantic routing' },
-        { command: 'monomind route semantic -t "write unit tests" --debug', description: 'Show all route scores' },
-    ],
-    action: async (ctx) => {
-        const taskDescription = ctx.flags.task;
-        const debug = ctx.flags.debug;
-        const jsonOutput = ctx.flags.json;
-        if (!taskDescription) {
-            output.printError('Task description is required. Use --task or -t flag.');
-            return { success: false, exitCode: 1 };
-        }
-        const spinner = output.createSpinner({ text: 'Computing semantic route...', spinner: 'dots' });
-        spinner.start();
-        try {
-            const { RouteLayer, ALL_ROUTES } = await import('@monomind/routing');
-            const layer = new RouteLayer({ routes: ALL_ROUTES, debug });
-            const result = await layer.route(taskDescription);
-            spinner.succeed(`Routed to ${result.agentSlug}`);
-            if (jsonOutput) {
-                output.printJson(result);
-            }
-            else {
-                output.writeln();
-                const confidencePct = (result.confidence * 100).toFixed(1);
-                const methodColor = result.method === 'semantic'
-                    ? (s) => output.success(s)
-                    : (s) => output.warning(s);
-                output.printBox([
-                    `Task: ${taskDescription}`,
-                    ``,
-                    `Agent: ${output.highlight(result.agentSlug)}`,
-                    `Route: ${result.routeName}`,
-                    `Confidence: ${methodColor(`${confidencePct}%`)}`,
-                    `Method: ${methodColor(result.method)}`,
-                ].join('\n'), 'Semantic Routing Result');
-                if (debug && result.allScores && result.allScores.length > 0) {
-                    output.writeln();
-                    output.writeln(output.bold('All Route Scores (top 10):'));
-                    const top10 = result.allScores.slice(0, 10);
-                    output.printTable({
-                        columns: [
-                            { key: 'route', header: 'Route', width: 30 },
-                            { key: 'agent', header: 'Agent Slug', width: 35 },
-                            { key: 'score', header: 'Score', width: 10, align: 'right' },
-                        ],
-                        data: top10.map(s => ({
-                            route: s.routeName,
-                            agent: s.agentSlug,
-                            score: s.score.toFixed(4),
-                        })),
-                    });
-                }
-            }
-            return { success: true, data: result };
-        }
-        catch (error) {
-            spinner.fail('Semantic routing failed');
-            output.printError(error instanceof Error ? error.message : String(error));
-            return { success: false, exitCode: 1 };
-        }
-    },
-};
-// ============================================================================
-// Main Route Command
-// ============================================================================
-export const routeCommand = {
-    name: 'route',
-    description: 'Intelligent task-to-agent routing using Q-Learning',
-    subcommands: [
-        routeTaskCommand,
-        semanticRouteCommand,
-        listAgentsCommand,
-        statsCommand,
-        feedbackCommand,
-        resetCommand,
-        exportCommand,
-        importCommand,
-        coverageRouteCommand,
-    ],
-    options: [
-        {
-            name: 'q-learning',
-            short: 'q',
-            description: 'Use Q-Learning for agent selection',
-            type: 'boolean',
-            default: true,
-        },
-        {
-            name: 'agent',
-            short: 'a',
-            description: 'Force specific agent',
-            type: 'string',
-        },
-    ],
-    examples: [
-        { command: 'monomind route "implement feature"', description: 'Route task to best agent' },
-        { command: 'monomind route "write tests" --q-learning', description: 'Use Q-Learning routing' },
-        { command: 'monomind route --agent coder "fix bug"', description: 'Force specific agent' },
-        { command: 'monomind route list-agents', description: 'List available agents' },
-        { command: 'monomind route stats', description: 'Show routing statistics' },
-    ],
-    action: async (ctx) => {
-        // If task description provided directly, route it
-        if (ctx.args.length > 0 && routeTaskCommand.action) {
-            const result = await routeTaskCommand.action(ctx);
-            if (result)
-                return result;
-            return { success: true };
-        }
-        // Show help
-        output.writeln();
-        output.writeln(output.bold('Q-Learning Agent Router'));
-        output.writeln(output.dim('Intelligent task-to-agent routing using reinforcement learning'));
-        output.writeln();
-        output.writeln('Usage: monomind route <task> [options]');
-        output.writeln('       monomind route <subcommand>');
-        output.writeln();
-        output.writeln(output.bold('Subcommands:'));
-        output.printList([
-            `${output.highlight('task')}         - Route a task to optimal agent`,
-            `${output.highlight('list-agents')}  - List available agent types`,
-            `${output.highlight('stats')}        - Show router statistics`,
-            `${output.highlight('feedback')}     - Provide routing feedback`,
-            `${output.highlight('reset')}        - Reset router state`,
-            `${output.highlight('export')}       - Export Q-table`,
-            `${output.highlight('import')}       - Import Q-table`,
-        ]);
-        output.writeln();
-        output.writeln(output.bold('How It Works:'));
-        output.printList([
-            'Analyzes task description using hash-based state encoding',
-            'Uses Q-Learning to learn from routing outcomes',
-            'Epsilon-greedy exploration for continuous improvement',
-            'Provides confidence scores and alternatives',
-        ]);
-        output.writeln();
-        // Show quick status
-        const ruvectorAvailable = await isRuvectorAvailable();
-        output.writeln(output.bold('Backend Status:'));
-        output.printList([
-            `RuVector: ${ruvectorAvailable ? output.success('Available') : output.warning('Fallback mode')}`,
-            `Backend: ${ruvectorAvailable ? 'ruvector-native' : 'JavaScript fallback'}`,
-        ]);
-        output.writeln();
-        output.writeln(output.dim('Run "monomind route <subcommand> --help" for more info'));
-        return { success: true };
-    },
-};
-export default routeCommand;
-//# sourceMappingURL=route.js.map