86 lines
5.4 KiB
Markdown
86 lines
5.4 KiB
Markdown
# 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.
|