@kevinrabun/judges 3.41.0 → 3.43.0

package/dist/commands/pr-summary.js

@@ -0,0 +1,188 @@
+/**
+ * PR summary comment — post a top-level comment on a GitHub PR
+ * with the overall Judges verdict, score, and finding counts.
+ *
+ * Uses the GitHub API to create or update a comment with a distinctive
+ * marker so subsequent runs update in-place rather than spamming.
+ */
+// ─── Marker ─────────────────────────────────────────────────────────────────
+const COMMENT_MARKER = "<!-- judges-pr-summary -->";
+// ─── Formatting ─────────────────────────────────────────────────────────────
+function verdictEmoji(verdict) {
+    if (verdict === "pass")
+        return "✅";
+    if (verdict === "fail")
+        return "❌";
+    return "⚠️";
+}
+function severityBadge(severity) {
+    const map = { critical: "🔴", high: "🟠", medium: "🟡", low: "🔵", info: "⚪" };
+    return map[severity] || "⚪";
+}
+export function formatPrSummary(verdict) {
+    const emoji = verdictEmoji(verdict.overallVerdict);
+    const lines = [
+        COMMENT_MARKER,
+        `## ${emoji} Judges Code Review — ${verdict.overallVerdict.toUpperCase()}`,
+        "",
+        `| Metric | Value |`,
+        `|--------|-------|`,
+        `| **Verdict** | ${verdict.overallVerdict} |`,
+        `| **Score** | ${verdict.overallScore}/100 |`,
+        `| **Critical** | ${verdict.criticalCount} |`,
+        `| **High** | ${verdict.highCount} |`,
+        `| **Judges Run** | ${verdict.evaluations.length} |`,
+        "",
+    ];
+    // Per-judge breakdown
+    if (verdict.evaluations.length > 0) {
+        lines.push("### Judge Breakdown", "");
+        lines.push("| Judge | Verdict | Score | Findings |");
+        lines.push("|-------|---------|-------|----------|");
+        for (const evaluation of verdict.evaluations) {
+            const jEmoji = verdictEmoji(evaluation.verdict);
+            const findingCount = evaluation.findings?.length ?? 0;
+            lines.push(`| ${evaluation.judgeId} | ${jEmoji} ${evaluation.verdict} | ${evaluation.score}/100 | ${findingCount} |`);
+        }
+        lines.push("");
+    }
+    // Top findings
+    const allFindings = verdict.evaluations.flatMap((e) => e.findings || []);
+    const topFindings = allFindings.filter((f) => f.severity === "critical" || f.severity === "high").slice(0, 10);
+    if (topFindings.length > 0) {
+        lines.push("### Top Findings", "");
+        for (const f of topFindings) {
+            const badge = severityBadge(f.severity);
+            const loc = f.lineNumbers?.length ? ` (line ${f.lineNumbers[0]})` : "";
+            lines.push(`- ${badge} **${f.severity.toUpperCase()}** — ${f.ruleId}: ${f.title}${loc}`);
+        }
+        lines.push("");
+    }
+    lines.push("---", `<sub>Generated by [Judges](https://github.com/KevinRabun/judges) at ${new Date().toISOString()}</sub>`);
+    return lines.join("\n");
+}
+// ─── GitHub API ─────────────────────────────────────────────────────────────
+async function findExistingComment(owner, repo, prNumber, token, baseUrl) {
+    const url = `${baseUrl}/repos/${owner}/${repo}/issues/${prNumber}/comments?per_page=100`;
+    const res = await fetch(url, {
+        headers: { Authorization: `Bearer ${token}`, Accept: "application/vnd.github+json" },
+    });
+    if (!res.ok)
+        return null;
+    const comments = (await res.json());
+    const existing = comments.find((c) => c.body.includes(COMMENT_MARKER));
+    return existing ? { id: existing.id, url: existing.html_url } : null;
+}
+export async function postPrSummary(options) {
+    const baseUrl = options.baseUrl || "https://api.github.com";
+    const body = formatPrSummary(options.verdict);
+    const headers = {
+        Authorization: `Bearer ${options.token}`,
+        Accept: "application/vnd.github+json",
+        "Content-Type": "application/json",
+    };
+    // Check for existing comment to update
+    const existing = await findExistingComment(options.owner, options.repo, options.prNumber, options.token, baseUrl);
+    if (existing) {
+        const url = `${baseUrl}/repos/${options.owner}/${options.repo}/issues/comments/${existing.id}`;
+        const res = await fetch(url, {
+            method: "PATCH",
+            headers,
+            body: JSON.stringify({ body }),
+        });
+        if (!res.ok)
+            throw new Error(`Failed to update comment: ${res.status} ${res.statusText}`);
+        return { commentId: existing.id, updated: true, url: existing.url };
+    }
+    const url = `${baseUrl}/repos/${options.owner}/${options.repo}/issues/${options.prNumber}/comments`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ body }),
+    });
+    if (!res.ok)
+        throw new Error(`Failed to create comment: ${res.status} ${res.statusText}`);
+    const data = (await res.json());
+    return { commentId: data.id, updated: false, url: data.html_url };
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export async function runPrSummary(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges pr-summary — Post a PR summary comment with Judges results
+
+Usage:
+  judges eval --file src/app.ts --format json | judges pr-summary --pr 42 --repo owner/repo
+
+Options:
+  --pr <number>          PR number (required)
+  --repo <owner/repo>    GitHub repo (auto-detected from git)
+  --token <token>        GitHub token (default: GITHUB_TOKEN env)
+  --sarif <path>         Read results from SARIF file instead of stdin
+  --help, -h             Show this help
+`);
+        return;
+    }
+    const { readFileSync, existsSync } = await import("fs");
+    const { execSync } = await import("child_process");
+    const prArg = argv.find((_a, i) => argv[i - 1] === "--pr");
+    if (!prArg) {
+        console.error("Error: --pr <number> is required");
+        process.exit(1);
+    }
+    const prNumber = parseInt(prArg, 10);
+    let repoArg = argv.find((_a, i) => argv[i - 1] === "--repo");
+    if (!repoArg) {
+        try {
+            const remote = execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
+            const match = remote.match(/github\.com[:/](.+?)(?:\.git)?$/);
+            if (match)
+                repoArg = match[1];
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (!repoArg) {
+        console.error("Error: --repo <owner/repo> required (could not auto-detect)");
+        process.exit(1);
+    }
+    const [owner, repo] = repoArg.split("/");
+    const token = argv.find((_a, i) => argv[i - 1] === "--token") || process.env.GITHUB_TOKEN || "";
+    if (!token) {
+        console.error("Error: --token or GITHUB_TOKEN env required");
+        process.exit(1);
+    }
+    // Load verdict
+    const sarifPath = argv.find((_a, i) => argv[i - 1] === "--sarif");
+    let verdict;
+    if (sarifPath && existsSync(sarifPath)) {
+        // Parse SARIF and synthesize a verdict
+        const sarif = JSON.parse(readFileSync(sarifPath, "utf-8"));
+        const findings = sarif.runs?.[0]?.results || [];
+        verdict = {
+            overallVerdict: findings.some((f) => f.level === "error") ? "fail" : "pass",
+            overallScore: Math.max(0, 100 - findings.length * 5),
+            summary: `SARIF upload with ${findings.length} findings`,
+            evaluations: [],
+            findings: [],
+            criticalCount: findings.filter((f) => f.level === "error").length,
+            highCount: findings.filter((f) => f.level === "warning").length,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    else {
+        // Try reading JSON verdict from stdin arg or file
+        const jsonArg = argv.find((_a, i) => argv[i - 1] === "--json");
+        if (jsonArg && existsSync(jsonArg)) {
+            verdict = JSON.parse(readFileSync(jsonArg, "utf-8"));
+        }
+        else {
+            console.error("Error: provide --sarif <path> or --json <path>");
+            process.exit(1);
+        }
+    }
+    const result = await postPrSummary({ owner, repo, prNumber, token, verdict });
+    console.log(`${result.updated ? "Updated" : "Created"} PR summary comment: ${result.url}`);
+}
+//# sourceMappingURL=pr-summary.js.map

package/dist/commands/pr-summary.js.map

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

package/dist/commands/profile.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Performance profiling — track evaluation time per judge/evaluator.
+ *
+ * Wraps tribunal evaluation and reports timing data for each judge,
+ * helping identify bottlenecks and optimize CI pipeline duration.
+ */
+export interface JudgeTiming {
+    judgeId: string;
+    durationMs: number;
+    findingCount: number;
+}
+export interface ProfilingReport {
+    totalMs: number;
+    judges: JudgeTiming[];
+    slowest: string;
+    fastest: string;
+    avgMs: number;
+}
+/**
+ * Create a profiling wrapper around a function.
+ */
+export declare function profileFn<T>(fn: () => T): {
+    result: T;
+    durationMs: number;
+};
+/**
+ * Create a profiling wrapper around an async function.
+ */
+export declare function profileAsync<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+/**
+ * Build a profiling report from timing data collected during evaluation.
+ */
+export declare function buildProfilingReport(timings: JudgeTiming[]): ProfilingReport;
+export declare function runProfile(argv: string[]): void;
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/commands/profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAI3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAItG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,eAAe,CAe5E;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAgD/C"}

package/dist/commands/profile.js

@@ -0,0 +1,102 @@
+/**
+ * Performance profiling — track evaluation time per judge/evaluator.
+ *
+ * Wraps tribunal evaluation and reports timing data for each judge,
+ * helping identify bottlenecks and optimize CI pipeline duration.
+ */
+// ─── Profiling ──────────────────────────────────────────────────────────────
+/**
+ * Create a profiling wrapper around a function.
+ */
+export function profileFn(fn) {
+    const start = performance.now();
+    const result = fn();
+    return { result, durationMs: Math.round(performance.now() - start) };
+}
+/**
+ * Create a profiling wrapper around an async function.
+ */
+export async function profileAsync(fn) {
+    const start = performance.now();
+    const result = await fn();
+    return { result, durationMs: Math.round(performance.now() - start) };
+}
+/**
+ * Build a profiling report from timing data collected during evaluation.
+ */
+export function buildProfilingReport(timings) {
+    if (timings.length === 0) {
+        return { totalMs: 0, judges: [], slowest: "N/A", fastest: "N/A", avgMs: 0 };
+    }
+    const sorted = [...timings].sort((a, b) => b.durationMs - a.durationMs);
+    const totalMs = sorted.reduce((sum, t) => sum + t.durationMs, 0);
+    return {
+        totalMs,
+        judges: sorted,
+        slowest: sorted[0].judgeId,
+        fastest: sorted[sorted.length - 1].judgeId,
+        avgMs: Math.round(totalMs / sorted.length),
+    };
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runProfile(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges profile — Performance profiling for judge evaluations
+
+Usage:
+  judges profile <file>               Profile evaluation of a file
+  judges profile --report <path>      Display a saved profiling report
+
+Options:
+  --format json          JSON output
+  --threshold <ms>       Highlight judges slower than threshold (default: 500)
+  --help, -h             Show this help
+
+Note: This command wraps the normal evaluation pipeline with timing
+instrumentation. Each judge's execution time is measured individually.
+`);
+        return;
+    }
+    const { readFileSync, existsSync } = require("fs");
+    const reportPath = argv.find((_a, i) => argv[i - 1] === "--report");
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const thresholdStr = argv.find((_a, i) => argv[i - 1] === "--threshold");
+    const threshold = thresholdStr ? parseInt(thresholdStr, 10) : 500;
+    if (reportPath && existsSync(reportPath)) {
+        const report = JSON.parse(readFileSync(reportPath, "utf-8"));
+        printReport(report, format, threshold);
+        return;
+    }
+    // Without a saved report, show instructions
+    console.log(`
+  Profiling requires running an evaluation first.
+
+  Run with JUDGES_PROFILE=1 to enable profiling during eval:
+
+    JUDGES_PROFILE=1 judges eval --file src/app.ts --format json > results.json
+
+  Then view the profiling data:
+
+    judges profile --report .judges-profile.json
+
+  The profiling data is saved to .judges-profile.json automatically
+  when JUDGES_PROFILE=1 is set.
+`);
+}
+function printReport(report, format, threshold) {
+    if (format === "json") {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log(`\n  ⏱️  Judges Evaluation Profile\n`);
+    console.log(`  Total: ${report.totalMs}ms | Avg: ${report.avgMs}ms | Judges: ${report.judges.length}\n`);
+    const maxLen = Math.max(...report.judges.map((j) => j.judgeId.length));
+    for (const j of report.judges) {
+        const bar = "█".repeat(Math.max(1, Math.round((j.durationMs / report.totalMs) * 40)));
+        const warn = j.durationMs > threshold ? " ⚠️ SLOW" : "";
+        console.log(`  ${j.judgeId.padEnd(maxLen)}  ${String(j.durationMs).padStart(6)}ms  ${bar}  (${j.findingCount} findings)${warn}`);
+    }
+    console.log(`\n  Slowest: ${report.slowest} | Fastest: ${report.fastest}\n`);
+}
+//# sourceMappingURL=profile.js.map

package/dist/commands/profile.js.map

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

package/dist/commands/regression-alert.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Regression alerting — compare current scan results against a saved
+ * baseline snapshot to detect quality regressions.
+ *
+ * Snapshots are stored locally in .judges-baseline.json.
+ */
+import type { Finding } from "../types.js";
+export interface BaselineSnapshot {
+    timestamp: string;
+    gitCommit?: string;
+    gitBranch?: string;
+    totalFindings: number;
+    bySeverity: Record<string, number>;
+    byRule: Record<string, number>;
+    findingIds: string[];
+}
+export interface RegressionReport {
+    status: "improved" | "stable" | "regressed";
+    newFindings: string[];
+    fixedFindings: string[];
+    delta: number;
+    severityDelta: Record<string, number>;
+    ruleDelta: Record<string, number>;
+    baseline: BaselineSnapshot;
+    current: BaselineSnapshot;
+}
+export declare function buildSnapshot(findings: Finding[]): BaselineSnapshot;
+export declare function saveBaseline(snapshot: BaselineSnapshot, file?: string): void;
+export declare function loadBaseline(file?: string): BaselineSnapshot | null;
+export declare function compareSnapshots(baseline: BaselineSnapshot, current: BaselineSnapshot): RegressionReport;
+export declare function runRegressionAlert(argv: string[]): Promise<void>;
+//# sourceMappingURL=regression-alert.d.ts.map

package/dist/commands/regression-alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression-alert.d.ts","sourceRoot":"","sources":["../../src/commands/regression-alert.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAqBD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAqBnE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,SAAgB,GAAG,IAAI,CAEnF;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAgB,GAAG,gBAAgB,GAAG,IAAI,CAG1E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAmCxG;AAID,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ItE"}

package/dist/commands/regression-alert.js

@@ -0,0 +1,216 @@
+/**
+ * Regression alerting — compare current scan results against a saved
+ * baseline snapshot to detect quality regressions.
+ *
+ * Snapshots are stored locally in .judges-baseline.json.
+ */
+import { readFileSync, writeFileSync, existsSync } from "fs";
+const BASELINE_FILE = ".judges-baseline.json";
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function makeFindingId(f) {
+    return `${f.ruleId}::${f.title}`;
+}
+function getGitInfo() {
+    try {
+        const { execSync } = require("child_process");
+        const commit = execSync("git rev-parse --short HEAD", { encoding: "utf-8" }).trim();
+        const branch = execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf-8" }).trim();
+        return { commit, branch };
+    }
+    catch {
+        return {};
+    }
+}
+export function buildSnapshot(findings) {
+    const git = getGitInfo();
+    const bySeverity = {};
+    const byRule = {};
+    const findingIds = [];
+    for (const f of findings) {
+        bySeverity[f.severity] = (bySeverity[f.severity] || 0) + 1;
+        byRule[f.ruleId] = (byRule[f.ruleId] || 0) + 1;
+        findingIds.push(makeFindingId(f));
+    }
+    return {
+        timestamp: new Date().toISOString(),
+        gitCommit: git.commit,
+        gitBranch: git.branch,
+        totalFindings: findings.length,
+        bySeverity,
+        byRule,
+        findingIds,
+    };
+}
+export function saveBaseline(snapshot, file = BASELINE_FILE) {
+    writeFileSync(file, JSON.stringify(snapshot, null, 2));
+}
+export function loadBaseline(file = BASELINE_FILE) {
+    if (!existsSync(file))
+        return null;
+    return JSON.parse(readFileSync(file, "utf-8"));
+}
+export function compareSnapshots(baseline, current) {
+    const baseSet = new Set(baseline.findingIds);
+    const currSet = new Set(current.findingIds);
+    const newFindings = current.findingIds.filter((id) => !baseSet.has(id));
+    const fixedFindings = baseline.findingIds.filter((id) => !currSet.has(id));
+    const delta = current.totalFindings - baseline.totalFindings;
+    const severityDelta = {};
+    const allSeverities = new Set([...Object.keys(baseline.bySeverity), ...Object.keys(current.bySeverity)]);
+    for (const sev of allSeverities) {
+        severityDelta[sev] = (current.bySeverity[sev] || 0) - (baseline.bySeverity[sev] || 0);
+    }
+    const ruleDelta = {};
+    const allRules = new Set([...Object.keys(baseline.byRule), ...Object.keys(current.byRule)]);
+    for (const rule of allRules) {
+        const d = (current.byRule[rule] || 0) - (baseline.byRule[rule] || 0);
+        if (d !== 0)
+            ruleDelta[rule] = d;
+    }
+    let status = "stable";
+    if (delta > 0 || newFindings.length > 0)
+        status = "regressed";
+    else if (delta < 0 || fixedFindings.length > 0)
+        status = "improved";
+    return {
+        status,
+        newFindings,
+        fixedFindings,
+        delta,
+        severityDelta,
+        ruleDelta,
+        baseline,
+        current,
+    };
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export async function runRegressionAlert(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges regression-alert — Detect quality regressions between scans
+
+Usage:
+  judges regression-alert --save --input results.json     Save current results as baseline
+  judges regression-alert --check --input results.json    Compare current results against baseline
+  judges regression-alert --show                          Show current baseline
+
+Options:
+  --save                Save current results as the baseline
+  --check               Compare against saved baseline
+  --show                Display stored baseline info
+  --input <path>        Results JSON file
+  --fail-on-regression  Exit with code 1 if regressions detected (CI mode)
+  --threshold <n>       Only alert if >= n new findings (default: 1)
+  --format json         JSON output
+  --help, -h            Show this help
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const inputPath = argv.find((_a, i) => argv[i - 1] === "--input");
+    const failOnRegression = argv.includes("--fail-on-regression");
+    const thresholdStr = argv.find((_a, i) => argv[i - 1] === "--threshold");
+    const threshold = thresholdStr ? parseInt(thresholdStr, 10) : 1;
+    // Show baseline
+    if (argv.includes("--show")) {
+        const baseline = loadBaseline();
+        if (!baseline) {
+            console.log("\n  No baseline saved. Run with --save first.\n");
+            return;
+        }
+        if (format === "json") {
+            console.log(JSON.stringify(baseline, null, 2));
+        }
+        else {
+            console.log(`
+  Baseline Snapshot
+  ─────────────────
+  Saved:     ${baseline.timestamp}
+  Commit:    ${baseline.gitCommit || "unknown"}
+  Branch:    ${baseline.gitBranch || "unknown"}
+  Findings:  ${baseline.totalFindings}
+`);
+            for (const [sev, count] of Object.entries(baseline.bySeverity)) {
+                console.log(`    ${sev.padEnd(10)} ${count}`);
+            }
+            console.log("");
+        }
+        return;
+    }
+    // Both --save and --check need input
+    if (!inputPath) {
+        console.error("Error: --input <path> required");
+        process.exit(1);
+    }
+    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 snapshot = buildSnapshot(findings);
+    // Save baseline
+    if (argv.includes("--save")) {
+        saveBaseline(snapshot);
+        if (format === "json") {
+            console.log(JSON.stringify(snapshot, null, 2));
+        }
+        else {
+            console.log(`\n  Baseline saved: ${snapshot.totalFindings} findings (${snapshot.gitCommit || "no git"})\n`);
+        }
+        return;
+    }
+    // Check against baseline
+    if (argv.includes("--check")) {
+        const baseline = loadBaseline();
+        if (!baseline) {
+            console.error("Error: No baseline saved. Run with --save first.");
+            process.exit(1);
+        }
+        const report = compareSnapshots(baseline, snapshot);
+        if (format === "json") {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            const icon = report.status === "improved" ? "✅" : report.status === "regressed" ? "🚨" : "➖";
+            console.log(`\n  ${icon} Status: ${report.status.toUpperCase()} (delta: ${report.delta >= 0 ? "+" : ""}${report.delta})`);
+            console.log(`  Baseline: ${baseline.totalFindings} findings (${baseline.gitCommit || "?"})`);
+            console.log(`  Current:  ${snapshot.totalFindings} findings (${snapshot.gitCommit || "?"})\n`);
+            if (report.newFindings.length > 0) {
+                console.log(`  New findings (${report.newFindings.length}):`);
+                for (const id of report.newFindings.slice(0, 20)) {
+                    console.log(`    + ${id}`);
+                }
+                if (report.newFindings.length > 20) {
+                    console.log(`    ... and ${report.newFindings.length - 20} more`);
+                }
+            }
+            if (report.fixedFindings.length > 0) {
+                console.log(`\n  Fixed findings (${report.fixedFindings.length}):`);
+                for (const id of report.fixedFindings.slice(0, 20)) {
+                    console.log(`    - ${id}`);
+                }
+                if (report.fixedFindings.length > 20) {
+                    console.log(`    ... and ${report.fixedFindings.length - 20} more`);
+                }
+            }
+            if (Object.keys(report.severityDelta).length > 0) {
+                console.log("\n  By severity:");
+                for (const [sev, d] of Object.entries(report.severityDelta)) {
+                    if (d !== 0)
+                        console.log(`    ${sev.padEnd(10)} ${d >= 0 ? "+" : ""}${d}`);
+                }
+            }
+            console.log("");
+        }
+        if (failOnRegression && report.newFindings.length >= threshold) {
+            console.error(`  ❌ Regression detected: ${report.newFindings.length} new finding(s) (threshold: ${threshold})`);
+            process.exit(1);
+        }
+        return;
+    }
+    console.log("Use --save, --check, or --show. See --help for details.");
+}
+//# sourceMappingURL=regression-alert.js.map

package/dist/commands/regression-alert.js.map

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

package/dist/commands/remediation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Remediation guides — provide step-by-step fix guidance for common
+ * finding categories, linked from finding output.
+ *
+ * Each guide includes: description, risk level, fix steps,
+ * code examples (before/after), and references.
+ */
+export interface RemediationGuide {
+    rulePrefix: string;
+    title: string;
+    category: string;
+    risk: string;
+    steps: string[];
+    beforeCode?: string;
+    afterCode?: string;
+    references: string[];
+}
+export declare function findGuide(ruleId: string): RemediationGuide | undefined;
+export declare function listGuides(): RemediationGuide[];
+export declare function runRemediationGuide(argv: string[]): void;
+//# sourceMappingURL=remediation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remediation.d.ts","sourceRoot":"","sources":["../../src/commands/remediation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AA6KD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAGtE;AAED,wBAAgB,UAAU,IAAI,gBAAgB,EAAE,CAE/C;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAmFxD"}