@neat.is/core 0.8.1-dev.20260816 → 0.8.1

package/dist/{chunk-OJ6BW63H.js → chunk-RQTW7IV3.js}

@@ -20,7 +20,7 @@ import {
   startStalenessLoop,
   touchLastSeen,
   writeAtomically
-} from "./chunk-3PXRQH53.js";
+} from "./chunk-ZGZYZ33B.js";
 import {
   assertBindAuthority,
   buildOtelReceiver,
@@ -891,4 +891,4 @@ export {
   resolveHost,
   startDaemon
 };
-//# sourceMappingURL=chunk-OJ6BW63H.js.map
+//# sourceMappingURL=chunk-RQTW7IV3.js.map

package/dist/{chunk-3PXRQH53.js → chunk-ZGZYZ33B.js}

@@ -3794,7 +3794,7 @@ function ensureObservedSymbolNode(graph, fileNodeId, service, relPath, fn, line)
   }
   return sid;
 }
-function landObservedSymbol(graph, fileNodeId, service, relPath, callSite) {
+function landObservedSymbol(graph, fileNodeId, service, relPath, callSite, mint = true) {
   const line = callSite.line;
   if (line === void 0) return fileNodeId;
   let sawSymbol = false;
@@ -3809,7 +3809,7 @@ function landObservedSymbol(graph, fileNodeId, service, relPath, callSite) {
     }
   });
   if (candidates.length > 0) return pickContainingSymbol(candidates, callSite.fn);
-  if (sawSymbol && callSite.fn) {
+  if (mint && sawSymbol && callSite.fn) {
     return ensureObservedSymbolNode(graph, fileNodeId, service, relPath, callSite.fn, line);
   }
   return fileNodeId;
@@ -4215,6 +4215,20 @@ function incidentAffectedNode(span, graph, scanPath) {
   const callSite = callSiteFromSpan(span, serviceNode, scanPath);
   if (callSite) {
     const relPath = graph ? reconcileObservedRelPath(graph, span.service, callSite.relPath) : callSite.relPath;
+    const canonicalService = serviceNode && typeof serviceNode.name === "string" ? serviceNode.name : span.service;
+    if (graph) {
+      const fusedFileId = fileId3(canonicalService, relPath);
+      if (graph.hasNode(fusedFileId)) {
+        return landObservedSymbol(
+          graph,
+          fusedFileId,
+          canonicalService,
+          relPath,
+          { ...callSite, relPath },
+          false
+        );
+      }
+    }
     return fileId3(span.service, relPath);
   }
   return sid;
@@ -4578,7 +4592,11 @@ async function handleSpan(ctx, span) {
         ...span.exception?.type ? { exceptionType: span.exception.type } : {},
         ...span.exception?.stacktrace ? { exceptionStacktrace: span.exception.stacktrace } : {},
         ...Object.keys(attrs).length > 0 ? { attributes: attrs } : {},
-        affectedNode
+        // Attribute to where the failure originated — the symbol / file / service
+        // the throwing span named (incidentAffectedNode, ADR-191) — the same
+        // source-based attribution the durable receiver write uses, not the
+        // outbound edge target this span happened to mint.
+        affectedNode: incidentAffectedNode(span, ctx.graph, ctx.scanPath)
       };
       await appendErrorEvent(ctx, ev);
     }
@@ -4857,7 +4875,9 @@ import {
   Provenance as Provenance6,
   RelateResultSchema,
   RootCauseResultSchema,
-  TransitiveDependenciesResultSchema
+  TransitiveDependenciesResultSchema,
+  fileId as fileId4,
+  parseSymbolId
 } from "@neat.is/types";
 var ROOT_CAUSE_MAX_DEPTH = 5;
 var BLAST_RADIUS_DEFAULT_DEPTH = 10;
@@ -5099,7 +5119,11 @@ function legacyRootCause(graph, errorNodeId, errorEvent, incidents) {
 }
 var INCIDENT_ROOT_CAUSE_CONFIDENCE = 0.6;
 function incidentMatchesNode(ev, nodeId) {
-  return ev.affectedNode === nodeId || ev.service === nodeId.replace(/^service:/, "");
+  if (ev.affectedNode === nodeId) return true;
+  if (ev.service === nodeId.replace(/^service:/, "")) return true;
+  const sym = parseSymbolId(ev.affectedNode);
+  if (sym && fileId4(sym.service, sym.relPath) === nodeId) return true;
+  return false;
 }
 function localizeFromIncidents(nodeId, incidents, errorEvent) {
   const pool = incidents && incidents.length > 0 ? incidents : errorEvent ? [errorEvent] : [];
@@ -5117,8 +5141,8 @@ function localizeFromIncidents(nodeId, incidents, errorEvent) {
   const reasonParts = [`${latest.service}: ${latest.errorMessage}`];
   if (location) reasonParts.push(`surfaced at ${location}`);
   const rootCauseReason = `${reasonParts.join(" \u2014 ")}${tail}`;
-  const localizesToFile = latest.affectedNode !== nodeId && latest.affectedNode.startsWith("file:");
-  const fileNode = localizesToFile ? latest.affectedNode : void 0;
+  const localizesFiner = latest.affectedNode !== nodeId && (latest.affectedNode.startsWith("file:") || latest.affectedNode.startsWith("symbol:"));
+  const fileNode = localizesFiner ? latest.affectedNode : void 0;
   const fixRecommendation = location ? `Inspect ${location}${route ? ` handling ${route}` : ""}` : route ? `Inspect ${latest.service}'s handler for ${route}` : void 0;
   return {
     rootCauseNode: fileNode ?? nodeId,
@@ -5603,6 +5627,22 @@ function findLoadOrigin(graph, alertNodeId, incidents, now) {
   }
   return best ? { node: best.node, ctx: best.ctx } : null;
 }
+var LOAD_ORIGIN_CONFIDENCE_CEILING = 0.9;
+function loadOriginConfidence(originCtx, seedCtx) {
+  const cleanSplit = seedCtx.errorsFromCallers > 0 && seedCtx.errorsEmittedHere === 0;
+  const partialSplit = seedCtx.errorsFromCallers > seedCtx.errorsEmittedHere;
+  let evidence = 0;
+  evidence += cleanSplit ? 0.45 : partialSplit ? 0.2 : 0;
+  evidence += seedCtx.stale ? 0.2 : 0;
+  evidence += isSaturated(seedCtx) ? 0.15 : 0;
+  evidence += (volumeWeight(originCtx.outboundVolume) - 0.5) * 0.4;
+  const anchor = 0.45;
+  const confidence = anchor + Math.min(1, evidence) * (LOAD_ORIGIN_CONFIDENCE_CEILING - anchor);
+  return Math.max(0, Math.min(LOAD_ORIGIN_CONFIDENCE_CEILING, confidence));
+}
+function displayNameOf(nodeId) {
+  return nodeId.replace(/^[a-z]+:/, "");
+}
 function getRootCause(graph, errorNodeId, errorEvent, incidents, opts) {
   const legacy = legacyRootCause(graph, errorNodeId, errorEvent, incidents);
   if (!legacy) return null;
@@ -5617,20 +5657,20 @@ function enrichWithNavigation(graph, errorNodeId, legacy, incidents, now) {
   const candidates = [];
   if (seedCtx && isVictimSeed(seedCtx)) {
     const origin = findLoadOrigin(graph, errorNodeId, incidents, now);
+    const staleNote = seedCtx.stale ? "; it has gone STALE under load" : "";
+    const satNote = isSaturated(seedCtx) ? `; its inbound p95 ${Math.round(seedCtx.latencyP95Ms)}ms is saturated` : "";
     if (origin) {
-      const path64 = findPath(graph, errorNodeId, origin.node, "up", ROOT_CAUSE_MAX_DEPTH);
-      const originConfidence = confidenceFromMix(path64?.edges ?? [], now);
+      const originName = displayNameOf(origin.node);
+      const seedName = displayNameOf(seedNode);
       candidates.push({
         node: origin.node,
         classification: "primary-failure",
-        reason: `Highest-volume upstream source (${origin.ctx.outboundVolume} observed outbound calls) driving a saturated/stale subgraph; the alerting path decays downstream into a starved victim rather than a fault at the callee.`,
+        reason: `${originName} is the root cause: it overloads the failing subgraph, and the alerting node ${seedName} is a downstream symptom, not the fault \u2014 errors reach ${seedName} from its callers (${seedCtx.errorsFromCallers}), none originate there${staleNote}${satNote}. ${originName} is the upstream source driving that load (${origin.ctx.outboundVolume} observed outbound calls).`,
         context: origin.ctx,
-        confidence: Math.max(0.3, Math.min(0.8, originConfidence || 0.5)),
+        confidence: loadOriginConfidence(origin.ctx, seedCtx),
         provenance: Provenance6.OBSERVED
       });
     }
-    const staleNote = seedCtx.stale ? "; the node has gone STALE" : "";
-    const satNote = isSaturated(seedCtx) ? `; inbound p95 ${Math.round(seedCtx.latencyP95Ms)}ms is saturated` : "";
     candidates.push({
       node: seedNode,
       classification: "symptom-only",
@@ -5662,16 +5702,27 @@ function enrichWithNavigation(graph, errorNodeId, legacy, incidents, now) {
       edgeProvenances = [top.provenance ?? Provenance6.OBSERVED];
     }
   }
+  const fixRecommendation = fixRecommendationForTop(top, seedNode, legacy);
   return RootCauseResultSchema.parse({
     rootCauseNode: top.node,
     rootCauseReason: top.reason,
     traversalPath,
     edgeProvenances,
     confidence: top.confidence,
-    ...legacy.fixRecommendation ? { fixRecommendation: legacy.fixRecommendation } : {},
+    ...fixRecommendation ? { fixRecommendation } : {},
     candidates
   });
 }
+function fixRecommendationForTop(top, seedNode, legacy) {
+  if (top.classification === "primary-failure" && top.node === seedNode) {
+    return legacy.fixRecommendation;
+  }
+  const name = top.node.replace(/^service:/, "");
+  if (top.classification === "primary-failure") {
+    return `Reduce or throttle the load from ${name} (or scale the saturated downstream capacity it drives) \u2014 the failure originates at this overloading source, not the starved callee.`;
+  }
+  return `${name} is a saturated/starved downstream victim; investigate its inbound load and upstream callers, not its own handler.`;
+}
 
 // src/extract/services.ts
 import { promises as fs12 } from "fs";
@@ -16076,7 +16127,7 @@ function createFirebaseConnector(graph, serviceMap) {
 }
 
 // src/connectors/cloudflare/connector.ts
-import { EdgeType as EdgeType29, NodeType as NodeType29, fileId as fileId4, infraId as infraId21 } from "@neat.is/types";
+import { EdgeType as EdgeType29, NodeType as NodeType29, fileId as fileId5, infraId as infraId21 } from "@neat.is/types";
 
 // src/connectors/cloudflare/client.ts
 import { randomUUID } from "crypto";
@@ -16266,7 +16317,7 @@ function createCloudflareResolveTarget(config, graph) {
     };
     const mapping = config.workers?.[scriptName];
     if (mapping) {
-      const wholeFileId = fileId4(mapping.service, mapping.entryFile);
+      const wholeFileId = fileId5(mapping.service, mapping.entryFile);
       return {
         targetNodeId: resolveRouteGrain(mapping.service, wholeFileId),
         serviceName: mapping.service,
@@ -18924,4 +18975,4 @@ export {
   deprovisionConnector,
   buildApi
 };
-//# sourceMappingURL=chunk-3PXRQH53.js.map
+//# sourceMappingURL=chunk-ZGZYZ33B.js.map