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

package/dist/server.cjs

@@ -56,9 +56,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;
       }
@@ -69,11 +69,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;
     }
@@ -186,8 +188,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();
@@ -255,13 +257,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);
@@ -334,6 +336,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 ?? []) {
@@ -360,6 +369,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)
@@ -371,10 +384,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 }
@@ -419,7 +432,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();
@@ -572,12 +599,12 @@ async function buildOtelReceiver(opts) {
   };
   return decorated;
 }
-var import_node_path40, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
+var import_node_path42, import_node_url2, import_fastify2, import_protobufjs, ENV_ATTR_CANONICAL, ENV_ATTR_COMPAT, ENV_FALLBACK, exportTraceServiceRequestType, exportTraceServiceResponseType, cachedProtobufResponseBody;
 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);
@@ -593,7 +620,7 @@ var init_otel = __esm({
 
 // src/server.ts
 init_cjs_shims();
-var import_node_path42 = __toESM(require("path"), 1);
+var import_node_path44 = __toESM(require("path"), 1);
 
 // src/graph.ts
 init_cjs_shims();
@@ -617,7 +644,7 @@ function getGraph(project = DEFAULT_PROJECT) {
 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();
@@ -1360,19 +1387,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);
     }
@@ -1380,14 +1407,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];
@@ -1400,7 +1427,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}`
@@ -1411,11 +1438,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()) {
@@ -1424,7 +1451,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}`
@@ -1439,7 +1466,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}`
         };
@@ -1448,10 +1475,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,
@@ -1463,16 +1490,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
       });
     }
@@ -1530,9 +1557,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);
@@ -1549,9 +1576,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;
@@ -1566,26 +1593,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));
@@ -1593,14 +1620,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 } : {}
@@ -1612,7 +1639,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`
@@ -2824,10 +2851,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_types4.graphqlOperationId)(serviceName, operationType, operationName);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: import_types4.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_types4.infraId)(messagingDestinationKind(system), destination);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: import_types4.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();
@@ -2921,6 +2986,21 @@ function ensureDatabaseNode(graph, host, engine) {
   graph.addNode(id, node);
   return id;
 }
+function ensureLocalDatabaseNode(graph, serviceName, name, engine) {
+  const id = (0, import_types4.localDatabaseId)(serviceName, name);
+  if (graph.hasNode(id)) return id;
+  const node = {
+    id,
+    type: import_types4.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)) {
@@ -3147,10 +3227,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_types4.databaseId)(host);
+    if (mintsFromCallerSide) {
+      const host = pickAddress(span);
+      let targetId;
+      if (host) {
+        ensureDatabaseNode(ctx.graph, host, span.dbSystem);
+        targetId = (0, import_types4.databaseId)(host);
+      } else {
+        const localName = span.dbName ?? span.dbSystem;
+        targetId = ensureLocalDatabaseNode(
+          ctx.graph,
+          span.service,
+          localName,
+          span.dbSystem
+        );
+      }
       const result = upsertObservedEdge(
         ctx.graph,
         import_types4.EdgeType.CONNECTS_TO,
@@ -3162,6 +3253,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_types4.EdgeType.CONSUMES_FROM : import_types4.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_types4.EdgeType.CONTAINS,
+      observedSource(),
+      targetId,
+      ts,
+      isError,
+      callSiteEvidence
+    );
+    if (result) affectedNode = targetId;
   } else {
     const host = pickAddress(span);
     let resolvedViaAddress = false;
@@ -3271,29 +3396,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) {
@@ -4055,9 +4180,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_types7.NodeType.ServiceNode) return;
   const set = new Set(node.aliases ?? []);
   for (const c of candidates) {
@@ -4067,7 +4192,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();
@@ -4100,12 +4225,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([
@@ -4218,16 +4343,28 @@ init_cjs_shims();
 var import_node_fs12 = require("fs");
 var import_node_path12 = __toESM(require("path"), 1);
 var import_types8 = 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_path12.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_fs12.promises.readdir(current, { withFileTypes: true }).catch(() => []);
     for (const entry of entries) {
       const full = import_node_path12.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_path12.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)) {
@@ -4235,7 +4372,7 @@ async function walkSourceFiles(dir) {
       }
     }
   }
-  await walk(dir);
+  await walk3(dir);
   return out;
 }
 async function loadSourceFiles(dir) {
@@ -5329,20 +5466,20 @@ var import_node_path23 = __toESM(require("path"), 1);
 var import_types11 = require("@neat.is/types");
 async function walkConfigFiles(dir) {
   const out = [];
-  async function walk(current) {
+  async function walk3(current) {
     const entries = await import_node_fs16.promises.readdir(current, { withFileTypes: true });
     for (const entry of entries) {
       const full = import_node_path23.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) {
@@ -5390,17 +5527,347 @@ async function addConfigNodes(graph, services, scanPath) {
   return { nodesAdded, edgesAdded };
 }
 
+// src/extract/routes.ts
+init_cjs_shims();
+var import_node_path24 = __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_types12 = 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_path24.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_path24.default.extname(file.path))) continue;
+      const relFile = toPosix2(import_node_path24.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_types12.routeId)(service.pkg.name, route.method, route.pathTemplate);
+        if (!graph.hasNode(rid)) {
+          const node = {
+            id: rid,
+            type: import_types12.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_types12.extractedEdgeId)(service.node.id, rid, import_types12.EdgeType.CONTAINS);
+        if (!graph.hasEdge(containsId)) {
+          const edge = {
+            id: containsId,
+            source: service.node.id,
+            target: rid,
+            type: import_types12.EdgeType.CONTAINS,
+            provenance: import_types12.Provenance.EXTRACTED,
+            confidence: (0, import_types12.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_types18 = require("@neat.is/types");
+var import_types20 = require("@neat.is/types");
 
 // src/extract/calls/http.ts
 init_cjs_shims();
-var import_node_path24 = __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_path25 = __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_types12 = require("@neat.is/types");
+var import_types13 = 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) {
@@ -5428,14 +5895,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 = [];
@@ -5449,27 +5916,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_path24.default.basename(service.dir));
-    knownHosts.add(service.pkg.name);
-    hostToNodeId.set(import_node_path24.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) {
@@ -5477,7 +5937,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_path24.default.extname(file.path) === ".py" ? pyParser : jsParser;
+      const parser = import_node_path25.default.extname(file.path) === ".py" ? pyParser : jsParser;
       let sites;
       try {
         sites = callsFromSource(file.content, parser, knownHosts);
@@ -5486,14 +5946,14 @@ async function addHttpCallEdges(graph, services) {
         continue;
       }
       if (sites.length === 0) continue;
-      const relFile = toPosix2(import_node_path24.default.relative(service.dir, file.path));
+      const relFile = toPosix2(import_node_path25.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_types12.confidenceForExtracted)("url-literal-service-target");
+        const confidence = (0, import_types13.confidenceForExtracted)("url-literal-service-target");
         const ev = {
           file: relFile,
           line: site.line,
@@ -5507,25 +5967,25 @@ async function addHttpCallEdges(graph, services) {
         );
         nodesAdded += n;
         edgesAdded += e;
-        if (!(0, import_types12.passesExtractedFloor)(confidence)) {
+        if (!(0, import_types13.passesExtractedFloor)(confidence)) {
           noteExtractedDropped({
             source: fileNodeId,
             target: targetId,
-            type: import_types12.EdgeType.CALLS,
+            type: import_types13.EdgeType.CALLS,
             confidence,
             confidenceKind: "url-literal-service-target",
             evidence: ev
           });
           continue;
         }
-        const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, targetId, import_types12.EdgeType.CALLS);
+        const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, targetId, import_types13.EdgeType.CALLS);
         if (!graph.hasEdge(edgeId)) {
           const edge = {
             id: edgeId,
             source: fileNodeId,
             target: targetId,
-            type: import_types12.EdgeType.CALLS,
-            provenance: import_types12.Provenance.EXTRACTED,
+            type: import_types13.EdgeType.CALLS,
+            provenance: import_types13.Provenance.EXTRACTED,
             confidence,
             evidence: ev
           };
@@ -5538,10 +5998,279 @@ async function addHttpCallEdges(graph, services) {
   return { nodesAdded, edgesAdded };
 }
 
+// src/extract/calls/route-match.ts
+init_cjs_shims();
+var import_node_path26 = __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_types14 = 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_types14.NodeType.RouteNode) return;
+    const route = attrs;
+    const owner = (0, import_types14.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_path26.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_path26.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_types14.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_types14.passesExtractedFloor)(confidence)) {
+          noteExtractedDropped({
+            source: fileNodeId,
+            target: match.routeNodeId,
+            type: import_types14.EdgeType.CALLS,
+            confidence,
+            confidenceKind: "verified-call-site",
+            evidence: ev
+          });
+          continue;
+        }
+        const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, match.routeNodeId, import_types14.EdgeType.CALLS);
+        if (!graph.hasEdge(edgeId)) {
+          const edge = {
+            id: edgeId,
+            source: fileNodeId,
+            target: match.routeNodeId,
+            type: import_types14.EdgeType.CALLS,
+            provenance: import_types14.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_path25 = __toESM(require("path"), 1);
-var import_types13 = require("@neat.is/types");
+var import_node_path27 = __toESM(require("path"), 1);
+var import_types15 = 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) {
@@ -5562,7 +6291,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
     seen.add(key);
     const line = lineOf(file.content, topic);
     out.push({
-      infraId: (0, import_types13.infraId)("kafka-topic", topic),
+      infraId: (0, import_types15.infraId)("kafka-topic", topic),
       name: topic,
       kind: "kafka-topic",
       edgeType,
@@ -5571,7 +6300,7 @@ function kafkaEndpointsFromFile(file, serviceDir) {
       // tier (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)
       }
@@ -5584,8 +6313,8 @@ function kafkaEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/redis.ts
 init_cjs_shims();
-var import_node_path26 = __toESM(require("path"), 1);
-var import_types14 = require("@neat.is/types");
+var import_node_path28 = __toESM(require("path"), 1);
+var import_types16 = require("@neat.is/types");
 var REDIS_URL_RE = /redis(?:s)?:\/\/(?:[^@'"`\s]+@)?([^:/'"`\s]+)(?::(\d+))?/g;
 function redisEndpointsFromFile(file, serviceDir) {
   const out = [];
@@ -5598,7 +6327,7 @@ function redisEndpointsFromFile(file, serviceDir) {
     seen.add(host);
     const line = lineOf(file.content, host);
     out.push({
-      infraId: (0, import_types14.infraId)("redis", host),
+      infraId: (0, import_types16.infraId)("redis", host),
       name: host,
       kind: "redis",
       edgeType: "CALLS",
@@ -5607,7 +6336,7 @@ function redisEndpointsFromFile(file, serviceDir) {
       // support tier (ADR-066).
       confidenceKind: "url-with-structural-support",
       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)
       }
@@ -5618,8 +6347,8 @@ function redisEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/aws.ts
 init_cjs_shims();
-var import_node_path27 = __toESM(require("path"), 1);
-var import_types15 = require("@neat.is/types");
+var import_node_path29 = __toESM(require("path"), 1);
+var import_types17 = require("@neat.is/types");
 var S3_BUCKET_RE = /Bucket\s*:\s*['"`]([^'"`]+)['"`]/g;
 var DYNAMO_TABLE_RE = /TableName\s*:\s*['"`]([^'"`]+)['"`]/g;
 function hasMarker(text, markers) {
@@ -5643,7 +6372,7 @@ function awsEndpointsFromFile(file, serviceDir) {
     seen.add(key);
     const line = lineOf(file.content, name);
     out.push({
-      infraId: (0, import_types15.infraId)(kind, name),
+      infraId: (0, import_types17.infraId)(kind, name),
       name,
       kind,
       edgeType: "CALLS",
@@ -5652,7 +6381,7 @@ function awsEndpointsFromFile(file, serviceDir) {
       // (ADR-066).
       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)
       }
@@ -5677,8 +6406,8 @@ function awsEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/grpc.ts
 init_cjs_shims();
-var import_node_path28 = __toESM(require("path"), 1);
-var import_types16 = require("@neat.is/types");
+var import_node_path30 = __toESM(require("path"), 1);
+var import_types18 = 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['"`]/;
@@ -5727,7 +6456,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
     const { kind } = classified;
     const line = lineOf(file.content, m[0]);
     out.push({
-      infraId: (0, import_types16.infraId)(kind, name),
+      infraId: (0, import_types18.infraId)(kind, name),
       name,
       kind,
       edgeType: "CALLS",
@@ -5736,7 +6465,7 @@ function grpcEndpointsFromFile(file, serviceDir) {
       // tier (ADR-066).
       confidenceKind: "verified-call-site",
       evidence: {
-        file: import_node_path28.default.relative(serviceDir, file.path),
+        file: import_node_path30.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5747,8 +6476,8 @@ function grpcEndpointsFromFile(file, serviceDir) {
 
 // src/extract/calls/supabase.ts
 init_cjs_shims();
-var import_node_path29 = __toESM(require("path"), 1);
-var import_types17 = require("@neat.is/types");
+var import_node_path31 = __toESM(require("path"), 1);
+var import_types19 = 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;
@@ -5786,7 +6515,7 @@ function supabaseEndpointsFromFile(file, serviceDir) {
     seen.add(name);
     const line = lineOf(file.content, m[0]);
     out.push({
-      infraId: (0, import_types17.infraId)("supabase", name),
+      infraId: (0, import_types19.infraId)("supabase", name),
       name,
       kind: "supabase",
       edgeType: "CALLS",
@@ -5796,7 +6525,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_path29.default.relative(serviceDir, file.path),
+        file: import_node_path31.default.relative(serviceDir, file.path),
         line,
         snippet: snippet(file.content, line)
       }
@@ -5809,11 +6538,11 @@ function supabaseEndpointsFromFile(file, serviceDir) {
 function edgeTypeFromEndpoint(ep) {
   switch (ep.edgeType) {
     case "PUBLISHES_TO":
-      return import_types18.EdgeType.PUBLISHES_TO;
+      return import_types20.EdgeType.PUBLISHES_TO;
     case "CONSUMES_FROM":
-      return import_types18.EdgeType.CONSUMES_FROM;
+      return import_types20.EdgeType.CONSUMES_FROM;
     default:
-      return import_types18.EdgeType.CALLS;
+      return import_types20.EdgeType.CALLS;
   }
 }
 function isAwsKind(kind) {
@@ -5841,7 +6570,7 @@ async function addExternalEndpointEdges(graph, services) {
       if (!graph.hasNode(ep.infraId)) {
         const node = {
           id: ep.infraId,
-          type: import_types18.NodeType.InfraNode,
+          type: import_types20.NodeType.InfraNode,
           name: ep.name,
           // #238 — `aws-*` covers AWS-SDK client kinds (aws-s3, aws-dynamodb,
           // aws-cognito-identity-provider, …); `s3-` / `dynamodb-` cover the
@@ -5853,7 +6582,7 @@ async function addExternalEndpointEdges(graph, services) {
         nodesAdded++;
       }
       const edgeType = edgeTypeFromEndpoint(ep);
-      const confidence = (0, import_types18.confidenceForExtracted)(ep.confidenceKind);
+      const confidence = (0, import_types20.confidenceForExtracted)(ep.confidenceKind);
       const relFile = toPosix2(ep.evidence.file);
       const { fileNodeId, nodesAdded: n, edgesAdded: e } = ensureFileNode(
         graph,
@@ -5863,7 +6592,7 @@ async function addExternalEndpointEdges(graph, services) {
       );
       nodesAdded += n;
       edgesAdded += e;
-      if (!(0, import_types18.passesExtractedFloor)(confidence)) {
+      if (!(0, import_types20.passesExtractedFloor)(confidence)) {
         noteExtractedDropped({
           source: fileNodeId,
           target: ep.infraId,
@@ -5883,7 +6612,7 @@ async function addExternalEndpointEdges(graph, services) {
           source: fileNodeId,
           target: ep.infraId,
           type: edgeType,
-          provenance: import_types18.Provenance.EXTRACTED,
+          provenance: import_types20.Provenance.EXTRACTED,
           confidence,
           evidence: ep.evidence
         };
@@ -5897,9 +6626,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
   };
 }
 
@@ -5908,16 +6638,16 @@ init_cjs_shims();
 
 // src/extract/infra/docker-compose.ts
 init_cjs_shims();
-var import_node_path30 = __toESM(require("path"), 1);
-var import_types20 = require("@neat.is/types");
+var import_node_path32 = __toESM(require("path"), 1);
+var import_types22 = require("@neat.is/types");
 
 // src/extract/infra/shared.ts
 init_cjs_shims();
-var import_types19 = require("@neat.is/types");
+var import_types21 = require("@neat.is/types");
 function makeInfraNode(kind, name, provider = "self", extras) {
   return {
-    id: (0, import_types19.infraId)(kind, name),
-    type: import_types19.NodeType.InfraNode,
+    id: (0, import_types21.infraId)(kind, name),
+    type: import_types21.NodeType.InfraNode,
     name,
     provider,
     kind,
@@ -5946,7 +6676,7 @@ function dependsOnList(value) {
 }
 function serviceNameToServiceNode(name, services) {
   for (const s of services) {
-    if (s.node.name === name || import_node_path30.default.basename(s.dir) === name) return s.node.id;
+    if (s.node.name === name || import_node_path32.default.basename(s.dir) === name) return s.node.id;
   }
   return null;
 }
@@ -5955,7 +6685,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_path30.default.join(scanPath, name);
+    const abs = import_node_path32.default.join(scanPath, name);
     if (await exists2(abs)) {
       composePath = abs;
       break;
@@ -5968,13 +6698,13 @@ async function addComposeInfra(graph, scanPath, services) {
   } catch (err) {
     recordExtractionError(
       "infra docker-compose",
-      import_node_path30.default.relative(scanPath, composePath),
+      import_node_path32.default.relative(scanPath, composePath),
       err
     );
     return { nodesAdded, edgesAdded };
   }
   if (!compose?.services) return { nodesAdded, edgesAdded };
-  const evidenceFile = import_node_path30.default.relative(scanPath, composePath).split(import_node_path30.default.sep).join("/");
+  const evidenceFile = import_node_path32.default.relative(scanPath, composePath).split(import_node_path32.default.sep).join("/");
   const composeNameToNodeId = /* @__PURE__ */ new Map();
   for (const [composeName, svc] of Object.entries(compose.services)) {
     const matchedServiceId = serviceNameToServiceNode(composeName, services);
@@ -5996,15 +6726,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_types5.extractedEdgeId)(sourceId, targetId, import_types20.EdgeType.DEPENDS_ON);
+      const edgeId = (0, import_types5.extractedEdgeId)(sourceId, targetId, import_types22.EdgeType.DEPENDS_ON);
       if (graph.hasEdge(edgeId)) continue;
       const edge = {
         id: edgeId,
         source: sourceId,
         target: targetId,
-        type: import_types20.EdgeType.DEPENDS_ON,
-        provenance: import_types20.Provenance.EXTRACTED,
-        confidence: (0, import_types20.confidenceForExtracted)("structural"),
+        type: import_types22.EdgeType.DEPENDS_ON,
+        provenance: import_types22.Provenance.EXTRACTED,
+        confidence: (0, import_types22.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile }
       };
       graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -6016,9 +6746,9 @@ async function addComposeInfra(graph, scanPath, services) {
 
 // src/extract/infra/dockerfile.ts
 init_cjs_shims();
-var import_node_path31 = __toESM(require("path"), 1);
+var import_node_path33 = __toESM(require("path"), 1);
 var import_node_fs17 = require("fs");
-var import_types21 = require("@neat.is/types");
+var import_types23 = require("@neat.is/types");
 function readDockerfile(content) {
   let image = null;
   const ports = [];
@@ -6047,7 +6777,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
   let nodesAdded = 0;
   let edgesAdded = 0;
   for (const service of services) {
-    const dockerfilePath = import_node_path31.default.join(service.dir, "Dockerfile");
+    const dockerfilePath = import_node_path33.default.join(service.dir, "Dockerfile");
     if (!await exists2(dockerfilePath)) continue;
     let content;
     try {
@@ -6055,7 +6785,7 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     } catch (err) {
       recordExtractionError(
         "infra dockerfile",
-        import_node_path31.default.relative(scanPath, dockerfilePath),
+        import_node_path33.default.relative(scanPath, dockerfilePath),
         err
       );
       continue;
@@ -6067,8 +6797,8 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
       graph.addNode(node.id, node);
       nodesAdded++;
     }
-    const relDockerfile = toPosix2(import_node_path31.default.relative(service.dir, dockerfilePath));
-    const evidenceFile = toPosix2(import_node_path31.default.relative(scanPath, dockerfilePath));
+    const relDockerfile = toPosix2(import_node_path33.default.relative(service.dir, dockerfilePath));
+    const evidenceFile = toPosix2(import_node_path33.default.relative(scanPath, dockerfilePath));
     const { fileNodeId, nodesAdded: fn, edgesAdded: fe } = ensureFileNode(
       graph,
       service.pkg.name,
@@ -6077,15 +6807,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
     );
     nodesAdded += fn;
     edgesAdded += fe;
-    const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, node.id, import_types21.EdgeType.RUNS_ON);
+    const edgeId = (0, import_types5.extractedEdgeId)(fileNodeId, node.id, import_types23.EdgeType.RUNS_ON);
     if (!graph.hasEdge(edgeId)) {
       const edge = {
         id: edgeId,
         source: fileNodeId,
         target: node.id,
-        type: import_types21.EdgeType.RUNS_ON,
-        provenance: import_types21.Provenance.EXTRACTED,
-        confidence: (0, import_types21.confidenceForExtracted)("structural"),
+        type: import_types23.EdgeType.RUNS_ON,
+        provenance: import_types23.Provenance.EXTRACTED,
+        confidence: (0, import_types23.confidenceForExtracted)("structural"),
         evidence: {
           file: evidenceFile,
           ...facts.entrypoint ? { snippet: facts.entrypoint.slice(0, 120) } : {}
@@ -6100,15 +6830,15 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
         graph.addNode(portNode.id, portNode);
         nodesAdded++;
       }
-      const portEdgeId = (0, import_types5.extractedEdgeId)(fileNodeId, portNode.id, import_types21.EdgeType.CONNECTS_TO);
+      const portEdgeId = (0, import_types5.extractedEdgeId)(fileNodeId, portNode.id, import_types23.EdgeType.CONNECTS_TO);
       if (graph.hasEdge(portEdgeId)) continue;
       const portEdge = {
         id: portEdgeId,
         source: fileNodeId,
         target: portNode.id,
-        type: import_types21.EdgeType.CONNECTS_TO,
-        provenance: import_types21.Provenance.EXTRACTED,
-        confidence: (0, import_types21.confidenceForExtracted)("structural"),
+        type: import_types23.EdgeType.CONNECTS_TO,
+        provenance: import_types23.Provenance.EXTRACTED,
+        confidence: (0, import_types23.confidenceForExtracted)("structural"),
         evidence: { file: evidenceFile, snippet: `EXPOSE ${port}` }
       };
       graph.addEdgeWithKey(portEdgeId, portEdge.source, portEdge.target, portEdge);
@@ -6121,8 +6851,8 @@ async function addDockerfileRuntimes(graph, services, scanPath) {
 // src/extract/infra/terraform.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");
 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) {
@@ -6132,11 +6862,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_path32.default.join(start, entry.name);
+      const child = import_node_path34.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_path32.default.join(start, entry.name));
+      out.push(import_node_path34.default.join(start, entry.name));
     }
   }
   return out;
@@ -6168,7 +6898,7 @@ async function addTerraformResources(graph, scanPath) {
   const files = await walkTfFiles(scanPath);
   for (const file of files) {
     const content = await import_node_fs18.promises.readFile(file, "utf8");
-    const evidenceFile = toPosix2(import_node_path32.default.relative(scanPath, file));
+    const evidenceFile = toPosix2(import_node_path34.default.relative(scanPath, file));
     const resources = [];
     const byKey = /* @__PURE__ */ new Map();
     RESOURCE_RE.lastIndex = 0;
@@ -6203,16 +6933,16 @@ async function addTerraformResources(graph, scanPath) {
         if (!target) continue;
         if (seen.has(target.nodeId)) continue;
         seen.add(target.nodeId);
-        const edgeId = (0, import_types5.extractedEdgeId)(resource.nodeId, target.nodeId, import_types22.EdgeType.DEPENDS_ON);
+        const edgeId = (0, import_types5.extractedEdgeId)(resource.nodeId, target.nodeId, import_types24.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_types22.EdgeType.DEPENDS_ON,
-          provenance: import_types22.Provenance.EXTRACTED,
-          confidence: (0, import_types22.confidenceForExtracted)("structural"),
+          type: import_types24.EdgeType.DEPENDS_ON,
+          provenance: import_types24.Provenance.EXTRACTED,
+          confidence: (0, import_types24.confidenceForExtracted)("structural"),
           evidence: { file: evidenceFile, line, snippet: key }
         };
         graph.addEdgeWithKey(edgeId, edge.source, edge.target, edge);
@@ -6226,7 +6956,7 @@ async function addTerraformResources(graph, scanPath) {
 // src/extract/infra/k8s.ts
 init_cjs_shims();
 var import_node_fs19 = require("fs");
-var import_node_path33 = __toESM(require("path"), 1);
+var import_node_path35 = __toESM(require("path"), 1);
 var import_yaml3 = require("yaml");
 var K8S_KIND_TO_INFRA_KIND = {
   Service: "k8s-service",
@@ -6244,11 +6974,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_path33.default.join(start, entry.name);
+      const child = import_node_path35.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_path33.default.extname(entry.name))) {
-      out.push(import_node_path33.default.join(start, entry.name));
+    } else if (entry.isFile() && CONFIG_FILE_EXTENSIONS.has(import_node_path35.default.extname(entry.name))) {
+      out.push(import_node_path35.default.join(start, entry.name));
     }
   }
   return out;
@@ -6292,17 +7022,17 @@ async function addInfra(graph, scanPath, services) {
 }
 
 // src/extract/index.ts
-var import_node_path35 = __toESM(require("path"), 1);
+var import_node_path37 = __toESM(require("path"), 1);
 
 // src/extract/retire.ts
 init_cjs_shims();
 var import_node_fs20 = 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");
 function dropOrphanedFileNodes(graph) {
   const orphans = [];
   graph.forEachNode((id, attrs) => {
-    if (attrs.type !== import_types23.NodeType.FileNode) return;
+    if (attrs.type !== import_types25.NodeType.FileNode) return;
     if (graph.inboundEdges(id).length === 0 && graph.outboundEdges(id).length === 0) {
       orphans.push(id);
     }
@@ -6315,14 +7045,14 @@ function retireExtractedEdgesByMissingFile(graph, scanPath, serviceDirs = []) {
   const bases = [scanPath, ...serviceDirs];
   graph.forEachEdge((id, attrs) => {
     const edge = attrs;
-    if (edge.provenance !== import_types23.Provenance.EXTRACTED) return;
+    if (edge.provenance !== import_types25.Provenance.EXTRACTED) return;
     const evidenceFile = edge.evidence?.file;
     if (!evidenceFile) return;
-    if (import_node_path34.default.isAbsolute(evidenceFile)) {
+    if (import_node_path36.default.isAbsolute(evidenceFile)) {
       if (!(0, import_node_fs20.existsSync)(evidenceFile)) toDrop.push(id);
       return;
     }
-    const found = bases.some((base) => (0, import_node_fs20.existsSync)(import_node_path34.default.join(base, evidenceFile)));
+    const found = bases.some((base) => (0, import_node_fs20.existsSync)(import_node_path36.default.join(base, evidenceFile)));
     if (!found) toDrop.push(id);
   });
   for (const id of toDrop) graph.dropEdge(id);
@@ -6341,6 +7071,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(
@@ -6362,7 +7093,7 @@ async function extractFromDirectory(graph, scanPath, opts = {}) {
   }
   const droppedEntries = drainDroppedExtracted();
   if (isRejectedLogEnabled() && opts.errorsPath && droppedEntries.length > 0) {
-    const rejectedPath = import_node_path35.default.join(import_node_path35.default.dirname(opts.errorsPath), "rejected.ndjson");
+    const rejectedPath = import_node_path37.default.join(import_node_path37.default.dirname(opts.errorsPath), "rejected.ndjson");
     try {
       await writeRejectedExtracted(droppedEntries, rejectedPath);
     } catch (err) {
@@ -6372,8 +7103,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,
@@ -6474,8 +7205,8 @@ function canonicalJson(value) {
 // src/persist.ts
 init_cjs_shims();
 var import_node_fs22 = require("fs");
-var import_node_path36 = __toESM(require("path"), 1);
-var import_types24 = require("@neat.is/types");
+var import_node_path38 = __toESM(require("path"), 1);
+var import_types26 = require("@neat.is/types");
 var SCHEMA_VERSION = 4;
 function migrateV1ToV2(payload) {
   const nodes = payload.graph.nodes;
@@ -6497,12 +7228,12 @@ function migrateV2ToV3(payload) {
     for (const edge of edges) {
       const attrs = edge.attributes;
       if (!attrs || attrs.provenance !== "FRONTIER") continue;
-      attrs.provenance = import_types24.Provenance.OBSERVED;
+      attrs.provenance = import_types26.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_types24.observedEdgeId)(source, target, type);
+        const newId = (0, import_types26.observedEdgeId)(source, target, type);
         attrs.id = newId;
         if (edge.key) edge.key = newId;
       }
@@ -6511,7 +7242,7 @@ function migrateV2ToV3(payload) {
   return { ...payload, schemaVersion: 3 };
 }
 async function ensureDir(filePath) {
-  await import_node_fs22.promises.mkdir(import_node_path36.default.dirname(filePath), { recursive: true });
+  await import_node_fs22.promises.mkdir(import_node_path38.default.dirname(filePath), { recursive: true });
 }
 async function saveGraphToDisk(graph, outPath) {
   await ensureDir(outPath);
@@ -6592,23 +7323,23 @@ function startPersistLoop(graph, outPath, opts = {}) {
 
 // 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 {
@@ -6650,15 +7381,15 @@ function parseExtraProjects(raw) {
 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");
 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");
 }
 async function readRegistry() {
   const file = registryPath();
@@ -6672,7 +7403,7 @@ async function readRegistry() {
     throw err;
   }
   const parsed = JSON.parse(raw);
-  return import_types25.RegistryFileSchema.parse(parsed);
+  return import_types27.RegistryFileSchema.parse(parsed);
 }
 async function getProject(name) {
   const reg = await readRegistry();
@@ -6893,11 +7624,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);
@@ -7116,7 +7847,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",
@@ -7155,7 +7886,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",
@@ -7418,7 +8149,7 @@ init_otel_grpc();
 // src/search.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);
 var import_node_crypto3 = require("crypto");
 var DEFAULT_LIMIT = 10;
 var NOMIC_DIM = 768;
@@ -7453,6 +8184,18 @@ function embedText(node) {
       if (filePath) parts.push(`path=${filePath}`);
       break;
     }
+    case "RouteNode": {
+      const method = node.method;
+      const tmpl = node.pathTemplate;
+      if (method) parts.push(`method=${method}`);
+      if (tmpl) parts.push(`path=${tmpl}`);
+      break;
+    }
+    case "GraphQLOperationNode": {
+      const opType = node.operationType;
+      if (opType) parts.push(`operationType=${opType}`);
+      break;
+    }
     default:
       break;
   }
@@ -7557,7 +8300,7 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, cache) {
-  await import_node_fs24.promises.mkdir(import_node_path41.default.dirname(cachePath), { recursive: true });
+  await import_node_fs24.promises.mkdir(import_node_path43.default.dirname(cachePath), { recursive: true });
   await import_node_fs24.promises.writeFile(cachePath, JSON.stringify(cache));
 }
 var VectorIndex = class {
@@ -7738,14 +8481,14 @@ async function bootProject(registry, name, scanPath, baseDir) {
 async function main() {
   const baseDirEnv = process.env.NEAT_OUT_DIR;
   const legacyOutPath = process.env.NEAT_OUT_PATH;
-  const baseDir = baseDirEnv ? import_node_path42.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path42.default.resolve(import_node_path42.default.dirname(legacyOutPath)) : import_node_path42.default.resolve("./neat-out");
-  const defaultScanPath = import_node_path42.default.resolve(process.env.NEAT_SCAN_PATH ?? "./demo");
+  const baseDir = baseDirEnv ? import_node_path44.default.resolve(baseDirEnv) : legacyOutPath ? import_node_path44.default.resolve(import_node_path44.default.dirname(legacyOutPath)) : import_node_path44.default.resolve("./neat-out");
+  const defaultScanPath = import_node_path44.default.resolve(process.env.NEAT_SCAN_PATH ?? "./demo");
   const registry = new Projects();
   await bootProject(registry, DEFAULT_PROJECT, defaultScanPath, baseDir);
   for (const name of parseExtraProjects(process.env.NEAT_PROJECTS)) {
     const envKey = `NEAT_PROJECT_SCAN_PATH_${name.toUpperCase().replace(/[^A-Z0-9]/g, "_")}`;
     const projectScan = process.env[envKey];
-    await bootProject(registry, name, projectScan ? import_node_path42.default.resolve(projectScan) : void 0, baseDir);
+    await bootProject(registry, name, projectScan ? import_node_path44.default.resolve(projectScan) : void 0, baseDir);
   }
   const host = process.env.HOST ?? "0.0.0.0";
   const port = Number(process.env.PORT ?? 8080);