Add table-based node lookup to GraphQL

[jlhester]

Adds a tables filter to findNodes/findNodesPaginated matching nodes by physical table, and a nodesForTable query that returns the source nodes on a table plus everything downstream. Table entries may be fully or partially qualified, or bare.

Indexes noderevision on (catalog_id, schema_, table) to back the filter.

Summary

Test Plan

• PR has an associated issue: #
• make check passes
• make test shows 100% unit test coverage

Deployment Plan

[netlify]

✅ Deploy Preview for thriving-cassata-78ae72 canceled.

Name	Link
🔨 Latest commit	207d7c3
🔍 Latest deploy log	https://app.netlify.com/projects/thriving-cassata-78ae72/deploys/6abe8bd931d8250008510728

[greptile-apps]

Confidence Score: 4/5

[Critical risk] Adds database migration and table-based node lookup to GraphQL.

The PR should not merge until nodesForTable can return all matching sources and their downstream nodes without silent truncation.

Findings

1.  Table results are silently truncated ▶
2.  Index misses table lookups ▶

Summary

Adds case-insensitive physical-table filtering to both node-list queries and a nodesForTable query that finds matching sources and traverses their downstream graph.

• Adds a composite node-revision index and GraphQL coverage for qualified, partial, and bare table names.
• The new lookup can silently truncate a table’s source nodes; the index does not align with its lookup predicates.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart LR
  T["Physical table input"] --> F["Filter current source revisions"]
  F --> S["Up to 1,000 source nodes"]
  S --> D["Traverse downstream per source"]
  S --> R["Deduplicate and filter node types"]
  D --> R
  R --> O["nodesForTable result"]

Loading

_{Reviews (1) · Last reviewed commit: "Add table-based node lookup to GraphQL"}

[greptile-apps]

Table results are silently truncated

If more than 1,000 source nodes reference one physical table, this limit returns only the newest 1,000. The query never traverses the omitted sources, so nodesForTable also leaves out their downstream nodes despite promising everything downstream of the table. Source registration does not enforce a per-table limit.

[greptile-apps]

Index misses table lookups

The filter compares lower(table) and, for qualified names, lower(schema_), but this index stores the original column values. Bare-table lookups also do not constrain its leading catalog_id column. As a result, the new index does not provide the intended lookup benefit while still adding index maintenance cost.