@kevinrabun/judges 3.43.0 → 3.45.0

package/dist/commands/kb.js

@@ -0,0 +1,231 @@
+/**
+ * Team knowledge base — store team decisions about rules, exceptions,
+ * known patterns, and contextual knowledge that informs evaluations.
+ *
+ * Stored locally in .judges-kb.json.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+const KB_FILE = ".judges-kb.json";
+// ─── Core ───────────────────────────────────────────────────────────────────
+function loadDb(file = KB_FILE) {
+    if (!existsSync(file))
+        return { entries: [] };
+    return JSON.parse(readFileSync(file, "utf-8"));
+}
+function saveDb(db, file = KB_FILE) {
+    writeFileSync(file, JSON.stringify(db, null, 2));
+}
+function genId() {
+    return `kb-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+}
+export function addKbEntry(opts) {
+    const db = loadDb();
+    const entry = {
+        id: genId(),
+        rulePattern: opts.rulePattern,
+        decision: opts.decision,
+        reason: opts.reason,
+        approvedBy: opts.approvedBy,
+        createdIso: new Date().toISOString(),
+        scope: opts.scope,
+        tags: opts.tags,
+        active: true,
+    };
+    if (opts.expiresIn) {
+        const exp = new Date();
+        exp.setDate(exp.getDate() + opts.expiresIn);
+        entry.expiresIso = exp.toISOString();
+    }
+    db.entries.push(entry);
+    saveDb(db);
+    return entry;
+}
+export function archiveKbEntry(id) {
+    const db = loadDb();
+    const entry = db.entries.find((e) => e.id === id);
+    if (!entry)
+        return false;
+    entry.active = false;
+    saveDb(db);
+    return true;
+}
+export function searchKb(query) {
+    const db = loadDb();
+    const q = query.toLowerCase();
+    return db.entries.filter((e) => e.active &&
+        (e.rulePattern.toLowerCase().includes(q) ||
+            e.reason.toLowerCase().includes(q) ||
+            e.decision.includes(q) ||
+            e.tags?.some((t) => t.toLowerCase().includes(q))));
+}
+export function getApplicableEntries(ruleId) {
+    const db = loadDb();
+    const now = Date.now();
+    return db.entries.filter((e) => {
+        if (!e.active)
+            return false;
+        if (e.expiresIso && new Date(e.expiresIso).getTime() < now)
+            return false;
+        return ruleId === e.rulePattern || ruleId.startsWith(e.rulePattern);
+    });
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runKnowledgeBase(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges kb — Team knowledge base for rule decisions and exceptions
+
+Usage:
+  judges kb --add --rule AUTH-003 --decision not-applicable --reason "Stateless microservices" --approved-by "Team Lead"
+  judges kb --search AUTH               Search knowledge base
+  judges kb --check SEC-001             Check if rule has KB entries
+  judges kb --list                      List all active entries
+  judges kb --archive <id>              Archive an entry
+  judges kb --stats                     Show KB statistics
+
+Options:
+  --add                 Add new KB entry
+  --rule <pattern>      Rule ID or prefix
+  --decision <type>     not-applicable | accepted-risk | deferred | exception | custom-guidance
+  --reason <text>       Reason for decision
+  --approved-by <name>  Who approved
+  --scope <glob>        File scope
+  --tags <list>         Comma-separated tags
+  --expires-in <days>   Auto-expire after N days
+  --search <query>      Search KB
+  --check <rule-id>     Check for KB entries on a rule
+  --list                List all active entries
+  --archive <id>        Archive an entry
+  --stats               Show statistics
+  --format json         JSON output
+  --help, -h            Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    // Add entry
+    if (argv.includes("--add")) {
+        const rulePattern = argv.find((_a, i) => argv[i - 1] === "--rule");
+        const decision = argv.find((_a, i) => argv[i - 1] === "--decision");
+        const reason = argv.find((_a, i) => argv[i - 1] === "--reason");
+        const approvedBy = argv.find((_a, i) => argv[i - 1] === "--approved-by") ||
+            process.env.USER ||
+            process.env.USERNAME ||
+            "unknown";
+        const scope = argv.find((_a, i) => argv[i - 1] === "--scope");
+        const tagsStr = argv.find((_a, i) => argv[i - 1] === "--tags");
+        const expiresStr = argv.find((_a, i) => argv[i - 1] === "--expires-in");
+        if (!rulePattern || !decision || !reason) {
+            console.error("Error: --rule, --decision, and --reason required");
+            process.exit(1);
+        }
+        const entry = addKbEntry({
+            rulePattern,
+            decision,
+            reason,
+            approvedBy,
+            scope,
+            tags: tagsStr ? tagsStr.split(",").map((s) => s.trim()) : undefined,
+            expiresIn: expiresStr ? parseInt(expiresStr, 10) : undefined,
+        });
+        if (format === "json") {
+            console.log(JSON.stringify(entry, null, 2));
+        }
+        else {
+            console.log(`  ✅ KB entry created: ${entry.id}`);
+            console.log(`     ${entry.rulePattern}: ${entry.decision} — ${entry.reason}`);
+        }
+        return;
+    }
+    // Search
+    const searchQuery = argv.find((_a, i) => argv[i - 1] === "--search");
+    if (searchQuery) {
+        const results = searchKb(searchQuery);
+        if (format === "json") {
+            console.log(JSON.stringify(results, null, 2));
+        }
+        else if (results.length === 0) {
+            console.log(`\n  No KB entries matching "${searchQuery}".\n`);
+        }
+        else {
+            console.log(`\n  ${results.length} KB entry(ies) matching "${searchQuery}"\n  ──────────────────`);
+            for (const e of results) {
+                console.log(`    ${e.rulePattern.padEnd(15)} ${e.decision.padEnd(18)} ${e.reason}`);
+                console.log(`      Approved by ${e.approvedBy} on ${e.createdIso.split("T")[0]}`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    // Check specific rule
+    const checkRule = argv.find((_a, i) => argv[i - 1] === "--check");
+    if (checkRule) {
+        const entries = getApplicableEntries(checkRule);
+        if (format === "json") {
+            console.log(JSON.stringify(entries, null, 2));
+        }
+        else if (entries.length === 0) {
+            console.log(`\n  No KB entries for ${checkRule}.\n`);
+        }
+        else {
+            console.log(`\n  KB entries for ${checkRule}:`);
+            for (const e of entries) {
+                console.log(`    ${e.decision}: ${e.reason} (${e.approvedBy})`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    // Archive
+    const archiveId = argv.find((_a, i) => argv[i - 1] === "--archive");
+    if (archiveId) {
+        if (archiveKbEntry(archiveId)) {
+            console.log(`  Archived: ${archiveId}`);
+        }
+        else {
+            console.error(`  Not found: ${archiveId}`);
+        }
+        return;
+    }
+    // Stats
+    if (argv.includes("--stats")) {
+        const db = loadDb();
+        const active = db.entries.filter((e) => e.active);
+        const byDecision = {};
+        for (const e of active) {
+            byDecision[e.decision] = (byDecision[e.decision] || 0) + 1;
+        }
+        if (format === "json") {
+            console.log(JSON.stringify({ total: db.entries.length, active: active.length, byDecision }, null, 2));
+        }
+        else {
+            console.log(`\n  Knowledge Base\n  ──────────────`);
+            console.log(`  Total: ${db.entries.length} (${active.length} active)\n`);
+            for (const [d, c] of Object.entries(byDecision)) {
+                console.log(`    ${d.padEnd(20)} ${c}`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    // Default: list all
+    const db = loadDb();
+    const active = db.entries.filter((e) => e.active);
+    if (active.length === 0) {
+        console.log("\n  Knowledge base is empty. Use --add to create an entry.\n");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(active, null, 2));
+    }
+    else {
+        console.log(`\n  Team Knowledge Base (${active.length} active)\n  ──────────────────────`);
+        for (const e of active) {
+            const exp = e.expiresIso ? ` (expires ${e.expiresIso.split("T")[0]})` : "";
+            console.log(`    ${e.id}  ${e.rulePattern.padEnd(15)} ${e.decision}${exp}`);
+            console.log(`      ${e.reason} — ${e.approvedBy}`);
+        }
+        console.log("");
+    }
+}
+//# sourceMappingURL=kb.js.map

package/dist/commands/kb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.js","sourceRoot":"","sources":["../../src/commands/kb.ts"],"names":[],"mappings":"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"}

package/dist/commands/noise-advisor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Noise advisor — analyze finding feedback history and rule performance
+ * to recommend tuning actions (disable rules, adjust severity, etc.).
+ *
+ * Uses local false-negative and suppression data — no external services.
+ */
+export interface RuleStats {
+    ruleId: string;
+    totalFindings: number;
+    suppressedCount: number;
+    falseNegativeCount: number;
+    fpRate: number;
+    avgConfidence: number;
+}
+export interface NoiseRecommendation {
+    ruleId: string;
+    action: "disable" | "raise-threshold" | "lower-severity" | "keep" | "investigate";
+    reason: string;
+    fpRate: number;
+    findingCount: number;
+    confidence: number;
+}
+export declare function analyzeNoise(opts?: {
+    resultsPath?: string;
+    triagePath?: string;
+    fnPath?: string;
+    suppressionPath?: string;
+}): NoiseRecommendation[];
+export declare function runNoiseAdvisor(argv: string[]): void;
+//# sourceMappingURL=noise-advisor.d.ts.map

package/dist/commands/noise-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-advisor.d.ts","sourceRoot":"","sources":["../../src/commands/noise-advisor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,MAAM,GAAG,aAAa,CAAC;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAgCD,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,mBAAmB,EAAE,CAwGxB;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAkEpD"}

package/dist/commands/noise-advisor.js

@@ -0,0 +1,171 @@
+/**
+ * Noise advisor — analyze finding feedback history and rule performance
+ * to recommend tuning actions (disable rules, adjust severity, etc.).
+ *
+ * Uses local false-negative and suppression data — no external services.
+ */
+import { readFileSync, existsSync } from "fs";
+// ─── Analysis ───────────────────────────────────────────────────────────────
+function loadJsonSafe(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function analyzeNoise(opts) {
+    const resultsPath = opts?.resultsPath;
+    const fnPath = opts?.fnPath || ".judges-false-negatives.json";
+    const suppressionPath = opts?.suppressionPath || ".judges-suppressions.json";
+    // Gather findings from results
+    const ruleMap = new Map();
+    if (resultsPath && existsSync(resultsPath)) {
+        const data = JSON.parse(readFileSync(resultsPath, "utf-8"));
+        const findings = data.evaluations
+            ? data.evaluations.flatMap((e) => e.findings || [])
+            : data.findings || [];
+        for (const f of findings) {
+            const existing = ruleMap.get(f.ruleId) || { total: 0, confidences: [], severities: [] };
+            existing.total++;
+            if (f.confidence !== undefined)
+                existing.confidences.push(f.confidence);
+            existing.severities.push(f.severity);
+            ruleMap.set(f.ruleId, existing);
+        }
+    }
+    // Count suppressed findings per rule
+    const suppressedByRule = new Map();
+    const suppressionDb = loadJsonSafe(suppressionPath);
+    if (suppressionDb?.rules) {
+        for (const r of suppressionDb.rules) {
+            if (!r.active)
+                continue;
+            if (r.ruleIds) {
+                for (const id of r.ruleIds) {
+                    suppressedByRule.set(id, (suppressedByRule.get(id) || 0) + 1);
+                }
+            }
+            if (r.rulePrefix) {
+                // Count as affecting all matching rules
+                for (const ruleId of ruleMap.keys()) {
+                    if (ruleId.startsWith(r.rulePrefix)) {
+                        suppressedByRule.set(ruleId, (suppressedByRule.get(ruleId) || 0) + 1);
+                    }
+                }
+            }
+        }
+    }
+    // Count false negatives
+    const fnByRule = new Map();
+    const fnDb = loadJsonSafe(fnPath);
+    if (fnDb?.entries) {
+        for (const e of fnDb.entries) {
+            const key = e.ruleId || e.category || "unknown";
+            fnByRule.set(key, (fnByRule.get(key) || 0) + 1);
+        }
+    }
+    // Generate recommendations
+    const recommendations = [];
+    for (const [ruleId, stats] of ruleMap) {
+        const suppressed = suppressedByRule.get(ruleId) || 0;
+        const fnCount = fnByRule.get(ruleId) || 0;
+        const total = stats.total + suppressed;
+        const fpRate = total > 0 ? suppressed / total : 0;
+        const avgConf = stats.confidences.length > 0 ? stats.confidences.reduce((a, b) => a + b, 0) / stats.confidences.length : 0.5;
+        let action = "keep";
+        let reason = "Rule performs within acceptable parameters.";
+        if (fpRate > 0.6 && total >= 3) {
+            action = "disable";
+            reason = `${(fpRate * 100).toFixed(0)}% false-positive rate across ${total} findings. Consider disabling.`;
+        }
+        else if (fpRate > 0.4 && total >= 3) {
+            action = "raise-threshold";
+            reason = `${(fpRate * 100).toFixed(0)}% FP rate. Raise confidence threshold to reduce noise.`;
+        }
+        else if (avgConf < 0.4 && stats.total >= 3) {
+            action = "lower-severity";
+            reason = `Average confidence ${(avgConf * 100).toFixed(0)}%. Lower severity or add to review queue.`;
+        }
+        else if (fnCount > 0 && suppressed > 0) {
+            action = "investigate";
+            reason = `Rule has both false negatives (${fnCount}) and suppressions (${suppressed}). Needs calibration review.`;
+        }
+        recommendations.push({
+            ruleId,
+            action,
+            reason,
+            fpRate: Math.round(fpRate * 1000) / 1000,
+            findingCount: total,
+            confidence: Math.round(avgConf * 1000) / 1000,
+        });
+    }
+    // Sort by actionability (disable first, then raise-threshold, etc.)
+    const actionOrder = {
+        disable: 0,
+        "raise-threshold": 1,
+        "lower-severity": 2,
+        investigate: 3,
+        keep: 4,
+    };
+    recommendations.sort((a, b) => (actionOrder[a.action] ?? 5) - (actionOrder[b.action] ?? 5));
+    return recommendations;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runNoiseAdvisor(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges noise-advisor — Analyze rule performance and recommend tuning
+
+Usage:
+  judges noise-advisor --input results.json
+  judges noise-advisor --input results.json --format json
+
+Analyzes findings, suppressions, and false-negative feedback to recommend:
+  - Rules to disable (high FP rate)
+  - Rules needing threshold adjustment
+  - Rules requiring calibration review
+
+Options:
+  --input <path>        Results JSON file
+  --format json         JSON output
+  --help, -h            Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const inputPath = argv.find((_a, i) => argv[i - 1] === "--input");
+    const recs = analyzeNoise({ resultsPath: inputPath || undefined });
+    if (recs.length === 0) {
+        console.log("\n  No data to analyze. Run an evaluation first or provide --input.\n");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(recs, null, 2));
+        return;
+    }
+    const actionable = recs.filter((r) => r.action !== "keep");
+    const keep = recs.filter((r) => r.action === "keep");
+    console.log(`\n  Noise Analysis — ${recs.length} rules analyzed, ${actionable.length} need attention\n  ─────────────────`);
+    if (actionable.length > 0) {
+        console.log("\n  Recommendations:");
+        for (const r of actionable) {
+            const icon = r.action === "disable"
+                ? "🔴"
+                : r.action === "raise-threshold"
+                    ? "🟡"
+                    : r.action === "lower-severity"
+                        ? "🟠"
+                        : "🔍";
+            console.log(`    ${icon} ${r.ruleId.padEnd(15)} ${r.action.padEnd(18)} FP: ${(r.fpRate * 100).toFixed(0)}% (${r.findingCount} total)`);
+            console.log(`       ${r.reason}`);
+        }
+    }
+    if (keep.length > 0) {
+        console.log(`\n  ${keep.length} rule(s) performing well — no changes needed.`);
+    }
+    console.log("");
+}
+//# sourceMappingURL=noise-advisor.js.map

package/dist/commands/noise-advisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-advisor.js","sourceRoot":"","sources":["../../src/commands/noise-advisor.ts"],"names":[],"mappings":"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"}

package/dist/commands/query.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Advanced finding search/filter — complex queries across evaluation results.
+ *
+ * Reads local .judges-results.json files for searching.
+ */
+import type { Finding } from "../types.js";
+interface FindingRecord extends Finding {
+    source?: string;
+    timestamp?: string;
+}
+interface QueryResult {
+    matches: FindingRecord[];
+    total: number;
+    query: string;
+}
+export declare function queryFindings(queryStr: string, findings?: FindingRecord[]): QueryResult;
+export declare function aggregateFindings(findings: FindingRecord[], groupBy: string): Record<string, number>;
+export declare function runQuery(argv: string[]): void;
+export {};
+//# sourceMappingURL=query.d.ts.map

package/dist/commands/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,UAAU,aAAc,SAAQ,OAAO;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAmED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,EAAE,GAAG,WAAW,CAkCvF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBpG;AAID,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuF7C"}