catalog lineage
Show the lineage recorded in an entry’s metadata sidecar.
The sidecar stores one node table with scope-tagged edges; the compact boundary tree is derived from it, so no level re-walks the expression.
--level picks how much detail, --node picks how much of the graph, --format picks the rendering, and --expand opens a node up: its columns are listed under it in the tree, or inside it in the diagram. With --node, the compact level prints the subtree feeding that node — including a Flight boundary’s nested input lineage — and a handle matching several nodes (a kind, a tag) prints each match in turn.
The TUI’s Lineage panel expands the same way, with ] and [ on the node under its cursor.
Levels:
compact(default)—the boundary-only tree, as the TUI renders it.boundaries—one tab-separated line per boundary: id, kind, label.raw—the stored lineage as JSON; pipe it tojq.
Formats:
text(default)—the level’s own format: a tree, a listing, or JSON.mermaid—aflowchart TDto paste into docs or an issue. Edges point downstream, so sources sit at the top, and a Flight boundary’s nested input lineage becomes asubgraph. With--level compactit draws the boundary graph; with--level raw, the expanded one, where the runs collapsed intoviabecome real nodes.--level boundarieshas no graph to draw and is rejected. A--nodehandle matching several nodes emits oneflowchartblock per match—paste them one at a time.
Usage
xorq catalog lineage NAME [OPTIONS]Arguments
NAME—Entry name or alias.
Options
| Option | Default | Description |
|---|---|---|
-l, --level |
compact |
How much lineage detail to print. |
--node |
none | Expand one node: a snapshot hash, an @label, a tag value, or a boundary kind. Scopes every level to the match(es). |
-f, --format |
text |
Render the graph as a text tree or a mermaid flowchart. |
--expand |
none | List this node’s columns under it: name and type per field, and both sides of a Flight boundary’s schema change. Same handle forms as –node. |
Examples
# The tree the TUI shows
xorq catalog lineage penguins-prod
# Grep-able boundary list
xorq catalog lineage penguins-prod --level boundaries
# Every stored field, for jq
xorq catalog lineage penguins-prod --level raw | jq '.nodes[0]'
# What feeds one node, addressed by its content hash
xorq catalog lineage penguins-prod --node 8f3a91c2e4
# Every UDXF's stored facts, addressed by kind
xorq catalog lineage penguins-prod --node flight_udxf --level raw
# A catalog-tagged source, addressed by tag value
xorq catalog lineage penguins-prod --node catalog-source
# A mermaid diagram, whole graph or one node's upstream
xorq catalog lineage penguins-prod --format mermaid
xorq catalog lineage penguins-prod --node flight_udxf -f mermaid
# The same diagram expanded to every op, not just the boundaries
xorq catalog lineage penguins-prod --level raw --format mermaid
# What flows through one node: its columns, in the tree or in the diagram
xorq catalog lineage penguins-prod --expand @cached_node_14
xorq catalog lineage penguins-prod -f mermaid --expand @cached_node_14See also
catalog show—the rest of an entry’s metadatacatalog schema—input and output schemas onlycatalog tui—browse the same lineage tree interactively