#2063

docs: plan headless Run recording with Electron adapter

OpenDouglasymlaiwants to merge intofrom

Related Issue

Closes #2062 (planning specification only).

Description

Add a draft specification for saving useful footage of Eigent running Tasks into the bound Space folder. Keep the product headless: the Brain owns recording lifecycle, APIs, authorization and storage, while an optional Electron adapter supplies native capture, following the local-folder architecture.

The three documents cover scope, provider/API contracts, recovery and artifact publication, Electron/codec compatibility gates, and phased implementation including a later rolling buffer. This PR adds documentation only; recording is not implemented.

Testing Evidence

Agent-run checks at 348caafbf:

prettier --check plans/run-recording/README.md plans/run-recording/architecture.md plans/run-recording/implementation.md
All matched files use Prettier code style!

Local Markdown link validation: 23 links passed.
git diff main...HEAD --check: passed.
Commit scope: 3 planning documents, 304 insertions.
  • Human-verified testing/review evidence included (pending; PR remains draft).
  • This PR includes frontend/UI changes, and I attached screenshot(s) or screen recording(s).
  • No frontend/UI changes in this PR.

Runtime tests and type checking were not run for this documentation-only change. The plan defines future implementation acceptance gates; these are not claimed as passed.

Purpose

  • Bug fix
  • New Feature
  • Documentation update
  • Other

Contribution Guidelines Acknowledgement

  • Contribution guideline read; this AI-assisted specification is submitted as a draft pending human review.

Activity

6
Douglasymlai13d ago

Moving this to draft and planning it for 1.0.8. It will not be merged in this release.

In the next version we plan to build a replay feature for Remote Control, and recording will be revisited as part of that work. The current direction is to record through Chrome rather than building capture into Electron, so the approach in this PR may change before it lands.