Clarify comparison and report controls

This commit is contained in:
Jan Petykiewicz 2026-11-19 10:21:56 -08:00
commit 623de2e585

View file

@ -108,13 +108,14 @@ Limitation codes are `unsupported_record`, `unsupported_metadata_version`,
`unresolved_reference`, `hierarchy_cycle`, and `scope_mismatch`. Failure codes are
`invalid_input`, `io_error`, `invalid_scope`, and `command_error`.
`--hierarchy graph` includes the full scoped union graph; otherwise `hierarchy`
is null. Nodes are keyed by name, with per-side states `included`, `outside_scope`,
`unresolved`, or `absent`, and change states `direct`, `affected`, or `unchanged`.
`--hierarchy graph` includes the full scoped union graph. By default, `hierarchy`
is null. JSON output rejects `--depth` with exit code 2. Nodes are keyed by name,
with per-side states `included`, `outside_scope`, `unresolved`, or `absent`, and
change states `direct`, `affected`, or `unchanged`.
Edges record parent, target, before/after direct placement counts, and changed
reference records. Array multiplicities are symbolic, not expanded or recursively
accumulated. Shared cells occur once and removed edges remain. Display filters,
object limits, and text depth do not trim the graph.
accumulated. Shared cells occur once and removed edges remain. The graph covers
the full comparison scope regardless of display filters and object limits.
## Versions