Clarify native ConfigKit discovery in the roadmap
This commit is contained in:
@@ -154,14 +154,19 @@ Together with the explicit selections above, precedence is `--config`, then
|
|||||||
`NOTARIUS_CONFIG`, then working-directory, user-configuration, and system searches.
|
`NOTARIUS_CONFIG`, then working-directory, user-configuration, and system searches.
|
||||||
Retain each preset's native filename groups and ordering. In particular, the
|
Retain each preset's native filename groups and ordering. In particular, the
|
||||||
working-directory preset selects `notarius.yml`, then `notarius.yaml`, rather
|
working-directory preset selects `notarius.yml`, then `notarius.yaml`, rather
|
||||||
than generic `config.yml`. The separate `HomeDirectory()` preset is not enabled.
|
than generic `config.yml`; user and system presets retain their native named
|
||||||
|
and generic filename groups in their applicable directories. Use the presets
|
||||||
|
directly rather than maintaining a parallel filename list or overriding their
|
||||||
|
filename options. The separate `HomeDirectory()` preset is not enabled.
|
||||||
|
|
||||||
Discovery selects one main file; it does not merge files from all search
|
Discovery selects one main file; it does not merge files from all search
|
||||||
locations. Missing candidates advance the search under ConfigKit's rules. Access
|
locations. Missing candidates advance the search under ConfigKit's rules. Access
|
||||||
errors and failures loading a selected file are terminal rather than reasons to
|
errors and failures loading a selected file are terminal rather than reasons to
|
||||||
try a lower-priority configuration. Document working-directory-dependent
|
try a lower-priority configuration. A reached directory-resolution failure also
|
||||||
selection and recommend explicit `--config` for services and subprocess callers
|
remains terminal; later search directories need not be resolved once an earlier
|
||||||
that want a fixed selection.
|
candidate is selected. Document working-directory-dependent selection and
|
||||||
|
recommend explicit `--config` for services and subprocess callers that want a
|
||||||
|
fixed selection.
|
||||||
|
|
||||||
Use a required search for commands that require a configuration file, preserving
|
Use a required search for commands that require a configuration file, preserving
|
||||||
their need for a selected configuration. This does not impose requiredness on
|
their need for a selected configuration. This does not impose requiredness on
|
||||||
@@ -251,6 +256,10 @@ later PromptKit upgrade.
|
|||||||
`internal/cli`. Add representative collection composition and step-reference
|
`internal/cli`. Add representative collection composition and step-reference
|
||||||
normalization cases, including imports in distinct directories and leaf
|
normalization cases, including imports in distinct directories and leaf
|
||||||
histories after list composition. Test native semantics, not the old behavior.
|
histories after list composition. Test native semantics, not the old behavior.
|
||||||
|
- Verify discovery precedence from explicit CLI and environment selections
|
||||||
|
through working-directory, user, and system presets. Cover native filename
|
||||||
|
ordering, missing-candidate continuation, required-search exhaustion, and
|
||||||
|
terminal selected-file failures without adding a separate discovery engine.
|
||||||
- Retain two top-level configuration examples. Migrate the complete example's
|
- Retain two top-level configuration examples. Migrate the complete example's
|
||||||
required import and demonstrate useful native composition without adding a
|
required import and demonstrate useful native composition without adding a
|
||||||
second application merger or an unnecessary example framework.
|
second application merger or an unnecessary example framework.
|
||||||
|
|||||||
Reference in New Issue
Block a user