universal-ast-mapper 1.27.0 → 2.0.0

package/dist/layers.js

@@ -1,36 +0,0 @@
-import { computeCoupling } from "./coupling.js";
-/**
- * Detect violations of Robert C. Martin's Stable Dependencies Principle (SDP):
- * a module should depend only on modules at least as stable as itself. A "stable"
- * file (low instability) that imports a "volatile" file (high instability) is a
- * violation — volatile code changes often and will keep dragging the stable code
- * with it. Severity is the instability gap the dependency crosses.
- */
-export function findLayerViolations(graph, minGap = 0) {
-    const inst = new Map(computeCoupling(graph).map((m) => [m.file, m.instability]));
-    const nodeMap = new Map(graph.nodes.map((n) => [n.id, n]));
-    const seen = new Set();
-    const violations = [];
-    for (const e of graph.edges) {
-        if (e.edgeType !== "imports")
-            continue;
-        const to = nodeMap.get(e.to);
-        const toFile = to ? (to.nodeType === "file" ? to.id : to.file) : null;
-        const fromFile = e.from;
-        if (!toFile || fromFile === toFile)
-            continue;
-        const fi = inst.get(fromFile);
-        const ti = inst.get(toFile);
-        if (fi === undefined || ti === undefined)
-            continue;
-        const severity = Math.round((ti - fi) * 100) / 100;
-        if (severity <= minGap)
-            continue; // only "uphill" dependencies (stable -> volatile)
-        const key = fromFile + " " + toFile;
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        violations.push({ from: fromFile, to: toFile, fromInstability: fi, toInstability: ti, severity });
-    }
-    return violations.sort((a, b) => b.severity - a.severity || a.from.localeCompare(b.from));
-}

package/dist/parser.js

@@ -1,84 +0,0 @@
-import Parser from "web-tree-sitter";
-import { createRequire } from "node:module";
-import path from "node:path";
-const require = createRequire(import.meta.url);
-// `web-tree-sitter` 0.20.x ships a CommonJS class with static members that are
-// only populated after `init()`. We treat the static surface loosely.
-const P = Parser;
-let initPromise = null;
-const languageCache = new Map();
-const parserCache = new Map();
-function pkgDir(spec) {
-    return path.dirname(require.resolve(spec));
-}
-function grammarWasmPath(grammar) {
-    return path.join(pkgDir("tree-sitter-wasms/package.json"), "out", `tree-sitter-${grammar}.wasm`);
-}
-export async function initParser() {
-    if (!initPromise) {
-        const coreDir = pkgDir("web-tree-sitter/package.json");
-        initPromise = P.init({
-            locateFile(name) {
-                // The runtime requests "tree-sitter.wasm"; serve it from the package dir.
-                return path.join(coreDir, name);
-            },
-        });
-    }
-    return initPromise;
-}
-async function loadLanguage(grammar) {
-    await initParser();
-    const cached = languageCache.get(grammar);
-    if (cached)
-        return cached;
-    const lang = await P.Language.load(grammarWasmPath(grammar));
-    languageCache.set(grammar, lang);
-    return lang;
-}
-/** Parse source code with the given grammar and return the root node. */
-export async function parseSource(grammar, source) {
-    const lang = await loadLanguage(grammar);
-    let parser = parserCache.get(grammar);
-    if (!parser) {
-        parser = new P();
-        parser.setLanguage(lang);
-        parserCache.set(grammar, parser);
-    }
-    return parser.parse(source).rootNode;
-}
-/* ----------------------------- node helpers ----------------------------- */
-export function namedChildren(node) {
-    const out = [];
-    for (let i = 0; i < node.namedChildCount; i++) {
-        const c = node.namedChild(i);
-        if (c)
-            out.push(c);
-    }
-    return out;
-}
-export function nameOf(node) {
-    const n = node.childForFieldName("name");
-    return n ? n.text : null;
-}
-/**
- * Build a one-line "header" signature: text from the node start up to the
- * start of its body (or the whole node if there is no body), whitespace
- * collapsed. Works uniformly across languages.
- */
-export function headerSignature(node, body) {
-    const src = node.text;
-    const slice = body ? src.slice(0, body.startIndex - node.startIndex) : src;
-    return slice.replace(/\s+/g, " ").trim();
-}
-/** Collect consecutive leading line/block comments immediately above a node. */
-export function leadingComment(node) {
-    const lines = [];
-    let prev = node.previousNamedSibling;
-    while (prev && prev.type === "comment") {
-        lines.unshift(prev.text);
-        prev = prev.previousNamedSibling;
-    }
-    if (lines.length === 0)
-        return null;
-    return lines.join("\n").slice(0, 500);
-}

package/dist/pool.js

@@ -1,114 +0,0 @@
-import os from "node:os";
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { Worker } from "node:worker_threads";
-import { buildSkeleton } from "./skeleton.js";
-import { computeFileComplexity } from "./complexity.js";
-import { diskCacheDir } from "./diskcache.js";
-/** Batches smaller than this are parsed sequentially (worker startup costs more). */
-const MIN_BATCH = 64;
-const MAX_WORKERS = 8;
-function envWorkers() {
-    const env = process.env.AST_MAP_WORKERS;
-    if (env === undefined || env === "")
-        return null;
-    const v = Number.parseInt(env, 10);
-    return Number.isNaN(v) ? null : Math.max(0, Math.min(v, MAX_WORKERS));
-}
-function plannedWorkers(n) {
-    const forced = envWorkers();
-    if (forced !== null)
-        return forced;
-    const cpus = os.cpus().length;
-    return Math.min(Math.max(cpus - 1, 0), MAX_WORKERS, Math.ceil(n / MIN_BATCH));
-}
-async function buildSequential(items, opts, withComplexity, out) {
-    for (let i = 0; i < items.length; i++) {
-        if (out[i] !== undefined)
-            continue; // already produced by a worker
-        try {
-            const skel = await buildSkeleton(items[i].abs, items[i].rel, opts);
-            const complexity = withComplexity
-                ? await computeFileComplexity(items[i].abs, items[i].rel)
-                : undefined;
-            out[i] = { skel, complexity };
-        }
-        catch {
-            out[i] = null; // unparsable / unsupported — callers skip nulls
-        }
-    }
-}
-/**
- * Build skeletons for many files, in parallel when it pays off.
- * Returns one entry per input item (null = failed/unsupported file).
- */
-export async function buildSkeletonsBulk(items, opts, withComplexity = false) {
-    const out = new Array(items.length);
-    const workers = plannedWorkers(items.length);
-    const workerFile = path.join(path.dirname(fileURLToPath(import.meta.url)), "worker.js");
-    // An explicit AST_MAP_WORKERS >= 2 bypasses the batch-size gate.
-    const smallBatch = items.length < MIN_BATCH && envWorkers() === null;
-    if (smallBatch || workers <= 1 || !fs.existsSync(workerFile)) {
-        await buildSequential(items, opts, withComplexity, out);
-        return out;
-    }
-    let failed = false;
-    await new Promise((resolve) => {
-        let next = 0;
-        let done = 0;
-        let open = 0;
-        const pool = [];
-        const finish = () => {
-            for (const w of pool)
-                void w.terminate();
-            resolve();
-        };
-        const dispatch = (w) => {
-            if (failed || next >= items.length) {
-                return;
-            }
-            const id = next++;
-            w.postMessage({ id, abs: items[id].abs, rel: items[id].rel, opts, withComplexity });
-        };
-        for (let i = 0; i < workers; i++) {
-            let w;
-            try {
-                w = new Worker(workerFile, { workerData: { cacheDir: diskCacheDir() } });
-            }
-            catch {
-                failed = true;
-                break;
-            }
-            open++;
-            pool.push(w);
-            w.on("message", (msg) => {
-                out[msg.id] = msg.ok && msg.skel ? { skel: msg.skel, complexity: msg.complexity } : null;
-                done++;
-                if (done >= items.length || failed)
-                    finish();
-                else
-                    dispatch(w);
-            });
-            w.on("error", () => {
-                failed = true;
-                finish();
-            });
-            dispatch(w);
-            // prime a second task per worker to hide round-trip latency
-            dispatch(w);
-        }
-        if (pool.length === 0)
-            resolve();
-        else if (open === 0)
-            resolve();
-    });
-    // Fill any gaps (worker failure, early termination) sequentially.
-    for (let i = 0; i < items.length; i++) {
-        if (out[i] === undefined) {
-            await buildSequential(items, opts, withComplexity, out);
-            break;
-        }
-    }
-    return out;
-}

package/dist/prompts.js

@@ -1,67 +0,0 @@
-import { z } from "zod";
-/** GetPromptResult helper — a single user-role text message. */
-function userPrompt(text) {
-    return { messages: [{ role: "user", content: { type: "text", text } }] };
-}
-const dirArg = { dir: z.string().optional().describe("Directory to analyze, relative to the project root. Default 'src'.") };
-const d = (dir) => (dir && dir.trim() ? dir.trim() : "src");
-/**
- * Register the Cookbook recipes as MCP prompts so clients can invoke a whole
- * AST-MCP workflow (a chain of tool calls) by name, instead of the user pasting
- * the recipe text. Each prompt returns a ready-to-run instruction that references
- * the server's own tools.
- */
-export function registerPrompts(server) {
-    server.registerPrompt("architecture_audit", {
-        title: "Architecture audit",
-        description: "Full structural audit of a directory: God Nodes, cycles, rule violations, and module coupling.",
-        argsSchema: dirArg,
-    }, ({ dir }) => userPrompt(`Run a full architecture audit of \`${d(dir)}\` using the ast-mapper tools, in this order:\n\n` +
-        `1. \`build_symbol_graph\` on \`${d(dir)}\` to load the dependency graph.\n` +
-        `2. \`get_top_symbols\` — identify the 5 most-imported symbols (the "God Nodes").\n` +
-        `3. \`find_circular_deps\` — report any circular import chains.\n` +
-        `4. \`validate_architecture\` — list structural rule violations (large files, too many imports, god exports).\n` +
-        `5. \`get_module_coupling\` — which directories are load-bearing (high Ca) vs. volatile (high I)?\n` +
-        `6. \`get_layer_violations\` — any stable code depending on volatile code (SDP breaks)?\n\n` +
-        `Then write a short prioritized summary: the top 3 architectural risks and a concrete first step for each.`));
-    server.registerPrompt("safe_refactor", {
-        title: "Safe refactor checklist",
-        description: "Everything you need to know before changing a specific symbol: blast radius, callees, and minimal context.",
-        argsSchema: {
-            file: z.string().describe("File containing the symbol, relative to the project root."),
-            symbol: z.string().describe("Name of the function/class/symbol you intend to change."),
-        },
-    }, ({ file, symbol }) => userPrompt(`Before refactoring \`${symbol}\` in \`${file}\`, gather the impact using the ast-mapper tools:\n\n` +
-        `1. \`get_change_impact\` for \`${file}\` / \`${symbol}\` — who depends on it (the blast radius)?\n` +
-        `2. \`get_call_graph\` — what does \`${symbol}\` call, and what calls it?\n` +
-        `3. \`pack_context\` for \`${file}\` / \`${symbol}\` — the minimal context (its source + the signatures it depends on).\n\n` +
-        `Then summarize: what will break if the signature changes, which call sites need updating, and a safe step-by-step refactor order.`));
-    server.registerPrompt("dead_code_cleanup", {
-        title: "Dead-code cleanup",
-        description: "Find unused exports and verify each is safe to delete before removing it.",
-        argsSchema: dirArg,
-    }, ({ dir }) => userPrompt(`Help me remove dead code from \`${d(dir)}\` using the ast-mapper tools:\n\n` +
-        `1. \`find_dead_code\` on \`${d(dir)}\` — list exported symbols nobody imports.\n` +
-        `2. For each HIGH-confidence result, double-check with \`get_change_impact\` (should be empty).\n` +
-        `3. Before suggesting deletion, show the symbol's source with \`get_symbol_context\`.\n\n` +
-        `Produce a deletion checklist: only symbols that are high-confidence AND have zero impact. Flag anything dynamic (string-referenced, re-exported) as "verify manually".`));
-    server.registerPrompt("health_check", {
-        title: "Codebase health check",
-        description: "A one-pass health report: overall grade, riskiest files, and stability inversions.",
-        argsSchema: dirArg,
-    }, ({ dir }) => userPrompt(`Give me a health check of \`${d(dir)}\` using the ast-mapper tools:\n\n` +
-        `1. \`get_codebase_report\` on \`${d(dir)}\` — overall grade A–F, hotspots, god nodes, dead code, cycles.\n` +
-        `2. \`get_risk_map\` — the files with the highest churn × complexity (best refactor / test targets).\n` +
-        `3. \`get_layer_violations\` — stable files depending on volatile ones.\n\n` +
-        `Summarize as: the grade, the single biggest problem, and the 3 files I should touch first to improve it.`));
-    server.registerPrompt("onboard_codebase", {
-        title: "Onboard to a codebase",
-        description: "Get oriented in an unfamiliar directory: languages, structure, the core symbols, and how modules connect.",
-        argsSchema: dirArg,
-    }, ({ dir }) => userPrompt(`I'm new to this codebase. Walk me through \`${d(dir)}\` using the ast-mapper tools:\n\n` +
-        `1. \`list_supported_languages\` then \`generate_skeleton\` on \`${d(dir)}\` — what languages and overall shape?\n` +
-        `2. \`get_top_symbols\` — the most-depended-on symbols are the concepts to learn first.\n` +
-        `3. \`get_module_coupling\` — how do the directories relate; what's the stable core?\n` +
-        `4. For the top God Node, \`get_symbol_context\` with related symbols to see how it's used.\n\n` +
-        `Then write a 5-bullet "start here" orientation: what this code does, its core abstractions, and where to begin reading.`));
-}

package/dist/registry.js

@@ -1,87 +0,0 @@
-import path from "node:path";
-import { extractTypeScript, extractDirectivesTS, extractImportsTS } from "./extractors/typescript.js";
-import { extractPython, extractImportsPython } from "./extractors/python.js";
-import { extractGo, extractImportsGo } from "./extractors/go.js";
-import { extractRust, extractImportsRust } from "./extractors/rust.js";
-import { extractJava, extractDirectivesJava, extractImportsJava } from "./extractors/java.js";
-import { extractCSharp, extractDirectivesCSharp, extractImportsCSharp } from "./extractors/csharp.js";
-import { extractC, extractImportsC } from "./extractors/c.js";
-import { extractCpp, extractImportsCpp } from "./extractors/cpp.js";
-import { extractKotlin, extractDirectivesKotlin, extractImportsKotlin } from "./extractors/kotlin.js";
-import { extractSwift, extractImportsSwift } from "./extractors/swift.js";
-import { extractPhp, extractImportsPhp } from "./extractors/php.js";
-import { extractRuby, extractImportsRuby } from "./extractors/ruby.js";
-const TS_ENTRY = (language, grammar) => ({
-    language,
-    grammar,
-    extract: extractTypeScript,
-    extractDirectives: extractDirectivesTS,
-    extractImports: extractImportsTS,
-});
-const SFC_ENTRY = (language) => ({
-    language,
-    grammar: "typescript", // overridden per-file after detecting lang="ts" vs js
-    extract: extractTypeScript,
-    extractDirectives: extractDirectivesTS,
-    extractImports: extractImportsTS,
-    sfc: true,
-});
-const BY_EXT = {
-    ".ts": TS_ENTRY("typescript", "typescript"),
-    ".mts": TS_ENTRY("typescript", "typescript"),
-    ".cts": TS_ENTRY("typescript", "typescript"),
-    ".tsx": TS_ENTRY("tsx", "tsx"),
-    ".js": TS_ENTRY("javascript", "javascript"),
-    ".mjs": TS_ENTRY("javascript", "javascript"),
-    ".cjs": TS_ENTRY("javascript", "javascript"),
-    ".jsx": TS_ENTRY("javascript", "tsx"),
-    ".py": { language: "python", grammar: "python", extract: extractPython, extractImports: extractImportsPython },
-    ".pyi": { language: "python", grammar: "python", extract: extractPython, extractImports: extractImportsPython },
-    ".go": { language: "go", grammar: "go", extract: extractGo, extractImports: extractImportsGo },
-    ".rs": { language: "rust", grammar: "rust", extract: extractRust, extractImports: extractImportsRust },
-    ".java": {
-        language: "java", grammar: "java",
-        extract: extractJava, extractDirectives: extractDirectivesJava, extractImports: extractImportsJava,
-    },
-    ".cs": {
-        language: "csharp", grammar: "c_sharp",
-        extract: extractCSharp, extractDirectives: extractDirectivesCSharp, extractImports: extractImportsCSharp,
-    },
-    ".c": { language: "c", grammar: "c", extract: extractC, extractImports: extractImportsC },
-    ".h": { language: "c", grammar: "c", extract: extractC, extractImports: extractImportsC },
-    ".cpp": { language: "cpp", grammar: "cpp", extract: extractCpp, extractImports: extractImportsCpp },
-    ".cxx": { language: "cpp", grammar: "cpp", extract: extractCpp, extractImports: extractImportsCpp },
-    ".cc": { language: "cpp", grammar: "cpp", extract: extractCpp, extractImports: extractImportsCpp },
-    ".hpp": { language: "cpp", grammar: "cpp", extract: extractCpp, extractImports: extractImportsCpp },
-    ".hxx": { language: "cpp", grammar: "cpp", extract: extractCpp, extractImports: extractImportsCpp },
-    ".hh": { language: "cpp", grammar: "cpp", extract: extractCpp, extractImports: extractImportsCpp },
-    ".kt": {
-        language: "kotlin", grammar: "kotlin",
-        extract: extractKotlin, extractDirectives: extractDirectivesKotlin, extractImports: extractImportsKotlin,
-    },
-    ".kts": {
-        language: "kotlin", grammar: "kotlin",
-        extract: extractKotlin, extractDirectives: extractDirectivesKotlin, extractImports: extractImportsKotlin,
-    },
-    ".swift": { language: "swift", grammar: "swift", extract: extractSwift, extractImports: extractImportsSwift },
-    ".php": { language: "php", grammar: "php", extract: extractPhp, extractImports: extractImportsPhp },
-    ".rb": { language: "ruby", grammar: "ruby", extract: extractRuby, extractImports: extractImportsRuby },
-    ".rake": { language: "ruby", grammar: "ruby", extract: extractRuby, extractImports: extractImportsRuby },
-    ".vue": SFC_ENTRY("vue"),
-    ".svelte": SFC_ENTRY("svelte"),
-};
-export function detectLanguage(filePath) {
-    return BY_EXT[path.extname(filePath).toLowerCase()] ?? null;
-}
-export function supportedExtensions() {
-    return Object.keys(BY_EXT);
-}
-export function supportedLanguages() {
-    const map = new Map();
-    for (const [ext, entry] of Object.entries(BY_EXT)) {
-        const arr = map.get(entry.language) ?? [];
-        arr.push(ext);
-        map.set(entry.language, arr);
-    }
-    return [...map.entries()].map(([language, extensions]) => ({ language, extensions }));
-}

package/dist/report.js

@@ -1,187 +0,0 @@
-import path from "node:path";
-import { collectSourceFiles } from "./skeleton.js";
-import { buildSkeletonsBulk } from "./pool.js";
-import { resolveOptions } from "./config.js";
-import { buildSymbolGraph } from "./graph.js";
-import { findDeadExports, findCircularDeps, getTopSymbols } from "./graph-analysis.js";
-import { findLayerViolations } from "./layers.js";
-import { computeModuleCoupling } from "./modulecoupling.js";
-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";
-}
-export async function buildReport(absDir, root) {
-    const opts = resolveOptions({ detail: "outline", emitHtml: false });
-    const files = collectSourceFiles(absDir, opts);
-    const skeletons = [];
-    const langCount = new Map();
-    let symbolCount = 0;
-    const hotspots = [];
-    let cxSum = 0, cxN = 0, cxMax = 0;
-    const items = files.map((file) => ({
-        abs: file,
-        rel: path.relative(root, file).split(path.sep).join("/"),
-    }));
-    const built = await buildSkeletonsBulk(items, opts, true);
-    for (let i = 0; i < built.length; i++) {
-        const r = built[i];
-        if (!r)
-            continue; // skip unparsable
-        const rel = items[i].rel;
-        skeletons.push(r.skel);
-        symbolCount += r.skel.symbolCount;
-        langCount.set(r.skel.language, (langCount.get(r.skel.language) ?? 0) + 1);
-        if (r.complexity) {
-            for (const f of r.complexity.functions) {
-                hotspots.push({ ...f, file: rel });
-                cxSum += f.complexity;
-                cxN++;
-                cxMax = Math.max(cxMax, f.complexity);
-            }
-        }
-    }
-    const graph = buildSymbolGraph(skeletons, root);
-    const dead = findDeadExports(graph).filter((d) => d.confidence === "high");
-    const cycles = findCircularDeps(graph);
-    const god = getTopSymbols(graph, 8);
-    const layerViolations = findLayerViolations(graph);
-    const modules = computeModuleCoupling(graph).modules;
-    hotspots.sort((a, b) => b.complexity - a.complexity);
-    const veryHigh = hotspots.filter((f) => f.complexity > 20).length;
-    const high = hotspots.filter((f) => f.complexity > 10 && f.complexity <= 20).length;
-    // Health score: start at 100, subtract weighted penalties.
-    let score = 100;
-    score -= Math.min(20, dead.length * 1.5);
-    score -= Math.min(22, cycles.length * 6);
-    score -= Math.min(28, veryHigh * 4 + high * 1);
-    score -= Math.min(12, god.filter((g) => g.importCount >= 8).length * 4);
-    score -= Math.min(10, layerViolations.length);
-    score = Math.max(0, Math.round(score));
-    const languages = [...langCount.entries()]
-        .map(([lang, f]) => ({ lang, files: f }))
-        .sort((a, b) => b.files - a.files);
-    return {
-        project: absDir.split(/[\\/]/).filter(Boolean).pop() || "project",
-        generatedAt: new Date().toISOString(),
-        fileCount: skeletons.length,
-        symbolCount,
-        edgeCount: graph.edges.filter((e) => e.edgeType === "imports").length,
-        languages,
-        score,
-        grade: gradeFor(score),
-        dead: { count: dead.length, items: dead.slice(0, 25).map((d) => ({ file: d.file, symbol: d.symbol, kind: d.kind })) },
-        cycles: { count: cycles.length, items: cycles.slice(0, 12).map((c) => c.cycle) },
-        godNodes: god.map((g) => ({ symbol: g.symbol, file: g.file, importCount: g.importCount })),
-        complexity: { average: cxN ? Math.round((cxSum / cxN) * 10) / 10 : 0, max: cxMax, hotspots: hotspots.slice(0, 12) },
-        layerViolations: { count: layerViolations.length, items: layerViolations.slice(0, 12) },
-        modules: modules.slice(0, 10),
-    };
-}
-/* ─── Premium HTML dashboard ───────────────────────────────────────────────── */
-const GRADE_COLOR = {
-    A: "#1d9e75", B: "#1d9e75", C: "#ba7517", D: "#d85a30", F: "#e24b4a",
-};
-function esc(s) {
-    return String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function ratingColor(r) {
-    return r === "very-high" ? "#e24b4a" : r === "high" ? "#d85a30" : r === "moderate" ? "#ba7517" : "#1d9e75";
-}
-function instColor(i) {
-    return i >= 0.8 ? "#e24b4a" : i <= 0.2 ? "#1d9e75" : "#ba7517";
-}
-function statCard(label, value, accent) {
-    return `<div class="stat"><div class="sv"${accent ? ` style="color:${accent}"` : ""}>${value}</div><div class="sl">${label}</div></div>`;
-}
-function bar(label, value, max, color, right) {
-    const pct = max > 0 ? Math.round((value / max) * 100) : 0;
-    return `<div class="row"><div class="rl">${esc(label)}</div><div class="track"><div class="fill" style="width:${pct}%;background:${color}"></div></div><div class="rr">${right}</div></div>`;
-}
-export function buildReportHtml(d) {
-    const gc = GRADE_COLOR[d.grade] ?? "#888";
-    const maxLang = d.languages[0]?.files ?? 1;
-    const langs = d.languages.map((l) => bar(l.lang, l.files, maxLang, "#534ab7", `${l.files}`)).join("");
-    const maxCx = d.complexity.hotspots[0]?.complexity ?? 1;
-    const hotspots = d.complexity.hotspots.length
-        ? d.complexity.hotspots.map((h) => bar(`${h.name}  ·  ${h.file}`, h.complexity, maxCx, ratingColor(h.rating), `<b>${h.complexity}</b>`)).join("")
-        : `<div class="empty">No functions found.</div>`;
-    const god = d.godNodes.length
-        ? d.godNodes.map((g) => `<div class="li"><span class="mono">${esc(g.symbol)}</span><span class="dim">${esc(g.file)}</span><span class="pill">${g.importCount} importers</span></div>`).join("")
-        : `<div class="empty">None.</div>`;
-    const dead = d.dead.count
-        ? d.dead.items.map((x) => `<div class="li"><span class="kbadge">${esc(x.kind)}</span><span class="mono">${esc(x.symbol)}</span><span class="dim">${esc(x.file)}</span></div>`).join("")
-            + (d.dead.count > d.dead.items.length ? `<div class="more">+${d.dead.count - d.dead.items.length} more…</div>` : "")
-        : `<div class="ok">✓ No high-confidence dead exports</div>`;
-    const cycles = d.cycles.count
-        ? d.cycles.items.map((c) => `<div class="li"><span class="mono">${esc(c.join("  →  "))}</span></div>`).join("")
-        : `<div class="ok">✓ No circular dependencies</div>`;
-    const modules = d.modules.length
-        ? d.modules.map((m) => bar(`${m.module}  ·  ${m.files} file(s)`, m.instability, 1, instColor(m.instability), `Ca ${m.afferent} · Ce ${m.efferent} · <b>I ${m.instability.toFixed(2)}</b>`)).join("")
-        : `<div class="empty">No cross-module imports.</div>`;
-    const sdp = d.layerViolations.count
-        ? d.layerViolations.items.map((v) => `<div class="li"><span class="mono">${esc(v.from)}</span><span class="dim">→ ${esc(v.to)}</span><span class="pill" style="color:${instColor(0.9)}">+${v.severity.toFixed(2)}</span></div>`).join("")
-            + (d.layerViolations.count > d.layerViolations.items.length ? `<div class="more">+${d.layerViolations.count - d.layerViolations.items.length} more…</div>` : "")
-        : `<div class="ok">✓ No stability inversions (SDP)</div>`;
-    return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
-<title>${esc(d.project)} — code health</title><style>
-:root{--bg:#fafaf8;--card:#fff;--bd:#e7e5df;--tx:#2b2b28;--dim:#8a8880;--soft:#f1efe9}
-@media(prefers-color-scheme:dark){:root{--bg:#161613;--card:#1e1e1b;--bd:#33332e;--tx:#e6e4dd;--dim:#9a988f;--soft:#26261f}}
-*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--tx);font-family:system-ui,-apple-system,sans-serif;line-height:1.5}
-.wrap{max-width:980px;margin:0 auto;padding:32px 24px 60px}
-.hero{display:flex;align-items:center;gap:24px;margin-bottom:28px}
-.badge{width:104px;height:104px;border-radius:24px;display:flex;flex-direction:column;align-items:center;justify-content:center;color:#fff;flex:0 0 auto}
-.badge .g{font-size:46px;font-weight:700;line-height:1}.badge .s{font-size:12px;opacity:.9}
-.h1{font-size:26px;font-weight:650;margin:0}.sub{color:var(--dim);font-size:13px;margin-top:4px}
-.grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(110px,1fr));gap:12px;margin-bottom:30px}
-.stat{background:var(--card);border:1px solid var(--bd);border-radius:14px;padding:14px 16px}
-.sv{font-size:24px;font-weight:650}.sl{font-size:12px;color:var(--dim);margin-top:2px}
-.card{background:var(--card);border:1px solid var(--bd);border-radius:16px;padding:18px 20px;margin-bottom:18px}
-.card h2{font-size:14px;font-weight:600;margin:0 0 14px;letter-spacing:.02em;text-transform:uppercase;color:var(--dim)}
-.row{display:flex;align-items:center;gap:12px;margin:7px 0;font-size:13px}
-.rl{flex:0 0 46%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.track{flex:1;height:8px;background:var(--soft);border-radius:5px;overflow:hidden}.fill{height:100%;border-radius:5px}
-.rr{flex:0 0 auto;color:var(--dim);min-width:32px;text-align:right}
-.li{display:flex;align-items:center;gap:10px;padding:5px 0;font-size:13px;border-top:1px solid var(--bd)}.li:first-child{border-top:none}
-.mono{font-family:ui-monospace,monospace;font-weight:550}.dim{color:var(--dim);font-size:12px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
-.pill{margin-left:auto;background:var(--soft);border-radius:20px;padding:2px 10px;font-size:11px;color:var(--dim);flex:0 0 auto}
-.kbadge{font-size:11px;color:var(--dim);background:var(--soft);border-radius:5px;padding:1px 7px;flex:0 0 auto}
-.ok{color:#1d9e75;font-size:13px}.empty{color:var(--dim);font-size:13px}.more{color:var(--dim);font-size:12px;padding-top:6px}
-.two{display:grid;grid-template-columns:1fr 1fr;gap:18px}@media(max-width:720px){.two{grid-template-columns:1fr}.rl{flex-basis:42%}}
-.foot{color:var(--dim);font-size:11px;text-align:center;margin-top:24px}
-</style></head><body><div class="wrap">
-<div class="hero">
-  <div class="badge" style="background:${gc}"><div class="g">${d.grade}</div><div class="s">${d.score}/100</div></div>
-  <div><h1 class="h1">${esc(d.project)} — code health</h1>
-  <div class="sub">${d.fileCount} files · ${d.symbolCount} symbols · ${d.languages.length} language(s) · ${esc(d.generatedAt.slice(0, 10))}</div></div>
-</div>
-<div class="grid">
-  ${statCard("Files", d.fileCount)}
-  ${statCard("Symbols", d.symbolCount)}
-  ${statCard("Import edges", d.edgeCount)}
-  ${statCard("Avg complexity", d.complexity.average)}
-  ${statCard("Max complexity", d.complexity.max, ratingColor(d.complexity.max > 20 ? "very-high" : d.complexity.max > 10 ? "high" : "low"))}
-  ${statCard("Dead exports", d.dead.count, d.dead.count ? "#d85a30" : "#1d9e75")}
-  ${statCard("Cycles", d.cycles.count, d.cycles.count ? "#e24b4a" : "#1d9e75")}
-  ${statCard("SDP violations", d.layerViolations.count, d.layerViolations.count ? "#d85a30" : "#1d9e75")}
-</div>
-<div class="card"><h2>Language breakdown</h2>${langs}</div>
-<div class="card"><h2>Complexity hotspots</h2>${hotspots}</div>
-<div class="two">
-  <div class="card"><h2>God nodes (most imported)</h2>${god}</div>
-  <div class="card"><h2>Circular dependencies</h2>${cycles}</div>
-</div>
-<div class="two">
-  <div class="card"><h2>Module coupling (instability)</h2>${modules}</div>
-  <div class="card"><h2>Layer violations (stable → volatile)</h2>${sdp}</div>
-</div>
-<div class="card"><h2>Dead exports (high confidence)</h2>${dead}</div>
-<div class="foot">Generated by AST-MCP · universal-ast-mapper</div>
-</div></body></html>`;
-}