@nerviq/cli 1.8.1 → 1.8.4

package/bin/cli.js

@@ -1,1614 +1,1879 @@
-#!/usr/bin/env node
-
-const { audit } = require('../src/audit');
-const { setup } = require('../src/setup');
-const { analyzeProject, printAnalysis, exportMarkdown } = require('../src/analyze');
-const { buildProposalBundle, printProposalBundle, writePlanFile, applyProposalBundle, printApplyResult } = require('../src/plans');
-const { getGovernanceSummary, printGovernanceSummary, ensureWritableProfile, renderGovernanceMarkdown } = require('../src/governance');
-const { runBenchmark, printBenchmark, writeBenchmarkReport } = require('../src/benchmark');
-const { writeSnapshotArtifact, recordRecommendationOutcome, formatRecommendationOutcomeSummary, getRecommendationOutcomeSummary } = require('../src/activity');
-const { collectFeedback } = require('../src/feedback');
-const { startServer } = require('../src/server');
-const { auditWorkspaces } = require('../src/workspace');
-const { scanOrg } = require('../src/org');
-const { detectAntiPatterns, printAntiPatterns, printAntiPatternCatalog } = require('../src/anti-patterns');
-const { VERIFICATION_DATES, getVerificationDate, getVerificationStats } = require('../src/verification-metadata');
-const { version } = require('../package.json');
-
-const args = process.argv.slice(2);
-const COMMAND_ALIASES = {
-  review: 'deep-review',
-  wizard: 'interactive',
-  learn: 'insights',
-  discover: 'audit',
-  starter: 'setup',
-  suggest: 'suggest-only',
-  gov: 'governance',
-  outcome: 'feedback',
-};
-const KNOWN_COMMANDS = ['audit', 'org', 'setup', 'init', 'augment', 'suggest-only', 'plan', 'apply', 'fix', 'rollback', 'governance', 'benchmark', 'deep-review', 'interactive', 'watch', 'badge', 'insights', 'history', 'compare', 'trend', 'scan', 'feedback', 'doctor', 'convert', 'migrate', 'catalog', 'certify', 'serve', 'check-health', 'dashboard', 'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise', 'harmony-watch', 'harmony-governance', 'harmony-add', 'synergy-report', 'anti-patterns', 'rules-export', 'freshness', 'help', 'version'];
-
-function levenshtein(a, b) {
-  const matrix = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
-  for (let i = 0; i <= a.length; i++) matrix[i][0] = i;
-  for (let j = 0; j <= b.length; j++) matrix[0][j] = j;
-  for (let i = 1; i <= a.length; i++) {
-    for (let j = 1; j <= b.length; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      matrix[i][j] = Math.min(
-        matrix[i - 1][j] + 1,
-        matrix[i][j - 1] + 1,
-        matrix[i - 1][j - 1] + cost
-      );
-    }
-  }
-  return matrix[a.length][b.length];
-}
-
-function suggestCommand(input) {
-  const candidates = [...KNOWN_COMMANDS, ...Object.keys(COMMAND_ALIASES)];
-  let best = null;
-  let bestDistance = Infinity;
-  for (const candidate of candidates) {
-    const distance = levenshtein(input, candidate);
-    if (distance < bestDistance) {
-      best = candidate;
-      bestDistance = distance;
-    }
-  }
-  return bestDistance <= 3 ? best : null;
-}
-
-function parseArgs(rawArgs) {
-  const flags = [];
-  let command = 'audit';
-  let threshold = null;
-  let out = null;
-  let planFile = null;
-  let only = [];
-  let profile = 'safe-write';
-  let mcpPacks = [];
-  let requireChecks = [];
-  let feedbackKey = null;
-  let feedbackStatus = null;
-  let feedbackEffect = null;
-  let feedbackNotes = null;
-  let feedbackSource = null;
-  let feedbackScoreDelta = null;
-  let platform = 'claude';
-  let format = null;
-  let port = null;
-  let workspace = null;
-  let webhookUrl = null;
-  let commandSet = false;
-  let extraArgs = [];
-  let convertFrom = null;
-  let convertTo = null;
-  let migrateFrom = null;
-  let migrateTo = null;
-  let checkVersion = null;
-  let external = null;
-  let repos = [];
-
-  for (let i = 0; i < rawArgs.length; i++) {
-    const arg = rawArgs[i];
-
-    if (arg === '--threshold' || arg === '--out' || arg === '--plan' || arg === '--only' || arg === '--profile' || arg === '--mcp-pack' || arg === '--require' || arg === '--key' || arg === '--status' || arg === '--effect' || arg === '--notes' || arg === '--source' || arg === '--score-delta' || arg === '--platform' || arg === '--format' || arg === '--from' || arg === '--to' || arg === '--port' || arg === '--workspace' || arg === '--check-version' || arg === '--webhook' || arg === '--external') {
-      const value = rawArgs[i + 1];
-      if (!value || value.startsWith('--')) {
-        throw new Error(`${arg} requires a value`);
-      }
-      if (arg === '--threshold') threshold = value;
-      if (arg === '--out') out = value;
-      if (arg === '--plan') planFile = value;
-      if (arg === '--only') only = value.split(',').map(item => item.trim()).filter(Boolean);
-      if (arg === '--profile') profile = value.trim();
-      if (arg === '--mcp-pack') mcpPacks = value.split(',').map(item => item.trim()).filter(Boolean);
-      if (arg === '--require') requireChecks = value.split(',').map(item => item.trim()).filter(Boolean);
-      if (arg === '--key') feedbackKey = value.trim();
-      if (arg === '--status') feedbackStatus = value.trim();
-      if (arg === '--effect') feedbackEffect = value.trim();
-      if (arg === '--notes') feedbackNotes = value;
-      if (arg === '--source') feedbackSource = value.trim();
-      if (arg === '--score-delta') feedbackScoreDelta = value.trim();
-      if (arg === '--platform') platform = value.trim().toLowerCase();
-      if (arg === '--format') format = value.trim().toLowerCase();
-      if (arg === '--from') { convertFrom = value.trim(); migrateFrom = value.trim(); }
-      if (arg === '--to') { convertTo = value.trim(); migrateTo = value.trim(); }
-      if (arg === '--port') port = value.trim();
-      if (arg === '--workspace') workspace = value.trim();
-      if (arg === '--check-version') checkVersion = value.trim();
-      if (arg === '--webhook') webhookUrl = value.trim();
-      if (arg === '--external') external = value.trim();
-      i++;
-      continue;
-    }
-
-    if (arg.startsWith('--external=')) {
-      external = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg === '--repos') {
-      // Collect all following non-flag args as repo paths (supports comma-separated too)
-      while (i + 1 < rawArgs.length && !rawArgs[i + 1].startsWith('--')) {
-        i++;
-        repos.push(...rawArgs[i].split(',').map(s => s.trim()).filter(Boolean));
-      }
-      if (repos.length === 0) throw new Error('--repos requires at least one path');
-      continue;
-    }
-
-    if (arg.startsWith('--repos=')) {
-      repos = arg.split('=').slice(1).join('=').split(',').map(s => s.trim()).filter(Boolean);
-      if (repos.length === 0) throw new Error('--repos requires at least one path');
-      continue;
-    }
-
-    if (arg.startsWith('--require=')) {
-      requireChecks = arg.split('=').slice(1).join('=').split(',').map(item => item.trim()).filter(Boolean);
-      continue;
-    }
-
-    if (arg.startsWith('--threshold=')) {
-      threshold = arg.split('=')[1];
-      continue;
-    }
-
-    if (arg.startsWith('--out=')) {
-      out = arg.split('=').slice(1).join('=');
-      continue;
-    }
-
-    if (arg.startsWith('--plan=')) {
-      planFile = arg.split('=').slice(1).join('=');
-      continue;
-    }
-
-    if (arg.startsWith('--only=')) {
-      only = arg.split('=').slice(1).join('=').split(',').map(item => item.trim()).filter(Boolean);
-      continue;
-    }
-
-    if (arg.startsWith('--profile=')) {
-      profile = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--mcp-pack=')) {
-      mcpPacks = arg.split('=').slice(1).join('=').split(',').map(item => item.trim()).filter(Boolean);
-      continue;
-    }
-
-    if (arg.startsWith('--key=')) {
-      feedbackKey = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--status=')) {
-      feedbackStatus = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--effect=')) {
-      feedbackEffect = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--notes=')) {
-      feedbackNotes = arg.split('=').slice(1).join('=');
-      continue;
-    }
-
-    if (arg.startsWith('--source=')) {
-      feedbackSource = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--score-delta=')) {
-      feedbackScoreDelta = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--platform=')) {
-      platform = arg.split('=').slice(1).join('=').trim().toLowerCase();
-      continue;
-    }
-
-    if (arg.startsWith('--format=')) {
-      format = arg.split('=').slice(1).join('=').trim().toLowerCase();
-      continue;
-    }
-
-    if (arg.startsWith('--port=')) {
-      port = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--workspace=')) {
-      workspace = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--check-version=')) {
-      checkVersion = arg.split('=').slice(1).join('=').trim();
-      continue;
-    }
-
-    if (arg.startsWith('--')) {
-      flags.push(arg);
-      continue;
-    }
-
-    if (!commandSet) {
-      command = arg;
-      commandSet = true;
-    } else {
-      extraArgs.push(arg);
-    }
-  }
-
-  const normalizedCommand = COMMAND_ALIASES[command] || command;
-
-  return { flags, command, normalizedCommand, threshold, out, planFile, only, profile, mcpPacks, requireChecks, feedbackKey, feedbackStatus, feedbackEffect, feedbackNotes, feedbackSource, feedbackScoreDelta, platform, format, port, workspace, extraArgs, convertFrom, convertTo, migrateFrom, migrateTo, checkVersion, webhookUrl, external, repos };
-}
-
-function printWorkspaceSummary(summary, options) {
-  if (options.json) {
-    console.log(JSON.stringify(summary, null, 2));
-    return;
-  }
-
-  console.log('');
-  console.log('\x1b[1m  nerviq workspace audit\x1b[0m');
-  console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
-  console.log(`  Root: ${summary.rootDir}`);
-  console.log(`  Platform: ${summary.platform}`);
-  console.log(`  Workspaces: ${summary.workspaceCount}`);
-  console.log(`  Average score: \x1b[1m${summary.averageScore}/100\x1b[0m`);
-  console.log('');
-  console.log('\x1b[1m  Workspace                  Score  Pass  Total  Top action\x1b[0m');
-  console.log('  ' + '─'.repeat(72));
-  for (const item of summary.workspaces) {
-    const score = item.score === null ? 'ERR' : String(item.score);
-    const topAction = item.error || item.topAction || '-';
-    console.log(`  ${item.workspace.padEnd(26)} ${score.padStart(5)} ${String(item.passed).padStart(5)} ${String(item.total).padStart(6)}  ${topAction}`);
-  }
-  console.log('');
-}
-
-function printOrgSummary(summary, options) {
-  if (options.json) {
-    console.log(JSON.stringify(summary, null, 2));
-    return;
-  }
-
-  console.log('');
-  console.log('\x1b[1m  nerviq org scan\x1b[0m');
-  console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
-  console.log(`  Platform: ${summary.platform}`);
-  console.log(`  Repos: ${summary.repoCount}`);
-  console.log(`  Average score: \x1b[1m${summary.averageScore}/100\x1b[0m`);
-  console.log('');
-  console.log('\x1b[1m  Repo              Platform  Score  Top action\x1b[0m');
-  console.log('  ' + '─'.repeat(72));
-  for (const item of summary.repos) {
-    const score = item.score === null ? 'ERR' : String(item.score);
-    const topAction = item.error || item.topAction || '-';
-    console.log(`  ${item.name.padEnd(18)} ${item.platform.padEnd(8)} ${score.padStart(5)}  ${topAction}`);
-  }
-  console.log('');
-}
-
-const HELP = `
-  nerviq v${version}
-  The intelligent nervous system for AI coding agents.
-  Audit, align, and amplify every platform on every project.
-
-  DISCOVER
-    nerviq audit                  Quick scan: score + top 3 gaps (default)
-    nerviq audit --full           Full audit with all checks, weakest areas, badge
-    nerviq audit --platform X     Audit specific platform (claude|codex|cursor|copilot|gemini|windsurf|aider|opencode)
-    nerviq audit --json           Machine-readable JSON output (for CI)
-    nerviq audit --workspace packages/*     Audit each workspace in a monorepo
-    nerviq scan dir1 dir2         Compare multiple repos side-by-side
-    nerviq org scan dir1 dir2     Aggregate multiple repos into one score table
-    nerviq catalog                Full check catalog (all 8 platforms)
-    nerviq catalog --json         Export full check catalog as JSON
-    nerviq anti-patterns          Detect anti-patterns in current project
-    nerviq anti-patterns --all    Show full anti-pattern catalog
-
-  SETUP
-    nerviq setup                  Generate starter-safe baseline config files
-    nerviq setup --auto           Apply all generated files without prompts
-    nerviq interactive            Step-by-step guided wizard
-    nerviq check-health           Detect regressions + platform format changes between snapshots
-    nerviq doctor                 Self-diagnostics: Node, deps, freshness, platform detection
-
-  FIX
-    nerviq fix                    Show fixable checks and manual-fix guidance
-    nerviq fix <key>              Auto-fix a specific check (with score impact)
-    nerviq fix --all-critical     Fix all critical issues at once
-    nerviq fix --dry-run          Preview fixes without writing
-    nerviq fix --auto             Apply fixes without confirmation prompt
-    nerviq rollback               Undo the most recent apply (delete created files)
-    nerviq rollback --list        Show available rollback points
-    nerviq rollback --dry-run     Preview what would be deleted
-
-  IMPROVE
-    nerviq augment                Improvement plan (no writes)
-    nerviq suggest-only           Structured report for sharing (no writes)
-    nerviq plan                   Export proposal bundles with diffs
-    nerviq plan --out plan.json   Save plan to file
-    nerviq apply                  Apply proposals selectively with rollback
-    nerviq apply --dry-run        Preview changes without writing
-
-  GOVERN
-    nerviq governance             Permission profiles + hooks + policy packs
-    nerviq governance --json      Machine-readable governance summary
-    nerviq benchmark              Before/after score in isolated temp copy
-    nerviq benchmark --external /path  Benchmark an external repo
-    nerviq freshness              Show verification freshness for all checks
-    nerviq certify                Generate certification badge for your project
-
-  CROSS-PLATFORM
-    nerviq harmony-audit          Drift detection across all active platforms
-    nerviq harmony-sync           Preview cross-platform sync (dry run)
-    nerviq harmony-sync --fix     Apply cross-platform sync (write files)
-    nerviq harmony-sync --json    JSON output for CI/automation
-    nerviq harmony-add <platform>  Add a new platform to the project
-    nerviq synergy-report         Multi-agent amplification opportunities
-    nerviq convert --from X --to Y   Convert configs between platforms
-    nerviq migrate --platform X   Platform version migration helper
-    nerviq migrate --platform cursor --from v2 --to v3
-
-  MONITOR
-    nerviq dashboard              Generate static HTML dashboard report
-    nerviq dashboard --out F      Save dashboard to custom file
-    nerviq dashboard --open       Open dashboard in browser after generating
-    nerviq watch                  Live config monitoring (re-audits on file change)
-    nerviq history                Score history from saved snapshots
-    nerviq compare                Latest vs previous snapshot diff
-    nerviq trend                  Score trend over time
-    nerviq trend --out report.md  Export trend report as markdown
-    nerviq feedback               Record recommendation outcomes
-
-  ADVANCED
-    nerviq deep-review            AI-powered config review (opt-in, uses API key)
-    nerviq serve --port 3000      Start local Nerviq REST API server
-    nerviq badge                  Generate shields.io badge markdown
-    nerviq rules-export           Export recommendation rules as JSON
-    nerviq rules-export --out F   Save rules to file
-
-  OPTIONS
-    --platform NAME   Platform: claude (default), codex, cursor, copilot, gemini, windsurf, aider, opencode
-    --threshold N     Exit code 1 if score < N  (CI gate)
-    --require A,B     Exit code 1 if named checks fail
-    --out FILE        Write output to file (JSON or markdown)
-    --plan FILE       Load previously exported plan file
-    --only A,B        Limit plan/apply to selected proposal IDs
-    --profile NAME    Permission profile: read-only | suggest-only | safe-write | power-user
-    --mcp-pack A,B    Merge MCP packs into setup (e.g. context7-docs,next-devtools)
-    --check-version V Pin catalog to a specific version (warn on mismatch)
-    --format NAME     Output format: json | sarif | otel
-    --webhook URL     Send audit results to a webhook (Slack/Discord/generic JSON)
-    --external PATH   Benchmark an external repo instead of cwd
-    --port N          Port for \`serve\` (default: 3000)
-    --workspace GLOBS Audit workspaces separately (e.g. packages/* or apps/web,apps/api)
-    --snapshot        Save snapshot artifact under .claude/nerviq/snapshots/
-    --full            Show full audit output (all checks, weakest areas, badge)
-    --lite            Short top-3 scan (default behavior since v1.5.2)
-    --dry-run         Preview changes without writing files
-    --config-only     Only write config files (.claude/, rules, hooks) — never source code
-    --verbose         Full audit + medium-priority recommendations
-    --show-deprecated Show deprecated checks (excluded from scoring)
-    --json            Output as JSON
-    --auto            Apply all generated files without prompting
-    --key NAME        Feedback: recommendation key (e.g. permissionDeny)
-    --status VALUE    Feedback: accepted | rejected | deferred
-    --effect VALUE    Feedback: positive | neutral | negative
-    --score-delta N   Feedback: observed score delta
-    --help            Show this help
-    --version         Show version
-
-  EXAMPLES
-    npx nerviq
-    npx nerviq --lite
-    npx nerviq --platform cursor
-    npx nerviq audit --workspace packages/*
-    npx nerviq --platform codex augment
-    npx nerviq org scan ./app ./api ./infra
-    npx nerviq scan ./app ./api ./infra
-    npx nerviq harmony-audit
-    npx nerviq convert --from claude --to codex
-    npx nerviq migrate --platform cursor --from v2 --to v3
-    npx nerviq setup --mcp-pack context7-docs
-    npx nerviq apply --plan plan.json --only hooks,commands
-    npx nerviq serve --port 4000
-    npx nerviq --json --threshold 70
-    npx nerviq catalog --json --out catalog.json
-    npx nerviq feedback --key permissionDeny --status accepted --effect positive
-
-  EXIT CODES
-    0  Success
-    1  Error, unknown command, or score below --threshold
-`;
-
-async function main() {
-  let parsed;
-  try {
-    parsed = parseArgs(args);
-  } catch (err) {
-    console.error(`\n  Error: ${err.message}\n`);
-    process.exit(1);
-  }
-
-  const { flags, command, normalizedCommand } = parsed;
-
-  if (flags.includes('--help') || command === 'help') {
-    console.log(HELP);
-    process.exit(0);
-  }
-
-  if (flags.includes('--version') || command === 'version') {
-    console.log(version);
-    process.exit(0);
-  }
-
-  const options = {
-    verbose: flags.includes('--verbose'),
-    json: flags.includes('--json'),
-    auto: flags.includes('--auto'),
-    lite: flags.includes('--full') || flags.includes('--verbose') ? false : true,
-    full: flags.includes('--full'),
-    showDeprecated: flags.includes('--show-deprecated'),
-    snapshot: flags.includes('--snapshot'),
-    feedback: flags.includes('--feedback'),
-    fix: flags.includes('--fix'),
-    autoSync: flags.includes('--auto-sync'),
-    dryRun: flags.includes('--dry-run'),
-    configOnly: flags.includes('--config-only'),
-    threshold: parsed.threshold !== null ? Number(parsed.threshold) : null,
-    out: parsed.out,
-    planFile: parsed.planFile,
-    only: parsed.only,
-    profile: parsed.profile,
-    mcpPacks: parsed.mcpPacks,
-    require: parsed.requireChecks,
-    platform: parsed.platform || 'claude',
-    format: parsed.format || null,
-    port: parsed.port !== null ? Number(parsed.port) : null,
-    workspace: parsed.workspace || null,
-    webhookUrl: parsed.webhookUrl || null,
-    external: parsed.external || null,
-    dir: process.cwd()
-  };
-
-  if (parsed.checkVersion) {
-    if (parsed.checkVersion !== version) {
-      console.error(`\n  Warning: --check-version ${parsed.checkVersion} does not match installed nerviq version ${version}.`);
-      console.error(`  Check catalog may differ between versions. To align, run: npm install @nerviq/cli@${parsed.checkVersion}`);
-      console.error('');
-    }
-    options.checkVersion = parsed.checkVersion;
-  }
-
-  const SUPPORTED_PLATFORMS = ['claude', 'codex', 'gemini', 'copilot', 'cursor', 'windsurf', 'aider', 'opencode'];
-  if (!SUPPORTED_PLATFORMS.includes(options.platform)) {
-    console.error(`\n  Error: Unsupported platform '${options.platform}'.`);
-    console.error(`  Why: Only the following platforms are supported: ${SUPPORTED_PLATFORMS.join(', ')}.`);
-    console.error(`  Fix: Use --platform with one of the supported values, e.g.: npx nerviq --platform claude`);
-    console.error('  Docs: https://github.com/nerviq/nerviq#cross-platform\n');
-    process.exit(1);
-  }
-
-  if (options.format !== null && !['json', 'sarif', 'otel'].includes(options.format)) {
-    console.error(`\n  Error: Unsupported format '${options.format}'. Use 'json', 'sarif', or 'otel'.\n`);
-    process.exit(1);
-  }
-
-  if (options.port !== null && (!Number.isInteger(options.port) || options.port < 0 || options.port > 65535)) {
-    console.error('\n  Error: --port must be an integer between 0 and 65535.\n');
-    process.exit(1);
-  }
-
-  if (options.threshold !== null && (!Number.isFinite(options.threshold) || options.threshold < 0 || options.threshold > 100)) {
-    console.error(`\n  Error: Invalid threshold value '${parsed.threshold}'.`);
-    console.error('  Why: --threshold must be a number between 0 and 100 representing the minimum passing score.');
-    console.error('  Fix: Use a valid number, e.g.: npx nerviq --threshold 70');
-    console.error('  Docs: https://github.com/nerviq/nerviq#ci-integration\n');
-    process.exit(1);
-  }
-
-  if (options.require && options.require.length > 0 && normalizedCommand !== 'audit' && !['audit', 'discover'].includes(command)) {
-    console.error(`\n  Warning: --require is only supported with the audit command. Ignoring for '${normalizedCommand}'.\n`);
-  }
-
-  if (!KNOWN_COMMANDS.includes(normalizedCommand)) {
-    const suggestion = suggestCommand(command);
-    console.error(`\n  Error: Unknown command '${command}'.`);
-    console.error(`  Why: '${command}' is not a recognized nerviq command or alias.`);
-    if (suggestion) {
-      console.error(`  Fix: Did you mean '${suggestion}'? Run: npx nerviq ${suggestion}`);
-    } else {
-      console.error('  Fix: Run nerviq --help to see all available commands.');
-    }
-    console.error('  Docs: https://github.com/nerviq/nerviq#readme\n');
-    process.exit(1);
-  }
-
-  if (!require('fs').existsSync(options.dir)) {
-    console.error(`\n  Error: Directory not found: ${options.dir}`);
-    console.error('  Why: The current working directory does not exist or is not accessible.');
-    console.error('  Fix: cd into your project directory first, then run nerviq.');
-    console.error('  Docs: https://github.com/nerviq/nerviq#getting-started\n');
-    process.exit(1);
-  }
-
-  if (['setup', 'apply', 'benchmark'].includes(normalizedCommand)) {
-    try {
-      ensureWritableProfile(options.profile, normalizedCommand, options.dryRun);
-    } catch (err) {
-      console.error(`\n  Error: ${err.message}\n`);
-      process.exit(1);
-    }
-  }
-
-  try {
-    const FULL_COMMAND_SET = new Set([
-      'audit', 'org', 'scan', 'badge', 'augment', 'suggest-only', 'setup', 'plan', 'apply',
-      'governance', 'benchmark', 'deep-review', 'interactive', 'watch', 'insights',
-      'history', 'compare', 'trend', 'feedback', 'catalog', 'certify', 'serve', 'help', 'version',
-      // Harmony + Synergy (cross-platform)
-      'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise',
-      'harmony-watch', 'harmony-governance', 'harmony-add', 'synergy-report', 'anti-patterns', 'rules-export',
-      'freshness',
-    ]);
-
-    if (options.platform === 'codex') {
-      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
-        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform codex.`);
-        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
-        process.exit(1);
-      }
-    }
-
-    if (options.platform === 'gemini') {
-      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
-        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform gemini.`);
-        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
-        process.exit(1);
-      }
-    }
-
-    if (options.platform === 'copilot') {
-      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
-        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform copilot.`);
-        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
-        process.exit(1);
-      }
-    }
-
-    if (options.platform === 'cursor') {
-      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
-        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform cursor.`);
-        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
-        process.exit(1);
-      }
-    }
-
-    for (const plat of ['windsurf', 'aider', 'opencode']) {
-      if (options.platform === plat) {
-        if (!FULL_COMMAND_SET.has(normalizedCommand)) {
-          console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform ${plat}.`);
-          console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
-          process.exit(1);
-        }
-      }
-    }
-
-    if (normalizedCommand === 'scan') {
-      const scanDirs = parsed.extraArgs;
-      if (scanDirs.length === 0) {
-        console.error('\n  Error: scan requires at least one directory argument.');
-        console.error('  Usage: npx nerviq scan dir1 dir2 dir3\n');
-        process.exit(1);
-      }
-      const summary = await scanOrg(scanDirs, options.platform);
-      printOrgSummary(summary, options);
-      if (options.threshold !== null && summary.averageScore < options.threshold) {
-        process.exit(1);
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'org') {
-      const subcommand = parsed.extraArgs[0];
-      const scanDirs = parsed.extraArgs.slice(1);
-      if (subcommand !== 'scan' || scanDirs.length === 0) {
-        console.error('\n  Error: org requires the scan subcommand and at least one directory.');
-        console.error('  Usage: npx nerviq org scan dir1 dir2 dir3\n');
-        process.exit(1);
-      }
-      const summary = await scanOrg(scanDirs, options.platform);
-      printOrgSummary(summary, options);
-      if (options.threshold !== null && summary.averageScore < options.threshold) {
-        process.exit(1);
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'history') {
-      const { formatHistory, readSnapshotIndex } = require('../src/activity');
-      // Handle --prune N
-      const pruneIdx = flags.indexOf('--prune');
-      if (pruneIdx >= 0) {
-        const keepCount = parseInt(flags[pruneIdx + 1] || parsed.extraArgs[0], 10) || 10;
-        const fsMod = require('fs');
-        const pathMod = require('path');
-        const entries = readSnapshotIndex(options.dir);
-        if (entries.length <= keepCount) {
-          console.log(`\n  Nothing to prune (${entries.length} snapshots, keeping ${keepCount}).\n`);
-        } else {
-          const toRemove = entries.slice(0, entries.length - keepCount);
-          let removed = 0;
-          for (const entry of toRemove) {
-            const fp = pathMod.join(options.dir, entry.relativePath);
-            try { fsMod.unlinkSync(fp); removed++; } catch {}
-          }
-          const kept = entries.slice(entries.length - keepCount);
-          const indexPath = pathMod.join(options.dir, '.nerviq', 'snapshots', 'index.json');
-          try { fsMod.writeFileSync(indexPath, JSON.stringify(kept, null, 2), 'utf8'); } catch {}
-          console.log(`\n  Pruned ${removed} snapshots, kept ${kept.length}.\n`);
-        }
-        process.exit(0);
-      }
-      console.log('');
-      console.log(formatHistory(options.dir));
-      console.log('');
-      process.exit(0);
-    } else if (normalizedCommand === 'compare') {
-      const { compareLatest } = require('../src/activity');
-      const result = compareLatest(options.dir);
-      if (!result) {
-        console.log('\n  Need at least 2 snapshots to compare. Run `npx nerviq --snapshot` twice.\n');
-        process.exit(0);
-      }
-      if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        const sign = result.delta.score >= 0 ? '+' : '';
-        console.log('');
-        console.log(`  Previous: ${result.previous.score}/100 (${result.previous.date?.split('T')[0]})`);
-        console.log(`  Current:  ${result.current.score}/100 (${result.current.date?.split('T')[0]})`);
-        console.log(`  Delta:    ${sign}${result.delta.score} points`);
-        console.log(`  Trend:    ${result.trend}`);
-        if (result.improvements.length > 0) console.log(`  Fixed:    ${result.improvements.join(', ')}`);
-        if (result.regressions.length > 0) console.log(`  New gaps: ${result.regressions.join(', ')}`);
-        console.log('');
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'trend') {
-      const { exportTrendReport } = require('../src/activity');
-      const report = exportTrendReport(options.dir);
-      if (!report) {
-        console.log('\n  No snapshots found. Run `npx nerviq --snapshot` to start tracking.\n');
-        process.exit(0);
-      }
-      if (options.out) {
-        require('fs').writeFileSync(options.out, report, 'utf8');
-        console.log(`\n  Trend report exported to ${options.out}\n`);
-      } else {
-        console.log(report);
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'badge') {
-      const { getBadgeMarkdown } = require('../src/badge');
-      const result = await audit({ ...options, silent: true });
-      console.log(getBadgeMarkdown(result.score));
-      console.log('');
-      console.log('Add this to your README.md');
-      process.exit(0);
-    } else if (normalizedCommand === 'insights') {
-      const https = require('https');
-      const url = 'https://claudex-insights.claudex.workers.dev/v1/stats';
-      const req = https.get(url, (res) => {
-        let data = '';
-        res.on('data', chunk => data += chunk);
-        res.on('end', () => {
-          try {
-            const stats = JSON.parse(data);
-            console.log('');
-            console.log('\x1b[1m  CLAUDEX Community Insights\x1b[0m');
-            console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
-            console.log(`  Total audits run: \x1b[1m${stats.totalRuns}\x1b[0m`);
-            console.log(`  Average score: \x1b[1m${stats.averageScore}/100\x1b[0m`);
-            console.log('');
-            if (stats.topFailedChecks && stats.topFailedChecks.length > 0) {
-              console.log('\x1b[33m  Most common gaps:\x1b[0m');
-              for (const f of stats.topFailedChecks.slice(0, 5)) {
-                console.log(`     ${f.pct}% miss: \x1b[1m${f.check}\x1b[0m`);
-              }
-              console.log('');
-            }
-            if (stats.topStacks && stats.topStacks.length > 0) {
-              console.log('\x1b[36m  Popular stacks:\x1b[0m');
-              console.log(`     ${stats.topStacks.map(s => s.stack).join(', ')}`);
-            }
-            console.log('');
-          } catch (e) {
-            console.log('  No community data available yet. Be the first to run: npx nerviq');
-          }
-        });
-      }).on('error', () => {
-        console.log('  Could not reach insights server. Run locally: npx nerviq');
-      });
-      req.setTimeout(10000, () => {
-        req.destroy();
-        console.log('  Insights request timed out. Run locally: npx nerviq');
-      });
-      return; // keep process alive for http
-    } else if (normalizedCommand === 'feedback') {
-      if (parsed.feedbackKey) {
-        if (!parsed.feedbackStatus) {
-          console.error('\n  Error: feedback logging requires --status when --key is provided.\n');
-          process.exit(1);
-        }
-        const artifact = recordRecommendationOutcome(options.dir, {
-          key: parsed.feedbackKey,
-          status: parsed.feedbackStatus,
-          effect: parsed.feedbackEffect || 'neutral',
-          notes: parsed.feedbackNotes || '',
-          source: parsed.feedbackSource || 'manual-cli',
-          scoreDelta: parsed.feedbackScoreDelta !== null ? Number(parsed.feedbackScoreDelta) : null,
-        });
-        const summary = getRecommendationOutcomeSummary(options.dir);
-        if (options.json) {
-          console.log(JSON.stringify({ artifact, summary }, null, 2));
-        } else {
-          console.log('');
-          console.log(`  Feedback recorded for ${parsed.feedbackKey}`);
-          console.log(`  Artifact: ${artifact.relativePath}`);
-          console.log('');
-          console.log(formatRecommendationOutcomeSummary(options.dir));
-          console.log('');
-        }
-      } else {
-        if (options.json) {
-          console.log(JSON.stringify(getRecommendationOutcomeSummary(options.dir), null, 2));
-        } else {
-          console.log('');
-          console.log(formatRecommendationOutcomeSummary(options.dir));
-          console.log('');
-        }
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'augment' || normalizedCommand === 'suggest-only') {
-      const report = await analyzeProject({ ...options, mode: normalizedCommand });
-      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, normalizedCommand, report, {
-        sourceCommand: normalizedCommand,
-      }) : null;
-      if (options.out && !options.json) {
-        const fs = require('fs');
-        const md = exportMarkdown(report);
-        fs.writeFileSync(options.out, md, 'utf8');
-        console.log(`\n  Report exported to ${options.out}\n`);
-      }
-      printAnalysis(report, options);
-      if (snapshot && !options.json) {
-        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
-        console.log(`  Snapshot index: ${snapshot.indexPath}`);
-        console.log('');
-      }
-    } else if (normalizedCommand === 'plan') {
-      const bundle = await buildProposalBundle(options);
-      let artifact = null;
-      if (options.out) {
-        artifact = writePlanFile(bundle, options.out);
-      }
-      printProposalBundle(bundle, options);
-      if (options.out && !options.json) {
-        console.log(`  Plan written to ${options.out}`);
-        if (artifact) {
-          console.log(`  Activity log: ${artifact.relativePath}`);
-        }
-        console.log('');
-      }
-    } else if (normalizedCommand === 'rollback') {
-      const fsMod = require('fs');
-      const pathMod = require('path');
-      const rollbackDir = pathMod.join(options.dir, '.nerviq', 'rollbacks');
-
-      if (!fsMod.existsSync(rollbackDir)) {
-        console.log('\n  No rollback artifacts found. Run `nerviq apply` first to create rollback data.\n');
-        process.exit(0);
-      }
-
-      const rollbackFiles = fsMod.readdirSync(rollbackDir)
-        .filter(f => f.endsWith('.json'))
-        .sort()
-        .reverse();
-
-      if (rollbackFiles.length === 0) {
-        console.log('\n  No rollback artifacts found.\n');
-        process.exit(0);
-      }
-
-      // --list mode
-      if (flags.includes('--list')) {
-        console.log(`\n  Rollback points (${rollbackFiles.length}):\n`);
-        for (const f of rollbackFiles) {
-          try {
-            const data = JSON.parse(fsMod.readFileSync(pathMod.join(rollbackDir, f), 'utf8'));
-            const created = (data.createdFiles || []).length;
-            const patched = (data.patchedFiles || []).length;
-            console.log(`  ${f.replace('.json', '')}  (${created} created, ${patched} patched)`);
-          } catch {
-            console.log(`  ${f}  (unreadable)`);
-          }
-        }
-        console.log(`\n  Run \`nerviq rollback\` to undo the most recent.\n`);
-        process.exit(0);
-      }
-
-      // Execute rollback of most recent
-      const latestFile = rollbackFiles[0];
-      const latestPath = pathMod.join(rollbackDir, latestFile);
-      let rollbackData;
-      try {
-        rollbackData = JSON.parse(fsMod.readFileSync(latestPath, 'utf8'));
-      } catch (e) {
-        console.error(`\n  Error: Cannot parse rollback file: ${e.message}\n`);
-        process.exit(1);
-      }
-
-      const createdFiles = rollbackData.createdFiles || [];
-      if (createdFiles.length === 0) {
-        console.log('\n  Rollback artifact has no files to remove.\n');
-        process.exit(0);
-      }
-
-      if (options.dryRun) {
-        console.log(`\n  [dry-run] Would delete ${createdFiles.length} files:\n`);
-        for (const f of createdFiles) {
-          console.log(`    - ${f}`);
-        }
-        console.log('');
-        process.exit(0);
-      }
-
-      let deleted = 0;
-      let missing = 0;
-      console.log('');
-      for (const relPath of createdFiles) {
-        const fullPath = pathMod.join(options.dir, relPath);
-        if (fsMod.existsSync(fullPath)) {
-          fsMod.unlinkSync(fullPath);
-          console.log(`  🗑️  Deleted: ${relPath}`);
-          deleted++;
-        } else {
-          missing++;
-        }
-      }
-
-      // Remove rollback artifact after use
-      fsMod.unlinkSync(latestPath);
-
-      console.log(`\n  Rollback complete: ${deleted} files deleted${missing > 0 ? `, ${missing} already missing` : ''}.\n`);
-
-    } else if (normalizedCommand === 'apply') {
-      if (flags.includes('--rollback')) {
-        console.error('\n  Error: --rollback is not yet supported as a flag.');
-        console.error('  Why: Rollback artifacts are saved in .nerviq/rollbacks/ but automatic rollback is not implemented yet.');
-        console.error('  Fix: Manually delete the files listed in .nerviq/rollbacks/<latest>.json, or use `nerviq apply --dry-run` to preview before applying.');
-        console.error('  Docs: https://github.com/nerviq/nerviq#rollback\n');
-        process.exit(1);
-      }
-      const result = await applyProposalBundle(options);
-      printApplyResult(result, options);
-    } else if (normalizedCommand === 'governance') {
-      const fs = require('fs');
-      const path = require('path');
-      const summary = getGovernanceSummary(options.platform);
-      if (options.out) {
-        fs.mkdirSync(path.dirname(options.out), { recursive: true });
-        const content = path.extname(options.out).toLowerCase() === '.md'
-          ? renderGovernanceMarkdown(summary)
-          : JSON.stringify(summary, null, 2);
-        fs.writeFileSync(options.out, content, 'utf8');
-      }
-      printGovernanceSummary(summary, options);
-      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, 'governance', summary, {
-        sourceCommand: normalizedCommand,
-      }) : null;
-      if (options.out && !options.json) {
-        console.log(`  Governance report written to ${options.out}`);
-        console.log('');
-      }
-      if (snapshot && !options.json) {
-        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
-        console.log(`  Snapshot index: ${snapshot.indexPath}`);
-        console.log('');
-      }
-    } else if (normalizedCommand === 'benchmark') {
-      const report = await runBenchmark(options);
-      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, 'benchmark', report, {
-        sourceCommand: normalizedCommand,
-      }) : null;
-      if (options.out) {
-        writeBenchmarkReport(report, options.out);
-      }
-      printBenchmark(report, options);
-      if (options.out && !options.json) {
-        console.log(`  Benchmark report written to ${options.out}`);
-        console.log('');
-      }
-      if (snapshot && !options.json) {
-        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
-        console.log(`  Snapshot index: ${snapshot.indexPath}`);
-        console.log('');
-      }
-    } else if (normalizedCommand === 'deep-review') {
-      const { deepReview } = require('../src/deep-review');
-      await deepReview(options);
-    } else if (normalizedCommand === 'interactive') {
-      const { interactive } = require('../src/interactive');
-      await interactive(options);
-    } else if (normalizedCommand === 'watch') {
-      const { watch } = require('../src/watch');
-      await watch(options);
-    } else if (normalizedCommand === 'catalog') {
-      const { generateCatalog, generateCatalogWithVersion, writeCatalogJson } = require('../src/catalog');
-      if (options.out) {
-        const result = writeCatalogJson(options.out);
-        if (options.json) {
-          console.log(JSON.stringify({ path: result.path, count: result.count }));
-        } else {
-          console.log(`\n  Catalog written to ${result.path} (${result.count} checks)\n`);
-        }
-      } else {
-        const catalog = generateCatalog();
-        if (options.json) {
-          const envelope = generateCatalogWithVersion();
-          if (options.checkVersion) envelope.requestedVersion = options.checkVersion;
-          console.log(JSON.stringify(envelope, null, 2));
-        } else {
-          // Print summary table
-          const platforms = {};
-          for (const entry of catalog) {
-            platforms[entry.platform] = (platforms[entry.platform] || 0) + 1;
-          }
-          console.log('');
-          console.log('\x1b[1m  nerviq check catalog\x1b[0m');
-          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
-          console.log(`  Total checks: \x1b[1m${catalog.length}\x1b[0m`);
-          console.log('');
-          for (const [plat, count] of Object.entries(platforms)) {
-            console.log(`    ${plat.padEnd(12)} ${count} checks`);
-          }
-          console.log('');
-          console.log('  Use --json for full output or --out catalog.json to write file.');
-          console.log('');
-        }
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'certify') {
-      const { certifyProject, generateCertBadge } = require('../src/certification');
-      const certResult = await certifyProject(options.dir);
-      if (options.json) {
-        console.log(JSON.stringify(certResult, null, 2));
-      } else {
-        console.log('');
-        console.log('\x1b[1m  nerviq certification\x1b[0m');
-        console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
-        console.log('');
-        console.log(`  Level: \x1b[1m${certResult.level}\x1b[0m`);
-        console.log(`  Harmony Score: ${certResult.harmonyScore}/100`);
-        console.log('');
-        if (Object.keys(certResult.platformScores).length > 0) {
-          console.log('  Platform Scores:');
-          for (const [plat, score] of Object.entries(certResult.platformScores)) {
-            const scoreColor = score >= 70 ? '\x1b[32m' : score >= 40 ? '\x1b[33m' : '\x1b[31m';
-            console.log(`    ${plat.padEnd(12)} ${scoreColor}${score}/100\x1b[0m`);
-          }
-          console.log('');
-        }
-        console.log('  Badge:');
-        console.log(`  ${certResult.badge}`);
-        console.log('');
-        console.log('  Add the badge to your README.md');
-        console.log('');
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'serve') {
-      const server = await startServer({
-        port: options.port == null ? 3000 : options.port,
-        baseDir: options.dir,
-      });
-      const address = server.address();
-      const resolvedPort = address && typeof address === 'object' ? address.port : options.port;
-      console.log('');
-      console.log(`  nerviq API listening on http://127.0.0.1:${resolvedPort}`);
-      console.log('  Endpoints: /api/health, /api/catalog, /api/audit, /api/harmony');
-      console.log('');
-
-      const closeServer = () => {
-        server.close(() => process.exit(0));
-      };
-
-      process.on('SIGINT', closeServer);
-      process.on('SIGTERM', closeServer);
-      return;
-    } else if (normalizedCommand === 'harmony-audit') {
-      const { runHarmonyAudit } = require('../src/harmony/cli');
-      await runHarmonyAudit(options);
-      process.exit(0);
-    } else if (normalizedCommand === 'harmony-sync') {
-      const { previewHarmonySync, applyHarmonySync } = require('../src/harmony/sync');
-      const dir = options.dir || process.cwd();
-
-      if (options.fix) {
-        // Apply mode: write files
-        const result = applyHarmonySync(dir);
-        if (options.json) {
-          console.log(JSON.stringify(result, null, 2));
-        } else {
-          console.log('');
-          console.log('\x1b[1m  Harmony Sync — Apply\x1b[0m');
-          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
-          console.log('');
-          if (result.applied.length === 0 && result.skipped.length === 0) {
-            console.log('  \x1b[32mAll platforms are already in sync. Nothing to apply.\x1b[0m');
-          } else {
-            for (const item of result.applied) {
-              console.log(`  \x1b[32m✓\x1b[0m ${item.action.padEnd(8)} ${item.platform.padEnd(12)} ${item.path}`);
-            }
-            for (const item of result.skipped) {
-              const reason = typeof item === 'string' ? item : (item.reason || item.path);
-              console.log(`  \x1b[33m⚠\x1b[0m skipped  ${reason}`);
-            }
-            console.log('');
-            if (result.summary) {
-              console.log(`  Files: ${result.summary.totalFiles} (${result.summary.creates} created, ${result.summary.patches} patched)`);
-              console.log(`  Platforms: ${result.summary.platforms.join(', ')}`);
-            }
-          }
-          if (result.warnings && result.warnings.length > 0) {
-            console.log('');
-            for (const w of result.warnings) {
-              console.log(`  \x1b[33m⚠\x1b[0m ${w}`);
-            }
-          }
-          console.log('');
-        }
-      } else {
-        // Preview mode (dry run)
-        const plan = previewHarmonySync(dir);
-        if (options.json) {
-          console.log(JSON.stringify(plan, null, 2));
-        } else {
-          console.log('');
-          console.log('\x1b[1m  Harmony Sync — Preview\x1b[0m');
-          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
-          console.log('');
-          if (plan.files.length === 0) {
-            console.log('  \x1b[32mAll platforms are already in sync. No changes needed.\x1b[0m');
-          } else {
-            for (const file of plan.files) {
-              const actionColor = file.action === 'create' ? '\x1b[32m' : '\x1b[36m';
-              console.log(`  ${actionColor}${file.action.padEnd(8)}\x1b[0m ${file.platform.padEnd(12)} ${file.path}`);
-              if (file.preview) {
-                console.log(`           \x1b[2m${file.preview}\x1b[0m`);
-              }
-            }
-            console.log('');
-            console.log(`  Total: ${plan.summary.totalFiles} file(s) — ${plan.summary.creates} create, ${plan.summary.patches} patch`);
-            console.log(`  Platforms: ${plan.summary.platforms.join(', ')}`);
-            if (plan.summary.recommendedTrust) {
-              console.log(`  Recommended trust: ${plan.summary.recommendedTrust}`);
-            }
-            console.log('');
-            console.log('  Run \x1b[1mnerviq harmony-sync --fix\x1b[0m to apply these changes.');
-          }
-          if (plan.warnings && plan.warnings.length > 0) {
-            console.log('');
-            for (const w of plan.warnings) {
-              console.log(`  \x1b[33m⚠\x1b[0m ${w}`);
-            }
-          }
-          console.log('');
-        }
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'harmony-drift') {
-      const { runHarmonyDrift } = require('../src/harmony/cli');
-      await runHarmonyDrift(options);
-      process.exit(0);
-    } else if (normalizedCommand === 'harmony-advise') {
-      const { runHarmonyAdvise } = require('../src/harmony/cli');
-      await runHarmonyAdvise(options);
-      process.exit(0);
-    } else if (normalizedCommand === 'harmony-watch') {
-      const { runHarmonyWatch } = require('../src/harmony/cli');
-      await runHarmonyWatch(options);
-    } else if (normalizedCommand === 'harmony-governance') {
-      const { runHarmonyGovernance } = require('../src/harmony/cli');
-      await runHarmonyGovernance(options);
-      process.exit(0);
-    } else if (normalizedCommand === 'harmony-add') {
-      const { addPlatform } = require('../src/harmony/add');
-      const platformArg = parsed.extraArgs[0];
-      if (!platformArg) {
-        console.log('\n  Usage: nerviq harmony-add <platform>');
-        console.log('  Available: claude, codex, gemini, copilot, cursor, windsurf, aider, opencode\n');
-        process.exit(1);
-      }
-      const dir = options.dir || process.cwd();
-      const result = addPlatform(dir, platformArg.toLowerCase());
-      if (options.json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else if (result.success) {
-        console.log(`\n  \x1b[32m\u2713\x1b[0m Added ${result.platform} to project`);
-        result.created.forEach(f => console.log(`     Created: ${f}`));
-        console.log(`     Platforms: ${result.beforeCount} \u2192 ${result.afterCount}`);
-        if (result.syncApplied > 0) console.log(`     Harmony sync: ${result.syncApplied} file(s) updated`);
-        console.log('');
-      } else {
-        console.log(`\n  \x1b[31m\u2717\x1b[0m ${result.error}\n`);
-        process.exit(1);
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'anti-patterns') {
-      const showAll = flags.includes('--all');
-      if (showAll) {
-        printAntiPatternCatalog(options);
-      } else {
-        const { ProjectContext } = require('../src/context');
-        const ctx = new ProjectContext(options.dir);
-        const detected = detectAntiPatterns(ctx);
-        printAntiPatterns(detected, options);
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'rules-export') {
-      const { generateRecommendationRules } = require('../src/recommendation-rules');
-      const rules = generateRecommendationRules();
-      if (options.json) {
-        console.log(JSON.stringify(rules, null, 2));
-      } else if (options.out) {
-        require('fs').writeFileSync(options.out, JSON.stringify(rules, null, 2), 'utf8');
-        console.log(`\n  Rules exported to ${options.out} (${rules.totalRules} rules)\n`);
-      } else {
-        // Human-readable summary
-        console.log(`\n  Nerviq Recommendation Rules (${rules.totalRules} rules)\n`);
-        const byCategory = {};
-        for (const rule of (rules.rules || [])) {
-          const cat = rule.category || 'other';
-          if (!byCategory[cat]) byCategory[cat] = 0;
-          byCategory[cat]++;
-        }
-        for (const [cat, count] of Object.entries(byCategory).sort((a, b) => b[1] - a[1])) {
-          console.log(`  ${cat.padEnd(20)} ${count} rules`);
-        }
-        console.log(`\n  Use --json for full output or --out <file> to save.\n`);
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'dashboard') {
-      const dashFlags = {
-        out: options.out,
-        open: flags.includes('--open'),
-        json: options.json,
-        platform: options.platform,
-      };
-      if (parsed.repos && parsed.repos.length > 0) {
-        const { generatePortfolioDashboard } = require('../src/dashboard');
-        await generatePortfolioDashboard(parsed.repos, dashFlags);
-      } else {
-        const { generateDashboard } = require('../src/dashboard');
-        await generateDashboard(options.dir, dashFlags);
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'check-health') {
-      const { checkHealth, formatCheckHealth } = require('../src/activity');
-      const report = checkHealth(options.dir);
-      if (options.json) {
-        console.log(JSON.stringify(report, null, 2));
-      } else {
-        console.log('');
-        console.log(formatCheckHealth(report));
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'freshness') {
-      const { TECHNIQUES } = require('../src/techniques');
-      const stats = getVerificationStats();
-      const allKeys = Object.keys(TECHNIQUES);
-      const verifiedKeys = Object.keys(VERIFICATION_DATES);
-      const neverVerified = allKeys.filter(k => !VERIFICATION_DATES[k]);
-
-      if (options.json) {
-        console.log(JSON.stringify({
-          totalChecks: allKeys.length,
-          verifiedChecks: verifiedKeys.length,
-          neverVerifiedCount: neverVerified.length,
-          newestVerification: stats.newest,
-          oldestVerification: stats.oldest,
-          neverVerified,
-        }, null, 2));
-      } else {
-        console.log('');
-        console.log('  nerviq freshness');
-        console.log('  ═══════════════════════════════════════');
-        console.log(`  Total checks:            ${allKeys.length}`);
-        console.log(`  With verification date:  ${verifiedKeys.length}`);
-        console.log(`  Never verified:          ${neverVerified.length}`);
-        console.log(`  Newest verification:     ${stats.newest}`);
-        console.log(`  Oldest verification:     ${stats.oldest}`);
-        console.log('');
-        if (neverVerified.length > 0 && options.verbose) {
-          console.log('  Never verified:');
-          for (const key of neverVerified) {
-            console.log(`    - ${key}`);
-          }
-          console.log('');
-        } else if (neverVerified.length > 0) {
-          console.log(`  Use --verbose to list all ${neverVerified.length} never-verified checks.`);
-          console.log('');
-        }
-      }
-      process.exit(0);
-    } else if (normalizedCommand === 'synergy-report') {
-      // Placeholder — synergy report is referenced but may not be implemented yet
-      console.log('\n  Synergy report: coming soon.\n');
-      process.exit(0);
-    } else if (normalizedCommand === 'doctor') {
-      const { runDoctor } = require('../src/doctor');
-      const output = await runDoctor({ dir: options.dir, json: options.json, verbose: options.verbose });
-      console.log(output);
-      process.exit(0);
-    } else if (normalizedCommand === 'convert') {
-      const { runConvert } = require('../src/convert');
-      const output = await runConvert({
-        dir: options.dir,
-        from: parsed.convertFrom,
-        to: parsed.convertTo,
-        dryRun: options.dryRun,
-        json: options.json,
-      });
-      console.log(output);
-      process.exit(0);
-    } else if (normalizedCommand === 'migrate') {
-      const { runMigrate } = require('../src/migrate');
-      const output = await runMigrate({
-        dir: options.dir,
-        platform: options.platform || parsed.platform || 'claude',
-        from: parsed.migrateFrom,
-        to: parsed.migrateTo,
-        dryRun: options.dryRun,
-        json: options.json,
-      });
-      console.log(output);
-      process.exit(0);
-    } else if (normalizedCommand === 'fix') {
-      // nerviq fix [key] [--all-critical] [--dry-run] [--auto]
-      const fixKey = parsed.extraArgs[0] || null;
-      const allCritical = flags.includes('--all-critical');
-      const autoApply = options.auto || options.dryRun;
-
-      // Step 1: Run silent audit to find failed checks (only actual failures, not skipped/null)
-      const auditResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
-      const failedResults = (auditResult.results || []).filter(r => r.passed === false);
-
-      if (failedResults.length === 0) {
-        console.log('\n  ✅ All checks passing — nothing to fix.\n');
-        process.exit(0);
-      }
-
-      // Step 2: Determine which checks to fix
-      const { TECHNIQUES } = require('../src/techniques');
-      const fs = require('fs');
-      const pathMod = require('path');
-
-      // Inline fixers for checks without templates but with trivial auto-fixes
-      const INLINE_FIXERS = {
-        gitIgnoreEnv: (dir) => {
-          const gitignorePath = pathMod.join(dir, '.gitignore');
-          const existing = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf8') : '';
-          if (!existing.includes('.env')) {
-            const lines = existing.endsWith('\n') || existing === '' ? '' : '\n';
-            fs.appendFileSync(gitignorePath, `${lines}.env\n.env.*\n`, 'utf8');
-            return true;
-          }
-          return false;
-        },
-        secretsProtection: (dir) => {
-          const settingsPath = pathMod.join(dir, '.claude', 'settings.json');
-          const settingsDir = pathMod.join(dir, '.claude');
-          if (!fs.existsSync(settingsDir)) fs.mkdirSync(settingsDir, { recursive: true });
-          let settings = {};
-          if (fs.existsSync(settingsPath)) {
-            try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch { settings = {}; }
-          }
-          if (!settings.permissions) settings.permissions = {};
-          if (!settings.permissions.deny) settings.permissions.deny = [];
-          const denyEntries = ['.env', '.env.*', '**/.env', '**/*.pem', '**/secrets/**'];
-          for (const entry of denyEntries) {
-            if (!settings.permissions.deny.includes(entry)) settings.permissions.deny.push(entry);
-          }
-          fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
-          return true;
-        },
-      };
-
-      let targetKeys = [];
-
-      if (fixKey) {
-        // Fix a specific check
-        if (!failedResults.find(r => r.key === fixKey)) {
-          const passed = (auditResult.results || []).find(r => r.key === fixKey && r.passed);
-          if (passed) {
-            console.log(`\n  ✅ '${fixKey}' is already passing.\n`);
-          } else {
-            console.log(`\n  Error: Unknown check key '${fixKey}'.`);
-            console.log(`  Fix: Run 'nerviq audit --full' to see all check keys.\n`);
-          }
-          process.exit(1);
-        }
-        targetKeys = [fixKey];
-      } else if (allCritical) {
-        targetKeys = failedResults.filter(r => r.impact === 'critical').map(r => r.key);
-        if (targetKeys.length === 0) {
-          console.log('\n  ✅ No critical issues found.\n');
-          process.exit(0);
-        }
-      } else {
-        // No key specified — show fixable checks and exit
-        const INLINE_FIX_KEYS = new Set(Object.keys(INLINE_FIXERS));
-        const fixable = failedResults.filter(r => (TECHNIQUES[r.key] && TECHNIQUES[r.key].template) || INLINE_FIX_KEYS.has(r.key));
-        const nonFixable = failedResults.filter(r => !(TECHNIQUES[r.key] && TECHNIQUES[r.key].template) && !INLINE_FIX_KEYS.has(r.key));
-        console.log('');
-        console.log(`  nerviq fix — ${failedResults.length} failed checks\n`);
-        if (fixable.length > 0) {
-          console.log(`  Auto-fixable (${fixable.length}):`);
-          for (const r of fixable) {
-            const tier = r.impact === 'critical' ? '🔴' : r.impact === 'high' ? '🟡' : '🔵';
-            console.log(`    ${tier} nerviq fix ${r.key}`);
-          }
-          console.log('');
-        }
-        if (nonFixable.length > 0) {
-          console.log(`  Manual fix needed (${nonFixable.length}):`);
-          for (const r of nonFixable.slice(0, 5)) {
-            const tier = r.impact === 'critical' ? '🔴' : r.impact === 'high' ? '🟡' : '🔵';
-            console.log(`    ${tier} ${r.key}: ${r.fix}`);
-          }
-          if (nonFixable.length > 5) {
-            console.log(`    ... and ${nonFixable.length - 5} more (use --full to see all)`);
-          }
-          console.log('');
-        }
-        if (fixable.length > 0) {
-          console.log(`  Quick actions:`);
-          console.log(`    nerviq fix ${fixable[0].key}        Fix the first auto-fixable check`);
-          console.log(`    nerviq fix --all-critical    Fix all critical issues at once`);
-        }
-        console.log('');
-        process.exit(0);
-      }
-
-      // Step 2.5: Predict impact and show preview before applying
-      const IMPACT_WEIGHTS = { critical: 15, high: 10, medium: 5, low: 2 };
-      const preScore = auditResult.score;
-      const applicableResults = (auditResult.results || []).filter(r => r.passed !== null);
-      const maxScore = applicableResults.reduce((sum, r) => sum + (IMPACT_WEIGHTS[r.impact] || 5), 0);
-
-      // Compute predicted score by simulating target fixes as passing
-      const targetKeySet = new Set(targetKeys);
-      const INLINE_FIX_KEYS = new Set(Object.keys(INLINE_FIXERS));
-      const fixableTargets = targetKeys.filter(k => {
-        const tech = TECHNIQUES[k];
-        return (tech && tech.template) || INLINE_FIX_KEYS.has(k);
-      });
-      const fixableTargetSet = new Set(fixableTargets);
-      const simulatedEarned = applicableResults.reduce((sum, r) => {
-        const w = IMPACT_WEIGHTS[r.impact] || 5;
-        if (r.passed) return sum + w;
-        if (fixableTargetSet.has(r.key)) return sum + w;
-        return sum;
-      }, 0);
-      const predictedScore = maxScore > 0 ? Math.round((simulatedEarned / maxScore) * 100) : 0;
-      const predictedDelta = predictedScore - preScore;
-
-      if (!autoApply) {
-        console.log('');
-        if (allCritical && fixableTargets.length > 1) {
-          // Multi-fix summary
-          console.log(`  ${fixableTargets.length} critical fixes available:`);
-          let runningEarned = applicableResults.reduce((s, r) => s + (r.passed ? (IMPACT_WEIGHTS[r.impact] || 5) : 0), 0);
-          let runningScore = maxScore > 0 ? Math.round((runningEarned / maxScore) * 100) : 0;
-          fixableTargets.forEach((k, idx) => {
-            const r = failedResults.find(fr => fr.key === k);
-            const w = IMPACT_WEIGHTS[r.impact] || 5;
-            const nextEarned = runningEarned + w;
-            const nextScore = maxScore > 0 ? Math.round((nextEarned / maxScore) * 100) : 0;
-            const d = nextScore - runningScore;
-            console.log(`  ${idx + 1}. ${(r.key).padEnd(18)} ${runningScore} → ${nextScore} (+${d})`);
-            runningEarned = nextEarned;
-            runningScore = nextScore;
-          });
-          console.log('');
-          console.log(`  Total: ${preScore} → ${predictedScore} (+${predictedDelta})`);
-        } else {
-          // Single fix preview
-          const targetCheck = failedResults.find(r => r.key === fixableTargets[0]) || failedResults.find(r => r.key === targetKeys[0]);
-          if (targetCheck) {
-            console.log(`  Predicted impact: ${preScore} → ${predictedScore} (+${predictedDelta})`);
-          }
-        }
-
-        // Prompt for confirmation
-        const readline = require('readline');
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        const answer = await new Promise(resolve => {
-          rl.question('  Apply? (Y/n) ', resolve);
-        });
-        rl.close();
-        if (answer && answer.trim().toLowerCase() === 'n') {
-          console.log('\n  Aborted.\n');
-          process.exit(0);
-        }
-      }
-
-      // Step 3: For each target, either use template, inline fix, or show manual instructions
-      let fixed = 0;
-      let manual = 0;
-
-      for (const key of targetKeys) {
-        const technique = TECHNIQUES[key];
-        const failedCheck = failedResults.find(r => r.key === key);
-
-        if (technique && technique.template) {
-          if (options.dryRun) {
-            console.log(`\n  [dry-run] Would fix: ${failedCheck.name} (${key})`);
-            fixed++;
-          } else {
-            // Use setup with only this key
-            await setup({ ...options, only: [key], silent: true });
-            console.log(`  ✅ Fixed: ${failedCheck.name}`);
-            fixed++;
-          }
-        } else if (INLINE_FIXERS[key]) {
-          if (options.dryRun) {
-            console.log(`  [dry-run] Would fix: ${failedCheck.name} (${key})`);
-            fixed++;
-          } else {
-            const didFix = INLINE_FIXERS[key](options.dir);
-            if (didFix) {
-              console.log(`  ✅ Fixed: ${failedCheck.name}`);
-              fixed++;
-            } else {
-              console.log(`  ⏭️  Already fixed: ${failedCheck.name}`);
-            }
-          }
-        } else {
-          console.log(`  📋 ${failedCheck.name} (manual fix needed)`);
-          console.log(`     ${failedCheck.fix}`);
-          manual++;
-        }
-      }
-
-      // Step 4: Show score impact
-      if (fixed > 0 && !options.dryRun) {
-        const postResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
-        const delta = postResult.score - preScore;
-        console.log('');
-        console.log(`  Score: ${preScore} → ${postResult.score} (${delta >= 0 ? '+' : ''}${delta})`);
-      }
-
-      console.log(`\n  ${fixed} fixed, ${manual} need manual action.\n`);
-
-    } else if (normalizedCommand === 'init') {
-      const { runInit } = require('../src/init');
-      await runInit(options.dir, flags);
-      process.exit(0);
-    } else if (normalizedCommand === 'setup') {
-      await setup(options);
-      if (options.snapshot) {
-        const postSetupResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
-        const snapshot = writeSnapshotArtifact(options.dir, 'audit', postSetupResult, {
-          sourceCommand: 'setup',
-        });
-        if (!options.json) {
-          console.log(`  Snapshot saved: ${snapshot.relativePath}`);
-        }
-      }
-    } else {
-      if (options.workspace) {
-        const summary = await auditWorkspaces(options.dir, options.workspace, options.platform);
-        printWorkspaceSummary(summary, options);
-        if (options.threshold !== null && summary.averageScore < options.threshold) {
-          process.exit(1);
-        }
-        process.exit(0);
-      }
-      const result = await audit(options);
-      if (options.webhookUrl) {
-        try {
-          const { sendWebhook, formatSlackMessage } = require('../src/integrations');
-          // Auto-detect Slack vs generic by URL pattern
-          const isSlack = options.webhookUrl.includes('hooks.slack.com');
-          const isDiscord = options.webhookUrl.includes('discord.com/api/webhooks');
-          let payload;
-          if (isSlack) {
-            payload = formatSlackMessage(result);
-          } else if (isDiscord) {
-            const { formatDiscordMessage } = require('../src/integrations');
-            payload = formatDiscordMessage(result);
-          } else {
-            // Generic webhook: send full JSON audit result
-            payload = { platform: result.platform, score: result.score, passed: result.passed, failed: result.failed, results: result.results };
-          }
-          const webhookResp = await sendWebhook(options.webhookUrl, payload);
-          if (!options.json) {
-            if (webhookResp.ok) {
-              console.log(`  Webhook sent: ${options.webhookUrl} (${webhookResp.status})`);
-            } else {
-              console.error(`  Webhook failed: ${webhookResp.status} — ${webhookResp.body.slice(0, 200)}`);
-            }
-          }
-        } catch (webhookErr) {
-          if (!options.json) console.error(`  Webhook error: ${webhookErr.message}`);
-        }
-      }
-      if (options.feedback && !options.json && options.format === null) {
-        const feedbackTargets = options.lite
-          ? (result.liteSummary?.topNextActions || [])
-          : (result.topNextActions || []);
-        const feedbackResult = await collectFeedback(options.dir, {
-          findings: feedbackTargets,
-          platform: result.platform,
-          sourceCommand: normalizedCommand,
-          score: result.score,
-        });
-        if (feedbackResult.mode === 'skipped-noninteractive') {
-          console.log('  Feedback prompt skipped: interactive terminal required.');
-          console.log('');
-        } else if (feedbackResult.saved > 0) {
-          console.log(`  Feedback saved: ${feedbackResult.relativeDir}`);
-          console.log(`  Helpful: ${feedbackResult.helpful} | Not helpful: ${feedbackResult.unhelpful}`);
-          console.log('');
-        }
-      }
-      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, 'audit', result, {
-        sourceCommand: normalizedCommand,
-      }) : null;
-      if (snapshot && !options.json) {
-        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
-        console.log(`  Snapshot index: ${snapshot.indexPath}`);
-        console.log('');
-      }
-      if (options.threshold !== null && result.score < options.threshold) {
-        if (!options.json) {
-          console.error(`\n  Error: Threshold not met — score ${result.score}/100 is below required ${options.threshold}/100.`);
-          console.error('  Why: Your project audit score is lower than the minimum threshold set via --threshold.');
-          console.error('  Fix: Run `npx nerviq augment` to see improvement suggestions, then re-audit.');
-          console.error('  Docs: https://github.com/nerviq/nerviq#ci-integration\n');
-        }
-        process.exit(1);
-      }
-      if (options.require && options.require.length > 0) {
-        const failedRequired = options.require.filter(key => {
-          const check = result.results.find(r => r.key === key);
-          return !check || check.passed !== true;
-        });
-        if (failedRequired.length > 0) {
-          if (!options.json) {
-            console.error(`\n  Required checks failed: ${failedRequired.join(', ')}`);
-            console.error('  These must pass for CI to succeed.\n');
-          }
-          process.exit(1);
-        }
-      }
-    }
-  } catch (err) {
-    console.error(`\n  Error: ${err.message}`);
-    console.error('  Fix: Run `npx nerviq doctor` to diagnose common issues, or check https://github.com/nerviq/nerviq#troubleshooting');
-    process.exit(1);
-  }
-}
-
-main();
+#!/usr/bin/env node
+
+const { audit } = require('../src/audit');
+const { setup } = require('../src/setup');
+const { analyzeProject, printAnalysis, exportMarkdown } = require('../src/analyze');
+const { buildProposalBundle, printProposalBundle, writePlanFile, applyProposalBundle, printApplyResult } = require('../src/plans');
+const { getGovernanceSummary, printGovernanceSummary, ensureWritableProfile, renderGovernanceMarkdown } = require('../src/governance');
+const { runBenchmark, printBenchmark, writeBenchmarkReport } = require('../src/benchmark');
+const { writeSnapshotArtifact, writeRollbackArtifact, recordRecommendationOutcome, formatRecommendationOutcomeSummary, getRecommendationOutcomeSummary } = require('../src/activity');
+const { collectFeedback } = require('../src/feedback');
+const { recordPattern, getPriorityAdjustment, formatUsageSummary } = require('../src/usage-patterns');
+const { startServer } = require('../src/server');
+const { auditWorkspaces } = require('../src/workspace');
+const { scanOrg } = require('../src/org');
+const { detectAntiPatterns, printAntiPatterns, printAntiPatternCatalog } = require('../src/anti-patterns');
+const { VERIFICATION_DATES, getVerificationDate, getVerificationStats } = require('../src/verification-metadata');
+const { version } = require('../package.json');
+
+const args = process.argv.slice(2);
+const COMMAND_ALIASES = {
+  review: 'deep-review',
+  wizard: 'interactive',
+  learn: 'insights',
+  discover: 'audit',
+  starter: 'setup',
+  suggest: 'suggest-only',
+  gov: 'governance',
+  outcome: 'feedback',
+};
+const KNOWN_COMMANDS = ['audit', 'org', 'setup', 'init', 'augment', 'suggest-only', 'plan', 'apply', 'fix', 'rollback', 'governance', 'benchmark', 'deep-review', 'interactive', 'watch', 'badge', 'insights', 'history', 'compare', 'trend', 'scan', 'feedback', 'doctor', 'convert', 'migrate', 'catalog', 'certify', 'serve', 'check-health', 'dashboard', 'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise', 'harmony-watch', 'harmony-governance', 'harmony-add', 'synergy-report', 'anti-patterns', 'rules-export', 'freshness', 'suggest-rules', 'profile', 'help', 'version'];
+
+function levenshtein(a, b) {
+  const matrix = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
+  for (let i = 0; i <= a.length; i++) matrix[i][0] = i;
+  for (let j = 0; j <= b.length; j++) matrix[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      matrix[i][j] = Math.min(
+        matrix[i - 1][j] + 1,
+        matrix[i][j - 1] + 1,
+        matrix[i - 1][j - 1] + cost
+      );
+    }
+  }
+  return matrix[a.length][b.length];
+}
+
+function suggestCommand(input) {
+  const candidates = [...KNOWN_COMMANDS, ...Object.keys(COMMAND_ALIASES)];
+  let best = null;
+  let bestDistance = Infinity;
+  for (const candidate of candidates) {
+    const distance = levenshtein(input, candidate);
+    if (distance < bestDistance) {
+      best = candidate;
+      bestDistance = distance;
+    }
+  }
+  return bestDistance <= 3 ? best : null;
+}
+
+function parseArgs(rawArgs) {
+  const flags = [];
+  let command = 'audit';
+  let threshold = null;
+  let out = null;
+  let planFile = null;
+  let only = [];
+  let profile = 'safe-write';
+  let mcpPacks = [];
+  let requireChecks = [];
+  let feedbackKey = null;
+  let feedbackStatus = null;
+  let feedbackEffect = null;
+  let feedbackNotes = null;
+  let feedbackSource = null;
+  let feedbackScoreDelta = null;
+  let platform = 'claude';
+  let format = null;
+  let port = null;
+  let workspace = null;
+  let webhookUrl = null;
+  let commandSet = false;
+  let extraArgs = [];
+  let convertFrom = null;
+  let convertTo = null;
+  let migrateFrom = null;
+  let migrateTo = null;
+  let checkVersion = null;
+  let external = null;
+  let repos = [];
+  let teamProfile = null;
+
+  for (let i = 0; i < rawArgs.length; i++) {
+    const arg = rawArgs[i];
+
+    if (arg === '--threshold' || arg === '--out' || arg === '--plan' || arg === '--only' || arg === '--profile' || arg === '--mcp-pack' || arg === '--require' || arg === '--key' || arg === '--status' || arg === '--effect' || arg === '--notes' || arg === '--source' || arg === '--score-delta' || arg === '--platform' || arg === '--format' || arg === '--from' || arg === '--to' || arg === '--port' || arg === '--workspace' || arg === '--check-version' || arg === '--webhook' || arg === '--external' || arg === '--team-profile') {
+      const value = rawArgs[i + 1];
+      if (!value || value.startsWith('--')) {
+        throw new Error(`${arg} requires a value`);
+      }
+      if (arg === '--threshold') threshold = value;
+      if (arg === '--out') out = value;
+      if (arg === '--plan') planFile = value;
+      if (arg === '--only') only = value.split(',').map(item => item.trim()).filter(Boolean);
+      if (arg === '--profile') profile = value.trim();
+      if (arg === '--mcp-pack') mcpPacks = value.split(',').map(item => item.trim()).filter(Boolean);
+      if (arg === '--require') requireChecks = value.split(',').map(item => item.trim()).filter(Boolean);
+      if (arg === '--key') feedbackKey = value.trim();
+      if (arg === '--status') feedbackStatus = value.trim();
+      if (arg === '--effect') feedbackEffect = value.trim();
+      if (arg === '--notes') feedbackNotes = value;
+      if (arg === '--source') feedbackSource = value.trim();
+      if (arg === '--score-delta') feedbackScoreDelta = value.trim();
+      if (arg === '--platform') platform = value.trim().toLowerCase();
+      if (arg === '--format') format = value.trim().toLowerCase();
+      if (arg === '--from') { convertFrom = value.trim(); migrateFrom = value.trim(); }
+      if (arg === '--to') { convertTo = value.trim(); migrateTo = value.trim(); }
+      if (arg === '--port') port = value.trim();
+      if (arg === '--workspace') workspace = value.trim();
+      if (arg === '--check-version') checkVersion = value.trim();
+      if (arg === '--webhook') webhookUrl = value.trim();
+      if (arg === '--external') external = value.trim();
+      if (arg === '--team-profile') teamProfile = value.trim();
+      i++;
+      continue;
+    }
+
+    if (arg.startsWith('--team-profile=')) {
+      teamProfile = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--external=')) {
+      external = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg === '--repos') {
+      // Collect all following non-flag args as repo paths (supports comma-separated too)
+      while (i + 1 < rawArgs.length && !rawArgs[i + 1].startsWith('--')) {
+        i++;
+        repos.push(...rawArgs[i].split(',').map(s => s.trim()).filter(Boolean));
+      }
+      if (repos.length === 0) throw new Error('--repos requires at least one path');
+      continue;
+    }
+
+    if (arg.startsWith('--repos=')) {
+      repos = arg.split('=').slice(1).join('=').split(',').map(s => s.trim()).filter(Boolean);
+      if (repos.length === 0) throw new Error('--repos requires at least one path');
+      continue;
+    }
+
+    if (arg.startsWith('--require=')) {
+      requireChecks = arg.split('=').slice(1).join('=').split(',').map(item => item.trim()).filter(Boolean);
+      continue;
+    }
+
+    if (arg.startsWith('--threshold=')) {
+      threshold = arg.split('=')[1];
+      continue;
+    }
+
+    if (arg.startsWith('--out=')) {
+      out = arg.split('=').slice(1).join('=');
+      continue;
+    }
+
+    if (arg.startsWith('--plan=')) {
+      planFile = arg.split('=').slice(1).join('=');
+      continue;
+    }
+
+    if (arg.startsWith('--only=')) {
+      only = arg.split('=').slice(1).join('=').split(',').map(item => item.trim()).filter(Boolean);
+      continue;
+    }
+
+    if (arg.startsWith('--profile=')) {
+      profile = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--mcp-pack=')) {
+      mcpPacks = arg.split('=').slice(1).join('=').split(',').map(item => item.trim()).filter(Boolean);
+      continue;
+    }
+
+    if (arg.startsWith('--key=')) {
+      feedbackKey = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--status=')) {
+      feedbackStatus = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--effect=')) {
+      feedbackEffect = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--notes=')) {
+      feedbackNotes = arg.split('=').slice(1).join('=');
+      continue;
+    }
+
+    if (arg.startsWith('--source=')) {
+      feedbackSource = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--score-delta=')) {
+      feedbackScoreDelta = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--platform=')) {
+      platform = arg.split('=').slice(1).join('=').trim().toLowerCase();
+      continue;
+    }
+
+    if (arg.startsWith('--format=')) {
+      format = arg.split('=').slice(1).join('=').trim().toLowerCase();
+      continue;
+    }
+
+    if (arg.startsWith('--port=')) {
+      port = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--workspace=')) {
+      workspace = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--check-version=')) {
+      checkVersion = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
+    if (arg.startsWith('--')) {
+      flags.push(arg);
+      continue;
+    }
+
+    if (!commandSet) {
+      command = arg;
+      commandSet = true;
+    } else {
+      extraArgs.push(arg);
+    }
+  }
+
+  const normalizedCommand = COMMAND_ALIASES[command] || command;
+
+  return { flags, command, normalizedCommand, threshold, out, planFile, only, profile, mcpPacks, requireChecks, feedbackKey, feedbackStatus, feedbackEffect, feedbackNotes, feedbackSource, feedbackScoreDelta, platform, format, port, workspace, extraArgs, convertFrom, convertTo, migrateFrom, migrateTo, checkVersion, webhookUrl, external, repos, teamProfile };
+}
+
+function printWorkspaceSummary(summary, options) {
+  if (options.json) {
+    console.log(JSON.stringify(summary, null, 2));
+    return;
+  }
+
+  console.log('');
+  console.log('\x1b[1m  nerviq workspace audit\x1b[0m');
+  console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+  console.log(`  Root: ${summary.rootDir}`);
+  console.log(`  Platform: ${summary.platform}`);
+  console.log(`  Workspaces: ${summary.workspaceCount}`);
+  console.log(`  Average score: \x1b[1m${summary.averageScore}/100\x1b[0m`);
+  console.log('');
+  console.log('\x1b[1m  Workspace                  Score  Pass  Total  Top action\x1b[0m');
+  console.log('  ' + '─'.repeat(72));
+  for (const item of summary.workspaces) {
+    const score = item.score === null ? 'ERR' : String(item.score);
+    const topAction = item.error || item.topAction || '-';
+    console.log(`  ${item.workspace.padEnd(26)} ${score.padStart(5)} ${String(item.passed).padStart(5)} ${String(item.total).padStart(6)}  ${topAction}`);
+  }
+  console.log('');
+}
+
+function printOrgSummary(summary, options) {
+  if (options.json) {
+    console.log(JSON.stringify(summary, null, 2));
+    return;
+  }
+
+  console.log('');
+  console.log('\x1b[1m  nerviq org scan\x1b[0m');
+  console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+  console.log(`  Platform: ${summary.platform}`);
+  console.log(`  Repos: ${summary.repoCount}`);
+  console.log(`  Average score: \x1b[1m${summary.averageScore}/100\x1b[0m`);
+  console.log('');
+  console.log('\x1b[1m  Repo              Platform  Score  Top action\x1b[0m');
+  console.log('  ' + '─'.repeat(72));
+  for (const item of summary.repos) {
+    const score = item.score === null ? 'ERR' : String(item.score);
+    const topAction = item.error || item.topAction || '-';
+    console.log(`  ${item.name.padEnd(18)} ${item.platform.padEnd(8)} ${score.padStart(5)}  ${topAction}`);
+  }
+  console.log('');
+}
+
+const HELP = `
+  nerviq v${version}
+  The intelligent nervous system for AI coding agents.
+  Audit, align, and amplify every platform on every project.
+
+  DISCOVER
+    nerviq audit                  Quick scan: score + top 3 gaps (default)
+    nerviq audit --full           Full audit with all checks, weakest areas, badge
+    nerviq audit --platform X     Audit specific platform (claude|codex|cursor|copilot|gemini|windsurf|aider|opencode)
+    nerviq audit --json           Machine-readable JSON output (for CI)
+    nerviq audit --workspace packages/*     Audit each workspace in a monorepo
+    nerviq scan dir1 dir2         Compare multiple repos side-by-side
+    nerviq org scan dir1 dir2     Aggregate multiple repos into one score table
+    nerviq catalog                Full check catalog (all 8 platforms)
+    nerviq catalog --json         Export full check catalog as JSON
+    nerviq anti-patterns          Detect anti-patterns in current project
+    nerviq anti-patterns --all    Show full anti-pattern catalog
+
+  SETUP
+    nerviq setup                  Generate starter-safe baseline config files
+    nerviq setup --auto           Apply all generated files without prompts
+    nerviq interactive            Step-by-step guided wizard
+    nerviq check-health           Detect regressions + platform format changes between snapshots
+    nerviq doctor                 Self-diagnostics: Node, deps, freshness, platform detection
+
+  FIX
+    nerviq fix                    Show fixable checks and manual-fix guidance
+    nerviq fix <key>              Auto-fix a specific check (with score impact)
+    nerviq fix <key> --prompt     Show AI agent prompt for a check (no auto-fix)
+    nerviq fix --all-critical     Fix all critical issues at once
+    nerviq fix --dry-run          Preview fixes without writing
+    nerviq fix --auto             Apply fixes without confirmation prompt
+    nerviq rollback               Undo the most recent apply (delete created files)
+    nerviq rollback --list        Show available rollback points
+    nerviq rollback --dry-run     Preview what would be deleted
+
+  IMPROVE
+    nerviq augment                Improvement plan (no writes)
+    nerviq suggest-only           Structured report for sharing (no writes)
+    nerviq plan                   Export proposal bundles with diffs
+    nerviq plan --out plan.json   Save plan to file
+    nerviq apply                  Apply proposals selectively with rollback
+    nerviq apply --dry-run        Preview changes without writing
+
+  GOVERN
+    nerviq governance             Permission profiles + hooks + policy packs
+    nerviq governance --json      Machine-readable governance summary
+    nerviq benchmark              Before/after score in isolated temp copy
+    nerviq benchmark --external /path  Benchmark an external repo
+    nerviq freshness              Show verification freshness for all checks
+    nerviq certify                Generate certification badge for your project
+
+  CROSS-PLATFORM
+    nerviq harmony-audit          Drift detection across all active platforms
+    nerviq harmony-sync           Preview cross-platform sync (dry run)
+    nerviq harmony-sync --fix     Apply cross-platform sync (write files)
+    nerviq harmony-sync --json    JSON output for CI/automation
+    nerviq harmony-add <platform>  Add a new platform to the project
+    nerviq synergy-report         Multi-agent amplification opportunities
+    nerviq convert --from X --to Y   Convert configs between platforms
+    nerviq migrate --platform X   Platform version migration helper
+    nerviq migrate --platform cursor --from v2 --to v3
+
+  MONITOR
+    nerviq dashboard              Generate static HTML dashboard report
+    nerviq dashboard --out F      Save dashboard to custom file
+    nerviq dashboard --open       Open dashboard in browser after generating
+    nerviq watch                  Live config monitoring (re-audits on file change)
+    nerviq history                Score history from saved snapshots
+    nerviq compare                Latest vs previous snapshot diff
+    nerviq trend                  Score trend over time
+    nerviq trend --out report.md  Export trend report as markdown
+    nerviq feedback               Record recommendation outcomes
+
+  TEAM PROFILES
+    nerviq profile save <name>    Save current preferences as a named profile
+    nerviq profile load <name>    Load and display a saved profile
+    nerviq profile list           List available profiles
+    nerviq profile export <name>  Export profile JSON for sharing
+
+  ADVANCED
+    nerviq deep-review            AI-powered config review (opt-in, uses API key)
+    nerviq serve --port 3000      Start local Nerviq REST API server
+    nerviq badge                  Generate shields.io badge markdown
+    nerviq rules-export           Export recommendation rules as JSON
+    nerviq rules-export --out F   Save rules to file
+    nerviq suggest-rules          Auto-suggest rules based on usage patterns
+
+  OPTIONS
+    --platform NAME   Platform: claude (default), codex, cursor, copilot, gemini, windsurf, aider, opencode
+    --threshold N     Exit code 1 if score < N  (CI gate)
+    --require A,B     Exit code 1 if named checks fail
+    --out FILE        Write output to file (JSON or markdown)
+    --plan FILE       Load previously exported plan file
+    --only A,B        Limit plan/apply to selected proposal IDs
+    --profile NAME    Permission profile: read-only | suggest-only | safe-write | power-user
+    --team-profile N  Load a saved team profile for audit (overrides threshold/platform)
+    --mcp-pack A,B    Merge MCP packs into setup (e.g. context7-docs,next-devtools)
+    --check-version V Pin catalog to a specific version (warn on mismatch)
+    --format NAME     Output format: json | sarif | otel
+    --webhook URL     Send audit results to a webhook (Slack/Discord/generic JSON)
+    --external PATH   Benchmark an external repo instead of cwd
+    --port N          Port for \`serve\` (default: 3000)
+    --workspace GLOBS Audit workspaces separately (e.g. packages/* or apps/web,apps/api)
+    --snapshot        Save snapshot artifact under .claude/nerviq/snapshots/
+    --full            Show full audit output (all checks, weakest areas, badge)
+    --lite            Short top-3 scan (default behavior since v1.5.2)
+    --dry-run         Preview changes without writing files
+    --config-only     Only write config files (.claude/, rules, hooks) — never source code
+    --verbose         Full audit + medium-priority recommendations
+    --show-deprecated Show deprecated checks (excluded from scoring)
+    --json            Output as JSON
+    --auto            Apply all generated files without prompting
+    --key NAME        Feedback: recommendation key (e.g. permissionDeny)
+    --status VALUE    Feedback: accepted | rejected | deferred
+    --effect VALUE    Feedback: positive | neutral | negative
+    --score-delta N   Feedback: observed score delta
+    --help            Show this help
+    --version         Show version
+
+  EXAMPLES
+    npx nerviq
+    npx nerviq --lite
+    npx nerviq --platform cursor
+    npx nerviq audit --workspace packages/*
+    npx nerviq --platform codex augment
+    npx nerviq org scan ./app ./api ./infra
+    npx nerviq scan ./app ./api ./infra
+    npx nerviq harmony-audit
+    npx nerviq convert --from claude --to codex
+    npx nerviq migrate --platform cursor --from v2 --to v3
+    npx nerviq setup --mcp-pack context7-docs
+    npx nerviq apply --plan plan.json --only hooks,commands
+    npx nerviq serve --port 4000
+    npx nerviq --json --threshold 70
+    npx nerviq catalog --json --out catalog.json
+    npx nerviq feedback --key permissionDeny --status accepted --effect positive
+
+  EXIT CODES
+    0  Success
+    1  Error, unknown command, or score below --threshold
+`;
+
+async function main() {
+  let parsed;
+  try {
+    parsed = parseArgs(args);
+  } catch (err) {
+    console.error(`\n  Error: ${err.message}\n`);
+    process.exit(1);
+  }
+
+  const { flags, command, normalizedCommand } = parsed;
+
+  if (flags.includes('--help') || command === 'help') {
+    console.log(HELP);
+    process.exit(0);
+  }
+
+  if (flags.includes('--version') || command === 'version') {
+    console.log(version);
+    process.exit(0);
+  }
+
+  const options = {
+    verbose: flags.includes('--verbose'),
+    json: flags.includes('--json'),
+    auto: flags.includes('--auto'),
+    lite: flags.includes('--full') || flags.includes('--verbose') ? false : true,
+    full: flags.includes('--full'),
+    showDeprecated: flags.includes('--show-deprecated'),
+    snapshot: flags.includes('--snapshot'),
+    feedback: flags.includes('--feedback'),
+    fix: flags.includes('--fix'),
+    autoSync: flags.includes('--auto-sync'),
+    dryRun: flags.includes('--dry-run'),
+    configOnly: flags.includes('--config-only'),
+    threshold: parsed.threshold !== null ? Number(parsed.threshold) : null,
+    out: parsed.out,
+    planFile: parsed.planFile,
+    only: parsed.only,
+    profile: parsed.profile,
+    mcpPacks: parsed.mcpPacks,
+    require: parsed.requireChecks,
+    platform: parsed.platform || 'claude',
+    format: parsed.format || null,
+    port: parsed.port !== null ? Number(parsed.port) : null,
+    workspace: parsed.workspace || null,
+    webhookUrl: parsed.webhookUrl || null,
+    external: parsed.external || null,
+    dir: process.cwd()
+  };
+
+  if (parsed.checkVersion) {
+    if (parsed.checkVersion !== version) {
+      console.error(`\n  Warning: --check-version ${parsed.checkVersion} does not match installed nerviq version ${version}.`);
+      console.error(`  Check catalog may differ between versions. To align, run: npm install @nerviq/cli@${parsed.checkVersion}`);
+      console.error('');
+    }
+    options.checkVersion = parsed.checkVersion;
+  }
+
+  if (parsed.teamProfile) {
+    const { loadProfile, applyProfileToOptions } = require('../src/profiles');
+    try {
+      const teamProf = loadProfile(options.dir, parsed.teamProfile);
+      const merged = applyProfileToOptions(teamProf, options);
+      Object.assign(options, merged);
+      if (!options.json) {
+        console.log(`  Using team profile: ${parsed.teamProfile}`);
+      }
+    } catch (err) {
+      console.error(`\n  Error: ${err.message}\n`);
+      process.exit(1);
+    }
+  }
+
+  const SUPPORTED_PLATFORMS = ['claude', 'codex', 'gemini', 'copilot', 'cursor', 'windsurf', 'aider', 'opencode'];
+  if (!SUPPORTED_PLATFORMS.includes(options.platform)) {
+    console.error(`\n  Error: Unsupported platform '${options.platform}'.`);
+    console.error(`  Supported platforms: ${SUPPORTED_PLATFORMS.join(', ')}.`);
+    console.error(`  To get started: npx nerviq setup`);
+    console.error(`  To diagnose issues: npx nerviq doctor`);
+    console.error('  Docs: https://github.com/nerviq/nerviq#cross-platform\n');
+    process.exit(1);
+  }
+
+  if (options.format !== null && !['json', 'sarif', 'otel'].includes(options.format)) {
+    console.error(`\n  Error: Unsupported format '${options.format}'. Use 'json', 'sarif', or 'otel'.\n`);
+    process.exit(1);
+  }
+
+  if (options.port !== null && (!Number.isInteger(options.port) || options.port < 0 || options.port > 65535)) {
+    console.error('\n  Error: --port must be an integer between 0 and 65535.\n');
+    process.exit(1);
+  }
+
+  if (options.threshold !== null && (!Number.isFinite(options.threshold) || options.threshold < 0 || options.threshold > 100)) {
+    console.error(`\n  Error: Invalid threshold value '${parsed.threshold}'.`);
+    console.error('  Why: --threshold must be a number between 0 and 100 representing the minimum passing score.');
+    console.error('  Fix: Use a valid number, e.g.: npx nerviq --threshold 70');
+    console.error('  Docs: https://github.com/nerviq/nerviq#ci-integration\n');
+    process.exit(1);
+  }
+
+  if (options.require && options.require.length > 0 && normalizedCommand !== 'audit' && !['audit', 'discover'].includes(command)) {
+    console.error(`\n  Warning: --require is only supported with the audit command. Ignoring for '${normalizedCommand}'.\n`);
+  }
+
+  if (!KNOWN_COMMANDS.includes(normalizedCommand)) {
+    const suggestion = suggestCommand(command);
+    console.error(`\n  Error: Unknown command '${command}'.`);
+    console.error(`  Why: '${command}' is not a recognized nerviq command or alias.`);
+    if (suggestion) {
+      console.error(`  Fix: Did you mean '${suggestion}'? Run: npx nerviq ${suggestion}`);
+    } else {
+      console.error('  Fix: Run nerviq --help to see all available commands.');
+    }
+    console.error('  Docs: https://github.com/nerviq/nerviq#readme\n');
+    process.exit(1);
+  }
+
+  if (!require('fs').existsSync(options.dir)) {
+    console.error(`\n  Error: Directory not found: ${options.dir}`);
+    console.error('  Why: The current working directory does not exist or is not accessible.');
+    console.error('  Fix: cd into your project directory first, then run nerviq.');
+    console.error('  Docs: https://github.com/nerviq/nerviq#getting-started\n');
+    process.exit(1);
+  }
+
+  if (['setup', 'apply', 'benchmark'].includes(normalizedCommand)) {
+    try {
+      ensureWritableProfile(options.profile, normalizedCommand, options.dryRun);
+    } catch (err) {
+      console.error(`\n  Error: ${err.message}\n`);
+      process.exit(1);
+    }
+  }
+
+  try {
+    const FULL_COMMAND_SET = new Set([
+      'audit', 'org', 'scan', 'badge', 'augment', 'suggest-only', 'setup', 'plan', 'apply',
+      'governance', 'benchmark', 'deep-review', 'interactive', 'watch', 'insights',
+      'history', 'compare', 'trend', 'feedback', 'catalog', 'certify', 'serve', 'help', 'version',
+      // Harmony + Synergy (cross-platform)
+      'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise',
+      'harmony-watch', 'harmony-governance', 'harmony-add', 'synergy-report', 'anti-patterns', 'rules-export',
+      'freshness', 'profile',
+    ]);
+
+    if (options.platform === 'codex') {
+      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
+        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform codex.`);
+        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
+        process.exit(1);
+      }
+    }
+
+    if (options.platform === 'gemini') {
+      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
+        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform gemini.`);
+        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
+        process.exit(1);
+      }
+    }
+
+    if (options.platform === 'copilot') {
+      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
+        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform copilot.`);
+        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
+        process.exit(1);
+      }
+    }
+
+    if (options.platform === 'cursor') {
+      if (!FULL_COMMAND_SET.has(normalizedCommand)) {
+        console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform cursor.`);
+        console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
+        process.exit(1);
+      }
+    }
+
+    for (const plat of ['windsurf', 'aider', 'opencode']) {
+      if (options.platform === plat) {
+        if (!FULL_COMMAND_SET.has(normalizedCommand)) {
+          console.error(`\n  Error: '${normalizedCommand}' is not supported for --platform ${plat}.`);
+          console.error('  Available: ' + [...FULL_COMMAND_SET].filter(c => c !== 'help' && c !== 'version').join(', ') + '.');
+          process.exit(1);
+        }
+      }
+    }
+
+    if (normalizedCommand === 'scan') {
+      const scanDirs = parsed.extraArgs;
+      if (scanDirs.length === 0) {
+        console.error('\n  Error: scan requires at least one directory argument.');
+        console.error('  Usage: npx nerviq scan dir1 dir2 dir3\n');
+        process.exit(1);
+      }
+      const summary = await scanOrg(scanDirs, options.platform);
+      printOrgSummary(summary, options);
+      if (options.threshold !== null && summary.averageScore < options.threshold) {
+        process.exit(1);
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'org') {
+      const subcommand = parsed.extraArgs[0];
+      const scanDirs = parsed.extraArgs.slice(1);
+      if (subcommand !== 'scan' || scanDirs.length === 0) {
+        console.error('\n  Error: org requires the scan subcommand and at least one directory.');
+        console.error('  Usage: npx nerviq org scan dir1 dir2 dir3\n');
+        process.exit(1);
+      }
+      const summary = await scanOrg(scanDirs, options.platform);
+      printOrgSummary(summary, options);
+      if (options.threshold !== null && summary.averageScore < options.threshold) {
+        process.exit(1);
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'history') {
+      const { formatHistory, readSnapshotIndex } = require('../src/activity');
+      // Handle --prune N
+      const pruneIdx = flags.indexOf('--prune');
+      if (pruneIdx >= 0) {
+        const keepCount = parseInt(flags[pruneIdx + 1] || parsed.extraArgs[0], 10) || 10;
+        const fsMod = require('fs');
+        const pathMod = require('path');
+        const entries = readSnapshotIndex(options.dir);
+        if (entries.length <= keepCount) {
+          console.log(`\n  Nothing to prune (${entries.length} snapshots, keeping ${keepCount}).\n`);
+        } else {
+          const toRemove = entries.slice(0, entries.length - keepCount);
+          let removed = 0;
+          for (const entry of toRemove) {
+            const fp = pathMod.join(options.dir, entry.relativePath);
+            try { fsMod.unlinkSync(fp); removed++; } catch {}
+          }
+          const kept = entries.slice(entries.length - keepCount);
+          const indexPath = pathMod.join(options.dir, '.nerviq', 'snapshots', 'index.json');
+          try { fsMod.writeFileSync(indexPath, JSON.stringify(kept, null, 2), 'utf8'); } catch {}
+          console.log(`\n  Pruned ${removed} snapshots, kept ${kept.length}.\n`);
+        }
+        process.exit(0);
+      }
+      console.log('');
+      console.log(formatHistory(options.dir));
+      console.log('');
+      process.exit(0);
+    } else if (normalizedCommand === 'compare') {
+      const { compareLatest } = require('../src/activity');
+      const result = compareLatest(options.dir);
+      if (!result) {
+        console.log('\n  Need at least 2 snapshots to compare. Run `npx nerviq --snapshot` twice.\n');
+        process.exit(0);
+      }
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        const sign = result.delta.score >= 0 ? '+' : '';
+        console.log('');
+        console.log(`  Previous: ${result.previous.score}/100 (${result.previous.date?.split('T')[0]})`);
+        console.log(`  Current:  ${result.current.score}/100 (${result.current.date?.split('T')[0]})`);
+        console.log(`  Delta:    ${sign}${result.delta.score} points`);
+        console.log(`  Trend:    ${result.trend}`);
+        if (result.improvements.length > 0) console.log(`  Fixed:    ${result.improvements.join(', ')}`);
+        if (result.regressions.length > 0) console.log(`  New gaps: ${result.regressions.join(', ')}`);
+        console.log('');
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'trend') {
+      const { exportTrendReport } = require('../src/activity');
+      const report = exportTrendReport(options.dir);
+      if (!report) {
+        console.log('\n  No snapshots found. Run `npx nerviq --snapshot` to start tracking.\n');
+        process.exit(0);
+      }
+      if (options.out) {
+        require('fs').writeFileSync(options.out, report, 'utf8');
+        console.log(`\n  Trend report exported to ${options.out}\n`);
+      } else {
+        console.log(report);
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'badge') {
+      const { getBadgeMarkdown } = require('../src/badge');
+      const result = await audit({ ...options, silent: true });
+      console.log(getBadgeMarkdown(result.score));
+      console.log('');
+      console.log('Add this to your README.md');
+      process.exit(0);
+    } else if (normalizedCommand === 'insights') {
+      const https = require('https');
+      const url = 'https://claudex-insights.claudex.workers.dev/v1/stats';
+      const req = https.get(url, (res) => {
+        let data = '';
+        res.on('data', chunk => data += chunk);
+        res.on('end', () => {
+          try {
+            const stats = JSON.parse(data);
+            console.log('');
+            console.log('\x1b[1m  CLAUDEX Community Insights\x1b[0m');
+            console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+            console.log(`  Total audits run: \x1b[1m${stats.totalRuns}\x1b[0m`);
+            console.log(`  Average score: \x1b[1m${stats.averageScore}/100\x1b[0m`);
+            console.log('');
+            if (stats.topFailedChecks && stats.topFailedChecks.length > 0) {
+              console.log('\x1b[33m  Most common gaps:\x1b[0m');
+              for (const f of stats.topFailedChecks.slice(0, 5)) {
+                console.log(`     ${f.pct}% miss: \x1b[1m${f.check}\x1b[0m`);
+              }
+              console.log('');
+            }
+            if (stats.topStacks && stats.topStacks.length > 0) {
+              console.log('\x1b[36m  Popular stacks:\x1b[0m');
+              console.log(`     ${stats.topStacks.map(s => s.stack).join(', ')}`);
+            }
+            console.log('');
+          } catch (e) {
+            console.log('  No community data available yet. Be the first to run: npx nerviq');
+          }
+        });
+      }).on('error', () => {
+        console.log('  Could not reach insights server. Run locally: npx nerviq');
+      });
+      req.setTimeout(10000, () => {
+        req.destroy();
+        console.log('  Insights request timed out. Run locally: npx nerviq');
+      });
+      return; // keep process alive for http
+    } else if (normalizedCommand === 'feedback') {
+      if (flags.includes('--patterns')) {
+        if (options.json) {
+          const { getUsageSummary } = require('../src/usage-patterns');
+          console.log(JSON.stringify(getUsageSummary(options.dir), null, 2));
+        } else {
+          console.log('');
+          console.log(formatUsageSummary(options.dir));
+          console.log('');
+        }
+        process.exit(0);
+      }
+      if (parsed.feedbackKey) {
+        if (!parsed.feedbackStatus) {
+          console.error('\n  Error: feedback logging requires --status when --key is provided.\n');
+          process.exit(1);
+        }
+        const artifact = recordRecommendationOutcome(options.dir, {
+          key: parsed.feedbackKey,
+          status: parsed.feedbackStatus,
+          effect: parsed.feedbackEffect || 'neutral',
+          notes: parsed.feedbackNotes || '',
+          source: parsed.feedbackSource || 'manual-cli',
+          scoreDelta: parsed.feedbackScoreDelta !== null ? Number(parsed.feedbackScoreDelta) : null,
+        });
+        const summary = getRecommendationOutcomeSummary(options.dir);
+        if (options.json) {
+          console.log(JSON.stringify({ artifact, summary }, null, 2));
+        } else {
+          console.log('');
+          console.log(`  Feedback recorded for ${parsed.feedbackKey}`);
+          console.log(`  Artifact: ${artifact.relativePath}`);
+          console.log('');
+          console.log(formatRecommendationOutcomeSummary(options.dir));
+          console.log('');
+        }
+      } else {
+        if (options.json) {
+          console.log(JSON.stringify(getRecommendationOutcomeSummary(options.dir), null, 2));
+        } else {
+          console.log('');
+          console.log(formatRecommendationOutcomeSummary(options.dir));
+          console.log('');
+        }
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'augment' || normalizedCommand === 'suggest-only') {
+      const report = await analyzeProject({ ...options, mode: normalizedCommand });
+      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, normalizedCommand, report, {
+        sourceCommand: normalizedCommand,
+      }) : null;
+      if (options.out && !options.json) {
+        const fs = require('fs');
+        const md = exportMarkdown(report);
+        fs.writeFileSync(options.out, md, 'utf8');
+        console.log(`\n  Report exported to ${options.out}\n`);
+      }
+      printAnalysis(report, options);
+      if (snapshot && !options.json) {
+        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
+        console.log(`  Snapshot index: ${snapshot.indexPath}`);
+        console.log('');
+      }
+    } else if (normalizedCommand === 'plan') {
+      const bundle = await buildProposalBundle(options);
+      let artifact = null;
+      if (options.out) {
+        artifact = writePlanFile(bundle, options.out);
+      }
+      printProposalBundle(bundle, options);
+      if (options.out && !options.json) {
+        console.log(`  Plan written to ${options.out}`);
+        if (artifact) {
+          console.log(`  Activity log: ${artifact.relativePath}`);
+        }
+        console.log('');
+      }
+    } else if (normalizedCommand === 'rollback') {
+      const fsMod = require('fs');
+      const pathMod = require('path');
+      const rollbackDir = pathMod.join(options.dir, '.nerviq', 'rollbacks');
+
+      if (!fsMod.existsSync(rollbackDir)) {
+        console.log('\n  No rollback artifacts found. Run `nerviq apply` first to create rollback data.\n');
+        process.exit(0);
+      }
+
+      const rollbackFiles = fsMod.readdirSync(rollbackDir)
+        .filter(f => f.endsWith('.json'))
+        .sort()
+        .reverse();
+
+      if (rollbackFiles.length === 0) {
+        console.log('\n  No rollback artifacts found.\n');
+        process.exit(0);
+      }
+
+      // --list mode
+      if (flags.includes('--list')) {
+        console.log(`\n  Rollback points (${rollbackFiles.length}):\n`);
+        for (const f of rollbackFiles) {
+          try {
+            const data = JSON.parse(fsMod.readFileSync(pathMod.join(rollbackDir, f), 'utf8'));
+            const created = (data.createdFiles || []).length;
+            const patched = (data.patchedFiles || []).length;
+            console.log(`  ${f.replace('.json', '')}  (${created} created, ${patched} patched)`);
+          } catch {
+            console.log(`  ${f}  (unreadable)`);
+          }
+        }
+        console.log(`\n  Run \`nerviq rollback\` to undo the most recent.\n`);
+        process.exit(0);
+      }
+
+      // Execute rollback of most recent
+      const latestFile = rollbackFiles[0];
+      const latestPath = pathMod.join(rollbackDir, latestFile);
+      let rollbackData;
+      try {
+        rollbackData = JSON.parse(fsMod.readFileSync(latestPath, 'utf8'));
+      } catch (e) {
+        console.error(`\n  Error: Cannot parse rollback file: ${e.message}\n`);
+        process.exit(1);
+      }
+
+      const createdFiles = rollbackData.createdFiles || [];
+      if (createdFiles.length === 0) {
+        console.log('\n  Rollback artifact has no files to remove.\n');
+        process.exit(0);
+      }
+
+      if (options.dryRun) {
+        console.log(`\n  [dry-run] Would delete ${createdFiles.length} files:\n`);
+        for (const f of createdFiles) {
+          console.log(`    - ${f}`);
+        }
+        console.log('');
+        process.exit(0);
+      }
+
+      let deleted = 0;
+      let missing = 0;
+      console.log('');
+      for (const relPath of createdFiles) {
+        const fullPath = pathMod.join(options.dir, relPath);
+        if (fsMod.existsSync(fullPath)) {
+          fsMod.unlinkSync(fullPath);
+          console.log(`  🗑️  Deleted: ${relPath}`);
+          deleted++;
+        } else {
+          missing++;
+        }
+      }
+
+      // Remove rollback artifact after use
+      fsMod.unlinkSync(latestPath);
+
+      console.log(`\n  Rollback complete: ${deleted} files deleted${missing > 0 ? `, ${missing} already missing` : ''}.\n`);
+
+    } else if (normalizedCommand === 'apply') {
+      if (flags.includes('--rollback')) {
+        console.error('\n  Error: --rollback is not yet supported as a flag.');
+        console.error('  Why: Rollback artifacts are saved in .nerviq/rollbacks/ but automatic rollback is not implemented yet.');
+        console.error('  Fix: Manually delete the files listed in .nerviq/rollbacks/<latest>.json, or use `nerviq apply --dry-run` to preview before applying.');
+        console.error('  Docs: https://github.com/nerviq/nerviq#rollback\n');
+        process.exit(1);
+      }
+      const result = await applyProposalBundle(options);
+      printApplyResult(result, options);
+    } else if (normalizedCommand === 'governance') {
+      const fs = require('fs');
+      const path = require('path');
+      const summary = getGovernanceSummary(options.platform);
+      if (options.out) {
+        fs.mkdirSync(path.dirname(options.out), { recursive: true });
+        const content = path.extname(options.out).toLowerCase() === '.md'
+          ? renderGovernanceMarkdown(summary)
+          : JSON.stringify(summary, null, 2);
+        fs.writeFileSync(options.out, content, 'utf8');
+      }
+      printGovernanceSummary(summary, options);
+      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, 'governance', summary, {
+        sourceCommand: normalizedCommand,
+      }) : null;
+      if (options.out && !options.json) {
+        console.log(`  Governance report written to ${options.out}`);
+        console.log('');
+      }
+      if (snapshot && !options.json) {
+        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
+        console.log(`  Snapshot index: ${snapshot.indexPath}`);
+        console.log('');
+      }
+    } else if (normalizedCommand === 'benchmark') {
+      const report = await runBenchmark(options);
+      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, 'benchmark', report, {
+        sourceCommand: normalizedCommand,
+      }) : null;
+      if (options.out) {
+        writeBenchmarkReport(report, options.out);
+      }
+      printBenchmark(report, options);
+      if (options.out && !options.json) {
+        console.log(`  Benchmark report written to ${options.out}`);
+        console.log('');
+      }
+      if (snapshot && !options.json) {
+        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
+        console.log(`  Snapshot index: ${snapshot.indexPath}`);
+        console.log('');
+      }
+    } else if (normalizedCommand === 'deep-review') {
+      const { deepReview } = require('../src/deep-review');
+      await deepReview(options);
+    } else if (normalizedCommand === 'interactive') {
+      const { interactive } = require('../src/interactive');
+      await interactive(options);
+    } else if (normalizedCommand === 'watch') {
+      const { watch } = require('../src/watch');
+      await watch(options);
+    } else if (normalizedCommand === 'catalog') {
+      const { generateCatalog, generateCatalogWithVersion, writeCatalogJson } = require('../src/catalog');
+      if (options.out) {
+        const result = writeCatalogJson(options.out);
+        if (options.json) {
+          console.log(JSON.stringify({ path: result.path, count: result.count }));
+        } else {
+          console.log(`\n  Catalog written to ${result.path} (${result.count} checks)\n`);
+        }
+      } else {
+        const catalog = generateCatalog();
+        if (options.json) {
+          const envelope = generateCatalogWithVersion();
+          if (options.checkVersion) envelope.requestedVersion = options.checkVersion;
+          console.log(JSON.stringify(envelope, null, 2));
+        } else {
+          // Print summary table
+          const platforms = {};
+          for (const entry of catalog) {
+            platforms[entry.platform] = (platforms[entry.platform] || 0) + 1;
+          }
+          console.log('');
+          console.log('\x1b[1m  nerviq check catalog\x1b[0m');
+          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+          console.log(`  Total checks: \x1b[1m${catalog.length}\x1b[0m`);
+          console.log('');
+          for (const [plat, count] of Object.entries(platforms)) {
+            console.log(`    ${plat.padEnd(12)} ${count} checks`);
+          }
+          console.log('');
+          console.log('  Use --json for full output or --out catalog.json to write file.');
+          console.log('');
+        }
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'certify') {
+      const { certifyProject, generateCertBadge } = require('../src/certification');
+      const certResult = await certifyProject(options.dir);
+      if (options.json) {
+        console.log(JSON.stringify(certResult, null, 2));
+      } else {
+        console.log('');
+        console.log('\x1b[1m  nerviq certification\x1b[0m');
+        console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+        console.log('');
+        console.log(`  Level: \x1b[1m${certResult.level}\x1b[0m`);
+        console.log(`  Harmony Score: ${certResult.harmonyScore}/100`);
+        console.log('');
+        if (Object.keys(certResult.platformScores).length > 0) {
+          console.log('  Platform Scores:');
+          for (const [plat, score] of Object.entries(certResult.platformScores)) {
+            const scoreColor = score >= 70 ? '\x1b[32m' : score >= 40 ? '\x1b[33m' : '\x1b[31m';
+            console.log(`    ${plat.padEnd(12)} ${scoreColor}${score}/100\x1b[0m`);
+          }
+          console.log('');
+        }
+        console.log('  Badge:');
+        console.log(`  ${certResult.badge}`);
+        console.log('');
+        console.log('  Add the badge to your README.md');
+        console.log('');
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'serve') {
+      const server = await startServer({
+        port: options.port == null ? 3000 : options.port,
+        baseDir: options.dir,
+      });
+      const address = server.address();
+      const resolvedPort = address && typeof address === 'object' ? address.port : options.port;
+      console.log('');
+      console.log(`  nerviq API listening on http://127.0.0.1:${resolvedPort}`);
+      console.log('  Endpoints: /api/health, /api/catalog, /api/audit, /api/harmony');
+      console.log('');
+
+      const closeServer = () => {
+        server.close(() => process.exit(0));
+      };
+
+      process.on('SIGINT', closeServer);
+      process.on('SIGTERM', closeServer);
+      return;
+    } else if (normalizedCommand === 'harmony-audit') {
+      const { runHarmonyAudit } = require('../src/harmony/cli');
+      await runHarmonyAudit(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-sync') {
+      const { previewHarmonySync, applyHarmonySync } = require('../src/harmony/sync');
+      const dir = options.dir || process.cwd();
+
+      if (options.fix) {
+        // Apply mode: write files
+        const result = applyHarmonySync(dir);
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log('');
+          console.log('\x1b[1m  Harmony Sync — Apply\x1b[0m');
+          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+          console.log('');
+          if (result.applied.length === 0 && result.skipped.length === 0) {
+            console.log('  \x1b[32mAll platforms are already in sync. Nothing to apply.\x1b[0m');
+          } else {
+            for (const item of result.applied) {
+              console.log(`  \x1b[32m✓\x1b[0m ${item.action.padEnd(8)} ${item.platform.padEnd(12)} ${item.path}`);
+            }
+            for (const item of result.skipped) {
+              const reason = typeof item === 'string' ? item : (item.reason || item.path);
+              console.log(`  \x1b[33m⚠\x1b[0m skipped  ${reason}`);
+            }
+            console.log('');
+            if (result.summary) {
+              console.log(`  Files: ${result.summary.totalFiles} (${result.summary.creates} created, ${result.summary.patches} patched)`);
+              console.log(`  Platforms: ${result.summary.platforms.join(', ')}`);
+            }
+          }
+          if (result.warnings && result.warnings.length > 0) {
+            console.log('');
+            for (const w of result.warnings) {
+              console.log(`  \x1b[33m⚠\x1b[0m ${w}`);
+            }
+          }
+          console.log('');
+        }
+      } else {
+        // Preview mode (dry run)
+        const plan = previewHarmonySync(dir);
+        if (options.json) {
+          console.log(JSON.stringify(plan, null, 2));
+        } else {
+          console.log('');
+          console.log('\x1b[1m  Harmony Sync — Preview\x1b[0m');
+          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+          console.log('');
+          if (plan.files.length === 0) {
+            console.log('  \x1b[32mAll platforms are already in sync. No changes needed.\x1b[0m');
+          } else {
+            for (const file of plan.files) {
+              const actionColor = file.action === 'create' ? '\x1b[32m' : '\x1b[36m';
+              console.log(`  ${actionColor}${file.action.padEnd(8)}\x1b[0m ${file.platform.padEnd(12)} ${file.path}`);
+              if (file.preview) {
+                console.log(`           \x1b[2m${file.preview}\x1b[0m`);
+              }
+            }
+            console.log('');
+            console.log(`  Total: ${plan.summary.totalFiles} file(s) — ${plan.summary.creates} create, ${plan.summary.patches} patch`);
+            console.log(`  Platforms: ${plan.summary.platforms.join(', ')}`);
+            if (plan.summary.recommendedTrust) {
+              console.log(`  Recommended trust: ${plan.summary.recommendedTrust}`);
+            }
+            console.log('');
+            console.log('  Run \x1b[1mnerviq harmony-sync --fix\x1b[0m to apply these changes.');
+          }
+          if (plan.warnings && plan.warnings.length > 0) {
+            console.log('');
+            for (const w of plan.warnings) {
+              console.log(`  \x1b[33m⚠\x1b[0m ${w}`);
+            }
+          }
+          console.log('');
+        }
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-drift') {
+      const { runHarmonyDrift } = require('../src/harmony/cli');
+      await runHarmonyDrift(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-advise') {
+      const { runHarmonyAdvise } = require('../src/harmony/cli');
+      await runHarmonyAdvise(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-watch') {
+      const { runHarmonyWatch } = require('../src/harmony/cli');
+      await runHarmonyWatch(options);
+    } else if (normalizedCommand === 'harmony-governance') {
+      const { runHarmonyGovernance } = require('../src/harmony/cli');
+      await runHarmonyGovernance(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-add') {
+      const { addPlatform } = require('../src/harmony/add');
+      const platformArg = parsed.extraArgs[0];
+      if (!platformArg) {
+        console.log('\n  Usage: nerviq harmony-add <platform>');
+        console.log('  Available: claude, codex, gemini, copilot, cursor, windsurf, aider, opencode\n');
+        process.exit(1);
+      }
+      const dir = options.dir || process.cwd();
+      const result = addPlatform(dir, platformArg.toLowerCase());
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else if (result.success) {
+        console.log(`\n  \x1b[32m\u2713\x1b[0m Added ${result.platform} to project`);
+        result.created.forEach(f => console.log(`     Created: ${f}`));
+        console.log(`     Platforms: ${result.beforeCount} \u2192 ${result.afterCount}`);
+        if (result.syncApplied > 0) console.log(`     Harmony sync: ${result.syncApplied} file(s) updated`);
+        console.log('');
+      } else {
+        console.log(`\n  \x1b[31m\u2717\x1b[0m ${result.error}\n`);
+        process.exit(1);
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'anti-patterns') {
+      const showAll = flags.includes('--all');
+      if (showAll) {
+        printAntiPatternCatalog(options);
+      } else {
+        const { ProjectContext } = require('../src/context');
+        const ctx = new ProjectContext(options.dir);
+        const detected = detectAntiPatterns(ctx);
+        printAntiPatterns(detected, options);
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'rules-export') {
+      const { generateRecommendationRules } = require('../src/recommendation-rules');
+      const rules = generateRecommendationRules();
+      if (options.json) {
+        console.log(JSON.stringify(rules, null, 2));
+      } else if (options.out) {
+        require('fs').writeFileSync(options.out, JSON.stringify(rules, null, 2), 'utf8');
+        console.log(`\n  Rules exported to ${options.out} (${rules.totalRules} rules)\n`);
+      } else {
+        // Human-readable summary
+        console.log(`\n  Nerviq Recommendation Rules (${rules.totalRules} rules)\n`);
+        const byCategory = {};
+        for (const rule of (rules.rules || [])) {
+          const cat = rule.category || 'other';
+          if (!byCategory[cat]) byCategory[cat] = 0;
+          byCategory[cat]++;
+        }
+        for (const [cat, count] of Object.entries(byCategory).sort((a, b) => b[1] - a[1])) {
+          console.log(`  ${cat.padEnd(20)} ${count} rules`);
+        }
+        console.log(`\n  Use --json for full output or --out <file> to save.\n`);
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'dashboard') {
+      const dashFlags = {
+        out: options.out,
+        open: flags.includes('--open'),
+        json: options.json,
+        platform: options.platform,
+      };
+      if (parsed.repos && parsed.repos.length > 0) {
+        const { generatePortfolioDashboard } = require('../src/dashboard');
+        await generatePortfolioDashboard(parsed.repos, dashFlags);
+      } else {
+        const { generateDashboard } = require('../src/dashboard');
+        await generateDashboard(options.dir, dashFlags);
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'check-health') {
+      const { checkHealth, formatCheckHealth } = require('../src/activity');
+      const report = checkHealth(options.dir);
+      if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+      } else {
+        console.log('');
+        console.log(formatCheckHealth(report));
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'freshness') {
+      const { TECHNIQUES } = require('../src/techniques');
+      const stats = getVerificationStats();
+      const allKeys = Object.keys(TECHNIQUES);
+      const verifiedKeys = Object.keys(VERIFICATION_DATES);
+      const neverVerified = allKeys.filter(k => !VERIFICATION_DATES[k]);
+
+      if (options.json) {
+        console.log(JSON.stringify({
+          totalChecks: allKeys.length,
+          verifiedChecks: verifiedKeys.length,
+          neverVerifiedCount: neverVerified.length,
+          newestVerification: stats.newest,
+          oldestVerification: stats.oldest,
+          neverVerified,
+        }, null, 2));
+      } else {
+        console.log('');
+        console.log('  nerviq freshness');
+        console.log('  ═══════════════════════════════════════');
+        console.log(`  Total checks:            ${allKeys.length}`);
+        console.log(`  With verification date:  ${verifiedKeys.length}`);
+        console.log(`  Never verified:          ${neverVerified.length}`);
+        console.log(`  Newest verification:     ${stats.newest}`);
+        console.log(`  Oldest verification:     ${stats.oldest}`);
+        console.log('');
+        if (neverVerified.length > 0 && options.verbose) {
+          console.log('  Never verified:');
+          for (const key of neverVerified) {
+            console.log(`    - ${key}`);
+          }
+          console.log('');
+        } else if (neverVerified.length > 0) {
+          console.log(`  Use --verbose to list all ${neverVerified.length} never-verified checks.`);
+          console.log('');
+        }
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'suggest-rules') {
+      const { analyzeSuggestions, formatSuggestions } = require('../src/auto-suggest');
+      const suggestions = analyzeSuggestions(options.dir);
+      if (options.json) {
+        console.log(JSON.stringify(suggestions, null, 2));
+      } else {
+        console.log('');
+        console.log(formatSuggestions(suggestions));
+        console.log('');
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'profile') {
+      const { saveProfile, loadProfile, listProfiles, exportProfile, formatProfileList, formatProfile } = require('../src/profiles');
+      const subcommand = parsed.extraArgs[0];
+      const profileArg = parsed.extraArgs[1];
+
+      if (!subcommand || subcommand === 'list') {
+        const profiles = listProfiles(options.dir);
+        console.log('');
+        console.log(formatProfileList(profiles));
+        console.log('');
+        process.exit(0);
+      } else if (subcommand === 'save') {
+        if (!profileArg) {
+          console.error('\n  Error: Profile name required. Usage: nerviq profile save <name>\n');
+          process.exit(1);
+        }
+        const result = saveProfile(options.dir, profileArg, {
+          platforms: [options.platform],
+          threshold: options.threshold,
+          suppressedChecks: [],
+          priorityBoosts: [],
+          description: '',
+        });
+        if (options.json) {
+          console.log(JSON.stringify(result.profile, null, 2));
+        } else {
+          console.log(`\n  Profile '${profileArg}' saved to ${result.path}\n`);
+        }
+        process.exit(0);
+      } else if (subcommand === 'load') {
+        if (!profileArg) {
+          console.error('\n  Error: Profile name required. Usage: nerviq profile load <name>\n');
+          process.exit(1);
+        }
+        const profile = loadProfile(options.dir, profileArg);
+        if (options.json) {
+          console.log(JSON.stringify(profile, null, 2));
+        } else {
+          console.log('');
+          console.log(formatProfile(profile));
+          console.log('');
+        }
+        process.exit(0);
+      } else if (subcommand === 'export') {
+        if (!profileArg) {
+          console.error('\n  Error: Profile name required. Usage: nerviq profile export <name>\n');
+          process.exit(1);
+        }
+        const json = exportProfile(options.dir, profileArg);
+        if (options.out) {
+          require('fs').writeFileSync(options.out, json, 'utf8');
+          console.log(`\n  Profile exported to ${options.out}\n`);
+        } else {
+          console.log(json);
+        }
+        process.exit(0);
+      } else {
+        console.error(`\n  Error: Unknown profile subcommand '${subcommand}'.`);
+        console.error('  Usage: nerviq profile save|load|list|export <name>\n');
+        process.exit(1);
+      }
+    } else if (normalizedCommand === 'synergy-report') {
+      // Placeholder — synergy report is referenced but may not be implemented yet
+      console.log('\n  Synergy report: coming soon.\n');
+      process.exit(0);
+    } else if (normalizedCommand === 'doctor') {
+      const { runDoctor } = require('../src/doctor');
+      const output = await runDoctor({ dir: options.dir, json: options.json, verbose: options.verbose });
+      console.log(output);
+      process.exit(0);
+    } else if (normalizedCommand === 'convert') {
+      const { runConvert } = require('../src/convert');
+      const output = await runConvert({
+        dir: options.dir,
+        from: parsed.convertFrom,
+        to: parsed.convertTo,
+        dryRun: options.dryRun,
+        json: options.json,
+      });
+      console.log(output);
+      process.exit(0);
+    } else if (normalizedCommand === 'migrate') {
+      const { runMigrate } = require('../src/migrate');
+      const output = await runMigrate({
+        dir: options.dir,
+        platform: options.platform || parsed.platform || 'claude',
+        from: parsed.migrateFrom,
+        to: parsed.migrateTo,
+        dryRun: options.dryRun,
+        json: options.json,
+      });
+      console.log(output);
+      process.exit(0);
+    } else if (normalizedCommand === 'fix') {
+      // nerviq fix [key] [--all-critical] [--dry-run] [--auto] [--prompt]
+      const fixKey = parsed.extraArgs[0] || null;
+      const allCritical = flags.includes('--all-critical');
+      const promptOnly = flags.includes('--prompt');
+      const autoApply = options.auto || options.dryRun;
+
+      // Step 1: Run silent audit to find failed checks (only actual failures, not skipped/null)
+      const auditResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
+      const failedResults = (auditResult.results || []).filter(r => r.passed === false);
+
+      if (failedResults.length === 0) {
+        console.log('\n  ✅ All checks passing — nothing to fix.\n');
+        process.exit(0);
+      }
+
+      // Step 2: Determine which checks to fix
+      const { TECHNIQUES } = require('../src/techniques');
+      const { FIX_PROMPTS, formatFixPrompt } = require('../src/fix-prompts');
+      const fs = require('fs');
+      const pathMod = require('path');
+
+      // Inline fixers for checks without templates but with trivial auto-fixes
+      const INLINE_FIXERS = {
+        gitIgnoreEnv: (dir) => {
+          const gitignorePath = pathMod.join(dir, '.gitignore');
+          const existing = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf8') : '';
+          if (!existing.includes('.env')) {
+            const lines = existing.endsWith('\n') || existing === '' ? '' : '\n';
+            fs.appendFileSync(gitignorePath, `${lines}.env\n.env.*\n`, 'utf8');
+            return true;
+          }
+          return false;
+        },
+        secretsProtection: (dir) => {
+          const settingsPath = pathMod.join(dir, '.claude', 'settings.json');
+          const settingsDir = pathMod.join(dir, '.claude');
+          if (!fs.existsSync(settingsDir)) fs.mkdirSync(settingsDir, { recursive: true });
+          let settings = {};
+          if (fs.existsSync(settingsPath)) {
+            try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch { settings = {}; }
+          }
+          if (!settings.permissions) settings.permissions = {};
+          if (!settings.permissions.deny) settings.permissions.deny = [];
+          const denyEntries = ['.env', '.env.*', '**/.env', '**/*.pem', '**/secrets/**'];
+          for (const entry of denyEntries) {
+            if (!settings.permissions.deny.includes(entry)) settings.permissions.deny.push(entry);
+          }
+          fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+          return true;
+        },
+      };
+
+      let targetKeys = [];
+
+      if (fixKey) {
+        // Fix a specific check
+        if (!failedResults.find(r => r.key === fixKey)) {
+          const passed = (auditResult.results || []).find(r => r.key === fixKey && r.passed);
+          if (passed) {
+            console.log(`\n  ✅ '${fixKey}' is already passing.\n`);
+          } else {
+            console.log(`\n  Error: Unknown check key '${fixKey}'.`);
+            console.log(`  Fix: Run 'nerviq audit --full' to see all check keys.\n`);
+          }
+          process.exit(1);
+        }
+        // --prompt flag: show AI prompt and exit without attempting fix
+        if (promptOnly) {
+          const prompt = FIX_PROMPTS[fixKey];
+          if (prompt) {
+            console.log(formatFixPrompt(fixKey, prompt));
+          } else {
+            const failedCheck = failedResults.find(r => r.key === fixKey);
+            console.log(`\n  No AI prompt available for '${fixKey}'.`);
+            console.log(`  Manual fix: ${failedCheck ? failedCheck.fix : 'See nerviq audit --full.'}\n`);
+          }
+          process.exit(0);
+        }
+        targetKeys = [fixKey];
+      } else if (allCritical) {
+        targetKeys = failedResults.filter(r => r.impact === 'critical').map(r => r.key);
+        if (targetKeys.length === 0) {
+          console.log('\n  ✅ No critical issues found.\n');
+          process.exit(0);
+        }
+      } else {
+        // No key specified — show fixable checks and exit
+        const INLINE_FIX_KEYS = new Set(Object.keys(INLINE_FIXERS));
+        const fixable = failedResults.filter(r => (TECHNIQUES[r.key] && TECHNIQUES[r.key].template) || INLINE_FIX_KEYS.has(r.key));
+        const nonFixable = failedResults.filter(r => !(TECHNIQUES[r.key] && TECHNIQUES[r.key].template) && !INLINE_FIX_KEYS.has(r.key));
+        console.log('');
+        console.log(`  nerviq fix — ${failedResults.length} failed checks\n`);
+        if (fixable.length > 0) {
+          console.log(`  Auto-fixable (${fixable.length}):`);
+          for (const r of fixable) {
+            const tier = r.impact === 'critical' ? '🔴' : r.impact === 'high' ? '🟡' : '🔵';
+            console.log(`    ${tier} nerviq fix ${r.key}`);
+          }
+          console.log('');
+        }
+        if (nonFixable.length > 0) {
+          const withPrompt = nonFixable.filter(r => FIX_PROMPTS[r.key]);
+          const withoutPrompt = nonFixable.filter(r => !FIX_PROMPTS[r.key]);
+          if (withPrompt.length > 0) {
+            console.log(`  AI prompt available (${withPrompt.length}):`);
+            for (const r of withPrompt.slice(0, 5)) {
+              const tier = r.impact === 'critical' ? '🔴' : r.impact === 'high' ? '🟡' : '🔵';
+              console.log(`    ${tier} nerviq fix ${r.key} --prompt`);
+            }
+            if (withPrompt.length > 5) {
+              console.log(`    ... and ${withPrompt.length - 5} more`);
+            }
+            console.log('');
+          }
+          if (withoutPrompt.length > 0) {
+            console.log(`  Manual fix needed (${withoutPrompt.length}):`);
+            for (const r of withoutPrompt.slice(0, 5)) {
+              const tier = r.impact === 'critical' ? '🔴' : r.impact === 'high' ? '🟡' : '🔵';
+              console.log(`    ${tier} ${r.key}: ${r.fix}`);
+            }
+            if (withoutPrompt.length > 5) {
+              console.log(`    ... and ${withoutPrompt.length - 5} more (use --full to see all)`);
+            }
+            console.log('');
+          }
+        }
+        if (fixable.length > 0) {
+          console.log(`  Quick actions:`);
+          console.log(`    nerviq fix ${fixable[0].key}        Fix the first auto-fixable check`);
+          console.log(`    nerviq fix --all-critical    Fix all critical issues at once`);
+        }
+        console.log('');
+        process.exit(0);
+      }
+
+      // Step 2.5: Predict impact and show preview before applying
+      const IMPACT_WEIGHTS = { critical: 15, high: 10, medium: 5, low: 2 };
+      const preScore = auditResult.score;
+      const applicableResults = (auditResult.results || []).filter(r => r.passed !== null);
+      const maxScore = applicableResults.reduce((sum, r) => sum + (IMPACT_WEIGHTS[r.impact] || 5), 0);
+
+      // Compute predicted score by simulating target fixes as passing
+      const targetKeySet = new Set(targetKeys);
+      const INLINE_FIX_KEYS = new Set(Object.keys(INLINE_FIXERS));
+      const fixableTargets = targetKeys.filter(k => {
+        const tech = TECHNIQUES[k];
+        return (tech && tech.template) || INLINE_FIX_KEYS.has(k);
+      });
+      const fixableTargetSet = new Set(fixableTargets);
+      const simulatedEarned = applicableResults.reduce((sum, r) => {
+        const w = IMPACT_WEIGHTS[r.impact] || 5;
+        if (r.passed) return sum + w;
+        if (fixableTargetSet.has(r.key)) return sum + w;
+        return sum;
+      }, 0);
+      const predictedScore = maxScore > 0 ? Math.round((simulatedEarned / maxScore) * 100) : 0;
+      const predictedDelta = predictedScore - preScore;
+
+      if (!autoApply) {
+        console.log('');
+        if (allCritical && fixableTargets.length > 1) {
+          // Multi-fix summary
+          console.log(`  ${fixableTargets.length} critical fixes available:`);
+          let runningEarned = applicableResults.reduce((s, r) => s + (r.passed ? (IMPACT_WEIGHTS[r.impact] || 5) : 0), 0);
+          let runningScore = maxScore > 0 ? Math.round((runningEarned / maxScore) * 100) : 0;
+          fixableTargets.forEach((k, idx) => {
+            const r = failedResults.find(fr => fr.key === k);
+            const w = IMPACT_WEIGHTS[r.impact] || 5;
+            const nextEarned = runningEarned + w;
+            const nextScore = maxScore > 0 ? Math.round((nextEarned / maxScore) * 100) : 0;
+            const d = nextScore - runningScore;
+            console.log(`  ${idx + 1}. ${(r.key).padEnd(18)} ${runningScore} → ${nextScore} (+${d})`);
+            runningEarned = nextEarned;
+            runningScore = nextScore;
+          });
+          console.log('');
+          console.log(`  Total: ${preScore} → ${predictedScore} (+${predictedDelta})`);
+        } else {
+          // Single fix preview
+          const targetCheck = failedResults.find(r => r.key === fixableTargets[0]) || failedResults.find(r => r.key === targetKeys[0]);
+          if (targetCheck) {
+            console.log(`  Predicted impact: ${preScore} → ${predictedScore} (+${predictedDelta})`);
+          }
+        }
+
+        // Prompt for confirmation
+        const readline = require('readline');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await new Promise(resolve => {
+          rl.question('  Apply? (Y/n) ', resolve);
+        });
+        rl.close();
+        if (answer && answer.trim().toLowerCase() === 'n') {
+          for (const key of targetKeys) {
+            recordPattern(options.dir, key, 'rejected');
+          }
+          console.log('\n  Aborted.\n');
+          process.exit(0);
+        }
+      }
+
+      // Step 3: Create rollback snapshot before applying fixes
+      const isBatch = allCritical && targetKeys.length > 1;
+      let rollbackId = null;
+      const allCreatedFiles = [];
+      const fixResults = []; // { key, name, status, delta }
+
+      if (!options.dryRun && targetKeys.length > 0) {
+        // Snapshot existing files for rollback
+        const snapshotFiles = {};
+        for (const key of targetKeys) {
+          const technique = TECHNIQUES[key];
+          if (technique && technique.template && technique.template.path) {
+            const tplPath = pathMod.join(options.dir, technique.template.path);
+            if (fs.existsSync(tplPath)) {
+              snapshotFiles[technique.template.path] = fs.readFileSync(tplPath, 'utf8');
+            }
+          }
+        }
+        const rollbackArtifact = writeRollbackArtifact(options.dir, {
+          sourcePlan: 'fix-batch',
+          preSnapshot: snapshotFiles,
+          createdFiles: [],
+          patchedFiles: Object.keys(snapshotFiles),
+          rollbackInstructions: ['Use nerviq rollback to undo these fixes'],
+        });
+        rollbackId = rollbackArtifact.id;
+      }
+
+      // Step 3b: Apply fixes sequentially with progress
+      let fixed = 0;
+      let manual = 0;
+      let runningScore = preScore;
+
+      for (let i = 0; i < targetKeys.length; i++) {
+        const key = targetKeys[i];
+        const technique = TECHNIQUES[key];
+        const failedCheck = failedResults.find(r => r.key === key);
+        const progress = isBatch ? `${i + 1}/${targetKeys.length}: ` : '';
+
+        if (technique && technique.template) {
+          if (options.dryRun) {
+            console.log(`  [dry-run] Would fix: ${progress}${failedCheck.name} (${key})`);
+            fixResults.push({ key, name: failedCheck.name, status: 'dry-run', delta: 0 });
+            fixed++;
+          } else {
+            try {
+              if (isBatch) console.log(`  Fixing ${progress}${key}...`);
+              const setupResult = await setup({ ...options, only: [key], silent: true });
+              if (setupResult && setupResult.writtenFiles) {
+                allCreatedFiles.push(...setupResult.writtenFiles);
+              }
+              const midResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
+              const delta = midResult.score - runningScore;
+              fixResults.push({ key, name: failedCheck.name, status: 'fixed', delta });
+              runningScore = midResult.score;
+              if (!isBatch) console.log(`  ✅ Fixed: ${failedCheck.name}`);
+              fixed++;
+            } catch (err) {
+              fixResults.push({ key, name: failedCheck.name, status: 'failed', delta: 0 });
+              if (isBatch) {
+                console.log(`  ❌ Failed: ${key} — ${err.message}`);
+                console.log(`  Stopping batch. ${fixed} fixes applied so far.`);
+                console.log(`  Rollback: nerviq rollback --id ${rollbackId}`);
+                break;
+              } else {
+                console.log(`  ❌ Failed: ${failedCheck.name} — ${err.message}`);
+              }
+            }
+          }
+        } else if (INLINE_FIXERS[key]) {
+          if (options.dryRun) {
+            console.log(`  [dry-run] Would fix: ${progress}${failedCheck.name} (${key})`);
+            fixResults.push({ key, name: failedCheck.name, status: 'dry-run', delta: 0 });
+            fixed++;
+          } else {
+            try {
+              if (isBatch) console.log(`  Fixing ${progress}${key}...`);
+              const didFix = INLINE_FIXERS[key](options.dir);
+              if (didFix) {
+                const midResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
+                const delta = midResult.score - runningScore;
+                fixResults.push({ key, name: failedCheck.name, status: 'fixed', delta });
+                runningScore = midResult.score;
+                if (!isBatch) console.log(`  ✅ Fixed: ${failedCheck.name}`);
+                fixed++;
+              } else {
+                fixResults.push({ key, name: failedCheck.name, status: 'skipped', delta: 0 });
+                if (!isBatch) console.log(`  ⏭️  Already fixed: ${failedCheck.name}`);
+              }
+            } catch (err) {
+              fixResults.push({ key, name: failedCheck.name, status: 'failed', delta: 0 });
+              if (isBatch) {
+                console.log(`  ❌ Failed: ${key} — ${err.message}`);
+                console.log(`  Stopping batch. ${fixed} fixes applied so far.`);
+                console.log(`  Rollback: nerviq rollback --id ${rollbackId}`);
+                break;
+              }
+            }
+          }
+        } else {
+          if (!isBatch) {
+            const aiPrompt = FIX_PROMPTS[key];
+            if (aiPrompt) {
+              console.log(formatFixPrompt(key, aiPrompt));
+            } else {
+              console.log(`  📋 ${failedCheck.name} (manual fix needed)`);
+              console.log(`     ${failedCheck.fix}`);
+            }
+          }
+          fixResults.push({ key, name: failedCheck.name, status: 'skipped', delta: 0 });
+          manual++;
+        }
+      }
+
+      // Record accepted patterns for successfully fixed checks
+      if (!options.dryRun) {
+        for (const key of targetKeys) {
+          const fr = fixResults.find(r => r.key === key);
+          recordPattern(options.dir, key, fr && fr.status === 'fixed' ? 'accepted' : 'rejected');
+        }
+      }
+
+      // Update rollback artifact with actual created files
+      if (!options.dryRun && rollbackId && allCreatedFiles.length > 0) {
+        const { ensureArtifactDirs } = require('../src/activity');
+        const { rollbackDir } = ensureArtifactDirs(options.dir);
+        const rbFiles = fs.readdirSync(rollbackDir).filter(f => f.includes(rollbackId));
+        if (rbFiles.length > 0) {
+          const rbPath = pathMod.join(rollbackDir, rbFiles[0]);
+          try {
+            const rbData = JSON.parse(fs.readFileSync(rbPath, 'utf8'));
+            rbData.createdFiles = allCreatedFiles;
+            fs.writeFileSync(rbPath, JSON.stringify(rbData, null, 2), 'utf8');
+          } catch { /* best effort */ }
+        }
+      }
+
+      // Step 4: Show batch summary or simple score impact
+      if (isBatch && fixResults.length > 0) {
+        console.log('');
+        console.log('  Batch fix complete:');
+        for (let i = 0; i < fixResults.length; i++) {
+          const r = fixResults[i];
+          const icon = r.status === 'fixed' ? '✅' : r.status === 'failed' ? '❌' : '⚠ ';
+          const deltaStr = r.status === 'fixed' ? ` (+${r.delta})` : r.status === 'skipped' ? ' (skipped — no auto-fix)' : r.status === 'failed' ? ' (failed)' : ' (dry-run)';
+          console.log(`  ${icon} ${i + 1}. ${r.key.padEnd(20)}${deltaStr}`);
+        }
+        const totalDelta = runningScore - preScore;
+        console.log('');
+        console.log(`  Score: ${preScore} → ${runningScore} (${totalDelta >= 0 ? '+' : ''}${totalDelta})`);
+        if (rollbackId && !options.dryRun) {
+          console.log(`  Rollback available: nerviq rollback --id ${rollbackId}`);
+        }
+      } else if (fixed > 0 && !options.dryRun) {
+        const postResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
+        const delta = postResult.score - preScore;
+        console.log('');
+        console.log(`  Score: ${preScore} → ${postResult.score} (${delta >= 0 ? '+' : ''}${delta})`);
+        if (rollbackId) {
+          console.log(`  Rollback available: nerviq rollback --id ${rollbackId}`);
+        }
+      }
+
+      console.log(`\n  ${fixed} fixed, ${manual} need manual action.\n`);
+
+    } else if (normalizedCommand === 'init') {
+      const { runInit } = require('../src/init');
+      await runInit(options.dir, flags);
+      process.exit(0);
+    } else if (normalizedCommand === 'setup') {
+      await setup(options);
+      if (options.snapshot) {
+        const postSetupResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
+        const snapshot = writeSnapshotArtifact(options.dir, 'audit', postSetupResult, {
+          sourceCommand: 'setup',
+        });
+        if (!options.json) {
+          console.log(`  Snapshot saved: ${snapshot.relativePath}`);
+        }
+      }
+    } else {
+      if (options.workspace) {
+        const summary = await auditWorkspaces(options.dir, options.workspace, options.platform);
+        printWorkspaceSummary(summary, options);
+        if (options.threshold !== null && summary.averageScore < options.threshold) {
+          process.exit(1);
+        }
+        process.exit(0);
+      }
+      const result = await audit(options);
+      if (options.webhookUrl) {
+        try {
+          const { sendWebhook, formatSlackMessage } = require('../src/integrations');
+          // Auto-detect Slack vs generic by URL pattern
+          const isSlack = options.webhookUrl.includes('hooks.slack.com');
+          const isDiscord = options.webhookUrl.includes('discord.com/api/webhooks');
+          let payload;
+          if (isSlack) {
+            payload = formatSlackMessage(result);
+          } else if (isDiscord) {
+            const { formatDiscordMessage } = require('../src/integrations');
+            payload = formatDiscordMessage(result);
+          } else {
+            // Generic webhook: send full JSON audit result
+            payload = { platform: result.platform, score: result.score, passed: result.passed, failed: result.failed, results: result.results };
+          }
+          const webhookResp = await sendWebhook(options.webhookUrl, payload);
+          if (!options.json) {
+            if (webhookResp.ok) {
+              console.log(`  Webhook sent: ${options.webhookUrl} (${webhookResp.status})`);
+            } else {
+              console.error(`  Webhook failed: ${webhookResp.status} — ${webhookResp.body.slice(0, 200)}`);
+            }
+          }
+        } catch (webhookErr) {
+          if (!options.json) console.error(`  Webhook error: ${webhookErr.message}`);
+        }
+      }
+      if (options.feedback && !options.json && options.format === null) {
+        const feedbackTargets = options.lite
+          ? (result.liteSummary?.topNextActions || [])
+          : (result.topNextActions || []);
+        const feedbackResult = await collectFeedback(options.dir, {
+          findings: feedbackTargets,
+          platform: result.platform,
+          sourceCommand: normalizedCommand,
+          score: result.score,
+        });
+        if (feedbackResult.mode === 'skipped-noninteractive') {
+          console.log('  Feedback prompt skipped: interactive terminal required.');
+          console.log('');
+        } else if (feedbackResult.saved > 0) {
+          console.log(`  Feedback saved: ${feedbackResult.relativeDir}`);
+          console.log(`  Helpful: ${feedbackResult.helpful} | Not helpful: ${feedbackResult.unhelpful}`);
+          console.log('');
+        }
+      }
+      const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, 'audit', result, {
+        sourceCommand: normalizedCommand,
+      }) : null;
+      if (snapshot && !options.json) {
+        console.log(`  Snapshot saved: ${snapshot.relativePath}`);
+        console.log(`  Snapshot index: ${snapshot.indexPath}`);
+        console.log('');
+      }
+      if (options.threshold !== null && result.score < options.threshold) {
+        if (!options.json) {
+          console.error(`\n  Error: Threshold not met — score ${result.score}/100 is below required ${options.threshold}/100.`);
+          console.error('  Why: Your project audit score is lower than the minimum threshold set via --threshold.');
+          console.error('  Fix: Run `npx nerviq augment` to see improvement suggestions, then re-audit.');
+          console.error('  Docs: https://github.com/nerviq/nerviq#ci-integration\n');
+        }
+        process.exit(1);
+      }
+      if (options.require && options.require.length > 0) {
+        const failedRequired = options.require.filter(key => {
+          const check = result.results.find(r => r.key === key);
+          return !check || check.passed !== true;
+        });
+        if (failedRequired.length > 0) {
+          if (!options.json) {
+            console.error(`\n  Required checks failed: ${failedRequired.join(', ')}`);
+            console.error('  These must pass for CI to succeed.\n');
+          }
+          process.exit(1);
+        }
+      }
+    }
+  } catch (err) {
+    console.error(`\n  Error: ${err.message}`);
+    console.error('  Fix: Run `npx nerviq doctor` to diagnose common issues, or check https://github.com/nerviq/nerviq#troubleshooting');
+    process.exit(1);
+  }
+}
+
+main();