@nerviq/cli 0.0.1 → 0.9.0-beta.1

package/src/insights.js

@@ -0,0 +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: CLAUDEX_NO_INSIGHTS=1
+ */
+
+const https = require('https');
+const os = require('os');
+
+const INSIGHTS_ENDPOINT = 'https://claudex-insights.claudex.workers.dev/v1/report';
+const TIMEOUT_MS = 3000;
+
+function shouldCollect() {
+  // Opt-IN: only collect if user explicitly enables
+  if (process.env.CLAUDEX_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/interactive.js

@@ -0,0 +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 };