feat(01-05): complete offline Windows collection agenda and selftests
Prepare all session materials, explicit terminal outcomes and raw-media provenance while retaining open acceptance. Verify the package-free collector on synthetic fixtures without redistributing external tools.
This commit is contained in:
1 parent
c9b9f2eba9
commit
857466568d
4 files changed
+510
-22
No files matched your search
@@ -0,0 +1,204 @@
|
||||
# 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.
|
||||
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.
|
||||
Reference in new issue
Block a user