feat(01-06): collect bounded Linux capture and honest failed preflight

This commit is contained in:
UnixNight committed 2026-11-13 11:56:08 -05:00
1 parent 9c59f60b50
commit 16f5e126be
3 files changed
+439

No files matched your search

+85
View File
@@ -0,0 +1,85 @@
# Local Linux fidelity capture
This joins the single final combined session described in
[windows-session.md](windows-session.md). Prepare locally; no early hands-on
session is requested. Every original/native acceptance obligation remains open
until actual evidence and human review. No gameplay/movement reset is added.
Use the existing sealed Linux package, not a rebuilt or relabeled package.
The 01-05 package is `artifacts/fidelity/01-05-packages/linux-x64`:
source `446930d2a30d6d616c60ac5e59e4169a840bea09`, dirty yes, publish diff
`90cef95669caece53fe2d2c4736cf2ac05ed27f5d25ca03ab572589686bcb73d`.
Its file-list hash is `124cf271e4952f3822eec5c24358447fcffc9e9e1803aded8d96d4d4472dc5a3`.
The collector checks all sealed bytes before launch and collection. Keep output
outside the package and originals, in a fresh session directory.
Select the actual local X11 display and capture rectangle, real Pulse monitor
source and physical input method. Save a local JSON settings object with these
exact fields (values below are examples, not observed devices):
```json
{"display_method":"x11","display":":0","audio_method":"pulse",
"audio_source":"actual-device.monitor","input_method":"physical",
"size":"1280x720","offset":"0,0"}
```
Inspect `pactl list short sources` and `pactl list short sinks` locally. Null/dummy
devices do not qualify. This collector implements X11/Pulse capture with installed
FFmpeg/ffprobe; it records unsupported Wayland/TTY/dependency conditions as failed
preflight. Do not install or select a guessed alternative automatically. Use a
separately identified existing recorder for unsupported display sources and retain
its actual settings, tool identity, raw recording and timing provenance.
```sh
bash scripts/collect-fidelity-linux.sh preflight --package artifacts/fidelity/01-05-packages/linux-x64 --settings /local/linux-settings.json
bash scripts/collect-fidelity-linux.sh run --package artifacts/fidelity/01-05-packages/linux-x64 --settings /local/linux-settings.json --output artifacts/fidelity/linux/unique-launch --session-id unique-launch --case-id fresh-natural-ordinary --scope dialogue-return --seconds 120
bash scripts/collect-fidelity-linux.sh collect --run artifacts/fidelity/linux/unique-launch --import-to artifacts/fidelity/linux-receipts
```
Nonzero run/collect exits preserve failure/abort output; inspect it, and collect
the failed run too. Recorder starts before the normal `--load-save NewGame.tsk
--walk` process and passive observer. This is the existing story entry, not an
implemented main menu. Close the game normally before the selected duration.
Both children have one bounded deadline; interruption ends only owned children.
Logs and metadata have explicit bounds; raw recording is capped at 8 GiB. Retain
the entire lossless FFV1/PCM MKV and tail; a detected frozen interval is an open
inspection flag, not a claim of failure or parity derived from a numeric tolerance.
Collection probes actual streams/duration and hashes logs/media/observer and
package/source/resource identities. The duplicate MKV audio alias preserves exact
bytes for the shared receipt's distinct audio role. No audio normalization,
retiming, crop repair or preview is implicit. If a browser needs a remux/preview,
retain raw media and explicit derivation command/version/hash/time mapping under
the existing shared derivative contract. The local viewer exporter consumes the
imported receipts; actual playback/seeking/audio/crop remain human review gates.
Record manual event annotations as `{"events":[...]}` using the exact fields in
`scenarios.json`: hashed raw artifact name, media and monotonic elapsed seconds,
method and uncertainty. Supply `collect --annotations /local/annotations.json`.
Port simulation ticks remain separate from raw clocks. Observer gate results
do not prove a physical key was pressed. Automated injection is `port_fixture`;
test doubles are permanently synthetic. No collector output grants acceptance.
## Actual 2026-11-13 preflight
The scoped host probe, outside sandbox device restrictions, found a TTY session,
no `DISPLAY` or `WAYLAND_DISPLAY` and no X11 socket. Existing FFmpeg/ffprobe are
available. Pulse exposes only `auto_null` and `auto_null.monitor` (suspended).
No Xvfb or OBS command resolved. A synthetic display or null audio would not
establish the requested normal visible/audible gameplay, so no game/recorder
was launched and no substitute route/media was fabricated.
The exact failed focused receipt is `linux-01-06-focused-preflight-linux`, at
`artifacts/fidelity/linux/01-06-focused-preflight/receipt.json`, imported into
`artifacts/fidelity/linux-receipts/linux-01-06-focused-preflight-linux/`.
`preflight.json` preserves observed OS, tool versions/hashes, Pulse devices and
available GPU/Vulkan diagnostics; missing SDL/active-instance runtime versions
remain explicit. The selected package/resource seal matches the hash above.
Both the failed result and its import validate structurally, with acceptance open.
Before collection, all 539 original files verified unchanged.
Required next physical session: provide an actual display/game capture source
and real audible device/monitor source, verify moving unobstructed content and
audio, then record physical normal controls and full tails. Inspect capture cost,
crop/aspect and actual browser playback/seeking separately. Preserve this failed
preflight as history; new attempts use new session IDs and fresh output roots.