Complete documentation reconciliation and final review

This commit is contained in:
2026-10-07 18:32:44 +00:00
parent eaf0c8f004
commit 3871d83748
5 changed files with 73 additions and 43 deletions

View File

@@ -797,11 +797,11 @@ func RegisterPromptKit[C any](app *App, suite PromptKitSuite[C]) error
bookkeeping. Configuration scope installation remains independent.
3. Accept ID as one required operand. Prompt alone has singleton `--version`
(default empty). Both accept standard Config/Overlay selection, context-selector
bindings, and `--format text|yaml` (text default), plus help. No built-in configuration-scope selector is
installed for definition commands; a custom context selector can use the name
`scope` when it does not collide with an installed flag. Selector target is
`promptkit`; empty Scopes
or a list containing promptkit applies, independent of a config scope registry.
bindings, and `--format text|yaml` (text default), plus help. No built-in
configuration-scope selector is installed for definition commands; a custom
context selector can use the name `scope` when it does not collide with an
installed flag. Selector target is `promptkit`; empty Scopes or a list containing
promptkit applies, independent of a config scope registry.
Other explicit targets are miswired metadata at registration.
4. Reuse Stage 7's input/context creation and input-check rules. Missing ID is
usage; a supplied blank/unknown/ambiguous selection reaching the owning API is

View File

@@ -46,9 +46,9 @@ owns current package inventory and mechanics.
| Compare safe semantic snapshots with sensitivity union and explicit coverage gaps when comparison is enabled. | [ADR 0008](../adr/0008-semantic-configuration-diff.md) | deferred DIFF-01 |
| Declare scope capabilities; default to `app`; preserve the meaning and coverage of `all`; order scopes consistently. | [ADR 0009](../adr/0009-configuration-scopes.md) | CFG-01–05, INT-01 |
The [four earlier roadmaps](01-cli-plan.md), [dispatcher proposal](02-dispatch.md),
[backend proposal](03-backend.md), and [facade proposal](04-facade.md) supply design
evidence. Carry these controlling corrections into implementation:
The [CLI planning record](01-cli-plan.md), [dispatcher record](02-dispatch.md),
[backend record](03-backend.md), and [facade record](04-facade.md) preserve the
review history. These corrections were selected for the initial target:
- Singleton flags use the last supplied occurrence, including mixed `--name value`
and `--name=value` spellings. Repeatable flags accumulate in order.
@@ -58,8 +58,10 @@ evidence. Carry these controlling corrections into implementation:
- Partial capabilities remain useful; neither scopes nor families need every verb.
- Preparing every selected view before report output is a `config show`
requirement. Other operations have their own output timing.
- The older acquisition graph, shared-load mandates, selector inheritance rules,
illustrative Go declarations, and exact report layouts remain proposals.
- The older acquisition graph and shared-load mandates were superseded by
application-composed callbacks. Exact declarations, selector behavior, and
report layouts are owned by GoDoc and the CLI reference. Old illustrations
remain historical evidence.
## Initial delivery scope

View File

@@ -1,6 +1,6 @@
# Documentation reconciliation work
Status: reconciliation in progress.
Status: all twelve documentation remediation units complete.
Date: 2026-10-07.
@@ -68,7 +68,8 @@ Owner: [01-cli-plan.md](01-cli-plan.md).
- [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.
**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
@@ -84,7 +85,8 @@ Owner: [02-dispatch.md](02-dispatch.md).
[consumer guide](../consumers/guide.md), and current mechanics to the internal
overview. Preserve application migration work as separate future work.
**Completion:** Replaced pending dispatcher work with a completed planning record and links to implemented API, consumer, and internal owners.
**Completion:** Replaced pending dispatcher work with a completed planning
record and links to implemented API, consumer, and internal owners.
## D-03: reconcile backend planning
@@ -99,7 +101,8 @@ Owner: [03-backend.md](03-backend.md).
and evidence tasks. Link current behavior to its owners; retain backend
replacement and consumer adoption only as future work where applicable.
**Completion:** Recorded the implemented backend, retired completed adaptation tasks, and replaced singleton-rejection proposals with canonical references.
**Completion:** Recorded the implemented backend, retired completed adaptation
tasks, and replaced singleton-rejection proposals with canonical references.
## D-04: reconcile facade planning
@@ -115,7 +118,9 @@ Owner: [04-facade.md](04-facade.md).
- [x] Keep old automated boundary-checker suggestions clearly historical or
optional; do not turn them into a new implementation requirement.
**Completion:** Recorded facade completion, retired illustrative extra packages, and preserved backend replacement and proportionate-check considerations.
**Completion:** Recorded facade completion, retired illustrative extra
packages, and preserved backend replacement and proportionate-check
considerations.
## D-05: close the preparation checklist
@@ -128,7 +133,8 @@ Owner: [initial-plan.md](initial-plan.md).
- [x] Check the completed final handoff item and label the preparation process
and recommended outline as historical planning material.
**Completion:** Closed the planning handoff, checked its final item, and labeled the retained process and outline as historical.
**Completion:** Closed the planning handoff, checked its final item, and
labeled the retained process and outline as historical.
## D-06: clarify completed feature and implementation records
@@ -146,7 +152,9 @@ Owners: [initial.md](initial.md) and [implementation.md](implementation.md).
context. Keep diff/catalog and other genuine deferrals visible; completed
design records must not become competing current API/CLI references.
**Completion:** Labeled feature specifications and staged instructions as completed history, linked current owners, and recorded later code fixes and selector-name behavior.
**Completion:** Labeled feature specifications and staged instructions as
completed history, linked current owners, and recorded later code fixes and
selector-name behavior.
## D-07: correct the current CLI reference
@@ -166,7 +174,8 @@ Owner: [cli.md](../cli.md).
CommandKit's standard-handler boundaries as well as returned by PromptKit.
Preserve supported error identity and operational classification.
**Completion:** Corrected native marker/comment placement, qualified callback and engine lifecycle claims, and reconciled cancellation attribution.
**Completion:** Corrected native marker/comment placement, qualified callback
and engine lifecycle claims, and reconciled cancellation attribution.
## D-08: remove stale policy status statements
@@ -180,7 +189,8 @@ Owners: [testing.md](../policy/testing.md) and [oss.md](../policy/oss.md).
- [x] Preserve policy rules and upstream provenance while correcting local
implementation status. This work does not add testing or licensing gates.
**Completion:** Removed stale Go-suite and dependency-status claims while preserving policy rules, adopted versions, and upstream provenance.
**Completion:** Removed stale Go-suite and dependency-status claims while
preserving policy rules, adopted versions, and upstream provenance.
## D-09: correct the internal bridge description
@@ -192,7 +202,9 @@ Owner: [internal/overview.md](../internal/overview.md).
- [x] Keep inventory/mechanics here and normative responsibility boundaries in
the architecture policy.
**Completion:** Corrected neutral metadata/results flow and root callback ownership; distinguished adapter help rendering from standard inspection reports.
**Completion:** Corrected neutral metadata/results flow and root callback
ownership; distinguished adapter help rendering from standard inspection
reports.
## D-10: reconcile navigation and reading guidance
@@ -205,7 +217,8 @@ Owners: [development.md](../development.md) and [README.md](../../README.md).
- [x] Update README roadmap labels/navigation to match the reconciled statuses.
Keep genuine future-work navigation discoverable without duplicating contracts.
**Completion:** Routed current work to canonical contracts and mechanics, labeled completed planning records, and exposed genuine deferrals separately.
**Completion:** Routed current work to canonical contracts and mechanics,
labeled completed planning records, and exposed genuine deferrals separately.
## D-11: remove temporary references from durable ADRs
@@ -222,21 +235,36 @@ Owners:
must not change architectural decisions or manufacture new requirements.
- [x] Confirm that no ADR retains a temporary-roadmap reference after the edits.
**Completion:** Removed all temporary-roadmap links from ADRs through editorial reference updates; accepted statuses, dates, and architectural choices remain unchanged.
**Completion:** Removed all temporary-roadmap links from ADRs through editorial
reference updates; accepted statuses, dates, and architectural choices remain
unchanged.
## D-12: review the reconciled documentation
- [ ] Review every changed document against its canonical owner and current code.
- [x] Review every changed document against its canonical owner and current code.
Verify command spellings, defaults, outcomes, ownership, and report descriptions
affected by the corrections.
- [ ] Check local links and heading targets, including links affected by retiring
- [x] Check local links and heading targets, including links affected by retiring
sections. The audit found no unresolved local prose links or heading targets;
preserve that result.
- [ ] Check diffs for whitespace, stale references, and claims that delivered
- [x] Check diffs for whitespace, stale references, and claims that delivered
components are absent or superseded choices remain active requirements.
Historical baselines and explicitly labeled rejected alternatives remain valid.
- [ ] Confirm that deferred features are still identified accurately and that
- [x] Confirm that deferred features are still identified accurately and that
reconciliation introduces no new APIs, commands, guarantees, or consumer policy.
- [ ] Record completion here and commit completed documentation units under the
- [x] Record completion here and commit completed documentation units under the
local commit policy. Use document review for this prose work; do not add tests
or validation machinery solely to reconcile documentation.
**Completion:** Reviewed all changed documentation against current code and
owners; local links, headings, whitespace, deferrals, and preserved ADR/policy
scope checked.
## Final reconciliation evidence
All D-01 through D-12 items are complete. The completed records distinguish
historical planning from implemented contracts and genuine future work. Review
confirmed that only Markdown documents changed, accepted ADR metadata and
architectural choices were preserved, and policy source/version provenance was
retained. Local prose links and heading targets resolve; diff whitespace checks
passed. No Go tests were added or run for this documentation-only work.