@nerviq/cli 1.8.9 → 1.10.0

package/README.md

@@ -4,7 +4,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@nerviq/cli)](https://www.npmjs.com/package/@nerviq/cli)
 [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
-[![Checks: 2431](https://img.shields.io/badge/checks-2431-brightgreen)](https://github.com/nerviq/nerviq)
+[![Checks: 2438](https://img.shields.io/badge/checks-2438-brightgreen)](https://github.com/nerviq/nerviq)
 
 ---
 
@@ -14,7 +14,7 @@ Nerviq audits, sets up, and governs AI coding agent configurations for **8 platf
 
 | Platform | Checks | Status |
 |----------|--------|--------|
-| Claude Code | 393 | Full |
+| Claude Code | 400 | Full |
 | Codex (OpenAI) | 272 | Full |
 | Gemini CLI (Google) | 300 | Full |
 | GitHub Copilot | 299 | Full |
@@ -64,18 +64,26 @@ Nerviq scores your AI coding agent setup from 0 to 100, finds what's missing, an
   Next: nerviq setup
 ```
 
-## Quick Start
-
-```bash
-npx @nerviq/cli audit              # Quick scan: score + top 3 actions
-npx @nerviq/cli audit --full       # Full audit with all checks + badge
-npx @nerviq/cli setup              # Generate starter-safe baseline
-npx @nerviq/cli augment            # Improvement plan, no writes
-npx @nerviq/cli governance         # Permission profiles + policy packs
-npx @nerviq/cli benchmark          # Before/after in isolated copy
-```
-
-No install required. Zero dependencies.
+## Quick Start
+
+```bash
+npx @nerviq/cli --beginner         # Show only the 5 starter commands
+npx @nerviq/cli audit              # Quick scan: score + top 3 actions
+npx @nerviq/cli audit --full       # Full audit with all checks + badge
+npx @nerviq/cli audit --workspace packages/*  # Monorepo: root governance + workspace average/package scores
+npx @nerviq/cli setup              # Generate starter-safe baseline
+npx @nerviq/cli augment            # Improvement plan, no writes
+npx @nerviq/cli governance         # Permission profiles + policy packs
+npx @nerviq/cli benchmark          # Baseline vs projected score in isolated copy
+```
+
+No install required. Zero dependencies.
+
+If you want the shortest possible command list inside the terminal, start with:
+
+```bash
+npx @nerviq/cli --beginner
+```
 
 ## Get Started by Role
 
@@ -85,7 +93,7 @@ No install required. Zero dependencies.
 | **Team lead / DevEx** | `nerviq governance` → `nerviq audit --json` | CI threshold + `nerviq watch` |
 | **Enterprise / Platform** | `nerviq harmony-audit` → `nerviq harmony-drift` | Policy packs + `nerviq certify` |
 
-## 2,431 Checks Across 96 Categories (8 Platforms × ~300 Governance Rules)
+## 2,438 Checks Across 96 Categories (8 Platforms × ~300 Governance Rules)
 
 | Category Group | Checks | Examples |
 |----------------|--------|---------|
@@ -236,14 +244,14 @@ Levels:
 | `nerviq plan` | Export proposal bundles with previews |
 | `nerviq apply` | Apply proposals with rollback |
 | `nerviq governance` | Permission profiles, hooks, policy packs |
-| `nerviq benchmark` | Before/after in isolated temp copy |
+| `nerviq benchmark` | Baseline vs projected score in isolated temp copy |
 | `nerviq check-health` | Detect regressions between audit snapshots |
 | `nerviq deep-review` | AI-powered config review (opt-in) |
 | `nerviq interactive` | Step-by-step guided wizard |
 | `nerviq watch` | Live monitoring with score delta |
-| `nerviq history` | Score history from snapshots |
-| `nerviq compare` | Compare latest vs previous |
-| `nerviq trend` | Export trend report |
+| `nerviq history` | Audit snapshot history from saved snapshots |
+| `nerviq compare` | Compare latest vs previous audit snapshot |
+| `nerviq trend` | Export audit snapshot trend report |
 | `nerviq feedback` | Record recommendation outcomes |
 | `nerviq anti-patterns` | Detect anti-patterns in current project |
 | `nerviq freshness` | Show verification freshness for all checks |
@@ -281,7 +289,7 @@ Levels:
 | `--only A,B` | Limit apply to selected proposal IDs |
 | `--format sarif` | SARIF output for code scanning |
 | `--platform NAME` | Target platform (claude, codex, gemini, copilot, cursor, windsurf, aider, opencode) |
-| `--workspace GLOB` | Audit workspaces separately (e.g. packages/*) |
+| `--workspace GLOB` | Audit workspaces separately as package-level live audits (e.g. packages/*) |
 | `--external PATH` | Benchmark an external repo |
 
 ## Backed by Research
@@ -290,7 +298,7 @@ Nerviq is built on the NERVIQ knowledge engine — the largest verified catalog
 
 - **448+ research documents** covering all 8 platforms
 - **332+ experiments** with tested, rated results
-- **2,431 checks** across 8 platforms (~300 unique governance rules × 8 platform adaptations), each with `sourceUrl` and `confidence` level (0.0-1.0)
+- **2,438 checks** across 8 platforms (~300 unique governance rules × 8 platform adaptations), each with `sourceUrl` and `confidence` level (0.0-1.0)
 - Every check is traceable to primary documentation or verified experiment
 - 90-day freshness cycle: stale findings are re-verified or pruned
 
@@ -333,9 +341,9 @@ If Nerviq helped you, consider giving it a ⭐ on [GitHub](https://github.com/ne
 
 **Not designed for:** Deeply customized setups with 20+ skills, agent teams, and bespoke MCP integrations. If you've already built advanced agent workflows, you may not need this.
 
-**Strongest at:** Agent configuration, workflow governance, repo policy hygiene, cross-platform alignment, and setup standardization.
-
-**Not a replacement for:** Deep architectural review of business logic, runtime performance profiling, or security penetration testing. Nerviq focuses on how your AI coding agents are configured and governed — not on what your application code does.
+**Strongest at:** AI agent governance, configuration intelligence, workflow policy hygiene, cross-platform alignment, and setup standardization.
+
+**Not a replacement for:** Deep architectural review of business logic, runtime performance profiling, full SAST coverage, secret scanning, or security penetration testing. Nerviq focuses on how your AI coding agents are configured and governed — not on what your application code does.
 
 **Confidence levels:** Every check includes a `confidence` score (0.0–1.0) and a `sourceUrl` linking to primary documentation. Checks marked `heuristic` are pattern-based and may produce false positives on non-standard project structures.
 

package/bin/cli.js

@@ -14,6 +14,7 @@ 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 { init: initI18n, t } = require('../src/i18n');
 const { version } = require('../package.json');
 
 const args = process.argv.slice(2);
@@ -60,9 +61,9 @@ function suggestCommand(input) {
   return bestDistance <= 3 ? best : null;
 }
 
-function parseArgs(rawArgs) {
-  const flags = [];
-  let command = 'audit';
+function parseArgs(rawArgs) {
+  const flags = [];
+  let command = 'audit';
   let threshold = null;
   let out = null;
   let planFile = null;
@@ -88,14 +89,16 @@ function parseArgs(rawArgs) {
   let migrateFrom = null;
   let migrateTo = null;
   let checkVersion = null;
-  let external = null;
-  let repos = [];
-  let teamProfile = null;
+  let external = null;
+  let repos = [];
+  let teamProfile = null;
+  let lang = null;
+  let commandExplicit = false;
 
   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') {
+    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' || arg === '--lang') {
       const value = rawArgs[i + 1];
       if (!value || value.startsWith('--')) {
         throw new Error(`${arg} requires a value`);
@@ -123,10 +126,16 @@ function parseArgs(rawArgs) {
       if (arg === '--webhook') webhookUrl = value.trim();
       if (arg === '--external') external = value.trim();
       if (arg === '--team-profile') teamProfile = value.trim();
+      if (arg === '--lang') lang = value.trim().toLowerCase();
       i++;
       continue;
     }
 
+    if (arg.startsWith('--lang=')) {
+      lang = arg.split('=').slice(1).join('=').trim().toLowerCase();
+      continue;
+    }
+
     if (arg.startsWith('--team-profile=')) {
       teamProfile = arg.split('=').slice(1).join('=').trim();
       continue;
@@ -248,37 +257,47 @@ function parseArgs(rawArgs) {
       continue;
     }
 
-    if (!commandSet) {
-      command = arg;
-      commandSet = true;
-    } else {
-      extraArgs.push(arg);
-    }
-  }
+    if (!commandSet) {
+      command = arg;
+      commandSet = true;
+      commandExplicit = 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);
+  return { flags, command, commandExplicit, 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, lang };
+}
+
+function printWorkspaceSummary(summary, options) {
+  if (options.json) {
+    console.log(JSON.stringify(summary, null, 2));
+    return;
+  }
+
+  const rootScore = summary.rootGovernance?.score === null ? 'ERR' : `${summary.rootGovernance?.score ?? 0}/100`;
+  const workspaceAverage = summary.workspaceAggregate?.score ?? summary.averageScore;
+
+  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}`);
+  if (summary.patterns?.length > 0) {
+    console.log(`  Selection: ${summary.patterns.join(', ')}`);
+  }
+  console.log(`  Root governance audit: \x1b[1m${rootScore}\x1b[0m`);
+  console.log(`  Workspace audit average: \x1b[1m${workspaceAverage}/100\x1b[0m`);
+  console.log('  Score semantics: root governance shows shared repo policy health; workspace average shows package-level coverage across the selected workspaces.');
+  console.log('  Aggregate vs package: per-workspace scores can legitimately trail the root repo score in a monorepo.');
+  console.log('');
+  console.log('\x1b[1m  Workspace                  Audit  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}`);
   }
@@ -358,17 +377,18 @@ function printOrgSummary(summary, options) {
   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
+const HELP = `
+  nerviq v${version}
+  The intelligent nervous system for AI coding agents.
+  Audit, align, and amplify every platform on every project.
+  New here? Run: nerviq --beginner
+
+  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 monorepo workspaces with root-vs-package score semantics
     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)
@@ -405,30 +425,30 @@ const HELP = `
   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              Baseline vs projected 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 harmony-audit          Drift detection across all active platforms (GA)
+    nerviq harmony-sync           Preview cross-platform sync (dry run, GA)
+    nerviq harmony-sync --fix     Apply cross-platform sync (write files, GA)
+    nerviq harmony-sync --json    JSON output for CI/automation
+    nerviq harmony-add <platform>  Add a new platform to the project
+    nerviq synergy-report         [EXPERIMENTAL] Static-rule multi-agent amplification report
     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              Generate static dashboard from latest audit snapshot (or live audit if none)
     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 history                Audit snapshot history from saved snapshots
+    nerviq compare                Latest vs previous audit snapshot diff
+    nerviq trend                  Audit snapshot trend over time
     nerviq trend --out report.md  Export trend report as markdown
     nerviq feedback               Record recommendation outcomes
 
@@ -461,26 +481,28 @@ const HELP = `
     --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)
+    --workspace GLOBS Audit workspaces separately and label root governance vs package scores
     --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)
+    --show-deprecated Show deprecated checks (excluded from scoring)
+    --json            Output as JSON
+    --auto            Apply all generated files without prompting
+    --beginner        Show only the 5 starter commands for first-time users
+    --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
+  EXAMPLES
+    npx nerviq --beginner
+    npx nerviq
+    npx nerviq --lite
     npx nerviq --platform cursor
     npx nerviq audit --workspace packages/*
     npx nerviq --platform codex augment
@@ -497,9 +519,34 @@ const HELP = `
     npx nerviq feedback --key permissionDeny --status accepted --effect positive
 
   EXIT CODES
-    0  Success
-    1  Error, unknown command, or score below --threshold
-`;
+    0  Success
+    1  Error, unknown command, or score below --threshold
+`;
+
+const BEGINNER_HELP = `
+  nerviq v${version}
+  Start here.
+
+  If this is your first time, learn just these 5 commands:
+
+  STARTER COMMANDS
+    nerviq audit      Score the repo and show the top gaps
+    nerviq setup      Generate a starter-safe baseline
+    nerviq fix        Fix what can be fixed or show manual fix guidance
+    nerviq augment    Show an improvement plan without writing
+    nerviq doctor     Check install health, freshness, and platform detection
+
+  SIMPLE PATH
+    1. nerviq audit
+    2. nerviq setup --auto
+    3. nerviq fix --all-critical --auto
+    4. nerviq augment
+    5. nerviq doctor
+
+  WHEN YOU ARE READY
+    nerviq --help     Show the full command set
+    Docs: https://nerviq.net/docs/getting-started
+`;
 
 async function main() {
   let parsed;
@@ -510,17 +557,27 @@ async function main() {
     process.exit(1);
   }
 
-  const { flags, command, normalizedCommand } = parsed;
+  const { flags, command, commandExplicit, normalizedCommand } = parsed;
 
-  if (flags.includes('--help') || command === 'help') {
-    console.log(HELP);
-    process.exit(0);
+  // Initialize i18n with --lang flag or NERVIQ_LANG env var
+  if (parsed.lang) {
+    initI18n(parsed.lang);
   }
 
-  if (flags.includes('--version') || command === 'version') {
-    console.log(version);
-    process.exit(0);
-  }
+  if (flags.includes('--version') || command === 'version') {
+    console.log(version);
+    process.exit(0);
+  }
+
+  if (flags.includes('--beginner') && (!commandExplicit || flags.includes('--help') || command === 'help')) {
+    console.log(BEGINNER_HELP);
+    process.exit(0);
+  }
+
+  if (flags.includes('--help') || command === 'help') {
+    console.log(HELP);
+    process.exit(0);
+  }
 
   const options = {
     verbose: flags.includes('--verbose'),
@@ -547,6 +604,7 @@ async function main() {
     port: parsed.port !== null ? Number(parsed.port) : null,
     workspace: parsed.workspace || null,
     webhookUrl: parsed.webhookUrl || null,
+    lang: parsed.lang || null,
     external: parsed.external || null,
     dir: process.cwd()
   };
@@ -732,9 +790,9 @@ async function main() {
         process.exit(1);
       }
       process.exit(0);
-    } else if (normalizedCommand === 'history') {
-      const { formatHistory, readSnapshotIndex } = require('../src/activity');
-      // Handle --prune N
+    } 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;
@@ -742,7 +800,7 @@ async function main() {
         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`);
+          console.log(`\n  Nothing to prune (${entries.length} audit snapshots, keeping ${keepCount}).\n`);
         } else {
           const toRemove = entries.slice(0, entries.length - keepCount);
           let removed = 0;
@@ -753,42 +811,53 @@ async function main() {
           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`);
+          console.log(`\n  Pruned ${removed} audit 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);
-      }
+      console.log(formatHistory(options.dir));
+      console.log('');
+      process.exit(0);
+    } else if (normalizedCommand === 'compare') {
+      const { compareLatest, formatSnapshotBootstrap } = require('../src/activity');
+      const result = compareLatest(options.dir);
+      if (!result) {
+        console.log('');
+        console.log(formatSnapshotBootstrap(options.dir, 'compare'));
+        console.log('');
+        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}`);
+        console.log(`  Previous snapshot: ${result.previous.score}/100 (${result.previous.date?.split('T')[0]})`);
+        console.log(`  Current snapshot:  ${result.current.score}/100 (${result.current.date?.split('T')[0]})`);
+        console.log(`  Snapshot 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);
-      }
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'trend') {
+      const { exportTrendReport, getHistory, formatSnapshotBootstrap } = require('../src/activity');
+      const auditHistory = getHistory(options.dir, 2);
+      if (auditHistory.length < 2) {
+        console.log('');
+        console.log(formatSnapshotBootstrap(options.dir, 'trend'));
+        console.log('');
+        process.exit(0);
+      }
+      const report = exportTrendReport(options.dir);
+      if (!report) {
+        console.log('');
+        console.log(formatSnapshotBootstrap(options.dir, 'trend'));
+        console.log('');
+        process.exit(0);
+      }
       if (options.out) {
         require('fs').writeFileSync(options.out, report, 'utf8');
         console.log(`\n  Trend report exported to ${options.out}\n`);