@nerviq/cli 1.2.3 → 1.2.6

package/src/harmony/advisor.js

@@ -8,69 +8,9 @@
  * Zero external dependencies - imports only from sibling/parent modules.
  */
 
-// ─── Platform Strength Matrix (from CLAUDEX research) ─────────────────────────
-
-const PLATFORM_STRENGTHS = {
-  claude: {
-    label: 'Claude Code',
-    reasoning: 5,
-    refactoring: 5,
-    ci: 2,
-    ide: 2,
-    sandbox: 3,
-    inline: 3,
-    context: 4,
-    automation: 4,
-  },
-  codex: {
-    label: 'Codex',
-    reasoning: 4,
-    ci: 5,
-    cloud: 5,
-    ide: 3,
-    sandbox: 4,
-    refactoring: 4,
-    inline: 2,
-    context: 3,
-    automation: 4,
-  },
-  gemini: {
-    label: 'Gemini CLI',
-    reasoning: 4,
-    context: 5,
-    sandbox: 5,
-    ci: 3,
-    ide: 3,
-    refactoring: 3,
-    inline: 2,
-    cloud: 4,
-    automation: 3,
-  },
-  copilot: {
-    label: 'GitHub Copilot',
-    inline: 5,
-    'cloud-agent': 4,
-    ide: 4,
-    ci: 4,
-    governance: 3,
-    reasoning: 3,
-    refactoring: 3,
-    context: 3,
-    automation: 3,
-  },
-  cursor: {
-    label: 'Cursor',
-    ide: 5,
-    ui: 5,
-    background: 4,
-    automation: 4,
-    reasoning: 3,
-    refactoring: 3,
-    inline: 4,
-    context: 3,
-    ci: 2,
-  },
-};
+// ─── Platform Strength Matrix (canonical source: shared/capabilities.js) ─────
+
+const { PLATFORM_CAPABILITIES: PLATFORM_STRENGTHS } = require('../shared/capabilities');
 
 // ─── Task-type to platform-strength mapping ───────────────────────────────────
 
@@ -82,7 +22,7 @@ const TASK_TYPE_PROFILES = {
   },
   'ci-review': {
     label: 'CI / Async Review',
-    requiredStrengths: { ci: 0.5, cloud: 0.3, automation: 0.2 },
+    requiredStrengths: { ci: 0.4, cloudTasks: 0.3, async: 0.2, automation: 0.1 },
     description: 'Asynchronous code review and CI-integrated workflows.',
   },
   'ui-work': {
@@ -97,7 +37,7 @@ const TASK_TYPE_PROFILES = {
   },
   'infrastructure': {
     label: 'Infrastructure',
-    requiredStrengths: { sandbox: 0.4, cloud: 0.3, reasoning: 0.3 },
+    requiredStrengths: { sandbox: 0.4, cloudTasks: 0.3, reasoning: 0.3 },
     description: 'Infrastructure, DevOps, and sandbox-heavy workflows.',
   },
   'refactoring': {
@@ -115,6 +55,16 @@ const TASK_TYPE_PROFILES = {
     requiredStrengths: { reasoning: 0.3, automation: 0.3, ide: 0.2, refactoring: 0.2 },
     description: 'Starting new projects or major new features from scratch.',
   },
+  'harness-optimization': {
+    label: 'Config Optimization',
+    requiredStrengths: { governance: 0.4, automation: 0.3, reasoning: 0.3 },
+    description: 'Optimizing AI coding agent configuration and harness settings.',
+  },
+  'phased-migration': {
+    label: 'Phased Migration',
+    requiredStrengths: { reasoning: 0.4, refactoring: 0.3, architecture: 0.3 },
+    description: 'Multi-phase migrations requiring sequential execution with validation gates.',
+  },
 };
 
 // ─── Scoring ──────────────────────────────────────────────────────────────────

package/src/harmony/audit.js

@@ -42,6 +42,9 @@ const PLATFORM_AUDIT_MAP = {
   gemini: 'gemini',
   copilot: 'copilot',
   cursor: 'cursor',
+  windsurf: 'windsurf',
+  aider: 'aider',
+  opencode: 'opencode',
 };
 
 // ─── Cross-platform recommendations ────────────────────────────────────────

package/src/harmony/canon.js

@@ -3,7 +3,7 @@
  *
  * Reads ALL platform config files from a single project and builds a unified
  * understanding of instructions, MCP servers, trust posture, and governance
- * across Claude, Codex, Gemini, Copilot, and Cursor.
+ * across Claude, Codex, Gemini, Copilot, Cursor, Windsurf, Aider, and OpenCode.
  */
 
 const fs = require('fs');
@@ -13,10 +13,17 @@ 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 { getCodexGovernanceSummary } = require('../codex/governance');
 const { getGeminiGovernanceSummary } = require('../gemini/governance');
 const { getCopilotGovernanceSummary } = require('../copilot/governance');
 const { getCursorGovernanceSummary } = require('../cursor/governance');
+const { getWindsurfGovernanceSummary } = require('../windsurf/governance');
+const { getAiderGovernanceSummary } = require('../aider/governance');
+const { getOpenCodeGovernanceSummary } = require('../opencode/governance');
+const { tryParseJsonc } = require('../opencode/config-parser');
 
 // ─── Platform detection signatures ──────────────────────────────────────────
 
@@ -96,6 +103,52 @@ const PLATFORM_SIGNATURES = {
     rulesDir: '.cursor/rules',
     hooksDir: null,
   },
+  windsurf: {
+    label: 'Windsurf',
+    detect: (dir) => {
+      try {
+        if (fs.existsSync(path.join(dir, '.windsurfrules'))) return true;
+        if (fs.existsSync(path.join(dir, '.windsurf'))) return true;
+        return false;
+      } catch { return false; }
+    },
+    instructionFiles: ['.windsurfrules'],
+    configFiles: ['.windsurfrules', '.windsurf/mcp.json', '.cascadeignore'],
+    mcpFiles: ['.windsurf/mcp.json'],
+    rulesDir: '.windsurf/rules',
+    hooksDir: '.windsurf/workflows',
+  },
+  aider: {
+    label: 'Aider',
+    detect: (dir) => {
+      try {
+        if (fs.existsSync(path.join(dir, '.aider.conf.yml'))) return true;
+        if (fs.existsSync(path.join(dir, '.aiderignore'))) return true;
+        return false;
+      } catch { return false; }
+    },
+    instructionFiles: ['CONVENTIONS.md', '.aider.conventions.md'],
+    configFiles: ['.aider.conf.yml', '.aider.model.settings.yml', '.aiderignore'],
+    mcpFiles: [],
+    rulesDir: null,
+    hooksDir: null,
+  },
+  opencode: {
+    label: 'OpenCode',
+    detect: (dir) => {
+      try {
+        if (fs.existsSync(path.join(dir, 'opencode.json'))) return true;
+        if (fs.existsSync(path.join(dir, 'opencode.jsonc'))) return true;
+        if (fs.existsSync(path.join(dir, '.opencode'))) return true;
+        return false;
+      } catch { return false; }
+    },
+    instructionFiles: ['AGENTS.md', 'CLAUDE.md'],
+    configFiles: ['opencode.json', 'opencode.jsonc'],
+    mcpFiles: ['opencode.json', 'opencode.jsonc'],
+    rulesDir: null,
+    hooksDir: null,
+  },
 };
 
 // ─── Context builders per platform ──────────────────────────────────────────
@@ -106,6 +159,9 @@ const CONTEXT_BUILDERS = {
   gemini: (dir) => new GeminiProjectContext(dir),
   copilot: (dir) => new CopilotProjectContext(dir),
   cursor: (dir) => new CursorProjectContext(dir),
+  windsurf: (dir) => new WindsurfProjectContext(dir),
+  aider: (dir) => new AiderProjectContext(dir),
+  opencode: (dir) => new OpenCodeProjectContext(dir),
 };
 
 const GOVERNANCE_GETTERS = {
@@ -113,6 +169,9 @@ const GOVERNANCE_GETTERS = {
   gemini: getGeminiGovernanceSummary,
   copilot: getCopilotGovernanceSummary,
   cursor: getCursorGovernanceSummary,
+  windsurf: getWindsurfGovernanceSummary,
+  aider: getAiderGovernanceSummary,
+  opencode: getOpenCodeGovernanceSummary,
 };
 
 // ─── Helpers ────────────────────────────────────────────────────────────────
@@ -133,6 +192,11 @@ function safeParseJson(content) {
   }
 }
 
+function safeParseJsonc(content) {
+  const parsed = tryParseJsonc(content);
+  return parsed.ok ? parsed.data : null;
+}
+
 /**
  * Extract instruction text from a platform's instruction files.
  * Returns array of { file, content } for each found file.
@@ -177,6 +241,17 @@ function extractMcpFromMcpJson(content) {
   }));
 }
 
+function extractMcpFromOpenCodeConfig(content) {
+  const json = safeParseJsonc(content);
+  if (!json) return [];
+  const servers = json.mcpServers || json.servers || {};
+  return Object.keys(servers).map(name => ({
+    name,
+    command: servers[name].command || null,
+    args: servers[name].args || [],
+  }));
+}
+
 /**
  * Extract MCP server names from Gemini settings.json.
  */
@@ -205,6 +280,8 @@ function readMcpServers(dir, platform, mcpFiles) {
       extracted = extractMcpFromClaudeSettings(content);
     } else if (platform === 'gemini') {
       extracted = extractMcpFromGeminiSettings(content);
+    } else if (platform === 'opencode') {
+      extracted = extractMcpFromOpenCodeConfig(content);
     } else {
       extracted = extractMcpFromMcpJson(content);
     }
@@ -268,6 +345,27 @@ function detectTrustPosture(platform, ctx) {
     return 'no-sandbox';
   }
 
+  if (platform === 'windsurf') {
+    if (ctx.fileContent('.cascadeignore')) return 'guarded';
+    if (ctx.fileContent('.windsurf/mcp.json')) return 'team-managed';
+    return 'foreground';
+  }
+
+  if (platform === 'aider') {
+    const config = ctx.configContent ? (ctx.configContent() || '') : '';
+    if (/^\s*(yes|yes-always)\s*:\s*true\b/m.test(config)) return 'full-auto';
+    if (/^\s*auto-commits\s*:\s*true\b/m.test(config)) return 'git-guarded';
+    return 'manual-review';
+  }
+
+  if (platform === 'opencode') {
+    const config = ctx.configContent ? (ctx.configContent() || '') : '';
+    if (/"\*"\s*:\s*"allow"/.test(config)) return 'unrestricted';
+    if (/"(?:bash|edit|task|external_directory)"\s*:\s*"deny"/.test(config)) return 'locked-down';
+    if (/"(?:bash|edit|task|external_directory)"\s*:\s*"ask"/.test(config)) return 'prompted';
+    return 'standard';
+  }
+
   return 'unknown';
 }
 
@@ -415,10 +513,33 @@ function buildCanonicalModel(dir) {
     governanceSummary[key] = platformDetails[key].governance;
   }
 
+  // SD2: Adaptive project signals — infrastructure & tooling detection
+  const projectSignals = {};
+  const signalChecks = [
+    { key: 'docker', label: 'Docker', files: ['Dockerfile', 'docker-compose.yml', 'docker-compose.yaml', '.dockerignore'] },
+    { key: 'terraform', label: 'Terraform', files: ['main.tf', 'terraform.tf', '.terraform.lock.hcl'] },
+    { key: 'kubernetes', label: 'Kubernetes', files: ['k8s/', 'kubernetes/', 'helm/', 'Chart.yaml'] },
+    { key: 'ci-github', label: 'GitHub Actions', files: ['.github/workflows/'] },
+    { key: 'ci-gitlab', label: 'GitLab CI', files: ['.gitlab-ci.yml'] },
+    { key: 'pytest', label: 'pytest', files: ['pytest.ini', 'conftest.py', 'pyproject.toml'] },
+    { key: 'jest', label: 'Jest', files: ['jest.config.js', 'jest.config.ts', 'jest.config.mjs'] },
+    { key: 'migrations', label: 'DB Migrations', files: ['migrations/', 'alembic/', 'prisma/migrations/', 'db/migrate/'] },
+    { key: 'monorepo', label: 'Monorepo', files: ['pnpm-workspace.yaml', 'lerna.json', 'nx.json', 'turbo.json'] },
+    { key: 'openapi', label: 'OpenAPI', files: ['openapi.yaml', 'openapi.json', 'swagger.yaml', 'swagger.json'] },
+  ];
+  for (const signal of signalChecks) {
+    const detected = signal.files.some(f => {
+      const full = path.join(dir, f);
+      try { return fs.existsSync(full); } catch { return false; }
+    });
+    if (detected) projectSignals[signal.key] = signal.label;
+  }
+
   return {
     projectName,
     dir,
     stacks: stacks.map(s => s.key),
+    projectSignals,
     activePlatforms: platformKeys.map(key => ({
       platform: key,
       label: platformDetails[key].label,

package/src/harmony/cli.js

@@ -68,6 +68,27 @@ function collectPlatformAudits(dir) {
     if (result) results.push({ platform: 'cursor', ...result });
   } catch (_e) { /* platform not available */ }
 
+  // Try Windsurf audit
+  try {
+    const { audit } = require('../audit');
+    const result = audit({ dir, silent: true, platform: 'windsurf' });
+    if (result) results.push({ platform: 'windsurf', ...result });
+  } catch (_e) { /* platform not available */ }
+
+  // Try Aider audit
+  try {
+    const { audit } = require('../audit');
+    const result = audit({ dir, silent: true, platform: 'aider' });
+    if (result) results.push({ platform: 'aider', ...result });
+  } catch (_e) { /* platform not available */ }
+
+  // Try OpenCode audit
+  try {
+    const { audit } = require('../audit');
+    const result = audit({ dir, silent: true, platform: 'opencode' });
+    if (result) results.push({ platform: 'opencode', ...result });
+  } catch (_e) { /* platform not available */ }
+
   return results;
 }
 

package/src/harmony/drift.js

@@ -97,7 +97,7 @@ function detectMcpDrift(model) {
   const drifts = [];
   const allPlatforms = model.activePlatforms.map(p => p.platform);
   const mcpCapablePlatforms = allPlatforms.filter(p =>
-    p === 'claude' || p === 'gemini' || p === 'copilot' || p === 'cursor'
+    p === 'claude' || p === 'gemini' || p === 'copilot' || p === 'cursor' || p === 'windsurf' || p === 'opencode'
   );
 
   if (mcpCapablePlatforms.length < 2) return drifts;
@@ -150,7 +150,7 @@ function detectRuleDrift(model) {
 
   // Platforms that support rules: claude (.claude/rules), copilot (.github/instructions), cursor (.cursor/rules)
   const ruleCapable = allPlatforms.filter(p =>
-    p === 'claude' || p === 'copilot' || p === 'cursor'
+    p === 'claude' || p === 'copilot' || p === 'cursor' || p === 'windsurf'
   );
 
   if (ruleCapable.length < 2) return drifts;

package/src/harmony/memory.js

@@ -1,7 +1,7 @@
 /**
  * H7. Shared Memory / Knowledge Layer
  *
- * Cross-platform knowledge storage in .claudex/harmony/ directory.
+ * Cross-platform knowledge storage in .nerviq/harmony/ directory.
  * Persists canonical models, drift history, platform scores,
  * recommendation outcomes, and routing history.
  *
@@ -10,8 +10,12 @@
 
 const fs = require('fs');
 const path = require('path');
+const {
+  resolveHarmonyStateReadPath,
+  ensureHarmonyStateDir,
+} = require('../state-paths');
 
-const HARMONY_DIR = '.claudex/harmony';
+const HARMONY_DIR = '.nerviq/harmony';
 
 const STATE_FILES = {
   canon: 'canon.json',
@@ -24,9 +28,7 @@ const STATE_FILES = {
 // ─── File I/O helpers ─────────────────────────────────────────────────────────
 
 function ensureHarmonyDir(dir) {
-  const harmonyPath = path.join(dir, HARMONY_DIR);
-  fs.mkdirSync(harmonyPath, { recursive: true });
-  return harmonyPath;
+  return ensureHarmonyStateDir(dir);
 }
 
 function readJsonSafe(filePath) {
@@ -78,11 +80,10 @@ function saveHarmonyState(dir, state) {
  * @returns {Object} State object with all available keys populated
  */
 function loadHarmonyState(dir) {
-  const harmonyPath = path.join(dir, HARMONY_DIR);
   const state = {};
 
   for (const [key, filename] of Object.entries(STATE_FILES)) {
-    const filePath = path.join(harmonyPath, filename);
+    const filePath = resolveHarmonyStateReadPath(dir, filename);
     const data = readJsonSafe(filePath);
     if (data !== null) {
       state[key] = data;
@@ -90,7 +91,7 @@ function loadHarmonyState(dir) {
   }
 
   // Load manifest for metadata
-  const manifest = readJsonSafe(path.join(harmonyPath, 'manifest.json'));
+  const manifest = readJsonSafe(resolveHarmonyStateReadPath(dir, 'manifest.json'));
   if (manifest) {
     state._manifest = manifest;
   }

package/src/harmony/sync.js

@@ -3,7 +3,8 @@
  *
  * Generates aligned configs for ALL active platforms from a shared canonical
  * understanding. Ensures instructions, MCP servers, and trust posture are
- * consistent across Claude, Codex, Gemini, Copilot, and Cursor.
+ * consistent across Claude, Codex, Gemini, Copilot, Cursor, Windsurf,
+ * Aider, and OpenCode.
  *
  * Uses managed blocks from each platform's patch module so hand-authored
  * content is always preserved.
@@ -37,6 +38,12 @@ const MANAGED_MARKERS = {
     start: '<!-- nerviq:managed:start -->',
     end: '<!-- nerviq:managed:end -->',
   },
+  windsurf: {
+    start: '<!-- nerviq:managed:start -->',
+    end: '<!-- nerviq:managed:end -->',
+  },
+  // aider: uses .aider.conf.yml (YAML) — managed HTML-comment blocks not supported
+  // opencode: uses opencode.json (JSON) — managed HTML-comment blocks not supported
 };
 
 // ─── Helpers ────────────────────────────────────────────────────────────────
@@ -144,6 +151,9 @@ function getInstructionPath(platform) {
     case 'gemini': return 'GEMINI.md';
     case 'copilot': return '.github/copilot-instructions.md';
     case 'cursor': return '.cursorrules';
+    case 'windsurf': return '.windsurfrules';
+    // aider: .aider.conf.yml is YAML config — no managed block support, skip instruction sync
+    // opencode: opencode.json is JSON config — no managed block support, skip instruction sync
     default: return null;
   }
 }
@@ -178,6 +188,11 @@ function buildMcpConfig(platform, mcpServers) {
     return { mcpServers: servers };
   }
 
+  if (platform === 'windsurf') {
+    // Windsurf mcp.json format
+    return { mcpServers: servers };
+  }
+
   return null;
 }
 
@@ -190,6 +205,8 @@ function getMcpConfigPath(platform) {
     case 'gemini': return '.gemini/settings.json';
     case 'copilot': return '.vscode/mcp.json';
     case 'cursor': return '.cursor/mcp.json';
+    case 'windsurf': return '.windsurf/mcp.json';
+    // aider & opencode: no MCP config support
     default: return null;
   }
 }

package/src/insights.js

@@ -21,7 +21,7 @@
 const https = require('https');
 const os = require('os');
 
-const INSIGHTS_ENDPOINT = 'https://claudex-insights.claudex.workers.dev/v1/report';
+const INSIGHTS_ENDPOINT = 'https://insights.nerviq.net/v1/report';
 const TIMEOUT_MS = 3000;
 
 function shouldCollect() {

package/src/opencode/activity.js

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

package/src/opencode/patch.js

@@ -142,7 +142,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/opencode/techniques.js

@@ -21,11 +21,12 @@
  */
 
 const os = require('os');
-const path = require('path');
-const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
-const { attachSourceUrls } = require('../source-urls');
-const { buildStackChecks } = require('../stack-checks');
-const { isApiProject, isDatabaseProject, isAuthProject, isMonitoringRelevant } = require('../supplemental-checks');
+const path = require('path');
+const { EMBEDDED_SECRET_PATTERNS, containsEmbeddedSecret } = require('../secret-patterns');
+const { attachSourceUrls } = require('../source-urls');
+const { buildStackChecks } = require('../stack-checks');
+const { isApiProject, isDatabaseProject, isAuthProject, isMonitoringRelevant } = require('../supplemental-checks');
+const { resolveProjectStateReadPath } = require('../state-paths');
 
 const DEFAULT_PROJECT_DOC_MAX_BYTES = 32768;
 
@@ -1458,14 +1459,15 @@ const OPENCODE_TECHNIQUES = {
     line: () => null,
   },
 
-  opencodePilotEvidence: {
-    id: 'OC-M03',
-    name: 'OpenCode setup has been audited at least once',
-    check: (ctx) => {
-      // Check for nerviq activity artifacts
-      const hasArtifacts = ctx.hasDir('.claude/claudex-setup');
-      return hasArtifacts ? true : null;
-    },
+  opencodePilotEvidence: {
+    id: 'OC-M03',
+    name: 'OpenCode setup has been audited at least once',
+    check: (ctx) => {
+      // Check for nerviq activity artifacts
+      const fs = require('fs');
+      const hasArtifacts = fs.existsSync(resolveProjectStateReadPath(ctx.dir));
+      return hasArtifacts ? true : null;
+    },
     impact: 'low',
     rating: 2,
     category: 'governance',