Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

fix(demo): stop the short cut from overwriting the full film's chapters

nirholasbb5593e9b26e
diff --git a/docs/product-demo.md b/docs/product-demo.md
index 860860e2e..0f6d791fd 100644
--- a/docs/product-demo.md
+++ b/docs/product-demo.md
@@ -23,7 +23,7 @@ Output goes to `marketing/product-demo/`:
|---|---|
| `three-ws-demo.mp4` | The whole film, all chapters joined |
| `three-ws-demo-01-main.mp4` … | One file per chapter, in route order |
-| `demo-manifest.json` | What was filmed: origin, route, voice, stop count, chapter durations, and every skipped stop with the reason |
+| `three-ws-demo-manifest.json` | What was filmed: origin, route, narration lane and voice, stop count, chapter durations, and every skipped stop with the reason |
The mp4s are gitignored on purpose. Each chapter is a 1080p screen recording and the set runs to
hundreds of megabytes, which is not something a git history should carry forever. The manifest is
@@ -64,7 +64,7 @@ clicks instead of going silent on a surface that takes a moment. Add an act by a
`ACTS` whose name is the stop's path.
A selector that has gone missing does not fail the run. It fails that stop, which is recorded in
-`demo-manifest.json` under `skipped`, and the film moves on. Pass `--strict` when you want a missing
+the run manifest under `skipped`, and the film moves on. Pass `--strict` when you want a missing
selector to stop everything.
## How it is filmed
diff --git a/marketing/product-demo/README.md b/marketing/product-demo/README.md
index e8fb473e0..b3f01c73a 100644
--- a/marketing/product-demo/README.md
+++ b/marketing/product-demo/README.md
@@ -19,11 +19,11 @@ guide is [docs/product-demo.md](../../docs/product-demo.md).
| --- | --- |
| `three-ws-demo.mp4` | The whole film, every chapter joined, 1920x1080 with narration |
| `three-ws-demo-01-main.mp4` … | One file per chapter, in route order, so a chapter can be posted or re-shot on its own |
-| `demo-manifest.json` | The run record: origin, route, narration lane and voice, stop count, per-chapter durations, and every stop that was skipped with the reason |
+| `three-ws-demo-manifest.json` | The run record: origin, route, narration lane and voice, stop count, per-chapter durations, and every stop that was skipped with the reason |
| `.raw/` | Working directory: the narration clip cache and per-chapter audio tracks. Safe to delete; deleting the voice cache means the next run re-synthesizes it |
**The mp4s are gitignored.** Each chapter is a 1080p screen recording and the set runs to hundreds of
-megabytes, which is not something a git history should carry forever. `demo-manifest.json` is
+megabytes, which is not something a git history should carry forever. The manifest is
committed, so the repo still records what was filmed and when. Re-run the recorder to get the film
back.
diff --git a/scripts/make-product-demo.mjs b/scripts/make-product-demo.mjs
index 21a57ddc0..00a7af945 100644
--- a/scripts/make-product-demo.mjs
+++ b/scripts/make-product-demo.mjs
@@ -34,6 +34,7 @@
* --authed replay .auth/audit-state.json (signed-in surfaces)
* --origin= film a dev server instead of https://three.ws
* --out= output directory (default marketing/product-demo)
+ * --name= output basename (default three-ws-demo, per route)
* --narrator=edge|speak which TTS lane to synthesize on (default edge)
* --voice= voice id for that lane (default en-US-AndrewMultilingualNeural)
* --no-voice caption-only, no narration track
@@ -62,6 +63,9 @@ const VOICE = args.voice ? String(args.voice) : null;
const CRF = Number(args.crf || 22);
const STRICT = Boolean(args.strict);
const LIMIT = args.limit ? Number(args.limit) : Infinity;
+/* Every route writes its own set of files, so filming the short cut never
+ overwrites the chapters of the full film sitting beside it. */
+const NAME = String(args.name || (String(args.route || 'full') === 'full' ? 'three-ws-demo' : `three-ws-demo-${args.route}`));
const log = (...m) => console.log('[demo]', ...m);
/* ── the script ─────────────────────────────────────────────────────────── */
@@ -399,7 +403,7 @@ const browser = await chromium.launch(launchOptions());
try {
for (const [ci, chapter] of chapters.entries()) {
- const out = path.join(OUT, `three-ws-demo-${String(ci + 1).padStart(2, '0')}-${chapter.id}.mp4`);
+ const out = path.join(OUT, `${NAME}-${String(ci + 1).padStart(2, '0')}-${chapter.id}.mp4`);
if (args.reuse && existsSync(out)) {
log(`chapter ${chapter.title}: reusing ${path.basename(out)}`);
parts.push(out);
@@ -505,7 +509,7 @@ try {
await browser.close();
}
-const full = path.join(OUT, 'three-ws-demo.mp4');
+const full = path.join(OUT, `${NAME}.mp4`);
if (parts.length > 1) {
concatParts(parts, full, WORK);
log(`wrote ${path.relative(ROOT, full)}`);
@@ -535,7 +539,7 @@ const manifest = {
})),
skipped,
};
-writeFileSync(path.join(OUT, 'demo-manifest.json'), `${JSON.stringify(manifest, null, '\t')}\n`);
+writeFileSync(path.join(OUT, `${NAME}-manifest.json`), `${JSON.stringify(manifest, null, '\t')}\n`);
log(`${manifest.recorded}/${totalStops} stops recorded, ${skipped.length} skipped`);
if (skipped.length) for (const s of skipped) log(` skipped ${s.path}: ${s.why}`);