@kevinrabun/judges 3.31.0 → 3.33.0

package/dist/evaluators/over-engineering.d.ts

@@ -0,0 +1,3 @@
+import type { Finding } from "../types.js";
+export declare function analyzeOverEngineering(code: string, language: string): Finding[];
+//# sourceMappingURL=over-engineering.d.ts.map

package/dist/evaluators/over-engineering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"over-engineering.d.ts","sourceRoot":"","sources":["../../src/evaluators/over-engineering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAuLhF"}

package/dist/evaluators/over-engineering.js

@@ -0,0 +1,161 @@
+import { getLineNumbers } from "./shared.js";
+export function analyzeOverEngineering(code, language) {
+    const findings = [];
+    let ruleNum = 1;
+    const prefix = "OVER";
+    const lines = code.split("\n");
+    const loc = lines.length;
+    // Skip test files — they legitimately use builders / helpers
+    const isTestFile = /\b(?:describe|it|test)\s*\(/i.test(code) || /\b(?:test|spec|__tests__)\b/i.test(language);
+    if (isTestFile)
+        return findings;
+    // ─── OVER-001: Single-implementation abstractions ──────────────────────────
+    // Detect abstract class / interface with only one implementation in the file
+    const abstractDecls = getLineNumbers(code, /(?:abstract\s+class|interface\s+)\w+/g);
+    const classDecls = getLineNumbers(code, /class\s+\w+\s+(?:extends|implements)\s+\w+/g);
+    // In a single file, if we see ≥ 3 abstract/interface declarations but few
+    // implementing classes, the abstractions are likely unnecessary.
+    if (abstractDecls.length >= 3 && classDecls.length <= abstractDecls.length) {
+        findings.push({
+            ruleId: `${prefix}-${String(ruleNum++).padStart(3, "0")}`,
+            severity: "medium",
+            title: "Multiple single-implementation abstractions",
+            description: `Found ${abstractDecls.length} abstract classes or interfaces with at most ${classDecls.length} implementing class(es) in the same file. Each abstraction adds cognitive overhead; prefer concrete implementations until a second consumer requires polymorphism.`,
+            lineNumbers: abstractDecls.slice(0, 5),
+            recommendation: "Remove abstractions that have only one implementation. Introduce interfaces when you have two or more consumers or when crossing module boundaries.",
+            reference: "YAGNI — You Aren't Gonna Need It",
+            suggestedFix: "Inline the interface into the concrete class. Extract an interface later when a second implementation is needed.",
+            confidence: 0.7,
+        });
+    }
+    // ─── OVER-002: Trivial wrappers around builtins ──────────────────────────
+    // Functions that simply delegate to a builtin with no added logic
+    const wrapperPatterns = /(?:function|const|export\s+(?:function|const))\s+\w*(?:wrapper|wrap|helper|util)\w*\s*(?:=\s*(?:\([^)]*\)\s*=>|function)|\()/gi;
+    const wrapperLines = getLineNumbers(code, wrapperPatterns);
+    // Also detect trivial fetch/fs/crypto wrappers (functions that return the builtin call directly)
+    const trivialDelegation = /(?:return\s+(?:fetch|fs\.\w+|crypto\.\w+|JSON\.(?:parse|stringify)|console\.\w+|Math\.\w+)\s*\()/g;
+    const trivialLines = getLineNumbers(code, trivialDelegation);
+    if (trivialLines.length >= 5) {
+        findings.push({
+            ruleId: `${prefix}-${String(ruleNum++).padStart(3, "0")}`,
+            severity: "high",
+            title: "Excessive trivial wrappers around standard APIs",
+            description: `Found ${trivialLines.length} functions that simply delegate to standard library calls (fetch, fs, JSON, crypto) with no added value (no retry, caching, logging, or error handling).`,
+            lineNumbers: trivialLines.slice(0, 5),
+            recommendation: "Call the standard API directly. Wrappers are justified only when they add cross-cutting concerns (retry, circuit-breaking, telemetry, caching).",
+            reference: "Rule of Three — refactoring guidance",
+            suggestedFix: "Remove the wrapper function and call the standard API at each call site.",
+            confidence: 0.7,
+        });
+    }
+    // ─── OVER-003: God interfaces (10+ methods) ──────────────────────────────
+    // Detect interfaces with many method signatures
+    const interfaceBlocks = code.matchAll(/(?:interface|abstract\s+class)\s+(\w+)[^{]*\{([^}]{200,})\}/gs);
+    const godInterfaces = [];
+    for (const m of interfaceBlocks) {
+        const body = m[2];
+        // Count method-like signatures: lines with parentheses (method signatures)
+        const methodCount = (body.match(/\w+\s*\([^)]*\)\s*[;:{]/g) || []).length;
+        if (methodCount >= 10) {
+            const idx = code.indexOf(m[0]);
+            const line = code.slice(0, idx).split("\n").length;
+            godInterfaces.push({ name: m[1], line, methodCount });
+        }
+    }
+    if (godInterfaces.length > 0) {
+        findings.push({
+            ruleId: `${prefix}-${String(ruleNum++).padStart(3, "0")}`,
+            severity: "medium",
+            title: "God interface detected",
+            description: `${godInterfaces.length} interface(s) with 10+ methods: ${godInterfaces
+                .map((g) => `${g.name} (${g.methodCount} methods)`)
+                .join(", ")}. Large interfaces violate the Interface Segregation Principle.`,
+            lineNumbers: godInterfaces.map((g) => g.line),
+            recommendation: "Split into smaller, focused interfaces that each serve a specific client. Consumers should not depend on methods they do not use.",
+            reference: "SOLID — Interface Segregation Principle (ISP)",
+            suggestedFix: "Extract related methods into separate interfaces (e.g., IReadable, IWritable).",
+            confidence: 0.75,
+        });
+    }
+    // ─── OVER-004: Builder/factory for simple objects ─────────────────────────
+    const builderPattern = /class\s+\w*Builder\w*\s*[{<]/g;
+    const factoryPattern = /class\s+\w*Factory\w*\s*[{<]/g;
+    const builderLines = getLineNumbers(code, builderPattern);
+    const factoryLines = getLineNumbers(code, factoryPattern);
+    // Check if the built object has few fields (≤ 3 setters in the builder)
+    if (builderLines.length > 0) {
+        const builderMatch = code.match(/class\s+\w*Builder\w*[^}]*\}/s);
+        if (builderMatch) {
+            const setterCount = (builderMatch[0].match(/\bset\w+\s*\(|with\w+\s*\(/g) || []).length;
+            if (setterCount <= 3) {
+                findings.push({
+                    ruleId: `${prefix}-${String(ruleNum++).padStart(3, "0")}`,
+                    severity: "low",
+                    title: "Builder pattern for simple object",
+                    description: `Builder class has only ${setterCount} setter(s). For objects with ≤ 3 fields, a constructor or object literal is simpler and more readable.`,
+                    lineNumbers: builderLines,
+                    recommendation: "Use a constructor, factory function, or object literal. Reserve the Builder pattern for objects with many optional fields (≥ 5).",
+                    reference: "Effective Java, Item 2 — Consider a builder when faced with many constructor parameters",
+                    suggestedFix: "Replace the Builder with a plain constructor: `new Foo({ field1, field2, field3 })`.",
+                    confidence: 0.7,
+                });
+            }
+        }
+    }
+    // ─── OVER-005: Enterprise patterns in small code ──────────────────────────
+    if (loc < 500) {
+        const enterprisePatterns = [
+            {
+                pattern: /(?:@Injectable|@Inject|Container\.get|container\.resolve|ServiceLocator|Injector)/g,
+                name: "dependency injection container",
+            },
+            {
+                pattern: /(?:EventBus|EventEmitter|MessageBroker|PubSub|EventDispatcher)(?:\s*[({<])/g,
+                name: "event bus / message broker",
+            },
+            {
+                pattern: /(?:AbstractFactory|FactoryMethod|ServiceRegistry|PluginManager)(?:\s*[({<])/g,
+                name: "abstract factory / registry",
+            },
+        ];
+        const found = [];
+        for (const ep of enterprisePatterns) {
+            const epLines = getLineNumbers(code, ep.pattern);
+            if (epLines.length > 0) {
+                found.push({ name: ep.name, lines: epLines });
+            }
+        }
+        if (found.length >= 2) {
+            findings.push({
+                ruleId: `${prefix}-${String(ruleNum++).padStart(3, "0")}`,
+                severity: "medium",
+                title: "Enterprise patterns in small codebase",
+                description: `File has only ${loc} lines but uses ${found.length} enterprise-grade patterns: ${found
+                    .map((f) => f.name)
+                    .join(", ")}. This adds complexity disproportionate to the code's scope.`,
+                lineNumbers: found.flatMap((f) => f.lines).slice(0, 5),
+                recommendation: "For small services (< 500 LOC), prefer direct function calls, simple module imports, and constructor parameters. Introduce DI containers and event buses only when the codebase grows to warrant them.",
+                reference: "KISS Principle / Simple Design",
+                suggestedFix: "Replace the container with direct constructor injection or module-level imports.",
+                confidence: 0.65,
+            });
+        }
+    }
+    // ─── OVER-006: Excessive generic type parameters ──────────────────────────
+    const genericHeavy = getLineNumbers(code, /<\w+(?:\s+extends\s+\w+)?,\s*\w+(?:\s+extends\s+\w+)?,\s*\w+(?:\s+extends\s+\w+)?(?:,\s*\w+(?:\s+extends\s+\w+)?)*>/g);
+    if (genericHeavy.length >= 3) {
+        findings.push({
+            ruleId: `${prefix}-${String(ruleNum++).padStart(3, "0")}`,
+            severity: "medium",
+            title: "Excessive generic type parameters",
+            description: `Found ${genericHeavy.length} declaration(s) with 3+ generic type parameters. Deeply parameterised types are hard to read and often indicate over-generalisation.`,
+            lineNumbers: genericHeavy.slice(0, 5),
+            recommendation: "Reduce generic parameters by using concrete types where only one instantiation exists. Extract type aliases for complex generic combinations.",
+            reference: "TypeScript Handbook — Generics / Clean Code",
+            suggestedFix: "Replace unused generic parameters with concrete types.",
+            confidence: 0.6,
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=over-engineering.js.map

package/dist/evaluators/over-engineering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"over-engineering.js","sourceRoot":"","sources":["../../src/evaluators/over-engineering.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,QAAgB;IACnE,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IAEzB,6DAA6D;IAC7D,MAAM,UAAU,GAAG,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,8BAA8B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9G,IAAI,UAAU;QAAE,OAAO,QAAQ,CAAC;IAEhC,8EAA8E;IAC9E,6EAA6E;IAC7E,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,EAAE,uCAAuC,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,EAAE,6CAA6C,CAAC,CAAC;IAEvF,0EAA0E;IAC1E,iEAAiE;IACjE,IAAI,aAAa,CAAC,MAAM,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;QAC3E,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACzD,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,6CAA6C;YACpD,WAAW,EAAE,SAAS,aAAa,CAAC,MAAM,gDAAgD,UAAU,CAAC,MAAM,oKAAoK;YAC/Q,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACtC,cAAc,EACZ,qJAAqJ;YACvJ,SAAS,EAAE,kCAAkC;YAC7C,YAAY,EACV,kHAAkH;YACpH,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,kEAAkE;IAClE,MAAM,eAAe,GACnB,gIAAgI,CAAC;IACnI,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAE3D,iGAAiG;IACjG,MAAM,iBAAiB,GACrB,mGAAmG,CAAC;IACtG,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAE7D,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACzD,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,iDAAiD;YACxD,WAAW,EAAE,SAAS,YAAY,CAAC,MAAM,0JAA0J;YACnM,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACrC,cAAc,EACZ,iJAAiJ;YACnJ,SAAS,EAAE,sCAAsC;YACjD,YAAY,EAAE,0EAA0E;YACxF,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,gDAAgD;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,+DAA+D,CAAC,CAAC;IACvG,MAAM,aAAa,GAA0D,EAAE,CAAC;IAChF,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,2EAA2E;QAC3E,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC1E,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACnD,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACzD,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,GAAG,aAAa,CAAC,MAAM,mCAAmC,aAAa;iBACjF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,WAAW,CAAC;iBAClD,IAAI,CAAC,IAAI,CAAC,iEAAiE;YAC9E,WAAW,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7C,cAAc,EACZ,mIAAmI;YACrI,SAAS,EAAE,+CAA+C;YAC1D,YAAY,EAAE,gFAAgF;YAC9F,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,MAAM,cAAc,GAAG,+BAA+B,CAAC;IACvD,MAAM,cAAc,GAAG,+BAA+B,CAAC;IACvD,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAE1D,wEAAwE;IACxE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACjE,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACxF,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC;oBACZ,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;oBACzD,QAAQ,EAAE,KAAK;oBACf,KAAK,EAAE,mCAAmC;oBAC1C,WAAW,EAAE,0BAA0B,WAAW,wGAAwG;oBAC1J,WAAW,EAAE,YAAY;oBACzB,cAAc,EACZ,kIAAkI;oBACpI,SAAS,EAAE,yFAAyF;oBACpG,YAAY,EAAE,sFAAsF;oBACpG,UAAU,EAAE,GAAG;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,MAAM,kBAAkB,GAAG;YACzB;gBACE,OAAO,EAAE,oFAAoF;gBAC7F,IAAI,EAAE,gCAAgC;aACvC;YACD;gBACE,OAAO,EAAE,6EAA6E;gBACtF,IAAI,EAAE,4BAA4B;aACnC;YACD;gBACE,OAAO,EAAE,8EAA8E;gBACvF,IAAI,EAAE,6BAA6B;aACpC;SACF,CAAC;QAEF,MAAM,KAAK,GAAwC,EAAE,CAAC;QACtD,KAAK,MAAM,EAAE,IAAI,kBAAkB,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;gBACzD,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,uCAAuC;gBAC9C,WAAW,EAAE,iBAAiB,GAAG,mBAAmB,KAAK,CAAC,MAAM,+BAA+B,KAAK;qBACjG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAClB,IAAI,CAAC,IAAI,CAAC,8DAA8D;gBAC3E,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtD,cAAc,EACZ,wMAAwM;gBAC1M,SAAS,EAAE,gCAAgC;gBAC3C,YAAY,EAAE,kFAAkF;gBAChG,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,MAAM,YAAY,GAAG,cAAc,CACjC,IAAI,EACJ,sHAAsH,CACvH,CAAC;IACF,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YACzD,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,mCAAmC;YAC1C,WAAW,EAAE,SAAS,YAAY,CAAC,MAAM,sIAAsI;YAC/K,WAAW,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACrC,cAAc,EACZ,+IAA+I;YACjJ,SAAS,EAAE,6CAA6C;YACxD,YAAY,EAAE,wDAAwD;YACtE,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/formatters/pdf.d.ts

@@ -0,0 +1,13 @@
+/**
+ * PDF-Ready Report Formatter — Print-optimized HTML output.
+ *
+ * Generates a single-file HTML report optimized for "Print → Save as PDF":
+ *   - Clean print layout with page breaks
+ *   - No interactive elements (no JavaScript)
+ *   - Fixed-width tables for consistent rendering
+ *   - @media print styles for proper pagination
+ *   - Executive summary on first page
+ */
+import type { TribunalVerdict } from "../types.js";
+export declare function verdictToPdfHtml(verdict: TribunalVerdict, filePath?: string): string;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/formatters/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/formatters/pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAW,MAAM,aAAa,CAAC;AA4C5D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA0FpF"}

package/dist/formatters/pdf.js

@@ -0,0 +1,138 @@
+/**
+ * PDF-Ready Report Formatter — Print-optimized HTML output.
+ *
+ * Generates a single-file HTML report optimized for "Print → Save as PDF":
+ *   - Clean print layout with page breaks
+ *   - No interactive elements (no JavaScript)
+ *   - Fixed-width tables for consistent rendering
+ *   - @media print styles for proper pagination
+ *   - Executive summary on first page
+ */
+function esc(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function severityColor(severity) {
+    switch (severity) {
+        case "critical":
+            return "#dc2626";
+        case "high":
+            return "#ea580c";
+        case "medium":
+            return "#ca8a04";
+        case "low":
+            return "#2563eb";
+        case "info":
+            return "#6b7280";
+        default:
+            return "#6b7280";
+    }
+}
+function renderFinding(f) {
+    const color = severityColor(f.severity);
+    return `<tr>
+    <td><span style="color:${color};font-weight:600">${esc(f.severity.toUpperCase())}</span></td>
+    <td><code>${esc(f.ruleId)}</code></td>
+    <td>${esc(f.title)}</td>
+    <td>${f.lineNumbers?.join(", ") ?? "—"}</td>
+    <td>${esc(f.confidenceTier ?? "—")}</td>
+  </tr>
+  <tr class="detail-row">
+    <td colspan="5">
+      <div class="detail">${esc(f.description)}${f.recommendation ? `<br><strong>Recommendation:</strong> ${esc(f.recommendation)}` : ""}</div>
+    </td>
+  </tr>`;
+}
+export function verdictToPdfHtml(verdict, filePath) {
+    const totalFindings = verdict.evaluations.reduce((s, e) => s + e.findings.length, 0);
+    const allFindings = verdict.evaluations.flatMap((e) => e.findings);
+    const severityCounts = {
+        critical: allFindings.filter((f) => f.severity === "critical").length,
+        high: allFindings.filter((f) => f.severity === "high").length,
+        medium: allFindings.filter((f) => f.severity === "medium").length,
+        low: allFindings.filter((f) => f.severity === "low").length,
+        info: allFindings.filter((f) => f.severity === "info").length,
+    };
+    const timestamp = new Date(verdict.timestamp).toLocaleString();
+    const fileLabel = filePath ? esc(filePath) : "stdin";
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>Judges Panel Report — ${fileLabel}</title>
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body { font-family: "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; color: #1a1a1a; line-height: 1.5; padding: 2rem; max-width: 210mm; margin: 0 auto; font-size: 10pt; }
+  h1 { font-size: 18pt; margin-bottom: 2pt; }
+  h2 { font-size: 13pt; margin: 1.5rem 0 0.5rem; border-bottom: 2px solid #e5e7eb; padding-bottom: 4pt; page-break-after: avoid; }
+  .meta { color: #6b7280; font-size: 9pt; margin-bottom: 1rem; }
+  .summary-table { width: 100%; border-collapse: collapse; margin-bottom: 1rem; }
+  .summary-table td { padding: 8pt 12pt; text-align: center; border: 1px solid #e5e7eb; }
+  .summary-table .value { font-size: 18pt; font-weight: 700; display: block; }
+  .summary-table .label { font-size: 7pt; color: #6b7280; text-transform: uppercase; letter-spacing: 0.05em; }
+  table.findings { width: 100%; border-collapse: collapse; font-size: 9pt; margin-bottom: 1rem; }
+  table.findings th { background: #f3f4f6; border: 1px solid #d1d5db; padding: 4pt 6pt; text-align: left; font-size: 8pt; text-transform: uppercase; letter-spacing: 0.04em; }
+  table.findings td { border: 1px solid #e5e7eb; padding: 4pt 6pt; vertical-align: top; }
+  table.findings code { font-size: 8pt; background: #f3f4f6; padding: 1pt 3pt; border-radius: 2pt; }
+  .detail-row td { background: #fafbfc; }
+  .detail { font-size: 8.5pt; color: #374151; }
+  .judge-header { background: #f9fafb; padding: 6pt; border: 1px solid #e5e7eb; margin-bottom: -1px; }
+  .judge-header .name { font-weight: 600; }
+  .judge-header .score { float: right; font-weight: 700; }
+  footer { margin-top: 2rem; text-align: center; color: #9ca3af; font-size: 7pt; border-top: 1px solid #e5e7eb; padding-top: 8pt; }
+
+  @media print {
+    body { padding: 0; max-width: none; }
+    h2 { page-break-after: avoid; }
+    table.findings { page-break-inside: auto; }
+    table.findings tr { page-break-inside: avoid; }
+    .detail-row { page-break-inside: avoid; }
+    .judge-section { page-break-inside: avoid; }
+    footer { page-break-before: avoid; }
+    @page { margin: 15mm 12mm; size: A4; }
+  }
+</style>
+</head>
+<body>
+<h1>Judges Panel Report</h1>
+<p class="meta">File: ${fileLabel} &middot; Generated: ${timestamp}</p>
+
+<table class="summary-table">
+  <tr>
+    <td><span class="value" style="color:${verdict.overallVerdict === "pass" ? "#16a34a" : verdict.overallVerdict === "warning" ? "#ca8a04" : "#dc2626"}">${verdict.overallVerdict.toUpperCase()}</span><span class="label">Verdict</span></td>
+    <td><span class="value">${verdict.overallScore}</span><span class="label">Score / 100</span></td>
+    <td><span class="value">${totalFindings}</span><span class="label">Total Findings</span></td>
+    <td><span class="value">${verdict.evaluations.length}</span><span class="label">Judges</span></td>
+  </tr>
+  <tr>
+    <td><span class="value" style="color:${severityColor("critical")}">${severityCounts.critical}</span><span class="label">Critical</span></td>
+    <td><span class="value" style="color:${severityColor("high")}">${severityCounts.high}</span><span class="label">High</span></td>
+    <td><span class="value" style="color:${severityColor("medium")}">${severityCounts.medium}</span><span class="label">Medium</span></td>
+    <td><span class="value" style="color:${severityColor("low")}">${severityCounts.low}</span><span class="label">Low</span></td>
+  </tr>
+</table>
+
+${verdict.evaluations
+        .filter((e) => e.findings.length > 0)
+        .map((e) => `<h2>${esc(e.judgeName)}</h2>
+<div class="judge-header">
+  <span class="name">${esc(e.judgeId)}</span>
+  <span class="score">Score: ${e.score}/100 — ${e.verdict.toUpperCase()}</span>
+</div>
+<table class="findings">
+  <thead><tr><th style="width:70px">Severity</th><th style="width:100px">Rule</th><th>Title</th><th style="width:40px">Line</th><th style="width:70px">Confidence</th></tr></thead>
+  <tbody>${e.findings.map(renderFinding).join("\n")}</tbody>
+</table>`)
+        .join("\n")}
+
+${totalFindings === 0 ? '<p style="color:#16a34a;text-align:center;margin:2rem 0;font-size:12pt">✓ No findings — all judges passed.</p>' : ""}
+
+<footer>Generated by Judges Panel &middot; Open in browser and use File → Print → Save as PDF</footer>
+</body>
+</html>`;
+}
+//# sourceMappingURL=pdf.js.map

package/dist/formatters/pdf.js.map

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

package/dist/judges/accessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/judges/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,kBAAkB,EAAE,eAiChC,CAAC"}
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/judges/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,kBAAkB,EAAE,eAmChC,CAAC"}

package/dist/judges/accessibility.js

@@ -4,6 +4,8 @@ export const accessibilityJudge = {
     domain: "Accessibility (a11y)",
     description: "Evaluates code for WCAG compliance, ARIA attributes, keyboard navigation, screen reader support, color contrast, semantic HTML, and inclusive design patterns.",
     rulePrefix: "A11Y",
+    tableDescription: "WCAG compliance, screen reader support, keyboard navigation, ARIA",
+    promptDescription: "Deep accessibility/WCAG review",
     systemPrompt: `You are Judge Accessibility — a certified accessibility specialist (IAAP CPWA) with 15+ years building inclusive digital experiences, deep expertise in WCAG 2.2, WAI-ARIA, and assistive technology compatibility.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/accessibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../src/judges/accessibility.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE,sBAAsB;IAC9B,WAAW,EACT,gKAAgK;IAClK,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;8HAyB8G;CAC7H,CAAC"}
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../src/judges/accessibility.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE,sBAAsB;IAC9B,WAAW,EACT,gKAAgK;IAClK,UAAU,EAAE,MAAM;IAClB,gBAAgB,EAAE,mEAAmE;IACrF,iBAAiB,EAAE,gCAAgC;IACnD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;8HAyB8G;CAC7H,CAAC"}

package/dist/judges/agent-instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../src/judges/agent-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,sBAAsB,EAAE,eAiCpC,CAAC"}
+{"version":3,"file":"agent-instructions.d.ts","sourceRoot":"","sources":["../../src/judges/agent-instructions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,sBAAsB,EAAE,eAmCpC,CAAC"}

package/dist/judges/agent-instructions.js

@@ -4,6 +4,8 @@ export const agentInstructionsJudge = {
     domain: "Agent Instruction Markdown Quality & Safety",
     description: "Evaluates instruction markdown files for clarity, hierarchy, conflict risk, safety policy coverage, and operational guidance for AI coding agents.",
     rulePrefix: "AGENT",
+    tableDescription: "Instruction hierarchy, conflict detection, unsafe overrides, scope, validation, policy guidance",
+    promptDescription: "Deep review of agent instruction markdown quality and safety",
     systemPrompt: `You are Judge Agent Instructions — a specialist in AI agent governance, instruction hierarchy design, prompt safety, and operational reliability for coding assistants.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/agent-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-instructions.js","sourceRoot":"","sources":["../../src/judges/agent-instructions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAoB;IACrD,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,0BAA0B;IAChC,MAAM,EAAE,6CAA6C;IACrD,WAAW,EACT,oJAAoJ;IACtJ,UAAU,EAAE,OAAO;IACnB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;gGAyBgF;CAC/F,CAAC"}
+{"version":3,"file":"agent-instructions.js","sourceRoot":"","sources":["../../src/judges/agent-instructions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAoB;IACrD,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,0BAA0B;IAChC,MAAM,EAAE,6CAA6C;IACrD,WAAW,EACT,oJAAoJ;IACtJ,UAAU,EAAE,OAAO;IACnB,gBAAgB,EAAE,iGAAiG;IACnH,iBAAiB,EAAE,8DAA8D;IACjF,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;gGAyBgF;CAC/F,CAAC"}

package/dist/judges/ai-code-safety.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-code-safety.d.ts","sourceRoot":"","sources":["../../src/judges/ai-code-safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAE,eA4C/B,CAAC"}
+{"version":3,"file":"ai-code-safety.d.ts","sourceRoot":"","sources":["../../src/judges/ai-code-safety.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAE,eAgD/B,CAAC"}

package/dist/judges/ai-code-safety.js

@@ -4,6 +4,8 @@ export const aiCodeSafetyJudge = {
     domain: "AI-Generated Code Quality & Security",
     description: "Evaluates code for risks specifically common in AI-generated code — prompt injection, unsanitised LLM output, hallucinated patterns, debug-mode defaults, missing input validation, overly broad permissions, and insecure-by-default configurations.",
     rulePrefix: "AICS",
+    tableDescription: "Prompt injection, insecure LLM output handling, debug defaults, missing validation, unsafe deserialization of AI responses",
+    promptDescription: "Deep review of AI-generated code risks: prompt injection, insecure LLM output handling, debug defaults, missing validation",
     systemPrompt: `You are Judge AI Code Safety — a specialist in identifying security, quality, and reliability issues that are disproportionately common in AI-generated code produced by large language models and coding assistants.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/ai-code-safety.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-code-safety.js","sourceRoot":"","sources":["../../src/judges/ai-code-safety.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,sBAAsB;IAC5B,MAAM,EAAE,sCAAsC;IAC9C,WAAW,EACT,uPAAuP;IACzP,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wHAoCwG;CACvH,CAAC"}
+{"version":3,"file":"ai-code-safety.js","sourceRoot":"","sources":["../../src/judges/ai-code-safety.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,sBAAsB;IAC5B,MAAM,EAAE,sCAAsC;IAC9C,WAAW,EACT,uPAAuP;IACzP,UAAU,EAAE,MAAM;IAClB,gBAAgB,EACd,4HAA4H;IAC9H,iBAAiB,EACf,4HAA4H;IAC9H,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wHAoCwG;CACvH,CAAC"}

package/dist/judges/api-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-contract.d.ts","sourceRoot":"","sources":["../../src/judges/api-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,eA2B9B,CAAC"}
+{"version":3,"file":"api-contract.d.ts","sourceRoot":"","sources":["../../src/judges/api-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,gBAAgB,EAAE,eA6B9B,CAAC"}

package/dist/judges/api-contract.js

@@ -1,10 +1,12 @@
 export const apiContractJudge = {
     id: "api-contract",
-    name: "API Contract Conformance",
+    name: "Judge API Contract Conformance",
     description: "Evaluates API endpoint implementations for contract conformance: input validation, " +
         "proper status codes, error handling, rate limiting, versioning, and content-type management.",
     domain: "API Design & REST Best Practices",
     rulePrefix: "API",
+    tableDescription: "API endpoint input validation, REST conformance, request/response contract consistency",
+    promptDescription: "Deep review of API contract conformance, input validation, REST best practices",
     systemPrompt: `You are Judge API Contract Conformance — an expert in REST API design, HTTP semantics, and contract-first development.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/api-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-contract.js","sourceRoot":"","sources":["../../src/judges/api-contract.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,qFAAqF;QACrF,8FAA8F;IAChG,MAAM,EAAE,kCAAkC;IAC1C,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE;;;;;;;;;;;;;;;;;;sFAkBsE;CACrF,CAAC"}
+{"version":3,"file":"api-contract.js","sourceRoot":"","sources":["../../src/judges/api-contract.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,gCAAgC;IACtC,WAAW,EACT,qFAAqF;QACrF,8FAA8F;IAChG,MAAM,EAAE,kCAAkC;IAC1C,UAAU,EAAE,KAAK;IACjB,gBAAgB,EAAE,wFAAwF;IAC1G,iBAAiB,EAAE,gFAAgF;IACnG,YAAY,EAAE;;;;;;;;;;;;;;;;;;sFAkBsE;CACrF,CAAC"}

package/dist/judges/api-design.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-design.d.ts","sourceRoot":"","sources":["../../src/judges/api-design.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,cAAc,EAAE,eAmC5B,CAAC"}
+{"version":3,"file":"api-design.d.ts","sourceRoot":"","sources":["../../src/judges/api-design.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,cAAc,EAAE,eAqC5B,CAAC"}

package/dist/judges/api-design.js

@@ -4,6 +4,8 @@ export const apiDesignJudge = {
     domain: "API Design & Contracts",
     description: "Evaluates API design for RESTful conventions, naming consistency, proper HTTP status codes, versioning, pagination, error contract consistency, and backward compatibility.",
     rulePrefix: "API",
+    tableDescription: "REST conventions, versioning, pagination, error responses",
+    promptDescription: "Deep API design review",
     systemPrompt: `You are Judge API Design — a senior API architect who has designed and governed public APIs used by millions of developers, with deep expertise in REST, GraphQL, gRPC, and API governance.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/api-design.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-design.js","sourceRoot":"","sources":["../../src/judges/api-design.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,wBAAwB;IAChC,WAAW,EACT,6KAA6K;IAC/K,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;gIA2BgH;CAC/H,CAAC"}
+{"version":3,"file":"api-design.js","sourceRoot":"","sources":["../../src/judges/api-design.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,wBAAwB;IAChC,WAAW,EACT,6KAA6K;IAC/K,UAAU,EAAE,KAAK;IACjB,gBAAgB,EAAE,2DAA2D;IAC7E,iBAAiB,EAAE,wBAAwB;IAC3C,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;gIA2BgH;CAC/H,CAAC"}

package/dist/judges/authentication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authentication.d.ts","sourceRoot":"","sources":["../../src/judges/authentication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,eAiCjC,CAAC"}
+{"version":3,"file":"authentication.d.ts","sourceRoot":"","sources":["../../src/judges/authentication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,eAmCjC,CAAC"}

package/dist/judges/authentication.js

@@ -4,6 +4,8 @@ export const authenticationJudge = {
     domain: "Authentication & Authorization",
     description: "Evaluates code for proper authentication mechanisms, authorization checks, session management, token handling, and access control patterns.",
     rulePrefix: "AUTH",
+    tableDescription: "Hardcoded creds, missing auth middleware, token in query params",
+    promptDescription: "Deep authentication & authorization review",
     systemPrompt: `You are Judge Authentication — an identity and access management specialist with deep expertise in OAuth 2.0, OIDC, RBAC, ABAC, and secure session management. You have conducted hundreds of security audits focused specifically on auth systems.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/authentication.js.map

@@ -1 +1 @@
-{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../src/judges/authentication.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,sBAAsB;IAC5B,MAAM,EAAE,gCAAgC;IACxC,WAAW,EACT,6IAA6I;IAC/I,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;sHAyBsG;CACrH,CAAC"}
+{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../src/judges/authentication.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,sBAAsB;IAC5B,MAAM,EAAE,gCAAgC;IACxC,WAAW,EACT,6IAA6I;IAC/I,UAAU,EAAE,MAAM;IAClB,gBAAgB,EAAE,iEAAiE;IACnF,iBAAiB,EAAE,4CAA4C;IAC/D,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;sHAyBsG;CACrH,CAAC"}

package/dist/judges/backwards-compatibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backwards-compatibility.d.ts","sourceRoot":"","sources":["../../src/judges/backwards-compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,2BAA2B,EAAE,eAiCzC,CAAC"}
+{"version":3,"file":"backwards-compatibility.d.ts","sourceRoot":"","sources":["../../src/judges/backwards-compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,2BAA2B,EAAE,eAmCzC,CAAC"}

package/dist/judges/backwards-compatibility.js

@@ -4,6 +4,8 @@ export const backwardsCompatibilityJudge = {
     domain: "Backwards Compatibility & Versioning",
     description: "Evaluates code for breaking changes, API versioning strategy, deprecation practices, and migration path planning that affect consumers and integrators.",
     rulePrefix: "COMPAT",
+    tableDescription: "API versioning, breaking changes, response consistency",
+    promptDescription: "Deep backwards compatibility review",
     systemPrompt: `You are Judge Backwards Compatibility — a platform API architect who has managed public APIs consumed by thousands of integrators. You have deep expertise in semantic versioning, API evolution, deprecation, and migration strategies.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/backwards-compatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"backwards-compatibility.js","sourceRoot":"","sources":["../../src/judges/backwards-compatibility.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAAoB;IAC1D,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,+BAA+B;IACrC,MAAM,EAAE,sCAAsC;IAC9C,WAAW,EACT,yJAAyJ;IAC3J,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;mIAyBmH;CAClI,CAAC"}
+{"version":3,"file":"backwards-compatibility.js","sourceRoot":"","sources":["../../src/judges/backwards-compatibility.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAAoB;IAC1D,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,+BAA+B;IACrC,MAAM,EAAE,sCAAsC;IAC9C,WAAW,EACT,yJAAyJ;IAC3J,UAAU,EAAE,QAAQ;IACpB,gBAAgB,EAAE,wDAAwD;IAC1E,iBAAiB,EAAE,qCAAqC;IACxD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;mIAyBmH;CAClI,CAAC"}

package/dist/judges/caching.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"caching.d.ts","sourceRoot":"","sources":["../../src/judges/caching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,eAiC1B,CAAC"}
+{"version":3,"file":"caching.d.ts","sourceRoot":"","sources":["../../src/judges/caching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,eAmC1B,CAAC"}

package/dist/judges/caching.js

@@ -4,6 +4,8 @@ export const cachingJudge = {
     domain: "Caching Strategy & Data Freshness",
     description: "Evaluates code for caching strategy, cache invalidation, TTL configuration, cache stampede prevention, and HTTP caching headers.",
     rulePrefix: "CACHE",
+    tableDescription: "Unbounded caches, missing TTL, no HTTP cache headers",
+    promptDescription: "Deep caching strategy review",
     systemPrompt: `You are Judge Caching — a performance architect specializing in caching strategies across application layers, CDNs, and distributed systems. You understand that "there are only two hard things in computer science: cache invalidation and naming things."
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/caching.js.map

@@ -1 +1 @@
-{"version":3,"file":"caching.js","sourceRoot":"","sources":["../../src/judges/caching.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,mCAAmC;IAC3C,WAAW,EACT,kIAAkI;IACpI,UAAU,EAAE,OAAO;IACnB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;0HAyB0G;CACzH,CAAC"}
+{"version":3,"file":"caching.js","sourceRoot":"","sources":["../../src/judges/caching.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,mCAAmC;IAC3C,WAAW,EACT,kIAAkI;IACpI,UAAU,EAAE,OAAO;IACnB,gBAAgB,EAAE,sDAAsD;IACxE,iBAAiB,EAAE,8BAA8B;IACjD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;0HAyB0G;CACzH,CAAC"}

package/dist/judges/ci-cd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ci-cd.d.ts","sourceRoot":"","sources":["../../src/judges/ci-cd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,SAAS,EAAE,eAiCvB,CAAC"}
+{"version":3,"file":"ci-cd.d.ts","sourceRoot":"","sources":["../../src/judges/ci-cd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,SAAS,EAAE,eAmCvB,CAAC"}

package/dist/judges/ci-cd.js

@@ -4,6 +4,8 @@ export const ciCdJudge = {
     domain: "CI/CD Pipeline & Deployment Safety",
     description: "Evaluates code for CI/CD readiness, build reproducibility, deployment safety, pipeline configuration, and release management practices.",
     rulePrefix: "CICD",
+    tableDescription: "Test infrastructure, lint config, Docker tags, build scripts",
+    promptDescription: "Deep CI/CD pipeline review",
     systemPrompt: `You are Judge CI/CD — a DevOps engineer and release manager who has built and maintained CI/CD pipelines for organizations shipping hundreds of deployments per day. You specialize in build reproducibility, deployment safety, and release automation.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/ci-cd.js.map

@@ -1 +1 @@
-{"version":3,"file":"ci-cd.js","sourceRoot":"","sources":["../../src/judges/ci-cd.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,oCAAoC;IAC5C,WAAW,EACT,yIAAyI;IAC3I,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;sHAyBsG;CACrH,CAAC"}
+{"version":3,"file":"ci-cd.js","sourceRoot":"","sources":["../../src/judges/ci-cd.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAoB;IACxC,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,oCAAoC;IAC5C,WAAW,EACT,yIAAyI;IAC3I,UAAU,EAAE,MAAM;IAClB,gBAAgB,EAAE,8DAA8D;IAChF,iBAAiB,EAAE,4BAA4B;IAC/C,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;sHAyBsG;CACrH,CAAC"}

package/dist/judges/cloud-readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-readiness.d.ts","sourceRoot":"","sources":["../../src/judges/cloud-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,eAiCjC,CAAC"}
+{"version":3,"file":"cloud-readiness.d.ts","sourceRoot":"","sources":["../../src/judges/cloud-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,mBAAmB,EAAE,eAmCjC,CAAC"}

package/dist/judges/cloud-readiness.js

@@ -4,6 +4,8 @@ export const cloudReadinessJudge = {
     domain: "Cloud-Native Architecture & DevOps",
     description: "Evaluates code for cloud-native patterns, 12-factor app compliance, containerization readiness, infrastructure as code, observability, and CI/CD maturity.",
     rulePrefix: "CLOUD",
+    tableDescription: "12-Factor compliance, containerization, graceful shutdown, IaC",
+    promptDescription: "Deep cloud readiness review",
     systemPrompt: `You are Judge Cloud Readiness — a cloud-native architect and DevOps practitioner certified across AWS, Azure, and GCP with deep expertise in platform engineering and SRE.
 
 YOUR EVALUATION CRITERIA:

package/dist/judges/cloud-readiness.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-readiness.js","sourceRoot":"","sources":["../../src/judges/cloud-readiness.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,uBAAuB;IAC7B,MAAM,EAAE,oCAAoC;IAC5C,WAAW,EACT,4JAA4J;IAC9J,UAAU,EAAE,OAAO;IACnB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;gIAyBgH;CAC/H,CAAC"}
+{"version":3,"file":"cloud-readiness.js","sourceRoot":"","sources":["../../src/judges/cloud-readiness.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,uBAAuB;IAC7B,MAAM,EAAE,oCAAoC;IAC5C,WAAW,EACT,4JAA4J;IAC9J,UAAU,EAAE,OAAO;IACnB,gBAAgB,EAAE,gEAAgE;IAClF,iBAAiB,EAAE,6BAA6B;IAChD,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;gIAyBgH;CAC/H,CAAC"}

package/dist/judges/code-structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-structure.d.ts","sourceRoot":"","sources":["../../src/judges/code-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,kBAAkB,EAAE,eA4ChC,CAAC"}
+{"version":3,"file":"code-structure.d.ts","sourceRoot":"","sources":["../../src/judges/code-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,kBAAkB,EAAE,eA8ChC,CAAC"}

package/dist/judges/code-structure.js

@@ -4,6 +4,8 @@ export const codeStructureJudge = {
     domain: "Structural Analysis",
     description: "Uses AST parsing (TypeScript compiler for JS/TS, scope-tracking parser for Python/Rust/Go/Java/C#) to evaluate cyclomatic complexity, nesting depth, function length, parameter count, dead code, and type-safety — metrics that regex alone cannot reliably measure.",
     rulePrefix: "STRUCT",
+    tableDescription: "Cyclomatic complexity, nesting depth, function length, dead code, type safety",
+    promptDescription: "Deep AST-based structural analysis review",
     systemPrompt: `You are the Code Structure Judge. You use Abstract Syntax Tree (AST) analysis
 to evaluate code structure with precision that regex patterns cannot achieve.
 

package/dist/judges/code-structure.js.map

@@ -1 +1 @@
-{"version":3,"file":"code-structure.js","sourceRoot":"","sources":["../../src/judges/code-structure.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,sBAAsB;IAC5B,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EACT,uQAAuQ;IACzQ,UAAU,EAAE,QAAQ;IACpB,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kLAoCkK;CACjL,CAAC"}
+{"version":3,"file":"code-structure.js","sourceRoot":"","sources":["../../src/judges/code-structure.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,sBAAsB;IAC5B,MAAM,EAAE,qBAAqB;IAC7B,WAAW,EACT,uQAAuQ;IACzQ,UAAU,EAAE,QAAQ;IACpB,gBAAgB,EAAE,+EAA+E;IACjG,iBAAiB,EAAE,2CAA2C;IAC9D,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kLAoCkK;CACjL,CAAC"}

package/dist/judges/compliance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../src/judges/compliance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,eAAe,EAAE,eAoC7B,CAAC"}
+{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../src/judges/compliance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,eAAe,EAAE,eAsC7B,CAAC"}