@kevinrabun/judges 3.38.0 → 3.41.0

package/dist/commands/metrics.js

@@ -0,0 +1,242 @@
+/**
+ * `judges metrics` — Local-only ROI metrics.
+ *
+ * Computes time-saved, defect-catch, and adoption statistics from
+ * local finding lifecycle data and feedback stores. No data leaves
+ * the developer's machine.
+ *
+ * Usage:
+ *   judges metrics                   # summary to stdout
+ *   judges metrics --format json     # machine-readable
+ *   judges metrics --since 30d       # last 30 days
+ */
+import { existsSync, readFileSync } from "fs";
+import { resolve } from "path";
+// ─── Time Estimates ─────────────────────────────────────────────────────────
+// Conservative estimates for manual review time saved per finding category.
+// Based on industry averages for manual code review discovery.
+const MINUTES_PER_FINDING = {
+    critical: 120, // Critical vulns take ~2 hours to discover manually
+    high: 60, // High-severity issues ~1 hour
+    medium: 30, // Medium issues ~30 minutes
+    low: 15, // Low issues ~15 minutes
+    info: 5, // Informational ~5 minutes
+};
+const MINUTES_PER_AUTOFIX = 20; // Each auto-fix saves ~20 min of manual patching
+// ─── Data Loading ───────────────────────────────────────────────────────────
+function loadFindingStore(dir) {
+    const storePath = resolve(dir, ".judges-findings.json");
+    if (!existsSync(storePath))
+        return undefined;
+    try {
+        const raw = JSON.parse(readFileSync(storePath, "utf-8"));
+        return raw;
+    }
+    catch {
+        return undefined;
+    }
+}
+function _loadFeedbackEntries(dir) {
+    const feedbackPath = resolve(dir, ".judges-feedback.json");
+    if (!existsSync(feedbackPath))
+        return [];
+    try {
+        const raw = JSON.parse(readFileSync(feedbackPath, "utf-8"));
+        return (raw.entries ?? []);
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Metrics Computation ────────────────────────────────────────────────────
+function parseSinceDays(since) {
+    if (!since)
+        return undefined;
+    const m = /^(\d+)d$/.exec(since);
+    return m ? parseInt(m[1], 10) : undefined;
+}
+function isWithinPeriod(timestamp, cutoff) {
+    if (!cutoff)
+        return true;
+    return new Date(timestamp) >= cutoff;
+}
+export function computeMetrics(dir, sinceDays) {
+    const store = loadFindingStore(dir);
+    const findings = store?.findings ?? [];
+    const now = new Date();
+    const cutoff = sinceDays ? new Date(now.getTime() - sinceDays * 86400000) : undefined;
+    // Filter by period
+    const relevant = cutoff
+        ? findings.filter((f) => isWithinPeriod(f.lastSeen, cutoff) || isWithinPeriod(f.firstSeen, cutoff))
+        : findings;
+    const from = cutoff?.toISOString() ??
+        (relevant.length > 0
+            ? relevant.reduce((a, b) => (a.firstSeen < b.firstSeen ? a : b)).firstSeen
+            : now.toISOString());
+    const to = now.toISOString();
+    // Categorize
+    const fixed = relevant.filter((f) => f.status === "fixed");
+    const open = relevant.filter((f) => f.status === "open");
+    const acceptedRisk = relevant.filter((f) => f.status === "accepted-risk" || f.status === "wont-fix" || f.status === "deferred");
+    const falsePositive = relevant.filter((f) => f.status === "false-positive");
+    // By severity
+    const bySeverity = {};
+    for (const f of relevant) {
+        if (!bySeverity[f.severity])
+            bySeverity[f.severity] = { detected: 0, fixed: 0 };
+        bySeverity[f.severity].detected++;
+        if (f.status === "fixed")
+            bySeverity[f.severity].fixed++;
+    }
+    // Auto-fix estimates: findings with fixes available approximate to findings with patches
+    // We count findings that were fixed quickly (< 1 day from first seen) as likely auto-fixed
+    const quickFixes = fixed.filter((f) => {
+        if (!f.fixedAt)
+            return false;
+        const openDuration = new Date(f.fixedAt).getTime() - new Date(f.firstSeen).getTime();
+        return openDuration < 86400000; // Fixed within 24 hours
+    });
+    // Time saved breakdown
+    const breakdown = [];
+    for (const sev of ["critical", "high", "medium", "low", "info"]) {
+        const count = bySeverity[sev]?.detected ?? 0;
+        if (count > 0) {
+            breakdown.push({
+                category: `${sev} findings detected`,
+                count,
+                minutesPerItem: MINUTES_PER_FINDING[sev],
+                totalMinutes: count * MINUTES_PER_FINDING[sev],
+            });
+        }
+    }
+    if (quickFixes.length > 0) {
+        breakdown.push({
+            category: "Auto-fixes applied",
+            count: quickFixes.length,
+            minutesPerItem: MINUTES_PER_AUTOFIX,
+            totalMinutes: quickFixes.length * MINUTES_PER_AUTOFIX,
+        });
+    }
+    const totalMinutes = breakdown.reduce((sum, b) => sum + b.totalMinutes, 0);
+    // Trend: compare first half vs second half of findings by firstSeen
+    const sorted = [...relevant].sort((a, b) => a.firstSeen.localeCompare(b.firstSeen));
+    const mid = Math.floor(sorted.length / 2);
+    const firstHalfOpen = sorted.slice(0, mid).filter((f) => f.status === "open").length;
+    const secondHalfOpen = sorted.slice(mid).filter((f) => f.status === "open").length;
+    const trend = sorted.length < 4
+        ? "stable"
+        : secondHalfOpen < firstHalfOpen * 0.8
+            ? "improving"
+            : secondHalfOpen > firstHalfOpen * 1.2
+                ? "degrading"
+                : "stable";
+    const runCount = store?.runNumber ?? 1;
+    return {
+        period: { from, to },
+        findings: {
+            totalDetected: relevant.length,
+            totalFixed: fixed.length,
+            totalOpen: open.length,
+            totalAcceptedRisk: acceptedRisk.length,
+            totalFalsePositive: falsePositive.length,
+            fixRate: relevant.length > 0 ? fixed.length / relevant.length : 0,
+            bySeverity,
+        },
+        autoFix: {
+            available: relevant.length, // All findings potentially have fixes
+            applied: quickFixes.length,
+            adoptionRate: relevant.length > 0 ? quickFixes.length / relevant.length : 0,
+        },
+        timeSaved: {
+            estimatedMinutes: totalMinutes,
+            estimatedHours: Math.round((totalMinutes / 60) * 10) / 10,
+            breakdown,
+        },
+        trend: {
+            direction: trend,
+            newFindingsPerRun: runCount > 0 ? relevant.length / runCount : 0,
+            fixedFindingsPerRun: runCount > 0 ? fixed.length / runCount : 0,
+        },
+    };
+}
+// ─── Formatters ─────────────────────────────────────────────────────────────
+function formatMetricsText(m) {
+    const lines = [
+        "╔══════════════════════════════════════════════════════════════╗",
+        "║              Judges — ROI Metrics (Local Only)              ║",
+        "╚══════════════════════════════════════════════════════════════╝",
+        "",
+        `Period: ${m.period.from.slice(0, 10)} → ${m.period.to.slice(0, 10)}`,
+        "",
+        "── Findings ────────────────────────────────────────────────────",
+        `   Detected:       ${m.findings.totalDetected}`,
+        `   Fixed:          ${m.findings.totalFixed}`,
+        `   Open:           ${m.findings.totalOpen}`,
+        `   Accepted risk:  ${m.findings.totalAcceptedRisk}`,
+        `   False positive: ${m.findings.totalFalsePositive}`,
+        `   Fix rate:       ${(m.findings.fixRate * 100).toFixed(1)}%`,
+        "",
+    ];
+    if (Object.keys(m.findings.bySeverity).length > 0) {
+        lines.push("   By severity:");
+        for (const [sev, s] of Object.entries(m.findings.bySeverity)) {
+            lines.push(`     ${sev.padEnd(10)} ${s.detected} detected, ${s.fixed} fixed`);
+        }
+        lines.push("");
+    }
+    lines.push("── Time Saved (estimated) ──────────────────────────────────");
+    lines.push(`   Total: ~${m.timeSaved.estimatedHours} hours`);
+    for (const b of m.timeSaved.breakdown) {
+        lines.push(`     ${b.category}: ${b.count} × ${b.minutesPerItem}min = ${b.totalMinutes}min`);
+    }
+    lines.push("");
+    lines.push("── Trend ───────────────────────────────────────────────────");
+    const arrow = m.trend.direction === "improving" ? "↗" : m.trend.direction === "degrading" ? "↘" : "→";
+    lines.push(`   Direction:        ${arrow} ${m.trend.direction}`);
+    lines.push(`   Findings/run:     ${m.trend.newFindingsPerRun.toFixed(1)}`);
+    lines.push(`   Fixed/run:        ${m.trend.fixedFindingsPerRun.toFixed(1)}`);
+    lines.push("");
+    return lines.join("\n");
+}
+// ─── CLI Entry ──────────────────────────────────────────────────────────────
+export function runMetrics(argv) {
+    let format = "text";
+    let since;
+    let dir = ".";
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--format" && argv[i + 1])
+            format = argv[++i];
+        else if (arg === "--since" && argv[i + 1])
+            since = argv[++i];
+        else if (arg === "--dir" && argv[i + 1])
+            dir = argv[++i];
+        else if (arg === "--help" || arg === "-h") {
+            console.log(`
+judges metrics — Local-only ROI metrics
+
+Usage:
+  judges metrics                   Summary to stdout
+  judges metrics --format json     Machine-readable output
+  judges metrics --since 30d       Last 30 days only
+  judges metrics --dir ./project   Target project directory
+
+Options:
+  --format <fmt>   Output format: text (default), json
+  --since <days>   Time window, e.g. 30d, 90d
+  --dir <path>     Project directory (default: cwd)
+  -h, --help       Show this help
+`);
+            process.exit(0);
+        }
+    }
+    const sinceDays = parseSinceDays(since);
+    const metrics = computeMetrics(resolve(dir), sinceDays);
+    if (format === "json") {
+        console.log(JSON.stringify(metrics, null, 2));
+    }
+    else {
+        console.log(formatMetricsText(metrics));
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/commands/metrics.js.map

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

package/dist/commands/monorepo.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `judges monorepo` — Monorepo workspace evaluation.
+ *
+ * Discovers packages in a monorepo (lerna, pnpm-workspace, turbo, packages/,
+ * apps/) and evaluates each one with its local `.judgesrc` cascading config.
+ *
+ * Usage:
+ *   judges monorepo                       # Auto-detect and evaluate all packages
+ *   judges monorepo --list                # List detected packages only
+ *   judges monorepo --concurrency 4       # Evaluate 4 packages in parallel
+ *   judges monorepo --format json         # JSON summary
+ */
+import type { JudgesConfig } from "../types.js";
+export interface MonorepoPackage {
+    /** Package name (from package.json name or directory name) */
+    name: string;
+    /** Absolute path to the package */
+    path: string;
+    /** Relative path from root */
+    relativePath: string;
+    /** Has its own .judgesrc */
+    hasLocalConfig: boolean;
+    /** Resolved config (cascading merge) */
+    config: JudgesConfig;
+    /** Languages detected */
+    languages: string[];
+}
+export interface MonorepoScanResult {
+    /** Root directory */
+    root: string;
+    /** Monorepo tool detected */
+    tool: "pnpm" | "lerna" | "turbo" | "nx" | "npm-workspaces" | "heuristic";
+    /** Discovered packages */
+    packages: MonorepoPackage[];
+}
+export declare function discoverPackages(root: string): MonorepoScanResult;
+export declare function runMonorepoCommand(argv: string[]): void;
+//# sourceMappingURL=monorepo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo.d.ts","sourceRoot":"","sources":["../../src/commands/monorepo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,gBAAgB,GAAG,WAAW,CAAC;IACzE,0BAA0B;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAqGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA2EjE;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6DvD"}

package/dist/commands/monorepo.js

@@ -0,0 +1,233 @@
+/**
+ * `judges monorepo` — Monorepo workspace evaluation.
+ *
+ * Discovers packages in a monorepo (lerna, pnpm-workspace, turbo, packages/,
+ * apps/) and evaluates each one with its local `.judgesrc` cascading config.
+ *
+ * Usage:
+ *   judges monorepo                       # Auto-detect and evaluate all packages
+ *   judges monorepo --list                # List detected packages only
+ *   judges monorepo --concurrency 4       # Evaluate 4 packages in parallel
+ *   judges monorepo --format json         # JSON summary
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { resolve, join, relative, basename } from "path";
+import { loadCascadingConfig } from "../config.js";
+// ─── Package Discovery ─────────────────────────────────────────────────────
+function readJsonSafe(filepath) {
+    try {
+        return JSON.parse(readFileSync(filepath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function readYamlWorkspaces(filepath) {
+    try {
+        const content = readFileSync(filepath, "utf-8");
+        const patterns = [];
+        // Simple extraction — lines starting with "  - " under "packages:"
+        let inPackages = false;
+        for (const line of content.split("\n")) {
+            if (/^packages:/i.test(line.trim())) {
+                inPackages = true;
+                continue;
+            }
+            if (inPackages && line.match(/^\s+-\s+/)) {
+                patterns.push(line
+                    .replace(/^\s+-\s+/, "")
+                    .replace(/['"]/g, "")
+                    .trim());
+            }
+            else if (inPackages && !line.match(/^\s/)) {
+                inPackages = false;
+            }
+        }
+        return patterns;
+    }
+    catch {
+        return [];
+    }
+}
+function expandGlobDirs(root, patterns) {
+    const dirs = [];
+    for (const pattern of patterns) {
+        const clean = pattern.replace(/\/\*$/, "").replace(/\*\*$/, "");
+        const base = join(root, clean);
+        if (!existsSync(base) || !statSync(base).isDirectory())
+            continue;
+        // If pattern ends with * — list subdirectories
+        if (pattern.endsWith("/*") || pattern.endsWith("/**")) {
+            try {
+                for (const entry of readdirSync(base)) {
+                    const full = join(base, entry);
+                    if (statSync(full).isDirectory())
+                        dirs.push(full);
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+        else {
+            dirs.push(base);
+        }
+    }
+    return dirs;
+}
+function detectLanguagesInDir(dir) {
+    const langs = new Set();
+    const EXT_MAP = {
+        ".ts": "typescript",
+        ".tsx": "typescript",
+        ".js": "javascript",
+        ".jsx": "javascript",
+        ".mjs": "javascript",
+        ".py": "python",
+        ".go": "go",
+        ".rs": "rust",
+        ".java": "java",
+        ".cs": "csharp",
+        ".rb": "ruby",
+        ".php": "php",
+        ".swift": "swift",
+        ".kt": "kotlin",
+        ".cpp": "cpp",
+        ".cc": "cpp",
+        ".hpp": "cpp",
+        ".c": "c",
+        ".h": "c",
+    };
+    try {
+        const entries = readdirSync(dir, { recursive: true, withFileTypes: false });
+        for (const entry of entries.slice(0, 500)) {
+            const ext = entry.substring(entry.lastIndexOf(".")).toLowerCase();
+            if (EXT_MAP[ext])
+                langs.add(EXT_MAP[ext]);
+        }
+    }
+    catch {
+        /* skip */
+    }
+    return [...langs];
+}
+export function discoverPackages(root) {
+    const absRoot = resolve(root);
+    let tool = "heuristic";
+    let packageDirs = [];
+    // 1. pnpm-workspace.yaml
+    const pnpmWs = join(absRoot, "pnpm-workspace.yaml");
+    if (existsSync(pnpmWs)) {
+        tool = "pnpm";
+        const patterns = readYamlWorkspaces(pnpmWs);
+        packageDirs = expandGlobDirs(absRoot, patterns);
+    }
+    // 2. lerna.json
+    if (packageDirs.length === 0) {
+        const lernaPath = join(absRoot, "lerna.json");
+        if (existsSync(lernaPath)) {
+            tool = "lerna";
+            const lerna = readJsonSafe(lernaPath);
+            const patterns = lerna?.packages || ["packages/*"];
+            packageDirs = expandGlobDirs(absRoot, patterns);
+        }
+    }
+    // 3. turbo.json — check root package.json workspaces
+    if (packageDirs.length === 0 && existsSync(join(absRoot, "turbo.json"))) {
+        tool = "turbo";
+        const rootPkg = readJsonSafe(join(absRoot, "package.json"));
+        const workspaces = rootPkg?.workspaces || [];
+        packageDirs = expandGlobDirs(absRoot, workspaces.length > 0 ? workspaces : ["packages/*", "apps/*"]);
+    }
+    // 4. npm workspaces (package.json "workspaces" field)
+    if (packageDirs.length === 0) {
+        const rootPkg = readJsonSafe(join(absRoot, "package.json"));
+        if (rootPkg?.workspaces) {
+            tool = "npm-workspaces";
+            const workspaces = Array.isArray(rootPkg.workspaces)
+                ? rootPkg.workspaces
+                : rootPkg.workspaces.packages || [];
+            packageDirs = expandGlobDirs(absRoot, workspaces);
+        }
+    }
+    // 5. nx.json
+    if (packageDirs.length === 0 && existsSync(join(absRoot, "nx.json"))) {
+        tool = "nx";
+        packageDirs = expandGlobDirs(absRoot, ["packages/*", "apps/*", "libs/*"]);
+    }
+    // 6. Heuristic — look for packages/ and apps/ directories
+    if (packageDirs.length === 0) {
+        packageDirs = expandGlobDirs(absRoot, ["packages/*", "apps/*"]);
+    }
+    // Build package metadata
+    const packages = packageDirs
+        .filter((dir) => existsSync(dir) && statSync(dir).isDirectory())
+        .map((dir) => {
+        const pkg = readJsonSafe(join(dir, "package.json"));
+        const hasLocalConfig = existsSync(join(dir, ".judgesrc"));
+        const config = loadCascadingConfig(dir, absRoot);
+        const name = pkg?.name || basename(dir);
+        return {
+            name,
+            path: dir,
+            relativePath: relative(absRoot, dir),
+            hasLocalConfig,
+            config,
+            languages: detectLanguagesInDir(dir),
+        };
+    });
+    return { root: absRoot, tool, packages };
+}
+// ─── CLI Runner ─────────────────────────────────────────────────────────────
+export function runMonorepoCommand(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges monorepo — Monorepo workspace evaluation
+
+Usage:
+  judges monorepo [root]                    Auto-detect and list packages
+  judges monorepo --list                    List detected packages only
+  judges monorepo --format json             JSON output
+
+Supports:
+  • pnpm-workspace.yaml
+  • lerna.json
+  • turbo.json
+  • npm workspaces (package.json "workspaces")
+  • nx.json
+  • Heuristic (packages/, apps/ directories)
+
+Each package inherits its .judgesrc config via cascading config resolution.
+
+Options:
+  --list                List packages only (no evaluation)
+  --format <fmt>        Output format: text, json
+  --help, -h            Show this help
+`);
+        return;
+    }
+    const root = argv.find((a, i) => i > 1 && !a.startsWith("-") && argv[i - 1] !== "--format") || ".";
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    console.log(`\n  Scanning for monorepo packages in ${resolve(root)}...\n`);
+    const result = discoverPackages(resolve(root));
+    if (format === "json") {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    // Text output
+    console.log(`  Monorepo tool: ${result.tool}`);
+    console.log(`  Packages found: ${result.packages.length}\n`);
+    if (result.packages.length === 0) {
+        console.log("  No packages detected. Run from a monorepo root or use manual package paths.\n");
+        return;
+    }
+    const nameWidth = Math.max(12, ...result.packages.map((p) => p.name.length));
+    console.log(`  ${"PACKAGE".padEnd(nameWidth)}  ${"PATH".padEnd(30)}  ${"CONFIG"}  LANGUAGES`);
+    console.log(`  ${"─".repeat(nameWidth)}  ${"─".repeat(30)}  ${"──────"}  ${"─".repeat(20)}`);
+    for (const pkg of result.packages) {
+        const configStatus = pkg.hasLocalConfig ? "local " : "inherit";
+        console.log(`  ${pkg.name.padEnd(nameWidth)}  ${pkg.relativePath.padEnd(30)}  ${configStatus}  ${pkg.languages.join(", ") || "—"}`);
+    }
+    console.log("");
+}
+//# sourceMappingURL=monorepo.js.map

package/dist/commands/monorepo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo.js","sourceRoot":"","sources":["../../src/commands/monorepo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA6BnD,8EAA8E;AAE9E,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,mEAAmE;QACnE,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBACpC,UAAU,GAAG,IAAI,CAAC;gBAClB,SAAS;YACX,CAAC;YACD,IAAI,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzC,QAAQ,CAAC,IAAI,CACX,IAAI;qBACD,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;qBACvB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;qBACpB,IAAI,EAAE,CACV,CAAC;YACJ,CAAC;iBAAM,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5C,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,QAAkB;IACtD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;YAAE,SAAS;QAEjE,+CAA+C;QAC/C,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC/B,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;wBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,OAAO,GAA2B;QACtC,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,GAAG;QACT,IAAI,EAAE,GAAG;KACV,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAa,CAAC;QACxF,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAClE,IAAI,OAAO,CAAC,GAAG,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,UAAU;IACZ,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,IAAI,GAA+B,WAAW,CAAC;IACnD,IAAI,WAAW,GAAa,EAAE,CAAC;IAE/B,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,IAAI,GAAG,MAAM,CAAC;QACd,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC5C,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,gBAAgB;IAChB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,GAAG,OAAO,CAAC;YACf,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAI,KAAK,EAAE,QAAqB,IAAI,CAAC,YAAY,CAAC,CAAC;YACjE,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;QACxE,IAAI,GAAG,OAAO,CAAC;QACf,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAI,OAAO,EAAE,UAAuB,IAAI,EAAE,CAAC;QAC3D,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvG,CAAC;IAED,sDAAsD;IACtD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAC5D,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACxB,IAAI,GAAG,gBAAgB,CAAC;YACxB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;gBAClD,CAAC,CAAE,OAAO,CAAC,UAAuB;gBAClC,CAAC,CAAE,OAAO,CAAC,UAAuC,CAAC,QAAQ,IAAI,EAAE,CAAC;YACpE,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,aAAa;IACb,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QACrE,IAAI,GAAG,IAAI,CAAC;QACZ,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,0DAA0D;IAC1D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,yBAAyB;IACzB,MAAM,QAAQ,GAAsB,WAAW;SAC5C,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;SAC/D,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAI,GAAG,EAAE,IAAe,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;QAEpD,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,GAAG;YACT,YAAY,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;YACpC,cAAc;YACd,MAAM;YACN,SAAS,EAAE,oBAAoB,CAAC,GAAG,CAAC;SACrC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsBf,CAAC,CAAC;QACC,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,GAAG,CAAC;IACnG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,MAAM,CAAC;IAE1E,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,cAAc;IACd,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IAE7D,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7E,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,QAAQ,aAAa,CAAC,CAAC;IAC9F,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,QAAQ,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAE7F,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/D,OAAO,CAAC,GAAG,CACT,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,YAAY,KAAK,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,EAAE,CACvH,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

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