@nerviq/cli 0.9.3 → 0.9.5

package/bin/cli.js

@@ -7,6 +7,7 @@ const { buildProposalBundle, printProposalBundle, writePlanFile, applyProposalBu
 const { getGovernanceSummary, printGovernanceSummary, ensureWritableProfile, renderGovernanceMarkdown } = require('../src/governance');
 const { runBenchmark, printBenchmark, writeBenchmarkReport } = require('../src/benchmark');
 const { writeSnapshotArtifact, recordRecommendationOutcome, formatRecommendationOutcomeSummary, getRecommendationOutcomeSummary } = require('../src/activity');
+const { collectFeedback } = require('../src/feedback');
 const { version } = require('../package.json');
 
 const args = process.argv.slice(2);
@@ -20,7 +21,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', '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', 'help', 'version'];
 
 function levenshtein(a, b) {
   const matrix = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
@@ -73,11 +74,15 @@ function parseArgs(rawArgs) {
   let format = null;
   let commandSet = false;
   let extraArgs = [];
+  let convertFrom = null;
+  let convertTo = null;
+  let migrateFrom = null;
+  let migrateTo = null;
 
   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') {
+    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') {
       const value = rawArgs[i + 1];
       if (!value || value.startsWith('--')) {
         throw new Error(`${arg} requires a value`);
@@ -97,6 +102,8 @@ function parseArgs(rawArgs) {
       if (arg === '--score-delta') feedbackScoreDelta = value.trim();
       if (arg === '--platform') platform = value.trim().toLowerCase();
       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(); }
       i++;
       continue;
     }
@@ -191,7 +198,7 @@ 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 };
+  return { flags, command, normalizedCommand, threshold, out, planFile, only, profile, mcpPacks, requireChecks, feedbackKey, feedbackStatus, feedbackEffect, feedbackNotes, feedbackSource, feedbackScoreDelta, platform, format, extraArgs, convertFrom, convertTo, migrateFrom, migrateTo };
 }
 
 const HELP = `
@@ -230,6 +237,16 @@ const HELP = `
     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)
@@ -246,6 +263,7 @@ const HELP = `
     --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
@@ -316,6 +334,7 @@ async function main() {
     auto: flags.includes('--auto'),
     lite: flags.includes('--lite'),
     snapshot: flags.includes('--snapshot'),
+    feedback: flags.includes('--feedback'),
     dryRun: flags.includes('--dry-run'),
     threshold: parsed.threshold !== null ? Number(parsed.threshold) : null,
     out: parsed.out,
@@ -377,7 +396,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', 'help', 'version',
+      'history', 'compare', 'trend', 'feedback', 'catalog', 'help', 'version',
       // Harmony + Synergy (cross-platform)
       'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise',
       'harmony-watch', 'harmony-governance', 'synergy-report',
@@ -699,6 +718,67 @@ async function main() {
     } else if (normalizedCommand === 'watch') {
       const { watch } = require('../src/watch');
       await watch(options);
+    } else if (normalizedCommand === 'catalog') {
+      const { generateCatalog, writeCatalogJson } = require('../src/catalog');
+      if (options.out) {
+        const result = writeCatalogJson(options.out);
+        if (options.json) {
+          console.log(JSON.stringify({ path: result.path, count: result.count }));
+        } else {
+          console.log(`\n  Catalog written to ${result.path} (${result.count} checks)\n`);
+        }
+      } else {
+        const catalog = generateCatalog();
+        if (options.json) {
+          console.log(JSON.stringify(catalog, null, 2));
+        } else {
+          // Print summary table
+          const platforms = {};
+          for (const entry of catalog) {
+            platforms[entry.platform] = (platforms[entry.platform] || 0) + 1;
+          }
+          console.log('');
+          console.log('\x1b[1m  nerviq check catalog\x1b[0m');
+          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+          console.log(`  Total checks: \x1b[1m${catalog.length}\x1b[0m`);
+          console.log('');
+          for (const [plat, count] of Object.entries(platforms)) {
+            console.log(`    ${plat.padEnd(12)} ${count} checks`);
+          }
+          console.log('');
+          console.log('  Use --json for full output or --out catalog.json to write file.');
+          console.log('');
+        }
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'doctor') {
+      const { runDoctor } = require('../src/doctor');
+      const output = await runDoctor({ dir: options.dir, json: options.json, verbose: options.verbose });
+      console.log(output);
+      process.exit(0);
+    } else if (normalizedCommand === 'convert') {
+      const { runConvert } = require('../src/convert');
+      const output = await runConvert({
+        dir: options.dir,
+        from: parsed.convertFrom,
+        to: parsed.convertTo,
+        dryRun: options.dryRun,
+        json: options.json,
+      });
+      console.log(output);
+      process.exit(0);
+    } else if (normalizedCommand === 'migrate') {
+      const { runMigrate } = require('../src/migrate');
+      const output = await runMigrate({
+        dir: options.dir,
+        platform: options.platform || parsed.platform || 'claude',
+        from: parsed.migrateFrom,
+        to: parsed.migrateTo,
+        dryRun: options.dryRun,
+        json: options.json,
+      });
+      console.log(output);
+      process.exit(0);
     } else if (normalizedCommand === 'setup') {
       await setup(options);
       if (options.snapshot) {
@@ -712,6 +792,25 @@ async function main() {
       }
     } else {
       const result = await audit(options);
+      if (options.feedback && !options.json && options.format === null) {
+        const feedbackTargets = options.lite
+          ? (result.liteSummary?.topNextActions || [])
+          : (result.topNextActions || []);
+        const feedbackResult = await collectFeedback(options.dir, {
+          findings: feedbackTargets,
+          platform: result.platform,
+          sourceCommand: normalizedCommand,
+          score: result.score,
+        });
+        if (feedbackResult.mode === 'skipped-noninteractive') {
+          console.log('  Feedback prompt skipped: interactive terminal required.');
+          console.log('');
+        } else if (feedbackResult.saved > 0) {
+          console.log(`  Feedback saved: ${feedbackResult.relativeDir}`);
+          console.log(`  Helpful: ${feedbackResult.helpful} | Not helpful: ${feedbackResult.unhelpful}`);
+          console.log('');
+        }
+      }
       const snapshot = options.snapshot ? writeSnapshotArtifact(options.dir, 'audit', result, {
         sourceCommand: normalizedCommand,
       }) : null;

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@nerviq/cli",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "The intelligent nervous system for AI coding agents — audit, align, and amplify every platform on every project.",
   "main": "src/index.js",
   "bin": {
-    "nerviq": "bin/cli.js"
+    "nerviq": "bin/cli.js",
+    "nerviq-mcp": "src/mcp-server.js"
   },
   "files": [
     "bin",
@@ -19,7 +20,9 @@
     "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/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))\""
   },
   "keywords": [
     "nerviq",

package/src/aider/techniques.js

@@ -20,6 +20,7 @@
  */
 
 const { containsEmbeddedSecret } = require('../secret-patterns');
+const { attachSourceUrls } = require('../source-urls');
 
 const FILLER_PATTERNS = [
   /\bbe helpful\b/i,
@@ -1389,6 +1390,8 @@ const AIDER_TECHNIQUES = {
   },
 };
 
+attachSourceUrls('aider', AIDER_TECHNIQUES);
+
 module.exports = {
   AIDER_TECHNIQUES,
 };

package/src/audit.js

@@ -461,7 +461,7 @@ function buildTopNextActions(failed, limit = 5, outcomeSummaryByKey = {}, option
       return scoreB - scoreA;
     })
     .slice(0, limit)
-    .map(({ key, id, name, impact, fix, category }) => {
+    .map(({ key, id, name, impact, fix, category, sourceUrl }) => {
       const feedback = outcomeSummaryByKey[key] || null;
       const rankingAdjustment = getRecommendationAdjustment(outcomeSummaryByKey, key);
       const signals = [
@@ -491,6 +491,7 @@ function buildTopNextActions(failed, limit = 5, outcomeSummaryByKey = {}, option
       name,
       impact,
       category,
+      sourceUrl,
       module: CATEGORY_MODULES[category] || category,
       fix,
       priorityScore,
@@ -810,7 +811,7 @@ async function audit(options) {
     stacks,
     results,
     categoryScores,
-    quickWins: quickWins.map(({ key, name, impact, fix, category }) => ({ key, name, impact, category, fix })),
+    quickWins: quickWins.map(({ key, name, impact, fix, category, sourceUrl }) => ({ key, name, impact, category, fix, sourceUrl })),
     topNextActions,
     recommendationOutcomes: {
       totalEntries: outcomeSummary.totalEntries,

package/src/catalog.js

@@ -0,0 +1,87 @@
+/**
+ * Public Check Catalog Generator
+ * Reads ALL technique files from all 8 platforms and generates a unified JSON catalog.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { TECHNIQUES: CLAUDE_TECHNIQUES } = require('./techniques');
+const { CODEX_TECHNIQUES } = require('./codex/techniques');
+const { GEMINI_TECHNIQUES } = require('./gemini/techniques');
+const { COPILOT_TECHNIQUES } = require('./copilot/techniques');
+const { CURSOR_TECHNIQUES } = require('./cursor/techniques');
+const { WINDSURF_TECHNIQUES } = require('./windsurf/techniques');
+const { AIDER_TECHNIQUES } = require('./aider/techniques');
+const { OPENCODE_TECHNIQUES } = require('./opencode/techniques');
+const { attachSourceUrls } = require('./source-urls');
+
+const PLATFORM_MAP = {
+  claude:   CLAUDE_TECHNIQUES,
+  codex:    CODEX_TECHNIQUES,
+  gemini:   GEMINI_TECHNIQUES,
+  copilot:  COPILOT_TECHNIQUES,
+  cursor:   CURSOR_TECHNIQUES,
+  windsurf: WINDSURF_TECHNIQUES,
+  aider:    AIDER_TECHNIQUES,
+  opencode: OPENCODE_TECHNIQUES,
+};
+
+/**
+ * Generate a unified catalog array from all platform technique files.
+ * Each entry contains:
+ *   platform, id, key, name, category, impact, rating, fix, sourceUrl,
+ *   confidence, template, deprecated
+ */
+function generateCatalog() {
+  const catalog = [];
+
+  for (const [platform, techniques] of Object.entries(PLATFORM_MAP)) {
+    // Clone techniques so we don't mutate the originals
+    const cloned = {};
+    for (const [key, tech] of Object.entries(techniques)) {
+      cloned[key] = { ...tech };
+    }
+
+    // Attach source URLs
+    try {
+      attachSourceUrls(platform, cloned);
+    } catch (_) {
+      // If source URLs fail for a platform, continue without them
+    }
+
+    for (const [key, tech] of Object.entries(cloned)) {
+      catalog.push({
+        platform,
+        id: tech.id ?? null,
+        key,
+        name: tech.name ?? null,
+        category: tech.category ?? null,
+        impact: tech.impact ?? null,
+        rating: tech.rating ?? null,
+        fix: tech.fix ?? null,
+        sourceUrl: tech.sourceUrl ?? null,
+        confidence: tech.confidence ?? null,
+        template: tech.template ?? null,
+        deprecated: tech.deprecated ?? false,
+      });
+    }
+  }
+
+  return catalog;
+}
+
+/**
+ * Write the catalog as formatted JSON to the given output path.
+ * @param {string} outputPath - Absolute or relative path for the JSON file
+ * @returns {{ path: string, count: number }} Written path and entry count
+ */
+function writeCatalogJson(outputPath) {
+  const catalog = generateCatalog();
+  const resolved = path.resolve(outputPath);
+  fs.mkdirSync(path.dirname(resolved), { recursive: true });
+  fs.writeFileSync(resolved, JSON.stringify(catalog, null, 2) + '\n', 'utf8');
+  return { path: resolved, count: catalog.length };
+}
+
+module.exports = { generateCatalog, writeCatalogJson };

package/src/codex/techniques.js

@@ -1,6 +1,7 @@
 const os = require('os');
 const path = require('path');
 const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
+const { attachSourceUrls } = require('../source-urls');
 
 const DEFAULT_PROJECT_DOC_MAX_BYTES = 32768;
 const SUPPORTED_HOOK_EVENTS = new Set(['SessionStart', 'PreToolUse', 'PostToolUse', 'UserPromptSubmit', 'Stop']);
@@ -3249,6 +3250,8 @@ const CODEX_TECHNIQUES = {
   },
 };
 
+attachSourceUrls('codex', CODEX_TECHNIQUES);
+
 module.exports = {
   CODEX_TECHNIQUES,
 };