Document and validate configured secrets bootstrap

This commit is contained in:
2026-11-18 01:10:24 +00:00
parent ab6e610fb7
commit eeafc356e4
13 changed files with 172 additions and 46 deletions

View File

@@ -407,11 +407,11 @@ accessor exposes a resolved credential to application code. Credential bytes mus
never enter composition trees, history, or inspection. General environment-variable
configuration overlays are an explicit non-goal. Bootstrap preserves already
set variables by default, including empty ones, and reports blocked files without
contents. [ADR 0023](../adr/0023-explicit-configured-secrets-bootstrap.md) permits
explicit overwrite and main-document-directed bootstrap as a separate startup
operation. Its implementation is tracked in the
[secrets-directory roadmap](../roadmap/secrets-directory.md); the
[configuration contract](../config.md#explicit-secrets-directory-bootstrap)
contents. Explicit overwrite and main-document-directed bootstrap are available
as separate startup operations. A prepared main retains its selected document
and passive filesystem context without retaining secret-file contents or open
handles. [ADR 0023](../adr/0023-explicit-configured-secrets-bootstrap.md) records
the decision; the [configuration contract](../config.md#explicit-secrets-directory-bootstrap)
owns current behavior.
Secrets must be considered throughout error handling and inspection. Library