OpenRec Plan Execution Checklist

March 5, 2026 · View on GitHub

Documentation index: README.md

This checklist tracks implementation closure status for this execution environment.

Quick navigation

  1. Delivery checklist by plan phase
  2. Remaining manual gates (macOS runtime)
  3. Workspace closure criteria
  4. Pointer documents

1) Delivery checklist by plan phase

Phase 0 — Audit + critical reliability

  • Dynamic recording resolution (source-derived dimensions, quality presets, codec selection)
  • Duration no longer hardcoded in project metadata (session timing + ffprobe fallback)
  • Pause/resume segment stitching into canonical screen.mp4
  • Camera + microphone tracks captured from frontend and persisted with offsets
  • Export speed effects keep audio aligned (atempo chain support)
  • Export preflight validates required media inputs before ffmpeg spawn
  • Recording source fallback handling (display/window disconnect/reconnect resilience)
  • Recorder preferences persisted/restored with source-type-aware fields

Phase 1 — Architecture hardening

  • Commands standardized on Result<T, AppError> with serialized user-facing errors
  • Critical runtime .ok() drops removed from backend execution paths
  • Runtime std::fs paths migrated to Tokio fs for async-safe operations
  • App shutdown cleanup for active recordings and active export jobs
  • Backend checks automated in CI (cargo fmt, cargo check, cargo test)
  • cross-platform backend compile guard added in CI (backend-checks.yml matrix on Linux + macOS)

Phase 2 / 3 — Recording + editor capability upgrades

  • Recording quality presets (720p30, 1080p30, 1080p60, 4k30, 4k60)
  • Codec selection (h264 / hevc)
  • Countdown flow + global start/stop + pause/resume shortcuts
  • Disk-space guardrails and auto-segmentation behavior
  • Camera overlay controls persisted in project data and used during export
  • Timeline/editor refactors into hook/component architecture with component-size guardrails
  • Export queue with cancellation and progress eventing

Phase 4 / 5 / 6 — Native integration + distribution workflow

  • Tray menu + app menu with recorder/projects/recent-project actions
  • .openrec file association support and startup/opened-event handling
  • Unsigned macOS build config (signingIdentity: null)
  • Unsigned DMG workflow with release artifact upload + checksums
  • Unsigned installation documentation (Gatekeeper bypass + permissions)
  • In-app Help menu links for release downloads + unsigned install guide

2) Remaining manual gates (macOS runtime)

  • End-to-end monitor unplug/replug tests while recording and while paused
  • Permission revocation flows (screen/camera/mic) during active sessions
  • Long-session stability pass (multi-hour run with pause/resume and auto-segmentation)
  • Hardware export performance benchmark validation against target metrics
  • Unsigned Gatekeeper install/open flow validation on clean machines (Intel + Apple Silicon)

3) Workspace closure criteria

Per approved scope, macOS runtime validation is out of scope for this Linux host. Completion for this workspace is gated by:

  • Automated baseline green (pnpm run check, pnpm --filter @openrec/desktop run cargo:fmt, pnpm --filter @openrec/desktop run cargo:test)
  • Documentation link baseline green (pnpm run verify:docs)
  • Frontend regression baseline green (pnpm run test)
  • No known open P0/P1 blockers in implemented cross-platform/runtime logic
  • Final sign-off documentation updated with explicit out-of-scope macOS runtime checklist

4) Pointer documents