Compare commits

...
88 Commits
Author SHA1 Message Date
UnixNight 404b4b4d4a docs(01): verify bundled checker repair and restart pending UAT 2026-11-14 17:00:38 -05:00
UnixNight 2fe8b40ea5 fix(01): keep bundled Python commands from writing bytecode caches 2026-11-14 16:53:30 -05:00
UnixNight 23ee1c2e47 test(01): reproduce bundled checker creating immutable bytecode caches 2026-11-14 16:50:04 -05:00
UnixNight 07793af9fc docs(01): keep local-only API declaration within preflight limit 2026-11-14 16:33:42 -05:00
UnixNight 898aef7ffa docs(01): normalize final verification report whitespace 2026-11-14 00:41:11 -05:00
UnixNight f7e7033514 docs(01): persist final verification and pending combined-session UAT 2026-11-14 00:40:51 -05:00
UnixNight febb4a9d98 docs(01): express existing verification goal as required user story 2026-11-14 00:32:22 -05:00
UnixNight 08150c0199 docs(pause): preserve final verification continuation at quota reserve 2026-11-13 17:27:15 -05:00
UnixNight 71366e7d45 docs(01): close review and security gates with acceptance pending 2026-11-13 17:22:39 -05:00
UnixNight 02d182f35d fix(01-07): validate actual copy-state artifacts at scenario boundary 2026-11-13 17:18:39 -05:00
UnixNight 48fca0df52 test(01-07): reject copy-state identities without backing artifacts 2026-11-13 17:16:54 -05:00
UnixNight a821754b67 test(01): WR-01 verify readiness after transfer without Git 2026-11-13 17:08:10 -05:00
UnixNight 2608517c37 fix(01): WR-02 recover interrupted Windows runs without invented clocks 2026-11-13 17:07:44 -05:00
UnixNight 548c97aa58 fix(01): WR-01 preserve validated capability history in checkpoint viewer 2026-11-13 17:07:44 -05:00
UnixNight 6e5ee0bd25 fix(01): CR-03 bind lifetime continuity to named copy snapshots 2026-11-13 17:02:22 -05:00
UnixNight bda35e5bf5 fix(01): CR-02 bind original evidence to pristine inventory members 2026-11-13 17:01:42 -05:00
UnixNight 5569bc2b8b fix(01): CR-01 bind review digest to selected receipt bytes 2026-11-13 17:00:47 -05:00
UnixNight 5915128570 docs(01): record final code review findings and disposition 2026-11-13 16:58:55 -05:00
UnixNight 215d01e43e docs(01-07): track completed preparation and open acceptance gate 2026-11-13 16:49:31 -05:00
UnixNight 52a3e2d5ff docs(01-07): record verified preparation and pending human acceptance 2026-11-13 16:48:09 -05:00
UnixNight 472500bf4e test(01-07): integrate counted fidelity regressions and exact local results
Run existing fidelity Python, Node and observer checks with positive-count guards and explicit TAP output. Record the completed 782.05-second local suite and preserve human acceptance at 0/120.
2026-11-13 16:44:59 -05:00
UnixNight b732256751 docs(pause): save quota-guard checkpoint at 01-07 task3 2026-11-13 12:29:02 -05:00
UnixNight fc5e936fd7 docs(01-07): retain pending combined-session acceptance and diagnostic identity 2026-11-13 12:18:43 -05:00
UnixNight 026def9c5a feat(01-07): audit prepared fidelity materials and strict human acceptance 2026-11-13 12:17:46 -05:00
UnixNight d78b13566d test(01-07): specify strict final fidelity acceptance gates 2026-11-13 12:09:46 -05:00
UnixNight d18f551a26 docs(01-06): record reviewed Linux capture tooling and access limits 2026-11-13 12:06:50 -05:00
UnixNight ef021e79f0 docs(01-06): retain SDK planning-state companion 2026-11-13 12:05:41 -05:00
UnixNight 589481218d docs(01-06): advance completed capture plan tracking 2026-11-13 12:05:23 -05:00
UnixNight c60248dbfe docs(01-06): record Linux capture limits and complete open matrix 2026-11-13 12:04:22 -05:00
UnixNight 0172916ffd feat(01-06): preserve full Linux obligation matrix and capture history 2026-11-13 12:02:33 -05:00
UnixNight e17cfbebe3 test(01-06): require full Linux matrix continuity and resume history 2026-11-13 11:57:23 -05:00
UnixNight 16f5e126be feat(01-06): collect bounded Linux capture and honest failed preflight 2026-11-13 11:56:08 -05:00
UnixNight 9c59f60b50 test(01-06): require bounded Linux capture round trip 2026-11-13 11:52:12 -05:00
UnixNight 31ae6a6ab2 docs(01-05): record primary review and retain consumed handoff 2026-11-13 11:48:20 -05:00
UnixNight 1af5217e47 docs(01-05): advance verified checkpoint plan tracking 2026-11-13 11:46:26 -05:00
UnixNight 2d48ee5316 docs(01-05): complete offline Windows checkpoint plan 2026-11-13 11:45:36 -05:00
UnixNight aa4b862a12 fix(01-05): retain executable permissions in offline copies
Preserve source read/write/execute bits without privileged mode bits. Verify copied Linux apphost byte identity and permissions.
2026-11-13 11:43:51 -05:00
UnixNight 857466568d feat(01-05): complete offline Windows collection agenda and selftests
Prepare all session materials, explicit terminal outcomes and raw-media provenance while retaining open acceptance. Verify the package-free collector on synthetic fixtures without redistributing external tools.
2026-11-13 11:36:47 -05:00
UnixNight c9b9f2eba9 feat(workflow): checkpoint GSD before five-hour quota exhaustion 2026-11-13 11:24:53 -05:00
UnixNight 73954e675d docs(handoff): preserve quota-interrupted Windows bundle task 2026-11-13 11:07:44 -05:00
UnixNight 818191c90c test(01-05): require complete Windows session materials and open results 2026-11-12 23:48:52 -05:00
UnixNight 61123394e0 feat(01-05): assemble identified offline Windows checkpoint 2026-11-12 23:48:03 -05:00
UnixNight 446930d2a3 test(01-05): specify immutable offline checkpoint round trip 2026-11-12 23:40:08 -05:00
UnixNight de68796df1 docs(01-04): record reviewed wave two runtime regressions 2026-11-12 23:36:19 -05:00
UnixNight 4bf072d03c docs(01-04): advance sequential observation plan metadata 2026-11-12 23:23:27 -05:00
UnixNight 85e533b629 docs(01-04): complete passive port observation plan 2026-11-12 23:22:36 -05:00
UnixNight ea4dc9b5df feat(01-04): preserve observer identity through control and scene changes 2026-11-12 23:20:14 -05:00
UnixNight 6bccd47b9b test(01-04): require retained session and dialogue observation 2026-11-12 23:10:30 -05:00
UnixNight 72523eebb7 feat(01-04): observe accepted input with bounded passive output 2026-11-12 23:09:01 -05:00
UnixNight 773c228a30 test(01-04): specify passive port input observation 2026-11-12 23:05:18 -05:00
UnixNight e815534895 docs(01-03): verify resumed ledger and clear pause handoff 2026-11-12 23:01:12 -05:00
UnixNight f55ba8eae7 docs(01-03): advance sequential capability ledger progress 2026-11-12 23:00:00 -05:00
UnixNight 564b19ad03 docs(01-03): complete capability ledger plan 2026-11-12 22:59:25 -05:00
UnixNight 4d07d60e2f feat(01-03): reconcile full-game capability and checkpoint coverage
Map all 33 requirements across six groups and reconcile 33 hashed source rows. Preserve startup current/history, unimplemented work and open native/reference acceptance; bind imported receipt identities and generate navigation.
2026-11-12 22:57:22 -05:00
UnixNight fafbd05811 docs(pause): preserve phase one partial ledger continuation 2026-11-12 20:02:30 -05:00
UnixNight c21ed7d7a2 test(01-03): require complete game and checkpoint source coverage 2026-11-12 19:58:32 -05:00
UnixNight e6713ead48 feat(01-03): trace corrected TSK order through capability evidence 2026-11-12 19:57:35 -05:00
UnixNight ded848f78e test(01-03): specify capability applicability and review navigation 2026-11-12 19:53:52 -05:00
UnixNight be18d77ca4 docs(01-02): record sequential viewer progress 2026-11-12 19:48:50 -05:00
UnixNight a789bfa942 docs(01-02): complete local paired review plan 2026-11-12 19:48:18 -05:00
UnixNight 91da92f17d feat(01-02): preserve clocks exclusive audio and complete review tails 2026-11-12 19:46:04 -05:00
UnixNight 75d7ca4279 test(01-02): specify truthful timing audio and failure states 2026-11-12 19:35:57 -05:00
UnixNight 49f874e64c feat(01-02): export and serve validated local media pairs 2026-11-12 19:34:06 -05:00
UnixNight 488c904807 test(01-02): specify contained paired media review 2026-11-12 19:30:43 -05:00
UnixNight 6be8484802 docs(01-01): record reviewed wave one regression evidence 2026-11-12 19:26:58 -05:00
UnixNight f9f7a7277a docs(01-01): complete preserved session and scenario plan 2026-11-12 19:13:23 -05:00
UnixNight ac958e1962 docs(01-01): record preserved session and scenario implementation 2026-11-12 19:12:37 -05:00
UnixNight 32a72654e8 feat(01-01): enforce eight-cell scenario and native evidence completeness 2026-11-12 19:10:15 -05:00
UnixNight cc4a5a3e92 test(01-01): require complete journey and lifetime scenario matrix 2026-11-12 19:04:21 -05:00
UnixNight cd7783ba3a feat(01-01): stage preserved sessions and import typed hashed receipts 2026-11-12 19:02:34 -05:00
UnixNight 597caa0b49 test(01-01): cover preserved sessions and receipt trust boundaries 2026-11-12 18:58:00 -05:00
UnixNight 96c5f2c00f docs(state): retain generated planning state projection 2026-11-12 17:38:57 -05:00
UnixNight cf64b8ce18 docs(01): create verified fidelity baseline plans 2026-11-12 17:38:34 -05:00
UnixNight 36f24e4474 docs(phase-01): add research and validation strategy 2026-11-12 12:21:56 -05:00
UnixNight 29f8cb1714 docs(state): record phase 1 context session 2026-11-12 12:11:48 -05:00
UnixNight 661e7c3299 docs(01): capture phase context 2026-11-12 12:11:35 -05:00
UnixNight 9aa49970e4 docs: initialize eight-phase reconstruction roadmap 2026-11-12 11:52:43 -05:00
UnixNight ac60452db6 docs: define full reconstruction requirements 2026-11-12 11:49:22 -05:00
UnixNight a8dc07f9fc docs: research remaining full reconstruction 2026-11-12 11:47:41 -05:00
UnixNight dd7688bce9 chore: configure reconstruction workflow 2026-11-12 11:42:01 -05:00
UnixNight 7d56538d9f docs: initialize reconstruction project 2026-11-12 11:37:30 -05:00
UnixNight f2f3a805cd docs: map existing codebase 2026-11-12 11:06:58 -05:00
UnixNight bdca29d3aa Recover actor normal callbacks and late collision reads 2026-11-07 19:36:26 -05:00
UnixNight bf876e9c3c Match original collision rounding through populated dynamic reclip 2026-11-07 08:26:17 -05:00
UnixNight 135ff3642a Recover dynamic box shared-context ownership and kernel winding 2026-11-07 00:20:22 -05:00
UnixNight 346d350176 Trace VR04 physical registration and generated helper lifetimes 2026-11-06 22:56:38 -05:00
UnixNight 3794439d4e Record pair-contract package verification 2026-11-06 19:10:04 -05:00
UnixNight 924ad2f67b Recover ordered physical pair collision lifecycle 2026-11-06 19:07:09 -05:00
144 changed files with 23937 additions and 35 deletions

No files matched your search

+65
View File
@@ -0,0 +1,65 @@
{
"description": "GamePort quota guard: stop new workers at 20%; checkpoint and pause at 15%.",
"hooks": {
"SessionStart": [
{
"hooks": [
{
"type": "command",
"command": "/usr/bin/python3 \"$(git rev-parse --show-toplevel)/tools/workflow/codex_quota_guard.py\" hook",
"timeout": 5,
"commandWindows": "cmd /c exit 0"
}
]
}
],
"PreModelRequest": [
{
"hooks": [
{
"type": "command",
"command": "/usr/bin/python3 \"$(git rev-parse --show-toplevel)/tools/workflow/codex_quota_guard.py\" hook",
"timeout": 5,
"commandWindows": "cmd /c exit 0"
}
]
}
],
"UserPromptSubmit": [
{
"hooks": [
{
"type": "command",
"command": "/usr/bin/python3 \"$(git rev-parse --show-toplevel)/tools/workflow/codex_quota_guard.py\" hook",
"timeout": 5,
"commandWindows": "cmd /c exit 0"
}
]
}
],
"PreToolUse": [
{
"hooks": [
{
"type": "command",
"command": "/usr/bin/python3 \"$(git rev-parse --show-toplevel)/tools/workflow/codex_quota_guard.py\" hook",
"timeout": 5,
"commandWindows": "cmd /c exit 0"
}
]
}
],
"PostToolUse": [
{
"hooks": [
{
"type": "command",
"command": "/usr/bin/python3 \"$(git rev-parse --show-toplevel)/tools/workflow/codex_quota_guard.py\" hook",
"timeout": 5,
"commandWindows": "cmd /c exit 0"
}
]
}
]
}
}
+69
View File
@@ -0,0 +1,69 @@
{
"version": "1.0",
"timestamp": "2026-11-13T22:26:46.798618+00:00",
"phase": "01",
"phase_name": "Reproducible Fidelity Baseline",
"phase_dir": ".planning/phases/01-reproducible-fidelity-baseline",
"plan": 7,
"task": 3,
"total_tasks": 3,
"status": "consumed",
"completed_tasks": [
{
"id": 1,
"name": "Readiness/audit tooling plus review closure",
"status": "done",
"commit": "026def9",
"fix_head": "02d182f"
},
{
"id": 2,
"name": "Actual combined session status projection",
"status": "partial",
"commit": "fc5e936",
"actual_acceptance": "0/120 OPEN"
},
{
"id": 3,
"name": "Suite integration and review",
"status": "done",
"commit": "472500b",
"review_docs": "71366e7"
}
],
"remaining_tasks": [
{
"id": 2,
"name": "Actual original/native combined session and strict acceptance",
"status": "human_pending"
}
],
"blockers": [
{
"type": "human_action",
"description": "Combined original/native session and ten named UAT checks remain pending; 0/120 accepted."
}
],
"background_processes": {
"tests": "finished",
"verifier": "finished human_needed",
"quota_watcher": "running; no automatic resume"
},
"async_jobs": [],
"human_actions_pending": [
{
"action": "AfterfinalreadinessverificationperformonecombinedWindowsDxWnd/nativeWindows/physicalLinuxreviewsession",
"blocking": true
}
],
"uncommitted_files": [
" M .planning/HANDOFF.json",
" M .planning/ROADMAP.md",
" M .planning/STATE.md",
" M .planning/phases/01-reproducible-fidelity-baseline/.continue-here.md",
" M .planning/phases/01-reproducible-fidelity-baseline/HANDOFF.md",
"?? tools.yaml"
],
"next_action": "Use $gsd-verify-work 1 and docs/evidence/checkpoint-session.md for one combined actual human session; do not repeat completed implementation/tests/review or advance Phase2 automatically.",
"context_notes": "Quota guard explicitly requested pause at15%. Resume completed task01-07-03 and recovered fullsuite exit0 (782.049626s), then reviewed/fixed allfive source-integrity findings. Do NOT redo implementation or tests. Source commits through02d182f, review/coverage/security documentation71366e7. Fullsuite556Python/180fidelity,27Node,23observer,2HUD,51managedentrypoints,36GPUrenderedreceipts,zeroVulkanvalidationerrors,SDLdummychecks,539originalhashes. Latertooling-onlyfixes: all191fidelityregressions PASS43.355s; focused26scenario,23capture,29acceptance,27Node,18LinuxhostedPowerShell. All539originals unchanged. No runtime changes afterfullsuite; no need13minGPUrerun forcurrentPython/collector fixes.\nHistoricalreview5915128: CR01selected-vs-reviewedpath,CR02originalinventory/executablebinding,CR03copy-stateidentity,WR01viewerledgerprojection,WR02interruptedWindowsfinalization. Fixes5569bc2,bda35e5,6e5ee0b,548c97a,2608517,a821754. Independentre-reviewcaughtremaininghash-onlycopy-statebypass; RED48fca0d/GREEN02d182f requiresactual_checked_artifactwithrootinside_scenario_observation; callersupdated. Finalindependentre-reviewallfiveFIXED in01-REVIEW-VERIFY.md; dispositionopen0. Securityauditorfinal22/22mitigated, threats_open0 in01-SECURITY.md. Nyquistautomationcoveragevalidatedall15taskbindings; manualacceptanceopen;191fidelityaggregate43.355sec exceeds30secquicktargethonestly. UIreviewdisabledconfigfalse. No remainingknowncode/securityblockers.\nCurrentfreshfinalbundle dist/fidelity/phase01 has11001immutableentries. Currenthashes/readinessreceipt artifacts/fidelity/verification/01-07-final-checkpoint.json. readyexit0true,strictauditexit1 errors[] accepted0/120,10humanpending; logs artifacts/fidelity/01-review-fixes/readiness-final.json,acceptance-final.json,python-fidelity-final.log. Oldbundlespreserved phase01-pre-review-48100025 andphase01-pre-copy-artifact-7ceebcb3. ActualLinuxfailedpreflightimportedcurrentbundle/results/imported. Runtimepackage source446930d dirty/diff90cef956 unchanged; source/docscommitsmustnotrelabelitsidentity. Original/nativeWindows+DxWnd andphysicalLinuxvisible/audible/browserreviewremainonecombinedhuman session pending. Humanonlycollects/observes/returns; agent-ownedexactnormalizationmapping incheckpoint-session.md. No capture request issued yet because finalphaseverification/handoffpending.\nFinal typed verifier phase01_final_verification was dispatched at21%; quota15% interrupted it, instructedfinishonlyboundedhuman_neededreport/fingerprint thenreturn. It had readall7musthaves/summaries, checked25capabilities/33requirements/0unmapped/6groups/33rows,16/16decisioncoverage,40sourcefilesnoskip/debtscan. A mandatoryMVPgoalformatguard exposed existingROADMAPMode:mvp plainproseGoal. Rootauthorizedformat-only identicalintentuserstory and modifiedROADMAP.md uncommitted: As a tester, I want to reproduce identified original/port comparison scenarios, so that I understand exactly what the current reconstruction proves on each native platform. Validatorvalidtrue; no scope/successcriteriamodified. OneverifiercommandusedwrongunittestclassFidelityAcceptance (loadererror,correctclassAcceptanceTests); twoothernamedbehaviorcheckspassed; don'tmislabelthatcommandassuccess. Priorfulltargeted29passestablishactualcoverage.\nNEXT: Reconcile currentverifier's 01-VERIFICATION.md and CLI verification.status; ifreport/fingerprintabsentfinishthat ONLY beforeanynewphase. FingerprintmustbeownerCLIgenerated, notmanual. Oncehuman_neededstatusvalid, persistUATfromnamedhumanitems, updateSTATE/consumedhandoffs, commitverifiedreport+goalmetadata+handoffdocs andpush verifiedsource/tooling toauthorizedGitea/main. Lastpushedhead remainsd18f551; later01-07/task3/reviewfix/auditcommits arelocalawaitingfinalverification. Preserveunrelatedtools.yaml. Do notadvancephase2orclaimPhase1accepted; allEVIDIDsPending0/120humanacceptance. No source changesuncommittedexceptROADMAPformatandpossiblynewverifierreport.\nNativeagents/sourcewritesallfinishedexceptverifierreportbeingclosed. Quota watcher runs and actual15%steeringworks. Noauto-resume; usermust $gsd-resume-workafterreset. Don'tspendquota rereadingmassiveGSDscriptbodies orrerunningfinished13minfullsuite. Existinglocalpackages/media/originalcopiesstaylocal, noCI/uploads. MaintracksGitea/main, scoped.gitwriteescalation; retainhistoricalhandoffsmarkconsumedratherthandelete (priorautomaticreviewrejecteddeletion).\nRootinterruptedverifieratfinalpause tostopallmodelwork. Reconcileactualreportfileifpresent; ifabsentfinishboundedreport/fingerprintafterreset.\n\n2026-11-14 final typed verifier completed: human_needed,29/42verified13uncertain,all10namedhumanitems saved01-UAT.md. Ownerstatusacceptedreport; verificationfingerprintrefreshedafterfinalstatusnotes. Goalformatfebb4a9committed. Remainingworkisactualcombinedhumanverification, notcoding/fulltests.\n"
}
+81
View File
@@ -0,0 +1,81 @@
# Neutron GamePort
## What This Is
A faithful reconstruction of the original Windows 98 Neutron game for native Linux x64 and Windows 10/11 x64, using shared C#/.NET 10 code, Vulkan 1.3+ through Silk.NET.Vulkan, and SDL3. It preserves the original game's identity and reuses recovered original assets. The current project already implements substantial playable content; this planning effort covers the remaining full reconstruction.
## Core Value
Match the original game's behavior and presentation as accurately as possible, using original evidence and explicit verification to govern every reconstruction decision.
## Requirements
### Validated
These are existing capabilities with bounded evidence, not claims that the whole game or all platforms are verified. See `docs/progress.md`, `docs/compatibility.md`, and the linked investigation reports for exact revisions and limits.
- ✓ Shared .NET 10 runtime with Vulkan rendering and SDL3 window/input/audio — existing code and recorded native Linux checks.
- ✓ Original inventory and hash verification, bounded asset parsers, offline preparation and original-format GAM/TSK reading — existing tools and regressions; 539 originals comprise the recorded baseline.
- ✓ Playable lab/tutorial/outside content, script and cutscene execution, original-derived geometry, actors, HUD, music and speech — existing bounded routes and runtime checks; full original fidelity remains open.
- ✓ Recovered movement/body/collision components with isolated original-code comparisons — existing component evidence; physical registration, derived callbacks and broad live admission remain incomplete.
- ✓ Bounded implementations of several gadgets and vehicles — existing per-scene reports; broader actor interactions, levels and retained lifetimes remain open.
- ✓ Local Linux and Windows self-contained publishing and package provenance — existing scripts and recorded checks; Windows cross-publishing and Wine evidence do not establish complete native Windows compatibility.
### Active
- [ ] Close remaining Jimmy movement, body/contact, animation, camera and retained scene-state gaps while preserving verified baseline behavior.
- [ ] Recover physical registration, activation, helper cleanup, real actor responses and shared collision context before expanding live source solver admission.
- [ ] Complete original gameplay systems, gadgets, enemies/AI, damage, interactions and level-specific mechanics from authoritative evidence.
- [ ] Complete all original levels and progression, menus, configuration, save/load and fresh/retained/RETURN lifetimes.
- [ ] Match original rendering, materials, lighting, fog, transparency, animation, camera framing and UI behavior as closely as evidence permits.
- [ ] Complete original audio playback, banks, positional effects, timing, attenuation and lifecycle behavior.
- [ ] Establish repeatable original-versus-port comparisons, document discrepancies and resolve them in dependency order.
- [ ] Verify integrated gameplay and local release packages on native Linux and native Windows, retaining explicit evidence and remaining limitations.
### Out of Scope
- Creative reinterpretation, replacement movement tuning or visual modernization that changes the original identity — fidelity takes precedence.
- New gadgets or broader gameplay expansion before the current movement/route checkpoint closes — preserve the current stabilization priority.
- Runtime online services, telemetry, cloud CI, and uploads of original assets or generated packages — local operation and evidence preservation are mandatory.
- Replacing authoritative evidence with third-party reconstruction behavior — external decompiler indexes provide investigation leads only.
## Context
The authoritative specification is `../prompt.MD`; `../AGENTS.md` and `AGENTS.md` provide project rules and current priorities. Original binaries and assets live in `../Original/` and must never be modified or executed in place. Use generated copies and separate analysis/extraction/build output.
The complete codebase map is in `.planning/codebase/`. Existing architecture composes a persistent presentation session with scene-local simulation, scripts, resources and audio. Recovered algorithms and isolated original-component probes coexist with bounded live adapters and explicitly modern compatibility paths. Lab/outside capsule collision must remain until the source replacement gate is satisfied.
`docs/checkpoint/next-work-plan.md`, `docs/checkpoint/coverage.md`, `docs/checkpoint/implementation-plan.md`, and `docs/gameplay/jimmy-movement-stabilization.md` preserve the current recovery sequence. The successful TSK-backed first-story retained-input ordering correction is already documented; it must not be planned as an untouched defect or replaced by an invented orientation reset. Remaining derived actor responses, helper lifetime, collision admission, animation and camera handoffs need their own evidence gates.
The user explicitly selected the remaining full reconstruction as the planning scope and emphasized that it must be as accurate as possible to the original. A complete playable scene is an intermediate checkpoint, not the final scope. Existing runtime and component tests do not prove complete original-game fidelity. Whole-original runtime reference capture and broader native Windows comparisons remain open according to current reports.
## Constraints
- **Technology:** C#/.NET 10, Silk.NET.Vulkan, Vulkan 1.3+, SDL3; one shared native Linux/Windows x64 implementation.
- **Fidelity:** Preserve original algorithms, control semantics, floating-point/store behavior where significant, timing, progression and asset identity. Record approximations and unresolved questions explicitly.
- **Evidence:** Use REA for original-binary investigations; preserve complete Evidence, addresses, file offsets, provider gaps and relevant byte cross-checks. Distinguish static recovery, inference, implementation, compilation, component execution and whole-game runtime verification.
- **Validation:** Compilation alone cannot establish completion. Require meaningful regressions and integrated runtime comparisons at the appropriate scope; native Windows verification remains distinct from cross-publish and Wine.
- **Preservation:** Verify original hashes against `docs/original-manifest.json`; keep generated data outside originals and source commits.
- **Workflow:** Local builds/tests/packages only. Commit and push completed, verified source/tools/docs to existing `Gitea/main`; do not add cloud CI or upload originals/generated packages.
- **Coordination:** At most three investigators alongside primary, exclusive file ownership, primary integration and verification. Preserve unrelated working-tree changes.
## Key Decisions
| Decision | Rationale | Outcome |
|----------|-----------|---------|
| Plan the remaining full reconstruction | User selected full scope rather than a movement-only milestone | Confirmed |
| Make original fidelity the governing priority | User explicitly requires accuracy as high as possible | Confirmed |
| Stabilize movement and interacting lifetimes before expansion | Current project instructions and recovery dependencies | Existing policy |
| Reuse evidence and validated implementation with bounded claims | Avoid repeating solved investigations or overstating coverage | Existing policy |
| Require original comparison and native platform evidence for final completion | Component tests and cross-builds have narrower guarantees | Pending full verification |
## Evolution
This document evolves at phase transitions and milestone boundaries.
After each phase transition, move verified requirements to Validated with evidence references, record invalidated scope and new requirements, update decisions, and check that the project description remains accurate.
After each milestone, review every section, confirm the fidelity priority, revisit deferrals and update context with actual implementation and verification status. Keep full-game completion separate from intermediate scene and component checkpoints.
---
*Last updated: 2026-11-12 after initialization and user scope approval*
+127
View File
@@ -0,0 +1,127 @@
# Requirements: Neutron GamePort
**Defined:** 2026-11-12
**Core Value:** Match original behavior and presentation as accurately as possible, governed by authoritative evidence and explicit verification.
## v1 Requirements — Remaining Full Reconstruction
The release scope is the full original game. Existing bounded implementations are foundations; unchecked items represent their remaining full-scope acceptance, not absence of all implementation. Original means behavior established from authoritative binaries/assets and observed execution, including significant quirks. Approximation and unavailable comparison evidence must stay explicit; neither is silently counted as verified parity.
### Reference and Fidelity Baseline
- [ ] **EVID-01**: Every original file remains byte-identical to the recorded inventory throughout recovery, testing and release preparation; generated copies and outputs remain separate.
- [ ] **EVID-02**: Reviewers can reproduce identified original-game reference scenarios from an isolated generated installation, with input/event, visual and audio captures where applicable; unresolved execution limitations are recorded and leave comparison acceptance open.
- [ ] **EVID-03**: Reviewers can identify each capability's source evidence, implementation revision, runtime platform, current discrepancy and acceptance condition in a maintained full-game coverage ledger.
- [ ] **EVID-04**: Testers can repeat the baseline movement/route scenarios on native Linux and native Windows with revision-specific receipts; cross-publish, Wine, component execution and native gameplay remain separately labeled.
### Movement, Contacts and Scene Ownership
- [ ] **MOVE-01**: Jimmy's intended original keyboard/mouse/controller inputs, where supported by the original, produce source-faithful movement, facing, jumps, gravity and effect behavior across required movement modes and frame rates.
- [ ] **MOVE-02**: Jimmy and participating bodies resolve static/dynamic support, walls, ceilings and special contacts using evidenced real actor responses, live callback reads, ordered physical membership and helper lifetimes before broader scene admission.
- [ ] **MOVE-03**: Players retain the original action/animation acceptance, playback, interruption and completion behavior through movement, landing, conversation and control changes.
- [ ] **MOVE-04**: Players experience original camera/input/control handoffs through scripts, pause, fresh entry, LOAD and RETURN, preserving correct object/state ownership without invented orientation resets.
- [ ] **MOVE-05**: Players can complete lab → VR04 → lab → outside under fresh and retained entry with natural/skipped dialogue, banked jumping, landing, held input and gadget cleanup, preserving implemented startup-order corrections and legitimate landing bank.
### Actors, Hazards and Combat
- [ ] **ACT-01**: Original NPC/enemy classes exhibit their evidenced sensing, action transitions, movement, animation and RNG-dependent behavior in their intended scenes.
- [ ] **ACT-02**: Players and actors receive original health, damage, immunity, hazard, death and recovery behavior through real gameplay consumers.
- [ ] **ACT-03**: Enter/stay/leave and special actor interactions perform original task, score, control and class-specific side effects in the evidenced order.
### Gadgets, Vehicles and Inventory
- [ ] **GAD-01**: Players acquire and select all original gadgets/items through original gameplay paths with faithful inventory, energy and availability rules.
- [ ] **GAD-02**: Players can use every original gadget against its intended actors/objects with source-faithful aiming, firing, state, projectile and effect behavior; existing bounded gadget implementations retain their verified behavior.
- [ ] **GAD-03**: Players can summon, mount, drive/fly and dismount original vehicles through intended modes, inputs, camera, passenger, collision and cleanup behavior.
- [ ] **GAD-04**: Gadget/vehicle/companion state follows original interruption, death, script, LOAD/RETURN and save/resume lifetimes across intended scenes.
### Campaign and Authored Content
- [ ] **CAMP-01**: Players can enter and traverse every evidenced reachable original campaign and optional/practice level with its intended original assets and entry/exit rules.
- [ ] **CAMP-02**: Original missions, authored scripts/cutscenes, tasks, objectives, collectibles and level-specific mechanisms advance through ordinary gameplay in their intended order.
- [ ] **CAMP-03**: Players can complete every original campaign route and evidenced optional branch through original completion/win/loss outcomes without debug grants or warps.
- [ ] **CAMP-04**: The content ledger accounts for every supplied level/resource and distinguishes reachable content, unreachable/unused content and unresolved missing dependencies using evidence; absent assets are never silently substituted.
### Frontend, Configuration and Persistence
- [ ] **UI-01**: Players can use original startup, new-game, menu, pause, objective/HUD, prompt and ending flows through source-supported input and timing; modern diagnostics remain distinguishable.
- [ ] **UI-02**: Players can change and persist original-supported configuration, including relevant input/display/audio settings, with source-faithful defaults and bounds.
- [ ] **SAVE-01**: Players can save, load and resume through original player-facing workflows with faithful checkpoint, task, inventory, health/energy and progression state, preserving required original-format fields.
- [ ] **SAVE-02**: Fresh start, repeated load, scene return and resume reproduce correct retained/reset actor, helper, companion, gadget, script and camera state, verified by equivalent continued gameplay.
### Visual, Animation and Audio Fidelity
- [ ] **VIS-01**: Players see original geometry, textures, model hierarchy/pivots, morphs, sprites, animation and UI layout at faithful authored positions and playback timing.
- [ ] **VIS-02**: Original lighting, materials, fog, texture stages/sampling, blending, alpha/depth/culling and render-layer behavior are reproduced by Vulkan equivalents and compared against identified original references.
- [ ] **VIS-03**: Original gameplay/script cameras, projection, clipping, aspect behavior and transitions reproduce authored presentation without distorting the scene.
- [ ] **AUD-01**: Players hear original music, speech and contextual sound banks/events with faithful selection, timing, channel priority, looping and interruption through gameplay and transitions.
- [ ] **AUD-02**: Players hear faithful volume, panning, attenuation, positional/frequency behavior and listener ownership, validated through physical audible output as well as event/stream checks.
### Full-Game Acceptance and Local Delivery
- [ ] **REL-01**: Players can run clean, self-contained Linux x64 and Windows x64 packages offline with required SDL3/resources/shaders, without development tools, original installation paths or runtime online services.
- [ ] **REL-02**: Current packages pass integrated full campaign/optional-content, input, audio, window/focus/resize/fullscreen and resource-lifecycle checks on native Linux and native Windows, with exact source/package identities and recorded Vulkan diagnostics.
- [ ] **REL-03**: The final discrepancy audit compares the reconstructed game against original reference scenarios across gameplay, timing, visuals, audio and progression; unresolved differences and verification gaps remain explicit and prevent unsupported full-fidelity completion claims.
- [ ] **REL-04**: Maintainers can reproduce local builds/tests/packages and review current evidence, compatibility and known limitations; verified source/tools/docs are pushed to existing Gitea while originals, generated traces and packages stay local.
## Deferred Requirements
No original-required feature category is deferred outside the full reconstruction release. Phase-level deferral only establishes dependency order; unknown original behavior is investigated rather than invented. New-gadget expansion remains behind the current movement/route stabilization gate.
## Out of Scope
| Feature | Reason |
|---------|--------|
| Creative mechanics, replacement movement tuning or visual modernization | Original fidelity governs the reconstruction. |
| Online runtime services, telemetry, cloud CI | Shared native offline implementation and local builds/tests are mandatory. |
| Uploading originals, generated traces or release packages | Source-control authorization covers verified source/tools/docs only. |
| Treating third-party remakes as behavior authority | Only original evidence establishes faithful behavior. |
## Definition of Done
Each requirement requires evidence recovery, integrated implementation, appropriate regressions and runtime verification, and a verified source revision. Preserve source addresses/offsets and complete REA evidence for binary investigations. Native Windows execution is not replaced by Wine or cross-publishing. Component parity is not whole-original execution. Capture comparison tolerances per system with an evidence-backed reason; never assume blanket pixel/bit identity. All original-required content must be accounted for before full-game completion, and unresolved reference/platform access is an open acceptance dependency.
## Traceability
Every v1 requirement maps to exactly one accountable phase. Preservation, evidence capture and fidelity checks continue throughout later phases without duplicating requirement ownership. All statuses begin Pending; existing bounded implementations do not establish full-scope acceptance.
| Requirement | Phase | Status |
|-------------|-------|--------|
| EVID-01 | Phase 1 | Pending |
| EVID-02 | Phase 1 | Pending |
| EVID-03 | Phase 1 | Pending |
| EVID-04 | Phase 1 | Pending |
| MOVE-01 | Phase 2 | Pending |
| MOVE-02 | Phase 2 | Pending |
| MOVE-03 | Phase 2 | Pending |
| MOVE-04 | Phase 2 | Pending |
| MOVE-05 | Phase 2 | Pending |
| ACT-01 | Phase 3 | Pending |
| ACT-02 | Phase 3 | Pending |
| ACT-03 | Phase 3 | Pending |
| GAD-01 | Phase 4 | Pending |
| GAD-02 | Phase 4 | Pending |
| GAD-03 | Phase 4 | Pending |
| GAD-04 | Phase 4 | Pending |
| CAMP-01 | Phase 5 | Pending |
| CAMP-02 | Phase 5 | Pending |
| CAMP-03 | Phase 5 | Pending |
| CAMP-04 | Phase 5 | Pending |
| UI-01 | Phase 6 | Pending |
| UI-02 | Phase 6 | Pending |
| SAVE-01 | Phase 6 | Pending |
| SAVE-02 | Phase 6 | Pending |
| VIS-01 | Phase 7 | Pending |
| VIS-02 | Phase 7 | Pending |
| VIS-03 | Phase 7 | Pending |
| AUD-01 | Phase 7 | Pending |
| AUD-02 | Phase 7 | Pending |
| REL-01 | Phase 8 | Pending |
| REL-02 | Phase 8 | Pending |
| REL-03 | Phase 8 | Pending |
| REL-04 | Phase 8 | Pending |
**Coverage:** 33 v1 requirements; 33 mapped; 0 unmapped; 0 duplicate phase assignments.
---
*Last updated: 2026-11-12 after full-scope research, playable-slice selection and roadmap traceability*
+174
View File
@@ -0,0 +1,174 @@
# Roadmap: Neutron GamePort
## Overview
Complete the remaining original game as faithfully as possible, building on the existing runtime and bounded implementations. Eight delivery boundaries separate reference access, movement ownership, real actor consumers, gadget use, complete progression, player-facing persistence, presentation closure and native acceptance. Each phase uses playable slices: recover the source contract, integrate it into its intended scenario, and verify the resulting behavior. No original-required content is deferred outside this reconstruction.
## Delivery and Evidence Rules
- Preserve the original inventory throughout every phase; use separate generated copies for execution and analysis. Phase 1 owns the preservation baseline; all later phases keep checking it.
- Every acceptance receipt identifies source/package/resource revision and platform. Static recovery, inference, compilation, copied-original component execution, port runtime, Wine and whole-original/native Windows comparisons are distinct.
- Reference access and native Windows verification start in Phase 1 and continue throughout. If access is unavailable, keep EVID-02/EVID-04 and affected comparison criteria open. Phase 2 and other independently source-backed recovery may proceed on the available ledger/baseline; this exception does not mark Phase 1 complete or waive final acceptance.
- Movement stabilization precedes gameplay expansion. Before broader source collision admission, establish actual derived responses, ordered physical membership, helper activation/cleanup and shared mutable reclip. Preserve the lab/outside capsule until its replacement gate closes.
- The TSK-backed first-story startup-order correction is implemented. Preserve it and legitimate landing bank; do not invent orientation resets or substitute third-party movement tuning.
- Rendering, audio, menus and persistence needed by an earlier playable slice are integrated there. Their later owning phase closes full-game coverage rather than authorizing temporary invented behavior.
- Derive comparison tolerances from original evidence per system. Missing comparison evidence stays an acceptance dependency, not a parity claim. REA Evidence and authoritative bytes govern future binary investigations.
## Phases
Integer phases are planned work; decimal phases may be inserted for urgent recovered dependencies. Independent investigations may run in parallel with exclusive ownership, while integration follows the dependencies below.
- [ ] **Phase 1: Reproducible Fidelity Baseline** - Compare identified original and port routes with preserved assets and current native-platform receipts.
- [ ] **Phase 2: Faithful Movement and Scene Handoffs** - Stabilize Jimmy, real contacts, animation and retained ownership in the integrated lab/tutorial/outside route.
- [ ] **Phase 3: Original Actors, Hazards and Combat** - Make intended NPC/enemy encounters and their consequences playable.
- [ ] **Phase 4: Complete Gadget and Vehicle Use** - Acquire and use all original gadgets/vehicles against real consumers across intended lifetimes.
- [ ] **Phase 5: Complete Campaign and Optional Routes** - Traverse all original-required content and reach original outcomes through normal progression.
- [ ] **Phase 6: Original Frontend and Save/Resume** - Use original menus/options and resume equivalent gameplay through player-facing persistence.
- [ ] **Phase 7: Original Visual and Audible Presentation** - Close rendering, playback, camera and sound differences across complete gameplay.
- [ ] **Phase 8: Full-Game Native Acceptance and Delivery** - Verify standalone Linux/Windows packages against original journeys and publish verified source documentation.
## Phase Details
### Phase 1: Reproducible Fidelity Baseline
**Goal:** As a tester, I want to reproduce identified original/port comparison scenarios, so that I understand exactly what the current reconstruction proves on each native platform.
**Mode:** mvp
**Depends on:** Nothing (existing codebase and evidence are the starting point).
**Requirements:** EVID-01, EVID-02, EVID-03, EVID-04
**Success Criteria** (what must be TRUE):
1. A reviewer can verify every original against the recorded inventory and run investigation/reference copies without altering the original installation.
2. A tester can reproduce identified whole-original reference scenarios from an isolated generated installation and inspect corresponding input/events, images and audio where applicable; unavailable execution keeps this criterion open.
3. A reviewer can trace every full-game capability from original evidence through current implementation, platform receipts, discrepancies and its remaining acceptance condition.
4. Testers can repeat the same baseline movement/route scenarios on native Linux and native Windows with exact revision identities; Wine/cross-publish receipts remain separately labeled and cannot close missing native execution.
**Plans:** 7/7 autonomous preparation/reconciliation plans recorded; actual 01-07-02 capture/review and Phase 1 acceptance remain pending.
**Wave 1**
- [x] 01-01-PLAN.md
**Wave 2** *(blocked on Wave 1 completion)*
- [x] 01-02-PLAN.md
- [x] 01-03-PLAN.md
- [x] 01-04-PLAN.md
**Wave 3** *(blocked on Wave 2 completion)*
- [x] 01-05-PLAN.md
**Wave 4** *(blocked on Wave 3 completion)*
- [x] 01-06-PLAN.md
**Wave 5** *(blocked on Wave 4 completion)*
- [x] 01-07-PLAN.md
Autonomous preparation is complete: 11,000 immutable files pass readiness and
the complete local suite passes in 782.05s. Actual task 01-07-02 capture/review
remains human_needed: 0/120 original/native obligations accepted and ten human
findings pending. All EVID requirements remain Pending; Phase 1 is not accepted.
The primary reviews readiness before one combined session. Retained quota
handoff files are historical until primary consumption; the final SUMMARY
records completed task 3 and pending human dependencies. No Phase 2 advancement.
### Phase 2: Faithful Movement and Scene Handoffs
**Goal:** Players move, contact the world and return from scripts/scenes with the original movement, animation, camera and state ownership intact.
**Mode:** mvp
**Depends on:** Phase 1 baseline/ledger and available reference evidence; independently source-backed work may proceed under the access exception above.
**Requirements:** MOVE-01, MOVE-02, MOVE-03, MOVE-04, MOVE-05
**Success Criteria** (what must be TRUE):
1. Players reproduce evidenced Jimmy movement/facing/jump/effect modes using original-supported input devices across tested frame rates without changing significant source arithmetic or timing.
2. Players and participating bodies experience evidenced static/dynamic support, walls, ceilings and special contacts through real responses; full state/event comparisons establish helper membership, live callback reads and shared reclip before any wider solver admission.
3. Movement, landing, talk and control changes accept, interrupt and complete actions/animations with the original clocks and outcomes.
4. Camera/input/control ownership and retained/reset state remain faithful across fresh entry, scripts, pause, LOAD and RETURN, including the implemented TSK startup order and original landing bank.
5. Players complete lab → VR04 → lab → outside with natural/skipped conversations, banked jumps, held input, landing/idle and gadget cleanup; integrated port/native receipts and available original comparisons identify remaining differences explicitly.
**Plans:** TBD
### Phase 3: Original Actors, Hazards and Combat
**Goal:** Players encounter original NPC/enemy behavior and receive the correct gameplay consequences through real scene interactions.
**Mode:** mvp
**Depends on:** Phase 2; actor-specific membership/response contracts must precede each live admission.
**Requirements:** ACT-01, ACT-02, ACT-03
**Success Criteria** (what must be TRUE):
1. Players encounter each original-required NPC/enemy class in its intended scenes with evidenced sensing, movement, action/RNG decisions and animation rather than generic placeholder policies.
2. Combat and hazards produce original health, damage, immunity, death and recovery outcomes for players and affected actors during normal play.
3. Real enter/stay/leave and special interactions produce the correct ordered task, score, control and class-specific effects, including callback mutations and repeated contacts.
**Plans:** TBD
### Phase 4: Complete Gadget and Vehicle Use
**Goal:** Players acquire and use every original gadget and vehicle through intended gameplay paths, consumers and scene lifetimes.
**Mode:** mvp
**Depends on:** Phases 2 and 3; required normal acquisition routes are integrated with each gadget slice before Phase 5 closes complete campaign coverage.
**Requirements:** GAD-01, GAD-02, GAD-03, GAD-04
**Success Criteria** (what must be TRUE):
1. Players acquire/select every original gadget/item through its evidenced normal gameplay path, with original availability, inventory and energy behavior; debug grants alone do not satisfy acquisition.
2. Every gadget can be aimed/activated/fired against its intended actor/object consumers with the evidenced states, projectiles and effects, while already verified bounded features keep working.
3. Players summon, mount, operate and dismount original vehicles in supported modes with faithful input, collision, passenger and camera behavior.
4. Interruptions, death, scripts, LOAD/RETURN and supported save/resume preserve or clear gadget, vehicle and companion state exactly at evidenced lifetime boundaries.
**Plans:** TBD
### Phase 5: Complete Campaign and Optional Routes
**Goal:** Players traverse all original-required campaign and optional content and reach original outcomes through ordinary progression.
**Mode:** mvp
**Depends on:** Phases 2–4; integrate any prerequisite frontend/persistence behavior within each route slice.
**Requirements:** CAMP-01, CAMP-02, CAMP-03, CAMP-04
**Success Criteria** (what must be TRUE):
1. Players enter/traverse every evidenced reachable campaign, optional and practice level using its original assets and correct entrance/exit rules.
2. Authored scripts/cutscenes, missions, tasks, objectives, collectibles and level mechanisms advance in the original order through normal play.
3. Players complete every original campaign route and evidenced optional branch through its original completion/win/loss outcome without debug grants, warps or substituted progression.
4. Reviewers can account for every supplied level/resource as reachable, evidenced unused/unreachable, or an unresolved dependency; missing archives are investigated for actual reachability rather than silently substituted or assumed fatal.
**Plans:** TBD
**UI hint:** yes
### Phase 6: Original Frontend and Save/Resume
**Goal:** Players use the original frontend/options and save/resume completed gameplay with equivalent progression and retained state.
**Mode:** mvp
**Depends on:** Phases 2–5; save/configuration callers needed by earlier slices are recovered and integrated earlier.
**Requirements:** UI-01, UI-02, SAVE-01, SAVE-02
**Success Criteria** (what must be TRUE):
1. Players use original startup, new-game, menu, pause, objective/HUD, prompt and ending flows with evidenced input/timing; modern diagnostics are distinguishable from original UI.
2. Players change and persist original-supported input/display/audio configuration with faithful defaults and bounds.
3. Players save/load/resume through original player-facing workflows with correct checkpoints, tasks, inventory, health/energy and progression, preserving required original-format fields.
4. Fresh start, repeated load, scene return and resumed play preserve the appropriate actor/helper/companion/gadget/script/camera state and produce equivalent continued gameplay, not merely matching serialized bytes.
**Plans:** TBD
**UI hint:** yes
### Phase 7: Original Visual and Audible Presentation
**Goal:** Players see and hear the original authored presentation across complete gameplay, with remaining visual/audio differences resolved through identified comparisons.
**Mode:** mvp
**Depends on:** Phases 2–6 and original reference access from Phase 1; blocking presentation contracts are integrated with earlier slices.
**Requirements:** VIS-01, VIS-02, VIS-03, AUD-01, AUD-02
**Success Criteria** (what must be TRUE):
1. Original geometry, textures, hierarchy/pivots, morphs, sprites, animation and UI appear at faithful authored positions and playback timing in matched gameplay/reference captures.
2. Lighting, materials, fog, texture stages/sampling, blend/alpha/depth/culling and render layers match the evidenced original behavior through Vulkan equivalents, using justified system-specific comparison tolerances.
3. Gameplay/script camera framing, projection, clipping, aspect handling and transitions preserve the authored scene without distortion.
4. Players hear the original music/speech/contextual banks and events with correct timing, priorities, loops and interruption through gameplay and scene changes.
5. Physical audible checks and matched event/listener observations confirm volume, panning, attenuation, positional/frequency behavior and camera/listener ownership; dummy streams alone do not establish fidelity.
**Plans:** TBD
**UI hint:** yes
### Phase 8: Full-Game Native Acceptance and Delivery
**Goal:** Players can run reproducible offline packages on native Linux and Windows and complete the original game with current full-game fidelity evidence.
**Mode:** mvp
**Depends on:** Phases 1–7; all original/native comparison acceptance dependencies must close for full completion.
**Requirements:** REL-01, REL-02, REL-03, REL-04
**Success Criteria** (what must be TRUE):
1. Clean self-contained Linux x64 and Windows x64 packages run offline without SDK/development paths or the original installation, carrying the required SDL3, resources and shaders.
2. Current packages complete integrated campaign/optional-content scenarios and physical input/audio/window/focus/resize/fullscreen/lifecycle checks on both native platforms with exact source/package identities and Vulkan diagnostics.
3. A final original-versus-port discrepancy audit covers gameplay, timing, visuals, audio and progression; unresolved original-required differences or unavailable comparisons remain visible and prevent unsupported full-fidelity completion claims.
4. Maintainers reproduce local builds/tests/packages and find current compatibility/evidence/limitations; verified source/tools/docs are pushed to existing Gitea while originals, generated traces and packages remain local, and original hashes still match.
**Plans:** TBD
## Progress
Execution follows 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8, subject to the explicit reference-access exception and earlier prerequisite integration. Full completion cannot bypass an open phase or acceptance dependency.
| Phase | Plans Complete | Status | Completed |
|-------|----------------|--------|-----------|
| 1. Reproducible Fidelity Baseline | 7/7 preparation | Human acceptance pending (0/120) | - |
| 2. Faithful Movement and Scene Handoffs | 0/TBD | Not started | - |
| 3. Original Actors, Hazards and Combat | 0/TBD | Not started | - |
| 4. Complete Gadget and Vehicle Use | 0/TBD | Not started | - |
| 5. Complete Campaign and Optional Routes | 0/TBD | Not started | - |
| 6. Original Frontend and Save/Resume | 0/TBD | Not started | - |
| 7. Original Visual and Audible Presentation | 0/TBD | Not started | - |
| 8. Full-Game Native Acceptance and Delivery | 0/TBD | Not started | - |
**Coverage:** 33/33 v1 requirements assigned once; all phases have 3–5 observable success criteria. Existing bounded implementation is not counted as phase completion.
---
*Initialized: 2026-11-12 — remaining full reconstruction, playable slices*
+113
View File
@@ -0,0 +1,113 @@
---
gsd_state_version: "1.0"
current_phase: 01
current_phase_name: Reproducible Fidelity Baseline
status: awaiting_human_verification
stopped_at: Phase1 verified human_needed; ten UAT checks and combined actual session pending
last_updated: "2026-11-14T05:39:47.960Z"
last_activity: 2026-11-13
last_activity_desc: 01-07 autonomous preparation verified; actual human acceptance pending 0/120
state_head: febb4a9d98071b19998bcecfab4a236d9c0adfce
progress:
total_phases: 8
completed_phases: 0
total_plans: 7
completed_plans: 7
percent: 0
---
# Project State
## Project Reference
See: .planning/PROJECT.md (updated 2026-11-12)
**Core value:** Match original behavior and presentation as accurately as possible, governed by authoritative evidence and explicit verification.
**Current focus:** Phase 01 — Reproducible Fidelity Baseline
## Current Position
Phase: 01 (Reproducible Fidelity Baseline) — HUMAN ACCEPTANCE PENDING
Plan: 7 of 7
Status: Preparation complete; actual original/native acceptance human_needed
Last activity: 2026-11-13 — Task 3 committed, complete local suite passed in 782.05s; final summary committed.
Progress: [░░░░░░░░░░] 0%
## Performance Metrics
- Autonomous preparation plans recorded: 7/7; accepted phases: 0/8
- Average duration: See per-plan metrics; elapsed intervals include pauses
- Total active execution time: Not continuously measured
| Phase | Plans | Total | Avg/Plan |
|-------|-------|-------|----------|
| - | - | - | - |
Recent trend: All seven preparation/reconciliation records exist; actual task 01-07-02 and Phase 1/EVID acceptance remain open. Existing project work retains its documented bounded evidence.
**Per-Plan Metrics:**
| Plan | Duration | Tasks | Files |
|------|----------|-------|-------|
| Phase 01 P01 | 16 min | 2 tasks | 5 files |
| Phase 01 P02 | 16 min | 2 tasks | 6 files |
| Phase 01 P03 | 22 min | 2 tasks | 4 files |
| Phase 01 P04 | 16 min | 2 tasks | 5 files |
| Phase 01 P05 | 12h 4min | 2 tasks | 7 files |
| Phase 01 P06 | 14 min | 2 tasks | 4 files |
| Phase 01 P07 | 4h 36min elapsed incl quota pause; suite 782.05s | 2 tasks | 16 files |
## Accumulated Context
### Decisions
- Full remaining original game is in scope; fidelity governs behavior and presentation, including significant original quirks.
- Playable slices, standard granularity, autonomous mode and parallel independent plans; research, plan checking and verification enabled; models inherit this session.
- Preserve Jimmy movement and implemented TSK startup-order correction; movement/contact/helper/animation/camera stabilization precedes broader gameplay expansion.
- Cross-cutting checks continue throughout; each requirement has one accountable phase. No original-required category is deferred outside this release.
- Builds/tests/packages stay local; push verified source/tools/docs to existing Gitea. Preserve unrelated working-tree changes.
- [Phase 01]: Version 1 typed hashed receipts keep category, history and actual bytes separate from acceptance; structural readiness never substitutes for native/reference execution.
- [Phase 01]: All eight lifetime/dialogue/input cells require continuous plus four focused obligations on three original/native sides, totaling 120 independently audited obligations.
- [Phase 01]: Retained observations require one session, observed prerequisite departure/return and hashed copy state; each fresh run uses an independent launch/session identity.
- [Phase 01]: Paired review preserves actual speed, separate raw clocks, explicit event and playback drift, exclusive audio and complete recording tails; export never promotes runtime acceptance.
- [Phase 01]: Capability source links are normalized to contained tracked bounded UTF-8 text copies and activated only through exporter-validated local hrefs.
- [Phase 01]: Capability ledger maps all33 requirements and reconciles33 hashed checkpoint rows; documentary coverage, unimplemented work and exact historical content never promote actual original/native acceptance.
- [Phase 01]: One outer observer owns a unique launch/clock identity through Run continuations; simulation ticks remain scene-local and case/session IDs remain declared provenance.
- [Phase 01]: Accepted input means the existing binding's returned gate result, with separately identified post-step ownership; individual command dispatch and independent body/fire work are not inferred.
- [Phase 01]: Observer records are diagnostic source material for later collectors, not receipts or automatic original/native acceptance; fixture classification survives continuations.
- [Phase 01]: READY validates identified offline materials only; original-DxWnd/native Linux/native Windows acceptance remains open 0/120.
- [Phase 01]: Runtime package provenance retains actual completed publish source/dirty/diff identity; selected external tools are identified without redistributing executables.
- [Phase 01]: No display and only auto_null audio yields failed native preflight; all forty Linux obligations retain explicit physical/audible capture dependencies.
- [Phase 01]: Linux matrix history revalidates saved receipt hashes and requires new launch/session IDs; focused captures cannot replace continuous route lifetimes.
- [Phase 01]: Ready materials and local regressions never substitute for actual original/native acceptance; all 120 obligations and ten named human findings remain open.
- [Phase 01]: The integration agent reconciles returned collector records through specified artifact mappings; the tester collects, observes and returns one combined session.
### Pending Todos
Primary readiness review of final 01-07 source/materials, then the single combined human session in docs/evidence/checkpoint-session.md. All EVID requirements remain Pending. Do not launch Phase 2 from preparation counts.
### Blockers/Concerns
- Final 01-07 readiness passes 11,000 immutable files and local suite passes; strict audit still exits 1 with no structural errors, 0/120 accepted obligations and ten pending human findings. This is an actual evidence dependency, not a test failure or auto-approval gate.
- Phase 1: Working whole-original reference capture and current native Windows comparison remain unverified access dependencies. Record limitations; keep acceptance open while independent source-backed recovery continues.
- Phase 2: Real derived responses, helper membership/activation/cleanup, physical order and shared mutable reclip remain live admission gates. Lab/outside capsule stays until its replacement gate closes.
- Full-game completion requires current integrated native Linux/Windows and original-reference evidence. Compilation, copied-original probes and Wine have narrower scopes.
- Historical reports contain superseded narratives; prefer later continuation receipts with exact revision/platform identity. Carl startup ordering is already corrected, not an untouched defect.
### Evidence Pointers
- `.planning/research/SUMMARY.md`, `.planning/codebase/` — scope, dependencies and current architecture.
- `docs/progress.md`, `docs/compatibility.md`, `docs/tasks.md` — implementation/runtime receipts and open work.
- `docs/checkpoint/next-work-plan.md`, `coverage.md`, `implementation-plan.md` — recovery/admission sequence (latter two under the same directory).
- `docs/gameplay/main-menu-player-lifetime.md`, `jimmy-movement-stabilization.md` — preserved correction and movement priority (same directory).
- `../prompt.MD`, `AGENTS.md`, `../AGENTS.md` — authoritative specification/rules; original manifest at `docs/original-manifest.json`.
## Deferred Items
No original-required category deferred outside full reconstruction. Later phases express dependency order only.
## Session Continuity
Last session: 2026-11-14T05:39:45.079Z
Stopped at: Phase1 verified human_needed; ten UAT checks and combined actual session pending
Resume file: .planning/phases/01-reproducible-fidelity-baseline/01-UAT.md
+64
View File
@@ -0,0 +1,64 @@
---
schema_version: 1
open_count: 2
waived_count: 0
fixed_count: 1
total_count: 3
last_updated: 2026-11-13T17:20:49.885Z
---
# Broken Windows Ledger
> Cross-phase defect register. With `workflow.windows_enforce` enabled, `/gsd-ship` blocks while `open_count > 0`.
> Waive with `gsd-tools windows waive <id> "<reason>"` (reason required).
> Mark fixed with `gsd-tools windows fixed <id>`.
| id | phase | kind | file | line | description | status | reason | recorded_at | resolved_at |
|----|-------|------|------|------|-------------|--------|--------|-------------|-------------|
| 1 | 01 | deviation | tests/test_fidelity_sessions.py | | Task 2 also strengthens shared receipt security regressions in the task-1 test file; fixed and verified. | fixed | | 2026-11-13T00:12:34.143Z | 2026-11-13T00:13:04.410Z |
| 2 | 01 | unrun-verify | docs/evidence/linux-session.md | | Actual Linux display, physical-input and audible capture remains open: no display session and only auto_null audio; all 40 Linux obligations await the final combined session. | open | | 2026-11-13T17:02:56.623Z | |
| 3 | 01 | unmet-truth | docs/evidence/phase01-baseline.md | | Actual original-DxWnd/native Linux/native Windows capture and combined human review remain OPEN0/120; strict audit human_needed. | open | | 2026-11-13T17:20:49.885Z | |
````json
[
{
"id": 1,
"kind": "deviation",
"phase": "01",
"file": "tests/test_fidelity_sessions.py",
"line": null,
"description": "Task 2 also strengthens shared receipt security regressions in the task-1 test file; fixed and verified.",
"status": "fixed",
"reason": "",
"recorded_at": "2026-11-13T00:12:34.143Z",
"resolved_at": "2026-11-13T00:13:04.410Z",
"milestone": null
},
{
"id": 2,
"kind": "unrun-verify",
"phase": "01",
"file": "docs/evidence/linux-session.md",
"line": null,
"description": "Actual Linux display, physical-input and audible capture remains open: no display session and only auto_null audio; all 40 Linux obligations await the final combined session.",
"status": "open",
"reason": "",
"recorded_at": "2026-11-13T17:02:56.623Z",
"resolved_at": null,
"milestone": null
},
{
"id": 3,
"kind": "unmet-truth",
"phase": "01",
"file": "docs/evidence/phase01-baseline.md",
"line": null,
"description": "Actual original-DxWnd/native Linux/native Windows capture and combined human review remain OPEN0/120; strict audit human_needed.",
"status": "open",
"reason": "",
"recorded_at": "2026-11-13T17:20:49.885Z",
"resolved_at": null,
"milestone": null
}
]
````
+199
View File
@@ -0,0 +1,199 @@
---
last_mapped_commit: bdca29d3aa31face0c0023537ff98783716dbc45
last_mapped_at: 2026-11-12
---
<!-- refreshed: 2026-11-12 -->
# Architecture
**Analysis Date:** 2026-11-12
## System Overview
```text
Read-only ../Original assets
-> tools/extractors/prepare.py -> artifacts/extracted manifests/buffers/WAV
-> src/GamePort/Assets + original GAM/TSK/ASE/PNG readers
-> Program.Run scene composition
Game simulation/scripts -> Application visuals/HUD -> VulkanRenderer
Game events -> SceneAudio -> SdlAudio -> SDL3
Program.Main -> persistent RenderSession -> SDL window + Vulkan instance/device
```
The desktop application is a single shared Linux/Windows C# executable (`GamePort.csproj`). `src/GamePort/Program.cs` composes concrete systems and owns scheduling. There is no runtime server, database, dependency-injection container, or external game engine.
## Component Responsibilities
| Component | Responsibility | File |
|-----------|----------------|------|
| Application entry | CLI, resource composition, input dispatch, fixed ticks, scene continuation | `src/GamePort/Program.cs` |
| Presentation session | Application lifetime window and renderer; replace scene resources | `src/GamePort/Application/RenderSession.cs` |
| Player simulation | Physics, input/apply order, facing, jump/effects, player camera | `src/GamePort/Game/LabSimulation.cs` |
| Script bridge | Raw control owner, authored transforms, gadget cleanup, vehicle/passenger phases | `src/GamePort/Game/PlayerSceneBinding.cs` |
| Scene director | GAM actors, CAM/MCA/AI chains, cutscene camera, control and issue reporting | `src/GamePort/Game/SceneDirector.cs` |
| Progression | Contacts, inventory, tasks, transitions and save snapshots | `src/GamePort/Game/SceneInteractions.cs`, `src/GamePort/Game/TaskStates.cs` |
| Resource readers | Original and prepared data decoding | `src/GamePort/Assets/` |
| Presentation adapters | Mutable geometry, morphs, sprites, UI and camera projection | `src/GamePort/Application/` |
| GPU backend | Vulkan resources, rendering, resizing, readback and disposal | `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs` |
| Audio | Independent music/speech/effects and SDL WAV stream ownership | `src/GamePort/Audio/SceneAudio.cs`, `src/GamePort/Audio/SdlAudio.cs` |
## Pattern Overview
**Overall:** Explicit application composition with scene-local state, event-connected gameplay systems and a persistent native presentation owner.
**Key Characteristics:**
- Keep scheduling visible in `src/GamePort/Program.cs`; source ordering is behavior, not interchangeable service invocation order.
- Keep recovered arithmetic in focused `src/GamePort/Game/` modules and presentation in `src/GamePort/Application/`.
- Preserve the distinction between isolated recovered components and admitted live scene adapters (`src/GamePort/Game/OriginalPairCollision.cs`, `src/GamePort/Game/OriginalNormalContacts.cs`).
- Use local original-derived assets; Python preparation is a development/package stage (`tools/extractors/prepare.py`, `scripts/package.sh`).
## Layers
**Application composition and presentation:**
- Purpose: Connect input, simulation, scripts, visuals, audio and GPU submission.
- Location: `src/GamePort/Program.cs`, `src/GamePort/Application/`.
- Contains: `RenderSession`, debug interfaces, `SceneHud`, visual adapters and smoke fixtures.
- Depends on: Game, Assets, Audio, Platform and Rendering namespaces.
- Used by: Executable entry and managed regression projects.
**Game state and recovered algorithms:**
- Purpose: Own simulation and script/progression semantics.
- Location: `src/GamePort/Game/`.
- Contains: `LabSimulation`, `SceneDirector`, inventory/tasks, gadgets, vehicles, collision and numeric kernels.
- Depends on: `System.Numerics` and decoded asset types in `src/GamePort/Assets/`.
- Used by: Application orchestration and focused `tests/GamePort.*Tests/` executables.
**Asset decoding:**
- Purpose: Convert bounded original/prepared files into typed CPU resources.
- Location: `src/GamePort/Assets/`.
- Contains: `GamLevel`, `OriginalSave`, `Mesh`, `MorphAnimation`, `PngImage`, resource identities and path resolution.
- Depends on: Filesystem, binary primitives, JSON and numerics; no renderer ownership.
- Used by: Game systems and application/renderer initialization.
**Native platform, GPU and audio:**
- Purpose: Own unmanaged interoperability and device resources.
- Location: `src/GamePort/Platform/Sdl.cs`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`, `src/GamePort/Audio/`.
- Contains: SDL3 imports, Vulkan offscreen/present paths, WAV streams and scene audio orchestration.
- Depends on: SDL3, Silk.NET.Vulkan, shaders and decoded meshes/textures.
- Used by: `src/GamePort/Application/RenderSession.cs` and `src/GamePort/Program.cs`.
**Offline evidence and preparation:**
- Purpose: Inspect source evidence and create reusable resources without modifying originals.
- Location: `tools/binary/`, `tools/extractors/`, `tools/levels/`, `tools/recon/`.
- Contains: Python parsers, extraction manifests, C component probes and observation tools.
- Depends on: Local original files and explicit analysis tooling; not part of the native runtime dependency graph.
- Used by: Tests, local preparation, research and `scripts/package.sh`.
## Data Flow
### Primary Request Path
1. `Program.Main` creates persistent presentation, energy, grappler memory and diagnostics, then invokes the scene runner (`src/GamePort/Program.cs:14`).
2. `Run` resolves originals, loads prepared geometry and original GAM/save data, constructs scene systems and binds the player (`src/GamePort/Program.cs:46`).
3. SDL polling updates held input; unpaused gameplay advances through a 60 Hz accumulator, while bounded fixtures use explicit steps (`src/GamePort/Program.cs:1057`, `src/GamePort/Game/FixedStepClock.cs`).
4. Each tick advances gadget/projectile bodies, player/vehicle binding, timers/targets, interactions/mechanisms, patrols, director and animation state (`src/GamePort/Program.cs:1271`).
5. Application visuals mutate mesh vertices/draw properties, update HUD and select gameplay/script/orbit camera; renderer uploads and renders (`src/GamePort/Program.cs:1371`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`).
### Player and cutscene phase ordering
1. `LabSimulation.Step` runs body physics before registry-style callbacks (`src/GamePort/Game/LabSimulation.cs:265`).
2. Fresh direct-scene input runs before ceiling/floor/facing and player apply. Retained input runs after player/effect updates. `Program` sets `InputAfterPlayerUpdate` for story entry or carried saves (`src/GamePort/Program.cs:361`).
3. Lack of Jimmy control gates input/player apply, not body, facing or owned effect clocks. `PlayerSceneBinding` receives director preparation/transform events and preserves vehicle control ordering (`src/GamePort/Game/PlayerSceneBinding.cs`).
4. Script preparation separates stop-motion, orientation flattening, gadget release and authored transforms; do not replace these with a generic player reset (`src/GamePort/Game/PlayerSceneBinding.cs`, `src/GamePort/Game/SceneDirector.cs`).
### Scene loading and retained state
1. Contact or practice logic requests a `LevelTransition`; application stages a departure/RETURN root through `RuntimeCheckpoint` (`src/GamePort/Program.cs:339`, `src/GamePort/Game/RuntimeCheckpoint.cs`).
2. Scene runner returns a continuation with destination arguments, original-format save snapshot and optional bounded `PlayerLevelState` (`src/GamePort/Program.cs`, `src/GamePort/Game/PlayerLevelState.cs`).
3. `Main` invokes a new scene run. GAM actors, bindings, visual resources and scene audio are rebuilt; `RenderSession.LoadScene` calls `ReplaceScene` on the existing renderer (`src/GamePort/Application/RenderSession.cs`).
4. Vulkan scene replacement waits for device idle and replaces scene GPU resources while retaining presentation identity (`src/GamePort/Rendering/Vulkan/VulkanRenderer.cs:101`).
### Source-to-extracted-assets pipeline
1. `tools/recon/inventory.py` provides original manifest verification against `docs/original-manifest.json`.
2. `tools/extractors/prepare.py` reads OMT/GAM/ASE/PNG and dispatches scene, entity, model, UI, effect and gadget resource extraction. `tools/extractors/omt.py` and `tools/levels/gam.py` retain format-specific parsing.
3. Generated `artifacts/extracted/` contains scene JSON, textures, animation buffers/manifests, entity/model resources, WAV and a scene catalog. Missing scene archives are reported rather than substituted (`tools/extractors/prepare.py`).
4. Runtime readers load prepared resources and original GAM/TSK/base assets; `scripts/package.sh` copies those into local package `scenes/` and `assets/` trees. Runtime packages do not need Python.
**State Management:**
- Application session: presentation, diagnostics preference, `PlayerEnergy` and `GrapplerMemory` are created outside the scene loop (`src/GamePort/Program.cs`).
- Scene: simulation, actors, tasks/inventory, mechanisms, animation meshes, audio and bindings are concrete objects recreated by `Run` (`src/GamePort/Program.cs`).
- Retained route scalars: `PlayerLevelState` supports LV1B/VR04/LEV1 with selected gadget -1 or 3; this is in-memory state, not an extension of TSK (`src/GamePort/Game/PlayerLevelState.cs`).
- Original save persistence: `OriginalSave` encodes TSK tasks/items/checkpoint state; save output uses a temporary file and move outside original assets (`src/GamePort/Assets/OriginalSave.cs`, `src/GamePort/Program.cs`).
## Key Abstractions
**Mesh and MeshDraw:**
- Purpose: CPU geometry, source collision polygons, textures and per-range material/presentation state.
- Examples: `src/GamePort/Assets/Mesh.cs`, `src/GamePort/Application/SceneActorVisuals.cs`.
- Pattern: Arrays plus mutable draw state; visual adapters append/update shared scene data rather than owning Vulkan objects.
**GamEntity and DirectorActor:**
- Purpose: Preserve serialized properties separately from live authored actor state.
- Examples: `src/GamePort/Assets/GamLevel.cs`, `src/GamePort/Game/SceneDirector.cs`.
- Pattern: Bounded typed decoding followed by scene-specific actor/script execution; unknown behavior produces issues.
**Original collision components and live adapters:**
- Purpose: Express bounded source contracts without assuming a complete recovered physical registry.
- Examples: `src/GamePort/Game/OriginalBodyPhysics.cs`, `src/GamePort/Game/OriginalStaticCollision.cs`, `src/GamePort/Game/OriginalPairCollision.cs`, `src/GamePort/Game/OriginalNormalContacts.cs`.
- Pattern: Caller-owned state/accessors and explicit profiles. Pair callbacks and generic normal responses do not establish scene membership or Jimmy's override policy.
## Entry Points
**Native executable:**
- Location: `src/GamePort/Program.cs`.
- Triggers: `dotnet run`, local published executable or package launchers.
- Responsibilities: Scene/model preview, playable story, asset verification, audio/GPU/SDL fixtures and explicit CLI validation.
**Offline preparation:**
- Location: `tools/extractors/prepare.py`.
- Triggers: Local developer invocation and `scripts/package.sh`.
- Responsibilities: Original-derived resource production outside the source installation.
**Regression and build entry points:**
- Location: `scripts/test.sh`, `scripts/build-linux.sh`, `scripts/build-windows.sh`, `tests/GamePort.*Tests/Program.cs`, `tests/test_*.py`.
- Triggers: Local scripts or direct test projects.
- Responsibilities: Bounded source/algorithm/parser checks, GPU fixtures and native packaging inputs. A cross-publish is not native Windows runtime evidence.
## Architectural Constraints
- **Threading:** Gameplay and rendering are explicitly scheduled on the application loop; Vulkan submission/presentation waits synchronously (`src/GamePort/Program.cs`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`). SDL manages audio stream transport (`src/GamePort/Audio/SdlAudio.cs`).
- **Global state:** Native SDL state is process-level; managed session state is explicitly passed. Keep native resource disposal scoped through `RenderSession` and `SdlAudio` (`src/GamePort/Application/RenderSession.cs`, `src/GamePort/Audio/SdlAudio.cs`).
- **Circular imports:** No project-layer circular project-reference chain is detected: production source is compiled into one executable (`GamePort.csproj`). Events intentionally connect director/player/inventory lifetimes (`src/GamePort/Game/PlayerSceneBinding.cs`).
- **Live solver boundaries:** Lab/outside retain capsule compatibility. Original static body is admitted by explicit scene gates including VR01/VR02/VR04/VR07/VR08; VR04 is a bounded source-body scene, not a full dynamic registry (`src/GamePort/Program.cs:361`, `src/GamePort/Game/LabSimulation.cs`).
- **Recovery gates:** `OriginalPairCollision` and `OriginalNormalContacts` are isolated components, not live admission. Physical activation/helper lifetime, actual derived callbacks and shared reclip remain separate obligations (`src/GamePort/Game/OriginalPairCollision.cs`, `src/GamePort/Game/OriginalNormalContacts.cs`, `docs/checkpoint/next-work-plan.md`).
- **Movement priority:** Preserve Jimmy movement and caller-dependent retained cutscene state before gameplay expansion (`AGENTS.md`, `docs/gameplay/jimmy-movement-stabilization.md`).
- **References:** `../Original/` is immutable authoritative evidence; sibling JN-Engine research is a source lead, not a runtime service or replacement movement implementation (`AGENTS.md`, `docs/reviews/jn-engine-survey.md`).
## Anti-Patterns
### Treating component recovery as live scene coverage
**What happens:** Bounded pair/contact components coexist with separately gated runtime solvers (`src/GamePort/Game/OriginalPairCollision.cs`, `src/GamePort/Program.cs`).
**Why it's wrong:** Substituting them solely because component tests pass loses physical registration, activation and real derived callback policies.
**Do this instead:** Preserve explicit scene admission in `src/GamePort/Program.cs` and require the dependencies recorded in `docs/checkpoint/next-work-plan.md` before wiring new actors.
### Collapsing input, control and body phases
**What happens:** `LabSimulation` exposes both fresh and retained callback orders, while scripts independently gate raw control (`src/GamePort/Game/LabSimulation.cs`, `src/GamePort/Game/PlayerSceneBinding.cs`).
**Why it's wrong:** A generic reset or input-first rewrite changes neutral cutscene return, facing and effect behavior.
**Do this instead:** Preserve named preparation events, retained scalar state and `InputAfterPlayerUpdate`; extend focused lifecycle regressions (`tests/GamePort.BodyOwnershipTests/Program.cs`, `tests/GamePort.DirectorTests/Program.cs`).
## Error Handling
**Strategy:** Reject invalid data and native failures explicitly; report unrecovered script behavior without inventing execution (`src/GamePort/Assets/GamLevel.cs`, `src/GamePort/Game/SceneDirector.cs`).
**Patterns:**
- Top-level exception handling prints to stderr and returns 1; validation/fixture failures return 2 (`src/GamePort/Program.cs`).
- Bounded readers throw `InvalidDataException`; missing resources use explicit missing/ambiguous errors (`src/GamePort/Assets/AssetPath.cs`, `src/GamePort/Assets/PreparedEntityResources.cs`).
- SDL/Vulkan failure checks throw with native operation context; cleanup uses `IDisposable`/`finally` (`src/GamePort/Application/RenderSession.cs`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`).
- Director bounded dispatch records unsupported behavior and blocks problematic chains (`src/GamePort/Game/SceneDirector.cs`).
## Cross-Cutting Concerns
**Logging:** Console diagnostics, unrecovered behavior lists and live debug overlays (`src/GamePort/Program.cs`, `src/GamePort/Application/DebugDiagnostics.cs`).
**Validation:** Explicit endian parsing, finite/count/size checks, resource identity validation and Vulkan validation/error counts (`src/GamePort/Assets/GamLevel.cs`, `src/GamePort/Assets/PreparedEntityResources.cs`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`).
**Authentication:** Not applicable; local desktop runtime with no online identity service (`GamePort.csproj`, `src/GamePort/Program.cs`).
---
*Architecture analysis: 2026-11-12*
+143
View File
@@ -0,0 +1,143 @@
---
last_mapped_commit: bdca29d3aa31face0c0023537ff98783716dbc45
last_mapped_at: 2026-11-12
---
# Codebase Concerns
**Analysis Date:** 2026-11-12
Scope: tracked GamePort source and documented findings. Source HEAD is `bdca29d`; integrated SDL/GPU evidence belongs to `bf876e9`, while distributed local packages identify `924ad2f`. These are distinct validation targets, as recorded in `docs/progress.md` and `docs/compatibility.md`. This mapping performs no new builds, tests, binary execution or runtime comparison.
## Tech Debt
**Standalone collision contracts await supported live admission:**
- Issue: `OriginalPairCollision` requires caller-owned physical order and real callbacks; `OriginalNormalContacts` implements inherited response without providing Jimmy's override or scene admission. Dynamic/static composition remains test-only.
- Files: `src/GamePort/Game/OriginalPairCollision.cs`, `src/GamePort/Game/OriginalNormalContacts.cs`, `src/GamePort/Game/DynamicSceneCollision.cs`, `tests/GamePort.ActorContactTests/Program.cs`, `docs/checkpoint/actor-normal-contacts.md`.
- Impact: passing component snapshots cannot establish general NPC interaction, live dynamic collision or game/task side effects. Replacing existing collision directly would skip unresolved owners.
- Fix approach: recover soldier complete174 and helper membership/order first; then bind a bounded response adapter to explicitly supported actor states. Preserve late inhibition, radius, geometry and42C reads. Do not cache pre-callback fields or apply inherited reflection to Jimmy ordinary374.
**Physical registration and retained helper lifecycle are incomplete:**
- Issue:72 serialized VR04 records/13 interfaces and21 helper edges establish source construction/registration contracts, not a full active body list. Common append permits duplicate pointers, Jimmy49E guards its whole bridge, and per-object Init/PostLoad visits newly appended tails.
- Files: `docs/checkpoint/physical-registration.md`, `docs/checkpoint/vr04-generated-bodies.md`, `docs/checkpoint/dynamic-context.md`, `tools/binary/physical_registration.py`, `tools/binary/helper_teardown.py`.
- Impact: constructor-only helpers, Jeep child cleanup, activation and LOAD/RETURN reuse can change physical order and contact effects. Counting serialized records or deduplicating registration would misrepresent the original.
- Fix approach: trace actual helper removal/re-entry/activation and cleanup mutations across fresh load, retained load and RETURN. Compare complete ordered registry snapshots before enabling additional physical members.
**Compatibility adapters remain explicit movement boundaries:**
- Issue: the lab/outside capsule, floor-derived visual sole correction and fixed60Hz scheduling are port policies. Bounded source-body integration does not cover every special material or dynamic actor path.
- Files: `src/GamePort/Game/LabSimulation.cs`, `src/GamePort/Game/SceneCollision.cs`, `src/GamePort/Game/FixedStepClock.cs`, `src/GamePort/Game/OriginalBodyPhysics.cs`, `docs/gameplay/jimmy-movement-stabilization.md`, `docs/checkpoint/body-contact-implementation.md`.
- Impact: existing navigation/playability and recovered scalar motion are not full original-body or scheduler parity.
- Fix approach: retain the current Jimmy baseline while recovering successful hazard/FENCE/LADDER paths, support ownership, actor mode/facing and real callback publication. Use original evidence to replace one named adapter at a time; JN-Engine replacement movement is not authoritative.
**Partial camera/audio/UI/save ownership:**
- Issue: the coverage ledger identifies separate scripted/chase eyes, merged clip policy, independent file-based audio streams, a subset of objective/UI dispatch and a fresh-director save-load path that differs from original repeated task/entity callbacks.
- Files: `docs/checkpoint/coverage.md`, `src/GamePort/Application/OrbitCamera.cs`, `src/GamePort/Audio/SceneAudio.cs`, `src/GamePort/Game/ObjectivePanel.cs`, `src/GamePort/Game/SceneDirector.cs`, `src/GamePort/Assets/OriginalSave.cs`.
- Impact: recovered route behavior does not establish arbitrary save/load, full camera handoff, audio bank/clock lifecycle or all UI flags.
- Fix approach: follow the ownership/probe gates in `docs/checkpoint/next-work-plan.md`; recover dispatcher transitions and repeated callbacks before expanding UI, progression or gadget behavior.
## Known Bugs
**No newly reproduced runtime bug in this source-only mapping:**
- Symptoms: current docs retain earlier failure narratives alongside resolved checkpoint entries. The post-Carl neutral-bank failure has a supported TSK startup ordering correction and documented first-input/300-idle regression results; it must not be listed as an unfixed current bug.
- Files: `docs/progress.md`, `docs/tasks.md`, `docs/compatibility.md`, `docs/gameplay/main-menu-player-lifetime.md`, `docs/checkpoint/coverage.md`.
- Trigger: the corrected path is successful TSK story entry, whose retained background Jimmy precedes new level input; direct fresh-GAM ordering is a separate case.
- Workaround: preserve the correction and fresh/retained distinction. Ordinary landing residual bank is user-confirmed original behavior; do not add a universal leveling/reset workaround. Whole-original Carl comparison remains unverified.
## Security Considerations
**Preservation and generated-probe isolation:**
- Risk: extraction or instrumentation directed into originals could destroy authoritative evidence; incorrect relocation operands can invalidate a copied-code experiment.
- Files: `AGENTS.md`, `tools/binary/actor_contact.py`, `tools/recon/inventory.py`, `docs/original-manifest.json`, `docs/checkpoint/actor-normal-contacts.md`.
- Current mitigation: the actor-contact generator rejects overlapping original/output directories and generated symlinks; reviewed operands, complete source/probe identities and completion markers guard capture acceptance. The documented cross-instruction relocation failure affects an invalid private probe, not original behavior.
- Recommendations: retain operand-specific regression guards and hash verification; keep invalid partial captures excluded. Never execute or patch original files in place.
**Local asset parsing and path boundary:**
- Risk: malformed local assets require bounded decoding, and portable case lookup must reject ambiguous names rather than silently load another file.
- Files: `src/GamePort/Assets/AssetPath.cs`, `src/GamePort/Assets/GamLevel.cs`, `src/GamePort/Assets/PngImage.cs`, `tests/GamePort.DataTests/Program.cs`, `tests/test_extractors.py`.
- Current mitigation: paths reject dot/parent components and require one case-insensitive match; GAM validates counts, remaining spans, finite scalars and duplicate properties; image parsing enforces supported formats and size limits.
- Recommendations: preserve these checks when adding formats and test malformed/truncated inputs. This source review identifies no reproduced exploit and makes no claim that these checks constitute a general filesystem sandbox.
## Performance Bottlenecks
**No measured bottleneck established by this mapping:**
- Problem: pair enumeration and source cell/FIFO traversal have scaling costs, but there is no new timing measurement here.
- Files: `src/GamePort/Game/OriginalPairCollision.cs`, `src/GamePort/Game/OriginalStaticCollision.cs`, `src/GamePort/Application/DebugDiagnostics.cs`.
- Cause: `Step` enumerates an upper triangular body list, giving quadratic candidate growth; static traversal deliberately retains cell duplicates and retries. This is source complexity evidence, not a measured live slowdown; the pair component is not live.
- Improvement path: measure candidate counts, NodeVisits, TriangleTests and frame timings on supported scenes before optimizing. Preserve asymmetric exclusions, duplicate visits, tie order and callback timing; do not introduce an order-changing broadphase without equivalence evidence.
## Fragile Areas
**Callback-mutated context and late getters:**
- Files: `src/GamePort/Game/OriginalNormalContacts.cs`, `src/GamePort/Game/OriginalStaticCollision.cs`, `tests/GamePort.ActorContactTests/Program.cs`, `docs/checkpoint/dynamic-reclip.md`, `docs/checkpoint/actor-normal-contacts.md`.
- Why fragile: callbacks can alter inhibition/radius/geometry/force state before reclip; retained last polygon can issue another callback; final local-root publication can overwrite callback root edits. Getter timing is observable behavior.
- Safe modification: retain accessor order, independent state channels, XYZ/full-Vec4 setter distinctions and explicit context ownership. Test full snapshots/event order rather than final root alone.
- Test coverage:30 normal-contact fixtures include synthetic mutations. They do not execute real soldier174/Jimmy204 policy or establish reentrant linked-list mutation.
**Source arithmetic and finite-domain boundaries:**
- Files: `src/GamePort/Game/OriginalSphereResponse.cs`, `src/GamePort/Game/OriginalHeading.cs`, `src/GamePort/Game/OriginalNormalContacts.cs`, `src/GamePort/Game/OriginalStaticCollision.cs`, `docs/checkpoint/dynamic-reclip.md`.
- Why fragile: float-store boundaries, source triangle winding, heading wrap and strict comparisons affect complete state even where final positions agree. Double intermediates are not a universal x87 emulator.
- Safe modification: require original instruction/store evidence and exact fixture comparisons for arithmetic changes. Keep unsupported zero-horizontal normalization explicit instead of silently inventing a policy.
- Test coverage: populated reclip has14 complete observations/12 kernel steps; inherited normal response has30 bounded snapshots. Degenerate inputs, arbitrary normals and broad x87 equivalence are not certified.
**Story entry and ordinary landing:**
- Files: `src/GamePort/Program.cs`, `src/GamePort/Game/LabSimulation.cs`, `docs/gameplay/main-menu-player-lifetime.md`, `docs/gameplay/jimmy-landing-rotation-source.md`.
- Why fragile: TSK-backed retained order and fresh direct-scene order differ; a generic neutral-angle reset would erase legitimate landing bank while masking scheduler errors.
- Safe modification: preserve first-story retained player-before-input classification and baseline movement algorithms. Recheck first resumed neutral frame, sustained idle, held input, Left/Right bank, natural completion/skip and repeated scenes after lifecycle changes.
- Test coverage: eight managed trajectories and integrated Linux evidence are documented; original full Carl runtime and current native Windows comparison remain separate gaps.
## Scaling Limits
**Bounded solver contracts:**
- Current capacity: `OriginalStaticCollision.Move` permits256 retries and throws beyond its verified finite-motion domain; `OriginalPairCollision.Step` requires a stable input list during the pass.
- Files: `src/GamePort/Game/OriginalStaticCollision.cs`, `src/GamePort/Game/OriginalPairCollision.cs`.
- Limit: source recursive retry behavior and callback-driven linked-list insertion/deletion are not fully represented by these bounded APIs. The256 guard is an implementation boundary, not measured original capacity.
- Scaling path: recover problematic repeated-contact cases and list-mutation semantics before widening the contract; preserve explicit failure rather than return an invented final position.
**Scene admission is deliberately restricted:**
- Current capacity: static route construction admits LV1B, VR01, VR02, VR04, VR05, VR07, VR08 and LEV1; this is not a claim of complete gameplay in those eight scenes. Prepared resources cover33 available scenes according to the project ledger.
- Files: `src/GamePort/Game/OriginalStaticCollision.cs`, `docs/tasks.md`, `docs/checkpoint/coverage.md`.
- Limit: asset availability and class binding do not establish live physics, AI or progression coverage in other scenes.
- Scaling path: recover scene-specific consumers and ownership before broadening admission; keep unsupported scenes on their documented compatibility path.
## Dependencies at Risk
**No package-specific obsolescence or migration risk established:**
- Risk: this mapping provides no evidence that .NET10, SDL3 or Silk.NET.Vulkan requires replacement. The material dependency is runtime/platform validation, not a speculative package migration.
- Files: `GamePort.csproj`, `scripts/build-windows.sh`, `scripts/package.sh`, `docs/compatibility.md`.
- Impact: a successful Windows cross-publish and resource match do not establish current native Windows execution, audible behavior or driver compatibility.
- Migration plan: not applicable. Run the same route/control/window/audio scenarios on native Windows and record exact source/package identity before claiming platform equivalence.
## Missing Critical Features
**Real derived actor response and game/task contact consumers:**
- Problem: soldier409590 mode10 calls complete174→4098C0, whose RNG/target/action policy is not executed by the bounded fixture; Jimmy204 is likewise a record-only endpoint. Enter/stay/leave gameplay consumers remain separate from normal response.
- Files: `docs/checkpoint/actor-normal-contacts.md`, `tools/binary/actor_contact.py`, `tests/GamePort.ActorContactTests/Program.cs`, `docs/tasks.md`.
- Blocks: general dynamic actor admission and faithful enemy/contact behavior. Recover complete caller/callee state and RNG progression before wiring supported adapters.
**Full reconstruction beyond bounded playable routes:**
- Problem: animation playback/completion/interrupt timing, shared camera/input ownership, full audio bank lifecycle, arbitrary retained LOAD/save and broader progression remain open in the coverage ledger. New gadget expansion is paused behind movement/core-system gates.
- Files: `docs/checkpoint/coverage.md`, `docs/checkpoint/next-work-plan.md`, `docs/tasks.md`, `docs/gameplay/jimmy-movement-stabilization.md`.
- Blocks: full-game completion and blanket fidelity claims. Prioritize the interacting lab→VR04→lab→outside route and remove specific documented assumptions with original evidence.
## Test Coverage Gaps
**Whole-original gameplay comparison and native Windows:**
- What's not tested: current source as a complete original-game Carl sequence and native Windows equivalent of the integrated Linux route. Black-frame original Wine startup/allocation observations do not supply visual gameplay comparison; earlier Wine64 port evidence belongs to `ea04210`.
- Files: `docs/compatibility.md`, `docs/gameplay/original-startup-diagnostic.md`, `docs/gameplay/main-menu-player-lifetime.md`, `docs/reference-testing.md`.
- Risk: component correctness and Linux replay success can coexist with differences in original timing, visuals, audio and Windows behavior.
- Priority: High. Capture a working copied-original banked-entry/skip/neutral-return interval and native Windows route evidence, identifying exact binaries and limitations.
**Real helper lifecycle and reentrant collision integration:**
- What's not tested: full fresh/retained active physical lists, helper cleanup/re-entry during LOAD/RETURN, real soldier RNG response, actual contact-driven task mutations and callback list mutation during a pair pass.
- Files: `tests/GamePort.PairLifecycleTests/Program.cs`, `tests/GamePort.ActorContactTests/Program.cs`, `docs/checkpoint/physical-registration.md`, `docs/checkpoint/vr04-generated-bodies.md`, `docs/checkpoint/actor-normal-contacts.md`.
- Risk: synthetic endpoint and stable-list tests can pass while real admission produces incorrect order or side effects.
- Priority: High. Add original-supported complete ordered-state fixtures, then bounded integration regressions before enabling actors.
**Source/package evidence divergence:**
- What's not tested: latest standalone normal-contact source changes as a new SDL/GPU/native Windows package checkpoint. Current source `bdca29d`, integrated runtime `bf876e9` and packaged `924ad2f` must remain separately identified.
- Files: `docs/progress.md`, `docs/compatibility.md`, `scripts/package.sh`.
- Risk: citing earlier package readbacks as verification of later source overstates coverage.
- Priority: Medium. At the next authorized integration checkpoint, validate the complete intended source, rebuild clean packages and record identities, resource hashes and platform-specific execution receipts.
---
*Concerns audit: 2026-11-12*
+121
View File
@@ -0,0 +1,121 @@
---
last_mapped_commit: bdca29d3aa31face0c0023537ff98783716dbc45
last_mapped_at: 2026-11-12
---
# Coding Conventions
**Analysis Date:** 2026-11-12
## Naming Patterns
**Files:**
- Use PascalCase C# filenames matching the principal type: `src/GamePort/Assets/GamLevel.cs`, `src/GamePort/Game/OriginalNormalContacts.cs`.
- Use snake_case Python modules and `test_*.py` regressions: `tools/extractors/sound_bank.py`, `tests/test_actor_contact.py`.
- Keep shell entry points under `scripts/`, using descriptive hyphenated names such as `scripts/test-window-transitions.sh`.
**Functions:**
- Use PascalCase C# methods (`ReadVelocity`, `GenericWall`) as in `src/GamePort/Game/OriginalNormalContacts.cs`.
- Use snake_case Python functions (`export_sound_bank`, `validate_output`) as in `tools/extractors/sound_bank.py` and `tools/extractors/omt.py`.
- Name Python test methods `test_<behavior>`; `tests/test_extractors.py` names invalid-input cases explicitly.
**Variables:**
- Use camelCase C# parameters and locals, with explicit role names such as `headingUnits`, `oldHeading`, `carriedPlayer` in `src/GamePort/Game/OriginalNormalContacts.cs` and `src/GamePort/Program.cs`.
- Private C# fields do not uniformly use underscore prefixes; match the surrounding module (`src/GamePort/Assets/GamLevel.cs`).
- Python locals use snake_case; module constants use uppercase (`ROOT`, `ORIGINAL`, `CALLBACK_OPERANDS` in `tests/test_actor_contact.py`).
**Types:**
- Use PascalCase C# classes/records and `I`-prefixed interfaces, exemplified by `OriginalNormalContacts` and `IOriginalNormalBody` in `src/GamePort/Game/OriginalNormalContacts.cs`.
- Python uses PascalCase classes and frozen dataclasses for resource identity (`Reader`, `Entry`, `FormatError` in `tools/extractors/omt.py`).
## Code Style
**Formatting:**
- No tracked formatter or `.editorconfig` is detected in the mapped repository. Follow each file's existing style rather than assuming an enforced formatter (`GamePort.csproj`, `src/GamePort/Assets/GamLevel.cs`).
- C# generally uses four spaces, file-scoped namespaces and braces on separate lines; short guards and expression-bodied helpers are common. Some numerical modules and console tests use compact spacing (`src/GamePort/Game/OriginalNormalContacts.cs`, `tests/GamePort.JimmyGroundTests/Program.cs`).
- Python uses four spaces, type annotations where useful, and compact reader helpers; quotation style varies (`tools/extractors/omt.py`, `tools/extractors/sound_bank.py`).
**Linting:**
- Dedicated C#/Python lint configurations are Not detected. `GamePort.csproj` enables nullable references, implicit usings and unsafe blocks; it does not declare warnings-as-errors or a separate analyzer package.
- Preserve explicit compile globs and shader copy rules in `GamePort.csproj`; test projects can compile production source directly, as in `tests/GamePort.ActorContactTests/GamePort.ActorContactTests.csproj`.
## Import Organization
**Order:**
1. C# explicit `System` namespaces precede project namespaces in `src/GamePort/Program.cs` and `tests/GamePort.ActorContactTests/Program.cs`.
2. Group runtime dependencies by namespace; implicit usings supply common base namespaces (`GamePort.csproj`).
3. Python standard library imports precede local tool imports. Tests insert the relevant tools directory into `sys.path` (`tests/test_extractors.py`, `tests/test_actor_contact.py`).
**Path Aliases:**
- No frontend-style aliases are applicable. Use `GamePort.Assets`, `GamePort.Game` and related C# namespaces; Python tool imports resolve from explicit local paths (`src/GamePort/Program.cs`, `tests/test_actor_contact.py`).
## Error Handling
**Patterns:**
- Fail malformed assets with contextual format exceptions, including offsets. Do not silently truncate or accept trailing bytes (`src/GamePort/Assets/GamLevel.cs`, `tools/extractors/omt.py`).
- Reject unsupported recovered behavior explicitly with `NotSupportedException`; validate nonfinite values separately with argument exceptions (`src/GamePort/Game/OriginalNormalContacts.cs`).
- Keep entry-point failure reporting centralized: `src/GamePort/Program.cs` catches exceptions, writes to stderr and returns status 1.
- Resolve original asset names case-insensitively after direct lookup, reject `.`/`..`, and reject missing/ambiguous matches (`src/GamePort/Assets/AssetPath.cs`).
- Reject extraction output overlapping originals; preserve source hashes and archive identities in generated metadata (`tools/extractors/sound_bank.py`).
Representative bounded C# reader from `src/GamePort/Assets/GamLevel.cs`:
```csharp
public ReadOnlySpan<byte> Take(int length)
{
if (length < 0 || length > Remaining)
throw new InvalidDataException($"Truncated GAM at {Offset:x}");
var result = data.Slice(Offset, length);
Offset += length;
return result;
}
public uint U32() => BinaryPrimitives.ReadUInt32BigEndian(Take(4));
```
## Logging
**Framework:** Console output, with explicit application diagnostics; no hosted logging service is detected (`src/GamePort/Program.cs`, `src/GamePort/Application/DebugDiagnostics.cs`).
**Patterns:**
- Report fatal errors to `Console.Error`; expose inspection/smoke commands and readback paths through CLI options (`src/GamePort/Program.cs`).
- Tests print descriptive `PASS` messages and throw on failure (`tests/GamePort.ActorContactTests/Program.cs`).
- Persist verification scope and limitations in `docs/progress.md`, `docs/compatibility.md` and subsystem reports; console success alone does not establish whole-game equivalence.
## Comments
**When to Comment:**
- Explain original addresses, ownership, sampled field order and excluded behavior rather than restating arithmetic (`src/GamePort/Game/OriginalNormalContacts.cs`).
- Preserve concrete resource semantics: effect IDs are archive identities, and encoded audio preservation is separate from decoder support (`tools/extractors/sound_bank.py`).
- Keep recovered contracts distinct from approximations and runtime admission; `AGENTS.md` and `docs/checkpoint/actor-normal-contacts.md` make these evidence boundaries explicit.
**XML documentation / Python docstrings:**
- Use C# `/// <summary>` for bounded public contracts and interfaces (`src/GamePort/Game/OriginalNormalContacts.cs`).
- Use Python module/class docstrings for recovery purpose and failure semantics (`tools/extractors/omt.py`). JSDoc/TSDoc is Not applicable.
## Function Design
**Size:**
- Prefer focused components such as the ceiling/reflection helpers in `src/GamePort/Game/OriginalNormalContacts.cs`; no numerical line-count rule is detected. `src/GamePort/Program.cs` remains a substantial orchestration entry point.
**Parameters:**
- Use explicit vectors, typed state and named flags rather than hidden scene state in recovered algorithms (`src/GamePort/Game/OriginalNormalContacts.cs`, `tests/GamePort.JimmyGroundTests/Program.cs`).
- Inject actor-owned accessors through interfaces where read order matters; do not cache values across callbacks without evidence (`IOriginalNormalBody` in `src/GamePort/Game/OriginalNormalContacts.cs`).
- Keep bounded readers over spans/bytes and explicitly choose endianness (`src/GamePort/Assets/GamLevel.cs`, `tools/extractors/omt.py`).
**Return Values:**
- Return parsed records, typed state, or explicit metadata; throw for malformed/unsupported input (`src/GamePort/Assets/GamLevel.cs`, `tools/extractors/sound_bank.py`).
- Preserve float-store boundaries and intentional double intermediates in recovered math. Do not simplify formulas or clamp source values without evidence (`src/GamePort/Game/OriginalNormalContacts.cs`, `docs/checkpoint/dynamic-reclip.md`).
## Module Design
**Exports:**
- Keep asset decoding in `src/GamePort/Assets/`, recovered algorithms in `src/GamePort/Game/`, SDL interop in `src/GamePort/Platform/Sdl.cs`, and presentation in `src/GamePort/Application/`.
- Python tools expose importable parser/export functions as well as CLI-oriented modules (`tools/extractors/omt.py`, `tools/extractors/sound_bank.py`).
- Use `using`/disposal and explicit native ownership at runtime boundaries (`src/GamePort/Program.cs`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`); follow the project requirement in `AGENTS.md`.
**Barrel Files:**
- Not detected / Not applicable. C# namespaces and project compile includes provide organization (`GamePort.csproj`).
- Project-local agent skill constraints: the configured agent-skill query is empty; the applicable project constraints are in `AGENTS.md`.
---
*Convention analysis: 2026-11-12*
+92
View File
@@ -0,0 +1,92 @@
---
last_mapped_commit: bdca29d3aa31face0c0023537ff98783716dbc45
last_mapped_at: 2026-11-12
---
# External Integrations
**Analysis Date:** 2026-11-12
## APIs & External Services
**Game runtime:**
- No hosted runtime service is required; offline operation and no telemetry are requirements in `AGENTS.md`. Runtime entry/configuration and resource loading reside in `src/GamePort/Program.cs`.
- Vulkan is a local native graphics API, accessed through Silk.NET.Vulkan/KHR/EXT `2.23.0` (`GamePort.csproj`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`). Authentication: not applicable.
- SDL3 is a local native window/input/audio API, accessed through project P/Invoke (`src/GamePort/Platform/Sdl.cs`, `src/GamePort/Audio/SdlAudio.cs`). Authentication: not applicable.
**Dependency acquisition (development only):**
- Microsoft SDK archives, SDL release archives and optional Ubuntu packages are downloaded by `scripts/bootstrap.sh`; the SDK and SDL archive hashes are pinned there.
- NuGet resolves managed packages through `dotnet restore` in `scripts/bootstrap.sh`, with direct versions in `GamePort.csproj` and resolved dependencies in `packages.lock.json`.
- These download sources are build-time inputs, not runtime asset storage or telemetry destinations (`scripts/bootstrap.sh`, `AGENTS.md`).
**Local reverse-engineering tools:**
- `scripts/rea.sh` launches local REA with Ghidra/full JDK prerequisites. `tools/binary/rea_decompile_batch.py` communicates using local stdio JSON-RPC and saves complete replies/Evidence separately from originals.
- Use generated target copies; the batch wrapper rejects original-directory targets and output (`tools/binary/rea_decompile_batch.py`). This is developer analysis infrastructure, not game networking.
## Data Storage
**Databases:**
- No database server, ORM or connection-string configuration is detected in the runtime/project manifest; assets and game data are read through local readers (`GamePort.csproj`, `src/GamePort/Assets/GamLevel.cs`, `src/GamePort/Assets/OriginalSave.cs`).
**File Storage:**
- Local filesystem only: source assets are selected by `--assets` or discovery of `Original`/`original`/`assets` directories; use case-insensitive bounded path resolution in `src/GamePort/Assets/AssetPath.cs`.
- Local prepared scene/animation/entity JSON, binary mesh/texture data and WAV files are emitted by `tools/extractors/prepare.py`; its default output is `artifacts/extracted`.
- `scripts/package.sh` copies required original assets and prepared resources into local package `assets/`, `scenes/` and `audio/` directories. Original files remain separate and byte-identical (`AGENTS.md`).
- Original-format TSK checkpoint reads/writes are exposed through `--load-save` and `--write-save`; output is kept outside assets, with temporary-file replacement in `src/GamePort/Program.cs` and encoding in `src/GamePort/Assets/OriginalSave.cs`.
- Debug checkpoint defaults to `debug-checkpoint.tsk` beside the executable; the debug smoke path is separate in `src/GamePort/Program.cs`. These are checkpoint/progression snapshots, not arbitrary full live-game saves (`README.md`).
**Caching:**
- Local generated SDK/dependency/prepared-resource caches only: `scripts/env.sh` configures `.nuget/packages` and local SDK paths; `tools/extractors/prepare.py` manages prepared output.
- No distributed cache or hosted asset cache is declared in `GamePort.csproj` or `scripts/package.sh`.
## Authentication & Identity
**Auth Provider:**
- None for the game runtime; no account/login integration is configured in `src/GamePort/Program.cs` or `GamePort.csproj`.
- Gitea source-control authentication is outside runtime configuration. `AGENTS.md` authorizes pushing completed, verified source commits to existing `Gitea`, with `main` tracking `Gitea/main`; do not embed credentials in documentation.
## Monitoring & Observability
**Error Tracking:**
- No external error-tracking service is declared in `GamePort.csproj`. Top-level exceptions print to stderr and exit unsuccessfully in `src/GamePort/Program.cs`.
- Optional local Khronos validation output uses `VK_LAYER_KHRONOS_validation` and EXT debug utils; errors increment a renderer counter and messages print to stderr in `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`.
**Logs:**
- Console runtime/resource/audio/smoke diagnostics in `src/GamePort/Program.cs` and `src/GamePort/Audio/SdlAudio.cs`.
- In-process live diagnostics/debug overlay in `src/GamePort/Application/DebugDiagnostics.cs` and `src/GamePort/Application/DebugMenuOverlay.cs`; GPU readback screenshots are local outputs exposed by `src/GamePort/Program.cs`.
- Analysis evidence is written locally by `tools/binary/rea_decompile_batch.py`; current validation scope and provenance are recorded in `docs/compatibility.md` and `docs/progress.md`.
## CI/CD & Deployment
**Hosting:**
- Native local executables, not a hosted application: `scripts/build-linux.sh` and `scripts/build-windows.sh` publish self-contained platform binaries; `scripts/package.sh` assembles local packages and launchers.
- Native SDL is bundled; the host supplies a Vulkan 1.3 graphics loader/driver (`GamePort.csproj`, `scripts/package.sh`).
- Existing Gitea remote is for verified source commits only; original assets and generated packages must not be uploaded (`AGENTS.md`). Workspace `../.git` is reserved; project Git operations belong to `GamePort/` (`../AGENTS.md`).
**CI Pipeline:**
- Local scripts only: `scripts/test.sh`, `scripts/test-window-transitions.sh`, `scripts/build-linux.sh`, `scripts/build-windows.sh`, `scripts/package.sh`.
- No cloud CI is desired or authorized (`AGENTS.md`, `../prompt.MD`). This absence is intentional.
- Cross-publish success does not establish native Windows runtime behavior; retain the scope distinctions in `docs/compatibility.md`.
## Environment Configuration
**Required env vars:**
- No runtime service keys or credentials required (`AGENTS.md`, `src/GamePort/Program.cs`).
- Development shell setup exports `DOTNET_CLI_HOME`, `DOTNET_CLI_TELEMETRY_OPTOUT`, `DOTNET_SKIP_FIRST_TIME_EXPERIENCE` and `NUGET_PACKAGES`; conditionally sets `DOTNET_ROOT`, `PATH`, `LD_LIBRARY_PATH`, `VK_LAYER_PATH` (`scripts/env.sh`).
- Test audio can use `SDL_AUDIODRIVER=dummy` (`scripts/test.sh`).
- Local analysis launcher uses `GHIDRA_INSTALL_DIR`, `JAVA_HOME`, `NEUTRON_REA_JAVA_HOME`, `NEUTRON_REA_NODE` and `NEUTRON_REA_LAUNCHER` (`scripts/rea.sh`). These are developer tool selectors, not game configuration.
**Secrets location:**
- No runtime secret store is required (`AGENTS.md`). Source-control credentials remain external to runtime and this map.
- `scripts/rea.sh` optionally sources ignored `.tools/rea.env`; only the launcher reference is inspected, not the environment file contents.
## Webhooks & Callbacks
**Incoming:**
- No HTTP webhook endpoints are declared in `GamePort.csproj` or `src/GamePort/Program.cs`. SDL events and Vulkan validation callbacks are local API callbacks (`src/GamePort/Platform/Sdl.cs`, `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`).
**Outgoing:**
- No runtime webhooks are declared in `src/GamePort/Program.cs` or `GamePort.csproj`. Development dependency downloads and source pushes are separate workflows (`scripts/bootstrap.sh`, `AGENTS.md`).
---
*Integration audit: 2026-11-12*
+91
View File
@@ -0,0 +1,91 @@
---
last_mapped_commit: bdca29d3aa31face0c0023537ff98783716dbc45
last_mapped_at: 2026-11-12
---
# Technology Stack
**Analysis Date:** 2026-11-12
## Languages
**Primary:**
- C# targeting `net10.0` for the shared executable and managed regression programs; no explicit `LangVersion` override is declared in `GamePort.csproj` or `tests/GamePort.DataTests/GamePort.DataTests.csproj`.
**Secondary:**
- Python 3 for local asset preparation, binary evidence tooling and unittest regressions in `tools/` and `tests/`; `docs/dependencies.md` records Python 3.12. These tools are not runtime requirements.
- Bash for local dependency setup, builds, tests and packaging in `scripts/`.
- GLSL vertex/fragment shaders compiled to SPIR-V in `src/GamePort/Rendering/Shaders/mesh.vert` and `src/GamePort/Rendering/Shaders/mesh.frag`.
- C for isolated original-component probes such as `tools/binary/actor_contact_probe.c`; do not treat probe code as the game runtime.
## Runtime
**Environment:**
- .NET 10 executable, with invariant globalization, nullable analysis, implicit usings and unsafe interop enabled in `GamePort.csproj`.
- SDK selection: `global.json` requests `10.0.100`, permits `latestFeature` roll-forward and disables prerelease SDKs. `scripts/bootstrap.sh` downloads SDK `10.0.402` with a pinned SHA-256.
- `docs/dependencies.md` records self-contained runtime pack `10.0.13`; verify generated publish metadata when establishing package provenance rather than equating SDK and runtime versions.
- Native Vulkan 1.3 minimum: `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs` requests `Vk.Version13` and filters physical devices below it.
**Package Manager:**
- NuGet through the .NET SDK (`dotnet restore` in `scripts/bootstrap.sh`); no separately pinned NuGet client version.
- Lockfile present: `packages.lock.json`; `GamePort.csproj` enables `RestorePackagesWithLockFile`.
- Use `scripts/env.sh` to select the project-local SDK and `.nuget/packages` cache and disable .NET CLI telemetry.
## Frameworks
**Core:**
- Silk.NET.Vulkan, Silk.NET.Vulkan.Extensions.KHR and Silk.NET.Vulkan.Extensions.EXT `2.23.0` provide Vulkan bindings and extensions in `GamePort.csproj`.
- SDL3 `3.4.2` is provisioned by `scripts/bootstrap.sh`; window/input/Vulkan-surface and audio bindings are handwritten P/Invoke in `src/GamePort/Platform/Sdl.cs`.
- Game logic, binary formats, asset readers and UI are project C# modules under `src/GamePort/`; no general game engine is declared in `GamePort.csproj`.
**Testing:**
- Python standard-library `unittest`, invoked by `scripts/test.sh` against `tests/test_*.py` and the HUD checks.
- Standalone .NET 10 executable test projects, rather than a declared xUnit/NUnit dependency; `tests/GamePort.DataTests/GamePort.DataTests.csproj` links production source directly.
- `scripts/test.sh` also runs real Vulkan rendering checks and SDL dummy-audio checks; read `docs/compatibility.md` for recorded platform scope.
**Build/Dev:**
- MSBuild/.NET CLI solution and executable configuration: `GamePort.slnx`, `GamePort.csproj`, `global.json`.
- `glslangValidator` and `spirv-val` compile/validate Vulkan 1.3 shaders in `scripts/compile-shaders.sh`; distro package versions are not pinned there.
- CMake builds SDL locally in `scripts/bootstrap.sh`; curl, Python, and optional apt-get/dpkg-deb provision local dependencies without system installation.
- REA/Ghidra/JDK/Node are analysis-only tools selected by `scripts/rea.sh`; defaults reference Ghidra `12.1.4_PUBLIC` and a Java 21 JDK directory. Node and REA versions are not pinned in that launcher.
- Wine is an original-reference/preliminary compatibility tool, not a production dependency; `docs/dependencies.md` records Wine `11.0`.
## Key Dependencies
**Critical:**
- Silk.NET Vulkan/KHR/EXT `2.23.0`: native renderer access, swapchain/surface handling and validation messaging in `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`; direct pins in `GamePort.csproj`.
- SDL3 `3.4.2`: native window, input and audio backend, provisioned in `scripts/bootstrap.sh` and consumed through `src/GamePort/Platform/Sdl.cs` and `src/GamePort/Audio/SdlAudio.cs`.
- Host Vulkan loader and graphics ICD: required even for packaged self-contained builds; `scripts/package.sh` documents the Vulkan 1.3 prerequisite.
**Infrastructure:**
- Locked transitives in `packages.lock.json`: Silk.NET.Core `2.23.0`, Microsoft.DotNet.PlatformAbstractions `3.1.6`, Microsoft.Extensions.DependencyModel `9.0.9`.
- .NET built-ins supply numerics, compression, JSON and filesystem operations; examples are `src/GamePort/Game/RuntimeCheckpoint.cs`, `src/GamePort/Assets/PngImage.cs` and `src/GamePort/Assets/AssetPath.cs`.
- Local asset converters are project modules, such as `tools/extractors/prepare.py`, `tools/extractors/omt.py` and `tools/extractors/sound_bank.py`, not a hosted conversion service.
## Configuration
**Environment:**
- Runtime configuration uses CLI options in `src/GamePort/Program.cs`, including `--assets`, `--scene`, `--level`, `--load-save`, `--write-save`, dimensions, headless rendering and mute/debug switches.
- Native SDL lookup checks the executable directory, project-local native library directory and platform loader in `src/GamePort/Platform/Sdl.cs`.
- `scripts/env.sh` configures SDK/cache paths, optional native-tool paths, `LD_LIBRARY_PATH` and `VK_LAYER_PATH`; no runtime service credentials are required.
- Preserve originals and write prepared assets outside their root; `tools/extractors/prepare.py` rejects output inside the original installation.
**Build:**
- `GamePort.csproj` explicitly includes `src/GamePort/**/*.cs`, copies SPIR-V shaders and conditionally includes platform SDL binaries.
- `scripts/build-linux.sh` and `scripts/build-windows.sh` self-contained publish to `dist/linux-x64` and `dist/win-x64` and require the corresponding SDL library.
- `scripts/package.sh` assembles local assets/scenes/audio, runtime libraries, licenses, documentation and source provenance into both packages; generated packages are not source-control upload artifacts (`AGENTS.md`).
## Platform Requirements
**Development:**
- .NET 10 SDK; Python 3 for preparation/regressions; Vulkan-capable driver/loader and SDL backend dependencies for native checks (`README.md`, `scripts/test.sh`).
- Linux bootstrap additionally uses CMake and native build tooling for SDL and optional Ubuntu package extraction for shader/X11/audio/validation tools (`scripts/bootstrap.sh`).
- Read-only evidence work uses separate generated targets and local analysis tools (`tools/binary/rea_decompile_batch.py`, `scripts/rea.sh`); never execute or modify originals in place (`AGENTS.md`).
**Production:**
- Shared `linux-x64` and `win-x64` source implementation, with self-contained .NET and native SDL packaging declared in `GamePort.csproj` and `scripts/package.sh`.
- Native Linux and Windows 10/11 x64 are required by `../prompt.MD`; host Vulkan 1.3+ driver/loader remains necessary.
- Offline operation is intentional (`AGENTS.md`). Native Linux scene evidence, Windows cross-publish, Wine runs and native Windows gameplay are separate claims; `docs/progress.md` and `docs/compatibility.md` retain bounded verification and outstanding broader/native Windows comparisons.
---
*Stack analysis: 2026-11-12*
+195
View File
@@ -0,0 +1,195 @@
---
last_mapped_commit: bdca29d3aa31face0c0023537ff98783716dbc45
last_mapped_at: 2026-11-12
---
# Codebase Structure
**Analysis Date:** 2026-11-12
## Directory Layout
```text
GamePort/
├── GamePort.csproj / GamePort.slnx # Single runtime executable and solution
├── global.json / NuGet.Config # SDK/package configuration
├── src/GamePort/
│ ├── Program.cs # Composition, CLI, scheduling and transitions
│ ├── Application/ # Presentation session, visuals, UI, debug and fixtures
│ ├── Assets/ # Original/prepared readers and CPU resources
│ ├── Audio/ # Scene mixer policy and owned SDL streams
│ ├── Game/ # Simulation, scripts, progression, recovered kernels
│ ├── Platform/ # SDL3 native interop
│ └── Rendering/
│ ├── Vulkan/ # GPU backend
│ └── Shaders/ # GLSL and committed SPIR-V
├── tests/ # Python evidence/parser tests and C# executables
├── tools/
│ ├── binary/ # Static evidence extractors and component probes
│ ├── extractors/ # Archive/model/audio/UI preparation
│ ├── levels/ # GAM forensic parser
│ └── recon/ # Inventory and reference observation tools
├── scripts/ # Local dependency/build/test/package scripts
├── docs/
│ ├── analysis/ # Format, binary, graphics and gameplay findings
│ ├── checkpoint/ # Reconstruction gates, ledgers and continuation plan
│ ├── gameplay/ # Focused source contracts and live implementation evidence
│ └── reviews/ # Reference project reviews
└── .planning/codebase/ # GSD codebase maps
```
`../Original/` is a separate immutable evidence tree, not a source directory. The sibling JN-Engine reference is discussed in `docs/reviews/jn-engine-survey.md`; it is not linked into the runtime. Workspace `.git` is reserved; GamePort has the actual project repository (`AGENTS.md`).
## Directory Purposes
**`src/GamePort/Application/`:**
- Purpose: Translate game state into scene meshes, camera views, HUD/debug interfaces and native presentation lifetime.
- Contains: `*Visuals.cs`, overlays, preview helpers, explicit `*Smoke.cs` fixture drivers.
- Key files: `src/GamePort/Application/RenderSession.cs`, `src/GamePort/Application/SceneActorVisuals.cs`, `src/GamePort/Application/SceneHud.cs`, `src/GamePort/Application/UiViewport.cs`.
- Keep Vulkan device ownership in `RenderSession`/backend and expose mutable CPU scene data to visual adapters.
**`src/GamePort/Game/`:**
- Purpose: Stateful gameplay and focused recovered mathematical/source contracts.
- Contains: Player simulation, script director, tasks/inventory, collision, gadget/vehicle systems and route checkpoints. These are currently flat files, not speculative Entities/Physics/AI subtrees.
- Key files: `src/GamePort/Game/LabSimulation.cs`, `src/GamePort/Game/PlayerSceneBinding.cs`, `src/GamePort/Game/SceneDirector.cs`, `src/GamePort/Game/SceneInteractions.cs`, `src/GamePort/Game/OriginalBodyPhysics.cs`.
- Keep source arithmetic in small named modules such as `src/GamePort/Game/JimmyGroundMotion.cs` and `src/GamePort/Game/JimmyOrientation.cs`.
**`src/GamePort/Assets/`:**
- Purpose: Bounded decoding and CPU representation; no native device lifetime.
- Contains: GAM/TSK, ASE/PNG, prepared JSON/buffers, morphs and portable lookup.
- Key files: `src/GamePort/Assets/GamLevel.cs`, `src/GamePort/Assets/OriginalSave.cs`, `src/GamePort/Assets/Mesh.cs`, `src/GamePort/Assets/PreparedEntityResources.cs`, `src/GamePort/Assets/AssetPath.cs`.
**`src/GamePort/Rendering/`, `src/GamePort/Platform/`, `src/GamePort/Audio/`:**
- Purpose: Native rendering, platform and audio boundaries.
- Contains: One Vulkan backend, shaders, SDL3 imports and independent WAV streams.
- Key files: `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`, `src/GamePort/Rendering/Shaders/mesh.vert`, `src/GamePort/Rendering/Shaders/mesh.frag`, `src/GamePort/Platform/Sdl.cs`, `src/GamePort/Audio/SceneAudio.cs`, `src/GamePort/Audio/SdlAudio.cs`.
**`tools/extractors/` and `tools/levels/`:**
- Purpose: Read-only source data interpretation and generated resource production.
- Contains: OMT, ASE, PNG, entity/model/UI/audio and gadget-specific extractors; lossless GAM reference parsing.
- Key files: `tools/extractors/prepare.py`, `tools/extractors/omt.py`, `tools/extractors/ase.py`, `tools/extractors/entities.py`, `tools/extractors/models.py`, `tools/levels/gam.py`.
- Route new resource preparation through `tools/extractors/prepare.py` so local package preparation uses the same path.
**`tools/binary/` and `tools/recon/`:**
- Purpose: Preserve reproducible source-contract evidence and original/reference observation tooling.
- Contains: Python instruction/structure guards, C copied-component probes, inventory and observation utilities.
- Key files: `tools/binary/physical_registration.py`, `tools/binary/dynamic_reclip.py`, `tools/binary/actor_contact.py`, `tools/recon/inventory.py`, `tools/recon/reference_capture.py`.
- These tools are research/test infrastructure, not executable game dependencies (`GamePort.csproj`).
**`docs/`:**
- Purpose: Evidence, confidence boundaries, implementation status and continuation instructions.
- Contains: `docs/analysis/`, `docs/gameplay/`, `docs/checkpoint/`, `docs/reviews/` and root status documents.
- Key files: `docs/progress.md`, `docs/tasks.md`, `docs/decisions.md`, `docs/compatibility.md`, `docs/architecture.md`, `docs/checkpoint/coverage.md`, `docs/checkpoint/next-work-plan.md`.
- Keep addresses/offsets, recovered versus inferred behavior and actual validation scope in the relevant report.
## Key File Locations
**Entry Points:**
- `src/GamePort/Program.cs`: Runtime CLI, scene composition, input loop, transitions and fixture invocation.
- `tools/extractors/prepare.py`: Original-to-prepared-assets pipeline.
- `tools/recon/inventory.py`: Original file inventory/hash verification.
- `scripts/test.sh`: Local consolidated regression/GPU checks.
- `scripts/package.sh`: Local self-contained package assembly and launchers.
**Configuration:**
- `GamePort.csproj`: net10.0, Linux/Windows x64, explicit production source glob, Silk.NET references and shader/native content.
- `GamePort.slnx`: Solution entry.
- `global.json`: SDK selection.
- `NuGet.Config`, `packages.lock.json`: Package configuration and dependency lock.
- `scripts/env.sh`: Local toolchain environment setup.
- `.gitignore`: Generated output/cache exclusions.
- `AGENTS.md`: Movement priority, recovery gates, platform requirements and coordination.
**Core Logic:**
- `src/GamePort/Game/LabSimulation.cs`: Player state and body/input/wrapper/apply/effect phase order.
- `src/GamePort/Game/PlayerSceneBinding.cs`: Director/actor/player control and preparation bridge; vehicle sequencing.
- `src/GamePort/Game/PlayerLevelState.cs`: Explicit retained route scalars outside TSK.
- `src/GamePort/Game/SceneDirector.cs`: Authored script/camera chains and live actor state.
- `src/GamePort/Game/RuntimeCheckpoint.cs`: Departure/RETURN context.
- `src/GamePort/Game/OriginalStaticCollision.cs`, `src/GamePort/Game/OriginalBodyPhysics.cs`: Bounded source static/body path.
- `src/GamePort/Game/SceneCollision.cs`: Capsule compatibility geometry.
- `src/GamePort/Game/OriginalPairCollision.cs`, `src/GamePort/Game/OriginalNormalContacts.cs`: Isolated recovered components, not live scene admission.
- `src/GamePort/Application/RenderSession.cs`: Persistent application-owned SDL/Vulkan lifetime.
**Testing:**
- `tests/test_extractors.py`, `tests/test_levels.py`, `tests/test_models.py`: Python format/preparation coverage.
- `tests/test_checkpoint_*.py`, `tests/test_jimmy_*.py`: Source-contract and lifecycle evidence guards.
- `tests/GamePort.DirectorTests/Program.cs`: Script/control regressions.
- `tests/GamePort.BodyOwnershipTests/Program.cs`: Body/control ownership checks.
- `tests/GamePort.JimmyGroundTests/Program.cs`, `tests/GamePort.JimmyAirTests/Program.cs`: Focused managed movement comparisons.
- `tests/GamePort.PairLifecycleTests/Program.cs`, `tests/GamePort.ActorContactTests/Program.cs`: Isolated component fixtures.
- `src/GamePort/Application/CutsceneIdleSmoke.cs`, `src/GamePort/Application/WindowTransitionSmoke.cs`: Native runtime fixture drivers, distinct from isolated numeric tests.
## Naming Conventions
**Files:**
- Use PascalCase C# files matching primary types: `src/GamePort/Game/JimmyAirMotion.cs`.
- Use feature-specific suffixes for roles: `src/GamePort/Application/ScooterVisuals.cs`, `src/GamePort/Game/ScooterMotion.cs`, `src/GamePort/Application/ScooterSmoke.cs`.
- Prefix recovered source contracts with `Original` where established: `src/GamePort/Game/OriginalNormalContacts.cs`; the prefix does not assert live integration.
- Use snake_case Python modules and tests: `tools/binary/dynamic_reclip.py`, `tests/test_dynamic_reclip.py`.
- Use kebab-case documentation topics: `docs/checkpoint/actor-normal-contacts.md`.
**Directories:**
- Keep runtime namespaces grouped by concrete responsibility under `src/GamePort/`.
- Use `tests/GamePort.<Subject>Tests/` for executable managed test projects with `Program.cs` and matching `.csproj`.
- Keep root Python tests under `tests/` and reusable retained references under `tests/fixtures/` or focused project folders.
- Keep evidence-oriented reports in `docs/checkpoint/`, source/live feature reports in `docs/gameplay/`.
## Where to Add New Code
**New Feature:**
- Primary code: `src/GamePort/Game/`; coordinate explicit composition and supported scene gates in `src/GamePort/Program.cs`.
- Presentation: Add a focused adapter under `src/GamePort/Application/`; use `src/GamePort/Application/UiViewport.cs` for UI sizing/pointers.
- Tests: Add focused `tests/GamePort.<Subject>Tests/` numeric/state comparisons and source-evidence guards in `tests/test_<subject>.py` where appropriate.
- Evidence/status: Use `docs/gameplay/` or `docs/checkpoint/` and update `docs/progress.md`/`docs/tasks.md` when authorized gameplay work changes state.
- Preserve the current Jimmy stabilization priority and lab/outside capsule versus bounded source-body distinction (`AGENTS.md`, `src/GamePort/Program.cs`).
**New Component/Module:**
- Recovered arithmetic: `src/GamePort/Game/`, with explicit input/output state as in `src/GamePort/Game/JimmyGroundMotion.cs`.
- Script preparation/control bridge: `src/GamePort/Game/PlayerSceneBinding.cs` and `src/GamePort/Game/SceneDirector.cs`; retain fresh/retained ordering.
- New binary format reader: `src/GamePort/Assets/`; forensic/extraction counterpart in `tools/extractors/` or `tools/levels/`.
- New visual: `src/GamePort/Application/`; extend backend only when required by source rendering behavior (`src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`).
- New native interop: `src/GamePort/Platform/Sdl.cs`; keep allocation/release in the owning subsystem.
- New audio policy: `src/GamePort/Audio/SceneAudio.cs`; SDL stream mechanics belong in `src/GamePort/Audio/SdlAudio.cs`.
- New recovered collision callback: Focused `src/GamePort/Game/` component plus fixture first; do not wire `OriginalPairCollision` or `OriginalNormalContacts` into runtime without activation/order/derived-response evidence (`docs/checkpoint/next-work-plan.md`).
**Utilities:**
- Asset path handling: `src/GamePort/Assets/AssetPath.cs`; preserve case-insensitive lookup and root containment.
- Offline source guards/probes: `tools/binary/`; use documented REA evidence for original-binary investigation (`AGENTS.md`).
- Shared extraction helpers: `tools/extractors/` next to the owning format; connect to `tools/extractors/prepare.py`.
- Build/package operations: `scripts/`; use local output and existing Linux/Windows entry scripts.
## Special Directories
**`artifacts/`:**
- Purpose: Prepared resources, generated evidence and local fixture output; default preparation root is `artifacts/extracted/` (`tools/extractors/prepare.py`).
- Generated: Yes.
- Committed: No (`.gitignore`).
**`dist/`, `bin/`, `obj/`:**
- Purpose: Local self-contained packages and .NET build output (`scripts/package.sh`, `GamePort.csproj`).
- Generated: Yes.
- Committed: No (`.gitignore`).
**`.tools/`, `.nuget/`, `.dotnet-home/`:**
- Purpose: Local toolchain, native dependencies and caches (`scripts/env.sh`, `GamePort.csproj`).
- Generated: Yes/local provisioned.
- Committed: No (`.gitignore`).
**`src/GamePort/Rendering/Shaders/`:**
- Purpose: Source GLSL and packaged SPIR-V, compiled by `scripts/compile-shaders.sh`.
- Generated: `.spv` files are generated; `.vert`/`.frag` are source.
- Committed: Yes; `GamePort.csproj` copies SPIR-V to executable output.
**`../Original/`:**
- Purpose: Immutable evidence and runtime asset source (`AGENTS.md`, `tools/recon/inventory.py`).
- Generated: No.
- Committed: Outside this repository; never modify or execute in place.
**`.planning/codebase/`:**
- Purpose: Generated analysis maps for planning; current files are distinct from persistent authored `docs/architecture.md`.
- Generated: Yes, from tracked source/config/documentation inspection.
- Committed: Controlled by the mapping orchestrator; not excluded by `.gitignore`.
---
*Structure analysis: 2026-11-12*
+171
View File
@@ -0,0 +1,171 @@
---
last_mapped_commit: bdca29d3aa31face0c0023537ff98783716dbc45
last_mapped_at: 2026-11-12
---
# Testing Patterns
**Analysis Date:** 2026-11-12
## Test Framework
**Runner:**
- Python standard-library `unittest`; no pinned Python test framework package is detected (`tests/test_extractors.py`, `scripts/test.sh`).
- Standalone C# `net10.0` console applications, invoked using `dotnet run`, rather than xUnit/NUnit/MSTest (`tests/GamePort.ActorContactTests/GamePort.ActorContactTests.csproj`, `scripts/test.sh`).
- The comprehensive local sequence is `scripts/test.sh`; it sources `scripts/env.sh`, prepares assets and runs managed, Python, rendering, audio and hash checks.
**Assertion Library:**
- `unittest.TestCase` assertions and context managers (`tests/test_extractors.py`).
- C# local `Check`/`Near` functions or recursive JSON comparisons that throw exceptions (`tests/GamePort.JimmyGroundTests/Program.cs`, `tests/GamePort.ActorContactTests/Program.cs`).
**Run Commands:**
Run from the GamePort repository root; these are recorded commands, not checks executed by this mapping.
```bash
source scripts/env.sh
python3 -m unittest discover -s tests -p 'test_*.py' -v
scripts/test.sh
dotnet run --project tests/GamePort.ActorContactTests
dotnet run --project tests/GamePort.JimmyGroundTests
dotnet run --project tests/GamePort.DataTests -- ../Original
python3 tests/GamePort.HudTests/test_ui.py
SDL_AUDIODRIVER=dummy dotnet run --project tests/GamePort.AudioPauseTests
NEUTRON_WINDOW_TEST=1 scripts/test.sh
scripts/test-window-transitions.sh
```
- No dedicated watch or coverage command is detected in `scripts/test.sh` or the inspected test projects. `scripts/test-window-transitions.sh` requires a prior build plus local Xvfb/Xfwm/session tools.
## Test File Organization
**Location:**
- Separate `tests/` directory; Python discovery sees root `test_*.py`, while HUD Python tests are invoked explicitly (`scripts/test.sh`).
- Each managed group has a project directory, `Program.cs` and optional JSON references (`tests/GamePort.ActorContactTests/`, `tests/GamePort.JimmyGroundTests/`).
**Naming:**
- `tests/test_<domain>.py`, `tests/GamePort.<Domain>Tests/Program.cs`, and descriptive `original-*-reference.json` or `expected.json` fixtures (`tests/test_actor_contact.py`, `tests/GamePort.DirectorTests/original-camera-rotation-reference.json`).
**Structure:**
```text
tests/
test_extractors.py
test_actor_contact.py
GamePort.ActorContactTests/
GamePort.ActorContactTests.csproj
Program.cs
expected.json
GamePort.JimmyGroundTests/
Program.cs
original-ground-reference.json
```
## Test Structure
**Suite Organization:**
Use deterministic inputs and assertions with descriptive failures. Actual Python pattern from `tests/test_extractors.py`:
```python
class BoundedReaders(unittest.TestCase):
def test_read_bounds_and_negative_size(self):
for size in (-1, 2):
with self.assertRaises(FormatError): Reader(b'x').take(size)
```
Actual C# comparison helper from `tests/GamePort.JimmyGroundTests/Program.cs`:
```csharp
static void Check(bool condition,string name)
{ if(!condition)throw new Exception(name); }
static void Near(float value,float expected,string name) =>
Check(float.IsFinite(value)&&Math.Abs(value-expected)<.02f,
$"{name}: {value} != {expected}");
```
**Patterns:**
- Top-level managed programs load JSON using `AppContext.BaseDirectory`, enumerate cases, compare every relevant field, check case counts and print `PASS` (`tests/GamePort.JimmyGroundTests/Program.cs`).
- Test projects copy saved fixtures into output and compile production files directly with explicit globs (`tests/GamePort.ActorContactTests/GamePort.ActorContactTests.csproj`).
- Some fixture filenames are output links rather than colocated tracked files: `tests/GamePort.JimmyGroundTests/GamePort.JimmyGroundTests.csproj` links `tools/binary/jimmy_landing_rotation_reference.json` as `original-landing-rotation-reference.json`. Check source availability when reproducing a suite.
- Use `TemporaryDirectory` for exports and symlink rejection fixtures; local-original integration cases can use `skipUnless(ORIGINAL.exists())` (`tests/test_extractors.py`, `tests/test_actor_contact.py`). Do not assume every original-dependent suite has a skip guard.
## Mocking
**Framework:** No general mocking library is detected in the inspected projects. Use explicit fixtures, interfaces and callbacks (`tests/GamePort.ActorContactTests/Program.cs`).
**Patterns:**
The actor-contact fixture implements `IOriginalNormalBody`, logs each accessor and deliberately changes state on a later read (`tests/GamePort.ActorContactTests/Program.cs`):
```csharp
public Vector4 ReadVelocity()
{
events.Add("Gv"); velocityGets++;
if(FreshY && velocityGets == 2) Velocity.Y = 99;
return Velocity;
}
```
**What to Mock:**
- Synthetic actor state, bounded callback endpoints, geometry and controlled getter mutations isolate original component behavior (`tests/GamePort.ActorContactTests/Program.cs`, `docs/checkpoint/actor-normal-contacts.md`).
- Dummy SDL audio drivers isolate lifecycle/consumption checks; they do not establish audible output (`scripts/test.sh`, `docs/compatibility.md`).
**What NOT to Mock:**
- Preserve real parser byte boundaries, production algorithms, archive identities and saved original observations; compare through the production implementation (`tests/test_extractors.py`, `tests/GamePort.ActorContactTests/Program.cs`).
- Do not replace live GPU validation with a managed-only assertion; real headless Vulkan paths write readbacks (`scripts/test.sh`, `src/GamePort/Program.cs`).
## Fixtures and Factories
**Test Data:**
- Build minimal byte fixtures with explicit endian packing, e.g. the RGB555 canvas case in `tests/test_extractors.py` uses `struct.pack('>H', len(row))` and a synthetic `OmCv`/`OmGW` header.
- Use `Fixture.Reset(kind)` to seed reproducible body state and clear event logs before each named observation (`tests/GamePort.ActorContactTests/Program.cs`).
- Preserve source-executed references rather than deriving all expectations from the port. `tests/GamePort.ActorContactTests/expected.json` contains complete saved observations; `--native <observations.json>` permits a fresh external observation comparison and `--dump` emits port states (`tests/GamePort.ActorContactTests/Program.cs`).
**Location:**
- Saved component references live beside managed projects (`tests/GamePort.DynamicReclipTests/expected.json`, `tests/GamePort.GrapplerTests/original-query-reference.json`).
- Original integration fixtures are external local `../Original`; never modify them (`AGENTS.md`, `tests/test_extractors.py`). Generated extraction/replay outputs belong under ignored `artifacts/`, as specified by `scripts/test.sh`; this map does not inspect those outputs.
- Binary tools validate complete original bodies, relocation operands, table bindings and generated-probe output separation (`tests/test_actor_contact.py`, `tools/binary/actor_contact.py`).
## Coverage
**Requirements:**
- No enforced percentage threshold or coverage collector is detected in `scripts/test.sh` or `tests/GamePort.ActorContactTests/GamePort.ActorContactTests.csproj`.
- Use behavioral coverage: malformed lengths/counts/trailing bytes, coordinate/winding/UV identities, positive recovered behavior, explicit unsupported contracts, case completeness and callback read order (`tests/test_extractors.py`, `tests/GamePort.ActorContactTests/Program.cs`).
- `docs/progress.md` and `docs/compatibility.md` record 352 Python checks for the documented source checkpoint identified as `bdca29d` by the mapping task. This is an existing receipt, not a fresh run or independently recounted total.
- The same records distinguish integrated SDL/GPU evidence at `bf876e9` and unchanged packages at `924ad2f`. Do not attach the newest component counts to an older package or imply the latest component work reran graphics.
**View Coverage:** Not detected. Consult `docs/compatibility.md` and subsystem reports for evidence scope rather than treating test count as gameplay completeness.
## Test Types
**Unit Tests:**
- Bounded readers, PackBits/PNG operations, numerical movement/orientation, task transitions, UI and standalone collision components (`tests/test_extractors.py`, `tests/GamePort.JimmyGroundTests/Program.cs`, `tests/GamePort.ActorContactTests/Program.cs`).
- Explicit unsupported-path checks require exceptions instead of silent admission; zero-horizontal reflection is rejected in `tests/GamePort.ActorContactTests/Program.cs`.
**Integration Tests:**
- Decode actual local archives and compare counts, models, materials, textures and exported references (`tests/test_extractors.py`, `tests/GamePort.DataTests/Program.cs`).
- `scripts/test.sh` prepares scenes/audio, verifies assets, runs save/load checks, SDL dummy audio lifecycle checks, Vulkan renders and original manifest verification.
- Differential component probes execute copied original instructions with synthetic state under Wine32, then compare port snapshots; complete-body/operand guards and provenance are described in `docs/checkpoint/actor-normal-contacts.md`. This is stronger than a port self-comparison but remains a bounded component experiment.
**E2E Tests:**
- Port smoke flows cover story/practice/RETURN routes, cutscenes, gadgets, input, windows and real GPU readbacks (`scripts/test.sh`, `src/GamePort/Application/WindowTransitionSmoke.cs`).
- Optional window checks are gated by `NEUTRON_WINDOW_TEST=1`; `scripts/test-window-transitions.sh` creates a private Xvfb session with Xfwm to support asynchronous fullscreen requests.
- Whole-original gameplay equivalence and native Windows runtime are separate open evidence gates (`docs/compatibility.md`). Windows cross-publishing is compiler/package evidence; Wine execution is preliminary compatibility evidence.
## Common Patterns
**Async Testing:**
- No general async test runner pattern is detected in the inspected console/Python suites. SDL/window progression is exercised through frame-driven smoke state and real window-manager acknowledgements (`src/GamePort/Application/WindowTransitionSmoke.cs`, `scripts/test-window-transitions.sh`).
**Error Testing:**
- Python uses `assertRaises` / `assertRaisesRegex`, including rejection of original-directory and symlink output (`tests/test_extractors.py`, `tests/test_actor_contact.py`).
- Managed tests call unsupported paths inside `try`, throw if accepted, and catch only the expected `NotSupportedException` (`tests/GamePort.ActorContactTests/Program.cs`).
**Numerical comparisons:**
- Use tolerances appropriate to the specific observed contract: `.02f` and finite checks for ground motion; decimal-place comparisons for exported ASE positions/UVs (`tests/GamePort.JimmyGroundTests/Program.cs`, `tests/test_extractors.py`).
- Actor-contact snapshots compare JSON field shapes, array counts, event order and `GetSingle()` values exactly; do not weaken exact float32 checks by borrowing another suite's tolerance (`tests/GamePort.ActorContactTests/Program.cs`).
- Preserve source float-store boundaries rather than declaring all double intermediates a universal x87 equivalent (`docs/checkpoint/dynamic-reclip.md`).
**Verification reporting:**
- State separately: compiler success, managed/Python assertions, copied-original component execution, port rendering/native SDL input, package provenance, whole-original comparison, and native Windows gameplay (`AGENTS.md`, `docs/progress.md`, `docs/compatibility.md`).
- No builds or tests are executed for this mapping; commands and evidence above describe the checked-in source and documented receipts.
---
*Testing analysis: 2026-11-12*
+72
View File
@@ -0,0 +1,72 @@
{
"model_profile": "inherit",
"commit_docs": true,
"parallelization": true,
"search_gitignored": false,
"brave_search": false,
"firecrawl": false,
"exa_search": false,
"tavily_search": false,
"ref_search": false,
"perplexity": false,
"jina": false,
"git": {
"branching_strategy": "none",
"create_tag": true,
"repo_tagging": "single",
"phase_branch_template": "gsd/phase-{phase}-{slug}",
"milestone_branch_template": "gsd/{milestone}-{slug}",
"quick_branch_template": null,
"allow_default_branch_commits": true
},
"workflow": {
"research": true,
"plan_check": true,
"verifier": true,
"nyquist_validation": true,
"auto_advance": false,
"node_repair": true,
"node_repair_budget": 2,
"ui_phase": true,
"ui_safety_gate": true,
"ai_integration_phase": true,
"api_coverage_gate": true,
"human_verify_mode": "end-of-phase",
"context_guard_mode": "warn",
"text_mode": false,
"compact_content": false,
"research_before_questions": false,
"discuss_mode": "discuss",
"skip_discuss": false,
"code_review": true,
"code_review_depth": "standard",
"code_review_command": null,
"pattern_mapper": true,
"plan_bounce": false,
"plan_bounce_script": null,
"plan_bounce_passes": 2,
"auto_prune_state": false,
"post_planning_gaps": true,
"security_enforcement": true,
"security_asvs_level": 1,
"security_block_on": "high",
"_auto_chain_active": false
},
"ship": {
"pr_body_sections": []
},
"hooks": {
"context_warnings": true
},
"project_code": null,
"phase_naming": "sequential",
"agent_skills": {},
"claude_md_path": "./.claude/CLAUDE.md",
"plan_review": {
"source_grounding": true,
"source_grounding_authority": "grep"
},
"resolve_model_ids": "omit",
"mode": "yolo",
"granularity": "standard"
}
+24
View File
@@ -0,0 +1,24 @@
# Onboarding Summary
## Project State
- PROJECT.md: present
- REQUIREMENTS.md: present
- ROADMAP.md: present
- STATE.md: present
## Codebase Context
- Brownfield repo: yes
- Map readiness: complete
- Codebase map: `.planning/codebase/` (complete codebase map)
- Fast map available: yes
## Docs Context
- Existing ADR/PRD/SPEC/RFC candidates detected by onboarding: 0
- Authoritative scope: [prompt.MD](../../../prompt.MD); see [PROJECT.md](../PROJECT.md) for specification and evidence pointers.
- Existing evidence reviewed in `.planning/research/`; prior runtime receipts remain bounded.
## Recommended Next Step
- `$gsd-manager` for project navigation.
- `$gsd-discuss-phase 1` to clarify Reproducible Fidelity Baseline, or `$gsd-plan-phase 1` to plan directly.
Initialization covers 8 playable-slice phases and 33 requirements. No reconstruction phase has executed under this roadmap.
@@ -0,0 +1,35 @@
<!-- CONSUMED: final verification completed human_needed on2026-11-14. Current next action: $gsd-verify-work 1 and combined actual human session; historical interrupted-verifier notes below are superseded. -->
---
context: phase
phase: 01-reproducible-fidelity-baseline
plan: "07"
task: 3
total_tasks: 3
status: consumed
last_updated: "2026-11-13T22:26:46.798618+00:00"
---
# Final verification quota checkpoint
Quota guard explicitly requested pause at15%. Resume completed task01-07-03 and recovered fullsuite exit0 (782.049626s), then reviewed/fixed allfive source-integrity findings. Do NOT redo implementation or tests. Source commits through02d182f, review/coverage/security documentation71366e7. Fullsuite556Python/180fidelity,27Node,23observer,2HUD,51managedentrypoints,36GPUrenderedreceipts,zeroVulkanvalidationerrors,SDLdummychecks,539originalhashes. Latertooling-onlyfixes: all191fidelityregressions PASS43.355s; focused26scenario,23capture,29acceptance,27Node,18LinuxhostedPowerShell. All539originals unchanged. No runtime changes afterfullsuite; no need13minGPUrerun forcurrentPython/collector fixes.
Historicalreview5915128: CR01selected-vs-reviewedpath,CR02originalinventory/executablebinding,CR03copy-stateidentity,WR01viewerledgerprojection,WR02interruptedWindowsfinalization. Fixes5569bc2,bda35e5,6e5ee0b,548c97a,2608517,a821754. Independentre-reviewcaughtremaininghash-onlycopy-statebypass; RED48fca0d/GREEN02d182f requiresactual_checked_artifactwithrootinside_scenario_observation; callersupdated. Finalindependentre-reviewallfiveFIXED in01-REVIEW-VERIFY.md; dispositionopen0. Securityauditorfinal22/22mitigated, threats_open0 in01-SECURITY.md. Nyquistautomationcoveragevalidatedall15taskbindings; manualacceptanceopen;191fidelityaggregate43.355sec exceeds30secquicktargethonestly. UIreviewdisabledconfigfalse. No remainingknowncode/securityblockers.
Currentfreshfinalbundle dist/fidelity/phase01 has11001immutableentries. Currenthashes/readinessreceipt artifacts/fidelity/verification/01-07-final-checkpoint.json. readyexit0true,strictauditexit1 errors[] accepted0/120,10humanpending; logs artifacts/fidelity/01-review-fixes/readiness-final.json,acceptance-final.json,python-fidelity-final.log. Oldbundlespreserved phase01-pre-review-48100025 andphase01-pre-copy-artifact-7ceebcb3. ActualLinuxfailedpreflightimportedcurrentbundle/results/imported. Runtimepackage source446930d dirty/diff90cef956 unchanged; source/docscommitsmustnotrelabelitsidentity. Original/nativeWindows+DxWnd andphysicalLinuxvisible/audible/browserreviewremainonecombinedhuman session pending. Humanonlycollects/observes/returns; agent-ownedexactnormalizationmapping incheckpoint-session.md. No capture request issued yet because finalphaseverification/handoffpending.
Final typed verifier phase01_final_verification was dispatched at21%; quota15% interrupted it, instructedfinishonlyboundedhuman_neededreport/fingerprint thenreturn. It had readall7musthaves/summaries, checked25capabilities/33requirements/0unmapped/6groups/33rows,16/16decisioncoverage,40sourcefilesnoskip/debtscan. A mandatoryMVPgoalformatguard exposed existingROADMAPMode:mvp plainproseGoal. Rootauthorizedformat-only identicalintentuserstory and modifiedROADMAP.md uncommitted: As a tester, I want to reproduce identified original/port comparison scenarios, so that I understand exactly what the current reconstruction proves on each native platform. Validatorvalidtrue; no scope/successcriteriamodified. OneverifiercommandusedwrongunittestclassFidelityAcceptance (loadererror,correctclassAcceptanceTests); twoothernamedbehaviorcheckspassed; don'tmislabelthatcommandassuccess. Priorfulltargeted29passestablishactualcoverage.
NEXT: Reconcile currentverifier's 01-VERIFICATION.md and CLI verification.status; ifreport/fingerprintabsentfinishthat ONLY beforeanynewphase. FingerprintmustbeownerCLIgenerated, notmanual. Oncehuman_neededstatusvalid, persistUATfromnamedhumanitems, updateSTATE/consumedhandoffs, commitverifiedreport+goalmetadata+handoffdocs andpush verifiedsource/tooling toauthorizedGitea/main. Lastpushedhead remainsd18f551; later01-07/task3/reviewfix/auditcommits arelocalawaitingfinalverification. Preserveunrelatedtools.yaml. Do notadvancephase2orclaimPhase1accepted; allEVIDIDsPending0/120humanacceptance. No source changesuncommittedexceptROADMAPformatandpossiblynewverifierreport.
Nativeagents/sourcewritesallfinishedexceptverifierreportbeingclosed. Quota watcher runs and actual15%steeringworks. Noauto-resume; usermust $gsd-resume-workafterreset. Don'tspendquota rereadingmassiveGSDscriptbodies orrerunningfinished13minfullsuite. Existinglocalpackages/media/originalcopiesstaylocal, noCI/uploads. MaintracksGitea/main, scoped.gitwriteescalation; retainhistoricalhandoffsmarkconsumedratherthandelete (priorautomaticreviewrejecteddeletion).
## Required Reading
AGENTS.md,parentinstructions,HANDOFF.json,01-07SUMMARY,01-REVIEW-VERIFY,01-SECURITY,01-VALIDATION,and01-VERIFICATIONifpresent.
## Critical Anti-Patterns
| Pattern | Description | Severity | Prevention Mechanism |
|---|---|---|---|
| Redo completed tests | Fullsuiteand191fidelitychecksfinished | advisory | Reconcile savedlogs first; rerunonlyafternewchanges |
| False phase completion | Preparedmaterialsfailactualstrictacceptance0/120 | advisory | KeepEVIDPending andhuman_needed; owner verification.status beforeadvance |
## Infrastructure State
Testsfinished; verifierinterruptedatpause; reportreconciliationpending; localquota watcher running. No sourceworkeractive.
## Next Action
Inspect01-VERIFICATION.md and owner verification.status; finish report/fingerprint/UAT ifneeded, commit/pushverified01-07reviewedwork; neverredo task3/fulltests orautoapprovehumanacceptance.
@@ -0,0 +1,126 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "01"
type: execute
wave: 1
depends_on: []
files_modified:
- tools/recon/fidelity.py
- tools/recon/fidelity_receipts.py
- tests/test_fidelity_sessions.py
- docs/evidence/scenarios.json
- tests/test_fidelity_scenarios.py
autonomous: true
requirements: [EVID-01, EVID-02, EVID-04]
estimate:
tokens: 34000
raw_tokens: 34000
tasks: 2
confidence: low
must_haves:
truths:
- "A reviewer can stage and identify a pristine generated original installation without altering any original byte (EVID-01, D-15)."
- "The protocol requires continuous lab → VR04 → lab → outside and focused dialogue-return, left/right banked-jump, landing and idle captures per D-01 and D-04."
- "Natural/skipped dialogue and fresh/retained entry are equally required, independently identified dimensions per D-02 and D-03."
- "Equal, nested, symlink-aliased and Windows case-aliased source/output paths fail before any staging write; sibling paths merely sharing a textual prefix remain distinct."
- "Empty/missing inventories fail; single-file fixtures round-trip, while changed, missing and added files invalidate identity."
- "Manifest order is canonical relative POSIX path order; case-colliding identities fail instead of acquiring filesystem-dependent order."
- "Interrupted staging/import leaves an explicit incomplete diagnostic and no completed receipt; simultaneous same-session allocation has one winner, and duplicate receipt imports are idempotent only for byte-identical content."
- "Typed receipt validation retains failures and missing evidence as open acceptance; D-13 Windows availability is not a runtime receipt."
artifacts:
- path: tools/recon/fidelity.py
provides: "Local stage, identify, import and validate CLI"
- path: tools/recon/fidelity_receipts.py
provides: "Versioned receipt, identity, containment and atomic publication contract"
- path: docs/evidence/scenarios.json
provides: "Required baseline matrix and observed-event protocol"
key_links:
- from: tools/recon/fidelity.py
to: tools/recon/inventory.py
via: "Recorded original inventory checked before staging and after collection"
- from: tools/recon/fidelity_receipts.py
to: docs/evidence/scenarios.json
via: "Stable case IDs and completeness rules"
prohibitions:
- statement: "MUST NOT sacrifice authoritative original bytes or execute the authoritative installation to make reference collection convenient."
status: unresolved
reason: "Spec-less recall: preservation is a project value; descriptor-less and flagged-unverified for review."
---
<objective>
**As a** tester, **I want to** reproduce identified original and port comparison scenarios and inspect their evidence, **so that** I can understand exactly what the current reconstruction proves on each native platform.
Roadmap-derived framing supplied by the orchestrator. Prove the local evidence workflow from immutable inventory through generated copy, actual package identity, imported bounded evidence and a readable receipt. Establish the complete scenario contract before parallel consumers begin.
Artifacts this phase produces in this plan: fidelity.py CLI subcommands stage, identify, import and validate; fidelity_receipts.py functions stage_original, identify_tree, validate_receipt and import_receipt; schema_version 1 local JSON contracts; tests/test_fidelity_sessions.py; docs/evidence/scenarios.json; tests/test_fidelity_scenarios.py. Generated session/receipt/manifest outputs belong in artifacts/fidelity/ and remain ignored. These are new tooling interfaces, not recovered game interfaces.
</objective>
<execution_context>
@/home/cristian/.codex/gsd-core/workflows/execute-plan.md
@/home/cristian/.codex/gsd-core/templates/summary.md
</execution_context>
<context>
@AGENTS.md
@.planning/PROJECT.md
@.planning/STATE.md
@.planning/ROADMAP.md
@.planning/REQUIREMENTS.md
@.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
@.planning/phases/01-reproducible-fidelity-baseline/01-RESEARCH.md
@.planning/phases/01-reproducible-fidelity-baseline/01-PATTERNS.md
@.planning/phases/01-reproducible-fidelity-baseline/SKELETON.md
</context>
<tasks>
<task type="tracer" tdd="true" id="01-01-01">
<name>Stage one preserved session and review one honestly classified receipt end to end</name>
<reversibility rating="costly">Versioned local records are shared by later tools; retaining raw inputs and explicit schema versions keeps migration bounded.</reversibility>
<files>tools/recon/fidelity.py, tools/recon/fidelity_receipts.py, tests/test_fidelity_sessions.py</files>
<read_first>tools/recon/inventory.py; tools/recon/reference_capture.py; scripts/package.sh; tests/test_extractors.py; docs/compatibility.md; docs/original-manifest.json; 01-RESEARCH.md sections Existing Analogs, Pattern 1 and Security Domain.</read_first>
<behavior>At least 16 discovered tests cover a valid CLI stage→identify→import→validate round trip, changed/missing/added originals, empty/single-file manifests, two-direction path equality/overlap and sibling prefixes, symlink/drive/case escape, shell characters as inert paths, reuse/concurrent allocation, interruption, byte tampering, identical duplicate import and conflicting duplicate ID. Native acceptance rejects synthetic/component/Wine/cross-publish classifications.</behavior>
<action>Create tests first, including one subprocess-level CLI round trip with tiny fixture trees. Implement stdlib-only tools with argument arrays, bounded subprocess/JSON sizes and streaming SHA-256. Reuse the existing inventory comparison without regenerating docs/original-manifest.json. Resolve and validate all roots before writing; reject symlink escapes, Windows normalized aliases, case collisions and source/output overlap in either direction. Allocate fresh session directories exclusively, stage in a temporary sibling and atomically publish after complete pre-run copy verification; failed/interrupted attempts retain diagnostics without publishing a completed receipt. Lock session/import publication and distinguish exact duplicate content from conflicting reuse. Stage a separate generated original copy per fresh run per D-15; retained cases keep one explicitly identified lifetime. Store pre-run copy identity, post-run copy changes and source pre/post inventory separately. Define receipt identity, evidence_kind, status, case/session IDs, actual executable/package/resource and launcher hashes, actual source/dirty/diff identity, native/platform category, invocation/cwd, clocks, artifacts/derivatives and open acceptance. Separate reported historical evidence from newly generated evidence. Exercise one real existing on-disk port package/report, verifying its actual bytes and reporting its recorded scope; if referenced artifacts are absent, explicitly retain missing/stale evidence rather than minting identity. Import an explicitly synthetic paired-media fixture only to exercise plumbing; it cannot qualify as original/native proof. The validate command prints a readable receipt summary with actual category, missing evidence and acceptance state, not just success. Preserve the legacy Wine harness classification and behavior. Establish read-only contained relative references and a documented allowed-receipt state machine for later consumers.</action>
<acceptance_criteria>The CLI round trip yields a hashed receipt and readable summary; original/copy/package identities are distinct; every hostile/partial identity case is rejected without original writes; an existing report is labeled historical or missing exactly as found; synthetic paired fixtures remain in a separate test namespace; no completed acceptance results from a launcher exit code.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_sessions.py"); assert s.countTestCases() >= 16,"fewer than 16 session tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 16 discovered tests, any failed round-trip/security/classification case, or no test summary.</fails_when>
<automated>python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json</automated>
<fails_when>Nonzero exit or missing output Verified 539 unchanged original files.</fails_when>
</verify>
<done>One preserved session can be staged, identified, imported and inspected through the real CLI; all negative tests pass; genuine historical evidence and synthetic test data remain visibly distinct from new native acceptance.</done>
</task>
<task type="auto" tdd="true" id="01-01-02">
<name>Make every required journey and lifetime cell explicit and reject incomplete evidence</name>
<files>docs/evidence/scenarios.json, tests/test_fidelity_scenarios.py, tools/recon/fidelity.py, tools/recon/fidelity_receipts.py</files>
<read_first>01-CONTEXT.md D-01 through D-04; .planning/REQUIREMENTS.md EVID-01 through EVID-04; the receipt interfaces created in task 01-01-01; docs/checkpoint/next-work-plan.md; docs/gameplay/main-menu-player-lifetime.md.</read_first>
<behavior>At least 12 tests require all eight fresh/retained × natural/skipped × ordinary/edge cells, continuous and focused evidence for each, stable IDs/order, real retained-session continuity, and explicit skipped/aborted/missing cases. Equal counts with a missing cell, disconnected scene snapshots, reset timestamps and synthetic/native substitution fail completeness.</behavior>
<action>Define schema-versioned scenarios.json with eight explicit matrix cells and a continuous journey plus focused replay obligations per cell per D-01–D-04. Ordinary runs use normal play; edge runs include held input spanning dialogue/RETURN, both bank directions, landing and idle. Natural and skipped dialogue are separate equal obligations per D-02. Fresh means an independently staged launch; retained means a recorded departure/return in the same session, including prerequisite setup and retained copy state, per D-03. Specify visible setup, actions, end condition and required media/event markers for startup/control, dialogue start/end/skip, first neutral/resumed held input, jump/bank/landing/idle, lab departure, VR04 entry/use, RETURN/cleanup, lab exit and outside arrival. Markers reference actual media time, monotonic elapsed time and observation method/uncertainty; simulation ticks stay separate. Original annotations are procedural/manual unless directly observed by a proven recorder. Allow truthful missing/failed results, but require all cells and artifacts for acceptance. Add validate --scenarios PATH --receipts ROOT with --allow-open for structural readiness and --require-complete for actual acceptance; both emit counts and missing case IDs, and the strict mode exits nonzero on gaps. Never invent universal timing/pixel/audio tolerances. Keep the existing TSK ordering correction, fresh direct-scene order and legitimate landing bank as protected observations rather than changes.</action>
<acceptance_criteria>There are eight uniquely identified matrix cells with explicit continuous and focused obligations; validators detect omitted dimensions and broken retained continuity; structural readiness and evidence acceptance use visibly different verdicts.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_scenarios.py"); assert s.countTestCases() >= 12,"fewer than 12 scenario tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 12 discovered tests, or a missing matrix/continuity/classification negative case passes validation.</fails_when>
</verify>
<done>Every required baseline run has a stable executable procedure, complete artifact obligations and a validator that preserves missing acceptance.</done>
</task>
</tasks>
<threat_model>
ASVS level 1; unresolved high/critical threats block execution acceptance. No package installs are planned.
| Boundary | Description |
|---|---|
| Authoritative originals → generated session | Reads may produce writable copies only outside originals |
| Imported local records → evidence index | Untrusted paths, classifications and identities become reviewable records |
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|---|---|---|---|---|---|
| T-01-01 | Tampering | stage_original | high | mitigate | Resolve aliases before allocation; reject overlaps; verify recorded originals before/after and staged bytes before execution |
| T-01-02 | Spoofing | validate_receipt/import_receipt | high | mitigate | Bind actual bytes, platform/method/scope and schema; reject promotion of synthetic/Wine/cross-publish; retain failures |
| T-01-03 | Tampering | Session publication | high | mitigate | Exclusive allocation, atomic completed publication, bounded failure diagnostics and conflicting-ID rejection |
| T-01-SC | Tampering | Package installation | high | mitigate | No new packages; any later proposed npm/pip/cargo install requires research legitimacy audit before execution |
</threat_model>
<verification>Run both counted test suites and original inventory check. Confirm current tree baselines: these new tooling/tests do not exist at planning time, so no new behavior is claimed verified. CLI negative tests must demonstrate nonzero exits, not only raised internal exceptions.</verification>
<success_criteria>Preservation and complete scenario contracts support independent viewer, ledger and native capture work without claiming new original/native execution.</success_criteria>
<output>Create .planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md with interfaces, actual test counts/durations and evidence boundaries.</output>
@@ -0,0 +1,163 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "01"
subsystem: testing
tags: [python, sha256, fidelity, preservation, receipts, scenarios]
requires: []
provides:
- Local preserved-session stage/identify/import/validate CLI
- Version 1 hashed receipt and read-only relative-reference contract
- Eight explicit lifetime/dialogue/input cells with 120 original/native obligations
affects: [01-02, 01-03, 01-04, 01-05, 01-06, 01-07]
tech-stack:
added: []
patterns: [stdlib-only tooling, exclusive allocation, atomic directory publication, streaming SHA-256, bounded JSON, explicit open acceptance]
key-files:
created:
- tools/recon/fidelity.py
- tools/recon/fidelity_receipts.py
- tests/test_fidelity_sessions.py
- docs/evidence/scenarios.json
- tests/test_fidelity_scenarios.py
modified: []
key-decisions:
- "A valid or reviewed receipt never implies native/original acceptance without identified bytes, compatible category, required artifacts and declared audiovisual review."
- "Each matrix cell requires continuous plus dialogue-return, bank-left, bank-right and landing-idle observations on original-DxWnd Windows, native Linux port and native Windows port: 120 obligations."
- "Retained runs bind one session, prerequisite departure/return observations and hashed copy state; fresh runs require independent launch/session IDs."
patterns-established:
- "Import IDs are append-only; only byte-identical duplicate records are idempotent."
- "Incomplete temporary publications retain diagnostics; stale locks are never stolen automatically."
requirements-completed: [EVID-01, EVID-02, EVID-04]
requirements-acceptance: "OPEN: these shared IDs remain Pending in REQUIREMENTS.md; this field records this plan's assigned contribution, not full requirement acceptance."
coverage:
- id: preserved-sessions
description: Preserved staging, actual byte identification and typed hashed imports
requirement: EVID-01
verification:
- kind: integration
ref: tests/test_fidelity_sessions.py
status: pass
- kind: other
ref: python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json
status: pass
human_judgment: false
- id: scenario-contract
description: Eight matrix cells, continuous/focused procedures and strict completeness audit
requirement: EVID-02
verification:
- kind: integration
ref: tests/test_fidelity_scenarios.py
status: pass
human_judgment: false
- id: runtime-acceptance
description: Actual identified original-DxWnd and native Linux/Windows audiovisual comparison
requirement: EVID-04
verification: []
human_judgment: true
rationale: "Future capture and human review are required; current real receipt coverage is 0/120. No new game or platform execution occurred in this plan."
actuals:
tokens: 21054
tasks: 2
commits: 4
basis: "ceil(chars/4) of the realized five-file production/test/protocol diff; excludes planning metadata"
plan_head_before: 96c5f2c00fd41e379945300b027e2c5ce9552845
plan_head_after: 32a72654e88ad3709aa1e2f0f108eea06e1b7469
duration: 16 min
started: 2026-11-12T23:56:04Z
completed: 2026-11-13
status: complete
---
# Phase 01 Plan 01: Preserved Sessions and Scenario Contract Summary
**Streaming original/copy/package identities, atomic typed receipt imports and eight explicit comparison cells preserve missing native/reference acceptance.**
## Performance
- Started: 2026-11-12T23:56:04Z; completed: 2026-11-13 UTC; approximately 16 minutes.
- Tasks: 2; source/test/protocol files created: 5; task commits: 4, measured from the persisted plan ledger.
- Final counted suites: 29 session tests in 0.698 seconds including process overhead; 22 scenario tests in 0.460 seconds. The combined discovery run executes 51 tests in 1.017 seconds.
- Original inventory: 539 unchanged files, final measured invocation 0.229 seconds.
## Accomplishments
- Real CLI fixture round trip stages a pristine installation, identifies its copy, imports paired explicitly synthetic WAV artifacts and prints a readable hashed receipt with OPEN acceptance. Hostile output paths and tampered evidence also return nonzero CLI exits.
- Preservation checks reject equal/nested/case/symlink aliases, changed/missing/added/empty identities, drive/traversal references, collisions and reuse. Source pre/post identity, pristine copy and post-run copy changes remain separate. Interrupted stage/import attempts retain incomplete diagnostics; concurrent stage allocation has one winner.
- Explicit procedures cover all fresh/retained × natural/skipped × ordinary/edge cells. Each has one continuous lab → VR04 → lab → outside journey plus four focused obligations, independently required on three original/native sides.
- Validators reject disconnected clips, timestamp resets, missing dimensions/events/artifacts, conflicting slots, reused fresh sessions, broken retained continuity and synthetic/Wine/component/cross-publish substitution. Structural readiness succeeds with visible gaps; strict acceptance exits 1 with 0/120 obligations accepted and all eight missing case IDs.
## Task Commits
1. Task 01-01-01 RED: `597caa0` — test preserved sessions and receipt trust boundaries.
2. Task 01-01-01 GREEN: `cd7783b` — implement stage/identify/import/validate and historical package identification.
3. Task 01-01-02 RED: `cc4a5a3` — test complete journey and lifetime matrix.
4. Task 01-01-02 GREEN: `32a7265` — enforce protocol, completeness and additional shared receipt security regressions.
Commits ran normal hooks, with explicit scoped staging. No tracked files were deleted. The existing user-authorized main workflow uses the primary's `git.allow_default_branch_commits` setting. The primary owns review, milestone status documents, integration and push; this executor did not push.
## Interfaces for Consumers
`fidelity_receipts.py` exports `stage_original(source, manifest, output, session_id)`, `identify_tree(root)`, `identify_file(path)`, `postflight_session(session, source, manifest)`, `validate_receipt(receipt, root)`, `import_receipt(path, root, output)`, `read_receipt(path)`, `contained_path(root, relative)`, `source_identity(project)`, `identify_report(...)`, `validate_scenario_contract(protocol)`, `required_events(protocol, cell, obligation_id)`, `audit_scenarios(protocol, [(receipt, root), ...])` and `audit_receipt_tree(protocol, root)`. Invalid input raises `ValueError`; filesystem failures propagate. CLI errors return 2; strict valid-but-open audit returns 1.
- Schema version 1 receipt: `receipt_id`, `session_id`, `case_id`, `evidence_kind`, `status`, `historical`, `scope`, `platform`, `identity`, `invocation`, `clocks`, `artifacts`, `derivatives`, `events`, `limitations`, `missing_evidence`, `acceptance`.
- `platform`: explicit `os`, `execution`; native port uses `native`, original Windows reference uses `dxwnd`, other kinds use their own category. Actual OS version and port GPU/driver/Vulkan/SDL provenance are required for acceptance.
- Artifacts/identity references use contained relative POSIX `path`, actual `size` and `sha256`. Artifacts carry `role`; timed media carries `duration_seconds`. Source identity additionally records commit, dirty/diff/status hashes and hashed untracked file identities. Invocations are inert argument arrays and a recorded cwd; imported commands are never executed.
- `clocks`: timezone-aware wall start/end plus finite monotonic start/end; scenario observations additionally require `clock_id`. Events use name/artifact/media_seconds/elapsed_seconds/method/uncertainty_seconds. Port simulation ticks are separate; original annotations remain manual/procedural.
- Scenario records add `obligation_id` and matching `scope`: `continuous`, `dialogue-return`, `bank-left`, `bank-right`, `landing-idle`; `case_id` equals the explicit cell ID. `continuity` binds lifetime/session and prerequisite artifact; retained cases also bind same departure/return session, identified pre/retained copy hashes and observed prerequisite markers preceding the tested interval.
- State-machine documentation lives in the module docstring and `RECEIPT_TRANSITIONS`. Import snapshots are immutable by ID; changing a capture/review requires a new receipt ID, rather than overwriting history. Synthetic imports require a separate output directory containing `test` in its name.
- JSON is bounded to 4 MiB, tree enumeration to 100000 entries, and tool-owned Git identity subprocesses to 20 seconds with bounded reads. Hashes stream in 1 MiB blocks. No dependencies were installed.
## Verification and Evidence Limits
Both exact counted plan commands passed, as did the mandated inventory command. Full logs and measured exit codes are in ignored `artifacts/fidelity/verification/`; the strict open audit's expected exit 1 is recorded there. Task 1 tracer verification ran again before expansion. Evaluation scope resolves all four task commits on the current branch.
One real on-disk `dist/linux-x64` package, its DLL/assets/launcher and `docs/gameplay/main-menu-player-lifetime.md` were hashed by the actual CLI. Ignored `artifacts/fidelity/historical-package.json` records package tree SHA-256 `eff9739dc6282ebb9e047f0a4a38e24b3c46e82502435e07c5a4b66bd31f05de` and DLL SHA-256 `8769ddd4e9f5fa8d4600dcca6ca46436385e14223097f44de68489bc4222f83b`. The report's recorded scope remains historical, with no current applicability or new runtime identity inferred from today's source HEAD. Missing-artifact behavior is separately tested.
The 120-slot positive test uses temporary metadata declarations solely to prove the counting/validation algorithm. The paired WAV fixture is explicitly synthetic and exercises import plumbing only. Neither is imported into the real receipt index. Hashes and declared human-review fields do not independently prove visible/audible content or truthful capture assertions; capture/probe/review/applicability remain later plan responsibilities. No original, DxWnd, Wine, native Windows, native Linux gameplay, browser, GPU, managed runtime, build or package execution was performed by this plan. Legacy `reference_capture.py`, movement, TSK ordering, fresh direct-scene order, legitimate landing bank and admission gates were not edited.
## TDD Gate Compliance
- Task 1: the real CLI round-trip target failed its stage-success assertion before implementation; full 25-test report and semantic assessment are in `artifacts/fidelity/tdd/01-01-01-red.json`. The classifier returned `RED_EVIDENCE_OK`; RED precedes GREEN in ancestry. Final suite has 29 passing cases.
- Task 2: the eight-cell target failed its explicit protocol-presence assertion before implementation; full 18-test report and semantic assessment are in `artifacts/fidelity/tdd/01-01-02-red.json`. The classifier returned `RED_EVIDENCE_OK`. That report also retains a separate missing-API error; the named target itself executed and failed the intended assertion. Final suite has 22 passing cases.
- REFACTOR: no separate refactor was necessary. No skipped/todo tests, unrun planned automated checks or implementation stubs remain.
## Deviations from Plan
### Auto-fixed Issues
**1. [Rule 2 - Missing Critical Functionality] Strengthened shared receipt security while completing scenario validation.**
- Found during: Task 2.
- Issue: shared import review needed directory-component case-alias checks and receipt-metadata sidecar tamper verification, in addition to file hashes.
- Fix: added these checks and regressions, bounded aggregate JSON output, and used actual paired synthetic WAVs. Task 2 consequently also edits `tests/test_fidelity_sessions.py`, beyond its narrow task file list but within the plan's exclusive ownership.
- Files: both fidelity modules, session/scenario tests.
- Verification: all 51 tests pass, including CLI tamper rejection and prefix-case collision tests.
- Commit: `32a7265`.
Total deviations: 1 correctness/security expansion within the planned boundary; no architectural or gameplay change. Optional broken-windows recording was attempted through the handler.
## Threat/Test Coverage
| Threat | Implemented controls | Evidence |
|---|---|---|
| T-01-01 | Alias/overlap checks before staging writes, exact inventory records, verified pristine copy, source pre/post checks | Session preservation/hostile-path/postflight tests; 539 original hashes |
| T-01-02 | Actual file hashes, typed platform/kind, explicit history/open acceptance, independent matrix slots and human review requirements | Tamper/classification/strict-audit and 120-slot metadata tests |
| T-01-03 | Exclusive allocation, sibling temporary publication, persistent incomplete diagnostics, exact duplicate bytes and conflicts | Concurrent allocation/interruption/duplicate import tests |
| T-01-SC | No package installation | Stdlib-only implementation |
No new endpoints, authentication paths or schema trust boundaries beyond the plan's local filesystem/import surface were introduced. The workflow serializes cooperative writers; concurrent hostile filesystem mutation is explicitly outside its offline threat boundary. Revalidate after collection and before review.
## Issues Encountered
None blocking. Synthetic fixtures stay separate from runtime proof. The unrelated `tools.yaml`, primary-owned config/state changes and milestone lock were preserved.
## User Setup Required
None for these tooling tests. Actual original-DxWnd/native capture and audiovisual review remain future combined checkpoint obligations, not requested prematurely here.
## Next Phase Readiness
Plans 01-02/03/04 can consume the versioned interfaces and scenario contract. Shared EVID-01/02/04 remain Pending until all declaring plans and actual acceptance conditions finish. Current strict audit is OPEN with 0/120 runtime obligations. The primary will update root continuity/compatibility documents and perform integration tests/push.
## Self-Check: PASSED
All five created source/test/protocol files exist. All four task commits are ancestors of current HEAD; evaluation-scope resolves them. Exact counted acceptance commands, original inventory and diff whitespace checks pass. No implementation stubs or unexplained tracked deletions were found.
@@ -0,0 +1,112 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "02"
type: execute
wave: 2
depends_on: ["01-01"]
files_modified:
- tools/recon/fidelity_review.py
- tools/recon/fidelity_viewer/index.html
- tools/recon/fidelity_viewer/viewer.mjs
- tools/recon/fidelity_viewer/style.css
- tests/test_fidelity_review.py
- tests/fidelity-viewer.test.mjs
autonomous: true
requirements: [EVID-02, EVID-03, EVID-04]
estimate:
tokens: 32000
raw_tokens: 32000
tasks: 2
confidence: low
must_haves:
truths:
- "A tester opens a local scenario with paired original/port playback and corresponding image, audio and input/event links per D-05."
- "Raw captures are unobstructed by default; annotations and provenance-bound image differences are optional overlays per D-06."
- "Selecting an event seeks each recording to its own observed time; both play at actual speed with separate elapsed clocks, event drift and playback drift per D-07."
- "The reviewer switches corresponding original/port audio with at most one source audible and visible review gain per D-08."
- "Missing, buffering, rejected-play, decoding and asymmetric-end states remain visible and preserve the full recording tails."
artifacts:
- path: tools/recon/fidelity_review.py
provides: "Contained local review export/server"
- path: tools/recon/fidelity_viewer/viewer.mjs
provides: "Testable paired media controller and capability navigation renderer"
- path: tests/fidelity-viewer.test.mjs
provides: "Built-in Node media-state tests without dependency installation"
key_links:
- from: tools/recon/fidelity_review.py
to: tools/recon/fidelity_receipts.py
via: "Only validated receipt/artifact identities enter generated review data"
- from: tools/recon/fidelity_viewer/viewer.mjs
to: "Generated review.json and contained media"
via: "Actual per-side event times and exclusive mute state"
prohibitions:
- statement: "MUST NOT manufacture apparent parity by retiming recordings, hiding drift, mixing both soundtracks or presenting synthetic media as an original reference."
status: unresolved
reason: "Spec-less recall; descriptor-less and flagged-unverified pending real playback judgment."
---
<objective>
Deliver the local paired review workflow per D-05–D-08. This is a filesystem-based tool, with a contained loopback viewer only where browser seeking requires it.
Artifacts this phase produces in this plan: fidelity_review.py CLI export and serve; generated review.json, index.html and copied/link-validated media under artifacts/fidelity/review; viewer.mjs exports createPairController and renderCapabilities; index.html/style.css; counted Python export/server tests and Node media-state tests. No hosted site or external integration.
</objective>
<execution_context>
@/home/cristian/.codex/gsd-core/workflows/execute-plan.md
@/home/cristian/.codex/gsd-core/templates/summary.md
</execution_context>
<context>
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
@.planning/phases/01-reproducible-fidelity-baseline/01-RESEARCH.md
@.planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md
</context>
<tasks>
<task type="tracer" tdd="true" id="01-02-01">
<name>Open one validated local pair with real media links and event selection</name>
<files>tools/recon/fidelity_review.py, tools/recon/fidelity_viewer/index.html, tools/recon/fidelity_viewer/viewer.mjs, tests/test_fidelity_review.py, tests/fidelity-viewer.test.mjs</files>
<read_first>01-RESEARCH.md Pattern 3 and Security Domain; 01-01-SUMMARY.md receipt interfaces; tools/recon/fidelity_receipts.py; docs/evidence/scenarios.json; 01-CONTEXT.md D-05–D-08.</read_first>
<behavior>At least 10 Python tests export and serve one valid imported pair end to end, preserve synthetic labels, reject traversal/symlinks/absolute or remote references and escaping labels, test GET/HEAD/byte-range seeking, and forbid write methods. Initial Node tests exercise event alignment, actual-speed playback, artifact links and failed play with media doubles.</behavior>
<action>Create tests before implementation. Export a self-contained review tree from validated receipts and their hashed artifacts; expose a real CLI flow from import output to generated review index and paired native media elements. Use one existing genuine port artifact where present and clearly labeled synthetic audiovisual pair fixtures for plumbing; display missing original reference explicitly. Retain raw recordings and derivative ancestry. Include links to original/port recordings, source audio, lossless stills and traces per D-05. Validate event correspondence and finite in-range timestamps before seeking. For local serving, bind loopback only, serve only the generated review root, reject resolved symlink escapes and unsupported methods, implement bounded GET/HEAD byte-range responses so seeking is exercised by tests; never expose repository/original roots or a write endpoint. Use textContent/escaped rendering and contained relative links, never imported HTML/commands. The browser shows scope/platform/synthetic/missing labels beside results, and no successful export or fixture is an acceptance receipt. Add capability-navigation rendering consuming the ledger model contract recorded in SKELETON.md, without inventing ledger facts.</action>
<acceptance_criteria>A CLI subprocess export plus local HTTP test opens both fixture media links and event metadata; malicious paths/labels cannot escape or execute; missing original is visible; generated media is local and properly classified.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_review.py"); assert s.countTestCases() >= 10,"fewer than 10 review tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 10 tests, failed CLI/export/range test, or a traversal/write-method negative case is accepted.</fails_when>
<automated>node --test tests/fidelity-viewer.test.mjs</automated>
<fails_when>Nonzero exit, zero tests or absence of a positive pass count; any media alignment/link/classification test fails.</fails_when>
</verify>
<done>One explicitly classified pair travels from validated receipt through local export/serving to the paired reviewer; no external request is required.</done>
</task>
<task type="auto" tdd="true" id="01-02-02">
<name>Complete truthful timing, exclusive audio, optional overlays and failure interaction</name>
<files>tools/recon/fidelity_viewer/index.html, tools/recon/fidelity_viewer/viewer.mjs, tools/recon/fidelity_viewer/style.css, tests/fidelity-viewer.test.mjs, tests/test_fidelity_review.py</files>
<read_first>The pair controller created in task 01-02-01; 01-CONTEXT.md D-06–D-08; 01-RESEARCH.md Pattern 3 and Meaningful Negative Cases.</read_first>
<behavior>At least 16 Node tests cover both elapsed clocks, event versus playback drift, rate 1.0 after seek/play/recovery, exclusive audio switch, default gain 1, labeled adjusted gain, missing/buffering/decode/play-rejection states, asynchronous seek readiness, asymmetric ends/tails, overlays default off and viewport mismatch. The test runner asserts its own nonzero count.</behavior>
<action>Keep video surfaces unobstructed by default and make annotation/difference layers separately opt-in per D-06. Event selection pauses both, waits for readiness, seeks each side independently to its own observed marker and resumes only on explicit review action at playbackRate 1 per D-07. Display absolute recording elapsed times, aligned-event elapsed offsets, scenario-event drift with uncertainty and browser playback drift separately. No periodic follower seeking, duration normalization or hidden timing correction. Expose per-side manual controls and raw media links. On buffering/missing/decode/play rejection pause the pair and show the cause; if one side ends, preserve and make the longer tail playable instead of trimming it. Mute both before selecting one soundtrack at corresponding times per D-08; gain starts unadjusted, is visibly labeled review-only when changed, and never changes recorded media. Optional image differences require matched lossless frame identity, viewport/aspect and crop metadata; explain mismatches and avoid numerical fidelity claims from lossy video. Add keyboard-accessible controls, readable narrow-window layout and explicit empty review states. Keep raw captures and elapsed time visible throughout.</action>
<acceptance_criteria>Sixteen or more behavior tests pass; both tracks always remain at real speed; at most one soundtrack is audible; initial overlays are off; failures and longer tails remain accessible. Browser/real-audio judgment remains an end-of-phase human check.</acceptance_criteria>
<verify>
<automated>node --test tests/fidelity-viewer.test.mjs</automated>
<fails_when>Nonzero exit, fewer than 16 declared/executed tests, missing positive test summary, or any drift/rate/audio/error/overlay assertion fails.</fails_when>
<human-check>During the single combined session, open real paired media in the actual browser; hear each source separately, seek observed markers, inspect asymmetric tails and toggle overlays. Record browser/version/codec failures and leave affected review acceptance open.</human-check>
</verify>
<done>The paired reviewer implements D-05–D-08 with tested state handling; actual codec/audio playback is listed for the one final session without creating an earlier user request.</done>
</task>
</tasks>
<threat_model>
ASVS level 1; high/critical unresolved threats block acceptance. No package installs.
| Boundary | Description |
|---|---|
| Imported evidence → HTML/media | Labels and paths become local browser content |
| Loopback HTTP → generated files | Only the contained generated tree is readable |
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|---|---|---|---|---|---|
| T-01-04 | Information disclosure | fidelity_review server | high | mitigate | Loopback only, root containment, symlink rejection, bounded byte ranges, read-only methods |
| T-01-05 | Tampering | Viewer text/media links | high | mitigate | Escaped/text rendering, local relative URL allowlist and no receipt commands/HTML execution |
| T-01-06 | Spoofing | Pair controller | medium | mitigate | Visible evidence category, raw clocks, rate 1 and explicit missing/uncertainty states |
| T-01-SC | Tampering | Package installation | high | mitigate | Built-in browser/Node/Python only; no npm/pip additions |
</threat_model>
<verification>Run counted Python and Node checks. First real-media browser acceptance occurs with final combined session; fixture playback is tooling evidence only.</verification>
<success_criteria>Local paired review exposes visual/audio/event correspondence without concealing drift or inventing original execution.</success_criteria>
<output>Create .planning/phases/01-reproducible-fidelity-baseline/01-02-SUMMARY.md with local invocation and measured checks.</output>
@@ -0,0 +1,176 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "02"
subsystem: testing
tags: [python, native-media, node, local-http, fidelity, evidence]
requires:
- phase: 01-01
provides: Version 1 validated hashed receipts and scenario contract
provides:
- Self-contained review export with contained read-only loopback GET/HEAD ranges
- Independent event seeks, raw clocks, drift, exclusive audio and preserved tails
- Capability navigation with validated copied source text and explicit missing states
affects: [01-03, 01-05, 01-06, 01-07]
tech-stack:
added: []
patterns: [stdlib-only export, native browser media, independent clocks, opt-in review aids, built-in Node tests]
key-files:
created:
- tools/recon/fidelity_review.py
- tools/recon/fidelity_viewer/index.html
- tools/recon/fidelity_viewer/viewer.mjs
- tools/recon/fidelity_viewer/style.css
- tests/test_fidelity_review.py
- tests/fidelity-viewer.test.mjs
modified: []
key-decisions:
- "Review exports always retain OPEN acceptance; synthetic/history labels and absent original/native recordings stay explicit."
- "Pair playback uses rate 1 with separately observed event anchors, independent clocks, visible drift and explicit recovery; longer tails remain playable."
- "Capability source links are copied only from contained tracked bounded UTF-8 text; the viewer activates only exporter-validated local hrefs."
requirements-completed: [EVID-02, EVID-03, EVID-04]
requirements-acceptance: "OPEN: assigned tooling contributions only; shared EVID IDs remain Pending and real runtime coverage remains 0/120."
coverage:
- id: contained-review
description: Validated receipt export, contained HTTP seeking and local source links
requirement: EVID-02
verification:
- kind: integration
ref: tests/test_fidelity_review.py
status: pass
human_judgment: false
- id: paired-controller
description: Event alignment, raw clocks, drift, exclusive audio, failure states and optional aids
requirement: EVID-03
verification:
- kind: unit
ref: tests/fidelity-viewer.test.mjs
status: pass
- kind: automated_ui
ref: artifacts/fidelity/viewer-smoke-final/browser-result.json
status: pass
human_judgment: false
- id: real-audiovisual-review
description: Actual original/native recordings, audible source switching and browser/codec judgment
requirement: EVID-04
verification: []
human_judgment: true
rationale: "Headless synthetic playback verifies tooling only. Actual identified original/native media and audible review belong to the final combined session."
actuals:
tokens: 18814
tasks: 2
commits: 4
basis: "ceil(chars/4) over the realized six-file production/test diff, excluding planning metadata"
plan_head_before: 6be848480288480208ac737c953b7c9bfc82bd84
plan_head_after: 91da92f17d93ba80ead87f92cf4714b6635133bb
duration: 16 min
started: 2026-11-13T00:30:27Z
completed: 2026-11-13
status: complete
---
# Phase 01 Plan 02: Local Paired Review Summary
**Contained hashed-media export and actual-speed paired playback expose event/playback drift, exclusive audio, optional still differences and complete recording tails.**
## Performance
- Measured implementation window: first persisted RED evidence at 00:30:27 UTC through final verification at 00:46:15 UTC, rounded to 16 minutes. Required setup/context reads preceded this measurement.
- Two tasks; six source/test files; four task commits measured from the persisted ledger.
- Final exact checks: 21 Python review tests, 5.234 seconds including process startup; 27 Node tests, 0.120 seconds. Combined fidelity discovery: 72 tests, 6.318 seconds. Original inventory: 539 unchanged files, 0.268 seconds.
- Full logs and command/exit/time records: ignored `artifacts/fidelity/verification/01-02-*`.
## Accomplishments
- A real subprocess exports imported hashed receipts into a new self-contained directory. Tests read both media links and event metadata over actual loopback HTTP, including HEAD, prefix/open/suffix ranges and invalid-range rejection.
- Both recordings seek to their own observed markers after metadata/seek readiness. Explicit play preserves rate 1, and raw elapsed clocks, event offsets, event drift plus uncertainty, and browser playback drift remain separately visible. No follower seeks, duration normalization or retiming occur.
- Dedicated keyboard-accessible per-side play/pause/seek controls coexist with exclusive soundtrack selection and visibly labeled review-only volume. Buffering, missing media, decoding failure, play rejection, stale asynchronous actions and asymmetric endings remain explicit; the full longer tail can resume.
- Annotations and lossless image differences begin off and leave raw captures unobstructed. Difference eligibility requires identified PNGs, source-media hashes, corresponding observed event timestamps, matching dimensions/viewport/aspect/crop and successful image decoding. Differences have no numerical fidelity score.
- Capability navigation preserves supplied facts/current evidence/history, orders discrepancies by impact, and links copied validated source text. Empty ledger and missing-source states remain explicit.
## Task Commits
1. Task 01-02-01 RED: `488c904` — specify contained paired media review.
2. Task 01-02-01 GREEN: `49f874e` — export and serve validated local media pairs.
3. Task 01-02-02 RED: `75d7ca4` — specify truthful timing, audio and failure states.
4. Task 01-02-02 GREEN: `91da92f` — preserve clocks, exclusive audio and complete review tails.
Normal hooks ran with scoped staging. No tracked files were deleted. The primary owns milestone review and push; this executor did not push.
## Local Invocation and Interfaces
```sh
python3 tools/recon/fidelity_review.py export \
--original PATH/TO/IMPORTED-ORIGINAL/receipt.json \
--port PATH/TO/IMPORTED-PORT/receipt.json \
--ledger PATH/TO/CAPABILITY-EXPORT.json \
--output artifacts/fidelity/review/NEW-PAIR
python3 tools/recon/fidelity_review.py serve \
--root artifacts/fidelity/review/NEW-PAIR --port 8765
```
Open `http://127.0.0.1:8765/`. Either receipt and the ledger may be omitted; absent evidence stays visible. Output must be a new directory. Invalid input exits 2. Serving requires a generated `.review-root.json` manifest and only binds `127.0.0.1`; it never serves the repository or Original directory. The exporter copies/revalidates bytes, retains raw artifacts/derivative ancestry, and never executes receipt argv. Failed publication retains its incomplete temporary sibling.
Python APIs: `export_review(original, port, output, ledger=None)` returns the model; `make_server(root, port=8765, host='127.0.0.1')` returns an owned `ThreadingHTTPServer`. The caller closes/shuts down that server. The generated root contains `review.json`, the three viewer files, side-specific receipt/artifacts and optional `sources/` text.
`review.json` version 1 contains `case_id`, `sides.original/port`, corresponding `events`, `ledger`, and explicit OPEN acceptance. Side records preserve kind/platform/scope/history/limits/identities, hashed `artifacts` with local `url`, selected `media`, observed `events`, `derivatives`, `receipt_url`, missing evidence and warnings. Only markers on the selected video/explicit preview are seekable; a preview without its own observed correspondence has visible gaps. Same case/scope and unambiguous event names are required. No timestamps are inferred from derivatives.
ES module exports: `createPairController`, `safeLocalURL`, `differenceEligibility`, `framePair`, `renderCapabilities`. Controller methods are `selectEvent`, `play`, `playSide`, `seekSide`, `pause`, `snapshot`, `setAudio`, `setGain`, `setOverlay`, `dispose`; media elements and change callback are injected for testing. Volume starts at 1 and can be attenuated from 0 to 1. Both sources are muted before audio selection; dedicated UI controls prevent native media controls independently enabling another soundtrack.
Optional PNG artifact metadata is `frame: {lossless,event,media_sha256,media_seconds,viewport:[w,h],crop:[x,y,w,h],width,height}`. It binds an identified PNG to its own selected source media and observed marker; unmatched provenance/dimensions disable the aid. PNG decoding must agree with declared dimensions. Raw video remains available, and still differences are review aids even when extracted from lossy video.
The coordinated ledger input contract is `{schema_version:1, capabilities:[...]}` with SKELETON fields `id/group/requirement_ids/summary/verified_scope/differences/acceptance/source_links/scenario_ids/evidence/current/history/discrepancies`. Evidence/current/history are rendered read-only without inventing acceptance facts. `source_links` entries are `{label,path,sha256?}` with repo-relative paths. Export resolves containment, rejects symlinks/private/generated/original roots, requires tracked non-NUL UTF-8 text at most 1 MiB, and verifies optional hashes. Exported links add `{href,validated_local,sha256,size,missing}`; only validated `sources/...` hrefs become links. Safe missing/untracked references have `href:null`, `validated_local:false`, and a visible reason. Other imported HTML/commands remain inert.
## Browser and Evidence Limits
Installed Chromium `157.0.8103.38` decoded local synthetic VP8/Vorbis recordings through the real server. A loopback CDP check verified `.500/.750` event seeks while paused, subsequent actual-speed playback, original/port mute exclusivity, visible volume adjustment, opt-in annotations/difference canvas, a 390px layout without horizontal overflow, and explicit longer-tail playback after the 3.003-second recording ended while the 5.003-second recording retained its tail. The copied source-document link returned HTTP 200. No page runtime exceptions were observed.
Ignored evidence is in `artifacts/fidelity/viewer-smoke-final/browser-result.json` and `browser.png`; fixture generation/CDP scripts are retained alongside them. The final generated synthetic viewer is `test-review-v3/` within that directory. Synthetic moving patterns and tones are labeled throughout, and no genuine original reference is implied. Browser media state checks do not prove audible hardware output or human audiovisual adequacy.
The genuine existing port output `artifacts/window-transitions/2-VR04-1280x720.png` was hashed/imported separately as **historical port_fixture** evidence and exported to `historical-review/`. Chromium displayed its historical label, raw still link, missing playable video and missing original reference. This does not establish a new runtime/source revision or applicability receipt.
Actual original-DxWnd, native Linux/Windows scenario recordings, codec variation and audible judgment remain for the one final combined session. Acceptance stays OPEN at 0/120 real obligations. Shared EVID IDs are not marked complete. No gameplay/runtime/package code, originals or shared receipt/scenario implementation changed; no game, DxWnd, Wine, GPU, managed build or Windows execution was performed here.
## TDD Gate Compliance
- Task 1: `artifacts/fidelity/tdd/01-02-01-red.json` retains the complete actual unittest report. The named CLI round-trip target failed its intended CLI-presence assertion before implementation. The classifier returned `RED_EVIDENCE_OK`; semantic inspection confirmed a behavior assertion rather than import/setup failure. The tracer's exact 15-Python/6-Node checks passed again before task 2.
- Task 2: `artifacts/fidelity/tdd/01-02-02-red.json` retains complete TAP. The named buffering test failed because replay incorrectly returned true while readyState was 2. The classifier returned `RED_EVIDENCE_OK`; other absent-API failures were retained rather than used as target evidence. Final suites pass 21 Python and 27 Node tests, with a dynamic minimum registered-count assertion.
- Each RED commit precedes its GREEN in ancestry. No separate refactor was needed. No skipped/todo tests or unrun planned automated checks remain.
## Deviations from Plan
No scope or architecture changes. The initial stylesheet was included with the tracer so its exported review tree was self-contained. The primary confirmed the exact tracked source-link normalization for plan 01-03 during implementation; this fulfills the planned capability navigation boundary without shared schema edits.
## Threat/Test Coverage
| Threat | Controls and evidence |
|---|---|
| T-01-04 | Generated-root manifest allowlist, actual hashes, loopback-only bind, resolved containment, symlink rejection, no listings, GET/HEAD-only reads, bounded single ranges; real HTTP negative/range tests |
| T-01-05 | Text rendering, relative URL allowlist, no imported HTML/argv execution, CSP/nosniff, imported active documents downloaded inertly, validated copied text sources; hostile-label/path/document tests |
| T-01-06 | Explicit category/history/missing labels, independent clocks, rate 1, separate drift/uncertainty, no auto-acceptance; controller/browser/classification tests |
| T-01-SC | Browser/Node/Python built-ins only; no npm/pip installation. Existing ffmpeg produced ignored synthetic smoke media. |
## Threat Flags
| Flag | File | Description |
|---|---|---|
| threat_flag: file-access | tools/recon/fidelity_review.py | Ledger source references cross the repository-text→generated-review boundary. Contained tracked bounded UTF-8-only copies, excluded roots, optional hash checks, inert text MIME and the generated manifest mitigate this planned navigation surface. |
The cooperative offline filesystem boundary matches the shared receipt module; hostile concurrent filesystem replacement is outside that model. Re-export/revalidate after evidence changes. Native media/browser codec support remains a runtime review condition.
## Issues Encountered
The sandbox blocks loopback sockets and causes Node's child test runner to report one file-only result. Authorized local-test escalation produced the real named counts and HTTP results; the file-only result was not counted as validation. A browser-cancelled read exposed a broken-pipe retry; the handler now ends disconnected responses cleanly. Newer seek actions supersede stale metadata waits without cancelling the current action. These fixes remain within planned failure handling.
No implementation stubs remain. Deliberately absent media/ledger states are implemented outcomes, not mock gameplay data. `tools.yaml`, the transient milestone lock and other owners' files were preserved.
## User Setup Required
None for the local tool checks. The planned combined hands-on original/native/audio session remains open; no earlier user execution request was created.
## Next Phase Readiness
Plan 01-03 can emit the coordinated capability/source-link contract; later checkpoint/capture/import plans can supply real receipts. The primary owns root continuity documents, integrated runtime regression gates and push. The existing gameplay and platform evidence limits remain binding.
## Self-Check: PASSED
All six created files exist. All four task commits are ancestors of HEAD and evaluation-scope resolves them on this branch. Exact counted plan checks, all 72 fidelity tests, whitespace checks and the 539-file preservation command pass. No tracked deletions, skipped tests or unexplained new untracked outputs were introduced; generated media/receipts stay ignored.
@@ -0,0 +1,114 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "03"
type: execute
wave: 2
depends_on: ["01-01"]
files_modified:
- tools/recon/fidelity_ledger.py
- tests/test_fidelity_ledger.py
- docs/evidence/capabilities.json
- docs/evidence/README.md
autonomous: true
requirements: [EVID-03]
estimate:
tokens: 28000
raw_tokens: 28000
tasks: 2
confidence: low
must_haves:
truths:
- "Reviewers browse movement, contacts, gadgets, progression, visuals and audio with requirement/source/scenario/platform links per D-09."
- "Each capability leads with working behavior, verified scope/platform, known differences and remaining acceptance per D-10."
- "Current applicable evidence precedes expandable explicitly superseded revision history per D-11; applicability uses content/scope/platform rather than newest date."
- "Discrepancies order blocking/disruptive failures before subtler differences and missing verification per D-12; all missing evidence keeps acceptance open."
- "All 33 full-game requirements have capability coverage even when unimplemented; an empty ledger fails and one capability remains renderable."
- "Equal receipt/content identities merge only when the record bytes match; conflicts remain explicit, and duplicate history rows never silently overwrite evidence."
- "Equal-priority entries have deterministic stable ID ordering; explicit supersession cycles and unresolved contradictory current claims fail validation."
artifacts:
- path: docs/evidence/capabilities.json
provides: "Authoritative full-game capability ledger"
- path: tools/recon/fidelity_ledger.py
provides: "Scope-aware validator and deterministic render/export"
- path: docs/evidence/README.md
provides: "Generated capability-first navigation and evidence instructions"
key_links:
- from: docs/evidence/capabilities.json
to: .planning/REQUIREMENTS.md
via: "Complete 33-ID coverage with implementation/evidence/acceptance separation"
- from: tools/recon/fidelity_ledger.py
to: "Generated ledger.json consumed by paired review"
via: "SKELETON.md shared capability contract; no parallel viewer file writes"
prohibitions:
- statement: "MUST NOT erase contradictory history, hide unimplemented required content or turn missing evidence into a fidelity-completion claim."
status: unresolved
reason: "Spec-less recall; project-specific transparency value, descriptor-less and flagged-unverified."
---
<objective>
Make the full reconstruction auditable through one authoritative capability ledger per D-09–D-12, retaining all evidence boundaries and exact current applicability.
Artifacts this phase produces in this plan: capabilities.json schema-versioned records; fidelity_ledger.py validate/render/export CLI and select_current_evidence function; generated docs/evidence/README.md navigation; tests/test_fidelity_ledger.py. Exported ledger.json stays below artifacts/fidelity/review. No parallel edits to viewer or root status files.
</objective>
<execution_context>
@/home/cristian/.codex/gsd-core/workflows/execute-plan.md
@/home/cristian/.codex/gsd-core/templates/summary.md
</execution_context>
<context>
@.planning/PROJECT.md
@.planning/REQUIREMENTS.md
@.planning/ROADMAP.md
@.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
@.planning/phases/01-reproducible-fidelity-baseline/01-RESEARCH.md
@.planning/phases/01-reproducible-fidelity-baseline/SKELETON.md
@.planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md
</context>
<tasks>
<task type="tracer" tdd="true" id="01-03-01">
<name>Trace one real capability from source report to current receipt and review navigation</name>
<reversibility rating="costly">The ledger is a shared evidence interface; version it and generate all presentation from its retained records.</reversibility>
<files>tools/recon/fidelity_ledger.py, tests/test_fidelity_ledger.py, docs/evidence/capabilities.json, docs/evidence/README.md</files>
<read_first>docs/checkpoint/coverage.md; docs/compatibility.md; docs/gameplay/main-menu-player-lifetime.md; docs/gameplay/jimmy-movement-stabilization.md; .planning/REQUIREMENTS.md; SKELETON.md capability contract; 01-RESEARCH.md Pattern 4.</read_first>
<behavior>At least 12 tests cover one real capability render/export round trip, empty/single ledger, duplicate/conflicting IDs/history, equal-priority ordering, supersession cycles, nonexistent/unsafe links, docs-only revisions, changed package/resources, mismatched platform/scope and missing evidence remaining open.</behavior>
<action>Create tests first. Implement one fully populated capability for the already corrected TSK-backed first-story input order using current authoritative reports, preserving direct-fresh distinction and legitimate landing bank. Link source evidence, implementation revision and exact bounded runtime receipt/report, with missing local artifacts explicitly recorded. Lead with what works, where verified, differences and acceptance per D-10. Define records with stable capability ID, group, requirement IDs, behavior/scenes, source links/addresses when present, implementation source revision, evidence records with method/platform/content/scope and artifact identities, current applicability, discrepancies and acceptance. Current receipt selection must use exact content identity and scope; a newer docs commit does not supersede unchanged runtime bytes, while changed runtime/resources require explicit applicability review. Keep prior statements in history with revision, supersedes ID/reason and current/superseded status per D-11. Produce readable Markdown and JSON review navigation from the same data. The actual capability round trip must show its remaining original/native Windows acceptance; a report link is not a newly executed run. Require finite bounded data and safe repository/local artifact references. Validate conflicting duplicate records and deterministic ordering before rendering, with stable IDs as tie-breakers.</action>
<acceptance_criteria>A reviewer can follow one real capability through source, implementation, bounded platform proof, prior narrative and remaining acceptance; generated navigation agrees with the authoritative JSON; tamper/empty/history failures are test-covered.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_ledger.py"); assert s.countTestCases() >= 12,"fewer than 12 ledger tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 12 tests, missing round-trip result, or any stale/empty/conflicting/history negative case passes.</fails_when>
</verify>
<done>One real capability is auditable through generated navigation with truthful current applicability and visible open acceptance.</done>
</task>
<task type="auto" tdd="true" id="01-03-02">
<name>Account for the complete game and rank actionable discrepancies</name>
<files>docs/evidence/capabilities.json, docs/evidence/README.md, tools/recon/fidelity_ledger.py, tests/test_fidelity_ledger.py</files>
<read_first>docs/progress.md; docs/tasks.md; docs/decisions.md; docs/checkpoint/implementation-plan.md; docs/checkpoint/next-work-plan.md; .planning/REQUIREMENTS.md; all source reports linked by the capability rows being reconciled, read only as needed.</read_first>
<behavior>Extend to at least 16 tests, requiring all 33 requirement IDs and all six locked capability groups; test unimplemented rows, receipt/scenario links, current/history separation, missing-proof open status and impact order blocking→disruptive→subtle→missing-verification with stable ties.</behavior>
<action>Populate every full-game requirement category per D-09 using existing recovery and implementation reports, including unimplemented/unverified work. Preserve all existing checkpoint coverage rows by a corresponding detail row or explicit linked source; record reconciliation so no historical source row disappears silently. Include movement, contacts/helpers, gadgets/vehicles, actors/hazards, authored progression/content, menus/persistence, visuals/cameras, audio and native delivery. Map all 33 requirement IDs without claiming they are implemented. For each row lead with D-10 fields and link the relevant scenarios/source/platform proof; retain exact historical package revisions and limited Wine/component/cross-publish classifications. Rank player-impact discrepancies per D-12 with deterministic ties, but keep verification gaps in acceptance even when displayed later. Export grouping, current summary, expandable history data and scenario links using the shared contract so the viewer can consume it without editing its files. validate must fail on unmapped requirements, missing critical fields, dead source links, contradictory current claims and invalid receipt classifications. Record explicitly missing generated artifacts as known gaps instead of dropping their entries. Generate README.md rather than maintaining a second independent status table.</action>
<acceptance_criteria>All 33 requirement IDs and existing checkpoint coverage entries are accounted for; current and superseded evidence retain exact revisions; missing evidence is visible and open; deterministic discrepancy sorting matches D-12.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_ledger.py"); assert s.countTestCases() >= 16,"fewer than 16 ledger tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 16 tests, or any requirement-coverage/impact/applicability assertion fails.</fails_when>
<automated>python3 tools/recon/fidelity_ledger.py validate --ledger docs/evidence/capabilities.json --requirements .planning/REQUIREMENTS.md</automated>
<fails_when>Nonzero exit or missing summary requirements=33 unmapped=0; any contradictory current record or unresolved broken source link.</fails_when>
</verify>
<done>The full game is traceable in one authoritative capability ledger, and its navigation never conflates implementation, recovered source, bounded execution and remaining acceptance.</done>
</task>
</tasks>
<threat_model>
ASVS level 1; unresolved high/critical threats block acceptance.
| Boundary | Description |
|---|---|
| Historical reports → current capability claims | Report scope and actual identity must survive reconciliation |
| Ledger references → generated navigation | Untrusted labels/paths are emitted as readable local data |
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|---|---|---|---|---|---|
| T-01-07 | Spoofing | select_current_evidence | high | mitigate | Exact content/platform/scope checks; explicit supersession; contradictory current evidence blocks validation |
| T-01-08 | Repudiation | Evidence/history import | medium | mitigate | Stable record IDs, duplicate conflict rejection, source-row reconciliation and deterministic history ordering |
| T-01-09 | Tampering | Ledger render/export | medium | mitigate | Escaped text and validated local/repository links; no executable imported commands |
| T-01-SC | Tampering | Package installation | high | mitigate | Stdlib-only ledger tools; no new package installation |
</threat_model>
<verification>Run counted ledger tests and full 33-ID validation. Inspect generated capability summary/history against the authoritative TSK and current platform reports. No native execution is claimed by ledger completion.</verification>
<success_criteria>Full-game proof and remaining acceptance can be reviewed by capability, with current applicability and discrepancies preserved.</success_criteria>
<output>Create .planning/phases/01-reproducible-fidelity-baseline/01-03-SUMMARY.md with reconciliation counts, authoritative model and open evidence.</output>
@@ -0,0 +1,163 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "03"
subsystem: testing
tags: [python, capability-ledger, fidelity, sha256, reconciliation]
requires:
- phase: 01-01
provides: Version 1 receipts and eight-cell scenario protocol
- phase: 01-02
provides: Actual contained viewer export and source-link normalization
provides:
- Authoritative 25-capability ledger covering all 33 full-game requirements
- Exact reconciliation of 16 checkpoint systems, 11 owners and six assumptions
- Scope/content/platform selection, preserved supersession and generated navigation
affects: [01-04, 01-05, 01-06, 01-07, movement, delivery]
tech-stack:
added: []
patterns: [stdlib-only validation, hashed source rows, explicit documentary scope, generated Markdown and JSON]
key-files:
created:
- tools/recon/fidelity_ledger.py
- tests/test_fidelity_ledger.py
- docs/evidence/capabilities.json
- docs/evidence/README.md
modified: []
key-decisions:
- "Full-game coverage includes bounded, unimplemented and tooling work; coverage and report validity never promote native/reference acceptance."
- "Checkpoint reconciliation hashes every system/ownership row and numbered assumption and requires a retained source link from each mapped capability."
- "Current evidence means exact named content/platform/scope applicability; documentation dates and newer source HEAD never substitute for runtime bytes."
patterns-established:
- "One authoritative JSON model generates Markdown and viewer export; equal receipt IDs merge only byte-identical records across the entire ledger."
- "Imported receipt references bind actual receipt digest, category, platform, scope and historical flag; legacy report records remain separately described."
requirements-completed: [EVID-03]
requirements-acceptance: "OPEN: assigned ledger contribution only. EVID-03 remains Pending because other declaring plans and runtime acceptance are unfinished. All 120 actual original/native obligations remain open."
coverage:
- id: capability-accounting
description: All 33 requirements, six groups and 33 checkpoint source rows are explicitly accounted for
requirement: EVID-03
verification:
- kind: integration
ref: tests/test_fidelity_ledger.py
status: pass
- kind: other
ref: python3 tools/recon/fidelity_ledger.py validate --ledger docs/evidence/capabilities.json --requirements .planning/REQUIREMENTS.md
status: pass
human_judgment: false
- id: review-roundtrip
description: Actual ledger CLI and viewer export preserve all capability/current/history/scenario/acceptance data and copied source links
requirement: EVID-03
verification:
- kind: integration
ref: tests/test_fidelity_ledger.py#test_real_startup_capability_cli_and_viewer_roundtrip
status: pass
human_judgment: false
- id: actual-reference-acceptance
description: Identified whole-original and current native Linux/Windows gameplay and audiovisual comparison
verification: []
human_judgment: true
rationale: "Existing reports and bounded historical fixtures are not the required original-DxWnd/native scenario recordings or human review; actual matrix acceptance remains 0/120."
actuals:
tokens: 78646
tasks: 2
commits: 5
basis: "ceil(chars/4) over the realized four-file production/test/model/navigation diff (314583 chars), excluding planning metadata. Commit count is the actual persisted-ledger range, including the intervening pause handoff commit."
plan_head_before: be18d77ca42b1896540ff21122bbc1e684195dc1
plan_head_after: 4d07d60e2fdbfdb065aaa2e7e780055620984521
duration: 22 min
started: 2026-11-13T00:48:50Z
completed: 2026-11-13
status: complete
---
# Phase 01 Plan 03: Full-Game Capability Ledger Summary
**A generated 25-capability ledger maps all 33 requirements, reconciles 33 hashed checkpoint entries and preserves exact startup-order evidence with open native/reference acceptance.**
## Performance
- Two tasks; four created files. Approximate active execution windows total 22 minutes: prior-plan close at 00:48:50 through pause handoff at 01:02:30, then resumed state at 03:49:05 through verification/commit at 03:57:36 UTC. Approximately 189 wall minutes include the explicitly requested usage pause.
- Persisted base-to-production-HEAD range contains five commits: four task RED/GREEN commits and one pause handoff. Evaluation-scope independently resolves the four task commits on this branch.
- Final ledger suite: 31 tests, 0.980 seconds; all fidelity Python suites: 103 tests, 7.149 seconds (7.229 seconds including process overhead); Node: 27 named tests, 82.360 milliseconds. Original inventory: 539 unchanged files.
## Accomplishments
- The authoritative model accounts for movement, contacts/helpers, actors/hazards, gadgets/vehicles/inventory, authored content/progression, frontend/configuration/persistence, visuals/cameras, audio and native delivery. Its six locked navigation groups contain 25 capabilities: 21 bounded, three explicitly unimplemented full-scope workflows and one tooling capability. Coverage is 33 requirements, zero unmapped.
- Reconciliation retains all 16 system rows, 11 ownership rows and six numbered assumptions from `docs/checkpoint/coverage.md`. Each has exact source-row SHA-256, retained source path and mapped capability IDs. Missing, changed, duplicate or extra source rows and absent retained source links fail validation. Baseline wording remains in its source; continuation summaries explicitly refine it.
- The real startup row retains already-corrected TSK story-entry order, separate fresh direct-scene order, valid landing bank, actual source addresses/REA identifier and exact historical ea04210 Linux/Wine classifications. Prior incorrect fresh-story inference stays explicitly superseded with its successor and reason. Report validity is distinct from runtime applicability.
- Markdown and JSON exports come from the same model. A real subprocess ledger export feeds the existing `fidelity_review.export_review` without viewer edits. All 25 rows preserve their current/history/scenario/acceptance/discrepancy fields; all 153 source-link entries resolve to validated copied text files. Current evidence precedes history; discrepancies sort blocking, disruptive, subtle, missing_verification, then stable ID.
- Validation rejects empty/unmapped ledgers, conflicting duplicate capabilities/receipts/history, cycles, unresolved contradictory current claims, unsafe/dead/tampered sources, nonfinite/unbounded data, unknown scenarios, invalid categories and stale artifact hashes. Actual imported receipts are revalidated and bound to their digest/platform/scope/history instead of accepting a relabeled reference.
## Task Commits
1. Task 01-03-01 RED: `ded848f` — specify capability applicability and review navigation.
2. Task 01-03-01 GREEN: `e6713ea` — trace corrected TSK order through capability evidence.
3. Task 01-03-02 RED: `c21ed7d` — require complete game and checkpoint source coverage.
4. Task 01-03-02 GREEN: `4d07d60` — reconcile full-game capability and checkpoint coverage.
Intervening `fafbd05` is the primary's pause handoff, not another task implementation. Normal hooks ran with explicit scoped staging. No tracked production files were deleted. Main commits use the user-authorized configuration; the primary owns integration and push.
## Files and Interfaces
- `docs/evidence/capabilities.json`: schema_version 1 authoritative facts; 25 capabilities, 28 typed documentary/historical evidence records, 33 reconciliation entries, explicit evidence policy. Unimplemented workflows are honest coverage rows, not implementation stubs.
- `tools/recon/fidelity_ledger.py`: `validate_ledger(data, project, requirements=None)`, `export_ledger(...)`, `render_markdown(...)`, `select_current_evidence(records, target)` and `checkpoint_rows(path)`. Invalid input raises `ValueError`; CLI failures exit 2. Full reconciled CLI models automatically use `.planning/REQUIREMENTS.md` if the optional flag is omitted; singleton API fixtures remain renderable.
- `tests/test_fidelity_ledger.py`: 31 behavior/integration regressions, including actual imported synthetic receipts and the genuine historical startup evidence/viewer round trip.
- `docs/evidence/README.md`: generated capability-first navigation, exact current targets, expandable history, remaining acceptance and source reconciliation. It is not independently maintained status.
```sh
python3 tools/recon/fidelity_ledger.py validate --ledger docs/evidence/capabilities.json --requirements .planning/REQUIREMENTS.md
python3 tools/recon/fidelity_ledger.py render --ledger docs/evidence/capabilities.json --output docs/evidence/README.md
python3 tools/recon/fidelity_ledger.py export --ledger docs/evidence/capabilities.json --output artifacts/fidelity/review/ledger.json
python3 tools/recon/fidelity_review.py export --ledger artifacts/fidelity/review/ledger.json --output artifacts/fidelity/review/new-review
```
Viewer input uses the established capability contract and source links `{label,path,sha256?}`. It adds contained copied `href/validated_local/sha256/size/missing` fields. Ledger source text is contained, tracked, UTF-8/non-NUL and at most 1 MiB per file. Optional source hashes and actual artifact identities are checked. Generated output stays local under the project or `/tmp`, rejects symlinks, and cannot overwrite originals/Git metadata or the authoritative input. No new package dependency, service, runtime endpoint or original-binary investigation was introduced.
## Evidence and Acceptance Limits
The expansion's current evidence records are explicitly **static documentary coverage**, bound to retained report content and named documentary scopes. They do not manufacture fresh component or native receipts. Implementation revisions identify recorded code changes separately from runtime/package identity. Existing copied-original/managed/Linux scene results are described with their narrower scope. Historical package revisions remain exact: current packaged924ad2f versus earlier ea04210 Wine64 and later integrated bf876e9 source checks are not conflated. Scooter/Rocketship milestones and current bounded scene limitations remain visible.
No new game, GPU, DxWnd, Wine or Windows execution, build or package was performed. Native Linux/Windows/original reference captures and human audiovisual review remain open at **0/120 actual obligations**. Shared EVID-03 is not checked complete in REQUIREMENTS.md. The preserved TSK correction is implemented, not an untouched defect; no leveling reset, movement replacement, new gadget, actor admission or lab/outside solver replacement was made. Missing generated original/native recordings retain explicit reasons in the startup evidence rather than being dropped.
## TDD Gate Compliance
- Task 1 RED evidence: `artifacts/fidelity/tdd/01-03-01-red.json`, recorded before implementation; the real CLI-presence/round-trip target failed its intended planned behavior assertion. Existing RED/GREEN commits and the previously verified 18-test tracer were reconciled rather than repeated.
- Task 2 RED evidence: `artifacts/fidelity/tdd/01-03-02-red.json`; the named full-game set-equality target ran and failed because only two movement requirements were mapped. The actual 26-test report retains the three expected missing coverage/reconciliation/unimplemented assertions. The classifier was re-run on resume and returned `RED_EVIDENCE_OK`; semantic inspection confirms intended assertions, not setup/import failures. Final suite passes all 31 tests.
- Each RED commit precedes its GREEN by ancestry. No separate refactor was necessary. Both exact counted plan commands and full 33-ID validation pass; singleton/negative cases remain covered. No skipped tests or unrun planned automated checks remain.
## Decisions Made
One JSON source owns all navigation. Current evidence selects exact content/platform/scope, including explicitly named historical bytes; latest documentation dates do not imply newer execution. Full-game rows and source-row reconciliation expose unfinished work without expanding gameplay. Future imported receipt references require exact receipt SHA-256 plus matching platform/scope/category/history.
## Deviations from Plan
No architecture or scope change. During planned validation, report-content hash binding, ledger-wide receipt duplicate checks, complete category validation and actual imported-receipt identity matching were completed as correctness controls for T-01-07/08. These are within the planned evidence-validation boundary and commit `4d07d60`.
## Threat/Test Coverage
| Threat | Implemented controls and verification |
|---|---|
| T-01-07 | Exact named content/platform/scope targets, explicit supersession/cycles and contradictory-current rejection; changed runtime/resource/package, docs-only and imported receipt tests |
| T-01-08 | Byte-identical duplicate merging, global receipt conflicts, stable ordering and 33 hashed source-row reconciliation entries; retained linked source required |
| T-01-09 | Escaped Markdown, bounded contained tracked UTF-8 source references, actual hashes, no imported command execution; hostile source and real viewer-copy tests |
| T-01-SC | Python standard library only; no package installation |
No additional threat surface beyond the plan's existing local file/navigation boundary was introduced. Cooperative local filesystem assumptions remain; revalidate/re-export after evidence changes.
## Issues Encountered
The user-requested pause interrupted task 2 after its RED commit and 41-line patch. Resume preserved those changes, validated ancestry/evidence and completed GREEN. Primary-owned HANDOFF deletion/STATE/continuation edits and untracked `tools.yaml` were preserved. Socket/Node checks used authorized local-test escalation to avoid the known sandbox false failures/file-only results. All-fidelity log: ignored `artifacts/fidelity/verification/01-03-all-python.log`.
No implementation stubs remain. Missing real recordings and unimplemented full-game workflows are intentional transparent evidence/coverage states whose later owning plans/phases remain open.
## User Setup Required
None for these local tooling checks. The combined Windows/original/native capture and human audiovisual session belongs to later plans; no premature hands-on request was created.
## Next Phase Readiness
Plans 01-04 through 01-07 can consume the coordinated ledger and provide real observer/checkpoint/capture receipts. The primary owns root continuity documents, consumed handoff cleanup, wave regression checks and push. Full-game and phase acceptance remain separate from this completed ledger implementation.
## Self-Check: PASSED
All four created files exist; all four task commits are ancestors of HEAD and evaluation-scope resolves them on this branch. Both exact counted plan checks, full 33-requirement/six-group/33-row validation, real CLI/viewer round trip, 103 fidelity Python tests, 27 named Node tests, whitespace checks and 539 original hashes pass. No tracked production deletions, skipped tests, placeholder implementation or unexplained generated untracked output was introduced.
@@ -0,0 +1,108 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "04"
type: execute
wave: 2
depends_on: ["01-01"]
files_modified:
- src/GamePort/Application/FidelityObservation.cs
- src/GamePort/Program.cs
- tests/GamePort.FidelityObservationTests/GamePort.FidelityObservationTests.csproj
- tests/GamePort.FidelityObservationTests/Program.cs
- tests/test_fidelity_observation.py
autonomous: true
requirements: [EVID-02, EVID-04]
estimate:
tokens: 33000
raw_tokens: 33000
tasks: 2
confidence: low
must_haves:
truths:
- "An optional passive observer records actual native port input/control/scene events across the continuous route per D-01, without changing gameplay or scene lifetime."
- "Natural/skipped and fresh/retained runs have distinct case identities, with one monotonic session across actual retained continuations per D-02 and D-03."
- "Held/neutral input, banked jump, landing and idle observations retain their real owner/tick/time per D-04; injected smoke fixtures stay separately classified."
- "An output failure leaves the observation incomplete and visible rather than reporting acceptance or changing movement/state to finish the recording."
artifacts:
- path: src/GamePort/Application/FidelityObservation.cs
provides: "Optional passive bounded JSONL session observer"
- path: tests/GamePort.FidelityObservationTests/Program.cs
provides: "Managed clock/order/ownership and failure regressions"
- path: tests/test_fidelity_observation.py
provides: "Process-level observer output and receipt interoperability checks"
key_links:
- from: src/GamePort/Program.cs
to: src/GamePort/Application/FidelityObservation.cs
via: "Outer Run continuation lifetime and actual post-Step acceptsInput result"
- from: "Observed events.jsonl"
to: tools/recon/fidelity_receipts.py
via: "Case/session identity, monotonic elapsed and separately labeled simulation tick"
---
<objective>
Supply the native port input/event evidence that existing smoke screenshots/logs cannot provide: accepted input and control ownership, with one lifetime across normal scene continuations. Observe existing behavior; do not repair any movement, rotation, body, camera or gameplay contract.
Artifacts this phase produces in this plan: FidelityObservation with session-owned clock, RecordInput/RecordControl/RecordTransition/Complete/Dispose methods; --fidelity-output PATH, --fidelity-session ID and --fidelity-case ID options; events.jsonl and observation-summary.json under a new generated session directory; standalone net10.0 observation test project and Python interoperability tests. All symbols/options are new observer interfaces, not existing/recovered gameplay APIs.
</objective>
<execution_context>
@/home/cristian/.codex/gsd-core/workflows/execute-plan.md
@/home/cristian/.codex/gsd-core/templates/summary.md
</execution_context>
<context>
@AGENTS.md
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
@.planning/phases/01-reproducible-fidelity-baseline/01-PATTERNS.md
@.planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md
</context>
<tasks>
<task type="tracer" tdd="true" id="01-04-01">
<name>Observe one real port input-to-control step through a recorded session</name>
<files>src/GamePort/Application/FidelityObservation.cs, src/GamePort/Program.cs, tests/GamePort.FidelityObservationTests/GamePort.FidelityObservationTests.csproj, tests/GamePort.FidelityObservationTests/Program.cs, tests/test_fidelity_observation.py</files>
<read_first>src/GamePort/Program.cs outer presentation/Run loop, SDL polling, PlayerInput construction, playerBinding.Step return and continuation publication; src/GamePort/Application/CutsceneIdleSmoke.cs; tests/GamePort.BodyOwnershipTests/GamePort.BodyOwnershipTests.csproj; 01-PATTERNS.md Optional FidelityObservation; docs/gameplay/main-menu-player-lifetime.md; docs/checkpoint/README.md, coverage.md and implementation-plan.md.</read_first>
<behavior>Managed tests execute at least eight checks for disabled no-op behavior, session identity, monotonic clock, requested versus accepted input, control/tick distinction, bounded output, output exception and correct disposal. Python adds at least four subprocess/interoperability checks proving actual emitted records validate and missing/incomplete records cannot qualify as native gameplay.</behavior>
<action>Write tests first and link the focused observer source into a standalone net10.0 console test project, following existing test conventions. Existing Program logging lacks ordinary accepted-input/timestamp continuity, so add a separate passive observer only at the application boundary. Allocate it once beside the outer RenderSession/Run loop, with a single Stopwatch spanning continuations; inject its reference into Run without creating a second gameplay owner. New options explicitly enable output, carry stable session/case IDs and require a new contained output directory separate from originals. On one actual step record requested PlayerInput values, accepted-input result after playerBinding.Step (or existing direct simulation.Step path), current control ownership, scene, monotonic time and simulation tick separately. Raw polled events, if captured, are labeled raw and never passed off as accepted gameplay input. Emit immutable copied observations after existing owner calls without invoking extra getters/callbacks that mutate game state. Keep observer-off paths behavior-identical. Handle bounded buffering/disk errors visibly in an incomplete observation summary; recording failure must not trigger a simulation reset, extra stepping or modified input. Add a subprocess end-to-end test using a bounded existing smoke invocation with observer output, explicitly classified synthetic/fixture, then validate its output through the receipt contract. This proves observation wiring only; ordinary native play remains required.</action>
<acceptance_criteria>A real port process emits a case-bound observation from input through control decision and file output; counted managed/Python checks pass; disabled observation and write errors preserve game update/state semantics; all fixture results retain their narrow method.</acceptance_criteria>
<verify>
<automated>bash -lc 'source scripts/env.sh && dotnet run --project tests/GamePort.FidelityObservationTests'</automated>
<fails_when>Nonzero exit or missing summary Fidelity observation checks: N passed with N at least 8; any clock/input/ownership/error assertion fails.</fails_when>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_observation.py"); assert s.countTestCases() >= 4,"fewer than 4 observer integration tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than four tests, no actual process output, or incomplete/fixture records incorrectly qualify as native gameplay.</fails_when>
</verify>
<done>Optional passive input/control observation works through the real port process and remains outside gameplay behavior and acceptance classification.</done>
</task>
<task type="auto" tdd="true" id="01-04-02">
<name>Preserve observation identity across dialogue and retained scene lifetimes</name>
<files>src/GamePort/Application/FidelityObservation.cs, src/GamePort/Program.cs, tests/GamePort.FidelityObservationTests/Program.cs, tests/test_fidelity_observation.py</files>
<read_first>Task 01-04-01 observer interfaces; Program.cs actual dialogue skip/control changes and continuation publication; docs/evidence/scenarios.json; protected movement/startup reports.</read_first>
<behavior>Extend managed checks to at least 14, covering natural/skip event distinction, requested held input while input is rejected, first accepted neutral/held step, ordered transition/RETURN records, monotonic continuation time and independent fresh session time. Compare observed/off deterministic state through existing fixtures.</behavior>
<action>Add observation records at actual existing dialogue/control changes and continuation publication per D-01–D-04, preserving exact player/save/return payloads and call order. Give transitions ordered sequence IDs and pair departure/destination in one session without restarting the outer clock. Keep fresh launches independent. Mark natural versus skip from the actual action path, not guessed elapsed duration; publish neutral/held acceptance and landing/bank/idle only from existing owner state observations or external annotations with explicit method. No new physics contacts, setters, orientation resets, cached callback data or actor admission. Annotate observation overhead in provenance; clean external audiovisual recordings and diagnostic observer runs remain distinguishable. Extend process-level tests to confirm fixture on/off state/readback equivalence and shared-session continuity, without calling synthetic transitions ordinary-route evidence. Run existing protected regressions and build; capture a bounded native Linux smoke with observer on/off if display is available, retaining actual readbacks and limitation if unavailable. Native full-route capture is owned by plan 01-06.</action>
<acceptance_criteria>All 14 managed checks pass; real continuation records preserve identity/order/clocks; protected movement/Director/Checkpoint/BodyOwnership checks remain passing; runtime diff contains passive observer plumbing only.</acceptance_criteria>
<verify>
<automated>bash -lc 'source scripts/env.sh && dotnet run --project tests/GamePort.FidelityObservationTests && dotnet build GamePort.csproj --no-restore'</automated>
<fails_when>Nonzero exit, missing at-least-14 positive observer check summary, or any build error.</fails_when>
<automated>bash -lc 'source scripts/env.sh && dotnet run --project tests/GamePort.MovementTests -- ../Original && dotnet run --project tests/GamePort.DirectorTests -- ../Original && dotnet run --project tests/GamePort.CheckpointTests -- ../Original && dotnet run --project tests/GamePort.BodyOwnershipTests'</automated>
<fails_when>Nonzero exit or an absent/zero group-count summary from any protected regression; state/readback equivalence differs.</fails_when>
</verify>
<done>Continuous observations preserve real control and retained lifetimes while all protected gameplay contracts remain unchanged.</done>
</task>
</tasks>
<threat_model>
ASVS level 1; unresolved high/critical threats block acceptance.
| Boundary | Description |
|---|---|
| Runtime observation → local output | Optional diagnostic writes cannot own or modify gameplay state |
| CLI output path → filesystem | Caller-controlled paths must remain outside originals and existing sessions |
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|---|---|---|---|---|---|
| T-01-10 | Tampering | Observer output | high | mitigate | Exclusive contained output, no gameplay callbacks/setters/retries and observed/off equivalence checks |
| T-01-11 | Denial of service | Observation buffering | medium | mitigate | Bounded records/buffer, explicit incomplete summary on write failure, reliable disposal |
| T-01-12 | Spoofing | Input/control records | high | mitigate | Distinct raw/requested/accepted observations, one session clock and fixture/native classification |
| T-01-SC | Tampering | Package installation | high | mitigate | Existing .NET framework/runtime dependencies only; no new NuGet packages |
</threat_model>
<verification>Run counted observation tests and protected managed regressions; inspect passive application-only diff. Full local suite runs during checkpoint integration. No body/movement/source algorithm edits are authorized.</verification>
<success_criteria>Native port recording can include truthful input/control/scene traces with preserved lifetime and source behavior.</success_criteria>
<output>Create .planning/phases/01-reproducible-fidelity-baseline/01-04-SUMMARY.md with observation semantics, overhead and actual protected checks.</output>
@@ -0,0 +1,197 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "04"
subsystem: testing
tags: [dotnet, passive-observation, jsonl, sdl, vulkan, provenance]
requires:
- phase: 01-01
provides: Version 1 receipts and separately classified scenario observations
provides:
- Optional bounded application observer with requested/accepted input and immutable state snapshots
- One launch clock and ordered departure/arrival records across retained scene composition
- Explicit script/skip/control methods, incomplete failure summaries and observer-on/off regressions
affects: [01-05, 01-06, 01-07, native-capture]
tech-stack:
added: []
patterns: [standalone net10 console tests, streamed bounded UTF-8 JSONL, snapshot-only application diagnostics]
key-files:
created:
- src/GamePort/Application/FidelityObservation.cs
- tests/GamePort.FidelityObservationTests/GamePort.FidelityObservationTests.csproj
- tests/GamePort.FidelityObservationTests/Program.cs
- tests/test_fidelity_observation.py
modified:
- src/GamePort/Program.cs
key-decisions:
- "One outer observer owns a unique launch/clock identity through Run continuations; simulation ticks remain scene-local and case/session IDs remain declared provenance."
- "Accepted input means the existing binding's returned gate result, with separately identified post-step ownership; individual command dispatch and independent body/fire work are not inferred."
- "Observer records are diagnostic source material for later collectors, not receipts or automatic original/native acceptance; fixture classification survives continuations."
patterns-established:
- "Copied values only: no simulation references, gameplay callbacks, setters, extra steps or recovery resets enter the observer."
- "Caller-selected new local output supports standalone checkpoint/transfer folders while rejecting protected asset/Git overlap, aliases, symlink ancestry and reused sessions."
requirements-completed: [EVID-02, EVID-04]
requirements-acceptance: "OPEN: assigned observation contribution only. Shared requirements remain Pending; actual original-DxWnd/native Linux/native Windows comparison acceptance remains 0/120."
coverage:
- id: observer-semantics
description: Bounded requested/accepted input, identity, clocks, disposal and output failure preserve simulation behavior
requirement: EVID-02
verification:
- kind: unit
ref: tests/GamePort.FidelityObservationTests/Program.cs
status: pass
- kind: integration
ref: tests/test_fidelity_observation.py
status: pass
human_judgment: false
- id: retained-observation
description: Real port fixture publishes LV1B to VR04 to LV1B with one ordered launch clock and paired departure sequences
requirement: EVID-04
verification:
- kind: integration
ref: tests/test_fidelity_observation.py#test_retained_continuation_keeps_one_ordered_session_clock
status: pass
human_judgment: false
- id: passive-runtime-comparison
description: Existing bounded headless and native SDL Carl fixtures preserve exact state and four GPU readbacks with observation on/off
verification:
- kind: integration
ref: tests/test_fidelity_observation.py#test_observed_off_fixture_state_and_readbacks_match
status: pass
- kind: other
ref: artifacts/fidelity/verification/01-04-native-1794543576213164551/comparison.json
status: pass
human_judgment: false
- id: actual-scenario-acceptance
description: Identified ordinary full-route original/native audiovisual comparison
verification: []
human_judgment: true
rationale: "Injected fixtures, observer traces and compilation do not supply ordinary play, physical audio/input or native Windows/original-DxWnd review; later capture plans retain these obligations."
actuals:
tokens: 13375
tasks: 2
commits: 4
basis: "ceil(chars/4) over the realized five-file production/test diff (53497 characters), excluding planning metadata; commits measured from the persisted ledger."
plan_head_before: e8155348950e997462f4d097a0e323c7f17b75fb
plan_head_after: ea4dc9b5dfb84b1d590dae049cabb4a262a5138c
duration: 16 min
started: 2026-11-13T04:04:37Z
completed: 2026-11-13
status: complete
---
# Phase 01 Plan 04: Passive Port Observation Summary
**Bounded JSONL observations preserve requested input, the real accepted-input gate, control changes and retained scene identity without changing player ownership or movement.**
## Performance
- Two tasks, five production/test files, four measured task commits. Started 04:04:37 UTC; final production verification/commit completed about 04:20 UTC, 2026-11-13.
- Final focused verification: **23 managed checks**, **7 Python process/interoperability tests in 19.126 seconds**. The tracer passed 10 managed/four process checks and repeated its automated gate before expansion.
- Protected projects: **Movement 28**, **Director 23**, **Checkpoint 4**, **BodyOwnership 3** actual passing groups. Existing projects without aggregate totals were additionally captured and counted from their executed PASS lines in `artifacts/fidelity/verification/01-04-protected.json` and per-project logs.
- Debug build and isolated self-contained Linux x64 Release publish succeed. The existing NU1900 warning concerns unavailable NuGet vulnerability metadata; no package was added or installed. All **539 original hashes** match.
## Accomplishments
- `FidelityObservation` is allocated once beside the outer presentation lifetime and passed through `Run`. A unique `launch_id`/`clock_id`, one Stopwatch and increasing sequence survive actual continuations. Simulation ticks remain explicitly separate and can reset at scene entry. Fresh observer instances get independent launch clocks even if a caller mistakenly repeats its declared session ID.
- The ordinary application input seam records the constructed `PlayerInput` and the actual `playerBinding.Step` return, or the existing direct simulation path. It copies post-step root, Euler, velocity, grounded/mode, retained-order flag and controller/body/effect counters. No recovered gameplay algorithm, orientation/reset policy, callback getter, actor admission or solver changed. Disabled observation allocates no observer or additional asset lookup; snapshots execute only through the optional observer path.
- SDL events are labeled raw before routing; only applicable keyboard/mouse union fields are copied. Requested input, returned gate and post-step control owner remain distinct. Script activity/control snapshots surround existing director calls. Explicit skip methods include startup/fixture, debug menu and actual SDL key paths; a playing-to-stopped boundary during the normal director step is identified as `natural_director_step`, without elapsed-time guesses.
- Scene composition records its actual entry path and retained-player/RETURN facts. Published continuations record departure source/destination and RETURN status; each following entry links the actual `departure_sequence`. The real existing fixture emits **LV1B → VR04 → LV1B**, retains one session/category/clock, and records two paired departures. This proves observer wiring through ordinary composition using fixture-owned setup; it is not ordinary-route acceptance.
- Output failure disables recording, retains an incomplete summary/stderr diagnostic and permits the existing game calls to continue. The managed failure regression compares 120 actual `LabSimulation` steps with failed observation versus off, including exact root/Euler/velocity and controller/body/effect counts. On/off headless and native SDL fixtures additionally preserve the existing locked body/fire/energy, first-neutral/300-idle assertions and held-input restoration.
## Task Commits
1. Task 01-04-01 RED: `773c228` — specify passive port input observation.
2. Task 01-04-01 GREEN: `72523ee` — observe accepted input with bounded passive output.
3. Task 01-04-02 RED: `6bccd47` — require retained session and dialogue observation.
4. Task 01-04-02 GREEN: `ea4dc9b` — preserve observer identity through control and scene changes.
Normal hooks ran, scoped staging preserved `tools.yaml`, and no tracked files were deleted. Main commits use the authorized configuration; the integrating primary owns push and root continuity reports.
## Files and Interfaces
- `src/GamePort/Application/FidelityObservation.cs`: optional `FromArguments`/`Create`, `RecordInput`, `RecordControl`, `RecordTransition`, `RecordSceneEntry`, `RecordRawEvent`, `RecordState`, `Complete` and `Dispose`. It holds copied diagnostic values and output ownership only.
- `src/GamePort/Program.cs`: optional CLI flags, one outer observer and post-owner/input/control/continuation seams. Skip and director-step wrappers preserve the original call and surrounding order. Existing helper-internal fixture steps remain outside this trace.
- Standalone `tests/GamePort.FidelityObservationTests` links focused observer plus existing assets/game sources, uses net10.0 and adds no packages. Its 23 Linux checks cover disabled operation, IDs/clocks, requested/rejected/accepted neutral input, ownership/ticks, bounds, write/flush/disposal failure, duplicate/unsafe output, real simulation parity and retained/fresh sequencing. Two symlink checks are Linux-specific; this run is not native Windows validation.
- `tests/test_fidelity_observation.py`: seven actual-port subprocess checks, hashed receipt interoperability, rejected fixture promotion/missing output, retained composition, explicit skip semantics and exact four-image/state equivalence. It builds current source before launching the actual DLL; if generated fixture resources are absent, it uses the existing local preparation command because the consolidated script runs Python before its own extraction step.
Example diagnostic invocation, with a **new** output directory:
```sh
source scripts/env.sh
dotnet run -- --fidelity-output artifacts/fidelity/new-session \
--fidelity-session unique-launch-session --fidelity-case fresh-natural-ordinary
```
IDs accept 1–128 safe alphanumeric/dot/underscore/hyphen characters. The output directory is caller-selected and need not live in a checkout: standalone package checkpoint results and local transfer folders work. Known original/source asset roots and Git metadata cannot overlap output in either direction. Protected asset aliases are resolved; output symlink ancestry and existing directories/files are rejected. A cooperative exclusive sibling reservation and `CreateNew` owned files prevent session reuse. Hostile concurrent filesystem replacement is outside this cooperative local model.
`events.jsonl` schema 1 fields are `session_id`, `case_id`, `evidence_kind`, unique `launch_id`, `clock_id`, increasing `sequence`, `elapsed_seconds`, separate `simulation_tick`, `name`, `scene`, `method` and immutable `data`. Names include `input_step`, `player_state`, `raw_sdl_event`, `control_observation`, `dialogue_start`, `dialogue_end`, `dialogue_skip`, `scene_departure` and `scene_entry`. Dialogue markers describe observed director script activity and explicit action paths, not inferred per-utterance audio timing. `accepted_input` copies the request only when the existing gate returned true; it does not assert that each input field dispatched an action. Independent body/fire work can continue when that gate is false.
`observation-summary.json` records UTC start/end, elapsed/clock identities, count/bytes, limits, completion/failure and overhead scope. It begins incomplete, remains incomplete after abort/error/bounds/disposal without completion, and is atomically updated after successful flush. A write failure never asks gameplay to retry, reset or step. If even the summary cannot be written, stderr explicitly reports that failure; a reserved prior incomplete summary is never promoted.
The writer uses a 64 Ki-character StreamWriter buffer, no growing record queue, at most **250000 records / 512 MiB**, and normalized UTF-8 LF output. These bounds can truncate long diagnostic sessions explicitly. `observer_seconds` measures serialization/write attempts only; caller snapshots, control comparisons, final flush and summary work are excluded, and this limitation is in provenance. No trace is represented as a clean, zero-overhead audiovisual run.
These are observer records, not shared receipt objects. The later collector must identify actual artifacts and map actual media clocks with uncertainty. Tests build an explicitly bounded `port_fixture` receipt from the trace interval, hash the actual trace, and validate it through the existing schema-1 receipt contract without changing that shared module. They do not invent a video/audio clock or promote native acceptance.
## Native Linux Evidence and Limits
Final evidence: `artifacts/fidelity/verification/01-04-native-1794543576213164551/comparison.json`, on/off `port.log`, eight retained PPM files and the actual observation directory. Both native SDL/Vulkan runs use a private Xvfb X11 display on **NVIDIA GeForce GTX 1070**, enabled validation, 32 frames and **zero Vulkan validation errors**. The existing injected Carl control fixture is muted; both runs exit 0. All four corresponding readbacks are byte-identical:
| Readback | SHA-256 |
|---|---|
| locked-start | f0d76654f1196534da20b7cf9a39c5e58931acb7f0aa22d349e87dad6ce176a2 |
| locked-fall | f0819d2dd9a43ff17b339be2bb3b487c3a94c4683e951015f38cd9b4f7c12e38 |
| returned | 642e15ad552c1c5819f41faf7b1bcbb9106462a26b6786753dd2f87f90cf4229 |
| final | e0e71f3c7f187149fc1b5b9d8c7fb7ff694f5ae3f27275a20948543a4f55fdfa |
The final observed run records **88 records / 65308 bytes**, 1.6721105 session seconds and 0.0365354 measured serialization/write seconds. Whole process durations are 1.5783 seconds off and 1.8555 seconds on; a single ordered pair is not an overhead benchmark. Actual Debug DLL SHA-256 is `778a1827d22c5359216c546b1841cea20fffca6a4bece2266a58057c8d24a348`, 776704 bytes. The report retains the actual pre-commit source identity: HEAD `6bccd47`, dirty true, diff SHA-256 `83eac9c22938f1f8d01200027e2fa3aefbe4ba123a9c58dc7bb6a7d9ce5ac33d`, plus unrelated preserved `tools.yaml` identity. Task GREEN commits that tested source; no clean-runtime claim is inferred from the later commit.
Exact state assertions and readbacks preserve the existing TSK first-story ordering correction, grounded neutral return, heading and legitimate source landing behavior. The fixture's deliberate preparatory calls remain fixture setup, not a newly invented reset. Full original playback, physical input/audio, ordinary full-route play, native Windows and broader platform compatibility remain unverified by this plan. **Actual matrix acceptance remains OPEN 0/120.** Plan 01-06 owns native full-route capture; Windows/original collection and review remain later work.
## TDD Gate Compliance
- Task 1: `artifacts/fidelity/tdd/01-04-01-red.json` contains the actual complete unittest report. The real port help succeeded but the named target failed its intended missing `--fidelity-output` assertion. Classifier result: `RED_EVIDENCE_OK`; semantic inspection confirms a planned behavior assertion rather than build/import/setup failure. The tracer's exact focused checks were repeated before expansion.
- Task 2: `artifacts/fidelity/tdd/01-04-02-red.json` contains the actual complete report. The existing real RETURN fixture succeeded, then the named target failed `[] != ['LV1B', 'VR04', 'LV1B']` because scene-entry observations were absent. Classifier result: `RED_EVIDENCE_OK`; semantic inspection confirms the intended sequencing assertion executed. Final 23 managed/seven process checks pass.
- Both RED commits precede their GREEN by ancestry. No separate refactor was required. No skipped/todo tests or unrun planned automated checks remain.
## Deviations from Plan
No architectural or gameplay scope change. Two bounded correctness adjustments remain within the planned application/test boundary:
1. **[Rule 2 — protected output]** Resolve source asset aliases and protect the checkout's known authoritative sibling even when `--assets` points to a generated copy. Otherwise lexical overlap alone could miss the original boundary. Managed source/output alias negatives pass; `ea4dc9b`.
2. **[Rule 3 — fixture preconditions]** Process tests build the current actual port and prepare missing generated resources through the existing extractor. The consolidated script schedules Python before its normal preparation/build steps; assuming prior generated files would make a clean test environment fail. No shared script or extractor was modified; `ea4dc9b`.
## Threat/Test Coverage
| Threat | Controls and actual verification |
|---|---|
| T-01-10 | New exclusive contained output, protected resolved asset/Git boundaries, symlink/reuse negatives, immutable values only; exact 120-step failed-writer parity and headless/native four-readback equivalence |
| T-01-11 | Fixed buffering, record/byte caps, incomplete initial/failure summaries, flush/disposal failure handling; managed bounds and exception regressions |
| T-01-12 | Distinct raw/requested/gate/post-step owner fields, actual director action methods, unique launch clock, ordered retained entries/departures, persistent fixture classification; process and shared-validator negatives |
| T-01-SC | Existing .NET framework/runtime, Python stdlib and already-installed native tools only; no added packages, services or downloads |
The new filesystem surface is exactly the plan's runtime-observation/local-output boundary; no additional network/auth/gameplay trust surface was introduced. Stub scan found only intentional optional/absent fields and test-only empty receipt identities, not unfinished implementation or UI mock data.
## Issues Encountered
The sandboxed first native-display attempt reported no video device. Authorized local-test escalation with explicit X11 on private Xvfb succeeded; both attempts remain in ignored diagnostics. A second `-o` passed to `scripts/build-linux.sh` was rejected by the .NET CLI, so the equivalent publish invocation used an isolated output to preserve existing `dist/` packages:
```sh
source scripts/env.sh
dotnet publish GamePort.csproj -c Release -r linux-x64 --self-contained true \
--no-restore -o artifacts/fidelity/verification/01-04-linux-publish
python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json
```
Both commands pass on final code. Existing packaged runtime outputs were not replaced. NU1900 remains a pre-existing offline audit warning, not an observer failure. No new original-binary investigation, REA claim, Wine result or native Windows execution occurred.
## User Setup Required
None for these local checks. The later combined original/native recording and human audiovisual review session remains open; this plan creates no premature hands-on request.
## Next Phase Readiness
Plans 01-05/01-06 can launch the optional observer into a new checkpoint result directory and consume its honest trace/summary while binding actual package/artifact/media provenance separately. The primary owns root progress/tasks/decisions/compatibility integration, broader wave checks and push. Shared EVID-02/EVID-04 remain Pending until all owning plans and actual acceptance conditions close.
## Self-Check: PASSED
All created files exist; all four task commits are ancestors of HEAD and evaluation-scope resolves them on this branch. Exact counted observer commands, positive protected groups, Debug/isolated Linux publish, final native state/four-readback equality and 539 original hashes pass. Native JSONL byte count matches the summary's actual file size. No tracked deletions, skipped tests, implementation stubs or unexplained generated untracked files were introduced; unrelated `tools.yaml` is preserved.
@@ -0,0 +1,113 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "05"
type: execute
wave: 3
depends_on: ["01-02", "01-03", "01-04"]
files_modified:
- tools/recon/fidelity_checkpoint.py
- scripts/prepare-fidelity-checkpoint.sh
- scripts/collect-fidelity-windows.ps1
- scripts/collect-fidelity-windows.cmd
- tests/test_fidelity_checkpoint.py
- tests/fidelity-windows.Tests.ps1
- docs/evidence/windows-session.md
autonomous: true
requirements: [EVID-01, EVID-02, EVID-04]
estimate:
tokens: 34000
raw_tokens: 34000
tasks: 2
confidence: low
must_haves:
truths:
- "One complete local checkpoint bundle contains identified port packages, a verified generated original copy, scenarios, viewer and result collection per D-14."
- "The available Windows PC is treated as a pending execution environment per D-13; actual OS/GPU/driver/tool identities are collected during the session."
- "The original launches only from a generated copy through the user's identified DxWnd binary/exported profile, separately from native port receipts, per D-15."
- "All original-reference and port materials are prepared before one combined session per D-16; preparation does not close EVID-02 or EVID-04."
- "Launcher preflight or recording failure produces an actionable local failure receipt without inventing successful capture or downloading dependencies."
artifacts:
- path: tools/recon/fidelity_checkpoint.py
provides: "Offline checkpoint manifest/preflight and bundle assembly"
- path: scripts/collect-fidelity-windows.ps1
provides: "Native Windows local preflight/launch/collection"
- path: docs/evidence/windows-session.md
provides: "Single combined-session instructions and local result transfer"
key_links:
- from: scripts/prepare-fidelity-checkpoint.sh
to: tools/recon/fidelity_checkpoint.py
via: "Consumes completed package bytes and validated scenario/ledger/viewer artifacts"
- from: scripts/collect-fidelity-windows.ps1
to: tools/recon/fidelity_receipts.py
via: "Same schema-versioned per-run receipt contract and byte identities"
---
<objective>
Prepare the complete local Windows original-DxWnd/native-port checkpoint per D-13–D-16, without asking the user to execute partial materials.
Artifacts this phase produces: fidelity_checkpoint.py prepare/preflight CLI; scripts/prepare-fidelity-checkpoint.sh; scripts/collect-fidelity-windows.ps1 and .cmd; tests/test_fidelity_checkpoint.py; tests/fidelity-windows.Tests.ps1; windows-session.md. The generated dist/fidelity/phase01 checkpoint contains manifest.json, READY.json, original-pristine/, original-runs/, port/win-x64/, port/linux-x64/, review/, protocol/, results/ and local launchers. READY means materials prepared, never acceptance passed. No media/packages are committed or uploaded.
</objective>
<execution_context>
@/home/cristian/.codex/gsd-core/workflows/execute-plan.md
@/home/cristian/.codex/gsd-core/templates/summary.md
</execution_context>
<context>
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
@.planning/phases/01-reproducible-fidelity-baseline/01-RESEARCH.md
@.planning/phases/01-reproducible-fidelity-baseline/SKELETON.md
@.planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md
@.planning/phases/01-reproducible-fidelity-baseline/01-02-SUMMARY.md
@.planning/phases/01-reproducible-fidelity-baseline/01-03-SUMMARY.md
@.planning/phases/01-reproducible-fidelity-baseline/01-04-SUMMARY.md
</context>
<tasks>
<task type="tracer" tdd="true" id="01-05-01">
<name>Prepare one runnable checkpoint case through package identity, launch plan and collected result</name>
<files>tools/recon/fidelity_checkpoint.py, scripts/prepare-fidelity-checkpoint.sh, scripts/collect-fidelity-windows.ps1, scripts/collect-fidelity-windows.cmd, tests/test_fidelity_checkpoint.py</files>
<read_first>scripts/package.sh; scripts/build-linux.sh; scripts/build-windows.sh; tools/recon/fidelity_receipts.py; tools/recon/fidelity_review.py; docs/evidence/scenarios.json; 01-RESEARCH.md Minimum Viable Windows Recording and Bundle.</read_first>
<behavior>At least 12 Python tests prepare→preflight→fixture-result-import one checkpoint case, compare actual package/resource and original hashes, reject output overlap/reuse, stale/missing binary/resources, tampered launcher/media, interrupted/concurrent assembly and missing dependencies. Fixture collection cannot qualify as native Windows.</behavior>
<action>Create failing tests first. Assemble a complete offline tree consuming actual finished package bytes and their BUILD-INFO rather than stamping the current docs revision onto old DLLs. Use scripts/package.sh locally if new observer packages are needed; retain its original identity fields and add a separate canonical manifest excluding its own output to avoid self-hashing. Record actual runtime source/dirty/diff identity, executable/resource/package tree hashes, original manifest hash and launcher/viewer hashes. Verify originals before copying; retain a pristine generated original seed and make a fresh writable original-runs copy per fresh case, preserving retained case state explicitly. Launchers are script-relative and quoted; no shell/eval or commands supplied by receipts. Implement one complete case path: preflight byte identities and dependencies, select actual tool/profile, start original-DxWnd or native port as separate explicit modes, collect invocation/exit/log/artifact metadata and publish a truthful receipt/failure. Do not assume DxWnd command switches/profile correctness: inspect the selected local distribution's help/config inside the final session, retain original exported profile plus any relocation-only edits, and provide transparent manual launch if automation is unsupported. Windows requires neither Python nor SDK for the self-contained port/PowerShell collector. Retain launcher/profile hashes, Windows/GPU/driver/SDL/Vulkan evidence as actually available. Hash incrementally and bound file counts, sizes and process waits. Bundle test round trips use deliberately synthetic executables/media and are labeled tooling-only. Original/native launch remains an actual final-session check.</action>
<acceptance_criteria>One checkpoint fixture travels through preparation, preflight and schema-valid import; an actual offline package tree can be assembled without original writes or external services; failures identify exact missing/tampered dependencies; Windows runtime remains pending.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_checkpoint.py"); assert s.countTestCases() >= 12,"fewer than 12 checkpoint tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 12 tests, missing end-to-end bundle import, or tampered/partial/tooling-only evidence incorrectly passes.</fails_when>
<automated>bash -n scripts/prepare-fidelity-checkpoint.sh</automated>
<fails_when>Nonzero exit or shell syntax diagnostic.</fails_when>
</verify>
<done>One production checkpoint path exists from completed local package to identity-bound result, with Windows execution explicitly pending.</done>
</task>
<task type="auto" tdd="true" id="01-05-02">
<name>Complete all session materials and collect audiovisual results without fragmented requests</name>
<files>scripts/collect-fidelity-windows.ps1, scripts/collect-fidelity-windows.cmd, tests/fidelity-windows.Tests.ps1, docs/evidence/windows-session.md, tests/test_fidelity_checkpoint.py</files>
<read_first>01-CONTEXT.md D-01–D-04 and D-13–D-16; docs/evidence/scenarios.json; receipt schema; 01-RESEARCH.md assumptions A1/A2 and Windows sequence.</read_first>
<behavior>Extend checkpoint tests to at least 16 checks for all matrix/materials, explicit original/native categories, abort/skip receipts and bundle readiness distinct from acceptance. Create package-free PowerShell tests with at least eight checks for identity/path/argument/exit/result functions; Windows execution is deferred to the same final session.</behavior>
<action>Finish launcher/checklist for all eight matrix cells, continuous/focused obligations, native port and original-DxWnd modes. Put one ordered combined agenda in windows-session.md: local dependency selection; versions/hashes/config capture; short original and port visual/audio preflights; all required runs; paired browser/audio review; result collection/postflight; one local return transfer. Initial OBS recommendation is offline Display Capture, with actual selected tool/version/source/settings recorded. Retain raw MKV plus any verified browser preview, exact derivation command/tool/version/timestamp/crop/aspect metadata; never discard the raw recording. A preview codec is accepted only after real browser playback. Require visible moving game content, intelligible game audio and correct crop in human preflight, not merely ffprobe streams. Original markers describe actual visible input/event intervals and uncertainty; port traces use observer data. Collect missed/skipped/aborted cases and wrapper rendering/timing limitations, distinguish diagnostic runs, and preserve generated original post-run changes. Keep DxWnd provenance distinct from native Windows port receipts per D-15. No guessed profile, forced timer/render setting, tool download or redistributed third-party installer. PowerShell tests run without Pester/package installs using temporary fixtures and explicit positive check count. Include their exact command in the session agenda; absence of pwsh here remains pending rather than pretending syntax tests ran. Local transfer instructions use USB/local filesystem or existing local shares, with hashes rechecked on return. Do not request capture yet.</action>
<acceptance_criteria>Every required case/tool/material appears in the one agenda; synthetic tests prove completeness/classification; package-free Windows selftests are ready; no capture request occurs before final readiness.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_checkpoint.py"); assert s.countTestCases() >= 16,"fewer than 16 checkpoint tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 16 tests, or missing agenda/required-cell/abort/classification checks.</fails_when>
<human-check>At the final combined session run powershell.exe -NoProfile -File .\tests\fidelity-windows.Tests.ps1 from the prepared checkpoint, requiring eight or more passing checks and zero failures; then perform the actual original/native recording agenda. Missing tools/settings remain explicit failure receipts.</human-check>
</verify>
<done>A complete local checkpoint and one combined session agenda cover original-reference and native Windows capture, including honest failure/abort results.</done>
</task>
</tasks>
<threat_model>
ASVS level 1; unresolved high/critical threats block acceptance. No new package installs.
| Boundary | Description |
|---|---|
| Selected tools/profile → process launch | Only explicitly selected local executables run with transparent arguments |
| Checkpoint package → user results | Byte identity and classification must survive local transfer |
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|---|---|---|---|---|---|
| T-01-13 | Elevation of privilege | PowerShell launcher | high | mitigate | No elevation/download/eval; allow explicit local selection, argument-safe invocation and no receipt-supplied commands |
| T-01-14 | Tampering | Bundle/transfer | high | mitigate | Canonical hashes, preflight/postflight, atomic fresh assembly and tampered artifact rejection |
| T-01-15 | Spoofing | Original/native receipts | high | mitigate | Separate methods/profile provenance, explicit abort/limitations and no acceptance from launch or metadata alone |
| T-01-SC | Tampering | Package installation | high | mitigate | No ecosystem additions or third-party redistribution; actual external executable provenance recorded locally |
</threat_model>
<verification>Run counted bundle tests and shell syntax check. Checkpoint READY describes materials only. Actual Windows PowerShell/original/DxWnd/native port and browser checks occur once in plan 01-07.</verification>
<success_criteria>Everything needed for the single Windows hands-on session is complete and locally transferable before the user is asked to run it.</success_criteria>
<output>Create .planning/phases/01-reproducible-fidelity-baseline/01-05-SUMMARY.md with checkpoint membership, actual package identities and pending Windows checks.</output>
@@ -0,0 +1,166 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "05"
subsystem: testing
tags: [offline, powershell, windows, fidelity, sha256]
requires:
- phase: 01-02
provides: Offline paired review viewer
- phase: 01-03
provides: Capability ledger and identified source links
- phase: 01-04
provides: Passive port observation and package flags
provides:
- Immutable offline checkpoint with identified original and Linux/Windows packages
- Complete eighty-obligation Windows agenda with separate original-DxWnd and native-port collection
- Package-free PowerShell selftests and truthful terminal/media results
affects: [01-06, 01-07]
tech-stack:
added: []
patterns: [exclusive allocation, bounded hashing, atomic publication, explicit open acceptance, inert argument provenance]
key-files:
created:
- tools/recon/fidelity_checkpoint.py
- scripts/prepare-fidelity-checkpoint.sh
- scripts/collect-fidelity-windows.ps1
- scripts/collect-fidelity-windows.cmd
- tests/test_fidelity_checkpoint.py
- tests/fidelity-windows.Tests.ps1
- docs/evidence/windows-session.md
modified: []
key-decisions:
- "READY validates immutable prepared materials only; actual original-DxWnd/native Linux/native Windows acceptance remains open 0/120."
- "Runtime package source/dirty/diff identity stays bound to its actual completed publish, separately from later collector and document commits."
- "Selected external tools are identified without redistributing executables; raw MKV, terminal failures and actual derivation provenance remain local."
requirements-completed: [EVID-01, EVID-02, EVID-04]
requirements-acceptance: "OPEN: assigned preparation contributions are complete; shared requirement IDs remain Pending until unfinished sibling capture/review plans and actual acceptance gates close."
coverage:
- id: offline-checkpoint
description: Identified complete offline bundle, preservation and tamper checks
requirement: EVID-01
verification:
- kind: integration
ref: tests/test_fidelity_checkpoint.py
status: pass
- kind: other
ref: artifacts/fidelity/verification/01-05-complete-bundle.json
status: pass
human_judgment: false
- id: collection-tooling
description: Package-free collector identity/path/argument/process/result functions on synthetic fixtures
requirement: EVID-02
verification:
- kind: integration
ref: tests/fidelity-windows.Tests.ps1
status: pass
human_judgment: false
- id: combined-session-materials
description: Eighty Windows obligations, session instructions and settings/annotation templates are bundled
requirement: EVID-04
verification:
- kind: integration
ref: tests/test_fidelity_checkpoint.py#test_complete_session_materials_and_eighty_windows_obligations
status: pass
human_judgment: false
- id: actual-original-native-acceptance
description: Actual original-DxWnd/native Windows execution, audiovisual preflight and full scenario review
verification: []
human_judgment: true
rationale: "Linux-hosted synthetic PowerShell tests, prepared bytes and apphost help do not establish Windows gameplay, actual browser/audio playback or whole-original fidelity; plan 01-07 owns the combined session."
actuals:
tokens: 21862
tasks: 2
commits: 7
basis: "ceil(chars/4) over the realized seven-file production/test/document diff: 87448 characters. Measured ledger range includes five plan task commits plus the intervening primary handoff and quota-guard commits; no invented task-commit count."
plan_head_before: de68796df15acaacbc7df1ae5701acac770680ce
plan_head_after: aa4b862a123112085660ee14fc0e2bccb251ddfa
duration: 12h 4min
started: 2026-11-13T04:40:08Z
completed: 2026-11-13
status: complete
---
# Phase 01 Plan 05: Offline Windows Checkpoint Summary
**An identified 10,983-file offline checkpoint carries preserved originals, both actual port packages, review/protocol materials and a complete Windows original-DxWnd/native-port collection agenda with open acceptance.**
## Performance
- Two tasks, seven production/test/document files. The recorded wall interval starts at the earliest task RED commit, 04:40:08 UTC, and includes the long quota interruption before task 2 resumed. It is not twelve hours of active execution.
- Final targeted verification: **24 Python checkpoint tests**, **17 actual Linux-hosted PowerShell checks**, four PowerShell-produced synthetic receipts validated by the shared Python validator, shell syntax and **539 unchanged original files**.
- The broader fidelity regression passed **133 tests in 123.784 seconds** with authorized local loopback/process access before the final mode-only correction; the affected checkpoint suite then passed all 24 tests in 4.742 seconds. No skipped tests are represented as passes.
- Actual full-bundle Python and Linux-hosted PowerShell preflights both pass, checking 10,983 immutable entries. The PowerShell traversal took several CPU-active minutes and completed before its explicit 600-second supervisory bound. It did not wait for interactive input.
## Accomplishments and Interfaces
- `fidelity_checkpoint.py` seals actual completed publishes, prepares a fresh offline tree and preflights immutable file identities. Existing outputs, overlaps, aliases, tampering, stale DLLs, interrupted/concurrent assembly and missing dependencies are rejected with local diagnostics. The generated original seed is verified before copying and again against its authoritative inventory. Hashes stream; assembly uses an exclusive reservation and retains incomplete diagnostics on failure.
- The bundle contains `manifest.json`, `READY.json`, `original-pristine/`, `original-runs/`, `port/linux-x64/`, `port/win-x64/`, `review/`, `protocol/`, `results/`, both collector launchers, the session guide and standalone PowerShell selftests. Protocol materials include scenarios, capabilities, original inventory, an **80-obligation Windows agenda** and explicit pending settings/annotation templates. Empty/false fields require actual observations during the later session; they are not fabricated identities or implementation stubs.
- `collect-fidelity-windows.ps1` supports `Preflight`, `Run`, `Retained`, `Finish`, `Skip` and `Abort`. Native port and original-DxWnd receipts keep distinct categories. It identifies actual selected external tools without copying third-party executables/installers, preserves the user's profile plus generated original pre/post state, uses quoted direct process invocation and records honest exit/log information. No original is executed in place, no command from a receipt is evaluated, and no dependency is downloaded.
- Raw MKV and actual audio evidence are required to finalize captured results. Derived artifacts retain source/output references, actual tool/version/argv/time/crop metadata and explicit browser-playback declaration. Synthetic promotion, terminal-outcome promotion, reused results and invalid references are rejected. Failed/skipped/aborted results remain available for collection without inventing successful media. All collector outputs retain open acceptance and require the shared validator and later human review.
- `windows-session.md` gives one ordered agenda: local selections/provenance, package-free checks, separate original/port visual/audio preflights, all eight matrix cells and five obligations, paired browser/exclusive-audio review, collection/postflight, then one local return transfer with hash checks. It recommends offline OBS Display Capture initially while requiring actual selected settings. It does not request capture now.
## Task Commits
1. Task 1 RED: `446930d` — specify immutable offline checkpoint round trip.
2. Task 1 GREEN: `6112339` — assemble identified offline Windows checkpoint.
3. Task 2 RED: `818191c` — require complete Windows session materials and open results.
4. Task 2 GREEN: `8574665` — complete offline Windows collection agenda and selftests.
5. Task 2 correctness follow-up: `aa4b862` — retain executable permissions in offline copies.
Task 1 was already complete and was not repeated during recovery. The partially edited collector and checkpoint module were preserved and completed. Normal Git hooks ran with explicit scoped staging, protected-branch configuration and the supplied-root guard; no tracked files were deleted. Unrelated `tools.yaml`, the primary's quota tooling commit `c9b9f2e` and its ownership were preserved. The primary owns review, integration reports and push.
## Actual Offline Bundle and Package Identities
Fresh final bundle: `artifacts/fidelity/01-05-session-checkpoint`. Durable identity/audit evidence: `artifacts/fidelity/verification/01-05-complete-bundle.json`.
| Material | SHA-256 |
|---|---|
| manifest.json, 2,689,788 bytes | `1098cf07030d5acf71b37d2132ec8bf39360855e9f7b2203cd130c9a7ac011be` |
| READY.json, 358 bytes | `1bb81a44da9f5ce92d5549f1608fcc6f46a47e2010d5160b39dcb471d1e8cccd` |
| Original 539-file canonical tree | `419af98a75a9f1d4ae3eceb5c7807bc9634912c2c3918c308470ad798dcef181` |
| Linux sealed package file-list hash | `124cf271e4952f3822eec5c24358447fcffc9e9e1803aded8d96d4d4472dc5a3` |
| Windows sealed package file-list hash | `335e5b75ec15c0fa904113d8b69d4f50e2cfa403f1f2f225353bd9e586322ef4` |
| Linux GamePort.dll, 734208 bytes | `145de80f2628f836cd77f0e8f66cb1b9d5abb8445088ff8ba8eb82527b6cd150` |
| Windows GamePort.dll, 734208 bytes | `d21c917c1d260f3cd2c5b3d19397ab78ae23108c90b4f393eba4904d80e512a1` |
Both packages already existed under `artifacts/fidelity/01-05-packages`; recovery did not rebuild them. Their actual BUILD-INFO identifies source `446930d2a30d6d616c60ac5e59e4169a840bea09`, **dirty yes**, diff SHA-256 `90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d`. Publish timestamps are 2026-11-13T04:45:41.527524+00:00 and 04:47:05.457630+00:00 respectively. Neither the resumed collector revision nor the later clean task commit is stamped over that runtime provenance. Historical `dist/` packages remain unchanged.
The final copied Linux apphost was permission-repaired from its byte-identical package source to mode 0755, then actually ran `--help` successfully. The generator now preserves ordinary source permissions for future copies while dropping privileged mode bits. That permission-only repair changes no manifest/file byte identity. Apphost help establishes startup/CLI availability only, not gameplay, sound, GPU or platform acceptance.
## Verification Commands and Scope
```sh
python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_checkpoint.py"); assert s.countTestCases() >= 16; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'
bash -n scripts/prepare-fidelity-checkpoint.sh
python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json
python3 tools/recon/fidelity_checkpoint.py preflight --checkpoint artifacts/fidelity/01-05-session-checkpoint
```
The cached `.tools/powershell-check/root/opt/microsoft/powershell/7/pwsh` is usable with `XDG_CACHE_HOME`, `XDG_CONFIG_HOME` and `XDG_DATA_HOME` set to task-local `/tmp/gameport-pwsh-*` directories. Its default home cache is read-only in the sandbox. No install/download was performed. Actual commands used that executable with `-NoProfile -File tests/fidelity-windows.Tests.ps1 -FixtureOutput /tmp/gameport-01-05-ps-results` and separately `-NoProfile -File scripts/collect-fidelity-windows.ps1 -Action Preflight -Bundle artifacts/fidelity/01-05-session-checkpoint`.
The 17 selftests exercise IDs/paths, hashes/copy identity, arrays/write-once JSON, argument quoting, an actual child with spaced arguments and exit 7, stdout/stderr, timeout/start failure, categories/terminal outcomes, manifest tampering and finish links. Their four captured/failed/skipped/aborted receipts all validate structurally through `fidelity_receipts.validate_receipt`; **all four remain synthetic and unaccepted**. Linux PowerShell is not Windows PowerShell 5.1 execution evidence. The exact native Windows selftest command is included in the future combined agenda.
## TDD Gate Compliance
Both retained RED reports, `artifacts/fidelity/tdd/01-05-01-red.json` and `01-05-02-red.json`, return `RED_EVIDENCE_OK` through the current classifier. Task 1's named target executes its intended missing preparation-API assertion. Task 2's named target completes assembly then fails the planned missing-session-material assertion; its separate missing status-API error remains honestly recorded. Both RED commits precede their GREEN commits by ancestry. No separate refactor was needed. Final targeted tests pass.
## Deviations from Plan
1. **[Rule 1 — collector correctness]** Real PowerShell execution exposed top-level empty arrays serializing incorrectly and asynchronous .NET completion values leaking into the process-result pipeline. `Write-FidelityJson` now uses `ConvertTo-Json -InputObject`; asynchronous completions are suppressed, output closure is bounded and final log size is checked. Standalone serialization/process/terminal tests pass; `8574665`.
2. **[Rule 2 — runnable offline copy]** Final bundle inspection found that byte-only copying dropped Linux apphost execution permission. The generator now preserves ordinary source mode bits, and a regression checks both mode and bytes. The generated apphost was repaired from its verified source and ran help; `aa4b862`. No source/package bytes or gameplay algorithms changed.
No new trust surface beyond the plan's selected-process/local-filesystem boundaries was introduced. The supplied threat mitigations remain applicable: no eval/elevation/downloads, explicit local selections, contained paths, hashes, immutable result IDs and categories that cannot imply acceptance. No implementation stub or skipped mandatory automated verification remains; actual Windows/human checks are intentionally assigned to the later combined session.
## Issues Encountered
Quota interruption required a specific task-2 recovery from the existing RED commit and partial edits. An accidentally duplicated slow preparation was stopped; its incomplete directory and reservation remain under `.01-05-complete-checkpoint*` as diagnostics, and the final assembly uses a new root. No lock was stolen or failed partial tree promoted. The sandboxed broader regression denied loopback sockets and timed out .NET setup; its authorized local rerun passed all 133 tests. The optional full PowerShell preflight was CPU-active and bounded, then passed. No unresolved test failure is hidden by these environment adaptations.
## Next Phase Readiness
The full bundle and session tooling are prepared. Plan 01-06 still owns actual native Linux capture, and plan 01-07 owns the combined original-DxWnd/native Windows session and audiovisual review. The real scenario audit is structurally ready with **accepted 0 / required 120**, all eight cases missing and no invalid receipts. Original launch/profile validity, native Windows execution, real browser playback/audio/crop and full-route fidelity remain open. This plan makes no new original-binary, REA, Wine, native Windows gameplay or whole-original compatibility claim.
Shared EVID-01/EVID-02/EVID-04 IDs remain Pending because `requirements.ready-ids` returns no ready IDs while sibling plans are unfinished. Root progress/tasks/decisions/compatibility integration and consumed-handoff cleanup belong to the primary.
## Self-Check: PASSED
All seven created files exist. All five plan task commits are reachable on this branch, and evaluation-scope resolves the recorded plan commits. Final counted checkpoint/PowerShell checks, shared receipt validation, both full-bundle preflights, shell syntax, Linux apphost help and 539 original hashes pass. The persisted ledger measures seven commits before summary metadata, including the two intervening primary commits explained above. No generated package/media/original is staged, no tracked deletion occurred, and unrelated `tools.yaml` is preserved.
@@ -0,0 +1,105 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "06"
type: execute
wave: 4
depends_on: ["01-05"]
files_modified:
- tools/recon/fidelity_capture.py
- scripts/collect-fidelity-linux.sh
- tests/test_fidelity_capture.py
- docs/evidence/linux-session.md
autonomous: true
requirements: [EVID-01, EVID-04]
estimate:
tokens: 25000
raw_tokens: 25000
tasks: 2
confidence: low
must_haves:
truths:
- "An identified native Linux package yields actual input/event and audiovisual captures where execution is available; synthetic/headless replays remain distinct (EVID-04)."
- "Continuous route and focused captures cover all natural/skipped, fresh/retained and ordinary/edge cells per D-01–D-04, with missing executions explicitly open."
- "Physical input/audio and real visible gameplay require actual native receipts/human review; dummy audio and window-only fixtures cannot complete acceptance."
artifacts:
- path: tools/recon/fidelity_capture.py
provides: "Bounded native Linux capture orchestration and result collection"
- path: docs/evidence/linux-session.md
provides: "Native Linux route protocol, capture setup and physical review agenda"
- path: scripts/collect-fidelity-linux.sh
provides: "Local identified-package launch/collection entry point"
key_links:
- from: tools/recon/fidelity_capture.py
to: "Identified Linux checkpoint package and port observer"
via: "Actual process invocation, accepted input/events, raw media and receipt identity"
- from: "Native Linux receipts"
to: "Paired review and final acceptance audit"
via: "Validated case/session/package/media identity and explicit missing cells"
---
<objective>
Collect current native Linux baseline evidence using the completed checkpoint rather than substituting synthetic fixtures for ordinary gameplay. Prepare all physical/audible review items for the same final combined review.
Artifacts this phase produces: fidelity_capture.py preflight/run/collect CLI; collect-fidelity-linux.sh; tests/test_fidelity_capture.py; linux-session.md; ignored artifacts/fidelity/linux sessions containing receipts, logs, raw video/audio, observer events, annotations, media probes and images. Original-side capture remains on Windows through DxWnd.
</objective>
<execution_context>
@/home/cristian/.codex/gsd-core/workflows/execute-plan.md
@/home/cristian/.codex/gsd-core/templates/summary.md
</execution_context>
<context>
@AGENTS.md
@.planning/ROADMAP.md
@.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
@.planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md
@.planning/phases/01-reproducible-fidelity-baseline/01-04-SUMMARY.md
@.planning/phases/01-reproducible-fidelity-baseline/01-05-SUMMARY.md
</context>
<tasks>
<task type="tracer" tdd="true" id="01-06-01">
<name>Capture one actual Linux focused moment and import its observed evidence</name>
<files>tools/recon/fidelity_capture.py, scripts/collect-fidelity-linux.sh, tests/test_fidelity_capture.py, docs/evidence/linux-session.md</files>
<read_first>docs/evidence/scenarios.json; tools/recon/fidelity_receipts.py; scripts/test-window-transitions.sh; docs/evidence/windows-session.md; 01-RESEARCH.md capture/media guidance; actual completed Linux package BUILD-INFO and manifest.</read_first>
<behavior>At least 10 tests exercise capture launch→probe→hash→import with bounded process/media doubles, real receipt validation and explicit fixture category; missing display/audio, recorder exit, timeout/abort, stale package, empty/frozen media indicators and native-versus-headless classification remain incomplete.</behavior>
<action>Create tests first. Implement bounded orchestration that verifies completed package/resource identities, records OS/GPU/driver/Vulkan/SDL and capture-tool versions, launches the native Linux package using normal controls plus passive observer and collects external recording and actual logs. Use available local FFmpeg/OBS capabilities only after preflight; record the selected X11/Wayland/display/audio capture methods rather than assuming Pulse/PipeWire availability. Preserve raw video/audio and any timestamp-preserving remux preview; ffprobe validates actual streams/durations, while human visibility/audibility remains separate. Prove one focused normal-play dialogue-return/neutral-input moment end to end through launch, logs/events, media collection, import and viewer links. Existing SDL injection may support a clearly labeled automated native replay, but cannot be relabeled physical user input. A smoke or headless fallback stays fixture evidence. If this environment cannot run/capture native audio/video, publish its exact failed preflight/open receipt and finish the usable collector/procedure without blocking remaining bundle preparation. This conditional is an execution dependency, not a waiver of native acceptance. Do not ask the user for an early session.</action>
<acceptance_criteria>Counted capture round-trip tests pass; either an actual identified native focused receipt or a precise failed-preflight receipt exists; no synthetic/automated/dummy-device evidence claims physical/audible acceptance.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_capture.py"); assert s.countTestCases() >= 10,"fewer than 10 capture tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 10 tests, absent round-trip output or an unavailable/synthetic capture promoted to native acceptance.</fails_when>
<human-check>The final combined review checks actual Linux physical input, moving game content and audible output, including the observer's recorded scope and any capture overhead.</human-check>
</verify>
<done>One focused Linux capture path is usable, and its actual execution result or precise access limitation is represented honestly.</done>
</task>
<task type="auto" tdd="true" id="01-06-02">
<name>Collect the complete Linux journey matrix with preserved entry lifetimes</name>
<files>tools/recon/fidelity_capture.py, scripts/collect-fidelity-linux.sh, tests/test_fidelity_capture.py, docs/evidence/linux-session.md</files>
<read_first>Task 01-06-01 collector; docs/evidence/scenarios.json; docs/gameplay/main-menu-player-lifetime.md; docs/gameplay/jimmy-movement-stabilization.md; current checkpoint package identities.</read_first>
<behavior>Extend to at least 14 tests proving full case enumeration, route continuity, focused obligations, fresh/retained separation, natural/skip identification, interrupted matrix resume without reusing sessions and explicit unavailable cells.</behavior>
<action>Expand the real collector/procedure to all required continuous/focused matrix cases per D-01–D-04. Each continuous lab→VR04→lab→outside recording preserves actual scene/control/save/RETURN lifetimes; independent focused setups are labeled and cannot replace the continuous journey. Keep ordinary play separate from held-through-dialogue/return, banked jumping left/right, landing and idle edge runs. Capture raw elapsed/event deltas and annotation uncertainty without inventing tolerances or repairing bank/movement. Use normal gameplay; debug warps/grants and smoke route fixtures remain narrow supplementary evidence. Verify source originals before/after the capture checkpoint. Attempt all runnable native Linux cells, record actual failures and missing media/physical/audible checks, and append remaining local Linux review actions to the single final session agenda. Re-run only failed/incomplete cells under new session IDs with retained history. Export receipt/review data for the final acceptance audit; do not update capability/root status files owned by final integration.</action>
<acceptance_criteria>All eight cells and their continuous/focused obligations are represented by actual receipt IDs or precise open dependencies; no count-only completeness or disconnected scene substitution passes.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_capture.py"); assert s.countTestCases() >= 14,"fewer than 14 capture tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 14 tests, or a missing cell/lifetime/continuity assertion fails.</fails_when>
<automated>python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json</automated>
<fails_when>Nonzero exit or missing Verified 539 unchanged original files.</fails_when>
</verify>
<done>The Linux evidence matrix is collected as far as actual access permits, with all remaining acceptance explicitly retained for final review.</done>
</task>
</tasks>
<threat_model>
ASVS level 1; high/critical unresolved threats block acceptance.
| Boundary | Description |
|---|---|
| Capture configuration → owned processes | Bound selected recorder/native executable and output paths |
| Captured artifacts → receipt | Real media/tool/input provenance must survive import |
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|---|---|---|---|---|---|
| T-01-16 | Tampering | Native collector | high | mitigate | Argument arrays, contained fresh output and manifest checks before launch/import |
| T-01-17 | Spoofing | Linux evidence classification | high | mitigate | Actual native/input/audio method fields, fail-open acceptance prohibited, explicit unavailable cells |
| T-01-18 | Denial of service | Recording process | medium | mitigate | Bounded durations, owned-process shutdown and incomplete receipts on abort |
| T-01-SC | Tampering | Package installation | high | mitigate | Existing local capture tools only; no new packages |
</threat_model>
<verification>Counted collector tests and original preservation must pass. Native evidence gaps stay open regardless of tooling success. Actual physical input/audibility is reviewed once with the final combined materials.</verification>
<success_criteria>Current Linux route evidence is reproducible and precisely classified, with no unsupported native acceptance claim.</success_criteria>
<output>Create .planning/phases/01-reproducible-fidelity-baseline/01-06-SUMMARY.md with actual case receipt IDs, missing cells and capture limitations.</output>
@@ -0,0 +1,200 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "06"
subsystem: testing
tags: [linux, fidelity, capture, ffmpeg, provenance]
requires:
- phase: 01-01
provides: Typed receipts and eight-cell scenario contract
- phase: 01-02
provides: Local paired review export
- phase: 01-04
provides: Passive runtime observer
- phase: 01-05
provides: Identified sealed Linux checkpoint package
provides:
- Bounded local Linux preflight/run/collect and immutable receipt import
- Forty Linux obligations with exact open dependencies and verified attempt history
- Actual host failed-preflight receipt and local review export
affects: [01-07]
tech-stack:
added: []
patterns: [fresh output allocation, owned child deadlines, sealed package checks, explicit open acceptance]
key-files:
created:
- tools/recon/fidelity_capture.py
- scripts/collect-fidelity-linux.sh
- tests/test_fidelity_capture.py
- docs/evidence/linux-session.md
modified: []
key-decisions:
- "A real host with no display and only auto_null audio yields failed native preflight, never synthetic replacement gameplay."
- "One common failed environment dependency can explain all forty open Linux obligations without inventing forty game launches."
- "Retry history revalidates actual saved receipts and requires new launch/session IDs; focused captures never substitute for the continuous journey."
requirements-completed: [EVID-01, EVID-04]
requirements-acceptance: "OPEN: conditional tooling/preparation contributions complete; actual native physical/audible acceptance remains 0/40 Linux and 0/120 overall. Shared IDs remain Pending while plan 01-07 is unfinished."
coverage:
- id: linux-collector
description: Bounded process/media doubles, actual receipt import and classification
requirement: EVID-04
verification:
- kind: integration
ref: tests/test_fidelity_capture.py
status: pass
human_judgment: false
- id: linux-matrix
description: Eight cells and forty continuous/focused obligations with retained/fresh history
requirement: EVID-01
verification:
- kind: integration
ref: artifacts/fidelity/linux/01-06-matrix.json
status: pass
human_judgment: false
- id: actual-native-capture
description: Actual moving gameplay, physical input, real audible output and original/native comparison
verification: []
human_judgment: true
rationale: "Actual host preflight found no display session and only auto_null audio. All physical/audible and full-route obligations remain assigned to the final combined session."
actuals:
tokens: 14371
tasks: 2
commits: 4
basis: "ceil(chars/4) over the realized four-file production/test/procedure diff: 57484 characters; persisted ledger measures four task commits before summary metadata."
plan_head_before: 31ae6a6ab2ab1c342361de376a8756dafafb8227
plan_head_after: 0172916ffd9e3120e57c87c3bd853965f3e4d196
duration: 14 min
started: 2026-11-13T16:49:00Z
completed: 2026-11-13
status: complete
---
# Phase 01 Plan 06: Linux Capture and Open Native Matrix Summary
**A bounded FFmpeg collector preserves package identity, failed native preflight and all forty Linux obligations without substituting synthetic gameplay.**
## Accomplishments
Both conditional plan tasks are complete. The collector provides `preflight`,
`run`, `collect` and `matrix`; the shell launcher does no build, download or
dummy-device fallback. It validates the sealed existing package/resources,
records OS/tools/hash/device/GPU information, and supports installed X11/Pulse
recording with normal `NewGame.tsk --walk` entry and passive observer. Actual
runtime SDL/active GPU/Vulkan versions remain unavailable without a game launch.
Fresh contained output, inert argument arrays, selected local sources, bounded
metadata/log/media sizes, one deadline and owned-child cleanup implement the
plan's process/filesystem trust boundaries. Raw lossless FFV1/PCM MKV, media
probes, logs, clocks and prelaunch identities survive collection/import. Media
emptiness, missing streams, frozen indicators, interrupted/failed children and
post-launch package changes keep observations incomplete. No automatic acceptance,
retiming, volume adjustment or gameplay/movement change was introduced.
The matrix enumerates each lifetime/dialogue/input cell and all five obligations,
including exact events/procedures and continuous lab → VR04 → lab → outside.
Saved retry history is hash-checked; a new attempt needs a new launch/session ID.
Annotations bind contained prerequisite recordings and actual copy-state identity
records without promoting them to physical/audible review. The Linux procedure
joins the single later Windows/original combined agenda.
## Task Commits
1. Task 1 RED: `9c59f60` — require bounded Linux capture round trip.
2. Task 1 GREEN: `16f5e12` — collect bounded Linux capture and honest failed preflight.
3. Task 2 RED: `e17cfbe` — require full Linux matrix continuity and resume history.
4. Task 2 GREEN: `0172916` — preserve full Linux obligation matrix and capture history.
Normal hooks and the supplied-root/protected-branch checks ran. The primary
explicitly authorized recovery after my first guard extraction omitted its bound
assignment; the complete literal guard then passed before any write. No root drift,
tracked deletion, runtime edit or unrelated `tools.yaml` change occurred. Primary
owns integration reports and push.
## Actual Execution and Package Identity
The outside-sandbox host probe found a TTY session, no `DISPLAY`/`WAYLAND_DISPLAY`
or X11 socket, no resolved Xvfb/OBS command and only suspended PipeWire Pulse
`auto_null`/`auto_null.monitor`. FFmpeg/ffprobe are installed distribution version
`6.1.1-3ubuntu5+esm15`; local help confirms the selected frozen-frame filter.
`lspci` succeeded; `vulkaninfo` is absent. The exact observations/tool hashes and
selected settings are retained. No game/recorder was launched, and no raw
video/audio or observed gameplay/input event was fabricated.
The existing package `artifacts/fidelity/01-05-packages/linux-x64` was reused,
without publish or bulk copying. Its file-list hash remains
`124cf271e4952f3822eec5c24358447fcffc9e9e1803aded8d96d4d4472dc5a3`.
Its actual source is `446930d2a30d6d616c60ac5e59e4169a840bea09`, dirty yes,
diff `90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d`;
the collector revision never replaces that runtime provenance.
| Evidence | Exact local result |
|---|---|
| Task-1 diagnostic | `artifacts/fidelity/linux/01-06-focused-preflight/receipt.json`, ID `linux-01-06-focused-preflight-linux`, failed/open |
| Current typed dependency | `artifacts/fidelity/linux/01-06-matrix-preflight/receipt.json`, ID `linux-01-06-matrix-preflight-linux`, failed/open |
| Current applicable import | `artifacts/fidelity/linux-current-receipts/linux-01-06-matrix-preflight-linux/receipt.json` |
| Full Linux checklist | `artifacts/fidelity/linux/01-06-matrix.json`, 8 cells / 40 obligations, all open |
| Current shared audit | `artifacts/fidelity/linux/01-06-audit.json`, accepted 0 / required 120, invalid `[]` |
| Local review | `artifacts/fidelity/linux/01-06-review/index.html`, failed receipt with no fabricated media |
The older task-1 import remains diagnostic history; select the current typed
receipt for scenario audit. The focused failure is an actual preflight result,
not an executed gameplay moment. Every continuous/focused slot retains the exact
current dependency receipt plus its own actual capture/lifetime/human-review
requirement. No native matrix cell was runnable after the shared preflight failed.
## Verification
- Final counted capture verification: **23 tests pass**, exceeding both 10/14
thresholds. Doubles stay synthetic, native automation stays `port_fixture`,
positive retained file/clock binding and invalid retained-session cases pass.
- Broader `test_fidelity*.py` regression: **156 tests pass** in 36.316 seconds,
including local viewer sockets and existing real .NET/observer fixtures outside
sandbox restrictions. This ran before the final capture-size bound regression;
the final focused suite passed all 23 after that bounded collector change.
Complete report: `artifacts/fidelity/linux/01-06-fidelity-tests.log`.
- Shell syntax and `git diff --check` pass. Both actual failed receipts validate
through the shared validator/importer. The current scenario audit has no invalid
receipts and grants no acceptance.
- Original inventory verified **539 unchanged files** before capture preparation
and repeatedly after collection/final changes. No generated package, original,
trace or raw media is staged.
- Task-1 tracer verification reran and passed before matrix expansion. No blanket
fidelity tolerance or native Windows/original execution claim is made.
## TDD Gate Compliance
Actual records `artifacts/fidelity/tdd/01-06-01-red.json` and
`01-06-02-red.json` both return `RED_EVIDENCE_OK`. Task 1's named target executes
the planned missing capture-API assertion, without import/setup failure. Task 2's
named target executes the missing forty-obligation matrix assertion while the
first twelve tests remain green. Both RED commits precede their GREEN commits.
No separate refactor was needed.
## Deviations from Plan
None in scope. The plan's explicit unavailable-native conditional was exercised:
precise failed preflight, usable collector/procedure and complete open matrix
replace unavailable execution, without waiving acceptance. Additional correctness
checks preserve prelaunch identity after package tampering, bind annotation files
and exclude oversized raw media from unbounded import. These implement the
planned T-01-16/17/18/SC mitigations; no new trust surface was introduced.
## Remaining Acceptance and Next Phase
All **40 Linux** and **120 total** actual original/native acceptance obligations
remain OPEN. A usable display, real output/monitor device, physical play, continuous
and focused recordings, audible/visible/browser review and original-DxWnd/native
Windows comparisons are still required in the final combined session. Independent
fresh execution-copy staging and actual same-process retained state remain visible
procedure obligations; no source package is silently relabeled as a fresh copy.
The unavailable physical/native check is recorded as open WINDOWS ledger entry 2
(`unrun-verify`), not as a passed test or waived truth. No implementation stub or
skipped mandatory automated verification remains. Shared EVID-01/EVID-04 IDs stay
Pending because unfinished plan 01-07 owns their remaining gates.
## Self-Check: PASSED
All four implementation/procedure files exist; all four recorded task commits
are ancestors of HEAD. Actual failed/current receipt files, matrix, audit and local
review export exist. The persisted ledger measures four commits over the recorded
before/after range. Original verification, final counted tests and current receipt
audit pass within their stated scope.
@@ -0,0 +1,163 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "07"
type: execute
wave: 5
depends_on: ["01-06"]
files_modified:
- tools/recon/fidelity_acceptance.py
- tests/test_fidelity_acceptance.py
- docs/evidence/checkpoint-session.md
- docs/evidence/capabilities.json
- docs/evidence/phase01-baseline.md
- docs/progress.md
- docs/tasks.md
- docs/decisions.md
- docs/compatibility.md
- scripts/test.sh
autonomous: false
requirements: [EVID-01, EVID-02, EVID-03, EVID-04]
estimate:
tokens: 30000
raw_tokens: 30000
tasks: 3
confidence: low
must_haves:
truths:
- "One fully prepared combined session covers original-DxWnd and native Windows cases, local Linux review and real paired playback, per D-13–D-16."
- "Every required original-reference and native Linux/Windows case has exact revision/package/resource/media and observation provenance; absent or failed cases keep EVID-02/EVID-04 open."
- "Paired review of actual original/port captures applies D-05–D-08 and publishes raw drift, discrepancies and audible/visible checks."
- "Current capabilities/history/discrepancies are reconciled to returned receipts per D-09–D-12, with full matrix completeness per D-01–D-04."
- statement: "Actual original-DxWnd moving game imagery and intelligible audio are observed and reviewed with wrapper/config limitations recorded."
verification: backstop
- statement: "Actual paired recordings decode, seek and switch exclusive audio in the identified local browser without concealing elapsed time."
verification: backstop
assumptions:
- requirement_id: EVID-02
category: unclassified
status: unresolved
flagged: true
statement: "Deterministic probe could not classify reference-execution edge behavior; manually review original/DxWnd capture boundaries and limitations in the final session."
- requirement_id: EVID-04
category: unclassified
status: unresolved
flagged: true
statement: "Deterministic probe could not classify native-platform execution edges; manually review actual native input/audio/route and identity evidence in the final session."
artifacts:
- path: tools/recon/fidelity_acceptance.py
provides: "Separate readiness and strict acceptance audits"
- path: docs/evidence/checkpoint-session.md
provides: "Final single-session handoff and result checklist"
- path: docs/evidence/phase01-baseline.md
provides: "Actual receipts, discrepancies and open acceptance report"
key_links:
- from: "Returned Windows/local Linux results"
to: tools/recon/fidelity_acceptance.py
via: "Validated artifact identities and complete case/platform plus human checks"
- from: docs/evidence/phase01-baseline.md
to: docs/evidence/capabilities.json
via: "Same receipt IDs and current applicability; no unsupported acceptance promotion"
---
<objective>
Finish the prepared checkpoint, perform the one combined hands-on session and reconcile actual original/native proof. Materials readiness, test success and native/original acceptance have separate verdicts. Missing execution prevents Phase 1 acceptance while permitted source-backed later work may continue under the roadmap exception.
Artifacts this phase produces: fidelity_acceptance.py ready/audit CLI; tests/test_fidelity_acceptance.py; checkpoint-session.md; phase01-baseline.md; final local READY.json, acceptance.json and returned-results manifests. Existing capability/root status documents and scripts/test.sh are updated only after independent plans finish. No user capture is requested before task 01-07-01 readiness succeeds.
</objective>
<scope_budget>
The ten-file list is a bounded final integration exception, estimated at 30,000 tokens
against the 100,000-token plan budget. There are two substantive implementation files:
`tools/recon/fidelity_acceptance.py` and its dedicated tests. Task 01-07-01 owns these
plus the final session checklist; it adds no recorder, viewer or package subsystem.
Task 01-07-02 consumes the already prepared bundle and updates the existing capability
records plus one baseline findings report from validated results. Its human dependency
can remain pending and cannot be disguised as completed acceptance.
Task 01-07-03 has only integration/projection work: add already-created counted test
invocations to `scripts/test.sh`; add revision/receipt/open-status entries to the four
existing root reports. It must not refactor the runner, invent new tests/features,
change gameplay or redesign those reports. These five thin edits share one source
of truth (the final acceptance/test receipts) and remain serially owned here after
all parallel work ends. The checklist and baseline report use the same receipt IDs;
no additional independent design decision is deferred to this plan.
If an implementation change beyond those boundaries is discovered, stop that expansion
and record it for a separately planned task; keep current acceptance gaps explicit.
</scope_budget>
<execution_context>
@/home/cristian/.codex/gsd-core/workflows/execute-plan.md
@/home/cristian/.codex/gsd-core/templates/summary.md
</execution_context>
<context>
@AGENTS.md
@.planning/PROJECT.md
@.planning/ROADMAP.md
@.planning/REQUIREMENTS.md
@.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
@.planning/phases/01-reproducible-fidelity-baseline/01-05-SUMMARY.md
@.planning/phases/01-reproducible-fidelity-baseline/01-06-SUMMARY.md
@.planning/phases/01-reproducible-fidelity-baseline/01-SOURCE-AUDIT.md
</context>
<tasks>
<task type="tracer" tdd="true" id="01-07-01">
<name>Audit one prepared checkpoint from actual receipts through review and explicit pending acceptance</name>
<files>tools/recon/fidelity_acceptance.py, tests/test_fidelity_acceptance.py, docs/evidence/checkpoint-session.md</files>
<read_first>All prior phase SUMMARY interfaces; docs/evidence/scenarios.json; capabilities.json; windows-session.md; linux-session.md; 01-SOURCE-AUDIT.md flagged assumptions/prohibitions; actual checkpoint manifest and available Linux receipts.</read_first>
<behavior>At least 14 tests cover ready/audit end-to-end, complete valid evidence, missing/aborted cases, false native classification, wrong package/resources, synthetic original, absent human visibility/audio/physical-input checks, contradictory/superseded history and both unclassified review flags. Strict audit must exit nonzero on every acceptance gap while ready may report materials prepared with gaps visible.</behavior>
<action>Create tests first. Implement ready --checkpoint ROOT to validate all prepared manifest members, scenario matrix/procedures, package/observer consistency, generated viewer/ledger links, dependency instructions, PowerShell tests and local transfer/result forms. Implement audit --checkpoint ROOT --results ROOT --require-complete to require actual original-DxWnd and native Linux/native Windows case receipts, exact package/resource/artifact identities, complete continuous/focused matrix, observed event provenance, visibility/audibility/physical-input review and wrapper limitations. Structural audits may use --allow-open but print pending acceptance and all missing cases; their zero exit is never a native acceptance result. End-to-end tests import an actual available Linux receipt plus explicitly synthetic negative fixtures, generate the final review index and show strict acceptance staying nonzero until real dependencies are met. Unknown/unclassified probe assumptions and descriptor-less prohibitions require visible human review disposition; do not auto-dismiss them. Research backstop truths A1/A2 abstain to human_needed if real evidence is insufficient. Merge all earlier human-only checks into checkpoint-session.md as one agenda. Recheck manifest freshness immediately before handoff; changed binaries/resources require a new identified bundle, not patched identity labels. No capture request in this task.</action>
<acceptance_criteria>All 14 tests pass; ready produces materials_ready separately from acceptance; audit demonstrably rejects every absent original/native/human dependency; all session materials and pending checks are assembled before handoff.</acceptance_criteria>
<verify>
<automated>python3 -c 'import sys,unittest; s=unittest.defaultTestLoader.discover("tests",pattern="test_fidelity_acceptance.py"); assert s.countTestCases() >= 14,"fewer than 14 acceptance tests"; sys.exit(not unittest.TextTestRunner(verbosity=2).run(s).wasSuccessful())'</automated>
<fails_when>Nonzero exit, fewer than 14 tests, or strict acceptance succeeds on missing/synthetic/misclassified/unreviewed evidence.</fails_when>
<automated>python3 tools/recon/fidelity_acceptance.py ready --checkpoint dist/fidelity/phase01</automated>
<fails_when>Nonzero exit, missing materials_ready=true summary, stale/missing hashed member, or absent acceptance=pending/open status when actual execution is still missing.</fails_when>
</verify>
<done>The complete bundle is reviewable and ready for one combined session; strict original/native acceptance remains separate and correctly pending where evidence is absent.</done>
</task>
<task type="auto" id="01-07-02">
<name>Collect the single combined session and reconcile actual original/native captures</name>
<files>docs/evidence/capabilities.json, docs/evidence/phase01-baseline.md</files>
<read_first>docs/evidence/checkpoint-session.md; ready audit output; returned local result manifests; current capabilities.json; actual original/native captures and receipt categories.</read_first>
<action>After all materials are complete, hand off one local checkpoint and perform the single combined hands-on session per D-13–D-16. Use end-of-phase human verification rather than intermediate checkpoint tasks. Run the prepared PowerShell selftests, select/identify DxWnd/OBS/profile, verify generated original copies, test visible moving content and audible output, then capture every required original-DxWnd/native-Windows case and physical input checks. Complete actual Linux physical/audible checks and real paired playback review from the agenda in the same review cycle. Retain all failed preflights, skipped cells and wrapper/capture/browser limits. Receive results only through local media/filesystem transfer and validate identities before import. Review raw recordings, images, events, exclusive audio, real elapsed/event drift, optional overlays and derivative metadata per D-05–D-08. No universal parity threshold may be invented. Publish per-case/platform findings, discrepancies and remaining conditions in phase01-baseline.md and update capabilities.json current/history per D-09–D-12. Record manual disposition of both unclassified EVID-02/EVID-04 assumptions and project-value prohibitions; insufficient evidence remains flagged human_needed/open. If execution/results are unavailable, retain pending dependencies and allow documentation integration, but do not claim this task's actual capture acceptance or Phase 1 acceptance complete. Prepared tools and failed/partial results cannot satisfy the native/original deliverable.</action>
<acceptance_criteria>Actual returned results are imported and reviewed, or each unavailable result is explicitly pending; strict acceptance can pass only with all required real original/native receipts and human checks. Native Windows, original-DxWnd and Linux remain separate proof categories.</acceptance_criteria>
<verify>
<automated>python3 tools/recon/fidelity_acceptance.py audit --checkpoint dist/fidelity/phase01 --results dist/fidelity/phase01/results --require-complete</automated>
<fails_when>Nonzero exit, any missing case/platform/media/human-review requirement, unresolved assumption affecting acceptance, or missing acceptance=passed result. Expected nonzero while actual evidence is unavailable is an open acceptance dependency, not a successful verification.</fails_when>
<human-check>One combined session: follow checkpoint-session.md, run the original generated copy through identified DxWnd and the port natively on Windows, return results locally, review actual Linux input/audio and paired recordings. Approve only observed case/platform facts; failed/unavailable cases remain open. No earlier fragmented capture request is authorized.</human-check>
</verify>
<done>Required actual original/native captures and review establish acceptance only when strict audit passes; otherwise the exact remaining session dependencies stay open and Phase 1 is not accepted.</done>
</task>
<task type="auto" id="01-07-03">
<name>Integrate local regressions and publish exact evidence status</name>
<files>scripts/test.sh, docs/progress.md, docs/tasks.md, docs/decisions.md, docs/compatibility.md</files>
<read_first>docs/evidence/phase01-baseline.md; actual acceptance.json and test logs; existing scripts/test.sh; current root status reports; all phase SUMMARY evidence limitations.</read_first>
<action>Integrate counted fidelity Python tests, built-in Node viewer checks and standalone observer tests into scripts/test.sh without duplicate full runs or new dependencies. The consolidated runner must reject zero discovered fidelity tests. Run the existing complete local suite and builds/package identity/resource checks required by changed observer/package boundaries, record actual durations/counts and preserve original hashes. Full-suite/native checks may exceed the quick-test budget; report their separately measured duration. Update all four durable status reports with actual implementation/test/native/whole-original facts, receipt IDs, package/source identities and open gaps; no historical totals copied as new results. If task 01-07-02 remains pending, prominently retain EVID-02/EVID-04 and Phase 1 acceptance open and cite the roadmap source-backed continuation exception. Include test/tool completion and prepared materials as their narrower facts. Keep all generated media/packages/traces local and ignored. Primary integration owns verified commits/push to existing Gitea; this plan authoring assignment performs no implementation or commits.</action>
<acceptance_criteria>The complete local suite and original inventory pass with measured positive counts; status documents agree with strict audit; no pending native/original dependency is marked complete; originals/packages/captures remain outside source uploads.</acceptance_criteria>
<verify>
<automated>scripts/test.sh</automated>
<fails_when>Nonzero exit, zero/missing fidelity or viewer/observer test count, failed managed/GPU/resource/preservation check, or missing consolidated completion log.</fails_when>
<automated>python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json</automated>
<fails_when>Nonzero exit or missing Verified 539 unchanged original files.</fails_when>
</verify>
<done>Local regressions and durable reports truthfully record current proof; Phase 1 acceptance is reported passed only after actual strict original/native acceptance, otherwise remains open.</done>
</task>
</tasks>
<threat_model>
ASVS level 1; unresolved high/critical threats block acceptance.
| Boundary | Description |
|---|---|
| Returned local results → current acceptance | Artifacts and human findings are validated before promotion |
| Prepared checkpoint → user execution | Launch provenance and complete materials are reviewed before handoff |
| Threat ID | Category | Component | Severity | Disposition | Mitigation Plan |
|---|---|---|---|---|---|
| T-01-19 | Spoofing | Strict acceptance audit | high | mitigate | Require actual method/platform/matrix/identities and human review; reject synthetic/Wine/cross-publish/native substitution |
| T-01-20 | Tampering | Returned result import | high | mitigate | Recheck hashes/containment, atomic import, conflicting duplicate rejection and retained diagnostics |
| T-01-21 | Repudiation | Final evidence/status | medium | mitigate | Exact receipt IDs, explicit history and flags; pending dependencies prevent completion claims |
| T-01-SC | Tampering | Package installation | high | mitigate | Existing dependencies only; no new installation or upload service |
</threat_model>
<verification>Task 01-07-01 proves readiness and strict rejection behavior. Task 01-07-02 requires actual combined-session receipts for acceptance. Task 01-07-03 records local regressions and exact passed/open status; it cannot waive missing original/native evidence.</verification>
<success_criteria>Testers can reproduce identified original/port scenarios and inspect exactly what each native platform proves; unavailable execution remains an explicit incomplete acceptance dependency.</success_criteria>
<output>Create .planning/phases/01-reproducible-fidelity-baseline/01-07-SUMMARY.md with prepared versus accepted status, actual receipts and outstanding human dependencies.</output>
@@ -0,0 +1,196 @@
---
phase: 01-reproducible-fidelity-baseline
plan: "07"
status: complete
completion_scope: autonomous preparation and pending-evidence reconciliation
acceptance: human_needed
subsystem: testing
tags: [fidelity, acceptance, checkpoint, local-regressions]
requires:
- phase: 01-06
provides: Linux collector and failed native preflight diagnostic
provides:
- Strict ready/audit gates and fresh local combined-session materials
- Pending original/native/human acceptance and exact reconciliation mapping
- Counted consolidated local regressions and measured final evidence status
affects: [phase01-acceptance, phase02]
tech-stack:
added: []
patterns: [receipt-bound human findings, immutable materials, explicit current selection, positive test counts]
key-files:
created: [tools/recon/fidelity_acceptance.py, tests/test_fidelity_acceptance.py, docs/evidence/checkpoint-session.md, docs/evidence/phase01-baseline.md]
modified: [tools/recon/fidelity_checkpoint.py, tests/test_fidelity_checkpoint.py, docs/evidence/capabilities.json, scripts/test.sh, docs/progress.md, docs/tasks.md, docs/decisions.md, docs/compatibility.md]
key-decisions:
- "Ready materials and local regressions never substitute for actual original/native acceptance; all 120 obligations and ten named human findings remain open."
- "The integration agent reconciles returned collector records through specified artifact mappings; the tester collects, observes and returns one combined session."
requirements-completed: []
actuals:
tokens: 18163
tasks: 2
commits: 5
plan_head_before: d18f551a26f90cd645309dcd545295911b581357
plan_head_after: 472500bf4e191c2080764471b6b08486c1909b3a
duration: "4h 36min observed commit-to-closeout elapsed, including quota pause; full suite 782.05s"
completed: 2026-11-13
coverage:
- id: D1
description: Immutable readiness and strict rejection of missing original/native/human evidence
verification:
- kind: integration
ref: tests/test_fidelity_acceptance.py; 23 checks in completed local suite
status: pass
- kind: integration
ref: fidelity_acceptance.py ready; 11000 immutable files
status: pass
human_judgment: false
- id: D2
description: Actual combined original-DxWnd/native Linux/native Windows capture and review
verification:
- kind: manual_procedural
ref: docs/evidence/checkpoint-session.md; acceptance.json 0/120
status: unknown
human_judgment: true
rationale: Actual moving content, physical input, audibility and paired playback remain unavailable; strict acceptance exits 1.
- id: D3
description: Counted fidelity regressions integrated with the existing complete local suite
verification:
- kind: integration
ref: artifacts/fidelity/01-07-full-suite.json; exit 0 in 782.0496263504028 seconds
status: pass
human_judgment: false
---
# Phase 01 Plan 07: Strict Fidelity Acceptance Checkpoint Summary
**Fresh 11,000-file offline materials pass readiness and the complete local suite; strict acceptance retains 0/120 original/native obligations and ten human judgments.**
Autonomous preparation and truthful pending-status reconciliation are complete.
Tasks 01-07-01 and 01-07-03 are complete. Task 01-07-02's permitted unavailable-
evidence projection is committed; its actual combined capture/review remains
pending. `status: complete` describes that preparation scope, never Phase 1 or
EVID acceptance. All EVID requirements remain Pending. Phase 2 is not advanced.
The stale quota handoff is retained for primary review/consumption separately.
## Performance and Accounting
- Earliest production-task commit: 2026-11-13T17:09:46Z; closeout: approximately 21:46Z.
- Observed elapsed interval includes the quota pause; active execution time was not measured continuously.
- Full authorized local suite: 782.0496263504028s, exit 0; runner reports 783s.
- Realized diff: 72,652 characters / 4 = 18,163 tokens, including committed quota metadata.
- Persisted plan ledger measures five commits before this summary; hashes above bound that measurement.
- Two fully completed tasks; one pending actual human task with its permitted documentation complete.
## Task Commits
| Task | Commit | Result |
|---|---|---|
| 01-07-01 RED | d78b135 | 18 intentional missing-API assertions fail; machine RED_EVIDENCE_OK |
| 01-07-01 GREEN | 026def9 | Strict audit, 23 passing tests, fresh final bundle and reconciliation checklist |
| 01-07-02 pending projection | fc5e936 | Capability ledger retains failed diagnostic and unresolved human states |
| Quota checkpoint | b732256 | Existing handoff/state only; no production behavior change |
| 01-07-03 | 472500b | Counted existing regressions and actual full-suite/status results |
## Verification Results
The complete suite ran once after the scoped reporter correction; its completed
receipt is `artifacts/fidelity/01-07-full-suite.json` and full output is
`artifacts/fidelity/01-07-full-suite.log`. No duplicate final suite was run.
| Verification | Actual result |
|---|---|
| Python discovery | 556 tests in 68.110s; 180 fidelity across all eight modules |
| Fidelity module counts | acceptance 23, capture 23, checkpoint 24, ledger 31, observation 7, review 21, scenarios 22, sessions 29 |
| Node viewer | 27 tests pass with explicit TAP reporter |
| Standalone managed observer | 23 checks pass |
| HUD Python | 2 separate tests in 0.171s |
| Managed entry points/build | All 51 test-project invocations and main build pass |
| Vulkan | 36 rendered receipts across 32 device groups; 27 saved readbacks; zero reported validation errors |
| Material regression | 17 Vulkan material/readback assertions pass, zero validation errors |
| SDL audio | Existing dummy-audio effect/stream/scene/cutscene checks pass; audibility remains unverified |
| Preservation | Verified 539 unchanged original files |
| Final readiness recheck | 11,000 immutable files; materials_ready=true, acceptance=human_needed |
| Final strict audit recheck | Exit 1; errors=[], accepted 0/120; ten human findings pending |
Optional `NEUTRON_WINDOW_TEST=1` checks were not enabled; no new native window,
physical-input, audible, original gameplay or native Windows execution is claimed.
Existing NU1900 unavailable vulnerability-metadata warnings remain unrelated.
First attempt: Python 556 passed in 71.765s and Node 27 passed, but the new TAP
count guard rejected Node's default spec reporter. Its 74.647s attempt/log is
retained as `01-07-full-suite-attempt1.{json,log}`. Explicit TAP passed focused
checks and the completed full rerun.
## Exact Evidence and Package Identity
- Final bundle: `dist/fidelity/phase01`; READY SHA-256 `48100025fbdcbb5310bdae28b5cae1e8f17412aa7b03be5f823616cd88211951`.
- Manifest SHA-256: `46610a4029f1341e7f48147370a81daaa8ff799a60fba388b641a0678d2032aa`.
- Exact tool/package identities: `artifacts/fidelity/verification/01-07-final-checkpoint.json`.
- Runtime source: `446930d2a30d6d616c60ac5e59e4169a840bea09`, dirty true, diff `90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d`. Later tool/docs commits do not relabel existing packages.
- Actual failed receipt: `linux-01-06-matrix-preflight-linux`, imported under final `results/imported/`; diagnostic viewer: `results/failed-linux-review/index.html`.
- Final audit: `dist/fidelity/phase01/results/acceptance.json`; actual capture and human acceptance remain OPEN.
- Capability validation: 25 capabilities, 33 requirements, 33 reconciled rows, six groups; acceptance OPEN.
No runtime source changed in task 3, no package rebuild/relabel occurred, and no
originals, generated packages, media or traces were uploaded. All remain local.
## Files Created/Modified
`fidelity_acceptance.py` and its dedicated tests separate readiness from strict
acceptance. The existing checkpoint assembler/tests add required final materials
and tool provenance. `checkpoint-session.md` prepares one combined review and
`phase01-baseline.md` records actual/pending findings. `capabilities.json` retains
the failed receipt and unresolved current states. `scripts/test.sh` counts the
existing fidelity Python/Node/observer checks; the four root status reports cite
the completed suite, exact identities and pending acceptance. Planning artifacts
record the quota interruption and final autonomous preparation scope.
## Decisions Made
Prepared bytes, diagnostic fixtures and local regression success do not replace
actual original/native receipts or human judgments. Reconciliation remains an
agent-owned operation after one combined tester session; no fragmented early
capture request or new universal fidelity tolerance is introduced.
## Deviations from Plan
- Approved ownership extension: minimal checkpoint MATERIALS expansion, actual tool_source metadata and existing material-membership assertion update make the final immutable bundle contain Linux/audit dependencies; no second assembler/capture subsystem.
- Baseline pending report was created with task 1 because it must exist before immutable assembly; task 2 actual capture acceptance remains open.
- **[Rule 1 - Bug]** Task 3's new positive-count guard expected TAP while installed Node emitted spec. Explicit `--test-reporter=tap` fixes that scoped runner mismatch; focused 27 checks and complete rerun pass. Commit: `472500b`.
- Quota reserve interrupted closeout; the retained quota commit did not add behavior. The completed suite was recovered after reset without repeating it.
## TDD Gate Compliance
Task 1 RED preceded GREEN: `d78b135` then `026def9`. Saved
`artifacts/fidelity/01-07-red.{log,json}` records RED_EVIDENCE_OK. Prior semantic
inspection confirmed the empty-matrix test ran and failed on planned API existence,
without load/setup failure. Final suite executes all 23 acceptance checks.
## Deferred Issues and Human Dependencies
Actual original-DxWnd 40/native Windows 40/native Linux 40 obligations remain OPEN.
A1/A2, both EVID-02/EVID-04 unclassified assumptions, P1/P2/P3, browser,
paired_review and physical_input are the ten pending named findings. No strict
acceptance verification passed; its expected nonzero result records that missing
evidence. `.planning/WINDOWS.md` entry 3 tracks this unmet truth; entry 2 retains
the Linux capture access dependency. The primary reviews readiness before the
single combined human session. The roadmap source-backed continuation exception
does not waive these dependencies or authorize a phase transition here.
## Known Stubs
None preventing autonomous preparation. Checklist JSON metavariables are explicit
human-review templates, never positive findings. Empty review dictionaries in
negative tests and fail-closed audit defaults intentionally exercise missing
evidence; no production UI/data stub was introduced. Existing gameplay admission
gates remain unchanged. No new security surface beyond the planned local evidence
file/import boundaries was introduced.
## Self-Check: PASSED
All created source/test/checklist/baseline files, final local checkpoint, completed
suite receipt and exact identity receipt exist. All five recorded commits are
ancestors of the measured HEAD. Final readiness passes and strict audit retains
errors=[], 0/120 and ten pending findings. Unrelated `tools.yaml` is preserved.
## Independent review closure
Five confirmed findings were fixed and independently verified; see01-REVIEW.md,01-FIX-REPORT.md,01-REVIEW-VERIFY.md and01-REVIEW-DISPOSITION.md. Final refinement02d182f requires actual artifact bytes at the scenario boundary;191 fidelity checks pass43.355s. The new checkpoint has11,001 immutable entries with current local identities in artifacts/fidelity/verification/01-07-final-checkpoint.json; prior identity notes remain historical. All22 planned security threats are closed, while actual0/120 acceptance and ten named human findings stayOPEN. No original/native acceptance or phase advancement is implied.
@@ -0,0 +1,136 @@
# Phase 1: Reproducible Fidelity Baseline - Context
**Gathered:** 2026-11-12
**Status:** Ready for planning
<domain>
## Phase Boundary
Establish reproducible original/port comparison scenarios, original-file preservation,
a full-game coverage ledger and revision-specific native Linux/Windows baseline
receipts (EVID-01 through EVID-04). Build on existing implementation and evidence.
This phase establishes comparison infrastructure and captures; movement fixes and
broader gameplay admission retain their later phase gates. Unavailable execution
keeps affected acceptance open under the roadmap's source-backed-work exception.
</domain>
<decisions>
## Implementation Decisions
### Baseline journeys
- **D-01:** Capture the continuous lab → VR04 → lab → outside journey and focused replays of specific moments, including dialogue return, banked jumps and landing.
- **D-02:** Natural and skipped dialogue are equally required baseline cases.
- **D-03:** Fresh entry and retained departure/return receive separate, equally required runs that preserve their respective lifetimes.
- **D-04:** Include ordinary play and deliberate edge cases: held input through dialogue/return, banked jumps, landing and idle.
### Comparison review
- **D-05:** Open scenario results with paired original/port playback and links to corresponding images, audio and input/event traces.
- **D-06:** Keep captures unobstructed by default; annotations and image differences are optional overlays.
- **D-07:** Align key events while preserving actual recording speed and elapsed time; expose timing drift rather than concealing it through retiming.
- **D-08:** Switch between original and port audio at corresponding moments, playing one recording at a time. Clearly label any review-only volume adjustment.
### Evidence navigation
- **D-09:** Browse the full-game ledger by gameplay capability (movement, contacts, gadgets, progression, visuals, audio), with links to scenarios, source evidence and platform receipts. Retain requirement traceability.
- **D-10:** Each capability leads with what works, where it was verified, known differences and remaining acceptance conditions.
- **D-11:** Show current applicable evidence first; retain expandable history with exact revisions and clear superseded labels.
- **D-12:** Order discrepancies by player impact: blocking or visibly disruptive failures first, then subtler differences and missing verification. Missing evidence still leaves its acceptance open regardless of display order.
### Original and Windows access
- **D-13:** The user has a local Windows PC available to run prepared packages and return results. Availability does not itself establish successful native execution.
- **D-14:** Prepare one local test bundle per checkpoint. A launcher collects source/package/resource identities, logs and captures, with clear user steps and local transfer instructions. Packages and captures remain local.
- **D-15:** Run a separate generated copy of the original on that Windows PC through **DxWnd**. Record DxWnd version/configuration and execution/rendering limitations with each capture. Preserve wrapper provenance separately from native Windows port receipts; do not silently treat wrapper behavior as historical-platform parity.
- **D-16:** Prepare all materials before one combined hands-on session per checkpoint, covering original-reference captures and port checks and collecting results together.
### Carried-forward constraints
- Preserve every original byte and never execute originals in place; verify against `docs/original-manifest.json`.
- Preserve the implemented TSK-backed first-story input-order correction, fresh direct-scene order and legitimate landing bank. No invented leveling reset or replacement movement tuning.
- Keep source recovery, inference, copied-original component execution, port runtime, Wine, DxWnd reference execution, cross-publish and native platform receipts explicitly distinguished.
- Current Windows and original-reference acceptance remain open until new identified receipts demonstrate the required scenarios. A prepared bundle, wrapper launch or historical result alone cannot close them.
- All builds/tests/captures/packages stay local. Push only verified source/tools/docs to the existing Gitea remote. Preserve current actor/collision admission gates and the lab/outside compatibility solver.
### Agent discretion
No product decisions were explicitly delegated. Research/planning selects file formats,
local viewer technology, capture tooling, event markers and bundle mechanics within
the decisions above. The discussion does not require an external hosted website.
</decisions>
<canonical_refs>
## Canonical References
**Downstream agents MUST read these before planning or implementing.**
### Scope and preservation
- `.planning/PROJECT.md` — full reconstruction goal, constraints and existing foundations.
- `.planning/REQUIREMENTS.md` — EVID-01 through EVID-04 and full-game acceptance definitions.
- `.planning/ROADMAP.md` — Phase 1 boundary, access exception and later phase dependencies.
- `AGENTS.md` — current fidelity, source-control, REA and gameplay admission rules.
- `../AGENTS.md` — parent project requirements and evidence preservation.
- `../prompt.MD` — authoritative reconstruction specification; later push authorization supersedes older Git restrictions.
- `docs/original-manifest.json` — original-file identity baseline.
### Current evidence and protected behavior
- `docs/progress.md` — implementation and revision-specific verification status.
- `docs/compatibility.md` — platform receipts and explicit verification limitations.
- `docs/tasks.md` — existing work and open gates.
- `docs/decisions.md` — durable project decisions.
- `docs/checkpoint/next-work-plan.md` — movement/recovery and route verification sequence.
- `docs/checkpoint/coverage.md` — existing coverage/admission ledger.
- `docs/checkpoint/implementation-plan.md` — reconstruction dependencies and remaining gates.
- `docs/gameplay/main-menu-player-lifetime.md` — implemented TSK-backed startup-order correction.
- `docs/gameplay/jimmy-movement-stabilization.md` — movement baseline and stabilization priority.
### Reusable infrastructure
- `.planning/codebase/TESTING.md` — local tests, fixtures and runtime evidence boundaries.
- `.planning/codebase/CONVENTIONS.md` — bounded tooling and evidence-reporting conventions.
- `.planning/codebase/STRUCTURE.md` — source, tool and documentation integration locations.
- `docs/rea.md` — original-binary investigation workflow when needed.
No user-supplied DxWnd configuration document was provided; capture the actual local
version/settings during preparation and execution, without inventing them.
</canonical_refs>
<code_context>
## Existing Code Insights
### Reusable Assets
- `tools/recon/inventory.py` — hash verification using the recorded manifest.
- `tools/recon/reference_capture.py` — existing copied-original isolated Wine capture and port smoke infrastructure; useful starting evidence/tooling, not proof of Windows/DxWnd support.
- `scripts/test.sh` — consolidated local Python, managed, rendering/audio and original-hash checks.
- `scripts/test-window-transitions.sh` — existing local native window/transition verification.
- `scripts/package.sh`, `scripts/build-linux.sh`, `scripts/build-windows.sh` — existing offline package/build paths and provenance foundations.
- `src/GamePort/Application/CutsceneIdleSmoke.cs`, `src/GamePort/Application/WindowTransitionSmoke.cs` — existing native scenario fixture patterns; reuse suitable behavior instead of claiming component fixtures are gameplay.
### Established Patterns
- Python standard-library tooling and standalone .NET 10 console regression projects.
- Saved original observations and full-state/event comparisons are distinct from integrated native captures.
- Generated resources, screenshots, traces and packages stay in ignored local output, outside originals and source commits.
- Durable reports identify exact revisions, supporting source evidence and bounded verification scope.
### Integration Points
- `tools/recon/` for inventory/reference orchestration; `scripts/` for local launch/test/package entry points.
- `src/GamePort/Program.cs` and existing application fixtures expose bounded port capture routes; gameplay algorithms remain protected by current gates.
- Existing `docs/checkpoint/coverage.md` and root status reports provide ledger inputs; reconcile current/superseded receipts rather than assuming report order establishes current proof.
- A local comparison viewer connects scenario captures, optional overlays, timing markers, audio selection and capability-ledger links. Its implementation is a planning choice.
</code_context>
<specifics>
## Specific Ideas
The user explicitly clarified: “Local testing on my windows machine will have the
original game running via dxwnd”. Use that setup for the planned Windows original
reference sessions. Compare original and port without simultaneous mixed audio or
hidden timing correction. Prepare a complete, reviewable local checkpoint bundle
before requesting hands-on execution.
</specifics>
<deferred>
## Deferred Ideas
None — discussion stayed within phase scope. Native execution and capture are
future execution tasks, not results established by this discussion.
</deferred>
---
*Phase: 01-reproducible-fidelity-baseline*
*Context gathered: 2026-11-12*
@@ -0,0 +1,231 @@
# Phase 1: Reproducible Fidelity Baseline - Discussion Log
> **Audit trail only.** Planning, research and execution consume CONTEXT.md, not this log.
**Date:** 2026-11-12
**Phase:** 01-reproducible-fidelity-baseline
**Areas discussed:** Baseline journeys, Comparison review, Evidence navigation, Original and Windows access
The user selected all four areas. Discussion used individual numbered text questions.
Each area was completed explicitly, and the user selected “Ready for context” after the final summary.
## Baseline journeys
### For lab → VR04 → lab → outside, how should comparison runs be organized?
| Option |
|--------|
| Full route plus focused replays (Recommended) |
| Full route first |
| Focused replays first |
**User’s choice / clarification:** Full route plus focused replays: capture the continuous journey, then replay specific moments such as dialogue return, banked jumps and landing.
### How should natural and skipped dialogue appear in the baseline?
| Option |
|--------|
| Both as equal cases (Recommended) |
| Natural dialogue first |
| Skipped dialogue first |
**User’s choice / clarification:** Both as equal cases: run the route with dialogue completing naturally and with dialogue skipped.
### How should fresh entry and retained return be covered?
| Option |
|--------|
| Separate, equally required runs (Recommended) |
| Continuous journey first |
| Fresh start first |
**User’s choice / clarification:** Separate, equally required runs: capture a clean start and a continuous departure/return journey, preserving each lifetime.
### How should player inputs be chosen for the focused replays?
| Option |
|--------|
| Normal play plus deliberate edge cases (Recommended) |
| Normal play first |
| Repeat your reported sequences first |
**User’s choice / clarification:** Normal play plus deliberate edge cases: include ordinary movement alongside held input through dialogue/return, banked jumps, landing and idle.
### More on baseline journeys, or next area?
| Option |
|--------|
| Next area |
| More on baseline journeys |
**User’s choice / clarification:** Next area: Comparison review.
## Comparison review
### What should appear first when opening scenario results?
| Option |
|--------|
| Paired playback with marked differences (Recommended) |
| Written findings first |
| Chronological capture timeline |
**User’s choice / clarification:** Paired playback with marked differences: original and port shown together, with links to matching images, audio and input/event traces.
### How should differences be highlighted?
| Option |
|--------|
| Clean playback with optional overlays (Recommended) |
| Annotations always visible |
| Clean playback with notes alongside |
**User’s choice / clarification:** Clean playback with optional overlays: both captures remain unobstructed by default; annotations and image differences can be toggled for inspection.
### How should original and port playback line up when timing differs?
| Option |
|--------|
| Align key events and show timing drift (Recommended) |
| Start together and run continuously |
| Step through matching events |
**User’s choice / clarification:** Align key events and show timing drift, preserving actual recording speed and elapsed time.
### How should audio be reviewed?
| Option |
|--------|
| Switch between original and port (Recommended) |
| Original then port excerpts |
| Separate audio review |
**User’s choice / clarification:** Switch between original and port at corresponding moments, hearing one recording at a time; review-only volume adjustments must be clearly labeled.
### More on comparison review, or next area?
| Option |
|--------|
| Next area |
| More on comparison review |
**User’s choice / clarification:** Next area: Evidence navigation.
## Evidence navigation
### What should be the main entry point into the full-game evidence ledger?
| Option |
|--------|
| Gameplay capabilities (Recommended) |
| Playable journeys |
| Requirements |
**User’s choice / clarification:** Gameplay capabilities: browse movement, contacts, gadgets, progression, visuals and audio; each leads to scenarios, source evidence and platform receipts.
### What should each capability show before detailed evidence?
| Option |
|--------|
| Current state and remaining gap (Recommended) |
| Latest comparison result |
| Evidence summary |
**User’s choice / clarification:** Current state and remaining gap: what works, where it was verified, known differences and remaining acceptance conditions.
### How should earlier evidence appear when newer work supersedes it?
| Option |
|--------|
| Current evidence first, history expandable (Recommended) |
| Full history alongside current evidence |
| Separate history index |
**User’s choice / clarification:** Current evidence first, history expandable; retain older results with clear revision and superseded labels.
### How should open discrepancies be ordered within a capability?
| Option |
|--------|
| Player impact first (Recommended) |
| Route order |
| Newest findings first |
**User’s choice / clarification:** Player impact first: failures blocking or visibly disrupting play precede subtler differences and missing verification.
### More on evidence navigation, or next area?
| Option |
|--------|
| Next area |
| More on evidence navigation |
**User’s choice / clarification:** Next area: Original and Windows access.
## Original and Windows access
### What Windows environment is available for this phase?
| Option |
|--------|
| A local Windows PC |
| A local Windows VM |
| None currently |
**User’s choice / clarification:** A local Windows PC; the user can run a prepared test package and return results.
### How should Windows checks be run?
| Option |
|--------|
| One local test bundle per checkpoint (Recommended) |
| Guided sessions |
| Written checklist |
**User’s choice / clarification:** One local test bundle per checkpoint, with a launcher collecting revision details, logs and captures; packages and captures remain local and transfer uses a local method.
### Can the Windows PC also run a separate generated copy of the original?
| Option |
|--------|
| Yes, try it on that PC (Recommended) |
| Use Linux/Wine for original captures |
| Original-game execution is unavailable for now |
**User’s choice / clarification:** Yes, try it on that PC, using a separate generated copy and recording execution/rendering limitations.
### How should hands-on capture sessions be scheduled?
| Option |
|--------|
| Prepare everything, then one combined session per checkpoint (Recommended) |
| Original captures first, port checks later |
| Short sessions as needed |
**User’s choice / clarification:** Prepare everything, then one combined session per checkpoint, bundling original-reference captures and port checks with clear steps and collecting results together.
### Finish execution access or discuss further?
| Option |
|--------|
| Finish this area |
| More on execution access |
**User’s choice / clarification:** User clarification: Local testing on my windows machine will have the original game running via dxwnd.
### Finish this area or discuss the DxWnd setup further?
| Option |
|--------|
| Finish this area |
| Discuss the DxWnd setup further |
**User’s choice / clarification:** Finish this area. Original reference execution uses DxWnd; record its version/configuration with captures and distinguish wrapper effects from native Windows port checks.
## Agent discretion
No explicit product-choice delegation. Implementation mechanics remain for research/planning within the captured decisions.
## Deferred Ideas
None.
@@ -0,0 +1,114 @@
---
phase: 01-reproducible-fidelity-baseline
fixed_at: 2026-11-13T22:09:37Z
review_path: .planning/phases/01-reproducible-fidelity-baseline/01-REVIEW.md
iteration: 1
findings_in_scope: 5
fixed: 5
skipped: 0
status: all_fixed
---
# Phase 01: Code Review Fix Report
All five confirmed findings were fixed. Their logic changes require independent
human/reviewer verification; automated results below establish the stated tooling
contracts, never original/native gameplay acceptance. No runtime/gameplay source,
original file, package bytes, review disposition, or phase state was changed.
| Finding | Status | Commit | Applied fix and regression |
|---|---|---|---|
| CR-01 | fixed: requires human verification | `5569bc2` | Carry the actual selected receipt path into digest review. Two different sibling JSON files without a sidecar prove that only the selected file's digest satisfies the human finding; absent/unrelated digests leave findings pending. |
| CR-02 | fixed: requires human verification | `bda35e5` | Supply the complete checkpoint original file inventory, recompute its digest, and bind `identity.executable.original_member` plus size/header/hash to the exact pristine member. Original pre/post/package/resources require full baseline file records and digest. Positive original fixtures retain actual member/executable hashes; wrong executable/member and altered inventory records fail. Writable-copy post changes are separately identified and remain allowed. |
| CR-03 | fixed: requires human verification | `6e5ee0b` | Bind both lifetimes to the validated named `identity.copy_pre` record; retained lifetimes also require `identity.retained_copy`. Unknown hashes and hashes of launcher/package/other state records fail. Fixtures now retain distinct actual copy-state files. |
| WR-01 | fixed: requires human verification | `548c97a` | Assemble the existing validated ledger projection before review export, seal it at `protocol/capability-ledger.json`, and compare viewer current/history against it during readiness. Actual preparation-to-bundled-renderer regression retains the named current and superseded startup records; a sealed viewer missing history is rejected. |
| WR-02 | fixed: requires human verification | `2608517` | Recover missing `run.json` only as aborted from the retained incomplete record. Preserve the raw initial bytes as an importable `recovery-initial.json` diagnostic artifact, retain session/start identity, remove initial placeholder end clocks, and reject captured promotion or launch-aligned events. Shared validation/import permits this open aborted record with absent end clocks. |
WR-01 has one additional positive regression commit, `a821754`, proving readiness
on a standalone copied checkpoint with no source Git checkout. No fix was skipped
or rolled back. Five finding commits plus this verification commit were made.
Modified source: `tools/recon/fidelity_acceptance.py`, `fidelity_receipts.py`,
`fidelity_checkpoint.py`, and `scripts/collect-fidelity-windows.ps1`. Tests:
`tests/test_fidelity_acceptance.py`, `test_fidelity_scenarios.py`,
`test_fidelity_checkpoint.py`, and `fidelity-windows.Tests.ps1`. Field contracts:
`docs/evidence/checkpoint-session.md` and `windows-session.md`. No new source file
or dependency was required.
## Verification
All gates ran locally in the **main checkout**. The primary explicitly authorized
a temporary `workflow.use_worktrees=false` override. Its original absent setting
was restored without staging or committing it; the unused clean worktree was
removed before edits. Unrelated untracked `tools.yaml` remains unchanged. Normal
Git hooks ran for every commit. The WR-01 refinement was folded into its commit
before the primary's no-rebase steering arrived; subsequent history is preserved.
Logs are retained under ignored `artifacts/fidelity/01-review-fixes/`:
- `python-fidelity.log`: all 189 fidelity regressions passed in 40.072 seconds.
Initial sandbox execution hit eight loopback-socket permission errors; the
successful scoped-escalation run permits only the local tests' necessary host
operations. These were environment errors, not accepted failed tests.
- `acceptance-final.log`: 29 acceptance tests passed after the final standalone
transfer regression was added. This includes the refined readiness path; these
tests overlap the 189-test run and are not added to its count.
- `node-viewer-direct.log`: 27 actual Node behavior tests passed. On this host
`node --test` reports an aggregate one-file result; direct execution supplied
the explicit 27-test count. The preparation test also rendered the real bundled
model with the bundled renderer and a DOM double, without claiming browser
playback evidence.
- `powershell.log`: 18 package-free synthetic tooling checks passed under cached
Linux-hosted PowerShell. This is not native Windows execution evidence.
- `recovered-import.log`: the actual incomplete-only PowerShell output passed
shared validation and atomic import; accepted is false. Raw fixture output and
imported bytes are retained in separate `test-windows-results/` and
`test-recovered-imports/` namespaces.
- `original-preservation.log`: all 539 original files unchanged. The same
inventory command passed after assembly as well; preparation independently
checked the original inventory before and after copying.
- Python parse checks and `git diff --check` passed. The prior 13-minute full
managed/GPU suite was not repeated because these changes touch tooling and
evidence contracts only.
## Fresh immutable checkpoint
The final checkpoint was assembled **once**, using unchanged existing
`artifacts/fidelity/01-05-packages/{linux-x64,win-x64}` bytes. The prior tree was
preserved at `dist/fidelity/phase01-pre-review-48100025`; the documented current
path remains `dist/fidelity/phase01`. No sealed member was patched after assembly.
Mutable results contain a fresh import of the existing failed Linux preflight
receipt and the unchanged pending human-review controls; no captured evidence was
invented. The former assembly remains historical evidence.
| Item | Identity/result |
|---|---|
| Current checkpoint | `dist/fidelity/phase01` |
| Immutable members | 11001 |
| READY SHA-256 | `7ceebcb3a22549a59bb9f7032c5c686b4ca4d32cf7b6a7d934e12e37f05e7aba` |
| Manifest SHA-256 | `a4da759bb264d63b716a931ae3b16a410baf01e36a7b2696ae8ed5649f77f7a9` |
| Tool commit | `a821754b6755151a0e33e4ac5065c8efd252b2e6` |
| Tool working-tree provenance | Tracked diff empty; dirty true solely from preserved untracked `tools.yaml`, identified by the manifest |
| Sealed runtime source | `446930d2a30d6d616c60ac5e59e4169a840bea09`, dirty true |
| Runtime publish diff | `90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d` |
| Linux package tree | `124cf271e4952f3822eec5c24358447fcffc9e9e1803aded8d96d4d4472dc5a3` |
| Windows package tree | `335e5b75ec15c0fa904113d8b69d4f50e2cfa403f1f2f225353bd9e586322ef4` |
| Startup viewer projection | Two current and two historical records retained |
| Readiness | Exit 0, `materials_ready: true`, `acceptance: human_needed` |
| Strict acceptance | Exit 1, 0/120, no structural errors, all ten human findings pending |
`prepare-checkpoint.log`, `readiness.json`, `acceptance.json`, and
`failed-linux-import.json` retain the actual results. The readiness and acceptance
reports also reside under the current bundle's mutable `results/` directory.
The ten pending findings remain A1, A2, EVID-02-unclassified,
EVID-04-unclassified, P1, P2, P3, browser, paired_review, and physical_input.
The host still lacks actual original/native Windows capture access and a usable
Linux display/audio session. Independent re-review and the primary's remaining
security/coverage gates precede any combined capture request.
This report is intentionally uncommitted for the primary workflow to review and
commit. No push, package upload, original execution, or original write occurred.
## Final artifact-boundary refinement
CR-03 independent re-review caught pathless hash-only named records. RED48fca0d reproduces fresh/retained missing-file, wrong-size and hash-only cases; GREEN02d182f validates actual named files inside scenario observation with an explicit root. All191 fidelity tests pass in43.355s; focused26 scenario/23 capture/29 acceptance checks pass. Independent reviewer confirms allfive findings fixed; security auditor closes22/22 planned threats. The earlier11001-file bundle is retained locally; current dist/fidelity/phase01 is freshly assembled from corrected source with original runtime package identities unchanged.
@@ -0,0 +1,349 @@
# Phase 01: Reproducible Fidelity Baseline - Pattern Map
**Mapped:** 2026-11-12
**Files analyzed:** 22 candidate new/modified files (names below are planning recommendations)
**Analogs found:** 16 / 22, including partial matches; five primary source analogs
## Scope and naming
CONTEXT.md locks behavior, not new filenames. RESEARCH.md proposes recon orchestration/receipt validation, a static viewer, scenario/ledger documents, Windows scripts, Python/JavaScript tests and an optional application observer. The concrete names below make that scope assignable; the planner may consolidate modules. Existing reference capture behavior must keep its Wine identity. Optional runtime/package edits are conditional on a demonstrated observation/identity gap, not authorization to change gameplay.
No project-local `.codex/skills/` or `.agents/skills/` directory was found. Read local/parent AGENTS.md, the parent specification, context and research. All five primary source analog paths below were verified by nonempty `git ls-files -- <path>` output. The two documentary sources were also tracked. No runtime/install mirror is used.
## File Classification
| New/Modified File | Role | Data Flow | Closest Analog | Match Quality |
|---|---|---|---|---|
| `tools/recon/fidelity.py` | utility | file-I/O, batch | `tools/recon/reference_capture.py` | role-match |
| `tools/recon/fidelity_receipts.py` | model, utility | transform, file-I/O | `tools/recon/inventory.py` | partial: identity transform only |
| `tools/recon/fidelity_viewer/index.html` | component | event-driven | — | none |
| `tools/recon/fidelity_viewer/viewer.js` | component | event-driven | — | none |
| `tools/recon/fidelity_viewer/style.css` | config | transform | — | none |
| `docs/evidence/scenarios.json` | config | batch | — | none: new protocol |
| `docs/evidence/capabilities.json` | model | transform | `docs/checkpoint/coverage.md` | partial: domain content, no JSON schema |
| `docs/evidence/README.md` | config (documentation) | transform | `docs/checkpoint/coverage.md` | role-match |
| `scripts/prepare-fidelity-checkpoint.sh` | utility | batch, file-I/O | `scripts/package.sh` | role-match |
| `scripts/collect-fidelity-windows.ps1` | utility | event-driven, file-I/O | — | none: new native collector |
| `scripts/collect-fidelity-windows.cmd` | utility | request-response | `scripts/package.sh` | partial: generated launcher stub |
| `tests/test_fidelity_sessions.py` | test | file-I/O | `tests/test_extractors.py` | role-match |
| `tests/test_fidelity_receipts.py` | test | transform | `tests/test_extractors.py` | role-match |
| `tests/test_fidelity_ledger.py` | test | transform | `tests/test_extractors.py` | role-match |
| `tests/fidelity-viewer.test.mjs` | test | event-driven | — | none: no tracked JS test suite |
| `src/GamePort/Application/FidelityObservation.cs` (optional) | service | event-driven, file-I/O | `src/GamePort/Program.cs` | partial: observation seams only |
| `src/GamePort/Program.cs` (optional) | controller | event-driven | `src/GamePort/Program.cs` | exact: existing owner |
| `scripts/package.sh` (optional) | utility | batch, file-I/O | `scripts/package.sh` | exact: existing owner |
| `docs/progress.md` | config (documentation) | transform | `docs/compatibility.md` | role-match |
| `docs/tasks.md` | config (documentation) | transform | `docs/compatibility.md` | role-match |
| `docs/decisions.md` | config (documentation) | transform | `docs/compatibility.md` | role-match |
| `docs/compatibility.md` | config (documentation) | transform | `docs/compatibility.md` | exact: existing owner |
Generated `artifacts/` sessions, media, review indexes and `dist/` checkpoint bundles are outputs, not tracked source targets. `docs/original-manifest.json` is an input that must not be regenerated to accommodate changes.
## Pattern Assignments
### `tools/recon/fidelity.py` — capture/staging/import/review CLI
**Analog:** `tools/recon/reference_capture.py`.
**Imports** (lines 8–16):
```python
import argparse
import ctypes
import hashlib
import json
import os
from pathlib import Path
import shutil
import subprocess
import time
```
Copy only needed stdlib imports; a passive collector does not need the legacy X11 injection helper.
**Path guard** (lines 150–157):
```python
project = Path(__file__).resolve().parents[2]
source = project.parent/'Original'
default_output = 'artifacts/windows-smoke' if args.port_smoke else 'artifacts/asset-probe' if args.asset_probe else 'artifacts/reference'
work = (args.output or project/default_output).resolve()
if work.is_relative_to(source.resolve()) or source.resolve().is_relative_to(work):
p.error('Output must be separate from originals')
work.mkdir(parents=True, exist_ok=True)
if not args.port_smoke and not (work/'game').exists(): shutil.copytree(source, work/'game')
```
Reuse the resolved two-direction overlap rejection. Replace the legacy reuse semantics in new sessions: a session directory must be new, and copy identity must be verified before execution. Add imported relative-path containment, symlink/alias checks and original pre/post verification. Do not simply copy `exist_ok=True` into the new session allocator.
**Bounded subprocess/error pattern** (lines 206–207):
```python
print('Running isolated Windows port' if args.port_smoke else 'Running copied original', 'with no network and no original-directory mount:', work, flush=True)
subprocess.run(cmd, check=True, timeout=args.seconds + 40)
```
Use argument arrays and bounded timeouts. New orchestration must retain failure/abort receipts when launch/probe/import fails; the old top-level exception behavior alone does not supply that contract. Never execute commands read from a receipt.
**Evidence classification** (lines 213–216):
```python
if result['captures'][-1]['wineExit'] != 0 or not evidence_ok:
raise SystemExit('Windows port smoke did not pass; inspect wine.log (native Windows remains unverified)')
print('Windows port audio lifecycle passed under Wine; native Windows validation is still required' if args.port_cutscene_audio
else 'Windows port rendered under Wine; native Windows validation is still required')
```
Preserve the explicit platform qualifier. The harness takes three timed stills (90–106) and installs null audio (159–160); it is not an audiovisual/native/DxWnd capture template. Keep that path separate or unchanged.
### `tools/recon/fidelity_receipts.py` — identities and validation
**Partial analog:** `tools/recon/inventory.py`; no existing complete receipt/ledger schema was found.
**Imports and stable identity** (lines 3–13):
```python
import argparse
import hashlib
import json
from pathlib import Path
def inventory(root):
return [{"path": p.relative_to(root).as_posix(), "size": p.stat().st_size,
"sha256": hashlib.sha256(p.read_bytes()).hexdigest(),
"header": p.read_bytes()[:16].hex()}
for p in sorted(root.rglob("*")) if p.is_file()]
```
Reuse deterministic relative POSIX paths and SHA-256 meaning. Stream large media hashes rather than copying this small-original-file `read_bytes()` approach. Keep session/schema/case/platform/package/resource/artifact/marker validation in a small explicit module; these types are new tooling contracts, not recovered game enums.
**Fail-closed preservation** (lines 21–26):
```python
files = inventory(args.root)
if args.verify:
previous = json.loads(args.verify.read_text())["files"]
if files != previous:
raise SystemExit("Original inventory differs from recorded baseline")
print(f"Verified {len(files)} unchanged original files")
```
Keep the mandated command `python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json`. Validate pristine staged-copy identity separately; post-run writes in that copy are observations, not permission to change the original manifest. Reject incomplete media/audio, nonfinite/out-of-range marker times, mismatched identities and false native classifications; metadata success alone does not establish visual/audible parity.
### `scripts/prepare-fidelity-checkpoint.sh` and optional `scripts/package.sh`
**Analog:** `scripts/package.sh`.
**Entrypoint and offline layout** (lines 1–9):
```bash
#!/usr/bin/env bash
set -euo pipefail
source "$(dirname "$0")/env.sh"
scripts/build-linux.sh
scripts/build-windows.sh
python3 tools/extractors/prepare.py --all-scenes --audio sounds musicsecretlab
for rid in linux-x64 win-x64; do
out="dist/$rid"
mkdir -p "$out/assets" "$out/scenes/level1b" "$out/scenes/VR01" "$out/scenes/animations" "$out/scenes/actors" "$out/scenes/ui" "$out/audio/sounds" "$out/licenses" "$out/docs"
```
Reuse local SDK/build/resource entry points and quoted portable paths; checkpoint preparation should consume an identified completed package rather than silently rebuild a different one on import. The reference installation and capture tools stay separate from the port resources.
**Current provenance** (lines 48–52):
```bash
{
printf 'source_commit=%s\n' "$(git rev-parse HEAD)"
printf 'source_dirty=%s\n' "$(if [[ -n "$(git status --porcelain)" ]]; then echo yes; else echo no; fi)"
printf 'packaged_utc=%s\n' "$(date -u +%FT%TZ)"
} > "$out/BUILD-INFO.txt"
```
Retain these fields and bind completed executable/resource/package bytes in a separate manifest/receipt. A later documentation HEAD is not the older package's build identity. Avoid self-referential hashing: define manifest membership before hashing. Preparation produces one complete local bundle and transfer instructions before the combined human session; it does not close Windows acceptance.
### `scripts/collect-fidelity-windows.cmd` and `.ps1`
**Partial analog for `.cmd` only:** `scripts/package.sh` lines 144–145 contain generated launcher content:
```bat
@echo off
"%~dp0GamePort.exe" --assets "%~dp0assets" --scene "%~dp0scenes\level1b\scene.json" --level gam/level1b.gam --walk %*
```
Reuse script-relative quoted port paths. This stub does not collect hashes, OBS/DxWnd versions/settings, GPU/driver data, media or structured results. No tracked `.ps1` or standalone `.cmd` analog was returned by `git ls-files`. The new PowerShell collector requires a new bounded design from RESEARCH.md: preflight, generated-copy separation, explicit local tool selection, external recording checklist, separate original-DxWnd/native-port receipts, postflight and abort paths. Do not invent a working DxWnd profile or claim this stub proves Windows collection.
### Python test files
**Applies to:** `tests/test_fidelity_sessions.py`, `tests/test_fidelity_receipts.py`, `tests/test_fidelity_ledger.py`.
**Analog:** `tests/test_extractors.py`.
**Imports/root convention** (lines 1–12):
```python
import json
from pathlib import Path
import struct
import sys
import tempfile
import unittest
import zlib
ROOT = Path(__file__).resolve().parents[1]
ORIGINAL = ROOT.parent / 'Original'
sys.path.insert(0, str(ROOT / 'tools' / 'extractors'))
from omt import Database, FormatError, Reader, export_scene, read_canvas, read_material, read_shape, unpack_row, validate_output, write_png
```
Use only required imports and adapt the import directory to `tools/recon`; do not pull extractor modules into receipt tests.
**Small failing inputs** (lines 17–20):
```python
class BoundedReaders(unittest.TestCase):
def test_read_bounds_and_negative_size(self):
for size in (-1, 2):
with self.assertRaises(FormatError): Reader(b'x').take(size)
```
**Temporary output and real assertion** (lines 46–52):
```python
def test_png_roundtrip_payload(self):
rgba = bytes((4,5,6,255,10,20,30,0))
with tempfile.TemporaryDirectory() as t:
path = Path(t)/'test.png'
write_png(path, 2, 1, rgba)
data = path.read_bytes()
self.assertEqual(data[:8], b'\x89PNG\r\n\x1a\n')
```
Use temporary tiny original/copy/package/media trees for overlap, reuse, symlink escape, changed/missing/added file, bad marker, evidence classification and stale applicability failures. Keep synthetic media labeled and outside real receipt indexes. Unlike original-resource integration tests, quick negative tests should run without a local game installation/GPU. Proposed discovery remains `python3 -m unittest discover -s tests -p 'test_fidelity_*.py' -v`; measure bounded runtime. `tests/fidelity-viewer.test.mjs` has no same-language analog; use the research's built-in Node test approach for independent playback/audio state behavior.
### Optional `FidelityObservation.cs` and `Program.cs`
**Analog/integration owner:** `src/GamePort/Program.cs`. This is an application-boundary match, not an existing recorder API.
**Imports** (lines 1–8):
```csharp
using System.Diagnostics;
using System.Numerics;
using GamePort.Assets;
using GamePort.Application;
using GamePort.Audio;
using GamePort.Game;
using GamePort.Platform;
using GamePort.Rendering.Vulkan;
```
**Session lifetime** (lines 18–30):
```csharp
using var presentation = new RenderSession();
OriginalSave? carriedSave = null;
PlayerLevelState? carriedPlayer = null;
var returning = false;
var diagnostics = new DebugDiagnostics { Enabled = args.Contains("--debug-overlay") };
var energy = new PlayerEnergy();
var grapplerMemory = new GrapplerMemory();
while (true)
{
var result = Run(args, carriedSave, carriedPlayer, returning, diagnostics, presentation, energy, grapplerMemory, out var continuation);
if (result != 0 || continuation == null) return result;
args = continuation.Args; carriedSave = continuation.Save; returning = continuation.Returning;
carriedPlayer = continuation.Player;
```
A continuous-route observation owner belongs across this outer loop. Creating an unrelated new session for each `Run` would lose the retained departure/return relationship.
**Clock/event anchors:** line 819 starts `var clock = Stopwatch.StartNew();`; line 826 creates `var stepClock = new FixedStepClock();`; line 1133 polls `while (!headless && Sdl.SDL_PollEvent(out var e))`. Record monotonic elapsed time separately from simulation ticks; raw polled events and accepted gameplay input are different observations. Focus/debug/menu filtering occurs afterward, so polling alone is not an accepted-input trace.
**Retained transition publication** (lines 1866–1869):
```csharp
continuation = new(nextArgs.ToArray(), (debugCheckpointToLoad ?? interactions!.Snapshot()) with {
StartPoint = transitionRequest.StartPoint, StoredVector = debugCheckpointToLoad?.StoredVector ?? returnRoot }, transitionRequest.Returning,
debugCheckpointToLoad == null ? simulation?.CaptureLevelState(interactions!.Inventory.SelectedGadget) : null);
Console.WriteLine($"Loading original destination: {transitionRequest.LevelFile}, start={transitionRequest.StartPoint}; fade behavior remains unreconstructed.");
```
Observe at actual transition/input owners without changing these payloads or update order. TSK retained first-story order, fresh direct-scene order, landing bank, actor admission and lab/outside compatibility remain protected. Add the helper only if existing logs and external recording cannot supply required evidence. Preserve smoke-fixture classification; injected fixtures cannot replace ordinary full-route input.
**Existing application error boundary** (line 33):
```csharp
catch (Exception error) { Console.Error.WriteLine(error); return 1; }
```
A new optional observer needs explicit output ownership/disposal and bounded buffering. Do not add asynchronous gameplay ownership or a hidden retry/reset to achieve capture success.
### Ledger/protocol/viewer and durable reports
**Applies to:** `docs/evidence/scenarios.json`, `docs/evidence/capabilities.json`, `docs/evidence/README.md`, the three viewer sources, and `docs/progress.md`, `docs/tasks.md`, `docs/decisions.md`, `docs/compatibility.md`.
**Documentary analog:** tracked `docs/checkpoint/coverage.md` lines 63–66:
```markdown
**S**=static/data recovery, **P**=isolated original component probe,
**M**=managed port regression, **R**=port runtime. No row has full original-game
runtime comparison. Coverage does not mean implementation completeness.
```
Its table header at line 100 is `| ID / system | Recovered contract / anchors | Port implementation | Evidence / remaining gap | Next bounded action |`. Reuse the separation of source contract, implementation, actual evidence and remaining action. JSON schemas are new; keep requirement IDs, scope/platform/content identities, current applicability, discrepancies, acceptance and explicit supersession in one authoritative ledger, then render the Markdown/viewer. Historical dates alone cannot select valid current receipts.
**Status-report pattern:** tracked `docs/compatibility.md` lines 5–10:
```markdown
The user has a local Windows PC for combined reference/port checkpoint sessions.
Original-game reference execution is planned through DxWnd on a generated copy;
record Windows, DxWnd version/settings and capture limitations. Native Windows
port results remain distinct. This is setup availability and a discussion decision,
not a new launch, capture, original-comparison or native Windows verification
receipt. Existing verification claims and open acceptance dependencies remain.
```
Apply this evidence precision to all four durable status files. State what actually ran, on which revision/platform, and what remains open; do not copy old success totals into a new checkpoint.
There is no tracked HTML/CSS/JS viewer analog. Use RESEARCH.md's native media design: unobstructed paired playback, separately observed event seeks, rate 1, visible scenario/playback drift, exclusive audio, explicit buffering/decode/missing-media/asymmetric-end states, optional overlays and visible review gain. Use text rendering for imported labels. If a server is necessary, expose only the generated review tree on loopback with validated containment and tested seeking; never serve originals/the repository as the viewer root. The protocol must encode fresh/retained × natural/skipped × ordinary/edge and full-route/focused distinctions.
## Shared Patterns
### Filesystem boundary replaces authentication concerns
There is no account/authentication flow in this phase. Apply the `reference_capture.py:150–155` path guard to staging/import/review generation, then strengthen it for unique sessions and symlink-safe relative references. No hosted service or write API is required.
### Identity and failure remain separate from acceptance
Apply `inventory.py:21–26` fail-closed comparison to original preservation and `package.sh:48–52` build identity to packaging. Add actual byte hashes and typed evidence classifications; exit zero, valid JSON, a compiled binary, a prepared bundle and synthetic media cannot independently close original/native acceptance. Retain error receipts and diagnostic artifacts.
### Local outputs and bounded tools
Reuse `reference_capture.py` argument arrays, explicit cwd/log outputs and timeouts, and `test_extractors.py` temporary-fixture structure. Keep packages/media/generated review indexes local and ignored. No npm/PyPI additions or cloud storage are implied. Preserve the unrelated untracked `tools.yaml`.
### Movement and execution gates
All capture work observes the existing runtime. No movement reset, retiming, body admission, solver replacement or original-in-place execution is part of this map. Real Windows original-DxWnd and native-port results remain a combined human checkpoint after independent preparation is complete. If unavailable/failed, receipts retain open acceptance while independent source-backed work can continue.
## No Analog Found
| File | Role | Data Flow | Reason / fallback |
|---|---|---|---|
| `tools/recon/fidelity_viewer/index.html` | component | event-driven | No tracked web UI; use research's native media layout and actual local playback review |
| `tools/recon/fidelity_viewer/viewer.js` | component | event-driven | No paired player/state machine; implement/test explicit timing and audio rules |
| `tools/recon/fidelity_viewer/style.css` | config | transform | No established viewer stylesheet/design system |
| `docs/evidence/scenarios.json` | config | batch | New baseline protocol and required case matrix |
| `scripts/collect-fidelity-windows.ps1` | utility | event-driven, file-I/O | No native Windows preflight/collector; package launch stub is insufficient |
| `tests/fidelity-viewer.test.mjs` | test | event-driven | No tracked JavaScript testing pattern; use Node built-ins per research |
`fidelity_receipts.py` and `capabilities.json` also have no exact schema analog; their partial matches only cover identity and evidence vocabulary. `.cmd` has only the partial generated stub above. None of these gaps should be presented to the planner as an existing API.
## Metadata
**Analog search scope:** tracked `tools/recon`, `scripts`, `tests`, `src/GamePort/Program.cs`, checkpoint coverage and compatibility reports; repository-wide tracked `*.html`, `*.js`, `*.mjs`, `*.css`, `*.ps1`, `*.cmd` search returned no paths.
**Primary source analogs:** five: inventory, reference capture, package assembly, extractor tests, Program application boundary. Documentary inputs: coverage and compatibility.
**Coverage:** 3 exact-owner matches, 9 role matches, 4 partial matches, 6 without an analog (16 / 22 with some match).
**Pattern extraction date:** 2026-11-12.
**Validation:** tracked paths and line anchors inspected read-only; no runtime tests, original execution, build, package, commit or push performed. PATTERNS.md is the only write.
@@ -0,0 +1,35 @@
# Phase 01 — Plan Verification Receipt
**Date:** 2026-11-12
**Result:** VERIFICATION PASSED after one revision cycle; zero remaining blockers/warnings.
Independent initial checker reviewed seven plans, 15 tasks and five waves. All four
requirements and 16 context decisions are covered; dependencies are acyclic and
same-wave file ownership is disjoint. Deterministic verify-command path and stated
failure-direction probes each examined 24 commands with zero findings. New paths
are declared future artifacts, not implementation already present.
## Findings resolved
1. Research resolution blocker: five research questions now carry concrete RESOLVED
planning policies and task references. Unknown Windows/DxWnd/capture/browser
outcomes remain explicit execution acceptance dependencies.
2. Scope warning for plan 01-07: a scope_budget block bounds ten files to two
substantive implementation/test files and serial final evidence/report/runner
projections. The 30,000-token estimate is below the 100,000-token plan budget;
confidence remains low because this roadmap has no calibration samples.
A separate independent checker rechecked both changes and returned VERIFICATION
PASSED with zero blockers/warnings. No requirement or human acceptance was waived.
## Final deterministic gates
- Requirement coverage: EVID-01 through EVID-04, 4/4.
- Context decision coverage: D-01 through D-16, 16/16.
- Post-planning gap analysis: 20/20 combined items; zero uncovered.
- Seven plan structure/frontmatter validations passed during planning.
- Original inventory: 539 unchanged files verified by the prescribed command.
Planning and original inventory checks only: new implementation/test fixtures,
original/DxWnd captures and native Linux/Windows acceptance were not executed.
They remain in the execution plans; prepared materials cannot establish parity.
@@ -0,0 +1,461 @@
# Phase 01: Reproducible Fidelity Baseline - Research
**Researched:** 2026-11-12
**Domain:** Local original/port capture, evidence provenance, comparison playback and native-platform receipts
**Confidence:** HIGH for repository findings; MEDIUM for external capture approach; Windows execution remains unverified.
<user_constraints>
## User Constraints (from CONTEXT.md)
The following decisions and discretion are copied verbatim. [VERIFIED: 01-CONTEXT.md, Implementation Decisions]
<!-- DATA_71ac69ef_START -->
## Implementation Decisions
### Baseline journeys
- **D-01:** Capture the continuous lab → VR04 → lab → outside journey and focused replays of specific moments, including dialogue return, banked jumps and landing.
- **D-02:** Natural and skipped dialogue are equally required baseline cases.
- **D-03:** Fresh entry and retained departure/return receive separate, equally required runs that preserve their respective lifetimes.
- **D-04:** Include ordinary play and deliberate edge cases: held input through dialogue/return, banked jumps, landing and idle.
### Comparison review
- **D-05:** Open scenario results with paired original/port playback and links to corresponding images, audio and input/event traces.
- **D-06:** Keep captures unobstructed by default; annotations and image differences are optional overlays.
- **D-07:** Align key events while preserving actual recording speed and elapsed time; expose timing drift rather than concealing it through retiming.
- **D-08:** Switch between original and port audio at corresponding moments, playing one recording at a time. Clearly label any review-only volume adjustment.
### Evidence navigation
- **D-09:** Browse the full-game ledger by gameplay capability (movement, contacts, gadgets, progression, visuals, audio), with links to scenarios, source evidence and platform receipts. Retain requirement traceability.
- **D-10:** Each capability leads with what works, where it was verified, known differences and remaining acceptance conditions.
- **D-11:** Show current applicable evidence first; retain expandable history with exact revisions and clear superseded labels.
- **D-12:** Order discrepancies by player impact: blocking or visibly disruptive failures first, then subtler differences and missing verification. Missing evidence still leaves its acceptance open regardless of display order.
### Original and Windows access
- **D-13:** The user has a local Windows PC available to run prepared packages and return results. Availability does not itself establish successful native execution.
- **D-14:** Prepare one local test bundle per checkpoint. A launcher collects source/package/resource identities, logs and captures, with clear user steps and local transfer instructions. Packages and captures remain local.
- **D-15:** Run a separate generated copy of the original on that Windows PC through **DxWnd**. Record DxWnd version/configuration and execution/rendering limitations with each capture. Preserve wrapper provenance separately from native Windows port receipts; do not silently treat wrapper behavior as historical-platform parity.
- **D-16:** Prepare all materials before one combined hands-on session per checkpoint, covering original-reference captures and port checks and collecting results together.
### Carried-forward constraints
- Preserve every original byte and never execute originals in place; verify against `docs/original-manifest.json`.
- Preserve the implemented TSK-backed first-story input-order correction, fresh direct-scene order and legitimate landing bank. No invented leveling reset or replacement movement tuning.
- Keep source recovery, inference, copied-original component execution, port runtime, Wine, DxWnd reference execution, cross-publish and native platform receipts explicitly distinguished.
- Current Windows and original-reference acceptance remain open until new identified receipts demonstrate the required scenarios. A prepared bundle, wrapper launch or historical result alone cannot close them.
- All builds/tests/captures/packages stay local. Push only verified source/tools/docs to the existing Gitea remote. Preserve current actor/collision admission gates and the lab/outside compatibility solver.
### Agent discretion
No product decisions were explicitly delegated. Research/planning selects file formats,
local viewer technology, capture tooling, event markers and bundle mechanics within
the decisions above. The discussion does not require an external hosted website.
## Deferred Ideas
None — discussion stayed within phase scope. Native execution and capture are
future execution tasks, not results established by this discussion.
<!-- DATA_71ac69ef_END -->
</user_constraints>
## Summary
Build an evidence workflow around the established runtime. Extend preservation/capture orchestration, add identified scenario receipts and a capability ledger, and generate a local paired-media viewer. First prove one actual focused original/port comparison; then complete the full route and required case matrix. These are implementation recommendations within the explicit file-format/viewer/bundle discretion above.
The present reference harness captures three timed screenshots in isolated Wine, redirects ALSA to null and reuses an existing generated game directory. Its result is neither a continuous audible recording nor Windows/DxWnd execution. [VERIFIED: tools/recon/reference_capture.py:88-106,149-160] The package script records source revision, dirty state and package time, but those three fields are the scope of its identity block; extend them with hashes of executables, resources and captured artifacts. [VERIFIED: scripts/package.sh:48-52] Current reports explicitly keep original-game and native Windows verification open. [VERIFIED: docs/compatibility.md:3-24]
**Primary recommendation:** Use Python standard-library orchestration/validation, plain HTML/JavaScript playback, existing .NET/SDL replay hooks, a prepared local Windows launcher and an OBS recording preflight for the generated original through DxWnd and the native port separately. Do not change movement, collision admission or gameplay to make a capture pass.
## Architectural Responsibility Map
The following is the recommended ownership boundary, not a claim about already implemented capture features.
| Capability | Primary Tier | Secondary Tier | Rationale |
|---|---|---|---|
| Preserve originals and stage execution copies | Local tooling/filesystem | Windows launcher | Verify before copying; never use the source installation as working directory |
| Port input/event observations | Application/platform boundary | Local receipt collector | Observe accepted input and scene/control changes at their actual owners |
| Original reference video/audio | Windows recording tools | Human operator | Capture externally without pretending port instrumentation exists in the original |
| Event annotation and receipt validation | Local tooling | Human reviewer | Separate manually observed events from instrumented state |
| Paired playback and capability browsing | Browser/client | Read-only loopback file service if needed | No hosted application or database |
| Provenance and history | Versioned JSON/Markdown plus local hashed artifacts | Validator | Source metadata is reviewable; large media stays local |
## Project Constraints (from AGENTS.md)
Actionable directives from the local and parent instructions and authoritative specification: [VERIFIED: AGENTS.md; ../AGENTS.md; ../prompt.MD]
- Follow the parent instructions/specification; originals are authoritative, byte-identical, and never executed in place. Keep analysis, extraction, build and capture output separate.
- Use shared C#/.NET 10, Silk.NET.Vulkan/Vulkan 1.3+ and SDL3 for Linux/Windows x64; keep builds/tests/packages local and the runtime offline.
- Push only completed verified source/tools/docs to existing Gitea through the integrating primary; no original/package uploads, cloud CI or telemetry. This research assignment explicitly excludes committing/pushing.
- Keep recovered source/data, inference, implementation, compilation, component execution, port runtime, Wine, wrapper reference and native verification distinct.
- Preserve Jimmy movement, first-story TSK retained ordering, fresh direct-scene ordering and legitimate landing bank. Keep movement stabilization first; no new gadgets, movement replacement or invented angle reset.
- Preserve live collision/helper/actor admission gates and lab/outside compatibility solver; do not equate isolated recovered components with live gameplay.
- Use REA for any new original-binary investigation, preserve complete Evidence and cross-check bytes/addresses/provider gaps. This phase needs no new binary investigation.
- Use bounded endian-aware parsing, portable/case-insensitive original paths, clear modules, deterministic tests and explicit unmanaged ownership. Build frequently if runtime changes.
- Respect exclusive file ownership, at most three investigators alongside primary, primary integration, and unrelated working-tree files.
- Update progress, tasks, decisions and compatibility evidence before transitions. Read checkpoint coverage/implementation and current reports before gameplay/package work.
- Use local SDK environment and existing build/test/package entry points. Existing runtime claims require actual matching runtime evidence.
## Phase Requirements
<phase_requirements>
Descriptions below are verbatim from the requirements file. [VERIFIED: .planning/REQUIREMENTS.md, Reference and Fidelity Baseline]
| ID | Description | Research support |
|---|---|---|
| EVID-01 | Every original file remains byte-identical to the recorded inventory throughout recovery, testing and release preparation; generated copies and outputs remain separate. | Existing inventory; new bounded staging and pre/post identity guards |
| EVID-02 | Reviewers can reproduce identified original-game reference scenarios from an isolated generated installation, with input/event, visual and audio captures where applicable; unresolved execution limitations are recorded and leave comparison acceptance open. | Windows/DxWnd generated-copy procedure, external recording, event annotations, failure receipts |
| EVID-03 | Reviewers can identify each capability's source evidence, implementation revision, runtime platform, current discrepancy and acceptance condition in a maintained full-game coverage ledger. | Capability-led JSON/Markdown ledger, exact receipt references and explicit supersession |
| EVID-04 | Testers can repeat the baseline movement/route scenarios on native Linux and native Windows with revision-specific receipts; cross-publish, Wine, component execution and native gameplay remain separately labeled. | Shared scenario protocol, existing port hooks, separate native receipts and one combined Windows session |
</phase_requirements>
## Standard Stack
Do not add game or JavaScript packages for this phase. Existing package references are a constraint, not an instruction to upgrade dependencies.
| Layer | Use | Version / evidence |
|---|---|---|
| Runtime | Existing .NET and Vulkan implementation | Project declarations verbatim: `<TargetFramework>net10.0</TargetFramework>`, `<RuntimeIdentifiers>linux-x64;win-x64</RuntimeIdentifiers>`, `Include="Silk.NET.Vulkan" Version="2.23.0"`; KHR/EXT references also declare `Version="2.23.0"`. [VERIFIED: GamePort.csproj:4-17] |
| Evidence tooling | Python stdlib: pathlib, hashlib, json, argparse, subprocess, unittest | Python probe returned `Python 3.12.3`; inventory already uses these primitives. [VERIFIED: environment probe 2026-11-12; tools/recon/inventory.py:3-28] |
| Viewer | Plain HTML, CSS, JavaScript and native media elements | Media APIs expose time, rate, mute and playback; normal speed is 1.0. [CITED: https://html.spec.whatwg.org/multipage/media.html] |
| Recording | OBS Studio locally on Windows; installed version recorded at execution | Offline recording and MKV/remux workflow are documented; Windows Display Capture captures the monitor. [CITED: https://obsproject.com/kb/standard-recording-output-guide] [CITED: https://obsproject.com/kb/display-capture-sources] |
| Media inspection | Existing ffprobe/ffmpeg locally; no automatic download | Probe returned FFmpeg `6.1.1-3ubuntu5+esm15`; ffprobe provides machine-readable stream/format inspection. [VERIFIED: environment probe 2026-11-12] [CITED: https://ffmpeg.org/ffprobe.html] |
| Original wrapper | User's local DxWnd distribution/configuration, retained by hash and reported version | Official project describes a Windows window hooker; no compatible Neutron profile was established here. [CITED: https://sourceforge.net/projects/dxwnd/] |
| Native launcher | PowerShell/.cmd on Windows; shell/Python on Linux | Recommendation: keep launch steps transparent; do not require the Windows user to install Python/.NET SDK for a self-contained port package |
**Installation:** No npm/PyPI/NuGet additions proposed. Record actual Windows DxWnd/OBS/browser versions during preflight, rather than selecting a guessed latest version. Do not redistribute unreviewed third-party tools inside the checkpoint.
### Alternatives Considered
| Choice | Alternative | Decision |
|---|---|---|
| Plain local viewer | React/Electron application | Use plain media elements; component framework/desktop packaging adds no necessary capability here |
| External Windows recording | Custom DirectDraw hook/injected original recorder | Start externally; capture problems are observed limitations, not permission to modify original execution semantics |
| Read-only generated viewer tree | Database/API service | Use identified static records; no multi-user or remote persistence requirement |
| Manual focused original annotations | Original input injection/whole-route automation | Accept honestly labeled observed/manual markers initially; do not invent an original-side deterministic replay guarantee |
## Package Legitimacy Audit
Not applicable: no new ecosystem packages are recommended. Existing locked game dependencies remain unchanged. OBS/DxWnd/FFmpeg are external executables, so retain official provenance, actual versions and hashes during preparation rather than applying an npm existence check. This research neither installs nor runs them on Windows.
## Existing Analogs and Verified Integration Points
Existing symbols/options below are quoted verbatim beside source citations. Proposed filenames later are explicitly recommendations, not existing paths.
| Existing analog | Verified fact and planning implication |
|---|---|
| Inventory | `def inventory(root):` emits `"path"`, `"size"`, `"sha256"`, `"header"`; mismatch raises `"Original inventory differs from recorded baseline"`. Reuse the exact original manifest comparison; verify the copy before execution separately from legitimate post-run copy mutations. [VERIFIED: tools/recon/inventory.py:9-26] |
| Wine harness | `def inside(args):`, `def main():`; timed `for index in range(3):`, `time.sleep(args.seconds / 3)`; copy creation `shutil.copytree(source, work/'game')` only when absent. Preserve this narrow legacy path or separate Windows orchestration; do not relabel it. [VERIFIED: tools/recon/reference_capture.py:40-106,115-157] |
| Existing generated directories | `work.mkdir(parents=True, exist_ok=True)`, `(work/'home').mkdir(exist_ok=True)`, `default_output = 'artifacts/windows-smoke' if args.port_smoke else 'artifacts/asset-probe' if args.asset_probe else 'artifacts/reference'`. These are created/selected by the harness, not a proposed new capture schema. [VERIFIED: tools/recon/reference_capture.py:152-160] |
| Package assembly | `out="dist/$rid"`, `mkdir -p "$out/assets"` (same line creates scene/audio/license/docs subdirectories), and `> "$out/BUILD-INFO.txt"`. Its identity fields are `source_commit=%s`, `source_dirty=%s`, `packaged_utc=%s`. Hash a completed package tree and separate receipt; do not stamp a later docs HEAD onto an older DLL. [VERIFIED: scripts/package.sh:7-11,48-52] |
| Native CLI fixtures | `"--smoke-walk"`, `"--smoke-jetpack"`, `"--smoke-carl-cutscene"`, `"--smoke-control-phases"`, `"--smoke-practice-return"`. They are selected by explicit options; preserve their semantics and test identity. [VERIFIED: src/GamePort/Program.cs:263-283] |
| Idle regression | `LandWhileLocked` and `VerifyReturn` execute bounded synthetic setup/resumption checks; they are not a human full-route recording. [VERIFIED: src/GamePort/Application/CutsceneIdleSmoke.cs:9-30] |
| Window regression | `WindowTransitionSmoke` explicitly says `"not a gameplay replay"`; `Directory.CreateDirectory(output);` creates output. Use for resource/window lifetime, not route completion. [VERIFIED: src/GamePort/Application/WindowTransitionSmoke.cs:9-16] |
| Live observation seam | `var clock = Stopwatch.StartNew();`, `var stepClock = new FixedStepClock();`, `Sdl.SDL_PollEvent(out var e)`. Observe here and at transitions without altering update order. [VERIFIED: src/GamePort/Program.cs:819-826,1133-1148] |
| Scene continuation | `continuation = new(nextArgs.ToArray()` carries the snapshot/retained state; log scene transition identity with one session lifetime spanning scene loops. [VERIFIED: src/GamePort/Program.cs:1846-1869] |
| Local test integration | `python3 -m unittest discover -s tests -p 'test_*.py' -v`, managed projects and native/headless checks are composed in the existing script. [VERIFIED: scripts/test.sh:4-67] |
Repository source files were opened directly in this session. Paths above identify inspected files; quoted generated-path expressions identify their actual creating code.
## Architecture Patterns
### System Architecture Diagram
Recommended data flow:
```mermaid
flowchart TD
O[Immutable original installation] --> H[Preflight inventory verification]
H -->|match| C[Fresh generated Windows reference copy]
H -->|mismatch| F[Failure receipt; no execution]
C --> D[DxWnd plus external recording]
P[Identified offline port package] --> N[Native Linux or Windows play]
N --> R[Port events, logs and external recording]
D --> I[Local importer and artifact hash validation]
R --> I
I -->|valid and complete| E[Scenario receipts and capability ledger]
I -->|missing or failed| U[Explicit open acceptance and discrepancy]
E --> V[Paired local playback]
U --> V
V --> A[Human review with actual timing and one audio source]
```
### Recommended Project Structure
These are NEW proposed files; the executor must create them explicitly:
- Extend orchestration alongside the existing recon tools with a small capture-session/receipt validator module and command-line entry point.
- Add a dedicated viewer source directory under tools/recon, containing static HTML/CSS/JS; generated local media/index belong below ignored artifacts output.
- Add a versioned scenario protocol and capability-ledger JSON under docs/evidence, with a concise rendered Markdown entry point.
- Add Windows preparation/collection scripts under scripts and Python regression coverage under tests.
- Only add a focused application observation helper if required; keep runtime composition changes small and avoid growing the monolithic program with recorder policy.
These locations follow existing repository boundaries; all are proposed additions, not source-of-truth filesystem constants.
### Pattern 1: Immutable session plus append-only observations
Recommended receipt model (new schema, not recovered source enums):
- Versioned schema and stable scenario/session identity; case dimensions include dialogue policy, startup/entry lifetime, ordinary/edge input and route/focused scope.
- Exact source revision, dirty flag/diff identity if applicable, package tree/executable hashes, original manifest hash, resource tree hash, launcher version/hash.
- Platform OS/version, native versus Wine versus original-DxWnd classification; GPU/driver/Vulkan/SDL evidence for port; DxWnd binary/config hashes and actual settings for original.
- Actual invocation, working directory, preflight/postflight inventory result, start/end monotonic and wall-clock timestamps, exit/abort result.
- Per-artifact relative path, bytes, SHA-256, media duration/stream metadata and derivation chain. Keep raw recording and derived preview separately.
- Event markers carry media timestamp, event identity, observation method, uncertainty and supporting frame/log; port simulation tick is a separate optional field. Never fill an original internal-state field from a component fixture.
- Explicit missing artifacts, failure reason and remaining acceptance. An empty directory or exit-zero launcher cannot mean scenario pass.
Use a unique new directory per run and fail on accidental reuse. Check path containment before creating anything; resolve aliases/symlinks and reject overlap with originals in either direction. Verify original inventory before staging, verify pristine execution copy before running, and verify source originals after collection. Runtime writes in the generated copy are expected observations; preserve a pre-run identity manifest and post-run diff.
### Pattern 2: One baseline protocol, multiple evidence methods
Recommended minimum matrix is fresh-session versus retained-entry × natural versus skipped dialogue, with ordinary and edge-input coverage in every combination. Make these explicit cells, not four loosely named recordings. The continuous journey must preserve real lab departure/VR04 return/outside progression; focused replays may use identified setups but cannot substitute for that continuity.
Define procedural checkpoints around: startup/control; dialogue entry; natural or skip boundary; first neutral and held-input resumed moments; left/right banked jump; support/landing; sustained idle; practice entry; VR04 use; RETURN/cleanup; lab exit and outside arrival. Log scene names, ownership and media markers as actually observed. Do not invent numeric timing tolerances: report raw deltas and annotation uncertainty pending original observations.
Record ordinary player input in native port sessions; existing injected smoke fixtures remain separate replay receipts. For the original minimum, use the same written input procedure plus manually annotated video/event intervals with uncertainty and held/released descriptions. Do not claim exact original key sampling without a proven original-side observer. If exact key transition recording is needed, add a bounded local recorder as a distinct instrumented run; preserve a clean visual/audio baseline.
### Pattern 3: Two independent clocks, explicit alignment
Use native media elements at actual speed. Selecting an event pauses both sides and seeks each to its own observed event timestamp; resume at normal speed from there. Display both elapsed times and differences at later corresponding markers. Do not continuously seek the follower, alter playback rates or normalize run durations to manufacture agreement.
Separately show playback drift (browser rendering/buffering) and scenario event drift (actual recorded behavior). Buffering or missing media should pause the review and expose a warning; do not silently skip. Preserve asymmetric tails when one recording ends earlier. Mute both before changing audio selection; enable at most one. Keep any review gain visible and default to unadjusted audio. These are recommendations implementing D-05 through D-08; the underlying time/rate/mute interfaces are documented. [CITED: https://html.spec.whatwg.org/multipage/media.html]
Optional overlays must leave raw recordings available. Image differences require same viewport/aspect, crop metadata and matched event/frame provenance; numerical differences of lossy video are not a fidelity oracle. Use lossless identified stills for byte/difference assertions and label overlays as review aids.
### Pattern 4: Capability ledger with explicit applicability
Create one structured authoritative ledger, and render its navigation rather than maintaining two independent status sources. Capability entries should retain requirement IDs and contain current behavior, scope/scene, source contract links, implementation revision, identified runtime receipts per platform, discrepancies by player impact, acceptance condition, and explicit supersedes/reason links.
Seed all full-game requirement categories, including unimplemented/unverified capabilities; do not limit the ledger to Phase 1 or to current movement fixtures. Retain detail rows or links from the existing checkpoint ledger. Its own legend explicitly distinguishes static/probe/managed/runtime scopes: `**S**=static/data recovery, **P**=isolated original component probe,` and `**M**=managed port regression, **R**=port runtime.` [VERIFIED: docs/checkpoint/coverage.md:63-66]
Current applicable evidence is selected by revision/content/scope/platform, not latest date. A docs-only revision does not invalidate matching unchanged runtime evidence; changed executable/resources require new applicability review. Keep contradictory/old claims in expandable history with explicit supersession, rather than rewriting history as if the defect never existed.
## Minimum Viable Windows Recording and Bundle
Recommended executable sequence:
1. Prepare one checkpoint root with a complete Windows port package, pristine generated original installation, original and package manifests, scenario instructions, a local result directory, launcher/collector, expected artifacts checklist and offline viewer. Include local transfer instructions only; no upload endpoint.
2. Launcher preflight verifies bundled hashes and path separation, records OS/GPU/driver and tool identities, and asks the operator to select the actual DxWnd executable/profile and recording application. Reject missing dependencies with an actionable local receipt, without downloading tools automatically.
3. Perform a short original-DxWnd and port video/audio preflight before the full route, within the same combined hands-on session. Check visible moving game content, intelligible game audio, correct capture area/aspect and elapsed-time behavior. Keep a failed preflight and its limitations.
4. Start externally recorded sessions before game interaction. Use OBS Display Capture as the initial Windows method to avoid assuming old renderer hook compatibility; record only the intended monitor/game crop and retain raw frame/crop metadata. Use the applicable Linux OBS screen-capture source for Linux sessions. These source availability distinctions are documented. [CITED: https://obsproject.com/kb/display-capture-sources]
5. Record locally to MKV and retain it; remux a separate browser-compatible preview if the tested browser needs it. Keep derivation command/tool version and original timestamps. OBS documents MKV and remux; ffprobe documents format/stream inspection. [CITED: https://obsproject.com/kb/standard-recording-output-guide] [CITED: https://ffmpeg.org/ffprobe.html]
6. Run required continuous and focused cases in prescribed order, each with fresh/retained setup recorded. Preserve reference copy writes/settings per case. Native port output is collected separately from DxWnd wrapper output.
7. Collector hashes recordings/logs/settings, writes structured per-run results and copies local annotations; record skipped/aborted cases honestly. Return one complete local result bundle; importing validates it before linking it into the ledger/viewer.
8. Complete audible/visual review and inventory postflight, then update current receipts and open discrepancies. If original execution or native Windows fails, keep EVID-02/EVID-04 open and proceed only with independent permitted work.
DxWnd's project-maintainer logging procedure writes a log in the game execution folder. That makes a writable generated working directory essential; logging is not evidence the original behaved faithfully. [CITED: https://sourceforge.net/p/dxwnd/discussion/general/thread/6e4aa579/] Do not invent a working profile, forced renderer, speed limit or timer setting. Preserve the user's actual exported profile/config and identify any relocation edits. Rich diagnostic runs may perturb timing; label them separately.
## Don't Hand-Roll
| Problem | Don't build | Use instead | Reason |
|---|---|---|---|
| Original-game recording | New injected graphics/audio interception | External recording preflight and explicit limitations | Keeps Phase 1 bounded; original instrumentation has separate evidence costs |
| Media decode/playback | Custom browser decoder or time stretcher | Native video/audio elements | Standard time/rate/mute APIs exist. [CITED: https://html.spec.whatwg.org/multipage/media.html] |
| Stream discovery | File-extension inference | ffprobe JSON output | Stream/format metadata is inspectable. [CITED: https://ffmpeg.org/ffprobe.html] |
| Original integrity | New incompatible inventory format | Existing inventory helper and manifest | Complete list equality is already enforced. [VERIFIED: tools/recon/inventory.py:21-26] |
| Gameplay route | Scene swaps represented as completed route | Human continuous capture plus existing bounded regressions | Window fixture itself excludes gameplay replay. [VERIFIED: src/GamePort/Application/WindowTransitionSmoke.cs:9] |
| Evidence publication | Cloud dashboard/CI/database | Versioned metadata and local media | Required by locked local-only decisions |
## Common Pitfalls
| Failure | Prevention and verification |
|---|---|
| Wine stills become original reference video | Preserve execution category and require actual continuous audiovisual artifacts; harness uses three screenshots and null audio. [VERIFIED: tools/recon/reference_capture.py:90-106,159-160] |
| An old generated installation contaminates a fresh run | Unique staging directories, pre-run copy hashes and explicit retained lifetimes; current harness only copies when the game directory is absent. [VERIFIED: tools/recon/reference_capture.py:157] |
| Native and cross-publish results collapse into one Windows status | Validate receipt category, platform and scenario independently; current report explicitly excludes new Windows execution. [VERIFIED: docs/compatibility.md:18-24] |
| Identity says clean while captures came from other binaries | Hash actual executable/resources and compare imported receipts; build script's source fields alone do not bind individual captures. [VERIFIED: scripts/package.sh:48-52] |
| Old Carl narrative reopens an implemented defect | Apply later source-supported TSK correction; historical next-work prose is followed by explicit correction and open comparison boundaries. [VERIFIED: docs/checkpoint/next-work-plan.md:14-25] |
| Retained scenario restarts the process mid-route | Carry one session/continuation identity through actual transitions; record real source lifetime and don't replace RETURN with a direct scene fixture |
| Viewer hides timing differences | Fixed normal speed, explicit user-triggered event alignment, raw durations and visible drift |
| Silent/black recordings count as acceptance | Preflight checks actual changing game content and audible output; metadata presence alone cannot prove either |
| Synthetic media/tests enter real ledger | Require explicit synthetic designation and reject them as original/native acceptance; test fixtures may validate plumbing only |
## Code Examples
These are recommended new glue patterns, not existing repository APIs. No recovered game constants or schema enums are introduced.
### Preservation command already supported
```bash
python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json
```
The positional root and `"--verify"` are implemented by the inventory command; mismatch exits before the success message. [VERIFIED: tools/recon/inventory.py:17-26] This exact invocation is mandated by project instructions. [VERIFIED: AGENTS.md, original preservation directive]
### Paired audio selection and actual speed
```javascript
// Recommended viewer glue; media APIs: WHATWG HTML media elements.
function selectAudio(original, port, useOriginal) {
original.muted = true;
port.muted = true;
(useOriginal ? original : port).muted = false;
}
function alignAtObservedEvent(original, port, originalTime, portTime) {
original.pause();
port.pause();
original.currentTime = originalTime;
port.currentTime = portTime;
original.playbackRate = port.playbackRate = 1;
}
```
Time, rate and mute controls are documented APIs. [CITED: https://html.spec.whatwg.org/multipage/media.html] Production glue must validate finite in-range marker times, await media readiness/seeking, expose play rejection/buffering and retain manual controls. No periodic resync is permitted by the recommended design.
## Bounded Executable Slices
These are planning recommendations in dependency order. Each slice produces a usable part of the actual evidence workflow.
1. **Preserved session and receipt contract.** Stage a generated original copy, verify original/copy hashes, collect an identified existing native port focused run and implement receipt validation. Include failing/stale/incomplete result paths. Define the full scenario matrix now; do not invent successful original captures.
2. **Local paired comparison vertical slice.** Import one actual focused original-DxWnd/port pair when available and open it with media links, time markers, drift and exclusive audio selection. Until real original media arrives, labeled synthetic media exercises viewer plumbing only. Include a completed ready-to-run Windows preflight/bundle path so this is executable.
3. **Current full-game capability ledger.** Reconcile current reports and checkpoint rows into capability-first entries covering every requirement category; link the working scenario viewer, actual receipts, discrepancies and expandable historical revisions. Run metadata validation without a GPU.
4. **Full route capture and native Linux baseline.** Exercise continuous route and all required focused cases, including fresh/retained, natural/skipped and normal/edge inputs. Extend observation hooks only where needed without changing update order; repeat targeted protected movement/ownership checks if runtime composition changes.
5. **One Windows checkpoint and import/review.** Finalize all materials before a single combined human session collecting original-DxWnd and native port cases; validate results locally, inspect audiovisual behavior, update evidence and leave explicit failures open. The phase cannot be fully accepted through a prepared bundle alone.
Dependencies: receipt format before viewer/import and launcher; real capture import before acceptance; ledger population and viewer work can otherwise progress independently with exclusive files. Human session happens after all independent preparation, not as repeated requests after each small task.
## Environment Availability
Actual local probes on 2026-11-12; Windows availability is a user declaration, not a remote machine probe. [VERIFIED: environment probe this session] [VERIFIED: 01-CONTEXT.md, D-13 through D-16]
| Dependency | Available here | Version / result | Planner action |
|---|---|---|---|
| Python | Yes | 3.12.3 | Use stdlib tooling/tests |
| Node | Yes | 24.22.1 | Optional viewer pure-JS checks; do not add packages |
| Project SDK | Yes after sourcing environment | 10.0.402 | Existing .NET 10 project and tests |
| ffmpeg / ffprobe | Yes | ffmpeg 6.1.1 distribution build | Probe capabilities/version in receipt; do not silently assume codec availability |
| Chromium / Firefox | Commands found | Browser execution/version not tested here | Verify actual playback and media decoding |
| OBS / PowerShell | No command returned by command lookup here | Windows installation not inspected | Bundle dependency preflight; no execution guarantee |
| DxWnd on user's Windows | Not inspected | User's actual version/profile unknown | Hands-on preflight and record provenance |
| Native Windows port/Vulkan | Not executed this session | Current report keeps acceptance open | Human run required |
| Original installation | Verified read-only inventory | Output: `Verified 539 unchanged original files` | Repeat before/after execution/package checkpoint |
| Knowledge graph | Disabled | Status response reported disabled | Use direct source and current reports |
No runtime suites, new original-binary probes, packages or native Windows captures were run for this research. Missing Windows execution is an explicit acceptance dependency; it does not block preparation, ledger or independent source-backed later work under the roadmap exception.
## Validation Architecture
Validation is enabled in project configuration: `"nyquist_validation": true` and security `"security_enforcement": true`. [VERIFIED: .planning/config.json:23-25,49-51]
### Test Framework
| Property | Value |
|---|---|
| Existing tooling tests | Python stdlib unittest; existing tests import `unittest` and use temporary directories. [VERIFIED: tests/test_extractors.py:1-20] |
| Existing managed tests | Standalone .NET console projects called through the local script. [VERIFIED: scripts/test.sh:6-54] |
| New quick command, proposed | `python3 -m unittest discover -s tests -p 'test_fidelity_*.py' -v` |
| Pure viewer logic, proposed | `node --test tests/fidelity-viewer.test.mjs` using built-in assertions/test runner; executor creates this file, no npm dependency |
| Existing full suite | `scripts/test.sh`; native window option is `NEUTRON_WINDOW_TEST=1 scripts/test.sh`. [VERIFIED: docs/tasks.md:419-424] |
| Protected targeted checks | `source scripts/env.sh`, then relevant existing managed Director/Checkpoint/BodyOwnership/Movement projects from script; no suite claimed run here |
New quick-test filenames/commands are proposed Wave 0 additions, not present infrastructure. Keep their fixtures tiny so each quick command is bounded below 30 seconds; measure this rather than assuming the full original inventory or GPU suite meets that budget.
### Phase Requirements → Test Map
| Requirement | Behavior | Test type and command | Existing? |
|---|---|---|---|
| EVID-01 | Changed, missing and added original files fail; read-only staging leaves originals unchanged; copy identity verified before launch | Proposed Python fidelity tests; existing real inventory command above at checkpoint | Inventory yes; temporary-tree negative cases Wave 0 |
| EVID-02 | Valid run imports; bad hashes, missing media/audio, invalid/NaN/out-of-bounds markers, incomplete/failed launch remain open | Proposed Python fidelity tests; media-probe tests with bounded fixtures | Wave 0 |
| EVID-02 | Actual original game is visible/audible through identified DxWnd setup and required scenarios | Human Windows capture/review plus receipt importer | Explicit native/human dependency |
| EVID-03 | Every requirement links to capability; missing evidence never becomes passed; current history selection respects content/platform/scope; dead/unsafe links rejected | Proposed Python fidelity tests | Wave 0 |
| EVID-04 | Reused session, package/resource mismatch and Wine labeled native are rejected | Proposed Python fidelity tests | Wave 0 |
| EVID-04 | Port native Linux and native Windows traverse matched full/focused cases with current revision | Native play/replay, physical input/audio and review; existing smoke hooks supplement | Hooks exist; new route receipts required |
| D-05–D-08 | Event alignment, actual speed, timing drift, no mixed audio, asymmetric end/buffering/missing media | Proposed Node pure-logic tests plus local browser integration/manual media review | Wave 0 |
### Meaningful Negative Cases
- Source/output overlap in either direction; symlink escape; Windows drive/case/path traversal; reused session directory; filename containing shell metacharacters. Must fail before writing/launching.
- One-byte changed copy/package/media; absent DLL/resource; unsupported receipt schema; source revision without actual package identity; cross-publish/Wine/component run offered as native gameplay. Reject promotion, retain diagnostic record.
- Synthetic recording offered as original reference; null/missing audio offered as audible pass; zero-byte/black/frozen recordings. Metadata validator catches structural faults; humans check actual game visibility/audibility.
- Fresh/retained and natural/skipped cells missing despite total clip count; full route replaced by unrelated scene snapshots; interrupted run silently marked complete.
- Marker beyond duration, nonfinite time, absent corresponding event, different viewport or unknown media derivative; viewer must show missing state.
- Audio switch while both playing, play promise rejection, decode failure, one video buffering/ending, and raw difference overlay enabled by default. Fail visibly without rate adjustment.
### Sampling Rate
Per tooling commit run focused Python and viewer logic tests; per runtime observation change also run affected managed ownership/movement tests and a native focused replay. Per integrated checkpoint run the full existing local suite, original verification and identified native Linux route. Final Phase 1 acceptance additionally requires the combined Windows original/native session and actual media review. No automated fixture closes human acceptance.
### Wave 0 Gaps
Create the proposed schema/validator tests, a tiny explicitly synthetic audiovisual fixture with known timestamps, viewer state tests and a completed Windows result/import checklist. Keep synthetic fixtures separated from real receipt indexes. Reuse the existing unittest and .NET conventions; no framework installation required.
## Security Domain
This phase handles local binary/media paths and structured receipts, not accounts or remote application sessions. Recommended controls are narrowly scoped to that surface. OWASP's current published standard is ASVS 5.0.0; the inherited checklist's V2–V6 names refer to older numbering, so do not present them as current ASVS 5 chapter mappings. [CITED: https://asvs.owasp.org/]
| Control domain (legacy checklist label) | Applies | Standard control |
|---|---|---|
| Authentication (V2) | No accounts proposed | Keep service local and read-only; no new authentication system |
| Session management (V3) | No web login session | Capture session identity is provenance, not an auth session |
| Access control (V4) | Yes, filesystem boundary | Allowlisted checkpoint root, resolved path containment, no original directory serving or write APIs |
| Input validation (V5) | Yes | Bounded JSON, finite timestamps, relative-path validation, media/receipt sizes, safe HTML text rendering |
| Cryptography (V6) | Integrity only | stdlib SHA-256 for artifact identity; hashes establish correspondence, not trust in arbitrary executables |
| Threat | STRIDE | Mitigation |
|---|---|---|
| Traversal/symlink or imported absolute path | Disclosure/tampering | Resolve under allowed root, reject escapes and overlaps before execution/import |
| Shell metacharacters in paths/config | Tampering/elevation | Argument arrays, no eval/shell interpolation; never execute a command supplied by a receipt |
| HTML/script in labels or report text | Tampering | textContent/escaped output; no untrusted HTML injection or remote resource URLs |
| Hash-valid but wrong evidence classification | Spoofing/repudiation | Typed receipt validation and human scope review; do not auto-promote by exit code |
| Local server exposes repository/originals | Disclosure | Serve only generated review tree on loopback, reject symlink escapes; no uploads |
| Unbounded JSON/media metadata or capture duration | Denial of service | Limits and explicit abort/error receipts; stream hashes and probe with timeouts |
Python's standard handler follows symlinks outside the served directory, so merely choosing a directory is insufficient containment. [CITED: https://docs.python.org/3.12/library/http.server.html] Prefer a generated self-contained review tree or a bounded read-only handler. Test seeking behavior with the chosen server; do not assume all servers provide media byte ranges.
## State of the Art
| Existing/narrow approach | Phase 1 delivery | Evidence boundary |
|---|---|---|
| Wine still capture with null audio | Continuous identified DxWnd recording on Windows | Existing harness remains Wine evidence. [VERIFIED: tools/recon/reference_capture.py:90-106,159-160] |
| Build identity text | Hashed source/package/resource/session binding | Existing identity fields remain preserved. [VERIFIED: scripts/package.sh:48-52] |
| Chronological reports and bounded coverage rows | Capability-led current applicability with history | Existing legend already distinguishes S/P/M/R. [VERIFIED: docs/checkpoint/coverage.md:63-66] |
No dependency modernization or runtime architecture migration is proposed.
## Assumptions Log
| # | Claim | Section | Risk if wrong |
|---|---|---|---|
| A1 | [ASSUMED] Windows external recording can capture this DxWnd game with usable audio and acceptable timing overhead | Windows workflow | Must be tested in preflight; failed capture keeps acceptance open |
| A2 | [ASSUMED] A browser on each review machine can decode the selected preview format with usable seeking | Viewer | Test actual files/browser; retain raw recording and choose a verified derivative if necessary |
These are execution hypotheses, not locked compatibility claims. Do not gate independent implementation on a vague preference question; resolve through the prescribed preflight/native acceptance checkpoint before claiming success.
## Open Questions — RESOLVED planning dispositions
Each policy below is resolved for planning. Actual future capture/native outcomes remain
execution acceptance dependencies; RESOLVED does not claim a successful Windows run.
1. **RESOLVED — Actual DxWnd version/config and original launch behavior:** collect the user's actual executable/version/profile hashes and settings through plan 01-05 preflight, then record launch, visibility and audibility during plan 01-07's combined session. No guessed profile or compatibility guarantee is required to implement the collector. Failed/missing original execution keeps EVID-02 open.
2. **RESOLVED — Windows capture/audio/browser availability:** use a local dependency checklist and short recording/decode/audio preflight in the prepared combined session (plans 01-05/01-07). Record observed versions/devices and blockers; do not automatically download tools or silently substitute black/silent media. Unavailable dependencies remain explicit pending capture acceptance.
3. **RESOLVED — Original input precision:** use procedural inputs plus manually observed event markers, each labeled with method and uncertainty (plans 01-01/01-05/01-07). Port observations remain separately instrumented. No claim of exact original input sampling or deterministic original replay is made. Further instrumentation requires a concrete comparison need and the existing original-binary evidence rules.
4. **RESOLVED — Timing/image/audio tolerances:** preserve actual-speed raw captures, elapsed values and drift without a blanket numeric parity threshold (plans 01-02/01-07). Record discrepancies/uncertainty; later system owners derive any acceptance tolerances from authoritative evidence. Tool acceptance tests validate timing/audio controls, not unestablished whole-game parity.
5. **RESOLVED — Historical applicability:** bind claims to content/source/platform/scenario identity, preserve explicit supersession and reject ambiguous conflicting current evidence (plans 01-01/01-03/01-07). Report date/order alone never promotes historical packages to current proof. Missing underlying artifacts remain missing/historical rather than receiving fabricated identity.
## Sources
### Primary repository evidence (HIGH)
Directly opened this session: local/parent instructions and full specification; phase context/requirements/state/roadmap/config/project; current progress/compatibility/tasks/decisions; checkpoint next-work, coverage and implementation plan; main-menu player lifetime and Jimmy movement stabilization; REA report; codebase testing/conventions/structure; original manifest; inventory/reference tools; package/test/environment/window scripts; project declaration; Program and native fixtures. Inline citations give exact inspected anchors for implementation claims.
### Official external documentation (MEDIUM)
- https://sourceforge.net/projects/dxwnd/ — official wrapper project identity.
- https://sourceforge.net/p/dxwnd/discussion/general/thread/6e4aa579/ — project-maintainer logging procedure; historical guidance, not a tested current Neutron profile.
- https://obsproject.com/kb/standard-recording-output-guide — offline recording, MKV and remux (dated 2023-05-26).
- https://obsproject.com/kb/display-capture-sources — platform-specific display recording methods (dated 2022-01-11).
- https://html.spec.whatwg.org/multipage/media.html — native media time/rate/mute/playback; living standard checked 2026-11-12.
- https://ffmpeg.org/ffprobe.html — media format/stream inspection.
- https://docs.python.org/3.12/library/http.server.html — local serving and symlink caveat.
- https://asvs.owasp.org/ — current ASVS release identity.
## Metadata
- Standard stack confidence HIGH for existing repository/environment; MEDIUM for external recording workflow pending real-device verification.
- Architecture confidence HIGH for inspected integration boundaries; proposed workflow requires implementation and end-to-end verification.
- Pitfalls confidence HIGH where directly demonstrated in code; MEDIUM for browser/device capture risks.
- Research-plan seam selected websearch for three external questions; classify-confidence returned LOW without verification and MEDIUM with verified official-source cross-check. External claims therefore use CITED tags.
- Research-store persistence was attempted for all three digests but failed with `ENOENT: no such file or directory, mkdir '/home/cristian/.gsd/research-cache'`. No cache write claimed; research sources remain in this document. Do not change global home/config or unrelated repository files to repair a research cache.
- Project graph disabled; no graph relationships used. No project agent skills configured.
- Original verification run this session: `Verified 539 unchanged original files`. This is preservation evidence, not new gameplay execution.
- No native Windows, DxWnd, original gameplay, browser playback or new gameplay compatibility claimed. No commit/push performed by this agent per exclusive assignment.
- Research date 2026-11-12; revisit local evidence applicability whenever runtime/resources change; external recording guidance should be rechecked during Windows preflight.
@@ -0,0 +1,39 @@
---
phase: 01
review: 01-REVIEW.md
titles: json
findings:
- id: CR-01
severity: critical
disposition: fixed
title: "Human review is checked against a different file from the selected receipt"
- id: CR-02
severity: critical
disposition: fixed
title: "Original applicability never binds the executed executable or preservation inventories"
- id: CR-03
severity: critical
disposition: fixed
title: "Fresh-copy continuity accepts a hash that identifies no artifact"
- id: WR-01
severity: warning
disposition: fixed
title: "Checkpoint assembly bypasses the capability ledger projection"
- id: WR-02
severity: warning
disposition: fixed
title: "An interrupted Windows collector cannot be finalized through the documented recovery command"
open: 0
total: 5
recorded: 2026-11-13T21:58:50.502559+00:00
---
# Phase 01: Code Review Disposition
| Finding | Severity | Disposition | Source |
|---|---|---|---|
| CR-01 | critical | fixed | 01-REVIEW-VERIFY.md; independent re-review |
| CR-02 | critical | fixed | 01-REVIEW-VERIFY.md; independent re-review |
| CR-03 | critical | fixed | 01-REVIEW-VERIFY.md; independent re-review |
| WR-01 | warning | fixed | 01-REVIEW-VERIFY.md; independent re-review |
| WR-02 | warning | fixed | 01-REVIEW-VERIFY.md; independent re-review |
@@ -0,0 +1,75 @@
---
phase: 01-reproducible-fidelity-baseline
verified: 2026-11-13T22:19:18Z
review_path: .planning/phases/01-reproducible-fidelity-baseline/01-REVIEW.md
fix_report_path: .planning/phases/01-reproducible-fidelity-baseline/01-FIX-REPORT.md
verified_head: 02d182f35de643f9d68699b2fff1d219dd132edb
findings_verified: 5
fixed: 5
open: 0
findings:
critical: 0
warning: 0
info: 0
total: 0
status: clean
---
# Phase 01 review-fix verification
All five fixes are verified. The final CR-03 refinement requires actual backing artifacts for named copy-state identities and rejects the hash-only records that survived its first fix. No reviewed finding remains open.
| Finding | Disposition | Independent verification |
|---|---|---|
| CR-01 | FIXED | The selected path is retained and its own digest is compared with the human finding. The sibling-digest and absent-digest regressions leave human checks pending; the actual selected-file digest satisfies that boundary. |
| CR-02 | FIXED | Complete baseline records and their recomputed digest bind original pre/post/package/resources. The explicit executed `original_member` binds executable size/header/hash. Wrong executable/member and inconsistent inventories are rejected; independently identified writable `copy_post` changes remain allowed. |
| CR-03 | FIXED | Scenario validation now checks the actual named copy-pre artifact for both lifetimes and the retained snapshot for retained runs. Previous hash-only reproductions and an isolated retained-snapshot reproduction are rejected; valid named state files still qualify. |
| WR-01 | FIXED | Assembly exports the validated ledger projection; readiness compares current/history with the sealed projection. The preparation-to-bundled-renderer check preserves named current/superseded records. The standalone-transfer check needs no source Git checkout, and missing viewer history is rejected. |
| WR-02 | FIXED | A real Linux-hosted PowerShell finalizer reproduction recovered an incomplete-only synthetic run as aborted. Initial raw bytes and session identity survived, end clocks remained absent, captured promotion was rejected, and shared validation plus atomic import succeeded with acceptance false. |
## CR-03 refinement verified
**Original classification:** BLOCKER
**Current disposition:** FIXED by `02d182f35de643f9d68699b2fff1d219dd132edb`, with regression `48fca0d`.
**File:** `/home/cristian/codex/Neutron/GamePort/tools/recon/fidelity_receipts.py:667-678`
**Related:** `/home/cristian/codex/Neutron/GamePort/tools/recon/fidelity_receipts.py:383-385`
At `a821754`, `_scenario_observation()` compared continuity digests with named identity strings while the generic validator skipped dictionaries without `path`. The refinement now passes the receipt root to scenario validation and calls `_checked_artifact()` on the actual named state records before comparing digests. The scenario audit and Linux capture matrix both pass their artifact root; their direct test callers were updated as well.
The bounded reproduction below uses existing synthetic metadata fixtures and launches no game. It previously demonstrated the gap and now demonstrates rejection for both native lifetimes:
```python
from test_fidelity_scenarios import FidelityScenarios
import fidelity_receipts as receipts
fixture = FidelityScenarios()
fixture.setUp()
try:
for lifetime in ('fresh', 'retained'):
value, root = fixture.receipt(
lifetime + '-natural-ordinary', 'dialogue-return')
value['identity']['copy_pre'] = {'sha256': 'f' * 64}
value['continuity']['copy_pre_sha256'] = 'f' * 64
if lifetime == 'retained':
value['identity']['retained_copy'] = {'sha256': 'e' * 64}
value['continuity']['retained_copy_sha256'] = 'e' * 64
result = receipts.audit_scenarios(
fixture.protocol(), [(value, root)])
print(lifetime, result['accepted'], result['invalid'])
finally:
fixture.doCleanups()
```
Run from the repository with `PYTHONPATH=tests:tools/recon`. Earlier output at `a821754` was `fresh 1 []` and `retained 1 []`. Rerunning at `02d182f` gives zero accepted slots and `Reference must be a bounded relative POSIX path` in each invalid list. A third reproduction retaining valid copy-pre but supplying only a hash for `identity.retained_copy` is rejected independently. The unmodified fresh and retained metadata controls each still accept one slot.
**Additional verification:** Four selected scenario tests passed in **0.424 seconds**: backing-file rejection for both lifetimes, named continuity binding, unrelated retained-snapshot rejection, and complete positive coverage of all 120 metadata slots. The new backing-file test covers hash-only, missing-file and wrong-size state identities, including the retained snapshot. This closes the reported artifact-binding gap without changing the four other verified fixes.
## Verification evidence and limits
Read the historical review, fix report and actual source/test diffs for `5569bc2`, `bda35e5`, `6e5ee0b`, `548c97a`, `2608517`, and `a821754`, then the final `48fca0d` regression and `02d182f` refinement. Initially ran 11 selected Python tests in **2.109 seconds**, all passing: selected-file review binding; original executable/member and inventory rejection; mutable generated-copy allowance; complete positive metadata matrix; standalone readiness without Git; malformed viewer history; actual assembled model through its bundled renderer; named pre/retained continuity; and aborted missing-end-clock import. The additional hash-only identity gap discovered during that verification is closed by the independently repeated checks above.
Separately exercised the actual PowerShell recovery function with a disposable synthetic prepared checkpoint, rejected captured promotion, recovered raw media, compared both raw initial copies byte-for-byte, verified absent end clocks, validated and imported the resulting open aborted receipt. This was Linux-hosted tooling execution, not native Windows evidence.
No full suite, whole 11,001-file checkpoint readiness/hash walk, original execution or gameplay capture was repeated. The primary's current bundle identities and pending 0/120 human acceptance remain separate evidence; this verification does not promote them. Source and tests were read-only, no commit was made, and unrelated concurrent report edits were preserved.
Historical `01-REVIEW.md` is unchanged; its SHA-256 is `493c0b9b7b491f7dcc896d6cfda675ced837f56ee32daf2bbf1cd98f1527f74c`.
@@ -0,0 +1,137 @@
---
phase: 01-reproducible-fidelity-baseline
reviewed: 2026-11-13T21:56:48Z
depth: standard
files_reviewed: 44
files_reviewed_list:
- .codex/hooks.json
- docs/codex-quota-guard.md
- docs/compatibility.md
- docs/decisions.md
- docs/evidence/README.md
- docs/evidence/capabilities.json
- docs/evidence/checkpoint-session.md
- docs/evidence/linux-session.md
- docs/evidence/phase01-baseline.md
- docs/evidence/scenarios.json
- docs/evidence/windows-session.md
- docs/progress.md
- docs/tasks.md
- scripts/collect-fidelity-linux.sh
- scripts/collect-fidelity-windows.cmd
- scripts/collect-fidelity-windows.ps1
- scripts/prepare-fidelity-checkpoint.sh
- scripts/test.sh
- src/GamePort/Application/FidelityObservation.cs
- src/GamePort/Program.cs
- tests/GamePort.FidelityObservationTests/GamePort.FidelityObservationTests.csproj
- tests/GamePort.FidelityObservationTests/Program.cs
- tests/fidelity-viewer.test.mjs
- tests/fidelity-windows.Tests.ps1
- tests/test_codex_quota_guard.py
- tests/test_fidelity_acceptance.py
- tests/test_fidelity_capture.py
- tests/test_fidelity_checkpoint.py
- tests/test_fidelity_ledger.py
- tests/test_fidelity_observation.py
- tests/test_fidelity_review.py
- tests/test_fidelity_scenarios.py
- tests/test_fidelity_sessions.py
- tools/recon/fidelity.py
- tools/recon/fidelity_acceptance.py
- tools/recon/fidelity_capture.py
- tools/recon/fidelity_checkpoint.py
- tools/recon/fidelity_ledger.py
- tools/recon/fidelity_receipts.py
- tools/recon/fidelity_review.py
- tools/recon/fidelity_viewer/index.html
- tools/recon/fidelity_viewer/style.css
- tools/recon/fidelity_viewer/viewer.mjs
- tools/workflow/codex_quota_guard.py
findings:
critical: 3
warning: 2
info: 0
total: 5
necessity: 0
status: issues_found
---
# Phase 01: Code Review Report
**Reviewed:** 2026-11-13T21:56:48Z
**Depth:** standard
**Files Reviewed:** 44
**Status:** issues_found
## Summary
Three acceptance-integrity defects permit mismatched reviewed bytes, unrelated original executable bytes, or an unbound fresh-copy identity to contribute accepted obligations. The prepared capability viewer also omits current/history evidence, and the Windows finalizer cannot recover the interrupted-run state described by its instructions.
Scope is the canonical `/tmp/gameport-phase01-review-scope.json` file union at HEAD `215d01e43e103f3fbb7e26b43607cd09f2856492`. Resolver status is **degraded**, reason `no-task-commit-rows`, using its real phase range from `9aa49970e43bc9ca5470b884757e3481e0c0293a`. The union contains 44 files; all seven SUMMARY key-file lists are covered, and none of these paths is ignored. No structural pre-pass or external reviewer evidence was supplied. The necessity rubric was read; no necessity finding was established.
The pending 0/120 original/native obligations and ten human findings are expected acceptance dependencies, not implementation defects. Findings below concern enforceable identity/continuation contracts. Reproductions used disposable synthetic metadata only; the Windows recovery reproduction used Linux-hosted PowerShell, not native Windows. The existing complete-suite run was not repeated. No original was executed or modified, no source was edited, and no commit was made; unrelated `tools.yaml` was preserved.
## Narrative Findings (AI reviewer)
## Critical Issues
### CR-01: Human review is checked against a different file from the selected receipt
**Classification:** BLOCKER
**File:** `/home/cristian/codex/Neutron/GamePort/tools/recon/fidelity_acceptance.py:134-143`
**Issue:** `current.json` may select any contained receipt filename. The loop reads that path, discards it, then compares the human-review digest against `directory / 'receipt.json'`. A sibling `selected.json` can therefore supply the accepted record while the human finding binds unrelated `receipt.json` bytes. Raw result directories need not have an import sidecar, so `read_receipt` does not close this gap. This defeats the explicit receipt-byte review boundary; the same mismatch can affect every selected slot.
**Evidence:** A bounded synthetic reproduction selected `run/selected.json`, stored a different object at `run/receipt.json`, and supplied the latter's digest in `human-review.json`. The real `audit()` returned `matrix.accepted == 1`, `human_needed == []`, and `errors == []`, despite the selected digest differing from the reviewed digest. Only material readiness was mocked to isolate receipt selection; hash checking, parsing and matrix evaluation ran normally.
**Fix:** Carry the actual selected path/digest alongside each record and compare `receipt_sha256[receipt_id]` with that file. Alternatively, explicitly reject every selected basename other than `receipt.json` before reading it. Missing or different selected-file digests must invalidate the human finding. Add a regression with two different sibling JSON files and no sidecar.
### CR-02: Original applicability never binds the executed executable or preservation inventories
**Classification:** BLOCKER
**File:** `/home/cristian/codex/Neutron/GamePort/tools/recon/fidelity_acceptance.py:81-84`
**Issue:** The original-DxWnd branch checks only a `tree_sha256` string inside the receipt's `original_pre` JSON. It does not compare the actual identified executable against its selected pristine inventory member, validate original package/resource identities against that baseline, or check `original_post`. The generic validator checks each referenced file's own hash, which establishes identity but not applicability. Consequently, attaching a correct original-pre inventory to an unrelated executable is sufficient to pass `_bind`. This is weaker than the concrete executable/pre/post mapping promised in `docs/evidence/checkpoint-session.md:90-94`.
**Evidence:** Starting with the existing complete metadata fixture for an original-DxWnd slot, a synthetic diagnostic replaced only `identity.executable` with the actual size/hash of a new file containing `synthetic wrong original executable`. The expected original-pre record stayed unchanged. `audit_records()` still returned one accepted obligation and no errors. The receipt schema otherwise remained valid; no false artifact hash was required.
**Fix:** Pass the checkpoint's actual pristine file inventory into original binding, retain the exact selected original member path, and compare the receipt executable identity with that member. Validate package/resources and authoritative pre/post inventories against the same baseline; recompute inventory digests from their file records rather than trusting an embedded digest alone. Writable-copy changes must stay separately recorded. Add negative tests for a wrong executable and inconsistent pre/post inventory content.
### CR-03: Fresh-copy continuity accepts a hash that identifies no artifact
**Classification:** BLOCKER
**File:** `/home/cristian/codex/Neutron/GamePort/tools/recon/fidelity_receipts.py:659-669`
**Issue:** All cells require `copy_pre_sha256`, but fresh cells only check its 64-hex syntax. Actual identity membership is checked inside the retained-only branch. Thus a fresh observation can claim a nonexistent copy state and still fill an accepted slot, contrary to the fresh lifetime procedure's separately identified generated execution copy. The executable/package binding does not identify that per-run startup state.
**Evidence:** With `FidelityScenarios.receipt('fresh-natural-ordinary', 'dialogue-return', 'native_port', 'linux')`, replacing `continuity.copy_pre_sha256` with `'f' * 64` produces `audit_scenarios(...).accepted == 1` and `invalid == []`. No identity file has that digest. This reproduction is a synthetic metadata diagnostic, not gameplay evidence.
**Fix:** Require `copy_pre_sha256` to match the validated, explicitly named `identity.copy_pre` record for both lifetimes before branching. Bind retained-copy state to its explicitly named retained snapshot as well, rather than any unrelated identity hash. Add fresh-copy negative tests for an unknown digest and a digest belonging to the launcher/package instead of the per-run copy record.
## Warnings
### WR-01: Checkpoint assembly bypasses the capability ledger projection
**Classification:** WARNING
**File:** `/home/cristian/codex/Neutron/GamePort/tools/recon/fidelity_checkpoint.py:165-167`
**Related:** `/home/cristian/codex/Neutron/GamePort/tools/recon/fidelity_viewer/viewer.mjs:228-244`
**Issue:** Assembly passes authoritative `capabilities.json` directly to `export_review()`. That export validates/copies source links but does not call `export_ledger()`, so its rows retain `evidence` without derived `current` and `history`. The browser renders only `row.current` and `row.history`, displaying `Unrecorded` in both sections and concealing the revision/classification details prepared for the reviewer. The separate CLI ledger-to-viewer test exercises the correct projection, but checkpoint assembly does not use that route.
**Evidence:** In the actual sealed `dist/fidelity/phase01/review/review.json`, all 25 capability rows lack both fields. Applying `export_ledger()` to the authoritative input yields two current and two historical records for `startup-order`; none appears in those viewer sections in the prepared model. This is independent of missing original/native recordings.
**Fix:** Generate the validated ledger projection before checkpoint review export, then preserve its current/history fields through source-link copying. Make `ready()` reject a malformed viewer ledger rather than checking only source hrefs. Add a preparation-to-renderer regression asserting that named current and superseded records survive the actual checkpoint assembly path.
### WR-02: An interrupted Windows collector cannot be finalized through the documented recovery command
**Classification:** WARNING
**File:** `/home/cristian/codex/Neutron/GamePort/scripts/collect-fidelity-windows.ps1:332-336`
**Related:** `/home/cristian/codex/Neutron/GamePort/docs/evidence/windows-session.md:150-152`
**Issue:** Startup writes `incomplete.json` before launching, while `run.json` is written only in the final `finally` block. If the collector is terminated before that block completes, its durable result has only the incomplete record. The instructions explicitly tell the tester to recover that state with `Finish -Outcome aborted`, but `Complete-FidelityRun` unconditionally reads missing `run.json` first. The supplied recovery command therefore cannot retain the interrupted launch's media as a terminal receipt; asking for a fresh launch would misidentify its lifetime.
**Evidence:** A disposable synthetic prepared bundle with `results/interrupted/incomplete.json` and no `run.json` was passed to the real finalizer through Linux-hosted PowerShell. It failed immediately with `Cannot find path '.../results/interrupted/run.json' because it does not exist.` The failed lookup precedes annotation/media recovery. Existing terminal tests always create `run.json` and do not cover this durable interrupted state.
**Fix:** Add an explicit aborted-recovery path using the retained initial record when `run.json` is absent. Preserve its launch identity and raw bytes, prohibit captured/reviewed promotion, and leave unavailable end clocks/observations explicitly missing. Recover media into a new write-once diagnostic receipt without inventing elapsed times. Test an incomplete-only result folder and verify that it remains open and structurally importable.
---
_Reviewed: 2026-11-13T21:56:48Z_
_Reviewer: gsd-code-reviewer_
_Depth: standard_
@@ -0,0 +1,60 @@
---
phase: "01"
slug: reproducible-fidelity-baseline
status: verified
threats_open: 0
threats_total: 22
threats_closed: 22
asvs_level: 1
block_on: high
register_authored_at_plan_time: true
verified_head: 02d182f35de643f9d68699b2fff1d219dd132edb
created: "2026-11-13T22:21:09.119266+00:00"
---
# Phase 01 — Security
The typed security auditor verified all planned mitigation boundaries. The repeated reserved T-01-SC is counted once. All dispositions are mitigate; no accepted or transferred risks.
## Trust Boundaries
Originals → generated copies; local paths → file/process operations; media/receipts → review and acceptance; observer → gameplay; transferred checkpoint → immutable validation.
## Threat Register
| Threat ID | Category | Severity | Disposition | Mitigation evidence | Status |
|---|---|---|---|---|---|
| T-01-01 | Tampering | high | mitigate | fidelity_receipts.py:123,221,239,257 | closed |
| T-01-02 | Spoofing | high | mitigate | fidelity_receipts.py:275,667,672,714 | closed |
| T-01-03 | Tampering | high | mitigate | fidelity_receipts.py:198,212,482,500 | closed |
| T-01-04 | Information disclosure | high | mitigate | fidelity_review.py:202,211,219,274 | closed |
| T-01-05 | Tampering | high | mitigate | viewer.mjs:2,190; fidelity_review.py:238 | closed |
| T-01-06 | Spoofing | medium | mitigate | viewer.mjs:43,79,302,318,324 | closed |
| T-01-07 | Spoofing | high | mitigate | fidelity_ledger.py:97,197,203,285 | closed |
| T-01-08 | Repudiation | medium | mitigate | fidelity_ledger.py:69,220,299,320 | closed |
| T-01-09 | Tampering | medium | mitigate | fidelity_ledger.py:117,339,372 | closed |
| T-01-10 | Tampering | high | mitigate | FidelityObservation.cs:54,78,93,109; test_fidelity_observation.py:130 | closed |
| T-01-11 | Denial of service | medium | mitigate | FidelityObservation.cs:165,171,179,192,233 | closed |
| T-01-12 | Spoofing | high | mitigate | FidelityObservation.cs:47,109,130,166; Program.cs:18,1328 | closed |
| T-01-13 | Elevation of privilege | high | mitigate | collect-fidelity-windows.ps1:128,136,144,253,303 | closed |
| T-01-14 | Tampering | high | mitigate | fidelity_checkpoint.py:103,120,198,215,220 | closed |
| T-01-15 | Spoofing | high | mitigate | collect-fidelity-windows.ps1:176,208,234,285,332 | closed |
| T-01-16 | Tampering | high | mitigate | fidelity_capture.py:154,156,195,239,347 | closed |
| T-01-17 | Spoofing | high | mitigate | fidelity_capture.py:85,98,107,325,338 | closed |
| T-01-18 | Denial of service | medium | mitigate | fidelity_capture.py:30,128,148,202,220,224 | closed |
| T-01-19 | Spoofing | high | mitigate | fidelity_acceptance.py:124; fidelity_receipts.py:275,667,672,714; fidelity_capture.py:390 | closed |
| T-01-20 | Tampering | high | mitigate | fidelity_receipts.py:453,482,488,494,500 | closed |
| T-01-21 | Repudiation | medium | mitigate | fidelity_acceptance.py:127,130,160,184; fidelity_ledger.py:328 | closed |
| T-01-SC | Tampering | high | mitigate | fidelity_checkpoint.py:301; collect-fidelity-windows.ps1:253; observer csproj:1 | closed |
## Accepted Risks Log
No accepted risks.
## Security Audit Trail
Initial source audit identified 20/22 closed and T-01-02/T-01-19 open because hash-only copy identities bypassed file checks. Regression48fca0d reproduced it; fix02d182f validates actual named artifacts at the scenario boundary. Independent auditor reinspection closes both. Code re-review confirms all five findings fixed; see01-REVIEW-VERIFY.md. All191 affected fidelity regressions pass in43.355s.
## Sign-Off
All22 planned threats have implemented, verified mitigations; threats_open=0. This tooling verdict does not approve original/native gameplay, physical input, audio or human findings; runtime acceptance remains0/120 OPEN.
@@ -0,0 +1,88 @@
# Phase 01 source audit
Planned 2026-11-12. COVERED means executable tasks exist, not that original/native acceptance has passed. All four source types are audited; no required source item is dropped. Existing instructions, current original inventory and all D-01–D-16 remain binding.
| Source | ID | Required outcome | Plans | Status |
|---|---|---|---|---|
| GOAL | G1 | Reproduce identified original/port scenarios and exact native proof | 01–07 | COVERED |
| GOAL | SC1 | Original inventory and isolated generated execution | 01,05–07 | COVERED |
| GOAL | SC2 | Actual original visual/audio/input/event reference, or open access | 01,02,05,07 | COVERED |
| GOAL | SC3 | Full-game evidence→implementation→platform→discrepancy→acceptance | 03,07 | COVERED |
| GOAL | SC4 | Same native Linux/Windows baseline with exact identity | 04–07 | COVERED |
| REQ | EVID-01 | Every original unchanged; generated output separate | 01,05–07 | COVERED |
| REQ | EVID-02 | Reproducible actual original reference and open limitations | 01,02,04,05,07 | COVERED |
| REQ | EVID-03 | Maintained full-game capability coverage ledger | 02,03,07 | COVERED |
| REQ | EVID-04 | Current native Linux/Windows baseline, separately classified | 01,02,04–07 | COVERED |
| CONTEXT | D-01 | Continuous route plus focused moments | 01,04,06,07 | COVERED |
| CONTEXT | D-02 | Equal natural/skipped runs | 01,04,06,07 | COVERED |
| CONTEXT | D-03 | Equal fresh/retained runs and correct lifetimes | 01,04,06,07 | COVERED |
| CONTEXT | D-04 | Ordinary and edge input/bank/landing/idle | 01,04,06,07 | COVERED |
| CONTEXT | D-05 | Paired playback and corresponding artifacts | 02,07 | COVERED |
| CONTEXT | D-06 | Unobstructed captures; optional overlays | 02,07 | COVERED |
| CONTEXT | D-07 | Event alignment at actual speed; exposed drift | 02,07 | COVERED |
| CONTEXT | D-08 | Exclusive corresponding audio; visible review gain | 02,07 | COVERED |
| CONTEXT | D-09 | Capability navigation with requirement/source/receipt links | 03,07 | COVERED |
| CONTEXT | D-10 | Works/verified/differences/acceptance lead each capability | 03,07 | COVERED |
| CONTEXT | D-11 | Current applicability first, exact superseded history | 03,07 | COVERED |
| CONTEXT | D-12 | Player-impact order without closing missing evidence | 03,07 | COVERED |
| CONTEXT | D-13 | User Windows availability, actual execution pending | 01,05,07 | COVERED |
| CONTEXT | D-14 | One identified local bundle/collector per checkpoint | 05,07 | COVERED |
| CONTEXT | D-15 | Generated original through identified DxWnd | 01,05,07 | COVERED |
| CONTEXT | D-16 | All materials before one combined human session | 05–07 | COVERED |
| RESEARCH | R1 | Stdlib tools, no dependency modernization/install | All | COVERED |
| RESEARCH | R2 | Stage/copy/source identity, fresh allocation, atomic failure | 01,05 | COVERED |
| RESEARCH | R3 | Actual source/package/executable/resource/media hashes | 01,05–07 | COVERED |
| RESEARCH | R4 | Typed evidence, failed/incomplete/missing remains open | 01,03,05–07 | COVERED |
| RESEARCH | R5 | Eight explicit matrix cells, continuous and focused obligations | 01,04–07 | COVERED |
| RESEARCH | R6 | Passive accepted-input/control/scene observation across continuations | 04 | COVERED |
| RESEARCH | R7 | External original recording; manual observed markers/uncertainty | 05,07 | COVERED |
| RESEARCH | R8 | Raw MKV/verified preview, derivation/time/crop metadata | 02,05–07 | COVERED |
| RESEARCH | R9 | Paired clocks/drift, seeking/range, exclusive audio/error/tail states | 02,07 | COVERED |
| RESEARCH | R10 | Full 33-requirement ledger and checkpoint-row reconciliation | 03 | COVERED |
| RESEARCH | R11 | Content/scope/platform current applicability and explicit history | 03,07 | COVERED |
| RESEARCH | R12 | Actual dependency/version/profile/media preflight and local transfer | 05,07 | COVERED |
| RESEARCH | R13 | Real native Linux/Windows/physical audio/input and actual original | 05–07 | COVERED; execution remains a dependency |
| RESEARCH | R14 | Bounded input, path/symlink safety, no receipt commands, safe viewer | All relevant tools | COVERED |
| RESEARCH | R15 | Meaningful negative tests, nonempty discovery, no fake native pass | All | COVERED |
| RESEARCH | R16 | Preserve movement/body/TSK/bank/admission; no source investigation needed | 01,04,06,07 | COVERED |
| RESEARCH | R17 | Actual browser/codec and original capture hypotheses A1/A2 | 02,05,07 | COVERED with human backstops |
| RESEARCH | R18 | Local full suite, original verification and durable status before transition | 07 | COVERED |
No deferred ideas were supplied. Later-phase gameplay expansion is excluded by phase ownership, not omitted from this phase's required evidence ledger. The RESEARCH initial-real-pair recommendation is satisfied by eventual actual pairing in 07; its synthetic plumbing allowance enables earlier 01/02 without claiming parity or blocking preparation.
## Spec-less edge report: no silent drop
Source: actual deterministic /tmp/gameport-edge-coverage.json, 9 rows. Seven classified rows receive explicit criteria in must_haves.truths; both unclassified rows remain unresolved flagged assumptions in 01-07. No auto-dismissal. 9 surfaced = 7 explicit authored + 2 flagged unresolved.
| Requirement | Category | Disposition / exact boundary | Plan/task |
|---|---|---|---|
| EVID-01 | adjacency | Reject equal/nested/aliased source/output; allow distinct sibling prefixes | 01-01-01 |
| EVID-01 | empty | Empty/missing inventory invalid; one-file round-trip valid | 01-01-01 |
| EVID-01 | ordering | Canonical relative path order; reject normalized identity collisions | 01-01-01 |
| EVID-01 | concurrency | Exclusive allocation, atomic publish, interrupted incomplete, duplicate import rules | 01-01-01 |
| EVID-02 | unclassified | Unresolved flagged assumption; manual original/DxWnd capture review | 01-07-02 |
| EVID-03 | adjacency | Identical duplicate receipt idempotent, conflicting bytes/history rejected | 01-03-01 |
| EVID-03 | empty | Empty ledger invalid; single capability renderable | 01-03-01 |
| EVID-03 | ordering | Stable ID tie-breaks; explicit supersession, conflict/cycle checks | 01-03-01/02 |
| EVID-04 | unclassified | Unresolved flagged assumption; actual native route/input/audio review | 01-07-02 |
Research A1/A2 backstop truths are separate from the two unclassified rows: backstops abstain to human_needed if unconfirmed and do not auto-resolve those rows.
## Prohibition recall and precision
Stage 1 adversarial recall considered ten candidates per requirement:
| Requirement | Raw candidates |
|---|---|
| EVID-01 | Original mutation, original in-place execution, changed baseline regeneration, empty tree, symlink escape, alias overlap, hash mismatch, partial copy, concurrent allocation, accidental original write |
| EVID-02 | Synthetic parity, hidden retiming, mixed audio, wrapper as historical parity, black capture, silent capture, missing input, fake markers, swallowed abort, unsafe receipt command |
| EVID-03 | Erased history, hidden unimplemented content, missing-proof completion, newest-date selection, duplicate conflict, empty ledger, lost requirements, impact ordering, dead links, injected labels |
| EVID-04 | Wine as native, cross-publish as native, fixture as gameplay, absent Windows proof, fabricated audible pass, available PC as success, wrong package, stale resources, lost lifetime, zero tests |
Stage 2 drops ordinary correctness/hygiene into edge tests and implementation review. Canon path traversal/injection/access control are referred to per-plan STRIDE/ASVS and secure-phase review, not minted as product prohibitions. Three merged bespoke project values survive: P1 authoritative preservation; P2 honest unretimed/unmixed/non-synthetic comparison; P3 historical/full-scope/native proof transparency. P1 maps EVID-01 to 01-01; P2 maps EVID-02 to 01-02; P3 maps EVID-03/EVID-04 to 01-03. They were projected through the installed probe-core.cjs projectProhibitions serializer and authored descriptor-less with status unresolved. No check_* descriptor or must-NOT truth was fabricated. They remain flagged-unverified for final judgment. 3 kept = 3 must_haves.prohibitions; 0 silently dropped.
## Planning evidence and limits
Discovery level 1 is satisfied by current research/official documentation and inspected repository analogs; no new integration/dependency selection is introduced. Existing source paths were grounded with git ls-files. New artifacts are explicitly listed per plan. No prior verify commands/summaries exist; no new implementation/tests/fixtures ran during planning. UI gate supplied frontend=false/block=false; local paired viewer remains fully in scope. Assumption-delta supplied detected=false. Graph is disabled. API capability detector can false-trigger on local viewer/media terminology; COVERAGE.md records the reasoned no-external-integration declaration.
All seven plans have 2–3 tasks and first-task tracers, five execution waves, zero same-wave file overlap and unique T-01-01 through T-01-21 threats plus reserved T-01-SC. Security uses ASVS1 with high blocking. Full-suite durations remain to be measured; quick checks target under 30 seconds. Human verification is a single end-of-phase session, with strict actual acceptance dependencies preserved.
@@ -0,0 +1,74 @@
---
status: testing
phase: 01-reproducible-fidelity-baseline
source: [01-VERIFICATION.md]
started: 2026-11-14T21:56:41.166382+00:00
updated: 2026-11-14T21:56:41.166382+00:00
---
## Current Test
number: 1
name: A1 — Capture and observe the isolated original through the selected DxWnd setup
expected: |
Complete 40 original-Windows-DxWnd obligations; observe moving game imagery and intelligible game audio, retaining actual executable/profile/copy inventories and wrapper/configuration limitations.
awaiting: user response
## Tests
### 1. A1 — Capture and observe the isolated original through the selected DxWnd setup
expected: Complete 40 original-Windows-DxWnd obligations; observe moving game imagery and intelligible game audio, retaining actual executable/profile/copy inventories and wrapper/configuration limitations.
result: [pending]
### 2. A2 — Exercise actual paired recordings in the identified browser
expected: Both real recordings decode, play at actual speed, seek to their own observed events, preserve full tails and switch exclusive audio without concealing elapsed time.
result: [pending]
### 3. EVID-02-unclassified — Review original capture boundaries and limitations
expected: Document observed original/DxWnd launch, crop, aspect, timing, recording boundaries and retained/fresh lifetimes for the actual reference captures.
result: [pending]
### 4. EVID-04-unclassified — Collect and inspect both native platform routes
expected: Complete 40 native Windows and 40 native Linux obligations with actual OS/GPU/driver/Vulkan/SDL/source/package/resource identity and observed route/input/audio continuity.
result: [pending]
### 5. P1 — Resolve the original-preservation prohibition explicitly
expected: Confirm authoritative originals were never executed or changed; compare all 539 recorded hashes and generated-copy pre/retained/post inventories after the session.
result: [pending]
### 6. P2 — Resolve the honest-comparison prohibition explicitly
expected: Confirm genuine original media, no retiming or concealed drift, no mixed simultaneous soundtracks, and visible review gain/derivation provenance.
result: [pending]
### 7. P3 — Resolve the history/full-scope/native-transparency prohibition explicitly
expected: Confirm all 33 requirements and unimplemented content stay visible; conflicting/superseded evidence and native/Wine/component/cross-publish distinctions are preserved after reconciliation.
result: [pending]
### 8. browser — Review the complete local comparison interface
expected: With real captures, verify readable independent clocks/drift, keyboard controls, raw unobstructed default views, optional annotations/differences and visible loading/error/tail states.
result: [pending]
### 9. paired_review — Compare all corresponding actual recordings and record discrepancies
expected: Review matched events, imagery and sound across the required cases, retaining raw drift and justified system-specific observations without invented tolerances.
result: [pending]
### 10. physical_input — Exercise visible native gameplay and actual audible devices
expected: On Linux and Windows use physical supported inputs through lab → VR04 → lab → outside, natural/skipped and fresh/retained cases, held input, banked jumps, landing and idle; confirm real display/audio output.
result: [pending]
## Summary
total: 10
passed: 0
issues: 0
pending: 10
skipped: 0
blocked: 0
## Gaps
No implementation issues reported in this UAT session. All ten actual human checks remain pending; 0/120 capture obligations are accepted. Follow docs/evidence/checkpoint-session.md as one combined session. Prepared materials and prior tests do not supply human approval.
## Session Notes
Restart requested by the user. Readiness then failed on generated tools/recon/__pycache__/fidelity_checkpoint.cpython-312.pyc before any human capture test. Fixed by2fe8b40; real bundled readiness succeeds twice with no bytecode writes. This automated preflight repair does not pass A1 or any other human check.
@@ -0,0 +1,110 @@
---
phase: "01"
slug: "reproducible-fidelity-baseline"
status: validated
nyquist_compliant: true
wave_0_complete: true
created: "2026-11-12"
---
# Phase 01 — Validation Strategy
## Test Infrastructure
| Property | Value |
|---|---|
| Framework | Existing Python stdlib unittest, standalone .NET 10 console projects; Node built-in tests for pure viewer logic |
| Config file | Existing scripts/test.sh and scripts/env.sh; no new package dependencies |
| Quick run command | `python3 -m unittest discover -s tests -p 'test_fidelity_*.py' -v` |
| Viewer quick command | `node --test tests/fidelity-viewer.test.mjs` |
| Full suite command | `scripts/test.sh` (includes counted Python, Node viewer and managed observer checks) |
| Runtime | Broad fidelity run: 40.072 seconds (30-second target exceeded); focused tooling checks typically 1–5 seconds, process/observer checks can take longer. Complete local suite: 782.049626 seconds. |
## Sampling Rate
- After every task: run its focused tests; require a positive test count, not empty discovery.
- After each plan: run all fidelity tests and relevant existing managed/runtime regressions when their boundaries changed.
- After each wave and before verify-work: run scripts/test.sh and all newly introduced viewer checks.
- Every runnable automated command has an adjacent fails_when predicate in PLAN.md.
- Synthetic media and receipt fixtures validate tooling only. Actual Windows/DxWnd and native gameplay receipts require identified execution.
## Per-Task Verification Map
Final task bindings below reference the exact executable `<automated>` blocks in the named PLAN.md/task. Each block carries its adjacent observable `<fails_when>`; Python commands assert the minimum discovered count before running. The tests exist and have run with positive counts. The status column separates passing automation from actual capture/review still OPEN. Shared EVID requirement acceptance is not implied by any green tooling row.
| Task | Wave | Exact automated command binding | Minimum count / threat refs | Actual result |
|---|---|---|---|---|
| 01-01-01 | 1 | 01-01-PLAN.md task 01-01-01: counted `test_fidelity_sessions.py` runner and mandated original inventory invocation | 16; T-01-01/02/03 | green: 29 session tests; 539 originals |
| 01-01-02 | 1 | 01-01-PLAN.md task 01-01-02: counted `test_fidelity_scenarios.py` runner | 12; T-01-02 | green: 25 scenario tests |
| 01-02-01 | 2 | 01-02-PLAN.md task 01-02-01: counted `test_fidelity_review.py` runner; `node --test tests/fidelity-viewer.test.mjs` | Python 10, Node positive; T-01-04/05/06 | green: 21 review + 27 Node tests |
| 01-02-02 | 2 | 01-02-PLAN.md task 01-02-02: `node --test tests/fidelity-viewer.test.mjs` | 16; T-01-04/05/06 | green: 27 Node tests |
| 01-03-01 | 2 | 01-03-PLAN.md task 01-03-01: counted `test_fidelity_ledger.py` runner | 12; T-01-07/08/09 | green: 31 ledger tests |
| 01-03-02 | 2 | 01-03-PLAN.md task 01-03-02: counted ledger runner; `python3 tools/recon/fidelity_ledger.py validate --ledger docs/evidence/capabilities.json --requirements .planning/REQUIREMENTS.md` | 16 tests, 33 requirements; T-01-07/08/09 | green: 31 tests; 33 requirement mappings validated |
| 01-04-01 | 2 | 01-04-PLAN.md task 01-04-01: exact sourced-SDK observer command and counted `test_fidelity_observation.py` runner | Managed 8, Python 4; T-01-10/11/12 | green: 23 managed + 7 process tests |
| 01-04-02 | 2 | 01-04-PLAN.md task 01-04-02: sourced-SDK observer/build and MovementTests/DirectorTests/CheckpointTests/BodyOwnershipTests commands | Managed 14 plus positive existing groups; T-01-10/11/12 | green: observer/build and protected groups 28/23/4/3 |
| 01-05-01 | 3 | 01-05-PLAN.md task 01-05-01: counted `test_fidelity_checkpoint.py` runner; `bash -n scripts/prepare-fidelity-checkpoint.sh` | 12; T-01-13/14/15 | green: 25 checkpoint tests; shell syntax |
| 01-05-02 | 3 | 01-05-PLAN.md task 01-05-02: counted checkpoint runner; package-free PowerShell command deferred to final human session | Python 16, Windows 8; T-01-13/14/15 | green: 25 Python + 18 Linux-hosted PowerShell checks; native Windows session OPEN |
| 01-06-01 | 4 | 01-06-PLAN.md task 01-06-01: counted `test_fidelity_capture.py` runner | 10; T-01-16/17/18 | green: 23 capture tests; actual Linux capture OPEN |
| 01-06-02 | 4 | 01-06-PLAN.md task 01-06-02: counted capture runner and original inventory command | 14; T-01-16/17/18 | green: 23 capture tests; 539 originals; actual matrix OPEN |
| 01-07-01 | 5 | 01-07-PLAN.md task 01-07-01: counted `test_fidelity_acceptance.py` runner; `python3 tools/recon/fidelity_acceptance.py ready --checkpoint dist/fidelity/phase01` | 14; T-01-19/20/21 | green: 29 acceptance tests; readiness exit 0 |
| 01-07-02 | 5 | `python3 tools/recon/fidelity_acceptance.py audit --checkpoint dist/fidelity/phase01 --results dist/fidelity/phase01/results --require-complete` | Real matrix/native/original/human checks required; T-01-19/20/21 | OPEN: strict audit exit 1, errors=[], 0/120; fail-closed behavior covered by passing acceptance tests |
| 01-07-03 | 5 | `scripts/test.sh`; `python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json` | Positive consolidated counts, 539 originals; all threats | green: completed full suite exit 0; 539 originals |
All 15 task bindings were checked against the seven PLAN verify blocks and SUMMARY interfaces. No missing automated contract was found. Task 01-07-02 remains an explicit actual-evidence dependency; its expected nonzero strict audit is not a green acceptance result. Focused commands ran during their owning slices; the completed integrated suite and subsequent tooling regressions are recorded below. No full suite or large checkpoint hash walk was repeated for this audit.
The seven explicit classified spec-less boundaries and two unresolved unclassified manual assumptions are reconciled in 01-SOURCE-AUDIT.md. The two research backstop truths abstain to human_needed if actual original audiovisual capture/browser review is insufficient. Descriptor-less project prohibitions remain flagged-unverified, not silently passed. ASVS1 high/critical threats block acceptance; T-01-SC is reserved across plans.
## Wave 0 Requirements — Complete (Automation)
- Each implementation slice creates meaningful tests together with its production code; no empty stubs counted as validation.
- Implemented fidelity test fixtures covering changed/missing/added originals, output overlap, symlink/drive/case escape, reused session, tampered hash, invalid marker and unsupported schema.
- Implemented pure viewer tests including asymmetric durations, missing/buffering tracks, preserved playbackRate 1.0 and exclusive audio switching.
- No external test-framework installation required. Existing full suite remains available.
## Manual-Only Verifications
| Behavior | Requirement | Why Manual | Test Instructions |
|---|---|---|---|
| Original visible and audible through DxWnd | EVID-02 | User Windows PC and wrapper/media behavior | Use generated verified copy; record Windows/DxWnd/recorder versions and settings; execute the defined matrix and import hashed recordings/annotations |
| Native Windows port route/input/audio | EVID-04 | Cannot be replaced by Linux cross-publish or Wine | Run local checkpoint bundle on user PC; capture actual route and physical input/audio; collect exact package/resource identities and logs |
| Native Linux route/input/audio | EVID-04 | Synthetic/headless fixtures have narrower scope | Run equivalent identified package/matrix on Linux with actual input, audible checks and captures |
| Local playback review | D-05–D-08 | Browser codecs, audible output and media interaction | Load real paired recordings, inspect optional overlays, event seeks/drift and source audio switching without retiming |
Unavailable/failed executions are recorded as open dependencies. Completing tools or preparing a bundle does not close EVID-02/EVID-04 or mark Phase 1 accepted. Source-backed later work may continue only under the existing roadmap exception.
## Measured Verification Evidence
- Completed integrated run: `artifacts/fidelity/01-07-full-suite.json` and `.log`, exit 0 in **782.049626 seconds**. Actual output records 556 Python tests (180 fidelity), 27 Node tests, 23 standalone managed observer checks, two separate HUD tests, all 51 managed entry-point invocations/build, 36 rendered Vulkan receipts with zero reported validation errors, SDL dummy-audio checks and 539 unchanged originals. Optional native-window checks were not enabled. Dummy audio does not establish audibility.
- Subsequent code-review fixes: `01-FIX-REPORT.md` and `artifacts/fidelity/01-review-fixes/`. `python-fidelity.log` records **189 passing tests in 40.072 seconds**; `acceptance-final.log` records **29 passing acceptance tests** after the final standalone-transfer regression. These runs overlap; do not add their counts. `node-viewer-direct.log` records 27 behavior tests, `powershell.log` 18 synthetic checks under Linux-hosted PowerShell, and `original-preservation.log` 539 unchanged originals. The initial sandbox socket errors were resolved by the scoped local run; they are not represented as passes.
- Current discovery, without executing runtime loops: acceptance 29, capture 23, checkpoint 25, ledger 31, observation 7, review 21, scenarios 25, sessions 29: **190 current fidelity tests**. The final added acceptance test explains the difference from the earlier 189-test aggregate; it was executed in the final 29-test acceptance run. Discovery alone is not execution evidence.
- Review fixes exercise selected-receipt digest binding, pristine executable/inventory identity, named copy-state lifetime binding, sealed ledger/history projection including standalone transfer, and incomplete-session recovery without captured promotion. They strengthen existing covered contracts; independent review remains separate.
- Fresh immutable checkpoint: **11001 members**, `dist/fidelity/phase01`. Saved `01-review-fixes/readiness.json` reports `materials_ready: true`, `acceptance: human_needed` (command exit 0). Saved `acceptance.json` reports `errors: []`, **0/120**, all ten human findings pending (strict command exit 1). Original-DxWnd, native Windows and native Linux each retain 40 outstanding obligations.
- Focused tooling feedback is generally around 1–5 seconds (session/scenario/ledger around one second, checkpoint 4.742 seconds, review 5.234 seconds in owning summaries); observer process integration measured 19.126 seconds. The broad 40.072-second regression **exceeds** the proposed 30-second quick target. This is a latency WARNING, not a missing behavioral check or evidence acceptance.
## Validation Sign-Off
- [x] Final plans bind every task to automated checks or explicit human/native evidence
- [x] Sampling continuity has no three consecutive tasks without automated verification
- [x] New test files exist and execute nonzero test counts
- [x] No watch-mode flags
- [ ] Broad quick feedback below 30 seconds — measured 40.072 seconds; WARNING retained
- [x] Native/original capture limitations recorded
- [x] Implemented automated validation contract audited; `nyquist_compliant` and `wave_0_complete` refer only to automation coverage
- [ ] Actual combined capture and human review complete — OPEN
- [ ] EVID requirements and Phase 01 acceptance complete — OPEN
**Automation validation:** Validated on 2026-11-13 from executed tests and retained logs; no new automated gap found, no tests or implementation changed. The latency target remains a documented warning. `status: validated` does not advance the phase or promote any EVID requirement.
**Acceptance dependencies:** A1, A2, EVID-02-unclassified, EVID-04-unclassified, P1, P2, P3, browser, paired_review and physical_input remain OPEN. Follow the single combined agenda in `docs/evidence/checkpoint-session.md` and its Windows/Linux session procedures. Collect actual original-DxWnd/native Windows/native Linux recordings, physical input and audible checks, review real paired playback, return the identified local results, then rerun strict acceptance. The Linux preflight's missing usable display/audio is an explicit dependency. Cross-publish, Wine, headless/synthetic fixtures and preparation cannot close it. Independent review/security gates remain owned by their respective audits.
## Final copy-state refinement
All191 fidelity checks pass in43.355s after02d182f (26 scenario,23 capture,29 acceptance); missing/hash-only/wrong-size state records are explicitly rejected for both lifetimes. The43.355s aggregate still exceeds the30s quick target. No manual acceptance was promoted.
## Validation Audit 2026-11-13
| Metric | Count |
|---|---|
| Gaps found | 0 |
| Resolved | 0 |
| Escalated | 0 |
@@ -0,0 +1,325 @@
---
phase: 01-reproducible-fidelity-baseline
verified: 2026-11-14T05:34:19Z
status: human_needed
score: 29/42 must-haves verified
covered_files: [".planning/REQUIREMENTS.md",".planning/ROADMAP.md",".planning/phases/01-reproducible-fidelity-baseline/01-01-PLAN.md",".planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md",".planning/phases/01-reproducible-fidelity-baseline/01-02-PLAN.md",".planning/phases/01-reproducible-fidelity-baseline/01-02-SUMMARY.md",".planning/phases/01-reproducible-fidelity-baseline/01-03-PLAN.md",".planning/phases/01-reproducible-fidelity-baseline/01-03-SUMMARY.md",".planning/phases/01-reproducible-fidelity-baseline/01-04-PLAN.md",".planning/phases/01-reproducible-fidelity-baseline/01-04-SUMMARY.md",".planning/phases/01-reproducible-fidelity-baseline/01-05-PLAN.md",".planning/phases/01-reproducible-fidelity-baseline/01-05-SUMMARY.md",".planning/phases/01-reproducible-fidelity-baseline/01-06-PLAN.md",".planning/phases/01-reproducible-fidelity-baseline/01-06-SUMMARY.md",".planning/phases/01-reproducible-fidelity-baseline/01-07-PLAN.md",".planning/phases/01-reproducible-fidelity-baseline/01-07-SUMMARY.md","artifacts/fidelity/01-07-full-suite.json","artifacts/fidelity/01-07-full-suite.log","artifacts/fidelity/01-review-fixes/acceptance-final.json","artifacts/fidelity/01-review-fixes/python-fidelity-final.log","artifacts/fidelity/01-review-fixes/readiness-final.json","artifacts/fidelity/bytecode-fix/acceptance.json","artifacts/fidelity/bytecode-fix/fidelity-tests.log","artifacts/fidelity/bytecode-fix/observer-build.log","artifacts/fidelity/bytecode-fix/observer-retry.log","artifacts/fidelity/bytecode-fix/ready-bundled-1.json","artifacts/fidelity/bytecode-fix/ready-bundled-2.json","artifacts/fidelity/verification/01-07-final-checkpoint.json","docs/compatibility.md","docs/decisions.md","docs/evidence/README.md","docs/evidence/capabilities.json","docs/evidence/checkpoint-session.md","docs/evidence/linux-session.md","docs/evidence/phase01-baseline.md","docs/evidence/scenarios.json","docs/evidence/windows-session.md","docs/original-manifest.json","docs/progress.md","docs/tasks.md","scripts/collect-fidelity-linux.sh","scripts/collect-fidelity-windows.cmd","scripts/collect-fidelity-windows.ps1","scripts/env.sh","scripts/prepare-fidelity-checkpoint.sh","scripts/test.sh","src/GamePort/Application/FidelityObservation.cs","src/GamePort/Program.cs","tests/GamePort.FidelityObservationTests/GamePort.FidelityObservationTests.csproj","tests/GamePort.FidelityObservationTests/Program.cs","tests/fidelity-viewer.test.mjs","tests/fidelity-windows.Tests.ps1","tests/test_fidelity_acceptance.py","tests/test_fidelity_capture.py","tests/test_fidelity_checkpoint.py","tests/test_fidelity_ledger.py","tests/test_fidelity_observation.py","tests/test_fidelity_review.py","tests/test_fidelity_scenarios.py","tests/test_fidelity_sessions.py","tools/recon/fidelity.py","tools/recon/fidelity_acceptance.py","tools/recon/fidelity_capture.py","tools/recon/fidelity_checkpoint.py","tools/recon/fidelity_ledger.py","tools/recon/fidelity_receipts.py","tools/recon/fidelity_review.py","tools/recon/fidelity_viewer/index.html","tools/recon/fidelity_viewer/style.css","tools/recon/fidelity_viewer/viewer.mjs","tools/recon/inventory.py"]
covered_digest: "v4:sha256:acca5bdaa1f405a74d29d69c8ebe048085a6a4ff4c86e3b3f80c97cebfba8ac3"
behavior_unverified: 0
overrides_applied: 0
decision_coverage:
honored: 16
total: 16
not_honored: []
non_inferable_checks:
- truth: "Actual original-DxWnd moving game imagery and intelligible audio are observed and reviewed with wrapper/config limitations recorded."
status: uncertain
reason: insufficient_spec
human_check: A1
- truth: "Actual paired recordings decode, seek and switch exclusive audio in the identified local browser without concealing elapsed time."
status: uncertain
reason: insufficient_spec
human_check: A2
unverified_prohibitions:
- id: P1
statement: "MUST NOT sacrifice authoritative original bytes or execute the authoritative installation to make reference collection convenient."
status: unverified
flag: "unverified-prohibition — human review recommended"
- id: P2
statement: "MUST NOT manufacture apparent parity by retiming recordings, hiding drift, mixing both soundtracks or presenting synthetic media as an original reference."
status: unverified
flag: "unverified-prohibition — human review recommended"
- id: P3
statement: "MUST NOT erase contradictory history, hide unimplemented required content or turn missing evidence into a fidelity-completion claim."
status: unverified
flag: "unverified-prohibition — human review recommended"
human_verification:
- test: "A1 — Capture and observe the isolated original through the selected DxWnd setup"
expected: "Complete 40 original-Windows-DxWnd obligations; observe moving game imagery and intelligible game audio, retaining actual executable/profile/copy inventories and wrapper/configuration limitations."
why_human: "Original execution and audiovisual truth are unobserved; the backstop abstains with insufficient_spec."
- test: "A2 — Exercise actual paired recordings in the identified browser"
expected: "Both real recordings decode, play at actual speed, seek to their own observed events, preserve full tails and switch exclusive audio without concealing elapsed time."
why_human: "Controller tests use media doubles; they cannot establish real codec/browser/physical-audio behavior. Backstop: insufficient_spec."
- test: "EVID-02-unclassified — Review original capture boundaries and limitations"
expected: "Document observed original/DxWnd launch, crop, aspect, timing, recording boundaries and retained/fresh lifetimes for the actual reference captures."
why_human: "This flagged assumption cannot be inferred from prepared settings or synthetic metadata."
- test: "EVID-04-unclassified — Collect and inspect both native platform routes"
expected: "Complete 40 native Windows and 40 native Linux obligations with actual OS/GPU/driver/Vulkan/SDL/source/package/resource identity and observed route/input/audio continuity."
why_human: "Windows is cross-published only; current Linux TTY/auto_null preflight cannot capture native physical gameplay."
- test: "P1 — Resolve the original-preservation prohibition explicitly"
expected: "Confirm authoritative originals were never executed or changed; compare all 539 recorded hashes and generated-copy pre/retained/post inventories after the session."
why_human: "Descriptor-less unresolved prohibition requires explicit disposition; current preserved hashes do not prove future session conduct."
- test: "P2 — Resolve the honest-comparison prohibition explicitly"
expected: "Confirm genuine original media, no retiming or concealed drift, no mixed simultaneous soundtracks, and visible review gain/derivation provenance."
why_human: "Unverified-prohibition — human review recommended; genuine playback and perceived audiovisual comparison require observation."
- test: "P3 — Resolve the history/full-scope/native-transparency prohibition explicitly"
expected: "Confirm all 33 requirements and unimplemented content stay visible; conflicting/superseded evidence and native/Wine/component/cross-publish distinctions are preserved after reconciliation."
why_human: "Unverified-prohibition — human review recommended; final returned-evidence reconciliation requires explicit judgment."
- test: "browser — Review the complete local comparison interface"
expected: "With real captures, verify readable independent clocks/drift, keyboard controls, raw unobstructed default views, optional annotations/differences and visible loading/error/tail states."
why_human: "No actual browser visual/usability/codec review has been performed."
- test: "paired_review — Compare all corresponding actual recordings and record discrepancies"
expected: "Review matched events, imagery and sound across the required cases, retaining raw drift and justified system-specific observations without invented tolerances."
why_human: "No corresponding original/native pair or completed visual/audible comparison exists."
- test: "physical_input — Exercise visible native gameplay and actual audible devices"
expected: "On Linux and Windows use physical supported inputs through lab → VR04 → lab → outside, natural/skipped and fresh/retained cases, held input, banked jumps, landing and idle; confirm real display/audio output."
why_human: "Injected/headless/GPU/dummy-audio fixtures prove narrower behavior and cannot satisfy physical-input or audibility acceptance."
---
# Phase 1: Reproducible Fidelity Baseline Verification Report
**Phase Goal:** As a tester, I want to reproduce identified original/port comparison scenarios, so that I understand exactly what the current reconstruction proves on each native platform.
**Verified:** 2026-11-14T05:34:19Z
**Status:** human_needed
**Re-verification:** No existing VERIFICATION.md; completion of the interrupted initial verification after the MVP goal-format correction (`febb4a9`). No scope change or override.
## User Flow Coverage
| Step | Expected | Evidence | Status |
|---|---|---|---|
| Open the local checkpoint and inspect identities | Identified offline original copy, both port packages, complete agenda and viewer | Final readiness receipt: 11,001 immutable members; materials_ready true | VERIFIED for preparation |
| Reproduce isolated original scenarios | Moving imagery, intelligible audio, input/events and retained/fresh provenance from the actual selected DxWnd configuration | Collector/guide prepared; no returned original gameplay captures; 0/40 accepted | UNCERTAIN — WARNING; A1, EVID-02, P1 |
| Repeat matching native Linux/Windows routes | Same route/cases with physical input, real display/audio and exact runtime identities | Windows cross-publish only; real Linux preflight failed without selected X11/real audio; 0/80 accepted | UNCERTAIN — WARNING; EVID-04, physical_input |
| Inspect paired playback | Actual corresponding media with independent event times, exposed drift and exclusive audio | Controller is implemented/tested; prepared viewer contains no actual pair | UNCERTAIN — WARNING; A2, browser, paired_review, P2 |
| Trace what each capability proves | Source/implementation/platform/scope/discrepancy/remaining-acceptance links across the full game | 25 capabilities, six groups, all 33 requirements; current/history preserved | VERIFIED for traceability; P3 final judgment pending |
| Understand the reconstruction on each native platform | Actual identified original/native evidence plus honest discrepancies and unresolved limitations | Audit: errors [], 0/120 accepted; ten named human findings pending | UNCERTAIN — WARNING; user-story outcome remains open |
The MVP user flow is incomplete. No new technical runtime/test run was started to bypass it. The implementation evidence below records inspected code and already completed local verification; it does not constitute manual acceptance. Phase 1 is not passed and Phase 2 is not advanced by this report.
## Goal Achievement
### Observable Truths
Roadmap criteria are retained in full; PLAN truths add detail and do not reduce them. VERIFIED on a tooling truth certifies its bounded implementation, not original/native fidelity. UNCERTAIN items request human verification rather than asserting missing implementation. No accepted override exists.
| ID | Truth | Status | Evidence |
|---|---|---|---|
| SC1 | A reviewer can verify every original against the recorded inventory and run investigation/reference copies without altering the original installation. | UNCERTAIN — WARNING | `verify_inventory`/staging and saved 539-file check prove current preservation; actual generated-copy reference execution and P1 disposition remain unobserved. |
| SC2 | A tester can reproduce identified whole-original reference scenarios from an isolated generated installation and inspect corresponding input/events, images and audio where applicable; unavailable execution keeps this criterion open. | UNCERTAIN — WARNING | Actual original-DxWnd captures absent; explicit access limitation leaves 40 obligations open (A1/EVID-02). |
| SC3 | A reviewer can trace every full-game capability from original evidence through current implementation, platform receipts, discrepancies and its remaining acceptance condition. | VERIFIED | Ledger validator/export/renderer connect 25 capabilities to all 33 requirements, source paths, implementation revisions, scoped platform records, differences and open acceptance. |
| SC4 | Testers can repeat the same baseline movement/route scenarios on native Linux and native Windows with exact revision identities; Wine/cross-publish receipts remain separately labeled and cannot close missing native execution. | UNCERTAIN — WARNING | No accepted current native baseline capture on either platform: 40 Linux + 40 Windows obligations remain open (EVID-04/physical_input). |
| 01.1 | A reviewer can stage and identify a pristine generated original installation without altering any original byte (EVID-01, D-15). | VERIFIED | `fidelity.py:stage` calls `stage_original`; `verify_inventory` compares all recorded file identities before/after isolated copying. Saved original-preservation log verifies 539 unchanged originals. Actual DxWnd execution remains separately pending. |
| 01.2 | The protocol requires continuous lab → VR04 → lab → outside and focused dialogue-return, left/right banked-jump, landing and idle captures per D-01 and D-04. | VERIFIED | `scenarios.json` requires continuous lab → VR04 → lab → outside plus dialogue-return, left/right bank, landing/idle; `validate_scenario_contract`/`audit_scenarios` enforce obligations. |
| 01.3 | Natural/skipped dialogue and fresh/retained entry are equally required, independently identified dimensions per D-02 and D-03. | VERIFIED | Eight case IDs independently cross fresh/retained, natural/skipped and ordinary/held-input; scenario validator rejects collapsed dimensions. |
| 01.4 | Equal, nested, symlink-aliased and Windows case-aliased source/output paths fail before any staging write; sibling paths merely sharing a textual prefix remain distinct. | VERIFIED | `separated_roots`, symlink rejection and canonical path checks precede staging writes; session regressions cover equal/nested/case/symlink/prefix cases. |
| 01.5 | Empty/missing inventories fail; single-file fixtures round-trip, while changed, missing and added files invalidate identity. | VERIFIED | `identify_tree` rejects empty inventory; exact file-list comparison rejects changed/missing/added files; single-file round-trip regressions are active. |
| 01.6 | Manifest order is canonical relative POSIX path order; case-colliding identities fail instead of acquiring filesystem-dependent order. | VERIFIED | `identify_tree` sorts POSIX paths and rejects casefold collisions; canonical-order regression checks actual list/digest values. |
| 01.7 | Interrupted staging/import leaves an explicit incomplete diagnostic and no completed receipt; simultaneous same-session allocation has one winner, and duplicate receipt imports are idempotent only for byte-identical content. | VERIFIED | `_reserve`, exclusive writes, incomplete siblings and atomic publication implement allocation/import ownership. Named concurrency/interruption/duplicate regressions in `test_fidelity_sessions.py` pass in saved 191-test run. |
| 01.8 | Typed receipt validation retains failures and missing evidence as open acceptance; D-13 Windows availability is not a runtime receipt. | VERIFIED | `validate_receipt`/`audit_scenarios` separate failure, synthetic, component, Wine and native kinds. Current real failed Linux receipt remains OPEN; availability is no receipt. |
| 02.1 | A tester opens a local scenario with paired original/port playback and corresponding image, audio and input/event links per D-05. | UNCERTAIN — WARNING | Exporter/controller support paired validated receipts, but final `review.json` has no actual original/native pair. A1/A2/browser/paired_review remain human checks. |
| 02.2 | Raw captures are unobstructed by default; annotations and provenance-bound image differences are optional overlays per D-06. | VERIFIED | Controller defaults `annotations`/`difference` false; corresponding Node overlay/provenance regressions cover opt-in state. Actual visual unobstruction remains part of browser review. |
| 02.3 | Selecting an event seeks each recording to its own observed time; both play at actual speed with separate elapsed clocks, event drift and playback drift per D-07. | VERIFIED | Named Node event-selection/drift/readiness tests assert separate observed times, rate 1, independent elapsed clocks and exposed drift. This verifies controller behavior, not actual codec/browser playback. |
| 02.4 | The reviewer switches corresponding original/port audio with at most one source audible and visible review gain per D-08. | VERIFIED | Named exclusive-soundtrack/gain tests assert both muted before selecting one and labeled review-only gain. Physical audibility remains pending. |
| 02.5 | Missing, buffering, rejected-play, decoding and asymmetric-end states remain visible and preserve the full recording tails. | VERIFIED | Named rejected-play/buffering/decode/asymmetric-end tests assert paired pause, visible cause and resumable full longer tail. Real browser observation is still A2. |
| 03.1 | Reviewers browse movement, contacts, gadgets, progression, visuals and audio with requirement/source/scenario/platform links per D-09. | VERIFIED | `GROUPS` and ledger contain movement, contacts, gadgets, progression, visuals and audio; exported capability links include source/requirement/scenario/platform. |
| 03.2 | Each capability leads with working behavior, verified scope/platform, known differences and remaining acceptance per D-10. | VERIFIED | Capability rows carry working summary, verified scope, implementation revision, differences and open acceptance; renderer presents supplied facts. |
| 03.3 | Current applicable evidence precedes expandable explicitly superseded revision history per D-11; applicability uses content/scope/platform rather than newest date. | VERIFIED | Scope/content/platform applicability and explicit supersession retain current/history. Final reviewed fix verifies both projections survive bundle export; newest date is not acceptance. |
| 03.4 | Discrepancies order blocking/disruptive failures before subtler differences and missing verification per D-12; all missing evidence keeps acceptance open. | VERIFIED | `IMPACTS` orders blocking/disruptive/subtle/missing_verification; acceptance stays open. Strict current audit has no accepted runtime obligations. |
| 03.5 | All 33 full-game requirements have capability coverage even when unimplemented; an empty ledger fails and one capability remains renderable. | VERIFIED | Ledger covers 25 capabilities and all 33 requirements across six groups; validator rejects empty ledger, renderer supports a singleton. Full-game implementation is not claimed. |
| 03.6 | Equal receipt/content identities merge only when the record bytes match; conflicts remain explicit, and duplicate history rows never silently overwrite evidence. | VERIFIED | Canonical byte conflict checks prevent contradictory receipt/content deduplication and preserve history; ledger regression assertions cover conflicts. |
| 03.7 | Equal-priority entries have deterministic stable ID ordering; explicit supersession cycles and unresolved contradictory current claims fail validation. | VERIFIED | Stable ID sorting, supersession-cycle and contradictory-current validation are implemented and covered by active ledger regressions. |
| 04.1 | An optional passive observer records actual native port input/control/scene events across the continuous route per D-01, without changing gameplay or scene lifetime. | VERIFIED | `Program.cs:18-30` owns one optional observer across outer Run continuations; post-Step calls at 1328-1333 use actual accepted input/state. Managed/process regressions cover observer wiring; no physical route acceptance inferred. |
| 04.2 | Natural/skipped and fresh/retained runs have distinct case identities, with one monotonic session across actual retained continuations per D-02 and D-03. | VERIFIED | One retained observer/monotonic session spans Run continuations; distinct case identity and simulation ticks are preserved. Existing observer tests exercise clock/order/continuation. |
| 04.3 | Held/neutral input, banked jump, landing and idle observations retain their real owner/tick/time per D-04; injected smoke fixtures stay separately classified. | VERIFIED | Actual raw SDL/input/state/control calls include owner/tick/time; smoke/injected paths are separately classified. Managed and process assertions check payload/receipt interoperability. |
| 04.4 | An output failure leaves the observation incomplete and visible rather than reporting acceptance or changing movement/state to finish the recording. | VERIFIED | Observer write failure emits an incomplete diagnostic without completing acceptance; standalone managed failure regressions exercise this path. |
| 05.1 | One complete local checkpoint bundle contains identified port packages, a verified generated original copy, scenarios, viewer and result collection per D-14. | VERIFIED | Final checkpoint receipt identifies 11,001 immutable members, both sealed packages, generated original seed, protocol, viewer and result collectors; readiness true. |
| 05.2 | The available Windows PC is treated as a pending execution environment per D-13; actual OS/GPU/driver/tool identities are collected during the session. | VERIFIED | Windows session guide/collector require actual OS/GPU/driver/tool observations; no native Windows receipt exists. Pending environment is explicitly distinguished from execution. |
| 05.3 | The original launches only from a generated copy through the user's identified DxWnd binary/exported profile, separately from native port receipts, per D-15. | UNCERTAIN — WARNING | Collector protects original-pristine, copies a writable run, retains selected DxWnd/profile and requires GUI launch. Actual user-selected DxWnd execution/configuration is unobserved; A1/P1 pending. |
| 05.4 | All original-reference and port materials are prepared before one combined session per D-16; preparation does not close EVID-02 or EVID-04. | VERIFIED | Readiness validates both package identities and complete 80-obligation Windows agenda; guide also requires 40 Linux obligations. `ready()` always reports human_needed. |
| 05.5 | Launcher preflight or recording failure produces an actionable local failure receipt without inventing successful capture or downloading dependencies. | VERIFIED | Collector/preflight failures retain diagnostic/open states. Actual Linux TTY/null-audio failure is retained; PowerShell recovery checks cover aborted incomplete collection without invented success. |
| 06.1 | An identified native Linux package yields actual input/event and audiovisual captures where execution is available; synthetic/headless replays remain distinct (EVID-04). | UNCERTAIN — WARNING | Native Linux collector invokes identified package/observer and real recorder only after preflight. Current host has no selected real display/audio and produced failed preflight, with no gameplay capture. |
| 06.2 | Continuous route and focused captures cover all natural/skipped, fresh/retained and ordinary/edge cells per D-01–D-04, with missing executions explicitly open. | UNCERTAIN — WARNING | Matrix/scenario implementation requires all 40 Linux obligations and tracks missing cases, but no physical Linux route/focused capture is accepted. |
| 06.3 | Physical input/audio and real visible gameplay require actual native receipts/human review; dummy audio and window-only fixtures cannot complete acceptance. | VERIFIED | Preflight rejects dummy/null devices; native review requires real input/audibility/visibility. Strict audit cannot accept headless/synthetic fixtures. |
| 07.1 | One fully prepared combined session covers original-DxWnd and native Windows cases, local Linux review and real paired playback, per D-13–D-16. | UNCERTAIN — WARNING | Materials and one-session agenda are ready; the combined original/native/browser session has not occurred. |
| 07.2 | Every required original-reference and native Linux/Windows case has exact revision/package/resource/media and observation provenance; absent or failed cases keep EVID-02/EVID-04 open. | UNCERTAIN — WARNING | Strict audit reports 0/120 accepted, no structural errors and every missing obligation. Exact successful runtime/media provenance cannot yet be verified. |
| 07.3 | Paired review of actual original/port captures applies D-05–D-08 and publishes raw drift, discrepancies and audible/visible checks. | UNCERTAIN — WARNING | No actual paired recordings or witnessed drift/audio/visual review returned; paired_review/P2 remain pending. |
| 07.4 | Current capabilities/history/discrepancies are reconciled to returned receipts per D-09–D-12, with full matrix completeness per D-01–D-04. | UNCERTAIN — WARNING | Current baseline and ledger honestly retain missing evidence; returned-receipt reconciliation awaits actual collection and agent-owned normalization/import. |
| 07.5 | Actual original-DxWnd moving game imagery and intelligible audio are observed and reviewed with wrapper/config limitations recorded. | UNCERTAIN — WARNING | UNCERTAIN — insufficient_spec: no observed original-DxWnd moving imagery/intelligible audio and wrapper review (A1); metadata fixtures cannot prove it. |
| 07.6 | Actual paired recordings decode, seek and switch exclusive audio in the identified local browser without concealing elapsed time. | UNCERTAIN — WARNING | UNCERTAIN — insufficient_spec: no actual identified-browser decode/seek/exclusive-audio observation (A2); Node media doubles cannot prove browser codecs or audibility. |
**Score:** 29/42 truths verified; 13 UNCERTAIN. **Present-but-behavior-unverified invariants:** 0. Existing behavioral regressions exercise the tooling transitions; the unverified items concern actual external execution, media, physical experience and final reconciliation. A1/A2 separately abstain with `insufficient_spec`.
### Required Artifacts and Wiring Evidence
Owner `query verify.artifacts` independently returned exit 0 for each of seven PLANs: **21/21 declared artifacts** exist and are substantive. Source inspection then checked their actual callers and data contracts.
| Plan | Declared artifacts | Implementation/wiring evidence | Status |
|---|---|---|---|
| 01-01 | fidelity.py; fidelity_receipts.py; scenarios.json | CLI dispatches stage/identify/import/validate; shared validators consume supplied protocol and real byte inventories | VERIFIED |
| 01-02 | fidelity_review.py; fidelity_viewer/viewer.mjs; fidelity-viewer.test.mjs | Validated receipt export → review.json/local media → fetch → controller/renderer; actual pair absent | VERIFIED implementation; actual browser pending |
| 01-03 | capabilities.json; fidelity_ledger.py; docs/evidence/README.md | Validator checks tracked source/requirements/scenarios; canonical export supplies bundle and viewer current/history projection | VERIFIED |
| 01-04 | FidelityObservation.cs; managed observer test Program.cs; test_fidelity_observation.py | Outer Program continuation owns observer; actual raw/input/control/state hooks feed ordered JSONL; process tests feed receipt contract | VERIFIED bounded observer |
| 01-05 | fidelity_checkpoint.py; collect-fidelity-windows.ps1; windows-session.md | Preparation launcher calls assembler; actual files sealed/preflighted; PowerShell emits same versioned contract for later validated import | VERIFIED implementation; native execution pending |
| 01-06 | fidelity_capture.py; linux-session.md; collect-fidelity-linux.sh | Shell execs collector; selected package/observer/recorder argv and real-device preflight feed failure/capture collection and matrix | VERIFIED implementation; native physical capture pending |
| 01-07 | fidelity_acceptance.py; checkpoint-session.md; phase01-baseline.md | Explicit selected receipts/hashes + complete scenario audit + ten findings decide strict acceptance; baseline accurately leaves evidence open | VERIFIED implementation; final reconciliation pending |
Paths above are the exact declared repository paths shown in each PLAN and fingerprint; no artifact is merely an unused placeholder.
### Key Link Verification
The owner heuristic returned 1/14 literal-path links and exit 1 on each PLAN. It searches literal target paths; Python module imports, C# class use, external schema contracts and prose names do not match. Those negative heuristic results are not treated as verified. Manual traces establish the implemented connections below; runtime-return links stay explicitly pending.
| From → To | Actual connection | Status |
|---|---|---|
| fidelity.py → inventory baseline | stage_original → verify_inventory compares inventory.py-compatible file list with docs/original-manifest.json; no direct inventory.py import is needed | WIRED by shared inventory contract |
| fidelity_receipts.py → scenarios.json | CLI/capture pass loaded protocol to validate_scenario_contract/audit_scenarios; stable IDs and required obligations validated | WIRED |
| fidelity_review.py → fidelity_receipts.py | Imports and calls read_receipt, validate_receipt, contained_path, identify_file before export | WIRED |
| viewer.mjs → generated review/media | fetch('review.json') supplies per-side media/events to createPairController; controller enforces exclusive mute and independent times | WIRED; actual media/browser pending |
| capabilities.json → REQUIREMENTS.md | Validator extracts exact IDs and rejects incomplete coverage; all 33 IDs accounted for | WIRED |
| fidelity_ledger.py → viewer ledger | Canonical export/current/history projection copied during checkpoint assembly and rendered by renderCapabilities | WIRED |
| Program.cs → FidelityObservation.cs | Optional outer using owner passed through Run; real post-Step acceptsInput/state/control/raw SDL hooks call observer | WIRED |
| Observed JSONL → shared receipts | Versioned session/case/elapsed/tick payload validated through process interoperability and collector; synthetic scope preserved | WIRED contract; real route pending |
| prepare-fidelity-checkpoint.sh → fidelity_checkpoint.py | Explicit Python invocation consumes original inventory and completed sealed packages | WIRED |
| Windows collector → shared receipts | Emits schema-versioned raw receipts, exact content identities and failure states; documented agent-owned validation/import normalizes returned reviewed records | WIRED contract; actual returned data pending |
| fidelity_capture.py → Linux package/observer | Uses actual package executable/assets and --fidelity-* arguments after real display/audio preflight | WIRED; hardware execution pending |
| Linux receipts → review/acceptance | Collected diagnostics undergo shared validation/import and explicit current selection; real failed Linux receipt remains open | WIRED failure path; successful route pending |
| Returned Windows/Linux results → strict audit | audit reads current.json, validates contained selected receipts and receipt_sha256 binding, checks all 120 slots and named reviews | WIRED implementation; human return pending |
| phase01-baseline.md → capability ledger | Same open acceptance/current scope retained; documented reconciliation updates receipt-bound current/history after return | WIRED present baseline; future reconciliation pending |
### Data-Flow Trace (Level 4)
| Rendered/accepted value | Actual source and flow | Finding |
|---|---|---|
| Capability navigation/current/history/discrepancies | capabilities.json → validate/export → sealed protocol/capability-ledger.json → review.json → renderCapabilities | FLOWING: real maintained evidence; unimplemented and missing scopes remain visible |
| Paired video/audio/event times | Actual imported receipt artifacts/hashes → _side/_events export → review.json → media/controller | Implementation wired; current source is explicitly missing, not synthetic original footage |
| Observer input/state/elapsed | Actual SDL/control/post-Step data → retained observer → bounded JSONL → collector/receipt validation | FLOWING in bounded regressions; current complete physical capture unavailable |
| Native acceptance totals | Explicit selected actual receipt files + content identities → audit_scenarios + CHECKS → strict report | FLOWING: actual failed diagnostic yields 0/120, errors [], human_needed |
Missing media is expected open evidence and is displayed as such; no hardcoded empty success path or invented original recording closes it.
### Existing Behavioral Evidence Reviewed
This completion pass did not rerun tests or launch services. Commands/results below are from retained execution receipts/logs, not SUMMARY assertions; fresh owner queries covered artifact presence, story validity and decision coverage.
| Evidence | Recorded invocation/result | Limit |
|---|---|---|
| Integrated local suite | artifacts/fidelity/01-07-full-suite.json and .log: scripts/test.sh, exit 0, 782.049626s; 556 Python (180 fidelity), 27 Node, 23 managed observer, 2 HUD, 51 managed entry-point invocations, 36 rendered GPU receipts, zero Vulkan errors, 539 originals | Before later tooling-only review fixes; dummy audio/headless checks are not physical/native baseline capture |
| Final tooling regression | artifacts/fidelity/01-review-fixes/python-fidelity-final.log: 191 tests, 43.355s, OK | Includes final copy-state artifact-root fix; no new runtime change or full GPU rerun claimed |
| Media controller | artifacts/fidelity/01-review-fixes/node-viewer-direct.log: 27 pass, 0 fail/skipped; named independent seek/drift, exclusive mute, rejected play, buffering, decode and full-tail assertions inspected | Media doubles exercise controller transitions, not actual browser decoding/audibility |
| Preservation | artifacts/fidelity/01-review-fixes/original-preservation.log: 539 unchanged originals | Byte preservation at check time; final P1 session conduct still needs disposition |
| Readiness | artifacts/fidelity/01-review-fixes/readiness-final.json plus verification/01-07-final-checkpoint.json: 11,001 members, materials_ready true, human_needed | Sealed runtime provenance retained as 446930d dirty true / diff 90cef956…; later tooling revision does not relabel it |
| Strict acceptance | artifacts/fidelity/01-review-fixes/acceptance-final.json: require-complete exit 1, errors [], accepted 0/120, all ten findings pending | Expected open evidence; no malformed acceptance input or observed code failure |
No phase-declared shell probe requiring a separate new execution was identified; the phase relies on the retained local CLI/test/preflight evidence. No full suite was repeated in this completion pass.
### Requirements Coverage
All four accountable requirement IDs are declared across the seven PLANs; no Phase 1 requirement is orphaned. Pending is retained in REQUIREMENTS.md.
| Requirement | Source PLANs | Evidence and remaining dependency | Disposition |
|---|---|---|---|
| EVID-01 | 01,05,06,07 | 539 unchanged originals; bounded isolated staging, canonical inventory and pre/post checks implemented. Final actual session preservation/P1 remains pending | Pending — current preservation verified; final human disposition required |
| EVID-02 | 01,02,04,05,07 | Original-DxWnd collector/protocol/identity/review tooling ready; 0/40 actual original obligations and A1/original-boundary review open | Pending — NEEDS HUMAN |
| EVID-03 | 02,03,07 | All 33 full-game requirements represented in 25 capabilities/six groups; source/implementation/platform/history/discrepancy/open acceptance traceable. Returned-evidence reconciliation and P3 remain open | Pending — ledger implementation verified; final human/reconciliation dependency |
| EVID-04 | 01,02,04,05,06,07 | Native collectors, observer and exact package binding implemented; failed Linux physical preflight retained, no accepted native route; 0/80 accepted | Pending — NEEDS HUMAN |
### Decision Coverage
Owner query: **16/16** trackable CONTEXT decisions honored, not_honored []. “All trackable CONTEXT.md decisions are honored by shipped artifacts.” Advisory gate only; it does not change acceptance.
### Test Quality and Anti-Patterns
Active tests assert concrete identity bytes, rejection behavior, monotonic ownership/state, media-controller transitions and acceptance classification. Test-generated metadata/media are explicitly synthetic fixtures: they verify validators/controller behavior and are never original/native fidelity oracles. The complete-metadata positive matrix test cannot establish actual physical execution; strict real matrix stays 0/120.
The targeted completion scan found no unreferenced TBD/FIXME/XXX or disabled requirement-test markers in the fidelity source/tests/scripts/observer scope; the prior completed 40-file debt/skip scan is retained. Expected empty initial review and false human-review fields preserve missing evidence. They are not stubs claiming completion. No new blocking anti-pattern was established.
Existing gates remain recorded: security 22/22 mitigated, zero open; validation automation complete with manual checks open; independent review verification closes all five historical findings after 02d182f. UI review was explicitly disabled for this phase by the recorded gate configuration; TDD is inactive. These gates were not reopened. Broad tooling feedback 43.355s exceeds its 30s quick target (WARNING), with no effect on native acceptance.
### Human Verification Required
**Ten named findings remain pending.** Collect, observe and return one complete local result tree following docs/evidence/checkpoint-session.md and its Windows/Linux subguides. The integration agent owns evidence-backed normalization, reviewed-copy creation, hash validation, import, current selection, ledger reconciliation and final strict audit after return. Raw receipts remain immutable. Positive human findings must never be generated automatically.
#### 1. A1 — Capture and observe the isolated original through the selected DxWnd setup
**Test:** A1 — Capture and observe the isolated original through the selected DxWnd setup using the combined-session guide.
**Expected:** Complete 40 original-Windows-DxWnd obligations; observe moving game imagery and intelligible game audio, retaining actual executable/profile/copy inventories and wrapper/configuration limitations.
**Why human:** Original execution and audiovisual truth are unobserved; the backstop abstains with insufficient_spec.
#### 2. A2 — Exercise actual paired recordings in the identified browser
**Test:** A2 — Exercise actual paired recordings in the identified browser using the combined-session guide.
**Expected:** Both real recordings decode, play at actual speed, seek to their own observed events, preserve full tails and switch exclusive audio without concealing elapsed time.
**Why human:** Controller tests use media doubles; they cannot establish real codec/browser/physical-audio behavior. Backstop: insufficient_spec.
#### 3. EVID-02-unclassified — Review original capture boundaries and limitations
**Test:** EVID-02-unclassified — Review original capture boundaries and limitations using the combined-session guide.
**Expected:** Document observed original/DxWnd launch, crop, aspect, timing, recording boundaries and retained/fresh lifetimes for the actual reference captures.
**Why human:** This flagged assumption cannot be inferred from prepared settings or synthetic metadata.
#### 4. EVID-04-unclassified — Collect and inspect both native platform routes
**Test:** EVID-04-unclassified — Collect and inspect both native platform routes using the combined-session guide.
**Expected:** Complete 40 native Windows and 40 native Linux obligations with actual OS/GPU/driver/Vulkan/SDL/source/package/resource identity and observed route/input/audio continuity.
**Why human:** Windows is cross-published only; current Linux TTY/auto_null preflight cannot capture native physical gameplay.
#### 5. P1 — Resolve the original-preservation prohibition explicitly
**Test:** P1 — Resolve the original-preservation prohibition explicitly using the combined-session guide.
**Expected:** Confirm authoritative originals were never executed or changed; compare all 539 recorded hashes and generated-copy pre/retained/post inventories after the session.
**Why human:** Descriptor-less unresolved prohibition requires explicit disposition; current preserved hashes do not prove future session conduct.
#### 6. P2 — Resolve the honest-comparison prohibition explicitly
**Test:** P2 — Resolve the honest-comparison prohibition explicitly using the combined-session guide.
**Expected:** Confirm genuine original media, no retiming or concealed drift, no mixed simultaneous soundtracks, and visible review gain/derivation provenance.
**Why human:** Unverified-prohibition — human review recommended; genuine playback and perceived audiovisual comparison require observation.
#### 7. P3 — Resolve the history/full-scope/native-transparency prohibition explicitly
**Test:** P3 — Resolve the history/full-scope/native-transparency prohibition explicitly using the combined-session guide.
**Expected:** Confirm all 33 requirements and unimplemented content stay visible; conflicting/superseded evidence and native/Wine/component/cross-publish distinctions are preserved after reconciliation.
**Why human:** Unverified-prohibition — human review recommended; final returned-evidence reconciliation requires explicit judgment.
#### 8. browser — Review the complete local comparison interface
**Test:** browser — Review the complete local comparison interface using the combined-session guide.
**Expected:** With real captures, verify readable independent clocks/drift, keyboard controls, raw unobstructed default views, optional annotations/differences and visible loading/error/tail states.
**Why human:** No actual browser visual/usability/codec review has been performed.
#### 9. paired_review — Compare all corresponding actual recordings and record discrepancies
**Test:** paired_review — Compare all corresponding actual recordings and record discrepancies using the combined-session guide.
**Expected:** Review matched events, imagery and sound across the required cases, retaining raw drift and justified system-specific observations without invented tolerances.
**Why human:** No corresponding original/native pair or completed visual/audible comparison exists.
#### 10. physical_input — Exercise visible native gameplay and actual audible devices
**Test:** physical_input — Exercise visible native gameplay and actual audible devices using the combined-session guide.
**Expected:** On Linux and Windows use physical supported inputs through lab → VR04 → lab → outside, natural/skipped and fresh/retained cases, held input, banked jumps, landing and idle; confirm real display/audio output.
**Why human:** Injected/headless/GPU/dummy-audio fixtures prove narrower behavior and cannot satisfy physical-input or audibility acceptance.
### Acceptance Conclusion
Autonomous preparation is complete; the promised real comparison outcome remains human_needed. No implementation BLOCKER was established in this bounded completion. The observable absence of original/native accepted captures is a documented human/external evidence dependency, explicitly kept open by the roadmap contract, not silently passed.
A1/A2 are **unverified non-inferable checks** (`insufficient_spec`); P1/P2/P3 are **unverified-prohibition — human review recommended**, with no automatic resolution. No later phase specifically replaces Phase 1 capture/review obligations, so none are deferred. No phase completion, advancement, commit or push was performed.
The fingerprint was produced by the owner CLI `query verification.fingerprint` over the listed actual source/test/document/evidence inputs; its returned fields are copied verbatim. Planning PLAN/SUMMARY coverage was added by the owner. SUMMARYs supply intended interfaces, not proof of behavior.
---
_Verified: 2026-11-14T05:34:19Z_
_Verifier: gsd-verifier_
## Bounded Verification Follow-up — Bundled Bytecode Fix (2026-11-14)
The first actual UAT readiness command exposed a tooling defect: Python local imports created `__pycache__/*.pyc` inside the sealed checkpoint, so later immutable-tree checks could fail. This qualifies the earlier readiness evidence; it was not an original/native capture or an A1 pass. Historical bundle `phase01-before-bytecode-fix-20261114T215109Z` is preserved. The freshly assembled `dist/fidelity/phase01` retains 11,001 immutable members and existing result/run history.
Independently inspected regression commit `23ee1c2` and implementation commit `2fe8b40`. The regression invokes all five copied bundled CLI entry points using `python -E`, checks that no bytecode appears, invokes copied checkpoint preflight twice, and compares the complete tree identity before/after. The fix sets `sys.dont_write_bytecode = True` only under `__name__ == '__main__'`, before local imports, in acceptance/checkpoint/capture/review/ledger. It adds two required sys imports and changes no gameplay, library algorithm, receipt schema or acceptance decision.
| Retained evidence inspected | Actual result and scope |
|---|---|
| bytecode-fix/ready-bundled-1.json and ready-bundled-2.json | Exact bundled-cwd default-python readiness command succeeded twice without -B: materials_ready true, 11,001 members, human_needed; updated checkpoint identity receipt records zero created bytecode files |
| bytecode-fix/fidelity-tests.log | Initial broad attempt ran 185 test methods, with an observer-class setup ERROR caused by its 90-second .NET build timeout; the run is FAILED, not a passing aggregate. The completed methods include the 26 checkpoint regressions |
| bytecode-fix/observer-build.log | Separate bounded build succeeded in 72.12s, zero errors; one NU1900 vulnerability-index access warning retained |
| bytecode-fix/observer-retry.log | Observer-only retry: seven tests PASS in 24.473s; 192 target checks are covered across the separate runs, not by a successful initial full run |
| bytecode-fix/acceptance.json | Strict audit remains exit 1, errors [], 0/120 accepted, all ten named human findings pending |
| verification/01-07-final-checkpoint.json | Current manifest/READY identities updated for source fix 2fe8b40; package runtime provenance remains separately identified |
Evidence paths above are under `artifacts/fidelity/`. No tests, runtime, full GPU suite or wider audit were rerun by this follow-up verifier. The reviewed change is confined to bundled CLI cache behavior; no new native compatibility or gameplay claim follows. The user-selected UAT restart preserves all ten pending findings and agent-owned result reconciliation.
**Follow-up verdict:** the bounded bytecode defect is corrected by the inspected implementation and retained behavioral evidence. Overall status remains **human_needed**, score **29/42**, with **all ten human checks pending**. Fingerprint refreshed through the owner CLI over the prior 65 inputs plus the six evidence files above; prior proof is retained.
_Follow-up verified: 2026-11-14T21:58:58Z_
@@ -0,0 +1 @@
No external API integration: Phase 01 uses local files, native capture, offline media review and a loopback viewer; no hosted API or external SDK is added.
@@ -0,0 +1,35 @@
<!-- CONSUMED: final verification completed human_needed on2026-11-14. Current next action: $gsd-verify-work 1 and combined actual human session; historical interrupted-verifier notes below are superseded. -->
---
context: phase
phase: 01-reproducible-fidelity-baseline
plan: "07"
task: 3
total_tasks: 3
status: consumed
last_updated: "2026-11-13T22:26:46.798618+00:00"
---
# Final verification quota checkpoint
Quota guard explicitly requested pause at15%. Resume completed task01-07-03 and recovered fullsuite exit0 (782.049626s), then reviewed/fixed allfive source-integrity findings. Do NOT redo implementation or tests. Source commits through02d182f, review/coverage/security documentation71366e7. Fullsuite556Python/180fidelity,27Node,23observer,2HUD,51managedentrypoints,36GPUrenderedreceipts,zeroVulkanvalidationerrors,SDLdummychecks,539originalhashes. Latertooling-onlyfixes: all191fidelityregressions PASS43.355s; focused26scenario,23capture,29acceptance,27Node,18LinuxhostedPowerShell. All539originals unchanged. No runtime changes afterfullsuite; no need13minGPUrerun forcurrentPython/collector fixes.
Historicalreview5915128: CR01selected-vs-reviewedpath,CR02originalinventory/executablebinding,CR03copy-stateidentity,WR01viewerledgerprojection,WR02interruptedWindowsfinalization. Fixes5569bc2,bda35e5,6e5ee0b,548c97a,2608517,a821754. Independentre-reviewcaughtremaininghash-onlycopy-statebypass; RED48fca0d/GREEN02d182f requiresactual_checked_artifactwithrootinside_scenario_observation; callersupdated. Finalindependentre-reviewallfiveFIXED in01-REVIEW-VERIFY.md; dispositionopen0. Securityauditorfinal22/22mitigated, threats_open0 in01-SECURITY.md. Nyquistautomationcoveragevalidatedall15taskbindings; manualacceptanceopen;191fidelityaggregate43.355sec exceeds30secquicktargethonestly. UIreviewdisabledconfigfalse. No remainingknowncode/securityblockers.
Currentfreshfinalbundle dist/fidelity/phase01 has11001immutableentries. Currenthashes/readinessreceipt artifacts/fidelity/verification/01-07-final-checkpoint.json. readyexit0true,strictauditexit1 errors[] accepted0/120,10humanpending; logs artifacts/fidelity/01-review-fixes/readiness-final.json,acceptance-final.json,python-fidelity-final.log. Oldbundlespreserved phase01-pre-review-48100025 andphase01-pre-copy-artifact-7ceebcb3. ActualLinuxfailedpreflightimportedcurrentbundle/results/imported. Runtimepackage source446930d dirty/diff90cef956 unchanged; source/docscommitsmustnotrelabelitsidentity. Original/nativeWindows+DxWnd andphysicalLinuxvisible/audible/browserreviewremainonecombinedhuman session pending. Humanonlycollects/observes/returns; agent-ownedexactnormalizationmapping incheckpoint-session.md. No capture request issued yet because finalphaseverification/handoffpending.
Final typed verifier phase01_final_verification was dispatched at21%; quota15% interrupted it, instructedfinishonlyboundedhuman_neededreport/fingerprint thenreturn. It had readall7musthaves/summaries, checked25capabilities/33requirements/0unmapped/6groups/33rows,16/16decisioncoverage,40sourcefilesnoskip/debtscan. A mandatoryMVPgoalformatguard exposed existingROADMAPMode:mvp plainproseGoal. Rootauthorizedformat-only identicalintentuserstory and modifiedROADMAP.md uncommitted: As a tester, I want to reproduce identified original/port comparison scenarios, so that I understand exactly what the current reconstruction proves on each native platform. Validatorvalidtrue; no scope/successcriteriamodified. OneverifiercommandusedwrongunittestclassFidelityAcceptance (loadererror,correctclassAcceptanceTests); twoothernamedbehaviorcheckspassed; don'tmislabelthatcommandassuccess. Priorfulltargeted29passestablishactualcoverage.
NEXT: Reconcile currentverifier's 01-VERIFICATION.md and CLI verification.status; ifreport/fingerprintabsentfinishthat ONLY beforeanynewphase. FingerprintmustbeownerCLIgenerated, notmanual. Oncehuman_neededstatusvalid, persistUATfromnamedhumanitems, updateSTATE/consumedhandoffs, commitverifiedreport+goalmetadata+handoffdocs andpush verifiedsource/tooling toauthorizedGitea/main. Lastpushedhead remainsd18f551; later01-07/task3/reviewfix/auditcommits arelocalawaitingfinalverification. Preserveunrelatedtools.yaml. Do notadvancephase2orclaimPhase1accepted; allEVIDIDsPending0/120humanacceptance. No source changesuncommittedexceptROADMAPformatandpossiblynewverifierreport.
Nativeagents/sourcewritesallfinishedexceptverifierreportbeingclosed. Quota watcher runs and actual15%steeringworks. Noauto-resume; usermust $gsd-resume-workafterreset. Don'tspendquota rereadingmassiveGSDscriptbodies orrerunningfinished13minfullsuite. Existinglocalpackages/media/originalcopiesstaylocal, noCI/uploads. MaintracksGitea/main, scoped.gitwriteescalation; retainhistoricalhandoffsmarkconsumedratherthandelete (priorautomaticreviewrejecteddeletion).
## Required Reading
AGENTS.md,parentinstructions,HANDOFF.json,01-07SUMMARY,01-REVIEW-VERIFY,01-SECURITY,01-VALIDATION,and01-VERIFICATIONifpresent.
## Critical Anti-Patterns
| Pattern | Description | Severity | Prevention Mechanism |
|---|---|---|---|
| Redo completed tests | Fullsuiteand191fidelitychecksfinished | advisory | Reconcile savedlogs first; rerunonlyafternewchanges |
| False phase completion | Preparedmaterialsfailactualstrictacceptance0/120 | advisory | KeepEVIDPending andhuman_needed; owner verification.status beforeadvance |
## Infrastructure State
Testsfinished; verifierinterruptedatpause; reportreconciliationpending; localquota watcher running. No sourceworkeractive.
## Next Action
Inspect01-VERIFICATION.md and owner verification.status; finish report/fingerprint/UAT ifneeded, commit/pushverified01-07reviewedwork; neverredo task3/fulltests orautoapprovehumanacceptance.
@@ -0,0 +1,62 @@
# Evidence Walking Skeleton — Neutron GamePort
Phase 01 · Planned 2026-11-12 · No implementation or new runtime proof implied.
**As a** tester, **I want to** reproduce identified original and port comparison scenarios and inspect their evidence, **so that** I can understand exactly what the current reconstruction proves on each native platform.
This roadmap-derived story framing was supplied by the orchestrator. This is an established native game; its Phase 1 skeleton is the local evidence workflow, without unrelated database, account, routing or deployment scaffolding.
## Capability to prove end to end
Verify authoritative inventory → stage a generated copy → identify actual port bytes → collect/import one honestly classified receipt → inspect local review output. Actual original/native acceptance remains dependent on identified runtime captures and human review.
## Architectural contract
| Decision | Choice | Reason |
|---|---|---|
| Game runtime | Existing .NET 10, SDL3, Silk.NET.Vulkan/Vulkan 1.3+ | Preserve gameplay and current platform design |
| Evidence orchestration | Python stdlib CLI modules under tools/recon | Existing bounded local-tool patterns; no new packages |
| Persistence | Versioned JSON metadata and immutable local hashed artifacts | Actual disk read/write replaces an unrelated database requirement |
| Viewer | Plain HTML/CSS/native media plus testable ES module | Paired recordings, real time, exclusive audio |
| Local access | Contained read-only loopback viewer with GET/HEAD ranges | Browser seeking without hosted services or original-directory exposure |
| Native launch | Local shell / package-free PowerShell and cmd | User Windows PC does not need Python or SDK |
| Auth | No accounts; filesystem containment | A local evidence workflow, not a multi-user service |
| Original reference | Generated copy through actual identified DxWnd | Wrapper provenance remains separate from native port |
| Human gate | One complete session after all preparation | D-13–D-16; actual results required for acceptance |
| Reversibility | Versioned formats, retained raw artifacts, generated views | Shared contracts are costly to change but migrations remain bounded |
## Shared interfaces for parallel execution
Plan 01-01 owns fidelity_receipts.py and scenarios.json. Downstream plans consume those contracts and must not edit them in parallel. Any demonstrated contract correction returns to the owning plan/integrator before consumers continue.
Receipt schema_version 1 carries receipt_id/session_id/case_id, evidence_kind (static, inferred, component, managed, port_fixture, native_port, original_dxwnd, wine, cross_publish, synthetic), status (incomplete, failed, captured, reviewed), source/build/dirty/diff identity, executable/package/resource/original/launcher hashes, platform and observation method, invocation/cwd, wall/monotonic clocks, artifacts/derivatives, event markers with uncertainty, limitations and explicit acceptance. Reviewed status alone never implies full matrix acceptance. Normalized paths, finite times and actual platform/method compatibility are mandatory.
Scenario contract has eight fresh/retained × natural/skipped × ordinary/edge cells, each requiring a continuous lab→VR04→lab→outside run and focused observations. Every side/platform/cell is independently auditable. A retained case carries one session/continuation identity; fresh launches are independent. Original input annotations remain manually observed unless proven otherwise.
Capability export contract is schema_version, capabilities[] with id/group/requirement_ids/summary/verified_scope/differences/acceptance/source_links/scenario_ids/evidence/current/history/discrepancies. Evidence entries retain receipt identity, revision/content/platform/scope and supersedes/reason. Discrepancies carry impact blocking/disruptive/subtle/missing_verification and stable ID ties. Viewer plan 01-02 consumes this contract; ledger plan 01-03 exports it without shared file writes. The authoritative source is docs/evidence/capabilities.json, not generated Markdown or review JSON.
All CLI commands print counted summaries and nonzero invalid/strict-gap exits. `--allow-open` validates structure while visibly reporting pending acceptance; `--require-complete` cannot succeed without actual native/original and human evidence. New source paths, symbols, CLI names and generated artifacts are enumerated in each plan's “Artifacts this phase produces” paragraph.
## Execution graph and ownership
| Wave | Plans | Owned slice |
|---|---|---|
| 1 | 01-01 | Preservation, receipts and complete protocol |
| 2 | 01-02, 01-03, 01-04 | Viewer; ledger; passive port observer, with zero file overlap |
| 3 | 01-05 | Complete Windows checkpoint/collector |
| 4 | 01-06 | Native Linux capture and evidence |
| 5 | 01-07 | Readiness, one combined session, strict audit and status integration |
Every plan begins with a production tracer and then expands the same capability. There are 15 tasks; no task modifies more than five files. Estimates use measured calibration factor 1, sample_count 0, confidence low. No previous GSD summaries/verify commands or graph context exist.
## Walking-skeleton verification
- Real filesystem read/write and CLI receipt inspection are proven in 01-01.
- Actual local media interaction is wired in 01-02 and reviewed with real recordings in 01-07.
- Existing runtime input/event ownership is observed in 01-04, without changing movement/body algorithms.
- The documented full local workflow is package preparation → checkpoint ready → native capture → local import/review → strict audit. Exact commands and failure signals are in plans.
- Any missing original/native access or backstop evidence remains open/human_needed. Tools completion does not complete Phase 1 acceptance.
## Preserved boundaries for later phases
Movement/rotation/body policies, TSK ordering correction, normal landing bank, actor admission and lab/outside compatibility remain unchanged. Broader source-backed work may proceed only under the roadmap access exception while Phase 1 acceptance remains open. New gadgets, online runtime services, cloud CI and artifact uploads remain outside this phase.
+97
View File
@@ -0,0 +1,97 @@
# Reconstruction Architecture and Dependency Gates
**Project:** Neutron GamePort
**Researched:** 2026-11-12
**Scope:** Local repository research for the remaining full reconstruction; no binary analysis, source execution, implementation changes or new runtime verification.
## Recommendation
Extend the existing explicit scene composition and recovered component architecture. Preserve the distinction between a recovered algorithm, a synthetic original-component comparison, a live scene adapter and verified whole-game behavior. Complete movement and interacting lifetimes before expanding gameplay. The architecture already supports playable scenes; replacing it with a new engine or a speculative universal solver would discard the source-order contracts that existing evidence establishes.
This is a dependency analysis of current project reports and selected code, not independent certification of their original-binary findings. The generic CLI confidence classifier returns LOW for the `curated` provider label; it has no repository-evidence provider. Therefore the conclusions below state their documentary basis and limits rather than claiming a provider-certified HIGH confidence result.
## Existing Boundaries to Preserve
| Owner | Existing responsibility | Remaining architectural obligation |
|-------|-------------------------|-------------------------------------|
| `Program.Main` / `RenderSession` | Persistent native window/Vulkan device and session diagnostics; scene replacement | Keep resource replacement separate from original object retention; retain explicit cleanup and native ownership |
| `Program.Run` | Concrete scene composition, held input, fixed-step policy and callback scheduling | Extend actual per-object registry order, live mutation and phase ownership rather than treating grouped updates as original semantics |
| `LabSimulation` / `PlayerSceneBinding` | Player body/controller/fire/control boundaries; fresh versus retained input ordering; script and vehicle bridges | Preserve independent control, body and effect eligibility, retained scalar ownership and authored transform publications |
| `OriginalBodyPhysics`, static/dynamic/pair/normal components | Bounded recovered numeric and callback contracts | Admit only actor states whose membership, callbacks, live reads and helper lifetime have been recovered |
| `SceneDirector` / interactions / tasks | Script actions, task broadcasts, cutscene control, contacts and transitions | Recover remaining real derived callbacks, action acceptance/completion and complete progression consumers |
| `Assets` / offline extractors | Original-format decoding and prepared render/audio resources | Preserve source identity/material metadata, explicit missing resources and immutable originals |
| Application visuals / renderer | Morphs, sprites, UI, camera projection and Vulkan resources | Replace named approximations with source-backed transforms, playback, materials, layers and render states |
| `SceneAudio` / `SdlAudio` | Scene music/speech/effects and native stream ownership | Separate original handle/bank/software clocks from SDL transport; complete positional/lifecycle policies |
Source: [codebase architecture](../codebase/ARCHITECTURE.md), [coverage](../../docs/checkpoint/coverage.md), [implementation ledger](../../docs/checkpoint/implementation-plan.md).
## Physical Scene Admission Is the Immediate Gate
The physical list and the ordinary object registry have separate ownership. Common registration repeats transform/zero/Init work and appends without identity deduplication; Jimmy's outer `49E` guard encloses the whole bridge. A scene-wide two-pass Init/PostLoad abstraction or a snapshot of registry membership would disagree with the recorded same-pass appended-child behavior. Serialized class counts and vtable identities cannot be treated as actual active-body counts.
The registration report inventories all 72 VR04 records/13 interfaces and compares 12 original-component registration/loader cases. Generated-helper edges are catalogued, but constructor/re-entry, conditional creation, removal, activation and retained LOAD/RETURN membership still need full ownership traces. The next integration must recover the actual ordered participants, not simply append every serialized actor or infer eligibility from its presence in the GAM file.
Normal response is also distinct from pair enter/stay/leave notification. Thirty original/C# normal-contact snapshots establish inherited response, Jimmy's ordinary bypass, live accessor order and bounded derived endpoints. Soldier mode10's complete `174` call is only a recorded endpoint; its RNG/action/target policy remains open. The grappler-related Jimmy `204` endpoint is likewise not a recovered universal cleanup policy.
The dynamic query/reclip components already compare empty and populated synthetic contexts, but sequential fixed actors are not a live mutable dispatcher. Post-callback inhibition, geometry permission, radius and `42C` reads must stay live; callback root mutation can be overwritten by final query-local publication. Do not cache constructor values or insert an unevidenced context reset. Preserve old nearest/hit/last-polygon state where recovered.
**Integration order:** real derived responses and game/task consumers → helper activation/removal/re-entry and fresh/retained physical order → shared mutable query context/accessors → bounded response adapter for explicitly supported VR04 states → route and platform verification → broader special-material actors and lab/outside admission.
Sources: [registration](../../docs/checkpoint/physical-registration.md), [helpers](../../docs/checkpoint/vr04-generated-bodies.md), [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [dynamic context](../../docs/checkpoint/dynamic-context.md), [populated reclip](../../docs/checkpoint/dynamic-reclip.md), [pair lifecycle](../../docs/checkpoint/pair-lifecycle.md).
## Camera, Animation and Retained State
- **Shared camera state:** The source report establishes a shared viewport eye read by both scripted camera writes and follow input, strict DEFAULT snapping only above distance1000, and aim computed from the pre-update eye. Current `Program.cs` selects director versus simulation cameras and `LabSimulation` retains its own `CameraEye`; partial gadget bridges do not establish complete shared viewport semantics. Model the owner explicitly after validating the remaining callers. Keep projection, layer masks/fog, noclip and modern orbit policy separate.
- **Animation:** Existing morph assets and deterministic visual checks do not establish the original action acceptance, playback clock, repeat/end events or interruption policy. Recover these across jump/land/STOP/talk/skip/control return before relying on them to drive actor transitions or progression. The port's fixed60Hz simulation policy must not become an assumed oracle for every original animation or script clock.
- **Retained scene state:** Ordinary LOAD/RETURN, TSK loading, debug reset and fresh direct-GAM startup are different paths. Preserve original tasks/items/root state separately from session diagnostics and scene GPU/audio recreation. Current bounded retained player scalars are not permission to carry arbitrary helpers, timers, modes or handles through every transition.
- **Sound clocks:** Original software elapsed/duration, strict completion boundaries, repeat and bank ownership govern cutscene behavior; transport queue-empty and dummy-stream success prove narrower properties. Integrate source channel state before broad playback-dependent script completion.
Sources: [camera handoff](../../docs/checkpoint/camera-handoff.md), [coverage](../../docs/checkpoint/coverage.md), [implementation ledger C5–C8](../../docs/checkpoint/implementation-plan.md), [next-work plan](../../docs/checkpoint/next-work-plan.md).
## Solved Checkpoints Versus Remaining Work
| Reuse as established bounded work | Still required |
|----------------------------------|----------------|
| C1 pre-task objective notification and C2 per-actor Carl task override | Other real derived task/contact policies and full progression |
| Controlled player body-before-callback order, fresh/retained input distinction | Broader object scheduler, mutable helpers and actor-specific eligibility |
| TSK-backed first-story retained Jimmy ordering correction; first-neutral/300-idle regression | Whole-original Carl runtime reference and native Windows comparison; broader handoffs |
| Static camera ray/FIFO/wall-first adapter and per-level far limits | Complete shared eye/aim handoff, special follow branches and visual comparison |
| VR04 ordinary source static body and bounded body publication/mode components | Dynamic registry/response, successful Jimmy hazards/climbs, lab/outside source admission |
| Dynamic query and populated reclip component comparisons | Real actors/accessors and shared ordered scene context |
| Bounded gadget/vehicle scenes and retained scalar bridges | Broader levels, special interactions, helper cleanup and arbitrary save/load lifetimes |
Historical prose in `next-work-plan.md` still says the Carl correction has not begun; later updates and `docs/tasks.md` establish that the source startup-order classification and port correction are already implemented. Do not reopen that defect as untouched work or add an invented leveling reset. Similarly, the old C4 kernel-only checkpoint has been superseded by ordinary-body integration and later component reports, while its broader admission gate remains.
## Dependency Order for the Full Reconstruction
1. **Close the movement/route checkpoint:** real callbacks, helper lifetime/physical order, shared reclip, animation/control/camera handoffs and an integrated lab→VR04→lab→outside regression. Retain the existing playable baseline until each replacement gate closes.
2. **Complete shared actor/gameplay contracts:** source damage/hazards, AI/action/RNG, interactions, gadgets/vehicles and their activation/cleanup. Derive scope from original resources and consumers; existing bounded scenes are reusable implementations, not proof of universal support.
3. **Complete original progression and persistence:** load/RETURN and task/item state, every reachable level/mission, authored scripts and win/loss paths. Add full menu/configuration/save UI once their state ownership is recovered. Level inspection/rendering is insufficient.
4. **Complete presentation and audio contracts:** animation/pivots, material/light/fog/alpha/culling/layers, shared camera and UI; bank/handle clocks, positional mixing and effects. Independent static research can run alongside earlier work, but live integration must respect gameplay and lifetime dependencies.
5. **Verify complete journeys and release packages:** original comparison across representative and full-game routes, native Linux and native Windows gameplay/input/audio/rendering, offline package resource/provenance checks and reproducible discrepancy triage.
These are dependency groups, not a demand to defer all rendering/audio work until the end. Resolve a presentation or sound contract earlier when it blocks a verified gameplay route. Keep the roadmap within the selected standard granularity while allowing phase plans to subdivide evidence gates.
## Verification Architecture
For each admitted capability, maintain an evidence chain: authoritative binary/asset identity → addresses/offsets and REA Evidence or documented provider gap → bounded source contract/probe → managed regression → live scene replay → native platform/package result → whole-original comparison where observable. Preserve complete snapshots and hashes locally. A successful level render, synthetic callback endpoint or cross-publish closes only its named gate.
Use deterministic source/component checks for phase and numeric differences; GPU readbacks for pose/camera/material differences; actual SDL input for integrated ownership and controls; physical/native audio checks for audible behavior; original-format round-trips and live reload for persistence. Define a discrepancy ledger with original/port scenario, first divergence, evidence, fix and remaining uncertainty. Never certify full fidelity from matching a few constants or rendered scenes.
Both packages must identify a clean verified runtime commit and contain matching original/prepared resources. Execute from a standalone directory without source/SDK/development-library paths. Reverify original hashes. Windows cross-publish, Wine compatibility, historical user reports and new native Windows execution remain separate receipts. Push only source/tools/docs to approved Gitea; original assets, generated traces and packages stay local.
## Open Questions for Phase Research
- Complete soldier RNG/action/target response and real enter/stay/leave task effects.
- Constructor-only/conditional helper activation, cleanup mutation and retained physical ordering.
- General live/reentrant scalar getter and shared context ownership beyond fixed synthetic probes.
- Successful Jimmy FENCE/LADDER/hazard paths and multi-frame mode/animation effects.
- Complete shared viewport handoff, source aim quantization and special follow branches.
- Playback clocks/end callbacks, original sound bank lifecycle and full save/menu callers.
- A usable whole-original reference environment and current native Windows verification.
## Sources and Limits
Primary local planning inputs: [PROJECT.md](../PROJECT.md), [architecture map](../codebase/ARCHITECTURE.md), [tasks](../../docs/tasks.md), [coverage](../../docs/checkpoint/coverage.md), [implementation ledger](../../docs/checkpoint/implementation-plan.md), and [next-work plan](../../docs/checkpoint/next-work-plan.md). Selected current code checks: `src/GamePort/Program.cs` camera selection and `src/GamePort/Game/LabSimulation.cs` camera ownership. Specialized evidence reports are linked beside their findings above.
No original files were modified or executed. No current build, platform execution or original-runtime comparison was performed for this report. Architectural recommendations are inference from documented contracts; exact remaining original behavior must be recovered in phase-specific investigation.
+64
View File
@@ -0,0 +1,64 @@
# Remaining Reconstruction Feature Landscape
**Project:** Neutron GamePort
**Reviewed:** 2026-11-12
**Scope:** Remaining full reconstruction, with original fidelity governing scope and acceptance.
## Evidence and interpretation
This is a local specification/report review, not a new binary investigation, build, runtime capture or independent validation of historical receipts. The user's full-reconstruction and maximum-accuracy requirements are explicit. Capability and gap statements below are attributed to repository reports; their exact revision/platform/fixture boundaries remain binding. Older narratives in long reports do not supersede later completion entries. The GSD `classify-confidence --provider local --verified` seam returned LOW because this provider has no curated classification; that label applies to this review's provider classification, not a downgrade of separately recorded original instruction/probe evidence.
Read the current [project context](../PROJECT.md), [current concerns](../codebase/CONCERNS.md), [progress](../../docs/progress.md), [tasks](../../docs/tasks.md), [coverage ledger](../../docs/checkpoint/coverage.md), and [authoritative specification](../../../prompt.MD) together. Treat all remaining-original functionality as required; this is not a market-feature selection exercise.
## Required feature categories
| Category | Existing bounded capability | Remaining reconstruction target | Complexity / acceptance evidence |
|---|---|---|---|
| Jimmy controls and movement | Recovered ground/air acceleration, facing, jump/hold/gravity components and fresh/retained order; native Linux input routes | Close remaining body/contact, mode/facing persistence and animation interactions; preserve original quirks and significant float stores; establish original timing rather than assuming fixed 60 Hz proves parity | High. Original-derived full-state trajectories plus original/port input replays at differing presentation rates; no speed-up from refresh rate |
| Physical world and contacts | Sphere/static kernels, bounded source bodies, ordered pair and normal-response components; lab/outside compatibility capsule | Actual physical registry membership/activation/removal, retained helpers, callback mutations, shared dynamic/static reclip, special hazard/FENCE/LADDER paths, complete derived actor policies | Very high. Complete ordered state/event traces, successful special-contact cases and bounded live scene admission after dependencies close |
| Animation, scripts and control | Original morph assets; CAM/MCA/AI lab chains, natural/skip and TSK story-entry correction | Full action acceptance, animation timing/completion/interruption and script dispatch across characters/scenes; control and body/effect clocks remain independent | High. Compare original action/event/pose sequences, including banked entry, skip/natural return, held input and repeated transitions |
| Cameras and original input | Authored and follow cameras, bounded static camera collision, corrected orbit; SDL keyboard/window handling | Shared scripted/follow viewport state and DEFAULT handoff, full clipping/state policy, source-supported mouse/relative/analog behavior and controller behavior if evidenced | High. Compare eye/target/projection/input state through first resumed frame; verify focus, fullscreen, resize and high-DPI mapping without distorted presentation |
| Actors, enemies and combat | Lab props/patrol subset, source-body components, bounded target/soldier responses | Complete actual class behaviors, sensing, follow, action selection, RNG-dependent policies, damage/health/death/recovery, combat effects and any original difficulty/win/loss rules | Very high. Real derived responses and complete interaction side effects; generic patrol or synthetic callback injection does not prove AI parity |
| Gadgets, vehicles and inventory | Shared selection/energy, ray/jetpack, Invisible, Bubble VR01, Baseball VR07, Rocketship VR02, Grappler VR08 and Scooter VR05/LEV1 | Complete remaining gadgets including Remote; all original intended consumers/scenes, dynamic interactions, mission/hazard policies, retained LOAD/helper/save lifetime and supported input modes | Very high. Inventory earned through normal progression and each intended use exercised without F1 grants or fixture-only shortcuts; current bounded live features remain preserved |
| Levels, tasks and progression | All 35 supplied GAMs parse; 33 have scene geometry; lab → practice → RETURN → outside route and task/score effects | Original reachable campaign, class-specific triggers/objectives/collectibles/NPCs, level-specific mechanics, entrances/exits and final progression outcomes | Very high. Fresh NewGame-to-ending route evidence, intermediate checkpoints and branch/optional content matrix; direct scene selection is not reachability |
| Menus, HUD and configuration | Objective/practice/gadget art and bounded logic; user-authorized modern diagnostics; native window/session handling | Original player-facing frontend, options/configuration persistence, complete HUD/objective flags, cursors/highlights, source-supported input and pause transitions | High. Original screens and modal/input/timer behavior compared; debug menus are test tools, not original frontend completion |
| Save/load and retained state | All 12 supplied TSKs byte-round-trip; tasks/items/RETURN departure-root CLI and carried snapshots | Complete runtime saving/loading and repeated callback semantics, unknown field meanings needed by gameplay, menu integration, arbitrary supported resume, correct fresh/retained/reset ownership | High. Save before/after meaningful interactions and reload to equivalent gameplay state while preserving unknown/raw fields; TSK round-trip alone is insufficient |
| Geometry, animation art and rendering | Original scene/models/morphs/textures, Vulkan material support and GPU/native Linux checks | Original fixed-function equivalents, per-layer lighting/fog/blend/depth/cull/texture states, sprite pivots, full actor root/hierarchy and morph playback fidelity | High. Matched-camera original/port captures, dynamic-state comparisons and documented differences; no pixel-perfect claim from port-only readbacks |
| Audio | Independent music/speech/effects streams, cutscene music stop/restart, default pickup/button/door sounds, some vehicle positional frequency | Full contextual banks, source channel/voice allocation and clocks, volume/pan/attenuation, loops, jetpack and remaining actor effects, encoded resource playback and physical output | High. Matched event/time/listener captures plus audible Linux/Windows verification; dummy-stream lifecycle tests remain narrower |
| Cross-platform release | Shared .NET 10/Vulkan 1.3+/SDL3 runtime; local Linux/Windows publishes and package provenance | Current complete-game packages validated natively on both targets, startup/input/audio/window/resource cleanup and practical driver coverage; offline runtime and reproducible local packaging | High. Standalone native Linux and Windows runs of the same clean source checkpoint and resources; cross-publish/Wine are separate preliminary evidence |
| Original comparison and preservation | 539-original manifest, byte guards, isolated original probes and port regression fixtures | Working copied-original reference captures, systematic discrepancy register, per-system tolerance rationale, integrated whole-game comparison and verified original hashes | Very high. Identify exact reference/port revision, route, input, clock, state and platform; preserve raw evidence locally and distinguish inference from runtime observation |
## Specific boundaries that must shape requirements
- The Carl first-neutral-tick bank has a supported TSK story-entry ordering correction. Preserve it and fresh direct-scene order. Ordinary landing residual bank is user-confirmed original behavior; do not introduce universal leveling. Whole-original Carl comparison remains open. See [menu/player lifetime](../../docs/gameplay/main-menu-player-lifetime.md) and [movement stabilization](../../docs/gameplay/jimmy-movement-stabilization.md).
- Pair/normal components are not a complete live physical world. Soldier complete174 RNG/action effects, helper cleanup/activation across LOAD/RETURN and real enter/stay/leave task consumers remain dependencies. Keep Jimmy ordinary374 separate from inherited reflection and read callback-mutated fields at original times. See [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [registration](../../docs/checkpoint/physical-registration.md), [populated reclip](../../docs/checkpoint/dynamic-reclip.md).
- The independent pickup checkpoint is not the TSK transition-departure root. Save-field preservation must not invent respawn behavior. See [save format](../../docs/save-format.md) and [runtime checkpoint](../../docs/analysis/runtime-checkpoint.md).
- Level3B and Level3E GAMs exist; their OMT archives are absent. Normal gameplay reachability is unverified, so do not declare missing files a campaign blocker, substitute geometry or request files merely from registry membership. Resolve actual reachable content through evidence. See [level-resource mapping](../../docs/analysis/level-resource-mapping.md).
- Some older task lines still call already-live Grappler/Scooter unimplemented. Use [Grappler live](../../docs/gameplay/grappler-live.md), [Scooter live](../../docs/gameplay/scooter-live.md), [Rocketship live](../../docs/gameplay/rocketship-live.md) and [Baseball implementation](../../docs/gameplay/baseball-implementation.md) as their bounded capability records.
- Bird1/id162 retains MPEG Layer3-in-RIFF data and is unsupported by the documented SDL WAV path; do not silently substitute audio. Bank/channel/attenuation policy remains incomplete. See [sound effects](../../docs/analysis/sound-effects.md).
## Dependency order for roadmap construction
1. Establish a usable original-reference comparison route and evidence/discrepancy matrix early. Continue source-backed work when a runtime reference is unavailable, but preserve the outstanding fidelity gate.
2. Finish movement/contact/animation/camera and retained registry/helper contracts; prove the lab → VR04 → lab → outside route as one interacting system before new gameplay expansion.
3. Expand real actor responses, hazards/combat and gadget consumers on that foundation, preserving current bounded features and explicit scene admission.
4. Complete campaign tasks, level-specific systems, frontend and save/resume in playable slices. Unknown reachability, task consumers and saved state require phase-specific recovery.
5. Complete visual/audio behavior alongside supported gameplay slices; do not defer all comparison until release, because presentation clocks and camera/input ownership affect gameplay.
6. Validate the full campaign and supported optional content against original evidence on native Linux and native Windows, then produce local clean packages and a discrepancy audit.
This order is an integration recommendation, not a claim that every system must be fully recovered before any bounded change. Rendering/audio investigations can proceed independently with exclusive ownership; gameplay expansion remains behind the current movement gate.
## Differentiators and explicit exclusions
No new competitive features are proposed. Fidelity to the original is the defining value. Preserve existing user-authorized diagnostics and modern platform support, but keep them separate from original gameplay claims. Exclude invented story/mechanics, replacement movement tuning, PBR/visual redesign, online services, telemetry, cloud CI, and original/generated-package uploads.
## Completion targets
- One faithful playable scene is an intermediate milestone, followed by all original reachable content and progression; loading all assets is not a playable-game criterion.
- Every feature has separate recovery, implementation, component-test, integrated-runtime and original-comparison status, with paths to evidence and known approximations.
- Expected results come from authoritative original instructions/data/execution and working-original observation where available; port outputs cannot be their own fidelity oracle.
- Native Linux and native Windows packages identify the same verified source/resources; original hashes remain unchanged; unresolved discrepancies remain visible and prevent unsupported full-fidelity claims.
## Sources
All source links above are local project evidence. Additional integration references: [next-work plan](../../docs/checkpoint/next-work-plan.md), [implementation plan](../../docs/checkpoint/implementation-plan.md), [compatibility](../../docs/compatibility.md), [presentation/UI](../../docs/presentation-and-ui.md), [graphics recovery](../../docs/analysis/graphics.md), [rendering](../../docs/rendering.md). Rendering and task reports contain historical entries; consult current progress and feature-specific completion reports before treating an older gap as current.
+116
View File
@@ -0,0 +1,116 @@
# Reconstruction Pitfalls
**Project:** Neutron GamePort
**Reviewed:** 2026-11-12
**Scope:** Remaining full reconstruction; local documentation review only. No new original-binary investigation, execution, build or runtime comparison was performed.
## Evidence and confidence
The risks below are cross-referenced repository findings, not externally researched ecosystem claims. Their supporting source/component observations have the bounds specified in the linked reports; their implications for phase ordering are planning inferences. Whole-game accuracy is unverified. The generic `classify-confidence --provider curated --verified` seam returned LOW for this local-source provider; that label must not be mistaken for a new certification of the original experiments. Use the underlying receipts and their explicit execution scope when deciding admission.
## Critical pitfalls
### 1. Promoting component parity into live gameplay fidelity
**Failure:** A matching pair, normal-response or reclip fixture is wired into every scene as though actual actors, registry membership and task effects were recovered.
**Warning signs:** Completion claims cite only fixture counts; synthetic callback endpoints are described as real soldier/Jimmy policies; serialized GAM records become the active physical-body count.
**Prevention:** Require actual class construction, activation, physical order, derived response, enter/stay/leave consumers and shared context before expanding each live adapter. Keep lab/outside capsule compatibility until its replacement dependencies close. Compare complete callback events, flags and state snapshots, not just final positions. Soldier complete174 and Jimmy204 remain record-only endpoints in the normal-contact report.
**Phase implication:** Physical lifecycle and derived callbacks precede broad actor, enemy and gadget collision expansion.
Sources: [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [physical registration](../../docs/checkpoint/physical-registration.md), [pair lifecycle](../../docs/checkpoint/pair-lifecycle.md), [coverage](../../docs/checkpoint/coverage.md).
### 2. Fixing symptoms by changing legitimate original movement
**Failure:** A universal angle reset, added damping or imported tuned movement masks an ownership/scheduling divergence and removes original behavior.
**Warning signs:** Ordinary landing bank is called a bug; fresh direct-scene and TSK-backed retained entry are given the same input order; JN-Engine's tuned movement becomes the oracle.
**Prevention:** Preserve current movement and the successful first-story TSK retained-input correction. Trace the first divergent owner and caller phase before changing arithmetic. Recheck neutral return, sustained idle, held input, both turn directions, natural/skip completion and repeated scenes. External decompiler indexes provide leads only.
**Phase implication:** Movement, control/animation ownership and route handoffs remain the first implementation checkpoint. The Carl initialization correction is existing work, not an untouched future fix.
Sources: [menu/player lifetime](../../docs/gameplay/main-menu-player-lifetime.md), [movement stabilization](../../docs/gameplay/jimmy-movement-stabilization.md), [next-work plan updates](../../docs/checkpoint/next-work-plan.md).
### 3. Flattening physical registration and retained lifetime
**Failure:** Deduplication, snapshot traversal or a generic reset silently changes ordering across fresh load, retained LOAD and RETURN.
**Warning signs:** Constructor registrations are treated as final active membership; Init and PostLoad run as two global passes; setting a flag is treated as deleting a node; helper reuse/cleanup is assumed from a constructor edge.
**Prevention:** Keep ordinary registry and physical list independent. Common registration can append an existing pointer; Jimmy's outer guard is separate. Preserve Init-before-parent-append and per-object Init/PostLoad traversal that can visit new tails. Recover actual helper removal, activation and re-entry before representing retained lists. Compare complete ordered lists across scene transitions.
**Phase implication:** Lifecycle closure must precede arbitrary retained saves, general dynamic contacts and full-level progression admission.
Sources: [registration](../../docs/checkpoint/physical-registration.md), [generated helpers](../../docs/checkpoint/vr04-generated-bodies.md), [dynamic context](../../docs/checkpoint/dynamic-context.md).
### 4. Caching values across source callbacks
**Failure:** A refactor snapshots radius, inhibition, geometry permission or velocity before callbacks, changing subsequent reclip and final publication.
**Warning signs:** Accessors become constructor constants; a callback's root edit is assumed to survive final local-root publication; collision mode and class-specific controller state share an enum or layout.
**Prevention:** Preserve source getter order and independent fields. Test callbacks that mutate radius, flags, Y velocity and roots, plus retained old-hit/last-polygon behavior. Distinguish XYZ writes from full XYZW setters. Do not apply inherited reflection to Jimmy ordinary374, which takes its own material-policy path.
**Phase implication:** Response adapters require live getter and ownership contracts before integration.
Sources: [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [populated reclip](../../docs/checkpoint/dynamic-reclip.md).
### 5. Treating mathematically equivalent arithmetic as source equivalent
**Failure:** Double promotion, normalization changes, reordered operations, triangle winding fixes or a faster broadphase alter strict branches, ties and accumulated state.
**Warning signs:** Double intermediates are called an x87 emulator; only root tolerance is checked; duplicated source cell visits are removed; heading wraps or unclamped damping are normalized to conventional behavior.
**Prevention:** Preserve evidenced float-store boundaries, kernel A,C,B winding, strict comparisons and traversal order. Record the first exact differing field and kernel argument. Widening precision or optimizing needs new differential evidence; degenerate inputs outside the bounded contract remain explicit unknowns.
**Phase implication:** Preserve numeric probes throughout collision, actors and rendering-transform work; optimize after equivalence and measured need.
Sources: [dynamic reclip](../../docs/checkpoint/dynamic-reclip.md), [normal contacts](../../docs/checkpoint/actor-normal-contacts.md), [codebase concerns](../codebase/CONCERNS.md).
### 6. Mistaking successful rendering or audio transport for original presentation
**Failure:** Zero Vulkan errors, identical port screenshots or SDL dummy-stream success are reported as visual/audible parity.
**Warning signs:** Merged far-plane policy implies per-layer fog/clipping fidelity; queue-empty replaces the original software sound clock; fixed 60 Hz is called recovered original scheduling; a correct transform kernel implies exact final OMT visual decomposition.
**Prevention:** Compare original reference frames and sound intervals at identified states. Keep lighting/fog/material/blend/culling, sprite/pivot/decomposition, morph clocks, camera handoff, sound-bank/channel duration/attenuation and physical listening as separate targets. Retain device-independent numeric and transport checks, but report their narrower guarantees.
**Phase implication:** Presentation and audio need source-specific recovery and integrated comparisons; start reference acquisition early rather than leaving all fidelity checks until release.
Sources: [coverage](../../docs/checkpoint/coverage.md), [compatibility](../../docs/compatibility.md), [air bridge](../../docs/gameplay/jimmy-air-bridge.md).
### 7. Shipping a different revision from the one verified
**Failure:** Current source, historical GPU tests and an older local package are merged into one completion claim; Wine is presented as native Windows verification.
**Warning signs:** No exact package identity; user Windows reports attributed to an agent-run current build; startup black frames treated as a playable original reference; source-only changes inherit old SDL coverage.
**Prevention:** Bind every receipt to source commit, package provenance, resource hashes, platform, scenario and validation setting. Run the same integrated route/control/window/audio checks on clean standalone Linux and native Windows packages. Keep original-component Wine32, port Wine64, whole-original reference and native Windows evidence separate. A blocked original runtime comparison remains an open release obligation.
**Phase implication:** Reference/native Windows access is an early dependency; final full-game acceptance requires current integrated evidence, not a cross-publish alone.
Sources: [progress](../../docs/progress.md), [compatibility](../../docs/compatibility.md), [codebase concerns](../codebase/CONCERNS.md).
## Further risks during full reconstruction
| Risk | Warning sign | Prevention / roadmap consequence |
|------|--------------|----------------------------------|
| Asset inventory mistaken for playable coverage | All GAMs parse, therefore all levels are called complete | Track each original route, mechanic, actor and script consumer through implementation and runtime verification. |
| Unsupported missing-content conclusion | Level3B/E GAMs described as missing, or absent OMTs called a proven fatal normal-game blocker | GAMs exist; distinguish their referenced absent archives from proven reachability. Investigate hardcoded/serialized routes without inventing substitutes. See [resource evidence](../../docs/analysis/level-resource-mapping.md). |
| Save round-trip mistaken for load fidelity | Binary equality substitutes for repeated task/entity callbacks and retained scene ownership | Recover full original load UI, callback multiplicity, placement and helper lifetimes; test loading at real progression boundaries. See [coverage SAVE](../../docs/checkpoint/coverage.md). |
| Invalid copied-code evidence accepted | Partial captures or relocation scans are counted as source behavior | Preserve full REA replies, source/probe hashes, reviewed operand mappings and completion markers; exclude invalid captures. Provider errors remain errors. See [normal contacts](../../docs/checkpoint/actor-normal-contacts.md). |
| Original evidence altered or published | Extraction/probes target Original, or package files enter source commits | Generated copies/output only; verify all 539 baseline hashes, stage explicit source/docs paths and keep assets/packages local. |
| Old narratives override newer receipts | A solved Carl bug is reopened from an older section | Follow dated continuation updates and exact receipt scope; reconcile current reports before planning changes. |
## Phase-specific gates
1. **Core movement/lifetimes:** preserve baseline, close real response/helper/state owners and validate lab → VR04 → lab → outside before expansion.
2. **Actors/gadgets/combat:** recover actual callbacks, RNG/action policies, activation and physical order before broader admission; bounded training-scene behavior is not full-game coverage.
3. **Progression/save/menu:** exercise complete authored routes, fresh/load/RETURN paths and task callbacks; do not equate parsable resources with playable progression.
4. **Rendering/audio/UI:** obtain observable original references, then address named state/clock/transform differences with isolated and integrated evidence.
5. **Release:** identify exact clean builds and resource manifests; verify full original content and native Linux/Windows behavior, with no unverified fidelity claims hidden by successful packaging.
These gates are dependency recommendations inferred from current findings. They are not new binary findings or implementation approvals.
+59
View File
@@ -0,0 +1,59 @@
# Technology and Verification Foundation
**Project:** Neutron GamePort remaining full reconstruction
**Researched:** 2026-11-12
**Method:** Local specification, source/configuration cross-checks and existing verification reports. No dependency updates, new runtime tests or binary analysis were performed.
## Keep the Existing Stack
| Component | Repository version/requirement | Role and decision |
|-----------|-------------------------------|-------------------|
| C# / .NET | `net10.0`; SDK selector 10.0.100 with latestFeature roll-forward; bootstrap SDK 10.0.402 | Retain one shared Linux/Windows x64 executable. Do not plan a foundation rewrite. |
| Silk.NET.Vulkan / KHR / EXT | 2.23.0 | Existing Vulkan bindings, pinned in the project and lockfile. |
| Vulkan | 1.3 minimum | Existing renderer requests Version13 and rejects older devices. Host driver/loader remains required even with self-contained packages. |
| SDL3 | 3.4.2 in bootstrap | Existing handwritten P/Invoke for native window, input, surface and audio. Retain the shared platform boundary. |
| GLSL / SPIR-V tools | Local shader compiler and validator | Preserve original fixed-function behavior through explicit Vulkan shaders/states rather than modernizing the look. |
| Python / Bash / C | Local tooling; documented Python 3.12 | Offline preparation, repeatable local scripts and isolated original-component probes. None is a packaged gameplay runtime dependency. |
| REA / Ghidra / full JDK | Existing launcher; documented Ghidra 12.1.4 / Java 21 paths | Required investigation route for original binaries. Check actual local launcher/tool identities when producing new evidence. |
| Wine | Documented 11.0 | Isolated original/component investigation and preliminary Windows compatibility only. It cannot substitute for native Windows verification. |
Versions describe this repository, not upstream latest releases or newly verified installations. `docs/dependencies.md` records runtime pack 10.0.13; confirm generated publish runtime metadata for each package rather than deriving runtime version from SDK version.
Sources: [project](../../GamePort.csproj), [SDK selection](../../global.json), [bootstrap](../../scripts/bootstrap.sh), [dependencies](../../docs/dependencies.md), [renderer](../../src/GamePort/Rendering/Vulkan/VulkanRenderer.cs), [REA launcher](../../scripts/rea.sh).
## Existing Local Delivery and Evidence Facilities
- `scripts/env.sh` selects local SDK/cache/native tools and disables .NET CLI telemetry. NuGet dependencies are locked in `packages.lock.json`.
- `scripts/test.sh` combines Python parser/source regressions, managed algorithm programs, Vulkan rendering and SDL dummy-audio checks. Tests must retain their bounded claims: exact component output does not establish original full-game scheduling or visuals.
- `scripts/build-linux.sh`, `scripts/build-windows.sh` and `scripts/package.sh` already implement local self-contained publishing and original-derived asset assembly. Packages include SDL3, shaders, resources, licenses and source provenance. They remain local artifacts.
- Original preservation uses `tools/recon/inventory.py` with `docs/original-manifest.json`. Existing reports record 539 hashes; run the verifier at actual implementation/package checkpoints.
- Runtime has no required hosted service, account system, remote database or telemetry. Gitea is solely the authorized source-control destination for completed verified source/tools/docs.
Sources: [integration map](../codebase/INTEGRATIONS.md), [test entry](../../scripts/test.sh), [packaging](../../scripts/package.sh), [project rules](../../AGENTS.md).
## Remaining Capability Gaps
| Gap | Existing evidence | Required closure and roadmap implication |
|-----|-------------------|------------------------------------------|
| Whole-original reference execution | Compatibility reports record isolated Wine windows with unusable original GL/Vulkan rendering; component execution is available | Establish a working local original reference environment/capture path early. Use a generated copy, local Windows/legacy VM or other supported local investigation path. Feasibility of a particular environment is unverified. Do not silently promote component probes to whole-game reference evidence. |
| Native Windows verification | Windows x64 cross-publish, preliminary Wine checks and bounded user reports exist | Plan repeatable native Windows input, audio, resize, driver and integrated progression checks. Record revision, device/environment and scenario results. A new cross-publish does not refresh prior Windows runtime evidence. |
| Audible and positional audio comparison | Dummy streams verify consumption/lifecycle; broader speakers/latency/attenuation verification remains open | Compare effects/bank selection, spatial behavior, timing and actual listening output against the original on both native platforms. SDL API availability alone does not resolve policy. |
| Rendering equivalence | Native Linux/llvmpipe GPU checks and readbacks exist | Add reference-matched camera/scene captures and per-state discrepancy review for materials, lighting, fog, alpha, pivots and animation. Zero Vulkan validation errors proves API correctness, not fidelity. |
| Timing and retained system composition | Numerous copied-original component cases; fixed 60 Hz port policy; source ordering corrections already integrated | Recover remaining shared scheduling, actor lifetime and callback contracts before broad solver admission. Compare event/state traces as well as pixels and final positions. |
| Full content and release coverage | 35 GAMs catalogued, 33 with matching geometry; local packages contain substantial playable content | Audit all reachable original routes and resources. Missing Level3B/E geometry is recorded but normal gameplay use is unverified: it is not an established blocker or permission to fabricate replacement assets. |
Sources: [compatibility ledger](../../docs/compatibility.md), [current progress](../../docs/progress.md), [next-work plan](../../docs/checkpoint/next-work-plan.md), [authoritative specification](../../../prompt.MD).
## Roadmap Decisions
1. Treat the existing shared renderer/platform/build system as the foundation. Extend focused recovered modules and local checks instead of reselecting engines or libraries.
2. Establish the original-reference and native-platform comparison matrix at the start and grow it with each gameplay slice; reserve final cross-platform acceptance for complete routes and clean packages.
3. Keep the current Jimmy stabilization and collision admission gates ahead of gameplay expansion. Additional tooling should answer a named unresolved source/runtime question, not become an independent infrastructure rewrite.
4. Preserve generated extraction, original-code probes, snapshots and build output separately from immutable originals. Commit findings/tools/source only; no original assets or generated packages may be pushed.
5. Record source commit, package identity and verification scope together. Research does not refresh historical runtime receipts.
## Confidence and Unresolved Questions
The stack/configuration observations are directly cross-checked against repository files; historical runtime results are report evidence, not newly reproduced results. No claim is made about current upstream releases. The generic GSD `classify-confidence --provider curated --verified` returned LOW without a recognized package/ecosystem; that provider score does not independently validate these local artifacts.
Open questions are the working original capture environment, comprehensive native Windows availability, original cadence/reference trace coverage, audible output parity and the complete reachable content matrix. These require phase-specific local investigation and execution; they are not reasons to replace the mandated technology stack.
+181
View File
@@ -0,0 +1,181 @@
# Project Research Summary
**Project:** Neutron GamePort — remaining full reconstruction
**Domain:** Evidence-led reconstruction of a legacy native 3D game
**Researched:** 2026-11-12
**Confidence:** High in mandated scope and existing boundaries; medium in roadmap decomposition; unresolved for complete original/runtime fidelity.
## Executive Summary
This is an existing playable reconstruction, not a new engine project. Retain the shared C#/.NET 10, Silk.NET.Vulkan/Vulkan 1.3+ and SDL3 foundation, original-derived resources, local tooling and bounded recovered components. The user requires the remaining full game to match the original as accurately as possible. Original behavior, including quirks, takes priority over conventional movement or presentation improvements. A faithful scene is an intermediate milestone; complete campaign and supported optional-content coverage remain required.
The immediate implementation dependency is movement and interacting ownership: real derived actor responses, physical/helper registration and cleanup, callback-mutated fields, shared dynamic/static reclip, animation and camera handoffs. Preserve the implemented TSK-backed first-story ordering correction and legitimate landing bank. Expand existing gadgets, actors and levels only after their source admission dependencies close. Complete gameplay, progression/persistence and presentation/audio through integrated playable slices rather than treating their isolated algorithms as full scene support.
The largest acceptance gap is reference evidence. Existing copied-original component execution, Linux SDL/Vulkan tests, Windows cross-publishing and Wine results have useful but different scopes. Establish a usable copied-original reference environment and repeatable native Windows checks early; grow comparison coverage throughout implementation. Full-game completion requires current integrated native Linux/Windows and original-versus-port evidence, exact source/package provenance and explicit discrepancy closure. This research reviewed local documents and selected configuration/code; it did not refresh any runtime receipt or recover new binary behavior.
## Key Findings
### Recommended Stack
Retain the existing implementation. Repository versions are .NET 10 (`net10.0`, bootstrap SDK 10.0.402), Silk.NET.Vulkan/KHR/EXT 2.23.0 and bootstrap SDL3 3.4.2. Vulkan 1.3 is mandatory. These describe repository configuration, not newly checked upstream releases or installations. Host Vulkan loader/driver support remains necessary for self-contained packages.
- **C#/.NET 10:** one shared native Linux/Windows x64 runtime and managed regression programs.
- **Silk.NET.Vulkan and GLSL/SPIR-V:** existing resource ownership and shader pipeline; extend source fixed-function equivalents instead of redesigning the look.
- **SDL3:** existing native window/input/audio transport; original policy and timing remain project responsibilities.
- **Python/Bash/C, REA/Ghidra and Wine:** local preparation, evidence and isolated probes. They are not online or packaged runtime dependencies. REA is required for future original-binary investigations; Wine is preliminary compatibility evidence.
- **Local build/package scripts and hash manifests:** reuse established facilities, adding exact revision/platform/resource receipts rather than replacing infrastructure.
See [STACK.md](STACK.md) for configuration sources and verification capability gaps.
### Expected Features
All original-required behavior belongs in the full reconstruction scope. Existing bounded implementations are reusable progress, not grounds to omit their remaining consumers or lifetimes.
**Must complete:**
- Jimmy movement, original input, body/contact modes, animation/control and camera ownership across fresh entry, scripts, LOAD and RETURN.
- Actual actors, enemies/AI, RNG/action policies, health/damage/hazards, combat and class-specific task/contact effects.
- All original gadgets/vehicles and inventory/energy behavior across intended consumers and scenes, preserving currently live bounded features.
- Reachable campaign levels, authored scripts, tasks, objectives, collectibles, branch/optional content and ending/win/loss behavior where evidenced.
- Original frontend, HUD, options/configuration and complete runtime save/load/resume semantics.
- Original geometry, pivots/morphs, materials, lighting/fog/alpha/depth/cull/layer behavior and camera presentation.
- Music/speech/effects, contextual banks/channels, clocks, loops, attenuation/panning and physical audible output.
- Offline clean packages and integrated native Linux/Windows and original-reference comparisons.
**No new differentiators:** Fidelity is the value. Keep existing user-authorized diagnostics distinct from original frontend/gameplay. Do not add creative mechanics, tuned replacement movement, visual modernization, online services or telemetry. No original-required category is deferred beyond the full reconstruction merely to shorten this roadmap.
See [FEATURES.md](FEATURES.md) for per-category existing capabilities, dependency and acceptance targets. Level3B/E GAMs exist but their referenced OMTs are absent; normal gameplay reachability is unverified, so missing geometry is not an established campaign blocker.
### Architecture Approach
Preserve explicit application composition and scheduling. `RenderSession` owns persistent native presentation; scene composition connects simulation, script/interactions, decoded resources, visual adapters and audio. Original object retention is different from GPU/audio resource recreation. Recovered components require explicit actor/scene admission, with complete registry/helper lifetime and real callback policies before broad integration.
Keep body/controller/fire/control clocks independent; fresh direct-GAM ordering differs from retained TSK story entry. Maintain source live getter order and separate collision modes from class-specific state. Shared camera eye/aim, animation completion and sound software clocks need their own owners rather than generic resets or transport-driven substitutes. Extend focused modules and tests without inventing a universal engine or solver.
See [ARCHITECTURE.md](ARCHITECTURE.md) for boundary tables, the immediate physical admission gate and solved-versus-open checkpoints.
### Critical Pitfalls
1. **Component parity promoted to live fidelity:** Require actual derived policies, active membership, helper lifetime and task effects; compare ordered full state/events before admitting new actors/scenes.
2. **Symptom fixes erase original behavior:** Preserve legitimate landing bank and the implemented startup ordering correction. Trace the first divergent writer instead of adding leveling resets or importing third-party tuned movement.
3. **Convenient lifecycle/numeric rewrites alter semantics:** Preserve mutable registry traversal, repeated registrations, callback-time scalar reads, retained query state, strict comparisons, winding and evidenced float-store boundaries.
4. **Port-only visuals/audio mistaken for original parity:** Zero Vulkan errors and dummy streams prove narrower properties. Compare identified original frames, clocks, listener states and audible output.
5. **Verification and shipped revisions diverge:** Bind receipts to exact source/package/resource identity; distinguish native Windows, Wine, component execution and whole-original runtime. Never inherit historical coverage for a changed build.
See [PITFALLS.md](PITFALLS.md) for warning signs, mitigation and report references.
## Implications for Roadmap
Use eight dependency-led phases at standard granularity. Each phase should contain small source-recovery → implementation → integrated-verification slices; phase boundaries do not justify delaying necessary audio, camera or reference work.
### Phase 1: Fidelity Baseline and Reference Access
**Rationale:** Later acceptance needs a trustworthy original/platform comparison path and current coverage matrix.
**Delivers:** Revision-specific evidence/discrepancy ledger, original-reference capture route and initial native Linux/Windows scenario matrix; explicit unresolved environment limitations.
**Addresses:** Original comparison, preservation and current baseline provenance.
**Avoids:** Treating probes, startup frames, cross-publish or older packages as full-game reference evidence. Independent source-backed recovery can continue if reference execution is unavailable, but its acceptance gate stays open.
### Phase 2: Movement, Contact and Retained Ownership
**Rationale:** This is the existing stabilization gate before broader gameplay expansion.
**Delivers:** Real derived response/helper/physical-order/shared-reclip contracts, supported live admission, animation/control/camera handoffs and integrated lab → VR04 → lab → outside verification.
**Addresses:** Jimmy movement, source timing, contacts, fresh/retained/RETURN state and route ownership.
**Avoids:** Reopening the solved Carl startup correction, generic resets and premature lab/outside capsule replacement.
### Phase 3: Actors, Hazards and Combat
**Rationale:** Gadgets and campaign scripts depend on real class consumers and actor responses.
**Delivers:** Supported enemy/NPC sensing/action/RNG, damage/health/death/recovery, special contacts and actual task/contact side effects in playable slices.
**Addresses:** Actor/AI/combat and level mechanics foundations.
**Avoids:** Synthetic callbacks and generic patrols being called complete original AI.
### Phase 4: Gadgets, Vehicles and Interaction Coverage
**Rationale:** Expand on recovered actor/lifetime contracts and preserve already-live bounded gadget scenes.
**Delivers:** Remaining original gadgets, all intended consumers and supported modes, activation/cleanup, inventory/energy and transition behavior.
**Addresses:** Remote and other remaining functionality, broader existing gadget/vehicle use and source-supported inputs.
**Avoids:** Fixture/F1-grant demonstrations substituted for normal gameplay acquisition/use or blanket physical admission.
### Phase 5: Campaign, Tasks and Level Completion
**Rationale:** Full progression relies on actors, interactions and gadget consumers.
**Delivers:** All evidenced reachable campaign and optional routes, authored missions/scripts, objectives/collectibles, entrances/exits and final outcomes.
**Addresses:** Full original content and class-specific progression consumers.
**Avoids:** Counting parsed GAMs or rendered levels as playable completion; resolve absent-archive reachability before treating it as a blocker.
### Phase 6: Frontend, Configuration and Persistence
**Rationale:** Complete supported gameplay state must survive real player-facing save/resume and menu flows.
**Delivers:** Original frontend/HUD/options, persisted configuration, runtime save/load and repeatable equivalent resume across supported checkpoints and retained lifetimes.
**Addresses:** Full player workflow beyond debug tools and CLI save operations.
**Avoids:** Binary round-trip mistaken for live load correctness; preserving unknown TSK fields does not establish their gameplay semantics. Add necessary persistence earlier when campaign slices require it.
### Phase 7: Visual, Animation and Audio Fidelity Closure
**Rationale:** Systematic final presentation closure needs representative complete gameplay, while blocking presentation contracts are recovered earlier.
**Delivers:** Matched original/port frames and event/audio timelines; corrected rendering states, pivots, playback, camera/UI details, contextual banks/channels and audible spatial behavior.
**Addresses:** Remaining fixed-function and original presentation/sound differences.
**Avoids:** Modernization, assumed 60 Hz equivalence and transport/API correctness used as fidelity evidence.
### Phase 8: Full-Game Native Acceptance and Local Release
**Rationale:** Only integrated complete journeys can establish final scope and platform claims.
**Delivers:** Current clean standalone Linux and Windows packages, full progression/optional-content comparison, physical audio/input/window checks, original hash verification and discrepancy audit.
**Addresses:** Complete reconstruction acceptance and reproducible local delivery.
**Avoids:** Historical receipts or Wine replacing current native Windows execution; generated packages/original assets remain local while verified source/tools/docs go to Gitea.
### Phase Ordering Rationale
Reference access starts early and comparison grows throughout the work. Movement and lifecycle gates precede expansion; actual actors precede their gadget consumers; these enable campaign and complete persistence. Presentation and audio investigations can run independently with exclusive ownership, integrating as soon as they block a gameplay slice. The final presentation and release phases close cross-cutting differences rather than postponing every fidelity check until the end.
### Research Flags
- **Phases 1–2:** Targeted environment feasibility and deep original source/runtime investigation; complete helper/response/camera/animation contracts remain open.
- **Phases 3–6:** Phase-specific REA/asset/caller recovery is required for real actors, gadget consumers, campaign reachability and frontend/save semantics. Existing bounded implementations reduce work but do not establish remaining policies.
- **Phase 7:** Original render/audio state and playback research is essential; reference captures determine acceptance tolerances.
- **Phase 8:** Existing package/build patterns can be reused without ecosystem re-research. Native platform execution and original comparison are mandatory validation, not assumed standard behavior.
## Confidence Assessment
| Area | Confidence | Notes |
|------|------------|-------|
| Stack | High for repository foundation | Mandated by specification and corroborated by project configuration; installation/current runtime not reverified here. |
| Features | High for full scope; medium for remaining exact behavior | Explicit user/spec scope; detailed remaining behavior still requires original evidence. |
| Architecture | High for current boundaries; medium for proposed phase order | Multiple local reports agree; future dependency grouping is planning inference. |
| Pitfalls | High as recorded risks | Supported by prior divergence/lifecycle reports; this review does not reproduce their experiments. |
**Overall confidence:** Medium for the execution roadmap, with strong documented constraints and explicit unresolved original behavior. Generic provider-classifier LOW results in dimension files do not independently certify or invalidate underlying repository evidence.
### Gaps to Address
- Working whole-original capture environment and repeatable native Windows access remain unverified dependencies.
- Complete physical helper membership/removal/activation, derived soldier/Jimmy effects, shared mutable reclip, camera handoff and animation/sound clocks need focused investigation.
- Full reachable content, original frontend/save callers, contextual audio and per-layer rendering remain incomplete; do not fabricate behavior from resource names.
- Comparison tolerances must be justified per system from original observations; no blanket pixel-perfect or bit-exact whole-game claim is supported.
- Historical reports contain superseded narratives. Prefer dated continuation evidence with exact revision/platform scope before implementation.
## Sources
### Authoritative Scope and Repository Rules
- [PROJECT.md](../PROJECT.md) — user-selected full remaining reconstruction and maximum-fidelity priority.
- [prompt.MD](../../../prompt.MD) — original mission, platforms, preservation and full completion requirements.
- [AGENTS.md](../../AGENTS.md) — current movement priority, REA requirements and Gitea/local-only artifact policy.
### Synthesized Research
- [STACK.md](STACK.md) — existing technology/configuration and verification facilities.
- [FEATURES.md](FEATURES.md) — original-required categories, bounded existing support and acceptance gaps.
- [ARCHITECTURE.md](ARCHITECTURE.md) — ownership/admission dependencies and solved versus unresolved work.
- [PITFALLS.md](PITFALLS.md) — fidelity risks and concrete prevention.
### Underlying Local Evidence Indexes
- [Progress](../../docs/progress.md), [compatibility](../../docs/compatibility.md), [tasks](../../docs/tasks.md) — historical implementation/runtime receipts and current limits.
- [Coverage](../../docs/checkpoint/coverage.md), [implementation ledger](../../docs/checkpoint/implementation-plan.md), [next-work plan](../../docs/checkpoint/next-work-plan.md) — source recovery and admission gates, including later correction updates.
- [Codebase architecture](../codebase/ARCHITECTURE.md), [concerns](../codebase/CONCERNS.md) — current source structure and risks.
- Specialized source/probe/runtime reports are linked beside individual findings in the four dimension files. Their evidence scopes remain binding; this synthesis is not new binary or runtime evidence.
---
*Research completed: 2026-11-12*
*Ready for roadmap: yes, with unresolved verification dependencies retained explicitly.*
+53
View File
@@ -0,0 +1,53 @@
{
"contract": "1.0.0",
"flavor": "core",
"milestone": null,
"phases": [
{
"number": "1",
"name": "Reproducible Fidelity Baseline",
"status": "in_progress"
},
{
"number": "2",
"name": "Faithful Movement and Scene Handoffs",
"status": "pending"
},
{
"number": "3",
"name": "Original Actors, Hazards and Combat",
"status": "pending"
},
{
"number": "4",
"name": "Complete Gadget and Vehicle Use",
"status": "pending"
},
{
"number": "5",
"name": "Complete Campaign and Optional Routes",
"status": "pending"
},
{
"number": "6",
"name": "Original Frontend and Save/Resume",
"status": "pending"
},
{
"number": "7",
"name": "Original Visual and Audible Presentation",
"status": "pending"
},
{
"number": "8",
"name": "Full-Game Native Acceptance and Delivery",
"status": "pending"
}
],
"next": {
"command": "$gsd-progress --next",
"label": "Review prepared Phase 1 checkpoint and pending combined human session",
"reason": "Phase 1 remains open: 7/7 autonomous preparation records, actual acceptance human_needed 0/120; Phase 2 not advanced"
},
"updated_at": "2026-11-13T21:49:00Z"
}
+37
View File
@@ -49,6 +49,43 @@ The broader priority remains Jimmy movement stabilization, with gadgets paused.
JN-Engine native/Godot movement. Use its original decompiler index only as leads,
verified with REA/authoritative originals. See docs/gameplay/jimmy-movement-stabilization.md.
Pair continuation: docs/checkpoint/pair-lifecycle.md records28 complete original/
C# cases and20 VR04 class bindings. OriginalPairCollision is a bounded component,
not live scene admission. Next recover full physical registration/activation and
helpers, real actor responses and shared dynamic reclip before replacing existing
collision. Gated pairs retain contacts; sphere exclusions use the earlier actor.
Both packages identify clean924ad2f; standalone Linux Carl return passes with4
readbacks identical to ea04210. Current Windows is cross-published/resource-
verified; earlier Wine64 runtime evidence belongs to ea04210, native Windows open.
Registration continuation: docs/checkpoint/physical-registration.md and
vr04-generated-bodies.md cover72 records/13 classes,12 original component cases
and21 helper edges. Runtime/packages remain924ad2f. Common append is not deduped;
Jimmy49E guards the whole bridge. Per-node Init/PostLoad visits new registry tails.
Full retained helper membership/cleanup/activation and shared reclip remain open.
Dynamic continuation: docs/checkpoint/dynamic-context.md adds17 complete original/
C# test-only reclip cases and12 captured kernel arguments. Kernel winding is A,C,B
relative to construction; preserve retained hit/last polygon and final local-root
publication. Jeep default deletion eligibility is guarded, full cleanup remains
open. Next nonempty shared static reclip/ordered bodies and real callbacks;
no live pair admission or package change.345 Python checks and539 originals pass.
Populated continuation: docs/checkpoint/dynamic-reclip.md matches14 full original/
C# observations and12 kernel steps. Shared edge/ray math now retains evidenced
float-store boundaries; NodeVisits precedes the geometry gate. No broad x87 or
new actor admission claim. Next real Jimmy/VR04 callback mutations/live getter
timing and retained helper cleanup/order; consult current verification receipts.
The populated correction passes348 Python+2 HUD, all managed projects and36 GPU
checks, plus native Linux Carl/VR04 SDL replays and Windows x64 cross-publish.
All539 originals and924ad2f packages are unchanged; no new Windows execution.
Normal continuation: docs/checkpoint/actor-normal-contacts.md adds30 complete
original/C# snapshots,13 interfaces/182 bindings and5 scalar getter fields.
OriginalNormalContacts is standalone; Jimmy ordinary374 bypasses reflection.
Soldier174 and Jimmy204 endpoints are recorded, not fully executed policies.
Next derived response and retained helper cleanup/activation/order; do not wire
new actors or cache pre-callback radius/flags. Use reviewed relocation operands.
352 Python and targeted body/pair/reclip checks pass, with Linux/Windows builds;
539 originals and924ad2f packages stay unchanged. Latest integrated SDL/GPU
evidence is bf876e9; no new live profile or native Windows verification is claimed.
2026-11-06 continuation: the earlier292 original component cases plus50 derived-
caller cases and body/visual-sync audit supply no extra reset. Startup diagnostics
now observe backgroundLevel1D/Jimmy allocation after an explicit OS repaint
+21
View File
@@ -128,3 +128,24 @@ actual lab bars closed/open passage using the existing provisional swept-sphere
SceneCollision adapter. The latter verifies port integration, not original47BD80
or original runtime behavior. Full edge/vertex sphere response, static reclipping,
door pushing/crushing and native original comparison remain unresolved.
## Shared response continuation — 2026-11-07
[Dynamic context](../checkpoint/dynamic-context.md) now supplies17 complete
original mode2/static-reclip observations and a test-only C# composition. Twelve
captured kernel calls establish A,C,B argument winding relative to the construction
topology above, with the construction normal retained. Do not reverse live
construction topology indiscriminately. The injected live adapter is unchanged.
The original retains hit/last polygon, can invoke a stale static callback after
the dynamic hit, and publishes its local root after callbacks unless inhibited.
Empty-grid tests close that finite ownership contract, not nonempty shared-world
behavior, real actor responses or broad live admission. The source kernel itself
has since been recovered in collision-response/body reports; the older unresolved
wording above describes this report's original implementation checkpoint.
The [populated follow-up](../checkpoint/dynamic-reclip.md) adds14 exact full
observations and12 kernel-step matches, with source-store corrections in shared
edge/ray arithmetic. This closes the populated synthetic reclip contract without
replacing the live injected adapter. Real callbacks, live getter timing and
retained physical/helper order remain the admission boundary.
+25
View File
@@ -5,6 +5,19 @@ SDL3 for platform windowing, input and audio. Linux x64 and Windows x64 are
equally required. Source is `src/GamePort/`; root executable csproj allows
`dotnet build` and `dotnet run` from GamePort. No runtime network dependencies.
Shared collision kernels retain recovered float-store boundaries in edge
projection and ray normalization/hit publication. `StaticCollisionContext` keeps
nearest/last polygon, passes, pre-geometry node visits and actual primitive tests
separate. Dynamic pair/reclip composition remains a test fixture until real
actor callbacks and retained physical order are recovered. See
checkpoint/dynamic-reclip.md; no generic live box solver is implied.
`OriginalNormalContacts` exposes inherited370/374/378 through an actor-owned
accessor interface, keeping full-vector/XYZ setters, fresh Y, damping and heading
impulse distinct. It is not a universal Jimmy callback: Jimmy's ordinary374
override bypasses reflection. Real class bindings and late scalar ownership are
documented in checkpoint/actor-normal-contacts.md; live profile wiring is retained.
`Scooter` is a separate registered C3DJEEP in VR05/LEV1, owning body, wheels,
steering/impact/jump clocks and camera state. Selection summons at the companion;
strict contact transfers raw control. PlayerSceneBinding runs body, player/input,
@@ -93,6 +106,18 @@ composes that static path for ordinary Jimmy flags/contacts and is used in VR04;
the live bridge supplies zero angular velocity, variable source radius60/100 and
separate published160 speed. Lab/outside retain the capsule. Special callbacks,
other original actor pair eligibility and shared dynamic reclipping remain gated.
`OriginalPairCollision` now expresses47A430's ordered physical-list pass and
47B3E0's sphere/exclusion query. It takes live actor callbacks and an explicit
mode2 solver, and preserves contacts when eligibility skips a pair.28 complete
original-component comparisons support it. It is not connected to the grouped
SceneInteractions loop: full registration/activation, real actor responses and
shared dynamic reclip state remain prerequisites. See checkpoint/pair-lifecycle.md.
Registration has separate ordinary registry50999C, physical list695D3C and own
49E flag. Common4623D0/464210 can append duplicates even when49E is already set;
Jimmy42AB50 guards the whole call.479A40 invokes Init before node append, while
46E570 runs Init then PostLoad per node and visits same-pass registry appends.
12 original-component cases support these boundaries; the full VR04 helper/
activation sequence remains open. See checkpoint/physical-registration.md.
Source root and modern feet/sole rendering are distinct adapters; F3 exit still
uses modern capsule occupancy. See checkpoint/collision-body-implementation.md.
The source-root upward ray is supplied separately from the camera debug query:
+210
View File
@@ -0,0 +1,210 @@
# Original normal callbacks and late scalar reads
2026-11-07. Continues [populated reclip](dynamic-reclip.md). Thirty complete
emitted original/C# fixture snapshots now match exact float32 values and event
order. `OriginalNormalContacts` implements the bounded inherited ceiling/wall/
reflection callbacks as a standalone component. Live actor admission and the
current body/profile wiring are unchanged.
## Evidence, layout and class coverage
Canonical Neutron.exe SHA-256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Retained complete REA instruction Evidence:
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
`tools/binary/actor_contact.py` guards17 complete bodies,139 relocation operands,
13 actual VR04 interfaces/182 method bindings and5 scalar getters. Source hashes,
table/file offsets and pointer displacements are local in
`artifacts/actor-contact/native/source.json`. Text offsets below equal VA−400000;
the helper uses actual PE mapping.
| Callback VA / file offset | Owner / complete span |
|---|---|
|42A660 /2A660|Jimmy374, through42A714.|
|43AA40 /3AA40|Player material policy, through43AFE3.|
|472690 /72690|Inherited370 positive-Y response, through47274A.|
|458890 /58890|Inherited374 reflection gate, through4588CD.|
|472750 /72750|Inherited378 reflection/heading impulse, guarded through472970.|
|409590 /9590|Soldier374 override, through4095EE.|
Prior REA pseudocode is reused for472690
(`ev_122849f87121b02fefe6a3a443f75c7f02fee30c59c816b617d30e1f98fc2cff`),
458890 (`ev_2e4ec83ea68f06777162a80ab45793cff068e973dc248556d4a408932d24c85a`)
and43AA40 (`ev_4f2a6aa666451db831efd46f5c587573e22d8072315626b8bc2f844f9c6f0cae`).
The new REA/Ghidra requests for409590 and4098C0 both report unrecognized
procedures. Their complete failures, export and closed-session snapshot are
retained under `artifacts/actor-contact/rea/`; no successful pseudocode is
attributed to them. Existing REA instructions, canonical bytes and new copied-code
execution support the bounded caller findings instead. Earlier unrecognized
42A660/472750 requests were not repeated.
Jimmy game table4A373C selects374→42A660; soldier4C19C4 selects409590;
Rocketship4B25AC selects43E8D0 and its separate370→43EB70. The other10 serialized
VR04 interfaces use374→458890. All13 bind378→472750. Tables and complete-object
displacements are recorded separately: some interfaces are+C8 rather than+C0.
Class bindings do not establish active physical membership or constructor defaults.
The sampled offsets are class-specific beyond the shared base. Soldier608 is an
integer state; Jimmy608 is its controller speed float. Player704 movement mode
is separate from physical collision mode178. The composition fixes178 to0;
the direct `jimmy_mode2` fixture changes704, not box-vs-box collision mode.
Snapshot labels do not define a universal actor structure or shared mode enum.
All13 share these pure live-field getters:
| Slot → function VA / file offset | Interface-relative field / use |
|---|---|
|1D0→4718F0 /718F0|byte13C, per-body geometry permission.|
|1D8→471910 /71910|byte13D, inherited wall-reflection gate.|
|1E0→471930 /71930|byte137, box response inhibition.|
|248→471AD0 /71AD0|float150, wall damping.|
|260→471B30 /71B30|float15C, live radius.|
These are source field/read facts. The native fixtures supply explicit accessor
stubs so they can log reads and inject changes; they do not execute these getters
on constructor-created actors. Scene global4F69E5 is a different owner from1D0.
The constructor/property/Init lifetimes of these fields are not established by a
vtable binding alone.
## Recovered policies and state transitions
**Jimmy:**42A660 forwards to43AA40 on ordinary selections, including−1 and
jetpack3.43AA65 explicitly accepts a null polygon, using material sentinel−1.
Neither ordinary/null contact nor rejected elapsed<=3 material contact reaches
generic reflection378. Test modes0/1/2 and raw-control NULL preserve velocity,
acceleration, angular state and root; no control query occurs in this handler.
VR04 has no special material IDs, as previously established in
[material contacts](collision-contact-callbacks.md). Actual lab/outside hazard,
FENCE and LADDER success remain separate gates.
The additional gadget7/active branch zeros globals4F82BC/C0, tests their prior
two-component magnitude **strictly greater than60**, then invokes complete204
and sets interface1D65.36/48 is equality and issues no204;36/49 does. Our204 is a
record-only endpoint, not the actual429C10 cleanup. This does not change live
grappler behavior or recover every cleanup effect.
**Inherited ceiling370:**472690 reads velocity, clears strictly positive Y
through2C0, then independently reads acceleration and clears its positive Y
through274. Negative channels survive independently. There is no generic
position, movement-mode, jump or control reset. The adapter distinguishes full
Vec4 writes from the wall callback's XYZ setter.
**Inherited wall374/378:**458890 first reads1D8; false returns before velocity
normalization.472750 snapshots horizontal velocity, stores its quick magnitude,
normalizes with the retained quotient and reflects using the supplied normal.
It reads velocity again for live Y, then248 damping, then publishes XYZ through
2C4. Damping is not clamped:1.25 reverses the damped horizontal result.
After publication, the source calls copied OMT `angles` twice: old normalized
horizontal direction, then normalized reflected horizontal direction **before
damping**. It wraps oldHeading−newHeading once at strict±180 and adds angular Y:
```
heading delta degrees × old horizontal quick magnitude × float32(0.001)
```
The factor is4D5FD8; angles import48D108 is
`?angles@OMedia3DVector@@QAEXAAF0@Z`. The source's raw yaw uses the14-bit circle,
e.g.9870 and14706 for the oblique fixture. `OriginalHeading.Angles` is a signed
consumer view; masking yaw with16383 recovers that raw circle. Its behavior is
unchanged; its comment now makes the distinction explicit.
Axis velocity(0,7,−40), normal+Z, damping.25 gives velocity(0,7,30) and angular
Y9.20000076 from initial2. Oblique(30,7,−40) gives velocityX22.5000019 and
angularY−3.31300402. Angular response remains independent of damping. A synthetic
second velocity getter returningY99 proves that the second read owns the
published Y; it is an accessor-order test, not observed spontaneous actor mutation.
**Soldier:**409590 calls generic458890 first. It then checks interface608==10
and, independently of reflection being enabled, calls complete174 with force500
and the supplied normal. Complete table4C1E64+174 targets4098C0. That callee
begins by advancing RNG through509A40 twice, then reaches target/action-dependent
branches. Its complete policy is not executed here. The fixture records174 and
optionally changes scalar fields to test the enclosing caller, not to claim
that the real soldier naturally performs those changes.
## Dynamic composition and late ownership
Three cases invoke complete original47A5E0 with real Jimmy/generic/soldier normal
callbacks. Four more use the soldier's record-only174 endpoint to change one
dependency after its dynamic callback:
| Injected change | Original/C# result |
|---|---|
|Box inhibition=true|Contact remains true; root staysZ15, radius reads[10], no static pass or314.|
|Radius10→20|Reclip reads[10,20,20], rootZ55 against wallZ35; cached10 would give45.|
|Scene geometry=false|Static primitive is skipped but retained polygon still gives a second normal callback; rootZ20.|
|Sphere42C=true|Static force flag is visible to reclip; rootZ45, radius reads[10,10,10].|
Static callbacks can therefore run the full generic/soldier chain again. In
these fixtures, the second reflection gives velocityZ−22.5 and angularY3.80000067.
The final local root still publishes after callbacks. There is no added implicit
context reset or root-changed guard.
The C# dynamic composition remains test-only. Its static getters are fixed
between primitive passes; the fixture records repeated identical radius reads
before the sole terminal callback. This is not a reusable live getter/reentrant
dispatcher, linked-list mutation policy or proof of real actor registry ordering.
## Probe correction and implementation boundary
The initial numeric relocation scan selected bytes4095BE..C1 (`8B C4 68 00`)
spanning `mov eax,esp` and `push500`, misreading them as pointer68C48B. It also
selected other cross-instruction sequences. This corrupted the **private probe
image**, causing a derived-dispatch fault. Those partial runs are invalid source
behavior evidence and are retained as diagnostic failures only. Originals were
never patched. The corrected generator uses37 individually reviewed callback
operands within complete REA instructions:139 total rather than152. A regression
explicitly rejects4095BE and guards the original seven bytes. The final30-case
capture exits0 with all source/probe hashes verified.
`OriginalNormalContacts` and `IOriginalNormalBody` preserve the recovered getter/
setter order, XYZ/full-vector distinction, reflection and angular tail. The
standalone component is not substituted into the live Baseball, Jimmy or NPC
profiles. Zero horizontal normalization remains an explicit unsupported source
arithmetic boundary; the component throws rather than silently admitting a new
policy. A disabled reflection gate returns before that boundary. General x87,
arbitrary normals and zero/degenerate cases are not certified by these fixtures.
`tests/GamePort.ActorContactTests` keeps30 fixed snapshots and can compare the
generated native observations with `--native`; `--dump` plus the Python helper's
`--managed` produces complete exact-float32 differences. Snapshots include roots,
velocity/acceleration/angular XYZW, two modes, marker/tether, derived endpoint
calls/arguments, flags, radius samples, raw angle arguments/results, context
counters/limits and the full emitted accessor event order. Jimmy no-effect paths
and the two derived endpoints are bounded fixture logic, not complete new Player,
grappler or soldier implementations.
## Next chunk
Recover the soldier174 policy and helper cleanup/activation/physical order across
LOAD/RETURN; retain special Jimmy material and gadget gates. The next response
adapter must preserve post-callback1E0, live radius/42C and per-node scene-geometry
ownership, and may admit only explicitly supported actor states. Keep lab/outside
capsule and current VR04 static body while those dependencies remain. Final tests,
build identities and runtime limits are recorded in progress.md/compatibility.md
and `artifacts/actor-contact/validation.json`.
Reproduce after preparing and fully copying the disposable Wine prefix:
```sh
python3 tools/binary/actor_contact.py ../Original --output artifacts/actor-contact/native
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wno-unused-function -o artifacts/actor-contact/native/probe.exe artifacts/actor-contact/native/actor_contact_probe.c
python3 tools/recon/reference_capture.py --asset-probe --probe-executable artifacts/actor-contact/native/probe.exe --probe-success ACTOR_CONTACT_COMPLETE --seconds 45 --output artifacts/actor-contact/probe
python3 tools/binary/actor_contact.py ../Original --output artifacts/actor-contact/native --capture artifacts/actor-contact/probe
source scripts/env.sh
dotnet run --project tests/GamePort.ActorContactTests -- --native artifacts/actor-contact/native/observations.json
```
Normal response is separate from pair enter/stay/leave notifications and their
game/task effects; those real consumers remain an admission gate too. In
particular, an inhibited position response does not cancel pair membership.
Verification:352 Python checks,30 native/fixed managed snapshots,5 sphere groups,
11 static groups,20 ordinary-body groups,100 complete body-ownership comparisons
plus6 bounded state cases,28 pair cases,17 prior context cases and14 populated
reclip/12 kernel steps pass. Linux Debug builds with zero warnings/errors;
Windows x64 self-contained cross-publish succeeds. All539 originals and both
924ad2f packaged DLLs/BUILD-INFO remain unchanged. No new SDL/Vulkan or Windows
execution is claimed; the latest integrated render/native SDL evidence belongs
to bf876e9. This unused component does not change live profile wiring.
+8 -1
View File
@@ -10,7 +10,7 @@ object identity can survive in registry50999C.46E131 explicitly clears surviving
interfaces'49E registration flag. Jimmy PostLoad4238B4 invokes interface2C→42AB50:
false49E jumps to4623D0 InitPhysics. Identity retention is not physical-list retention.
4623D0 invokes base458910 (470A00 allocation/49E=true), copies current render XYZ
4623D0 invokes base458910 (one-time470A00 logging/49E=true), copies current render XYZ
complete44/48/4C through16C→471630, copies angular-unit Euler through174→4716D0,
then calls479A40.479A65 invokes interface150(0,0,0);479A6F invokes Init28 AGAIN,
resolving to Jimmy437890. Only then does it append a12-byte body-list node with
@@ -19,6 +19,13 @@ final control preparation have their own order; registration's Init is not a
blanket post-placement reset. Existing retained scalar conclusions remain bounded
by the closed437890/generic Init chain, not by an assumption that Init runs once.
Follow-up: [physical registration](physical-registration.md) executes12 bounded
original registration/loader cases.470A00 is a logging hook, not an allocator;
the12-byte body node is allocated inside479A40. The common polygon/sprite bridges
can append repeated actor pointers; Jimmy's outer49E guard supplies the distinct
skip boundary. The per-object Init/PostLoad order and same-pass registry appends
are now covered by original-component execution, not solely static reading.
| REA routine | Evidence ID |
|---|---|
|4623D0|ev_d60cfc7d2ff8266e19176052e1466ba98f09e7b10b92db828566fbc28d36d281|
+38 -2
View File
@@ -1,5 +1,29 @@
# Core architecture coverage map
2026-11-07 normal callbacks: [actor contacts](actor-normal-contacts.md) adds30
full emitted original/C# snapshots (S/P/M),13 interface/182 method bindings and5
pure scalar getter fields. Inherited ceiling/reflection/angular response is a
standalone component; Jimmy's ordinary374 override stays separate. Late scalar
reads are tested with explicit injected endpoint changes. Soldier174/Jimmy204
full policies, retained helper order and live scene binding remain open. No new
port-render/original-game/native Windows runtime coverage is claimed.
2026-11-07 populated follow-up: [dynamic reclip](dynamic-reclip.md) adds14 full
original/C# comparisons and12 kernel-step matches (S/P/M). Real synthetic static
walls/ceiling now exercise shared nearest, retries,370/374 order and primitive
mode. Kernel arithmetic corrections follow captured divergences and original
float-store boundaries; no numerical tolerance was added. Actual actor callbacks,
post-callback flag/radius ownership and retained helper order still gate live pairs.
2026-11-07: [dynamic/shared context](dynamic-context.md) adds17 complete original/
C# test-composition cases and12 captured kernel argument matches (S/P/M).
Hit/last-polygon retention, old static callback and final local-root publication
are recovered under empty-grid/non-reentrant fixtures. Original kernel A,C,B
arguments differ from construction topology; final position alone hid that error.
Jeep's default deletion predicate is guarded; full active cleanup remains open.
Live collision, nonempty shared reclip, real actor callbacks and retained helper
order remain gated. No new R/whole-original/native Windows coverage is claimed.
2026-11-06 TSK-entry correction: [menu/player lifetime](../gameplay/main-menu-player-lifetime.md)
establishes backgroundJimmy construction and reuse before the first playable
story scene. Input is now after Jimmy for that TSK path, while direct fresh-GAM
@@ -61,20 +85,32 @@ payload ordering.100 new complete original comparisons and six callback-state
comparisons pass. Special callback mechanics, actor mode persistence and scene-wide
dynamic/shared context remain separate gates; lab/outside capsule is preserved.
[Ordered pair lifecycle](pair-lifecycle.md) adds28 complete original/C# component
comparisons: physical-list pair order, one-sided sphere exclusions, gate retention,
callback-mutated roots/membership and enter/stay/leave. The component has explicit
mode2 injection and is not admitted to live scenes. VR04's6 inspected actor records
and20 bindings do not yet constitute the full physical/helper registration list.
[Physical registration](physical-registration.md) now inventories all72 VR04
records/13 actual interfaces and executes12 original registration/loader cases.
Common append versus Jimmy49E guard, nested Init and live per-object registry
traversal are verified.21 helper edges/12 RTTI identities are catalogued; actual
retained helper membership, deletion/activation and shared reclip remain open.
| ID / system | Recovered contract / anchors | Port implementation | Evidence / remaining gap | Next bounded action |
|---|---|---|---|---|
| LOOP | Viewport47E4F0 physics before registry473740, including input44DF80; second sync473770; construction order and selective retained-character/new-game ordering. Separate engine morph clock. | Player now integrates prior body state, then fresh input/player/fire or retained player/fire/input. Uncontrolled body/fire now continue while movement/input are gated. Other systems remain grouped; fixed60Hz policy. | S/M/R. Controlled player partial order implemented; bounded raw-owner preparation implemented; full wrapper/registry/cadence open. | C3 continue other callbacks and morph/control phases; C4 support/response remains separate. |
| INPUT | Game interface+8C slot3C4→44DF80→475A70 reads controlled5099E4 and calls3CC; Jimmy interface+C0→426030. | SDL arrows/jump aliases; control gate, modern debug override; mouse/controller incomplete. | S/M/R, user Windows route. Input occurs in object traversal after physics; device sampling/focus and latency open. | Trace event pump, key/mouse and focus gates alongside retained registry order. |
| MOVE |437940/439900 ground/air;479D20 impulse→acceleration→gravity; authored114→26C body speed separate from controller608. | Body/fire continue without control; input/controller gated. VR04 uses ordinary source static body and variable radius; lab/outside capsule retained. Fresh/retained order and overhead wrapper explicit. | S/P/M/R. Source body references/phase checks and native VR04 flight pass; complete registry/base/transform/cadence open. | Continue dynamic/special C4 contracts and C3 base transforms; preserve published speed ownership across preparation/Init. |
| JET |437F90 controller;421FB0 effect; fresh constructor order places fire after Jimmy, both after global physics. States0..5, hold>.4,8s, energy. | Explicit state table with post-collision effect ticking and VR immunity. | S/M/R. Fresh same-pass countdown recovered; retained child lifecycle, sound and expiry→animation open. | Trace retained Jimmy/fire resets and phase end events before scheduler integration. |
| COLL |479D20/47BD80 body;47B4B0 FIFO grid/retries;370/374/37C; signed material IDs; separate160 friction; radius60/100 and support/suppression. | VR04 uses ordinary source static body/support/friction; lab/outside keep24-unit capsule. Root+150 wrapper live for route. Dynamic response remains provisional. | S/P/M/R. Ten original kernel, seven dispatcher, ten body references matched in managed composition;20 body groups and native/headless VR04 replay. Special/dynamic classes and visual transform open. | C4: recover original actor physical/pair eligibility and shared dynamic context; lab/outside need160/164/FENCE/LADDER before solver expansion. |
| COLL |479D20/47BD80 body;47B4B0 FIFO grid/retries;370/374/37C; signed materials/friction; radius60/100;47A430 ordered pairs/47CA90 one-sided sphere exclusions. | VR04 uses ordinary source static body; lab/outside keep24-unit capsule.28-case pair component remains separate; live dynamic response provisional. | S/P/M/R. Prior kernel/dispatcher/body comparisons and native VR04 pass;28 complete pair observations now match. Real actor callbacks, full physical list and shared reclip remain open. | C4: complete VR04 physical registration/activation/helpers, then shared dynamic context; lab/outside need160/164/FENCE/LADDER before solver expansion. |
| ANIM | Engine morph10002DB0; linear interpolation10002F9A; game logical→OMT sync4624B0. | ASE sample timing, unconditional loop closure, pose/action aliases,1/60 advance. | S/P/M/R. Playback flags, rate, completion callbacks, transition order open. | Recover one-shot/loop/end notifications before more aliases. |
| SCRIPT | Source AI/CAM/MCA dispatch and chains; task45F990 objective406F50 BEFORE records BEFORE per-entity424. | Pre-assignment objective selection and per-actor Carl override implemented; bounded synchronous director. | S/M/R. Script callbacks recovered for route; generic class coverage and reentrancy incomplete. | Continue other class-specific callbacks and reentrancy under the recovered owner/phase boundaries. |
| CONTROL | Global5099E4 null during valid CAM/MCA; PlayerControlled completion target; DEFAULT447D..447F restores camera/UI/music. | Director raw ownership plus explicit debug effective override; eligible player body/fire continue; only input/controller tail is gated. | S/M/R. Raw/effective control and ordered preparation are implemented; full base/class wrappers and scheduler remain incomplete. | Continue full wrapper/base and collision contact phases around deferred LOAD. |
| CAMERA | Shared viewport eye is recaptured by ground/air follow after scripts; strict>1000 DEFAULT snap; aim uses pre-update eye; source ray/gain and per-level far planes. | Static source query integrated for the three route scenes; other scenes use provisional sweep. Separate chase/script eyes and merged clip maximum remain. | S/M/R. Handoff source bytes/projections recovered, not implemented; full follow/input/quantization and visual comparison open. | C5 shared viewport eye/aim and DEFAULT transition; preserve source phase boundary. |
| AUDIO | CAM416776..E1 stops music; DEFAULT447F12..45 restarts; bank696008 / gate4F8434; handle47D890 polls inherited software duration and repeat+30. | Separate SDL streams, floating-file-duration cutscene completion, independent per-file SFX. | S/M/R (dummy streams). Source duration/allocation/play-failure/bank/attenuation lifecycle incomplete; speakers/native Windows timing not verified. | C6: explicit bank owner and software channel-clock tests; SDL queue-empty is not the source oracle. |
| UI |406F50 selector/timer;4043D9 controlled clock;407070/O edge;404D97 practice resume.44 objective flags distinct from selector. | Timed objective subset, modal practice, modern UiViewport/debug. | S/M/R. Other flags/gadgets/highlights/cursor/energy/layout transitions open; source widescreen not recovered. | Keep modern scale policy separate; recover UI dispatcher/mode gates before expanding. |
| LOAD | Deferred scene request; selective reuse; Init stored+11→live+139; Jimmy/Goddard retained. Physical49E clears and re-registration repeats Init before STRT placement. RETURN root/flags and28→40C. | Reconstructed scene with retained input order and bounded mode/hold/fire; app-owned presentation. | S/P/M/R. Physical registration chain source-guarded; full helper/body allocation/order and fades remain.50988A is editor R input. | Integrate physical list/helper traversal alongside C4; other gadget/level branches remain gated. |
| LOAD | Deferred request/selective reuse; Init stored+11→live+139; retained Jimmy/Goddard.49E clears; registration repeats Init before STRT. Per-object28→40C and same-pass appends; RETURN root/flags. | Reconstructed scene with retained input order and bounded state; app-owned presentation. | S/P/M/R.12 original registration/loader cases now pass; all72 serialized VR04 records mapped. Helper lifetime/activation and full ordering still open;50988A is editor R input. | Close helper reuse/removal and physical sequence alongside C4; other gadget/level branches remain gated. |
| INVENTORY | PostLoad common prefix enables eight owned gadgets4→1, then VR01..08 disables1→4; full tail re-enables the practice gadget. LV1B disables1/7; other wire values preserved. | Availability pass now applied at level entry and verified across TSK tutorial/return; snapshots preserve raw values. | S/M/R. Full selected-gadget/UI and other level tails remain incomplete; bounded route mode/hold/fire carry is implemented. | Keep availability separate from ownership, task changes and arbitrary state carry. |
| SAVE | TSK45FEE0 writer /4603F0 reader; records, arrays, return strings, stored departure root; queued460E70→460EA0. | Original-format round-trip and CLI save, scene snapshots; no full source save UI/load lifecycle. | S/M. Source reader duplicates matching task callback then all-entity420 post-task hook; this is distinct from Jimmy placement PostLoad423A90. Current fresh-director path differs. | C7 after C1/C2; test repeated callbacks before adopting loader behavior. |
| CHECKPOINT | Pickup42AF00 stores+1E38 root/+1E48 level separately from+9A8 RETURN root. | Capture exposed, not used for return; source capture consumers unknown. | S/M. Do not interpret as death/respawn until read consumer found. | Track unresolved consumer; no speculative gameplay. |
+156
View File
@@ -0,0 +1,156 @@
# Dynamic box response and shared static context
2026-11-07. Continues [pair lifecycle](pair-lifecycle.md) and
[physical registration](physical-registration.md). This checkpoint executes the
complete original mode2 box query and composes existing C# source kernels in a
**test fixture**, without admitting dynamic pairs to live gameplay.
## Evidence and scope
Canonical Neutron.exe SHA-256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
REA instruction Evidence:
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
New REA/Ghidra mode2 pseudocode:
`ev_76827fca086933b7c48a9036a5a4a0a0f86d714935de6373eca4a3530fd231c5`.
Jeep PostLoad4217D0:
`ev_72e727e980c8ad114b46c1f23905088233e2925ff8bf8a9420d3b81bddccda27`.
The request for teardown46DFF0 remains an unrecognized-procedure error; no full
cleanup decompilation or execution is claimed. Complete replies, export and
closed-session snapshot are local under `artifacts/dynamic-context/rea/`.
`tools/binary/dynamic_context.py` guards11 copied bodies and102 relocated
operands, including the complete47A5E0..47B3DC query/switch-table span
(file7A5E0, lengthDFC, SHA-256
`9bb2c187d12f73a73f4ac2f31e19072d9010f919ce93fb6884e2be35b2fac894`).
It uses the prior dispatcher/kernel mapper and a copied original OMT2.dll.
Actor getters, contact callbacks, root setter and box point transform are
synthetic. The source static grid is empty, with a deliberately seeded old
polygon. This is original component execution under isolated Wine32, not an
original scene, live Jimmy callback or native Windows observation.
## Recovered call order and ownership
Text file offsets below equal VA−400000; the tools verify actual PE mapping.
The box query is reached from ordered pair47A430. Its other actor geometry gate,
source radius broadphase and other-mode2 shortcut precede triangle processing.
Those early paths preserve the seeded nearest/hit/last-polygon context.
| Original VA / file offset | Recovered operation |
|---|---|
|47AB3F / 7AB3F|Write sphere radius to edge limit5CFBE0.|
|47AB4B / 7AB4B|Set nearest face695D5C to−1. Do not clear hit5CFBE8 or last polygon695D4C.|
|47B277 / 7B277|Call47BD80 for each of12 transformed box triangles, updating the shared nearest state and local candidate.|
|47B29B / 7B29B|Each accepted kernel result invokes sphere virtual374 with a **null polygon**. This is not a normal-Y choice between370/374.|
|47B2EF / 7B2EF|Read box virtual1E0 after triangle callbacks. If inhibited, return contact without world reclip or sphere root setter.|
|47B364 / 7B364|Call47B4B0 from source previous root with candidate−previous displacement; edge checking is disabled. Reuse current hit/nearest/last state.|
|47B399 / 7B399|Publish the clipped local candidate through sphere314 after the static callback; there is no live-root comparison before publication.|
After all triangles, face−1 and edge>=radius means no contact. An accepted
query resets the nearest limits even when it misses, while old hit and last
polygon survive. The chained fixture verifies this across two successive calls.
Its callback/setter/pass counters are cumulative, not reset for the second call.
With an empty grid,47B4B0 can still issue its terminal callback for the seeded
old polygon, including when static geometry4F69E5 is disabled. An uninhibited
dynamic hit therefore gives a null-polygon dynamic callback followed by an
old-polygon static callback. A callback's live-root mutation is overwritten by
the final local candidate; inhibition leaves that mutation intact, including W2.
Do not replace this with a root-changed suppression rule.
The global primitive mode695D74 is a separate owner.47B6F4 sets it to1 around
an individual static primitive when sphere42C is set, then47B742 clears it.
Our empty-grid fixture starts and ends with mode0, including42C=true. That case
does not establish general mode reset, recursive queries or arbitrary callback
mutations. Parent static-body479D20 normally initializes its own query state;
the later dynamic phase can see another body's last polygon. Explicit seeding
tests state retention, not which real actor supplied it in a complete frame.
## Kernel winding: a meaningful failed comparison
The first C# composition used `DynamicSceneCollision.Triangles` construction
order directly. Its first fixture reached the same root(0,0,20,1), but reported
face−1/edge5 instead of original face40/edge10. The passing interpretation uses
kernel arguments **A,C,B**, with the normal retained from construction A,B,C.
To test that interpretation, the generated private mapped kernel entry is
instrumented to record its first12 triangle/normal arguments. The hook restores
the original five bytes before invoking the actual source kernel and reinstalls
it afterward. All12 complete arguments match the C# fixture; each captured
cross(B−A,C−A) points opposite its supplied normal. The original files and copied
on-disk EXE are not patched. This validates the kernel boundary, not a blanket
change to construction topology or the provisional live collision adapter.
The intentionally wrong construction-winding run remains a failing diagnostic
(`--construction-winding`), with its first divergence and nonzero exit saved in
`artifacts/dynamic-context/construction-winding-failure.json`. Matching final
positions alone would have missed the shared-state error.
## Implemented comparison and verification
`tests/GamePort.DynamicContextTests` composes the existing source sphere and
static kernels with this bounded control flow. No production solver or gameplay
actor is added. Fixed references run without generated artifacts; `--native`
also compares every emitted field and all12 captured kernel arguments.
The17 observations cover old/null polygon, inhibition, geometry-off and
broadphase rejection, other-box overlap/rejection, triangle miss, root-mutating
callbacks with/without inhibition, static-geometry-off,42C force-static flag,
Y45 face contact, translated/90-degree box and a two-call hit→away sequence.
Each compares contact, XYZW, nearest face/edge/hit, retained polygon identity,
dynamic/static callback counts, setter count, static passes and global mode.
The Y45 case is not proof of a successful geometric edge/corner response.
Verification: all17 full native/C# observations and12 kernel arguments match;
fixed references pass;345 Python tests,11 static-dispatcher groups,10 dynamic-box
groups and28 pair lifecycle cases pass. All539 original files remain unchanged.
Both packaged DLLs and BUILD-INFO remain identical to the924ad2f baseline.
No new GPU, audible, whole-original or native Windows comparison is claimed.
Reproduction from GamePort (probe execution uses a separate copied game):
```sh
python3 tools/binary/dynamic_context.py ../Original --output artifacts/dynamic-context/native
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wno-unused-function -o artifacts/dynamic-context/native/probe.exe artifacts/dynamic-context/native/dynamic_context_probe.c
python3 tools/recon/reference_capture.py --asset-probe --probe-executable artifacts/dynamic-context/native/probe.exe --probe-success DYNAMIC_CONTEXT_COMPLETE --seconds 12 --output artifacts/dynamic-context/probe
python3 tools/binary/dynamic_context.py ../Original --output artifacts/dynamic-context/native --capture artifacts/dynamic-context/probe
source scripts/env.sh
dotnet run --project tests/GamePort.DynamicContextTests -- --native artifacts/dynamic-context/native/observations.json
```
## Helper teardown follow-up
`tools/binary/helper_teardown.py` guards13 sites and5 Jeep bindings at table
4A2AEC (fileA2AEC). Constructor42129A (file2129A) pushes1, and4212A8 calls
470F40: authored predicate+11 is stored and dispatched through204 to live+139.
Generic Init4705B3/4705BC restores the authored predicate through8C→204.
Table slots8C/200/204 target470F30/4719B0/4719C0. Default Jeep is therefore
eligible for ordinary deletion, unlike the retained Jimmy default; pointer
clearing in Jimmy PostLoad is not itself evidence of a retained old Jeep.
Teardown re-reads200 at46E032,46E06F and46E0AC (files6E032/6E06F/6E0AC),
with virtual20/34 cleanup between reads, then marks+6 at46E0CA before the
473710 sweep. Jeep20 targets4213E0→462390;34 targets458C50, whose game+4B0
condition can invoke430. Callback/active-vehicle mutations can affect those
re-reads. This closes the **default eligibility** question, not complete active
cleanup, child deletion, sweep execution or final retained registry order.
## Remaining admission gates and next chunk
Follow-up: [populated reclip](dynamic-reclip.md) now executes real synthetic static
walls/ceiling and matches14 full observations/12 kernel steps after directly
evidenced rounding corrections. The first gate below is closed for that bounded
composition; real actors, ordered-body provenance and reentrancy remain separate.
1. Exercise static geometry after a dynamic hit, rather than only empty-grid
reclip. Compare shared nearest/last ownership across two real primitive
candidates and ordered bodies, including face/edge ties and flag transitions.
2. Trace actual Jimmy/door/VR04 actor callbacks and their root, mode, activation
and polygon requirements. Synthetic callbacks do not establish these owners.
3. Finish constructor-only helper re-entry/deletion and physical order across
ordinary LOAD/RETURN, including cleanup mutations between the three reads.
Then implement a bounded shared-context response component and integrate only
the evidenced VR04 actor set. Keep lab/outside capsule and current playable
movement while these gates remain. Preserve ordinary landing bank; this report
adds no rotation reset and does not reopen the completed TSK-entry order fix.
+153
View File
@@ -0,0 +1,153 @@
# Populated dynamic reclip and recovered rounding boundaries
2026-11-07. Continues [dynamic context](dynamic-context.md). The complete original
box query now runs against a populated synthetic static grid. Fourteen full
observations and12 diagnostic kernel steps match the C# composition exactly as
parsed float32 values. This checkpoint corrects directly evidenced shared math;
it does not admit dynamic pairs or new actors to live gameplay.
## Evidence and runtime boundary
Canonical EXE SHA-256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
The generator reuses the prior11 guarded bodies/102 relocations, including
47A5E0,47B4B0,47BBB0,47BD80,469880 and469B70. Body hashes, PE offsets and copied
OMT2.dll identity are retained in `artifacts/dynamic-reclip/native/source.json`.
REA evidence is reused, not regenerated for an unchanged question:
| Evidence | Source |
|---|---|
|`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`|Complete original instruction listing; decisive float stores/call order.|
|`ev_76827fca086933b7c48a9036a5a4a0a0f86d714935de6373eca4a3530fd231c5`|47A5E0 mode2 pseudocode, retained under dynamic-context/rea.|
|`ev_f39128dafc2a3a20b5768613ce22b3c3168fe8653908837d92ad9a69ef5f2ad8`|47B4B0 static traversal/retry; see collision-grid-traversal.md.|
|`ev_5e39f2668d04b1fdd2c91b298a28413327dc3879e6b8bbffe0a14bc1dcbc1128`|4695B0 nearest-edge pseudocode; assembly resolves intermediate stores.|
`tools/binary/dynamic_reclip.py` generates a bounded harness containing copies of
the existing probe sources without their mains. The new executable calls copied
source bodies with synthetic box/sphere getters, point transforms, callbacks and
grid nodes. It never invokes the original entry point. An instrumented private
mapped47BD80 counts primitive mode and captures12 steps only for the skew case;
the hook restores original entry bytes for each real kernel invocation. Original
files and on-disk copied EXE remain unpatched. This is Wine32 component execution,
not full original gameplay, live actor callbacks or native Windows verification.
Final execution is under `artifacts/dynamic-reclip/probe-verified/`, with no
network or Original-directory mount. An earlier overlapping prefix preparation
produced no observations; a separate completed prefix then exceeded the12-second
startup bound while still running. The45-second bound completed successfully.
Incomplete attempts and intermediate comparisons are preserved separately and
are not counted as source observations. One initial ceiling triangle missed the
intended path; the final fixture covers it and proves a real370 callback.
## Shared state through populated static geometry
The box is identity-oriented with cube(−50,−50,−10)..(50,50,10), radius40;
sphere radius10, previous(0,0,50), current(0,0,15). The dynamic face query normally
gives rootZ20, face40, edge10 and hitZ10. A separate old polygon99 is seeded.
| Fixture | Original result / dependency |
|---|---|
|Static wallZ35|Nearer static face wins: rootZ45, face15, hitZ35, last0;2 passes/4 cell-list visits.|
|WallZ10 at equal dynamic face|No replacement: rootZ20, face40, old polygon99 survives.|
|Far wallZ0|No replacement; old polygon99 still supplies the terminal callback.|
|Walls35→30 and30→35|Both end atZ45/face15; winning polygon is0 or1 according to its identity.2 passes/8 visits.|
|Root-mutating callbacks|Final local root still overwrites the mutation, now toZ45.|
|Box response inhibited|Only dynamic callback; no static visits, passes or setter.|
|Static geometry disabled|2 node visits, no static kernel calls; retained old-polygon callback still occurs.|
|Sphere42C enabled|12 dynamic kernel calls in mode0,4 static kernel calls in mode1, terminal callbacks/setter in mode0.|
|Old ceiling polygon|No accepted static face, but retained normal−Y invokes370 rather than374.|
|Real ceilingY35|Root(0,25,23.7499962), face43.7501259, last1;370 follows dynamic374, then314;2 passes/12 visits.|
|Repeated query without context reset|Nearest limits reset per dynamic query; last polygon and all callback/pass/visit/kernel counters persist across calls.|
The real ceiling fixture starts currentY30 and uses a triangle covering positiveZ.
The skew fixture instead starts previousY−30/currentY0 and registers the original
wall/ceiling triangles without claiming that the ceiling accepts. Its dynamic
edge→face sequence is the numerical diagnostic below.
The callback event string records virtual slot, polygon identity and global mode.
Dynamic callbacks use374/null. Static callback370/374 selects from the **retained
last polygon's normal**, and final314 follows callbacks. Every observation compares
contact, rootXYZW, face/edge/hitXYZW, last identity, callback/setter/pass/visit counts,
global mode, mode0/1 kernel counts and complete event order. Sequential queries use
the same synthetic actor; they do not prove registry order across real actors.
## First divergences and supported corrections
Text offsets are VA−400000; the source tools check actual PE mapping.
1. **Visited nodes and primitive tests have different owners.** At47B6A8..47B6B9
(file7B6A8),695D70 increments before4F69E5 is checked. The first managed
comparison reported0 visits versus original2 with geometry disabled.
`StaticCollisionContext.NodeVisits` now counts before that gate, while
`TriangleTests` continues counting only dispatched primitives. This is a
diagnostic-state correction, not a new collision response.
2. **Segment projection X retains its product.** The skew case's first differing
kernel is zero-based6: input(0,0,15,1) matches, but source hitX is
`8.68490133e-7` and managed hitX was0.4699A0..4699DE (file699A0) retains
directionX×projection until adding originX; Y/Z products have intermediate
float stores. `OriginalSphereResponse.NearestOnSegment` now follows those
separate boundaries.47C194..47C1D0 likewise retains X/Z products through the
final edge-root subtraction. This makes the complete step6 output match.
3. **Ray normalization and hit publication retain intermediates.** The next
mismatch is step7's face hit.469BE5..469C09 (file69BE5) uses OMT's returned
quick-magnitude quotient directly for reciprocal normalization; a float return
inserted an extra rounding.469DF0..469E13 (file69DF0) stores hit coordinates
after multiply+add. `OriginalBodySupport` now retains the magnitude intermediate
as double for these ray callers, and delays coordinate rounding until that
final store. Its public float QuickMagnitude result and caller-owned nearest
reduction remain float. All14 final observations and12 kernel steps now match.
Intermediate failure logs and experiment snapshots remain local, including
`managed-initial.log`, `managed-after-visits.log`, `projection-experiment.log`,
`ray-experiment.log` and `wide-experiment.log`. No epsilon or near-zero clamp was
added. The comparator parses native9-digit and managed shortest decimal spellings
back to float32; distinct values remain failures. Double intermediates reproduce
these fixtures, not every x87 extended-precision or table-boundary case.
## Implementation and validation
Runtime changes are confined to the shared support/ray and sphere kernels plus
the additional static visit counter. `tests/GamePort.DynamicReclipTests` keeps
fixed numeric references and all12 kernel steps for artifact-free normal runs;
`--native` checks the complete generated observation file, and `--dump` supports
future differential tracing. Python tests guard instruction boundaries, safe
generation and exact-float comparison semantics. Both probe source and expected
data are test fixtures, not new actor implementations.
`scripts/test.sh` exits0 with348 Python+2 HUD Python checks, all managed projects,
36 Vulkan/render checks with zero validation errors, audio lifecycle and539
original hashes. Debug build has zero warnings/errors. Native Linux SDL Carl
control (first neutral input/300 idle ticks) and VR04 jetpack steering/resize
also pass with zero validation errors. Windows x64 self-contained cross-publish
succeeds to a separate artifact directory. Existing packaged DLLs and BUILD-INFO
remain identical to924ad2f; no new package or Windows execution is claimed.
Reproduction after **waiting for disposable prefix preparation to complete**:
```sh
python3 tools/binary/dynamic_reclip.py ../Original --output artifacts/dynamic-reclip/native
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wno-unused-function -o artifacts/dynamic-reclip/native/probe.exe artifacts/dynamic-reclip/native/dynamic_reclip_probe.c
python3 tools/recon/reference_capture.py --asset-probe --probe-executable artifacts/dynamic-reclip/native/probe.exe --probe-success DYNAMIC_RECLIP_COMPLETE --seconds 45 --output artifacts/dynamic-reclip/probe-verified
python3 tools/binary/dynamic_reclip.py ../Original --output artifacts/dynamic-reclip/native --capture artifacts/dynamic-reclip/probe-verified
source scripts/env.sh
dotnet run --project tests/GamePort.DynamicReclipTests -- --native artifacts/dynamic-reclip/native/observations.json
```
For a complete field/step difference report, run `--dump` to a local file, then
pass that file as `dynamic_reclip.py --managed <file>` with the same output path.
The generated comparison explicitly records every mismatch; it does not turn
nearby values into parity. Final platform/suite receipts are in progress.md and
compatibility.md; local identities/results are in artifacts/dynamic-reclip/.
## Remaining gate and next chunk
Populated-grid composition now supports a bounded shared-context response. Before
live admission, recover actual Jimmy/VR04 actor callback mutations, live flag/
radius reads after callbacks, constructor-only helper re-entry/cleanup and real
physical registration order across LOAD/RETURN. Reentrant global-mode and grid
mutation, extreme coordinates/degenerate inputs and general x87 boundary behavior
remain open. Preserve lab/outside capsule and the existing VR04 static-only actor
set. Next focus on real actor callback ownership, then implement the bounded
response adapter against those interfaces. No movement tuning, angle reset,
gadget feature or unsupported dynamic actor is introduced here.
+33
View File
@@ -23,6 +23,39 @@ Windows comparison remains a step5 obligation, not a completed claim. Step4's
derived-caller/body-transform investigation is also recorded, with broader
dynamic/special contacts and playback dependencies still open.
Step4 continuation: [ordered pair lifecycle](pair-lifecycle.md) now has28 complete
original/C# comparisons,6 new REA pseudocode results and20 guarded VR04 class
bindings. The pair component is verified separately; scene admission remains
gated on full physical registration/activation, real callbacks and shared reclip.
Registration continuation now covers all72 serialized VR04 records/13 interfaces
and12 original registration/loader cases, plus21 guarded helper edges. This closes
the bounded common registration and per-object loader contracts, not complete
fresh/retained helper membership. See [registration](physical-registration.md).
Next resolve helper re-entry/deletion/activation and dynamic shared reclip state;
keep live scene admission unchanged until those dependencies close.
2026-11-07 continuation: [dynamic context](dynamic-context.md) executes17 original
mode2/reclip cases and captures12 kernel triangle/normal arguments. Test-only C#
composition matches complete snapshots, including retained old polygon and
callback publication. Jeep default deletion eligibility is guarded, while cleanup
mutations/children/order remain open. Next extend to nonempty static reclip and
ordered-body context, then real actor callbacks and retained helper cleanup.
Keep the current live solver and924ad2f packages while those gates remain.
Populated follow-up: [dynamic reclip](dynamic-reclip.md) now matches14 complete
observations and12 kernel steps. Direct source-store corrections remove two
rounding divergences without admitting new actors. Next prioritize real Jimmy/
VR04 callback mutations and live getter timing, then constructor-only helper
cleanup/order across LOAD/RETURN; integrate the bounded response only afterward.
Actor continuation: [normal contacts](actor-normal-contacts.md) now compares30
complete snapshots and implements inherited ceiling/reflection/heading impulse
outside live wiring. Jimmy ordinary374 is separate; soldier mode10's174 policy
and helper lifetime remain unresolved. Post-callback radius/inhibition/geometry/
42C reads are explicit contracts, not constructor snapshots. Next close derived
response and retained helper activation/order before a supported response adapter.
## Objective
Establish the original ownership and timing of player state across gameplay,
+172
View File
@@ -0,0 +1,172 @@
# Physical pair ordering and contact lifecycle
2026-11-06. Continues step4 of the movement plan after the Carl story-entry fix.
This closes a bounded pair-dispatch contract. It does not admit new live scene
physics, implement special Jimmy terrain callbacks or establish whole-game fidelity.
## Recovered source and structures
Canonical Neutron.exe SHA256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
`tools/binary/pair_lifecycle.py` guards8 complete source ranges and20 virtual
bindings, records PE file offsets and retains the matching original instruction
Evidence `ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
The generated probe relocates11 explicit absolute operands in private memory.
The supplied originals are read only; the executable entry point is not invoked.
New local REA/Ghidra pseudocode Evidence:
| Original VA / file offset | Role | Evidence ID suffix (all prefixed `ev_`) |
|---|---|---|
|479BC0 /79BC0|Physics scheduler; nonzero seconds, body pass then pair pass|56b7e074ec8509d1c5b3576d02361ff051963b777d7ccb8259ed9c65dc2db52f|
|47A430 /7A430|Ordered pair eligibility and notifications|8756a4c51d0c9215d3a36b86b673a2529bf74ed86bb9dcf630f66cbc398259b3|
|47B3E0 /7B3E0|Strict root-sphere overlap and callbacks|b98a1806c11507d5105d6fb22e259efafd141fe3c862eb4bb6602468a93a658d|
|47CA90 /7CA90|Earlier body's exclusion list|3f2613369c1259cba7aadfc00b7383dbf7bd37def7085f003daf81802dddbc4e|
|470B20 /70B20|Base leave, optional wake, contact removal|ae39adff84ac253cd370a2fd3f04ee7e9c00a6a6210d4f0222e938103a114d72|
|470BC0 /70BC0|Base stay/game callback cache|c3f377c29e0818cb43ed7bcc58d4db3871ab34d1b54c329421591438b79f0d00|
Complete replies/export and closed snapshot: `artifacts/pair-lifecycle/rea/`.
Ghidra did not recognize470A60/470BF0 as requested procedures; error replies are
retained. Its47B3E0 pseudocode misidentifies the first argument as a return-address
value. Calling convention, stack arguments and the omitted leaf bodies therefore
use guarded instructions plus actual copied-code execution, not that pseudocode.
No repeated query is presented as successful decompilation of those two leaves.
The physical list at695D3C is a circular sentinel list of12-byte nodes:
next+0, previous+4, game-interface pointer+8. This differs from the ordinary update
registry50999C. Re-registration and repeated Init are documented separately in
[body registration](body-root-registration.md).
Each actor owns contact-list sentinel pointer+260/count+264 and exclusion-list
sentinel pointer+254. These are interface-relative fields, not radius slot260.
Base contact game-callback result caches are+408 enter,+40C stay,+410 leave.
## State transitions and ordering
- Viewport47E554 calls479BC0 before ordinary registry updates. Nonzero delta and
global4F69E7 admit body integration479D20 followed by47A430. Pair global4F69E4
gates the latter independently; raw control5099E4 is not queried here.
- 47A430 traverses each earlier physical node against itself and subsequent nodes.
Identical actor pointers are skipped, with no reverse pair traversal. A duplicate
physical node can cause another test of the same actor pair; it is not deduplicated.
- Own220 is sampled once at the outer boundary; each inner actor's220 is read
again. Mutual3A0 permissions follow. Rejected flags/permissions skip the pair
**without removing stored contacts or emitting leave**. An outer actor disabled
by its first enter callback can still contact later actors in that traversal.
- First actor mode178=2 selects47A5E0(first,second); otherwise second mode2
selects47A5E0(second,first). Both mode2 preserves first-first selection. Other
modes use47B3E0(first,second). Box geometry is a distinct contract.
- Sphere query reads second root, first root, both radii and quick_magnitude.
Contact requires strict distance<radius sum. Tangency is separation.47CA90
checks **only the earlier actor's exclusion list**, after the distance test;
the later actor's exclusions are not consulted by this sphere query.
- Successful sphere query invokes first4C then second4C before notifications,
retaining the computed distance/result. A response may change a live root;
the current pair still notifies, while later pairs read the changed root.
- Each side independently queries membership3C. Positive overlap gives enter40
when absent, stay48 when present; separation gives leave44 only when present.
The first notification can alter the second side's membership before its query.
- Actual470A90 adds a contact unless already present or own deletion byte+6 is set.
Actual470B20 optionally restores live integration214 when own210 is false and
authoredB4 true, then removes matching nodes.470BC0 does not change membership.
These base routines can request current-game callbacks when their cache is−1.
- 470BF0 uses the **other** actor's1E0 inhibition flag. If clear, own integration210
permits414 response; a separate own1F8 branch may call60. Sleeping bodies can
still enter/stay contact. The probe leaves1F8 false; full response60 remains open.
## Original component execution and C# comparison
The native probe executes the complete pair pass, sphere/exclusion queries and
base membership/enter/stay/leave/overlap routines in a hash-verified generated
copy. Quick magnitude uses the copied OMT DLL export. Actors, vtables, permission
getters, response414 mutations, allocation/free and box query results are explicit
fixture adapters. No real Jimmy constructor, actor AI/contact consumer, static
world reclip, original renderer or scene loader executes.
All28 cases pass under isolated Wine32 with no network or Original-directory mount.
Cases cover enter/stay/tangency/leave/reentry, wake-on-leave, earlier/later/reordered
exclusions, gate retention, three-actor order, callback root/flag/membership changes,
duplicate identity, response inhibition, sleeping bodies and mode2 dispatch.
Initial12s capture expired during prefix creation; a reused scalar-only prefix
could not load OMT (error126, missing Wine DLLs). Both failures are retained.
The successful run uses a copied initialized OMT-capable prefix; it is component
evidence, not native Windows or whole-original gameplay verification.
`OriginalPairCollision` now translates the ordered pass and sphere query with
live actor callbacks and explicit mode2 injection. It is intentionally **not
wired into SceneInteractions or LabSimulation**. A stable physical list is required;
callback insertion/removal of list nodes is not yet reproduced by this component.
Base actor callback implementation remains the consumer's responsibility.
`GamePort.PairLifecycleTests` compares all28 native callback traces, contact masks,
integration/enabled flags and root-X snapshots. Fixed copies of those finite
expectations also run without generated artifacts. All28 complete comparisons pass.
The fixture's synthetic base-callback behavior is not a complete actor implementation.
The optional test rejects mode2 without an explicit solver instead of substituting
the provisional capsule. Existing lookup-table/x87 precision limitations remain;
these sphere fixtures use axis distances, not a proof of all boundary arithmetic.
Reproduce locally:
```sh
python3 tools/binary/pair_lifecycle.py ../Original \
--output artifacts/pair-lifecycle/native \
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wno-unused-function \
-o artifacts/pair-lifecycle/native/probe.exe \
artifacts/pair-lifecycle/native/pair_lifecycle_probe.c
python3 tools/recon/reference_capture.py --asset-probe \
--probe-executable artifacts/pair-lifecycle/native/probe.exe \
--probe-success PAIR_LIFECYCLE_COMPLETE --seconds 12 \
--output artifacts/pair-lifecycle/probe
python3 tools/binary/pair_lifecycle.py ../Original \
--output artifacts/pair-lifecycle/native --capture artifacts/pair-lifecycle/probe
source scripts/env.sh
dotnet run --project tests/GamePort.PairLifecycleTests -- \
--native artifacts/pair-lifecycle/native/observations.json
```
Use an initialized OMT-capable generated Wine32 prefix for the12s capture.
`source.json` records identities/ranges/bindings; `observations.json` hashes the
capture, executable and generated source. The capture verifier checks EXE/DLL copy
hashes and observed probe identity. All generated evidence remains local.
## Integration and package verification
All338 Python tests pass, including2 new source/corpus checks. The28-case native
comparison and saved-reference replay pass; existing10 dynamic collision groups,
body-ownership and Director regressions pass. Debug build has zero warnings/errors.
Windows x64 cross-publish succeeds; its initial normal restore reports NU1900 for
unavailable vulnerability metadata. Clean packaging disables that metadata query.
Both packages identify clean source commit924ad2f67b5a2c3c90856366b0642c12da56d59e.
Each contains519 byte-identical original copies,4285 matching prepared scene files
and7 matching prepared audio files; DLLs match the corresponding publish outputs.
Standalone Linux from /tmp without SDK/development-library paths passes Carl first
neutral input/300 idle ticks/held-input return. All4 captures match the previous
ea04210 package exactly. This run disables optional Vulkan validation; prior
enabled-validation evidence remains separate. No new Windows runtime or whole-
original gameplay result is inferred. All539 originals remain unchanged.
Logs and hashes: artifacts/pair-lifecycle/validation.json, package-identity.json,
package-readbacks.json and package-control.log.
## VR04 eligibility coverage and next gate
Actual VR04 GAM contains Jimmy, Rocketship,3 YokianSoldiers and trophy among its
records. Their4 class game tables bind220→471A30, mode178→471720,
permission3A0→472F80 (unconditional true), overlap4C→470BF0 and210→4719F0.
The3 soldier records explicitly request HasCollision1. Guard output retains their
GAM offsets, tags, task/activation fields and20 common bindings. This removes any
basis for treating their class permission callback as a blanket exclusion.
It does **not** establish the complete physical list: other GAM classes, generated
children/helpers, task activation, constructors, exclusions, registration and live
flags still matter. Visibility and raw-control ownership cannot substitute for
that inventory. SceneInteractions currently groups selected player contacts after
player processing; its single contact set, active/control gates and immediate talk
dispatch are still approximations of these independent owners/phases.
Next: trace actual VR04 physical registration/activation and generated children,
then recover shared nearest/last-polygon dynamic reclip ownership. Recover real
Jimmy material160/164/FENCE/LADDER callbacks and persistent body/animation state
before enabling source physics in lab/outside. Keep ea04210 readbacks as the
comparison baseline; current clean924ad2f packages preserve that live route.
+138
View File
@@ -0,0 +1,138 @@
# VR04 physical registration and initialization boundaries
2026-11-06. Extends the existing [registration trace](body-root-registration.md)
and [pair contract](pair-lifecycle.md) with complete serialized-class coverage and
12 executed original-component cases. No runtime gameplay code or scene admission
changes in this checkpoint. The playable/package baseline remains924ad2f.
## Identity and evidence
Canonical Neutron.exe SHA256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
`physical_registration.py` verifies that identity,6 bounded source hashes,
13 RTTI interface identities,11 own-registration sites and78 method bindings.
It inventories every one of VR04's72 records with source GAM offsets/activation
fields. Original instruction Evidence is
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`;
bounded extracts, offsets, hashes and10 private-memory relocation operands are
retained in artifacts/physical-registration/native/source.json.
New local REA/Ghidra results:
- 464210 sprite bridge:
`ev_4d39cc1aaad564de60bb801c08dfeb740d52e507227e630de9b0570e3e1bc43d`.
- 436B80 derived AI/pickup gate:
`ev_95baf27f6c5f2949dcc5f03f77f3c45bcd14852595b0cc207b9ee27c1dbb02f9`.
Requests for46E570,40E1F0 and45F2B0 had no recognized procedure in this analysis;
complete errors are retained. Their instructions remain available in the earlier
full REA disassembly. No retry is counted as successful decompilation. Successful
results/export and closed snapshot are in artifacts/physical-registration/rea/.
The prior4623D0/458910/479A40 Evidence remains linked in body-root-registration.md.
## What registration actually owns
| VA / PE file offset | Recovered behavior |
|---|---|
|4623D0 /623D0|3D-object interface at complete+C0. Calls458910; copies current complete44/48/4C through16C; converts signed14-bit Euler fields through174; calls479A40.|
|464210 /64210|Sprite interface at complete+C8. Same registration shape with the corresponding−84/−80/−7C render-root offsets; converts Euler units by360/16384; calls479A40.|
|458910 /58910|Tests interface49E. When false invokes470A00 and sets49E=true. This gates the base hook, **not the later append in either bridge**.|
|470A00 /70A00|Logging hook ending at472970; it does not allocate a physical body node. This corrects an earlier allocation label.|
|479A40 /79A40|Calls own150(0,0,0), then own28 Init, then allocates/appends a12-byte physical node and increments695D40. The payload is the game-interface pointer. No identity deduplication or pair/integration gate occurs here.|
|42AB50 /2AB50|Jimmy/Rocketship outer49E guard: true returns; false jumps to4623D0. This is a distinct guard around the whole registration path.|
|46E570..46E69F /6E570..6E69F|Live registry traversal: own28 Init, attached-render handling, own40C PostLoad, attached-render handling, next node. Then app10C cleanup and47E470 timer reset.|
The physical list695D3C and ordinary registry50999C have separate ownership.
Common registration reads the current render transform, which is not a promise
that authored GAM properties have already been streamed. Constructor registration
can precede that streaming; later Init/PostLoad work owns later state publication.
The12-case copied-code probe establishes:
- Repeated direct4623D0 or464210 calls append the same interface again, repeating
transform/zero/Init callbacks even with49E already true. This is a function
contract, not evidence that every real actor naturally acquires duplicate nodes.
- Jimmy's guarded entry skips all that work when49E is set. Clearing49E admits
another append. Clearing a flag is not equivalent to clearing the list.
- A child registered from the supplied Init callback is appended before its
parent's append, because479A40 calls Init before allocating the parent's node.
The child callback is synthetic; no claim is made that all real Init methods do so.
- Pair flag140 and integration13E false do not prevent registration. Membership,
active integration and pair eligibility must stay independent.
- The previously recovered per-object Init/PostLoad order is confirmed by actual
46E570 execution. Nodes appended from either callback are visited later in that
same traversal. A snapshot/two-global-pass model would differ in these fixtures.
## All serialized VR04 classes
The following is a source inventory of **own registration sites**, not a complete
runtime body count. Constructor rows assume that constructor is actually invoked
and succeeds; reuse, nested helpers, later calls and scene state remain separate.
| GAM kind / records | Actual interface | Own registration site / phase |
|---|---|---|
|3JIM /1|C3DJimmy4A373C, complete+C0|4238B4 virtual2C during matching-start PostLoad; guarded42AB50|
|3ROC /1|C3DRocketShip4B25AC, complete+C0|43DB22 virtual2C in PostLoad; guarded42AB50|
|STRT /1|C3DStartPoint4B7654, complete+C8|Constructor44249D→464210|
|3PHO /2|C3DPhoneBooth4ADF6C, complete+C0|Constructor4356A0→4623D0|
|3PAT /34|C3DPatrolPoint4ACEE4, complete+C8|Constructor434D44→464210|
|3PIC /11|C3DPickupItem4AE548, complete+C8|Constructor435A37→464210|
|3SOL /3|C3DYokianSoldier4C19C4, complete+C0|Constructor44BFA4→4623D0|
|3TRO /1|C3DVRTrophy4BE404, complete+C0|Constructor448D33→4623D0|
|3AIT /2|C3DAITrigger48F8C0, complete+C8|Constructor40BE5B→464210|
|3CHK /1|C3DCheckPoint4959A8, complete+C8|Constructor414323→464210|
|LOAD /2|CLoadLevel4D025C, complete+C8|Constructor457CCA→464210|
|3CAM /12|C3DCutSceneCamera497BFC, complete+C8|No own registration call in the inspected constructor/base/PostLoad chain|
|3SM1 /1|C3DSmoke4B4F08, complete+C8|No own call in that chain; it creates a separately registered SmokePuff helper|
Thus57 serialized records map to own constructor sites,2 to PostLoad sites and13
to no own call in the inspected chain. These numbers partition records; they
are **not a claim of59 actual bodies**. All these interfaces expose InitPhysics,
including the two negative own-call classes. Having that method is insufficient
evidence that it is invoked.3CAM's class is the cutscene-camera subclass, not the
base C3DCamera. Source RTTI verifies the distinction.
Authored HasCollision/task/range values are retained per record. Generic activation
40E1F0, task callback40E340, pickup45F2B0 and derived436B80 have different ownership.
The recovered436B80 first calls40E340, then may hide an acquired optional pickup;
it does not establish an independent universal body-list removal policy. Current
live flags, deletion, exclusions and child activation still require tracing.
## Execution, reproduction and limits
`physical_registration_probe.c` executes copied4623D0/464210/458910/470A00/479A40,
42AB50 and46E570. Explicit adapters supply actor vtables/transforms, Init/PostLoad
callbacks, logging, allocation, app cleanup and timer. Render-presence byte8 is
false in loader fixtures, so attached-render branches are not exercised. No real
actor constructor, original game entry point, script/task world or renderer runs.
All12 cases verify full emitted callback/order/count/flag/Init/XYZ/Euler outputs
under isolated Wine32, with Original unmounted and network disabled. The helper
checks copied EXE hash, observed probe identity, exit0 and completion marker;
provenance and validated observations are retained locally. This is original
component execution, not native Windows or full original gameplay verification.
```sh
python3 tools/binary/physical_registration.py ../Original \
--output artifacts/physical-registration/native \
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wno-unused-function \
-o artifacts/physical-registration/native/probe.exe \
artifacts/physical-registration/native/physical_registration_probe.c
python3 tools/recon/reference_capture.py --asset-probe \
--probe-executable artifacts/physical-registration/native/probe.exe \
--probe-success PHYSICAL_REGISTRATION_COMPLETE --seconds 12 \
--output artifacts/physical-registration/probe
python3 tools/binary/physical_registration.py ../Original \
--output artifacts/physical-registration/native --capture artifacts/physical-registration/probe
```
The short capture uses a copied initialized generated Wine32 prefix; this scalar
probe needs no OMT DLL load. No runtime implementation or package identity changes
follow from these observations alone. [Generated helpers](vr04-generated-bodies.md)
records21 verified creation/registration calls and the remaining lifetime gaps.
Next: close helper reuse/removal and activation enough to reconstruct the actual
physical sequence for fresh and retained VR04; then integrate dynamic response
with original nearest/last-polygon reclip ownership. Keep the playable collision
baseline and separate OriginalPairCollision component until that boundary closes.
+84
View File
@@ -0,0 +1,84 @@
# VR04 generated helpers: bounded registration catalogue
2026-11-06. Complements [serialized registration](physical-registration.md).
This is source recovery, not a complete observed helper/body count. No gameplay
change, native actor constructor execution or package refresh is claimed.
`tools/binary/vr04_generated_bodies.py` verifies the canonical EXE hash,21 direct
calls,9 instruction sites and12 helper RTTI identities/36 method targets. Optional
`--rea` retains13 bounded instruction excerpts, PE offsets and hashes under
artifacts/physical-registration/helpers.json. Source Evidence is
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
EXE text offsets cited here are VA−400000; the guard uses actual PE mapping.
JN-Engine documentation supplied navigation leads; canonical instructions and RTTI
establish the following identities. No JN replacement movement is used.
## Positive creation/registration chains
| Owner / original VA | Helper and physical-registration evidence |
|---|---|
|Jimmy422610/422633|Loop counter20, ctor40FC50; complete+AB4..B00 stores20 C3DBaseball pointers. Table49141C+40C→410000 invokes2C at41000C→464210. The loop disables each ball's integration214; sleeping does not remove registration.|
|Player4374DF; Jimmy4238EF|C3DJetpackFire ctor421D80, table4A3160, created from the Player constructor. Its own40C→40E7B0 supplies no registration call, but Jimmy's matching-start PostLoad configures the owned fire and explicitly invokes its2C at4238EF. Owner-driven registration is essential.|
|Jimmy42243F|Owned C3DRocketShip ctor43D840, distinct from a separately created serialized3ROC instance unless the loader's reuse policy selects an existing one. Its43DB22 PostLoad invokes guarded42AB50. Do not collapse nodes by kind name.|
|Rocketship43D9BC|C3DFireStrato ctor4192E0, table49BDD4. Common40E7B0 PostLoad alone is not a registration edge; other owner/lifecycle calls remain separate.|
|Jimmy42232C|C3DBubble ctor410840; direct registration410992→464210. Its410A80 PostLoad sets up retained artwork and does not itself establish repeated registration.|
|Jimmy4225BE|C3DPointCursor ctor43BC70;43BD67→4623D0. Generic40E7B0 PostLoad supplies no own registration.|
|Jimmy422800|C3DGraplingHook (original RTTI spelling), ctor41EEB0;41EFB4→4623D0. Its generic40E7B0 likewise is not a retained re-registration proof.|
|Smoke4406B1|C3DSmokePuff ctor440980;440ACC→464210. The serialized Smoke object's own negative registration result does not exclude its helper's node.|
|Goddard41CA9C/41CB09|Two C3DCursor constructors415760, each415857→4623D0. RTTI/table497620 identifies Cursor; these are not C3DFlag helpers.|
Common registration can append an interface more than once, while the Jimmy/
Rocketship outer49E guard prevents a repeated call when set. The new native
registration cases verify that distinction; this catalogue does not assert a
natural duplicate node for every positive chain above.
## Helpers whose interface does not prove body membership
- Jimmy42250C creates C3DShadow43F640, table4B37B8. Yokian44A88F creates the same
type conditionally on the source shadow flag. Their retained-canvas PostLoad
43F810→4354C0 is not itself a2C call. Terrain projection is a separate consumer.
- Jimmy42255B creates **C3DTargetCursor**4453B0, table4B9F48. It is distinct from
C3DMovingTarget/table4A8A10 and the target consumers used in VR07. Shared FourCC
3TAR or misleading class-registration strings are insufficient type evidence.
Its445580 retained-canvas setup does not establish body registration.
- Yokian44A826 creates C3DYokianShield44B510, table4C0E24. Its44B6C0 PostLoad calls
464810 canvas setup; exposing2C→464210 alone proves no physical-list membership.
The catalogue is bounded: additional Jimmy allocations (including ray/pod paths),
conditional helpers and owner callbacks still need their own lifetime inventory.
The12 listed RTTI identities are not an assertion that only12 helper types exist.
## Retained loads and late companion construction
Ordinary scene teardown clears the physical list; it also clears surviving
interfaces'49E flag. A retained registry identity is not a retained physical node.
Baseballs' explicit PostLoad and Jimmy-owned fire invocation give positive re-entry
edges. Constructor-only helper registration cannot silently be treated as a
PostLoad edge; gadget activation, later owner calls, reuse/removal and shutdown
must be followed before assigning retained membership.
Jimmy PostLoad423C98 constructs Goddard only on its observed pointer-null path.
The Jeep path is different: EDI is zeroed at4236FA and stored into game+970 at
423792, before the later null test423CEE and constructor4211A0 at423D1A. Therefore
the later null test alone is not evidence that this pointer is retained. Source
421552 invokes Jeep2C→421570, whose49E guard enters465070→4623D0. Jimmy423D75
then calls the wheel-construction hook; existing Scooter documentation covers its
four wheel objects. Old Jeep teardown/deletion and complete retained ordering
remain open; no leak or new carry/reset policy is inferred.
2026-11-07 [teardown follow-up](dynamic-context.md#helper-teardown-follow-up):
Jeep constructor42129A pushes1 into470F40, storing authored+11 and live+139;
Init restores that value. Default Jeep is eligible for ordinary deletion.
Thirteen guarded sites/five bindings also establish three live-predicate reads
around cleanup20/34. This narrows default eligibility, while active callback
mutations, child cleanup, deletion sweep and final retained order remain open.
## Implementation consequence
The live port reconstructs selected actors and bounded body records per scene.
It does not yet reproduce this complete helper/physical-list lifecycle. The pair
component must receive source physical order with real actor callbacks, not a
filtered list of visible GAM actors or a dictionary containing one actor per kind.
No helper is added to live collision merely because a vtable exposes InitPhysics.
Resolve remaining constructor-only re-entry, deletion and activation edges before
changing that boundary. All source/probe work remains local and originals unchanged.
+81
View File
@@ -0,0 +1,81 @@
# Codex quota guard
This repository has a local Linux watcher and project hooks for the user's
requested GSD quota policy. The watcher polls the existing Codex app-server every
60 seconds; it does not start model turns or read credentials. It uses the
300-minute account window and its actual reset timestamp, preferring the general
`codex` bucket over specialty-model buckets.
- At **20% remaining or less**, `PreToolUse` denies new `Agent`, `spawn_agent`,
and `followup_task` calls. Existing workers may finish their safe checkpoint.
- At **15% remaining or less**, the watcher saves a separate recovery snapshot
and sends each registered active turn one request to checkpoint with
`$gsd-pause-work` and end. Tool hooks also supply that instruction once per turn.
- Missing, expired, or older-than-180-second quota data blocks new worker dispatch
until a fresh reading arrives. Checkpoint tools remain available.
- The watcher never starts a turn, interrupts a process, commits unfinished work,
pushes code, or automatically resumes after reset.
## One-time activation
The source is `tools/workflow/codex_quota_guard.py`; project configuration is
`.codex/hooks.json`. Existing global GSD hooks are preserved and additive.
Open **`/hooks`** in Codex, review and trust the five hooks from this project's
`.codex/hooks.json`. New definitions remain skipped until reviewed; see the
[official hook trust instructions](https://learn.chatgpt.com/docs/hooks#review-and-trust-hooks).
The watcher has been started for this host, but thread registration and tool
blocking require trusted hooks. A later session's `SessionStart` hook starts
another watcher only if one is not already running.
The guard targets this Linux Codex host, not the Windows original-game test
machine. Windows uses a no-op command override. It does not restart Codex or
change provider/model/account settings.
## Commands
From the repository root:
```sh
python3 tools/workflow/codex_quota_guard.py status
python3 tools/workflow/codex_quota_guard.py refresh
python3 tools/workflow/codex_quota_guard.py start
python3 tools/workflow/codex_quota_guard.py stop
```
`status` includes the lock-verified `running` flag, current reading, reset epoch,
and any last poll error type. `refresh` uses the existing local daemon socket and
may need execution outside the agent sandbox. It neither starts a daemon nor a
model turn. `stop` requests termination within a second after any in-flight RPC
finishes; hooks start the watcher again, so disable the project hooks in `/hooks`
when turning the guard off permanently. `start` clears the stop marker when its
singleton watcher starts. No service or cron entry is installed.
After quota resets, send **`$gsd-resume-work`**. The current saved continuation is
phase 01, plan 01-05, task 2; preserve its partial edits and do not repeat task 1.
Resumption remains a user action even after the account has recovered.
## Recovery and limits
Ignored private state is under `artifacts/gsd-quota/`. `quota.json` stores only
counters/timestamps. Per-thread registration stores thread/turn identifiers, not
conversation contents. At low quota, `recovery-<reset>/record.json` saves the Git
HEAD, status, tracked patch (capped at 2 MiB), and existing GSD state/handoff text
(capped at 256 KiB each). It supplements and never replaces the canonical GSD
handoff. Untracked file contents remain in the working tree; this is not a full
backup. Source changes after that one-per-window snapshot rely on the working
tree and the model's final handoff. Files are private to the local account.
The pause is **cooperative**. Polling may lag usage by a minute, a long active
model request may consume the reserve, and no model can guarantee writing a
handoff after the provider exhausts quota. The independent recovery record still
runs without model tokens. Tool hooks cover supported local tool paths; launching
workers through unrelated shell scripts or other clients bypasses this specific
dispatch policy. Weekly and specialty-model limits are not guarded. Inactive or
mismatched turns are never restarted by the watcher.
Verified against local Codex 0.169.0: real Unix WebSocket quota read, project hook
discovery (five hooks awaiting trust), singleton background watcher, and 24 targeted
unit tests. Simulated low-quota tests verify pause steering and snapshot behavior;
no real quota depletion or active gameplay work was induced to test the threshold.
See the [official app-server protocol](https://learn.chatgpt.com/docs/app-server)
and [hook contracts](https://learn.chatgpt.com/docs/hooks).
+224
View File
@@ -1,5 +1,229 @@
# Compatibility and validation
## Bundled checker cache fix — 2026-11-14
A user readiness check created Python bytecode inside the sealed checkpoint and
then rejected it as unexpected immutable material. Regression23ee1c2 reproduces
this; fix2fe8b40 disables bytecode writes before local imports in all five bundled
Python command entry points. All26 checkpoint tests pass, including a real copied
CLI test with environment overrides ignored. The exact bundled readiness command
passes twice without creating pyc files. A fresh11,001-member checkpoint replaces
phase01; the old tree and its cache/results are retained in local history, and
existing results/generated execution copies were copied into the new mutable roots.
The broader attempt ran185 tests but failed observer class setup after a90-second
.NET build timeout. A separate bounded local build passed; the seven observer
checks then passed on their own retry. Thus all192 fidelity checks are covered
across the two runs; the initial full attempt remains recorded as failed.
No runtime implementation changed. Actual original/native acceptance remains
0/120 OPEN and all ten human UAT items remain pending.
## Phase 1 verification — human session pending
Final owner-validated verification is `human_needed`:29/42 truths verified and13
uncertain pending actual observations. Ten named checks are saved in
`.planning/phases/01-reproducible-fidelity-baseline/01-UAT.md`. Autonomous materials,
review fixes, security and automation coverage are complete. Actual acceptance
remains0/120 OPEN; all EVID requirements stay Pending and Phase2 is unadvanced.
The combined session guide is `docs/evidence/checkpoint-session.md`; the local
checkpoint is `dist/fidelity/phase01`. Resume human verification with
`$gsd-verify-work 1`. No new build/test or gameplay claim accompanies this report.
## Final phase 1 review closure
All five review findings are independently verified fixed. The final copy-state
refinement is02d182f; all191 fidelity regressions pass in43.355s, with29 acceptance,
26 scenario and23 capture checks in the affected suites. Earlier review fixes
also pass27 Node and18 Linux-hosted PowerShell checks;539 originals stay unchanged.
The recovered full local suite passed782.049626s before these tooling-only review
fixes:556 Python,27 Node,23 observer,2 HUD,51 managed entry points and36 GPU render
receipts, zero Vulkan validation errors. The full GPU suite was not repeated for
these Python/collector fixes. Independent security audit closes22/22 planned
threats. Current fresh checkpoint is `dist/fidelity/phase01` (11,001 immutable
entries); exact current manifest/READY identities are recorded locally in
`artifacts/fidelity/verification/01-07-final-checkpoint.json`. Earlier bundle
history is preserved locally. All120 actual original/native acceptance obligations
and ten named human findings remainOPEN. Final phase verification is pending.
## Phase 1 final checkpoint — materials ready, runtime acceptance OPEN
Fresh `dist/fidelity/phase01` readiness passes11,000 immutable members. Strict audit
exits1 with0/120 accepted and ten pending human findings. Failed Linux preflight
`linux-01-06-matrix-preflight-linux` identifies no display/auto_null only; it is
diagnostic evidence, not captured gameplay. Native Windows and actual original-
DxWnd remain unexecuted; automated GPU/SDL fixtures cannot establish physical
input/audibility. Runtime packages retain446930d dirty/diff90cef956, separately
from later tools/docs commits; originals and generated packages/media stay local.
Complete local suite: exit 0 in 782.05s (runner: 783s), with 556 Python
(180 fidelity), 27 Node, 23 managed observer, 2 separate HUD Python tests,
51 managed test entry points and the main build. The 36 GPU rendered receipts,
27 saved readbacks and 17 material/readback assertions report zero validation
errors. SDL dummy-audio checks pass; 539 original hashes match. Optional native
window tests were not enabled; dummy consumption supplies no audible proof.
Final exit/duration: `artifacts/fidelity/01-07-full-suite.json`, with the complete
log alongside it; the first74.65s attempt is retained
separately for the corrected Node reporter/count guard failure. Exact final
checkpoint identities: `artifacts/fidelity/verification/01-07-final-checkpoint.json`.
See [remaining acceptance](evidence/phase01-baseline.md). All EVID requirements and
Phase1 acceptance stay OPEN under the roadmap source-backed continuation exception.
## Phase 1 plan 01-06 — reviewed tooling evidence
Primary repeats23 capture tests; executor records156 broader fidelity tests
and539 unchanged originals. Actual host TTY/no-display/auto_null preflight failed
with a structurally valid imported receipt. No Linux gameplay capture was made;
all40 Linux and120 total acceptance obligations remainOPEN.
## Phase 1 plan 01-05 — reviewed tooling evidence
24 checkpoint tests and17 actual PowerShell selftests pass in primary review;
executor records133 broader fidelity checks,539 unchanged originals, and both
Python/PowerShell preflights of the10,983-file offline bundle. Linux copied-apphost
--help passes after executable mode preservation. Actual Windows gameplay,
original-DxWnd comparison and full runtime acceptance remain0/120 OPEN.
## Workflow quota guard — 2026-11-13
Local Codex0.169.0 Linux Unix-WebSocket quota read and watcher verified; five
project hooks discovered, awaiting user trust. Targeted simulated quota, policy,
transport and recovery tests pass. Real exhaustion/active-turn pause is not
induced; pause remains cooperative. Windows hook override is a no-op. No game
build, package or original/native Windows acceptance claim changes.
## Phase 1 wave 2 bounded observer evidence
Full authorized wave2 `scripts/test.sh` exits0:462 Python+2 HUD checks,
all existing managed projects and36 GPU/render checks pass with zero Vulkan
validation errors (GTX1070); SDL stream/lifecycle checks and539 original hashes
pass. The initial sandbox run retained8 denied-loopback errors; no tests were
skipped, and the authorized rerun passed. Viewer27 named Node checks and the
observer23 managed checks retain their separate passing receipts. Logs are
local under `artifacts/fidelity/wave2-test*.log`.
Plan01-04 passes23 managed checks,7 port-process checks and protected groups
Movement28/Director23/Checkpoint4/BodyOwnership3. The real LV1B→VR04→LV1B
fixture retains one observer clock. Native Linux SDL/Vulkan under private Xvfb
on/off passes with4 identical GPU readbacks and zero validation errors, using
actual dirty-source/diff and DLL identities recorded in its local comparison
report. No physical input/audio, full route, original-DxWnd or native Windows
acceptance follows. Debug and isolated Linux self-contained publish pass;
NU1900 is the existing unavailable vulnerability-metadata warning. All539
originals match. Exact receipts/limitations:
`../.planning/phases/01-reproducible-fidelity-baseline/01-04-SUMMARY.md`.
## Phase 1 resumed — capability ledger complete
User resumed from the usage pause. Plan01-03 is complete:25 capabilities cover
all33 requirements and33 checkpoint rows across6 groups. Primary repeats31
ledger tests and103 combined fidelity tests;539 original hashes match. Earlier
viewer27 Node checks and synthetic Chromium smoke remain their bounded evidence.
Full details: `../.planning/phases/01-reproducible-fidelity-baseline/01-03-SUMMARY.md`.
Actual original-DxWnd/native Linux/native Windows acceptance remains OPEN0/120.
Next: plan01-04 passive port observer; no new gameplay behavior or original/native
comparison was established by the ledger work.
## Phase 1 wave 1 tooling verification
Full wave1 `scripts/test.sh` exits0:403 Python checks plus2 HUD checks,
all managed projects and36 rendering checks pass with zero Vulkan validation
errors; SDL dummy-device audio lifecycle and539 original hashes pass. NU1900
reports unavailable vulnerability metadata; no build error. Log stays local at
`artifacts/fidelity/wave1-test.log`. This is baseline regression evidence, not
new whole-original/native Windows comparison.
Preservation/receipt/scenario tooling passes51 Python tests on the development
Linux host;539 original hashes are unchanged. This checks local metadata and
filesystem behavior, not Windows/DxWnd execution or gameplay comparison. An
existing package was identified as historical only; current acceptance stays
OPEN at0/120 runtime obligations. No runtime/gameplay/package code changed.
Details and exact commits: `../.planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md`.
## Phase 1 planning verification — 2026-11-12
Seven phase plans pass independent review, requirement/decision coverage and
24 deterministic verify-command checks. These are plan-quality results, not
executed feature tests or platform receipts. Original inventory still verifies
539 unchanged files. Original-DxWnd and native Linux/Windows comparison captures
remain future plan deliverables, with actual execution limitations retained.
## Planned Phase 1 capture setup — 2026-11-12
The user has a local Windows PC for combined reference/port checkpoint sessions.
Original-game reference execution is planned through DxWnd on a generated copy;
record Windows, DxWnd version/settings and capture limitations. Native Windows
port results remain distinct. This is setup availability and a discussion decision,
not a new launch, capture, original-comparison or native Windows verification
receipt. Existing verification claims and open acceptance dependencies remain.
2026-11-07 normal-callback checkpoint:30 complete emitted original/C# fixture
snapshots match exact float32 values, raw angle arguments/results and getter
order. The inherited ceiling/reflection/angular component remains outside live
profile wiring. Jimmy no-effect paths and Soldier174/Jimmy204 record-only
endpoints are explicitly bounded; no full derived policy is implied.352 Python
checks and targeted sphere/static/body/ownership/pair/context/reclip checks pass.
Linux Debug build has zero warnings/errors; Windows x64 self-contained cross-
publish succeeds.539 originals and both924ad2f packaged DLLs/BUILD-INFO are
unchanged. No new graphics/native SDL, whole-original or Windows execution is
claimed; integrated runtime evidence remains bf876e9. Invalid partial captures
from the corrected relocation scan are excluded. See
[normal callbacks](checkpoint/actor-normal-contacts.md) and local
artifacts/actor-contact/validation.json for source/capture/build identities.
2026-11-07 populated-reclip correction:14 complete original/C# observations and12
kernel steps match exact float32 values after source-store arithmetic corrections.
Initial node-visit, edge-projection and ray-hit failures are retained. No epsilon
or near-zero reset is added. `scripts/test.sh` exits0:348 Python checks,2 HUD
Python checks, all managed projects,36 Vulkan/render checks with zero validation
errors, dummy-device audio lifecycle and539 unchanged original files. Debug build
has zero warnings/errors. Native Linux1920×1080 SDL Carl-control and VR04 jetpack/
resize replays also pass with zero validation errors; first neutral input and300
idle ticks stay upright. Windows x64 self-contained cross-publish succeeds to a
separate artifact directory; no new Windows execution is claimed. Existing Linux/
Windows packaged DLLs and BUILD-INFO remain the verified924ad2f baseline.
Dynamic composition still uses synthetic actors/callbacks/grid and is not live
pair admission. Double intermediates reproduce these cases, not all x87 inputs.
See [populated reclip](checkpoint/dynamic-reclip.md), with final logs/identities
under artifacts/dynamic-reclip/validation.json and its referenced artifacts.
2026-11-07 dynamic-context checkpoint:17 copied-original mode2/static reclip
observations match the C# test composition in full, including XYZW, shared
nearest/hit/old polygon, callback/setter/pass counts and mode. All12 instrumented
kernel triangle/normal arguments also match. A retained diagnostic intentionally
fails with construction winding despite the same final position. The source
static grid is empty, transforms/callbacks are synthetic and mode starts0;
nonempty/reentrant/live actor behavior is not established. All345 Python tests,
17 fixed context cases,11 static groups,10 dynamic groups and28 pair cases pass.
539 originals and both924ad2f packaged DLLs/BUILD-INFO are unchanged. No runtime
code, package refresh, new GPU run or native Windows execution is claimed.
See [shared context and helper follow-up](checkpoint/dynamic-context.md).
2026-11-06 physical-registration continuation:12 copied-code registration/loader
cases pass with complete emitted callback/order/count/flag/transform checks.
All72 VR04 records/13 class interfaces are inventoried, with a bounded catalogue
of21 helper creation/registration edges and12 verified helper RTTI identities.
These are source/component results, not a complete observed physical list or
whole-original/native Windows gameplay.342 Python checks and the existing28-case
managed pair regression pass;539 originals remain unchanged. Runtime code and
924ad2f packages are unchanged. See [registration](checkpoint/physical-registration.md)
and [helpers](checkpoint/vr04-generated-bodies.md). Helper retained lifetime,
activation and dynamic shared reclip state remain open before live admission.
2026-11-06 pair lifecycle checkpoint:28 copied-original pair/sphere/exclusion/
base-contact cases match the C# dispatch component's complete callbacks, contact
masks, integration/enabled flags and roots. Fixed reference tests also pass without
local traces. Actors, response hooks and box results are synthetic adapters;
mode2 geometry, whole original and native Windows behavior are not established.
The component is not admitted to live gameplay. All338 Python tests, targeted
dynamic/body-ownership/Director checks and Debug build pass; Windows cross-publish
succeeds with a NU1900 vulnerability-metadata warning.539 originals are unchanged.
See [pair contract](checkpoint/pair-lifecycle.md). Both packages identify clean
924ad2f, with519 exact original copies,4285 matching scene files and7 matching
prepared audio files each. Standalone Linux from /tmp without SDK/development
library paths passes the Carl control replay with4 readbacks identical to ea04210.
That run disables validation; no new enabled-validation claim is made. The current
Windows package is cross-published/resource-verified; the earlier Wine64 evidence
belongs to ea04210 and native Windows testing remains pending.
2026-11-06 TSK startup correction: the original menu creates backgroundLevel1D/
Jimmy before successful TSK story entry, then retains that player ahead of the
new level-game input callback. Program now models this on first story entry as
+205
View File
@@ -1,5 +1,162 @@
# Decisions
## Bundled checker cache fix — 2026-11-14
A user readiness check created Python bytecode inside the sealed checkpoint and
then rejected it as unexpected immutable material. Regression23ee1c2 reproduces
this; fix2fe8b40 disables bytecode writes before local imports in all five bundled
Python command entry points. All26 checkpoint tests pass, including a real copied
CLI test with environment overrides ignored. The exact bundled readiness command
passes twice without creating pyc files. A fresh11,001-member checkpoint replaces
phase01; the old tree and its cache/results are retained in local history, and
existing results/generated execution copies were copied into the new mutable roots.
The broader attempt ran185 tests but failed observer class setup after a90-second
.NET build timeout. A separate bounded local build passed; the seven observer
checks then passed on their own retry. Thus all192 fidelity checks are covered
across the two runs; the initial full attempt remains recorded as failed.
No runtime implementation changed. Actual original/native acceptance remains
0/120 OPEN and all ten human UAT items remain pending.
## Phase 1 verification — human session pending
Final owner-validated verification is `human_needed`:29/42 truths verified and13
uncertain pending actual observations. Ten named checks are saved in
`.planning/phases/01-reproducible-fidelity-baseline/01-UAT.md`. Autonomous materials,
review fixes, security and automation coverage are complete. Actual acceptance
remains0/120 OPEN; all EVID requirements stay Pending and Phase2 is unadvanced.
The combined session guide is `docs/evidence/checkpoint-session.md`; the local
checkpoint is `dist/fidelity/phase01`. Resume human verification with
`$gsd-verify-work 1`. No new build/test or gameplay claim accompanies this report.
## Final phase 1 review closure
All five review findings are independently verified fixed. The final copy-state
refinement is02d182f; all191 fidelity regressions pass in43.355s, with29 acceptance,
26 scenario and23 capture checks in the affected suites. Earlier review fixes
also pass27 Node and18 Linux-hosted PowerShell checks;539 originals stay unchanged.
The recovered full local suite passed782.049626s before these tooling-only review
fixes:556 Python,27 Node,23 observer,2 HUD,51 managed entry points and36 GPU render
receipts, zero Vulkan validation errors. The full GPU suite was not repeated for
these Python/collector fixes. Independent security audit closes22/22 planned
threats. Current fresh checkpoint is `dist/fidelity/phase01` (11,001 immutable
entries); exact current manifest/READY identities are recorded locally in
`artifacts/fidelity/verification/01-07-final-checkpoint.json`. Earlier bundle
history is preserved locally. All120 actual original/native acceptance obligations
and ten named human findings remainOPEN. Final phase verification is pending.
## Final fidelity audit — phase 1 plan 01-07
Readiness verifies immutable prepared bytes and current copied materials;
strict acceptance separately requires complete original/native matrix coverage,
matching package/source/resource identities and receipt-bound human judgments.
Structural `--allow-open` success never promotes acceptance. Preserve raw collector
receipts and failed/superseded history; the integration agent performs explicitly
specified evidence-backed post-return normalization, while the tester only
collects, observes and returns local files. A1/A2, both unclassified assumptions
and P1/P2/P3 remain visible until actual review. No universal fidelity tolerance,
automatic physical/audible pass or movement/landing reset is introduced.
Current result: ready11,000 files; strict audit human_needed,0/120. Positive-count
guards cover the existing fidelity suites in one consolidated local run; Node
uses explicit TAP so installed reporter defaults cannot hide the executed count.
The completed local run exits 0 in 782.05s: 556 Python (180 fidelity), 27 Node,
23 observer and 2 separate HUD Python tests; all 51 managed test entry points,
the main build, 36 GPU rendered receipts, 17 material/readback assertions,
dummy-audio checks and 539 original hashes pass. These bounded regression facts
do not resolve physical/audible/native/original acceptance.
## Linux capture access — phase 1 plan 01-06
A common failed native display/audio preflight may explain all40 Linux open
obligations. Do not fabricate40 launches or substitute fixture playback. Preserve
actual package seals, unique session history and retained prerequisite evidence.
Physical input, moving content and audible playback remain human gates.
## Offline checkpoint review — phase 1 plan 01-05
Keep prepared-material readiness separate from runtime acceptance. Identify
external tools without copying their executables; preserve raw media and terminal
results. Retain source executable modes when copying local Linux packages; byte
hashes alone do not establish runnable apphost permissions. Windows collection
selftests on Linux establish tooling behavior only.
## Quota reserve — 2026-11-13
Use actual300-minute account quota and server reset time. Reserve20% for
existing workers and15% for handoff. Poll locally without model turns; preserve
a private independent recovery snapshot and request cooperative GSD pause.
Never auto-resume, commit partial source, restart Codex, or bypass hook trust.
See [guard contract](codex-quota-guard.md).
## Passive evidence observation — phase 1 wave 2
Keep one optional application-owned clock across Run continuations. Record raw,
requested and actual gate-accepted input separately after existing owner calls;
copy state without new gameplay ownership or callback reads. Script activity,
explicit skip actions and transitions carry actual observed provenance. Observer
failures disable recording with incomplete diagnostics and do not reset/retry
simulation. Output is caller-selected for standalone packages, bounded and
exclusive; fixtures/headless/debug-injected runs are labeled port_fixture.
Observer overhead and incomplete coverage stay explicit. Existing algorithms,
TSK retained/fresh ordering and collision admission gates are preserved.
## Phase 1 resumed — capability ledger complete
User resumed from the usage pause. Plan01-03 is complete:25 capabilities cover
all33 requirements and33 checkpoint rows across6 groups. Primary repeats31
ledger tests and103 combined fidelity tests;539 original hashes match. Earlier
viewer27 Node checks and synthetic Chromium smoke remain their bounded evidence.
Full details: `../.planning/phases/01-reproducible-fidelity-baseline/01-03-SUMMARY.md`.
Actual original-DxWnd/native Linux/native Windows acceptance remains OPEN0/120.
Next: plan01-04 passive port observer; no new gameplay behavior or original/native
comparison was established by the ledger work.
## Phase 1 evidence contract — wave 1
Session/receipt schema1 records original/copy/package/media identities separately.
Imported commands are inert data; duplicate IDs are idempotent only for identical
bytes. Retained cases bind departure/return and copy-state evidence; fresh cases
have independent lifetime IDs. Eight dialogue/lifetime/input cells each require
continuous plus dialogue-return, left/right bank and landing-idle scope on original
Windows/DxWnd, native Linux port and native Windows port (120 obligations).
Synthetic/component/Wine/cross-publish/historical evidence cannot substitute.
The GSD worktree fork-base guard selected sequential native executors because
origin/HEAD is absent in this Gitea/main repository. Existing user authorization
for main commits is encoded in git.allow_default_branch_commits.
## Phase 1 execution structure — 2026-11-12
Build the agreed evidence workflow in seven plans/five waves: preservation and
session/scenario contracts; parallel local viewer, full-game capability ledger
and passive port observer; local Windows/DxWnd bundle; native Linux capture; then
one combined hands-on session and strict acceptance audit. Materials readiness
and native/original acceptance have separate verdicts. Missing actual captures
leave EVID-02/EVID-04 open. Five research uncertainties now have explicit planning
policies while their actual runtime outcomes remain execution dependencies.
## Phase 1 comparison decisions — 2026-11-12
Use full lab → VR04 → lab → outside journeys plus focused normal/edge-input
replays, with equal natural/skipped dialogue and separate fresh/retained coverage.
Review original/port playback together with optional overlays, actual timing drift
and switchable audio. Browse evidence by capability with current gaps first and
expandable revision history; order discrepancies by player impact. Prepare one
local bundle and combined Windows session per checkpoint. The original runs from
a generated copy through DxWnd, with version/settings recorded; port-native
receipts remain separate. Full decisions are in
`../.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md`.
## Full reconstruction planning — 2026-11-12
The user scoped GSD planning to the remaining full reconstruction and explicitly
required accuracy as high as possible to the original. Organize work as playable
slices, retaining the movement-first stabilization gate and all original-required
content. Use autonomous mode, standard phases, parallel independent plans,
tracked planning docs, research/plan checking/verification, full instructions
and inherited session models; optional PR body sections are disabled.
See `../.planning/PROJECT.md`, `config.json`, `REQUIREMENTS.md` and `ROADMAP.md`.
These decisions introduce no gameplay changes or new compatibility claims.
User workflow update (2026-11-05): completed, verified milestones are now pushed
to the existing `Gitea` remote at `https://gitea.unixnight.com/UnixNight/Neutron.git`
on `main`. This explicit user instruction supersedes earlier local-only Git
@@ -384,3 +541,51 @@ assets and generated packages stay excluded.
republishes−10° bank; corrected startup order stays upright through300 idle
ticks. Original runtime/native Windows comparison remains distinct. See
gameplay/main-menu-player-lifetime.md.
55. **Retain source pair ownership before admitting a replacement scene loop.**
47A430 uses physical registration order, live callbacks and eligibility gates
that preserve old contacts. Sphere47CA90 checks only the earlier actor's
exclusions; successful responses precede independent membership notifications.
The28-case original/C# component implements that bounded contract with an
explicit box solver. Keep it outside live gameplay until full registration,
real actor callbacks and shared reclip dependencies close. Render visibility
and raw-control flags are not substitutes for physical eligibility. See
checkpoint/pair-lifecycle.md.
56. **Keep physical membership,49E and active collision as separate state.**
Common4623D0/464210 only use49E to gate the base hook; they can append the
same pointer again. Jimmy42AB50 guards the whole bridge. Registration runs
Init before physical append, while loading runs Init then PostLoad per live
registry node and visits new tails. Twelve original component cases confirm
these boundaries. Inventory actual constructor/owner-driven helper edges;
neither visibility nor an exposed InitPhysics method establishes membership.
Do not synthesize a full live body count or retained re-entry from the72-record
serialized partition. See checkpoint/physical-registration.md.
57. **Preserve shared context and validate kernel arguments before live admission.**
Full47A5E0 execution retains old hit/last polygon and can issue its static
callback after a dynamic hit. Final local-root publication overwrites callback
changes unless inhibited. Seventeen complete comparisons pass in a test-only
composition. Kernel A,C,B/retained construction normal is confirmed by all12
captured arguments; a same-position match with wrong nearest state was rejected.
Keep source topology and kernel boundary distinct. Empty-grid/synthetic actor
results do not admit live scene collision. Guard default Jeep deletion while
leaving cleanup-mutated active lifetime open. See checkpoint/dynamic-context.md.
58. **Follow evidenced float-store boundaries instead of accepting nearby roots.**
Populated reclip exposed an edge projection mismatch at triangle6, then a ray
hit mismatch at7. Delayed X projection/edge-root products, retained quick-
magnitude normalization and delayed hit-coordinate stores close14 complete
float32 comparisons and12 kernel steps without epsilon or near-zero clamps.
Keep public float magnitude/caller nearest state and source per-coordinate
stores distinct; double intermediates do not establish general x87 identity.
Count static node visits before the geometry gate, separately from actual
primitive tests. Real actor callbacks/lifetime still gate live integration.
See checkpoint/dynamic-reclip.md.
59. **Bind normal response by real class and preserve late scalar reads.**
Jimmy ordinary/null/jetpack374 does not enter inherited reflection378.
The inherited handler samples live Y again, preserves unclamped damping and
has a separate angular-heading tail. Implement that as an isolated component,
confirmed by30 complete original/C# snapshots. Soldier mode10 additionally
invokes complete174 with500; its RNG/action policy remains outside this
boundary. Sample inhibition/radius/42C/scene geometry at their source points,
not once before callbacks. Explicitly reviewed relocation operands replace
the probe's rejected cross-instruction numeric scan. No new live actor is
admitted from these finite fixtures. See checkpoint/actor-normal-contacts.md.
+895
View File
@@ -0,0 +1,895 @@
# Capability evidence ledger
Generated by tools/recon/fidelity_ledger.py from [capabilities.json](capabilities.json).
Capabilities: 25; requirements: 33; unmapped: 0. Acceptance: **OPEN**.
Current means exact named content/platform/scope applicability, including explicitly historical bytes. A report link is not a new execution; date or docs HEAD never promotes proof. Original-DxWnd/native matrix acceptance remains **0/120** until identified captures and review.
Regenerate and validate locally:
```sh
python3 tools/recon/fidelity_ledger.py validate --ledger docs/evidence/capabilities.json --requirements .planning/REQUIREMENTS.md
python3 tools/recon/fidelity_ledger.py render --ledger docs/evidence/capabilities.json --output docs/evidence/README.md
python3 tools/recon/fidelity_ledger.py export --ledger docs/evidence/capabilities.json --output artifacts/fidelity/review/ledger.json
python3 tools/recon/fidelity_review.py export --ledger artifacts/fidelity/review/ledger.json --output artifacts/fidelity/review/new-review
```
Omitting recordings creates an explicitly missing-media review. Add --original and --port imported receipt.json paths when available. Scenario IDs link to the [eight-cell protocol](scenarios.json). Ledger evidence summaries are typed report records; only receipt_path entries reference imported version 1 receipts. Missing local artifacts retain their reasons. Source/implementation links are tracked bounded UTF-8 text; viewer export copies them into its contained sources/ tree.
## Movement
### action-animation
**Working behavior:** Original morph resources and bounded movement/turn/action aliases play; task and script controls have bounded tests.
**Verified scope/platform:** Checkpoint ANIM S/P/M/R and historical Linux renders; loop closure, advance and action aliases are partly port policy.
**Known differences:** Original playback flags/rate, acceptance, interruption and completion callbacks remain incomplete.
**Remaining acceptance — OPEN:** Recover one-shot/loop/end and movement/landing/talk/skip action ownership; compare actual original playback.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** MOVE-03 · **Implementation:** {&#x27;revision&#x27;: &#x27;1ae5f4251c26f3b0446f333e994694f99eab5be6&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/PlayerAppearance.cs&#x27;, &#x27;src/GamePort/Game/SceneDirector.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: PlayerAppearance.cs](../../src/GamePort/Game/PlayerAppearance.cs), [Implementation: SceneDirector.cs](../../src/GamePort/Game/SceneDirector.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;action-animation-coverage&quot;, &quot;result&quot;: &quot;Original morph resources and bounded movement/turn/action aliases play; task and script controls have bounded tests.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;action-animation-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;action-animation-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;action-animation: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;action-animation-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;action-animation: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · action-animation-remaining: Recover one-shot/loop/end and movement/landing/talk/skip action ownership; compare actual original playback.
- **missing_verification** · action-animation-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### controller-phases
**Working behavior:** Recovered ground/air/facing/jump arithmetic and prior-body then registry input ordering support bounded Jimmy movement.
**Verified scope/platform:** Recorded S/P/M/R: 108 controller component comparisons, later 146 air/render observations and native Linux five-jump-alias replays; not whole-original cadence.
**Known differences:** Fixed 60 Hz remains a port policy; mouse/controller, full base wrappers and grouped actor/morph cadence remain incomplete.
**Remaining acceptance — OPEN:** Recover intended device/focus sampling, full movement modes and interacting owner/cadence contracts before broad parity claims.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** MOVE-01 · **Implementation:** {&#x27;revision&#x27;: &#x27;0e2f426d425153d4452a67f288813067caa624da&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/JimmyGroundMotion.cs&#x27;, &#x27;src/GamePort/Game/JimmyAirMotion.cs&#x27;, &#x27;src/GamePort/Game/JimmyOrientation.cs&#x27;, &#x27;src/GamePort/Game/FixedStepClock.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: JimmyGroundMotion.cs](../../src/GamePort/Game/JimmyGroundMotion.cs), [Implementation: JimmyAirMotion.cs](../../src/GamePort/Game/JimmyAirMotion.cs), [Implementation: JimmyOrientation.cs](../../src/GamePort/Game/JimmyOrientation.cs), [Implementation: FixedStepClock.cs](../../src/GamePort/Game/FixedStepClock.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;controller-phases-coverage&quot;, &quot;result&quot;: &quot;Recovered ground/air/facing/jump arithmetic and prior-body then registry input ordering support bounded Jimmy movement.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;controller-phases-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;controller-phases-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;controller-phases: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;controller-phases-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;controller-phases: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · controller-phases-remaining: Recover intended device/focus sampling, full movement modes and interacting owner/cadence contracts before broad parity claims.
- **missing_verification** · controller-phases-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### route-control
**Working behavior:** Lab/VR04/lab/outside, raw versus debug control, body/fire continuation and bounded RETURN state are implemented.
**Verified scope/platform:** Historical Linux route/control and managed checks; startup-order row retains exact ea04210 native fixture and Wine classifications.
**Known differences:** Full shared wrappers/camera/control and complete fresh/retained natural/skipped/edge matrix remain open. Ordinary landing bank is legitimate.
**Remaining acceptance — OPEN:** Capture continuous and focused eight-cell routes, preserving successful TSK retained order and separate fresh direct-scene order.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** MOVE-04, MOVE-05 · **Implementation:** {&#x27;revision&#x27;: &#x27;ea04210f524faae7dc1caff8afbc608fbb8144f4&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Program.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: Program.cs](../../src/GamePort/Program.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;route-control-coverage&quot;, &quot;result&quot;: &quot;Lab/VR04/lab/outside, raw versus debug control, body/fire continuation and bounded RETURN state are implemented.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;route-control-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;route-control-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;route-control: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;route-control-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;route-control: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · route-control-remaining: Capture continuous and focused eight-cell routes, preserving successful TSK retained order and separate fresh direct-scene order.
- **missing_verification** · route-control-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### startup-order
**Working behavior:** TSK-backed first-story input order is already corrected: retained Jimmy updates before level-game input. Direct fresh scenes keep fresh insertion order; legitimate landing bank and all movement/rotation algorithms are preserved.
**Verified scope/platform:** Source/data lifetime proof; historical ea04210 Linux SDL/Vulkan Carl fixture (first neutral tick, 300 idle, held return) and standalone four-readback replay. Historical Wine64 is preliminary; whole-original/native Windows comparison remains open.
**Known differences:** Source allocation diagnostic required an OS repaint acknowledgement and black frames/timing perturbation; it is not playable original Carl evidence.; Bounded fixture input is not the complete physical-input lab→VR04→lab→outside matrix. Current package924ad2f differs from ea04210; later matching readbacks do not promote all runtime bytes.
**Remaining acceptance — OPEN:** Identified whole-original DxWnd Carl natural/skip and fresh/retained audiovisual comparison; Current native Windows and native Linux full matrix with actual input/audio and human review; 0/120 accepted obligations; Preserve normal landing bank, fresh direct-scene order and independent airborne behavior
**Requirements:** MOVE-04, MOVE-05 · **Implementation:** {&#x27;revision&#x27;: &#x27;ea04210f524faae7dc1caff8afbc608fbb8144f4&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Program.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;story &#124;&#124; carriedSave != null; unchanged Program source through ledger work&#x27;}
**Sources:** [TSK source lifetime and bounded runtime receipt](../../docs/gameplay/main-menu-player-lifetime.md), [Exact implementation owner](../../src/GamePort/Program.cs), [Platform/history reconciliation](../../docs/compatibility.md), [Checkpoint coverage rows](../../docs/checkpoint/coverage.md)
**Scenarios:** [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [{&quot;path&quot;: &quot;artifacts/main-menu-player-lifetime/package-identity.json&quot;, &quot;sha256&quot;: &quot;6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c&quot;, &quot;size&quot;: 845}, {&quot;path&quot;: &quot;artifacts/main-menu-player-lifetime/package-verification.json&quot;, &quot;sha256&quot;: &quot;e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31&quot;, &quot;size&quot;: 2548}, {&quot;path&quot;: &quot;artifacts/main-menu-player-lifetime/native-control-final.log&quot;, &quot;sha256&quot;: &quot;46efc999b3d2d78b1eef3b3dea9d8fee188202c1556dc1d40751e6ee555f8548&quot;, &quot;size&quot;: 1901}, {&quot;path&quot;: &quot;artifacts/main-menu-player-lifetime/package-control-standalone.log&quot;, &quot;sha256&quot;: &quot;09fa452577bbd66b9275cb83045db6b3a117913ec415f5fb6ae52e9a174790e0&quot;, &quot;size&quot;: 1950}, {&quot;path&quot;: &quot;artifacts/main-menu-player-lifetime/native-control-final.returned.ppm&quot;, &quot;sha256&quot;: &quot;2aa0156b1ee0de50a54808cfaac8acd6b9df5c3d947c7fa4f2ee08e6a814e238&quot;, &quot;size&quot;: 6220817}, {&quot;missing_reason&quot;: &quot;No usable whole-original Carl recording exists in this checkpoint&quot;, &quot;path&quot;: &quot;artifacts/fidelity/captures/original-carl-reference.webm&quot;}, {&quot;missing_reason&quot;: &quot;Native Windows Carl recording has not been collected&quot;, &quot;path&quot;: &quot;artifacts/fidelity/captures/windows-native-carl-reference.webm&quot;}], &quot;claim&quot;: {&quot;key&quot;: &quot;neutral-return&quot;, &quot;result&quot;: &quot;First input and 300 idle ticks upright; preserved heading/body/fire; four standalone readbacks identical. Development validation zero errors; standalone validation disabled.&quot;}, &quot;content&quot;: {&quot;package_report_sha256&quot;: &quot;6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c&quot;, &quot;runtime_sha256&quot;: &quot;9bee85197c0d7322dc67a8c1aedbe700cf63083f91f99161dd4533c2585501e5&quot;, &quot;verification_report_sha256&quot;: &quot;e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31&quot;}, &quot;evidence_kind&quot;: &quot;port_fixture&quot;, &quot;historical&quot;: true, &quot;id&quot;: &quot;tsk-linux-fixture-ea04210&quot;, &quot;method&quot;: &quot;Historical native Linux SDL/Vulkan control fixture and standalone replay, recorded report/logs; no new execution&quot;, &quot;missing_evidence&quot;: [&quot;No complete original Carl capture&quot;, &quot;No current native Windows comparison&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;native&quot;, &quot;os&quot;: &quot;linux&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;tsk-linux-fixture-ea04210&quot;, &quot;report_path&quot;: &quot;docs/gameplay/main-menu-player-lifetime.md&quot;, &quot;revision&quot;: &quot;ea04210f524faae7dc1caff8afbc608fbb8144f4&quot;, &quot;scope&quot;: [&quot;Carl first neutral input and 300 idle ticks; held movement return&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
- {&quot;addresses&quot;: [&quot;46BF2F..46C00A&quot;, &quot;460A50..460A6A&quot;, &quot;43B5A0&quot;, &quot;46E38B/46E45A&quot;], &quot;artifacts&quot;: [{&quot;path&quot;: &quot;artifacts/main-menu-player-lifetime/source.json&quot;, &quot;sha256&quot;: &quot;abfeef8fb990e39e6e7f9395aae8fc8111e8038d92f5c0673a2db7505ec61070&quot;, &quot;size&quot;: 37630}], &quot;claim&quot;: {&quot;key&quot;: &quot;initial-story-order&quot;, &quot;result&quot;: &quot;Retained Jimmy precedes new level-game input; already corrected&quot;}, &quot;content&quot;: {&quot;implementation_sha256&quot;: &quot;2ea2e4cee3816337765b3cb4c07bc9b2a226a4c0951d0f4a7d9e2eb2f8b09e5d&quot;, &quot;report_sha256&quot;: &quot;956dc37ab40b0701564faf7fb227163cd1b7d118aeb73c9847c51f9f9ac61ce9&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;tsk-source-order-ea04210&quot;, &quot;method&quot;: &quot;Guarded source/data report, not a new execution&quot;, &quot;missing_evidence&quot;: [&quot;No complete original Carl capture&quot;, &quot;No current native Windows comparison&quot;], &quot;original_sha256&quot;: &quot;f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8&quot;, &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;rea_evidence&quot;: &quot;ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904&quot;, &quot;reason&quot;: &quot;Successful TSK requires existing Jimmy; background Level1D constructs him and ordinary loader retains registry node.&quot;, &quot;receipt_id&quot;: &quot;tsk-source-order-ea04210&quot;, &quot;report_path&quot;: &quot;docs/gameplay/main-menu-player-lifetime.md&quot;, &quot;revision&quot;: &quot;ea04210f524faae7dc1caff8afbc608fbb8144f4&quot;, &quot;scope&quot;: [&quot;successful TSK story entry; direct-fresh distinction&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: [&quot;tsk-fresh-assumption-dae13ac&quot;]}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;source-order-at-ledger-import&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;956dc37ab40b0701564faf7fb227163cd1b7d118aeb73c9847c51f9f9ac61ce9&#x27;, &#x27;implementation_sha256&#x27;: &#x27;2ea2e4cee3816337765b3cb4c07bc9b2a226a4c0951d0f4a7d9e2eb2f8b09e5d&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;successful TSK story entry; direct-fresh distinction&#x27;]}, {&#x27;id&#x27;: &#x27;historical-linux-ea04210-only&#x27;, &#x27;content&#x27;: {&#x27;runtime_sha256&#x27;: &#x27;9bee85197c0d7322dc67a8c1aedbe700cf63083f91f99161dd4533c2585501e5&#x27;, &#x27;package_report_sha256&#x27;: &#x27;6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c&#x27;, &#x27;verification_report_sha256&#x27;: &#x27;e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;linux&#x27;, &#x27;execution&#x27;: &#x27;native&#x27;}, &#x27;scope&#x27;: [&#x27;Carl first neutral input and 300 idle ticks; held movement return&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;initial-story-order&quot;, &quot;result&quot;: &quot;Prior port incorrectly treated first TSK story as fresh registry order; source report explicitly corrects this&quot;}, &quot;content&quot;: {&quot;implementation_sha256&quot;: &quot;2ea2e4cee3816337765b3cb4c07bc9b2a226a4c0951d0f4a7d9e2eb2f8b09e5d&quot;, &quot;report_sha256&quot;: &quot;956dc37ab40b0701564faf7fb227163cd1b7d118aeb73c9847c51f9f9ac61ce9&quot;}, &quot;evidence_kind&quot;: &quot;inferred&quot;, &quot;historical&quot;: true, &quot;id&quot;: &quot;tsk-fresh-assumption-dae13ac&quot;, &quot;method&quot;: &quot;Prior narrative retained from source report; never accepted as source fact&quot;, &quot;missing_evidence&quot;: [&quot;No complete original Carl capture&quot;, &quot;No current native Windows comparison&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;tsk-fresh-assumption-dae13ac&quot;, &quot;report_path&quot;: &quot;docs/gameplay/main-menu-player-lifetime.md&quot;, &quot;revision&quot;: &quot;dae13ace7391671aee7082c662bb798b285b9124&quot;, &quot;scope&quot;: [&quot;successful TSK story entry; direct-fresh distinction&quot;], &quot;status&quot;: &quot;superseded&quot;, &quot;supersedes&quot;: []}
- {&quot;artifacts&quot;: [{&quot;path&quot;: &quot;artifacts/main-menu-player-lifetime/package-verification.json&quot;, &quot;sha256&quot;: &quot;e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31&quot;, &quot;size&quot;: 2548}], &quot;claim&quot;: {&quot;key&quot;: &quot;wine-control&quot;, &quot;result&quot;: &quot;Historical isolated Wine64 fixture exits 0; preliminary compatibility only&quot;}, &quot;content&quot;: {&quot;package_report_sha256&quot;: &quot;6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c&quot;, &quot;runtime_sha256&quot;: &quot;24e1f01be497b920eab005608cf04c8838894d9e63404008c674990627bbc989&quot;, &quot;verification_report_sha256&quot;: &quot;e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31&quot;}, &quot;evidence_kind&quot;: &quot;wine&quot;, &quot;historical&quot;: true, &quot;id&quot;: &quot;tsk-wine64-ea04210&quot;, &quot;method&quot;: &quot;Reported Wine64 fixture; not native Windows; package verification report retained&quot;, &quot;missing_evidence&quot;: [&quot;No complete original Carl capture&quot;, &quot;No current native Windows comparison&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;wine&quot;, &quot;os&quot;: &quot;windows&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;tsk-wine64-ea04210&quot;, &quot;report_path&quot;: &quot;docs/gameplay/main-menu-player-lifetime.md&quot;, &quot;revision&quot;: &quot;ea04210f524faae7dc1caff8afbc608fbb8144f4&quot;, &quot;scope&quot;: [&quot;32-frame packaged Carl/control fixture&quot;], &quot;status&quot;: &quot;historical&quot;, &quot;supersedes&quot;: []}
</details>
**Player-impact discrepancies:**
- **missing_verification** · startup-native-windows: ea04210 Wine64/cross-publish never establishes current native Windows acceptance.
- **missing_verification** · startup-original-reference: Whole-original Carl playback has not been captured; background allocation is narrower evidence.
## Contacts
### actor-policies
**Working behavior:** Bounded Carl/Goddard patrol, pickup/task callbacks, VR04 shrink targets and VR01/VR07 contact consumers exist.
**Verified scope/platform:** Documented managed/source and bounded Linux scene checks; Soldier174 and Jimmy204 are recorded endpoints, not executed full policies.
**Known differences:** Full enemy sensing/RNG/actions, damage/death/recovery, hazards, successful climbs and real special enter/stay/leave consumers are incomplete.
**Remaining acceptance — OPEN:** Recover and implement real class policies and health/combat consumers with original observations before admitting new actors.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** ACT-01, ACT-02, ACT-03 · **Implementation:** {&#x27;revision&#x27;: &#x27;fccc0b9d1b6ae962d32147e4ae1433fce6a1a23e&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/ActorPatrol.cs&#x27;, &#x27;src/GamePort/Game/SceneInteractions.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: ActorPatrol.cs](../../src/GamePort/Game/ActorPatrol.cs), [Implementation: SceneInteractions.cs](../../src/GamePort/Game/SceneInteractions.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;actor-policies-coverage&quot;, &quot;result&quot;: &quot;Bounded Carl/Goddard patrol, pickup/task callbacks, VR04 shrink targets and VR01/VR07 contact consumers exist.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;actor-policies-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;actor-policies-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;actor-policies: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;actor-policies-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;actor-policies: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **blocking** · actor-policies-remaining: Recover and implement real class policies and health/combat consumers with original observations before admitting new actors.
- **missing_verification** · actor-policies-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### body-static-dynamic
**Working behavior:** VR04 ordinary source static body and standalone pair/reclip/normal components preserve published roots, live getters and callback order.
**Verified scope/platform:** Checkpoint S/P/M/R is bounded: 28 pair, 17 context, 14 populated reclip, 30 normal and 100 body ownership comparisons; actual scene admission is narrower.
**Known differences:** Pair discovery and real derived Jimmy/soldier callbacks are not live; lab/outside retain the compatibility capsule.
**Remaining acceptance — OPEN:** Complete actual special callbacks, ordered dynamic context and live getter timing before extending solver admission.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** MOVE-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;c9d0c5be59eedba3a92dcd46d1beb96b2e9e941a&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/OriginalBodyPhysics.cs&#x27;, &#x27;src/GamePort/Game/OriginalPairCollision.cs&#x27;, &#x27;src/GamePort/Game/OriginalNormalContacts.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: OriginalBodyPhysics.cs](../../src/GamePort/Game/OriginalBodyPhysics.cs), [Implementation: OriginalPairCollision.cs](../../src/GamePort/Game/OriginalPairCollision.cs), [Implementation: OriginalNormalContacts.cs](../../src/GamePort/Game/OriginalNormalContacts.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;body-static-dynamic-coverage&quot;, &quot;result&quot;: &quot;VR04 ordinary source static body and standalone pair/reclip/normal components preserve published roots, live getters and callback order.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;body-static-dynamic-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;body-static-dynamic-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;body-static-dynamic: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;body-static-dynamic-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;body-static-dynamic: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · body-static-dynamic-remaining: Complete actual special callbacks, ordered dynamic context and live getter timing before extending solver admission.
- **missing_verification** · body-static-dynamic-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### physical-helper-lifetimes
**Working behavior:** 72 VR04 records/13 classes, 12 original registration cases and 21 helper edges are inventoried; common append differs from Jimmy49E guard.
**Verified scope/platform:** Recorded static/copied-original/managed components only; constructor catalogue is not an observed physical body list.
**Known differences:** Retained helper membership, removal, activation and shared mutable reclip are open; no broad scene binding follows from the catalogue.
**Remaining acceptance — OPEN:** Recover helper re-entry/deletion and real retained physical order across LOAD/RETURN, then verify scene response adapters.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** MOVE-02, SAVE-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;ea04210f524faae7dc1caff8afbc608fbb8144f4&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Program.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: Program.cs](../../src/GamePort/Program.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;physical-helper-lifetimes-coverage&quot;, &quot;result&quot;: &quot;72 VR04 records/13 classes, 12 original registration cases and 21 helper edges are inventoried; common append differs from Jimmy49E guard.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;physical-helper-lifetimes-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;physical-helper-lifetimes-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;physical-helper-lifetimes: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;physical-helper-lifetimes-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;physical-helper-lifetimes: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · physical-helper-lifetimes-remaining: Recover helper re-entry/deletion and real retained physical order across LOAD/RETURN, then verify scene response adapters.
- **missing_verification** · physical-helper-lifetimes-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
## Gadgets
### gadget-use
**Working behavior:** Shrink ray/jetpack, Invisible, Bubble VR01, Baseball VR07 and Grappler VR08 have bounded implementations using original resources.
**Verified scope/platform:** Historical progress/compatibility reports separate copied-original components, managed checks and scene-specific native Linux replays.
**Known differences:** Remote and remaining gadget/actor consumers, other levels, suppression globals and complete enemy interactions are unfinished.
**Remaining acceptance — OPEN:** After movement stabilization, recover missing original gadgets and intended consumers; retain each bounded live scene and its source gate.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** GAD-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;7b5230ceb819e2e6cd551f19d11ef07fad9f1876&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/ShrinkRay.cs&#x27;, &#x27;src/GamePort/Game/InvisibleGadget.cs&#x27;, &#x27;src/GamePort/Game/BubbleMotion.cs&#x27;, &#x27;src/GamePort/Game/BaseballGadget.cs&#x27;, &#x27;src/GamePort/Game/GrapplerGadget.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: ShrinkRay.cs](../../src/GamePort/Game/ShrinkRay.cs), [Implementation: InvisibleGadget.cs](../../src/GamePort/Game/InvisibleGadget.cs), [Implementation: BubbleMotion.cs](../../src/GamePort/Game/BubbleMotion.cs), [Implementation: BaseballGadget.cs](../../src/GamePort/Game/BaseballGadget.cs), [Implementation: GrapplerGadget.cs](../../src/GamePort/Game/GrapplerGadget.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;gadget-use-coverage&quot;, &quot;result&quot;: &quot;Shrink ray/jetpack, Invisible, Bubble VR01, Baseball VR07 and Grappler VR08 have bounded implementations using original resources.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;gadget-use-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;gadget-use-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;gadget-use: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;gadget-use-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;gadget-use: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **blocking** · gadget-use-remaining: After movement stabilization, recover missing original gadgets and intended consumers; retain each bounded live scene and its source gate.
- **missing_verification** · gadget-use-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### gadget-retention
**Working behavior:** Bounded cutscene/unequip/RETURN cleanup and selected route scalar ownership are implemented; independent helpers retain separate lifetimes.
**Verified scope/platform:** S/M/R route/gadget reports; ordinary route carry differs from TSK/debug checkpoint load and process-memory fields.
**Known differences:** Arbitrary LOAD/save, death, helper cleanup and non-RETURN attachment continuity remain incomplete.
**Remaining acceptance — OPEN:** Verify all retained/reset gadget/vehicle/companion fields and helpers across intended interruption and resume paths.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** GAD-04 · **Implementation:** {&#x27;revision&#x27;: &#x27;27be8ed63079ae2e3bf7e965ee205c4a57a96559&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/PlayerLevelState.cs&#x27;, &#x27;src/GamePort/Game/SceneGadgets.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: PlayerLevelState.cs](../../src/GamePort/Game/PlayerLevelState.cs), [Implementation: SceneGadgets.cs](../../src/GamePort/Game/SceneGadgets.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;gadget-retention-coverage&quot;, &quot;result&quot;: &quot;Bounded cutscene/unequip/RETURN cleanup and selected route scalar ownership are implemented; independent helpers retain separate lifetimes.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;gadget-retention-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;gadget-retention-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;gadget-retention: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;gadget-retention-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;gadget-retention: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · gadget-retention-remaining: Verify all retained/reset gadget/vehicle/companion fields and helpers across intended interruption and resume paths.
- **missing_verification** · gadget-retention-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### inventory-energy
**Working behavior:** Owned gadget panel, practice selection, source availability passes and shared energy warnings operate in bounded scenes.
**Verified scope/platform:** Recorded S/M/R route and gadget tests; F1 grants are modern diagnostics, not ordinary acquisition proof.
**Known differences:** Availability differs from ownership; full acquisition paths, selected UI and other per-level availability tails remain incomplete.
**Remaining acceptance — OPEN:** Verify all original acquisition/energy/availability rules through ordinary campaign consumers without debug grants.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** GAD-01 · **Implementation:** {&#x27;revision&#x27;: &#x27;1ae5f4251c26f3b0446f333e994694f99eab5be6&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/SceneInventory.cs&#x27;, &#x27;src/GamePort/Game/PlayerEnergy.cs&#x27;, &#x27;src/GamePort/Game/GadgetScreen.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: SceneInventory.cs](../../src/GamePort/Game/SceneInventory.cs), [Implementation: PlayerEnergy.cs](../../src/GamePort/Game/PlayerEnergy.cs), [Implementation: GadgetScreen.cs](../../src/GamePort/Game/GadgetScreen.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;inventory-energy-coverage&quot;, &quot;result&quot;: &quot;Owned gadget panel, practice selection, source availability passes and shared energy warnings operate in bounded scenes.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;inventory-energy-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;inventory-energy-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;inventory-energy: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;inventory-energy-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;inventory-energy: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · inventory-energy-remaining: Verify all original acquisition/energy/availability rules through ordinary campaign consumers without debug grants.
- **missing_verification** · inventory-energy-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### vehicles
**Working behavior:** Scooter VR05/outside LEV1 and Rocketship VR02 provide bounded summon/mount/control/camera/cleanup with original art.
**Verified scope/platform:** Historical packages: Scooter 62c07a3 then fccc0b9 feedback; Rocketship e77add5 then 62e908e RGBA correction. Native Linux replays and component counts remain report-scoped.
**Known differences:** Scooter modes2..20/mouse/analog, other scenes, mission/hazard/RNG, shared dynamic pairs and whole-original/native Windows comparison remain open.
**Remaining acceptance — OPEN:** Recover remaining source-supported vehicle modes/passenger/collision/camera consumers before enabling broader scenes.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** GAD-03 · **Implementation:** {&#x27;revision&#x27;: &#x27;c9d0c5be59eedba3a92dcd46d1beb96b2e9e941a&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/Scooter.cs&#x27;, &#x27;src/GamePort/Game/Rocketship.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: Scooter.cs](../../src/GamePort/Game/Scooter.cs), [Implementation: Rocketship.cs](../../src/GamePort/Game/Rocketship.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;vehicles-coverage&quot;, &quot;result&quot;: &quot;Scooter VR05/outside LEV1 and Rocketship VR02 provide bounded summon/mount/control/camera/cleanup with original art.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;vehicles-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;vehicles-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;vehicles: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;vehicles-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;vehicles: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · vehicles-remaining: Recover remaining source-supported vehicle modes/passenger/collision/camera consumers before enabling broader scenes.
- **missing_verification** · vehicles-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
## Progression
### authored-scenes-tasks
**Working behavior:** All 35 supplied GAMs parse; 33 have geometry. Lab tasks, scripts, objectives, practice/RETURN and bounded optional mechanisms work.
**Verified scope/platform:** Source data/round-trip and bounded managed/Linux route evidence; no full campaign reachability or original gameplay comparison.
**Known differences:** Generic class callbacks/reentrancy, all mission/task/collectible mechanisms and ordinary traversal of every scene remain unfinished.
**Remaining acceptance — OPEN:** Implement authored reachable scene/mission consumers after movement/actor gates, preserving source objective-before-record/per-actor notification order.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** CAMP-01, CAMP-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;62c07a3d59ca6d71a7456957d8586c268d27c439&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/SceneDirector.cs&#x27;, &#x27;src/GamePort/Game/TaskActivation.cs&#x27;, &#x27;src/GamePort/Game/SceneMechanisms.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: SceneDirector.cs](../../src/GamePort/Game/SceneDirector.cs), [Implementation: TaskActivation.cs](../../src/GamePort/Game/TaskActivation.cs), [Implementation: SceneMechanisms.cs](../../src/GamePort/Game/SceneMechanisms.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;authored-scenes-tasks-coverage&quot;, &quot;result&quot;: &quot;All 35 supplied GAMs parse; 33 have geometry. Lab tasks, scripts, objectives, practice/RETURN and bounded optional mechanisms work.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;authored-scenes-tasks-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;authored-scenes-tasks-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;authored-scenes-tasks: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;authored-scenes-tasks-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;authored-scenes-tasks: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **blocking** · authored-scenes-tasks-remaining: Implement authored reachable scene/mission consumers after movement/actor gates, preserving source objective-before-record/per-actor notification order.
- **missing_verification** · authored-scenes-tasks-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### campaign-completion
**Working behavior:** No verified full-campaign completion workflow exists; bounded playable routes are foundations.
**Verified scope/platform:** Explicitly unimplemented full-scope outcome, not a missing audit row; checkpoint route does not prove campaign completion.
**Known differences:** All campaign/optional-route win/loss outcomes without debug grants or warps remain unverified and incomplete.
**Remaining acceptance — OPEN:** Recover reachable endings/branches and implement complete ordinary-play campaign outcomes, then compare original and native platforms.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** CAMP-03 · **Implementation:** {&#x27;revision&#x27;: &#x27;bdca29d3aa31face0c0023537ff98783716dbc45&#x27;, &#x27;paths&#x27;: [], &#x27;status&#x27;: &#x27;unimplemented&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;campaign-completion-coverage&quot;, &quot;result&quot;: &quot;No verified full-campaign completion workflow exists; bounded playable routes are foundations.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;campaign-completion-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;campaign-completion-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;campaign-completion: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;campaign-completion-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;campaign-completion: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **blocking** · campaign-completion-remaining: Recover reachable endings/branches and implement complete ordinary-play campaign outcomes, then compare original and native platforms.
- **missing_verification** · campaign-completion-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### configuration-workflow
**Working behavior:** Modern CLI/debug display/audio options exist; full original-supported settings persistence workflow is unimplemented.
**Verified scope/platform:** No original defaults/bounds/persistence acceptance is established by CLI availability.
**Known differences:** Player-facing original configuration, exact defaults and persisted input/display/audio bounds remain open.
**Remaining acceptance — OPEN:** Recover original settings workflow and persistence, implement it and verify continued gameplay with those settings.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** UI-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;bdca29d3aa31face0c0023537ff98783716dbc45&#x27;, &#x27;paths&#x27;: [], &#x27;status&#x27;: &#x27;unimplemented&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;configuration-workflow-coverage&quot;, &quot;result&quot;: &quot;Modern CLI/debug display/audio options exist; full original-supported settings persistence workflow is unimplemented.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;configuration-workflow-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;configuration-workflow-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;configuration-workflow: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;configuration-workflow-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;configuration-workflow: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · configuration-workflow-remaining: Recover original settings workflow and persistence, implement it and verify continued gameplay with those settings.
- **missing_verification** · configuration-workflow-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### content-accounting
**Working behavior:** Original inventory and GAM/OMT preparation account for supplied assets; missing Level3B/E geometry is recorded without substitution.
**Verified scope/platform:** 539-file hash baseline; 35 GAMs/33 geometry scenes; B/E duplicate four-entity records have unresolved normal use.
**Known differences:** No incoming GAM/save selection proves B/E reachable; complete authored reachability/unused classification remains open.
**Remaining acceptance — OPEN:** Account for every resource and authored dependency with evidence; distinguish unreachable/unused from unresolved rather than invent replacements.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** CAMP-04 · **Implementation:** {&#x27;revision&#x27;: &#x27;d62e2ab4dea38ce1c018b1a18ab51c39986ab630&#x27;, &#x27;paths&#x27;: [&#x27;tools/recon/inventory.py&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: inventory.py](../../tools/recon/inventory.py)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;content-accounting-coverage&quot;, &quot;result&quot;: &quot;Original inventory and GAM/OMT preparation account for supplied assets; missing Level3B/E geometry is recorded without substitution.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;content-accounting-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;content-accounting-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;content-accounting: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;content-accounting-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;content-accounting: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · content-accounting-remaining: Account for every resource and authored dependency with evidence; distinguish unreachable/unused from unresolved rather than invent replacements.
- **missing_verification** · content-accounting-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### frontend-hud
**Working behavior:** Bounded objective/practice/gadget UI and script return operate; persistent window/widescreen/F1/F2 are explicit modern presentation tools.
**Verified scope/platform:** S/M/R: source timer/O/strict input and Linux UI captures; historical layout is not complete original frontend parity.
**Known differences:** Startup/new-game/pause/menu/ending dispatcher and full objective flags/highlights/cursor/layout timing remain incomplete.
**Remaining acceptance — OPEN:** Recover original frontend modes/input/timing while distinguishing modern diagnostics and widescreen policy.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** UI-01 · **Implementation:** {&#x27;revision&#x27;: &#x27;ca08c468ba21a26710891b0029652351b9c2ae23&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/ObjectivePanel.cs&#x27;, &#x27;src/GamePort/Game/PracticePrompt.cs&#x27;, &#x27;src/GamePort/Game/GadgetScreen.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: ObjectivePanel.cs](../../src/GamePort/Game/ObjectivePanel.cs), [Implementation: PracticePrompt.cs](../../src/GamePort/Game/PracticePrompt.cs), [Implementation: GadgetScreen.cs](../../src/GamePort/Game/GadgetScreen.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;frontend-hud-coverage&quot;, &quot;result&quot;: &quot;Bounded objective/practice/gadget UI and script return operate; persistent window/widescreen/F1/F2 are explicit modern presentation tools.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;frontend-hud-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;frontend-hud-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;frontend-hud: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;frontend-hud-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;frontend-hud: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · frontend-hud-remaining: Recover original frontend modes/input/timing while distinguishing modern diagnostics and widescreen policy.
- **missing_verification** · frontend-hud-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### save-load-return
**Working behavior:** Original TSK round-trip/CLI task-item-score state, source departure-root RETURN and bounded retained scene snapshots are implemented.
**Verified scope/platform:** All 12 original saves byte-round-trip; S/P/M/R loader/RETURN route evidence is narrower than complete save UI/resume.
**Known differences:** Matching-task duplicate callbacks/post-task hooks and pickup checkpoint read consumer remain unresolved. TSK does not carry arbitrary actor/helper state.
**Remaining acceptance — OPEN:** Recover full save/load UI and reset/retained ownership across repeated loads and gameplay continuation; do not invent checkpoint respawn semantics.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** SAVE-01, SAVE-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;8d60a68511d1891d68e34feb22d6938c738ba98f&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/RuntimeCheckpoint.cs&#x27;, &#x27;src/GamePort/Game/PlayerLevelState.cs&#x27;, &#x27;src/GamePort/Game/SceneInteractions.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: RuntimeCheckpoint.cs](../../src/GamePort/Game/RuntimeCheckpoint.cs), [Implementation: PlayerLevelState.cs](../../src/GamePort/Game/PlayerLevelState.cs), [Implementation: SceneInteractions.cs](../../src/GamePort/Game/SceneInteractions.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;save-load-return-coverage&quot;, &quot;result&quot;: &quot;Original TSK round-trip/CLI task-item-score state, source departure-root RETURN and bounded retained scene snapshots are implemented.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;save-load-return-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;save-load-return-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;save-load-return: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;save-load-return-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;save-load-return: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · save-load-return-remaining: Recover full save/load UI and reset/retained ownership across repeated loads and gameplay continuation; do not invent checkpoint respawn semantics.
- **missing_verification** · save-load-return-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### final-fidelity-audit
**Working behavior:** Capability/history/discrepancy navigation exists; a successful whole-game comparison and final fidelity audit is unimplemented.
**Verified scope/platform:** This ledger is auditable documentation and tool output, not a whole-original/native runtime result.
**Known differences:** Unresolved gameplay/timing/visual/audio/progression differences and reference/platform access prevent full-fidelity completion.
**Remaining acceptance — OPEN:** Compare complete identified original and native routes, publish remaining differences and require explicit review before final acceptance.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** REL-03 · **Implementation:** {&#x27;revision&#x27;: &#x27;bdca29d3aa31face0c0023537ff98783716dbc45&#x27;, &#x27;paths&#x27;: [], &#x27;status&#x27;: &#x27;unimplemented&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;final-fidelity-audit-coverage&quot;, &quot;result&quot;: &quot;Capability/history/discrepancy navigation exists; a successful whole-game comparison and final fidelity audit is unimplemented.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;final-fidelity-audit-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;final-fidelity-audit-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;final-fidelity-audit: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;final-fidelity-audit-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;final-fidelity-audit: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **missing_verification** · final-fidelity-audit-remaining: Compare complete identified original and native routes, publish remaining differences and require explicit review before final acceptance.
- **missing_verification** · final-fidelity-audit-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### native-delivery
**Working behavior:** Local shared .NET10/SDL3/Vulkan builds and Linux/Windows self-contained packages have bounded provenance and resource checks.
**Verified scope/platform:** Historical clean924ad2f packages: Linux standalone Carl 4 readbacks match ea04210; Windows cross-publish/resource verification only. Earlier ea04210 Wine64 remains preliminary.
**Known differences:** Current broader integrated runtime evidence bf876e9 does not change packaged924ad2f bytes; native Windows/full-campaign/audio/focus/lifecycle acceptance remains open.
**Remaining acceptance — OPEN:** Rebuild clean identified offline packages at integrated checkpoints; run complete native platform journeys and preserve exact source/resource/package/log identities.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** REL-01, REL-02, REL-04 · **Implementation:** {&#x27;revision&#x27;: &#x27;62c07a3d59ca6d71a7456957d8586c268d27c439&#x27;, &#x27;paths&#x27;: [&#x27;scripts/package.sh&#x27;, &#x27;scripts/build-linux.sh&#x27;, &#x27;scripts/build-windows.sh&#x27;, &#x27;scripts/test.sh&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: package.sh](../../scripts/package.sh), [Implementation: build-linux.sh](../../scripts/build-linux.sh), [Implementation: build-windows.sh](../../scripts/build-windows.sh), [Implementation: test.sh](../../scripts/test.sh)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;native-delivery-coverage&quot;, &quot;result&quot;: &quot;Local shared .NET10/SDL3/Vulkan builds and Linux/Windows self-contained packages have bounded provenance and resource checks.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;native-delivery-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;native-delivery-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;native-delivery: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;native-delivery-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;native-delivery: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **missing_verification** · native-delivery-remaining: Rebuild clean identified offline packages at integrated checkpoints; run complete native platform journeys and preserve exact source/resource/package/log identities.
- **missing_verification** · native-delivery-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### preservation-reference-tools
**Working behavior:** Local inventory, preserved staging, typed hashed receipt import, eight-cell protocol and paired review tools support reproducible evidence navigation.
**Verified scope/platform:** Tooling and synthetic fixtures only for phase 1; genuine original-DxWnd/native matrix coverage remains 0/120. Existing runtime evidence stays historical and bounded.
**Known differences:** Working whole-original captures, current native Windows and complete native Linux journeys plus human audiovisual review are missing.
**Remaining acceptance — OPEN:** Prepare combined local original/native checkpoint, collect identified input/audio/video/results and audit each obligation; ledger completion does not complete shared EVID requirements.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** EVID-01, EVID-02, EVID-03, EVID-04 · **Implementation:** {&#x27;revision&#x27;: &#x27;32a72654e88ad3709aa1e2f0f108eea06e1b7469&#x27;, &#x27;paths&#x27;: [&#x27;tools/recon/fidelity.py&#x27;, &#x27;tools/recon/fidelity_receipts.py&#x27;, &#x27;tools/recon/fidelity_review.py&#x27;], &#x27;status&#x27;: &#x27;tooling&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Capability source report](../../docs/evidence/scenarios.json), [Implementation: fidelity.py](../../tools/recon/fidelity.py), [Implementation: fidelity_receipts.py](../../tools/recon/fidelity_receipts.py), [Implementation: fidelity_review.py](../../tools/recon/fidelity_review.py)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;preservation-reference-tools-coverage&quot;, &quot;result&quot;: &quot;Local inventory, preserved staging, typed hashed receipt import, eight-cell protocol and paired review tools support reproducible evidence navigation.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;f43abb53db1715ca3c5643159b44cac3742b4b1973b1feaf9a1001f754537743&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;preservation-reference-tools-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;preservation-reference-tools-report&quot;, &quot;report_path&quot;: &quot;docs/evidence/scenarios.json&quot;, &quot;revision&quot;: &quot;32a72654e88ad3709aa1e2f0f108eea06e1b7469&quot;, &quot;scope&quot;: [&quot;preservation-reference-tools: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;preservation-reference-tools-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;f43abb53db1715ca3c5643159b44cac3742b4b1973b1feaf9a1001f754537743&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;preservation-reference-tools: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **missing_verification** · preservation-reference-tools-remaining: Prepare combined local original/native checkpoint, collect identified input/audio/video/results and audit each obligation; ledger completion does not complete shared EVID requirements.
- **missing_verification** · preservation-reference-tools-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
## Visuals
### shared-camera-projection
**Working behavior:** Source static clipping/ray/gain runs in lab/VR04/outside; all level far overrides and bounded vehicle/script cameras are mapped.
**Verified scope/platform:** S/M/R source/projection and native Linux camera/transition checks; orbit inspector is modern and has separate Left/Right correction.
**Known differences:** Shared viewport eye/aim/default follow ownership, full input/quantization and layer maximum/masks remain open.
**Remaining acceptance — OPEN:** Recover shared old-eye/aim and first-follow handoff plus source projection/layers; preserve separate modern render/noclip policies.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** VIS-03, MOVE-04 · **Implementation:** {&#x27;revision&#x27;: &#x27;62c07a3d59ca6d71a7456957d8586c268d27c439&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/OriginalCameraRay.cs&#x27;, &#x27;src/GamePort/Game/GrapplerCamera.cs&#x27;, &#x27;src/GamePort/Game/ScooterCamera.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: OriginalCameraRay.cs](../../src/GamePort/Game/OriginalCameraRay.cs), [Implementation: GrapplerCamera.cs](../../src/GamePort/Game/GrapplerCamera.cs), [Implementation: ScooterCamera.cs](../../src/GamePort/Game/ScooterCamera.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;shared-camera-projection-coverage&quot;, &quot;result&quot;: &quot;Source static clipping/ray/gain runs in lab/VR04/outside; all level far overrides and bounded vehicle/script cameras are mapped.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;shared-camera-projection-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;shared-camera-projection-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;shared-camera-projection: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;shared-camera-projection-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;shared-camera-projection: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · shared-camera-projection-remaining: Recover shared old-eye/aim and first-follow handoff plus source projection/layers; preserve separate modern render/noclip policies.
- **missing_verification** · shared-camera-projection-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### vulkan-materials
**Working behavior:** Vulkan renders original textured/depth geometry and bounded material/alpha effects; null-material and Rocketship diffuse RGBA contracts are corrected.
**Verified scope/platform:** Historical Linux enabled-validation GPU tests, material/readback checks and source data; no original visual equivalence.
**Known differences:** Lighting/fog/texture stages/layer masks/blending/culling/material options and source widescreen presentation remain incomplete.
**Remaining acceptance — OPEN:** Recover remaining fixed-function equivalents and compare actual original frames with matched viewport/event provenance.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** VIS-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;7b5230ceb819e2e6cd551f19d11ef07fad9f1876&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Rendering/Vulkan/VulkanRenderer.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: VulkanRenderer.cs](../../src/GamePort/Rendering/Vulkan/VulkanRenderer.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;vulkan-materials-coverage&quot;, &quot;result&quot;: &quot;Vulkan renders original textured/depth geometry and bounded material/alpha effects; null-material and Rocketship diffuse RGBA contracts are corrected.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;vulkan-materials-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;vulkan-materials-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;vulkan-materials: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;vulkan-materials-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;vulkan-materials: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · vulkan-materials-remaining: Recover remaining fixed-function equivalents and compare actual original frames with matched viewport/event provenance.
- **missing_verification** · vulkan-materials-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### models-animation-layout
**Working behavior:** Original geometry/textures/hierarchies/morphs/sprites/UI resources render with bounded full-Euler and source-pivot bridges.
**Verified scope/platform:** Original-data/managed and historical Linux GPU readbacks; air bridge records 146 observations but final OMT decomposition precision differs.
**Known differences:** Modern sole alignment, loop timing, some actor pivots and full source action/morph/layout lifecycle remain explicit differences.
**Remaining acceptance — OPEN:** Recover final OMT decomposition and playback/actor/UI ownership, then compare authored positions and timing against identified original captures.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** VIS-01 · **Implementation:** {&#x27;revision&#x27;: &#x27;27be8ed63079ae2e3bf7e965ee205c4a57a96559&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/JimmyRenderTransform.cs&#x27;, &#x27;src/GamePort/Game/PlayerAppearance.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: JimmyRenderTransform.cs](../../src/GamePort/Game/JimmyRenderTransform.cs), [Implementation: PlayerAppearance.cs](../../src/GamePort/Game/PlayerAppearance.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;models-animation-layout-coverage&quot;, &quot;result&quot;: &quot;Original geometry/textures/hierarchies/morphs/sprites/UI resources render with bounded full-Euler and source-pivot bridges.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;models-animation-layout-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;models-animation-layout-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;models-animation-layout: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;models-animation-layout-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;models-animation-layout: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **subtle** · models-animation-layout-remaining: Recover final OMT decomposition and playback/actor/UI ownership, then compare authored positions and timing against identified original captures.
- **missing_verification** · models-animation-layout-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
## Audio
### music-speech-banks
**Working behavior:** Original music/speech and 251 RIFF effects exports feed independent SDL streams; CAM stops music and DEFAULT restores it.
**Verified scope/platform:** S/M/R with Linux dummy-device and bounded package stream checks; queue consumption is not original audible timing.
**Known differences:** Software duration integer boundaries, channel allocation/failure/priority, bank/gate/unload/repeat lifetime and unsupported MPEG-in-RIFF remain open.
**Remaining acceptance — OPEN:** Recover bank/channel lifecycle and source software clock, then verify real scene selection/timing/loop/interruption audibly.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** AUD-01 · **Implementation:** {&#x27;revision&#x27;: &#x27;62c07a3d59ca6d71a7456957d8586c268d27c439&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Audio/SceneAudio.cs&#x27;, &#x27;src/GamePort/Audio/SdlAudio.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: SceneAudio.cs](../../src/GamePort/Audio/SceneAudio.cs), [Implementation: SdlAudio.cs](../../src/GamePort/Audio/SdlAudio.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;music-speech-banks-coverage&quot;, &quot;result&quot;: &quot;Original music/speech and 251 RIFF effects exports feed independent SDL streams; CAM stops music and DEFAULT restores it.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;music-speech-banks-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;music-speech-banks-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;music-speech-banks: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;music-speech-banks-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;music-speech-banks: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · music-speech-banks-remaining: Recover bank/channel lifecycle and source software clock, then verify real scene selection/timing/loop/interruption audibly.
- **missing_verification** · music-speech-banks-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
### spatial-audio-listener
**Working behavior:** Scooter positional frequency/history correction uses the shared listener including parked/script cameras; nominal engine formula is preserved.
**Verified scope/platform:** Historical 11 positional-frequency plus 11 follow traces, managed/dummy and Linux SDL replays at fccc0b9; no new audible or Windows proof.
**Known differences:** Global attenuation/pan/channel scheduling, listener ownership across all states and physical speaker/native Windows comparison remain incomplete.
**Remaining acceptance — OPEN:** Recover all positional volume/frequency/listener policies and compare audible original/native output alongside event/stream checks.; Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
**Requirements:** AUD-02 · **Implementation:** {&#x27;revision&#x27;: &#x27;fccc0b9d1b6ae962d32147e4ae1433fce6a1a23e&#x27;, &#x27;paths&#x27;: [&#x27;src/GamePort/Game/ScooterAudio.cs&#x27;, &#x27;src/GamePort/Audio/SceneAudio.cs&#x27;], &#x27;status&#x27;: &#x27;bounded&#x27;, &#x27;note&#x27;: &#x27;Revision identifies the last tracked change to the first implementation path; it is not a runtime/package identity. Unimplemented denotes the named full-scope workflow, not absence of all foundations.&#x27;}
**Sources:** [Retained checkpoint contracts and source-report links](../../docs/checkpoint/coverage.md), [Implementation gates and historical execution ledger](../../docs/checkpoint/implementation-plan.md), [Revision-specific runtime and package status index](../../docs/progress.md), [Platform classifications and limits](../../docs/compatibility.md), [Implementation: ScooterAudio.cs](../../src/GamePort/Game/ScooterAudio.cs), [Implementation: SceneAudio.cs](../../src/GamePort/Audio/SceneAudio.cs)
**Scenarios:** [fresh-natural-edge](scenarios.json), [fresh-natural-ordinary](scenarios.json), [fresh-skipped-edge](scenarios.json), [fresh-skipped-ordinary](scenarios.json), [retained-natural-edge](scenarios.json), [retained-natural-ordinary](scenarios.json), [retained-skipped-edge](scenarios.json), [retained-skipped-ordinary](scenarios.json)
**Current applicable evidence (only the targets below):**
- {&quot;artifacts&quot;: [], &quot;claim&quot;: {&quot;key&quot;: &quot;spatial-audio-listener-coverage&quot;, &quot;result&quot;: &quot;Scooter positional frequency/history correction uses the shared listener including parked/script cameras; nominal engine formula is preserved.&quot;}, &quot;content&quot;: {&quot;report_sha256&quot;: &quot;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&quot;}, &quot;evidence_kind&quot;: &quot;static&quot;, &quot;historical&quot;: false, &quot;id&quot;: &quot;spatial-audio-listener-report&quot;, &quot;method&quot;: &quot;Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture&quot;, &quot;missing_evidence&quot;: [&quot;Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).&quot;], &quot;platform&quot;: {&quot;execution&quot;: &quot;static&quot;, &quot;os&quot;: &quot;source&quot;}, &quot;reason&quot;: null, &quot;receipt_id&quot;: &quot;spatial-audio-listener-report&quot;, &quot;report_path&quot;: &quot;docs/checkpoint/coverage.md&quot;, &quot;revision&quot;: &quot;bdca29d3aa31face0c0023537ff98783716dbc45&quot;, &quot;scope&quot;: [&quot;spatial-audio-listener: documentary coverage only&quot;], &quot;status&quot;: &quot;current&quot;, &quot;supersedes&quot;: []}
**Explicit applicability targets:** [{&#x27;id&#x27;: &#x27;spatial-audio-listener-documentation&#x27;, &#x27;content&#x27;: {&#x27;report_sha256&#x27;: &#x27;4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea&#x27;}, &#x27;platform&#x27;: {&#x27;os&#x27;: &#x27;source&#x27;, &#x27;execution&#x27;: &#x27;static&#x27;}, &#x27;scope&#x27;: [&#x27;spatial-audio-listener: documentary coverage only&#x27;]}]
<details><summary>History — exact revisions and supersession retained</summary>
- No superseded evidence recorded.
</details>
**Player-impact discrepancies:**
- **disruptive** · spatial-audio-listener-remaining: Recover all positional volume/frequency/listener policies and compare audible original/native output alongside event/stream checks.
- **missing_verification** · spatial-audio-listener-verification: Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations).
## Source-row reconciliation
Every checkpoint row remains explicitly linked; continuation reports refine its claims.
- system:LOOP → controller-phases · [retained source](../../docs/checkpoint/coverage.md)
- system:INPUT → controller-phases · [retained source](../../docs/checkpoint/coverage.md)
- system:MOVE → controller-phases · [retained source](../../docs/checkpoint/coverage.md)
- system:JET → gadget-use · [retained source](../../docs/checkpoint/coverage.md)
- system:COLL → body-static-dynamic · [retained source](../../docs/checkpoint/coverage.md)
- system:ANIM → action-animation · [retained source](../../docs/checkpoint/coverage.md)
- system:SCRIPT → authored-scenes-tasks · [retained source](../../docs/checkpoint/coverage.md)
- system:CONTROL → route-control · [retained source](../../docs/checkpoint/coverage.md)
- system:CAMERA → shared-camera-projection · [retained source](../../docs/checkpoint/coverage.md)
- system:AUDIO → music-speech-banks · [retained source](../../docs/checkpoint/coverage.md)
- system:UI → frontend-hud · [retained source](../../docs/checkpoint/coverage.md)
- system:LOAD → physical-helper-lifetimes · [retained source](../../docs/checkpoint/coverage.md)
- system:INVENTORY → inventory-energy · [retained source](../../docs/checkpoint/coverage.md)
- system:SAVE → save-load-return · [retained source](../../docs/checkpoint/coverage.md)
- system:CHECKPOINT → save-load-return · [retained source](../../docs/checkpoint/coverage.md)
- system:SCOOTER → vehicles · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Task records4FC5FC, name+0/state+64 → authored-scenes-tasks · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Current controlled entity5099E4 → route-control · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Scene actor game interface, body, OMT morph → action-animation · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Objective selector4F8194 / transient timing and flags → frontend-hud · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Departed root complete+9A8 → save-load-return · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Return level/start strings → save-load-return · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Pickup checkpoint complete+1E38/+1E48 → save-load-return · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Music/effects/cutscene voice → music-speech-banks · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Viewport/camera target → shared-camera-projection · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Jimmy mode/hold/owned-fire timer → gadget-retention · [retained source](../../docs/checkpoint/coverage.md)
- ownership:Modern application presentation and debug → frontend-hud · [retained source](../../docs/checkpoint/coverage.md)
- assumption:1 → controller-phases · [retained source](../../docs/checkpoint/coverage.md)
- assumption:2 → body-static-dynamic · [retained source](../../docs/checkpoint/coverage.md)
- assumption:3 → authored-scenes-tasks · [retained source](../../docs/checkpoint/coverage.md)
- assumption:4 → shared-camera-projection · [retained source](../../docs/checkpoint/coverage.md)
- assumption:5 → music-speech-banks · [retained source](../../docs/checkpoint/coverage.md)
- assumption:6 → route-control · [retained source](../../docs/checkpoint/coverage.md)
File diff suppressed because it is too large. Load diff
+169
View File
@@ -0,0 +1,169 @@
# Phase 01 combined acceptance session
Materials preparation is separate from acceptance. The final local checkpoint is
`dist/fidelity/phase01`; all 120 obligations remain OPEN until actual captures and
human review. This document prepares the single combined session; it does not
report that any physical, audible, Windows or original fact has been observed.
Read [Windows/DxWnd instructions](windows-session.md) and
[Linux capture instructions](linux-session.md) together. They contain the exact
collector commands, settings, annotation fields and complete procedures. The
sealed packages retain source `446930d2a30d6d616c60ac5e59e4169a840bea09`, dirty true,
diff `90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d`.
The later tools/checklist revision never replaces that runtime provenance.
1. Recheck immutable materials immediately before local transfer:
`python3 tools/recon/fidelity_acceptance.py ready --checkpoint dist/fidelity/phase01`.
Require `materials_ready: true`, separately `acceptance: human_needed`. A changed
package/resource requires a fresh identified checkpoint. Preserve the old bundle.
2. On the actual Windows PC select already installed DxWnd, its original exported
profile, recorder, browser and media tools. Record versions, executable hashes,
Windows/GPU/driver identities and actual settings. Run the bundled PowerShell
preflight and selftests; save their complete positive counts and failures.
3. Use only generated original copies. Retain pristine/pre/retained/post inventories,
original and relocated DxWnd profiles, wrapper limitations and the actual child
launch method. Observe moving game imagery, intelligible game audio, crop and
aspect before recording scenarios. Black/silent captures remain failed evidence.
4. Follow `protocol/agenda.json`: eight fresh/retained × natural/skipped × ordinary/
held-input cells, each with continuous, dialogue-return, bank-left, bank-right,
landing-idle obligations on original-DxWnd and native Windows (80). Follow the
same 40 obligations on native Linux. Retained departure/return must remain in
one process/clock. Continuous is lab → VR04 → lab → outside. No fixture, warp,
Wine, cross-publish, injected input or second fresh launch fills these slots.
5. Complete Linux real-display, physical-input and actual audible-device checks.
The saved `linux-01-06-matrix-preflight-linux` failure explains the current TTY/
auto_null limitation; it proves no captured gameplay. Retain failed/aborted/
skipped results and use fresh launch IDs for retries.
6. Review actual paired recordings in the identified local browser, including
decode/playback, seeking, complete tails, exclusive audio, corresponding events,
raw elapsed/event drift, actual speed and optional overlays. Keep source MKV,
derivation tool/hash/argv/time mapping and visible review gain. Do not invent
timing/pixel/angle/audio thresholds or hide drift through retiming.
7. Record the following named human findings with reviewer and concrete notes:
`A1` original moving imagery/intelligible audio/DxWnd limits; `A2` actual browser
decode/seek/exclusive audio; `EVID-02-unclassified` original capture boundaries;
`EVID-04-unclassified` native route/input/audio/identity; `P1` preservation;
`P2` honest unretimed/unmixed/non-synthetic comparison; `P3` history/full-scope/
native transparency; `browser`; `paired_review`; `physical_input`. A1/A2 are
separate from the two flagged assumptions. Insufficient observation remains
human_needed; descriptor-less P1/P2/P3 cannot be automatically dismissed.
8. Return the complete tree once by local filesystem/USB/existing local share.
Compare mutable result/original-run inventories with the source transfer
inventory, recheck READY/manifest and every linked hash before atomic import.
Keep packages, original copies and media local and ignored.
## Result reconciliation contract — integration agent only
The human tester collects, observes and returns the tree. The integration agent
performs the following local reconciliation after return; the tester is never
asked to engineer JSON or run the Python tooling. No normalized gameplay receipt
exists yet. Do not run reconciliation on failed/skipped/aborted/incomplete runs as
if they were successful; import those unchanged as diagnostic history.
Keep raw collector receipts immutable. Use the existing receipt importer on a
fresh local result destination; it validates hashes/containment and rejects
conflicting duplicates. Reviewed acceptance receipts are separately authored
records retaining the raw collector identity, actual media/events and limitations;
they must satisfy the shared receipt schema, source/package/resource binding and
full scenario continuity. Raw collection success never becomes review success.
Windows source/package/resources initially identify the exact `fidelity-build.json`
seal. Original reviewed receipts additionally identify the unchanged original
inventory and actual generated-copy pre/post inventories; missing raw collector
fields require evidence-backed normalization, never invented values.
Work on a **fresh sibling derived directory** for each captured raw receipt. Copy
every raw referenced file byte-identically into that directory, copy the raw
`receipt.json` as `raw-receipt.json`, and preserve `raw-receipt.sha256`. Make the
reviewed receipt a new ID ending `-reviewed`; retain the original launch/session
and clock IDs. Add the hashed raw receipt to `artifacts` with role `diagnostic`.
The integration agent uses this exact mapping; every new path is inside that fresh
derived directory and every identity uses `identify_file(actual_path)` including
SHA-256, size and header. No path or command from returned metadata is executed.
| Reviewed field | Actual source and required validation |
|---|---|
| Native executable | Raw identity copy; match manifest package executable SHA-256 |
| Native package | Exact selected RID's copied `fidelity-build.json`; match sealed package SHA-256 |
| Windows native source/resources | Same actual `fidelity-build.json` file; retain its source commit/dirty/diff fields. Resources are proven by exact full seal equality |
| Linux native source | Raw `identity/BUILD-INFO.txt`, with commit/dirty/diff taken from the matching exact package seal |
| Linux native resources | Raw `identity/resources.json`, exactly equal to manifest package resources |
| Original executable | Actual selected executable from the generated run (`Neutron.exe` or the recorded selected variant); retain its exact pristine relative path in `identity.executable.original_member` and compare size/header/hash to that member, retaining any mismatch as open |
| Original package/resources | Both identify hashed `identify_tree(original-pristine)` inventories whose complete file records and recomputed digest equal the checkpoint baseline. Generated-copy pre/post inventories remain separate; preserve all raw original content identities |
| Original pre/post | Save complete actual `identify_tree(original-pristine)` before/after return validation; require files and tree digest equal to the baseline and manifest original_pre. These describe authoritative/pristine preservation, separately from writable copy changes |
| Original copy pre/post/retained | Raw `copy-pre.json`, `copy-post.json`, `retained-copy.json`; preserve exact actual bytes/hashes in `identity.copy_pre`, `identity.copy_post`, `identity.retained_copy`. For both lifetimes bind `copy_pre_sha256` to the named pre record; retained runs also bind `retained_copy_sha256` to the named retained snapshot. Native reviewed runs use the same explicit state-record contract |
| Original source/launcher | Save manifest `tool_source` as `collector-source.json` and identify the actual bundled Windows collector; source commit/dirty/diff describes collector tooling, never recovered original source code |
| Original DxWnd/profile | Retain hashed actual `dxwnd-tool.json`, source profile and relocated export; explicit wrapper settings/limits are required |
| Platform/version/GPU/driver/Vulkan/SDL | Actual raw queries and human device/version records; absent observations remain missing, never guessed |
| Events/continuity/derivatives | Preserve actual raw values and hashed media; supplement only from observed annotations with methods/uncertainty; never generate invented markers |
| Review | Set visible/audible/ordinary_input/human_reviewed true only from the named, receipt-bound actual reviewer findings |
For example a Windows native raw receipt `port-fresh-natural-ordinary-continuous-01`
already identifies `identity/build.json` as source/package/resources. Its reviewed
identity retains that **same file/hash**, keeps source commit/dirty/diff from its
contents, and binds executable to manifest `packages.win-x64.executable`. It does
not substitute BUILD-INFO for that raw source or regenerate a package seal.
The reviewed record's minimal projection looks like this (metavariables below
are populated from the actual retained records by the integration agent):
```json
{
"receipt_id": "port-fresh-natural-ordinary-continuous-01-reviewed",
"session_id": "port-fresh-natural-ordinary-continuous-01",
"status": "reviewed",
"identity": {
"source": {"path":"identity/build.json", "sha256":"ACTUAL_SEAL_HASH", "size":0,
"header":"ACTUAL_HEADER", "commit":"ACTUAL_BUILD_COMMIT", "dirty":true,
"diff_sha256":"ACTUAL_BUILD_DIFF"}
},
"review": {"visible":true,"audible":true,"ordinary_input":true,"human_reviewed":true},
"acceptance": {"state":"accepted","remaining":[]}
}
```
This projection is **not a usable receipt or positive finding**: retain all other
required raw fields, replace every metavariable/size with identified actual values,
keep limitations/discrepancies, and include missing identity mappings above.
Clear `missing_evidence` and acceptance remaining only when each corresponding
fact has actually been supplied and reviewed. Otherwise preserve the gap and
`state: open`. The shared validator and strict audit reject incomplete reviewed
records. Do not overwrite raw receipts or label normalized copies as raw captures.
After writing the complete derived receipt, the agent validates/imports with the
existing API (run from repository root; substitute the actual derived directory):
```sh
PYTHONPATH=tools/recon python3 -c 'from pathlib import Path; from fidelity_receipts import read_receipt,validate_receipt,import_receipt; p=Path("LOCAL_DERIVED/receipt.json"); print(validate_receipt(read_receipt(p),p.parent)); print(import_receipt(p,p.parent,Path("dist/fidelity/phase01/results/imported")))'
```
An absent mapping or unobserved human fact is an OPEN result. Never manufacture
source, original, device, media or review identities to make this command pass.
In `results/current.json`, list the explicit current receipt paths as
`{"receipts":["imported/receipt-id/receipt.json"]}`. Preserve historical/superseded
records outside that selection. Conflicting duplicate slots cannot be selected.
In `results/human-review.json`, use `schema_version: 1`, exact selected
`receipt_ids`, a `receipt_sha256` object mapping each ID to its actual receipt hash,
and `checks` mapping every name above to `{ "observed": true, "reviewer":
"actual reviewer", "notes": "specific observation and limitations" }`. Empty or
false findings remain pending. These fields describe witnessed facts; tools never
generate positive human findings.
Run strict audit on the complete local result tree:
`python3 tools/recon/fidelity_acceptance.py audit --checkpoint dist/fidelity/phase01 --results dist/fidelity/phase01/results --require-complete`.
Nonzero means acceptance remains open. `--allow-open` may return zero for structural
inspection while explicitly reporting human_needed and every missing obligation;
it never satisfies EVID-02/EVID-04. Export actual paired selected receipts with the
existing `fidelity_review.py export` command; the prepared viewer starts empty.
## Pending acceptance checklist
- [ ] Original-DxWnd 40 obligations, actual imagery/audio/input and wrapper review.
- [ ] Native Windows 40 obligations, physical input/audio and exact runtime identity.
- [ ] Native Linux 40 obligations, real display/audio and physical input.
- [ ] Actual paired browser playback, seeking, exclusive audio and exposed drift.
- [ ] Both unclassified assumptions, A1/A2 backstops and P1/P2/P3 dispositions.
- [ ] Returned identities and strict audit passed; current/history discrepancies reconciled.
Phase 1 and all EVID requirements remain pending. The roadmap permits independent
source-backed recovery while these access dependencies remain open; it does not
waive them or authorize broader gameplay admission.
+177
View File
@@ -0,0 +1,177 @@
# Local Linux fidelity capture
This joins the single final combined session described in
[windows-session.md](windows-session.md). Prepare locally; no early hands-on
session is requested. Every original/native acceptance obligation remains open
until actual evidence and human review. No gameplay/movement reset is added.
Use the existing sealed Linux package, not a rebuilt or relabeled package.
The 01-05 package is `artifacts/fidelity/01-05-packages/linux-x64`:
source `446930d2a30d6d616c60ac5e59e4169a840bea09`, dirty yes, publish diff
`90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d`.
Its file-list hash is `124cf271e4952f3822eec5c24358447fcffc9e9e1803aded8d96d4d4472dc5a3`.
The collector checks all sealed bytes before launch and collection. Keep output
outside the package and originals, in a fresh session directory.
Select the actual local X11 display and capture rectangle, real Pulse monitor
source and physical input method. Save a local JSON settings object with these
exact fields (values below are examples, not observed devices):
```json
{"display_method":"x11","display":":0","audio_method":"pulse",
"audio_source":"actual-device.monitor","input_method":"physical",
"size":"1280x720","offset":"0,0"}
```
Inspect `pactl list short sources` and `pactl list short sinks` locally. Null/dummy
devices do not qualify. This collector implements X11/Pulse capture with installed
FFmpeg/ffprobe; it records unsupported Wayland/TTY/dependency conditions as failed
preflight. Do not install or select a guessed alternative automatically. Use a
separately identified existing recorder for unsupported display sources and retain
its actual settings, tool identity, raw recording and timing provenance.
```sh
bash scripts/collect-fidelity-linux.sh preflight --package artifacts/fidelity/01-05-packages/linux-x64 --settings /local/linux-settings.json
bash scripts/collect-fidelity-linux.sh run --package artifacts/fidelity/01-05-packages/linux-x64 --settings /local/linux-settings.json --output artifacts/fidelity/linux/unique-launch --session-id unique-launch --case-id fresh-natural-ordinary --scope dialogue-return --seconds 120
bash scripts/collect-fidelity-linux.sh collect --run artifacts/fidelity/linux/unique-launch --import-to artifacts/fidelity/linux-receipts
```
Nonzero run/collect exits preserve failure/abort output; inspect it, and collect
the failed run too. Recorder starts before the normal `--load-save NewGame.tsk
--walk` process and passive observer. This is the existing story entry, not an
implemented main menu. Close the game normally before the selected duration.
Both children have one bounded deadline; interruption ends only owned children.
Logs and metadata have explicit bounds; raw recording is capped at 8 GiB. Retain
the entire lossless FFV1/PCM MKV and tail; a detected frozen interval is an open
inspection flag, not a claim of failure or parity derived from a numeric tolerance.
Collection probes actual streams/duration and hashes logs/media/observer and
package/source/resource identities. The duplicate MKV audio alias preserves exact
bytes for the shared receipt's distinct audio role. No audio normalization,
retiming, crop repair or preview is implicit. If a browser needs a remux/preview,
retain raw media and explicit derivation command/version/hash/time mapping under
the existing shared derivative contract. The local viewer exporter consumes the
imported receipts; actual playback/seeking/audio/crop remain human review gates.
Record manual event annotations as `{"events":[...]}` using the exact fields in
`scenarios.json`: hashed raw artifact name, media and monotonic elapsed seconds,
method and uncertainty. Supply `collect --annotations /local/annotations.json`.
Port simulation ticks remain separate from raw clocks. Observer gate results
do not prove a physical key was pressed. Automated injection is `port_fixture`;
test doubles are permanently synthetic. No collector output grants acceptance.
## Actual 2026-11-13 preflight
The scoped host probe, outside sandbox device restrictions, found a TTY session,
no `DISPLAY` or `WAYLAND_DISPLAY` and no X11 socket. Existing FFmpeg/ffprobe are
available. Pulse exposes only `auto_null` and `auto_null.monitor` (suspended).
No Xvfb or OBS command resolved. A synthetic display or null audio would not
establish the requested normal visible/audible gameplay, so no game/recorder
was launched and no substitute route/media was fabricated.
The exact failed focused receipt is `linux-01-06-focused-preflight-linux`, at
`artifacts/fidelity/linux/01-06-focused-preflight/receipt.json`, imported into
`artifacts/fidelity/linux-receipts/linux-01-06-focused-preflight-linux/`.
`preflight.json` preserves observed OS, tool versions/hashes, Pulse devices and
available GPU/Vulkan diagnostics; missing SDL/active-instance runtime versions
remain explicit. The selected package/resource seal matches the hash above.
Both the failed result and its import validate structurally, with acceptance open.
Before collection, all 539 original files verified unchanged.
Required next physical session: provide an actual display/game capture source
and real audible device/monitor source, verify moving unobstructed content and
audio, then record physical normal controls and full tails. Inspect capture cost,
crop/aspect and actual browser playback/seeking separately. Preserve this failed
preflight as history; new attempts use new session IDs and fresh output roots.
## Full matrix and the final combined agenda
The current typed dependency receipt is
`linux-01-06-matrix-preflight-linux`, at
`artifacts/fidelity/linux/01-06-matrix-preflight/receipt.json`, imported under
`artifacts/fidelity/linux-current-receipts/`. The earlier task-1 receipt is
retained diagnostic history; select the current typed receipt for scenario audit.
`artifacts/fidelity/linux/01-06-matrix.json` enumerates every obligation, exact
procedures/events, failed attempt ID and shared display/audio dependency.
There were no runnable native cells after that common dependency failed. The
collector does not manufacture 40 failed game launches or unrelated scene clips.
In this table **OPEN** means the exact current dependency receipt above plus
the named cell/obligation's actual recording, lifetime evidence and human review.
| Cell | continuous | dialogue-return | bank-left | bank-right | landing-idle |
|---|---|---|---|---|---|
| fresh-natural-edge | OPEN | OPEN | OPEN | OPEN | OPEN |
| fresh-natural-ordinary | OPEN | OPEN | OPEN | OPEN | OPEN |
| fresh-skipped-edge | OPEN | OPEN | OPEN | OPEN | OPEN |
| fresh-skipped-ordinary | OPEN | OPEN | OPEN | OPEN | OPEN |
| retained-natural-edge | OPEN | OPEN | OPEN | OPEN | OPEN |
| retained-natural-ordinary | OPEN | OPEN | OPEN | OPEN | OPEN |
| retained-skipped-edge | OPEN | OPEN | OPEN | OPEN | OPEN |
| retained-skipped-ordinary | OPEN | OPEN | OPEN | OPEN | OPEN |
Follow `scenarios.json` literally. Continuous recording begins before startup or
retained setup and keeps lab → VR04 → lab → outside in one process/clock and raw
video. Use normal supported controls/gadget/RETURN, without warps/grants. Focused
clips have their own declared setup and never substitute for the continuous run.
Natural dialogue reaches its real end; skipped dialogue records the actual skip
key and observed skip/end boundaries. Ordinary play releases movement at return;
edge play records held input through dialogue and RETURN, release/first-neutral,
independent left/right banked jumps, landing and idle. Preserve legitimate bank,
TSK-retained story input order and distinct fresh direct-scene observations.
No blanket angle/pixel/timing/audio tolerance or leveling repair is implied.
For each fresh observation, use a new launch/session ID and separately identified
generated execution copy; verify its existing seal rather than rebuilding it.
Keep the source package immutable. The collector records the selected package
root and sealed pre/post identities; copying/staging is an explicit local step,
not an invented copy claim. The prepared checkpoint's immutable Linux package is
also available for a verified local copy. Never select the original installation.
For retained observations, keep one actual process, copy and clock across visible
prerequisite lab departure to VR04 and return, then the tested interval. Capture
the real generated-copy state while that process remains alive; a later launch
or synthetic snapshot cannot replace the prerequisite. Use a separate terminal
to save the observed state records inside the run directory before finalization.
Annotations may declare `artifact_roles` mapping contained recording paths to
`prerequisite`, `identity_files` mapping `copy_pre`, `retained_copy`, `copy_post`
to actual contained state-record paths, and `continuity` with `lifetime_id`,
`prerequisite_artifact`, `copy_pre_sha256`, and for retained runs
`departure_session_id`, `return_session_id`, `retained_copy_sha256`.
All hashes refer to actual identity records. The selected prerequisite recording
must have a probed duration, and prerequisite events precede the tested interval.
A byte-identical alias of raw media can identify its prerequisite role without
retiming; preserve its exact bytes. The collector never invents these observations.
`clocks.clock_id` identifies the outer capture clock; preserve the passive observer
clock's separate origin and annotate any alignment/uncertainty explicitly.
Export/update the checklist with an unused output filename:
```sh
bash scripts/collect-fidelity-linux.sh matrix --receipt artifacts/fidelity/linux-current-receipts/linux-01-06-matrix-preflight-linux/receipt.json --dependency-run artifacts/fidelity/linux/01-06-matrix-preflight --output artifacts/fidelity/linux/new-matrix.json
```
For interrupted work, pass `--previous /local/prior-matrix.json` and repeat
`--receipt` for new attempts. Old receipts are re-read and hash-checked; reused
or conflicting session/receipt IDs are rejected. Preserve failed/incomplete
history, retry only missing/incomplete obligations, and use fresh IDs/directories.
Do not hand-edit history to imply completed cells. Shared scenario validation
checks chronological required markers, one recording and retained identity;
the final acceptance audit still owns review and applicability selection.
The single final session adds these Linux actions to the Windows/original agenda:
1. Verify all 539 authoritative originals before staging and after collection with
`python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json`.
2. Select real display/audio and identified installed recorder/probe; perform a
short moving-content, audible-output, crop/aspect and physical-control check.
3. Record all 40 obligations with their real setup/lifetime; retain raw video/audio,
accepted gate/observer logs, manual input descriptions, clocks and uncertainty.
4. Import current applicable receipts and export local paired review. Verify actual
browser playback/seeking/tails at normal speed and exclusive original/port audio;
retain any preview's exact derivation and raw source. Review capture overhead.
5. Recheck source/package/original identities and matrix history, retain remaining
discrepancies/open dependencies, and transfer results locally together once.
The Linux subset is **0/40 accepted**. The full three-side protocol remains
**0/120 accepted**: original-DxWnd/native Windows/physical audible review are open.
+44
View File
@@ -0,0 +1,44 @@
# Phase 01 evidence baseline — preparation, acceptance OPEN
The final acceptance checkpoint is `dist/fidelity/phase01`, freshly assembled from
the existing sealed 01-05 packages plus the final Linux/audit/session materials.
Prepared identities and generated media remain local and ignored. Runtime source:
`446930d2a30d6d616c60ac5e59e4169a840bea09`, dirty true; publish diff:
`90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d`.
Original files remain governed by `docs/original-manifest.json` (539 files).
| Proof category | Current result | Acceptance |
|---|---|---|
| Immutable local tools/protocol/packages | Separate readiness audit | Materials only |
| Actual original-DxWnd | No returned gameplay recordings | OPEN 0/40 |
| Native Windows | Cross-publish/resource identity only | OPEN 0/40 |
| Native Linux physical/audible route | Failed TTY/null-audio preflight | OPEN 0/40 |
| Actual paired browser/audio review | No original/native recording pair | human_needed |
The retained actual diagnostic receipt is
`linux-01-06-matrix-preflight-linux`, from
`artifacts/fidelity/linux-current-receipts/`. It records no selected X11 display,
only `auto_null.monitor`, absent recording and absent observer events. No game was
launched. This is failed native preflight evidence, not native gameplay acceptance.
Historical Wine/component/GPU results keep their original scope and revision.
The strict audit reports every missing case/obligation and rejects synthetic,
misclassified, stale, wrong-resource, historical/conflicting or unreviewed evidence.
Its metadata unit fixtures exercise both complete coverage and rejection behavior;
their invented media/observations are never imported as runtime proof.
## Remaining discrepancies and judgments
The blocking gaps are actual original-DxWnd and native Windows execution, Linux
display/audio/physical-input access, complete 120-obligation captures, returned
media identity and real paired review. The NewGame.tsk story entry is not the
original main menu. DxWnd wrapper/timing/render behavior must remain separately
identified. No universal timing/pixel/audio tolerance is asserted.
A1 (original moving imagery/intelligible audio) and A2 (actual browser playback,
seek and exclusive audio) remain **human_needed**. EVID-02/EVID-04 unclassified
assumptions remain unresolved/flagged; P1 preservation, P2 honest comparison and
P3 history/native transparency require explicit final judgment. Follow the single
[combined session checklist](checkpoint-session.md). All EVID requirements and
Phase 1 acceptance remain OPEN under the roadmap source-backed continuation
exception. No movement, rendering, gameplay or collision admission changed.
+99
View File
@@ -0,0 +1,99 @@
{
"schema_version": 1,
"protocol_id": "phase01-baseline-v1",
"description": "Procedures and obligations only. No runtime acceptance is asserted by this document.",
"decisions": ["D-01", "D-02", "D-03", "D-04", "D-15"],
"required_sides": [
{"id": "original-windows-dxwnd", "evidence_kind": "original_dxwnd", "os": "windows"},
{"id": "port-linux-native", "evidence_kind": "native_port", "os": "linux"},
{"id": "port-windows-native", "evidence_kind": "native_port", "os": "windows"}
],
"cells": [
{"id": "fresh-natural-edge", "lifetime": "fresh", "dialogue": "natural", "input": "edge", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]},
{"id": "fresh-natural-ordinary", "lifetime": "fresh", "dialogue": "natural", "input": "ordinary", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]},
{"id": "fresh-skipped-edge", "lifetime": "fresh", "dialogue": "skipped", "input": "edge", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]},
{"id": "fresh-skipped-ordinary", "lifetime": "fresh", "dialogue": "skipped", "input": "ordinary", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]},
{"id": "retained-natural-edge", "lifetime": "retained", "dialogue": "natural", "input": "edge", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]},
{"id": "retained-natural-ordinary", "lifetime": "retained", "dialogue": "natural", "input": "ordinary", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]},
{"id": "retained-skipped-edge", "lifetime": "retained", "dialogue": "skipped", "input": "edge", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]},
{"id": "retained-skipped-ordinary", "lifetime": "retained", "dialogue": "skipped", "input": "ordinary", "obligations": ["continuous", "dialogue-return", "bank-left", "bank-right", "landing-idle"]}
],
"lifetime_procedures": {
"fresh": {
"setup": "Allocate an independently verified generated copy and new launch/session ID for each run. Record copy_pre identity. For the port, identify the actual package and its existing startup path; do not reset gameplay state to fit the procedure.",
"actions": "Record startup and ordinary New Game/TSK lab entry visibly. A direct fresh-scene fixture is a separate observation, not a replacement for New Game.",
"end_condition": "The requested continuous or focused procedure ends in this independently identified launch. Never reuse a fresh-session ID for another required run."
},
"retained": {
"setup": "Begin recording in one verified generated copy/launch. Visibly establish lab departure to VR04 and return as prerequisite setup before the retained test. Hash the prerequisite recording and retained copy state; preserve the original copy_pre identity.",
"actions": "Keep departure_session_id and return_session_id equal to the same session_id/lifetime_id. Record prerequisite_departure and prerequisite_return markers on the hashed prerequisite_artifact before the tested interval. Bind copy_pre_sha256 and retained_copy_sha256 to actual identified records. Continue the required scenario without terminating, restaging, loading unrelated state or resetting clocks.",
"end_condition": "Evidence includes prerequisite setup, retained copy identity and the actual departure/return in the same process lifetime. A second fresh launch cannot count as retained."
}
},
"dialogue_procedures": {
"natural": "Approach Carl through normal play, let dialogue and its return complete naturally, then observe the first resumed input and neutral idle. Do not press skip.",
"skipped": "Approach Carl through normal play, visibly perform the supported skip input, record the observed skip and dialogue completion boundary, then observe resumed input and neutral idle. Record the actual chosen key; do not infer original sampling."
},
"input_procedures": {
"ordinary": "Use normal physical play inputs. Release movement at dialogue/control return, observe the first neutral input, perform separately visible left and right banked jumps, land and remain idle. Record actual input description and audible/visual output.",
"edge": "Deliberately hold movement through the dialogue boundary, observe resumed held input, then release and record first neutral input. Perform left and right banked jumps, land and remain idle. Hold a declared direction through RETURN and record cleanup/resumption. Preserve legitimate landing bank."
},
"dialogue_events": {"natural": ["dialogue_end"], "skipped": ["dialogue_skip", "dialogue_end"]},
"input_events": {"ordinary": [], "edge": ["resumed_held_input", "held_dialogue", "held_return"]},
"obligations": {
"continuous": {
"route": ["lab", "VR04", "lab", "outside"],
"setup": "Apply the cell's lifetime, dialogue and input procedures. Start one uninterrupted video/audio recording before startup/control or retained prerequisite setup. Identify package, copy, launcher and platform.",
"actions": "In the lab, complete Carl dialogue according to policy, observe resumed/neutral input, perform left/right banked jumps, land and idle. Depart normally to VR04, use its existing supported gadget, invoke ordinary RETURN, observe gadget cleanup and lab return, then take the ordinary lab exit to outside. Keep one process lifetime and one continuous video for the route. No debug warp, scene snapshots or injected smoke input substitutes.",
"end_condition": "Jimmy visibly arrives outside after lab -> VR04 -> lab in the same run; audio/input events and cleanup are reviewable, with missing/failed transitions reported honestly.",
"required_events": ["startup", "control", "dialogue_start", "dialogue_end", "first_neutral_input", "jump_left", "bank_left", "landing_left", "jump_right", "bank_right", "landing", "idle", "lab_departure", "vr04_entry", "vr04_use", "return_cleanup", "lab_return", "lab_exit", "outside_arrival"],
"required_artifact_roles": ["video", "audio", "input_events", "prerequisite"]
},
"dialogue-return": {
"setup": "Apply the cell's visible lifetime prerequisite, then approach Carl with the chosen natural/skipped and ordinary/held-input policy. Record setup before the focused clip.",
"actions": "Observe dialogue activation, actual natural completion or skip, first resumed held input when applicable, release to first neutral input and sustained idle. Record method/uncertainty at each observed boundary.",
"end_condition": "Control has resumed and neutral idle is visibly recorded, without inserting any leveling reset.",
"required_events": ["dialogue_start", "dialogue_end", "first_neutral_input", "idle"],
"required_artifact_roles": ["video", "audio", "input_events", "prerequisite"]
},
"bank-left": {
"setup": "Apply the cell lifetime and record the supported normal standing/moving setup. Preserve the actual selected camera/control state.",
"actions": "Use ordinary physical jump and Left/A to visibly bank left, release as prescribed, land and observe the resulting pose. Record exact physical keys and actual elapsed/media markers.",
"end_condition": "The left bank and landing are both visible; orientation is observed rather than forced upright.",
"required_events": ["jump_left", "bank_left", "landing"],
"required_artifact_roles": ["video", "audio", "input_events", "prerequisite"]
},
"bank-right": {
"setup": "Apply the same cell lifetime independently and record the supported normal standing/moving setup.",
"actions": "Use ordinary physical jump and Right/D to visibly bank right, release as prescribed, land and observe the resulting pose. Do not mirror or relabel the left recording.",
"end_condition": "The right bank and landing are independently visible and audible.",
"required_events": ["jump_right", "bank_right", "landing"],
"required_artifact_roles": ["video", "audio", "input_events", "prerequisite"]
},
"landing-idle": {
"setup": "Apply the cell lifetime. Record a real jump/landing setup with support visible; retain the actual body and camera state.",
"actions": "Observe landing, release movement and record sustained idle at actual speed. Keep any legitimate landing bank and record discrepancies rather than tuning them away.",
"end_condition": "Landing and a reviewable idle interval are captured; no universal duration/angle/pixel/audio tolerance is inferred.",
"required_events": ["landing", "idle"],
"required_artifact_roles": ["video", "audio", "input_events", "prerequisite"]
}
},
"event_contract": {
"fields": ["name", "artifact", "media_seconds", "elapsed_seconds", "method", "uncertainty_seconds"],
"original_method": ["manual", "procedural"],
"simulation_ticks": "separate_port_only",
"clocks": "Finite monotonic elapsed seconds from one identified clock_id; actual media seconds on hashed raw recordings. Preserve clock offsets and uncertainty. Do not reset or normalize clocks at scene transitions.",
"continuity": "Continuous route events reference one video artifact in chronological order. Independent scene snapshots cannot satisfy this obligation.",
"derivatives": "Preserve raw recordings; each preview/still links its hashed source, actual tool/version/command and any crop/timing changes. Never silently retime.",
"tolerances": "No blanket timing, pixel, angle or audio threshold; later system-specific acceptance needs authoritative evidence."
},
"protected_observations": {
"tsk_retained_order": "Preserve implemented menu/background Jimmy-before-level-input successful TSK entry; docs/gameplay/main-menu-player-lifetime.md.",
"fresh_direct_scene_order": "Fresh direct-scene order remains a distinct observation; do not apply retained-story classification universally.",
"legitimate_landing_bank": "Observe and preserve legitimate landing bank; never substitute an unsupported leveling reset."
},
"acceptance": {
"structural_readiness": "--allow-open checks the complete protocol while reporting every missing case/obligation. It is not native/reference acceptance.",
"complete": "--require-complete requires all 8 cells x 5 obligations x 3 independently identified original/native sides, hashed artifacts, chronological markers, lifetime continuity and actual human audiovisual review. Failed/skipped/aborted/missing captures remain open. D-13 availability, launcher exit zero, fixtures, component probes, Wine and cross-publish do not fill any slot."
}
}
+210
View File
@@ -0,0 +1,210 @@
# One combined local Windows fidelity session
This is the prepared agenda for plan 01-07, not a request to capture now.
`READY.json` means immutable materials are prepared. It never means original,
native Windows, browser, audio or scenario acceptance passed. Linux PowerShell
selftests, cross-publish, Wine and synthetic media cannot fill those slots.
Keep every package, original copy, raw recording and result on local storage.
The checkpoint contains `manifest.json`, `READY.json`, both identified
`port/{linux-x64,win-x64}` packages, `original-pristine/`, writable
`original-runs/`, `protocol/`, offline `review/`, collectors, these instructions,
package-free selftests and `results/`. No SDK or Python is needed on Windows.
The manifest records actual package BUILD-INFO and sealed source identities;
the later bundle revision does not replace the runtime's source identity.
Do not alter immutable materials to make a preflight pass. Mutable results and
generated run copies stay outside that immutable hash set.
## Ordered session agenda
1. **Select local dependencies and capture provenance.** Transfer the entire
prepared checkpoint to a fresh local directory, preferably a short path with
sufficient recording space. Select the actual Windows PC, DxWnd executable,
original exported DxWnd profile, recorder, browser and any media-probe/
derivation executables already installed locally. No download, installer
redistribution, elevation or guessed DxWnd switches are part of this bundle.
Copy `protocol/settings-template.json` into `results/session-settings.json`
and fill observed values. Record each tool's actual local source, version,
SHA-256, settings/export and limitations, Windows build, GPU/driver, Vulkan
and SDL versions as actually available; missing identities remain pending.
The collector hashes selected external tool executables without copying them
into returned results. Retain settings/profile exports, not installers.
Initial recorder recommendation: **offline OBS Display Capture**, with the
actual monitor, capture source, crop/aspect, resolution/frame rate, encoder,
audio device/mix and MKV container recorded. Record notification/desktop
exposure and wrapper timing/rendering limitations in the local notes.
2. **Run immutable preflight and package-free selftests.** From the checkpoint
directory run the following exact commands. Require exit zero, at least eight
executed checks and zero failures; preserve the output in local session notes.
A missing PowerShell or dependency is a failure to record, not a silent pass.
```powershell
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Preflight
powershell.exe -NoProfile -File .\tests\fidelity-windows.Tests.ps1
```
PowerShell 5.1 is the Windows target; a `pwsh` run on Linux exercises tooling
only. Executables are launched directly with quoted arguments, never from
receipt-supplied commands. Keep script execution subject to the PC's existing
policy; record a policy failure rather than changing security policy here.
3. **Perform separate short original and native-port visual/audio preflights.**
Use new diagnostic IDs for each. Inspect the selected DxWnd distribution's
own local help/config. Import the user's retained exported profile and change
only executable/working-directory paths to the generated copy printed by the
collector; export that relocated profile to the result's artifacts directory.
Do not force timer, renderer or compatibility settings or guess profile syntax.
If automation is unsupported, use the transparent DxWnd GUI launch. Retain
original and relocated exports and describe exact changes. The collector opens
DxWnd with no assumed switches and does not infer the original child's exit.
Never select the authoritative installation or `original-pristine/` as target.
Play each raw preflight: require **visible moving game content, intelligible
game audio, correct crop and aspect**, rather than merely detected ffprobe
streams. Record failures before proceeding. Keep diagnostic runs separate
from required cases. Native port launch uses the existing NewGame.tsk story
entry; absence of a reconstructed menu remains an explicit comparison gap.
4. **Record all matrix cells and obligations.** Use `protocol/agenda.json` as
the checklist: 8 cells × 5 obligations × 2 Windows sides = **80 Windows
obligations**. The separate Linux side contributes 40; all **120** remain
subject to actual receipt validation and human review. The table below and
`protocol/scenarios.json` specify the matrix, actual route, required events
and end conditions. Each fresh run has a new launch ID and original copy.
For retained runs, record prerequisite lab departure to VR04 and return in
the same process/clock before the tested interval; do not relaunch or reset
state. Capture the retained generated-copy identity during that lifetime
with `-Action Retained`, preserving the original pre-copy identity. Start the
recorder before interaction, retain the entire raw MKV and audible tail,
then finalize the specific scope after the process ends. Follow each cell's
natural/skip and ordinary/held-input procedure through its focused setup.
5. **Review paired browser video and exclusive audio.** Open `review/index.html`
using the selected local browser. Return results are imported into a fresh
local review export for pairing; the initially empty viewer does not invent
captures. Preserve actual speed and separate raw clocks, annotate offsets,
playback drift, crop and uncertainty. Listen to only one source at a time.
Require actual browser playback/seeking/audio checks for every preview codec.
A codec name, probe success or file extension is insufficient. Retain raw MKV
even if the browser cannot decode it. If a preview or extracted WAV is needed,
use a selected existing local tool and retain exact executable/version/hash,
inert argv, UTC derivation time, raw/output identities, timestamp mapping and
crop/aspect changes. Never silently retime or discard the source. Record
unsupported codecs or inaudible/missing content as open failures.
6. **Collect, postflight and audit.** Finish each run with actual annotations,
recording files, observer logs, settings, DxWnd exports and limitations.
Include missed, skipped, aborted, crashed and incomplete runs. A process exit
or `captured` means collection only. Original-DxWnd provenance is separate
from native port receipts. Preserve generated originals and their post-run
changes, `copy-pre.json`, `retained-copy.json` where applicable and
`copy-post.json`; never restore them over the authoritative originals.
Re-run immutable preflight after collection and preserve output. Actual
review verdicts and shared schema/matrix validation remain separate gates.
7. **Return once using local transfer.** Copy the complete checkpoint (including
raw recordings, results and original-runs) by USB/local filesystem or existing
local share to a new return directory. Do not upload assets/packages/media.
Recheck manifest/READY SHA-256 and all immutable entries, then rehash all
receipt-linked artifacts on return using the shared Python receipt validator.
Preserve a source-side file/hash inventory for the mutable result and
original-runs trees and compare it with the returned copy before importing.
A mismatch or missing file is an explicit transfer failure. Do not overwrite
the source copy, canonical originals, historical packages or an earlier return.
## Matrix and required procedures
| Case ID | Lifetime | Carl dialogue | Physical input policy |
|---|---|---|---|
| fresh-natural-edge | Independent fresh launch | Natural completion | Held through dialogue/RETURN |
| fresh-natural-ordinary | Independent fresh launch | Natural completion | Ordinary play/release |
| fresh-skipped-edge | Independent fresh launch | Actual supported skip | Held through dialogue/RETURN |
| fresh-skipped-ordinary | Independent fresh launch | Actual supported skip | Ordinary play/release |
| retained-natural-edge | Observed departure/return, same lifetime | Natural completion | Held through dialogue/RETURN |
| retained-natural-ordinary | Observed departure/return, same lifetime | Natural completion | Ordinary play/release |
| retained-skipped-edge | Observed departure/return, same lifetime | Actual supported skip | Held through dialogue/RETURN |
| retained-skipped-ordinary | Observed departure/return, same lifetime | Actual supported skip | Ordinary play/release |
Every cell requires separate `continuous`, `dialogue-return`, `bank-left`,
`bank-right` and `landing-idle` obligations on both original-DxWnd and native
Windows port. Continuous means ordinary **lab → VR04 → lab → outside** in one
uninterrupted recording and process, including Carl dialogue, first neutral
input, both banked jumps/landings, gadget use, RETURN cleanup and outside arrival.
Focused clips retain their actual setup/prerequisite recording. A direct scene,
debug warp or injected fixture cannot replace the route or retained prerequisite.
Record keys, skip action and held/released boundaries as actually performed.
Preserve legitimate landing bank and the implemented TSK lifetime ordering;
do not insert a leveling reset or tune movement for the recording.
## Collector commands and failure results
Replace paths and IDs with actual selections. Commands are examples for the
later combined session; use a fresh unique ID for each independent launch.
Start external recording when prompted and keep the collector alive for the
entire retained setup and tested interval. The recorder/browser are identified,
not automatically driven. The `.cmd` wrapper is an optional equivalent entry.
```powershell
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Run -Mode port -SessionId port-fresh-natural-ordinary-continuous-01 -CaseId fresh-natural-ordinary -Scope continuous -RecorderPath 'C:\Tools\OBS\bin\64bit\obs64.exe' -BrowserPath 'C:\Tools\Browser\browser.exe' -SettingsPath '.\results\session-settings.json'
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Run -Mode original -SessionId original-retained-natural-edge-bank-left-01 -CaseId retained-natural-edge -Scope bank-left -DxWndPath 'C:\Tools\DxWnd\dxwnd.exe' -ProfilePath 'C:\Local\exported.dxw' -RecorderPath 'C:\Tools\OBS\bin\64bit\obs64.exe' -BrowserPath 'C:\Tools\Browser\browser.exe' -SettingsPath '.\results\session-settings.json'
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Retained -SessionId original-retained-natural-edge-bank-left-01
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Finish -SessionId port-fresh-natural-ordinary-continuous-01 -AnnotationPath '.\results\port-notes.json' -ArtifactsDirectory 'D:\LocalCaptures\port-run-01'
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Skip -Mode original -SessionId original-missed-01 -CaseId fresh-skipped-edge -Scope bank-left -Reason 'Actual reason this obligation could not run'
```
`Skip`/`Abort` create a new terminal result without requiring recorder/browser
selection. An interrupted active run retains its initial `incomplete.json`;
when safe, collect its artifacts with `Finish -Outcome aborted -Reason '...'`
instead of pretending a separate aborted launch describes its lifetime.
When only `incomplete.json` survived, this command preserves its exact bytes as
a diagnostic artifact and permits only `aborted`. End clocks remain absent;
initial placeholder end values are discarded. Keep recovered media and source
notes, with an empty `events` array because no complete launch interval was
observed. The receipt remains open and importable; recovery does not establish
missing executable identity, process completion, or a captured/reviewed run.
Failed starts preserve `run.json`, `failure.json` and available logs. To collect
failed/skipped/aborted media use `Finish -Outcome failed|skipped|aborted` matching
the prior status, a reason and annotation/artifact directories (empty arrays are
allowed for these outcomes). Never promote a failed or terminal run to captured;
use a new independent session for a retry. Existing evidence is write-once.
## Annotation field contract
Copy `protocol/annotation-template.json` to a mutable result note and fill it
with actual values. Empty templates cannot finalize capture. All paths are
relative, case-unique and contained below `ArtifactsDirectory`; no commands are
read from annotations. Every captured run retains a raw `.mkv` video and actual
audio evidence. If raw audio is embedded, retain a separately named byte-identical
MKV copy with role `audio`, or a proven extracted WAV with derivation provenance.
This preserves unique artifact paths while binding the actual audio bytes.
- `artifacts`: entries `{path, role, duration_seconds}`; roles include `video`,
`audio`, `input_events`, `prerequisite`, `diagnostic`. Preserve raw and preview
as separate entries. Original prerequisite recordings/copy-state records and
port `observer/events.jsonl`, summary, stdout/stderr must be included as
appropriate; do not rename synthetic fixtures as native evidence.
- `events`: `{name, artifact, media_seconds, elapsed_seconds, method,
uncertainty_seconds}` using the exact required names/order in scenarios.json.
Original methods are `manual` or `procedural`; markers describe visible input
and event intervals, never invented original simulation ticks. Port events
map observer data to actual media clocks; `simulation_tick` remains separate.
Preserve observer `launch_id`, `clock_id`, requested/accepted input distinctions,
sequence and possible truncation/overhead. Never reset elapsed clocks at scenes.
All times are finite, nonnegative and within actual recording/run duration.
- `derivatives`: `{path, source, tool, version, argv, created_utc,
timestamp_mapping, crop_aspect, browser_playback_verified}`. The collector
stores argv as inert provenance; it does not execute it. Select true browser
playback only after observed playback. Hash tool binaries and retain source
identity/settings in local session notes, including whether crop/time changed.
- `continuity`: `lifetime_id` equals session ID, `prerequisite_artifact` names a
hashed artifact, `copy_pre_sha256` binds the actual copy-state record. Retained
additionally needs `departure_session_id` and `return_session_id` equal to that
same session ID and `retained_copy_sha256` identifying the retained snapshot.
`prerequisite_departure` and `prerequisite_return` markers precede the tested
interval on the prerequisite artifact. Include these state records as hashed
identities/artifacts, never made-up placeholders. The port's actual package/
startup-state record must be identified separately; missing continuity remains
open rather than treating a second fresh launch as retained.
- `diagnostic`: true for observation overhead, preflight, fixtures or other
diagnostic limitations; `limitations`: actual missing tools, crop/audio/render/
timer/wrapper differences, incomplete transitions, uncertain markers and review
failures. A successful collector does not clear them or acceptance automatically.
`Finish` prefixes local media/event/derivative references with `media/` and hashes
copied bytes. It never accepts an annotation-supplied acceptance verdict. The
shared receipt validator and later full matrix/human review decide applicability.
No universal timing, pixel, angle or audio tolerance is asserted by this agenda.
+1 -1
View File
@@ -22,7 +22,7 @@ the helper PE-maps file offsets independently (these text offsets equal VA−400
|46BF2F..46C00A|Stage1 advances to2, clears elapsed and dispatches app114(`level1d.gam`) at46C004. This is the previously omitted positive background-load edge.|
|app114→46DFB0;46BEDF;app104→46DFF0|Queues filename+74D with signed callback countdown+7FA=2; underflow sets pending+74C; the application then invokes ordinary selective teardown/load.|
|Level1D GAM|LV1D,54 records, first3JIM/JIM1 at raw8. SHA256276133d750eaa82724b35c12a91fce41a9e074224e3ef12c3624564ae8ed4d9e. Loading the supplied background creates Jimmy before a user story load.|
|46E570..46E67D|After GAM records, the whole surviving registry receives Init28 then PostLoad40C, including retained MAIN; Init is not limited to newly parsed records.|
|46E570..46E67D|After GAM records, each surviving registry node receives Init28 then PostLoad40C before advancing to the next node, including retained MAIN; Init is not limited to newly parsed records.|
|MAIN/Level1D game28→44D4E0→4587F0→470540|Common Init restores stored+11 into live+139 through4705B3/4705BC. Both games' stored value is1. MAIN's constructor-default live0 therefore does not imply indefinite retention after background initialization. Their40C is44DF30, a noop call plus own game520=0 store, with no later lifetime reset.|
|404B4F→460E70→460EA0/460EF0→4603F0|The NewGame action queues NewGame.tsk; the reader consumes that request. The request itself does not initialize Jimmy.|
|460A50..460A6A;460BD1|The reader requests a destination GAM only through an existing non-null controlled receiver accepting **C3DJIMMY** at4ECB20. It dispatches Jimmy complete168→43B5A0 with the staged filename/start/root data. The no-Jimmy path does not supply that request.|
+306 -1
View File
@@ -1,4 +1,186 @@
# Progress — 2026-11-06
# Progress — 2026-11-07
## Bundled checker cache fix — 2026-11-14
A user readiness check created Python bytecode inside the sealed checkpoint and
then rejected it as unexpected immutable material. Regression23ee1c2 reproduces
this; fix2fe8b40 disables bytecode writes before local imports in all five bundled
Python command entry points. All26 checkpoint tests pass, including a real copied
CLI test with environment overrides ignored. The exact bundled readiness command
passes twice without creating pyc files. A fresh11,001-member checkpoint replaces
phase01; the old tree and its cache/results are retained in local history, and
existing results/generated execution copies were copied into the new mutable roots.
The broader attempt ran185 tests but failed observer class setup after a90-second
.NET build timeout. A separate bounded local build passed; the seven observer
checks then passed on their own retry. Thus all192 fidelity checks are covered
across the two runs; the initial full attempt remains recorded as failed.
No runtime implementation changed. Actual original/native acceptance remains
0/120 OPEN and all ten human UAT items remain pending.
## Phase 1 verification — human session pending
Final owner-validated verification is `human_needed`:29/42 truths verified and13
uncertain pending actual observations. Ten named checks are saved in
`.planning/phases/01-reproducible-fidelity-baseline/01-UAT.md`. Autonomous materials,
review fixes, security and automation coverage are complete. Actual acceptance
remains0/120 OPEN; all EVID requirements stay Pending and Phase2 is unadvanced.
The combined session guide is `docs/evidence/checkpoint-session.md`; the local
checkpoint is `dist/fidelity/phase01`. Resume human verification with
`$gsd-verify-work 1`. No new build/test or gameplay claim accompanies this report.
## Final phase 1 review closure
All five review findings are independently verified fixed. The final copy-state
refinement is02d182f; all191 fidelity regressions pass in43.355s, with29 acceptance,
26 scenario and23 capture checks in the affected suites. Earlier review fixes
also pass27 Node and18 Linux-hosted PowerShell checks;539 originals stay unchanged.
The recovered full local suite passed782.049626s before these tooling-only review
fixes:556 Python,27 Node,23 observer,2 HUD,51 managed entry points and36 GPU render
receipts, zero Vulkan validation errors. The full GPU suite was not repeated for
these Python/collector fixes. Independent security audit closes22/22 planned
threats. Current fresh checkpoint is `dist/fidelity/phase01` (11,001 immutable
entries); exact current manifest/READY identities are recorded locally in
`artifacts/fidelity/verification/01-07-final-checkpoint.json`. Earlier bundle
history is preserved locally. All120 actual original/native acceptance obligations
and ten named human findings remainOPEN. Final phase verification is pending.
## Phase 1 final preparation — acceptance human_needed
The fresh local `dist/fidelity/phase01` checkpoint passes readiness over11,000
immutable files. Strict audit exits1:0/120 original-DxWnd/native Linux/native
Windows obligations accepted, all ten human findings pending. The actual failed
`linux-01-06-matrix-preflight-linux` receipt is imported with a diagnostic viewer;
no gameplay was launched. Runtime source remains446930d dirty, diff90cef956;
exact package/tool identities are local in
`artifacts/fidelity/verification/01-07-final-checkpoint.json`.
The consolidated runner now rejects zero fidelity Python/viewer/observer counts.
The complete local suite passed in 782.05s (runner clock: 783s): 556 Python
(180 fidelity), 27 Node, 23 managed observer, 2 separate HUD Python tests and
51 managed test entry points, followed by the main build. The log records
36 GPU rendered receipts, 27 saved readbacks and 17 material/readback assertions,
all with zero Vulkan validation errors; SDL dummy-audio checks pass and all
539 originals remain unchanged. No physical input, audible or window-session
acceptance is inferred. Receipt: `artifacts/fidelity/01-07-full-suite.json`;
full output: `artifacts/fidelity/01-07-full-suite.log`.
The first74.65s attempt passed Python but exposed the new Node reporter/count
guard mismatch; explicit TAP fixes it and the complete rerun is retained.
See [baseline](evidence/phase01-baseline.md) and the single
[combined session](evidence/checkpoint-session.md). All EVID requirements and
Phase1 acceptance remain OPEN; source-backed continuation follows the roadmap
exception. Movement/gameplay/admission and historical runtime evidence are unchanged.
## Phase 1 plan 01-06 — reviewed completion
Linux capture tooling and full40-obligation matrix are complete. Primary repeats
23 capture tests; executor records156 broader fidelity checks and539 unchanged
originals. Actual host preflight has no display and only auto_null audio, saved as
`linux-01-06-matrix-preflight-linux`. No game was launched. Matrix/review artifacts
are under `artifacts/fidelity/linux/`. Phase1 is6/7 plans; all120 runtime acceptance
obligations stayOPEN. Final readiness and combined-session audit are next.
## Phase 1 plan 01-05 — reviewed completion
Offline Windows checkpoint preparation is complete:10,983 identified immutable
files, both full-bundle preflights pass,24 checkpoint Python tests and17 real
Linux-hosted PowerShell checks pass. Primary repeats both targeted suites. The
executor also records133 broader fidelity regressions and539 unchanged originals.
The copied Linux apphost retains executable permissions and runs --help. Generated
bundle: `artifacts/fidelity/01-05-session-checkpoint`; exact identities are in
`artifacts/fidelity/verification/01-05-complete-bundle.json` and the01-05SUMMARY.
Phase1 has5/7 plans complete; Linux capture preparation is next. Actual runtime
acceptance remains0/120 OPEN. No Windows gameplay or original comparison claimed.
## Local quota guard — 2026-11-13
Installed Linux quota watcher and five project hooks; real local account quota
read succeeds, watcher runs, and targeted policy/recovery tests pass. Hook trust
remains a user `/hooks` action. At20% remaining new workers are denied; at15%
remaining recovery is saved and registered active turns receive a cooperative
GSD pause request. See [setup and limits](codex-quota-guard.md). Phase01-05 task2
partial edits remain untouched; no gameplay or acceptance status changed.
## Phase 1 wave 2 — review, ledger and passive observation
Full authorized wave2 `scripts/test.sh` exits0:462 Python+2 HUD checks,
all existing managed projects and36 GPU/render checks pass with zero Vulkan
validation errors (GTX1070); SDL stream/lifecycle checks and539 original hashes
pass. The initial sandbox run retained8 denied-loopback errors; no tests were
skipped, and the authorized rerun passed. Viewer27 named Node checks and the
observer23 managed checks retain their separate passing receipts. Logs are
local under `artifacts/fidelity/wave2-test*.log`.
Plans01-02/03/04 are implemented: paired actual-speed local playback with exclusive
audio/optional overlays;25 capabilities covering33 requirements and33 checkpoint
rows; optional bounded input/control/continuation observations. Observer checks:
23 managed,7 actual subprocesses, protected Movement28/Director23/Checkpoint4/
BodyOwnership3. Private-Xvfb native SDL/Vulkan on/off has4 identical readbacks
and zero validation errors; exact source-diff/binary identities and limits are in
`../.planning/phases/01-reproducible-fidelity-baseline/01-04-SUMMARY.md`.
Linux self-contained publish used an isolated artifact directory. All539 original
hashes match. This is bounded tooling/fixture evidence, not physical input/audio,
whole-original, full-route or native Windows acceptance; actual obligations stay
OPEN0/120. Next: Windows checkpoint bundle (plan01-05).
## Phase 1 resumed — capability ledger complete
User resumed from the usage pause. Plan01-03 is complete:25 capabilities cover
all33 requirements and33 checkpoint rows across6 groups. Primary repeats31
ledger tests and103 combined fidelity tests;539 original hashes match. Earlier
viewer27 Node checks and synthetic Chromium smoke remain their bounded evidence.
Full details: `../.planning/phases/01-reproducible-fidelity-baseline/01-03-SUMMARY.md`.
Actual original-DxWnd/native Linux/native Windows acceptance remains OPEN0/120.
Next: plan01-04 passive port observer; no new gameplay behavior or original/native
comparison was established by the ledger work.
## Phase 1 wave 1 — preserved sessions and scenarios
Full wave1 `scripts/test.sh` exits0:403 Python checks plus2 HUD checks,
all managed projects and36 rendering checks pass with zero Vulkan validation
errors; SDL dummy-device audio lifecycle and539 original hashes pass. NU1900
reports unavailable vulnerability metadata; no build error. Log stays local at
`artifacts/fidelity/wave1-test.log`. This is baseline regression evidence, not
new whole-original/native Windows comparison.
Plan01-01 implements bounded fresh-copy staging, hashed receipt import/validation
and eight dialogue/lifetime/input cells covering continuous and focused route
observations. Primary repeats51 passing Python tests;539 originals match. Exact
commits and scoped TDD receipts are in
`../.planning/phases/01-reproducible-fidelity-baseline/01-01-SUMMARY.md`.
All120 actual original-DxWnd/native Linux/native Windows obligations remain open.
No gameplay, build/package or new platform execution is claimed. Next: local
viewer, full-game ledger and passive port observer (wave2).
## Phase 1 plans verified — 2026-11-12
Phase 1 now has seven executable plans (15 tasks/five waves), research, pattern
mapping, source audit and a draft validation contract in
`../.planning/phases/01-reproducible-fidelity-baseline/`. Independent checking
passes after resolving research dispositions and bounding final integration.
All4 requirements and16 discussion decisions are covered;24 command targets and
failure predicates pass deterministic probes. All539 original hashes match.
Next: `$gsd-execute-phase 1`. This is planning verification only: no new capture,
package, gameplay or native-platform acceptance is established.
## Phase 1 discussion complete — 2026-11-12
Phase 1 context and the discussion audit are captured in
`../.planning/phases/01-reproducible-fidelity-baseline/`. Decisions cover full-route
and focused comparisons, paired playback, a capability-led evidence ledger and
combined local Windows sessions. The original will run through DxWnd on the
user’s Windows PC; record wrapper configuration separately from port receipts.
Next: `$gsd-plan-phase 1`. No new runtime or platform verification is established.
## Planning initialization — 2026-11-12
GSD onboarding and full-reconstruction planning are initialized in
`../.planning/PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md` and `STATE.md`.
The user requires fidelity as high as possible to the original and selected
autonomous execution, standard granularity and playable slices. Eight phases
map all33 requirements exactly once; phase1 is ready to plan, none executed.
Research reuses existing evidence; it is not new binary or runtime verification.
All existing movement/admission gates and platform limitations remain binding.
Next: `$gsd-discuss-phase 1` or `$gsd-plan-phase 1` from GamePort.
Workflow update: the user authorizes pushing completed, verified commits to the
existing `Gitea/main` upstream from now on. See docs/decisions.md and AGENTS.md.
@@ -7,6 +189,129 @@ Next-work plan: [recover interactions, then implement verified changes](checkpoi
It defines the Carl source/differential gate, the bounded implementation step,
movement/contact/animation recovery and the end-to-end platform checkpoint.
## Real normal callback continuation
[Normal callbacks](checkpoint/actor-normal-contacts.md) adds30 complete original/
C# fixture comparisons,13 class interfaces/182 bindings and5 pure scalar getter
fields. Jimmy's ordinary/null/jetpack374 does not invoke generic reflection;
the inherited callback has a live gate, fresh Y read, unclamped damping and an
angular-heading tail. Soldier mode10 adds a separate complete174/force500 call.
Its full RNG/action-dependent policy remains open;174 and Jimmy204 are recorded
endpoints, not executed derived policies. The two new REA procedure requests were
unrecognized; retained original REA instructions and byte guards support the work.
The standalone OriginalNormalContacts component and bounded fixture match30 emitted states,
angle arguments/results and accessor order exactly as float32. Four bounded
injections confirm post-callback inhibition, radius10→20 reclip toZ55, retained
callback with geometry disabled and fresh42C. Live body/profile wiring remains
unchanged. Partial captures from an erroneous cross-instruction relocation scan
are excluded;37 reviewed operands fix it, with a regression guarding4095BE.
Next recover derived soldier response and helper cleanup/activation/physical
order across LOAD/RETURN, then bind a response adapter only to supported actor
states. Class-specific608/704 state must remain distinct from collision mode178.
Normal callbacks do not replace real enter/stay/leave/game-task effects; those
consumers remain a separate gate.352 Python checks and targeted sphere/static/
body/ownership/pair/context/reclip regressions pass. Linux Debug build and Windows
x64 cross-publish succeed;539 originals and924ad2f packages are unchanged. No new
graphics/SDL or Windows runtime run; prior integrated evidence remains bf876e9.
## Populated reclip and source rounding
[Populated dynamic reclip](checkpoint/dynamic-reclip.md) extends the copied
original query to14 cases with actual synthetic static triangles and12 captured
kernel steps. All fields match exactly as float32, including wall/ceiling retry,
old-polygon callbacks, disabled-geometry visits and per-primitive lower-edge mode.
A skew edge first diverged at triangle6; original instruction stores support
delayed X projection/edge publication and ray normalization/hit-point rounding.
Those shared kernels now follow the evidenced boundaries. The public float
quick-magnitude result is preserved; double intermediates are not a universal
x87 oracle. Node visits are now counted separately from primitive tests.
No new dynamic actor or scene admission is enabled. Actual Jimmy/VR04 callback
mutations, post-callback live flag/radius reads and retained helper cleanup/order
remain next. Native source execution uses synthetic actors/grid under Wine32;
whole-original and native Windows gameplay remain separate. Detailed verification
receipts and limits are recorded in compatibility.md and the linked report.
Verification complete: scripts/test.sh exits0 with348 Python+2 HUD checks, all
managed projects and36 Vulkan/render checks with zero validation errors; audio
lifecycle and539 original hashes pass. Native Linux Carl neutral/300-idle and
VR04 SDL steering/resize pass with zero validation errors. Windows x64 cross-
publish succeeds; no new Windows runtime claim. Existing924ad2f packages remain
unchanged while the verified source correction is committed separately.
## Dynamic response and shared context
[Dynamic context](checkpoint/dynamic-context.md) adds17 complete original/C#
component comparisons and12 captured kernel triangle/normal argument matches.
The original box query retains old hit/last-polygon state, can issue an old
static callback after a dynamic hit, and overwrites callback root mutations at
final publication unless box response is inhibited. A same-position/wrong-state
comparison exposed kernel A,C,B winding relative to construction A,B,C; captured
arguments confirm it. The composition is test-only, not live scene collision.
The helper follow-up guards13 sites/5 Jeep bindings: default Jeep is eligible
for ordinary deletion, with three live-predicate reads around cleanup hooks.
Active cleanup, child lifetime and retained physical ordering remain open.
Two new REA pseudocode results and complete instruction Evidence support this
chunk;46DFF0 remains an unrecognized-procedure error. All345 Python checks,
17 context,11 static,10 dynamic and28 pair cases/groups pass;539 originals and
both924ad2f packages remain unchanged. No new platform runtime claim is made.
Next: nonempty static reclip/ordered-body context, real actor callbacks, and
retained helper cleanup before bounded live admission.
## VR04 registration and generated-helper continuation
[Physical registration](checkpoint/physical-registration.md) now covers all72
serialized VR04 records/13 actual class interfaces and adds12 executed original
registration/loader cases. Common bridges append repeated pointers; Jimmy's outer
49E guard is a separate boundary. The native cases confirm per-object Init→PostLoad,
same-pass registry appends and nested registration before parent append. They use
synthetic actors/callbacks, not full original scene construction.
[Helper catalogue](checkpoint/vr04-generated-bodies.md) guards21 creation/
registration calls,9 instruction sites and12 RTTI helper identities/36 bindings.
Baseball PostLoad and Jimmy-owned fire give positive re-entry edges; constructor-
only helpers, conditional children and old Jeep cleanup remain explicit unknowns.
The57 constructor/2 PostLoad/13 negative own-call record partition is not a live
body count. Earlier470A00 allocation wording is corrected: it logs;479A40 allocates
the physical node. Two new REA pseudocode results and retained original instructions
support the source trace; three unrecognized procedures remain recorded errors.
All342 Python checks pass, as does the existing28-case managed pair regression.
The native capture verifies complete12-case callbacks/order/flags/transforms and
source/probe identities. All539 originals remain unchanged. No gameplay/runtime
source is changed; both924ad2f packages and their prior verification remain the
playable baseline. Actual helper reuse/removal/activation and shared dynamic
nearest/last-polygon reclip ownership remain next. Evidence: artifacts/physical-registration/.
## Ordered physical pair contract
[Pair lifecycle](checkpoint/pair-lifecycle.md) now records the original physical-
list order, asymmetric sphere exclusions, live callback mutations and independent
enter/stay/leave membership. Six new REA pseudocode results and guarded original
instructions support28 copied-code component cases. The C# pair dispatcher matches
all28 complete callback/contact/flag/root observations; saved expectations also
pass without generated traces. No new scene physics is enabled.
VR04's6 inspected Jimmy/Rocketship/soldier/trophy records share unconditional
class permission callbacks;20 virtual bindings are guarded. Complete physical
registration, other classes/helpers, actual response and dynamic reclip state
remain open. Keep lab/outside's playable capsule and VR04's bounded static body.
All338 Python tests, targeted dynamic/body-ownership/Director regressions and
Debug build pass; Windows cross-publish succeeds (NU1900 vulnerability-metadata
warning, no compilation error). All539 originals are unchanged. Local logs,
complete REA replies and component provenance are under artifacts/pair-lifecycle/.
Both packages now identify clean924ad2f:519 exact original copies,4285 matching
prepared scene files and7 matching prepared audio files each. Standalone Linux
from /tmp without SDK/development-library paths passes Carl first neutral input,
300 idle ticks and held-input resumption. All4 readbacks match the ea04210 package
baseline exactly. This package run disables optional Vulkan validation; the prior
enabled-validation route evidence is unchanged. Current Windows is cross-published
and resource-verified, not newly runtime-tested. All539 originals are reverified.
Package identities/readback hashes are under artifacts/pair-lifecycle/.
## Carl neutral return: TSK startup lifetime correction
[Menu/player lifetime](gameplay/main-menu-player-lifetime.md) closes the missing
+26
View File
@@ -5,6 +5,32 @@ offsets, virtual addresses, API symbols or observed behavior. Decompiled output
evidence, not original source. Original gameplay has not yet been observed successfully; isolated original DLL
probes and modern runtime checks are recorded separately.
- [Actor normal contacts](checkpoint/actor-normal-contacts.md):30 complete
original/C# emitted snapshots,13 interfaces/182 bindings and5 scalar getters.
Jimmy override versus inherited ceiling/reflection/angular behavior and late
dynamic reclip reads are verified in bounded fixtures. Soldier174/Jimmy204 are
record-only endpoints; full policies/helper lifetime still gate live wiring.
- [Populated dynamic reclip](checkpoint/dynamic-reclip.md):14 full observations
and12 captured kernel steps. Original instruction stores explain delayed edge
projection, ray normalization and hit-coordinate rounding. Shared kernels now
reproduce those cases exactly; node visits are distinct from primitive tests.
Actor callbacks/live getter timing and retained helper order remain open.
- [Dynamic box/shared context](checkpoint/dynamic-context.md): full47A5E0 plus
static reclip/kernel execution,17 complete C# composition comparisons and12
captured kernel triangle/normal arguments. Nearest reset, retained hit/last
polygon, callback effects and publication are bounded source/component facts.
Jeep default deletion eligibility has13 guarded sites/5 bindings; complete
cleanup and live actor/shared-world integration remain open.
- [Physical registration](checkpoint/physical-registration.md) and
[generated helpers](checkpoint/vr04-generated-bodies.md): all72 VR04 serialized
records/13 RTTI interfaces;12 original registration/loader cases;21 helper
creation/registration calls. Per-object Init/PostLoad and live appends are
executed component evidence. Full retained helper membership/cleanup is open.
- [Ordered physical pairs](checkpoint/pair-lifecycle.md):6 REA pseudocode results,
8 guarded source ranges,20 VR04 class bindings and28 complete copied-code/C#
comparisons. One-sided exclusions, gate-retained contacts, callback-mutated
roots/membership and notification order are recovered. The reusable component
remains outside live scenes; physical registration and real callbacks are open.
- [Body root publication](checkpoint/body-root-publication.md) and
[body modes](checkpoint/body-modes.md):19 actual dispatcher/kernel contact-root
observations plus87 body/support/friction flag/payload observations. Parent
+166
View File
@@ -1,5 +1,135 @@
# Tasks
## Bundled checker cache fix — 2026-11-14
A user readiness check created Python bytecode inside the sealed checkpoint and
then rejected it as unexpected immutable material. Regression23ee1c2 reproduces
this; fix2fe8b40 disables bytecode writes before local imports in all five bundled
Python command entry points. All26 checkpoint tests pass, including a real copied
CLI test with environment overrides ignored. The exact bundled readiness command
passes twice without creating pyc files. A fresh11,001-member checkpoint replaces
phase01; the old tree and its cache/results are retained in local history, and
existing results/generated execution copies were copied into the new mutable roots.
The broader attempt ran185 tests but failed observer class setup after a90-second
.NET build timeout. A separate bounded local build passed; the seven observer
checks then passed on their own retry. Thus all192 fidelity checks are covered
across the two runs; the initial full attempt remains recorded as failed.
No runtime implementation changed. Actual original/native acceptance remains
0/120 OPEN and all ten human UAT items remain pending.
## Phase 1 verification — human session pending
Final owner-validated verification is `human_needed`:29/42 truths verified and13
uncertain pending actual observations. Ten named checks are saved in
`.planning/phases/01-reproducible-fidelity-baseline/01-UAT.md`. Autonomous materials,
review fixes, security and automation coverage are complete. Actual acceptance
remains0/120 OPEN; all EVID requirements stay Pending and Phase2 is unadvanced.
The combined session guide is `docs/evidence/checkpoint-session.md`; the local
checkpoint is `dist/fidelity/phase01`. Resume human verification with
`$gsd-verify-work 1`. No new build/test or gameplay claim accompanies this report.
## Final phase 1 review closure
All five review findings are independently verified fixed. The final copy-state
refinement is02d182f; all191 fidelity regressions pass in43.355s, with29 acceptance,
26 scenario and23 capture checks in the affected suites. Earlier review fixes
also pass27 Node and18 Linux-hosted PowerShell checks;539 originals stay unchanged.
The recovered full local suite passed782.049626s before these tooling-only review
fixes:556 Python,27 Node,23 observer,2 HUD,51 managed entry points and36 GPU render
receipts, zero Vulkan validation errors. The full GPU suite was not repeated for
these Python/collector fixes. Independent security audit closes22/22 planned
threats. Current fresh checkpoint is `dist/fidelity/phase01` (11,001 immutable
entries); exact current manifest/READY identities are recorded locally in
`artifacts/fidelity/verification/01-07-final-checkpoint.json`. Earlier bundle
history is preserved locally. All120 actual original/native acceptance obligations
and ten named human findings remainOPEN. Final phase verification is pending.
## Phase 1 final preparation — human session pending
- [x] Strict ready/audit tools:23 acceptance checks and24 checkpoint checks pass.
- [x] Fresh11,000-file offline bundle and actual failed Linux diagnostic import.
- [x] Strict audit rejects acceptance:0/120 obligations; all named human findings pending.
- [x] Integrate positive-count fidelity Python/Node/managed observer checks into runner.
- [x] Complete local suite: exit 0 in 782.05s; 556 Python (180 fidelity),
27 Node, 23 observer, 2 separate HUD Python tests, 51 managed test entry points,
main build, 36 GPU rendered receipts, 17 material/readback assertions,
SDL dummy-audio checks and 539 unchanged originals. No window-session claim.
- [ ] Actual original-DxWnd40/native Windows40/native Linux40 capture obligations.
- [ ] Single combined physical/audible/browser review, A1/A2, both unclassified
assumptions and P1/P2/P3 judgments; post-return agent-owned reconciliation.
- [ ] Phase1/EVID-02/EVID-04 acceptance; retain all EVID requirements Pending.
Full-suite receipt: `artifacts/fidelity/01-07-full-suite.json`; final local bundle:
`dist/fidelity/phase01`. See [complete checklist](evidence/checkpoint-session.md).
The roadmap's independent source-backed recovery exception does not waive these
acceptance dependencies or broaden gameplay admission.
## Phase 1 plan 01-06 — reviewed completion
- [x] Linux collector and23 targeted checks, full40-obligation open matrix.
- [x] Record actual no-display/null-audio host dependency; retain failed receipt.
- [ ]01-07 final readiness/audit/integration and combined human session.
## Phase 1 plan 01-05 — reviewed completion
- [x] Complete offline Windows/DxWnd collection materials and synthetic selftests.
- [x] Verify both10,983-file bundle preflights,24 Python/17 PowerShell checks.
- [ ]01-06 Linux capture preparation, then01-07 combined-session readiness/audit.
- [ ]Actual original/native acceptance0/120 OPEN.
## Quota-aware GSD continuation — 2026-11-13
- [x] Install/test local60-second quota watcher,20% dispatch gate,15% pause request.
- [ ] User review/trust the five project quota hooks via `/hooks`.
- [ ] Resume `$gsd-resume-work` when desired; retain01-05 task2 partial edits.
## Phase 1 execution — wave 2
- [x]01-02 paired local review:21 Python/27 Node checks and real Chromium
synthetic-media smoke; actual audible original/native review stays open.
- [x]01-03 full ledger:25 capabilities/33 requirements/33 checkpoint rows;
31 ledger tests and103 combined fidelity Python tests pass.
- [x]01-04 passive observer:23 managed/7 process tests and protected suites;
native private-Xvfb on/off4 readbacks identical, zero validation errors.
- [ ]01-05 prepare complete Windows/DxWnd local checkpoint bundle.
- [ ]01-06 native Linux captures;01-07 combined hands-on session and strict audit.
- [ ]Actual original/native runtime acceptance OPEN0/120.
## Phase 1 resumed — capability ledger complete
User resumed from the usage pause. Plan01-03 is complete:25 capabilities cover
all33 requirements and33 checkpoint rows across6 groups. Primary repeats31
ledger tests and103 combined fidelity tests;539 original hashes match. Earlier
viewer27 Node checks and synthetic Chromium smoke remain their bounded evidence.
Full details: `../.planning/phases/01-reproducible-fidelity-baseline/01-03-SUMMARY.md`.
Actual original-DxWnd/native Linux/native Windows acceptance remains OPEN0/120.
Next: plan01-04 passive port observer; no new gameplay behavior or original/native
comparison was established by the ledger work.
## Phase 1 execution — wave 1
- [x] Plan01-01: preserved-session stage/identify/import/validate and required
eight-cell route contract;51 tooling tests and539 original hashes pass.
- [ ] Plans01-02/03/04: paired local viewer, capability ledger and passive observer.
- [ ] Plans01-05/06/07: prepared Windows bundle, Linux captures, then combined
original-DxWnd/native Windows session and actual acceptance audit.
- [ ] All120 runtime evidence obligations remain open; tooling tests alone do
not establish EVID-02/EVID-04 acceptance.
## GSD handoff — 2026-11-12
- [x] Initialize full remaining reconstruction scope, research,33 requirements
and8 playable-slice phases in `../.planning/`.
- [x] Discuss phase1: Reproducible Fidelity Baseline; capture all four areas and
the Windows/DxWnd setup in `../.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md`.
- [x] Plan phase1: seven plans/15 tasks/five waves; independent review and
requirement/decision/command gates pass.
- [ ] Execute phase1 (`$gsd-execute-phase 1`). Keep original/native
Windows access dependencies open; independent source-backed recovery may
continue under the explicit roadmap exception.
- [ ] Execute the roadmap with current evidence/admission gates; initialization
does not complete or supersede existing gameplay tasks below.
Full-game completion remains the objective. Original files are authoritative;
compile, runtime and original-fidelity verification are separate.
@@ -65,6 +195,42 @@ Execution order and acceptance criteria: [next work plan](checkpoint/next-work-p
replay. Native Windows and original-game comparisons remain separate.
- [ ] Obtain native Windows/whole-original Carl feedback for that same scenario;
local Wine allocation diagnostics remain visually unusable.
- [x] Recover physical pair order, eligibility gates, asymmetric exclusions and
callback-mutated enter/stay/leave state;28 complete original/C# comparisons
and20 VR04 class bindings. See checkpoint/pair-lifecycle.md. Component remains
outside the live scene loop until actor/scheduler dependencies close.
- [x] Refresh both clean924ad2f packages and verify resources; standalone Linux
Carl return passes with4 readbacks identical to the previous runtime checkpoint.
- [ ] Complete VR04 physical registration/activation and generated-helper inventory,
then dynamic nearest/last-polygon reclip ownership. Preserve existing scene
collision admission until real actor/special callbacks are verified.
- [x] Inventory all72 serialized VR04 records/13 actual interfaces and execute12
original registration/loader cases (duplicate append,49E guard, nested order,
per-object Init/PostLoad and same-pass registry additions).
- [x] Guard21 helper creation/registration edges and12 RTTI identities; separate
owner-driven fire/Baseball re-entry from constructor-only or conditional helpers.
Full live body counts and retained helper cleanup remain open. See
checkpoint/physical-registration.md and vr04-generated-bodies.md.
- [x] Execute complete dynamic-box query/shared static reclip in17 bounded
original cases; match full C# snapshots and12 captured kernel arguments.
Preserve old polygon/hit, post-callback publication and kernel winding.
Guard Jeep default teardown eligibility separately from full cleanup. See
checkpoint/dynamic-context.md; no live pair admission is enabled.
- [ ] Recover ordered-body context provenance, real actor callbacks and cleanup-
mutated helper lifetime before live integration. The populated fixtures below
close the bounded nonempty reclip contract.
- [x] Match populated static reclip in14 complete original/C# cases and12 kernel
steps. Correct directly evidenced projection, ray normalization and coordinate
float stores; separate pre-gate node visits from primitive tests. See
checkpoint/dynamic-reclip.md. Sequential same-actor queries do not establish
real physical ordering, callback mutation contracts or helper lifetime.
- [x] Compare30 original normal-callback/composition snapshots and implement the
bounded inherited ceiling/reflection/angular component. Guard13 actual class
interfaces/182 bindings and5 scalar getter fields; preserve post-callback live
reads. See checkpoint/actor-normal-contacts.md. No new live actor admission.
- [ ] Close soldier complete174 RNG/target/action effects and helper cleanup/
activation/order across LOAD/RETURN before binding the shared response adapter.
Real enter/stay/leave game/task consumers remain separate from normal response.
- [x] Expand original lifecycle coverage:96 Carl contact,8 composed input/
controller/skip-prefix,48 task/objective and140 base/STOP cases; recover complete
+5
View File
@@ -0,0 +1,5 @@
#!/usr/bin/env bash
# No build, download, device fallback or acceptance promotion.
set -euo pipefail
task_root="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
exec python3 "$task_root/tools/recon/fidelity_capture.py" "$@"
+5
View File
@@ -0,0 +1,5 @@
@echo off
setlocal
rem Argument selection happens in PowerShell; never run commands from receipts.
powershell.exe -NoLogo -NoProfile -File "%~dp0collect-fidelity-windows.ps1" %*
exit /b %ERRORLEVEL%
+445
View File
@@ -0,0 +1,445 @@
# Windows PowerShell 5.1 compatible. No SDK/Python, elevation, downloads or eval.
[CmdletBinding()]
param(
[ValidateSet('Preflight','Run','Finish','Skip','Abort','Retained')][string]$Action = 'Preflight',
[ValidateSet('port','original')][string]$Mode = 'port',
[string]$Bundle = (Split-Path -Parent $PSScriptRoot),
[string]$SessionId, [string]$CaseId = 'fresh-natural-ordinary',
[ValidateSet('continuous','dialogue-return','bank-left','bank-right','landing-idle')][string]$Scope = 'continuous',
[string]$DxWndPath, [string]$ProfilePath, [string]$RecorderPath,
[string]$BrowserPath, [string]$SettingsPath, [string]$AnnotationPath,
[string]$ArtifactsDirectory, [string]$Reason,
[ValidateSet('captured','failed','skipped','aborted')][string]$Outcome = 'captured',
[ValidateRange(1,14400)][int]$TimeoutSeconds = 7200,
[switch]$LibraryOnly
)
Set-StrictMode -Version 2
$ErrorActionPreference = 'Stop'
$script:CollectorSource = $PSCommandPath
function Test-FidelityId([string]$Value) {
if ($Value -cnotmatch '^[A-Za-z0-9][A-Za-z0-9_.-]{0,95}$' -or
$Value -match '^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\.|$)') { throw 'Invalid stable ID' }
return $Value
}
function Get-FidelityPath([string]$Root, [string]$Relative) {
if (-not $Relative -or $Relative.Length -gt 4096 -or $Relative -match '[\\:<>"|?*\x00-\x1f]' -or
$Relative.StartsWith('/') -or $Relative -match '(^|/)(\.{1,2}|)(/|$)') { throw "Unsafe relative path: $Relative" }
foreach ($part in $Relative.Split('/')) {
if ($part.EndsWith(' ') -or $part.EndsWith('.') -or
$part -match '^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\.|$)') { throw 'Unsafe Windows alias' }
}
$base = [IO.Path]::GetFullPath($Root).TrimEnd([IO.Path]::DirectorySeparatorChar)
$path = [IO.Path]::GetFullPath((Join-Path $base $Relative))
if (-not $path.StartsWith($base + [IO.Path]::DirectorySeparatorChar, [StringComparison]::OrdinalIgnoreCase)) {
throw 'Path escapes checkpoint'
}
$cursor = $path
while ($cursor) {
if (Test-Path -LiteralPath $cursor) {
if (((Get-Item -LiteralPath $cursor -Force).Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0) {
throw "Reparse/symlink path: $cursor"
}
}
$parent = [IO.Path]::GetDirectoryName($cursor)
if ($parent -eq $cursor) { break }
$cursor = $parent
}
return $path
}
function Get-FidelityIdentity([string]$Path) {
$item = Get-Item -LiteralPath $Path -Force
if ($item.PSIsContainer -or ($item.Attributes -band [IO.FileAttributes]::ReparsePoint) -ne 0 -or
$item.Length -gt 8589934592) { throw "Not a bounded regular file: $Path" }
$stream = [IO.File]::OpenRead($item.FullName)
$sha = [Security.Cryptography.SHA256]::Create()
try {
$digest = [BitConverter]::ToString($sha.ComputeHash($stream)).Replace('-','').ToLowerInvariant()
return @{size=[long]$item.Length; sha256=$digest}
} finally { $stream.Dispose(); $sha.Dispose() }
}
function Read-FidelityJson([string]$Path) {
if ((Get-Item -LiteralPath $Path).Length -gt 4194304) { throw 'JSON exceeds 4 MiB' }
return [IO.File]::ReadAllText($Path, [Text.Encoding]::UTF8) | ConvertFrom-Json
}
function Write-FidelityJson([string]$Path, $Value) {
$text = (ConvertTo-Json -InputObject $Value -Depth 40) + "`n"
$bytes = (New-Object Text.UTF8Encoding($false)).GetBytes($text)
if ($bytes.Length -gt 4194304) { throw 'JSON exceeds 4 MiB' }
$temporary = $Path + '.incomplete-' + [guid]::NewGuid().ToString('N')
$stream = [IO.File]::Open($temporary, [IO.FileMode]::CreateNew)
try { $stream.Write($bytes,0,$bytes.Length); $stream.Flush() } finally { $stream.Dispose() }
[IO.File]::Move($temporary,$Path)
}
function Get-FidelityTree([string]$Root) {
$base = [IO.Path]::GetFullPath($Root).TrimEnd([IO.Path]::DirectorySeparatorChar)
$seen = @{}
$files = New-Object 'System.Collections.Generic.List[object]'
# Enumerate directories ourselves so reparse points are checked before descent.
$queue = New-Object 'System.Collections.Generic.Queue[string]'
$queue.Enqueue($base)
$count = 0
while ($queue.Count -gt 0) {
foreach ($item in Get-ChildItem -LiteralPath $queue.Dequeue() -Force) {
$count++
if ($count -gt 100000) { throw 'Tree exceeds 100000 entries' }
$name = $item.FullName.Substring($base.Length+1).Replace('\','/')
$null = Get-FidelityPath $base $name
if ($seen.ContainsKey($name)) { throw 'Case-alias in tree' }; $seen[$name] = $true
if ($item.PSIsContainer) { $queue.Enqueue($item.FullName) }
else { $identity = Get-FidelityIdentity $item.FullName; $identity.path = $name; $files.Add($identity) }
}
}
if ($files.Count -eq 0) { throw 'Empty tree' }
return @($files | Sort-Object path -CaseSensitive)
}
function Test-FidelityBundle([string]$Root) {
$ready = Read-FidelityJson (Get-FidelityPath $Root 'READY.json')
if ($ready.schema_version -ne 1 -or $ready.status -ne 'prepared') { throw 'Checkpoint is not READY' }
$id = Get-FidelityIdentity (Get-FidelityPath $Root 'manifest.json')
if ($id.sha256 -ne $ready.manifest.sha256 -or $id.size -ne $ready.manifest.size) { throw 'Manifest tampered' }
$manifest = Read-FidelityJson (Join-Path $Root 'manifest.json')
if ($manifest.schema_version -ne 1 -or $manifest.mutable_roots.Count -ne 2 -or
$manifest.mutable_roots[0] -ne 'results' -or $manifest.mutable_roots[1] -ne 'original-runs') {
throw 'Unsupported checkpoint manifest'
}
$seen = @{}
foreach ($file in $manifest.files) {
if ($seen.ContainsKey($file.path)) { throw 'Duplicate/case-aliased manifest file' }
$seen[$file.path] = $true
$actual = Get-FidelityIdentity (Get-FidelityPath $Root $file.path)
if ($actual.sha256 -ne $file.sha256 -or $actual.size -ne $file.size) { throw "Tampered/missing material: $($file.path)" }
}
foreach ($file in Get-FidelityTree $Root) {
if ($file.path.Split('/')[0] -notin @('results','original-runs') -and
$file.path -notin @('manifest.json','READY.json') -and -not $seen.ContainsKey($file.path)) {
throw "Unexpected immutable material: $($file.path)"
}
}
return $manifest
}
function ConvertTo-FidelityArgument([string]$Value) {
# Windows CommandLineToArgvW/CRT quoting. No cmd.exe, shell or expression eval.
if ($Value -match '[\x00\r\n]') { throw 'Control character in argument' }
$escaped = [regex]::Replace($Value, '(\\*)"', '$1$1\"')
$escaped = [regex]::Replace($escaped, '(\\+)$', '$1$1')
return '"' + $escaped + '"'
}
function Invoke-FidelityProcess([string]$Executable, [string[]]$Arguments,
[string]$WorkingDirectory, [string]$OutputDirectory, [int]$Seconds) {
$null = Get-FidelityIdentity $Executable
if ($Seconds -lt 1 -or $Seconds -gt 14400) { throw 'Process wait must be bounded' }
$info = New-Object Diagnostics.ProcessStartInfo
$info.FileName = $Executable
$info.Arguments = (($Arguments | ForEach-Object { ConvertTo-FidelityArgument $_ }) -join ' ')
$info.WorkingDirectory = $WorkingDirectory
$info.UseShellExecute = $false
$info.RedirectStandardOutput = $true; $info.RedirectStandardError = $true
$process = New-Object Diagnostics.Process
$process.StartInfo = $info
$out = [IO.File]::Open((Join-Path $OutputDirectory 'stdout.txt'),[IO.FileMode]::CreateNew)
$err = [IO.File]::Open((Join-Path $OutputDirectory 'stderr.txt'),[IO.FileMode]::CreateNew)
$timer = [Diagnostics.Stopwatch]::StartNew()
$started = $false
try {
$started = $process.Start()
if (-not $started) { throw 'Process did not start' }
$stdout = $process.StandardOutput.BaseStream.CopyToAsync($out)
$stderr = $process.StandardError.BaseStream.CopyToAsync($err)
while (-not $process.WaitForExit(200)) {
if ($timer.Elapsed.TotalSeconds -gt $Seconds -or $out.Length -gt 67108864 -or $err.Length -gt 67108864) {
$process.Kill(); $process.WaitForExit(); throw 'Process timed out or logs exceeded 64 MiB'
}
}
$remaining = [int][Math]::Max(1,($Seconds - $timer.Elapsed.TotalSeconds) * 1000)
if (-not [Threading.Tasks.Task]::WaitAll([Threading.Tasks.Task[]]@($stdout,$stderr),$remaining)) {
throw 'Process output did not close within the bounded wait'
}
$null = $stdout.GetAwaiter().GetResult(); $null = $stderr.GetAwaiter().GetResult()
if ($out.Length -gt 67108864 -or $err.Length -gt 67108864) { throw 'Process logs exceeded 64 MiB' }
return @{exit_code=$process.ExitCode; elapsed_seconds=$timer.Elapsed.TotalSeconds;
executable=$Executable; argv=@($Executable)+$Arguments; cwd=$WorkingDirectory}
} finally {
if ($started -and -not $process.HasExited) { $process.Kill(); $process.WaitForExit() }
$out.Dispose(); $err.Dispose(); $process.Dispose(); $timer.Stop()
}
}
function Get-FidelityOutcome([string]$Prior, [string]$Requested, [string]$Why) {
if ($Prior -notin @('incomplete','failed','skipped','aborted') -or
$Requested -notin @('captured','failed','skipped','aborted')) { throw 'Invalid outcome' }
if ($Prior -ne 'incomplete' -and $Requested -ne $Prior) { throw 'Failed/terminal run cannot be promoted; use a new session' }
if ($Requested -ne 'captured' -and -not $Why) { throw 'Failure/skip/abort requires a reason' }
return $Requested
}
function Get-FidelityPlatform {
$result = @{os='windows'; execution='native'; version=[Environment]::OSVersion.VersionString;
powershell=$PSVersionTable.PSVersion.ToString(); gpu=''; driver=''; vulkan=''; sdl=''}
if ([Environment]::OSVersion.Platform -ne [PlatformID]::Win32NT) { throw 'Native Windows collector requires Windows; Linux library tests are tooling-only' }
try {
$result.gpu_adapters = @(Get-CimInstance Win32_VideoController | Select-Object Name,DriverVersion,DriverDate,PNPDeviceID)
$result.gpu = ($result.gpu_adapters | ForEach-Object { $_.Name }) -join '; '
$result.driver = ($result.gpu_adapters | ForEach-Object { $_.DriverVersion }) -join '; '
$result.windows = Get-CimInstance Win32_OperatingSystem | Select-Object Caption,Version,BuildNumber,OSArchitecture
} catch { $result.query_failure = $_.Exception.Message }
return $result
}
function Copy-FidelityEvidence([string]$Source, [string]$Run, [string]$Name) {
$target = Get-FidelityPath $Run $Name
$null = [IO.Directory]::CreateDirectory([IO.Path]::GetDirectoryName($target))
$before = Get-FidelityIdentity $Source
[IO.File]::Copy($Source,$target,$false)
$after = Get-FidelityIdentity $target
if ($before.sha256 -ne $after.sha256 -or $before.size -ne $after.size) { throw 'Copy identity changed' }
$after.path = $Name
return $after
}
function New-FidelityReceipt([string]$Id, [string]$Case, [string]$Obligation,
[string]$Kind, [string]$Status, $Platform, $Clocks, [string]$Why) {
$null = Test-FidelityId $Id; $null = Test-FidelityId $Case
if ($Kind -notin @('original_dxwnd','native_port','synthetic') -or
$Status -notin @('incomplete','failed','captured','skipped','aborted')) { throw 'Invalid result classification' }
return @{schema_version=1; receipt_id=$Id; session_id=$Id; case_id=$Case;
scope=$Obligation; obligation_id=$Obligation; evidence_kind=$Kind;
status=$Status; historical=$false; platform=$Platform; identity=@{};
invocation=@{argv=@();cwd=''}; clocks=$Clocks; artifacts=@();derivatives=@();events=@();
limitations=@($Why); missing_evidence=@('Actual audiovisual review and scenario audit remain open');
acceptance=@{state='open';remaining=@('No acceptance from preparation, launch or collector success')}}
}
function Start-FidelityRun {
$null = Test-FidelityId $SessionId
$root = [IO.Path]::GetFullPath($Bundle)
$run = Get-FidelityPath $root ('results/' + $SessionId)
if (Test-Path -LiteralPath $run) { throw 'Session exists; choose an independent new launch ID' }
$null = [IO.Directory]::CreateDirectory((Join-Path $root 'results'))
$reservation = [IO.File]::Open(($run + '.lock'),[IO.FileMode]::CreateNew)
$reservation.Dispose()
$null = [IO.Directory]::CreateDirectory($run)
$watch = [Diagnostics.Stopwatch]::StartNew()
$clock = @{wall_start=[DateTime]::UtcNow.ToString('o'); wall_end=[DateTime]::UtcNow.ToString('o');
monotonic_start=0;monotonic_end=0;clock_id=[guid]::NewGuid().ToString('N')}
$platform = @{os='windows';execution=$(if ($Mode -eq 'original') {'dxwnd'} else {'native'})}
$kind = $(if ($Mode -eq 'original') {'original_dxwnd'} else {'native_port'})
$receipt = New-FidelityReceipt $SessionId $CaseId $Scope $kind 'incomplete' $platform $clock 'Collection pending'
Write-FidelityJson (Join-Path $run 'incomplete.json') $receipt
try {
$manifest = Test-FidelityBundle $root
if ($manifest.tooling_only) { throw 'Synthetic checkpoint cannot launch native/original evidence' }
$protocol = Read-FidelityJson (Join-Path $root 'protocol/scenarios.json')
if ($CaseId -notin @($protocol.cells | ForEach-Object {$_.id})) { throw 'Unknown scenario cell' }
if ($Action -in @('Skip','Abort')) {
$receipt.status = Get-FidelityOutcome 'incomplete' $(if ($Action -eq 'Skip') {'skipped'} else {'aborted'}) $Reason
$receipt.limitations = @($Reason)
return 0
}
$platform = Get-FidelityPlatform
$platform.execution = $(if ($Mode -eq 'original') {'dxwnd'} else {'native'})
$receipt.platform = $platform
$receipt.identity.checkpoint = Copy-FidelityEvidence (Join-Path $root 'manifest.json') $run 'identity/checkpoint.json'
$receipt.identity.launcher = Copy-FidelityEvidence $script:CollectorSource $run 'identity/collector.ps1'
$tools = @{}
foreach ($entry in @(@('recorder',$RecorderPath),@('browser',$BrowserPath),@('settings',$SettingsPath))) {
if (-not $entry[1]) { throw ('Select actual local ' + $entry[0] + ' file; no downloads are performed') }
# Identify external tools; do not redistribute their executables/installers.
$id = Get-FidelityIdentity $entry[1]
$tools[$entry[0]] = @{selected_path=$entry[1]; identity=$id;
version=[Diagnostics.FileVersionInfo]::GetVersionInfo($entry[1]).FileVersion}
}
$receipt.identity.settings = Copy-FidelityEvidence $SettingsPath $run 'identity/settings.json'
Write-FidelityJson (Join-Path $run 'tools.json') $tools
if ($Mode -eq 'port') {
$package = Join-Path $root 'port/win-x64'
$exe = Join-Path $package 'GamePort.exe'
$receipt.identity.executable = Copy-FidelityEvidence $exe $run 'identity/GamePort.exe'
$receipt.identity.runtime_dll = Copy-FidelityEvidence (Join-Path $package 'GamePort.dll') $run 'identity/GamePort.dll'
$build = Read-FidelityJson (Join-Path $package 'fidelity-build.json')
$src = Copy-FidelityEvidence (Join-Path $package 'fidelity-build.json') $run 'identity/build.json'
$src.commit = $build.source.commit; $src.dirty = $build.source.dirty; $src.diff_sha256 = $build.source.diff_sha256
$receipt.identity.source = $src
$receipt.identity.package = $src
$receipt.identity.resources = $src
$sdl = [Diagnostics.FileVersionInfo]::GetVersionInfo((Join-Path $package 'SDL3.dll'))
$platform.sdl_binary_version = $sdl.FileVersion
$arguments = @('--assets',(Join-Path $package 'assets'),'--load-save',(Join-Path $package 'assets/NewGame.tsk'),
'--walk','--fidelity-output',(Join-Path $run 'observer'),'--fidelity-session',$SessionId,'--fidelity-case',$CaseId)
Write-Host 'Start the external raw MKV recording now. Record physical inputs and media clocks. This is the existing TSK story entry, not a reconstructed main menu.'
$null = Read-Host 'Press Enter when recording is running'
$receipt.invocation = @{argv=@($exe)+$arguments;cwd=$run}
$result = Invoke-FidelityProcess $exe $arguments $run $run $TimeoutSeconds
Write-FidelityJson (Join-Path $run 'process.json') $result
if ($result.exit_code -ne 0) { throw "Port exited $($result.exit_code); preserve recording and logs" }
$receipt.limitations = @('Port process exited; media/event mapping and human review pending; observer overhead is diagnostic')
} else {
if (-not $DxWndPath -or -not $ProfilePath) { throw 'Select actual local DxWnd executable and exported profile' }
$dxwndId = Get-FidelityIdentity $DxWndPath
Write-FidelityJson (Join-Path $run 'dxwnd-tool.json') @{selected_path=$DxWndPath;identity=$dxwndId;
version=[Diagnostics.FileVersionInfo]::GetVersionInfo($DxWndPath).FileVersion}
$receipt.identity.dxwnd = @{path='dxwnd-tool.json'} + (Get-FidelityIdentity (Join-Path $run 'dxwnd-tool.json'))
$receipt.identity.dxwnd_config = Copy-FidelityEvidence $ProfilePath $run 'identity/original-profile.dxw'
$copy = Get-FidelityPath $root ('original-runs/' + $SessionId)
if (Test-Path -LiteralPath $copy) { throw 'Original run copy exists' }
$null = [IO.Directory]::CreateDirectory($copy)
$seed = Join-Path $root 'original-pristine'
foreach ($file in Get-FidelityTree $seed) {
$null = Copy-FidelityEvidence (Get-FidelityPath $seed $file.path) $copy $file.path
}
Write-FidelityJson (Join-Path $run 'copy-pre.json') @(Get-FidelityTree $copy)
$receipt.identity.copy_pre = @{path='copy-pre.json'} + (Get-FidelityIdentity (Join-Path $run 'copy-pre.json'))
Write-Host "Generated original copy: $copy"
Write-Host 'Inspect this selected DxWnd distribution help/config. Import the retained exported profile and change ONLY target/working-directory paths to the generated copy; export the relocated profile into this result folder. No switches/settings are assumed.'
Write-Host 'Start external raw MKV recording before original interaction. Launch the original manually through DxWnd. Never select original-pristine or the authoritative installation.'
$info = New-Object Diagnostics.ProcessStartInfo
$info.FileName = [IO.Path]::GetFullPath($DxWndPath); $info.WorkingDirectory = $copy; $info.UseShellExecute = $false
$wrapper = [Diagnostics.Process]::Start($info)
$receipt.invocation = @{argv=@($info.FileName);cwd=$copy;method='manual profile import and GUI launch; original child exit not inferred'}
$null = Read-Host 'After the original has exited and recording stopped, press Enter (keep this collector alive during retained prerequisites)'
$receipt.wrapper_settings = 'Selected profile retained; relocated export/settings and wrapper limitations require annotation review'
$receipt.limitations = @('DxWnd GUI launched; original child invocation/exit and visible/audible behavior require actual session annotations')
$wrapper.Dispose()
}
} catch {
$receipt.status = 'failed'; $receipt.limitations = @($_.Exception.Message)
Write-Warning $_.Exception.Message
} finally {
if ($Mode -eq 'original' -and (Get-Variable copy -ErrorAction SilentlyContinue) -and
(Test-Path -LiteralPath $copy) -and -not (Test-Path -LiteralPath (Join-Path $run 'copy-post.json'))) {
try {
Write-FidelityJson (Join-Path $run 'copy-post.json') @(Get-FidelityTree $copy)
$receipt.identity.copy_post = @{path='copy-post.json'} + (Get-FidelityIdentity (Join-Path $run 'copy-post.json'))
} catch { $receipt.status = 'failed'; $receipt.limitations += ('Postflight failed: ' + $_.Exception.Message) }
}
$clock.wall_end = [DateTime]::UtcNow.ToString('o'); $clock.monotonic_end = $watch.Elapsed.TotalSeconds
Write-FidelityJson (Join-Path $run 'run.json') $receipt
if ($receipt.status -in @('failed','skipped','aborted')) { Write-FidelityJson (Join-Path $run 'failure.json') $receipt }
$watch.Stop()
}
Write-Host "Result: $run ; status=$($receipt.status); acceptance OPEN"
if ($receipt.status -eq 'failed') { return 2 }; return 0
}
function Complete-FidelityRun {
$null = Test-FidelityId $SessionId
$run = Get-FidelityPath $Bundle ('results/' + $SessionId)
$null = Test-FidelityBundle $Bundle
$runPath = Join-Path $run 'run.json'
$recovering = -not (Test-Path -LiteralPath $runPath)
if ($recovering) {
if ($Outcome -ne 'aborted') { throw 'Interrupted initial record can only be finalized as aborted' }
$runPath = Join-Path $run 'incomplete.json'
}
$receipt = Read-FidelityJson $runPath
if ($recovering) {
if ($receipt.status -ne 'incomplete' -or $receipt.session_id -cne $SessionId) { throw 'Interrupted initial record does not match the incomplete session' }
# Initial records from older collectors contain placeholder end values.
# Neither those placeholders nor recovery time observed the process end.
$receipt.clocks.PSObject.Properties.Remove('wall_end')
$receipt.clocks.PSObject.Properties.Remove('monotonic_end')
$receipt.missing_evidence += 'Interrupted collector: end clocks and launch-aligned observations unavailable'
$receipt | Add-Member -Force -NotePropertyName diagnostic -NotePropertyValue $true
}
if (Test-Path -LiteralPath (Join-Path $run 'receipt.json')) { throw 'Result already finalized; preserve it and use a new result ID' }
if (-not $AnnotationPath -or -not $ArtifactsDirectory) { throw 'Finish requires actual annotations and a local artifact directory' }
$annotation = Read-FidelityJson $AnnotationPath
$requested = Get-FidelityOutcome $receipt.status $Outcome $Reason
if ($annotation.schema_version -ne 1) { throw 'Unsupported annotation schema' }
if ($recovering -and @($annotation.events).Count) { throw 'Interrupted run has no observed end interval; retain annotations without launch-aligned events' }
if (@($annotation.artifacts).Count -gt 10000) { throw 'Too many artifacts' }
$names = @{}
foreach ($file in $annotation.artifacts) {
$null = Get-FidelityPath $ArtifactsDirectory $file.path
if ($names.ContainsKey($file.path)) { throw 'Duplicate/case-aliased artifact' }; $names[$file.path] = $file
$null = Get-FidelityIdentity (Get-FidelityPath $ArtifactsDirectory $file.path)
if ($file.PSObject.Properties.Name -contains 'synthetic' -and $file.synthetic) { throw 'Synthetic media cannot be relabeled as native/original' }
}
foreach ($event in $annotation.events) {
if (-not $names.ContainsKey($event.artifact)) { throw 'Event references missing artifact' }
}
if ($requested -eq 'captured') {
if (-not @($annotation.artifacts | Where-Object {$_.role -eq 'video' -and $_.path.EndsWith('.mkv',[StringComparison]::OrdinalIgnoreCase)}).Count) {
throw 'Captured result requires retained raw MKV video'
}
if (-not @($annotation.artifacts | Where-Object {$_.role -eq 'audio'}).Count) { throw 'Captured result requires actual audio evidence' }
}
foreach ($derivative in $annotation.derivatives) {
if (-not $names.ContainsKey($derivative.path) -or -not $names.ContainsKey($derivative.source) -or
-not $derivative.tool -or -not $derivative.version -or -not $derivative.created_utc -or
-not @($derivative.argv).Count -or -not $derivative.timestamp_mapping -or
-not $derivative.crop_aspect -or $derivative.browser_playback_verified -isnot [bool] -or
-not $derivative.browser_playback_verified) {
throw 'Derivative requires source/output, actual tool/version/argv/time/crop and verified browser playback'
}
}
$receipt.artifacts = @()
if ($recovering) {
$initial = Copy-FidelityEvidence $runPath $run 'recovery-initial.json'
$initial.role = 'diagnostic'
$receipt.artifacts += $initial
}
foreach ($file in $annotation.artifacts) {
$source = Get-FidelityPath $ArtifactsDirectory $file.path
$id = Copy-FidelityEvidence $source $run ('media/' + $file.path)
$id.role = $file.role
if ($file.PSObject.Properties.Name -contains 'duration_seconds') { $id.duration_seconds = $file.duration_seconds }
$receipt.artifacts += $id
}
$copied = Copy-FidelityEvidence $AnnotationPath $run 'annotations.json'
$copied.role = 'input_events'; $receipt.artifacts += $copied
$receipt.events = @($annotation.events | ForEach-Object {
if (-not $names.ContainsKey($_.artifact)) { throw 'Event references missing artifact' }
$_.artifact = 'media/' + $_.artifact; $_
})
$receipt.derivatives = @($annotation.derivatives | ForEach-Object {
$_.path = 'media/' + $_.path; $_.source = 'media/' + $_.source; $_
})
$receipt.status = $requested
if ($annotation.PSObject.Properties.Name -contains 'continuity') {
$continuity = $annotation.continuity
if ($continuity.PSObject.Properties.Name -contains 'prerequisite_artifact') {
if (-not $names.ContainsKey($continuity.prerequisite_artifact)) { throw 'Continuity references missing artifact' }
$continuity.prerequisite_artifact = 'media/' + $continuity.prerequisite_artifact
}
$receipt | Add-Member -Force -NotePropertyName continuity -NotePropertyValue $continuity
}
if ($annotation.PSObject.Properties.Name -contains 'diagnostic') { $receipt | Add-Member -Force -NotePropertyName diagnostic -NotePropertyValue ([bool]$annotation.diagnostic) }
if ($Reason) { $receipt.limitations += $Reason }
$receipt.limitations += @($annotation.limitations)
# Human declarations remain source annotations; the shared importer and final
# audit validate times, hashes, category, continuity and actual review later.
$receipt.limitations += 'Imported annotations require shared validation; raw MKV and incomplete/failed cases are retained'
Write-FidelityJson (Join-Path $run 'receipt.json') $receipt
Write-Host "Result saved ($requested); acceptance OPEN. Return full checkpoint locally for validation."
}
if ($LibraryOnly) { return }
try {
if ($Action -eq 'Preflight') {
$manifest = Test-FidelityBundle $Bundle
Write-Host "Prepared materials checked: $($manifest.files.Count) files; acceptance OPEN; actual Windows/tools/media preflight pending"
exit 0
}
if ($Action -eq 'Finish') { Complete-FidelityRun; exit 0 }
if ($Action -eq 'Retained') {
$null = Test-FidelityId $SessionId
$run = Get-FidelityPath $Bundle ('results/' + $SessionId)
$copy = Get-FidelityPath $Bundle ('original-runs/' + $SessionId)
Write-FidelityJson (Join-Path $run 'retained-copy.json') @{observed_utc=[DateTime]::UtcNow.ToString('o');
files=@(Get-FidelityTree $copy);note='Snapshot only; prerequisite recording and actual media timing/uncertainty still required'}
exit 0
}
exit (Start-FidelityRun)
} catch {
Write-Error ('Collector failed; acceptance OPEN: ' + $_.Exception.Message)
exit 2
}
+6
View File
@@ -0,0 +1,6 @@
#!/usr/bin/env bash
set -euo pipefail
source "$(dirname "$0")/env.sh"
# Build first into NEW local output, then prepare a different NEW bundle root.
# Existing dist packages retain their historical bytes and BUILD-INFO.
exec python3 tools/recon/fidelity_checkpoint.py "$@"
+42 -1
View File
@@ -1,7 +1,43 @@
#!/usr/bin/env bash
set -euo pipefail
source "$(dirname "$0")/env.sh"
python3 -m unittest discover -s tests -p 'test_*.py' -v
suite_started=$SECONDS
mkdir -p artifacts/fidelity
python3 - <<'PY'
import sys
import unittest
suite = unittest.defaultTestLoader.discover('tests', pattern='test_*.py')
def cases(node):
for item in node:
if isinstance(item, unittest.TestSuite):
yield from cases(item)
else:
yield item
counts = {}
for case in cases(suite):
module = case.id().split('.')[0]
if module.startswith('test_fidelity_'):
counts[module] = counts.get(module, 0) + 1
required = ('sessions', 'scenarios', 'review', 'ledger', 'observation',
'checkpoint', 'capture', 'acceptance')
assert all(counts.get('test_fidelity_' + name, 0) > 0 for name in required), counts
print('Fidelity Python checks:', sum(counts.values()), counts, flush=True)
sys.exit(not unittest.TextTestRunner(verbosity=2).run(suite).wasSuccessful())
PY
node --test --test-reporter=tap tests/fidelity-viewer.test.mjs | tee artifacts/fidelity/consolidated-viewer.log
python3 - <<'PY'
import re
from pathlib import Path
text = Path('artifacts/fidelity/consolidated-viewer.log').read_text()
assert re.search(r'^# tests [1-9][0-9]*$', text, re.M), 'zero/missing viewer checks'
PY
dotnet run --project tests/GamePort.FidelityObservationTests | tee artifacts/fidelity/consolidated-observer.log
python3 - <<'PY'
import re
from pathlib import Path
text = Path('artifacts/fidelity/consolidated-observer.log').read_text()
assert re.search(r'Fidelity observation checks: [1-9][0-9]* passed', text), 'zero/missing observer checks'
PY
python3 tools/extractors/prepare.py --all-scenes --audio sounds musicsecretlab
dotnet run --project tests/GamePort.DataTests -- ../Original
dotnet run --project tests/GamePort.CollisionTests -- ../Original
@@ -18,6 +54,10 @@ dotnet run --project tests/GamePort.SphereResponseTests
dotnet run --project tests/GamePort.StaticCollisionTests
dotnet run --project tests/GamePort.BodyPhysicsTests
dotnet run --project tests/GamePort.BodyOwnershipTests
dotnet run --project tests/GamePort.PairLifecycleTests
dotnet run --project tests/GamePort.DynamicContextTests
dotnet run --project tests/GamePort.DynamicReclipTests
dotnet run --project tests/GamePort.ActorContactTests
dotnet run --project tests/GamePort.GadgetTests
dotnet run --project tests/GamePort.InvisibleTests
dotnet run --project tests/GamePort.BubbleMotionTests
@@ -114,3 +154,4 @@ if [[ "${NEUTRON_WINDOW_TEST:-0}" == 1 ]]; then
dotnet run --no-build -- --scene artifacts/extracted/level1b/scene.json --smoke-window --frames 6 --screenshot artifacts/test-window.ppm
dotnet run --no-build -- --smoke-walk --screenshot artifacts/test-walk-window.ppm
fi
printf 'Complete local suite passed in %s seconds; fidelity Python/Node/observer counts verified positive.\n' "$((SECONDS - suite_started))"
@@ -0,0 +1,239 @@
using System.Diagnostics;
using System.Numerics;
using System.Text;
using System.Text.Json;
using System.Text.RegularExpressions;
using GamePort.Game;
namespace GamePort.Application;
/// <summary>Optional application diagnostics. Owns only copied observations and output;
/// it never owns a simulation, callback, input source or continuation payload.</summary>
internal sealed class FidelityObservation : IDisposable
{
private static readonly JsonSerializerOptions Json = new() { PropertyNamingPolicy = JsonNamingPolicy.SnakeCaseLower };
private readonly Stopwatch clock = Stopwatch.StartNew();
private readonly string directory, session, caseId, kind;
private readonly string launchId = Guid.NewGuid().ToString("N");
private readonly DateTimeOffset wallStart = DateTimeOffset.UtcNow;
private readonly int maxRecords;
private const long MaxBytes = 512L * 1024 * 1024;
private TextWriter? writer;
private long sequence, bytes;
private string? failure;
private bool completed, disposed, ownsDirectory;
private double overhead;
private long? pendingDeparture;
private (string Scene, bool Controlled, string? Owner, bool Playing, string? Dialogue)? control;
private FidelityObservation(string directory, string session, string caseId, string kind, int maxRecords)
{ this.directory = directory; this.session = session; this.caseId = caseId; this.kind = kind; this.maxRecords = maxRecords; }
public static FidelityObservation? FromArguments(string[] args, string project, string originals)
{
string? Option(string name)
{
var index = Array.IndexOf(args, name);
if (index < 0) return null;
if (index + 1 == args.Length || args[index + 1].StartsWith("--", StringComparison.Ordinal))
throw new ArgumentException(name + " requires a value");
if (Array.LastIndexOf(args, name) != index) throw new ArgumentException("Repeated " + name);
return args[index + 1];
}
var output = Option("--fidelity-output");
if (output == null) return null;
var session = Option("--fidelity-session") ?? throw new ArgumentException("--fidelity-session required");
var caseId = Option("--fidelity-case") ?? throw new ArgumentException("--fidelity-case required");
var fixture = args.Any(a => a.StartsWith("--smoke-", StringComparison.Ordinal)
|| a.StartsWith("--", StringComparison.Ordinal) && a.EndsWith("-smoke", StringComparison.Ordinal)
|| a is "--headless" or "--story-time" or "--time" or "--inspect" or "--skip-intro"
or "--noclip" or "--debug-menu" or "--debug-page" or "--gadget-menu");
return Create(output, session, caseId, fixture ? "port_fixture" : "native_port", project, originals);
}
public static FidelityObservation Create(string output, string session, string caseId, string kind,
string project, string originals, int maxRecords = 250000, TextWriter? sink = null)
{
foreach (var id in new[] { session, caseId })
if (!Regex.IsMatch(id, "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$", RegexOptions.CultureInvariant))
throw new ArgumentException("Observation IDs require 1..128 safe characters");
if (kind is not ("port_fixture" or "native_port") || maxRecords < 1 || maxRecords > 250000)
throw new ArgumentException("Invalid observation category or record limit");
var path = Path.TrimEndingDirectorySeparator(Path.GetFullPath(output));
static bool Within(string child, string parent) => child.Equals(parent, StringComparison.OrdinalIgnoreCase)
|| child.StartsWith(Path.TrimEndingDirectorySeparator(parent) + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase);
static string ResolvedDirectory(string value)
{
var full = Path.GetFullPath(value);
var current = Path.GetPathRoot(full)!;
foreach (var part in full[current.Length..].Split(Path.DirectorySeparatorChar, StringSplitOptions.RemoveEmptyEntries))
{
current = Path.Combine(current, part);
var info = new DirectoryInfo(current);
if (info.LinkTarget != null)
current = info.ResolveLinkTarget(true)?.FullName ?? throw new ArgumentException("Unresolved protected asset link");
}
return Path.TrimEndingDirectorySeparator(current);
}
var protectedRoots = new List<string> { ResolvedDirectory(originals), Path.Combine(ResolvedDirectory(project), ".git") };
// A generated --assets copy must not make the checkout's authoritative sibling writable.
foreach (var candidate in new[] { Path.Combine(project, "..", "Original"), Path.Combine(project, "Original"), Path.Combine(project, "assets") })
if (Directory.Exists(candidate)) protectedRoots.Add(ResolvedDirectory(candidate));
if (protectedRoots.Any(protectedRoot => Within(path, protectedRoot) || Within(protectedRoot, path)))
throw new ArgumentException("Observation output must be separate from original assets and Git metadata");
for (var parent = new DirectoryInfo(path); parent != null; parent = parent.Parent)
if (parent.LinkTarget != null) throw new ArgumentException("Observation output cannot traverse symbolic links");
if (Directory.Exists(path) || File.Exists(path)) throw new IOException("Observation requires a new output directory");
var observer = new FidelityObservation(path, session, caseId, kind, maxRecords);
try
{
Directory.CreateDirectory(Path.GetDirectoryName(path)!);
// A cooperative local reservation prevents two observers reusing the same directory.
var reservation = path + ".fidelity-reservation";
using (new FileStream(reservation, FileMode.CreateNew, FileAccess.Write, FileShare.None))
{
if (Directory.Exists(path) || File.Exists(path)) throw new IOException("Observation directory was reserved by another writer");
Directory.CreateDirectory(path);
observer.ownsDirectory = true;
}
File.Delete(reservation);
observer.WriteSummary(false);
observer.writer = sink ?? new StreamWriter(new FileStream(Path.Combine(path, "events.jsonl"),
FileMode.CreateNew, FileAccess.Write, FileShare.Read), new UTF8Encoding(false), 65536);
observer.writer.NewLine = "\n";
}
catch (Exception error) when (OutputError(error)) { observer.Fail(error.Message); }
return observer;
}
public void RecordInput(string scene, int simulationTick, PlayerInput requested, bool acceptsInput, string controlOwner)
=> Record("input_step", scene, simulationTick, "post_owner_step", new {
requested_input = requested, accepts_input = acceptsInput,
accepted_input = acceptsInput ? (PlayerInput?)requested : null,
control_owner = controlOwner, control_owner_phase = "post_step",
acceptance_scope = "reported binding gate only; individual command dispatch and independent body/fire work are not classified by this boolean" });
public void RecordSceneEntry(string scene, int simulationTick, bool returning, bool retainedPlayer, string entryPath)
{
control = null;
Record("scene_entry", scene, simulationTick, "application_scene_composition", new {
returning, retained_player = retainedPlayer, entry_path = entryPath, departure_sequence = pendingDeparture });
pendingDeparture = null;
}
public void RecordTransition(string scene, string destination, int simulationTick, bool returning)
{
Record("scene_departure", scene, simulationTick, "continuation_published", new { destination, returning });
pendingDeparture = sequence;
}
public void RecordRawEvent(string scene, int simulationTick, uint eventType, uint? scancode, byte? button, byte? repeat)
=> Record("raw_sdl_event", scene, simulationTick, "sdl_poll_before_routing", new {
event_type = eventType, scancode, button, repeat, acceptance = "raw_only; routing may consume or reject this event" });
public void RecordControl(string scene, int simulationTick, bool controlled, string? owner, bool playing, string? dialogue, string boundary)
{
var current = (scene, controlled, owner, playing, dialogue);
var previous = control;
if (previous == current && !boundary.StartsWith("skip:", StringComparison.Ordinal)) return;
var data = new { controlled, control_owner = owner, playing, dialogue };
Record("control_observation", scene, simulationTick, boundary, data);
if (boundary.StartsWith("skip:", StringComparison.Ordinal) && previous is { } before && (before.Playing || !before.Controlled))
Record("dialogue_skip", scene, simulationTick, boundary, data);
if ((previous == null || previous is { Playing: false }) && playing)
Record("dialogue_start", scene, simulationTick, boundary, data);
if (previous is { Playing: true } && !playing)
Record("dialogue_end", scene, simulationTick,
boundary == "director_step" ? "natural_director_step" : boundary, data);
control = current;
}
public void RecordState(string scene, int simulationTick, Vector3 root, Vector3 rotation, Vector3 velocity,
bool grounded, int movementMode, bool inputAfterPlayerUpdate, int controllers, int physics, int effects)
=> Record("player_state", scene, simulationTick, "post_owner_value_snapshot", new {
actor_root = new[] { root.X, root.Y, root.Z }, euler_degrees = new[] { rotation.X, rotation.Y, rotation.Z },
velocity = new[] { velocity.X, velocity.Y, velocity.Z }, grounded, movement_mode = movementMode,
input_after_player_update = inputAfterPlayerUpdate, controller_steps = controllers, physics_steps = physics,
effect_steps = effects, interpretation = "copied state only; bank/landing/idle require explicit review" });
private void Record(string name, string scene, int simulationTick, string method, object data)
{
if (disposed || completed || failure != null) return;
var started = Stopwatch.GetTimestamp();
try
{
if (sequence >= maxRecords) throw new IOException("Observation record limit reached");
var line = JsonSerializer.Serialize(new { schema_version = 1, session_id = session, case_id = caseId,
evidence_kind = kind, launch_id = launchId, clock_id = launchId + ":stopwatch", sequence = sequence + 1,
elapsed_seconds = clock.Elapsed.TotalSeconds, simulation_tick = simulationTick,
name, scene, method, data }, Json);
var length = Encoding.UTF8.GetByteCount(line) + 1;
if (bytes + length > MaxBytes) throw new IOException("Observation byte limit reached");
writer!.WriteLine(line);
sequence++; bytes += length;
}
catch (Exception error) when (OutputError(error)) { Fail(error.Message); }
finally { overhead += Stopwatch.GetElapsedTime(started).TotalSeconds; }
}
public void Complete(int exitCode)
{
if (disposed || completed) return;
if (exitCode != 0) Fail("Port exited with code " + exitCode);
try { writer?.Dispose(); writer = null; }
catch (Exception error) when (OutputError(error)) { Fail(error.Message); }
completed = true;
TrySummary(exitCode == 0 && failure == null);
}
private static bool OutputError(Exception error) => error is IOException or UnauthorizedAccessException
or System.Security.SecurityException or JsonException or ArgumentException or NotSupportedException;
private void Fail(string reason)
{
if (failure != null) return;
failure = reason;
Console.Error.WriteLine("Fidelity observation INCOMPLETE: " + reason);
try { writer?.Dispose(); } catch (Exception error) when (OutputError(error)) { }
writer = null;
TrySummary(false);
}
private void TrySummary(bool success)
{
if (!ownsDirectory) return;
try { WriteSummary(success); }
catch (Exception error) when (OutputError(error))
{ Console.Error.WriteLine("Fidelity observation INCOMPLETE; summary unavailable: " + error.Message); }
}
private void WriteSummary(bool success)
{
var target = Path.Combine(directory, "observation-summary.json");
var temporary = target + "." + Guid.NewGuid().ToString("N") + ".tmp";
var summary = new { schema_version = 1, session_id = session, case_id = caseId, evidence_kind = kind,
launch_id = launchId, clock_id = launchId + ":stopwatch", wall_start = wallStart, wall_end = DateTimeOffset.UtcNow,
elapsed_seconds = clock.Elapsed.TotalSeconds, records = sequence, bytes, incomplete = !success,
status = success ? "recorded" : "incomplete", failure,
diagnostic = true, observer_seconds = overhead, max_records = maxRecords, max_bytes = MaxBytes,
overhead_scope = "Record serialization/write attempts only; excludes caller snapshots, control comparisons, final flush and summaries",
limitations = new[] { "Diagnostic observer adds serialization, buffered disk writes and state-copy overhead; not a clean audiovisual capture.",
"Observation is not a receipt or an acceptance decision; fixture and native full-route evidence remain distinct.",
"No media clock mapping is inferred. Simulation ticks are scene-local and may reset across continuations.",
"Only named application seams are observed; fixture helper-internal steps are not a complete simulation trace." } };
try
{
using (var stream = new FileStream(temporary, FileMode.CreateNew, FileAccess.Write, FileShare.None))
JsonSerializer.Serialize(stream, summary, Json);
File.Move(temporary, target, true);
}
finally { if (File.Exists(temporary)) File.Delete(temporary); }
}
public void Dispose()
{
if (disposed) return;
if (!completed) { Fail("Session ended without successful completion"); TrySummary(false); }
disposed = true;
}
}
+20 -9
View File
@@ -30,7 +30,11 @@ public static class OriginalBodySupport
private static readonly ushort[] halfAcos = BuildHalfAcos();
/// <summary>OMT1001FF70: largest component divided by a quantized sine lookup.</summary>
public static float QuickMagnitude(Vector3 vector)
public static float QuickMagnitude(Vector3 vector) => (float)QuickMagnitudeIntermediate(vector);
// OMT returns its quotient in an x87 register. Callers with no intervening
// float store must retain that intermediate; this is not general x87 emulation.
internal static double QuickMagnitudeIntermediate(Vector3 vector)
{
RequireFinite(vector);
var x = (double)MathF.Abs(vector.X);
@@ -43,7 +47,7 @@ public static class OriginalBodySupport
if (z == 0) return 0;
var otherSquared = x * x + y * y;
var index = (int)(otherSquared * 16384 / (otherSquared + z * z)) & 0x3fff;
return (float)(z / sine[halfAcos[index] & 0x3fff]);
return z / sine[halfAcos[index] & 0x3fff];
}
/// <summary>
@@ -100,11 +104,13 @@ public static class OriginalBodySupport
ArgumentNullException.ThrowIfNull(triangles);
RequireFinite(start); RequireFinite(end);
var direction = end - start;
var length = QuickMagnitude(direction);
var length = QuickMagnitudeIntermediate(direction);
if (length == 0) return null;
direction /= length;
var reciprocal = 1 / length;
direction = new((float)(direction.X*reciprocal),(float)(direction.Y*reciprocal),
(float)(direction.Z*reciprocal));
SupportHit? nearest = null;
var nearestDistance = length;
var nearestDistance = (float)length;
foreach (var triangle in triangles)
{
var hit = IntersectSegment(triangle, start, direction, length, twoSided);
@@ -124,13 +130,15 @@ public static class OriginalBodySupport
{
RequireFinite(start); RequireFinite(end);
var direction = end - start;
var length = QuickMagnitude(direction);
var length = QuickMagnitudeIntermediate(direction);
if (length == 0) return null;
return IntersectSegment(triangle, start, direction / length, length, twoSided);
var reciprocal = 1 / length;
return IntersectSegment(triangle, start,new((float)(direction.X*reciprocal),
(float)(direction.Y*reciprocal),(float)(direction.Z*reciprocal)),length,twoSided);
}
private static SupportHit? IntersectSegment(SupportTriangle triangle,
Vector3 start, Vector3 direction, float length, bool twoSided)
Vector3 start, Vector3 direction, double length, bool twoSided)
{
RequireFinite(triangle.A); RequireFinite(triangle.B); RequireFinite(triangle.C);
var edge1 = triangle.B - triangle.A;
@@ -150,7 +158,10 @@ public static class OriginalBodySupport
var distance = Dot(q, edge2) * inverse;
// Beginning accepted, endpoint rejected; no invented camera radius/skin.
if (distance < 0 || distance >= length) return null;
var position = start + direction * distance;
//469DF0..469E13 stores each hit coordinate only after multiply+add.
//Keep the product until that store, including near-cancelling inputs.
var position = new Vector3((float)(start.X+(double)direction.X*distance),
(float)(start.Y+(double)direction.Y*distance),(float)(start.Z+(double)direction.Z*distance));
return new SupportHit(position, triangle.ShapeId, triangle.PolygonId, QuickMagnitude(position - start));
}
+4 -1
View File
@@ -30,7 +30,10 @@ public static class OriginalHeading
return (-angle) & 0x3fff;
}
/// <summary>Copied OMT2 vector::angles pitch/yaw, in signed14-bit circle units.</summary>
/// <summary>
/// Signed circle representation used by movement consumers of OMT2 angles.
/// Mask yaw with16383 when matching the DLL's raw14-bit circle output.
/// </summary>
public static (int Pitch,int Yaw) Angles(Vector3 vector)
{
var heading=HeadingUnits(vector);
@@ -0,0 +1,84 @@
using System.Numerics;
namespace GamePort.Game;
/// <summary>Actor-owned accessors used by the base370/374/378 callbacks.</summary>
public interface IOriginalNormalBody
{
Vector4 ReadVelocity();
void WriteVelocity(Vector4 value);
void WriteVelocityXYZ(Vector3 value);
Vector4 ReadAcceleration();
void WriteAcceleration(Vector4 value);
bool ReflectWalls { get; }
float WallDamping { get; }
void AddAngularVelocity(Vector3 delta);
}
/// <summary>
/// Bounded472690/458890/472750 callbacks, with live accessor order and original
/// heading impulse. Not a Jimmy override or live scene-admission policy.
/// </summary>
public static class OriginalNormalContacts
{
public static void Ceiling(IOriginalNormalBody body)
{
ArgumentNullException.ThrowIfNull(body);
var velocity = body.ReadVelocity();
if (velocity.Y > 0) body.WriteVelocity(velocity with {Y = 0});
var acceleration = body.ReadAcceleration();
if (acceleration.Y > 0) body.WriteAcceleration(acceleration with {Y = 0});
}
public static void GenericWall(IOriginalNormalBody body, Vector3 normal,
Func<Vector4,int>? headingUnits = null)
{
ArgumentNullException.ThrowIfNull(body);
if (!body.ReflectWalls) return;
Reflect(body,normal,headingUnits);
}
public static void Reflect(IOriginalNormalBody body, Vector3 normal,
Func<Vector4,int>? headingUnits = null)
{
ArgumentNullException.ThrowIfNull(body);
Finite(normal);
var velocity = body.ReadVelocity();
var horizontal = new Vector3(velocity.X,0,velocity.Z);
var magnitude = OriginalBodySupport.QuickMagnitude(horizontal);
if (magnitude <= 0) throw new NotSupportedException("Original zero-horizontal normalization is outside the finite contact contract");
var direction = Normalize(horizontal,velocity.W);
var dot = -((double)direction.Z*normal.Z + (double)direction.X*normal.X + (double)direction.Y*normal.Y);
var reflected = new Vector3((float)(direction.X + 2*dot*normal.X),
(float)(direction.Y + 2*dot*normal.Y),(float)(direction.Z + 2*dot*normal.Z));
var x = reflected.X*magnitude;
//472834 samples live Y again, after computing the horizontal reflection.
var y = body.ReadVelocity().Y;
var z = reflected.Z*magnitude;
var damping = body.WallDamping;
if (!float.IsFinite(damping)) throw new ArgumentOutOfRangeException(nameof(body));
body.WriteVelocityXYZ(new((float)(x-(double)damping*x),y,(float)(z-(double)damping*z)));
headingUnits ??= static vector => OriginalHeading.Angles(new(vector.X,vector.Y,vector.Z)).Yaw & 16383;
var oldHeading = headingUnits(direction)*0.02197265625f;
var outgoing = Normalize(new(x,0,z),0);
var newHeading = headingUnits(outgoing)*0.02197265625f;
double delta = oldHeading-newHeading;
if (delta > 180) delta -= 360;
else if (delta < -180) delta += 360;
body.AddAngularVelocity(new(0,(float)(delta*magnitude*0.001f),0));
}
private static Vector4 Normalize(Vector3 vector,float w)
{
var length = OriginalBodySupport.QuickMagnitudeIntermediate(vector);
if (length <= 0) throw new NotSupportedException("Original zero reflected normalization is outside the finite contact contract");
var reciprocal = 1/length;
return new((float)(vector.X*reciprocal),(float)(vector.Y*reciprocal),(float)(vector.Z*reciprocal),w);
}
private static void Finite(Vector3 vector)
{
if (!float.IsFinite(vector.X) || !float.IsFinite(vector.Y) || !float.IsFinite(vector.Z))
throw new ArgumentOutOfRangeException(nameof(vector));
}
}
@@ -0,0 +1,87 @@
using System.Numerics;
namespace GamePort.Game;
/// <summary>Live callbacks of an original physical-list member, not render visibility or raw control.</summary>
public interface IOriginalPairBody
{
bool PairCollisionEnabled { get; }
int CollisionMode { get; }
Vector3 Root { get; }
float Radius { get; }
bool AllowsPair(IOriginalPairBody other);
bool Excludes(IOriginalPairBody other);
bool HasContact(IOriginalPairBody other);
void SphereOverlap(IOriginalPairBody other, float distance);
void Enter(IOriginalPairBody other);
void Stay(IOriginalPairBody other);
void Leave(IOriginalPairBody other);
}
/// <summary>
/// EXE47A430/47B3E0/47CA90 ordered pair and notification contract. The caller
/// supplies physical registration order and real actor callbacks. Mode2 geometry
/// remains a separate injected solver. Not yet admitted to the live scene loop.
/// </summary>
public static class OriginalPairCollision
{
/// <remarks>
/// This bounded component requires a stable list during the pass. Source
/// linked-list insertion/deletion during callbacks is not reconstructed here.
/// Eligibility gates retain existing contacts; they do not synthesize leaves.
/// </remarks>
public static void Step(IReadOnlyList<IOriginalPairBody> bodies,
Func<IOriginalPairBody, IOriginalPairBody, bool>? boxContact = null, bool enabled = true)
{
ArgumentNullException.ThrowIfNull(bodies);
if (!enabled) return;
for (var i = 0; i < bodies.Count; i++)
{
var first = bodies[i];
//47A46E: sampled once for this outer traversal, before its callbacks.
if (!first.PairCollisionEnabled) continue;
for (var j = i; j < bodies.Count; j++)
{
var second = bodies[j];
if (!second.PairCollisionEnabled || ReferenceEquals(first, second)
|| !first.AllowsPair(second) || !second.AllowsPair(first)) continue;
bool contact;
if (first.CollisionMode == 2) contact = Box(first, second);
else if (second.CollisionMode == 2) contact = Box(second, first);
else contact = SphereContact(first, second);
Notify(first, second, contact);
//The first callback can alter the second actor's membership.
Notify(second, first, contact);
}
}
bool Box(IOriginalPairBody box, IOriginalPairBody other) =>
(boxContact ?? throw new InvalidOperationException("Mode2 requires an explicit source box solver"))(box, other);
}
public static bool SphereContact(IOriginalPairBody first, IOriginalPairBody second)
{
//Source queries second root first, then first root and both radii.
var secondRoot = second.Root;
var firstRoot = first.Root;
var firstRadius = first.Radius;
var radius = second.Radius + firstRadius;
var distance = OriginalBodySupport.QuickMagnitude(secondRoot - firstRoot);
//47CA90 checks only the earlier body's exclusions, after strict overlap.
if (!(distance < radius) || first.Excludes(second)) return false;
first.SphereOverlap(second, distance);
second.SphereOverlap(first, distance);
return true;
}
private static void Notify(IOriginalPairBody self, IOriginalPairBody other, bool contact)
{
if (!contact)
{
if (self.HasContact(other)) self.Leave(other);
}
else if (self.HasContact(other)) self.Stay(other);
else self.Enter(other);
}
}
+10 -3
View File
@@ -55,8 +55,10 @@ public static class OriginalSphereResponse
var direction = toEdge / distance;
if (Dot(direction, normal) >= 0 || state.EdgeDistance != -1 && distance >= state.EdgeDistance)
return unchanged;
var edgePosition = nearest - direction * radius;
edgePosition.Y = position.Y;
//47C194..47C1D0 keeps each X/Z product through the subtraction before
//the final float store; Vector3 multiplication would round it early.
var edgePosition = new Vector3((float)(nearest.X-(double)direction.X*radius),position.Y,
(float)(nearest.Z-(double)direction.Z*radius));
return new(edgePosition, state with { EdgeDistance = distance, Hit = nearest }, SphereContact.Edge);
}
@@ -67,7 +69,12 @@ public static class OriginalSphereResponse
if (length == 0) return a;
var direction = edge / length;
var projection = Dot(point - a, direction);
return projection < 0 ? a : projection > length ? b : a + direction * projection;
if (projection < 0) return a;
if (projection > length) return b;
//4699A0..4699DE retains X's product until adding the segment origin;
//Y/Z products have explicit intervening float stores in the source.
return new((float)(a.X+(double)direction.X*projection),
a.Y+direction.Y*projection,a.Z+direction.Z*projection);
}
private static float Dot(Vector3 a, Vector3 b) =>
@@ -8,6 +8,8 @@ public sealed class StaticCollisionContext(float radius, float faceDistance = 13
public SphereResponseState Nearest { get; internal set; } = new(faceDistance, radius, null);
public CameraRayPolygon? LastPolygon { get; internal set; }
public int Passes { get; internal set; }
//47B6A8..47B6B9 counts list visits before the geometry-enable gate.
public int NodeVisits { get; internal set; }
public int TriangleTests { get; internal set; }
}
@@ -100,6 +102,7 @@ public sealed class OriginalStaticCollision
if (walls.TryGetValue(cell, out var polygons))
foreach (var polygon in polygons)
{
context.NodeVisits++;
if (!geometryEnabled) continue;
context.TriangleTests++;
var result = OriginalSphereResponse.Resolve(polygon.Triangle, polygon.StoredNormal,
+54 -16
View File
@@ -15,6 +15,8 @@ internal static class Program
{
try
{
using var observation = args.Contains("--help") || !args.Contains("--fidelity-output") ? null : FidelityObservation.FromArguments(args,
Directory.GetCurrentDirectory(), AssetPath.FindOriginal(Option(args, "--assets")));
using var presentation = new RenderSession();
OriginalSave? carriedSave = null;
PlayerLevelState? carriedPlayer = null;
@@ -24,8 +26,8 @@ internal static class Program
var grapplerMemory = new GrapplerMemory();
while (true)
{
var result = Run(args, carriedSave, carriedPlayer, returning, diagnostics, presentation, energy, grapplerMemory, out var continuation);
if (result != 0 || continuation == null) return result;
var result = Run(args, carriedSave, carriedPlayer, returning, diagnostics, presentation, energy, grapplerMemory, observation, out var continuation);
if (result != 0 || continuation == null) { observation?.Complete(result); return result; }
args = continuation.Args; carriedSave = continuation.Save; returning = continuation.Returning;
carriedPlayer = continuation.Player;
}
@@ -45,7 +47,7 @@ internal static class Program
private sealed record SceneContinuation(string[] Args, OriginalSave Save, bool Returning, PlayerLevelState? Player);
private static int Run(string[] args, OriginalSave? carriedSave, PlayerLevelState? carriedPlayer, bool returning, DebugDiagnostics diagnostics,
RenderSession presentation, PlayerEnergy energy, GrapplerMemory grapplerMemory, out SceneContinuation? continuation)
RenderSession presentation, PlayerEnergy energy, GrapplerMemory grapplerMemory, FidelityObservation? observation, out SceneContinuation? continuation)
{
continuation = null;
if (args.Contains("--help"))
@@ -69,6 +71,9 @@ internal static class Program
--start TAG Use a named original STRT checkpoint
--load-save PATH Resume original TSK task/items/checkpoint state
--write-save PATH Write checkpoint state as TSK outside asset directory
--fidelity-output PATH New local diagnostic session directory
--fidelity-session ID Stable session identity across scene continuations
--fidelity-case ID Declared comparison case; does not establish acceptance
--mute Disable scene audio
--time SECONDS Fixed animation time for comparisons
--headless Render offscreen through Vulkan
@@ -336,6 +341,24 @@ internal static class Program
var debugCheckpointFile = toolsSmoke ? Path.GetFullPath("artifacts/debug-expansion/checkpoint.tsk")
: Path.Combine(AppContext.BaseDirectory, "debug-checkpoint.tsk");
Vector3 returnRoot = loadedSave?.StoredVector ?? Vector3.Zero;
void ObserveControl(string boundary)
{
if (observation != null && director != null)
observation.RecordControl(level!.Code, simulation?.Steps ?? 0, director.Controlled,
director.ControlledTag, director.Playing, director.CurrentTag, boundary);
}
void SkipObservedDialogue(string source)
{
ObserveControl("before_skip");
director!.Skip();
ObserveControl("skip:" + source);
}
void StepObservedDirector(float delta)
{
ObserveControl("before_director_step");
director?.Step(delta);
ObserveControl("director_step");
}
void RequestTransition(LevelTransition request)
{
if (transitionRequest != null) return;
@@ -588,6 +611,8 @@ internal static class Program
var renderer = presentation.LoadScene(mesh, texture, headless,
walking ? WalkTitle : animations?.WindowTitle ?? "Jimmy Neutron — scene preview | C camera",
width, height, !args.Contains("--no-validation"));
observation?.RecordSceneEntry(level?.Code ?? "preview", simulation?.Steps ?? 0, returning,
carriedPlayer != null, carriedSave != null ? "retained" : loadedSave != null ? "tsk-story" : "fresh-direct-scene");
var window = presentation.Window;
ShrinkSoldier? shrinkVictim = null;
var shrinkPhaseMask = 0;
@@ -663,6 +688,7 @@ internal static class Program
sceneAudio.Music(originalStart!.Text("MusicDatabase") ?? "none", originalStart.Integer("MusicIndex", -1));
}
director.Begin(originalStart!, activateStartTrigger: !returning);
ObserveControl("scene_begin");
gadgets?.Reset();
baseballs?.Reset();
interactions!.Reset();
@@ -680,7 +706,7 @@ internal static class Program
Console.WriteLine($"Practice RETURN: exact saved root={restored}, root={simulation.ActorRoot}, STRT yaw={simulation.Yaw}, intro suppressed={!director.Playing}, companion restored={companionRestored}, retained player input order={simulation.InputAfterPlayerUpdate}, gadget availability={interactions.Inventory.State(0, 3)}.");
if (!restored) throw new InvalidOperationException("RETURN did not restore the live departure root without replaying STRT actions");
}
if (args.Contains("--skip-intro") || jetpackSmoke || shrinkSmoke || invisibleSmoke || bubbleSmoke || baseballSmoke || rocketSmoke || grapplerSmoke || scooterSmoke || gadgetWindowSmoke || debugSmoke || diagnosticsSmoke || toolsSmoke || controlPhaseSmoke) { sceneAudio?.StopSpeech(); director.Skip(); }
if (args.Contains("--skip-intro") || jetpackSmoke || shrinkSmoke || invisibleSmoke || bubbleSmoke || baseballSmoke || rocketSmoke || grapplerSmoke || scooterSmoke || gadgetWindowSmoke || debugSmoke || diagnosticsSmoke || toolsSmoke || controlPhaseSmoke) { sceneAudio?.StopSpeech(); SkipObservedDialogue("startup-option-or-fixture"); }
if (gadgetWindowSmoke) { interactions!.Inventory.SetState(0,3,1); interactions.Inventory.SelectGadget(3); }
if (controlPhaseSmoke)
{
@@ -705,13 +731,13 @@ internal static class Program
{
if (interactions!.Inventory.State(0, 3) != 1)
throw new InvalidOperationException("VR04 PostLoad tail did not re-enable its owned practice jetpack");
director.Skip();
SkipObservedDialogue("fixture-setup");
interactions!.Update(level.Entities.First(e => e.Kind == "LOAD").Position);
if (transitionRequest is not { Returning: true }) throw new InvalidOperationException("VR04 exit did not preserve RETURN identity");
}
if (args.Contains("--smoke-transition"))
{
director.Skip();
SkipObservedDialogue("fixture-setup");
interactions!.Update(level!.Entities.First(e => e.Kind == "LOAD").Position);
if (transitionRequest == null) throw new InvalidOperationException("Original VR01 RETURN contact did not request a transition");
}
@@ -724,9 +750,9 @@ internal static class Program
if (carlSmoke) LabRouteSmoke.StartCarl(level!, director, interactions!, () => practice.Key(17, Vector2.Zero));
if (objectiveSmoke)
{
director.Skip();
SkipObservedDialogue("fixture-setup");
director.Touch(level!.Player!.Tag!, level.Entities.Single(e => e.Tag == "teleportexplanation").Position);
director.Skip();
SkipObservedDialogue("fixture-setup");
if (interactions!.CurrentObjective != 1) throw new InvalidOperationException("Original explanation did not assign objective1");
if (objectiveWindowSmoke) objectivePanel!.Step(9);
}
@@ -734,7 +760,7 @@ internal static class Program
|| practiceReturnSmoke && level.Code == "LV1B" && !returning)
{
if ((!headless && !practiceWindowSmoke) || level?.Code != "LV1B") throw new ArgumentException("Practice smoke requires the original lab");
director.Skip();
SkipObservedDialogue("fixture-setup");
if (practiceReturnSmoke)
{
// Move the real player away from STRT so an accidental
@@ -743,7 +769,7 @@ internal static class Program
director.SyncActor(level.Player!.Tag!, simulation.ActorRoot, simulation.Rotation);
}
director.Touch(level!.Player!.Tag!, level.Entities.Single(e => e.Tag == "teleportexplanation").Position);
director.Skip();
SkipObservedDialogue("fixture-setup");
interactions!.Update(director.FindActor("shrinkray")!.Position);
if (!practice.Active) throw new InvalidOperationException("Original lab pickup did not open practice modal");
if (args.Contains("--smoke-practice-transition") || practiceReturnSmoke) practice.Key(28, Vector2.Zero);
@@ -756,7 +782,7 @@ internal static class Program
interactions!.UpdateEnergy(simulation!.Energy);
foreach (var patrol in patrols.Values) patrol.Step(FixedStepClock.Step);
mechanisms!.Step(FixedStepClock.Step);
director.Step(FixedStepClock.Step);
StepObservedDirector(FixedStepClock.Step);
objectivePanel!.Step(FixedStepClock.Step, director.ControlledTag != null, practice.Active);
if (animations!.SelectAction(director.FindActor(level!.Player!.Tag!)!.Animation)) initialPoseTime = 0;
initialPoseTime += FixedStepClock.Step;
@@ -874,6 +900,7 @@ internal static class Program
if (simulation == null) { debugMenu.Message = "RESET REQUIRES PLAY MODE"; return; }
if (practice.Active) practice.Key(17, Vector2.Zero);
playerBinding?.ResetVehicle();simulation.Reset(); poseTime = 0; sceneAudio?.StopSpeech(); director?.Begin(originalStart!);
ObserveControl("reset_begin");
rocketship?.Reset();
if(scooter!=null)
{
@@ -909,7 +936,7 @@ internal static class Program
case DebugAction.Camera: ToggleCamera(); debugMenu.Close(); break;
case DebugAction.SkipCutscene:
if (director is { Playing: true } or { Blocked: true }||director is{Controlled:false}&&rocketship?.Mounted!=true)
{ sceneAudio?.StopSpeech(); director.Skip(); debugMenu.Message = "CUTSCENE SKIPPED"; }
{ sceneAudio?.StopSpeech(); SkipObservedDialogue("debug-menu"); debugMenu.Message = "CUTSCENE SKIPPED"; }
else debugMenu.Message = "NO ACTIVE CUTSCENE";
break;
case DebugAction.RefillEnergy when simulation != null:
@@ -1132,6 +1159,10 @@ internal static class Program
}
while (!headless && Sdl.SDL_PollEvent(out var e))
{
observation?.RecordRawEvent(level?.Code ?? "preview", simulation?.Steps ?? 0,
e.Type, e.Type is Sdl.KeyDown or Sdl.KeyUp ? e.Scancode : null,
e.Type is Sdl.MouseButtonDown or Sdl.MouseButtonUp ? e.MouseButton : null,
e.Type is Sdl.KeyDown or Sdl.KeyUp ? e.Repeat : null);
if(scooterSmoke&&e.Type==Sdl.KeyDown)
sawScooterKeys|=e.Scancode switch{81=>1,82=>2,80=>4,225=>8,43=>16,60=>32,21=>64,_=>0};
if(grapplerSmoke&&e.Type==Sdl.KeyDown)
@@ -1225,7 +1256,7 @@ internal static class Program
if (smoke && e.Scancode == 79) sawKey = true;
if (e.Scancode is 41 or 44 && e.Repeat == 0 && director is { Controlled: false }&&rocketship?.Mounted!=true
&& (e.Scancode != 44 || simulation?.Noclip != true))
{ sceneAudio?.StopSpeech(); director.Skip(); keys.Clear(); mouseJump = false; }
{ sceneAudio?.StopSpeech(); SkipObservedDialogue("sdl-key-" + e.Scancode); keys.Clear(); mouseJump = false; }
else if (e.Scancode == 41) running = false;
if (inspecting && e.Repeat == 0 && animations?.Select(e.Scancode) == true)
{
@@ -1294,6 +1325,12 @@ internal static class Program
bool acceptsInput;
if (playerBinding != null) acceptsInput = playerBinding.Step(input);
else { simulation.Step(input); acceptsInput = true; }
observation?.RecordInput(level?.Code ?? "preview", simulation.Steps, input, acceptsInput,
director?.ControlledTag ?? (playerBinding == null ? "direct-simulation" : "script"));
observation?.RecordState(level?.Code ?? "preview", simulation.Steps, simulation.ActorRoot,
simulation.Rotation, simulation.Velocity, simulation.Grounded, simulation.MovementMode,
simulation.InputAfterPlayerUpdate, simulation.ControllerSteps, simulation.PhysicsSteps, simulation.EffectSteps);
ObserveControl("player_step");
scooterFixture?.Received(input);
grapplerFixture?.Received(input);
rocketFixture?.Received(input);
@@ -1317,7 +1354,7 @@ internal static class Program
}
mechanisms?.Step(FixedStepClock.Step);
foreach (var patrol in patrols.Values) patrol.Step(FixedStepClock.Step);
director?.Step(FixedStepClock.Step);
StepObservedDirector(FixedStepClock.Step);
objectivePanel?.Key(keys.Contains(18) && director is { Controlled: true, InventoryEnabled: true });
objectivePanel?.Step(FixedStepClock.Step, director?.ControlledTag != null, practice.Active);
var switched = director is { Controlled: false } && !simulation.Noclip
@@ -1518,8 +1555,8 @@ internal static class Program
&& simulation.Energy < 20 && Vector2.Distance(new(simulation.ActorRoot.X, simulation.ActorRoot.Z), new(controlEntry.X, controlEntry.Z)) < .001f;
CutsceneIdleSmoke.LandWhileLocked(playerBinding!, director!, simulation!);
sceneAudio?.StopSpeech();
director!.Skip();
CutsceneIdleSmoke.VerifyReturn(playerBinding!, director, simulation!);
SkipObservedDialogue("control-phase-fixture");
CutsceneIdleSmoke.VerifyReturn(playerBinding!, director!, simulation!);
controlControllers = simulation!.ControllerSteps;
}
if (controlPhaseSmoke && count == 30)
@@ -1866,6 +1903,7 @@ internal static class Program
continuation = new(nextArgs.ToArray(), (debugCheckpointToLoad ?? interactions!.Snapshot()) with {
StartPoint = transitionRequest.StartPoint, StoredVector = debugCheckpointToLoad?.StoredVector ?? returnRoot }, transitionRequest.Returning,
debugCheckpointToLoad == null ? simulation?.CaptureLevelState(interactions!.Inventory.SelectedGadget) : null);
observation?.RecordTransition(level!.Code, transitionRequest.LevelFile, simulation?.Steps ?? 0, transitionRequest.Returning);
Console.WriteLine($"Loading original destination: {transitionRequest.LevelFile}, start={transitionRequest.StartPoint}; fade behavior remains unreconstructed.");
}
if (walkSmoke && !simulation!.SmokePassed) return 2;
@@ -0,0 +1,13 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType><TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>
<EnableDefaultCompileItems>false</EnableDefaultCompileItems>
</PropertyGroup>
<ItemGroup>
<Compile Include="Program.cs" />
<Compile Include="../../src/GamePort/Assets/*.cs" />
<Compile Include="../../src/GamePort/Game/*.cs" />
<None Include="expected.json" CopyToOutputDirectory="PreserveNewest" Condition="Exists('expected.json')" />
</ItemGroup>
</Project>
+219
View File
@@ -0,0 +1,219 @@
using System.Numerics;
using System.Text.Json;
using GamePort.Game;
// Original normal callback component over synthetic state/accessors. Derived
// Soldier174 and Jimmy204 are recorded endpoints, not full policy emulation.
var fixture = new Fixture();
var rows = new List<JsonElement>();
void Direct(string name,bool ceiling = false) => rows.Add(fixture.Direct(name,ceiling));
void Dynamic(string name) => rows.Add(fixture.Dynamic(name));
fixture.Reset(0); Direct("jimmy_null");
fixture.Reset(0); fixture.Selection = 3; Direct("jimmy_jetpack");
fixture.Reset(0); Direct("jimmy_ordinary_polygon");
fixture.Reset(0); fixture.Elapsed = 3; Direct("jimmy_elapsed_gate");
fixture.Reset(0); fixture.MovementMode = 1; Direct("jimmy_mode1");
fixture.Reset(0); fixture.MovementMode = 2; Direct("jimmy_mode2");
fixture.Reset(0); Direct("jimmy_uncontrolled");
fixture.Reset(0); fixture.Selection = 7; Direct("jimmy_gadget7_inactive");
fixture.Reset(0); fixture.Selection = 7; fixture.Grappling = true; Direct("jimmy_gadget7_equal");
fixture.Reset(0); fixture.Selection = 7; fixture.Grappling = true; fixture.Tether.Y = 49; Direct("jimmy_gadget7_large");
fixture.Reset(0); Direct("ceiling_positive",true);
fixture.Reset(0); fixture.Velocity.Y = -7; fixture.Acceleration.Y = -13; Direct("ceiling_negative",true);
fixture.Reset(0); fixture.Acceleration.Y = -13; Direct("ceiling_velocity_only",true);
fixture.Reset(0); fixture.Velocity.Y = -7; Direct("ceiling_acceleration_only",true);
fixture.Reset(1); fixture.Reflection = false; Direct("generic_disabled");
fixture.Reset(1); Direct("generic_axis");
fixture.Reset(1); fixture.Damping = 0; Direct("generic_no_damping");
fixture.Reset(1); fixture.Damping = 1.25f; Direct("generic_excess_damping");
fixture.Reset(1); fixture.Velocity.X = 30; Direct("generic_oblique");
fixture.Reset(1); fixture.FreshY = true; Direct("generic_fresh_y");
fixture.Reset(2); Direct("soldier_mode0");
fixture.Reset(2); fixture.ActorMode = 10; Direct("soldier_mode10");
fixture.Reset(2); fixture.ActorMode = 10; fixture.Reflection = false; Direct("soldier_mode10_disabled");
fixture.Reset(0); Dynamic("dynamic_jimmy");
fixture.Reset(1); Dynamic("dynamic_generic");
fixture.Reset(2); fixture.ActorMode = 10; Dynamic("dynamic_soldier");
fixture.Reset(2); fixture.ActorMode = 10; fixture.Mutation = 1; Dynamic("late_inhibition");
fixture.Reset(2); fixture.ActorMode = 10; fixture.Mutation = 2; fixture.Wall(); Dynamic("late_radius");
fixture.Reset(2); fixture.ActorMode = 10; fixture.Mutation = 3; fixture.Wall(true); Dynamic("late_geometry");
fixture.Reset(2); fixture.ActorMode = 10; fixture.Mutation = 4; fixture.Wall(); Dynamic("late_force");
if(args is ["--dump"])
{
Console.WriteLine(JsonSerializer.Serialize(new {cases = rows}));
return;
}
var native = args is ["--native", _];
if(args.Length != 0 && !native) throw new ArgumentException("Use --native <observations.json> or --dump");
using var expected = JsonDocument.Parse(File.ReadAllText(native ? args[1] : Path.Combine(AppContext.BaseDirectory,"expected.json")));
var cases = expected.RootElement.GetProperty("cases").EnumerateArray().ToArray();
if(cases.Length != rows.Count) throw new Exception("Case count differs");
for(var i = 0; i < rows.Count; i++) Compare(cases[i],rows[i],cases[i].GetProperty("name").GetString()!);
fixture.Reset(1); fixture.Velocity = Vector4.Zero; fixture.Reflection = false;
OriginalNormalContacts.GenericWall(fixture,Vector3.UnitZ);
fixture.Reflection = true;
try
{
OriginalNormalContacts.GenericWall(fixture,Vector3.UnitZ);
throw new Exception("Undefined original zero-horizontal path was silently admitted");
}
catch(NotSupportedException) { }
Console.WriteLine($"PASS {rows.Count} original actor-contact snapshots, live getter order and bounded derived endpoints; exact float32.");
static void Compare(JsonElement expected,JsonElement actual,string path)
{
if(expected.ValueKind != actual.ValueKind) throw new Exception($"{path}: kind differs");
if(expected.ValueKind == JsonValueKind.Object)
{
if(expected.EnumerateObject().Count() != actual.EnumerateObject().Count()) throw new Exception($"{path}: field count differs");
foreach(var p in expected.EnumerateObject()) Compare(p.Value,actual.GetProperty(p.Name),path+"."+p.Name);
}
else if(expected.ValueKind == JsonValueKind.Array)
{
if(expected.GetArrayLength() != actual.GetArrayLength()) throw new Exception($"{path}: array length differs");
for(var i = 0; i < expected.GetArrayLength(); i++) Compare(expected[i],actual[i],$"{path}[{i}]");
}
else if(expected.ValueKind == JsonValueKind.Number)
{
if(expected.GetSingle() != actual.GetSingle()) throw new Exception($"{path}: {actual} != original {expected}");
}
else if(!JsonElement.DeepEquals(expected,actual)) throw new Exception($"{path}: {actual} != original {expected}");
}
sealed class Fixture : IOriginalNormalBody
{
public Vector4 Root,Velocity,Acceleration,Angular;
public Vector2 Tether;
public int Selection,MovementMode,ActorMode,Mutation;
public bool Grappling,Reflection,FreshY,Inhibited,ForceStatic,Geometry;
public float Elapsed,Damping,Radius;
private int profile,knocks,cleanups,marker,velocityGets;
private float knockForce;
private Vector4 knockNormal;
private StaticCollisionContext context = null!;
private readonly List<string> events = [];
private readonly List<float> radii = [];
private readonly List<object> angles = [];
private CameraRayPolygon? wall;
public void Reset(int kind)
{
profile = kind; Root = new(0,0,15,1); Velocity = new(0,7,-40,0);
Acceleration = new(11,13,17,0); Angular = new(1,2,3,0);
Tether = new(36,48); Selection = -1; MovementMode = ActorMode = Mutation = 0;
Grappling = FreshY = Inhibited = ForceStatic = false; Reflection = Geometry = true;
Elapsed = 4; Damping = .25f; Radius = 10;
knocks = cleanups = marker = velocityGets = 0; knockForce = 0; knockNormal = default;
events.Clear(); radii.Clear(); angles.Clear(); wall = null;
context = new(88,77){Nearest = new(77,88,new(111,222,333))};
}
public void Wall(bool seedLast = false)
{
wall = new(new(new(-100,-100,35),new(-100,100,35),new(100,100,35)),Vector3.UnitZ);
if(seedLast) context.LastPolygon = wall;
}
public Vector4 ReadVelocity()
{
events.Add("Gv"); velocityGets++;
if(FreshY && velocityGets == 2) Velocity.Y = 99;
return Velocity;
}
public void WriteVelocity(Vector4 value) { events.Add("Sv4"); Velocity = value; }
public void WriteVelocityXYZ(Vector3 value) { events.Add("Sv3"); Velocity = new(value,Velocity.W); }
public Vector4 ReadAcceleration() { events.Add("Ga"); return Acceleration; }
public void WriteAcceleration(Vector4 value) { events.Add("Sa4"); Acceleration = value; }
public bool ReflectWalls { get { events.Add("Gate"); return Reflection; } }
public float WallDamping { get { events.Add("F"); return Damping; } }
public void AddAngularVelocity(Vector3 value) { events.Add("Aw"); Angular += new Vector4(value,0); }
private int Heading(Vector4 vector)
{
var result = OriginalHeading.Angles(new(vector.X,vector.Y,vector.Z));
var pitch = result.Pitch & 16383; var yaw = result.Yaw & 16383;
angles.Add(new {vector = Values(vector),pitch,yaw}); events.Add("Angles");
return yaw;
}
private void Knock(Vector3 normal)
{
events.Add("K174"); knocks++; knockForce = 500; knockNormal = new(normal,0);
if(Mutation == 1) Inhibited = true;
if(Mutation == 2) Radius = 20;
if(Mutation == 3) Geometry = false;
if(Mutation == 4) ForceStatic = true;
}
private void WallContact(Vector3 normal)
{
if(profile == 0)
{
// Only tested null/ordinary/elapsed-rejected Player material paths.
// Complete204 is recorded, not the actual grappler cleanup policy.
if(Selection == 7 && Grappling)
{
var length = Math.Sqrt((double)Tether.X*Tether.X+(double)Tether.Y*Tether.Y);
Tether = default;
if(length > 60) { events.Add("C204"); cleanups++; marker = 1; }
}
}
else
{
OriginalNormalContacts.GenericWall(this,normal,Heading);
if(profile == 2 && ActorMode == 10) Knock(normal);
}
}
public JsonElement Direct(string name,bool ceiling)
{
if(ceiling) OriginalNormalContacts.Ceiling(this); else WallContact(Vector3.UnitZ);
return Snapshot(name,-1);
}
private float ReadRadius() { events.Add("Radius"); radii.Add(Radius); return Radius; }
public JsonElement Dynamic(string name)
{
var previous = new Vector3(0,0,50);
var candidate = new Vector3(Root.X,Root.Y,Root.Z);
var radius = ReadRadius();
context.Nearest = context.Nearest with {FaceDistance = -1,EdgeDistance = radius};
var box = new DynamicBoxCollider(1,Vector3.Zero,new(-50,-50,-10),new(50,50,10),Matrix4x4.Identity,40);
foreach(var triangle in DynamicSceneCollision.Triangles(box))
{
var cross = Vector3.Cross(triangle.B-triangle.A,triangle.C-triangle.A);
var normal = cross/OriginalBodySupport.QuickMagnitude(cross);
var response = OriginalSphereResponse.Resolve(new(triangle.A,triangle.C,triangle.B),normal,
previous,candidate,radius,context.Nearest);
if(response.Contact == SphereContact.None) continue;
candidate = response.Position; context.Nearest = response.State;
WallContact(normal);
}
var contact = context.Nearest.FaceDistance != -1 || context.Nearest.EdgeDistance < radius;
if(contact)
{
events.Add("Inhibit");
if(!Inhibited)
{
var world = new OriginalStaticCollision(wall is {} polygon ? [polygon] : []);
var initialPasses = context.Passes;
var clipped = world.Move(previous,candidate-previous,ReadRadius(),context,edges:false,
lowerEdges:ForceStatic,geometryEnabled:Geometry);
// Fixed primitive getters: recursive source calls read the same
// radius before their sole terminal callback. No actor callback
// occurs between these bounded passes in this composition.
for(var pass = 1; pass < context.Passes-initialPasses; pass++) ReadRadius();
if(clipped.CallbackPolygon is {} last)
{
if(last.StoredNormal.Y <= -.7f) OriginalNormalContacts.Ceiling(this);
else WallContact(last.StoredNormal);
}
events.Add("Root"); Root = new(clipped.Position,1);
}
}
return Snapshot(name,contact ? 1 : 0);
}
private JsonElement Snapshot(string name,int contact) => JsonSerializer.SerializeToElement(new {
name,contact,root = Values(Root),velocity = Values(Velocity),acceleration = Values(Acceleration),
angular = Values(Angular),movementMode = MovementMode,actorMode = ActorMode,marker,
tether = new[]{Tether.X,Tether.Y},knocks,force = knockForce,knockNormal = Values(knockNormal),cleanups,
radius = Radius,forceStatic = ForceStatic ? 1 : 0,geometry = Geometry ? 1 : 0,inhibited = Inhibited ? 1 : 0,
radii,angles,passes = context.Passes,visits = context.NodeVisits,face = context.Nearest.FaceDistance,
edge = context.Nearest.EdgeDistance,events = string.Join(',',events)
});
private static float[] Values(Vector4 v) => [v.X,v.Y,v.Z,v.W];
}
@@ -0,0 +1,34 @@
{
"cases": [
{"name":"jimmy_null","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_jetpack","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_ordinary_polygon","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_elapsed_gate","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_mode1","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":1,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_mode2","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":2,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_uncontrolled","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_gadget7_inactive","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_gadget7_equal","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[0,0],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":""},
{"name":"jimmy_gadget7_large","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":1,"tether":[0,0],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":1,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":"C204"},
{"name":"ceiling_positive","contact":-1,"root":[0,0,15,1],"velocity":[0,0,-40,0],"acceleration":[11,0,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gv,Sv4,Ga,Sa4"},
{"name":"ceiling_negative","contact":-1,"root":[0,0,15,1],"velocity":[0,-7,-40,0],"acceleration":[11,-13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gv,Ga"},
{"name":"ceiling_velocity_only","contact":-1,"root":[0,0,15,1],"velocity":[0,0,-40,0],"acceleration":[11,-13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gv,Sv4,Ga"},
{"name":"ceiling_acceleration_only","contact":-1,"root":[0,0,15,1],"velocity":[0,-7,-40,0],"acceleration":[11,0,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gv,Ga,Sa4"},
{"name":"generic_disabled","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate"},
{"name":"generic_axis","contact":-1,"root":[0,0,15,1],"velocity":[0,7,30,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw"},
{"name":"generic_no_damping","contact":-1,"root":[0,0,15,1],"velocity":[0,7,40,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw"},
{"name":"generic_excess_damping","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-10,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw"},
{"name":"generic_oblique","contact":-1,"root":[0,0,15,1],"velocity":[22.5000019,7,30,0],"acceleration":[11,13,17,0],"angular":[1,-3.31300402,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[{"vector":[0.599998295,0,-0.799997687,0],"pitch":0,"yaw":9870},{"vector":[0.599998295,0,0.799997687,0],"pitch":0,"yaw":14706}],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw"},
{"name":"generic_fresh_y","contact":-1,"root":[0,0,15,1],"velocity":[0,99,30,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw"},
{"name":"soldier_mode0","contact":-1,"root":[0,0,15,1],"velocity":[0,7,30,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw"},
{"name":"soldier_mode10","contact":-1,"root":[0,0,15,1],"velocity":[0,7,30,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":10,"marker":0,"tether":[36,48],"knocks":1,"force":500,"knockNormal":[0,0,1,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174"},
{"name":"soldier_mode10_disabled","contact":-1,"root":[0,0,15,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":10,"marker":0,"tether":[36,48],"knocks":1,"force":500,"knockNormal":[0,0,1,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[],"angles":[],"passes":0,"visits":0,"face":77,"edge":88,"events":"Gate,K174"},
{"name":"dynamic_jimmy","contact":1,"root":[0,0,20,1],"velocity":[0,7,-40,0],"acceleration":[11,13,17,0],"angular":[1,2,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[10,10],"angles":[],"passes":1,"visits":0,"face":40,"edge":10,"events":"Radius,Inhibit,Radius,Root"},
{"name":"dynamic_generic","contact":1,"root":[0,0,20,1],"velocity":[0,7,30,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":0,"marker":0,"tether":[36,48],"knocks":0,"force":0,"knockNormal":[0,0,0,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[10,10],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":1,"visits":0,"face":40,"edge":10,"events":"Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,Inhibit,Radius,Root"},
{"name":"dynamic_soldier","contact":1,"root":[0,0,20,1],"velocity":[0,7,30,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":10,"marker":0,"tether":[36,48],"knocks":1,"force":500,"knockNormal":[0,0,1,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[10,10],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":1,"visits":0,"face":40,"edge":10,"events":"Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Inhibit,Radius,Root"},
{"name":"late_inhibition","contact":1,"root":[0,0,15,1],"velocity":[0,7,30,0],"acceleration":[11,13,17,0],"angular":[1,9.20000076,3,0],"movementMode":0,"actorMode":10,"marker":0,"tether":[36,48],"knocks":1,"force":500,"knockNormal":[0,0,1,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":1,"inhibited":1,"radii":[10],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0}],"passes":0,"visits":0,"face":40,"edge":10,"events":"Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Inhibit"},
{"name":"late_radius","contact":1,"root":[0,0,55,1],"velocity":[0,7,-22.5,0],"acceleration":[11,13,17,0],"angular":[1,3.80000067,3,0],"movementMode":0,"actorMode":10,"marker":0,"tether":[36,48],"knocks":2,"force":500,"knockNormal":[0,0,1,0],"cleanups":0,"radius":20,"forceStatic":0,"geometry":1,"inhibited":0,"radii":[10,20,20],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0},{"vector":[0,0,1,0],"pitch":0,"yaw":0},{"vector":[0,0,-1,0],"pitch":0,"yaw":8192}],"passes":2,"visits":4,"face":15,"edge":10,"events":"Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Inhibit,Radius,Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Root"},
{"name":"late_geometry","contact":1,"root":[0,0,20,1],"velocity":[0,7,-22.5,0],"acceleration":[11,13,17,0],"angular":[1,3.80000067,3,0],"movementMode":0,"actorMode":10,"marker":0,"tether":[36,48],"knocks":2,"force":500,"knockNormal":[0,0,1,0],"cleanups":0,"radius":10,"forceStatic":0,"geometry":0,"inhibited":0,"radii":[10,10],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0},{"vector":[0,0,1,0],"pitch":0,"yaw":0},{"vector":[0,0,-1,0],"pitch":0,"yaw":8192}],"passes":1,"visits":2,"face":40,"edge":10,"events":"Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Inhibit,Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Root"},
{"name":"late_force","contact":1,"root":[0,0,45,1],"velocity":[0,7,-22.5,0],"acceleration":[11,13,17,0],"angular":[1,3.80000067,3,0],"movementMode":0,"actorMode":10,"marker":0,"tether":[36,48],"knocks":2,"force":500,"knockNormal":[0,0,1,0],"cleanups":0,"radius":10,"forceStatic":1,"geometry":1,"inhibited":0,"radii":[10,10,10],"angles":[{"vector":[0,0,-1,0],"pitch":0,"yaw":8192},{"vector":[0,0,1,0],"pitch":0,"yaw":0},{"vector":[0,0,1,0],"pitch":0,"yaw":0},{"vector":[0,0,-1,0],"pitch":0,"yaw":8192}],"passes":2,"visits":4,"face":15,"edge":10,"events":"Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Inhibit,Radius,Radius,Gate,Gv,Gv,F,Sv3,Angles,Angles,Aw,K174,Root"}
]
}
@@ -0,0 +1,10 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup><OutputType>Exe</OutputType><TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>
<EnableDefaultCompileItems>false</EnableDefaultCompileItems></PropertyGroup>
<ItemGroup>
<Compile Include="Program.cs" />
<Compile Include="../../src/GamePort/Assets/*.cs" />
<Compile Include="../../src/GamePort/Game/*.cs" />
</ItemGroup>
</Project>
@@ -0,0 +1,144 @@
using System.Numerics;
using System.Text.Json;
using GamePort.Game;
//Test composition of recovered47A5E0 ownership over existing source kernels.
//Not wired into gameplay: actors/getters/transform are fixtures; point roots W1,
//empty static grid and non-reentrant normal callbacks bound this comparison.
var fixture=new Fixture(args is ["--construction-winding"]);var rows=new List<Observation>();
void Query(string name)=>rows.Add(fixture.Query(name));
fixture.Reset();Query("face_stale_polygon");
fixture.Reset();fixture.Context.LastPolygon=null;Query("face_no_polygon");
fixture.Reset();fixture.Inhibit=true;Query("inhibited");
fixture.Reset();fixture.Geometry=false;Query("geometry_off");
fixture.Reset();fixture.Root.Z=200;Query("broadphase_reject");
fixture.Reset();fixture.Mode=2;Query("other_box_overlap");
fixture.Reset();fixture.Mode=2;fixture.Root.Z=51;Query("other_box_reject");
fixture.Reset();fixture.Previous.Z=100;fixture.Root.Z=80;Query("no_triangle_hit");
fixture.Reset();fixture.Mutate=true;Query("callback_root_overwritten");
fixture.Reset();fixture.Mutate=fixture.Inhibit=true;Query("inhibited_callback_root_survives");
fixture.Reset();fixture.StaticGeometry=false;Query("static_geometry_off_stale_polygon");
fixture.Reset();fixture.ForceStatic=true;Query("forced_static_mode");
fixture.Reset();fixture.Root.Y=fixture.Previous.Y=45;Query("near_top_edge");
fixture.Reset();fixture.BoxRoot.X=fixture.Root.X=fixture.Previous.X=100;Query("translated_box");
fixture.Reset();fixture.Rotate=true;fixture.Root=new(15,0,0,1);fixture.Previous=new(50,0,0);Query("rotated_box");
fixture.Reset();Query("chain_first");fixture.Previous=new(fixture.Root.X,fixture.Root.Y,fixture.Root.Z);fixture.Root.Z=25;Query("chain_away");
//Fixed finite original observations; no generated trace is needed for normal tests.
string[] references=[
"1|0,0,20,1|40|10|0,0,10,1|1|1|1|1|1|0",
"1|0,0,20,1|40|10|0,0,10,1|0|1|0|1|1|0",
"1|0,0,15,1|40|10|0,0,10,1|1|1|0|0|0|0",
"0|0,0,15,1|77|88|111,222,333,1|1|0|0|0|0|0",
"0|0,0,200,1|77|88|111,222,333,1|1|0|0|0|0|0",
"1|0,0,15,1|77|88|111,222,333,1|1|0|0|0|0|0",
"0|0,0,51,1|77|88|111,222,333,1|1|0|0|0|0|0",
"0|0,0,80,1|-1|10|111,222,333,1|1|0|0|0|0|0",
"1|0,0,20,1|40|10|0,0,10,1|1|1|1|1|1|0",
"1|777,888,999,2|40|10|0,0,10,1|1|1|0|0|0|0",
"1|0,0,20,1|40|10|0,0,10,1|1|1|1|1|1|0",
"1|0,0,20,1|40|10|0,0,10,1|1|1|1|1|1|0",
"1|0,45,20,1|40|10|0,45,10,1|1|1|1|1|1|0",
"1|100,0,20,1|40|10|100,0,10,1|1|1|1|1|1|0",
"1|20,0,0,1|40|10|10,0,0,1|1|1|1|1|1|0",
"1|0,0,20,1|40|10|0,0,10,1|1|1|1|1|1|0",
"0|0,0,25,1|-1|10|0,0,10,1|1|1|1|1|1|0"
];
for(var i=0;i<rows.Count;i++)
if(rows[i].Reference()!=references[i])throw new Exception($"{rows[i].Name}: {rows[i].Reference()} != {references[i]}");
if(args.Length==2&&args[0]=="--native")
{
using var data=JsonDocument.Parse(File.ReadAllText(args[1]));
var cases=data.RootElement.GetProperty("cases").EnumerateArray().ToArray();
if(cases.Length!=rows.Count)throw new Exception("Original case count");
for(var i=0;i<rows.Count;i++)
{
var actual=JsonSerializer.SerializeToElement(rows[i],new JsonSerializerOptions{PropertyNamingPolicy=JsonNamingPolicy.CamelCase});
foreach(var property in cases[i].EnumerateObject())
if(!actual.TryGetProperty(property.Name,out var value)||!JsonElement.DeepEquals(value,property.Value))
throw new Exception($"{rows[i].Name}: original {property.Name} differs");
}
var arguments=JsonSerializer.SerializeToElement(fixture.KernelArguments);
if(!JsonElement.DeepEquals(arguments,data.RootElement.GetProperty("kernel_triangles")))
throw new Exception("Original12 kernel triangles/normals differ");
Console.WriteLine("Matched17 complete original dynamic/context observations and12 kernel triangle/normal arguments.");
}
else if(args.Length!=0)throw new ArgumentException("Use --native <observations.json>");
Console.WriteLine("PASS17 dynamic context/reclip compositions; live collision admission unchanged.");
sealed record Observation(string Name,int Contact,float[] Root,float Face,float Edge,float[] Hit,
int Last,int DynamicCallbacks,int StaticCallbacks,int Setters,int Passes,int Mode)
{
public string Reference()=>string.Join('|',Contact,string.Join(',',Root),Face,Edge,string.Join(',',Hit),
Last,DynamicCallbacks,StaticCallbacks,Setters,Passes,Mode);
}
sealed class Fixture(bool constructionWinding=false)
{
public Vector4 Root;
public Vector3 Previous,BoxRoot;
public bool Inhibit,Geometry,StaticGeometry,ForceStatic,Rotate,Mutate;
public int Mode;
public StaticCollisionContext Context=null!;
private readonly OriginalStaticCollision world=new([]);
private readonly CameraRayPolygon stale=new(new(new(-100,-100,0),new(-100,100,0),new(100,100,0)),Vector3.UnitZ);
private int dynamicCallbacks,staticCallbacks,setters;
public List<float[][]> KernelArguments {get;}=[];
public void Reset()
{
Root=new(0,0,15,1);Previous=new(0,0,50);BoxRoot=default;
Inhibit=ForceStatic=Rotate=Mutate=false;Geometry=StaticGeometry=true;Mode=0;
Context=new(88,77){Nearest=new(77,88,new(111,222,333)),LastPolygon=stale};
dynamicCallbacks=staticCallbacks=setters=0;
}
private void Notify(CameraRayPolygon? polygon)
{
if(polygon is null)dynamicCallbacks++;else staticCallbacks++;
if(Mutate)Root=new(777,888,999,2);
}
public Observation Query(string name)
{
var current=new Vector3(Root.X,Root.Y,Root.Z);
var transform=Rotate?new Matrix4x4(0,0,-1,0,0,1,0,0,1,0,0,0,BoxRoot.X,BoxRoot.Y,BoxRoot.Z,1)
:Matrix4x4.CreateTranslation(BoxRoot);
var box=new DynamicBoxCollider(1,BoxRoot,new(-50,-50,-10),new(50,50,10),transform,40);
var sphere=new DynamicSphereMotion(Previous,current,10,GeometryCollisionEnabled:Geometry,Mode:Mode);
bool contact=false;
if(DynamicSceneCollision.BroadPhase(box,sphere))
{
if(Mode==2)contact=true;
else
{
Context.Nearest=Context.Nearest with{FaceDistance=-1,EdgeDistance=10};
var candidate=current;
foreach(var triangle in DynamicSceneCollision.Triangles(box))
{
var cross=Vector3.Cross(triangle.B-triangle.A,triangle.C-triangle.A);
var normal=cross/OriginalBodySupport.QuickMagnitude(cross);
//47A5E0's vector argument pushes reverse the constructed
//triangle winding at the kernel boundary; normal is retained.
var kernelTriangle=constructionWinding?triangle:new SupportTriangle(triangle.A,triangle.C,triangle.B);
if(name=="face_stale_polygon")KernelArguments.Add([
[kernelTriangle.A.X,kernelTriangle.A.Y,kernelTriangle.A.Z,1],
[kernelTriangle.B.X,kernelTriangle.B.Y,kernelTriangle.B.Z,1],
[kernelTriangle.C.X,kernelTriangle.C.Y,kernelTriangle.C.Z,1],
[normal.X,normal.Y,normal.Z,0]]);
var hit=OriginalSphereResponse.Resolve(kernelTriangle,normal,Previous,candidate,10,Context.Nearest);
if(hit.Contact==SphereContact.None)continue;
candidate=hit.Position;Context.Nearest=hit.State;Notify(null);
}
contact=Context.Nearest.FaceDistance!=-1||Context.Nearest.EdgeDistance<10;
if(contact&&!Inhibit)
{
var clipped=world.Move(Previous,candidate-Previous,10,Context,edges:false,
lowerEdges:ForceStatic,geometryEnabled:StaticGeometry);
if(clipped.CallbackPolygon is{} polygon)Notify(polygon);
Root=new(clipped.Position,1);setters++;
}
}
}
var p=Context.Nearest.Hit??throw new Exception("Seeded hit lost");
return new(name,contact?1:0,[Root.X,Root.Y,Root.Z,Root.W],Context.Nearest.FaceDistance,
Context.Nearest.EdgeDistance,[p.X,p.Y,p.Z,1],Context.LastPolygon==stale?1:0,
dynamicCallbacks,staticCallbacks,setters,Context.Passes,0);
}
}
@@ -0,0 +1,13 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType><TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable>
<EnableDefaultCompileItems>false</EnableDefaultCompileItems>
</PropertyGroup>
<ItemGroup>
<Compile Include="Program.cs" />
<Compile Include="../../src/GamePort/Assets/*.cs" />
<Compile Include="../../src/GamePort/Game/*.cs" />
<None Include="expected.json" CopyToOutputDirectory="PreserveNewest" />
</ItemGroup>
</Project>
@@ -0,0 +1,153 @@
using System.Numerics;
using System.Text.Json;
using GamePort.Game;
// Synthetic actor composition, not live scene admission. All roots are points;
// callbacks mutate roots only, primitive flags remain constant during each query.
var fixture = new Fixture();
var actual = new List<JsonElement>();
void Query(string name) => actual.Add(fixture.Query(name));
fixture.Reset(); fixture.Wall(0,35); Query("nearer_wall");
fixture.Reset(); fixture.Wall(0,10); Query("equal_dynamic_face");
fixture.Reset(); fixture.Wall(0,0); Query("far_wall");
fixture.Reset(); fixture.Wall(0,35); fixture.Wall(1,30); Query("two_near_first");
fixture.Reset(); fixture.Wall(0,30); fixture.Wall(1,35); Query("two_far_first");
fixture.Reset(); fixture.Wall(0,35); fixture.Mutate = true; Query("nearer_callback_root");
fixture.Reset(); fixture.Wall(0,35); fixture.Inhibit = true; Query("inhibit_static_visit");
fixture.Reset(); fixture.Wall(0,35); fixture.Geometry = false; Query("geometry_off_visits");
fixture.Reset(); fixture.Wall(0,35); fixture.Force = true; Query("forced_primitive_mode");
fixture.Reset(); fixture.Wall(0,0); fixture.CeilingSeed = true; Query("stale_ceiling_callback");
fixture.Reset(); fixture.Wall(0,0); fixture.Root.Y = 30;
fixture.Ceiling(35,true); Query("ceiling_response");
fixture.Reset(); fixture.Wall(0,35); fixture.Previous.Y = -30;
fixture.Ceiling(); Query("wall_and_ceiling");
fixture.Reset(); fixture.Wall(0,35); Query("retained_first");
fixture.Previous = new(0,0,50); fixture.Root = new(0,0,15,1); Query("retained_second");
if(args is ["--dump"])
{
Console.WriteLine(JsonSerializer.Serialize(new {cases = actual,diagnostic_steps = fixture.DiagnosticSteps}));
return;
}
var native = args is ["--native", _];
if(args.Length != 0 && !native) throw new ArgumentException("Use --native <observations.json>");
using var expected = JsonDocument.Parse(File.ReadAllText(native ? args[1]
: Path.Combine(AppContext.BaseDirectory,"expected.json")));
var cases = expected.RootElement.GetProperty("cases").EnumerateArray().ToArray();
if(cases.Length != actual.Count) throw new Exception("Case count differs");
for(var i = 0; i < actual.Count; i++) Compare(cases[i],actual[i],cases[i].GetProperty("name").GetString()!);
Compare(expected.RootElement.GetProperty("diagnostic_steps"),
JsonSerializer.SerializeToElement(fixture.DiagnosticSteps),"diagnostic_steps");
Console.WriteLine($"PASS {actual.Count} populated-grid dynamic/static comparisons and 12 kernel steps; exact float32, callback order and primitive mode.");
static void Compare(JsonElement expected,JsonElement actual,string path)
{
if(expected.ValueKind != actual.ValueKind) throw new Exception($"{path}: value kind differs");
if(expected.ValueKind == JsonValueKind.Object)
{
if(expected.EnumerateObject().Count() != actual.EnumerateObject().Count()) throw new Exception($"{path}: fields differ");
foreach(var p in expected.EnumerateObject()) Compare(p.Value,actual.GetProperty(p.Name),path+"."+p.Name);
}
else if(expected.ValueKind == JsonValueKind.Array)
{
if(expected.GetArrayLength() != actual.GetArrayLength()) throw new Exception($"{path}: array length differs");
for(var i = 0; i < expected.GetArrayLength(); i++) Compare(expected[i],actual[i],$"{path}[{i}]");
}
// Native %.9g and managed shortest-roundtrip text can spell the same float
// differently. Compare exact parsed Single values, without an epsilon.
else if(expected.ValueKind == JsonValueKind.Number)
{
if(expected.GetSingle() != actual.GetSingle()) throw new Exception($"{path}: {actual} != original {expected}");
}
else if(!JsonElement.DeepEquals(expected,actual)) throw new Exception($"{path}: {actual} != original {expected}");
}
sealed class Fixture
{
public Vector3 Previous;
public Vector4 Root;
public bool Mutate,Inhibit,Geometry,Force,CeilingSeed;
private StaticCollisionContext context = null!;
private readonly List<CameraRayPolygon> polygons = [];
private readonly List<string> events = [];
private int dynamicCallbacks,staticCallbacks,setters,kernelCalls;
private CameraRayPolygon seed;
public List<JsonElement> DiagnosticSteps { get; } = [];
public void Reset()
{
Previous = new(0,0,50); Root = new(0,0,15,1);
Mutate = Inhibit = Force = CeilingSeed = false; Geometry = true;
context = new(88,77){Nearest = new(77,88,new(111,222,333))};
seed = new(new(new(-100,-100,0),new(-100,100,0),new(100,100,0),99,0),Vector3.UnitZ);
context.LastPolygon = seed;
polygons.Clear(); events.Clear();
dynamicCallbacks = staticCallbacks = setters = kernelCalls = 0;
}
public void Wall(int id,float z) => polygons.Add(new(new(new(-100,-100,z),new(-100,100,z),
new(100,100,z),0,id),Vector3.UnitZ));
public void Ceiling(float y = 5,bool positiveZ = false) => polygons.Add(new(new(new(-100,y,-100),
positiveZ ? new(-100,y,100) : new(100,y,100),
positiveZ ? new(100,y,100) : new(100,y,-100),0,1),-Vector3.UnitY));
private int PolygonId(CameraRayPolygon? p) => p is null ? -1 : p == seed ? 99 : p.Value.Triangle.PolygonId;
private void Notify(Vector3 normal,CameraRayPolygon? polygon,int slot)
{
events.Add($"{slot:x}:{PolygonId(polygon)}:0");
if(polygon is null) dynamicCallbacks++; else staticCallbacks++;
if(Mutate) Root = new(777,888,999,2);
}
public JsonElement Query(string name)
{
if(CeilingSeed)
{
seed = seed with { StoredNormal = -Vector3.UnitY };
context.LastPolygon = seed;
}
var current = new Vector3(Root.X,Root.Y,Root.Z);
var candidate = current;
context.Nearest = context.Nearest with {FaceDistance = -1,EdgeDistance = 10};
var box = new DynamicBoxCollider(1,Vector3.Zero,new(-50,-50,-10),new(50,50,10),Matrix4x4.Identity,40);
foreach(var triangle in DynamicSceneCollision.Triangles(box))
{
var cross = Vector3.Cross(triangle.B-triangle.A,triangle.C-triangle.A);
var normal = cross/OriginalBodySupport.QuickMagnitude(cross);
kernelCalls++;
var input = candidate;
var hit = OriginalSphereResponse.Resolve(new(triangle.A,triangle.C,triangle.B),normal,
Previous,candidate,10,context.Nearest);
if(name == "wall_and_ceiling")
{
var h = hit.State.Hit!.Value;
DiagnosticSteps.Add(JsonSerializer.SerializeToElement(new {
index = DiagnosticSteps.Count,input = new[]{input.X,input.Y,input.Z,1},
output = new[]{hit.Position.X,hit.Position.Y,hit.Position.Z,1},
contact = hit.Contact == SphereContact.None ? 0 : 1,face = hit.State.FaceDistance,
edge = hit.State.EdgeDistance,hit = new[]{h.X,h.Y,h.Z,1}
}));
}
if(hit.Contact == SphereContact.None) continue;
candidate = hit.Position; context.Nearest = hit.State;
Notify(normal,null,0x374);
}
var contact = context.Nearest.FaceDistance != -1 || context.Nearest.EdgeDistance < 10;
if(contact && !Inhibit)
{
var world = new OriginalStaticCollision(polygons);
var clipped = world.Move(Previous,candidate-Previous,10,context,edges:false,
lowerEdges:Force,geometryEnabled:Geometry);
if(clipped.CallbackPolygon is {} polygon)
Notify(polygon.StoredNormal,polygon,polygon.StoredNormal.Y > -.7f ? 0x374 : 0x370);
events.Add("314:-1:0"); Root = new(clipped.Position,1); setters++;
}
var p = context.Nearest.Hit!.Value;
return JsonSerializer.SerializeToElement(new {
name,contact = contact ? 1 : 0,root = new[]{Root.X,Root.Y,Root.Z,Root.W},
face = context.Nearest.FaceDistance,edge = context.Nearest.EdgeDistance,
hit = new[]{p.X,p.Y,p.Z,1},last = PolygonId(context.LastPolygon),
dynamicCallbacks,staticCallbacks,setters,passes = context.Passes,
visits = context.NodeVisits,mode = 0,
kernelZero = kernelCalls+(Force ? 0 : context.TriangleTests),
kernelLower = Force ? context.TriangleTests : 0,events = string.Join(',',events)
});
}
}
Loaded 100 of 144 files, more files were not shown because too many files have changed in this diff. Show more