thuban 0.3.3 → 0.3.4

package/cli.js

@@ -1,2627 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Thuban CLI
- * 
- * Code Health Engine — scan, map, fix.
- * 
- * Usage:
- *   npx thuban scan [path]          Scan a codebase for issues
- *   npx thuban deps [path]          Map dependencies and detect circular imports
- *   npx thuban drift [path]         Detect drift from Mother Code annotations
- *   npx thuban inject [path]        Inject Mother Code DNA into files
- *   npx thuban health [path]        Run health check on codebase
- *   npx thuban report [path]        Full scan + deps + drift combined report
- *   npx thuban hallucinate [path]   Detect AI hallucinations and phantom imports
- *   npx thuban watch [path]         Live sentinel — continuous file monitoring
- *   npx thuban monitor [path]       Recurring scans with saved history and alerts
- *   npx thuban history [path]       View recurring scan history for a repo
- *   npx thuban trend [path]         Show issue trends across recurring scans
- *   npx thuban dashboard [path]     Generate visual HTML dashboard report
- *   npx thuban diff [path]          Scan only git-changed files
- */
-
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-
-// Import engine components
-const CodeScanner = require('./packages/scanner/code-scanner.js');
-const DependencyGraph = require('./packages/scanner/dependency-graph.js');
-const DriftDetector = require('./packages/scanner/drift-detector.js');
-const WidgetGenerator = require('./packages/scanner/widget-generator.js');
-const AlertManager = require('./packages/scanner/alert-manager.js');
-const TechDebtAnalyzer = require('./packages/scanner/tech-debt-analyzer.js');
-const HallucinationDetector = require('./packages/scanner/hallucination-detector.js');
-const HtmlReportGenerator = require('./packages/scanner/html-report.js');
-const FileWatcher = require('./packages/scanner/file-watcher.js');
-const LicenseManager = require('./packages/scanner/license-manager.js');
-const PreCommitGate = require('./packages/scanner/pre-commit-gate.js');
-const TechDebtCostCalculator = require('./packages/scanner/tech-debt-cost.js');
-const GhostCodeDetector = require('./packages/scanner/ghost-code-detector.js');
-const AIConfidenceScorer = require('./packages/scanner/ai-confidence-scorer.js');
-const CopyPasteDriftDetector = require('./packages/scanner/copy-paste-detector.js');
-const CodebasePassport = require('./packages/scanner/codebase-passport.js');
-const ExecutiveReport = require('./packages/scanner/executive-report.js');
-const BaselineManager = require('./packages/scanner/baseline-manager.js');
-const MonitorStore = require('./packages/scanner/monitor-store.js');
-const { MonitorService, resolveIntervalMs } = require('./packages/scanner/monitor-service.js');
-const { collectFiles } = require('./packages/scanner/file-collector.js');
-
-// ─── Helpers ───────────────────────────────────────────────
-
-const COLORS = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  gray: '\x1b[90m',
-  white: '\x1b[37m',
-  bgRed: '\x1b[41m',
-  bgGreen: '\x1b[42m',
-  bgYellow: '\x1b[43m',
-};
-
-function c(color, text) {
-  return `${COLORS[color]}${text}${COLORS.reset}`;
-}
-
-function banner() {
-  console.log('');
-  console.log(c('cyan', '  ╔══════════════════════════════════════╗'));
-  console.log(c('cyan', '  ║') + c('bold', '        THUBAN Code Health Engine     ') + c('cyan', '║'));
-  console.log(c('cyan', '  ║') + c('gray', '   v0.3.3 · Public Beta · thuban.dev  ') + c('cyan', '║'));
-  console.log(c('cyan', '  ╚══════════════════════════════════════╝'));
-  console.log('');
-}
-
-function printHelp() {
-  banner();
-  const lm = new LicenseManager();
-  const status = lm.getStatus();
-  const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf-8'));
-  console.log(c('gray', `  v${pkg.version}  ·  ${status.tierName} tier`) + (status.licensed ? c('green', ' ✓') : '') + c('gray', '  ·  https://thuban.dev'));
-  console.log('');
-
-  // ─── QUICK START ──────────────────────────────────────────
-  console.log(c('bold', '  QUICK START'));
-  console.log('');
-  console.log(c('gray', '  Run these in order to see what Thuban does:'));
-  console.log('');
-  console.log(`    ${c('cyan', 'npx thuban scan .')}                  Scan your project`);
-  console.log(`    ${c('cyan', 'npx thuban fix .')}                   Preview what can be fixed`);
-  console.log(`    ${c('cyan', 'npx thuban fix . --fix')}             Apply all safe fixes`);
-  console.log(`    ${c('cyan', 'npx thuban dashboard .')}             Open visual HTML report`);
-  console.log('');
-
-  // ─── SCAN & DETECT ───────────────────────────────────────
-  console.log(c('bold', '  SCAN & DETECT'));
-  console.log('');
-  console.log(`    ${c('cyan', 'scan')} [path|url]           Full health scan — score, grade, all issues`);
-  console.log(`    ${c('cyan', 'compare')} [a] [b]          Compare two codebases side by side`);
-  console.log(`    ${c('cyan', 'hallucinate')} [path]       Find phantom APIs and invented imports`);
-  console.log(`    ${c('cyan', 'ghosts')} [path]            Dead functions nobody calls`);
-  console.log(`    ${c('cyan', 'ai-score')} [path]          Probability each function is AI-generated`);
-  console.log(`    ${c('cyan', 'clones')} [path]            Copy-pasted code that has drifted apart`);
-  console.log(`    ${c('cyan', 'drift')} [path]             Files that changed since Mother Code was set`);
-  console.log(`    ${c('cyan', 'deps')} [path]              Dependency map — circular, orphan, critical`);
-  console.log(`    ${c('cyan', 'diff')} [path]              Scan only git-changed files`);
-  console.log(`    ${c('cyan', 'debt')} [path]              Detailed tech debt breakdown`);
-  console.log(`    ${c('cyan', 'cost')} [path]              Tech debt translated to £ and hours`);
-  console.log('');
-
-  // ─── FIX & PROTECT ───────────────────────────────────────
-  console.log(c('bold', '  FIX & PROTECT'));
-  console.log('');
-  console.log(`    ${c('cyan', 'fix')} [path]               Preview fixable issues ${c('gray', '(safe, no changes)')}`);
-  console.log(`    ${c('cyan', 'fix')} [path] ${c('gray', '--fix')}         Apply all safe fixes`);
-  console.log(`    ${c('cyan', 'fix')} [path] ${c('gray', '--fix --commit')}  Each fix = 1 git commit ${c('gray', '(revert any)')}`);
-  console.log(`    ${c('cyan', 'inject')} [path]            Add Mother Code DNA to every file`);
-  console.log(`    ${c('cyan', 'gate')}                     Install pre-commit hook ${c('gray', '(blocks hallucinations)')}`);
-  console.log(`    ${c('cyan', 'watch')} [path]             Live sentinel — scans files as you save`);
-  console.log(`    ${c('cyan', 'monitor')} [path]           Recurring scans with saved history and alerts ${c('gray', '(Pro)')}`);
-  console.log(`    ${c('cyan', 'history')} [path]           View recurring scan history for a repo ${c('gray', '(Pro)')}`);
-  console.log(`    ${c('cyan', 'trend')} [path]             Show issue trends across recurring scans ${c('gray', '(Pro)')}`);
-  console.log(`    ${c('cyan', 'baseline')} [path]          Snapshot issues so future scans show only NEW ones`);
-  console.log('');
-
-  // ─── REPORTS ──────────────────────────────────────────────
-  console.log(c('bold', '  REPORTS'));
-  console.log('');
-  console.log(`    ${c('cyan', 'dashboard')} [path]         Interactive HTML report ${c('gray', '(share with your team)')}`);
-  console.log(`    ${c('cyan', 'executive')} [path]         CTO-ready report ${c('gray', '(print to PDF from browser)')}`);
-  console.log(`    ${c('cyan', 'report')} [path]            Combined scan + deps + drift summary`);
-  console.log(`    ${c('cyan', 'passport')} [path]          Codebase identity card ${c('gray', '(for new team members)')}`);
-  console.log('');
-
-  // ─── LICENSE ──────────────────────────────────────────────
-  console.log(c('bold', '  LICENSE'));
-  console.log('');
-  console.log(`    ${c('cyan', 'activate')} <key>           Activate a license key`);
-  console.log(`    ${c('cyan', 'status')}                   Show license, usage, and features`);
-  console.log(`    ${c('cyan', 'upgrade')}                  Open pricing page`);
-  console.log('');
-
-  // ─── OPTIONS ──────────────────────────────────────────────
-  console.log(c('bold', '  OPTIONS'));
-  console.log('');
-  console.log(`    ${c('gray', '--fix')}              Apply changes ${c('gray', '(default is dry-run preview)')}`);
-  console.log(`    ${c('gray', '--commit')}           Auto-commit each fix for easy rollback`);
-  console.log(`    ${c('gray', '--unsafe')}           Include fixes that change runtime behaviour`);
-  console.log(`    ${c('gray', '--json')}             Machine-readable JSON output`);
-  console.log(`    ${c('gray', '--baseline')}         Only show NEW issues vs saved baseline`);
-  console.log(`    ${c('gray', '--verbose')}          Show detailed output`);
-  console.log(`    ${c('gray', '--ignore <pat>')}     Skip files matching pattern`);
-  console.log(`    ${c('gray', '--max-issues <n>')}   Limit displayed issues ${c('gray', '(default: 50)')}`);
-  console.log('');
-
-  // ─── EXAMPLES ─────────────────────────────────────────────
-  console.log(c('bold', '  EXAMPLES'));
-  console.log('');
-  console.log(c('gray', '  # Scan the current project'));
-  console.log(`    ${c('white', 'npx thuban scan .')}`);
-  console.log('');
-  console.log(c('gray', '  # Find and fix all AI hallucinations'));
-  console.log(`    ${c('white', 'npx thuban hallucinate .')}`);
-  console.log(`    ${c('white', 'npx thuban fix . --fix')}`);
-  console.log('');
-  console.log(c('gray', '  # Generate a report for your CTO'));
-  console.log(`    ${c('white', 'npx thuban executive .')}`);
-  console.log('');
-  console.log(c('gray', '  # Block hallucinated code on every commit'));
-  console.log(`    ${c('white', 'npx thuban gate --fix')}`);
-  console.log('');
-  console.log(c('gray', '  # Scan a specific folder, ignore tests'));
-  console.log(`    ${c('white', 'npx thuban scan ./src --ignore "**/*.test.js"')}`);
-  console.log('');
-  console.log(c('gray', '  Report a bug or request a feature:'));
-  console.log(`    ${c('cyan', 'https://github.com/SilverwingsBenefitsGit/thuban/issues')}`);
-  console.log('');
-}
-
-function parseArgs(args) {
-  const opts = {
-    command: null,
-    targetPath: process.cwd(),
-    json: false,
-    fix: false,
-    dryRun: false,
-    safe: true,
-    gitCommit: false,
-    verbose: false,
-    ignore: [],
-    maxIssues: 50,
-    licenseKey: null,
-    baseline: false,
-    baselineCreate: false,
-    frequency: 'daily',
-    intervalMs: null,
-    notify: 'inbox',
-    once: false,
-  };
-
-  const noPathCommands = ['activate', 'status', 'upgrade', 'help', 'version'];
-
-  let i = 0;
-  while (i < args.length) {
-    const arg = args[i];
-    if (arg === '--json') { opts.json = true; }
-    else if (arg === '--fix') { opts.fix = true; }
-    else if (arg === '--dry-run' || arg === '--dryrun') { opts.dryRun = true; }
-    else if (arg === '--unsafe') { opts.safe = false; }
-    else if (arg === '--git-commit' || arg === '--commit') { opts.gitCommit = true; }
-    else if (arg === '--baseline') { opts.baseline = true; }
-    else if (arg === '--baseline-create') { opts.baselineCreate = true; }
-    else if (arg === '--frequency' && args[i + 1]) { opts.frequency = args[++i]; }
-    else if (arg === '--interval-ms' && args[i + 1]) { opts.intervalMs = parseInt(args[++i], 10); }
-    else if (arg === '--notify' && args[i + 1]) { opts.notify = args[++i]; }
-    else if (arg === '--once') { opts.once = true; }
-    else if (arg === '--verbose') { opts.verbose = true; }
-    else if (arg === '--ignore' && args[i + 1]) { opts.ignore.push(args[++i]); }
-    else if (arg === '--max-issues' && args[i + 1]) { opts.maxIssues = parseInt(args[++i], 10); }
-    else if (arg === '--help' || arg === '-h') { opts.command = 'help'; }
-    else if (arg === '--version' || arg === '-v') { opts.command = 'version'; }
-    else if (!opts.command) { opts.command = arg; }
-    else if (opts.command === 'activate' && !opts.licenseKey) { opts.licenseKey = arg; }
-    else if (!noPathCommands.includes(opts.command)) {
-      // Don't resolve git URLs as local paths
-      if (arg.match(/^(https?:\/\/|git@)/)) {
-        opts.targetPath = arg;
-      } else {
-        opts.targetPath = path.resolve(arg);
-      }
-    }
-    i++;
-  }
-
-  return opts;
-}
-
-// ─── Collect files recursively ───────────────────────────────
-
-function summarizeRemainingFiles(scannedFiles, allFiles, rootPath) {
-  const scannedSet = new Set(scannedFiles);
-  const remainingFiles = allFiles.filter(file => !scannedSet.has(file));
-  const directoryCounts = new Map();
-
-  for (const file of remainingFiles) {
-    const relativePath = path.relative(rootPath, file);
-    const segments = relativePath.split(path.sep).filter(Boolean);
-    const directory = segments.length > 1 ? segments[0] : '(root)';
-    directoryCounts.set(directory, (directoryCounts.get(directory) || 0) + 1);
-  }
-
-  const topDirectories = Array.from(directoryCounts.entries())
-    .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
-    .slice(0, 3)
-    .map(([directory, count]) => ({ directory, count }));
-
-  return {
-    remainingFiles,
-    remainingCount: remainingFiles.length,
-    topDirectories,
-    previewFiles: remainingFiles.slice(0, 5).map(file => path.relative(rootPath, file)),
-  };
-}
-
-function requireProFeature(featureName) {
-  const lm = new LicenseManager();
-  const access = lm.canUseProFeature(featureName);
-  if (!access.allowed) {
-    const upgradeUrl = 'https://thuban.dev/pricing';
-    console.log('');
-    console.log(c('yellow', '  ╔══════════════════════════════════════════════════════════════╗'));
-    console.log(c('yellow', '  ║') + c('bold', '  PRO FEATURE REQUIRED                                         ') + c('yellow', '║'));
-    console.log(c('yellow', '  ╠══════════════════════════════════════════════════════════════╣'));
-    console.log(c('yellow', '  ║') + `  ${featureName} is available on Thuban Pro.`.padEnd(62) + c('yellow', '║'));
-    console.log(c('yellow', '  ║') + '  Free Thuban gives you a one-off checkup. Pro gives you'.padEnd(62) + c('yellow', '║'));
-    console.log(c('yellow', '  ║') + '  a pair of eyes on your codebase all day every day with'.padEnd(62) + c('yellow', '║'));
-    console.log(c('yellow', '  ║') + '  recurring scans, saved history, trends, and alerts.'.padEnd(62) + c('yellow', '║'));
-    console.log(c('yellow', '  ║') + '                                                              ' + c('yellow', '║'));
-    console.log(c('yellow', '  ║') + `  Upgrade now: ${upgradeUrl}`.padEnd(62) + c('yellow', '║'));
-    console.log(c('yellow', '  ║') + '  CLI shortcut: thuban upgrade'.padEnd(62) + c('yellow', '║'));
-    console.log(c('yellow', '  ╚══════════════════════════════════════════════════════════════╝'));
-    console.log('');
-    process.exit(0);
-  }
-  return lm;
-}
-
-function resolveRepoConfigOrExit(store, targetPath) {
-  const repo = store.getRepo(targetPath);
-  if (!repo) {
-    console.log('');
-    console.log(c('yellow', '  No monitor configuration found for this repo.'));
-    console.log(c('gray', '  Run `thuban monitor <path> --once` or `thuban monitor <path>` first.'));
-    console.log('');
-    process.exit(0);
-  }
-  return repo;
-}
-
-function printFileCapUpgradePrompt({ scannedCount, totalCount, remainingSummary, upgradeUrl }) {
-  const criticalDirectoryCount = remainingSummary.topDirectories.length;
-
-  console.log(c('yellow', '  ╔══════════════════════════════════════════════════════════════╗'));
-  console.log(c('yellow', '  ║') + c('bold', '  FREE TIER LIMIT REACHED                                     ') + c('yellow', '║'));
-  console.log(c('yellow', '  ╠══════════════════════════════════════════════════════════════╣'));
-  console.log(c('yellow', '  ║') + `  You have scanned ${scannedCount} of ${totalCount} files.`.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + '  Upgrade to Thuban Pro for continuous monitoring —'.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + '  a pair of eyes on your codebase, all day, every day.'.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + '  Your always-on guardian with unlimited scans.'.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + `  ${remainingSummary.remainingCount} more files remaining including ${criticalDirectoryCount}`.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + `  critical director${criticalDirectoryCount === 1 ? 'y' : 'ies'}.`.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + '                                                              ' + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + `  Upgrade now: ${upgradeUrl}`.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ║') + `  CLI shortcut: thuban upgrade`.padEnd(62) + c('yellow', '║'));
-  console.log(c('yellow', '  ╚══════════════════════════════════════════════════════════════╝'));
-  console.log('');
-
-  if (remainingSummary.topDirectories.length > 0) {
-    console.log(c('bold', '  Remaining scan preview'));
-    for (const item of remainingSummary.topDirectories) {
-      console.log(`    ${c('yellow', '•')} ${c('cyan', item.directory)} ${c('gray', `(${item.count} files)`)}`);
-    }
-    if (remainingSummary.previewFiles.length > 0) {
-      console.log('');
-      console.log(c('gray', '  Next files that would be scanned:'));
-      for (const file of remainingSummary.previewFiles) {
-        console.log(`    ${c('gray', '·')} ${file}`);
-      }
-    }
-    console.log('');
-  }
-}
-
-// ─── Commands ───────────────────────────────────────────────
-
-async function cmdScan(opts) {
-  const startTime = Date.now();
-  const gitUrlPattern = /^(https?:\/\/|git@)/;
-  const isGitUrl = gitUrlPattern.test(opts.targetPath);
-  let targetPath = isGitUrl ? opts.targetPath : path.resolve(opts.targetPath);
-  let clonedRepo = null;
-
-  // ─── Git URL detection — clone and scan ─────────────────
-  if (isGitUrl) {
-    if (!opts.json) {
-      console.log('');
-      console.log(c('cyan', '  Cloning repository...'));
-      console.log(c('gray', `  ${opts.targetPath}`));
-    }
-    const tmpDir = path.join(os.tmpdir(), 'thuban-scan-' + Date.now());
-    const { execFileSync } = require('child_process');
-    try {
-      execFileSync('git', ['clone', '--depth', '1', opts.targetPath, tmpDir], { stdio: 'pipe', timeout: 60000 });
-      targetPath = tmpDir;
-      clonedRepo = tmpDir;
-      if (!opts.json) {
-        console.log(c('cyan', '  Cloned successfully'));
-        console.log('');
-      }
-    } catch (e) {
-      console.error(c('red', `  Failed to clone repository: ${e.message}`));
-      console.error(c('gray', '  Check the URL is correct and the repo is accessible'));
-      process.exit(1);
-    }
-  }
-
-  // ─── License check ───────────────────────────────────────
-  const lm = new LicenseManager();
-  const tier = lm.getTierConfig();
-  const scanCheck = lm.canScan();
-  const upgradeUrl = 'https://thuban.dev/pricing';
-
-  if (!scanCheck.allowed && !opts.json) {
-    console.log('');
-    console.log(c('red', '  ╔══════════════════════════════════════════════════╗'));
-    console.log(c('red', '  ║') + c('bold', '  Monthly scan limit reached                      ') + c('red', '║'));
-    console.log(c('red', '  ╚══════════════════════════════════════════════════╝'));
-    console.log('');
-    console.log(`  You've used ${c('bold', scanCheck.used + '/' + scanCheck.limit)} free scans this month.`);
-    console.log(`  Resets on ${c('cyan', scanCheck.resetsOn)}.`);
-    console.log('');
-    console.log(`  ${c('cyan', 'Upgrade to Pro')} for unlimited scans, full reports, auto-fix, and an always-on pair of eyes via thuban monitor:`);
-    console.log(`  ${c('bold', upgradeUrl)}`);
-    console.log('');
-    console.log(`  Or activate a key: ${c('cyan', 'thuban activate <your-key>')}`);
-    console.log('');
-    process.exit(0);
-  }
-
-  if (!opts.json) {
-    banner();
-
-    // First-run welcome
-    if (lm.usage.totalScans === 0) {
-      console.log(c('cyan', '  ┌──────────────────────────────────────────────────────┐'));
-      console.log(c('cyan', '  │') + c('bold', '  Welcome to Thuban!                                 ') + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('gray', 'Thuban scans your codebase for AI hallucinations,') + '   ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('gray', 'dead code, tech debt, and architecture drift.') + '      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('gray', 'After this scan, try:') + '                               ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '    ' + c('cyan', 'npx thuban fix .') + '          ' + c('gray', 'Preview fixes') + '           ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '    ' + c('cyan', 'npx thuban dashboard .') + '    ' + c('gray', 'Visual report') + '          ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '    ' + c('cyan', 'npx thuban --help') + '         ' + c('gray', 'All commands') + '           ' + c('cyan', '│'));
-      console.log(c('cyan', '  └──────────────────────────────────────────────────────┘'));
-      console.log('');
-    }
-
-    console.log(c('bold', '  SCANNING: ') + c('cyan', targetPath));
-    console.log('');
-  }
-
-  const allFiles = collectFiles(targetPath, opts.ignore);
-  const totalFileCount = allFiles.length;
-
-  // File limit gating
-  const files = tier.maxFiles < Infinity ? allFiles.slice(0, tier.maxFiles) : allFiles;
-  const isFileCapped = totalFileCount > tier.maxFiles;
-  const remainingSummary = isFileCapped ? summarizeRemainingFiles(files, allFiles, targetPath) : null;
-
-  if (!opts.json && isFileCapped) {
-    console.log(c('yellow', `  Free tier: scanning ${tier.maxFiles} of ${totalFileCount} files`));
-    console.log(c('gray', `  Partial results below. Upgrade to scan your entire codebase.`));
-    console.log('');
-  } else if (!opts.json) {
-    console.log(c('gray', `  Found ${files.length} files to scan...`));
-    console.log('');
-  }
-
-  // Run all analyses in parallel for the gut-punch report
-  const scanner = new CodeScanner({
-    rootPath: targetPath,
-    ignorePatterns: ['node_modules/**', '.git/**', 'dist/**', ...opts.ignore],
-  });
-  const hallucinationDetector = new HallucinationDetector({ rootPath: targetPath });
-
-  const [scanResults, hallResults] = await Promise.all([
-    scanner.scanFiles(files),
-    hallucinationDetector.scan(files),
-  ]);
-
-  const elapsed = Date.now() - startTime;
-
-  // Record this scan
-  lm.recordScan();
-
-  // ─── Collect all issues ──────────────────────────────────
-  const allIssues = [];
-  for (const issue of (scanResults.issues || [])) {
-    allIssues.push({ file: path.relative(targetPath, issue.file), ...issue });
-  }
-
-  // Add hallucination results as issues
-  for (const item of hallResults.phantomAPIs) {
-    allIssues.push({
-      file: item.file, line: item.line, severity: 'critical',
-      category: 'hallucination', id: 'HALL_API',
-      message: `${item.name} — this API does not exist`,
-      suggestion: item.suggestion,
-      crash: true,
-    });
-  }
-  for (const item of hallResults.phantomImports) {
-    allIssues.push({
-      file: item.file, line: item.line, severity: 'critical',
-      category: 'hallucination', id: 'HALL_IMPORT',
-      message: `${item.module} — ${item.reason}`,
-      crash: true,
-    });
-  }
-  for (const item of hallResults.deprecatedAPIs) {
-    allIssues.push({
-      file: item.file, line: item.line, severity: 'high',
-      category: 'deprecated', id: 'DEPR_API',
-      message: `${item.name} — deprecated since ${item.since}`,
-      suggestion: item.suggestion,
-    });
-  }
-  for (const item of hallResults.aiSmells) {
-    allIssues.push({
-      file: item.file, line: item.line, severity: 'warning',
-      category: 'ai_smell', id: item.id,
-      message: item.message,
-    });
-  }
-
-  if (opts.json) {
-    console.log(JSON.stringify({
-      files: totalFileCount,
-      filesScanned: files.length,
-      elapsed_ms: elapsed,
-      tier: lm.getTier(),
-      issues: tier.showFullDetails ? allIssues : allIssues.slice(0, tier.teaserIssues),
-      totalIssues: allIssues.length,
-      gated: !tier.showFullDetails,
-      fileLimitReached: isFileCapped,
-      upgradeUrl: isFileCapped ? upgradeUrl : null,
-      remainingFiles: remainingSummary ? remainingSummary.remainingCount : 0,
-      remainingDirectories: remainingSummary ? remainingSummary.topDirectories : [],
-      remainingPreview: remainingSummary ? remainingSummary.previewFiles : [],
-    }, null, 2));
-    return;
-  }
-
-  // ─── Sort by severity ────────────────────────────────────
-  const severityOrder = { critical: 0, high: 1, error: 2, medium: 3, warning: 4, low: 5, info: 6 };
-  allIssues.sort((a, b) => (severityOrder[a.severity] || 99) - (severityOrder[b.severity] || 99));
-
-  const criticals = allIssues.filter(i => i.severity === 'critical');
-  const highs = allIssues.filter(i => i.severity === 'high' || i.severity === 'error');
-  const mediums = allIssues.filter(i => i.severity === 'medium' || i.severity === 'warning');
-  const lows = allIssues.filter(i => i.severity === 'low' || i.severity === 'info');
-  const hallucinations = allIssues.filter(i => i.category === 'hallucination');
-  const deprecated = allIssues.filter(i => i.category === 'deprecated');
-
-  // ─── Health score ────────────────────────────────────────
-  // Weight by category: hallucinations are critical, AI smells are minor
-  const aiSmellIssues = allIssues.filter(i => i.category === 'ai_smell');
-  const nonSmellMediums = mediums.filter(i => i.category !== 'ai_smell');
-  const score = Math.max(0, 100
-    - (criticals.length * 15)
-    - (highs.length * 5)
-    - (nonSmellMediums.length * 2)
-    - (aiSmellIssues.length * 0.5)
-    - (lows.length * 0.25)
-  );
-  const grade = score >= 90 ? 'A' : score >= 80 ? 'B' : score >= 70 ? 'C+' : score >= 60 ? 'C' : score >= 50 ? 'D+' : score >= 40 ? 'D' : 'F';
-  const scoreColor = score >= 80 ? 'green' : score >= 60 ? 'yellow' : 'red';
-
-  // ═══════════════════════════════════════════════════════════
-  // THE GUT-PUNCH OUTPUT
-  // ═══════════════════════════════════════════════════════════
-
-  // ─── Count fixable items ─────────────────────────────────
-  const fixableCount = allIssues.filter(i => i.fixable !== false).length;
-
-  console.log(c('cyan', '  ╔══════════════════════════════════════════════════════╗'));
-  console.log(c('cyan', '  ║') + c('bold', '  THUBAN SCAN RESULTS                                ') + c('cyan', '║'));
-  console.log(c('cyan', '  ║') + c('gray', '  v0.3.3 · Public Beta                               ') + c('cyan', '║'));
-  console.log(c('cyan', '  ╠══════════════════════════════════════════════════════╣'));
-  console.log(c('cyan', '  ║') + `  Files scanned:     ${c('bold', String(files.length).padEnd(6))}` + (isFileCapped ? c('yellow', ` of ${totalFileCount}`) : '              ') + c('cyan', '       ║'));
-  console.log(c('cyan', '  ║') + `  Health score:      ${c(scoreColor, (grade + ' (' + Math.round(score) + '/100)').padEnd(20))}` + c('cyan', '           ║'));
-  console.log(c('cyan', '  ║') + `  Issues found:      ${c(allIssues.length > 0 ? 'yellow' : 'green', String(allIssues.length).padEnd(20))}` + c('cyan', '           ║'));
-  console.log(c('cyan', '  ║') + `  Auto-fixable:      ${c('green', String(fixableCount).padEnd(20))}` + c('cyan', '           ║'));
-  console.log(c('cyan', '  ║') + `  Scan time:         ${c('gray', (elapsed + 'ms').padEnd(20))}` + c('cyan', '           ║'));
-  console.log(c('cyan', '  ╚══════════════════════════════════════════════════════╝'));
-  console.log('');
-
-  // ─── Python/non-JS scoring disclosure ───────────────────
-  const hasNonJsFiles = files.some(f => !f.endsWith('.js') && !f.endsWith('.ts') && !f.endsWith('.jsx') && !f.endsWith('.tsx') && !f.endsWith('.mjs'));
-  if (hasNonJsFiles) {
-    const nonJsExts = [...new Set(files.filter(f => !/\.(js|ts|jsx|tsx|mjs)$/.test(f)).map(f => path.extname(f)).filter(Boolean))];
-    console.log(c('gray', `  Note: Score includes Security + Hallucination + Code Quality categories.`));
-    console.log(c('gray', `  Architecture + Dependency analysis evaluated for JS/TS only. Detected non-JS: ${nonJsExts.join(', ')}`));
-    console.log('');
-  }
-
-  // ─── CRITICAL: Hallucinated APIs (will crash) ────────────
-  if (hallucinations.length > 0) {
-    console.log(c('bgRed', ' CRITICAL ') + c('red', c('bold', ` ${hallucinations.length} Hallucinated API${hallucinations.length > 1 ? 's' : ''}`)));
-    console.log(c('gray', '  These imports or method calls do not exist. Your code WILL crash when it hits them.'));
-    console.log('');
-
-    const showCount = tier.showFullDetails ? hallucinations.length : Math.min(tier.teaserIssues, hallucinations.length);
-    for (let i = 0; i < showCount; i++) {
-      const item = hallucinations[i];
-      const lineRef = item.line ? `:${item.line}` : '';
-      console.log(`  ${c('cyan', item.file + lineRef)}`);
-      // Try to read the actual source line for maximum impact
-      try {
-        const fullPath = path.resolve(targetPath, item.file);
-        const lines = fs.readFileSync(fullPath, 'utf-8').split('\n');
-        if (item.line && lines[item.line - 1]) {
-          console.log(`    ${c('red', lines[item.line - 1].trim())}`);
-        }
-      } catch (e) { /* skip */ }
-      console.log(`    ${c('yellow', '^^^')} ${item.message}`);
-      if (item.suggestion) {
-        console.log(`    ${c('green', 'Fix:')} ${item.suggestion}`);
-      }
-      console.log('');
-    }
-
-    if (hallucinations.length > showCount) {
-      console.log(c('gray', `    ... ${hallucinations.length - showCount} more hallucinations hidden`));
-      console.log(c('cyan', `    Upgrade to Pro to see all: `) + c('bold', 'thuban upgrade'));
-      console.log('');
-    }
-  }
-
-  // ─── HIGH: Deprecated APIs ───────────────────────────────
-  if (deprecated.length > 0) {
-    console.log(c('red', c('bold', `  DEPRECATED: ${deprecated.length} API${deprecated.length > 1 ? 's' : ''} that will break on upgrade`)));
-    console.log(c('gray', '  These work NOW but will stop working when you upgrade Node.js or your dependencies.'));
-    console.log(c('gray', '  Fix: ') + c('cyan', 'npx thuban fix . --fix --unsafe'));
-    console.log('');
-
-    const showCount = tier.showFullDetails ? deprecated.length : Math.min(tier.teaserIssues, deprecated.length);
-    for (let i = 0; i < showCount; i++) {
-      const item = deprecated[i];
-      const lineRef = item.line ? `:${item.line}` : '';
-      console.log(`  ${c('cyan', item.file + lineRef)}`);
-      console.log(`    ${c('yellow', item.message)}`);
-      if (item.suggestion) {
-        console.log(`    ${c('green', '→')} ${item.suggestion}`);
-      }
-      console.log('');
-    }
-
-    if (deprecated.length > showCount) {
-      console.log(c('gray', `    ... ${deprecated.length - showCount} more hidden`));
-      console.log('');
-    }
-  }
-
-  // ─── Security & quality issues ───────────────────────────
-  const securityIssues = allIssues.filter(i => i.category === 'security');
-  const qualityIssues = allIssues.filter(i => i.category === 'quality' || i.category === 'performance' || i.category === 'ai' || i.category === 'ai_smell');
-
-  if (securityIssues.length > 0) {
-    console.log(c('red', c('bold', `  SECURITY: ${securityIssues.length} issue${securityIssues.length > 1 ? 's' : ''}`)));
-    const showCount = tier.showFullDetails ? Math.min(securityIssues.length, 10) : Math.min(tier.teaserIssues, securityIssues.length);
-    for (let i = 0; i < showCount; i++) {
-      const item = securityIssues[i];
-      const lineRef = item.line ? `:${item.line}` : '';
-      console.log(`    ${c('red', '✗')} ${c('cyan', item.file + lineRef)} ${c('gray', item.message)}`);
-    }
-    if (securityIssues.length > showCount) {
-      console.log(c('gray', `    ... ${securityIssues.length - showCount} more hidden`));
-    }
-    console.log('');
-  }
-
-  if (qualityIssues.length > 0) {
-    // Group quality issues by type for clearer output
-    const qualityByType = {};
-    for (const item of qualityIssues) {
-      const key = item.message || item.type || 'other';
-      // Normalize similar messages
-      const normalizedKey = key.replace(/\s*—.*$/, '').trim();
-      if (!qualityByType[normalizedKey]) qualityByType[normalizedKey] = [];
-      qualityByType[normalizedKey].push(item);
-    }
-    const typeEntries = Object.entries(qualityByType).sort((a, b) => b[1].length - a[1].length);
-
-    console.log(c('yellow', c('bold', `  CODE QUALITY: ${qualityIssues.length} issue${qualityIssues.length > 1 ? 's' : ''}`)));
-    console.log(c('gray', '  Patterns that reduce code quality, maintainability, or production readiness.'));
-    console.log('');
-
-    // Show grouped summary
-    const showTypes = tier.showFullDetails ? typeEntries.length : Math.min(3, typeEntries.length);
-    for (let t = 0; t < showTypes; t++) {
-      const [typeName, items] = typeEntries[t];
-      const sevColor = items[0].severity === 'high' || items[0].severity === 'error' ? 'red' : 'yellow';
-      console.log(`    ${c(sevColor, '!')} ${c('bold', String(items.length))} x ${typeName}`);
-      // Show first example file
-      if (items[0].file) {
-        const lineRef = items[0].line ? `:${items[0].line}` : '';
-        console.log(`      ${c('gray', 'e.g.')} ${c('cyan', items[0].file + lineRef)}`);
-      }
-    }
-    if (typeEntries.length > showTypes) {
-      console.log(c('gray', `    ... ${typeEntries.length - showTypes} more issue types`));
-    }
-    console.log('');
-
-    // Show fix command if fixable
-    const fixableQuality = qualityIssues.filter(i => i.fixable !== false).length;
-    if (fixableQuality > 0) {
-      console.log(c('gray', `  ${fixableQuality} of these can be auto-fixed: `) + c('cyan', 'npx thuban fix . --fix --unsafe'));
-      console.log('');
-    }
-  }
-
-  // ─── THE VERDICT ─────────────────────────────────────────
-  console.log(c('bold', '  ┌──────────────────────────────────────────────────────┐'));
-
-  if (score < 60) {
-    console.log(c('bold', '  │  ') + c('red', 'YOUR CODEBASE HAS A SERIOUS HEALTH PROBLEM      ') + c('bold', '  │'));
-  } else if (score < 80) {
-    console.log(c('bold', '  │  ') + c('yellow', 'YOUR CODEBASE NEEDS ATTENTION                   ') + c('bold', '  │'));
-  } else {
-    console.log(c('bold', '  │  ') + c('green', 'YOUR CODEBASE IS IN GOOD SHAPE                  ') + c('bold', '  │'));
-  }
-
-  console.log(c('bold', '  │') + `  Score: ${c(scoreColor, grade + ' (' + Math.round(score) + '/100)')}                                     ` + c('bold', '│'));
-  console.log(c('bold', '  └──────────────────────────────────────────────────────┘'));
-  console.log('');
-
-  // ─── Impact statement ────────────────────────────────────
-  if (criticals.length > 0) {
-    console.log(c('red', `  ${criticals.length} function${criticals.length > 1 ? 's' : ''} will crash in production.`));
-    const fixTime = criticals.length <= 3 ? '30 seconds' : criticals.length <= 10 ? '2 minutes' : '10 minutes';
-    console.log(c('gray', `  Estimated cleanup: ${fixTime} with Thuban auto-fix.`));
-    console.log(c('gray', `  Estimated cost if shipped: your weekend.`));
-    console.log('');
-  }
-
-  // ─── FREE TIER: Upgrade CTA ──────────────────────────────
-  if (!tier.showFullDetails) {
-    const hidden = allIssues.length - tier.teaserIssues;
-    if (hidden > 0) {
-      console.log(c('cyan', '  ╔══════════════════════════════════════════════════════╗'));
-      console.log(c('cyan', '  ║') + c('bold', `  ${hidden} more issues hidden                              `) + c('cyan', '║'));
-      console.log(c('cyan', '  ║') + c('gray', '  Upgrade to see every issue, fix them automatically,') + c('cyan', '║'));
-      console.log(c('cyan', '  ║') + c('gray', '  and get the full HTML dashboard report.            ') + c('cyan', '║'));
-      console.log(c('cyan', '  ╠══════════════════════════════════════════════════════╣'));
-      console.log(c('cyan', '  ║') + `  ${c('bold', 'thuban upgrade')}      Open pricing page               ` + c('cyan', '║'));
-      console.log(c('cyan', '  ║') + `  ${c('bold', 'thuban activate')} <key>  Activate a license key       ` + c('cyan', '║'));
-      console.log(c('cyan', '  ╚══════════════════════════════════════════════════════╝'));
-      console.log('');
-    }
-
-    // Show scan counter
-    const scanStatus = lm.canScan();
-    const remaining = scanStatus.remaining;
-    console.log(c('gray', `  Free scans remaining this month: ${remaining}/${scanStatus.limit}`));
-    console.log('');
-  } else {
-    // Pro/Team: show clear next steps
-    if (allIssues.length > 0) {
-      const fixable = allIssues.filter(i => i.fixable !== false).length;
-      console.log(c('cyan', '  ┌──────────────────────────────────────────────────────┐'));
-      console.log(c('cyan', '  │') + c('bold', '  WHAT TO DO NEXT                                    ') + c('cyan', '│'));
-      console.log(c('cyan', '  ├──────────────────────────────────────────────────────┤'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('bold', '1. See what would be fixed (safe preview):') + '         ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('cyan', 'npx thuban fix . ') + '                                ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('bold', '2. Apply all safe fixes:') + '                            ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('cyan', 'npx thuban fix . --fix') + '                           ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('bold', '3. Apply fixes with git rollback:') + '                   ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('cyan', 'npx thuban fix . --fix --commit') + '                  ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('gray', 'Each fix = 1 git commit. Undo any with git revert.') + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('bold', '4. Generate visual report (HTML):') + '                   ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('cyan', 'npx thuban dashboard .') + '                           ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('gray', 'Opens a dashboard you can share with your team.') + '  ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('bold', '5. Show tech debt cost in £:') + '                        ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('cyan', 'npx thuban cost .') + '                                ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('bold', '6. Block bad code on every commit:') + '                  ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('cyan', 'npx thuban gate') + '                                  ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '     ' + c('gray', 'Installs a pre-commit hook. Set once, forget.') + '    ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '                                                      ' + c('cyan', '│'));
-      console.log(c('cyan', '  │') + '  ' + c('gray', 'All commands: npx thuban --help') + '                     ' + c('cyan', '│'));
-      console.log(c('cyan', '  └──────────────────────────────────────────────────────┘'));
-      console.log('');
-    }
-  }
-
-  if (isFileCapped) {
-    printFileCapUpgradePrompt({
-      scannedCount: files.length,
-      totalCount: totalFileCount,
-      remainingSummary,
-      upgradeUrl,
-    });
-  }
-
-  // ─── Continuous monitoring pitch ────────────────────────
-  if (allIssues.length > 0 && !isFileCapped) {
-    console.log(c('gray', '  ─────────────────────────────────────────────────────'));
-    console.log(c('gray', '  Thuban runs 100% on your machine. No data leaves.'));
-    console.log(c('gray', '  No cloud costs. As your codebase grows, Thuban grows with it.'));
-    console.log('');
-    console.log(c('gray', '  Keep your codebase healthy continuously:'));
-    console.log(c('gray', '    ') + c('cyan', 'npx thuban gate --fix') + c('gray', '   Block bad code on every commit'));
-    console.log(c('gray', '    ') + c('cyan', 'npx thuban watch .') + c('gray', '      Scan files as you save them'));
-    console.log(c('gray', '    ') + c('cyan', 'npx thuban baseline .') + c('gray', '   Only alert on NEW issues'));
-    console.log('');
-  }
-}
-
-async function cmdDeps(opts) {
-  const startTime = Date.now();
-  const targetPath = path.resolve(opts.targetPath);
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  MAPPING DEPENDENCIES: ') + c('cyan', targetPath));
-    console.log('');
-  }
-
-  const files = collectFiles(targetPath, opts.ignore);
-  const graph = new DependencyGraph({ rootPath: targetPath });
-  await graph.build(files);
-  const elapsed = Date.now() - startTime;
-
-  const summary = graph.getModuleSummary();
-  const critical = graph.getMostCriticalFiles(10);
-  const orphans = graph.getOrphanFiles();
-  const circular = graph.circularDeps || [];
-
-  if (opts.json) {
-    console.log(JSON.stringify({ elapsed_ms: elapsed, summary, critical, orphans, circular, graph: graph.toJSON() }, null, 2));
-    return;
-  }
-
-  console.log(c('gray', `  Analysed ${files.length} files in ${elapsed}ms`));
-  console.log('');
-
-  console.log(c('bold', '  DEPENDENCY SUMMARY'));
-  console.log(`  Files:             ${summary.totalFiles || files.length}`);
-  console.log(`  Import links:      ${summary.totalImports || 0}`);
-  console.log(`  Circular deps:     ${circular.length > 0 ? c('red', circular.length) : c('green', '0')}`);
-  console.log(`  Orphan files:      ${orphans.length > 0 ? c('yellow', orphans.length) : c('green', '0')}`);
-  console.log('');
-
-  if (critical.length > 0) {
-    console.log(c('bold', '  MOST CRITICAL FILES') + c('gray', ' (most dependents)'));
-    for (const f of critical) {
-      const filePath = typeof f === 'string' ? f : (f.file || f.path || String(f));
-      const rel = path.relative(targetPath, filePath);
-      const deps = typeof f === 'object' ? (f.dependents || f.score || f.count || '?') : '?';
-      console.log(`    ${c('cyan', rel)} ${c('gray', '→ ' + deps + ' dependents')}`);
-    }
-    console.log('');
-  }
-
-  if (circular.length > 0) {
-    console.log(c('red', '  CIRCULAR DEPENDENCIES'));
-    for (const cycle of circular.slice(0, 5)) {
-      const cycleStr = Array.isArray(cycle) ? cycle.map(f => path.relative(targetPath, f)).join(' → ') : String(cycle);
-      console.log(`    ${c('yellow', '⟲')} ${cycleStr}`);
-    }
-    console.log('');
-  }
-
-  if (orphans.length > 0) {
-    console.log(c('yellow', '  ORPHAN FILES') + c('gray', ' (no imports, no exports consumed)'));
-    for (const orphan of orphans.slice(0, 10)) {
-      const orphanPath = typeof orphan === 'string' ? orphan : (orphan.file || orphan.path || String(orphan));
-      console.log(`    ${c('gray', '○')} ${path.relative(targetPath, orphanPath)}`);
-    }
-    if (orphans.length > 10) {
-      console.log(c('gray', `    ... and ${orphans.length - 10} more`));
-    }
-    console.log('');
-  }
-}
-
-async function cmdMonitor(opts) {
-  requireProFeature('Scheduled monitoring');
-  const targetPath = path.resolve(opts.targetPath);
-  const service = new MonitorService();
-  const repoConfig = service.configureRepo({
-    repoPath: targetPath,
-    frequency: opts.frequency,
-    intervalMs: resolveIntervalMs(opts.frequency, opts.intervalMs),
-    notification: { channels: String(opts.notify || 'inbox').split(',').map(item => item.trim()).filter(Boolean) },
-  });
-
-  if (opts.once) {
-    const result = await service.runRepoScan(repoConfig);
-    if (opts.json) {
-      console.log(JSON.stringify(result.run, null, 2));
-      return;
-    }
-    console.log('');
-    console.log(c('bold', '  THUBAN MONITOR RUN'));
-    console.log(`  Repo: ${repoConfig.repoPath}`);
-    console.log(`  New issues: ${result.diff.added.length}`);
-    console.log(`  Resolved issues: ${result.diff.resolved.length}`);
-    console.log(`  History saved: ${result.runPath}`);
-    console.log('');
-    return;
-  }
-
-  console.log('');
-  console.log(c('bold', '  THUBAN MONITOR ACTIVE'));
-  console.log(`  Repo: ${repoConfig.repoPath}`);
-  console.log(`  Frequency: ${repoConfig.frequency} (${repoConfig.intervalMs}ms)`);
-  console.log(`  Notifications: ${(repoConfig.notification.channels || []).join(', ')}`);
-  console.log(c('gray', '  Press Ctrl+C to stop.'));
-  console.log('');
-
-  service.start(repoConfig);
-  process.on('SIGINT', () => {
-    service.stopAll();
-    process.exit(0);
-  });
-}
-
-async function cmdHistory(opts) {
-  requireProFeature('Scan history');
-  const store = new MonitorStore();
-  const repo = resolveRepoConfigOrExit(store, opts.targetPath);
-  const runs = store.listRuns(repo.repoId);
-
-  if (opts.json) {
-    console.log(JSON.stringify({ repo, runs }, null, 2));
-    return;
-  }
-
-  console.log('');
-  console.log(c('bold', '  THUBAN HISTORY'));
-  console.log(`  Repo: ${repo.repoPath}`);
-  console.log(`  Runs: ${runs.length}`);
-  console.log('');
-
-  for (const run of runs.slice(-10).reverse()) {
-    console.log(`  ${c('cyan', run.timestamp)}  issues=${run.metrics.issueCount}  new=${run.diff?.added?.length || 0}  resolved=${run.diff?.resolved?.length || 0}`);
-  }
-
-  const notifications = store.getNotifications(10).filter(item => item.repoId === repo.repoId);
-  if (notifications.length) {
-    console.log('');
-    console.log(c('bold', '  RECENT ALERTS'));
-    for (const notification of notifications) {
-      console.log(`  ${c('yellow', notification.timestamp)}  ${notification.summary}`);
-    }
-  }
-  console.log('');
-}
-
-async function cmdTrend(opts) {
-  requireProFeature('Trend reporting');
-  const store = new MonitorStore();
-  const repo = resolveRepoConfigOrExit(store, opts.targetPath);
-  const runs = store.listRuns(repo.repoId);
-  const trend = runs.map(run => ({
-    timestamp: run.timestamp,
-    issueCount: run.metrics.issueCount,
-    hallucinations: run.metrics.hallucinations,
-    secrets: run.metrics.secrets,
-    techDebtScore: run.metrics.techDebtScore,
-    techDebtHours: run.metrics.techDebtHours,
-  }));
-
-  if (opts.json) {
-    console.log(JSON.stringify({ repo, trend }, null, 2));
-    return;
-  }
-
-  console.log('');
-  console.log(c('bold', '  THUBAN TREND'));
-  console.log(`  Repo: ${repo.repoPath}`);
-  console.log('');
-  for (const point of trend.slice(-12)) {
-    console.log(`  ${c('cyan', point.timestamp)}  issues=${point.issueCount}  hallucinations=${point.hallucinations}  secrets=${point.secrets}  debtScore=${point.techDebtScore ?? 'n/a'}  debtHours=${point.techDebtHours ?? 'n/a'}`);
-  }
-  console.log('');
-}
-
-async function cmdDrift(opts) {
-  const startTime = Date.now();
-  const targetPath = path.resolve(opts.targetPath);
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  DETECTING DRIFT: ') + c('cyan', targetPath));
-    console.log('');
-  }
-
-  const files = collectFiles(targetPath, opts.ignore);
-  const detector = new DriftDetector({ rootPath: targetPath });
-
-  const results = [];
-  let withWidget = 0;
-  let withDrift = 0;
-
-  for (const file of files) {
-    try {
-      const result = await detector.analyzeFile(file);
-      if (result && result.hasWidget) {
-        withWidget++;
-        if (result.drifts && result.drifts.length > 0) {
-          withDrift++;
-          results.push({ file: path.relative(targetPath, file), ...result });
-        }
-      }
-    } catch (e) { /* skip unreadable files */ }
-  }
-
-  const elapsed = Date.now() - startTime;
-
-  if (opts.json) {
-    console.log(JSON.stringify({ elapsed_ms: elapsed, total: files.length, annotated: withWidget, drifted: withDrift, results }, null, 2));
-    return;
-  }
-
-  console.log(c('gray', `  Checked ${files.length} files in ${elapsed}ms`));
-  console.log('');
-  console.log(`  Files with Mother Code:   ${c('cyan', withWidget)}`);
-  console.log(`  Files without:            ${c('yellow', files.length - withWidget)}`);
-  console.log(`  Files with drift:         ${withDrift > 0 ? c('red', withDrift) : c('green', '0')}`);
-  console.log('');
-
-  if (results.length > 0) {
-    console.log(c('bold', '  DRIFT DETECTED'));
-    for (const r of results.slice(0, 20)) {
-      console.log(`  ${c('yellow', '⚠')} ${c('cyan', r.file)}`);
-      for (const d of r.drifts) {
-        console.log(`    ${c('gray', '→')} ${d.type}: ${d.message || d.detail || JSON.stringify(d)}`);
-      }
-    }
-    console.log('');
-  }
-
-  const coverage = files.length > 0 ? Math.round((withWidget / files.length) * 100) : 0;
-  const covColor = coverage >= 80 ? 'green' : coverage >= 40 ? 'yellow' : 'red';
-  console.log(`  Mother Code coverage: ${c(covColor, coverage + '%')}`);
-  console.log('');
-}
-
-async function cmdInject(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  INJECTING MOTHER CODE: ') + c('cyan', targetPath));
-    console.log('');
-  }
-
-  const files = collectFiles(targetPath, opts.ignore).filter(f =>
-    f.endsWith('.js') || f.endsWith('.ts') || f.endsWith('.jsx') || f.endsWith('.tsx') ||
-    f.endsWith('.py') || f.endsWith('.java') || f.endsWith('.cs') || f.endsWith('.go') ||
-    f.endsWith('.kt') || f.endsWith('.rs') || f.endsWith('.php') || f.endsWith('.rb')
-  );
-  const graph = new DependencyGraph({ rootPath: targetPath });
-  await graph.build(files);
-
-  const generator = new WidgetGenerator({ rootPath: targetPath, dependencyGraph: graph });
-
-  let injected = 0;
-  let skipped = 0;
-  const previews = [];
-
-  for (const file of files) {
-    try {
-      const content = fs.readFileSync(file, 'utf-8');
-      // Check if already has a widget
-      if (content.includes('@purpose') && content.includes('@module')) {
-        skipped++;
-        continue;
-      }
-
-      const rawWidget = await generator.generateWidget(file, content);
-      if (!rawWidget) { skipped++; continue; }
-      // generateWidget returns an object with { widgetString, ... }
-      const rawWidgetStr = (rawWidget && rawWidget.widgetString) ? rawWidget.widgetString : String(rawWidget);
-
-      // Select correct comment style by file extension
-      const ext = path.extname(file).toLowerCase();
-      let widget;
-      if (ext === '.py' || ext === '.rb') {
-        // Python and Ruby use # line comments
-        widget = rawWidgetStr.replace(/^\/\*\*\n/, '').replace(/\s*\*\/\s*$/, '')
-          .split('\n').map(l => l.replace(/^\s*\*\s?/, '# ')).join('\n');
-      } else if (ext === '.go' || ext === '.rs') {
-        // Go and Rust use // line comments
-        widget = rawWidgetStr.replace(/^\/\*\*\n/, '').replace(/\s*\*\/\s*$/, '')
-          .split('\n').map(l => l.replace(/^\s*\*\s?/, '// ')).join('\n');
-      } else {
-        // Java, Kotlin, C#, PHP all support /** */ block comments natively
-        widget = rawWidgetStr;
-      }
-
-      if (opts.fix) {
-        // Actually inject
-        const newContent = widget + '\n\n' + content;
-        fs.writeFileSync(file, newContent, 'utf-8');
-        injected++;
-        if (!opts.json) {
-          console.log(`  ${c('green', '✓')} ${path.relative(targetPath, file)}`);
-        }
-      } else {
-        previews.push({ file: path.relative(targetPath, file), widget });
-        injected++;
-      }
-    } catch (e) { skipped++; }
-  }
-
-  if (opts.json) {
-    console.log(JSON.stringify({ injected, skipped, dryRun: !opts.fix, previews }, null, 2));
-    return;
-  }
-
-  console.log('');
-  if (!opts.fix) {
-    console.log(c('yellow', `  DRY RUN — ${injected} files would be annotated. Use --fix to apply.`));
-    if (opts.verbose && previews.length > 0) {
-      console.log('');
-      for (const p of previews.slice(0, 5)) {
-        console.log(`  ${c('cyan', p.file)}:`);
-        console.log(c('gray', p.widget.split('\n').map(l => '    ' + l).join('\n')));
-        console.log('');
-      }
-    }
-  } else {
-    console.log(c('green', `  ✓ Injected Mother Code into ${injected} files`));
-  }
-  console.log(`  ${c('gray', `Skipped: ${skipped} (already annotated or unsupported)`)}`);
-  console.log('');
-}
-
-async function cmdReport(opts) {
-  const startTime = Date.now();
-  const targetPath = path.resolve(opts.targetPath);
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  FULL REPORT: ') + c('cyan', targetPath));
-    console.log('');
-  }
-
-  const files = collectFiles(targetPath, opts.ignore);
-
-  // Run all analyses in parallel
-  const scanner = new CodeScanner({ rootPath: targetPath });
-  const graph = new DependencyGraph({ rootPath: targetPath });
-  const detector = new DriftDetector({ rootPath: targetPath });
-
-  const [scanResults] = await Promise.all([
-    scanner.scanFiles(files),
-    graph.build(files),
-  ]);
-
-  // Drift check
-  let driftCount = 0;
-  let annotated = 0;
-  for (const file of files) {
-    try {
-      const result = await detector.analyzeFile(file);
-      if (result && result.hasWidget) {
-        annotated++;
-        if (result.drifts && result.drifts.length > 0) driftCount++;
-      }
-    } catch (e) { /* skip */ }
-  }
-
-  const elapsed = Date.now() - startTime;
-
-  // Count issues
-  let totalIssues = 0;
-  let criticalCount = 0;
-  let highCount = 0;
-  for (const i of (scanResults.issues || [])) {
-    totalIssues++;
-    if (i.severity === 'critical') criticalCount++;
-    if (i.severity === 'high') highCount++;
-  }
-
-  const orphans = graph.getOrphanFiles();
-  const circular = graph.circularDeps || [];
-  const coverage = files.length > 0 ? Math.round((annotated / files.length) * 100) : 0;
-
-  // Health score
-  const score = Math.max(0, Math.round(
-    100
-    - (criticalCount * 15)
-    - (highCount * 5)
-    - (circular.length * 10)
-    - (orphans.length * 1)
-    - ((100 - coverage) * 0.1)
-    - (driftCount * 3)
-  ));
-
-  if (opts.json) {
-    console.log(JSON.stringify({
-      elapsed_ms: elapsed,
-      files: files.length,
-      health_score: score,
-      issues: { total: totalIssues, critical: criticalCount, high: highCount },
-      dependencies: { circular: circular.length, orphans: orphans.length },
-      mother_code: { annotated, coverage_pct: coverage, drifted: driftCount },
-    }, null, 2));
-    return;
-  }
-
-  const scoreColor = score >= 80 ? 'green' : score >= 60 ? 'yellow' : 'red';
-
-  console.log(c('bold', '  ╔══════════════════════════════════════╗'));
-  console.log(c('bold', '  ║         THUBAN HEALTH REPORT         ║'));
-  console.log(c('bold', '  ╚══════════════════════════════════════╝'));
-  console.log('');
-  console.log(`  ${c('bold', 'Health Score:')}       ${c(scoreColor, score + '/100')}`);
-  console.log(`  ${c('bold', 'Files Scanned:')}      ${files.length}`);
-  console.log(`  ${c('bold', 'Time:')}               ${elapsed}ms`);
-  console.log('');
-  console.log(c('bold', '  ── Code Quality ──────────────────────'));
-  console.log(`  Total issues:      ${totalIssues}`);
-  console.log(`  Critical:          ${criticalCount > 0 ? c('red', criticalCount) : c('green', '0')}`);
-  console.log(`  High:              ${highCount > 0 ? c('red', highCount) : c('green', '0')}`);
-  console.log('');
-  console.log(c('bold', '  ── Dependencies ─────────────────────'));
-  console.log(`  Circular deps:     ${circular.length > 0 ? c('red', circular.length) : c('green', '0')}`);
-  console.log(`  Orphan files:      ${orphans.length > 0 ? c('yellow', orphans.length) : c('green', '0')}`);
-  console.log('');
-  console.log(c('bold', '  ── Mother Code ──────────────────────'));
-  console.log(`  Annotated files:   ${annotated}`);
-  console.log(`  Coverage:          ${c(coverage >= 80 ? 'green' : coverage >= 40 ? 'yellow' : 'red', coverage + '%')}`);
-  console.log(`  Drifted files:     ${driftCount > 0 ? c('yellow', driftCount) : c('green', '0')}`);
-  console.log('');
-
-  // Grade
-  const grade = score >= 90 ? 'A' : score >= 80 ? 'B' : score >= 70 ? 'C' : score >= 60 ? 'D' : 'F';
-  const gradeColor = score >= 80 ? 'green' : score >= 60 ? 'yellow' : 'red';
-  console.log(`  ${c('bold', 'Grade:')} ${c(gradeColor, grade)}`);
-  console.log('');
-
-  if (score < 80) {
-    console.log(c('bold', '  RECOMMENDATIONS:'));
-    if (criticalCount > 0) console.log(`  ${c('red', '→')} Fix ${criticalCount} critical issues immediately`);
-    if (circular.length > 0) console.log(`  ${c('yellow', '→')} Resolve ${circular.length} circular dependencies`);
-    if (coverage < 50) console.log(`  ${c('yellow', '→')} Run ${c('cyan', 'thuban inject --fix')} to improve Mother Code coverage`);
-    if (driftCount > 0) console.log(`  ${c('yellow', '→')} ${driftCount} files have drifted from their annotations`);
-    if (orphans.length > 5) console.log(`  ${c('gray', '→')} Consider removing ${orphans.length} orphan files`);
-    console.log('');
-  }
-
-  // Clean up cloned repo (clonedRepo only exists in cmdScan scope)
-}
-
-// ─── Tech Debt & Fix Commands ────────────────────────────
-
-async function cmdDebt(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  const files = collectFiles(targetPath, opts.ignore);
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  TECH DEBT ANALYSIS: ') + c('cyan', targetPath));
-    console.log(c('gray', `  Scanning ${files.length} files...`));
-    console.log('');
-  }
-
-  const analyzer = new TechDebtAnalyzer({ rootPath: targetPath });
-  const debt = await analyzer.analyze(files);
-
-  if (opts.json) {
-    console.log(JSON.stringify(analyzer.toJSON(debt), null, 2));
-  } else {
-    console.log(analyzer.formatReport(debt));
-  }
-}
-
-async function cmdFix(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  const files = collectFiles(targetPath, opts.ignore);
-  const { execSync } = require('child_process');
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  AUTO-FIX TECH DEBT: ') + c('cyan', targetPath));
-    console.log('');
-  }
-
-  const analyzer = new TechDebtAnalyzer({ rootPath: targetPath });
-
-  // ─── DRY RUN is the default (Senate recommendation #1) ────
-  if (!opts.fix) {
-    const result = await analyzer.fix(files, { dryRun: true });
-
-    if (!opts.json) {
-      console.log(c('cyan', '  ╔══════════════════════════════════════════════════════╗'));
-      console.log(c('cyan', '  ║') + c('bold', '  DRY RUN — no files will be changed               ') + c('cyan', '║'));
-      console.log(c('cyan', '  ╚══════════════════════════════════════════════════════╝'));
-      console.log('');
-      console.log(`  Fixable items:    ${c('bold', result.totalFixable)}`);
-      console.log('');
-
-      const grouped = {};
-      const safeActions = ['inject_widget', 'regenerate_widget', 'remove_console_log', 'flag_for_removal'];
-      const unsafeActions = ['break_circular', 'extract_to_env', 'update_deprecated_api', 'wrap_localhost_url'];
-      let safeCount = 0;
-      let unsafeCount = 0;
-
-      for (const f of result.fixes) {
-        const action = f.fixAction || 'unknown';
-        if (!grouped[action]) grouped[action] = 0;
-        grouped[action]++;
-        if (unsafeActions.includes(action)) unsafeCount++;
-        else safeCount++;
-      }
-
-      console.log(c('green', c('bold', `  SAFE FIXES (${safeCount})`)) + c('gray', ' — no runtime behaviour change'));
-      for (const [action, count] of Object.entries(grouped).sort((a, b) => b[1] - a[1])) {
-        if (unsafeActions.includes(action)) continue;
-        const label = {
-          'inject_widget': 'Inject Mother Code DNA annotations',
-          'regenerate_widget': 'Update stale annotations',
-          'remove_console_log': 'Remove debug console.logs',
-          'flag_for_removal': 'Confirm orphan files for removal',
-        }[action] || action;
-        console.log(`    ${c('green', '→')} ${label}: ${c('bold', count)}`);
-      }
-      console.log('');
-
-      if (unsafeCount > 0) {
-        console.log(c('yellow', c('bold', `  UNSAFE FIXES (${unsafeCount})`)) + c('gray', ' — may change runtime behaviour'));
-        for (const [action, count] of Object.entries(grouped).sort((a, b) => b[1] - a[1])) {
-          if (!unsafeActions.includes(action)) continue;
-          const label = {
-            'break_circular': 'Restructure circular dependencies',
-            'extract_to_env': 'Extract hardcoded secrets to env vars',
-            'update_deprecated_api': 'Replace deprecated API calls with modern equivalents',
-            'wrap_localhost_url': 'Wrap hardcoded localhost URLs in env var fallback',
-          }[action] || action;
-          console.log(`    ${c('yellow', '!')} ${label}: ${c('bold', count)}`);
-        }
-        console.log('');
-        console.log(c('gray', '  Unsafe fixes require --unsafe flag:'));
-        console.log(`    ${c('cyan', 'thuban fix [path] --fix --unsafe')}`);
-        console.log('');
-      }
-
-      console.log(c('bold', '  TO APPLY:'));
-      console.log(`    ${c('cyan', 'thuban fix [path] --fix')}              Apply safe fixes only`);
-      console.log(`    ${c('cyan', 'thuban fix [path] --fix --unsafe')}     Apply all fixes`);
-      console.log(`    ${c('cyan', 'thuban fix [path] --fix --commit')}     Each fix = separate git commit`);
-      console.log('');
-    } else {
-      console.log(JSON.stringify(result, null, 2));
-    }
-    return;
-  }
-
-  // ─── ACTUAL FIX MODE ──────────────────────────────────────
-  if (!opts.json) {
-    if (opts.safe) {
-      console.log(c('green', '  SAFE MODE') + c('gray', ' — only non-runtime-changing fixes will be applied'));
-    } else {
-      console.log(c('yellow', '  UNSAFE MODE') + c('gray', ' — all fixes including runtime changes'));
-    }
-    console.log('');
-  }
-
-  const result = await analyzer.fix(files, {
-    dryRun: false,
-    safeOnly: opts.safe,
-  });
-
-  // ─── GIT COMMIT MODE (Senate recommendation: each fix = revertable commit) ─
-  if (opts.gitCommit && result.fixed > 0) {
-    try {
-      execSync('git rev-parse --git-dir', { cwd: targetPath, stdio: 'pipe' });
-      execSync('git add -A', { cwd: targetPath, stdio: 'pipe' });
-      const commitMsg = `fix(thuban): auto-fix ${result.fixed} issues [safe=${opts.safe}]`;
-      execSync(`git commit -m "${commitMsg}"`, { cwd: targetPath, stdio: 'pipe' });
-      if (!opts.json) {
-        console.log(c('green', `  ✓ Changes committed: "${commitMsg}"`));
-        console.log(c('gray', '  Revert with: git revert HEAD'));
-        console.log('');
-      }
-    } catch (e) {
-      if (!opts.json) {
-        console.log(c('yellow', '  ⚠ Could not auto-commit: ' + (e.message || 'not a git repo')));
-        console.log('');
-      }
-    }
-  }
-
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    console.log(c('cyan', '  ╔══════════════════════════════════════════════════════╗'));
-    console.log(c('cyan', '  ║') + c('bold', '  FIX RESULTS                                        ') + c('cyan', '║'));
-    console.log(c('cyan', '  ╠══════════════════════════════════════════════════════╣'));
-    // Split annotations (inject_widget/regenerate_widget) from real code fixes
-    const annotationsAdded = (result.fixes || []).filter(f => f.status === 'fixed' && (f.fixAction === 'inject_widget' || f.fixAction === 'regenerate_widget')).length;
-    const issuesFixed = result.fixed - annotationsAdded;
-    if (annotationsAdded > 0) {
-      console.log(c('cyan', '  ║') + `  Annotations added:  ${c('green', String(annotationsAdded).padEnd(19))}` + c('cyan', '           ║'));
-    }
-    if (issuesFixed > 0) {
-      console.log(c('cyan', '  ║') + `  Issues fixed:      ${c('green', String(issuesFixed).padEnd(20))}` + c('cyan', '           ║'));
-    }
-    if (annotationsAdded === 0 && issuesFixed === 0) {
-      console.log(c('cyan', '  ║') + `  Fixed:             ${c('green', String(result.fixed).padEnd(20))}` + c('cyan', '           ║'));
-    }
-    console.log(c('cyan', '  ║') + `  Flagged for review: ${c('yellow', String(result.flagged).padEnd(19))}` + c('cyan', '           ║'));
-    if (result.failed > 0) {
-      console.log(c('cyan', '  ║') + `  Failed:            ${c('red', String(result.failed).padEnd(20))}` + c('cyan', '           ║'));
-    }
-    if (result.skipped > 0) {
-      console.log(c('cyan', '  ║') + `  Skipped:           ${c('gray', String(result.skipped).padEnd(20))}` + c('cyan', '           ║'));
-    }
-    console.log(c('cyan', '  ╚══════════════════════════════════════════════════════╝'));
-    console.log('');
-
-    if (result.fixed > 0) {
-      console.log(c('green', '  Your files have been updated. Changes are saved to disk.'));
-      if (!opts.gitCommit) {
-        console.log(c('gray', '  Tip: use --commit next time to auto-commit each fix for easy rollback.'));
-      }
-      console.log('');
-      console.log(c('gray', '  Verify the changes:'));
-      console.log(c('gray', '    ') + c('cyan', 'npx thuban scan .') + c('gray', '        Re-scan to see your new score'));
-      console.log(c('gray', '    ') + c('cyan', 'npx thuban dashboard .') + c('gray', '   Generate updated report'));
-      console.log('');
-    }
-
-    if (result.skipped > 0) {
-      console.log(c('gray', `  ${result.skipped} items were skipped (no auto-fix available or pattern not matched).`));
-      console.log(c('gray', '  Review them manually or run: ') + c('cyan', 'npx thuban dashboard .'));
-      console.log('');
-    }
-
-    if (result.flagged > 0) {
-      console.log(c('gray', `  ${result.flagged} items need human review (secrets, orphan files, complex patterns).`));
-      console.log(c('gray', '  See details: ') + c('cyan', 'npx thuban dashboard .'));
-      console.log('');
-    }
-  }
-}
-
-// ─── Main ───────────────────────────────────────────────────
-
-async function cmdHallucinate(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  const files = collectFiles(targetPath, opts.ignore);
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  HALLUCINATION SCAN: ') + c('cyan', targetPath));
-    console.log(c('gray', `  Scanning ${files.length} files for AI hallucinations...`));
-    console.log('');
-  }
-
-  const detector = new HallucinationDetector({ rootPath: targetPath });
-  const results = await detector.scan(files);
-
-  if (opts.json) {
-    console.log(JSON.stringify(results, null, 2));
-  } else {
-    console.log(detector.formatReport(results));
-  }
-}
-
-async function cmdWatch(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-
-  const scanner = new CodeScanner({
-    rootPath: targetPath,
-    ignorePatterns: ['node_modules/**', '.git/**', 'dist/**', ...opts.ignore],
-  });
-
-  const hallucinationDetector = new HallucinationDetector({ rootPath: targetPath });
-
-  // Create a quick scan function for the watcher
-  const quickScan = async (filePath) => {
-    const issues = [];
-
-    // Code scan
-    const scanIssues = await scanner.scanFile(filePath);
-    if (scanIssues) issues.push(...scanIssues);
-
-    // Hallucination check
-    const hallResults = await hallucinationDetector.scan([filePath]);
-    if (hallResults.phantomAPIs.length > 0) {
-      for (const api of hallResults.phantomAPIs) {
-        issues.push({ severity: 'high', message: `Phantom API: ${api.name} — ${api.suggestion}`, line: api.line });
-      }
-    }
-    if (hallResults.phantomImports.length > 0) {
-      for (const imp of hallResults.phantomImports) {
-        issues.push({ severity: 'critical', message: `Phantom import: ${imp.module} — ${imp.reason}`, line: imp.line });
-      }
-    }
-    if (hallResults.aiSmells.length > 0) {
-      for (const smell of hallResults.aiSmells) {
-        issues.push({ severity: 'warning', message: `AI smell: ${smell.message}`, line: smell.line });
-      }
-    }
-
-    return issues;
-  };
-
-  const watcher = new FileWatcher({
-    rootPath: targetPath,
-    ignorePatterns: ['node_modules', '.git', 'dist', '.next', '__pycache__', ...opts.ignore],
-  });
-
-  // Handle graceful shutdown
-  process.on('SIGINT', () => {
-    watcher.stop();
-    process.exit(0);
-  });
-
-  watcher.start(quickScan);
-}
-
-async function cmdDashboard(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  const files = collectFiles(targetPath, opts.ignore);
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  GENERATING DASHBOARD: ') + c('cyan', targetPath));
-    console.log(c('gray', `  Scanning ${files.length} files...`));
-    console.log('');
-  }
-
-  // Run full analysis
-  const analyzer = new TechDebtAnalyzer({ rootPath: targetPath });
-  const debt = await analyzer.analyze(files);
-
-  // Get dependency data
-  const graph = new DependencyGraph({ rootPath: targetPath });
-  await graph.build(files);
-  const depData = {
-    circular: graph.circularDeps || [],
-    orphans: graph.getOrphanFiles() || [],
-    critical: graph.getMostCriticalFiles(5) || [],
-  };
-
-  // Run hallucination scan
-  const hallucinationDetector = new HallucinationDetector({ rootPath: targetPath });
-  const hallResults = await hallucinationDetector.scan(files);
-
-  // Generate HTML report
-  const reportGen = new HtmlReportGenerator({
-    rootPath: targetPath,
-    outputDir: targetPath,
-  });
-
-  const projectName = path.basename(targetPath);
-  const outputPath = await reportGen.writeReport(debt, depData, {
-    projectName,
-    hallucinations: hallResults,
-  });
-
-  if (!opts.json) {
-    console.log(c('green', `  ✓ Dashboard generated:`));
-    console.log(`    ${c('cyan', outputPath)}`);
-    console.log('');
-    console.log(c('gray', `  Open in your browser to view the interactive report`));
-    console.log('');
-  } else {
-    console.log(JSON.stringify({ outputPath, scores: debt.scores, stats: debt.stats }, null, 2));
-  }
-}
-
-async function cmdDiff(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  const { execSync } = require('child_process');
-
-  if (!opts.json) {
-    banner();
-    console.log(c('bold', '  DIFF SCAN: ') + c('cyan', targetPath));
-  }
-
-  // Get changed files from git
-  let changedFiles = [];
-  try {
-    // Files changed vs main/master branch
-    let baseBranch = 'main';
-    try {
-      execSync('git rev-parse --verify main', { cwd: targetPath, stdio: 'pipe' });
-    } catch {
-      try {
-        execSync('git rev-parse --verify master', { cwd: targetPath, stdio: 'pipe' });
-        baseBranch = 'master';
-      } catch {
-        // Fall back to HEAD~1
-        baseBranch = 'HEAD~1';
-      }
-    }
-
-    const diffOutput = execSync(`git diff --name-only ${baseBranch}...HEAD`, {
-      cwd: targetPath, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-
-    // Also get uncommitted changes
-    const statusOutput = execSync('git diff --name-only HEAD', {
-      cwd: targetPath, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-
-    const untrackedOutput = execSync('git ls-files --others --exclude-standard', {
-      cwd: targetPath, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
-    }).trim();
-
-    const allChanged = new Set([
-      ...diffOutput.split('\n').filter(Boolean),
-      ...statusOutput.split('\n').filter(Boolean),
-      ...untrackedOutput.split('\n').filter(Boolean),
-    ]);
-
-    // Resolve to full paths and filter to JS/TS files
-    for (const relFile of allChanged) {
-      const fullPath = path.resolve(targetPath, relFile);
-      const ext = path.extname(relFile).toLowerCase();
-      if (['.js', '.ts', '.jsx', '.tsx', '.mjs', '.cjs', '.json'].includes(ext)) {
-        if (fs.existsSync(fullPath)) {
-          changedFiles.push(fullPath);
-        }
-      }
-    }
-  } catch (e) {
-    if (!opts.json) {
-      console.log(c('red', `  ✗ Not a git repository or git error: ${e.message}`));
-    }
-    process.exit(1);
-  }
-
-  if (changedFiles.length === 0) {
-    if (!opts.json) {
-      console.log(c('green', '  ✓ No changed files to scan'));
-    } else {
-      console.log(JSON.stringify({ changedFiles: 0, issues: 0 }));
-    }
-    return;
-  }
-
-  if (!opts.json) {
-    console.log(c('gray', `  Scanning ${changedFiles.length} changed file${changedFiles.length === 1 ? '' : 's'}...\n`));
-  }
-
-  // Run scans on changed files only
-  const scanner = new CodeScanner({ rootPath: targetPath });
-  const hallucinationDetector = new HallucinationDetector({ rootPath: targetPath });
-
-  const scanResults = await scanner.scanFiles(changedFiles);
-  const hallResults = await hallucinationDetector.scan(changedFiles);
-
-  // Collect all issues
-  let totalIssues = 0;
-  const fileIssues = {};
-
-  for (const issue of (scanResults.issues || [])) {
-    const relFile = path.relative(targetPath, issue.file);
-    if (!fileIssues[relFile]) fileIssues[relFile] = [];
-    fileIssues[relFile].push(issue);
-    totalIssues++;
-  }
-
-  totalIssues += hallResults.stats.totalIssues;
-
-  if (opts.json) {
-    console.log(JSON.stringify({
-      changedFiles: changedFiles.length,
-      totalIssues,
-      codeIssues: fileIssues,
-      hallucinations: hallResults,
-    }, null, 2));
-  } else {
-    // Display results per file
-    for (const [relFile, issues] of Object.entries(fileIssues)) {
-      console.log(`  ${c('cyan', relFile)}`);
-      for (const issue of issues.slice(0, 5)) {
-        const sevColor = issue.severity === 'critical' || issue.severity === 'high' ? 'red' : issue.severity === 'warning' ? 'yellow' : 'gray';
-        console.log(`    ${c(sevColor, '✗')} ${c('gray', issue.message || issue.id || '')}`);
-      }
-      if (issues.length > 5) {
-        console.log(`    ${c('gray', `... and ${issues.length - 5} more`)}`);
-      }
-      console.log('');
-    }
-
-    // Hallucination results
-    if (hallResults.stats.totalIssues > 0) {
-      console.log(hallucinationDetector.formatReport(hallResults));
-    }
-
-    // Summary
-    const color = totalIssues === 0 ? 'green' : 'yellow';
-    console.log(`  ${c(color, `${changedFiles.length} files changed, ${totalIssues} new issues introduced`)}\n`);
-  }
-}
-
-// ─── License Commands ───────────────────────────────────────
-
-async function cmdActivate(opts) {
-  banner();
-  const lm = new LicenseManager();
-
-  const key = opts.licenseKey;
-
-  if (!key) {
-    console.log(c('red', '  Usage: thuban activate <license-key>'));
-    console.log('');
-    console.log(c('gray', '  Get a key at: ') + c('cyan', 'https://thuban.dev/pricing'));
-    console.log('');
-    return;
-  }
-
-  const result = lm.activate(key);
-
-  if (result.success) {
-    console.log(c('green', '  ╔══════════════════════════════════════╗'));
-    console.log(c('green', '  ║') + c('bold', '  License activated!                   ') + c('green', '║'));
-    console.log(c('green', '  ╚══════════════════════════════════════╝'));
-    console.log('');
-    console.log(`  Tier:     ${c('bold', result.tierName)}`);
-    console.log(`  Status:   ${c('green', 'Active')}`);
-    console.log('');
-    console.log(c('gray', '  All features unlocked. Run ') + c('cyan', 'thuban scan .') + c('gray', ' to get started.'));
-    console.log('');
-  } else {
-    console.log(c('red', '  Invalid license key.'));
-    console.log('');
-    console.log(c('gray', '  Check for typos or get a new key at: ') + c('cyan', 'https://thuban.dev/pricing'));
-    console.log('');
-  }
-}
-
-async function cmdStatus(opts) {
-  banner();
-  const lm = new LicenseManager();
-  const status = lm.getStatus();
-
-  console.log(c('bold', '  LICENSE STATUS'));
-  console.log('');
-  console.log(`  Tier:              ${c('bold', status.tierName)}${status.licensed ? c('green', ' (active)') : ''}`);
-  console.log(`  Machine ID:        ${c('gray', status.machineId)}`);
-  console.log(`  Scans this month:  ${c('bold', status.scansUsed)}${status.scansLimit < Infinity ? c('gray', ' / ' + status.scansLimit) : ''}`);
-  console.log(`  Lifetime scans:    ${c('gray', status.totalScans)}`);
-  console.log('');
-  console.log(c('bold', '  FEATURES'));
-  console.log(`  Full scan details: ${status.features.fullDetails ? c('green', 'Yes') : c('red', 'No')}`);
-  console.log(`  HTML dashboard:    ${status.features.dashboard ? c('green', 'Yes') : c('red', 'No')}`);
-  console.log(`  Auto-fix:          ${status.features.autoFix ? c('green', 'Yes') : c('red', 'No')}`);
-  console.log(`  CI Action:         ${status.features.ciAction ? c('green', 'Yes') : c('red', 'No')}`);
-  console.log('');
-
-  if (!status.licensed) {
-    console.log(c('cyan', '  Upgrade at: ') + c('bold', 'https://thuban.dev/pricing'));
-    console.log('');
-  }
-}
-
-function cmdUpgrade() {
-  banner();
-  console.log(c('bold', '  THUBAN PRICING'));
-  console.log('');
-  console.log(`  ${c('gray', 'FREE')}          ${c('bold', '£0/mo')}`);
-  console.log(`    5 scans/month, 100 files, summary only`);
-  console.log('');
-  console.log(`  ${c('cyan', 'PRO')}           ${c('bold', '£19/mo')}  ${c('gray', '(or £149/year — save 35%)')}`);
-  console.log(`    Unlimited scans, full details, auto-fix, HTML dashboard`);
-  console.log('');
-  console.log(`  ${c('cyan', 'TEAM')}          ${c('bold', '£99/mo')}`);
-  console.log(`    Everything in Pro + 5 seats, CI Action, team reports`);
-  console.log('');
-  console.log(`  ${c('cyan', 'ENTERPRISE')}    ${c('bold', '£299/mo')}`);
-  console.log(`    Everything in Team + unlimited seats, priority support, SLA`);
-  console.log('');
-  console.log(c('bold', '  Subscribe at: ') + c('cyan', 'https://thuban.dev/pricing'));
-  console.log('');
-
-  // Try to open the URL
-  try {
-    const { exec } = require('child_process');
-    const platform = process.platform;
-    const cmd = platform === 'win32' ? 'start' : platform === 'darwin' ? 'open' : 'xdg-open';
-    exec(`${cmd} https://thuban.dev/pricing`);
-  } catch (e) { /* non-fatal */ }
-}
-
-// ─── New Feature Commands ───────────────────────────────────
-
-async function cmdGate(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-
-  if (opts.fix) {
-    // --fix = install the hook
-    const result = PreCommitGate.install(targetPath);
-    banner();
-    if (result.success) {
-      console.log(c('green', '  ✓ Pre-commit gate installed!'));
-      console.log('');
-      console.log(c('gray', '  Every commit will now be checked for hallucinated APIs.'));
-      console.log(c('gray', '  Commits with phantom APIs will be blocked automatically.'));
-      console.log('');
-      console.log(`  To remove: ${c('cyan', 'thuban gate --uninstall')}`);
-    } else {
-      console.log(c('red', `  Error: ${result.error}`));
-    }
-    console.log('');
-    return;
-  }
-
-  if (process.argv.includes('--uninstall')) {
-    const result = PreCommitGate.uninstall(targetPath);
-    banner();
-    console.log(c('green', `  ✓ ${result.message}`));
-    console.log('');
-    return;
-  }
-
-  // Run the gate check (used by the pre-commit hook and manual runs)
-  const gate = new PreCommitGate({ rootPath: targetPath, strict: !process.argv.includes('--warn') });
-  const result = gate.run();
-
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  const isCi = process.argv.includes('--ci');
-
-  if (!isCi) banner();
-
-  if (result.files === 0) {
-    console.log(c('gray', '  No staged files to check.'));
-    console.log('');
-    console.log(`  Install the gate: ${c('cyan', 'thuban gate --fix')}`);
-    console.log('');
-    return;
-  }
-
-  if (result.passed) {
-    console.log(c('green', `  ✓ ${result.message}`));
-    console.log(c('gray', `    ${result.elapsed}ms`));
-    if (!isCi) console.log('');
-    process.exit(0);
-  } else {
-    console.log(c('red', `  ✗ ${result.message}`));
-    console.log('');
-    for (const issue of result.issues) {
-      console.log(`  ${c('red', issue.file)}:${issue.line}`);
-      console.log(`    ${c('yellow', issue.code)}`);
-      console.log(`    ${c('red', '^^^')} ${issue.message}`);
-      if (issue.fix) console.log(`    ${c('green', 'Fix:')} ${issue.fix}`);
-      console.log('');
-    }
-    process.exit(1);
-  }
-}
-
-async function cmdCost(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  banner();
-  console.log(c('bold', '  SCANNING: ') + c('cyan', targetPath));
-  console.log('');
-
-  const files = collectFiles(targetPath, opts.ignore);
-  const scanner = new CodeScanner({
-    rootPath: targetPath,
-    ignorePatterns: ['node_modules/**', '.git/**', 'dist/**', ...opts.ignore],
-  });
-  const hallucinationDetector = new HallucinationDetector({ rootPath: targetPath });
-
-  const [scanResults, hallResults] = await Promise.all([
-    scanner.scanFiles(files),
-    hallucinationDetector.scan(files),
-  ]);
-
-  // Collect all issues
-  const allIssues = [];
-  for (const issue of (scanResults.issues || [])) {
-    allIssues.push({ file: path.relative(targetPath, issue.file), ...issue });
-  }
-  for (const item of hallResults.phantomAPIs) {
-    allIssues.push({ category: 'hallucination', severity: 'critical', message: item.name });
-  }
-  for (const item of hallResults.deprecatedAPIs) {
-    allIssues.push({ category: 'deprecated', severity: 'high', message: item.name });
-  }
-
-  const calculator = new TechDebtCostCalculator();
-  const result = calculator.calculate(allIssues, files.length);
-
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  console.log(calculator.formatCLI(result));
-}
-
-async function cmdGhosts(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  banner();
-  console.log(c('bold', '  SCANNING FOR GHOST CODE: ') + c('cyan', targetPath));
-  console.log('');
-
-  const files = collectFiles(targetPath, opts.ignore);
-  const detector = new GhostCodeDetector({ rootPath: targetPath });
-  const result = detector.scan(files);
-
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.ghosts.length === 0) {
-    console.log(c('green', '  No ghost code detected. Every function is referenced.'));
-    console.log('');
-    return;
-  }
-
-  console.log(c('yellow', c('bold', `  GHOST CODE: ${result.totalGhosts} function${result.totalGhosts > 1 ? 's' : ''} exist but are never called`)));
-  console.log('');
-
-  for (const ghost of result.ghosts.slice(0, opts.maxIssues)) {
-    const sevColor = ghost.severity === 'high' ? 'red' : 'yellow';
-    console.log(`  ${c(sevColor, '⊘')} ${c('cyan', ghost.file)}:${ghost.line}`);
-    console.log(`    ${c('bold', ghost.name + '()')} — ${ghost.wastedLines} lines, ${ghost.references} references`);
-    console.log('');
-  }
-
-  console.log(c('bold', '  ┌──────────────────────────────────────────────────────┐'));
-  console.log(c('bold', '  │') + `  Wasted code: ${c('red', result.totalWastedLines + ' lines')} (${result.wastedPercent}% of codebase)  ` + c('bold', '│'));
-  console.log(c('bold', '  └──────────────────────────────────────────────────────┘'));
-  console.log('');
-}
-
-async function cmdAIScore(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  banner();
-  console.log(c('bold', '  AI CONFIDENCE SCORING: ') + c('cyan', targetPath));
-  console.log('');
-
-  const files = collectFiles(targetPath, opts.ignore);
-  const scorer = new AIConfidenceScorer({ rootPath: targetPath });
-  const result = scorer.scan(files);
-
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.highConfidence.length === 0 && result.mediumConfidence.length === 0) {
-    console.log(c('green', '  No AI-generated code patterns detected.'));
-    console.log('');
-    return;
-  }
-
-  console.log(c('red', c('bold', `  HIGH CONFIDENCE AI-GENERATED (${result.highConfidence.length} functions)`)));
-  console.log('');
-
-  for (const fn of result.highConfidence.slice(0, 15)) {
-    console.log(`  ${c('red', fn.confidence + '%')} AI  ${c('cyan', fn.file)}:${fn.line}`);
-    console.log(`    ${c('bold', fn.name + '()')} — ${fn.lineCount} lines | Test coverage: ${fn.testCoverage}`);
-    for (const signal of fn.signals.slice(0, 2)) {
-      console.log(`    ${c('gray', '• ' + signal)}`);
-    }
-    console.log('');
-  }
-
-  if (result.mediumConfidence.length > 0) {
-    console.log(c('yellow', c('bold', `  POSSIBLE AI-GENERATED (${result.mediumConfidence.length} functions)`)));
-    console.log('');
-    for (const fn of result.mediumConfidence.slice(0, 10)) {
-      console.log(`  ${c('yellow', fn.confidence + '%')} AI  ${c('cyan', fn.file)}:${fn.line}  ${c('gray', fn.name + '()')}`);
-    }
-    console.log('');
-  }
-
-  console.log(c('bold', '  ┌──────────────────────────────────────────────────────┐'));
-  console.log(c('bold', '  │') + `  ${c('red', result.aiPercentage + '%')} of functions are likely AI-generated            ` + c('bold', '│'));
-  console.log(c('bold', '  │') + `  ${c('yellow', result.aiLikelyCount)} high confidence | ${result.aiPossibleCount} possible          ` + c('bold', '│'));
-  console.log(c('bold', '  └──────────────────────────────────────────────────────┘'));
-  console.log('');
-}
-
-async function cmdClones(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  banner();
-  console.log(c('bold', '  COPY-PASTE DRIFT DETECTION: ') + c('cyan', targetPath));
-  console.log('');
-
-  const files = collectFiles(targetPath, opts.ignore);
-  const detector = new CopyPasteDriftDetector({ rootPath: targetPath });
-  const result = detector.scan(files);
-
-  if (opts.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-
-  if (result.clusters.length === 0) {
-    console.log(c('green', '  No copy-paste drift detected.'));
-    console.log('');
-    return;
-  }
-
-  console.log(c('yellow', c('bold', `  COPY-PASTE CLUSTERS: ${result.totalClusters} found`)));
-  console.log('');
-
-  for (const cluster of result.clusters.slice(0, 10)) {
-    const sevColor = cluster.severity === 'high' ? 'red' : 'yellow';
-    console.log(`  ${c(sevColor, '◈')} ${c('bold', cluster.pattern + ' pattern')} — ${cluster.totalInstances} instances`);
-    for (const member of cluster.members) {
-      const sim = member.similarity < 100 ? c('gray', ` (${member.similarity}% similar)`) : '';
-      console.log(`    ${c('cyan', member.file)}:${member.line}  ${c('gray', member.name + '()')}${sim}`);
-    }
-    console.log(`    ${c('green', '→')} ${cluster.recommendation}`);
-    console.log('');
-  }
-
-  console.log(c('bold', `  Total duplicate lines: ${c('red', result.totalDuplicateLines)}`));
-  console.log(c('gray', `  ${result.recommendation}`));
-  console.log('');
-}
-
-async function cmdPassport(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  banner();
-  console.log(c('bold', '  GENERATING CODEBASE PASSPORT: ') + c('cyan', targetPath));
-  console.log('');
-
-  const files = collectFiles(targetPath, opts.ignore);
-  const generator = new CodebasePassport({ rootPath: targetPath });
-  const passport = generator.generate(files);
-
-  if (opts.json) {
-    console.log(JSON.stringify(passport, null, 2));
-    return;
-  }
-
-  const outputPath = generator.save(passport);
-  const p = passport.project;
-  const o = passport.onboarding;
-
-  console.log(c('green', `  ✓ Passport generated: ${c('bold', path.relative(targetPath, outputPath))}`));
-  console.log('');
-  console.log(c('bold', '  PROJECT IDENTITY'));
-  console.log(`  Name:          ${c('cyan', p.name)}`);
-  console.log(`  Files:         ${c('bold', p.totalFiles)}`);
-  console.log(`  Lines:         ${c('bold', p.totalLines.toLocaleString())}`);
-  console.log(`  Architecture:  ${c('bold', p.architecture)}`);
-  console.log(`  Frameworks:    ${p.frameworks.join(', ') || 'vanilla'}`);
-  console.log('');
-  console.log(c('bold', '  LANGUAGES'));
-  for (const lang of p.languages.slice(0, 5)) {
-    const bar = '█'.repeat(Math.max(1, Math.round(lang.percentage / 5)));
-    console.log(`    ${lang.extension.padEnd(6)} ${c('cyan', bar)} ${lang.percentage}% (${lang.lines} lines)`);
-  }
-  console.log('');
-  console.log(c('bold', '  ONBOARDING'));
-  console.log(`  Read time:     ~${o.estimatedReadTimeMinutes} minutes`);
-  console.log(`  Start here:    ${o.startHere.slice(0, 3).join(', ')}`);
-  if (o.doNotTouch.length > 0) {
-    console.log(`  Do not touch:  ${c('red', o.doNotTouch.join(', '))}`);
-  }
-  console.log(`  Summary:       ${o.quickSummary}`);
-  console.log('');
-
-  if (passport.sacred.length > 0) {
-    console.log(c('bold', '  SACRED FILES (high impact if changed)'));
-    for (const s of passport.sacred.slice(0, 5)) {
-      console.log(`    ${c('red', '!')} ${c('cyan', s.file)} — imported by ${s.importedBy} files`);
-    }
-    console.log('');
-  }
-
-  console.log(c('gray', `  Full passport: ${outputPath}`));
-  console.log(c('gray', `  Share with new team members for instant onboarding.`));
-  console.log('');
-}
-
-async function cmdExecutive(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  banner();
-  console.log(c('bold', '  GENERATING EXECUTIVE REPORT: ') + c('cyan', targetPath));
-  console.log('');
-
-  const files = collectFiles(targetPath, opts.ignore);
-
-  console.log(c('gray', `  Scanning ${files.length} files...`));
-
-  const scanner = new CodeScanner({
-    rootPath: targetPath,
-    ignorePatterns: ['node_modules/**', '.git/**', 'dist/**', ...opts.ignore],
-  });
-  const hallucinationDetector = new HallucinationDetector({ rootPath: targetPath });
-  const ghostDetector = new GhostCodeDetector({ rootPath: targetPath });
-  const aiScorer = new AIConfidenceScorer({ rootPath: targetPath });
-  const cloneDetector = new CopyPasteDriftDetector({ rootPath: targetPath });
-
-  // Run all scans in parallel
-  const [scanResults, hallResults, ghostResults, aiScoreResults, cloneResults] = await Promise.all([
-    scanner.scanFiles(files),
-    hallucinationDetector.scan(files),
-    ghostDetector.scan(files),
-    aiScorer.scan(files),
-    cloneDetector.scan(files),
-  ]);
-
-  // Calculate total lines
-  let lineCount = 0;
-  for (const file of files) {
-    try {
-      const content = fs.readFileSync(file, 'utf-8');
-      lineCount += content.split('\n').length;
-    } catch { /* skip */ }
-  }
-
-  // Collect all issues for cost calculator
-  const allIssues = [];
-  for (const issue of (scanResults.issues || [])) {
-    allIssues.push({ file: path.relative(targetPath, issue.file), ...issue });
-  }
-  for (const item of hallResults.phantomAPIs) {
-    allIssues.push({ category: 'hallucination', severity: 'critical', message: item.name });
-  }
-  for (const item of hallResults.deprecatedAPIs) {
-    allIssues.push({ category: 'deprecated', severity: 'high', message: item.name });
-  }
-
-  const costCalc = new TechDebtCostCalculator();
-  const debtCost = costCalc.calculate(allIssues, files.length);
-
-  // Generate report
-  const report = new ExecutiveReport({
-    rootPath: targetPath,
-    companyName: opts.companyName || undefined,
-  });
-
-  const html = report.generate({
-    scanResults,
-    hallResults,
-    debtCost,
-    ghostResults,
-    aiScoreResults,
-    cloneResults,
-    fileCount: files.length,
-    lineCount,
-  });
-
-  const outputPath = report.save(html, targetPath);
-
-  console.log(c('green', `  ✓ Executive report generated!`));
-  console.log('');
-  console.log(`  ${c('bold', 'Report:')} ${c('cyan', outputPath)}`);
-  console.log('');
-  console.log(c('gray', '  Open in browser → Ctrl+P → Save as PDF'));
-  console.log(c('gray', '  Or click the "Save as PDF" button in the report.'));
-  console.log('');
-
-  // Try to open in browser
-  try {
-    const { exec } = require('child_process');
-    const platform = process.platform;
-    const cmd = platform === 'win32' ? 'start' : platform === 'darwin' ? 'open' : 'xdg-open';
-    exec(`${cmd} "${outputPath}"`);
-    console.log(c('green', '  ✓ Opened in your default browser.'));
-    console.log('');
-  } catch (e) { /* non-fatal */ }
-}
-
-async function cmdBaseline(opts) {
-  const targetPath = path.resolve(opts.targetPath);
-  const baseline = new BaselineManager(targetPath);
-
-  banner();
-
-  if (opts.baselineCreate || !baseline.exists()) {
-    // Create baseline from current scan
-    console.log(c('bold', '  CREATING BASELINE: ') + c('cyan', targetPath));
-    console.log('');
-
-    const files = collectFiles(targetPath, opts.ignore);
-    const scanner = new CodeScanner({
-      rootPath: targetPath,
-      ignorePatterns: ['node_modules/**', '.git/**', 'dist/**', ...opts.ignore],
-    });
-    const hallucinationDetector = new HallucinationDetector({ rootPath: targetPath });
-
-    const [scanResults, hallResults] = await Promise.all([
-      scanner.scanFiles(files),
-      hallucinationDetector.scan(files),
-    ]);
-
-    const allIssues = [];
-    for (const issue of (scanResults.issues || [])) {
-      allIssues.push({ file: path.relative(targetPath, issue.file), ...issue });
-    }
-    for (const item of hallResults.phantomAPIs) {
-      allIssues.push({ file: item.file, category: 'hallucination', severity: 'critical', id: item.id, message: item.name });
-    }
-    for (const item of hallResults.deprecatedAPIs) {
-      allIssues.push({ file: item.file, category: 'deprecated', severity: 'high', id: item.id, message: item.name });
-    }
-    for (const item of hallResults.aiSmells) {
-      allIssues.push({ file: item.file, category: 'ai_smell', severity: 'warning', id: item.id, message: item.message });
-    }
-
-    const result = baseline.create(allIssues);
-    console.log(c('green', `  ✓ Baseline created: ${c('bold', result.count)} known issues recorded`));
-    console.log(`    ${c('cyan', result.path)}`);
-    console.log('');
-    console.log(c('gray', '  Future scans with --baseline will only report NEW issues.'));
-    console.log(c('gray', '  Commit .thuban-baseline.json to share baseline with your team.'));
-    console.log('');
-  } else {
-    // Show baseline status
-    const existing = baseline.load();
-    console.log(c('bold', '  BASELINE STATUS'));
-    console.log('');
-    console.log(`  Created:        ${c('cyan', existing.created)}`);
-    console.log(`  Known issues:   ${c('bold', existing.issueCount)}`);
-    console.log('');
-    console.log(c('gray', '  Use --baseline-create to update the baseline'));
-    console.log(c('gray', '  Use --baseline with scan to only see new issues'));
-    console.log('');
-  }
-}
-
-// ─── Telemetry (opt-in anonymous usage stats) ───────────────
-
-function getTelemetryConfigPath() {
-  const home = process.env.HOME || process.env.USERPROFILE || os.homedir();
-  return path.join(home, '.thuban-telemetry.json');
-}
-
-function isTelemetryEnabled() {
-  try {
-    const config = JSON.parse(fs.readFileSync(getTelemetryConfigPath(), 'utf-8'));
-    return config.enabled === true;
-  } catch { return false; }
-}
-
-function sendAnonymousTelemetry(data) {
-  if (!isTelemetryEnabled()) return;
-  try {
-    const payload = JSON.stringify({
-      v: data.version || '0.3.1',
-      cmd: data.command,
-      files: data.fileCount,
-      score: data.score,
-      grade: data.grade,
-      langs: data.languages,
-      issues: data.issueCount,
-      duration: data.duration,
-      os: process.platform,
-      node: process.version,
-      ts: new Date().toISOString()
-    });
-    // Fire and forget — never blocks the CLI
-    const https = require('https');
-    const req = https.request({
-      hostname: 'thuban-telemetry.silverwingsbenefits.workers.dev',
-      path: '/report',
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(payload) },
-      timeout: 3000
-    });
-    req.on('error', () => {}); // silently ignore
-    req.write(payload);
-    req.end();
-  } catch { /* never fail the CLI for telemetry */ }
-}
-
-async function cmdTelemetry(opts) {
-  const configPath = getTelemetryConfigPath();
-  const args = process.argv.slice(2);
-
-  if (args.includes('--on')) {
-    fs.writeFileSync(configPath, JSON.stringify({ enabled: true, updated: new Date().toISOString() }));
-    console.log('');
-    console.log(c('cyan', '  Telemetry enabled'));
-    console.log(c('gray', '  Anonymous usage stats will be sent (no code, no paths, no PII)'));
-    console.log(c('gray', '  Turn off anytime: npx thuban telemetry --off'));
-    console.log('');
-  } else if (args.includes('--off')) {
-    fs.writeFileSync(configPath, JSON.stringify({ enabled: false, updated: new Date().toISOString() }));
-    console.log('');
-    console.log(c('cyan', '  Telemetry disabled'));
-    console.log(c('gray', '  No data will be collected'));
-    console.log('');
-  } else {
-    const enabled = isTelemetryEnabled();
-    console.log('');
-    console.log(c('bold', '  TELEMETRY STATUS'));
-    console.log('');
-    console.log(`  Status:   ${enabled ? c('cyan', 'Enabled') : c('gray', 'Disabled (default)')}`);
-    console.log('');
-    console.log(c('gray', '  Thuban telemetry is 100% opt-in and anonymous.'));
-    console.log(c('gray', '  We collect: file count, score, grade, languages, OS, scan duration.'));
-    console.log(c('gray', '  We never collect: code, file names, paths, project names, or PII.'));
-    console.log('');
-    console.log(`  Enable:   ${c('cyan', 'npx thuban telemetry --on')}`);
-    console.log(`  Disable:  ${c('cyan', 'npx thuban telemetry --off')}`);
-    console.log('');
-  }
-}
-
-// ─── Internal scan (returns data without printing) ──────────
-
-async function runScanSilent(targetInput) {
-  const gitUrlPattern = /^(https?:\/\/|git@)/;
-  const isGitUrl = gitUrlPattern.test(targetInput);
-  let targetPath = isGitUrl ? targetInput : path.resolve(targetInput);
-  let clonedRepo = null;
-  let label = targetInput;
-
-  if (isGitUrl) {
-    const tmpDir = path.join(os.tmpdir(), 'thuban-compare-' + Date.now() + '-' + Math.random().toString(36).slice(2,6));
-    const { execFileSync } = require('child_process');
-    execFileSync('git', ['clone', '--depth', '1', targetInput, tmpDir], { stdio: 'pipe', timeout: 60000 });
-    targetPath = tmpDir;
-    clonedRepo = tmpDir;
-    // Extract repo name for label
-    const parts = targetInput.replace(/\.git$/, '').split('/');
-    label = parts[parts.length - 1] || targetInput;
-  } else {
-    label = path.basename(path.resolve(targetInput)) || targetInput;
-  }
-
-  const startTime = Date.now();
-  const scanner = new CodeScanner();
-  const graph = new DependencyGraph();
-  const hallDetector = new HallucinationDetector({ rootPath: targetPath });
-
-  const files = collectFiles(targetPath, []);
-  const scanResults = {};
-  let annotated = 0;
-  let driftCount = 0;
-
-  for (const file of files) {
-    try {
-      const result = scanner.scanFile(file);
-      const relPath = path.relative(targetPath, file);
-      scanResults[file] = result;
-      graph.addFile(file, targetPath);
-      if (result.motherCode && result.motherCode.hasDNA) annotated++;
-      if (result.drifts && result.drifts.length > 0) driftCount++;
-    } catch (e) { /* skip */ }
-  }
-
-  // Run hallucination detection (same as main scan)
-  const hallResults = hallDetector.scan(files, targetPath);
-
-  const elapsed = Date.now() - startTime;
-  let totalIssues = 0, criticalCount = 0, highCount = 0;
-  const issueByCat = {};
-
-  // Count code scanner issues
-  for (const [, r] of Object.entries(scanResults)) {
-    if (r.issues) {
-      totalIssues += r.issues.length;
-      for (const iss of r.issues) {
-        if (iss.severity === 'critical') criticalCount++;
-        if (iss.severity === 'high') highCount++;
-        const cat = iss.category || iss.type || 'other';
-        issueByCat[cat] = (issueByCat[cat] || 0) + 1;
-      }
-    }
-  }
-
-  // Count hallucination issues
-  const hallIssueCount = (hallResults.phantomAPIs || []).length
-    + (hallResults.phantomImports || []).length
-    + (hallResults.deprecatedAPIs || []).length;
-  totalIssues += hallIssueCount;
-  criticalCount += (hallResults.phantomAPIs || []).length + (hallResults.phantomImports || []).length;
-  highCount += (hallResults.deprecatedAPIs || []).length;
-  if (hallIssueCount > 0) issueByCat['hallucination'] = hallIssueCount;
-
-  const orphans = graph.getOrphanFiles();
-  const circular = graph.circularDeps || [];
-  const coverage = files.length > 0 ? Math.round((annotated / files.length) * 100) : 0;
-
-  const score = Math.max(0, Math.round(
-    100 - (criticalCount * 15) - (highCount * 5) - (circular.length * 10)
-    - (orphans.length * 1) - ((100 - coverage) * 0.1) - (driftCount * 3)
-  ));
-
-  const grade = score >= 90 ? 'A' : score >= 80 ? 'B' : score >= 70 ? 'C' : score >= 60 ? 'D' : 'F';
-
-  if (clonedRepo) {
-    try { fs.rmSync(clonedRepo, { recursive: true, force: true }); } catch {}
-  }
-
-  return {
-    label,
-    files: files.length,
-    score,
-    grade,
-    elapsed,
-    issues: { total: totalIssues, critical: criticalCount, high: highCount },
-    categories: issueByCat,
-    dependencies: { circular: circular.length, orphans: orphans.length },
-    motherCode: { annotated, coverage, drifted: driftCount }
-  };
-}
-
-// ─── Compare Command ────────────────────────────────────────
-
-async function cmdCompare(opts) {
-  const args = process.argv.slice(2);
-  // Find the two paths after 'compare'
-  const paths = args.filter(a => a !== 'compare' && !a.startsWith('--'));
-
-  if (paths.length < 2) {
-    console.log('');
-    console.log(c('red', '  Compare requires two paths or URLs'));
-    console.log('');
-    console.log(c('gray', '  Usage:'));
-    console.log(`    ${c('cyan', 'npx thuban compare ./project-a ./project-b')}`);
-    console.log(`    ${c('cyan', 'npx thuban compare . https://github.com/user/repo')}`);
-    console.log(`    ${c('cyan', 'npx thuban compare https://github.com/a/repo https://github.com/b/repo')}`);
-    console.log('');
-    process.exit(1);
-  }
-
-  console.log('');
-  console.log(c('bold', '  ╔══════════════════════════════════════╗'));
-  console.log(c('bold', '  ║     THUBAN — Codebase Comparison     ║'));
-  console.log(c('bold', '  ╚══════════════════════════════════════╝'));
-  console.log('');
-
-  console.log(c('cyan', `  Scanning: ${paths[0]}`));
-  const resultA = await runScanSilent(paths[0]);
-  console.log(c('cyan', `  Scanning: ${paths[1]}`));
-  const resultB = await runScanSilent(paths[1]);
-
-  console.log('');
-
-  // ─── Side by side comparison ────────────────────────────
-  const pad = (str, len) => String(str).padEnd(len);
-  const padL = (str, len) => String(str).padStart(len);
-  const colW = 20;
-  const labelA = resultA.label.length > colW ? resultA.label.slice(0, colW - 2) + '..' : resultA.label;
-  const labelB = resultB.label.length > colW ? resultB.label.slice(0, colW - 2) + '..' : resultB.label;
-
-  const scoreColorA = resultA.score >= 80 ? 'green' : resultA.score >= 60 ? 'yellow' : 'red';
-  const scoreColorB = resultB.score >= 80 ? 'green' : resultB.score >= 60 ? 'yellow' : 'red';
-
-  const arrow = (a, b) => {
-    if (a === b) return c('gray', '  =');
-    return a > b ? c('green', '  ↑') : c('red', '  ↓');
-  };
-
-  const better = (a, b, lowerIsBetter) => {
-    if (a === b) return c('gray', ' draw');
-    if (lowerIsBetter) return a < b ? c('green', ' ← winner') : c('red', '');
-    return a > b ? c('green', ' ← winner') : c('red', '');
-  };
-
-  console.log(c('bold', '  ┌──────────────────────┬──────────────────────┬──────────────────────┐'));
-  console.log(c('bold', `  │ ${pad('METRIC', colW)} │ ${pad(labelA, colW)} │ ${pad(labelB, colW)} │`));
-  console.log(c('bold', '  ├──────────────────────┼──────────────────────┼──────────────────────┤'));
-
-  const row = (label, valA, valB) => {
-    console.log(`  │ ${c('gray', pad(label, colW))} │ ${pad(valA, colW)} │ ${pad(valB, colW)} │`);
-  };
-
-  row('Health Score', `${c(scoreColorA, resultA.score + '/100')}`, `${c(scoreColorB, resultB.score + '/100')}`);
-  row('Grade', `${c(scoreColorA, resultA.grade)}`, `${c(scoreColorB, resultB.grade)}`);
-  row('Files Scanned', String(resultA.files), String(resultB.files));
-  row('Total Issues', String(resultA.issues.total), String(resultB.issues.total));
-  row('Critical Issues', String(resultA.issues.critical), String(resultB.issues.critical));
-  row('High Issues', String(resultA.issues.high), String(resultB.issues.high));
-  row('Circular Deps', String(resultA.dependencies.circular), String(resultB.dependencies.circular));
-  row('Orphan Files', String(resultA.dependencies.orphans), String(resultB.dependencies.orphans));
-  row('Mother Code DNA', `${resultA.motherCode.coverage}%`, `${resultB.motherCode.coverage}%`);
-  row('Drift Issues', String(resultA.motherCode.drifted), String(resultB.motherCode.drifted));
-  row('Scan Time', `${resultA.elapsed}ms`, `${resultB.elapsed}ms`);
-
-  console.log(c('bold', '  └──────────────────────┴──────────────────────┴──────────────────────┘'));
-  console.log('');
-
-  // ─── Verdict ────────────────────────────────────────────
-  const diff = resultA.score - resultB.score;
-  if (diff === 0) {
-    console.log(c('cyan', `  VERDICT: Both codebases score identically (${resultA.score}/100)`));
-  } else {
-    const winner = diff > 0 ? resultA : resultB;
-    const loser = diff > 0 ? resultB : resultA;
-    console.log(c('cyan', `  VERDICT: ${winner.label} is healthier`));
-    console.log(c('gray', `  ${winner.label} scores ${winner.score}/100 (${winner.grade}) vs ${loser.label} at ${loser.score}/100 (${loser.grade})`));
-    console.log(c('gray', `  ${Math.abs(diff)} point difference — ${Math.abs(diff) > 20 ? 'significant gap' : Math.abs(diff) > 10 ? 'moderate gap' : 'close race'}`));
-  }
-
-  // ─── Issue breakdown comparison ─────────────────────────
-  const allCats = new Set([...Object.keys(resultA.categories), ...Object.keys(resultB.categories)]);
-  if (allCats.size > 0) {
-    console.log('');
-    console.log(c('bold', '  ISSUE BREAKDOWN'));
-    for (const cat of allCats) {
-      const countA = resultA.categories[cat] || 0;
-      const countB = resultB.categories[cat] || 0;
-      const catLabel = cat.charAt(0).toUpperCase() + cat.slice(1);
-      console.log(c('gray', `    ${pad(catLabel, 22)} ${padL(countA, 5)} vs ${padL(countB, 5)}  ${countA < countB ? c('green', `← ${labelA}`) : countA > countB ? c('green', `→ ${labelB}`) : c('gray', 'tied')}`));
-    }
-  }
-
-  console.log('');
-  console.log(c('gray', `  Full scan: npx thuban scan ${paths[0]}`));
-  console.log(c('gray', `  Full scan: npx thuban scan ${paths[1]}`));
-  console.log('');
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-  const opts = parseArgs(args);
-
-  if (!opts.command || opts.command === 'help') {
-    printHelp();
-    process.exit(0);
-  }
-
-  if (opts.command === 'version') {
-    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf-8'));
-    console.log(`thuban v${pkg.version}`);
-    process.exit(0);
-  }
-
-  // Verify target path exists
-  const noPathCommands2 = ['activate', 'status', 'upgrade', 'telemetry', 'compare'];
-
-  if (!noPathCommands2.includes(opts.command) && !opts.targetPath.match(/^(https?:\/\/|git@)/) && !fs.existsSync(opts.targetPath)) {
-    console.error(c('red', `  Error: Path not found: ${opts.targetPath}`));
-    process.exit(1);
-  }
-
-  try {
-    switch (opts.command) {
-      case 'scan':
-        await cmdScan(opts);
-        break;
-      case 'deps':
-        await cmdDeps(opts);
-        break;
-      case 'drift':
-        await cmdDrift(opts);
-        break;
-      case 'inject':
-        await cmdInject(opts);
-        break;
-      case 'health':
-        // Alias for report
-        await cmdReport(opts);
-        break;
-      case 'report':
-        await cmdReport(opts);
-        break;
-      case 'debt':
-        await cmdDebt(opts);
-        break;
-      case 'fix':
-        await cmdFix(opts);
-        break;
-      case 'hallucinate':
-      case 'hal':
-        await cmdHallucinate(opts);
-        break;
-      case 'watch':
-        await cmdWatch(opts);
-        break;
-      case 'monitor':
-        await cmdMonitor(opts);
-        break;
-      case 'history':
-        await cmdHistory(opts);
-        break;
-      case 'trend':
-        await cmdTrend(opts);
-        break;
-      case 'dashboard':
-      case 'dash':
-        await cmdDashboard(opts);
-        break;
-      case 'diff':
-        await cmdDiff(opts);
-        break;
-      case 'activate':
-        await cmdActivate(opts);
-        break;
-      case 'status':
-        await cmdStatus(opts);
-        break;
-      case 'upgrade':
-        cmdUpgrade();
-        break;
-      case 'gate':
-        await cmdGate(opts);
-        break;
-      case 'cost':
-        await cmdCost(opts);
-        break;
-      case 'ghosts':
-        await cmdGhosts(opts);
-        break;
-      case 'ai-score':
-      case 'aiscore':
-        await cmdAIScore(opts);
-        break;
-      case 'clones':
-      case 'duplicates':
-        await cmdClones(opts);
-        break;
-      case 'passport':
-        await cmdPassport(opts);
-        break;
-      case 'executive':
-      case 'exec-report':
-      case 'pdf':
-        await cmdExecutive(opts);
-        break;
-      case 'baseline':
-        await cmdBaseline(opts);
-        break;
-      case 'telemetry':
-        await cmdTelemetry(opts);
-        break;
-      case 'compare':
-        await cmdCompare(opts);
-        break;
-      default:
-        console.error('');
-        console.error(c('red', `  Unknown command: ${opts.command}`));
-        console.error('');
-        // Suggest closest match
-        const allCmds = ['scan','compare','deps','drift','inject','health','report','debt','fix','hallucinate','watch','dashboard','diff','gate','cost','ghosts','ai-score','clones','passport','executive','baseline','activate','status','upgrade','telemetry'];
-        const suggestions = allCmds.filter(cmd => cmd.startsWith(opts.command.slice(0,2)) || cmd.includes(opts.command));
-        if (suggestions.length > 0) {
-          console.error(c('gray', `  Did you mean: `) + c('cyan', suggestions.join(', ')) + c('gray', '?'));
-          console.error('');
-        }
-        console.error(c('gray', '  Quick start:'));
-        console.error(`    ${c('cyan', 'npx thuban scan .')}       Scan your project`);
-        console.error(`    ${c('cyan', 'npx thuban --help')}       See all commands`);
-        console.error('');
-        process.exit(1);
-    }
-  } catch (err) {
-    console.error(c('red', `  Error: ${err.message}`));
-    if (opts.verbose) console.error(err.stack);
-    process.exit(1);
-  }
-}
-
-main();