Clarify precedence for discovered collections
This commit is contained in:
@@ -98,6 +98,12 @@ checkout directory name does not determine the namespace. New checkouts are
|
|||||||
available on the next invocation without editing this file; a running server
|
available on the next invocation without editing this file; a running server
|
||||||
does not reload them. See the [maintained collection examples](../examples/discovery/collections/).
|
does not reload them. See the [maintained collection examples](../examples/discovery/collections/).
|
||||||
|
|
||||||
|
Entries imported by one discovery file are composed together as peers.
|
||||||
|
Conflicting definitions of the same qualified resource ID fail to load;
|
||||||
|
filename, checkout, and glob order do not set precedence. To override a
|
||||||
|
discovered record, select a separate framework file later in
|
||||||
|
`promptkit_sources` and supply the complete replacement record.
|
||||||
|
|
||||||
### Explicit imports and selected overlays
|
### Explicit imports and selected overlays
|
||||||
|
|
||||||
Application files declare imports under root `config.imports`. Native `path`,
|
Application files declare imports under root `config.imports`. Native `path`,
|
||||||
|
|||||||
@@ -82,9 +82,13 @@ Convert framework source controls from `configkit:` to `config:` and add
|
|||||||
header, if present, is `version: 2`. Use sibling inheritance such as
|
header, if present, is `version: 2`. Use sibling inheritance such as
|
||||||
`extends: {id: base}`.
|
`extends: {id: base}`.
|
||||||
|
|
||||||
Composition now replaces a whole record when a later source selects the same
|
Across ordered `promptkit_sources` entries, a later framework underlay replaces
|
||||||
ID; supply the complete intended replacement, or create a distinct inherited
|
the whole record for the same ID. Supply the complete intended replacement,
|
||||||
record. Null profile endpoint, credential, or provider-map settings can fall
|
or create a distinct inherited record. Checkouts imported by the same
|
||||||
|
[discovery file](../config.md#collection-checkout-discovery) are peers:
|
||||||
|
conflicting definitions of the same ID fail instead of overriding one another.
|
||||||
|
|
||||||
|
Null profile endpoint, credential, or provider-map settings can fall
|
||||||
back to the selected backend; review behavior rather than assuming null clears
|
back to the selected backend; review behavior rather than assuming null clears
|
||||||
backend values. Keep JSON schemas self-contained instead of depending on remote
|
backend values. Keep JSON schemas self-contained instead of depending on remote
|
||||||
schema references. Application selectors remain separate from these framework
|
schema references. Application selectors remain separate from these framework
|
||||||
|
|||||||
@@ -71,6 +71,10 @@ adopted attribution format.
|
|||||||
|
|
||||||
## R4: Distinguish discovery peers from ordered framework layers (Stages 6–7)
|
## R4: Distinguish discovery peers from ordered framework layers (Stages 6–7)
|
||||||
|
|
||||||
|
**Complete.** The migration guide and configuration reference distinguish
|
||||||
|
peer conflicts from ordered replacement. The same two definitions were
|
||||||
|
verified to conflict as peers and replace as separate selectors.
|
||||||
|
|
||||||
The [upgrade guide](../consumers/upgrading-promptkit.md) says a later source
|
The [upgrade guide](../consumers/upgrading-promptkit.md) says a later source
|
||||||
selecting the same ID replaces the whole record. That holds for a later
|
selecting the same ID replaces the whole record. That holds for a later
|
||||||
framework underlay, not for two checkout entries selected by the same
|
framework underlay, not for two checkout entries selected by the same
|
||||||
|
|||||||
Reference in New Issue
Block a user