One decision per record, numbered in order. A record is never rewritten after it is accepted: a later record supersedes it and says so.
| ADR | Decision | Status |
|---|---|---|
| 0001 | Control plane and execution plane; one demoflow package on Node; module layout |
accepted; amended by 0015 |
| 0002 | develop integration, staging on merge, GitHub Actions OS matrix |
accepted |
| 0003 | Scenario format, locators, secrets, project config | accepted |
| 0004 | Capture model, stage statuses, failure rendering, output defaults, artifact location | accepted; §1's 2× premise superseded by 0010 |
| 0005 | Renderer: the FFmpeg compositor, chosen by a spike | accepted |
| 0006 | Multi-user accounts: GitHub OAuth and email/password | accepted |
| 0007 | Runner pairing (device code), WebSocket connection, device token | accepted |
| 0008 | What crosses to the cloud, and what the website may make a runner do | accepted; §3 extended by 0016 |
| 0009 | Playback through an API relay; Luna Player behind an adapter | accepted |
| 0010 | The source video is recorded at the viewport size (1×) | accepted |
| 0011 | No Docker socket and no host cache on a pull request | accepted |
| 0012 | The camera zooms only where a step asks for it (zoom); no automatic zoom |
accepted |
| 0013 | The page-side contract: data-demoflow-mask and window.demoflow (ready, waitForReady) |
accepted; extended by 0014 |
| 0014 | Scenes and captions from the page: window.demoflow.scene and caption |
accepted |
| 0015 | Playwright tests become scenarios: a demoflow/playwright fixture records a .demo.json, the engine replays it; new module packages/playwright, optional peer @playwright/test |
accepted |
| 0016 | Runs started from the website: scenario listing (ids and names), a registered project is a root the machine reported a run from | accepted; §4 superseded by 0017; §2 superseded by 0022 |
| 0017 | The website may choose the output formats of a run it starts (formats only; always headless) | accepted |
| 0018 | Step fragments (include) are inlined at load time; off-camera steps (setup, record: false) are an unrecorded prefix run in its own context |
accepted |
| 0019 | Opt-in share links: one render uploaded to the server on an explicit share, unlisted link with an optional password | accepted; supersedes the roadmap's Phase 5 "no public share links", extends 0008 §2–§3 |
| 0020 | The website may send a run's edits as data and ask its runner to re-render it; edits live in the run directory | accepted; extends 0008 §3 |
| 0021 | Scheduled checks from the website and the project config; check mode runs without recording | accepted; extends 0017 |
| 0022 | A project may be added from the website: a folder inside the machine's allowed roots, inspected and optionally initialised by the runner; GitHub link as metadata, no cloning | accepted; supersedes 0016 §2, extends 0008 §3 |