@kevinrabun/judges 3.65.0 → 3.67.0

package/dist/commands/finding-timeline.js

@@ -0,0 +1,144 @@
+/**
+ * Finding-timeline — Track finding trends across commits over time.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { execSync } from "child_process";
+import { join, dirname } from "path";
+// ─── Storage ────────────────────────────────────────────────────────────────
+const TIMELINE_FILE = join(".judges", "finding-timeline.json");
+function loadTimeline() {
+    if (!existsSync(TIMELINE_FILE))
+        return { version: "1.0.0", entries: [] };
+    try {
+        return JSON.parse(readFileSync(TIMELINE_FILE, "utf-8"));
+    }
+    catch {
+        return { version: "1.0.0", entries: [] };
+    }
+}
+function saveTimeline(store) {
+    mkdirSync(dirname(TIMELINE_FILE), { recursive: true });
+    writeFileSync(TIMELINE_FILE, JSON.stringify(store, null, 2), "utf-8");
+}
+function countBySeverity(findings) {
+    const counts = {};
+    for (const f of findings) {
+        const sev = f.severity || "unknown";
+        counts[sev] = (counts[sev] || 0) + 1;
+    }
+    return counts;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runFindingTimeline(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges finding-timeline — Track finding trends across commits
+
+Usage:
+  judges finding-timeline record --file verdict.json --label "v1.0"
+  judges finding-timeline show
+  judges finding-timeline show --last 10
+  judges finding-timeline clear
+
+Subcommands:
+  record               Record a data point from a verdict
+  show                 Show timeline with trend visualization
+  clear                Clear all timeline data
+
+Options:
+  --file <path>         Verdict JSON (for record)
+  --label <text>        Label for this data point
+  --commit <hash>       Git commit hash (auto-detected if omitted)
+  --last <n>            Show only last N entries
+  --format json         JSON output
+  --help, -h            Show this help
+
+Tracks findings over time to show improvement trends.
+Data is stored locally in .judges/finding-timeline.json.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const subcommand = argv.find((a) => ["record", "show", "clear"].includes(a)) || "show";
+    const store = loadTimeline();
+    if (subcommand === "record") {
+        const file = argv.find((_a, i) => argv[i - 1] === "--file");
+        if (!file || !existsSync(file)) {
+            console.error("Error: --file with a valid verdict JSON is required.");
+            process.exitCode = 1;
+            return;
+        }
+        let verdict;
+        try {
+            verdict = JSON.parse(readFileSync(file, "utf-8"));
+        }
+        catch {
+            console.error(`Error: Could not parse ${file}`);
+            process.exitCode = 1;
+            return;
+        }
+        const label = argv.find((_a, i) => argv[i - 1] === "--label") || `entry-${store.entries.length + 1}`;
+        let commit = argv.find((_a, i) => argv[i - 1] === "--commit") || "";
+        if (!commit) {
+            try {
+                commit = execSync("git rev-parse --short HEAD", { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+            }
+            catch {
+                commit = "unknown";
+            }
+        }
+        const findings = verdict.findings || [];
+        const entry = {
+            id: `tl-${Date.now().toString(36)}`,
+            timestamp: new Date().toISOString(),
+            commit,
+            label,
+            totalFindings: findings.length,
+            bySeverity: countBySeverity(findings),
+            score: verdict.overallScore || 0,
+        };
+        store.entries.push(entry);
+        saveTimeline(store);
+        console.log(`Recorded timeline entry '${label}' — ${findings.length} findings, score ${entry.score}`);
+        return;
+    }
+    if (subcommand === "clear") {
+        saveTimeline({ version: "1.0.0", entries: [] });
+        console.log("Timeline cleared.");
+        return;
+    }
+    // Show
+    const lastN = parseInt(argv.find((_a, i) => argv[i - 1] === "--last") || "0", 10);
+    const entries = lastN > 0 ? store.entries.slice(-lastN) : store.entries;
+    if (format === "json") {
+        console.log(JSON.stringify({ total: store.entries.length, shown: entries.length, entries }, null, 2));
+        return;
+    }
+    console.log(`\n  Finding Timeline (${entries.length} entries)\n  ═════════════════════════════`);
+    if (entries.length === 0) {
+        console.log("    No data. Record with: judges finding-timeline record --file verdict.json");
+        console.log();
+        return;
+    }
+    // ASCII chart
+    const maxFindings = Math.max(...entries.map((e) => e.totalFindings), 1);
+    const barWidth = 30;
+    for (const entry of entries) {
+        const barLen = Math.round((entry.totalFindings / maxFindings) * barWidth);
+        const bar = "█".repeat(barLen) + "░".repeat(barWidth - barLen);
+        const date = entry.timestamp.slice(0, 10);
+        console.log(`    ${date} ${entry.label.padEnd(15)} ${bar} ${entry.totalFindings} findings (score: ${entry.score})`);
+    }
+    // Show trend
+    if (entries.length >= 2) {
+        const first = entries[0];
+        const last = entries[entries.length - 1];
+        const delta = last.totalFindings - first.totalFindings;
+        const scoreDelta = last.score - first.score;
+        console.log();
+        console.log(`    Trend: findings ${delta >= 0 ? "+" : ""}${delta}, score ${scoreDelta >= 0 ? "+" : ""}${scoreDelta}`);
+        console.log(`    ${delta <= 0 && scoreDelta >= 0 ? "📈 Improving" : delta > 0 ? "📉 Declining" : "➡️ Stable"}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=finding-timeline.js.map

package/dist/commands/finding-timeline.js.map

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

package/dist/commands/fix-verify.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Fix-verify — Re-run review on fixed code to confirm findings are resolved.
+ */
+export declare function runFixVerify(argv: string[]): void;
+//# sourceMappingURL=fix-verify.d.ts.map

package/dist/commands/fix-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-verify.d.ts","sourceRoot":"","sources":["../../src/commands/fix-verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAwDH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAoGjD"}

package/dist/commands/fix-verify.js

@@ -0,0 +1,124 @@
+/**
+ * Fix-verify — Re-run review on fixed code to confirm findings are resolved.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { dirname } from "path";
+// ─── Matching ───────────────────────────────────────────────────────────────
+function findingKey(f) {
+    return [f.ruleId || "", f.title || "", String(f.severity || "")].join("|").toLowerCase();
+}
+function compareVerdicts(original, updated) {
+    const origFindings = original.findings || [];
+    const updFindings = updated.findings || [];
+    const origKeys = new Set(origFindings.map(findingKey));
+    const updKeys = new Set(updFindings.map(findingKey));
+    const resolved = origFindings.filter((f) => !updKeys.has(findingKey(f)));
+    const remaining = origFindings.filter((f) => updKeys.has(findingKey(f)));
+    const newFindings = updFindings.filter((f) => !origKeys.has(findingKey(f)));
+    const resolutionRate = origFindings.length > 0 ? Math.round((resolved.length / origFindings.length) * 100) : 100;
+    return {
+        timestamp: new Date().toISOString(),
+        originalFile: "",
+        originalCount: origFindings.length,
+        resolvedCount: resolved.length,
+        remainingCount: remaining.length,
+        newCount: newFindings.length,
+        resolved,
+        remaining,
+        newFindings,
+        resolutionRate,
+    };
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runFixVerify(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges fix-verify — Verify that fixes resolved findings
+
+Usage:
+  judges fix-verify --original before.json --updated after.json
+  judges fix-verify --original before.json --updated after.json --output report.json
+
+Options:
+  --original <path>     Original verdict JSON (before fixes)
+  --updated <path>      Updated verdict JSON (after fixes)
+  --output <path>       Write verification report to file
+  --format json         JSON output
+  --help, -h            Show this help
+
+Compares two verdict files to show which findings were resolved,
+which remain, and whether new findings were introduced.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const originalFile = argv.find((_a, i) => argv[i - 1] === "--original");
+    const updatedFile = argv.find((_a, i) => argv[i - 1] === "--updated");
+    const outputFile = argv.find((_a, i) => argv[i - 1] === "--output");
+    if (!originalFile || !updatedFile) {
+        console.error("Error: Both --original and --updated are required.");
+        process.exitCode = 1;
+        return;
+    }
+    if (!existsSync(originalFile)) {
+        console.error(`Error: File not found: ${originalFile}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!existsSync(updatedFile)) {
+        console.error(`Error: File not found: ${updatedFile}`);
+        process.exitCode = 1;
+        return;
+    }
+    let original;
+    let updated;
+    try {
+        original = JSON.parse(readFileSync(originalFile, "utf-8"));
+        updated = JSON.parse(readFileSync(updatedFile, "utf-8"));
+    }
+    catch {
+        console.error("Error: Could not parse verdict files.");
+        process.exitCode = 1;
+        return;
+    }
+    const result = compareVerdicts(original, updated);
+    result.originalFile = originalFile;
+    if (outputFile) {
+        mkdirSync(dirname(outputFile), { recursive: true });
+        writeFileSync(outputFile, JSON.stringify(result, null, 2), "utf-8");
+        console.log(`Verification report written to ${outputFile}`);
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`\n  Fix Verification Report\n  ═════════════════════════════`);
+    console.log(`    Original findings: ${result.originalCount}`);
+    console.log(`    Resolved: ${result.resolvedCount} ✅`);
+    console.log(`    Remaining: ${result.remainingCount} ⚠️`);
+    console.log(`    New findings: ${result.newCount} ${result.newCount > 0 ? "🆕" : ""}`);
+    console.log(`    Resolution rate: ${result.resolutionRate}%`);
+    console.log();
+    if (result.resolved.length > 0) {
+        console.log("  Resolved Findings:");
+        for (const f of result.resolved) {
+            console.log(`    ✅ [${(f.severity || "").toUpperCase()}] ${f.title || f.ruleId}`);
+        }
+        console.log();
+    }
+    if (result.remaining.length > 0) {
+        console.log("  Remaining Findings:");
+        for (const f of result.remaining) {
+            console.log(`    ⚠️ [${(f.severity || "").toUpperCase()}] ${f.title || f.ruleId}`);
+        }
+        console.log();
+    }
+    if (result.newFindings.length > 0) {
+        console.log("  New Findings (introduced by fixes):");
+        for (const f of result.newFindings) {
+            console.log(`    🆕 [${(f.severity || "").toUpperCase()}] ${f.title || f.ruleId}`);
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=fix-verify.js.map

package/dist/commands/fix-verify.js.map

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

package/dist/commands/review-comment.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Review-comment — Generate inline source code comments from review findings.
+ */
+export declare function runReviewComment(argv: string[]): void;
+//# sourceMappingURL=review-comment.d.ts.map

package/dist/commands/review-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-comment.d.ts","sourceRoot":"","sources":["../../src/commands/review-comment.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8EH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAwHrD"}

package/dist/commands/review-comment.js

@@ -0,0 +1,166 @@
+/**
+ * Review-comment — Generate inline source code comments from review findings.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+const COMMENT_STYLES = {
+    javascript: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    typescript: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    python: { line: "#", blockStart: '"""', blockEnd: '"""' },
+    ruby: { line: "#", blockStart: "=begin", blockEnd: "=end" },
+    java: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    csharp: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    go: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    rust: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    cpp: { line: "//", blockStart: "/*", blockEnd: "*/" },
+    c: { line: "//", blockStart: "/*", blockEnd: "*/" },
+};
+function getCommentStyle(lang) {
+    return COMMENT_STYLES[lang.toLowerCase()] || COMMENT_STYLES["javascript"];
+}
+function formatComment(finding, style, commentStyle) {
+    const severity = (finding.severity || "info").toUpperCase();
+    const rule = finding.ruleId || "JUDGES";
+    const title = finding.title || "Finding";
+    if (commentStyle === "line") {
+        const lines = [`${style.line} JUDGES [${severity}] ${rule}: ${title}`];
+        if (finding.recommendation) {
+            lines.push(`${style.line}   Fix: ${finding.recommendation}`);
+        }
+        return lines.join("\n");
+    }
+    if (commentStyle === "jsdoc") {
+        const lines = [`/** JUDGES [${severity}] ${rule}: ${title}`];
+        if (finding.recommendation) {
+            lines.push(` *  Fix: ${finding.recommendation}`);
+        }
+        lines.push(" */");
+        return lines.join("\n");
+    }
+    // block
+    const lines = [`/* JUDGES [${severity}] ${rule}: ${title}`];
+    if (finding.recommendation) {
+        lines.push(`   Fix: ${finding.recommendation}`);
+    }
+    lines.push("*/");
+    return lines.join("\n");
+}
+function generateComments(findings, lang, style) {
+    const cs = getCommentStyle(lang);
+    const blocks = [];
+    for (const f of findings) {
+        const line = f.lineNumbers && f.lineNumbers.length > 0 ? f.lineNumbers[0] : 1;
+        blocks.push({ line, text: formatComment(f, cs, style) });
+    }
+    // Sort by line descending so insertions don't shift subsequent lines
+    blocks.sort((a, b) => b.line - a.line);
+    return blocks;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewComment(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-comment — Generate inline code comments from findings
+
+Usage:
+  judges review-comment --verdict verdict.json --source app.ts
+  judges review-comment --verdict verdict.json --source app.py --lang python
+  judges review-comment --verdict verdict.json --preview
+
+Options:
+  --verdict <path>       Verdict JSON file
+  --source <path>        Source file to annotate (optional; preview without)
+  --lang <language>      Language (auto-detected from extension)
+  --style line|block|jsdoc  Comment style (default: line)
+  --output <path>        Write annotated file to path (default: modifies in-place)
+  --preview              Show comments without modifying files
+  --min-severity <sev>   Only include findings at this severity or above
+  --format json          JSON output
+  --help, -h             Show this help
+
+Generates inline code comments from review findings. Comments include
+severity, rule ID, title, and fix recommendation.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const verdictFile = argv.find((_a, i) => argv[i - 1] === "--verdict");
+    const sourceFile = argv.find((_a, i) => argv[i - 1] === "--source");
+    const lang = argv.find((_a, i) => argv[i - 1] === "--lang") || "";
+    const styleArg = argv.find((_a, i) => argv[i - 1] === "--style") || "line";
+    const outputFile = argv.find((_a, i) => argv[i - 1] === "--output");
+    const preview = argv.includes("--preview");
+    const minSev = argv.find((_a, i) => argv[i - 1] === "--min-severity");
+    if (!verdictFile) {
+        console.error("Error: --verdict is required.");
+        process.exitCode = 1;
+        return;
+    }
+    if (!existsSync(verdictFile)) {
+        console.error(`Error: File not found: ${verdictFile}`);
+        process.exitCode = 1;
+        return;
+    }
+    let verdict;
+    try {
+        verdict = JSON.parse(readFileSync(verdictFile, "utf-8"));
+    }
+    catch {
+        console.error(`Error: Could not parse ${verdictFile}`);
+        process.exitCode = 1;
+        return;
+    }
+    let findings = verdict.findings || [];
+    // Severity filter
+    if (minSev) {
+        const sevOrder = { critical: 4, high: 3, medium: 2, low: 1, info: 0 };
+        const threshold = sevOrder[minSev.toLowerCase()] ?? 0;
+        findings = findings.filter((f) => (sevOrder[(f.severity || "").toLowerCase()] ?? 0) >= threshold);
+    }
+    // Detect language from source file extension
+    const detectedLang = lang || (sourceFile ? sourceFile.split(".").pop() || "ts" : "ts");
+    const languageMap = {
+        ts: "typescript",
+        js: "javascript",
+        py: "python",
+        rb: "ruby",
+        java: "java",
+        cs: "csharp",
+        go: "go",
+        rs: "rust",
+        cpp: "cpp",
+        c: "c",
+    };
+    const resolvedLang = languageMap[detectedLang] || detectedLang;
+    const commentStyle = (["line", "block", "jsdoc"].includes(styleArg) ? styleArg : "line");
+    const comments = generateComments(findings, resolvedLang, commentStyle);
+    if (format === "json") {
+        console.log(JSON.stringify({ language: resolvedLang, style: commentStyle, comments }, null, 2));
+        return;
+    }
+    if (preview || !sourceFile) {
+        console.log(`\n  Review Comments Preview (${resolvedLang}, ${commentStyle} style)\n  ─────────────────────────────`);
+        for (const c of [...comments].reverse()) {
+            console.log(`\n  Line ${c.line}:`);
+            for (const line of c.text.split("\n")) {
+                console.log(`    ${line}`);
+            }
+        }
+        console.log(`\n  Total: ${comments.length} comment(s)\n`);
+        return;
+    }
+    // Insert comments into source file
+    if (!existsSync(sourceFile)) {
+        console.error(`Error: Source file not found: ${sourceFile}`);
+        process.exitCode = 1;
+        return;
+    }
+    const sourceLines = readFileSync(sourceFile, "utf-8").split("\n");
+    for (const c of comments) {
+        const insertAt = Math.max(0, c.line - 1);
+        sourceLines.splice(insertAt, 0, c.text);
+    }
+    const dest = outputFile || sourceFile;
+    writeFileSync(dest, sourceLines.join("\n"), "utf-8");
+    console.log(`Inserted ${comments.length} comment(s) into ${dest}`);
+}
+//# sourceMappingURL=review-comment.js.map

package/dist/commands/review-comment.js.map

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

package/dist/commands/review-dashboard.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Review-dashboard — Terminal-based dashboard summary of review health.
+ */
+export declare function runReviewDashboard(argv: string[]): void;
+//# sourceMappingURL=review-dashboard.d.ts.map

package/dist/commands/review-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-dashboard.d.ts","sourceRoot":"","sources":["../../src/commands/review-dashboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAqJvD"}

package/dist/commands/review-dashboard.js

@@ -0,0 +1,141 @@
+/**
+ * Review-dashboard — Terminal-based dashboard summary of review health.
+ */
+import { readFileSync, existsSync, readdirSync } from "fs";
+import { join } from "path";
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runReviewDashboard(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges review-dashboard — Terminal dashboard of review health
+
+Usage:
+  judges review-dashboard                        Show dashboard
+  judges review-dashboard --dir ./results        From verdict directory
+  judges review-dashboard --file verdict.json    From single file
+  judges review-dashboard --format json          JSON output
+
+Options:
+  --file <path>         Single verdict file
+  --dir <directory>     Directory with verdict JSON files
+  --format json         JSON output
+  --help, -h            Show this help
+
+Displays a summary dashboard with key metrics: score,
+findings by severity, trends, and actionable insights.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const file = argv.find((_a, i) => argv[i - 1] === "--file");
+    const dir = argv.find((_a, i) => argv[i - 1] === "--dir");
+    const verdicts = [];
+    if (file && existsSync(file)) {
+        try {
+            verdicts.push(JSON.parse(readFileSync(file, "utf-8")));
+        }
+        catch {
+            /* skip */
+        }
+    }
+    if (dir && existsSync(dir)) {
+        try {
+            const entries = readdirSync(dir);
+            for (const entry of entries) {
+                if (typeof entry === "string" && entry.endsWith(".json")) {
+                    try {
+                        verdicts.push(JSON.parse(readFileSync(join(dir, entry), "utf-8")));
+                    }
+                    catch {
+                        /* skip */
+                    }
+                }
+            }
+        }
+        catch {
+            /* skip */
+        }
+    }
+    if (verdicts.length === 0) {
+        console.log("\n  No verdict data found. Use --file or --dir to provide verdict JSON files.\n");
+        return;
+    }
+    // Compute metrics
+    const scores = verdicts.map((v) => v.overallScore || 0);
+    const avgScore = Math.round(scores.reduce((a, b) => a + b, 0) / scores.length);
+    const totalFindings = verdicts.reduce((sum, v) => sum + (v.findings || []).length, 0);
+    const severityCounts = {};
+    for (const v of verdicts) {
+        for (const f of v.findings || []) {
+            const sev = f.severity || "unknown";
+            severityCounts[sev] = (severityCounts[sev] || 0) + 1;
+        }
+    }
+    const criticalCount = severityCounts["critical"] || 0;
+    const highCount = severityCounts["high"] || 0;
+    const mediumCount = severityCounts["medium"] || 0;
+    const lowCount = severityCounts["low"] || 0;
+    const passCount = verdicts.filter((v) => v.overallVerdict === "pass").length;
+    const failCount = verdicts.filter((v) => v.overallVerdict === "fail").length;
+    const grade = avgScore >= 90 ? "A" : avgScore >= 80 ? "B" : avgScore >= 70 ? "C" : avgScore >= 60 ? "D" : "F";
+    if (format === "json") {
+        console.log(JSON.stringify({
+            reviewCount: verdicts.length,
+            avgScore,
+            grade,
+            totalFindings,
+            severityCounts,
+            passCount,
+            failCount,
+        }, null, 2));
+        return;
+    }
+    const barLen = Math.round((avgScore / 100) * 20);
+    const scoreBar = "█".repeat(barLen) + "░".repeat(20 - barLen);
+    console.log(`
+  ╔═══════════════════════════════════════════╗
+  ║          JUDGES REVIEW DASHBOARD          ║
+  ╚═══════════════════════════════════════════╝
+
+  Score: ${scoreBar} ${avgScore}/100 (Grade ${grade})
+
+  ┌─────────────────────────────────────────┐
+  │  Reviews: ${String(verdicts.length).padEnd(6)} Pass: ${String(passCount).padEnd(6)} Fail: ${String(failCount).padEnd(4)}│
+  │  Findings: ${String(totalFindings).padEnd(30)}│
+  └─────────────────────────────────────────┘
+
+  Severity Distribution:
+    🔴 Critical: ${"█".repeat(Math.min(criticalCount, 30))} ${criticalCount}
+    🟠 High:     ${"█".repeat(Math.min(highCount, 30))} ${highCount}
+    🟡 Medium:   ${"█".repeat(Math.min(mediumCount, 30))} ${mediumCount}
+    🟢 Low:      ${"█".repeat(Math.min(lowCount, 30))} ${lowCount}
+`);
+    // Top rules
+    const ruleCounts = new Map();
+    for (const v of verdicts) {
+        for (const f of v.findings || []) {
+            const rule = f.ruleId || "unknown";
+            ruleCounts.set(rule, (ruleCounts.get(rule) || 0) + 1);
+        }
+    }
+    const topRules = [...ruleCounts.entries()].sort(([, a], [, b]) => b - a).slice(0, 5);
+    if (topRules.length > 0) {
+        console.log("  Top Rules:");
+        for (const [rule, count] of topRules) {
+            console.log(`    ${rule.padEnd(30)} ${count} occurrence(s)`);
+        }
+        console.log();
+    }
+    // Insights
+    console.log("  Insights:");
+    if (criticalCount > 0)
+        console.log(`    ⚠️  ${criticalCount} critical finding(s) require immediate attention`);
+    if (failCount > passCount)
+        console.log("    ⚠️  More reviews failing than passing — consider reviewing thresholds");
+    if (avgScore >= 80)
+        console.log("    ✅ Code quality is above target");
+    if (totalFindings === 0)
+        console.log("    ✅ Clean — no findings detected");
+    console.log();
+}
+//# sourceMappingURL=review-dashboard.js.map