@nerviq/cli 1.13.0 → 1.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nerviq/cli",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "The intelligent nervous system for AI coding agents — 2,441 checks (8 platforms × ~300 governance rules), 10 languages, 62 domain packs. Audit, align, and amplify.",
   "main": "src/index.js",
   "bin": {

package/src/audit.js

@@ -2,7 +2,7 @@
  * Audit engine - evaluates project against NERVIQ technique database.
  */
 
-const { TECHNIQUES: CLAUDE_TECHNIQUES, STACKS, STACK_CATEGORY_DETECTORS } = require('./techniques');
+const { TECHNIQUES: CLAUDE_TECHNIQUES, STACKS, STACK_CATEGORY_DETECTORS } = require('./techniques');
 const { ProjectContext } = require('./context');
 const { CODEX_TECHNIQUES } = require('./codex/techniques');
 const { detectCodexDomainPacks } = require('./codex/domain-packs');
@@ -23,28 +23,28 @@ const { AiderProjectContext } = require('./aider/context');
 const { OPENCODE_TECHNIQUES } = require('./opencode/techniques');
 const { OpenCodeProjectContext } = require('./opencode/context');
 const { getBadgeMarkdown } = require('./badge');
-const { sendInsights, getLocalInsights } = require('./insights');
-const { getRecommendationOutcomeSummary } = require('./activity');
-const { getFeedbackSummary } = require('./feedback');
-const { formatSarif } = require('./formatters/sarif');
-const { formatOtelMetrics } = require('./formatters/otel');
-const { collectAuditTerminology, formatTerminologyLines } = require('./terminology');
-const { loadPlugins, mergePluginChecks } = require('./plugins');
-const { detectDeprecationWarnings } = require('./deprecation');
-const { buildWorkspaceHint, formatCount, guardSkippedInstructionFiles, inspectInstructionFiles } = require('./audit/instruction-files');
-const {
-  WEIGHTS,
-  buildScoreCoaching,
-  buildTopNextActions,
-  confidenceLabel,
-  computeCategoryScores,
-  getFpFeedbackMultiplier,
-  getQuickWins,
-  getRecommendationPriorityScore,
-  inferSuggestedNextCommand,
-} = require('./audit/recommendations');
-const { version: packageVersion } = require('../package.json');
-const { t } = require('./i18n');
+const { sendInsights, getLocalInsights } = require('./insights');
+const { getRecommendationOutcomeSummary } = require('./activity');
+const { getFeedbackSummary } = require('./feedback');
+const { formatSarif } = require('./formatters/sarif');
+const { formatOtelMetrics } = require('./formatters/otel');
+const { collectAuditTerminology, formatTerminologyLines } = require('./terminology');
+const { loadPlugins, mergePluginChecks } = require('./plugins');
+const { detectDeprecationWarnings } = require('./deprecation');
+const { buildWorkspaceHint, formatCount, guardSkippedInstructionFiles, inspectInstructionFiles } = require('./audit/instruction-files');
+const {
+  WEIGHTS,
+  buildScoreCoaching,
+  buildTopNextActions,
+  confidenceLabel,
+  computeCategoryScores,
+  getFpFeedbackMultiplier,
+  getQuickWins,
+  getRecommendationPriorityScore,
+  inferSuggestedNextCommand,
+} = require('./audit/recommendations');
+const { version: packageVersion } = require('../package.json');
+const { t } = require('./i18n');
 
 const COLORS = {
   reset: '\x1b[0m',
@@ -68,10 +68,10 @@ function progressBar(score, max = 100, width = 20) {
   return colorize('█'.repeat(filled), color) + colorize('░'.repeat(empty), 'dim');
 }
 
-function formatLocation(file, line) {
-  if (!file) return null;
-  return line ? `${file}:${line}` : file;
-}
+function formatLocation(file, line) {
+  if (!file) return null;
+  return line ? `${file}:${line}` : file;
+}
 
 function getAuditSpec(platform = 'claude') {
   if (platform === 'codex') {
@@ -153,7 +153,7 @@ function getAuditSpec(platform = 'claude') {
   };
 }
 
-function getPlatformScopeNote(spec, ctx) {
+function getPlatformScopeNote(spec, ctx) {
   if (spec.platform !== 'codex') {
     return null;
   }
@@ -242,7 +242,7 @@ function printLiteAudit(result, dir) {
     console.log(colorize(`  Found: ${result.detectedConfigFiles.join(', ')}`, 'dim'));
   }
   console.log('');
-  console.log(`  ${t('audit.score', { score: colorize(`${result.score}/100`, 'bold'), passed: result.passed, total: result.passed + result.failed })}`);
+  console.log(`  ${t('audit.score', { score: colorize(`${result.score}/100`, 'bold'), passed: result.passed, total: result.passed + result.failed })}`);
 
   // Score explanation line (lite mode only)
   const _critCount = (result.results || []).filter(r => r.passed === false && r.impact === 'critical').length;
@@ -265,14 +265,14 @@ function printLiteAudit(result, dir) {
     scoreExplanation = t('audit.basic', { category: weakestCategory });
   } else {
     scoreExplanation = t('audit.early');
-  }
-  console.log(colorize(`  ${scoreExplanation}`, 'dim'));
-  if (result.scoreCoaching) {
-    console.log(colorize(`  Milestone: ${result.scoreCoaching.summary}`, 'magenta'));
-  }
-  console.log(colorize('  Score type: live repo audit (current files only, not snapshot history or benchmark projection).', 'dim'));
-
-  if (result.platformScopeNote) {
+  }
+  console.log(colorize(`  ${scoreExplanation}`, 'dim'));
+  if (result.scoreCoaching) {
+    console.log(colorize(`  Milestone: ${result.scoreCoaching.summary}`, 'magenta'));
+  }
+  console.log(colorize('  Score type: live repo audit (current files only, not snapshot history or benchmark projection).', 'dim'));
+
+  if (result.platformScopeNote) {
     console.log(colorize(`  Scope: ${result.platformScopeNote.message}`, 'dim'));
   }
   if (result.workspaceHint && result.workspaceHint.workspaces.length > 0) {
@@ -284,11 +284,11 @@ function printLiteAudit(result, dir) {
       console.log(colorize(`     - ${item.title}: ${item.message}`, 'dim'));
     });
   }
-  if (result.largeInstructionFiles && result.largeInstructionFiles.length > 0) {
-    result.largeInstructionFiles.slice(0, 2).forEach((item) => {
-      console.log(colorize(`  Large file: ${item.file} (~${formatCount(item.tokenCount)} tokens)`, 'yellow'));
-    });
-  }
+  if (result.largeInstructionFiles && result.largeInstructionFiles.length > 0) {
+    result.largeInstructionFiles.slice(0, 2).forEach((item) => {
+      console.log(colorize(`  Large file: ${item.file} (~${formatCount(item.tokenCount)} tokens)`, 'yellow'));
+    });
+  }
   console.log('');
 
   if (result.failed === 0) {
@@ -320,23 +320,23 @@ function printLiteAudit(result, dir) {
   console.log('');
   let usagePatterns;
   try { usagePatterns = require('./usage-patterns'); } catch { usagePatterns = null; }
-  result.liteSummary.topNextActions.forEach((item, index) => {
-    const tier = item.impact === 'critical' ? '🔴' : item.impact === 'high' ? '🟡' : '🔵';
-    const suppressed = usagePatterns && usagePatterns.getPriorityAdjustment(dir, item.key) === 'suppress';
-    const suffix = suppressed ? colorize(' (suppressed)', 'dim') : '';
-    console.log(`  ${index + 1}. ${tier} ${colorize(item.name, 'bold')}${suffix}`);
-    console.log(colorize(`     ${item.fix}`, 'dim'));
-  });
-  console.log('');
-  const liteTerminology = formatTerminologyLines(collectAuditTerminology(result));
-  if (liteTerminology.length > 0) {
-    liteTerminology.forEach((line) => {
-      const color = line.startsWith('  Terms used here:') ? 'blue' : 'dim';
-      console.log(colorize(line, color));
-    });
-    console.log('');
-  }
-  console.log(`  Ready? Run: ${colorize(result.suggestedNextCommand, 'bold')}`);
+  result.liteSummary.topNextActions.forEach((item, index) => {
+    const tier = item.impact === 'critical' ? '🔴' : item.impact === 'high' ? '🟡' : '🔵';
+    const suppressed = usagePatterns && usagePatterns.getPriorityAdjustment(dir, item.key) === 'suppress';
+    const suffix = suppressed ? colorize(' (suppressed)', 'dim') : '';
+    console.log(`  ${index + 1}. ${tier} ${colorize(item.name, 'bold')}${suffix}`);
+    console.log(colorize(`     ${item.fix}`, 'dim'));
+  });
+  console.log('');
+  const liteTerminology = formatTerminologyLines(collectAuditTerminology(result));
+  if (liteTerminology.length > 0) {
+    liteTerminology.forEach((line) => {
+      const color = line.startsWith('  Terms used here:') ? 'blue' : 'dim';
+      console.log(colorize(line, color));
+    });
+    console.log('');
+  }
+  console.log(`  Ready? Run: ${colorize(result.suggestedNextCommand, 'bold')}`);
   if (result.platform === 'codex') {
     console.log(colorize('  Note: Codex now supports no-write advisory flows via augment and suggest-only before setup/apply.', 'dim'));
   }
@@ -387,7 +387,7 @@ async function audit(options) {
     'supply-chain', 'api-versioning', 'caching', 'rate-limiting', 'feature-flags',
     'docs-quality', 'monorepo', 'performance-budget', 'realtime', 'graphql',
     'testing-strategy', 'code-quality', 'api-design', 'database', 'authentication',
-    'monitoring', 'dependency-management', 'cost-optimization',
+    'monitoring', 'dependency-management', 'cost-optimization', 'devops',
   ]);
   const includeGenericQuality = options.verbose;
 
@@ -425,12 +425,12 @@ async function audit(options) {
       key: 'largeInstructionFile',
       id: null,
       name: 'Large instruction file warning',
-      category: 'performance',
-      impact: 'medium',
-      rating: null,
-      fix: 'Split oversized instruction files so they stay under ~12,000 tokens, and keep any single instruction file below ~240,000 tokens.',
-      sourceUrl: null,
-      confidence: 'high',
+      category: 'performance',
+      impact: 'medium',
+      rating: null,
+      fix: 'Split oversized instruction files so they stay under ~12,000 tokens, and keep any single instruction file below ~240,000 tokens.',
+      sourceUrl: null,
+      confidence: 'high',
       file: largeInstructionFiles[0].file,
       line: null,
       passed: null,
@@ -498,13 +498,13 @@ async function audit(options) {
     ...largeInstructionFiles.map((item) => ({
       kind: 'large-instruction-file',
       severity: item.severity,
-      message: item.message,
-      file: item.file,
-      lineCount: item.lineCount,
-      byteCount: item.byteCount,
-      tokenCount: item.tokenCount,
-      skipped: item.skipped,
-    })),
+      message: item.message,
+      file: item.file,
+      lineCount: item.lineCount,
+      byteCount: item.byteCount,
+      tokenCount: item.tokenCount,
+      skipped: item.skipped,
+    })),
     ...deprecationWarnings.map((item) => ({
       kind: 'deprecated-feature',
       severity: 'warning',
@@ -514,7 +514,7 @@ async function audit(options) {
   const recommendedDomainPacks = spec.platform === 'codex'
     ? detectCodexDomainPacks(ctx, stacks, getCodexDomainPackSignals(ctx))
     : [];
-  const result = {
+  const result = {
     platform: spec.platform,
     platformLabel: spec.platformLabel,
     platformVersion: spec.platformVersion,
@@ -537,18 +537,18 @@ async function audit(options) {
       deprecatedReason: r.deprecatedReason || null,
       sunsetDate: r.sunsetDate || null,
     })),
-    categoryScores,
-    scoreCoaching: buildScoreCoaching({
-      score,
-      earnedPoints: earnedScore,
-      maxPoints: maxScore,
-      failed,
-      outcomeSummaryByKey: outcomeSummary.byKey,
-      platform: spec.platform,
-      fpFeedbackByKey: fpFeedback.byKey,
-    }),
-    quickWins: quickWins.map(({ key, name, impact, fix, category, sourceUrl }) => ({ key, name, impact, category, fix, sourceUrl })),
-    topNextActions,
+    categoryScores,
+    scoreCoaching: buildScoreCoaching({
+      score,
+      earnedPoints: earnedScore,
+      maxPoints: maxScore,
+      failed,
+      outcomeSummaryByKey: outcomeSummary.byKey,
+      platform: spec.platform,
+      fpFeedbackByKey: fpFeedback.byKey,
+    }),
+    quickWins: quickWins.map(({ key, name, impact, fix, category, sourceUrl }) => ({ key, name, impact, category, fix, sourceUrl })),
+    topNextActions,
     recommendationOutcomes: {
       totalEntries: outcomeSummary.totalEntries,
       keysTracked: outcomeSummary.keys,
@@ -578,12 +578,12 @@ async function audit(options) {
   result.detectedConfigFiles = configFiles;
 
   result.suggestedNextCommand = inferSuggestedNextCommand(result);
-  result.liteSummary = {
-    topNextActions: topNextActions.slice(0, 3),
-    nextCommand: result.suggestedNextCommand,
-    platformCaveats: platformCaveats.slice(0, 2),
-    scoreCoaching: result.scoreCoaching,
-  };
+  result.liteSummary = {
+    topNextActions: topNextActions.slice(0, 3),
+    nextCommand: result.suggestedNextCommand,
+    platformCaveats: platformCaveats.slice(0, 2),
+    scoreCoaching: result.scoreCoaching,
+  };
 
   // Silent mode: skip all output, just return result
   if (silent) {
@@ -642,13 +642,13 @@ async function audit(options) {
     console.log('');
   }
 
-  if (largeInstructionFiles.length > 0) {
-    console.log(colorize('  Large instruction files', 'yellow'));
-    for (const item of largeInstructionFiles) {
-      const sizeKb = Number.isFinite(item.byteCount) ? Math.round(item.byteCount / 1024) : '?';
-      console.log(colorize(`     ${item.file} (~${formatCount(item.tokenCount)} tokens, ${item.lineCount || '?'} lines, ${sizeKb}KB)`, 'bold'));
-      console.log(colorize(`     → ${item.message}`, 'dim'));
-    }
+  if (largeInstructionFiles.length > 0) {
+    console.log(colorize('  Large instruction files', 'yellow'));
+    for (const item of largeInstructionFiles) {
+      const sizeKb = Number.isFinite(item.byteCount) ? Math.round(item.byteCount / 1024) : '?';
+      console.log(colorize(`     ${item.file} (~${formatCount(item.tokenCount)} tokens, ${item.lineCount || '?'} lines, ${sizeKb}KB)`, 'bold'));
+      console.log(colorize(`     → ${item.message}`, 'dim'));
+    }
     console.log('');
   }
 
@@ -678,18 +678,18 @@ async function audit(options) {
   console.log('');
 
   // Score
-  console.log(`  ${progressBar(score)} ${colorize(`${score}/100`, 'bold')}`);
-  if (isScaffolded && scaffoldedPassed.length > 0) {
-    console.log(colorize(`  Organic: ${organicScore}/100 (without nerviq generated files)`, 'dim'));
-  }
-  if (result.scoreCoaching) {
-    const fastestPath = result.scoreCoaching.recommendedNames.slice(0, 3).join(', ');
-    console.log(colorize(`  Milestone: ${result.scoreCoaching.summary}`, 'magenta'));
-    if (fastestPath) {
-      console.log(colorize(`  Fastest path: ${fastestPath}`, 'dim'));
-    }
-  }
-  console.log('');
+  console.log(`  ${progressBar(score)} ${colorize(`${score}/100`, 'bold')}`);
+  if (isScaffolded && scaffoldedPassed.length > 0) {
+    console.log(colorize(`  Organic: ${organicScore}/100 (without nerviq generated files)`, 'dim'));
+  }
+  if (result.scoreCoaching) {
+    const fastestPath = result.scoreCoaching.recommendedNames.slice(0, 3).join(', ');
+    console.log(colorize(`  Milestone: ${result.scoreCoaching.summary}`, 'magenta'));
+    if (fastestPath) {
+      console.log(colorize(`  Fastest path: ${fastestPath}`, 'dim'));
+    }
+  }
+  console.log('');
 
   // Passed
   if (passed.length > 0) {
@@ -755,8 +755,8 @@ async function audit(options) {
   }
 
   // Top next actions
-  if (topNextActions.length > 0) {
-    console.log(colorize('  ⚡ Top 5 Next Actions', 'magenta'));
+  if (topNextActions.length > 0) {
+    console.log(colorize('  ⚡ Top 5 Next Actions', 'magenta'));
     for (let i = 0; i < topNextActions.length; i++) {
       const item = topNextActions[i];
       console.log(`     ${i + 1}. ${colorize(item.name, 'bold')}`);
@@ -772,20 +772,20 @@ async function audit(options) {
         console.log(colorize(`        Feedback: accepted ${item.feedback.accepted}, rejected ${item.feedback.rejected}, positive ${item.feedback.positive}, negative ${item.feedback.negative}${avgDelta}`, 'dim'));
       }
       console.log(colorize(`        Fix: ${item.fix}`, 'dim'));
-    }
-    console.log('');
-  }
-
-  const terminology = formatTerminologyLines(collectAuditTerminology(result));
-  if (terminology.length > 0) {
-    terminology.forEach((line) => {
-      const color = line.startsWith('  Terms used here:') ? 'blue' : 'dim';
-      console.log(colorize(line, color));
-    });
-    console.log('');
-  }
-
-  // Summary
+    }
+    console.log('');
+  }
+
+  const terminology = formatTerminologyLines(collectAuditTerminology(result));
+  if (terminology.length > 0) {
+    terminology.forEach((line) => {
+      const color = line.startsWith('  Terms used here:') ? 'blue' : 'dim';
+      console.log(colorize(line, color));
+    });
+    console.log('');
+  }
+
+  // Summary
   console.log(colorize('  ─────────────────────────────────────', 'dim'));
   const deprecatedNote = deprecated.length > 0 ? colorize(`, ${deprecated.length} deprecated`, 'dim') : '';
   console.log(`  ${colorize(`${passed.length}/${applicable.length}`, 'bold')} checks passing${skipped.length > 0 ? colorize(` (${skipped.length} not applicable${deprecatedNote})`, 'dim') : (deprecatedNote ? colorize(` (${deprecatedNote})`, 'dim') : '')}`);

package/src/harmony/cli.js

@@ -346,6 +346,237 @@ async function runHarmonyGovernance(options) {
   return summary;
 }
 
+// ─── Command: harmony score ──────────────────────────────────────────────────
+
+/**
+ * Output a standalone Harmony Score (0-100) with optional badge and CI threshold.
+ *
+ * Options:
+ *   --json          JSON output
+ *   --badge         Print shields.io badge markdown
+ *   --threshold N   Exit with code 1 if score < N (for CI gates)
+ *   --quiet         Score number only (for piping)
+ */
+async function runHarmonyScore(options) {
+  const dir = resolveDir(options);
+  const { harmonyAudit } = require('./audit');
+  const result = await harmonyAudit({ dir, silent: true });
+
+  const score = result.harmonyScore;
+  const threshold = parseInt(options.threshold, 10) || 0;
+  const pass = score >= threshold;
+
+  if (options.json) {
+    const output = {
+      harmonyScore: score,
+      platforms: result.platformScores,
+      activePlatforms: result.activePlatforms.map(p => p.platform),
+      driftCount: result.drift.drifts.length,
+      threshold: threshold || null,
+      pass,
+    };
+    if (options.badge) {
+      output.badge = getHarmonyBadgeMarkdown(score);
+      output.badgeUrl = getHarmonyBadgeUrl(score);
+    }
+    console.log(JSON.stringify(output, null, 2));
+    return output;
+  }
+
+  if (options.quiet) {
+    console.log(score);
+    return { score, pass };
+  }
+
+  console.log('');
+  console.log(c('  Harmony Score', 'bold'));
+  console.log(c('  ═══════════════════════════════════════', 'dim'));
+  console.log('');
+
+  // Score with color bar
+  const barWidth = 30;
+  const filled = Math.round((score / 100) * barWidth);
+  const empty = barWidth - filled;
+  const scoreColor = score >= 80 ? 'green' : score >= 50 ? 'yellow' : 'red';
+  const bar = c('\u2588'.repeat(filled), scoreColor) + c('\u2591'.repeat(empty), 'dim');
+  console.log(`  ${bar} ${c(`${score}/100`, scoreColor)}`);
+  console.log('');
+
+  // Per-platform breakdown
+  for (const ap of result.activePlatforms) {
+    const ps = result.platformScores[ap.platform];
+    const psColor = ps >= 70 ? 'green' : ps >= 40 ? 'yellow' : 'red';
+    console.log(`  ${ap.platform.padEnd(12)} ${ps !== null ? c(`${ps}/100`, psColor) : c('n/a', 'dim')}`);
+  }
+  console.log('');
+
+  // Drift summary
+  const driftCount = result.drift.drifts.length;
+  if (driftCount > 0) {
+    const critical = result.drift.drifts.filter(d => d.severity === 'critical').length;
+    const high = result.drift.drifts.filter(d => d.severity === 'high').length;
+    let driftMsg = `  ${driftCount} drift issue${driftCount !== 1 ? 's' : ''}`;
+    if (critical > 0) driftMsg += c(` (${critical} critical)`, 'red');
+    else if (high > 0) driftMsg += c(` (${high} high)`, 'yellow');
+    console.log(driftMsg);
+    console.log(c('  Run "nerviq harmony-audit" for details.', 'dim'));
+    console.log('');
+  }
+
+  // Badge output
+  if (options.badge) {
+    console.log(c('  Badge:', 'bold'));
+    console.log(`  ${getHarmonyBadgeMarkdown(score)}`);
+    console.log('');
+  }
+
+  // Threshold check
+  if (threshold > 0) {
+    if (pass) {
+      console.log(c(`  Threshold: ${score} >= ${threshold} PASS`, 'green'));
+    } else {
+      console.log(c(`  Threshold: ${score} < ${threshold} FAIL`, 'red'));
+    }
+    console.log('');
+  }
+
+  return { score, pass, platforms: result.platformScores };
+}
+
+// ─── Harmony Badge helpers ───────────────────────────────────────────────────
+
+function getHarmonyBadgeUrl(score) {
+  const color = score >= 80 ? 'brightgreen' : score >= 60 ? 'yellow' : score >= 40 ? 'orange' : 'red';
+  const label = encodeURIComponent('Harmony Score');
+  const message = encodeURIComponent(`${score}/100`);
+  return `https://img.shields.io/badge/${label}-${message}-${color}`;
+}
+
+function getHarmonyBadgeMarkdown(score) {
+  const url = getHarmonyBadgeUrl(score);
+  return `[![Harmony Score](${url})](https://github.com/nerviq/nerviq)`;
+}
+
+// ─── Command: harmony demo ──────────────────────────────────────────────────
+
+/**
+ * Zero-setup demo: creates a temporary multi-platform project, runs harmony
+ * audit on it, and shows how Nerviq detects cross-platform drift.
+ *
+ * This lets new users see Harmony's value instantly without configuring anything.
+ */
+async function runHarmonyDemo(options) {
+  const fs = require('fs');
+  const os = require('os');
+  const { harmonyAudit } = require('./audit');
+
+  console.log('');
+  console.log(c('  Harmony Demo — Zero-Setup Cross-Platform Drift Detection', 'bold'));
+  console.log(c('  ═══════════════════════════════════════════════════════', 'dim'));
+  console.log('');
+  console.log(c('  Creating a sample multi-platform project...', 'dim'));
+  console.log('');
+
+  // Create temp directory with realistic multi-platform configs
+  const demoDir = path.join(os.tmpdir(), `nerviq-harmony-demo-${Date.now()}`);
+  fs.mkdirSync(demoDir, { recursive: true });
+  fs.mkdirSync(path.join(demoDir, '.claude'), { recursive: true });
+  fs.mkdirSync(path.join(demoDir, '.cursor'), { recursive: true });
+  fs.mkdirSync(path.join(demoDir, '.github'), { recursive: true });
+
+  // Claude config — well-configured
+  fs.writeFileSync(path.join(demoDir, 'CLAUDE.md'), [
+    '# Project Instructions',
+    '',
+    '## Architecture',
+    'This is a Node.js API with PostgreSQL. Use Express for routing.',
+    '',
+    '## Testing',
+    'Run tests with `npm test`. All PRs require passing tests.',
+    '',
+    '## Security',
+    '- Never commit .env files',
+    '- Use parameterized queries for all database access',
+    '- Validate all user input',
+    '',
+    '## Code Style',
+    '- Use ESLint with the project config',
+    '- Prefer async/await over callbacks',
+    '- Add JSDoc comments for public functions',
+  ].join('\n'));
+
+  fs.writeFileSync(path.join(demoDir, '.claude', 'settings.json'), JSON.stringify({
+    permissions: {
+      allow: ['Read', 'Glob', 'Grep'],
+      deny: ['Bash(rm -rf *)'],
+    },
+    model: 'claude-sonnet-4-6',
+  }, null, 2));
+
+  // Cursor config — intentionally drifted (different rules, less security)
+  fs.writeFileSync(path.join(demoDir, '.cursorrules'), [
+    'You are a helpful coding assistant.',
+    'This is a Node.js project using Express.',
+    'Write clean, readable code.',
+    // Missing: security rules, testing rules, architecture details
+  ].join('\n'));
+
+  // Copilot config — partial coverage
+  fs.writeFileSync(path.join(demoDir, '.github', 'copilot-instructions.md'), [
+    '# Copilot Instructions',
+    '',
+    'This is a Node.js Express API project.',
+    'Use TypeScript-style JSDoc annotations.',
+    'Follow RESTful conventions for API endpoints.',
+    // Missing: security, testing, architecture details
+  ].join('\n'));
+
+  // Add a package.json for realism
+  fs.writeFileSync(path.join(demoDir, 'package.json'), JSON.stringify({
+    name: 'harmony-demo-project',
+    version: '1.0.0',
+    scripts: { test: 'jest' },
+  }, null, 2));
+
+  console.log(c('  Demo project created with 3 platforms:', 'bold'));
+  console.log(`    ${c('Claude', 'green')}   — Well-configured (CLAUDE.md + settings.json)`);
+  console.log(`    ${c('Cursor', 'yellow')}   — Basic rules only (.cursorrules)`);
+  console.log(`    ${c('Copilot', 'yellow')}  — Partial coverage (copilot-instructions.md)`);
+  console.log('');
+  console.log(c('  Intentional drift injected:', 'bold'));
+  console.log(`    ${c('\u2718', 'red')} Security rules only in Claude, missing from Cursor & Copilot`);
+  console.log(`    ${c('\u2718', 'red')} Testing instructions only in Claude`);
+  console.log(`    ${c('\u2718', 'red')} Architecture details inconsistent across platforms`);
+  console.log(`    ${c('\u2718', 'red')} Trust posture differs (Claude has explicit permissions)`);
+  console.log('');
+  console.log(c('  Running Harmony Audit...', 'dim'));
+  console.log('');
+
+  // Run the actual harmony audit on the demo project
+  const result = await harmonyAudit({ dir: demoDir, silent: false, verbose: !!options.verbose });
+
+  console.log('');
+  console.log(c('  ═══════════════════════════════════════════════════════', 'dim'));
+  console.log(c('  What you just saw:', 'bold'));
+  console.log('');
+  console.log('  Nerviq Harmony detected real configuration drift between');
+  console.log('  3 AI coding platforms in your project — differences in');
+  console.log('  instructions, security posture, and tool coverage that');
+  console.log('  cause inconsistent AI behavior.');
+  console.log('');
+  console.log(c('  Try it on your own project:', 'bold'));
+  console.log(`    ${c('npx @nerviq/cli harmony-audit', 'blue')}`);
+  console.log(`    ${c('npx @nerviq/cli harmony-score --threshold 70', 'blue')}`);
+  console.log('');
+
+  // Clean up
+  try {
+    fs.rmSync(demoDir, { recursive: true, force: true });
+  } catch (_e) { /* cleanup optional */ }
+
+  return result;
+}
+
 module.exports = {
   runHarmonyAudit,
   runHarmonySync,
@@ -353,4 +584,8 @@ module.exports = {
   runHarmonyAdvise,
   runHarmonyWatch,
   runHarmonyGovernance,
+  runHarmonyScore,
+  runHarmonyDemo,
+  getHarmonyBadgeUrl,
+  getHarmonyBadgeMarkdown,
 };

package/src/index.js

@@ -240,6 +240,7 @@ module.exports = {
     const { startHarmonyWatch } = require('./harmony/watch');
     const { saveHarmonyState, loadHarmonyState, getHarmonyHistory } = require('./harmony/memory');
     const { getHarmonyGovernanceSummary, formatHarmonyGovernanceReport } = require('./harmony/governance');
+    const { getHarmonyBadgeUrl, getHarmonyBadgeMarkdown } = require('./harmony/cli');
     return {
       buildCanonicalModel, detectActivePlatforms, detectDrift, formatDriftReport,
       harmonyAudit, formatHarmonyAuditReport,
@@ -247,6 +248,7 @@ module.exports = {
       generateStrategicAdvice, PLATFORM_STRENGTHS,
       startHarmonyWatch, saveHarmonyState, loadHarmonyState, getHarmonyHistory,
       getHarmonyGovernanceSummary, formatHarmonyGovernanceReport,
+      getHarmonyBadgeUrl, getHarmonyBadgeMarkdown,
     };
   })(),
   // Synergy (cross-platform amplification)