universal-ast-mapper 1.27.0 → 1.28.0

package/CHANGELOG.md

@@ -6,6 +6,23 @@ since 1.0.0, guarantees a stable MCP tool / CLI surface across the 1.x line.
 
 ---
 
+## [1.28.0] — 2026-06-11 · Test coverage in the dashboard
+- The health dashboard (`ast-map report` / `get_codebase_report`) now surfaces
+  v1.27's structural test coverage:
+  - **Test coverage card** — coverage bar (tested/total sources, % colored
+    green ≥ 70 / amber ≥ 40 / red below) + the **untested sources ranked by
+    risk** (fan-in Ca, then symbol count), capped at 12 with a "+N more" note.
+  - **Test coverage stat tile** in the header grid.
+- **Root fallback** — reporting on `src/` only (no test files in the scanned
+  dir)? Test files are pulled in from the project root automatically and the
+  card notes "(from project root)".
+- **Health score** now includes a structural-coverage penalty (capped at 8
+  points, proportional to the untested share).
+- `ReportData` gains `testCoverage` (testFiles, sourceFiles, testedSources,
+  coverageRatio, untestedCount, untested[], rootFallback) — additive.
+- CLI `ast-map report` summary line now shows `tests N%`.
+- Tests: +6 checks in `test/analysis.mjs` (159 total).
+
 ## [1.27.0] — 2026-06-11 · Test-coverage mapping
 - **New MCP tool `get_test_coverage`** + **CLI `ast-map tests [dir]`** (alias
   `coverage`) — structural test coverage with zero instrumentation: which source

package/README.md

@@ -4,7 +4,7 @@ An **MCP server + CLI tool** that turns source code into structured, machine-rea
 
 Built on [tree-sitter](https://tree-sitter.github.io/) WASM grammars. Zero regex guessing — real AST parsing.
 
-**30 MCP tools / 32 CLI commands / 5 MCP prompts** spanning skeletons, dependency graphs, and deep analysis — dead code, cycles, change-impact, complexity, duplicates, unused params, type-flow, decorators, test-coverage mapping — plus monorepo support, an interactive **graph explorer** with a **coupling overlay** (`ast-map explore`), **watch mode**, a one-page **health dashboard** (`ast-map report`), a **persistent parse cache + parallel parsing** (warm re-scans skip parsing entirely), and a **CI quality gate** (`ast-map check`, baseline ratchet).
+**30 MCP tools / 32 CLI commands / 5 MCP prompts** spanning skeletons, dependency graphs, and deep analysis — dead code, cycles, change-impact, complexity, duplicates, unused params, type-flow, decorators, test-coverage mapping — plus monorepo support, an interactive **graph explorer** with a **coupling overlay** (`ast-map explore`), **watch mode**, a one-page **health dashboard** with test-coverage, coupling and SDP cards (`ast-map report`), a **persistent parse cache + parallel parsing** (warm re-scans skip parsing entirely), and a **CI quality gate** (`ast-map check`, baseline ratchet).
 
 **Supported languages:** TypeScript · TSX · JavaScript (ESM/CJS) · Python · Go · Rust · Java · C# · C · C++ · Kotlin · Swift · Vue · Svelte (SFC `<script>`) · **PHP** · **Ruby**
 
@@ -835,6 +835,7 @@ Not part of the public API: the internal `src/` module layout and the generated
 
 | Version | What changed |
 |---------|--------------|
+| **1.28.0** | **Test coverage in the dashboard** — `ast-map report` / `get_codebase_report` gain a **Test coverage** card (coverage bar + untested sources ranked by risk with Ca/symbols) and stat tile; structural coverage now factors into the health score (capped penalty). Reporting on `src/` only? Test files are **pulled in from the project root automatically**. |
 | **1.27.0** | **Test-coverage mapping** — new MCP tool `get_test_coverage` + CLI `ast-map tests` (alias `coverage`): pairs test files with the sources they exercise (import edges + naming conventions) and lists **untested sources ranked by risk** (fan-in, then symbols). Fixture dirs excluded; orphan tests reported. File-level, zero instrumentation. (**30 tools / 32 commands**) |
 | **1.26.0** | **Coupling overlay in the explorer** — `ast-map explore` gains a `color: coupling` mode: nodes shaded by **instability** I = Ce/(Ca+Ce) on a green (stable) → red (volatile) scale, with a legend, and Ca / Ce / I readouts in the hover tooltip and detail sidebar. Spot load-bearing files and volatile hotspots at a glance. |
 | **1.25.0** | **Semantic symbol search** — new MCP tool `semantic_search` + CLI `ast-map find <query>`: find symbols by *meaning* ("remove expired sessions" → `clearDiskCache`). Identifier tokenization + 60-group programming thesaurus + stemming + fuzzy matching + BM25-style IDF ranking over names, docs, signatures and paths. No embeddings, no network. (**29 tools / 31 commands**) |

package/dist/cli.js

@@ -675,7 +675,7 @@ program
     fs.writeFileSync(out, buildReportHtml(data), "utf8");
     header(`Code Health \u2014 ${rel}/  ${dim(`(${data.fileCount} files)`)}`);
     const gcolor = data.grade === "A" || data.grade === "B" ? green : data.grade === "C" || data.grade === "D" ? yellow : (x) => x;
-    console.log(indent(`Grade ${bold(gcolor(data.grade))}  ${dim("(" + data.score + "/100)")}  ·  ${data.dead.count} dead · ${data.cycles.count} cycles · max cx ${data.complexity.max}`));
+    console.log(indent(`Grade ${bold(gcolor(data.grade))}  ${dim("(" + data.score + "/100)")}  ·  ${data.dead.count} dead · ${data.cycles.count} cycles · max cx ${data.complexity.max} · tests ${Math.round(data.testCoverage.coverageRatio * 100)}%`));
     console.log(indent(green("✓ wrote " + path.relative(process.cwd(), out))));
     console.log();
 });

package/dist/index.js

@@ -794,7 +794,8 @@ server.registerTool("get_codebase_report", {
     title: "Codebase health report",
     description: "Scan a directory and return a one-shot health summary: file/symbol counts, language " +
         "breakdown, a health grade (A\u2013F) and score, complexity hotspots, god nodes (most-imported " +
-        "symbols), dead exports, and circular dependencies. The `ast-map report` CLI renders this as HTML.",
+        "symbols), dead exports, circular dependencies, module coupling, SDP violations, and structural " +
+        "test coverage (untested sources ranked by risk). The `ast-map report` CLI renders this as HTML.",
     inputSchema: {
         path: z.string().optional().describe("Directory to scan. Defaults to the project root."),
     },

package/dist/report.js

@@ -6,6 +6,7 @@ import { buildSymbolGraph } from "./graph.js";
 import { findDeadExports, findCircularDeps, getTopSymbols } from "./graph-analysis.js";
 import { findLayerViolations } from "./layers.js";
 import { computeModuleCoupling } from "./modulecoupling.js";
+import { mapTestCoverage, isTestFile, isFixtureFile } from "./testmap.js";
 function gradeFor(score) {
     if (score >= 90)
         return "A";
@@ -53,6 +54,27 @@ export async function buildReport(absDir, root) {
     const god = getTopSymbols(graph, 8);
     const layerViolations = findLayerViolations(graph);
     const modules = computeModuleCoupling(graph).modules;
+    // Test coverage. If the scanned dir has no test files (common when reporting
+    // on src/ only), pull test files in from the project root so the map can
+    // still pair them with the scanned sources.
+    let covGraph = graph;
+    let rootFallback = false;
+    if (!skeletons.some((s) => isTestFile(s.file)) && path.resolve(absDir) !== path.resolve(root)) {
+        const have = new Set(items.map((i) => i.abs));
+        const testItems = collectSourceFiles(root, opts)
+            .filter((f) => !have.has(f))
+            .map((f) => ({ abs: f, rel: path.relative(root, f).split(path.sep).join("/") }))
+            .filter((i) => isTestFile(i.rel) && !isFixtureFile(i.rel));
+        if (testItems.length > 0) {
+            const builtTests = await buildSkeletonsBulk(testItems, opts);
+            const testSkels = builtTests.filter((r) => r !== null).map((r) => r.skel);
+            if (testSkels.length > 0) {
+                covGraph = buildSymbolGraph([...skeletons, ...testSkels], root);
+                rootFallback = true;
+            }
+        }
+    }
+    const cov = mapTestCoverage(covGraph);
     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;
@@ -63,6 +85,7 @@ export async function buildReport(absDir, root) {
     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.min(8, Math.round((1 - cov.coverageRatio) * 8)); // structural test coverage
     score = Math.max(0, Math.round(score));
     const languages = [...langCount.entries()]
         .map(([lang, f]) => ({ lang, files: f }))
@@ -82,6 +105,15 @@ export async function buildReport(absDir, root) {
         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),
+        testCoverage: {
+            testFiles: cov.testFiles,
+            sourceFiles: cov.sourceFiles,
+            testedSources: cov.testedSources,
+            coverageRatio: cov.coverageRatio,
+            untestedCount: cov.untestedSources,
+            untested: cov.untested.slice(0, 12),
+            rootFallback,
+        },
     };
 }
 /* ─── Premium HTML dashboard ───────────────────────────────────────────────── */
@@ -125,6 +157,17 @@ export function buildReportHtml(d) {
     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 covPct = Math.round(d.testCoverage.coverageRatio * 100);
+    const covC = d.testCoverage.coverageRatio >= 0.7 ? "#1d9e75" : d.testCoverage.coverageRatio >= 0.4 ? "#ba7517" : "#e24b4a";
+    const covHead = d.testCoverage.testFiles > 0
+        ? bar(`${d.testCoverage.testedSources}/${d.testCoverage.sourceFiles} sources tested · ${d.testCoverage.testFiles} test file(s)${d.testCoverage.rootFallback ? " (from project root)" : ""}`, covPct, 100, covC, `<b>${covPct}%</b>`)
+        : "";
+    const covList = d.testCoverage.testFiles === 0
+        ? `<div class="empty">No test files found in the scanned directory or project root.</div>`
+        : d.testCoverage.untested.length === 0
+            ? `<div class="ok">✓ Every source file has at least one test</div>`
+            : d.testCoverage.untested.map((u) => `<div class="li"><span class="mono">${esc(u.file)}</span><span class="dim">${u.symbols} symbol(s)</span><span class="pill">Ca ${u.afferent}</span></div>`).join("")
+                + (d.testCoverage.untestedCount > d.testCoverage.untested.length ? `<div class="more">+${d.testCoverage.untestedCount - d.testCoverage.untested.length} more…</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>` : "")
@@ -170,6 +213,7 @@ export function buildReportHtml(d) {
   ${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")}
+  ${statCard("Test coverage", covPct + "%", covC)}
 </div>
 <div class="card"><h2>Language breakdown</h2>${langs}</div>
 <div class="card"><h2>Complexity hotspots</h2>${hotspots}</div>
@@ -181,6 +225,7 @@ export function buildReportHtml(d) {
   <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>Test coverage (untested by risk)</h2>${covHead}${covList}</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>`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-ast-mapper",
-  "version": "1.27.0",
+  "version": "1.28.0",
   "description": "MCP server that maps source files into a normalized code skeleton (JSON + HTML) using tree-sitter.",
   "type": "module",
   "main": "dist/index.js",