@nerviq/cli 1.8.4 → 1.8.6

package/README.md

@@ -85,7 +85,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
+## 2,431 Checks Across 96 Categories (8 Platforms × ~300 Governance Rules)
 
 | Category Group | Checks | Examples |
 |----------------|--------|---------|
@@ -104,7 +104,7 @@ No install required. Zero dependencies.
 | Memory & Context | ~15 | context management, compaction, @path |
 | Prompting & Design | ~10 | XML tags, constraints, frontend patterns |
 
-## Harmony — Cross-Platform Alignment
+## Harmony — Cross-Platform Alignment `GA`
 
 Harmony detects drift between your AI coding platforms and keeps them in sync.
 
@@ -118,9 +118,9 @@ npx @nerviq/cli harmony-governance # Unified governance across platforms
 npx @nerviq/cli harmony-add <platform>  # Add a new platform to your project
 ```
 
-## Synergy — Multi-Agent Amplification
+## Synergy — Multi-Agent Amplification `EXPERIMENTAL`
 
-Synergy analyzes how your platforms work together and finds amplification opportunities.
+Synergy analyzes how your platforms work together and finds amplification opportunities. Currently uses static routing rules — learned routing is planned for v2.0.
 
 ```bash
 npx @nerviq/cli synergy-report     # Multi-agent synergy analysis
@@ -128,7 +128,7 @@ 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`
+## SDK — `@nerviq/sdk` `BETA`
 
 Programmatic access to all Nerviq capabilities:
 
@@ -290,7 +290,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 and 10 languages, each with `sourceUrl` and `confidence` level (0.0-1.0)
+- **2,431 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
 
@@ -329,12 +329,24 @@ If Nerviq helped you, consider giving it a ⭐ on [GitHub](https://github.com/ne
 
 ## What Nerviq Is — and Isn't
 
+**Best for:** Teams going from zero governance to a strong baseline — fast. If you're starting with AI coding agents or have a few platforms running without consistent configuration, Nerviq gets you to a governed setup quickly.
+
+**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.
 
 **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.
 
+**Feature maturity:**
+
+| Label | Meaning |
+|-------|---------|
+| `GA` | Stable, tested on real repos, safe for production use |
+| `BETA` | Works but has limited real-world testing. API may change |
+| `EXPERIMENTAL` | Early stage, static rules, results may vary |
+
 ## Previously claudex-setup
 
 Nerviq was previously published as `claudex-setup`. If you were using it:

package/bin/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-const { audit } = require('../src/audit');
+const { audit, detectPlatforms, getCatalog } = require('../src/public-api');
 const { setup } = require('../src/setup');
 const { analyzeProject, printAnalysis, exportMarkdown } = require('../src/analyze');
 const { buildProposalBundle, printProposalBundle, writePlanFile, applyProposalBundle, printApplyResult } = require('../src/plans');
@@ -998,7 +998,7 @@ async function main() {
       const { watch } = require('../src/watch');
       await watch(options);
     } else if (normalizedCommand === 'catalog') {
-      const { generateCatalog, generateCatalogWithVersion, writeCatalogJson } = require('../src/catalog');
+      const { generateCatalogWithVersion, writeCatalogJson } = require('../src/catalog');
       if (options.out) {
         const result = writeCatalogJson(options.out);
         if (options.json) {
@@ -1007,7 +1007,7 @@ async function main() {
           console.log(`\n  Catalog written to ${result.path} (${result.count} checks)\n`);
         }
       } else {
-        const catalog = generateCatalog();
+        const catalog = getCatalog(); // dogfood: use SDK instead of internal import
         if (options.json) {
           const envelope = generateCatalogWithVersion();
           if (options.checkVersion) envelope.requestedVersion = options.checkVersion;

package/package.json

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

package/src/audit.js

@@ -1422,7 +1422,7 @@ async function audit(options) {
     if (activePlatforms.length >= 2) {
       const comp = analyzeCompensation(activePlatforms);
       const synergyScore = calculateSynergyScore(activePlatforms);
-      console.log(colorize(`  Cross-platform synergy: ${activePlatforms.length} platforms detected`, 'blue'));
+      console.log(colorize(`  Cross-platform synergy [EXPERIMENTAL]: ${activePlatforms.length} platforms detected`, 'blue'));
       console.log(colorize(`     Platforms: ${activePlatforms.join(', ')}`, 'dim'));
       console.log(colorize(`     Compensations: ${comp.compensations.length} | Gaps: ${comp.uncoveredGaps.length}`, 'dim'));
       console.log(colorize(`     Run: npx nerviq harmony-audit for full cross-platform analysis`, 'dim'));

package/src/source-urls.js

@@ -367,15 +367,32 @@ function hasRuntimeVerificationSignal(technique) {
   return /experiment(?:ally)? confirmed|confirmed by (?:live )?experiment|current runtime|runtime evidence|runtime-verified|validated in current runtime|observed in current runtime|measured in live experiment|reproduced in runtime|confirmed by experiment/i.test(haystack);
 }
 
+// Stack categories where checks are generated/adapted rather than individually verified
+const STACK_CATEGORIES = new Set([
+  'python', 'go', 'rust', 'java', 'ruby', 'dotnet', 'php', 'flutter', 'swift', 'kotlin',
+]);
+
 function resolveConfidence(platform, technique) {
   if (STALE_CONFIDENCE_IDS.has(technique.id)) {
     return 0.3;
   }
 
+  // Runtime-verified: highest confidence
   if (RUNTIME_CONFIDENCE_IDS[platform]?.has(technique.id) || hasRuntimeVerificationSignal(technique)) {
     return 0.9;
   }
 
+  // Has fix template: author wrote specific remediation → higher confidence
+  if (technique.template) {
+    return 0.8;
+  }
+
+  // Stack-specific checks: generated per-language, less individually verified
+  if (STACK_CATEGORIES.has(technique.category)) {
+    return 0.6;
+  }
+
+  // Default: documented but not individually experiment-verified
   return 0.7;
 }
 
@@ -396,7 +413,7 @@ function attachSourceUrls(platform, techniques) {
     }
 
     technique.sourceUrl = technique.sourceUrl || resolved;
-    technique.confidence = technique.confidence ?? resolveConfidence(platform, technique);
+    technique.confidence = resolveConfidence(platform, technique);
     technique.lastVerified = technique.lastVerified || LAST_VERIFIED[platform] || LAST_VERIFIED.default;
   }
 

package/src/synergy/report.js

@@ -51,8 +51,9 @@ function formatSynergyReport(options) {
   // Header
   lines.push('');
   lines.push(c('  ╔══════════════════════════════════════════════════╗', 'blue'));
-  lines.push(c('  ║           SYNERGY DASHBOARD                     ║', 'blue'));
+  lines.push(c('  ║     SYNERGY DASHBOARD [EXPERIMENTAL]             ║', 'blue'));
   lines.push(c('  ╚══════════════════════════════════════════════════╝', 'blue'));
+  lines.push(c('  Static routing rules. Learned routing planned for v2.0.', 'dim'));
   lines.push('');
 
   // Compound audit