catalog check-sources
Compare each entry’s recorded source schemas against the live ones.
Reports; never repairs and never infers. Bundled and pinned sources are exempt: their bytes are in the archive, so they cannot drift.
Exit codes (the worst leaf wins): 0 every checked source equal; any leaf this version cannot probe is named in the output 2 a source was unreachable, or a leaf or the entry itself was unreadable 3 a source changed, or its table is missing
A sweep that never started is not a verdict about any source: a name that does not resolve, or a catalog that cannot be opened, exits 1, and a usage error exits click’s own 2. Neither prints a document, so a consumer reads the sweep’s verdict off the document rather than off a bare 2.
With –json the whole sweep is buffered and printed once as a single document, so a consumer parses a complete report or none at all. Its shape is documented in xorq.catalog.drift; the exit code is the same either way.
Usage
xorq catalog check-sources NAMES... [OPTIONS]Arguments
NAMES—One or more entry names or aliases.
Options
| Option | Default | Description |
|---|---|---|
--json |
off | Output as JSON. |
Examples
xorq catalog check-sources prod-matches staging
xorq catalog check-sources prod-matches --jsonSee also
- Check catalog entries for source drift—when to run it, how to read each verdict, and what the exit codes mean
catalog schema—the schemas an entry recordedcatalog check—verify the catalog’s own integrity