Merge origin/main and record coordinator panel observation

app/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "frame-control",
-  "version": "0.4.17",
+  "version": "0.4.16",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "frame-control",
-      "version": "0.4.17",
+      "version": "0.4.16",
       "license": "MIT",
       "devDependencies": {
         "electron": "^44.4.5",

app/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frame-control",
   "productName": "Frame Control",
-  "version": "0.4.17",
+  "version": "0.4.16",
   "description": "Desktop app for managing a Valve Steam Frame over SSH",
   "private": true,
   "main": "main.js",

docs/evidence/clip-long-2026-10-24.json

@@ -1,29 +0,0 @@
-{
-  "date_utc": "2026-10-24",
-  "version": "v0.4.17",
-  "steam_os_version": "0.5.6",
-  "steam_os_build": "20261015.6141207",
-  "result": "PASS: the real Steam-saved clip exported beyond 60 seconds",
-  "method": "Steam manual recording of a reserved test title, then Frame Control's production frame_clips.export_clip path; no packaged GUI button click",
-  "source": {
-    "kind": "saved Steam clip",
-    "duration_seconds": 100.801,
-    "chunks": 68,
-    "gaps": 0
-  },
-  "export": {
-    "format": "MP4",
-    "bytes": 1377849,
-    "sha256": "82ef31f65e6933d122bc326d664beb2eb2e3ba6969f26c0032552e80fbe8d823",
-    "duration_seconds_ffprobe": 100.833335,
-    "video": "H.264, 1920x1080, 6049 frames",
-    "audio": "AAC, 48000 Hz, stereo",
-    "full_ffmpeg_decode": "passed without errors"
-  },
-  "cleanup": "Restored Steam recording mode to its prior off setting; stopped and removed only the reserved title and its processes; no recording or running Steam apps remained; Game Mode active, battery 100%, shared test lock released",
-  "limits": [
-    "This exercised the production export code path, not a packaged GUI Export click.",
-    "Visible gameplay quality, perceptual audio/video sync, trims and longer recordings were not checked.",
-    "The newly saved Steam source clip was retained; no user recording was deleted."
-  ]
-}

docs/evidence/clip-packaged-export-2026-10-24.json

@@ -1,94 +0,0 @@
-{
-  "date_utc": "2026-10-24T09:08:35.523Z",
-  "result": "PASS: packaged Electron visible Export click saved the retained real Steam clip beyond 60 seconds",
-  "frame_control_tag": "v0.4.17",
-  "documentation_base_commit": "4e456480aefbe541e334dbd247328537f535bd94",
-  "host": "lxso2",
-  "steamos_version": "0.5.6",
-  "steamos_build": "20261015.6141207",
-  "package": {
-    "asset": "Frame-Control-linux-x86_64.AppImage",
-    "url": "https://github.com/saphid/frame-control/releases/download/v0.4.17/Frame-Control-linux-x86_64.AppImage",
-    "sha256": "b1b8eb82bf73a227b2cd36e8f0ef3a2ebdf7967c5853efb08a9634f38227015d",
-    "launch": "Verified release asset; --appimage-extract, then unmodified squashfs-root/AppRun. Electron used the bundled server and Python, not checkout source.",
-    "display": "Xvfb :137, 1440x1000x24; Electron window 1400x950 including native chrome",
-    "flags": [
-      "--no-sandbox",
-      "--disable-gpu",
-      "--remote-debugging-port=49371",
-      "--remote-debugging-address=127.0.0.1",
-      "--user-data-dir=/tmp/frame-packaged-export-20261024/electron-profile"
-    ],
-    "isolation": "Throwaway XDG_CONFIG_HOME, FRAME_CONTROL_DATA_DIR and Electron profile; telemetry and update checks disabled; existing SSH identity and normal home Videos destination used."
-  },
-  "ui": {
-    "navigation": "Dismissed optional email prompt with No thanks; clicked Tools, then Capture & Live; scrolled Steam clips into view.",
-    "row": "Steam recording \u00b7 Clip; Oct 24, 8:53 AM \u00b7 1:40 \u00b7 2 MB",
-    "action": "Playwright connected to this Electron instance over local CDP; locator.click() clicked its visible button named exactly Export. The test did not directly invoke an export function or API POST.",
-    "button": "button.small[data-clip-export=\"0\"]",
-    "click_is_trusted": true,
-    "button_bounds_css_pixels": {
-      "x": 1300.390625,
-      "y": 701.15625,
-      "width": 61.609375,
-      "height": 28
-    },
-    "post_clips_export_http": 200,
-    "job": "0ab20b1788adce63",
-    "job_poll_http": 200,
-    "saved_message": "Saved clip_15658413054201167872_20261024_085343.mp4 to ~/Videos/SteamFrame",
-    "final_row": "ON PC; Export again",
-    "screenshots": [
-      "clip-packaged-export-2026-10-24-before.png",
-      "clip-packaged-export-2026-10-24-after.png"
-    ],
-    "screenshot_scope": "Cropped to Steam clip rows and saved notification; unrelated screenshot thumbnails and host connection identity excluded."
-  },
-  "source": {
-    "clip_id": "10230640/clips/clip_15658413054201167872_20261024_085343",
-    "duration_seconds": 100.801,
-    "duration_provenance": "Retained real Steam clip from clip-long-2026-10-24.json; current packaged UI displays 1:40."
-  },
-  "output": {
-    "path": "~/Videos/SteamFrame/clip_15658413054201167872_20261024_085343.mp4",
-    "bytes": 1377849,
-    "sha256": "82ef31f65e6933d122bc326d664beb2eb2e3ba6969f26c0032552e80fbe8d823",
-    "matches_prior_production_export_size_and_sha256": true,
-    "duration_seconds_ffprobe": 100.833335,
-    "duration_difference_from_steam_seconds": 0.032335,
-    "video": "H.264, 1920x1080, 6049 decoded frames",
-    "audio": "AAC, 48000 Hz, stereo, 4724 decoded audio frames",
-    "validation": [
-      "ffprobe -v error -count_frames -show_entries format=duration,size:stream=codec_name,codec_type,width,height,sample_rate,channels,nb_read_frames -of json <output>: exit 0",
-      "sha256sum <output>: exact match to prior production export",
-      "ffmpeg -v error -xerror -i <output> -f null -: exit 0, no errors"
-    ]
-  },
-  "cleanup": {
-    "shared_lock": "Acquired with ssh frame mkdir /tmp/frame-test.lock after read-only battery/build/lock checks; released with rmdir after app shutdown; absence read back.",
-    "battery_percent_before": 99,
-    "battery_percent_after": 99,
-    "battery_status": "Not charging; charger Full",
-    "packaged_app_and_server_exited": true,
-    "test_xvfb_stopped": true,
-    "frame_export_cache_directories_remaining": 0,
-    "ffmpeg_processes_after": 0,
-    "game_mode_and_steamvr_running_after": true,
-    "steam_source_clip_retained": true,
-    "user_recordings_deleted": false,
-    "headset_install_or_settings_changes": false,
-    "local_export_retained": true
-  },
-  "limits": [
-    "The unchanged AppImage payload ran after extraction on a virtual X desktop, with Chromium sandbox and GPU disabled. FUSE mounting, desktop integration and hardware rendering were not tested.",
-    "The click was automated trusted pointer input in a visible Electron window on Xvfb, not a human click on a physical monitor. T3 collaborative preview opened successfully but drives separate browser tabs; Electron-native automation was used for this window.",
-    "No new game or Steam recording was started. Visible gameplay quality, audible content and perceptual audio/video sync were not assessed.",
-    "Clips longer than this retained 100-second clip, trims and automatic copying remain unverified.",
-    "No release, tag or application code was changed."
-  ],
-  "validation_local": {
-    "clip_regression_suite": "python3 -m unittest discover -s tests -p test_clips.py -v: 34 tests passed in 20.173s, including real ffmpeg long-recording export",
-    "json": "python3 -m json.tool: passed",
-    "diff": "git diff --check: passed"
-  }
-}

docs/recording.md

@@ -170,42 +170,14 @@ The temporary server stopped, the shared device lock was released, and the
 headset remained in Game Mode at 99% battery. See
 [`docs/evidence/clip-gui-export-2026-10-24.json`](evidence/clip-gui-export-2026-10-24.json)
 for the narrow proof. This did not exercise the packaged desktop installer.
-
-On 2026-10-24, the exact v0.4.17 tag exported a second real Steam-saved clip
-through `frame_clips.export_clip`, the same production path used by **Export**.
-Steam listed the clip at **100.801 seconds**, with 68 chunks and no gaps. The
-copied MP4 was **100.833 seconds** by `ffprobe` and decoded completely with
-`ffmpeg`; it was not cut at 60 seconds. The test restored Steam's recording
-mode, removed its reserved title and processes, and left Game Mode active at
-100% battery. See [the long-clip evidence](evidence/clip-long-2026-10-24.json).
-That code-path test did not click **Export** in the packaged desktop app or
-verify visible gameplay quality or perceptual audio/video sync.
-
-Later that day, the published v0.4.17 x86_64 Linux AppImage also passed the
-packaged desktop **Export** check against the retained 100.801-second clip.
-The asset SHA-256 was verified before launching its unchanged extracted payload
-in an isolated Electron profile on a virtual X desktop. An automated pointer
-click on the visible **Tools → Capture & Live → Steam clips → Export** button
-saved the MP4 and changed the row to **ON PC / Export again**. The saved file
-was 100.833335 seconds, decoded completely, and matched the prior production
-export by size and SHA-256. The app and test display were closed,
-the Frame export cache was empty, the source clip was retained, and the shared
-lock was released at 99% battery with Game Mode and SteamVR still running.
-See [the packaged export evidence](evidence/clip-packaged-export-2026-10-24.json)
-and its cropped before/after screenshots. This verifies the packaged Electron
-button and bundled export path; AppImage FUSE mounting, desktop integration,
-physical display/GPU rendering, gameplay quality and perceptual sync remain
-unverified. The virtual-display launch used `--no-sandbox --disable-gpu`.
-
 Remaining checks include:
 
 - Perceptual audio/video sync and audible content. Frame Control's separate
   **Record** path stamps camera and audio inputs with the wall clock because
   they otherwise count from different clocks.
-- Clips longer than the 100-second test and trims starting partway through a
-  Steam recording. Two real saved clips' directory layouts were checked; the
-  parser remains deliberately loose
-  for other layouts.
+- Long saved clips, trims starting partway through a Steam recording, and the
+  packaged desktop app's **Export** button. One real saved clip's directory
+  layout was checked; the parser remains deliberately loose for other layouts.
 - How much x264 at 1080p30 costs the Frame while a game is running.
 - Automatic copying: that 30 seconds without a write is a safe sign Steam has
   finished saving a clip, and how a once-a-minute listing feels on the Frame.