docs(01): create verified fidelity baseline plans
This commit is contained in:
1 parent
36f24e4474
commit
cf64b8ce18
21 files changed
+1473
-32
No files matched your search
@@ -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.
|
||||
@@ -419,13 +419,16 @@ No dependency modernization or runtime architecture migration is proposed.
|
||||
|
||||
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
|
||||
## Open Questions — RESOLVED planning dispositions
|
||||
|
||||
1. **Actual DxWnd version/config and original launch behavior:** no successful Windows reference run is supplied by context. Prepare profile collection and preflight; retain limitations rather than inventing settings.
|
||||
2. **Windows capture/audio/browser availability:** user's PC is available, but tools/devices are unprobed. Include dependency checklist and one short test inside the combined session.
|
||||
3. **Original input precision:** minimum procedural input plus manual observed markers is honest but not exact original sampling. Label the method/uncertainty; add instrumentation only if a concrete comparison requires it.
|
||||
4. **Timing/image/audio tolerances:** no universal numeric parity threshold is established. Capture raw values and uncertainty first; later system owners justify thresholds from original evidence.
|
||||
5. **Historical applicability:** current reports contain historical package/runtime revisions and superseded defect narratives. Bind ledger claims by actual content and source report scope, not date or prose order.
|
||||
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
|
||||
|
||||
|
||||
@@ -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.
|
||||
@@ -30,15 +30,29 @@ created: "2026-11-12"
|
||||
|
||||
## Per-Task Verification Map
|
||||
|
||||
To be bound to final task IDs after planning/checking; planner must supply exact per-task automated commands and threat references. Required coverage:
|
||||
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.
|
||||
|
||||
| Behavior | Requirement / decisions | Verification |
|
||||
|---|---|---|
|
||||
| Original preservation, bounded fresh staging and source/copy distinction | EVID-01, D-15 | Existing inventory plus temporary-tree negative tests |
|
||||
| Receipt identity, imported media/event bounds, failed/incomplete runs remain open | EVID-02, EVID-04, D-13–D-16 | Fidelity Python tests with tamper/missing-media/NaN/partial-run fixtures |
|
||||
| Capability ledger, all requirements, scope-aware current/history, impact ordering | EVID-03, D-09–D-12 | Fidelity Python tests and generated local evidence review |
|
||||
| Full route, natural/skipped, fresh/retained, normal/edge inputs | EVID-02, EVID-04, D-01–D-04 | Matrix validator plus actual recorded original/native runs |
|
||||
| Paired playback, opt-in overlays, real speed/drift, exclusive audio | D-05–D-08 | Node logic tests plus actual local browser/media review |
|
||||
| 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
|
||||
|
||||
@@ -68,4 +82,4 @@ Unavailable/failed executions are recorded as open dependencies. Completing tool
|
||||
- [ ] Native/original capture limitations recorded
|
||||
- [ ] nyquist_compliant updated only after the implemented validation contract is audited
|
||||
|
||||
**Approval:** Pending execution; this draft describes validation, not results.
|
||||
**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.
|
||||
Reference in new issue
Block a user