@nerviq/cli 1.18.0 → 1.20.0

package/LICENSE

@@ -1,23 +1,23 @@
-                    GNU AFFERO GENERAL PUBLIC LICENSE
-                       Version 3, 19 November 2007
-
-Copyright (c) 2026 Nerviq (nerviq.net)
-
-Everyone is permitted to copy and distribute verbatim copies of this
-license document, but changing it is not allowed.
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU Affero General Public License as
-published by the Free Software Foundation, either version 3 of the
-License, or (at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-GNU Affero General Public License for more details.
-
-You should have received a copy of the GNU Affero General Public License
-along with this program. If not, see <https://www.gnu.org/licenses/agpl-3.0.html>.
-
-For the full AGPL-3.0 license text, see:
-https://www.gnu.org/licenses/agpl-3.0.html
+                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
+
+Copyright (c) 2026 Nerviq (nerviq.net)
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/agpl-3.0.html>.
+
+For the full AGPL-3.0 license text, see:
+https://www.gnu.org/licenses/agpl-3.0.html

package/README.md

@@ -223,8 +223,8 @@ All successful operational responses are wrapped in a JSON envelope:
 {
   "data": {},
   "meta": {
-    "version": "1.18.0",
-    "timestamp": "2026-04-12T12:00:00.000Z"
+    "version": "1.20.0",
+    "timestamp": "2026-04-13T12:00:00.000Z"
   }
 }
 ```

package/bin/cli.js

@@ -576,12 +576,12 @@ const HELP = `
   Audit, align, and amplify every platform on every project.
   New here? Run: nerviq --beginner
 
-  DISCOVER
-    nerviq audit                  Quick scan: score + top 3 gaps (Harmony-first when 2+ platforms detected)
-    nerviq audit --fix            Audit, apply fixable critical fixes, then re-audit
-    nerviq audit --fix --dry-run  Show proposed autofix diff without writing
-    nerviq audit --no-harmony-first   Skip the cross-platform Harmony header
-    nerviq audit --full           Full audit with all checks, weakest areas, badge
+  DISCOVER
+    nerviq audit                  Quick scan: score + top 3 gaps (Harmony-first when 2+ platforms detected)
+    nerviq audit --fix            Audit, apply fixable critical fixes, then re-audit
+    nerviq audit --fix --dry-run  Show proposed autofix diff without writing
+    nerviq audit --no-harmony-first   Skip the cross-platform Harmony header
+    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 stack-specific package profiles
@@ -602,9 +602,9 @@ const HELP = `
     nerviq check-health           Detect regressions + platform format changes between snapshots
     nerviq doctor                 Self-diagnostics: Node, deps, freshness, MCP, hook runtime
 
-  FIX
-    nerviq fix                    Show fixable checks and manual-fix guidance
-    nerviq fix <key>              Auto-fix a specific check (with score impact)
+  FIX
+    nerviq fix                    Show fixable checks and manual-fix guidance
+    nerviq fix <key>              Auto-fix a specific check (with score impact)
     nerviq fix <key> --prompt     Show AI agent prompt for a check (no auto-fix)
     nerviq fix --all-critical     Fix all critical issues at once
     nerviq fix --dry-run          Preview fixes without writing
@@ -775,12 +775,12 @@ const BEGINNER_HELP = `
     nerviq augment    Show an improvement plan without writing
     nerviq doctor     Check install health, freshness, platform detection, MCP, and hook runtime
 
-  SIMPLE PATH
-    1. nerviq audit
-    2. nerviq setup --auto
-    3. nerviq audit --fix --auto
-    4. nerviq augment
-    5. nerviq doctor
+  SIMPLE PATH
+    1. nerviq audit
+    2. nerviq setup --auto
+    3. nerviq audit --fix --auto
+    4. nerviq augment
+    5. nerviq doctor
 
   WHEN YOU ARE READY
     nerviq --help     Show the full command set
@@ -2095,34 +2095,34 @@ async function main() {
       });
       console.log(output);
       process.exit(0);
-    } else if (normalizedCommand === 'fix') {
-      // nerviq fix [key] [--all-critical] [--dry-run] [--auto] [--prompt]
-      const fixKey = parsed.extraArgs[0] || null;
-      const allCritical = flags.includes('--all-critical');
-      const promptOnly = flags.includes('--prompt');
-      const autoApply = options.auto;
-      const isDryRun = options.dryRun;
-      const { getFixableFailedResults, isFixableKey, applyFixes } = require('../src/fix-engine');
-
-      // Step 1: Run silent audit to find failed checks (only actual failures, not skipped/null)
-      const auditResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
-      const failedResults = (auditResult.results || []).filter(r => r.passed === false);
+    } else if (normalizedCommand === 'fix') {
+      // nerviq fix [key] [--all-critical] [--dry-run] [--auto] [--prompt]
+      const fixKey = parsed.extraArgs[0] || null;
+      const allCritical = flags.includes('--all-critical');
+      const promptOnly = flags.includes('--prompt');
+      const autoApply = options.auto;
+      const isDryRun = options.dryRun;
+      const { getFixableFailedResults, isFixableKey, applyFixes } = require('../src/fix-engine');
+
+      // Step 1: Run silent audit to find failed checks (only actual failures, not skipped/null)
+      const auditResult = await audit({ dir: options.dir, silent: true, platform: options.platform });
+      const failedResults = (auditResult.results || []).filter(r => r.passed === false);
 
       if (failedResults.length === 0) {
         console.log('\n  ✅ All checks passing — nothing to fix.\n');
         process.exit(0);
       }
 
-      // Step 2: Determine which checks to fix
-      const { FIX_PROMPTS, formatFixPrompt } = require('../src/fix-prompts');
-
-      let targetKeys = [];
-      const fixableFailedResults = getFixableFailedResults(failedResults, { mode: 'fix' });
-
-      if (fixKey) {
-        // Fix a specific check
-        if (!failedResults.find(r => r.key === fixKey)) {
-          const passed = (auditResult.results || []).find(r => r.key === fixKey && r.passed);
+      // Step 2: Determine which checks to fix
+      const { FIX_PROMPTS, formatFixPrompt } = require('../src/fix-prompts');
+
+      let targetKeys = [];
+      const fixableFailedResults = getFixableFailedResults(failedResults, { mode: 'fix' });
+
+      if (fixKey) {
+        // Fix a specific check
+        if (!failedResults.find(r => r.key === fixKey)) {
+          const passed = (auditResult.results || []).find(r => r.key === fixKey && r.passed);
           if (passed) {
             console.log(`\n  ✅ '${fixKey}' is already passing.\n`);
           } else {
@@ -2140,37 +2140,37 @@ async function main() {
             const failedCheck = failedResults.find(r => r.key === fixKey);
             console.log(`\n  No AI prompt available for '${fixKey}'.`);
             console.log(`  Manual fix: ${failedCheck ? failedCheck.fix : 'See nerviq audit --full.'}\n`);
-          }
-          process.exit(0);
-        }
-        if (!isFixableKey(fixKey, { mode: 'fix' })) {
-          const aiPrompt = FIX_PROMPTS[fixKey];
-          const failedCheck = failedResults.find(r => r.key === fixKey);
-          if (aiPrompt) {
-            console.log(formatFixPrompt(fixKey, aiPrompt));
-          } else {
-            console.log(`\n  📋 ${failedCheck.name} (manual fix needed)`);
-            console.log(`     ${failedCheck.fix}\n`);
-          }
-          process.exit(0);
-        }
-        targetKeys = [fixKey];
-      } else if (allCritical) {
-        targetKeys = getFixableFailedResults(failedResults, { mode: 'fix', criticalOnly: true }).map(r => r.key);
-        if (targetKeys.length === 0) {
-          console.log('\n  ✅ No critical issues found.\n');
-          process.exit(0);
-        }
-      } else {
-        // No key specified — show fixable checks and exit
-        const fixable = fixableFailedResults;
-        const fixableKeySet = new Set(fixable.map(r => r.key));
-        const nonFixable = failedResults.filter(r => !fixableKeySet.has(r.key));
-        console.log('');
-        console.log(`  nerviq fix — ${failedResults.length} failed checks\n`);
-        if (fixable.length > 0) {
-          console.log(`  Auto-fixable (${fixable.length}):`);
-          for (const r of fixable) {
+          }
+          process.exit(0);
+        }
+        if (!isFixableKey(fixKey, { mode: 'fix' })) {
+          const aiPrompt = FIX_PROMPTS[fixKey];
+          const failedCheck = failedResults.find(r => r.key === fixKey);
+          if (aiPrompt) {
+            console.log(formatFixPrompt(fixKey, aiPrompt));
+          } else {
+            console.log(`\n  📋 ${failedCheck.name} (manual fix needed)`);
+            console.log(`     ${failedCheck.fix}\n`);
+          }
+          process.exit(0);
+        }
+        targetKeys = [fixKey];
+      } else if (allCritical) {
+        targetKeys = getFixableFailedResults(failedResults, { mode: 'fix', criticalOnly: true }).map(r => r.key);
+        if (targetKeys.length === 0) {
+          console.log('\n  ✅ No critical issues found.\n');
+          process.exit(0);
+        }
+      } else {
+        // No key specified — show fixable checks and exit
+        const fixable = fixableFailedResults;
+        const fixableKeySet = new Set(fixable.map(r => r.key));
+        const nonFixable = failedResults.filter(r => !fixableKeySet.has(r.key));
+        console.log('');
+        console.log(`  nerviq fix — ${failedResults.length} failed checks\n`);
+        if (fixable.length > 0) {
+          console.log(`  Auto-fixable (${fixable.length}):`);
+          for (const r of fixable) {
             const tier = r.impact === 'critical' ? '🔴' : r.impact === 'high' ? '🟡' : '🔵';
             console.log(`    ${tier} nerviq fix ${r.key}`);
           }
@@ -2207,23 +2207,23 @@ async function main() {
           console.log(`    nerviq fix ${fixable[0].key}        Fix the first auto-fixable check`);
           console.log(`    nerviq fix --all-critical    Fix all critical issues at once`);
         }
-        console.log('');
-        process.exit(0);
-      }
-
-      const outcome = await applyFixes({
-        dir: options.dir,
-        platform: options.platform,
-        auditResult,
-        targetKeys,
-        auto: autoApply,
-        dryRun: isDryRun,
-        mode: 'fix',
-        recordOutcomes: true,
-      });
-      process.exit(outcome.exitCode);
-
-    } else if (normalizedCommand === 'init') {
+        console.log('');
+        process.exit(0);
+      }
+
+      const outcome = await applyFixes({
+        dir: options.dir,
+        platform: options.platform,
+        auditResult,
+        targetKeys,
+        auto: autoApply,
+        dryRun: isDryRun,
+        mode: 'fix',
+        recordOutcomes: true,
+      });
+      process.exit(outcome.exitCode);
+
+    } else if (normalizedCommand === 'init') {
       const { runInit } = require('../src/init');
       await runInit(options.dir, flags);
       process.exit(0);
@@ -2273,11 +2273,11 @@ async function main() {
       }
       // MOAT-01: Harmony-first default — when 2+ platforms and platform not explicit
       let harmonyFirstResult = null;
-      if (!options.platformExplicit && !options.noHarmonyFirst && !options.diffOnly && !options.driftMode && !options.workspace) {
-        const detected = detectPlatforms(options.dir) || [];
-        if (detected.length >= 2) {
-          try {
-            const { harmonyAudit } = require('../src/harmony/audit');
+      if (!options.platformExplicit && !options.noHarmonyFirst && !options.diffOnly && !options.driftMode && !options.workspace) {
+        const detected = detectPlatforms(options.dir) || [];
+        if (detected.length >= 2) {
+          try {
+            const { harmonyAudit } = require('../src/harmony/audit');
             harmonyFirstResult = await harmonyAudit({ dir: options.dir, silent: true });
             if (!options.json && harmonyFirstResult) {
               const hs = harmonyFirstResult.harmonyScore;
@@ -2291,46 +2291,46 @@ async function main() {
             }
           } catch {
             harmonyFirstResult = null;
-          }
-        }
-      }
-
-      if (options.fix) {
-        if (options.diffOnly) {
-          console.error('\n  Error: --diff-only cannot be combined with --fix.\n');
-          process.exit(2);
-        }
-
-        const { getFixableFailedResults, applyFixes } = require('../src/fix-engine');
-        const auditResult = await audit({ ...options, silent: true });
-        const failedResults = (auditResult.results || []).filter((item) => item.passed === false);
-        const targetKeys = getFixableFailedResults(failedResults, { mode: 'audit', criticalOnly: true }).map((item) => item.key);
-
-        if (targetKeys.length === 0) {
-          console.log('');
-          console.log('  אין תיקוני critical אוטומטיים זמינים למסלול audit --fix.');
-          console.log('  נסו `nerviq fix <key> --prompt` עבור תיקון ידני, או הריצו audit מלא כדי לראות את כל הפערים.');
-          console.log('');
-          process.exit(2);
-        }
-
-        const outcome = await applyFixes({
-          dir: options.dir,
-          platform: options.platform,
-          auditResult,
-          targetKeys,
-          auto: options.auto,
-          dryRun: options.dryRun,
-          mode: 'audit',
-        });
-        process.exit(outcome.exitCode);
-      }
-
-      let result;
-      const renderAuditJsonLocally = options.json && (Boolean(options.driftMode) || Boolean(harmonyFirstResult));
-      if (options.diffOnly) {
-        const { getChangedFiles, buildDiffOnlyAuditView, printDiffOnlyAudit } = require('../src/diff-only');
-        const fullResult = await audit({ ...options, silent: true });
+          }
+        }
+      }
+
+      if (options.fix) {
+        if (options.diffOnly) {
+          console.error('\n  Error: --diff-only cannot be combined with --fix.\n');
+          process.exit(2);
+        }
+
+        const { getFixableFailedResults, applyFixes } = require('../src/fix-engine');
+        const auditResult = await audit({ ...options, silent: true });
+        const failedResults = (auditResult.results || []).filter((item) => item.passed === false);
+        const targetKeys = getFixableFailedResults(failedResults, { mode: 'audit', criticalOnly: true }).map((item) => item.key);
+
+        if (targetKeys.length === 0) {
+          console.log('');
+          console.log('  אין תיקוני critical אוטומטיים זמינים למסלול audit --fix.');
+          console.log('  נסו `nerviq fix <key> --prompt` עבור תיקון ידני, או הריצו audit מלא כדי לראות את כל הפערים.');
+          console.log('');
+          process.exit(2);
+        }
+
+        const outcome = await applyFixes({
+          dir: options.dir,
+          platform: options.platform,
+          auditResult,
+          targetKeys,
+          auto: options.auto,
+          dryRun: options.dryRun,
+          mode: 'audit',
+        });
+        process.exit(outcome.exitCode);
+      }
+
+      let result;
+      const renderAuditJsonLocally = options.json && (Boolean(options.driftMode) || Boolean(harmonyFirstResult));
+      if (options.diffOnly) {
+        const { getChangedFiles, buildDiffOnlyAuditView, printDiffOnlyAudit } = require('../src/diff-only');
+        const fullResult = await audit({ ...options, silent: true });
         const diffInfo = getChangedFiles(options.dir, {
           diffBase: options.diffBase,
           diffHead: options.diffHead,
@@ -2536,6 +2536,7 @@ async function main() {
     }
   } catch (err) {
     console.error(`\n  Error: ${err.message}`);
+    if (process.env.NERVIQ_DEBUG) console.error(err.stack);
     console.error('  Fix: Run `npx nerviq doctor` to diagnose common issues, or check https://github.com/nerviq/nerviq#troubleshooting');
     process.exit(2);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nerviq/cli",
-  "version": "1.18.0",
+  "version": "1.20.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": {
@@ -18,6 +18,7 @@
     "build": "npm pack --dry-run",
     "test": "node test/run.js",
     "verify:release-metadata": "node tools/validate-release-metadata.js",
+    "prepublish:check": "node tools/pre-publish.js",
     "test:jest": "jest",
     "test:coverage": "jest --coverage",
     "test:all": "npm test && npx jest && node test/check-matrix.js && node test/codex-check-matrix.js && node test/gemini-check-matrix.js && node test/copilot-check-matrix.js && node test/cursor-check-matrix.js && node test/windsurf-check-matrix.js && node test/aider-check-matrix.js && node test/opencode-check-matrix.js && node test/golden-matrix.js && node test/codex-golden-matrix.js && node test/gemini-golden-matrix.js && node test/copilot-golden-matrix.js && node test/cursor-golden-matrix.js && node test/windsurf-golden-matrix.js && node test/aider-golden-matrix.js && node test/opencode-golden-matrix.js",