Document and validate configured secrets bootstrap
This commit is contained in:
@@ -27,6 +27,16 @@ Contextless bindings prepare declaration policies and assemble the declaring
|
||||
payload without opening filesystem access or recording selection evidence.
|
||||
Selected contexts use the existing acquisition and handle lifecycle.
|
||||
|
||||
A captured host main enters the same parsed-source and import traversal handoff
|
||||
as an ordinarily selected file. Its original bytes and nodes are charged once per
|
||||
load, including placement wrappers, and its canonical path participates in
|
||||
cycle and repeated-source checks. Imports are still acquired live; layered
|
||||
main-relative consumers receive the captured base and root, while each tier
|
||||
continues to use its own namespace token and repetition state. The capture and
|
||||
context checks are owned by
|
||||
[`prepared_source.go`](../../internal/engine/prepared_source.go) and
|
||||
[`filesystem_context.go`](../../internal/engine/filesystem_context.go).
|
||||
|
||||
Directory traversal tracks canonical directories on the active traversal path.
|
||||
It adds an identity when descending and removes it when the frame is popped, so
|
||||
only a back-edge to an active directory is a traversal cycle; a later alias is
|
||||
|
||||
@@ -125,6 +125,16 @@ for passive-context construction and ordinary-overlay handling: see
|
||||
[`filesystem_context.go`](../../internal/engine/filesystem_context.go) and
|
||||
[`source_context.go`](../../internal/engine/source_context.go).
|
||||
|
||||
Explicit configured bootstrap uses
|
||||
[`prepared_source.go`](../../internal/engine/prepared_source.go) to share host
|
||||
discovery and bounded parsing with acquisition. It stores a read-only main tree,
|
||||
byte count, and canonical path facts; each load clones the tree and assigns its
|
||||
own source ID. [`secrets_from_config.go`](../../internal/engine/secrets_from_config.go)
|
||||
validates just the bootstrap controls and calls the shared directory worker.
|
||||
Acquisition checks any later explicit context against the captured facts before
|
||||
imports or overlays, then applies normal source and aggregate accounting.
|
||||
Captured state contains no access handles or secret-file values.
|
||||
|
||||
Import responsibilities are split across candidate selection and path
|
||||
normalization in [`import_selection.go`](../../internal/engine/import_selection.go),
|
||||
source reading and traversal admission in
|
||||
|
||||
Reference in New Issue
Block a user