@kevinrabun/judges 3.38.0 → 3.41.0

package/dist/commands/config-migrate.js

@@ -0,0 +1,241 @@
+/**
+ * `judges config-migrate` — Configuration migration assistant.
+ *
+ * Helps users upgrade their .judgesrc configs between Judges versions.
+ * Detects deprecated fields, renamed keys, and structural changes,
+ * then applies automatic or guided migrations.
+ *
+ * Usage:
+ *   judges config-migrate                     # Analyze current .judgesrc
+ *   judges config-migrate --apply             # Apply migrations in place
+ *   judges config-migrate --dry-run           # Show changes without writing
+ *   judges config-migrate --config path       # Specify config path
+ */
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { resolve } from "path";
+// ─── Migration Rules ────────────────────────────────────────────────────────
+const MIGRATIONS = [
+    {
+        id: "M001-severity-rename",
+        since: "3.0.0",
+        description: 'Rename "warning" severity to "medium" (severity levels: critical, high, medium, low, info)',
+        level: "error",
+        detect: (config) => {
+            const overrides = config.ruleOverrides;
+            if (!overrides)
+                return false;
+            return Object.values(overrides).some((o) => o.severity === "warning");
+        },
+        apply: (config) => {
+            const overrides = config.ruleOverrides;
+            for (const [key, val] of Object.entries(overrides)) {
+                if (val.severity === "warning") {
+                    overrides[key] = { ...val, severity: "medium" };
+                }
+            }
+            return { ...config, ruleOverrides: overrides };
+        },
+    },
+    {
+        id: "M002-min-severity-string",
+        since: "3.0.0",
+        description: "Numeric minSeverity (1-5) should be replaced with string value (critical/high/medium/low/info)",
+        level: "error",
+        detect: (config) => typeof config.minSeverity === "number",
+        apply: (config) => {
+            const mapping = { 5: "critical", 4: "high", 3: "medium", 2: "low", 1: "info" };
+            const newSev = mapping[config.minSeverity] || "medium";
+            return { ...config, minSeverity: newSev };
+        },
+    },
+    {
+        id: "M003-disabled-rules-object",
+        since: "3.10.0",
+        description: "disabledRules should be an array of strings, not an object",
+        level: "error",
+        detect: (config) => config.disabledRules !== undefined && !Array.isArray(config.disabledRules),
+        apply: (config) => {
+            const obj = config.disabledRules;
+            return { ...config, disabledRules: Object.keys(obj) };
+        },
+    },
+    {
+        id: "M004-ignorePatterns-to-exclude",
+        since: "3.15.0",
+        description: 'Renamed "ignorePatterns" to "exclude" for consistency',
+        level: "warning",
+        detect: (config) => "ignorePatterns" in config,
+        apply: (config) => {
+            const { ignorePatterns, ...rest } = config;
+            const existing = rest.exclude || [];
+            const patterns = Array.isArray(ignorePatterns) ? ignorePatterns : [ignorePatterns];
+            return { ...rest, exclude: [...existing, ...patterns] };
+        },
+    },
+    {
+        id: "M005-level-to-preset",
+        since: "3.20.0",
+        description: 'Renamed "level" to "preset" for config profiles',
+        level: "warning",
+        detect: (config) => "level" in config && !("preset" in config),
+        apply: (config) => {
+            const { level, ...rest } = config;
+            return { ...rest, preset: level };
+        },
+    },
+    {
+        id: "M006-whitelist-to-include",
+        since: "3.15.0",
+        description: 'Renamed "whitelist" to "include" for inclusive terminology',
+        level: "warning",
+        detect: (config) => "whitelist" in config,
+        apply: (config) => {
+            const { whitelist, ...rest } = config;
+            const existing = rest.include || [];
+            const patterns = Array.isArray(whitelist) ? whitelist : [whitelist];
+            return { ...rest, include: [...existing, ...patterns] };
+        },
+    },
+    {
+        id: "M007-output-to-format",
+        since: "3.20.0",
+        description: 'Renamed "output" to "format" for output format specification',
+        level: "warning",
+        detect: (config) => "output" in config && !("format" in config),
+        apply: (config) => {
+            const { output, ...rest } = config;
+            return { ...rest, format: output };
+        },
+    },
+    {
+        id: "M008-judges-to-disabledJudges",
+        since: "3.25.0",
+        description: '"skipJudges" array should be "disabledJudges"',
+        level: "warning",
+        detect: (config) => "skipJudges" in config,
+        apply: (config) => {
+            const { skipJudges, ...rest } = config;
+            const existing = rest.disabledJudges || [];
+            const skip = Array.isArray(skipJudges) ? skipJudges : [skipJudges];
+            return { ...rest, disabledJudges: [...existing, ...skip] };
+        },
+    },
+    {
+        id: "M009-data-adapter-string",
+        since: "3.35.0",
+        description: "dataAdapter should be an object { type, url?, headers? }, not a string",
+        level: "warning",
+        detect: (config) => typeof config.dataAdapter === "string",
+        apply: (config) => {
+            const da = config.dataAdapter;
+            if (da.startsWith("http")) {
+                return { ...config, dataAdapter: { type: "http", url: da } };
+            }
+            return { ...config, dataAdapter: { type: "filesystem" } };
+        },
+    },
+    {
+        id: "M010-custom-rules-flat",
+        since: "3.30.0",
+        description: 'customRules entries require "id" field (previously auto-generated from index)',
+        level: "info",
+        detect: (config) => {
+            const rules = config.customRules;
+            if (!rules || !Array.isArray(rules))
+                return false;
+            return rules.some((r) => !r.id);
+        },
+        apply: (config) => {
+            const rules = config.customRules;
+            const patched = rules.map((r, i) => (r.id ? r : { ...r, id: `CUSTOM-${String(i + 1).padStart(3, "0")}` }));
+            return { ...config, customRules: patched };
+        },
+    },
+];
+// ─── Analysis ───────────────────────────────────────────────────────────────
+export function analyzeConfig(config) {
+    const applied = [];
+    let migratedConfig = { ...config };
+    let hasChanges = false;
+    for (const rule of MIGRATIONS) {
+        if (rule.detect(config)) {
+            applied.push({ id: rule.id, description: rule.description, level: rule.level });
+            migratedConfig = rule.apply(migratedConfig);
+            hasChanges = true;
+        }
+    }
+    return { configPath: "", applied, hasChanges, migratedConfig: hasChanges ? migratedConfig : undefined };
+}
+// ─── CLI Runner ─────────────────────────────────────────────────────────────
+export function runConfigMigrate(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges config-migrate — Configuration migration assistant
+
+Usage:
+  judges config-migrate                     Analyze .judgesrc for issues
+  judges config-migrate --apply             Apply migrations in place
+  judges config-migrate --dry-run           Show changes without writing
+  judges config-migrate --config <path>     Specify config file path
+
+Detects and fixes:
+  • Renamed fields (ignorePatterns→exclude, output→format, etc.)
+  • Deprecated value types (numeric severity → string)
+  • Structural changes (object → array for disabledRules)
+  • Missing required fields (customRules.id)
+  • Terminology updates (whitelist→include, skipJudges→disabledJudges)
+
+Options:
+  --apply                Apply migrations and write updated config
+  --dry-run              Show what would change (default behavior)
+  --config <path>        Path to .judgesrc file (default: ./.judgesrc)
+  --format json          JSON output
+  --help, -h             Show this help
+`);
+        return;
+    }
+    const configPath = resolve(argv.find((_a, i) => argv[i - 1] === "--config") || ".judgesrc");
+    const shouldApply = argv.includes("--apply");
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    if (!existsSync(configPath)) {
+        console.log(`\n  No config file found at ${configPath}\n`);
+        console.log("  Run 'judges init' to create a .judgesrc, or specify --config <path>\n");
+        return;
+    }
+    let config;
+    try {
+        config = JSON.parse(readFileSync(configPath, "utf-8"));
+    }
+    catch (err) {
+        console.error(`\n  Error parsing ${configPath}: ${err instanceof Error ? err.message : String(err)}\n`);
+        return;
+    }
+    const result = analyzeConfig(config);
+    result.configPath = configPath;
+    if (format === "json") {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`\n  Config Migration Analysis: ${configPath}\n`);
+    if (result.applied.length === 0) {
+        console.log("  ✅ No migrations needed — config is up to date.\n");
+        return;
+    }
+    const icons = { error: "❌", warning: "⚠️", info: "ℹ️" };
+    for (const m of result.applied) {
+        const icon = icons[m.level] || "•";
+        console.log(`  ${icon} [${m.id}] ${m.description}`);
+    }
+    const errors = result.applied.filter((m) => m.level === "error").length;
+    const warnings = result.applied.filter((m) => m.level === "warning").length;
+    const infos = result.applied.filter((m) => m.level === "info").length;
+    console.log(`\n  Summary: ${errors} error(s), ${warnings} warning(s), ${infos} info(s)\n`);
+    if (shouldApply && result.migratedConfig) {
+        writeFileSync(configPath, JSON.stringify(result.migratedConfig, null, 2) + "\n", "utf-8");
+        console.log(`  ✅ Migrated config written to ${configPath}\n`);
+    }
+    else if (result.hasChanges) {
+        console.log("  Run with --apply to write the migrated config.\n");
+    }
+}
+//# sourceMappingURL=config-migrate.js.map

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

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

package/dist/commands/dedup-report.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `judges dedup-report` — Cross-run finding deduplication report.
+ *
+ * Shows which findings are new vs recurring vs fixed across runs.
+ * Built on the existing finding-lifecycle tracking infrastructure.
+ *
+ * Usage:
+ *   judges dedup-report                       # Show finding delta report
+ *   judges dedup-report --format json         # JSON output
+ *   judges dedup-report --stats               # Summary statistics only
+ */
+export declare function runDedupReport(argv: string[]): void;
+//# sourceMappingURL=dedup-report.d.ts.map

package/dist/commands/dedup-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup-report.d.ts","sourceRoot":"","sources":["../../src/commands/dedup-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA0HnD"}

package/dist/commands/dedup-report.js

@@ -0,0 +1,138 @@
+/**
+ * `judges dedup-report` — Cross-run finding deduplication report.
+ *
+ * Shows which findings are new vs recurring vs fixed across runs.
+ * Built on the existing finding-lifecycle tracking infrastructure.
+ *
+ * Usage:
+ *   judges dedup-report                       # Show finding delta report
+ *   judges dedup-report --format json         # JSON output
+ *   judges dedup-report --stats               # Summary statistics only
+ */
+import { loadFindingStore, getFindingStats } from "../finding-lifecycle.js";
+import { resolve } from "path";
+// ─── CLI Runner ─────────────────────────────────────────────────────────────
+export function runDedupReport(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges dedup-report — Cross-run finding deduplication report
+
+Usage:
+  judges dedup-report [dir]                 Show finding delta report
+  judges dedup-report --stats               Summary statistics only
+  judges dedup-report --recurring           Show only recurring findings
+  judges dedup-report --new                 Show only new findings since last run
+  judges dedup-report --fixed               Show recently fixed findings
+  judges dedup-report --format json         JSON output
+
+Reads .judges-findings.json from the project directory to show:
+  • New findings introduced since last run
+  • Recurring findings (persistent across runs)
+  • Fixed findings (no longer detected)
+  • Trend analysis (improving / stable / degrading)
+
+Options:
+  --dir <path>         Project directory (default: current)
+  --stats              Show summary statistics only
+  --recurring          Filter to recurring findings
+  --new                Filter to newly introduced findings
+  --fixed              Filter to fixed findings
+  --format <fmt>       Output format: text, json
+  --help, -h           Show this help
+`);
+        return;
+    }
+    const dir = resolve(argv.find((_a, i) => argv[i - 1] === "--dir") ||
+        argv.find((a, i) => i > 1 && !a.startsWith("-") && argv[i - 1] !== "--format" && argv[i - 1] !== "--dir") ||
+        ".");
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const statsOnly = argv.includes("--stats");
+    const showRecurring = argv.includes("--recurring");
+    const showNew = argv.includes("--new");
+    const showFixed = argv.includes("--fixed");
+    const store = loadFindingStore(dir);
+    if (store.findings.length === 0) {
+        console.log("\n  No finding history found. Run 'judges eval' first to build the finding store.\n");
+        return;
+    }
+    const stats = getFindingStats(store);
+    if (format === "json") {
+        const data = { stats, runNumber: store.runNumber, lastRunAt: store.lastRunAt };
+        if (!statsOnly) {
+            const openFindings = store.findings.filter((f) => f.status === "open");
+            const fixedFindings = store.findings.filter((f) => f.status === "fixed");
+            const newFindings = openFindings.filter((f) => f.runCount === 1);
+            const recurringFindings = openFindings.filter((f) => f.runCount > 1);
+            if (showNew)
+                data.findings = newFindings;
+            else if (showRecurring)
+                data.findings = recurringFindings;
+            else if (showFixed)
+                data.findings = fixedFindings;
+            else
+                data.findings = { new: newFindings, recurring: recurringFindings, fixed: fixedFindings };
+        }
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    // Text output
+    console.log(`\n  Finding Deduplication Report  —  Run #${store.runNumber}  (${store.lastRunAt})\n`);
+    // Stats
+    console.log(`  Total tracked:    ${stats.totalOpen + stats.totalFixed}`);
+    console.log(`  Open:             ${stats.totalOpen}`);
+    console.log(`  Fixed:            ${stats.totalFixed}`);
+    console.log(`  Triaged:          ${stats.totalTriaged}`);
+    console.log(`  Avg age (days):   ${Math.round(stats.avgAge)}`);
+    console.log("");
+    // Severity breakdown
+    console.log("  By severity:");
+    for (const [sev, count] of Object.entries(stats.bySeverity)) {
+        if (count > 0) {
+            console.log(`    ${sev.toUpperCase().padEnd(10)} ${count}`);
+        }
+    }
+    console.log("");
+    if (statsOnly)
+        return;
+    const openFindings = store.findings.filter((f) => f.status === "open");
+    const fixedFindings = store.findings.filter((f) => f.status === "fixed");
+    const newFindings = openFindings.filter((f) => f.runCount === 1);
+    const recurringFindings = openFindings.filter((f) => f.runCount > 1);
+    // New findings
+    if (!showRecurring && !showFixed && newFindings.length > 0) {
+        console.log(`  ─── New Findings (${newFindings.length}) ───\n`);
+        printFindings(newFindings);
+    }
+    // Recurring
+    if (!showNew && !showFixed && recurringFindings.length > 0) {
+        console.log(`  ─── Recurring Findings (${recurringFindings.length}) ───\n`);
+        printFindings(recurringFindings, true);
+    }
+    // Fixed
+    if (!showNew && !showRecurring && fixedFindings.length > 0) {
+        const recentFixed = fixedFindings.filter((f) => {
+            if (!f.fixedAt)
+                return false;
+            const fixedDate = new Date(f.fixedAt);
+            const weekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+            return fixedDate >= weekAgo;
+        });
+        if (recentFixed.length > 0) {
+            console.log(`  ─── Recently Fixed (${recentFixed.length}) ───\n`);
+            printFindings(recentFixed);
+        }
+    }
+    console.log("");
+}
+function printFindings(findings, showRunCount = false) {
+    for (const f of findings.slice(0, 20)) {
+        const runInfo = showRunCount ? ` (${f.runCount} runs)` : "";
+        console.log(`  • [${f.severity.toUpperCase()}] ${f.ruleId}: ${f.title}${runInfo}`);
+        console.log(`    ${f.filePath}`);
+    }
+    if (findings.length > 20) {
+        console.log(`  ... and ${findings.length - 20} more`);
+    }
+    console.log("");
+}
+//# sourceMappingURL=dedup-report.js.map

package/dist/commands/dedup-report.js.map

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

package/dist/commands/dep-audit.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `judges dep-audit` — Dependency vulnerability correlation.
+ *
+ * Correlates code-level findings with known vulnerabilities in project
+ * dependencies. Uses npm audit / pip audit output to enrich findings
+ * with CVE data, adding urgency context to code review.
+ *
+ * Usage:
+ *   judges dep-audit                             # Audit current directory
+ *   judges dep-audit --format json               # JSON output
+ *   judges dep-audit --correlate results.json     # Correlate with findings
+ */
+import type { Finding, Severity } from "../types.js";
+export interface VulnerablePackage {
+    /** Package name */
+    name: string;
+    /** Installed version */
+    version: string;
+    /** Vulnerability severity */
+    severity: Severity;
+    /** CVE identifier(s) */
+    cves: string[];
+    /** CWE identifier(s) */
+    cwes: string[];
+    /** Advisory title */
+    title: string;
+    /** URL for more information */
+    url?: string;
+    /** Fixed version (if known) */
+    fixedIn?: string;
+}
+export interface DepAuditResult {
+    /** Detected package manager */
+    packageManager: "npm" | "pip" | "unknown";
+    /** Vulnerable packages found */
+    vulnerabilities: VulnerablePackage[];
+    /** Total vulnerability count */
+    totalVulnerabilities: number;
+    /** Counts by severity */
+    severityCounts: Record<Severity, number>;
+    /** Correlations with code findings */
+    correlations: Array<{
+        vulnerability: VulnerablePackage;
+        relatedFindings: Array<{
+            ruleId: string;
+            title: string;
+            reason: string;
+        }>;
+    }>;
+}
+export declare function runDepAudit(dir: string, findings?: Finding[]): DepAuditResult;
+export declare function runDepAuditCommand(argv: string[]): void;
+//# sourceMappingURL=dep-audit.d.ts.map

package/dist/commands/dep-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dep-audit.d.ts","sourceRoot":"","sources":["../../src/commands/dep-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIrD,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,cAAc,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1C,gCAAgC;IAChC,eAAe,EAAE,iBAAiB,EAAE,CAAC;IACrC,gCAAgC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yBAAyB;IACzB,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,sCAAsC;IACtC,YAAY,EAAE,KAAK,CAAC;QAClB,aAAa,EAAE,iBAAiB,CAAC;QACjC,eAAe,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC3E,CAAC,CAAC;CACJ;AA0KD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,CA+B7E;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAgGvD"}