monomind 1.17.0 → 1.17.2

package/packages/@monomind/cli/dist/src/commands/hooks-coverage-commands.js

@@ -4,759 +4,11 @@
  * Extracted from hooks.ts to reduce file size.
  */
 import { output } from '../output.js';
-import { callMCPTool, MCPClientError } from '../mcp-client.js';
-import { readCoverageFromDisk, classifyCoverageGap, suggestAgentsForFile, } from './hooks-coverage-utils.js';
-// ============================================================================
-// Coverage-Aware Routing Commands
-// ============================================================================
-// Coverage route subcommand
-export const coverageRouteCommand = {
-    name: 'coverage-route',
-    description: 'Route task to agents based on test coverage gaps (monovector integration)',
-    options: [
-        {
-            name: 'task',
-            short: 't',
-            description: 'Task description to route',
-            type: 'string',
-            required: true
-        },
-        {
-            name: 'threshold',
-            description: 'Coverage threshold percentage (default: 80)',
-            type: 'number',
-            default: 80
-        },
-        {
-            name: 'no-monovector',
-            description: 'Disable monovector integration',
-            type: 'boolean',
-            default: false
-        }
-    ],
-    examples: [
-        { command: 'monomind hooks coverage-route -t "fix bug in auth"', description: 'Route with coverage awareness' },
-        { command: 'monomind hooks coverage-route -t "add tests" --threshold 90', description: 'Route with custom threshold' }
-    ],
-    action: async (ctx) => {
-        const task = ctx.args[0] || ctx.flags.task;
-        const threshold = ctx.flags.threshold || 80;
-        const useMonovector = !ctx.flags['no-monovector'];
-        if (!task) {
-            output.printError('Task description is required. Use --task or -t flag.');
-            return { success: false, exitCode: 1 };
-        }
-        const spinner = output.createSpinner({ text: 'Analyzing coverage and routing task...' });
-        spinner.start();
-        // Try reading coverage from disk first
-        const diskCoverage = readCoverageFromDisk();
-        if (diskCoverage.found) {
-            spinner.succeed(`Coverage data loaded from ${diskCoverage.source}`);
-            // Find files with lowest coverage that may relate to the task
-            const taskLower = task.toLowerCase();
-            const taskWords = taskLower.split(/\s+/).filter(w => w.length > 2);
-            // Score each file by relevance to the task and how low its coverage is
-            const scoredFiles = diskCoverage.entries
-                .filter(e => e.lines < threshold)
-                .map(e => {
-                const fileNameLower = e.filePath.toLowerCase();
-                let relevance = 0;
-                for (const word of taskWords) {
-                    if (fileNameLower.includes(word))
-                        relevance += 2;
-                }
-                // Penalize high coverage (we care about low coverage)
-                const coveragePenalty = e.lines / 100;
-                return { ...e, relevance, score: relevance + (1 - coveragePenalty) };
-            })
-                .sort((a, b) => b.score - a.score);
-            const gaps = scoredFiles.slice(0, 8).map(e => {
-                const { gapType, priority } = classifyCoverageGap(e.lines, threshold);
-                return {
-                    filePath: e.filePath,
-                    coveragePercent: e.lines,
-                    gapType,
-                    priority,
-                    suggestedAgents: suggestAgentsForFile(e.filePath),
-                    reason: `${e.lines.toFixed(1)}% coverage, below ${threshold}%`,
-                };
-            });
-            const criticalGaps = gaps.filter(g => g.gapType === 'critical').length;
-            const primaryAgent = taskLower.includes('test') ? 'tester' :
-                taskLower.includes('security') || taskLower.includes('auth') ? 'security-auditor' :
-                    taskLower.includes('fix') || taskLower.includes('bug') ? 'coder' : 'tester';
-            const suggestions = [];
-            if (criticalGaps > 0)
-                suggestions.push(`${criticalGaps} critical coverage gaps need immediate attention`);
-            if (diskCoverage.summary.overallLineCoverage < threshold) {
-                suggestions.push(`Overall line coverage (${diskCoverage.summary.overallLineCoverage.toFixed(1)}%) is below ${threshold}% threshold`);
-            }
-            if (scoredFiles.length > 8)
-                suggestions.push(`${scoredFiles.length - 8} additional files with low coverage`);
-            const result = {
-                success: true,
-                task,
-                coverageAware: true,
-                gaps,
-                routing: {
-                    primaryAgent,
-                    confidence: gaps.length > 0 ? 0.85 : 0.6,
-                    reason: gaps.length > 0
-                        ? `Routing to ${primaryAgent} based on ${gaps.length} coverage gaps related to task`
-                        : `No coverage gaps found related to task, routing to ${primaryAgent}`,
-                    coverageImpact: gaps.length > 0 ? 'high' : 'low',
-                },
-                suggestions,
-                metrics: {
-                    filesAnalyzed: diskCoverage.summary.totalFiles,
-                    totalGaps: scoredFiles.length,
-                    criticalGaps,
-                    avgCoverage: diskCoverage.summary.overallLineCoverage,
-                },
-                source: diskCoverage.source,
-            };
-            if (ctx.flags.format === 'json') {
-                output.printJson(result);
-                return { success: true, data: result };
-            }
-            output.writeln();
-            output.printBox([
-                `Agent: ${output.highlight(result.routing.primaryAgent)}`,
-                `Confidence: ${(result.routing.confidence * 100).toFixed(1)}%`,
-                `Coverage-Aware: ${output.success('Yes')} (from ${diskCoverage.source})`,
-                `Reason: ${result.routing.reason}`
-            ].join('\n'), 'Coverage-Aware Routing');
-            if (gaps.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Priority Coverage Gaps'));
-                output.printTable({
-                    columns: [
-                        { key: 'filePath', header: 'File', width: 35, format: (v) => {
-                                const s = String(v);
-                                return s.length > 32 ? '...' + s.slice(-32) : s;
-                            } },
-                        { key: 'coveragePercent', header: 'Coverage', width: 10, align: 'right', format: (v) => `${Number(v).toFixed(1)}%` },
-                        { key: 'gapType', header: 'Type', width: 10 },
-                        { key: 'suggestedAgents', header: 'Agent', width: 15, format: (v) => Array.isArray(v) ? v[0] || '' : String(v) }
-                    ],
-                    data: gaps.slice(0, 8)
-                });
-            }
-            if (result.metrics.filesAnalyzed > 0) {
-                output.writeln();
-                output.writeln(output.bold('Coverage Metrics'));
-                output.printList([
-                    `Files Analyzed: ${result.metrics.filesAnalyzed}`,
-                    `Total Gaps: ${result.metrics.totalGaps}`,
-                    `Critical Gaps: ${result.metrics.criticalGaps}`,
-                    `Average Coverage: ${result.metrics.avgCoverage.toFixed(1)}%`
-                ]);
-            }
-            if (suggestions.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Suggestions'));
-                output.printList(suggestions.map(s => output.dim(s)));
-            }
-            return { success: true, data: result };
-        }
-        // No disk coverage - fall back to MCP tool
-        try {
-            const result = await callMCPTool('hooks_coverage-route', {
-                task,
-                threshold,
-                useMonovector,
-            });
-            spinner.stop();
-            if (ctx.flags.format === 'json') {
-                output.printJson(result);
-                return { success: true, data: result };
-            }
-            output.writeln();
-            output.printBox([
-                `Agent: ${output.highlight(result.routing.primaryAgent)}`,
-                `Confidence: ${(result.routing.confidence * 100).toFixed(1)}%`,
-                `Coverage-Aware: ${result.coverageAware ? output.success('Yes') : output.dim('No coverage data')}`,
-                `Reason: ${result.routing.reason}`
-            ].join('\n'), 'Coverage-Aware Routing');
-            if (result.gaps.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Priority Coverage Gaps'));
-                output.printTable({
-                    columns: [
-                        { key: 'filePath', header: 'File', width: 35, format: (v) => {
-                                const s = String(v);
-                                return s.length > 32 ? '...' + s.slice(-32) : s;
-                            } },
-                        { key: 'coveragePercent', header: 'Coverage', width: 10, align: 'right', format: (v) => `${Number(v).toFixed(1)}%` },
-                        { key: 'gapType', header: 'Type', width: 10 },
-                        { key: 'suggestedAgents', header: 'Agent', width: 15, format: (v) => Array.isArray(v) ? v[0] || '' : String(v) }
-                    ],
-                    data: result.gaps.slice(0, 8)
-                });
-            }
-            if (result.metrics.filesAnalyzed > 0) {
-                output.writeln();
-                output.writeln(output.bold('Coverage Metrics'));
-                output.printList([
-                    `Files Analyzed: ${result.metrics.filesAnalyzed}`,
-                    `Total Gaps: ${result.metrics.totalGaps}`,
-                    `Critical Gaps: ${result.metrics.criticalGaps}`,
-                    `Average Coverage: ${result.metrics.avgCoverage.toFixed(1)}%`
-                ]);
-            }
-            if (result.suggestions.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Suggestions'));
-                output.printList(result.suggestions.map(s => output.dim(s)));
-            }
-            return { success: true, data: result };
-        }
-        catch (error) {
-            spinner.fail('No coverage data found');
-            output.writeln();
-            output.printWarning('No coverage data found. Run your test suite with coverage first.');
-            output.writeln();
-            output.printList([
-                'Jest:     npx jest --coverage',
-                'Vitest:   npx vitest --coverage',
-                'nyc:      npx nyc npm test',
-                'c8:       npx c8 npm test',
-            ]);
-            output.writeln();
-            output.writeln(output.dim('Expected files: coverage/coverage-summary.json, coverage/lcov.info, or .nyc_output/out.json'));
-            return { success: false, exitCode: 1 };
-        }
-    }
-};
-// Coverage suggest subcommand
-export const coverageSuggestCommand = {
-    name: 'coverage-suggest',
-    description: 'Suggest coverage improvements for a path (monovector integration)',
-    options: [
-        {
-            name: 'path',
-            short: 'p',
-            description: 'Path to analyze for coverage suggestions',
-            type: 'string',
-            required: true
-        },
-        {
-            name: 'threshold',
-            description: 'Coverage threshold percentage (default: 80)',
-            type: 'number',
-            default: 80
-        },
-        {
-            name: 'limit',
-            short: 'l',
-            description: 'Maximum number of suggestions (default: 20)',
-            type: 'number',
-            default: 20
-        }
-    ],
-    examples: [
-        { command: 'monomind hooks coverage-suggest -p src/', description: 'Suggest improvements for src/' },
-        { command: 'monomind hooks coverage-suggest -p src/services --threshold 90', description: 'Stricter threshold' }
-    ],
-    action: async (ctx) => {
-        const targetPath = ctx.args[0] || ctx.flags.path;
-        const threshold = ctx.flags.threshold || 80;
-        const limit = ctx.flags.limit || 20;
-        if (!targetPath) {
-            output.printError('Path is required. Use --path or -p flag.');
-            return { success: false, exitCode: 1 };
-        }
-        const spinner = output.createSpinner({ text: `Analyzing coverage for ${targetPath}...` });
-        spinner.start();
-        // Try reading coverage from disk first
-        const diskCoverage = readCoverageFromDisk();
-        if (diskCoverage.found) {
-            spinner.succeed(`Coverage data loaded from ${diskCoverage.source}`);
-            // Filter entries to those matching the target path
-            const pathLower = targetPath.toLowerCase().replace(/\\/g, '/');
-            const matchingEntries = diskCoverage.entries.filter(e => {
-                const fileLower = e.filePath.toLowerCase().replace(/\\/g, '/');
-                return fileLower.includes(pathLower);
-            });
-            const belowThreshold = matchingEntries.filter(e => e.lines < threshold);
-            const suggestions = belowThreshold.slice(0, limit).map(e => {
-                const { gapType, priority } = classifyCoverageGap(e.lines, threshold);
-                return {
-                    filePath: e.filePath,
-                    coveragePercent: e.lines,
-                    gapType,
-                    priority,
-                    suggestedAgents: suggestAgentsForFile(e.filePath),
-                    reason: e.lines === 0 ? 'No coverage at all' :
-                        e.lines < 20 ? 'Very low coverage, needs tests' :
-                            e.lines < 50 ? 'Below 50%, add more tests' :
-                                `Below ${threshold}% threshold`,
-                };
-            });
-            const totalLinesCov = matchingEntries.length > 0
-                ? matchingEntries.reduce((acc, e) => acc + e.lines, 0) / matchingEntries.length
-                : 0;
-            const totalBranchesCov = matchingEntries.length > 0
-                ? matchingEntries.reduce((acc, e) => acc + e.branches, 0) / matchingEntries.length
-                : 0;
-            const prioritizedFiles = belowThreshold.slice(0, 5).map(e => e.filePath);
-            const result = {
-                success: true,
-                path: targetPath,
-                suggestions,
-                summary: {
-                    totalFiles: matchingEntries.length,
-                    overallLineCoverage: totalLinesCov,
-                    overallBranchCoverage: totalBranchesCov,
-                    filesBelowThreshold: belowThreshold.length,
-                },
-                prioritizedFiles,
-                monovectorAvailable: false,
-                source: diskCoverage.source,
-            };
-            if (ctx.flags.format === 'json') {
-                output.printJson(result);
-                return { success: true, data: result };
-            }
-            output.writeln();
-            output.printBox([
-                `Path: ${output.highlight(targetPath)}`,
-                `Files Analyzed: ${result.summary.totalFiles}`,
-                `Line Coverage: ${result.summary.overallLineCoverage.toFixed(1)}%`,
-                `Branch Coverage: ${result.summary.overallBranchCoverage.toFixed(1)}%`,
-                `Below Threshold: ${result.summary.filesBelowThreshold} files`,
-                `Source: ${output.highlight(diskCoverage.source)}`
-            ].join('\n'), 'Coverage Summary');
-            if (suggestions.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Coverage Improvement Suggestions'));
-                output.printTable({
-                    columns: [
-                        { key: 'filePath', header: 'File', width: 40, format: (v) => {
-                                const s = String(v);
-                                return s.length > 37 ? '...' + s.slice(-37) : s;
-                            } },
-                        { key: 'coveragePercent', header: 'Coverage', width: 10, align: 'right', format: (v) => `${Number(v).toFixed(1)}%` },
-                        { key: 'gapType', header: 'Priority', width: 10 },
-                        { key: 'reason', header: 'Reason', width: 25 }
-                    ],
-                    data: suggestions.slice(0, 15)
-                });
-            }
-            else {
-                output.writeln();
-                output.printSuccess('All files meet coverage threshold!');
-            }
-            if (prioritizedFiles.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Priority Files (Top 5)'));
-                output.printList(prioritizedFiles.slice(0, 5).map(f => output.highlight(f)));
-            }
-            return { success: true, data: result };
-        }
-        // No disk coverage - fall back to MCP tool
-        try {
-            const result = await callMCPTool('hooks_coverage-suggest', {
-                path: targetPath,
-                threshold,
-                limit,
-            });
-            spinner.stop();
-            if (ctx.flags.format === 'json') {
-                output.printJson(result);
-                return { success: true, data: result };
-            }
-            output.writeln();
-            output.printBox([
-                `Path: ${output.highlight(result.path)}`,
-                `Files Analyzed: ${result.summary.totalFiles}`,
-                `Line Coverage: ${result.summary.overallLineCoverage.toFixed(1)}%`,
-                `Branch Coverage: ${result.summary.overallBranchCoverage.toFixed(1)}%`,
-                `Below Threshold: ${result.summary.filesBelowThreshold} files`,
-                `Keyword routing: ${result.monovectorAvailable ? output.success('Available') : output.dim('Unavailable')}`
-            ].join('\n'), 'Coverage Summary');
-            if (result.suggestions.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Coverage Improvement Suggestions'));
-                output.printTable({
-                    columns: [
-                        { key: 'filePath', header: 'File', width: 40, format: (v) => {
-                                const s = String(v);
-                                return s.length > 37 ? '...' + s.slice(-37) : s;
-                            } },
-                        { key: 'coveragePercent', header: 'Coverage', width: 10, align: 'right', format: (v) => `${Number(v).toFixed(1)}%` },
-                        { key: 'gapType', header: 'Priority', width: 10 },
-                        { key: 'reason', header: 'Reason', width: 25 }
-                    ],
-                    data: result.suggestions.slice(0, 15)
-                });
-            }
-            else {
-                output.writeln();
-                output.printSuccess('All files meet coverage threshold!');
-            }
-            if (result.prioritizedFiles.length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Priority Files (Top 5)'));
-                output.printList(result.prioritizedFiles.slice(0, 5).map(f => output.highlight(f)));
-            }
-            return { success: true, data: result };
-        }
-        catch (error) {
-            spinner.fail('No coverage data found');
-            output.writeln();
-            output.printWarning('No coverage data found. Run your test suite with coverage first.');
-            output.writeln();
-            output.printList([
-                'Jest:     npx jest --coverage',
-                'Vitest:   npx vitest --coverage',
-                'nyc:      npx nyc npm test',
-                'c8:       npx c8 npm test',
-            ]);
-            output.writeln();
-            output.writeln(output.dim('Expected files: coverage/coverage-summary.json, coverage/lcov.info, or .nyc_output/out.json'));
-            return { success: false, exitCode: 1 };
-        }
-    }
-};
-// Coverage gaps subcommand
-export const coverageGapsCommand = {
-    name: 'coverage-gaps',
-    description: 'List all coverage gaps with priority scoring and agent assignments',
-    options: [
-        {
-            name: 'threshold',
-            description: 'Coverage threshold percentage (default: 80)',
-            type: 'number',
-            default: 80
-        },
-        {
-            name: 'group-by-agent',
-            description: 'Group gaps by suggested agent (default: true)',
-            type: 'boolean',
-            default: true
-        },
-        {
-            name: 'critical-only',
-            description: 'Show only critical gaps',
-            type: 'boolean',
-            default: false
-        }
-    ],
-    examples: [
-        { command: 'monomind hooks coverage-gaps', description: 'List all coverage gaps' },
-        { command: 'monomind hooks coverage-gaps --critical-only', description: 'Only critical gaps' },
-        { command: 'monomind hooks coverage-gaps --threshold 90', description: 'Stricter threshold' }
-    ],
-    action: async (ctx) => {
-        const threshold = ctx.flags.threshold || 80;
-        const groupByAgent = ctx.flags['group-by-agent'] !== false;
-        const criticalOnly = ctx.flags['critical-only'] || false;
-        const spinner = output.createSpinner({ text: 'Analyzing project coverage gaps...' });
-        spinner.start();
-        // Try reading coverage from disk first
-        const diskCoverage = readCoverageFromDisk();
-        if (diskCoverage.found) {
-            spinner.succeed(`Coverage data loaded from ${diskCoverage.source}`);
-            // Build gaps from disk data
-            const allGaps = diskCoverage.entries
-                .filter(e => e.lines < threshold)
-                .map(e => {
-                const { gapType, priority } = classifyCoverageGap(e.lines, threshold);
-                return {
-                    filePath: e.filePath,
-                    coveragePercent: e.lines,
-                    gapType,
-                    complexity: Math.round((100 - e.lines) / 10),
-                    priority,
-                    suggestedAgents: suggestAgentsForFile(e.filePath),
-                    reason: `Line coverage ${e.lines.toFixed(1)}% below ${threshold}% threshold`,
-                };
-            });
-            const gaps = criticalOnly
-                ? allGaps.filter(g => g.gapType === 'critical')
-                : allGaps;
-            // Build agent assignments
-            const agentAssignments = {};
-            if (groupByAgent) {
-                for (const gap of gaps) {
-                    const agent = gap.suggestedAgents[0] || 'tester';
-                    if (!agentAssignments[agent])
-                        agentAssignments[agent] = [];
-                    agentAssignments[agent].push(gap.filePath);
-                }
-            }
-            const result = {
-                success: true,
-                gaps,
-                summary: {
-                    totalFiles: diskCoverage.summary.totalFiles,
-                    overallLineCoverage: diskCoverage.summary.overallLineCoverage,
-                    overallBranchCoverage: diskCoverage.summary.overallBranchCoverage,
-                    filesBelowThreshold: gaps.length,
-                    coverageThreshold: threshold,
-                },
-                agentAssignments,
-                monovectorAvailable: false,
-                source: diskCoverage.source,
-            };
-            if (ctx.flags.format === 'json') {
-                output.printJson(result);
-                return { success: true, data: result };
-            }
-            output.writeln();
-            output.printBox([
-                `Total Files: ${result.summary.totalFiles}`,
-                `Line Coverage: ${result.summary.overallLineCoverage.toFixed(1)}%`,
-                `Branch Coverage: ${result.summary.overallBranchCoverage.toFixed(1)}%`,
-                `Below ${threshold}%: ${result.summary.filesBelowThreshold} files`,
-                `Source: ${output.highlight(diskCoverage.source)}`
-            ].join('\n'), 'Coverage Gap Analysis');
-            if (gaps.length > 0) {
-                output.writeln();
-                output.writeln(output.bold(`Coverage Gaps (${gaps.length} files)`));
-                output.printTable({
-                    columns: [
-                        { key: 'filePath', header: 'File', width: 35, format: (v) => {
-                                const s = String(v);
-                                return s.length > 32 ? '...' + s.slice(-32) : s;
-                            } },
-                        { key: 'coveragePercent', header: 'Coverage', width: 10, align: 'right', format: (v) => `${Number(v).toFixed(1)}%` },
-                        { key: 'gapType', header: 'Type', width: 10, format: (v) => {
-                                const t = String(v);
-                                if (t === 'critical')
-                                    return output.error(t);
-                                if (t === 'high')
-                                    return output.warning(t);
-                                return t;
-                            } },
-                        { key: 'priority', header: 'Priority', width: 8, align: 'right' },
-                        { key: 'suggestedAgents', header: 'Agent', width: 12, format: (v) => Array.isArray(v) ? v[0] || '' : String(v) }
-                    ],
-                    data: gaps.slice(0, 20)
-                });
-            }
-            else {
-                output.writeln();
-                output.printSuccess('No coverage gaps found! All files meet threshold.');
-            }
-            if (groupByAgent && Object.keys(agentAssignments).length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Agent Assignments'));
-                for (const [agent, files] of Object.entries(agentAssignments)) {
-                    output.writeln();
-                    output.writeln(`  ${output.highlight(agent)} (${files.length} files)`);
-                    files.slice(0, 3).forEach(f => {
-                        output.writeln(`    - ${output.dim(f)}`);
-                    });
-                    if (files.length > 3) {
-                        output.writeln(`    ... and ${files.length - 3} more`);
-                    }
-                }
-            }
-            return { success: true, data: result };
-        }
-        // No coverage files on disk - try MCP tool as fallback
-        try {
-            const result = await callMCPTool('hooks_coverage-gaps', {
-                threshold,
-                groupByAgent,
-            });
-            spinner.stop();
-            const gaps = criticalOnly
-                ? result.gaps.filter(g => g.gapType === 'critical')
-                : result.gaps;
-            if (ctx.flags.format === 'json') {
-                output.printJson({ ...result, gaps });
-                return { success: true, data: result };
-            }
-            output.writeln();
-            output.printBox([
-                `Total Files: ${result.summary.totalFiles}`,
-                `Line Coverage: ${result.summary.overallLineCoverage.toFixed(1)}%`,
-                `Branch Coverage: ${result.summary.overallBranchCoverage.toFixed(1)}%`,
-                `Below ${result.summary.coverageThreshold}%: ${result.summary.filesBelowThreshold} files`,
-                `Keyword routing: ${result.monovectorAvailable ? output.success('Available') : output.dim('Unavailable')}`
-            ].join('\n'), 'Coverage Gap Analysis');
-            if (gaps.length > 0) {
-                output.writeln();
-                output.writeln(output.bold(`Coverage Gaps (${gaps.length} files)`));
-                output.printTable({
-                    columns: [
-                        { key: 'filePath', header: 'File', width: 35, format: (v) => {
-                                const s = String(v);
-                                return s.length > 32 ? '...' + s.slice(-32) : s;
-                            } },
-                        { key: 'coveragePercent', header: 'Coverage', width: 10, align: 'right', format: (v) => `${Number(v).toFixed(1)}%` },
-                        { key: 'gapType', header: 'Type', width: 10, format: (v) => {
-                                const t = String(v);
-                                if (t === 'critical')
-                                    return output.error(t);
-                                if (t === 'high')
-                                    return output.warning(t);
-                                return t;
-                            } },
-                        { key: 'priority', header: 'Priority', width: 8, align: 'right' },
-                        { key: 'suggestedAgents', header: 'Agent', width: 12, format: (v) => Array.isArray(v) ? v[0] || '' : String(v) }
-                    ],
-                    data: gaps.slice(0, 20)
-                });
-            }
-            else {
-                output.writeln();
-                output.printSuccess('No coverage gaps found! All files meet threshold.');
-            }
-            if (groupByAgent && Object.keys(result.agentAssignments).length > 0) {
-                output.writeln();
-                output.writeln(output.bold('Agent Assignments'));
-                for (const [agent, files] of Object.entries(result.agentAssignments)) {
-                    output.writeln();
-                    output.writeln(`  ${output.highlight(agent)} (${files.length} files)`);
-                    files.slice(0, 3).forEach(f => {
-                        output.writeln(`    - ${output.dim(f)}`);
-                    });
-                    if (files.length > 3) {
-                        output.writeln(`    ... and ${files.length - 3} more`);
-                    }
-                }
-            }
-            return { success: true, data: result };
-        }
-        catch (error) {
-            spinner.fail('No coverage data found');
-            output.writeln();
-            output.printWarning('No coverage data found. Run your test suite with coverage first.');
-            output.writeln();
-            output.printList([
-                'Jest:     npx jest --coverage',
-                'Vitest:   npx vitest --coverage',
-                'nyc:      npx nyc npm test',
-                'c8:       npx c8 npm test',
-            ]);
-            output.writeln();
-            output.writeln(output.dim('Expected files: coverage/coverage-summary.json, coverage/lcov.info, or .nyc_output/out.json'));
-            return { success: false, exitCode: 1 };
-        }
-    }
-};
-// Progress hook command
-export const progressHookCommand = {
-    name: 'progress',
-    description: 'Check implementation progress via hooks',
-    options: [
-        {
-            name: 'detailed',
-            short: 'd',
-            description: 'Show detailed breakdown by category',
-            type: 'boolean',
-            default: false
-        },
-        {
-            name: 'sync',
-            short: 's',
-            description: 'Sync and persist progress to file',
-            type: 'boolean',
-            default: false
-        },
-        {
-            name: 'summary',
-            description: 'Show human-readable summary',
-            type: 'boolean',
-            default: false
-        }
-    ],
-    examples: [
-        { command: 'monomind hooks progress', description: 'Check current progress' },
-        { command: 'monomind hooks progress -d', description: 'Detailed breakdown' },
-        { command: 'monomind hooks progress --sync', description: 'Sync progress to file' },
-        { command: 'monomind hooks progress --summary', description: 'Human-readable summary' }
-    ],
-    action: async (ctx) => {
-        const detailed = ctx.flags.detailed;
-        const sync = ctx.flags.sync;
-        const summary = ctx.flags.summary;
-        try {
-            if (summary) {
-                const spinner = output.createSpinner({ text: 'Getting progress summary...' });
-                spinner.start();
-                const result = await callMCPTool('progress_summary', {});
-                spinner.stop();
-                if (ctx.flags.format === 'json') {
-                    output.printJson(result);
-                    return { success: true, data: result };
-                }
-                output.writeln();
-                output.writeln(result.summary);
-                return { success: true, data: result };
-            }
-            if (sync) {
-                const spinner = output.createSpinner({ text: 'Syncing progress...' });
-                spinner.start();
-                const result = await callMCPTool('progress_sync', {});
-                spinner.stop();
-                if (ctx.flags.format === 'json') {
-                    output.printJson(result);
-                    return { success: true, data: result };
-                }
-                output.writeln();
-                output.printSuccess(`Progress synced: ${result.progress}%`);
-                output.writeln(output.dim(`  Persisted to .monomind/metrics/v1-progress.json`));
-                output.writeln(output.dim(`  Last updated: ${result.lastUpdated}`));
-                return { success: true, data: result };
-            }
-            // Default: check progress
-            const spinner = output.createSpinner({ text: 'Checking v1 progress...' });
-            spinner.start();
-            const result = await callMCPTool('progress_check', { detailed });
-            spinner.stop();
-            if (ctx.flags.format === 'json') {
-                output.printJson(result);
-                return { success: true, data: result };
-            }
-            output.writeln();
-            const progressValue = result.overall ?? result.progress ?? 0;
-            // Create progress bar
-            const barWidth = 30;
-            const filled = Math.round((progressValue / 100) * barWidth);
-            const empty = barWidth - filled;
-            const bar = output.success('█'.repeat(filled)) + output.dim('░'.repeat(empty));
-            output.writeln(output.bold('v1 Implementation Progress'));
-            output.writeln();
-            output.writeln(`[${bar}] ${progressValue}%`);
-            output.writeln();
-            if (detailed && result.cli) {
-                output.writeln(output.highlight('CLI Commands:') + `     ${result.cli.progress}% (${result.cli.commands}/${result.cli.target})`);
-                output.writeln(output.highlight('MCP Tools:') + `        ${result.mcp?.progress ?? 0}% (${result.mcp?.tools ?? 0}/${result.mcp?.target ?? 0})`);
-                output.writeln(output.highlight('Hooks:') + `            ${result.hooks?.progress ?? 0}% (${result.hooks?.subcommands ?? 0}/${result.hooks?.target ?? 0})`);
-                output.writeln(output.highlight('Packages:') + `         ${result.packages?.progress ?? 0}% (${result.packages?.total ?? 0}/${result.packages?.target ?? 0})`);
-                output.writeln(output.highlight('DDD Structure:') + `    ${result.ddd?.progress ?? 0}% (${result.packages?.withDDD ?? 0}/${result.packages?.total ?? 0})`);
-                output.writeln();
-                if (result.codebase) {
-                    output.writeln(output.dim(`Codebase: ${result.codebase.totalFiles} files, ${result.codebase.totalLines.toLocaleString()} lines`));
-                }
-            }
-            else if (result.breakdown) {
-                output.writeln('Breakdown:');
-                for (const [category, value] of Object.entries(result.breakdown)) {
-                    output.writeln(`  ${output.highlight(category)}: ${value}`);
-                }
-            }
-            if (result.lastUpdated) {
-                output.writeln(output.dim(`Last updated: ${result.lastUpdated}`));
-            }
-            return { success: true, data: result };
-        }
-        catch (error) {
-            if (error instanceof MCPClientError) {
-                output.printError(`Progress check failed: ${error.message}`);
-            }
-            else {
-                output.printError(`Progress check failed: ${String(error)}`);
-            }
-            return { success: false, exitCode: 1 };
-        }
-    }
-};
+// Re-export commands from sub-modules so hooks.ts import stays unchanged
+export { coverageRouteCommand } from './hooks-coverage-routing.js';
+export { coverageSuggestCommand } from './hooks-coverage-routing.js';
+export { coverageGapsCommand } from './hooks-coverage-gaps.js';
+export { progressHookCommand } from './hooks-coverage-gaps.js';
 // Statusline subcommand - generates dynamic status display
 export const statuslineCommand = {
     name: 'statusline',
@@ -790,7 +42,6 @@ export const statuslineCommand = {
         const fs = await import('fs');
         const path = await import('path');
         const { execSync } = await import('child_process');
-        // Get learning stats from memory database
         function getLearningStats() {
             const memoryPaths = [
                 path.join(process.cwd(), '.swarm', 'memory.db'),
@@ -809,9 +60,7 @@ export const statuslineCommand = {
                         trajectories = Math.floor(patterns / 5);
                         break;
                     }
-                    catch {
-                        // Ignore
-                    }
+                    catch { /* ignore */ }
                 }
             }
             const sessionsPath = path.join(process.cwd(), '.claude', 'sessions');
@@ -820,13 +69,10 @@ export const statuslineCommand = {
                     const sessionFiles = fs.readdirSync(sessionsPath).filter((f) => f.endsWith('.json'));
                     sessions = Math.max(sessions, sessionFiles.length);
                 }
-                catch {
-                    // Ignore
-                }
+                catch { /* ignore */ }
             }
             return { patterns, sessions, trajectories };
         }
-        // Get v1 progress
         function getv1Progress() {
             const learning = getLearningStats();
             let domainsCompleted = 0;
@@ -844,7 +90,6 @@ export const statuslineCommand = {
             const dddProgress = Math.min(100, Math.floor((domainsCompleted / totalDomains) * 100));
             return { domainsCompleted, totalDomains, dddProgress, patternsLearned: learning.patterns, sessionsCompleted: learning.sessions };
         }
-        // Get security status
         function getSecurityStatus() {
             const scanResultsPath = path.join(process.cwd(), '.claude', 'security-scans');
             let cvesFixed = 0;
@@ -854,9 +99,7 @@ export const statuslineCommand = {
                     const scans = fs.readdirSync(scanResultsPath).filter((f) => f.endsWith('.json'));
                     cvesFixed = Math.min(totalCves, scans.length);
                 }
-                catch {
-                    // Ignore
-                }
+                catch { /* ignore */ }
             }
             const auditPath = path.join(process.cwd(), '.swarm', 'security');
             if (fs.existsSync(auditPath)) {
@@ -864,14 +107,11 @@ export const statuslineCommand = {
                     const audits = fs.readdirSync(auditPath).filter((f) => f.includes('audit'));
                     cvesFixed = Math.min(totalCves, Math.max(cvesFixed, audits.length));
                 }
-                catch {
-                    // Ignore
-                }
+                catch { /* ignore */ }
             }
             const status = cvesFixed >= totalCves ? 'CLEAN' : cvesFixed > 0 ? 'IN_PROGRESS' : 'PENDING';
             return { status, cvesFixed, totalCves };
         }
-        // Get swarm status
         function getSwarmStatus() {
             let activeAgents = 0;
             let coordinationActive = false;
@@ -886,12 +126,9 @@ export const statuslineCommand = {
                 activeAgents = Math.max(0, isWindows ? raw : raw - 1);
                 coordinationActive = activeAgents > 0;
             }
-            catch {
-                // Ignore
-            }
+            catch { /* ignore */ }
             return { activeAgents, maxAgents, coordinationActive };
         }
-        // Get system metrics
         function getSystemMetrics() {
             let memoryMB = 0;
             let subAgents = 0;
@@ -899,12 +136,8 @@ export const statuslineCommand = {
             try {
                 memoryMB = Math.floor(process.memoryUsage().heapUsed / 1024 / 1024);
             }
-            catch {
-                // Ignore
-            }
-            // Calculate intelligence from multiple sources (matching statusline-generator.ts)
+            catch { /* ignore */ }
             let intelligencePct = 0;
-            // 1. Check learning.json for REAL intelligence metrics first
             const learningJsonPaths = [
                 path.join(process.cwd(), '.monomind', 'learning.json'),
                 path.join(process.cwd(), '.claude', '.monomind', 'learning.json'),
@@ -924,16 +157,11 @@ export const statuslineCommand = {
                     catch { /* ignore */ }
                 }
             }
-            // 2. Fallback: calculate from patterns and vectors
             if (intelligencePct === 0) {
-                const fromPatterns = learning.patterns > 0 ? Math.min(100, Math.floor(learning.patterns / 10)) : 0;
-                // Will be updated later with vector count
-                intelligencePct = fromPatterns;
+                intelligencePct = learning.patterns > 0 ? Math.min(100, Math.floor(learning.patterns / 10)) : 0;
             }
-            // 3. Fallback: calculate maturity score from project indicators
             if (intelligencePct === 0) {
                 let maturityScore = 0;
-                // Check for key project files/dirs
                 if (fs.existsSync(path.join(process.cwd(), '.claude')))
                     maturityScore += 15;
                 if (fs.existsSync(path.join(process.cwd(), '.monomind')))
@@ -944,7 +172,6 @@ export const statuslineCommand = {
                     maturityScore += 10;
                 if (fs.existsSync(path.join(process.cwd(), '.swarm')))
                     maturityScore += 10;
-                // Check for test files
                 const testDirs = ['tests', '__tests__', 'test', 'v1/__tests__'];
                 for (const dir of testDirs) {
                     if (fs.existsSync(path.join(process.cwd(), dir))) {
@@ -952,7 +179,6 @@ export const statuslineCommand = {
                         break;
                     }
                 }
-                // Check for hooks config
                 if (fs.existsSync(path.join(process.cwd(), '.claude', 'settings.json')))
                     maturityScore += 10;
                 intelligencePct = Math.min(100, maturityScore);
@@ -960,30 +186,22 @@ export const statuslineCommand = {
             const contextPct = Math.min(100, Math.floor(learning.sessions * 5));
             return { memoryMB, contextPct, intelligencePct, subAgents };
         }
-        // Get user info
         function getUserInfo() {
             let name = 'user';
             let gitBranch = '';
             const modelName = 'Opus 4.6 (1M context)';
             const isWindows = process.platform === 'win32';
             try {
-                const nameCmd = isWindows
-                    ? 'git config user.name 2>NUL || echo user'
-                    : 'git config user.name 2>/dev/null || echo "user"';
-                const branchCmd = isWindows
-                    ? 'git branch --show-current 2>NUL || echo.'
-                    : 'git branch --show-current 2>/dev/null || echo ""';
+                const nameCmd = isWindows ? 'git config user.name 2>NUL || echo user' : 'git config user.name 2>/dev/null || echo "user"';
+                const branchCmd = isWindows ? 'git branch --show-current 2>NUL || echo.' : 'git branch --show-current 2>/dev/null || echo ""';
                 name = execSync(nameCmd, { encoding: 'utf-8' }).trim();
                 gitBranch = execSync(branchCmd, { encoding: 'utf-8' }).trim();
                 if (gitBranch === '.')
                     gitBranch = '';
             }
-            catch {
-                // Ignore
-            }
+            catch { /* ignore */ }
             return { name, gitBranch, modelName };
         }
-        // Collect all status
         const progress = getv1Progress();
         const security = getSecurityStatus();
         const swarm = getSwarmStatus();
@@ -997,18 +215,15 @@ export const statuslineCommand = {
             system,
             timestamp: new Date().toISOString()
         };
-        // JSON output
         if (ctx.flags.json || ctx.flags.format === 'json') {
             output.printJson(statusData);
             return { success: true, data: statusData };
         }
-        // Compact output
         if (ctx.flags.compact) {
             const line = `DDD:${progress.domainsCompleted}/${progress.totalDomains} CVE:${security.cvesFixed}/${security.totalCves} Swarm:${swarm.activeAgents}/${swarm.maxAgents} Ctx:${system.contextPct}% Int:${system.intelligencePct}%`;
             output.writeln(line);
             return { success: true, data: statusData };
         }
-        // Full colored output
         const noColor = ctx.flags['no-color'] || ctx.flags.noColor;
         const c = noColor ? {
             reset: '', bold: '', dim: '', red: '', green: '', yellow: '', blue: '',
@@ -1021,13 +236,11 @@ export const statuslineCommand = {
             brightGreen: '\x1b[1;32m', brightYellow: '\x1b[1;33m', brightBlue: '\x1b[1;34m',
             brightPurple: '\x1b[1;35m', brightCyan: '\x1b[1;36m', brightWhite: '\x1b[1;37m'
         };
-        // Progress bar helper
         const progressBar = (current, total) => {
             const filled = Math.round((current / total) * 5);
             const empty = 5 - filled;
             return '[' + '●'.repeat(filled) + '○'.repeat(empty) + ']';
         };
-        // Generate lines
         let header = `${c.bold}${c.brightPurple}▊ Monomind ${c.reset}`;
         header += `${swarm.coordinationActive ? c.brightCyan : c.dim}● ${c.brightCyan}${user.name}${c.reset}`;
         if (user.gitBranch) {
@@ -1035,7 +248,6 @@ export const statuslineCommand = {
         }
         header += `  ${c.dim}│${c.reset}  ${c.purple}${user.modelName}${c.reset}`;
         const separator = `${c.dim}─────────────────────────────────────────────────────${c.reset}`;
-        // Get hooks stats
         const hooksStats = { enabled: 0, total: 17 };
         const settingsPath = path.join(process.cwd(), '.claude', 'settings.json');
         if (fs.existsSync(settingsPath)) {
@@ -1049,9 +261,7 @@ export const statuslineCommand = {
             }
             catch { /* ignore */ }
         }
-        // Get memory backend stats
         const memoryStats = { vectorCount: 0, dbSizeKB: 0, hasHnsw: false };
-        // Check for direct database files first
         const dbPaths = [
             path.join(process.cwd(), '.swarm', 'memory.db'),
             path.join(process.cwd(), '.monomind', 'memory.db'),
@@ -1073,13 +283,11 @@ export const statuslineCommand = {
                 catch { /* ignore */ }
             }
         }
-        // Check for LanceDB directories if no direct db found
         if (memoryStats.vectorCount === 0) {
             const lancedbDirs = [
                 path.join(process.cwd(), ".monomind", "lancedb"),
                 path.join(process.cwd(), ".swarm", "lancedb"),
                 path.join(process.cwd(), "data", "lancedb"),
-                path.join(process.cwd(), ".swarm", "lancedb"),
             ];
             for (const dir of lancedbDirs) {
                 if (fs.existsSync(dir)) {
@@ -1087,8 +295,7 @@ export const statuslineCommand = {
                         const files = fs.readdirSync(dir);
                         for (const f of files) {
                             if (f.endsWith('.db') || f.endsWith('.sqlite')) {
-                                const filePath = path.join(dir, f);
-                                const fileStat = fs.statSync(filePath);
+                                const fileStat = fs.statSync(path.join(dir, f));
                                 memoryStats.dbSizeKB += Math.round(fileStat.size / 1024);
                             }
                         }
@@ -1101,7 +308,6 @@ export const statuslineCommand = {
                 }
             }
         }
-        // Check for HNSW index files
         const hnswPaths = [
             path.join(process.cwd(), '.monomind', 'hnsw'),
             path.join(process.cwd(), '.swarm', 'hnsw'),
@@ -1115,15 +321,13 @@ export const statuslineCommand = {
                     const indexFile = hnswFiles.find(f => f.endsWith('.index'));
                     if (indexFile) {
                         const indexStat = fs.statSync(path.join(hnswPath, indexFile));
-                        const hnswVectors = Math.floor(indexStat.size / 512);
-                        memoryStats.vectorCount = Math.max(memoryStats.vectorCount, hnswVectors);
+                        memoryStats.vectorCount = Math.max(memoryStats.vectorCount, Math.floor(indexStat.size / 512));
                     }
                 }
                 catch { /* ignore */ }
                 break;
             }
         }
-        // Check for vectors.json file
         const vectorsPath = path.join(process.cwd(), '.monomind', 'vectors.json');
         if (fs.existsSync(vectorsPath) && memoryStats.vectorCount === 0) {
             try {
@@ -1139,21 +343,18 @@ export const statuslineCommand = {
             }
             catch { /* ignore */ }
         }
-        // Get test stats
         const testStats = { testFiles: 0, testCases: 0 };
-        const testPaths = ['tests', '__tests__', 'test', 'spec'];
-        for (const testPath of testPaths) {
+        for (const testPath of ['tests', '__tests__', 'test', 'spec']) {
             const fullPath = path.join(process.cwd(), testPath);
             if (fs.existsSync(fullPath)) {
                 try {
                     const files = fs.readdirSync(fullPath, { recursive: true });
                     testStats.testFiles = files.filter((f) => /\.(test|spec)\.(ts|js|tsx|jsx)$/.test(f)).length;
-                    testStats.testCases = testStats.testFiles * 28; // Estimate
+                    testStats.testCases = testStats.testFiles * 28;
                 }
                 catch { /* ignore */ }
             }
         }
-        // Get MCP stats
         const mcpStats = { enabled: 0, total: 0 };
         const mcpPath = path.join(process.cwd(), '.mcp.json');
         if (fs.existsSync(mcpPath)) {
@@ -1167,7 +368,6 @@ export const statuslineCommand = {
             catch { /* ignore */ }
         }
         const domainsColor = progress.domainsCompleted >= 3 ? c.brightGreen : progress.domainsCompleted > 0 ? c.yellow : c.red;
-        // Dynamic perf indicator based on patterns/HNSW
         let perfIndicator = `${c.dim}⚡ HNSW: idle${c.reset}`;
         if (memoryStats.hasHnsw && memoryStats.vectorCount > 0) {
             perfIndicator = `${c.brightGreen}⚡ HNSW ${memoryStats.vectorCount.toLocaleString()} vec${c.reset}`;