cmp-standards 3.1.1 → 3.3.0

package/dist/cli/index.js

@@ -1396,6 +1396,493 @@ program
     }
 });
 // =============================================================================
+// OPPORTUNITIES COMMAND
+// =============================================================================
+program
+    .command('opportunities')
+    .description('Discover improvement opportunities across the codebase')
+    .argument('[paths...]', 'Files or directories to analyze')
+    .option('-c, --category <category>', 'Filter by category (idea, edge_case, security, performance, etc.)')
+    .option('-i, --impact <impact>', 'Minimum impact level (low, medium, high)', 'low')
+    .option('-e, --effort <effort>', 'Maximum effort level (trivial, small, medium, large, epic)', 'epic')
+    .option('-d, --depth <depth>', 'Analysis depth (quick, standard, thorough)', 'standard')
+    .option('--export', 'Export results as markdown')
+    .option('--json', 'Output results as JSON')
+    .action(async (paths, options) => {
+    ui.header('Opportunity Discovery');
+    const config = await loadConfig(process.cwd());
+    const system = config.system;
+    const { getOpportunityDiscovery } = await import('../services/OpportunityDiscovery.js');
+    const discovery = getOpportunityDiscovery(system);
+    // Parse category filter
+    const categories = options.category
+        ? [options.category]
+        : [];
+    const result = await withSpinner(`Analyzing codebase (${options.depth} mode)...`, () => discovery.discover({
+        paths: paths.length > 0 ? paths : ['.'],
+        categories,
+        minImpact: options.impact,
+        maxEffort: options.effort,
+        depth: options.depth,
+        system,
+    }));
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    if (options.export) {
+        const markdown = await discovery.exportMarkdown(result.opportunities);
+        console.log(markdown);
+        return;
+    }
+    // Display summary
+    console.log('');
+    ui.subheader('Summary');
+    console.log(`  Files analyzed: ${chalk.cyan(result.summary.filesAnalyzed)}`);
+    console.log(`  Opportunities found: ${chalk.cyan(result.summary.totalFound)}`);
+    console.log(`  Analysis time: ${chalk.gray(result.summary.analysisTimeMs + 'ms')}`);
+    console.log('');
+    // Display by category
+    ui.subheader('By Category');
+    const categoryNames = {
+        idea: '💡 Ideas',
+        edge_case: '⚠️  Edge Cases',
+        future_feature: '🚀 Future Features',
+        technical_debt: '🔧 Technical Debt',
+        performance: '⚡ Performance',
+        security: '🔒 Security',
+        dx_improvement: '👩‍💻 DX Improvements',
+        documentation: '📚 Documentation',
+        test_coverage: '🧪 Test Coverage',
+        accessibility: '♿ Accessibility',
+    };
+    for (const [category, count] of Object.entries(result.summary.byCategory)) {
+        const name = categoryNames[category] ?? category;
+        console.log(`  ${name}: ${chalk.yellow(count)}`);
+    }
+    console.log('');
+    // Display by impact
+    ui.subheader('By Impact');
+    const impactColors = {
+        high: chalk.red,
+        medium: chalk.yellow,
+        low: chalk.gray,
+    };
+    for (const [impact, count] of Object.entries(result.summary.byImpact)) {
+        const color = impactColors[impact] ?? chalk.white;
+        console.log(`  ${impact.toUpperCase()}: ${color(count.toString())}`);
+    }
+    console.log('');
+    // Display top opportunities
+    if (result.opportunities.length > 0) {
+        ui.subheader('Top Opportunities');
+        // Sort by impact (high first)
+        const impactOrder = ['high', 'medium', 'low'];
+        const sorted = [...result.opportunities].sort((a, b) => {
+            return impactOrder.indexOf(a.impact) - impactOrder.indexOf(b.impact);
+        });
+        const top = sorted.slice(0, 10);
+        for (const opp of top) {
+            const icon = categoryNames[opp.category]?.slice(0, 2) ?? '📋';
+            const impactColor = impactColors[opp.impact] ?? chalk.white;
+            console.log(`  ${icon} ${chalk.white(opp.title)}`);
+            console.log(`     Impact: ${impactColor(opp.impact)} | Effort: ${chalk.gray(opp.effort)} | Confidence: ${chalk.gray(Math.round(opp.confidence * 100) + '%')}`);
+            if (opp.relatedFiles.length > 0) {
+                console.log(`     File: ${chalk.gray(opp.relatedFiles[0])}`);
+            }
+            console.log('');
+        }
+        if (result.opportunities.length > 10) {
+            console.log(chalk.gray(`  ... and ${result.opportunities.length - 10} more opportunities`));
+            console.log(chalk.gray('  Run with --export to see all'));
+        }
+    }
+    // Display top files with issues
+    if (result.summary.topFiles.length > 0) {
+        console.log('');
+        ui.subheader('Files with Most Opportunities');
+        for (const { file, count } of result.summary.topFiles.slice(0, 5)) {
+            console.log(`  ${chalk.gray(file)}: ${chalk.yellow(count)}`);
+        }
+    }
+    console.log('');
+    ui.success(`Run ID: ${result.runId}`);
+});
+// =============================================================================
+// WIKI COMMAND (CodeWiki - Code Knowledge Graph)
+// =============================================================================
+const wikiCmd = program
+    .command('wiki')
+    .description('CodeWiki - Code knowledge graph and documentation');
+wikiCmd
+    .command('index')
+    .description('Index codebase for CodeWiki knowledge graph')
+    .argument('[paths...]', 'Paths to index (defaults to current directory)')
+    .option('-d, --depth <depth>', 'Index depth (quick, standard, thorough)', 'standard')
+    .option('-f, --force', 'Force re-index all files (ignore cache)')
+    .option('-s, --system <system>', 'System identifier')
+    .option('--json', 'Output as JSON')
+    .action(async (paths, options) => {
+    ui.header('CodeWiki Indexer');
+    const projectRoot = await getProjectRoot();
+    let system = options.system;
+    if (!system) {
+        try {
+            const config = await loadConfig(projectRoot);
+            system = config.system;
+        }
+        catch {
+            system = 'UNKNOWN';
+        }
+    }
+    const { getCodeWikiIndexer } = await import('../services/CodeWikiIndexer.js');
+    const indexer = getCodeWikiIndexer(system, projectRoot);
+    const result = await withSpinner(`Indexing codebase (${options.depth} mode)...`, () => indexer.index({
+        projectId: system,
+        paths: paths.length > 0 ? paths : ['.'],
+        rootDir: projectRoot,
+        depth: options.depth,
+        force: options.force ?? false,
+    }));
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log('');
+    ui.subheader('Indexing Complete');
+    console.log(`  Run ID: ${chalk.cyan(result.runId)}`);
+    console.log(`  Status: ${result.status === 'completed' ? chalk.green('✓ Completed') : chalk.red(result.status)}`);
+    console.log(`  Duration: ${chalk.gray(result.durationMs + 'ms')}`);
+    console.log('');
+    ui.subheader('Statistics');
+    ui.keyValue({
+        'Files Scanned': result.stats.filesScanned,
+        'Files Indexed': result.stats.filesIndexed,
+        'Files Skipped (unchanged)': result.stats.filesSkipped,
+        'Files Changed': result.stats.filesChanged,
+        'Symbols Extracted': result.stats.symbolsExtracted,
+        'Dependencies Found': result.stats.dependenciesFound,
+        'Errors': result.stats.errorsEncountered,
+    });
+    if (result.errors.length > 0) {
+        console.log('');
+        ui.subheader('Errors');
+        for (const error of result.errors.slice(0, 5)) {
+            console.log(`  ❌ ${chalk.gray(error.file)}: ${error.error}`);
+        }
+        if (result.errors.length > 5) {
+            console.log(chalk.gray(`  ... and ${result.errors.length - 5} more errors`));
+        }
+    }
+});
+wikiCmd
+    .command('status')
+    .description('Show CodeWiki index status')
+    .option('-s, --system <system>', 'System identifier')
+    .action(async (options) => {
+    ui.header('CodeWiki Status');
+    const projectRoot = await getProjectRoot();
+    let system = options.system;
+    if (!system) {
+        try {
+            const config = await loadConfig(projectRoot);
+            system = config.system;
+        }
+        catch {
+            system = 'UNKNOWN';
+        }
+    }
+    const { query: tursoQuery } = await import('../db/turso-client.js');
+    // Get latest index run
+    const runs = await tursoQuery({
+        type: 'index_run',
+        system,
+        limit: 5,
+    });
+    if (runs.length === 0) {
+        console.log(chalk.yellow('  No index runs found'));
+        console.log(chalk.gray('  Run: cmp-standards wiki index'));
+        return;
+    }
+    ui.subheader('Recent Index Runs');
+    for (const run of runs) {
+        try {
+            const content = run.content;
+            const status = content.status === 'completed' ? chalk.green('✓') : chalk.yellow(content.status);
+            const files = content.stats?.filesIndexed ?? 0;
+            const symbols = content.stats?.symbolsExtracted ?? 0;
+            const duration = content.durationMs ? `${content.durationMs}ms` : 'running';
+            console.log(`  ${status} ${chalk.gray(content.startedAt)} - ${files} files, ${symbols} symbols (${duration})`);
+        }
+        catch {
+            // Skip malformed records
+        }
+    }
+    // Get counts
+    console.log('');
+    ui.subheader('Index Summary');
+    const fileMetadata = await tursoQuery({ type: 'file_metadata', system, limit: 1 });
+    const codeStructure = await tursoQuery({ type: 'code_structure', system, limit: 1 });
+    const codeDependency = await tursoQuery({ type: 'code_dependency', system, limit: 1 });
+    ui.keyValue({
+        'File Metadata': fileMetadata.length > 0 ? '✓' : '✗',
+        'Code Structure': codeStructure.length > 0 ? '✓' : '✗',
+        'Dependencies': codeDependency.length > 0 ? '✓' : '✗',
+    });
+});
+wikiCmd
+    .command('search <query>')
+    .description('Search CodeWiki for symbols, files, or patterns')
+    .option('-t, --type <type>', 'Filter by type (function, class, interface, type, component)')
+    .option('-f, --file <file>', 'Filter by file pattern')
+    .option('-s, --system <system>', 'System identifier')
+    .option('-l, --limit <limit>', 'Maximum results', '20')
+    .action(async (query, options) => {
+    ui.header('CodeWiki Search');
+    const projectRoot = await getProjectRoot();
+    let system = options.system;
+    if (!system) {
+        try {
+            const config = await loadConfig(projectRoot);
+            system = config.system;
+        }
+        catch {
+            system = 'UNKNOWN';
+        }
+    }
+    const { query: tursoQuery } = await import('../db/turso-client.js');
+    // Search code structures for symbols
+    const structures = await tursoQuery({
+        type: 'code_structure',
+        system,
+        limit: 100,
+    });
+    const results = [];
+    const queryLower = query.toLowerCase();
+    const limit = parseInt(options.limit, 10);
+    for (const struct of structures) {
+        try {
+            const content = struct.content;
+            const symbols = content.symbols ?? [];
+            for (const symbol of symbols) {
+                // Check name match
+                if (!symbol.name.toLowerCase().includes(queryLower))
+                    continue;
+                // Check type filter
+                if (options.type && symbol.kind !== options.type)
+                    continue;
+                // Check file filter
+                if (options.file && !content.filePath.includes(options.file))
+                    continue;
+                results.push({
+                    name: symbol.name,
+                    kind: symbol.kind,
+                    file: content.filePath,
+                    line: symbol.lineStart,
+                    exported: symbol.isExported,
+                });
+                if (results.length >= limit)
+                    break;
+            }
+        }
+        catch {
+            // Skip malformed records
+        }
+        if (results.length >= limit)
+            break;
+    }
+    if (results.length === 0) {
+        console.log(chalk.yellow(`  No results found for "${query}"`));
+        return;
+    }
+    console.log(`  Found ${chalk.cyan(results.length)} results:\n`);
+    const kindIcons = {
+        function: 'ƒ',
+        arrow_function: '→',
+        class: '◆',
+        interface: '◇',
+        type: 'τ',
+        enum: '∈',
+        const: '●',
+        component: '⬡',
+        hook: '⚓',
+    };
+    for (const result of results) {
+        const icon = kindIcons[result.kind] ?? '○';
+        const exported = result.exported ? chalk.green('exported') : chalk.gray('internal');
+        console.log(`  ${icon} ${chalk.white(result.name)} ${chalk.gray(`(${result.kind})`)} [${exported}]`);
+        console.log(`    ${chalk.gray(result.file)}:${result.line}`);
+    }
+});
+wikiCmd
+    .command('deps <file>')
+    .description('Show dependencies for a file')
+    .option('-d, --direction <dir>', 'Direction: incoming, outgoing, both', 'both')
+    .option('-s, --system <system>', 'System identifier')
+    .action(async (file, options) => {
+    ui.header(`Dependencies: ${file}`);
+    const projectRoot = await getProjectRoot();
+    let system = options.system;
+    if (!system) {
+        try {
+            const config = await loadConfig(projectRoot);
+            system = config.system;
+        }
+        catch {
+            system = 'UNKNOWN';
+        }
+    }
+    const { query: tursoQuery } = await import('../db/turso-client.js');
+    const deps = await tursoQuery({
+        type: 'code_dependency',
+        system,
+        limit: 500,
+    });
+    const incoming = [];
+    const outgoing = [];
+    for (const dep of deps) {
+        try {
+            const content = dep.content;
+            if (content.sourceFile.includes(file)) {
+                outgoing.push({
+                    to: content.targetFile,
+                    symbols: content.symbols ?? [],
+                    external: content.isExternal,
+                });
+            }
+            if (content.targetFile.includes(file)) {
+                incoming.push({
+                    from: content.sourceFile,
+                    symbols: content.symbols ?? [],
+                });
+            }
+        }
+        catch {
+            // Skip malformed records
+        }
+    }
+    if (options.direction !== 'outgoing' && incoming.length > 0) {
+        ui.subheader(`Incoming Dependencies (${incoming.length})`);
+        for (const dep of incoming.slice(0, 20)) {
+            console.log(`  ← ${chalk.gray(dep.from)}`);
+            if (dep.symbols.length > 0) {
+                console.log(`    imports: ${chalk.cyan(dep.symbols.join(', '))}`);
+            }
+        }
+        if (incoming.length > 20) {
+            console.log(chalk.gray(`  ... and ${incoming.length - 20} more`));
+        }
+    }
+    if (options.direction !== 'incoming' && outgoing.length > 0) {
+        console.log('');
+        ui.subheader(`Outgoing Dependencies (${outgoing.length})`);
+        for (const dep of outgoing.slice(0, 20)) {
+            const icon = dep.external ? chalk.yellow('📦') : '→';
+            console.log(`  ${icon} ${chalk.gray(dep.to)}`);
+            if (dep.symbols.length > 0) {
+                console.log(`    uses: ${chalk.cyan(dep.symbols.join(', '))}`);
+            }
+        }
+        if (outgoing.length > 20) {
+            console.log(chalk.gray(`  ... and ${outgoing.length - 20} more`));
+        }
+    }
+    if (incoming.length === 0 && outgoing.length === 0) {
+        console.log(chalk.yellow('  No dependencies found for this file'));
+        console.log(chalk.gray('  Run: cmp-standards wiki index'));
+    }
+});
+wikiCmd
+    .command('symbols <file>')
+    .description('List all symbols in a file')
+    .option('-s, --system <system>', 'System identifier')
+    .action(async (file, options) => {
+    ui.header(`Symbols: ${file}`);
+    const projectRoot = await getProjectRoot();
+    let system = options.system;
+    if (!system) {
+        try {
+            const config = await loadConfig(projectRoot);
+            system = config.system;
+        }
+        catch {
+            system = 'UNKNOWN';
+        }
+    }
+    const { query: tursoQuery } = await import('../db/turso-client.js');
+    const structures = await tursoQuery({
+        type: 'code_structure',
+        system,
+        limit: 100,
+    });
+    for (const struct of structures) {
+        try {
+            const content = struct.content;
+            if (!content.filePath.includes(file))
+                continue;
+            // Found the file
+            console.log(`  File: ${chalk.cyan(content.filePath)}`);
+            console.log(`  Framework: ${content.framework ?? 'none'}`);
+            console.log(`  Component: ${content.isComponent ? 'Yes' : 'No'}`);
+            console.log(`  Test: ${content.isTest ? 'Yes' : 'No'}`);
+            console.log('');
+            // Imports
+            const imports = content.imports ?? [];
+            if (imports.length > 0) {
+                ui.subheader(`Imports (${imports.length})`);
+                for (const imp of imports) {
+                    const icon = imp.isExternal ? chalk.yellow('📦') : '📁';
+                    const names = imp.names?.map((n) => n.alias ? `${n.name} as ${n.alias}` : n.name).join(', ') ?? '';
+                    console.log(`  ${icon} ${chalk.gray(imp.source)}`);
+                    if (names) {
+                        console.log(`    ${chalk.cyan(names)}`);
+                    }
+                }
+                console.log('');
+            }
+            // Exports
+            const exports = content.exports ?? [];
+            if (exports.length > 0) {
+                ui.subheader(`Exports (${exports.length})`);
+                for (const exp of exports) {
+                    const defaultMark = exp.isDefault ? chalk.green('default') : '';
+                    console.log(`  ↗ ${chalk.white(exp.name)} ${defaultMark}`);
+                }
+                console.log('');
+            }
+            // Symbols
+            const symbols = content.symbols ?? [];
+            if (symbols.length > 0) {
+                ui.subheader(`Symbols (${symbols.length})`);
+                const kindIcons = {
+                    function: 'ƒ',
+                    arrow_function: '→',
+                    class: '◆',
+                    interface: '◇',
+                    type: 'τ',
+                    enum: '∈',
+                    const: '●',
+                    component: '⬡',
+                    hook: '⚓',
+                };
+                for (const symbol of symbols) {
+                    const icon = kindIcons[symbol.kind] ?? '○';
+                    const exported = symbol.isExported ? chalk.green('↗') : ' ';
+                    const async = symbol.isAsync ? chalk.gray('async') : '';
+                    console.log(`  ${icon}${exported} ${chalk.white(symbol.name)} ${chalk.gray(`(${symbol.kind})`)} ${async}`);
+                    console.log(`    line ${symbol.lineStart}${symbol.lineEnd !== symbol.lineStart ? `-${symbol.lineEnd}` : ''}`);
+                }
+            }
+            return;
+        }
+        catch {
+            // Skip malformed records
+        }
+    }
+    console.log(chalk.yellow(`  File not found in index: ${file}`));
+    console.log(chalk.gray('  Run: cmp-standards wiki index'));
+});
+// =============================================================================
 // COMPLETION COMMAND
 // =============================================================================
 program
@@ -1407,7 +1894,7 @@ program
         'init', 'sync', 'validate', 'verify-hooks', 'generate', 'scan', 'improve',
         'status', 'dashboard', 'mcp', 'analytics', 'cross-analytics', 'feedback',
         'tasks', 'ideas', 'improvements', 'plan', 'capture', 'export',
-        'cloud', 'quickstart', 'doctor', 'completion'
+        'cloud', 'quickstart', 'doctor', 'opportunities', 'completion'
     ];
     const subcommands = {
         cloud: ['status', 'init', 'improvements', 'tasks', 'session']