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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
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.mdindex 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 tohundreds 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 missingselector to stop everything.## How it is filmeddiff --git a/marketing/product-demo/README.md b/marketing/product-demo/README.mdindex 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 iscommitted, so the repo still records what was filmed and when. Re-run the recorder to get the filmback.diff --git a/scripts/make-product-demo.mjs b/scripts/make-product-demo.mjsindex 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}`);