@kevinrabun/judges 3.41.0 → 3.43.0

package/dist/commands/upload.js

@@ -0,0 +1,173 @@
+/**
+ * `judges upload` — Upload SARIF results to GitHub Code Scanning.
+ *
+ * Pushes evaluation results directly to GitHub's Code Scanning API,
+ * making findings visible in the Security tab without needing
+ * github/codeql-action/upload-sarif in CI.
+ *
+ * Usage:
+ *   judges upload results.sarif.json                   Upload SARIF file
+ *   judges upload --file results.json --repo owner/repo  Convert + upload
+ *   judges upload --ref refs/heads/main --sha abc123     Specify git ref
+ */
+import { existsSync, readFileSync } from "fs";
+import { execSync } from "child_process";
+import { resolve, basename } from "path";
+import { gzipSync } from "zlib";
+// ─── Git Helpers ────────────────────────────────────────────────────────────
+function detectGitRef() {
+    try {
+        const branch = execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf-8" }).trim();
+        return `refs/heads/${branch}`;
+    }
+    catch {
+        return "refs/heads/main";
+    }
+}
+function detectGitSha() {
+    try {
+        return execSync("git rev-parse HEAD", { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return "";
+    }
+}
+function detectRepo() {
+    try {
+        const remote = execSync("git remote get-url origin", { encoding: "utf-8" }).trim();
+        const match = remote.match(/github\.com[/:]([^/]+\/[^/.]+)/);
+        return match?.[1]?.replace(/\.git$/, "") || "";
+    }
+    catch {
+        return "";
+    }
+}
+// ─── Upload ────────────────────────────────────────────────────────────────
+async function uploadSarif(options) {
+    const { sarifPath, repo, ref, commitSha, token } = options;
+    if (!existsSync(sarifPath)) {
+        return { success: false, error: `File not found: ${sarifPath}` };
+    }
+    const sarifContent = readFileSync(sarifPath, "utf-8");
+    // Validate it's valid JSON
+    try {
+        JSON.parse(sarifContent);
+    }
+    catch {
+        return { success: false, error: "Invalid JSON in SARIF file" };
+    }
+    // GitHub requires gzip + base64 encoding
+    const compressed = gzipSync(Buffer.from(sarifContent, "utf-8"));
+    const encoded = compressed.toString("base64");
+    const apiUrl = `https://api.github.com/repos/${repo}/code-scanning/sarifs`;
+    const body = JSON.stringify({
+        commit_sha: commitSha,
+        ref,
+        sarif: encoded,
+        tool_name: "Judges Panel",
+    });
+    try {
+        const response = await fetch(apiUrl, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: "application/vnd.github+json",
+                "Content-Type": "application/json",
+                "X-GitHub-Api-Version": "2022-11-28",
+            },
+            body,
+        });
+        if (response.ok || response.status === 202) {
+            const data = (await response.json());
+            return {
+                success: true,
+                id: data.id,
+                url: data.url,
+            };
+        }
+        const errorData = (await response.json().catch(() => ({})));
+        return {
+            success: false,
+            error: `GitHub API ${response.status}: ${errorData.message || response.statusText}`,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Upload failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+}
+// ─── CLI Runner ─────────────────────────────────────────────────────────────
+export async function runUpload(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges upload — Upload SARIF results to GitHub Code Scanning
+
+Usage:
+  judges upload <sarif-file>                 Upload SARIF file
+  judges upload --file <sarif-file>          Upload SARIF file (alternate)
+  judges upload --repo <owner/repo>          Specify target repository
+  judges upload --ref <git-ref>              Git ref (default: current branch)
+  judges upload --sha <commit-sha>           Git commit SHA (default: HEAD)
+  judges upload --token <github-token>       GitHub token (default: GITHUB_TOKEN env)
+
+The SARIF file is gzipped and base64-encoded before upload, as required by
+the GitHub Code Scanning API.
+
+Environment Variables:
+  GITHUB_TOKEN                               GitHub API token with security_events scope
+
+Options:
+  --file <path>          Path to SARIF file
+  --repo <owner/repo>    GitHub repository (auto-detected from git remote)
+  --ref <ref>            Git ref (auto-detected from current branch)
+  --sha <sha>            Commit SHA (auto-detected from HEAD)
+  --token <token>        GitHub token (or set GITHUB_TOKEN env var)
+  --help, -h             Show this help
+`);
+        return;
+    }
+    // Parse args
+    const sarifPath = resolve(argv.find((_a, i) => argv[i - 1] === "--file") ||
+        argv.find((a, i) => i > 1 && !a.startsWith("-") && a.endsWith(".json")) ||
+        "");
+    if (!sarifPath || !existsSync(sarifPath)) {
+        console.error("\n  Error: Please provide a SARIF file path.\n");
+        console.error("  Usage: judges upload <sarif-file>\n");
+        process.exit(1);
+    }
+    const repo = argv.find((_a, i) => argv[i - 1] === "--repo") || detectRepo();
+    const ref = argv.find((_a, i) => argv[i - 1] === "--ref") || detectGitRef();
+    const commitSha = argv.find((_a, i) => argv[i - 1] === "--sha") || detectGitSha();
+    const token = argv.find((_a, i) => argv[i - 1] === "--token") || process.env.GITHUB_TOKEN || "";
+    if (!repo) {
+        console.error("\n  Error: Could not detect repository. Use --repo owner/repo\n");
+        process.exit(1);
+    }
+    if (!commitSha) {
+        console.error("\n  Error: Could not detect commit SHA. Use --sha <sha>\n");
+        process.exit(1);
+    }
+    if (!token) {
+        console.error("\n  Error: No GitHub token found. Set GITHUB_TOKEN env var or use --token\n");
+        process.exit(1);
+    }
+    console.log(`\n  Uploading SARIF to GitHub Code Scanning...`);
+    console.log(`  Repository: ${repo}`);
+    console.log(`  Ref: ${ref}`);
+    console.log(`  Commit: ${commitSha.slice(0, 7)}`);
+    console.log(`  File: ${basename(sarifPath)}\n`);
+    const result = await uploadSarif({ sarifPath, repo, ref, commitSha, token });
+    if (result.success) {
+        console.log("  ✅ SARIF uploaded successfully.");
+        if (result.id)
+            console.log(`  Analysis ID: ${result.id}`);
+        console.log(`  View results: https://github.com/${repo}/security/code-scanning\n`);
+    }
+    else {
+        console.error(`  ❌ Upload failed: ${result.error}\n`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=upload.js.map

package/dist/commands/upload.js.map

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

package/dist/commands/validate-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Config validation — validate .judgesrc against the JSON schema
+ * and report errors with line numbers and fix suggestions.
+ */
+export interface ValidationError {
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+export declare function validateConfig(config: Record<string, unknown>): ValidationResult;
+export declare function runValidateConfig(argv: string[]): void;
+//# sourceMappingURL=validate-config.d.ts.map

package/dist/commands/validate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-config.d.ts","sourceRoot":"","sources":["../../src/commands/validate-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAqDD,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAuIhF;AAiCD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6EtD"}

package/dist/commands/validate-config.js

@@ -0,0 +1,268 @@
+/**
+ * Config validation — validate .judgesrc against the JSON schema
+ * and report errors with line numbers and fix suggestions.
+ */
+// ─── Known Fields ───────────────────────────────────────────────────────────
+const KNOWN_TOP_FIELDS = new Set([
+    "preset",
+    "presets",
+    "severity",
+    "minSeverity",
+    "format",
+    "disabledJudges",
+    "disabledRules",
+    "ruleOverrides",
+    "parallel",
+    "concurrency",
+    "failOnFindings",
+    "summary",
+    "baseline",
+    "exclude",
+    "include",
+    "judges",
+    "notifications",
+    "qualityGate",
+    "plugins",
+    "extends",
+    "language",
+    "framework",
+    "dataAdapter",
+    "smartSelect",
+    "customRules",
+    "organizationPolicy",
+    "cache",
+    "autoFix",
+    "triage",
+    "deprecated",
+    "ignorePatterns",
+]);
+const KNOWN_SEVERITIES = new Set(["critical", "high", "medium", "low", "info"]);
+const KNOWN_FORMATS = new Set([
+    "text",
+    "json",
+    "sarif",
+    "markdown",
+    "html",
+    "pdf",
+    "junit",
+    "codeclimate",
+    "github-actions",
+]);
+// ─── Validation Logic ───────────────────────────────────────────────────────
+export function validateConfig(config) {
+    const errors = [];
+    const warnings = [];
+    // Check for unknown top-level fields
+    for (const key of Object.keys(config)) {
+        if (!KNOWN_TOP_FIELDS.has(key)) {
+            warnings.push({
+                path: key,
+                message: `Unknown field "${key}"`,
+                suggestion: findClosestMatch(key, KNOWN_TOP_FIELDS),
+            });
+        }
+    }
+    // Validate severity
+    if (config.minSeverity !== undefined) {
+        if (typeof config.minSeverity !== "string" || !KNOWN_SEVERITIES.has(config.minSeverity)) {
+            errors.push({
+                path: "minSeverity",
+                message: `Invalid severity "${config.minSeverity}". Must be one of: ${[...KNOWN_SEVERITIES].join(", ")}`,
+            });
+        }
+    }
+    // Validate format
+    if (config.format !== undefined) {
+        if (typeof config.format !== "string" || !KNOWN_FORMATS.has(config.format)) {
+            errors.push({
+                path: "format",
+                message: `Invalid format "${config.format}". Must be one of: ${[...KNOWN_FORMATS].join(", ")}`,
+            });
+        }
+    }
+    // Validate disabledJudges is array of strings
+    if (config.disabledJudges !== undefined) {
+        if (!Array.isArray(config.disabledJudges)) {
+            errors.push({
+                path: "disabledJudges",
+                message: "disabledJudges must be an array of strings",
+            });
+        }
+    }
+    // Validate disabledRules is array of strings
+    if (config.disabledRules !== undefined) {
+        if (!Array.isArray(config.disabledRules)) {
+            errors.push({
+                path: "disabledRules",
+                message: "disabledRules must be an array of strings",
+            });
+        }
+    }
+    // Validate ruleOverrides
+    if (config.ruleOverrides !== undefined) {
+        if (typeof config.ruleOverrides !== "object" || config.ruleOverrides === null) {
+            errors.push({
+                path: "ruleOverrides",
+                message: "ruleOverrides must be an object",
+            });
+        }
+        else {
+            for (const [rule, override] of Object.entries(config.ruleOverrides)) {
+                if (typeof override === "object" && override !== null) {
+                    const ov = override;
+                    if (ov.severity && !KNOWN_SEVERITIES.has(ov.severity)) {
+                        errors.push({
+                            path: `ruleOverrides.${rule}.severity`,
+                            message: `Invalid severity "${ov.severity}"`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Validate concurrency
+    if (config.concurrency !== undefined) {
+        if (typeof config.concurrency !== "number" || config.concurrency < 1) {
+            errors.push({
+                path: "concurrency",
+                message: "concurrency must be a positive number",
+            });
+        }
+    }
+    // Validate exclude/include patterns
+    for (const field of ["exclude", "include"]) {
+        if (config[field] !== undefined) {
+            if (!Array.isArray(config[field])) {
+                errors.push({
+                    path: field,
+                    message: `${field} must be an array of glob patterns`,
+                });
+            }
+        }
+    }
+    // Validate notifications
+    if (config.notifications !== undefined) {
+        const notifs = config.notifications;
+        if (notifs.channels && !Array.isArray(notifs.channels)) {
+            errors.push({
+                path: "notifications.channels",
+                message: "notifications.channels must be an array",
+            });
+        }
+    }
+    // Validate qualityGate
+    if (config.qualityGate !== undefined) {
+        const qg = config.qualityGate;
+        if (qg.maxFindings !== undefined && (typeof qg.maxFindings !== "number" || qg.maxFindings < 0)) {
+            errors.push({
+                path: "qualityGate.maxFindings",
+                message: "qualityGate.maxFindings must be a non-negative number",
+            });
+        }
+        if (qg.minScore !== undefined &&
+            (typeof qg.minScore !== "number" || qg.minScore < 0 || qg.minScore > 100)) {
+            errors.push({
+                path: "qualityGate.minScore",
+                message: "qualityGate.minScore must be between 0 and 100",
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+function findClosestMatch(input, candidates) {
+    let best;
+    let bestDist = Infinity;
+    for (const c of candidates) {
+        const dist = levenshtein(input.toLowerCase(), c.toLowerCase());
+        if (dist < bestDist && dist <= 3) {
+            bestDist = dist;
+            best = c;
+        }
+    }
+    return best ? `Did you mean "${best}"?` : undefined;
+}
+function levenshtein(a, b) {
+    const m = a.length, n = b.length;
+    const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+        }
+    }
+    return dp[m][n];
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runValidateConfig(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges validate-config — Validate .judgesrc configuration
+
+Usage:
+  judges validate-config                        Validate .judgesrc in current directory
+  judges validate-config --config path/to/.judgesrc   Validate specific file
+
+Options:
+  --config <path>    Config file to validate (default: .judgesrc)
+  --format json      JSON output
+  --strict           Treat warnings as errors
+  --help, -h         Show this help
+`);
+        return;
+    }
+    const { readFileSync, existsSync } = require("fs");
+    const { resolve } = require("path");
+    const configPath = argv.find((_a, i) => argv[i - 1] === "--config") || ".judgesrc";
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const strict = argv.includes("--strict");
+    const resolved = resolve(configPath);
+    if (!existsSync(resolved)) {
+        console.error(`Error: config file not found: ${resolved}`);
+        process.exit(1);
+    }
+    let config;
+    try {
+        config = JSON.parse(readFileSync(resolved, "utf-8"));
+    }
+    catch (e) {
+        console.error(`Error: invalid JSON in ${resolved}: ${e instanceof Error ? e.message : e}`);
+        process.exit(1);
+    }
+    const result = validateConfig(config);
+    if (strict && result.warnings.length > 0) {
+        result.valid = false;
+        result.errors.push(...result.warnings);
+    }
+    if (format === "json") {
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(result.valid ? 0 : 1);
+    }
+    if (result.valid && result.warnings.length === 0) {
+        console.log(`\n  ✅ Config is valid: ${resolved}\n`);
+        return;
+    }
+    console.log(`\n  Config Validation: ${resolved}\n`);
+    if (result.errors.length > 0) {
+        console.log(`  ❌ Errors (${result.errors.length}):`);
+        for (const e of result.errors) {
+            console.log(`    ${e.path}: ${e.message}`);
+            if (e.suggestion)
+                console.log(`      💡 ${e.suggestion}`);
+        }
+        console.log("");
+    }
+    if (result.warnings.length > 0) {
+        console.log(`  ⚠️  Warnings (${result.warnings.length}):`);
+        for (const w of result.warnings) {
+            console.log(`    ${w.path}: ${w.message}`);
+            if (w.suggestion)
+                console.log(`      💡 ${w.suggestion}`);
+        }
+        console.log("");
+    }
+    process.exit(result.valid ? 0 : 1);
+}
+//# sourceMappingURL=validate-config.js.map

package/dist/commands/validate-config.js.map

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

package/dist/commands/warm-cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Eval cache warming — pre-populate the evaluation cache with
+ * common patterns so CI runs start warm and skip known-good files.
+ *
+ * Works with the existing disk-cache system: scans the project,
+ * evaluates files, and stores results. Subsequent CI runs check
+ * the cache first and skip files whose hash hasn't changed.
+ */
+export interface WarmingResult {
+    filesScanned: number;
+    filesCached: number;
+    filesSkipped: number;
+    durationMs: number;
+    cacheDir: string;
+}
+export interface WarmingOptions {
+    /** Root directory to scan */
+    root: string;
+    /** File extensions to include */
+    extensions: string[];
+    /** Glob patterns to exclude */
+    exclude: string[];
+    /** Maximum files to warm */
+    maxFiles: number;
+    /** Cache directory */
+    cacheDir?: string;
+}
+export declare function computeFileHash(content: string): string;
+export declare function warmCache(options?: Partial<WarmingOptions>): Promise<WarmingResult>;
+export declare function runWarmCache(argv: string[]): Promise<void>;
+//# sourceMappingURL=warm-cache.d.ts.map

package/dist/commands/warm-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warm-cache.d.ts","sourceRoot":"","sources":["../../src/commands/warm-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAsCD,wBAAsB,SAAS,CAAC,OAAO,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmF7F;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ChE"}