@kevinrabun/judges 3.41.0 → 3.43.0

package/dist/commands/warm-cache.js

@@ -0,0 +1,166 @@
+/**
+ * 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.
+ */
+import { createHash } from "crypto";
+import { DiskCache } from "../disk-cache.js";
+// ─── Hash Computation ───────────────────────────────────────────────────────
+export function computeFileHash(content) {
+    return createHash("sha256").update(content).digest("hex").slice(0, 16);
+}
+// ─── Cache Warming Logic ────────────────────────────────────────────────────
+const DEFAULT_EXTENSIONS = [
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".py",
+    ".go",
+    ".rs",
+    ".java",
+    ".cs",
+    ".rb",
+    ".php",
+    ".kt",
+    ".scala",
+    ".swift",
+    ".c",
+    ".cpp",
+    ".h",
+    ".hpp",
+];
+const DEFAULT_EXCLUDE = [
+    "node_modules",
+    "dist",
+    "build",
+    ".git",
+    "__pycache__",
+    "vendor",
+    "target",
+    ".next",
+    ".nuxt",
+    "coverage",
+];
+export async function warmCache(options = {}) {
+    const { readdirSync, readFileSync, statSync } = await import("fs");
+    const { join, extname } = await import("path");
+    const root = options.root || process.cwd();
+    const extensions = new Set(options.extensions || DEFAULT_EXTENSIONS);
+    const excludeDirs = new Set(options.exclude || DEFAULT_EXCLUDE);
+    const maxFiles = options.maxFiles || 500;
+    const cache = new DiskCache({ cacheDir: options.cacheDir });
+    const cacheDir = options.cacheDir || process.env.JUDGES_CACHE_DIR || ".judges-cache";
+    const start = performance.now();
+    let filesScanned = 0;
+    let filesCached = 0;
+    let filesSkipped = 0;
+    function walkDir(dir) {
+        if (filesScanned >= maxFiles)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (filesScanned >= maxFiles)
+                break;
+            if (entry.isDirectory()) {
+                if (!excludeDirs.has(entry.name) && !entry.name.startsWith(".")) {
+                    walkDir(join(dir, entry.name));
+                }
+                continue;
+            }
+            const ext = extname(entry.name).toLowerCase();
+            if (!extensions.has(ext))
+                continue;
+            const filePath = join(dir, entry.name);
+            filesScanned++;
+            try {
+                const content = readFileSync(filePath, "utf-8");
+                const hash = computeFileHash(content);
+                const cacheKey = `warm:${filePath}:${hash}`;
+                // Check if already cached
+                const existing = cache.get(cacheKey);
+                if (existing) {
+                    filesSkipped++;
+                    continue;
+                }
+                // Store a warming marker — actual eval results will be populated
+                // on first real evaluation when the hash matches
+                const stat = statSync(filePath);
+                cache.set(cacheKey, JSON.stringify({
+                    warmed: true,
+                    hash,
+                    size: stat.size,
+                    timestamp: new Date().toISOString(),
+                }));
+                filesCached++;
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+    }
+    walkDir(root);
+    return {
+        filesScanned,
+        filesCached,
+        filesSkipped,
+        durationMs: Math.round(performance.now() - start),
+        cacheDir,
+    };
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export async function runWarmCache(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges warm-cache — Pre-populate evaluation cache for faster CI
+
+Usage:
+  judges warm-cache                              Warm cache for current directory
+  judges warm-cache --root src/                  Warm specific directory
+  judges warm-cache --max 200                    Limit files to warm
+
+Options:
+  --root <dir>          Root directory to scan (default: .)
+  --max <n>             Max files to warm (default: 500)
+  --extensions <list>   Comma-separated extensions (default: .ts,.js,.py,.go,...)
+  --format json         JSON output
+  --help, -h            Show this help
+
+Pre-populates the disk cache with file hashes. Subsequent evaluations
+skip files whose content hasn't changed, dramatically speeding up CI.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const root = argv.find((_a, i) => argv[i - 1] === "--root");
+    const maxStr = argv.find((_a, i) => argv[i - 1] === "--max");
+    const extStr = argv.find((_a, i) => argv[i - 1] === "--extensions");
+    const options = {};
+    if (root)
+        options.root = root;
+    if (maxStr)
+        options.maxFiles = parseInt(maxStr, 10);
+    if (extStr)
+        options.extensions = extStr.split(",").map((s) => s.trim());
+    const result = await warmCache(options);
+    if (format === "json") {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`\n  Cache Warming Results\n`);
+    console.log(`  Files scanned: ${result.filesScanned}`);
+    console.log(`  Newly cached:  ${result.filesCached}`);
+    console.log(`  Already warm:  ${result.filesSkipped}`);
+    console.log(`  Duration:      ${result.durationMs}ms`);
+    console.log(`  Cache dir:     ${result.cacheDir}\n`);
+}
+//# sourceMappingURL=warm-cache.js.map

package/dist/commands/warm-cache.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kevinrabun/judges",
-  "version": "3.41.0",
+  "version": "3.43.0",
   "description": "45 specialized judges that evaluate AI-generated code for security, cost, and quality.",
   "mcpName": "io.github.KevinRabun/judges",
   "type": "module",

package/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/kevinrabun/judges",
     "source": "github"
   },
-  "version": "3.41.0",
+  "version": "3.43.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@kevinrabun/judges",
-      "version": "3.41.0",
+      "version": "3.43.0",
       "transport": {
         "type": "stdio"
       }