Reconcile completed CLI planning and deferred work
This commit is contained in:
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user