@nerviq/cli 0.9.5 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.0.0 — 2026-04-05
+### 🎉 First Stable Release
+- 8 platforms: Claude Code, Codex, Gemini CLI, GitHub Copilot, Cursor, Windsurf, Aider, OpenCode
+- 673 checks with sourceUrl and confidence on every check
+- Harmony: cross-platform drift detection and alignment
+- Synergy: multi-agent amplification and task routing
+- Plugin system: custom checks via nerviq.config.js
+- SDK: @nerviq/sdk with TypeScript types
+- REST API: nerviq serve --port 3000
+- MCP Server: nerviq as MCP tool provider
+- VS Code Extension
+- GitHub Action with SARIF support
+- Performance: 226ms total audit across 8 platforms
+- CLI commands: audit, setup, plan, apply, governance, benchmark, harmony-audit, synergy-report, deep-review, interactive, watch, history, compare, trend, feedback, catalog, certify, doctor, convert, migrate, serve
+- 213 tests across 21 test suites
+- AGPL-3.0 license
+
 ## [1.16.2] - 2026-04-03
 
 ### Changed

package/README.md

@@ -4,23 +4,24 @@
 
 [![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: 673](https://img.shields.io/badge/checks-673-brightgreen)](https://github.com/nerviq/nerviq)
 
 ---
 
-### ⚠️ Beta — Currently Claude Code only
+### 8 Platforms Supported
 
-Nerviq is in **beta**. The current release fully supports **Claude Code** (90 checks, audit, setup, governance, benchmark).
+Nerviq v1.0 ships with full audit, setup, governance, and benchmark support for **8 AI coding platforms**:
 
-**Coming soon:**
-- Codex (OpenAI)
-- Gemini CLI (Google)
-- GitHub Copilot
-- Cursor
-- Windsurf
-- Aider
-- OpenCode
-- **Harmony** — cross-platform drift detection
-- **Synergy** — multi-agent amplification
+| Platform | Checks | Status |
+|----------|--------|--------|
+| Claude Code | 90 | Full |
+| Codex (OpenAI) | 83 | Full |
+| Gemini CLI (Google) | 83 | Full |
+| GitHub Copilot | 83 | Full |
+| Cursor | 83 | Full |
+| Windsurf | 83 | Full |
+| Aider | 85 | Full |
+| OpenCode | 83 | Full |
 
 ---
 
@@ -61,7 +62,7 @@ npx @nerviq/cli benchmark          # Before/after in isolated copy
 
 No install required. Zero dependencies.
 
-## 90 Checks Across 14 Categories
+## 673 Checks Across 14 Categories
 
 | Category | Checks | Examples |
 |----------|--------|---------|
@@ -79,11 +80,126 @@ No install required. Zero dependencies.
 | Features | 2 | channels, worktrees |
 | Quality Deep | 9 | freshness, contradictions, deprecated patterns |
 
+## Harmony — Cross-Platform Alignment
+
+Harmony detects drift between your AI coding platforms and keeps them in sync.
+
+```bash
+npx @nerviq/cli harmony-audit      # Cross-platform DX audit (0-100 harmony score)
+npx @nerviq/cli harmony-sync       # Sync shared config across platforms
+npx @nerviq/cli harmony-drift      # Detect drift between platform configs
+npx @nerviq/cli harmony-advise     # Cross-platform improvement advice
+npx @nerviq/cli harmony-watch      # Live monitoring for config drift
+npx @nerviq/cli harmony-governance # Unified governance across platforms
+```
+
+## Synergy — Multi-Agent Amplification
+
+Synergy analyzes how your platforms work together and finds amplification opportunities.
+
+```bash
+npx @nerviq/cli synergy-report     # Multi-agent synergy analysis
+```
+
+Synergy evaluates compound audit results, discovers compensation patterns (where one platform covers another's gaps), and ranks recommendations by cross-platform impact.
+
+## SDK — `@nerviq/sdk`
+
+Programmatic access to all Nerviq capabilities:
+
+```js
+const { audit, harmonyAudit, synergyReport, detectPlatforms } = require('@nerviq/sdk');
+
+const result = await audit('.', 'claude');
+console.log(`Score: ${result.score}/100`);
+
+const platforms = detectPlatforms('.');
+console.log(`Active platforms: ${platforms.join(', ')}`);
+
+const harmony = await harmonyAudit('.');
+console.log(`Harmony score: ${harmony.harmonyScore}/100`);
+```
+
+## MCP Server — `nerviq serve`
+
+Nerviq ships with a built-in MCP-compatible HTTP server for integration with AI agents:
+
+```bash
+npx @nerviq/cli serve --port 3000
+```
+
+Endpoints:
+- `GET /api/health` — Server health check
+- `GET /api/catalog` — Full check catalog
+- `POST /api/audit` — Run audit on a directory
+- `GET /api/harmony` — Cross-platform harmony data
+
+## Plugin System — `nerviq.config.js`
+
+Extend Nerviq with custom checks via a config file in your project root:
+
+```js
+// nerviq.config.js
+module.exports = {
+  plugins: [
+    {
+      name: 'my-company-checks',
+      checks: {
+        internalDocs: {
+          id: 'internalDocs',
+          name: 'Internal docs present',
+          check: (dir) => require('fs').existsSync(`${dir}/docs/internal.md`),
+          impact: 'medium',
+          category: 'Quality',
+          fix: 'Add docs/internal.md with team-specific guidelines',
+        },
+      },
+    },
+  ],
+};
+```
+
+See [docs/plugins.md](docs/plugins.md) for full plugin API reference.
+
+## GitHub Action
+
+Add Nerviq to your CI pipeline:
+
+```yaml
+# .github/workflows/nerviq.yml
+name: Nerviq Audit
+on: [push, pull_request]
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: nerviq/nerviq@v1
+        with:
+          threshold: 60
+```
+
+The action outputs `score`, `passed`, and `total` for use in downstream steps. Fails the workflow if the score is below the configured threshold.
+
+## Certification
+
+Earn a Nerviq certification badge for your project:
+
+```bash
+npx @nerviq/cli certify            # Run certification and display badge
+```
+
+Levels:
+- **Gold** — Harmony score >= 80, all platforms >= 70
+- **Silver** — Harmony score >= 60, all platforms >= 50
+- **Bronze** — Any platform >= 40
+
 ## All Commands
 
 | Command | What it does |
 |---------|-------------|
-| `nerviq audit` | Score 0-100 against 90 checks |
+| `nerviq audit` | Score 0-100 against 673 checks |
 | `nerviq audit --lite` | Quick top-3 scan |
 | `nerviq setup` | Generate starter-safe CLAUDE.md + hooks + commands |
 | `nerviq augment` | Repo-aware improvement plan (no writes) |
@@ -100,7 +216,20 @@ No install required. Zero dependencies.
 | `nerviq trend` | Export trend report |
 | `nerviq feedback` | Record recommendation outcomes |
 | `nerviq badge` | shields.io badge for README |
+| `nerviq certify` | Certification level + badge |
 | `nerviq scan dir1 dir2` | Compare multiple repos |
+| `nerviq harmony-audit` | Cross-platform DX audit |
+| `nerviq harmony-sync` | Sync config across platforms |
+| `nerviq harmony-drift` | Detect platform drift |
+| `nerviq harmony-advise` | Cross-platform advice |
+| `nerviq harmony-watch` | Live drift monitoring |
+| `nerviq harmony-governance` | Unified platform governance |
+| `nerviq synergy-report` | Multi-agent synergy analysis |
+| `nerviq catalog` | Show check catalog for all 8 platforms |
+| `nerviq doctor` | Self-diagnostics |
+| `nerviq convert` | Convert config between platforms |
+| `nerviq migrate` | Migrate platform config versions |
+| `nerviq serve` | Start local MCP-compatible HTTP API |
 
 ## Options
 
@@ -115,6 +244,17 @@ No install required. Zero dependencies.
 | `--auto` | Apply without prompts |
 | `--verbose` | Show all recommendations |
 | `--format sarif` | SARIF output for code scanning |
+| `--platform NAME` | Target platform (claude, codex, gemini, copilot, cursor, windsurf, aider, opencode) |
+
+## Backed by Research
+
+Nerviq is built on the CLAUDEX knowledge engine — the largest verified catalog of AI coding agent techniques:
+
+- **315 research documents** covering all 8 platforms
+- **100+ experiments** with tested, rated results
+- **673 checks** 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
 
 ## Privacy
 

package/bin/cli.js

@@ -8,6 +8,7 @@ const { getGovernanceSummary, printGovernanceSummary, ensureWritableProfile, ren
 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 { version } = require('../package.json');
 
 const args = process.argv.slice(2);
@@ -21,7 +22,7 @@ const COMMAND_ALIASES = {
   gov: 'governance',
   outcome: 'feedback',
 };
-const KNOWN_COMMANDS = ['audit', 'setup', 'augment', 'suggest-only', 'plan', 'apply', 'governance', 'benchmark', 'deep-review', 'interactive', 'watch', 'badge', 'insights', 'history', 'compare', 'trend', 'scan', 'feedback', 'doctor', 'convert', 'migrate', 'catalog', 'help', 'version'];
+const KNOWN_COMMANDS = ['audit', 'setup', 'augment', 'suggest-only', 'plan', 'apply', 'governance', 'benchmark', 'deep-review', 'interactive', 'watch', 'badge', 'insights', 'history', 'compare', 'trend', 'scan', 'feedback', 'doctor', 'convert', 'migrate', 'catalog', 'certify', 'serve', 'help', 'version'];
 
 function levenshtein(a, b) {
   const matrix = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
@@ -72,6 +73,7 @@ function parseArgs(rawArgs) {
   let feedbackScoreDelta = null;
   let platform = 'claude';
   let format = null;
+  let port = null;
   let commandSet = false;
   let extraArgs = [];
   let convertFrom = null;
@@ -82,7 +84,7 @@ function parseArgs(rawArgs) {
   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') {
+    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') {
       const value = rawArgs[i + 1];
       if (!value || value.startsWith('--')) {
         throw new Error(`${arg} requires a value`);
@@ -104,6 +106,7 @@ function parseArgs(rawArgs) {
       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();
       i++;
       continue;
     }
@@ -183,6 +186,11 @@ function parseArgs(rawArgs) {
       continue;
     }
 
+    if (arg.startsWith('--port=')) {
+      port = arg.split('=').slice(1).join('=').trim();
+      continue;
+    }
+
     if (arg.startsWith('--')) {
       flags.push(arg);
       continue;
@@ -198,111 +206,104 @@ function parseArgs(rawArgs) {
 
   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, extraArgs, convertFrom, convertTo, migrateFrom, migrateTo };
+  return { flags, command, normalizedCommand, threshold, out, planFile, only, profile, mcpPacks, requireChecks, feedbackKey, feedbackStatus, feedbackEffect, feedbackNotes, feedbackSource, feedbackScoreDelta, platform, format, port, extraArgs, convertFrom, convertTo, migrateFrom, migrateTo };
 }
 
 const HELP = `
   nerviq v${version}
-  Score your repo's Claude Code setup. Fix gaps safely. Benchmark the impact.
-
-  Start here (read-only, nothing changes):
-    npx nerviq                  Audit your project (10 seconds)
-    npx nerviq --lite           Quick scan: top 3 gaps + next command
-    npx nerviq --platform codex Audit your Codex repo setup
-    npx nerviq --platform codex augment      Codex-aware advisory pass, no writes
-    npx nerviq --platform codex suggest-only Structured Codex report, no writes
-    npx nerviq augment          Repo-aware analysis, no writes
-    npx nerviq suggest-only     Structured report, no writes
-
-  Plan and apply (when you're ready to change things):
-    npx nerviq plan             Export proposal bundles with previews
-    npx nerviq apply            Apply proposals selectively with rollback
-    npx nerviq setup            Generate starter-safe baseline
-    npx nerviq setup --auto     Apply all generated files without prompts
-
-  Track progress over time:
-    npx nerviq history          Show score history from saved snapshots
-    npx nerviq compare          Compare latest vs previous snapshot
-    npx nerviq trend --out r.md Export trend report as markdown
-
-  Multi-repo:
-    npx nerviq scan dir1 dir2   Compare multiple repos side-by-side
-
-  Advanced:
-    npx nerviq governance       Permission profiles, hooks, policy packs
-    npx nerviq benchmark        Before/after in isolated temp copy
-    npx nerviq deep-review      AI-powered config review (opt-in, uses API)
-    npx nerviq interactive      Step-by-step guided wizard
-    npx nerviq watch            Live monitoring on config changes with cross-platform watch fallback
-    npx nerviq badge            Generate shields.io badge markdown
-    npx nerviq feedback         Record recommendation outcomes or show local outcome summary
-
-  Catalog:
-    npx nerviq catalog          Show check catalog summary for all 8 platforms
-    npx nerviq catalog --json   Full catalog as JSON
-    npx nerviq catalog --out catalog.json  Write catalog to file
-
-  Utilities:
-    npx nerviq doctor           Self-diagnostics: Node version, deps, freshness gates, platform detection
-    npx nerviq convert --from claude --to codex   Convert config between platforms
-    npx nerviq migrate --platform cursor --from v2 --to v3   Migrate platform config to newer version
-
-  Options:
-    --threshold N   Exit with code 1 if score is below N (useful for CI)
-    --require A,B   Exit with code 1 if named checks fail (e.g. --require secretsProtection,permissionDeny)
-    --out FILE      Write JSON or markdown output to a file
-    --plan FILE     Load a previously exported plan file
-    --only A,B      Limit plan/apply to selected proposal ids or technique keys
-    --profile NAME  Choose permission profile (read-only, suggest-only, safe-write, power-user, internal-research)
-    --mcp-pack A,B  Merge named MCP packs into generated settings (e.g. context7-docs,next-devtools)
-    --key NAME      Recommendation key for feedback logging (e.g. permissionDeny)
-    --status VALUE  Feedback status: accepted, rejected, deferred
-    --effect VALUE  Feedback effect: positive, neutral, negative
-    --notes TEXT    Short notes to store with a feedback event
-    --source NAME   Source label for feedback event (default: manual-cli)
-    --score-delta N Optional observed score delta tied to the outcome
-    --platform NAME Choose platform surface (claude default, codex advisory/build preview)
-    --format NAME   Output format for audit results (json, sarif)
-    --feedback      After audit output, prompt "Was this helpful? (y/n)" for each displayed top action and save answers locally
-    --snapshot      Save a normalized snapshot artifact under .claude/nerviq/snapshots/
-    --lite          Show a short top-3 quick scan with one clear next command
-    --dry-run       Preview apply without writing files
-    --verbose       Show all recommendations (not just critical/high)
-    --json          Output as JSON (for CI pipelines)
-    --auto          Apply all generated setup files without prompting
-    --insights      Enable anonymous usage insights (off by default)
-    --help          Show this help
-    --version       Show version
-
-  Examples:
+  The intelligent nervous system for AI coding agents.
+  Audit, align, and amplify every platform on every project.
+
+  DISCOVER
+    nerviq audit                  Score your project (0-100)
+    nerviq audit --platform X     Audit specific platform (claude|codex|cursor|copilot|gemini|windsurf|aider|opencode)
+    nerviq audit --lite           Quick scan: top 3 gaps + next command
+    nerviq audit --json           Machine-readable JSON output (for CI)
+    nerviq scan dir1 dir2         Compare multiple repos side-by-side
+    nerviq catalog                Full check catalog (all 8 platforms)
+    nerviq catalog --json         Export full check catalog as JSON
+
+  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 doctor                 Self-diagnostics: Node, deps, freshness, platform detection
+
+  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 certify                Generate certification badge for your project
+
+  CROSS-PLATFORM
+    nerviq harmony-audit          Drift detection across all active platforms
+    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 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
+
+  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)
+    --format NAME     Output format: json | sarif
+    --port N          Port for \`serve\` (default: 3000)
+    --snapshot        Save snapshot artifact under .claude/nerviq/snapshots/
+    --lite            Short top-3 scan with one clear next step
+    --dry-run         Preview changes without writing files
+    --verbose         Show all checks (not just critical/high)
+    --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 codex
+    npx nerviq --platform cursor
     npx nerviq --platform codex augment
-    npx nerviq --platform codex suggest-only --json
-    npx nerviq --platform codex setup
-    npx nerviq --platform codex plan --out codex-plan.json
-    npx nerviq --platform codex --format sarif
-    npx nerviq --snapshot
-    npx nerviq augment
-    npx nerviq augment --snapshot
-    npx nerviq suggest-only --json
-    npx nerviq governance --snapshot
-    npx nerviq plan --out claudex-plan.json
-    npx nerviq plan --profile safe-write
+    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 claudex-plan.json --only hooks,commands
-    npx nerviq apply --mcp-pack context7-docs,next-devtools --only hooks
-    npx nerviq apply --profile power-user --only claude-md,hooks
-    npx nerviq governance --json
-    npx nerviq benchmark --out benchmark.md
-    npx nerviq feedback
-    npx nerviq feedback --key permissionDeny --status accepted --effect positive --score-delta 12
-    npx nerviq --json --threshold 60
-    npx nerviq setup --auto
-    npx nerviq interactive
-
-  Exit codes:
+    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
 `;
@@ -345,6 +346,7 @@ async function main() {
     require: parsed.requireChecks,
     platform: parsed.platform || 'claude',
     format: parsed.format || null,
+    port: parsed.port !== null ? Number(parsed.port) : null,
     dir: process.cwd()
   };
 
@@ -358,6 +360,11 @@ async function main() {
     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: --threshold must be a number between 0 and 100.\n');
     process.exit(1);
@@ -396,7 +403,7 @@ async function main() {
     const FULL_COMMAND_SET = new Set([
       'audit', 'scan', 'badge', 'augment', 'suggest-only', 'setup', 'plan', 'apply',
       'governance', 'benchmark', 'deep-review', 'interactive', 'watch', 'insights',
-      'history', 'compare', 'trend', 'feedback', 'catalog', 'help', 'version',
+      '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', 'synergy-report',
@@ -751,6 +758,53 @@ async function main() {
         }
       }
       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 === 'doctor') {
       const { runDoctor } = require('../src/doctor');
       const output = await runDoctor({ dir: options.dir, json: options.json, verbose: options.verbose });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nerviq/cli",
-  "version": "0.9.5",
-  "description": "The intelligent nervous system for AI coding agents — audit, align, and amplify every platform on every project.",
+  "version": "1.0.0",
+  "description": "The intelligent nervous system for AI coding agents — 673 checks across 8 platforms. Audit, align, and amplify.",
   "main": "src/index.js",
   "bin": {
     "nerviq": "bin/cli.js",
@@ -20,7 +20,7 @@
     "test": "node test/run.js",
     "test:jest": "jest",
     "test:coverage": "jest --coverage",
-    "test:all": "node test/run.js && node test/check-matrix.js && node test/codex-check-matrix.js && node test/golden-matrix.js && node test/codex-golden-matrix.js && node test/security-tests.js && jest",
+    "test:all": "node test/run.js && node test/check-matrix.js && node test/codex-check-matrix.js && node test/golden-matrix.js && node test/codex-golden-matrix.js && node test/gemini-check-matrix.js && node test/gemini-golden-matrix.js && node test/copilot-check-matrix.js && node test/copilot-golden-matrix.js && node test/cursor-check-matrix.js && node test/cursor-golden-matrix.js && node test/security-tests.js && jest",
     "benchmark:perf": "node tools/benchmark.js",
     "catalog": "node -e \"const {generateCatalog}=require('./src/catalog');console.log(JSON.stringify(generateCatalog(),null,2))\""
   },

package/src/audit.js

@@ -26,6 +26,7 @@ const { getBadgeMarkdown } = require('./badge');
 const { sendInsights, getLocalInsights } = require('./insights');
 const { getRecommendationOutcomeSummary, getRecommendationAdjustment } = require('./activity');
 const { formatSarif } = require('./formatters/sarif');
+const { loadPlugins, mergePluginChecks } = require('./plugins');
 
 const COLORS = {
   reset: '\x1b[0m',
@@ -728,8 +729,14 @@ async function audit(options) {
   const results = [];
   const outcomeSummary = getRecommendationOutcomeSummary(options.dir);
 
+  // Load and merge plugin checks
+  const plugins = loadPlugins(options.dir);
+  const techniques = plugins.length > 0
+    ? mergePluginChecks(spec.techniques, plugins)
+    : spec.techniques;
+
   // Run all technique checks
-  for (const [key, technique] of Object.entries(spec.techniques)) {
+  for (const [key, technique] of Object.entries(techniques)) {
     const passed = technique.check(ctx);
     const file = typeof technique.file === 'function' ? (technique.file(ctx) ?? null) : (technique.file ?? null);
     const line = typeof technique.line === 'function' ? (technique.line(ctx) ?? null) : (technique.line ?? null);

package/src/certification.js

@@ -0,0 +1,100 @@
+/**
+ * Certification system for Nerviq.
+ * Evaluates a project against all active platforms and assigns a certification level.
+ */
+
+const path = require('path');
+const { audit } = require('./audit');
+const { harmonyAudit } = require('./harmony/audit');
+const { detectPlatforms } = require('./public-api');
+
+const LEVELS = {
+  GOLD: 'Nerviq Certified Gold',
+  SILVER: 'Nerviq Certified Silver',
+  BRONZE: 'Nerviq Certified Bronze',
+  NONE: 'Not Certified',
+};
+
+const BADGE_COLORS = {
+  [LEVELS.GOLD]: 'gold',
+  [LEVELS.SILVER]: 'silver',
+  [LEVELS.BRONZE]: 'cd7f32',
+  [LEVELS.NONE]: 'lightgrey',
+};
+
+/**
+ * Certify a project directory.
+ * Runs harmony audit and per-platform audits, then determines certification level.
+ *
+ * @param {string} dir - Project directory path
+ * @returns {Promise<{ level: string, harmonyScore: number, platformScores: Object, badge: string }>}
+ */
+async function certifyProject(dir) {
+  const resolvedDir = path.resolve(dir || '.');
+
+  // Detect active platforms
+  const platforms = detectPlatforms(resolvedDir);
+
+  // Run per-platform audits
+  const platformScores = {};
+  for (const platform of platforms) {
+    try {
+      const result = await audit({ dir: resolvedDir, platform, silent: true });
+      platformScores[platform] = result.score;
+    } catch {
+      platformScores[platform] = 0;
+    }
+  }
+
+  // Run harmony audit
+  let harmonyScore = 0;
+  try {
+    const harmonyResult = await harmonyAudit({ dir: resolvedDir, silent: true });
+    harmonyScore = harmonyResult.harmonyScore || 0;
+  } catch {
+    harmonyScore = 0;
+  }
+
+  // Determine certification level
+  const scores = Object.values(platformScores);
+  const allAbove70 = scores.length > 0 && scores.every(s => s >= 70);
+  const allAbove50 = scores.length > 0 && scores.every(s => s >= 50);
+  const anyAbove40 = scores.some(s => s >= 40);
+
+  let level;
+  if (harmonyScore >= 80 && allAbove70) {
+    level = LEVELS.GOLD;
+  } else if (harmonyScore >= 60 && allAbove50) {
+    level = LEVELS.SILVER;
+  } else if (anyAbove40) {
+    level = LEVELS.BRONZE;
+  } else {
+    level = LEVELS.NONE;
+  }
+
+  const badge = generateCertBadge(level);
+
+  return {
+    level,
+    harmonyScore,
+    platformScores,
+    platforms,
+    badge,
+  };
+}
+
+/**
+ * Generate a shields.io badge markdown string for a certification level.
+ *
+ * @param {string} level - One of the LEVELS values
+ * @returns {string} Markdown badge string
+ */
+function generateCertBadge(level) {
+  const color = BADGE_COLORS[level] || 'lightgrey';
+  const label = encodeURIComponent('Nerviq');
+  const message = encodeURIComponent(level);
+  const url = `https://img.shields.io/badge/${label}-${message}-${color}`;
+  return `[![${level}](${url})](https://nerviq.net)`;
+}
+
+module.exports = { certifyProject, generateCertBadge, LEVELS };

package/src/index.js

@@ -87,6 +87,8 @@ const { setupOpenCode } = require('./opencode/setup');
 const { getOpenCodeGovernanceSummary } = require('./opencode/governance');
 const { runOpenCodeDeepReview } = require('./opencode/deep-review');
 const { opencodeInteractive } = require('./opencode/interactive');
+const { detectPlatforms, getCatalog, synergyReport } = require('./public-api');
+const { createServer, startServer } = require('./server');
 
 module.exports = {
   audit,
@@ -96,6 +98,11 @@ module.exports = {
   applyProposalBundle,
   getGovernanceSummary,
   runBenchmark,
+  detectPlatforms,
+  getCatalog,
+  synergyReport,
+  createServer,
+  startServer,
   DOMAIN_PACKS,
   detectDomainPacks,
   MCP_PACKS,

package/src/plugins.js

@@ -0,0 +1,110 @@
+/**
+ * Plugin system for Nerviq.
+ * Allows users to extend audits with custom checks via nerviq.config.js.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const REQUIRED_CHECK_FIELDS = ['id', 'name', 'check', 'impact', 'category', 'fix'];
+const VALID_IMPACTS = ['critical', 'high', 'medium', 'low'];
+
+/**
+ * Validate a single plugin object.
+ * Returns { valid: true } or { valid: false, errors: [...] }.
+ */
+function validatePlugin(plugin) {
+  const errors = [];
+
+  if (!plugin || typeof plugin !== 'object') {
+    return { valid: false, errors: ['Plugin must be a non-null object'] };
+  }
+
+  if (!plugin.name || typeof plugin.name !== 'string') {
+    errors.push('Plugin must have a non-empty string "name" field');
+  }
+
+  if (!plugin.checks || typeof plugin.checks !== 'object' || Array.isArray(plugin.checks)) {
+    errors.push('Plugin must have a "checks" object');
+    return { valid: false, errors };
+  }
+
+  for (const [key, check] of Object.entries(plugin.checks)) {
+    for (const field of REQUIRED_CHECK_FIELDS) {
+      if (check[field] === undefined || check[field] === null) {
+        errors.push(`Check "${key}" is missing required field "${field}"`);
+      }
+    }
+
+    if (typeof check.check !== 'function') {
+      errors.push(`Check "${key}" field "check" must be a function`);
+    }
+
+    if (check.impact && !VALID_IMPACTS.includes(check.impact)) {
+      errors.push(`Check "${key}" has invalid impact "${check.impact}". Must be one of: ${VALID_IMPACTS.join(', ')}`);
+    }
+  }
+
+  return errors.length > 0 ? { valid: false, errors } : { valid: true };
+}
+
+/**
+ * Load plugins from nerviq.config.js in the given directory.
+ * Returns an array of plugin objects, or [] if no config file exists.
+ */
+function loadPlugins(dir) {
+  const configPath = path.join(dir, 'nerviq.config.js');
+
+  if (!fs.existsSync(configPath)) {
+    return [];
+  }
+
+  let config;
+  try {
+    config = require(configPath);
+  } catch (err) {
+    console.error(`Failed to load nerviq.config.js: ${err.message}`);
+    return [];
+  }
+
+  if (!config || !Array.isArray(config.plugins)) {
+    return [];
+  }
+
+  const validPlugins = [];
+  for (const plugin of config.plugins) {
+    const result = validatePlugin(plugin);
+    if (result.valid) {
+      validPlugins.push(plugin);
+    } else {
+      console.error(`Plugin "${plugin && plugin.name || 'unknown'}" is invalid: ${result.errors.join('; ')}`);
+    }
+  }
+
+  return validPlugins;
+}
+
+/**
+ * Merge plugin checks into the existing techniques object.
+ * Plugin checks are prefixed with "plugin:" to avoid key collisions.
+ * Returns a new merged techniques object (does not mutate the original).
+ */
+function mergePluginChecks(techniques, plugins) {
+  const merged = { ...techniques };
+
+  for (const plugin of plugins) {
+    for (const [key, check] of Object.entries(plugin.checks)) {
+      const prefixedKey = `plugin:${plugin.name}:${key}`;
+      merged[prefixedKey] = {
+        ...check,
+        pluginName: plugin.name,
+        sourceUrl: check.sourceUrl || null,
+        confidence: check.confidence !== undefined ? check.confidence : 0.5,
+      };
+    }
+  }
+
+  return merged;
+}
+
+module.exports = { loadPlugins, mergePluginChecks, validatePlugin };

package/src/public-api.js

@@ -0,0 +1,173 @@
+const fs = require('fs');
+const path = require('path');
+const { audit } = require('./audit');
+const { harmonyAudit } = require('./harmony/audit');
+const { generateCatalog } = require('./catalog');
+const { compoundAudit, calculateAmplification } = require('./synergy/evidence');
+const { analyzeCompensation } = require('./synergy/compensation');
+const { discoverPatterns } = require('./synergy/patterns');
+const { rankRecommendations } = require('./synergy/ranking');
+const { generateSynergyReport } = require('./synergy/report');
+const { routeTask } = require('./synergy/routing');
+const { CodexProjectContext } = require('./codex/context');
+const { GeminiProjectContext } = require('./gemini/context');
+const { CopilotProjectContext } = require('./copilot/context');
+const { CursorProjectContext } = require('./cursor/context');
+const { WindsurfProjectContext } = require('./windsurf/context');
+const { AiderProjectContext } = require('./aider/context');
+const { OpenCodeProjectContext } = require('./opencode/context');
+
+const PLATFORM_ORDER = [
+  'claude',
+  'codex',
+  'gemini',
+  'copilot',
+  'cursor',
+  'windsurf',
+  'aider',
+  'opencode',
+];
+
+const PLATFORM_DETECTORS = {
+  claude: (dir) => exists(path.join(dir, 'CLAUDE.md')) || exists(path.join(dir, '.claude')),
+  codex: (dir) => CodexProjectContext.isCodexRepo(dir),
+  gemini: (dir) => GeminiProjectContext.isGeminiRepo(dir),
+  copilot: (dir) => CopilotProjectContext.isCopilotRepo(dir),
+  cursor: (dir) => CursorProjectContext.isCursorRepo(dir),
+  windsurf: (dir) => WindsurfProjectContext.isWindsurfRepo(dir),
+  aider: (dir) => AiderProjectContext.isAiderRepo(dir),
+  opencode: (dir) => OpenCodeProjectContext.isOpenCodeRepo(dir),
+};
+
+const IMPACT_SCORES = {
+  critical: 5,
+  high: 4,
+  medium: 3,
+  low: 2,
+};
+
+function exists(targetPath) {
+  try {
+    return fs.existsSync(targetPath);
+  } catch {
+    return false;
+  }
+}
+
+function resolveDir(dir) {
+  return path.resolve(dir || '.');
+}
+
+function detectPlatforms(dir) {
+  const resolvedDir = resolveDir(dir);
+  return PLATFORM_ORDER.filter((platform) => {
+    const detect = PLATFORM_DETECTORS[platform];
+    return typeof detect === 'function' ? detect(resolvedDir) : false;
+  });
+}
+
+function getCatalog() {
+  return generateCatalog();
+}
+
+function buildPatternHistory(dir, platformAudits) {
+  const timestamp = new Date().toISOString();
+  return Object.entries(platformAudits).map(([platform, result]) => ({
+    dir,
+    platform,
+    score: result.score,
+    findings: result.results || [],
+    timestamp,
+  }));
+}
+
+function buildRecommendationPool(platformAudits, compensation) {
+  const recommendations = [];
+
+  for (const [platform, result] of Object.entries(platformAudits)) {
+    const topActions = Array.isArray(result.topNextActions) ? result.topNextActions : [];
+    for (const action of topActions) {
+      recommendations.push({
+        key: action.key,
+        name: action.name,
+        description: action.fix,
+        impact: action.impact,
+        sourcePlatform: platform,
+        applicablePlatforms: [platform],
+        validatedOn: [platform],
+        baseScore: IMPACT_SCORES[action.impact] || 1,
+      });
+    }
+  }
+
+  for (const addition of compensation.recommendedAdditions || []) {
+    recommendations.push({
+      key: `add-${addition.platform}`,
+      name: `Add ${addition.platform}`,
+      description: `Covers ${addition.wouldCover.map((item) => item.label).join(', ')}`,
+      impact: addition.wouldCover.length >= 2 ? 'high' : 'medium',
+      sourcePlatform: addition.platform,
+      applicablePlatforms: [addition.platform],
+      validatedOn: [],
+      fillsGap: true,
+      baseScore: Math.max(2, Math.min(5, Math.round(addition.estimatedBenefit / Math.max(1, addition.wouldCover.length)))),
+    });
+  }
+
+  return recommendations;
+}
+
+async function synergyReport(dir) {
+  const resolvedDir = resolveDir(dir);
+  const activePlatforms = detectPlatforms(resolvedDir);
+  const platformAudits = {};
+  const errors = [];
+
+  for (const platform of activePlatforms) {
+    try {
+      platformAudits[platform] = await audit({
+        dir: resolvedDir,
+        platform,
+        silent: true,
+      });
+    } catch (error) {
+      errors.push({ platform, message: error.message });
+    }
+  }
+
+  const compound = compoundAudit(platformAudits);
+  const amplification = calculateAmplification(platformAudits);
+  const compensation = analyzeCompensation(activePlatforms, platformAudits);
+  const patterns = discoverPatterns(buildPatternHistory(resolvedDir, platformAudits)).patterns;
+  const recommendations = rankRecommendations(
+    buildRecommendationPool(platformAudits, compensation),
+    activePlatforms
+  );
+  const report = generateSynergyReport({
+    platformAudits,
+    activePlatforms,
+    recommendations,
+  });
+
+  return {
+    dir: resolvedDir,
+    activePlatforms,
+    platformAudits,
+    compound,
+    amplification,
+    compensation,
+    patterns,
+    recommendations,
+    errors,
+    report,
+  };
+}
+
+module.exports = {
+  audit,
+  harmonyAudit,
+  detectPlatforms,
+  getCatalog,
+  routeTask,
+  synergyReport,
+};

package/src/server.js

@@ -0,0 +1,123 @@
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { URL } = require('url');
+const { version } = require('../package.json');
+const { audit } = require('./audit');
+const { harmonyAudit } = require('./harmony/audit');
+const { getCatalog } = require('./public-api');
+
+const SUPPORTED_PLATFORMS = new Set([
+  'claude',
+  'codex',
+  'gemini',
+  'copilot',
+  'cursor',
+  'windsurf',
+  'aider',
+  'opencode',
+]);
+
+function sendJson(res, statusCode, payload) {
+  const body = JSON.stringify(payload, null, 2);
+  res.writeHead(statusCode, {
+    'Content-Type': 'application/json; charset=utf-8',
+    'Content-Length': Buffer.byteLength(body),
+    'Cache-Control': 'no-store',
+  });
+  res.end(body);
+}
+
+function resolveRequestDir(baseDir, rawDir) {
+  const requested = rawDir || '.';
+  const resolved = path.isAbsolute(requested)
+    ? requested
+    : path.resolve(baseDir, requested);
+
+  if (!fs.existsSync(resolved)) {
+    const error = new Error(`Directory not found: ${resolved}`);
+    error.statusCode = 400;
+    throw error;
+  }
+
+  return resolved;
+}
+
+function normalizePlatform(rawPlatform) {
+  const platform = (rawPlatform || 'claude').toLowerCase();
+  if (!SUPPORTED_PLATFORMS.has(platform)) {
+    const error = new Error(`Unsupported platform '${rawPlatform}'.`);
+    error.statusCode = 400;
+    throw error;
+  }
+  return platform;
+}
+
+function createServer(options = {}) {
+  const baseDir = path.resolve(options.baseDir || process.cwd());
+
+  return http.createServer(async (req, res) => {
+    const requestUrl = new URL(req.url || '/', 'http://127.0.0.1');
+
+    if (req.method !== 'GET') {
+      sendJson(res, 405, { error: 'Method not allowed' });
+      return;
+    }
+
+    try {
+      if (requestUrl.pathname === '/api/health') {
+        sendJson(res, 200, {
+          status: 'ok',
+          version,
+          checks: getCatalog().length,
+        });
+        return;
+      }
+
+      if (requestUrl.pathname === '/api/catalog') {
+        sendJson(res, 200, getCatalog());
+        return;
+      }
+
+      if (requestUrl.pathname === '/api/audit') {
+        const dir = resolveRequestDir(baseDir, requestUrl.searchParams.get('dir'));
+        const platform = normalizePlatform(requestUrl.searchParams.get('platform'));
+        const result = await audit({ dir, platform, silent: true });
+        sendJson(res, 200, result);
+        return;
+      }
+
+      if (requestUrl.pathname === '/api/harmony') {
+        const dir = resolveRequestDir(baseDir, requestUrl.searchParams.get('dir'));
+        const result = await harmonyAudit({ dir, silent: true });
+        sendJson(res, 200, result);
+        return;
+      }
+
+      sendJson(res, 404, { error: 'Not found' });
+    } catch (error) {
+      sendJson(res, error.statusCode || 500, {
+        error: error.message,
+      });
+    }
+  });
+}
+
+function startServer(options = {}) {
+  const port = options.port == null ? 3000 : Number(options.port);
+  const host = options.host || '127.0.0.1';
+  const server = createServer(options);
+
+  return new Promise((resolve, reject) => {
+    server.once('error', reject);
+    server.listen(port, host, () => {
+      server.off('error', reject);
+      resolve(server);
+    });
+  });
+}
+
+module.exports = {
+  createServer,
+  startServer,
+};