universal-ast-mapper 1.18.0 → 1.19.0

package/CHANGELOG.md

@@ -6,6 +6,17 @@ since 1.0.0, guarantees a stable MCP tool / CLI surface across the 1.x line.
 
 ---
 
+## [1.19.0] — 2026-06-09 · Dashboard: coupling + SDP
+- The health dashboard (`ast-map report` / `get_codebase_report`) now surfaces the
+  v1.14–1.16 architecture metrics: a **Module coupling** card (per-directory instability
+  bars with Ca/Ce) and a **Layer violations** card (stable→volatile SDP inversions),
+  plus an **SDP violations** stat tile.
+- SDP violations now factor into the health score (small capped penalty), so a codebase
+  that systematically depends "uphill" on the stability gradient scores lower.
+- `ReportData` gains `layerViolations` and `modules`; purely additive.
+- Tests: 4 new assertions (131 total) — report carries the new data and the HTML renders
+  both cards.
+
 ## [1.18.0] — 2026-06-09 · Vue & Svelte SFC support
 - `.vue` and `.svelte` **single-file components** are now first-class inputs. The
   `<script>` / `<script setup>` block is lifted out and parsed with the TS/JS extractor

package/README.md

@@ -368,7 +368,7 @@ Given a compiled JS/CSS file with an inline (`data:`) or external `sourceMapping
 ---
 
 ### `get_codebase_report`
-A one-shot **codebase health summary**: file/symbol counts, language breakdown, a health **grade (A–F)** + score, complexity hotspots, god nodes, dead exports, and circular dependencies. Rendered as a premium HTML dashboard by `ast-map report`.
+A one-shot **codebase health summary**: file/symbol counts, language breakdown, a health **grade (A–F)** + score, complexity hotspots, god nodes, dead exports, circular dependencies, **module coupling** (per-directory instability), and **layer violations** (SDP). Rendered as a premium HTML dashboard by `ast-map report`.
 
 ```json
 { "grade": "B", "score": 82, "fileCount": 120, "symbolCount": 1400,
@@ -740,6 +740,7 @@ Not part of the public API: the internal `src/` module layout and the generated
 
 | Version | What changed |
 |---------|--------------|
+| **1.19.0** | **Dashboard: coupling + SDP** — `ast-map report` / `get_codebase_report` now include **module coupling** (per-directory instability bars) and **layer violations** (stable→volatile, SDP) cards, plus an SDP stat; SDP inversions also factor into the health score. The v1.14–1.16 metrics are now visual. |
 | **1.18.0** | **Vue & Svelte SFC support** — `.vue` and `.svelte` single-file components are now parsed: the `<script>` / `<script setup>` block is lifted out (TS or JS) and its symbols + imports extracted, with cross-file graph edges into plain modules. Blank-padding keeps every symbol's line numbers pointing at the original SFC. **14 languages**. |
 | **1.17.0** | **MCP prompts** — the server now registers 5 parameterized **prompts** (`architecture_audit`, `safe_refactor`, `dead_code_cleanup`, `health_check`, `onboard_codebase`): named workflows a client can invoke from its prompt menu, each chaining the right tools. The Cookbook recipes, one call away. |
 | **1.16.0** | **Module coupling** — new `get_module_coupling` MCP tool + `ast-map modules` (alias `mods`) CLI: aggregates the import graph to the **directory/module level** — per-module Ca / Ce / instability plus weighted inter-module edges (intra-module imports ignored). The bird's-eye view above per-file coupling. **27 MCP tools**. |

package/dist/report.js

@@ -4,6 +4,8 @@ import { resolveOptions } from "./config.js";
 import { buildSymbolGraph } from "./graph.js";
 import { findDeadExports, findCircularDeps, getTopSymbols } from "./graph-analysis.js";
 import { computeFileComplexity } from "./complexity.js";
+import { findLayerViolations } from "./layers.js";
+import { computeModuleCoupling } from "./modulecoupling.js";
 function gradeFor(score) {
     if (score >= 90)
         return "A";
@@ -46,6 +48,8 @@ export async function buildReport(absDir, 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;
@@ -55,6 +59,7 @@ export async function buildReport(absDir, root) {
     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 }))
@@ -72,6 +77,8 @@ export async function buildReport(absDir, root) {
         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 ───────────────────────────────────────────────── */
@@ -84,6 +91,9 @@ function esc(s) {
 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>`;
 }
@@ -109,6 +119,13 @@ export function buildReportHtml(d) {
     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}
@@ -149,6 +166,7 @@ export function buildReportHtml(d) {
   ${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>
@@ -156,6 +174,10 @@ export function buildReportHtml(d) {
   <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>`;

package/package.json

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