Skip to content

Latest commit

 

History

History
29 lines (27 loc) · 3.76 KB

README.md

File metadata and controls

29 lines (27 loc) · 3.76 KB

Architecture decision records

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