retake-demos 0.2.1 → 0.3.0

package/dist/ui/server.js

@@ -33,11 +33,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 { ffmpegBin, gifskiBin, makeGif } from "../render.js";
 import { captureHash } 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 +118,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 —
@@ -326,25 +327,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 +388,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;
@@ -448,9 +433,11 @@ 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.
+            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 });
@@ -536,6 +523,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 +762,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 +942,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 +1106,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.1",
+  "version": "0.3.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,17 +30,22 @@
   "files": [
     "dist",
     "skill",
-    "site/index.html",
     "assets/logo.svg",
     "assets/icon-192.png",
     "assets/icon-512.png",
     "demos/example.yaml",
     ".env.example",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "scripts/patch-testreel.mjs",
+    "AGENTS.md",
+    "llms.txt",
+    "site/index.html",
+    "site/logos"
   ],
   "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",
+    "postinstall": "node scripts/patch-testreel.mjs",
     "prepare": "npm run build",
     "prepublishOnly": "npm run typecheck && npm test",
     "retake": "tsx src/cli.ts",
@@ -52,7 +57,7 @@
     "@modelcontextprotocol/sdk": "^1.30.0",
     "commander": "^14.0.3",
     "playwright": "^1.58.2",
-    "testreel": "^0.2.0",
+    "testreel": "0.2.0",
     "yaml": "^2.8.3",
     "zod": "^4.4.3"
   },

package/scripts/patch-testreel.mjs

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Lift testreel's cursor cap.
+ *
+ * testreel draws the cursor overlay with ffmpeg expressions it builds as one
+ * nested `if(lt(t,…),…,if(lt(t,…),…,…))` per keyframe. ffmpeg's expression
+ * parser stops at 98 nesting levels, so past ~45 cursor moves the overlay
+ * silently drops out of the video. Upstream (0.2.0) has not changed this.
+ *
+ * The same piecewise functions can be written flat — a sum of windowed
+ * segments, `gte(t,a)*lt(t,b)*value` — with no nesting and the same result
+ * frame for frame. This script rewrites the four builders Retake relies on
+ * (x/y position, show/hide, fade, cursor style) in testreel's dist files.
+ *
+ * It runs on `postinstall`, is idempotent, and refuses to touch anything if
+ * the functions are not byte-identical to testreel 0.2.0 — a newer testreel
+ * means re-checking, not guessing. (testreel is pinned to an exact version
+ * in package.json for the same reason.)
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+
+const require = createRequire(import.meta.url);
+const MARK = "/*retake:flat-cursor*/";
+
+// The originals, exactly as shipped in testreel 0.2.0 (dist/index.js).
+const ORIGINALS = {
+  Qe: 'function Qe(e,t){if(e.length===0)return"0";if(e.length===1)return String(e[0].value);let o=String(e[e.length-1].value);for(let r=e.length-1;r>=1;r--){let n=e[r-1],i=e[r],s=i.transitionMs/1e3,a=i.time,u=a+s,l=`${n.value}+(${i.value}-${n.value})*(t-${a.toFixed(4)})/${s.toFixed(4)}`;o=`if(lt(t,${a.toFixed(4)}),${n.value},if(lt(t,${u.toFixed(4)}),${l},${o}))`}return o}',
+  _t: 'function _t(e){let t=e.filter(n=>n.type==="hide"||n.type==="show");if(t.length===0)return"1";let r=t[t.length-1].type==="hide"?"0":"1";for(let n=t.length-2;n>=0;n--){let i=t[n].type==="hide"?"0":"1";r=`if(lt(t,${t[n+1].time.toFixed(4)}),${i},${r})`}return r=`if(lt(t,${t[0].time.toFixed(4)}),1,${r})`,r}',
+  zt: 'function zt(e,t,o="T"){let r=e.filter(a=>a.type==="hide"||a.type==="show").sort((a,u)=>a.time-u.time);if(r.length===0)return"1";let n=Math.max(.001,t/1e3),s=r[r.length-1].type==="hide"?"0":"1";for(let a=r.length-1;a>=0;a--){let u=r[a],l=a===0?1:r[a-1].type==="hide"?0:1,p=u.type==="hide"?0:1,w=u.time,d=u.time+n;if(l===p){s=`if(lt(${o},${w.toFixed(4)}),${l},${s})`;continue}let f=p-l,h=`${l}+(${f})*(${o}-${w.toFixed(4)})/${n.toFixed(4)}`;s=`if(lt(${o},${w.toFixed(4)}),${l},if(lt(${o},${d.toFixed(4)}),${h},${s}))`}return s}',
+  Mt: 'function Mt(e,t,o){let r=e.filter(a=>a.type==="move"&&a.cursorStyle!==void 0);if(r.length===0)return o===t?"1":"0";let n=[];n.push({time:0,active:o===t});for(let a of r)n.push({time:a.time,active:(a.cursorStyle??o)===t});let i=[n[0]];for(let a=1;a<n.length;a++)n[a].active!==i[i.length-1].active&&i.push(n[a]);if(i.length===1)return i[0].active?"1":"0";let s=i[i.length-1].active?"1":"0";for(let a=i.length-2;a>=0;a--){let u=i[a].active?"1":"0";s=`if(lt(t,${i[a+1].time.toFixed(4)}),${u},${s})`}return s}',
+};
+
+// Flat replacements. `__flat(v, segs)` sums windowed segments; a segment is
+// {f, t, e}: from time f (null = -∞) to time t (null = +∞), expression e.
+// Segments are contiguous and non-overlapping, so the sum IS the function.
+// Where the originals let a running transition finish before the next
+// keyframe takes over (nested ifs, outermost wins), these do the same.
+const FLAT = {
+  helper: `${MARK}function __flat(v,a){a=a.filter(s=>s.f==null||s.t==null||s.t>s.f);if(a.length===0)return"0";if(a.length===1)return"("+a[0].e+")";return a.map(s=>{let g=s.f==null?"":"gte("+v+","+s.f.toFixed(4)+")*",l=s.t==null?"":"lt("+v+","+s.t.toFixed(4)+")*";return g+l+"("+s.e+")"}).join("+")}`,
+  Qe: 'function Qe(e,t){if(e.length===0)return"0";if(e.length===1)return String(e[0].value);let a=[{f:null,t:e[1].time,e:String(e[0].value)}],cur=e[1].time;for(let r=1;r<e.length;r++){let n=e[r-1],i=e[r],s=i.transitionMs/1e3,st=Math.max(i.time,cur),u=i.time+s,nx=r+1<e.length?e[r+1].time:null;if(u>st){a.push({f:st,t:u,e:`${n.value}+(${i.value}-${n.value})*(t-${i.time.toFixed(4)})/${s.toFixed(4)}`});cur=u}if(nx==null||nx>cur){a.push({f:cur,t:nx,e:String(i.value)});if(nx!=null)cur=nx}}return __flat("t",a)}',
+  _t: 'function _t(e){let t=e.filter(n=>n.type==="hide"||n.type==="show");if(t.length===0)return"1";let a=[{f:null,t:t[0].time,e:"1"}];for(let n=0;n<t.length;n++)a.push({f:t[n].time,t:n+1<t.length?t[n+1].time:null,e:t[n].type==="hide"?"0":"1"});return __flat("t",a)}',
+  zt: 'function zt(e,t,o="T"){let r=e.filter(a=>a.type==="hide"||a.type==="show").sort((a,u)=>a.time-u.time);if(r.length===0)return"1";let n=Math.max(.001,t/1e3),a=[{f:null,t:r[0].time,e:"1"}],cur=r[0].time;for(let i=0;i<r.length;i++){let u=r[i],l=i===0?1:r[i-1].type==="hide"?0:1,p=u.type==="hide"?0:1,w=u.time,nx=i+1<r.length?r[i+1].time:null;if(l!==p){let st=Math.max(w,cur),d=w+n;if(d>st){a.push({f:st,t:d,e:`${l}+(${p-l})*(${o}-${w.toFixed(4)})/${n.toFixed(4)}`});cur=d}}if(nx==null||nx>cur){a.push({f:cur,t:nx,e:String(p)});if(nx!=null)cur=nx}}return __flat(o,a)}',
+  Mt: 'function Mt(e,t,o){let r=e.filter(a=>a.type==="move"&&a.cursorStyle!==void 0);if(r.length===0)return o===t?"1":"0";let n=[];n.push({time:0,active:o===t});for(let a of r)n.push({time:a.time,active:(a.cursorStyle??o)===t});let i=[n[0]];for(let a=1;a<n.length;a++)n[a].active!==i[i.length-1].active&&i.push(n[a]);if(i.length===1)return i[0].active?"1":"0";let s=[];for(let a=0;a<i.length;a++)s.push({f:a===0?null:i[a].time,t:a+1<i.length?i[a+1].time:null,e:i[a].active?"1":"0"});return __flat("t",s)}',
+};
+
+function patchFile(file) {
+  let src = fs.readFileSync(file, "utf8");
+  if (src.includes(MARK)) return "already patched";
+  for (const [name, original] of Object.entries(ORIGINALS)) {
+    const n = src.split(original).length - 1;
+    if (n !== 1) throw new Error(`${path.basename(file)}: expected exactly one copy of ${name} as shipped in testreel 0.2.0, found ${n} — testreel changed; re-check scripts/patch-testreel.mjs before trusting the cursor past ~45 moves`);
+  }
+  // Prepend the helper to the first builder so it is defined once, in scope.
+  src = src.replace(ORIGINALS.Qe, FLAT.helper + FLAT.Qe);
+  for (const name of ["_t", "zt", "Mt"]) src = src.replace(ORIGINALS[name], FLAT[name]);
+  fs.writeFileSync(file, src);
+  return "patched";
+}
+
+let dir;
+try {
+  // testreel's exports map hides package.json; walk up from the resolved entry.
+  let d = path.dirname(require.resolve("testreel"));
+  while (!fs.existsSync(path.join(d, "package.json"))) d = path.dirname(d);
+  dir = d;
+} catch { console.log("patch-testreel: testreel not installed yet — nothing to do"); process.exit(0); }
+const version = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf8")).version;
+if (version !== "0.2.0") throw new Error(`patch-testreel: written for testreel 0.2.0, found ${version}`);
+
+// Retake imports the ESM build; the CJS build has different minified names
+// and is left alone.
+console.log(`patch-testreel: dist/index.js — ${patchFile(path.join(dir, "dist", "index.js"))}`);