@kevinrabun/judges 3.53.0 → 3.55.0

package/dist/commands/migration-safety.js

@@ -0,0 +1,257 @@
+/**
+ * Migration safety — validate framework/language migration PRs for
+ * compatibility gaps, data-loss risks, and breaking changes.
+ */
+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",
+    ".go",
+    ".rs",
+    ".json",
+    ".yaml",
+    ".yml",
+]);
+function collectFiles(dir, max = 300) {
+    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 ───────────────────────────────────────────────────────────────
+const MIGRATION_PATTERNS = [
+    // Framework migrations
+    {
+        pattern: /(?:from|import)\s+['"]react-router(?:-dom)?['"]/i,
+        risk: "React Router migration",
+        severity: "high",
+        detail: "React Router v5→v6: <Switch> replaced by <Routes>, useHistory→useNavigate",
+    },
+    {
+        pattern: /(?:from|import)\s+['"]@angular\/(?:core|common)['"]/i,
+        risk: "Angular version migration",
+        severity: "high",
+        detail: "Angular major versions change DI, module system, and template syntax",
+    },
+    {
+        pattern: /(?:from|import)\s+['"]vue['"]/i,
+        risk: "Vue migration",
+        severity: "high",
+        detail: "Vue 2→3: Options API defaults change, Composition API, Proxy-based reactivity",
+    },
+    {
+        pattern: /(?:from|import)\s+['"]express['"].*(?:from|import)\s+['"]fastify['"]/is,
+        risk: "Express→Fastify migration",
+        severity: "high",
+        detail: "Middleware model differs — req/res API changes, plugin system replaces middleware chain",
+    },
+    // TypeScript/JavaScript evolution
+    {
+        pattern: /require\s*\(.*\).*(?:import|from).*['"]/i,
+        risk: "CJS/ESM mixed imports",
+        severity: "medium",
+        detail: "Mixed require() and import — choose one module system",
+    },
+    {
+        pattern: /"type"\s*:\s*"module"/i,
+        risk: "ESM migration",
+        severity: "medium",
+        detail: "ESM migration: ensure all imports have extensions, __dirname unavailable",
+    },
+    // Database migrations
+    {
+        pattern: /(?:ALTER|DROP)\s+(?:TABLE|COLUMN|INDEX)/i,
+        risk: "Schema migration",
+        severity: "critical",
+        detail: "Schema changes may lose data — run on copy first, verify rollback",
+    },
+    {
+        pattern: /(?:mongoose|sequelize|typeorm|prisma).*(?:migrate|migration)/i,
+        risk: "ORM migration",
+        severity: "high",
+        detail: "ORM migrations may have different default behaviors across versions",
+    },
+    // Config format changes
+    {
+        pattern: /(?:webpack|rollup|vite|esbuild|parcel).*(?:config|\.config)/i,
+        risk: "Bundler migration",
+        severity: "medium",
+        detail: "Bundler configs are not portable — verify plugin equivalents",
+    },
+    // API surface changes
+    {
+        pattern: /deprecated|@deprecated|TODO.*migrate|FIXME.*upgrade/i,
+        risk: "Deprecated API usage",
+        severity: "medium",
+        detail: "Deprecated APIs may be removed in next version — update now",
+    },
+    // Runtime changes
+    {
+        pattern: /engines.*node.*['"]\d+/i,
+        risk: "Node.js version requirement",
+        severity: "high",
+        detail: "Node version changes affect API availability, performance, and security",
+    },
+    {
+        pattern: /python_requires.*['"]\s*>=?\s*3\./i,
+        risk: "Python version requirement",
+        severity: "high",
+        detail: "Python version changes affect syntax, stdlib, and type hints",
+    },
+    // Data serialization changes
+    {
+        pattern: /(?:protobuf|proto3|avro|thrift).*(?:schema|definition)/i,
+        risk: "Serialization schema change",
+        severity: "critical",
+        detail: "Schema changes can break wire compatibility — ensure backward compat",
+    },
+    // Authentication changes
+    {
+        pattern: /(?:passport|auth0|firebase[.-]auth|cognito).*(?:migrate|upgrade|v\d)/i,
+        risk: "Auth provider migration",
+        severity: "critical",
+        detail: "Auth migrations risk locking out users — run parallel during transition",
+    },
+];
+function analyzeFile(filepath) {
+    const risks = [];
+    let content;
+    try {
+        content = readFileSync(filepath, "utf-8");
+    }
+    catch {
+        return risks;
+    }
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        for (const mp of MIGRATION_PATTERNS) {
+            if (mp.pattern.test(lines[i])) {
+                risks.push({ file: filepath, line: i + 1, risk: mp.risk, severity: mp.severity, detail: mp.detail });
+                break; // One finding per line
+            }
+        }
+    }
+    return risks;
+}
+function detectMigrationContext(dir) {
+    const signals = [];
+    const files = collectFiles(dir, 50);
+    const allContent = files
+        .map((f) => {
+        try {
+            return readFileSync(f, "utf-8");
+        }
+        catch {
+            return "";
+        }
+    })
+        .join("\n");
+    if (/codemod|jscodeshift|ast-grep/i.test(allContent))
+        signals.push("Codemod tooling detected — automated migration in progress");
+    if (/compatibility|compat|shim|polyfill/i.test(allContent))
+        signals.push("Compatibility layer/shim detected");
+    if (/canary|feature.?flag|gradual.?rollout/i.test(allContent))
+        signals.push("Gradual rollout strategy detected");
+    if (/(?:upgrade|migration).?guide|MIGRATION/i.test(allContent))
+        signals.push("Migration guide referenced");
+    return signals;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runMigrationSafety(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges migration-safety — Validate migration PRs for compatibility and data-loss risks
+
+Usage:
+  judges migration-safety [dir]
+  judges migration-safety src/ --format json
+
+Options:
+  [dir]                 Directory to scan (default: .)
+  --format json         JSON output
+  --help, -h            Show this help
+
+Detects: framework version breaks, CJS/ESM mixed imports, schema migrations,
+bundler config changes, deprecated APIs, runtime version changes, serialization
+schema breaks, auth provider migrations.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const dir = argv.find((a) => !a.startsWith("-") && argv.indexOf(a) > 0) || ".";
+    const files = collectFiles(dir);
+    const allRisks = [];
+    for (const f of files)
+        allRisks.push(...analyzeFile(f));
+    const signals = detectMigrationContext(dir);
+    const critCount = allRisks.filter((r) => r.severity === "critical").length;
+    const highCount = allRisks.filter((r) => r.severity === "high").length;
+    const score = allRisks.length === 0 ? 100 : Math.max(0, 100 - critCount * 20 - highCount * 8);
+    if (format === "json") {
+        console.log(JSON.stringify({
+            risks: allRisks,
+            signals,
+            score,
+            summary: { critical: critCount, high: highCount, total: allRisks.length },
+            timestamp: new Date().toISOString(),
+        }, null, 2));
+    }
+    else {
+        const badge = critCount > 0 ? "🚫 HIGH RISK" : highCount > 2 ? "⚠️  CAUTION" : "✅ SAFE";
+        console.log(`\n  Migration Safety: ${badge} (${score}/100)\n  ─────────────────────────────`);
+        if (signals.length > 0) {
+            console.log("\n    Context:");
+            for (const s of signals)
+                console.log(`      📌 ${s}`);
+        }
+        if (allRisks.length === 0) {
+            console.log("\n    No migration risks detected.\n");
+            return;
+        }
+        console.log("\n    Risks:");
+        for (const r of allRisks.slice(0, 25)) {
+            const icon = r.severity === "critical" ? "🚫" : r.severity === "high" ? "🔴" : "🟡";
+            console.log(`      ${icon} [${r.severity.toUpperCase()}] ${r.risk}`);
+            console.log(`          ${r.file}:${r.line}`);
+            console.log(`          ${r.detail}`);
+        }
+        if (allRisks.length > 25)
+            console.log(`      ... and ${allRisks.length - 25} more`);
+        console.log(`\n    Total: ${allRisks.length} | Critical: ${critCount} | High: ${highCount} | Score: ${score}/100\n`);
+    }
+}
+//# sourceMappingURL=migration-safety.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-safety.js","sourceRoot":"","sources":["../../src/commands/migration-safety.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAYrC,+EAA+E;AAE/E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,OAAO;IACP,KAAK;IACL,KAAK;IACL,OAAO;IACP,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,GAAW,EAAE,GAAG,GAAG,GAAG;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,SAAS,IAAI,CAAC,CAAS;QACrB,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;YAAE,OAAO;QAChC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,CAAC,CAAwB,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;gBAAE,OAAO;YAChC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,cAAc,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO;gBAAE,SAAS;YACzF,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;oBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;qBACxC,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAE/E,MAAM,kBAAkB,GAKlB;IACJ,uBAAuB;IACvB;QACE,OAAO,EAAE,kDAAkD;QAC3D,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,2EAA2E;KACpF;IACD;QACE,OAAO,EAAE,sDAAsD;QAC/D,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,sEAAsE;KAC/E;IACD;QACE,OAAO,EAAE,gCAAgC;QACzC,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,+EAA+E;KACxF;IACD;QACE,OAAO,EAAE,wEAAwE;QACjF,IAAI,EAAE,2BAA2B;QACjC,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,yFAAyF;KAClG;IAED,kCAAkC;IAClC;QACE,OAAO,EAAE,0CAA0C;QACnD,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,uDAAuD;KAChE;IACD;QACE,OAAO,EAAE,wBAAwB;QACjC,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,0EAA0E;KACnF;IAED,sBAAsB;IACtB;QACE,OAAO,EAAE,0CAA0C;QACnD,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,mEAAmE;KAC5E;IACD;QACE,OAAO,EAAE,+DAA+D;QACxE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,qEAAqE;KAC9E;IAED,wBAAwB;IACxB;QACE,OAAO,EAAE,8DAA8D;QACvE,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,8DAA8D;KACvE;IAED,sBAAsB;IACtB;QACE,OAAO,EAAE,sDAAsD;QAC/D,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,6DAA6D;KACtE;IAED,kBAAkB;IAClB;QACE,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,6BAA6B;QACnC,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,yEAAyE;KAClF;IACD;QACE,OAAO,EAAE,oCAAoC;QAC7C,IAAI,EAAE,4BAA4B;QAClC,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,8DAA8D;KACvE;IAED,6BAA6B;IAC7B;QACE,OAAO,EAAE,yDAAyD;QAClE,IAAI,EAAE,6BAA6B;QACnC,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,sEAAsE;KAC/E;IAED,yBAAyB;IACzB;QACE,OAAO,EAAE,uEAAuE;QAChF,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,yEAAyE;KAClF;CACF,CAAC;AAEF,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,MAAM,EAAE,IAAI,kBAAkB,EAAE,CAAC;YACpC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;gBACrG,MAAM,CAAC,uBAAuB;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW;IACzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,KAAK;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,IAAI,+BAA+B,CAAC,IAAI,CAAC,UAAU,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC7E,IAAI,qCAAqC,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAC9G,IAAI,wCAAwC,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IACjH,IAAI,yCAAyC,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAE3G,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAE/E,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;CAef,CAAC,CAAC;QACC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,MAAM,CAAC;IAC1F,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC;IAE/E,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;IAC3E,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,GAAG,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;IAE9F,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,KAAK,EAAE,QAAQ;YACf,OAAO;YACP,KAAK;YACL,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE;YACzE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;QACxF,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,KAAK,KAAK,wCAAwC,CAAC,CAAC;QAE9F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC;QAEpF,OAAO,CAAC,GAAG,CACT,gBAAgB,QAAQ,CAAC,MAAM,gBAAgB,SAAS,YAAY,SAAS,aAAa,KAAK,QAAQ,CACxG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/observability-gap.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Observability gap — detect missing metrics, traces, and structured logs
+ * at critical code paths.
+ */
+export declare function runObservabilityGap(argv: string[]): void;
+//# sourceMappingURL=observability-gap.d.ts.map

package/dist/commands/observability-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-gap.d.ts","sourceRoot":"","sources":["../../src/commands/observability-gap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+KH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAgExD"}

package/dist/commands/observability-gap.js

@@ -0,0 +1,212 @@
+/**
+ * Observability gap — detect missing metrics, traces, and structured logs
+ * at critical code paths.
+ */
+import { readFileSync, readdirSync, statSync } from "fs";
+import { join, extname } from "path";
+// ─── File Collection ────────────────────────────────────────────────────────
+const CODE_EXTS = new Set([".ts", ".tsx", ".js", ".jsx", ".py", ".java", ".go", ".rs"]);
+function collectFiles(dir, max = 300) {
+    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 analyzeFile(filepath) {
+    const gaps = [];
+    let content;
+    try {
+        content = readFileSync(filepath, "utf-8");
+    }
+    catch {
+        return gaps;
+    }
+    const lines = content.split("\n");
+    // Track context for scoped analysis
+    let inCatchBlock = false;
+    let catchStart = 0;
+    let inRouteHandler = false;
+    let routeStart = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Detect catch blocks
+        if (/\bcatch\s*\(/.test(line)) {
+            inCatchBlock = true;
+            catchStart = i;
+        }
+        if (inCatchBlock && i - catchStart > 10)
+            inCatchBlock = false;
+        // Catch without logging
+        if (inCatchBlock && /\bcatch\s*\(/.test(line)) {
+            const block = lines.slice(i, Math.min(i + 8, lines.length)).join("\n");
+            if (!/log|logger|console\.(error|warn|log)|logging|slog|zerolog|println|print/i.test(block)) {
+                gaps.push({
+                    file: filepath,
+                    line: i + 1,
+                    gap: "Silent catch block",
+                    severity: "high",
+                    suggestion: "Log error details with context (request ID, user, operation)",
+                });
+            }
+        }
+        // Detect route/endpoint handlers
+        if (/\.(get|post|put|delete|patch)\s*\(\s*['"]\//.test(line) ||
+            /@(Get|Post|Put|Delete|Patch)Mapping/.test(line) ||
+            /app\.route|@app\.(get|post|put|delete)/.test(line)) {
+            inRouteHandler = true;
+            routeStart = i;
+        }
+        if (inRouteHandler && i - routeStart > 30)
+            inRouteHandler = false;
+        // HTTP handler without latency tracking
+        if (inRouteHandler && i === routeStart) {
+            const block = lines.slice(i, Math.min(i + 30, lines.length)).join("\n");
+            if (!/histogram|timer|latency|duration|perf_hooks|performance\.now|time\.Since|Stopwatch/i.test(block)) {
+                gaps.push({
+                    file: filepath,
+                    line: i + 1,
+                    gap: "Endpoint without latency metrics",
+                    severity: "medium",
+                    suggestion: "Add response-time histogram/metric for SLO monitoring",
+                });
+            }
+        }
+        // External calls without tracing
+        if (/fetch\(|axios\.|http\.request|httpClient|requests\.(get|post)|gorequest|reqwest/i.test(line)) {
+            const surrounding = lines.slice(Math.max(0, i - 3), Math.min(i + 3, lines.length)).join("\n");
+            if (!/trace|span|opentelemetry|tracing|X-Request-Id|correlation.?id|traceparent/i.test(surrounding)) {
+                gaps.push({
+                    file: filepath,
+                    line: i + 1,
+                    gap: "Outbound call without trace propagation",
+                    severity: "medium",
+                    suggestion: "Propagate trace context (traceparent header) for distributed tracing",
+                });
+            }
+        }
+        // Background/scheduled jobs without heartbeat
+        if (/setInterval|cron\.schedule|@Scheduled|BackgroundJob|celery|sidekiq/i.test(line)) {
+            const surrounding = lines.slice(i, Math.min(i + 15, lines.length)).join("\n");
+            if (!/heartbeat|health|alive|lastRun|metric|gauge/i.test(surrounding)) {
+                gaps.push({
+                    file: filepath,
+                    line: i + 1,
+                    gap: "Background job without heartbeat",
+                    severity: "high",
+                    suggestion: "Emit heartbeat metric or last-run timestamp for alerting",
+                });
+            }
+        }
+        // Database queries without instrumentation
+        if (/\.query\s*\(|\.execute\s*\(|\.raw\s*\(|cursor\.execute|db\.Exec|sqlx/i.test(line)) {
+            const surrounding = lines.slice(Math.max(0, i - 2), Math.min(i + 5, lines.length)).join("\n");
+            if (!/span|trace|metric|histogram|timer|duration|slow.?query/i.test(surrounding)) {
+                gaps.push({
+                    file: filepath,
+                    line: i + 1,
+                    gap: "DB query without instrumentation",
+                    severity: "low",
+                    suggestion: "Add query timing to detect slow queries",
+                });
+            }
+        }
+        // Queue/message consumers without metrics
+        if (/\.consume\s*\(|\.subscribe\s*\(|@RabbitListener|@KafkaListener|on\s*\(\s*['"]message['"]\s*\)/i.test(line)) {
+            const surrounding = lines.slice(i, Math.min(i + 15, lines.length)).join("\n");
+            if (!/metric|counter|gauge|processed|lag|backlog/i.test(surrounding)) {
+                gaps.push({
+                    file: filepath,
+                    line: i + 1,
+                    gap: "Message consumer without processing metrics",
+                    severity: "medium",
+                    suggestion: "Track message processing rate, lag, and error counters",
+                });
+            }
+        }
+    }
+    return gaps;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runObservabilityGap(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges observability-gap — Detect missing instrumentation at critical paths
+
+Usage:
+  judges observability-gap [dir]
+  judges observability-gap src/ --format json
+
+Options:
+  [dir]                 Directory to scan (default: .)
+  --format json         JSON output
+  --help, -h            Show this help
+
+Detects: silent catch blocks, endpoints without latency metrics, outbound calls
+without trace propagation, background jobs without heartbeats, DB queries without
+instrumentation, message consumers without processing metrics.
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const dir = argv.find((a) => !a.startsWith("-") && argv.indexOf(a) > 0) || ".";
+    const files = collectFiles(dir);
+    const allGaps = [];
+    for (const f of files)
+        allGaps.push(...analyzeFile(f));
+    const highCount = allGaps.filter((g) => g.severity === "high").length;
+    const medCount = allGaps.filter((g) => g.severity === "medium").length;
+    const score = Math.max(0, 100 - highCount * 10 - medCount * 5);
+    if (format === "json") {
+        console.log(JSON.stringify({
+            gaps: allGaps,
+            score,
+            summary: { high: highCount, medium: medCount, total: allGaps.length },
+            timestamp: new Date().toISOString(),
+        }, null, 2));
+    }
+    else {
+        const badge = score >= 80 ? "✅ WELL INSTRUMENTED" : score >= 50 ? "⚠️  GAPS FOUND" : "❌ BLIND SPOTS";
+        console.log(`\n  Observability: ${badge} (${score}/100)\n  ──────────────────────────────`);
+        if (allGaps.length === 0) {
+            console.log("    No observability gaps detected.\n");
+            return;
+        }
+        for (const g of allGaps.slice(0, 25)) {
+            const icon = g.severity === "high" ? "🔴" : g.severity === "medium" ? "🟡" : "🔵";
+            console.log(`    ${icon} ${g.gap}`);
+            console.log(`        ${g.file}:${g.line}`);
+            console.log(`        → ${g.suggestion}`);
+        }
+        if (allGaps.length > 25)
+            console.log(`    ... and ${allGaps.length - 25} more`);
+        console.log(`\n    Total: ${allGaps.length} | High: ${highCount} | Medium: ${medCount} | Score: ${score}/100\n`);
+    }
+}
+//# sourceMappingURL=observability-gap.js.map

package/dist/commands/observability-gap.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Prompt replay — reverse-engineer the probable AI prompt that generated
+ * flagged code and suggest improved prompts that produce compliant output.
+ *
+ * Turns Judges into a prompt engineering coach.
+ */
+export declare function runPromptReplay(argv: string[]): void;
+//# sourceMappingURL=prompt-replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-replay.d.ts","sourceRoot":"","sources":["../../src/commands/prompt-replay.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+IH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAsEpD"}