projscan 0.11.0 → 0.12.0

package/dist/cli/index.js

@@ -1,1419 +1,48 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
-import ora from 'ora';
-import chalk from 'chalk';
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import readline from 'node:readline';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pkg = JSON.parse(readFileSync(path.resolve(__dirname, '../../package.json'), 'utf-8'));
-import { scanRepository } from '../core/repositoryScanner.js';
-import { detectLanguages } from '../core/languageDetector.js';
-import { detectFrameworks } from '../core/frameworkDetector.js';
-import { analyzeDependencies } from '../core/dependencyAnalyzer.js';
-import { collectIssues } from '../core/issueEngine.js';
-import { analyzeHotspots } from '../core/hotspotAnalyzer.js';
-import { detectOutdated } from '../core/outdatedDetector.js';
-import { runAudit, auditFindingsToIssues } from '../core/auditRunner.js';
-import { previewUpgrade } from '../core/upgradePreview.js';
-import { parseCoverage, coverageMap } from '../core/coverageParser.js';
-import { joinCoverageWithHotspots } from '../core/coverageJoin.js';
-import { buildCodeGraph } from '../core/codeGraph.js';
-import { loadCachedGraph, saveCachedGraph } from '../core/indexCache.js';
-import { computeCoupling, filterCoupling } from '../core/couplingAnalyzer.js';
-import { computePrDiff } from '../core/prDiff.js';
-import { detectWorkspaces, filterFilesByPackage } from '../core/monorepo.js';
-import { describeTelemetryConfig, aggregateTelemetry } from '../core/telemetry.js';
-import { buildSearchIndex, search as searchIndex, attachExcerpts, expandQuery } from '../core/searchIndex.js';
-import { buildSemanticIndex, semanticSearch, reciprocalRankFusion, } from '../core/semanticSearch.js';
-import { isSemanticAvailable } from '../core/embeddings.js';
-import { inspectFile, extractImports, extractExports, inferPurpose, detectFileIssues, } from '../core/fileInspector.js';
-import { getAllAvailableFixes } from '../fixes/fixRegistry.js';
-import { setLogLevel } from '../utils/logger.js';
-import { calculateScore, badgeUrl, badgeMarkdown } from '../utils/scoreCalculator.js';
-import { showBanner, showCompactBanner, showHelp } from '../utils/banner.js';
-import { saveBaseline, loadBaseline, computeDiff } from '../utils/baseline.js';
-import { loadConfig, applyConfigToIssues } from '../utils/config.js';
-import { getChangedFiles } from '../utils/changedFiles.js';
-import { runMcpServer } from '../mcp/server.js';
-import { reportAnalysis, reportHealth, reportCi, reportDiff, reportDetectedIssues, reportExplanation, reportDiagram, reportStructure, reportDependencies, reportHotspots, reportFileInspection, reportOutdated, reportAudit, reportUpgrade, reportCoverage, reportCoupling, reportPrDiff, reportWorkspaces, } from '../reporters/consoleReporter.js';
-import { reportAnalysisJson, reportHealthJson, reportCiJson, reportDiffJson, reportExplanationJson, reportDiagramJson, reportStructureJson, reportDependenciesJson, reportHotspotsJson, reportFileJson, reportOutdatedJson, reportAuditJson, reportUpgradeJson, reportCoverageJson, reportCouplingJson, reportPrDiffJson, reportWorkspacesJson, } from '../reporters/jsonReporter.js';
-import { reportAnalysisMarkdown, reportHealthMarkdown, reportCiMarkdown, reportDiffMarkdown, reportExplanationMarkdown, reportDiagramMarkdown, reportStructureMarkdown, reportDependenciesMarkdown, reportHotspotsMarkdown, reportFileMarkdown, reportOutdatedMarkdown, reportAuditMarkdown, reportUpgradeMarkdown, reportCoverageMarkdown, reportCouplingMarkdown, reportPrDiffMarkdown, reportWorkspacesMarkdown, } from '../reporters/markdownReporter.js';
-import { reportAnalysisSarif, reportHealthSarif, reportCiSarif, issuesToSarif, } from '../reporters/sarifReporter.js';
-// ── CLI Setup ─────────────────────────────────────────────
-const program = new Command();
-program
-    .name('projscan')
-    .description('Instant codebase insights - doctor, x-ray, and architecture map for any repository')
-    .version(pkg.version)
-    .option('--format <type>', 'output format: console, json, markdown, sarif', 'console')
-    .option('--config <path>', 'path to .projscanrc config file')
-    .option('--verbose', 'enable verbose output')
-    .option('--quiet', 'suppress non-essential output');
-function getFormat() {
-    const opts = program.opts();
-    const f = opts.format;
-    if (f === 'json' || f === 'markdown' || f === 'sarif')
-        return f;
-    return 'console';
-}
-function getRootPath() {
-    return process.cwd();
-}
-async function loadProjectConfig() {
-    const opts = program.opts();
-    const explicit = typeof opts.config === 'string' ? opts.config : undefined;
-    try {
-        const { config, source } = await loadConfig(getRootPath(), explicit);
-        if (source && !opts.quiet && getFormat() === 'console') {
-            console.error(chalk.dim(`  [config: ${path.relative(getRootPath(), source) || source}]`));
-        }
-        return config;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        console.error(chalk.red(`  Config error: ${msg}`));
-        process.exit(1);
-    }
-}
-async function filterIssuesByChangedFiles(issues, rootPath, baseRef) {
-    const result = await getChangedFiles(rootPath, baseRef);
-    if (!result.available) {
-        if (getFormat() === 'console' && !program.opts().quiet) {
-            console.error(chalk.yellow(`  [--changed-only: ${result.reason ?? 'unavailable'} - reporting all issues]`));
-        }
-        return issues;
-    }
-    if (getFormat() === 'console' && !program.opts().quiet) {
-        console.error(chalk.dim(`  [--changed-only: base=${result.baseRef}, ${result.files.length} file(s)]`));
-    }
-    const set = new Set(result.files);
-    const filtered = issues.filter((issue) => {
-        if (!issue.locations || issue.locations.length === 0)
-            return false;
-        return issue.locations.some((loc) => set.has(loc.file));
-    });
-    const dropped = issues.length - filtered.length;
-    if (dropped > 0 && !program.opts().quiet) {
-        const unlocated = issues.filter((i) => !i.locations || i.locations.length === 0).length;
-        const message = unlocated > 0
-            ? `  [--changed-only: ${dropped} issue(s) filtered out; ${unlocated} had no file location]`
-            : `  [--changed-only: ${dropped} issue(s) outside the changed-file set]`;
-        if (getFormat() === 'console') {
-            console.error(chalk.dim(message));
-        }
-        else {
-            // For non-console formats, still emit to stderr so the count is visible
-            // without corrupting machine-readable stdout.
-            console.error(message.trim());
-        }
-    }
-    return filtered;
-}
-function setupLogLevel() {
-    const opts = program.opts();
-    if (opts.verbose)
-        setLogLevel('debug');
-    else if (opts.quiet)
-        setLogLevel('quiet');
-}
-function maybeBanner() {
-    const opts = program.opts();
-    if (!opts.quiet && getFormat() === 'console') {
-        try {
-            showBanner();
-        }
-        catch (err) {
-            console.error(chalk.dim(`  [banner error: ${err instanceof Error ? err.message : String(err)}]`));
-        }
-    }
-}
-function maybeCompactBanner() {
-    const opts = program.opts();
-    if (!opts.quiet && getFormat() === 'console') {
-        try {
-            showCompactBanner();
-        }
-        catch (err) {
-            console.error(chalk.dim(`  [banner error: ${err instanceof Error ? err.message : String(err)}]`));
-        }
-    }
-}
-/** Walk a DirectoryNode to find the node whose `path` matches targetPath. */
-function sliceCliTree(node, targetPath) {
-    if (node.path === targetPath)
-        return node;
-    for (const child of node.children) {
-        const hit = sliceCliTree(child, targetPath);
-        if (hit)
-            return hit;
-    }
-    return null;
-}
-// ── Command: analyze (default) ────────────────────────────
-program
-    .command('analyze', { isDefault: true })
-    .description('Analyze repository and show project report')
-    .option('--changed-only', 'only report issues on files changed vs base ref')
-    .option('--base-ref <ref>', 'git base ref for --changed-only (default: origin/main)')
-    .option('--package <name>', 'monorepo: scope issues to a single workspace package')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora('Scanning repository...').start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        if (spinner)
-            spinner.text = 'Detecting languages...';
-        const languages = detectLanguages(scan.files);
-        if (spinner)
-            spinner.text = 'Detecting frameworks...';
-        const frameworks = await detectFrameworks(rootPath, scan.files);
-        if (spinner)
-            spinner.text = 'Analyzing dependencies...';
-        const dependencies = await analyzeDependencies(rootPath);
-        if (spinner)
-            spinner.text = 'Checking for issues...';
-        let issues = await collectIssues(rootPath, scan.files);
-        issues = applyConfigToIssues(issues, config);
-        if (cmdOpts.changedOnly) {
-            issues = await filterIssuesByChangedFiles(issues, rootPath, cmdOpts.baseRef ?? config.baseRef);
-        }
-        if (cmdOpts.package) {
-            const ws = await detectWorkspaces(rootPath);
-            const allowed = new Set(filterFilesByPackage(ws, cmdOpts.package, scan.files.map((f) => f.relativePath)));
-            issues = issues.filter((i) => (i.locations ?? []).some((l) => l.file && allowed.has(l.file)));
-        }
-        if (spinner)
-            spinner.stop();
-        const report = {
-            projectName: path.basename(rootPath),
-            rootPath,
-            scan,
-            languages,
-            frameworks,
-            dependencies,
-            issues,
-            timestamp: new Date().toISOString(),
-        };
-        switch (format) {
-            case 'json':
-                reportAnalysisJson(report);
-                break;
-            case 'markdown':
-                reportAnalysisMarkdown(report);
-                break;
-            case 'sarif':
-                reportAnalysisSarif(issues, pkg.version);
-                break;
-            default:
-                reportAnalysis(report);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Analysis failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: doctor ───────────────────────────────────────
-program
-    .command('doctor')
-    .description('Evaluate project health and detect issues')
-    .option('--changed-only', 'only report issues on files changed vs base ref')
-    .option('--base-ref <ref>', 'git base ref for --changed-only (default: origin/main)')
-    .option('--package <name>', 'monorepo: scope issues to a single workspace package')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora('Running health checks...').start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        let issues = await collectIssues(rootPath, scan.files);
-        issues = applyConfigToIssues(issues, config);
-        if (cmdOpts.changedOnly) {
-            issues = await filterIssuesByChangedFiles(issues, rootPath, cmdOpts.baseRef ?? config.baseRef);
-        }
-        if (cmdOpts.package) {
-            const ws = await detectWorkspaces(rootPath);
-            const allowed = new Set(filterFilesByPackage(ws, cmdOpts.package, scan.files.map((f) => f.relativePath)));
-            issues = issues.filter((i) => (i.locations ?? []).some((l) => l.file && allowed.has(l.file)));
-        }
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportHealthJson(issues);
-                break;
-            case 'markdown':
-                reportHealthMarkdown(issues);
-                break;
-            case 'sarif':
-                reportHealthSarif(issues, pkg.version);
-                break;
-            default:
-                reportHealth(issues, scan.scanDurationMs);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Health check failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: ci ──────────────────────────────────────────
-program
-    .command('ci')
-    .description('Run health check for CI pipelines (exits 1 if score below threshold)')
-    .option('--min-score <score>', 'minimum passing score (0-100)')
-    .option('--changed-only', 'gate only on issues in files changed vs base ref')
-    .option('--base-ref <ref>', 'git base ref for --changed-only (default: origin/main)')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        let issues = await collectIssues(rootPath, scan.files);
-        issues = applyConfigToIssues(issues, config);
-        if (cmdOpts.changedOnly) {
-            issues = await filterIssuesByChangedFiles(issues, rootPath, cmdOpts.baseRef ?? config.baseRef);
-        }
-        const rawThreshold = cmdOpts.minScore ?? config.minScore ?? 70;
-        const threshold = Math.max(0, Math.min(100, typeof rawThreshold === 'string' ? parseInt(rawThreshold, 10) || 70 : rawThreshold));
-        const { score } = calculateScore(issues);
-        switch (format) {
-            case 'json':
-                reportCiJson(issues, threshold);
-                break;
-            case 'markdown':
-                reportCiMarkdown(issues, threshold);
-                break;
-            case 'sarif':
-                reportCiSarif(issues, pkg.version);
-                break;
-            default:
-                reportCi(issues, threshold);
-        }
-        if (score < threshold) {
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: diff ─────────────────────────────────────────
-program
-    .command('diff')
-    .description('Compare health against a saved baseline')
-    .option('--save-baseline', 'save current health as the baseline')
-    .option('--baseline <path>', 'path to baseline file (default: .projscan-baseline.json)')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        let issues = await collectIssues(rootPath, scan.files);
-        issues = applyConfigToIssues(issues, config);
-        const hotspotReport = await analyzeHotspots(rootPath, scan.files, issues, { limit: 20 });
-        if (cmdOpts.saveBaseline) {
-            const filePath = await saveBaseline(rootPath, issues, hotspotReport);
-            const { score, grade } = calculateScore(issues);
-            console.log(chalk.green(`\n  Baseline saved to ${filePath}`));
-            console.log(`  Score: ${chalk.bold(`${grade} (${score}/100)`)}`);
-            console.log(`  Issues: ${issues.length}`);
-            if (hotspotReport.available) {
-                console.log(`  Hotspots snapshotted: ${hotspotReport.hotspots.length}\n`);
-            }
-            else {
-                console.log('');
-            }
-            return;
-        }
-        let baseline;
-        try {
-            baseline = await loadBaseline(cmdOpts.baseline, rootPath);
-        }
-        catch {
-            console.error(chalk.yellow('\n  No baseline found.'));
-            console.error(`  Run ${chalk.bold.cyan('projscan diff --save-baseline')} first to create one.\n`);
-            process.exit(1);
-        }
-        const diff = computeDiff(baseline, issues, hotspotReport);
-        switch (format) {
-            case 'json':
-                reportDiffJson(diff);
-                break;
-            case 'markdown':
-                reportDiffMarkdown(diff);
-                break;
-            default:
-                reportDiff(diff);
-        }
-    }
-    catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: fix ──────────────────────────────────────────
-program
-    .command('fix')
-    .description('Auto-fix detected project issues')
-    .option('-y, --yes', 'apply fixes without prompting')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const spinner = ora('Detecting issues...').start();
-    const config = await loadProjectConfig();
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        let issues = await collectIssues(rootPath, scan.files);
-        issues = applyConfigToIssues(issues, config);
-        const fixes = getAllAvailableFixes(issues);
-        spinner.stop();
-        if (fixes.length === 0) {
-            console.log(`\n  ${chalk.green('✓')} ${chalk.bold('No fixable issues found!')}\n`);
-            return;
-        }
-        reportDetectedIssues(issues, fixes);
-        // Prompt for confirmation
-        if (!cmdOpts.yes) {
-            const proceed = await promptYesNo(`  Apply ${fixes.length} fix${fixes.length > 1 ? 'es' : ''}? (y/n) `);
-            if (!proceed) {
-                console.log(chalk.dim('\n  Aborted.\n'));
-                return;
-            }
-        }
-        // Apply fixes
-        const results = [];
-        for (const fix of fixes) {
-            const fixSpinner = ora(`  Applying: ${fix.title}...`).start();
-            try {
-                await fix.apply(rootPath);
-                fixSpinner.succeed(`  ${fix.title}`);
-                results.push({ fix, success: true });
-            }
-            catch (error) {
-                const msg = error instanceof Error ? error.message : String(error);
-                fixSpinner.fail(`  ${fix.title}`);
-                results.push({ fix, success: false, error: msg });
-            }
-        }
-        const succeeded = results.filter((r) => r.success).length;
-        const failed = results.filter((r) => !r.success).length;
-        console.log('');
-        if (succeeded > 0) {
-            console.log(`  ${chalk.green('✓')} ${succeeded} fix${succeeded > 1 ? 'es' : ''} applied successfully`);
-        }
-        if (failed > 0) {
-            console.log(`  ${chalk.red('✗')} ${failed} fix${failed > 1 ? 'es' : ''} failed`);
-        }
-        console.log('');
-    }
-    catch (error) {
-        spinner.fail('Fix detection failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: file ─────────────────────────────────────────
-program
-    .command('file <file>')
-    .description('Drill into a file - purpose, risk, ownership, related issues')
-    .action(async (filePath) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const spinner = format === 'console' ? ora('Inspecting file...').start() : null;
-    try {
-        const inspection = await inspectFile(rootPath, filePath);
-        if (spinner)
-            spinner.stop();
-        if (!inspection.exists) {
-            console.error(chalk.red(`\n  ${inspection.reason ?? 'File unavailable'}: ${filePath}\n`));
-            process.exit(1);
-        }
-        switch (format) {
-            case 'json':
-                reportFileJson(inspection);
-                break;
-            case 'markdown':
-                reportFileMarkdown(inspection);
-                break;
-            default:
-                reportFileInspection(inspection);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('File inspection failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: explain ──────────────────────────────────────
-program
-    .command('explain <file>')
-    .description('Explain a file - its purpose, dependencies, and exports')
-    .action(async (filePath) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const format = getFormat();
-    const absolutePath = path.resolve(filePath);
-    try {
-        const content = await fs.readFile(absolutePath, 'utf-8');
-        const explanation = analyzeFile(absolutePath, content);
-        switch (format) {
-            case 'json':
-                reportExplanationJson(explanation);
-                break;
-            case 'markdown':
-                reportExplanationMarkdown(explanation);
-                break;
-            default:
-                reportExplanation(explanation);
-        }
-    }
-    catch (error) {
-        if (error.code === 'ENOENT') {
-            console.error(chalk.red(`File not found: ${filePath}`));
-        }
-        else {
-            console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        }
-        process.exit(1);
-    }
-});
-// ── Command: diagram ──────────────────────────────────────
-program
-    .command('diagram')
-    .description('Generate architecture overview diagram')
-    .action(async () => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora('Analyzing architecture...').start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        const frameworks = await detectFrameworks(rootPath, scan.files);
-        const layers = buildArchitectureLayers(scan.files, frameworks.frameworks.map((f) => f.name));
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportDiagramJson(layers);
-                break;
-            case 'markdown':
-                reportDiagramMarkdown(layers);
-                break;
-            default:
-                reportDiagram(layers);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Diagram generation failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: structure ────────────────────────────────────
-program
-    .command('structure')
-    .description('Show project directory structure')
-    .option('--package <name>', 'monorepo: scope tree to a single workspace package')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora('Scanning...').start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        let tree = scan.directoryTree;
-        let title = path.basename(rootPath);
-        if (cmdOpts.package) {
-            const ws = await detectWorkspaces(rootPath);
-            const pkg = ws.packages.find((p) => p.name === cmdOpts.package);
-            if (pkg && !pkg.isRoot && pkg.relativePath) {
-                const sliced = sliceCliTree(tree, pkg.relativePath);
-                if (sliced) {
-                    tree = sliced;
-                    title = pkg.name;
-                }
-            }
-        }
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportStructureJson(tree);
-                break;
-            case 'markdown':
-                reportStructureMarkdown(tree);
-                break;
-            default:
-                reportStructure(tree, title);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Structure scan failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: dependencies ─────────────────────────────────
-program
-    .command('dependencies')
-    .description('Analyze project dependencies')
-    .action(async () => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const spinner = format === 'console' ? ora('Analyzing dependencies...').start() : null;
-    try {
-        const report = await analyzeDependencies(rootPath);
-        if (spinner)
-            spinner.stop();
-        if (!report) {
-            console.log(chalk.yellow('\n  No package.json found in this directory.\n'));
-            return;
-        }
-        switch (format) {
-            case 'json':
-                reportDependenciesJson(report);
-                break;
-            case 'markdown':
-                reportDependenciesMarkdown(report);
-                break;
-            default:
-                reportDependencies(report);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Dependency analysis failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: hotspots ─────────────────────────────────────
-program
-    .command('hotspots')
-    .description('Rank files by risk (git churn × AST cyclomatic complexity × open issues)')
-    .option('--limit <n>', 'number of hotspots to show')
-    .option('--since <when>', 'git history window (e.g. "6 months ago", "2024-01-01")')
-    .option('--package <name>', 'monorepo: scope to a single workspace package')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora('Analyzing hotspots...').start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        let issues = await collectIssues(rootPath, scan.files);
-        issues = applyConfigToIssues(issues, config);
-        const limitRaw = cmdOpts.limit ?? config.hotspots?.limit ?? 10;
-        const limit = Math.max(1, Math.min(100, typeof limitRaw === 'string' ? parseInt(limitRaw, 10) || 10 : limitRaw));
-        const since = cmdOpts.since ?? config.hotspots?.since ?? '12 months ago';
-        const coverageReport = await parseCoverage(rootPath);
-        // Build the code graph so the risk score uses AST cyclomatic complexity
-        // instead of LOC. Cache hit makes this nearly free on repeat runs.
-        const cached = await loadCachedGraph(rootPath);
-        const graph = await buildCodeGraph(rootPath, scan.files, cached);
-        await saveCachedGraph(rootPath, graph);
-        const report = await analyzeHotspots(rootPath, scan.files, issues, {
-            since,
-            limit,
-            coverage: coverageReport.available ? coverageMap(coverageReport) : undefined,
-            graph,
-        });
-        if (cmdOpts.package) {
-            const ws = await detectWorkspaces(rootPath);
-            const allowed = new Set(filterFilesByPackage(ws, cmdOpts.package, report.hotspots.map((h) => h.relativePath)));
-            report.hotspots = report.hotspots.filter((h) => allowed.has(h.relativePath));
-        }
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportHotspotsJson(report);
-                break;
-            case 'markdown':
-                reportHotspotsMarkdown(report);
-                break;
-            default:
-                reportHotspots(report);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Hotspot analysis failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: coupling ─────────────────────────────────────
-program
-    .command('coupling')
-    .description('Per-file fan-in / fan-out / instability and circular-import cycles (AST-derived)')
-    .option('--limit <n>', 'number of files to show (default 25)')
-    .option('--cycles-only', 'only show files participating in import cycles')
-    .option('--high-fan-in', 'sort by fan-in (most-depended-on first)')
-    .option('--high-fan-out', 'sort by fan-out (most-coupled first)')
-    .option('--file <path>', 'restrict output to a single file')
-    .option('--package <name>', 'monorepo: scope to a single workspace package')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora('Computing coupling + cycles...').start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        const cached = await loadCachedGraph(rootPath);
-        const graph = await buildCodeGraph(rootPath, scan.files, cached);
-        await saveCachedGraph(rootPath, graph);
-        const ws = await detectWorkspaces(rootPath);
-        const report = computeCoupling(graph, ws);
-        const direction = cmdOpts.cyclesOnly
-            ? 'cycles_only'
-            : cmdOpts.highFanIn
-                ? 'high_fan_in'
-                : cmdOpts.highFanOut
-                    ? 'high_fan_out'
-                    : 'all';
-        const limitRaw = cmdOpts.limit ?? 25;
-        const limit = Math.max(1, Math.min(500, typeof limitRaw === 'string' ? parseInt(limitRaw, 10) || 25 : limitRaw));
-        let files = filterCoupling(report, direction);
-        if (cmdOpts.file)
-            files = files.filter((f) => f.relativePath === cmdOpts.file);
-        if (cmdOpts.package) {
-            const ws = await detectWorkspaces(rootPath);
-            const allowed = new Set(filterFilesByPackage(ws, cmdOpts.package, files.map((f) => f.relativePath)));
-            files = files.filter((f) => allowed.has(f.relativePath));
-        }
-        files = files.slice(0, limit);
-        const filtered = {
-            files,
-            cycles: report.cycles,
-            crossPackageEdges: report.crossPackageEdges,
-            totalFiles: report.totalFiles,
-            totalCycles: report.totalCycles,
-            totalCrossPackageEdges: report.totalCrossPackageEdges,
-        };
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportCouplingJson(filtered);
-                break;
-            case 'markdown':
-                reportCouplingMarkdown(filtered);
-                break;
-            default:
-                reportCoupling(filtered);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Coupling analysis failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: pr-diff ──────────────────────────────────────
-program
-    .command('pr-diff')
-    .description('Structural (AST) diff between two refs - what changed in exports, imports, calls, CC, fan-in')
-    .option('--base <ref>', 'base ref (default: origin/main, falling back to main/master/HEAD~1)')
-    .option('--head <ref>', 'head ref (default: HEAD)')
-    .option('--package <name>', 'monorepo: scope diff to a single workspace package')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const spinner = format === 'console' ? ora('Computing structural PR diff...').start() : null;
-    try {
-        const report = await computePrDiff(rootPath, { base: cmdOpts.base, head: cmdOpts.head });
-        if (cmdOpts.package) {
-            const ws = await detectWorkspaces(rootPath);
-            const collected = [
-                ...report.filesAdded,
-                ...report.filesRemoved,
-                ...report.filesModified.map((f) => f.relativePath),
-            ];
-            const allowed = new Set(filterFilesByPackage(ws, cmdOpts.package, collected));
-            report.filesAdded = report.filesAdded.filter((f) => allowed.has(f));
-            report.filesRemoved = report.filesRemoved.filter((f) => allowed.has(f));
-            report.filesModified = report.filesModified.filter((f) => allowed.has(f.relativePath));
-            report.totalFilesChanged =
-                report.filesAdded.length + report.filesRemoved.length + report.filesModified.length;
-        }
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportPrDiffJson(report);
-                break;
-            case 'markdown':
-                reportPrDiffMarkdown(report);
-                break;
-            default:
-                reportPrDiff(report);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('PR diff failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: workspaces ───────────────────────────────────
-program
-    .command('workspaces')
-    .description('List monorepo workspace packages (npm/yarn workspaces, pnpm-workspace.yaml, Nx/Turbo/Lerna fallback)')
-    .action(async () => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    try {
-        const info = await detectWorkspaces(rootPath);
-        switch (format) {
-            case 'json':
-                reportWorkspacesJson(info);
-                break;
-            case 'markdown':
-                reportWorkspacesMarkdown(info);
-                break;
-            default:
-                reportWorkspaces(info);
-        }
-    }
-    catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: telemetry ────────────────────────────────────
-program
-    .command('telemetry')
-    .description('Inspect projscan opt-in telemetry: config state, or per-tool histograms with --aggregate')
-    .option('--aggregate', 'read the local sink and print per-tool latency histograms (count, p50/p95/p99, error rate)')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    try {
-        const { config } = await loadConfig(rootPath);
-        const out = cmdOpts.aggregate
-            ? await aggregateTelemetry(config.telemetry)
-            : describeTelemetryConfig(config.telemetry);
-        if (format === 'json') {
-            console.log(JSON.stringify(out, null, 2));
-            return;
-        }
-        // Console: hand-formatted summary so users don't have to read raw JSON.
-        if (cmdOpts.aggregate) {
-            const agg = out;
-            if (!agg.available) {
-                console.log(chalk.yellow(`\n  ${agg.reason ?? 'No telemetry available.'}\n`));
-                return;
-            }
-            console.log(chalk.bold('\n  Telemetry histograms'));
-            console.log(chalk.dim(`  sink: ${agg.sink}`));
-            console.log(chalk.dim(`  ${agg.totalEvents} event(s) · ${agg.windowFrom ?? '?'} → ${agg.windowTo ?? '?'}\n`));
-            if (agg.byTool.length === 0) {
-                console.log(chalk.dim('  (no events recorded yet)\n'));
-                return;
-            }
-            const colHead = `    ${'count'.padStart(6)}  ${'err%'.padStart(5)}  ${'p50'.padStart(6)}  ${'p95'.padStart(6)}  ${'p99'.padStart(6)}  tool`;
-            console.log(chalk.dim(colHead));
-            for (const t of agg.byTool) {
-                const errPct = (t.errorRate * 100).toFixed(1) + '%';
-                console.log(`    ${String(t.count).padStart(6)}  ${errPct.padStart(5)}  ${(t.p50Ms ?? 0).toString().padStart(6)}  ${(t.p95Ms ?? 0).toString().padStart(6)}  ${(t.p99Ms ?? 0).toString().padStart(6)}  ${chalk.cyan(t.tool)}`);
-            }
-            console.log('');
-        }
-        else {
-            const cfg = out;
-            console.log(chalk.bold('\n  Telemetry'));
-            console.log(`    enabled: ${cfg.enabled ? chalk.green('yes') : chalk.dim('no (default)')}`);
-            console.log(`    sink:    ${cfg.sink}`);
-            console.log(`    default: ${cfg.defaultSink}`);
-            console.log(`    PROJSCAN_TELEMETRY env: ${cfg.envOverride ?? chalk.dim('(unset)')}`);
-            console.log(chalk.dim('\n    Records: tool, durationMs, ok, version, ts. Never source/paths/args.'));
-            console.log(chalk.dim('    Re-run with --aggregate to see histograms over the recorded events.\n'));
-        }
-    }
-    catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: outdated ─────────────────────────────────────
-program
-    .command('outdated')
-    .description('Detect outdated dependencies (offline - compares declared vs installed)')
-    .action(async () => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const spinner = format === 'console' ? ora('Checking dependencies...').start() : null;
-    try {
-        const report = await detectOutdated(rootPath);
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportOutdatedJson(report);
-                break;
-            case 'markdown':
-                reportOutdatedMarkdown(report);
-                break;
-            case 'sarif':
-                console.log(JSON.stringify(issuesToSarif([], pkg.version), null, 2));
-                break;
-            default:
-                reportOutdated(report);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Outdated check failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: audit ────────────────────────────────────────
-program
-    .command('audit')
-    .description('Run npm audit and surface vulnerabilities (SARIF supported)')
-    .option('--timeout <ms>', 'override npm audit timeout (default 60000)')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const spinner = format === 'console' ? ora('Running npm audit...').start() : null;
-    try {
-        const timeoutMs = cmdOpts.timeout ? Math.max(5_000, parseInt(cmdOpts.timeout, 10)) : undefined;
-        const report = await runAudit(rootPath, timeoutMs !== undefined ? { timeoutMs } : {});
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportAuditJson(report);
-                break;
-            case 'markdown':
-                reportAuditMarkdown(report);
-                break;
-            case 'sarif':
-                console.log(JSON.stringify(issuesToSarif(auditFindingsToIssues(report), pkg.version), null, 2));
-                break;
-            default:
-                reportAudit(report);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Audit failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: upgrade ──────────────────────────────────────
-program
-    .command('upgrade <package>')
-    .description('Preview the impact of upgrading a package (offline - reads local CHANGELOG + importers)')
-    .action(async (pkgName) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora(`Previewing ${pkgName}...`).start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        const preview = await previewUpgrade(rootPath, pkgName, scan.files);
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportUpgradeJson(preview);
-                break;
-            case 'markdown':
-                reportUpgradeMarkdown(preview);
-                break;
-            default:
-                reportUpgrade(preview);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Upgrade preview failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: search ───────────────────────────────────────
-program
-    .command('search <query...>')
-    .description('Ranked search - BM25 by default, semantic or hybrid when @xenova/transformers peer is installed')
-    .option('--scope <scope>', 'auto | content | symbols | files', 'auto')
-    .option('--mode <mode>', 'lexical | semantic | hybrid (content/auto scope only)', 'lexical')
-    .option('--semantic', 'shortcut for --mode semantic')
-    .option('--limit <n>', 'max results', '15')
-    .option('--package <name>', 'monorepo: scope to a single workspace package')
-    .action(async (queryParts, cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const query = queryParts.join(' ').trim();
-    if (!query) {
-        console.error(chalk.red('\n  search requires a non-empty query\n'));
-        process.exit(1);
-    }
-    const limitRaw = cmdOpts.limit ?? 15;
-    const limit = Math.max(1, Math.min(200, typeof limitRaw === 'string' ? parseInt(limitRaw, 10) || 15 : limitRaw));
-    const scope = String(cmdOpts.scope ?? 'auto');
-    const spinner = format === 'console' ? ora('Indexing repository...').start() : null;
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        const cached = await loadCachedGraph(rootPath);
-        const graph = await buildCodeGraph(rootPath, scan.files, cached);
-        await saveCachedGraph(rootPath, graph);
-        // Build a (file -> bool) filter once if --package is set; reused below.
-        let passes = null;
-        if (cmdOpts.package) {
-            const ws = await detectWorkspaces(rootPath);
-            const pkg = ws.packages.find((p) => p.name === cmdOpts.package);
-            if (!pkg) {
-                passes = () => false;
-            }
-            else if (pkg.isRoot) {
-                passes = () => true;
-            }
-            else {
-                const prefix = pkg.relativePath + '/';
-                passes = (f) => f === pkg.relativePath || f.startsWith(prefix);
-            }
-        }
-        if (spinner)
-            spinner.text = 'Searching...';
-        let results;
-        if (scope === 'symbols') {
-            const q = query.toLowerCase();
-            const matches = [];
-            for (const [file, entry] of graph.files) {
-                if (passes && !passes(file))
-                    continue;
-                for (const exp of entry.exports) {
-                    if (exp.name.toLowerCase().includes(q)) {
-                        matches.push({ symbol: exp.name, kind: exp.kind, file, line: exp.line });
-                    }
-                }
-            }
-            matches.sort((a, b) => {
-                const aExact = a.symbol.toLowerCase() === q ? 0 : a.symbol.toLowerCase().startsWith(q) ? 1 : 2;
-                const bExact = b.symbol.toLowerCase() === q ? 0 : b.symbol.toLowerCase().startsWith(q) ? 1 : 2;
-                return aExact - bExact;
-            });
-            results = { scope, query, matches: matches.slice(0, limit), total: matches.length };
-        }
-        else if (scope === 'files') {
-            const q = query.toLowerCase();
-            const matches = scan.files
-                .filter((f) => f.relativePath.toLowerCase().includes(q))
-                .filter((f) => !passes || passes(f.relativePath))
-                .slice(0, limit)
-                .map((f) => ({ file: f.relativePath, sizeBytes: f.sizeBytes }));
-            results = { scope, query, matches, total: matches.length };
-        }
-        else {
-            const mode = cmdOpts.semantic ? 'semantic' : String(cmdOpts.mode ?? 'lexical');
-            const index = await buildSearchIndex(rootPath, scan.files, graph);
-            const lexicalHitsAll = searchIndex(index, query, { limit });
-            const lexicalHits = passes ? lexicalHitsAll.filter((h) => passes(h.file)) : lexicalHitsAll;
-            const tokens = expandQuery(query);
-            if (mode === 'lexical') {
-                const withExcerpts = await attachExcerpts(rootPath, lexicalHits, tokens);
-                results = {
-                    scope: scope === 'auto' ? 'content' : scope,
-                    mode: 'lexical',
-                    query,
-                    queryTokens: tokens,
-                    matches: withExcerpts,
-                    total: withExcerpts.length,
-                };
-            }
-            else {
-                const available = await isSemanticAvailable();
-                if (!available) {
-                    if (spinner)
-                        spinner.stop();
-                    console.error(chalk.red(`\n  Semantic search requires the optional peer @xenova/transformers.\n  Install it with: ${chalk.bold('npm install @xenova/transformers')}\n`));
-                    process.exit(1);
-                }
-                if (spinner)
-                    spinner.text = 'Building semantic index (first run may take ~10s + model download)...';
-                const semIndex = await buildSemanticIndex(rootPath, scan.files, {
-                    onFirstLoad: (m) => spinner?.text && (spinner.text = m),
-                    onProgress: (d, t) => {
-                        if (spinner)
-                            spinner.text = `Embedding files... ${d}/${t}`;
-                    },
-                });
-                if (!semIndex) {
-                    if (spinner)
-                        spinner.fail('Semantic index build failed');
-                    process.exit(1);
-                }
-                if (spinner)
-                    spinner.text = 'Searching...';
-                const semHitsAll = await semanticSearch(semIndex, query, { limit });
-                const semHits = passes ? semHitsAll.filter((h) => passes(h.file)) : semHitsAll;
-                if (mode === 'semantic') {
-                    const enriched = await attachExcerpts(rootPath, semHits.map((h) => ({
-                        file: h.file,
-                        score: h.score,
-                        matched: [],
-                        symbolMatch: false,
-                        pathMatch: false,
-                        excerpt: '',
-                        line: 0,
-                    })), tokens);
-                    results = {
-                        scope: scope === 'auto' ? 'content' : scope,
-                        mode: 'semantic',
-                        query,
-                        model: semIndex.model,
-                        matches: enriched,
-                        total: enriched.length,
-                    };
-                }
-                else {
-                    // hybrid
-                    const fused = reciprocalRankFusion([lexicalHits, semHits]).slice(0, limit);
-                    const enriched = await attachExcerpts(rootPath, fused.map((f) => ({
-                        file: f.file,
-                        score: f.score,
-                        matched: [],
-                        symbolMatch: false,
-                        pathMatch: false,
-                        excerpt: '',
-                        line: 0,
-                    })), tokens);
-                    results = {
-                        scope: scope === 'auto' ? 'content' : scope,
-                        mode: 'hybrid',
-                        query,
-                        queryTokens: tokens,
-                        model: semIndex.model,
-                        matches: enriched,
-                        total: enriched.length,
-                    };
-                }
-            }
-        }
-        if (spinner)
-            spinner.stop();
-        if (format === 'json') {
-            console.log(JSON.stringify({ search: results }, null, 2));
-            return;
-        }
-        if (format === 'markdown') {
-            const r = results;
-            console.log(`# Search - \`${r.query}\` (${r.scope})\n`);
-            if (r.matches.length === 0) {
-                console.log('_No matches._');
-                return;
-            }
-            for (const m of r.matches) {
-                if ('symbol' in m)
-                    console.log(`- \`${m.symbol}\` (${m.kind}) → \`${m.file}:${m.line}\``);
-                else if ('score' in m)
-                    console.log(`- \`${m.file}:${m.line}\` - score ${m.score} - ${m.excerpt ?? ''}`);
-                else
-                    console.log(`- \`${m.file}\``);
-            }
-            return;
-        }
-        // Console
-        const r = results;
-        console.log(`\n  ${chalk.bold(`Search - "${query}"`)} ${chalk.dim(`[${r.scope}]`)}`);
-        if (r.queryTokens)
-            console.log(chalk.dim(`  tokens: ${r.queryTokens.join(', ')}`));
-        console.log(chalk.dim('  ─'.repeat(20)));
-        if (r.matches.length === 0) {
-            console.log(chalk.yellow('\n  No matches.\n'));
-            return;
-        }
-        for (const m of r.matches) {
-            if ('symbol' in m) {
-                console.log(`  ${chalk.bold(String(m.symbol))} ${chalk.dim(`(${m.kind})`)}  →  ${chalk.dim(`${m.file}:${m.line}`)}`);
-            }
-            else if ('score' in m) {
-                const score = typeof m.score === 'number' ? m.score.toFixed(1) : String(m.score);
-                console.log(`  ${chalk.bold(score.padStart(5))}  ${chalk.cyan(String(m.file))}${m.line ? chalk.dim(`:${m.line}`) : ''}`);
-                if (m.excerpt)
-                    console.log(`           ${chalk.dim(String(m.excerpt))}`);
-            }
-            else {
-                console.log(`  ${chalk.cyan(String(m.file))}`);
-            }
-        }
-        console.log('');
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Search failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: coverage ─────────────────────────────────────
-program
-    .command('coverage')
-    .description('Join test coverage with hotspots - surface the scariest untested files')
-    .option('--limit <n>', 'limit number of entries shown', '30')
-    .option('--package <name>', 'monorepo: scope to a single workspace package')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const format = getFormat();
-    const config = await loadProjectConfig();
-    const spinner = format === 'console' ? ora('Parsing coverage...').start() : null;
-    try {
-        const coverage = await parseCoverage(rootPath);
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        const issues = await collectIssues(rootPath, scan.files);
-        const limitRaw = cmdOpts.limit ?? 30;
-        const limit = Math.max(1, Math.min(200, typeof limitRaw === 'string' ? parseInt(limitRaw, 10) || 30 : limitRaw));
-        const hotspots = await analyzeHotspots(rootPath, scan.files, issues, {
-            limit,
-            coverage: coverage.available ? coverageMap(coverage) : undefined,
-        });
-        const joined = joinCoverageWithHotspots(hotspots, coverage);
-        if (cmdOpts.package && joined.available) {
-            const ws = await detectWorkspaces(rootPath);
-            const allowed = new Set(filterFilesByPackage(ws, cmdOpts.package, joined.entries.map((e) => e.relativePath)));
-            joined.entries = joined.entries.filter((e) => allowed.has(e.relativePath));
-        }
-        if (spinner)
-            spinner.stop();
-        switch (format) {
-            case 'json':
-                reportCoverageJson(joined);
-                break;
-            case 'markdown':
-                reportCoverageMarkdown(joined);
-                break;
-            default:
-                reportCoverage(joined);
-        }
-    }
-    catch (error) {
-        if (spinner)
-            spinner.fail('Coverage analysis failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: mcp ──────────────────────────────────────────
-program
-    .command('mcp')
-    .description('Run projscan as an MCP server (stdio) for AI coding agents')
-    .action(async () => {
-    setLogLevel('quiet');
-    const rootPath = getRootPath();
-    try {
-        await runMcpServer(rootPath);
-    }
-    catch (error) {
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── Command: badge ────────────────────────────────────────
-program
-    .command('badge')
-    .description('Generate a health badge for your README')
-    .option('--markdown', 'output as markdown image link')
-    .action(async (cmdOpts) => {
-    setupLogLevel();
-    maybeCompactBanner();
-    const rootPath = getRootPath();
-    const spinner = ora('Calculating health score...').start();
-    const config = await loadProjectConfig();
-    try {
-        const scan = await scanRepository(rootPath, { ignore: config.ignore });
-        let issues = await collectIssues(rootPath, scan.files);
-        issues = applyConfigToIssues(issues, config);
-        const { score, grade } = calculateScore(issues);
-        spinner.stop();
-        const gradeColor = grade === 'A' || grade === 'B' ? chalk.green : grade === 'C' ? chalk.yellow : chalk.red;
-        console.log(`\n  Health Score: ${gradeColor(chalk.bold(`${grade} (${score}/100)`))}\n`);
-        if (cmdOpts.markdown) {
-            console.log(`  ${badgeMarkdown(grade)}\n`);
-        }
-        else {
-            console.log(`  ${chalk.bold('Badge URL:')}`);
-            console.log(`  ${badgeUrl(grade)}\n`);
-            console.log(`  ${chalk.bold('Markdown:')}`);
-            console.log(`  ${badgeMarkdown(grade)}\n`);
-        }
-        console.log(chalk.dim('  Add this to your README to show your project health score.\n'));
-    }
-    catch (error) {
-        spinner.fail('Badge generation failed');
-        console.error(chalk.red(error instanceof Error ? error.message : String(error)));
-        process.exit(1);
-    }
-});
-// ── File Analysis (for explain command) ───────────────────
-function analyzeFile(filePath, content) {
-    const lines = content.split('\n');
-    const imports = extractImports(content);
-    const exports = extractExports(content);
-    const purpose = inferPurpose(filePath, exports);
-    const potentialIssues = detectFileIssues(content, lines.length);
-    return {
-        filePath: path.relative(process.cwd(), filePath),
-        purpose,
-        imports,
-        exports,
-        potentialIssues,
-        lineCount: lines.length,
-    };
-}
-// ── Architecture Layer Detection ──────────────────────────
-function buildArchitectureLayers(files, frameworkNames) {
-    const layers = [];
-    const dirs = new Set(files.map((f) => f.directory.split(path.sep)[0]).filter(Boolean));
-    // Frontend layer
-    const frontendDirs = ['pages', 'components', 'views', 'layouts', 'public', 'app', 'styles'];
-    const frontendMatches = frontendDirs.filter((d) => dirs.has(d) || dirs.has(`src/${d}`));
-    const frontendFrameworks = frameworkNames.filter((f) => ['React', 'Next.js', 'Vue.js', 'Nuxt.js', 'Svelte', 'SvelteKit', 'Angular', 'Solid.js'].includes(f));
-    if (frontendMatches.length > 0 || frontendFrameworks.length > 0) {
-        layers.push({
-            name: 'Frontend',
-            technologies: frontendFrameworks.length > 0 ? frontendFrameworks : ['Static'],
-            directories: frontendMatches,
-        });
-    }
-    // API layer
-    const apiDirs = ['api', 'routes', 'controllers', 'endpoints'];
-    const apiMatches = apiDirs.filter((d) => dirs.has(d) || dirs.has(`src/${d}`));
-    const apiFrameworks = frameworkNames.filter((f) => ['Express', 'Fastify', 'NestJS', 'Hono', 'Koa', 'Apollo Server', 'tRPC'].includes(f));
-    if (apiMatches.length > 0 || apiFrameworks.length > 0) {
-        layers.push({
-            name: 'API Layer',
-            technologies: apiFrameworks.length > 0 ? apiFrameworks : ['HTTP'],
-            directories: apiMatches,
-        });
-    }
-    // Services layer
-    const serviceDirs = ['services', 'lib', 'core', 'domain', 'modules'];
-    const serviceMatches = serviceDirs.filter((d) => dirs.has(d) || dirs.has(`src/${d}`));
-    if (serviceMatches.length > 0) {
-        layers.push({
-            name: 'Services',
-            technologies: inferServiceTech(files, serviceMatches),
-            directories: serviceMatches,
-        });
-    }
-    // Database layer
-    const dbDirs = ['db', 'database', 'prisma', 'migrations', 'models', 'entities'];
-    const dbMatches = dbDirs.filter((d) => dirs.has(d) || dirs.has(`src/${d}`));
-    const dbFrameworks = frameworkNames.filter((f) => ['Prisma', 'Drizzle ORM', 'Mongoose', 'TypeORM', 'Sequelize'].includes(f));
-    if (dbMatches.length > 0 || dbFrameworks.length > 0) {
-        layers.push({
-            name: 'Database',
-            technologies: dbFrameworks.length > 0 ? dbFrameworks : ['Database'],
-            directories: dbMatches,
-        });
-    }
-    // If no layers detected, show a generic one
-    if (layers.length === 0) {
-        const topDirs = [...dirs].slice(0, 5);
-        layers.push({
-            name: 'Application',
-            technologies: frameworkNames.length > 0 ? frameworkNames : ['Unknown'],
-            directories: topDirs,
-        });
-    }
-    return layers;
-}
-function inferServiceTech(files, serviceDirs) {
-    const techs = [];
-    const serviceFiles = files.filter((f) => serviceDirs.some((d) => f.directory.startsWith(d)));
-    const hasTsFiles = serviceFiles.some((f) => f.extension === '.ts' || f.extension === '.tsx');
-    const hasJsFiles = serviceFiles.some((f) => f.extension === '.js' || f.extension === '.jsx');
-    if (hasTsFiles)
-        techs.push('TypeScript');
-    else if (hasJsFiles)
-        techs.push('JavaScript');
-    if (techs.length === 0)
-        techs.push('Mixed');
-    return techs;
-}
-// ── Helpers ───────────────────────────────────────────────
-function promptYesNo(question) {
-    return new Promise((resolve) => {
-        const rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        rl.question(question, (answer) => {
-            rl.close();
-            resolve(answer.toLowerCase().startsWith('y'));
-        });
-    });
-}
-// ── Command: help ─────────────────────────────────────────
-program
-    .command('help')
-    .description('Show detailed help with all commands and options')
-    .action(() => {
-    showHelp();
-});
-// ── Run ───────────────────────────────────────────────────
+import { program } from './_shared.js';
+import { registerAnalyze } from './commands/analyze.js';
+import { registerDoctor } from './commands/doctor.js';
+import { registerCi } from './commands/ci.js';
+import { registerDiff } from './commands/diff.js';
+import { registerFix } from './commands/fix.js';
+import { registerFile } from './commands/file.js';
+import { registerExplain } from './commands/explain.js';
+import { registerDiagram } from './commands/diagram.js';
+import { registerStructure } from './commands/structure.js';
+import { registerDependencies } from './commands/dependencies.js';
+import { registerHotspots } from './commands/hotspots.js';
+import { registerCoupling } from './commands/coupling.js';
+import { registerPrDiff } from './commands/prDiff.js';
+import { registerWorkspaces } from './commands/workspaces.js';
+import { registerOutdated } from './commands/outdated.js';
+import { registerAudit } from './commands/audit.js';
+import { registerUpgrade } from './commands/upgrade.js';
+import { registerSearch } from './commands/search.js';
+import { registerCoverage } from './commands/coverage.js';
+import { registerMcp } from './commands/mcp.js';
+import { registerBadge } from './commands/badge.js';
+import { registerHelp } from './commands/help.js';
+registerAnalyze();
+registerDoctor();
+registerCi();
+registerDiff();
+registerFix();
+registerFile();
+registerExplain();
+registerDiagram();
+registerStructure();
+registerDependencies();
+registerHotspots();
+registerCoupling();
+registerPrDiff();
+registerWorkspaces();
+registerOutdated();
+registerAudit();
+registerUpgrade();
+registerSearch();
+registerCoverage();
+registerMcp();
+registerBadge();
+registerHelp();
 program.parse();
 //# sourceMappingURL=index.js.map