@kevinrabun/judges 3.43.0 → 3.45.0

package/dist/commands/correlate.js

@@ -0,0 +1,242 @@
+/**
+ * Finding correlation — link related findings, identify root causes,
+ * and detect systemic patterns across evaluations.
+ *
+ * Stored locally in .judges-correlations.json.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+const CORRELATION_FILE = ".judges-correlations.json";
+// ─── Core ───────────────────────────────────────────────────────────────────
+function loadDb() {
+    if (!existsSync(CORRELATION_FILE))
+        return { links: [], rootCauses: [] };
+    return JSON.parse(readFileSync(CORRELATION_FILE, "utf-8"));
+}
+function saveDb(db) {
+    writeFileSync(CORRELATION_FILE, JSON.stringify(db, null, 2));
+}
+export function linkFindings(findingA, findingB, relationship, notes) {
+    const db = loadDb();
+    // Avoid duplicates
+    const existing = db.links.find((l) => (l.findingA === findingA && l.findingB === findingB) || (l.findingA === findingB && l.findingB === findingA));
+    if (existing) {
+        existing.relationship = relationship;
+        existing.notes = notes;
+        saveDb(db);
+        return existing;
+    }
+    const link = {
+        findingA,
+        findingB,
+        relationship,
+        notes,
+        createdAt: new Date().toISOString(),
+    };
+    db.links.push(link);
+    saveDb(db);
+    return link;
+}
+export function addRootCause(title, description, severity, findingIds) {
+    const db = loadDb();
+    const rootCause = {
+        id: `RC-${Date.now()}`,
+        title,
+        description,
+        relatedFindings: findingIds,
+        severity,
+        createdAt: new Date().toISOString(),
+    };
+    db.rootCauses.push(rootCause);
+    saveDb(db);
+    return rootCause;
+}
+export function autoCorrelate(findings) {
+    const newLinks = [];
+    const db = loadDb();
+    for (let i = 0; i < findings.length; i++) {
+        for (let j = i + 1; j < findings.length; j++) {
+            const a = findings[i];
+            const b = findings[j];
+            // Same rule → likely related
+            if (a.ruleId === b.ruleId) {
+                const link = {
+                    findingA: `${a.ruleId}:${a.title}`,
+                    findingB: `${b.ruleId}:${b.title}`,
+                    relationship: "related",
+                    notes: "Same rule ID",
+                    createdAt: new Date().toISOString(),
+                };
+                newLinks.push(link);
+            }
+            // Same line range → possibly duplicate
+            if (a.lineNumbers &&
+                b.lineNumbers &&
+                a.lineNumbers.length > 0 &&
+                b.lineNumbers.length > 0 &&
+                a.lineNumbers[0] === b.lineNumbers[0]) {
+                const link = {
+                    findingA: `${a.ruleId}:${a.title}`,
+                    findingB: `${b.ruleId}:${b.title}`,
+                    relationship: "duplicate",
+                    notes: `Same line: ${a.lineNumbers[0]}`,
+                    createdAt: new Date().toISOString(),
+                };
+                newLinks.push(link);
+            }
+        }
+    }
+    db.links.push(...newLinks);
+    saveDb(db);
+    return newLinks;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runCorrelate(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges correlate — Finding correlation and root-cause analysis
+
+Usage:
+  judges correlate --link <findingA> <findingB> --relationship related
+  judges correlate --root-cause "Missing input validation" --severity high --findings "F1,F2,F3"
+  judges correlate --auto                     Auto-correlate from results
+  judges correlate --graph                    Show correlation graph
+  judges correlate --root-causes              List root causes
+  judges correlate --stats                    Correlation statistics
+
+Options:
+  --link <A> <B>           Link two findings
+  --relationship <type>    same-root-cause | related | prerequisite | duplicate
+  --notes <text>           Optional notes on the link
+  --root-cause <title>     Create a root cause
+  --description <text>     Root cause description
+  --severity <level>       Root cause severity
+  --findings <csv>         Comma-separated finding IDs
+  --auto                   Auto-correlate findings
+  --graph                  Show relationship graph
+  --root-causes            List all root causes
+  --stats                  Show statistics
+  --format json            JSON output
+  --help, -h               Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    // Link findings
+    const linkIdx = argv.indexOf("--link");
+    if (linkIdx >= 0 && argv[linkIdx + 1] && argv[linkIdx + 2]) {
+        const findingA = argv[linkIdx + 1];
+        const findingB = argv[linkIdx + 2];
+        const rel = argv.find((_a, i) => argv[i - 1] === "--relationship") ||
+            "related";
+        const notes = argv.find((_a, i) => argv[i - 1] === "--notes");
+        const link = linkFindings(findingA, findingB, rel, notes);
+        if (format === "json") {
+            console.log(JSON.stringify(link, null, 2));
+        }
+        else {
+            console.log(`  ✅ Linked: ${findingA} ↔ ${findingB} (${rel})`);
+        }
+        return;
+    }
+    // Root cause
+    const rootTitle = argv.find((_a, i) => argv[i - 1] === "--root-cause");
+    if (rootTitle) {
+        const desc = argv.find((_a, i) => argv[i - 1] === "--description") || rootTitle;
+        const severity = argv.find((_a, i) => argv[i - 1] === "--severity") || "medium";
+        const findingsStr = argv.find((_a, i) => argv[i - 1] === "--findings") || "";
+        const findingIds = findingsStr.split(",").filter(Boolean);
+        const rc = addRootCause(rootTitle, desc, severity, findingIds);
+        if (format === "json") {
+            console.log(JSON.stringify(rc, null, 2));
+        }
+        else {
+            console.log(`  ✅ Root cause created: ${rc.id} — ${rc.title} (${rc.severity})`);
+            console.log(`     Related findings: ${rc.relatedFindings.length}`);
+        }
+        return;
+    }
+    // Auto correlate
+    if (argv.includes("--auto")) {
+        const resultsFile = ".judges-results.json";
+        if (!existsSync(resultsFile)) {
+            console.error("  ❌ No .judges-results.json found. Run an evaluation first.");
+            return;
+        }
+        try {
+            const data = JSON.parse(readFileSync(resultsFile, "utf-8"));
+            const findings = Array.isArray(data) ? data : data.findings || [];
+            const links = autoCorrelate(findings);
+            console.log(`  ✅ Auto-correlated ${links.length} link(s) from ${findings.length} findings`);
+        }
+        catch {
+            console.error("  ❌ Failed to parse results file");
+        }
+        return;
+    }
+    const db = loadDb();
+    // Root causes list
+    if (argv.includes("--root-causes")) {
+        if (format === "json") {
+            console.log(JSON.stringify(db.rootCauses, null, 2));
+        }
+        else if (db.rootCauses.length === 0) {
+            console.log("\n  No root causes identified.\n");
+        }
+        else {
+            console.log(`\n  Root Causes (${db.rootCauses.length})\n  ────────────`);
+            for (const rc of db.rootCauses) {
+                console.log(`    [${rc.severity.toUpperCase()}] ${rc.id} — ${rc.title} (${rc.relatedFindings.length} findings)`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    // Stats
+    if (argv.includes("--stats")) {
+        const stats = {
+            totalLinks: db.links.length,
+            rootCauses: db.rootCauses.length,
+            byRelationship: {
+                related: db.links.filter((l) => l.relationship === "related").length,
+                duplicate: db.links.filter((l) => l.relationship === "duplicate").length,
+                sameRootCause: db.links.filter((l) => l.relationship === "same-root-cause").length,
+                prerequisite: db.links.filter((l) => l.relationship === "prerequisite").length,
+            },
+        };
+        if (format === "json") {
+            console.log(JSON.stringify(stats, null, 2));
+        }
+        else {
+            console.log(`
+  Correlation Statistics
+  ──────────────────────
+  Total links:       ${stats.totalLinks}
+  Root causes:       ${stats.rootCauses}
+  Related:           ${stats.byRelationship.related}
+  Duplicates:        ${stats.byRelationship.duplicate}
+  Same root cause:   ${stats.byRelationship.sameRootCause}
+  Prerequisites:     ${stats.byRelationship.prerequisite}
+`);
+        }
+        return;
+    }
+    // Default: graph view
+    if (db.links.length === 0 && db.rootCauses.length === 0) {
+        console.log("\n  No correlations. Use --link or --auto to start.\n");
+        return;
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(db, null, 2));
+    }
+    else {
+        console.log(`\n  Correlation Graph (${db.links.length} links, ${db.rootCauses.length} root causes)\n  ────────────────────`);
+        for (const l of db.links.slice(0, 20)) {
+            const arrow = l.relationship === "prerequisite" ? "→" : "↔";
+            console.log(`    ${l.findingA} ${arrow} ${l.findingB} [${l.relationship}]`);
+        }
+        if (db.links.length > 20)
+            console.log(`    ... and ${db.links.length - 20} more`);
+        console.log("");
+    }
+}
+//# sourceMappingURL=correlate.js.map

package/dist/commands/correlate.js.map

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

package/dist/commands/digest.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Periodic report builder — weekly/daily digest generation
+ * with trend summaries, comparisons, and distribution.
+ *
+ * Stored locally in .judges-digest.json.
+ */
+interface DigestSnapshot {
+    date: string;
+    critical: number;
+    high: number;
+    medium: number;
+    low: number;
+    total: number;
+    resolved: number;
+    newFindings: number;
+}
+export declare function addSnapshot(snapshot: Omit<DigestSnapshot, "date">): DigestSnapshot;
+export declare function runDigest(argv: string[]): void;
+export {};
+//# sourceMappingURL=digest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/commands/digest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AA+BD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,cAAc,CAMlF;AAgFD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAwI9C"}

package/dist/commands/digest.js

@@ -0,0 +1,222 @@
+/**
+ * Periodic report builder — weekly/daily digest generation
+ * with trend summaries, comparisons, and distribution.
+ *
+ * Stored locally in .judges-digest.json.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+const DIGEST_FILE = ".judges-digest.json";
+// ─── Core ───────────────────────────────────────────────────────────────────
+function loadDb() {
+    if (!existsSync(DIGEST_FILE))
+        return {
+            snapshots: [],
+            config: { frequency: "weekly", includeResolved: true, includeTrends: true },
+        };
+    return JSON.parse(readFileSync(DIGEST_FILE, "utf-8"));
+}
+function saveDb(db) {
+    writeFileSync(DIGEST_FILE, JSON.stringify(db, null, 2));
+}
+export function addSnapshot(snapshot) {
+    const db = loadDb();
+    const entry = { ...snapshot, date: new Date().toISOString().split("T")[0] };
+    db.snapshots.push(entry);
+    saveDb(db);
+    return entry;
+}
+function generateDigestReport(db, period) {
+    const lines = [];
+    const now = new Date();
+    let cutoff;
+    switch (period) {
+        case "daily":
+            cutoff = new Date(now.getTime() - 86400000);
+            break;
+        case "weekly":
+            cutoff = new Date(now.getTime() - 7 * 86400000);
+            break;
+        case "monthly":
+            cutoff = new Date(now.getTime() - 30 * 86400000);
+            break;
+        default:
+            cutoff = new Date(now.getTime() - 7 * 86400000);
+    }
+    const recent = db.snapshots.filter((s) => new Date(s.date) >= cutoff);
+    const older = db.snapshots.filter((s) => new Date(s.date) < cutoff);
+    lines.push(`# Judges Digest — ${period.charAt(0).toUpperCase() + period.slice(1)} Report`);
+    lines.push(`> Generated: ${now.toISOString()}\n`);
+    if (recent.length === 0) {
+        lines.push("No data for this period. Use `judges digest --snapshot` to record findings.\n");
+        return lines.join("\n");
+    }
+    const latest = recent[recent.length - 1];
+    lines.push("## Current Status");
+    lines.push(`| Severity | Count |`);
+    lines.push(`|----------|-------|`);
+    lines.push(`| Critical | ${latest.critical} |`);
+    lines.push(`| High     | ${latest.high} |`);
+    lines.push(`| Medium   | ${latest.medium} |`);
+    lines.push(`| Low      | ${latest.low} |`);
+    lines.push(`| **Total** | **${latest.total}** |`);
+    lines.push("");
+    if (db.config.includeTrends && recent.length >= 2) {
+        const first = recent[0];
+        const delta = latest.total - first.total;
+        const arrow = delta > 0 ? "📈" : delta < 0 ? "📉" : "➡️";
+        lines.push("## Trend");
+        lines.push(`- Period: ${first.date} → ${latest.date}`);
+        lines.push(`- Change: ${delta > 0 ? "+" : ""}${delta} findings ${arrow}`);
+        lines.push(`- New:     ${recent.reduce((s, r) => s + r.newFindings, 0)}`);
+        lines.push(`- Resolved: ${recent.reduce((s, r) => s + r.resolved, 0)}`);
+        lines.push("");
+    }
+    if (db.config.includeResolved && older.length > 0) {
+        const prevTotal = older[older.length - 1].total;
+        lines.push("## Comparison with Previous Period");
+        lines.push(`- Previous total: ${prevTotal}`);
+        lines.push(`- Current total:  ${latest.total}`);
+        lines.push(`- Net change:     ${latest.total - prevTotal}`);
+        lines.push("");
+    }
+    // Sparkline-style chart
+    if (recent.length >= 3) {
+        lines.push("## Trend Chart");
+        const max = Math.max(...recent.map((r) => r.total), 1);
+        for (const s of recent) {
+            const bar = "█".repeat(Math.max(1, Math.round((s.total / max) * 30)));
+            lines.push(`  ${s.date}  ${bar} ${s.total}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runDigest(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges digest — Periodic finding digest and trend reports
+
+Usage:
+  judges digest --snapshot --critical 2 --high 5 --medium 10 --low 3 --resolved 4 --new 3
+  judges digest --generate weekly
+  judges digest --generate daily --output report.md
+  judges digest --configure --frequency weekly
+  judges digest --history
+  judges digest --stats
+
+Options:
+  --snapshot             Record a point-in-time snapshot
+    --critical <n>       Critical count
+    --high <n>           High count
+    --medium <n>         Medium count
+    --low <n>            Low count
+    --resolved <n>       Resolved since last snapshot
+    --new <n>            New findings since last snapshot
+  --generate <period>    Generate digest: daily | weekly | monthly
+  --output <file>        Write report to file
+  --configure            Update digest configuration
+    --frequency <freq>   daily | weekly | monthly
+  --history              Show snapshot history
+  --stats                Summary statistics
+  --format json          JSON output
+  --help, -h             Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    // Record snapshot
+    if (argv.includes("--snapshot")) {
+        const getNum = (flag) => {
+            const val = argv.find((_a, i) => argv[i - 1] === flag);
+            return val ? parseInt(val, 10) : 0;
+        };
+        const snapshot = addSnapshot({
+            critical: getNum("--critical"),
+            high: getNum("--high"),
+            medium: getNum("--medium"),
+            low: getNum("--low"),
+            total: getNum("--critical") + getNum("--high") + getNum("--medium") + getNum("--low"),
+            resolved: getNum("--resolved"),
+            newFindings: getNum("--new"),
+        });
+        if (format === "json") {
+            console.log(JSON.stringify(snapshot, null, 2));
+        }
+        else {
+            console.log(`  ✅ Snapshot recorded: ${snapshot.date} — ${snapshot.total} findings (${snapshot.newFindings} new, ${snapshot.resolved} resolved)`);
+        }
+        return;
+    }
+    // Generate digest
+    const period = argv.find((_a, i) => argv[i - 1] === "--generate");
+    if (period) {
+        const db = loadDb();
+        const report = generateDigestReport(db, period);
+        const outputFile = argv.find((_a, i) => argv[i - 1] === "--output");
+        if (outputFile) {
+            writeFileSync(outputFile, report);
+            console.log(`  ✅ Digest written to ${outputFile}`);
+        }
+        else {
+            console.log(report);
+        }
+        return;
+    }
+    // Configure
+    if (argv.includes("--configure")) {
+        const db = loadDb();
+        const freq = argv.find((_a, i) => argv[i - 1] === "--frequency");
+        if (freq)
+            db.config.frequency = freq;
+        saveDb(db);
+        console.log(`  ✅ Digest configured: frequency=${db.config.frequency}`);
+        return;
+    }
+    const db = loadDb();
+    // History
+    if (argv.includes("--history")) {
+        if (format === "json") {
+            console.log(JSON.stringify(db.snapshots, null, 2));
+        }
+        else if (db.snapshots.length === 0) {
+            console.log("\n  No snapshots. Use --snapshot to record.\n");
+        }
+        else {
+            console.log(`\n  Snapshot History (${db.snapshots.length})\n  ─────────────────`);
+            for (const s of db.snapshots.slice(-20)) {
+                console.log(`    ${s.date}  C:${s.critical} H:${s.high} M:${s.medium} L:${s.low} (${s.total} total, +${s.newFindings} -${s.resolved})`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    // Stats
+    if (argv.includes("--stats") || db.snapshots.length > 0) {
+        if (db.snapshots.length === 0) {
+            console.log("\n  No digest data. Use --snapshot to start tracking.\n");
+            return;
+        }
+        const latest = db.snapshots[db.snapshots.length - 1];
+        const totalResolved = db.snapshots.reduce((s, snap) => s + snap.resolved, 0);
+        const totalNew = db.snapshots.reduce((s, snap) => s + snap.newFindings, 0);
+        if (format === "json") {
+            console.log(JSON.stringify({ latest, totalResolved, totalNew, snapshots: db.snapshots.length }, null, 2));
+        }
+        else {
+            console.log(`
+  Digest Summary
+  ──────────────
+  Snapshots:      ${db.snapshots.length}
+  Latest total:   ${latest.total} (${latest.date})
+  Total resolved: ${totalResolved}
+  Total new:      ${totalNew}
+  Net change:     ${totalNew - totalResolved}
+  Frequency:      ${db.config.frequency}
+`);
+        }
+        return;
+    }
+    console.log("\n  No digest data. Use --snapshot to start tracking, then --generate to create reports.\n");
+}
+//# sourceMappingURL=digest.js.map

package/dist/commands/digest.js.map

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

package/dist/commands/explain-finding.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Detailed finding explanation — provide rich context, references,
+ * and remediation guidance for individual findings.
+ */
+import type { Finding } from "../types.js";
+export declare function explainFinding(finding: Finding): string;
+export declare function runExplainFinding(argv: string[]): void;
+//# sourceMappingURL=explain-finding.d.ts.map

package/dist/commands/explain-finding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-finding.d.ts","sourceRoot":"","sources":["../../src/commands/explain-finding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAgH3C,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAkEvD;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAgHtD"}