Reconcile completed CLI planning and deferred work

This commit is contained in:
2026-10-07 18:24:31 +00:00
parent 2af1355b78
commit 71d2f6d4ee
2 changed files with 123 additions and 850 deletions

View File

@@ -1,6 +1,6 @@
# Documentation reconciliation work
Status: required updates recorded; reconciliation pending.
Status: reconciliation in progress.
Date: 2026-10-07.
@@ -26,48 +26,50 @@ Check each item when its documentation changes and review are complete.
Owner: [01-cli-plan.md](01-cli-plan.md).
- [ ] Replace the status claiming that no commands are implemented. Identify
- [x] Replace the status claiming that no commands are implemented. Identify
implemented operations, superseded proposals, and deferred features.
- [ ] Reconcile configuration scope defaults: every implemented configuration
- [x] Reconcile configuration scope defaults: every implemented configuration
operation defaults to `app`; aggregate validation/display requires explicit
`--scope all`. Retire the recommendation and rationale for validation defaulting
to `all`.
- [ ] Replace singleton-repetition rejection with the selected last-occurrence
- [x] Replace singleton-repetition rejection with the selected last-occurrence
rule, including conversion of every supplied occurrence. Remove repetition
from the list of usage failures and label the old alternative as superseded.
- [ ] Replace obsolete `--prompt-version` examples and descriptions with the
- [x] Replace obsolete `--prompt-version` examples and descriptions with the
implemented `--version` spelling.
- [ ] Retire the upstream redaction prerequisite for rich profile reports.
- [x] Retire the upstream redaction prerequisite for rich profile reports.
Record that effective `ExtraParams` is included using the current public
PromptKit API, without introducing additional redaction requirements.
- [ ] Remove CommandKit mandates for application root paths, rejection of empty
- [x] Remove CommandKit mandates for application root paths, rejection of empty
config values, overlay interpretation, and propagation from one application
root into PromptKit. Values and presence reach application callbacks; those
callbacks own their interpretation and acquisition paths.
- [ ] Reconcile aggregate validation output: completed scope records may already
- [x] Reconcile aggregate validation output: completed scope records may already
have been written when a later acquisition or output fails. Retire the claim
that failure always produces no success report.
- [ ] Reconcile native display syntax: `config show --format yaml` is accepted.
- [x] Reconcile native display syntax: `config show --format yaml` is accepted.
Link to the current framing contract rather than maintaining another report
reference.
- [ ] Retire the proposed scope inventory fields for descriptions/default
- [x] Retire the proposed scope inventory fields for descriptions/default
indicators and the proposed source-table presentation as current expectations.
Link to implemented scope/source report shapes in the CLI reference.
- [ ] Remove the claim that root `app --version` is supported. Reconcile identity
- [x] Remove the claim that root `app --version` is supported. Reconcile identity
presentation with the implemented version command, optional text revision, and
explicit YAML fields.
- [ ] Distinguish a missing definition ID operand from an explicitly blank ID:
- [x] Distinguish a missing definition ID operand from an explicitly blank ID:
missing is usage failure; blank values reach the owning inspection API and
produce operational results.
- [ ] Remove promises of automatic shared dependency reuse or mandatory
- [x] Remove promises of automatic shared dependency reuse or mandatory
acquisition coordination. Describe application-composed loading and optional
invocation-local caching as consumer integration patterns.
- [ ] Keep diff and PromptKit catalogs explicitly deferred. Retire completed
- [x] Keep diff and PromptKit catalogs explicitly deferred. Retire completed
dispatch/report implementation tasks and the obsolete profile-report upstream
dependency. Keep consumer migrations separate from library implementation.
- [ ] Label superseded alternatives and dated sibling-checkout evidence clearly.
- [x] Label superseded alternatives and dated sibling-checkout evidence clearly.
Replace duplicated current contracts with concise summaries and canonical links.
**Completion:** Retired completed CLI work and reconciled obsolete choices; current contracts link to their owners and future work remains explicit.
## D-02: reconcile dispatcher planning
Owner: [02-dispatch.md](02-dispatch.md).