vibe-splain 2.2.0 → 2.3.0

package/dist/index.js

@@ -981,9 +981,9 @@ function detectCommunities(nodes, adjacency) {
       if (!neighbors || neighbors.size === 0)
         continue;
       const counts = /* @__PURE__ */ new Map();
-      for (const nb of neighbors) {
+      for (const [nb, weight] of neighbors) {
         const l = label.get(nb);
-        counts.set(l, (counts.get(l) || 0) + 1);
+        counts.set(l, (counts.get(l) || 0) + weight);
       }
       let best = label.get(node), bestCount = -1;
       for (const [l, c] of counts) {
@@ -1175,7 +1175,7 @@ async function scanProject(projectRoot) {
   const undirected = /* @__PURE__ */ new Map();
   for (const node of realNodes) {
     outEdges.set(node, /* @__PURE__ */ new Set());
-    undirected.set(node, /* @__PURE__ */ new Set());
+    undirected.set(node, /* @__PURE__ */ new Map());
   }
   for (const w of work) {
     if (!realSet.has(w.rel))
@@ -1184,8 +1184,11 @@ async function scanProject(projectRoot) {
       if (!realSet.has(target))
         continue;
       outEdges.get(w.rel).add(target);
-      undirected.get(w.rel).add(target);
-      undirected.get(target).add(w.rel);
+      const wDir = w.rel.split(sep)[0];
+      const tDir = target.split(sep)[0];
+      const weight = wDir === tDir ? 1 : 0.5;
+      undirected.get(w.rel).set(target, weight);
+      undirected.get(target).set(w.rel, weight);
     }
   }
   const ranks = pageRank(realNodes, outEdges);
@@ -1335,8 +1338,42 @@ function buildPillars(real, communities, _stack) {
     const gravB = real.filter((f) => b.memberFiles.includes(f.relativePath)).reduce((s, f) => s + f.gravity, 0);
     return gravB - gravA;
   });
-  const seen = /* @__PURE__ */ new Set();
+  if (pillars.length === 0 && real.length > 0) {
+    pillars.push({ name: "Core", description: "Primary application code.", memberFiles: real.slice(0, 20).map((f) => f.relativePath) });
+  }
+  const finalPillars = [];
   for (const p of pillars) {
+    if (p.memberFiles.length > 15) {
+      const groups = /* @__PURE__ */ new Map();
+      for (const f of p.memberFiles) {
+        let bucket = "Core";
+        if (f.includes("app/") || f.includes("pages/") || f.includes("routes/"))
+          bucket = "Routing";
+        else if (f.includes("components/") || f.includes("ui/"))
+          bucket = "Components";
+        else if (f.includes("hooks/") || f.includes("lib/") || f.includes("utils/"))
+          bucket = "Logic";
+        const d = basename(dirname(f));
+        const key = `${p.name} (${bucket} - ${d})`;
+        if (!groups.has(key))
+          groups.set(key, []);
+        groups.get(key).push(f);
+      }
+      for (const [key, files] of groups) {
+        if (files.length > 0) {
+          finalPillars.push({
+            name: key,
+            description: `Subdivided from ${p.name}`,
+            memberFiles: files
+          });
+        }
+      }
+    } else {
+      finalPillars.push(p);
+    }
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const p of finalPillars) {
     let n = p.name, i = 2;
     while (seen.has(n)) {
       n = `${p.name} ${i++}`;
@@ -1344,10 +1381,7 @@ function buildPillars(real, communities, _stack) {
     p.name = n;
     seen.add(n);
   }
-  if (pillars.length === 0 && real.length > 0) {
-    pillars.push({ name: "Core", description: "Primary application code.", memberFiles: real.slice(0, 20).map((f) => f.relativePath) });
-  }
-  return pillars;
+  return finalPillars;
 }
 function pillarNameFromCluster(files) {
   const hintCounts = /* @__PURE__ */ new Map();
@@ -1444,11 +1478,30 @@ async function readDossier(projectRoot) {
 }
 async function writeDossier(projectRoot, dossier) {
   await dossierMutex.runExclusive(async () => {
+    for (const p of dossier.pillars) {
+      p.decisions = p.decisions.filter((c) => !(c.severity === 1 && c.category === "Convention"));
+      p.cardCount = p.decisions.length;
+    }
+    const uniqueCards = /* @__PURE__ */ new Map();
+    for (const p of dossier.pillars) {
+      for (const c of p.decisions)
+        uniqueCards.set(c.id, c);
+    }
+    for (const c of dossier.wildDiscoveries)
+      uniqueCards.set(c.id, c);
+    const deltaTargets = Array.from(uniqueCards.values()).filter((c) => c.severity >= 4).map((c) => ({
+      target_path: c.primaryFile,
+      bottleneck_title: c.title,
+      structural_intent: c.thesis,
+      evidence_snippets: c.evidence
+    }));
     const dir = join5(projectRoot, ".vibe-splainer");
     await mkdir3(dir, { recursive: true });
     const dossierPath = join5(dir, "dossier.json");
     const tmp = dossierPath + ".tmp";
     await writeFile4(tmp, JSON.stringify(dossier, null, 2), "utf8");
+    const targetsPath = join5(dir, "delta_targets.json");
+    await writeFile4(targetsPath, JSON.stringify(deltaTargets, null, 2), "utf8");
     const { rename } = await import("fs/promises");
     await rename(tmp, dossierPath);
     await regenerateUI(projectRoot, dossier);
@@ -1742,7 +1795,7 @@ var writeDecisionCardTool = {
       narrative: { type: "string", description: "3-5 sentences. WHY it exists and WHY it's built this way. Do NOT restate the file's header comments." },
       tradeoff: { type: "string", description: "What was given up, or why the obvious approach was rejected. Null only if genuinely none." },
       blastRadius: { type: "string", description: "What breaks if this changes. Ground it in the fan-in (importedBy) from get_file_context." },
-      confidence: { type: "string", enum: ["low", "medium", "high"] },
+      confidence: { type: "string", enum: ["low", "medium", "high"], description: 'Do NOT default to "high". Reserve "high" ONLY for provable execution anti-patterns. Score subjective stylistic choices or abstractions as "low" or "medium".' },
       evidence: {
         type: "array",
         items: {

package/dist/mcp/tools/write_decision_card.d.ts

@@ -47,6 +47,7 @@ export declare const writeDecisionCardTool: {
             confidence: {
                 type: string;
                 enum: string[];
+                description: string;
             };
             evidence: {
                 type: string;

package/dist/mcp/tools/write_decision_card.js

@@ -29,7 +29,7 @@ export const writeDecisionCardTool = {
             narrative: { type: 'string', description: "3-5 sentences. WHY it exists and WHY it's built this way. Do NOT restate the file's header comments." },
             tradeoff: { type: 'string', description: 'What was given up, or why the obvious approach was rejected. Null only if genuinely none.' },
             blastRadius: { type: 'string', description: 'What breaks if this changes. Ground it in the fan-in (importedBy) from get_file_context.' },
-            confidence: { type: 'string', enum: ['low', 'medium', 'high'] },
+            confidence: { type: 'string', enum: ['low', 'medium', 'high'], description: 'Do NOT default to "high". Reserve "high" ONLY for provable execution anti-patterns. Score subjective stylistic choices or abstractions as "low" or "medium".' },
             evidence: {
                 type: 'array',
                 items: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-splain",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Architectural dossier engine for vibe-coded projects. Runs as an MCP server inside your coding agent.",
   "type": "module",
   "license": "MIT",