@kevinrabun/judges 3.64.0 → 3.66.0

package/dist/commands/code-health.js

@@ -0,0 +1,196 @@
+/**
+ * Code-health — Overall codebase health score across multiple dimensions.
+ */
+import { readFileSync, existsSync } from "fs";
+// ─── Severity weights ───────────────────────────────────────────────────────
+const SEVERITY_PENALTY = {
+    critical: 25,
+    high: 15,
+    medium: 8,
+    low: 3,
+    info: 1,
+};
+function computeGrade(score) {
+    if (score >= 90)
+        return "A";
+    if (score >= 80)
+        return "B";
+    if (score >= 70)
+        return "C";
+    if (score >= 60)
+        return "D";
+    return "F";
+}
+// ─── Dimension Analysis ────────────────────────────────────────────────────
+function categorizeFinding(f) {
+    const rule = (f.ruleId || "").toLowerCase();
+    const title = (f.title || "").toLowerCase();
+    if (rule.includes("sql") ||
+        rule.includes("xss") ||
+        rule.includes("inject") ||
+        rule.includes("auth") ||
+        rule.includes("crypto") ||
+        rule.includes("secret") ||
+        title.includes("vulnerab") ||
+        title.includes("security") ||
+        title.includes("injection")) {
+        return "security";
+    }
+    if (rule.includes("error") ||
+        rule.includes("null") ||
+        rule.includes("type") ||
+        rule.includes("bound") ||
+        rule.includes("overflow") ||
+        title.includes("bug") ||
+        title.includes("error") ||
+        title.includes("crash")) {
+        return "reliability";
+    }
+    if (rule.includes("complex") ||
+        rule.includes("dupl") ||
+        rule.includes("smell") ||
+        rule.includes("long") ||
+        rule.includes("dead") ||
+        title.includes("maintain") ||
+        title.includes("complex") ||
+        title.includes("duplicate")) {
+        return "maintainability";
+    }
+    if (rule.includes("perf") ||
+        rule.includes("optim") ||
+        rule.includes("leak") ||
+        title.includes("perform") ||
+        title.includes("slow") ||
+        title.includes("memory")) {
+        return "performance";
+    }
+    return "quality";
+}
+function computeDimension(name, findings, weight) {
+    let penalty = 0;
+    for (const f of findings) {
+        const sev = (f.severity || "low").toLowerCase();
+        penalty += SEVERITY_PENALTY[sev] || 3;
+    }
+    const score = Math.max(0, Math.min(100, 100 - penalty));
+    const details = findings.length === 0 ? `No ${name} issues found` : `${findings.length} ${name} finding(s) detected`;
+    return { name, score, weight, findingsCount: findings.length, details };
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runCodeHealth(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges code-health — Overall codebase health score
+
+Usage:
+  judges code-health --file verdict.json       Compute health from verdict
+  judges code-health --format json             JSON output
+  judges code-health --weights "security=40,reliability=25,maintainability=20,performance=10,quality=5"
+
+Options:
+  --file <path>         Verdict JSON file
+  --weights <spec>      Custom dimension weights (must total 100)
+  --format json         JSON output
+  --help, -h            Show this help
+
+Dimensions:
+  security              Injection, auth, crypto, secrets
+  reliability           Null checks, type errors, bounds
+  maintainability       Complexity, duplication, code smells
+  performance           Memory leaks, optimization issues
+  quality               General code quality findings
+
+Computes a weighted health score (0-100) with a letter grade (A-F).
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const file = argv.find((_a, i) => argv[i - 1] === "--file");
+    // Parse custom weights
+    const defaultWeights = {
+        security: 35,
+        reliability: 25,
+        maintainability: 20,
+        performance: 10,
+        quality: 10,
+    };
+    const weightsArg = argv.find((_a, i) => argv[i - 1] === "--weights");
+    if (weightsArg) {
+        for (const part of weightsArg.split(",")) {
+            const [key, val] = part.split("=");
+            if (key && val)
+                defaultWeights[key.trim()] = parseInt(val, 10);
+        }
+    }
+    let findings = [];
+    let baseScore = 0;
+    if (file) {
+        if (!existsSync(file)) {
+            console.error(`Error: File not found: ${file}`);
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const verdict = JSON.parse(readFileSync(file, "utf-8"));
+            findings = verdict.findings || [];
+            baseScore = verdict.overallScore || 0;
+        }
+        catch {
+            console.error(`Error: Could not parse ${file}`);
+            process.exitCode = 1;
+            return;
+        }
+    }
+    // Group findings by dimension
+    const groups = new Map();
+    for (const key of Object.keys(defaultWeights)) {
+        groups.set(key, []);
+    }
+    for (const f of findings) {
+        const cat = categorizeFinding(f);
+        const arr = groups.get(cat);
+        if (arr)
+            arr.push(f);
+        else {
+            const qArr = groups.get("quality");
+            if (qArr)
+                qArr.push(f);
+        }
+    }
+    // Compute dimensions
+    const dimensions = [];
+    for (const [name, weight] of Object.entries(defaultWeights)) {
+        const dimFindings = groups.get(name) || [];
+        dimensions.push(computeDimension(name, dimFindings, weight));
+    }
+    // Weighted average
+    const totalWeight = dimensions.reduce((sum, d) => sum + d.weight, 0);
+    const weightedScore = totalWeight > 0 ? Math.round(dimensions.reduce((sum, d) => sum + d.score * d.weight, 0) / totalWeight) : baseScore;
+    const report = {
+        timestamp: new Date().toISOString(),
+        overallScore: weightedScore,
+        grade: computeGrade(weightedScore),
+        dimensions,
+        totalFindings: findings.length,
+        summary: `Health score: ${weightedScore}/100 (Grade ${computeGrade(weightedScore)}). ${findings.length} total findings across ${dimensions.filter((d) => d.findingsCount > 0).length} dimensions.`,
+    };
+    if (format === "json") {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log(`\n  Codebase Health Report\n  ═════════════════════════════`);
+    console.log(`    Overall Score: ${report.overallScore}/100`);
+    console.log(`    Grade: ${report.grade}`);
+    console.log(`    Total Findings: ${report.totalFindings}`);
+    console.log();
+    console.log("  Dimensions");
+    console.log("  ─────────────────────────────");
+    for (const d of dimensions) {
+        const bar = "█".repeat(Math.floor(d.score / 5)) + "░".repeat(20 - Math.floor(d.score / 5));
+        const grade = computeGrade(d.score);
+        console.log(`    ${d.name.padEnd(18)} ${bar} ${d.score}/100 (${grade}) — ${d.findingsCount} findings [weight: ${d.weight}%]`);
+    }
+    console.log(`\n  Summary: ${report.summary}`);
+    console.log();
+}
+//# sourceMappingURL=code-health.js.map

package/dist/commands/code-health.js.map

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

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

@@ -0,0 +1,5 @@
+/**
+ * Finding-suppress — Suppress specific findings with inline or config suppression.
+ */
+export declare function runFindingSuppress(argv: string[]): void;
+//# sourceMappingURL=finding-suppress.d.ts.map

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

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

package/dist/commands/finding-suppress.js

@@ -0,0 +1,165 @@
+/**
+ * Finding-suppress — Suppress specific findings with inline or config suppression.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+// ─── Storage ────────────────────────────────────────────────────────────────
+const SUPPRESS_FILE = join(".judges", "suppressions.json");
+function loadSuppressions() {
+    if (!existsSync(SUPPRESS_FILE))
+        return { version: "1.0.0", suppressions: [] };
+    try {
+        return JSON.parse(readFileSync(SUPPRESS_FILE, "utf-8"));
+    }
+    catch {
+        return { version: "1.0.0", suppressions: [] };
+    }
+}
+function saveSuppressions(config) {
+    mkdirSync(dirname(SUPPRESS_FILE), { recursive: true });
+    writeFileSync(SUPPRESS_FILE, JSON.stringify(config, null, 2), "utf-8");
+}
+// ─── Active check ───────────────────────────────────────────────────────────
+function isActive(entry) {
+    if (!entry.expiresAt)
+        return true;
+    return new Date(entry.expiresAt) > new Date();
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runFindingSuppress(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges finding-suppress — Suppress specific findings
+
+Usage:
+  judges finding-suppress list                    List suppressions
+  judges finding-suppress add --rule sql-injection --reason "False positive in test"
+  judges finding-suppress remove --rule sql-injection
+  judges finding-suppress check --rule sql-injection
+  judges finding-suppress --format json
+
+Subcommands:
+  list                 List all active suppressions
+  add                  Add a suppression
+  remove               Remove a suppression
+  check                Check if a rule is suppressed
+
+Options:
+  --rule <id>          Rule ID to suppress
+  --reason <text>      Reason for suppression (required for add)
+  --author <name>      Who suppressed (default: "unknown")
+  --expires <date>     Expiration date (ISO 8601, optional)
+  --scope <scope>      Scope: global, file, line (default: global)
+  --format json        JSON output
+  --help, -h           Show this help
+
+Suppressions are stored in .judges/suppressions.json. Expired
+suppressions are automatically ignored. Use inline comments
+(// judges-suppress: <rule-id>) for line-level suppression.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const subcommand = argv.find((a) => ["list", "add", "remove", "check"].includes(a)) || "list";
+    const config = loadSuppressions();
+    if (subcommand === "add") {
+        const ruleId = argv.find((_a, i) => argv[i - 1] === "--rule");
+        const reason = argv.find((_a, i) => argv[i - 1] === "--reason");
+        const author = argv.find((_a, i) => argv[i - 1] === "--author") || "unknown";
+        const expires = argv.find((_a, i) => argv[i - 1] === "--expires");
+        const scope = argv.find((_a, i) => argv[i - 1] === "--scope") || "global";
+        if (!ruleId) {
+            console.error("Error: --rule is required.");
+            process.exitCode = 1;
+            return;
+        }
+        if (!reason) {
+            console.error("Error: --reason is required. Explain why the finding is suppressed.");
+            process.exitCode = 1;
+            return;
+        }
+        const existing = config.suppressions.find((s) => s.ruleId === ruleId);
+        if (existing) {
+            console.error(`Error: Rule '${ruleId}' is already suppressed.`);
+            process.exitCode = 1;
+            return;
+        }
+        const entry = {
+            ruleId,
+            reason,
+            author,
+            timestamp: new Date().toISOString(),
+            scope,
+        };
+        if (expires)
+            entry.expiresAt = expires;
+        config.suppressions.push(entry);
+        saveSuppressions(config);
+        console.log(`Suppressed '${ruleId}' — reason: ${reason}${expires ? ` (expires: ${expires})` : ""}`);
+        return;
+    }
+    if (subcommand === "remove") {
+        const ruleId = argv.find((_a, i) => argv[i - 1] === "--rule");
+        if (!ruleId) {
+            console.error("Error: --rule is required.");
+            process.exitCode = 1;
+            return;
+        }
+        const idx = config.suppressions.findIndex((s) => s.ruleId === ruleId);
+        if (idx < 0) {
+            console.error(`Error: No suppression found for '${ruleId}'.`);
+            process.exitCode = 1;
+            return;
+        }
+        config.suppressions.splice(idx, 1);
+        saveSuppressions(config);
+        console.log(`Removed suppression for '${ruleId}'.`);
+        return;
+    }
+    if (subcommand === "check") {
+        const ruleId = argv.find((_a, i) => argv[i - 1] === "--rule");
+        if (!ruleId) {
+            console.error("Error: --rule is required.");
+            process.exitCode = 1;
+            return;
+        }
+        const entry = config.suppressions.find((s) => s.ruleId === ruleId);
+        if (!entry) {
+            console.log(`Rule '${ruleId}' is NOT suppressed.`);
+            return;
+        }
+        const active = isActive(entry);
+        if (format === "json") {
+            console.log(JSON.stringify({ ruleId, suppressed: active, entry }, null, 2));
+            return;
+        }
+        console.log(`Rule '${ruleId}' is ${active ? "SUPPRESSED" : "EXPIRED"}`);
+        console.log(`  Reason: ${entry.reason}`);
+        console.log(`  Author: ${entry.author}`);
+        console.log(`  Since: ${entry.timestamp}`);
+        if (entry.expiresAt)
+            console.log(`  Expires: ${entry.expiresAt}`);
+        return;
+    }
+    // List
+    const active = config.suppressions.filter(isActive);
+    const expired = config.suppressions.filter((s) => !isActive(s));
+    if (format === "json") {
+        console.log(JSON.stringify({ active: active.length, expired: expired.length, suppressions: config.suppressions }, null, 2));
+        return;
+    }
+    console.log(`\n  Finding Suppressions\n  ─────────────────────────────`);
+    console.log(`    Active: ${active.length} | Expired: ${expired.length}\n`);
+    if (active.length === 0 && expired.length === 0) {
+        console.log("    No suppressions configured.");
+    }
+    for (const s of active) {
+        console.log(`    🔇 ${s.ruleId} — ${s.reason}`);
+        console.log(`       Author: ${s.author} | Scope: ${s.scope}${s.expiresAt ? ` | Expires: ${s.expiresAt}` : ""}`);
+    }
+    for (const s of expired) {
+        console.log(`    ⏰ ${s.ruleId} (expired) — ${s.reason}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=finding-suppress.js.map

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * Finding-timeline — Track finding trends across commits over time.
+ */
+export declare function runFindingTimeline(argv: string[]): void;
+//# sourceMappingURL=finding-timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"finding-timeline.d.ts","sourceRoot":"","sources":["../../src/commands/finding-timeline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqDH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA+HvD"}

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"}