monomind 1.17.0 → 1.17.1

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

@@ -0,0 +1,399 @@
+/**
+ * Coverage-aware routing commands: coverage-route, coverage-suggest
+ */
+import { output } from '../output.js';
+import { callMCPTool } from '../mcp-client.js';
+import { readCoverageFromDisk, classifyCoverageGap, suggestAgentsForFile, } from './hooks-coverage-utils.js';
+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();
+        const diskCoverage = readCoverageFromDisk();
+        if (diskCoverage.found) {
+            spinner.succeed(`Coverage data loaded from ${diskCoverage.source}`);
+            const taskLower = task.toLowerCase();
+            const taskWords = taskLower.split(/\s+/).filter(w => w.length > 2);
+            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;
+                }
+                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 };
+        }
+        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 {
+            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 };
+        }
+    }
+};
+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();
+        const diskCoverage = readCoverageFromDisk();
+        if (diskCoverage.found) {
+            spinner.succeed(`Coverage data loaded from ${diskCoverage.source}`);
+            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 };
+        }
+        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 {
+            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 };
+        }
+    }
+};
+//# sourceMappingURL=hooks-coverage-routing.js.map

package/packages/@monomind/cli/dist/src/commands/init-subcommands.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Init subcommands: check, skills, hooks
+ */
+import type { Command } from '../types.js';
+export declare const checkCommand: Command;
+export declare const skillsCommand: Command;
+export declare const hooksCommand: Command;
+//# sourceMappingURL=init-subcommands.d.ts.map

package/packages/@monomind/cli/dist/src/commands/init-subcommands.js

@@ -0,0 +1,156 @@
+/**
+ * Init subcommands: check, skills, hooks
+ */
+import { output } from '../output.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import { executeInit, DEFAULT_INIT_OPTIONS, MINIMAL_INIT_OPTIONS, } from '../init/index.js';
+function isInitialized(cwd) {
+    const claudePath = path.join(cwd, '.claude', 'settings.json');
+    const monomindPath = path.join(cwd, '.monomind', 'config.yaml');
+    return {
+        claude: fs.existsSync(claudePath),
+        monomind: fs.existsSync(monomindPath),
+    };
+}
+export const checkCommand = {
+    name: 'check',
+    description: 'Check if MonoMind is initialized',
+    action: async (ctx) => {
+        const initialized = isInitialized(ctx.cwd);
+        const result = {
+            initialized: initialized.claude || initialized.monomind,
+            claude: initialized.claude,
+            monomind: initialized.monomind,
+            paths: {
+                claudeSettings: initialized.claude ? path.join(ctx.cwd, '.claude', 'settings.json') : null,
+                monomindConfig: initialized.monomind ? path.join(ctx.cwd, '.monomind', 'config.yaml') : null,
+            },
+        };
+        if (ctx.flags.format === 'json') {
+            output.printJson(result);
+            return { success: true, data: result };
+        }
+        if (result.initialized) {
+            output.printSuccess('MonoMind is initialized');
+            if (initialized.claude) {
+                output.printInfo(`  Claude Code: .claude/settings.json`);
+            }
+            if (initialized.monomind) {
+                output.printInfo(`  Runtime: .monomind/config.yaml`);
+            }
+        }
+        else {
+            output.printWarning('MonoMind is not initialized in this directory');
+            output.printInfo('Run "monomind init" to initialize');
+        }
+        return { success: true, data: result };
+    },
+};
+export const skillsCommand = {
+    name: 'skills',
+    description: 'Initialize only skills',
+    options: [
+        { name: 'all', description: 'Install all skills', type: 'boolean', default: false },
+        { name: 'core', description: 'Install core skills', type: 'boolean', default: true },
+        { name: 'memory', description: 'Install memory skills', type: 'boolean', default: false },
+        { name: 'github', description: 'Install GitHub skills', type: 'boolean', default: false },
+    ],
+    action: async (ctx) => {
+        const options = {
+            ...MINIMAL_INIT_OPTIONS,
+            targetDir: ctx.cwd,
+            force: ctx.flags.force,
+            components: {
+                settings: false,
+                skills: true,
+                commands: false,
+                agents: false,
+                helpers: false,
+                statusline: false,
+                mcp: false,
+                runtime: false,
+                claudeMd: false,
+                graphify: false,
+            },
+            skills: {
+                all: ctx.flags.all,
+                core: ctx.flags.core,
+                memory: ctx.flags.memory,
+                github: ctx.flags.github,
+                browser: false,
+                advanced: false,
+            },
+        };
+        const spinner = output.createSpinner({ text: 'Installing skills...' });
+        spinner.start();
+        const result = await executeInit(options);
+        if (result.success) {
+            spinner.succeed(`Installed ${result.summary.skillsCount} skills`);
+        }
+        else {
+            spinner.fail('Failed to install skills');
+            for (const error of result.errors) {
+                output.printError(error);
+            }
+        }
+        return { success: result.success, data: result };
+    },
+};
+export const hooksCommand = {
+    name: 'hooks',
+    description: 'Initialize only hooks configuration',
+    options: [
+        { name: 'all', description: 'Enable all hooks', type: 'boolean', default: true },
+        { name: 'minimal', description: 'Enable only essential hooks', type: 'boolean', default: false },
+    ],
+    action: async (ctx) => {
+        const minimal = ctx.flags.minimal;
+        const options = {
+            ...DEFAULT_INIT_OPTIONS,
+            targetDir: ctx.cwd,
+            force: ctx.flags.force,
+            components: {
+                settings: true,
+                skills: false,
+                commands: false,
+                agents: false,
+                helpers: false,
+                statusline: false,
+                mcp: false,
+                runtime: false,
+                claudeMd: false,
+                graphify: false,
+            },
+            hooks: minimal
+                ? {
+                    preToolUse: true,
+                    postToolUse: true,
+                    userPromptSubmit: false,
+                    sessionStart: false,
+                    stop: false,
+                    preCompact: false,
+                    notification: false,
+                    teammateIdle: false,
+                    taskCompleted: false,
+                    timeout: 5000,
+                    continueOnError: true,
+                }
+                : DEFAULT_INIT_OPTIONS.hooks,
+        };
+        const spinner = output.createSpinner({ text: 'Creating hooks configuration...' });
+        spinner.start();
+        const result = await executeInit(options);
+        if (result.success) {
+            spinner.succeed(`Created settings.json with ${result.summary.hooksEnabled} hooks enabled`);
+        }
+        else {
+            spinner.fail('Failed to create hooks configuration');
+            for (const error of result.errors) {
+                output.printError(error);
+            }
+        }
+        return { success: result.success, data: result };
+    },
+};
+//# sourceMappingURL=init-subcommands.js.map

package/packages/@monomind/cli/dist/src/commands/init-upgrade.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Init upgrade subcommand — update helpers without losing user data
+ */
+import type { Command } from '../types.js';
+export declare const upgradeCommand: Command;
+//# sourceMappingURL=init-upgrade.d.ts.map