Verify the native cutover and complete the implementation roadmap

This commit is contained in:
2026-11-22 07:11:50 +00:00
parent 633ebd282f
commit 75444b8ef3
8 changed files with 102 additions and 31 deletions

View File

@@ -7,8 +7,8 @@ That feature roadmap owns product choices, defaults, ownership, and acceptance
semantics. This document owns execution order and stage completion. Completion
markers below record finished stages. The inspected pre-migration application
baseline was Notarius commit `b3664d587914b1d7b0377f25fa377b57fa97c815`.
The completed stages below record the landed implementation and checks;
the final whole-roadmap acceptance audit remains pending until Stage 46.
All stages below are complete. Their markers record the landed work and checks;
Stage 46 records the completed whole-roadmap acceptance audit.
Each numbered stage is one implementation prompt for a Luna coding agent.
Execute stages in integer order as one end-to-end sprint. Intermediate stages
@@ -2235,6 +2235,79 @@ docs/examples for stale names while retaining meaningful migration/history menti
## Stage 46: Verify The Complete Native Cutover
**Status:** Complete. Audited every feature acceptance row against current
owning code, focused assertions, assembled/executable tests, and the checks below.
All earlier intermediate compilation/fixture blockers are closed: the full
default suite compiles and passes, including maintained examples and the concrete
module/validator/recovery tests previously recorded as blocked.
Final checks pass with Go `1.27.0`, declared dependencies, and `GOWORK=off`:
`go test ./...`, `go vet ./...`, a fresh temporary `go build -trimpath` executable,
and `git diff --check`. Repeated focused race checks pass for mixed ready jobs,
backend admission/cancellation, shared native capture, recorder/allocation, and
assembled recovery/fallback. Twenty-five direct offline executable checks pass
with the OpenRouter credential unset: help/version, all three completions,
configuration scopes/sources/explanation/diff, native resources/requirements,
minimal/complete/development/overlay preflight, and native JSON/YAML values.
Provider-boundary and real subprocess tests supply success/fallback formats,
stream separation, required-input/alias behavior, and post-publication failures
without paid inference.
The 252-file production inventory has fourteen native helper consumers (scene
planning, all ten extractors, three semantic normalizers), one direct native LLM
validator, and one composition-root engine constructor. Removed adapters,
schedulers, prompt/schema registries, generic retries, checkpoint/plan stores,
reporting sidecars, and copied accounting have no production consumers or tracked
legacy packages. Remaining test matches are explicit retired-input rejection,
unchanged legacy-data assertions, and deliberately selected native test budgets,
not pinned upstream defaults. Replaced the stale chunk-plan import-boundary fixture
with the current accepted-result store and removed its redundant special-case
guard; the existing generic framework boundary remains tested and unchanged.
Compared schemas and D&D codec files byte-for-byte with the inspected baseline:
no differences. Reviewed module selection/build metadata and all eleven selected
dependency notices against their module-cache release hashes; no replacement
modules or old-path kits/catalog dependencies remain. Successor ADR changes alter
earlier status links only, preserving accepted bodies; releases/archives remain
historical. No output/cache/debug data was migrated or deleted.
The read-only documentation check covers all 84 Markdown files, excluding literal
code-block examples from link interpretation. Current local destinations/anchors
resolve after fixing four stale D&D configuration anchors and the moved catalog
example link. Seven links in historical release notes intentionally refer to
retired checkout paths/headings; those records were preserved rather than
rewritten. Dated sibling comparison material remains evidence, not a current
implementation dependency. Selected upstream guide/source destinations were
checked against the exact module sources during the integration audit.
Acceptance evidence was checked at these owners, not inferred from test names
or a successful build alone:
| Feature acceptance row | Current evidence |
| --- | --- |
| Configuration/assets | [Typed definition/handoff](../../internal/core/config/native_settings_test.go), [main-relative source/peer/replacement cases](../../internal/cli/native_load_test.go), [operator schema execution](../../internal/cli/native_schema_load_test.go), and [every embedded declaration prepared](../../assets/package_test.go). |
| Commands/loaders | [Lazy native app/scopes/diff](../../internal/cli/application_test.go), [run inputs and shared roles](../../internal/cli/pipeline_run_test.go), [native overrides](../../internal/cli/execution_overrides_test.go), and [real executable routes](../../internal/cli/native_process_test.go). |
| Preflight/inspection | [Known/default/dynamic resources and partial profiles](../../internal/preflight/preflight_test.go) and [one-load offline commands without execution inputs/storage](../../internal/cli/pipeline_commands_test.go). |
| Domain workflow | [Spell pipeline contracts](../../internal/modules/integration/), [fresh typed normalization](../../internal/modules/dnd/normalize/itemregistry/native_execution_test.go), [candidate isolation/whole chains](../../internal/framework/pipeline/candidate_assessment_test.go), and [runner outcomes](../../internal/framework/pipeline/runner_operation_test.go). |
| Prompt/guidance contracts | [Native paired assets](../../assets/package_test.go), [correction defaults versus explicit selections/history](../../internal/framework/pipeline/producer_test.go), [complete ordered findings](../../internal/framework/pipeline/candidate_assessment_test.go), and [real combat judgment guidance](../../internal/modules/dnd/extract/scenedescriptions/native_execution_test.go). |
| Retry controls | [Presence/default/zero/precedence](../../internal/framework/pipeline/validation_policy_test.go), [loaded controls](../../internal/core/config/validation_policy_contract_test.go), [early/final-turn acceptance](../../internal/framework/pipeline/producer_test.go), and absent bundled repair counts in native declarations. |
| Non-LLM failure handling | [One deterministic production/error path](../../internal/framework/pipeline/runner_operation_test.go), direct generic/Seriatim modules, and [rejection of retired controls](../../internal/core/config/operational_document_test.go). |
| Continuation/failures | [Nil-error failed status, no prior recovery, native timeout/caller distinction](../../internal/framework/pipeline/producer_test.go), [unassessed undelivered/callback failures](../../internal/framework/pipeline/native_capture_test.go), and [direct validator failures](../../internal/modules/dnd/validate/scenedescriptions/combat_semantics/native_execution_test.go). |
| Strict/permissive outcomes | [Terminal handling](../../internal/framework/pipeline/producer_outcome.go), [runner counts/eligibility](../../internal/framework/pipeline/runner_operation_test.go), [whole-source plan fallback](../../internal/modules/dnd/chunk/scenes/chunker_test.go), and [final-only valid scene fallback/failure](../../internal/modules/dnd/extract/scenedescriptions/native_execution_test.go). |
| Admission/workers | [Mixed ready jobs, independent limits, serial/nested liveness, capacity modes, cancellation release](../../internal/framework/pipeline/ready_jobs_test.go), [stable ordering/draining](../../internal/framework/pipeline/runner_concurrency_test.go), and [nested same-backend assessment](../../internal/framework/pipeline/native_assessment_test.go). |
| Accepted-artifact cache | [Initial-key late applied-value writes, frozen handles, settings hits/content misses, terminal exclusions](../../internal/framework/pipeline/producer_cache_test.go), [typed usability and warning publication](../../internal/framework/pipeline/runner_cache_test.go), and [assembled recovery/actual dependents](../../internal/cli/recovery_contract_test.go). |
| Chunk-plan reuse | [Final plan key, current-source rematerialization, no semantic reassessment, changed-message partitions, and deterministic exclusion](../../internal/framework/pipeline/chunk_plan_cache_test.go). |
| Cache controls/migration | [Loaded roots](../../internal/core/config/operational_document_test.go), [resolved invocation precedence](../../internal/framework/pipeline/validation_policy_test.go), [raw atomic store/modes/legacy retention](../../internal/framework/artifactcache/filesystem_test.go), and [failed refresh/qualified lineage](../../internal/cli/recovery_contract_test.go). |
| Output/outcomes | [Domain-only encoder](../../internal/modules/generic/output/json/encoder_test.go), [native formats/counts/quiet/delivery/capture failures](../../internal/cli/run_result_command_test.go), [executable fake HTTP formats](../../internal/cli/native_process_test.go), and unchanged intrinsic schema/codec comparison. |
| Execution observations | [Once-only native enrollment, unknown usage, parent identity, result-less failures, and no hit executions](../../internal/framework/pipeline/native_capture_test.go) and [assembled native group facts](../../internal/cli/recovery_contract_test.go). |
| Debug controls/lifecycle | [Supplied empty/boolean selection](../../internal/cli/run_debug_test.go), [start-time relative latest/allocation failure](../../internal/core/debugbundle/bundle_test.go), [one incremental recorder/retained causes](../../internal/framework/debug/recorder_test.go), and [publication/capture ordering](../../internal/cli/run_result_command_test.go). |
| Debug evidence | [Full native snapshots/exchanges and hit/failure availability](../../internal/framework/pipeline/native_capture_test.go), [operation/normalization inputs](../../internal/framework/pipeline/operation_capture_test.go), [fixed mappings/proposals](../../internal/modules/dnd/normalize/itemregistry/native_execution_test.go), and [exact secret-aware projection without content rewriting](../../internal/cli/run_capture_test.go). |
| End-to-end migration | [Maintained minimal/complete/development workflows and explicit shared references](../../internal/cli/example_contract_test.go), [ordered failure/fix/reuse and fallback](../../internal/cli/recovery_contract_test.go), native executable checks, and current [migration guidance](../consumers/native-migration.md). |
All required implementation, documentation, and verification work is complete.
No live-model quality claim, real credential, release, tag, push, new permanent
gate, or deferred backlog feature was needed or introduced.
**Goal:** finish only when the full end state is supported by current evidence.
**Inspect/change:** the assembled repository, feature roadmap acceptance matrix