Use native configuration diff and source evidence
This commit is contained in:
12
docs/cli.md
12
docs/cli.md
@@ -117,8 +117,10 @@ family declarations, and runtime provenance.
|
||||
effective values. Its header identifies the root, ordered imports, selected
|
||||
overlay and its file, selected campaign, party source, and digest. The
|
||||
remaining tab-separated records are sorted as `path`, `role`, and `source`.
|
||||
Roles distinguish root, import, overlay, centralized default, campaign, party,
|
||||
and generated family ownership. A generated party member has
|
||||
Roles distinguish root, import, overlay, normalization, centralized default,
|
||||
campaign, party, and generated family ownership. Records labeled
|
||||
`empty_import` identify the source-local declaration path, selector, and
|
||||
location of an optional import that selected no sources. A generated party member has
|
||||
one family record and one party record at the same logical path. The output
|
||||
never reads or prints secret values.
|
||||
|
||||
@@ -151,8 +153,10 @@ removed <path> <left-value>
|
||||
changed <path> <left-value> <right-value>
|
||||
```
|
||||
|
||||
Mappings are flattened to their logical field paths; lists remain one atomic
|
||||
value. The command compares defaulted concrete artifacts and publish rules, not
|
||||
Paths use JSON Pointer notation, with `~0` for `~` and `~1` for `/`. Native
|
||||
comparison reports a changed mapping region as one value when a whole mapping
|
||||
is added or removed; lists are compared as whole values. A `hidden_changed=true`
|
||||
field indicates a change hidden by redaction. The command compares defaulted concrete artifacts and publish rules, not
|
||||
overlay names, source-file layout, or formatting. It succeeds when differences
|
||||
are found, making it suitable for review and migration checks.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user