@nerviq/cli 1.2.3 → 1.2.6

package/bin/cli.js

@@ -24,7 +24,7 @@ const COMMAND_ALIASES = {
   gov: 'governance',
   outcome: 'feedback',
 };
-const KNOWN_COMMANDS = ['audit', 'org', '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'];
+const KNOWN_COMMANDS = ['audit', 'org', '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', 'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise', 'harmony-watch', 'harmony-governance', 'synergy-report', 'help', 'version'];
 
 function levenshtein(a, b) {
   const matrix = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
@@ -312,6 +312,9 @@ const HELP = `
 
   CROSS-PLATFORM
     nerviq harmony-audit          Drift detection across all active platforms
+    nerviq harmony-sync           Preview cross-platform sync (dry run)
+    nerviq harmony-sync --fix     Apply cross-platform sync (write files)
+    nerviq harmony-sync --json    JSON output for CI/automation
     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
@@ -408,6 +411,7 @@ async function main() {
     lite: flags.includes('--lite'),
     snapshot: flags.includes('--snapshot'),
     feedback: flags.includes('--feedback'),
+    fix: flags.includes('--fix'),
     dryRun: flags.includes('--dry-run'),
     threshold: parsed.threshold !== null ? Number(parsed.threshold) : null,
     out: parsed.out,
@@ -862,6 +866,106 @@ async function main() {
       process.on('SIGINT', closeServer);
       process.on('SIGTERM', closeServer);
       return;
+    } else if (normalizedCommand === 'harmony-audit') {
+      const { runHarmonyAudit } = require('../src/harmony/cli');
+      await runHarmonyAudit(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-sync') {
+      const { previewHarmonySync, applyHarmonySync } = require('../src/harmony/sync');
+      const dir = options.dir || process.cwd();
+
+      if (options.fix) {
+        // Apply mode: write files
+        const result = applyHarmonySync(dir);
+        if (options.json) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          console.log('');
+          console.log('\x1b[1m  Harmony Sync — Apply\x1b[0m');
+          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+          console.log('');
+          if (result.applied.length === 0 && result.skipped.length === 0) {
+            console.log('  \x1b[32mAll platforms are already in sync. Nothing to apply.\x1b[0m');
+          } else {
+            for (const item of result.applied) {
+              console.log(`  \x1b[32m✓\x1b[0m ${item.action.padEnd(8)} ${item.platform.padEnd(12)} ${item.path}`);
+            }
+            for (const item of result.skipped) {
+              const reason = typeof item === 'string' ? item : (item.reason || item.path);
+              console.log(`  \x1b[33m⚠\x1b[0m skipped  ${reason}`);
+            }
+            console.log('');
+            if (result.summary) {
+              console.log(`  Files: ${result.summary.totalFiles} (${result.summary.creates} created, ${result.summary.patches} patched)`);
+              console.log(`  Platforms: ${result.summary.platforms.join(', ')}`);
+            }
+          }
+          if (result.warnings && result.warnings.length > 0) {
+            console.log('');
+            for (const w of result.warnings) {
+              console.log(`  \x1b[33m⚠\x1b[0m ${w}`);
+            }
+          }
+          console.log('');
+        }
+      } else {
+        // Preview mode (dry run)
+        const plan = previewHarmonySync(dir);
+        if (options.json) {
+          console.log(JSON.stringify(plan, null, 2));
+        } else {
+          console.log('');
+          console.log('\x1b[1m  Harmony Sync — Preview\x1b[0m');
+          console.log('\x1b[2m  ═══════════════════════════════════════\x1b[0m');
+          console.log('');
+          if (plan.files.length === 0) {
+            console.log('  \x1b[32mAll platforms are already in sync. No changes needed.\x1b[0m');
+          } else {
+            for (const file of plan.files) {
+              const actionColor = file.action === 'create' ? '\x1b[32m' : '\x1b[36m';
+              console.log(`  ${actionColor}${file.action.padEnd(8)}\x1b[0m ${file.platform.padEnd(12)} ${file.path}`);
+              if (file.preview) {
+                console.log(`           \x1b[2m${file.preview}\x1b[0m`);
+              }
+            }
+            console.log('');
+            console.log(`  Total: ${plan.summary.totalFiles} file(s) — ${plan.summary.creates} create, ${plan.summary.patches} patch`);
+            console.log(`  Platforms: ${plan.summary.platforms.join(', ')}`);
+            if (plan.summary.recommendedTrust) {
+              console.log(`  Recommended trust: ${plan.summary.recommendedTrust}`);
+            }
+            console.log('');
+            console.log('  Run \x1b[1mnerviq harmony-sync --fix\x1b[0m to apply these changes.');
+          }
+          if (plan.warnings && plan.warnings.length > 0) {
+            console.log('');
+            for (const w of plan.warnings) {
+              console.log(`  \x1b[33m⚠\x1b[0m ${w}`);
+            }
+          }
+          console.log('');
+        }
+      }
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-drift') {
+      const { runHarmonyDrift } = require('../src/harmony/cli');
+      await runHarmonyDrift(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-advise') {
+      const { runHarmonyAdvise } = require('../src/harmony/cli');
+      await runHarmonyAdvise(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'harmony-watch') {
+      const { runHarmonyWatch } = require('../src/harmony/cli');
+      await runHarmonyWatch(options);
+    } else if (normalizedCommand === 'harmony-governance') {
+      const { runHarmonyGovernance } = require('../src/harmony/cli');
+      await runHarmonyGovernance(options);
+      process.exit(0);
+    } else if (normalizedCommand === 'synergy-report') {
+      // Placeholder — synergy report is referenced but may not be implemented yet
+      console.log('\n  Synergy report: coming soon.\n');
+      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 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nerviq/cli",
-  "version": "1.2.3",
+  "version": "1.2.6",
   "description": "The intelligent nervous system for AI coding agents — 2,306 checks across 8 platforms and 10 languages. Audit, align, and amplify.",
   "main": "src/index.js",
   "bin": {
@@ -18,7 +18,7 @@
     "test": "node test/run.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/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",
+    "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",
     "benchmark:perf": "node tools/benchmark.js",
     "catalog": "node -e \"const {generateCatalog}=require('./src/catalog');console.log(JSON.stringify(generateCatalog(),null,2))\""
   },

package/src/activity.js

@@ -2,6 +2,10 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const { version } = require('../package.json');
+const {
+  resolveProjectStateReadPath,
+  ensureProjectStateDir,
+} = require('./state-paths');
 
 /**
  * Generate a machine-level user identity for audit tracking.
@@ -33,15 +37,11 @@ function timestampId() {
 }
 
 function ensureArtifactDirs(dir) {
-  const root = path.join(dir, '.claude', 'claudex-setup');
-  const activityDir = path.join(root, 'activity');
-  const rollbackDir = path.join(root, 'rollbacks');
-  const snapshotDir = path.join(root, 'snapshots');
-  const outcomesDir = path.join(root, 'outcomes');
-  fs.mkdirSync(activityDir, { recursive: true });
-  fs.mkdirSync(rollbackDir, { recursive: true });
-  fs.mkdirSync(snapshotDir, { recursive: true });
-  fs.mkdirSync(outcomesDir, { recursive: true });
+  const root = ensureProjectStateDir(dir);
+  const activityDir = ensureProjectStateDir(dir, 'activity');
+  const rollbackDir = ensureProjectStateDir(dir, 'rollbacks');
+  const snapshotDir = ensureProjectStateDir(dir, 'snapshots');
+  const outcomesDir = ensureProjectStateDir(dir, 'outcomes');
   return { root, activityDir, rollbackDir, snapshotDir, outcomesDir };
 }
 
@@ -161,7 +161,7 @@ function updateSnapshotIndex(snapshotDir, record) {
 }
 
 /**
- * Write a normalized snapshot artifact to .claude/claudex-setup/snapshots/ and update the index.
+ * Write a normalized snapshot artifact to .nerviq/snapshots/ and update the index.
  * @param {string} dir - Project root directory.
  * @param {string} snapshotKind - Snapshot type ('audit', 'benchmark', 'governance', 'augment', 'suggest-only').
  * @param {Object} payload - Full result payload to persist.
@@ -208,7 +208,7 @@ function writeSnapshotArtifact(dir, snapshotKind, payload, meta = {}) {
 }
 
 function readSnapshotIndex(dir) {
-  const indexPath = path.join(dir, '.claude', 'claudex-setup', 'snapshots', 'index.json');
+  const indexPath = resolveProjectStateReadPath(dir, 'snapshots', 'index.json');
   if (!fs.existsSync(indexPath)) return [];
   try {
     const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
@@ -228,7 +228,11 @@ function getHistory(dir, limit = 20) {
   const entries = readSnapshotIndex(dir);
   return entries
     .filter(e => e.snapshotKind === 'audit')
-    .sort((a, b) => new Date(b.createdAt) - new Date(a.createdAt))
+    .sort((a, b) => {
+      const dateDiff = new Date(b.createdAt) - new Date(a.createdAt);
+      if (dateDiff !== 0) return dateDiff;
+      return (b.id || '').localeCompare(a.id || '');
+    })
     .slice(0, limit);
 }
 
@@ -344,7 +348,7 @@ function exportTrendReport(dir) {
 }
 
 function readOutcomeIndex(dir) {
-  const indexPath = path.join(dir, '.claude', 'claudex-setup', 'outcomes', 'index.json');
+  const indexPath = resolveProjectStateReadPath(dir, 'outcomes', 'index.json');
   if (!fs.existsSync(indexPath)) return [];
   try {
     const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));

package/src/aider/activity.js

@@ -4,7 +4,7 @@
  * Adapts the shared activity/snapshot backend for Aider platform.
  * Provides: history, compare, trend, watch, feedback, insights.
  *
- * Aider snapshots stored in .claude/claudex-setup/snapshots/ filtered by platform='aider'.
+ * Aider snapshots stored in .nerviq/snapshots/ (legacy: .claude/claudex-setup/snapshots/) filtered by platform='aider'.
  */
 
 const path = require('path');

package/src/audit.js

@@ -1279,7 +1279,25 @@ async function audit(options) {
     console.log('');
   }
 
-  console.log(colorize(`  Backed by CLAUDEX research and evidence for ${spec.platformLabel}`, 'dim'));
+  // Cross-platform synergy hint
+  try {
+    const { detectActivePlatforms } = require('./harmony/canon');
+    const { analyzeCompensation } = require('./synergy/compensation');
+    const { calculateSynergyScore } = require('./synergy/ranking');
+    const detected = detectActivePlatforms(options.dir);
+    const activePlatforms = (detected || []).filter(p => p.detected).map(p => p.platform);
+    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(`     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'));
+      console.log('');
+    }
+  } catch { /* synergy display is optional */ }
+
+  console.log(colorize(`  Backed by NERVIQ research and evidence for ${spec.platformLabel}`, 'dim'));
   console.log(colorize('  https://github.com/nerviq/nerviq', 'dim'));
   console.log('');
 

package/src/claudex-sync.json

@@ -1,7 +1,7 @@
 {
   "synced_from": "claudex",
-  "synced_at": "2026-04-02T15:12:04Z",
-  "total_items": 1107,
+  "synced_at": "2026-04-05T17:08:58Z",
+  "total_items": 1118,
   "tested": 948,
-  "last_id": 1157
+  "last_id": 1137
 }

package/src/codex/activity.js

@@ -5,7 +5,7 @@
  * Provides: history, compare, trend, watch, feedback, insights.
  *
  * Codex snapshots are stored alongside Claude snapshots in
- * .claude/claudex-setup/snapshots/ but filtered by platform='codex'.
+ * .nerviq/snapshots/ (legacy: .claude/claudex-setup/snapshots/) but filtered by platform='codex'.
  */
 
 const path = require('path');

package/src/codex/patch.js

@@ -166,7 +166,7 @@ function applyPatch(dir, filePath, patchFn, options = {}) {
   }
 
   // Backup + write
-  const backupPath = fullPath + '.claudex-backup';
+  const backupPath = fullPath + '.nerviq-backup';
   fs.writeFileSync(backupPath, original, 'utf8');
   fs.writeFileSync(fullPath, patched, 'utf8');
 

package/src/codex/techniques.js

@@ -1,8 +1,9 @@
 const os = require('os');
-const path = require('path');
-const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
-const { attachSourceUrls } = require('../source-urls');
-const { buildSupplementalChecks } = require('../supplemental-checks');
+const path = require('path');
+const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
+const { attachSourceUrls } = require('../source-urls');
+const { buildSupplementalChecks } = require('../supplemental-checks');
+const { resolveProjectStateReadPath } = require('../state-paths');
 
 const CODEX_SUPPLEMENTAL_SOURCE_URLS = {
   'testing-strategy': 'https://developers.openai.com/codex/cli',
@@ -3097,16 +3098,15 @@ const CODEX_TECHNIQUES = {
   // CP-08: New checks (O. Repeat-Usage Hygiene)
   // =============================================
 
-  codexSnapshotRetention: {
-    id: 'CX-O01',
-    name: 'At least one prior audit snapshot exists for repeat-usage',
-    check: (ctx) => {
-      const snapshotDir = path.join(ctx.dir, '.claude', 'claudex-setup', 'snapshots');
-      try {
-        const indexPath = path.join(snapshotDir, 'index.json');
-        const fs = require('fs');
-        if (!fs.existsSync(indexPath)) return null; // No snapshots yet, not a failure
-        const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+  codexSnapshotRetention: {
+    id: 'CX-O01',
+    name: 'At least one prior audit snapshot exists for repeat-usage',
+    check: (ctx) => {
+      try {
+        const indexPath = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json');
+        const fs = require('fs');
+        if (!fs.existsSync(indexPath)) return null; // No snapshots yet, not a failure
+        const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
         return Array.isArray(entries) && entries.length > 0;
       } catch {
         return null;
@@ -3121,16 +3121,15 @@ const CODEX_TECHNIQUES = {
     line: () => null,
   },
 
-  codexFeedbackLoopHealth: {
-    id: 'CX-O02',
-    name: 'Feedback loop is functional when feedback has been submitted',
-    check: (ctx) => {
-      const outcomesDir = path.join(ctx.dir, '.claude', 'claudex-setup', 'outcomes');
-      try {
-        const indexPath = path.join(outcomesDir, 'index.json');
-        const fs = require('fs');
-        if (!fs.existsSync(indexPath)) return null; // No feedback yet, not a failure
-        const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+  codexFeedbackLoopHealth: {
+    id: 'CX-O02',
+    name: 'Feedback loop is functional when feedback has been submitted',
+    check: (ctx) => {
+      try {
+        const indexPath = resolveProjectStateReadPath(ctx.dir, 'outcomes', 'index.json');
+        const fs = require('fs');
+        if (!fs.existsSync(indexPath)) return null; // No feedback yet, not a failure
+        const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
         return Array.isArray(entries) && entries.length > 0;
       } catch {
         return null;
@@ -3145,16 +3144,15 @@ const CODEX_TECHNIQUES = {
     line: () => null,
   },
 
-  codexTrendDataAvailability: {
-    id: 'CX-O03',
-    name: 'Trend data is computable (2+ snapshots with compatible schemas)',
-    check: (ctx) => {
-      const snapshotDir = path.join(ctx.dir, '.claude', 'claudex-setup', 'snapshots');
-      try {
-        const indexPath = path.join(snapshotDir, 'index.json');
-        const fs = require('fs');
-        if (!fs.existsSync(indexPath)) return null;
-        const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+  codexTrendDataAvailability: {
+    id: 'CX-O03',
+    name: 'Trend data is computable (2+ snapshots with compatible schemas)',
+    check: (ctx) => {
+      try {
+        const indexPath = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json');
+        const fs = require('fs');
+        if (!fs.existsSync(indexPath)) return null;
+        const entries = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
         const audits = (Array.isArray(entries) ? entries : []).filter(e => e.snapshotKind === 'audit');
         return audits.length >= 2;
       } catch {

package/src/copilot/patch.js

@@ -196,7 +196,7 @@ function applyPatch(dir, filePath, patchFn, options = {}) {
     return { success: true, reason: 'dry run', preview, unchanged: false };
   }
 
-  const backupPath = fullPath + '.claudex-backup';
+  const backupPath = fullPath + '.nerviq-backup';
   fs.writeFileSync(backupPath, original, 'utf8');
   fs.writeFileSync(fullPath, patched, 'utf8');
 

package/src/copilot/premium.js

@@ -10,6 +10,7 @@
 const path = require('path');
 const { COPILOT_DOMAIN_PACKS } = require('./domain-packs');
 const { COPILOT_MCP_PACKS } = require('./mcp-packs');
+const { resolveProjectStateReadPath } = require('../state-paths');
 
 // ---------------------------------------------------------------------------
 // 1. Multi-Pack Composition Engine
@@ -388,7 +389,7 @@ const GATE_THRESHOLDS = {
 
 function getCopilotHistory(dir, limit = 20) {
   const fs = require('fs');
-  const snapshotDir = path.join(dir, '.claude', 'claudex-setup', 'snapshots');
+  const snapshotDir = resolveProjectStateReadPath(dir, 'snapshots');
   try {
     const files = fs.readdirSync(snapshotDir)
       .filter(f => f.endsWith('.json'))

package/src/cursor/patch.js

@@ -201,7 +201,7 @@ function applyPatch(dir, filePath, patchFn, options = {}) {
     return { success: true, reason: 'dry run', preview, unchanged: false };
   }
 
-  const backupPath = fullPath + '.claudex-backup';
+  const backupPath = fullPath + '.nerviq-backup';
   fs.writeFileSync(backupPath, original, 'utf8');
   fs.writeFileSync(fullPath, patched, 'utf8');
 

package/src/cursor/premium.js

@@ -10,6 +10,7 @@
 const path = require('path');
 const { CURSOR_DOMAIN_PACKS } = require('./domain-packs');
 const { CURSOR_MCP_PACKS } = require('./mcp-packs');
+const { resolveProjectStateReadPath } = require('../state-paths');
 
 // ---------------------------------------------------------------------------
 // 1. Multi-Pack Composition Engine (with MDC awareness)
@@ -406,7 +407,7 @@ const GATE_THRESHOLDS = {
 
 function getCursorHistory(dir, limit = 20) {
   const fs = require('fs');
-  const snapshotDir = path.join(dir, '.claude', 'claudex-setup', 'snapshots');
+  const snapshotDir = resolveProjectStateReadPath(dir, 'snapshots');
   try {
     const files = fs.readdirSync(snapshotDir)
       .filter(f => f.endsWith('.json'))

package/src/feedback.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
+const { ensureProjectStateDir, resolveProjectStateReadPath } = require('./state-paths');
 
 let lastTimestamp = '';
 let counter = 0;
@@ -17,9 +18,11 @@ function timestampId() {
 }
 
 function ensureFeedbackDir(dir) {
-  const feedbackDir = path.join(dir, '.claude', 'claudex-setup', 'feedback');
-  fs.mkdirSync(feedbackDir, { recursive: true });
-  return feedbackDir;
+  return ensureProjectStateDir(dir, 'feedback');
+}
+
+function resolveFeedbackDir(dir) {
+  return resolveProjectStateReadPath(dir, 'feedback');
 }
 
 function writeJson(filePath, payload) {
@@ -47,8 +50,10 @@ function saveFeedback(dir, payload) {
 }
 
 function getFeedbackSummary(dir) {
-  const feedbackDir = ensureFeedbackDir(dir);
-  const files = fs.readdirSync(feedbackDir).filter((name) => name.endsWith('.json'));
+  const feedbackDir = resolveFeedbackDir(dir);
+  const files = fs.existsSync(feedbackDir)
+    ? fs.readdirSync(feedbackDir).filter((name) => name.endsWith('.json'))
+    : [];
   const entries = [];
 
   for (const file of files) {
@@ -107,7 +112,7 @@ async function collectFeedback(dir, options = {}) {
       helpful: 0,
       unhelpful: 0,
       entries: [],
-      relativeDir: path.relative(dir, ensureFeedbackDir(dir)),
+      relativeDir: path.relative(dir, resolveFeedbackDir(dir)),
     };
   }
 
@@ -119,7 +124,7 @@ async function collectFeedback(dir, options = {}) {
       helpful: 0,
       unhelpful: 0,
       entries: [],
-      relativeDir: path.relative(dir, ensureFeedbackDir(dir)),
+      relativeDir: path.relative(dir, resolveFeedbackDir(dir)),
     };
   }
 
@@ -161,7 +166,7 @@ async function collectFeedback(dir, options = {}) {
     helpful,
     unhelpful,
     entries,
-    relativeDir: path.relative(dir, ensureFeedbackDir(dir)),
+    relativeDir: path.relative(dir, resolveFeedbackDir(dir)),
     summary: getFeedbackSummary(dir),
   };
 }

package/src/gemini/activity.js

@@ -5,7 +5,7 @@
  * Provides: history, compare, trend, feedback, insights.
  *
  * Gemini snapshots are stored alongside Claude snapshots in
- * .claude/claudex-setup/snapshots/ but filtered by platform='gemini'.
+ * .nerviq/snapshots/ (legacy: .claude/claudex-setup/snapshots/) but filtered by platform='gemini'.
  */
 
 const path = require('path');

package/src/gemini/patch.js

@@ -187,7 +187,7 @@ function applyPatch(dir, filePath, patchFn, options = {}) {
   }
 
   // Backup + write
-  const backupPath = fullPath + '.claudex-backup';
+  const backupPath = fullPath + '.nerviq-backup';
   fs.writeFileSync(backupPath, original, 'utf8');
   fs.writeFileSync(fullPath, patched, 'utf8');
 

package/src/gemini/premium.js

@@ -10,6 +10,7 @@
 const path = require('path');
 const { GEMINI_DOMAIN_PACKS } = require('./domain-packs');
 const { GEMINI_MCP_PACKS } = require('./mcp-packs');
+const { resolveGeminiStateReadPath } = require('../state-paths');
 
 // ---------------------------------------------------------------------------
 // 1. Multi-Pack Composition Engine
@@ -666,14 +667,14 @@ const GATE_THRESHOLDS = {
 };
 
 /**
- * Read Gemini audit snapshot history from the local .gemini/.claudex/ directory.
+ * Read Gemini audit snapshot history from the local .gemini/.nerviq/ directory.
  * @param {string} dir - Project directory
  * @param {number} limit - Max snapshots to read
  * @returns {object[]} Array of snapshot objects
  */
 function getGeminiHistory(dir, limit = 20) {
   const fs = require('fs');
-  const snapshotDir = path.join(dir, '.gemini', '.claudex', 'snapshots');
+  const snapshotDir = resolveGeminiStateReadPath(dir, 'snapshots');
   try {
     const files = fs.readdirSync(snapshotDir)
       .filter(f => f.endsWith('.json'))

package/src/gemini/techniques.js

@@ -14,10 +14,11 @@
 const os = require('os');
 const path = require('path');
 const { GeminiProjectContext } = require('./context');
-const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
-const { attachSourceUrls } = require('../source-urls');
-const { buildSupplementalChecks } = require('../supplemental-checks');
-const { buildStackChecks } = require('../stack-checks');
+const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
+const { attachSourceUrls } = require('../source-urls');
+const { buildSupplementalChecks } = require('../supplemental-checks');
+const { buildStackChecks } = require('../stack-checks');
+const { resolveProjectStateReadPath } = require('../state-paths');
 
 const GEMINI_SUPPLEMENTAL_SOURCE_URLS = {
   'testing-strategy': 'https://geminicli.com/docs/get-started/',
@@ -2062,23 +2063,23 @@ const GEMINI_TECHNIQUES = {
   },
 
   // CP-08: O. Repeat-Usage Hygiene (3 checks)
-  geminiSnapshotRetention: {
-    id: 'GM-O01', name: 'At least one prior audit snapshot exists',
-    check: (ctx) => { try { const fs = require('fs'); const p = require('path').join(ctx.dir, '.claude', 'claudex-setup', 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
+  geminiSnapshotRetention: {
+    id: 'GM-O01', name: 'At least one prior audit snapshot exists',
+    check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
     impact: 'medium', rating: 3, category: 'repeat-usage',
     fix: 'Run `npx nerviq --platform gemini --snapshot` to save your first snapshot.',
     template: null, file: () => null, line: () => null,
   },
-  geminiFeedbackLoopHealth: {
-    id: 'GM-O02', name: 'Feedback loop functional when feedback submitted',
-    check: (ctx) => { try { const fs = require('fs'); const p = require('path').join(ctx.dir, '.claude', 'claudex-setup', 'outcomes', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
+  geminiFeedbackLoopHealth: {
+    id: 'GM-O02', name: 'Feedback loop functional when feedback submitted',
+    check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'outcomes', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return Array.isArray(e) && e.length > 0; } catch { return null; } },
     impact: 'medium', rating: 3, category: 'repeat-usage',
     fix: 'Submit feedback using `npx nerviq --platform gemini feedback`.',
     template: null, file: () => null, line: () => null,
   },
-  geminiTrendDataAvailability: {
-    id: 'GM-O03', name: 'Trend data computable (2+ snapshots)',
-    check: (ctx) => { try { const fs = require('fs'); const p = require('path').join(ctx.dir, '.claude', 'claudex-setup', 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return (Array.isArray(e) ? e : []).filter(x => x.snapshotKind === 'audit').length >= 2; } catch { return null; } },
+  geminiTrendDataAvailability: {
+    id: 'GM-O03', name: 'Trend data computable (2+ snapshots)',
+    check: (ctx) => { try { const fs = require('fs'); const p = resolveProjectStateReadPath(ctx.dir, 'snapshots', 'index.json'); if (!fs.existsSync(p)) return null; const e = JSON.parse(fs.readFileSync(p, 'utf8')); return (Array.isArray(e) ? e : []).filter(x => x.snapshotKind === 'audit').length >= 2; } catch { return null; } },
     impact: 'low', rating: 2, category: 'repeat-usage',
     fix: 'Run at least 2 audits with --snapshot for trend tracking.',
     template: null, file: () => null, line: () => null,