@kevinrabun/judges 3.43.0 → 3.45.0

package/dist/commands/burndown.js

@@ -0,0 +1,180 @@
+/**
+ * Burndown — track finding resolution progress over time and
+ * visualize whether the team is on track to meet targets.
+ *
+ * Data stored locally in .judges-burndown.json.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+const BURNDOWN_FILE = ".judges-burndown.json";
+// ─── Core ───────────────────────────────────────────────────────────────────
+function loadDb(file = BURNDOWN_FILE) {
+    if (!existsSync(file))
+        return { entries: [] };
+    return JSON.parse(readFileSync(file, "utf-8"));
+}
+function saveDb(db, file = BURNDOWN_FILE) {
+    writeFileSync(file, JSON.stringify(db, null, 2));
+}
+function getGitCommit() {
+    try {
+        const { execSync } = require("child_process");
+        return execSync("git rev-parse --short HEAD", { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+export function recordSnapshot(findings) {
+    const db = loadDb();
+    const now = new Date();
+    const bySeverity = {};
+    for (const f of findings) {
+        bySeverity[f.severity] = (bySeverity[f.severity] || 0) + 1;
+    }
+    const entry = {
+        timestamp: now.toISOString(),
+        date: now.toISOString().split("T")[0],
+        totalFindings: findings.length,
+        bySeverity,
+        gitCommit: getGitCommit(),
+    };
+    db.entries.push(entry);
+    // Keep last 365 entries max
+    if (db.entries.length > 365) {
+        db.entries = db.entries.slice(-365);
+    }
+    saveDb(db);
+    return entry;
+}
+export function setTarget(count, deadline) {
+    const db = loadDb();
+    db.target = { count, deadline };
+    saveDb(db);
+}
+export function getBurndownData() {
+    return loadDb();
+}
+function renderChart(db) {
+    if (db.entries.length === 0)
+        return "  No data points. Run evaluations to populate.";
+    const lines = [];
+    const maxFindings = Math.max(...db.entries.map((e) => e.totalFindings), 1);
+    const chartWidth = 50;
+    const recent = db.entries.slice(-20); // Last 20 entries
+    for (const entry of recent) {
+        const barLen = Math.round((entry.totalFindings / maxFindings) * chartWidth);
+        const bar = "█".repeat(barLen) + "░".repeat(chartWidth - barLen);
+        lines.push(`  ${entry.date}  ${bar}  ${entry.totalFindings}`);
+    }
+    return lines.join("\n");
+}
+function calculateTrajectory(db) {
+    if (db.entries.length < 2)
+        return "  Need at least 2 data points for trajectory.";
+    const first = db.entries[0];
+    const last = db.entries[db.entries.length - 1];
+    const daysBetween = (new Date(last.timestamp).getTime() - new Date(first.timestamp).getTime()) / 86_400_000;
+    const delta = last.totalFindings - first.totalFindings;
+    const ratePerDay = daysBetween > 0 ? Math.round((delta / daysBetween) * 10) / 10 : 0;
+    const parts = [
+        `  Start: ${first.totalFindings} findings (${first.date})`,
+        `  Now:   ${last.totalFindings} findings (${last.date})`,
+        `  Rate:  ${ratePerDay >= 0 ? "+" : ""}${ratePerDay}/day`,
+    ];
+    if (db.target) {
+        const remaining = last.totalFindings - db.target.count;
+        if (remaining <= 0) {
+            parts.push(`  Target: ${db.target.count} by ${db.target.deadline} — ✅ ACHIEVED`);
+        }
+        else if (ratePerDay >= 0) {
+            parts.push(`  Target: ${db.target.count} by ${db.target.deadline} — ⚠️ Findings increasing`);
+        }
+        else {
+            const daysNeeded = Math.abs(Math.ceil(remaining / ratePerDay));
+            const eta = new Date();
+            eta.setDate(eta.getDate() + daysNeeded);
+            const onTrack = eta.getTime() <= new Date(db.target.deadline).getTime();
+            parts.push(`  Target: ${db.target.count} by ${db.target.deadline} — ${onTrack ? "✅ On track" : "⚠️ Behind schedule"}`, `  ETA:    ${eta.toISOString().split("T")[0]} (${daysNeeded} days at current rate)`);
+        }
+    }
+    return parts.join("\n");
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export async function runBurndown(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges burndown — Track finding resolution progress
+
+Usage:
+  judges burndown --record --input results.json    Record a data point
+  judges burndown --show                           Show burndown chart
+  judges burndown --set-target 50 --deadline 2025-06-01
+  judges burndown --trajectory                     Show trajectory analysis
+
+Options:
+  --record              Record current findings as data point
+  --input <path>        Results JSON file
+  --show                Display burndown chart
+  --set-target <n>      Set target finding count
+  --deadline <date>     Target deadline (YYYY-MM-DD)
+  --trajectory          Show rate and ETA analysis
+  --format json         JSON output
+  --help, -h            Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    // Record snapshot
+    const inputPath = argv.find((_a, i) => argv[i - 1] === "--input");
+    if (argv.includes("--record") && inputPath) {
+        if (!existsSync(inputPath)) {
+            console.error(`Error: file not found: ${inputPath}`);
+            process.exit(1);
+        }
+        const data = JSON.parse(readFileSync(inputPath, "utf-8"));
+        const findings = data.evaluations
+            ? data.evaluations.flatMap((e) => e.findings || [])
+            : data.findings || data;
+        const entry = recordSnapshot(findings);
+        if (format === "json") {
+            console.log(JSON.stringify(entry, null, 2));
+        }
+        else {
+            console.log(`  Recorded: ${entry.totalFindings} findings on ${entry.date}`);
+        }
+        return;
+    }
+    // Set target
+    const targetStr = argv.find((_a, i) => argv[i - 1] === "--set-target");
+    const deadline = argv.find((_a, i) => argv[i - 1] === "--deadline");
+    if (targetStr && deadline) {
+        setTarget(parseInt(targetStr, 10), deadline);
+        console.log(`  Target set: ${targetStr} findings by ${deadline}`);
+        return;
+    }
+    const db = getBurndownData();
+    // Trajectory
+    if (argv.includes("--trajectory")) {
+        if (format === "json") {
+            console.log(JSON.stringify(db, null, 2));
+        }
+        else {
+            console.log("\n  Trajectory Analysis\n  ───────────────────");
+            console.log(calculateTrajectory(db));
+            console.log("");
+        }
+        return;
+    }
+    // Show chart (default)
+    if (format === "json") {
+        console.log(JSON.stringify(db, null, 2));
+    }
+    else {
+        console.log("\n  Finding Burndown\n  ────────────────");
+        console.log(renderChart(db));
+        console.log("");
+        console.log(calculateTrajectory(db));
+        console.log("");
+    }
+}
+//# sourceMappingURL=burndown.js.map

package/dist/commands/burndown.js.map

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

package/dist/commands/compare-runs.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Compare evaluation runs — side-by-side comparison of two evaluation
+ * snapshots to show what changed.
+ *
+ * Uses local .judges-runs/ directory.
+ */
+import type { Finding } from "../types.js";
+interface RunSnapshot {
+    id: string;
+    label?: string;
+    timestamp: string;
+    findings: Finding[];
+    summary: {
+        total: number;
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+}
+interface RunComparison {
+    runA: string;
+    runB: string;
+    added: Finding[];
+    removed: Finding[];
+    unchanged: number;
+    severityDelta: Record<string, number>;
+    ruleChanges: Record<string, {
+        added: number;
+        removed: number;
+    }>;
+}
+export declare function saveRun(findings: Finding[], label?: string): RunSnapshot;
+export declare function listRuns(): RunSnapshot[];
+export declare function compareRuns(runAId: string, runBId: string): RunComparison;
+export declare function runCompareRuns(argv: string[]): void;
+export {};
+//# sourceMappingURL=compare-runs.d.ts.map

package/dist/commands/compare-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-runs.d.ts","sourceRoot":"","sources":["../../src/commands/compare-runs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE;AAcD,wBAAgB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,CAkBxE;AAED,wBAAgB,QAAQ,IAAI,WAAW,EAAE,CAMxC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CA6CzE;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6GnD"}

package/dist/commands/compare-runs.js

@@ -0,0 +1,229 @@
+/**
+ * Compare evaluation runs — side-by-side comparison of two evaluation
+ * snapshots to show what changed.
+ *
+ * Uses local .judges-runs/ directory.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs";
+import { join } from "path";
+const RUNS_DIR = ".judges-runs";
+// ─── Core ───────────────────────────────────────────────────────────────────
+function ensureDir() {
+    if (!existsSync(RUNS_DIR))
+        mkdirSync(RUNS_DIR, { recursive: true });
+}
+function findingKey(f) {
+    return `${f.ruleId}:${f.title}:${(f.lineNumbers || []).join(",")}`;
+}
+export function saveRun(findings, label) {
+    ensureDir();
+    const id = `run-${Date.now()}`;
+    const snapshot = {
+        id,
+        label,
+        timestamp: new Date().toISOString(),
+        findings,
+        summary: {
+            total: findings.length,
+            critical: findings.filter((f) => f.severity === "critical").length,
+            high: findings.filter((f) => f.severity === "high").length,
+            medium: findings.filter((f) => f.severity === "medium").length,
+            low: findings.filter((f) => f.severity === "low").length,
+        },
+    };
+    writeFileSync(join(RUNS_DIR, `${id}.json`), JSON.stringify(snapshot, null, 2));
+    return snapshot;
+}
+export function listRuns() {
+    ensureDir();
+    const files = readdirSync(RUNS_DIR)
+        .filter((f) => f.endsWith(".json"))
+        .sort();
+    return files.map((f) => JSON.parse(readFileSync(join(RUNS_DIR, f), "utf-8")));
+}
+export function compareRuns(runAId, runBId) {
+    const runA = JSON.parse(readFileSync(join(RUNS_DIR, `${runAId}.json`), "utf-8"));
+    const runB = JSON.parse(readFileSync(join(RUNS_DIR, `${runBId}.json`), "utf-8"));
+    const keysA = new Set(runA.findings.map(findingKey));
+    const keysB = new Set(runB.findings.map(findingKey));
+    const findingsMapA = new Map(runA.findings.map((f) => [findingKey(f), f]));
+    const findingsMapB = new Map(runB.findings.map((f) => [findingKey(f), f]));
+    const added = [];
+    const removed = [];
+    let unchanged = 0;
+    for (const key of keysB) {
+        if (!keysA.has(key)) {
+            added.push(findingsMapB.get(key));
+        }
+        else {
+            unchanged++;
+        }
+    }
+    for (const key of keysA) {
+        if (!keysB.has(key)) {
+            removed.push(findingsMapA.get(key));
+        }
+    }
+    const severityDelta = {
+        critical: runB.summary.critical - runA.summary.critical,
+        high: runB.summary.high - runA.summary.high,
+        medium: runB.summary.medium - runA.summary.medium,
+        low: runB.summary.low - runA.summary.low,
+    };
+    // Rule-level changes
+    const ruleChanges = {};
+    for (const f of added) {
+        if (!ruleChanges[f.ruleId])
+            ruleChanges[f.ruleId] = { added: 0, removed: 0 };
+        ruleChanges[f.ruleId].added++;
+    }
+    for (const f of removed) {
+        if (!ruleChanges[f.ruleId])
+            ruleChanges[f.ruleId] = { added: 0, removed: 0 };
+        ruleChanges[f.ruleId].removed++;
+    }
+    return { runA: runAId, runB: runBId, added, removed, unchanged, severityDelta, ruleChanges };
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runCompareRuns(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges compare-runs — Compare evaluation runs side by side
+
+Usage:
+  judges compare-runs --save                    Save current results as a run
+  judges compare-runs --save --label "baseline" Save with label
+  judges compare-runs --list                    List saved runs
+  judges compare-runs --compare <runA> <runB>   Compare two runs
+  judges compare-runs --latest                  Compare last two runs
+
+Options:
+  --save                 Save .judges-results.json as a run snapshot
+  --label <text>         Label for the snapshot
+  --list                 List all saved runs
+  --compare <A> <B>      Compare two run IDs
+  --latest               Compare the two most recent runs
+  --format json          JSON output
+  --help, -h             Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    // Save run
+    if (argv.includes("--save")) {
+        const resultsFile = ".judges-results.json";
+        if (!existsSync(resultsFile)) {
+            console.error("  ❌ No .judges-results.json found. Run an evaluation first.");
+            return;
+        }
+        const data = JSON.parse(readFileSync(resultsFile, "utf-8"));
+        const findings = Array.isArray(data) ? data : data.findings || [];
+        const label = argv.find((_a, i) => argv[i - 1] === "--label");
+        const run = saveRun(findings, label);
+        if (format === "json") {
+            console.log(JSON.stringify(run, null, 2));
+        }
+        else {
+            console.log(`  ✅ Run saved: ${run.id}${label ? ` (${label})` : ""} — ${run.summary.total} findings`);
+        }
+        return;
+    }
+    // List runs
+    if (argv.includes("--list")) {
+        const runs = listRuns();
+        if (runs.length === 0) {
+            console.log("\n  No runs saved. Use --save to capture a snapshot.\n");
+            return;
+        }
+        if (format === "json") {
+            console.log(JSON.stringify(runs.map((r) => ({ id: r.id, label: r.label, timestamp: r.timestamp, total: r.summary.total })), null, 2));
+        }
+        else {
+            console.log(`\n  Saved Runs (${runs.length})\n  ──────────────`);
+            for (const r of runs) {
+                const lbl = r.label ? ` (${r.label})` : "";
+                console.log(`    ${r.id}${lbl}  ${r.timestamp.split("T")[0]}  ${r.summary.total} findings`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    // Compare latest
+    if (argv.includes("--latest")) {
+        const runs = listRuns();
+        if (runs.length < 2) {
+            console.error("  ❌ Need at least 2 saved runs. Use --save to capture more.");
+            return;
+        }
+        const comparison = compareRuns(runs[runs.length - 2].id, runs[runs.length - 1].id);
+        printComparison(comparison, format);
+        return;
+    }
+    // Compare specific runs
+    const compareIdx = argv.indexOf("--compare");
+    if (compareIdx >= 0 && argv[compareIdx + 1] && argv[compareIdx + 2]) {
+        const runAId = argv[compareIdx + 1];
+        const runBId = argv[compareIdx + 2];
+        try {
+            const comparison = compareRuns(runAId, runBId);
+            printComparison(comparison, format);
+        }
+        catch {
+            console.error(`  ❌ Could not load runs. Check IDs with --list.`);
+        }
+        return;
+    }
+    // Default: show latest
+    const runs = listRuns();
+    if (runs.length === 0) {
+        console.log("\n  No runs saved. Use --save to start tracking.\n");
+    }
+    else {
+        const latest = runs[runs.length - 1];
+        console.log(`\n  Latest Run: ${latest.id}${latest.label ? ` (${latest.label})` : ""}`);
+        console.log(`  Date: ${latest.timestamp}`);
+        console.log(`  Findings: ${latest.summary.total} (C:${latest.summary.critical} H:${latest.summary.high} M:${latest.summary.medium} L:${latest.summary.low})\n`);
+    }
+}
+function printComparison(comp, format) {
+    if (format === "json") {
+        console.log(JSON.stringify(comp, null, 2));
+        return;
+    }
+    console.log(`\n  Run Comparison: ${comp.runA} → ${comp.runB}`);
+    console.log(`  ────────────────────────────────────────`);
+    console.log(`  Unchanged: ${comp.unchanged}`);
+    console.log(`  Added:     ${comp.added.length}`);
+    console.log(`  Removed:   ${comp.removed.length}`);
+    console.log("");
+    console.log("  Severity Changes:");
+    for (const [sev, delta] of Object.entries(comp.severityDelta)) {
+        const sign = delta > 0 ? "+" : "";
+        const icon = delta > 0 ? "📈" : delta < 0 ? "📉" : "➡️";
+        console.log(`    ${sev.padEnd(10)} ${sign}${delta} ${icon}`);
+    }
+    if (comp.added.length > 0) {
+        console.log("\n  New Findings:");
+        for (const f of comp.added.slice(0, 10)) {
+            console.log(`    + [${f.severity.toUpperCase()}] ${f.ruleId} — ${f.title.slice(0, 50)}`);
+        }
+        if (comp.added.length > 10)
+            console.log(`    ... and ${comp.added.length - 10} more`);
+    }
+    if (comp.removed.length > 0) {
+        console.log("\n  Resolved Findings:");
+        for (const f of comp.removed.slice(0, 10)) {
+            console.log(`    - [${f.severity.toUpperCase()}] ${f.ruleId} — ${f.title.slice(0, 50)}`);
+        }
+        if (comp.removed.length > 10)
+            console.log(`    ... and ${comp.removed.length - 10} more`);
+    }
+    if (Object.keys(comp.ruleChanges).length > 0) {
+        console.log("\n  Rule Changes:");
+        for (const [rule, changes] of Object.entries(comp.ruleChanges)) {
+            console.log(`    ${rule.padEnd(15)} +${changes.added} / -${changes.removed}`);
+        }
+    }
+    console.log("");
+}
+//# sourceMappingURL=compare-runs.js.map

package/dist/commands/compare-runs.js.map

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

package/dist/commands/correlate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Finding correlation — link related findings, identify root causes,
+ * and detect systemic patterns across evaluations.
+ *
+ * Stored locally in .judges-correlations.json.
+ */
+import type { Finding } from "../types.js";
+interface CorrelationLink {
+    findingA: string;
+    findingB: string;
+    relationship: "same-root-cause" | "related" | "prerequisite" | "duplicate";
+    notes?: string;
+    createdAt: string;
+}
+interface RootCause {
+    id: string;
+    title: string;
+    description: string;
+    relatedFindings: string[];
+    severity: "critical" | "high" | "medium" | "low";
+    createdAt: string;
+}
+export declare function linkFindings(findingA: string, findingB: string, relationship: CorrelationLink["relationship"], notes?: string): CorrelationLink;
+export declare function addRootCause(title: string, description: string, severity: RootCause["severity"], findingIds: string[]): RootCause;
+export declare function autoCorrelate(findings: Finding[]): CorrelationLink[];
+export declare function runCorrelate(argv: string[]): void;
+export {};
+//# sourceMappingURL=correlate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"correlate.d.ts","sourceRoot":"","sources":["../../src/commands/correlate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,UAAU,eAAe;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAAG,cAAc,GAAG,WAAW,CAAC;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAoBD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,EAC7C,KAAK,CAAC,EAAE,MAAM,GACb,eAAe,CAuBjB;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAC/B,UAAU,EAAE,MAAM,EAAE,GACnB,SAAS,CAaX;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CA4CpE;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA4JjD"}