@nerviq/cli 1.2.6 → 1.3.0

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', 'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise', 'harmony-watch', 'harmony-governance', 'synergy-report', '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', 'harmony-add', 'synergy-report', 'help', 'version'];
 
 function levenshtein(a, b) {
   const matrix = Array.from({ length: a.length + 1 }, () => Array(b.length + 1).fill(0));
@@ -315,6 +315,7 @@ const HELP = `
     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 harmony-add <platform>  Add a new platform to the project
     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
@@ -412,6 +413,7 @@ async function main() {
     snapshot: flags.includes('--snapshot'),
     feedback: flags.includes('--feedback'),
     fix: flags.includes('--fix'),
+    autoSync: flags.includes('--auto-sync'),
     dryRun: flags.includes('--dry-run'),
     threshold: parsed.threshold !== null ? Number(parsed.threshold) : null,
     out: parsed.out,
@@ -505,7 +507,7 @@ async function main() {
       'history', 'compare', 'trend', 'feedback', 'catalog', 'certify', 'serve', 'help', 'version',
       // Harmony + Synergy (cross-platform)
       'harmony-audit', 'harmony-sync', 'harmony-drift', 'harmony-advise',
-      'harmony-watch', 'harmony-governance', 'synergy-report',
+      'harmony-watch', 'harmony-governance', 'harmony-add', 'synergy-report',
     ]);
 
     if (options.platform === 'codex') {
@@ -962,6 +964,29 @@ async function main() {
       const { runHarmonyGovernance } = require('../src/harmony/cli');
       await runHarmonyGovernance(options);
       process.exit(0);
+    } else if (normalizedCommand === 'harmony-add') {
+      const { addPlatform } = require('../src/harmony/add');
+      const platformArg = parsed.extraArgs[0];
+      if (!platformArg) {
+        console.log('\n  Usage: nerviq harmony-add <platform>');
+        console.log('  Available: claude, codex, gemini, copilot, cursor, windsurf, aider, opencode\n');
+        process.exit(1);
+      }
+      const dir = options.dir || process.cwd();
+      const result = addPlatform(dir, platformArg.toLowerCase());
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else if (result.success) {
+        console.log(`\n  \x1b[32m\u2713\x1b[0m Added ${result.platform} to project`);
+        result.created.forEach(f => console.log(`     Created: ${f}`));
+        console.log(`     Platforms: ${result.beforeCount} \u2192 ${result.afterCount}`);
+        if (result.syncApplied > 0) console.log(`     Harmony sync: ${result.syncApplied} file(s) updated`);
+        console.log('');
+      } else {
+        console.log(`\n  \x1b[31m\u2717\x1b[0m ${result.error}\n`);
+        process.exit(1);
+      }
+      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');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nerviq/cli",
-  "version": "1.2.6",
+  "version": "1.3.0",
   "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": {

package/src/harmony/add.js

@@ -0,0 +1,68 @@
+/**
+ * Platform Addition Wizard
+ * Helps users add a new platform config to their project.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { detectActivePlatforms, PLATFORM_SIGNATURES } = require('./canon');
+const { applyHarmonySync } = require('./sync');
+
+const PLATFORM_BOOTSTRAPS = {
+  claude: { files: [{ path: 'CLAUDE.md', content: '# Project Instructions\n\nAdd your Claude Code instructions here.\n' }] },
+  codex: { files: [{ path: 'AGENTS.md', content: '# Agents Instructions\n\nAdd your Codex instructions here.\n' }] },
+  gemini: { files: [{ path: 'GEMINI.md', content: '# Gemini Instructions\n\nAdd your Gemini CLI instructions here.\n' }] },
+  copilot: { files: [{ path: '.github/copilot-instructions.md', content: '# Copilot Instructions\n\nAdd your GitHub Copilot instructions here.\n' }] },
+  cursor: { files: [{ path: '.cursorrules', content: '# Cursor Rules\n\nAdd your Cursor rules here.\n' }] },
+  windsurf: { files: [{ path: '.windsurfrules', content: '# Windsurf Rules\n\nAdd your Windsurf rules here.\n' }] },
+  aider: { files: [{ path: '.aider.conf.yml', content: '# Aider Configuration\n# See: https://aider.chat/docs/config/aider_conf.html\n' }] },
+  opencode: { files: [{ path: 'opencode.json', content: '{\n  "instructions": "Add your OpenCode instructions here."\n}\n' }] },
+};
+
+function addPlatform(dir, platformKey) {
+  // Validate platform
+  if (!PLATFORM_SIGNATURES[platformKey]) {
+    return { success: false, error: `Unknown platform: ${platformKey}. Available: ${Object.keys(PLATFORM_SIGNATURES).join(', ')}` };
+  }
+
+  // Check if already active
+  const active = detectActivePlatforms(dir);
+  const alreadyActive = active.find(p => p.platform === platformKey);
+  if (alreadyActive) {
+    return { success: false, error: `${platformKey} is already active in this project.` };
+  }
+
+  const beforeCount = active.length;
+  const bootstrap = PLATFORM_BOOTSTRAPS[platformKey];
+  const created = [];
+
+  // Create bootstrap files
+  for (const file of bootstrap.files) {
+    const fullPath = path.join(dir, file.path);
+    if (fs.existsSync(fullPath)) continue;
+    const dirName = path.dirname(fullPath);
+    fs.mkdirSync(dirName, { recursive: true });
+    fs.writeFileSync(fullPath, file.content, 'utf8');
+    created.push(file.path);
+  }
+
+  // Run harmony sync to populate managed blocks
+  let syncResult = null;
+  try {
+    syncResult = applyHarmonySync(dir);
+  } catch { /* sync is optional */ }
+
+  const afterActive = detectActivePlatforms(dir);
+  const afterCount = afterActive.length;
+
+  return {
+    success: true,
+    platform: platformKey,
+    created,
+    beforeCount,
+    afterCount,
+    syncApplied: syncResult ? syncResult.applied.length : 0,
+  };
+}
+
+module.exports = { addPlatform, PLATFORM_BOOTSTRAPS };

package/src/harmony/cli.js

@@ -300,6 +300,7 @@ async function runHarmonyWatch(options) {
 
   await startHarmonyWatch({
     dir,
+    autoSync: !!options.autoSync,
     debounceMs: options.debounce || 800,
     onDriftDetected: (platform, details) => {
       console.log(c(`  DRIFT ALERT: ${platform} score dropped by ${Math.abs(details.delta)}`, 'red'));

package/src/harmony/watch.js

@@ -36,6 +36,13 @@ const PLATFORM_WATCH_FILES = [
   '.github/copilot-review-instructions.md',
   // Cursor
   '.cursorrules',
+  // Windsurf
+  '.windsurfrules',
+  // Aider
+  '.aider.conf.yml',
+  '.aiderignore',
+  // OpenCode
+  'opencode.json',
   // Shared
   '.gitignore',
   'package.json',
@@ -53,6 +60,9 @@ const PLATFORM_WATCH_DIRS = [
   '.github',
   '.cursor',
   '.cursor/rules',
+  '.windsurf',
+  '.windsurf/rules',
+  '.opencode',
 ];
 
 // ─── fs.watch helpers (mirror pattern from src/watch.js) ──────────────────────
@@ -174,6 +184,9 @@ function identifyPlatform(filePath) {
   if (normalized.includes('.gemini') || normalized.includes('gemini.md')) return 'gemini';
   if (normalized.includes('copilot') || normalized.includes('.github')) return 'copilot';
   if (normalized.includes('.cursor') || normalized.includes('cursorrules')) return 'cursor';
+  if (normalized.includes('.windsurf') || normalized.includes('windsurfrules')) return 'windsurf';
+  if (normalized.includes('.aider') || normalized.includes('aiderignore')) return 'aider';
+  if (normalized.includes('.opencode') || normalized.includes('opencode.json')) return 'opencode';
   return 'unknown';
 }
 
@@ -187,6 +200,7 @@ function identifyPlatform(filePath) {
  * @param {Function} [options.onDriftDetected] - Callback when drift increases: (platform, details) => void
  * @param {Function} [options.onPlatformChange] - Callback on any platform config change: (platform, file) => void
  * @param {Function} [options.runAudit] - Optional audit function to re-run on changes
+ * @param {boolean} [options.autoSync=false] - Auto-apply harmony sync when drift is detected
  * @param {number} [options.debounceMs=800] - Debounce interval in ms
  */
 async function startHarmonyWatch(options) {
@@ -195,6 +209,7 @@ async function startHarmonyWatch(options) {
     onDriftDetected,
     onPlatformChange,
     runAudit,
+    autoSync = false,
     debounceMs = 800,
   } = options;
 
@@ -204,7 +219,10 @@ async function startHarmonyWatch(options) {
   console.log(c('  nerviq harmony watch', 'bold'));
   console.log(c('  ═══════════════════════════════════════', 'dim'));
   console.log(c(`  Watching: ${dir}`, 'dim'));
-  console.log(c(`  Platforms: Claude, Codex, Gemini, Copilot, Cursor`, 'dim'));
+  console.log(c(`  Platforms: Claude, Codex, Gemini, Copilot, Cursor, Windsurf, Aider, OpenCode`, 'dim'));
+  if (autoSync) {
+    console.log(c(`  Auto-sync: ON — drift will be auto-corrected`, 'green'));
+  }
   console.log(c(`  Mode: ${recursiveSupported ? 'native recursive' : 'expanded directory fallback'}`, 'dim'));
   console.log(c('  Press Ctrl+C to stop', 'dim'));
   console.log('');
@@ -293,6 +311,22 @@ async function startHarmonyWatch(options) {
                 }
               }
 
+              // Auto-sync on drift
+              if (delta < 0 && autoSync) {
+                try {
+                  const { applyHarmonySync } = require('./sync');
+                  const syncResult = applyHarmonySync(dir);
+                  if (syncResult.applied.length > 0) {
+                    console.log(c(`    Auto-sync: applied ${syncResult.applied.length} fix(es)`, 'green'));
+                    for (const item of syncResult.applied) {
+                      console.log(c(`      ✓ ${item.action} ${item.path}`, 'dim'));
+                    }
+                  }
+                } catch (_e) {
+                  console.log(c(`    Auto-sync failed: ${_e.message}`, 'yellow'));
+                }
+              }
+
               lastScores[p] = newScore;
             }
           }