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