Clarify native ConfigKit discovery in the roadmap

This commit is contained in:
2026-11-17 21:59:54 +00:00
parent c9744ad2e6
commit d88a01cec0

View File

@@ -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.