@nerviq/cli 1.12.0 → 1.13.0

package/src/mcp-server.js

@@ -29,7 +29,78 @@
 
 'use strict';
 
-const { version } = require('../package.json');
+const { version } = require('../package.json');
+
+function buildMcpAuditPayload(result, options = {}) {
+  const verbose = Boolean(options.verbose);
+  const normalizedCheckCount = typeof result.checkCount === 'number'
+    ? result.checkCount
+    : typeof result.total === 'number'
+      ? result.total
+      : 0;
+
+  const payload = {
+    platform: result.platform,
+    score: result.score,
+    passed: result.passed,
+    failed: result.failed,
+    total: normalizedCheckCount,
+    checkCount: normalizedCheckCount,
+    scoreType: result.scoreType || 'live-audit-score',
+    grade: result.score >= 80 ? 'A' : result.score >= 60 ? 'B' : result.score >= 40 ? 'C' : 'D',
+    criticalFailures: (result.results || [])
+      .filter(r => r.passed === false && r.impact === 'critical')
+      .map(r => ({ key: r.key, id: r.id, name: r.name, fix: r.fix })),
+    highFailures: (result.results || [])
+      .filter(r => r.passed === false && r.impact === 'high')
+      .map(r => ({ key: r.key, id: r.id, name: r.name, fix: r.fix })),
+    topNextActions: (result.topNextActions || []).slice(0, 3).map((item) => ({
+      key: item.key,
+      name: item.name,
+      impact: item.impact,
+      fix: item.fix,
+    })),
+    suggestedNextCommand: result.suggestedNextCommand || null,
+  };
+
+  if (verbose) {
+    payload.results = (result.results || []).map(r => ({
+      key: r.key,
+      id: r.id,
+      name: r.name,
+      passed: r.passed,
+      impact: r.impact,
+      fix: r.passed === false ? r.fix : undefined,
+    }));
+  }
+
+  return payload;
+}
+
+function buildMcpHarmonyPayload(result, options = {}) {
+  const verbose = Boolean(options.verbose);
+  const payload = {
+    harmonyScore: result.harmonyScore,
+    activePlatforms: result.activePlatforms || [],
+    platformScores: result.platformScores || {},
+    driftCount: result.driftCount || (result.drifts || []).length || 0,
+    criticalDrifts: (result.drifts || [])
+      .filter(d => d.severity === 'critical')
+      .map(d => ({ type: d.type, description: d.description, recommendation: d.recommendation })),
+    recommendations: (result.recommendations || []).slice(0, 5),
+  };
+
+  if (verbose) {
+    payload.allDrifts = (result.drifts || []).map(d => ({
+      type: d.type,
+      severity: d.severity,
+      description: d.description,
+      recommendation: d.recommendation,
+    }));
+  }
+
+  return payload;
+}
 
 // ─── Tool definitions ────────────────────────────────────────────────────────
 
@@ -132,74 +203,26 @@ const TOOLS = [
 
 // ─── Tool handlers ───────────────────────────────────────────────────────────
 
-async function handleAudit(input) {
+async function handleAudit(input) {
   const { audit } = require('./audit');
   const dir = input.dir || process.cwd();
   const platform = input.platform || 'claude';
   const verbose = Boolean(input.verbose);
 
-  const result = await audit({ dir, platform, silent: true, verbose });
-
-  // Return clean JSON without ANSI codes
-  const clean = {
-    platform: result.platform,
-    score: result.score,
-    passed: result.passed,
-    failed: result.failed,
-    total: result.total,
-    grade: result.score >= 80 ? 'A' : result.score >= 60 ? 'B' : result.score >= 40 ? 'C' : 'D',
-    criticalFailures: (result.results || [])
-      .filter(r => r.passed === false && r.impact === 'critical')
-      .map(r => ({ key: r.key, id: r.id, name: r.name, fix: r.fix })),
-    highFailures: (result.results || [])
-      .filter(r => r.passed === false && r.impact === 'high')
-      .map(r => ({ key: r.key, id: r.id, name: r.name, fix: r.fix })),
-    suggestedNextCommand: result.suggestedNextCommand || null,
-  };
-
-  if (verbose) {
-    clean.allResults = (result.results || []).map(r => ({
-      key: r.key,
-      id: r.id,
-      name: r.name,
-      passed: r.passed,
-      impact: r.impact,
-      fix: r.passed === false ? r.fix : undefined,
-    }));
-  }
-
-  return { content: [{ type: 'text', text: JSON.stringify(clean, null, 2) }] };
-}
+  const result = await audit({ dir, platform, silent: true, verbose });
+  const clean = buildMcpAuditPayload(result, { verbose });
+  return { content: [{ type: 'text', text: JSON.stringify(clean, null, 2) }] };
+}
 
 async function handleHarmony(input) {
   const { harmonyAudit } = require('./harmony/audit');
   const dir = input.dir || process.cwd();
   const verbose = Boolean(input.verbose);
 
-  const result = await harmonyAudit({ dir, silent: true });
-
-  const clean = {
-    harmonyScore: result.harmonyScore,
-    activePlatforms: result.activePlatforms || [],
-    platformScores: result.platformScores || {},
-    driftCount: result.driftCount || 0,
-    criticalDrifts: (result.drifts || [])
-      .filter(d => d.severity === 'critical')
-      .map(d => ({ type: d.type, description: d.description, recommendation: d.recommendation })),
-    recommendations: (result.recommendations || []).slice(0, 5),
-  };
-
-  if (verbose) {
-    clean.allDrifts = (result.drifts || []).map(d => ({
-      type: d.type,
-      severity: d.severity,
-      description: d.description,
-      recommendation: d.recommendation,
-    }));
-  }
-
-  return { content: [{ type: 'text', text: JSON.stringify(clean, null, 2) }] };
-}
+  const result = await harmonyAudit({ dir, silent: true });
+  const clean = buildMcpHarmonyPayload(result, { verbose });
+  return { content: [{ type: 'text', text: JSON.stringify(clean, null, 2) }] };
+}
 
 async function handleSetup(input) {
   const { setup } = require('./setup');
@@ -370,4 +393,17 @@ function main() {
   });
 }
 
-main();
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  TOOLS,
+  buildMcpAuditPayload,
+  buildMcpHarmonyPayload,
+  handleAudit,
+  handleHarmony,
+  handleSetup,
+  handleDrift,
+  main,
+};

package/src/opencode/freshness.js

@@ -29,18 +29,39 @@ const P0_SOURCES = [
     stalenessThresholdDays: 14,
     verifiedAt: '2026-04-07',
   },
-  {
-    key: 'opencode-plugin-api',
-    label: 'OpenCode Plugin API',
-    url: 'https://opencode.ai/docs/plugins/',
-    stalenessThresholdDays: 30,
-    verifiedAt: '2026-04-07',
-  },
-  {
-    key: 'opencode-permissions-docs',
-    label: 'OpenCode Permissions Documentation',
-    url: 'https://opencode.ai/docs/permissions/',
-    stalenessThresholdDays: 30,
+  {
+    key: 'opencode-plugin-api',
+    label: 'OpenCode Plugin API',
+    url: 'https://opencode.ai/docs/plugins/',
+    stalenessThresholdDays: 30,
+    verifiedAt: '2026-04-07',
+  },
+  {
+    key: 'opencode-agents-docs',
+    label: 'OpenCode Agents',
+    url: 'https://opencode.ai/docs/agents/',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'opencode-models-docs',
+    label: 'OpenCode Models',
+    url: 'https://opencode.ai/docs/models',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'opencode-github-docs',
+    label: 'OpenCode GitHub Integration',
+    url: 'https://opencode.ai/docs/github/',
+    stalenessThresholdDays: 14,
+    verifiedAt: '2026-04-10',
+  },
+  {
+    key: 'opencode-permissions-docs',
+    label: 'OpenCode Permissions Documentation',
+    url: 'https://opencode.ai/docs/permissions/',
+    stalenessThresholdDays: 30,
     verifiedAt: '2026-04-07',
   },
 ];
@@ -78,15 +99,39 @@ const PROPAGATION_CHECKLIST = [
       'src/opencode/techniques.js — update MCP checks',
     ],
   },
-  {
-    trigger: 'Known security bug fixed or new bug reported',
-    targets: [
-      'src/opencode/techniques.js — update security checks (E02, E03, D05)',
-      'src/opencode/governance.js — update platformCaveats',
-      'src/opencode/freshness.js — verify against latest release',
-    ],
-  },
-];
+  {
+    trigger: 'Known security bug fixed or new bug reported',
+    targets: [
+      'src/opencode/techniques.js — update security checks (E02, E03, D05)',
+      'src/opencode/governance.js — update platformCaveats',
+      'src/opencode/freshness.js — verify against latest release',
+    ],
+  },
+  {
+    trigger: 'OpenCode agent or subagent behavior change',
+    targets: [
+      'src/opencode/techniques.js — update agent and multi-session checks',
+      'src/opencode/governance.js — update permission guidance for plan/build/agent surfaces',
+      'src/source-urls.js — refresh OpenCode agent source mappings',
+    ],
+  },
+  {
+    trigger: 'OpenCode model catalog or provider-option change',
+    targets: [
+      'src/opencode/techniques.js — update model-awareness and provider-option assumptions',
+      'src/opencode/setup.js — update starter config guidance for model selection',
+      'src/source-urls.js — refresh OpenCode model source mappings',
+    ],
+  },
+  {
+    trigger: 'OpenCode GitHub integration or workflow contract change',
+    targets: [
+      'src/opencode/techniques.js — update GitHub/workflow checks',
+      'src/opencode/setup.js — update GitHub starter guidance',
+      'src/source-urls.js — refresh OpenCode GitHub source mappings',
+    ],
+  },
+];
 
 function checkReleaseGate(sourceVerifications = {}) {
   const now = new Date();