create-aura3d 1.3.2 → 1.4.0

package/dist/showcase-spec-types.d.ts

@@ -0,0 +1,304 @@
+export type ShowcaseSpecClaimLabel = "createAuraApp" | "prototype" | "roadmap";
+export type ShowcaseSpecFinalStatus = "release-ready candidate" | "prototype-blocked" | "internal-diagnostic" | "removed-from-public-showcase";
+export type ShowcaseSpecReplacementRequiredRole = "architecture" | "building" | "character" | "data-station" | "effect-core" | "environment" | "facility" | "industrial" | "level" | "platformer-world" | "stage" | "track" | "vehicle" | "world";
+export interface ShowcaseSpecAssetPolicy {
+    readonly allowReplacement: boolean;
+    readonly replacementQuery?: string;
+    readonly requiredRole?: ShowcaseSpecReplacementRequiredRole;
+    readonly minQuality?: "candidate" | "release";
+    readonly requireRenderedProbe?: boolean;
+    readonly requireDeployPass?: boolean;
+}
+export interface ShowcaseSpecAsset {
+    readonly id: string;
+    readonly role: string;
+    readonly typedRef: string;
+    readonly quality: "release" | "candidate" | "prototype";
+    readonly hasDurableProvenance: boolean;
+    readonly hasRenderedProbe: boolean;
+    readonly hasOrientationEvidence: boolean;
+    readonly hasForegroundBounds: boolean;
+    readonly assetPolicy?: ShowcaseSpecAssetPolicy;
+}
+export interface ShowcaseSpecCapability {
+    readonly name: string;
+    readonly status: "root-proven" | "partial" | "internal-only" | "roadmap" | "unsupported";
+    readonly evidence?: string;
+}
+export type ShowcasePlatformerGameplayRequirement = "movement" | "jump" | "checkpoint" | "progression";
+export type ShowcasePlatformerPlayableSurfaceSource = "asset-bound-playable-surfaces" | "asset-derived-playable-surfaces" | "authored-route-rectangles";
+export type ShowcaseGeometryEvidenceSource = "asset-mesh-extracted" | "manifest-authored" | "manifest-authored-overlay-validated" | "compiler-authored" | "compiler-authored-overlay-validated";
+export interface ShowcaseRacingTrackTopologyPoint {
+    readonly x: number;
+    readonly z: number;
+    readonly width?: number;
+}
+export interface ShowcaseRacingTrackTopologyCheckpoint {
+    readonly progress: number;
+    readonly width: number;
+}
+export interface ShowcaseGeometryEvidenceRef {
+    readonly sourceAsset: string;
+    readonly renderedProbe?: string;
+    readonly routeOverlay?: string;
+    readonly notes: string;
+}
+export interface ShowcaseGeometryModelBounds {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+}
+export interface ShowcaseRacingTopologyModelAlignment {
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly modelBounds: ShowcaseGeometryModelBounds;
+    readonly modelPoint: readonly [number, number, number];
+    readonly gamePoint: {
+        readonly x: number;
+        readonly z: number;
+    };
+    readonly anchorPairs?: readonly {
+        readonly id: string;
+        readonly modelPoint: readonly [number, number, number];
+        readonly gamePoint: {
+            readonly x: number;
+            readonly z: number;
+        };
+    }[];
+    readonly evidence: {
+        readonly routeOverlay?: string;
+        readonly notes: string;
+    };
+}
+export interface ShowcasePlatformerSurfaceModelAlignment {
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly modelBounds: ShowcaseGeometryModelBounds;
+    readonly modelPoint: readonly [number, number, number];
+    readonly gamePoint: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly anchorPairs?: readonly {
+        readonly id: string;
+        readonly modelPoint: readonly [number, number, number];
+        readonly gamePoint: {
+            readonly x: number;
+            readonly y: number;
+        };
+    }[];
+    readonly evidence: {
+        readonly routeOverlay?: string;
+        readonly notes: string;
+    };
+}
+export type ShowcaseGameAssetPairEvidenceCategory = "racing" | "platformer";
+export type ShowcaseGameAssetPairEvidenceVerdict = "pass" | "fail";
+export interface ShowcaseGameAssetPairEvidence {
+    readonly category: ShowcaseGameAssetPairEvidenceCategory;
+    readonly assets: readonly string[];
+    readonly screenshotEvidence: string;
+    readonly routePrimaryProbe?: string;
+    readonly screenshotSha256?: string;
+    readonly verdict: ShowcaseGameAssetPairEvidenceVerdict;
+    readonly notes: string;
+    readonly blockers: readonly string[];
+}
+export interface ShowcaseRacingTrackTopology {
+    readonly assetId: string;
+    readonly assetHash: string;
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly roadCenterline: readonly ShowcaseRacingTrackTopologyPoint[];
+    readonly checkpoints: readonly ShowcaseRacingTrackTopologyCheckpoint[];
+    readonly lapLengthMeters?: number;
+    readonly estimatedLapSeconds: number;
+    readonly confidence: number;
+    readonly modelAlignment: ShowcaseRacingTopologyModelAlignment;
+    readonly evidence: ShowcaseGeometryEvidenceRef;
+}
+export interface ShowcasePlatformerPlayableSurface {
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly kind: "ground" | "platform" | "moving" | "hazard" | "checkpoint" | "finish";
+}
+export interface ShowcasePlatformerPlayableSurfaceMap {
+    readonly assetId: string;
+    readonly assetHash: string;
+    readonly source: ShowcaseGeometryEvidenceSource;
+    readonly surfaces: readonly ShowcasePlatformerPlayableSurface[];
+    readonly levelLength: number;
+    readonly estimatedCompletionSeconds: number;
+    readonly characterScaleRatio: number;
+    readonly confidence: number;
+    readonly modelAlignment: ShowcasePlatformerSurfaceModelAlignment;
+    readonly evidence: ShowcaseGeometryEvidenceRef;
+}
+export interface ShowcasePlatformerSpec {
+    readonly characterAsset: string;
+    readonly worldAssets: readonly string[];
+    readonly cameraIntent: "side-scroller";
+    readonly layoutConstraints: {
+        readonly keepCharacterReadable: boolean;
+        readonly uiAvoidsEvidenceArea: boolean;
+    };
+    readonly gameplayRequirements: readonly ShowcasePlatformerGameplayRequirement[];
+    readonly levelDesign: {
+        readonly minPlayableSeconds: number;
+        readonly minCheckpoints: number;
+        readonly requiresHazardRespawn: boolean;
+        readonly requiresFinish: boolean;
+        readonly authoredLevelFlow: boolean;
+        readonly playableSurfaceSource: ShowcasePlatformerPlayableSurfaceSource;
+        readonly playableSurfaceLayoutValidated: boolean;
+        readonly playableSurfaceEvidence?: string;
+        readonly playableSurfaceMap?: ShowcasePlatformerPlayableSurfaceMap;
+        readonly assetPairEvidence?: ShowcaseGameAssetPairEvidence;
+        readonly characterWorldScaleCompatible: boolean;
+        readonly styleCompatible: boolean;
+        readonly primitivePrimaryWorldRejected: boolean;
+    };
+    readonly releaseAssetRequirements: {
+        readonly characterRole: "character";
+        readonly worldRoles: readonly ("level" | "world" | "stage")[];
+        readonly requiresOrientationEvidence: boolean;
+        readonly requiresScaleNormalizationEvidence: boolean;
+        readonly requiresRenderedProbe: boolean;
+        readonly requiresDurableProvenance: boolean;
+        readonly requiresSuitabilityReason: boolean;
+    };
+}
+export type ShowcaseRacingGameplayRequirement = "throttle" | "steering" | "reset" | "checkpoint" | "lap" | "multi-lap";
+export interface ShowcaseRacingSpec {
+    readonly vehicleAsset: string;
+    readonly trackAsset: string;
+    readonly cameraIntent: "track-overview";
+    readonly layoutConstraints: {
+        readonly keepVehicleReadable: boolean;
+        readonly keepTrackReadable: boolean;
+        readonly uiAvoidsEvidenceArea: boolean;
+    };
+    readonly gameplayRequirements: readonly ShowcaseRacingGameplayRequirement[];
+    readonly raceDesign: {
+        readonly minCheckpoints: number;
+        readonly minLaps: number;
+        readonly minLapSeconds: number;
+        readonly routeAlignedToTrackAsset: boolean;
+        readonly visibleTrackTopology: "asset-bound-road-topology" | "authored-route-over-visible-track" | "mesh-road-topology";
+        readonly trackTopologyEvidence?: string;
+        readonly trackTopology?: ShowcaseRacingTrackTopology;
+        readonly assetPairEvidence?: ShowcaseGameAssetPairEvidence;
+        readonly carTrackScaleCompatible: boolean;
+        readonly noDebugLocatorDisk: boolean;
+    };
+    readonly releaseAssetRequirements: {
+        readonly vehicleRole: "vehicle";
+        readonly trackRole: "track";
+        readonly requiresOrientationEvidence: boolean;
+        readonly requiresScaleNormalizationEvidence: boolean;
+        readonly requiresRenderedProbe: boolean;
+        readonly requiresDurableProvenance: boolean;
+        readonly requiresSuitabilityReason: boolean;
+    };
+}
+export type ShowcaseCategoryPlanKind = "architecture-environment" | "industrial-digital-twin" | "particle-diagnostic" | "data-diagnostic";
+export type ShowcaseCategoryCameraIntent = "architecture-hero" | "industrial-overview" | "diagnostic-core" | "data-observatory";
+export type ShowcaseCategoryBackendClaim = "webgl-particle" | "native-webgpu" | "fallback";
+export interface ShowcaseCategoryPlan {
+    readonly kind: ShowcaseCategoryPlanKind;
+    readonly primaryAsset: string;
+    readonly cameraIntent: ShowcaseCategoryCameraIntent;
+    readonly backendClaim?: ShowcaseCategoryBackendClaim;
+    readonly layoutConstraints: {
+        readonly keepHeroReadable: boolean;
+        readonly uiAvoidsEvidenceArea: boolean;
+    };
+    readonly claims: {
+        readonly allowed: readonly string[];
+        readonly notAllowed: readonly string[];
+    };
+}
+export interface ShowcaseSpec {
+    readonly schema: "aura3d-showcase-spec/1.0";
+    readonly routeId: string;
+    readonly label: string;
+    readonly category: string;
+    readonly path: string;
+    readonly globalName: string;
+    readonly claimLabel: ShowcaseSpecClaimLabel;
+    readonly publicStatus: ShowcaseSpecFinalStatus;
+    readonly layout: {
+        readonly heroAsset: string;
+        readonly uiPlacement: "left-panel" | "right-panel" | "bottom-bar" | "none";
+    };
+    readonly platformer?: ShowcasePlatformerSpec;
+    readonly racing?: ShowcaseRacingSpec;
+    readonly categoryPlan?: ShowcaseCategoryPlan;
+    readonly primaryAssets: readonly ShowcaseSpecAsset[];
+    readonly evidence: {
+        readonly routePrimaryProbe: string;
+        readonly routePrimaryScreenshot: string;
+        readonly deployCommand: string;
+        readonly deployEvidence?: string;
+        readonly deployPassed: boolean;
+        readonly routePrimaryPassed: boolean;
+        readonly gameplayProof?: string;
+        readonly gameplayPassed?: boolean;
+        readonly releaseAssetProbes?: Readonly<Record<string, string>>;
+    };
+    readonly capabilities: readonly ShowcaseSpecCapability[];
+}
+export interface CompileShowcaseSpecOptions {
+    readonly outputDir: string;
+    readonly projectDir?: string;
+}
+export interface CompileShowcaseSpecFileOptions extends CompileShowcaseSpecOptions {
+    readonly specPath: string;
+}
+export interface CompileShowcaseSpecReport {
+    readonly ok: boolean;
+    readonly schema: "aura3d-showcase-spec-compile-report/1.0";
+    readonly routeId: string;
+    readonly finalStatus: ShowcaseSpecFinalStatus;
+    readonly generatedFiles: readonly string[];
+    readonly blockers: readonly string[];
+    readonly evidenceChecklistPath: string;
+    readonly routeGatePatchPath: string;
+    readonly rejectedAssets: readonly ShowcaseSpecRejectedAsset[];
+    readonly replacementCandidates: readonly ShowcaseSpecReplacementCandidate[];
+    readonly selectedReplacement?: ShowcaseSpecSelectedReplacement;
+}
+export interface ShowcaseSpecRejectedAsset {
+    readonly id: string;
+    readonly reason: "release-probe-blank" | "release-probe-failing" | "release-probe-missing" | "route-primary-clipped" | "route-primary-missing" | "route-primary-unreadable" | "game-asset-pair-failing";
+    readonly evidence: string;
+    readonly failures: readonly string[];
+}
+export interface ShowcaseSpecReplacementProvenance {
+    readonly sourcePage?: string;
+    readonly downloadUrl?: string;
+    readonly license?: string;
+    readonly licenseUrl?: string;
+    readonly author?: string;
+    readonly assetHash?: string;
+}
+export interface ShowcaseSpecReplacementCandidate {
+    readonly id: string;
+    readonly role: string;
+    readonly typedRef: string;
+    readonly score: number;
+    readonly reasons: readonly string[];
+    readonly penalties: readonly string[];
+    readonly provenance: ShowcaseSpecReplacementProvenance;
+    readonly evidence?: string;
+    readonly accepted: boolean;
+    readonly selected: boolean;
+}
+export interface ShowcaseSpecSelectedReplacement {
+    readonly replaces: string;
+    readonly id: string;
+    readonly role: string;
+    readonly score: number;
+    readonly reasons: readonly string[];
+    readonly provenance: ShowcaseSpecReplacementProvenance;
+}
+//# sourceMappingURL=showcase-spec-types.d.ts.map

package/dist/showcase-spec-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-spec-types.d.ts","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-types.ts"],"names":[],"mappings":"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"}

package/dist/showcase-spec-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=showcase-spec-types.js.map

package/dist/showcase-spec-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showcase-spec-types.js","sourceRoot":"","sources":["../../../../packages/create-aura3d/src/showcase-spec-types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aura3d",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "type": "module",
   "bin": {
     "create-aura3d": "dist/cli.js"
@@ -10,12 +10,28 @@
     "templates/product-viewer",
     "templates/cinematic-scene",
     "templates/mini-game",
+    "templates/racing-starter",
+    "templates/falling-blocks-starter",
     "templates/fighting-game",
     "templates/animation-channel",
     "templates/prompt-animation-channel",
     "templates/animation-studio",
     "templates/episode-builder",
-    "templates/character-controller"
+    "templates/character-controller",
+    "templates/three-compat-premium-product-viewer",
+    "templates/three-compat-architecture-interior",
+    "templates/three-compat-material-authoring",
+    "templates/three-compat-asset-inspector",
+    "templates/three-compat-character-viewer",
+    "templates/three-compat-postprocess-scene",
+    "templates/three-compat-custom-threejs-migration",
+    "templates/three-compat-large-scene",
+    "!templates/**/dist/**",
+    "!templates/**/tests/reports/**",
+    "!templates/**/*.png",
+    "!templates/**/*.jpg",
+    "!templates/**/*.jpeg",
+    "!templates/**/*.csv"
   ],
   "publishConfig": {
     "access": "public"
@@ -28,6 +44,9 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@aura3d/asset-index": "1.4.0"
+  },
   "description": "Scaffold Aura3D browser 3D apps for product viewers, cinematic scenes, mini-games, fighting-game runtimes, prompt-driven animation channels, animation studios, and episode builders.",
   "keywords": [
     "create-aura3d",

package/templates/animation-channel/package.json

@@ -12,7 +12,7 @@
     "test:negative-failed-puppets": "playwright test tests/concept-2-5d.spec.ts tests/puppet-2d.spec.ts tests/image-puppet.spec.ts tests/concept-2-5d-animation.spec.ts tests/puppet-2d-animation.spec.ts tests/image-puppet-animation.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "1.3.2"
+    "@aura3d/engine": "1.3.3"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/animation-channel/tests/screenshot.spec.ts

@@ -0,0 +1,16 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { expect, test } from "@playwright/test";
+
+test.setTimeout(60_000);
+
+test("Aura3D animation channel screenshot shows content", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const canvas = page.locator("canvas");
+  const screenshot = await page.screenshot({ fullPage: false });
+  mkdirSync(resolve("tests/reports"), { recursive: true });
+  writeFileSync(resolve("tests/reports/screenshot.png"), screenshot);
+  writeFileSync(resolve("tests/reports/screenshot.json"), `${JSON.stringify({ bytes: screenshot.byteLength }, null, 2)}\n`);
+  expect(screenshot.byteLength).toBeGreaterThan(1000);
+});

package/templates/animation-studio/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Aura3D Animation Studio</title>
+  </head>
+  <body style="margin:0;background:#0b0f1a;">
+    <div id="app"></div>
+    <script type="module" src="/src/render-live-route.ts"></script>
+  </body>
+</html>

package/templates/animation-studio/node_modules.publish-aside/.vite/deps/_metadata.json

@@ -0,0 +1,8 @@
+{
+  "hash": "ffc76a4e",
+  "configHash": "a0e1cf88",
+  "lockfileHash": "014abcc5",
+  "browserHash": "7931f362",
+  "optimized": {},
+  "chunks": {}
+}

package/templates/animation-studio/node_modules.publish-aside/.vite/deps/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/templates/animation-studio/package.json

@@ -19,7 +19,7 @@
     "@aura3d/animation": "1.3.2",
     "@aura3d/assets": "1.3.2",
     "@aura3d/core": "1.3.2",
-    "@aura3d/engine": "1.3.2",
+    "@aura3d/engine": "1.3.3",
     "@aura3d/physics": "1.3.2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",

package/templates/animation-studio/scripts/animation-scene.ts

@@ -33,7 +33,7 @@ import { validateEpisodeDocument } from "../src/animation-episode-validator.js";
 import { addShot, clearProps, placeProp, removeDialogueLine, removeShot, retimeDialogue, retimeShot, setBlocking, setCamera, setCharacterScale, setDialogueLine, setGesture } from "../src/studio/scene-tools.js";
 import { compileEpisodeDocument } from "../src/director/compile-episode-document.js";
 import type { DirectorSceneInput } from "../src/director/director-heuristics.js";
-import { generateSceneFromPrompt } from "../src/director/prompt-to-scene.js";
+import { generateSceneFromPrompt } from "../src/director/prompt-scene.js";
 import { SET_TEMPLATES, getSetTemplate, pickSetForPrompt } from "../src/set-templates.js";
 import { resolveAsset, resolveLocalGlb, type ResolvedAsset } from "./resolve-asset.js";
 

package/templates/animation-studio/scripts/asset-motion-probe.ts

@@ -211,9 +211,15 @@ const VOCAB_KEYWORDS: Readonly<Record<StandardClipId, readonly string[]>> = {
   gesture: ["wave", "waving", "gesture", "greet", "hello", "clap"],
   point: ["point", "pointing", "aim", "indicate"],
   nod: ["nod", "nodding", "yes", "agree"],
+  wave: ["wave", "waving", "greet", "hello", "goodbye", "farewell"],
   walk: ["walk", "walking", "stride"],
   run: ["run", "running", "sprint", "jog"],
-  react: ["react", "reaction", "surprised", "flinch", "recoil", "hit", "damage", "dodge"]
+  react: ["react", "reaction", "surprised", "flinch", "recoil", "hit", "damage", "dodge"],
+  sit: ["sit", "sitting", "seat", "seated"],
+  shrug: ["shrug", "shrugging", "dunno", "uncertain"],
+  cross_arms: ["cross", "arms", "armcross", "defiant", "impatient"],
+  salute: ["salute", "saluting", "respect", "military"],
+  shake_head: ["shake", "head", "no", "disagree", "deny"]
 };
 
 export interface ClipMotionScore {

package/templates/animation-studio/scripts/author-office-scene.ts

@@ -7,7 +7,7 @@
 import { writeFileSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { generateSceneFromPrompt } from "../src/director/prompt-to-scene.js";
+import { generateSceneFromPrompt } from "../src/director/prompt-scene.js";
 import { directScene } from "../src/director/director-heuristics.js";
 import { estimateSpeechDuration } from "../src/episode-document.js";
 

package/templates/animation-studio/scripts/build-characters.ts

@@ -1480,7 +1480,7 @@ function main(): void {
     );
   }
   // The generator binds prompt casts to NEUTRAL copies (cast-a/cast-b) of the two leads
-  // (see src/director/prompt-to-scene.ts). Re-copy them byte-for-byte from the freshly
+  // (see src/director/prompt-scene.ts). Re-copy them byte-for-byte from the freshly
   // textured leads so the default generated cast picks up the new bitmap textures too.
   if (!LOW_FI) {
     const COPIES: readonly { from: string; to: string }[] = [

package/templates/animation-studio/scripts/render-live.ts

@@ -59,6 +59,26 @@ const OUTPUT_DIR = resolve(TEMPLATE_ROOT, process.env.AURA_OUTPUT_DIR ?? "dist/e
 const FRAMES_DIR = resolve(OUTPUT_DIR, "frames");
 const VIDEO_PATH = resolve(OUTPUT_DIR, "episode-3d.webm");
 
+// SSE render-progress contract (read by the studio dev server's /api/render-progress).
+const PROGRESS_PATH = resolve(OUTPUT_DIR, "progress.json");
+/**
+ * Atomic progress write: temp file + rename so the 200 ms SSE reader can never observe a
+ * partially written JSON (which it would surface as a bogus {label:"unknown", pct:0}).
+ * Guards total <= 0 so a zero-frame range can't produce Infinity/NaN pct.
+ */
+function writeProgress(current: number, total: number, label: string): void {
+  try {
+    const pct = total <= 0 ? 100 : Math.round((current / total) * 100);
+    const tmp = `${PROGRESS_PATH}.tmp`;
+    writeFileSync(tmp, JSON.stringify({ current, total, label, pct, ts: Date.now() }));
+    renameSync(tmp, PROGRESS_PATH);
+  } catch {}
+}
+// FIRST action of the script: publish an initial 0% entry so the SSE reader never replays a
+// previous render's final 100% (and the stale-file window shrinks to the tsx startup time).
+mkdirSync(OUTPUT_DIR, { recursive: true });
+writeProgress(0, 1, "starting");
+
 // M5 — RESOLUTION / OUTPUT TIERS via AURA_QUALITY:
 //   preview  (DEFAULT) = low-fi 480x270 @ 8fps, cheaper post — fast studio iteration.
 //   final               = 1080p (1920x1080) @ 24fps with the full post pass and no preview
@@ -507,6 +527,8 @@ async function main(): Promise<void> {
       `rendering frames ${FIRST_FRAME}..${LAST_FRAME} (${LAST_FRAME - FIRST_FRAME} frames) @ ${FRAME_RATE}fps` +
         `${PREVIEW_PARTS ? " [preview range]" : ` over ${EPISODE_DURATION}s`} ...`
     );
+    writeProgress(0, LAST_FRAME - FIRST_FRAME, "seeking");
+
     for (let i = FIRST_FRAME; i < LAST_FRAME; i += 1) {
       const t = i / FRAME_RATE;
       const result = await seekAndReadPixels(page, t, { burnCaption: false });
@@ -560,6 +582,7 @@ async function main(): Promise<void> {
       const basePng = await rawRgbaToPng(treated.pixels, WIDTH, HEIGHT);
       const png = await compositeCaptionPng(basePng, capText, WIDTH, HEIGHT);
       captured.push({ time: t, png });
+      writeProgress(i - FIRST_FRAME + 1, LAST_FRAME - FIRST_FRAME, "capturing");
 
       const fidelityId = fidelityFrameIndex.get(i);
       if (fidelityId) writeFileSync(resolve(FRAMES_DIR, `${fidelityId}.png`), png);
@@ -574,6 +597,7 @@ async function main(): Promise<void> {
       }
     }
 
+    writeProgress(LAST_FRAME - FIRST_FRAME, LAST_FRAME - FIRST_FRAME, "finishing");
     console.log("\n--- staged performance (per beat) ---");
     for (const beat of stagingByBeat.values()) {
       const m = beat.characters.find((c) => c.id === "miko");

package/templates/animation-studio/src/director/director-heuristics.ts

@@ -409,7 +409,7 @@ const LOW_MOTION = new Set<PerformanceClip>(["idle", "talk"]);
  *     (as speaker OR listener) — unless that character is explicitly `staged` (e.g. a
  *     background extra the director deliberately froze).
  * It also flags the absence of any gesture or any listener reaction, which the
- * prompt-to-scene proof asserts must both be present.
+ * prompt-scene proof asserts must both be present.
  *
  * `stagedStatic` lists character ids that are *allowed* to be motionless on purpose.
  */
@@ -462,7 +462,7 @@ export function validateDirectedActing(
     }
   }
 
-  // (3) Variety asserts the prompt-to-scene proof depends on.
+  // (3) Variety asserts the prompt-scene proof depends on.
   const GESTURE_INTENTS = new Set<PerformanceClip>(["gesture", "point", "nod"]);
   if (!beats.some((b) => GESTURE_INTENTS.has(b.speakingIntent))) {
     issues.push({ code: "NO_GESTURE", message: "No speaker ever gestures/points/nods — acting is all talk." });