@kevinrabun/judges 3.52.0 → 3.54.0

package/dist/commands/refactor-safety.js

@@ -0,0 +1,274 @@
+/**
+ * Refactor safety — analyze proposed refactorings for breaking changes,
+ * incomplete migrations, orphaned references, and behavioral changes.
+ *
+ * Compares two directory snapshots or a list of changed files against
+ * the broader codebase to detect incomplete refactors.
+ */
+import { readFileSync, readdirSync, statSync, existsSync } from "fs";
+import { join, extname, relative } from "path";
+// ─── File Collection ────────────────────────────────────────────────────────
+const CODE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".java", ".cs", ".go", ".rs"]);
+function collectFiles(dir, max = 500) {
+    const files = [];
+    function walk(d) {
+        if (files.length >= max)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (files.length >= max)
+                return;
+            if (e.startsWith(".") || e === "node_modules" || e === "dist" || e === "build")
+                continue;
+            const full = join(d, e);
+            try {
+                if (statSync(full).isDirectory())
+                    walk(full);
+                else if (CODE_EXTS.has(extname(full)))
+                    files.push(full);
+            }
+            catch {
+                /* skip */
+            }
+        }
+    }
+    walk(dir);
+    return files;
+}
+// ─── Analysis ───────────────────────────────────────────────────────────────
+function extractExports(content) {
+    const exports = [];
+    const exportRegex = /\bexport\s+(?:function|class|const|let|type|interface|enum)\s+(\w+)/g;
+    let m;
+    while ((m = exportRegex.exec(content)) !== null)
+        exports.push(m[1]);
+    const defaultExport = /\bexport\s+default\s+(?:function|class)?\s*(\w+)?/g;
+    while ((m = defaultExport.exec(content)) !== null) {
+        if (m[1])
+            exports.push(m[1]);
+    }
+    return exports;
+}
+function extractImports(content) {
+    const imports = [];
+    const importRegex = /import\s+\{([^}]+)\}\s+from\s+['"]([^'"]+)['"]/g;
+    let m;
+    while ((m = importRegex.exec(content)) !== null) {
+        const names = m[1]
+            .split(",")
+            .map((n) => n
+            .trim()
+            .split(/\s+as\s+/)[0]
+            .trim())
+            .filter(Boolean);
+        imports.push({ names, source: m[2] });
+    }
+    return imports;
+}
+function analyzeRefactorSafety(files, dir) {
+    const issues = [];
+    // Build export map: symbol → file
+    const exportMap = new Map();
+    const fileContents = new Map();
+    for (const f of files) {
+        let content;
+        try {
+            content = readFileSync(f, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        fileContents.set(f, content);
+        const exports = extractExports(content);
+        for (const exp of exports) {
+            exportMap.set(exp, f);
+        }
+    }
+    // Check for orphaned imports (importing symbols that no file exports)
+    for (const [filePath, content] of fileContents) {
+        const imports = extractImports(content);
+        const lines = content.split("\n");
+        for (const imp of imports) {
+            // Only check local imports (starting with . or ..)
+            if (!imp.source.startsWith("."))
+                continue;
+            for (const name of imp.names) {
+                // Check if any file exports this symbol
+                if (!exportMap.has(name)) {
+                    const lineNum = lines.findIndex((l) => l.includes(name) && l.includes("import")) + 1;
+                    issues.push({
+                        file: filePath,
+                        line: lineNum || 1,
+                        kind: "orphaned-import",
+                        message: `Import '${name}' from '${imp.source}' — symbol not found in any scanned file exports`,
+                        severity: "high",
+                    });
+                }
+            }
+        }
+    }
+    // Detect renamed/removed patterns
+    for (const [filePath, content] of fileContents) {
+        const lines = content.split("\n");
+        // Check for TODO/FIXME indicating incomplete refactor
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (/\/\/\s*(TODO|FIXME|HACK|XXX)\s*:?\s*(refactor|rename|migrate|move|deprecated)/i.test(line)) {
+                issues.push({
+                    file: filePath,
+                    line: i + 1,
+                    kind: "incomplete-refactor-marker",
+                    message: `Found refactor marker: ${line.trim().substring(0, 80)}`,
+                    severity: "medium",
+                });
+            }
+        }
+        // Detect deprecated usage
+        for (let i = 0; i < lines.length; i++) {
+            if (/@deprecated/i.test(lines[i])) {
+                // Find the symbol being deprecated
+                const nextLine = lines[i + 1] || "";
+                const symbolMatch = nextLine.match(/\b(function|class|const|let|var)\s+(\w+)/);
+                if (symbolMatch) {
+                    const deprecatedName = symbolMatch[2];
+                    // Count references across codebase
+                    let refs = 0;
+                    for (const [otherFile, otherContent] of fileContents) {
+                        if (otherFile === filePath)
+                            continue;
+                        const regex = new RegExp(`\\b${deprecatedName}\\b`, "g");
+                        const matches = otherContent.match(regex);
+                        if (matches)
+                            refs += matches.length;
+                    }
+                    if (refs > 0) {
+                        issues.push({
+                            file: filePath,
+                            line: i + 1,
+                            kind: "deprecated-still-used",
+                            message: `@deprecated symbol '${deprecatedName}' still referenced ${refs} time(s) across codebase`,
+                            severity: "high",
+                        });
+                    }
+                }
+            }
+        }
+        // Detect type assertion overuse (potential behavioral change masking)
+        const assertionCount = (content.match(/\bas\s+\w/g) || []).length;
+        if (assertionCount > 10) {
+            issues.push({
+                file: filePath,
+                line: 1,
+                kind: "excessive-type-assertions",
+                message: `${assertionCount} type assertions — may mask type incompatibilities from refactoring`,
+                severity: "low",
+            });
+        }
+    }
+    // Detect dead files (files with exports but no imports from other files)
+    for (const [filePath, content] of fileContents) {
+        const exports = extractExports(content);
+        if (exports.length === 0)
+            continue;
+        // Skip entry points
+        const rel = relative(dir, filePath);
+        if (rel.includes("index.") || rel.includes("main.") || rel.includes("cli.") || rel.includes("test"))
+            continue;
+        let referenced = false;
+        for (const [otherFile, otherContent] of fileContents) {
+            if (otherFile === filePath)
+                continue;
+            if (exports.some((exp) => otherContent.includes(exp))) {
+                referenced = true;
+                break;
+            }
+        }
+        if (!referenced) {
+            issues.push({
+                file: filePath,
+                line: 1,
+                kind: "potentially-dead-file",
+                message: `File exports [${exports.slice(0, 3).join(", ")}${exports.length > 3 ? "..." : ""}] but none appear imported elsewhere`,
+                severity: "low",
+            });
+        }
+    }
+    return issues.sort((a, b) => {
+        const sev = { high: 3, medium: 2, low: 1 };
+        return sev[b.severity] - sev[a.severity];
+    });
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runRefactorSafety(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges refactor-safety — Analyze refactoring safety
+
+Usage:
+  judges refactor-safety [dir]
+  judges refactor-safety src/ --severity high
+  judges refactor-safety --format json
+
+Options:
+  [dir]                 Directory to scan (default: .)
+  --severity <level>    Filter by minimum severity (high|medium|low)
+  --format json         JSON output
+  --help, -h            Show this help
+
+Detects:
+  • Orphaned imports (importing symbols that don't exist)
+  • Deprecated symbols still in use
+  • Incomplete refactor markers (TODO/FIXME with refactor keywords)
+  • Excessive type assertions masking type changes
+  • Potentially dead files (exported but never imported)
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const severityFilter = argv.find((_a, i) => argv[i - 1] === "--severity") || "low";
+    const dir = argv.find((a) => !a.startsWith("-") && argv.indexOf(a) > 0) || ".";
+    if (!existsSync(dir)) {
+        console.error(`  Directory not found: ${dir}`);
+        return;
+    }
+    const severityOrder = { high: 3, medium: 2, low: 1 };
+    const minSev = severityOrder[severityFilter] || 1;
+    const files = collectFiles(dir);
+    const allIssues = analyzeRefactorSafety(files, dir).filter((x) => severityOrder[x.severity] >= minSev);
+    if (format === "json") {
+        console.log(JSON.stringify({ issues: allIssues, filesScanned: files.length, timestamp: new Date().toISOString() }, null, 2));
+    }
+    else {
+        console.log(`\n  Refactor Safety — ${files.length} files scanned, ${allIssues.length} issue(s)\n  ──────────────────────────`);
+        if (allIssues.length === 0) {
+            console.log("  ✅ No refactoring safety issues detected");
+        }
+        else {
+            const byKind = new Map();
+            for (const issue of allIssues) {
+                byKind.set(issue.kind, (byKind.get(issue.kind) || 0) + 1);
+            }
+            console.log("\n  Summary:");
+            for (const [kind, count] of byKind) {
+                console.log(`    ${kind}: ${count}`);
+            }
+            console.log("\n  Details:");
+            for (const issue of allIssues.slice(0, 50)) {
+                const icon = issue.severity === "high" ? "🔴" : issue.severity === "medium" ? "🟡" : "⚪";
+                console.log(`    ${icon} [${issue.severity}] ${issue.file}:${issue.line}`);
+                console.log(`        ${issue.message}`);
+            }
+            if (allIssues.length > 50) {
+                console.log(`\n    ... and ${allIssues.length - 50} more`);
+            }
+        }
+        console.log("");
+    }
+}
+//# sourceMappingURL=refactor-safety.js.map

package/dist/commands/refactor-safety.js.map

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

package/dist/commands/resource-cleanup.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resource cleanup — validate that allocated resources are properly
+ * freed: file handles, DB connections, timers, event listeners,
+ * streams with try-finally or equivalent cleanup mechanisms.
+ */
+export declare function runResourceCleanup(argv: string[]): void;
+//# sourceMappingURL=resource-cleanup.d.ts.map

package/dist/commands/resource-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-cleanup.d.ts","sourceRoot":"","sources":["../../src/commands/resource-cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+LH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA8EvD"}

package/dist/commands/resource-cleanup.js

@@ -0,0 +1,236 @@
+/**
+ * Resource cleanup — validate that allocated resources are properly
+ * freed: file handles, DB connections, timers, event listeners,
+ * streams with try-finally or equivalent cleanup mechanisms.
+ */
+import { readFileSync, readdirSync, statSync } from "fs";
+import { join, extname } from "path";
+// ─── File Collection ────────────────────────────────────────────────────────
+const CODE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".java", ".cs", ".go"]);
+function collectFiles(dir, max = 500) {
+    const files = [];
+    function walk(d) {
+        if (files.length >= max)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (files.length >= max)
+                return;
+            if (e.startsWith(".") || e === "node_modules" || e === "dist" || e === "build")
+                continue;
+            const full = join(d, e);
+            try {
+                if (statSync(full).isDirectory())
+                    walk(full);
+                else if (CODE_EXTS.has(extname(full)))
+                    files.push(full);
+            }
+            catch {
+                /* skip */
+            }
+        }
+    }
+    walk(dir);
+    return files;
+}
+const RESOURCE_PATTERNS = [
+    {
+        name: "file-handle",
+        openRegex: /\b(openSync|createReadStream|createWriteStream|fs\.open)\s*\(/,
+        closeRegex: /\b(closeSync|\.close\(|\.destroy\(|\.end\()/,
+        guardRegex: /\b(finally|using|dispose|\.close\(|\.destroy\()/,
+        severity: "high",
+    },
+    {
+        name: "db-connection",
+        openRegex: /\b(createConnection|createPool|\.connect\(|new\s+Client\(|getConnection\()/,
+        closeRegex: /\b(\.end\(|\.close\(|\.release\(|\.disconnect\(|\.destroy\()/,
+        guardRegex: /\b(finally|\.release\(|\.end\(|pool\.end|disconnect)/,
+        severity: "high",
+    },
+    {
+        name: "timer",
+        openRegex: /\b(setInterval|setTimeout)\s*\(/,
+        closeRegex: /\b(clearInterval|clearTimeout)\s*\(/,
+        guardRegex: /\b(clearInterval|clearTimeout|finally)/,
+        severity: "medium",
+    },
+    {
+        name: "event-listener",
+        openRegex: /\b(addEventListener|\.on\(|\.addListener\()/,
+        closeRegex: /\b(removeEventListener|\.off\(|\.removeListener\(|\.removeAllListeners\()/,
+        guardRegex: /\b(removeEventListener|\.off\(|\.removeListener\(|dispose|finally)/,
+        severity: "medium",
+    },
+    {
+        name: "stream",
+        openRegex: /\b(createReadStream|createWriteStream|new\s+Readable|new\s+Writable|pipeline\()/,
+        closeRegex: /\b(\.end\(|\.destroy\(|\.close\(|pipeline\()/,
+        guardRegex: /\b(finally|\.destroy\(|\.end\(|pipeline|using)/,
+        severity: "high",
+    },
+    {
+        name: "child-process",
+        openRegex: /\b(spawn|exec|execFile|fork)\s*\(/,
+        closeRegex: /\b(\.kill\(|\.disconnect\()/,
+        guardRegex: /\b(\.kill\(|finally|\.on\(\s*['"]exit)/,
+        severity: "medium",
+    },
+];
+// ─── Analysis ───────────────────────────────────────────────────────────────
+function analyzeFile(filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const lines = content.split("\n");
+    const issues = [];
+    for (const pattern of RESOURCE_PATTERNS) {
+        // Find all opens
+        for (let i = 0; i < lines.length; i++) {
+            if (pattern.openRegex.test(lines[i])) {
+                // Check if a corresponding close or guard exists in the surrounding function
+                const functionBlock = extractFunctionBlock(lines, i);
+                const hasClose = pattern.closeRegex.test(functionBlock);
+                const hasGuard = pattern.guardRegex.test(functionBlock);
+                if (!hasClose) {
+                    issues.push({
+                        file: filePath,
+                        line: i + 1,
+                        kind: `${pattern.name}-no-close`,
+                        resource: pattern.name,
+                        message: `${pattern.name} opened but no corresponding close/cleanup found in surrounding scope`,
+                        severity: pattern.severity,
+                    });
+                }
+                else if (!hasGuard) {
+                    issues.push({
+                        file: filePath,
+                        line: i + 1,
+                        kind: `${pattern.name}-no-guard`,
+                        resource: pattern.name,
+                        message: `${pattern.name} is closed but not in a finally/dispose block — may leak on exception`,
+                        severity: "low",
+                    });
+                }
+            }
+        }
+    }
+    // Detect try blocks without finally when resources are opened inside
+    const tryRegex = /\btry\s*\{/g;
+    let match;
+    while ((match = tryRegex.exec(content)) !== null) {
+        const pos = match.index;
+        const lineNum = content.substring(0, pos).split("\n").length;
+        const remaining = content.substring(pos);
+        // Check if this try block has a finally
+        const hasFinally = /\bfinally\s*\{/.test(remaining.substring(0, 500));
+        if (!hasFinally) {
+            // Check if resource operations exist inside the try
+            const tryBlock = remaining.substring(0, 500);
+            const hasResourceOp = RESOURCE_PATTERNS.some((p) => p.openRegex.test(tryBlock));
+            if (hasResourceOp) {
+                issues.push({
+                    file: filePath,
+                    line: lineNum,
+                    kind: "try-without-finally",
+                    resource: "mixed",
+                    message: "try block contains resource operations but no finally block for cleanup",
+                    severity: "medium",
+                });
+            }
+        }
+    }
+    return issues;
+}
+function extractFunctionBlock(lines, startLine) {
+    // Walk backwards to find function/method boundary, then forward to end
+    let start = Math.max(0, startLine - 30);
+    const end = Math.min(lines.length, startLine + 50);
+    for (let i = startLine; i >= Math.max(0, startLine - 30); i--) {
+        if (/\b(function|async\s+function|=>\s*\{|class\s|constructor|ngOnInit|componentDidMount)/.test(lines[i])) {
+            start = i;
+            break;
+        }
+    }
+    return lines.slice(start, end).join("\n");
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runResourceCleanup(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges resource-cleanup — Validate resource cleanup patterns
+
+Usage:
+  judges resource-cleanup [dir]
+  judges resource-cleanup src/ --severity high
+  judges resource-cleanup --format json
+
+Options:
+  [dir]                 Directory to scan (default: .)
+  --severity <level>    Filter by minimum severity (high|medium|low)
+  --format json         JSON output
+  --help, -h            Show this help
+
+Resources checked:
+  • File handles (open/close)
+  • Database connections (connect/end)
+  • Timers (setInterval/clearInterval)
+  • Event listeners (on/off)
+  • Streams (createReadStream/destroy)
+  • Child processes (spawn/kill)
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const severityFilter = argv.find((_a, i) => argv[i - 1] === "--severity") || "low";
+    const dir = argv.find((a) => !a.startsWith("-") && argv.indexOf(a) > 0) || ".";
+    const severityOrder = { high: 3, medium: 2, low: 1 };
+    const minSev = severityOrder[severityFilter] || 1;
+    const files = collectFiles(dir);
+    const allIssues = [];
+    for (const f of files) {
+        const issues = analyzeFile(f);
+        allIssues.push(...issues.filter((x) => severityOrder[x.severity] >= minSev));
+    }
+    allIssues.sort((a, b) => severityOrder[b.severity] - severityOrder[a.severity]);
+    if (format === "json") {
+        console.log(JSON.stringify({ issues: allIssues, filesScanned: files.length, timestamp: new Date().toISOString() }, null, 2));
+    }
+    else {
+        console.log(`\n  Resource Cleanup — ${files.length} files scanned, ${allIssues.length} issue(s)\n  ──────────────────────────`);
+        if (allIssues.length === 0) {
+            console.log("  ✅ No resource cleanup issues detected");
+        }
+        else {
+            const byResource = new Map();
+            for (const issue of allIssues) {
+                byResource.set(issue.resource, (byResource.get(issue.resource) || 0) + 1);
+            }
+            console.log("\n  By resource type:");
+            for (const [res, count] of byResource) {
+                console.log(`    ${res}: ${count} issue(s)`);
+            }
+            console.log("\n  Details:");
+            for (const issue of allIssues.slice(0, 50)) {
+                const icon = issue.severity === "high" ? "🔴" : issue.severity === "medium" ? "🟡" : "⚪";
+                console.log(`    ${icon} [${issue.severity}] ${issue.file}:${issue.line}`);
+                console.log(`        ${issue.message}`);
+            }
+            if (allIssues.length > 50) {
+                console.log(`\n    ... and ${allIssues.length - 50} more issue(s)`);
+            }
+        }
+        console.log("");
+    }
+}
+//# sourceMappingURL=resource-cleanup.js.map

package/dist/commands/resource-cleanup.js.map

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

package/dist/commands/review-replay.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Review replay — record, export, and replay a full evaluation run
+ * as a shareable step-by-step walkthrough.
+ *
+ * Captures file discovery, judge selection, finding detection, dedup,
+ * and calibration into a replayable JSON trace.
+ */
+export declare function runReviewReplay(argv: string[]): void;
+//# sourceMappingURL=review-replay.d.ts.map

package/dist/commands/review-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-replay.d.ts","sourceRoot":"","sources":["../../src/commands/review-replay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwLH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAuHpD"}