Compare commits
3
Commits
29f8cb1714
...
96c5f2c00f
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
96c5f2c00f | ||
|
|
cf64b8ce18 | ||
|
|
36f24e4474 |
No files matched your search
+18
-2
@@ -39,7 +39,23 @@ Integer phases are planned work; decimal phases may be inserted for urgent recov
|
|||||||
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.
|
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.
|
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.
|
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:** TBD
|
**Plans:** 0/7 plans executed
|
||||||
|
**Wave 1**
|
||||||
|
- [ ] 01-01-PLAN.md
|
||||||
|
|
||||||
|
**Wave 2** *(blocked on Wave 1 completion)*
|
||||||
|
- [ ] 01-02-PLAN.md
|
||||||
|
- [ ] 01-03-PLAN.md
|
||||||
|
- [ ] 01-04-PLAN.md
|
||||||
|
|
||||||
|
**Wave 3** *(blocked on Wave 2 completion)*
|
||||||
|
- [ ] 01-05-PLAN.md
|
||||||
|
|
||||||
|
**Wave 4** *(blocked on Wave 3 completion)*
|
||||||
|
- [ ] 01-06-PLAN.md
|
||||||
|
|
||||||
|
**Wave 5** *(blocked on Wave 4 completion)*
|
||||||
|
- [ ] 01-07-PLAN.md
|
||||||
|
|
||||||
### Phase 2: Faithful Movement and Scene Handoffs
|
### 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.
|
**Goal:** Players move, contact the world and return from scripts/scenes with the original movement, animation, camera and state ownership intact.
|
||||||
@@ -135,7 +151,7 @@ Execution follows 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8, subject to the ex
|
|||||||
|
|
||||||
| Phase | Plans Complete | Status | Completed |
|
| Phase | Plans Complete | Status | Completed |
|
||||||
|-------|----------------|--------|-----------|
|
|-------|----------------|--------|-----------|
|
||||||
| 1. Reproducible Fidelity Baseline | 0/TBD | Not started | - |
|
| 1. Reproducible Fidelity Baseline | 0/7 | Planned | - |
|
||||||
| 2. Faithful Movement and Scene Handoffs | 0/TBD | Not started | - |
|
| 2. Faithful Movement and Scene Handoffs | 0/TBD | Not started | - |
|
||||||
| 3. Original Actors, Hazards and Combat | 0/TBD | Not started | - |
|
| 3. Original Actors, Hazards and Combat | 0/TBD | Not started | - |
|
||||||
| 4. Complete Gadget and Vehicle Use | 0/TBD | Not started | - |
|
| 4. Complete Gadget and Vehicle Use | 0/TBD | Not started | - |
|
||||||
|
|||||||
+13
-13
@@ -2,16 +2,16 @@
|
|||||||
gsd_state_version: "1.0"
|
gsd_state_version: "1.0"
|
||||||
current_phase: 1
|
current_phase: 1
|
||||||
current_phase_name: Reproducible Fidelity Baseline
|
current_phase_name: Reproducible Fidelity Baseline
|
||||||
status: planning
|
status: executing
|
||||||
stopped_at: "Phase 1 context gathered; next: gsd-plan-phase 1"
|
stopped_at: "Phase 1 planned and verified; next: gsd-execute-phase 1"
|
||||||
last_updated: "2026-11-12T17:11:39.360Z"
|
last_updated: "2026-11-12T22:38:11.076Z"
|
||||||
last_activity: 2026-11-12
|
last_activity: 2026-11-12
|
||||||
last_activity_desc: Initialized full-reconstruction roadmap with 33 requirements mapped once.
|
last_activity_desc: Phase 1 research and seven plans verified; ready to execute
|
||||||
state_head: 661e7c32990bfb8f7ba784c21c5dcc59d8f1c7ef
|
state_head: 36f24e4474909b299c38c07800823f43498a95a9
|
||||||
progress:
|
progress:
|
||||||
total_phases: 8
|
total_phases: 8
|
||||||
completed_phases: 0
|
completed_phases: 0
|
||||||
total_plans: 0
|
total_plans: 7
|
||||||
completed_plans: 0
|
completed_plans: 0
|
||||||
percent: 0
|
percent: 0
|
||||||
---
|
---
|
||||||
@@ -27,10 +27,10 @@ See: .planning/PROJECT.md (updated 2026-11-12)
|
|||||||
|
|
||||||
## Current Position
|
## Current Position
|
||||||
|
|
||||||
Phase: 1 of 8 (Reproducible Fidelity Baseline)
|
Phase: 1 (Reproducible Fidelity Baseline) — READY TO EXECUTE
|
||||||
Plan: None yet; phase plan count TBD
|
Plan: 0 of 7 executed; next plan 01-01
|
||||||
Status: Ready to plan
|
Status: Ready to execute
|
||||||
Last activity: 2026-11-12 — Initialized full-reconstruction roadmap with 33 requirements mapped once.
|
Last activity: 2026-11-12 — Phase 1 research and seven plans verified; ready to execute
|
||||||
|
|
||||||
Progress: [░░░░░░░░░░] 0%
|
Progress: [░░░░░░░░░░] 0%
|
||||||
|
|
||||||
@@ -81,6 +81,6 @@ No original-required category deferred outside full reconstruction. Later phases
|
|||||||
|
|
||||||
## Session Continuity
|
## Session Continuity
|
||||||
|
|
||||||
Last session: 2026-11-12T17:11:39.342Z
|
Last session: 2026-11-12T22:37:42.727Z
|
||||||
Stopped at: Phase 1 context gathered; next: gsd-plan-phase 1
|
Stopped at: Phase 1 planned and verified; next: gsd-execute-phase 1
|
||||||
Resume file: .planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md
|
Resume file: .planning/phases/01-reproducible-fidelity-baseline/01-01-PLAN.md
|
||||||
@@ -48,7 +48,8 @@
|
|||||||
"post_planning_gaps": true,
|
"post_planning_gaps": true,
|
||||||
"security_enforcement": true,
|
"security_enforcement": true,
|
||||||
"security_asvs_level": 1,
|
"security_asvs_level": 1,
|
||||||
"security_block_on": "high"
|
"security_block_on": "high",
|
||||||
|
"_auto_chain_active": false
|
||||||
},
|
},
|
||||||
"ship": {
|
"ship": {
|
||||||
"pr_body_sections": []
|
"pr_body_sections": []
|
||||||
|
|||||||
@@ -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,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,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,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,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,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,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,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,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,85 @@
|
|||||||
|
---
|
||||||
|
phase: "01"
|
||||||
|
slug: "reproducible-fidelity-baseline"
|
||||||
|
status: draft
|
||||||
|
nyquist_compliant: false
|
||||||
|
wave_0_complete: false
|
||||||
|
created: "2026-11-12"
|
||||||
|
---
|
||||||
|
|
||||||
|
# Phase 01 — Validation Strategy
|
||||||
|
|
||||||
|
## Test Infrastructure
|
||||||
|
|
||||||
|
| Property | Value |
|
||||||
|
|---|---|
|
||||||
|
| Framework | Existing Python stdlib unittest, standalone .NET 10 console projects; proposed 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` (new tests created with their owning slice) |
|
||||||
|
| Viewer quick command | `node --test tests/fidelity-viewer.test.mjs` (new test file created with viewer slice) |
|
||||||
|
| Full suite command | `scripts/test.sh` plus the viewer quick command |
|
||||||
|
| Runtime | Quick target below 30 seconds; measure during execution. Full GPU/original-data suite runs at wave boundaries and has a separate measured duration. |
|
||||||
|
|
||||||
|
## 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. These tests are intended new artifacts, not checks already executed.
|
||||||
|
|
||||||
|
| Task | Wave | Exact automated command binding | Minimum count / threat refs |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 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 |
|
||||||
|
| 01-01-02 | 1 | 01-01-PLAN.md task 01-01-02: counted `test_fidelity_scenarios.py` runner | 12; T-01-02 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
| 01-03-01 | 2 | 01-03-PLAN.md task 01-03-01: counted `test_fidelity_ledger.py` runner | 12; T-01-07/08/09 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
| 01-06-01 | 4 | 01-06-PLAN.md task 01-06-01: counted `test_fidelity_capture.py` runner | 10; T-01-16/17/18 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
| 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 |
|
||||||
|
|
||||||
|
All plan subcommands/paths are explicitly introduced in their owning tasks before verification. Run every focused task command after that task; at integrated checkpoint run the full suite once and repeat only after changes/failures. Quick checks target below 30 seconds, to be measured. Existing full suite and native runs can take longer and record separate durations. No new runtime/fixture/Windows results are claimed here.
|
||||||
|
|
||||||
|
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
|
||||||
|
|
||||||
|
- Each implementation slice creates meaningful tests together with its production code; no empty stubs counted as validation.
|
||||||
|
- Create fidelity test fixtures covering changed/missing/added originals, output overlap, symlink/drive/case escape, reused session, tampered hash, invalid marker and unsupported schema.
|
||||||
|
- Create 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.
|
||||||
|
|
||||||
|
## Validation Sign-Off
|
||||||
|
|
||||||
|
- [ ] Final plans bind every task to automated checks or explicit human/native evidence
|
||||||
|
- [ ] Sampling continuity has no three consecutive tasks without automated verification
|
||||||
|
- [ ] New test files exist and execute nonzero test counts
|
||||||
|
- [ ] No watch-mode flags
|
||||||
|
- [ ] Quick feedback latency measured below 30 seconds
|
||||||
|
- [ ] Native/original capture limitations recorded
|
||||||
|
- [ ] nyquist_compliant updated only after the implemented validation contract is audited
|
||||||
|
|
||||||
|
**Approval:** Pending execution; final task bindings are planned, while nyquist_compliant and wave_0_complete remain false until actual implementation and validation are audited.
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
No external API integration: Phase 01 implements local filesystem provenance, native process capture, offline media review and a contained loopback file viewer; it consumes existing game/tool executables without adding a hosted service, external SDK integration or remote API capability.
|
||||||
@@ -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,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": "Advance to the next step",
|
||||||
|
"reason": "Phase 1 of 8 · 0% · executing"
|
||||||
|
},
|
||||||
|
"updated_at": "2026-11-12T22:37:08.492Z"
|
||||||
|
}
|
||||||
@@ -1,5 +1,13 @@
|
|||||||
# Compatibility and validation
|
# Compatibility and validation
|
||||||
|
|
||||||
|
## 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
|
## Planned Phase 1 capture setup — 2026-11-12
|
||||||
|
|
||||||
The user has a local Windows PC for combined reference/port checkpoint sessions.
|
The user has a local Windows PC for combined reference/port checkpoint sessions.
|
||||||
|
|||||||
@@ -1,5 +1,15 @@
|
|||||||
# Decisions
|
# Decisions
|
||||||
|
|
||||||
|
## 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
|
## Phase 1 comparison decisions — 2026-11-12
|
||||||
|
|
||||||
Use full lab → VR04 → lab → outside journeys plus focused normal/edge-input
|
Use full lab → VR04 → lab → outside journeys plus focused normal/edge-input
|
||||||
|
|||||||
@@ -1,5 +1,16 @@
|
|||||||
# Progress — 2026-11-07
|
# Progress — 2026-11-07
|
||||||
|
|
||||||
|
## 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 discussion complete — 2026-11-12
|
||||||
|
|
||||||
Phase 1 context and the discussion audit are captured in
|
Phase 1 context and the discussion audit are captured in
|
||||||
|
|||||||
+3
-1
@@ -6,7 +6,9 @@
|
|||||||
and8 playable-slice phases in `../.planning/`.
|
and8 playable-slice phases in `../.planning/`.
|
||||||
- [x] Discuss phase1: Reproducible Fidelity Baseline; capture all four areas and
|
- [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`.
|
the Windows/DxWnd setup in `../.planning/phases/01-reproducible-fidelity-baseline/01-CONTEXT.md`.
|
||||||
- [ ] Plan phase1 (`$gsd-plan-phase 1`). Keep original/native
|
- [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
|
Windows access dependencies open; independent source-backed recovery may
|
||||||
continue under the explicit roadmap exception.
|
continue under the explicit roadmap exception.
|
||||||
- [ ] Execute the roadmap with current evidence/admission gates; initialization
|
- [ ] Execute the roadmap with current evidence/admission gates; initialization
|
||||||
|
|||||||
Reference in new issue
Block a user