@neat.is/core 0.4.25 → 0.4.26-dev.20260703

package/dist/index.cjs

@@ -57,9 +57,9 @@ function mountBearerAuth(app, opts) {
   const suffixes = [...DEFAULT_UNAUTH_SUFFIXES, ...opts.extraUnauthenticatedSuffixes ?? []];
   const publicRead = opts.publicRead === true;
   app.addHook("preHandler", (req, reply, done) => {
-    const path43 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
+    const path45 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
     for (const suffix of suffixes) {
-      if (path43 === suffix || path43.endsWith(suffix)) {
+      if (path45 === suffix || path45.endsWith(suffix)) {
         done();
         return;
       }
@@ -70,11 +70,13 @@ function mountBearerAuth(app, opts) {
     }
     const header = req.headers.authorization;
     if (typeof header !== "string" || !header.startsWith("Bearer ")) {
+      opts.onReject?.();
       void reply.code(401).send({ error: "unauthorized" });
       return;
     }
     const provided = Buffer.from(header.slice("Bearer ".length).trim(), "utf8");
     if (provided.length !== expected.length || !(0, import_node_crypto.timingSafeEqual)(provided, expected)) {
+      opts.onReject?.();
       void reply.code(401).send({ error: "unauthorized" });
       return;
     }
@@ -187,8 +189,8 @@ function reshapeGrpcRequest(req) {
   };
 }
 function resolveProtoRoot() {
-  const here = import_node_path39.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
-  return import_node_path39.default.resolve(here, "..", "proto");
+  const here = import_node_path41.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+  return import_node_path41.default.resolve(here, "..", "proto");
 }
 function loadTraceService() {
   const protoRoot = resolveProtoRoot();
@@ -256,13 +258,13 @@ async function startOtelGrpcReceiver(opts) {
     })
   };
 }
-var import_node_url, import_node_path39, import_node_crypto2, grpc, protoLoader;
+var import_node_url, import_node_path41, import_node_crypto2, grpc, protoLoader;
 var init_otel_grpc = __esm({
   "src/otel-grpc.ts"() {
     "use strict";
     init_cjs_shims();
     import_node_url = require("url");
-    import_node_path39 = __toESM(require("path"), 1);
+    import_node_path41 = __toESM(require("path"), 1);
     import_node_crypto2 = require("crypto");
     grpc = __toESM(require("@grpc/grpc-js"), 1);
     protoLoader = __toESM(require("@grpc/proto-loader"), 1);
@@ -335,6 +337,13 @@ function pickEnv(spanAttrs, resourceAttrs) {
   }
   return ENV_FALLBACK;
 }
+function messagingDestinationOf(attrs) {
+  for (const key of ["messaging.destination.name", "messaging.destination"]) {
+    const v = attrs[key];
+    if (typeof v === "string" && v.length > 0) return v;
+  }
+  return void 0;
+}
 function parseOtlpRequest(body) {
   const out = [];
   for (const rs of body.resourceSpans ?? []) {
@@ -361,6 +370,10 @@ function parseOtlpRequest(body) {
           attributes: attrs,
           dbSystem: typeof attrs["db.system"] === "string" ? attrs["db.system"] : void 0,
           dbName: typeof attrs["db.name"] === "string" ? attrs["db.name"] : void 0,
+          messagingSystem: typeof attrs["messaging.system"] === "string" ? attrs["messaging.system"] : void 0,
+          messagingDestination: messagingDestinationOf(attrs),
+          graphqlOperationName: typeof attrs["graphql.operation.name"] === "string" && attrs["graphql.operation.name"].length > 0 ? attrs["graphql.operation.name"] : void 0,
+          graphqlOperationType: typeof attrs["graphql.operation.type"] === "string" && attrs["graphql.operation.type"].length > 0 ? attrs["graphql.operation.type"] : void 0,
           statusCode: span.status?.code,
           errorMessage: span.status?.message,
           exception: extractExceptionFromEvents(span.events)
@@ -372,10 +385,10 @@ function parseOtlpRequest(body) {
   return out;
 }
 function loadProtoRoot() {
-  const here = import_node_path40.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
-  const protoRoot = import_node_path40.default.resolve(here, "..", "proto");
+  const here = import_node_path42.default.dirname((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const protoRoot = import_node_path42.default.resolve(here, "..", "proto");
   const root = new import_protobufjs.default.Root();
-  root.resolvePath = (_origin, target) => import_node_path40.default.resolve(protoRoot, target);
+  root.resolvePath = (_origin, target) => import_node_path42.default.resolve(protoRoot, target);
   root.loadSync(
     "opentelemetry/proto/collector/trace/v1/trace_service.proto",
     { keepCase: true }
@@ -420,7 +433,21 @@ async function buildOtelReceiver(opts) {
     logger: false,
     bodyLimit: opts.bodyLimit ?? 16 * 1024 * 1024
   });
-  mountBearerAuth(app, { token: opts.authToken, trustProxy: opts.trustProxy });
+  const REJECT_WARN_INTERVAL_MS = 6e4;
+  let lastRejectWarnAt = 0;
+  const warnRejectedOtlp = () => {
+    const now = Date.now();
+    if (now - lastRejectWarnAt < REJECT_WARN_INTERVAL_MS) return;
+    lastRejectWarnAt = now;
+    console.warn(
+      "[neatd] rejecting OTLP spans on /v1/traces \u2014 missing or invalid bearer token (set NEAT_OTEL_TOKEN on the instrumented app)"
+    );
+  };
+  mountBearerAuth(app, {
+    token: opts.authToken,
+    trustProxy: opts.trustProxy,
+    onReject: warnRejectedOtlp
+  });
   const queue = [];
   let draining = false;
   let drainPromise = Promise.resolve();
@@ -597,12 +624,12 @@ function logSpanHandler(span) {
     `otel: ${span.service} ${span.name} parent=${parent} status=${status2}${db}`
   );
 }
-var import_node_path40, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody, OTLP_STEP_ATTEMPTS, OTLP_STEP_STRIDE;
+var import_node_path42, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody, OTLP_STEP_ATTEMPTS, OTLP_STEP_STRIDE;
 var init_otel = __esm({
   "src/otel.ts"() {
     "use strict";
     init_cjs_shims();
-    import_node_path40 = __toESM(require("path"), 1);
+    import_node_path42 = __toESM(require("path"), 1);
     import_node_url2 = require("url");
     import_fastify2 = __toESM(require("fastify"), 1);
     import_protobufjs = __toESM(require("protobufjs"), 1);
@@ -1192,19 +1219,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, path43, edges) {
-    if (path43.length > best.path.length) {
-      best = { path: [...path43], edges: [...edges] };
+  function step(node, path45, edges) {
+    if (path45.length > best.path.length) {
+      best = { path: [...path45], edges: [...edges] };
     }
-    if (path43.length - 1 >= maxDepth) return;
+    if (path45.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);
-      path43.push(srcId);
+      path45.push(srcId);
       edges.push(edge);
-      step(srcId, path43, edges);
-      path43.pop();
+      step(srcId, path45, edges);
+      path45.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1212,14 +1239,14 @@ function longestIncomingWalk(graph, start, maxDepth) {
   step(start, [start], []);
   return best;
 }
-function databaseRootCauseShape(graph, origin, walk) {
+function databaseRootCauseShape(graph, origin, walk3) {
   const targetDb = origin;
   const candidatePairs = compatPairs().filter((p) => p.engine === targetDb.engine);
   if (candidatePairs.length === 0) return null;
-  for (const id of walk.path) {
+  for (const id of walk3.path) {
     const owner = resolveOwningService(graph, id);
     if (!owner) continue;
-    const { id: serviceId3, svc } = owner;
+    const { id: serviceId4, svc } = owner;
     const deps = svc.dependencies ?? {};
     for (const pair of candidatePairs) {
       const declared = deps[pair.driver];
@@ -1232,7 +1259,7 @@ function databaseRootCauseShape(graph, origin, walk) {
       );
       if (!result.compatible) {
         return {
-          rootCauseNode: serviceId3,
+          rootCauseNode: serviceId4,
           rootCauseReason: result.reason ?? "incompatible driver",
           ...result.minDriverVersion ? {
             fixRecommendation: `Upgrade ${svc.name} ${pair.driver} driver to >= ${result.minDriverVersion}`
@@ -1243,11 +1270,11 @@ function databaseRootCauseShape(graph, origin, walk) {
   }
   return null;
 }
-function serviceRootCauseShape(graph, _origin, walk) {
-  for (const id of walk.path) {
+function serviceRootCauseShape(graph, _origin, walk3) {
+  for (const id of walk3.path) {
     const owner = resolveOwningService(graph, id);
     if (!owner) continue;
-    const { id: serviceId3, svc } = owner;
+    const { id: serviceId4, svc } = owner;
     const deps = svc.dependencies ?? {};
     const serviceNodeEngine = svc.nodeEngine;
     for (const constraint of nodeEngineConstraints()) {
@@ -1256,7 +1283,7 @@ function serviceRootCauseShape(graph, _origin, walk) {
       const result = checkNodeEngineConstraint(constraint, declared, serviceNodeEngine);
       if (!result.compatible && result.reason) {
         return {
-          rootCauseNode: serviceId3,
+          rootCauseNode: serviceId4,
           rootCauseReason: result.reason,
           ...result.requiredNodeVersion ? {
             fixRecommendation: `Bump ${svc.name}'s engines.node to >= ${result.requiredNodeVersion}`
@@ -1271,7 +1298,7 @@ function serviceRootCauseShape(graph, _origin, walk) {
       const result = checkPackageConflict(conflict, declared, requiredDeclared);
       if (!result.compatible && result.reason) {
         return {
-          rootCauseNode: serviceId3,
+          rootCauseNode: serviceId4,
           rootCauseReason: result.reason,
           fixRecommendation: `Upgrade ${svc.name}'s ${conflict.requires.name} to >= ${conflict.requires.minVersion}`
         };
@@ -1280,10 +1307,10 @@ function serviceRootCauseShape(graph, _origin, walk) {
   }
   return null;
 }
-function fileRootCauseShape(graph, origin, walk) {
+function fileRootCauseShape(graph, origin, walk3) {
   const owner = resolveOwningService(graph, origin.id);
   if (!owner) return null;
-  return serviceRootCauseShape(graph, owner.svc, walk);
+  return serviceRootCauseShape(graph, owner.svc, walk3);
 }
 var rootCauseShapes = {
   [import_types.NodeType.DatabaseNode]: databaseRootCauseShape,
@@ -1295,16 +1322,16 @@ function getRootCause(graph, errorNodeId, errorEvent, incidents) {
   const origin = graph.getNodeAttributes(errorNodeId);
   const shape = rootCauseShapes[origin.type];
   if (shape) {
-    const walk = longestIncomingWalk(graph, errorNodeId, ROOT_CAUSE_MAX_DEPTH);
-    const match = shape(graph, origin, walk);
+    const walk3 = longestIncomingWalk(graph, errorNodeId, ROOT_CAUSE_MAX_DEPTH);
+    const match = shape(graph, origin, walk3);
     if (match) {
       const reason = errorEvent ? `${match.rootCauseReason} (observed error: ${errorEvent.errorMessage})` : match.rootCauseReason;
       return import_types.RootCauseResultSchema.parse({
         rootCauseNode: match.rootCauseNode,
         rootCauseReason: reason,
-        traversalPath: walk.path,
-        edgeProvenances: walk.edges.map((e) => e.provenance),
-        confidence: confidenceFromMix(walk.edges),
+        traversalPath: walk3.path,
+        edgeProvenances: walk3.edges.map((e) => e.provenance),
+        confidence: confidenceFromMix(walk3.edges),
         fixRecommendation: match.fixRecommendation
       });
     }
@@ -1362,9 +1389,9 @@ function rootCauseFromIncidents(nodeId, incidents, errorEvent) {
 function isFailingCallEdge(e) {
   return e.type === import_types.EdgeType.CALLS && (e.signal?.errorCount ?? 0) > 0;
 }
-function callSourcesForService(graph, serviceId3) {
-  const ids = [serviceId3];
-  for (const edgeId of graph.outboundEdges(serviceId3)) {
+function callSourcesForService(graph, serviceId4) {
+  const ids = [serviceId4];
+  for (const edgeId of graph.outboundEdges(serviceId4)) {
     const e = graph.getEdgeAttributes(edgeId);
     if (e.type !== import_types.EdgeType.CONTAINS) continue;
     const tgt = graph.getNodeAttributes(e.target);
@@ -1381,9 +1408,9 @@ function failingCallDominates(e, id, curEdge, curId) {
   }
   return id < curId;
 }
-function dominantFailingCall(graph, serviceId3, visited) {
+function dominantFailingCall(graph, serviceId4, visited) {
   let best = null;
-  for (const src of callSourcesForService(graph, serviceId3)) {
+  for (const src of callSourcesForService(graph, serviceId4)) {
     for (const edgeId of graph.outboundEdges(src)) {
       const e = graph.getEdgeAttributes(edgeId);
       if (!isFailingCallEdge(e)) continue;
@@ -1398,26 +1425,26 @@ function dominantFailingCall(graph, serviceId3, visited) {
   return best;
 }
 function followFailingCallChain(graph, originServiceId, maxDepth) {
-  const path43 = [originServiceId];
+  const path45 = [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;
-    path43.push(hop.nextService);
+    path45.push(hop.nextService);
     edges.push(hop.edge);
     visited.add(hop.nextService);
     current = hop.nextService;
   }
   if (edges.length === 0) return null;
-  return { path: path43, edges, culprit: current };
+  return { path: path45, 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 path43 = [...chain.path];
+  const path45 = [...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));
@@ -1425,14 +1452,14 @@ function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   if (loc) {
     let rootCauseNode = culprit;
     if (loc.fileNode) {
-      path43.push(loc.fileNode);
+      path45.push(loc.fileNode);
       edgeProvenances.push(import_types.Provenance.OBSERVED);
       rootCauseNode = loc.fileNode;
     }
     return import_types.RootCauseResultSchema.parse({
       rootCauseNode,
       rootCauseReason: loc.rootCauseReason,
-      traversalPath: path43,
+      traversalPath: path45,
       edgeProvenances,
       confidence,
       ...loc.fixRecommendation ? { fixRecommendation: loc.fixRecommendation } : {}
@@ -1444,7 +1471,7 @@ function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   return import_types.RootCauseResultSchema.parse({
     rootCauseNode: culprit,
     rootCauseReason: `${culpritName} is failing downstream calls (${errs} observed error${errs === 1 ? "" : "s"})`,
-    traversalPath: path43,
+    traversalPath: path45,
     edgeProvenances,
     confidence,
     fixRecommendation: `Inspect ${culpritName}'s failing handler`
@@ -2368,10 +2395,48 @@ var STITCH_EDGE_TYPES = /* @__PURE__ */ new Set([
 ]);
 var WIRE_SPAN_KIND_CLIENT = 3;
 var WIRE_SPAN_KIND_PRODUCER = 4;
+var WIRE_SPAN_KIND_CONSUMER = 5;
 function spanMintsObservedEdge(kind) {
   if (kind === void 0 || kind === 0) return true;
   return kind === WIRE_SPAN_KIND_CLIENT || kind === WIRE_SPAN_KIND_PRODUCER;
 }
+function spanMintsMessagingEdge(kind) {
+  return kind === WIRE_SPAN_KIND_PRODUCER || kind === WIRE_SPAN_KIND_CONSUMER;
+}
+function spanServesGraphqlOperation(kind) {
+  return kind !== WIRE_SPAN_KIND_CLIENT && kind !== WIRE_SPAN_KIND_PRODUCER && kind !== WIRE_SPAN_KIND_CONSUMER;
+}
+function ensureGraphqlOperationNode(graph, serviceName, operationType, operationName) {
+  const id = (0, import_types3.graphqlOperationId)(serviceName, operationType, operationName);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: import_types3.NodeType.GraphQLOperationNode,
+    name: operationName,
+    service: serviceName,
+    operationType: operationType.toLowerCase(),
+    operationName,
+    discoveredVia: "otel"
+  };
+  graph.addNode(id, node);
+  return id;
+}
+function messagingDestinationKind(system) {
+  return `${system}-topic`;
+}
+function ensureMessagingDestinationNode(graph, system, destination) {
+  const id = (0, import_types3.infraId)(messagingDestinationKind(system), destination);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: import_types3.NodeType.InfraNode,
+    name: destination,
+    provider: "self",
+    kind: messagingDestinationKind(system)
+  };
+  graph.addNode(id, node);
+  return id;
+}
 var PARENT_SPAN_CACHE_SIZE = 1e4;
 var PARENT_SPAN_CACHE_TTL_MS = 5 * 60 * 1e3;
 var parentSpanCache = /* @__PURE__ */ new Map();
@@ -2465,6 +2530,21 @@ function ensureDatabaseNode(graph, host, engine) {
   graph.addNode(id, node);
   return id;
 }
+function ensureLocalDatabaseNode(graph, serviceName, name, engine) {
+  const id = (0, import_types3.localDatabaseId)(serviceName, name);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: import_types3.NodeType.DatabaseNode,
+    name,
+    engine,
+    engineVersion: "unknown",
+    compatibleDrivers: [],
+    discoveredVia: "otel"
+  };
+  graph.addNode(id, node);
+  return id;
+}
 function ensureFrontierNode(graph, host, ts) {
   const id = frontierIdFor(host);
   if (graph.hasNode(id)) {
@@ -2716,10 +2796,21 @@ async function handleSpan(ctx, span) {
   let affectedNode = sourceId;
   const mintsFromCallerSide = spanMintsObservedEdge(span.kind);
   if (span.dbSystem) {
-    const host = pickAddress(span);
-    if (mintsFromCallerSide && host) {
-      ensureDatabaseNode(ctx.graph, host, span.dbSystem);
-      const targetId = (0, import_types3.databaseId)(host);
+    if (mintsFromCallerSide) {
+      const host = pickAddress(span);
+      let targetId;
+      if (host) {
+        ensureDatabaseNode(ctx.graph, host, span.dbSystem);
+        targetId = (0, import_types3.databaseId)(host);
+      } else {
+        const localName = span.dbName ?? span.dbSystem;
+        targetId = ensureLocalDatabaseNode(
+          ctx.graph,
+          span.service,
+          localName,
+          span.dbSystem
+        );
+      }
       const result = upsertObservedEdge(
         ctx.graph,
         import_types3.EdgeType.CONNECTS_TO,
@@ -2731,6 +2822,40 @@ async function handleSpan(ctx, span) {
       );
       if (result) affectedNode = targetId;
     }
+  } else if (span.messagingSystem && span.messagingDestination && spanMintsMessagingEdge(span.kind)) {
+    const targetId = ensureMessagingDestinationNode(
+      ctx.graph,
+      span.messagingSystem,
+      span.messagingDestination
+    );
+    const edgeType = span.kind === WIRE_SPAN_KIND_CONSUMER ? import_types3.EdgeType.CONSUMES_FROM : import_types3.EdgeType.PUBLISHES_TO;
+    const result = upsertObservedEdge(
+      ctx.graph,
+      edgeType,
+      observedSource(),
+      targetId,
+      ts,
+      isError,
+      callSiteEvidence
+    );
+    if (result) affectedNode = targetId;
+  } else if (span.graphqlOperationName && span.graphqlOperationType && spanServesGraphqlOperation(span.kind)) {
+    const targetId = ensureGraphqlOperationNode(
+      ctx.graph,
+      span.service,
+      span.graphqlOperationType,
+      span.graphqlOperationName
+    );
+    const result = upsertObservedEdge(
+      ctx.graph,
+      import_types3.EdgeType.CONTAINS,
+      observedSource(),
+      targetId,
+      ts,
+      isError,
+      callSiteEvidence
+    );
+    if (result) affectedNode = targetId;
   } else {
     const host = pickAddress(span);
     let resolvedViaAddress = false;
@@ -2840,29 +2965,29 @@ function promoteFrontierNodes(graph, opts = {}) {
     toPromote.push({ frontierId: id, serviceId: target });
   });
   let promoted = 0;
-  for (const { frontierId: frontierId2, serviceId: serviceId3 } of toPromote) {
+  for (const { frontierId: frontierId2, serviceId: serviceId4 } of toPromote) {
     if (opts.policies && opts.policies.length > 0 && opts.policyCtx) {
       const gate = canPromoteFrontier(graph, frontierId2, opts.policies, opts.policyCtx);
       if (!gate.allowed) {
         continue;
       }
     }
-    rewireFrontierEdges(graph, frontierId2, serviceId3);
+    rewireFrontierEdges(graph, frontierId2, serviceId4);
     graph.dropNode(frontierId2);
     promoted++;
   }
   return promoted;
 }
-function rewireFrontierEdges(graph, frontierId2, serviceId3) {
+function rewireFrontierEdges(graph, frontierId2, serviceId4) {
   const inbound = [...graph.inboundEdges(frontierId2)];
   const outbound = [...graph.outboundEdges(frontierId2)];
   for (const edgeId of inbound) {
     const edge = graph.getEdgeAttributes(edgeId);
-    rebuildEdge(graph, edge, edge.source, serviceId3, edgeId);
+    rebuildEdge(graph, edge, edge.source, serviceId4, edgeId);
   }
   for (const edgeId of outbound) {
     const edge = graph.getEdgeAttributes(edgeId);
-    rebuildEdge(graph, edge, serviceId3, edge.target, edgeId);
+    rebuildEdge(graph, edge, serviceId4, edge.target, edgeId);
   }
 }
 function rebuildEdge(graph, edge, newSource, newTarget, oldEdgeId) {
@@ -3624,9 +3749,9 @@ var K8S_KINDS_WITH_HOSTNAMES = /* @__PURE__ */ new Set([
   "StatefulSet",
   "DaemonSet"
 ]);
-function addAliases(graph, serviceId3, candidates) {
-  if (!graph.hasNode(serviceId3)) return;
-  const node = graph.getNodeAttributes(serviceId3);
+function addAliases(graph, serviceId4, candidates) {
+  if (!graph.hasNode(serviceId4)) return;
+  const node = graph.getNodeAttributes(serviceId4);
   if (node.type !== import_types6.NodeType.ServiceNode) return;
   const set = new Set(node.aliases ?? []);
   for (const c of candidates) {
@@ -3636,7 +3761,7 @@ function addAliases(graph, serviceId3, candidates) {
   }
   if (set.size === 0) return;
   const updated = { ...node, aliases: [...set].sort() };
-  graph.replaceNodeAttributes(serviceId3, updated);
+  graph.replaceNodeAttributes(serviceId4, updated);
 }
 function indexServicesByName(services) {
   const map = /* @__PURE__ */ new Map();
@@ -3669,12 +3794,12 @@ async function collectComposeAliases(graph, scanPath, serviceIndex) {
   }
   if (!compose?.services) return;
   for (const [composeName, svc] of Object.entries(compose.services)) {
-    const serviceId3 = serviceIndex.get(composeName);
-    if (!serviceId3) continue;
+    const serviceId4 = serviceIndex.get(composeName);
+    if (!serviceId4) continue;
     const aliases = /* @__PURE__ */ new Set([composeName]);
     if (svc.container_name) aliases.add(svc.container_name);
     if (svc.hostname) aliases.add(svc.hostname);
-    addAliases(graph, serviceId3, aliases);
+    addAliases(graph, serviceId4, aliases);
   }
 }
 var LABEL_KEYS = /* @__PURE__ */ new Set([
@@ -3787,16 +3912,28 @@ init_cjs_shims();
 var import_node_fs10 = require("fs");
 var import_node_path10 = __toESM(require("path"), 1);
 var import_types7 = require("@neat.is/types");
+function buildServiceHostIndex(services) {
+  const knownHosts = /* @__PURE__ */ new Set();
+  const hostToNodeId = /* @__PURE__ */ new Map();
+  for (const service of services) {
+    const base = import_node_path10.default.basename(service.dir);
+    knownHosts.add(base);
+    knownHosts.add(service.pkg.name);
+    hostToNodeId.set(base, service.node.id);
+    hostToNodeId.set(service.pkg.name, service.node.id);
+  }
+  return { knownHosts, hostToNodeId };
+}
 async function walkSourceFiles(dir) {
   const out = [];
-  async function walk(current) {
+  async function walk3(current) {
     const entries = await import_node_fs10.promises.readdir(current, { withFileTypes: true }).catch(() => []);
     for (const entry of entries) {
       const full = import_node_path10.default.join(current, entry.name);
       if (entry.isDirectory()) {
         if (IGNORED_DIRS.has(entry.name)) continue;
         if (await isPythonVenvDir(full)) continue;
-        await walk(full);
+        await walk3(full);
       } else if (entry.isFile() && SERVICE_FILE_EXTENSIONS.has(import_node_path10.default.extname(entry.name)) && // Skip NEAT's own generated `otel-init.*` bootstrap — extracting it
       // would attribute our instrumentation imports to the user's service.
       !isNeatAuthoredSourceFile(entry.name)) {
@@ -3804,7 +3941,7 @@ async function walkSourceFiles(dir) {
       }
     }
   }
-  await walk(dir);
+  await walk3(dir);
   return out;
 }
 async function loadSourceFiles(dir) {
@@ -4898,20 +5035,20 @@ var import_node_path21 = __toESM(require("path"), 1);
 var import_types10 = require("@neat.is/types");
 async function walkConfigFiles(dir) {
   const out = [];
-  async function walk(current) {
+  async function walk3(current) {
     const entries = await import_node_fs14.promises.readdir(current, { withFileTypes: true });
     for (const entry of entries) {
       const full = import_node_path21.default.join(current, entry.name);
       if (entry.isDirectory()) {
         if (IGNORED_DIRS.has(entry.name)) continue;
         if (await isPythonVenvDir(full)) continue;
-        await walk(full);
+        await walk3(full);
       } else if (entry.isFile() && isConfigFile(entry.name).match) {
         out.push(full);
       }
     }
   }
-  await walk(dir);
+  await walk3(dir);
   return out;
 }
 async function addConfigNodes(graph, services, scanPath) {
@@ -4959,17 +5096,347 @@ async function addConfigNodes(graph, services, scanPath) {
   return { nodesAdded, edgesAdded };
 }
 
+// src/extract/routes.ts
+init_cjs_shims();
+var import_node_path22 = __toESM(require("path"), 1);
+var import_tree_sitter2 = __toESM(require("tree-sitter"), 1);
+var import_tree_sitter_javascript2 = __toESM(require("tree-sitter-javascript"), 1);
+var import_types11 = require("@neat.is/types");
+var PARSE_CHUNK2 = 16384;
+function parseSource2(parser, source) {
+  return parser.parse(
+    (index) => index >= source.length ? "" : source.slice(index, index + PARSE_CHUNK2)
+  );
+}
+function makeJsParser2() {
+  const p = new import_tree_sitter2.default();
+  p.setLanguage(import_tree_sitter_javascript2.default);
+  return p;
+}
+var ROUTER_METHODS = /* @__PURE__ */ new Set([
+  "get",
+  "post",
+  "put",
+  "patch",
+  "delete",
+  "options",
+  "head",
+  "all"
+]);
+var NEXT_APP_METHODS = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
+var JS_ROUTE_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx"]);
+function canonicalizeTemplate(raw) {
+  let p = raw.split("?")[0].split("#")[0];
+  if (!p.startsWith("/")) p = "/" + p;
+  if (p.length > 1 && p.endsWith("/")) p = p.slice(0, -1);
+  return p;
+}
+function isDynamicSegment(seg) {
+  if (seg.length === 0) return false;
+  if (seg.includes(":")) return true;
+  if (seg.startsWith("{") || seg.startsWith("[")) return true;
+  if (/^\d+$/.test(seg)) return true;
+  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(seg)) return true;
+  if (/^[0-9a-f]{24,}$/i.test(seg)) return true;
+  return false;
+}
+function normalizePathTemplate(raw) {
+  const canonical = canonicalizeTemplate(raw);
+  const segments = canonical.split("/").filter((s) => s.length > 0);
+  const normalised = segments.map((seg) => isDynamicSegment(seg) ? ":param" : seg.toLowerCase());
+  return "/" + normalised.join("/");
+}
+function walk(node, visit) {
+  visit(node);
+  for (let i = 0; i < node.namedChildCount; i++) {
+    const child = node.namedChild(i);
+    if (child) walk(child, visit);
+  }
+}
+function staticStringText(node) {
+  if (node.type === "string") {
+    for (let i = 0; i < node.namedChildCount; i++) {
+      const child = node.namedChild(i);
+      if (child?.type === "string_fragment") return child.text;
+    }
+    return "";
+  }
+  if (node.type === "template_string") {
+    for (let i = 0; i < node.namedChildCount; i++) {
+      if (node.namedChild(i)?.type === "template_substitution") return null;
+    }
+    const raw = node.text;
+    return raw.length >= 2 ? raw.slice(1, -1) : "";
+  }
+  return null;
+}
+function objectStringProp(objNode, key) {
+  for (let i = 0; i < objNode.namedChildCount; i++) {
+    const pair = objNode.namedChild(i);
+    if (!pair || pair.type !== "pair") continue;
+    const k = pair.childForFieldName("key");
+    if (!k) continue;
+    const kText = k.type === "string" ? staticStringText(k) : k.text;
+    if (kText !== key) continue;
+    const v = pair.childForFieldName("value");
+    if (v) return staticStringText(v);
+  }
+  return null;
+}
+function fastifyRouteMethods(objNode) {
+  for (let i = 0; i < objNode.namedChildCount; i++) {
+    const pair = objNode.namedChild(i);
+    if (!pair || pair.type !== "pair") continue;
+    const k = pair.childForFieldName("key");
+    const kText = k ? k.type === "string" ? staticStringText(k) : k.text : null;
+    if (kText !== "method") continue;
+    const v = pair.childForFieldName("value");
+    if (!v) return [];
+    if (v.type === "string" || v.type === "template_string") {
+      const s = staticStringText(v);
+      return s ? [s.toUpperCase()] : [];
+    }
+    if (v.type === "array") {
+      const out = [];
+      for (let j = 0; j < v.namedChildCount; j++) {
+        const el = v.namedChild(j);
+        if (el && (el.type === "string" || el.type === "template_string")) {
+          const s = staticStringText(el);
+          if (s) out.push(s.toUpperCase());
+        }
+      }
+      return out;
+    }
+  }
+  return [];
+}
+function serverRoutesFromSource(source, parser, hasExpress, hasFastify) {
+  const tree = parseSource2(parser, source);
+  const out = [];
+  const framework = hasExpress ? "express" : "fastify";
+  walk(tree.rootNode, (node) => {
+    if (node.type !== "call_expression") return;
+    const fn = node.childForFieldName("function");
+    if (!fn || fn.type !== "member_expression") return;
+    const prop = fn.childForFieldName("property");
+    if (!prop) return;
+    const method = prop.text.toLowerCase();
+    const args = node.childForFieldName("arguments");
+    const first = args?.namedChild(0);
+    if (!first) return;
+    const line = node.startPosition.row + 1;
+    if (ROUTER_METHODS.has(method)) {
+      const p = staticStringText(first);
+      if (p && p.startsWith("/")) {
+        out.push({
+          method: method === "all" ? "ALL" : method.toUpperCase(),
+          pathTemplate: canonicalizeTemplate(p),
+          line,
+          framework
+        });
+      }
+      return;
+    }
+    if (method === "route" && hasFastify && first.type === "object") {
+      const url = objectStringProp(first, "url");
+      if (!url || !url.startsWith("/")) return;
+      const methods = fastifyRouteMethods(first);
+      const list = methods.length > 0 ? methods : ["ALL"];
+      for (const m of list) {
+        out.push({
+          method: m === "ALL" ? "ALL" : m.toUpperCase(),
+          pathTemplate: canonicalizeTemplate(url),
+          line,
+          framework: "fastify"
+        });
+      }
+    }
+  });
+  return out;
+}
+function segmentsOf(relFile) {
+  return toPosix2(relFile).split("/").filter((s) => s.length > 0);
+}
+function isNextAppRouteFile(relFile) {
+  const segs = segmentsOf(relFile);
+  if (!segs.includes("app")) return false;
+  const base = segs[segs.length - 1] ?? "";
+  return /^route\.(?:js|jsx|mjs|cjs|ts|tsx)$/.test(base);
+}
+function isNextPagesApiFile(relFile) {
+  const segs = segmentsOf(relFile);
+  const pagesIdx = segs.indexOf("pages");
+  if (pagesIdx === -1 || segs[pagesIdx + 1] !== "api") return false;
+  const base = segs[segs.length - 1] ?? "";
+  if (/^_(app|document|middleware)\./.test(base)) return false;
+  return JS_ROUTE_EXTENSIONS.has(import_node_path22.default.extname(base));
+}
+function nextSegment(seg) {
+  if (seg.startsWith("(") && seg.endsWith(")")) return null;
+  const catchAll = seg.match(/^\[\[?\.\.\.(.+?)\]?\]$/);
+  if (catchAll) return ":" + catchAll[1];
+  const dynamic = seg.match(/^\[(.+?)\]$/);
+  if (dynamic) return ":" + dynamic[1];
+  return seg;
+}
+function nextAppPathTemplate(relFile) {
+  const segs = segmentsOf(relFile);
+  const appIdx = segs.lastIndexOf("app");
+  const between = segs.slice(appIdx + 1, segs.length - 1);
+  const parts = [];
+  for (const seg of between) {
+    const mapped = nextSegment(seg);
+    if (mapped !== null) parts.push(mapped);
+  }
+  return "/" + parts.join("/");
+}
+function nextPagesApiPathTemplate(relFile) {
+  const segs = segmentsOf(relFile);
+  const pagesIdx = segs.indexOf("pages");
+  const rest = segs.slice(pagesIdx + 1);
+  const parts = [];
+  for (let i = 0; i < rest.length; i++) {
+    let seg = rest[i];
+    if (i === rest.length - 1) {
+      seg = seg.replace(/\.(?:js|jsx|mjs|cjs|ts|tsx)$/, "");
+      if (seg === "index") continue;
+    }
+    const mapped = nextSegment(seg);
+    if (mapped !== null) parts.push(mapped);
+  }
+  return "/" + parts.join("/");
+}
+function nextAppMethods(root) {
+  const out = [];
+  walk(root, (node) => {
+    if (node.type !== "export_statement") return;
+    const decl = node.childForFieldName("declaration");
+    if (!decl) return;
+    const line = node.startPosition.row + 1;
+    if (decl.type === "function_declaration") {
+      const name = decl.childForFieldName("name")?.text;
+      if (name && NEXT_APP_METHODS.has(name)) out.push({ method: name, line });
+      return;
+    }
+    if (decl.type === "lexical_declaration" || decl.type === "variable_declaration") {
+      for (let i = 0; i < decl.namedChildCount; i++) {
+        const d = decl.namedChild(i);
+        if (d?.type !== "variable_declarator") continue;
+        const name = d.childForFieldName("name")?.text;
+        if (name && NEXT_APP_METHODS.has(name)) out.push({ method: name, line });
+      }
+    }
+  });
+  return out;
+}
+function nextRoutesFromFile(source, relFile, parser) {
+  if (isNextAppRouteFile(relFile)) {
+    const tree = parseSource2(parser, source);
+    const template = nextAppPathTemplate(relFile);
+    return nextAppMethods(tree.rootNode).map(({ method, line }) => ({
+      method,
+      pathTemplate: canonicalizeTemplate(template),
+      line,
+      framework: "next"
+    }));
+  }
+  if (isNextPagesApiFile(relFile)) {
+    return [
+      {
+        method: "ALL",
+        pathTemplate: canonicalizeTemplate(nextPagesApiPathTemplate(relFile)),
+        line: 1,
+        framework: "next"
+      }
+    ];
+  }
+  return [];
+}
+async function addRoutes(graph, services) {
+  const jsParser = makeJsParser2();
+  let nodesAdded = 0;
+  let edgesAdded = 0;
+  for (const service of services) {
+    const deps = {
+      ...service.pkg.dependencies ?? {},
+      ...service.pkg.devDependencies ?? {}
+    };
+    const hasExpress = deps["express"] !== void 0;
+    const hasFastify = deps["fastify"] !== void 0;
+    const hasNext = deps["next"] !== void 0;
+    if (!hasExpress && !hasFastify && !hasNext) continue;
+    const files = await loadSourceFiles(service.dir);
+    for (const file of files) {
+      if (isTestPath(file.path)) continue;
+      if (!JS_ROUTE_EXTENSIONS.has(import_node_path22.default.extname(file.path))) continue;
+      const relFile = toPosix2(import_node_path22.default.relative(service.dir, file.path));
+      let routes;
+      try {
+        if (hasNext && (isNextAppRouteFile(relFile) || isNextPagesApiFile(relFile))) {
+          routes = nextRoutesFromFile(file.content, relFile, jsParser);
+        } else if (hasExpress || hasFastify) {
+          routes = serverRoutesFromSource(file.content, jsParser, hasExpress, hasFastify);
+        } else {
+          routes = [];
+        }
+      } catch (err) {
+        recordExtractionError("route extraction", file.path, err);
+        continue;
+      }
+      if (routes.length === 0) continue;
+      for (const route of routes) {
+        const rid = (0, import_types11.routeId)(service.pkg.name, route.method, route.pathTemplate);
+        if (!graph.hasNode(rid)) {
+          const node = {
+            id: rid,
+            type: import_types11.NodeType.RouteNode,
+            name: `${route.method} ${route.pathTemplate}`,
+            service: service.pkg.name,
+            method: route.method,
+            pathTemplate: route.pathTemplate,
+            path: relFile,
+            line: route.line,
+            framework: route.framework,
+            discoveredVia: "static"
+          };
+          graph.addNode(rid, node);
+          nodesAdded++;
+        }
+        const containsId = (0, import_types11.extractedEdgeId)(service.node.id, rid, import_types11.EdgeType.CONTAINS);
+        if (!graph.hasEdge(containsId)) {
+          const edge = {
+            id: containsId,
+            source: service.node.id,
+            target: rid,
+            type: import_types11.EdgeType.CONTAINS,
+            provenance: import_types11.Provenance.EXTRACTED,
+            confidence: (0, import_types11.confidenceForExtracted)("structural"),
+            evidence: {
+              file: relFile,
+              line: route.line,
+              snippet: snippet(file.content, route.line)
+            }
+          };
+          graph.addEdgeWithKey(containsId, service.node.id, rid, edge);
+          edgesAdded++;
+        }
+      }
+    }
+  }
+  return { nodesAdded, edgesAdded };
+}
+
 // src/extract/calls/index.ts
 init_cjs_shims();
-var import_types17 = require("@neat.is/types");
+var import_types19 = require("@neat.is/types");
 
 // src/extract/calls/http.ts
 init_cjs_shims();
-var import_node_path22 = __toESM(require("path"), 1);
-var import_tree_sitter2 = __toESM(require("tree-sitter"), 1);
-var import_tree_sitter_javascript2 = __toESM(require("tree-sitter-javascript"), 1);
+var import_node_path23 = __toESM(require("path"), 1);
+var import_tree_sitter3 = __toESM(require("tree-sitter"), 1);
+var import_tree_sitter_javascript3 = __toESM(require("tree-sitter-javascript"), 1);
 var import_tree_sitter_python2 = __toESM(require("tree-sitter-python"), 1);
-var import_types11 = require("@neat.is/types");
+var import_types12 = require("@neat.is/types");
 var STRING_LITERAL_NODE_TYPES = /* @__PURE__ */ new Set(["string_fragment", "string_content"]);
 var JSX_EXTERNAL_LINK_TAGS = /* @__PURE__ */ new Set(["a", "Link", "NavLink", "ExternalLink", "Anchor"]);
 function isInsideJsxExternalLink(node) {
@@ -4997,14 +5464,14 @@ function collectStringLiterals(node, out) {
     if (child) collectStringLiterals(child, out);
   }
 }
-var PARSE_CHUNK2 = 16384;
-function parseSource2(parser, source) {
+var PARSE_CHUNK3 = 16384;
+function parseSource3(parser, source) {
   return parser.parse(
-    (index) => index >= source.length ? "" : source.slice(index, index + PARSE_CHUNK2)
+    (index) => index >= source.length ? "" : source.slice(index, index + PARSE_CHUNK3)
   );
 }
 function callsFromSource(source, parser, knownHosts) {
-  const tree = parseSource2(parser, source);
+  const tree = parseSource3(parser, source);
   const literals = [];
   collectStringLiterals(tree.rootNode, literals);
   const out = [];
@@ -5018,27 +5485,20 @@ function callsFromSource(source, parser, knownHosts) {
   }
   return out;
 }
-function makeJsParser2() {
-  const p = new import_tree_sitter2.default();
-  p.setLanguage(import_tree_sitter_javascript2.default);
+function makeJsParser3() {
+  const p = new import_tree_sitter3.default();
+  p.setLanguage(import_tree_sitter_javascript3.default);
   return p;
 }
 function makePyParser2() {
-  const p = new import_tree_sitter2.default();
+  const p = new import_tree_sitter3.default();
   p.setLanguage(import_tree_sitter_python2.default);
   return p;
 }
 async function addHttpCallEdges(graph, services) {
-  const jsParser = makeJsParser2();
+  const jsParser = makeJsParser3();
   const pyParser = makePyParser2();
-  const knownHosts = /* @__PURE__ */ new Set();
-  const hostToNodeId = /* @__PURE__ */ new Map();
-  for (const service of services) {
-    knownHosts.add(import_node_path22.default.basename(service.dir));
-    knownHosts.add(service.pkg.name);
-    hostToNodeId.set(import_node_path22.default.basename(service.dir), service.node.id);
-    hostToNodeId.set(service.pkg.name, service.node.id);
-  }
+  const { knownHosts, hostToNodeId } = buildServiceHostIndex(services);
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
@@ -5046,7 +5506,7 @@ async function addHttpCallEdges(graph, services) {
     const seen = /* @__PURE__ */ new Set();
     for (const file of files) {
       if (isTestPath(file.path)) continue;
-      const parser = import_node_path22.default.extname(file.path) === ".py" ? pyParser : jsParser;
+      const parser = import_node_path23.default.extname(file.path) === ".py" ? pyParser : jsParser;
       let sites;
       try {
         sites = callsFromSource(file.content, parser, knownHosts);
@@ -5055,14 +5515,14 @@ async function addHttpCallEdges(graph, services) {
         continue;
       }
       if (sites.length === 0) continue;
-      const relFile = toPosix2(import_node_path22.default.relative(service.dir, file.path));
+      const relFile = toPosix2(import_node_path23.default.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 = (0, import_types11.confidenceForExtracted)("url-literal-service-target");
+        const confidence = (0, import_types12.confidenceForExtracted)("url-literal-service-target");
         const ev = {
           file: relFile,
           line: site.line,
@@ -5076,25 +5536,25 @@ async function addHttpCallEdges(graph, services) {
         );
         nodesAdded += n;
         edgesAdded += e;
-        if (!(0, import_types11.passesExtractedFloor)(confidence)) {
+        if (!(0, import_types12.passesExtractedFloor)(confidence)) {
           noteExtractedDropped({
             source: fileNodeId,
             target: targetId,
-            type: import_types11.EdgeType.CALLS,
+            type: import_types12.EdgeType.CALLS,
             confidence,
             confidenceKind: "url-literal-service-target",
             evidence: ev
           });
           continue;
         }
-        const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, targetId, import_types11.EdgeType.CALLS);
+        const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, targetId, import_types12.EdgeType.CALLS);
         if (!graph.hasEdge(edgeId)) {
           const edge = {
             id: edgeId,
             source: fileNodeId,
             target: targetId,
-            type: import_types11.EdgeType.CALLS,
-            provenance: import_types11.Provenance.EXTRACTED,
+            type: import_types12.EdgeType.CALLS,
+            provenance: import_types12.Provenance.EXTRACTED,
             confidence,
             evidence: ev
           };
@@ -5107,10 +5567,279 @@ async function addHttpCallEdges(graph, services) {
   return { nodesAdded, edgesAdded };
 }
 
+// src/extract/calls/route-match.ts
+init_cjs_shims();
+var import_node_path24 = __toESM(require("path"), 1);
+var import_tree_sitter4 = __toESM(require("tree-sitter"), 1);
+var import_tree_sitter_javascript4 = __toESM(require("tree-sitter-javascript"), 1);
+var import_types13 = require("@neat.is/types");
+var PARSE_CHUNK4 = 16384;
+function parseSource4(parser, source) {
+  return parser.parse(
+    (index) => index >= source.length ? "" : source.slice(index, index + PARSE_CHUNK4)
+  );
+}
+function makeJsParser4() {
+  const p = new import_tree_sitter4.default();
+  p.setLanguage(import_tree_sitter_javascript4.default);
+  return p;
+}
+var JS_CLIENT_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx"]);
+var AXIOS_METHODS = /* @__PURE__ */ new Set(["get", "post", "put", "patch", "delete", "head", "options", "request"]);
+function walk2(node, visit) {
+  visit(node);
+  for (let i = 0; i < node.namedChildCount; i++) {
+    const child = node.namedChild(i);
+    if (child) walk2(child, visit);
+  }
+}
+function reconstructUrl(node) {
+  if (node.type === "string") {
+    for (let i = 0; i < node.namedChildCount; i++) {
+      const child = node.namedChild(i);
+      if (child?.type === "string_fragment") return child.text;
+    }
+    return "";
+  }
+  if (node.type === "template_string") {
+    let out = "";
+    for (let i = 0; i < node.namedChildCount; i++) {
+      const child = node.namedChild(i);
+      if (!child) continue;
+      if (child.type === "string_fragment") out += child.text;
+      else if (child.type === "template_substitution") out += ":param";
+    }
+    if (out.length === 0) {
+      const raw = node.text;
+      return raw.length >= 2 ? raw.slice(1, -1) : "";
+    }
+    return out;
+  }
+  return null;
+}
+function methodFromOptions(objNode) {
+  for (let i = 0; i < objNode.namedChildCount; i++) {
+    const pair = objNode.namedChild(i);
+    if (!pair || pair.type !== "pair") continue;
+    const k = pair.childForFieldName("key");
+    const kText = k ? k.type === "string" ? stringText(k) : k.text : null;
+    if (kText !== "method") continue;
+    const v = pair.childForFieldName("value");
+    if (v && (v.type === "string" || v.type === "template_string")) {
+      const s = stringText(v);
+      return s ? s.toUpperCase() : void 0;
+    }
+  }
+  return void 0;
+}
+function stringText(node) {
+  if (node.type === "string") {
+    for (let i = 0; i < node.namedChildCount; i++) {
+      const child = node.namedChild(i);
+      if (child?.type === "string_fragment") return child.text;
+    }
+    return "";
+  }
+  return null;
+}
+function urlNodeFromConfig(objNode) {
+  for (let i = 0; i < objNode.namedChildCount; i++) {
+    const pair = objNode.namedChild(i);
+    if (!pair || pair.type !== "pair") continue;
+    const k = pair.childForFieldName("key");
+    const kText = k ? k.type === "string" ? stringText(k) : k.text : null;
+    if (kText === "url") return pair.childForFieldName("value");
+  }
+  return null;
+}
+function pathOf(urlStr) {
+  try {
+    const candidate = urlStr.startsWith("//") ? `http:${urlStr}` : urlStr;
+    const parsed = new URL(candidate);
+    return parsed.pathname || "/";
+  } catch {
+    return null;
+  }
+}
+function matchHost(urlStr, knownHosts) {
+  for (const host of knownHosts) {
+    if (urlMatchesHost(urlStr, host)) return host;
+  }
+  return null;
+}
+function clientCallSitesFromSource(source, parser, knownHosts) {
+  const tree = parseSource4(parser, source);
+  const out = [];
+  const push = (urlNode, method, callNode) => {
+    const urlStr = reconstructUrl(urlNode);
+    if (!urlStr) return;
+    const host = matchHost(urlStr, knownHosts);
+    if (!host) return;
+    const p = pathOf(urlStr);
+    if (p === null) return;
+    const line = callNode.startPosition.row + 1;
+    out.push({
+      host,
+      method,
+      pathTemplate: p,
+      line,
+      snippet: snippet(source, line)
+    });
+  };
+  walk2(tree.rootNode, (node) => {
+    if (node.type !== "call_expression") return;
+    const fn = node.childForFieldName("function");
+    if (!fn) return;
+    const args = node.childForFieldName("arguments");
+    const first = args?.namedChild(0);
+    if (!first) return;
+    const fnName = fn.type === "identifier" ? fn.text : fn.type === "member_expression" ? fn.childForFieldName("property")?.text ?? "" : "";
+    if (fn.type === "identifier" && fnName === "fetch") {
+      const opts = args?.namedChild(1);
+      const method = opts && opts.type === "object" ? methodFromOptions(opts) ?? "GET" : "GET";
+      push(first, method, node);
+      return;
+    }
+    if (fn.type === "identifier" && fnName === "axios") {
+      if (first.type === "object") {
+        const urlNode = urlNodeFromConfig(first);
+        if (urlNode) push(urlNode, methodFromOptions(first) ?? "GET", node);
+      } else {
+        const opts = args?.namedChild(1);
+        const method = opts && opts.type === "object" ? methodFromOptions(opts) ?? "GET" : "GET";
+        push(first, method, node);
+      }
+      return;
+    }
+    if (fn.type === "member_expression") {
+      const obj = fn.childForFieldName("object");
+      const objName = obj?.text ?? "";
+      if (objName === "axios" && AXIOS_METHODS.has(fnName)) {
+        if (fnName === "request" && first.type === "object") {
+          const urlNode = urlNodeFromConfig(first);
+          if (urlNode) push(urlNode, methodFromOptions(first) ?? "GET", node);
+        } else {
+          push(first, fnName.toUpperCase(), node);
+        }
+        return;
+      }
+      if ((objName === "http" || objName === "https") && (fnName === "request" || fnName === "get")) {
+        const opts = args?.namedChild(1);
+        const method = opts && opts.type === "object" ? methodFromOptions(opts) ?? (fnName === "get" ? "GET" : "GET") : "GET";
+        push(first, method, node);
+        return;
+      }
+    }
+  });
+  return out;
+}
+function buildRouteIndex(graph) {
+  const index = /* @__PURE__ */ new Map();
+  graph.forEachNode((_id, attrs) => {
+    const node = attrs;
+    if (node.type !== import_types13.NodeType.RouteNode) return;
+    const route = attrs;
+    const owner = (0, import_types13.serviceId)(route.service);
+    const entry = {
+      method: route.method.toUpperCase(),
+      normalizedPath: normalizePathTemplate(route.pathTemplate),
+      routeNodeId: route.id
+    };
+    const list = index.get(owner);
+    if (list) list.push(entry);
+    else index.set(owner, [entry]);
+  });
+  return index;
+}
+function findRoute(entries, method, normalizedPath) {
+  return entries.find(
+    (e) => e.normalizedPath === normalizedPath && (e.method === "ALL" || method === void 0 || e.method === method)
+  );
+}
+async function addRouteCallEdges(graph, services) {
+  const jsParser = makeJsParser4();
+  const { knownHosts, hostToNodeId } = buildServiceHostIndex(services);
+  const routeIndex = buildRouteIndex(graph);
+  if (routeIndex.size === 0) return { nodesAdded: 0, edgesAdded: 0 };
+  let nodesAdded = 0;
+  let edgesAdded = 0;
+  for (const service of services) {
+    const files = await loadSourceFiles(service.dir);
+    const seen = /* @__PURE__ */ new Set();
+    for (const file of files) {
+      if (isTestPath(file.path)) continue;
+      if (!JS_CLIENT_EXTENSIONS.has(import_node_path24.default.extname(file.path))) continue;
+      let sites;
+      try {
+        sites = clientCallSitesFromSource(file.content, jsParser, knownHosts);
+      } catch (err) {
+        recordExtractionError("route-match call extraction", file.path, err);
+        continue;
+      }
+      if (sites.length === 0) continue;
+      const relFile = toPosix2(import_node_path24.default.relative(service.dir, file.path));
+      for (const site of sites) {
+        const serverServiceId = hostToNodeId.get(site.host);
+        if (!serverServiceId || serverServiceId === service.node.id) continue;
+        const entries = routeIndex.get(serverServiceId);
+        if (!entries) continue;
+        const normalizedPath = normalizePathTemplate(site.pathTemplate);
+        const match = findRoute(entries, site.method, normalizedPath);
+        if (!match) continue;
+        const dedupKey = `${relFile}|${match.routeNodeId}`;
+        if (seen.has(dedupKey)) continue;
+        seen.add(dedupKey);
+        const { fileNodeId, nodesAdded: n, edgesAdded: e } = ensureFileNode(
+          graph,
+          service.pkg.name,
+          service.node.id,
+          relFile
+        );
+        nodesAdded += n;
+        edgesAdded += e;
+        const confidence = (0, import_types13.confidenceForExtracted)("verified-call-site");
+        const ev = {
+          file: relFile,
+          line: site.line,
+          snippet: site.snippet,
+          method: site.method ?? match.method,
+          pathTemplate: site.pathTemplate
+        };
+        if (!(0, import_types13.passesExtractedFloor)(confidence)) {
+          noteExtractedDropped({
+            source: fileNodeId,
+            target: match.routeNodeId,
+            type: import_types13.EdgeType.CALLS,
+            confidence,
+            confidenceKind: "verified-call-site",
+            evidence: ev
+          });
+          continue;
+        }
+        const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, match.routeNodeId, import_types13.EdgeType.CALLS);
+        if (!graph.hasEdge(edgeId)) {
+          const edge = {
+            id: edgeId,
+            source: fileNodeId,
+            target: match.routeNodeId,
+            type: import_types13.EdgeType.CALLS,
+            provenance: import_types13.Provenance.EXTRACTED,
+            confidence,
+            evidence: ev
+          };
+          graph.addEdgeWithKey(edgeId, fileNodeId, match.routeNodeId, edge);
+          edgesAdded++;
+        }
+      }
+    }
+  }
+  return { nodesAdded, edgesAdded };
+}
+
 // src/extract/calls/kafka.ts
 init_cjs_shims();
-var import_node_path23 = __toESM(require("path"), 1);
-var import_types12 = require("@neat.is/types");
+var import_node_path25 = __toESM(require("path"), 1);
+var import_types14 = require("@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;
 function findAll(re, text) {
@@ -5131,7 +5860,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
     seen.add(key);
     const line = lineOf(file.content, topic);
     out.push({
-      infraId: (0, import_types12.infraId)("kafka-topic", topic),
+      infraId: (0, import_types14.infraId)("kafka-topic", topic),
       name: topic,
       kind: "kafka-topic",
       edgeType,
@@ -5140,7 +5869,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path23.default.relative(serviceDir, file.path),
+        file: import_node_path25.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5153,8 +5882,8 @@ function kafkaEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/redis.ts
 init_cjs_shims();
-var import_node_path24 = __toESM(require("path"), 1);
-var import_types13 = require("@neat.is/types");
+var import_node_path26 = __toESM(require("path"), 1);
+var import_types15 = require("@neat.is/types");
 var REDIS_URL_RE = /redis(?:s)?:\/\/(?:[^@'"`\s]+@)?([^:/'"`\s]+)(?::(\d+))?/g;
 function redisEndpointsFromFile(file, serviceDir) {
   const out = [];
@@ -5167,7 +5896,7 @@ function redisEndpointsFromFile(file, serviceDir) {
     seen.add(host);
     const line = lineOf(file.content, host);
     out.push({
-      infraId: (0, import_types13.infraId)("redis", host),
+      infraId: (0, import_types15.infraId)("redis", host),
       name: host,
       kind: "redis",
       edgeType: "CALLS",
@@ -5176,7 +5905,7 @@ function redisEndpointsFromFile(file, serviceDir) {
       // support tier (ADR-066).
       confidenceKind: "url-with-structural-support",
       evidence: {
-        file: import_node_path24.default.relative(serviceDir, file.path),
+        file: import_node_path26.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5187,8 +5916,8 @@ function redisEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/aws.ts
 init_cjs_shims();
-var import_node_path25 = __toESM(require("path"), 1);
-var import_types14 = require("@neat.is/types");
+var import_node_path27 = __toESM(require("path"), 1);
+var import_types16 = require("@neat.is/types");
 var S3_BUCKET_RE = /Bucket\s*:\s*['"`]([^'"`]+)['"`]/g;
 var DYNAMO_TABLE_RE = /TableName\s*:\s*['"`]([^'"`]+)['"`]/g;
 function hasMarker(text, markers) {
@@ -5212,7 +5941,7 @@ function awsEndpointsFromFile(file, serviceDir) {
     seen.add(key);
     const line = lineOf(file.content, name);
     out.push({
-      infraId: (0, import_types14.infraId)(kind, name),
+      infraId: (0, import_types16.infraId)(kind, name),
       name,
       kind,
       edgeType: "CALLS",
@@ -5221,7 +5950,7 @@ function awsEndpointsFromFile(file, serviceDir) {
       // (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path25.default.relative(serviceDir, file.path),
+        file: import_node_path27.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5246,8 +5975,8 @@ function awsEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/grpc.ts
 init_cjs_shims();
-var import_node_path26 = __toESM(require("path"), 1);
-var import_types15 = require("@neat.is/types");
+var import_node_path28 = __toESM(require("path"), 1);
+var import_types17 = require("@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;
 var GRPC_IMPORT_RE = /(?:from\s+['"`]|require\(\s*['"`])@grpc\/grpc-js['"`]|_grpc_pb['"`]/;
@@ -5296,7 +6025,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
     const { kind } = classified;
     const line = lineOf(file.content, m[0]);
     out.push({
-      infraId: (0, import_types15.infraId)(kind, name),
+      infraId: (0, import_types17.infraId)(kind, name),
       name,
       kind,
       edgeType: "CALLS",
@@ -5305,7 +6034,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path26.default.relative(serviceDir, file.path),
+        file: import_node_path28.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5316,8 +6045,8 @@ function grpcEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/supabase.ts
 init_cjs_shims();
-var import_node_path27 = __toESM(require("path"), 1);
-var import_types16 = require("@neat.is/types");
+var import_node_path29 = __toESM(require("path"), 1);
+var import_types18 = require("@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['"`]/;
 var SUPABASE_CLIENT_RE = /\b(createClient|createServerClient|createBrowserClient)\s*\(\s*(?:['"`]([^'"`]*)['"`])?/g;
@@ -5355,7 +6084,7 @@ function supabaseEndpointsFromFile(file, serviceDir) {
     seen.add(name);
     const line = lineOf(file.content, m[0]);
     out.push({
-      infraId: (0, import_types16.infraId)("supabase", name),
+      infraId: (0, import_types18.infraId)("supabase", name),
       name,
       kind: "supabase",
       edgeType: "CALLS",
@@ -5365,7 +6094,7 @@ function supabaseEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066), the same grade aws.ts / grpc.ts emit at.
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path27.default.relative(serviceDir, file.path),
+        file: import_node_path29.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5378,11 +6107,11 @@ function supabaseEndpointsFromFile(file, serviceDir) {
 function edgeTypeFromEndpoint(ep) {
   switch (ep.edgeType) {
     case "PUBLISHES_TO":
-      return import_types17.EdgeType.PUBLISHES_TO;
+      return import_types19.EdgeType.PUBLISHES_TO;
     case "CONSUMES_FROM":
-      return import_types17.EdgeType.CONSUMES_FROM;
+      return import_types19.EdgeType.CONSUMES_FROM;
     default:
-      return import_types17.EdgeType.CALLS;
+      return import_types19.EdgeType.CALLS;
   }
 }
 function isAwsKind(kind) {
@@ -5410,7 +6139,7 @@ async function addExternalEndpointEdges(graph, services) {
       if (!graph.hasNode(ep.infraId)) {
         const node = {
           id: ep.infraId,
-          type: import_types17.NodeType.InfraNode,
+          type: import_types19.NodeType.InfraNode,
           name: ep.name,
           // #238 — `aws-*` covers AWS-SDK client kinds (aws-s3, aws-dynamodb,
           // aws-cognito-identity-provider, …); `s3-` / `dynamodb-` cover the
@@ -5422,7 +6151,7 @@ async function addExternalEndpointEdges(graph, services) {
         nodesAdded++;
       }
       const edgeType = edgeTypeFromEndpoint(ep);
-      const confidence = (0, import_types17.confidenceForExtracted)(ep.confidenceKind);
+      const confidence = (0, import_types19.confidenceForExtracted)(ep.confidenceKind);
       const relFile = toPosix2(ep.evidence.file);
       const { fileNodeId, nodesAdded: n, edgesAdded: e } = ensureFileNode(
         graph,
@@ -5432,7 +6161,7 @@ async function addExternalEndpointEdges(graph, services) {
       );
       nodesAdded += n;
       edgesAdded += e;
-      if (!(0, import_types17.passesExtractedFloor)(confidence)) {
+      if (!(0, import_types19.passesExtractedFloor)(confidence)) {
         noteExtractedDropped({
           source: fileNodeId,
           target: ep.infraId,
@@ -5452,7 +6181,7 @@ async function addExternalEndpointEdges(graph, services) {
           source: fileNodeId,
           target: ep.infraId,
           type: edgeType,
-          provenance: import_types17.Provenance.EXTRACTED,
+          provenance: import_types19.Provenance.EXTRACTED,
           confidence,
           evidence: ep.evidence
         };
@@ -5466,9 +6195,10 @@ async function addExternalEndpointEdges(graph, services) {
 async function addCallEdges(graph, services) {
   const http = await addHttpCallEdges(graph, services);
   const ext = await addExternalEndpointEdges(graph, services);
+  const routes = await addRouteCallEdges(graph, services);
   return {
-    nodesAdded: http.nodesAdded + ext.nodesAdded,
-    edgesAdded: http.edgesAdded + ext.edgesAdded
+    nodesAdded: http.nodesAdded + ext.nodesAdded + routes.nodesAdded,
+    edgesAdded: http.edgesAdded + ext.edgesAdded + routes.edgesAdded
   };
 }
 
@@ -5477,16 +6207,16 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path28 = __toESM(require("path"), 1);
-var import_types19 = require("@neat.is/types");
+var import_node_path30 = __toESM(require("path"), 1);
+var import_types21 = require("@neat.is/types");
 
 // src/extract/infra/shared.ts
 init_cjs_shims();
-var import_types18 = require("@neat.is/types");
+var import_types20 = require("@neat.is/types");
 function makeInfraNode(kind, name, provider = "self", extras) {
   return {
-    id: (0, import_types18.infraId)(kind, name),
-    type: import_types18.NodeType.InfraNode,
+    id: (0, import_types20.infraId)(kind, name),
+    type: import_types20.NodeType.InfraNode,
     name,
     provider,
     kind,
@@ -5515,7 +6245,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path28.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path30.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -5524,7 +6254,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 = import_node_path28.default.join(scanPath, name);
+    const abs = import_node_path30.default.join(scanPath, name);
     if (await exists(abs)) {
       composePath = abs;
       break;
@@ -5537,13 +6267,13 @@ async function addComposeInfra(graph, scanPath, services) {
   } catch (err) {
     recordExtractionError(
       "infra docker-compose",
-      import_node_path28.default.relative(scanPath, composePath),
+      import_node_path30.default.relative(scanPath, composePath),
       err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path28.default.relative(scanPath, composePath).split(import_node_path28.default.sep).join("/");
+  const evidenceFile = import_node_path30.default.relative(scanPath, composePath).split(import_node_path30.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -5565,15 +6295,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 = (0, import_types4.extractedEdgeId)(sourceId, targetId, import_types19.EdgeType.DEPENDS_ON);
+      const edgeId = (0, import_types4.extractedEdgeId)(sourceId, targetId, import_types21.EdgeType.DEPENDS_ON);
       if (graph.hasEdge(edgeId)) continue;
       const edge = {
         id: edgeId,
         source: sourceId,
         target: targetId,
-        type: import_types19.EdgeType.DEPENDS_ON,
-        provenance: import_types19.Provenance.EXTRACTED,
-        confidence: (0, import_types19.confidenceForExtracted)("structural"),
+        type: import_types21.EdgeType.DEPENDS_ON,
+        provenance: import_types21.Provenance.EXTRACTED,
+        confidence: (0, import_types21.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -5585,9 +6315,9 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path29 = __toESM(require("path"), 1);
+var import_node_path31 = __toESM(require("path"), 1);
 var import_node_fs15 = require("fs");
-var import_types20 = require("@neat.is/types");
+var import_types22 = require("@neat.is/types");
 function readDockerfile(content) {
   let image = null;
   const ports = [];
@@ -5616,7 +6346,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path29.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path31.default.join(service.dir, "Dockerfile");
     if (!await exists(dockerfilePath)) continue;
     let content;
     try {
@@ -5624,7 +6354,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     } catch (err) {
       recordExtractionError(
         "infra dockerfile",
-        import_node_path29.default.relative(scanPath, dockerfilePath),
+        import_node_path31.default.relative(scanPath, dockerfilePath),
         err
       );
       continue;
@@ -5636,8 +6366,8 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const relDockerfile = toPosix2(import_node_path29.default.relative(service.dir, dockerfilePath));
-    const evidenceFile = toPosix2(import_node_path29.default.relative(scanPath, dockerfilePath));
+    const relDockerfile = toPosix2(import_node_path31.default.relative(service.dir, dockerfilePath));
+    const evidenceFile = toPosix2(import_node_path31.default.relative(scanPath, dockerfilePath));
     const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
       graph,
       service.pkg.name,
@@ -5646,15 +6376,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     );
     nodesAdded += fn;
     edgesAdded += fe;
-    const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, node.id, import_types20.EdgeType.RUNS_ON);
+    const edgeId = (0, import_types4.extractedEdgeId)(fileNodeId, node.id, import_types22.EdgeType.RUNS_ON);
     if (!graph.hasEdge(edgeId)) {
       const edge = {
         id: edgeId,
         source: fileNodeId,
         target: node.id,
-        type: import_types20.EdgeType.RUNS_ON,
-        provenance: import_types20.Provenance.EXTRACTED,
-        confidence: (0, import_types20.confidenceForExtracted)("structural"),
+        type: import_types22.EdgeType.RUNS_ON,
+        provenance: import_types22.Provenance.EXTRACTED,
+        confidence: (0, import_types22.confidenceForExtracted)("structural"),
         evidence: {
           file: evidenceFile,
           ...facts.entrypoint ? { snippet: facts.entrypoint.slice(0, 120) } : {}
@@ -5669,15 +6399,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
         graph.addNode(portNode.id, portNode);
         nodesAdded++;
       }
-      const portEdgeId = (0, import_types4.extractedEdgeId)(fileNodeId, portNode.id, import_types20.EdgeType.CONNECTS_TO);
+      const portEdgeId = (0, import_types4.extractedEdgeId)(fileNodeId, portNode.id, import_types22.EdgeType.CONNECTS_TO);
       if (graph.hasEdge(portEdgeId)) continue;
       const portEdge = {
         id: portEdgeId,
         source: fileNodeId,
         target: portNode.id,
-        type: import_types20.EdgeType.CONNECTS_TO,
-        provenance: import_types20.Provenance.EXTRACTED,
-        confidence: (0, import_types20.confidenceForExtracted)("structural"),
+        type: import_types22.EdgeType.CONNECTS_TO,
+        provenance: import_types22.Provenance.EXTRACTED,
+        confidence: (0, import_types22.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile, snippet: `EXPOSE ${port}` }
       };
       graph.addEdgeWithKey(portEdgeId, portEdge.source, portEdge.target, portEdge);
@@ -5690,8 +6420,8 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 // src/extract/infra/terraform.ts
 init_cjs_shims();
 var import_node_fs16 = require("fs");
-var import_node_path30 = __toESM(require("path"), 1);
-var import_types21 = require("@neat.is/types");
+var import_node_path32 = __toESM(require("path"), 1);
+var import_types23 = require("@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) {
@@ -5701,11 +6431,11 @@ async function walkTfFiles(start, depth = 0, max = 5) {
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name) || entry.name === ".terraform") continue;
-      const child = import_node_path30.default.join(start, entry.name);
+      const child = import_node_path32.default.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(import_node_path30.default.join(start, entry.name));
+      out.push(import_node_path32.default.join(start, entry.name));
     }
   }
   return out;
@@ -5737,7 +6467,7 @@ async function addTerraformResources(graph, scanPath) {
   const files = await walkTfFiles(scanPath);
   for (const file of files) {
     const content = await import_node_fs16.promises.readFile(file, "utf8");
-    const evidenceFile = toPosix2(import_node_path30.default.relative(scanPath, file));
+    const evidenceFile = toPosix2(import_node_path32.default.relative(scanPath, file));
     const resources = [];
     const byKey = /* @__PURE__ */ new Map();
     RESOURCE_RE.lastIndex = 0;
@@ -5772,16 +6502,16 @@ async function addTerraformResources(graph, scanPath) {
         if (!target) continue;
         if (seen.has(target.nodeId)) continue;
         seen.add(target.nodeId);
-        const edgeId = (0, import_types4.extractedEdgeId)(resource.nodeId, target.nodeId, import_types21.EdgeType.DEPENDS_ON);
+        const edgeId = (0, import_types4.extractedEdgeId)(resource.nodeId, target.nodeId, import_types23.EdgeType.DEPENDS_ON);
         if (graph.hasEdge(edgeId)) continue;
         const line = lineAt(content, resource.bodyOffset + ref.index);
         const edge = {
           id: edgeId,
           source: resource.nodeId,
           target: target.nodeId,
-          type: import_types21.EdgeType.DEPENDS_ON,
-          provenance: import_types21.Provenance.EXTRACTED,
-          confidence: (0, import_types21.confidenceForExtracted)("structural"),
+          type: import_types23.EdgeType.DEPENDS_ON,
+          provenance: import_types23.Provenance.EXTRACTED,
+          confidence: (0, import_types23.confidenceForExtracted)("structural"),
           evidence: { file: evidenceFile, line, snippet: key }
         };
         graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -5795,7 +6525,7 @@ async function addTerraformResources(graph, scanPath) {
 // src/extract/infra/k8s.ts
 init_cjs_shims();
 var import_node_fs17 = require("fs");
-var import_node_path31 = __toESM(require("path"), 1);
+var import_node_path33 = __toESM(require("path"), 1);
 var import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -5813,11 +6543,11 @@ async function walkYamlFiles2(start, depth = 0, max = 5) {
   for (const entry of entries) {
     if (entry.isDirectory()) {
       if (IGNORED_DIRS.has(entry.name)) continue;
-      const child = import_node_path31.default.join(start, entry.name);
+      const child = import_node_path33.default.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(import_node_path31.default.extname(entry.name))) {
-      out.push(import_node_path31.default.join(start, entry.name));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path33.default.extname(entry.name))) {
+      out.push(import_node_path33.default.join(start, entry.name));
     }
   }
   return out;
@@ -5861,17 +6591,17 @@ async function addInfra(graph, scanPath, services) {
 }
 
 // src/extract/index.ts
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_path35 = __toESM(require("path"), 1);
 
 // src/extract/retire.ts
 init_cjs_shims();
 var import_node_fs18 = require("fs");
-var import_node_path32 = __toESM(require("path"), 1);
-var import_types22 = require("@neat.is/types");
+var import_node_path34 = __toESM(require("path"), 1);
+var import_types24 = require("@neat.is/types");
 function dropOrphanedFileNodes(graph) {
   const orphans = [];
   graph.forEachNode((id, attrs) => {
-    if (attrs.type !== import_types22.NodeType.FileNode) return;
+    if (attrs.type !== import_types24.NodeType.FileNode) return;
     if (graph.inboundEdges(id).length === 0 && graph.outboundEdges(id).length === 0) {
       orphans.push(id);
     }
@@ -5884,14 +6614,14 @@ function retireExtractedEdgesByMissingFile(graph, scanPath, serviceDirs = []) {
   const bases = [scanPath, ...serviceDirs];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== import_types22.Provenance.EXTRACTED) return;
+    if (edge.provenance !== import_types24.Provenance.EXTRACTED) return;
     const evidenceFile = edge.evidence?.file;
     if (!evidenceFile) return;
-    if (import_node_path32.default.isAbsolute(evidenceFile)) {
+    if (import_node_path34.default.isAbsolute(evidenceFile)) {
       if (!(0, import_node_fs18.existsSync)(evidenceFile)) toDrop.push(id);
       return;
     }
-    const found = bases.some((base) => (0, import_node_fs18.existsSync)(import_node_path32.default.join(base, evidenceFile)));
+    const found = bases.some((base) => (0, import_node_fs18.existsSync)(import_node_path34.default.join(base, evidenceFile)));
     if (!found) toDrop.push(id);
   });
   for (const id of toDrop) graph.dropEdge(id);
@@ -5910,6 +6640,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   const importGraph = await addImports(graph, services);
   const phase2 = await addDatabasesAndCompat(graph, services, scanPath);
   const phase3 = await addConfigNodes(graph, services, scanPath);
+  const routePhase = await addRoutes(graph, services);
   const phase4 = await addCallEdges(graph, services);
   const phase5 = await addInfra(graph, scanPath, services);
   const ghostsRetired = retireExtractedEdgesByMissingFile(
@@ -5931,7 +6662,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
-    const rejectedPath = import_node_path33.default.join(import_node_path33.default.dirname(opts.errorsPath), "rejected.ndjson");
+    const rejectedPath = import_node_path35.default.join(import_node_path35.default.dirname(opts.errorsPath), "rejected.ndjson");
     try {
       await writeRejectedExtracted(droppedEntries, rejectedPath);
     } catch (err) {
@@ -5941,8 +6672,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
     }
   }
   const result = {
-    nodesAdded: phase1Nodes + fileEnum.nodesAdded + importGraph.nodesAdded + phase2.nodesAdded + phase3.nodesAdded + phase4.nodesAdded + phase5.nodesAdded,
-    edgesAdded: fileEnum.edgesAdded + importGraph.edgesAdded + phase2.edgesAdded + phase3.edgesAdded + phase4.edgesAdded + phase5.edgesAdded,
+    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,
     frontiersPromoted,
     extractionErrors: errorEntries.length,
     errorEntries,
@@ -5966,8 +6697,8 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
 // src/persist.ts
 init_cjs_shims();
 var import_node_fs19 = require("fs");
-var import_node_path34 = __toESM(require("path"), 1);
-var import_types23 = require("@neat.is/types");
+var import_node_path36 = __toESM(require("path"), 1);
+var import_types25 = require("@neat.is/types");
 var SCHEMA_VERSION = 4;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -5989,12 +6720,12 @@ function migrateV2ToV3(payload) {
     for (const edge of edges) {
       const attrs = edge.attributes;
       if (!attrs || attrs.provenance !== "FRONTIER") continue;
-      attrs.provenance = import_types23.Provenance.OBSERVED;
+      attrs.provenance = import_types25.Provenance.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;
       if (type && source && target) {
-        const newId = (0, import_types23.observedEdgeId)(source, target, type);
+        const newId = (0, import_types25.observedEdgeId)(source, target, type);
         attrs.id = newId;
         if (edge.key) edge.key = newId;
       }
@@ -6003,7 +6734,7 @@ function migrateV2ToV3(payload) {
   return { ...payload, schemaVersion: 3 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs19.promises.mkdir(import_node_path34.default.dirname(filePath), { recursive: true });
+  await import_node_fs19.promises.mkdir(import_node_path36.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -6086,19 +6817,19 @@ function startPersistLoop(graph, outPath, opts = {}) {
 init_cjs_shims();
 var import_fastify = __toESM(require("fastify"), 1);
 var import_cors = __toESM(require("@fastify/cors"), 1);
-var import_types26 = require("@neat.is/types");
+var import_types28 = require("@neat.is/types");
 
 // src/extend/index.ts
 init_cjs_shims();
 var import_node_fs21 = require("fs");
-var import_node_path36 = __toESM(require("path"), 1);
+var import_node_path38 = __toESM(require("path"), 1);
 var import_node_os2 = __toESM(require("os"), 1);
 var import_instrumentation_registry = require("@neat.is/instrumentation-registry");
 
 // src/installers/package-manager.ts
 init_cjs_shims();
 var import_node_fs20 = require("fs");
-var import_node_path35 = __toESM(require("path"), 1);
+var import_node_path37 = __toESM(require("path"), 1);
 var import_node_child_process = require("child_process");
 var LOCKFILE_PRIORITY = [
   { lockfile: "bun.lockb", pm: "bun", args: ["install", "--no-summary"] },
@@ -6120,22 +6851,22 @@ async function exists2(p) {
   }
 }
 async function detectPackageManager(serviceDir) {
-  let dir = import_node_path35.default.resolve(serviceDir);
+  let dir = import_node_path37.default.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 = import_node_path35.default.join(dir, candidate.lockfile);
+      const lockPath = import_node_path37.default.join(dir, candidate.lockfile);
       if (await exists2(lockPath)) {
         return { pm: candidate.pm, cwd: dir, args: [...candidate.args] };
       }
     }
-    const parent = import_node_path35.default.dirname(dir);
+    const parent = import_node_path37.default.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
-  return { pm: "npm", cwd: import_node_path35.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
+  return { pm: "npm", cwd: import_node_path37.default.resolve(serviceDir), args: [...NPM_FALLBACK_ARGS] };
 }
 async function runPackageManagerInstall(cmd) {
   return new Promise((resolve) => {
@@ -6184,7 +6915,7 @@ async function fileExists2(p) {
   }
 }
 async function readPackageJson(scanPath) {
-  const pkgPath = import_node_path36.default.join(scanPath, "package.json");
+  const pkgPath = import_node_path38.default.join(scanPath, "package.json");
   const raw = await import_node_fs21.promises.readFile(pkgPath, "utf8");
   return JSON.parse(raw);
 }
@@ -6195,11 +6926,11 @@ async function findHookFiles(scanPath) {
   ).sort();
 }
 function extendLogPath() {
-  return process.env.NEAT_EXTEND_LOG ?? import_node_path36.default.join(import_node_os2.default.homedir(), ".neat", "extend-log.ndjson");
+  return process.env.NEAT_EXTEND_LOG ?? import_node_path38.default.join(import_node_os2.default.homedir(), ".neat", "extend-log.ndjson");
 }
 async function appendExtendLog(entry) {
   const logPath = extendLogPath();
-  await import_node_fs21.promises.mkdir(import_node_path36.default.dirname(logPath), { recursive: true });
+  await import_node_fs21.promises.mkdir(import_node_path38.default.dirname(logPath), { recursive: true });
   await import_node_fs21.promises.appendFile(logPath, JSON.stringify(entry) + "\n", "utf8");
 }
 function splicedContent(fileContent, snippet2) {
@@ -6258,7 +6989,7 @@ function lookupInstrumentation(library, installedVersion) {
 }
 async function describeProjectInstrumentation(ctx) {
   const hookFiles = await findHookFiles(ctx.scanPath);
-  const envNeat = await fileExists2(import_node_path36.default.join(ctx.scanPath, ".env.neat"));
+  const envNeat = await fileExists2(import_node_path38.default.join(ctx.scanPath, ".env.neat"));
   const registryInstrPackages = new Set(
     (0, import_instrumentation_registry.list)().map((e) => e.instrumentation_package).filter((p) => !!p)
   );
@@ -6280,16 +7011,16 @@ async function applyExtension(ctx, args, options) {
     );
   }
   for (const file of hookFiles) {
-    const content = await import_node_fs21.promises.readFile(import_node_path36.default.join(ctx.scanPath, file), "utf8");
+    const content = await import_node_fs21.promises.readFile(import_node_path38.default.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 = import_node_path36.default.join(ctx.scanPath, primaryFile);
+  const primaryPath = import_node_path38.default.join(ctx.scanPath, primaryFile);
   const filesTouched = [];
   const depsAdded = [];
-  const pkgPath = import_node_path36.default.join(ctx.scanPath, "package.json");
+  const pkgPath = import_node_path38.default.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 };
@@ -6335,7 +7066,7 @@ async function dryRunExtension(ctx, args) {
     };
   }
   for (const file of hookFiles) {
-    const content = await import_node_fs21.promises.readFile(import_node_path36.default.join(ctx.scanPath, file), "utf8");
+    const content = await import_node_fs21.promises.readFile(import_node_path38.default.join(ctx.scanPath, file), "utf8");
     if (content.includes(args.registration_snippet)) {
       return {
         library: args.library,
@@ -6357,7 +7088,7 @@ async function dryRunExtension(ctx, args) {
     depsToAdd.push(`${args.instrumentation_package}@${args.version}`);
     filesTouched.push("package.json");
   }
-  const hookContent = await import_node_fs21.promises.readFile(import_node_path36.default.join(ctx.scanPath, primaryFile), "utf8");
+  const hookContent = await import_node_fs21.promises.readFile(import_node_path38.default.join(ctx.scanPath, primaryFile), "utf8");
   const patched = splicedContent(hookContent, args.registration_snippet);
   if (patched) {
     filesTouched.push(primaryFile);
@@ -6378,7 +7109,7 @@ async function rollbackExtension(ctx, args) {
   if (!match) {
     return { undone: false, message: "no apply found for library" };
   }
-  const pkgPath = import_node_path36.default.join(ctx.scanPath, "package.json");
+  const pkgPath = import_node_path38.default.join(ctx.scanPath, "package.json");
   if (await fileExists2(pkgPath)) {
     const pkg = await readPackageJson(ctx.scanPath);
     if (pkg.dependencies?.[match.instrumentation_package]) {
@@ -6389,7 +7120,7 @@ async function rollbackExtension(ctx, args) {
   }
   const hookFiles = await findHookFiles(ctx.scanPath);
   for (const file of hookFiles) {
-    const filePath = import_node_path36.default.join(ctx.scanPath, file);
+    const filePath = import_node_path38.default.join(ctx.scanPath, file);
     const content = await import_node_fs21.promises.readFile(filePath, "utf8");
     if (content.includes(match.registration_snippet)) {
       const filtered = content.split("\n").filter((line) => !line.includes(match.registration_snippet)).join("\n");
@@ -6405,7 +7136,7 @@ async function rollbackExtension(ctx, args) {
 
 // src/divergences.ts
 init_cjs_shims();
-var import_types24 = require("@neat.is/types");
+var import_types26 = require("@neat.is/types");
 function bucketKey(source, target, type) {
   return `${type}|${source}|${target}`;
 }
@@ -6413,22 +7144,22 @@ function bucketEdges(graph) {
   const buckets = /* @__PURE__ */ new Map();
   graph.forEachEdge((id, attrs) => {
     const e = attrs;
-    const parsed = (0, import_types24.parseEdgeId)(id);
+    const parsed = (0, import_types26.parseEdgeId)(id);
     const provenance = parsed?.provenance ?? e.provenance;
     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 import_types24.Provenance.EXTRACTED:
+      case import_types26.Provenance.EXTRACTED:
         cur.extracted = e;
         break;
-      case import_types24.Provenance.OBSERVED:
+      case import_types26.Provenance.OBSERVED:
         cur.observed = e;
         break;
-      case import_types24.Provenance.INFERRED:
+      case import_types26.Provenance.INFERRED:
         cur.inferred = e;
         break;
       default:
-        if (e.provenance === import_types24.Provenance.STALE) cur.stale = e;
+        if (e.provenance === import_types26.Provenance.STALE) cur.stale = e;
     }
     buckets.set(key, cur);
   });
@@ -6437,7 +7168,7 @@ function bucketEdges(graph) {
 function nodeIsFrontier(graph, nodeId) {
   if (!graph.hasNode(nodeId)) return false;
   const attrs = graph.getNodeAttributes(nodeId);
-  return attrs.type === import_types24.NodeType.FrontierNode;
+  return attrs.type === import_types26.NodeType.FrontierNode;
 }
 function clampConfidence(n) {
   if (!Number.isFinite(n)) return 0;
@@ -6457,14 +7188,14 @@ function gradedConfidence(edge) {
   return clampConfidence(confidenceForEdge(edge));
 }
 var OBSERVABLE_EDGE_TYPES = /* @__PURE__ */ new Set([
-  import_types24.EdgeType.CALLS,
-  import_types24.EdgeType.CONNECTS_TO,
-  import_types24.EdgeType.PUBLISHES_TO,
-  import_types24.EdgeType.CONSUMES_FROM
+  import_types26.EdgeType.CALLS,
+  import_types26.EdgeType.CONNECTS_TO,
+  import_types26.EdgeType.PUBLISHES_TO,
+  import_types26.EdgeType.CONSUMES_FROM
 ]);
 function detectMissingDivergences(graph, bucket) {
   const out = [];
-  if (bucket.type === import_types24.EdgeType.CONTAINS) return out;
+  if (bucket.type === import_types26.EdgeType.CONTAINS) return out;
   if (bucket.extracted && !bucket.observed && OBSERVABLE_EDGE_TYPES.has(bucket.type)) {
     if (!nodeIsFrontier(graph, bucket.target)) {
       out.push({
@@ -6505,7 +7236,7 @@ function declaredHostFor(svc) {
 function hasExtractedConfiguredBy(graph, svcId) {
   for (const edgeId of graph.outboundEdges(svcId)) {
     const e = graph.getEdgeAttributes(edgeId);
-    if (e.type === import_types24.EdgeType.CONFIGURED_BY && e.provenance === import_types24.Provenance.EXTRACTED) {
+    if (e.type === import_types26.EdgeType.CONFIGURED_BY && e.provenance === import_types26.Provenance.EXTRACTED) {
       return true;
     }
   }
@@ -6518,10 +7249,10 @@ function detectHostMismatch(graph, svcId, svc) {
   const out = [];
   for (const edgeId of graph.outboundEdges(svcId)) {
     const edge = graph.getEdgeAttributes(edgeId);
-    if (edge.type !== import_types24.EdgeType.CONNECTS_TO) continue;
-    if (edge.provenance !== import_types24.Provenance.OBSERVED) continue;
+    if (edge.type !== import_types26.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types26.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types24.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types26.NodeType.DatabaseNode) continue;
     const observedHost = target.host?.trim();
     if (!observedHost) continue;
     if (observedHost === declaredHost) continue;
@@ -6543,10 +7274,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 !== import_types24.EdgeType.CONNECTS_TO) continue;
-    if (edge.provenance !== import_types24.Provenance.OBSERVED) continue;
+    if (edge.type !== import_types26.EdgeType.CONNECTS_TO) continue;
+    if (edge.provenance !== import_types26.Provenance.OBSERVED) continue;
     const target = graph.getNodeAttributes(edge.target);
-    if (target.type !== import_types24.NodeType.DatabaseNode) continue;
+    if (target.type !== import_types26.NodeType.DatabaseNode) continue;
     for (const pair of compatPairs()) {
       if (pair.engine !== target.engine) continue;
       const declared = deps[pair.driver];
@@ -6605,7 +7336,7 @@ function suppressHostMismatchHalves(all) {
   for (const d of all) {
     if (d.type !== "host-mismatch") continue;
     observedHalf.add(`${d.source}->${d.target}`);
-    declaredHalf.add((0, import_types24.databaseId)(d.extractedHost));
+    declaredHalf.add((0, import_types26.databaseId)(d.extractedHost));
   }
   if (observedHalf.size === 0) return all;
   return all.filter((d) => {
@@ -6624,7 +7355,7 @@ function computeDivergences(graph, opts = {}) {
   }
   graph.forEachNode((nodeId, attrs) => {
     const n = attrs;
-    if (n.type !== import_types24.NodeType.ServiceNode) return;
+    if (n.type !== import_types26.NodeType.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);
@@ -6658,7 +7389,7 @@ function computeDivergences(graph, opts = {}) {
     if (a.source !== b.source) return a.source.localeCompare(b.source);
     return a.target.localeCompare(b.target);
   });
-  return import_types24.DivergenceResultSchema.parse({
+  return import_types26.DivergenceResultSchema.parse({
     divergences: filtered,
     totalAffected: filtered.length,
     computedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -6744,23 +7475,23 @@ function canonicalJson(value) {
 
 // src/projects.ts
 init_cjs_shims();
-var import_node_path37 = __toESM(require("path"), 1);
+var import_node_path39 = __toESM(require("path"), 1);
 function pathsForProject(project, baseDir) {
   if (project === DEFAULT_PROJECT) {
     return {
-      snapshotPath: import_node_path37.default.join(baseDir, "graph.json"),
-      errorsPath: import_node_path37.default.join(baseDir, "errors.ndjson"),
-      staleEventsPath: import_node_path37.default.join(baseDir, "stale-events.ndjson"),
-      embeddingsCachePath: import_node_path37.default.join(baseDir, "embeddings.json"),
-      policyViolationsPath: import_node_path37.default.join(baseDir, "policy-violations.ndjson")
+      snapshotPath: import_node_path39.default.join(baseDir, "graph.json"),
+      errorsPath: import_node_path39.default.join(baseDir, "errors.ndjson"),
+      staleEventsPath: import_node_path39.default.join(baseDir, "stale-events.ndjson"),
+      embeddingsCachePath: import_node_path39.default.join(baseDir, "embeddings.json"),
+      policyViolationsPath: import_node_path39.default.join(baseDir, "policy-violations.ndjson")
     };
   }
   return {
-    snapshotPath: import_node_path37.default.join(baseDir, `${project}.json`),
-    errorsPath: import_node_path37.default.join(baseDir, `errors.${project}.ndjson`),
-    staleEventsPath: import_node_path37.default.join(baseDir, `stale-events.${project}.ndjson`),
-    embeddingsCachePath: import_node_path37.default.join(baseDir, `embeddings.${project}.json`),
-    policyViolationsPath: import_node_path37.default.join(baseDir, `policy-violations.${project}.ndjson`)
+    snapshotPath: import_node_path39.default.join(baseDir, `${project}.json`),
+    errorsPath: import_node_path39.default.join(baseDir, `errors.${project}.ndjson`),
+    staleEventsPath: import_node_path39.default.join(baseDir, `stale-events.${project}.ndjson`),
+    embeddingsCachePath: import_node_path39.default.join(baseDir, `embeddings.${project}.json`),
+    policyViolationsPath: import_node_path39.default.join(baseDir, `policy-violations.${project}.ndjson`)
   };
 }
 var Projects = class {
@@ -6798,23 +7529,23 @@ var Projects = class {
 init_cjs_shims();
 var import_node_fs23 = require("fs");
 var import_node_os3 = __toESM(require("os"), 1);
-var import_node_path38 = __toESM(require("path"), 1);
-var import_types25 = require("@neat.is/types");
+var import_node_path40 = __toESM(require("path"), 1);
+var import_types27 = require("@neat.is/types");
 var LOCK_TIMEOUT_MS = 5e3;
 var LOCK_RETRY_MS = 50;
 function neatHome() {
   const override = process.env.NEAT_HOME;
-  if (override && override.length > 0) return import_node_path38.default.resolve(override);
-  return import_node_path38.default.join(import_node_os3.default.homedir(), ".neat");
+  if (override && override.length > 0) return import_node_path40.default.resolve(override);
+  return import_node_path40.default.join(import_node_os3.default.homedir(), ".neat");
 }
 function registryPath() {
-  return import_node_path38.default.join(neatHome(), "projects.json");
+  return import_node_path40.default.join(neatHome(), "projects.json");
 }
 function registryLockPath() {
-  return import_node_path38.default.join(neatHome(), "projects.json.lock");
+  return import_node_path40.default.join(neatHome(), "projects.json.lock");
 }
 function daemonPidPath() {
-  return import_node_path38.default.join(neatHome(), "neatd.pid");
+  return import_node_path40.default.join(neatHome(), "neatd.pid");
 }
 function isPidAliveDefault(pid) {
   try {
@@ -6874,7 +7605,7 @@ function lockHolderMessage(holder, lockPath, timeoutMs) {
   }
 }
 async function normalizeProjectPath(input) {
-  const resolved = import_node_path38.default.resolve(input);
+  const resolved = import_node_path40.default.resolve(input);
   try {
     return await import_node_fs23.promises.realpath(resolved);
   } catch {
@@ -6882,7 +7613,7 @@ async function normalizeProjectPath(input) {
   }
 }
 async function writeAtomically(target, contents) {
-  await import_node_fs23.promises.mkdir(import_node_path38.default.dirname(target), { recursive: true });
+  await import_node_fs23.promises.mkdir(import_node_path40.default.dirname(target), { recursive: true });
   const tmp = `${target}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2, 8)}.tmp`;
   const fd = await import_node_fs23.promises.open(tmp, "w");
   try {
@@ -6895,7 +7626,7 @@ async function writeAtomically(target, contents) {
 }
 async function acquireLock(lockPath, timeoutMs = LOCK_TIMEOUT_MS, probe = defaultLockHolderProbe) {
   const deadline = Date.now() + timeoutMs;
-  await import_node_fs23.promises.mkdir(import_node_path38.default.dirname(lockPath), { recursive: true });
+  await import_node_fs23.promises.mkdir(import_node_path40.default.dirname(lockPath), { recursive: true });
   let probedHolder = false;
   while (true) {
     try {
@@ -6948,10 +7679,10 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types25.RegistryFileSchema.parse(parsed);
+  return import_types27.RegistryFileSchema.parse(parsed);
 }
 async function writeRegistry(reg) {
-  const validated = import_types25.RegistryFileSchema.parse(reg);
+  const validated = import_types27.RegistryFileSchema.parse(reg);
   await writeAtomically(registryPath(), JSON.stringify(validated, null, 2) + "\n");
 }
 var ProjectNameCollisionError = class extends Error {
@@ -7292,11 +8023,11 @@ function registerRoutes(scope, ctx) {
       const candidates = req.query.type.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
       const parsed = [];
       for (const c of candidates) {
-        const r = import_types26.DivergenceTypeSchema.safeParse(c);
+        const r = import_types28.DivergenceTypeSchema.safeParse(c);
         if (!r.success) {
           return reply.code(400).send({
             error: `unknown divergence type "${c}"`,
-            allowed: import_types26.DivergenceTypeSchema.options
+            allowed: import_types28.DivergenceTypeSchema.options
           });
         }
         parsed.push(r.data);
@@ -7515,7 +8246,7 @@ function registerRoutes(scope, ctx) {
     const log = new PolicyViolationsLog(proj.paths.policyViolationsPath);
     let violations = await log.readAll();
     if (req.query.severity) {
-      const sev = import_types26.PolicySeveritySchema.safeParse(req.query.severity);
+      const sev = import_types28.PolicySeveritySchema.safeParse(req.query.severity);
       if (!sev.success) {
         return reply.code(400).send({
           error: "invalid severity",
@@ -7554,7 +8285,7 @@ function registerRoutes(scope, ctx) {
   scope.post("/policies/check", async (req, reply) => {
     const proj = resolveProject(registry, req, reply, ctx.bootstrap, ctx.singleProject);
     if (!proj) return;
-    const parsed = import_types26.PoliciesCheckBodySchema.safeParse(req.body ?? {});
+    const parsed = import_types28.PoliciesCheckBodySchema.safeParse(req.body ?? {});
     if (!parsed.success) {
       return reply.code(400).send({
         error: "invalid /policies/check body",
@@ -7817,7 +8548,7 @@ init_otel_grpc();
 // src/daemon.ts
 init_cjs_shims();
 var import_node_fs25 = require("fs");
-var import_node_path42 = __toESM(require("path"), 1);
+var import_node_path44 = __toESM(require("path"), 1);
 var import_node_module = require("module");
 init_otel();
 init_auth();
@@ -7825,7 +8556,7 @@ init_auth();
 // src/unrouted.ts
 init_cjs_shims();
 var import_node_fs24 = require("fs");
-var import_node_path41 = __toESM(require("path"), 1);
+var import_node_path43 = __toESM(require("path"), 1);
 function buildUnroutedSpanRecord(serviceName, traceId, now = /* @__PURE__ */ new Date()) {
   return {
     timestamp: now.toISOString(),
@@ -7835,34 +8566,34 @@ function buildUnroutedSpanRecord(serviceName, traceId, now = /* @__PURE__ */ new
   };
 }
 async function appendUnroutedSpan(neatHome2, record) {
-  const target = import_node_path41.default.join(neatHome2, "errors.ndjson");
+  const target = import_node_path43.default.join(neatHome2, "errors.ndjson");
   await import_node_fs24.promises.mkdir(neatHome2, { recursive: true });
   await import_node_fs24.promises.appendFile(target, JSON.stringify(record) + "\n", "utf8");
 }
 function unroutedErrorsPath(neatHome2) {
-  return import_node_path41.default.join(neatHome2, "errors.ndjson");
+  return import_node_path43.default.join(neatHome2, "errors.ndjson");
 }
 
 // src/daemon.ts
-var import_types27 = require("@neat.is/types");
+var import_types29 = require("@neat.is/types");
 function daemonJsonPath(scanPath) {
-  return import_node_path42.default.join(scanPath, "neat-out", "daemon.json");
+  return import_node_path44.default.join(scanPath, "neat-out", "daemon.json");
 }
 function daemonsDiscoveryDir(home) {
   const base = home && home.length > 0 ? home : neatHomeFromEnv();
-  return import_node_path42.default.join(base, "daemons");
+  return import_node_path44.default.join(base, "daemons");
 }
 function daemonDiscoveryPath(project, home) {
-  return import_node_path42.default.join(daemonsDiscoveryDir(home), `${sanitizeDiscoveryName(project)}.json`);
+  return import_node_path44.default.join(daemonsDiscoveryDir(home), `${sanitizeDiscoveryName(project)}.json`);
 }
 function sanitizeDiscoveryName(project) {
   return project.replace(/[^A-Za-z0-9._-]/g, "_");
 }
 function neatHomeFromEnv() {
   const env = process.env.NEAT_HOME;
-  if (env && env.length > 0) return import_node_path42.default.resolve(env);
+  if (env && env.length > 0) return import_node_path44.default.resolve(env);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path42.default.join(home, ".neat");
+  return import_node_path44.default.join(home, ".neat");
 }
 function resolveNeatVersion() {
   if (process.env.NEAT_LOCAL_VERSION && process.env.NEAT_LOCAL_VERSION.length > 0) {
@@ -7903,17 +8634,21 @@ function teardownSlot(slot) {
     slot.stopPersist();
   } catch {
   }
+  try {
+    slot.stopStaleness();
+  } catch {
+  }
   try {
     slot.detachEvents();
   } catch {
   }
 }
 function neatHomeFor(opts) {
-  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path42.default.resolve(opts.neatHome);
+  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path44.default.resolve(opts.neatHome);
   const env = process.env.NEAT_HOME;
-  if (env && env.length > 0) return import_node_path42.default.resolve(env);
+  if (env && env.length > 0) return import_node_path44.default.resolve(env);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path42.default.join(home, ".neat");
+  return import_node_path44.default.join(home, ".neat");
 }
 function routeSpanToProject(serviceName, projects) {
   if (!serviceName) return DEFAULT_PROJECT;
@@ -7957,11 +8692,11 @@ function spanBelongsToSingleProject(graph, project, serviceName) {
   if (!serviceName) return true;
   if (serviceNameMatchesProject(serviceName, project)) return true;
   return graph.someNode(
-    (_id, attrs) => attrs.type === import_types27.NodeType.ServiceNode && attrs.name === serviceName
+    (_id, attrs) => attrs.type === import_types29.NodeType.ServiceNode && attrs.name === serviceName
   );
 }
 async function bootstrapProject(entry) {
-  const paths = pathsForProject(entry.name, import_node_path42.default.join(entry.path, "neat-out"));
+  const paths = pathsForProject(entry.name, import_node_path44.default.join(entry.path, "neat-out"));
   try {
     const stat = await import_node_fs25.promises.stat(entry.path);
     if (!stat.isDirectory()) {
@@ -7979,6 +8714,8 @@ async function bootstrapProject(entry) {
       paths,
       stopPersist: () => {
       },
+      stopStaleness: () => {
+      },
       detachEvents: () => {
       },
       status: "broken",
@@ -7993,6 +8730,10 @@ async function bootstrapProject(entry) {
   try {
     await extractFromDirectory(graph, entry.path);
     const stopPersist = startPersistLoop(graph, outPath, { exitOnSignal: false });
+    const stopStaleness = startStalenessLoop(graph, {
+      staleEventsPath: paths.staleEventsPath,
+      project: entry.name
+    });
     await touchLastSeen(entry.name).catch(() => {
     });
     return {
@@ -8001,6 +8742,7 @@ async function bootstrapProject(entry) {
       outPath,
       paths,
       stopPersist,
+      stopStaleness,
       detachEvents,
       status: "active"
     };
@@ -8057,7 +8799,7 @@ async function startDaemon(opts = {}) {
   const projectArg = typeof opts.project === "string" && opts.project.length > 0 ? opts.project : process.env.NEAT_PROJECT && process.env.NEAT_PROJECT.length > 0 ? process.env.NEAT_PROJECT : null;
   const projectPathArg = opts.projectPath && opts.projectPath.length > 0 ? opts.projectPath : process.env.NEAT_PROJECT_PATH && process.env.NEAT_PROJECT_PATH.length > 0 ? process.env.NEAT_PROJECT_PATH : null;
   const singleProject = projectArg;
-  const singleProjectPath = singleProject && projectPathArg ? import_node_path42.default.resolve(projectPathArg) : null;
+  const singleProjectPath = singleProject && projectPathArg ? import_node_path44.default.resolve(projectPathArg) : null;
   if (singleProject && !singleProjectPath) {
     throw new Error(
       `neatd: project "${singleProject}" given without a projectPath; pass NEAT_PROJECT_PATH alongside NEAT_PROJECT.`
@@ -8072,7 +8814,7 @@ async function startDaemon(opts = {}) {
       );
     }
   }
-  const pidPath = import_node_path42.default.join(home, "neatd.pid");
+  const pidPath = import_node_path44.default.join(home, "neatd.pid");
   await writeAtomically(pidPath, `${process.pid}
 `);
   const slots = /* @__PURE__ */ new Map();
@@ -8474,8 +9216,8 @@ async function startDaemon(opts = {}) {
   let registryWatcher = null;
   let reloadTimer = null;
   if (!singleProject) try {
-    const regDir = import_node_path42.default.dirname(regPath);
-    const regBase = import_node_path42.default.basename(regPath);
+    const regDir = import_node_path44.default.dirname(regPath);
+    const regBase = import_node_path44.default.basename(regPath);
     registryWatcher = (0, import_node_fs25.watch)(regDir, (_eventType, filename) => {
       if (filename !== null && filename !== regBase) return;
       if (reloadTimer) clearTimeout(reloadTimer);