@kevinrabun/judges 3.50.0 → 3.52.0

package/dist/commands/design-audit.js

@@ -0,0 +1,302 @@
+/**
+ * Design audit — detect AI-generated code that breaks project
+ * conventions, introduces unnecessary abstractions, or creates
+ * architectural deviation from the baseline.
+ *
+ * All analysis local.
+ */
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join, extname, relative } from "path";
+// ─── Analysers ──────────────────────────────────────────────────────────────
+function analyzeDesignCoherence(content, _filePath, baselinePatterns) {
+    const lines = content.split("\n");
+    const metrics = [];
+    const issues = [];
+    // 1. Convention adherence — does file follow project patterns?
+    const usesProjectImportStyle = baselinePatterns.importStyle === "named" ? /import\s*{/.test(content) : /import\s+\w+\s+from/.test(content);
+    const conventionScore = usesProjectImportStyle ? 80 : 40;
+    metrics.push({ id: "convention", label: "Convention Adherence", score: conventionScore, weight: 20 });
+    if (conventionScore < 60)
+        issues.push({
+            id: "import-style",
+            label: "Import Style Deviation",
+            severity: "low",
+            detail: "Import style differs from project convention",
+        });
+    // 2. Unnecessary abstraction
+    const classCount = (content.match(/\bclass\s+\w+/g) || []).length;
+    const interfaceCount = (content.match(/\binterface\s+\w+/g) || []).length;
+    const abstractCount = (content.match(/\babstract\s+class/g) || []).length;
+    const singleMethodClasses = (content.match(/class\s+\w+[\s\S]*?{[\s\S]*?(\w+\s*\([\s\S]*?\)[\s\S]*?{[\s\S]*?})[\s\S]*?}/g) || []).length;
+    const overAbstraction = abstractCount > 1 || (classCount > 0 && singleMethodClasses === classCount);
+    const abstractionScore = overAbstraction ? 30 : classCount + interfaceCount > 8 ? 50 : 100;
+    metrics.push({
+        id: "abstraction",
+        label: "Abstraction Level",
+        score: abstractionScore,
+        weight: 20,
+        detail: `${classCount} classes, ${interfaceCount} interfaces, ${abstractCount} abstract`,
+    });
+    if (overAbstraction) {
+        issues.push({
+            id: "over-abstraction",
+            label: "Over-Abstraction",
+            severity: "medium",
+            detail: "Excessive abstraction layers — AI often creates unnecessary wrappers",
+        });
+    }
+    // 3. Orphaned dependencies
+    const imports = content.match(/import\s+(?:{[^}]+}|\w+)\s+from\s+["']([^"']+)["']/g) || [];
+    const unusedImportCount = imports.filter((imp) => {
+        const names = imp
+            .match(/import\s+{([^}]+)}/)?.[1]
+            ?.split(",")
+            .map((s) => s
+            .trim()
+            .split(/\s+as\s+/)
+            .pop()
+            ?.trim()) || [];
+        const defaultName = imp.match(/import\s+(\w+)\s+from/)?.[1];
+        const allNames = [...names, defaultName].filter(Boolean);
+        const afterImport = content.slice(content.indexOf(imp) + imp.length);
+        return allNames.some((n) => !new RegExp(`\\b${n}\\b`).test(afterImport));
+    }).length;
+    const orphanScore = unusedImportCount === 0 ? 100 : unusedImportCount <= 2 ? 60 : 30;
+    metrics.push({
+        id: "orphaned-deps",
+        label: "Dependency Hygiene",
+        score: orphanScore,
+        weight: 15,
+        detail: `${unusedImportCount} potentially unused imports`,
+    });
+    if (unusedImportCount > 0) {
+        issues.push({
+            id: "unused-imports",
+            label: "Orphaned Imports",
+            severity: "low",
+            detail: `${unusedImportCount} import(s) may be unused — common AI-generation artifact`,
+        });
+    }
+    // 4. Pattern consistency
+    const usesCallbacks = /\bcallback\b|\.then\(|function\s*\(err/.test(content);
+    const usesAsync = /\basync\b.*\bawait\b/s.test(content);
+    const usesPromise = /new\s+Promise/.test(content);
+    const asyncPatterns = [usesCallbacks, usesAsync, usesPromise].filter(Boolean).length;
+    const patternScore = asyncPatterns <= 1 ? 100 : asyncPatterns === 2 ? 60 : 30;
+    metrics.push({ id: "pattern-consistency", label: "Pattern Consistency", score: patternScore, weight: 15 });
+    if (asyncPatterns > 1) {
+        issues.push({
+            id: "mixed-async",
+            label: "Mixed Async Patterns",
+            severity: "medium",
+            detail: "Mixes callbacks, async/await, and/or raw Promises — pick one style",
+        });
+    }
+    // 5. Error handling consistency
+    const tryCatchCount = (content.match(/\btry\s*{/g) || []).length;
+    const catchSuppressCount = (content.match(/catch\s*\([^)]*\)\s*{\s*}/g) || []).length;
+    const throwCount = (content.match(/\bthrow\s+/g) || []).length;
+    const errorScore = catchSuppressCount === 0 ? 100 : catchSuppressCount <= 1 ? 70 : 30;
+    metrics.push({
+        id: "error-handling",
+        label: "Error Handling",
+        score: errorScore,
+        weight: 15,
+        detail: `${tryCatchCount} try/catch, ${catchSuppressCount} suppressed, ${throwCount} throws`,
+    });
+    if (catchSuppressCount > 0) {
+        issues.push({
+            id: "suppressed-errors",
+            label: "Suppressed Errors",
+            severity: "high",
+            detail: `${catchSuppressCount} empty catch block(s) — errors silently swallowed`,
+        });
+    }
+    // 6. Naming coherence
+    const camelCase = (content.match(/\b[a-z][a-zA-Z0-9]*[A-Z][a-zA-Z0-9]*/g) || []).length;
+    const snakeCase = (content.match(/\b[a-z]+_[a-z]+/g) || []).length;
+    const mixedNaming = camelCase > 0 && snakeCase > 0;
+    const namingScore = mixedNaming ? (Math.abs(camelCase - snakeCase) > 5 ? 50 : 30) : 100;
+    metrics.push({ id: "naming-coherence", label: "Naming Coherence", score: namingScore, weight: 15 });
+    if (mixedNaming) {
+        issues.push({
+            id: "mixed-naming",
+            label: "Mixed Naming Convention",
+            severity: "low",
+            detail: `${camelCase} camelCase + ${snakeCase} snake_case identifiers`,
+        });
+    }
+    void lines;
+    return { metrics, issues };
+}
+function detectBaseline(files) {
+    let namedCount = 0;
+    let defaultCount = 0;
+    let totalLength = 0;
+    let asyncCount = 0;
+    let callbackCount = 0;
+    for (const f of files.slice(0, 20)) {
+        try {
+            const content = readFileSync(f, "utf-8");
+            totalLength += content.split("\n").length;
+            namedCount += (content.match(/import\s*{/g) || []).length;
+            defaultCount += (content.match(/import\s+\w+\s+from/g) || []).length;
+            if (/\basync\b/.test(content))
+                asyncCount++;
+            if (/\.then\(/.test(content))
+                callbackCount++;
+        }
+        catch {
+            /* skip */
+        }
+    }
+    return {
+        importStyle: namedCount >= defaultCount ? "named" : "default",
+        avgFileLength: files.length > 0 ? Math.round(totalLength / Math.min(files.length, 20)) : 0,
+        primaryAsyncPattern: asyncCount >= callbackCount ? "async/await" : "callbacks",
+    };
+}
+// ─── Scanner ────────────────────────────────────────────────────────────────
+const SKIP = new Set(["node_modules", ".git", "dist", "build", "coverage"]);
+const EXTS = new Set([".ts", ".js", ".py", ".java", ".cs", ".go", ".rb", ".php", ".rs"]);
+function collectFiles(dir) {
+    const result = [];
+    function walk(d) {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (SKIP.has(name) || name.startsWith("."))
+                continue;
+            const full = join(d, name);
+            try {
+                const sub = readdirSync(full);
+                void sub;
+                walk(full);
+            }
+            catch {
+                if (EXTS.has(extname(name).toLowerCase()))
+                    result.push(full);
+            }
+        }
+    }
+    walk(dir);
+    return result;
+}
+function gradeFor(score) {
+    if (score >= 90)
+        return "A";
+    if (score >= 80)
+        return "B";
+    if (score >= 70)
+        return "C";
+    if (score >= 60)
+        return "D";
+    return "F";
+}
+function computeOverall(metrics) {
+    const totalWeight = metrics.reduce((s, m) => s + m.weight, 0);
+    const weighted = metrics.reduce((s, m) => s + m.score * m.weight, 0);
+    return totalWeight > 0 ? Math.round(weighted / totalWeight) : 0;
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runDesignAudit(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges design-audit — Detect code that breaks project conventions
+
+Usage:
+  judges design-audit <file-or-dir>
+  judges design-audit src/ --min-grade C
+
+Options:
+  --min-grade <A-F>   Only show files at or below this grade
+  --format json       JSON output
+  --help, -h          Show this help
+
+Checks:
+  • Convention adherence (import style, project patterns)
+  • Abstraction level (over-engineering, unnecessary wrappers)
+  • Dependency hygiene (orphaned/unused imports)
+  • Pattern consistency (mixed async styles)
+  • Error handling (suppressed errors, empty catch blocks)
+  • Naming coherence (mixed camelCase/snake_case)
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const minGrade = argv.find((_a, i) => argv[i - 1] === "--min-grade");
+    const target = argv.find((a) => !a.startsWith("--") && !argv[argv.indexOf(a) - 1]?.startsWith("--")) || ".";
+    if (!existsSync(target)) {
+        console.error(`  Path not found: ${target}`);
+        return;
+    }
+    let files;
+    try {
+        readdirSync(target);
+        files = collectFiles(target);
+    }
+    catch {
+        files = [target];
+    }
+    const baseline = detectBaseline(files);
+    const results = [];
+    for (const f of files) {
+        let content;
+        try {
+            content = readFileSync(f, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const { metrics, issues } = analyzeDesignCoherence(content, f, baseline);
+        const overall = computeOverall(metrics);
+        results.push({ file: relative(target, f) || f, overallScore: overall, grade: gradeFor(overall), metrics, issues });
+    }
+    let filtered = results;
+    if (minGrade) {
+        const gradeOrder = ["A", "B", "C", "D", "F"];
+        const minIdx = gradeOrder.indexOf(minGrade.toUpperCase());
+        if (minIdx >= 0)
+            filtered = results.filter((r) => gradeOrder.indexOf(r.grade) >= minIdx);
+    }
+    filtered.sort((a, b) => a.overallScore - b.overallScore);
+    if (format === "json") {
+        console.log(JSON.stringify({ files: filtered, baseline, scannedFiles: files.length, timestamp: new Date().toISOString() }, null, 2));
+    }
+    else {
+        const avgScore = results.length > 0 ? Math.round(results.reduce((s, r) => s + r.overallScore, 0) / results.length) : 0;
+        console.log(`\n  Design Coherence Audit — ${files.length} files`);
+        console.log(`  Average: ${avgScore}/100 (${gradeFor(avgScore)})`);
+        console.log(`  Baseline: ${baseline.importStyle} imports, ${baseline.primaryAsyncPattern}, ~${baseline.avgFileLength} lines/file\n  ──────────────────────────`);
+        if (filtered.length === 0) {
+            console.log(`    ✅ All files meet design coherence threshold\n`);
+            return;
+        }
+        for (const r of filtered.slice(0, 20)) {
+            const icon = r.grade === "A" || r.grade === "B" ? "🟢" : r.grade === "C" ? "🟡" : r.grade === "D" ? "🟠" : "🔴";
+            console.log(`\n    ${icon} ${r.file} — ${r.overallScore}/100 (${r.grade})`);
+            for (const m of r.metrics) {
+                const mIcon = m.score >= 70 ? "✓" : m.score >= 40 ? "~" : "✗";
+                console.log(`        ${mIcon} ${m.label.padEnd(24)} ${String(m.score).padEnd(4)} ${m.detail || ""}`);
+            }
+            if (r.issues.length > 0) {
+                for (const iss of r.issues) {
+                    const sev = iss.severity === "high" ? "🔴" : iss.severity === "medium" ? "🟠" : "🟡";
+                    console.log(`        ${sev} ${iss.detail}`);
+                }
+            }
+        }
+        if (filtered.length > 20)
+            console.log(`    ... and ${filtered.length - 20} more files`);
+        const dist = { A: 0, B: 0, C: 0, D: 0, F: 0 };
+        for (const r of results)
+            dist[r.grade]++;
+        console.log(`\n    Distribution: A:${dist.A} B:${dist.B} C:${dist.C} D:${dist.D} F:${dist.F}\n`);
+    }
+}
+//# sourceMappingURL=design-audit.js.map

package/dist/commands/design-audit.js.map

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

package/dist/commands/hallucination-score.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hallucination score — assign a hallucination risk score (0–100)
+ * to AI-generated code based on detected patterns: generic naming,
+ * suspicious imports, implausible logic, unverified API usage.
+ *
+ * All analysis local.
+ */
+export declare function runHallucinationScore(argv: string[]): void;
+//# sourceMappingURL=hallucination-score.d.ts.map

package/dist/commands/hallucination-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hallucination-score.d.ts","sourceRoot":"","sources":["../../src/commands/hallucination-score.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8PH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAmG1D"}

package/dist/commands/hallucination-score.js

@@ -0,0 +1,317 @@
+/**
+ * Hallucination score — assign a hallucination risk score (0–100)
+ * to AI-generated code based on detected patterns: generic naming,
+ * suspicious imports, implausible logic, unverified API usage.
+ *
+ * All analysis local.
+ */
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join, extname } from "path";
+// ─── Detectors ──────────────────────────────────────────────────────────────
+function detectHallucinationSignals(content, lines) {
+    const signals = [];
+    // 1. Non-existent or suspicious imports
+    const importLines = lines
+        .map((l, i) => ({ line: i + 1, text: l }))
+        .filter((l) => /\bimport\s|require\s*\(/.test(l.text));
+    for (const imp of importLines) {
+        // Suspicious package names (very generic or implausible)
+        if (/["'](?:utils|helpers|common|shared|lib|core|base)["']/.test(imp.text) && !/from\s*["']\./.test(imp.text)) {
+            signals.push({
+                id: "suspicious-import",
+                description: "Generic import name — may reference non-existent package",
+                weight: 15,
+                line: imp.line,
+                evidence: imp.text.trim(),
+            });
+        }
+        // Version-specific imports (hallucinated API paths)
+        if (/["'][^"']+\/v\d+\/[^"']+["']/.test(imp.text)) {
+            signals.push({
+                id: "versioned-import-path",
+                description: "Version-specific import path — verify API exists",
+                weight: 10,
+                line: imp.line,
+                evidence: imp.text.trim(),
+            });
+        }
+    }
+    // 2. Generic/placeholder variable names
+    let genericNames = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (/\b(?:const|let|var)\s+(?:data|result|value|item|thing|stuff|temp|tmp|foo|bar|baz|x|y|z)\s*[=:]/.test(lines[i])) {
+            genericNames++;
+        }
+    }
+    if (genericNames > 3) {
+        signals.push({
+            id: "generic-naming",
+            description: `${genericNames} generic variable names — AI may have generated placeholder code`,
+            weight: 10,
+        });
+    }
+    // 3. TODO/FIXME comments left by AI
+    let todoCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (/\/\/\s*(?:TODO|FIXME|HACK|XXX|PLACEHOLDER)/i.test(lines[i])) {
+            todoCount++;
+        }
+    }
+    if (todoCount > 2) {
+        signals.push({
+            id: "excessive-todos",
+            description: `${todoCount} TODO/FIXME comments — AI left implementation gaps`,
+            weight: 20,
+        });
+    }
+    // 4. Unreachable or dead code patterns
+    for (let i = 0; i < lines.length; i++) {
+        if (/\breturn\b/.test(lines[i]) &&
+            i + 1 < lines.length &&
+            /^\s*\S/.test(lines[i + 1]) &&
+            !/^\s*[}\])]/.test(lines[i + 1]) &&
+            !/^\s*(?:case|default|\/\/|\/?\*)/.test(lines[i + 1])) {
+            signals.push({
+                id: "dead-code",
+                description: "Code after return statement — likely hallucinated",
+                weight: 15,
+                line: i + 2,
+                evidence: lines[i + 1].trim().substring(0, 60),
+            });
+        }
+    }
+    // 5. Contradictory logic
+    for (let i = 0; i < lines.length; i++) {
+        if (/if\s*\(\s*true\s*\)|if\s*\(\s*false\s*\)/.test(lines[i])) {
+            signals.push({
+                id: "tautology",
+                description: "Tautological condition (always true/false)",
+                weight: 20,
+                line: i + 1,
+            });
+        }
+        if (/=\s*null.*\.\w+|=\s*undefined.*\.\w+/.test(lines[i])) {
+            signals.push({
+                id: "null-access",
+                description: "Property access on value just assigned null/undefined",
+                weight: 25,
+                line: i + 1,
+            });
+        }
+    }
+    // 6. Copy-paste artifacts
+    const lineSet = new Map();
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        if (trimmed.length > 20) {
+            if (!lineSet.has(trimmed))
+                lineSet.set(trimmed, []);
+            lineSet.get(trimmed).push(i + 1);
+        }
+    }
+    let duplicateBlocks = 0;
+    for (const [, lineNums] of lineSet) {
+        if (lineNums.length >= 3)
+            duplicateBlocks++;
+    }
+    if (duplicateBlocks > 2) {
+        signals.push({
+            id: "copy-paste-artifact",
+            description: `${duplicateBlocks} repeated code blocks — AI may have duplicated patterns`,
+            weight: 15,
+        });
+    }
+    // 7. Magic numbers/strings
+    let magicCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (/\b(?:0x[0-9a-f]{4,}|\d{5,})\b/i.test(lines[i]) && !/\bconst\b/.test(lines[i]) && !/\/\//.test(lines[i])) {
+            magicCount++;
+        }
+    }
+    if (magicCount > 3) {
+        signals.push({
+            id: "magic-numbers",
+            description: `${magicCount} unexplained magic numbers — AI may have hallucinated constants`,
+            weight: 10,
+        });
+    }
+    // 8. Inconsistent error handling
+    const tryCatchCount = (content.match(/\btry\s*{/g) || []).length;
+    const catchCount = (content.match(/\bcatch\s*\(/g) || []).length;
+    const emptyHandlers = (content.match(/catch\s*\([^)]*\)\s*{\s*}/g) || []).length;
+    if (emptyHandlers > 0) {
+        signals.push({
+            id: "empty-catch",
+            description: `${emptyHandlers} empty catch block(s) — errors silently swallowed`,
+            weight: 15,
+        });
+    }
+    if (tryCatchCount > 0 && catchCount < tryCatchCount) {
+        signals.push({
+            id: "unmatched-try",
+            description: "More try blocks than catch blocks — incomplete error handling",
+            weight: 10,
+        });
+    }
+    // 9. Commented-out code (AI artifact)
+    let commentedCode = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (/^\s*\/\/\s*(?:const|let|var|function|class|import|return|if|for|while)\b/.test(lines[i])) {
+            commentedCode++;
+        }
+    }
+    if (commentedCode > 3) {
+        signals.push({
+            id: "commented-code",
+            description: `${commentedCode} lines of commented-out code — AI left alternative implementations`,
+            weight: 10,
+        });
+    }
+    // 10. Functions with no implementation
+    for (let i = 0; i < lines.length; i++) {
+        if (/\bfunction\s+\w+\s*\([^)]*\)\s*{\s*}/.test(lines[i]) || /=>\s*{\s*}/.test(lines[i])) {
+            signals.push({
+                id: "empty-function",
+                description: "Empty function body — stub not implemented",
+                weight: 20,
+                line: i + 1,
+            });
+        }
+    }
+    return signals;
+}
+// ─── Scanner ────────────────────────────────────────────────────────────────
+const SKIP = new Set(["node_modules", ".git", "dist", "build", "coverage"]);
+const EXTS = new Set([".ts", ".js", ".py", ".java", ".cs", ".go", ".rb", ".php", ".rs", ".swift", ".kt"]);
+function collectFiles(dir) {
+    const result = [];
+    function walk(d) {
+        let entries;
+        try {
+            entries = readdirSync(d);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (SKIP.has(name) || name.startsWith("."))
+                continue;
+            const full = join(d, name);
+            try {
+                const sub = readdirSync(full);
+                void sub;
+                walk(full);
+            }
+            catch {
+                if (EXTS.has(extname(name).toLowerCase()))
+                    result.push(full);
+            }
+        }
+    }
+    walk(dir);
+    return result;
+}
+function computeScore(signals) {
+    const raw = signals.reduce((sum, s) => sum + s.weight, 0);
+    return Math.min(100, raw);
+}
+function riskLevel(score) {
+    if (score >= 70)
+        return "critical";
+    if (score >= 45)
+        return "high";
+    if (score >= 20)
+        return "medium";
+    return "low";
+}
+// ─── CLI ────────────────────────────────────────────────────────────────────
+export function runHallucinationScore(argv) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(`
+judges hallucination-score — Assess hallucination risk in AI-generated code
+
+Usage:
+  judges hallucination-score <file-or-dir>
+  judges hallucination-score src/ --min-risk medium
+
+Options:
+  --min-risk <level>  Only show files at or above this risk (low, medium, high, critical)
+  --format json       JSON output
+  --help, -h          Show this help
+
+Signals detected:
+  • Suspicious/non-existent imports
+  • Generic placeholder naming
+  • Excessive TODO/FIXME comments
+  • Dead code after return statements
+  • Tautological conditions
+  • Copy-paste artifacts
+  • Magic numbers
+  • Empty catch blocks
+  • Commented-out code
+  • Empty function stubs
+`);
+        return;
+    }
+    const format = argv.find((_a, i) => argv[i - 1] === "--format") || "text";
+    const minRisk = argv.find((_a, i) => argv[i - 1] === "--min-risk");
+    const target = argv.find((a) => !a.startsWith("--") && !argv[argv.indexOf(a) - 1]?.startsWith("--")) || ".";
+    if (!existsSync(target)) {
+        console.error(`  Path not found: ${target}`);
+        return;
+    }
+    let files;
+    try {
+        readdirSync(target);
+        files = collectFiles(target);
+    }
+    catch {
+        files = [target];
+    }
+    const scored = [];
+    for (const f of files) {
+        let content;
+        try {
+            content = readFileSync(f, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split("\n");
+        const signals = detectHallucinationSignals(content, lines);
+        const score = computeScore(signals);
+        scored.push({ file: f, score, riskLevel: riskLevel(score), signals });
+    }
+    let filtered = scored;
+    if (minRisk) {
+        const order = ["low", "medium", "high", "critical"];
+        const minIdx = order.indexOf(minRisk);
+        if (minIdx >= 0)
+            filtered = scored.filter((s) => order.indexOf(s.riskLevel) >= minIdx);
+    }
+    filtered.sort((a, b) => b.score - a.score);
+    if (format === "json") {
+        console.log(JSON.stringify({ files: filtered, scannedFiles: files.length, timestamp: new Date().toISOString() }, null, 2));
+    }
+    else {
+        console.log(`\n  Hallucination Risk Assessment — ${files.length} files`);
+        console.log(`  ──────────────────────────`);
+        if (filtered.length === 0) {
+            console.log(`    ✅ No hallucination risks above threshold\n`);
+            return;
+        }
+        for (const f of filtered.slice(0, 20)) {
+            const icon = f.riskLevel === "critical" ? "🔴" : f.riskLevel === "high" ? "🟠" : f.riskLevel === "medium" ? "🟡" : "🟢";
+            console.log(`\n    ${icon} ${f.file} — Score: ${f.score}/100 (${f.riskLevel})`);
+            for (const s of f.signals) {
+                console.log(`        • ${s.description}${s.line ? ` (line ${s.line})` : ""}`);
+            }
+        }
+        if (filtered.length > 20)
+            console.log(`    ... and ${filtered.length - 20} more files`);
+        const avgScore = Math.round(filtered.reduce((sum, f) => sum + f.score, 0) / filtered.length);
+        console.log(`\n    Average risk score: ${avgScore}/100`);
+        console.log(`    Critical: ${filtered.filter((f) => f.riskLevel === "critical").length} | High: ${filtered.filter((f) => f.riskLevel === "high").length} | Medium: ${filtered.filter((f) => f.riskLevel === "medium").length} | Low: ${filtered.filter((f) => f.riskLevel === "low").length}\n`);
+    }
+}
+//# sourceMappingURL=hallucination-score.js.map