Files

211 lines
15 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# One combined local Windows fidelity session
This is the prepared agenda for plan 01-07, not a request to capture now.
`READY.json` means immutable materials are prepared. It never means original,
native Windows, browser, audio or scenario acceptance passed. Linux PowerShell
selftests, cross-publish, Wine and synthetic media cannot fill those slots.
Keep every package, original copy, raw recording and result on local storage.
The checkpoint contains `manifest.json`, `READY.json`, both identified
`port/{linux-x64,win-x64}` packages, `original-pristine/`, writable
`original-runs/`, `protocol/`, offline `review/`, collectors, these instructions,
package-free selftests and `results/`. No SDK or Python is needed on Windows.
The manifest records actual package BUILD-INFO and sealed source identities;
the later bundle revision does not replace the runtime's source identity.
Do not alter immutable materials to make a preflight pass. Mutable results and
generated run copies stay outside that immutable hash set.
## Ordered session agenda
1. **Select local dependencies and capture provenance.** Transfer the entire
prepared checkpoint to a fresh local directory, preferably a short path with
sufficient recording space. Select the actual Windows PC, DxWnd executable,
original exported DxWnd profile, recorder, browser and any media-probe/
derivation executables already installed locally. No download, installer
redistribution, elevation or guessed DxWnd switches are part of this bundle.
Copy `protocol/settings-template.json` into `results/session-settings.json`
and fill observed values. Record each tool's actual local source, version,
SHA-256, settings/export and limitations, Windows build, GPU/driver, Vulkan
and SDL versions as actually available; missing identities remain pending.
The collector hashes selected external tool executables without copying them
into returned results. Retain settings/profile exports, not installers.
Initial recorder recommendation: **offline OBS Display Capture**, with the
actual monitor, capture source, crop/aspect, resolution/frame rate, encoder,
audio device/mix and MKV container recorded. Record notification/desktop
exposure and wrapper timing/rendering limitations in the local notes.
2. **Run immutable preflight and package-free selftests.** From the checkpoint
directory run the following exact commands. Require exit zero, at least eight
executed checks and zero failures; preserve the output in local session notes.
A missing PowerShell or dependency is a failure to record, not a silent pass.
```powershell
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Preflight
powershell.exe -NoProfile -File .\tests\fidelity-windows.Tests.ps1
```
PowerShell 5.1 is the Windows target; a `pwsh` run on Linux exercises tooling
only. Executables are launched directly with quoted arguments, never from
receipt-supplied commands. Keep script execution subject to the PC's existing
policy; record a policy failure rather than changing security policy here.
3. **Perform separate short original and native-port visual/audio preflights.**
Use new diagnostic IDs for each. Inspect the selected DxWnd distribution's
own local help/config. Import the user's retained exported profile and change
only executable/working-directory paths to the generated copy printed by the
collector; export that relocated profile to the result's artifacts directory.
Do not force timer, renderer or compatibility settings or guess profile syntax.
If automation is unsupported, use the transparent DxWnd GUI launch. Retain
original and relocated exports and describe exact changes. The collector opens
DxWnd with no assumed switches and does not infer the original child's exit.
Never select the authoritative installation or `original-pristine/` as target.
Play each raw preflight: require **visible moving game content, intelligible
game audio, correct crop and aspect**, rather than merely detected ffprobe
streams. Record failures before proceeding. Keep diagnostic runs separate
from required cases. Native port launch uses the existing NewGame.tsk story
entry; absence of a reconstructed menu remains an explicit comparison gap.
4. **Record all matrix cells and obligations.** Use `protocol/agenda.json` as
the checklist: 8 cells × 5 obligations × 2 Windows sides = **80 Windows
obligations**. The separate Linux side contributes 40; all **120** remain
subject to actual receipt validation and human review. The table below and
`protocol/scenarios.json` specify the matrix, actual route, required events
and end conditions. Each fresh run has a new launch ID and original copy.
For retained runs, record prerequisite lab departure to VR04 and return in
the same process/clock before the tested interval; do not relaunch or reset
state. Capture the retained generated-copy identity during that lifetime
with `-Action Retained`, preserving the original pre-copy identity. Start the
recorder before interaction, retain the entire raw MKV and audible tail,
then finalize the specific scope after the process ends. Follow each cell's
natural/skip and ordinary/held-input procedure through its focused setup.
5. **Review paired browser video and exclusive audio.** Open `review/index.html`
using the selected local browser. Return results are imported into a fresh
local review export for pairing; the initially empty viewer does not invent
captures. Preserve actual speed and separate raw clocks, annotate offsets,
playback drift, crop and uncertainty. Listen to only one source at a time.
Require actual browser playback/seeking/audio checks for every preview codec.
A codec name, probe success or file extension is insufficient. Retain raw MKV
even if the browser cannot decode it. If a preview or extracted WAV is needed,
use a selected existing local tool and retain exact executable/version/hash,
inert argv, UTC derivation time, raw/output identities, timestamp mapping and
crop/aspect changes. Never silently retime or discard the source. Record
unsupported codecs or inaudible/missing content as open failures.
6. **Collect, postflight and audit.** Finish each run with actual annotations,
recording files, observer logs, settings, DxWnd exports and limitations.
Include missed, skipped, aborted, crashed and incomplete runs. A process exit
or `captured` means collection only. Original-DxWnd provenance is separate
from native port receipts. Preserve generated originals and their post-run
changes, `copy-pre.json`, `retained-copy.json` where applicable and
`copy-post.json`; never restore them over the authoritative originals.
Re-run immutable preflight after collection and preserve output. Actual
review verdicts and shared schema/matrix validation remain separate gates.
7. **Return once using local transfer.** Copy the complete checkpoint (including
raw recordings, results and original-runs) by USB/local filesystem or existing
local share to a new return directory. Do not upload assets/packages/media.
Recheck manifest/READY SHA-256 and all immutable entries, then rehash all
receipt-linked artifacts on return using the shared Python receipt validator.
Preserve a source-side file/hash inventory for the mutable result and
original-runs trees and compare it with the returned copy before importing.
A mismatch or missing file is an explicit transfer failure. Do not overwrite
the source copy, canonical originals, historical packages or an earlier return.
## Matrix and required procedures
| Case ID | Lifetime | Carl dialogue | Physical input policy |
|---|---|---|---|
| fresh-natural-edge | Independent fresh launch | Natural completion | Held through dialogue/RETURN |
| fresh-natural-ordinary | Independent fresh launch | Natural completion | Ordinary play/release |
| fresh-skipped-edge | Independent fresh launch | Actual supported skip | Held through dialogue/RETURN |
| fresh-skipped-ordinary | Independent fresh launch | Actual supported skip | Ordinary play/release |
| retained-natural-edge | Observed departure/return, same lifetime | Natural completion | Held through dialogue/RETURN |
| retained-natural-ordinary | Observed departure/return, same lifetime | Natural completion | Ordinary play/release |
| retained-skipped-edge | Observed departure/return, same lifetime | Actual supported skip | Held through dialogue/RETURN |
| retained-skipped-ordinary | Observed departure/return, same lifetime | Actual supported skip | Ordinary play/release |
Every cell requires separate `continuous`, `dialogue-return`, `bank-left`,
`bank-right` and `landing-idle` obligations on both original-DxWnd and native
Windows port. Continuous means ordinary **lab → VR04 → lab → outside** in one
uninterrupted recording and process, including Carl dialogue, first neutral
input, both banked jumps/landings, gadget use, RETURN cleanup and outside arrival.
Focused clips retain their actual setup/prerequisite recording. A direct scene,
debug warp or injected fixture cannot replace the route or retained prerequisite.
Record keys, skip action and held/released boundaries as actually performed.
Preserve legitimate landing bank and the implemented TSK lifetime ordering;
do not insert a leveling reset or tune movement for the recording.
## Collector commands and failure results
Replace paths and IDs with actual selections. Commands are examples for the
later combined session; use a fresh unique ID for each independent launch.
Start external recording when prompted and keep the collector alive for the
entire retained setup and tested interval. The recorder/browser are identified,
not automatically driven. The `.cmd` wrapper is an optional equivalent entry.
```powershell
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Run -Mode port -SessionId port-fresh-natural-ordinary-continuous-01 -CaseId fresh-natural-ordinary -Scope continuous -RecorderPath 'C:\Tools\OBS\bin\64bit\obs64.exe' -BrowserPath 'C:\Tools\Browser\browser.exe' -SettingsPath '.\results\session-settings.json'
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Run -Mode original -SessionId original-retained-natural-edge-bank-left-01 -CaseId retained-natural-edge -Scope bank-left -DxWndPath 'C:\Tools\DxWnd\dxwnd.exe' -ProfilePath 'C:\Local\exported.dxw' -RecorderPath 'C:\Tools\OBS\bin\64bit\obs64.exe' -BrowserPath 'C:\Tools\Browser\browser.exe' -SettingsPath '.\results\session-settings.json'
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Retained -SessionId original-retained-natural-edge-bank-left-01
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Finish -SessionId port-fresh-natural-ordinary-continuous-01 -AnnotationPath '.\results\port-notes.json' -ArtifactsDirectory 'D:\LocalCaptures\port-run-01'
powershell.exe -NoProfile -File .\scripts\collect-fidelity-windows.ps1 -Action Skip -Mode original -SessionId original-missed-01 -CaseId fresh-skipped-edge -Scope bank-left -Reason 'Actual reason this obligation could not run'
```
`Skip`/`Abort` create a new terminal result without requiring recorder/browser
selection. An interrupted active run retains its initial `incomplete.json`;
when safe, collect its artifacts with `Finish -Outcome aborted -Reason '...'`
instead of pretending a separate aborted launch describes its lifetime.
When only `incomplete.json` survived, this command preserves its exact bytes as
a diagnostic artifact and permits only `aborted`. End clocks remain absent;
initial placeholder end values are discarded. Keep recovered media and source
notes, with an empty `events` array because no complete launch interval was
observed. The receipt remains open and importable; recovery does not establish
missing executable identity, process completion, or a captured/reviewed run.
Failed starts preserve `run.json`, `failure.json` and available logs. To collect
failed/skipped/aborted media use `Finish -Outcome failed|skipped|aborted` matching
the prior status, a reason and annotation/artifact directories (empty arrays are
allowed for these outcomes). Never promote a failed or terminal run to captured;
use a new independent session for a retry. Existing evidence is write-once.
## Annotation field contract
Copy `protocol/annotation-template.json` to a mutable result note and fill it
with actual values. Empty templates cannot finalize capture. All paths are
relative, case-unique and contained below `ArtifactsDirectory`; no commands are
read from annotations. Every captured run retains a raw `.mkv` video and actual
audio evidence. If raw audio is embedded, retain a separately named byte-identical
MKV copy with role `audio`, or a proven extracted WAV with derivation provenance.
This preserves unique artifact paths while binding the actual audio bytes.
- `artifacts`: entries `{path, role, duration_seconds}`; roles include `video`,
`audio`, `input_events`, `prerequisite`, `diagnostic`. Preserve raw and preview
as separate entries. Original prerequisite recordings/copy-state records and
port `observer/events.jsonl`, summary, stdout/stderr must be included as
appropriate; do not rename synthetic fixtures as native evidence.
- `events`: `{name, artifact, media_seconds, elapsed_seconds, method,
uncertainty_seconds}` using the exact required names/order in scenarios.json.
Original methods are `manual` or `procedural`; markers describe visible input
and event intervals, never invented original simulation ticks. Port events
map observer data to actual media clocks; `simulation_tick` remains separate.
Preserve observer `launch_id`, `clock_id`, requested/accepted input distinctions,
sequence and possible truncation/overhead. Never reset elapsed clocks at scenes.
All times are finite, nonnegative and within actual recording/run duration.
- `derivatives`: `{path, source, tool, version, argv, created_utc,
timestamp_mapping, crop_aspect, browser_playback_verified}`. The collector
stores argv as inert provenance; it does not execute it. Select true browser
playback only after observed playback. Hash tool binaries and retain source
identity/settings in local session notes, including whether crop/time changed.
- `continuity`: `lifetime_id` equals session ID, `prerequisite_artifact` names a
hashed artifact, `copy_pre_sha256` binds the actual copy-state record. Retained
additionally needs `departure_session_id` and `return_session_id` equal to that
same session ID and `retained_copy_sha256` identifying the retained snapshot.
`prerequisite_departure` and `prerequisite_return` markers precede the tested
interval on the prerequisite artifact. Include these state records as hashed
identities/artifacts, never made-up placeholders. The port's actual package/
startup-state record must be identified separately; missing continuity remains
open rather than treating a second fresh launch as retained.
- `diagnostic`: true for observation overhead, preflight, fixtures or other
diagnostic limitations; `limitations`: actual missing tools, crop/audio/render/
timer/wrapper differences, incomplete transitions, uncertain markers and review
failures. A successful collector does not clear them or acceptance automatically.
`Finish` prefixes local media/event/derivative references with `media/` and hashes
copied bytes. It never accepts an annotation-supplied acceptance verdict. The
shared receipt validator and later full matrix/human review decide applicability.
No universal timing, pixel, angle or audio tolerance is asserted by this agenda.