@neat.is/core 0.4.27 → 0.4.28-dev.20260708

package/dist/index.cjs

@@ -54,15 +54,16 @@ function mountBearerAuth(app, opts) {
   if (!opts.token || opts.token.length === 0) return;
   if (opts.trustProxy) return;
   const expected = Buffer.from(opts.token, "utf8");
-  const suffixes = [...DEFAULT_UNAUTH_SUFFIXES, ...opts.extraUnauthenticatedSuffixes ?? []];
+  const exactUnauthPaths = /* @__PURE__ */ new Set([
+    ...DEFAULT_UNAUTH_PATHS,
+    ...opts.extraUnauthenticatedSuffixes ?? []
+  ]);
   const publicRead = opts.publicRead === true;
   app.addHook("preHandler", (req, reply, done) => {
-    const path46 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
-    for (const suffix of suffixes) {
-      if (path46 === suffix || path46.endsWith(suffix)) {
-        done();
-        return;
-      }
+    const path47 = (req.url.split("?")[0] ?? "").replace(/\/+$/, "");
+    if (exactUnauthPaths.has(path47) || PROJECT_SCOPED_UNAUTH_PATTERN.test(path47)) {
+      done();
+      return;
     }
     if (publicRead && PUBLIC_READ_METHODS.has(req.method)) {
       done();
@@ -97,7 +98,7 @@ function readAuthEnv(env = process.env) {
     publicRead: parseBoolEnv(env.NEAT_PUBLIC_READ)
   };
 }
-var import_node_crypto, LOOPBACK_HOSTS, BindAuthorityError, PUBLIC_READ_METHODS, DEFAULT_UNAUTH_SUFFIXES;
+var import_node_crypto, LOOPBACK_HOSTS, BindAuthorityError, PUBLIC_READ_METHODS, DEFAULT_UNAUTH_PATHS, PROJECT_SCOPED_UNAUTH_PATTERN;
 var init_auth = __esm({
   "src/auth.ts"() {
     "use strict";
@@ -118,12 +119,15 @@ var init_auth = __esm({
       }
     };
     PUBLIC_READ_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD", "OPTIONS"]);
-    DEFAULT_UNAUTH_SUFFIXES = [
+    DEFAULT_UNAUTH_PATHS = [
       "/health",
       "/healthz",
       "/readyz",
       "/api/config"
     ];
+    PROJECT_SCOPED_UNAUTH_PATTERN = new RegExp(
+      `^/projects/[^/]+/(?:${DEFAULT_UNAUTH_PATHS.map((p) => p.slice(1)).join("|")})$`
+    );
   }
 });
 
@@ -357,8 +361,8 @@ function websocketChannelPathOf(attrs) {
     const v = attrs[key];
     if (typeof v === "string" && v.length > 0) {
       const q = v.indexOf("?");
-      const path46 = q === -1 ? v : v.slice(0, q);
-      if (path46.length > 0) return path46;
+      const path47 = q === -1 ? v : v.slice(0, q);
+      if (path47.length > 0) return path47;
     }
   }
   return void 0;
@@ -1246,19 +1250,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, path46, edges) {
-    if (path46.length > best.path.length) {
-      best = { path: [...path46], edges: [...edges] };
+  function step(node, path47, edges) {
+    if (path47.length > best.path.length) {
+      best = { path: [...path47], edges: [...edges] };
     }
-    if (path46.length - 1 >= maxDepth) return;
+    if (path47.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);
-      path46.push(srcId);
+      path47.push(srcId);
       edges.push(edge);
-      step(srcId, path46, edges);
-      path46.pop();
+      step(srcId, path47, edges);
+      path47.pop();
       edges.pop();
       visited.delete(srcId);
     }
@@ -1273,7 +1277,7 @@ function databaseRootCauseShape(graph, origin, walk3) {
   for (const id of walk3.path) {
     const owner = resolveOwningService(graph, id);
     if (!owner) continue;
-    const { id: serviceId4, svc } = owner;
+    const { id: serviceId5, svc } = owner;
     const deps = svc.dependencies ?? {};
     for (const pair of candidatePairs) {
       const declared = deps[pair.driver];
@@ -1286,7 +1290,7 @@ function databaseRootCauseShape(graph, origin, walk3) {
       );
       if (!result.compatible) {
         return {
-          rootCauseNode: serviceId4,
+          rootCauseNode: serviceId5,
           rootCauseReason: result.reason ?? "incompatible driver",
           ...result.minDriverVersion ? {
             fixRecommendation: `Upgrade ${svc.name} ${pair.driver} driver to >= ${result.minDriverVersion}`
@@ -1301,7 +1305,7 @@ function serviceRootCauseShape(graph, _origin, walk3) {
   for (const id of walk3.path) {
     const owner = resolveOwningService(graph, id);
     if (!owner) continue;
-    const { id: serviceId4, svc } = owner;
+    const { id: serviceId5, svc } = owner;
     const deps = svc.dependencies ?? {};
     const serviceNodeEngine = svc.nodeEngine;
     for (const constraint of nodeEngineConstraints()) {
@@ -1310,7 +1314,7 @@ function serviceRootCauseShape(graph, _origin, walk3) {
       const result = checkNodeEngineConstraint(constraint, declared, serviceNodeEngine);
       if (!result.compatible && result.reason) {
         return {
-          rootCauseNode: serviceId4,
+          rootCauseNode: serviceId5,
           rootCauseReason: result.reason,
           ...result.requiredNodeVersion ? {
             fixRecommendation: `Bump ${svc.name}'s engines.node to >= ${result.requiredNodeVersion}`
@@ -1325,7 +1329,7 @@ function serviceRootCauseShape(graph, _origin, walk3) {
       const result = checkPackageConflict(conflict, declared, requiredDeclared);
       if (!result.compatible && result.reason) {
         return {
-          rootCauseNode: serviceId4,
+          rootCauseNode: serviceId5,
           rootCauseReason: result.reason,
           fixRecommendation: `Upgrade ${svc.name}'s ${conflict.requires.name} to >= ${conflict.requires.minVersion}`
         };
@@ -1416,9 +1420,9 @@ function rootCauseFromIncidents(nodeId, incidents, errorEvent) {
 function isFailingCallEdge(e) {
   return e.type === import_types.EdgeType.CALLS && (e.signal?.errorCount ?? 0) > 0;
 }
-function callSourcesForService(graph, serviceId4) {
-  const ids = [serviceId4];
-  for (const edgeId of graph.outboundEdges(serviceId4)) {
+function callSourcesForService(graph, serviceId5) {
+  const ids = [serviceId5];
+  for (const edgeId of graph.outboundEdges(serviceId5)) {
     const e = graph.getEdgeAttributes(edgeId);
     if (e.type !== import_types.EdgeType.CONTAINS) continue;
     const tgt = graph.getNodeAttributes(e.target);
@@ -1435,9 +1439,9 @@ function failingCallDominates(e, id, curEdge, curId) {
   }
   return id < curId;
 }
-function dominantFailingCall(graph, serviceId4, visited) {
+function dominantFailingCall(graph, serviceId5, visited) {
   let best = null;
-  for (const src of callSourcesForService(graph, serviceId4)) {
+  for (const src of callSourcesForService(graph, serviceId5)) {
     for (const edgeId of graph.outboundEdges(src)) {
       const e = graph.getEdgeAttributes(edgeId);
       if (!isFailingCallEdge(e)) continue;
@@ -1452,26 +1456,26 @@ function dominantFailingCall(graph, serviceId4, visited) {
   return best;
 }
 function followFailingCallChain(graph, originServiceId, maxDepth) {
-  const path46 = [originServiceId];
+  const path47 = [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;
-    path46.push(hop.nextService);
+    path47.push(hop.nextService);
     edges.push(hop.edge);
     visited.add(hop.nextService);
     current = hop.nextService;
   }
   if (edges.length === 0) return null;
-  return { path: path46, edges, culprit: current };
+  return { path: path47, 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 path46 = [...chain.path];
+  const path47 = [...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));
@@ -1479,14 +1483,14 @@ function crossServiceRootCause(graph, originId, incidents, errorEvent) {
   if (loc) {
     let rootCauseNode = culprit;
     if (loc.fileNode) {
-      path46.push(loc.fileNode);
+      path47.push(loc.fileNode);
       edgeProvenances.push(import_types.Provenance.OBSERVED);
       rootCauseNode = loc.fileNode;
     }
     return import_types.RootCauseResultSchema.parse({
       rootCauseNode,
       rootCauseReason: loc.rootCauseReason,
-      traversalPath: path46,
+      traversalPath: path47,
       edgeProvenances,
       confidence,
       ...loc.fixRecommendation ? { fixRecommendation: loc.fixRecommendation } : {}
@@ -1498,7 +1502,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: path46,
+    traversalPath: path47,
     edgeProvenances,
     confidence,
     fixRecommendation: `Inspect ${culpritName}'s failing handler`
@@ -3054,29 +3058,29 @@ function promoteFrontierNodes(graph, opts = {}) {
     toPromote.push({ frontierId: id, serviceId: target });
   });
   let promoted = 0;
-  for (const { frontierId: frontierId2, serviceId: serviceId4 } of toPromote) {
+  for (const { frontierId: frontierId2, serviceId: serviceId5 } 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, serviceId4);
+    rewireFrontierEdges(graph, frontierId2, serviceId5);
     graph.dropNode(frontierId2);
     promoted++;
   }
   return promoted;
 }
-function rewireFrontierEdges(graph, frontierId2, serviceId4) {
+function rewireFrontierEdges(graph, frontierId2, serviceId5) {
   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, serviceId4, edgeId);
+    rebuildEdge(graph, edge, edge.source, serviceId5, edgeId);
   }
   for (const edgeId of outbound) {
     const edge = graph.getEdgeAttributes(edgeId);
-    rebuildEdge(graph, edge, serviceId4, edge.target, edgeId);
+    rebuildEdge(graph, edge, serviceId5, edge.target, edgeId);
   }
 }
 function rebuildEdge(graph, edge, newSource, newTarget, oldEdgeId) {
@@ -3227,24 +3231,58 @@ function dedupeIncidents(events) {
     return !hasRealFailure.has(groupKey(ev));
   });
 }
+var SnapshotValidationError = class extends Error {
+  constructor(issues) {
+    super(`snapshot failed validation (${issues.length} invalid ${issues.length === 1 ? "entry" : "entries"})`);
+    this.issues = issues;
+    this.name = "SnapshotValidationError";
+  }
+  issues;
+};
+function describeZodIssues(error) {
+  return error.issues.map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
+}
 function mergeSnapshot(graph, snapshot) {
   const exported = snapshot.graph;
+  const incomingNodes = Array.isArray(exported.nodes) ? exported.nodes : [];
+  const incomingEdges = Array.isArray(exported.edges) ? exported.edges : [];
+  const issues = [];
+  const validNodes = [];
+  const validEdges = [];
+  for (const node of incomingNodes) {
+    if (node.attributes === void 0) continue;
+    const parsed = import_types3.GraphNodeSchema.safeParse(node.attributes);
+    if (!parsed.success) {
+      issues.push(`node "${node.key}": ${describeZodIssues(parsed.error)}`);
+      continue;
+    }
+    validNodes.push({ key: node.key, attributes: parsed.data });
+  }
+  for (const edge of incomingEdges) {
+    if (edge.attributes === void 0) continue;
+    const parsed = import_types3.GraphEdgeSchema.safeParse(edge.attributes);
+    if (!parsed.success) {
+      const label = edge.key ?? `${edge.source}->${edge.target}`;
+      issues.push(`edge "${label}": ${describeZodIssues(parsed.error)}`);
+      continue;
+    }
+    const id = edge.key ?? parsed.data.id;
+    validEdges.push({ key: id, source: edge.source, target: edge.target, attributes: parsed.data });
+  }
+  if (issues.length > 0) {
+    throw new SnapshotValidationError(issues);
+  }
   let nodesAdded = 0;
   let edgesAdded = 0;
-  for (const node of exported.nodes ?? []) {
+  for (const node of validNodes) {
     if (graph.hasNode(node.key)) continue;
-    if (!node.attributes) continue;
     graph.addNode(node.key, node.attributes);
     nodesAdded++;
   }
-  for (const edge of exported.edges ?? []) {
-    const attrs = edge.attributes;
-    if (!attrs) continue;
-    const id = edge.key ?? attrs.id;
-    if (!id) continue;
-    if (graph.hasEdge(id)) continue;
+  for (const edge of validEdges) {
+    if (graph.hasEdge(edge.key)) continue;
     if (!graph.hasNode(edge.source) || !graph.hasNode(edge.target)) continue;
-    graph.addEdgeWithKey(id, edge.source, edge.target, attrs);
+    graph.addEdgeWithKey(edge.key, edge.source, edge.target, edge.attributes);
     edgesAdded++;
   }
   return { nodesAdded, edgesAdded };
@@ -3838,9 +3876,9 @@ var K8S_KINDS_WITH_HOSTNAMES = /* @__PURE__ */ new Set([
   "StatefulSet",
   "DaemonSet"
 ]);
-function addAliases(graph, serviceId4, candidates) {
-  if (!graph.hasNode(serviceId4)) return;
-  const node = graph.getNodeAttributes(serviceId4);
+function addAliases(graph, serviceId5, candidates) {
+  if (!graph.hasNode(serviceId5)) return;
+  const node = graph.getNodeAttributes(serviceId5);
   if (node.type !== import_types6.NodeType.ServiceNode) return;
   const set = new Set(node.aliases ?? []);
   for (const c of candidates) {
@@ -3850,7 +3888,7 @@ function addAliases(graph, serviceId4, candidates) {
   }
   if (set.size === 0) return;
   const updated = { ...node, aliases: [...set].sort() };
-  graph.replaceNodeAttributes(serviceId4, updated);
+  graph.replaceNodeAttributes(serviceId5, updated);
 }
 function indexServicesByName(services) {
   const map = /* @__PURE__ */ new Map();
@@ -3883,12 +3921,12 @@ async function collectComposeAliases(graph, scanPath, serviceIndex) {
   }
   if (!compose?.services) return;
   for (const [composeName, svc] of Object.entries(compose.services)) {
-    const serviceId4 = serviceIndex.get(composeName);
-    if (!serviceId4) continue;
+    const serviceId5 = serviceIndex.get(composeName);
+    if (!serviceId5) 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, serviceId4, aliases);
+    addAliases(graph, serviceId5, aliases);
   }
 }
 var LABEL_KEYS = /* @__PURE__ */ new Set([
@@ -7352,13 +7390,13 @@ function bucketKey(source, target, type) {
   return `${type}|${source}|${target}`;
 }
 function bucketEdges(graph) {
-  const buckets = /* @__PURE__ */ new Map();
+  const buckets2 = /* @__PURE__ */ new Map();
   graph.forEachEdge((id, attrs) => {
     const e = attrs;
     const parsed = (0, import_types27.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 };
+    const cur = buckets2.get(key) ?? { source: e.source, target: e.target, type: e.type };
     switch (provenance) {
       case import_types27.Provenance.EXTRACTED:
         cur.extracted = e;
@@ -7372,9 +7410,9 @@ function bucketEdges(graph) {
       default:
         if (e.provenance === import_types27.Provenance.STALE) cur.stale = e;
     }
-    buckets.set(key, cur);
+    buckets2.set(key, cur);
   });
-  return buckets;
+  return buckets2;
 }
 function nodeIsFrontier(graph, nodeId) {
   if (!graph.hasNode(nodeId)) return false;
@@ -7565,8 +7603,8 @@ function suppressHostMismatchHalves(all) {
 }
 function computeDivergences(graph, opts = {}) {
   const all = [];
-  const buckets = bucketEdges(graph);
-  for (const bucket of buckets.values()) {
+  const buckets2 = bucketEdges(graph);
+  for (const bucket of buckets2.values()) {
     for (const d of detectMissingDivergences(graph, bucket)) all.push(d);
   }
   graph.forEachNode((nodeId, attrs) => {
@@ -7612,6 +7650,51 @@ function computeDivergences(graph, opts = {}) {
   });
 }
 
+// src/logs-store.ts
+init_cjs_shims();
+var LOGS_STORE_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
+var LOGS_QUERY_DEFAULT_LIMIT = 100;
+var LOGS_QUERY_MAX_LIMIT = 1e3;
+var buffers = /* @__PURE__ */ new Map();
+var KEY_SEP = "::";
+function bufferKey(projectName, source) {
+  return `${projectName}${KEY_SEP}${source}`;
+}
+function sourcesForProject(projectName) {
+  const prefix = `${projectName}${KEY_SEP}`;
+  const sources = [];
+  for (const key of buffers.keys()) {
+    if (key.startsWith(prefix)) sources.push(key.slice(prefix.length));
+  }
+  return sources;
+}
+function queryLogEntries(opts) {
+  const { projectName, source, service, since, limit } = opts;
+  const sources = source && source.length > 0 ? source : sourcesForProject(projectName);
+  let merged = [];
+  for (const src of sources) {
+    const buf = buffers.get(bufferKey(projectName, src));
+    if (buf) merged = merged.concat(buf);
+  }
+  if (service) {
+    merged = merged.filter((e) => e.serviceName === service);
+  }
+  if (since) {
+    const sinceMs = Date.parse(since);
+    if (!Number.isNaN(sinceMs)) {
+      merged = merged.filter((e) => {
+        const t = Date.parse(e.timestamp);
+        return Number.isNaN(t) || t >= sinceMs;
+      });
+    }
+  }
+  merged.sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));
+  if (typeof limit === "number" && Number.isFinite(limit) && limit >= 0) {
+    return merged.slice(0, limit);
+  }
+  return merged;
+}
+
 // src/diff.ts
 init_cjs_shims();
 var import_node_fs23 = require("fs");
@@ -8291,6 +8374,23 @@ function registerRoutes(scope, ctx) {
     const sliced = ordered.slice(0, Number.isFinite(limit) && limit > 0 ? limit : 50);
     return { count: sliced.length, total, events: sliced };
   });
+  scope.get("/logs", async (req, reply) => {
+    const proj = resolveProject(registry, req, reply, ctx.bootstrap, ctx.singleProject);
+    if (!proj) return;
+    const rawSource = req.query.source;
+    const sources = rawSource === void 0 ? void 0 : Array.isArray(rawSource) ? rawSource : [rawSource];
+    const filtered = queryLogEntries({
+      projectName: proj.name,
+      ...sources && sources.length > 0 ? { source: sources } : {},
+      ...req.query.service ? { service: req.query.service } : {},
+      ...req.query.since ? { since: req.query.since } : {}
+    });
+    const total = filtered.length;
+    const limit = req.query.limit ? Number(req.query.limit) : LOGS_QUERY_DEFAULT_LIMIT;
+    const safeLimit = Number.isFinite(limit) && limit > 0 ? Math.min(limit, LOGS_QUERY_MAX_LIMIT) : LOGS_QUERY_DEFAULT_LIMIT;
+    const sliced = filtered.slice(0, safeLimit);
+    return { count: sliced.length, total, logs: sliced };
+  });
   const incidentHistoryHandler = async (req, reply) => {
     const proj = resolveProject(registry, req, reply, ctx.bootstrap, ctx.singleProject);
     if (!proj) return;
@@ -8386,8 +8486,16 @@ function registerRoutes(scope, ctx) {
       if (!against) {
         return reply.code(400).send({ error: "query parameter `against` is required" });
       }
+      const targetProjectName = against === "self" ? proj.name : against;
+      const targetProject = registry.get(targetProjectName);
+      if (!targetProject) {
+        return reply.code(400).send({
+          error: "unknown snapshot id \u2014 `against` must be `self` or the name of a project this server has a snapshot for",
+          against
+        });
+      }
       try {
-        const snapshot = await loadSnapshotForDiff(against);
+        const snapshot = await loadSnapshotForDiff(targetProject.paths.snapshotPath);
         return computeGraphDiff(proj.graph, snapshot);
       } catch (err) {
         return reply.code(400).send({ error: "failed to load snapshot", against, detail: err.message });
@@ -8417,6 +8525,13 @@ function registerRoutes(scope, ctx) {
         edgeCount: proj.graph.size
       };
     } catch (err) {
+      if (err instanceof SnapshotValidationError) {
+        return reply.code(400).send({
+          error: "snapshot merge failed",
+          details: err.message,
+          issues: err.issues
+        });
+      }
       return reply.code(400).send({
         error: "snapshot merge failed",
         details: err.message
@@ -8763,8 +8878,8 @@ init_otel_grpc();
 
 // src/daemon.ts
 init_cjs_shims();
-var import_node_fs26 = require("fs");
-var import_node_path45 = __toESM(require("path"), 1);
+var import_node_fs27 = require("fs");
+var import_node_path46 = __toESM(require("path"), 1);
 var import_node_module = require("module");
 init_otel();
 
@@ -8845,13 +8960,1533 @@ function startConnectorPollLoop(connector, ctx, graph, resolveTarget, options =
   };
 }
 
+// src/connectors/registry.ts
+init_cjs_shims();
+
+// src/connectors/junction.ts
+init_cjs_shims();
+var buckets = /* @__PURE__ */ new Map();
+function bucketMapKey(provider, accountKey) {
+  return `${provider}\0${accountKey}`;
+}
+function getBucket(provider, accountKey, config) {
+  const key = bucketMapKey(provider, accountKey);
+  const existing = buckets.get(key);
+  if (existing && existing.capacity === config.capacity && existing.refillMs === config.refillMs) {
+    return existing;
+  }
+  const fresh = { ...config, tokens: config.capacity, updatedAt: Date.now() };
+  buckets.set(key, fresh);
+  return fresh;
+}
+function refillBucket(bucket, now) {
+  if (now <= bucket.updatedAt) return;
+  const elapsed = now - bucket.updatedAt;
+  const grant = elapsed / bucket.refillMs;
+  if (grant <= 0) return;
+  bucket.tokens = Math.min(bucket.capacity, bucket.tokens + grant);
+  bucket.updatedAt = now;
+}
+var RateLimitExceededError = class extends Error {
+  constructor(provider, accountKey) {
+    super(
+      `junction: rate limit exceeded for ${provider}:${accountKey} \u2014 waiting for the next token would exceed this call's wall-clock budget`
+    );
+    this.name = "RateLimitExceededError";
+  }
+};
+function delay(ms) {
+  if (ms <= 0) return Promise.resolve();
+  return new Promise((resolve) => {
+    const timer = setTimeout(resolve, ms);
+    if (typeof timer.unref === "function") timer.unref();
+  });
+}
+async function acquireToken(provider, accountKey, config, remainingBudgetMs) {
+  const bucket = getBucket(provider, accountKey, config);
+  refillBucket(bucket, Date.now());
+  if (bucket.tokens >= 1) {
+    bucket.tokens -= 1;
+    return 0;
+  }
+  const waitMs = Math.ceil((1 - bucket.tokens) * bucket.refillMs);
+  if (waitMs > remainingBudgetMs) {
+    throw new RateLimitExceededError(provider, accountKey);
+  }
+  await delay(waitMs);
+  refillBucket(bucket, Date.now());
+  bucket.tokens = Math.max(0, bucket.tokens - 1);
+  return waitMs;
+}
+var JUNCTION_DEFAULT_RATE_LIMITS = {
+  // ~300 requests / 5 minutes (ADR-131). Burst capacity holds a third of
+  // that ceiling; steady-state refill (1 token / 3s = 20/min = 100/5min)
+  // stays well clear of the documented limit even under sustained polling.
+  cloudflare: { capacity: 100, refillMs: 3e3 },
+  // Placeholder pending a live project confirming the real cap
+  // (docs/connectors/railway.md: "does not appear to publish one as of this
+  // writing").
+  railway: { capacity: 30, refillMs: 1e4 },
+  // Placeholder pending a live rate-limit check (docs/connectors/
+  // firebase.md: "needs-endpoint-testing against entries.list's live rate
+  // limits").
+  firebase: { capacity: 30, refillMs: 1e4 },
+  // Placeholder pending a live rate-limit check (docs/connectors/supabase.md:
+  // "the documented rate limit for this specific endpoint is unconfirmed").
+  supabase: { capacity: 30, refillMs: 1e4 },
+  // Not a documented API limit at all — a self-imposed ceiling on the raw
+  // pg_stat_statements connection (see module header above).
+  "supabase-postgres": { capacity: 20, refillMs: 3e3 }
+};
+var JUNCTION_GENERIC_RATE_LIMIT = { capacity: 20, refillMs: 5e3 };
+function defaultRateLimitFor(provider) {
+  return JUNCTION_DEFAULT_RATE_LIMITS[provider] ?? JUNCTION_GENERIC_RATE_LIMIT;
+}
+var JUNCTION_DEFAULT_TIMEOUT_MS = 1e4;
+var JUNCTION_DEFAULT_MAX_ATTEMPTS = 3;
+var JUNCTION_DEFAULT_INITIAL_BACKOFF_MS = 200;
+var JUNCTION_DEFAULT_BACKOFF_MULTIPLIER = 4;
+var JUNCTION_DEFAULT_MAX_ELAPSED_MS = 3e4;
+var JUNCTION_DEFAULT_DB_TIMEOUT_MS = 1e4;
+async function backoff(attempt, initialBackoffMs, backoffMultiplier, remainingBudgetMs) {
+  const raw = initialBackoffMs * backoffMultiplier ** (attempt - 1);
+  const capped = Math.max(0, Math.min(raw, remainingBudgetMs));
+  await delay(capped);
+}
+function safeUrlLabel(url) {
+  try {
+    const u = typeof url === "string" ? new URL(url) : url;
+    return `${u.origin}${u.pathname}`;
+  } catch {
+    return String(url);
+  }
+}
+function logOutcome(provider, accountKey, outcome, method, label, attempt, startedAt) {
+  const elapsedMs = Date.now() - startedAt;
+  const line = `[neat connector] ${provider}:${accountKey} ${method} ${label} \u2014 ${outcome} (attempt ${attempt}, ${elapsedMs}ms)`;
+  if (outcome === "success" || outcome === "retried-then-succeeded") {
+    console.log(line);
+  } else if (outcome === "rate-limited") {
+    console.warn(line);
+  } else {
+    console.error(line);
+  }
+}
+function bearerAuthHeader(token) {
+  return { Authorization: `Bearer ${token}` };
+}
+async function junctionFetch(url, init = {}, policy) {
+  const {
+    provider,
+    accountKey,
+    timeoutMs = JUNCTION_DEFAULT_TIMEOUT_MS,
+    maxAttempts = JUNCTION_DEFAULT_MAX_ATTEMPTS,
+    maxElapsedMs = JUNCTION_DEFAULT_MAX_ELAPSED_MS,
+    initialBackoffMs = JUNCTION_DEFAULT_INITIAL_BACKOFF_MS,
+    backoffMultiplier = JUNCTION_DEFAULT_BACKOFF_MULTIPLIER,
+    rateLimit = defaultRateLimitFor(provider),
+    fetchImpl = fetch
+  } = policy;
+  const method = (init.method ?? "GET").toUpperCase();
+  const label = safeUrlLabel(url);
+  const startedAt = Date.now();
+  let attempt = 0;
+  let sawRetry = false;
+  for (; ; ) {
+    attempt++;
+    const remainingBudget = maxElapsedMs - (Date.now() - startedAt);
+    if (remainingBudget <= 0) {
+      logOutcome(provider, accountKey, "retried-then-failed", method, label, attempt - 1, startedAt);
+      throw new Error(
+        `junction: ${provider}:${accountKey} ${method} ${label} exceeded its wall-clock budget (${maxElapsedMs}ms) after ${attempt - 1} attempt(s)`
+      );
+    }
+    try {
+      await acquireToken(provider, accountKey, rateLimit, remainingBudget);
+    } catch (err) {
+      if (err instanceof RateLimitExceededError) {
+        logOutcome(provider, accountKey, "rate-limited", method, label, attempt, startedAt);
+      }
+      throw err;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    if (typeof timer.unref === "function") timer.unref();
+    try {
+      const res = await fetchImpl(url, { ...init, signal: controller.signal });
+      clearTimeout(timer);
+      if (res.ok || res.status < 500) {
+        logOutcome(provider, accountKey, sawRetry ? "retried-then-succeeded" : "success", method, label, attempt, startedAt);
+        return res;
+      }
+      if (attempt >= maxAttempts) {
+        logOutcome(provider, accountKey, sawRetry ? "retried-then-failed" : "failed", method, label, attempt, startedAt);
+        return res;
+      }
+      sawRetry = true;
+      await backoff(attempt, initialBackoffMs, backoffMultiplier, maxElapsedMs - (Date.now() - startedAt));
+    } catch (err) {
+      clearTimeout(timer);
+      if (attempt >= maxAttempts) {
+        logOutcome(provider, accountKey, sawRetry ? "retried-then-failed" : "failed", method, label, attempt, startedAt);
+        throw err;
+      }
+      sawRetry = true;
+      await backoff(attempt, initialBackoffMs, backoffMultiplier, maxElapsedMs - (Date.now() - startedAt));
+    }
+  }
+}
+var DbJunctionTimeoutError = class extends Error {
+  constructor(ms) {
+    super(`junction: db query exceeded its ${ms}ms timeout`);
+    this.name = "DbJunctionTimeoutError";
+  }
+};
+function withTimeout(run, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new DbJunctionTimeoutError(timeoutMs)), timeoutMs);
+    if (typeof timer.unref === "function") timer.unref();
+    run().then(
+      (value) => {
+        clearTimeout(timer);
+        resolve(value);
+      },
+      (err) => {
+        clearTimeout(timer);
+        reject(err);
+      }
+    );
+  });
+}
+var RETRYABLE_NODE_ERROR_CODES = /* @__PURE__ */ new Set(["ECONNREFUSED", "ECONNRESET", "ETIMEDOUT", "EHOSTUNREACH", "EAI_AGAIN", "EPIPE"]);
+function isRetryableDbError(err) {
+  if (err instanceof DbJunctionTimeoutError) return true;
+  const code = err?.code;
+  if (typeof code !== "string") return false;
+  if (code.startsWith("08") || code === "57P03") return true;
+  return RETRYABLE_NODE_ERROR_CODES.has(code);
+}
+async function dbJunction(run, policy) {
+  const {
+    provider,
+    accountKey,
+    timeoutMs = JUNCTION_DEFAULT_DB_TIMEOUT_MS,
+    maxAttempts = JUNCTION_DEFAULT_MAX_ATTEMPTS,
+    maxElapsedMs = JUNCTION_DEFAULT_MAX_ELAPSED_MS,
+    initialBackoffMs = JUNCTION_DEFAULT_INITIAL_BACKOFF_MS,
+    backoffMultiplier = JUNCTION_DEFAULT_BACKOFF_MULTIPLIER,
+    rateLimit = defaultRateLimitFor(provider)
+  } = policy;
+  const startedAt = Date.now();
+  let attempt = 0;
+  let sawRetry = false;
+  for (; ; ) {
+    attempt++;
+    const remainingBudget = maxElapsedMs - (Date.now() - startedAt);
+    if (remainingBudget <= 0) {
+      logOutcome(provider, accountKey, "retried-then-failed", "QUERY", "db", attempt - 1, startedAt);
+      throw new Error(
+        `junction: ${provider}:${accountKey} db query exceeded its wall-clock budget (${maxElapsedMs}ms) after ${attempt - 1} attempt(s)`
+      );
+    }
+    try {
+      await acquireToken(provider, accountKey, rateLimit, remainingBudget);
+    } catch (err) {
+      if (err instanceof RateLimitExceededError) {
+        logOutcome(provider, accountKey, "rate-limited", "QUERY", "db", attempt, startedAt);
+      }
+      throw err;
+    }
+    try {
+      const result = await withTimeout(run, timeoutMs);
+      logOutcome(provider, accountKey, sawRetry ? "retried-then-succeeded" : "success", "QUERY", "db", attempt, startedAt);
+      return result;
+    } catch (err) {
+      if (!isRetryableDbError(err) || attempt >= maxAttempts) {
+        logOutcome(provider, accountKey, sawRetry ? "retried-then-failed" : "failed", "QUERY", "db", attempt, startedAt);
+        throw err;
+      }
+      sawRetry = true;
+      await backoff(attempt, initialBackoffMs, backoffMultiplier, maxElapsedMs - (Date.now() - startedAt));
+    }
+  }
+}
+
+// src/connectors/supabase/index.ts
+init_cjs_shims();
+
+// src/connectors/supabase/client.ts
+init_cjs_shims();
+var DEFAULT_SUPABASE_MANAGEMENT_API_URL = "https://api.supabase.com";
+var DEFAULT_LOG_LIMIT = 1e3;
+var SUPABASE_LOG_QUERY_MAX_WINDOW_MS = 24 * 60 * 60 * 1e3;
+function boundedSupabaseLogWindow(since, now, maxLookbackMs) {
+  const window = Math.min(maxLookbackMs, SUPABASE_LOG_QUERY_MAX_WINDOW_MS);
+  const floor = new Date(now.getTime() - window);
+  const endIso = now.toISOString();
+  if (!since) return { startIso: floor.toISOString(), endIso, truncated: false };
+  const sinceMs = new Date(since).getTime();
+  if (Number.isNaN(sinceMs)) return { startIso: floor.toISOString(), endIso, truncated: false };
+  if (sinceMs < floor.getTime()) return { startIso: floor.toISOString(), endIso, truncated: true };
+  return { startIso: new Date(sinceMs).toISOString(), endIso, truncated: false };
+}
+function buildEdgeLogsQuery(limit) {
+  const safeLimit = Math.max(1, Math.trunc(limit) || DEFAULT_LOG_LIMIT);
+  return [
+    "select",
+    "  format_timestamp('%Y-%m-%dT%H:%M:%E6SZ', timestamp) as timestamp,",
+    "  request.method as method,",
+    "  request.path as path,",
+    "  response.status_code as status_code",
+    "from edge_logs",
+    "cross join unnest(metadata) as metadata",
+    "cross join unnest(metadata.request) as request",
+    "cross join unnest(metadata.response) as response",
+    "where regexp_contains(request.path, '^/rest/v1/')",
+    "order by timestamp asc",
+    `limit ${safeLimit}`
+  ].join("\n");
+}
+async function fetchSupabaseEdgeLogs(config, token, startIso, endIso, fetchImpl = fetch) {
+  const baseUrl = config.managementApiUrl ?? DEFAULT_SUPABASE_MANAGEMENT_API_URL;
+  const url = new URL(`${baseUrl}/v1/projects/${config.apiProjectRef}/analytics/endpoints/logs.all`);
+  url.searchParams.set("sql", buildEdgeLogsQuery(config.logLimit ?? DEFAULT_LOG_LIMIT));
+  url.searchParams.set("iso_timestamp_start", startIso);
+  url.searchParams.set("iso_timestamp_end", endIso);
+  const res = await junctionFetch(
+    url,
+    { method: "GET", headers: bearerAuthHeader(token) },
+    // accountKey: the Supabase project ref (ADR-131's own worked example) —
+    // the Management API's rate limit is enforced per project.
+    { provider: "supabase", accountKey: config.apiProjectRef, fetchImpl }
+  );
+  if (!res.ok) {
+    throw new Error(`supabase connector: logs.all request failed (${res.status} ${res.statusText})`);
+  }
+  const body = await res.json();
+  if (body.error) {
+    const message = typeof body.error === "string" ? body.error : body.error.message;
+    throw new Error(`supabase connector: logs.all returned an error (${message})`);
+  }
+  return body.result ?? [];
+}
+
+// src/connectors/supabase/map.ts
+init_cjs_shims();
+
+// src/connectors/supabase/types.ts
+init_cjs_shims();
+function readSupabaseCredentials(raw) {
+  const managementToken = raw["managementToken"];
+  if (typeof managementToken !== "string" || managementToken.length === 0) {
+    throw new Error("supabase connector: credentials.managementToken must be a non-empty string");
+  }
+  const postgresConnectionString = raw["postgresConnectionString"];
+  if (postgresConnectionString !== void 0 && (typeof postgresConnectionString !== "string" || postgresConnectionString.length === 0)) {
+    throw new Error(
+      "supabase connector: credentials.postgresConnectionString must be a non-empty string when present"
+    );
+  }
+  return {
+    managementToken,
+    ...postgresConnectionString ? { postgresConnectionString } : {}
+  };
+}
+var SUPABASE_TABLE_TARGET_KIND = "supabase-table";
+var SUPABASE_RPC_TARGET_KIND = "supabase-rpc";
+
+// src/connectors/supabase/map.ts
+var REST_RPC_PATH_RE = /^\/rest\/v1\/rpc\/([^/?]+)/;
+var REST_TABLE_PATH_RE = /^\/rest\/v1\/([^/?]+)/;
+function targetFromRestPath(path47) {
+  const rpcMatch = REST_RPC_PATH_RE.exec(path47);
+  if (rpcMatch) return { targetKind: SUPABASE_RPC_TARGET_KIND, name: rpcMatch[1] };
+  const tableMatch = REST_TABLE_PATH_RE.exec(path47);
+  if (tableMatch) return { targetKind: SUPABASE_TABLE_TARGET_KIND, name: tableMatch[1] };
+  return null;
+}
+var ERROR_STATUS_THRESHOLD = 500;
+function mapEdgeLogRowsToSignals(rows) {
+  const buckets2 = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const target = targetFromRestPath(row.path);
+    if (!target) continue;
+    const key = `${target.targetKind}:${target.name}`;
+    const isError = row.status_code >= ERROR_STATUS_THRESHOLD;
+    const existing = buckets2.get(key);
+    if (existing) {
+      existing.callCount += 1;
+      if (isError) existing.errorCount += 1;
+      if (row.timestamp > existing.lastObservedIso) existing.lastObservedIso = row.timestamp;
+    } else {
+      buckets2.set(key, {
+        targetKind: target.targetKind,
+        targetName: target.name,
+        callCount: 1,
+        errorCount: isError ? 1 : 0,
+        lastObservedIso: row.timestamp
+      });
+    }
+  }
+  return [...buckets2.values()].map((b) => ({
+    targetKind: b.targetKind,
+    targetName: b.targetName,
+    callCount: b.callCount,
+    errorCount: b.errorCount,
+    lastObservedIso: b.lastObservedIso
+  }));
+}
+var FROM_TABLE_RE = /\bfrom\s+"?(?:[a-z_][a-z0-9_]*"?\.)?"?([a-z_][a-z0-9_]*)"?/i;
+var SYSTEM_SCHEMA_PREFIXES = ["pg_", "information_schema"];
+function tableNameFromQueryText(query) {
+  const match = FROM_TABLE_RE.exec(query);
+  if (!match) return null;
+  const name = match[1];
+  const lower = name.toLowerCase();
+  if (SYSTEM_SCHEMA_PREFIXES.some((prefix) => lower.startsWith(prefix))) return null;
+  return name;
+}
+function diffPgStatStatementsToSignals(rows, previous, nowIso2) {
+  const signals = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const row of rows) {
+    seen.add(row.queryid);
+    const calls = Number(row.calls);
+    const prior = previous.get(row.queryid);
+    previous.set(row.queryid, { calls });
+    if (!prior || calls < prior.calls) continue;
+    const delta = calls - prior.calls;
+    if (delta <= 0) continue;
+    const table = tableNameFromQueryText(row.query);
+    if (!table) continue;
+    signals.push({
+      targetKind: SUPABASE_TABLE_TARGET_KIND,
+      targetName: table,
+      callCount: delta,
+      errorCount: 0,
+      lastObservedIso: nowIso2
+    });
+  }
+  for (const queryid of [...previous.keys()]) {
+    if (!seen.has(queryid)) previous.delete(queryid);
+  }
+  return signals;
+}
+
+// src/connectors/supabase/postgres-client.ts
+init_cjs_shims();
+var import_pg = __toESM(require("pg"), 1);
+var { Client } = import_pg.default;
+var DEFAULT_STATEMENT_LIMIT = 500;
+var STATEMENTS_QUERY = `
+  select queryid, query, calls, total_exec_time, rows
+  from pg_stat_statements
+  where query ~* '^\\s*select\\b'
+  order by calls desc
+  limit $1
+`;
+async function fetchPgStatStatements(connectionString, limit = DEFAULT_STATEMENT_LIMIT, accountKey = "unknown", clientFactory = (cs) => new Client({ connectionString: cs })) {
+  return dbJunction(
+    async () => {
+      const client = clientFactory(connectionString);
+      await client.connect();
+      try {
+        await client.query("SET default_transaction_read_only = on");
+        const result = await client.query(STATEMENTS_QUERY, [limit]);
+        return result.rows;
+      } finally {
+        await client.end();
+      }
+    },
+    { provider: "supabase-postgres", accountKey }
+  );
+}
+
+// src/connectors/supabase/resolve.ts
+init_cjs_shims();
+var import_types31 = require("@neat.is/types");
+function createSupabaseResolveTarget(graph, config) {
+  return (signal, _ctx) => {
+    if (signal.targetKind !== SUPABASE_TABLE_TARGET_KIND && signal.targetKind !== SUPABASE_RPC_TARGET_KIND) {
+      return null;
+    }
+    const subResourceId = (0, import_types31.infraId)(signal.targetKind, `${config.nodeRef}/${signal.targetName}`);
+    if (graph.hasNode(subResourceId)) {
+      return { targetNodeId: subResourceId, serviceName: config.serviceName, edgeType: import_types31.EdgeType.CALLS };
+    }
+    const projectLevelId = (0, import_types31.infraId)("supabase", config.nodeRef);
+    if (graph.hasNode(projectLevelId)) {
+      return { targetNodeId: projectLevelId, serviceName: config.serviceName, edgeType: import_types31.EdgeType.CALLS };
+    }
+    return null;
+  };
+}
+
+// src/connectors/supabase/index.ts
+var DEFAULT_MAX_LOOKBACK_MS = 24 * 60 * 60 * 1e3;
+var SupabaseConnector = class {
+  // `deps.fetchPgStatStatements` defaults to the real Postgres-backed
+  // implementation; tests override it to exercise the "both surfaces
+  // combine" and "surface 2 only runs when a connection string is present"
+  // behavior without a live database — the same dependency-injection seam
+  // `fetchImpl` gives cloudflare/client.ts's tests for `fetch`.
+  constructor(config, deps = {}) {
+    this.config = config;
+    this.deps = deps;
+  }
+  config;
+  deps;
+  provider = "supabase";
+  // pg_stat_statements.calls is cumulative, not per-window (map.ts's
+  // diffPgStatStatementsToSignals doc comment) — this Map carries the
+  // previous poll's counts across ticks, the same way
+  // `startConnectorPollLoop` (connectors/index.ts) carries `since` across
+  // ticks for every connector. Lives on the instance, not `ConnectorContext`,
+  // because `ConnectorContext` is rebuilt fresh per tick (connectors/index.ts's
+  // `{ ...ctx, since }`) while this connector object is the one thing every
+  // tick shares.
+  statementBaselines = /* @__PURE__ */ new Map();
+  async poll(ctx) {
+    const creds = readSupabaseCredentials(ctx.credentials);
+    const now = /* @__PURE__ */ new Date();
+    const maxLookbackMs = this.config.maxLookbackMs ?? DEFAULT_MAX_LOOKBACK_MS;
+    const { startIso, endIso } = boundedSupabaseLogWindow(ctx.since, now, maxLookbackMs);
+    const logRows = await fetchSupabaseEdgeLogs(this.config, creds.managementToken, startIso, endIso);
+    const signals = mapEdgeLogRowsToSignals(logRows);
+    if (creds.postgresConnectionString) {
+      const fetchStatements = this.deps.fetchPgStatStatements ?? fetchPgStatStatements;
+      const statementRows = await fetchStatements(
+        creds.postgresConnectionString,
+        this.config.statementLimit ?? DEFAULT_STATEMENT_LIMIT,
+        this.config.apiProjectRef
+      );
+      signals.push(...diffPgStatStatementsToSignals(statementRows, this.statementBaselines, now.toISOString()));
+    }
+    return signals;
+  }
+};
+function createSupabaseConnector(graph, config, deps = {}) {
+  return {
+    connector: new SupabaseConnector(config, deps),
+    resolveTarget: createSupabaseResolveTarget(graph, config)
+  };
+}
+
+// src/connectors/railway/index.ts
+init_cjs_shims();
+var import_types35 = require("@neat.is/types");
+
+// src/connectors/railway/client.ts
+init_cjs_shims();
+var DEFAULT_RAILWAY_API_URL = "https://backboard.railway.com/graphql/v2";
+var DEFAULT_MAX_LOOKBACK_MS2 = 24 * 60 * 60 * 1e3;
+var DEFAULT_LOG_LIMIT2 = 1e3;
+function readRailwayToken(credentials) {
+  const token = credentials.token;
+  if (typeof token !== "string" || token.length === 0) {
+    throw new Error(
+      "Railway connector requires ctx.credentials.token (a Project-Access-Token or account Bearer token)"
+    );
+  }
+  return token;
+}
+async function railwayGraphQL(apiUrl, token, query, variables, accountKey) {
+  const res = await junctionFetch(
+    apiUrl,
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        // docs.railway.com/integrations/api/graphql-overview confirms
+        // `Authorization: Bearer <token>` for an account/workspace token;
+        // Railway also documents a dedicated `Project-Access-Token: <token>`
+        // header for the project-scoped token ADR-127 targets specifically.
+        // This connector sends the Bearer form — needs-endpoint-testing
+        // whether a live Project-Access-Token requires the dedicated header
+        // instead once this poller runs against a real project.
+        ...bearerAuthHeader(token)
+      },
+      body: JSON.stringify({ query, variables })
+    },
+    { provider: "railway", accountKey }
+  );
+  if (!res.ok) {
+    throw new Error(`Railway GraphQL request failed: ${res.status} ${res.statusText}`);
+  }
+  const body = await res.json();
+  if (body.errors && body.errors.length > 0) {
+    throw new Error(`Railway GraphQL errors: ${body.errors.map((e) => e.message).join("; ")}`);
+  }
+  if (!body.data) throw new Error("Railway GraphQL response carried no data");
+  return body.data;
+}
+var HTTP_LOGS_QUERY = `
+  query HttpLogs(
+    $environmentId: String!
+    $serviceId: String!
+    $startDate: String!
+    $endDate: String!
+    $limit: Int
+  ) {
+    httpLogs(
+      environmentId: $environmentId
+      serviceId: $serviceId
+      startDate: $startDate
+      endDate: $endDate
+      limit: $limit
+    ) {
+      timestamp
+      method
+      path
+      httpStatus
+      totalDuration
+      requestId
+      deploymentId
+      edgeRegion
+    }
+  }
+`;
+var NETWORK_FLOW_LOGS_QUERY = `
+  query NetworkFlowLogs(
+    $environmentId: String!
+    $serviceId: String!
+    $startDate: String!
+    $endDate: String!
+    $limit: Int
+  ) {
+    networkFlowLogs(
+      environmentId: $environmentId
+      serviceId: $serviceId
+      startDate: $startDate
+      endDate: $endDate
+      limit: $limit
+    ) {
+      timestamp
+      peerServiceId
+      peerKind
+      direction
+      byteCount
+      packetCount
+      dropCause
+    }
+  }
+`;
+async function fetchRailwayHttpLogs(config, token, startDate, endDate) {
+  const data = await railwayGraphQL(
+    config.apiUrl ?? DEFAULT_RAILWAY_API_URL,
+    token,
+    HTTP_LOGS_QUERY,
+    {
+      environmentId: config.environmentId,
+      serviceId: config.serviceId,
+      startDate,
+      endDate,
+      limit: config.limit ?? DEFAULT_LOG_LIMIT2
+    },
+    config.environmentId
+  );
+  return data.httpLogs;
+}
+async function fetchRailwayNetworkFlowLogs(config, token, startDate, endDate) {
+  const data = await railwayGraphQL(
+    config.apiUrl ?? DEFAULT_RAILWAY_API_URL,
+    token,
+    NETWORK_FLOW_LOGS_QUERY,
+    {
+      environmentId: config.environmentId,
+      serviceId: config.serviceId,
+      startDate,
+      endDate,
+      limit: config.limit ?? DEFAULT_LOG_LIMIT2
+    },
+    config.environmentId
+  );
+  return data.networkFlowLogs;
+}
+function boundedRailwayStartDate(since, now, maxLookbackMs) {
+  const floor = new Date(now.getTime() - maxLookbackMs);
+  if (!since) return floor.toISOString();
+  const sinceMs = new Date(since).getTime();
+  if (Number.isNaN(sinceMs)) return floor.toISOString();
+  return sinceMs < floor.getTime() ? floor.toISOString() : new Date(sinceMs).toISOString();
+}
+
+// src/connectors/railway/index.ts
+var ROUTE_TARGET_KIND = "route";
+var UNMATCHED_ROUTE_TARGET_KIND = "unmatched-route";
+var PEER_SERVICE_TARGET_KIND = "peer-service";
+function buildRailwayRouteIndex(graph, serviceName) {
+  const out = [];
+  graph.forEachNode((_id, attrs) => {
+    const node = attrs;
+    if (node.type !== import_types35.NodeType.RouteNode) return;
+    const route = attrs;
+    if (route.service !== serviceName) return;
+    out.push({
+      method: route.method.toUpperCase(),
+      normalizedPath: normalizePathTemplate(route.pathTemplate),
+      routeNodeId: route.id,
+      path: route.path,
+      line: route.line
+    });
+  });
+  return out;
+}
+function findRailwayRoute(entries, method, normalizedPath) {
+  return entries.find(
+    (e) => e.normalizedPath === normalizedPath && (e.method === "ALL" || e.method === method)
+  );
+}
+function bucketKey2(method, normalizedPath) {
+  return `${method} ${normalizedPath}`;
+}
+function isHttpErrorStatus(status2) {
+  return status2 >= 400;
+}
+function upsertBucket(buckets2, key, isError, timestamp, build) {
+  const existing = buckets2.get(key);
+  if (existing) {
+    existing.callCount += 1;
+    if (isError) existing.errorCount += 1;
+    if (timestamp > existing.lastObservedIso) existing.lastObservedIso = timestamp;
+    return;
+  }
+  buckets2.set(key, { callCount: 1, errorCount: isError ? 1 : 0, lastObservedIso: timestamp, ...build() });
+}
+function mapRailwayHttpLogsToSignals(entries, routeIndex) {
+  const buckets2 = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const method = entry.method.toUpperCase();
+    const normalizedPath = normalizePathTemplate(entry.path);
+    const match = findRailwayRoute(routeIndex, method, normalizedPath);
+    const isError = isHttpErrorStatus(entry.httpStatus);
+    if (match) {
+      upsertBucket(buckets2, `route:${match.routeNodeId}`, isError, entry.timestamp, () => ({
+        targetKind: ROUTE_TARGET_KIND,
+        targetName: match.routeNodeId,
+        // RouteNode.line is optional in the schema (packages/types/src/
+        // nodes.ts) even though routes.ts always sets it today — skip the
+        // callSite rather than fabricate a line when it's ever absent
+        // (file-awareness.md §6).
+        ...match.line !== void 0 ? { callSite: { file: match.path, line: match.line } } : {}
+      }));
+    } else {
+      upsertBucket(
+        buckets2,
+        `unmatched:${bucketKey2(method, normalizedPath)}`,
+        isError,
+        entry.timestamp,
+        () => ({
+          targetKind: UNMATCHED_ROUTE_TARGET_KIND,
+          targetName: bucketKey2(method, normalizedPath)
+        })
+      );
+    }
+  }
+  return [...buckets2.values()].map((b) => ({
+    targetKind: b.targetKind,
+    targetName: b.targetName,
+    callCount: b.callCount,
+    errorCount: b.errorCount,
+    lastObservedIso: b.lastObservedIso,
+    ...b.callSite ? { callSite: b.callSite } : {}
+  }));
+}
+function mapRailwayNetworkFlowLogsToSignals(entries) {
+  const buckets2 = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    if (!entry.peerServiceId) continue;
+    const isError = entry.dropCause !== null && entry.dropCause !== "";
+    upsertBucket(buckets2, entry.peerServiceId, isError, entry.timestamp, () => ({
+      targetKind: PEER_SERVICE_TARGET_KIND,
+      targetName: entry.peerServiceId
+    }));
+  }
+  return [...buckets2.values()].map((b) => ({
+    targetKind: b.targetKind,
+    targetName: b.targetName,
+    callCount: b.callCount,
+    errorCount: b.errorCount,
+    lastObservedIso: b.lastObservedIso
+  }));
+}
+function createRailwayResolveTarget(config) {
+  return (signal) => {
+    const serviceName = config.serviceNameById[config.serviceId];
+    if (!serviceName) return null;
+    if (signal.targetKind === ROUTE_TARGET_KIND) {
+      return { targetNodeId: signal.targetName, serviceName, edgeType: import_types35.EdgeType.CALLS };
+    }
+    if (signal.targetKind === PEER_SERVICE_TARGET_KIND) {
+      const peerName = config.serviceNameById[signal.targetName];
+      if (!peerName) return null;
+      return { targetNodeId: (0, import_types35.serviceId)(peerName), serviceName, edgeType: import_types35.EdgeType.CONNECTS_TO };
+    }
+    return null;
+  };
+}
+function createRailwayConnector(graph, config) {
+  return {
+    provider: "railway",
+    async poll(ctx) {
+      const token = readRailwayToken(ctx.credentials);
+      const now = /* @__PURE__ */ new Date();
+      const maxLookbackMs = config.maxLookbackMs ?? DEFAULT_MAX_LOOKBACK_MS2;
+      const startDate = boundedRailwayStartDate(ctx.since, now, maxLookbackMs);
+      const endDate = now.toISOString();
+      const [httpLogs, flowLogs] = await Promise.all([
+        fetchRailwayHttpLogs(config, token, startDate, endDate),
+        fetchRailwayNetworkFlowLogs(config, token, startDate, endDate)
+      ]);
+      const serviceName = config.serviceNameById[config.serviceId];
+      const routeIndex = serviceName ? buildRailwayRouteIndex(graph, serviceName) : [];
+      return [
+        ...mapRailwayHttpLogsToSignals(httpLogs, routeIndex),
+        ...mapRailwayNetworkFlowLogsToSignals(flowLogs)
+      ];
+    }
+  };
+}
+
+// src/connectors/firebase/index.ts
+init_cjs_shims();
+
+// src/connectors/firebase/logging-api.ts
+init_cjs_shims();
+function readFirebaseCredentials(raw) {
+  const projectId = raw["projectId"];
+  const accessToken = raw["accessToken"];
+  if (typeof projectId !== "string" || projectId.length === 0) {
+    throw new Error("firebase connector: credentials.projectId must be a non-empty string");
+  }
+  if (typeof accessToken !== "string" || accessToken.length === 0) {
+    throw new Error("firebase connector: credentials.accessToken must be a non-empty string");
+  }
+  return { projectId, accessToken };
+}
+var RESOURCE_TYPES = [
+  "cloud_function",
+  "cloud_run_revision",
+  "firebase_domain"
+];
+function isFirebaseResourceType(value) {
+  return RESOURCE_TYPES.includes(value);
+}
+function buildEntriesFilter(sinceIso) {
+  return [
+    'resource.type = ("cloud_function" OR "cloud_run_revision" OR "firebase_domain")',
+    "httpRequest:*",
+    `timestamp >= "${sinceIso}"`
+  ].join(" AND ");
+}
+var DEFAULT_LOOKBACK_MS = 24 * 60 * 60 * 1e3;
+var ENTRIES_LIST_URL = "https://logging.googleapis.com/v2/entries:list";
+var PAGE_SIZE = 1e3;
+var MAX_PAGES = 20;
+async function fetchHttpRequestLogEntries(creds, sinceIso) {
+  const filter = buildEntriesFilter(sinceIso);
+  const out = [];
+  let pageToken;
+  for (let page = 0; page < MAX_PAGES; page++) {
+    const body = {
+      resourceNames: [`projects/${creds.projectId}`],
+      filter,
+      orderBy: "timestamp asc",
+      pageSize: PAGE_SIZE,
+      ...pageToken ? { pageToken } : {}
+    };
+    const res = await junctionFetch(
+      ENTRIES_LIST_URL,
+      {
+        method: "POST",
+        headers: {
+          ...bearerAuthHeader(creds.accessToken),
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(body)
+      },
+      // accountKey: the GCP project id (ADR-131's own worked example for
+      // Firebase) — one customer's Cloud Logging quota is scoped per GCP
+      // project, not per Firebase site/function.
+      { provider: "firebase", accountKey: creds.projectId }
+    );
+    if (!res.ok) {
+      throw new Error(`Cloud Logging entries.list failed: ${res.status} ${res.statusText}`);
+    }
+    const json = await res.json();
+    out.push(...json.entries ?? []);
+    if (!json.nextPageToken) break;
+    pageToken = json.nextPageToken;
+  }
+  return out;
+}
+
+// src/connectors/firebase/map.ts
+init_cjs_shims();
+var FIELD_SEP = "\0";
+function packFirebaseTargetName(identity) {
+  return [identity.resourceName, identity.method, identity.path].join(FIELD_SEP);
+}
+function parseFirebaseTargetName(targetName) {
+  const firstSep = targetName.indexOf(FIELD_SEP);
+  if (firstSep === -1) return null;
+  const resourceName = targetName.slice(0, firstSep);
+  const rest = targetName.slice(firstSep + 1);
+  const secondSep = rest.indexOf(FIELD_SEP);
+  if (secondSep === -1) return null;
+  const method = rest.slice(0, secondSep);
+  const path47 = rest.slice(secondSep + 1);
+  if (!resourceName || !method || !path47) return null;
+  return { resourceName, method, path: path47 };
+}
+function resourceNameFor(type, labels) {
+  if (!labels) return null;
+  switch (type) {
+    case "cloud_function":
+      return labels["function_name"] ?? null;
+    case "cloud_run_revision":
+      return labels["service_name"] ?? null;
+    case "firebase_domain":
+      return labels["site_name"] ?? null;
+  }
+}
+function pathFromRequestUrl(requestUrl) {
+  if (!requestUrl) return null;
+  if (requestUrl.startsWith("/")) {
+    const withoutQuery = requestUrl.split("?")[0];
+    return withoutQuery && withoutQuery.length > 0 ? withoutQuery : "/";
+  }
+  try {
+    const candidate = requestUrl.startsWith("//") ? `https:${requestUrl}` : requestUrl;
+    const parsed = new URL(candidate);
+    return parsed.pathname || "/";
+  } catch {
+    return null;
+  }
+}
+var ERROR_STATUS_THRESHOLD2 = 500;
+function mapLogEntryToSignal(entry) {
+  const resourceType = entry.resource?.type;
+  if (!resourceType || !isFirebaseResourceType(resourceType)) return null;
+  const resourceName = resourceNameFor(resourceType, entry.resource?.labels);
+  if (!resourceName) return null;
+  const req = entry.httpRequest;
+  if (!req) return null;
+  if (!req.requestMethod) return null;
+  const method = req.requestMethod.toUpperCase();
+  const path47 = pathFromRequestUrl(req.requestUrl);
+  if (path47 === null) return null;
+  const timestamp = entry.timestamp;
+  if (!timestamp) return null;
+  const isError = typeof req.status === "number" && req.status >= ERROR_STATUS_THRESHOLD2;
+  return {
+    targetKind: resourceType,
+    targetName: packFirebaseTargetName({ resourceName, method, path: path47 }),
+    callCount: 1,
+    errorCount: isError ? 1 : 0,
+    lastObservedIso: timestamp
+  };
+}
+function mapLogEntriesToSignals(entries) {
+  const out = [];
+  for (const entry of entries) {
+    const signal = mapLogEntryToSignal(entry);
+    if (signal) out.push(signal);
+  }
+  return out;
+}
+
+// src/connectors/firebase/resolve.ts
+init_cjs_shims();
+var import_types36 = require("@neat.is/types");
+function neatServiceNameFor(resourceType, resourceName, serviceMap) {
+  switch (resourceType) {
+    case "cloud_function":
+      return serviceMap.functions?.[resourceName] ?? null;
+    case "cloud_run_revision":
+      return serviceMap.cloudRun?.[resourceName] ?? null;
+    case "firebase_domain":
+      return serviceMap.hosting?.[resourceName] ?? null;
+  }
+}
+function routeEntriesFor(graph, serviceName) {
+  const entries = [];
+  graph.forEachNode((_id, attrs) => {
+    const node = attrs;
+    if (node.type !== import_types36.NodeType.RouteNode) return;
+    const route = attrs;
+    if (route.service !== serviceName) return;
+    entries.push({
+      method: route.method.toUpperCase(),
+      normalizedPath: normalizePathTemplate(route.pathTemplate),
+      routeNodeId: route.id
+    });
+  });
+  return entries;
+}
+function findRoute2(entries, method, normalizedPath) {
+  return entries.find(
+    (e) => e.normalizedPath === normalizedPath && (e.method === "ALL" || e.method === method)
+  );
+}
+function createFirebaseResolveTarget(graph, serviceMap) {
+  return (signal, _ctx) => {
+    const resourceType = signal.targetKind;
+    if (resourceType !== "cloud_function" && resourceType !== "cloud_run_revision" && resourceType !== "firebase_domain") {
+      return null;
+    }
+    const identity = parseFirebaseTargetName(signal.targetName);
+    if (!identity) return null;
+    const serviceName = neatServiceNameFor(resourceType, identity.resourceName, serviceMap);
+    if (!serviceName) return null;
+    const normalizedPath = normalizePathTemplate(identity.path);
+    const match = findRoute2(routeEntriesFor(graph, serviceName), identity.method, normalizedPath);
+    if (!match) return null;
+    return {
+      targetNodeId: match.routeNodeId,
+      serviceName,
+      edgeType: import_types36.EdgeType.CALLS
+    };
+  };
+}
+
+// src/connectors/firebase/index.ts
+var FirebaseConnector = class {
+  provider = "firebase";
+  async poll(ctx) {
+    const creds = readFirebaseCredentials(ctx.credentials);
+    const sinceIso = ctx.since ?? new Date(Date.now() - DEFAULT_LOOKBACK_MS).toISOString();
+    const entries = await fetchHttpRequestLogEntries(creds, sinceIso);
+    return mapLogEntriesToSignals(entries);
+  }
+};
+function createFirebaseConnector(graph, serviceMap) {
+  return {
+    connector: new FirebaseConnector(),
+    resolveTarget: createFirebaseResolveTarget(graph, serviceMap)
+  };
+}
+
+// src/connectors/cloudflare/index.ts
+init_cjs_shims();
+
+// src/connectors/cloudflare/connector.ts
+init_cjs_shims();
+var import_types38 = require("@neat.is/types");
+
+// src/connectors/cloudflare/client.ts
+init_cjs_shims();
+var import_node_crypto3 = require("crypto");
+var DEFAULT_BASE_URL = "https://api.cloudflare.com/client/v4";
+var DEFAULT_EVENT_LIMIT = 1e3;
+async function queryWorkerInvocations(ctx, config, window, fetchImpl = fetch) {
+  const token = ctx.credentials.apiToken;
+  if (typeof token !== "string" || token.length === 0) {
+    throw new Error("cloudflare connector: ctx.credentials.apiToken must be a non-empty string");
+  }
+  const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+  const url = `${baseUrl}/accounts/${config.accountId}/workers/observability/telemetry/query`;
+  const body = {
+    // Cloudflare's schema requires an identifier per query even for an
+    // ad-hoc, unsaved one — a fresh id per tick, never reused.
+    queryId: `neat-connector-${(0, import_node_crypto3.randomUUID)()}`,
+    timeframe: { from: window.fromMs, to: window.toMs },
+    view: "events",
+    limit: config.eventLimit ?? DEFAULT_EVENT_LIMIT,
+    // Execute without persisting — this is a read, not a saved query
+    // (connectors.md §2's "never writes on the read path" applies to
+    // Cloudflare's own query-history state too).
+    dry: true
+  };
+  const res = await junctionFetch(
+    url,
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...bearerAuthHeader(token)
+      },
+      body: JSON.stringify(body)
+    },
+    // accountKey: the Cloudflare account id (ADR-131's own worked example) —
+    // the Telemetry Query API's ~300/5min limit is enforced per account.
+    { provider: "cloudflare", accountKey: config.accountId, fetchImpl }
+  );
+  if (!res.ok) {
+    throw new Error(
+      `cloudflare connector: telemetry query failed (${res.status} ${res.statusText})`
+    );
+  }
+  const payload = await res.json();
+  if (!payload.success) {
+    const message = payload.errors?.map((e) => e.message).join("; ") || "unknown error";
+    throw new Error(`cloudflare connector: telemetry query returned an error (${message})`);
+  }
+  return payload.result?.events?.events ?? [];
+}
+
+// src/connectors/cloudflare/map.ts
+init_cjs_shims();
+
+// src/connectors/cloudflare/types.ts
+init_cjs_shims();
+var CLOUDFLARE_TARGET_KIND = "cloudflare-worker-invocation";
+
+// src/connectors/cloudflare/map.ts
+var HTTP_METHODS = /* @__PURE__ */ new Set([
+  "GET",
+  "POST",
+  "PUT",
+  "PATCH",
+  "DELETE",
+  "HEAD",
+  "OPTIONS",
+  "TRACE",
+  "CONNECT"
+]);
+var LEADING_TOKEN_RE = /^(\S+)\s+\S/;
+function parseHttpMethodFromTrigger(trigger) {
+  if (!trigger) return null;
+  const match = LEADING_TOKEN_RE.exec(trigger.trim());
+  const token = match?.[1];
+  if (!token) return null;
+  const method = token.toUpperCase();
+  return HTTP_METHODS.has(method) ? method : null;
+}
+var ERROR_STATUS_THRESHOLD3 = 500;
+function mapEventToSignal(event) {
+  const metadata = event.$metadata;
+  const workers = event.$workers;
+  const method = parseHttpMethodFromTrigger(metadata?.trigger);
+  if (!method) return null;
+  const scriptName = workers?.scriptName ?? metadata?.service;
+  if (!scriptName) return null;
+  const timestampMs = event.timestamp ?? metadata?.startTime;
+  if (typeof timestampMs !== "number" || !Number.isFinite(timestampMs)) return null;
+  const statusCode = metadata?.statusCode;
+  const isError = typeof statusCode === "number" && statusCode >= ERROR_STATUS_THRESHOLD3;
+  return {
+    targetKind: CLOUDFLARE_TARGET_KIND,
+    targetName: scriptName,
+    callCount: 1,
+    errorCount: isError ? 1 : 0,
+    lastObservedIso: new Date(timestampMs).toISOString(),
+    method,
+    ...typeof statusCode === "number" ? { statusCode } : {},
+    ...typeof metadata?.duration === "number" ? { duration: metadata.duration } : {}
+  };
+}
+
+// src/connectors/cloudflare/connector.ts
+var DEFAULT_MAX_LOOKBACK_MS3 = 60 * 60 * 1e3;
+function resolveFromMs(since, maxLookbackMs) {
+  const cap = maxLookbackMs ?? DEFAULT_MAX_LOOKBACK_MS3;
+  const now = Date.now();
+  const floor = now - cap;
+  if (!since) return floor;
+  const parsed = Date.parse(since);
+  if (Number.isNaN(parsed)) return floor;
+  return Math.max(parsed, floor);
+}
+var CloudflareConnector = class {
+  constructor(config) {
+    this.config = config;
+  }
+  config;
+  provider = "cloudflare";
+  async poll(ctx) {
+    const toMs = Date.now();
+    const fromMs = resolveFromMs(ctx.since, this.config.maxLookbackMs);
+    const events = await queryWorkerInvocations(ctx, this.config, { fromMs, toMs });
+    const signals = [];
+    for (const event of events) {
+      const signal = mapEventToSignal(event);
+      if (signal) signals.push(signal);
+    }
+    return signals;
+  }
+};
+function createCloudflareResolveTarget(config) {
+  return (signal) => {
+    if (signal.targetKind !== CLOUDFLARE_TARGET_KIND) return null;
+    const mapping = config.workers[signal.targetName];
+    if (!mapping) return null;
+    return {
+      targetNodeId: (0, import_types38.fileId)(mapping.service, mapping.entryFile),
+      serviceName: mapping.service,
+      edgeType: import_types38.EdgeType.CALLS
+    };
+  };
+}
+
+// src/connectors-config.ts
+init_cjs_shims();
+var import_node_os4 = __toESM(require("os"), 1);
+var import_node_path44 = __toESM(require("path"), 1);
+var import_node_fs25 = require("fs");
+var CONNECTORS_CONFIG_VERSION = 1;
+var EnvRefUnsetError = class extends Error {
+  ref;
+  varName;
+  constructor(ref, varName) {
+    super(`${ref} is unset`);
+    this.name = "EnvRefUnsetError";
+    this.ref = ref;
+    this.varName = varName;
+  }
+};
+function neatHome2() {
+  const override = process.env.NEAT_HOME;
+  if (override && override.length > 0) return import_node_path44.default.resolve(override);
+  return import_node_path44.default.join(import_node_os4.default.homedir(), ".neat");
+}
+function connectorsConfigPath(home = neatHome2()) {
+  return import_node_path44.default.join(home, "connectors.json");
+}
+var MODE_MASK_LOOSER_THAN_0600 = 63;
+async function warnIfModeLooserThan0600(file) {
+  if (process.platform === "win32") return;
+  try {
+    const stat = await import_node_fs25.promises.stat(file);
+    if ((stat.mode & MODE_MASK_LOOSER_THAN_0600) !== 0) {
+      const mode = (stat.mode & 511).toString(8).padStart(3, "0");
+      console.warn(
+        `[neat] ${file} is mode 0${mode}, looser than the 0600 this file's secrets call for \u2014 run \`chmod 600 ${file}\``
+      );
+    }
+  } catch {
+  }
+}
+async function readConnectorsConfig(home = neatHome2()) {
+  const file = connectorsConfigPath(home);
+  let raw;
+  try {
+    raw = await import_node_fs25.promises.readFile(file, "utf8");
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      return { version: CONNECTORS_CONFIG_VERSION, connectors: [] };
+    }
+    throw err;
+  }
+  await warnIfModeLooserThan0600(file);
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`${file} is not valid JSON: ${err.message}`);
+  }
+  return validateConfig(parsed, file);
+}
+function validateConfig(parsed, file) {
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error(`${file} must be a JSON object with a "connectors" array`);
+  }
+  const obj = parsed;
+  const version = obj.version === void 0 ? CONNECTORS_CONFIG_VERSION : obj.version;
+  if (typeof version !== "number" || !Number.isInteger(version)) {
+    throw new Error(`${file}: "version" must be an integer`);
+  }
+  const rawConnectors = obj.connectors;
+  if (!Array.isArray(rawConnectors)) {
+    throw new Error(`${file}: "connectors" must be an array`);
+  }
+  const connectors = rawConnectors.map((entry, i) => validateEntry(entry, i, file));
+  return { version, connectors };
+}
+function validateEntry(entry, index, file) {
+  const where = `${file}: connectors[${index}]`;
+  if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+    throw new Error(`${where} must be an object`);
+  }
+  const e = entry;
+  const id = e.id;
+  if (typeof id !== "string" || id.length === 0) {
+    throw new Error(`${where}.id must be a non-empty string`);
+  }
+  const provider = e.provider;
+  if (typeof provider !== "string" || provider.length === 0) {
+    throw new Error(`${where}.provider must be a non-empty string`);
+  }
+  if (e.project !== void 0 && typeof e.project !== "string") {
+    throw new Error(`${where}.project must be a string when present`);
+  }
+  const credential = validateCredentialRef(e.credential, `${where}.credential`);
+  let options;
+  if (e.options !== void 0) {
+    if (typeof e.options !== "object" || e.options === null || Array.isArray(e.options)) {
+      throw new Error(`${where}.options must be an object when present`);
+    }
+    options = e.options;
+  }
+  return {
+    id,
+    provider,
+    ...typeof e.project === "string" ? { project: e.project } : {},
+    credential,
+    ...options ? { options } : {}
+  };
+}
+function validateCredentialRef(raw, where) {
+  if (typeof raw === "string") {
+    if (raw.length === 0) throw new Error(`${where} must be a non-empty string`);
+    return raw;
+  }
+  if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) {
+    const fields = raw;
+    const keys = Object.keys(fields);
+    if (keys.length === 0) throw new Error(`${where} object must have at least one field`);
+    for (const key of keys) {
+      const v = fields[key];
+      if (typeof v !== "string" || v.length === 0) {
+        throw new Error(`${where}.${key} must be a non-empty string`);
+      }
+    }
+    return fields;
+  }
+  throw new Error(`${where} must be a string or an object of strings`);
+}
+function resolveCredential(ref, env = process.env) {
+  if (typeof ref === "string") {
+    return { kind: "single", value: resolveRef(ref, env) };
+  }
+  const fields = {};
+  for (const [key, value] of Object.entries(ref)) {
+    fields[key] = resolveRef(value, env);
+  }
+  return { kind: "fields", fields };
+}
+function resolveRef(value, env) {
+  if (value.length > 1 && value.startsWith("$")) {
+    const varName = value.slice(1);
+    const resolved = env[varName];
+    if (resolved === void 0 || resolved.length === 0) {
+      throw new EnvRefUnsetError(value, varName);
+    }
+    return resolved;
+  }
+  return value;
+}
+function connectorMatchesProject(entry, project) {
+  return entry.project === void 0 || entry.project === project;
+}
+
+// src/connectors/registry.ts
+var CLOUDFLARE_API_BASE_URL = "https://api.cloudflare.com/client/v4";
+async function authProbe(input) {
+  const { provider, accountKey, url, token, init, fetchImpl } = input;
+  try {
+    const res = await junctionFetch(
+      url,
+      {
+        ...init ?? {},
+        headers: { ...bearerAuthHeader(token), ...init?.headers ?? {} }
+      },
+      { provider, accountKey, ...fetchImpl ? { fetchImpl } : {} }
+    );
+    if (res.ok) return { ok: true };
+    if (res.status === 401 || res.status === 403) {
+      return { ok: false, reason: `${provider} rejected the credential (HTTP ${res.status})` };
+    }
+    return {
+      ok: false,
+      reason: `${provider} auth check returned HTTP ${res.status} ${res.statusText} \u2014 could not confirm the credential`
+    };
+  } catch (err) {
+    return {
+      ok: false,
+      reason: `${provider} auth check could not reach the provider: ${err.message}`
+    };
+  }
+}
+var PROVIDER_DISPATCH = {
+  supabase: {
+    provider: "supabase",
+    primaryCredentialKey: "managementToken",
+    requiredCredentialFields: ["managementToken"],
+    requiredOptionFields: ["apiProjectRef", "nodeRef", "serviceName"],
+    build(graph, options) {
+      return createSupabaseConnector(graph, options);
+    },
+    // GET /v1/projects — the Management API's own auth-gated list endpoint, the
+    // cheapest confirmation the management token is live (the same surface
+    // client.ts polls, minus the heavy log query).
+    validate({ credentials, options, fetchImpl }) {
+      const cfg = options;
+      const baseUrl = cfg.managementApiUrl ?? DEFAULT_SUPABASE_MANAGEMENT_API_URL;
+      return authProbe({
+        provider: "supabase",
+        accountKey: cfg.apiProjectRef ?? "validate",
+        url: `${baseUrl}/v1/projects`,
+        token: String(credentials.managementToken ?? ""),
+        ...fetchImpl ? { fetchImpl } : {}
+      });
+    }
+  },
+  railway: {
+    provider: "railway",
+    primaryCredentialKey: "token",
+    requiredCredentialFields: ["token"],
+    requiredOptionFields: ["environmentId", "serviceId", "serviceNameById"],
+    build(graph, options) {
+      const config = options;
+      return {
+        connector: createRailwayConnector(graph, config),
+        resolveTarget: createRailwayResolveTarget(config)
+      };
+    },
+    // A minimal GraphQL POST — Railway's gateway 401s an unauthenticated call
+    // at the HTTP layer, so a 2xx confirms the token was accepted regardless of
+    // the query's own shape (the connector's real queries are still
+    // needs-endpoint-testing per railway/types.ts — auth is what we check).
+    validate({ credentials, options, fetchImpl }) {
+      const cfg = options;
+      return authProbe({
+        provider: "railway",
+        accountKey: cfg.environmentId ?? "validate",
+        url: cfg.apiUrl ?? DEFAULT_RAILWAY_API_URL,
+        token: String(credentials.token ?? ""),
+        init: {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ query: "{ __typename }" })
+        },
+        ...fetchImpl ? { fetchImpl } : {}
+      });
+    }
+  },
+  firebase: {
+    provider: "firebase",
+    // Firebase reads both projectId and accessToken from the credential; the
+    // single-string form maps to the secret, and the required-fields check
+    // below catches a projectId that was never supplied.
+    primaryCredentialKey: "accessToken",
+    requiredCredentialFields: ["projectId", "accessToken"],
+    requiredOptionFields: [],
+    build(graph, options) {
+      return createFirebaseConnector(graph, options);
+    },
+    // GET the project's Cloud Logging log-name list (pageSize 1) — within the
+    // same `roles/logging.viewer` grant the connector polls under, and the
+    // lightest call that still fails 401/403 on a bad or wrong-scoped token.
+    validate({ credentials, fetchImpl }) {
+      const projectId = String(credentials.projectId ?? "");
+      return authProbe({
+        provider: "firebase",
+        accountKey: projectId || "validate",
+        url: `https://logging.googleapis.com/v2/projects/${projectId}/logs?pageSize=1`,
+        token: String(credentials.accessToken ?? ""),
+        ...fetchImpl ? { fetchImpl } : {}
+      });
+    }
+  },
+  cloudflare: {
+    provider: "cloudflare",
+    primaryCredentialKey: "apiToken",
+    requiredCredentialFields: ["apiToken"],
+    requiredOptionFields: ["accountId", "workers"],
+    build(_graph, options) {
+      const config = options;
+      return {
+        connector: new CloudflareConnector(config),
+        resolveTarget: createCloudflareResolveTarget(config)
+      };
+    },
+    // GET /user/tokens/verify — Cloudflare's own purpose-built "is this API
+    // token live" endpoint. 200 on a valid token, 401 on an invalid one.
+    validate({ credentials, options, fetchImpl }) {
+      const cfg = options;
+      const baseUrl = cfg.baseUrl ?? CLOUDFLARE_API_BASE_URL;
+      return authProbe({
+        provider: "cloudflare",
+        accountKey: cfg.accountId ?? "validate",
+        url: `${baseUrl}/user/tokens/verify`,
+        token: String(credentials.apiToken ?? ""),
+        ...fetchImpl ? { fetchImpl } : {}
+      });
+    }
+  }
+};
+function resolveEntryCredentials(dispatch, entry, env) {
+  let credentials;
+  try {
+    const resolved = resolveCredential(entry.credential, env);
+    credentials = resolved.kind === "single" ? { [dispatch.primaryCredentialKey]: resolved.value } : { ...resolved.fields };
+  } catch (err) {
+    if (err instanceof EnvRefUnsetError) return { ok: false, kind: "unset-env", reason: err.message };
+    return { ok: false, kind: "error", reason: err.message };
+  }
+  const missingCreds = dispatch.requiredCredentialFields.filter((k) => !credentials[k]);
+  if (missingCreds.length > 0) {
+    return {
+      ok: false,
+      kind: "missing-field",
+      reason: `credential missing required field(s): ${missingCreds.join(", ")}`
+    };
+  }
+  return { ok: true, credentials };
+}
+function buildRegistration(entry, graph, env = process.env) {
+  const dispatch = PROVIDER_DISPATCH[entry.provider];
+  if (!dispatch) {
+    return { ok: false, reason: `unknown provider "${entry.provider}"` };
+  }
+  const creds = resolveEntryCredentials(dispatch, entry, env);
+  if (!creds.ok) return { ok: false, reason: creds.reason };
+  const credentials = creds.credentials;
+  const options = entry.options ?? {};
+  const missingOpts = dispatch.requiredOptionFields.filter((k) => !(k in options));
+  if (missingOpts.length > 0) {
+    return {
+      ok: false,
+      reason: `options missing required field(s): ${missingOpts.join(", ")}`
+    };
+  }
+  let built;
+  try {
+    built = dispatch.build(graph, options);
+  } catch (err) {
+    return { ok: false, reason: err.message };
+  }
+  const intervalMs = typeof options.intervalMs === "number" ? options.intervalMs : void 0;
+  return {
+    ok: true,
+    registration: {
+      connector: built.connector,
+      credentials,
+      resolveTarget: built.resolveTarget,
+      ...intervalMs !== void 0 ? { intervalMs } : {}
+    }
+  };
+}
+async function loadConnectorRegistrations(input) {
+  const { project, graph, home, env = process.env, onSkip } = input;
+  let connectors;
+  try {
+    connectors = (await readConnectorsConfig(home)).connectors;
+  } catch (err) {
+    onSkip?.(
+      { id: "(file)", provider: "(all)", credential: "" },
+      `connectors.json unreadable \u2014 ${err.message}`
+    );
+    return [];
+  }
+  const registrations = [];
+  for (const entry of connectors) {
+    if (!connectorMatchesProject(entry, project)) continue;
+    const result = buildRegistration(entry, graph, env);
+    if (result.ok) registrations.push(result.registration);
+    else onSkip?.(entry, result.reason);
+  }
+  return registrations;
+}
+
 // src/daemon.ts
 init_auth();
 
 // src/unrouted.ts
 init_cjs_shims();
-var import_node_fs25 = require("fs");
-var import_node_path44 = __toESM(require("path"), 1);
+var import_node_fs26 = require("fs");
+var import_node_path45 = __toESM(require("path"), 1);
 function buildUnroutedSpanRecord(serviceName, traceId, now = /* @__PURE__ */ new Date()) {
   return {
     timestamp: now.toISOString(),
@@ -8860,35 +10495,35 @@ function buildUnroutedSpanRecord(serviceName, traceId, now = /* @__PURE__ */ new
     traceId: traceId ?? null
   };
 }
-async function appendUnroutedSpan(neatHome2, record) {
-  const target = import_node_path44.default.join(neatHome2, "errors.ndjson");
-  await import_node_fs25.promises.mkdir(neatHome2, { recursive: true });
-  await import_node_fs25.promises.appendFile(target, JSON.stringify(record) + "\n", "utf8");
+async function appendUnroutedSpan(neatHome3, record) {
+  const target = import_node_path45.default.join(neatHome3, "errors.ndjson");
+  await import_node_fs26.promises.mkdir(neatHome3, { recursive: true });
+  await import_node_fs26.promises.appendFile(target, JSON.stringify(record) + "\n", "utf8");
 }
-function unroutedErrorsPath(neatHome2) {
-  return import_node_path44.default.join(neatHome2, "errors.ndjson");
+function unroutedErrorsPath(neatHome3) {
+  return import_node_path45.default.join(neatHome3, "errors.ndjson");
 }
 
 // src/daemon.ts
-var import_types30 = require("@neat.is/types");
+var import_types41 = require("@neat.is/types");
 function daemonJsonPath(scanPath) {
-  return import_node_path45.default.join(scanPath, "neat-out", "daemon.json");
+  return import_node_path46.default.join(scanPath, "neat-out", "daemon.json");
 }
 function daemonsDiscoveryDir(home) {
   const base = home && home.length > 0 ? home : neatHomeFromEnv();
-  return import_node_path45.default.join(base, "daemons");
+  return import_node_path46.default.join(base, "daemons");
 }
 function daemonDiscoveryPath(project, home) {
-  return import_node_path45.default.join(daemonsDiscoveryDir(home), `${sanitizeDiscoveryName(project)}.json`);
+  return import_node_path46.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_path45.default.resolve(env);
+  if (env && env.length > 0) return import_node_path46.default.resolve(env);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path45.default.join(home, ".neat");
+  return import_node_path46.default.join(home, ".neat");
 }
 function resolveNeatVersion() {
   if (process.env.NEAT_LOCAL_VERSION && process.env.NEAT_LOCAL_VERSION.length > 0) {
@@ -8920,7 +10555,7 @@ async function clearDaemonRecord(record, home) {
   } catch {
   }
   try {
-    await import_node_fs26.promises.unlink(daemonDiscoveryPath(record.project, home));
+    await import_node_fs27.promises.unlink(daemonDiscoveryPath(record.project, home));
   } catch {
   }
 }
@@ -8943,11 +10578,11 @@ function teardownSlot(slot) {
   }
 }
 function neatHomeFor(opts) {
-  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path45.default.resolve(opts.neatHome);
+  if (opts.neatHome && opts.neatHome.length > 0) return import_node_path46.default.resolve(opts.neatHome);
   const env = process.env.NEAT_HOME;
-  if (env && env.length > 0) return import_node_path45.default.resolve(env);
+  if (env && env.length > 0) return import_node_path46.default.resolve(env);
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  return import_node_path45.default.join(home, ".neat");
+  return import_node_path46.default.join(home, ".neat");
 }
 function routeSpanToProject(serviceName, projects) {
   if (!serviceName) return DEFAULT_PROJECT;
@@ -8991,13 +10626,13 @@ function spanBelongsToSingleProject(graph, project, serviceName) {
   if (!serviceName) return true;
   if (serviceNameMatchesProject(serviceName, project)) return true;
   return graph.someNode(
-    (_id, attrs) => attrs.type === import_types30.NodeType.ServiceNode && attrs.name === serviceName
+    (_id, attrs) => attrs.type === import_types41.NodeType.ServiceNode && attrs.name === serviceName
   );
 }
-async function bootstrapProject(entry, connectors = []) {
-  const paths = pathsForProject(entry.name, import_node_path45.default.join(entry.path, "neat-out"));
+async function bootstrapProject(entry, connectors = [], neatHome3) {
+  const paths = pathsForProject(entry.name, import_node_path46.default.join(entry.path, "neat-out"));
   try {
-    const stat = await import_node_fs26.promises.stat(entry.path);
+    const stat = await import_node_fs27.promises.stat(entry.path);
     if (!stat.isDirectory()) {
       throw new Error(`registered path ${entry.path} is not a directory`);
     }
@@ -9035,7 +10670,16 @@ async function bootstrapProject(entry, connectors = []) {
       staleEventsPath: paths.staleEventsPath,
       project: entry.name
     });
-    const stopFns = connectors.map(
+    const fileConnectors = neatHome3 ? await loadConnectorRegistrations({
+      project: entry.name,
+      graph,
+      home: neatHome3,
+      onSkip: (skipped, reason) => console.warn(
+        `neatd: connector "${skipped.id}" (${skipped.provider}) skipped for project "${entry.name}" \u2014 ${reason}`
+      )
+    }) : [];
+    const allConnectors = [...connectors, ...fileConnectors];
+    const stopFns = allConnectors.map(
       (registration) => startConnectorPollLoop(
         registration.connector,
         { projectDir: entry.path, credentials: registration.credentials },
@@ -9113,7 +10757,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_path45.default.resolve(projectPathArg) : null;
+  const singleProjectPath = singleProject && projectPathArg ? import_node_path46.default.resolve(projectPathArg) : null;
   if (singleProject && !singleProjectPath) {
     throw new Error(
       `neatd: project "${singleProject}" given without a projectPath; pass NEAT_PROJECT_PATH alongside NEAT_PROJECT.`
@@ -9121,14 +10765,14 @@ async function startDaemon(opts = {}) {
   }
   if (!singleProject) {
     try {
-      await import_node_fs26.promises.access(regPath);
+      await import_node_fs27.promises.access(regPath);
     } catch {
       throw new Error(
         `neatd: registry not found at ${regPath}. Run \`neat init <path>\` to register a project before starting the daemon.`
       );
     }
   }
-  const pidPath = import_node_path45.default.join(home, "neatd.pid");
+  const pidPath = import_node_path46.default.join(home, "neatd.pid");
   await writeAtomically(pidPath, `${process.pid}
 `);
   const slots = /* @__PURE__ */ new Map();
@@ -9172,7 +10816,7 @@ async function startDaemon(opts = {}) {
   }
   async function tryRecoverSlot(entry) {
     try {
-      const fresh = await bootstrapProject(entry, opts.connectors ?? []);
+      const fresh = await bootstrapProject(entry, opts.connectors ?? [], home);
       const prior = slots.get(entry.name);
       if (prior) teardownSlot(prior);
       slots.set(entry.name, fresh);
@@ -9196,7 +10840,7 @@ async function startDaemon(opts = {}) {
     bootstrapStatus.set(entry.name, "bootstrapping");
     bootstrapStartedAt.set(entry.name, Date.now());
     try {
-      const slot = await bootstrapProject(entry, opts.connectors ?? []);
+      const slot = await bootstrapProject(entry, opts.connectors ?? [], home);
       const prior = slots.get(entry.name);
       if (prior) teardownSlot(prior);
       slots.set(entry.name, slot);
@@ -9322,7 +10966,7 @@ async function startDaemon(opts = {}) {
       }
       if (restApp) await restApp.close().catch(() => {
       });
-      await import_node_fs26.promises.unlink(pidPath).catch(() => {
+      await import_node_fs27.promises.unlink(pidPath).catch(() => {
       });
       throw new Error(
         `neatd: failed to bind REST on port ${restPort} \u2014 ${err.message}`
@@ -9448,7 +11092,7 @@ async function startDaemon(opts = {}) {
       });
       if (otlpApp) await otlpApp.close().catch(() => {
       });
-      await import_node_fs26.promises.unlink(pidPath).catch(() => {
+      await import_node_fs27.promises.unlink(pidPath).catch(() => {
       });
       throw new Error(
         `neatd: failed to bind OTLP on port ${otlpPort} \u2014 ${err.message}`
@@ -9483,7 +11127,7 @@ async function startDaemon(opts = {}) {
         });
         if (otlpApp) await otlpApp.close().catch(() => {
         });
-        await import_node_fs26.promises.unlink(pidPath).catch(() => {
+        await import_node_fs27.promises.unlink(pidPath).catch(() => {
         });
         throw new Error(
           `neatd: failed to write daemon.json for "${singleProject}" \u2014 ${err.message}`
@@ -9530,9 +11174,9 @@ async function startDaemon(opts = {}) {
   let registryWatcher = null;
   let reloadTimer = null;
   if (!singleProject) try {
-    const regDir = import_node_path45.default.dirname(regPath);
-    const regBase = import_node_path45.default.basename(regPath);
-    registryWatcher = (0, import_node_fs26.watch)(regDir, (_eventType, filename) => {
+    const regDir = import_node_path46.default.dirname(regPath);
+    const regBase = import_node_path46.default.basename(regPath);
+    registryWatcher = (0, import_node_fs27.watch)(regDir, (_eventType, filename) => {
       if (filename !== null && filename !== regBase) return;
       if (reloadTimer) clearTimeout(reloadTimer);
       reloadTimer = setTimeout(() => {
@@ -9581,7 +11225,7 @@ async function startDaemon(opts = {}) {
     if (daemonRecord) {
       await clearDaemonRecord(daemonRecord, home);
     }
-    await import_node_fs26.promises.unlink(pidPath).catch(() => {
+    await import_node_fs27.promises.unlink(pidPath).catch(() => {
     });
   };
   return {