@nerviq/cli 1.8.3 → 1.8.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nerviq/cli",
-  "version": "1.8.3",
+  "version": "1.8.4",
   "description": "The intelligent nervous system for AI coding agents — 2,431 checks across 8 platforms, 10 languages, and 62 domain packs. Audit, align, and amplify.",
   "main": "src/index.js",
   "bin": {

package/src/auto-suggest.js

@@ -0,0 +1,101 @@
+const { loadPatterns } = require('./usage-patterns');
+const { readSnapshotIndex } = require('./activity');
+
+const MIN_EVENTS = 2;
+const SUPPRESS_THRESHOLD = 3;
+const RECENT_AUDITS = 10;
+
+/**
+ * Analyze usage patterns and audit history to suggest rules.
+ */
+function analyzeSuggestions(dir) {
+  const patterns = loadPatterns(dir);
+  const snapshots = readSnapshotIndex(dir);
+
+  const keys = Object.keys(patterns);
+  const totalEvents = keys.reduce((sum, k) => {
+    const e = patterns[k];
+    return sum + e.accepted + e.rejected + e.skipped;
+  }, 0);
+
+  // Checks always accepted -> suggest as required
+  const suggestedRules = keys
+    .filter(k => {
+      const e = patterns[k];
+      return e.accepted >= MIN_EVENTS && e.rejected === 0;
+    })
+    .map(k => ({ key: k, accepted: patterns[k].accepted, total: patterns[k].accepted }));
+
+  // Checks always rejected -> suggest suppressing
+  const suggestedSuppressions = keys
+    .filter(k => {
+      const e = patterns[k];
+      return e.rejected >= SUPPRESS_THRESHOLD && e.accepted === 0;
+    })
+    .map(k => ({ key: k, rejected: patterns[k].rejected, total: patterns[k].rejected }));
+
+  // From audit snapshots: checks that repeatedly appear in topActionKeys (failing)
+  const auditSnapshots = snapshots
+    .filter(s => s.snapshotKind === 'audit' && s.summary && Array.isArray(s.summary.topActionKeys))
+    .sort((a, b) => new Date(b.createdAt) - new Date(a.createdAt))
+    .slice(0, RECENT_AUDITS);
+
+  const failCounts = {};
+  for (const snap of auditSnapshots) {
+    for (const key of snap.summary.topActionKeys) {
+      failCounts[key] = (failCounts[key] || 0) + 1;
+    }
+  }
+
+  const suggestedPriorities = Object.entries(failCounts)
+    .filter(([, count]) => count >= 2)
+    .sort((a, b) => b[1] - a[1])
+    .map(([key, count]) => ({ key, failCount: count, auditCount: auditSnapshots.length }));
+
+  return { totalEvents, auditCount: auditSnapshots.length, suggestedRules, suggestedSuppressions, suggestedPriorities };
+}
+
+/**
+ * Format suggestions for CLI output.
+ */
+function formatSuggestions(suggestions) {
+  const { totalEvents, auditCount, suggestedRules, suggestedSuppressions, suggestedPriorities } = suggestions;
+
+  if (totalEvents === 0 && auditCount === 0) {
+    return '  No usage data yet. Run nerviq fix or nerviq audit to build pattern history.';
+  }
+
+  const sources = [];
+  if (totalEvents > 0) sources.push(`${totalEvents} pattern events`);
+  if (auditCount > 0) sources.push(`${auditCount} audit snapshots`);
+  const lines = [`  Auto-Suggested Rules (based on ${sources.join(', ')}):`];
+
+  if (suggestedRules.length > 0) {
+    lines.push('', '  Suggested as required (always accepted):');
+    for (const r of suggestedRules) {
+      lines.push(`  + ${r.key.padEnd(20)} — accepted ${r.accepted}/${r.total} times, consider making mandatory`);
+    }
+  }
+
+  if (suggestedSuppressions.length > 0) {
+    lines.push('', '  Suggested to suppress (always rejected):');
+    for (const s of suggestedSuppressions) {
+      lines.push(`  - ${s.key.padEnd(20)} — rejected ${s.rejected}/${s.total} times, may not fit your workflow`);
+    }
+  }
+
+  if (suggestedPriorities.length > 0) {
+    lines.push('', '  Priority focus (failing repeatedly):');
+    for (const p of suggestedPriorities) {
+      lines.push(`  ! ${p.key.padEnd(20)} — failed in ${p.failCount}/${p.auditCount} recent audits`);
+    }
+  }
+
+  if (suggestedRules.length === 0 && suggestedSuppressions.length === 0 && suggestedPriorities.length === 0) {
+    lines.push('', '  No strong patterns detected yet. Keep using nerviq fix and audit to build history.');
+  }
+
+  return lines.join('\n');
+}
+
+module.exports = { analyzeSuggestions, formatSuggestions };

package/src/profiles.js

@@ -0,0 +1,121 @@
+/**
+ * Team profiles — save and share org-specific check weights and preferences.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROFILES_DIR = 'profiles';
+
+function profilesDir(dir) {
+  return path.join(dir, '.nerviq', PROFILES_DIR);
+}
+
+function profilePath(dir, name) {
+  return path.join(profilesDir(dir), `${name}.json`);
+}
+
+function validateProfileName(name) {
+  if (!name || typeof name !== 'string') throw new Error('Profile name is required.');
+  if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+    throw new Error(`Invalid profile name '${name}'. Use only letters, numbers, hyphens, and underscores.`);
+  }
+  if (name.length > 64) throw new Error('Profile name must be 64 characters or fewer.');
+}
+
+function saveProfile(dir, profileName, options = {}) {
+  validateProfileName(profileName);
+  const profileDir = profilesDir(dir);
+  fs.mkdirSync(profileDir, { recursive: true });
+
+  const profile = {
+    name: profileName,
+    created: new Date().toISOString().split('T')[0],
+    platforms: options.platforms || ['claude'],
+    threshold: options.threshold != null ? Number(options.threshold) : 70,
+    suppressedChecks: options.suppressedChecks || [],
+    priorityBoosts: options.priorityBoosts || [],
+    customWeights: options.customWeights || {},
+    description: options.description || '',
+  };
+
+  const filePath = profilePath(dir, profileName);
+  fs.writeFileSync(filePath, JSON.stringify(profile, null, 2), 'utf8');
+  return { saved: true, path: filePath, profile };
+}
+
+function loadProfile(dir, profileName) {
+  validateProfileName(profileName);
+  const filePath = profilePath(dir, profileName);
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`Profile '${profileName}' not found. Run 'nerviq profile list' to see available profiles.`);
+  }
+  const raw = fs.readFileSync(filePath, 'utf8');
+  let profile;
+  try {
+    profile = JSON.parse(raw);
+  } catch {
+    throw new Error(`Profile '${profileName}' contains invalid JSON.`);
+  }
+  return profile;
+}
+
+function listProfiles(dir) {
+  const profDir = profilesDir(dir);
+  if (!fs.existsSync(profDir)) return [];
+  return fs.readdirSync(profDir)
+    .filter(f => f.endsWith('.json'))
+    .map(f => {
+      const name = f.replace(/\.json$/, '');
+      try {
+        const data = JSON.parse(fs.readFileSync(path.join(profDir, f), 'utf8'));
+        return { name, description: data.description || '', platforms: data.platforms || [], threshold: data.threshold };
+      } catch {
+        return { name, description: '(invalid)', platforms: [], threshold: null };
+      }
+    });
+}
+
+function exportProfile(dir, profileName) {
+  const profile = loadProfile(dir, profileName);
+  return JSON.stringify(profile, null, 2);
+}
+
+function applyProfileToOptions(profile, options) {
+  const merged = { ...options };
+  if (profile.threshold != null && merged.threshold == null) {
+    merged.threshold = profile.threshold;
+  }
+  if (profile.platforms && profile.platforms.length > 0 && !options.platform) {
+    merged.platform = profile.platforms[0];
+  }
+  merged.suppressedChecks = profile.suppressedChecks || [];
+  merged.priorityBoosts = profile.priorityBoosts || [];
+  merged.customWeights = profile.customWeights || {};
+  return merged;
+}
+
+function formatProfileList(profiles) {
+  if (profiles.length === 0) return '  No profiles found. Create one with: nerviq profile save <name>';
+  const lines = profiles.map(p => {
+    const desc = p.description ? ` — ${p.description}` : '';
+    const plats = p.platforms.length > 0 ? ` [${p.platforms.join(', ')}]` : '';
+    return `  ${p.name}${plats}${desc}`;
+  });
+  return lines.join('\n');
+}
+
+function formatProfile(profile) {
+  const lines = [
+    `  Name:        ${profile.name}`,
+    `  Created:     ${profile.created || 'unknown'}`,
+    `  Platforms:   ${(profile.platforms || []).join(', ') || 'any'}`,
+    `  Threshold:   ${profile.threshold != null ? profile.threshold : 'default'}`,
+    `  Suppressed:  ${(profile.suppressedChecks || []).join(', ') || 'none'}`,
+    `  Boosted:     ${(profile.priorityBoosts || []).join(', ') || 'none'}`,
+    `  Description: ${profile.description || '(none)'}`,
+  ];
+  return lines.join('\n');
+}
+
+module.exports = { saveProfile, loadProfile, listProfiles, exportProfile, applyProfileToOptions, formatProfileList, formatProfile, validateProfileName };