Compare commits
95
Commits
7818cc8d64
..
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
404b4b4d4a | ||
|
|
2fe8b40ea5 | ||
|
|
23ee1c2e47 | ||
|
|
07793af9fc | ||
|
|
898aef7ffa | ||
|
|
f7e7033514 | ||
|
|
febb4a9d98 | ||
|
|
08150c0199 | ||
|
|
71366e7d45 | ||
|
|
02d182f35d | ||
|
|
48fca0df52 | ||
|
|
a821754b67 | ||
|
|
2608517c37 | ||
|
|
548c97aa58 | ||
|
|
6e5ee0bd25 | ||
|
|
bda35e5bf5 | ||
|
|
5569bc2b8b | ||
|
|
5915128570 | ||
|
|
215d01e43e | ||
|
|
52a3e2d5ff | ||
|
|
472500bf4e | ||
|
|
b732256751 | ||
|
|
fc5e936fd7 | ||
|
|
026def9c5a | ||
|
|
d78b13566d | ||
|
|
d18f551a26 | ||
|
|
ef021e79f0 | ||
|
|
589481218d | ||
|
|
c60248dbfe | ||
|
|
0172916ffd | ||
|
|
e17cfbebe3 | ||
|
|
16f5e126be | ||
|
|
9c59f60b50 | ||
|
|
31ae6a6ab2 | ||
|
|
1af5217e47 | ||
|
|
2d48ee5316 | ||
|
|
aa4b862a12 | ||
|
|
857466568d | ||
|
|
c9b9f2eba9 | ||
|
|
73954e675d | ||
|
|
818191c90c | ||
|
|
61123394e0 | ||
|
|
446930d2a3 | ||
|
|
de68796df1 | ||
|
|
4bf072d03c | ||
|
|
85e533b629 | ||
|
|
ea4dc9b5df | ||
|
|
6bccd47b9b | ||
|
|
72523eebb7 | ||
|
|
773c228a30 | ||
|
|
e815534895 | ||
|
|
f55ba8eae7 | ||
|
|
564b19ad03 | ||
|
|
4d07d60e2f | ||
|
|
fafbd05811 | ||
|
|
c21ed7d7a2 | ||
|
|
e6713ead48 | ||
|
|
ded848f78e | ||
|
|
be18d77ca4 | ||
|
|
a789bfa942 | ||
|
|
91da92f17d | ||
|
|
75d7ca4279 | ||
|
|
49f874e64c | ||
|
|
488c904807 | ||
|
|
6be8484802 | ||
|
|
f9f7a7277a | ||
|
|
ac958e1962 | ||
|
|
32a72654e8 | ||
|
|
cc4a5a3e92 | ||
|
|
cd7783ba3a | ||
|
|
597caa0b49 | ||
|
|
96c5f2c00f | ||
|
|
cf64b8ce18 | ||
|
|
36f24e4474 | ||
|
|
29f8cb1714 | ||
|
|
661e7c3299 | ||
|
|
9aa49970e4 | ||
|
|
ac60452db6 | ||
|
|
a8dc07f9fc | ||
|
|
dd7688bce9 | ||
|
|
7d56538d9f | ||
|
|
f2f3a805cd | ||
|
|
bdca29d3aa | ||
|
|
bf876e9c3c | ||
|
|
135ff3642a | ||
|
|
346d350176 | ||
|
|
3794439d4e | ||
|
|
924ad2f67b | ||
|
|
27d91ad697 | ||
|
|
ea04210f52 | ||
|
|
4cd62d3627 | ||
|
|
c642b69849 | ||
|
|
68154dffce | ||
|
|
a2e89c625a | ||
|
|
dae13ace73 |
No files matched your search
@@ -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"
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -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"
|
||||
}
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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
|
||||
@@ -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
|
||||
}
|
||||
]
|
||||
````
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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*
|
||||
@@ -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"
|
||||
}
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.*
|
||||
@@ -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"
|
||||
}
|
||||
@@ -38,10 +38,61 @@ other agents' active changes. Keep updates concise, save detailed evidence to di
|
||||
Use bounded endian-aware parsers, portable paths, clear C#, deterministic tests,
|
||||
and explicit unmanaged ownership. Build frequently. Update `docs/progress.md`,
|
||||
`docs/tasks.md`, `docs/decisions.md`, and compatibility evidence before transitions.
|
||||
Current priority (2026-11-05): user pauses gadget expansion and returns to Jimmy
|
||||
movement stabilization. Preserve current movement as baseline; do not substitute
|
||||
Current direction: preserve exact original movement; keep gameplay expansion
|
||||
paused. The menu/background→successful TSK-load lifetime now establishes retained
|
||||
Jimmy-before-level-input order on first story entry. Correct that initialization
|
||||
classification, preserving fresh direct-scene order and all movement/rotation
|
||||
algorithms. See docs/gameplay/main-menu-player-lifetime.md. The strengthened
|
||||
Vulkan Carl fixture reproduces the old first-neutral-tick bank and passes after
|
||||
the correction; broader/native Windows comparison remains separate.
|
||||
The broader priority remains Jimmy movement stabilization, with gadgets paused. Preserve current movement as baseline; do not substitute
|
||||
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
|
||||
acknowledgement, with black frames/timing perturbation recorded. Source lifetime,
|
||||
not those frames, proves the TSK ordering correction. Preserve normal landing
|
||||
bank; never substitute a leveling reset. Historical runtime/package baseline is
|
||||
a2e89c6/dae13ac. Read the current progress/compatibility results before packaging.
|
||||
The prior collision work is resumed where needed for movement; preserve the
|
||||
35a2a66/0272f7b checkpoints and their source gates before broader body admission.
|
||||
Controller checkpoint integrates108 native ground/air/facing/jump comparisons;
|
||||
|
||||
@@ -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.
|
||||
@@ -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:
|
||||
|
||||
@@ -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.
|
||||
@@ -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|
|
||||
|
||||
@@ -15,9 +15,11 @@ the following body pass. Neither control loss nor restoration invents a key flus
|
||||
PlayerSceneBinding connects raw-owner preparation events to speed/velocity and
|
||||
supported gadget cleanup, and publishes the simulated root while uncontrolled.
|
||||
Authored AI transforms update the body too, preventing a later physics publish
|
||||
from overwriting the script's teleport. Destination yaw is preserved. Pitch/roll
|
||||
remain director-owned; Jimmy's render/controller still uses the existing yaw
|
||||
adapter. Initial MCA preparation occurs once, with its first-name guard; later
|
||||
from overwriting the script's teleport. Authored current writes preserve the
|
||||
facing destination. The later full-Euler bridge publishes all axes; CAM/MCA
|
||||
preparation now replaces destinationXYZ with the upright current heading too.
|
||||
See [rotation feedback](../gameplay/jimmy-rotation-handoff.md).
|
||||
Initial MCA preparation occurs once, with its first-name guard; later
|
||||
shots do not repeat it. AI and CAM use their own callback order. STOP notification
|
||||
follows physical preparation. DEFAULT grants control without preparation.
|
||||
|
||||
|
||||
@@ -1,5 +1,60 @@
|
||||
# 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
|
||||
order remains. This replaces the named assumption that initial story equals fresh
|
||||
registry insertion. First-neutral-tick/300-idle native Vulkan and eight managed
|
||||
Carl trajectories pass; full-suite/platform results are tracked in progress.md.
|
||||
50 more native derived-caller cases and body/transform ownership are documented.
|
||||
Original startup diagnostics now reach background allocation after a recorded
|
||||
repaint intervention, with black frames; no full-original visual/runtime parity
|
||||
or native Windows execution is claimed.
|
||||
|
||||
2026-11-06: [Carl lifecycle trace](../gameplay/jimmy-cutscene-lifecycle.md) adds
|
||||
292 bounded original-code cases and closes local contact/task/animation/STOP and
|
||||
DEFAULT-provider questions. Actual first-resumed-frame state remains unobserved.
|
||||
The new original-state observer passes Wine32 attach/read/leave-running; local
|
||||
original captures show MAIN only and remain visually unusable. This expands S/P
|
||||
and investigation-tool coverage, not original gameplay comparison or a new port fix.
|
||||
MOVE/CONTROL/INPUT's Carl gate and full-body/OMT dependencies stay open.
|
||||
|
||||
2026-11-05 follow-up: camera-entry reset is verified, but post-skip neutral idle
|
||||
remains a port bug. CONTROL/INPUT/skip coverage is reopened around Carl's full
|
||||
lifecycle;48 port traces and additional original boundaries are documented in
|
||||
[the focused decompilation checkpoint](../gameplay/jimmy-cutscene-decompilation.md).
|
||||
No further gameplay change is made before its source-ownership gate is closed.
|
||||
|
||||
2026-11-05 handoff correction: CAM/MCA destination state at game+274 is now reset
|
||||
along with current Euler (20 original-component cases; managed/native Linux
|
||||
handoff checks). Neutral ground input separately retains residual bank in seven
|
||||
original trajectories; whole-frame landing comparison remains open. See
|
||||
[rotation handoffs](../gameplay/jimmy-rotation-handoff.md).
|
||||
|
||||
Checkpoint scope: lab → tutorial VR04 → lab → outside, including intro,
|
||||
explanation, pickup/practice, RETURN, Carl conversation and exit. This compares
|
||||
source contracts with the current port and preserved playable baseline69d0187,
|
||||
@@ -30,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. |
|
||||
|
||||
@@ -9,8 +9,8 @@ corrected its sign-extended byte−1 comparison anchor and added tests/report.
|
||||
|
||||
| Boundary | Proven order and source sites |
|
||||
|---|---|
|
||||
|CAM with PlayerControlled=NULL|Guard prior raw owner416635;43841665D→41041666B→flatten logical/cached Euler(0,yaw,0)41667E..4166E5→game118(NULL)4166F4. Target lookup occurs later416754. Preparation can precede a missing target/sound failure.|
|
||||
|Initial MCA activation|First target name `none` guard431300 exits before preparation. A non-none name reaches initial target/animation prelude; missing lookup can continue. Prior owner guard431502;410431512→flatten Euler431525..431578→438431598→game118(NULL)4315A7. Per-shot helper invoked431600.|
|
||||
|CAM with PlayerControlled=NULL|Guard prior raw owner416635;43841665D→41041666B→flatten current/destination Euler(0,currentYaw,0)41667E..4166E5→game118(NULL)4166F4. Target lookup occurs later416754. Preparation can precede a missing target/sound failure.|
|
||||
|Initial MCA activation|First target name `none` guard431300 exits before preparation. A non-none name reaches initial target/animation prelude; missing lookup can continue. Prior owner guard431502;410431512→flatten current/destination Euler431525..43158D→438431598→game118(NULL)4315A7. Per-shot helper invoked431600.|
|
||||
|Later MCA shot|CompleteE0→431750; target/sound/animation work, no410/438 or raw control clear. The sound−1 check431771 sign-extends one immediate byte, not a four-byte immediate.|
|
||||
|AI PlayerControlled=NULL|Prior raw owner guard40C4AD→41040C4B9→game118(NULL)40C527; no438 or flatten. Named AI ownership remains an older port interpretation requiring broader proof.|
|
||||
|DEFAULT|447D5C checks whether Jimmy already owns raw control;447E27 restores via118 without410/438. No new key-release boundary is implemented. Music uses authored ownership independently of debug force.|
|
||||
@@ -38,3 +38,10 @@ animation prelude, all other class virtual effects and full shared camera state
|
||||
are not certified by this chunk. Existing named control behavior is preserved,
|
||||
not newly recovered here. Three byte/projection tests and coupled managed
|
||||
director/body tests guard the implemented ordering and boundaries.
|
||||
|
||||
2026-11-05 correction: game+274 is the facing destination, not an independent
|
||||
render cache. CAM/MCA copy `(0,currentYaw,0,currentW)` into both current and
|
||||
destination vectors without touching dirty. See
|
||||
[exact rotation handoff](../gameplay/jimmy-cutscene-rotation-source.md) for20
|
||||
isolated original-code cases and the recovered fix. STOP alone, AI NULL and
|
||||
DEFAULT retain their existing separate policies.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -0,0 +1,190 @@
|
||||
# Next work plan: recover interactions, then implement verified changes
|
||||
|
||||
2026-11-05. Proposed execution order following the user's request for a plan.
|
||||
Gameplay expansion remains paused. Current research checkpoint68154df preserves
|
||||
runtime a2e89c6 and packaged runtime dae13ac. This plan does not mark the remaining
|
||||
post-skip tilt fixed or authorize an unsupported rotation reset.
|
||||
|
||||
Execution update2026-11-06: [integrated lifecycle findings](../gameplay/jimmy-cutscene-lifecycle.md)
|
||||
add292 bounded original-code cases, complete DEFAULT recovery and a working
|
||||
read-only copied-original observer. Steps1–2 remain open at the actual original
|
||||
Carl entry/resumed-frame observation. Step3 has not begun; source composition
|
||||
agrees with the port's stale writer under the same synthetic order/state.
|
||||
|
||||
Later execution update: [menu/player lifetime](../gameplay/main-menu-player-lifetime.md)
|
||||
closes the successful TSK story path's source ordering gate. MAIN loads a background
|
||||
Level1D/Jimmy; successful TSK load uses that controlled Jimmy and the ordinary
|
||||
retained-object loader. Program's first-story classification is corrected without
|
||||
another angle reset. Step3's first-neutral-tick/300-idle Vulkan and eight managed
|
||||
trajectories pass. Integrated/native SDL checks and clean ea04210 packages now
|
||||
pass, including4 identical standalone Linux readbacks and a preliminary isolated
|
||||
Wine64 Carl replay. All539 originals remain unchanged. Original
|
||||
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,
|
||||
contact, cutscenes, landing and level return, then correct the port in small,
|
||||
verified chunks. Start with the concrete reported failure: jump while banked,
|
||||
enter Carl's lab conversation, skip, release controls, remain upright afterward.
|
||||
Ordinary landing bank must remain faithful to the original, as the user confirmed.
|
||||
|
||||
## 1. Close the original Carl skip-to-idle sequence
|
||||
|
||||
Trace the actual supplied route: physical contact → Carl talk activation →
|
||||
neutron1a activation → accepted skip → Carlwalk → DEFAULT → first idle input
|
||||
and player update. Follow direct callers, virtual targets and registry positions
|
||||
through REA, checking the authoritative bytes and GAM records.
|
||||
|
||||
Record support, raw control owner, movement mode, stored turn, current Euler,
|
||||
destination Euler, dirty flag, skip state, action latch, input suppression and
|
||||
frame delta at every boundary. Include contact/support state before entry: the
|
||||
port's grouped contacts might start the scene with different retained state.
|
||||
|
||||
Investigate the concrete remaining gaps: skip input-latch consumption and release,
|
||||
per-camera completion order, same-frame control changes, and fresh/retained actor
|
||||
ordering. Reuse the three new pseudocode results and existing instruction Evidence.
|
||||
Keep the unresolved DEFAULT procedure boundary explicit; use its guarded assembly
|
||||
and a changed analysis strategy where necessary rather than repeat failed queries.
|
||||
|
||||
**Deliverable:** an annotated original event/state trace and a clear explanation
|
||||
of where the original prevents the stale airborne bank from being republished.
|
||||
A local no-reset result or another plausible hypothesis does not close this gate.
|
||||
|
||||
## 2. Compare the original sequence with the reproducible port failure
|
||||
|
||||
Extend the existing48-case diagnostic around the original boundaries. Use an
|
||||
isolated original-code composition with explicit synthetic dependencies and/or
|
||||
an original-game runtime capture from a generated copy where the available
|
||||
runtime supports it. Record limitations, including any callbacks not executed.
|
||||
|
||||
Compare fresh and retained ordering; grounded and airborne entry; Left/Right
|
||||
bank; neutral and held input; Escape/Space skip and natural completion. Natural
|
||||
completion is a separate comparison—the user's confirmed failure concerns skip.
|
||||
Keep source viewport seconds, morph/engine timing and the port's60Hz policy
|
||||
explicit rather than assuming they share one clock.
|
||||
|
||||
**Deliverable:** a differential trace naming the first meaningful divergence,
|
||||
its owner and its consequences. Expected outcomes must agree with original
|
||||
instructions/composition and the user's observation. If they conflict, specify
|
||||
the exact missing observation before changing gameplay.
|
||||
|
||||
## 3. Implement the supported cutscene correction
|
||||
|
||||
Resume runtime work once steps1–2 establish the missing transition or ordering.
|
||||
Change the smallest coherent owner/lifecycle boundary, retaining the existing
|
||||
playable movement baseline. Preserve normal landing bank, heading, queued body
|
||||
work and the separately recovered fire/control lifecycles.
|
||||
|
||||
Convert the reported skipped-Carl/neutral-return scenario into a regression that
|
||||
fails on the current baseline. Cover the first resumed frame and sustained idle,
|
||||
both insertion orders, natural completion, held-input return, and repeated scenes.
|
||||
|
||||
**Done when:** the source explanation and implementation agree; Jimmy remains
|
||||
upright after skipping Carl; legitimate landing bank remains; targeted movement,
|
||||
Director, jetpack and visual checks pass. State any remaining approximation.
|
||||
|
||||
## 4. Deepen the remaining movement interaction contracts
|
||||
|
||||
After closing Carl's lifecycle, prioritize the existing core-system gaps:
|
||||
|
||||
1. **Body/contact ownership:** real Jimmy callbacks, dynamic pair eligibility,
|
||||
support admission, callback-mutated root/modes and successful fence/ladder or
|
||||
hazard paths. Preserve the lab/outside capsule until its replacement gate closes.
|
||||
2. **Animation lifecycle:** original action acceptance, playback clocks, completion
|
||||
callbacks and interruption across jump, land, STOP, talk, skip and control return.
|
||||
3. **Shared camera/input state:** final scripted eye, first resumed follow update,
|
||||
clipping, pause/menu/input gates and retained scene ordering.
|
||||
|
||||
Use each recovered transition to update the coverage map and remove a named
|
||||
assumption. Existing original arithmetic fixtures remain regression evidence;
|
||||
JN-Engine supplies original-decompiler leads, not replacement movement tuning.
|
||||
|
||||
**Deliverable:** per-system state/ownership contracts with addresses, file offsets,
|
||||
callers, dependencies, confidence and unresolved questions, plus bounded source
|
||||
probes where needed. Implement each supported correction as its own verified chunk.
|
||||
|
||||
## 5. Validate the route as one interacting system
|
||||
|
||||
Exercise lab → VR04 → lab → outside with fresh entry and RETURN. Include normal
|
||||
and skipped conversations, banked jumps, landing/idle, jetpack cleanup, held input,
|
||||
objectives, music/speech, camera handoff and persistent/reset state.
|
||||
|
||||
Run targeted checks for each change and the full suite at the integrated route
|
||||
checkpoint. Validate native Linux SDL/Vulkan, then obtain native Windows build
|
||||
feedback for the same scenarios. Compare original behavior where observed;
|
||||
managed tests, original components, Linux rendering and Windows execution remain
|
||||
separate evidence categories.
|
||||
|
||||
**Done when:** the route and reported bug pass the defined scenarios, original
|
||||
hashes remain unchanged, platform results/limits are recorded, and both packages
|
||||
identify a clean verified runtime commit. Push source/tools/docs to the approved
|
||||
Gitea remote; keep originals, generated traces and packages local.
|
||||
|
||||
## 6. Choose the next reconstruction checkpoint from the updated coverage map
|
||||
|
||||
Once movement and route handoffs are stable, rank the remaining audio/music,
|
||||
UI, progression/save-load and actor/AI gaps by how much existing gameplay they
|
||||
block. Recover and implement them in that dependency order. New gadgets and
|
||||
level-specific features stay behind the core movement/route checkpoint.
|
||||
|
||||
**Deliverable:** a short next-chunk plan based on measured gaps, with a concrete
|
||||
source question, implementation boundary and validation condition for each item.
|
||||
Do not require understanding every level before executing a supported core change.
|
||||
|
||||
## Parallel work and ownership
|
||||
|
||||
Use two independent investigators when the questions are substantial:
|
||||
|
||||
- Original input/skip/state ownership: jimmy-cutscene-return source report and
|
||||
its named binary analysis helpers.
|
||||
- Contact/registry/script ordering: jimmy-cutscene-chain-order source report and
|
||||
its named binary analysis helpers.
|
||||
|
||||
Primary owns the port diagnostic, integrated trace, coverage/status documents,
|
||||
runtime/test integration and commits. Establish exclusive ownership before work;
|
||||
review shared conclusions before editing gameplay. No investigator changes
|
||||
another's files or commits shared work.
|
||||
|
||||
## Checkpoint discipline
|
||||
|
||||
Every checkpoint reports recovered facts, inference, current implementation,
|
||||
verification and open questions separately. Save Evidence/probe identities and
|
||||
findings on disk. Commit and push completed, verified milestones. Gameplay work
|
||||
remains paused until the Carl source/differential gate above is satisfied; this
|
||||
plan itself introduces no gameplay or package changes.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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).
|
||||
@@ -1,5 +1,281 @@
|
||||
# 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
|
||||
well as retained transitions; direct fresh-scene order stays separate. The
|
||||
baseline native Vulkan replay fails on first neutral tick0 with destination
|
||||
roll−10.000001. Corrected first input and300 idle ticks stay upright, preserving
|
||||
heading, held-input return and body/fire continuation with zero Vulkan errors.
|
||||
Eight managed Carl trajectories coverLeft/Right, natural/skip and repeated scenes.
|
||||
All336 Python+2 HUD, managed projects and36 GPU/render passes succeed. Native Linux
|
||||
SDL/Vulkan1920×1080 control replay and VR04 powered keyboard/steering/resize pass
|
||||
with zero validation errors. The returned-frame readback is inspected upright.
|
||||
Final build has zero warnings/errors; Windows x64 cross-publish succeeds. Both
|
||||
packages identify clean ea04210 and have519 matching original copies,4285 scene
|
||||
files and7 prepared audio files each. Standalone Linux from /tmp without SDK/
|
||||
development-library paths passes the control replay with4 identical development
|
||||
readbacks. Its validation is disabled; development validation is enabled with zero
|
||||
errors. Removing the optional validation layer's library path produces
|
||||
ErrorLayerNotPresent; that diagnostic is preserved separately. The Windows
|
||||
package passes the32-frame Carl replay under isolated Wine64, including first
|
||||
neutral input/300 idle ticks and held-input return. This is preliminary Wine
|
||||
evidence, not native Windows verification. All539 originals are unchanged.
|
||||
Source details:
|
||||
[menu/player lifetime](gameplay/main-menu-player-lifetime.md). Normal landing bank
|
||||
and the actual movement/facing algorithms are preserved. Airborne control return,
|
||||
whole-original timing/rendering and native Windows comparison remain separate.
|
||||
|
||||
The50 new copied-original derived-caller cases and static body/visual-sync audit
|
||||
are bounded source/component evidence. Matched Wine startup diagnostics progress
|
||||
past MAIN only after an explicit OS repaint acknowledgement; they show background
|
||||
allocation with black frames and perturbed timing, not a playable Carl reference.
|
||||
|
||||
Earlier checkpoint (2026-11-05): post-skip tilt was still open. User original comparison specifically
|
||||
identifies skipping Carl; the previous validation covered entry and held movement
|
||||
on resume, not subsequent idle. A48-case managed port diagnostic isolates stale
|
||||
mode/turn republishing a bank target in fresh order. New original skip/control/
|
||||
registration evidence is documented, with its causal gap explicit. Gameplay
|
||||
changes are paused; packages remain dae13ac. See
|
||||
[focused decompilation](gameplay/jimmy-cutscene-decompilation.md).
|
||||
|
||||
Rotation handoff feedback (2026-11-05): CAM/MCA clear both live and destination
|
||||
pitch/bank while preserving current yaw/dirty.20 isolated original cases compare;
|
||||
managed real banked-jump handoffs and native Linux control restoration pass.
|
||||
Seven source grounded-input/facing trajectories reproduce residual idle tilt,
|
||||
so no generic landing snap was introduced. Whole-original frame/native Windows
|
||||
comparison remains open. See [handoff](gameplay/jimmy-rotation-handoff.md).
|
||||
|
||||
Rotation packages identify clean dae13ac;519 original copies,4285 scene resources
|
||||
and seven prepared audio files match per platform. Standalone Linux handoff passes
|
||||
with three identical development readbacks and zero Vulkan validation errors.
|
||||
All336 Python/targeted managed checks pass;539 originals unchanged. Windows is
|
||||
cross-published/resource-verified, not native runtime-verified.
|
||||
|
||||
Turning/fire feedback (2026-11-05): source left/right turn clips restored for
|
||||
low-speed grounded turning; jetpack fire now shares full owner pitch/yaw/roll
|
||||
and visual alignment. Player visual/movement/data/director/jetpack/Python checks
|
||||
|
||||
@@ -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
|
||||
@@ -347,3 +504,88 @@ assets and generated packages stay excluded.
|
||||
translation branch. Preserve inactive-path context. Retain the lab/outside
|
||||
capsule until real Jimmy callbacks and multi-frame/dynamic ownership are proven.
|
||||
See checkpoint/body-contact-implementation.md.
|
||||
|
||||
51. **Camera orientation preparation replaces the facing destination too.**
|
||||
Source CAM/MCA flatten current and game+274 destination to current yaw with
|
||||
pitch/roll0; direct writes preserve facing dirty. Reset both on that existing
|
||||
preparation boundary, not on every input lock/STOP/DEFAULT.20 isolated native
|
||||
cases verify this state ownership. Neutral grounded input instead retains
|
||||
residual destination bank in seven source trajectories; no unproven universal
|
||||
landing snap is added. Another whole-frame writer or original quirk remains
|
||||
open. See gameplay/jimmy-rotation-handoff.md and its two source reports.
|
||||
|
||||
52. **Recover full cutscene lifecycle before further symptom fixes.**
|
||||
User redirects work to decompilation first after confirming a distinct
|
||||
post-skip idle bank. Preserve the current runtime/packages; diagnose and
|
||||
document original entry/contact/skip/control/input ordering before resetting
|
||||
movement fields or changing the scheduler. Current source/component findings
|
||||
do not yet explain the whole-original upright return. See
|
||||
gameplay/jimmy-cutscene-decompilation.md for the recovery gate.
|
||||
|
||||
53. **Observe the actual original handoff when composed source matches the port.**
|
||||
292 new bounded original-code cases do not establish another movement reset;
|
||||
fresh input-before-player composition itself restores bank. Retain the user's
|
||||
upright-original requirement without inventing an owner/DEFAULT/animation reset.
|
||||
Use the copied-original read-only observer to measure actual route state and
|
||||
registry membership. Its successful Wine32 attach is tool validation, while
|
||||
MAIN-only black frames are not gameplay evidence. Keep runtime/packages fixed
|
||||
until the source/differential gate closes. See gameplay/jimmy-cutscene-lifecycle.md.
|
||||
|
||||
54. **Classify successful TSK story entry as retained-player order.**
|
||||
Source application startup loads backgroundLevel1D/Jimmy; successful TSK
|
||||
destination requests use an existing controlled C3DJIMMY and the ordinary
|
||||
selective teardown/reuse path. The new level game follows that retained node,
|
||||
including first playable New Game. Program's carriedSave-only test was too
|
||||
narrow. Include TSK-backed story entry, keep fresh direct-scene simulations,
|
||||
and preserve rotation/movement algorithms. Baseline first-neutral input
|
||||
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.
|
||||
@@ -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:** {'revision': '1ae5f4251c26f3b0446f333e994694f99eab5be6', 'paths': ['src/GamePort/Game/PlayerAppearance.cs', 'src/GamePort/Game/SceneDirector.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "action-animation-coverage", "result": "Original morph resources and bounded movement/turn/action aliases play; task and script controls have bounded tests."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "action-animation-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "action-animation-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["action-animation: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'action-animation-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['action-animation: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '0e2f426d425153d4452a67f288813067caa624da', 'paths': ['src/GamePort/Game/JimmyGroundMotion.cs', 'src/GamePort/Game/JimmyAirMotion.cs', 'src/GamePort/Game/JimmyOrientation.cs', 'src/GamePort/Game/FixedStepClock.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "controller-phases-coverage", "result": "Recovered ground/air/facing/jump arithmetic and prior-body then registry input ordering support bounded Jimmy movement."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "controller-phases-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "controller-phases-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["controller-phases: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'controller-phases-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['controller-phases: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'ea04210f524faae7dc1caff8afbc608fbb8144f4', 'paths': ['src/GamePort/Program.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "route-control-coverage", "result": "Lab/VR04/lab/outside, raw versus debug control, body/fire continuation and bounded RETURN state are implemented."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "route-control-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "route-control-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["route-control: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'route-control-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['route-control: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'ea04210f524faae7dc1caff8afbc608fbb8144f4', 'paths': ['src/GamePort/Program.cs'], 'status': 'bounded', 'note': 'story || carriedSave != null; unchanged Program source through ledger work'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [{"path": "artifacts/main-menu-player-lifetime/package-identity.json", "sha256": "6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c", "size": 845}, {"path": "artifacts/main-menu-player-lifetime/package-verification.json", "sha256": "e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31", "size": 2548}, {"path": "artifacts/main-menu-player-lifetime/native-control-final.log", "sha256": "46efc999b3d2d78b1eef3b3dea9d8fee188202c1556dc1d40751e6ee555f8548", "size": 1901}, {"path": "artifacts/main-menu-player-lifetime/package-control-standalone.log", "sha256": "09fa452577bbd66b9275cb83045db6b3a117913ec415f5fb6ae52e9a174790e0", "size": 1950}, {"path": "artifacts/main-menu-player-lifetime/native-control-final.returned.ppm", "sha256": "2aa0156b1ee0de50a54808cfaac8acd6b9df5c3d947c7fa4f2ee08e6a814e238", "size": 6220817}, {"missing_reason": "No usable whole-original Carl recording exists in this checkpoint", "path": "artifacts/fidelity/captures/original-carl-reference.webm"}, {"missing_reason": "Native Windows Carl recording has not been collected", "path": "artifacts/fidelity/captures/windows-native-carl-reference.webm"}], "claim": {"key": "neutral-return", "result": "First input and 300 idle ticks upright; preserved heading/body/fire; four standalone readbacks identical. Development validation zero errors; standalone validation disabled."}, "content": {"package_report_sha256": "6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c", "runtime_sha256": "9bee85197c0d7322dc67a8c1aedbe700cf63083f91f99161dd4533c2585501e5", "verification_report_sha256": "e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31"}, "evidence_kind": "port_fixture", "historical": true, "id": "tsk-linux-fixture-ea04210", "method": "Historical native Linux SDL/Vulkan control fixture and standalone replay, recorded report/logs; no new execution", "missing_evidence": ["No complete original Carl capture", "No current native Windows comparison"], "platform": {"execution": "native", "os": "linux"}, "reason": null, "receipt_id": "tsk-linux-fixture-ea04210", "report_path": "docs/gameplay/main-menu-player-lifetime.md", "revision": "ea04210f524faae7dc1caff8afbc608fbb8144f4", "scope": ["Carl first neutral input and 300 idle ticks; held movement return"], "status": "current", "supersedes": []}
|
||||
- {"addresses": ["46BF2F..46C00A", "460A50..460A6A", "43B5A0", "46E38B/46E45A"], "artifacts": [{"path": "artifacts/main-menu-player-lifetime/source.json", "sha256": "abfeef8fb990e39e6e7f9395aae8fc8111e8038d92f5c0673a2db7505ec61070", "size": 37630}], "claim": {"key": "initial-story-order", "result": "Retained Jimmy precedes new level-game input; already corrected"}, "content": {"implementation_sha256": "2ea2e4cee3816337765b3cb4c07bc9b2a226a4c0951d0f4a7d9e2eb2f8b09e5d", "report_sha256": "956dc37ab40b0701564faf7fb227163cd1b7d118aeb73c9847c51f9f9ac61ce9"}, "evidence_kind": "static", "historical": false, "id": "tsk-source-order-ea04210", "method": "Guarded source/data report, not a new execution", "missing_evidence": ["No complete original Carl capture", "No current native Windows comparison"], "original_sha256": "f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8", "platform": {"execution": "static", "os": "source"}, "rea_evidence": "ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904", "reason": "Successful TSK requires existing Jimmy; background Level1D constructs him and ordinary loader retains registry node.", "receipt_id": "tsk-source-order-ea04210", "report_path": "docs/gameplay/main-menu-player-lifetime.md", "revision": "ea04210f524faae7dc1caff8afbc608fbb8144f4", "scope": ["successful TSK story entry; direct-fresh distinction"], "status": "current", "supersedes": ["tsk-fresh-assumption-dae13ac"]}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'source-order-at-ledger-import', 'content': {'report_sha256': '956dc37ab40b0701564faf7fb227163cd1b7d118aeb73c9847c51f9f9ac61ce9', 'implementation_sha256': '2ea2e4cee3816337765b3cb4c07bc9b2a226a4c0951d0f4a7d9e2eb2f8b09e5d'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['successful TSK story entry; direct-fresh distinction']}, {'id': 'historical-linux-ea04210-only', 'content': {'runtime_sha256': '9bee85197c0d7322dc67a8c1aedbe700cf63083f91f99161dd4533c2585501e5', 'package_report_sha256': '6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c', 'verification_report_sha256': 'e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31'}, 'platform': {'os': 'linux', 'execution': 'native'}, 'scope': ['Carl first neutral input and 300 idle ticks; held movement return']}]
|
||||
|
||||
<details><summary>History — exact revisions and supersession retained</summary>
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "initial-story-order", "result": "Prior port incorrectly treated first TSK story as fresh registry order; source report explicitly corrects this"}, "content": {"implementation_sha256": "2ea2e4cee3816337765b3cb4c07bc9b2a226a4c0951d0f4a7d9e2eb2f8b09e5d", "report_sha256": "956dc37ab40b0701564faf7fb227163cd1b7d118aeb73c9847c51f9f9ac61ce9"}, "evidence_kind": "inferred", "historical": true, "id": "tsk-fresh-assumption-dae13ac", "method": "Prior narrative retained from source report; never accepted as source fact", "missing_evidence": ["No complete original Carl capture", "No current native Windows comparison"], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "tsk-fresh-assumption-dae13ac", "report_path": "docs/gameplay/main-menu-player-lifetime.md", "revision": "dae13ace7391671aee7082c662bb798b285b9124", "scope": ["successful TSK story entry; direct-fresh distinction"], "status": "superseded", "supersedes": []}
|
||||
- {"artifacts": [{"path": "artifacts/main-menu-player-lifetime/package-verification.json", "sha256": "e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31", "size": 2548}], "claim": {"key": "wine-control", "result": "Historical isolated Wine64 fixture exits 0; preliminary compatibility only"}, "content": {"package_report_sha256": "6b1c7ab40f26f489d0bc272d6e2962adc257f32d42e8cd78755f5a135f512e8c", "runtime_sha256": "24e1f01be497b920eab005608cf04c8838894d9e63404008c674990627bbc989", "verification_report_sha256": "e8a180991c35f279726c595a70ed32c4ab06df0381d59169735edebf86554e31"}, "evidence_kind": "wine", "historical": true, "id": "tsk-wine64-ea04210", "method": "Reported Wine64 fixture; not native Windows; package verification report retained", "missing_evidence": ["No complete original Carl capture", "No current native Windows comparison"], "platform": {"execution": "wine", "os": "windows"}, "reason": null, "receipt_id": "tsk-wine64-ea04210", "report_path": "docs/gameplay/main-menu-player-lifetime.md", "revision": "ea04210f524faae7dc1caff8afbc608fbb8144f4", "scope": ["32-frame packaged Carl/control fixture"], "status": "historical", "supersedes": []}
|
||||
|
||||
</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:** {'revision': 'fccc0b9d1b6ae962d32147e4ae1433fce6a1a23e', 'paths': ['src/GamePort/Game/ActorPatrol.cs', 'src/GamePort/Game/SceneInteractions.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "actor-policies-coverage", "result": "Bounded Carl/Goddard patrol, pickup/task callbacks, VR04 shrink targets and VR01/VR07 contact consumers exist."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "actor-policies-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "actor-policies-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["actor-policies: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'actor-policies-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['actor-policies: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'c9d0c5be59eedba3a92dcd46d1beb96b2e9e941a', 'paths': ['src/GamePort/Game/OriginalBodyPhysics.cs', 'src/GamePort/Game/OriginalPairCollision.cs', 'src/GamePort/Game/OriginalNormalContacts.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "body-static-dynamic-coverage", "result": "VR04 ordinary source static body and standalone pair/reclip/normal components preserve published roots, live getters and callback order."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "body-static-dynamic-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "body-static-dynamic-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["body-static-dynamic: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'body-static-dynamic-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['body-static-dynamic: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'ea04210f524faae7dc1caff8afbc608fbb8144f4', 'paths': ['src/GamePort/Program.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "physical-helper-lifetimes-coverage", "result": "72 VR04 records/13 classes, 12 original registration cases and 21 helper edges are inventoried; common append differs from Jimmy49E guard."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "physical-helper-lifetimes-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "physical-helper-lifetimes-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["physical-helper-lifetimes: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'physical-helper-lifetimes-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['physical-helper-lifetimes: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '7b5230ceb819e2e6cd551f19d11ef07fad9f1876', 'paths': ['src/GamePort/Game/ShrinkRay.cs', 'src/GamePort/Game/InvisibleGadget.cs', 'src/GamePort/Game/BubbleMotion.cs', 'src/GamePort/Game/BaseballGadget.cs', 'src/GamePort/Game/GrapplerGadget.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "gadget-use-coverage", "result": "Shrink ray/jetpack, Invisible, Bubble VR01, Baseball VR07 and Grappler VR08 have bounded implementations using original resources."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "gadget-use-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "gadget-use-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["gadget-use: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'gadget-use-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['gadget-use: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '27be8ed63079ae2e3bf7e965ee205c4a57a96559', 'paths': ['src/GamePort/Game/PlayerLevelState.cs', 'src/GamePort/Game/SceneGadgets.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "gadget-retention-coverage", "result": "Bounded cutscene/unequip/RETURN cleanup and selected route scalar ownership are implemented; independent helpers retain separate lifetimes."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "gadget-retention-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "gadget-retention-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["gadget-retention: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'gadget-retention-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['gadget-retention: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '1ae5f4251c26f3b0446f333e994694f99eab5be6', 'paths': ['src/GamePort/Game/SceneInventory.cs', 'src/GamePort/Game/PlayerEnergy.cs', 'src/GamePort/Game/GadgetScreen.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "inventory-energy-coverage", "result": "Owned gadget panel, practice selection, source availability passes and shared energy warnings operate in bounded scenes."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "inventory-energy-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "inventory-energy-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["inventory-energy: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'inventory-energy-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['inventory-energy: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'c9d0c5be59eedba3a92dcd46d1beb96b2e9e941a', 'paths': ['src/GamePort/Game/Scooter.cs', 'src/GamePort/Game/Rocketship.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "vehicles-coverage", "result": "Scooter VR05/outside LEV1 and Rocketship VR02 provide bounded summon/mount/control/camera/cleanup with original art."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "vehicles-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "vehicles-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["vehicles: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'vehicles-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['vehicles: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '62c07a3d59ca6d71a7456957d8586c268d27c439', 'paths': ['src/GamePort/Game/SceneDirector.cs', 'src/GamePort/Game/TaskActivation.cs', 'src/GamePort/Game/SceneMechanisms.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "authored-scenes-tasks-coverage", "result": "All 35 supplied GAMs parse; 33 have geometry. Lab tasks, scripts, objectives, practice/RETURN and bounded optional mechanisms work."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "authored-scenes-tasks-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "authored-scenes-tasks-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["authored-scenes-tasks: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'authored-scenes-tasks-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['authored-scenes-tasks: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'bdca29d3aa31face0c0023537ff98783716dbc45', 'paths': [], 'status': 'unimplemented', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "campaign-completion-coverage", "result": "No verified full-campaign completion workflow exists; bounded playable routes are foundations."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "campaign-completion-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "campaign-completion-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["campaign-completion: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'campaign-completion-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['campaign-completion: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'bdca29d3aa31face0c0023537ff98783716dbc45', 'paths': [], 'status': 'unimplemented', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "configuration-workflow-coverage", "result": "Modern CLI/debug display/audio options exist; full original-supported settings persistence workflow is unimplemented."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "configuration-workflow-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "configuration-workflow-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["configuration-workflow: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'configuration-workflow-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['configuration-workflow: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'd62e2ab4dea38ce1c018b1a18ab51c39986ab630', 'paths': ['tools/recon/inventory.py'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "content-accounting-coverage", "result": "Original inventory and GAM/OMT preparation account for supplied assets; missing Level3B/E geometry is recorded without substitution."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "content-accounting-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "content-accounting-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["content-accounting: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'content-accounting-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['content-accounting: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'ca08c468ba21a26710891b0029652351b9c2ae23', 'paths': ['src/GamePort/Game/ObjectivePanel.cs', 'src/GamePort/Game/PracticePrompt.cs', 'src/GamePort/Game/GadgetScreen.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "frontend-hud-coverage", "result": "Bounded objective/practice/gadget UI and script return operate; persistent window/widescreen/F1/F2 are explicit modern presentation tools."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "frontend-hud-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "frontend-hud-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["frontend-hud: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'frontend-hud-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['frontend-hud: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '8d60a68511d1891d68e34feb22d6938c738ba98f', 'paths': ['src/GamePort/Game/RuntimeCheckpoint.cs', 'src/GamePort/Game/PlayerLevelState.cs', 'src/GamePort/Game/SceneInteractions.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "save-load-return-coverage", "result": "Original TSK round-trip/CLI task-item-score state, source departure-root RETURN and bounded retained scene snapshots are implemented."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "save-load-return-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "save-load-return-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["save-load-return: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'save-load-return-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['save-load-return: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'bdca29d3aa31face0c0023537ff98783716dbc45', 'paths': [], 'status': 'unimplemented', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "final-fidelity-audit-coverage", "result": "Capability/history/discrepancy navigation exists; a successful whole-game comparison and final fidelity audit is unimplemented."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "final-fidelity-audit-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "final-fidelity-audit-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["final-fidelity-audit: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'final-fidelity-audit-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['final-fidelity-audit: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '62c07a3d59ca6d71a7456957d8586c268d27c439', 'paths': ['scripts/package.sh', 'scripts/build-linux.sh', 'scripts/build-windows.sh', 'scripts/test.sh'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "native-delivery-coverage", "result": "Local shared .NET10/SDL3/Vulkan builds and Linux/Windows self-contained packages have bounded provenance and resource checks."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "native-delivery-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "native-delivery-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["native-delivery: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'native-delivery-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['native-delivery: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '32a72654e88ad3709aa1e2f0f108eea06e1b7469', 'paths': ['tools/recon/fidelity.py', 'tools/recon/fidelity_receipts.py', 'tools/recon/fidelity_review.py'], 'status': 'tooling', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "preservation-reference-tools-coverage", "result": "Local inventory, preserved staging, typed hashed receipt import, eight-cell protocol and paired review tools support reproducible evidence navigation."}, "content": {"report_sha256": "f43abb53db1715ca3c5643159b44cac3742b4b1973b1feaf9a1001f754537743"}, "evidence_kind": "static", "historical": false, "id": "preservation-reference-tools-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "preservation-reference-tools-report", "report_path": "docs/evidence/scenarios.json", "revision": "32a72654e88ad3709aa1e2f0f108eea06e1b7469", "scope": ["preservation-reference-tools: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'preservation-reference-tools-documentation', 'content': {'report_sha256': 'f43abb53db1715ca3c5643159b44cac3742b4b1973b1feaf9a1001f754537743'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['preservation-reference-tools: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '62c07a3d59ca6d71a7456957d8586c268d27c439', 'paths': ['src/GamePort/Game/OriginalCameraRay.cs', 'src/GamePort/Game/GrapplerCamera.cs', 'src/GamePort/Game/ScooterCamera.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "shared-camera-projection-coverage", "result": "Source static clipping/ray/gain runs in lab/VR04/outside; all level far overrides and bounded vehicle/script cameras are mapped."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "shared-camera-projection-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "shared-camera-projection-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["shared-camera-projection: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'shared-camera-projection-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['shared-camera-projection: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '7b5230ceb819e2e6cd551f19d11ef07fad9f1876', 'paths': ['src/GamePort/Rendering/Vulkan/VulkanRenderer.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "vulkan-materials-coverage", "result": "Vulkan renders original textured/depth geometry and bounded material/alpha effects; null-material and Rocketship diffuse RGBA contracts are corrected."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "vulkan-materials-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "vulkan-materials-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["vulkan-materials: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'vulkan-materials-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['vulkan-materials: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '27be8ed63079ae2e3bf7e965ee205c4a57a96559', 'paths': ['src/GamePort/Game/JimmyRenderTransform.cs', 'src/GamePort/Game/PlayerAppearance.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "models-animation-layout-coverage", "result": "Original geometry/textures/hierarchies/morphs/sprites/UI resources render with bounded full-Euler and source-pivot bridges."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "models-animation-layout-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "models-animation-layout-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["models-animation-layout: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'models-animation-layout-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['models-animation-layout: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': '62c07a3d59ca6d71a7456957d8586c268d27c439', 'paths': ['src/GamePort/Audio/SceneAudio.cs', 'src/GamePort/Audio/SdlAudio.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "music-speech-banks-coverage", "result": "Original music/speech and 251 RIFF effects exports feed independent SDL streams; CAM stops music and DEFAULT restores it."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "music-speech-banks-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "music-speech-banks-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["music-speech-banks: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'music-speech-banks-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['music-speech-banks: documentary coverage only']}]
|
||||
|
||||
<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:** {'revision': 'fccc0b9d1b6ae962d32147e4ae1433fce6a1a23e', 'paths': ['src/GamePort/Game/ScooterAudio.cs', 'src/GamePort/Audio/SceneAudio.cs'], 'status': 'bounded', 'note': '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.'}
|
||||
|
||||
**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):**
|
||||
|
||||
- {"artifacts": [], "claim": {"key": "spatial-audio-listener-coverage", "result": "Scooter positional frequency/history correction uses the shared listener including parked/script cameras; nominal engine formula is preserved."}, "content": {"report_sha256": "4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea"}, "evidence_kind": "static", "historical": false, "id": "spatial-audio-listener-report", "method": "Existing documentation inspected and indexed; not new binary recovery, component execution or gameplay capture", "missing_evidence": ["Identified whole-original DxWnd and current native Linux/Windows scenario capture/review remain open (0/120 obligations)."], "platform": {"execution": "static", "os": "source"}, "reason": null, "receipt_id": "spatial-audio-listener-report", "report_path": "docs/checkpoint/coverage.md", "revision": "bdca29d3aa31face0c0023537ff98783716dbc45", "scope": ["spatial-audio-listener: documentary coverage only"], "status": "current", "supersedes": []}
|
||||
|
||||
**Explicit applicability targets:** [{'id': 'spatial-audio-listener-documentation', 'content': {'report_sha256': '4481cb6df6748bc38a8808da64a93206f5e02326bc37e6fa2104f189b9339dea'}, 'platform': {'os': 'source', 'execution': 'static'}, 'scope': ['spatial-audio-listener: documentary coverage only']}]
|
||||
|
||||
<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
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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."
|
||||
}
|
||||
}
|
||||
@@ -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.
|
||||
@@ -0,0 +1,148 @@
|
||||
# Jimmy base, animation completion and STOP during cutscene return
|
||||
|
||||
2026-11-06. Bounded original-code investigation of the dependencies omitted by
|
||||
[the skip composition](jimmy-skip-composition.md). No runtime change or new
|
||||
rotation reset is justified by these results.
|
||||
|
||||
## Identity and evidence
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Retained complete REA instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`
|
||||
is reused and its subject hash verified. The helper verifies original identity,
|
||||
virtual bindings and PE-maps the source ranges. Addresses below are preferred
|
||||
EXE VAs; the listed text file offsets equal VA minus400000.
|
||||
|
||||
JN-Engine's C3DAnimated/C3DPlayer/C3DJimmy reports supplied indexing leads.
|
||||
The conclusions here come from authoritative bytes, retained REA instructions
|
||||
and the bounded native execution, rather than its reconstructed movement.
|
||||
|
||||
## Recovered base/update contract
|
||||
|
||||
| Boundary / VA / file offset | Original ownership and effects |
|
||||
|---|---|
|
||||
|Jimmy424600..424D10 /24600..24D10|The ordinary derived frame callback eventually invokes437940 at424C34. Its null-control prelude handles helpers/menu/sound; the inspected function contains no direct mode704/turn614 reset. It also calls other Jimmy helpers; this is not a full execution proof of that frame.|
|
||||
|43796A→40E050 /3796A→E050|Player wrapper invokes animated base **before** its raw-owner identity gate437A1B. Base behavior therefore remains relevant while raw control is null.|
|
||||
|40E050..40E1C8 /E050..E1C8|Global readiness gate; one-time pickup-link work; common object update462520; optional authored-transform pin when game58C CanMove==0; animation clock/completion check. No direct movement-mode/turn reset. Actual lab JIM1 CanMove is1, as the earlier supplied-GAM investigation records.|
|
||||
|462520..462649 /62520..62649|Optional body-context/current-root bridge, then458930→473240. A missing body context skips the former bridge but still reaches the common update.|
|
||||
|473240..473298 /73240..73298|Calls game3D4→4732B0 to maintain sound handles, expiration callback if its timer expires, then game3D8→43A420 facing.|
|
||||
|40E162..40E1C0 /E162..E1C0|Requires both game574/575 readiness bytes. Increments game4C4/complete584 clock. If completeAD play-loop is0 and game56C/complete62C record exists, current frame at least record48−1 calls complete104. There is no completion latch here.|
|
||||
|complete4A3BDC+104→43A900 /A3CE0→3A900|Actual Jimmy animation-ended callback. Tests current action through complete100→40DF80. STOP, ordinary talk and FALL do nothing in this callback.|
|
||||
|43A92E..43A9A9 /3A92E..3A9A9|FENCE/LADDER completion selects STOP, clears shared4F83E0 and special timer, invokes Stop, clears special movement fields, restores saved **position** through game314, and enables body state. No mode704/turn614 or Euler reset.|
|
||||
|43A9CA..43AA38 /3A9CA..3AA38|SPLAT/HIT completion selects STOP; HIT additionally clears shared4F83E0/special timer. This is not an ordinary scene-return rotation reset.|
|
||||
|
||||
The optional body-context bridge in462520 has not been exercised with a real
|
||||
world/body here. Its current-root writes and any level callback side effects
|
||||
remain a separate boundary; a null synthetic context must not establish their
|
||||
absence in the whole original.
|
||||
|
||||
## STOP is two different entry paths
|
||||
|
||||
Script preparation's game410→42AFC0 is not the same entry as assigning a target
|
||||
deactivation animation through completeE0:
|
||||
|
||||
```
|
||||
game410 ->42AFC0
|
||||
->43A750: speed608=0, velocity XYZ via2C4->471F40, sound148->429A00
|
||||
->sound148->429A00 again
|
||||
->complete150->43AFF0("STOP"): action acceptance
|
||||
->completeE0->40DD90("STOP",1) if accepted
|
||||
|
||||
TargetDeactAnim STOP ->completeE0->40DD90("STOP",1) directly
|
||||
```
|
||||
|
||||
43AFF0 first rejects an unchanged current action and protected HIT/SPLAT/FENCE/
|
||||
LADDER/other special states; it then recognizes STOP at43B28A. Its accepted STOP
|
||||
branch stops sound, selects the animation and clears acceleration through
|
||||
game278. There is no mode/turn/Euler reset. A Stop call can therefore clear
|
||||
speed/velocity while its STOP animation request is rejected. Direct animation
|
||||
selection has a distinct acceptance boundary.
|
||||
|
||||
| Selection dependency / VA / file offset | Recovered effects and limits |
|
||||
|---|---|
|
||||
|40DD90..40DF7C /DD90..DF7C|Requires complete634/635. Resets local animation clock; may bind the selected shape, call completeC8 shape refresh and preserve scale; builds the resource key with HI/LOW prefix; finds the animation record; updates name/record; dispatches completeE4 with start frame/repeat and completeC0 with animation definition. No movement-mode/turn/Euler reset in this procedure.|
|
||||
|completeC8→462270 /62270..62331|Reads bound shape radius and bounds. Calls game110→471240, game2E8→472120 and game2E0→4720C0. The latter setters write game1D4/1C4 bounding vectors, not Euler or destination Euler.|
|
||||
|completeE4→40DA30 /DA30..DAAD|Calls morph subobject frame/repeat and pause methods, mirrors loop byte completeAD, selects frame metadata if present. No mode/turn/Euler reset.|
|
||||
|completeC0→47ED54 /7ED54|OMT animation-definition transport is represented by an explicit resource adapter in the probe. Full DLL animation playback is not executed.|
|
||||
|
||||
## Native observations
|
||||
|
||||
`tools/binary/jimmy_base_return.py` and `_probe.c` generate a private mapped-source
|
||||
probe; it runs in the existing network-isolated Wine32 copy environment.
|
||||
Original files are neither modified nor mounted in that execution namespace.
|
||||
The final run emits the required success marker and exits0. Post-capture Python
|
||||
assertions validate **140 finite cases**:
|
||||
|
||||
- **84 base cases:** seven action names STOP/TALK/FALL/HIT/SPLAT/FENCE/LADDER,
|
||||
three readiness states, loop0/1 and before/at-final-frame. Each runs180 actual
|
||||
base/common/facing updates. Both Euler vectors stay(0,155,0), movement mode1
|
||||
and stored turn11.666668 survive. Eligible non-loop completion is called180
|
||||
times. The action-selection adapter in this matrix records/copies the new
|
||||
action name without changing playback flags; repeated completion here is
|
||||
deliberately not a claim about the full selected animation's playback.
|
||||
- **56 STOP cases:** same seven initial actions, readiness off/on, record absent/
|
||||
present and game410 Stop versus direct completeE0 selection. These execute
|
||||
actual42AFC0,43A750,429A00,43AFF0,40DD90,40DA30 and462270 as applicable.
|
||||
STOP selection/frame/pause paths are checked, including protected-action
|
||||
rejection versus direct selection. Mode/turn and initially distinct Euler
|
||||
vectors remain unchanged. Non-direct Stop clears speed and velocity.
|
||||
After an **explicit synthetic upright seed**, another180 actual base updates
|
||||
retain upright vectors and the old mode/turn. Successful real STOP selection
|
||||
sets loop1, so this interval has no animation-ended callback.
|
||||
|
||||
Base cases execute the actual462520 chain with a synthetic null body-context
|
||||
pointer. The pickup link is marked checked, CanMove is1, sound handles invalid,
|
||||
timer0 and facing dirty0. Resource lookup, shape/animation binding, shape bounds,
|
||||
morph current-frame/frame-set/pause transport and special Stop/restore/enable
|
||||
callbacks are explicit adapters. Actual action-name getter and string comparison
|
||||
semantics are used. These are original components on synthetic state, not actual
|
||||
Carl startup, body integration, registry scheduling, a full Jimmy frame, OMT
|
||||
playback/rendering or native Windows gameplay.
|
||||
|
||||
## Consequence and remaining question
|
||||
|
||||
The omitted base completion and accepted STOP request paths do not supply a
|
||||
hidden ordinary-mode or stored-turn reset in these bounded source cases. The
|
||||
successfully selected STOP loop also prevents a later completion callback from
|
||||
quietly repairing those fields. This strengthens the existing composition's
|
||||
retained-state interpretation; it still does not establish the actual original
|
||||
first resumed input order or entry state.
|
||||
|
||||
Preserve the evidence gate. The next comparison must identify a real divergence
|
||||
in entry/contact state, registry/frame placement, input eligibility or the
|
||||
remaining live body/derived-frame context before changing the port. A blanket
|
||||
rotation reset or switching all fresh sessions to retained ordering is not
|
||||
supported by this result.
|
||||
|
||||
## Artifacts and reproduction
|
||||
|
||||
- artifacts/jimmy-base-return/build/source.json: source ranges, PE offsets,
|
||||
hashes, virtual bindings and retained REA excerpts.
|
||||
- artifacts/jimmy-base-return/native-observations.json: all140 case records and
|
||||
source/probe/log/capture hashes.
|
||||
- probe/wine.log and probe/capture.json: final success marker and exit0.
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_base_return.py ../Original \
|
||||
--output artifacts/jimmy-base-return/build \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-base-return/build/jimmy_base_return_probe.c \
|
||||
-o artifacts/jimmy-base-return/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-base-return/build/probe.exe \
|
||||
--probe-success JIMMY_BASE_RETURN_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-base-return/probe
|
||||
python3 tools/binary/jimmy_base_return.py ../Original \
|
||||
--output artifacts/jimmy-base-return/build \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--capture artifacts/jimmy-base-return/probe
|
||||
```
|
||||
|
||||
First-run prefix setup exceeded its initial capture interval; the initialized
|
||||
rerun established the84 base cases. The expanded resource adapter initially
|
||||
expected STOP instead of the source's HISTOP lookup; that harness assertion was
|
||||
corrected before the successful140-case capture. Source virtual bindings are
|
||||
checked before compilation. No failed harness/setup attempt is original gameplay
|
||||
evidence. No runtime/shared documentation edit or commit is made by this agent.
|
||||
@@ -0,0 +1,125 @@
|
||||
# Jimmy body-context alignment and transform publication on return
|
||||
|
||||
2026-11-06. Static follow-up to the null-body-context limitation in
|
||||
[the base/STOP probe](jimmy-base-return.md). Original identity and cached REA
|
||||
instructions are reused; no new native cases or gameplay changes are claimed.
|
||||
|
||||
## Source identity and guard
|
||||
|
||||
Canonical Neutron.exe SHA256:
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Complete EXE instruction Evidence:
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
|
||||
The read-only `tools/binary/jimmy_body_transform_return.py` verifies that subject,
|
||||
12 source sites,16 virtual bindings and13 bounded source ranges. Its generated
|
||||
report contains PE file offsets, hashes and the matching retained REA extracts:
|
||||
`artifacts/jimmy-body-transform-return/source.json`.
|
||||
|
||||
The prior OMT transform Evidence is
|
||||
`ev_af082632c98b34ccfcedef01466cafa03365e7fbf482496d01a4cda6d2f8f787`.
|
||||
It is a truncated DLL disassembly prefix, not complete DLL coverage. Existing
|
||||
transform ranges are present and rechecked against the supplied DLL through
|
||||
`jimmy_model_bridge.collect`; see [render transform](jimmy-render-transform.md)
|
||||
for the earlier12 angle and14 hierarchy/final-matrix observations and limitations.
|
||||
JN-Engine's original class notes supplied field/navigation leads only.
|
||||
|
||||
## The live context bridge can write current Euler, behind a separate gate
|
||||
|
||||
| Original VA / EXE file offset | Recovered receiver and state effect |
|
||||
|---|---|
|
||||
|462520..462649 /62520..62649|Runs before common458930→473240/facing. Requires475CA0, own game210→4719F0(byte13E), and nonnull own game338→472570(pointer234) for the context path.|
|
||||
|46255D..46258F /6255D..6258F|Reads support polygon's+4 link and linked+80 payload; invokes current game complete130(actor game pointer,linked record,payload,dt). Lab4C3CD0,VR044CE910 and outside4C5A80 all bind130→44E030. The callback occurs **before** the alignment gate.|
|
||||
|462595..4625A2 /62595..625A2|Own game1E8→471950 reads live byte138. False bypasses normal→Euler publication but still reaches common update/facing. This gate is independent of cached support218 and raw input owner.|
|
||||
|4625A8..462632 /625A8..62632|For true138, obtains current Euler328→4723F0, copies support normal Vec4 from polygon+8..14, calls476FF0 and writes resulting XYZ through330→472420. This changes **current Euler only**: target274, dirtyA, mode704 and turn614 are not written by this suffix.|
|
||||
|471080/471090 /71080/71090|Property getterC4 reads byte10. Property setterC8 writes byte10 and invokes live setter1EC.|
|
||||
|471950/471960 /71950/71960|Live getter1E8/setter1EC read/write byte138. Property10 and live138 are separate fields.|
|
||||
|47059C..4705A9 /7059C..705A9|Generic Init470540 restores live138 through1EC from propertyC4. It does not infer alignment from landing or input ownership.|
|
||||
|
||||
Crucially, the ordinary Player constructor explicitly disables this path:
|
||||
43729E clears EBX;437332 installs the active Player game table4AF6C4;437426
|
||||
pushes EBX=0 and437429 calls471090. The active constructor table's1EC resolves
|
||||
471960, as does the eventual Jimmy table4A373C. Thus both property10 and live138
|
||||
are set false. The inspected constructor interval contains no intervening EBX
|
||||
assignment; its callees follow the recovered x86 nonvolatile-register convention.
|
||||
Subsequent generic Init restores the false property into live138. This is a
|
||||
positive constructor/Init chain, not an assumption from the old null-context probe.
|
||||
|
||||
This does **not** prove no uninspected runtime path ever changes the property.
|
||||
The previously recovered Carl camera preparation/STOP/DEFAULT boundaries do not
|
||||
supply such a write. Enabling this surface-alignment path for Jimmy, or using it
|
||||
as a new cutscene-exit leveling rule, would therefore introduce unsupported state.
|
||||
The generic normal-angle helper's existing Scooter observations remain separate
|
||||
from whether Jimmy is eligible to invoke it.
|
||||
|
||||
## The supplied static lab terrain takes the ordinary callback path
|
||||
|
||||
The authoritative `omt/level1b.omt` SHA256 is
|
||||
`5a33d11311fc222631eb8f7384d1863192cb1f55f7e67035caa0ae12fd9892ab`.
|
||||
Using the existing bounded OMT parser and source shape/checkpoint exclusions,
|
||||
the helper inventories2869 polygons,2851 eligible for static registration.
|
||||
Among eligible polygons,2526 have texture references with IDs0..30 and325 have
|
||||
no texture. The report retains counts, shape IDs/names, original payload offsets
|
||||
and payload hashes. No texture ID is guessed from the port's material index.
|
||||
|
||||
44E030 requires both linked record and payload. It reads polygon material+0C,
|
||||
then the material's texture-definition ID+8; missing material/payload bypasses
|
||||
the callback's state paths. All identified static-lab IDs0..30 fall below its
|
||||
first special selector range50..55, so they select ordinary surface sound5 at
|
||||
44E407. This excludes the callback's higher-numbered lava/ground-hazard branches
|
||||
for **that supplied static geometry**.
|
||||
|
||||
When desired surface sound changes,44E426 invokes Jimmy **complete**1E4→42AEC0.
|
||||
That method stops/restarts an existing floor-loop handle at completeA44 only if
|
||||
the prior handle is valid. It writes the new handle, without touching either
|
||||
Euler vector, mode704 or turn614. This is distinct from game-interface1E4, which
|
||||
is another field accessor. The ordinary path supplies no movement reset and
|
||||
does not grant/remove raw control.
|
||||
|
||||
This is not a complete runtime collision-world inventory. It does not prove the
|
||||
provenance of a retained338 context, rule out additional runtime geometry or
|
||||
dynamic interactions, or execute the full original body/derived Jimmy frame.
|
||||
The old Bubble floor component investigation already covers this same callback
|
||||
with explicit synthetic dependencies; another duplicated finite negative probe
|
||||
would not establish the missing original Carl entry/resume state.
|
||||
|
||||
## Transform publication does not conditionally hide the bank
|
||||
|
||||
The later473770 pass calls each game interface3DC and3E0, **not3C8**.
|
||||
Jimmy3C8→4235B0 is the separate supervisor/editor update selected by470280 when
|
||||
app+8C is set. It must not be described as normal render synchronization.
|
||||
|
||||
For Jimmy,3DC→4624B0 copies current logical/body XYZ into complete44/48/4C.
|
||||
3E0→4624F0→473540 reads current Euler, converts each degree axis to masked
|
||||
14-bit angle units, then3E4→462500 writes complete50/52/54. These routines do
|
||||
not test raw control, movement mode, animation name or cutscene state, and do
|
||||
not replace current or destination Euler. Previously verified OMT hierarchy
|
||||
construction consumes those cached pitch/yaw/roll angles. The known publication
|
||||
path therefore provides no scene-return branch that conceals a residual bank.
|
||||
Whole-world parent transforms, full morph playback and final render flags remain
|
||||
separate from the already-probed identity-parent/unit-scale contract.
|
||||
|
||||
## Result, implementation and remaining observation
|
||||
|
||||
The optional body-context bridge contains a real current-Euler writer, but the
|
||||
ordinary Jimmy constructor/Init disables its alignment gate. The identified
|
||||
static lab terrain path affects surface audio, not banking state. The normal
|
||||
logical→visual synchronization publishes current pitch/roll rather than dropping
|
||||
them. These facts close specific omissions in the composed return explanation;
|
||||
they do not explain the user's upright whole-original return or justify a new
|
||||
reset. Keep the existing playable port unchanged until actual original entry,
|
||||
registry placement and resumed input state are measured.
|
||||
|
||||
Integration follow-up: [the menu/player lifetime chain](main-menu-player-lifetime.md)
|
||||
subsequently establishes retained player-before-input order for successful original
|
||||
TSK story entry. The resulting correction changes that entry classification; it
|
||||
does not enable this optional surface-alignment gate or alter visual publication.
|
||||
|
||||
Verification is static: source hash/site/binding/range checks, revalidated prior
|
||||
transform contracts and complete supplied-static-lab polygon inventory. No new
|
||||
original execution, native Windows comparison, runtime edit or commit is made.
|
||||
|
||||
```sh
|
||||
python3 tools/binary/jimmy_body_transform_return.py ../Original \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--output artifacts/jimmy-body-transform-return
|
||||
```
|
||||
@@ -0,0 +1,84 @@
|
||||
# Carl contact and conversation entry
|
||||
|
||||
2026-11-05. This investigation closes the local contact/admission boundary. It does **not** identify a source-supported fix for the bank returning after skipping Carl. Physical collision admission, the complete task callback graph, and the complete skip/resume frame remain separate boundaries.
|
||||
|
||||
## Evidence and reproduction
|
||||
|
||||
Original `Neutron.exe` SHA-256: `f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`. Retained REA disassembly: `artifacts/jimmy-movement-audit/rea-original-disassembly.json`, evidence `ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`. JN-Engine was used as an index; executable bytes and actual GAM fields establish the statements below.
|
||||
|
||||
Read-only guard/generator: `tools/binary/jimmy_carl_entry.py`. It checks the executable identity, direct calls, virtual bindings and instruction sites, records original file offsets/range hashes, and can retain bounded REA extracts. All addresses here are preferred-base VAs. For the cited executable text/data sites, raw file offset is VA minus `0x400000`; the helper calculates offsets from PE sections rather than assuming this mapping.
|
||||
|
||||
```sh
|
||||
python3 tools/binary/jimmy_carl_entry.py ../Original \
|
||||
--rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--generate-probe artifacts/jimmy-carl-entry/native \
|
||||
> artifacts/jimmy-carl-entry/source.json
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra \
|
||||
-o artifacts/jimmy-carl-entry/native/probe.exe \
|
||||
artifacts/jimmy-carl-entry/native/jimmy_carl_entry_probe.c
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-carl-entry/native/probe.exe \
|
||||
--probe-success JIMMY_CARL_ENTRY_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-carl-entry/probe
|
||||
```
|
||||
|
||||
The generator compiled without warnings. The copied-original component ran under Wine in the existing network-disabled namespace, with `Original/` unmounted. `artifacts/jimmy-carl-entry/probe/wine.log` reports 96 passing cases and `JIMMY_CARL_ENTRY_COMPLETE`; `capture.json` records exit 0. This is **isolated original component execution**, not native Windows/full original gameplay verification. Originals were not executed in place or changed.
|
||||
|
||||
## Recovered contact and talk ownership
|
||||
|
||||
Carl's game interface is complete-object `+0xC0`. Its game vtable `0x495364` binds contact slot `0x40` to `0x40A3C0`, ordinary actor update `0x3C4` to `0x41B950`, and velocity preparation `0x410` to `0x40A6B0`. Its complete vtable `0x495804` binds state setter `0x124` to `0x4089B0`, talk `0x140` to `0x41B7B0`, trigger resolution `0x17C` to `0x41BB20`, and progress callback `0x180` to `0x413E50`.
|
||||
|
||||
| Boundary | Original evidence | State and dependencies |
|
||||
|---|---|---|
|
||||
| Physical notification gates | `47A46E/47A48F`, `47A4AA/47A4BD` | Both actors' game220 bind471A30 (own byte140 collision-enable); both game3A0 bind472F80 (`mov al,1; ret4`). Thus these pair-permission callbacks contain no raw-control, current-action or support admission check. Game178 on both binds471720 (own collision-kind124); kind2 selects47A5E0, otherwise47B3E0. Geometry/actual values remain a separate boundary. |
|
||||
| Contact prelude | `40A3CD→470A90` | Own slot `3C→470A60` checks duplicate membership in own contact list. Own deletion byte `+6` can suppress list append. Appends contacted pointer to own `+260` list and increments `+264`. Own `+408` may receive current-game callback `144`; lab complete table `4C3CD0+144→475D40` is exactly `or eax,-1; ret8`, with no actor side effects. |
|
||||
| Target admission | `40A44C..40A460` | Reads **Carl game+600** target; requires non-null and exact identity with incoming contacted game pointer. This is not a raw-controlled-pointer requirement. |
|
||||
| Talk-ready transition | `40A676..40A693` | Requires **Carl game+608 == 6**; invokes **Carl complete slot124(0)**. No support getter, Jimmy mode/turn write, target velocity/root/Euler store, distance threshold, or vertical threshold occurs in this branch. |
|
||||
| State ownership | `4089E5..408A04` | Setter copies own complete `+6C8` to `+6CC`, then writes requested state to `+6C8` (game+608). Complete byte `+970` can suppress state0/6 assignment. State0 tail `408B44..408B90` prepares/animates the NPC if its own flags permit it. |
|
||||
| AI before talk | `41B95D→408000`; `41B972..41B988` | Friend update runs inherited AI, increments own timer, then reads **resulting own AI state**. State0 dispatches complete140. It is not a test for a null target pointer. |
|
||||
| AI state0 dependencies | `408438..4084FC` | Reads target's **game+49D** targetability/invisibility flag at `40847C`; uses own facing/AI helpers and own distance/range data; can restore own state6/2. This is not Jimmy's support flag. The inherited update includes gates and indirect own AI callbacks; the native probe below does not execute this whole update. |
|
||||
| Conversation trigger selection | `41BB20..41BC1F` | Up to five named trigger lookups through `474070`; TalkState must not be `-1` and must equal own complete+554 task state or wildcard `-2`. No Jimmy support query. |
|
||||
| Progress before activation | `41B7CD→Carl413E50→41B810` | Base awards score100 through `42ADC0`, then invokes **Carl game410→40A6B0**, which sets **Carl velocity** to zero through own game2C4. It does not prepare Jimmy. Carl then advances `SCENE50→60` (other paths65→70,270→280) through `45F990`. Task notifications remain a separate dependency. |
|
||||
| Synchronous camera activation | `41B7D3..41B7D8` | Invokes resolved trigger's game slot5C with that trigger as argument. Only after it returns, `41B7DD..41B7FA` increments NPC talk counter, clears own elapsed timer, sets own AIstate9, and stops own animation. |
|
||||
| Jimmy counterpart contact | game table `4A373C+40→422D30`; `422D50→470A90` | Jimmy also receives a contact callback. Its subsequent concrete-type ladder tests pendulum, vehicles, projectile/enemy classes, button, AIT and load-level. It has no Carl/friends/AI generic test. Carl matches none of those concrete classes, so the C3DLOADLEVEL false branch `4232D0→423563` finishes without mode/turn/Euler preparation. This is static path analysis, not execution of the counterpart in the finite probe. |
|
||||
|
||||
The optional marker logic earlier in contact (`40A3E7..40A44C`, own game+8CD) has raw-controlled/Goddard identity handling and NPC marker/animation writes. It is separate from the state6 exact-target admission branch and supplies no Jimmy grounding gate. The state4 branch transforms relative positions/directions into **NPC-owned** fields; state6 does not execute it.
|
||||
|
||||
Actual `level1b.gam`, SHA-256 `316fff40db565c2add5b07cbccdef640ddb67c64d6625fea1429ce2a0542a234`, binds Carl at raw `0x1455` to target `Jim1`, TaskName `SCENE`, initial AIState9, and TalkState0=50/TalkTrigger0=`neutron1a`. Jimmy at raw `0x8` has TaskName `none`, RequiredLevel0, ExactLevel/RemoveLevel `-1`. `neutron1a` MCA at raw `0xE0B` names PlayerControlled=`JIM1`, NextTrigger=`carlwalk`. Carlwalk AIT at raw `0x1AFD` targets `C3DCARL`, sets AIState3 and chains `default`; it does not change Jimmy root/yaw. The helper retains these actual entity fields and entity file offsets.
|
||||
|
||||
## Finite component result
|
||||
|
||||
`jimmy_carl_entry_probe.c` executes complete original contact `40A3C0`, base `470A90`, actual duplicate-list predicate `470A60`, state setter `4089B0` and lab callback `475D40`. It uses synthetic complete objects/vtables, a native allocator adapter, a false-returning incoming type-query adapter, and NPC animation/preparation adapters. Original constructors, dynamic collision admission, AI update, task callbacks, trigger resolution, camera activation and skip are outside the probe.
|
||||
|
||||
Across 96 combinations of incoming target identity, own AIState6/3, raw-controlled identity, Jimmy mode0/1, Jimmy turn `-12/0/+12`, and synthetic support0/1:
|
||||
|
||||
- Actual base contact appends one contact node.
|
||||
- Own state becomes0 exactly when contacted target matches and own state was6.
|
||||
- Own state0 idle preparation/animation callbacks occur in those cases.
|
||||
- The entire `0x1F00`-byte synthetic Jimmy object remains unchanged, including mode, turn, bank and Euler destination.
|
||||
- Jimmy support virtual218 is never queried. The synthetic support value is a callback experiment, not a claim about a recovered physical-support field.
|
||||
|
||||
This confirms the local source reading: adding a grounded-only Carl-talk gate or resetting Jimmy mode/turn in the contact callback has no support in this recovered boundary. It does **not** prove the physical pair engine admits every airborne trajectory or that the full conversation activation frame leaves Jimmy unchanged; camera activation itself has its recovered orientation suffix.
|
||||
|
||||
## Startup/reuse hypothesis audit
|
||||
|
||||
A proposed explanation for the original/port difference was that original New Game might preload the lab behind the main menu, leaving a reusable Jimmy before the first playable lab controller. The inspected startup gives no positive support for that explanation:
|
||||
|
||||
| Source chain | Observation |
|
||||
|---|---|
|
||||
| `46A641→46B160`; `46A654` | Constructs application and stores global509980. |
|
||||
| `46A65B` pushes MAIN; `46A660→46A310→46A33D/44D0E0` | Startup selects a constructed MAIN controller. |
|
||||
| `44D122→459110→459168/44D2B0→44D306/4745A0` | Constructs CMainMenu using Jimmy-game/generic-game base constructors. Installs complete4D1070/game4D0C0C; class literal4F291C is `CMAINMENU`. This is not a level1b GAM load. |
|
||||
| `4591C3→4749A0→completeB4/44D3D0` | Menu InitGame clears task list through45F4C0, initializes world/camera defaults through474A10, sets own lifetime fields; no direct Jimmy constructor or lab request here. |
|
||||
| `44D139` app118→46F760; `44D149` app12C(3)→46F830 | Opens resource database and creates a 2D image from it, respectively. These bounded bodies do not load a lab or construct Jimmy. |
|
||||
| `404B4F..404B54` | Actual menu New Game item pushes string4EC71C (`NewGame.tsk`) and calls460E70. It then changes own menu/current-game state. |
|
||||
| `40D089..40D08E` | The other executable reference to NewGame.tsk is the script RESTARTGAME action. |
|
||||
| `45B1E2→422160` | Sole direct `C3DJimmy` constructor call in retained executable disassembly is inside the generic object factory. |
|
||||
|
||||
**Inference limit:** this is a positive constructor/initialization chain and a bounded negative result for preload. Menu-frame event/deferred-task behavior and any attract/demo route have not been exhaustively executed here. The result does not certify initial full registry order, and does not justify changing the port's fresh/retained ordering. Existing loader reuse facts remain valid when a prior Jimmy actually exists.
|
||||
|
||||
## Remaining questions and implementation comparison
|
||||
|
||||
The current port approximates contact using a broad sphere and starts Carl talk from its actor update after player processing. Original physical contact notifications occur through47A430 before ordinary registry updates; Carl's own talk then occurs from41B950 after its inherited AI update. Their relationship to Jimmy's update depends on actual registry order, collision state, and callback ownership; this report does not replace that schedule with a guessed global order.
|
||||
|
||||
Still unresolved: exact physical admission at the actual jumping contact; complete entry frame with task callbacks and source bodies; full MCA skip→Carlwalk→DEFAULT→first resumed input composition; and original first-play registry order at the user-observed case. No runtime implementation was changed by this investigation. Ordinary landing bank must remain until directly contradicted by evidence; contact preparation supplies no basis for a global upright clamp.
|
||||
@@ -0,0 +1,65 @@
|
||||
# Laboratory trigger and skip callback order
|
||||
|
||||
2026-11-05. Static original source/data recovery; gameplay changes are paused.
|
||||
Original EXE identity and retained REA Evidence are recorded in
|
||||
[jimmy-cutscene-return-source.md](jimmy-cutscene-return-source.md).
|
||||
`tools/binary/jimmy_cutscene_chain.py` verifies PE-mapped offsets, calls, virtual
|
||||
bindings and supplied GAM fields; generated output is
|
||||
artifacts/jimmy-cutscene-return/source-contracts/chain.json.
|
||||
|
||||
## Actual lab records
|
||||
|
||||
| Record / file offset | Source chain |
|
||||
|---|---|
|
||||
|3MCA neutron1a, GAM index7, E0B|Five active targets, beginning with JIM1, then Carl, Carl, Jimmy, Carl. PlayerControlledJIM1 is the completion target; DeactivateInv1; TargetDeactAnimSTOP; NextTriggercarlwalk.|
|
||||
|3AIT Carlwalk, index10,1AFD|AITargetC3DCARL, AIState3, no new position/yaw, PlayerControllednone, NextTriggerdefault. This record does not restore an old Jimmy transform.|
|
||||
|3AIT teleportexplanation,index34,6756|Touch activation byjim1, SCENE30 invokes te1; PlayerControllednone; te1→te2→TE3→te4→te5→default. This is a different entry path from Carl's friend talk.|
|
||||
|
||||
GAM hash316fff40db565c2add5b07cbccdef640ddb67c64d6625fea1429ce2a0542a234.
|
||||
All tags are looked up case-insensitively as in the existing bounded parser.
|
||||
|
||||
## Original partial order
|
||||
|
||||
Viewport47E554 calls global physics479BC0 before registry473740 at47E582.
|
||||
Physics invokes dynamic pair processing47A430 at479C83. Its enter callbacks
|
||||
47A555/47A578 dispatch slot40 before the later registry traversal.
|
||||
|
||||
- An AI trigger's interface is complete+C8:48F8C0+40→40C200, then40C21F
|
||||
synchronously dispatches40C300. A trigger can therefore activate a camera
|
||||
during the contact pass, before the game's ordinary input callback.
|
||||
- Carl's interface is complete+C0:495364+40→40A3C0. Its AI contact state may
|
||||
become0. The friend update41B950 first calls408000, then41B972..41B988
|
||||
invokes talk when the resulting state is0. In the fresh registry partial
|
||||
order, Carl follows Jimmy. Contact and actual conversation activation are
|
||||
separate boundaries.
|
||||
- Talk41B7B0 obtains a matching trigger, invokes Carl's progress callback,
|
||||
then41B7D8 dispatches the chosen trigger. Carl413E50 calls41B810 first
|
||||
(+100 score and **Carl's**410 preparation), then advances SCENE50→60.
|
||||
This does not by itself establish a Jimmy movement reset.
|
||||
- MCA update is game interface+C8 table4A8F64+3C4→430DA0. Natural completion
|
||||
and skip have different branches; skip writes Jimmy's action latch and
|
||||
shared skip flag before completing through4A93C8+E4→4311F0.
|
||||
- Source registry473740 dispatches each object's slot10 at473758. Actor
|
||||
insertion order matters for same-frame control changes. Fresh and retained
|
||||
routes must not be collapsed into a single assumed order.
|
||||
|
||||
The port's director.Touch/SceneInteractions calls occur after the combined
|
||||
player update in Program. This is a documented scheduling approximation; it
|
||||
cannot prove the original starts a conversation with identical support/mode/
|
||||
turn state. The original dynamic admission/support and callback positions need
|
||||
comparison before that difference can be called the tilt's source cause.
|
||||
|
||||
## Missing proof and next trace
|
||||
|
||||
The user specifically reports **skipping Carl**, not a measured natural-end
|
||||
comparison. The diagnostic also reproduces natural-end failures in the port,
|
||||
but that is not evidence about original natural completion. Required original
|
||||
trace points are: physical contact, final Jimmy callback before activation,
|
||||
MCA entry, accepted skip, completion/DEFAULT, next game input and next Jimmy
|
||||
update. At each point record raw owner, support, mode, turn, current/target
|
||||
Euler, dirty and input suppression/latches. This will distinguish an entry-state
|
||||
mismatch from a return/scheduling mismatch.
|
||||
|
||||
Current static conclusions and managed traces are useful evidence, but neither
|
||||
supplies a source-justified reset location. No gameplay change is introduced by
|
||||
this report or its read-only guard.
|
||||
@@ -0,0 +1,97 @@
|
||||
# Focused decompilation checkpoint: cutscene lifecycle
|
||||
|
||||
Follow-up: the source gate for successful TSK story entry is now closed by
|
||||
[menu/player lifetime](main-menu-player-lifetime.md). BackgroundJimmy is reused
|
||||
before the first playable game, making input follow his update. Program's initial
|
||||
story order is corrected; camera preparation/landing algorithms are unchanged.
|
||||
First-neutral-tick/300-idle native Vulkan and eight managed trajectories pass.
|
||||
The investigation below records the earlier open state; whole-original/native
|
||||
Windows comparison and integrated package validation remain separate.
|
||||
|
||||
2026-11-05. User redirects work toward understanding the original before further
|
||||
implementation. Preserve runtime baseline a2e89c6 and packaged runtime dae13ac.
|
||||
No src/, regression test, build script, original or packaged binary changes are
|
||||
part of this checkpoint. New work is read-only diagnostics and source findings.
|
||||
|
||||
2026-11-06 continuation: [integrated lifecycle trace](jimmy-cutscene-lifecycle.md)
|
||||
records292 additional bounded original-code cases and complete DEFAULT recovery.
|
||||
Known original components reproduce the port's order-sensitive first stale writer;
|
||||
contact/task/STOP/ordinary animation paths supply no new reset. A copied-original
|
||||
read-only observer is implemented and its Wine32 attach path verified. Local
|
||||
original rendering still supplies no Jimmy/Carl gameplay trace. The source gate
|
||||
remains open; preserving exact original behavior takes precedence over forcing
|
||||
the diagnostic upright with an unsupported reset.
|
||||
|
||||
## Confirmed requirement and corrected coverage
|
||||
|
||||
User comparison confirms ordinary landing can leave Jimmy banked in the original.
|
||||
The reported port-only failure is specifically after **skipping Carl's lab
|
||||
conversation**: Jimmy must remain upright when control returns, including idle.
|
||||
The earlier correction proved camera-entry current/destination flattening and
|
||||
locked continuation. It did not prove resumed **neutral** input stays upright.
|
||||
Its held movement/jump resumption check cannot certify that missing boundary.
|
||||
The post-skip bug is open; do not classify it as the original landing quirk.
|
||||
|
||||
## Findings this pass
|
||||
|
||||
- [48-case port trace](jimmy-cutscene-port-trace.md): all24 fresh-order cases
|
||||
republish a stale air-bank target on the first neutral input; all24 retained-
|
||||
order cases remain upright. The player is grounded by return. This isolates
|
||||
the first port writer, not a source-justified fix.
|
||||
- [Original return/skip boundaries](jimmy-cutscene-return-source.md): raw control
|
||||
grants, DEFAULT and no-selection cleanup do not supply the hypothesized mode/
|
||||
turn reset. Original skip does write Jimmy's shared input latch and a global
|
||||
skip flag, with per-camera completion/resource behavior absent from the port's
|
||||
immediate fast-forward model. Its causal role in upright return is unproven.
|
||||
- [Source chain and registration order](jimmy-cutscene-chain-order.md): the actual
|
||||
GAM chain is neutron1a→Carlwalk→default. AI trigger contact can dispatch during
|
||||
physics; Carl contact first sets state, with conversation activation in his
|
||||
later actor update. The port's post-player contact grouping is an approximation.
|
||||
- Three fresh REA/Ghidra pseudocode results and the existing full instruction
|
||||
Evidence corroborate the focused source contracts. DEFAULT's unrecognized
|
||||
procedure remains an explicit provider gap; assembly/byte guards support the
|
||||
bounded statements. Complete Evidence is retained locally and sessions closed.
|
||||
|
||||
These findings improve the interaction model. They do not establish that the
|
||||
original enters/ends the scene with the same support/mode/turn values as the port.
|
||||
No additional rotation reset or blanket ordering switch is implemented.
|
||||
|
||||
## Recovery gate before implementation
|
||||
|
||||
1. Trace the original Carl route from physical enter to talk activation, then
|
||||
accepted Escape/Space skip, completion/DEFAULT and the first idle callbacks.
|
||||
Record support, raw owner, current/destination Euler, dirty, movement mode,
|
||||
turn, shared skip, action latch and relevant input suppression at each boundary.
|
||||
2. Close source actor/input ordering for the observed fresh and retained route,
|
||||
including deferred callbacks and contact/support eligibility. Explain where
|
||||
the source avoids the demonstrated first stale write. A local no-reset finding
|
||||
or a synthetic component outcome does not substitute for that explanation.
|
||||
3. Compare a bounded original composition/runtime trace with the reproducible
|
||||
port failure. Keep original instructions, inference and user observation
|
||||
separate. Cover skip and natural end independently; user observation here
|
||||
specifically concerns skip.
|
||||
4. Implement only the directly supported missing owner/transition/order after
|
||||
this gate closes. Verify first idle frame and sustained idle after skip in
|
||||
both orders, held-input resumption, normal landing bank, and existing scene/
|
||||
body/fire behavior. Preserve original state rather than clamping every frame.
|
||||
|
||||
This is a focused investigation pass, not a requirement to decompile every
|
||||
level before resuming implementation. Broader movement/contact/animation recovery
|
||||
continues after its state and verification boundaries are made explicit.
|
||||
|
||||
## Verification and remaining work
|
||||
|
||||
The source guards for return and chain complete against the original identity;
|
||||
the managed diagnostic compiles and records48 port cases. Its sources and traces
|
||||
have SHA256 provenance under artifacts/jimmy-cutscene-return/port-trace/.
|
||||
Original hashes and production-source identity are verified before publishing
|
||||
this research checkpoint. Existing packages remain the earlier baseline.
|
||||
The original skip-to-idle causal explanation remains unresolved; no full original
|
||||
frame or new native Windows parity is claimed.
|
||||
|
||||
Final checkpoint verification: chain guard passes6 direct calls,11 instruction
|
||||
sites,6 virtual slots,11 ranges and8 actual GAM records; return guard passes12
|
||||
sites,12 slots and13 ranges. The48-case diagnostic's recorded source/output
|
||||
hashes match.539 original files remain unchanged. A diff against a2e89c6 confirms
|
||||
no changes under src/, tests/ or scripts/. These checks do not certify the missing
|
||||
original skip-to-idle frame; that remains the next source-recovery task.
|
||||
@@ -0,0 +1,94 @@
|
||||
# Carl skip lifecycle: recovered boundaries and the remaining observation
|
||||
|
||||
Follow-up: [menu/player lifetime](main-menu-player-lifetime.md) resolves the
|
||||
successful TSK story entry ordering omitted by this earlier checkpoint. The port
|
||||
now includes first story entry in retained Jimmy-before-input order. Its baseline
|
||||
native regression fails on neutral tick0 and passes first input plus300 idle ticks
|
||||
with the correction. No additional movement/angle reset is introduced.50 derived-
|
||||
caller source cases and the body/visual-sync audit close other local omissions;
|
||||
the historical findings below remain scoped to their earlier evidence. Full
|
||||
original/native Windows gameplay comparison is still unverified.
|
||||
|
||||
2026-11-06. Execution of the accepted next-work plan, with the user's requirement
|
||||
to preserve original behavior exactly. Runtime a2e89c6 and packages dae13ac remain
|
||||
unchanged. This checkpoint adds evidence and observation tools, not a tilt fix.
|
||||
|
||||
## Event/state trace
|
||||
|
||||
Original source identity, PE offsets and REA Evidence are in the linked reports.
|
||||
These rows combine static facts and explicitly synthetic original-code execution;
|
||||
they are not a captured whole-original frame sequence.
|
||||
|
||||
| Boundary | Recovered state ownership | Evidence / remaining limit |
|
||||
|---|---|---|
|
||||
|Dynamic contact→Carl state0|Matching target and Carl state6 admit the talk-ready transition. Jimmy is not modified and support is not queried by that callback.|[Contact report](jimmy-carl-entry.md):96 native cases; actual physical trajectory/admission and whole AI update are separate.|
|
||||
|Carl talk→SCENE50→60→neutron1a|Task assignment/broadcast precedes the synchronous camera trigger. Jimmy's authored TaskName is `none`. All89 authored SCENE listeners across17 kinds are inventoried; six callback paths do not supply another Jimmy movement reset.|[Task report](jimmy-task-return.md): static callback closure and48 native dispatcher/objective cases; actor callbacks in that probe are adapters.|
|
||||
|MCA initial preparation|StopMotion clears speed/velocity independently of STOP animation acceptance. Both current and destination Euler become(0,currentYaw,0); dirty is preserved. Raw control is removed.|Earlier20 camera-entry cases; [full STOP/base report](jimmy-base-return.md) supplies the omitted selection/completion dependencies.|
|
||||
|Uncontrolled interval|Known controller ownership gate retains mode1/stored turn. Actual base/facing and ordinary STOP/talk/FALL completion provide no reset. Playback/resource state is distinct from movement mode.|140 native base/STOP cases. Full body context, complete Jimmy frame and OMT playback remain outside these probes.|
|
||||
|Accepted skip|Original sets Jimmy action/menu latch complete1E00 and shared skip4F83E4; stops sound, deactivates current actor/animation and invokes completion.|[Return source](jimmy-cutscene-return-source.md); actual skip prefix is executed by the composition. The complete skip frame is not.|
|
||||
|MCA completion→Carlwalk→DEFAULT|Completion grants named JIM1; Carlwalk changes Carl's AI. DEFAULT's already-owned early branch clears shared skip/resources, with no new Jimmy reset.|[Complete DEFAULT recovery](jimmy-default-decompilation.md) closes the previous provider-boundary gap using an explicitly mapped static carrier.|
|
||||
|First resumed callback|On synthetic supported/released state, input-before-player republishes stale roll before the controller clears mode/turn. Player-before-input clears those fields first and stays upright.|[Composition](jimmy-skip-composition.md):8 actual original-component cases agree with48 port traces. This does not establish the original route's actual entry state/order/delta.|
|
||||
|
||||
At the problematic composed boundary the seed is mode1, turn±11.666668,
|
||||
current/destination(0,155,0), supported=true and dt1/60. Fresh input reduces turn
|
||||
to±10.000001 and publishes the opposite roll. The next controller clears mode
|
||||
and turn; neutral ground input then retains the banked destination. Skip-prefix
|
||||
latch writes do not change this result. These values are measured synthetic
|
||||
component inputs/results, not values measured from the original Carl route.
|
||||
|
||||
## What this permits and what remains unresolved
|
||||
|
||||
The first stale port writer is known. Its arithmetic also occurs in the composed
|
||||
original routines, so adding a reset to raw control grant, DEFAULT, Carl contact,
|
||||
task broadcast or ordinary animation completion would lack source support.
|
||||
The user's observation that the original stays upright remains authoritative;
|
||||
the actual original state/order entering that first input is still missing.
|
||||
Normal landing bank must remain intact. No per-frame leveling, scheduler switch
|
||||
or input suppression has been introduced to make the diagnostic green.
|
||||
|
||||
The fresh-construction order is a conditional source fact, not a runtime trace
|
||||
of the user's route. Startup inspection constructs MAIN directly and supplies
|
||||
no positive lab-preload/reusable-Jimmy explanation. A new read-only observer can
|
||||
record real registry positions, raw ownership, mode, turn, current/destination
|
||||
Euler, dirty, cached support, viewport delta and input/skip flags. Its samples
|
||||
are non-atomic and cannot alone certify exact callback chronology.
|
||||
|
||||
## Runtime observation tool and local limit
|
||||
|
||||
[Original-state observer](original-state-observer.md) supports launch or attach
|
||||
to a verified generated game copy. It never writes actor memory or injects code.
|
||||
The attach path leaves the observed game running. Three exact executable profiles
|
||||
have24 independent instruction guards; the supplied HDnoCD variant has its own
|
||||
REA Evidence and global addresses, rather than assumed canonical equivalence.
|
||||
|
||||
The local Wine32 attach integration passes:928 parsed samples, source guards
|
||||
accepted, observer exit0, original still running after sampling. Provenance is
|
||||
`artifacts/original-state-observer/attach-runtime/observations.json`. The legacy
|
||||
window remains black; observed registry contains MAIN and no Jimmy, with viewport
|
||||
delta0. Focus/normal Return input and an isolated desktop also failed to reach a
|
||||
usable gameplay reference. Neither accepted input events nor MAIN's zero gameplay
|
||||
delta proves a menu selection or a whole-game timing fault. Native Windows and
|
||||
the actual Carl skip were not observed by this work.
|
||||
|
||||
To collect the missing comparison on native Windows, run a **copied** original,
|
||||
reach Carl, then attach for the banked entry/skip/neutral-return interval:
|
||||
|
||||
```text
|
||||
observer.exe --attach-copied-pid=1234 --seconds=60 > carl-original.jsonl
|
||||
```
|
||||
|
||||
Use the copied game's actual PID. Keep its path outside an `Original` directory;
|
||||
the tool checks the actual executable identity/path and refuses unsupported
|
||||
images. No automatic keys or close request are sent in attach mode. If the trace
|
||||
misses the first transition, a narrower callback-level observation is required;
|
||||
do not fill it with an inferred reset.
|
||||
|
||||
## Checkpoint status
|
||||
|
||||
292 new bounded original-code cases pass:96 contact,8 input/controller/skip-prefix
|
||||
composition,48 task/objective and140 base/STOP. They deliberately have different
|
||||
synthetic dependencies. The48 port diagnostic cases still describe the preserved
|
||||
failure, not successful gameplay. The mapped DEFAULT carrier regenerates exactly;
|
||||
539 original files remain unchanged. No src/tests/scripts or package change is
|
||||
part of this checkpoint. Steps1–2 of the next-work plan remain open at the actual
|
||||
original resumed-frame observation; step3's gameplay correction gate is not met.
|
||||
@@ -0,0 +1,106 @@
|
||||
# Post-cutscene tilt: existing-port trace
|
||||
|
||||
2026-11-05. User confirms ordinary landing tilt also occurs in the original,
|
||||
but Jimmy must remain upright after a cutscene. The earlier camera-entry fix
|
||||
does not cover that resumed-idle boundary. Gameplay implementation is on hold
|
||||
while the full original lifecycle is investigated.
|
||||
|
||||
## Scope and reproduction
|
||||
|
||||
This is **port runtime evidence**, not execution of original functions or a
|
||||
decompilation claim. Baseline is `a2e89c6`, with unchanged production sources.
|
||||
The read-only diagnostic at `tools/recon/cutscene-handoff-trace/` compiles the
|
||||
existing Assets/Game sources into its own managed executable. It creates the
|
||||
same synthetic flat-floor player as DirectorTests and runs either a synthetic
|
||||
CAM or the actual supplied lab `neutron1a` MCA chain with a deterministic
|
||||
two-second-per-speech clock. There is no GPU, SDL, full original scene collision,
|
||||
or original executable execution in this diagnostic.
|
||||
|
||||
All48 cases complete successfully:
|
||||
|
||||
| Input/player order | Cases | Retilt after300 neutral ticks |
|
||||
|---|---:|---:|
|
||||
|Input before player update (fresh order)|24|24, approximately ±10 degrees|
|
||||
|Input after player update (retained order)|24|0|
|
||||
|
||||
Each order covers both camera types, Left/Right bank, natural completion/Skip/
|
||||
explicit DEFAULT, and jump/movement held or released during control lock. Each
|
||||
case creates eight real controlled banked-jump ticks, triggers the camera,
|
||||
waits until the body is grounded while control remains NULL, completes the
|
||||
camera, then supplies **neutral** input for300 ticks. Held input during the lock
|
||||
does not change the result because input/controller phases remain gated there.
|
||||
|
||||
The native camera source recovery belongs to
|
||||
[camera orientation ownership](jimmy-cutscene-rotation-source.md), not this
|
||||
managed probe. Its original addresses are not substituted for port execution.
|
||||
|
||||
## First stale writer
|
||||
|
||||
Representative actual lab MCA case: fresh order, Left bank, natural completion,
|
||||
released controls during the scene:
|
||||
|
||||
| Boundary | Current Euler | Destination Euler | Mode / turn |
|
||||
|---|---|---|---|
|
||||
|Before trigger|(343.17676,1.3944445,357.05692)|(-40,1.2,-11.666668)|1 /11.666668|
|
||||
|After camera preparation|(0,1.3944445,0)|(0,1.3944445,0)|1 /11.666668|
|
||||
|Grounded during scene and after control returns|(0,1.3944445,0)|(0,1.3944445,0)|1 /11.666668|
|
||||
|First neutral input publishes|(0,1.3944445,0)|(0,1.3944445,-10.000001)|1 /10.000001|
|
||||
|End of first resumed player tick|(0,1.3944445,360)|(0,1.3944445,-10.000001)|0 /0|
|
||||
|End of300 neutral ticks|(0,1.3944445,350.00018)|(0,1.3944445,-10.000001)|0 /0|
|
||||
|
||||
The first old-angle write is the resumed input phase, observed through the
|
||||
existing `InputActions` event after `StepInput` publishes its target. It is not
|
||||
an old current-Euler vector restored by the director. The director grants
|
||||
control with the player still upright and facing clean.
|
||||
|
||||
In `LabSimulation.Step`, line279 dispatches fresh input before the player update
|
||||
at line290. `StepInput` selects the air branch using the retained mode1 at
|
||||
lines481–507, decays the old keyboard turn, and publishes the negative turn as
|
||||
destination roll. Only later does the supported/released `StepPlayer` reset
|
||||
mode/turn at lines555–560. Neutral mode0 input then retains the stale destination
|
||||
because it has no accepted heading update (lines487–491). Consequently the
|
||||
independent facing phase converges to that bank indefinitely. The first resumed
|
||||
tick's intermediate360-degree representation is preserved in the trace; the
|
||||
next tick visibly rotates toward the retained target.
|
||||
|
||||
With retained input-after-player ordering, `StepPlayer` resets mode/turn before
|
||||
input dispatch. That input sees mode0 and retains the already upright target;
|
||||
the bank never returns. This is a diagnostic distinction, **not evidence that
|
||||
all scenes should be forced into retained ordering**.
|
||||
|
||||
## Evidence files and commands
|
||||
|
||||
`artifacts/jimmy-cutscene-return/port-trace/observations.json` retains the48 full
|
||||
cases and selected boundary snapshots, including current/target/dirty, mode,
|
||||
turn, speed, support, raw owner, current camera, root, controller and physics
|
||||
counts. `summary.json` records per-order outcomes, baseline commit, source/harness
|
||||
SHA256 identities and the observation-file hash. `run.log` records successful
|
||||
completion. All are local generated outputs.
|
||||
|
||||
From GamePort:
|
||||
|
||||
```sh
|
||||
source scripts/env.sh
|
||||
dotnet run --project tools/recon/cutscene-handoff-trace/CutsceneHandoffTrace.csproj \
|
||||
-p:NuGetAudit=false -- ../Original \
|
||||
artifacts/jimmy-cutscene-return/port-trace/observations.json
|
||||
```
|
||||
|
||||
No runtime, regression test, build script, original file or packaged binary is
|
||||
changed. Parent owns integration and any eventual implementation decision.
|
||||
|
||||
## Implication and unresolved original questions
|
||||
|
||||
The confirmed port cause is a stale **air turn/movement mode** surviving camera
|
||||
preparation, then being consumed by the first fresh neutral input. An additional
|
||||
upright Euler write on DEFAULT alone would not explain or remove this first
|
||||
writer unless its timing/state ownership also changed. The correct original
|
||||
boundary must be established before implementing a reset or scheduling change.
|
||||
|
||||
Remaining questions belong to the independent original investigations: whether
|
||||
source control return lets the player update run before input in that same
|
||||
registry pass; whether camera activation/cleanup changes turn/mode through an
|
||||
unrecovered callback; and whether the actual trigger/registry ordering differs
|
||||
from the port's post-player interaction phase. This diagnostic does not answer
|
||||
those questions or certify that the original returns with the same retained
|
||||
state. Ordinary landing-idle tilt remains a separate confirmed behavior.
|
||||
@@ -0,0 +1,105 @@
|
||||
# Cutscene completion and first resumed input: original boundaries
|
||||
|
||||
2026-11-05. User comparison: ordinary landing tilt occurs in the original;
|
||||
**skipping Carl's laboratory conversation must leave Jimmy upright**. Gameplay
|
||||
changes are paused for source recovery. The previous camera-entry correction is
|
||||
preserved; it did not verify neutral input after the scene ended.
|
||||
|
||||
Original EXE SHA256:
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Retained REA full-instruction Evidence:
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
|
||||
VA400000 is the preferred base; the guard uses PE sections for file offsets
|
||||
(the cited text offsets equal VA minus400000). Originals are read-only.
|
||||
|
||||
## Recovered state owners
|
||||
|
||||
| Boundary / VA (file offset) | Original facts |
|
||||
|---|---|
|
||||
|Control118→475A40 (75A40)|Load argument, store raw controlled pointer5099E4, return. No actor, movement-mode, turn or orientation reset.|
|
||||
|DEFAULT447D34..447FC5 (47D34..47FC5)|Restores raw owner through118; handles shared camera eye/UI/music and clears shared skip. Inspected code has no direct Euler/mode/turn reset or Jimmy Init.|
|
||||
|MCA completion4311F0..43127F (311F0..3127F)|Resolves named PlayerControlled/NULL/none, grants through118, cleans resources and dispatches the next trigger. A grant is not initialization.|
|
||||
|Jimmy cleanup42AE00..42AE29 (2AE00..2AE29)|Calls complete178, sets game1D65 and global4F8182. No direct movement-mode/turn reset.|
|
||||
|Selected-gadget cleanup427FF0 (27FF0)|Raw-1 is rejected by the unsigned range guard428027; raw3's table entry also reaches common tail42882F. That tail only restores selected-gadget sentinel-1 and returns. Bubble/vehicle branches have separate policies.|
|
||||
|Menu prelude405FB0/406590 (5FB0/6590)|The inspected selection/close callbacks manipulate menu resources. They do not dispatch a recovered Jimmy movement reset.|
|
||||
|Player input438A60 (38A60)|Dispatches by retained game704, after raw-owner and camera-bump gates. Complete124 is ground438BC0;128 is air439900; no derived Jimmy air override supplies a hidden reset.|
|
||||
|Air target439DB7..439E33 (39DB7..39E33)|Accepted pitch/current yaw/negative stored turn become destination Euler. This is a writer, not a render-only cache.|
|
||||
|Grounded released controller437BA5/437BAC (37BA5/37BAC)|Clears mode704 and turn614 after the raw-ownership gate. Null ownership therefore leaves these fields retained.|
|
||||
|
||||
Jimmy complete object is game interface+C0. Game704/614 correspond to complete
|
||||
7C4/6D4. Current and destination Euler retain their previously recovered separate
|
||||
owners. Complete table4A3BDC slots124/128/12C/130/134/140 resolve438BC0/439900/
|
||||
43A120/437C40/437F90/429910 respectively.
|
||||
|
||||
Input callback426030 has independent gates:407060 reads global4F8198,475CA0,
|
||||
raw owner,4F8430 and game1D2D precede438A60. The bounded camera/default paths do
|
||||
not establish a special first-resume write to4F8430 or1D2D. Known1D2D writes
|
||||
belong to hit lock (complete1DED, set42A820/clear42567F). Camera bump7C8 can
|
||||
suppress dispatch, but no inspected camera/default write proves it is seeded
|
||||
here. These are ruled-out local explanations, not whole-program absence proofs.
|
||||
|
||||
## Skip is a distinct source path
|
||||
|
||||
The actual MCA update430DA0 tests a playing sound before entering its skip branch
|
||||
430EED..431027. Escape509853, Space509858, controller509AC4 or shared skip4F83E4
|
||||
can request it; nonzero4F8182 suppresses it. The accepted path resolves JIM1,
|
||||
sets **complete1E00=1 at430F37**, sets **shared4F83E4=1 at430F3E**, stops the
|
||||
sound, performs target-class/animation cleanup, deactivates the MCA, dispatches
|
||||
completionE4 at431012, and resets its shot index. CAM has the analogous latch/
|
||||
flag writes at41613B/416142 and its own completion order.
|
||||
|
||||
The Jimmy byte is the shared input-action/menu debounce latch recovered in
|
||||
[gadget controls](gadget-controls.md), not a recovered orientation-reset flag.
|
||||
No claim is made that copying this latch alone fixes the tilt. DEFAULT clears
|
||||
shared skip at447D91 or447F89. The port's immediate SceneDirector.Skip/Drain
|
||||
fast-forward does not represent these per-actor/registry/input-latch boundaries.
|
||||
Its earlier comment labeling it an original chain skip overstates that coverage.
|
||||
|
||||
## New REA pseudocode and limits
|
||||
|
||||
A generated EXE copy was opened by local REA/Ghidra12.1.4. Complete replies,
|
||||
Evidence export and closed snapshot are in
|
||||
artifacts/jimmy-cutscene-return/rea-completion/. New successful pseudocode:
|
||||
|
||||
| Procedure | Evidence |
|
||||
|---|---|
|
||||
|475A40 raw owner setter|ev_3e6ebc517bdc52a7c2cd8af4475b837f2e7126f5a54a45e147356784b4e93eb7|
|
||||
|438A60 retained-mode input dispatch|ev_77ee22e6d49adc0c983af92ba74273faf5f4daf697ab520ea45d22b08bc11bcb|
|
||||
|42AE00 cleanup wrapper|ev_2ee50b10018363378445be32df38ab4f6b2125247b69485304867674d5d484da|
|
||||
|
||||
DEFAULT entry447CF0 did not resolve to a Ghidra procedure in the original PE database; the provider then
|
||||
reported the numeric selector as an unmapped file offset. Its complete error is
|
||||
retained as00.json; no pseudocode is attributed to it. The guarded retained REA
|
||||
instructions support the DEFAULT statements above. No unchanged retry or claim
|
||||
that the whole original was executed follows from that provider result.
|
||||
|
||||
2026-11-06: a changed input strategy now supplies complete DEFAULT pseudocode
|
||||
through a separately mapped static raw carrier. Its Evidence subject and mapping
|
||||
are explicit in [the DEFAULT recovery report](jimmy-default-decompilation.md).
|
||||
The original PE function-boundary failure remains recorded; the carrier result
|
||||
agrees with the guarded instructions and supplies no additional Jimmy reset.
|
||||
|
||||
## Port cause versus original explanation
|
||||
|
||||
[The port diagnostic](jimmy-cutscene-port-trace.md) reproduces48 cases. On fresh
|
||||
input-before-player order, a grounded player returns with retained mode1/turn;
|
||||
first neutral air input republishes the old bank before the controller clears
|
||||
mode/turn. On retained order, the controller clears those fields first, avoiding
|
||||
that writer. This identifies a port cause. It does **not** prove that changing
|
||||
all scheduling or resetting turn on every control grant matches the original.
|
||||
|
||||
The complete original skip-to-idle frame has not been executed or fully closed.
|
||||
Remaining explanations include exact skip/input suppression, actor callback
|
||||
placement, contact/support state when the conversation starts and unmodeled
|
||||
wrappers. User observation takes precedence over assuming the local component
|
||||
composition describes the whole game. Further source recovery must explain why
|
||||
the original avoids the stale writer before another runtime patch is made.
|
||||
|
||||
## Verification
|
||||
|
||||
`tools/binary/jimmy_cutscene_return.py` checks original identity,12 source sites,
|
||||
12 virtual bindings and13 bounded spans. `jimmy_cutscene_chain.py` independently
|
||||
checks skip/contact/frame boundaries and actual lab records. Complete generated
|
||||
reports are under artifacts/jimmy-cutscene-return/source-contracts/.
|
||||
These are static byte/data checks. The48-case harness is managed port execution;
|
||||
no new original full-frame or native Windows observation is claimed.
|
||||
@@ -0,0 +1,102 @@
|
||||
# Jimmy cutscene rotation: source ownership
|
||||
|
||||
2026-11-05. User reports that jumping at an angle into cutscene triggers retains
|
||||
Jimmy's airborne tilt. This investigation identifies a direct source mismatch,
|
||||
not a new global "cutscenes upright" policy.
|
||||
|
||||
## Source and provenance
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
REA retained complete instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
|
||||
artifacts/jimmy-movement-audit/rea-original-disassembly.json, supplies the exact
|
||||
instruction windows. `tools/binary/jimmy_cutscene_rotation.py` independently
|
||||
checks original identity and seven complete instruction-range hashes; optional
|
||||
`--rea-disassembly` retains matching extracts in its generated source.json.
|
||||
Preferred VA400000; raw offsets below are VA minus400000, independently checked
|
||||
against PE section mapping. This uses existing REA evidence rather than repeating
|
||||
the previously unsupported native selectors.
|
||||
|
||||
## Recovered facts
|
||||
|
||||
Jimmy game interface is complete+C0. Current Euler is game224/228/22C/230,
|
||||
complete2E4/2E8/2EC/2F0. Destination Euler is game274/278/27C/280,
|
||||
complete334/338/33C/340. Byte game+A is facing dirty; byte+5 is facing enabled.
|
||||
|
||||
| Original boundary | Current and destination ownership |
|
||||
|---|---|
|
||||
|CAM NULL control:416671..4166EB, file16671..166EB|Read current full Euler through328 at41667E→4723F0. Build `(0,current.Y,0,current.W)`. Direct-write destination at4166A0..4166C9, then full current setter32C at4166E5→472450. Neither operation writes dirty or calls destination setter36C.|
|
||||
|Initial MCA:431518..431590, file31518..31590|Read328 at431525; build the same flat Vec4; write current32C at431565, then direct-write destination431578..43158D. Preserve dirty.|
|
||||
|Current full setter32C→472450, file72450|Copies all four values to game224..230; does not touch destination/dirty. Distinct from current XYZ setter330→472420.|
|
||||
|Destination XYZ setter36C→472660, file72660|Writes destinationXYZ and sets dirty+A=1. Camera suffixes bypass this setter; using it would introduce a dirty-state change absent from source.|
|
||||
|Facing43A420, file3A420|Global-ready475CA0, enabled+5, dirty+A gate. On acceptance, clears dirty first, compares before-step current/target axes, marks dirty for any unequal axis, adds per-axis angular deltas through334. Runs before Jimmy's raw-control gate437A1B.|
|
||||
|
||||
The old [preparation report](../checkpoint/cutscene-preparation.md) called
|
||||
game274 a "cached Euler". The later [target-state recovery](jimmy-air-target-state.md)
|
||||
identifies this same storage as the live facing destination. These camera writes
|
||||
therefore replace the **whole destination**, including Y with current Y; they do
|
||||
not merely cache an independent render rotation. Full W is copied too, though the
|
||||
port currently models orientationXYZ only.
|
||||
|
||||
CAM's broader order remains438 cleanup→410 stop→orientation writes→clear raw
|
||||
control. MCA starts410 stop→orientation writes→438 cleanup→clear raw control.
|
||||
Their prior-owner guards still apply. Initial MCA's first-name `none` guard exits
|
||||
before this path; subsequent shots do not repeat it. Generic AI NULL ownership
|
||||
40C4AD..40C527 only stops motion and clears control: **no flattening**. DEFAULT
|
||||
restores control without flattening/preparation. Animation STOP is also separate
|
||||
from these orientation writes. Do not flatten on every input lock, shot, action
|
||||
change, or missing controller tick.
|
||||
|
||||
## Port mismatch and implementation contract
|
||||
|
||||
At investigation start, LabSimulation.FlattenOrientation only set Pitch=Roll=0;
|
||||
it left destinationEuler at the airborne target. The newly restored full-Euler
|
||||
facing bridge legitimately runs while uncontrolled. Its next step therefore
|
||||
interpolates Jimmy back toward the stale airborne pitch/bank and possibly old
|
||||
heading. The source camera path overwrites that stale target at the handoff.
|
||||
|
||||
Replace currentXYZ and destinationXYZ with `(0,currentYaw,0)` on this existing
|
||||
FlattenOrientation boundary, preserving facingDirty/facingEnabled and all motion,
|
||||
impulse, jump/hold/fire and pitch seeds. Preserve named-authored/current writes as
|
||||
separate ownership; do not make arbitrary current setter writes reset destination.
|
||||
The existing CAM/MCA order and prior-owner guards remain authoritative. Parent
|
||||
owns integration and managed/native port checks.
|
||||
|
||||
## Verification boundary
|
||||
|
||||
The source guard passes against authoritative bytes. The bounded native probe
|
||||
executes the copied original orientation suffixes with the actual328/32C leaves,
|
||||
then the actual43A420 facing leaf and334 Euler-add chain, using synthetic owner
|
||||
storage/vtables and a forced-ready global facing gate. It does not execute game
|
||||
entrypoints, camera activation, actor registry, body, inputs, gadget cleanup or
|
||||
renderer. All execution is in the generated copy with Original unmounted and
|
||||
network disabled. All20 native cases pass (CAM/MCA × five initial Euler pairs × dirty0/1).
|
||||
Each suffix changes exactly the full current/destination vectors in the synthetic
|
||||
object; all other sentinel bytes, including enabled/dirty, are preserved. Before
|
||||
facing, current and target both equal `(0,oldCurrent.Y,0,oldCurrent.W)`; after
|
||||
one real facing pass dirty is0, and after30 passes the same upright vectors
|
||||
remain. Cases cover positive tilt, actual powered-flight-style wrapped tilt,
|
||||
negative tilt, heading359 with target1, and heading360 with target0. Initial
|
||||
current/targetW differ, proving the source copies currentW into both.
|
||||
|
||||
Artifacts: artifacts/jimmy-cutscene-rotation/build/source.json,
|
||||
probe/wine.log, probe/capture.json, native-observations.json. The JSON retains all
|
||||
before/prepared/after-facing/after30 vectors and dirty bytes for managed
|
||||
comparison. First3s capture only created the Wine prefix; repeating with12s allowed
|
||||
initialization and completed with exit0 and the required marker. This is a native
|
||||
original-component execution under Wine32, not whole-game/runtime Windows parity.
|
||||
|
||||
```sh
|
||||
python3 tools/binary/jimmy_cutscene_rotation.py ../Original \
|
||||
--rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--generate-probe artifacts/jimmy-cutscene-rotation/build
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-cutscene-rotation/build/jimmy_cutscene_rotation_probe.c \
|
||||
-o artifacts/jimmy-cutscene-rotation/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-cutscene-rotation/build/probe.exe \
|
||||
--probe-success JIMMY_CUTSCENE_ROTATION_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-cutscene-rotation/probe
|
||||
```
|
||||
|
||||
@@ -0,0 +1,60 @@
|
||||
# DEFAULT source recovery through a mapped analysis carrier
|
||||
|
||||
2026-11-06. This closes a provider function-boundary gap, not the Carl return
|
||||
behavior gate. No gameplay change follows from this result.
|
||||
|
||||
The original PE database did not recognize447CF0 as a function. Instead of
|
||||
repeating that failed selector, `tools/binary/default_raw_carrier.py` maps the
|
||||
verified EXE's initialized sections from VA447CF0 onward into a separate raw
|
||||
analysis file. It retains the original virtual spacing and zero-fills virtual
|
||||
tails/gaps. `mapping.json` identifies every source file range and carrier offset.
|
||||
This file is static analysis input; it is neither an executable nor a captured
|
||||
process image. Imports, earlier code and runtime-initialized state are not supplied.
|
||||
|
||||
Source EXE SHA256:
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Carrier SHA256:
|
||||
`a5bf4114beaf23fcaaf608e042a5873ff353ab4fa1189ba6b7466ed55fe91b99`.
|
||||
The regenerated carrier is byte-identical to the analyzed file.
|
||||
|
||||
REA/Ghidra12.1.4 successfully decompiled entry447CF0 using this changed input.
|
||||
Evidence:
|
||||
`ev_58ecada52eaf5028945af6330fc9721a6a085495dbfd8ffdbb665a1fcad27420`.
|
||||
Complete result, provider snapshot, mapping and stderr remain local under
|
||||
`artifacts/jimmy-skip-raw-default/`. The Evidence subject is the carrier hash,
|
||||
not the EXE hash. The existing original-instruction guard independently binds
|
||||
the relevant instructions to EXE offsets447CF0−400000 and onward.
|
||||
|
||||
## Recovered behavior and limits
|
||||
|
||||
The complete decompilation agrees with the guarded original instructions:
|
||||
|
||||
- `none` returns; named triggers resolve and dispatch according to concrete type.
|
||||
- DEFAULT447D34..447FC5 resolves JIM1. If JIM1 already owns raw control, its early
|
||||
branch447D5C..447D9A loads sound effects, clears the applicable actor flag and
|
||||
shared skip, and returns. It does not execute the later owner/camera/music branch.
|
||||
- Otherwise it selects the appropriate Jimmy/vehicle owner, grants through118,
|
||||
conditionally snaps the shared camera eye when distance exceeds1000, and handles
|
||||
sound/music/UI/shared state. The SCENE30 menu callback is a separate conditional.
|
||||
- No direct Jimmy mode704/turn614/current-or-destination-Euler reset appears in
|
||||
DEFAULT. A raw owner grant is still475A40's pointer store, not actor Init.
|
||||
|
||||
Carl's MCA completion names JIM1 before dispatching Carlwalk→DEFAULT, making the
|
||||
already-owned early branch relevant. This result supplies no hidden reset to
|
||||
explain the user's upright original return. Indirect callees retain the coverage
|
||||
and limits documented in the return-source report; pseudocode is a navigation aid,
|
||||
and the original instructions remain authoritative.
|
||||
|
||||
## Reproduction
|
||||
|
||||
From GamePort, with the local REA/Ghidra environment:
|
||||
|
||||
```sh
|
||||
python3 tools/binary/default_raw_carrier.py ../Original --output artifacts/default-recovery
|
||||
scripts/rea.sh decompile artifacts/default-recovery/default.bin 0x447cf0 \
|
||||
--provider ghidra --target-format raw-binary --architecture x86 \
|
||||
--entry-point 0x447cf0 --snapshot artifacts/default-recovery/snapshot.json \
|
||||
--format json --full-output > artifacts/default-recovery/result.json
|
||||
```
|
||||
|
||||
No original code was executed by this analysis and no original files were changed.
|
||||
@@ -0,0 +1,51 @@
|
||||
# Derived Jimmy frame around the controller
|
||||
|
||||
2026-11-06. This closes a caller-level omission in the earlier component
|
||||
composition; the lifecycle correction is separately established by
|
||||
[menu/player lifetime](main-menu-player-lifetime.md).
|
||||
|
||||
Canonical EXE SHA256f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8;
|
||||
retained REA instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
|
||||
The guard verifies14 source sites,21 virtual bindings,15 ranges and the actual
|
||||
controller call. Text file offsets below equal preferred VA−400000; the helper
|
||||
PE-maps them independently.
|
||||
|
||||
| Source boundary | Recovered ownership |
|
||||
|---|---|
|
||||
|424600..424D10 /24600..24D10|Actual Jimmy game3C4 caller. Null raw control closes/hides helper UI and stops sound handles. It does not itself clear movement mode or stored turn.|
|
||||
|424721..424751|If the menu exists and shared4F8181 is set, poll menu4A8→403A10. State2 calls menu460; both state2 and other states return before the controller. This lock is distinct from raw ownership.|
|
||||
|424767 complete208→424D10|Objective/UI helper before the controller. The separate objective presentation does not set modal input gate4F8198; that explicit-modal opener is406F90. See objective-timing.md.|
|
||||
|424BFC complete1A4→425170|Upward world query/velocity handling. Its falling callback425120 maintains mode1; it is not a grounded resume reset.|
|
||||
|424C08 complete1A8→4252E0|Downward/shadow-distance query and own helper state.|
|
||||
|424C2B complete194→42AAC0|Airborne sound cleanup.|
|
||||
|424C34→437940|Actual ordinary player wrapper. The source ownership/support/input-order conclusions remain here.|
|
||||
|424C3F complete1C8→424E80|Invisible upkeep, with its own mode gate and ordinary non-Invisible return.|
|
||||
|424C88 complete1B4→4255C0|Impact/material helper; world-hit dependencies remain separate.|
|
||||
|424C94 complete1B0→425490|History/position correction. Calls game314→472360 Vec4 **root** setter; this is not an Euler setter.|
|
||||
|
||||
`jimmy_derived_frame_probe.c` executes the complete derived caller and ordinary
|
||||
helpers on private copied source.437940 is a recording adapter, upward/downward
|
||||
world queries return no hit, and menu/resource/visibility transports are explicit
|
||||
adapters. Thus these cases test what the caller changes outside its controller,
|
||||
not another execution of the controller/body/whole game.
|
||||
|
||||
All50 cases pass:48 combinations of raw ownerNULL/Jimmy/other, menu lock0/1,
|
||||
menu state1/2, supported0/1 and rising0/1, plus two180-tick unlocked intervals.
|
||||
The caller dispatches the controller only while the menu lock is clear; raw
|
||||
ownership is passed onward rather than becoming another caller-side gate.
|
||||
Mode1, turn11.666668 and distinct current/destination Euler stay unchanged outside
|
||||
the recorded controller. Queries and menu-close callbacks have checked counts.
|
||||
|
||||
Artifacts: `artifacts/jimmy-derived-frame/native-observations.json` binds generated
|
||||
source, executable, source contracts, original identity, capture metadata and log
|
||||
hashes; capture wineExit0 and `JIMMY_DERIVED_FRAME_COMPLETE` are required. Primary
|
||||
integration reran the parser/guards and verified all50 cases. No full body/world
|
||||
hits, OMT playback, native Windows or actual original Carl frame is claimed.
|
||||
|
||||
```sh
|
||||
python3 tools/binary/jimmy_derived_frame.py ../Original \
|
||||
--output artifacts/jimmy-derived-frame/build \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--capture artifacts/jimmy-derived-frame/probe
|
||||
```
|
||||
@@ -0,0 +1,118 @@
|
||||
# Jimmy landing → idle orientation ownership
|
||||
|
||||
2026-11-05. User reports a slight bank/pitch can remain after landing without
|
||||
further movement. This investigation tests the original paths rather than
|
||||
assuming that support implies an upright snap. Parent owns runtime integration.
|
||||
|
||||
## Evidence and coordinate owners
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Retained complete REA instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
|
||||
artifacts/jimmy-movement-audit/rea-original-disassembly.json. This report reuses
|
||||
that observation; it does not claim a new Ghidra decompile. VA-to-file mapping
|
||||
below is checked through PE sections (these EXE text offsets equal VA−400000).
|
||||
JN-Engine's original C3DJimmy/C3DPlayer decompiler notes supplied leads only.
|
||||
|
||||
Current Euler is game224/228/22C (complete2E4/2E8/2EC). Destination Euler is
|
||||
game274/278/27C (complete334/338/33C); game+A (completeCA) is facing dirty.
|
||||
Destination setter36C→472660 storesXYZ and sets dirty. Jimmy facing43A420
|
||||
reads current/destination independently and runs before controlled-player gating.
|
||||
There is no small-error snap in that recovered interpolator.
|
||||
|
||||
## Grounded and idle transitions
|
||||
|
||||
| Original VA / file offset | Recovered behavior |
|
||||
|---|---|
|
||||
|438A60..438B9E /38A60..38B9E|Input dispatch uses retained movement mode game704. Mode0 selects ordinary ground handler438BC0; mode1/2 selects439900. It does not itself reset current/destination Euler.|
|
||||
|438BC0..43915D /38BC0..3915D|Complete ground handler prefix samples input, support/root, idle animation/sounds and camera-vector angles. No330/32C/36C Euler dispatch or direct current/destination Euler store occurs in this bounded prefix.|
|
||||
|438F66 /38F66|Ground accepted-heading flag ESI starts0. Keyboard/accepted analog directions set it; neutral input need not do so.|
|
||||
|43951E..439520 /3951E..39520|If ESI remains0, jump4395CF, skipping all destination writes. This preserves old destination pitch/roll/yaw and dirty state.|
|
||||
|43957C,439599,4395C9 /3957C,39599,395C9|Accepted steering publishes pitch0/roll0 and the selected destination yaw through36C. Input, rather than the mere fact of standing, owns these upright destinations.|
|
||||
|437AEA,437B12 /37AEA,37B12|Grounded/released wrapper calls complete140 when prior movement mode1, before the animation decision and resetting mode0/turn0 at437B9E..437BAC.|
|
||||
|429910..429962 /29910..29962|Complete140 clears complete1E64/1E68, hides the A18 menu indicator except rawmode2 and stops A3C sound if valid. No current/destination Euler write occurs. The menu488 target403700 only hides two UI resources.|
|
||||
|43B28A..43B2EB /3B28A..3B2EB|Accepted STOP selection uses generic animationE0 and clears acceleration278. It does not reset current/destination Euler; same-animation request returns earlier43AFF8..43B010.|
|
||||
|40DD90..40DF79 /DD90..DF79|Generic animation start resolves the named morph, starts it and sets shape/timing. No Euler destination/current setter is dispatched in the resolved routine.|
|
||||
|game37C→472970 /72970|Jimmy's body landing callback binding is the bare no-op/log stub, not an upright reset.|
|
||||
|
||||
The derived Jimmy input hook426030 also has a separate impact latch. Its support
|
||||
query is4260AA, falling gate uses vertical thresholds at4260EF/4261B1 and sets
|
||||
**game1D98** at4261C5 (complete1E58). On support42622D..42625E, it clears that
|
||||
latch, plays soundC0 and calls complete1A0(-10,-10,5), the camera effect path.
|
||||
This is not a rotation reset. Offset names in the friend's mixed-interface notes
|
||||
must not be copied without the C0 adjustment. The pickup-halo AddEuler4264F8
|
||||
writes the effect object1D94, not Jimmy. The426F47 Euler copy likewise targets
|
||||
an attached action objectA10 from Jimmy's current Euler.
|
||||
|
||||
Ordinary air input439900 independently accepts support for speed decay, but
|
||||
turn return439989..439A58 has no supported-axis reset. Its ordinary destination
|
||||
439DB7..439E2D is `(acceptedPitch,currentYaw,-storedTurn)`. The last accepted air
|
||||
input can therefore leave a small bank destination after turn0 is subsequently
|
||||
written by the grounded wrapper. Neutral ground input alone does not replace it.
|
||||
Earlier [Bubble recovery](bubble-motion.md) already records the analogous
|
||||
no-input retention; this is not evidence for introducing a cleanup timer or snap.
|
||||
|
||||
## Rendering and scope
|
||||
|
||||
473540 converts current degrees to source14-bit angle units. The existing
|
||||
JimmyRenderTransform already performs that quantization. The OMT hierarchy
|
||||
retains full pitch/roll. The final OMT model-matrix decomposition remains its
|
||||
previous precision gate; none of these static paths establishes a general
|
||||
"grounded means upright" policy.
|
||||
|
||||
**Recovered:** the local writes, dispatch order and retention contracts above.
|
||||
**Inference:** stale last-air bank can explain the reported freeze in the port
|
||||
and is also possible through these source components. A full original frame
|
||||
trace is still required to prove whether another scene writer intervenes in the
|
||||
reported route. A component result is not that whole-game observation.
|
||||
**Implementation:** parent owns any runtime change; do not silently insert a
|
||||
landing snap and label it original behavior. The independently recovered CAM/MCA
|
||||
flattening writes both current and destination and has a different owner.
|
||||
|
||||
## Guard and finite component verification
|
||||
|
||||
`tools/binary/jimmy_landing_rotation.py` guards original SHA, seven branch/field
|
||||
anchors, five virtual bindings and eleven bounded range hashes. Optional retained
|
||||
REA input verifies Evidence identity and lists all ground-prefix calls.
|
||||
`jimmy_landing_rotation_probe.c` executes the original43915D..4395CF keyboard
|
||||
suffix and actual43A420/458F90/472480 facing leaves with real472660 destination
|
||||
setter and4723F0 getter. A synthetic actor/input phase replaces body, camera,
|
||||
animation resources and full scheduling. It seeds a supported neutral-input
|
||||
boundary after the last airborne destination publication, then records one and
|
||||
300 input/facing passes; it does not execute full landing or whole gameplay.
|
||||
|
||||
All seven finite original-component cases complete successfully inside the
|
||||
network/filesystem-isolated Wine32 generated copy. The final capture records
|
||||
wineExit0 and `JIMMY_LANDING_ROTATION_COMPLETE`. Example observations:
|
||||
|
||||
- Neutral last-air target `(0,155,-5)` retains that destination; after300 passes,
|
||||
current is approximately `(0,155,355)`. The five-degree bank survives.
|
||||
- Neutral last-air forward target `(-40,290,-25)` retains it and settles to
|
||||
`(320.000183,290,335.000183)`, rather than upright.
|
||||
- Dirty0 with current `(10,155,15)` leaves that rotation unchanged for300 passes.
|
||||
- Active Up publishes `(0,290,0)` and levels via the original interpolator;
|
||||
Left likewise publishes zero destination pitch/roll while changing yaw.
|
||||
|
||||
The neutral suffix does not query support itself: caller selection of the ground
|
||||
input path is the fixture boundary, not a newly observed whole landing callback.
|
||||
`tools/binary/jimmy_landing_rotation_reference.json` retains all7 observations,
|
||||
source range/byte/virtual guards, generated C/executable/shared harness/log hashes,
|
||||
and capture exit metadata. Raw logs, generated source and executable are retained
|
||||
under artifacts/jimmy-landing-rotation/. NoOriginal directory is mounted for the
|
||||
probe and no original entrypoint executes. This confirms retention in the
|
||||
specific original components and leaves another whole-frame writer explicitly
|
||||
unresolved; it supplies no evidence-based justification for a universal land snap.
|
||||
|
||||
Reproduce static preparation:
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_landing_rotation.py ../Original \
|
||||
--generate-probe artifacts/jimmy-landing-rotation \
|
||||
--rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json
|
||||
```
|
||||
|
||||
Compile generated C with local i686-w64-mingw32-gcc and `-Itools/binary`; execute
|
||||
only through tools/recon/reference_capture.py's `--asset-probe` boundary with
|
||||
`--probe-success JIMMY_LANDING_ROTATION_COMPLETE`. Parent owns regression-test
|
||||
placement and runtime decisions; no shared/runtime file was edited by this agent.
|
||||
@@ -0,0 +1,98 @@
|
||||
# Jimmy rotation at script and ground handoffs
|
||||
|
||||
Follow-up: the entry fix below does not resolve neutral idle **after skipping
|
||||
Carl**. User reports that separate port bug and confirms original landing bank
|
||||
is normal. See [decompilation checkpoint](jimmy-cutscene-decompilation.md) for the
|
||||
48-case reproduction, original skip findings and the implementation pause.
|
||||
|
||||
2026-11-05. User reports jumping at an angle into cutscene triggers leaves Jimmy
|
||||
tilted, and a slight tilt can also remain after landing and standing still.
|
||||
|
||||
## Recovered cutscene correction
|
||||
|
||||
[Original camera ownership](jimmy-cutscene-rotation-source.md) records REA
|
||||
Evidence, original addresses/file offsets, callers, vectors and native execution.
|
||||
CAM416671..4166EB and initial MCA431518..431590 explicitly flatten both current
|
||||
Euler and facing destination, preserving current yaw and the dirty flag. Their
|
||||
direct game+274 writes were previously described as a render cache; the air
|
||||
bridge correctly identified them as destination state but missed this handoff.
|
||||
The port only flattened current Euler. Control-independent facing then consumed
|
||||
the stale airborne target and restored the tilt (and sometimes the prior yaw).
|
||||
|
||||
LabSimulation.FlattenOrientation now replaces currentXYZ and destinationXYZ with
|
||||
`(0,currentYaw,0)` without calling the dirty-setting destination setter. Existing
|
||||
CAM/MCA preparation ordering, prior-owner guards, AI NULL/DEFAULT differences,
|
||||
held input, queued motion and fire lifecycle remain intact. Authored transforms
|
||||
still change current Euler independently of destination; no generic control-loss
|
||||
or per-frame orientation clamp is introduced. Original orientation W is verified
|
||||
by the probe but remains outside the port's XYZ orientation model.
|
||||
|
||||
## Landing investigation
|
||||
|
||||
[Landing source investigation](jimmy-landing-rotation-source.md) records its
|
||||
separate boundary. Neutral ground input retains its prior destination; ground
|
||||
apply, STOP, the landing notification and the derived impact latch do not supply
|
||||
a proven leveling reset. This differs from the directly evidenced camera reset.
|
||||
Do not invent an unconditional grounded snap from this symptom. Seven copied-original300-tick ground-input/facing trajectories reproduce
|
||||
retention: destination `(0,155,-5)` retains roll355 after300 neutral passes;
|
||||
active Up/Left replaces X/Z targets and levels. The managed ground tests compare
|
||||
all seven source trajectories. These are component observations, not a whole
|
||||
original frame trace: another unobserved frame writer or an original quirk remains
|
||||
open. No landing policy is changed without that evidence.
|
||||
|
||||
## Verification
|
||||
|
||||
The old implementation fails the new director regression at the pending target.
|
||||
Eight integrated cases cover CAM/original lab Carl MCA, both input/player orders,
|
||||
and clean/dirty facing. They enter real banked jumps, verify immediate current/
|
||||
destination flattening and unchanged dirty/impulse, then run120 locked body ticks
|
||||
without reintroducing tilt. Additional checks compare20 saved native camera
|
||||
preparation/facing XYZ/dirty outputs, including negative/wrapped Euler and yaw
|
||||
seams. These comparisons seed dirty through live input; the native probe's whole
|
||||
object comparison separately proves independence from the old destination and W.
|
||||
The saved fixture includes original range and probe provenance hashes.
|
||||
|
||||
Native Linux SDL/Vulkan --smoke-control-phases now first creates a real8-tick
|
||||
banked jump before triggering the original Carl MCA. It asserts both current and
|
||||
destination are leveled while dirty survives the handoff, verifies they remain
|
||||
upright through15 locked body/fire/energy ticks, and checks held-input resumption.
|
||||
It saves locked-start/locked-fall GPU captures. The Carl lock and powered VR04
|
||||
replays remain regression checks. Artifacts: artifacts/jimmy-rotation-handoff/.
|
||||
28 movement groups, extended Director tests, original25 ground observations plus
|
||||
seven trajectories,14 jetpack groups and both visual groups pass. Build passes
|
||||
with zero warnings/errors using NuGetAudit=false (the first default-audit attempt
|
||||
reported unavailable network metadata). Native Linux banked handoff/Carl lock/
|
||||
powered jetpack runs pass with zero Vulkan validation errors. The jetpack replay
|
||||
requires explicit VR04; an initial default-lab invocation was rejected by its
|
||||
existing argument guard before rendering and the corrected replay passes.
|
||||
All336 Python tests pass, including new camera/landing source and native-fixture
|
||||
provenance guards. The initial managed fixture name collision was corrected
|
||||
before the final Director run. Package results follow below.
|
||||
|
||||
These are static-source, isolated original-component and port-runtime checks.
|
||||
They do not establish whole-original frame scheduling or native Windows parity.
|
||||
|
||||
## Packages and final boundary
|
||||
|
||||
Both self-contained packages identify clean runtime commit
|
||||
`dae13ace7391671aee7082c662bb798b285b9124`. Each verifies519 original copies,
|
||||
4285 prepared scene/resource files and seven prepared audio files. The539 source
|
||||
originals remain unchanged. Provenance is in
|
||||
artifacts/jimmy-rotation-handoff/package-identity.json. The earlier turn/fire
|
||||
package resource count likewise excluded those audio files; no new assets are
|
||||
introduced by the orientation correction.
|
||||
|
||||
Standalone Linux from /tmp with SDK variables unset passes the banked Carl
|
||||
handoff/body-fire continuation/control-resumption replay with zero Vulkan
|
||||
validation errors. All three packaged handoff GPU captures match development
|
||||
byte for byte. The three powered-flight development captures also match the
|
||||
previous turn/fire runtime exactly. Hashes/logs are retained as
|
||||
package-readbacks.json, package-control-phases.log and jetpack-readbacks.json.
|
||||
Windows is cross-published/resource-verified; native Windows and whole-original
|
||||
frame comparison remain outstanding. Validation docs are added after packaging;
|
||||
BUILD-INFO preserves the clean runtime commit above.
|
||||
|
||||
The landing report remains an investigation outcome, not an implemented landing
|
||||
correction: verified components preserve neutral bank and do not provide the
|
||||
missing whole-frame observation. Any automatic landing leveling requires further
|
||||
original evidence or an explicit decision to diverge from the recovered behavior.
|
||||
@@ -0,0 +1,126 @@
|
||||
# Original input/controller composition after scene return
|
||||
|
||||
2026-11-05. Independent bounded original-code execution for the accepted next-work
|
||||
plan. This addresses whether the port's fresh-versus-retained distinction is an
|
||||
invented implementation artifact or also exists in the known original components.
|
||||
It does not execute original startup, complete Carl activation or all skip logic.
|
||||
|
||||
## Source identity and recovery
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
REA complete instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`
|
||||
provides the bounded source instruction context. The generator verifies that
|
||||
Evidence's subject identity, verifies the authoritative EXE hash, PE-maps every
|
||||
copied range and records source range hashes. Originals are never modified or
|
||||
executed in place. The generated probe runs under the existing isolated Wine32
|
||||
asset-probe boundary, with no network or original-directory mount.
|
||||
|
||||
## Executed source and synthetic boundary
|
||||
|
||||
| Original VA / raw file offset | Executed role |
|
||||
|---|---|
|
||||
|431518..431590 /31518..31590|Initial MCA current/destination flatten suffix; actual328→4723F0 and32C→472450 leaves.|
|
||||
|430F1D..430F5C /30F1D..30F5C|Accepted skip's JIM1 lookup, complete1E00 latch, shared4F83E4 set and audio-stop prefix. Lookup/audio transport are recorded shims; target cleanup and completion are outside this prefix.|
|
||||
|475A40..475A4C /75A40..75A4C|Actual raw control-pointer grant and removal. Shared skip is explicitly cleared to represent the already-verified DEFAULT field effect; complete DEFAULT is not executed.|
|
||||
|438A60..438BA2 /38A60..38BA2|Actual retained-mode dispatch. Its absolute jump-table operand and four table entries are relocated into the private source image.|
|
||||
|439900..439E33 /39900..39E33|Actual keyboard/zero-mouse ordinary air input through the real36C→472660 destination writer. The camera tail is replaced by the proper source-function epilogue.|
|
||||
|437940..437C3A /37940..37C3A|Actual player wrapper including control identity, jump/support dispatch, mode/turn reset and publication. Its40E050 base call is replaced only by actual43A420 facing; unrelated base resource/animation behavior is not simulated.|
|
||||
|43A420..43A5CD /3A420..3A5CD|Actual facing, actual334→458F90→472480 Euler-add chain; global ready gate forced true.|
|
||||
|429910..429963 /29910..29963|Actual landing effect/menu helper with synthetic menu488/noop and invalid sound handle. It does not change mode/turn/Euler.|
|
||||
|43915D..4395CF /3951D..395CF|Actual neutral ground keyboard suffix after the wrapper has selected mode0; ground camera/device prefix omitted.|
|
||||
|
||||
The actor is synthetic, supported=true, jump-held=false, ordinary raw gadget-1,
|
||||
zero mouse/analog/keyboard and initial speed0. Complete/game vtables are explicit.
|
||||
Ground/air motion apply and animation actions are recorded no-op resource shims;
|
||||
the known mode/turn writes and facing/input arithmetic execute from original code.
|
||||
The current-action helper represents STOP versus RUN inequality. There is no body,
|
||||
world collision, registry, full derived Jimmy input callback426030, animation engine,
|
||||
renderer, complete MCA update/completion, original startup or full-game execution.
|
||||
|
||||
The initial state deliberately models the problematic boundary: retained movement
|
||||
mode1 and stored turn±11.666668, with both current/destination flattened to
|
||||
(0,155,0). After180 uncontrolled player wrappers, those vectors remain upright
|
||||
and mode/turn survive. The composition then grants control and orders input/player
|
||||
callbacks either fresh-input-first or retained-player-first, followed by300 idle
|
||||
callbacks. Each order is run with and without the original skip-prefix writes,
|
||||
and with both turn signs: eight finite cases.
|
||||
|
||||
## Observed results
|
||||
|
||||
All8 cases complete with the required marker and capture wineExit0. Finite
|
||||
post-capture assertions validate the boundary values below.
|
||||
|
||||
| Order | Skip prefix | First resumed effect | After300 idle callbacks |
|
||||
|---|---|---|---|
|
||||
|Input before player|Off or on|Air input decays turn±11.666668 to±10.000001 and writes target roll∓10.000001. Actual player wrapper then clears mode/turn, after facing has consumed the bad target.|Four cases retain approximately±10° bank.|
|
||||
|Player before input|Off or on|Actual supported/released player wrapper clears mode1/turn before input. Mode0 neutral ground suffix preserves upright target.|Four cases stay exactly upright.|
|
||||
|
||||
Representative positive-turn fresh result is bit-for-print equivalent to the
|
||||
existing managed diagnostic: first target roll-10.000001; first player current
|
||||
roll360, mode0/turn0; idle current roll350.000183. Negative-turn result converges
|
||||
to9.99999523. This is original code reproducing the same component composition,
|
||||
not proof that this fresh composition is the normal original playable lifecycle.
|
||||
|
||||
With skip enabled, the prefix sets both latch and shared skip to1 and records
|
||||
one stopped sound; mode and turn remain unchanged. Those writes alone therefore
|
||||
do not erase the first stale target in this composition. Their full menu/input
|
||||
consumer and caller timing remain separate questions.
|
||||
|
||||
## Consequences and unresolved original behavior
|
||||
|
||||
The known controller/input contracts agree with the port's first-writer trace;
|
||||
there is no new source evidence for adding a rotation or turn reset at raw grant.
|
||||
The critical question is which callback order and entry state actual original
|
||||
startup and the reported Carl route establish. A fresh allocation partial-order
|
||||
proof must not be substituted for normal New Game execution: original startup/
|
||||
menu/loading may already have created a retained Jimmy before the first playable
|
||||
lab. Proving that chain would explain upright return without an invented reset.
|
||||
This investigation does not independently establish that startup chain.
|
||||
|
||||
Follow-up2026-11-06: [Carl/startup audit](jimmy-carl-entry.md) positively traces
|
||||
MAIN construction and supplies no lab-preload/Jimmy construction in that bounded
|
||||
chain. The new observer also sees only MAIN before the unusable black-screen
|
||||
boundary. Neither result supports switching all fresh scenes to retained order.
|
||||
The broader [lifecycle trace](jimmy-cutscene-lifecycle.md) keeps actual original
|
||||
Carl entry state/order/delta unresolved instead of adopting the preload hypothesis.
|
||||
|
||||
One additional inspected base branch is not a reset justification:40E050 pins
|
||||
current transform to authored transform when game58C CanMove==0, but actual
|
||||
lab JIM1 has serialized CanMove1. Other base resources/callbacks remain omitted
|
||||
from the composition and must be tracked if startup/order does not explain the
|
||||
user's whole-original observation.
|
||||
|
||||
## Artifacts and reproduction
|
||||
|
||||
- tools/binary/jimmy_skip_composition.py and _probe.c: read-only source guards,
|
||||
relocation generator and bounded synthetic composition.
|
||||
- artifacts/jimmy-skip-composition/build/source.json: ten original range hashes,
|
||||
PE offsets and relocation operands.
|
||||
- artifacts/jimmy-skip-composition/native-observations.json: all eight cases,
|
||||
per-boundary fields and source/harness/executable/log/capture provenance hashes.
|
||||
- probe/wine.log and probe/capture.json: successful marker and wineExit0.
|
||||
|
||||
From GamePort:
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_skip_composition.py ../Original \
|
||||
--output artifacts/jimmy-skip-composition/build \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-skip-composition/build/jimmy_skip_composition_probe.c \
|
||||
-o artifacts/jimmy-skip-composition/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-skip-composition/build/probe.exe \
|
||||
--probe-success JIMMY_SKIP_COMPOSITION_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-skip-composition/probe
|
||||
```
|
||||
|
||||
Harness corrections preceded the successful run: initial Wine prefix creation
|
||||
outlasted its first capture, the absolute dispatch jump table needed relocation,
|
||||
and the skip-prefix exit initially preceded its cdecl argument cleanup. These
|
||||
failures were probe construction gaps, not original gameplay observations.
|
||||
The final compiled probe has no warnings; only the final success marker/exit and
|
||||
validated eight-case outputs establish the observations. No production/runtime/
|
||||
regression-test/build-script change or commit is made by this investigator.
|
||||
@@ -0,0 +1,153 @@
|
||||
# SCENE60 task broadcast and Jimmy's retained bank
|
||||
|
||||
2026-11-06. This investigation covers the task broadcast that Carl's talk
|
||||
progress runs **before** `neutron1a` activation. It provides no source-supported
|
||||
Jimmy movement reset and does not close the whole original skip-to-idle frame.
|
||||
No runtime, test, build-script or package change is made here.
|
||||
|
||||
## Identity and evidence
|
||||
|
||||
Authoritative `Neutron.exe` SHA256:
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Retained REA complete instruction Evidence:
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
|
||||
The helper validates that Evidence's subject hash, the authoritative binary,
|
||||
PE-mapped source sites, direct calls, tables and actual GAM records. Addresses
|
||||
below are preferred VAs; the listed text file offsets equal VA minus400000,
|
||||
independently checked through PE sections.
|
||||
|
||||
JN-Engine's `docs/decomp_ledger.csv` and `docs/gam_schema.md` supplied class/table
|
||||
leads only. All17 matching FourCC registrations, constructor game-table stores
|
||||
and game424 targets are verified against the supplied original. JN-Engine's
|
||||
movement implementation is not used.
|
||||
|
||||
## Assignment phases and direct Jimmy admission
|
||||
|
||||
| Original VA / file offset | Recovered owner/transition |
|
||||
|---|---|
|
||||
|413E5A,413E9D /13E5A,13E9D|Carl progress queries SCENE;50 becomes60 through45F990. The friend talk caller subsequently dispatches the selected conversation. This is an entry phase, not an automatic skip-completion broadcast.|
|
||||
|45F9EC,45F9F2 /5F9EC,5F9F2|SCENE milestone switch. Byte45FC48[60−35] is2;45FBF0[2] points45FA0B, which supplies objective arguments3,1.|
|
||||
|406F50..406F88 /6F50..6F88|For positive objective id, clear44 dwords at4F7D00, store id4F8194, zero timer4F8188, store low argument byte at indexed objective flag. This complete leaf does not write modal4F8198 or input suppression4F8430.|
|
||||
|45FB63..45FB8B /5FB63..5FB8B|Traverse task records4FC5FC, case-insensitively match name, then store supplied state at record+64. Repeated assignments are not suppressed.|
|
||||
|45FB8D..45FBE8 /5FB8D..5FBE8|Traverse registry50999C in list order. Compare supplied task against each game interface+430 TaskName. Only exact case-insensitive matches receive game424, synchronously.|
|
||||
|458880..45888A /58880..5888A|Plain task callback stores supplied state at **own** game494 and returns.|
|
||||
|4A373C+420,+424 /A3B5C,A3B60|Jimmy binds post-task hook472970 (no-op) and task callback40E340. Actual lab JIM1 has TaskName`none`, so the SCENE60 broadcast never reaches its424 callback. The45F990 loop does not invoke420.|
|
||||
|
||||
Actual `gam/level1b.gam` SHA256:
|
||||
`316fff40db565c2add5b07cbccdef640ddb67c64d6625fea1429ce2a0542a234`.
|
||||
JIM1 is index0/raw8, TaskName`none`, RequiredLevel0, ExactLevel/RemoveLevel−1.
|
||||
Carl is index8/raw1455, TaskName`SCENE`, RequiredLevel0,
|
||||
ExactLevel/RemoveLevel−1. Direct Jimmy exclusion alone would not prove that
|
||||
another listener cannot affect him; the following inventory addresses that gap.
|
||||
|
||||
## All authored matching listeners
|
||||
|
||||
There are89 serialized SCENE listeners, spanning17 kinds and six callback
|
||||
targets. The generated `source.json` retains every record index/raw offset,
|
||||
tag, authored gate, callback and a50/60 gate comparison. This is an inventory of
|
||||
**authored records**, not a runtime census of constructor-created helpers or
|
||||
retained actors.
|
||||
|
||||
| Callback VA / offset | Kinds and matching count | Recovered behavior |
|
||||
|---|---|---|
|
||||
|458880 /58880|3CAM,3MCA,3LIO,3NEU,3PAT,3SOU,STRT,LOAD:43|Store own TaskState. In particular, CAM/MCA task callbacks do **not** dispatch activation, prepare Jimmy, take control or play shots.|
|
||||
|40CA80..40CA9D /CA80..CA9D|3AIT:14|Store own TaskState, query its own task name through45FEA0, discard query result and return. This callback does not call AIT trigger40C300 or grant control.|
|
||||
|40E340..40E3D0 /E340..E3D0|3DUD,3BUT,3OMT,3TEL:9|Store own TaskState and apply own exact/required/remove activation gates through own complete110. Every matching authored instance in these kinds has all three gates−1, so50 and60 preserve existing activation.|
|
||||
|45F2B0..45F3A5 /5F2B0..5F3A5|3PIC,3ANI:21|Store own TaskState; if its picture is uncollected, test own exact/required gate. Set own visibility, pickup-active byte and collision byte. No NextTrigger/ActivateObject/ToggledObject dispatch occurs in this task callback.|
|
||||
|43EBB0..43EC07 /3EBB0..3EC07|3ROC:1|Run generic animated callback. If own linked pointer game680 is nonzero, set own rendering/effect and collision flags. The inspected callback tests that pointer without dereferencing it as another actor. Authored exact/required/remove gates are all−1.|
|
||||
|413F30..41411E /13F30..1411E|3CAR:1|Query new SCENE, run generic activation, then LV1B override on Carl. At60, resolve CARLESC3, set **Carl** AIstate6 and copy marker root to **Carl**, then leave base activation unchanged.|
|
||||
|
||||
For the pickup/sprite paths, `shrinkray` (required0), the unnamed animated sprite
|
||||
index72 (required0) and the late pickup index120 (required140) preserve the same
|
||||
gate outcome at50 and60. `apple` (exact30) is disabled at both. All remaining
|
||||
matching pickup/sprite records have required/exact−1 and preserve state.
|
||||
Actual collection table4F8438 and live visibility are not reconstructed by this
|
||||
authored gate calculation. All21 callbacks can still store their own TaskState
|
||||
on repeated assignments.
|
||||
|
||||
The source helper records exact game tables and constructor/registration sites
|
||||
for all17 kinds. Representative bindings include AIT48F8C0+424→40CA80,
|
||||
CAM497BFC+424→458880, MCA4A8F64+424→458880,
|
||||
PIC4AE548+424→45F2B0, Rocket4B25AC+424→43EBB0,
|
||||
Carl495364+424→413F30 and LOAD4D025C+424→458880.
|
||||
|
||||
## Activation dependencies and state ownership
|
||||
|
||||
The inspected callback tails do not contain a Jimmy mode704/turn614/Euler
|
||||
reset or a raw control-pointer grant. Their relevant indirect calls keep the
|
||||
listener as `this`:
|
||||
|
||||
- Animated complete110→40E3E0 controls that actor's display and collision.
|
||||
Its complete10C hook is472970 for the matching Button/DUD/OMT/TEL/Rocket
|
||||
classes. Carl's hook413D60 is an own-animation resource/preparation path,
|
||||
guarded by its own complete635 loaded byte; it requests Carl's STOP and
|
||||
sets Carl's motion parameters. It does not invoke a cutscene or Jimmy cleanup.
|
||||
- Own game3A4/3AC→473030/4730E0 forwards false/true to own game224.
|
||||
The common224→471A40 only writes own game140 collision-enabled byte.
|
||||
Own game214→471A00 writes own game13E, and pickup game1F4→471980
|
||||
writes own game134. These are flags, not immediate collision-pair callbacks.
|
||||
- Carl complete124→4089B0, state6, enters the408AC2 branch when eligible.
|
||||
Its own game410→40A6B0 preparation clears Carl velocity/speed. Carl
|
||||
game314→472360 copies Vec4 only to own game214 root. Neither receiver is
|
||||
Jimmy. Equal/locked-state branches remain local as well.
|
||||
- Display slot58 forwards to OMT resource visibility. This report does not
|
||||
execute the complete OMT renderer/animation graph or claim arbitrary engine
|
||||
observers have been exhausted. The recovered task callbacks themselves do
|
||||
not publish another actor's Euler/mode/turn or trigger a camera chain.
|
||||
|
||||
This closes the proposed **direct SCENE60 task reset** explanation and the
|
||||
authored CAM/MCA/AIT activation explanation. It does not establish the original
|
||||
first resumed frame or justify a blanket rotation reset, actor rescheduling or
|
||||
new input suppression. Later UI consumers of objective flags, runtime-created
|
||||
listeners and the full original registry remain separate observation boundaries.
|
||||
|
||||
## Bounded native verification
|
||||
|
||||
`jimmy_task_return_probe.c` executes original45F990 assignment/dispatch,
|
||||
406F50 objective selection and458880 state store from a private mapped copy.
|
||||
Only original absolute operands/jump-table targets needed by this finite path
|
||||
are relocated. Task and registry lists, game objects/vtables and `_stricmp`
|
||||
transport are explicit synthetic adapters. Matching actor callbacks in this
|
||||
probe are **adapters**, not actual Carl/pickup/Rocket/engine callbacks; those
|
||||
paths above are statically recovered.
|
||||
|
||||
All48 cases pass, varying prior task50/60, authored-like Jimmy task`none`
|
||||
versus synthetic matching`SCENE`, movement mode0/1, turn−12/0/+12 and both
|
||||
modal/input-flag seeds0/1. Each callback observes assigned task60 and already
|
||||
selected objective3. Authored-like Jimmy receives zero callbacks and remains
|
||||
byte-for-byte unchanged across all1F00 bytes. Synthetic matching Jimmy's only
|
||||
change is own game494 TaskState. Modal4F8198 and input suppression4F8430
|
||||
retain both tested seed values; objective timer4F8188 becomes zero.
|
||||
|
||||
Final capture reports wineExit0 and `JIMMY_TASK_RETURN_COMPLETE`; parsed output
|
||||
and provenance are in `artifacts/jimmy-task-return/native-observations.json`.
|
||||
The probe binary, generated source, complete copied EXE identity, static guards,
|
||||
Wine log and capture metadata are hashed there. No original startup, full Carl
|
||||
talk, skip, body, input/controller or renderer executes in this probe.
|
||||
|
||||
Initial capture timed out during Wine prefix creation. A missing-module repair
|
||||
then failed kernel32 loading. The successful run uses a copy of the previously
|
||||
successful generated Carl-contact Wine32 prefix. Logs for failed setup attempts
|
||||
and prefix repair/reuse metadata are retained; none is gameplay evidence.
|
||||
Original files were not modified or executed in place; isolated runs have no
|
||||
network or original-directory mount.
|
||||
|
||||
## Reproduction
|
||||
|
||||
From GamePort, with the existing local REA Evidence and Wine32 tooling:
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_task_return.py ../Original \
|
||||
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||||
--output artifacts/jimmy-task-return/build
|
||||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||||
-I tools/binary artifacts/jimmy-task-return/build/jimmy_task_return_probe.c \
|
||||
-o artifacts/jimmy-task-return/build/probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/jimmy-task-return/build/probe.exe \
|
||||
--probe-success JIMMY_TASK_RETURN_COMPLETE --seconds 12 \
|
||||
--output artifacts/jimmy-task-return/probe
|
||||
```
|
||||
|
||||
A fresh Wine prefix may need more time for initialization; successful completion requires
|
||||
both marker and process exit0, not merely screenshots or a returned wrapper.
|
||||
@@ -0,0 +1,110 @@
|
||||
# First story entry inherits the menu's Jimmy registry position
|
||||
|
||||
2026-11-06. This closes the missing source lifetime distinction behind the Carl
|
||||
neutral-return failure. It does not establish a universal rotation reset or a
|
||||
native Windows/full-original cutscene capture.
|
||||
|
||||
## Source and supplied data
|
||||
|
||||
Canonical Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`;
|
||||
retained REA instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
|
||||
`tools/binary/main_menu_player_lifetime.py` verifies8 calls,15 sites,15 bindings,
|
||||
12 instruction spans and both actual GAMs. Coordinates below are preferred VAs;
|
||||
the helper PE-maps file offsets independently (these text offsets equal VA−400000).
|
||||
|
||||
| Boundary | Source fact |
|
||||
|---|---|
|
||||
|46A641→46B160;46A660→46A310→44D0E0|Construct application and MAIN. This bounded prefix alone does not create Jimmy.|
|
||||
|46BA12/46BA18|Application constructor seeds elapsed+804=0 and splash stage+808=0.|
|
||||
|46BEC0..46C067|Application update increments elapsed. Strict elapsed>3s or an accepted Escape edge advances stages0→1→2→3; the3s float is48E5A0.|
|
||||
|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, 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.|
|
||||
|43B5A0→app100/46DF70|Uses the ordinary player scene-transition request. The successful TSK-to-GAM path does not construct a new player before teardown.|
|
||||
|Jimmy4226B5..BF;42275A|Stored/live teardown predicate0 via470F40(0), reusable game09=1. The initialized old games qualify for removal; Jimmy survives.|
|
||||
|46E38B/46E45A→46E6A0,46E6E0|Matching reusable3JIM is found in the existing registry. Reuse does not invoke its constructor or re-append its node. The new game header is allocated/appended after that existing node.|
|
||||
|
||||
Lab Level1B has129 records and first3JIM/JIM1 at raw8, SHA256
|
||||
316fff40db565c2add5b07cbccdef640ddb67c64d6625fea1429ce2a0542a234.
|
||||
The prior [game-lifetime proof](../checkpoint/level-game-lifetime.md) supplies
|
||||
the initialized-game predicate, destructor unlink and retained-character order.
|
||||
The earlier fresh game→Jimmy proof remains correct **when no reusable Jimmy
|
||||
exists**. It was incorrectly applied to the port's first TSK-backed story scene.
|
||||
|
||||
## Causal consequence and implementation boundary
|
||||
|
||||
A successful original TSK character/destination load requires an existing Jimmy;
|
||||
the ordinary loader retains him and appends the new game afterward. Thus the
|
||||
normal New Game story path has **Jimmy update before level-game input**, even
|
||||
though it is the first playable lab. The background edge explains where that
|
||||
player comes from; successful-request and retention guards establish the ordering
|
||||
without treating a black screenshot as proof of the complete New Game sequence.
|
||||
|
||||
At Carl completion, grounded/released Jimmy clears mode704/turn614 in437940
|
||||
before438A60 can select air input. The stale airborne destination is not republished.
|
||||
This agrees with the already-executed original-component composition and the
|
||||
user's upright-original observation. No Euler/turn reset is added to control grant,
|
||||
DEFAULT, landing, task or animation callbacks.
|
||||
|
||||
The port previously selected retained input order only when `carriedSave!=null`.
|
||||
Its initial story also consumes NewGame.tsk, but incorrectly used fresh order.
|
||||
Correct only that scene-entry classification: TSK-backed story and retained
|
||||
transitions use player-before-input; direct scene inspection/fresh simulations
|
||||
keep fresh order. Remaining scalar/helper/lifetime reconstruction stays bounded.
|
||||
|
||||
## Runtime evidence and limits
|
||||
|
||||
An isolated generated-copy diagnostic observed MAIN followed by Level1D allocation
|
||||
and a Jimmy registry node. It required a recorded, one-time Win32 ValidateRect
|
||||
acknowledgement after a pending full-window WM_PAINT. Thread snapshots suspend/
|
||||
resume owned threads briefly, so timing is perturbed. The supplied HDnoCD and
|
||||
640×480 NoCD variants have separately authenticated identities; their only mutual
|
||||
byte differences are the3 resolution-data bytes. Neither is silently equated with
|
||||
the canonical EXE. These captures show allocation/lifetime progress, not usable
|
||||
rendering, completed PostLoad, user New Game or Carl playback.
|
||||
|
||||
Local artifacts: `artifacts/original-startup-diagnostic/{before-ack,with-ack,long-hd}/`
|
||||
and `artifacts/main-menu-player-lifetime/source.json`. The baseline port's strengthened
|
||||
native Vulkan control-phase regression fails on **first neutral tick0**:
|
||||
inputAfterPlayer=false, current roll360, destination roll−10.000001, mode0/turn0.
|
||||
This is the exact source-composed stale writer. After the correction, the native
|
||||
Vulkan fixture stays upright on first resumed input and300 neutral ticks, then
|
||||
resumes held movement. It preserves heading and locked body/fire/energy updates.
|
||||
The existing standing/landing/air algorithms are unchanged; airborne return is
|
||||
still governed by original air input, not an invented blanket leveling rule.
|
||||
|
||||
Verification: all336 Python plus2 HUD checks, all managed projects and36
|
||||
GPU/render passes succeed. Eight new managed trajectories coverLeft/Right,
|
||||
natural/skip and repeated Carl scenes. Native Linux SDL/Vulkan1920×1080 control
|
||||
replay and VR04 powered steering/keyboard/800×600 resize pass, zero Vulkan errors.
|
||||
The first post-return held-input readback is inspected upright. Final Debug build
|
||||
has zero warnings/errors and Windows x64 cross-publish succeeds. No native Windows
|
||||
execution or full-original Carl runtime is claimed.
|
||||
|
||||
Both self-contained packages identify clean runtime commit ea04210f524faae7dc1caff8afbc608fbb8144f4.
|
||||
Each contains519 byte-identical original copies,4285 matching prepared scene files
|
||||
and7 matching prepared audio files. Their runtime DLLs match the corresponding
|
||||
published outputs. Standalone Linux from /tmp without SDK/development-library
|
||||
paths passes first input/300 neutral ticks and held-input return; all4 captured
|
||||
readbacks match development byte-for-byte. Validation is disabled for that
|
||||
standalone run; the development native run has validation enabled and zero errors.
|
||||
The optional validation layer needs its development library path; its initial
|
||||
ErrorLayerNotPresent diagnostic is retained as package-control.log.
|
||||
|
||||
The Windows package also passes the32-frame Carl/control fixture under isolated
|
||||
Wine64 with no Original-directory mount or network, including the neutral-return
|
||||
assertion and held-input resumption. Wine exit0 is recorded; this remains
|
||||
preliminary compatibility evidence, not native Windows testing. All539 original
|
||||
files remain unchanged.
|
||||
|
||||
Logs, baseline failure, source contracts, capture hashes, verified-change.json,
|
||||
package-identity.json and package-verification.json are in
|
||||
artifacts/main-menu-player-lifetime/. Wine capture metadata/logs are in
|
||||
artifacts/tsk-entry-windows/. Full original/native Windows comparison remains
|
||||
separate from this source-supported initialization correction.
|
||||
@@ -0,0 +1,88 @@
|
||||
# Original startup: pending repaint and background Jimmy allocation
|
||||
|
||||
2026-11-06. This is a local Wine diagnostic, not an untouched timing or visual
|
||||
reference. Originals remain unmounted in the execution namespace and unchanged.
|
||||
|
||||
`tools/recon/original_startup_probe.c` reuses the observer's exact-subject/live
|
||||
instruction guards and runs only at the generated wrapper directory
|
||||
`Z:\work\game`. It samples registry/actor state, loaded modules and owned thread
|
||||
contexts. Each successful SuspendThread is paired with ResumeThread; all recorded
|
||||
resumes succeed. Stack words are retained as raw candidates, not a full validated
|
||||
unwind. Suspension perturbs timing. No game code or actor memory is written.
|
||||
|
||||
## Repaint observation and controlled test
|
||||
|
||||
Two initial main-thread snapshots contain the guarded OMT window-procedure return
|
||||
100F1ADA and its consistent local message value0F (WM_PAINT), with internal event7.
|
||||
Read-only GetUpdateRect later reports the entire1024×768 window pending. Original
|
||||
DLL source100F1330 converts paint to event7 and calls100F7050; its validation of
|
||||
engine-owned rectangles includes100F70BA→ValidateRect. The message pump
|
||||
100F11D0..100F129C drains queued messages before returning to the periodical loop.
|
||||
These bounded facts explain the diagnostic target; they do not prove all startup
|
||||
time is spent in a single call or that native Windows has the same failure.
|
||||
|
||||
`--acknowledge-repaint` makes one ordinary Win32 ValidateRect(window,NULL) call
|
||||
after the second sample. The operation is explicit in output and changes only
|
||||
the OS window update region. It is an intervention, so no result is presented as
|
||||
an untouched original frame/timing trace.
|
||||
|
||||
Matched24s tests use the same standard-resolution executable, generated prefix,
|
||||
sampling tool and no synthetic keyboard input:
|
||||
|
||||
| Condition | Observed result |
|
||||
|---|---|
|
||||
|No acknowledgement|16 samples through24.35s: MAIN only, no Jimmy.|
|
||||
|One acknowledgement at3.10s|Pending full-window region acknowledged. By9.18s, current game table4C444C (Level1D), Jimmy table4A373C, with MAIN still in the registry.|
|
||||
|
||||
The HD variant also progresses to the same allocation boundary after the recorded
|
||||
acknowledgement. Both resolutions remain black with sampled gameplay-viewport
|
||||
delta0 and raw ownerNULL. No usable Carl, completed New Game, completed PostLoad,
|
||||
or playable-render reference is established. The source trace of
|
||||
[menu/player lifetime](main-menu-player-lifetime.md) supplies the subsequent
|
||||
successful-TSK retention proof; these captures establish the previously unseen
|
||||
background allocation, not that complete later route.
|
||||
|
||||
## Subject and code identity
|
||||
|
||||
HDnoCD SHA2568cd5d21997835a40978b8b83e344c97c92217bf6cd6858f7458b76935d64dedb,
|
||||
standard NoCD SHA2565e1d3bed2d649d16ec62ead02514119a16590380d4d5a6a73103db900a15c62e.
|
||||
Their only mutual byte differences are resolution-data offsetsF655E,F655F,F6561:
|
||||
standard640×480 versus HD1920×1080, both16-bit. The Xvfb desktop is1024×768.
|
||||
This difference prompted the controlled standard-resolution check; switching
|
||||
resolution alone is not claimed to repair rendering. Neither variant is assumed
|
||||
equivalent to canonical Neutron.exe.
|
||||
|
||||
Standard-subject REA file-header Evidence:
|
||||
`ev_62814154b8ddc13d5db3c1150082b91f0f7bf1eaccf1bca208b36671a7a1bd81`.
|
||||
HDnoCD complete instruction Evidence:
|
||||
`ev_23555fac476985c913a80805a12b25c26c25347c6e8210ee188471dd815c276d`.
|
||||
Relevant OMT instructions come from retained DLL Evidence
|
||||
`ev_af082632c98b34ccfcedef01466cafa03365e7fbf482496d01a4cda6d2f8f787`;
|
||||
that saved disassembly is a prefix, not complete DLL coverage. The relevant
|
||||
window/message ranges are present. Original file identity is independently
|
||||
checked by the project inventory and PE mapping.
|
||||
|
||||
Artifacts under `artifacts/original-startup-diagnostic/` retain each probe binary,
|
||||
capture identity, stdout, screenshots, module/stack/state samples and final
|
||||
standard probe/dependency source. `standard/` is the acknowledged matched run;
|
||||
`standard-no-ack/` is the control. All actual live anchors pass. Successful capture
|
||||
requires process exit0 and `ORIGINAL_STARTUP_DIAGNOSTIC_COMPLETE`.
|
||||
|
||||
## Reproduction
|
||||
|
||||
Build against the source observer in the same tools directory. Reuse only the
|
||||
existing generated game copy/prefix; never use an original directory as output.
|
||||
|
||||
```sh
|
||||
i686-w64-mingw32-gcc -std=c11 -O2 -Wall -Wextra -Werror \
|
||||
tools/recon/original_startup_probe.c -lbcrypt -o artifacts/startup-probe.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/startup-probe.exe \
|
||||
--probe-model=--standard-resolution --probe-arg=--seconds=24 \
|
||||
--probe-arg=--acknowledge-repaint \
|
||||
--probe-success ORIGINAL_STARTUP_DIAGNOSTIC_COMPLETE --seconds 30 \
|
||||
--output artifacts/jimmy-skip-original-sw
|
||||
```
|
||||
|
||||
Omit the acknowledgement argument for the control. Keep each capture in a
|
||||
separate generated directory or preserve its logs/identity before another run.
|
||||
@@ -0,0 +1,222 @@
|
||||
# Read-only original process-state observer
|
||||
|
||||
2026-11-06. This investigation tool is separate from the modern runtime. It is
|
||||
intended to establish actual startup registry state and narrow the unresolved
|
||||
Carl skip-to-idle discrepancy. It does not supply a gameplay fix or certify exact
|
||||
callback order. No original execution is claimed by the initial compile/guard
|
||||
checks below.
|
||||
|
||||
## Execution boundary
|
||||
|
||||
`tools/recon/original_state_observer.c` launches one explicitly attested generated
|
||||
game copy with `CreateProcessA`, samples it with `ReadProcessMemory`, then requests
|
||||
ordinary `WM_CLOSE` on that process's own visible window. It never writes target
|
||||
memory, installs breakpoints, invokes target functions, forces actor state, or
|
||||
terminates another process. If ordinary close does not succeed, the child remains
|
||||
running; the caller must handle its own isolated environment. Existing Wine
|
||||
capture infrastructure cleans up only its private wineserver afterward.
|
||||
|
||||
The first argument must be `--copied-game=<path>`. This is the caller's explicit
|
||||
attestation that the target is a generated copy. Both the absolute path and the
|
||||
handle-resolved final path reject a case-insensitive `Original` path component.
|
||||
The tool accepts only the three exact hashes below and the original1019904-byte
|
||||
file size. It holds an authenticated read handle without write/delete sharing
|
||||
through process creation. The flag is not a cryptographic proof of provenance;
|
||||
use the existing generated-copy wrapper, never a hard link to an original file.
|
||||
|
||||
Alternatively, `--attach-copied-pid=<PID>` explicitly attests that an already
|
||||
running process uses a generated copy. This mode acquires only
|
||||
`PROCESS_VM_READ | PROCESS_QUERY_LIMITED_INFORMATION | SYNCHRONIZE`, obtains its
|
||||
actual image path with `QueryFullProcessImageNameA`, and applies the same final
|
||||
path, size, file hash and live instruction guards. PID is a strict positive
|
||||
32-bit decimal value; malformed/overflowed values are rejected. The process
|
||||
handle binds the selected process throughout validation/sampling, rather than
|
||||
reopening a potentially reused PID. Attach mode never calls `CreateProcess`,
|
||||
focuses a window, sends input, requests `WM_CLOSE`, or terminates the target.
|
||||
`--menu-keys` is rejected before opening the process. Sampling ends while the
|
||||
original session remains under the user's control.
|
||||
|
||||
No network API is used. Run under `tools/recon/reference_capture.py` for its
|
||||
existing no-network/no-original-mount boundary. Native Windows execution must
|
||||
likewise use a generated directory containing copies of the game and its assets.
|
||||
Game-created settings/saves then remain in that generated environment.
|
||||
|
||||
## Supported subjects and evidence
|
||||
|
||||
| Profile | Exact executable SHA256 |
|
||||
|---|---|
|
||||
|canonical|`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`|
|
||||
|hd-resolution|`b6675b7e7f3fc37512185ddb4d6ce1fbe9a36c8b83f3b4b3ed6979a56db3d2d4`|
|
||||
|hd-nocd|`8cd5d21997835a40978b8b83e344c97c92217bf6cd6858f7458b76935d64dedb`|
|
||||
|
||||
Canonical instruction Evidence is
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
|
||||
retained in artifacts/jimmy-movement-audit/rea-original-disassembly.json.
|
||||
The HDnoCD subject has separate complete REA instruction Evidence
|
||||
`ev_23555fac476985c913a80805a12b25c26c25347c6e8210ee188471dd815c276d`,
|
||||
retained in artifacts/jimmy-skip-original-sw/rea-hdnocd-disassembly.json.
|
||||
The supplied HD resolution variant preserves the observed operands. The HDnoCD
|
||||
profile is independently identified; its observation is not automatically a
|
||||
canonical-original behavior claim. Other supplied variants are rejected.
|
||||
|
||||
2026-11-06 follow-up: the supplied standard-resolution NoCD image is now a fourth
|
||||
exact profile, SHA256
|
||||
`5e1d3bed2d649d16ec62ead02514119a16590380d4d5a6a73103db900a15c62e`.
|
||||
Its eight live global operands match the HDnoCD profile; independent source checks
|
||||
verify32 anchors across four subjects. The two NoCD images differ only at three
|
||||
resolution bytes; canonical-equivalence is still not assumed. Source checks are
|
||||
in artifacts/original-state-observer/profiles-4.json. Standard-subject REA Evidence
|
||||
and perturbed startup observations are in
|
||||
[the startup diagnostic](original-startup-diagnostic.md).
|
||||
|
||||
Each global address is independently guarded by its actual live instruction
|
||||
operand before sampling. Runtime inspection is refused if those anchors do not
|
||||
match within5s. This avoids assuming that the other variant has identical data
|
||||
addresses. Preferred-base VAs and PE file offsets follow:
|
||||
|
||||
| Read role | Instruction VA / file offset | canonical and HD global | HDnoCD global |
|
||||
|---|---|---|---|
|
||||
|Raw control owner|475A40..475A4B /75A40..75A4B setter|5099E4|509A04|
|
||||
|Registry sentinel pointer|473740 /73740 load|50999C|5099BC|
|
||||
|Viewport seconds|47374F /7374F load|696030|696050|
|
||||
|Current game complete pointer|46E360 /6E360 store|509948|509968|
|
||||
|Shared skip|430F3E /30F3E store|4F83E4|4F8404|
|
||||
|Input block|426062 /26062 load|4F8430|4F8450|
|
||||
|Modal gate|407060 /7060 load|4F8198|4F81B8|
|
||||
|Skip suppression|430F11 /30F11 compare|4F8182|4F81A2|
|
||||
|
||||
Registry nodes are `{next,previous,payload}` at offsets0/4/8, from the recovered
|
||||
46FF4A..46FF7F insertion and473740 traversal. Traversal stops at the sentinel,
|
||||
1024 nodes, an unreadable node or a repeated payload. `complete:false` means the
|
||||
sample cannot establish the whole list; mutation during a read is possible.
|
||||
Jimmy is recognized by game-interface vtable4A373C. The current game registry
|
||||
payload is its complete pointer+8C. A successful full-list sample records their
|
||||
actual indices without executing either actor or inferring constructor order.
|
||||
|
||||
Jimmy samples use the game interface: current Euler224..230, destination274..280,
|
||||
dirtyA, movement mode704, stored turn614, and action latch1D40 (=complete1E00).
|
||||
Support fields13F and4A0 are reported separately as cached and force-support
|
||||
bytes: actual458960 reads4A0 first, otherwise471A10 reads13F. They are not an
|
||||
executed support query. The source addresses are code-field contracts, not
|
||||
guessed layouts or corresponding fields from the modern simulation.
|
||||
|
||||
## Output and ordinary input
|
||||
|
||||
Output is bounded JSONL on stdout: authenticated identity, registry changes,
|
||||
nominal10ms state samples, optional normal input events, finish and completion
|
||||
marker. `Sleep(10)` is a sampling request, not a guaranteed interval or a game
|
||||
clock. Each record includes actual elapsed wall-clock milliseconds. Floating
|
||||
point NaN/infinity is written as JSON null. Narrow Win32 path/title bytes outside
|
||||
ASCII are escaped so the output remains valid JSON; use ASCII generated paths
|
||||
for reliable cross-machine reproduction.
|
||||
|
||||
`valid_mask` uses bits0..3 for readable skip/input/modal/suppression bytes, bit4
|
||||
for readable viewport delta, and bit5 for a readable full Jimmy field block.
|
||||
Zero values without the corresponding valid bit are placeholders, not evidence
|
||||
that the game state was zero. Jimmy fields are omitted without bit5.
|
||||
|
||||
By default no keys are sent. `--menu-keys` explicitly opts into ordinary Return
|
||||
presses at approximately3/6/9s, each held100ms while sampling continues. It finds
|
||||
only the child process's visible unowned window, requests normal window focus,
|
||||
and uses `SendInput` only when that window is foreground. Records include title,
|
||||
window/foreground handles, press/release and events accepted by `SendInput`.
|
||||
Accepted events do not prove that the game's input system consumed them or that
|
||||
a particular menu item was selected. This sequence is not a recovered New Game
|
||||
macro. `--copied-game-menu=<path>` is an explicit single-argument equivalent for
|
||||
the existing capture wrapper, which passes one `--probe-model` argument.
|
||||
|
||||
Samples consist of multiple independent reads without suspending the game. They
|
||||
can miss transitions shorter than the interval and can mix adjacent callbacks.
|
||||
They establish observed retained state and list membership; they cannot alone
|
||||
prove the first writer, same-frame control order, exact input/controller order,
|
||||
physics chronology, or the complete Carl skip lifecycle. A black screenshot is
|
||||
still not a usable visual reference even if process state can be read.
|
||||
|
||||
## Build and use
|
||||
|
||||
From GamePort:
|
||||
|
||||
```sh
|
||||
mkdir -p artifacts/original-state-observer
|
||||
i686-w64-mingw32-gcc -std=c11 -O2 -Wall -Wextra -Werror \
|
||||
tools/recon/original_state_observer.c -lbcrypt \
|
||||
-o artifacts/original-state-observer/observer.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/original-state-observer/observer.exe \
|
||||
--probe-model=--copied-game=NeutronHDnoCD.exe \
|
||||
--probe-success ORIGINAL_STATE_OBSERVER_COMPLETE --seconds 24 \
|
||||
--output artifacts/original-state-observer/capture
|
||||
```
|
||||
|
||||
The observer itself defaults to15s and accepts `--seconds=1..120` on native
|
||||
Windows. For normal
|
||||
input opt-in, substitute
|
||||
`--probe-model=--copied-game-menu=NeutronHDnoCD.exe` above. Original variants with
|
||||
a CD prompt may not proceed to gameplay in this environment; no prompt bypass or
|
||||
executable modification is implemented by this tool.
|
||||
|
||||
On native Windows, first start an ordinary generated copy and reach the desired
|
||||
Carl/tutorial route. Obtain that game's process ID, then start the observer from
|
||||
a separate terminal, redirecting stdout to a local trace:
|
||||
|
||||
```text
|
||||
observer.exe --attach-copied-pid=1234 --seconds=60 > carl-original.jsonl
|
||||
```
|
||||
|
||||
Replace1234 with the copied game's actual PID. The existing session is left
|
||||
running and receives no observer-generated input or close request. `--help`
|
||||
prints usage without opening a file or process. The same process path/hash
|
||||
restrictions apply even if another executable is named Neutron.exe.
|
||||
|
||||
Initial verification: MinGW32 compilation with all warnings treated as errors
|
||||
passes. All24 independently PE-mapped source anchors (8 per supported subject)
|
||||
match; artifacts/original-state-observer/source-guards.json records original
|
||||
hashes, exact bytes, addresses and file offsets. These are compilation/static
|
||||
checks only. The primary investigator owns subsequent isolated runtime captures,
|
||||
integration, additional evidence and any commit.
|
||||
|
||||
## Integrated Wine32 observation
|
||||
|
||||
The primary's generated-copy launch and focus/Return checks reach MAIN only:
|
||||
game-interface table4D0C0C, no Jimmy, black captures. An isolated xfwm4 desktop
|
||||
does not produce a usable gameplay reference. Viewport delta0 here does not prove
|
||||
the menu selected New Game or that menu/engine clocks share the gameplay clock.
|
||||
|
||||
The final attach revision is exercised by
|
||||
`tools/recon/original_observer_smoke.c`. This Wine-only driver requires the
|
||||
wrapper's generated `Z:\work\game` directory, launches the supplied HDnoCD
|
||||
copy, then attaches the observer for10s. It verifies observer exit0 and that the
|
||||
original remains active afterward, before sending its own child's ordinary close.
|
||||
The observer itself sends no input or close in attach mode.928 JSON samples parse,
|
||||
the exact live guards pass, and capture wineExit0 plus both completion markers
|
||||
are present. MAIN only is observed; this is API/tool validation, not a Carl trace.
|
||||
|
||||
The tested observer source/build hashes, driver identity, logs/capture metadata
|
||||
and parsed summary are in
|
||||
`artifacts/original-state-observer/attach-runtime/observations.json`. The initial
|
||||
launch capture lacked a pre-recorded observer executable hash and includes a
|
||||
Wine diagnostic interleaved with JSON; it is retained separately as a limited
|
||||
functional observation. The final attach capture has explicit build provenance
|
||||
and928 intact samples. Native Windows execution remains unverified.
|
||||
|
||||
Reproduce after building the observer and driver, using the already prepared
|
||||
generated Wine copy/prefix (no source original is mounted):
|
||||
|
||||
```sh
|
||||
i686-w64-mingw32-gcc -std=c11 -O2 -Wall -Wextra -Werror \
|
||||
tools/recon/original_observer_smoke.c -o artifacts/original-state-observer/attach-smoke.exe
|
||||
cp artifacts/original-state-observer/observer.exe artifacts/jimmy-skip-original-sw/observer-under-test.exe
|
||||
python3 tools/recon/reference_capture.py --asset-probe \
|
||||
--probe-executable artifacts/original-state-observer/attach-smoke.exe \
|
||||
--probe-success ORIGINAL_OBSERVER_ATTACH_COMPLETE --seconds 18 \
|
||||
--output artifacts/jimmy-skip-original-sw
|
||||
```
|
||||
|
||||
Primary's launch observation, before attach support: separate HDnoCD profile
|
||||
passes all live guards; normal focused menu input and an isolated window manager
|
||||
still yield only MAIN (game index0, interface vtable4D0C0C), no Jimmy, and delta0.
|
||||
The final run recorded2042 samples across22.02s. This validates the observer's
|
||||
bounded launch/read path under Wine, not original gameplay or Carl's return.
|
||||
Attach support was added for a reference machine where the user can reach the
|
||||
route before starting a bounded trace. Its strict compilation/source checks are
|
||||
separate from native Windows attach execution, which remains unverified here.
|
||||
+410
-1
@@ -1,8 +1,417 @@
|
||||
# Progress — 2026-11-05
|
||||
# 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.
|
||||
|
||||
Next-work plan: [recover interactions, then implement verified changes](checkpoint/next-work-plan.md).
|
||||
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
|
||||
ordering distinction: the original initializes a backgroundLevel1D/Jimmy before
|
||||
a successful TSK story load. The loader retains Jimmy and appends the new level
|
||||
game later. First playable story entry therefore uses player-before-input, just
|
||||
like subsequent retained transitions. Fresh direct-GAM order remains separate.
|
||||
|
||||
Program previously used that order only when carriedSave was non-null. The
|
||||
correction includes TSK-backed story entry and adds no movement/Euler reset.
|
||||
The strengthened Vulkan control-phase replay fails on baseline neutral tick0
|
||||
(destination roll−10.000001), then passes first input plus300 idle ticks after
|
||||
the correction, preserving heading and held-input/body/fire continuation.
|
||||
Eight managed trajectories coverLeft/Right, natural/skip and repeated scenes.
|
||||
All336 Python+2 HUD, managed projects and36 GPU/render passes succeed. Native Linux
|
||||
SDL/Vulkan1920×1080 control replay and VR04 powered keyboard/steering/resize pass
|
||||
with zero validation errors; the first returned-frame readback is inspected upright.
|
||||
Final build has zero warnings/errors; Windows x64 cross-publish passes. Source/
|
||||
test provenance is in artifacts/main-menu-player-lifetime/verified-change.json.
|
||||
Both packages identify clean runtime commit ea04210; each has519 byte-identical
|
||||
original copies,4285 matching prepared scene files and7 matching prepared audio
|
||||
files. Standalone Linux from /tmp, without SDK/development-library paths, passes
|
||||
the Carl neutral-return replay with all4 readbacks identical to development.
|
||||
That standalone run disables validation; the development run enables it and
|
||||
reports zero errors. The optional validation layer cannot load without its
|
||||
development library path (ErrorLayerNotPresent, retained diagnostic).
|
||||
The Windows package passes the same32-frame control replay under isolated
|
||||
Wine64, including first input/300 idle ticks and held-input return. Wine is
|
||||
preliminary compatibility evidence. Native Windows/original Carl execution stays
|
||||
unverified. All539 originals remain unchanged. Package identities and verification
|
||||
are in artifacts/main-menu-player-lifetime/package-{identity,verification}.json.
|
||||
|
||||
The additional derived-frame caller50 native cases and static body/visual-sync
|
||||
audit close their bounded omissions. A matched original-resolution Wine startup
|
||||
diagnostic progresses to backgroundJimmy allocation only after the recorded
|
||||
repaint acknowledgement; frames remain black. See
|
||||
[startup observations](gameplay/original-startup-diagnostic.md). These are
|
||||
perturbed allocation observations, not full original Carl or Windows fidelity.
|
||||
|
||||
## Earlier Carl lifecycle investigation and original-state observer
|
||||
|
||||
The accepted plan is underway; its gameplay correction gate remains open.
|
||||
[Integrated lifecycle trace](gameplay/jimmy-cutscene-lifecycle.md) records292 new
|
||||
bounded original-code cases:96 contact,8 input/controller/skip-prefix,48 task/
|
||||
objective and140 base/STOP. Complete DEFAULT pseudocode is recovered through a
|
||||
verified mapped analysis carrier. None supplies a source-supported movement reset;
|
||||
the original components reproduce the port's order-sensitive stale-bank writer.
|
||||
|
||||
A read-only Windows32 observer now launches or attaches to a verified **copied**
|
||||
original. Wine32 attach/read/leave-running integration passes928 samples, with
|
||||
observer exit0 and original still running. Local original rendering remains black:
|
||||
only MAIN, no Jimmy/gameplay reference, was observed. Native Windows Carl state,
|
||||
actual entry mode/turn, registry order and first-resume timing remain required.
|
||||
All539 originals are unchanged. Runtime a2e89c6/packages dae13ac and the48-case
|
||||
port diagnostic remain unchanged; no new gameplay fix or fidelity claim is made.
|
||||
|
||||
## Decompilation first: Carl skip-to-idle remains open
|
||||
|
||||
User reports the remaining tilt after skipping Carl and confirms original landing
|
||||
bank is normal. Further gameplay changes are paused for a focused decompilation
|
||||
checkpoint. Runtime a2e89c6/package dae13ac is preserved. The earlier correction
|
||||
covers entry/locked state; its moved-input resume check missed neutral return.
|
||||
|
||||
A read-only48-case port trace isolates the first stale target write: all24 fresh
|
||||
input-before-player cases retilt, all24 retained-order cases stay upright. Original
|
||||
control/default/cleanup boundaries do not prove a reset; source skip writes a
|
||||
Jimmy action latch plus shared skip state absent from the current fast-forward
|
||||
model. Three new REA/Ghidra pseudocode results and guarded actual GAM/contact/
|
||||
registry findings are retained. No gameplay fix is inferred from these local facts.
|
||||
See [decompilation gate](gameplay/jimmy-cutscene-decompilation.md),
|
||||
[port trace](gameplay/jimmy-cutscene-port-trace.md), and its source reports.
|
||||
|
||||
Research checkpoint checks: both source guards and all48 recorded diagnostic
|
||||
cases/provenance verify,539 originals unchanged, no src/tests/scripts changes.
|
||||
Source explanation of upright return after original skip is still open. This
|
||||
checkpoint preserves the reproducible failure and narrowed investigation;
|
||||
it does not mark the post-skip bug fixed or authorize speculative gameplay fixes.
|
||||
|
||||
## Jump tilt at cutscene and landing handoffs
|
||||
|
||||
Recovered CAM/MCA direct writes flatten both current and destination Euler to
|
||||
(0,currentYaw,0), preserving dirty; the old port cleared current only, allowing
|
||||
uncontrolled facing to restore the airborne tilt. Fixed that existing boundary,
|
||||
with20 isolated original-code cases, eight integrated handoff cases, and the
|
||||
native banked Carl/control-restoration replay passing. Input, body and fire
|
||||
ownership remain separate; see [handoff](gameplay/jimmy-rotation-handoff.md).
|
||||
|
||||
The separate idle-after-landing report has seven original ground-input/facing
|
||||
trajectories: neutral input retains residual bank; active input levels normally.
|
||||
No universal grounded snap is supported by those recovered paths, so no landing
|
||||
policy was invented. Whole-original frame ownership remains an explicit question;
|
||||
see [landing evidence](gameplay/jimmy-landing-rotation-source.md).
|
||||
|
||||
All336 Python tests and targeted managed checks pass; native Linux handoff,
|
||||
Carl and powered-flight replays report zero validation errors. Both packages
|
||||
identify clean dae13ac;519 original copies/4285 scene resources/seven audio files
|
||||
verify each. Standalone Linux repeats the handoff with three matching GPU captures;
|
||||
three flight captures also match the prior runtime.539 originals unchanged.
|
||||
Native Windows/whole-original frame comparison remain open.
|
||||
|
||||
## Turning animation and jetpack attachment feedback
|
||||
|
||||
Restored supplied six-frame jimleft/jimright clips to default preparation and
|
||||
|
||||
@@ -37,6 +37,26 @@ No native Windows installation/VM or Windows 98 image was available in the initi
|
||||
environment/tool inventory. A local reference machine remains necessary if Wine
|
||||
cannot render correctly. Native Windows port execution remains separately untested.
|
||||
|
||||
2026-11-06 follow-up: a fresh generated prefix initially lacked Wine builtin
|
||||
modules; missing files were copied only from the already-installed local Wine
|
||||
tree. Missing32-bit EGL/GBM/Wayland libraries were downloaded into the local cache
|
||||
and extracted under `.tools/native`, without a system installation. The supplied
|
||||
HDnoCD variant then creates its window without the earlier GL-context failure,
|
||||
but frames remain black. The normal Return/focus check and optional
|
||||
`--managed-desktop` (isolated `dbus-run-session`/xfwm4) do not establish playable
|
||||
startup. This is a different observed failure boundary, not a usable reference.
|
||||
Canonical Neutron/HD also encounter a CD prompt; no executable patch is applied.
|
||||
|
||||
[Read-only state observer](gameplay/original-state-observer.md) now supports a
|
||||
verified copied-original launch or attach. Its Wine32 attach smoke passes928
|
||||
samples and leaves the original running. Only MAIN, no Jimmy, was observed;
|
||||
native Windows Carl skip/return remains unverified. Variant identities, mappings,
|
||||
probe build/log hashes and setup details stay local in
|
||||
artifacts/original-state-observer/ and artifacts/jimmy-skip-original-sw/.
|
||||
`--probe-arg=VALUE` forwards repeatable generated-probe arguments, including
|
||||
option-shaped arguments, and `probe-identity.json` binds the executable hash and
|
||||
arguments before capture; a changed probe hash invalidates the observation.
|
||||
|
||||
## Preliminary Windows-port smoke under Wine64
|
||||
|
||||
`python3 tools/recon/reference_capture.py --port-smoke --seconds 24 --debug`
|
||||
|
||||
@@ -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
|
||||
|
||||
+218
@@ -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.
|
||||
|
||||
@@ -46,6 +176,94 @@ compile, runtime and original-fidelity verification are separate.
|
||||
|
||||
## Immediate continuation
|
||||
|
||||
Execution order and acceptance criteria: [next work plan](checkpoint/next-work-plan.md).
|
||||
|
||||
- [x] Close the first-story ordering distinction through original menu background,
|
||||
controlled-Jimmy TSK request, ordinary selective teardown and registry reuse.
|
||||
See gameplay/main-menu-player-lifetime.md. Preserve conditional fresh-GAM order.
|
||||
- [x] Correct TSK story-entry order; native Vulkan regression fails on baseline
|
||||
tick0 and passes first neutral input plus300 idle ticks after the change.
|
||||
Eight managed Left/Right/natural/skip/repeated-scene cases pass.
|
||||
- [x] Verify50 additional derived Jimmy caller cases and audit body-context/
|
||||
surface-alignment/visual-sync ownership without inventing an angle reset.
|
||||
- [x] Complete integrated suite:336 Python+2 HUD, all managed projects and36
|
||||
GPU/render passes; native Linux SDL control/VR04 input-steering-resize and
|
||||
Windows x64 cross-publish pass. No native Windows execution is inferred.
|
||||
- [x] Build clean ea04210 Linux/Windows packages; verify519 original copies,
|
||||
4285 scene files and7 audio files per platform. Standalone Linux from /tmp
|
||||
passes with4 identical readbacks; isolated Wine64 passes the Carl control
|
||||
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
|
||||
DEFAULT pseudocode through a mapped carrier. See gameplay/jimmy-cutscene-lifecycle.md.
|
||||
- [x] Implement copied-original read-only launch/attach observation; verify actual
|
||||
Wine32 attach,928 samples and leave-running behavior. Three exact subject profiles
|
||||
have24 source anchors. Native Windows remains separate.
|
||||
- [ ] Capture the actual original Carl banked-entry/skip/neutral-return interval.
|
||||
Local Wine reaches MAIN with black frames and no Jimmy; the composed original
|
||||
routines do not establish a reset. Use the observer on a working copied original
|
||||
for the remaining full-runtime comparison. The separately recovered TSK lifetime
|
||||
now supports the bounded startup-order correction. Preserve ordinary landing bank.
|
||||
|
||||
- [x] Current user direction: decompile the Carl skip-to-idle state
|
||||
lifecycle before further gameplay implementation. Baseline a2e89c6/dae13ac was
|
||||
preserved through that research checkpoint.
|
||||
Establish the missing source ordering before implementation. The successful TSK
|
||||
entry chain now closes that bounded gate; full original runtime comparison and
|
||||
broader core reconstruction stay open. See gameplay/main-menu-player-lifetime.md.
|
||||
- [x] Reproduce the remaining post-skip bug with48 managed port traces: all24
|
||||
fresh-order cases retilt, all24 retained-order cases stay upright. This is
|
||||
diagnostic evidence, not a source-justified scheduling or reset correction.
|
||||
|
||||
- [x] User airborne cutscene ENTRY tilt: reproduce and recover CAM/MCA current plus
|
||||
destination reset with dirty preserved; implement and verify20 original native
|
||||
cases, both player/input orders and native Carl handoff/resumption. See
|
||||
gameplay/jimmy-rotation-handoff.md.
|
||||
- [x] Investigate landing-idle tilt: seven original-component trajectories retain
|
||||
neutral residual bank and active steering levels. No supported universal snap.
|
||||
- [x] User confirms landing-idle residual bank also occurs in the original.
|
||||
Preserve it. The post-cutscene bank is a separate port bug; complete original
|
||||
frame comparison remains a fidelity gate for the skip path.
|
||||
|
||||
- [x] User feedback: restore original left/right turning animations and fix jetpack
|
||||
fire following pitch/roll as well as yaw. Source guards, visual/pose tests and
|
||||
native Linux rendering pass; see gameplay/jimmy-turn-fire-fixes.md.
|
||||
|
||||
Loaded 100 of 199 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user