docs(testing): log the 1.9.5-rc.2 regression pass

[EtienneLescot]

What

The manual e2e record for the 1.9.5-rc.2 candidate, plus the one correction this pass made to its own instructions.

Scope was deliberately the 65 commits since v1.9.2, not the rc.2 delta — a release candidate is judged against the last thing users actually installed. ~20 of those commits are in the Windows capture helper, so the net is weighted there.

Run against release/v1.9.5 @ b1b81de5 with the CI-built rc.1 native payload. That payload is the rc.2 payload: nothing under electron/native/ or crates/ changed since the rc.1 tag, verified by diffing the file list.

Result: pass, no defect

Four recordings. Highlights, all measured rather than eyeballed:

• Container — every recording a fragmented MP4, mvex present, ~1 moof/s, mfra only after a clean stop.
• The [Bug]: Error: Failed to encode WGC frame #336 regression has not crept back — videoInput: cpu-rgb32, so the GPU DXGI path is still opt-in.
• No capture-pacing drift (c9ff08ac) — HUD 00:59 → 60.067 s at 60/1.
• Waveform correct in both directions (9e00d11a) — absent with no audio track, rendered with one.
• Audio — AAC 48 kHz stereo muxed into the fragmented container, 15 ms A/V drift, under one frame at 60 fps.
• Compositor with no camera (9c6f2e1f, 462b5572) — preview renders and export completes.
• fix(editor): import a recording once, so reopening keeps the project you saved #366 — reopening returns to the saved project with its settings intact (Blur BG on, padding 9 %), and mints no second project: 167 → 168 across an entire new recording.
• fix(recording): open the recording a failed stop left playable #363 — helper killed mid-recording, editor opens on the recovered take (46 moof, no mfra), all three sidecars written.
• fix(recording): open the recording a failed stop left playable #363 × fix(editor): import a recording once, so reopening keeps the project you saved #366 together — the case neither PR tested, and the only one that exists solely in rc.2: a recovered recording is imported once, into one project.
• Export from that recovered take — MP4 1080p60, 46.0 s / 2760 packets, decodes clean, duration matches the source exactly. A salvaged recording is not merely openable, it is shippable.
• Tray refocus works.

Not covered, and why

DPI scaling (60bb6d7c, 71cc88d6) — not re-run here; already validated when those two landed. My first draft of this row said "this machine is at 100 %, those bugs are structurally invisible here", which is wrong: the display scale is a setting, changing it takes about two minutes, and doing so has been the documented procedure since #346. Skipping was a choice, and the record now says so rather than dressing it up as a constraint. Webcam PiP and the export webcam fixes (056cfc39, 26ad478c) — no camera in the loop. Microphone, GIF, macOS/Linux, AI sections, packaging.

The AGENTS.md change

Yesterday's staleness warning said to date "the binary". So I refreshed the capture helper and nothing else — and the export then died on:

native bridge compositor.exportMulti failed: open_input: -22 (Invalid argument)

That reads exactly like a product regression, and I nearly reported it as one. The recording was fine: ffmpeg -f null - opened the same file from the command line and decoded it end to end. The compositor addon was four days older than the av* DLLs it was built against. A full hash diff of electron/native/bin/<platform>/ turned up sixteen files differing and two missing outright.

Copying the whole directory and re-running the identical export made it pass. So the unit of staleness is the directory, not the binary, and the doc now says so — with the failure mode named, because "mismatched native set" presents as a bug in whatever you happened to be testing.

Checks

node scripts/check-docs.mjs → OK (31 files). Docs only; no code touched.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 24097f2f-d29c-4d66-8db4-c7d503809706

📥 Commits

Reviewing files that changed from the base of the PR and between d5b1e8f and e489164.

📒 Files selected for processing (2)

• AGENTS.md
• technical-documentation/testing/manual-e2e-checklist.md

---

📝 Walkthrough

Walkthrough

The pull request updates native-binary refresh guidance and adds a Windows 11 release regression-test result for recording, recovery, synchronization, rendering, persistence, refocus, and export.

Changes

Release documentation

Layer / File(s)	Summary
Native-binary refresh guidance AGENTS.md	The guidance requires copying the complete platform-specific native binary directory and verifying file hashes.
Windows release regression result technical-documentation/testing/manual-e2e-checklist.md	The checklist records passing Windows 11 release/v1.9.5 tests and lists untested platform and feature areas.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Merge Risk: ⚪ Minimal · up to e4891

This PR only records manual testing results and clarifies documentation for refreshing the native-file directory; no actionable merge-blocking risk remains beyond normal checks and review.

Possibly related PRs

• getopenscreen/openscreen#338: The regression results validate fragmented MP4 recording and helper-termination recovery from this PR.
• getopenscreen/openscreen#361: Both PRs update native-binary verification guidance and manual E2E documentation.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the primary change: documenting the 1.9.5-rc.2 regression test pass.
Description check	✅ Passed	The description is detailed, on-topic, and documents the testing scope, results, limitations, native-directory correction, and validation command.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch claude/e2e-log-1-9-5-rc2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}