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.
|
||||
Retain each preset's native filename groups and ordering. In particular, the
|
||||
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
|
||||
locations. Missing candidates advance the search under ConfigKit's rules. Access
|
||||
errors and failures loading a selected file are terminal rather than reasons to
|
||||
try a lower-priority configuration. Document working-directory-dependent
|
||||
selection and recommend explicit `--config` for services and subprocess callers
|
||||
that want a fixed selection.
|
||||
try a lower-priority configuration. A reached directory-resolution failure also
|
||||
remains terminal; later search directories need not be resolved once an earlier
|
||||
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
|
||||
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
|
||||
normalization cases, including imports in distinct directories and leaf
|
||||
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
|
||||
required import and demonstrate useful native composition without adding a
|
||||
second application merger or an unnecessary example framework.
|
||||
|
||||
Reference in New Issue
Block a user