ConfigKit/docs/roadmap/deferred.md

Deferred Scope

This document owns intentionally excluded features, not a committed delivery plan. The architecture policy governs changes to these boundaries. Implemented behavior belongs in the configuration contract and consumer adoption in the consumer guide.

Explicit non-goals and deferred scope

General environment-variable configuration overlays are not supported. Typed secret references and explicit directory bootstrap are the environment convention. Literal credential configuration and implicit secret-directory discovery are unsupported.

The following remain deliberately excluded:

• automatic conf.d discovery;
• remote imports, arbitrary providers, and additional configuration formats;
• custom merge strategies, sequence merging, reset operators, multiple-parent inheritance, and cross-scope references;
• named overlay inheritance;
• parser-specific or custom structural-decoding extension APIs;
• generic dynamic-subtree conversion and module-registry APIs;
• automatic schema migrations;
• hot reload, runtime resource replacement, and remote resource validation;
• a bundled CLI framework or application commands; and
• configuration diffs and fingerprints.

Applications may build their own validate, effective-value, source, bootstrap, and explanation commands around the library. Broadening these boundaries requires concrete consumer evidence, compatibility review, and an explicit design change.

Built-in sibling inheritance using extends is implemented as described in the configuration contract. It is distinct from inheritance between selected overlay files, which remains excluded above.