@nerviq/cli 1.29.0 → 1.30.0

package/src/i18n.js

@@ -1,63 +1,63 @@
-/**
- * Minimal i18n module for nerviq CLI.
- *
- * Supports locale files in src/locales/<lang>.json.
- * Falls back to English for missing keys.
- */
-
-const path = require('path');
-const fs = require('fs');
-
-const SUPPORTED_LOCALES = ['en', 'es'];
-const DEFAULT_LOCALE = 'en';
-
-let currentLocale = DEFAULT_LOCALE;
-let messages = {};
-let fallbackMessages = {};
-
-function loadLocale(locale) {
-  const file = path.join(__dirname, 'locales', `${locale}.json`);
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return {};
-  }
-}
-
-/**
- * Initialize i18n with a locale string (e.g. 'en', 'es').
- * Call this once at CLI startup.
- */
-function init(locale) {
-  const lang = (locale || process.env.NERVIQ_LANG || DEFAULT_LOCALE).toLowerCase().slice(0, 2);
-  currentLocale = SUPPORTED_LOCALES.includes(lang) ? lang : DEFAULT_LOCALE;
-  fallbackMessages = loadLocale(DEFAULT_LOCALE);
-  messages = currentLocale === DEFAULT_LOCALE ? fallbackMessages : loadLocale(currentLocale);
-}
-
-/**
- * Translate a key with optional interpolation.
- *
- * Usage:
- *   t('audit.score', { score: 85, passed: 20, total: 25 })
- *   // => "Score: 85/100  (20/25 checks passing)"
- */
-function t(key, params = {}) {
-  let msg = messages[key] || fallbackMessages[key] || key;
-  for (const [k, v] of Object.entries(params)) {
-    msg = msg.replace(new RegExp(`\\{${k}\\}`, 'g'), String(v));
-  }
-  return msg;
-}
-
-/**
- * Get current locale.
- */
-function getLocale() {
-  return currentLocale;
-}
-
-// Auto-init with default on first require
-init();
-
-module.exports = { init, t, getLocale, SUPPORTED_LOCALES };
+/**
+ * Minimal i18n module for nerviq CLI.
+ *
+ * Supports locale files in src/locales/<lang>.json.
+ * Falls back to English for missing keys.
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const SUPPORTED_LOCALES = ['en', 'es'];
+const DEFAULT_LOCALE = 'en';
+
+let currentLocale = DEFAULT_LOCALE;
+let messages = {};
+let fallbackMessages = {};
+
+function loadLocale(locale) {
+  const file = path.join(__dirname, 'locales', `${locale}.json`);
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+/**
+ * Initialize i18n with a locale string (e.g. 'en', 'es').
+ * Call this once at CLI startup.
+ */
+function init(locale) {
+  const lang = (locale || process.env.NERVIQ_LANG || DEFAULT_LOCALE).toLowerCase().slice(0, 2);
+  currentLocale = SUPPORTED_LOCALES.includes(lang) ? lang : DEFAULT_LOCALE;
+  fallbackMessages = loadLocale(DEFAULT_LOCALE);
+  messages = currentLocale === DEFAULT_LOCALE ? fallbackMessages : loadLocale(currentLocale);
+}
+
+/**
+ * Translate a key with optional interpolation.
+ *
+ * Usage:
+ *   t('audit.score', { score: 85, passed: 20, total: 25 })
+ *   // => "Score: 85/100  (20/25 checks passing)"
+ */
+function t(key, params = {}) {
+  let msg = messages[key] || fallbackMessages[key] || key;
+  for (const [k, v] of Object.entries(params)) {
+    msg = msg.replace(new RegExp(`\\{${k}\\}`, 'g'), String(v));
+  }
+  return msg;
+}
+
+/**
+ * Get current locale.
+ */
+function getLocale() {
+  return currentLocale;
+}
+
+// Auto-init with default on first require
+init();
+
+module.exports = { init, t, getLocale, SUPPORTED_LOCALES };

package/src/insights.js

@@ -1,119 +1,119 @@
-/**
- * Anonymous insights collection - opt-in, privacy-first.
- *
- * What we collect (anonymously, no PII):
- * - Score distribution (10/100, 45/100, etc.)
- * - Stack detection (React+TS, Python+Docker, etc.)
- * - Which checks fail most
- * - Which checks pass most
- * - OS + Node version
- *
- * What we NEVER collect:
- * - File contents, paths, or project names
- * - IP addresses or user identity
- * - API keys, tokens, or credentials
- * - Any data if user opts out
- *
- * Users can opt out with: npx nerviq --no-insights
- * Or set env: NERVIQ_NO_INSIGHTS=1
- */
-
-const https = require('https');
-const os = require('os');
-
-const INSIGHTS_ENDPOINT = 'https://insights.nerviq.net/v1/report';
-const TIMEOUT_MS = 3000;
-
-function shouldCollect() {
-  // Opt-IN: only collect if user explicitly enables
-  if (process.env.NERVIQ_INSIGHTS === '1') return true;
-  if (process.argv.includes('--insights')) return true;
-  return false;
-}
-
-function buildPayload(auditResult) {
-  // Only anonymous aggregate data - no PII, no file contents, no paths
-  const failedChecks = auditResult.results
-    .filter(r => !r.passed)
-    .map(r => r.key);
-
-  const passedChecks = auditResult.results
-    .filter(r => r.passed)
-    .map(r => r.key);
-
-  return {
-    v: 1,
-    score: auditResult.score,
-    passed: auditResult.passed,
-    failed: auditResult.failed,
-    stacks: (auditResult.stacks || []).map(s => s.label),
-    failedChecks,
-    passedChecks,
-    platform: os.platform(),
-    nodeVersion: process.version,
-    toolVersion: require('../package.json').version,
-    timestamp: new Date().toISOString(),
-  };
-}
-
-function sendInsights(auditResult) {
-  if (!shouldCollect()) return;
-
-  try {
-    const payload = JSON.stringify(buildPayload(auditResult));
-    const url = new URL(INSIGHTS_ENDPOINT);
-
-    const req = https.request({
-      hostname: url.hostname,
-      path: url.pathname,
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(payload) },
-      timeout: TIMEOUT_MS,
-    });
-
-    // Fire and forget - never block the CLI
-    req.on('error', () => {}); // silently ignore
-    req.on('timeout', () => req.destroy());
-    req.write(payload);
-    req.end();
-  } catch (e) {
-    // Never let insights crash the CLI
-  }
-}
-
-/**
- * Generate insights summary from local audit history.
- * This runs locally - no network needed.
- */
-function getLocalInsights(auditResult) {
-  const { results } = auditResult;
-  const applicable = results.filter(r => r.passed !== null);
-  const failed = applicable.filter(r => r.passed === false);
-
-  // Top 3 most impactful fixes
-  const impactOrder = { critical: 3, high: 2, medium: 1 };
-  const topFixes = [...failed]
-    .sort((a, b) => (impactOrder[b.impact] || 0) - (impactOrder[a.impact] || 0))
-    .slice(0, 3)
-    .map(r => ({ name: r.name, impact: r.impact, fix: r.fix }));
-
-  // Score breakdown by category
-  const categories = {};
-  for (const r of applicable) {
-    const cat = r.category || 'other';
-    if (!categories[cat]) categories[cat] = { passed: 0, total: 0 };
-    categories[cat].total++;
-    if (r.passed) categories[cat].passed++;
-  }
-
-  // Weakest categories
-  const weakest = Object.entries(categories)
-    .map(([name, data]) => ({ name, score: Math.round((data.passed / data.total) * 100), ...data }))
-    .filter(c => c.score < 100)
-    .sort((a, b) => a.score - b.score)
-    .slice(0, 3);
-
-  return { topFixes, categories, weakest, totalScore: auditResult.score };
-}
-
-module.exports = { sendInsights, getLocalInsights, shouldCollect };
+/**
+ * Anonymous insights collection - opt-in, privacy-first.
+ *
+ * What we collect (anonymously, no PII):
+ * - Score distribution (10/100, 45/100, etc.)
+ * - Stack detection (React+TS, Python+Docker, etc.)
+ * - Which checks fail most
+ * - Which checks pass most
+ * - OS + Node version
+ *
+ * What we NEVER collect:
+ * - File contents, paths, or project names
+ * - IP addresses or user identity
+ * - API keys, tokens, or credentials
+ * - Any data if user opts out
+ *
+ * Users can opt out with: npx nerviq --no-insights
+ * Or set env: NERVIQ_NO_INSIGHTS=1
+ */
+
+const https = require('https');
+const os = require('os');
+
+const INSIGHTS_ENDPOINT = 'https://insights.nerviq.net/v1/report';
+const TIMEOUT_MS = 3000;
+
+function shouldCollect() {
+  // Opt-IN: only collect if user explicitly enables
+  if (process.env.NERVIQ_INSIGHTS === '1') return true;
+  if (process.argv.includes('--insights')) return true;
+  return false;
+}
+
+function buildPayload(auditResult) {
+  // Only anonymous aggregate data - no PII, no file contents, no paths
+  const failedChecks = auditResult.results
+    .filter(r => !r.passed)
+    .map(r => r.key);
+
+  const passedChecks = auditResult.results
+    .filter(r => r.passed)
+    .map(r => r.key);
+
+  return {
+    v: 1,
+    score: auditResult.score,
+    passed: auditResult.passed,
+    failed: auditResult.failed,
+    stacks: (auditResult.stacks || []).map(s => s.label),
+    failedChecks,
+    passedChecks,
+    platform: os.platform(),
+    nodeVersion: process.version,
+    toolVersion: require('../package.json').version,
+    timestamp: new Date().toISOString(),
+  };
+}
+
+function sendInsights(auditResult) {
+  if (!shouldCollect()) return;
+
+  try {
+    const payload = JSON.stringify(buildPayload(auditResult));
+    const url = new URL(INSIGHTS_ENDPOINT);
+
+    const req = https.request({
+      hostname: url.hostname,
+      path: url.pathname,
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(payload) },
+      timeout: TIMEOUT_MS,
+    });
+
+    // Fire and forget - never block the CLI
+    req.on('error', () => {}); // silently ignore
+    req.on('timeout', () => req.destroy());
+    req.write(payload);
+    req.end();
+  } catch (e) {
+    // Never let insights crash the CLI
+  }
+}
+
+/**
+ * Generate insights summary from local audit history.
+ * This runs locally - no network needed.
+ */
+function getLocalInsights(auditResult) {
+  const { results } = auditResult;
+  const applicable = results.filter(r => r.passed !== null);
+  const failed = applicable.filter(r => r.passed === false);
+
+  // Top 3 most impactful fixes
+  const impactOrder = { critical: 3, high: 2, medium: 1 };
+  const topFixes = [...failed]
+    .sort((a, b) => (impactOrder[b.impact] || 0) - (impactOrder[a.impact] || 0))
+    .slice(0, 3)
+    .map(r => ({ name: r.name, impact: r.impact, fix: r.fix }));
+
+  // Score breakdown by category
+  const categories = {};
+  for (const r of applicable) {
+    const cat = r.category || 'other';
+    if (!categories[cat]) categories[cat] = { passed: 0, total: 0 };
+    categories[cat].total++;
+    if (r.passed) categories[cat].passed++;
+  }
+
+  // Weakest categories
+  const weakest = Object.entries(categories)
+    .map(([name, data]) => ({ name, score: Math.round((data.passed / data.total) * 100), ...data }))
+    .filter(c => c.score < 100)
+    .sort((a, b) => a.score - b.score)
+    .slice(0, 3);
+
+  return { topFixes, categories, weakest, totalScore: auditResult.score };
+}
+
+module.exports = { sendInsights, getLocalInsights, shouldCollect };

package/src/integrations.js

@@ -1,15 +1,15 @@
-/**
- * Nerviq Integrations
- *
- * Webhook dispatch and message formatting for Slack, Discord,
- * and generic HTTP endpoints.
- *
- * All functions are synchronous-friendly; sendWebhook is async
- * (uses built-in https module, no external dependencies).
- */
-
-'use strict';
-
+/**
+ * Nerviq Integrations
+ *
+ * Webhook dispatch and message formatting for Slack, Discord,
+ * and generic HTTP endpoints.
+ *
+ * All functions are synchronous-friendly; sendWebhook is async
+ * (uses built-in https module, no external dependencies).
+ */
+
+'use strict';
+
 const https = require('https');
 const http = require('http');
 const { URL } = require('url');
@@ -65,11 +65,11 @@ function sendWebhookOnce(parsed, body, opts = {}) {
 }
 
 // ─── Webhook delivery ────────────────────────────────────────────────────────
-
-/**
- * POST JSON payload to a webhook URL.
- * @param {string} url  - Destination URL (http or https)
- * @param {object} payload - JSON-serialisable object
+
+/**
+ * POST JSON payload to a webhook URL.
+ * @param {string} url  - Destination URL (http or https)
+ * @param {object} payload - JSON-serialisable object
  * @param {object} [opts]
  * @param {number} [opts.timeoutMs=10000]
  * @param {object} [opts.headers]
@@ -117,124 +117,124 @@ async function sendWebhook(url, payload, opts = {}) {
 
   return { ok: false, status: 0, body: '', attempts: maxAttempts };
 }
-
-// ─── Slack formatting ─────────────────────────────────────────────────────────
-
-/**
- * Format an audit result as a Slack Block Kit message payload.
- * @param {object} auditResult - Result from audit()
- * @returns {object} Slack-compatible message payload (blocks API)
- */
-function formatSlackMessage(auditResult) {
-  const score = auditResult.score ?? 0;
-  const platform = auditResult.platform ?? 'claude';
-  const emoji = score >= 70 ? ':white_check_mark:' : score >= 40 ? ':warning:' : ':x:';
-  const color = score >= 70 ? 'good' : score >= 40 ? 'warning' : 'danger';
-
-  const criticals = (auditResult.results || [])
-    .filter((r) => r.passed === false && r.impact === 'critical')
-    .slice(0, 5);
-
-  const sections = [
-    {
-      type: 'header',
-      text: { type: 'plain_text', text: `${emoji} Nerviq Audit — ${platform}`, emoji: true },
-    },
-    {
-      type: 'section',
-      fields: [
-        { type: 'mrkdwn', text: `*Score*\n${score}/100` },
-        { type: 'mrkdwn', text: `*Checks*\n${auditResult.passed ?? 0} pass / ${auditResult.failed ?? 0} fail` },
-      ],
-    },
-  ];
-
-  if (criticals.length > 0) {
-    sections.push({ type: 'divider' });
-    sections.push({
-      type: 'section',
-      text: {
-        type: 'mrkdwn',
-        text: `*Critical gaps:*\n${criticals.map((r) => `• ${r.name}`).join('\n')}`,
-      },
-    });
-  }
-
-  if (auditResult.suggestedNextCommand) {
-    sections.push({
-      type: 'section',
-      text: { type: 'mrkdwn', text: `*Next step:* \`${auditResult.suggestedNextCommand}\`` },
-    });
-  }
-
-  // Also include legacy attachment for clients that don't support blocks
-  return {
-    blocks: sections,
-    attachments: [
-      {
-        color,
-        fallback: `Nerviq audit (${platform}): ${score}/100 — ${auditResult.passed ?? 0} pass, ${auditResult.failed ?? 0} fail`,
-      },
-    ],
-  };
-}
-
-// ─── Discord formatting ───────────────────────────────────────────────────────
-
-/**
- * Format an audit result as a Discord webhook embed payload.
- * @param {object} auditResult - Result from audit()
- * @returns {object} Discord-compatible webhook payload (embeds)
- */
+
+// ─── Slack formatting ─────────────────────────────────────────────────────────
+
+/**
+ * Format an audit result as a Slack Block Kit message payload.
+ * @param {object} auditResult - Result from audit()
+ * @returns {object} Slack-compatible message payload (blocks API)
+ */
+function formatSlackMessage(auditResult) {
+  const score = auditResult.score ?? 0;
+  const platform = auditResult.platform ?? 'claude';
+  const emoji = score >= 70 ? ':white_check_mark:' : score >= 40 ? ':warning:' : ':x:';
+  const color = score >= 70 ? 'good' : score >= 40 ? 'warning' : 'danger';
+
+  const criticals = (auditResult.results || [])
+    .filter((r) => r.passed === false && r.impact === 'critical')
+    .slice(0, 5);
+
+  const sections = [
+    {
+      type: 'header',
+      text: { type: 'plain_text', text: `${emoji} Nerviq Audit — ${platform}`, emoji: true },
+    },
+    {
+      type: 'section',
+      fields: [
+        { type: 'mrkdwn', text: `*Score*\n${score}/100` },
+        { type: 'mrkdwn', text: `*Checks*\n${auditResult.passed ?? 0} pass / ${auditResult.failed ?? 0} fail` },
+      ],
+    },
+  ];
+
+  if (criticals.length > 0) {
+    sections.push({ type: 'divider' });
+    sections.push({
+      type: 'section',
+      text: {
+        type: 'mrkdwn',
+        text: `*Critical gaps:*\n${criticals.map((r) => `• ${r.name}`).join('\n')}`,
+      },
+    });
+  }
+
+  if (auditResult.suggestedNextCommand) {
+    sections.push({
+      type: 'section',
+      text: { type: 'mrkdwn', text: `*Next step:* \`${auditResult.suggestedNextCommand}\`` },
+    });
+  }
+
+  // Also include legacy attachment for clients that don't support blocks
+  return {
+    blocks: sections,
+    attachments: [
+      {
+        color,
+        fallback: `Nerviq audit (${platform}): ${score}/100 — ${auditResult.passed ?? 0} pass, ${auditResult.failed ?? 0} fail`,
+      },
+    ],
+  };
+}
+
+// ─── Discord formatting ───────────────────────────────────────────────────────
+
+/**
+ * Format an audit result as a Discord webhook embed payload.
+ * @param {object} auditResult - Result from audit()
+ * @returns {object} Discord-compatible webhook payload (embeds)
+ */
 function formatDiscordMessage(auditResult) {
-  const score = auditResult.score ?? 0;
-  const platform = auditResult.platform ?? 'claude';
-  const color = score >= 70 ? 0x2ecc71 : score >= 40 ? 0xf39c12 : 0xe74c3c; // green / yellow / red
-  const icon = score >= 70 ? '✅' : score >= 40 ? '⚠️' : '❌';
-
-  const criticals = (auditResult.results || [])
-    .filter((r) => r.passed === false && r.impact === 'critical')
-    .slice(0, 5);
-
-  const highs = (auditResult.results || [])
-    .filter((r) => r.passed === false && r.impact === 'high')
-    .slice(0, 3);
-
-  const fields = [
-    { name: 'Score', value: `**${score}/100**`, inline: true },
-    { name: 'Pass / Fail', value: `${auditResult.passed ?? 0} / ${auditResult.failed ?? 0}`, inline: true },
-    { name: 'Platform', value: platform, inline: true },
-  ];
-
-  if (criticals.length > 0) {
-    fields.push({
-      name: '🚨 Critical',
-      value: criticals.map((r) => `• ${r.name}`).join('\n'),
-      inline: false,
-    });
-  }
-
-  if (highs.length > 0) {
-    fields.push({
-      name: '⚠️ High',
-      value: highs.map((r) => `• ${r.name}`).join('\n'),
-      inline: false,
-    });
-  }
-
-  if (auditResult.suggestedNextCommand) {
-    fields.push({ name: '▶️ Next step', value: `\`${auditResult.suggestedNextCommand}\``, inline: false });
-  }
-
-  return {
-    embeds: [
-      {
-        title: `${icon} Nerviq Audit — ${platform}`,
-        color,
-        fields,
-        footer: { text: `nerviq v${require('../package.json').version} • ${new Date().toISOString()}` },
-      },
-    ],
+  const score = auditResult.score ?? 0;
+  const platform = auditResult.platform ?? 'claude';
+  const color = score >= 70 ? 0x2ecc71 : score >= 40 ? 0xf39c12 : 0xe74c3c; // green / yellow / red
+  const icon = score >= 70 ? '✅' : score >= 40 ? '⚠️' : '❌';
+
+  const criticals = (auditResult.results || [])
+    .filter((r) => r.passed === false && r.impact === 'critical')
+    .slice(0, 5);
+
+  const highs = (auditResult.results || [])
+    .filter((r) => r.passed === false && r.impact === 'high')
+    .slice(0, 3);
+
+  const fields = [
+    { name: 'Score', value: `**${score}/100**`, inline: true },
+    { name: 'Pass / Fail', value: `${auditResult.passed ?? 0} / ${auditResult.failed ?? 0}`, inline: true },
+    { name: 'Platform', value: platform, inline: true },
+  ];
+
+  if (criticals.length > 0) {
+    fields.push({
+      name: '🚨 Critical',
+      value: criticals.map((r) => `• ${r.name}`).join('\n'),
+      inline: false,
+    });
+  }
+
+  if (highs.length > 0) {
+    fields.push({
+      name: '⚠️ High',
+      value: highs.map((r) => `• ${r.name}`).join('\n'),
+      inline: false,
+    });
+  }
+
+  if (auditResult.suggestedNextCommand) {
+    fields.push({ name: '▶️ Next step', value: `\`${auditResult.suggestedNextCommand}\``, inline: false });
+  }
+
+  return {
+    embeds: [
+      {
+        title: `${icon} Nerviq Audit — ${platform}`,
+        color,
+        fields,
+        footer: { text: `nerviq v${require('../package.json').version} • ${new Date().toISOString()}` },
+      },
+    ],
   };
 }