@kevinrabun/judges 3.23.6 → 3.23.7

package/dist/commands/tune.js

@@ -0,0 +1,408 @@
+/**
+ * `judges tune` — Analyze your project and suggest optimal .judgesrc.json configuration.
+ *
+ * Runs an initial evaluation on a sample of project files, then recommends:
+ * - Which preset best fits your project
+ * - Rules to disable based on consistent FP patterns
+ * - Severity overrides for noisy rules
+ * - Framework-specific settings
+ *
+ * Usage:
+ *   judges tune                        # Analyze current directory
+ *   judges tune --dir ./src            # Analyze specific directory
+ *   judges tune --apply                # Write .judgesrc.json automatically
+ *   judges tune --max-files 20         # Limit sample size
+ */
+import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "fs";
+import { resolve, extname, join } from "path";
+import { evaluateWithTribunal } from "../evaluators/index.js";
+import { PRESETS } from "../presets.js";
+// ─── Language Detection ─────────────────────────────────────────────────────
+const EXT_TO_LANG = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".py": "python",
+    ".rs": "rust",
+    ".go": "go",
+    ".java": "java",
+    ".cs": "csharp",
+    ".rb": "ruby",
+    ".php": "php",
+    ".swift": "swift",
+    ".kt": "kotlin",
+    ".tf": "terraform",
+    ".hcl": "terraform",
+    ".bicep": "bicep",
+    ".sh": "bash",
+};
+function detectLanguage(filePath) {
+    const ext = extname(filePath.toLowerCase());
+    if (filePath.toLowerCase().includes("dockerfile"))
+        return "dockerfile";
+    return EXT_TO_LANG[ext];
+}
+// ─── Framework Detection ────────────────────────────────────────────────────
+function detectFramework(dir) {
+    const signals = [];
+    // Check package.json for JS/TS frameworks
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+            if (deps["next"])
+                signals.push({ framework: "Next.js", preset: "nextjs", confidence: 0.95 });
+            if (deps["react"] && !deps["next"])
+                signals.push({ framework: "React", preset: "react", confidence: 0.9 });
+            if (deps["express"])
+                signals.push({ framework: "Express", preset: "express", confidence: 0.9 });
+            if (deps["fastify"])
+                signals.push({ framework: "Express", preset: "express", confidence: 0.8 });
+            if (deps["koa"])
+                signals.push({ framework: "Express", preset: "express", confidence: 0.7 });
+        }
+        catch {
+            // Invalid package.json
+        }
+    }
+    // Check for Python frameworks
+    const reqPath = join(dir, "requirements.txt");
+    const pyprojectPath = join(dir, "pyproject.toml");
+    const pipfilePath = join(dir, "Pipfile");
+    const pythonManifests = [reqPath, pyprojectPath, pipfilePath].filter(existsSync);
+    for (const manifest of pythonManifests) {
+        try {
+            const content = readFileSync(manifest, "utf-8").toLowerCase();
+            if (content.includes("fastapi"))
+                signals.push({ framework: "FastAPI", preset: "fastapi", confidence: 0.9 });
+            if (content.includes("django"))
+                signals.push({ framework: "Django", preset: "django", confidence: 0.9 });
+            if (content.includes("flask"))
+                signals.push({ framework: "FastAPI", preset: "fastapi", confidence: 0.7 });
+        }
+        catch {
+            // ignore
+        }
+    }
+    // Check for Java frameworks
+    const pomPath = join(dir, "pom.xml");
+    const gradlePath = join(dir, "build.gradle");
+    const gradleKtsPath = join(dir, "build.gradle.kts");
+    for (const manifest of [pomPath, gradlePath, gradleKtsPath].filter(existsSync)) {
+        try {
+            const content = readFileSync(manifest, "utf-8").toLowerCase();
+            if (content.includes("spring-boot") || content.includes("spring.boot"))
+                signals.push({ framework: "Spring Boot", preset: "spring-boot", confidence: 0.9 });
+        }
+        catch {
+            // ignore
+        }
+    }
+    // Check for Ruby frameworks
+    const gemfilePath = join(dir, "Gemfile");
+    if (existsSync(gemfilePath)) {
+        try {
+            const content = readFileSync(gemfilePath, "utf-8").toLowerCase();
+            if (content.includes("rails"))
+                signals.push({ framework: "Rails", preset: "rails", confidence: 0.9 });
+        }
+        catch {
+            // ignore
+        }
+    }
+    // Check for Terraform
+    const hasTfFiles = existsSync(dir) && readdirSync(dir).some((f) => f.endsWith(".tf"));
+    if (hasTfFiles)
+        signals.push({ framework: "Terraform", preset: "terraform", confidence: 0.85 });
+    // Check for Kubernetes
+    const hasK8sFiles = existsSync(dir) &&
+        readdirSync(dir).some((f) => {
+            if (!f.endsWith(".yaml") && !f.endsWith(".yml"))
+                return false;
+            try {
+                const content = readFileSync(join(dir, f), "utf-8");
+                return /apiVersion:\s/.test(content) && /kind:\s/.test(content);
+            }
+            catch {
+                return false;
+            }
+        });
+    if (hasK8sFiles)
+        signals.push({ framework: "Kubernetes", preset: "kubernetes", confidence: 0.8 });
+    // Return highest confidence signal
+    signals.sort((a, b) => b.confidence - a.confidence);
+    return signals[0];
+}
+// ─── File Collection ────────────────────────────────────────────────────────
+function collectSampleFiles(dir, maxFiles) {
+    const files = [];
+    const skipDirs = new Set([
+        "node_modules",
+        ".git",
+        "dist",
+        "build",
+        ".next",
+        "__pycache__",
+        ".venv",
+        "venv",
+        "target",
+        "bin",
+        "obj",
+        "vendor",
+        ".terraform",
+    ]);
+    function walk(dirPath, depth) {
+        if (depth > 5 || files.length >= maxFiles)
+            return;
+        try {
+            const entries = readdirSync(dirPath);
+            for (const entry of entries) {
+                if (files.length >= maxFiles)
+                    break;
+                if (entry.startsWith("."))
+                    continue;
+                if (skipDirs.has(entry))
+                    continue;
+                const fullPath = join(dirPath, entry);
+                try {
+                    const stat = statSync(fullPath);
+                    if (stat.isDirectory()) {
+                        walk(fullPath, depth + 1);
+                    }
+                    else if (stat.isFile() && stat.size < 100_000) {
+                        const lang = detectLanguage(fullPath);
+                        if (lang) {
+                            try {
+                                const content = readFileSync(fullPath, "utf-8");
+                                if (content.trim().length > 10) {
+                                    files.push({ path: fullPath, content, lang });
+                                }
+                            }
+                            catch {
+                                // Binary file or read error
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Permission error
+                }
+            }
+        }
+        catch {
+            // Can't read directory
+        }
+    }
+    walk(dir, 0);
+    return files;
+}
+// ─── Analysis & Recommendation ──────────────────────────────────────────────
+function analyzeFindings(allFindings, totalFiles) {
+    const ruleCount = {};
+    const judgeCount = {};
+    const ruleSeverity = {};
+    for (const { finding } of allFindings) {
+        ruleCount[finding.ruleId] = (ruleCount[finding.ruleId] || 0) + 1;
+        ruleSeverity[finding.ruleId] = ruleSeverity[finding.ruleId] || [];
+        ruleSeverity[finding.ruleId].push(finding.severity);
+        // Extract judge name from ruleId (e.g., "SEC-001" → "security")
+        const parts = finding.ruleId.split("-");
+        if (parts.length > 1) {
+            const judgePrefix = parts[0];
+            judgeCount[judgePrefix] = (judgeCount[judgePrefix] || 0) + 1;
+        }
+    }
+    // Identify rules that fire on >50% of files (likely FP or style preference)
+    const disabledRules = [];
+    const severityOverrides = {};
+    const threshold = Math.max(totalFiles * 0.5, 3);
+    for (const [ruleId, count] of Object.entries(ruleCount)) {
+        if (count >= threshold) {
+            // If it fires on >80% of files, disable it entirely
+            if (count >= totalFiles * 0.8) {
+                disabledRules.push(ruleId);
+            }
+            else {
+                // Downgrade to info
+                severityOverrides[ruleId] = { severity: "info" };
+            }
+        }
+    }
+    // Identify judges with very low signal (many findings but all low/info)
+    const disabledJudges = [];
+    const statsMessage = `Analyzed ${totalFiles} files, found ${allFindings.length} findings across ${Object.keys(ruleCount).length} rules`;
+    const config = {};
+    if (disabledRules.length > 0)
+        config.disabledRules = disabledRules;
+    if (Object.keys(severityOverrides).length > 0)
+        config.ruleOverrides = severityOverrides;
+    if (disabledJudges.length > 0)
+        config.disabledJudges = disabledJudges;
+    return {
+        preset: undefined,
+        detectedFramework: undefined,
+        disabledRules,
+        severityOverrides,
+        disabledJudges,
+        statsMessage,
+        config,
+    };
+}
+// ─── CLI Entry Point ────────────────────────────────────────────────────────
+export function parseTuneArgs(argv) {
+    const args = {
+        dir: process.cwd(),
+        apply: false,
+        maxFiles: 15,
+        verbose: false,
+    };
+    for (let i = 3; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case "--dir":
+            case "-d":
+                args.dir = resolve(argv[++i]);
+                break;
+            case "--apply":
+                args.apply = true;
+                break;
+            case "--max-files":
+                args.maxFiles = parseInt(argv[++i], 10);
+                break;
+            case "--verbose":
+            case "-v":
+                args.verbose = true;
+                break;
+            default:
+                if (!arg.startsWith("-")) {
+                    args.dir = resolve(arg);
+                }
+                break;
+        }
+    }
+    return args;
+}
+export function runTune(argv) {
+    const args = parseTuneArgs(argv);
+    console.log("");
+    console.log("╔══════════════════════════════════════════════════════════════╗");
+    console.log("║              Judges Panel — Tune                            ║");
+    console.log("╚══════════════════════════════════════════════════════════════╝");
+    console.log("");
+    console.log(`  Analyzing: ${args.dir}`);
+    console.log(`  Sample size: up to ${args.maxFiles} files`);
+    console.log("");
+    // 1. Detect framework
+    const framework = detectFramework(args.dir);
+    if (framework) {
+        console.log(`  🔍 Detected framework: ${framework.framework} (confidence: ${Math.round(framework.confidence * 100)}%)`);
+        console.log(`     Recommended preset: ${framework.preset}`);
+    }
+    else {
+        console.log("  🔍 No specific framework detected");
+    }
+    console.log("");
+    // 2. Collect sample files
+    const files = collectSampleFiles(args.dir, args.maxFiles);
+    if (files.length === 0) {
+        console.log("  ⚠️  No source files found to analyze.");
+        process.exit(0);
+    }
+    console.log(`  📂 Found ${files.length} files to analyze`);
+    // 3. Run evaluation on sample
+    console.log("  ⏳ Running evaluation...");
+    const allFindings = [];
+    for (const file of files) {
+        try {
+            const result = evaluateWithTribunal(file.content, file.lang);
+            for (const finding of result.findings) {
+                allFindings.push({ file: file.path, finding });
+            }
+        }
+        catch {
+            // Skip files that fail evaluation
+        }
+    }
+    console.log(`  ✅ Found ${allFindings.length} findings`);
+    console.log("");
+    // 4. Generate recommendations
+    const rec = analyzeFindings(allFindings, files.length);
+    rec.detectedFramework = framework?.framework;
+    rec.preset = framework?.preset;
+    // Merge framework preset config
+    if (rec.preset && PRESETS[rec.preset]) {
+        const presetConfig = PRESETS[rec.preset].config;
+        rec.config = {
+            preset: rec.preset,
+            ...rec.config,
+            disabledJudges: [...new Set([...(presetConfig.disabledJudges || []), ...(rec.config.disabledJudges || [])])],
+        };
+    }
+    // 5. Display recommendations
+    console.log("  ─── Recommendations ───────────────────────────────────────");
+    console.log("");
+    console.log(`  ${rec.statsMessage}`);
+    console.log("");
+    if (rec.preset) {
+        console.log(`  📋 Preset: "${rec.preset}"`);
+    }
+    if (rec.disabledRules.length > 0) {
+        console.log(`  🔇 Disable noisy rules (fire on >80% of files):`);
+        for (const rule of rec.disabledRules) {
+            console.log(`     - ${rule}`);
+        }
+    }
+    if (Object.keys(rec.severityOverrides).length > 0) {
+        console.log(`  📉 Downgrade rules to info (fire on >50% of files):`);
+        for (const [rule, override] of Object.entries(rec.severityOverrides)) {
+            console.log(`     - ${rule} → ${override.severity ?? "info"}`);
+        }
+    }
+    if ((rec.config.disabledJudges || []).length > 0) {
+        console.log(`  ⏭️  Disabled judges (from preset + analysis):`);
+        for (const judge of rec.config.disabledJudges || []) {
+            console.log(`     - ${judge}`);
+        }
+    }
+    console.log("");
+    // 6. Build final .judgesrc.json
+    const judgesrc = {};
+    if (rec.config.preset)
+        judgesrc.preset = rec.config.preset;
+    if ((rec.config.disabledRules || []).length > 0)
+        judgesrc.disabledRules = rec.config.disabledRules;
+    if (Object.keys(rec.config.ruleOverrides || {}).length > 0)
+        judgesrc.ruleOverrides = rec.config.ruleOverrides;
+    if ((rec.config.disabledJudges || []).length > 0)
+        judgesrc.disabledJudges = rec.config.disabledJudges;
+    if ((rec.config.languages || []).length > 0)
+        judgesrc.languages = rec.config.languages;
+    const configJson = JSON.stringify(judgesrc, null, 2);
+    console.log("  📄 Recommended .judgesrc.json:");
+    console.log("");
+    for (const line of configJson.split("\n")) {
+        console.log(`     ${line}`);
+    }
+    console.log("");
+    if (args.apply) {
+        const outputPath = join(args.dir, ".judgesrc.json");
+        if (existsSync(outputPath)) {
+            console.log(`  ⚠️  ${outputPath} already exists — writing to .judgesrc.tuned.json instead`);
+            writeFileSync(join(args.dir, ".judgesrc.tuned.json"), configJson + "\n", "utf-8");
+            console.log(`  ✅ Written to ${join(args.dir, ".judgesrc.tuned.json")}`);
+        }
+        else {
+            writeFileSync(outputPath, configJson + "\n", "utf-8");
+            console.log(`  ✅ Written to ${outputPath}`);
+        }
+    }
+    else {
+        console.log("  💡 Run `judges tune --apply` to write this config automatically.");
+    }
+    console.log("");
+}
+//# sourceMappingURL=tune.js.map

package/dist/commands/tune.js.map

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

package/dist/finding-lifecycle.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Finding Lifecycle Tracking
+ *
+ * Tracks individual findings across multiple evaluation runs, enabling:
+ * - New vs. recurring finding classification
+ * - "Fixed" detection when a finding disappears
+ * - Finding trend statistics (are things getting better or worse?)
+ * - Age tracking (how long has a finding been open?)
+ *
+ * Data stored in .judges-findings.json
+ */
+import type { Finding, Severity } from "./types.js";
+export interface TrackedFinding {
+    /** Stable fingerprint based on ruleId + file + code context */
+    fingerprint: string;
+    /** Rule that generated this finding */
+    ruleId: string;
+    /** Finding severity */
+    severity: Severity;
+    /** File where the finding was detected */
+    filePath: string;
+    /** Finding title for display */
+    title: string;
+    /** First seen timestamp */
+    firstSeen: string;
+    /** Last seen timestamp */
+    lastSeen: string;
+    /** Number of consecutive runs this finding has appeared */
+    runCount: number;
+    /** Whether this finding is currently active */
+    status: "open" | "fixed";
+    /** When the finding was resolved */
+    fixedAt?: string;
+}
+export interface FindingStore {
+    version: string;
+    lastRunAt: string;
+    runNumber: number;
+    findings: TrackedFinding[];
+}
+export interface FindingDelta {
+    /** Findings that appeared for the first time in this run */
+    introduced: TrackedFinding[];
+    /** Findings that are still present from previous runs */
+    recurring: TrackedFinding[];
+    /** Findings from previous runs that are no longer present */
+    fixed: TrackedFinding[];
+    /** Summary statistics */
+    stats: {
+        totalOpen: number;
+        totalFixed: number;
+        introduced: number;
+        recurring: number;
+        fixed: number;
+        trend: "improving" | "stable" | "degrading";
+    };
+}
+/**
+ * Generate a stable fingerprint for a finding that survives minor code edits.
+ * Based on ruleId + file path + approximate code location.
+ */
+export declare function generateFindingFingerprint(finding: Finding, filePath: string): string;
+export declare function loadFindingStore(dir?: string): FindingStore;
+export declare function saveFindingStore(store: FindingStore, dir?: string): void;
+/**
+ * Update the finding store with results from a new evaluation run.
+ * Returns a delta describing what changed since the last run.
+ *
+ * When `dirOrStore` is a string, reads/writes `.judges-findings.json` in that
+ * directory.  When a `FindingStore` object is passed directly, operates
+ * in-memory (useful for testing) and does NOT persist to disk.
+ */
+export declare function updateFindings(currentFindings: Array<{
+    finding: Finding;
+    filePath: string;
+}>, dirOrStore?: string | FindingStore): FindingDelta;
+/**
+ * Get summary statistics from the finding store.
+ */
+export declare function getFindingStats(dirOrStore?: string | FindingStore): {
+    totalOpen: number;
+    totalFixed: number;
+    oldestOpen: string | undefined;
+    bySeverity: Record<string, number>;
+    byRule: Record<string, number>;
+    avgAge: number;
+    runCount: number;
+};
+/**
+ * Format finding delta as a human-readable summary for CLI output.
+ */
+export declare function formatDelta(delta: FindingDelta): string;
+//# sourceMappingURL=finding-lifecycle.d.ts.map

package/dist/finding-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-lifecycle.d.ts","sourceRoot":"","sources":["../src/finding-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIpD,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,yDAAyD;IACzD,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,6DAA6D;IAC7D,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,yBAAyB;IACzB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;KAC7C,CAAC;CACH;AAID;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOrF;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAY,GAAG,YAAY,CAoBhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,GAAE,MAAY,GAAG,IAAI,CAG7E;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9D,UAAU,GAAE,MAAM,GAAG,YAAkB,GACtC,YAAY,CAmGd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,GAAE,MAAM,GAAG,YAAkB,GAAG;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CA6BA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAgCvD"}