feat(01-06): collect bounded Linux capture and honest failed preflight
This commit is contained in:
1 parent
9c59f60b50
commit
16f5e126be
3 files changed
+439
No files matched your search
@@ -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.
|
||||
Reference in new issue
Block a user