base-layer/commandkit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Close comparison collection scope and defer general clearing support

Browse Source
This commit is contained in:
Eric Rakestraw
2026-11-07 01:36:07 +00:00
parent ca454624cc
commit 93c16bd57e
2 changed files with 26 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
docs/roadmap/future.md
View File

@@ -51,11 +51,18 @@ included in the [working roadmap](promptkit-v0.19.0.md#additional-configkit-oper
Roadmap OD-9 selects independent ordinary defaults for both sides and explicit Roadmap OD-9 selects independent ordinary defaults for both sides and explicit
application-declared right-side bindings. Configuration selections and overrides application-declared right-side bindings. Configuration selections and overrides
apply only to their own side; omission never inherits from the opposite side. apply only to their own side; omission never inherits from the opposite side.
Whether to standardize empty collections overriding nonempty application defaults Explicit-empty application selectors remain with application-declared bindings
remains open; clearing inherited comparison values is no longer needed. for this release; no additional standard collection-clearing flags are selected.
OD-10 selects an optional assertion outcome with a distinct difference status. OD-10 selects an optional assertion outcome with a distinct difference status.
These accepted plans do not change the currently implemented behavior. These accepted plans do not change the currently implemented behavior.
General collection-clearing support is deferred pending a concrete consumer need.
Revisit standardized syntax and binding support for explicitly replacing a
nonempty application-default selector collection with an empty collection.
This is separate from clearing configuration lists through OD-11's transient
overrides and does not reinstate comparison inheritance. No clearing grammar
or public helper API is selected.
[Roadmap OD-5](promptkit-v0.19.0.md#od-5-detailed-comparison-selection-and-shape) [Roadmap OD-5](promptkit-v0.19.0.md#od-5-detailed-comparison-selection-and-shape)
selects an optional detailed report while retaining the concise default for selects an optional detailed report while retaining the concise default for
human operators. Both presentations reuse the existing native comparison data; human operators. Both presentations reuse the existing native comparison data;

30
docs/roadmap/promptkit-v0.19.0.md
View File

@@ -910,11 +910,10 @@ universal-format, automatic-selection, and joint format-delivery decisions are
now agreed above. Remaining details are listed under now agreed above. Remaining details are listed under
[remaining core reporting implementation details](#remaining-core-reporting-implementation-details). [remaining core reporting implementation details](#remaining-core-reporting-implementation-details).
CLI JSON number decoding for both integrations, namespace applicability, and CLI JSON number decoding for both integrations, namespace applicability, and
independent comparison defaults are agreed. Outstanding operator choices are independent comparison defaults are agreed. OD-9 is settled: explicit-empty
whether to standardize explicit empty collections when application defaults are application selectors remain with application-declared bindings for this release.
nonempty (OD-9), and unusual-path grammar and loader composition (OD-11). The remaining open decision is OD-11, covering unusual-path grammar and loader
Inheritance-clearing flags are no longer composition. Exact helper signatures, typed binding composition, flag collision
needed. Exact helper signatures, typed binding composition, flag collision
handling, and report layouts remain implementation choices, not unresolved scope. handling, and report layouts remain implementation choices, not unresolved scope.
### OD-1: Preview command and report presentation ### OD-1: Preview command and report presentation
@@ -1389,14 +1388,19 @@ ADR 0012, retaining its accepted decision text as history, and update current
CLI/API contracts and examples. Exact helper signatures and flag collision CLI/API contracts and examples. Exact helper signatures and flag collision
handling remain implementation design tasks. handling remain implementation design tasks.
**Remaining collection question:** omission already means the ordinary collection **Agreed collection scope:** leave explicit-empty selection for application-defined
for that side, so no flag is needed to clear inherited left-side values. The repeatable selectors to application-declared bindings in this release. Omission
earlier proposed `--against-clear-*` flags are not selected. Explicitly replacing retains that side's ordinary collection; an empty string element is not implicitly
an application's nonempty default collection with an empty collection is a an empty collection. No additional standard collection-clearing flags, including
separate, symmetric question for either side: decide whether it needs a standard the earlier proposed `--against-clear-*` forms, are selected.
capability or should remain with application-declared bindings. No empty-collection
grammar is selected here, and an empty string element is not implicitly an empty Actual configuration lists supported by OD-11 can be replaced with an empty list
collection. using `--set /path=[]` or `--against-set /path=[]` on the corresponding side,
subject to upstream path and schema rules. This does not necessarily express
empty selection for an application selector that controls which sources load.
Retain general collection-clearing support as a
[future candidate](future.md#comparison-extensions) pending a concrete consumer
need. OD-9 requires no further operator-policy decision for this adoption.
### OD-10: Comparison assertion outcomes ### OD-10: Comparison assertion outcomes