retake-demos 0.2.2 → 0.4.0

package/dist/ui/server.js

@@ -10,6 +10,7 @@
  *   POST /api/describe              { name, url, describe } → scout + model → draft manifest (saved)
  *   GET  /api/provider              { active, available }
  *   GET  /api/presets               [{name, ...}]
+ *   GET  /api/releases              what's new, from site/releases.json
  *   GET/PUT/DELETE /api/drafts/:id   an unfinished "new demo" (auto-saved as you go)
  *   DELETE /api/demos/:name         remove a demo (manifest + outputs)
  *   PATCH /api/demos/:name/settings { preset?, layout?, camera?, cursor? } → edits keys, keeps comments
@@ -33,11 +34,12 @@ import { draftManifest, loadDotenv, pickProvider, proposeEdits, providerStatus,
 import { applyEdits, receiptsFor } from "../edits.js";
 import { dryRun } from "../dryrun.js";
 import { startOperator, getSession, addPending, answerPending, markDone, stopSession } from "../operator/run.js";
-import { gifskiBin, makeGif } from "../render.js";
-import { captureHash } from "../record.js";
+import { ffmpegBin, gifskiBin, makeGif } from "../render.js";
+import { captureHash, restorePrevious } from "../record.js";
 import { digest } from "../digest.js";
 import { startOffer, startApp, listeningPorts } from "../appserver.js";
 import { PKG_ROOT, PROJECT_ROOT, VERSION, entry } from "../paths.js";
+import { SECRET_NAME, missingSecrets, writeEnvFile } from "../env.js";
 const ROOT = PROJECT_ROOT;
 const DEMOS = path.join(ROOT, "demos");
 /** Where takes land. Default outputs/ in the project; changeable in Settings
@@ -117,7 +119,7 @@ const readBody = (req) => new Promise((ok) => {
     req.on("end", () => ok(b));
 });
 const safeName = (s) => /^[a-z0-9-]+$/.test(s);
-const MIME = { ".mp4": "video/mp4", ".gif": "image/gif", ".png": "image/png", ".md": "text/markdown", ".json": "application/json", ".html": "text/html", ".yaml": "text/yaml" };
+const MIME = { ".mp4": "video/mp4", ".gif": "image/gif", ".png": "image/png", ".jpg": "image/jpeg", ".svg": "image/svg+xml", ".md": "text/markdown", ".json": "application/json", ".html": "text/html", ".yaml": "text/yaml" };
 /** A short name for "the app at this URL": the last path segment if there
     is one (demo.playwright.dev/todomvc → todomvc), else the host without
     www and TLD (www.saucedemo.com → saucedemo). localhost keeps its port —
@@ -162,6 +164,34 @@ function unassignDemoProject(name) {
     delete map[name];
     fs.writeFileSync(DEMO_PROJECTS, JSON.stringify(map, null, 2) + "\n");
 }
+/** Parsed manifests, keyed by path and invalidated by mtime+size.
+    Listing 32 demos meant 64 YAML parses and zod validations per request —
+    two seconds, on a call the window makes on load, on every agent event and
+    every 30s. Nothing about a file that has not changed can have changed. */
+const manifestCache = new Map();
+function cachedManifest(file) {
+    let key;
+    try {
+        const st = fs.statSync(file);
+        key = `${st.mtimeMs}:${st.size}`;
+    }
+    catch {
+        manifestCache.delete(file);
+        return null;
+    }
+    const hit = manifestCache.get(file);
+    if (hit && hit.key === key)
+        return hit.manifest;
+    let manifest = null;
+    try {
+        manifest = loadManifest(file).manifest;
+    }
+    catch {
+        manifest = null;
+    }
+    manifestCache.set(file, { key, manifest });
+    return manifest;
+}
 function listDemos(project) {
     if (!fs.existsSync(DEMOS))
         return [];
@@ -169,13 +199,12 @@ function listDemos(project) {
     const assignments = demoProjects();
     const byUrl = new Map();
     for (const f of fs.readdirSync(DEMOS).filter((x) => /\.ya?ml$/.test(x))) {
-        try {
-            const mm = loadManifest(path.join(DEMOS, f)).manifest;
+        const mm = cachedManifest(path.join(DEMOS, f));
+        if (mm) {
             const asg = assignments[mm.name];
             if (asg && mm.url && !byUrl.has(mm.url))
                 byUrl.set(mm.url, asg);
         }
-        catch { /* invalid manifest: no vote */ }
     }
     return fs
         .readdirSync(DEMOS)
@@ -184,7 +213,9 @@ function listDemos(project) {
         const file = path.join(DEMOS, f);
         let title = "", name = f.replace(/\.ya?ml$/, ""), valid = true, url = "", settings = {};
         try {
-            const m = loadManifest(file).manifest;
+            const m = cachedManifest(file);
+            if (!m)
+                throw new Error("invalid");
             title = m.title ?? "";
             name = m.name;
             url = m.url;
@@ -205,6 +236,11 @@ function listDemos(project) {
         // Capture lands in a second "localhost:3100" fold next to "capture".
         const assigned = assignments[name] ?? (url ? byUrl.get(url) : undefined);
         const group = assigned ? path.basename(assigned) : shortGroup(url);
+        // Heal a folder whose run was killed mid-recording: the previous take is
+        // in its stash and nothing has put it back yet. The window must never
+        // show someone an empty demo when their recording is safe on disk.
+        if (!fs.existsSync(path.join(outRoot(), name, "take.json")))
+            restorePrevious(path.join(outRoot(), name));
         const take = path.join(outRoot(), name, "take.json");
         let lastTake = null;
         // Does the browser need to run again, or is a re-render enough? The
@@ -326,25 +362,7 @@ function startRun(name, mode = {}) {
     return run;
 }
 /** Read/write the .env in the project root — only the keys we own. */
-function writeEnv(set) {
-    const file = path.join(ROOT, ".env");
-    const lines = fs.existsSync(file) ? fs.readFileSync(file, "utf8").split("\n") : [];
-    for (const [k, v] of Object.entries(set)) {
-        if (v === undefined)
-            continue;
-        const i = lines.findIndex((l) => l.startsWith(k + "="));
-        const line = `${k}=${v}`;
-        if (v === "") {
-            if (i >= 0)
-                lines.splice(i, 1);
-        }
-        else if (i >= 0)
-            lines[i] = line;
-        else
-            lines.push(line);
-    }
-    fs.writeFileSync(file, lines.filter((l, i, a) => l !== "" || i < a.length - 1).join("\n").replace(/\n*$/, "\n"));
-}
+function writeEnv(set) { writeEnvFile(ROOT, set); }
 function envSummary() {
     return { localUrl: process.env.RETAKE_LOCAL_URL ?? "", localModel: process.env.RETAKE_LOCAL_MODEL ?? "", groq: !!process.env.GROQ_API_KEY, mistral: !!process.env.MISTRAL_API_KEY };
 }
@@ -405,6 +423,8 @@ function withStaleness(a) {
         return { ...a, active: false, stale: true };
     return a;
 }
+const secretRequests = new Map();
+const openSecretRequests = () => [...secretRequests.values()].filter((r) => !r.filled).map(({ id, names, why }) => ({ id, names, why }));
 function noteActivity(b) {
     if (!activity.active && !b.done) {
         activity.active = true;
@@ -430,7 +450,6 @@ function noteActivity(b) {
 }
 export function serve(port) {
     loadDotenv(ROOT);
-    const page = fs.readFileSync(path.join(HERE, "index.html"), "utf8");
     const chatPage = fs.readFileSync(path.join(HERE, "chat.html"), "utf8");
     const guidePage = fs.readFileSync(path.join(HERE, "guide.html"), "utf8");
     const server = http.createServer(async (req, res) => {
@@ -448,9 +467,21 @@ export function serve(port) {
                 res.writeHead(200, { "content-type": "text/html" });
                 return res.end(fs.readFileSync(f));
             }
-            const msite = /^\/landing\/media\/([A-Za-z0-9._-]+)$/.exec(p);
+            // Both prefixes: the page is served at /landing here and from a site
+            // root when deployed, so its asset paths are relative either way.
+            // releases.json sits beside index.html when deployed, so the preview
+            // has to serve it from the same two prefixes the page might be under.
+            const mrel = /^(?:\/landing)?\/releases\.json$/.exec(p);
+            if (mrel && (req.method === "GET" || req.method === "HEAD")) {
+                const f = path.join(PKG_ROOT, "site", "releases.json");
+                if (!fs.existsSync(f))
+                    return json(res, 404, { error: "not found" });
+                res.writeHead(200, { "content-type": "application/json" });
+                return res.end(req.method === "HEAD" ? undefined : fs.readFileSync(f));
+            }
+            const msite = /^(?:\/landing)?\/(media|logos)\/([A-Za-z0-9._-]+)$/.exec(p);
             if (msite && (req.method === "GET" || req.method === "HEAD")) {
-                const f = path.join(PKG_ROOT, "site", "media", msite[1]);
+                const f = path.join(PKG_ROOT, "site", msite[1], msite[2]);
                 if (!fs.existsSync(f))
                     return json(res, 404, { error: "not found" });
                 res.writeHead(200, { "content-type": MIME[path.extname(f)] ?? "application/octet-stream", "content-length": fs.statSync(f).size });
@@ -462,10 +493,6 @@ export function serve(port) {
                 res.writeHead(200, { "content-type": "text/html" });
                 return res.end(guidePage);
             }
-            if (p === "/classic" && req.method === "GET") {
-                res.writeHead(200, { "content-type": "text/html" });
-                return res.end(page);
-            }
             if (p === "/manifest.webmanifest") {
                 res.writeHead(200, { "content-type": "application/manifest+json" });
                 return res.end(JSON.stringify({ name: "Retake", short_name: "Retake", description: "Rerun the demo, don't re-record it.", start_url: "/", scope: "/", display: "standalone", background_color: "#edefe8", theme_color: "#edefe8", icons: [{ src: "/icon-192.png", sizes: "192x192", type: "image/png" }, { src: "/icon-512.png", sizes: "512x512", type: "image/png", purpose: "any maskable" }] }));
@@ -507,6 +534,19 @@ export function serve(port) {
             }
             if (p === "/api/provider" && req.method === "GET")
                 return json(res, 200, providerStatus());
+            if (p === "/api/releases" && req.method === "GET") {
+                // The same site/releases.json the landing page reads — one list, so
+                // the window and the page can never disagree about what shipped.
+                const f = path.join(PKG_ROOT, "site", "releases.json");
+                if (!fs.existsSync(f))
+                    return json(res, 200, { releases: [] });
+                try {
+                    return json(res, 200, JSON.parse(fs.readFileSync(f, "utf8")));
+                }
+                catch {
+                    return json(res, 200, { releases: [] });
+                }
+            }
             if (p === "/api/presets" && req.method === "GET")
                 return json(res, 200, Object.values(PRESETS));
             if (p === "/api/drafts" && req.method === "GET")
@@ -536,6 +576,61 @@ export function serve(port) {
                 const seen = new Set();
                 return json(res, 200, items.filter((x) => !seen.has(x.name) && seen.add(x.name)));
             }
+            // ---------- the poster: any frame, a card, or their own file ----------
+            // thumbnail.png IS the poster. Every source here just writes it, so the
+            // choice costs no re-render and never touches the video.
+            const mcov = /^\/api\/cover\/([a-z0-9-]+)$/.exec(p);
+            if (mcov && req.method === "POST") {
+                const name = mcov[1];
+                const dir = path.join(outRoot(), name);
+                const target = path.join(dir, "thumbnail.png");
+                if (!fs.existsSync(dir))
+                    return json(res, 404, { error: `no take for ${name}` });
+                const b = JSON.parse(await readBody(req));
+                if (b.auto) {
+                    fs.rmSync(path.join(dir, ".poster"), { force: true });
+                    return json(res, 200, { ok: true, poster: "auto — the next render takes it from the thumbnail scene" });
+                }
+                try {
+                    if (b.still) {
+                        // A scene still, by its file name under stills/.
+                        const src = path.join(dir, "stills", path.basename(b.still));
+                        if (!fs.existsSync(src))
+                            return json(res, 404, { error: `no still ${b.still}` });
+                        fs.copyFileSync(src, target);
+                    }
+                    else if (b.file) {
+                        // A candidate already in the take (cover.png, cover-titled.png).
+                        const src = path.join(dir, path.basename(b.file));
+                        if (!fs.existsSync(src))
+                            return json(res, 404, { error: `no file ${b.file}` });
+                        fs.copyFileSync(src, target);
+                    }
+                    else if (typeof b.at === "number") {
+                        // Any moment of the finished video — usually the best frame is
+                        // nowhere near a scene marker.
+                        const mp4 = path.join(dir, "demo.mp4");
+                        if (!fs.existsSync(mp4))
+                            return json(res, 404, { error: "no demo.mp4" });
+                        execFileSync(ffmpegBin(), ["-y", "-loglevel", "error", "-ss", Math.max(0, b.at).toFixed(2), "-i", mp4, "-frames:v", "1", target]);
+                    }
+                    else if (b.dataUrl) {
+                        // Their own image.
+                        const m2 = /^data:image\/(png|jpe?g|webp);base64,(.+)$/.exec(b.dataUrl);
+                        if (!m2)
+                            return json(res, 400, { error: "expected a png, jpeg or webp data URL" });
+                        fs.writeFileSync(target, Buffer.from(m2[2], "base64"));
+                    }
+                    else
+                        return json(res, 400, { error: "give a still, a file, an `at` time, or a dataUrl" });
+                }
+                catch (e) {
+                    return json(res, 500, { error: e.message });
+                }
+                // The choice survives re-renders; "auto" hands it back to the scene default.
+                fs.writeFileSync(path.join(dir, ".poster"), JSON.stringify({ ...b, dataUrl: b.dataUrl ? "(uploaded)" : undefined, at: b.at }));
+                return json(res, 200, { ok: true, poster: "thumbnail.png" });
+            }
             if (p === "/api/trash/clear" && req.method === "POST") {
                 const trash = path.join(ROOT, ".trash");
                 let n = 0;
@@ -720,9 +815,50 @@ export function serve(port) {
             }
             if (p === "/api/activity" && req.method === "GET")
                 return json(res, 200, withStaleness(activity));
+            // ---------- secrets: asked for by name, typed into the window, written here ----------
+            if (p === "/api/secrets/request" && req.method === "POST") {
+                const b = JSON.parse(await readBody(req));
+                const names = (b.names ?? []).filter((n) => SECRET_NAME.test(n));
+                if (!names.length)
+                    return json(res, 400, { error: "names must be like APP_PASSWORD" });
+                // The same ask twice is one form, not two stacked ones.
+                const dup = [...secretRequests.values()].find((x) => !x.filled && x.names.join() === names.join());
+                if (dup)
+                    return json(res, 200, { id: dup.id });
+                const r = { id: "s" + Date.now().toString(36), names, why: String(b.why ?? "").slice(0, 300), filled: false, at: Date.now() };
+                secretRequests.set(r.id, r);
+                for (const w of activityWatchers)
+                    w({ type: "secrets", data: { id: r.id, names: r.names, why: r.why } });
+                return json(res, 200, { id: r.id });
+            }
+            if (p === "/api/secrets/pending" && req.method === "GET")
+                return json(res, 200, openSecretRequests());
+            if (p === "/api/secrets/fill" && req.method === "POST") {
+                const b = JSON.parse(await readBody(req));
+                const r = secretRequests.get(b.id);
+                if (!r)
+                    return json(res, 404, { error: "no such request" });
+                const values = {};
+                for (const [k, v] of Object.entries(b.values ?? {}))
+                    if (r.names.includes(k) && typeof v === "string" && v.trim())
+                        values[k] = v;
+                if (!Object.keys(values).length)
+                    return json(res, 400, { error: "nothing to save" });
+                writeEnvFile(ROOT, values);
+                if (!missingSecrets(ROOT, r.names).length)
+                    r.filled = true;
+                for (const w of activityWatchers)
+                    w({ type: "secrets-done", data: { id: r.id, filled: r.filled } });
+                return json(res, 200, { ok: true, filled: r.filled, set: Object.keys(values) });
+            }
+            const msec = /^\/api\/secrets\/(s[a-z0-9]+)$/.exec(p);
+            if (msec && req.method === "GET") {
+                const r = secretRequests.get(msec[1]);
+                return r ? json(res, 200, { filled: r.filled, missing: missingSecrets(ROOT, r.names) }) : json(res, 404, { error: "no such request" });
+            }
             if (p === "/api/activity/stream" && req.method === "GET") {
                 res.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-cache", connection: "keep-alive" });
-                res.write(`event: state\ndata: ${JSON.stringify({ ...activity, boot: BOOT })}\n\n`);
+                res.write(`event: state\ndata: ${JSON.stringify({ ...activity, boot: BOOT, secrets: openSecretRequests() })}\n\n`);
                 const send = (ev) => res.write(`event: ${ev.type}\ndata: ${JSON.stringify(ev.data)}\n\n`);
                 activityWatchers.add(send);
                 const beat = setInterval(() => res.write(": ping\n\n"), 25_000);
@@ -859,7 +995,7 @@ export function serve(port) {
                 return json(res, 200, { provider, selected, models: [{ id: selected, name: selected || "Configured default" }] });
             }
             if (p === "/api/settings" && req.method === "GET")
-                return json(res, 200, { ...providerStatus(), model: process.env.RETAKE_MODEL ?? "", selection: modelSelection(), gifski: !!gifskiBin(), env: envSummary(), outDir: outRoot(), outDefault: OUT_DEFAULT, version: VERSION });
+                return json(res, 200, { envPath: path.join(ROOT, ".env"), ...providerStatus(), model: process.env.RETAKE_MODEL ?? "", selection: modelSelection(), gifski: !!gifskiBin(), env: envSummary(), outDir: outRoot(), outDefault: OUT_DEFAULT, version: VERSION });
             const mopen = /^\/api\/open\/([a-z0-9-]+)$/.exec(p);
             if (mopen && req.method === "POST") {
                 const dir = path.join(outRoot(), mopen[1]);
@@ -1023,7 +1159,7 @@ export function serve(port) {
                         if (b.camera === "static")
                             node.set("camera", "static");
                         else if (b.camera === "auto")
-                            node.delete("camera");
+                            node.set("camera", "auto");
                         else if (typeof b.camera === "object")
                             node.set("camera", b.camera);
                     }

package/dist/voice.js

@@ -0,0 +1,36 @@
+/**
+ * Voiceover: the captions read aloud. The captions ARE the script — each
+ * scene's line is synthesized once and placed at the scene's start, so the
+ * narration is honest to the take by construction.
+ *
+ * Engine: edge-tts (Microsoft's neural voices — free, network). Found as a
+ * CLI (`edge-tts`, pipx/pip) or module (`python3 -m edge_tts`). Retake does
+ * not bundle a voice engine; the error says how to install one.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync, spawnSync } from "node:child_process";
+export const DEFAULT_VOICE = "en-US-JennyNeural";
+function engine() {
+    const home = process.env.HOME ?? "";
+    for (const c of ["edge-tts", path.join(home, ".local", "bin", "edge-tts")]) {
+        if (spawnSync(c, ["--help"], { stdio: "ignore" }).status === 0)
+            return { cmd: c, args: [] };
+    }
+    if (spawnSync("python3", ["-m", "edge_tts", "--help"], { stdio: "ignore" }).status === 0)
+        return { cmd: "python3", args: ["-m", "edge_tts"] };
+    throw new Error("voiceover needs edge-tts — install it once with `pipx install edge-tts` (or `pip install edge-tts`), then re-render");
+}
+export function synthesize(text, voice, out) {
+    const e = engine();
+    execFileSync(e.cmd, [...e.args, "--voice", voice, "--text", text, "--write-media", out], { stdio: "pipe", timeout: 60_000 });
+    if (!fs.existsSync(out) || fs.statSync(out).size < 200)
+        throw new Error(`voiceover: nothing came back for “${text.slice(0, 40)}…” — is the network up? (edge-tts is a network service)`);
+}
+export function audioSeconds(ffmpeg, file) {
+    const out = String(spawnSync(ffmpeg, ["-hide_banner", "-i", file], { encoding: "utf8" }).stderr);
+    const m = /Duration:\s*(\d+):(\d+):(\d+\.?\d*)/.exec(out);
+    if (!m)
+        throw new Error(`could not read duration of ${file}`);
+    return Number(m[1]) * 3600 + Number(m[2]) * 60 + Number(m[3]);
+}

package/llms.txt

@@ -0,0 +1,11 @@
+# Retake
+
+> Demo-as-code for coding agents: a YAML manifest in, a product walkthrough video out. Rerun the demo instead of re-recording it.
+
+An agent that was handed this repository should read README.md first — its "If you are a coding agent" section is the setup sequence — then AGENTS.md (the CLI loop, manifests, logins, what trips agents up) and skill/SKILL.md (the method Claude Code loads as a skill).
+
+- README.md: https://raw.githubusercontent.com/glebbogachev00/retake/main/README.md
+- AGENTS.md: https://raw.githubusercontent.com/glebbogachev00/retake/main/AGENTS.md
+- skill/SKILL.md: https://raw.githubusercontent.com/glebbogachev00/retake/main/skill/SKILL.md
+- demos/example.yaml: https://raw.githubusercontent.com/glebbogachev00/retake/main/demos/example.yaml
+- npm: https://www.npmjs.com/package/retake-demos

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retake-demos",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "Demo-as-code for coding agents: a YAML manifest in, a product walkthrough video out. Rerun the demo instead of re-recording it.",
   "keywords": [
     "demo",
@@ -30,7 +30,6 @@
   "files": [
     "dist",
     "skill",
-    "site/index.html",
     "assets/logo.svg",
     "assets/icon-192.png",
     "assets/icon-512.png",
@@ -38,7 +37,10 @@
     ".env.example",
     "README.md",
     "LICENSE",
-    "scripts/patch-testreel.mjs"
+    "scripts/patch-testreel.mjs",
+    "AGENTS.md",
+    "llms.txt",
+    "site/releases.json"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && mkdir -p dist/ui && cp src/ui/*.html dist/ui/ && chmod +x dist/cli.js",

package/site/releases.json

@@ -0,0 +1,45 @@
+{
+  "_readme": "What's new, written for the person using Retake — not for whoever wrote it. Both the landing page and the Retake window read THIS file; there is no second copy. Rules for adding one: say what changed for them, name no files, no flags they will not type, no words like refactor or regression. If a line only makes sense to someone who has read the source, it does not belong here. Newest first. Add an entry on every release that changes what people see.",
+  "releases": [
+    {
+      "version": "0.4.0",
+      "date": "2026-08-25",
+      "headline": "Videos come out the size you asked for — and changing your mind is nearly free",
+      "notes": [
+        "Every video is exactly the size of the format you picked. Landscape is 1920×1080, square is square, vertical fits a phone. No more sizes drifting between takes.",
+        "Changing your mind costs seconds, not another recording. Size, shape, format, captions, speed, zoom, music, title cards and the cover image all re-make themselves from the recording you already have.",
+        "Moved a caption to the wrong moment? Nudge it. The caption, the still and the cover all follow, and you never record again.",
+        "Only the ending changed? Record only the ending. The earlier steps still run so your app gets to the right place, but they happen at full speed and off camera. On a seven-minute demo that is about three minutes instead of sixteen.",
+        "Your old recordings are kept. A re-record no longer throws away the take you had — you can look at the previous ones and go back to any of them. Only the recording itself is stored, so it stays small.",
+        "A failed recording can no longer cost you the one that worked.",
+        "New: clear out old files safely. It shows you what it would free before removing anything, and never touches a recording.",
+        "In the window: pick several demos at once — or a whole folder — and archive them together. The archive empties in one click.",
+        "Launch videos can open with a title card and close with your own sign-off, put music underneath, and add a spoken voiceover.",
+        "Dead air gets trimmed: while your app is thinking, the video moves through the wait instead of sitting in it.",
+        "You can sign in to a demo account without any AI ever seeing your password.",
+        "Renders are about twice as fast.",
+        "Your agent now checks far more before recording — that a click will land on something clickable, that a stub is really being used, that it is looking at the same screen the recording will — so fewer takes are wasted finding out mid-recording.",
+        "On a long demo your agent shows you a quick draft and asks before spending the full recording.",
+        "The window has been rebuilt: one place for everything, and it stops shouting at you."
+      ]
+    },
+    {
+      "version": "0.3.0",
+      "date": "2026-08-23",
+      "headline": "Demos behind a login",
+      "notes": [
+        "Demos of apps that need signing in. You sign in once in a real browser window; nothing types your password and nothing records it.",
+        "The video player shows your video in its own shape, with no black bars around it."
+      ]
+    },
+    {
+      "version": "0.2.0",
+      "date": "2026-08-23",
+      "headline": "The first public release",
+      "notes": [
+        "Describe a demo in one readable file, and get a video, still frames, and a written record of what happened.",
+        "When your app changes, fix the file and run it again — instead of recording the whole thing over."
+      ]
+    }
+  ]
+}