@neat.is/types 0.6.4 → 0.7.1

package/dist/index.js

@@ -22,7 +22,16 @@ var EdgeType = {
   // Static module dependency between two FileNodes within a service (ADR-092,
   // file-awareness.md §10). Compile-time, not runtime — represents one file
   // importing another. Distinct from CALLS which records runtime invocations.
-  IMPORTS: "IMPORTS"
+  IMPORTS: "IMPORTS",
+  // Static heritage between two SymbolNodes (ADR-158 §3). `INHERITS` records a
+  // class's `extends` clause (`class ──INHERITS──▶ superclass`); `IMPLEMENTS`
+  // records an `implements` clause (`class ──IMPLEMENTS──▶ implemented`). Both
+  // are symbol→symbol, EXTRACTED, minted only when the parent name resolves to
+  // exactly one known SymbolNode — same-file or through the import graph — never
+  // fuzzy-matched. A parent that resolves to nothing (external package,
+  // re-export chain, an interface, which is not a SymbolNode) emits no edge.
+  INHERITS: "INHERITS",
+  IMPLEMENTS: "IMPLEMENTS"
 };
 var NodeType = {
   ServiceNode: "ServiceNode",
@@ -72,7 +81,18 @@ var NodeType = {
   // edge that carries `lastObserved` and decays OBSERVED → STALE on CONNECTS_TO's
   // own staleness threshold when the channel goes quiet. See
   // docs/contracts/otel-ingest.md.
-  WebSocketChannelNode: "WebSocketChannelNode"
+  WebSocketChannelNode: "WebSocketChannelNode",
+  // A symbol under a file — a function, method, constructor, or class
+  // definition — at definition-span granularity (ADR-158). Static-first: the
+  // extractor mints one per definition and the file owns it through a
+  // `file ──CONTAINS──▶ symbol` edge, one containment level below
+  // `service ──CONTAINS──▶ file`. It carries its `{ startLine, endLine }`
+  // definition span, which is the fusion key ingest joins a span's `code.line`
+  // against to land an OBSERVED edge on the calling symbol rather than only its
+  // file (observed-first edges, one grain finer than §4 file grain). The node is
+  // language-neutral; the per-language tree-sitter extractor is the adapter. See
+  // docs/contracts/static-extraction.md and docs/contracts/file-awareness.md §1.
+  SymbolNode: "SymbolNode"
 };
 var NodeTypeSchema = z.enum([
   NodeType.ServiceNode,
@@ -84,145 +104,216 @@ var NodeTypeSchema = z.enum([
   NodeType.RouteNode,
   NodeType.GraphQLOperationNode,
   NodeType.GrpcMethodNode,
-  NodeType.WebSocketChannelNode
+  NodeType.WebSocketChannelNode,
+  NodeType.SymbolNode
 ]);
 
 // src/nodes.ts
+import { z as z3 } from "zod";
+
+// src/edges.ts
 import { z as z2 } from "zod";
-var CompatibleDriverSchema = z2.object({
-  name: z2.string(),
-  minVersion: z2.string()
+var ProvenanceSchema = z2.enum([
+  Provenance.EXTRACTED,
+  Provenance.INFERRED,
+  Provenance.OBSERVED,
+  Provenance.STALE
+]);
+var EdgeTypeSchema = z2.enum([
+  EdgeType.CALLS,
+  EdgeType.DEPENDS_ON,
+  EdgeType.CONNECTS_TO,
+  EdgeType.CONFIGURED_BY,
+  EdgeType.PUBLISHES_TO,
+  EdgeType.CONSUMES_FROM,
+  EdgeType.RUNS_ON,
+  EdgeType.CONTAINS,
+  EdgeType.IMPORTS,
+  EdgeType.INHERITS,
+  EdgeType.IMPLEMENTS
+]);
+var EdgeEvidenceSchema = z2.object({
+  file: z2.string(),
+  line: z2.number().int().nonnegative().optional(),
+  snippet: z2.string().optional(),
+  // HTTP shape of a recognised client call site (ADR-119). Present on a
+  // client↔route CALLS edge so the edge records the method + path-template the
+  // client named, alongside the file:line it named them at. Absent on every
+  // other edge — a config or infra edge has no HTTP method.
+  method: z2.string().optional(),
+  pathTemplate: z2.string().optional()
+});
+var EdgeSignalSchema = z2.object({
+  spanCount: z2.number().int().nonnegative(),
+  errorCount: z2.number().int().nonnegative(),
+  lastObservedAgeMs: z2.number().nonnegative().optional()
 });
-var DiscoveredViaSchema = z2.enum(["static", "otel", "merged"]);
-var ServiceNodeSchema = z2.object({
+var GraphEdgeSchema = z2.object({
   id: z2.string(),
-  type: z2.literal(NodeType.ServiceNode),
-  name: z2.string(),
-  language: z2.string(),
+  source: z2.string(),
+  target: z2.string(),
+  type: EdgeTypeSchema,
+  provenance: ProvenanceSchema,
+  confidence: z2.number().min(0).max(1).optional(),
+  lastObserved: z2.string().datetime().optional(),
+  callCount: z2.number().int().nonnegative().optional(),
+  evidence: EdgeEvidenceSchema.optional(),
+  signal: EdgeSignalSchema.optional(),
+  // OBSERVED grain (ADR-142): `file` when the edge originates from a source
+  // file's call site (a `file:` source + `evidence`), `service` for the coarse
+  // fallback where no call site was captured. Makes "service-grained only as a
+  // labeled fallback" (connector gate #803) a stored, machine-readable fact
+  // instead of a re-derivation from the source prefix. `.optional()` — EXTRACTED
+  // edges and legacy snapshots carry none; an OBSERVED edge is backfilled on its
+  // next observation.
+  grain: z2.enum(["file", "service"]).optional()
+});
+
+// src/nodes.ts
+var CompatibleDriverSchema = z3.object({
+  name: z3.string(),
+  minVersion: z3.string()
+});
+var DiscoveredViaSchema = z3.enum(["static", "otel", "merged"]);
+var ServiceNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.ServiceNode),
+  name: z3.string(),
+  language: z3.string(),
   // Deployment environment from the OTel `deployment.environment.name` attr
   // (with `deployment.environment` and resource-attr fallbacks). The literal
   // `'unknown'` is the honest sentinel when no env signal is present; static
   // extraction never sees env at extract time, so its ServiceNodes carry
   // `undefined` here and the id stays in the env-less wire format
   // `service:<name>`. See ADR-074 §2 and docs/contracts/env-dimension.md.
-  env: z2.string().optional(),
+  env: z3.string().optional(),
   // Framework recorded by the static extractor when the install plan
   // dispatches a framework-specific path (Next.js, Remix, SvelteKit, Nuxt,
   // Astro). Optional enrichment — `undefined` for lib-only packages and
   // ambiguous repos. See ADR-074 §3 / docs/contracts/framework-installers.md.
-  framework: z2.string().optional(),
+  framework: z3.string().optional(),
   // The hosting platform a static extractor recognized this service as
   // deployed to (`'cloudflare'` today) — a free string, same discipline as
   // `framework`, so a future platform needs no schema change. This is the
   // frontend's icon key at the service-rollup level (ADR-133,
   // docs/contracts/static-extraction.md).
-  platform: z2.string().optional(),
+  platform: z3.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional(),
-  version: z2.string().optional(),
-  dbConnectionTarget: z2.string().optional(),
-  repoPath: z2.string().optional(),
-  owner: z2.string().optional(),
-  dependencies: z2.record(z2.string(), z2.string()).optional(),
+  version: z3.string().optional(),
+  dbConnectionTarget: z3.string().optional(),
+  repoPath: z3.string().optional(),
+  owner: z3.string().optional(),
+  dependencies: z3.record(z3.string(), z3.string()).optional(),
   // Hostnames OTel spans might mention for this service: compose service
   // names, k8s metadata.name (and the cluster-DNS variants), Dockerfile
   // labels, etc. resolveServiceId in ingest.ts checks these before falling
   // back to a FRONTIER placeholder.
-  aliases: z2.array(z2.string()).optional(),
+  aliases: z3.array(z3.string()).optional(),
   // Optional. If set, services declare their `engines.node` here so γ #74's
   // node-engine compat check has something to test against.
-  nodeEngine: z2.string().optional(),
-  incompatibilities: z2.array(
+  nodeEngine: z3.string().optional(),
+  incompatibilities: z3.array(
     // Discriminated by `kind`. `driver-engine` is the original shape and
     // stays default for backward compatibility — older snapshots without a
     // `kind` field still parse via the union's `.optional()` discriminator
     // fallback. New kinds came in with γ #74.
-    z2.union([
-      z2.object({
-        kind: z2.literal("driver-engine").optional(),
-        driver: z2.string(),
-        driverVersion: z2.string(),
-        engine: z2.string(),
-        engineVersion: z2.string(),
-        reason: z2.string()
+    z3.union([
+      z3.object({
+        kind: z3.literal("driver-engine").optional(),
+        driver: z3.string(),
+        driverVersion: z3.string(),
+        engine: z3.string(),
+        engineVersion: z3.string(),
+        reason: z3.string()
       }),
-      z2.object({
-        kind: z2.literal("node-engine"),
-        package: z2.string(),
-        packageVersion: z2.string().optional(),
-        requiredNodeVersion: z2.string(),
-        declaredNodeEngine: z2.string().optional(),
-        reason: z2.string()
+      z3.object({
+        kind: z3.literal("node-engine"),
+        package: z3.string(),
+        packageVersion: z3.string().optional(),
+        requiredNodeVersion: z3.string(),
+        declaredNodeEngine: z3.string().optional(),
+        reason: z3.string()
       }),
-      z2.object({
-        kind: z2.literal("package-conflict"),
-        package: z2.string(),
-        packageVersion: z2.string().optional(),
-        requires: z2.object({
-          name: z2.string(),
-          minVersion: z2.string()
+      z3.object({
+        kind: z3.literal("package-conflict"),
+        package: z3.string(),
+        packageVersion: z3.string().optional(),
+        requires: z3.object({
+          name: z3.string(),
+          minVersion: z3.string()
         }),
-        foundVersion: z2.string().optional(),
-        reason: z2.string()
+        foundVersion: z3.string().optional(),
+        reason: z3.string()
       }),
-      z2.object({
-        kind: z2.literal("deprecated-api"),
-        package: z2.string(),
-        packageVersion: z2.string().optional(),
-        reason: z2.string()
+      z3.object({
+        kind: z3.literal("deprecated-api"),
+        package: z3.string(),
+        packageVersion: z3.string().optional(),
+        reason: z3.string()
       })
     ])
   ).optional()
 });
-var DatabaseNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.DatabaseNode),
-  name: z2.string(),
-  engine: z2.string(),
-  engineVersion: z2.string(),
-  compatibleDrivers: z2.array(CompatibleDriverSchema),
-  host: z2.string().optional(),
-  port: z2.number().optional(),
+var DatabaseNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.DatabaseNode),
+  name: z3.string(),
+  engine: z3.string(),
+  engineVersion: z3.string(),
+  compatibleDrivers: z3.array(CompatibleDriverSchema),
+  host: z3.string().optional(),
+  port: z3.number().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var ConfigNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.ConfigNode),
-  name: z2.string(),
-  path: z2.string(),
-  fileType: z2.string()
+var ConfigNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.ConfigNode),
+  name: z3.string(),
+  path: z3.string(),
+  fileType: z3.string()
 });
-var InfraNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.InfraNode),
-  name: z2.string(),
-  provider: z2.string(),
-  region: z2.string().optional(),
-  kind: z2.string().optional()
+var ColumnAttrSchema = z3.object({
+  name: z3.string(),
+  provenances: z3.array(ProvenanceSchema),
+  confidence: z3.number().min(0).max(1)
 });
-var FrontierNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.FrontierNode),
-  name: z2.string(),
-  host: z2.string(),
-  firstObserved: z2.string().datetime().optional(),
-  lastObserved: z2.string().datetime().optional()
+var InfraNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.InfraNode),
+  name: z3.string(),
+  provider: z3.string(),
+  region: z3.string().optional(),
+  kind: z3.string().optional(),
+  // Column-grain attributes on a table InfraNode (`sql-table`, `supabase-table`).
+  // Absent on a non-table InfraNode (a project node, a queue, a route). Optional
+  // schema growth (ADR-031); ADR-157 stamps the snapshot version because the field
+  // records a new grain the graph can now carry. See docs/contracts/schema.md.
+  columns: z3.array(ColumnAttrSchema).optional()
 });
-var FileNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.FileNode),
-  service: z2.string(),
-  path: z2.string(),
-  language: z2.string().optional(),
+var FrontierNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.FrontierNode),
+  name: z3.string(),
+  host: z3.string(),
+  firstObserved: z3.string().datetime().optional(),
+  lastObserved: z3.string().datetime().optional()
+});
+var FileNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.FileNode),
+  service: z3.string(),
+  path: z3.string(),
+  language: z3.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional(),
   // The raw compiled `dist/...js` frame an OBSERVED call site was captured on,
   // preserved for diagnostic when ingest resolved it through a source map to
   // this original `src/...ts` (file-awareness.md §4 / `code.original_filepath`).
   // Absent when the call site was already source-grained.
-  originalPath: z2.string().optional(),
+  originalPath: z3.string().optional(),
   // The hosting platform this file is the entry point for (`'cloudflare'`
   // today) — set on a Worker/Pages-Function's entry file only, mirroring
   // ServiceNode's own `platform` field. See `platformName` below.
-  platform: z2.string().optional(),
+  platform: z3.string().optional(),
   // The platform's own name for this file's service, when the platform names
   // things differently than NEAT's manifest-derived serviceId (a Cloudflare
   // Worker's wrangler.toml/jsonc `name`, not `package.json#name`). This is the
@@ -230,52 +321,67 @@ var FileNodeSchema = z2.object({
   // connector's resolveTarget looks up against to fuse an OBSERVED signal onto
   // this exact FileNode (ADR-133, docs/contracts/static-extraction.md /
   // docs/contracts/connectors.md).
-  platformName: z2.string().optional()
+  platformName: z3.string().optional()
 });
-var RouteNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.RouteNode),
-  name: z2.string(),
-  service: z2.string(),
-  method: z2.string(),
-  pathTemplate: z2.string(),
-  path: z2.string(),
-  line: z2.number().int().nonnegative().optional(),
-  framework: z2.string().optional(),
+var RouteNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.RouteNode),
+  name: z3.string(),
+  service: z3.string(),
+  method: z3.string(),
+  pathTemplate: z3.string(),
+  path: z3.string(),
+  line: z3.number().int().nonnegative().optional(),
+  framework: z3.string().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var GraphQLOperationNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.GraphQLOperationNode),
-  name: z2.string(),
-  service: z2.string(),
-  operationType: z2.string(),
-  operationName: z2.string(),
-  path: z2.string().optional(),
-  line: z2.number().int().nonnegative().optional(),
+var GraphQLOperationNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.GraphQLOperationNode),
+  name: z3.string(),
+  service: z3.string(),
+  operationType: z3.string(),
+  operationName: z3.string(),
+  path: z3.string().optional(),
+  line: z3.number().int().nonnegative().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var GrpcMethodNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.GrpcMethodNode),
-  name: z2.string(),
-  rpcService: z2.string(),
-  rpcMethod: z2.string(),
-  path: z2.string().optional(),
-  line: z2.number().int().nonnegative().optional(),
+var GrpcMethodNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.GrpcMethodNode),
+  name: z3.string(),
+  rpcService: z3.string(),
+  rpcMethod: z3.string(),
+  path: z3.string().optional(),
+  line: z3.number().int().nonnegative().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var WebSocketChannelNodeSchema = z2.object({
-  id: z2.string(),
-  type: z2.literal(NodeType.WebSocketChannelNode),
-  name: z2.string(),
-  service: z2.string(),
-  channel: z2.string(),
-  path: z2.string().optional(),
-  line: z2.number().int().nonnegative().optional(),
+var WebSocketChannelNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.WebSocketChannelNode),
+  name: z3.string(),
+  service: z3.string(),
+  channel: z3.string(),
+  path: z3.string().optional(),
+  line: z3.number().int().nonnegative().optional(),
   discoveredVia: DiscoveredViaSchema.optional()
 });
-var GraphNodeSchema = z2.discriminatedUnion("type", [
+var SymbolKindSchema = z3.enum(["function", "method", "constructor", "class"]);
+var SymbolSpanSchema = z3.object({
+  startLine: z3.number().int().nonnegative(),
+  endLine: z3.number().int().nonnegative()
+});
+var SymbolNodeSchema = z3.object({
+  id: z3.string(),
+  type: z3.literal(NodeType.SymbolNode),
+  kind: SymbolKindSchema,
+  qualname: z3.string(),
+  span: SymbolSpanSchema,
+  service: z3.string(),
+  relPath: z3.string(),
+  discoveredVia: DiscoveredViaSchema.optional()
+});
+var GraphNodeSchema = z3.discriminatedUnion("type", [
   ServiceNodeSchema,
   DatabaseNodeSchema,
   ConfigNodeSchema,
@@ -285,65 +391,10 @@ var GraphNodeSchema = z2.discriminatedUnion("type", [
   RouteNodeSchema,
   GraphQLOperationNodeSchema,
   GrpcMethodNodeSchema,
-  WebSocketChannelNodeSchema
+  WebSocketChannelNodeSchema,
+  SymbolNodeSchema
 ]);
 
-// src/edges.ts
-import { z as z3 } from "zod";
-var ProvenanceSchema = z3.enum([
-  Provenance.EXTRACTED,
-  Provenance.INFERRED,
-  Provenance.OBSERVED,
-  Provenance.STALE
-]);
-var EdgeTypeSchema = z3.enum([
-  EdgeType.CALLS,
-  EdgeType.DEPENDS_ON,
-  EdgeType.CONNECTS_TO,
-  EdgeType.CONFIGURED_BY,
-  EdgeType.PUBLISHES_TO,
-  EdgeType.CONSUMES_FROM,
-  EdgeType.RUNS_ON,
-  EdgeType.CONTAINS,
-  EdgeType.IMPORTS
-]);
-var EdgeEvidenceSchema = z3.object({
-  file: z3.string(),
-  line: z3.number().int().nonnegative().optional(),
-  snippet: z3.string().optional(),
-  // HTTP shape of a recognised client call site (ADR-119). Present on a
-  // client↔route CALLS edge so the edge records the method + path-template the
-  // client named, alongside the file:line it named them at. Absent on every
-  // other edge — a config or infra edge has no HTTP method.
-  method: z3.string().optional(),
-  pathTemplate: z3.string().optional()
-});
-var EdgeSignalSchema = z3.object({
-  spanCount: z3.number().int().nonnegative(),
-  errorCount: z3.number().int().nonnegative(),
-  lastObservedAgeMs: z3.number().nonnegative().optional()
-});
-var GraphEdgeSchema = z3.object({
-  id: z3.string(),
-  source: z3.string(),
-  target: z3.string(),
-  type: EdgeTypeSchema,
-  provenance: ProvenanceSchema,
-  confidence: z3.number().min(0).max(1).optional(),
-  lastObserved: z3.string().datetime().optional(),
-  callCount: z3.number().int().nonnegative().optional(),
-  evidence: EdgeEvidenceSchema.optional(),
-  signal: EdgeSignalSchema.optional(),
-  // OBSERVED grain (ADR-142): `file` when the edge originates from a source
-  // file's call site (a `file:` source + `evidence`), `service` for the coarse
-  // fallback where no call site was captured. Makes "service-grained only as a
-  // labeled fallback" (connector gate #803) a stored, machine-readable fact
-  // instead of a re-derivation from the source prefix. `.optional()` — EXTRACTED
-  // edges and legacy snapshots carry none; an OBSERVED edge is backfilled on its
-  // next observation.
-  grain: z3.enum(["file", "service"]).optional()
-});
-
 // src/events.ts
 import { z as z4 } from "zod";
 var SpanAttributesSchema = z4.record(
@@ -493,6 +544,7 @@ var ROUTE_PREFIX = "route:";
 var GRAPHQL_OP_PREFIX = "graphql:";
 var GRPC_METHOD_PREFIX = "grpc:";
 var WEBSOCKET_CHANNEL_PREFIX = "ws:";
+var SYMBOL_PREFIX = "symbol:";
 var ENV_UNKNOWN = "unknown";
 function serviceId(name, env) {
   if (env === void 0 || env === ENV_UNKNOWN) return `${SERVICE_PREFIX}${name}`;
@@ -612,6 +664,34 @@ function parseWebsocketChannelId(id) {
   if (service.length === 0 || channel.length === 0) return null;
   return { service, channel };
 }
+function symbolId(service, relPath, qualname, disambiguator) {
+  const base = `${SYMBOL_PREFIX}${service}:${relPath}#${qualname}`;
+  return disambiguator === void 0 ? base : `${base}~${disambiguator}`;
+}
+function parseSymbolId(id) {
+  if (!id.startsWith(SYMBOL_PREFIX)) return null;
+  const rest = id.slice(SYMBOL_PREFIX.length);
+  const colon = rest.indexOf(":");
+  if (colon === -1) return null;
+  const service = rest.slice(0, colon);
+  const tail = rest.slice(colon + 1);
+  const hash = tail.lastIndexOf("#");
+  if (hash === -1) return null;
+  const relPath = tail.slice(0, hash);
+  let qualname = tail.slice(hash + 1);
+  if (service.length === 0 || relPath.length === 0 || qualname.length === 0) return null;
+  let disambiguator;
+  const tilde = qualname.lastIndexOf("~");
+  if (tilde !== -1) {
+    const suffix = qualname.slice(tilde + 1);
+    if (suffix.length > 0 && /^\d+$/.test(suffix)) {
+      disambiguator = Number(suffix);
+      qualname = qualname.slice(0, tilde);
+    }
+  }
+  if (qualname.length === 0) return null;
+  return { service, relPath, qualname, ...disambiguator !== void 0 ? { disambiguator } : {} };
+}
 var EDGE_ARROW = "->";
 function extractedEdgeId(source, target, type) {
   return `${type}:${source}${EDGE_ARROW}${target}`;
@@ -834,14 +914,20 @@ var commonFields = {
 var MissingObservedDivergenceSchema = z8.object({
   type: z8.literal("missing-observed"),
   ...commonFields,
-  edgeType: EdgeTypeSchema,
-  extracted: GraphEdgeSchema
+  edgeType: EdgeTypeSchema.optional(),
+  extracted: GraphEdgeSchema.optional(),
+  // Column locus (ADR-157 §4): the `sql-table` node id and the declared-only column.
+  table: z8.string().optional(),
+  column: z8.string().optional()
 });
 var MissingExtractedDivergenceSchema = z8.object({
   type: z8.literal("missing-extracted"),
   ...commonFields,
-  edgeType: EdgeTypeSchema,
-  observed: GraphEdgeSchema
+  edgeType: EdgeTypeSchema.optional(),
+  observed: GraphEdgeSchema.optional(),
+  // Column locus (ADR-157 §4): the `sql-table` node id and the observed-only column.
+  table: z8.string().optional(),
+  column: z8.string().optional()
 });
 var CompatibilityVerdictSchema = z8.enum(["incompatible", "deprecated", "unknown"]);
 var VersionMismatchDivergenceSchema = z8.object({
@@ -1094,6 +1180,7 @@ export {
   BlastRadiusResultSchema,
   BlastRadiusRuleSchema,
   CheckPoliciesScopeSchema,
+  ColumnAttrSchema,
   CompatRuleRefSchema,
   CompatViolationDivergenceSchema,
   CompatibilityRuleSchema,
@@ -1174,6 +1261,9 @@ export {
   StaleEventSchema,
   StaleEventsResponseSchema,
   StructuralRuleSchema,
+  SymbolKindSchema,
+  SymbolNodeSchema,
+  SymbolSpanSchema,
   TransitiveDependenciesResultSchema,
   TransitiveDependencySchema,
   VersionMismatchDivergenceSchema,
@@ -1202,10 +1292,12 @@ export {
   parseInfraId,
   parseRouteId,
   parseServiceId,
+  parseSymbolId,
   parseWebsocketChannelId,
   passesExtractedFloor,
   routeId,
   serviceId,
+  symbolId,
   websocketChannelId
 };
 //# sourceMappingURL=index.js.map