@kevinrabun/judges 3.44.0 → 3.46.0

package/dist/commands/dev-score.js

@@ -0,0 +1,204 @@
+/**
+ * Developer growth score — track individual developer improvement
+ * based on finding patterns over time.
+ *
+ * Stored locally in .judges-scores/ directory.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+const SCORES_DIR = ".judges-scores";
+// ─── Core ───────────────────────────────────────────────────────────────────
+function ensureDir() {
+    if (!existsSync(SCORES_DIR))
+        mkdirSync(SCORES_DIR, { recursive: true });
+}
+function sanitizeFilename(author) {
+    return author.replace(/[^a-zA-Z0-9._-]/g, "_").toLowerCase();
+}
+function loadScore(author) {
+    ensureDir();
+    const file = join(SCORES_DIR, `${sanitizeFilename(author)}.json`);
+    if (!existsSync(file)) {
+        return {
+            author,
+            currentScore: 100,
+            history: [],
+            weaknesses: [],
+            streak: 0,
+            totalFindings: 0,
+            totalResolved: 0,
+            avgFindingsPerCommit: 0,
+            trend: "stable",
+            lastUpdated: new Date().toISOString(),
+        };
+    }
+    return JSON.parse(readFileSync(file, "utf-8"));
+}
+function saveScore(score) {
+    ensureDir();
+    const file = join(SCORES_DIR, `${sanitizeFilename(score.author)}.json`);
+    writeFileSync(file, JSON.stringify(score, null, 2));
+}
+function computeScore(history) {
+    if (history.length === 0)
+        return 100;
+    // Score based on recent finding rate and resolution rate
+    const recent = history.slice(-10);
+    const avgFindings = recent.reduce((s, e) => s + e.findingsCount, 0) / recent.length;
+    const avgResolved = recent.reduce((s, e) => s + e.resolvedCount, 0) / recent.length;
+    const avgCritical = recent.reduce((s, e) => s + e.criticalCount, 0) / recent.length;
+    let score = 100;
+    score -= avgFindings * 3; // penalty per finding
+    score -= avgCritical * 10; // extra penalty for critical
+    score += avgResolved * 2; // bonus for resolving
+    score = Math.max(0, Math.min(100, Math.round(score)));
+    return score;
+}
+function computeTrend(history) {
+    if (history.length < 5)
+        return "stable";
+    const recent = history.slice(-5);
+    const older = history.slice(-10, -5);
+    if (older.length < 3)
+        return "stable";
+    const recentAvg = recent.reduce((s, e) => s + e.findingsCount, 0) / recent.length;
+    const olderAvg = older.reduce((s, e) => s + e.findingsCount, 0) / older.length;
+    if (recentAvg < olderAvg * 0.8)
+        return "improving";
+    if (recentAvg > olderAvg * 1.2)
+        return "declining";
+    return "stable";
+}
+export function recordScan(author, findingsCount, criticalCount, highCount, resolvedCount, commitCount) {
+    const score = loadScore(author);
+    score.history.push({
+        date: new Date().toISOString().split("T")[0],
+        findingsCount,
+        criticalCount,
+        highCount,
+        resolvedCount,
+        commitCount,
+    });
+    score.totalFindings += findingsCount;
+    score.totalResolved += resolvedCount;
+    score.streak = findingsCount === 0 ? score.streak + 1 : 0;
+    score.currentScore = computeScore(score.history);
+    score.trend = computeTrend(score.history);
+    const totalCommits = score.history.reduce((s, e) => s + e.commitCount, 0);
+    score.avgFindingsPerCommit = totalCommits > 0 ? Math.round((score.totalFindings / totalCommits) * 100) / 100 : 0;
+    score.lastUpdated = new Date().toISOString();
+    saveScore(score);
+    return score;
+}
+export function getScore(author) {
+    return loadScore(author);
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runDevScore(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges dev-score — Developer growth and improvement tracking
+
+Usage:
+  judges dev-score --author "jane@company.com"
+  judges dev-score --record "jane@company.com" --findings 3 --critical 0 --high 1 --resolved 5 --commits 12
+  judges dev-score --leaderboard
+  judges dev-score --author "jane@company.com" --history
+
+Options:
+  --author <email>       Developer email/identifier
+  --record <email>       Record a scan for a developer
+    --findings <n>       Number of findings
+    --critical <n>       Critical findings
+    --high <n>           High findings
+    --resolved <n>       Resolved findings
+    --commits <n>        Commits in period
+  --leaderboard          Show team leaderboard
+  --history              Show score history for author
+  --format json          JSON output
+  --help, -h             Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    // Record scan
+    const recordAuthor = argv.find((_a, i) => argv[i - 1] === "--record");
+    if (recordAuthor) {
+        const getNum = (flag) => {
+            const val = argv.find((_a, i) => argv[i - 1] === flag);
+            return val ? parseInt(val, 10) : 0;
+        };
+        const score = recordScan(recordAuthor, getNum("--findings"), getNum("--critical"), getNum("--high"), getNum("--resolved"), getNum("--commits"));
+        if (format === "json") {
+            console.log(JSON.stringify(score, null, 2));
+        }
+        else {
+            const icon = score.trend === "improving" ? "📈" : score.trend === "declining" ? "📉" : "➡️";
+            console.log(`  ✅ Scan recorded for ${recordAuthor}`);
+            console.log(`     Score: ${score.currentScore}/100 ${icon} Streak: ${score.streak} clean scans`);
+        }
+        return;
+    }
+    // Show author score
+    const author = argv.find((_a, i) => argv[i - 1] === "--author");
+    if (author) {
+        const score = getScore(author);
+        if (argv.includes("--history")) {
+            if (format === "json") {
+                console.log(JSON.stringify(score.history, null, 2));
+            }
+            else if (score.history.length === 0) {
+                console.log(`\n  No history for ${author}.\n`);
+            }
+            else {
+                console.log(`\n  Score History — ${author}\n  ────────────────────────`);
+                for (const h of score.history.slice(-20)) {
+                    console.log(`    ${h.date}  findings: ${h.findingsCount} (C:${h.criticalCount} H:${h.highCount}) resolved: ${h.resolvedCount}`);
+                }
+                console.log("");
+            }
+            return;
+        }
+        if (format === "json") {
+            console.log(JSON.stringify(score, null, 2));
+        }
+        else {
+            const icon = score.trend === "improving" ? "📈" : score.trend === "declining" ? "📉" : "➡️";
+            console.log(`\n  Developer Score — ${author}`);
+            console.log(`  ──────────────────────────`);
+            console.log(`  Score:             ${score.currentScore}/100 ${icon}`);
+            console.log(`  Trend:             ${score.trend}`);
+            console.log(`  Clean scan streak: ${score.streak}`);
+            console.log(`  Total findings:    ${score.totalFindings}`);
+            console.log(`  Total resolved:    ${score.totalResolved}`);
+            console.log(`  Findings/commit:   ${score.avgFindingsPerCommit}`);
+            console.log(`  Scans recorded:    ${score.history.length}\n`);
+        }
+        return;
+    }
+    // Leaderboard
+    if (argv.includes("--leaderboard")) {
+        ensureDir();
+        const { readdirSync: rds } = require("fs");
+        const files = rds(SCORES_DIR).filter((f) => f.endsWith(".json"));
+        const scores = files.map((f) => JSON.parse(readFileSync(join(SCORES_DIR, f), "utf-8")));
+        scores.sort((a, b) => b.currentScore - a.currentScore);
+        if (format === "json") {
+            console.log(JSON.stringify(scores.map((s) => ({ author: s.author, score: s.currentScore, trend: s.trend })), null, 2));
+        }
+        else if (scores.length === 0) {
+            console.log("\n  No scores recorded. Use --record to start tracking.\n");
+        }
+        else {
+            console.log(`\n  Leaderboard (${scores.length} developers)\n  ─────────────`);
+            scores.forEach((s, i) => {
+                const icon = s.trend === "improving" ? "📈" : s.trend === "declining" ? "📉" : "➡️";
+                console.log(`    ${String(i + 1).padStart(2)}. ${s.author.padEnd(25)} ${String(s.currentScore).padStart(3)}/100 ${icon} streak: ${s.streak}`);
+            });
+            console.log("");
+        }
+        return;
+    }
+    console.log("  Use --author <email> to view a score, or --record to log a scan. --help for usage.");
+}
+//# sourceMappingURL=dev-score.js.map

package/dist/commands/dev-score.js.map

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