@neat.is/core 0.4.26-dev.20260703 → 0.4.27-dev.20260705

package/dist/{chunk-WZYH5DVG.js → chunk-QM6BMPVJ.js}

@@ -1,7 +1,7 @@
 import {
   mountBearerAuth,
   readAuthEnv
-} from "./chunk-2LNICOVU.js";
+} from "./chunk-A3322JYS.js";
 
 // src/graph.ts
 import GraphDefault from "graphology";
@@ -456,19 +456,19 @@ function confidenceFromMix(edges, now = Date.now()) {
 function longestIncomingWalk(graph, start, maxDepth) {
   let best = { path: [start], edges: [] };
   const visited = /* @__PURE__ */ new Set([start]);
-  function step(node, path41, edges) {
-    if (path41.length > best.path.length) {
-      best = { path: [...path41], edges: [...edges] };
+  function step(node, path42, edges) {
+    if (path42.length > best.path.length) {
+      best = { path: [...path42], edges: [...edges] };
     }
-    if (path41.length - 1 >= maxDepth) return;
+    if (path42.length - 1 >= maxDepth) return;
     const incoming = bestEdgeBySource(graph, graph.inboundEdges(node));
     for (const [srcId, edge] of incoming) {
       if (visited.has(srcId)) continue;
       visited.add(srcId);
-      path41.push(srcId);
+      path42.push(srcId);
       edges.push(edge);
-      step(srcId, path41, edges);
-      path41.pop();
+      step(srcId, path42, edges);
+      path42.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -662,26 +662,26 @@ function dominantFailingCall(graph, serviceId4, visited) {
   return best;
 }
 function followFailingCallChain(graph, originServiceId, maxDepth) {
-  const path41 = [originServiceId];
+  const path42 = [originServiceId];
   const edges = [];
   const visited = /* @__PURE__ */ new Set([originServiceId]);
   let current = originServiceId;
   for (let depth = 0; depth < maxDepth; depth++) {
     const hop = dominantFailingCall(graph, current, visited);
     if (!hop) break;
-    path41.push(hop.nextService);
+    path42.push(hop.nextService);
     edges.push(hop.edge);
     visited.add(hop.nextService);
     current = hop.nextService;
   }
   if (edges.length === 0) return null;
-  return { path: path41, edges, culprit: current };
+  return { path: path42, edges, culprit: current };
 }
 function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   const chain = followFailingCallChain(graph, originId, ROOT_CAUSE_MAX_DEPTH);
   if (!chain) return null;
   const culprit = chain.culprit;
-  const path41 = [...chain.path];
+  const path42 = [...chain.path];
   const edgeProvenances = chain.edges.map((e) => e.provenance);
   const baseConfidence = confidenceFromMix(chain.edges);
   const confidence = Math.max(0, Math.min(1, baseConfidence * INCIDENT_ROOT_CAUSE_CONFIDENCE));
@@ -689,14 +689,14 @@ function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   if (loc) {
     let rootCauseNode = culprit;
     if (loc.fileNode) {
-      path41.push(loc.fileNode);
+      path42.push(loc.fileNode);
       edgeProvenances.push(Provenance.OBSERVED);
       rootCauseNode = loc.fileNode;
     }
     return RootCauseResultSchema.parse({
       rootCauseNode,
       rootCauseReason: loc.rootCauseReason,
-      traversalPath: path41,
+      traversalPath: path42,
       edgeProvenances,
       confidence,
       ...loc.fixRecommendation ? { fixRecommendation: loc.fixRecommendation } : {}
@@ -708,7 +708,7 @@ function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   return RootCauseResultSchema.parse({
     rootCauseNode: culprit,
     rootCauseReason: `${culpritName} is failing downstream calls (${errs} observed error${errs === 1 ? "" : "s"})`,
-    traversalPath: path41,
+    traversalPath: path42,
     edgeProvenances,
     confidence,
     fixRecommendation: `Inspect ${culpritName}'s failing handler`
@@ -1382,10 +1382,12 @@ import {
   fileId,
   frontierId,
   graphqlOperationId,
+  grpcMethodId,
   inferredEdgeId,
   infraId,
   observedEdgeId,
-  serviceId
+  serviceId,
+  websocketChannelId
 } from "@neat.is/types";
 var HOUR_MS = 60 * 60 * 1e3;
 var DAY_MS = 24 * HOUR_MS;
@@ -1748,6 +1750,40 @@ function ensureGraphqlOperationNode(graph, serviceName, operationType, operation
   graph.addNode(id, node);
   return id;
 }
+function spanServesGrpcMethod(kind) {
+  return kind !== WIRE_SPAN_KIND_CLIENT && kind !== WIRE_SPAN_KIND_PRODUCER && kind !== WIRE_SPAN_KIND_CONSUMER;
+}
+function ensureGrpcMethodNode(graph, rpcService, rpcMethod) {
+  const id = grpcMethodId(rpcService, rpcMethod);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: NodeType3.GrpcMethodNode,
+    name: `${rpcService}/${rpcMethod}`,
+    rpcService,
+    rpcMethod,
+    discoveredVia: "otel"
+  };
+  graph.addNode(id, node);
+  return id;
+}
+function spanServesWebsocketChannel(kind) {
+  return kind !== WIRE_SPAN_KIND_CLIENT && kind !== WIRE_SPAN_KIND_PRODUCER && kind !== WIRE_SPAN_KIND_CONSUMER;
+}
+function ensureWebsocketChannelNode(graph, serviceName, channel) {
+  const id = websocketChannelId(serviceName, channel);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: NodeType3.WebSocketChannelNode,
+    name: channel,
+    service: serviceName,
+    channel,
+    discoveredVia: "otel"
+  };
+  graph.addNode(id, node);
+  return id;
+}
 function messagingDestinationKind(system) {
   return `${system}-topic`;
 }
@@ -2183,6 +2219,34 @@ async function handleSpan(ctx, span) {
       callSiteEvidence
     );
     if (result) affectedNode = targetId;
+  } else if (span.rpcSystem === "grpc" && span.rpcService && span.rpcMethod && spanServesGrpcMethod(span.kind)) {
+    const targetId = ensureGrpcMethodNode(ctx.graph, span.rpcService, span.rpcMethod);
+    const result = upsertObservedEdge(
+      ctx.graph,
+      EdgeType3.CONTAINS,
+      observedSource(),
+      targetId,
+      ts,
+      isError,
+      callSiteEvidence
+    );
+    if (result) affectedNode = targetId;
+  } else if (span.websocketChannel && spanServesWebsocketChannel(span.kind)) {
+    const targetId = ensureWebsocketChannelNode(
+      ctx.graph,
+      span.service,
+      span.websocketChannel
+    );
+    const result = upsertObservedEdge(
+      ctx.graph,
+      EdgeType3.CONNECTS_TO,
+      observedSource(),
+      targetId,
+      ts,
+      isError,
+      callSiteEvidence
+    );
+    if (result) affectedNode = targetId;
   } else {
     const host = pickAddress(span);
     let resolvedViaAddress = false;
@@ -4774,24 +4838,151 @@ async function addRoutes(graph, services) {
   return { nodesAdded, edgesAdded };
 }
 
+// src/extract/proto.ts
+import { promises as fs15 } from "fs";
+import path23 from "path";
+import {
+  EdgeType as EdgeType9,
+  NodeType as NodeType10,
+  Provenance as Provenance8,
+  confidenceForExtracted as confidenceForExtracted6,
+  extractedEdgeId as extractedEdgeId6,
+  grpcMethodId as grpcMethodId2
+} from "@neat.is/types";
+var PROTO_EXTENSION = ".proto";
+function packageOf(content) {
+  const m = content.match(/^\s*package\s+([A-Za-z_][A-Za-z0-9_.]*)\s*;/m);
+  return m ? m[1] : null;
+}
+function lineAt(content, offset) {
+  return content.slice(0, offset).split("\n").length;
+}
+function grpcMethodsFromProto(content, fqPackage) {
+  const out = [];
+  const serviceRe = /\bservice\s+([A-Za-z_][A-Za-z0-9_]*)\s*\{/g;
+  let sm;
+  while ((sm = serviceRe.exec(content)) !== null) {
+    const serviceName = sm[1];
+    const rpcService = fqPackage ? `${fqPackage}.${serviceName}` : serviceName;
+    const bodyStart = serviceRe.lastIndex;
+    let depth = 1;
+    let i = bodyStart;
+    for (; i < content.length && depth > 0; i++) {
+      const ch = content[i];
+      if (ch === "{") depth++;
+      else if (ch === "}") depth--;
+    }
+    const body = content.slice(bodyStart, i - 1);
+    const rpcRe = /\brpc\s+([A-Za-z_][A-Za-z0-9_]*)\s*\(/g;
+    let rm;
+    while ((rm = rpcRe.exec(body)) !== null) {
+      const rpcMethod = rm[1];
+      const line = lineAt(content, bodyStart + rm.index);
+      out.push({ rpcService, rpcMethod, line });
+    }
+    serviceRe.lastIndex = i;
+  }
+  return out;
+}
+async function walkProtoFiles(dir) {
+  const out = [];
+  async function walk3(current) {
+    const entries = await fs15.readdir(current, { withFileTypes: true }).catch(() => []);
+    for (const entry of entries) {
+      const full = path23.join(current, entry.name);
+      if (entry.isDirectory()) {
+        if (IGNORED_DIRS.has(entry.name)) continue;
+        if (await isPythonVenvDir(full)) continue;
+        await walk3(full);
+      } else if (entry.isFile() && path23.extname(entry.name) === PROTO_EXTENSION) {
+        out.push(full);
+      }
+    }
+  }
+  await walk3(dir);
+  return out;
+}
+async function addGrpcMethods(graph, services) {
+  let nodesAdded = 0;
+  let edgesAdded = 0;
+  for (const service of services) {
+    const protoPaths = await walkProtoFiles(service.dir);
+    for (const protoPath of protoPaths) {
+      if (isTestPath(protoPath)) continue;
+      const relFile = toPosix2(path23.relative(service.dir, protoPath));
+      let content;
+      try {
+        content = await fs15.readFile(protoPath, "utf8");
+      } catch (err) {
+        recordExtractionError("proto extraction", protoPath, err);
+        continue;
+      }
+      let methods;
+      try {
+        methods = grpcMethodsFromProto(content, packageOf(content));
+      } catch (err) {
+        recordExtractionError("proto extraction", protoPath, err);
+        continue;
+      }
+      if (methods.length === 0) continue;
+      for (const method of methods) {
+        const mid = grpcMethodId2(method.rpcService, method.rpcMethod);
+        if (!graph.hasNode(mid)) {
+          const node = {
+            id: mid,
+            type: NodeType10.GrpcMethodNode,
+            name: `${method.rpcService}/${method.rpcMethod}`,
+            rpcService: method.rpcService,
+            rpcMethod: method.rpcMethod,
+            path: relFile,
+            line: method.line,
+            discoveredVia: "static"
+          };
+          graph.addNode(mid, node);
+          nodesAdded++;
+        }
+        const containsId = extractedEdgeId6(service.node.id, mid, EdgeType9.CONTAINS);
+        if (!graph.hasEdge(containsId)) {
+          const edge = {
+            id: containsId,
+            source: service.node.id,
+            target: mid,
+            type: EdgeType9.CONTAINS,
+            provenance: Provenance8.EXTRACTED,
+            confidence: confidenceForExtracted6("structural"),
+            evidence: {
+              file: relFile,
+              line: method.line,
+              snippet: snippet(content, method.line)
+            }
+          };
+          graph.addEdgeWithKey(containsId, service.node.id, mid, edge);
+          edgesAdded++;
+        }
+      }
+    }
+  }
+  return { nodesAdded, edgesAdded };
+}
+
 // src/extract/calls/index.ts
 import {
-  EdgeType as EdgeType11,
-  NodeType as NodeType11,
-  Provenance as Provenance10,
-  confidenceForExtracted as confidenceForExtracted8,
+  EdgeType as EdgeType12,
+  NodeType as NodeType12,
+  Provenance as Provenance11,
+  confidenceForExtracted as confidenceForExtracted9,
   passesExtractedFloor as passesExtractedFloor3
 } from "@neat.is/types";
 
 // src/extract/calls/http.ts
-import path23 from "path";
+import path24 from "path";
 import Parser3 from "tree-sitter";
 import JavaScript3 from "tree-sitter-javascript";
 import Python2 from "tree-sitter-python";
 import {
-  EdgeType as EdgeType9,
-  Provenance as Provenance8,
-  confidenceForExtracted as confidenceForExtracted6,
+  EdgeType as EdgeType10,
+  Provenance as Provenance9,
+  confidenceForExtracted as confidenceForExtracted7,
   passesExtractedFloor
 } from "@neat.is/types";
 var STRING_LITERAL_NODE_TYPES = /* @__PURE__ */ new Set(["string_fragment", "string_content"]);
@@ -4863,7 +5054,7 @@ async function addHttpCallEdges(graph, services) {
     const seen = /* @__PURE__ */ new Set();
     for (const file of files) {
       if (isTestPath(file.path)) continue;
-      const parser = path23.extname(file.path) === ".py" ? pyParser : jsParser;
+      const parser = path24.extname(file.path) === ".py" ? pyParser : jsParser;
       let sites;
       try {
         sites = callsFromSource(file.content, parser, knownHosts);
@@ -4872,14 +5063,14 @@ async function addHttpCallEdges(graph, services) {
         continue;
       }
       if (sites.length === 0) continue;
-      const relFile = toPosix2(path23.relative(service.dir, file.path));
+      const relFile = toPosix2(path24.relative(service.dir, file.path));
       for (const site of sites) {
         const targetId = hostToNodeId.get(site.host);
         if (!targetId || targetId === service.node.id) continue;
         const dedupKey = `${relFile}|${targetId}`;
         if (seen.has(dedupKey)) continue;
         seen.add(dedupKey);
-        const confidence = confidenceForExtracted6("url-literal-service-target");
+        const confidence = confidenceForExtracted7("url-literal-service-target");
         const ev = {
           file: relFile,
           line: site.line,
@@ -4897,21 +5088,21 @@ async function addHttpCallEdges(graph, services) {
           noteExtractedDropped({
             source: fileNodeId,
             target: targetId,
-            type: EdgeType9.CALLS,
+            type: EdgeType10.CALLS,
             confidence,
             confidenceKind: "url-literal-service-target",
             evidence: ev
           });
           continue;
         }
-        const edgeId = extractedEdgeId2(fileNodeId, targetId, EdgeType9.CALLS);
+        const edgeId = extractedEdgeId2(fileNodeId, targetId, EdgeType10.CALLS);
         if (!graph.hasEdge(edgeId)) {
           const edge = {
             id: edgeId,
             source: fileNodeId,
             target: targetId,
-            type: EdgeType9.CALLS,
-            provenance: Provenance8.EXTRACTED,
+            type: EdgeType10.CALLS,
+            provenance: Provenance9.EXTRACTED,
             confidence,
             evidence: ev
           };
@@ -4925,14 +5116,14 @@ async function addHttpCallEdges(graph, services) {
 }
 
 // src/extract/calls/route-match.ts
-import path24 from "path";
+import path25 from "path";
 import Parser4 from "tree-sitter";
 import JavaScript4 from "tree-sitter-javascript";
 import {
-  EdgeType as EdgeType10,
-  NodeType as NodeType10,
-  Provenance as Provenance9,
-  confidenceForExtracted as confidenceForExtracted7,
+  EdgeType as EdgeType11,
+  NodeType as NodeType11,
+  Provenance as Provenance10,
+  confidenceForExtracted as confidenceForExtracted8,
   passesExtractedFloor as passesExtractedFloor2,
   serviceId as serviceId3
 } from "@neat.is/types";
@@ -5100,7 +5291,7 @@ function buildRouteIndex(graph) {
   const index = /* @__PURE__ */ new Map();
   graph.forEachNode((_id, attrs) => {
     const node = attrs;
-    if (node.type !== NodeType10.RouteNode) return;
+    if (node.type !== NodeType11.RouteNode) return;
     const route = attrs;
     const owner = serviceId3(route.service);
     const entry = {
@@ -5131,7 +5322,7 @@ async function addRouteCallEdges(graph, services) {
     const seen = /* @__PURE__ */ new Set();
     for (const file of files) {
       if (isTestPath(file.path)) continue;
-      if (!JS_CLIENT_EXTENSIONS.has(path24.extname(file.path))) continue;
+      if (!JS_CLIENT_EXTENSIONS.has(path25.extname(file.path))) continue;
       let sites;
       try {
         sites = clientCallSitesFromSource(file.content, jsParser, knownHosts);
@@ -5140,7 +5331,7 @@ async function addRouteCallEdges(graph, services) {
         continue;
       }
       if (sites.length === 0) continue;
-      const relFile = toPosix2(path24.relative(service.dir, file.path));
+      const relFile = toPosix2(path25.relative(service.dir, file.path));
       for (const site of sites) {
         const serverServiceId = hostToNodeId.get(site.host);
         if (!serverServiceId || serverServiceId === service.node.id) continue;
@@ -5160,7 +5351,7 @@ async function addRouteCallEdges(graph, services) {
         );
         nodesAdded += n;
         edgesAdded += e;
-        const confidence = confidenceForExtracted7("verified-call-site");
+        const confidence = confidenceForExtracted8("verified-call-site");
         const ev = {
           file: relFile,
           line: site.line,
@@ -5172,21 +5363,21 @@ async function addRouteCallEdges(graph, services) {
           noteExtractedDropped({
             source: fileNodeId,
             target: match.routeNodeId,
-            type: EdgeType10.CALLS,
+            type: EdgeType11.CALLS,
             confidence,
             confidenceKind: "verified-call-site",
             evidence: ev
           });
           continue;
         }
-        const edgeId = extractedEdgeId2(fileNodeId, match.routeNodeId, EdgeType10.CALLS);
+        const edgeId = extractedEdgeId2(fileNodeId, match.routeNodeId, EdgeType11.CALLS);
         if (!graph.hasEdge(edgeId)) {
           const edge = {
             id: edgeId,
             source: fileNodeId,
             target: match.routeNodeId,
-            type: EdgeType10.CALLS,
-            provenance: Provenance9.EXTRACTED,
+            type: EdgeType11.CALLS,
+            provenance: Provenance10.EXTRACTED,
             confidence,
             evidence: ev
           };
@@ -5200,7 +5391,7 @@ async function addRouteCallEdges(graph, services) {
 }
 
 // src/extract/calls/kafka.ts
-import path25 from "path";
+import path26 from "path";
 import { infraId as infraId2 } from "@neat.is/types";
 var PRODUCER_TOPIC_RE = /(?:producer|kafkaProducer)[\s\S]{0,40}?\.send\s*\(\s*\{[\s\S]{0,200}?topic\s*:\s*['"`]([^'"`]+)['"`]/g;
 var CONSUMER_TOPIC_RE = /(?:consumer|kafkaConsumer)[\s\S]{0,40}?\.(?:subscribe|run)\s*\(\s*\{[\s\S]{0,200}?topic[s]?\s*:\s*(?:\[\s*)?['"`]([^'"`]+)['"`]/g;
@@ -5231,7 +5422,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: path25.relative(serviceDir, file.path),
+        file: path26.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5243,7 +5434,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
 }
 
 // src/extract/calls/redis.ts
-import path26 from "path";
+import path27 from "path";
 import { infraId as infraId3 } from "@neat.is/types";
 var REDIS_URL_RE = /redis(?:s)?:\/\/(?:[^@'"`\s]+@)?([^:/'"`\s]+)(?::(\d+))?/g;
 function redisEndpointsFromFile(file, serviceDir) {
@@ -5266,7 +5457,7 @@ function redisEndpointsFromFile(file, serviceDir) {
       // support tier (ADR-066).
       confidenceKind: "url-with-structural-support",
       evidence: {
-        file: path26.relative(serviceDir, file.path),
+        file: path27.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5276,7 +5467,7 @@ function redisEndpointsFromFile(file, serviceDir) {
 }
 
 // src/extract/calls/aws.ts
-import path27 from "path";
+import path28 from "path";
 import { infraId as infraId4 } from "@neat.is/types";
 var S3_BUCKET_RE = /Bucket\s*:\s*['"`]([^'"`]+)['"`]/g;
 var DYNAMO_TABLE_RE = /TableName\s*:\s*['"`]([^'"`]+)['"`]/g;
@@ -5310,7 +5501,7 @@ function awsEndpointsFromFile(file, serviceDir) {
       // (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: path27.relative(serviceDir, file.path),
+        file: path28.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5334,7 +5525,7 @@ function awsEndpointsFromFile(file, serviceDir) {
 }
 
 // src/extract/calls/grpc.ts
-import path28 from "path";
+import path29 from "path";
 import { infraId as infraId5 } from "@neat.is/types";
 var GRPC_CLIENT_RE = /new\s+([A-Z][A-Za-z0-9_]*)Client\s*\(\s*['"`]?([^,'"`)]+)?/g;
 var AWS_SDK_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@aws-sdk\/client-([a-z0-9-]+)['"`]/g;
@@ -5393,7 +5584,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: path28.relative(serviceDir, file.path),
+        file: path29.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5403,7 +5594,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
 }
 
 // src/extract/calls/supabase.ts
-import path29 from "path";
+import path30 from "path";
 import { infraId as infraId6 } from "@neat.is/types";
 var SUPABASE_JS_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@supabase\/supabase-js['"`]/;
 var SUPABASE_SSR_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@supabase\/ssr['"`]/;
@@ -5452,7 +5643,7 @@ function supabaseEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066), the same grade aws.ts / grpc.ts emit at.
       confidenceKind: "verified-call-site",
       evidence: {
-        file: path29.relative(serviceDir, file.path),
+        file: path30.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5465,11 +5656,11 @@ function supabaseEndpointsFromFile(file, serviceDir) {
 function edgeTypeFromEndpoint(ep) {
   switch (ep.edgeType) {
     case "PUBLISHES_TO":
-      return EdgeType11.PUBLISHES_TO;
+      return EdgeType12.PUBLISHES_TO;
     case "CONSUMES_FROM":
-      return EdgeType11.CONSUMES_FROM;
+      return EdgeType12.CONSUMES_FROM;
     default:
-      return EdgeType11.CALLS;
+      return EdgeType12.CALLS;
   }
 }
 function isAwsKind(kind) {
@@ -5497,7 +5688,7 @@ async function addExternalEndpointEdges(graph, services) {
       if (!graph.hasNode(ep.infraId)) {
         const node = {
           id: ep.infraId,
-          type: NodeType11.InfraNode,
+          type: NodeType12.InfraNode,
           name: ep.name,
           // #238 — `aws-*` covers AWS-SDK client kinds (aws-s3, aws-dynamodb,
           // aws-cognito-identity-provider, …); `s3-` / `dynamodb-` cover the
@@ -5509,7 +5700,7 @@ async function addExternalEndpointEdges(graph, services) {
         nodesAdded++;
       }
       const edgeType = edgeTypeFromEndpoint(ep);
-      const confidence = confidenceForExtracted8(ep.confidenceKind);
+      const confidence = confidenceForExtracted9(ep.confidenceKind);
       const relFile = toPosix2(ep.evidence.file);
       const { fileNodeId, nodesAdded: n, edgesAdded: e } = ensureFileNode(
         graph,
@@ -5539,7 +5730,7 @@ async function addExternalEndpointEdges(graph, services) {
           source: fileNodeId,
           target: ep.infraId,
           type: edgeType,
-          provenance: Provenance10.EXTRACTED,
+          provenance: Provenance11.EXTRACTED,
           confidence,
           evidence: ep.evidence
         };
@@ -5561,15 +5752,15 @@ async function addCallEdges(graph, services) {
 }
 
 // src/extract/infra/docker-compose.ts
-import path30 from "path";
-import { EdgeType as EdgeType12, Provenance as Provenance11, confidenceForExtracted as confidenceForExtracted9 } from "@neat.is/types";
+import path31 from "path";
+import { EdgeType as EdgeType13, Provenance as Provenance12, confidenceForExtracted as confidenceForExtracted10 } from "@neat.is/types";
 
 // src/extract/infra/shared.ts
-import { NodeType as NodeType12, infraId as infraId7 } from "@neat.is/types";
+import { NodeType as NodeType13, infraId as infraId7 } from "@neat.is/types";
 function makeInfraNode(kind, name, provider = "self", extras) {
   return {
     id: infraId7(kind, name),
-    type: NodeType12.InfraNode,
+    type: NodeType13.InfraNode,
     name,
     provider,
     kind,
@@ -5598,7 +5789,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || path30.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || path31.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -5607,7 +5798,7 @@ async function addComposeInfra(graph, scanPath, services) {
   let edgesAdded = 0;
   let composePath = null;
   for (const name of ["docker-compose.yml", "docker-compose.yaml"]) {
-    const abs = path30.join(scanPath, name);
+    const abs = path31.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
@@ -5620,13 +5811,13 @@ async function addComposeInfra(graph, scanPath, services) {
   } catch (err) {
     recordExtractionError(
       "infra docker-compose",
-      path30.relative(scanPath, composePath),
+      path31.relative(scanPath, composePath),
       err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = path30.relative(scanPath, composePath).split(path30.sep).join("/");
+  const evidenceFile = path31.relative(scanPath, composePath).split(path31.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -5648,15 +5839,15 @@ async function addComposeInfra(graph, scanPath, services) {
     for (const dep of dependsOnList(svc.depends_on)) {
       const targetId = composeNameToNodeId.get(dep);
       if (!targetId) continue;
-      const edgeId = extractedEdgeId2(sourceId, targetId, EdgeType12.DEPENDS_ON);
+      const edgeId = extractedEdgeId2(sourceId, targetId, EdgeType13.DEPENDS_ON);
       if (graph.hasEdge(edgeId)) continue;
       const edge = {
         id: edgeId,
         source: sourceId,
         target: targetId,
-        type: EdgeType12.DEPENDS_ON,
-        provenance: Provenance11.EXTRACTED,
-        confidence: confidenceForExtracted9("structural"),
+        type: EdgeType13.DEPENDS_ON,
+        provenance: Provenance12.EXTRACTED,
+        confidence: confidenceForExtracted10("structural"),
         evidence: { file: evidenceFile }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -5667,9 +5858,9 @@ async function addComposeInfra(graph, scanPath, services) {
 }
 
 // src/extract/infra/dockerfile.ts
-import path31 from "path";
-import { promises as fs15 } from "fs";
-import { EdgeType as EdgeType13, Provenance as Provenance12, confidenceForExtracted as confidenceForExtracted10 } from "@neat.is/types";
+import path32 from "path";
+import { promises as fs16 } from "fs";
+import { EdgeType as EdgeType14, Provenance as Provenance13, confidenceForExtracted as confidenceForExtracted11 } from "@neat.is/types";
 function readDockerfile(content) {
   let image = null;
   const ports = [];
@@ -5698,15 +5889,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = path31.join(service.dir, "Dockerfile");
+    const dockerfilePath = path32.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
     let content;
     try {
-      content = await fs15.readFile(dockerfilePath, "utf8");
+      content = await fs16.readFile(dockerfilePath, "utf8");
     } catch (err) {
       recordExtractionError(
         "infra dockerfile",
-        path31.relative(scanPath, dockerfilePath),
+        path32.relative(scanPath, dockerfilePath),
         err
       );
       continue;
@@ -5718,8 +5909,8 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const relDockerfile = toPosix2(path31.relative(service.dir, dockerfilePath));
-    const evidenceFile = toPosix2(path31.relative(scanPath, dockerfilePath));
+    const relDockerfile = toPosix2(path32.relative(service.dir, dockerfilePath));
+    const evidenceFile = toPosix2(path32.relative(scanPath, dockerfilePath));
     const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
       graph,
       service.pkg.name,
@@ -5728,15 +5919,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     );
     nodesAdded += fn;
     edgesAdded += fe;
-    const edgeId = extractedEdgeId2(fileNodeId, node.id, EdgeType13.RUNS_ON);
+    const edgeId = extractedEdgeId2(fileNodeId, node.id, EdgeType14.RUNS_ON);
     if (!graph.hasEdge(edgeId)) {
       const edge = {
         id: edgeId,
         source: fileNodeId,
         target: node.id,
-        type: EdgeType13.RUNS_ON,
-        provenance: Provenance12.EXTRACTED,
-        confidence: confidenceForExtracted10("structural"),
+        type: EdgeType14.RUNS_ON,
+        provenance: Provenance13.EXTRACTED,
+        confidence: confidenceForExtracted11("structural"),
         evidence: {
           file: evidenceFile,
           ...facts.entrypoint ? { snippet: facts.entrypoint.slice(0, 120) } : {}
@@ -5751,15 +5942,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
         graph.addNode(portNode.id, portNode);
         nodesAdded++;
       }
-      const portEdgeId = extractedEdgeId2(fileNodeId, portNode.id, EdgeType13.CONNECTS_TO);
+      const portEdgeId = extractedEdgeId2(fileNodeId, portNode.id, EdgeType14.CONNECTS_TO);
       if (graph.hasEdge(portEdgeId)) continue;
       const portEdge = {
         id: portEdgeId,
         source: fileNodeId,
         target: portNode.id,
-        type: EdgeType13.CONNECTS_TO,
-        provenance: Provenance12.EXTRACTED,
-        confidence: confidenceForExtracted10("structural"),
+        type: EdgeType14.CONNECTS_TO,
+        provenance: Provenance13.EXTRACTED,
+        confidence: confidenceForExtracted11("structural"),
         evidence: { file: evidenceFile, snippet: `EXPOSE ${port}` }
       };
       graph.addEdgeWithKey(portEdgeId, portEdge.source, portEdge.target, portEdge);
@@ -5770,23 +5961,23 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 }
 
 // src/extract/infra/terraform.ts
-import { promises as fs16 } from "fs";
-import path32 from "path";
-import { EdgeType as EdgeType14, Provenance as Provenance13, confidenceForExtracted as confidenceForExtracted11 } from "@neat.is/types";
+import { promises as fs17 } from "fs";
+import path33 from "path";
+import { EdgeType as EdgeType15, Provenance as Provenance14, confidenceForExtracted as confidenceForExtracted12 } from "@neat.is/types";
 var RESOURCE_RE = /resource\s+"(aws_[A-Za-z0-9_]+)"\s+"([A-Za-z0-9_-]+)"/g;
 var REFERENCE_RE = /(?<![\w.])(aws_[A-Za-z0-9_]+)\.([A-Za-z0-9_-]+)/g;
 async function walkTfFiles(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await fs16.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await fs17.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name) || entry.name === ".terraform") continue;
-      const child = path32.join(start, entry.name);
+      const child = path33.join(start, entry.name);
       if (await isPythonVenvDir(child)) continue;
       out.push(...await walkTfFiles(child, depth + 1, max));
     } else if (entry.isFile() && entry.name.endsWith(".tf")) {
-      out.push(path32.join(start, entry.name));
+      out.push(path33.join(start, entry.name));
     }
   }
   return out;
@@ -5805,7 +5996,7 @@ function blockBody(content, from) {
   }
   return null;
 }
-function lineAt(content, index) {
+function lineAt2(content, index) {
   let line = 1;
   for (let i = 0; i < index && i < content.length; i++) {
     if (content[i] === "\n") line++;
@@ -5817,8 +6008,8 @@ async function addTerraformResources(graph, scanPath) {
   let edgesAdded = 0;
   const files = await walkTfFiles(scanPath);
   for (const file of files) {
-    const content = await fs16.readFile(file, "utf8");
-    const evidenceFile = toPosix2(path32.relative(scanPath, file));
+    const content = await fs17.readFile(file, "utf8");
+    const evidenceFile = toPosix2(path33.relative(scanPath, file));
     const resources = [];
     const byKey = /* @__PURE__ */ new Map();
     RESOURCE_RE.lastIndex = 0;
@@ -5853,16 +6044,16 @@ async function addTerraformResources(graph, scanPath) {
         if (!target) continue;
         if (seen.has(target.nodeId)) continue;
         seen.add(target.nodeId);
-        const edgeId = extractedEdgeId2(resource.nodeId, target.nodeId, EdgeType14.DEPENDS_ON);
+        const edgeId = extractedEdgeId2(resource.nodeId, target.nodeId, EdgeType15.DEPENDS_ON);
         if (graph.hasEdge(edgeId)) continue;
-        const line = lineAt(content, resource.bodyOffset + ref.index);
+        const line = lineAt2(content, resource.bodyOffset + ref.index);
         const edge = {
           id: edgeId,
           source: resource.nodeId,
           target: target.nodeId,
-          type: EdgeType14.DEPENDS_ON,
-          provenance: Provenance13.EXTRACTED,
-          confidence: confidenceForExtracted11("structural"),
+          type: EdgeType15.DEPENDS_ON,
+          provenance: Provenance14.EXTRACTED,
+          confidence: confidenceForExtracted12("structural"),
           evidence: { file: evidenceFile, line, snippet: key }
         };
         graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -5874,8 +6065,8 @@ async function addTerraformResources(graph, scanPath) {
 }
 
 // src/extract/infra/k8s.ts
-import { promises as fs17 } from "fs";
-import path33 from "path";
+import { promises as fs18 } from "fs";
+import path34 from "path";
 import { parseAllDocuments as parseAllDocuments2 } from "yaml";
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -5889,15 +6080,15 @@ var K8S_KIND_TO_INFRA_KIND = {
 async function walkYamlFiles2(start, depth = 0, max = 5) {
   if (depth > max) return [];
   const out = [];
-  const entries = await fs17.readdir(start, { withFileTypes: true }).catch(() => []);
+  const entries = await fs18.readdir(start, { withFileTypes: true }).catch(() => []);
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name)) continue;
-      const child = path33.join(start, entry.name);
+      const child = path34.join(start, entry.name);
       if (await isPythonVenvDir(child)) continue;
       out.push(...await walkYamlFiles2(child, depth + 1, max));
-    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(path33.extname(entry.name))) {
-      out.push(path33.join(start, entry.name));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(path34.extname(entry.name))) {
+      out.push(path34.join(start, entry.name));
     }
   }
   return out;
@@ -5906,7 +6097,7 @@ async function addK8sResources(graph, scanPath) {
   let nodesAdded = 0;
   const files = await walkYamlFiles2(scanPath);
   for (const file of files) {
-    const content = await fs17.readFile(file, "utf8");
+    const content = await fs18.readFile(file, "utf8");
     let docs;
     try {
       docs = parseAllDocuments2(content).map((d) => d.toJSON());
@@ -5941,16 +6132,16 @@ async function addInfra(graph, scanPath, services) {
 }
 
 // src/extract/index.ts
-import path35 from "path";
+import path36 from "path";
 
 // src/extract/retire.ts
 import { existsSync as existsSync2 } from "fs";
-import path34 from "path";
-import { NodeType as NodeType13, Provenance as Provenance14 } from "@neat.is/types";
+import path35 from "path";
+import { NodeType as NodeType14, Provenance as Provenance15 } from "@neat.is/types";
 function dropOrphanedFileNodes(graph) {
   const orphans = [];
   graph.forEachNode((id, attrs) => {
-    if (attrs.type !== NodeType13.FileNode) return;
+    if (attrs.type !== NodeType14.FileNode) return;
     if (graph.inboundEdges(id).length === 0 && graph.outboundEdges(id).length === 0) {
       orphans.push(id);
     }
@@ -5963,7 +6154,7 @@ function retireEdgesByFile(graph, file) {
   const toDrop = [];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== Provenance14.EXTRACTED) return;
+    if (edge.provenance !== Provenance15.EXTRACTED) return;
     if (!edge.evidence?.file) return;
     if (edge.evidence.file === normalized) toDrop.push(id);
   });
@@ -5976,14 +6167,14 @@ function retireExtractedEdgesByMissingFile(graph, scanPath, serviceDirs = []) {
   const bases = [scanPath, ...serviceDirs];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== Provenance14.EXTRACTED) return;
+    if (edge.provenance !== Provenance15.EXTRACTED) return;
     const evidenceFile = edge.evidence?.file;
     if (!evidenceFile) return;
-    if (path34.isAbsolute(evidenceFile)) {
+    if (path35.isAbsolute(evidenceFile)) {
       if (!existsSync2(evidenceFile)) toDrop.push(id);
       return;
     }
-    const found = bases.some((base) => existsSync2(path34.join(base, evidenceFile)));
+    const found = bases.some((base) => existsSync2(path35.join(base, evidenceFile)));
     if (!found) toDrop.push(id);
   });
   for (const id of toDrop) graph.dropEdge(id);
@@ -6003,6 +6194,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   const phase2 = await addDatabasesAndCompat(graph, services, scanPath);
   const phase3 = await addConfigNodes(graph, services, scanPath);
   const routePhase = await addRoutes(graph, services);
+  const grpcPhase = await addGrpcMethods(graph, services);
   const phase4 = await addCallEdges(graph, services);
   const phase5 = await addInfra(graph, scanPath, services);
   const ghostsRetired = retireExtractedEdgesByMissingFile(
@@ -6024,7 +6216,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
-    const rejectedPath = path35.join(path35.dirname(opts.errorsPath), "rejected.ndjson");
+    const rejectedPath = path36.join(path36.dirname(opts.errorsPath), "rejected.ndjson");
     try {
       await writeRejectedExtracted(droppedEntries, rejectedPath);
     } catch (err) {
@@ -6034,8 +6226,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
     }
   }
   const result = {
-    nodesAdded: phase1Nodes + fileEnum.nodesAdded + importGraph.nodesAdded + phase2.nodesAdded + phase3.nodesAdded + routePhase.nodesAdded + phase4.nodesAdded + phase5.nodesAdded,
-    edgesAdded: fileEnum.edgesAdded + importGraph.edgesAdded + phase2.edgesAdded + phase3.edgesAdded + routePhase.edgesAdded + phase4.edgesAdded + phase5.edgesAdded,
+    nodesAdded: phase1Nodes + fileEnum.nodesAdded + importGraph.nodesAdded + phase2.nodesAdded + phase3.nodesAdded + routePhase.nodesAdded + grpcPhase.nodesAdded + phase4.nodesAdded + phase5.nodesAdded,
+    edgesAdded: fileEnum.edgesAdded + importGraph.edgesAdded + phase2.edgesAdded + phase3.edgesAdded + routePhase.edgesAdded + grpcPhase.edgesAdded + phase4.edgesAdded + phase5.edgesAdded,
     frontiersPromoted,
     extractionErrors: errorEntries.length,
     errorEntries,
@@ -6060,10 +6252,10 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
 import {
   databaseId as databaseId3,
   DivergenceResultSchema,
-  EdgeType as EdgeType15,
-  NodeType as NodeType14,
+  EdgeType as EdgeType16,
+  NodeType as NodeType15,
   parseEdgeId,
-  Provenance as Provenance15
+  Provenance as Provenance16
 } from "@neat.is/types";
 function bucketKey(source, target, type) {
   return `${type}|${source}|${target}`;
@@ -6077,17 +6269,17 @@ function bucketEdges(graph) {
     const key = bucketKey(e.source, e.target, e.type);
     const cur = buckets.get(key) ?? { source: e.source, target: e.target, type: e.type };
     switch (provenance) {
-      case Provenance15.EXTRACTED:
+      case Provenance16.EXTRACTED:
         cur.extracted = e;
         break;
-      case Provenance15.OBSERVED:
+      case Provenance16.OBSERVED:
         cur.observed = e;
         break;
-      case Provenance15.INFERRED:
+      case Provenance16.INFERRED:
         cur.inferred = e;
         break;
       default:
-        if (e.provenance === Provenance15.STALE) cur.stale = e;
+        if (e.provenance === Provenance16.STALE) cur.stale = e;
     }
     buckets.set(key, cur);
   });
@@ -6096,7 +6288,12 @@ function bucketEdges(graph) {
 function nodeIsFrontier(graph, nodeId) {
   if (!graph.hasNode(nodeId)) return false;
   const attrs = graph.getNodeAttributes(nodeId);
-  return attrs.type === NodeType14.FrontierNode;
+  return attrs.type === NodeType15.FrontierNode;
+}
+function nodeIsWebsocketChannel(graph, nodeId) {
+  if (!graph.hasNode(nodeId)) return false;
+  const attrs = graph.getNodeAttributes(nodeId);
+  return attrs.type === NodeType15.WebSocketChannelNode;
 }
 function clampConfidence(n) {
   if (!Number.isFinite(n)) return 0;
@@ -6116,14 +6313,14 @@ function gradedConfidence(edge) {
   return clampConfidence(confidenceForEdge(edge));
 }
 var OBSERVABLE_EDGE_TYPES = /* @__PURE__ */ new Set([
-  EdgeType15.CALLS,
-  EdgeType15.CONNECTS_TO,
-  EdgeType15.PUBLISHES_TO,
-  EdgeType15.CONSUMES_FROM
+  EdgeType16.CALLS,
+  EdgeType16.CONNECTS_TO,
+  EdgeType16.PUBLISHES_TO,
+  EdgeType16.CONSUMES_FROM
 ]);
 function detectMissingDivergences(graph, bucket) {
   const out = [];
-  if (bucket.type === EdgeType15.CONTAINS) return out;
+  if (bucket.type === EdgeType16.CONTAINS) return out;
   if (bucket.extracted && !bucket.observed && OBSERVABLE_EDGE_TYPES.has(bucket.type)) {
     if (!nodeIsFrontier(graph, bucket.target)) {
       out.push({
@@ -6138,7 +6335,7 @@ function detectMissingDivergences(graph, bucket) {
       });
     }
   }
-  if (bucket.observed && !bucket.extracted) {
+  if (bucket.observed && !bucket.extracted && !nodeIsWebsocketChannel(graph, bucket.target)) {
     out.push({
       type: "missing-extracted",
       source: bucket.source,
@@ -6164,7 +6361,7 @@ function declaredHostFor(svc) {
 function hasExtractedConfiguredBy(graph, svcId) {
   for (const edgeId of graph.outboundEdges(svcId)) {
     const e = graph.getEdgeAttributes(edgeId);
-    if (e.type === EdgeType15.CONFIGURED_BY && e.provenance === Provenance15.EXTRACTED) {
+    if (e.type === EdgeType16.CONFIGURED_BY && e.provenance === Provenance16.EXTRACTED) {
       return true;
     }
   }
@@ -6177,10 +6374,10 @@ function detectHostMismatch(graph, svcId, svc) {
   const out = [];
   for (const edgeId of graph.outboundEdges(svcId)) {
     const edge = graph.getEdgeAttributes(edgeId);
-    if (edge.type !== EdgeType15.CONNECTS_TO) continue;
-    if (edge.provenance !== Provenance15.OBSERVED) continue;
+    if (edge.type !== EdgeType16.CONNECTS_TO) continue;
+    if (edge.provenance !== Provenance16.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== NodeType14.DatabaseNode) continue;
+    if (target.type !== NodeType15.DatabaseNode) continue;
     const observedHost = target.host?.trim();
     if (!observedHost) continue;
     if (observedHost === declaredHost) continue;
@@ -6202,10 +6399,10 @@ function detectCompatDivergences(graph, svcId, svc) {
   const deps = svc.dependencies ?? {};
   for (const edgeId of graph.outboundEdges(svcId)) {
     const edge = graph.getEdgeAttributes(edgeId);
-    if (edge.type !== EdgeType15.CONNECTS_TO) continue;
-    if (edge.provenance !== Provenance15.OBSERVED) continue;
+    if (edge.type !== EdgeType16.CONNECTS_TO) continue;
+    if (edge.provenance !== Provenance16.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== NodeType14.DatabaseNode) continue;
+    if (target.type !== NodeType15.DatabaseNode) continue;
     for (const pair of compatPairs()) {
       if (pair.engine !== target.engine) continue;
       const declared = deps[pair.driver];
@@ -6283,7 +6480,7 @@ function computeDivergences(graph, opts = {}) {
   }
   graph.forEachNode((nodeId, attrs) => {
     const n = attrs;
-    if (n.type !== NodeType14.ServiceNode) return;
+    if (n.type !== NodeType15.ServiceNode) return;
     const svc = n;
     for (const d of detectHostMismatch(graph, nodeId, svc)) all.push(d);
     for (const d of detectCompatDivergences(graph, nodeId, svc)) all.push(d);
@@ -6325,9 +6522,9 @@ function computeDivergences(graph, opts = {}) {
 }
 
 // src/persist.ts
-import { promises as fs18 } from "fs";
-import path36 from "path";
-import { Provenance as Provenance16, observedEdgeId as observedEdgeId2 } from "@neat.is/types";
+import { promises as fs19 } from "fs";
+import path37 from "path";
+import { Provenance as Provenance17, observedEdgeId as observedEdgeId2 } from "@neat.is/types";
 var SCHEMA_VERSION = 4;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -6349,7 +6546,7 @@ function migrateV2ToV3(payload) {
     for (const edge of edges) {
       const attrs = edge.attributes;
       if (!attrs || attrs.provenance !== "FRONTIER") continue;
-      attrs.provenance = Provenance16.OBSERVED;
+      attrs.provenance = Provenance17.OBSERVED;
       const type = typeof attrs.type === "string" ? attrs.type : void 0;
       const source = typeof attrs.source === "string" ? attrs.source : void 0;
       const target = typeof attrs.target === "string" ? attrs.target : void 0;
@@ -6363,7 +6560,7 @@ function migrateV2ToV3(payload) {
   return { ...payload, schemaVersion: 3 };
 }
 async function ensureDir(filePath) {
-  await fs18.mkdir(path36.dirname(filePath), { recursive: true });
+  await fs19.mkdir(path37.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -6373,13 +6570,13 @@ async function saveGraphToDisk(graph, outPath) {
     graph: graph.export()
   };
   const tmp = `${outPath}.tmp`;
-  await fs18.writeFile(tmp, JSON.stringify(payload), "utf8");
-  await fs18.rename(tmp, outPath);
+  await fs19.writeFile(tmp, JSON.stringify(payload), "utf8");
+  await fs19.rename(tmp, outPath);
 }
 async function loadGraphFromDisk(graph, outPath) {
   let raw;
   try {
-    raw = await fs18.readFile(outPath, "utf8");
+    raw = await fs19.readFile(outPath, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") return;
     throw err;
@@ -6443,7 +6640,7 @@ function startPersistLoop(graph, outPath, opts = {}) {
 }
 
 // src/diff.ts
-import { promises as fs19 } from "fs";
+import { promises as fs20 } from "fs";
 async function loadSnapshotForDiff(target) {
   if (/^https?:\/\//i.test(target)) {
     const res = await fetch(target);
@@ -6452,7 +6649,7 @@ async function loadSnapshotForDiff(target) {
     }
     return await res.json();
   }
-  const raw = await fs19.readFile(target, "utf8");
+  const raw = await fs20.readFile(target, "utf8");
   return JSON.parse(raw);
 }
 function indexEntries(entries) {
@@ -6519,23 +6716,23 @@ function canonicalJson(value) {
 }
 
 // src/projects.ts
-import path37 from "path";
+import path38 from "path";
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: path37.join(baseDir, "graph.json"),
-      errorsPath: path37.join(baseDir, "errors.ndjson"),
-      staleEventsPath: path37.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: path37.join(baseDir, "embeddings.json"),
-      policyViolationsPath: path37.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: path38.join(baseDir, "graph.json"),
+      errorsPath: path38.join(baseDir, "errors.ndjson"),
+      staleEventsPath: path38.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: path38.join(baseDir, "embeddings.json"),
+      policyViolationsPath: path38.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: path37.join(baseDir, `${project}.json`),
-    errorsPath: path37.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: path37.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: path37.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: path37.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: path38.join(baseDir, `${project}.json`),
+    errorsPath: path38.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: path38.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: path38.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: path38.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -6574,9 +6771,9 @@ function parseExtraProjects(raw) {
 }
 
 // src/registry.ts
-import { promises as fs20 } from "fs";
+import { promises as fs21 } from "fs";
 import os2 from "os";
-import path38 from "path";
+import path39 from "path";
 import {
   RegistryFileSchema
 } from "@neat.is/types";
@@ -6584,20 +6781,20 @@ var LOCK_TIMEOUT_MS = 5e3;
 var LOCK_RETRY_MS = 50;
 function neatHome() {
   const override = process.env.NEAT_HOME;
-  if (override && override.length > 0) return path38.resolve(override);
-  return path38.join(os2.homedir(), ".neat");
+  if (override && override.length > 0) return path39.resolve(override);
+  return path39.join(os2.homedir(), ".neat");
 }
 function registryPath() {
-  return path38.join(neatHome(), "projects.json");
+  return path39.join(neatHome(), "projects.json");
 }
 function registryLockPath() {
-  return path38.join(neatHome(), "projects.json.lock");
+  return path39.join(neatHome(), "projects.json.lock");
 }
 function daemonPidPath() {
-  return path38.join(neatHome(), "neatd.pid");
+  return path39.join(neatHome(), "neatd.pid");
 }
 function daemonsDir() {
-  return path38.join(neatHome(), "daemons");
+  return path39.join(neatHome(), "daemons");
 }
 function isFiniteInt(v) {
   return typeof v === "number" && Number.isFinite(v);
@@ -6630,7 +6827,7 @@ async function discoverDaemons(probe = defaultDiscoveryProbe) {
   const dir = daemonsDir();
   let names;
   try {
-    names = await fs20.readdir(dir);
+    names = await fs21.readdir(dir);
   } catch (err) {
     if (err.code === "ENOENT") return [];
     throw err;
@@ -6638,10 +6835,10 @@ async function discoverDaemons(probe = defaultDiscoveryProbe) {
   const out = [];
   for (const name of names) {
     if (!name.endsWith(".json")) continue;
-    const file = path38.join(dir, name);
+    const file = path39.join(dir, name);
     let raw;
     try {
-      raw = await fs20.readFile(file, "utf8");
+      raw = await fs21.readFile(file, "utf8");
     } catch {
       continue;
     }
@@ -6654,7 +6851,7 @@ async function discoverDaemons(probe = defaultDiscoveryProbe) {
   return out;
 }
 async function removeDaemonRecord(source) {
-  await fs20.unlink(source).catch(() => {
+  await fs21.unlink(source).catch(() => {
   });
 }
 async function listMachineProjects(probe = defaultDiscoveryProbe) {
@@ -6711,7 +6908,7 @@ function isPidAliveDefault(pid) {
 }
 async function readPidFile(file) {
   try {
-    const raw = await fs20.readFile(file, "utf8");
+    const raw = await fs21.readFile(file, "utf8");
     const pid = Number.parseInt(raw.trim(), 10);
     return Number.isInteger(pid) && pid > 0 ? pid : void 0;
   } catch {
@@ -6759,32 +6956,32 @@ function lockHolderMessage(holder, lockPath, timeoutMs) {
   }
 }
 async function normalizeProjectPath(input) {
-  const resolved = path38.resolve(input);
+  const resolved = path39.resolve(input);
   try {
-    return await fs20.realpath(resolved);
+    return await fs21.realpath(resolved);
   } catch {
     return resolved;
   }
 }
 async function writeAtomically(target, contents) {
-  await fs20.mkdir(path38.dirname(target), { recursive: true });
+  await fs21.mkdir(path39.dirname(target), { recursive: true });
   const tmp = `${target}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}.tmp`;
-  const fd = await fs20.open(tmp, "w");
+  const fd = await fs21.open(tmp, "w");
   try {
     await fd.writeFile(contents, "utf8");
     await fd.sync();
   } finally {
     await fd.close();
   }
-  await fs20.rename(tmp, target);
+  await fs21.rename(tmp, target);
 }
 async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS, probe = defaultLockHolderProbe) {
   const deadline = Date.now() + timeoutMs;
-  await fs20.mkdir(path38.dirname(lockPath), { recursive: true });
+  await fs21.mkdir(path39.dirname(lockPath), { recursive: true });
   let probedHolder = false;
   while (true) {
     try {
-      const fd = await fs20.open(lockPath, "wx");
+      const fd = await fs21.open(lockPath, "wx");
       try {
         await fd.writeFile(`${process.pid}
 `, "utf8");
@@ -6809,7 +7006,7 @@ async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS, probe = defaul
   }
 }
 async function releaseLock(lockPath) {
-  await fs20.unlink(lockPath).catch(() => {
+  await fs21.unlink(lockPath).catch(() => {
   });
 }
 async function withLock(fn) {
@@ -6825,7 +7022,7 @@ async function readRegistry() {
   const file = registryPath();
   let raw;
   try {
-    raw = await fs20.readFile(file, "utf8");
+    raw = await fs21.readFile(file, "utf8");
   } catch (err) {
     if (err.code === "ENOENT") {
       return { version: 1, projects: [] };
@@ -6930,7 +7127,7 @@ function pruneTtlMs() {
 }
 async function statPathStatus(p) {
   try {
-    const stat = await fs20.stat(p);
+    const stat = await fs21.stat(p);
     return stat.isDirectory() ? "present" : "unknown";
   } catch (err) {
     return err.code === "ENOENT" ? "gone" : "unknown";
@@ -6975,14 +7172,14 @@ import cors from "@fastify/cors";
 import { DivergenceTypeSchema, PoliciesCheckBodySchema, PolicySeveritySchema } from "@neat.is/types";
 
 // src/extend/index.ts
-import { promises as fs22 } from "fs";
-import path40 from "path";
+import { promises as fs23 } from "fs";
+import path41 from "path";
 import os3 from "os";
 import { resolve as registryResolve, list as registryList } from "@neat.is/instrumentation-registry";
 
 // src/installers/package-manager.ts
-import { promises as fs21 } from "fs";
-import path39 from "path";
+import { promises as fs22 } from "fs";
+import path40 from "path";
 import { spawn } from "child_process";
 var LOCKFILE_PRIORITY = [
   { lockfile: "bun.lockb", pm: "bun", args: ["install", "--no-summary"] },
@@ -6997,29 +7194,29 @@ var LOCKFILE_PRIORITY = [
 var NPM_FALLBACK_ARGS = ["install", "--no-audit", "--no-fund", "--prefer-offline"];
 async function exists2(p) {
   try {
-    await fs21.access(p);
+    await fs22.access(p);
     return true;
   } catch {
     return false;
   }
 }
 async function detectPackageManager(serviceDir) {
-  let dir = path39.resolve(serviceDir);
+  let dir = path40.resolve(serviceDir);
   const stops = /* @__PURE__ */ new Set();
   for (let i = 0; i < 64; i++) {
     if (stops.has(dir)) break;
     stops.add(dir);
     for (const candidate of LOCKFILE_PRIORITY) {
-      const lockPath = path39.join(dir, candidate.lockfile);
+      const lockPath = path40.join(dir, candidate.lockfile);
       if (await exists2(lockPath)) {
         return { pm: candidate.pm, cwd: dir, args: [...candidate.args] };
       }
     }
-    const parent = path39.dirname(dir);
+    const parent = path40.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return { pm: "npm", cwd: path39.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
+  return { pm: "npm", cwd: path40.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
 }
 async function runPackageManagerInstall(cmd) {
   return new Promise((resolve) => {
@@ -7061,30 +7258,30 @@ ${err.message}`
 // src/extend/index.ts
 async function fileExists2(p) {
   try {
-    await fs22.access(p);
+    await fs23.access(p);
     return true;
   } catch {
     return false;
   }
 }
 async function readPackageJson(scanPath) {
-  const pkgPath = path40.join(scanPath, "package.json");
-  const raw = await fs22.readFile(pkgPath, "utf8");
+  const pkgPath = path41.join(scanPath, "package.json");
+  const raw = await fs23.readFile(pkgPath, "utf8");
   return JSON.parse(raw);
 }
 async function findHookFiles(scanPath) {
-  const entries = await fs22.readdir(scanPath);
+  const entries = await fs23.readdir(scanPath);
   return entries.filter(
     (e) => (e.startsWith("instrumentation") || e.startsWith("otel-init")) && /\.(ts|js)$/.test(e)
   ).sort();
 }
 function extendLogPath() {
-  return process.env.NEAT_EXTEND_LOG ?? path40.join(os3.homedir(), ".neat", "extend-log.ndjson");
+  return process.env.NEAT_EXTEND_LOG ?? path41.join(os3.homedir(), ".neat", "extend-log.ndjson");
 }
 async function appendExtendLog(entry) {
   const logPath = extendLogPath();
-  await fs22.mkdir(path40.dirname(logPath), { recursive: true });
-  await fs22.appendFile(logPath, JSON.stringify(entry) + "\n", "utf8");
+  await fs23.mkdir(path41.dirname(logPath), { recursive: true });
+  await fs23.appendFile(logPath, JSON.stringify(entry) + "\n", "utf8");
 }
 function splicedContent(fileContent, snippet2) {
   if (fileContent.includes("__INSTRUMENTATION_BLOCK__")) {
@@ -7142,7 +7339,7 @@ function lookupInstrumentation(library, installedVersion) {
 }
 async function describeProjectInstrumentation(ctx) {
   const hookFiles = await findHookFiles(ctx.scanPath);
-  const envNeat = await fileExists2(path40.join(ctx.scanPath, ".env.neat"));
+  const envNeat = await fileExists2(path41.join(ctx.scanPath, ".env.neat"));
   const registryInstrPackages = new Set(
     registryList().map((e) => e.instrumentation_package).filter((p) => !!p)
   );
@@ -7164,31 +7361,31 @@ async function applyExtension(ctx, args, options) {
     );
   }
   for (const file of hookFiles) {
-    const content = await fs22.readFile(path40.join(ctx.scanPath, file), "utf8");
+    const content = await fs23.readFile(path41.join(ctx.scanPath, file), "utf8");
     if (content.includes(args.registration_snippet)) {
       return { library: args.library, filesTouched: [], depsAdded: [], installOutput: "", alreadyApplied: true };
     }
   }
   const primaryFile = hookFiles[0];
-  const primaryPath = path40.join(ctx.scanPath, primaryFile);
+  const primaryPath = path41.join(ctx.scanPath, primaryFile);
   const filesTouched = [];
   const depsAdded = [];
-  const pkgPath = path40.join(ctx.scanPath, "package.json");
+  const pkgPath = path41.join(ctx.scanPath, "package.json");
   const pkg = await readPackageJson(ctx.scanPath);
   if (!(pkg.dependencies ?? {})[args.instrumentation_package]) {
     pkg.dependencies = { ...pkg.dependencies ?? {}, [args.instrumentation_package]: args.version };
-    await fs22.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
+    await fs23.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
     filesTouched.push("package.json");
     depsAdded.push(`${args.instrumentation_package}@${args.version}`);
   }
-  const hookContent = await fs22.readFile(primaryPath, "utf8");
+  const hookContent = await fs23.readFile(primaryPath, "utf8");
   const patched = splicedContent(hookContent, args.registration_snippet);
   if (!patched) {
     throw new Error(
       `Could not find instrumentation insertion point in ${primaryFile}. Expected __INSTRUMENTATION_BLOCK__, instrumentations.push(, or new NodeSDK(.`
     );
   }
-  await fs22.writeFile(primaryPath, patched, "utf8");
+  await fs23.writeFile(primaryPath, patched, "utf8");
   filesTouched.push(primaryFile);
   const cmd = await detectPackageManager(ctx.scanPath);
   const installer = options?.runInstall ?? runPackageManagerInstall;
@@ -7219,7 +7416,7 @@ async function dryRunExtension(ctx, args) {
     };
   }
   for (const file of hookFiles) {
-    const content = await fs22.readFile(path40.join(ctx.scanPath, file), "utf8");
+    const content = await fs23.readFile(path41.join(ctx.scanPath, file), "utf8");
     if (content.includes(args.registration_snippet)) {
       return {
         library: args.library,
@@ -7241,7 +7438,7 @@ async function dryRunExtension(ctx, args) {
     depsToAdd.push(`${args.instrumentation_package}@${args.version}`);
     filesTouched.push("package.json");
   }
-  const hookContent = await fs22.readFile(path40.join(ctx.scanPath, primaryFile), "utf8");
+  const hookContent = await fs23.readFile(path41.join(ctx.scanPath, primaryFile), "utf8");
   const patched = splicedContent(hookContent, args.registration_snippet);
   if (patched) {
     filesTouched.push(primaryFile);
@@ -7256,28 +7453,28 @@ async function rollbackExtension(ctx, args) {
   if (!await fileExists2(logPath)) {
     return { undone: false, message: "no apply found for library" };
   }
-  const raw = await fs22.readFile(logPath, "utf8");
+  const raw = await fs23.readFile(logPath, "utf8");
   const entries = raw.trim().split("\n").filter(Boolean).map((line) => JSON.parse(line));
   const match = [...entries].reverse().find((e) => e.project === ctx.project && e.library === args.library);
   if (!match) {
     return { undone: false, message: "no apply found for library" };
   }
-  const pkgPath = path40.join(ctx.scanPath, "package.json");
+  const pkgPath = path41.join(ctx.scanPath, "package.json");
   if (await fileExists2(pkgPath)) {
     const pkg = await readPackageJson(ctx.scanPath);
     if (pkg.dependencies?.[match.instrumentation_package]) {
       const { [match.instrumentation_package]: _removed, ...rest } = pkg.dependencies;
       pkg.dependencies = rest;
-      await fs22.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
+      await fs23.writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf8");
     }
   }
   const hookFiles = await findHookFiles(ctx.scanPath);
   for (const file of hookFiles) {
-    const filePath = path40.join(ctx.scanPath, file);
-    const content = await fs22.readFile(filePath, "utf8");
+    const filePath = path41.join(ctx.scanPath, file);
+    const content = await fs23.readFile(filePath, "utf8");
     if (content.includes(match.registration_snippet)) {
       const filtered = content.split("\n").filter((line) => !line.includes(match.registration_snippet)).join("\n");
-      await fs22.writeFile(filePath, filtered, "utf8");
+      await fs23.writeFile(filePath, filtered, "utf8");
       break;
     }
   }
@@ -8027,6 +8224,10 @@ export {
   loadPolicyFile,
   PolicyViolationsLog,
   thresholdForEdgeType,
+  reconcileObservedRelPath,
+  ensureObservedFileNode,
+  ensureServiceNode,
+  upsertObservedEdge,
   stitchTrace,
   makeErrorSpanWriter,
   handleSpan,
@@ -8081,4 +8282,4 @@ export {
   pruneRegistry,
   buildApi
 };
-//# sourceMappingURL=chunk-WZYH5DVG.js.map
+//# sourceMappingURL=chunk-QM6BMPVJ.js.map