@vosjs/cli 0.17.4 → 0.19.0

package/dist/{chunk-Y7BXFF2W.js → chunk-4LLBPFCW.js}

@@ -6,11 +6,11 @@ import {
 } from "./chunk-NHKHTIDR.js";
 
 // src/plugin/run.ts
-import { mkdir as mkdir9, readFile as readFile13, rm as rm4 } from "fs/promises";
-import { existsSync as existsSync13 } from "fs";
-import { join as join16, resolve as resolve8 } from "path";
+import { mkdir as mkdir9, readFile as readFile14, rm as rm4 } from "fs/promises";
+import { existsSync as existsSync14 } from "fs";
+import { join as join17, resolve as resolve9 } from "path";
 import { totalDuration as totalDuration2 } from "@vosjs/timeline";
-import { migrateHostedDoc as migrateHostedDoc4, ratedSegments as ratedSegments6 } from "@vosjs/studio-core";
+import { migrateHostedDoc as migrateHostedDoc5, ratedSegments as ratedSegments6 } from "@vosjs/studio-core";
 
 // src/plugin/args.ts
 var UsageError = class extends Error {
@@ -181,6 +181,13 @@ import {
   CAM_SIZE_MAX,
   CAM_SIZE_MIN,
   CAM_SPAN_MIN,
+  CARD_ENTER_KINDS,
+  CARD_EXIT_KINDS,
+  IDLE_KINDS,
+  MEDIA_ENTER_KINDS,
+  MEDIA_EXIT_KINDS,
+  TEXT_ENTER_KINDS,
+  TEXT_EXIT_KINDS,
   EXPORT_RESOLUTION_OPTIONS,
   SPEED_RATE_MAX,
   SPEED_RATE_MIN,
@@ -196,6 +203,79 @@ import {
   zoomCoversRect
 } from "@vosjs/studio-core";
 import { TYPEFACE_CATALOG, findFontFamily, findTypeface } from "@vosjs/shared";
+var STEP_KINDS_ALL = [
+  "none",
+  "fade",
+  "rise",
+  "pop",
+  "blur",
+  "typewriter",
+  "tilt-in",
+  "pull-out",
+  "recede"
+];
+var STEP_UNITS = ["block", "line", "word", "char"];
+var STEP_DIRS = ["forward", "reverse", "center"];
+function lintAnim(name, anim, kinds, problems) {
+  if (anim === void 0) return;
+  if (typeof anim !== "object" || anim === null || Array.isArray(anim)) {
+    problems.push(`${name}.anim must be { enter?, exit?, idle? }`);
+    return;
+  }
+  const a = anim;
+  for (const side of ["enter", "exit"]) {
+    const step = a[side];
+    if (step === void 0) continue;
+    const allowed = kinds[side];
+    const spelled = typeof step === "string" ? step : null;
+    const obj = typeof step === "object" && step !== null && !Array.isArray(step) ? step : null;
+    const kind = spelled ?? (obj ? obj.kind : void 0);
+    if (typeof kind !== "string" || !STEP_KINDS_ALL.includes(kind)) {
+      problems.push(
+        `${name}.anim.${side} must be a kind or { kind, seconds?${kinds.words ? ", unit?, direction?, stagger?" : ""} } (got ${JSON.stringify(step)})`
+      );
+      continue;
+    }
+    if (!allowed.includes(kind)) {
+      problems.push(
+        `${name}.anim.${side} cannot be "${kind}" here; one of ${allowed.join(" | ")}`
+      );
+    }
+    if (!obj) continue;
+    const secs = obj.seconds;
+    if (secs !== void 0 && (typeof secs !== "number" || !Number.isFinite(secs) || secs < 0.05 || secs > 3)) {
+      problems.push(`${name}.anim.${side}.seconds must be 0.05..3`);
+    }
+    for (const key of ["unit", "direction", "stagger"]) {
+      if (obj[key] === void 0) continue;
+      if (!kinds.words) {
+        problems.push(`${name}.anim.${side}.${key} is for words only`);
+        continue;
+      }
+      if (key === "unit" && (typeof obj.unit !== "string" || !STEP_UNITS.includes(obj.unit)))
+        problems.push(
+          `${name}.anim.${side}.unit must be ${STEP_UNITS.join("|")}`
+        );
+      if (key === "direction" && (typeof obj.direction !== "string" || !STEP_DIRS.includes(obj.direction)))
+        problems.push(
+          `${name}.anim.${side}.direction must be ${STEP_DIRS.join("|")}`
+        );
+      if (key === "stagger" && (typeof obj.stagger !== "number" || obj.stagger < 0 || obj.stagger > 2))
+        problems.push(`${name}.anim.${side}.stagger must be seconds in 0..2`);
+    }
+  }
+  if (a.idle !== void 0 && a.idle !== null) {
+    if (!kinds.idle) problems.push(`${name}.anim.idle is for props only`);
+    else if (typeof a.idle !== "string" || !kinds.idle.includes(a.idle))
+      problems.push(
+        `${name}.anim.idle must be ${kinds.idle.join(" | ")} | null`
+      );
+  }
+}
+function lintFrom(name, from, problems) {
+  if (from !== void 0 && (typeof from !== "string" || !from.length))
+    problems.push(`${name}.from must be the id of the template that placed it`);
+}
 var EPS = 1e-3;
 var isNum = (v) => typeof v === "number" && Number.isFinite(v);
 var isObj = (v) => typeof v === "object" && v !== null;
@@ -328,19 +408,27 @@ function lintDoc(docIn) {
     const endCard = doc.endCard;
     if (endCard !== void 0) {
       if (typeof endCard !== "object" || endCard === null) {
-        problems.push("endCard must be an object: {seconds?, headline?, sub?, wordmark?}");
+        problems.push(
+          "endCard must be an object: {seconds?, headline?, sub?, wordmark?}"
+        );
       } else {
         const ec = endCard;
         if (ec.seconds !== void 0 && (!isNum(ec.seconds) || ec.seconds < 1 || ec.seconds > 8)) {
-          problems.push(`endCard.seconds must be 1..8 (got ${String(ec.seconds)}); absent = 2.5`);
+          problems.push(
+            `endCard.seconds must be 1..8 (got ${String(ec.seconds)}); absent = 2.5`
+          );
         }
         for (const k of ["headline", "sub", "wordmark"]) {
           if (ec[k] !== void 0 && typeof ec[k] !== "string") {
             problems.push(`endCard.${k} must be a string`);
           }
         }
-        if (!["headline", "sub", "wordmark"].some((k) => typeof ec[k] === "string" && ec[k].trim())) {
-          warnings.push("endCard carries no words: it holds the last frame and recedes the card over nothing");
+        if (!["headline", "sub", "wordmark"].some(
+          (k) => typeof ec[k] === "string" && ec[k].trim()
+        )) {
+          warnings.push(
+            "endCard carries no words: it holds the last frame and recedes the card over nothing"
+          );
         }
       }
     }
@@ -579,6 +667,17 @@ function lintDoc(docIn) {
           }
         }
       }
+      lintAnim(
+        "frame",
+        frame.anim,
+        {
+          enter: CARD_ENTER_KINDS,
+          exit: CARD_EXIT_KINDS,
+          idle: null,
+          words: false
+        },
+        problems
+      );
       if (frame.focusFollow !== void 0 && frame.focusFollow !== "camera") {
         problems.push(
           `frame.focusFollow must be "camera" (got ${String(frame.focusFollow)}); it reads under fit: cover only`
@@ -826,6 +925,23 @@ function lintDoc(docIn) {
         problems.push(`${name}.${key} must be one of ${TRANSITIONS.join("|")}`);
       }
     }
+    lintAnim(
+      name,
+      o.anim,
+      o.kind === "text" ? {
+        enter: TEXT_ENTER_KINDS,
+        exit: TEXT_EXIT_KINDS,
+        idle: null,
+        words: true
+      } : {
+        enter: MEDIA_ENTER_KINDS,
+        exit: MEDIA_EXIT_KINDS,
+        idle: null,
+        words: false
+      },
+      problems
+    );
+    lintFrom(name, o.from, problems);
     if (o.motion !== void 0) {
       if (!Array.isArray(o.motion)) {
         problems.push(`${name}.motion must be an array of poses`);
@@ -956,6 +1072,18 @@ function lintDoc(docIn) {
     if (o.animation !== void 0 && o.animation !== null && o.animation !== "spin" && o.animation !== "float") {
       problems.push(`${name}.animation must be "spin" | "float" | null`);
     }
+    lintAnim(
+      name,
+      o.anim,
+      {
+        enter: MEDIA_ENTER_KINDS,
+        exit: MEDIA_EXIT_KINDS,
+        idle: IDLE_KINDS,
+        words: false
+      },
+      problems
+    );
+    lintFrom(name, o.from, problems);
     if (o.motion !== void 0) {
       if (!Array.isArray(o.motion)) {
         problems.push(`${name}.motion must be an array of poses`);
@@ -1352,10 +1480,10 @@ function startTakeServer(rootDir, pages) {
     res.writeHead(404).end();
   });
   return new Promise(
-    (resolve9) => server.listen(0, () => {
+    (resolve10) => server.listen(0, () => {
       const addr = server.address();
       const port = typeof addr === "object" && addr ? addr.port : 0;
-      resolve9({ base: `http://localhost:${port}`, close: () => server.close() });
+      resolve10({ base: `http://localhost:${port}`, close: () => server.close() });
     })
   );
 }
@@ -1806,7 +1934,7 @@ async function resolveBackdropSlug(o) {
   o.backgroundDuration = hit.duration;
 }
 function hasOverrides(o) {
-  return !!(o.set?.length || o.frame !== void 0 || o.background !== void 0);
+  return !!(o.set?.length || o.unset?.length || o.frame !== void 0 || o.background !== void 0);
 }
 var FRAME_KINDS = {
   macos: "mac-light",
@@ -1913,6 +2041,16 @@ function applyDocOverrides(doc, o) {
     setPath(d, path, value);
     applied.push(`${path} = ${JSON.stringify(value)}`);
   }
+  for (const path of o.unset ?? []) {
+    const segs = parsePath(path);
+    let node = d;
+    for (let i = 0; i < segs.length - 1 && node && typeof node === "object"; i++)
+      node = node[segs[i].key];
+    if (node && typeof node === "object") {
+      delete node[segs[segs.length - 1].key];
+      applied.push(`${path} removed`);
+    }
+  }
   return applied;
 }
 function applyAndValidate(doc, o) {
@@ -2476,8 +2614,8 @@ async function stillsInPage(opts) {
 }
 async function framesTake(browser, dir, opts) {
   const take = await loadTake(dir);
-  if (!take.doc) throw new Error(`${dir} has no doc.json \u2014 run plan first`);
-  const doc = take.doc;
+  const doc = opts.doc ? structuredClone(opts.doc) : take.doc;
+  if (!doc) throw new Error(`${dir} has no doc.json \u2014 run plan first`);
   if (opts.overrides && hasOverrides(opts.overrides)) {
     await resolveBackdropSlug(opts.overrides);
     applyAndValidate(doc, opts.overrides);
@@ -2505,7 +2643,7 @@ async function framesTake(browser, dir, opts) {
     }
   }
   if (opts.atMoments) {
-    for (const m of await momentsFor(dir, take.doc)) {
+    for (const m of await momentsFor(dir, doc)) {
       if (m.outputAt === null) continue;
       shots.push({ time: clamp(m.outputAt), kind: "moment", momentId: m.id });
     }
@@ -2618,9 +2756,9 @@ async function writeIndexJson(result) {
 }
 
 // src/plugin/deliver.ts
-import { mkdir as mkdir5, mkdtemp, rename as rename4, rm as rm3, stat, writeFile as writeFile7 } from "fs/promises";
+import { mkdir as mkdir4, mkdtemp, rename as rename4, rm as rm3, stat, writeFile as writeFile6 } from "fs/promises";
 import { tmpdir } from "os";
-import { join as join6, relative, resolve as resolve4 } from "path";
+import { join as join7, relative, resolve as resolve4 } from "path";
 import { totalDuration } from "@vosjs/timeline";
 import { existsSync as existsSync6 } from "fs";
 import { readFile as readFile6 } from "fs/promises";
@@ -2741,114 +2879,6 @@ async function renderTake(browser, dir, outFile, opts) {
   };
 }
 
-// src/plugin/posterStill.ts
-import { compileVosConfig as compileVosConfig3 } from "@vosjs/core";
-async function posterStillInPage(opts) {
-  const w = window;
-  const RW = opts.W * opts.ss;
-  const RH = opts.H * opts.ss;
-  try {
-    const mod = await import(
-      /* @vite-ignore */
-      URL.createObjectURL(
-        new Blob([opts.animationCode], { type: "text/javascript" })
-      )
-    );
-    w.__vos__ = w.__vos__ || {};
-    w.__vos__.isPaused = true;
-    const deps = {
-      THREE: w.__THREE__,
-      gsap: w.__gsap__,
-      resolution: {
-        width: RW,
-        height: RH,
-        pixelRatio: 1,
-        drawingBufferWidth: RW,
-        drawingBufferHeight: RH
-      },
-      preserveDrawingBuffer: true
-    };
-    const result = await mod.initVos(document.body, deps);
-    if (result.assetsReady) await result.assetsReady;
-    const { timeline } = result;
-    timeline.pause();
-    timeline.seek(opts.time, false);
-    const canvas = document.querySelector("canvas");
-    canvas.width = RW;
-    canvas.height = RH;
-    canvas.style.width = RW + "px";
-    canvas.style.height = RH + "px";
-    const raf = () => new Promise((r) => requestAnimationFrame(r));
-    await raf();
-    await raf();
-    await raf();
-    let src = canvas;
-    if (opts.ss > 1) {
-      const out = document.createElement("canvas");
-      out.width = opts.W;
-      out.height = opts.H;
-      const g = out.getContext("2d");
-      g.imageSmoothingEnabled = true;
-      g.imageSmoothingQuality = "high";
-      g.drawImage(canvas, 0, 0, opts.W, opts.H);
-      src = out;
-    }
-    const png = await new Promise(
-      (res) => src.toBlob((b) => res(b), "image/png")
-    );
-    if (!png) throw new Error("toBlob returned null");
-    await fetch("/save?name=" + opts.outName, { method: "POST", body: png });
-    w.__done = { ok: true };
-  } catch (e) {
-    w.__error = String(e instanceof Error && e.stack || e);
-  }
-}
-async function renderPosterStills(browser, config, serveDir, shots, time) {
-  const animationCode = compileVosConfig3(config, {
-    tweenEngine: "vos"
-  });
-  const server = await startTakeServer(serveDir, {
-    "/render.html": renderPageHtml()
-  });
-  try {
-    for (const shot of shots) {
-      const ss = stillSupersample(shot.width, shot.height);
-      const context = await browser.newContext({
-        viewport: { width: shot.width * ss, height: shot.height * ss }
-      });
-      try {
-        const page = await context.newPage();
-        page.on("console", (m) => {
-          if (m.type() === "error")
-            process.stderr.write(`   [poster page] ${m.text()}
-`);
-        });
-        await page.addInitScript(() => {
-          ;
-          globalThis.__name = (f) => f;
-        });
-        await page.goto(`${server.base}/render.html`);
-        await page.waitForFunction("window.__pageReady__ === true");
-        void page.evaluate(posterStillInPage, {
-          animationCode,
-          W: shot.width,
-          H: shot.height,
-          ss,
-          time,
-          outName: shot.name
-        }).catch(() => {
-        });
-        await waitForPageDone(page, `poster ${shot.name}`, () => {
-        }, 12e4);
-      } finally {
-        await context.close();
-      }
-    }
-  } finally {
-    server.close();
-  }
-}
-
 // src/plugin/moments.ts
 import { ratedSegments as ratedSegments3, spanOutputExtent as spanOutputExtent3 } from "@vosjs/studio-core";
 
@@ -3356,1242 +3386,516 @@ function pickMoments(measured, opts = {}) {
   return { times: kept.map((k) => k.time), dropped };
 }
 
-// src/plugin/shotBake.ts
-import { deflateSync } from "zlib";
-function blurPlane(src, w, h, r, passes = 3) {
-  if (r < 1) return;
-  const tmp = new Float32Array(src.length);
-  for (let p = 0; p < passes; p++) {
-    for (let y = 0; y < h; y++) {
-      let acc = 0;
-      const row = y * w;
-      for (let x = -r; x <= r; x++)
-        acc += src[row + Math.min(w - 1, Math.max(0, x))];
-      for (let x = 0; x < w; x++) {
-        tmp[row + x] = acc / (2 * r + 1);
-        const add = src[row + Math.min(w - 1, x + r + 1)];
-        const sub = src[row + Math.max(0, x - r)];
-        acc += add - sub;
-      }
-    }
-    for (let x = 0; x < w; x++) {
-      let acc = 0;
-      for (let y = -r; y <= r; y++)
-        acc += tmp[Math.min(h - 1, Math.max(0, y)) * w + x];
-      for (let y = 0; y < h; y++) {
-        src[y * w + x] = acc / (2 * r + 1);
-        const add = tmp[Math.min(h - 1, y + r + 1) * w + x];
-        const sub = tmp[Math.max(0, y - r) * w + x];
-        acc += add - sub;
-      }
-    }
+// src/plugin/motionPlan.ts
+import { ratedSegments as ratedSegments4, spanOutputExtent as spanOutputExtent4 } from "@vosjs/studio-core";
+var SOUND_DESTINATIONS = /* @__PURE__ */ new Set([
+  "x-feed-cut",
+  "youtube-main-demo",
+  "shorts-linkedin-vertical-cut"
+]);
+var LOOP_DESTINATIONS = /* @__PURE__ */ new Set(["github-readme-loop"]);
+var BED_ID = "bed";
+var CLICK_ID_PREFIX = "click-";
+var CAPTION_ID_PREFIX = "caption-";
+var off = (v) => v !== void 0 && /^(none|off|false|no)$/i.test(v.trim());
+function pickTrack(catalog, ask) {
+  if (!catalog || !ask || off(ask)) return null;
+  const want = ask.trim().toLowerCase();
+  return catalog.tracks.find((t) => t.slug.toLowerCase() === want) ?? catalog.tracks.find((t) => (t.mood ?? "").toLowerCase() === want) ?? null;
+}
+function clickTimes(doc, range) {
+  const rated = ratedSegments4(doc);
+  const out = [];
+  for (const e of doc.source.cursor) {
+    if (e.type !== "down") continue;
+    const src = e.t / 1e3;
+    const ext = spanOutputExtent4(rated, src, src + 1e-3);
+    if (!ext) continue;
+    const t = ext.start;
+    if (t < range[0] || t > range[1]) continue;
+    if (out.length && t - out[out.length - 1] < 0.12) continue;
+    out.push(+(t - range[0]).toFixed(3));
   }
+  return out;
 }
-function roundedCoverage(x, y, rect, r) {
-  let inside = 0;
-  for (const dy of [0.25, 0.75]) {
-    for (const dx of [0.25, 0.75]) {
-      const px = x + dx;
-      const py = y + dy;
-      if (px < rect.x || py < rect.y || px > rect.x + rect.w || py > rect.y + rect.h)
-        continue;
-      const cx = Math.min(Math.max(px, rect.x + r), rect.x + rect.w - r);
-      const cy = Math.min(Math.max(py, rect.y + r), rect.y + rect.h - r);
-      if ((px - cx) ** 2 + (py - cy) ** 2 <= r * r) inside++;
-    }
-  }
-  return inside / 4;
-}
-function bakeShot(shot, opts = {}) {
-  const margin = Math.round(shot.w * (opts.margin ?? 0.06));
-  const radius = shot.w * (opts.radius ?? 0.014);
-  const shadowA = opts.shadow ?? 0.3;
-  const blur = Math.round(shot.w * (opts.blur ?? 0.05));
-  const offsetY = Math.round(shot.w * (opts.offsetY ?? 0.02));
-  const hair = opts.hairline ?? 0;
-  const w = shot.w + margin * 2;
-  const h = shot.h + margin * 2;
-  const out = new Uint8Array(w * h * 4);
-  const rect = { x: margin, y: margin, w: shot.w, h: shot.h };
-  if (shadowA > 0) {
-    const layers = [
-      [Math.max(1, Math.round(blur / 4)), Math.round(offsetY / 5), 0.4],
-      [blur, offsetY, 0.6]
-    ];
-    const acc = new Float32Array(w * h);
-    for (const [lb, lo, share] of layers) {
-      const mask = new Float32Array(w * h);
-      for (let y = 0; y < h; y++)
-        for (let x = 0; x < w; x++) {
-          const c = roundedCoverage(x, y - lo, rect, radius);
-          if (c > 0) mask[y * w + x] = c;
-        }
-      blurPlane(mask, w, h, Math.max(1, Math.round(lb / 2)));
-      const a = shadowA * share;
-      for (let i = 0; i < w * h; i++)
-        acc[i] = 1 - (1 - acc[i]) * (1 - mask[i] * a);
+var outputLength = (doc) => ratedSegments4(doc).reduce((acc, s) => {
+  const rate = s.rate && s.rate > 0 ? s.rate : 1;
+  return acc + (s.out - s.in) / rate;
+}, 0);
+function proposeMotion(input, opts) {
+  const doc = structuredClone(input);
+  const { words, launch, catalog } = opts;
+  const notes = [];
+  const skipped = [];
+  const length = outputLength(doc);
+  const range = [0, length];
+  const entrance = launch.entrance;
+  if (!off(entrance)) {
+    const kind = entrance && /^(tilt-in|pull-out|rise)$/.test(entrance.trim()) ? entrance.trim() : "tilt-in";
+    doc.frame.entrance = { kind };
+    notes.push(`entrance ${kind}`);
+  } else {
+    delete doc.frame.entrance;
+  }
+  if (!off(launch.endCard)) {
+    const headline = (words.headline ?? "").trim();
+    const brand = (words.brand ?? "").trim();
+    const sub = [brand, (words.release ?? "").trim()].filter(Boolean).join(" ");
+    if (headline || brand) {
+      const card = { seconds: 2.5 };
+      if (opts.ink) card.ink = opts.ink;
+      if (headline) card.headline = headline;
+      if (sub && sub !== headline) card.sub = sub;
+      if (brand) card.wordmark = brand;
+      if (opts.mark) card.mark = opts.mark;
+      doc.endCard = card;
+      notes.push("end card");
+    } else {
+      skipped.push(
+        "no end card (no headline or wordmark in LAUNCH.md, BRAND.md or the flags)"
+      );
     }
-    for (let i = 0; i < w * h; i++) {
-      const a = acc[i];
-      if (a <= 2e-3) continue;
-      out[i * 4] = 0;
-      out[i * 4 + 1] = 0;
-      out[i * 4 + 2] = 0;
-      out[i * 4 + 3] = Math.round(a * 255);
+  } else {
+    delete doc.endCard;
+  }
+  const kept = (doc.overlays ?? []).filter(
+    (o) => !o.id.startsWith(CAPTION_ID_PREFIX)
+  );
+  const captionClips = [];
+  if (opts.captions.length && !off(launch.captions)) {
+    const rated = ratedSegments4(doc);
+    const steps = doc.source.meta.steps ?? [];
+    for (const c of opts.captions) {
+      const step = steps.find(
+        (s) => c.id !== void 0 && s.id === c.id || s.step === c.step
+      );
+      if (!step || step.skipped) continue;
+      const t = stepOutputTime(rated, step, 0.2);
+      if (t === null || t < 0 || t > length - 1) continue;
+      captionClips.push({
+        id: `${CAPTION_ID_PREFIX}${c.step}`,
+        kind: "text",
+        text: c.caption,
+        preset: "caption",
+        start: +t.toFixed(3),
+        duration: Math.min(3.5, Math.max(2.5, length - t - 0.2)),
+        transform: { x: 0.5, y: 0.86, scale: 1, rotation: 0 },
+        enter: "rise",
+        exit: "fade",
+        align: "center",
+        box: { color: "rgba(17,17,17,0.72)" }
+      });
     }
+    if (captionClips.length) notes.push(`${captionClips.length} caption(s)`);
   }
-  for (let y = 0; y < h; y++) {
-    for (let x = 0; x < w; x++) {
-      const cov = roundedCoverage(x, y, rect, radius);
-      if (cov <= 0) continue;
-      const sx = Math.min(shot.w - 1, Math.max(0, x - margin));
-      const sy = Math.min(shot.h - 1, Math.max(0, y - margin));
-      const si = (sy * shot.w + sx) * 4;
-      const o = (y * w + x) * 4;
-      let r = shot.data[si];
-      let g = shot.data[si + 1];
-      let b = shot.data[si + 2];
-      if (hair > 0) {
-        const edge = Math.min(
-          x - rect.x,
-          rect.x + rect.w - x,
-          y - rect.y,
-          rect.y + rect.h - y
-        );
-        if (edge < 1.5) {
-          r = Math.round(r * (1 - hair));
-          g = Math.round(g * (1 - hair));
-          b = Math.round(b * (1 - hair));
-        }
-      }
-      const a = cov;
-      const ba = out[o + 3] / 255;
-      const outA = a + ba * (1 - a);
-      const mix = (fg, bg) => outA > 0 ? Math.round((fg * a + bg * ba * (1 - a)) / outA) : 0;
-      out[o] = mix(r, out[o]);
-      out[o + 1] = mix(g, out[o + 1]);
-      out[o + 2] = mix(b, out[o + 2]);
-      out[o + 3] = Math.round(outA * 255);
+  const overlays = [...kept, ...captionClips];
+  if (overlays.length) doc.overlays = overlays;
+  else delete doc.overlays;
+  const clips = (doc.audio ?? []).filter(
+    (a) => a.id !== BED_ID && !a.id.startsWith(CLICK_ID_PREFIX)
+  );
+  const track = pickTrack(catalog, launch.music);
+  if (track) {
+    const hasMic = !!doc.source.micKey;
+    const fadeOut = Math.min(2.5, length * 0.15);
+    clips.push({
+      id: BED_ID,
+      key: track.url,
+      name: track.title,
+      start: 0,
+      in: 0,
+      out: Math.min(track.duration, length),
+      duration: track.duration,
+      gain: hasMic ? 0.35 : 0.5,
+      fadeIn: 0.6,
+      fadeOut,
+      loop: track.duration < length,
+      loopLen: track.duration < length ? length : void 0,
+      duck: hasMic
+    });
+    notes.push(`bed ${track.slug}`);
+  } else if (launch.music && !off(launch.music)) {
+    skipped.push(
+      `music "${launch.music}" is not a catalog track or mood${catalog ? "" : " (the catalog could not be read)"}`
+    );
+  }
+  const click = catalog?.sfx.find((s) => s.slug === "sfx-click");
+  if (click && !doc.source.micKey && !off(launch.clicks)) {
+    const times = clickTimes(doc, range);
+    for (const [i, t] of times.entries()) {
+      clips.push({
+        id: `${CLICK_ID_PREFIX}${i}`,
+        key: click.url,
+        name: click.title,
+        start: t,
+        in: 0,
+        out: click.duration,
+        duration: click.duration,
+        gain: 0.4,
+        fadeIn: 0,
+        fadeOut: 0
+      });
     }
+    if (times.length) notes.push(`${times.length} click sound(s)`);
   }
-  return { w, h, data: out };
+  doc.audio = clips;
+  return { doc, notes, skipped };
 }
-var crcTable = (() => {
-  const t = new Uint32Array(256);
-  for (let n = 0; n < 256; n++) {
-    let c = n;
-    for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
-    t[n] = c >>> 0;
+function destinationMechanics(d, doc) {
+  const set = [];
+  const unset = [];
+  const notes = [];
+  if (d.kind !== "video") return { set, unset, notes };
+  const loop = LOOP_DESTINATIONS.has(d.id);
+  const sound = SOUND_DESTINATIONS.has(d.id);
+  const portrait = d.px.w / d.px.h < 0.9;
+  if (loop) {
+    unset.push("frame.entrance", "endCard");
+    notes.push("loop: no entrance, no end card");
   }
-  return t;
-})();
-function crc32(buf) {
-  let c = 4294967295;
-  for (const b of buf) c = crcTable[(c ^ b) & 255] ^ c >>> 8;
-  return (c ^ 4294967295) >>> 0;
-}
-function chunk(type, body) {
-  const out = new Uint8Array(12 + body.length);
-  const dv = new DataView(out.buffer);
-  dv.setUint32(0, body.length);
-  for (let i = 0; i < 4; i++) out[4 + i] = type.charCodeAt(i);
-  out.set(body, 8);
-  dv.setUint32(8 + body.length, crc32(out.subarray(4, 8 + body.length)));
-  return out;
-}
-function encodePng(img) {
-  const stride = img.w * 4;
-  const raw = new Uint8Array((stride + 1) * img.h);
-  for (let y = 0; y < img.h; y++) {
-    raw[y * (stride + 1)] = 2;
-    for (let i = 0; i < stride; i++) {
-      const cur = img.data[y * stride + i];
-      const up = y ? img.data[(y - 1) * stride + i] : 0;
-      raw[y * (stride + 1) + 1 + i] = cur - up & 255;
+  if (loop || !sound) {
+    set.push("audio=[]");
+    if (!loop) notes.push("silent channel");
+  }
+  if (loop || d.text === "none") {
+    const kept = (doc.overlays ?? []).filter(
+      (o) => !o.id.startsWith(CAPTION_ID_PREFIX)
+    );
+    if (kept.length !== (doc.overlays ?? []).length) {
+      set.push(`overlays=${JSON.stringify(kept)}`);
+      notes.push("no captions");
     }
   }
-  const ihdr = new Uint8Array(13);
-  const dv = new DataView(ihdr.buffer);
-  dv.setUint32(0, img.w);
-  dv.setUint32(4, img.h);
-  ihdr[8] = 8;
-  ihdr[9] = 6;
-  const parts = [
-    new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]),
-    chunk("IHDR", ihdr),
-    chunk("IDAT", new Uint8Array(deflateSync(raw))),
-    chunk("IEND", new Uint8Array(0))
-  ];
-  const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
-  let o = 0;
-  for (const p of parts) {
-    out.set(p, o);
-    o += p.length;
+  if (portrait) {
+    set.push("frame.fit=cover");
+    set.push('frame.inset={"left":0.06,"right":0.06,"top":0.17,"bottom":0.17}');
+    set.push("frame.focusFollow=camera");
+    notes.push("vertical reframe follows the camera");
   }
-  return out;
+  return { set, unset, notes };
 }
-
-// src/plugin/template.ts
-function templateOf(config) {
-  const t = config.template;
-  if (!t || typeof t !== "object") return null;
-  return t;
-}
-function aspectOf(size) {
-  const r = size.w / Math.max(1, size.h);
-  if (r > 1.15) return "landscape";
-  if (r < 0.87) return "portrait";
-  return "square";
+function endCardInk(look, brand) {
+  if (!look) return null;
+  const ground = look.ground;
+  const m = /#([0-9a-f]{6})/i.exec(ground);
+  const hex2 = m ? m[0] : null;
+  const light = look.kind === "plate" || (hex2 ? isLightHexGround(hex2) : look.kind === "gradient");
+  if (!light) return "#ffffff";
+  const ink = brand?.ink;
+  return ink && /^#[0-9a-f]{6}$/i.test(ink) ? ink : "#111111";
 }
-function templateProblems(config) {
-  const t = templateOf(config);
-  if (!t) return ["no template block: a poster template declares config.template"];
-  const out = [];
-  const elements = Array.isArray(config.elements) ? config.elements : [];
-  const byId = new Map(elements.filter((e) => e.id).map((e) => [e.id, e]));
-  const params = Array.isArray(config.params) ? config.params : [];
-  const keys = new Set(params.map((p) => p.key).filter(Boolean));
-  if (!t.family) out.push("template.family is missing");
-  for (const s of t.slots ?? []) {
-    const el = byId.get(s.id);
-    if (!el) out.push(`template.slots: no element with id "${s.id}"`);
-    else if (el.type !== s.kind)
-      out.push(`template.slots: "${s.id}" is a ${String(el.type)} element, the slot wants ${s.kind}`);
-  }
-  for (const x of t.text ?? []) {
-    const el = byId.get(x.element);
-    if (!el) out.push(`template.text: no element with id "${x.element}"`);
-    else if (el.type !== "text") out.push(`template.text: "${x.element}" is not a text element`);
-    if (!keys.has(x.param)) out.push(`template.text: param "${x.param}" is not declared in config.params`);
-    const bound = el?.content;
-    if (el && (!bound || typeof bound !== "object" || bound.$data !== x.param))
-      out.push(`template.text: "${x.element}" must bind its content to {$data: "${x.param}"}`);
-  }
-  for (const k of t.params?.required ?? []) {
-    if (!keys.has(k)) out.push(`template.params.required: "${k}" is not declared in config.params`);
-  }
-  if (!t.layouts?.landscape) out.push("template.layouts.landscape is required");
-  for (const [name, layout] of Object.entries(t.layouts ?? {})) {
-    for (const s of t.slots ?? []) {
-      if (!layout?.slots?.[s.id]) out.push(`template.layouts.${name}: slot "${s.id}" is not placed`);
-    }
-  }
-  return out;
+function isLightHexGround(hex2) {
+  const n = parseInt(hex2.slice(1), 16);
+  const r = n >> 16 & 255;
+  const g = n >> 8 & 255;
+  const b = n & 255;
+  return (0.2126 * r + 0.7152 * g + 0.0722 * b) / 255 >= 0.6;
 }
-var pctOf = (v) => {
-  if (typeof v === "number") return null;
-  if (typeof v !== "string") return null;
-  const m = /^(-?\d+(?:\.\d+)?)%$/.exec(v.trim());
-  return m ? Number(m[1]) / 100 : null;
-};
-function fillTemplate(config, input) {
-  const t = templateOf(config);
-  if (!t) throw new Error("fillTemplate: the config carries no template block");
-  const aspect = aspectOf(input.size);
-  const layout = t.layouts[aspect] ?? t.layouts.landscape;
-  const out = structuredClone(config);
-  const designH = 1080;
-  const designW = designH * input.size.w / input.size.h;
-  const elements = Array.isArray(out.elements) ? out.elements : [];
-  const byId = new Map(elements.filter((e) => e.id).map((e) => [e.id, e]));
-  const slotRects = {};
-  for (const s of t.slots) {
-    const el = byId.get(s.id);
-    const place = layout.slots[s.id];
-    const src = input.slots[s.id];
-    if (!el || !place) continue;
-    if (src) el.src = src.src;
-    const pad = src?.pad ?? 0;
-    slotRects[s.id] = {
-      x: place.x,
-      y: place.y,
-      w: place.w,
-      h: place.w * (input.size.w / input.size.h) / (src?.aspect ?? 16 / 9)
-    };
-    const w = place.w * designW * (1 + 2 * pad);
-    const x = place.x - place.w * pad;
-    const y = place.y - place.w * pad * (input.size.w / input.size.h) / (src?.aspect ?? 16 / 9);
-    el.position = { x: `${(x * 100).toFixed(2)}%`, y: `${(y * 100).toFixed(2)}%` };
-    el.anchor = "top-left";
-    el.size = { ...el.size ?? {}, width: Math.round(w), height: "auto" };
-    if (!src && s.required) el.opacity = 0;
-  }
-  const data = out.data && typeof out.data === "object" ? { ...out.data } : {};
-  const params = Array.isArray(out.params) ? out.params : [];
-  const missing = [];
-  for (const k of [...t.params.required ?? [], ...t.params.brand ?? []]) {
-    if (input.values[k] === void 0 || input.values[k] === null || input.values[k] === "") {
-      if ((t.params.required ?? []).includes(k)) missing.push(k);
-      continue;
-    }
-    data[k] = input.values[k];
-    const p = params.find((q) => q.key === k);
-    if (p) p.default = input.values[k];
-  }
-  for (const [k, v] of Object.entries(input.values)) {
-    if (v !== void 0 && v !== null && v !== "") {
-      data[k] = v;
-      const p = params.find((q) => q.key === k);
-      if (p) p.default = v;
-    }
-  }
-  out.data = data;
-  const boxes = [];
-  for (const x of t.text) {
-    const el = byId.get(x.element);
-    if (!el) continue;
-    const pos = layout.text?.[x.element];
-    if (pos) el.position = { x: pos.x, y: pos.y };
-    const size = layout.size?.[x.element];
-    if (size) el.font = { ...el.font ?? {}, size };
-    if (layout.hide?.includes(x.element)) {
-      el.opacity = 0;
-      continue;
-    }
-    const value = data[x.param];
-    if (typeof value !== "string" || !value.trim()) continue;
-    const font = el.font ?? {};
-    const px = typeof font.size === "number" ? font.size : 40;
-    const lines = value.split("\n");
-    const longest = Math.max(...lines.map((l) => l.length));
-    const lh = typeof font.lineHeight === "number" ? font.lineHeight : 1.15;
-    const boxW = longest * px * 0.56;
-    const boxH = lines.length * px * lh;
-    const ex = pctOf(el.position?.x) ?? 0;
-    const ey = pctOf(el.position?.y) ?? 0;
-    const anchor = String(el.anchor ?? "center");
-    let left = ex * designW;
-    let top = ey * designH;
-    if (anchor.includes("right")) left -= boxW;
-    else if (!anchor.includes("left")) left -= boxW / 2;
-    if (anchor.includes("bottom")) top -= boxH;
-    else if (!anchor.includes("top")) top -= boxH / 2;
-    const rawColor = font.color;
-    const color = typeof rawColor === "string" ? rawColor : rawColor && typeof rawColor === "object" && typeof rawColor.$data === "string" ? data[rawColor.$data] : void 0;
-    boxes.push({
-      x: left / designW,
-      y: top / designH,
-      w: boxW / designW,
-      h: boxH / designH,
-      color: color && /^#[0-9a-f]{6}$/i.test(color) ? color : void 0,
-      role: x.role,
-      label: value.length > 24 ? `${value.slice(0, 24)}\u2026` : value
-    });
-  }
-  for (const id of layout.hide ?? []) {
-    const el = byId.get(id);
-    if (el && !t.text.some((x) => x.element === id)) el.opacity = 0;
+
+// src/plugin/posterDoc.ts
+import { existsSync as existsSync5 } from "fs";
+import { readFile as readFile5 } from "fs/promises";
+import { isAbsolute, join as join6, resolve as resolve3 } from "path";
+import {
+  computeCardLayout,
+  docRestTime,
+  migrateHostedDoc,
+  overlayRect,
+  resolveOverlayStyle
+} from "@vosjs/studio-core";
+
+// src/plugin/platform.ts
+import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join as join5 } from "path";
+function platformOrigin(flags = {}) {
+  const legacyEnv = process.env.VOS_API_BASE?.trim();
+  const raw = flags.origin ?? flags.api ?? process.env.VOS_ORIGIN?.trim() ?? legacyEnv ?? "https://vos.so";
+  if (!flags.origin && !flags.api && !process.env.VOS_ORIGIN && legacyEnv) {
+    process.stderr.write(
+      "note: VOS_API_BASE is deprecated \u2014 set VOS_ORIGIN (an origin, no /api suffix)\n"
+    );
   }
-  return { config: out, text: boxes, slots: slotRects, aspect, missing };
+  return raw.replace(/\/+$/, "").replace(/\/api$/, "");
 }
-function textLimitProblems(t, values) {
-  const out = [];
-  for (const x of t.text) {
-    const v = values[x.param];
-    if (typeof v !== "string") continue;
-    const words = v.trim().split(/\s+/).filter(Boolean).length;
-    const lines = v.split("\n").length;
-    if (x.maxWords && words > x.maxWords)
-      out.push(`${x.param}: ${words} words, the template holds ${x.maxWords}`);
-    if (x.lines && lines > x.lines)
-      out.push(`${x.param}: ${lines} lines, the template holds ${x.lines}`);
+function parseVosId(input) {
+  if (!/^https?:\/\//.test(input)) {
+    if (/^[A-Za-z0-9_-]+$/.test(input)) return input;
+    throw new UsageError(`"${input}" is not a vos id or URL`);
   }
-  return out;
-}
-
-// src/plugin/templates/cardOnGradient.ts
-var GROUND = `(ctx) => {
-  const THREE = ctx.THREE
-  const d = ctx.data
-  const canvas = document.createElement('canvas')
-  canvas.width = 1280
-  canvas.height = 720
-  const c = canvas.getContext('2d')
-  c.fillStyle = d.bgA
-  c.fillRect(0, 0, 1280, 720)
-  const blob = (x, y, r, color) => {
-    const g = c.createRadialGradient(x, y, 0, x, y, r)
-    g.addColorStop(0, color)
-    g.addColorStop(1, 'rgba(0,0,0,0)')
-    c.fillStyle = g
-    c.fillRect(0, 0, 1280, 720)
-  }
-  blob(180, 120, 760, d.blobA)
-  blob(1120, 620, 820, d.blobB)
-  blob(760, 60, 620, d.blobC)
-  let seed = 7
-  const rand = () => { seed = (seed * 1664525 + 1013904223) >>> 0; return seed / 4294967296 }
-  const img = c.getImageData(0, 0, 1280, 720)
-  const px = img.data
-  const grain = d.grain
-  for (let i = 0; i < px.length; i += 4) {
-    const n = (rand() - 0.5) * grain
-    px[i] += n; px[i + 1] += n; px[i + 2] += n
-  }
-  c.putImageData(img, 0, 0)
-  const tex = new THREE.CanvasTexture(canvas)
-  tex.colorSpace = THREE.SRGBColorSpace
-  const plane = new THREE.Mesh(
-    new THREE.PlaneGeometry(2, 2),
-    new THREE.MeshBasicMaterial({ map: tex, depthTest: false }),
-  )
-  plane.renderOrder = -10
-  ctx.scene.add(plane)
-  return { refs: { plane }, dispose: () => { tex.dispose(); plane.geometry.dispose(); plane.material.dispose() } }
-}`;
-var TIMELINE = `(ctx, content, duration) => {
-  const { gsap, elements } = ctx
-  const tl = gsap.timeline({ paused: true })
-  const shot = elements.get('shot')
-  if (shot) tl.fromTo(shot.props, { opacity: 0, translateY: 30, scale: 0.97 }, { opacity: 1, translateY: 0, scale: 1, duration: 1.0, ease: 'power3.out' }, 0.2)
-  return tl
-}`;
-function cardOnGradient() {
-  return {
-    version: 2,
-    duration: 4,
-    camera: { preset: "fullscreen" },
-    template: {
-      family: "card-on-gradient",
-      slots: [{ id: "shot", kind: "image", required: true }],
-      params: { required: [], brand: ["bgA", "blobA", "blobB", "blobC", "grain"] },
-      text: [],
-      layouts: {
-        landscape: { slots: { shot: { x: 0.09, y: 0.12, w: 0.82 } } },
-        square: { slots: { shot: { x: 0.08, y: 0.27, w: 0.84 } } },
-        portrait: { slots: { shot: { x: 0.06, y: 0.3, w: 0.88 } } }
-      }
-    },
-    params: [
-      { key: "bgA", type: "color", label: "Ground", default: "#f3efe8" },
-      { key: "blobA", type: "color", label: "Blob A", default: "rgba(255,183,146,0.55)" },
-      { key: "blobB", type: "color", label: "Blob B", default: "rgba(170,196,255,0.5)" },
-      { key: "blobC", type: "color", label: "Blob C", default: "rgba(255,236,170,0.45)" },
-      { key: "grain", type: "number", label: "Grain", default: 14, min: 0, max: 40, step: 1 }
-    ],
-    data: {
-      bgA: "#f3efe8",
-      blobA: "rgba(255,183,146,0.55)",
-      blobB: "rgba(170,196,255,0.5)",
-      blobC: "rgba(255,236,170,0.45)",
-      grain: 14
-    },
-    elements: [
-      {
-        type: "image",
-        id: "shot",
-        src: "",
-        position: { x: "9%", y: "12%" },
-        anchor: "top-left",
-        size: { width: 1574, height: "auto", fit: "contain" },
-        zIndex: 60,
-        opacity: 0
-      }
-    ],
-    createContent: GROUND,
-    createTimeline: TIMELINE
-  };
-}
-
-// src/plugin/templates/splitCover.ts
-var GROUND2 = `(ctx) => {
-  const THREE = ctx.THREE
-  const d = ctx.data
-  const canvas = document.createElement('canvas')
-  canvas.width = 1280
-  canvas.height = 720
-  const c = canvas.getContext('2d')
-  const g = c.createLinearGradient(0, 0, 1280, 720)
-  g.addColorStop(0, d.bgA)
-  g.addColorStop(0.55, d.bgB)
-  g.addColorStop(1, d.bgC)
-  c.fillStyle = g
-  c.fillRect(0, 0, 1280, 720)
-  const rg = c.createRadialGradient(980, 120, 40, 980, 120, 820)
-  rg.addColorStop(0, d.streak)
-  rg.addColorStop(1, 'rgba(0,0,0,0)')
-  c.fillStyle = rg
-  c.fillRect(0, 0, 1280, 720)
-  let seed = 41
-  const rand = () => { seed = (seed * 1664525 + 1013904223) >>> 0; return seed / 4294967296 }
-  const img = c.getImageData(0, 0, 1280, 720)
-  const px = img.data
-  const grain = d.grain
-  for (let i = 0; i < px.length; i += 4) {
-    const n = (rand() - 0.5) * grain
-    px[i] += n; px[i + 1] += n; px[i + 2] += n
-  }
-  c.putImageData(img, 0, 0)
-  const tex = new THREE.CanvasTexture(canvas)
-  tex.colorSpace = THREE.SRGBColorSpace
-  const plane = new THREE.Mesh(
-    new THREE.PlaneGeometry(2, 2),
-    new THREE.MeshBasicMaterial({ map: tex, depthTest: false }),
-  )
-  plane.renderOrder = -10
-  ctx.scene.add(plane)
-  return { refs: { plane }, dispose: () => { tex.dispose(); plane.geometry.dispose(); plane.material.dispose() } }
-}`;
-var TIMELINE2 = `(ctx, content, duration) => {
-  const { gsap, elements } = ctx
-  const tl = gsap.timeline({ paused: true })
-  const kicker = elements.get('kicker')
-  const title = elements.get('title')
-  const brand = elements.get('brand')
-  const shot = elements.get('shot')
-  if (kicker) tl.fromTo(kicker.props, { opacity: 0, translateY: 14 }, { opacity: 1, translateY: 0, duration: 0.7, ease: 'power2.out' }, 0.25)
-  if (title) tl.fromTo(title.props, { opacity: 0, translateY: 26 }, { opacity: 1, translateY: 0, duration: 0.9, ease: 'power3.out' }, 0.45)
-  if (brand) tl.fromTo(brand.props, { opacity: 0 }, { opacity: 1, duration: 0.8, ease: 'power2.out' }, 0.9)
-  if (shot) tl.fromTo(shot.props, { opacity: 0, translateX: 70 }, { opacity: 1, translateX: 0, duration: 1.1, ease: 'power3.out' }, 0.55)
-  return tl
-}`;
-function splitCover() {
-  return {
-    version: 2,
-    duration: 6,
-    camera: { preset: "fullscreen" },
-    fonts: [
-      { family: "Fraunces", url: "https://assets.vos.so/fonts/fraunces/600.woff2", weight: 600 },
-      { family: "Lexend", url: "https://assets.vos.so/fonts/lexend/700.woff2", weight: 700 },
-      { family: "JetBrains Mono", url: "https://assets.vos.so/fonts/jetbrains-mono/400.woff2", weight: 400 }
-    ],
-    template: {
-      family: "split-cover",
-      slots: [{ id: "shot", kind: "image", required: true }],
-      params: {
-        required: ["headline", "brand"],
-        brand: ["bgA", "bgB", "bgC", "ink", "inkSoft", "accent", "streak", "fontDisplay", "fontBody", "grain"]
-      },
-      text: [
-        { element: "title", param: "headline", role: "headline", maxWords: 8, lines: 3 },
-        { element: "kicker", param: "kicker", role: "body" },
-        { element: "brand", param: "brand", role: "body" }
-      ],
-      layouts: {
-        landscape: {
-          slots: { shot: { x: 0.46, y: 0.28, w: 1.02 } },
-          text: { kicker: { x: "7%", y: "24%" }, title: { x: "7%", y: "44%" }, brand: { x: "7%", y: "86%" } },
-          size: { title: 84, kicker: 19, brand: 25 }
-        },
-        square: {
-          slots: { shot: { x: 0.1, y: 0.5, w: 1 } },
-          text: { kicker: { x: "8%", y: "12%" }, title: { x: "8%", y: "27%" }, brand: { x: "8%", y: "93%" } },
-          size: { title: 72, kicker: 18, brand: 23 }
-        },
-        portrait: {
-          slots: { shot: { x: 0.08, y: 0.44, w: 1.06 } },
-          text: { kicker: { x: "8%", y: "12%" }, title: { x: "8%", y: "26%" }, brand: { x: "8%", y: "94%" } },
-          size: { title: 64, kicker: 17, brand: 22 }
-        }
-      }
-    },
-    params: [
-      { key: "kicker", type: "text", label: "Kicker", default: "RELEASE" },
-      { key: "headline", type: "text", label: "Headline", default: "What shipped,\nin three lines" },
-      { key: "brand", type: "text", label: "Wordmark", default: "brand" },
-      { key: "bgA", type: "color", label: "Ground A", default: "#8a3d2a" },
-      { key: "bgB", type: "color", label: "Ground B", default: "#c0632f" },
-      { key: "bgC", type: "color", label: "Ground C", default: "#5c5a2e" },
-      { key: "ink", type: "color", label: "Ink", default: "#fff6ec" },
-      { key: "inkSoft", type: "color", label: "Ink, softened", default: "#e9d9c8" },
-      { key: "streak", type: "color", label: "Light streak", default: "rgba(255,220,170,0.18)" },
-      { key: "fontDisplay", type: "text", label: "Headline face", default: "Fraunces, serif" },
-      { key: "fontBody", type: "text", label: "Body face", default: "Lexend, sans-serif" },
-      { key: "grain", type: "number", label: "Grain", default: 22, min: 0, max: 40, step: 1 }
-    ],
-    data: {
-      kicker: "RELEASE",
-      headline: "What shipped,\nin three lines",
-      brand: "brand",
-      bgA: "#8a3d2a",
-      bgB: "#c0632f",
-      bgC: "#5c5a2e",
-      ink: "#fff6ec",
-      inkSoft: "#e9d9c8",
-      streak: "rgba(255,220,170,0.18)",
-      fontDisplay: "Fraunces, serif",
-      fontBody: "Lexend, sans-serif",
-      grain: 22
-    },
-    elements: [
-      {
-        type: "text",
-        id: "kicker",
-        content: { $data: "kicker" },
-        position: { x: "7%", y: "24%" },
-        anchor: "center-left",
-        font: { family: "JetBrains Mono, monospace", size: 19, weight: 400, color: { $data: "inkSoft" }, letterSpacing: 6, align: "left" },
-        opacity: 0
-      },
-      {
-        type: "text",
-        id: "title",
-        content: { $data: "headline" },
-        position: { x: "7%", y: "44%" },
-        anchor: "center-left",
-        font: { family: { $data: "fontDisplay" }, size: 84, weight: 600, color: { $data: "ink" }, lineHeight: 1.08, align: "left", letterSpacing: 0 },
-        opacity: 0
-      },
-      {
-        type: "text",
-        id: "brand",
-        content: { $data: "brand" },
-        position: { x: "7%", y: "86%" },
-        anchor: "center-left",
-        font: { family: { $data: "fontBody" }, size: 25, weight: 700, color: { $data: "ink" }, letterSpacing: 1, align: "left" },
-        opacity: 0
-      },
-      {
-        type: "image",
-        id: "shot",
-        src: "",
-        position: { x: "46%", y: "28%" },
-        anchor: "top-left",
-        size: { width: 1400, height: "auto", fit: "contain" },
-        zIndex: 60,
-        opacity: 0
-      }
-    ],
-    createContent: GROUND2,
-    createTimeline: TIMELINE2
-  };
+  let url;
+  try {
+    url = new URL(input);
+  } catch {
+    throw new UsageError(`"${input}" is not a valid URL`);
+  }
+  const query = url.searchParams.get("vos");
+  if (query) return query;
+  const path = url.pathname.match(/\/vos\/([A-Za-z0-9_-]+)/);
+  if (path) return path[1];
+  throw new UsageError(
+    `could not find a vos id in ${input} \u2014 expected /vos/{id} or ?vos={id}`
+  );
 }
-
-// src/plugin/templates/index.ts
-var TEMPLATES = {
-  "split-cover": splitCover,
-  "card-on-gradient": cardOnGradient
-};
-var TEMPLATE_NAMES = Object.keys(TEMPLATES);
-function templateByName(name) {
-  const make = TEMPLATES[name];
-  return make ? make() : null;
+function deriveSlug(title) {
+  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 50).replace(/-+$/, "") || "remix";
 }
-
-// src/plugin/posterValues.ts
-import {
-  findFontFamily as findFontFamily2,
-  fontFaceUrl,
-  fontStack,
-  nearestFontWeight
-} from "@vosjs/shared";
-var HEX = /^#([0-9a-f]{6})$/i;
-var rgb = (hex2) => {
-  const m = HEX.exec(hex2.trim());
-  if (!m) return null;
-  const n = parseInt(m[1], 16);
-  return [n >> 16 & 255, n >> 8 & 255, n & 255];
-};
-var toHex = (c) => "#" + c.map(
-  (v) => Math.max(0, Math.min(255, Math.round(v))).toString(16).padStart(2, "0")
-).join("");
-function mixHex(a, b, t) {
-  const pa = rgb(a);
-  const pb = rgb(b);
-  if (!pa || !pb) return a;
-  return toHex([
-    pa[0] + (pb[0] - pa[0]) * t,
-    pa[1] + (pb[1] - pa[1]) * t,
-    pa[2] + (pb[2] - pa[2]) * t
-  ]);
+var CREDENTIALS_PATH = join5(homedir(), ".config", "vos", "credentials");
+function resolveCredential(explicit) {
+  const flag = explicit?.trim();
+  if (flag) return flag;
+  const env = process.env.VOS_API_KEY?.trim();
+  if (env) return env;
+  try {
+    const first = readFileSync2(CREDENTIALS_PATH, "utf8").split("\n")[0].trim();
+    return first || null;
+  } catch {
+    return null;
+  }
 }
-function rgba(hex2, alpha) {
-  const c = rgb(hex2) ?? [255, 255, 255];
-  return `rgba(${c[0]},${c[1]},${c[2]},${alpha})`;
-}
-function isLightHex(hex2) {
-  const c = rgb(hex2);
-  if (!c) return true;
-  return (0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2]) / 255 >= 0.6;
-}
-function resolveFace(family, weights) {
-  if (!family) return null;
-  const first = family.split(",")[0].replace(/['"]/g, "").replace(/\s+variable$/i, "").trim();
-  const entry = findFontFamily2(first);
-  if (!entry) return null;
-  const fonts = [
-    ...new Set(weights.map((w) => nearestFontWeight(entry, w)))
-  ].map((w) => ({
-    family: entry.family,
-    url: fontFaceUrl(entry.slug, w),
-    weight: w
-  }));
-  return { stack: fontStack(entry), category: entry.category, fonts };
-}
-function posterValues(brand, words) {
-  const b = brand ?? {};
-  const bgA = b.bgA && HEX.test(b.bgA) ? b.bgA : null;
-  const bgB = b.bgB && HEX.test(b.bgB) ? b.bgB : bgA;
-  const bgC = b.bgC && HEX.test(b.bgC) ? b.bgC : bgB;
-  const ink = b.ink && HEX.test(b.ink) ? b.ink : null;
-  const accent = b.accent && HEX.test(b.accent) ? b.accent : null;
-  const wordmark = (words.brand ?? b.wordmark ?? b.name ?? "").trim();
-  const release = (words.release ?? "").trim();
-  const lightGround = bgA ? isLightHex(bgA) : false;
-  const values = {};
-  if (bgA) values.bgA = bgA;
-  if (bgB) values.bgB = bgB;
-  if (bgC) values.bgC = bgC;
-  if (ink) values.ink = ink;
-  if (accent) values.accent = accent;
-  if (ink && bgA) values.inkSoft = mixHex(ink, bgA, 0.28);
-  if (accent) values.streak = rgba(accent, lightGround ? 0.12 : 0.18);
-  if (bgA) values.grain = lightGround ? 10 : 22;
-  if (accent) values.blobA = rgba(accent, lightGround ? 0.28 : 0.4);
-  if (bgC) values.blobB = rgba(bgC, 0.75);
-  if (accent)
-    values.blobC = rgba(
-      mixHex(accent, "#ffffff", 0.55),
-      lightGround ? 0.35 : 0.25
+function requireCredential(explicit) {
+  const key = resolveCredential(explicit);
+  if (!key) {
+    throw new Error(
+      "no credential found \u2014 pass --key, set VOS_API_KEY, or run `vos login` (mint a content key at https://vos.so/app/api; a vos_rg_ remix grant works too)"
     );
-  if (wordmark) values.brand = wordmark;
-  const headline = (words.headline ?? "").trim();
-  if (headline) values.headline = headline;
-  const kicker = (words.kicker ?? "").trim();
-  values.kicker = kicker ? kicker : [wordmark, release].filter(Boolean).join("  ").toUpperCase();
-  const fonts = [];
-  const display = resolveFace(b.fontDisplay, [600, 700]);
-  if (display) {
-    values.fontDisplay = display.stack;
-    fonts.push(...display.fonts);
-  }
-  const body = resolveFace(b.fontBody, [700]);
-  if (body) {
-    values.fontBody = body.stack;
-    fonts.push(...body.fonts);
   }
-  return { values, fonts, lightGround };
+  return key;
 }
-
-// src/plugin/stages.ts
-var str = (v, fallback) => typeof v === "string" && v.trim() ? v.trim() : fallback;
-var firstFamily = (stack) => stack.split(",")[0].replace(/['"]/g, "").trim();
-function stageSplitCover(input) {
-  const R = input.size.w / Math.max(1, input.size.h);
-  const portrait = R < 0.87;
-  const square = !portrait && R <= 1.15;
-  const v = input.values;
-  const ground = `linear-gradient(135deg, ${str(v.bgA, "#8a3d2a")}, ${str(v.bgC, str(v.bgB, "#5c5a2e"))})`;
-  const ink = str(v.ink, "#fff6ec");
-  const inkSoft = str(v.inkSoft, ink);
-  const display = firstFamily(str(v.fontDisplay, "Lexend"));
-  const body = firstFamily(str(v.fontBody, "Lexend"));
-  const headline = str(v.headline, "");
-  const kicker = str(v.kicker, "");
-  const brand = str(v.brand, "");
-  const inset = portrait ? { left: 0.08, right: -0.08, top: 0.44, bottom: -0.1 } : square ? { left: 0.1, right: -0.1, top: 0.5, bottom: -0.12 } : { left: 0.44, right: -0.06, top: 0.3, bottom: -0.12 };
-  const shot = {
-    x: inset.left,
-    y: inset.top,
-    w: 1 - inset.left - inset.right,
-    h: 1 - inset.top - inset.bottom
-  };
-  const set = [
-    `frame.background=${JSON.stringify(ground)}`,
-    "frame.backgroundMedia=null",
-    "frame.fit=cover",
-    `frame.inset=${JSON.stringify(inset)}`,
-    'frame.focus={"cx":0,"cy":0}',
-    "frame.radius=16",
-    "frame.shadow=0.5",
-    "frame.shadowContact=0",
-    "frame.border=0",
-    "zoom=[]",
-    `tilt=[{"id":"stage","in":0,"out":${input.sourceSeconds.toFixed(3)},"rx":3,"ry":${portrait || square ? 0 : 10}}]`,
-    "cursor.visible=false",
-    "cursor.clickFx.style=none"
-  ];
-  const designW = 1080 * input.size.w / input.size.h;
-  const boxes = [];
-  const clips = [];
-  const column = portrait || square ? 0.84 : 0.36;
-  const left = portrait || square ? 0.08 : 0.07;
-  const size = portrait ? 60 : square ? 68 : 84;
-  const word = (id, text, preset, family, px, y, color, extra, role, x0 = left) => {
-    if (!text) return;
-    const lines = text.split("\n");
-    const longest = Math.max(...lines.map((l) => l.length));
-    const widest = Math.min(
-      column,
-      longest * px * (preset === "title" ? 0.5 : 0.62) / designW
-    );
-    const lh = preset === "title" ? 1.05 : 1.2;
-    const h = lines.length * px * lh / 1080;
-    clips.push({
-      id,
-      kind: "text",
-      text,
-      preset,
-      family,
-      size: px,
-      color,
-      align: "left",
-      maxWidth: column,
-      lineHeight: lh,
-      transform: { x: x0 + widest / 2, y, scale: 1, rotation: 0 },
-      // Words on the ground carry no footage shadow: a drop shadow under a
-      // headline on a plate is the old-web tell.
-      shadow: 0,
-      start: 0,
-      duration: +input.outputSeconds.toFixed(3),
-      enter: "none",
-      exit: "none",
-      ...extra
-    });
-    boxes.push({
-      x: x0,
-      y: y - h / 2,
-      w: widest,
-      h,
-      color,
-      role,
-      label: text.length > 24 ? `${text.slice(0, 24)}\u2026` : text
-    });
-  };
-  const markKey = str(v.logoKey, "");
-  const markAspect = typeof v.logoAspect === "number" && v.logoAspect > 0 ? v.logoAspect : 1;
-  const wideMark = !!markKey && markAspect > 2.2;
-  const lockup = (px, y) => {
-    if (!markKey) return left;
-    const hPx = wideMark ? px * 1.6 : px * 1.3;
-    const w = Math.min(column, hPx * markAspect / designW);
-    clips.push({
-      id: "stage-mark",
-      kind: "image",
-      key: markKey,
-      width: +w.toFixed(4),
-      radius: 0,
-      shadow: "none",
-      transform: { x: left + w / 2, y, scale: 1, rotation: 0 },
-      start: 0,
-      duration: +input.outputSeconds.toFixed(3),
-      enter: "none",
-      exit: "none"
-    });
-    return left + w + px * 0.5 / designW;
-  };
-  const kickerY = portrait ? 0.1 : square ? 0.12 : 0.24;
-  const titleY = portrait ? 0.24 : square ? 0.28 : 0.46;
-  const brandY = portrait ? 0.94 : square ? 0.94 : 0.86;
-  word(
-    "stage-kicker",
-    kicker,
-    "label",
-    "JetBrains Mono",
-    19,
-    kickerY,
-    inkSoft,
-    { letterSpacing: 6, weight: 400 },
-    "body"
-  );
-  word(
-    "stage-title",
-    headline,
-    "title",
-    display,
-    size,
-    titleY,
-    ink,
-    { weight: 600, letterSpacing: -Math.round(size * 0.02) },
-    "headline"
-  );
-  const brandX = lockup(25, brandY);
-  if (!wideMark)
-    word(
-      "stage-brand",
-      brand,
-      "label",
-      body,
-      25,
-      brandY,
-      ink,
-      { weight: 700, letterSpacing: 1 },
-      "body",
-      brandX
-    );
-  set.push(`overlays=${JSON.stringify(clips)}`);
-  return { set, text: boxes, shot };
+function writeCredential(key) {
+  mkdirSync(join5(homedir(), ".config", "vos"), { recursive: true, mode: 448 });
+  writeFileSync(CREDENTIALS_PATH, `${key.trim()}
+`, { mode: 384 });
+  return CREDENTIALS_PATH;
 }
-var TILE_MAX_PX = 700;
-function isTileSize(size) {
-  return Math.max(size.w, size.h) < TILE_MAX_PX;
-}
-function stageTile(input) {
-  const R = input.size.w / Math.max(1, input.size.h);
-  const square = R <= 1.15;
-  const v = input.values;
-  const ground = `linear-gradient(135deg, ${str(v.bgA, "#8a3d2a")}, ${str(v.bgC, str(v.bgB, "#5c5a2e"))})`;
-  const ink = str(v.ink, "#fff6ec");
-  const display = firstFamily(str(v.fontDisplay, "Lexend"));
-  const headline = str(v.headline, "") || str(v.brand, "Release");
-  const wordless = input.text === "none";
-  const aspect = input.footageAspect && input.footageAspect > 0 ? input.footageAspect : 16 / 9;
-  const left = square ? 0.08 : 0.07;
-  const top = wordless ? square ? 0.1 : 0.12 : square ? 0.42 : 0.47;
-  const visible = wordless ? square ? 0.66 : 0.8 : square ? 0.56 : 0.62;
-  const cardW = (1 - left) / visible;
-  const cardH = cardW * R / aspect;
-  const inset = {
-    left,
-    right: +(1 - left - cardW).toFixed(4),
-    top,
-    bottom: +(1 - top - cardH).toFixed(4)
-  };
-  const shot = {
-    x: inset.left,
-    y: inset.top,
-    w: 1 - inset.left - inset.right,
-    h: 1 - inset.top - inset.bottom
-  };
-  const set = [
-    `frame.background=${JSON.stringify(ground)}`,
-    "frame.backgroundMedia=null",
-    "frame.fit=cover",
-    `frame.inset=${JSON.stringify(inset)}`,
-    'frame.focus={"cx":0,"cy":0}',
-    "frame.radius=24",
-    "frame.shadow=0.5",
-    "frame.shadowContact=0",
-    "frame.border=0",
-    "zoom=[]",
-    "tilt=[]",
-    "cursor.visible=false",
-    "cursor.clickFx.style=none"
-  ];
-  const designW = 1080 * input.size.w / input.size.h;
-  const column = square ? 0.84 : 0.86;
-  const px = square ? 96 : 108;
-  const lines = headline.split("\n");
-  const longest = Math.max(...lines.map((l) => l.length));
-  const widest = Math.min(column, longest * px * 0.5 / designW);
-  const lh = 1.05;
-  const h = lines.length * px * lh / 1080;
-  const y = square ? 0.2 : 0.24;
-  const clip = {
-    id: "stage-title",
-    kind: "text",
-    text: headline,
-    preset: "title",
-    family: display,
-    size: px,
-    color: ink,
-    align: "left",
-    maxWidth: column,
-    lineHeight: lh,
-    weight: 600,
-    letterSpacing: -Math.round(px * 0.02),
-    transform: { x: left + widest / 2, y, scale: 1, rotation: 0 },
-    shadow: 0,
-    start: 0,
-    duration: +input.outputSeconds.toFixed(3),
-    enter: "none",
-    exit: "none"
+function clientId() {
+  const env = process.env.VOS_CLIENT?.trim();
+  if (env && env.length <= 60 && !/[\r\n]/.test(env)) return env;
+  return "vos-cli";
+}
+async function apiJson(origin, path, init = {}) {
+  const headers = {
+    accept: "application/json",
+    ...init.headers
   };
-  if (wordless) {
-    const markKey = str(v.logoKey, "");
-    const markAspect = typeof v.logoAspect === "number" && v.logoAspect > 0 ? v.logoAspect : 1;
-    if (markKey) {
-      const hFrac = top * 0.5;
-      const w = Math.min(
-        0.8,
-        hFrac * input.size.h * markAspect / input.size.w
-      );
-      set.push(
-        `overlays=${JSON.stringify([
-          {
-            id: "stage-mark",
-            kind: "image",
-            key: markKey,
-            width: +w.toFixed(4),
-            radius: 0,
-            shadow: "none",
-            transform: { x: left + w / 2, y: top / 2, scale: 1, rotation: 0 },
-            start: 0,
-            duration: +input.outputSeconds.toFixed(3),
-            enter: "none",
-            exit: "none"
-          }
-        ])}`
-      );
-    } else set.push("overlays=[]");
-    return { set, text: [], shot };
+  if (init.key) headers.authorization = `Bearer ${init.key}`;
+  if (init.body !== void 0) headers["content-type"] = "application/json";
+  const reqBody = init.raw !== void 0 ? init.raw : init.body === void 0 ? void 0 : JSON.stringify(init.body);
+  const res = await fetch(`${origin}${path}`, {
+    method: init.method ?? "GET",
+    headers,
+    body: reqBody
+  });
+  let body = {};
+  try {
+    body = await res.json();
+  } catch {
   }
-  set.push(`overlays=${JSON.stringify([clip])}`);
-  const text = [
-    {
-      x: left,
-      y: y - h / 2,
-      w: widest,
-      h,
-      color: ink,
-      role: "headline",
-      label: headline.length > 24 ? `${headline.slice(0, 24)}\u2026` : headline
-    }
-  ];
-  return { set, text, shot };
+  return { status: res.status, body };
 }
-
-// src/plugin/markAsset.ts
-import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile6 } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
-import { isAbsolute, join as join5, resolve as resolve3 } from "path";
-function markExtension(url) {
-  const m = /\.(svg|png|webp|jpe?g)(?:[?#]|$)/i.exec(url);
-  if (!m) return null;
-  const e = m[1].toLowerCase();
-  return e === "jpeg" ? "jpg" : e;
+function apiError(what, r) {
+  const detail = typeof r.body.error === "string" ? r.body.error : r.body.details !== void 0 ? JSON.stringify(r.body.details) : "";
+  const hint = r.status === 401 ? " (run `vos login`, or set VOS_API_KEY \u2014 mint a key at https://vos.so/app/api)" : "";
+  return `${what} \u2192 ${r.status}${detail ? `: ${detail}` : ""}${hint}`;
 }
-function imageAspect(bytes, ext) {
-  if (ext === "svg") {
-    const head = new TextDecoder().decode(bytes.subarray(0, 4096));
-    const vb = /viewBox\s*=\s*["']\s*[-\d.]+[\s,]+[-\d.]+[\s,]+([\d.]+)[\s,]+([\d.]+)/i.exec(
-      head
-    );
-    if (vb) return ratio(+vb[1], +vb[2]);
-    const w = /<svg[^>]*\swidth\s*=\s*["']([\d.]+)/i.exec(head);
-    const h = /<svg[^>]*\sheight\s*=\s*["']([\d.]+)/i.exec(head);
-    if (w && h) return ratio(+w[1], +h[1]);
+var SYNC_STATE_NAME = "vos.json";
+function readJsonFile(file) {
+  try {
+    return JSON.parse(readFileSync2(file, "utf8"));
+  } catch {
     return null;
   }
-  const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-  if (ext === "png") {
-    if (bytes.length < 24 || bytes[0] !== 137 || bytes[1] !== 80) return null;
-    return ratio(dv.getUint32(16), dv.getUint32(20));
+}
+function readSyncState(dir) {
+  const own = readJsonFile(join5(dir, SYNC_STATE_NAME));
+  if (own && typeof own.vosId === "string") {
+    return {
+      vosId: own.vosId,
+      versionId: typeof own.versionId === "string" ? own.versionId : null,
+      ...typeof own.pushedAt === "string" ? { pushedAt: own.pushedAt } : {},
+      ...typeof own.title === "string" ? { title: own.title } : {},
+      ...typeof own.slug === "string" ? { slug: own.slug } : {},
+      ...typeof own.remixOfId === "string" ? { remixOfId: own.remixOfId } : {}
+    };
   }
-  if (ext === "webp") {
-    if (bytes.length < 30) return null;
-    const tag = String.fromCharCode(...bytes.subarray(12, 16));
-    if (tag === "VP8X")
-      return ratio(
-        1 + (dv.getUint32(24, true) & 16777215),
-        1 + (dv.getUint32(27, true) & 16777215)
-      );
-    if (tag === "VP8L") {
-      const b = dv.getUint32(21, true);
-      return ratio(1 + (b & 16383), 1 + (b >> 14 & 16383));
-    }
-    if (tag === "VP8 ")
-      return ratio(
-        dv.getUint16(26, true) & 16383,
-        dv.getUint16(28, true) & 16383
-      );
-    return null;
+  const push = readJsonFile(join5(dir, "push.json"));
+  if (push && typeof push.vosId === "string") {
+    return {
+      vosId: push.vosId,
+      versionId: typeof push.versionId === "string" ? push.versionId : null,
+      ...typeof push.pushedAt === "string" ? { pushedAt: push.pushedAt } : {}
+    };
   }
-  if (ext === "jpg") {
-    let i = 2;
-    while (i + 9 < bytes.length) {
-      if (bytes[i] !== 255) return null;
-      const marker = bytes[i + 1];
-      const len = dv.getUint16(i + 2);
-      if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
-        return ratio(dv.getUint16(i + 7), dv.getUint16(i + 5));
-      }
-      i += 2 + len;
-    }
-    return null;
+  const meta = readJsonFile(join5(dir, "meta.json"));
+  if (meta && typeof meta.id === "string") {
+    return {
+      vosId: meta.id,
+      versionId: typeof meta.currentVersionId === "string" ? meta.currentVersionId : null,
+      ...typeof meta.title === "string" ? { title: meta.title } : {},
+      ...typeof meta.slug === "string" ? { slug: meta.slug } : {},
+      ...typeof meta.remixOfId === "string" ? { remixOfId: meta.remixOfId } : {}
+    };
   }
   return null;
 }
-function ratio(w, h) {
-  return w > 0 && h > 0 ? w / h : null;
-}
-async function fetchBrandMarks(takeDir, roles) {
-  const out = { light: null, dark: null, notes: [] };
-  if (!roles) return out;
-  const one = async (role, name) => {
-    const src = (roles[role] ?? "").trim();
-    if (!src) return null;
-    const ext = markExtension(src);
-    if (!ext) {
-      out.notes.push(
-        `${role}: ${src} is not an svg, png, webp or jpg; the wordmark stands in`
-      );
-      return null;
-    }
-    let bytes;
-    try {
-      if (/^https?:/i.test(src)) {
-        const res = await fetch(src);
-        if (!res.ok) throw new Error(`HTTP ${res.status}`);
-        bytes = new Uint8Array(await res.arrayBuffer());
-      } else {
-        const file = isAbsolute(src) ? src : resolve3(takeDir, src);
-        if (!existsSync5(file)) throw new Error("no such file");
-        bytes = new Uint8Array(await readFile5(file));
-      }
-    } catch (e) {
-      out.notes.push(
-        `${role}: ${src} could not be read (${e instanceof Error ? e.message : String(e)}); the wordmark stands in`
-      );
-      return null;
-    }
-    const aspect = imageAspect(bytes, ext);
-    if (!aspect) {
-      out.notes.push(
-        `${role}: ${src} has no readable size; the wordmark stands in`
-      );
-      return null;
-    }
-    await mkdir4(join5(takeDir, "brand"), { recursive: true });
-    await writeFile6(join5(takeDir, "brand", `${name}.${ext}`), bytes);
-    return { key: `/brand/${name}.${ext}`, aspect };
+function writeSyncState(dir, patch) {
+  const merged = {
+    ...readSyncState(dir) ?? { versionId: null },
+    ...patch
   };
-  out.light = await one("logoUrl", "mark");
-  out.dark = await one("logoOnDarkUrl", "mark-on-dark");
-  return out;
-}
-
-// src/plugin/motionPlan.ts
-import { ratedSegments as ratedSegments4, spanOutputExtent as spanOutputExtent4 } from "@vosjs/studio-core";
-var SOUND_DESTINATIONS = /* @__PURE__ */ new Set([
-  "x-feed-cut",
-  "youtube-main-demo",
-  "shorts-linkedin-vertical-cut"
-]);
-var LOOP_DESTINATIONS = /* @__PURE__ */ new Set(["github-readme-loop"]);
-var off = (v) => v !== void 0 && /^(none|off|false|no)$/i.test(v.trim());
-function pickTrack(catalog, ask) {
-  if (!catalog || !ask || off(ask)) return null;
-  const want = ask.trim().toLowerCase();
-  return catalog.tracks.find((t) => t.slug.toLowerCase() === want) ?? catalog.tracks.find((t) => (t.mood ?? "").toLowerCase() === want) ?? null;
-}
-function clickTimes(doc, range) {
-  const rated = ratedSegments4(doc);
-  const out = [];
-  for (const e of doc.source.cursor) {
-    if (e.type !== "down") continue;
-    const src = e.t / 1e3;
-    const ext = spanOutputExtent4(rated, src, src + 1e-3);
-    if (!ext) continue;
-    const t = ext.start;
-    if (t < range[0] || t > range[1]) continue;
-    if (out.length && t - out[out.length - 1] < 0.12) continue;
-    out.push(+(t - range[0]).toFixed(3));
-  }
-  return out;
+  writeFileSync(
+    join5(dir, SYNC_STATE_NAME),
+    `${JSON.stringify(merged, null, 2)}
+`
+  );
+  return merged;
 }
-function planMotion(input) {
-  const { destination: d, doc, range, words, launch, catalog } = input;
-  const set = [];
-  const notes = [];
-  const skipped = [];
-  if (d.kind !== "video") return { set, notes, skipped };
-  const loop = LOOP_DESTINATIONS.has(d.id);
-  const sound = SOUND_DESTINATIONS.has(d.id);
-  const length = range[1] - range[0];
-  const portrait = d.px.w / d.px.h < 0.9;
-  const entrance = launch.entrance;
-  if (!loop && !off(entrance)) {
-    const kind = entrance && /^(tilt-in|pull-out|rise)$/.test(entrance.trim()) ? entrance.trim() : "tilt-in";
-    set.push(`frame.entrance={"kind":"${kind}"}`);
-    notes.push(`entrance ${kind}`);
-  }
-  if (!loop && !off(launch.endCard)) {
-    const headline = (words.headline ?? "").trim();
-    const brand = (words.brand ?? "").trim();
-    const sub = [brand, (words.release ?? "").trim()].filter(Boolean).join(" ");
-    if (headline || brand) {
-      const card = { seconds: 2.5 };
-      if (input.ink) card.ink = input.ink;
-      if (headline) card.headline = headline;
-      if (sub && sub !== headline) card.sub = sub;
-      if (brand) card.wordmark = brand;
-      if (input.mark) card.mark = input.mark;
-      set.push(`endCard=${JSON.stringify(card)}`);
-      notes.push("end card");
-    } else {
-      skipped.push(
-        `${d.id}: no end card (no headline or wordmark in LAUNCH.md, BRAND.md or the flags)`
-      );
-    }
+function formatChanges(changes) {
+  const lines = [];
+  for (const ch of changes) {
+    const label = ch.label ? ` \xB7 ${ch.label}` : "";
+    const who = ch.origin === "studio" ? "human" : ch.origin ?? "unknown";
+    lines.push(
+      `v${String(ch.versionNumber ?? "?")} (${who}${label}): ${ch.summary ?? ""}`
+    );
+    if (ch.note) lines.push(`    note: ${ch.note}`);
   }
-  if (!loop && d.text !== "none" && input.captions.length && !off(launch.captions)) {
-    const rated = ratedSegments4(doc);
-    const steps = doc.source.meta.steps ?? [];
-    const clips = [];
-    for (const c of input.captions) {
-      const step = steps.find(
-        (s) => c.id !== void 0 && s.id === c.id || s.step === c.step
-      );
-      if (!step || step.skipped) continue;
-      const t = stepOutputTime(rated, step, 0.2);
-      if (t === null || t < range[0] || t > range[1] - 1) continue;
-      const start = +(t - range[0]).toFixed(3);
-      clips.push({
-        id: `caption-${c.step}`,
-        kind: "text",
-        text: c.caption,
-        preset: "caption",
-        start,
-        duration: Math.min(3.5, Math.max(2.5, range[1] - t - 0.2)),
-        transform: { x: 0.5, y: portrait ? 0.8 : 0.86, scale: 1, rotation: 0 },
-        enter: "rise",
-        exit: "fade",
-        align: "center",
-        box: { color: "rgba(17,17,17,0.72)" }
-      });
-    }
-    if (clips.length) {
-      const existing = Array.isArray(doc.overlays) ? doc.overlays : [];
-      set.push(`overlays=${JSON.stringify([...existing, ...clips])}`);
-      notes.push(`${clips.length} caption(s)`);
-    }
+  return lines;
+}
+
+// src/plugin/posterDoc.ts
+var POSTER_CLASSES = [
+  "landscape",
+  "square",
+  "portrait",
+  "tile"
+];
+var TILE_MAX_PX = 700;
+function posterClassFor(px) {
+  if (Math.max(px.w, px.h) < TILE_MAX_PX) return "tile";
+  const r = px.w / Math.max(1, px.h);
+  if (r < 0.87) return "portrait";
+  if (r <= 1.15) return "square";
+  return "landscape";
+}
+var ROLE_ALL = "poster";
+var roleFor = (cls) => `poster-${cls}`;
+async function readPosterAt(cls, path, takeDir, from) {
+  let file = path;
+  let docDir = path;
+  if (existsSync5(join6(path, "doc.json"))) {
+    file = join6(path, "doc.json");
+  } else if (!/\.json$/i.test(path) || !existsSync5(path)) {
+    return null;
+  } else {
+    docDir = resolve3(path, "..");
   }
-  if (sound && !loop) {
-    const track = pickTrack(catalog, launch.music);
-    const clips = Array.isArray(doc.audio) ? [...doc.audio] : [];
-    if (track) {
-      const hasMic = !!doc.source.micKey;
-      const fadeOut = Math.min(2.5, length * 0.15);
-      clips.push({
-        id: "bed",
-        key: track.url,
-        name: track.title,
-        start: 0,
-        in: 0,
-        out: Math.min(track.duration, length),
-        duration: track.duration,
-        gain: hasMic ? 0.35 : 0.5,
-        fadeIn: 0.6,
-        fadeOut,
-        loop: track.duration < length,
-        loopLen: track.duration < length ? length : void 0,
-        duck: hasMic
-      });
-      notes.push(`bed ${track.slug}`);
-    } else if (launch.music && !off(launch.music)) {
-      skipped.push(
-        `${d.id}: music "${launch.music}" is not a catalog track or mood${catalog ? "" : " (the catalog could not be read)"}`
-      );
-    }
-    const click = catalog?.sfx.find((s) => s.slug === "sfx-click");
-    if (click && !doc.source.micKey && !off(launch.clicks)) {
-      const times = clickTimes(doc, range);
-      for (const [i, t] of times.entries()) {
-        clips.push({
-          id: `click-${i}`,
-          key: click.url,
-          name: click.title,
-          start: t,
-          in: 0,
-          out: click.duration,
-          duration: click.duration,
-          gain: 0.4,
-          fadeIn: 0,
-          fadeOut: 0
-        });
+  let raw;
+  try {
+    raw = JSON.parse(await readFile5(file, "utf8"));
+  } catch {
+    return null;
+  }
+  if (!raw || typeof raw !== "object") return null;
+  const source = raw.source;
+  if (!source || typeof source.videoKey !== "string") return null;
+  const doc = migrateHostedDoc(
+    raw
+  );
+  const ownFootage = existsSync5(join6(docDir, "meta.json")) && existsSync5(join6(docDir, source.videoKey));
+  const sync = readSyncState(docDir);
+  return {
+    cls,
+    file,
+    takeDir: ownFootage ? docDir : takeDir,
+    ownFootage,
+    doc,
+    ...sync?.vosId ? { vosId: sync.vosId } : {},
+    from
+  };
+}
+async function findPosterDocs(takeDir, launchRoles) {
+  const out = {};
+  const at2 = (p) => isAbsolute(p) ? p : resolve3(takeDir, p);
+  for (const cls of POSTER_CLASSES) {
+    const named = launchRoles?.[roleFor(cls)] ?? launchRoles?.[ROLE_ALL];
+    const candidates = [];
+    if (named && !/^(none|off|no|false)$/i.test(named.trim())) {
+      const role = launchRoles?.[roleFor(cls)] ? roleFor(cls) : ROLE_ALL;
+      candidates.push({ path: at2(named.trim()), from: `LAUNCH.md ${role}` });
+    }
+    candidates.push({
+      path: join6(takeDir, "poster", cls),
+      from: `poster/${cls}`
+    });
+    candidates.push({ path: join6(takeDir, "poster"), from: "poster" });
+    for (const c of candidates) {
+      const ref = await readPosterAt(cls, c.path, takeDir, c.from);
+      if (ref) {
+        out[cls] = ref;
+        break;
       }
-      if (times.length) notes.push(`${times.length} click sound(s)`);
     }
-    if (clips.length) set.push(`audio=${JSON.stringify(clips)}`);
   }
-  if (portrait) {
-    set.push("frame.fit=cover");
-    set.push('frame.inset={"left":0.06,"right":0.06,"top":0.17,"bottom":0.17}');
-    set.push("frame.focusFollow=camera");
-    notes.push("vertical reframe follows the camera");
+  return out;
+}
+function posterStillTime(doc, duration) {
+  const rest = docRestTime(doc);
+  if (rest != null) return rest;
+  return Math.max(0, duration - 1 / 30);
+}
+var DESIGN_H = 1080;
+function designFrame(px) {
+  return {
+    W: Math.max(2, Math.round(DESIGN_H * px.w / Math.max(1, px.h))),
+    H: DESIGN_H
+  };
+}
+function posterShotRect(doc, px) {
+  const { W, H } = designFrame(px);
+  const meta = doc.source.meta;
+  const layout = computeCardLayout(
+    doc.frame,
+    {
+      width: meta.captureWidth ?? meta.width,
+      height: meta.captureHeight ?? meta.height
+    },
+    W,
+    H
+  );
+  const r3 = (v) => Math.round(v * 1e3) / 1e3;
+  return {
+    x: r3(layout.cardX / W),
+    y: r3(layout.cardY / H),
+    w: r3(layout.cardW / W),
+    h: r3(layout.cardH / H)
+  };
+}
+function estimateWidth(text, font, letterSpacingPx = 0) {
+  const m = /(\d+(?:\.\d+)?)px/.exec(font);
+  const px = m ? Number(m[1]) : 32;
+  return text.length * (px * 0.55 + letterSpacingPx);
+}
+function posterTextBoxes(doc, px, time) {
+  const { W, H } = designFrame(px);
+  const out = [];
+  for (const clip of doc.overlays ?? []) {
+    if (clip.kind !== "text") continue;
+    if (time < clip.start || time > clip.start + clip.duration) continue;
+    const rect = overlayRect(clip, estimateWidth, W, H);
+    const style = resolveOverlayStyle(clip);
+    const r3 = (v) => Math.round(v * 1e3) / 1e3;
+    out.push({
+      x: r3((rect.cx - rect.w / 2) / W),
+      y: r3((rect.cy - rect.h / 2) / H),
+      w: r3(rect.w / W),
+      h: r3(rect.h / H),
+      role: clip.preset === "title" ? "headline" : "body",
+      label: clip.text.split("\n")[0].slice(0, 40),
+      .../^#[0-9a-f]{6}$/i.test(style.color) ? { color: style.color } : {}
+    });
   }
-  return { set, notes, skipped };
+  return out;
 }
 
 // src/plugin/deliver.ts
@@ -4622,7 +3926,7 @@ function resolveChannels(raw) {
   return out;
 }
 async function readBrandBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join6(dir, "BRAND.md"), join6(dir, "..", "BRAND.md")];
+  const candidates = explicit ? [explicit] : [join7(dir, "BRAND.md"), join7(dir, "..", "BRAND.md")];
   for (const file of candidates) {
     if (!existsSync6(file)) continue;
     const roles = parseFrontmatter(await readFile6(file, "utf8"));
@@ -4631,7 +3935,7 @@ async function readBrandBesideTake(dir, explicit) {
   return null;
 }
 async function readLaunchBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join6(dir, "LAUNCH.md"), join6(dir, "..", "LAUNCH.md")];
+  const candidates = explicit ? [explicit] : [join7(dir, "LAUNCH.md"), join7(dir, "..", "LAUNCH.md")];
   for (const file of candidates) {
     if (!existsSync6(file)) continue;
     return { file, roles: parseFrontmatter(await readFile6(file, "utf8")) };
@@ -4659,28 +3963,6 @@ async function resolveLook(dir, opts) {
     roles
   };
 }
-function templateForCard(d, opts) {
-  if (opts.poster === null) return null;
-  if (opts.poster) return { config: opts.poster.config, from: opts.poster.from };
-  if (!d.template) return null;
-  if (isTileSize(d.px)) {
-    const config2 = templateByName(d.template) ?? templateByName("card-on-gradient");
-    if (config2) return { config: config2, from: "stage tile", stage: "tile" };
-  }
-  let name = d.template;
-  let note;
-  const wants = templateOf(templateByName(name) ?? {});
-  const needsHeadline = wants?.text.some((t) => t.role === "headline");
-  if (needsHeadline && !opts.words?.headline?.trim()) {
-    name = "card-on-gradient";
-    note = `${d.id}: no headline (LAUNCH.md headline: or --headline), so the ${d.template} template stands down for card-on-gradient`;
-  }
-  const config = templateByName(name);
-  if (!config) return null;
-  if (name === "split-cover")
-    return { config, from: "stage split-cover", note, stage: "split-cover" };
-  return { config, from: `template ${name}`, note };
-}
 function lookOverrides(look, placement, size, video, opts) {
   const inset = cardInset(look, size, video, placement);
   const set = [
@@ -4708,23 +3990,6 @@ function lookOverrides(look, placement, size, video, opts) {
   }
   return set;
 }
-function endCardInk(look, brand) {
-  if (!look) return null;
-  const ground = look.ground;
-  const m = /#([0-9a-f]{6})/i.exec(ground);
-  const hex2 = m ? m[0] : null;
-  const light = look.kind === "plate" || (hex2 ? isLightHexGround(hex2) : look.kind === "gradient");
-  if (!light) return "#ffffff";
-  const ink = brand?.ink;
-  return ink && /^#[0-9a-f]{6}$/i.test(ink) ? ink : "#111111";
-}
-function isLightHexGround(hex2) {
-  const n = parseInt(hex2.slice(1), 16);
-  const r = n >> 16 & 255;
-  const g = n >> 8 & 255;
-  const b = n & 255;
-  return (0.2126 * r + 0.7152 * g + 0.0722 * b) / 255 >= 0.6;
-}
 var PROBE_WIDTH = 640;
 async function pickStillTimes(browser, dir, doc, duration, opts) {
   const { candidates, dropped } = momentCandidates(doc, duration);
@@ -4737,7 +4002,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
   const meta = doc.source.meta;
   const vw = meta.captureWidth ?? meta.width;
   const vh = meta.captureHeight ?? meta.height;
-  const probeDir = await mkdtemp(join6(tmpdir(), "vos-moments-"));
+  const probeDir = await mkdtemp(join7(tmpdir(), "vos-moments-"));
   try {
     const probe = await framesTake(browser, dir, {
       times: candidates.map((c) => c.time),
@@ -4822,16 +4087,10 @@ async function deliverTake(browser, dir, opts) {
   const take = await loadTake(dir);
   if (!take.doc) throw new Error(`${dir} has no doc.json \u2014 run plan first`);
   const doc = take.doc;
-  const marks = await fetchBrandMarks(dir, opts.brandRoles);
-  for (const n of marks.notes) opts.onPhase?.(`note: ${n}`);
-  const darkGround = opts.look?.kind === "dark";
-  const mark = darkGround ? marks.dark : marks.light;
-  if (mark)
-    opts.onPhase?.(`brand mark: ${mark.key} (${mark.aspect.toFixed(2)}:1)`);
   const duration = totalDuration(ratedSegments5(doc));
   const videoSeconds = opts.range ? Math.min(opts.range[1], duration) - Math.min(opts.range[0], duration) : duration;
-  const outDir = resolve4(opts.outDir ?? join6(dir, "kit"));
-  await mkdir5(outDir, { recursive: true });
+  const outDir = resolve4(opts.outDir ?? join7(dir, "kit"));
+  await mkdir4(outDir, { recursive: true });
   const destinations = opts.channels.flatMap((c) => destinationsForChannel(c));
   const assets = [];
   const skipped = [];
@@ -4855,7 +4114,7 @@ async function deliverTake(browser, dir, opts) {
     w: meta0.captureWidth ?? meta0.width,
     h: meta0.captureHeight ?? meta0.height
   };
-  const videoOverrides = (d, range) => {
+  const videoOverrides = (d) => {
     const set = [];
     if (opts.look) {
       set.push(
@@ -4865,203 +4124,82 @@ async function deliverTake(browser, dir, opts) {
         })
       );
     }
-    const plan = planMotion({
-      destination: d,
-      doc,
-      range: range ?? [0, duration],
-      words: opts.words ?? {},
-      launch: opts.launchRoles ?? {},
-      captions: opts.captions ?? [],
-      catalog: opts.catalog ?? null,
-      ink: endCardInk(opts.look, opts.brandRoles),
-      mark
-    });
-    set.push(...plan.set);
-    if (plan.notes.length) opts.onPhase?.(`${d.id}: ${plan.notes.join(", ")}`);
-    for (const s of plan.skipped) skipped.push(`note: ${s}`);
+    const mech = destinationMechanics(d, doc);
+    set.push(...mech.set);
+    if (mech.notes.length) opts.onPhase?.(`${d.id}: ${mech.notes.join(", ")}`);
     set.push(...opts.overrides?.set ?? []);
-    if (!set.length) return opts.overrides;
-    return { ...opts.overrides, set };
+    if (!set.length && !mech.unset.length) return opts.overrides;
+    return { ...opts.overrides, set, unset: mech.unset };
   };
-  const cardPlans = destinations.filter(
-    (d) => d.kind !== "video" && d.genre === "card" && !NOT_FROM_FOOTAGE[d.id]
-  ).map((d) => ({ d, plan: templateForCard(d, opts) })).filter(
-    (p) => p.plan !== null
-  );
-  const posterCardIds = new Set(cardPlans.map((p) => p.d.id));
-  for (const p of cardPlans)
-    if (p.plan.note) skipped.push(`note: ${p.plan.note}`);
-  if (cardPlans.length) {
-    const meta = doc.source.meta;
-    const heroTime = opts.shotTime ?? (stillTimes.length ? stillTimes[0] : duration / 2);
-    const fill = posterValues(opts.brandRoles, opts.words ?? {});
-    if (mark) {
-      fill.values.logoKey = mark.key;
-      fill.values.logoAspect = mark.aspect;
+  const posters = await findPosterDocs(dir, opts.launchRoles);
+  const posterCardIds = /* @__PURE__ */ new Set();
+  const missing = /* @__PURE__ */ new Set();
+  for (const d of destinations) {
+    if (d.kind === "video" || d.genre !== "card" || NOT_FROM_FOOTAGE[d.id])
+      continue;
+    const cls = posterClassFor(d.px);
+    const ref = posters[cls];
+    if (!ref) {
+      missing.add(cls);
+      continue;
     }
+    posterCardIds.add(d.id);
+    const label = `${d.channel} ${d.asset}`;
+    const posterDuration = totalDuration(ratedSegments5(ref.doc));
+    const time = posterStillTime(ref.doc, posterDuration);
     opts.onPhase?.(
-      `poster shot (full bleed at ${heroTime.toFixed(2)}s), baked as an object`
+      `${label} (${specWords(d)}) from ${ref.from}${ref.vosId ? ` ${ref.vosId}` : ""}, the rest at ${time.toFixed(2)}s`
     );
-    const serveDir = await mkdtemp(join6(tmpdir(), "vos-poster-"));
+    const shotDir = await mkdtemp(join7(tmpdir(), "vos-poster-"));
     try {
-      const shot = await framesTake(browser, dir, {
-        times: [heroTime],
-        width: meta.captureWidth ?? meta.width,
-        height: meta.captureHeight ?? meta.height,
-        outDir: serveDir,
-        overrides: {
-          ...opts.overrides,
-          set: [
-            "frame.fit=contain",
-            "frame.padding=0",
-            "frame.radius=0",
-            "frame.shadow=0",
-            "frame.border=0",
-            "frame.browserBar.kind=none",
-            "cursor.visible=false",
-            "cursor.clickFx.style=none",
-            ...opts.overrides?.set ?? []
-          ]
-        }
-      });
-      const raw = decodePng(new Uint8Array(await readFile6(shot.frames[0].file)));
-      if (!raw) throw new Error("the poster shot could not be decoded");
-      const PAD = 0.06;
-      const baked = bakeShot(raw, {
-        margin: PAD,
-        hairline: fill.lightGround ? 0.14 : 0,
-        shadow: fill.lightGround ? 0.28 : 0.4
+      const captured = await framesTake(browser, ref.takeDir, {
+        times: [time],
+        width: d.px.w,
+        height: d.px.h,
+        outDir: shotDir,
+        doc: ref.doc,
+        overrides: opts.overrides
       });
-      await writeFile7(join6(serveDir, "shot.png"), encodePng(baked));
-      const shotAspect = raw.w / raw.h;
-      for (const { d, plan } of cardPlans) {
-        if (plan.stage) {
-          const stageInput = {
-            size: d.px,
-            values: fill.values,
-            sourceSeconds: meta.durationMs / 1e3,
-            outputSeconds: duration,
-            text: d.text,
-            footageAspect: (meta.captureWidth ?? meta.width) / (meta.captureHeight ?? meta.height)
-          };
-          const staged = plan.stage === "tile" ? stageTile(stageInput) : stageSplitCover(stageInput);
-          opts.onPhase?.(
-            `${d.channel} ${d.asset} (${specWords(d)}) from ${plan.from}`
-          );
-          const shotDir = await mkdtemp(join6(tmpdir(), "vos-stage-"));
-          try {
-            const captured = await framesTake(browser, dir, {
-              times: [heroTime],
-              width: d.px.w,
-              height: d.px.h,
-              outDir: shotDir,
-              overrides: {
-                ...opts.overrides,
-                set: [...staged.set, ...opts.overrides?.set ?? []]
-              }
-            });
-            const to2 = join6(outDir, `${d.id}.png`);
-            await rename4(captured.frames[0].file, to2);
-            const bytes2 = (await stat(to2)).size;
-            if (d.maxBytes !== void 0 && bytes2 > d.maxBytes) {
-              skipped.push(
-                `${d.channel} ${d.asset}: ${overCeiling(bytes2, d.maxBytes)} (kept at ${to2})`
-              );
-              continue;
-            }
-            assets.push({
-              channel: d.channel,
-              asset: d.asset,
-              destination: d.id,
-              path: relative(outDir, to2),
-              w: d.px.w,
-              h: d.px.h,
-              bytes: bytes2,
-              seconds: null,
-              frameTime: heroTime,
-              source: "stage",
-              template: `${plan.stage}-stage`,
-              text: staged.text,
-              shot: staged.shot,
-              ...plan.stage === "tile" ? { crop: true } : {}
-            });
-          } finally {
-            await rm3(shotDir, { recursive: true, force: true });
-          }
-          continue;
-        }
-        const problems = templateProblems(plan.config);
-        if (problems.length) {
-          skipped.push(
-            `${d.channel} ${d.asset}: ${plan.from} is not a valid template (${problems[0]}) \u2014 kept from the take`
-          );
-          posterCardIds.delete(d.id);
-          continue;
-        }
-        const filled = fillTemplate(plan.config, {
-          size: d.px,
-          slots: { shot: { src: "/shot.png", aspect: shotAspect, pad: PAD } },
-          values: fill.values
-        });
-        const limits = textLimitProblems(templateOf(plan.config), fill.values);
-        for (const l of limits) skipped.push(`note: ${d.id}: ${l}`);
-        if (filled.missing.length) {
-          skipped.push(
-            `${d.channel} ${d.asset}: ${plan.from} needs ${filled.missing.join(", ")} \u2014 kept from the take`
-          );
-          posterCardIds.delete(d.id);
-          continue;
-        }
-        const config = filled.config;
-        if (fill.fonts.length) {
-          const declared = Array.isArray(config.fonts) ? config.fonts : [];
-          config.fonts = [...declared, ...fill.fonts];
-        }
-        const posterDuration = typeof config.duration === "number" ? config.duration : 6;
-        const time = Math.min(
-          opts.posterTime ?? posterDuration * 0.9,
-          Math.max(0, posterDuration - 0.05)
-        );
-        opts.onPhase?.(
-          `${d.channel} ${d.asset} (${specWords(d)}) from ${plan.from}, ${filled.aspect}`
-        );
-        await renderPosterStills(
-          browser,
-          config,
-          serveDir,
-          [{ name: `${d.id}.png`, width: d.px.w, height: d.px.h }],
-          time
+      const to = join7(outDir, `${d.id}.png`);
+      await rename4(captured.frames[0].file, to);
+      const bytes = (await stat(to)).size;
+      if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
+        skipped.push(
+          `${label}: ${overCeiling(bytes, d.maxBytes)} (kept at ${to})`
         );
-        const from = join6(serveDir, `${d.id}.png`);
-        const to = join6(outDir, `${d.id}.png`);
-        await rename4(from, to);
-        const bytes = (await stat(to)).size;
-        if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
-          skipped.push(
-            `${d.channel} ${d.asset}: ${overCeiling(bytes, d.maxBytes)} (kept at ${to})`
-          );
-          continue;
-        }
-        assets.push({
-          channel: d.channel,
-          asset: d.asset,
-          destination: d.id,
-          path: relative(outDir, to),
-          w: d.px.w,
-          h: d.px.h,
-          bytes,
-          seconds: null,
-          frameTime: heroTime,
-          source: "poster",
-          template: templateOf(plan.config)?.family ?? plan.from,
-          text: filled.text,
-          shot: filled.slots.shot
-        });
+        continue;
       }
+      const shot = posterShotRect(ref.doc, d.px);
+      assets.push({
+        channel: d.channel,
+        asset: d.asset,
+        destination: d.id,
+        path: relative(outDir, to),
+        w: d.px.w,
+        h: d.px.h,
+        bytes,
+        seconds: null,
+        frameTime: time,
+        source: "poster",
+        poster: {
+          class: cls,
+          file: relative(dir, ref.file),
+          ...ref.vosId ? { vosId: ref.vosId } : {}
+        },
+        text: posterTextBoxes(ref.doc, d.px, time),
+        shot,
+        ...shot.x < 0 && shot.x + shot.w > 1 ? { crop: true } : {}
+      });
     } finally {
-      await rm3(serveDir, { recursive: true, force: true });
+      await rm3(shotDir, { recursive: true, force: true });
     }
   }
+  if (missing.size) {
+    const classes = [...missing].sort().join(", ");
+    skipped.push(
+      `note: no poster document for the ${classes} class${missing.size > 1 ? "es" : ""} beside the take (poster/<class>/doc.json, or LAUNCH.md poster:), so those cards are the take's own frame`
+    );
+  }
   for (const d of destinations) {
     const label = `${d.channel} ${d.asset}`;
     const excuse = NOT_FROM_FOOTAGE[d.id];
@@ -5094,7 +4232,7 @@ async function deliverTake(browser, dir, opts) {
         }
       }
       opts.onPhase?.(`${label} (${specWords(d)})`);
-      const outFile = join6(outDir, `${d.id}.${d.format}`);
+      const outFile = join7(outDir, `${d.id}.${d.format}`);
       const bitrate = d.maxBytes !== void 0 ? Math.min(
         1e7,
         Math.floor(d.maxBytes * 8 / seconds * 0.85)
@@ -5106,7 +4244,7 @@ async function deliverTake(browser, dir, opts) {
         parallel: opts.parallel,
         range,
         bitrate,
-        overrides: videoOverrides(d, range),
+        overrides: videoOverrides(d),
         onProgress: opts.onProgress
       });
       if (d.maxBytes !== void 0 && result.bytes > d.maxBytes) {
@@ -5141,7 +4279,7 @@ async function deliverTake(browser, dir, opts) {
     for (let i = 0; i < captured.frames.length; i++) {
       const frame = captured.frames[i];
       const name = captured.frames.length > 1 ? `${d.id}-${i + 1}.png` : `${d.id}.png`;
-      const to = join6(outDir, name);
+      const to = join7(outDir, name);
       await rename4(frame.file, to);
       const bytes = (await stat(to)).size;
       if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
@@ -5163,25 +4301,135 @@ async function deliverTake(browser, dir, opts) {
         ...d.genre === "screenshot" && opts.composed ? { composed: true } : {}
       });
     }
-    if (d.count && captured.frames.length < d.count.min) {
-      skipped.push(
-        `${label}: spec wants ${d.count.min}-${d.count.max}, only ${captured.frames.length} still time(s) available \u2014 pass --times`
+    if (d.count && captured.frames.length < d.count.min) {
+      skipped.push(
+        `${label}: spec wants ${d.count.min}-${d.count.max}, only ${captured.frames.length} still time(s) available \u2014 pass --times`
+      );
+    }
+  }
+  const kit = {
+    release: opts.release ?? null,
+    look: opts.look?.kind ?? null,
+    take: dir,
+    produced: (/* @__PURE__ */ new Date()).toISOString(),
+    specsVerified: CHANNEL_SPECS_VERIFIED,
+    moments,
+    skipped,
+    assets
+  };
+  const kitFile = join7(outDir, "kit.json");
+  await writeFile6(kitFile, JSON.stringify(kit, null, 2));
+  return { kit, kitFile, outDir };
+}
+
+// src/plugin/markAsset.ts
+import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile7 } from "fs/promises";
+import { existsSync as existsSync7 } from "fs";
+import { isAbsolute as isAbsolute2, join as join8, resolve as resolve5 } from "path";
+function markExtension(url) {
+  const m = /\.(svg|png|webp|jpe?g)(?:[?#]|$)/i.exec(url);
+  if (!m) return null;
+  const e = m[1].toLowerCase();
+  return e === "jpeg" ? "jpg" : e;
+}
+function imageAspect(bytes, ext) {
+  if (ext === "svg") {
+    const head = new TextDecoder().decode(bytes.subarray(0, 4096));
+    const vb = /viewBox\s*=\s*["']\s*[-\d.]+[\s,]+[-\d.]+[\s,]+([\d.]+)[\s,]+([\d.]+)/i.exec(
+      head
+    );
+    if (vb) return ratio(+vb[1], +vb[2]);
+    const w = /<svg[^>]*\swidth\s*=\s*["']([\d.]+)/i.exec(head);
+    const h = /<svg[^>]*\sheight\s*=\s*["']([\d.]+)/i.exec(head);
+    if (w && h) return ratio(+w[1], +h[1]);
+    return null;
+  }
+  const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  if (ext === "png") {
+    if (bytes.length < 24 || bytes[0] !== 137 || bytes[1] !== 80) return null;
+    return ratio(dv.getUint32(16), dv.getUint32(20));
+  }
+  if (ext === "webp") {
+    if (bytes.length < 30) return null;
+    const tag = String.fromCharCode(...bytes.subarray(12, 16));
+    if (tag === "VP8X")
+      return ratio(
+        1 + (dv.getUint32(24, true) & 16777215),
+        1 + (dv.getUint32(27, true) & 16777215)
+      );
+    if (tag === "VP8L") {
+      const b = dv.getUint32(21, true);
+      return ratio(1 + (b & 16383), 1 + (b >> 14 & 16383));
+    }
+    if (tag === "VP8 ")
+      return ratio(
+        dv.getUint16(26, true) & 16383,
+        dv.getUint16(28, true) & 16383
+      );
+    return null;
+  }
+  if (ext === "jpg") {
+    let i = 2;
+    while (i + 9 < bytes.length) {
+      if (bytes[i] !== 255) return null;
+      const marker = bytes[i + 1];
+      const len = dv.getUint16(i + 2);
+      if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204) {
+        return ratio(dv.getUint16(i + 7), dv.getUint16(i + 5));
+      }
+      i += 2 + len;
+    }
+    return null;
+  }
+  return null;
+}
+function ratio(w, h) {
+  return w > 0 && h > 0 ? w / h : null;
+}
+async function fetchBrandMarks(takeDir, roles) {
+  const out = { light: null, dark: null, notes: [] };
+  if (!roles) return out;
+  const one = async (role, name) => {
+    const src = (roles[role] ?? "").trim();
+    if (!src) return null;
+    const ext = markExtension(src);
+    if (!ext) {
+      out.notes.push(
+        `${role}: ${src} is not an svg, png, webp or jpg; the wordmark stands in`
+      );
+      return null;
+    }
+    let bytes;
+    try {
+      if (/^https?:/i.test(src)) {
+        const res = await fetch(src);
+        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+        bytes = new Uint8Array(await res.arrayBuffer());
+      } else {
+        const file = isAbsolute2(src) ? src : resolve5(takeDir, src);
+        if (!existsSync7(file)) throw new Error("no such file");
+        bytes = new Uint8Array(await readFile7(file));
+      }
+    } catch (e) {
+      out.notes.push(
+        `${role}: ${src} could not be read (${e instanceof Error ? e.message : String(e)}); the wordmark stands in`
+      );
+      return null;
+    }
+    const aspect = imageAspect(bytes, ext);
+    if (!aspect) {
+      out.notes.push(
+        `${role}: ${src} has no readable size; the wordmark stands in`
       );
+      return null;
     }
-  }
-  const kit = {
-    release: opts.release ?? null,
-    look: opts.look?.kind ?? null,
-    take: dir,
-    produced: (/* @__PURE__ */ new Date()).toISOString(),
-    specsVerified: CHANNEL_SPECS_VERIFIED,
-    moments,
-    skipped,
-    assets
+    await mkdir5(join8(takeDir, "brand"), { recursive: true });
+    await writeFile7(join8(takeDir, "brand", `${name}.${ext}`), bytes);
+    return { key: `/brand/${name}.${ext}`, aspect };
   };
-  const kitFile = join6(outDir, "kit.json");
-  await writeFile7(kitFile, JSON.stringify(kit, null, 2));
-  return { kit, kitFile, outDir };
+  out.light = await one("logoUrl", "mark");
+  out.dark = await one("logoOnDarkUrl", "mark-on-dark");
+  return out;
 }
 
 // src/plugin/music.ts
@@ -5197,10 +4445,69 @@ async function fetchMusicCatalog(origin) {
 }
 
 // src/plugin/judge.ts
-import { existsSync as existsSync7 } from "fs";
-import { mkdir as mkdir6, readFile as readFile7, writeFile as writeFile8 } from "fs/promises";
-import { dirname, isAbsolute as isAbsolute2, join as join7, resolve as resolve5 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { mkdir as mkdir6, readFile as readFile8, writeFile as writeFile8 } from "fs/promises";
+import { dirname, isAbsolute as isAbsolute3, join as join9, resolve as resolve6 } from "path";
 import { DESTINATIONS as DESTINATIONS2 } from "@vosjs/studio-core";
+
+// src/plugin/shotBake.ts
+import { deflateSync } from "zlib";
+var crcTable = (() => {
+  const t = new Uint32Array(256);
+  for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+    t[n] = c >>> 0;
+  }
+  return t;
+})();
+function crc32(buf) {
+  let c = 4294967295;
+  for (const b of buf) c = crcTable[(c ^ b) & 255] ^ c >>> 8;
+  return (c ^ 4294967295) >>> 0;
+}
+function chunk(type, body) {
+  const out = new Uint8Array(12 + body.length);
+  const dv = new DataView(out.buffer);
+  dv.setUint32(0, body.length);
+  for (let i = 0; i < 4; i++) out[4 + i] = type.charCodeAt(i);
+  out.set(body, 8);
+  dv.setUint32(8 + body.length, crc32(out.subarray(4, 8 + body.length)));
+  return out;
+}
+function encodePng(img) {
+  const stride = img.w * 4;
+  const raw = new Uint8Array((stride + 1) * img.h);
+  for (let y = 0; y < img.h; y++) {
+    raw[y * (stride + 1)] = 2;
+    for (let i = 0; i < stride; i++) {
+      const cur = img.data[y * stride + i];
+      const up = y ? img.data[(y - 1) * stride + i] : 0;
+      raw[y * (stride + 1) + 1 + i] = cur - up & 255;
+    }
+  }
+  const ihdr = new Uint8Array(13);
+  const dv = new DataView(ihdr.buffer);
+  dv.setUint32(0, img.w);
+  dv.setUint32(4, img.h);
+  ihdr[8] = 8;
+  ihdr[9] = 6;
+  const parts = [
+    new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]),
+    chunk("IHDR", ihdr),
+    chunk("IDAT", new Uint8Array(deflateSync(raw))),
+    chunk("IEND", new Uint8Array(0))
+  ];
+  const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
+  let o = 0;
+  for (const p of parts) {
+    out.set(p, o);
+    o += p.length;
+  }
+  return out;
+}
+
+// src/plugin/judge.ts
 var RUBRIC = [
   "A plate, and room on it: the subject sits at 74 to 89% of the width with headroom; nobody bleeds a window on all four sides.",
   "The window is an object: rounded corners and a shadow with weight (a soft wide one on a light plate, a tight glow on a dark one).",
@@ -5303,26 +4610,26 @@ function composeSheet(left, right, height = 540, gutter = 32) {
   return { w, h, data: out };
 }
 async function judgeKit(kitPath, manifestPath, outDir) {
-  const kit = JSON.parse(await readFile7(kitPath, "utf8"));
-  const manifest = JSON.parse(await readFile7(manifestPath, "utf8"));
-  const manifestDir = dirname(resolve5(manifestPath));
-  const kitDir = dirname(resolve5(kitPath));
-  const out = resolve5(outDir ?? join7(kitDir, "judge"));
+  const kit = JSON.parse(await readFile8(kitPath, "utf8"));
+  const manifest = JSON.parse(await readFile8(manifestPath, "utf8"));
+  const manifestDir = dirname(resolve6(manifestPath));
+  const kitDir = dirname(resolve6(kitPath));
+  const out = resolve6(outDir ?? join9(kitDir, "judge"));
   await mkdir6(out, { recursive: true });
   const sheets = [];
   const skipped = [];
   const refCache = /* @__PURE__ */ new Map();
   const loadRef = async (file) => {
     if (refCache.has(file)) return refCache.get(file) ?? null;
-    const p = join7(manifestDir, file);
-    const img = existsSync7(p) ? decodePng(new Uint8Array(await readFile7(p))) : null;
+    const p = join9(manifestDir, file);
+    const img = existsSync8(p) ? decodePng(new Uint8Array(await readFile8(p))) : null;
     refCache.set(file, img);
     return img;
   };
   for (const a of kit.assets) {
     if (!/\.png$/i.test(a.path)) continue;
-    const file = isAbsolute2(a.path) && existsSync7(a.path) ? a.path : join7(kitDir, a.path.split("/").pop() ?? a.path);
-    const img = existsSync7(file) ? decodePng(new Uint8Array(await readFile7(file))) : null;
+    const file = isAbsolute3(a.path) && existsSync8(a.path) ? a.path : join9(kitDir, a.path.split("/").pop() ?? a.path);
+    const img = existsSync8(file) ? decodePng(new Uint8Array(await readFile8(file))) : null;
     if (!img) {
       skipped.push(`${a.destination ?? a.path}: unreadable`);
       continue;
@@ -5342,8 +4649,8 @@ async function judgeKit(kitPath, manifestPath, outDir) {
     const id = stem.replace(/[^A-Za-z0-9_-]+/g, "-") || a.destination || "asset";
     const nameA = `${id}--A.png`;
     const nameB = `${id}--B.png`;
-    await writeFile8(join7(out, nameA), encodePng(composeSheet(img, refImg)));
-    await writeFile8(join7(out, nameB), encodePng(composeSheet(refImg, img)));
+    await writeFile8(join9(out, nameA), encodePng(composeSheet(img, refImg)));
+    await writeFile8(join9(out, nameB), encodePng(composeSheet(refImg, img)));
     const rubric = [
       `# ${id} against ${ref.id} (${ref.file})`,
       "",
@@ -5363,11 +4670,11 @@ async function judgeKit(kitPath, manifestPath, outDir) {
       "In judge.json: `win` true when the kit asset is at least as good as the reference on the rules that apply to its genre, false when it is worse, null for a tie; `reasons` names the rules by number.",
       ""
     ].join("\n");
-    await writeFile8(join7(out, `${id}.md`), rubric);
+    await writeFile8(join9(out, `${id}.md`), rubric);
     sheets.push({ asset: id, reference: ref.id, sheetA: nameA, sheetB: nameB, rubric: `${id}.md` });
   }
-  const verdictFile = join7(out, "judge.json");
-  if (!existsSync7(verdictFile)) {
+  const verdictFile = join9(out, "judge.json");
+  if (!existsSync8(verdictFile)) {
     await writeFile8(
       verdictFile,
       JSON.stringify(
@@ -5394,7 +4701,7 @@ function winRate(verdicts) {
 // src/plugin/kitPicture.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { readFile as readFile8 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 var execFileP = promisify(execFile);
 var SUBJECT_BAND = { min: 0.6, max: 0.92 };
 var BLANK_INK = 0.12;
@@ -5571,10 +4878,10 @@ function textFindings(a, img) {
         });
       }
     }
-    const rgb2 = t.color ? hexToRgb(t.color) : null;
-    if (rgb2) {
+    const rgb = t.color ? hexToRgb(t.color) : null;
+    if (rgb) {
       const ground = medianColour(img, box);
-      const lc = apcaContrast(rgb2, ground);
+      const lc = apcaContrast(rgb, ground);
       const floor = t.role === "body" ? 75 : 60;
       if (lc < floor) {
         out.push({
@@ -5625,7 +4932,7 @@ function duplicateFindings(stills) {
       severity: composed ? "info" : g.length >= 3 ? "error" : "warning",
       asset: g.map((s) => s.destination).join(", "),
       message: composed ? `${g.length} channels share one cover: ${g.map((s) => s.destination).join(", ")}` : `${g.length} assets share one frame${g[0].time !== null ? ` (${g[0].time.toFixed(2)}s)` : ""}: ${g.map((s) => s.destination).join(", ")}`,
-      fixHint: "a kit is many moments: let deliver pick from the step timeline, or pass --times with one step per still; a poster template composes each card differently from one shot"
+      fixHint: "a kit is many moments: let deliver pick from the step timeline, or pass --times with one step per still; a poster document per class (poster/<class>/doc.json) or per destination (LAUNCH.md poster roles) gives each channel its own cover"
     };
   });
 }
@@ -5670,7 +4977,7 @@ async function pictureChecks(assets) {
   let ffmpeg = null;
   for (const a of assets) {
     if (/\.png$/i.test(a.file)) {
-      const img = decodePng(new Uint8Array(await readFile8(a.file)));
+      const img = decodePng(new Uint8Array(await readFile9(a.file)));
       if (!img) {
         findings.push({
           code: "unreadable",
@@ -5763,9 +5070,9 @@ function formatFinding(f) {
 }
 
 // src/plugin/validateKit.ts
-import { existsSync as existsSync8 } from "fs";
-import { readFile as readFile9, stat as stat2 } from "fs/promises";
-import { dirname as dirname2, isAbsolute as isAbsolute3, join as join8 } from "path";
+import { existsSync as existsSync9 } from "fs";
+import { readFile as readFile10, stat as stat2 } from "fs/promises";
+import { dirname as dirname2, isAbsolute as isAbsolute4, join as join10 } from "path";
 import { DESTINATIONS as DESTINATIONS3 } from "@vosjs/studio-core";
 var PNG_SIG2 = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
 function pngDimensions(bytes) {
@@ -5784,7 +5091,7 @@ async function probeVideo(path) {
   const MB = await import("mediabunny");
   const input = new MB.Input({
     formats: MB.ALL_FORMATS,
-    source: new MB.BufferSource(new Uint8Array(await readFile9(path)))
+    source: new MB.BufferSource(new Uint8Array(await readFile10(path)))
   });
   try {
     const track = await input.getPrimaryVideoTrack();
@@ -5805,7 +5112,7 @@ async function validateKit(kitPath, opts = {}) {
   const measured = [];
   let kit;
   try {
-    kit = JSON.parse(await readFile9(kitPath, "utf8"));
+    kit = JSON.parse(await readFile10(kitPath, "utf8"));
   } catch (e) {
     return {
       valid: false,
@@ -5824,8 +5131,8 @@ async function validateKit(kitPath, opts = {}) {
   }
   const base = dirname2(kitPath);
   const resolvePath = (p) => {
-    if (isAbsolute3(p) && existsSync8(p)) return p;
-    const beside = join8(base, p.split("/").pop() ?? p);
+    if (isAbsolute4(p) && existsSync9(p)) return p;
+    const beside = join10(base, p.split("/").pop() ?? p);
     return beside;
   };
   const perDestination = /* @__PURE__ */ new Map();
@@ -5851,7 +5158,7 @@ async function validateKit(kitPath, opts = {}) {
     let h = null;
     let seconds = null;
     if (/\.(png|jpe?g|webp)$/i.test(file)) {
-      const head = Buffer.from(await readFile9(file));
+      const head = Buffer.from(await readFile10(file));
       const kind = sniffImage(head);
       if (file.toLowerCase().endsWith(".png") && kind !== "png")
         problems.push(
@@ -5899,228 +5206,69 @@ async function validateKit(kitPath, opts = {}) {
     pictureAssets.push({
       destination: id,
       path: a.path,
-      file,
-      spec,
-      text: a.text,
-      seconds,
-      composed: a.composed,
-      shot: a.source === "poster" || a.source === "stage" ? a.shot : void 0,
-      crop: a.crop
-    });
-    if (!spec) {
-      if (a.channel !== "demo")
-        warnings.push(
-          `${label}: no channel spec for "${id}" \u2014 not verified against one`
-        );
-      continue;
-    }
-    if (w !== null && h !== null && (w !== spec.px.w || h !== spec.px.h))
-      problems.push(
-        `${label}: spec wants ${spec.px.w}x${spec.px.h}, the file is ${w}x${h}`
-      );
-    if (spec.maxBytes !== void 0 && bytes > spec.maxBytes)
-      problems.push(
-        `${label}: ${Math.ceil(bytes / 1024)} KB exceeds the ${Math.floor(spec.maxBytes / 1024)} KB ceiling`
-      );
-    if (seconds !== null) {
-      if (spec.minSeconds !== void 0 && seconds < spec.minSeconds - 0.25)
-        problems.push(
-          `${label}: spec wants at least ${spec.minSeconds} s, the file is ${seconds.toFixed(1)} s`
-        );
-      if (spec.maxSeconds !== void 0 && seconds > spec.maxSeconds + 0.25)
-        problems.push(
-          `${label}: spec caps at ${spec.maxSeconds} s, the file is ${seconds.toFixed(1)} s`
-        );
-    }
-    if (spec.format === "png" && !file.toLowerCase().endsWith(".png"))
-      warnings.push(
-        `${label}: spec renders png, the file is ${file.split(".").pop()}`
-      );
-  }
-  for (const [id, n] of perDestination) {
-    const spec = specById.get(id);
-    if (spec?.count && (n < spec.count.min || n > spec.count.max))
-      problems.push(
-        `${spec.channel} ${spec.asset}: spec wants ${spec.count.min}-${spec.count.max}, the kit has ${n}`
-      );
-  }
-  if (!opts.picture) {
-    return { valid: problems.length === 0, problems, warnings, measured };
-  }
-  const picture = await pictureChecks(pictureAssets);
-  const pictureErrors = picture.findings.filter((f) => f.severity === "error");
-  return {
-    valid: problems.length === 0 && pictureErrors.length === 0,
-    problems,
-    warnings,
-    measured,
-    picture: picture.findings,
-    pictureMeasured: picture.measured
-  };
-}
-
-// src/plugin/platform.ts
-import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join as join9 } from "path";
-function platformOrigin(flags = {}) {
-  const legacyEnv = process.env.VOS_API_BASE?.trim();
-  const raw = flags.origin ?? flags.api ?? process.env.VOS_ORIGIN?.trim() ?? legacyEnv ?? "https://vos.so";
-  if (!flags.origin && !flags.api && !process.env.VOS_ORIGIN && legacyEnv) {
-    process.stderr.write(
-      "note: VOS_API_BASE is deprecated \u2014 set VOS_ORIGIN (an origin, no /api suffix)\n"
-    );
-  }
-  return raw.replace(/\/+$/, "").replace(/\/api$/, "");
-}
-function parseVosId(input) {
-  if (!/^https?:\/\//.test(input)) {
-    if (/^[A-Za-z0-9_-]+$/.test(input)) return input;
-    throw new UsageError(`"${input}" is not a vos id or URL`);
-  }
-  let url;
-  try {
-    url = new URL(input);
-  } catch {
-    throw new UsageError(`"${input}" is not a valid URL`);
-  }
-  const query = url.searchParams.get("vos");
-  if (query) return query;
-  const path = url.pathname.match(/\/vos\/([A-Za-z0-9_-]+)/);
-  if (path) return path[1];
-  throw new UsageError(
-    `could not find a vos id in ${input} \u2014 expected /vos/{id} or ?vos={id}`
-  );
-}
-function deriveSlug(title) {
-  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 50).replace(/-+$/, "") || "remix";
-}
-var CREDENTIALS_PATH = join9(homedir(), ".config", "vos", "credentials");
-function resolveCredential(explicit) {
-  const flag = explicit?.trim();
-  if (flag) return flag;
-  const env = process.env.VOS_API_KEY?.trim();
-  if (env) return env;
-  try {
-    const first = readFileSync2(CREDENTIALS_PATH, "utf8").split("\n")[0].trim();
-    return first || null;
-  } catch {
-    return null;
-  }
-}
-function requireCredential(explicit) {
-  const key = resolveCredential(explicit);
-  if (!key) {
-    throw new Error(
-      "no credential found \u2014 pass --key, set VOS_API_KEY, or run `vos login` (mint a content key at https://vos.so/app/api; a vos_rg_ remix grant works too)"
-    );
-  }
-  return key;
-}
-function writeCredential(key) {
-  mkdirSync(join9(homedir(), ".config", "vos"), { recursive: true, mode: 448 });
-  writeFileSync(CREDENTIALS_PATH, `${key.trim()}
-`, { mode: 384 });
-  return CREDENTIALS_PATH;
-}
-function clientId() {
-  const env = process.env.VOS_CLIENT?.trim();
-  if (env && env.length <= 60 && !/[\r\n]/.test(env)) return env;
-  return "vos-cli";
-}
-async function apiJson(origin, path, init = {}) {
-  const headers = {
-    accept: "application/json",
-    ...init.headers
-  };
-  if (init.key) headers.authorization = `Bearer ${init.key}`;
-  if (init.body !== void 0) headers["content-type"] = "application/json";
-  const reqBody = init.raw !== void 0 ? init.raw : init.body === void 0 ? void 0 : JSON.stringify(init.body);
-  const res = await fetch(`${origin}${path}`, {
-    method: init.method ?? "GET",
-    headers,
-    body: reqBody
-  });
-  let body = {};
-  try {
-    body = await res.json();
-  } catch {
-  }
-  return { status: res.status, body };
-}
-function apiError(what, r) {
-  const detail = typeof r.body.error === "string" ? r.body.error : r.body.details !== void 0 ? JSON.stringify(r.body.details) : "";
-  const hint = r.status === 401 ? " (run `vos login`, or set VOS_API_KEY \u2014 mint a key at https://vos.so/app/api)" : "";
-  return `${what} \u2192 ${r.status}${detail ? `: ${detail}` : ""}${hint}`;
-}
-var SYNC_STATE_NAME = "vos.json";
-function readJsonFile(file) {
-  try {
-    return JSON.parse(readFileSync2(file, "utf8"));
-  } catch {
-    return null;
-  }
-}
-function readSyncState(dir) {
-  const own = readJsonFile(join9(dir, SYNC_STATE_NAME));
-  if (own && typeof own.vosId === "string") {
-    return {
-      vosId: own.vosId,
-      versionId: typeof own.versionId === "string" ? own.versionId : null,
-      ...typeof own.pushedAt === "string" ? { pushedAt: own.pushedAt } : {},
-      ...typeof own.title === "string" ? { title: own.title } : {},
-      ...typeof own.slug === "string" ? { slug: own.slug } : {},
-      ...typeof own.remixOfId === "string" ? { remixOfId: own.remixOfId } : {}
-    };
+      file,
+      spec,
+      text: a.text,
+      seconds,
+      composed: a.composed,
+      shot: a.source === "poster" || a.source === "stage" ? a.shot : void 0,
+      crop: a.crop
+    });
+    if (!spec) {
+      if (a.channel !== "demo")
+        warnings.push(
+          `${label}: no channel spec for "${id}" \u2014 not verified against one`
+        );
+      continue;
+    }
+    if (w !== null && h !== null && (w !== spec.px.w || h !== spec.px.h))
+      problems.push(
+        `${label}: spec wants ${spec.px.w}x${spec.px.h}, the file is ${w}x${h}`
+      );
+    if (spec.maxBytes !== void 0 && bytes > spec.maxBytes)
+      problems.push(
+        `${label}: ${Math.ceil(bytes / 1024)} KB exceeds the ${Math.floor(spec.maxBytes / 1024)} KB ceiling`
+      );
+    if (seconds !== null) {
+      if (spec.minSeconds !== void 0 && seconds < spec.minSeconds - 0.25)
+        problems.push(
+          `${label}: spec wants at least ${spec.minSeconds} s, the file is ${seconds.toFixed(1)} s`
+        );
+      if (spec.maxSeconds !== void 0 && seconds > spec.maxSeconds + 0.25)
+        problems.push(
+          `${label}: spec caps at ${spec.maxSeconds} s, the file is ${seconds.toFixed(1)} s`
+        );
+    }
+    if (spec.format === "png" && !file.toLowerCase().endsWith(".png"))
+      warnings.push(
+        `${label}: spec renders png, the file is ${file.split(".").pop()}`
+      );
   }
-  const push = readJsonFile(join9(dir, "push.json"));
-  if (push && typeof push.vosId === "string") {
-    return {
-      vosId: push.vosId,
-      versionId: typeof push.versionId === "string" ? push.versionId : null,
-      ...typeof push.pushedAt === "string" ? { pushedAt: push.pushedAt } : {}
-    };
+  for (const [id, n] of perDestination) {
+    const spec = specById.get(id);
+    if (spec?.count && (n < spec.count.min || n > spec.count.max))
+      problems.push(
+        `${spec.channel} ${spec.asset}: spec wants ${spec.count.min}-${spec.count.max}, the kit has ${n}`
+      );
   }
-  const meta = readJsonFile(join9(dir, "meta.json"));
-  if (meta && typeof meta.id === "string") {
-    return {
-      vosId: meta.id,
-      versionId: typeof meta.currentVersionId === "string" ? meta.currentVersionId : null,
-      ...typeof meta.title === "string" ? { title: meta.title } : {},
-      ...typeof meta.slug === "string" ? { slug: meta.slug } : {},
-      ...typeof meta.remixOfId === "string" ? { remixOfId: meta.remixOfId } : {}
-    };
+  if (!opts.picture) {
+    return { valid: problems.length === 0, problems, warnings, measured };
   }
-  return null;
-}
-function writeSyncState(dir, patch) {
-  const merged = {
-    ...readSyncState(dir) ?? { versionId: null },
-    ...patch
+  const picture = await pictureChecks(pictureAssets);
+  const pictureErrors = picture.findings.filter((f) => f.severity === "error");
+  return {
+    valid: problems.length === 0 && pictureErrors.length === 0,
+    problems,
+    warnings,
+    measured,
+    picture: picture.findings,
+    pictureMeasured: picture.measured
   };
-  writeFileSync(
-    join9(dir, SYNC_STATE_NAME),
-    `${JSON.stringify(merged, null, 2)}
-`
-  );
-  return merged;
-}
-function formatChanges(changes) {
-  const lines = [];
-  for (const ch of changes) {
-    const label = ch.label ? ` \xB7 ${ch.label}` : "";
-    const who = ch.origin === "studio" ? "human" : ch.origin ?? "unknown";
-    lines.push(
-      `v${String(ch.versionNumber ?? "?")} (${who}${label}): ${ch.summary ?? ""}`
-    );
-    if (ch.note) lines.push(`    note: ${ch.note}`);
-  }
-  return lines;
 }
 
 // src/plugin/recorder.ts
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 
 // src/plugin/recordingCap.ts
 var HOSTED_RECORDING_CAP_SECONDS = 30 * 60;
@@ -6208,7 +5356,7 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
   cdp.on("Page.screencastFrame", (ev) => {
     const tsMs = ev.metadata.timestamp ? ev.metadata.timestamp * 1e3 : Date.now();
     const file = `frame-${String(frameIdx++).padStart(5, "0")}.jpg`;
-    writeFileSync2(join10(paths.framesDir, file), Buffer.from(ev.data, "base64"));
+    writeFileSync2(join11(paths.framesDir, file), Buffer.from(ev.data, "base64"));
     frames.push({ file, tMs: Math.max(0, Math.round(tsMs - t0)) });
     cdp.send("Page.screencastFrameAck", { sessionId: ev.sessionId }).catch(() => {
     });
@@ -6431,7 +5579,7 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
   await sleep(200);
   const pageTitle = await page.title().catch(() => "");
   await context.close();
-  const firstFrame = frames[0] ? jpegDims(readFileSync3(join10(paths.framesDir, frames[0].file))) : null;
+  const firstFrame = frames[0] ? jpegDims(readFileSync3(join11(paths.framesDir, frames[0].file))) : null;
   const meta = {
     dpr: 1,
     zoom: 1,
@@ -6539,14 +5687,17 @@ async function encodeRecording(browser, takeDir, onProgress) {
 }
 
 // src/plugin/plan.ts
-import { existsSync as existsSync9 } from "fs";
-import { readFile as readFile10 } from "fs/promises";
-import { join as join11 } from "path";
+import { existsSync as existsSync10 } from "fs";
+import { readFile as readFile11 } from "fs/promises";
+import { join as join12 } from "path";
 import {
   DEFAULT_FRAME_STYLE,
   STYLE_FIELDS,
+  copyLayout,
   copyStyle,
   isRejected,
+  isStageClip,
+  layoutOf,
   planAutoSpeed,
   planAutoZoom,
   projectFromArtifact,
@@ -6734,15 +5885,36 @@ function retimeCut(prev, newSteps, newDurationMs) {
 // src/plugin/plan.ts
 var overlaps = (a, b) => a.in < b.out && b.in < a.out;
 async function readDigestActivity(dir) {
-  const file = join11(dir, "digest", "digest.json");
-  if (!existsSync9(file)) return null;
+  const file = join12(dir, "digest", "digest.json");
+  if (!existsSync10(file)) return null;
   try {
-    const d = JSON.parse(await readFile10(file, "utf8"));
+    const d = JSON.parse(await readFile11(file, "utf8"));
     return Array.isArray(d.activity) && d.activity.every((v) => typeof v === "number") ? d.activity : null;
   } catch {
     return null;
   }
 }
+function patchStageWords(doc, words) {
+  const map = {
+    "stage-title": words.headline,
+    "stage-kicker": words.kicker,
+    "stage-brand": words.brand
+  };
+  for (const clip of doc.overlays ?? []) {
+    if (clip.kind !== "text" || !isStageClip(clip)) continue;
+    const v = map[clip.id];
+    if (typeof v === "string" && v.trim()) clip.text = v.trim();
+  }
+}
+function applyStyle(seed, doc, opts) {
+  const parts = layoutOf(seed);
+  const carries = parts.clips.length > 0 || parts.lean || parts.hold;
+  if (!carries) return { doc: copyStyle(seed, doc), layout: void 0 };
+  const keys = opts.mark ? { "stage-mark": opts.mark.key } : void 0;
+  const { doc: next, notes } = copyLayout(seed, copyStyle(seed, doc), { keys });
+  if (opts.words) patchStageWords(next, opts.words);
+  return { doc: next, layout: { ...parts, notes } };
+}
 async function planTake(dir, opts = {}) {
   const take = await loadTake(dir);
   const { meta, cursor } = take;
@@ -6750,6 +5922,7 @@ async function planTake(dir, opts = {}) {
   const ingest = opts.backdrop ? { frame: withBackdrop(DEFAULT_FRAME_STYLE, opts.backdrop) } : {};
   let doc;
   let fresh;
+  let layout;
   if (opts.reuse) {
     const prev = opts.reuse.doc;
     const artifact = {
@@ -6761,6 +5934,10 @@ async function planTake(dir, opts = {}) {
     doc = copyStyle(prev, doc);
     const rt = retimeCut(prev, meta.steps ?? [], meta.durationMs);
     doc.segments = rt.segments;
+    const prevHold = prev.segments.at(-1)?.hold;
+    const last = doc.segments.at(-1);
+    if (typeof prevHold === "number" && prevHold > 0 && last)
+      last.hold = prevHold;
     if (rt.rejected.length) doc.rejected = rt.rejected;
     const manualZoom = rt.zoom;
     const autoZoom = planAutoZoom(doc.source.cursor, {
@@ -6782,6 +5959,7 @@ async function planTake(dir, opts = {}) {
     if (prev.objects?.length) doc.objects = prev.objects;
     if (prev.audio.length) doc.audio = prev.audio;
     if (prev.camMotion?.length) doc.camMotion = prev.camMotion;
+    if (prev.endCard) doc.endCard = structuredClone(prev.endCard);
     await writeJson(take.paths.doc, doc, true);
     return {
       doc,
@@ -6793,7 +5971,13 @@ async function planTake(dir, opts = {}) {
     };
   }
   if (take.doc) {
-    doc = opts.style ? copyStyle(opts.style.doc, take.doc) : take.doc;
+    if (opts.style) {
+      const applied = applyStyle(opts.style.doc, take.doc, opts);
+      doc = applied.doc;
+      layout = applied.layout;
+    } else {
+      doc = take.doc;
+    }
     fresh = false;
     const manual = doc.zoom.filter((z) => z.source === "manual");
     const auto = planAutoZoom(doc.source.cursor, {
@@ -6817,7 +6001,11 @@ async function planTake(dir, opts = {}) {
       meta
     };
     doc = projectFromArtifact(artifact, RECORDING_NAME, ingest).doc;
-    if (opts.style) doc = copyStyle(opts.style.doc, doc);
+    if (opts.style) {
+      const applied = applyStyle(opts.style.doc, doc, opts);
+      doc = applied.doc;
+      layout = applied.layout;
+    }
     doc.zoom = planAutoZoom(doc.source.cursor, {
       width: doc.source.meta.width,
       height: doc.source.meta.height,
@@ -6831,6 +6019,12 @@ async function planTake(dir, opts = {}) {
     });
     fresh = true;
   }
+  let motion;
+  if (opts.motion && (fresh || opts.motion.again)) {
+    const proposed = proposeMotion(doc, opts.motion);
+    doc = proposed.doc;
+    motion = { notes: proposed.notes, skipped: proposed.skipped };
+  }
   await writeJson(take.paths.doc, doc, true);
   return {
     doc,
@@ -6844,22 +6038,24 @@ async function planTake(dir, opts = {}) {
       styleFields: STYLE_FIELDS.filter(
         (k) => opts.style.doc[k] !== void 0
       )
-    } : {}
+    } : {},
+    ...layout ? { layout } : {},
+    ...motion ? { motion } : {}
   };
 }
 
 // src/plugin/sync.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync11 } from "fs";
-import { readFile as readFile11 } from "fs/promises";
+import { existsSync as existsSync12 } from "fs";
+import { readFile as readFile12 } from "fs/promises";
 import { createInterface } from "readline/promises";
-import { basename, join as join14 } from "path";
-import { lowerToComposition as lowerToComposition3, migrateHostedDoc as migrateHostedDoc2 } from "@vosjs/studio-core";
+import { basename, join as join15 } from "path";
+import { lowerToComposition as lowerToComposition3, migrateHostedDoc as migrateHostedDoc3 } from "@vosjs/studio-core";
 
 // src/plugin/media.ts
-import { createWriteStream, existsSync as existsSync10 } from "fs";
+import { createWriteStream, existsSync as existsSync11 } from "fs";
 import { writeFile as writeFile9 } from "fs/promises";
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
 var MIC_NAME = "mic.webm";
@@ -6869,6 +6065,81 @@ var KEYS = [
   { key: "micKey", file: MIC_NAME },
   { key: "camKey", file: CAM_NAME }
 ];
+function isTakeRelativeKey(key) {
+  return !!key && !/^(https?:|blob:|data:|\/\/)/.test(key) && !key.startsWith("/api/");
+}
+var takeRelativeFile = (key) => key.replace(/^\/+/, "");
+function docMediaRefs(doc, keep = isTakeRelativeKey) {
+  const out = [];
+  for (const clip of doc.overlays ?? []) {
+    if (clip.kind === "text" || !keep(clip.key)) continue;
+    out.push({
+      where: `overlay ${clip.id}`,
+      key: clip.key,
+      set: (next) => {
+        clip.key = next;
+      }
+    });
+  }
+  const mark = doc.endCard?.mark;
+  if (mark && keep(mark.key))
+    out.push({
+      where: "end card mark",
+      key: mark.key,
+      set: (next) => {
+        mark.key = next;
+      }
+    });
+  const bg = doc.frame.backgroundMedia;
+  if (bg && keep(bg.key))
+    out.push({
+      where: "background",
+      key: bg.key,
+      set: (next) => {
+        bg.key = next;
+      }
+    });
+  return out;
+}
+function mediaContentType(file) {
+  const ext = (/\.([a-z0-9]+)$/i.exec(file)?.[1] ?? "").toLowerCase();
+  const types = {
+    svg: "image/svg+xml",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    gif: "image/gif",
+    avif: "image/avif",
+    webm: "video/webm",
+    mp4: "video/mp4",
+    mov: "video/quicktime",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    ogg: "audio/ogg",
+    m4a: "audio/mp4"
+  };
+  return types[ext] ?? "application/octet-stream";
+}
+function extensionFor(contentType) {
+  const t = contentType.split(";")[0].trim().toLowerCase();
+  const exts = {
+    "image/svg+xml": ".svg",
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/webp": ".webp",
+    "image/gif": ".gif",
+    "image/avif": ".avif",
+    "video/webm": ".webm",
+    "video/mp4": ".mp4",
+    "video/quicktime": ".mov",
+    "audio/mpeg": ".mp3",
+    "audio/wav": ".wav",
+    "audio/ogg": ".ogg",
+    "audio/mp4": ".m4a"
+  };
+  return exts[t] ?? "";
+}
 function assetIdOf(url) {
   if (!url) return null;
   const m = /\/api\/assets\/([A-Za-z0-9_-]+)\/file/.exec(url);
@@ -6880,8 +6151,8 @@ async function pullMedia(ctx, dir, doc, log) {
     const url = doc.source[key];
     const assetId = assetIdOf(url);
     if (!assetId) continue;
-    const target = join12(dir, file);
-    if (existsSync10(target)) {
+    const target = join13(dir, file);
+    if (existsSync11(target)) {
       result.kept.push(file);
     } else {
       const abs = /^https?:/.test(url) ? url : `${ctx.origin}${url}`;
@@ -6903,19 +6174,56 @@ async function pullMedia(ctx, dir, doc, log) {
     }
     doc.source[key] = file;
   }
-  const metaPath = join12(dir, "meta.json");
-  if (!existsSync10(metaPath)) await writeJson(metaPath, doc.source.meta, true);
-  const cursorPath = join12(dir, "cursor.json");
-  if (!existsSync10(cursorPath)) await writeJson(cursorPath, doc.source.cursor);
-  await writeFile9(join12(dir, "doc.json"), JSON.stringify(doc, null, 2));
+  for (const ref of docMediaRefs(doc, (k) => assetIdOf(k) !== null)) {
+    const assetId = assetIdOf(ref.key);
+    const abs = /^https?:/.test(ref.key) ? ref.key : `${ctx.origin}${ref.key}`;
+    const existing = existsSync11(join13(dir, "media")) ? (await import("fs/promises").then(
+      (fs) => fs.readdir(join13(dir, "media"))
+    )).find((f) => f.startsWith(`${assetId}.`)) : void 0;
+    let file;
+    if (existing) {
+      file = `media/${existing}`;
+      result.kept.push(file);
+    } else {
+      const res = await fetch(abs, {
+        headers: ctx.key ? { authorization: `Bearer ${ctx.key}` } : {}
+      });
+      if (!res.ok || !res.body) {
+        throw new Error(
+          `download of ${ref.where} (${ref.key}) failed (${res.status})`
+        );
+      }
+      const ext = extensionFor(res.headers.get("content-type") ?? "");
+      file = `media/${assetId}${ext}`;
+      const target = join13(dir, file);
+      await import("fs/promises").then(
+        (fs) => fs.mkdir(join13(dir, "media"), { recursive: true })
+      );
+      await pipeline(
+        Readable.fromWeb(res.body),
+        createWriteStream(target)
+      );
+      const bytes = (await import("fs/promises").then((fs) => fs.stat(target))).size;
+      result.downloaded.push({ file, assetId, bytes });
+      log(
+        `  ${file} \u2190 ${ref.where}, asset ${assetId} (${Math.round(bytes / 1024)} kB)`
+      );
+    }
+    ref.set(file);
+  }
+  const metaPath = join13(dir, "meta.json");
+  if (!existsSync11(metaPath)) await writeJson(metaPath, doc.source.meta, true);
+  const cursorPath = join13(dir, "cursor.json");
+  if (!existsSync11(cursorPath)) await writeJson(cursorPath, doc.source.cursor);
+  await writeFile9(join13(dir, "doc.json"), JSON.stringify(doc, null, 2));
   return result;
 }
 
 // src/plugin/folder.ts
 import { mkdir as mkdir7, writeFile as writeFile10 } from "fs/promises";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 import { recipeHints } from "@vosjs/shared/frontmatter";
-import { migrateHostedDoc } from "@vosjs/studio-core";
+import { migrateHostedDoc as migrateHostedDoc2 } from "@vosjs/studio-core";
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["json", "help", "media"]);
 async function listFolders(origin, key) {
   const r = await apiJson(origin, "/api/folders", { key });
@@ -7089,18 +6397,18 @@ async function cmdPull(argv) {
     throw new Error(apiError(`pull folder ${folder.slug}`, res));
   const payload = res.body;
   const out = strFlag(flags, "out") ?? folder.slug;
-  await mkdir7(join13(out, "recipes"), { recursive: true });
+  await mkdir7(join14(out, "recipes"), { recursive: true });
   const lines = [];
   const recipes = [];
   for (const rec of payload.recipes) {
-    const path = join13(out, "recipes", safeName(rec.filename));
+    const path = join14(out, "recipes", safeName(rec.filename));
     await writeFile10(path, rec.body ?? "");
     recipes.push({ path, line: recipeLine(rec.filename, rec.body ?? "") });
   }
   for (const rec of payload.inheritedRecipes) {
     const from = safeName(rec.folderSlug ?? "inherited");
-    await mkdir7(join13(out, "recipes", "_inherited", from), { recursive: true });
-    const path = join13(
+    await mkdir7(join14(out, "recipes", "_inherited", from), { recursive: true });
+    const path = join14(
       out,
       "recipes",
       "_inherited",
@@ -7115,7 +6423,7 @@ async function cmdPull(argv) {
   }
   const members = [];
   for (const v of payload.voses) {
-    const dir = join13(out, "members", safeName(v.slug || v.title || v.id));
+    const dir = join14(out, "members", safeName(v.slug || v.title || v.id));
     await mkdir7(dir, { recursive: true });
     const cfg = await apiJson(origin, `/api/vos/${v.id}/config`, { key });
     if (cfg.status !== 200) {
@@ -7123,7 +6431,7 @@ async function cmdPull(argv) {
       continue;
     }
     await writeFile10(
-      join13(dir, "config.json"),
+      join14(dir, "config.json"),
       JSON.stringify(cfg.body.config, null, 2)
     );
     let take = false;
@@ -7135,12 +6443,12 @@ async function cmdPull(argv) {
       );
       if (doc.status === 200) {
         await writeFile10(
-          join13(dir, "doc.json"),
+          join14(dir, "doc.json"),
           JSON.stringify(doc.body, null, 2)
         );
         take = true;
         if (flags.media === true) {
-          const hosted = migrateHostedDoc(doc.body);
+          const hosted = migrateHostedDoc2(doc.body);
           await pullMedia({ origin, key }, dir, hosted, r.log);
         }
       }
@@ -7252,7 +6560,7 @@ async function pushTake(dir, flags, r) {
     throw new Error(`doc.json fails lint:
   ${lint.problems.join("\n  ")}`);
   }
-  if (!existsSync11(take.paths.recording)) {
+  if (!existsSync12(take.paths.recording)) {
     throw new Error("no recording.webm in this take");
   }
   const ctx = apiContext(flags);
@@ -7284,7 +6592,7 @@ async function pushTake(dir, flags, r) {
       throw new Error("push cancelled");
     }
   }
-  const bytes = await readFile11(take.paths.recording);
+  const bytes = await readFile12(take.paths.recording);
   const hash = createHash("sha256").update(bytes).digest("hex");
   r.log(`uploading recording (${Math.round(bytes.length / 1024)} kB)\u2026`);
   const upload = await api(ctx, "/assets/recording", {
@@ -7322,6 +6630,35 @@ async function pushTake(dir, flags, r) {
     r.log("  mic track is local-only \u2014 dropped from the push");
     delete docForPush.source.micKey;
   }
+  for (const ref of docMediaRefs(docForPush)) {
+    const file = join15(dir, takeRelativeFile(ref.key));
+    if (!existsSync12(file)) {
+      r.log(`  ${ref.where}: ${ref.key} is not in the take \u2014 left as is`);
+      continue;
+    }
+    const media = await readFile12(file);
+    const mediaHash = createHash("sha256").update(media).digest("hex");
+    const type = mediaContentType(file);
+    const put = await api(ctx, "/assets/recording", {
+      method: "POST",
+      headers: {
+        "Content-Type": type,
+        "Content-Length": String(media.length),
+        "X-Filename": basename(file),
+        "X-Content-Hash": mediaHash
+      },
+      raw: new Uint8Array(media)
+    });
+    if (put.status !== 201 && put.status !== 200) {
+      throw new Error(
+        `${ref.where} upload failed (${put.status}): ${String(put.json.error ?? "")}`
+      );
+    }
+    ref.set(String(put.json.url));
+    r.log(
+      `  ${ref.where}: ${ref.key} \u2192 asset ${String(put.json.id)}${put.json.reused === true ? " (reused)" : ""}`
+    );
+  }
   const lowered = lowerToComposition3(docForPush);
   const config = { ...lowered.config, data: lowered.data };
   if (!state) {
@@ -7435,9 +6772,9 @@ async function pullTake(dir, flags, r) {
       };
     }
     let media2;
-    if (flags.media && existsSync11(join14(dir, "doc.json"))) {
+    if (flags.media && existsSync12(join15(dir, "doc.json"))) {
       const local = JSON.parse(
-        await readFile11(join14(dir, "doc.json"), "utf8")
+        await readFile12(join15(dir, "doc.json"), "utf8")
       );
       media2 = await pullMedia(ctx, dir, local, r.log);
     }
@@ -7495,12 +6832,12 @@ async function pullTake(dir, flags, r) {
       docRes.status === 404 ? "the head version carries no doc \u2014 is this a take vos?" : `doc fetch failed (${docRes.status})`
     );
   }
-  const hostedDoc = migrateHostedDoc2(docRes.json);
+  const hostedDoc = migrateHostedDoc3(docRes.json);
   const doc = hostedDoc;
-  if (existsSync11(join14(dir, RECORDING_NAME))) {
+  if (existsSync12(join15(dir, RECORDING_NAME))) {
     doc.source.videoKey = RECORDING_NAME;
   }
-  await writeJson(join14(dir, "doc.json"), doc, true);
+  await writeJson(join15(dir, "doc.json"), doc, true);
   const media = flags.media ? await pullMedia(ctx, dir, doc, r.log) : void 0;
   const versions = await api(ctx, `/vos/${vosId}/versions`);
   const headRow = (versions.json.versions ?? []).find((v) => v.id === head);
@@ -7519,16 +6856,16 @@ async function pullTake(dir, flags, r) {
 }
 
 // src/plugin/program.ts
-import { existsSync as existsSync12 } from "fs";
-import { mkdir as mkdir8, readFile as readFile12, writeFile as writeFile11 } from "fs/promises";
+import { existsSync as existsSync13 } from "fs";
+import { mkdir as mkdir8, readFile as readFile13, writeFile as writeFile11 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
-import { basename as basename2, dirname as dirname3, join as join15 } from "path";
+import { basename as basename2, dirname as dirname3, join as join16 } from "path";
 import {
   CURRENT_CONFIG_VERSION,
   migrateConfig,
   vosConfigJsonSchema
 } from "@vosjs/core";
-import { migrateHostedDoc as migrateHostedDoc3 } from "@vosjs/studio-core";
+import { migrateHostedDoc as migrateHostedDoc4 } from "@vosjs/studio-core";
 
 // src/plugin/login.ts
 import { hostname } from "os";
@@ -7692,8 +7029,8 @@ function preflightConfig(parsed) {
 }
 function resolveConfigPath(target) {
   if (target.endsWith(".json")) return target;
-  const inDir = join15(target, "config.json");
-  if (existsSync12(inDir)) return inDir;
+  const inDir = join16(target, "config.json");
+  if (existsSync13(inDir)) return inDir;
   throw new UsageError(
     `${target} has no config.json (and is not a take \u2014 no doc.json)`
   );
@@ -7721,7 +7058,7 @@ async function cmdFetch(argv) {
   const out = strFlag(flags, "out") ?? slug;
   await mkdir8(out, { recursive: true });
   await writeFile11(
-    join15(out, "config.json"),
+    join16(out, "config.json"),
     JSON.stringify(cfg.body.config, null, 2)
   );
   const title = typeof vosMeta.title === "string" ? vosMeta.title : "";
@@ -7743,15 +7080,15 @@ async function cmdFetch(argv) {
       }
     );
     if (doc.status === 200 && !("source" in doc.body)) {
-      const hosted = migrateHostedDoc3(doc.body);
+      const hosted = migrateHostedDoc4(doc.body);
       const { config: own } = await writeProgramDoc(out, hosted);
       if (own) {
-        await writeFile11(join15(out, "config.json"), JSON.stringify(own, null, 2));
+        await writeFile11(join16(out, "config.json"), JSON.stringify(own, null, 2));
       }
     } else if (doc.status === 200) {
       take = true;
-      const hosted = migrateHostedDoc3(doc.body);
-      await writeFile11(join15(out, "doc.json"), JSON.stringify(hosted, null, 2));
+      const hosted = migrateHostedDoc4(doc.body);
+      await writeFile11(join16(out, "doc.json"), JSON.stringify(hosted, null, 2));
       if (flags.media === true) {
         const media = await pullMedia({ origin, key }, out, hosted, r.log);
         mediaLine = media.downloaded.length ? ` + ${media.downloaded.map((m) => m.file).join(", ")}` : "";
@@ -7863,7 +7200,7 @@ async function cmdPushProgram(argv) {
     api: strFlag(flags, "api")
   });
   const dir = dirname3(source);
-  const parsed = JSON.parse(await readFile12(source, "utf8"));
+  const parsed = JSON.parse(await readFile13(source, "utf8"));
   const pre = preflightConfig(parsed);
   if (!pre.ok || !pre.config) {
     for (const issue of pre.issues) r.log(`error ${issue}`);
@@ -8096,10 +7433,10 @@ async function cmdPullProgram(argv) {
   const cfg = await apiJson(origin, `/api/vos/${vosId}/config`, { key });
   if (cfg.status !== 200)
     throw new Error(apiError(`fetch head config for ${vosId}`, cfg));
-  const configPath = join15(dir, "config.json");
+  const configPath = join16(dir, "config.json");
   let backedUp = false;
-  if (existsSync12(configPath)) {
-    await writeFile11(join15(dir, "config.backup.json"), await readFile12(configPath));
+  if (existsSync13(configPath)) {
+    await writeFile11(join16(dir, "config.backup.json"), await readFile13(configPath));
     backedUp = true;
   }
   let headConfig = cfg.body.config;
@@ -8113,7 +7450,7 @@ async function cmdPullProgram(argv) {
     if (docRes.status === 200 && !("source" in docRes.body)) {
       const { config: own } = await writeProgramDoc(
         dir,
-        migrateHostedDoc3(docRes.body)
+        migrateHostedDoc4(docRes.body)
       );
       if (own) headConfig = own;
     }
@@ -8132,7 +7469,7 @@ async function cmdPullProgram(argv) {
       protected: protectedIds,
       changes,
       out: configPath,
-      backup: backedUp ? join15(dir, "config.backup.json") : null
+      backup: backedUp ? join16(dir, "config.backup.json") : null
     },
     `Pulled ${changes.length} version${changes.length === 1 ? "" : "s"} \u2192 ${configPath}` + (backedUp ? ` (previous copy: config.backup.json)` : "") + `
 Re-apply your edit on the new head, then: vos push ${configPath} --vos ${vosId}`
@@ -8189,9 +7526,9 @@ function isTakeDir(target) {
   return directoryKind(target) === "take";
 }
 async function readProgramDoc(dir, config) {
-  const docPath = join15(dir, "doc.json");
-  if (!existsSync12(docPath)) return null;
-  const parsed = JSON.parse(await readFile12(docPath, "utf8"));
+  const docPath = join16(dir, "doc.json");
+  if (!existsSync13(docPath)) return null;
+  const parsed = JSON.parse(await readFile13(docPath, "utf8"));
   if (typeof parsed !== "object" || parsed === null || "source" in parsed)
     return null;
   const raw = parsed;
@@ -8202,7 +7539,7 @@ async function writeProgramDoc(dir, hosted) {
   const program = hosted.program && typeof hosted.program === "object" ? hosted.program : {};
   const { config, ...rest } = program;
   const onDisk = { ...hosted, program: rest };
-  await writeFile11(join15(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
+  await writeFile11(join16(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
   return {
     config: config && typeof config === "object" ? config : null
   };
@@ -8410,7 +7747,7 @@ async function cmdRecipe(argv) {
 
 // src/plugin/brand.ts
 import { writeFile as writeFile12 } from "fs/promises";
-import { resolve as resolve6 } from "path";
+import { resolve as resolve7 } from "path";
 import { parseFrontmatter as parseFrontmatter2 } from "@vosjs/shared/frontmatter";
 import { lookKindForGround } from "@vosjs/studio-core";
 var HEX_RE = /#(?:[0-9a-f]{6}|[0-9a-f]{3})\b/gi;
@@ -8459,7 +7796,7 @@ function isSaturated(hex2) {
   return s >= 0.25 && l > 0.12 && l < 0.88;
 }
 var isLight = (hex2) => hsl(hex2).l >= 0.5;
-function mixHex2(a, b, t) {
+function mixHex(a, b, t) {
   const ch = (i) => Math.round(
     parseInt(a.slice(i, i + 2), 16) * (1 - t) + parseInt(b.slice(i, i + 2), 16) * t
   ).toString(16).padStart(2, "0");
@@ -8477,7 +7814,7 @@ function mostCommon(values) {
     }
   return best;
 }
-function firstFamily2(fontFamily) {
+function firstFamily(fontFamily) {
   const first = fontFamily.split(",")[0]?.trim() ?? "";
   return first.replace(/^["']|["']$/g, "");
 }
@@ -8596,7 +7933,7 @@ function composeBrand(input) {
   p.bgA = `the body's background`;
   const surfaceHexes = w.surfaces.map(rgbToHex).filter((h) => h !== null && h !== bgA);
   const neutralSurface = mostCommon(surfaceHexes.filter((h) => !isSaturated(h)));
-  const bgB = neutralSurface ?? mixHex2(bgA, isLight(bgA) ? "#000000" : "#ffffff", 0.04);
+  const bgB = neutralSurface ?? mixHex(bgA, isLight(bgA) ? "#000000" : "#ffffff", 0.04);
   p.bgB = neutralSurface ? `the most common section / card ground` : `no distinct surface found; bgA stepped 4% toward ${isLight(bgA) ? "black" : "white"}`;
   const accentHexes = w.accents.map(rgbToHex).filter((h) => h !== null && isSaturated(h));
   const themeHex = w.themeColor ? rgbToHex(w.themeColor) : null;
@@ -8606,13 +7943,13 @@ function composeBrand(input) {
   const inkHex = rgbToHex(w.h1?.color ?? w.body.color) ?? (isLight(bgA) ? "#111111" : "#f5f5f5");
   if (!accent) accent = inkHex;
   p.accent = accentHexes.length ? `the saturated colour buttons and links agree on` : themeHex && isSaturated(themeHex) ? `the theme-color meta` : design?.hexes.find(isSaturated) ? `a hex quoted in design.md` : `no saturated colour on the page; the ink stands in`;
-  const bgC = mixHex2(bgA, accent, 0.14);
+  const bgC = mixHex(bgA, accent, 0.14);
   p.bgC = `bgA tinted 14% toward the accent (a highlight ground)`;
   p.ink = w.h1 ? `the h1's colour` : `the body's colour`;
-  const fontDisplay = design?.fonts[0] ?? (w.h1 ? firstFamily2(w.h1.fontFamily) : firstFamily2(w.body.fontFamily));
+  const fontDisplay = design?.fonts[0] ?? (w.h1 ? firstFamily(w.h1.fontFamily) : firstFamily(w.body.fontFamily));
   p.fontDisplay = design?.fonts[0] ? `named in design.md` : w.h1 ? `the h1's computed face` : `the body's computed face (no h1)`;
   const designBody = design?.fonts.slice(1).find((f) => !/\bmono\b/i.test(f));
-  const fontBody = designBody ?? firstFamily2(w.body.fontFamily);
+  const fontBody = designBody ?? firstFamily(w.body.fontFamily);
   p.fontBody = designBody ? `named in design.md` : `the body's computed face`;
   const isIcon = (u) => /favicon|apple-touch|icon/i.test(u);
   const onDark = (u) => /on-dark|white/i.test(u);
@@ -8727,7 +8064,7 @@ async function cmdBrand(argv) {
     throw new UsageError(`not a URL: ${raw}`);
   }
   const r = createReporter(flags.json === true);
-  const out = resolve6(strFlag(flags, "out") ?? "BRAND.md");
+  const out = resolve7(strFlag(flags, "out") ?? "BRAND.md");
   r.log(`reading ${origin}/design.md and /llms.txt\u2026`);
   const [designText, llmsText] = await Promise.all([
     fetchText(`${origin}/design.md`),
@@ -8780,7 +8117,7 @@ async function cmdBrand(argv) {
 
 // src/plugin/agentBrowser.ts
 import { writeFile as writeFile13 } from "fs/promises";
-import { resolve as resolve7 } from "path";
+import { resolve as resolve8 } from "path";
 function parseAgentBrowserLog(text) {
   const records = [];
   const problems = [];
@@ -9250,7 +8587,7 @@ async function cmdActions(argv) {
     );
   }
   const r = createReporter(flags.json === true);
-  const out = resolve7(strFlag(flags, "out") ?? "actions.json");
+  const out = resolve8(strFlag(flags, "out") ?? "actions.json");
   const viewportFlag = strFlag(flags, "viewport");
   let viewport;
   if (viewportFlag) {
@@ -9258,8 +8595,8 @@ async function cmdActions(argv) {
     if (!m) throw new UsageError("--viewport expects WxH, e.g. 1280x720");
     viewport = { width: Number(m[1]), height: Number(m[2]) };
   }
-  const { readFile: readFile14 } = await import("fs/promises");
-  const text = await readFile14(resolve7(input), "utf8");
+  const { readFile: readFile15 } = await import("fs/promises");
+  const text = await readFile15(resolve8(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -9311,7 +8648,8 @@ var BOOLEAN_FLAGS5 = /* @__PURE__ */ new Set([
   "print",
   "yes",
   "composed",
-  "check"
+  "check",
+  "motion"
 ]);
 var MULTI_FLAGS2 = /* @__PURE__ */ new Set(["set", "override"]);
 var HELP = `vos \u2014 record a browser flow, plan effects, render a product video; sync with vos.so
@@ -9319,10 +8657,10 @@ var HELP = `vos \u2014 record a browser flow, plan effects, render a product vid
 Take pipeline
   vos create --actions actions.json [--url <url>] [--out take] [out.webm] [--strict] [--max-duration <s>] [--background <slug|url|none>] [render flags] [--json]
   vos record --actions actions.json [--url <url>] [--out take] [--strict] [--max-duration <s>] [--background <slug|url|none>] [--json]
-  vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--background <slug|url|none>] [--json]
+  vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--background <slug|url|none>] [--motion] [--headline "\u2026"] [--kicker "\u2026"] [--launch LAUNCH.md] [--brand BRAND.md] [--music <slug|mood|none>] [--entrance tilt-in|pull-out|rise|none] [--end-card none] [--captions none] [--clicks none] [--release v2.1] [--json]
   vos render <take> [out.webm] [--width] [--height] [--fps] [--format webm|mp4] [--parallel N] [--range a..b] [--draft] [--frame <kind>] [--background <url|slug>] [--set <path=value>]... [--json]
   vos frames <take> [--times 0,25%,50%,75%,100%] [--frame <t>] [--at-zooms] [--at-moments] [--size WxH] [--out dir] [--background <url|slug>] [--set <path=value>]... [--json]
-  vos deliver <take> --to cws,producthunt,x,linkedin,og,github,youtube (or all) [--headline "\u2026"] [--kicker "\u2026"] [--launch LAUNCH.md] [--music <slug|mood|none>] [--entrance tilt-in|pull-out|rise|none] [--end-card none] [--captions none] [--clicks none] [--look plate|gradient|dark|none] [--brand BRAND.md] [--poster <split-cover|card-on-gradient|config.json|vosId|none>] [--shot-time <t>] [--poster-time <t>] [--composed] [--set path=value] [--release v2.1] [--out dir] [--times a,b] [--range a..b] [--parallel N] [--json]
+  vos deliver <take> --to cws,producthunt,x,linkedin,og,github,youtube (or all) [--launch LAUNCH.md] [--look plate|gradient|dark|none] [--brand BRAND.md] [--composed] [--set path=value] [--release v2.1] [--out dir] [--times a,b] [--range a..b] [--parallel N] [--json]
   vos digest <take> [--out dir] [--full 960] [--crop 640] [--no-frames] [--transcript <file.json>] [--style <doc.json|vosId>] [--json]
   vos brand <url> [--out BRAND.md] [--json]
   vos open <take> [--studio <url>] [--print]
@@ -9422,44 +8760,47 @@ read once as the real page, blank ones (a wallpaper, an empty canvas) are
 dropped and two of one frame collapse to one, with every drop said in
 skipped[]. --times overrides with seconds, percents or step:<id>[+offset]
 (the id from actions.json); --range cuts every video destination.
-The LOOK presents the card: card-genre stills with no poster and every
-video cut sit on a ground (a cream plate, the house gradient, a dark plate
-with a light streak) at ~84% of the width with headroom, a soft ambient
-shadow plus a tight contact shadow, and a hairline when card and ground
-are both light; a wide frame runs the card off the bottom. --look picks a
-house look (or none for the pre-look crops); with no flag the BRAND.md
-beside the take (or --brand <file>) decides from its look role or its own
-ground (a paper site is a plate, a dark site is dark), and with no brand
-the house gradient. Screenshot-genre stills never take a look.
-Card-genre destinations (OG, LinkedIn, X, YouTube thumbnail, the CWS
-tile + marquee, GitHub social preview) COMPOSE by default: each renders
-from its destination's poster TEMPLATE (split-cover is a STAGE, the
-take's own card leaning in perspective with its chrome and shadow beside
-a serif headline column, on the brand's ground; card-on-gradient is the
-shot alone on a mesh, the store's tile rule), filled with BRAND.md's colours and faces and the
-release's words, the shot baked as an object (padded, rounded, shadowed,
-a hairline on a light ground), PNG at exact pixels; kit.json records the
-template and the text boxes. The headline is LAUNCH.md's headline role
-beside the take or --headline (with none, the headline templates stand
-down for card-on-gradient, said); --kicker overrides the wordmark plus
---release line. --poster names a bundled template for every card, your
-own template (a config.json or a hosted vos id carrying a template
-block), or none to keep the take path.
-Every video cut but the README loop opens on an ENTRANCE (tilt-in by
-default: the card swings in from a perspective pose and settles) and
-closes on an END CARD (the last frame holds 2.5 s while the card recedes
-and the headline, the release line and the wordmark rise); LAUNCH.md's
-entrance and endCard roles, or --entrance and --end-card, change or
-switch them off. A step's caption in actions.json lands as a lower-third
-at the step's moment on cuts that take words (--captions none to skip).
-Destinations that play sound (the X cut, the YouTube demo, the vertical
-cut) take a music bed from LAUNCH.md's music role (a catalog slug or a
-mood; --music overrides) and a click sound on every press when the take
-has no mic (--clicks none). The 9:16 cut is a reframe, not a letterbox:
-the crop follows the camera. --shot-time <t> picks the take moment (OUTPUT seconds;
-default the first still time \u2014 pick a zoom apex, the cut's camera makes
-the shot the feature, not the whole page); --poster-time <t> is the instant
-inside the poster's OWN timeline (default 90% through it). Screenshot-genre
+The LOOK presents the card: card-genre stills with no poster document
+and every video cut sit on a ground (a cream plate, the house gradient, a
+dark plate with a light streak) at ~84% of the width with headroom, a
+soft ambient shadow plus a tight contact shadow, and a hairline when card
+and ground are both light; a wide frame runs the card off the bottom.
+--look picks a house look (or none for the pre-look crops); with no flag
+the BRAND.md beside the take (or --brand <file>) decides from its look
+role or its own ground, and with no brand the house gradient.
+Screenshot-genre stills never take a look.
+A POSTER is a document, never a template: a plain take whose card sits
+where the poster wants it (frame.inset), leans (the tilt track), carries
+the words and the mark as clips (ids stage-title, stage-kicker,
+stage-brand, stage-mark) and ends on a trailing hold whose start is the
+still. Card-genre destinations (OG, LinkedIn, X, YouTube thumbnail, the
+CWS tile + marquee, GitHub social preview) render from the poster
+document of their aspect CLASS (landscape, square, portrait, tile), found
+beside the take as poster/<class>/doc.json (poster/doc.json serves every
+class) or named in LAUNCH.md (poster: <path>, poster-landscape: \u2026), at
+the document's rest; kit.json records source poster, the class, the file,
+the vos it tracks, the shot rect and the text boxes read FROM the
+document. A class with no document is the take's own frame, said once.
+deliver renders and verifies; it composes nothing. The composition is
+made with plan --style <poster>, which copies a poster's layout onto a
+take (its card placement, its stage clips with the release's words
+patched in from LAUNCH.md's headline and kicker roles or --headline and
+--kicker, its rest lean, its hold), or by hand in doc.json.
+The cut's MOTION is the document's too. plan proposes it on a fresh plan
+(--motion re-proposes onto an existing doc.json, replacing only its own
+proposals): the card's ENTRANCE (tilt-in by default: the card swings in
+from a perspective pose and settles), the END CARD (the last frame holds
+2.5 s while the card recedes and the headline, the release line and the
+wordmark rise; the brand's mark from BRAND.md logoUrl above them), a
+CAPTION per actions.json step at the step's moment, a music BED from
+LAUNCH.md's music role (a catalog slug or a mood) and a click sound on
+every press when the take has no mic. LAUNCH.md's entrance, endCard,
+captions, music and clicks roles, or the flags, change or switch each
+off; a deleted proposal stays deleted on a refresh. deliver applies each
+destination's MECHANICS and nothing more: the README loop plays no
+entrance, end card or sound; a channel that autoplays muted drops the
+bed; the 9:16 cut is a reframe, not a letterbox, and the crop follows
+the camera. Screenshot-genre
 destinations (CWS screenshots, the PH gallery) are the real page at that
 moment, FULL BLEED: no zoom, no tilt, no browser bar, no padding (store
 policy); --composed keeps the cut's camera and chrome instead. --set
@@ -9547,7 +8888,7 @@ lint-gated, so a bad override fails like a bad doc.json):
                        first ready loop (the house backdrop the studio opens on), or a flat ground offline
 `;
 async function loadActions(file) {
-  const raw = JSON.parse(await readFile13(file, "utf8"));
+  const raw = JSON.parse(await readFile14(file, "utf8"));
   const errors = validateActions(raw);
   if (errors.length)
     throw new UsageError(`invalid actions file:
@@ -9603,10 +8944,10 @@ async function cmdRecord(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const outDir = resolve8(strFlag(flags, "out") ?? "take");
+  const outDir = resolve9(strFlag(flags, "out") ?? "take");
   const backdrop = await takeBackdrop(flags, r);
   const maxDurationSeconds = await maxDuration(flags, r);
-  if (existsSync13(join16(outDir, "meta.json"))) {
+  if (existsSync14(join17(outDir, "meta.json"))) {
     const { prevDoc, kept } = await prepareReRecord(outDir);
     r.log(
       `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
@@ -9653,7 +8994,7 @@ async function cmdRecord(argv) {
       },
       strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}` : `Take ready: ${outDir}
   ${(rec.meta.durationMs / 1e3).toFixed(1)}s \xB7 ${rec.frames.length} frames \xB7 ${rec.events.length} cursor events \xB7 ${clicks} clicks \xB7 ${plan.doc.zoom.length} zoom spans planned \xB7 ${rec.freezePct}% frozen${rec.freezePct >= 25 ? " \u26A0 keep motion in frame or trim" : ""}${skippedNote}
-  Next: edit ${join16(outDir, "doc.json")} (optional), then: vos render ${outDir}`
+  Next: edit ${join17(outDir, "doc.json")} (optional), then: vos render ${outDir}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -9677,19 +9018,19 @@ async function cmdCreate2(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const outDir = resolve8(strFlag(flags, "out") ?? "take");
+  const outDir = resolve9(strFlag(flags, "out") ?? "take");
   const fmtRaw = strFlag(flags, "format") ?? "webm";
   if (fmtRaw !== "webm" && fmtRaw !== "mp4")
     throw new UsageError("--format must be webm or mp4");
   const format = fmtRaw;
-  const out = positionals[0] ?? join16(outDir, `out.${format}`);
+  const out = positionals[0] ?? join17(outDir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
   }
   const backdrop = await takeBackdrop(flags, r);
   const maxDurationSeconds = await maxDuration(flags, r);
-  if (existsSync13(join16(outDir, "meta.json"))) {
+  if (existsSync14(join17(outDir, "meta.json"))) {
     const { prevDoc, kept } = await prepareReRecord(outDir);
     r.log(
       `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
@@ -9772,40 +9113,66 @@ async function cmdPlan(argv) {
   const dir = positionals[0];
   if (!dir)
     throw new UsageError(
-      "vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>]"
+      'vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--motion] [--headline "\u2026"] [--launch LAUNCH.md] [--brand BRAND.md]'
     );
   const r = createReporter(flags.json === true);
   if (flags.fresh === true) {
-    await rm4(join16(dir, "doc.json"), { force: true });
+    await rm4(join17(dir, "doc.json"), { force: true });
     r.log("note: --fresh discarded the existing doc.json");
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve8(strFlag(flags, "from") ?? join16(dir, PREV_DOC_NAME));
-    if (!existsSync13(from)) {
+    const from = resolve9(strFlag(flags, "from") ?? join17(dir, PREV_DOC_NAME));
+    if (!existsSync14(from)) {
       throw new UsageError(
         `--reuse: ${from} does not exist \u2014 a re-record into this take writes doc.prev.json, or pass --from <doc.json>`
       );
     }
     reuse = {
       from,
-      doc: JSON.parse(await readFile13(from, "utf8"))
+      doc: JSON.parse(await readFile14(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const backdrop = existsSync13(join16(dir, "doc.json")) ? null : await takeBackdrop(flags, r);
+  const hasDoc = existsSync14(join17(dir, "doc.json"));
+  const backdrop = hasDoc ? null : await takeBackdrop(flags, r);
+  const release = await releaseInputs(dir, flags, r);
+  const motionWanted = !hasDoc || flags.motion === true || flags.fresh === true;
   const s = await planTake(dir, {
     ...style ? { style } : {},
     ...reuse ? { reuse } : {},
-    backdrop
+    backdrop,
+    words: release.words,
+    mark: release.mark,
+    ...motionWanted ? {
+      motion: {
+        words: release.words,
+        launch: release.launchRoles,
+        ink: release.ink,
+        mark: release.mark,
+        captions: release.captions,
+        catalog: release.catalog,
+        again: flags.motion === true
+      }
+    } : {}
   });
+  const layoutLines = s.layout ? `
+  layout from ${s.styleFrom}: ${[
+    s.layout.clips.length ? `${s.layout.clips.length} stage clip(s)` : "",
+    s.layout.lean ? "the rest lean" : "",
+    s.layout.hold ? "the hold" : ""
+  ].filter(Boolean).join(", ")}` + (s.layout.notes.length ? `
+    ${s.layout.notes.join("\n    ")}` : "") : "";
+  const motionLines = s.motion ? (s.motion.notes.length ? `
+  proposed: ${s.motion.notes.join(", ")}` : "") + (s.motion.skipped.length ? `
+  not proposed: ${s.motion.skipped.join("; ")}` : "") : "";
   const reuseLines = s.reuse ? `
   reused ${s.reuse.from}: ${s.reuse.anchored} anchored + ${s.reuse.mapped} mapped span(s)` + (s.reuse.flagged.length ? `
   flagged:
     ${s.reuse.flagged.join("\n    ")}` : "") : "";
   r.done(
     {
-      take: resolve8(dir),
+      take: resolve9(dir),
       fresh: s.fresh,
       cursorKept: s.cursorKept,
       zoomAuto: s.zoomAuto,
@@ -9813,12 +9180,78 @@ async function cmdPlan(argv) {
       duration: s.doc.source.meta.durationMs / 1e3,
       ...s.backdrop !== void 0 ? { backdrop: s.backdrop } : {},
       ...s.styleFrom ? { styleFrom: s.styleFrom, styleFields: s.styleFields } : {},
+      ...s.layout ? { layout: s.layout } : {},
+      ...s.motion ? { motion: s.motion } : {},
       ...s.reuse ? { reuse: s.reuse } : {}
     },
-    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join16(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${reuseLines}`
+    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join17(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}`
   );
   return EXIT_OK;
 }
+async function releaseInputs(dir, flags, r) {
+  let lookPick;
+  try {
+    lookPick = await resolveLook(dir, {
+      look: strFlag(flags, "look"),
+      brand: strFlag(flags, "brand")
+    });
+  } catch (e) {
+    throw new UsageError(e instanceof Error ? e.message : String(e));
+  }
+  const launch = await readLaunchBesideTake(dir, strFlag(flags, "launch"));
+  const lines = (v) => v === null || v === void 0 ? null : v.replace(/\\n/g, "\n");
+  const words = {
+    headline: lines(strFlag(flags, "headline") ?? launch?.roles.headline),
+    kicker: lines(strFlag(flags, "kicker") ?? launch?.roles.kicker),
+    brand: strFlag(flags, "brand-name") ?? lookPick.roles?.wordmark ?? null,
+    release: strFlag(flags, "release") ?? null
+  };
+  if (launch) r.log(`words: ${launch.file}`);
+  const launchRoles = { ...launch?.roles ?? {} };
+  for (const [flag, role] of [
+    ["music", "music"],
+    ["entrance", "entrance"],
+    ["end-card", "endCard"],
+    ["captions", "captions"],
+    ["clicks", "clicks"]
+  ]) {
+    const v = strFlag(flags, flag);
+    if (v !== void 0) launchRoles[role] = v;
+  }
+  const marks = await fetchBrandMarks(dir, lookPick.roles);
+  for (const n of marks.notes) r.log(`note: ${n}`);
+  const mark = lookPick.look?.kind === "dark" ? marks.dark : marks.light;
+  if (mark) r.log(`brand mark: ${mark.key} (${mark.aspect.toFixed(2)}:1)`);
+  const off2 = (v) => v !== void 0 && /^(none|off|no|false)$/i.test(v);
+  let catalog = null;
+  if (launchRoles.music && !off2(launchRoles.music)) {
+    try {
+      catalog = await fetchMusicCatalog(
+        platformOrigin({
+          origin: strFlag(flags, "origin"),
+          api: strFlag(flags, "api")
+        })
+      );
+    } catch (e) {
+      r.log(
+        `music catalog: ${e instanceof Error ? e.message : String(e)} \u2014 no bed`
+      );
+    }
+  }
+  const take = await loadTake(dir);
+  const captions = (take.actions?.steps ?? []).flatMap((st, i) => {
+    const step = st;
+    return typeof step.caption === "string" && step.caption.trim() ? [{ step: i, id: step.id, caption: step.caption.trim() }] : [];
+  });
+  return {
+    words,
+    launchRoles,
+    ink: endCardInk(lookPick.look, lookPick.roles),
+    mark,
+    captions,
+    catalog
+  };
+}
 async function cmdRender(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
@@ -9835,7 +9268,7 @@ async function cmdRender(argv) {
   if (fmtRaw !== "webm" && fmtRaw !== "mp4")
     throw new UsageError("--format must be webm or mp4");
   const format = fmtRaw;
-  const out = positionals[1] ?? join16(dir, `out.${format}`);
+  const out = positionals[1] ?? join17(dir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
@@ -10013,34 +9446,6 @@ async function cmdDeliver(argv) {
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
   }
-  let poster;
-  const posterRef = strFlag(flags, "poster");
-  if (posterRef === "none") {
-    poster = null;
-  } else if (posterRef !== void 0 && templateByName(posterRef)) {
-    poster = { from: `template ${posterRef}`, config: templateByName(posterRef) };
-  } else if (posterRef !== void 0) {
-    if (existsSync13(posterRef)) {
-      poster = {
-        from: resolve8(posterRef),
-        config: JSON.parse(await readFile13(posterRef, "utf8"))
-      };
-    } else {
-      const origin = platformOrigin({
-        origin: strFlag(flags, "origin"),
-        api: strFlag(flags, "api")
-      });
-      const key = await resolveCredential(strFlag(flags, "key"));
-      const res = await apiJson(origin, `/api/vos/${posterRef}/config`, {
-        key
-      });
-      if (!res.config)
-        throw new UsageError(
-          `--poster ${posterRef}: not a file on disk and the platform returned no config`
-        );
-      poster = { from: posterRef, config: res.config };
-    }
-  }
   let lookPick;
   try {
     lookPick = await resolveLook(dir, {
@@ -10052,63 +9457,18 @@ async function cmdDeliver(argv) {
   }
   r.log(`look: ${lookPick.from}`);
   const launch = await readLaunchBesideTake(dir, strFlag(flags, "launch"));
-  const lines = (v) => v === null || v === void 0 ? null : v.replace(/\\n/g, "\n");
-  const words = {
-    headline: lines(strFlag(flags, "headline") ?? launch?.roles.headline),
-    kicker: lines(strFlag(flags, "kicker") ?? launch?.roles.kicker),
-    brand: strFlag(flags, "brand-name") ?? lookPick.roles?.wordmark ?? null,
-    release: strFlag(flags, "release") ?? null
-  };
-  if (launch) r.log(`words: ${launch.file}`);
-  const launchRoles = { ...launch?.roles ?? {} };
-  for (const [flag, role] of [
-    ["music", "music"],
-    ["entrance", "entrance"],
-    ["end-card", "endCard"],
-    ["captions", "captions"],
-    ["clicks", "clicks"]
-  ]) {
-    const v = strFlag(flags, flag);
-    if (v !== void 0) launchRoles[role] = v;
-  }
-  const soundWanted = channels.some(
-    (c) => ["x", "youtube", "shorts-linkedin"].includes(c)
-  );
-  let catalog = null;
-  if (soundWanted && !/^(none|off|no|false)$/i.test(launchRoles.music ?? "") && !/^(none|off|no|false)$/i.test(launchRoles.clicks ?? "")) {
-    try {
-      catalog = await fetchMusicCatalog(
-        platformOrigin({
-          origin: strFlag(flags, "origin"),
-          api: strFlag(flags, "api")
-        })
-      );
-    } catch (e) {
-      r.log(`music catalog: ${e instanceof Error ? e.message : String(e)} \u2014 the cuts stay silent`);
-    }
-  }
-  const captions = (take.actions?.steps ?? []).flatMap((s, i) => {
-    const step = s;
-    return typeof step.caption === "string" && step.caption.trim() ? [{ step: i, id: step.id, caption: step.caption.trim() }] : [];
-  });
+  if (launch) r.log(`launch: ${launch.file}`);
   const browser = await launchBrowser();
   try {
     const result = await deliverTake(browser, dir, {
       look: lookPick.look,
-      brandRoles: lookPick.roles,
-      launchRoles,
-      catalog,
-      captions,
-      words,
+      launchRoles: launch?.roles ?? null,
       channels,
       outDir: strFlag(flags, "out"),
       release: strFlag(flags, "release"),
       times,
       range,
       parallel,
-      poster,
-      posterTime: hasFlag(flags, "poster-time") ? numFlag(flags, "poster-time", 0) : void 0,
-      shotTime: hasFlag(flags, "shot-time") ? numFlag(flags, "shot-time", 0) : void 0,
       composed: hasFlag(flags, "composed"),
       overrides: {
         set: multi.set,
@@ -10126,7 +9486,7 @@ async function cmdDeliver(argv) {
     });
     const { kit } = result;
     const assetLines = kit.assets.map(
-      (a) => `${a.destination} \u2192 ${a.path} (${a.w}x${a.h}, ${(a.bytes / 1024).toFixed(0)} KB${a.seconds !== null ? `, ${a.seconds.toFixed(1)}s` : ""}${a.frameTime !== null ? `, frame ${a.frameTime.toFixed(2)}s` : ""}${a.source === "poster" ? ", poster" : ""})`
+      (a) => `${a.destination} \u2192 ${a.path} (${a.w}x${a.h}, ${(a.bytes / 1024).toFixed(0)} KB${a.seconds !== null ? `, ${a.seconds.toFixed(1)}s` : ""}${a.frameTime !== null ? `, frame ${a.frameTime.toFixed(2)}s` : ""}${a.poster ? `, poster ${a.poster.class}` : ""})`
     );
     const skippedLines = kit.skipped.map((s) => `skipped: ${s}`);
     r.done(
@@ -10149,14 +9509,14 @@ Store uploads stay manual: hand the human this directory and the manifest.`
 async function resolveStyleRef(flags) {
   const styleRef = strFlag(flags, "style");
   if (!styleRef) return null;
-  const file = existsSync13(styleRef) ? resolve8(
+  const file = existsSync14(styleRef) ? resolve9(
     styleRef,
-    existsSync13(join16(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync14(join17(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync13(file)) {
+  if (file && existsSync14(file)) {
     return {
       from: file,
-      doc: JSON.parse(await readFile13(file, "utf8"))
+      doc: JSON.parse(await readFile14(file, "utf8"))
     };
   }
   const origin = platformOrigin({
@@ -10179,7 +9539,7 @@ async function resolveStyleRef(flags) {
     throw new UsageError(`--style: ${styleRef} carries no doc (is it a take?)`);
   return {
     from: `${origin}/vos/${styleRef}`,
-    doc: migrateHostedDoc4(doc.body)
+    doc: migrateHostedDoc5(doc.body)
   };
 }
 async function cmdDigest(argv) {
@@ -10193,7 +9553,7 @@ async function cmdDigest(argv) {
   const take = await loadTake(dir);
   if (!take.doc) throw new UsageError(`${dir} has no doc.json \u2014 run plan first`);
   const transcriptPath = strFlag(flags, "transcript");
-  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile13(transcriptPath, "utf8"))) : null;
+  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile14(transcriptPath, "utf8"))) : null;
   const style = await resolveStyleRef(flags);
   const noFrames = flags["no-frames"] === true;
   let browser = null;
@@ -10224,7 +9584,7 @@ async function cmdDigest(argv) {
         kinds,
         frames: d.images.full,
         crops: d.images.crop,
-        sheet: d.images.sheet ? join16(result.outDir, d.images.sheet) : null,
+        sheet: d.images.sheet ? join17(result.outDir, d.images.sheet) : null,
         scenes: kinds.scene ?? 0,
         sourceDuration: d.take.sourceDuration,
         outputDuration: d.take.outputDuration,
@@ -10248,14 +9608,14 @@ async function cmdOpen(argv) {
   if (!dir) throw new UsageError("vos open <take> [--studio <url>]");
   const r = createReporter(flags.json === true);
   const take = await loadTake(dir);
-  if (!existsSync13(take.paths.recording)) {
+  if (!existsSync14(take.paths.recording)) {
     throw new UsageError(`${dir} has no recording.webm \u2014 re-run record`);
   }
   const studio = (strFlag(flags, "studio") ?? "http://localhost:6060").replace(
     /\/+$/,
     ""
   );
-  const server = await startTakeServer(resolve8(dir), {});
+  const server = await startTakeServer(resolve9(dir), {});
   const url = `${studio}/studio?take=${encodeURIComponent(server.base)}`;
   r.event({ event: "open", server: server.base, url });
   r.log(`take served at ${server.base}`);
@@ -10289,11 +9649,12 @@ async function cmdJudge(argv) {
       "vos judge <kit.json> --against <MANIFEST.json> [--out dir] [--json]\n(the manifest names the reference set: id, file, role, layout, facts, rule per asset)"
     );
   const r = createReporter(flags.json === true);
-  const kitFile = target.endsWith("kit.json") ? target : join16(target, "kit.json");
-  if (!existsSync13(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
-  if (!existsSync13(against)) throw new UsageError(`${against}: no reference manifest`);
+  const kitFile = target.endsWith("kit.json") ? target : join17(target, "kit.json");
+  if (!existsSync14(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
+  if (!existsSync14(against))
+    throw new UsageError(`${against}: no reference manifest`);
   const result = await judgeKit(kitFile, against, strFlag(flags, "out"));
-  const verdicts = JSON.parse(await readFile13(result.verdictFile, "utf8")).verdicts;
+  const verdicts = JSON.parse(await readFile14(result.verdictFile, "utf8")).verdicts;
   const rate = winRate(verdicts);
   const lines = result.sheets.map(
     (s) => `${s.asset} vs ${s.reference}: ${s.sheetA}, ${s.sheetB}, ${s.rubric}`
@@ -10313,7 +9674,7 @@ async function cmdValidate(argv) {
   const target = positionals[0];
   if (!target) throw new UsageError("vos validate <actions.json|take>");
   const r = createReporter(flags.json === true);
-  const kitTarget = target.endsWith("kit.json") ? target : existsSync13(join16(target, "kit.json")) && !isTakeDir(target) ? join16(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync14(join17(target, "kit.json")) && !isTakeDir(target) ? join17(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -10345,9 +9706,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync13(join16(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync14(join17(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile13(join16(target, "config.json"), "utf8")
+      await readFile14(join17(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -10388,7 +9749,7 @@ async function cmdValidate(argv) {
   const take = await loadTake(target);
   const problems = [];
   const warnings = [];
-  if (!existsSync13(take.paths.recording))
+  if (!existsSync14(take.paths.recording))
     problems.push("missing recording.webm (re-run record)");
   if (!take.doc) problems.push("missing doc.json (run plan)");
   if (take.doc) {
@@ -10433,7 +9794,7 @@ async function cmdPush3(argv) {
   const r = createReporter(flags.json === true);
   const overrides = multi.override;
   const result = await pushTake(
-    resolve8(dir),
+    resolve9(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -10447,11 +9808,15 @@ async function cmdPush3(argv) {
     },
     r
   );
+  const pushedTo = platformOrigin({
+    origin: strFlag(flags, "origin"),
+    api: strFlag(flags, "api")
+  }).replace(/\/+$/, "");
   r.done(
     { ...result },
     `pushed v${result.versionNumber} \u2192 vos ${result.vosId}
-  review: https://vos.so/vos/${result.vosId}
-  studio: https://vos.so/studio?vos=${result.vosId}`
+  review: ${pushedTo}/vos/${result.vosId}
+  studio: ${pushedTo}/studio?vos=${result.vosId}`
   );
   return EXIT_OK;
 }
@@ -10460,7 +9825,7 @@ async function cmdPull2(argv) {
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
-    resolve8(dir),
+    resolve9(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -10595,4 +9960,4 @@ export {
   convertAgentBrowser,
   run
 };
-//# sourceMappingURL=chunk-Y7BXFF2W.js.map
+//# sourceMappingURL=chunk-4LLBPFCW.js.map