@nerviq/cli 1.2.3 → 1.2.6

package/src/shared/capabilities.js

@@ -0,0 +1,194 @@
+/**
+ * Canonical Platform Capability Matrix
+ *
+ * Single source of truth for platform strengths/weaknesses.
+ * Used by: harmony/advisor.js, synergy/routing.js, synergy/compensation.js
+ *
+ * Scale: 1 (weak) to 5 (best-in-class)
+ * All keys use camelCase for consistency.
+ */
+
+const PLATFORM_CAPABILITIES = {
+  claude: {
+    label: 'Claude Code',
+    reasoning: 5,
+    refactoring: 5,
+    debugging: 5,
+    review: 5,
+    architecture: 5,
+    ci: 2,
+    ide: 2,
+    ui: 1,
+    async: 3,
+    inline: 3,
+    context: 4,
+    automation: 4,
+    sandbox: 3,
+    cloudTasks: 3,
+    cloudAgent: 2,
+    background: 3,
+    governance: 4,
+  },
+  codex: {
+    label: 'Codex',
+    reasoning: 4,
+    refactoring: 4,
+    debugging: 3,
+    review: 4,
+    architecture: 3,
+    ci: 5,
+    ide: 3,
+    ui: 2,
+    async: 5,
+    inline: 2,
+    context: 3,
+    automation: 4,
+    sandbox: 4,
+    cloudTasks: 5,
+    cloudAgent: 4,
+    background: 4,
+    governance: 3,
+  },
+  gemini: {
+    label: 'Gemini CLI',
+    reasoning: 4,
+    refactoring: 3,
+    debugging: 3,
+    review: 3,
+    architecture: 3,
+    ci: 3,
+    ide: 3,
+    ui: 2,
+    async: 4,
+    inline: 2,
+    context: 5,
+    automation: 3,
+    sandbox: 5,
+    cloudTasks: 4,
+    cloudAgent: 3,
+    background: 3,
+    governance: 2,
+  },
+  copilot: {
+    label: 'GitHub Copilot',
+    reasoning: 3,
+    refactoring: 3,
+    debugging: 3,
+    review: 3,
+    architecture: 2,
+    ci: 4,
+    ide: 4,
+    ui: 3,
+    async: 3,
+    inline: 5,
+    context: 3,
+    automation: 3,
+    sandbox: 2,
+    cloudTasks: 4,
+    cloudAgent: 4,
+    background: 3,
+    governance: 3,
+  },
+  cursor: {
+    label: 'Cursor',
+    reasoning: 3,
+    refactoring: 4,
+    debugging: 4,
+    review: 3,
+    architecture: 3,
+    ci: 2,
+    ide: 5,
+    ui: 5,
+    async: 2,
+    inline: 4,
+    context: 3,
+    automation: 4,
+    sandbox: 2,
+    cloudTasks: 2,
+    cloudAgent: 2,
+    background: 4,
+    governance: 2,
+  },
+  windsurf: {
+    label: 'Windsurf',
+    reasoning: 4,
+    refactoring: 4,
+    debugging: 4,
+    review: 3,
+    architecture: 3,
+    ci: 2,
+    ide: 5,
+    ui: 4,
+    async: 3,
+    inline: 4,
+    context: 3,
+    automation: 4,
+    sandbox: 2,
+    cloudTasks: 2,
+    cloudAgent: 2,
+    background: 2,
+    governance: 3,
+  },
+  aider: {
+    label: 'Aider',
+    reasoning: 4,
+    refactoring: 5,
+    debugging: 4,
+    review: 3,
+    architecture: 3,
+    ci: 4,
+    ide: 1,
+    ui: 1,
+    async: 2,
+    inline: 1,
+    context: 2,
+    automation: 2,
+    sandbox: 1,
+    cloudTasks: 1,
+    cloudAgent: 1,
+    background: 1,
+    governance: 2,
+  },
+  opencode: {
+    label: 'OpenCode',
+    reasoning: 4,
+    refactoring: 4,
+    debugging: 4,
+    review: 4,
+    architecture: 4,
+    ci: 4,
+    ide: 3,
+    ui: 2,
+    async: 4,
+    inline: 2,
+    context: 4,
+    automation: 4,
+    sandbox: 4,
+    cloudTasks: 3,
+    cloudAgent: 3,
+    background: 3,
+    governance: 4,
+  },
+};
+
+const CAPABILITY_LABELS = {
+  reasoning: 'Complex reasoning & analysis',
+  refactoring: 'Code refactoring',
+  debugging: 'Bug diagnosis & debugging',
+  review: 'Code review',
+  architecture: 'Architecture design',
+  ci: 'CI/CD pipeline integration',
+  ide: 'IDE integration',
+  ui: 'UI/frontend work',
+  async: 'Async/background tasks',
+  inline: 'Inline code completion',
+  context: 'Large context handling',
+  automation: 'Workflow automation',
+  sandbox: 'Sandboxed execution',
+  cloudTasks: 'Cloud-based tasks',
+  cloudAgent: 'Cloud agent mode',
+  background: 'Background processing',
+  governance: 'Governance & permissions',
+};
+
+module.exports = { PLATFORM_CAPABILITIES, CAPABILITY_LABELS };

package/src/state-paths.js

@@ -0,0 +1,85 @@
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_STATE_ROOT = ['.nerviq'];
+const LEGACY_PROJECT_STATE_ROOT = ['.claude', 'claudex-setup'];
+const HARMONY_STATE_ROOT = ['.nerviq', 'harmony'];
+const LEGACY_HARMONY_STATE_ROOT = ['.claudex', 'harmony'];
+const GEMINI_STATE_ROOT = ['.gemini', '.nerviq'];
+const LEGACY_GEMINI_STATE_ROOT = ['.gemini', '.claudex'];
+
+function buildPath(dir, rootSegments, segments) {
+  return path.join(dir, ...rootSegments, ...segments);
+}
+
+function resolveReadablePath(dir, preferredRoot, legacyRoot, ...segments) {
+  const preferredPath = buildPath(dir, preferredRoot, segments);
+  if (fs.existsSync(preferredPath)) return preferredPath;
+
+  const legacyPath = buildPath(dir, legacyRoot, segments);
+  if (fs.existsSync(legacyPath)) return legacyPath;
+
+  return preferredPath;
+}
+
+function ensureWritableDir(dir, rootSegments, ...segments) {
+  const targetPath = buildPath(dir, rootSegments, segments);
+  fs.mkdirSync(targetPath, { recursive: true });
+  return targetPath;
+}
+
+function resolveProjectStatePath(dir, ...segments) {
+  return buildPath(dir, PROJECT_STATE_ROOT, segments);
+}
+
+function resolveProjectStateReadPath(dir, ...segments) {
+  return resolveReadablePath(dir, PROJECT_STATE_ROOT, LEGACY_PROJECT_STATE_ROOT, ...segments);
+}
+
+function ensureProjectStateDir(dir, ...segments) {
+  return ensureWritableDir(dir, PROJECT_STATE_ROOT, ...segments);
+}
+
+function resolveHarmonyStatePath(dir, ...segments) {
+  return buildPath(dir, HARMONY_STATE_ROOT, segments);
+}
+
+function resolveHarmonyStateReadPath(dir, ...segments) {
+  return resolveReadablePath(dir, HARMONY_STATE_ROOT, LEGACY_HARMONY_STATE_ROOT, ...segments);
+}
+
+function ensureHarmonyStateDir(dir, ...segments) {
+  return ensureWritableDir(dir, HARMONY_STATE_ROOT, ...segments);
+}
+
+function resolveGeminiStatePath(dir, ...segments) {
+  return buildPath(dir, GEMINI_STATE_ROOT, segments);
+}
+
+function resolveGeminiStateReadPath(dir, ...segments) {
+  return resolveReadablePath(dir, GEMINI_STATE_ROOT, LEGACY_GEMINI_STATE_ROOT, ...segments);
+}
+
+function ensureGeminiStateDir(dir, ...segments) {
+  return ensureWritableDir(dir, GEMINI_STATE_ROOT, ...segments);
+}
+
+module.exports = {
+  PROJECT_STATE_ROOT,
+  LEGACY_PROJECT_STATE_ROOT,
+  HARMONY_STATE_ROOT,
+  LEGACY_HARMONY_STATE_ROOT,
+  GEMINI_STATE_ROOT,
+  LEGACY_GEMINI_STATE_ROOT,
+  resolveReadablePath,
+  ensureWritableDir,
+  resolveProjectStatePath,
+  resolveProjectStateReadPath,
+  ensureProjectStateDir,
+  resolveHarmonyStatePath,
+  resolveHarmonyStateReadPath,
+  ensureHarmonyStateDir,
+  resolveGeminiStatePath,
+  resolveGeminiStateReadPath,
+  ensureGeminiStateDir,
+};

package/src/synergy/compensation.js

@@ -5,26 +5,7 @@
  * platform additions to fill coverage gaps.
  */
 
-const { PLATFORM_CAPABILITIES } = require('./routing');
-
-const AREA_LABELS = {
-  reasoning: 'Complex reasoning & analysis',
-  refactoring: 'Code refactoring',
-  debugging: 'Bug diagnosis & debugging',
-  CI: 'CI/CD pipeline integration',
-  IDE: 'IDE integration',
-  UI: 'UI/frontend work',
-  async: 'Async/background tasks',
-  review: 'Code review',
-  architecture: 'Architecture design',
-  inline: 'Inline code completion',
-  cloudTasks: 'Cloud-based tasks',
-  context: 'Large context handling',
-  sandbox: 'Sandboxed execution',
-  cloudAgent: 'Cloud agent mode',
-  background: 'Background processing',
-  automation: 'Workflow automation',
-};
+const { PLATFORM_CAPABILITIES, CAPABILITY_LABELS: AREA_LABELS } = require('../shared/capabilities');
 
 const WEAKNESS_THRESHOLD = 3;
 const STRENGTH_THRESHOLD = 4;

package/src/synergy/learning.js

@@ -15,6 +15,9 @@ const PLATFORM_SEMANTICS = {
   gemini: { configFile: 'GEMINI.md', format: 'markdown', instructionStyle: 'structured' },
   copilot: { configFile: '.github/copilot-instructions.md', format: 'markdown', instructionStyle: 'concise' },
   cursor: { configFile: '.cursor/rules', format: 'mdc', instructionStyle: 'rule-based' },
+  windsurf: { configFile: '.windsurf/rules', format: 'markdown', instructionStyle: 'rule-based' },
+  aider: { configFile: '.aider.conf.yml', format: 'yaml', instructionStyle: 'convention-based' },
+  opencode: { configFile: 'opencode.json', format: 'jsonc', instructionStyle: 'directive' },
 };
 
 const TRANSLATION_MAP = {
@@ -24,13 +27,19 @@ const TRANSLATION_MAP = {
     gemini: (rec) => `Add to GEMINI.md: verification command \`${rec.command}\``,
     copilot: (rec) => `Document in copilot-instructions.md: always run \`${rec.command}\` before completing`,
     cursor: (rec) => `Add rule: "Always run \`${rec.command}\` before completing tasks"`,
+    windsurf: (rec) => `Add a .windsurf/rules verification rule that runs \`${rec.command}\` before task completion`,
+    aider: (rec) => `Document in CONVENTIONS.md or .aider.conf.yml workflow notes: run \`${rec.command}\` before final response`,
+    opencode: (rec) => `Add to AGENTS.md or opencode.json workflow guidance: run \`${rec.command}\` before completing`,
   },
   'architecture-doc': {
-    claude: (rec) => `Add Mermaid architecture diagram to CLAUDE.md`,
-    codex: (rec) => `Add architecture overview to AGENTS.md`,
-    gemini: (rec) => `Add architecture context to GEMINI.md`,
-    copilot: (rec) => `Add architecture reference in copilot-instructions.md`,
-    cursor: (rec) => `Add architecture context rule in .cursor/rules`,
+    claude: () => `Add Mermaid architecture diagram to CLAUDE.md`,
+    codex: () => `Add architecture overview to AGENTS.md`,
+    gemini: () => `Add architecture context to GEMINI.md`,
+    copilot: () => `Add architecture reference in copilot-instructions.md`,
+    cursor: () => `Add architecture context rule in .cursor/rules`,
+    windsurf: () => `Add architecture guidance to a .windsurf/rules/*.md file or shared workflow`,
+    aider: () => `Add architecture overview to CONVENTIONS.md for Aider sessions`,
+    opencode: () => `Add architecture context to AGENTS.md and reference it from opencode.json`,
   },
   'permission-rule': {
     claude: (rec) => `Configure in settings.json permissions: ${rec.description}`,
@@ -38,6 +47,9 @@ const TRANSLATION_MAP = {
     gemini: (rec) => `Configure Gemini sandbox settings: ${rec.description}`,
     copilot: (rec) => `Note in instructions: ${rec.description}`,
     cursor: (rec) => `Add safety rule: ${rec.description}`,
+    windsurf: (rec) => `Translate into .cascadeignore, MCP whitelist, or rule guidance: ${rec.description}`,
+    aider: (rec) => `Translate into git workflow guardrails or config defaults: ${rec.description}`,
+    opencode: (rec) => `Encode in opencode.json permissions: ${rec.description}`,
   },
   'hook': {
     claude: (rec) => `Add hook in settings.json: ${rec.description}`,
@@ -45,6 +57,9 @@ const TRANSLATION_MAP = {
     gemini: (rec) => `Add automated check: ${rec.description}`,
     copilot: (rec) => `Add workflow step: ${rec.description}`,
     cursor: (rec) => `Add background task rule: ${rec.description}`,
+    windsurf: (rec) => `Implement as a workflow, Steps sequence, or auto rule: ${rec.description}`,
+    aider: (rec) => `Implement via git hooks, auto-test, or documented Aider workflow: ${rec.description}`,
+    opencode: (rec) => `Implement via plugin, workflow, or task automation: ${rec.description}`,
   },
 };
 

package/src/synergy/routing.js

@@ -5,13 +5,7 @@
  * project history, and active platform availability.
  */
 
-const PLATFORM_CAPABILITIES = {
-  claude: { reasoning: 5, refactoring: 5, debugging: 5, CI: 2, IDE: 2, UI: 1, async: 3, review: 5, architecture: 5 },
-  codex: { reasoning: 4, CI: 5, cloudTasks: 5, IDE: 3, async: 5, UI: 2, refactoring: 4, debugging: 3, review: 4 },
-  gemini: { reasoning: 4, context: 5, sandbox: 5, CI: 3, IDE: 3, UI: 2, refactoring: 3, debugging: 3, async: 4 },
-  copilot: { inline: 5, cloudAgent: 4, IDE: 4, CI: 4, reasoning: 3, UI: 3, refactoring: 3, review: 3, debugging: 3 },
-  cursor: { IDE: 5, UI: 5, background: 4, automation: 4, reasoning: 3, refactoring: 4, inline: 4, debugging: 4 },
-};
+const { PLATFORM_CAPABILITIES } = require('../shared/capabilities');
 
 const TASK_TYPE_PATTERNS = [
   { type: 'bugfix', patterns: ['bug', 'fix', 'error', 'crash', 'broken', 'issue', 'regression', 'failing'] },
@@ -27,16 +21,16 @@ const TASK_TYPE_PATTERNS = [
 ];
 
 const TASK_CAPABILITY_MAP = {
-  bugfix: ['debugging', 'reasoning', 'IDE'],
-  refactor: ['refactoring', 'reasoning', 'IDE'],
+  bugfix: ['debugging', 'reasoning', 'ide'],
+  refactor: ['refactoring', 'reasoning', 'ide'],
   review: ['review', 'reasoning', 'context'],
-  UI: ['UI', 'IDE', 'inline'],
-  CI: ['CI', 'cloudTasks', 'async'],
-  infrastructure: ['CI', 'cloudTasks', 'sandbox'],
-  testing: ['debugging', 'CI', 'sandbox'],
+  UI: ['ui', 'ide', 'inline'],
+  CI: ['ci', 'cloudTasks', 'async'],
+  infrastructure: ['ci', 'cloudTasks', 'sandbox'],
+  testing: ['debugging', 'ci', 'sandbox'],
   architecture: ['architecture', 'reasoning', 'context'],
   documentation: ['reasoning', 'context', 'inline'],
-  feature: ['reasoning', 'IDE', 'refactoring'],
+  feature: ['reasoning', 'ide', 'refactoring'],
 };
 
 /**