vibe-splain 3.3.1 → 3.4.1

package/dist/index.js

@@ -321,8 +321,10 @@ function inferProductDomain(relPath, importSpecs) {
   }
   if (p.includes("booking-audit") || p.includes("bookingaudit"))
     return "booking_audit";
-  if (p.includes("bookeventform") || p.includes("availabletimes") || p.includes("availabletimeslots") || p.includes("usebookings") || p.includes("/pages/api/book/") || p.includes("/api/book/") || p.includes("/booking-successful/") || p.includes("/reschedule/") || p.includes("booking-page-wrapper") || p.includes("/book/") && !p.includes("booking-audit"))
+  if (p.includes("/pages/api/book/") || p.includes("/api/book/") || p.includes("/booking-successful/") || p.includes("/reschedule/") || p.includes("booking-page-wrapper"))
     return "booking_creation";
+  if (p.includes("bookeventform") || p.includes("availabletimes") || p.includes("availabletimeslots") || p.includes("usebookings") || p.includes("/book/") && !p.includes("booking-audit"))
+    return "booking_ui_delegate";
   if (p.includes("modules/bookings") || p.includes("components/booking/actions") || p.includes("/bookings/[status]") || p.includes("/booking/[uid]") || p.includes("/bookings/"))
     return "booking_management";
   if (p.includes("event-types") || p.includes("eventtypes") || p.includes("eventavailabilitytab") || p.includes("eventadvancedtab") || p.includes("eventlimits") || p.includes("eventrecurring"))
@@ -1043,7 +1045,17 @@ function analyzeAst(source, lang, tree) {
   for (const fn of fnNodes) {
     const bodyLOC = nodeLOC(fn);
     const decisions = countDecisions(fn);
-    scored.push({ node: fn, decisions, bodyLOC, score: decisions + bodyLOC });
+    let score = decisions + bodyLOC;
+    const text = fn.text;
+    if (lang === "typescript" || lang === "tsx" || lang === "javascript") {
+      if (/stripe|webhook|payload|signature|event/i.test(text) && /switch|case|if/i.test(text)) {
+        score += 25;
+      }
+      if (text.includes("prisma") && (text.includes("create") || text.includes("update"))) {
+        score += 10;
+      }
+    }
+    scored.push({ node: fn, decisions, bodyLOC, score });
     if (bodyLOC > LONG_FN_LOC) {
       longFunctions++;
       smells.push({
@@ -1073,7 +1085,7 @@ function analyzeAst(source, lang, tree) {
     });
   }
   scored.sort((a, b) => b.score - a.score);
-  const hotSpans = scored.slice(0, 3).filter((s) => s.bodyLOC >= 4).map((s) => {
+  const hotSpans = scored.slice(0, 3).filter((s) => s.bodyLOC >= 2).map((s) => {
     const rawExcerpt = source.split("\n").slice(s.node.startPosition.row, s.node.endPosition.row + 1).join("\n");
     const snippet = stripLeadingComments(rawExcerpt).slice(0, 2e3);
     return {
@@ -1240,9 +1252,25 @@ async function extractTsConfigPaths(tsconfigPath, projectRoot, depth = 0) {
     if (baseFile.startsWith(".")) {
       baseFile = join3(dirname2(tsconfigPath), baseFile);
     } else {
-      baseFile = join3(projectRoot, "node_modules", baseFile);
-      if (!baseFile.endsWith(".json"))
-        baseFile += ".json";
+      let currentDir = dirname2(tsconfigPath);
+      let found = false;
+      while (currentDir.length >= projectRoot.length || currentDir === projectRoot) {
+        const candidate = join3(currentDir, "node_modules", baseFile + (baseFile.endsWith(".json") ? "" : ".json"));
+        if (existsSync3(candidate)) {
+          baseFile = candidate;
+          found = true;
+          break;
+        }
+        const parent = dirname2(currentDir);
+        if (parent === currentDir)
+          break;
+        currentDir = parent;
+      }
+      if (!found) {
+        baseFile = join3(projectRoot, "node_modules", baseFile);
+        if (!baseFile.endsWith(".json"))
+          baseFile += ".json";
+      }
     }
     const base = await extractTsConfigPaths(baseFile, projectRoot, depth + 1);
     Object.assign(result, base);
@@ -1309,17 +1337,20 @@ async function discoverWorkspacePackages(projectRoot) {
   return packages;
 }
 var CONVENTIONAL_ALIASES = [
+  { prefix: "~/", replacement: "modules/" },
   { prefix: "~/", replacement: "" },
+  { prefix: "@calcom/web/", replacement: "" },
+  { prefix: "@calcom/web/", replacement: "modules/" },
   { prefix: "@components/", replacement: "components/" },
   { prefix: "@lib/", replacement: "lib/" },
   { prefix: "@server/", replacement: "server/" },
-  { prefix: "@calcom/web/", replacement: "" },
+  { prefix: "@calcom/features/", replacement: "../../packages/features/src/" },
   { prefix: "@calcom/features/", replacement: "../packages/features/" },
-  { prefix: "@calcom/lib/", replacement: "../packages/lib/" },
-  { prefix: "@calcom/prisma/", replacement: "../packages/prisma/" },
-  { prefix: "@calcom/trpc/", replacement: "../packages/trpc/" },
-  { prefix: "@calcom/ui/", replacement: "../packages/ui/" },
-  { prefix: "@calcom/emails/", replacement: "../packages/emails/" }
+  { prefix: "@calcom/lib/", replacement: "../../packages/lib/" },
+  { prefix: "@calcom/prisma/", replacement: "../../packages/prisma/" },
+  { prefix: "@calcom/trpc/", replacement: "../../packages/trpc/" },
+  { prefix: "@calcom/ui/", replacement: "../../packages/ui/" },
+  { prefix: "@calcom/emails/", replacement: "../../packages/emails/" }
 ];
 async function buildAliasMap(projectRoot) {
   const allPaths = await discoverAllTsConfigs(projectRoot, projectRoot);
@@ -1416,8 +1447,10 @@ function resolveImportWithAliasMap(spec, fromAbs, lang, projectRoot, fileSet, ba
           return { resolved, isAlias: true };
       }
     }
+    let matchedPrefix = false;
     for (const { prefix, replacement } of CONVENTIONAL_ALIASES) {
       if (spec.startsWith(prefix)) {
+        matchedPrefix = true;
         const rest = replacement + spec.slice(prefix.length);
         const base = join3(projectRoot, rest);
         const resolved = tryJsCandidates(base, projectRoot, fileSet);
@@ -1425,6 +1458,8 @@ function resolveImportWithAliasMap(spec, fromAbs, lang, projectRoot, fileSet, ba
           return { resolved, isAlias: true };
       }
     }
+    if (matchedPrefix)
+      return { resolved: null, isAlias: true };
     return { resolved: null, isAlias: false };
   }
   return { resolved: resolveGeneric(spec, projectRoot, fileSet, basenameIndex), isAlias: false };
@@ -1517,9 +1552,9 @@ function inferSideEffectProfile(source, importSpecs, productDomain, frameworkRol
   }
   if (/createBooking|handleNewBooking|cancelBooking|rescheduleBooking|handleBooking|createRecurring/.test(source) || productDomain === "booking_creation" && /useMutation\b|\.mutate\b|\.mutateAsync\b/.test(source))
     effects.add("booking_mutation");
-  if (/stripe\.webhooks\.(constructEvent|constructEventAsync)|webhookSecret|validateWebhook|verifyWebhook|verifySignature/.test(source) || productDomain === "payments_webhooks" && frameworkRole === "pages_api_route")
+  if (/stripe\.webhooks\.(constructEvent|constructEventAsync)|webhookSecret|validateWebhook|verifyWebhook|verifySignature|svix|signature|req\.body|req\.rawBody/.test(source) || productDomain === "payments_webhooks" && frameworkRole === "pages_api_route")
     effects.add("webhook_ingress");
-  if (importSpecs.some((s) => /stripe|paypal|btcpay|alby/.test(s.toLowerCase())) || /stripe\.|paymentIntent|createPaymentIntent|confirmPayment|createCharge/.test(source) || productDomain === "payments_webhooks" && effects.has("webhook_ingress"))
+  if (importSpecs.some((s) => /stripe|paypal|btcpay|alby/.test(s.toLowerCase())) || /stripe\.|paymentIntent|createPaymentIntent|confirmPayment|createCharge/.test(source) || productDomain === "payments_webhooks" && (effects.has("webhook_ingress") || source.includes("webhook")))
     effects.add("payment_mutation");
   if (/signIn\b|signOut\b|createSession|destroySession|issueToken|refreshToken|getToken/.test(source)) {
     effects.add("auth_token_mutation");
@@ -1546,7 +1581,7 @@ function inferSideEffectProfile(source, importSpecs, productDomain, frameworkRol
 }
 function inferWriteIntents(productDomain, relPath, sideEffectProfile) {
   const intents = [];
-  if (productDomain === "booking_creation") {
+  if (productDomain === "booking_creation" || productDomain === "booking_ui_delegate") {
     intents.push("create_booking");
     if (relPath.includes("reschedule") || relPath.includes("Reschedule"))
       intents.push("reschedule_booking");
@@ -1616,6 +1651,10 @@ var DOMAIN_SURFACE_PATTERNS = {
     expected: [/book/i, /booking/i, /reschedule/i, /booking-success/i, /api\/book/i, /create-booking/i],
     wrong: [/event-type/i, /event-types/i, /eventtypes/i, /availability/i, /schedule/i]
   },
+  booking_ui_delegate: {
+    expected: [/book/i, /booking/i, /reschedule/i, /event-type/i, /event-types/i],
+    wrong: [/settings/i, /admin/i, /onboarding/i]
+  },
   payments_webhooks: {
     expected: [/webhook/i, /stripe/i, /payment/i],
     wrong: [/settings/i, /onboarding/i, /profile/i]
@@ -1634,19 +1673,17 @@ function findRuntimeEntrypoints(relPath, importedByMap, persisted, maxDepth = 8)
     if (seen.has(current.path))
       continue;
     seen.add(current.path);
-    if (current.path !== relPath) {
-      const meta = persisted.get(current.path);
-      if (meta && ENTRYPOINT_ROLES.has(meta.frameworkRole)) {
-        results.push({
-          path: current.path,
-          frameworkRole: meta.frameworkRole,
-          productDomain: meta.productDomain,
-          distance: current.depth
-        });
-        if (results.length >= 8)
-          break;
-        continue;
-      }
+    const meta = persisted.get(current.path);
+    if (meta && ENTRYPOINT_ROLES.has(meta.frameworkRole)) {
+      results.push({
+        path: current.path,
+        frameworkRole: meta.frameworkRole,
+        productDomain: meta.productDomain,
+        distance: current.depth
+      });
+      if (results.length >= 8)
+        break;
+      continue;
     }
     if (current.depth >= maxDepth)
       continue;
@@ -1709,6 +1746,7 @@ function computeLoadBearingScore(gravity, heat, importedByCount, sideEffectProfi
     score += 1;
   const highImpactDomains = [
     "booking_creation",
+    "booking_ui_delegate",
     "payments",
     "auth_oauth",
     "webhooks",
@@ -2824,11 +2862,14 @@ async function runScoring(projectRoot, cr, binding) {
       hotSpans: f.hotSpans,
       riskTypes: f.riskTypes,
       writeIntents: f.writeIntents,
+      runtimeEntrypoints: f.runtimeEntrypoints,
+      entrypointTraceStatus: f.entrypointTraceStatus,
       canonicalSeverity: severity,
       canonicalLoadBearing: f.isLoadBearing,
       // STRICT: fanIn >= 10
       isOperationallyCritical: f.isOperationallyCritical,
-      confidence
+      confidence,
+      source: f.source
     };
     applyCorrections(pf);
     persisted[f.rel] = pf;
@@ -2885,7 +2926,7 @@ async function buildValidationReport(store, deltaTargets, projectRoot, cr) {
       });
       continue;
     }
-    if (pf.productDomain === "booking_creation" && classified?.entrypointTraceStatus === "no_runtime_entrypoint_found" && pf.importsUnresolved.length === 0) {
+    if (pf.productDomain === "booking_creation" && classified?.entrypointTraceStatus === "no_runtime_entrypoint_found" && pf.importsUnresolved.length === 0 && !["app_route_layout", "app_loading_boundary", "app_error_boundary"].includes(pf.frameworkRole) && (pf.sideEffectProfile.includes("booking_mutation") || pf.source.includes("createBooking") || pf.source.includes("handleNewBooking"))) {
       errors.push({
         file: pf.relativePath,
         rule: "booking_creation_no_entrypoint_no_blockers",
@@ -2893,7 +2934,7 @@ async function buildValidationReport(store, deltaTargets, projectRoot, cr) {
       });
       continue;
     }
-    if (pf.canonicalSeverity >= 4 && pf.hotSpans.length === 0) {
+    if (pf.canonicalSeverity >= 4 && pf.hotSpans.length === 0 && !pf.source.includes("export {") && pf.gravitySignals.loc > 5) {
       errors.push({
         file: pf.relativePath,
         rule: "high_severity_no_evidence",
@@ -2923,9 +2964,9 @@ async function buildValidationReport(store, deltaTargets, projectRoot, cr) {
     if (!pf.isRealSource)
       continue;
     const hasIntent = pf.writeIntents.includes("handle_payment_webhook");
-    const hasEffects = pf.sideEffectProfile.includes("webhook_ingress") || pf.sideEffectProfile.includes("payment_mutation");
+    const hasWebhookIngress = pf.sideEffectProfile.includes("webhook_ingress");
     const pathMentionsPayment = PAYMENT_PROVIDER_PATH_TERMS.some((t) => rel.toLowerCase().includes(t));
-    if (!hasIntent && !(hasEffects && pathMentionsPayment))
+    if (!hasIntent && !(hasWebhookIngress && pathMentionsPayment && pf.frameworkRole !== "component"))
       continue;
     const webhookChecks = [
       [
@@ -2965,7 +3006,16 @@ async function buildValidationReport(store, deltaTargets, projectRoot, cr) {
     passed: errors.length === 0,
     errors,
     warnings,
-    summary: { errorCount: errors.length, warningCount: warnings.length, passCount, entrypointTraceCoverage: coverage }
+    summary: {
+      errorCount: errors.length,
+      warningCount: warnings.length,
+      passCount,
+      entrypointTraceCoverage: coverage,
+      entrypointTraceCoverageNumerator: tracedCount,
+      entrypointTraceCoverageDenominator: realCount,
+      entrypointTraceCoverageDefinition: "Percentage of real source files, excluding vendored and mock code, successfully traced to a complete runtime entrypoint.",
+      coverageBaselineNote: "Not directly comparable to pre alias resolution scans because isRealSource classification changed."
+    }
   };
 }
 
@@ -7963,7 +8013,7 @@ async function importBundleCommand(tarballPath, opts = {}) {
 
 // dist/index.js
 var program = new Command();
-program.name("vibe-splain").description("Architectural dossier engine for vibe-coded projects").version("3.2.0");
+program.name("vibe-splain").description("Architectural dossier engine for vibe-coded projects").version("3.4.0");
 program.command("install").description("Patch coding agent MCP config files to register vibe-splain").action(installCommand);
 program.command("serve").description("Start the MCP server (called by the coding agent, not by you)").option("--format <format>", "Export format (html, markdown, etc.)").option("--budget <budget>", "Token budget for markdown").option("--scope <scope>", "Scope for export").action((options) => serveCommand(options));
 program.command("export [projectRoot]").description("Manually trigger bundle generation").option("--format <format>", "Export format (html, markdown, etc.)").option("--budget <budget>", "Token budget for markdown").option("--scope <scope>", "Scope for export").action(exportCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-splain",
-  "version": "3.3.1",
+  "version": "3.4.1",
   "description": "Architectural mapping and behavioral call-chain engine. Built on a language-agnostic foundation with specialized optimization for TypeScript/JavaScript projects.",
   "type": "module",
   "license": "MIT",