@nerviq/cli 1.20.1 → 1.22.0

package/src/integrations.js

@@ -10,113 +10,113 @@
 
 'use strict';
 
-const https = require('https');
-const http = require('http');
-const { URL } = require('url');
-
-const RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);
-
-function wait(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-function sendWebhookOnce(parsed, body, opts = {}) {
-  return new Promise((resolve, reject) => {
-    const timeoutMs = opts.timeoutMs ?? 10_000;
-    const customHeaders = opts.headers || {};
-    const headers = {
-      'User-Agent': `nerviq/${require('../package.json').version}`,
-      ...customHeaders,
-      'Content-Length': Buffer.byteLength(body),
-    };
-
-    const hasContentTypeHeader = Object.keys(headers).some((name) => name.toLowerCase() === 'content-type');
-    if (!hasContentTypeHeader) {
-      headers['Content-Type'] = 'application/json';
-    }
-
-    const options = {
-      hostname: parsed.hostname,
-      port: parsed.port || (parsed.protocol === 'https:' ? 443 : 80),
-      path: parsed.pathname + (parsed.search || ''),
-      method: 'POST',
-      headers,
-    };
-
-    const transport = parsed.protocol === 'https:' ? https : http;
-
-    const req = transport.request(options, (res) => {
-      const chunks = [];
-      res.on('data', (c) => chunks.push(c));
-      res.on('end', () => {
-        const respBody = Buffer.concat(chunks).toString('utf8');
-        resolve({ ok: res.statusCode >= 200 && res.statusCode < 300, status: res.statusCode, body: respBody });
-      });
-    });
-
-    req.setTimeout(timeoutMs, () => {
-      req.destroy(new Error(`Webhook request timed out after ${timeoutMs}ms`));
-    });
-
-    req.on('error', reject);
-    req.write(body);
-    req.end();
-  });
-}
-
-// ─── Webhook delivery ────────────────────────────────────────────────────────
+const https = require('https');
+const http = require('http');
+const { URL } = require('url');
+
+const RETRYABLE_STATUS_CODES = new Set([408, 425, 429, 500, 502, 503, 504]);
+
+function wait(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function sendWebhookOnce(parsed, body, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    const customHeaders = opts.headers || {};
+    const headers = {
+      'User-Agent': `nerviq/${require('../package.json').version}`,
+      ...customHeaders,
+      'Content-Length': Buffer.byteLength(body),
+    };
+
+    const hasContentTypeHeader = Object.keys(headers).some((name) => name.toLowerCase() === 'content-type');
+    if (!hasContentTypeHeader) {
+      headers['Content-Type'] = 'application/json';
+    }
+
+    const options = {
+      hostname: parsed.hostname,
+      port: parsed.port || (parsed.protocol === 'https:' ? 443 : 80),
+      path: parsed.pathname + (parsed.search || ''),
+      method: 'POST',
+      headers,
+    };
+
+    const transport = parsed.protocol === 'https:' ? https : http;
+
+    const req = transport.request(options, (res) => {
+      const chunks = [];
+      res.on('data', (c) => chunks.push(c));
+      res.on('end', () => {
+        const respBody = Buffer.concat(chunks).toString('utf8');
+        resolve({ ok: res.statusCode >= 200 && res.statusCode < 300, status: res.statusCode, body: respBody });
+      });
+    });
+
+    req.setTimeout(timeoutMs, () => {
+      req.destroy(new Error(`Webhook request timed out after ${timeoutMs}ms`));
+    });
+
+    req.on('error', reject);
+    req.write(body);
+    req.end();
+  });
+}
+
+// ─── Webhook delivery ────────────────────────────────────────────────────────
 
 /**
  * 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]
- * @param {number} [opts.retries=2]
- * @param {number} [opts.retryDelayMs=400]
- * @returns {Promise<{ ok: boolean, status: number, body: string, attempts: number }>}
- */
-async function sendWebhook(url, payload, opts = {}) {
-  let parsed;
-  try {
-    parsed = new URL(url);
-  } catch {
-    throw new Error(`Invalid webhook URL: ${url}`);
-  }
-
-  if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
-    throw new Error(`Unsupported webhook protocol: ${parsed.protocol}`);
-  }
-
-  const body = JSON.stringify(payload);
-  const retries = Number.isInteger(opts.retries) && opts.retries >= 0 ? opts.retries : 2;
-  const retryDelayMs = Number.isFinite(opts.retryDelayMs) && opts.retryDelayMs >= 0 ? opts.retryDelayMs : 400;
-  const maxAttempts = retries + 1;
-
-  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    try {
-      const response = await sendWebhookOnce(parsed, body, opts);
-      const enriched = { ...response, attempts: attempt };
-      const shouldRetry = RETRYABLE_STATUS_CODES.has(response.status) && attempt < maxAttempts;
-      if (!shouldRetry) {
-        return enriched;
-      }
-    } catch (error) {
-      error.attempts = attempt;
-      if (attempt >= maxAttempts) {
-        throw error;
-      }
-    }
-
-    const delayMs = retryDelayMs * attempt;
-    if (delayMs > 0) {
-      await wait(delayMs);
-    }
-  }
-
-  return { ok: false, status: 0, body: '', attempts: maxAttempts };
-}
+ * @param {object} [opts]
+ * @param {number} [opts.timeoutMs=10000]
+ * @param {object} [opts.headers]
+ * @param {number} [opts.retries=2]
+ * @param {number} [opts.retryDelayMs=400]
+ * @returns {Promise<{ ok: boolean, status: number, body: string, attempts: number }>}
+ */
+async function sendWebhook(url, payload, opts = {}) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    throw new Error(`Invalid webhook URL: ${url}`);
+  }
+
+  if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+    throw new Error(`Unsupported webhook protocol: ${parsed.protocol}`);
+  }
+
+  const body = JSON.stringify(payload);
+  const retries = Number.isInteger(opts.retries) && opts.retries >= 0 ? opts.retries : 2;
+  const retryDelayMs = Number.isFinite(opts.retryDelayMs) && opts.retryDelayMs >= 0 ? opts.retryDelayMs : 400;
+  const maxAttempts = retries + 1;
+
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      const response = await sendWebhookOnce(parsed, body, opts);
+      const enriched = { ...response, attempts: attempt };
+      const shouldRetry = RETRYABLE_STATUS_CODES.has(response.status) && attempt < maxAttempts;
+      if (!shouldRetry) {
+        return enriched;
+      }
+    } catch (error) {
+      error.attempts = attempt;
+      if (attempt >= maxAttempts) {
+        throw error;
+      }
+    }
+
+    const delayMs = retryDelayMs * attempt;
+    if (delayMs > 0) {
+      await wait(delayMs);
+    }
+  }
+
+  return { ok: false, status: 0, body: '', attempts: maxAttempts };
+}
 
 // ─── Slack formatting ─────────────────────────────────────────────────────────
 
@@ -186,7 +186,7 @@ function formatSlackMessage(auditResult) {
  * @param {object} auditResult - Result from audit()
  * @returns {object} Discord-compatible webhook payload (embeds)
  */
-function formatDiscordMessage(auditResult) {
+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
@@ -235,44 +235,44 @@ function formatDiscordMessage(auditResult) {
         footer: { text: `nerviq v${require('../package.json').version} • ${new Date().toISOString()}` },
       },
     ],
-  };
-}
-
-function formatGenericAuditWebhookEvent(auditResult, options = {}) {
-  const generatedAt = options.generatedAt || new Date().toISOString();
-  const packageVersion = require('../package.json').version;
-
-  return {
-    event: 'nerviq.audit.completed',
-    schemaVersion: '1.0',
-    generatedAt,
-    // Keep legacy summary fields at top-level for backward compatibility.
-    platform: auditResult.platform ?? 'claude',
-    score: auditResult.score ?? 0,
-    passed: auditResult.passed ?? 0,
-    failed: auditResult.failed ?? 0,
-    results: Array.isArray(auditResult.results) ? auditResult.results : [],
-    data: {
-      platform: auditResult.platform ?? 'claude',
-      platformLabel: auditResult.platformLabel ?? null,
-      score: auditResult.score ?? 0,
-      scoreType: auditResult.scoreType || 'live-audit-score',
-      organicScore: auditResult.organicScore ?? null,
-      passed: auditResult.passed ?? 0,
-      failed: auditResult.failed ?? 0,
-      skipped: auditResult.skipped ?? null,
-      checkCount: auditResult.checkCount ?? 0,
-      topNextActions: Array.isArray(auditResult.topNextActions) ? auditResult.topNextActions : [],
-      quickWins: Array.isArray(auditResult.quickWins) ? auditResult.quickWins : [],
-      scoreCoaching: auditResult.scoreCoaching || null,
-      suggestedNextCommand: auditResult.suggestedNextCommand || null,
-    },
-    meta: {
-      cliVersion: packageVersion,
-      source: 'nerviq-cli',
-      webhookFormat: 'generic-audit-event',
-    },
-  };
-}
-
-module.exports = { sendWebhook, formatSlackMessage, formatDiscordMessage, formatGenericAuditWebhookEvent };
+  };
+}
+
+function formatGenericAuditWebhookEvent(auditResult, options = {}) {
+  const generatedAt = options.generatedAt || new Date().toISOString();
+  const packageVersion = require('../package.json').version;
+
+  return {
+    event: 'nerviq.audit.completed',
+    schemaVersion: '1.0',
+    generatedAt,
+    // Keep legacy summary fields at top-level for backward compatibility.
+    platform: auditResult.platform ?? 'claude',
+    score: auditResult.score ?? 0,
+    passed: auditResult.passed ?? 0,
+    failed: auditResult.failed ?? 0,
+    results: Array.isArray(auditResult.results) ? auditResult.results : [],
+    data: {
+      platform: auditResult.platform ?? 'claude',
+      platformLabel: auditResult.platformLabel ?? null,
+      score: auditResult.score ?? 0,
+      scoreType: auditResult.scoreType || 'live-audit-score',
+      organicScore: auditResult.organicScore ?? null,
+      passed: auditResult.passed ?? 0,
+      failed: auditResult.failed ?? 0,
+      skipped: auditResult.skipped ?? null,
+      checkCount: auditResult.checkCount ?? 0,
+      topNextActions: Array.isArray(auditResult.topNextActions) ? auditResult.topNextActions : [],
+      quickWins: Array.isArray(auditResult.quickWins) ? auditResult.quickWins : [],
+      scoreCoaching: auditResult.scoreCoaching || null,
+      suggestedNextCommand: auditResult.suggestedNextCommand || null,
+    },
+    meta: {
+      cliVersion: packageVersion,
+      source: 'nerviq-cli',
+      webhookFormat: 'generic-audit-event',
+    },
+  };
+}
+
+module.exports = { sendWebhook, formatSlackMessage, formatDiscordMessage, formatGenericAuditWebhookEvent };

package/src/interactive.js

@@ -1,118 +1,118 @@
-/**
- * Interactive mode - guides users step-by-step through Claude Code setup.
- * Uses Node.js readline (zero dependencies).
- */
-
-const readline = require('readline');
-const { TECHNIQUES, STACKS } = require('./techniques');
-const { ProjectContext } = require('./context');
-const { setup } = require('./setup');
-
-const COLORS = {
-  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
-  red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
-  blue: '\x1b[36m', magenta: '\x1b[35m',
-};
-const c = (text, color) => `${COLORS[color] || ''}${text}${COLORS.reset}`;
-
-function ask(rl, question) {
-  return new Promise(resolve => rl.question(question, resolve));
-}
-
-async function interactive(options) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  const ctx = new ProjectContext(options.dir);
-  const stacks = ctx.detectStacks(STACKS);
-
-  console.log('');
-  console.log(c('  ╔═══════════════════════════════════════╗', 'magenta'));
-  console.log(c('  ║   nerviq interactive wizard    ║', 'magenta'));
-  console.log(c('  ╚═══════════════════════════════════════╝', 'magenta'));
-  console.log('');
-
-  if (stacks.length > 0) {
-    console.log(c(`  Detected stack: ${stacks.map(s => s.label).join(', ')}`, 'blue'));
-  }
-  console.log(c(`  Working directory: ${options.dir}`, 'dim'));
-  console.log('');
-
-  // Run audit silently
-  const results = [];
-  for (const [key, technique] of Object.entries(TECHNIQUES)) {
-    results.push({ key, ...technique, passed: technique.check(ctx) });
-  }
-  const failed = results.filter(r => r.passed === false);
-  const passed = results.filter(r => r.passed === true);
-
-  console.log(`  ${c(`${passed.length}/${results.length}`, 'bold')} checks already passing.`);
-  console.log(`  ${c(String(failed.length), 'yellow')} improvements available.`);
-  console.log('');
-
-  if (failed.length === 0) {
-    console.log(c('  Your project is fully optimized for Claude Code!', 'green'));
-    rl.close();
-    return;
-  }
-
-  // Group by priority
-  const critical = failed.filter(r => r.impact === 'critical');
-  const high = failed.filter(r => r.impact === 'high');
-  const medium = failed.filter(r => r.impact === 'medium');
-  const groups = [
-    { label: 'Critical', color: 'red', items: critical },
-    { label: 'High Impact', color: 'yellow', items: high },
-    { label: 'Recommended', color: 'blue', items: medium },
-  ].filter(g => g.items.length > 0);
-
-  const toFix = [];
-
-  for (const group of groups) {
-    console.log(c(`  ── ${group.label} (${group.items.length}) ──`, group.color));
-    console.log('');
-
-    for (const item of group.items) {
-      console.log(`  ${c(item.name, 'bold')}`);
-      console.log(c(`  ${item.fix}`, 'dim'));
-      const answer = await ask(rl, c('  Fix this? (y/n/q) ', 'magenta'));
-
-      if (answer.toLowerCase() === 'q') {
-        console.log('');
-        console.log(c('  Stopping wizard.', 'dim'));
-        break;
-      }
-      if (answer.toLowerCase() === 'y' || answer.toLowerCase() === '') {
-        toFix.push(item.key);
-        console.log(c('  → Will fix', 'green'));
-      } else {
-        console.log(c('  → Skipped', 'dim'));
-      }
-      console.log('');
-    }
-  }
-
-  rl.close();
-
-  if (toFix.length === 0) {
-    console.log(c('  No changes selected.', 'dim'));
-    return;
-  }
-
-  console.log('');
-  console.log(c('  ── Summary ──', 'magenta'));
-  console.log(`  Selected ${c(String(toFix.length), 'bold')} improvements to apply:`);
-  for (const key of toFix) {
-    const item = results.find(r => r.key === key);
-    console.log(c(`    • ${item ? item.name : key}`, 'dim'));
-  }
-  console.log('');
-  console.log(c(`  Applying...`, 'bold'));
-  console.log('');
-
-  // Run setup in auto mode
-  await setup({ ...options, auto: true, only: toFix });
-
-  console.log('');
-  console.log(c('  Done! Run `npx nerviq` to see your new score.', 'green'));
-}
-
-module.exports = { interactive };
+/**
+ * Interactive mode - guides users step-by-step through Claude Code setup.
+ * Uses Node.js readline (zero dependencies).
+ */
+
+const readline = require('readline');
+const { TECHNIQUES, STACKS } = require('./techniques');
+const { ProjectContext } = require('./context');
+const { setup } = require('./setup');
+
+const COLORS = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
+  blue: '\x1b[36m', magenta: '\x1b[35m',
+};
+const c = (text, color) => `${COLORS[color] || ''}${text}${COLORS.reset}`;
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, resolve));
+}
+
+async function interactive(options) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const ctx = new ProjectContext(options.dir);
+  const stacks = ctx.detectStacks(STACKS);
+
+  console.log('');
+  console.log(c('  ╔═══════════════════════════════════════╗', 'magenta'));
+  console.log(c('  ║   nerviq interactive wizard    ║', 'magenta'));
+  console.log(c('  ╚═══════════════════════════════════════╝', 'magenta'));
+  console.log('');
+
+  if (stacks.length > 0) {
+    console.log(c(`  Detected stack: ${stacks.map(s => s.label).join(', ')}`, 'blue'));
+  }
+  console.log(c(`  Working directory: ${options.dir}`, 'dim'));
+  console.log('');
+
+  // Run audit silently
+  const results = [];
+  for (const [key, technique] of Object.entries(TECHNIQUES)) {
+    results.push({ key, ...technique, passed: technique.check(ctx) });
+  }
+  const failed = results.filter(r => r.passed === false);
+  const passed = results.filter(r => r.passed === true);
+
+  console.log(`  ${c(`${passed.length}/${results.length}`, 'bold')} checks already passing.`);
+  console.log(`  ${c(String(failed.length), 'yellow')} improvements available.`);
+  console.log('');
+
+  if (failed.length === 0) {
+    console.log(c('  Your project is fully optimized for Claude Code!', 'green'));
+    rl.close();
+    return;
+  }
+
+  // Group by priority
+  const critical = failed.filter(r => r.impact === 'critical');
+  const high = failed.filter(r => r.impact === 'high');
+  const medium = failed.filter(r => r.impact === 'medium');
+  const groups = [
+    { label: 'Critical', color: 'red', items: critical },
+    { label: 'High Impact', color: 'yellow', items: high },
+    { label: 'Recommended', color: 'blue', items: medium },
+  ].filter(g => g.items.length > 0);
+
+  const toFix = [];
+
+  for (const group of groups) {
+    console.log(c(`  ── ${group.label} (${group.items.length}) ──`, group.color));
+    console.log('');
+
+    for (const item of group.items) {
+      console.log(`  ${c(item.name, 'bold')}`);
+      console.log(c(`  ${item.fix}`, 'dim'));
+      const answer = await ask(rl, c('  Fix this? (y/n/q) ', 'magenta'));
+
+      if (answer.toLowerCase() === 'q') {
+        console.log('');
+        console.log(c('  Stopping wizard.', 'dim'));
+        break;
+      }
+      if (answer.toLowerCase() === 'y' || answer.toLowerCase() === '') {
+        toFix.push(item.key);
+        console.log(c('  → Will fix', 'green'));
+      } else {
+        console.log(c('  → Skipped', 'dim'));
+      }
+      console.log('');
+    }
+  }
+
+  rl.close();
+
+  if (toFix.length === 0) {
+    console.log(c('  No changes selected.', 'dim'));
+    return;
+  }
+
+  console.log('');
+  console.log(c('  ── Summary ──', 'magenta'));
+  console.log(`  Selected ${c(String(toFix.length), 'bold')} improvements to apply:`);
+  for (const key of toFix) {
+    const item = results.find(r => r.key === key);
+    console.log(c(`    • ${item ? item.name : key}`, 'dim'));
+  }
+  console.log('');
+  console.log(c(`  Applying...`, 'bold'));
+  console.log('');
+
+  // Run setup in auto mode
+  await setup({ ...options, auto: true, only: toFix });
+
+  console.log('');
+  console.log(c('  Done! Run `npx nerviq` to see your new score.', 'green'));
+}
+
+module.exports = { interactive };

package/src/locales/en.json

@@ -7,7 +7,7 @@
   "audit.platform": "Platform: {platform} ({version})",
   "audit.domainPacks": "Domain packs: {packs}",
   "audit.scope": "Scope: {message}",
-  "audit.score": "Live audit score: {score}  ({passed}/{total} checks passing)",
+  "audit.score": "Live audit score: {score}  ({passed}/{total} checks passing)",
   "audit.found": "Found: {files}",
   "audit.excellent": "Excellent setup — production-ready governance",
   "audit.strong": "Strong setup — {count} critical items to address",

package/src/locales/es.json

@@ -7,7 +7,7 @@
   "audit.platform": "Plataforma: {platform} ({version})",
   "audit.domainPacks": "Paquetes de dominio: {packs}",
   "audit.scope": "Alcance: {message}",
-  "audit.score": "Puntuación de auditoría en vivo: {score}  ({passed}/{total} verificaciones aprobadas)",
+  "audit.score": "Puntuación de auditoría en vivo: {score}  ({passed}/{total} verificaciones aprobadas)",
   "audit.found": "Encontrado: {files}",
   "audit.excellent": "Configuración excelente — gobernanza lista para producción",
   "audit.strong": "Configuración sólida — {count} elementos críticos por resolver",