@kevinrabun/judges 3.40.0 → 3.42.0

package/dist/commands/notify.d.ts

@@ -0,0 +1,79 @@
+/**
+ * `judges notify` — Webhook notification system for findings alerts.
+ *
+ * Sends evaluation results to configured webhook endpoints (Slack, Teams,
+ * generic HTTP). Users configure their own endpoints — Judges never stores
+ * or processes data on behalf of users.
+ *
+ * Usage:
+ *   judges notify --file results.json --channel slack        # Send to Slack
+ *   judges notify --file results.json --channel teams        # Send to Teams
+ *   judges notify --file results.json --channel webhook      # Generic webhook
+ *   judges eval src/app.ts --notify                          # Evaluate + notify
+ *
+ * Configuration in .judgesrc:
+ * ```json
+ * {
+ *   "notifications": {
+ *     "channels": [
+ *       { "type": "slack",   "url": "https://hooks.slack.com/..." },
+ *       { "type": "teams",   "url": "https://outlook.office.com/webhook/..." },
+ *       { "type": "webhook", "url": "https://my-server.com/judges-hook",
+ *         "headers": { "Authorization": "Bearer ..." } }
+ *     ],
+ *     "minSeverity": "medium",
+ *     "onlyOnFailure": false
+ *   }
+ * }
+ * ```
+ */
+import type { Finding, Severity, TribunalVerdict } from "../types.js";
+export type NotificationChannelType = "slack" | "teams" | "webhook";
+export interface NotificationChannel {
+    /** Channel type */
+    type: NotificationChannelType;
+    /** Webhook URL — provided and hosted by the user */
+    url: string;
+    /** Optional custom headers (e.g. auth tokens) */
+    headers?: Record<string, string>;
+    /** Optional display name for this channel */
+    name?: string;
+}
+export interface NotificationConfig {
+    /** Channels to send notifications to */
+    channels: NotificationChannel[];
+    /** Only notify for findings at or above this severity */
+    minSeverity?: Severity;
+    /** Only send when the verdict is "fail" */
+    onlyOnFailure?: boolean;
+}
+export interface NotificationPayload {
+    /** Project or file being evaluated */
+    target: string;
+    /** Overall verdict */
+    verdict: "pass" | "fail" | "warning";
+    /** Aggregate score (0-10) */
+    score: number;
+    /** Summary counts by severity */
+    summary: Record<Severity, number>;
+    /** Total finding count */
+    totalFindings: number;
+    /** Top findings (limited to 10 for brevity) */
+    topFindings: Array<{
+        ruleId: string;
+        severity: Severity;
+        title: string;
+        line?: number;
+    }>;
+    /** Timestamp of evaluation */
+    timestamp: string;
+}
+export declare function buildNotificationPayload(target: string, verdict: TribunalVerdict, filteredFindings: Finding[]): NotificationPayload;
+export declare function sendNotification(channel: NotificationChannel, payload: NotificationPayload): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+export declare function notifyAllChannels(config: NotificationConfig, target: string, verdict: TribunalVerdict): Promise<void>;
+export declare function parseNotificationConfig(obj: Record<string, unknown>): NotificationConfig | undefined;
+export declare function runNotify(argv: string[]): Promise<void>;
+//# sourceMappingURL=notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/commands/notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAItE,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,IAAI,EAAE,uBAAuB,CAAC;IAC9B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,yDAAyD;IACzD,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClC,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,QAAQ,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,EACxB,gBAAgB,EAAE,OAAO,EAAE,GAC1B,mBAAmB,CAyBrB;AA6FD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC/C;AAID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAMD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,GAAG,SAAS,CAmCpG;AAID,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyF7D"}

package/dist/commands/notify.js

@@ -0,0 +1,325 @@
+/**
+ * `judges notify` — Webhook notification system for findings alerts.
+ *
+ * Sends evaluation results to configured webhook endpoints (Slack, Teams,
+ * generic HTTP). Users configure their own endpoints — Judges never stores
+ * or processes data on behalf of users.
+ *
+ * Usage:
+ *   judges notify --file results.json --channel slack        # Send to Slack
+ *   judges notify --file results.json --channel teams        # Send to Teams
+ *   judges notify --file results.json --channel webhook      # Generic webhook
+ *   judges eval src/app.ts --notify                          # Evaluate + notify
+ *
+ * Configuration in .judgesrc:
+ * ```json
+ * {
+ *   "notifications": {
+ *     "channels": [
+ *       { "type": "slack",   "url": "https://hooks.slack.com/..." },
+ *       { "type": "teams",   "url": "https://outlook.office.com/webhook/..." },
+ *       { "type": "webhook", "url": "https://my-server.com/judges-hook",
+ *         "headers": { "Authorization": "Bearer ..." } }
+ *     ],
+ *     "minSeverity": "medium",
+ *     "onlyOnFailure": false
+ *   }
+ * }
+ * ```
+ */
+// ─── Severity Filtering ─────────────────────────────────────────────────────
+const SEVERITY_RANK = { critical: 0, high: 1, medium: 2, low: 3, info: 4 };
+function meetsMinSeverity(findings, minSeverity) {
+    const threshold = SEVERITY_RANK[minSeverity] ?? 4;
+    return findings.filter((f) => (SEVERITY_RANK[f.severity] ?? 4) <= threshold);
+}
+// ─── Payload Construction ───────────────────────────────────────────────────
+export function buildNotificationPayload(target, verdict, filteredFindings) {
+    const summary = { critical: 0, high: 0, medium: 0, low: 0, info: 0 };
+    for (const f of filteredFindings) {
+        summary[f.severity] = (summary[f.severity] || 0) + 1;
+    }
+    const topFindings = filteredFindings
+        .sort((a, b) => (SEVERITY_RANK[a.severity] ?? 4) - (SEVERITY_RANK[b.severity] ?? 4))
+        .slice(0, 10)
+        .map((f) => ({
+        ruleId: f.ruleId,
+        severity: f.severity,
+        title: f.title,
+        line: f.lineNumbers?.[0],
+    }));
+    return {
+        target,
+        verdict: verdict.overallVerdict,
+        score: verdict.overallScore,
+        summary,
+        totalFindings: filteredFindings.length,
+        topFindings,
+        timestamp: new Date().toISOString(),
+    };
+}
+// ─── Channel Formatters ─────────────────────────────────────────────────────
+function formatSlackPayload(payload) {
+    const emoji = payload.verdict === "pass" ? ":white_check_mark:" : payload.verdict === "fail" ? ":x:" : ":warning:";
+    const color = payload.verdict === "pass" ? "#36a64f" : payload.verdict === "fail" ? "#e01e5a" : "#ecb22e";
+    const findingLines = payload.topFindings
+        .map((f) => `• \`${f.ruleId}\` [${f.severity.toUpperCase()}] ${f.title}${f.line ? ` (L${f.line})` : ""}`)
+        .join("\n");
+    return {
+        attachments: [
+            {
+                color,
+                blocks: [
+                    {
+                        type: "section",
+                        text: {
+                            type: "mrkdwn",
+                            text: `${emoji} *Judges Panel — ${payload.verdict.toUpperCase()}*\n*Target:* \`${payload.target}\`\n*Score:* ${payload.score}/10 | *Findings:* ${payload.totalFindings}`,
+                        },
+                    },
+                    ...(payload.totalFindings > 0
+                        ? [
+                            {
+                                type: "section",
+                                text: {
+                                    type: "mrkdwn",
+                                    text: `*Summary:* ${Object.entries(payload.summary)
+                                        .filter(([, v]) => v > 0)
+                                        .map(([k, v]) => `${k}: ${v}`)
+                                        .join(" | ")}`,
+                                },
+                            },
+                        ]
+                        : []),
+                    ...(findingLines
+                        ? [
+                            {
+                                type: "section",
+                                text: {
+                                    type: "mrkdwn",
+                                    text: `*Top Findings:*\n${findingLines}`,
+                                },
+                            },
+                        ]
+                        : []),
+                ],
+            },
+        ],
+    };
+}
+function formatTeamsPayload(payload) {
+    const color = payload.verdict === "pass" ? "00FF00" : payload.verdict === "fail" ? "FF0000" : "FFAA00";
+    const icon = payload.verdict === "pass" ? "✅" : payload.verdict === "fail" ? "❌" : "⚠️";
+    const findingRows = payload.topFindings.map((f) => `| ${f.ruleId} | ${f.severity} | ${f.title} |`).join("\n");
+    return {
+        "@type": "MessageCard",
+        "@context": "http://schema.org/extensions",
+        themeColor: color,
+        summary: `Judges Panel — ${payload.verdict.toUpperCase()}`,
+        sections: [
+            {
+                activityTitle: `${icon} Judges Panel — ${payload.verdict.toUpperCase()}`,
+                facts: [
+                    { name: "Target", value: payload.target },
+                    { name: "Score", value: `${payload.score}/10` },
+                    { name: "Findings", value: String(payload.totalFindings) },
+                    ...Object.entries(payload.summary)
+                        .filter(([, v]) => v > 0)
+                        .map(([k, v]) => ({ name: k.charAt(0).toUpperCase() + k.slice(1), value: String(v) })),
+                ],
+                markdown: true,
+                text: payload.topFindings.length > 0
+                    ? `**Top Findings:**\n\n| Rule | Severity | Title |\n|------|----------|-------|\n${findingRows}`
+                    : "",
+            },
+        ],
+    };
+}
+function formatGenericWebhookPayload(payload) {
+    return payload;
+}
+// ─── Send Notification ──────────────────────────────────────────────────────
+export async function sendNotification(channel, payload) {
+    let body;
+    switch (channel.type) {
+        case "slack":
+            body = formatSlackPayload(payload);
+            break;
+        case "teams":
+            body = formatTeamsPayload(payload);
+            break;
+        case "webhook":
+        default:
+            body = formatGenericWebhookPayload(payload);
+            break;
+    }
+    try {
+        const response = await fetch(channel.url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(channel.headers ?? {}),
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            return { success: false, error: `HTTP ${response.status}: ${response.statusText}` };
+        }
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── Notify All Channels ────────────────────────────────────────────────────
+export async function notifyAllChannels(config, target, verdict) {
+    // Apply severity filter
+    const filtered = config.minSeverity ? meetsMinSeverity(verdict.findings, config.minSeverity) : verdict.findings;
+    // Skip if onlyOnFailure and verdict is pass
+    if (config.onlyOnFailure && verdict.overallVerdict === "pass") {
+        return;
+    }
+    // Skip if no findings after filtering and onlyOnFailure
+    if (filtered.length === 0 && config.onlyOnFailure) {
+        return;
+    }
+    const payload = buildNotificationPayload(target, verdict, filtered);
+    const results = await Promise.allSettled(config.channels.map(async (ch) => {
+        const result = await sendNotification(ch, payload);
+        return { channel: ch.name || ch.type, ...result };
+    }));
+    for (const r of results) {
+        if (r.status === "fulfilled") {
+            if (r.value.success) {
+                console.log(`  ✓ Notification sent to ${r.value.channel}`);
+            }
+            else {
+                console.error(`  ✗ Notification failed for ${r.value.channel}: ${r.value.error}`);
+            }
+        }
+        else {
+            console.error(`  ✗ Notification error: ${r.reason}`);
+        }
+    }
+}
+// ─── Config Parsing ─────────────────────────────────────────────────────────
+const VALID_SEVERITIES = new Set(["critical", "high", "medium", "low", "info"]);
+export function parseNotificationConfig(obj) {
+    if (!obj.notifications)
+        return undefined;
+    const raw = obj.notifications;
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return undefined;
+    if (!Array.isArray(raw.channels))
+        return undefined;
+    const channels = [];
+    for (const ch of raw.channels) {
+        if (typeof ch !== "object" || ch === null)
+            continue;
+        const type = ch.type;
+        const url = ch.url;
+        if (!type || !url || !["slack", "teams", "webhook"].includes(type))
+            continue;
+        if (typeof url !== "string" || !url.startsWith("https://"))
+            continue;
+        channels.push({
+            type: type,
+            url,
+            headers: typeof ch.headers === "object" && ch.headers !== null ? ch.headers : undefined,
+            name: typeof ch.name === "string" ? ch.name : undefined,
+        });
+    }
+    if (channels.length === 0)
+        return undefined;
+    return {
+        channels,
+        minSeverity: typeof raw.minSeverity === "string" && VALID_SEVERITIES.has(raw.minSeverity)
+            ? raw.minSeverity
+            : undefined,
+        onlyOnFailure: typeof raw.onlyOnFailure === "boolean" ? raw.onlyOnFailure : false,
+    };
+}
+// ─── CLI Runner ─────────────────────────────────────────────────────────────
+export async function runNotify(argv) {
+    const file = argv.find((_a, i) => argv[i - 1] === "--file") || argv.find((_a, i) => argv[i - 1] === "-f");
+    const channelType = argv.find((_a, i) => argv[i - 1] === "--channel");
+    const url = argv.find((_a, i) => argv[i - 1] === "--url");
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges notify — Send evaluation results to webhook channels
+
+Usage:
+  judges notify --file results.json                    Send to configured channels
+  judges notify --file results.json --channel slack    Send to specific channel type
+  judges notify --url https://hooks.slack.com/...      Send to ad-hoc webhook
+
+Options:
+  --file, -f     Path to a Judges JSON result file
+  --channel      Channel type filter: slack | teams | webhook
+  --url          Ad-hoc webhook URL (overrides config)
+  --help, -h     Show this help
+`);
+        return;
+    }
+    // Load notification config from .judgesrc
+    const { existsSync: exists, readFileSync: readFile } = await import("fs");
+    let notifConfig;
+    for (const name of [".judgesrc", ".judgesrc.json"]) {
+        if (exists(name)) {
+            try {
+                const raw = JSON.parse(readFile(name, "utf-8"));
+                notifConfig = parseNotificationConfig(raw);
+            }
+            catch {
+                // Skip invalid config
+            }
+            break;
+        }
+    }
+    // Ad-hoc URL override
+    if (url) {
+        notifConfig = {
+            channels: [{ type: channelType || "webhook", url }],
+        };
+    }
+    if (!notifConfig || notifConfig.channels.length === 0) {
+        console.error('Error: No notification channels configured. Add "notifications" to .judgesrc or use --url.');
+        process.exit(1);
+    }
+    // Filter to specific channel type if requested
+    if (channelType && !url) {
+        notifConfig.channels = notifConfig.channels.filter((ch) => ch.type === channelType);
+        if (notifConfig.channels.length === 0) {
+            console.error(`Error: No ${channelType} channels configured.`);
+            process.exit(1);
+        }
+    }
+    if (!file) {
+        console.error("Error: --file is required. Provide a Judges JSON result file.");
+        process.exit(1);
+    }
+    if (!exists(file)) {
+        console.error(`Error: File not found: ${file}`);
+        process.exit(1);
+    }
+    try {
+        const data = JSON.parse(readFile(file, "utf-8"));
+        const verdict = {
+            overallVerdict: data.overallVerdict || data.verdict || "pass",
+            overallScore: data.overallScore || data.score || 0,
+            findings: data.findings || [],
+            evaluations: data.evaluations || [],
+            summary: data.summary || "",
+            criticalCount: data.criticalCount || 0,
+            highCount: data.highCount || 0,
+            timestamp: data.timestamp || new Date().toISOString(),
+        };
+        console.log(`Sending notifications for ${file}...`);
+        await notifyAllChannels(notifConfig, file, verdict);
+    }
+    catch (err) {
+        console.error(`Error reading results file: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=notify.js.map

package/dist/commands/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../src/commands/notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAkDH,+EAA+E;AAE/E,MAAM,aAAa,GAA6B,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAErG,SAAS,gBAAgB,CAAC,QAAmB,EAAE,WAAqB;IAClE,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC;AAC/E,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,OAAwB,EACxB,gBAA2B;IAE3B,MAAM,OAAO,GAA6B,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/F,KAAK,MAAM,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB;SACjC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;SACnF,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;KACzB,CAAC,CAAC,CAAC;IAEN,OAAO;QACL,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,cAAc;QAC/B,KAAK,EAAE,OAAO,CAAC,YAAY;QAC3B,OAAO;QACP,aAAa,EAAE,gBAAgB,CAAC,MAAM;QACtC,WAAW;QACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,+EAA+E;AAE/E,SAAS,kBAAkB,CAAC,OAA4B;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;IACnH,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1G,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;SACxG,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;QACL,WAAW,EAAE;YACX;gBACE,KAAK;gBACL,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,GAAG,KAAK,oBAAoB,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,kBAAkB,OAAO,CAAC,MAAM,gBAAgB,OAAO,CAAC,KAAK,qBAAqB,OAAO,CAAC,aAAa,EAAE;yBACzK;qBACF;oBACD,GAAG,CAAC,OAAO,CAAC,aAAa,GAAG,CAAC;wBAC3B,CAAC,CAAC;4BACE;gCACE,IAAI,EAAE,SAAS;gCACf,IAAI,EAAE;oCACJ,IAAI,EAAE,QAAQ;oCACd,IAAI,EAAE,cAAc,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;yCAChD,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;yCACxB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;yCAC7B,IAAI,CAAC,KAAK,CAAC,EAAE;iCACjB;6BACF;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,YAAY;wBACd,CAAC,CAAC;4BACE;gCACE,IAAI,EAAE,SAAS;gCACf,IAAI,EAAE;oCACJ,IAAI,EAAE,QAAQ;oCACd,IAAI,EAAE,oBAAoB,YAAY,EAAE;iCACzC;6BACF;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,OAA4B;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvG,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAExF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9G,OAAO;QACL,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,8BAA8B;QAC1C,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,kBAAkB,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE;QAC1D,QAAQ,EAAE;YACR;gBACE,aAAa,EAAE,GAAG,IAAI,mBAAmB,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE;gBACxE,KAAK,EAAE;oBACL,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE;oBACzC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,KAAK,EAAE;oBAC/C,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;oBAC1D,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;yBAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;yBACxB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;iBACzF;gBACD,QAAQ,EAAE,IAAI;gBACd,IAAI,EACF,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;oBAC5B,CAAC,CAAC,kFAAkF,WAAW,EAAE;oBACjG,CAAC,CAAC,EAAE;aACT;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,OAA4B;IAC/D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA4B,EAC5B,OAA4B;IAE5B,IAAI,IAAY,CAAC;IACjB,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,OAAO;YACV,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,OAAO;YACV,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM;QACR,KAAK,SAAS,CAAC;QACf;YACE,IAAI,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM;IACV,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;YACxC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;aAC3B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;QACtF,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACrF,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA0B,EAC1B,MAAc,EACd,OAAwB;IAExB,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAEhH,4CAA4C;IAC5C,IAAI,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,wDAAwD;IACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QAClD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEpE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACpD,CAAC,CAAC,CACH,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1F,MAAM,UAAU,uBAAuB,CAAC,GAA4B;IAClE,IAAI,CAAC,GAAG,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IAEzC,MAAM,GAAG,GAAG,GAAG,CAAC,aAAwC,CAAC;IACzD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnD,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,QAA0C,EAAE,CAAC;QAChE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI;YAAE,SAAS;QACpD,MAAM,IAAI,GAAG,EAAE,CAAC,IAAc,CAAC;QAC/B,MAAM,GAAG,GAAG,EAAE,CAAC,GAAa,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7E,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAErE,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,IAA+B;YACrC,GAAG;YACH,OAAO,EACL,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAE,EAAE,CAAC,OAAkC,CAAC,CAAC,CAAC,SAAS;YAC5G,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SACxD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,OAAO;QACL,QAAQ;QACR,WAAW,EACT,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAuB,CAAC;YACtF,CAAC,CAAE,GAAG,CAAC,WAAwB;YAC/B,CAAC,CAAC,SAAS;QACf,aAAa,EAAE,OAAO,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK;KAClF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC1G,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,WAAW,CAAwC,CAAC;IAC7G,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;IAE1D,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;CAaf,CAAC,CAAC;QACC,OAAO;IACT,CAAC;IAED,0CAA0C;IAC1C,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,WAA2C,CAAC;IAEhD,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,EAAE,CAAC;QACnD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAA4B,CAAC;gBAC3E,WAAW,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,GAAG,EAAE,CAAC;QACR,WAAW,GAAG;YACZ,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,IAAI,SAAS,EAAE,GAAG,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,4FAA4F,CAAC,CAAC;QAC5G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QACpF,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,aAAa,WAAW,uBAAuB,CAAC,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACjD,MAAM,OAAO,GAAoB;YAC/B,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,IAAI,MAAM;YAC7D,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;YAClD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;YAC9B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtD,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,KAAK,CAAC,CAAC;QACpD,MAAM,iBAAiB,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/pr-summary.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+import type { TribunalVerdict } from "../types.js";
+export interface PrSummaryOptions {
+    owner: string;
+    repo: string;
+    prNumber: number;
+    token: string;
+    verdict: TribunalVerdict;
+    baseUrl?: string;
+}
+interface PrSummaryResult {
+    commentId: number;
+    updated: boolean;
+    url: string;
+}
+export declare function formatPrSummary(verdict: TribunalVerdict): string;
+export declare function postPrSummary(options: PrSummaryOptions): Promise<PrSummaryResult>;
+export declare function runPrSummary(argv: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=pr-summary.d.ts.map

package/dist/commands/pr-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-summary.d.ts","sourceRoot":"","sources":["../../src/commands/pr-summary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAInD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAmBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAoDhE;AAsBD,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiCvF;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFhE"}

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