Prepare resolution entry provenance view

This commit is contained in:
2026-09-12 13:10:48 +00:00
parent 818d36f836
commit 88f21d09c7
4 changed files with 142 additions and 3 deletions

View File

@@ -81,7 +81,7 @@ performance guarantees, resource caps, or benchmark gates.
## Stage 1 — Factor reusable effective-path indexing
Status: not started. Dependencies: none.
Status: complete (2026-09-12). Dependencies: none.
Scope: `metadata.go`, `load_metadata.go`, and their focused test owners.
@@ -110,6 +110,17 @@ No public API or configuration contract changes are claimed by this stage.
Validation: `go test . -run 'Metadata|Path|Provenance|Historical'`, then the everyday
checker. Handoff should identify the helper and constructor signatures for Stage 2.
Completion record (2026-09-12): extracted `effectivePathIndex(final)` from final
metadata publication and introduced `newResolutionInput(metadata, final, sources)`.
The private view owns cloned metadata/source records, indexes source IDs, and exposes
private detached lookup helpers for the next step; it intentionally has no public API
or load-lifecycle wiring yet. `TestResolutionInputKeepsDetachedEntryMetadata` covers
root, defaults, explicit null, missing descendants, escaped keys, contextual parsed
sequence indices, key/index mismatches, detached records, and stability after real
recorded resolution. `go test . -run 'Metadata|Path|Provenance|Historical'` and
`./scripts/check.sh` passed with Go 1.26.7 on Linux. No deviations or remaining
Stage 1 risks were identified.
## Stage 2 — Wire the callback API and enforce lifetime
Status: not started. Dependencies: Stage 1.