@nerviq/cli 1.20.1 → 1.21.0

package/src/platform-change-manifest.js

@@ -1,86 +1,86 @@
-'use strict';
-
-const claudeFreshness = require('./freshness');
-const codexFreshness = require('./codex/freshness');
-const cursorFreshness = require('./cursor/freshness');
-const copilotFreshness = require('./copilot/freshness');
-const geminiFreshness = require('./gemini/freshness');
-const windsurfFreshness = require('./windsurf/freshness');
-const aiderFreshness = require('./aider/freshness');
-const opencodeFreshness = require('./opencode/freshness');
-
-const DAILY_FRESHNESS_WORKFLOW = {
-  workflow: '.github/workflows/freshness-check.yml',
-  cadence: 'Daily at 06:00 UTC plus manual dispatch',
-  issuePolicy: 'Open or refresh GitHub issues for stale P0 sources without failing the main CI pipeline.',
-};
-
-const PLATFORM_CHANGE_MANIFEST = [
-  { key: 'claude', label: 'Claude Code', modulePath: 'src/freshness.js', freshness: claudeFreshness },
-  { key: 'codex', label: 'Codex', modulePath: 'src/codex/freshness.js', freshness: codexFreshness },
-  { key: 'cursor', label: 'Cursor', modulePath: 'src/cursor/freshness.js', freshness: cursorFreshness },
-  { key: 'copilot', label: 'Copilot', modulePath: 'src/copilot/freshness.js', freshness: copilotFreshness },
-  { key: 'gemini', label: 'Gemini CLI', modulePath: 'src/gemini/freshness.js', freshness: geminiFreshness },
-  { key: 'windsurf', label: 'Windsurf', modulePath: 'src/windsurf/freshness.js', freshness: windsurfFreshness },
-  { key: 'aider', label: 'Aider', modulePath: 'src/aider/freshness.js', freshness: aiderFreshness },
-  { key: 'opencode', label: 'OpenCode', modulePath: 'src/opencode/freshness.js', freshness: opencodeFreshness },
-].map((entry) => {
-  const sources = (entry.freshness.P0_SOURCES || []).map((source) => ({
-    key: source.key,
-    label: source.label,
-    url: source.url,
-    stalenessThresholdDays: source.stalenessThresholdDays,
-    verifiedAt: source.verifiedAt || null,
-  }));
-  const thresholds = [...new Set(sources.map((source) => source.stalenessThresholdDays))].sort((a, b) => a - b);
-
-  return {
-    key: entry.key,
-    label: entry.label,
-    modulePath: entry.modulePath,
-    trackedSources: sources,
-    trackedSourceCount: sources.length,
-    reviewCadence: {
-      automation: DAILY_FRESHNESS_WORKFLOW.cadence,
-      thresholdsDays: thresholds,
-      manualExpectation: thresholds.includes(14)
-        ? 'Review high-volatility sources weekly and verify any stale source immediately.'
-        : 'Review sources at least monthly and verify any stale source immediately.',
-    },
-    freshnessWorkflow: {
-      ...DAILY_FRESHNESS_WORKFLOW,
-      manualTrigger: true,
-    },
-    updateTriggers: (entry.freshness.PROPAGATION_CHECKLIST || []).map((item) => ({
-      trigger: item.trigger,
-      targets: item.targets || [],
-    })),
-  };
-});
-
-function getPlatformChangeManifest() {
-  return JSON.parse(JSON.stringify(PLATFORM_CHANGE_MANIFEST));
-}
-
-function summarizePlatformChangeManifest() {
-  const manifest = getPlatformChangeManifest();
-  return {
-    platformCount: manifest.length,
-    trackedSourceCount: manifest.reduce((sum, entry) => sum + entry.trackedSourceCount, 0),
-    workflow: DAILY_FRESHNESS_WORKFLOW,
-    platforms: manifest.map((entry) => ({
-      key: entry.key,
-      label: entry.label,
-      trackedSourceCount: entry.trackedSourceCount,
-      thresholdDays: entry.reviewCadence.thresholdsDays,
-      updateTriggerCount: entry.updateTriggers.length,
-    })),
-  };
-}
-
-module.exports = {
-  DAILY_FRESHNESS_WORKFLOW,
-  PLATFORM_CHANGE_MANIFEST,
-  getPlatformChangeManifest,
-  summarizePlatformChangeManifest,
-};
+'use strict';
+
+const claudeFreshness = require('./freshness');
+const codexFreshness = require('./codex/freshness');
+const cursorFreshness = require('./cursor/freshness');
+const copilotFreshness = require('./copilot/freshness');
+const geminiFreshness = require('./gemini/freshness');
+const windsurfFreshness = require('./windsurf/freshness');
+const aiderFreshness = require('./aider/freshness');
+const opencodeFreshness = require('./opencode/freshness');
+
+const DAILY_FRESHNESS_WORKFLOW = {
+  workflow: '.github/workflows/freshness-check.yml',
+  cadence: 'Daily at 06:00 UTC plus manual dispatch',
+  issuePolicy: 'Open or refresh GitHub issues for stale P0 sources without failing the main CI pipeline.',
+};
+
+const PLATFORM_CHANGE_MANIFEST = [
+  { key: 'claude', label: 'Claude Code', modulePath: 'src/freshness.js', freshness: claudeFreshness },
+  { key: 'codex', label: 'Codex', modulePath: 'src/codex/freshness.js', freshness: codexFreshness },
+  { key: 'cursor', label: 'Cursor', modulePath: 'src/cursor/freshness.js', freshness: cursorFreshness },
+  { key: 'copilot', label: 'Copilot', modulePath: 'src/copilot/freshness.js', freshness: copilotFreshness },
+  { key: 'gemini', label: 'Gemini CLI', modulePath: 'src/gemini/freshness.js', freshness: geminiFreshness },
+  { key: 'windsurf', label: 'Windsurf', modulePath: 'src/windsurf/freshness.js', freshness: windsurfFreshness },
+  { key: 'aider', label: 'Aider', modulePath: 'src/aider/freshness.js', freshness: aiderFreshness },
+  { key: 'opencode', label: 'OpenCode', modulePath: 'src/opencode/freshness.js', freshness: opencodeFreshness },
+].map((entry) => {
+  const sources = (entry.freshness.P0_SOURCES || []).map((source) => ({
+    key: source.key,
+    label: source.label,
+    url: source.url,
+    stalenessThresholdDays: source.stalenessThresholdDays,
+    verifiedAt: source.verifiedAt || null,
+  }));
+  const thresholds = [...new Set(sources.map((source) => source.stalenessThresholdDays))].sort((a, b) => a - b);
+
+  return {
+    key: entry.key,
+    label: entry.label,
+    modulePath: entry.modulePath,
+    trackedSources: sources,
+    trackedSourceCount: sources.length,
+    reviewCadence: {
+      automation: DAILY_FRESHNESS_WORKFLOW.cadence,
+      thresholdsDays: thresholds,
+      manualExpectation: thresholds.includes(14)
+        ? 'Review high-volatility sources weekly and verify any stale source immediately.'
+        : 'Review sources at least monthly and verify any stale source immediately.',
+    },
+    freshnessWorkflow: {
+      ...DAILY_FRESHNESS_WORKFLOW,
+      manualTrigger: true,
+    },
+    updateTriggers: (entry.freshness.PROPAGATION_CHECKLIST || []).map((item) => ({
+      trigger: item.trigger,
+      targets: item.targets || [],
+    })),
+  };
+});
+
+function getPlatformChangeManifest() {
+  return JSON.parse(JSON.stringify(PLATFORM_CHANGE_MANIFEST));
+}
+
+function summarizePlatformChangeManifest() {
+  const manifest = getPlatformChangeManifest();
+  return {
+    platformCount: manifest.length,
+    trackedSourceCount: manifest.reduce((sum, entry) => sum + entry.trackedSourceCount, 0),
+    workflow: DAILY_FRESHNESS_WORKFLOW,
+    platforms: manifest.map((entry) => ({
+      key: entry.key,
+      label: entry.label,
+      trackedSourceCount: entry.trackedSourceCount,
+      thresholdDays: entry.reviewCadence.thresholdsDays,
+      updateTriggerCount: entry.updateTriggers.length,
+    })),
+  };
+}
+
+module.exports = {
+  DAILY_FRESHNESS_WORKFLOW,
+  PLATFORM_CHANGE_MANIFEST,
+  getPlatformChangeManifest,
+  summarizePlatformChangeManifest,
+};

package/src/plugins.js

@@ -1,110 +1,110 @@
-/**
- * Plugin system for Nerviq.
- * Allows users to extend audits with custom checks via nerviq.config.js.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const REQUIRED_CHECK_FIELDS = ['id', 'name', 'check', 'impact', 'category', 'fix'];
-const VALID_IMPACTS = ['critical', 'high', 'medium', 'low'];
-
-/**
- * Validate a single plugin object.
- * Returns { valid: true } or { valid: false, errors: [...] }.
- */
-function validatePlugin(plugin) {
-  const errors = [];
-
-  if (!plugin || typeof plugin !== 'object') {
-    return { valid: false, errors: ['Plugin must be a non-null object'] };
-  }
-
-  if (!plugin.name || typeof plugin.name !== 'string') {
-    errors.push('Plugin must have a non-empty string "name" field');
-  }
-
-  if (!plugin.checks || typeof plugin.checks !== 'object' || Array.isArray(plugin.checks)) {
-    errors.push('Plugin must have a "checks" object');
-    return { valid: false, errors };
-  }
-
-  for (const [key, check] of Object.entries(plugin.checks)) {
-    for (const field of REQUIRED_CHECK_FIELDS) {
-      if (check[field] === undefined || check[field] === null) {
-        errors.push(`Check "${key}" is missing required field "${field}"`);
-      }
-    }
-
-    if (typeof check.check !== 'function') {
-      errors.push(`Check "${key}" field "check" must be a function`);
-    }
-
-    if (check.impact && !VALID_IMPACTS.includes(check.impact)) {
-      errors.push(`Check "${key}" has invalid impact "${check.impact}". Must be one of: ${VALID_IMPACTS.join(', ')}`);
-    }
-  }
-
-  return errors.length > 0 ? { valid: false, errors } : { valid: true };
-}
-
-/**
- * Load plugins from nerviq.config.js in the given directory.
- * Returns an array of plugin objects, or [] if no config file exists.
- */
-function loadPlugins(dir) {
-  const configPath = path.join(dir, 'nerviq.config.js');
-
-  if (!fs.existsSync(configPath)) {
-    return [];
-  }
-
-  let config;
-  try {
-    config = require(configPath);
-  } catch (err) {
-    console.error(`Failed to load nerviq.config.js: ${err.message}`);
-    return [];
-  }
-
-  if (!config || !Array.isArray(config.plugins)) {
-    return [];
-  }
-
-  const validPlugins = [];
-  for (const plugin of config.plugins) {
-    const result = validatePlugin(plugin);
-    if (result.valid) {
-      validPlugins.push(plugin);
-    } else {
-      console.error(`Plugin "${plugin && plugin.name || 'unknown'}" is invalid: ${result.errors.join('; ')}`);
-    }
-  }
-
-  return validPlugins;
-}
-
-/**
- * Merge plugin checks into the existing techniques object.
- * Plugin checks are prefixed with "plugin:" to avoid key collisions.
- * Returns a new merged techniques object (does not mutate the original).
- */
-function mergePluginChecks(techniques, plugins) {
-  const merged = { ...techniques };
-
-  for (const plugin of plugins) {
-    for (const [key, check] of Object.entries(plugin.checks)) {
-      const prefixedKey = `plugin:${plugin.name}:${key}`;
-      merged[prefixedKey] = {
-        ...check,
-        pluginName: plugin.name,
-        sourceUrl: check.sourceUrl || null,
-        confidence: check.confidence !== undefined ? check.confidence : 0.5,
-      };
-    }
-  }
-
-  return merged;
-}
-
-module.exports = { loadPlugins, mergePluginChecks, validatePlugin };
+/**
+ * Plugin system for Nerviq.
+ * Allows users to extend audits with custom checks via nerviq.config.js.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const REQUIRED_CHECK_FIELDS = ['id', 'name', 'check', 'impact', 'category', 'fix'];
+const VALID_IMPACTS = ['critical', 'high', 'medium', 'low'];
+
+/**
+ * Validate a single plugin object.
+ * Returns { valid: true } or { valid: false, errors: [...] }.
+ */
+function validatePlugin(plugin) {
+  const errors = [];
+
+  if (!plugin || typeof plugin !== 'object') {
+    return { valid: false, errors: ['Plugin must be a non-null object'] };
+  }
+
+  if (!plugin.name || typeof plugin.name !== 'string') {
+    errors.push('Plugin must have a non-empty string "name" field');
+  }
+
+  if (!plugin.checks || typeof plugin.checks !== 'object' || Array.isArray(plugin.checks)) {
+    errors.push('Plugin must have a "checks" object');
+    return { valid: false, errors };
+  }
+
+  for (const [key, check] of Object.entries(plugin.checks)) {
+    for (const field of REQUIRED_CHECK_FIELDS) {
+      if (check[field] === undefined || check[field] === null) {
+        errors.push(`Check "${key}" is missing required field "${field}"`);
+      }
+    }
+
+    if (typeof check.check !== 'function') {
+      errors.push(`Check "${key}" field "check" must be a function`);
+    }
+
+    if (check.impact && !VALID_IMPACTS.includes(check.impact)) {
+      errors.push(`Check "${key}" has invalid impact "${check.impact}". Must be one of: ${VALID_IMPACTS.join(', ')}`);
+    }
+  }
+
+  return errors.length > 0 ? { valid: false, errors } : { valid: true };
+}
+
+/**
+ * Load plugins from nerviq.config.js in the given directory.
+ * Returns an array of plugin objects, or [] if no config file exists.
+ */
+function loadPlugins(dir) {
+  const configPath = path.join(dir, 'nerviq.config.js');
+
+  if (!fs.existsSync(configPath)) {
+    return [];
+  }
+
+  let config;
+  try {
+    config = require(configPath);
+  } catch (err) {
+    console.error(`Failed to load nerviq.config.js: ${err.message}`);
+    return [];
+  }
+
+  if (!config || !Array.isArray(config.plugins)) {
+    return [];
+  }
+
+  const validPlugins = [];
+  for (const plugin of config.plugins) {
+    const result = validatePlugin(plugin);
+    if (result.valid) {
+      validPlugins.push(plugin);
+    } else {
+      console.error(`Plugin "${plugin && plugin.name || 'unknown'}" is invalid: ${result.errors.join('; ')}`);
+    }
+  }
+
+  return validPlugins;
+}
+
+/**
+ * Merge plugin checks into the existing techniques object.
+ * Plugin checks are prefixed with "plugin:" to avoid key collisions.
+ * Returns a new merged techniques object (does not mutate the original).
+ */
+function mergePluginChecks(techniques, plugins) {
+  const merged = { ...techniques };
+
+  for (const plugin of plugins) {
+    for (const [key, check] of Object.entries(plugin.checks)) {
+      const prefixedKey = `plugin:${plugin.name}:${key}`;
+      merged[prefixedKey] = {
+        ...check,
+        pluginName: plugin.name,
+        sourceUrl: check.sourceUrl || null,
+        confidence: check.confidence !== undefined ? check.confidence : 0.5,
+      };
+    }
+  }
+
+  return merged;
+}
+
+module.exports = { loadPlugins, mergePluginChecks, validatePlugin };