vibe-splain 2.3.1 → 2.4.0

package/dist/index.js

@@ -126,14 +126,65 @@ async function writeAnalysis(projectRoot, store) {
   await rename(tmp, dest);
 }
 var LOAD_BEARING_FAN_IN_THRESHOLD = 10;
-async function writeDeltaTargets(projectRoot, store) {
+function deriveRiskTypes(f) {
+  const kinds = new Set(f.smells.map((s) => s.kind));
+  const types = [];
+  if (f.gravitySignals.cyclomatic > 15)
+    types.push("state_machine");
+  if (kinds.has("god-file"))
+    types.push("god_object");
+  if (f.gravitySignals.fanIn > 15)
+    types.push("deep_coupling");
+  if (kinds.has("swallowed-catch"))
+    types.push("error_sink");
+  if (f.gravitySignals.fanIn > 10 && f.gravitySignals.publicSurface > 8)
+    types.push("mutation_hotspot");
+  if (kinds.has("todo") && kinds.has("suppression"))
+    types.push("tech_debt");
+  return types.length > 0 ? types : ["complexity_hotspot"];
+}
+function deriveConfidence(f) {
+  if (f.gravitySignals.fanIn >= LOAD_BEARING_FAN_IN_THRESHOLD && f.gravity >= 40)
+    return "high";
+  if (f.gravitySignals.fanIn >= 5 || f.gravity >= 25)
+    return "medium";
+  return "low";
+}
+function findRuntimeEntrypoints(relPath, files, entrypoints) {
+  const found = [];
+  const visited = /* @__PURE__ */ new Set();
+  const queue = [relPath];
+  while (queue.length > 0) {
+    const curr = queue.shift();
+    if (visited.has(curr))
+      continue;
+    visited.add(curr);
+    if (entrypoints.has(curr) && curr !== relPath)
+      found.push(curr);
+    if (found.length >= 5)
+      break;
+    const f = files[curr];
+    if (f) {
+      for (const importer of f.importedBy)
+        if (!visited.has(importer))
+          queue.push(importer);
+    }
+  }
+  return found;
+}
+async function writeDeltaTargets(projectRoot, store, entrypoints = /* @__PURE__ */ new Set()) {
+  const domain = (f) => f.pillarHint && !f.pillarHint.startsWith("community-") ? f.pillarHint : null;
   const targets = Object.values(store.files).filter((f) => f.isRealSource).sort((a, b) => b.gravity - a.gravity).map((f) => ({
     path: f.relativePath,
     gravity: f.gravity,
     isLoadBearing: f.gravitySignals.fanIn >= LOAD_BEARING_FAN_IN_THRESHOLD,
     blastRadius: f.importedBy,
-    // community-{N} labels are internal graph IDs — not useful to Delta Engine
-    pillarHint: f.pillarHint && !f.pillarHint.startsWith("community-") ? f.pillarHint : null
+    pillarHint: domain(f),
+    domain: domain(f),
+    riskTypes: deriveRiskTypes(f),
+    severity: f.smells.length > 0 ? Math.max(...f.smells.map((s) => s.severity)) : 0,
+    confidence: deriveConfidence(f),
+    runtimeEntrypoints: findRuntimeEntrypoints(f.relativePath, store.files, entrypoints)
   }));
   const dir = join3(projectRoot, ".vibe-splainer");
   await mkdir2(dir, { recursive: true });
@@ -256,7 +307,14 @@ var DEMOTE_SEGMENTS = /* @__PURE__ */ new Set([
   "fixtures",
   "fixture",
   "__generated__",
-  "__mocks__"
+  "__mocks__",
+  "playwright",
+  "e2e",
+  "__tests__",
+  "cypress",
+  "storybook",
+  "stories",
+  ".storybook"
 ]);
 var VENDOR_SEGMENTS = /* @__PURE__ */ new Set([
   "node_modules",
@@ -1094,6 +1152,19 @@ async function detectStackAndEntrypoints(projectRoot, files) {
     if (base === "main.rs" || base === "lib.rs")
       entrypoints.add(r);
   }
+  if (stack.has("Next.js")) {
+    const appRouterNames = /* @__PURE__ */ new Set(["page", "layout", "route", "loading", "error", "not-found", "template", "default"]);
+    for (const abs of files) {
+      const r = rel(abs);
+      const stem = basename(r, extname(r));
+      const underApp = /(?:^|[/\\])app[/\\]/.test(r);
+      const underPages = /(?:^|[/\\])pages[/\\]/.test(r);
+      if (underApp && appRouterNames.has(stem))
+        entrypoints.add(r);
+      if (underPages && !stem.startsWith("_"))
+        entrypoints.add(r);
+    }
+  }
   return { stack: [...stack], entrypoints };
 }
 var SMELL_WEIGHT = {
@@ -1295,7 +1366,7 @@ async function scanProject(projectRoot) {
   await writeGraph(projectRoot, graph);
   const analysisStore = { files: persisted };
   await writeAnalysis(projectRoot, analysisStore);
-  await writeDeltaTargets(projectRoot, analysisStore);
+  await writeDeltaTargets(projectRoot, analysisStore, entrypoints);
   const uiUrl = `file://${join4(projectRoot, ".vibe-splainer", "ui", "index.html")}`;
   return {
     projectRoot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-splain",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Architectural dossier engine for vibe-coded TypeScript/JavaScript projects. Runs as an MCP server inside your coding agent.",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "node": ">=18"
   },
   "bin": {
-    "vibe-splain": "./dist/index.js"
+    "vibe-splain": "dist/index.js"
   },
   "scripts": {
     "build": "tsc && node build.mjs"