From d88a01cec03816968b746ea0cddf1e04d2b6498d Mon Sep 17 00:00:00 2001 From: Eric Rakestraw Date: Tue, 17 Nov 2026 21:59:54 +0000 Subject: [PATCH] Clarify native ConfigKit discovery in the roadmap --- docs/roadmap/configkit.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/roadmap/configkit.md b/docs/roadmap/configkit.md index dcb66c89..f3698cbb 100644 --- a/docs/roadmap/configkit.md +++ b/docs/roadmap/configkit.md @@ -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.