@vosjs/cli 0.79.0 → 0.80.0

package/dist/{chunk-TWAP4BKR.js → chunk-SP5OHTVB.js}

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  BROWSER_SWITCHES,
   BrowserUnavailableError,
   configDuration,
   directoryKind,
@@ -9,10 +10,12 @@ import {
   reencodeStill,
   renderStill,
   videoFormat
-} from "./chunk-Z6TLHRFQ.js";
+} from "./chunk-B373NVJE.js";
 import {
   PREV_DOC_NAME,
+  PasteFileRefusal,
   RECORDING_NAME,
+  claimablePasteFiles,
   docAudioRefs,
   docLayerRefs,
   docMediaRefs,
@@ -30,8 +33,10 @@ import {
   pullMedia,
   readJson,
   readMediaHead,
+  readPasteFiles,
   recordHostedMedia,
   safePathName,
+  sendPasteFiles,
   sourceSidecarRefs,
   takeMediaFile,
   takePaths,
@@ -40,7 +45,7 @@ import {
   uploadDocRefs,
   uploadManifest,
   writeJson
-} from "./chunk-4ZUHEXUX.js";
+} from "./chunk-PJ6MEJZV.js";
 import {
   CREDENTIALS_PATH,
   MEDIA_HEAD_BYTES,
@@ -87,7 +92,7 @@ import {
 var absolute = (origin, url) => typeof url === "string" && url ? /^https?:/.test(url) ? url : `${origin}${url.startsWith("/") ? "" : "/"}${url}` : null;
 async function waitForLanded(opts) {
   const origin = opts.origin.replace(/\/+$/, "");
-  const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const sleep = opts.sleep ?? ((ms2) => new Promise((r) => setTimeout(r, ms2)));
   const now = opts.now ?? (() => Date.now());
   const timeoutMs = opts.timeoutMs ?? 3e5;
   const intervalMs = opts.intervalMs ?? 4e3;
@@ -139,12 +144,12 @@ function landedLines(l) {
 }
 
 // src/plugin/run.ts
-import { mkdir as mkdir13, readFile as readFile16, rm as rm6 } from "fs/promises";
-import { existsSync as existsSync28 } from "fs";
-import { dirname as dirname11, join as join31, resolve as resolve19 } from "path";
+import { mkdir as mkdir13, readFile as readFile18, rm as rm6 } from "fs/promises";
+import { existsSync as existsSync29 } from "fs";
+import { dirname as dirname11, join as join33, resolve as resolve20 } from "path";
 import {
   END_CARD_FROM as END_CARD_FROM2,
-  docOutputDuration as docOutputDuration4,
+  docOutputDuration as docOutputDuration5,
   migrateHostedDoc as migrateHostedDoc4
 } from "@vosjs/studio-core";
 
@@ -186,6 +191,24 @@ function createReporter(json) {
 
 // src/plugin/actions.ts
 import { validateActions } from "@vosjs/render-core/record";
+function jsSyntaxProblems(actions) {
+  const out = [];
+  const AsyncFunction = Object.getPrototypeOf(async function() {
+  }).constructor;
+  actions.steps.forEach((s, i) => {
+    const js = s.do === "expect" ? s.js : s.do === "await" ? s.until.js : void 0;
+    if (typeof js !== "string") return;
+    try {
+      new AsyncFunction(`return await (${js}
+)`);
+    } catch (e) {
+      out.push(
+        `steps[${i}]: ${s.do === "await" ? "await until.js" : "expect js"} does not parse as an expression (${e instanceof Error ? e.message : String(e)})`
+      );
+    }
+  });
+  return out;
+}
 
 // src/plugin/validateDoc.ts
 import {
@@ -226,7 +249,9 @@ import {
   formatElapsed,
   hasElapsed,
   outputEnd,
+  layerStart,
   resolveAnchor,
+  resolveOverlayAnchors,
   pinBox,
   pinCandidates,
   pinRectOnScreen,
@@ -238,6 +263,9 @@ import {
   snapRunWeight,
   RUN_STYLE_KEYS,
   ratedSegments,
+  replayedSeconds,
+  cameraSpanExtents,
+  spanOutputExtents,
   clipGain,
   recommendedExportResolution,
   resolvePins,
@@ -456,7 +484,7 @@ function lintLoudness(a, name, problems, warnings) {
       `${name}: normalize ${a.normalize} asks for more than +24 dB, the most a target lifts; it plays under its target`
     );
 }
-function checkSpanList(list, label, duration, problems) {
+function checkSpanList(list, label, duration, problems, opts = {}) {
   const sorted = [...list].sort(
     (a, b) => (isNum(a.in) ? a.in : 0) - (isNum(b.in) ? b.in : 0)
   );
@@ -480,6 +508,7 @@ function checkSpanList(list, label, duration, problems) {
       );
     }
   }
+  if (opts.overlap) return;
   for (let i = 1; i < sorted.length; i++) {
     const prev = sorted[i - 1];
     const curr = sorted[i];
@@ -530,11 +559,11 @@ function lintDoc(docIn) {
           `media[${i}]${id ? ` (${id})` : ""}: videoKey must be a string`
         );
       const mm = isObj(m.meta) ? m.meta : {};
-      const ms = isNum(mm.durationMs) ? mm.durationMs : 0;
-      if (id) mediaLen.set(id, ms / 1e3);
+      const ms2 = isNum(mm.durationMs) ? mm.durationMs : 0;
+      if (id) mediaLen.set(id, ms2 / 1e3);
     }
   }
-  const checkByMedia = (list, label) => {
+  const checkByMedia = (list, label, opts = {}) => {
     const groups = /* @__PURE__ */ new Map();
     for (const s of list) {
       const m = typeof s.media === "string" ? s.media : "";
@@ -551,7 +580,8 @@ function lintDoc(docIn) {
         group,
         label,
         m ? mediaLen.get(m) ?? 0 : duration,
-        problems
+        problems,
+        opts
       );
   };
   if (!recording) {
@@ -623,7 +653,7 @@ function lintDoc(docIn) {
       } else {
         const rated = ratedSegments(doc);
         const end = outputEnd(
-          doc,
+          resolveOverlayAnchors(doc, rated),
           rated.reduce((a, s) => a + (s.out - s.in) / (s.rate ?? 1), 0)
         );
         if (st > end + 1e-6)
@@ -705,7 +735,63 @@ function lintDoc(docIn) {
     if (doc.segments !== void 0 && !Array.isArray(doc.segments)) {
       problems.push("segments must be an array of {in, out} spans");
     }
-    checkByMedia(entries(doc.segments), "segment");
+    checkByMedia(entries(doc.segments), "segment", { overlap: true });
+    {
+      const index = [];
+      const pieces = [];
+      for (const [i, seg] of entries(doc.segments).entries()) {
+        if (!isNum(seg.in) || !isNum(seg.out)) continue;
+        index.push(i);
+        pieces.push({
+          in: seg.in,
+          out: seg.out,
+          ...typeof seg.media === "string" ? { media: seg.media } : {}
+        });
+      }
+      const bySegment = /* @__PURE__ */ new Map();
+      for (const r of replayedSeconds(pieces)) {
+        const list = bySegment.get(r.piece) ?? [];
+        list.push(r);
+        bySegment.set(r.piece, list);
+      }
+      for (const [p, spans] of bySegment) {
+        const m = spans[0].media;
+        const which = spans.map((r) => `${r.in.toFixed(2)}\u2013${r.out.toFixed(2)}s`).join(", ");
+        const segs2 = entries(doc.segments);
+        const rests = segs2[index[p]]?.camera === "rest";
+        const restedBefore = pieces.map((q, k) => ({ q, k })).filter(
+          ({ q, k }) => k < p && (q.media ?? "") === m && segs2[index[k]]?.camera === "rest" && spans.some((r) => Math.min(q.out, r.out) > Math.max(q.in, r.in))
+        ).map(({ k }) => `segments[${index[k]}]`);
+        const what = `segments[${index[p]}] replays ${which} of ${m ? `media "${m}"` : "the recording"}`;
+        notes.push(
+          rests ? `${what} with its camera at rest: clicks, freezes and speed spans over those seconds play again, zooms, tilts and cam moves do not` : restedBefore.length ? `${what}, which ${restedBefore.join(" and ")} played with the camera at rest: clicks, freezes and speed spans over those seconds play in every occurrence, zooms, tilts and cam moves only in segments[${index[p]}]` : `${what}: zooms, tilts, clicks, freezes and speed spans over those seconds play in every occurrence`
+        );
+      }
+    }
+    const segList = entries(doc.segments);
+    segList.forEach((seg, i) => {
+      if (seg.camera !== void 0 && seg.camera !== "rest")
+        problems.push(
+          `segments[${i}].camera must be "rest" (the camera rests through this clip's pass); absent = the camera plays here`
+        );
+    });
+    if (segList.some((s) => s.camera === "rest")) {
+      const rated = ratedSegments(doc);
+      for (const [label, list] of [
+        ["zoom", zoom],
+        ["tilt", entries(doc.tilt)],
+        ["camMotion", entries(doc.camMotion)]
+      ]) {
+        for (const s of list) {
+          if (!isNum(s.in) || !isNum(s.out)) continue;
+          const media = typeof s.media === "string" ? s.media : void 0;
+          if (spanOutputExtents(rated, s.in, s.out, media).length && !cameraSpanExtents(rated, s.in, s.out, media).length)
+            warnings.push(
+              `${spanName(label, s)}: it plays only in segments whose camera rests (segments[].camera: "rest"), so it never moves the camera`
+            );
+        }
+      }
+    }
     const segs = Array.isArray(doc.segments) ? doc.segments.filter(isObj) : [];
     segs.forEach((seg, i) => {
       lintAnim(
@@ -1133,8 +1219,10 @@ function lintDoc(docIn) {
         `${name}.kind must be "text" | "image" | "video" | "html" (got ${String(o.kind)})`
       );
     }
-    if (!isNum(o.start) || o.start < 0)
-      problems.push(`${name}.start must be \u2265 0 (OUTPUT seconds)`);
+    if (o.anchor === void 0 || o.start !== void 0) {
+      if (!isNum(o.start) || o.start < 0)
+        problems.push(`${name}.start must be \u2265 0 (OUTPUT seconds)`);
+    }
     if (!isNum(o.duration) || o.duration <= 0) {
       problems.push(`${name}.duration must be > 0 (seconds)`);
     }
@@ -1730,6 +1818,24 @@ function lintDoc(docIn) {
     framingWarnings(docIn, doc, zoom, overlays ?? [], warnings);
   return { problems, warnings, ...notes.length ? { notes } : {} };
 }
+function otherSceneAt(doc, start, anchorMedia) {
+  const segs = Array.isArray(doc.segments) ? doc.segments : [];
+  if (!segs.length) return null;
+  const own = typeof anchorMedia === "string" ? anchorMedia : "";
+  const mediaOf = (i) => segs[i]?.media === void 0 ? "" : String(segs[i].media);
+  const ext2 = segmentOutputExtents(doc);
+  const EPS2 = 1e-3;
+  const at2 = (i) => start >= ext2[i].start - EPS2 && start < ext2[i].end - EPS2;
+  if (ext2.some((_, i) => mediaOf(i) === own && at2(i))) return null;
+  const index = ext2.findIndex((_, i) => mediaOf(i) !== own && at2(i));
+  if (index < 0) return null;
+  const before = ext2.filter((e, i) => mediaOf(i) === own && e.end <= start + EPS2).map((e) => e.end);
+  return {
+    index,
+    media: mediaOf(index),
+    ownEnd: before.length ? Math.max(...before) : null
+  };
+}
 function checkOverlayAnchor(o, name, docIn, recording, pieces, problems, warnings, notes) {
   const fallback = isNum(o.start) ? o.start : null;
   const words2 = o.kind === "text" ? o.text : void 0;
@@ -1765,7 +1871,14 @@ function checkOverlayAnchor(o, name, docIn, recording, pieces, problems, warning
     problems.push(`${name}.anchor.offset must be a number (OUTPUT seconds)`);
     shaped = false;
   }
-  if (!shaped || !recording || !pieces) return fallback;
+  if (!shaped) return fallback;
+  if (!recording || !pieces) {
+    if (fallback === null)
+      problems.push(
+        recording ? `${name}.anchor: the cut could not be read to place step ${JSON.stringify(a.step)}, and the layer has no start to fall back to` : `${name}.anchor: names step ${JSON.stringify(a.step)}, but a program document has no recorder steps, and the layer has no start to fall back to; give it a start`
+      );
+    return fallback;
+  }
   const r = resolveAnchor(
     docIn,
     a,
@@ -1775,9 +1888,21 @@ function checkOverlayAnchor(o, name, docIn, recording, pieces, problems, warning
   const at2 = fallback === null ? "nowhere" : `${fallback.toFixed(2)}s`;
   if (r.start === null) {
     const why = r.miss === "media" ? `media "${String(a.media)}" is not one of media[].id` : r.miss === "step" ? `${step} is not in its meta.steps` : r.miss === "skipped" ? `${step} was skipped by the recorder` : `the cut leaves ${step} out`;
-    warnings.push(
-      `${name}.anchor: ${why}, so it plays at its fallback start (${at2}); re-anchor it, or keep the footage that step plays in`
-    );
+    if (fallback === null)
+      problems.push(
+        `${name}.anchor: ${why}, and the layer has no start to fall back to, so it would play nowhere; re-anchor it, keep the footage that step plays in, or give it a start`
+      );
+    else
+      warnings.push(
+        `${name}.anchor: ${why}, so it plays at its fallback start (${at2}); re-anchor it, or keep the footage that step plays in`
+      );
+  }
+  if (r.start !== null) {
+    const over = otherSceneAt(docIn, r.start, a.media);
+    if (over)
+      warnings.push(
+        `${name}${typeof o.id === "string" ? ` (${o.id})` : ""}: anchored to ${step}, it starts at ${r.start.toFixed(2)}s, ${over.ownEnd === null ? "where" : `after that media's footage there ends (${over.ownEnd.toFixed(2)}s), where`} segments[${over.index}] plays ${over.media ? `media "${over.media}"` : "the recording"}: it speaks over another scene. Anchor it to the step's start (anchor.at: "start"), lower anchor.offset, or keep more of the footage it is about`
+      );
   }
   if (elapsed && r.elapsedFrom && r.elapsedMs !== void 0)
     notes.push(
@@ -1976,7 +2101,9 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
     const zoomTrack = docZoomTrack(docIn);
     const pins = resolvePins(docIn, layout, camera, zoomTrack);
     overlays.forEach((o, i) => {
-      if (!isObj(o) || !isNum(o.start) || !isNum(o.duration)) return;
+      if (!isObj(o) || !isNum(o.duration)) return;
+      const start = o.anchor ? layerStart(o, docIn, rated) : isNum(o.start) ? o.start : null;
+      if (start === null) return;
       const tf = isObj(o.transform) ? o.transform : null;
       if (!tf || !isNum(tf.x) || !isNum(tf.y)) return;
       const pinned = pins.get(String(o.id));
@@ -1996,7 +2123,7 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
         }
         const about = [];
         for (const c of pinCandidates(docIn, {
-          start: o.start,
+          start,
           duration: o.duration
         })) {
           const named = c.selector ? selectorLabelWords(c.selector).filter((x) => words2.has(x)) : [];
@@ -2064,7 +2191,7 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
       );
       for (const { c, key, ev } of presses) {
         const out = spanOutputExtent(rated, c.t, c.t + 1e-3, key || void 0);
-        if (!out || out.start < o.start || out.start > o.start + o.duration)
+        if (!out || out.start < start || out.start > start + o.duration)
           continue;
         const target = pinRectOnScreen(
           {
@@ -2084,8 +2211,8 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
           w: box.w,
           h: box.h
         };
-        const overlaps2 = L.x < target.x + target.w && L.x + L.w > target.x && L.y < target.y + target.h && L.y + L.h > target.y;
-        if (overlaps2) {
+        const overlaps3 = L.x < target.x + target.w && L.x + L.w > target.x && L.y < target.y + target.h && L.y + L.h > target.y;
+        if (overlaps3) {
           warnings.push(
             `overlays[${i}] sits over the thing being clicked at ${c.t.toFixed(1)}s (output ${out.start.toFixed(1)}s) \u2014 pin it to that step (pin: { step }) so it sits beside the target and follows it, or move it off`
           );
@@ -2193,7 +2320,8 @@ import {
   planForDigest as planForDigest2,
   ratedSegments as ratedSegments2,
   resolveExportSize,
-  spanOutputExtent as spanOutputExtent2
+  cameraSpanExtents as cameraSpanExtents2,
+  spanOutputExtents as spanOutputExtents2
 } from "@vosjs/studio-core";
 
 // src/plugin/server.ts
@@ -2300,8 +2428,8 @@ function startTakeServer(rootDir, pages) {
       const size = statSync(file).size;
       const buf = readFileSync(file);
       const type = sniffMediaType(buf.subarray(0, MEDIA_HEAD_BYTES)) ?? MIME[extname(file)] ?? "application/octet-stream";
-      const range = req.headers.range;
-      const m = range && /^bytes=(\d*)-(\d*)$/.exec(range);
+      const range2 = req.headers.range;
+      const m = range2 && /^bytes=(\d*)-(\d*)$/.exec(range2);
       if (m) {
         const start = m[1] ? parseInt(m[1], 10) : 0;
         const end = m[2] ? Math.min(parseInt(m[2], 10), size - 1) : size - 1;
@@ -3234,7 +3362,7 @@ async function digestTake(browser, dir, opts = {}) {
       });
       await page.addInitScript(() => {
         ;
-        globalThis.__name = (f2) => f2;
+        globalThis.__name = (f3) => f3;
       });
       await page.goto(`${server.base}/digest.html`);
       await page.waitForFunction("window.__pageReady__ === true");
@@ -3461,24 +3589,25 @@ function zoomApexes(doc) {
       });
       continue;
     }
-    const ext = spanOutputExtent2(rated, z.in, z.out, z.media);
-    if (!ext) {
+    const exts = cameraSpanExtents2(rated, z.in, z.out, z.media);
+    if (!exts.length) {
       skipped.push({
         id: z.id,
         ...of,
         in: z.in,
         out: z.out,
-        reason: "the cut keeps none of it, so it never plays"
+        reason: spanOutputExtents2(rated, z.in, z.out, z.media).length ? "every pass of it plays in a segment whose camera rests" : "the cut keeps none of it, so it never plays"
       });
       continue;
     }
-    apexes.push({
-      id: z.id,
-      ...of,
-      time: (ext.start + ext.end) / 2,
-      start: ext.start,
-      end: ext.end
-    });
+    for (const ext2 of exts)
+      apexes.push({
+        id: z.id,
+        ...of,
+        time: (ext2.start + ext2.end) / 2,
+        start: ext2.start,
+        end: ext2.end
+      });
   }
   return { apexes, skipped };
 }
@@ -3966,20 +4095,30 @@ import {
   docOutputDuration,
   dropTemplate,
   endCardClips,
+  hasReplay as hasReplay2,
   migrateMotion,
+  momentOutputs as momentOutputs2,
   ratedSegments as ratedSegments4,
   sameMedia,
-  spanOutputExtent as spanOutputExtent4
+  spanOutputExtent as spanOutputExtent3
 } from "@vosjs/studio-core";
 
 // src/plugin/moments.ts
-import { spanOutputExtent as spanOutputExtent3 } from "@vosjs/studio-core";
+import {
+  hasReplay,
+  longestOutputExtent,
+  momentOutputs,
+  spanOutputExtent as spanOutputExtent2
+} from "@vosjs/studio-core";
 var STEP_SETTLE_SECONDS = 0.4;
 function stepOutputTime(rated, step, settle2) {
   const src = step.tEnd + settle2;
-  const ext = spanOutputExtent3(rated, src, src + 1e-3);
-  if (!ext) return null;
-  return ext.start;
+  const ext2 = spanOutputExtent2(rated, src, src + 1e-3);
+  if (!ext2) return null;
+  if (!hasReplay(rated)) return ext2.start;
+  const pass = longestOutputExtent(rated, step.tStart, step.tEnd);
+  const after = pass ? momentOutputs(rated, src).find((o) => o >= pass.start - 1e-6) : void 0;
+  return after ?? ext2.start;
 }
 
 // src/plugin/motionPlan.ts
@@ -4049,18 +4188,26 @@ function pickTrack(catalog, ask) {
   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) {
+function clickTimes(doc, range2) {
   const rated = ratedSegments4(doc);
-  const out = [];
+  const replayed = hasReplay2(rated);
+  const at2 = [];
   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 (replayed) {
+      at2.push(...momentOutputs2(rated, src));
+      continue;
+    }
+    const ext2 = spanOutputExtent3(rated, src, src + 1e-3);
+    if (ext2) at2.push(ext2.start);
+  }
+  if (replayed) at2.sort((a, b) => a - b);
+  const out = [];
+  for (const t of at2) {
+    if (t < range2[0] || t > range2[1]) continue;
     if (out.length && t - out[out.length - 1] < 0.12) continue;
-    out.push(+(t - range[0]).toFixed(3));
+    out.push(+(t - range2[0]).toFixed(3));
   }
   return out;
 }
@@ -4102,7 +4249,7 @@ function proposeMotion(input, opts) {
   const notes = [];
   const skipped = [];
   const footage = outputLength(doc);
-  const range = [0, footage];
+  const range2 = [0, footage];
   const entrance = launch.entrance;
   delete doc.frame.entrance;
   if (!off(entrance)) {
@@ -4257,7 +4404,7 @@ function proposeMotion(input, opts) {
   }
   const click = catalog?.sfx.find((s) => s.slug === "sfx-click");
   if (click && !doc.source.micKey && !off(launch.clicks)) {
-    const times = clickTimes(doc, range);
+    const times = clickTimes(doc, range2);
     for (const [i, t] of times.entries()) {
       clips.push({
         id: `${CLICK_ID_PREFIX}${i}`,
@@ -4460,11 +4607,11 @@ async function deliverTake(browser, dir, opts) {
       );
       continue;
     }
-    let range = opts.range;
+    let range2 = opts.range;
     let seconds = videoSeconds;
     if (d.maxSeconds !== void 0 && videoSeconds > d.maxSeconds) {
       if (LOOP_DESTINATIONS.has(d.id) && !opts.range) {
-        range = [0, d.maxSeconds];
+        range2 = [0, d.maxSeconds];
         seconds = d.maxSeconds;
         opts.onPhase?.(
           `note: ${label} takes the first ${d.maxSeconds}s of the ${videoSeconds.toFixed(0)}s take (a loop's cap)`
@@ -4484,7 +4631,7 @@ async function deliverTake(browser, dir, opts) {
       height: d.px.h,
       format: "mp4",
       parallel: opts.parallel,
-      range,
+      range: range2,
       bitrate,
       overrides: videoOverrides(d),
       onProgress: opts.onProgress
@@ -4571,7 +4718,7 @@ async function browserLogin(origin, r, opts) {
   if (opts.openBrowser && verifyUrlOk(verifyUrl, origin))
     void launchDefaultBrowser(verifyUrl);
   r.log("Waiting for approval\u2026 (Ctrl-C to cancel)");
-  const sleep = opts.sleep ?? ((ms) => new Promise((res) => setTimeout(res, ms)));
+  const sleep = opts.sleep ?? ((ms2) => new Promise((res) => setTimeout(res, ms2)));
   let intervalMs = baseIntervalMs;
   let failures = 0;
   let capNoted = false;
@@ -4673,8 +4820,8 @@ function markExtension(url) {
   const e = m[1].toLowerCase();
   return e === "jpeg" ? "jpg" : e;
 }
-function imageAspect(bytes, ext) {
-  if (ext === "svg") {
+function imageAspect(bytes, ext2) {
+  if (ext2 === "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
@@ -4686,11 +4833,11 @@ function imageAspect(bytes, ext) {
     return null;
   }
   const dv = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-  if (ext === "png") {
+  if (ext2 === "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 (ext2 === "webp") {
     if (bytes.length < 30) return null;
     const tag = String.fromCharCode(...bytes.subarray(12, 16));
     if (tag === "VP8X")
@@ -4709,7 +4856,7 @@ function imageAspect(bytes, ext) {
       );
     return null;
   }
-  if (ext === "jpg") {
+  if (ext2 === "jpg") {
     let i = 2;
     while (i + 9 < bytes.length) {
       if (bytes[i] !== 255) return null;
@@ -4733,8 +4880,8 @@ async function fetchBrandMarks(takeDir, roles) {
   const one = async (role, name) => {
     const src = (roles[role] ?? "").trim();
     if (!src) return null;
-    const ext = markExtension(src);
-    if (!ext) {
+    const ext2 = markExtension(src);
+    if (!ext2) {
       out.notes.push(
         `${role}: ${src} is not an svg, png, webp or jpg; the wordmark stands in`
       );
@@ -4757,7 +4904,7 @@ async function fetchBrandMarks(takeDir, roles) {
       );
       return null;
     }
-    const aspect = imageAspect(bytes, ext);
+    const aspect = imageAspect(bytes, ext2);
     if (!aspect) {
       out.notes.push(
         `${role}: ${src} has no readable size; the wordmark stands in`
@@ -4765,8 +4912,8 @@ async function fetchBrandMarks(takeDir, roles) {
       return null;
     }
     await mkdir4(join5(takeDir, "brand"), { recursive: true });
-    await writeFile6(join5(takeDir, "brand", `${name}.${ext}`), bytes);
-    return { key: `/brand/${name}.${ext}`, aspect };
+    await writeFile6(join5(takeDir, "brand", `${name}.${ext2}`), bytes);
+    return { key: `/brand/${name}.${ext2}`, aspect };
   };
   out.light = await one("logoUrl", "mark");
   out.dark = await one("logoOnDarkUrl", "mark-on-dark");
@@ -4829,11 +4976,12 @@ import {
   docCardLayout as docCardLayout2,
   docZoomTrack as docZoomTrack2,
   hexToRgb,
+  layerStart as layerStart2,
   parseCssColour,
   pinBox as pinBox2,
   ratedSegments as ratedSegments5,
   resolvePins as resolvePins2,
-  spanOutputExtent as spanOutputExtent5
+  longestOutputExtent as longestOutputExtent2
 } from "@vosjs/studio-core";
 
 // src/plugin/picture.ts
@@ -5238,15 +5386,15 @@ function windowForStep(doc, step, seconds = CALLOUT_DEFAULT_SECONDS) {
   const s = steps.find((x) => x.id !== void 0 && x.id === step) ?? steps.find((x) => String(x.step) === String(step));
   if (!s || s.skipped) return null;
   const rated = ratedSegments5(doc);
-  const ext = spanOutputExtent5(rated, s.tStart, s.tEnd);
-  if (!ext) return null;
-  const at2 = s.do === "click" || s.do === "drag" ? ext.start : ext.end;
+  const ext2 = longestOutputExtent2(rated, s.tStart, s.tEnd);
+  if (!ext2) return null;
+  const at2 = s.do === "click" || s.do === "drag" ? ext2.start : ext2.end;
   const start = +(at2 + CALLOUT_LEAD_SECONDS).toFixed(3);
   let end = start + seconds;
   for (const n of steps) {
     if (n.tStart <= s.tStart) continue;
     if (n.do !== "scroll" && !n.navigated) continue;
-    const ne = spanOutputExtent5(rated, n.tStart, n.tEnd);
+    const ne = longestOutputExtent2(rated, n.tStart, n.tEnd);
     if (ne && ne.start > start && ne.start < end) end = ne.start - 0.05;
   }
   return { start, duration: +Math.max(0.5, end - start).toFixed(3) };
@@ -5307,6 +5455,19 @@ function composeCallout(doc, register, ask) {
 function isCalloutShape(s) {
   return CALLOUT_SHAPES.includes(s);
 }
+function groundTime(start, duration) {
+  return +(start + Math.min(0.35, duration / 2)).toFixed(3);
+}
+function groundCheckTimes(doc) {
+  const rated = ratedSegments5(doc);
+  const times = /* @__PURE__ */ new Set();
+  for (const o of doc.overlays ?? []) {
+    if (o.kind !== "html") continue;
+    const start = layerStart2(o, doc, rated);
+    if (start !== null) times.add(groundTime(start, o.duration));
+  }
+  return [...times];
+}
 async function groundFindings(doc, frameAt) {
   const out = [];
   const overlays = doc.overlays ?? [];
@@ -5314,9 +5475,12 @@ async function groundFindings(doc, frameAt) {
   const camera = cameraModel2(doc.frame);
   const track = docZoomTrack2(doc);
   const pins = resolvePins2(doc, layout, camera, track);
+  const rated = ratedSegments5(doc);
   for (let i = 0; i < overlays.length; i++) {
     const o = overlays[i];
     if (o.kind !== "html") continue;
+    const start = layerStart2(o, doc, rated);
+    if (start === null) continue;
     const card = calloutGroundOf(o.css ?? "");
     if (!card) {
       out.push({
@@ -5330,7 +5494,7 @@ async function groundFindings(doc, frameAt) {
       });
       continue;
     }
-    const t = o.start + Math.min(0.35, o.duration / 2);
+    const t = groundTime(start, o.duration);
     const img = await frameAt(t);
     if (!img) {
       out.push({
@@ -5349,7 +5513,7 @@ async function groundFindings(doc, frameAt) {
     let cx = o.transform.x * layout.W;
     let cy = o.transform.y * layout.H;
     if (pinned) {
-      const v = sample(pinned.track, t - o.start, lerpArray);
+      const v = sample(pinned.track, t - start, lerpArray);
       cx = v[0] * layout.W;
       cy = v[1] * layout.H;
     }
@@ -5654,161 +5818,13 @@ async function validateKit(kitPath, opts = {}) {
 // src/plugin/recorder.ts
 import { writeFileSync } from "fs";
 import { lstat, mkdir as mkdir5, readFile as readFile8, realpath } from "fs/promises";
-import { join as join8, resolve as resolve6, sep as sep2 } from "path";
+import { join as join10, resolve as resolve6, sep as sep2 } from "path";
 import {
   fileNameProblem,
   inlineScript,
   loadScriptFiles,
   recordTake as recordTakeCore
 } from "@vosjs/render-core/record";
-function outputsSink(dir) {
-  const outDir = join8(dir, "outputs");
-  return {
-    save: async (name, bytes) => {
-      const problem = fileNameProblem(name);
-      if (problem) throw new Error(`outputs/${name}: ${problem}`);
-      await refuseSymlink(outDir);
-      await mkdir5(outDir, { recursive: true });
-      await writeFileSafe(join8(outDir, name), bytes);
-    }
-  };
-}
-var PAGE_SOUND_DIR = "page-sound";
-function pageSoundSink(dir) {
-  const soundDir = join8(dir, PAGE_SOUND_DIR);
-  return {
-    save: async (name, bytes) => {
-      const problem = fileNameProblem(name);
-      if (problem) throw new Error(`${PAGE_SOUND_DIR}/${name}: ${problem}`);
-      await refuseSymlink(soundDir);
-      await mkdir5(soundDir, { recursive: true });
-      await writeFileSafe(join8(soundDir, name), bytes);
-      return `${PAGE_SOUND_DIR}/${name}`;
-    }
-  };
-}
-function actionsDirFiles(dir) {
-  return {
-    read: async (name) => {
-      const problem = fileNameProblem(name);
-      if (problem) throw new Error(problem);
-      const file = join8(dir, name);
-      if ((await lstat(file)).isSymbolicLink())
-        throw new Error(
-          `${name} is a symbolic link, which a script never follows`
-        );
-      const [real, root] = await Promise.all([realpath(file), realpath(dir)]);
-      if (!real.startsWith(root + sep2))
-        throw new Error(`${name} resolves outside the actions file's directory`);
-      return new Uint8Array(await readFile8(real));
-    }
-  };
-}
-var pasteCopyName = (name) => name.startsWith("paste-") ? name : `paste-${name}`;
-async function keepPasteFiles(actions, actionsDir, takeDir) {
-  if (!actions.steps.some((s) => s.do === "paste" && s.file)) return actions;
-  const files = actionsDirFiles(actionsDir);
-  const steps = await Promise.all(
-    actions.steps.map(async (s) => {
-      if (s.do !== "paste" || !s.file) return s;
-      const name = pasteCopyName(s.file);
-      const same = resolve6(actionsDir) === resolve6(takeDir) && name === s.file;
-      if (!same)
-        await writeFileSafe(join8(takeDir, name), await files.read(s.file));
-      return { ...s, file: name };
-    })
-  );
-  return { ...actions, steps };
-}
-async function scriptForHost(actions, actionsDir) {
-  const pathsOnly = {
-    steps: actions.steps.map(
-      (s) => s.do === "paste" ? { do: "wait", ms: 0 } : s
-    )
-  };
-  const files = await loadScriptFiles(pathsOnly, actionsDirFiles(actionsDir));
-  if ("problem" in files) throw new Error(files.problem);
-  return inlineScript(actions, files);
-}
-async function recordTake(browser, url, actions, paths, log, opts = {}) {
-  const dry = opts.dryRun === true;
-  const result = await recordTakeCore(
-    browser,
-    url,
-    actions,
-    {
-      frame: (file, bytes) => {
-        writeFileSync(join8(paths.framesDir, file), bytes);
-      }
-    },
-    log,
-    {
-      ...opts,
-      outputs: outputsSink(paths.dir),
-      sounds: pageSoundSink(paths.dir),
-      ...opts.actionsDir ? { files: actionsDirFiles(opts.actionsDir) } : {},
-      env: process.env,
-      platform: process.platform === "darwin" ? "mac" : process.platform === "win32" ? "windows" : "linux"
-    }
-  );
-  if (!dry) {
-    if (opts.actionsDir)
-      result.actions = await keepPasteFiles(
-        result.actions,
-        opts.actionsDir,
-        paths.dir
-      );
-    await writeJson(paths.cursor, result.events);
-    await writeJson(paths.meta, result.meta, true);
-    await writeJson(paths.framesIndex, result.frames);
-    await writeJson(paths.actions, result.actions, true);
-  }
-  return result;
-}
-
-// src/plugin/run.ts
-import {
-  RecordRefusedError,
-  guardVerdict,
-  guardedSteps,
-  hostedRefusals,
-  readyProblem,
-  overrunLine
-} from "@vosjs/render-core/record";
-
-// src/plugin/wall.ts
-import {
-  WALL_PROBE,
-  WallError,
-  isIdpHost,
-  isSignInPath,
-  redirectedAway,
-  wallVerdict
-} from "@vosjs/render-core/record";
-
-// src/plugin/exposure.ts
-import {
-  EXPOSURE_ADVICE,
-  EXPOSURE_MATCHERS_SRC,
-  EXPOSURE_PROBE,
-  ExposureLog,
-  NoticeLog,
-  exposureLine,
-  maskInitScript,
-  noticeAdvice,
-  noticeLine
-} from "@vosjs/render-core/record";
-
-// src/plugin/setup.ts
-import {
-  SetupEnvError,
-  SetupError,
-  parseHeaders,
-  resolveSetupText,
-  runSetup,
-  setupEnvNames,
-  validateSetup
-} from "@vosjs/render-core/record";
 
 // src/plugin/session.ts
 import { spawn } from "child_process";
@@ -5821,13 +5837,13 @@ import {
   statSync as statSync2
 } from "fs";
 import { homedir, tmpdir } from "os";
-import { join as join10 } from "path";
+import { join as join9 } from "path";
 import { chromium } from "playwright";
 
 // src/plugin/sessionWindow.ts
 import { execFile as execFile2 } from "child_process";
 import { existsSync as existsSync8 } from "fs";
-import { join as join9 } from "path";
+import { join as join8 } from "path";
 import { createInterface } from "readline";
 function parseProcessTable(out) {
   const rows = [];
@@ -5863,19 +5879,19 @@ function chromeTree(rows, pid) {
 }
 function readChromeTree(pid) {
   if (process.platform === "win32") return Promise.resolve(null);
-  return new Promise((resolve20) => {
+  return new Promise((resolve21) => {
     execFile2(
       "ps",
       ["-A", "-o", "pid=", "-o", "ppid=", "-o", "command="],
       { maxBuffer: 16 * 1024 * 1024, timeout: 5e3 },
       (err, stdout) => {
-        if (err) resolve20(null);
-        else resolve20(chromeTree(parseProcessTable(stdout), pid));
+        if (err) resolve21(null);
+        else resolve21(chromeTree(parseProcessTable(stdout), pid));
       }
     );
   });
 }
-async function helpersGone(pids, ms = 1e4, sleep = realSleep) {
+async function helpersGone(pids, ms2 = 1e4, sleep = realSleep) {
   const alive = (p) => {
     try {
       process.kill(p, 0);
@@ -5884,10 +5900,10 @@ async function helpersGone(pids, ms = 1e4, sleep = realSleep) {
       return e.code === "EPERM";
     }
   };
-  const until = Date.now() + ms;
+  const until = Date.now() + ms2;
   while (pids.some(alive) && Date.now() < until) await sleep(100);
 }
-var realSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var realSleep = (ms2) => new Promise((r) => setTimeout(r, ms2));
 async function waitForFinish(w) {
   const sleep = w.sleep ?? realSleep;
   const pollMs = w.pollMs ?? 1e3;
@@ -5972,7 +5988,7 @@ function enterPressed() {
     } };
   const rl = createInterface({ input: process.stdin });
   const pressed = new Promise(
-    (resolve20) => rl.once("line", () => resolve20())
+    (resolve21) => rl.once("line", () => resolve21())
   );
   return { pressed, close: () => rl.close() };
 }
@@ -6004,8 +6020,8 @@ function cookieReport(state, rows, host) {
 }
 function cookieStore(profileDir) {
   for (const p of [
-    join9(profileDir, "Default", "Network", "Cookies"),
-    join9(profileDir, "Default", "Cookies")
+    join8(profileDir, "Default", "Network", "Cookies"),
+    join8(profileDir, "Default", "Cookies")
   ])
     if (existsSync8(p)) return p;
   return null;
@@ -6061,8 +6077,18 @@ function cookieWatch(profileDir, host, log) {
   };
 }
 
+// src/plugin/wall.ts
+import {
+  WALL_PROBE,
+  WallError,
+  isIdpHost,
+  isSignInPath,
+  redirectedAway,
+  wallVerdict
+} from "@vosjs/render-core/record";
+
 // src/plugin/session.ts
-var SESSIONS_DIR = join10(homedir(), ".config", "vos", "sessions");
+var SESSIONS_DIR = join9(homedir(), ".config", "vos", "sessions");
 var NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/i;
 function sessionNameVerdict(name) {
   if (!name) return "a session needs a name: --name <app>";
@@ -6071,20 +6097,20 @@ function sessionNameVerdict(name) {
   return null;
 }
 function sessionDir(name) {
-  return join10(SESSIONS_DIR, name);
+  return join9(SESSIONS_DIR, name);
 }
 function systemChromePath() {
   const explicit = process.env.VOS_BROWSER_PATH;
   if (explicit) return explicit;
   const candidates = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : process.platform === "win32" ? [
-    join10(
+    join9(
       process.env["PROGRAMFILES"] ?? "C:\\Program Files",
       "Google",
       "Chrome",
       "Application",
       "chrome.exe"
     ),
-    join10(
+    join9(
       process.env["LOCALAPPDATA"] ?? "",
       "Google",
       "Chrome",
@@ -6135,14 +6161,14 @@ async function openSessionWindow(opts) {
   const child = spawn(exe, args, { stdio: "ignore" });
   let failed = null;
   let code = null;
-  const exited = new Promise((resolve20) => {
+  const exited = new Promise((resolve21) => {
     child.once("exit", (c) => {
       code = c;
-      resolve20();
+      resolve21();
     });
     child.once("error", (e) => {
       failed = e;
-      resolve20();
+      resolve21();
     });
   });
   try {
@@ -6189,6 +6215,7 @@ async function withProfile(dir, fn, opts = {}) {
     ...explicit ? { executablePath: explicit } : { channel: "chrome" },
     // The real keychain: the whole reason a profile Chrome wrote can be read.
     ignoreDefaultArgs: ["--use-mock-keychain"],
+    args: [...BROWSER_SWITCHES],
     ...opts.viewport ? { viewport: opts.viewport, deviceScaleFactor: 1 } : {}
   });
   try {
@@ -6235,7 +6262,7 @@ async function profileVerdict(dir, url) {
   return sessionVerdictOf(null, stranger);
 }
 async function strangerWall(url) {
-  const dir = mkdtempSync(join10(tmpdir(), "vos-stranger-"));
+  const dir = mkdtempSync(join9(tmpdir(), "vos-stranger-"));
   try {
     return await withProfile(dir, (ctx) => arrivalWall(ctx, url));
   } finally {
@@ -6298,7 +6325,7 @@ function summaryLine(s) {
 function listSessions() {
   if (!existsSync9(SESSIONS_DIR)) return [];
   return readdirSync(SESSIONS_DIR, { withFileTypes: true }).filter((d) => d.isDirectory() && NAME.test(d.name)).map((d) => {
-    const st = statSync2(join10(SESSIONS_DIR, d.name));
+    const st = statSync2(join9(SESSIONS_DIR, d.name));
     return {
       name: d.name,
       ageDays: Math.floor(
@@ -6319,33 +6346,201 @@ function looksLikeStorageState(value) {
   return Array.isArray(v.cookies) && Array.isArray(v.origins);
 }
 
-// src/plugin/recordingCap.ts
-import {
-  capReached,
-  cappedLine,
-  clampWait,
-  formatDurationCap
-} from "@vosjs/render-core/record";
-var HOSTED_RECORDING_CAP_SECONDS = 30 * 60;
-function parseHostedCap(body) {
-  const limits = body && typeof body === "object" ? body.limits : void 0;
-  const cap = limits?.recordingMaxSeconds;
-  return typeof cap === "number" && Number.isInteger(cap) && cap > 0 ? cap : null;
+// src/plugin/recorder.ts
+function outputsSink(dir) {
+  const outDir = join10(dir, "outputs");
+  return {
+    save: async (name, bytes) => {
+      const problem = fileNameProblem(name);
+      if (problem) throw new Error(`outputs/${name}: ${problem}`);
+      await refuseSymlink(outDir);
+      await mkdir5(outDir, { recursive: true });
+      await writeFileSafe(join10(outDir, name), bytes);
+    }
+  };
 }
-async function hostedRecordingCap(origin, key, fetchImpl = fetch) {
-  const ctl = new AbortController();
-  const timer = setTimeout(() => ctl.abort(), 2e3);
-  try {
-    const res = await fetchImpl(`${origin.replace(/\/+$/, "")}/api/limits`, {
-      signal: ctl.signal,
-      headers: bearerFor(key, origin)
-    });
-    if (!res.ok) return null;
-    return parseHostedCap(await res.json());
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timer);
+var PAGE_SOUND_DIR = "page-sound";
+function pageSoundSink(dir) {
+  const soundDir = join10(dir, PAGE_SOUND_DIR);
+  return {
+    save: async (name, bytes) => {
+      const problem = fileNameProblem(name);
+      if (problem) throw new Error(`${PAGE_SOUND_DIR}/${name}: ${problem}`);
+      await refuseSymlink(soundDir);
+      await mkdir5(soundDir, { recursive: true });
+      await writeFileSafe(join10(soundDir, name), bytes);
+      return `${PAGE_SOUND_DIR}/${name}`;
+    }
+  };
+}
+function actionsDirFiles(dir) {
+  return {
+    read: async (name) => {
+      const problem = fileNameProblem(name);
+      if (problem) throw new Error(problem);
+      const file = join10(dir, name);
+      if ((await lstat(file)).isSymbolicLink())
+        throw new Error(
+          `${name} is a symbolic link, which a script never follows`
+        );
+      const [real, root] = await Promise.all([realpath(file), realpath(dir)]);
+      if (!real.startsWith(root + sep2))
+        throw new Error(`${name} resolves outside the actions file's directory`);
+      return new Uint8Array(await readFile8(real));
+    }
+  };
+}
+function peerStateFrom(dir) {
+  return async (name) => {
+    const file = resolve6(dir, name);
+    let raw;
+    try {
+      raw = await readFile8(file, "utf8");
+    } catch {
+      throw new Error(
+        `there is no file at ${file}; a storage state is never copied into a take, so name it by a path from the actions file (or an absolute one, such as one saved under ~/.config/vos)`
+      );
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      parsed = null;
+    }
+    if (!looksLikeStorageState(parsed))
+      throw new Error(
+        `${file} is not a Playwright storage state ({ cookies, origins }); save one with context.storageState({ path })`
+      );
+    return file;
+  };
+}
+var pasteCopyName = (name) => name.startsWith("paste-") ? name : `paste-${name}`;
+async function keepPasteFiles(actions, actionsDir, takeDir) {
+  if (!actions.steps.some((s) => s.do === "paste" && s.file)) return actions;
+  const files = actionsDirFiles(actionsDir);
+  const steps = await Promise.all(
+    actions.steps.map(async (s) => {
+      if (s.do !== "paste" || !s.file) return s;
+      const name = pasteCopyName(s.file);
+      const same = resolve6(actionsDir) === resolve6(takeDir) && name === s.file;
+      if (!same)
+        await writeFileSafe(join10(takeDir, name), await files.read(s.file));
+      return { ...s, file: name };
+    })
+  );
+  return { ...actions, steps };
+}
+async function scriptForHost(actions, actionsDir) {
+  const pathsOnly = {
+    steps: actions.steps.map(
+      (s) => s.do === "paste" ? { do: "wait", ms: 0 } : s
+    )
+  };
+  const files = await loadScriptFiles(pathsOnly, actionsDirFiles(actionsDir));
+  if ("problem" in files) throw new Error(files.problem);
+  return inlineScript(actions, files);
+}
+async function recordTake(browser, url, actions, paths, log, opts = {}) {
+  const dry = opts.dryRun === true;
+  const result = await recordTakeCore(
+    browser,
+    url,
+    actions,
+    {
+      frame: (file, bytes) => {
+        writeFileSync(join10(paths.framesDir, file), bytes);
+      }
+    },
+    log,
+    {
+      ...opts,
+      outputs: outputsSink(paths.dir),
+      sounds: pageSoundSink(paths.dir),
+      ...opts.actionsDir ? {
+        files: actionsDirFiles(opts.actionsDir),
+        peerStorageState: peerStateFrom(opts.actionsDir)
+      } : {},
+      env: process.env,
+      platform: process.platform === "darwin" ? "mac" : process.platform === "win32" ? "windows" : "linux"
+    }
+  );
+  if (!dry) {
+    if (opts.actionsDir)
+      result.actions = await keepPasteFiles(
+        result.actions,
+        opts.actionsDir,
+        paths.dir
+      );
+    await writeJson(paths.cursor, result.events);
+    await writeJson(paths.meta, result.meta, true);
+    await writeJson(paths.framesIndex, result.frames);
+    await writeJson(paths.actions, result.actions, true);
+  }
+  return result;
+}
+
+// src/plugin/run.ts
+import {
+  RecordRefusedError,
+  guardVerdict,
+  guardedSteps,
+  hostedRefusals,
+  readyProblem,
+  overrunLine,
+  sayValue
+} from "@vosjs/render-core/record";
+
+// src/plugin/exposure.ts
+import {
+  EXPOSURE_ADVICE,
+  EXPOSURE_MATCHERS_SRC,
+  EXPOSURE_PROBE,
+  ExposureLog,
+  NoticeLog,
+  exposureLine,
+  maskInitScript,
+  noticeAdvice,
+  noticeLine
+} from "@vosjs/render-core/record";
+
+// src/plugin/setup.ts
+import {
+  SetupEnvError,
+  SetupError,
+  parseHeaders,
+  resolveSetupText,
+  runSetup,
+  setupEnvNames,
+  validateSetup
+} from "@vosjs/render-core/record";
+
+// src/plugin/recordingCap.ts
+import {
+  capReached,
+  cappedLine,
+  clampWait,
+  formatDurationCap
+} from "@vosjs/render-core/record";
+var HOSTED_RECORDING_CAP_SECONDS = 30 * 60;
+function parseHostedCap(body) {
+  const limits = body && typeof body === "object" ? body.limits : void 0;
+  const cap = limits?.recordingMaxSeconds;
+  return typeof cap === "number" && Number.isInteger(cap) && cap > 0 ? cap : null;
+}
+async function hostedRecordingCap(origin, key, fetchImpl = fetch) {
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), 2e3);
+  try {
+    const res = await fetchImpl(`${origin.replace(/\/+$/, "")}/api/limits`, {
+      signal: ctl.signal,
+      headers: bearerFor(key, origin)
+    });
+    if (!res.ok) return null;
+    return parseHostedCap(await res.json());
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
   }
 }
 function defaultMaxDurationSeconds() {
@@ -6408,12 +6603,30 @@ var AFTER_STEP = 1;
 var LAYER_AFTER_STEP = 5;
 var WINDOW_SLACK = 0.05;
 var LAYER_DRIFT = 0.5;
-function matchStep(old, newSteps) {
+function matchByNeighbour(old, newSteps, oldSteps) {
+  const named = oldSteps.filter(
+    (s) => s.id && newSteps.some((n) => n.id === s.id && !n.skipped)
+  );
+  const before = named.filter((s) => s.step < old.step).sort((a, b) => b.step - a.step)[0];
+  const after = named.filter((s) => s.step > old.step).sort((a, b) => a.step - b.step)[0];
+  const found = [before, after].flatMap((anchor) => {
+    if (!anchor) return [];
+    const now = newSteps.find((n) => n.id === anchor.id);
+    const hit = newSteps.find(
+      (n) => n.step === now.step + old.step - anchor.step
+    );
+    return hit && !hit.skipped && !hit.id && hit.do === old.do && hit.selector === old.selector ? [hit] : [];
+  });
+  return found.length && found.every((h) => h === found[0]) ? found[0] : null;
+}
+function matchStep(old, newSteps, oldSteps = []) {
   const usable = (s) => !!s && s.skipped !== true;
   if (old.id) {
     const byId = newSteps.find((s) => s.id === old.id);
     return usable(byId) ? byId : null;
   }
+  const near2 = matchByNeighbour(old, newSteps, oldSteps);
+  if (near2) return near2;
   const atIndex = newSteps.find((s) => s.step === old.step);
   if (usable(atIndex) && atIndex.do === old.do && atIndex.selector === old.selector) {
     return atIndex;
@@ -6445,7 +6658,7 @@ function buildStepMap(oldSteps, newSteps, oldDuration, newDuration) {
   let matched = 0;
   for (const old of oldSteps) {
     if (old.skipped) continue;
-    const hit = matchStep(old, newSteps);
+    const hit = matchStep(old, newSteps, oldSteps);
     if (!hit) {
       unmatched.push(old);
       continue;
@@ -6505,7 +6718,7 @@ function placeMoment(t, anchor, ctx) {
   }
   const under = stepUnder(t, ctx.oldSteps);
   if (under) {
-    const hit = matchStep(under, ctx.newSteps);
+    const hit = matchStep(under, ctx.newSteps, ctx.oldSteps);
     if (!hit) return { gone: under };
     ctx.report.anchored++;
     return { at: hit.tStart + (t - under.tStart), via: "step" };
@@ -6660,8 +6873,8 @@ function retimeOverlays(prev, next, report) {
   const newDuration = next.source.meta.durationMs / 1e3;
   const stepMap = buildStepMap(oldSteps, newSteps, oldDuration, newDuration);
   const ctx = { oldSteps, newSteps, stepMap, report };
-  const follow = (o, oldRef, newRef) => {
-    const offset = o.start - sourceToOutput(oldPieces, oldRef);
+  const follow = (o, from, oldRef, newRef) => {
+    const offset = from - sourceToOutput(oldPieces, oldRef);
     const start = Math.max(0, sourceToOutput(newPieces, newRef) + offset);
     return { ...o, start: +start.toFixed(3) };
   };
@@ -6670,54 +6883,56 @@ function retimeOverlays(prev, next, report) {
       const r = resolveLayerAnchor(next, o.anchor, newPieces);
       if (r.start === null) {
         report.flagged.push(
-          `overlay ${o.id}: anchored to step ${String(o.anchor.step)}, which is missing, skipped or cut in the new recording \u2014 it plays at its fallback ${o.start.toFixed(2)}s; re-anchor or re-place it`
+          o.start === void 0 ? `overlay ${o.id}: anchored to step ${String(o.anchor.step)}, which is missing, skipped or cut in the new recording \u2014 it has no start to fall back to, so it plays nowhere; re-anchor it or give it a start` : `overlay ${o.id}: anchored to step ${String(o.anchor.step)}, which is missing, skipped or cut in the new recording \u2014 it plays at its fallback ${o.start.toFixed(2)}s; re-anchor or re-place it`
         );
         return o;
       }
       report.anchored++;
-      return { ...o, start: r.start };
+      return o.start === void 0 ? o : { ...o, start: r.start };
     }
+    const at2 = o.start;
+    if (at2 === void 0) return o;
     const pin = o.pin;
     if (pin?.step !== void 0) {
       const was = stepByRef(oldSteps, pin.step);
-      const now2 = was ? matchStep(was, newSteps) : stepByRef(newSteps, pin.step);
+      const now2 = was ? matchStep(was, newSteps, oldSteps) : stepByRef(newSteps, pin.step);
       if (!now2 || now2.skipped) {
         report.flagged.push(
-          `overlay ${o.id}: pinned to step ${String(pin.step)}, which is missing or skipped in the new recording \u2014 kept at ${o.start.toFixed(2)}s; re-pin or re-place it`
+          `overlay ${o.id}: pinned to step ${String(pin.step)}, which is missing or skipped in the new recording \u2014 kept at ${at2.toFixed(2)}s; re-pin or re-place it`
         );
         return o;
       }
       report.anchored++;
-      return follow(o, was?.tStart ?? now2.tStart, now2.tStart);
+      return follow(o, at2, was?.tStart ?? now2.tStart, now2.tStart);
     }
     if (typeof pin?.press === "number") {
       const placed = placeMoment(pin.press, void 0, ctx);
       if ("gone" in placed) {
         report.flagged.push(
-          `overlay ${o.id}: pinned to a press at ${pin.press.toFixed(2)}s, and ${goneWords(placed.gone)} \u2014 kept at ${o.start.toFixed(2)}s; re-pin or re-place it`
+          `overlay ${o.id}: pinned to a press at ${pin.press.toFixed(2)}s, and ${goneWords(placed.gone)} \u2014 kept at ${at2.toFixed(2)}s; re-pin or re-place it`
         );
         return o;
       }
-      const moved = follow(o, pin.press, placed.at);
+      const moved = follow(o, at2, pin.press, placed.at);
       return { ...moved, pin: { ...pin, press: +placed.at.toFixed(3) } };
     }
     const under = stepUnder(
-      outputToSource(oldPieces, o.start),
+      outputToSource(oldPieces, at2),
       oldSteps,
       LAYER_AFTER_STEP
     );
     if (!under) return o;
-    const now = matchStep(under, newSteps);
+    const now = matchStep(under, newSteps, oldSteps);
     if (!now) {
       report.flagged.push(
-        `overlay ${o.id} (${o.start.toFixed(2)}s): it sat over step ${stepName(under)}, which is missing or skipped in the new recording \u2014 kept at its output time; re-place it`
+        `overlay ${o.id} (${at2.toFixed(2)}s): it sat over step ${stepName(under)}, which is missing or skipped in the new recording \u2014 kept at its output time; re-place it`
       );
       return o;
     }
-    const expected = follow(o, under.tStart, now.tStart).start;
-    if (Math.abs(expected - o.start) > LAYER_DRIFT) {
+    const expected = follow(o, at2, under.tStart, now.tStart).start;
+    if (Math.abs(expected - at2) > LAYER_DRIFT) {
       report.flagged.push(
-        `overlay ${o.id} (${o.start.toFixed(2)}s): it sat over step ${stepName(under)}, which now plays at ${expected.toFixed(2)}s in the cut \u2014 kept at ${o.start.toFixed(2)}s by the output-time contract; pin it to follow (pin: { step: ${JSON.stringify(under.id ?? under.step)} }) or move it`
+        `overlay ${o.id} (${at2.toFixed(2)}s): it sat over step ${stepName(under)}, which now plays at ${expected.toFixed(2)}s in the cut \u2014 kept at ${at2.toFixed(2)}s by the output-time contract; pin it to follow (pin: { step: ${JSON.stringify(under.id ?? under.step)} }) or move it`
       );
     }
     return o;
@@ -6961,14 +7176,14 @@ import { createHash } from "crypto";
 import { existsSync as existsSync12, readFileSync as readFileSync3, readdirSync as readdirSync2 } from "fs";
 import { readFile as readFile11 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
-import { basename, join as join14 } from "path";
+import { basename as basename2, join as join14 } from "path";
 import { lowerToComposition as lowerToComposition3, migrateHostedDoc as migrateHostedDoc2 } from "@vosjs/studio-core";
 
 // src/plugin/takeScript.ts
 import { existsSync as existsSync11 } from "fs";
 import { readFile as readFile10, writeFile as writeFile7 } from "fs/promises";
 import { readFileSync as readFileSync2 } from "fs";
-import { join as join12 } from "path";
+import { basename, join as join12 } from "path";
 function scriptFromText(text) {
   try {
     const v = JSON.parse(text);
@@ -6984,6 +7199,8 @@ function scriptToWrite(doc, hasLocal) {
 `;
 }
 function publicScript(script) {
+  const peers = publicPeers(script.peers);
+  if (peers) script = { ...script, peers };
   const setup = script.setup;
   if (!Array.isArray(setup)) return script;
   return {
@@ -7005,6 +7222,15 @@ function publicScript(script) {
     })
   };
 }
+function publicPeers(peers) {
+  if (!Array.isArray(peers)) return null;
+  return peers.map((p) => {
+    if (!p || typeof p !== "object") return p;
+    const peer = p;
+    if (typeof peer.storageState !== "string") return peer;
+    return { ...peer, storageState: basename(peer.storageState) };
+  });
+}
 function embedScript(doc, dir) {
   const path = join12(dir, "actions.json");
   if (!existsSync11(path)) return;
@@ -7018,6 +7244,11 @@ async function writeScriptBeside(dir, doc) {
   await writeFile7(path, text, "utf8");
   return true;
 }
+async function readScript(dir) {
+  const path = join12(dir, "actions.json");
+  if (!existsSync11(path)) return null;
+  return scriptFromText(await readFile10(path, "utf8"));
+}
 
 // src/plugin/folder.ts
 import { mkdir as mkdir6 } from "fs/promises";
@@ -7511,6 +7742,10 @@ async function pushTake(dir, flags, r) {
       "no recording in this take \u2014 record it, or `vos pull --media` to bring it home"
     );
   }
+  const pasteFiles = await readPasteFiles(
+    await readScript(dir) ?? take.doc.source.script,
+    dir
+  );
   const ctx = apiContext(flags);
   const tracked = readSyncState(dir);
   const firstPush = tracked === null;
@@ -7567,12 +7802,6 @@ async function pushTake(dir, flags, r) {
     filename: take.paths.recordingName
   });
   const filename = nameForType(take.paths.recordingName, contentType);
-  if (filename !== take.paths.recordingName) {
-    r.log(
-      `  ${take.paths.recordingName} holds ${contentType} \u2014 uploading it as ${filename}`
-    );
-  }
-  r.log(`uploading recording (${Math.round(bytes.length / 1024)} kB)\u2026`);
   let upload;
   try {
     upload = await uploadAsset(ctx, new Uint8Array(bytes), {
@@ -7581,6 +7810,15 @@ async function pushTake(dir, flags, r) {
       contentHash: hash,
       // The take's length so the server holds it to the plan's cap.
       ...take.meta.durationMs > 0 ? { durationSeconds: take.meta.durationMs / 1e3 } : {},
+      // Said once the platform asks for the bytes: a re-push of a hosted
+      // take sends none, and says only that it reused them.
+      onSending: () => {
+        if (filename !== take.paths.recordingName)
+          r.log(
+            `  ${take.paths.recordingName} holds ${contentType} \u2014 uploading it as ${filename}`
+          );
+        r.log(`uploading recording (${Math.round(bytes.length / 1024)} kB)\u2026`);
+      },
       onPart: (done, total) => r.log(`  part ${done}/${total}`)
     });
   } catch (e) {
@@ -7596,6 +7834,7 @@ async function pushTake(dir, flags, r) {
   const docForPush = structuredClone(sendDoc);
   docForPush.source.videoKey = assetUrl;
   embedScript(docForPush, dir);
+  await sendPasteFiles(docForPush, pasteFiles, ctx, (l) => r.log(l));
   await uploadDocRefs(sourceSidecarRefs(docForPush), dir, ctx, (l) => r.log(l));
   for (const field of ["micKey", "camKey"]) {
     const key = docForPush.source[field];
@@ -7610,7 +7849,7 @@ async function pushTake(dir, flags, r) {
   const lowered = lowerToComposition3(docForPush);
   const config = { ...lowered.config, data: lowered.data };
   if (!state) {
-    const title = flags.title ?? `Take ${basename(dir)} ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`;
+    const title = flags.title ?? `Take ${basename2(dir)} ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`;
     const slug = `${title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40) || "take"}-${Date.now().toString(36)}`;
     const created = await api(ctx, "/vos", {
       method: "POST",
@@ -7797,7 +8036,7 @@ async function pullTake(dir, flags, r) {
   const doc = hostedDoc;
   const localRecording = takeMediaFile(dir, "recording", RECORDING_NAME);
   if (existsSync12(localRecording)) {
-    doc.source.videoKey = basename(localRecording);
+    doc.source.videoKey = basename2(localRecording);
   }
   await writeJson(join14(dir, "doc.json"), doc, true);
   const media = flags.media ? await pullMedia(ctx, dir, doc, r.log) : void 0;
@@ -7840,6 +8079,10 @@ async function pushTakeClaimable(dir, flags, r) {
   ${lint.problems.join("\n  ")}`
     );
   }
+  const pasteFiles = await readPasteFiles(
+    await readScript(dir) ?? take.doc.source.script,
+    dir
+  );
   const state = readSyncState(dir);
   const hosted = state?.hostedMedia ?? {};
   if (!Object.keys(hosted).length)
@@ -7882,6 +8125,7 @@ async function pushTakeClaimable(dir, flags, r) {
   for (const line of plays.lines) r.log(line);
   const docForPush = structuredClone(plays.doc);
   embedScript(docForPush, dir);
+  await claimablePasteFiles(docForPush, pasteFiles, hosted, (l) => r.log(l));
   for (const ref of claimRefs(docForPush)) {
     const origin2 = hosted[takeRelativeFile(ref.key)];
     if (!origin2)
@@ -7892,7 +8136,7 @@ async function pushTakeClaimable(dir, flags, r) {
   }
   const lowered = lowerToComposition3(docForPush);
   const config = { ...lowered.config, data: lowered.data };
-  const title = (flags.title ?? (state?.title ? `${state.title} remix` : basename(dir))).slice(0, 200);
+  const title = (flags.title ?? (state?.title ? `${state.title} remix` : basename2(dir))).slice(0, 200);
   const body = { title, config, doc: docForPush };
   if (state?.vosId) body.remixOfId = state.vosId;
   if (flags.prompt) body.prompt = flags.prompt;
@@ -7919,7 +8163,7 @@ async function pushTakeClaimable(dir, flags, r) {
 import { existsSync as existsSync14 } from "fs";
 import { mkdir as mkdir7, readFile as readFile12 } from "fs/promises";
 import { createInterface as createInterface3 } from "readline/promises";
-import { basename as basename3, dirname as dirname2, join as join15 } from "path";
+import { basename as basename4, dirname as dirname2, join as join15 } from "path";
 import {
   CURRENT_CONFIG_VERSION,
   migrateConfig,
@@ -7928,7 +8172,7 @@ import {
 import { lowerProgramDoc, migrateHostedDoc as migrateHostedDoc3 } from "@vosjs/studio-core";
 
 // src/plugin/programFiles.ts
-import { basename as basename2, extname as extname2, relative as relative2 } from "path";
+import { basename as basename3, extname as extname2, relative as relative2 } from "path";
 import { existsSync as existsSync13, realpathSync as realpathSync2 } from "fs";
 function isLocalName(value) {
   if (/^(https?:|data:|blob:|asset:|media:)/.test(value)) return false;
@@ -7939,7 +8183,7 @@ function isLocalName(value) {
 }
 var FILE_EXT = /\.(png|jpe?g|webp|gif|avif|svg|mp4|webm|mov|mp3|m4a|ogg|wav|flac|aac|glb|gltf|woff2?|ttf|otf|hdr|exr)$/i;
 function manifestName(file, taken) {
-  const stem = basename2(file, extname2(file)).replace(/[^A-Za-z0-9_]/g, "_").replace(/^(?=[0-9])/, "_") || "file";
+  const stem = basename3(file, extname2(file)).replace(/[^A-Za-z0-9_]/g, "_").replace(/^(?=[0-9])/, "_") || "file";
   let name = stem;
   for (let n = 2; taken.has(name); n++) name = `${stem}_${n}`;
   taken.add(name);
@@ -8358,7 +8602,7 @@ async function cmdPushProgram(argv) {
         "--claimable creates a NEW claimable vos and cannot iterate (--vos). After the human claims it, iterate with their key: vos push --vos <id>"
       );
     }
-    const fallback = state?.title ? `${state.title} remix` : basename3(source).replace(/\.json$/i, "") || "vos program";
+    const fallback = state?.title ? `${state.title} remix` : basename4(source).replace(/\.json$/i, "") || "vos program";
     const title2 = (strFlag(flags, "title") ?? fallback).slice(0, 100);
     const files2 = await collectFiles(config, programDoc, dir, r);
     let uploadToken;
@@ -8525,7 +8769,7 @@ ${landedLines(landed2)}` : "")
     return EXIT_OK;
   }
   const remixOfId = pushTarget.kind === "create" ? pushTarget.remixOfId : void 0;
-  const fallbackTitle = state?.title ? `${state.title} remix` : basename3(source).replace(/\.json$/i, "") || "vos remix";
+  const fallbackTitle = state?.title ? `${state.title} remix` : basename4(source).replace(/\.json$/i, "") || "vos remix";
   const title = (strFlag(flags, "title") ?? fallbackTitle).slice(0, 100);
   const pushFolder = folderRef ? await resolvePushFolder(origin, key, folderRef) : void 0;
   const folderId = pushFolder?.id;
@@ -8851,7 +9095,7 @@ async function writeProgramDoc(dir, hosted) {
 // src/plugin/asset.ts
 import { createHash as createHash2 } from "crypto";
 import { readFileSync as readFileSync4 } from "fs";
-import { basename as basename4 } from "path";
+import { basename as basename5 } from "path";
 
 // src/plugin/assetWords.ts
 function hostedFile(raw) {
@@ -9116,7 +9360,7 @@ async function cmdPush(argv) {
   const folder = folderRef ? resolveFolder(await listFolders(origin, key), folderRef) : null;
   const uploaded = [];
   for (const file of positionals) {
-    const name = basename4(file);
+    const name = basename5(file);
     const body = readFileSync4(file);
     const media = resolveMediaType({
       head: body.subarray(0, MEDIA_HEAD_BYTES),
@@ -9634,7 +9878,7 @@ function trackingCwd(vosId) {
 
 // src/plugin/buildProgram.ts
 import { readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
-import { basename as basename5, dirname as dirname3, join as join17, resolve as resolve7 } from "path";
+import { basename as basename6, dirname as dirname3, join as join17, resolve as resolve7 } from "path";
 import { pathToFileURL } from "url";
 import { parse } from "acorn";
 import { fullAncestor } from "acorn-walk";
@@ -9842,7 +10086,7 @@ async function cmdBuild(argv) {
     throw new UsageError(
       `${source} exports no program: \`export default { version: 2, duration, camera, createContent, createTimeline, \u2026 }\``
     );
-  const built = buildProgram(program, basename5(file), text);
+  const built = buildProgram(program, basename6(file), text);
   for (const p of built.problems) r.log(`error ${p.fn}: ${p.message}`);
   if (built.problems.length) {
     r.done(
@@ -10077,7 +10321,7 @@ import { findFontFamily as findFontFamily3 } from "@vosjs/shared";
 import { existsSync as existsSync17, readFileSync as readFileSync6, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
 import { createServer as createServer2 } from "http";
 import { createRequire } from "module";
-import { basename as basename6, extname as extname3, join as join19 } from "path";
+import { basename as basename7, extname as extname3, join as join19 } from "path";
 function themeColors(sources) {
   const out = {};
   const re = /\bconst\s+([A-Za-z_$][\w$]*)\s*(?::\s*string\s*)?=\s*['"](#[0-9a-fA-F]{3,8})['"]/g;
@@ -10091,10 +10335,10 @@ function themeColors(sources) {
 function remotionScenes(seqs, fps) {
   const seen = /* @__PURE__ */ new Map();
   const live = seqs.filter((s) => s.durationInFrames > 0);
-  const overlaps2 = (a, b) => a.from < b.from + b.durationInFrames && b.from < a.from + a.durationInFrames;
+  const overlaps3 = (a, b) => a.from < b.from + b.durationInFrames && b.from < a.from + a.durationInFrames;
   return live.filter(
     (s) => !live.some(
-      (o) => o !== s && o.durationInFrames > s.durationInFrames && overlaps2(o, s)
+      (o) => o !== s && o.durationInFrames > s.durationInFrames && overlaps3(o, s)
     )
   ).sort((a, b) => a.from - b.from).map((s, i) => {
     const base = s.name ?? `scene${i + 1}`;
@@ -10357,7 +10601,7 @@ async function readRemotion(dir, log) {
     const sources = sourceTexts(dir);
     const publicDir = join19(dir, "public");
     const media = tree.audio.map((a) => {
-      const name = basename6(a.src.split("?")[0]);
+      const name = basename7(a.src.split("?")[0]);
       const local = existsSync17(join19(publicDir, name)) ? `public/${name}` : a.src;
       return {
         kind: "audio",
@@ -10860,7 +11104,7 @@ async function readInventory(source, opts) {
 // src/plugin/portScaffold.ts
 import { spawnSync as spawnSync3 } from "child_process";
 import { copyFileSync, existsSync as existsSync19, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
-import { basename as basename7, dirname as dirname6, join as join21, resolve as resolve10 } from "path";
+import { basename as basename8, dirname as dirname6, join as join21, resolve as resolve10 } from "path";
 import { findFontFamily as findFontFamily4, fontFaceUrl, nearestFontWeight } from "@vosjs/shared";
 
 // src/plugin/painterLib.ts
@@ -11270,7 +11514,7 @@ function planScaffold(inv, opts) {
   const copies = [];
   inv.media.filter((m) => m.kind === "audio" && m.src).forEach((m, i) => {
     const from = resolve10(opts.sourceDir, m.src);
-    const name = basename7(from);
+    const name = basename8(from);
     if (!existsSync19(from)) {
       report.push(
         `- the audio ${m.src} is not in the source folder; add it to doc.json by hand`
@@ -11423,7 +11667,7 @@ ${sceneTodos}${springHint}
 }
 function reportText(inv, r) {
   const lines = [
-    `# Port report: ${inv.source === "." && inv.root ? basename7(inv.root) : inv.source}`,
+    `# Port report: ${inv.source === "." && inv.root ? basename8(inv.root) : inv.source}`,
     "",
     `${inv.engine} piece, ${inv.width}\xD7${inv.height}${inv.fps ? ` at ${inv.fps} fps` : ""}, ${inv.duration ?? "?"} s. A program has no size of its own: render it with \`--width ${inv.width} --height ${inv.height}\`.`,
     "",
@@ -11587,11 +11831,11 @@ function scaffoldSourceDir(inv) {
 // src/plugin/recipe.ts
 import { createHash as createHash3 } from "crypto";
 import { readFileSync as readFileSync9 } from "fs";
-import { basename as basename8 } from "path";
+import { basename as basename9 } from "path";
 var BOOLEAN_FLAGS9 = /* @__PURE__ */ new Set(["json", "help"]);
 var USAGE = "vos recipe push <file.md> (--folder <folderId|slug> | --asset <assetId>)";
 function recipeFilename(file) {
-  const name = basename8(file);
+  const name = basename9(file);
   if (!/\.md$/i.test(name)) {
     throw new UsageError(`a recipe is a markdown file \u2014 ${name} is not .md`);
   }
@@ -12077,7 +12321,7 @@ function isWallError(error) {
   return !!error && /^(\[\w+\] )?The page is behind a sign-in/.test(error);
 }
 async function recordHosted(input) {
-  const sleep = input.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const sleep = input.sleep ?? ((ms2) => new Promise((r) => setTimeout(r, ms2)));
   const posted = await apiJson(input.origin, "/api/record/jobs", {
     method: "POST",
     key: input.key,
@@ -12640,8 +12884,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: readFile17 } = await import("fs/promises");
-  const text = await readFile17(resolve13(input), "utf8");
+  const { readFile: readFile19 } = await import("fs/promises");
+  const text = await readFile19(resolve13(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -12678,9 +12922,9 @@ function summary2(result) {
 }
 async function cmdActionsScript(input, flags) {
   const r = createReporter(flags.json === true);
-  const { readFile: readFile17 } = await import("fs/promises");
-  const { shotList, formatShotList } = await import("./shotList-EE3S5LVF.js");
-  const raw = JSON.parse(await readFile17(resolve13(input), "utf8"));
+  const { readFile: readFile19 } = await import("fs/promises");
+  const { shotList, formatShotList } = await import("./shotList-MSNWLVDN.js");
+  const raw = JSON.parse(await readFile19(resolve13(input), "utf8"));
   const errors = validateActions(raw);
   if (errors.length) throw new UsageError(`${input}:
   ${errors.join("\n  ")}`);
@@ -12692,7 +12936,7 @@ async function cmdActionsScript(input, flags) {
 // src/plugin/ingest.ts
 import { existsSync as existsSync21 } from "fs";
 import { copyFile, mkdir as mkdir8, readFile as readFile13, stat as stat2 } from "fs/promises";
-import { basename as basename9, join as join23, resolve as resolve14 } from "path";
+import { basename as basename10, join as join23, resolve as resolve14 } from "path";
 
 // src/plugin/traceInflate.ts
 import { inflateRawSync } from "zlib";
@@ -12765,7 +13009,7 @@ async function probeVideoFile(path) {
       input.getPrimaryAudioTrack()
     ]);
     const mimeType = format.mimeType;
-    const ext = mimeType.includes("mp4") ? "mp4" : mimeType.includes("quicktime") ? "mov" : "webm";
+    const ext2 = mimeType.includes("mp4") ? "mp4" : mimeType.includes("quicktime") ? "mov" : "webm";
     return {
       width: video.displayWidth,
       height: video.displayHeight,
@@ -12773,14 +13017,14 @@ async function probeVideoFile(path) {
       fps: Math.round(stats.averagePacketRate * 100) / 100,
       hasAudio: !!audio,
       mimeType,
-      ext
+      ext: ext2
     };
   } finally {
     await input.dispose?.();
   }
 }
-async function copyRecording(src, dest, ext) {
-  if (ext === "mov") {
+async function copyRecording(src, dest, ext2) {
+  if (ext2 === "mov") {
     await copyFile(src, dest);
     return false;
   }
@@ -12788,7 +13032,7 @@ async function copyRecording(src, dest, ext) {
     source: new FilePathSource(src),
     formats: ALL_FORMATS
   });
-  const format = () => ext === "mp4" ? new Mp4OutputFormat({ fastStart: "in-memory" }) : new WebMOutputFormat();
+  const format = () => ext2 === "mp4" ? new Mp4OutputFormat({ fastStart: "in-memory" }) : new WebMOutputFormat();
   try {
     const probe3 = await Conversion.init({
       input,
@@ -12819,7 +13063,7 @@ async function copyRecording(src, dest, ext) {
   }
 }
 async function readTraceFile(path, offsetMs) {
-  const kind = traceKindOf(basename9(path));
+  const kind = traceKindOf(basename10(path));
   if (!kind) {
     throw new UsageError(
       `${path}: not a trace the recorder reads (trace.zip, .trace, .jsonl, .json or .csv)`
@@ -12840,7 +13084,7 @@ async function readTraceFile(path, offsetMs) {
     return cursorFromPlaywrightTrace(text2, { offsetMs });
   }
   const text = await readFile13(path, "utf8");
-  return cursorFromTrace(basename9(path), text, { offsetMs });
+  return cursorFromTrace(basename10(path), text, { offsetMs });
 }
 function parseViewport(v) {
   if (!v) return null;
@@ -12871,7 +13115,7 @@ async function cmdIngest(argv) {
       "note: finished footage opens bare, so --background is not used (pass --as take for the screen-recording card and its ground)"
     );
   const backdrop = footage ? null : await takeBackdrop(flags, r);
-  r.log(`probing ${basename9(videoPath)}\u2026`);
+  r.log(`probing ${basename10(videoPath)}\u2026`);
   const probed = await probeVideoFile(videoPath);
   if (!(probed.durationMs > 0)) {
     throw new UsageError(
@@ -12920,13 +13164,13 @@ async function cmdIngest(argv) {
   const clicks = events.filter((e) => e.type === "down").length;
   const seconds = (probed.durationMs / 1e3).toFixed(1);
   const facts = `${seconds}s, ${probed.width}\xD7${probed.height} @ ${meta.fps} fps${probed.hasAudio ? ", audio" : ", no audio"}${remuxed ? "" : ", copied as is"}`;
-  const cursorLine = trace ? `${events.length} cursor events (${clicks} clicks) from ${basename9(cursorPath)}${trace.dropped ? `, ${trace.dropped} not placed` : ""}; ${plan.zoomAuto} zoom${plan.zoomAuto === 1 ? "" : "s"} planned` : "no cursor track, so nothing was planned";
+  const cursorLine = trace ? `${events.length} cursor events (${clicks} clicks) from ${basename10(cursorPath)}${trace.dropped ? `, ${trace.dropped} not placed` : ""}; ${plan.zoomAuto} zoom${plan.zoomAuto === 1 ? "" : "s"} planned` : "no cursor track, so nothing was planned";
   const opened = footage ? `opened as finished footage: no card, no browser bar, no drawn cursor, ${meta.fps > 30 ? 60 : 30} fps export (--as take for a screen recording's card)` : `opened as a screen recording: the card, its ground and the drawn cursor (--as footage to open it bare)`;
   const next = footage && !trace ? `Next: vos push ${outDir} --wait \u2014 it lands as it is; trim or add to it in the studio` : trace ? `Next: vos digest ${outDir} \u2014 look before you cut; edit doc.json; vos push ${outDir}` : `Add --cursor <trace> recorded beside the video (a Playwright trace.zip, stamped JSON records, or a t,x,y,type CSV) to plan zooms from its clicks; else place them by eye: vos frames ${outDir} --times 0,25%,50%,75%,100%, then edit doc.json`;
   r.done(
     {
       out: outDir,
-      recording: basename9(recording),
+      recording: basename10(recording),
       durationMs: probed.durationMs,
       width: probed.width,
       height: probed.height,
@@ -12935,7 +13179,7 @@ async function cmdIngest(argv) {
       hasAudio: probed.hasAudio,
       remuxed,
       cursor: trace ? {
-        file: basename9(cursorPath),
+        file: basename10(cursorPath),
         kind: trace.kind,
         events: events.length,
         clicks,
@@ -12947,7 +13191,7 @@ async function cmdIngest(argv) {
       backdrop: plan.backdrop ?? null,
       as: footage ? "footage" : "take"
     },
-    `Ingested ${basename9(videoPath)} \u2192 ${outDir}/${basename9(recording)} (${facts})
+    `Ingested ${basename10(videoPath)} \u2192 ${outDir}/${basename10(recording)} (${facts})
   ${opened}
   ${cursorLine}
   ${next}`
@@ -12959,12 +13203,13 @@ async function cmdIngest(argv) {
 import { createRequire as createRequire2 } from "module";
 import { existsSync as existsSync22 } from "fs";
 import { mkdir as mkdir9, readFile as readFile14, stat as stat3, writeFile as writeFile10 } from "fs/promises";
-import { basename as basename10, dirname as dirname8, extname as extname4, join as join24, resolve as resolve15 } from "path";
+import { basename as basename11, dirname as dirname8, extname as extname4, join as join24, resolve as resolve15 } from "path";
 import { ALL_FORMATS as ALL_FORMATS2, FilePathSource as FilePathSource2, Input as Input2 } from "mediabunny";
 
 // src/plugin/videoChecks.ts
 var SCENE_CHANGE_AT = 0.12;
 var CELL_CHANGED_AT = 0.03;
+var CELL_STRONG_AT = 0.06;
 var SCENE_WINDOW = 5;
 var UNIFORM_BELOW = 2;
 var QUIET_BELOW_LUFS = -23;
@@ -12975,7 +13220,9 @@ var SCENE_SPIKE = 2.5;
 var ISOLATED_CHANGE_AT = 0.03;
 var ISOLATED_SPIKE = 8;
 var ISOLATED_COVERAGE = 0.25;
-function sceneChanges2(times, changes, coverage) {
+var SCATTER_SHARE = 0.1;
+var SCATTER_BOX = 0.22;
+function sceneChanges2(times, changes, coverage, scatter) {
   const out = [];
   for (let i = 1; i < changes.length; i++) {
     const c = changes[i];
@@ -12987,7 +13234,9 @@ function sceneChanges2(times, changes, coverage) {
     const most = around.length ? around[around.length - 1] : 0;
     const share = coverage ? coverage[i] : 1;
     const standsOut = c >= SCENE_CHANGE_AT && c >= SCENE_SPIKE * mid;
-    const standsAlone = c >= ISOLATED_CHANGE_AT && share >= ISOLATED_COVERAGE && c >= ISOLATED_SPIKE * most;
+    const spread = scatter?.[i];
+    const scattered = !!spread && spread.share >= SCATTER_SHARE && spread.box >= SCATTER_BOX;
+    const standsAlone = c >= ISOLATED_CHANGE_AT && (share >= ISOLATED_COVERAGE || scattered) && c >= ISOLATED_SPIKE * most;
     if (!standsOut && !standsAlone) continue;
     out.push({
       time: times[i],
@@ -13195,7 +13444,8 @@ function posterWarning(which, deviation) {
 
 // src/plugin/checkVideo.ts
 var BOOLEAN_FLAGS11 = /* @__PURE__ */ new Set(["json", "help", "strict"]);
-var THUMB_LONG_SIDE = 64;
+var THUMB_LONG_SIDE = 160;
+var CELLS_LONG_SIDE = 16;
 async function probeVideoFacts(file) {
   const input = new Input2({
     source: new FilePathSource2(file),
@@ -13295,22 +13545,43 @@ async function decodeInPage(opts) {
     const coverageOf = (a, b) => {
       const W = opts.thumbW;
       const H = opts.thumbH;
+      const C = opts.cellPx;
       let cells = 0;
       let changed = 0;
-      for (let cy = 0; cy < H; cy += 4)
-        for (let cx = 0; cx < W; cx += 4) {
+      let strong = 0;
+      let x0 = W;
+      let x1 = 0;
+      let y0 = H;
+      let y1 = 0;
+      for (let cy = 0; cy < H; cy += C)
+        for (let cx = 0; cx < W; cx += C) {
           let s = 0;
-          let n = 0;
-          for (let y = cy; y < Math.min(H, cy + 4); y++)
-            for (let x = cx; x < Math.min(W, cx + 4); x++) {
+          let n2 = 0;
+          for (let y = cy; y < Math.min(H, cy + C); y++)
+            for (let x = cx; x < Math.min(W, cx + C); x++) {
               const k = (y * W + x) * 3;
               s += Math.abs(a[k] - b[k]) + Math.abs(a[k + 1] - b[k + 1]) + Math.abs(a[k + 2] - b[k + 2]);
-              n += 3;
+              n2 += 3;
             }
           cells++;
-          if (s / Math.max(1, n) / 255 >= opts.cellChanged) changed++;
+          const m = s / Math.max(1, n2) / 255;
+          if (m >= opts.cellChanged) changed++;
+          if (m >= opts.cellStrong) {
+            strong++;
+            x0 = Math.min(x0, cx);
+            x1 = Math.max(x1, Math.min(W, cx + C));
+            y0 = Math.min(y0, cy);
+            y1 = Math.max(y1, Math.min(H, cy + C));
+          }
+        }
+      const n = Math.max(1, cells);
+      return {
+        share: changed / n,
+        scatter: {
+          share: strong / n,
+          box: strong ? (x1 - x0) * (y1 - y0) / Math.max(1, W * H) : 0
         }
-      return changed / Math.max(1, cells);
+      };
     };
     const small = document.createElement("canvas");
     small.width = opts.thumbW;
@@ -13323,6 +13594,8 @@ async function decodeInPage(opts) {
     const times = [];
     const changes = [];
     const coverage = [];
+    const scatter = [];
+    const none = { share: 0, scatter: { share: 0, box: 0 } };
     let next = -Infinity;
     let prev = null;
     let first = null;
@@ -13350,7 +13623,9 @@ async function decodeInPage(opts) {
       }
       times.push(t);
       changes.push(prev ? difference(prev, g) : 0);
-      coverage.push(prev ? coverageOf(prev, g) : 0);
+      const cov = prev ? coverageOf(prev, g) : none;
+      coverage.push(cov.share);
+      scatter.push(cov.scatter);
       prev = g;
       lastKept = t;
       lastGray = g;
@@ -13362,7 +13637,9 @@ async function decodeInPage(opts) {
     if (tail && lastTime > lastKept) {
       times.push(lastTime);
       changes.push(prev ? difference(prev, tail) : 0);
-      coverage.push(prev ? coverageOf(prev, tail) : 0);
+      const cov = prev ? coverageOf(prev, tail) : none;
+      coverage.push(cov.share);
+      scatter.push(cov.scatter);
       lastGray = tail;
     }
     const toBase64 = (bytes) => {
@@ -13412,6 +13689,7 @@ async function decodeInPage(opts) {
       times,
       changes,
       coverage,
+      scatter,
       firstDeviation: deviation(first),
       lastDeviation: deviation(lastGray),
       firstTime,
@@ -13447,12 +13725,14 @@ async function checkVideo(browser, file, outDir) {
     void page.evaluate(decodeInPage, {
       mbCode: await mediabunnyBundle(),
       meterSrc: String(createLoudnessMeter),
-      videoUrl: `/${encodeURIComponent(basename10(file))}`,
+      videoUrl: `/${encodeURIComponent(basename11(file))}`,
       sampleFps,
       thumbW: side(facts.width),
       thumbH: side(facts.height),
+      cellPx: Math.max(1, Math.round(THUMB_LONG_SIDE / CELLS_LONG_SIDE)),
       subBlock: SUB_BLOCK_SECONDS,
-      cellChanged: CELL_CHANGED_AT
+      cellChanged: CELL_CHANGED_AT,
+      cellStrong: CELL_STRONG_AT
     }).catch(() => {
     });
     done = await waitForPageDone(
@@ -13471,7 +13751,12 @@ async function checkVideo(browser, file, outDir) {
   const lastFile = join24(outDir, "last.png");
   await writeFile10(firstFile, Buffer.from(done.firstPng, "base64"));
   await writeFile10(lastFile, Buffer.from(done.lastPng, "base64"));
-  const changes = sceneChanges2(done.times, done.changes, done.coverage);
+  const changes = sceneChanges2(
+    done.times,
+    done.changes,
+    done.coverage,
+    done.scatter
+  );
   const loudness = done.audio ? loudnessFromEnergies(done.audio.energies, done.audio.peak) : null;
   const round2 = (n) => Math.round(n * 100) / 100;
   const posters = {
@@ -13548,7 +13833,7 @@ async function cmdCheckVideo(argv) {
   const r = createReporter(flags.json === true);
   const strict = flags.strict === true;
   const outDir = resolve15(
-    strFlag(flags, "out") ?? join24(dirname8(file), `${basename10(file, extname4(file))}-check`)
+    strFlag(flags, "out") ?? join24(dirname8(file), `${basename11(file, extname4(file))}-check`)
   );
   const browser = await launchBrowser();
   try {
@@ -13563,27 +13848,28 @@ async function cmdCheckVideo(argv) {
 }
 
 // src/plugin/join.ts
-import { existsSync as existsSync24, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
-import { copyFile as copyFile3, mkdir as mkdir11, rm as rm4 } from "fs/promises";
+import { existsSync as existsSync25, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
+import { copyFile as copyFile3, mkdir as mkdir11, readFile as readFile17, rm as rm4 } from "fs/promises";
 import {
-  basename as basename12,
+  basename as basename13,
   dirname as dirname9,
   isAbsolute as isAbsolute4,
-  join as join26,
+  join as join27,
   relative as relative5,
   resolve as resolve17,
   sep as sep4
 } from "path";
 import {
-  mediaKey as mediaKey2,
-  mediaRefId,
+  mediaKey as mediaKey4,
+  mediaRefId as mediaRefId2,
   migrateMotion as migrateMotion3,
   projectFromArtifact as projectFromArtifact2,
-  ratedSegments as ratedSegments9,
-  resolveAnchor as resolveAnchor6,
-  segmentOutputExtents as segmentOutputExtents3
+  ratedSegments as ratedSegments10,
+  layerStart as layerStart4,
+  resolveAnchor as resolveAnchor7,
+  segmentOutputExtents as segmentOutputExtents4
 } from "@vosjs/studio-core";
-import { totalDuration as totalDuration2 } from "@vosjs/timeline";
+import { totalDuration as totalDuration3 } from "@vosjs/timeline";
 
 // src/plugin/score.ts
 import { existsSync as existsSync23 } from "fs";
@@ -13596,7 +13882,7 @@ import {
   writeFile as writeFile11
 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import { basename as basename11, isAbsolute as isAbsolute3, join as join25, relative as relative4, resolve as resolve16, sep as sep3 } from "path";
+import { basename as basename12, isAbsolute as isAbsolute3, join as join25, relative as relative4, resolve as resolve16, sep as sep3 } from "path";
 import {
   NORMALIZE_MAX_LUFS as NORMALIZE_MAX_LUFS2,
   NORMALIZE_MIN_LUFS as NORMALIZE_MIN_LUFS2,
@@ -13911,7 +14197,7 @@ async function measureInBrowser(path) {
   const bytes = await readFile15(path);
   if (bytes.length > BROWSER_DECODE_MAX_BYTES)
     throw new Error(
-      `${basename11(path)} is ${Math.round(bytes.length / 1048576)} MB, past the ${BROWSER_DECODE_MAX_BYTES / 1048576} MB the browser decode takes whole`
+      `${basename12(path)} is ${Math.round(bytes.length / 1048576)} MB, past the ${BROWSER_DECODE_MAX_BYTES / 1048576} MB the browser decode takes whole`
     );
   const browser = await launchBrowser();
   try {
@@ -14015,12 +14301,12 @@ async function resolveTrack(dir, ref, flags, dryRun) {
   if (existsSync23(local)) {
     const rel = relative4(resolve16(dir), local);
     const inside = !!rel && !rel.startsWith(`..${sep3}`) && rel !== ".." && !isAbsolute3(rel);
-    const key = inside ? rel.split(sep3).join("/") : `music/${basename11(local)}`;
+    const key = inside ? rel.split(sep3).join("/") : `music/${basename12(local)}`;
     if (!inside && !dryRun) {
       await mkdir10(join25(dir, "music"), { recursive: true });
       await copyFile2(local, join25(dir, key));
     }
-    return { path: local, key, name: basename11(local) };
+    return { path: local, key, name: basename12(local) };
   }
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -14035,7 +14321,7 @@ async function resolveTrack(dir, ref, flags, dryRun) {
   const res = await fetch(track.url);
   if (!res.ok) throw new Error(`GET ${track.url} answered ${res.status}`);
   const tmp = await mkdtemp(join25(tmpdir2(), "vos-score-"));
-  const path = join25(tmp, basename11(new URL(track.url).pathname) || "track");
+  const path = join25(tmp, basename12(new URL(track.url).pathname) || "track");
   await writeFile11(path, new Uint8Array(await res.arrayBuffer()));
   return {
     path,
@@ -14183,30 +14469,94 @@ import {
   segmentOutputExtents as segmentOutputExtents2
 } from "@vosjs/studio-core";
 import { totalDuration } from "@vosjs/timeline";
+
+// src/plugin/scriptStep.ts
+var asRaw = (v) => typeof v === "object" && v !== null && !Array.isArray(v) ? v : void 0;
+function scriptStepOf(step, list, recorded = []) {
+  if (!Array.isArray(list)) return void 0;
+  const steps = list.map(asRaw);
+  const indexOfId = (id) => steps.findIndex((s) => s?.id === id);
+  if (step.id !== void 0) {
+    const at2 = indexOfId(String(step.id));
+    if (at2 >= 0) return steps[at2];
+  }
+  const recordedIds = new Set(
+    recorded.filter((r) => r !== step && r.id !== void 0).map((r) => String(r.id))
+  );
+  const fits = (s) => !!s && s.do === step.do && !(typeof s.id === "string" && recordedIds.has(s.id)) && !(typeof s.selector === "string" && typeof step.selector === "string" && s.selector !== step.selector);
+  const named = recorded.filter(
+    (r) => r !== step && r.id !== void 0 && indexOfId(String(r.id)) >= 0
+  );
+  const before = named.filter((r) => r.step < step.step).sort((a, b) => b.step - a.step)[0];
+  const after = named.filter((r) => r.step > step.step).sort((a, b) => a.step - b.step)[0];
+  const found = /* @__PURE__ */ new Set();
+  for (const anchor of [before, after]) {
+    if (!anchor) continue;
+    const hit = steps[indexOfId(String(anchor.id)) + step.step - anchor.step];
+    if (fits(hit)) found.add(hit);
+  }
+  if (found.size === 1) return [...found][0];
+  if (found.size > 1) return void 0;
+  const own = steps[step.step];
+  return fits(own) ? own : void 0;
+}
+function scriptDrift(recorded, list) {
+  if (!Array.isArray(list) || !recorded.length) return null;
+  const changed = [];
+  for (const step of recorded) {
+    const raw = scriptStepOf(step, list, recorded);
+    const id = step.id !== void 0 ? { id: String(step.id) } : {};
+    if (!raw) {
+      changed.push({ step: step.step, ...id, was: step.do, now: null });
+      continue;
+    }
+    const selectorMoved = typeof raw.selector === "string" && typeof step.selector === "string" && raw.selector !== step.selector;
+    if (raw.do !== step.do || selectorMoved)
+      changed.push({
+        step: step.step,
+        ...id,
+        was: step.selector ? `${step.do} ${step.selector}` : step.do,
+        now: typeof raw.selector === "string" ? `${String(raw.do)} ${raw.selector}` : String(raw.do)
+      });
+  }
+  if (list.length === recorded.length && !changed.length) return null;
+  return { recorded: recorded.length, inScript: list.length, changed };
+}
+function scriptDriftLine(d, file = "actions.json") {
+  const counts = d.inScript === d.recorded ? `${file} no longer matches what was recorded` : `${file} has ${d.inScript} step${d.inScript === 1 ? "" : "s"} and the take recorded ${d.recorded} (meta.steps)`;
+  const shown = d.changed.slice(0, 3).map(
+    (c) => `#${c.step}${c.id ? ` ${c.id}` : ""} was ${c.was}, ${c.now === null ? "not found in the file" : `now ${c.now}`}`
+  );
+  const changed = d.changed.length ? `; ${d.changed.length} recorded step${d.changed.length === 1 ? "" : "s"} changed (${shown.join("; ")}${d.changed.length > 3 ? "; \u2026" : ""})` : "";
+  return `${counts}${changed}: captions and zoom marks are matched to the recorded steps by id, then by place beside a named step, then by index (vos info shows where each lands; record again to bring them back in step)`;
+}
+
+// src/plugin/stepCaptions.ts
 var STEP_CAPTIONS_FROM = "steps";
-var STEP_CAPTION_OFFSET = 0.2;
+var STEP_CAPTION_AT = "start";
 var CAPTION_MAX = 3;
 var CAPTION_MIN = 1.2;
 var CAPTION_GAP = 0.1;
-function captionOf(step, actions, script) {
+function captionOf(step, actions, script, recorded = []) {
   const own = step.caption;
   if (typeof own === "string" && own.trim()) return own.trim();
   for (const list of [
     actions?.steps,
     Array.isArray(script?.steps) ? script.steps : void 0
   ]) {
-    if (!Array.isArray(list)) continue;
-    const byId = step.id !== void 0 ? list.find((s) => s?.id === step.id) : void 0;
-    const raw = byId ?? list[step.step];
+    const raw = scriptStepOf(step, list, recorded);
     if (typeof raw?.caption === "string" && raw.caption.trim())
       return raw.caption.trim();
   }
   return null;
 }
 var safeId = (v) => String(v).replace(/[^A-Za-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "") || "step";
-function landStepCaptions(doc, actions) {
+function landStepCaptions(doc, actions, opts = {}) {
   const report = { landed: [], skipped: [], uncaptioned: [] };
-  const kept = (doc.overlays ?? []).filter((o) => o.from !== STEP_CAPTIONS_FROM);
+  const mine = (o) => !opts.only || opts.only.has(mediaKey(o.anchor?.media));
+  const kept = (doc.overlays ?? []).filter(
+    (o) => o.from !== STEP_CAPTIONS_FROM || !mine(o)
+  );
   const rated = ratedSegments8(doc);
   const footageEnd = totalDuration(rated);
   const docSegments = doc.segments.length ? doc.segments : [{ in: 0, out: doc.source.meta.durationMs / 1e3 }];
@@ -14229,10 +14579,11 @@ function landStepCaptions(doc, actions) {
   const fresh = [];
   const taken = new Set(kept.map((o) => o.id));
   for (const { id: media, source } of docMediaList2(doc)) {
+    if (opts.only && !opts.only.has(media)) continue;
     const steps = source.meta.steps ?? [];
     let captioned = 0;
     for (const step of steps) {
-      const caption = captionOf(step, actions.get(media), source.script);
+      const caption = captionOf(step, actions.get(media), source.script, steps);
       if (!caption) continue;
       captioned++;
       const ref = step.id ?? step.step;
@@ -14248,8 +14599,7 @@ function landStepCaptions(doc, actions) {
       const anchor = {
         step: ref,
         ...media ? { media } : {},
-        at: "end",
-        offset: STEP_CAPTION_OFFSET
+        at: STEP_CAPTION_AT
       };
       const placed = resolveAnchor5(doc, anchor, rated);
       if (placed.start === null) {
@@ -14267,6 +14617,7 @@ function landStepCaptions(doc, actions) {
       taken.add(id);
       const clip = {
         ...houseCaption(id, caption, placed.start, CAPTION_MAX),
+        start: placed.start,
         anchor,
         from: STEP_CAPTIONS_FROM
       };
@@ -14303,55 +14654,1072 @@ function bareCaptionsFlag(argv) {
   );
 }
 
-// src/plugin/join.ts
-var FULL_BLEED_FRAME = {
-  inset: { top: 0, right: 0, bottom: 0, left: 0 },
-  radius: 0,
-  shadow: 0,
-  shadowContact: 0,
-  border: 0,
-  fit: "cover"
-};
-var round32 = (v) => Math.round(v * 1e3) / 1e3;
-var FILE_SOUND_FADE = 0.15;
-var prefixed = (id, key) => `${id}/${takeRelativeFile(key)}`;
-function fileDoc(key, probed, t0 = 0) {
-  const meta = {
-    dpr: 1,
-    zoom: 1,
-    t0,
-    durationMs: probed.durationMs,
-    width: probed.width,
-    height: probed.height,
-    captureWidth: probed.width,
-    captureHeight: probed.height,
-    fps: probed.fps > 0 ? probed.fps : 30,
-    hasAudio: probed.hasAudio,
-    producer: "ingest"
+// src/plugin/beats.ts
+import { docMediaList as docMediaList3, mediaKey as mediaKey2, rejectSpan } from "@vosjs/studio-core";
+var PER_BEAT_NOTE = "one zoom per beat";
+var ZOOM_FALSE_NOTE = "zoom: false in the script";
+var ZOOM_MODES = ["per-beat"];
+function zoomModeOf(raw) {
+  if (raw === void 0) return null;
+  if (ZOOM_MODES.includes(raw)) return raw;
+  return {
+    error: `--zooms expects ${ZOOM_MODES.join(" or ")}, got "${raw}"`
   };
-  const doc = projectFromArtifact2({ videoKey: key, cursor: [], meta }, key, {
-    footage: true
-  }).doc;
-  doc.segments = [{ in: 0, out: round32(probed.durationMs / 1e3) }];
-  return doc;
 }
-function endingLayers(doc) {
-  const pieces = ratedSegments9(doc);
-  const end = totalDuration2(pieces);
-  if (!(end > 0)) return [];
-  return (doc.overlays ?? []).filter((o) => {
-    const start = o.anchor ? resolveAnchor6(doc, o.anchor, pieces).start ?? o.start : o.start;
-    return start >= end - 1e-3;
+var LAST_GESTURE_VERBS = [
+  "click",
+  "drag",
+  "type",
+  "paste"
+];
+function zoomMarkOf(step, actions, script, recorded = []) {
+  const inList = (list) => {
+    const raw = scriptStepOf(step, list, recorded);
+    return typeof raw?.zoom === "boolean" ? raw.zoom : void 0;
+  };
+  return inList(actions?.steps) ?? (typeof step.zoom === "boolean" ? step.zoom : void 0) ?? inList(script?.steps);
+}
+var beatStep = (s) => ({
+  step: s.step,
+  ...s.id ? { id: s.id } : {},
+  do: s.do,
+  in: s.tStart,
+  out: Math.max(s.tStart, s.tEnd)
+});
+function markedSteps(source, actions) {
+  return [...source.meta.steps ?? []].filter((s) => typeof s.tStart === "number" && !s.skipped).sort((a, b) => a.tStart - b.tStart || a.step - b.step).map((s) => ({
+    s,
+    mark: zoomMarkOf(s, actions, source.script, source.meta.steps ?? [])
+  }));
+}
+function mediaBeats(media, source, actions) {
+  const end = (source.meta.durationMs || 0) / 1e3;
+  const starts = [];
+  for (const step of source.meta.steps ?? []) {
+    if (typeof step.tStart !== "number") continue;
+    const caption = captionOf(
+      step,
+      actions,
+      source.script,
+      source.meta.steps ?? []
+    );
+    if (caption) starts.push({ step, caption });
+  }
+  if (!starts.length) return [];
+  starts.sort((a, b) => a.step.tStart - b.step.tStart);
+  const steps = markedSteps(source, actions);
+  const beat = (step, caption, from, to, last) => {
+    const mine = steps.filter(
+      (x) => x.s.tStart >= from && (x.s.tStart < to || last)
+    );
+    const gesture = mine.filter((x) => LAST_GESTURE_VERBS.includes(x.s.do) && x.mark !== false).at(-1);
+    return {
+      media,
+      step,
+      caption,
+      in: from,
+      out: to,
+      marked: mine.filter((x) => x.mark === true).map((x) => beatStep(x.s)),
+      ...gesture ? { lastGesture: beatStep(gesture.s) } : {}
+    };
+  };
+  const beats = [];
+  if (starts[0].step.tStart > 0)
+    beats.push(beat(null, null, 0, starts[0].step.tStart, false));
+  starts.forEach(({ step, caption }, i) => {
+    const next = starts[i + 1];
+    beats.push(
+      beat(
+        step.id ?? step.step,
+        caption,
+        step.tStart,
+        next ? next.step.tStart : Math.max(end, step.tStart),
+        !next
+      )
+    );
   });
+  return beats;
+}
+function playedSeconds(doc, z) {
+  const key = mediaKey2(z.media);
+  const segments = doc.segments.length ? doc.segments : [{ in: 0, out: doc.source.meta.durationMs / 1e3 }];
+  let played = 0;
+  for (const s of segments) {
+    if (mediaKey2(s.media) !== key) continue;
+    played += Math.max(0, Math.min(s.out, z.out) - Math.max(s.in, z.in));
+  }
+  return played;
+}
+var ms = (v) => Math.round(v * 1e3);
+function stepOverlap(z, step) {
+  if (!step) return 0;
+  const shared = Math.min(z.out, step.out) - Math.max(z.in, step.in);
+  if (shared > 0) return shared;
+  return step.out - step.in < 1e-3 && z.in <= step.in && step.in <= z.out ? 1e-6 : 0;
+}
+function onStep(z, step) {
+  const shorter = Math.min(z.out - z.in, step.out - step.in);
+  return shorter > 0 ? stepOverlap(z, step) > shorter / 2 : stepOverlap(z, step) > 0;
+}
+function stronger(doc) {
+  return (a, b) => ms(playedSeconds(doc, b)) - ms(playedSeconds(doc, a)) || ms(b.out - b.in) - ms(a.out - a.in) || b.level - a.level || a.in - b.in;
+}
+var overlaps2 = (a, b) => a.in < b.out && b.in < a.out;
+function takeMarksZoom(doc, actions) {
+  return docMediaList3(doc).some(
+    ({ id, source }) => markedSteps(source, actions.get(id)).some((x) => x.mark === true)
+  );
 }
-function dropEnding(d, label, notes) {
-  const ending = endingLayers(d);
-  const legacy = d.endCard !== void 0;
-  if (!ending.length && !legacy) return;
-  const gone = new Set(ending);
-  d.overlays = (d.overlays ?? []).filter((o) => !gone.has(o));
-  if (!d.overlays.length) delete d.overlays;
-  if (legacy) delete d.endCard;
+function rejectAll(doc, drop, note) {
+  if (!drop.size) return 0;
+  const rejected = [...doc.rejected ?? []];
+  for (const z of doc.zoom) {
+    if (!drop.has(z)) continue;
+    const entry = rejectSpan(rejected, "zoom", z, note);
+    if (z.media) entry.media = z.media;
+    rejected.push(entry);
+  }
+  doc.rejected = rejected;
+  doc.zoom = doc.zoom.filter((z) => !drop.has(z));
+  return drop.size;
+}
+function oneZoomPerBeat(doc, actions, opts = {}) {
+  const fallback = !takeMarksZoom(doc, actions);
+  const report = {
+    fallback,
+    kept: [],
+    none: [],
+    manual: [],
+    rejected: 0,
+    uncaptioned: [],
+    beats: 0
+  };
+  const drop = /* @__PURE__ */ new Set();
+  const refused = /* @__PURE__ */ new Set();
+  const order = stronger(doc);
+  for (const { id: media, source } of docMediaList3(doc)) {
+    if (opts.only && !opts.only.has(media)) continue;
+    const beats = mediaBeats(media, source, actions.get(media));
+    const spans = doc.zoom.filter((z) => mediaKey2(z.media) === media);
+    if (!beats.length) {
+      if (spans.length) report.uncaptioned.push(media);
+      continue;
+    }
+    const never = markedSteps(source, actions.get(media)).filter((x) => x.mark === false).map((x) => beatStep(x.s));
+    for (const z of spans) if (never.some((s) => onStep(z, s))) refused.add(z);
+    for (const beat of beats) {
+      const inBeat = spans.filter((z) => {
+        const mid = (z.in + z.out) / 2;
+        return mid >= beat.in && mid < beat.out;
+      });
+      if (inBeat.length) report.beats++;
+      const manual = inBeat.filter((z) => z.source === "manual");
+      const auto = inBeat.filter((z) => z.source !== "manual");
+      if (manual.length) {
+        for (const z of auto) drop.add(z);
+        if (auto.length)
+          report.manual.push({
+            media,
+            step: beat.step,
+            ids: manual.map((z) => z.id)
+          });
+        continue;
+      }
+      const words2 = {
+        media,
+        step: beat.step,
+        caption: beat.caption
+      };
+      if (!inBeat.length) {
+        if (beat.step !== null)
+          report.none.push({
+            ...words2,
+            why: "empty",
+            ids: [],
+            ...beat.marked.length ? {
+              marked: beat.marked.map((m) => ({ step: m.step, do: m.do }))
+            } : {}
+          });
+        continue;
+      }
+      const targets = fallback ? beat.step === null || !beat.lastGesture ? [] : [beat.lastGesture] : beat.marked;
+      if (!targets.length) {
+        for (const z of auto) drop.add(z);
+        if (auto.length)
+          report.none.push({
+            ...words2,
+            why: !fallback ? "unmarked" : beat.step === null ? "opening" : "no-gesture",
+            ids: auto.map((z) => z.id)
+          });
+        continue;
+      }
+      const candidates = auto.filter((z) => !never.some((s) => onStep(z, s)));
+      const chosen = [];
+      for (const target of targets) {
+        const action = { step: target.step, do: target.do };
+        const [best] = candidates.filter(
+          (z) => stepOverlap(z, target) > 0 && !chosen.some((c) => c === z || overlaps2(c, z))
+        ).sort(
+          (a, b) => ms(stepOverlap(b, target)) - ms(stepOverlap(a, target)) || order(a, b)
+        );
+        if (!best) {
+          report.none.push({ ...words2, why: "no-proposal", action, ids: [] });
+          continue;
+        }
+        chosen.push(best);
+        report.kept.push({ ...words2, action, id: best.id });
+      }
+      for (const z of chosen) z.source = "manual";
+      for (const z of auto) if (!chosen.includes(z)) drop.add(z);
+    }
+  }
+  const onNever = new Set([...drop].filter((z) => refused.has(z)));
+  for (const z of onNever) drop.delete(z);
+  report.rejected = rejectAll(doc, onNever, ZOOM_FALSE_NOTE) + rejectAll(doc, drop, PER_BEAT_NOTE);
+  return report;
+}
+function applyZoomMarks(doc, actions) {
+  const report = { rejected: [], unproposed: [] };
+  const drop = /* @__PURE__ */ new Set();
+  for (const { id: media, source } of docMediaList3(doc)) {
+    const spans = doc.zoom.filter((z) => mediaKey2(z.media) === media);
+    for (const { s, mark } of markedSteps(source, actions.get(media))) {
+      const step = beatStep(s);
+      if (mark === false) {
+        const on = spans.filter(
+          (z) => z.source !== "manual" && !drop.has(z) && onStep(z, step)
+        );
+        for (const z of on) drop.add(z);
+        if (on.length)
+          report.rejected.push({
+            media,
+            step: s.step,
+            ids: on.map((z) => z.id)
+          });
+      } else if (mark === true && !spans.some((z) => !drop.has(z) && stepOverlap(z, step) > 0)) {
+        report.unproposed.push({
+          media,
+          step: s.step,
+          ...s.id ? { id: s.id } : {},
+          do: s.do
+        });
+      }
+    }
+  }
+  rejectAll(doc, drop, ZOOM_FALSE_NOTE);
+  return report;
+}
+function zoomMarkLine(r, name = (m) => m ? `media ${m}` : "the primary") {
+  const at2 = (x) => `#${x.step}${x.media ? ` of ${name(x.media)}` : ""}`;
+  const parts = [];
+  if (r.rejected.length)
+    parts.push(
+      `zoom: false rejected ${r.rejected.map((x) => `${x.ids.join(", ")} on step ${at2(x)}`).join("; ")}`
+    );
+  if (r.unproposed.length)
+    parts.push(
+      `zoom: true on ${r.unproposed.map((x) => `step ${at2(x)} ${x.id ? `${x.id} ` : ""}${x.do}`).join(", ")}, but the planner proposed no zoom there (none is invented)`
+    );
+  return parts.length ? parts.join("; ") : null;
+}
+function perBeatLine(r, name = (m) => m ? `media ${m}` : "the primary") {
+  const parts = [
+    `one zoom per beat: ${r.beats} beat${r.beats === 1 ? "" : "s"} held zooms, ${r.kept.length} kept (now manual), ${r.rejected} rejected into doc.rejected (no re-plan brings them back)`
+  ];
+  if (r.fallback)
+    parts.push(
+      `no step is marked "zoom": falling back to each beat's last gesture`
+    );
+  const beatName = (b) => b.step === null ? `the opening${b.media ? ` of ${name(b.media)}` : ""}` : `beat ${b.caption ? JSON.stringify(b.caption) : String(b.step)}${b.media ? ` (${name(b.media)})` : ""}`;
+  const target = (a) => `${r.fallback ? "last gesture" : "marked"} #${a.step} ${a.do}`;
+  for (const b of r.kept)
+    parts.push(`${beatName(b)}: ${target(b.action)}, kept ${b.id}`);
+  for (const b of r.none)
+    parts.push(
+      `${beatName(b)}: ${b.why === "empty" ? `no proposal in this beat${b.marked?.length ? ` (marked ${b.marked.map((m) => `#${m.step} ${m.do}`).join(", ")})` : ""}` : b.why === "no-proposal" && b.action ? `${target(b.action)}, but no proposal on it` : b.why === "unmarked" ? 'no step marked "zoom", no zoom' : b.why === "no-gesture" ? "no gesture to stand in, no zoom" : "no zoom"}`
+    );
+  if (r.manual.length)
+    parts.push(
+      `${r.manual.length} beat${r.manual.length === 1 ? "" : "s"} kept ${r.manual.length === 1 ? "its" : "their"} manual zoom${r.manual.some((m) => m.ids.length > 1) ? "s" : ""}`
+    );
+  if (r.uncaptioned.length)
+    parts.push(
+      `no captioned step in ${r.uncaptioned.map(name).join(", ")}, so ${r.uncaptioned.length === 1 ? "its" : "their"} zooms stay as planned`
+    );
+  return parts.join("; ");
+}
+
+// src/plugin/rejoin.ts
+import { createHash as createHash4 } from "crypto";
+import { createReadStream, existsSync as existsSync24 } from "fs";
+import { readFile as readFile16 } from "fs/promises";
+import { join as join26 } from "path";
+import {
+  isRejected as isRejected2,
+  layerStart as layerStart3,
+  mediaKey as mediaKey3,
+  mediaRefId,
+  ratedSegments as ratedSegments9,
+  resolveAnchor as resolveAnchor6,
+  segmentOutputExtents as segmentOutputExtents3
+} from "@vosjs/studio-core";
+import { totalDuration as totalDuration2 } from "@vosjs/timeline";
+import { splitSegmentsAtSkips as splitSegmentsAtSkips2 } from "@vosjs/render-core/record";
+var JOIN_RECORD_NAME = "join.json";
+var round32 = (v) => Math.round(v * 1e3) / 1e3;
+function fileHash(file) {
+  return new Promise((done, fail) => {
+    const h = createHash4("sha256");
+    createReadStream(file).on("data", (c) => h.update(c)).on("error", fail).on("end", () => done(h.digest("hex")));
+  });
+}
+async function partFootage(part) {
+  if (part.file) return fileHash(part.file.path);
+  const key = part.doc.source.videoKey;
+  if (!isTakeRelativeKey(key))
+    return `key:${createHash4("sha256").update(key).digest("hex")}`;
+  const file = join26(part.dir, takeRelativeFile(key));
+  return existsSync24(file) ? fileHash(file) : `key:${createHash4("sha256").update(key).digest("hex")}`;
+}
+async function readJoinRecord(dir) {
+  const file = join26(dir, JOIN_RECORD_NAME);
+  if (!existsSync24(file)) return null;
+  try {
+    const v = JSON.parse(await readFile16(file, "utf8"));
+    return v && v.version === 1 && Array.isArray(v.inputs) ? v : null;
+  } catch {
+    return null;
+  }
+}
+async function recordFromFootage(dir, doc) {
+  const hash = async (key) => {
+    if (!isTakeRelativeKey(key))
+      return `key:${createHash4("sha256").update(key).digest("hex")}`;
+    const file = join26(dir, takeRelativeFile(key));
+    return existsSync24(file) ? fileHash(file) : `missing:${key}`;
+  };
+  const inputs = [
+    {
+      path: "",
+      kind: "take",
+      footage: await hash(doc.source.videoKey),
+      media: ""
+    }
+  ];
+  for (const m of doc.media ?? [])
+    inputs.push({
+      path: "",
+      kind: "take",
+      footage: await hash(m.videoKey),
+      media: m.id
+    });
+  return { version: 1, inputs };
+}
+function joinRecordOf(inputs, ids) {
+  return {
+    version: 1,
+    inputs: inputs.map((x, i) => {
+      const sub = ids[i]?.sub ?? {};
+      return {
+        path: x.path,
+        kind: x.part.kind,
+        footage: x.footage,
+        media: ids[i]?.id ?? "",
+        ...Object.keys(sub).length ? { sub } : {}
+      };
+    })
+  };
+}
+function matchInputs(prev, next) {
+  const match = next.map(() => null);
+  const claimed = /* @__PURE__ */ new Set();
+  const pass = (same) => {
+    next.forEach((n, i) => {
+      if (match[i] !== null) return;
+      const j = prev.findIndex(
+        (p, k) => !claimed.has(k) && p.footage === n.footage && same(p, n)
+      );
+      if (j >= 0) {
+        match[i] = j;
+        claimed.add(j);
+      }
+    });
+  };
+  pass((p, n) => p.path !== "" && p.path === n.path);
+  pass(() => true);
+  const changed = [];
+  const removed = [];
+  prev.forEach((p, j) => {
+    if (claimed.has(j)) return;
+    const back = p.path !== "" && next.some((n, i) => match[i] === null && n.path === p.path);
+    (back ? changed : removed).push(j);
+  });
+  return { match, changed, removed };
+}
+var keysOf = (x) => [
+  x.media,
+  ...Object.values(x.sub ?? {})
+];
+var scriptUrl = (m) => {
+  const s = m?.script;
+  return typeof s?.url === "string" ? s.url : void 0;
+};
+var SAME_SCRIPT = 0.5;
+function rerecordedInputs(prev, record, inputs, m) {
+  const pairs = /* @__PURE__ */ new Map();
+  const mediaOf = (k) => (prev.media ?? []).find((x) => x.id === k);
+  const fit = (j) => {
+    const x = record.inputs[j];
+    if (x.kind !== "take" || x.media === "" || Object.keys(x.sub ?? {}).length)
+      return null;
+    const media = mediaOf(x.media);
+    const steps = media?.meta.steps ?? [];
+    return media && steps.length ? { media, steps } : null;
+  };
+  const open = (i) => i > 0 && m.match[i] === null && !pairs.has(i) && inputs[i].part.kind === "take" && !(inputs[i].part.doc.media ?? []).length && !!inputs[i].part.doc.source.meta.steps?.length;
+  for (const j of m.changed) {
+    if (!fit(j)) continue;
+    const i = inputs.findIndex(
+      (n, at2) => open(at2) && n.path === record.inputs[j].path
+    );
+    if (i >= 0) pairs.set(i, j);
+  }
+  for (const j of m.removed) {
+    const old = fit(j);
+    if (!old) continue;
+    const ids = [
+      ...new Set(old.steps.map((s) => s.id).filter((v) => !!v))
+    ];
+    if (!ids.length) continue;
+    const url = scriptUrl(old.media);
+    let best = -1;
+    let bestScore = SAME_SCRIPT;
+    let tie = false;
+    inputs.forEach((n, i) => {
+      if (!open(i)) return;
+      const there = scriptUrl(n.part.doc.source) ?? n.part.actions?.url;
+      if (url && there && url !== there) return;
+      const now = new Set((n.part.doc.source.meta.steps ?? []).map((s) => s.id));
+      const score = ids.filter((id) => now.has(id)).length / ids.length;
+      if (score > bestScore) {
+        best = i;
+        bestScore = score;
+        tie = false;
+      } else if (score === bestScore && best >= 0) tie = true;
+    });
+    if (best >= 0 && !tie) pairs.set(best, j);
+  }
+  return pairs;
+}
+function mediaView(doc, media, segments) {
+  const own = (xs) => (xs ?? []).filter((x) => mediaKey3(x.media) === media.id).map((x) => {
+    const { media: _, ...rest } = x;
+    return rest;
+  });
+  return {
+    ...doc,
+    source: {
+      videoKey: media.videoKey,
+      cursor: media.cursor,
+      meta: media.meta
+    },
+    segments: own(segments),
+    zoom: own(doc.zoom),
+    speed: own(doc.speed),
+    tilt: own(doc.tilt),
+    freeze: own(doc.freeze),
+    rejected: own(doc.rejected),
+    media: void 0
+  };
+}
+function rejoinDocs(prev, record, inputs, opts = {}) {
+  const where = opts.where ?? ((p) => p);
+  const { match, changed, removed } = matchInputs(record.inputs, inputs);
+  const first = match[0] === null ? null : record.inputs[match[0]];
+  if (!first || first.media !== "")
+    throw new UsageError(
+      `--keep-edits: ${inputs[0].part.label} is not the primary this take was joined from (its first input, footage unchanged). The primary carries the cut's frame and camera; keep it first, or join afresh with --force`
+    );
+  const redo = rerecordedInputs(prev, record, inputs, {
+    match,
+    changed,
+    removed
+  });
+  const redoneFrom = new Set(redo.values());
+  const isNew = (i) => match[i] === null && !redo.has(i);
+  const parts = inputs.map((x, i) => {
+    const j = match[i];
+    if (i === 0 || j === null) return x.part;
+    const was = record.inputs[j];
+    return { ...x.part, id: was.media, ...was.sub ? { subIds: was.sub } : {} };
+  });
+  const reserved = /* @__PURE__ */ new Set([
+    ...record.inputs.flatMap(keysOf),
+    ...(prev.media ?? []).map((m) => m.id)
+  ]);
+  const fresh = joinDocs(parts, { reserved });
+  const argOf = /* @__PURE__ */ new Map();
+  const newIds = /* @__PURE__ */ new Set();
+  const kept = /* @__PURE__ */ new Set();
+  fresh.ids.forEach((ids, i) => {
+    for (const k of [ids.id, ...Object.values(ids.sub)]) {
+      argOf.set(k, i);
+      if (isNew(i)) newIds.add(k);
+    }
+  });
+  match.forEach((j, i) => {
+    if (j === null) return;
+    for (const k of keysOf(record.inputs[j])) kept.add(k);
+    for (const k of [fresh.ids[i].id, ...Object.values(fresh.ids[i].sub)])
+      kept.add(k);
+  });
+  kept.add("");
+  const dropped = /* @__PURE__ */ new Set();
+  for (const k of [
+    ...record.inputs.flatMap(keysOf),
+    ...(prev.media ?? []).map((m) => m.id)
+  ])
+    if (!kept.has(k)) dropped.add(k);
+  const report = {
+    kept: [],
+    added: [],
+    dropped: [],
+    rerecorded: [],
+    regrouped: false,
+    shifted: [],
+    notes: []
+  };
+  inputs.forEach((x, i) => {
+    const j = match[i];
+    if (j === null) {
+      if (isNew(i))
+        report.added.push({ label: x.part.label, id: fresh.ids[i].id });
+      return;
+    }
+    const was = record.inputs[j];
+    report.kept.push({
+      label: x.part.label,
+      id: was.media,
+      ...was.path && was.path !== x.path ? { moved: where(was.path) } : {}
+    });
+  });
+  const doc = structuredClone(prev);
+  const keyOf = (s) => mediaKey3(s.media);
+  const prevSegments = prev.segments.length ? prev.segments : [{ in: 0, out: round32(prev.source.meta.durationMs / 1e3) }];
+  const prevExt = segmentOutputExtents3(prev);
+  const prevFootage = totalDuration2(ratedSegments9(prev));
+  const redoByOld = /* @__PURE__ */ new Map();
+  for (const [i, j] of redo) {
+    const from = record.inputs[j].media;
+    const to = fresh.ids[i].id;
+    const was = (prev.media ?? []).find((m) => m.id === from);
+    const view = mediaView(prev, was, prevSegments);
+    const meta = inputs[i].part.doc.source.meta;
+    const rt = retimeCut(view, meta.steps ?? [], meta.durationMs);
+    const cut = view.segments.length ? splitSegmentsAtSkips2(rt.segments, meta.skips) : [];
+    const x = inputs[i];
+    redoByOld.set(from, {
+      i,
+      from,
+      to,
+      rt,
+      segments: cut.map((sg) => ({ ...sg, media: to })),
+      placed: false,
+      entry: {
+        label: x.part.label,
+        from,
+        id: to,
+        ...record.inputs[j].path && record.inputs[j].path !== x.path ? { was: where(record.inputs[j].path) } : {},
+        segments: cut.length,
+        spans: 0,
+        layers: [],
+        flagged: [...rt.report.flagged]
+      }
+    });
+  }
+  const redoTo = new Set([...redoByOld.values()].map((r) => r.to));
+  let segments = prevSegments.flatMap((sg) => {
+    const r = redoByOld.get(keyOf(sg));
+    if (r) {
+      if (r.placed) return [];
+      r.placed = true;
+      return r.segments;
+    }
+    return kept.has(keyOf(sg)) ? [sg] : [];
+  });
+  const keptOrder = match.filter((j) => j !== null);
+  const inOrder = keptOrder.every((j, k) => k === 0 || keptOrder[k - 1] < j);
+  if (!inOrder) {
+    report.regrouped = true;
+    segments = segments.map((s, at2) => ({ s, at: at2, arg: argOf.get(keyOf(s)) ?? 0 })).sort((a, b) => a.arg - b.arg || a.at - b.at).map((x) => x.s);
+  }
+  const freshSegs = fresh.doc.segments;
+  const freshExt = segmentOutputExtents3(fresh.doc);
+  const firstFresh = /* @__PURE__ */ new Map();
+  inputs.forEach((_, i) => {
+    if (!isNew(i)) return;
+    const mine = freshSegs.map((s, at3) => ({ s, at: at3 })).filter((x) => argOf.get(keyOf(x.s)) === i);
+    if (!mine.length) return;
+    firstFresh.set(i, mine[0].at);
+    let at2 = segments.length;
+    for (let n = i + 1; n < inputs.length; n++) {
+      if (isNew(n)) continue;
+      const k = segments.findIndex((s) => argOf.get(keyOf(s)) === n);
+      if (k >= 0) {
+        at2 = k;
+        break;
+      }
+    }
+    segments.splice(at2, 0, ...mine.map((x) => x.s));
+  });
+  doc.segments = segments;
+  const freshMedia = new Map((fresh.doc.media ?? []).map((m) => [m.id, m]));
+  const media = [
+    ...(prev.media ?? []).filter((m) => kept.has(m.id)).map((m) => {
+      const f = freshMedia.get(m.id);
+      return !m.script && f?.script ? { ...m, script: f.script } : m;
+    }),
+    ...(fresh.doc.media ?? []).filter(
+      (m) => newIds.has(m.id) || redoTo.has(m.id)
+    )
+  ].map((m, at2) => ({ m, at: at2, arg: argOf.get(m.id) ?? 0 })).sort((a, b) => a.arg - b.arg || a.at - b.at).map((x) => x.m);
+  if (media.length) doc.media = media;
+  else delete doc.media;
+  const spanLanes = [
+    "zoom",
+    "speed",
+    "tilt",
+    "camMotion",
+    "freeze",
+    "rejected"
+  ];
+  const dropCount = /* @__PURE__ */ new Map();
+  const tally = (k, what) => {
+    const c = dropCount.get(k) ?? { segments: 0, spans: 0 };
+    c[what]++;
+    dropCount.set(k, c);
+  };
+  for (const s of prevSegments)
+    if (dropped.has(keyOf(s)) && !redoByOld.has(keyOf(s)))
+      tally(keyOf(s), "segments");
+  const redoSpans = (lane) => {
+    const out = [];
+    for (const r of redoByOld.values()) {
+      const tag = (x) => ({ ...x, media: r.to });
+      let mine;
+      if (lane === "camMotion") {
+        mine = (prev.camMotion ?? []).filter((x) => keyOf(x) === r.from).map(tag);
+      } else {
+        mine = r.rt[lane].map(tag);
+        if (lane === "zoom" || lane === "speed" || lane === "tilt") {
+          const rejected = r.rt.rejected;
+          const proposed = (fresh.doc[lane] ?? []).filter(
+            (x) => keyOf(x) === r.to && x.source === "auto" && !mine.some((m) => x.in < m.out && m.in < x.out) && !isRejected2(lane, x, rejected)
+          );
+          r.entry.spans += mine.length;
+          mine = [...mine, ...proposed];
+        } else if (lane === "rejected") {
+          const fromTake = (fresh.doc.rejected ?? []).filter(
+            (x) => keyOf(x) === r.to && !isRejected2(x.lane, x, r.rt.rejected)
+          );
+          r.entry.spans += mine.length;
+          mine = [...mine, ...fromTake];
+        } else r.entry.spans += mine.length;
+      }
+      if (lane === "camMotion") r.entry.spans += mine.length;
+      out.push(...mine);
+    }
+    return out;
+  };
+  for (const lane of spanLanes) {
+    const before = prev[lane] ?? [];
+    for (const s of before)
+      if (dropped.has(keyOf(s)) && !redoByOld.has(keyOf(s)))
+        tally(keyOf(s), "spans");
+    const next = [
+      ...before.filter((s) => kept.has(keyOf(s))),
+      ...redoSpans(lane),
+      ...(fresh.doc[lane] ?? []).filter(
+        (s) => newIds.has(keyOf(s))
+      )
+    ];
+    if (next.length) doc[lane] = next;
+    else delete doc[lane];
+  }
+  const newExt = segmentOutputExtents3(doc);
+  const newFootage = totalDuration2(ratedSegments9(doc));
+  const placeOf = /* @__PURE__ */ new Map();
+  segments.forEach((s, i) => placeOf.set(s, i));
+  const follow = (t) => {
+    for (let i = 0; i < prevExt.length; i++) {
+      const e = prevExt[i];
+      if (t >= e.start - 1e-6 && t < e.end - 1e-6) {
+        const at2 = placeOf.get(prevSegments[i]);
+        if (at2 === void 0) return null;
+        const moved = newExt[at2].start + (t - e.start);
+        return Math.abs(moved - t) < 1e-9 ? t : round32(moved);
+      }
+    }
+    if (t >= prevFootage - 1e-6) {
+      const moved = newFootage + (t - prevFootage);
+      return Math.abs(moved - t) < 1e-9 ? t : round32(moved);
+    }
+    return t;
+  };
+  const deltaOf = (k) => {
+    const i = argOf.get(k);
+    if (i === void 0) return 0;
+    const at2 = firstFresh.get(i);
+    if (at2 === void 0) return 0;
+    const now = placeOf.get(freshSegs[at2]);
+    return now === void 0 ? 0 : newExt[now].start - freshExt[at2].start;
+  };
+  const droppedItems = /* @__PURE__ */ new Map();
+  const lose = (k, what, id) => {
+    const c = droppedItems.get(k) ?? { layers: [], sound: [] };
+    c[what].push(id);
+    droppedItems.set(k, c);
+  };
+  const footageAt = (t) => {
+    for (let i = 0; i < prevExt.length; i++) {
+      const e = prevExt[i];
+      if (t >= e.start - 1e-6 && t < e.end - 1e-6) return keyOf(prevSegments[i]);
+    }
+    return null;
+  };
+  const blockOf = (segs, ext2, k) => {
+    const at2 = segs.flatMap((sg, i) => keyOf(sg) === k ? [ext2[i]] : []);
+    return at2.length ? { start: at2[0].start, end: at2[at2.length - 1].end } : null;
+  };
+  const place2 = (t) => {
+    const k = footageAt(t);
+    const r = k === null ? void 0 : redoByOld.get(k);
+    if (!r) return follow(t);
+    const was = blockOf(prevSegments, prevExt, r.from);
+    const now = blockOf(segments, newExt, r.to);
+    if (!was || !now) return null;
+    const moved = now.start + (t - was.start);
+    if (moved >= now.end - 1e-6) return null;
+    return Math.abs(moved - t) < 1e-9 ? t : round32(moved);
+  };
+  const loseOver = (t, what) => {
+    const r = redoByOld.get(footageAt(t) ?? "\0");
+    if (!r) return false;
+    r.entry.flagged.push(
+      `${what} (${t.toFixed(2)} s): it played over this input's footage past where its new recording ends; dropped`
+    );
+    return true;
+  };
+  const overlays = [];
+  const redoLayers = /* @__PURE__ */ new Map();
+  for (const prevLayer of prev.overlays ?? []) {
+    let o = prevLayer;
+    const refMedia = o.kind !== "text" && o.kind !== "html" ? mediaRefId(o.key) : null;
+    const owner = o.anchor ? mediaKey3(o.anchor.media) : null;
+    const goes = (k) => k !== null && dropped.has(k) && !redoByOld.has(k);
+    const gone = goes(owner) && owner || goes(refMedia) && refMedia || null;
+    if (gone) {
+      lose(gone, "layers", o.id);
+      continue;
+    }
+    const byOwner = owner === null ? void 0 : redoByOld.get(owner);
+    if (byOwner && o.anchor) {
+      o = { ...o, anchor: { ...o.anchor, media: byOwner.to } };
+      redoLayers.set(o.id, byOwner);
+    }
+    const byRef = refMedia === null ? void 0 : redoByOld.get(refMedia);
+    if (byRef && o.kind !== "text" && o.kind !== "html") {
+      o = { ...o, key: `media:${byRef.to}` };
+      redoLayers.set(o.id, byRef);
+    }
+    if (o.anchor || o.start === void 0) {
+      overlays.push(o);
+      continue;
+    }
+    const t = place2(o.start);
+    if (t === null) {
+      if (!loseOver(o.start, `layer ${o.id}`))
+        lose(footageAt(o.start) ?? "", "layers", o.id);
+      continue;
+    }
+    const over = redoByOld.get(footageAt(o.start) ?? "\0");
+    if (over) redoLayers.set(o.id, over);
+    if (t !== o.start) report.shifted.push(o.id);
+    overlays.push(t === o.start ? o : { ...o, start: t });
+  }
+  for (const o of fresh.doc.overlays ?? []) {
+    const k = fresh.owners.get(o.id);
+    if (k === void 0 || !newIds.has(k)) continue;
+    const d = o.anchor ? 0 : deltaOf(k);
+    overlays.push(
+      d && o.start !== void 0 ? { ...o, start: round32(o.start + d) } : o
+    );
+  }
+  if (overlays.length) doc.overlays = overlays;
+  else delete doc.overlays;
+  const objects = [];
+  for (const ob of prev.objects ?? []) {
+    if (!ob.span) {
+      objects.push(ob);
+      continue;
+    }
+    const t = place2(ob.span.start);
+    if (t === null) {
+      if (!loseOver(ob.span.start, `prop ${ob.id}`))
+        lose(footageAt(ob.span.start) ?? "", "layers", ob.id);
+      continue;
+    }
+    if (t !== ob.span.start) report.shifted.push(ob.id);
+    objects.push(
+      t === ob.span.start ? ob : { ...ob, span: { ...ob.span, start: t } }
+    );
+  }
+  for (const ob of fresh.doc.objects ?? []) {
+    const k = fresh.owners.get(ob.id);
+    if (k === void 0 || !newIds.has(k)) continue;
+    const d = deltaOf(k);
+    objects.push(
+      d && ob.span ? { ...ob, span: { ...ob.span, start: round32(ob.span.start + d) } } : ob
+    );
+  }
+  if (objects.length) doc.objects = objects;
+  else delete doc.objects;
+  const allPrev = /* @__PURE__ */ new Set([...dropped, ...kept]);
+  const audio = [];
+  for (const a of prev.audio) {
+    const m = /^(.*)-sound$/.exec(a.id);
+    const k = m && allPrev.has(m[1]) ? m[1] : null;
+    if (k === null) {
+      audio.push(a);
+      continue;
+    }
+    const r = redoByOld.get(k);
+    if (r) {
+      r.entry.flagged.push(
+        `sound ${a.id}: it was the old recording's own sound; dropped`
+      );
+      continue;
+    }
+    if (dropped.has(k)) {
+      lose(k, "sound", a.id);
+      continue;
+    }
+    const t = follow(a.start);
+    if (t === null) {
+      lose(k, "sound", a.id);
+      continue;
+    }
+    if (t !== a.start) report.shifted.push(a.id);
+    audio.push(t === a.start ? a : { ...a, start: t });
+  }
+  for (const a of fresh.doc.audio) {
+    const k = fresh.owners.get(a.id);
+    if (k === void 0 || !newIds.has(k)) continue;
+    const d = deltaOf(k);
+    audio.push(d ? { ...a, start: round32(a.start + d) } : a);
+  }
+  doc.audio = audio;
+  if (typeof prev.still === "number") {
+    const t = place2(prev.still);
+    if (t === null) {
+      delete doc.still;
+      report.notes.push(
+        `the still (${prev.still.toFixed(2)} s) played over footage that is gone; the cover falls back to its default (vos push --still sets one)`
+      );
+    } else if (t !== prev.still) {
+      doc.still = t;
+      report.shifted.push("still");
+    }
+  }
+  const pieces = ratedSegments9(doc);
+  if (doc.overlays) {
+    doc.overlays = doc.overlays.flatMap((o) => {
+      const r = o.anchor ? resolveAnchor6(doc, o.anchor, pieces) : null;
+      const redone = redoLayers.get(o.id);
+      if (o.anchor && r && r.start === null && redone) {
+        redone.entry.flagged.push(
+          `layer ${o.id}: anchored to step ${String(o.anchor.step)}, which the new recording does not have, skipped, or the cut leaves out; dropped`
+        );
+        return [];
+      }
+      if (redone) redone.entry.layers.push(o.id);
+      return r && r.start !== null && o.start !== void 0 && r.start !== o.start ? [{ ...o, start: r.start }] : [o];
+    });
+    if (!doc.overlays.length) delete doc.overlays;
+  }
+  const prevPieces = ratedSegments9(prev);
+  const wasEnding = new Set(
+    (prev.overlays ?? []).filter((o) => {
+      if (!o.anchor) return false;
+      const r = resolveAnchor6(prev, o.anchor, prevPieces);
+      return r.start !== null && r.start >= prevFootage - 1e-3;
+    }).map((o) => o.id)
+  );
+  const overrun = (doc.overlays ?? []).filter((o) => {
+    if (!wasEnding.has(o.id)) return false;
+    const start = layerStart3(o, doc, pieces);
+    return start !== null && start < newFootage - 1e-3;
+  }).map((o) => o.id);
+  if (overrun.length)
+    report.notes.push(
+      `${overrun.join(", ")} played after the footage and, anchored to ${overrun.length === 1 ? "its" : "their"} step, now ${overrun.length === 1 ? "lands" : "land"} over the footage that follows; anchor ${overrun.length === 1 ? "it" : "them"} to the last input's end, or move ${overrun.length === 1 ? "it" : "them"}`
+    );
+  const labelOf = (k) => {
+    const x = record.inputs.find((r) => keysOf(r).includes(k));
+    return x?.path ? where(x.path) : k ? `media ${k}` : "the primary";
+  };
+  for (const j of [...changed, ...removed]) {
+    if (redoneFrom.has(j)) continue;
+    const x = record.inputs[j];
+    for (const k of keysOf(x)) {
+      const c = dropCount.get(k) ?? { segments: 0, spans: 0 };
+      const items = droppedItems.get(k) ?? { layers: [], sound: [] };
+      report.dropped.push({
+        input: labelOf(k),
+        id: k,
+        why: changed.includes(j) ? "changed" : "removed",
+        segments: c.segments,
+        spans: c.spans,
+        layers: items.layers,
+        sound: items.sound
+      });
+    }
+  }
+  for (const k of dropped) {
+    if (report.dropped.some((d) => d.id === k) || redoByOld.has(k)) continue;
+    const c = dropCount.get(k) ?? { segments: 0, spans: 0 };
+    const items = droppedItems.get(k) ?? { layers: [], sound: [] };
+    report.dropped.push({
+      input: `media ${k}`,
+      id: k,
+      why: "removed",
+      segments: c.segments,
+      spans: c.spans,
+      layers: items.layers,
+      sound: items.sound
+    });
+  }
+  if (Math.abs(newFootage - prevFootage) > 1e-3) {
+    const film = doc.audio.filter((a) => !/-sound$/.test(a.id));
+    if (film.length)
+      report.notes.push(
+        `the footage now runs ${newFootage.toFixed(2)} s (was ${prevFootage.toFixed(2)} s); ${film.map((a) => a.id).join(", ")} kept ${film.length === 1 ? "its" : "their"} seconds (vos score places a score again)`
+      );
+  }
+  report.rerecorded = [...redoByOld.values()].map((r) => r.entry);
+  const newLabels = inputs.filter((_, i) => isNew(i)).map((x) => x.part.label);
+  const notes = fresh.notes.filter(
+    (n) => newLabels.some((l) => n.startsWith(`${l}:`))
+  );
+  const copies = fresh.copies.filter(
+    (c) => [...newIds, ...redoTo].some((k) => k !== "" && c.to.startsWith(`${k}/`))
+  );
+  return {
+    plan: {
+      doc,
+      copies,
+      media: fresh.media,
+      actions: fresh.actions,
+      notes,
+      ids: fresh.ids,
+      owners: fresh.owners
+    },
+    report,
+    newIds,
+    dropped
+  };
+}
+function rejoinLines(r) {
+  const lines = [];
+  const n = (v, one, many = `${one}s`) => `${v} ${v === 1 ? one : many}`;
+  if (r.kept.length)
+    lines.push(
+      `kept the edits of ${r.kept.map((k) => `${k.label} (${k.id || "primary"}${k.moved ? `, found at its new path; was ${k.moved}` : ""})`).join(", ")}`
+    );
+  if (r.added.length)
+    lines.push(`added ${r.added.map((a) => `${a.label} \u2192 ${a.id}`).join(", ")}`);
+  for (const x of r.rerecorded) {
+    lines.push(
+      `re-recorded ${x.label}${x.was ? ` (was ${x.was})` : ""}: ${x.from} \u2192 ${x.id}; its edits re-timed by its steps: ${[
+        n(x.segments, "segment"),
+        n(x.spans, "span"),
+        x.layers.length ? `layers ${x.layers.join(", ")}` : "0 layers"
+      ].join(", ")}`
+    );
+    for (const f of x.flagged) lines.push(`  ${f}`);
+  }
+  for (const d of r.dropped) {
+    const what = [
+      n(d.segments, "segment"),
+      n(d.spans, "span"),
+      ...d.layers.length ? [`layers ${d.layers.join(", ")}`] : [],
+      ...d.sound.length ? [`sound ${d.sound.join(", ")}`] : []
+    ].join(", ");
+    lines.push(
+      `dropped ${d.input} (${d.id || "primary"}): ${d.why === "changed" ? "its footage changed since the join" : "no longer an input"}; ${what} went with it`
+    );
+  }
+  if (r.regrouped)
+    lines.push(
+      "the inputs changed order, so the segments play in argument order again (each input\u2019s own segments in their edited order)"
+    );
+  if (r.shifted.length)
+    lines.push(
+      `${r.shifted.join(", ")} moved with the footage ${r.shifted.length === 1 ? "it plays" : "they play"} over`
+    );
+  lines.push(...r.notes);
+  return lines;
+}
+
+// src/plugin/join.ts
+var FULL_BLEED_FRAME = {
+  inset: { top: 0, right: 0, bottom: 0, left: 0 },
+  radius: 0,
+  shadow: 0,
+  shadowContact: 0,
+  border: 0,
+  fit: "cover"
+};
+var round33 = (v) => Math.round(v * 1e3) / 1e3;
+var FILE_SOUND_FADE = 0.15;
+var prefixed = (id, key) => `${id}/${takeRelativeFile(key)}`;
+function fileDoc(key, probed, t0 = 0) {
+  const meta = {
+    dpr: 1,
+    zoom: 1,
+    t0,
+    durationMs: probed.durationMs,
+    width: probed.width,
+    height: probed.height,
+    captureWidth: probed.width,
+    captureHeight: probed.height,
+    fps: probed.fps > 0 ? probed.fps : 30,
+    hasAudio: probed.hasAudio,
+    producer: "ingest"
+  };
+  const doc = projectFromArtifact2({ videoKey: key, cursor: [], meta }, key, {
+    footage: true
+  }).doc;
+  doc.segments = [{ in: 0, out: round33(probed.durationMs / 1e3) }];
+  return doc;
+}
+function endingLayers(doc) {
+  const pieces = ratedSegments10(doc);
+  const end = totalDuration3(pieces);
+  if (!(end > 0)) return [];
+  return (doc.overlays ?? []).filter((o) => {
+    const start = layerStart4(o, doc, pieces);
+    return start !== null && start >= end - 1e-3;
+  });
+}
+function dropEnding(d, label, notes) {
+  const ending = endingLayers(d);
+  const legacy = d.endCard !== void 0;
+  if (!ending.length && !legacy) return;
+  const gone = new Set(ending);
+  d.overlays = (d.overlays ?? []).filter((o) => !gone.has(o));
+  if (!d.overlays.length) delete d.overlays;
+  if (legacy) delete d.endCard;
   const named = [
     ...ending.map((o) => o.id),
     ...legacy ? ["its endCard"] : []
@@ -14361,9 +15729,9 @@ function dropEnding(d, label, notes) {
   );
 }
 function segs0(d) {
-  return d.segments.length ? d.segments[0] : { in: 0, out: round32(d.source.meta.durationMs / 1e3) };
+  return d.segments.length ? d.segments[0] : { in: 0, out: round33(d.source.meta.durationMs / 1e3) };
 }
-function joinDocs(parts) {
+function joinDocs(parts, opts = {}) {
   if (parts.length < 2)
     throw new UsageError("vos join needs two inputs or more");
   const [first, ...rest] = parts;
@@ -14390,14 +15758,28 @@ function joinDocs(parts) {
     ];
     for (const ref of refs)
       copy({
-        from: join26(first.dir, takeRelativeFile(ref.key)),
+        from: join27(first.dir, takeRelativeFile(ref.key)),
         to: takeRelativeFile(ref.key),
         base: first.dir
       });
   }
   if (!doc.segments.length)
-    doc.segments = [{ in: 0, out: round32(doc.source.meta.durationMs / 1e3) }];
-  const taken = new Set((doc.media ?? []).map((m) => m.id));
+    doc.segments = [{ in: 0, out: round33(doc.source.meta.durationMs / 1e3) }];
+  const taken = /* @__PURE__ */ new Set([
+    ...(doc.media ?? []).map((m) => m.id),
+    ...opts.reserved ?? [],
+    ...rest.flatMap((p) => [
+      ...p.id ? [p.id] : [],
+      ...Object.values(p.subIds ?? {})
+    ])
+  ]);
+  const ids = [
+    {
+      id: "",
+      sub: Object.fromEntries((doc.media ?? []).map((m) => [m.id, m.id]))
+    }
+  ];
+  const owners = /* @__PURE__ */ new Map();
   const allocate = () => {
     let n = 1;
     while (taken.has(`m${n}`)) n++;
@@ -14410,10 +15792,17 @@ function joinDocs(parts) {
   for (const part of rest) {
     const d = structuredClone(migrateMotion3(part.doc));
     if (part !== rest[rest.length - 1]) dropEnding(d, part.label, notes);
-    const pid = allocate();
+    const pid = part.id ?? allocate();
     const idMap = /* @__PURE__ */ new Map([["", pid]]);
-    for (const m of d.media ?? []) idMap.set(m.id, allocate());
-    const mapMedia = (k) => idMap.get(mediaKey2(k)) ?? pid;
+    for (const m of d.media ?? [])
+      idMap.set(m.id, part.subIds?.[m.id] ?? allocate());
+    ids.push({
+      id: pid,
+      sub: Object.fromEntries(
+        (d.media ?? []).map((m) => [m.id, idMap.get(m.id)])
+      )
+    });
+    const mapMedia = (k) => idMap.get(mediaKey4(k)) ?? pid;
     joined.push({ label: part.label, id: pid });
     actions.set(pid, part.actions);
     if (part.file) {
@@ -14452,20 +15841,22 @@ function joinDocs(parts) {
       for (const ref of refs) {
         const to = prefixed(pid, ref.key);
         copy({
-          from: join26(part.dir, takeRelativeFile(ref.key)),
+          from: join27(part.dir, takeRelativeFile(ref.key)),
           to,
           base: part.dir
         });
         ref.set(to);
       }
     }
+    const script = !d.source.script && part.actions ? publicScript(part.actions) : void 0;
     media.push({
       ...d.source,
       id: pid,
+      ...script ? { script } : {},
       ...part.kind === "file" ? { frame: { ...FULL_BLEED_FRAME } } : {}
     });
     for (const m of d.media ?? []) media.push({ ...m, id: idMap.get(m.id) });
-    const segs = d.segments.length ? d.segments : [{ in: 0, out: round32(d.source.meta.durationMs / 1e3) }];
+    const segs = d.segments.length ? d.segments : [{ in: 0, out: round33(d.source.meta.durationMs / 1e3) }];
     const at2 = doc.segments.length;
     doc.segments.push(...segs.map((s) => ({ ...s, media: mapMedia(s.media) })));
     const ns = (id) => `${pid}-${id}`;
@@ -14490,30 +15881,31 @@ function joinDocs(parts) {
     placed.push({ part, d, pid, firstSegment: at2, mapMedia });
   }
   if (media.length) doc.media = media;
-  const extents = segmentOutputExtents3(doc);
+  const extents = segmentOutputExtents4(doc);
   for (const { part, d, pid, firstSegment, mapMedia } of placed) {
     const offset = extents[firstSegment]?.start ?? 0;
-    const ownPieces = ratedSegments9(d);
+    const ownPieces = ratedSegments10(d);
     const ns = (id) => `${pid}-${id}`;
     let dropped = 0;
     for (const o of d.overlays ?? []) {
       const next = { ...o, id: ns(o.id) };
       if (next.kind !== "text" && next.kind !== "html") {
-        const ref = mediaRefId(next.key);
+        const ref = mediaRefId2(next.key);
         if (ref !== null) next.key = `media:${mapMedia(ref)}`;
       }
       if (o.anchor) {
         next.anchor = { ...o.anchor, media: mapMedia(o.anchor.media) };
+      } else if (o.start === void 0) {
       } else if (o.pin?.step !== void 0) {
-        const r = resolveAnchor6(d, { step: o.pin.step }, ownPieces);
+        const r = resolveAnchor7(d, { step: o.pin.step }, ownPieces);
         if (r.start !== null) {
           next.anchor = {
             step: o.pin.step,
             media: pid,
-            offset: round32(o.start - r.start)
+            offset: round33(o.start - r.start)
           };
         } else {
-          next.start = round32(o.start + offset);
+          next.start = round33(o.start + offset);
         }
         delete next.pin;
         dropped++;
@@ -14522,10 +15914,11 @@ function joinDocs(parts) {
           delete next.pin;
           dropped++;
         }
-        next.start = round32(o.start + offset);
+        next.start = round33(o.start + offset);
       }
       ;
       (doc.overlays ??= []).push(next);
+      owners.set(next.id, pid);
     }
     if (dropped)
       notes.push(
@@ -14538,18 +15931,19 @@ function joinDocs(parts) {
         notes.push(`${part.label}: its own sound is left out (--mute)`);
       } else if (seg && at2) {
         const len = Math.max(0, seg.out - seg.in);
-        const fade = round32(Math.min(FILE_SOUND_FADE, len / 4));
+        const fade = round33(Math.min(FILE_SOUND_FADE, len / 4));
         const id = `${pid}-sound`;
+        owners.set(id, pid);
         doc.audio = [
           ...doc.audio,
           {
             id,
             key: d.source.videoKey,
-            name: basename12(part.file.path),
-            start: round32(at2.start),
-            in: round32(seg.in),
-            out: round32(seg.out),
-            duration: round32(d.source.meta.durationMs / 1e3),
+            name: basename13(part.file.path),
+            start: round33(at2.start),
+            in: round33(seg.in),
+            out: round33(seg.out),
+            duration: round33(d.source.meta.durationMs / 1e3),
             gain: 1,
             fadeIn: fade,
             fadeOut: fade
@@ -14561,11 +15955,11 @@ function joinDocs(parts) {
       }
     }
     for (const ob of d.objects ?? []) {
-      ;
+      owners.set(ns(ob.id), pid);
       (doc.objects ??= []).push({
         ...ob,
         id: ns(ob.id),
-        ...ob.span ? { span: { ...ob.span, start: round32(ob.span.start + offset) } } : {}
+        ...ob.span ? { span: { ...ob.span, start: round33(ob.span.start + offset) } } : {}
       });
     }
   }
@@ -14578,26 +15972,40 @@ function joinDocs(parts) {
     notes.push(
       `${first.label}: --mute leaves nothing out (the first input's sound is the film's own)`
     );
-  const pieces = ratedSegments9(doc);
+  const pieces = ratedSegments10(doc);
   for (const o of doc.overlays ?? []) {
-    if (!o.anchor) continue;
-    const r = resolveAnchor6(doc, o.anchor, pieces);
+    if (!o.anchor || o.start === void 0) continue;
+    const r = resolveAnchor7(doc, o.anchor, pieces);
     if (r.start !== null) o.start = r.start;
   }
-  return { doc, copies: [...copies.values()], media: joined, actions, notes };
+  return {
+    doc,
+    copies: [...copies.values()],
+    media: joined,
+    actions,
+    notes,
+    ids,
+    owners
+  };
 }
-var BOOLEAN_FLAGS13 = /* @__PURE__ */ new Set(["json", "help", "force", "captions"]);
+var BOOLEAN_FLAGS13 = /* @__PURE__ */ new Set([
+  "json",
+  "help",
+  "force",
+  "keep-edits",
+  "captions"
+]);
 var MULTI = /* @__PURE__ */ new Set(["mute"]);
-var USAGE3 = "vos join <take> <take|file.mp4>\u2026 --out <dir> [--force] [--captions] [--mute <file>]... [--json]";
+var USAGE3 = "vos join <take> <take|file.mp4>\u2026 --out <dir> [--keep-edits|--force] [--captions] [--zooms per-beat] [--mute <file>]... [--json]";
 var within = (inner, outer) => {
   const rel = relative5(outer, inner);
   return rel === "" || !rel.startsWith(`..${sep4}`) && rel !== ".." && !isAbsolute4(rel);
 };
 async function readPart(arg) {
   const path = resolve17(arg);
-  if (!existsSync24(path)) throw new UsageError(`${arg}: no such take or file`);
+  if (!existsSync25(path)) throw new UsageError(`${arg}: no such take or file`);
   if (statSync7(path).isDirectory()) {
-    if (!existsSync24(join26(path, "meta.json")))
+    if (!existsSync25(join27(path, "meta.json")))
       throw new UsageError(
         `${arg}: not a take directory (no meta.json); a video file is joined by its path`
       );
@@ -14634,8 +16042,16 @@ async function cmdJoin(argv) {
   const r = createReporter(flags.json === true);
   const outArg = strFlag(flags, "out");
   const force = flags.force === true;
+  const keepEdits = flags["keep-edits"] === true;
   const withCaptions = flags.captions === true;
+  const zoomMode = zoomModeOf(strFlag(flags, "zooms"));
+  if (zoomMode && typeof zoomMode === "object")
+    throw new UsageError(zoomMode.error);
   if (positionals.length < 2 || !outArg) throw new UsageError(USAGE3);
+  if (force && keepEdits)
+    throw new UsageError(
+      "--force replaces the joined take and --keep-edits keeps its edits; pass one"
+    );
   const out = resolve17(outArg);
   const inputs = positionals.map((p) => resolve17(p));
   const muted = /* @__PURE__ */ new Set();
@@ -14653,42 +16069,85 @@ async function cmdJoin(argv) {
         `--out ${outArg} overlaps the input ${positionals[i]}; write the joined take somewhere of its own`
       );
   }
-  if (existsSync24(out)) {
-    if (!force)
+  let rejoin = false;
+  if (existsSync25(out)) {
+    if (!force && !keepEdits)
       throw new UsageError(
-        `--out ${outArg} exists; pass --force to replace it, or name a new directory`
-      );
-    const isTake = existsSync24(join26(out, "doc.json")) || existsSync24(join26(out, "meta.json"));
-    if (!isTake && readdirSync5(out).length > 0)
-      throw new UsageError(
-        `--force replaces a take directory, and ${outArg} holds other files; name a new directory`
+        `--out ${outArg} exists; pass --keep-edits to join again and keep every edit made since (its trims, spans, layers, frame, sound), --force to replace it, or name a new directory`
       );
+    if (keepEdits) {
+      if (!existsSync25(join27(out, "doc.json")))
+        throw new UsageError(
+          `--keep-edits: ${outArg} holds no doc.json, so there are no edits to keep; name a new directory, or --force to replace it`
+        );
+      rejoin = true;
+    } else {
+      const isTake = existsSync25(join27(out, "doc.json")) || existsSync25(join27(out, "meta.json"));
+      if (!isTake && readdirSync5(out).length > 0)
+        throw new UsageError(
+          `--force replaces a take directory, and ${outArg} holds other files; name a new directory`
+        );
+    }
     if (within(process.cwd(), out))
       throw new UsageError(
         `--out ${outArg} is the working directory or above it; name a new directory`
       );
   }
   const parts = [];
+  const read = [];
   for (const [i, p] of positionals.entries()) {
     r.log(`reading ${p}\u2026`);
-    parts.push({
+    const part = {
       ...await readPart(p),
       ...muted.has(i) ? { mute: true } : {}
+    };
+    parts.push(part);
+    const drift = part.kind === "take" ? scriptDrift(part.doc.source.meta.steps ?? [], part.actions?.steps) : null;
+    if (drift) r.warn(`${p}: ${scriptDriftLine(drift)}`);
+    read.push({
+      part,
+      path: relative5(out, inputs[i]) || ".",
+      footage: await partFootage(part)
     });
   }
-  const plan = joinDocs(parts);
+  if (keepEdits && !rejoin)
+    r.log(
+      `note: --keep-edits: ${outArg} does not exist yet, so this is a fresh join`
+    );
+  let plan;
+  let rejoined = null;
+  if (rejoin) {
+    const prev = JSON.parse(
+      await readFile17(join27(out, "doc.json"), "utf8")
+    );
+    let record = await readJoinRecord(out);
+    if (!record) {
+      record = await recordFromFootage(out, prev);
+      r.log(
+        `note: ${outArg} carries no ${JOIN_RECORD_NAME} (joined by an older vos), so its inputs are matched by the footage it holds; a video file joined then was re-encoded on the way in and reads as new`
+      );
+    }
+    rejoined = rejoinDocs(migrateMotion3(prev), record, read, {
+      where: (p) => relative5(process.cwd(), resolve17(out, p)) || "."
+    });
+    plan = rejoined.plan;
+  } else plan = joinDocs(parts);
+  const only = rejoined ? rejoined.newIds : void 0;
+  const labelOf = new Map([
+    ["", positionals[0]],
+    ...plan.media.map((m) => [m.id, m.label])
+  ]);
   let captions = null;
   if (withCaptions) {
-    captions = landStepCaptions(plan.doc, plan.actions);
-    const labelOf = new Map([
-      ["", positionals[0]],
-      ...plan.media.map((m) => [m.id, m.label])
-    ]);
+    captions = landStepCaptions(plan.doc, plan.actions, { only });
     for (const k of captions.uncaptioned)
       plan.notes.push(
         `no step in ${labelOf.get(k) ?? `media ${k}`} carries a caption`
       );
   }
+  let perBeat = null;
+  if (zoomMode === "per-beat")
+    perBeat = oneZoomPerBeat(plan.doc, plan.actions, { only });
   const lint = lintDoc(plan.doc);
   if (lint.problems.length) {
     r.log(
@@ -14706,25 +16165,36 @@ async function cmdJoin(argv) {
       );
     c.from = found.file;
   }
-  if (existsSync24(out)) await rm4(out, { recursive: true, force: true });
-  await mkdir11(out, { recursive: true });
+  if (rejoined) {
+    for (const k of rejoined.dropped) {
+      if (!/^[A-Za-z0-9_-]+$/.test(k)) continue;
+      const dir = join27(out, k);
+      if (existsSync25(dir) && statSync7(dir).isDirectory())
+        await rm4(dir, { recursive: true, force: true });
+    }
+  } else {
+    if (existsSync25(out)) await rm4(out, { recursive: true, force: true });
+    await mkdir11(out, { recursive: true });
+  }
   for (const c of plan.copies) {
-    const to = join26(out, c.to);
+    const to = join27(out, c.to);
     await mkdir11(dirname9(to), { recursive: true });
     if (c.remux) {
       const remuxed = await copyRecording(c.from, to, c.remux);
       if (!remuxed && c.remux !== "mov")
         plan.notes.push(
-          `could not read ${basename12(c.from)}'s audio in Node, so it was copied as it is; its length comes from the container`
+          `could not read ${basename13(c.from)}'s audio in Node, so it was copied as it is; its length comes from the container`
         );
     } else await copyFile3(c.from, to);
   }
   const doc = plan.doc;
-  const added = new Set(plan.media.map((m) => `${m.id}-sound`));
+  const added = new Set(
+    plan.media.filter((m) => !only || only.has(m.id)).map((m) => `${m.id}-sound`)
+  );
   for (const clip of doc.audio) {
     if (!added.has(clip.id) || !isTakeRelativeKey(clip.key)) continue;
     try {
-      const m = await measureTrack(join26(out, takeRelativeFile(clip.key)));
+      const m = await measureTrack(join27(out, takeRelativeFile(clip.key)));
       if (m.lufs !== null)
         clip.loudness = loudnessFact(
           { lufs: m.lufs, peakDb: m.peakDb },
@@ -14736,33 +16206,350 @@ async function cmdJoin(argv) {
       );
     }
   }
-  await writeJson(join26(out, "meta.json"), doc.source.meta, true);
+  await writeJson(join27(out, "meta.json"), doc.source.meta, true);
   if (doc.source.cursor.length)
-    await writeJson(join26(out, "cursor.json"), doc.source.cursor);
+    await writeJson(join27(out, "cursor.json"), doc.source.cursor);
   if (parts[0].actions)
-    await writeJson(join26(out, "actions.json"), parts[0].actions, true);
-  await writeJson(join26(out, "doc.json"), doc, true);
-  const extents = segmentOutputExtents3(doc);
+    await writeJson(join27(out, "actions.json"), parts[0].actions, true);
+  await writeJson(join27(out, "doc.json"), doc, true);
+  await writeJson(
+    join27(out, JOIN_RECORD_NAME),
+    joinRecordOf(read, plan.ids),
+    true
+  );
+  const extents = segmentOutputExtents4(doc);
   const length = extents.length ? extents[extents.length - 1].end : 0;
   for (const n of plan.notes) r.log(`note: ${n}`);
   for (const w of lint.warnings) r.log(`warning: ${w}`);
-  const captionLine = captions ? `
-  ${captions.landed.length} step caption${captions.landed.length === 1 ? "" : "s"} landed` + (captions.skipped.length ? `; not landed: ${captions.skipped.join("; ")}` : "") : "";
+  const stepCount = (id) => (doc.media ?? []).find((m) => m.id === id)?.meta.steps?.length ?? 0;
+  const newMedia = only ? plan.media.filter((m) => only.has(m.id)) : [];
+  const stepped = newMedia.filter((m) => stepCount(m.id) > 0);
+  const bare = newMedia.filter((m) => stepCount(m.id) === 0);
+  const bareWords = bare.length ? `${bare.map((m) => m.label).join(", ")} ${bare.length === 1 ? "has" : "have"} no recorded steps` : "";
+  const onNew = only ? ` on ${stepped.map((m) => m.label).join(", ")}` : "";
+  const captionLine = !captions ? "" : only && !newMedia.length ? "\n  --captions: no new input to caption (a re-join captions only the inputs it adds; the kept ones keep their captions as edited)" : only && !stepped.length ? `
+  --captions: ${bareWords}, so there is nothing to caption` : `
+  ${captions.landed.length} step caption${captions.landed.length === 1 ? "" : "s"} landed${onNew}` + (captions.skipped.length ? `; not landed: ${captions.skipped.join("; ")}` : "") + (bareWords ? `; ${bareWords}` : "");
+  const beatLine = !perBeat ? "" : only && !newMedia.length ? "\n  --zooms per-beat: no new input to re-plan (a re-join re-plans only the inputs it adds; the kept ones keep their zooms as edited)" : only && !stepped.length ? `
+  --zooms per-beat: ${bareWords}, so there are no beats to plan` : `
+  ${only ? `${stepped.map((m) => m.label).join(", ")}: ` : ""}${perBeatLine(perBeat, (k) => labelOf.get(k) ?? `media ${k}`)}${bareWords ? `; ${bareWords}` : ""}`;
+  const rejoinText = rejoined ? rejoinLines(rejoined.report).map((l) => `
+  ${l}`).join("") : "";
   r.done(
     {
       out,
       primary: positionals[0],
       media: plan.media,
       segments: doc.segments.length,
-      seconds: round32(length),
+      seconds: round33(length),
       files: plan.copies.map((c) => c.to),
       notes: plan.notes,
       warnings: lint.warnings,
-      ...captions ? { captions } : {}
+      ...captions ? { captions } : {},
+      ...perBeat ? { perBeat } : {},
+      ...rejoined ? { keptEdits: rejoined.report } : {}
     },
-    `Joined ${parts.length} inputs \u2192 ${out} (${length.toFixed(1)}s, ${doc.segments.length} segments)
-  ${positionals[0]} is the primary; ${plan.media.map((m) => `${m.label} \u2192 ${m.id}`).join(", ")}${captionLine}
-  Next: vos frames ${outArg} --times 0,25%,50%,75%,100%; vos render ${outArg}`
+    `${rejoined ? "Joined again, keeping the edits:" : "Joined"} ${parts.length} inputs \u2192 ${out} (${length.toFixed(1)}s, ${doc.segments.length} segments)
+  ${positionals[0]} is the primary; ${plan.media.map((m) => `${m.label} \u2192 ${m.id}`).join(", ")}${rejoinText}${captionLine}${beatLine}
+  Next: vos info ${outArg}; vos frames ${outArg} --times 0,25%,50%,75%,100%; vos render ${outArg}`
+  );
+  return EXIT_OK;
+}
+
+// src/plugin/timeline.ts
+import { join as join28, resolve as resolve18 } from "path";
+import {
+  docFreezes as docFreezes2,
+  docMediaList as docMediaList4,
+  docOutputDuration as docOutputDuration4,
+  cameraSpanExtents as cameraSpanExtents3,
+  docStillTime as docStillTime2,
+  freezeOutputExtents,
+  mediaKey as mediaKey5,
+  migrateMotion as migrateMotion4,
+  overlayPlainText,
+  longestOutputExtent as longestOutputExtent3,
+  ratedSegments as ratedSegments11,
+  resolveOverlayAnchors as resolveOverlayAnchors2,
+  segmentOutputExtents as segmentOutputExtents5,
+  spanOutputExtents as spanOutputExtents3
+} from "@vosjs/studio-core";
+import { totalDuration as totalDuration4 } from "@vosjs/timeline";
+var r32 = (v) => Math.round(v * 1e3) / 1e3;
+var ext = (e) => e ? { start: r32(e.start), end: r32(e.end) } : null;
+function ratedWithoutFreezes(doc) {
+  return ratedSegments11({
+    ...doc,
+    freeze: void 0,
+    segments: doc.segments.map((s) => {
+      const { hold: _hold, ...rest } = s;
+      void _hold;
+      return rest;
+    })
+  });
+}
+function takeTimeline(rawDoc, actions = /* @__PURE__ */ new Map()) {
+  const doc = migrateMotion4(rawDoc);
+  const rated = ratedSegments11(doc);
+  const round = (e) => ({
+    start: r32(e.start),
+    end: r32(e.end)
+  });
+  const span = (sIn, sOut, media2) => {
+    const all = spanOutputExtents3(rated, sIn, sOut, media2).map(round);
+    return {
+      output: all[0] ?? null,
+      ...all.length > 1 ? { also: all.slice(1) } : {}
+    };
+  };
+  const stepSpan = (sIn, sOut, media2) => {
+    const all = spanOutputExtents3(rated, sIn, sOut, media2).map(round);
+    const longest = longestOutputExtent3(rated, sIn, sOut, media2);
+    const main = longest ? all.find(
+      (e) => Math.abs(e.start - r32(longest.start)) < 1e-6 && Math.abs(e.end - r32(longest.end)) < 1e-6
+    ) : void 0;
+    const others = all.filter((e) => e !== main);
+    return {
+      output: main ?? null,
+      ...others.length ? { also: others } : {}
+    };
+  };
+  const cameraSpan = (sIn, sOut, media2) => {
+    const moves = cameraSpanExtents3(rated, sIn, sOut, media2).map(round);
+    const rests = spanOutputExtents3(rated, sIn, sOut, media2).map(round).filter(
+      (e) => !moves.some(
+        (m) => m.start >= e.start - 1e-6 && m.end <= e.end + 1e-6
+      )
+    );
+    return {
+      output: moves[0] ?? null,
+      ...moves.length > 1 ? { also: moves.slice(1) } : {},
+      ...rests.length ? { rests } : {}
+    };
+  };
+  const media = docMediaList4(doc).map(({ id, source }) => ({
+    id,
+    file: source.videoKey,
+    duration: r32((source.meta.durationMs || 0) / 1e3),
+    steps: (source.meta.steps ?? []).map((s) => {
+      const caption = captionOf(
+        s,
+        actions.get(id),
+        source.script,
+        source.meta.steps ?? []
+      );
+      const out = Math.max(s.tEnd, s.tStart + 1e-3);
+      return {
+        step: s.step,
+        ...s.id !== void 0 ? { id: s.id } : {},
+        do: s.do,
+        in: r32(s.tStart),
+        out: r32(s.tEnd),
+        ...caption ? { caption } : {},
+        ...s.skipped ? { skipped: true } : {},
+        ...stepSpan(s.tStart, out, id || void 0)
+      };
+    })
+  }));
+  const docSegments = doc.segments.length ? doc.segments : [{ in: 0, out: doc.source.meta.durationMs / 1e3 }];
+  const extents = segmentOutputExtents5(doc);
+  const segments = docSegments.map((s, index) => ({
+    index,
+    media: mediaKey5(s.media),
+    in: r32(s.in),
+    out: r32(s.out),
+    start: r32(extents[index]?.start ?? 0),
+    end: r32(extents[index]?.end ?? 0)
+  }));
+  const freezeMarks = freezeOutputExtents(
+    ratedWithoutFreezes(doc),
+    docFreezes2(doc)
+  );
+  const freeze = docFreezes2(doc).map((f) => {
+    const m = freezeMarks.get(f.id);
+    return {
+      id: f.id,
+      media: mediaKey5(f.media),
+      at: r32(f.at),
+      seconds: r32(f.seconds),
+      output: m ? ext({ start: m.t, end: m.t + m.duration }) : null
+    };
+  });
+  const resolved = resolveOverlayAnchors2(doc, rated);
+  const rawById = new Map((doc.overlays ?? []).map((o) => [o.id, o]));
+  const overlays = (resolved.overlays ?? []).flatMap((o) => {
+    const start = o.start;
+    if (start === void 0) return [];
+    const raw = rawById.get(o.id);
+    const text = o.kind === "text" ? overlayPlainText(o) : o.kind === "html" ? void 0 : o.key;
+    return [
+      {
+        id: o.id,
+        kind: o.kind ?? "text",
+        ...text !== void 0 ? { text } : {},
+        start: r32(start),
+        end: r32(start + o.duration),
+        ...raw?.anchor ? { anchor: raw.anchor } : {},
+        ...o.from ? { from: o.from } : {}
+      }
+    ];
+  });
+  const footage = totalDuration4(rated);
+  return {
+    media,
+    segments,
+    speed: (doc.speed ?? []).map((s) => ({
+      id: s.id,
+      media: mediaKey5(s.media),
+      in: r32(s.in),
+      out: r32(s.out),
+      rate: s.rate,
+      ...s.source ? { source: s.source } : {},
+      ...span(s.in, s.out, s.media)
+    })),
+    freeze,
+    zoom: doc.zoom.map((z) => ({
+      id: z.id,
+      media: mediaKey5(z.media),
+      in: r32(z.in),
+      out: r32(z.out),
+      level: z.level,
+      ...z.source ? { source: z.source } : {},
+      ...cameraSpan(z.in, z.out, z.media)
+    })),
+    tilt: (doc.tilt ?? []).map((t) => ({
+      id: t.id,
+      media: mediaKey5(t.media),
+      in: r32(t.in),
+      out: r32(t.out),
+      ...cameraSpan(t.in, t.out, t.media)
+    })),
+    overlays,
+    objects: (doc.objects ?? []).map((ob) => ({
+      id: ob.id,
+      start: r32(ob.span?.start ?? 0),
+      end: ob.span ? r32(ob.span.start + ob.span.duration) : null
+    })),
+    audio: doc.audio.map((a) => {
+      const len = a.loop && a.loopLen ? a.loopLen : a.out - a.in;
+      return {
+        id: a.id,
+        ...a.name ? { name: a.name } : {},
+        start: r32(a.start),
+        end: r32(a.start + len),
+        in: r32(a.in),
+        out: r32(a.out)
+      };
+    }),
+    footage: r32(footage),
+    end: r32(docOutputDuration4(doc)),
+    still: docStillTime2(doc)
+  };
+}
+var f2 = (v) => v.toFixed(2);
+var range = (a, b) => `${f2(a)}\u2013${f2(b)}`;
+var ranges = (list) => list.map((a) => range(a.start, a.end)).join(", ");
+var outText = (e, also, rests) => `${e ? range(e.start, e.end) : rests?.length ? "(camera at rest)" : "(cut)"}${also?.length ? `, also ${ranges(also)}` : ""}${rests?.length ? `${e ? "," : ""} at rest in ${ranges(rests)}` : ""}`;
+var mediaName = (m) => m || "primary";
+function formatTimeline(t, label) {
+  const lines = [];
+  const pad = (s, n) => s.padEnd(n);
+  lines.push(
+    `${label}: output ${f2(t.end)} s (footage ${f2(t.footage)} s), ${t.media.length} media`
+  );
+  for (const m of t.media) {
+    lines.push("");
+    lines.push(
+      `${mediaName(m.id)}  ${m.file}  ${f2(m.duration)} s source, ${m.steps.length} step${m.steps.length === 1 ? "" : "s"}`
+    );
+    if (m.steps.length)
+      lines.push(
+        `  ${pad("step", 5)} ${pad("id", 16)} ${pad("do", 8)} ${pad("source", 14)} ${pad("output", 14)} caption`
+      );
+    for (const s of m.steps)
+      lines.push(
+        `  ${pad(String(s.step), 5)} ${pad(s.id ?? "-", 16)} ${pad(s.do, 8)} ${pad(range(s.in, s.out), 14)} ${pad(s.skipped ? "(skipped)" : outText(s.output), 14)} ${s.caption ? JSON.stringify(s.caption) : ""}${s.also?.length && !s.skipped ? ` (also ${ranges(s.also)})` : ""}`.trimEnd()
+      );
+  }
+  lines.push("");
+  lines.push("output timeline (source \u2192 output seconds)");
+  lines.push("  segments");
+  for (const s of t.segments)
+    lines.push(
+      `    #${pad(String(s.index), 4)} ${pad(mediaName(s.media), 8)} ${pad(range(s.in, s.out), 14)} \u2192 ${range(s.start, s.end)}`
+    );
+  if (t.speed.length) {
+    lines.push("  speed");
+    for (const s of t.speed)
+      lines.push(
+        `    ${pad(s.id, 12)} ${pad(mediaName(s.media), 8)} ${pad(range(s.in, s.out), 14)} \xD7${pad(String(s.rate), 5)} ${pad(s.source ?? "", 6)} \u2192 ${outText(s.output, s.also)}`
+      );
+  }
+  if (t.freeze.length) {
+    lines.push("  freeze");
+    for (const f of t.freeze)
+      lines.push(
+        `    ${pad(f.id, 12)} ${pad(mediaName(f.media), 8)} at ${pad(f2(f.at), 11)} ${f2(f.seconds)} s \u2192 ${outText(f.output)}`
+      );
+  }
+  if (t.zoom.length) {
+    lines.push("  zoom");
+    for (const z of t.zoom)
+      lines.push(
+        `    ${pad(z.id, 12)} ${pad(mediaName(z.media), 8)} ${pad(range(z.in, z.out), 14)} L${pad(String(z.level), 5)} ${pad(z.source ?? "", 6)} \u2192 ${outText(z.output, z.also, z.rests)}`
+      );
+  }
+  if (t.tilt.length) {
+    lines.push("  tilt");
+    for (const z of t.tilt)
+      lines.push(
+        `    ${pad(z.id, 12)} ${pad(mediaName(z.media), 8)} ${pad(range(z.in, z.out), 14)} \u2192 ${outText(z.output, z.also, z.rests)}`
+      );
+  }
+  if (t.overlays.length) {
+    lines.push("  layers");
+    for (const o of t.overlays) {
+      const anchor = o.anchor ? ` anchor ${o.anchor.media ? `${o.anchor.media}:` : ""}${String(o.anchor.step)}${o.anchor.at === "end" ? " end" : ""}${o.anchor.offset ? ` ${o.anchor.offset > 0 ? "+" : ""}${o.anchor.offset}` : ""}` : "";
+      const words2 = o.text !== void 0 ? ` ${JSON.stringify(o.text)}` : "";
+      lines.push(
+        `    ${pad(o.id, 12)} ${pad(o.kind, 6)} ${range(o.start, o.end)}${anchor}${o.from ? ` (from ${o.from})` : ""}${words2}`
+      );
+    }
+  }
+  if (t.objects.length) {
+    lines.push("  3D");
+    for (const o of t.objects)
+      lines.push(
+        `    ${pad(o.id, 12)} ${o.end === null ? "always" : range(o.start, o.end)}`
+      );
+  }
+  if (t.audio.length) {
+    lines.push("  sound");
+    for (const a of t.audio)
+      lines.push(
+        `    ${pad(a.id, 12)} ${range(a.start, a.end)} (its file ${range(a.in, a.out)})${a.name ? ` ${a.name}` : ""}`
+      );
+  }
+  lines.push(`  still ${f2(t.still)}`);
+  lines.push(`  end   ${f2(t.end)}`);
+  return lines.join("\n");
+}
+async function cmdTakeInfo(argv) {
+  const { positionals, flags } = parseArgs(argv, /* @__PURE__ */ new Set(["json", "help"]));
+  const dir = positionals[0];
+  if (!dir) throw new UsageError("vos info <take> [--json]");
+  const r = createReporter(flags.json === true);
+  const take = await loadTake(dir);
+  if (!take.doc)
+    throw new UsageError(
+      `${dir} has no doc.json yet; vos plan ${dir} writes one`
+    );
+  const drift = scriptDrift(take.meta.steps ?? [], take.actions?.steps);
+  if (drift) r.warn(scriptDriftLine(drift));
+  const timeline = takeTimeline(take.doc, /* @__PURE__ */ new Map([["", take.actions]]));
+  r.done(
+    { take: resolve18(dir), doc: join28(resolve18(dir), "doc.json"), ...timeline },
+    formatTimeline(timeline, dir)
   );
   return EXIT_OK;
 }
@@ -14770,7 +16557,7 @@ async function cmdJoin(argv) {
 // src/plugin/audio.ts
 import { mkdtemp as mkdtemp2, rm as rm5, writeFile as writeFile12 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import { basename as basename13, join as join27 } from "path";
+import { basename as basename14, join as join29 } from "path";
 import { clipGain as clipGain3 } from "@vosjs/studio-core";
 var USAGE4 = "vos audio measure <take> [--json]";
 async function fileFor(dir, key, fetchImpl) {
@@ -14782,8 +16569,8 @@ async function fileFor(dir, key, fetchImpl) {
   if (/^https?:\/\//.test(key)) {
     const res = await fetchImpl(key);
     if (!res.ok) return { skipped: `GET ${key} answered ${res.status}` };
-    const tmp = await mkdtemp2(join27(tmpdir3(), "vos-audio-"));
-    const path = join27(tmp, basename13(new URL(key).pathname) || "audio");
+    const tmp = await mkdtemp2(join29(tmpdir3(), "vos-audio-"));
+    const path = join29(tmp, basename14(new URL(key).pathname) || "audio");
     await writeFile12(path, new Uint8Array(await res.arrayBuffer()));
     return { path, cleanup: () => rm5(tmp, { recursive: true, force: true }) };
   }
@@ -14865,8 +16652,8 @@ async function cmdAudio(argv) {
 
 // src/plugin/look.ts
 import { mkdir as mkdir12 } from "fs/promises";
-import { existsSync as existsSync25 } from "fs";
-import { join as join28, resolve as resolve18 } from "path";
+import { existsSync as existsSync26 } from "fs";
+import { join as join30, resolve as resolve19 } from "path";
 import { headersFor, urlSchemeProblem } from "@vosjs/render-core/record";
 function quote(value) {
   return `"${value.replace(/\s+/g, " ").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
@@ -15318,7 +17105,7 @@ async function lookAt(page, url, opts) {
   }
   if (opts.waitMs && opts.waitMs > 0) await page.waitForTimeout(opts.waitMs);
   await mkdir12(opts.outDir, { recursive: true });
-  const screenshot = join28(opts.outDir, "look.png");
+  const screenshot = join30(opts.outDir, "look.png");
   await page.screenshot({ path: screenshot });
   const scan = await page.evaluate(EXPOSURE_PROBE).catch(() => null);
   const step = ran.length ? ran.length - 1 : -1;
@@ -15408,15 +17195,15 @@ async function cmdLook(argv) {
   if (scheme) throw new UsageError(scheme);
   const r = createReporter(flags.json === true);
   const viewport = parseViewport2(strFlag(flags, "viewport"));
-  const outDir = resolve18(strFlag(flags, "out") ?? "look");
+  const outDir = resolve19(strFlag(flags, "out") ?? "look");
   const headed = flags.headed === true;
   const waitRaw = strFlag(flags, "wait");
   const waitMs = waitRaw === void 0 ? 0 : Number(waitRaw);
   if (!Number.isFinite(waitMs) || waitMs < 0 || waitMs > 6e4)
     throw new UsageError("--wait expects milliseconds, 0 to 60000");
   const storageRaw = strFlag(flags, "storage-state");
-  const storageState = storageRaw ? resolve18(storageRaw) : void 0;
-  if (storageState && !existsSync25(storageState))
+  const storageState = storageRaw ? resolve19(storageRaw) : void 0;
+  if (storageState && !existsSync26(storageState))
     throw new UsageError(`--storage-state: no such file: ${storageState}`);
   const sessionName = strFlag(flags, "session");
   if (sessionName) {
@@ -15426,7 +17213,7 @@ async function cmdLook(argv) {
       throw new UsageError(
         "--session and --storage-state are two doors to one page: a persistent profile cannot take a storage state. Pass one"
       );
-    if (!existsSync25(sessionDir(sessionName)))
+    if (!existsSync26(sessionDir(sessionName)))
       throw new UsageError(
         `no session "${sessionName}". Make one: vos session open <url> --name ${sessionName} (a Chrome window opens; sign in and close it)`
       );
@@ -15489,19 +17276,19 @@ async function cmdLook(argv) {
 import { spawnSync as spawnSync4 } from "child_process";
 import {
   cpSync,
-  existsSync as existsSync27,
+  existsSync as existsSync28,
   mkdirSync as mkdirSync6,
   readFileSync as readFileSync11,
   rmSync as rmSync3,
   writeFileSync as writeFileSync6
 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join30 } from "path";
+import { join as join32 } from "path";
 import { chromium as chromium2 } from "playwright";
 
 // src/plugin/machine.ts
-import { existsSync as existsSync26, readFileSync as readFileSync10, readdirSync as readdirSync6, statSync as statSync8 } from "fs";
-import { dirname as dirname10, join as join29 } from "path";
+import { existsSync as existsSync27, readFileSync as readFileSync10, readdirSync as readdirSync6, statSync as statSync8 } from "fs";
+import { dirname as dirname10, join as join31 } from "path";
 var AGENT_NAMES = [
   "claude",
   "cursor",
@@ -15521,17 +17308,17 @@ var HOME_DIRS = {
   copilot: [".copilot"]
 };
 function detectAgents(root, opts = {}) {
-  const exists = opts.exists ?? existsSync26;
+  const exists = opts.exists ?? existsSync27;
   const out = [];
   for (const agent of AGENT_NAMES) {
     for (const rel of PROJECT_DIRS[agent]) {
-      const dir = join29(root, rel);
+      const dir = join31(root, rel);
       if (exists(dir)) out.push({ agent, dir, scope: "project" });
     }
-    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join29(root, ".github", "copilot-instructions.md"))) {
+    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join31(root, ".github", "copilot-instructions.md"))) {
       out.push({
         agent,
-        dir: join29(root, ".github", "copilot"),
+        dir: join31(root, ".github", "copilot"),
         scope: "project"
       });
     }
@@ -15539,7 +17326,7 @@ function detectAgents(root, opts = {}) {
   if (opts.global && opts.home) {
     for (const agent of AGENT_NAMES) {
       for (const rel of HOME_DIRS[agent]) {
-        const dir = join29(opts.home, rel);
+        const dir = join31(opts.home, rel);
         if (exists(dir)) out.push({ agent, dir, scope: "global" });
       }
     }
@@ -15557,18 +17344,18 @@ function agentsFromFlag(value, root) {
   return {
     homes: wanted.map((agent) => ({
       agent,
-      dir: join29(root, PROJECT_DIRS[agent][0]),
+      dir: join31(root, PROJECT_DIRS[agent][0]),
       scope: "project"
     }))
   };
 }
 function skillsDirFor(home) {
-  return join29(home.dir, "skills");
+  return join31(home.dir, "skills");
 }
 function fallbackSkillsHome(root) {
-  return { agent: "codex", dir: join29(root, ".agents"), scope: "project" };
+  return { agent: "codex", dir: join31(root, ".agents"), scope: "project" };
 }
-function installedSkills(dir, exists = existsSync26, list = (p) => {
+function installedSkills(dir, exists = existsSync27, list = (p) => {
   try {
     return readdirSync6(p);
   } catch {
@@ -15576,7 +17363,7 @@ function installedSkills(dir, exists = existsSync26, list = (p) => {
   }
 }) {
   if (!exists(dir)) return [];
-  return list(dir).filter((name) => exists(join29(dir, name, "SKILL.md"))).sort();
+  return list(dir).filter((name) => exists(join31(dir, name, "SKILL.md"))).sort();
 }
 var RULES_BEGIN = "<!-- vos:begin (written by vos setup; the block is replaced on the next run) -->";
 var RULES_END = "<!-- vos:end -->";
@@ -15609,10 +17396,10 @@ ${RULES_BLOCK}
   }
   return { text, changed: text !== current };
 }
-function rulesFileFor(root, exists = existsSync26) {
-  const agents = join29(root, "AGENTS.md");
+function rulesFileFor(root, exists = existsSync27) {
+  const agents = join31(root, "AGENTS.md");
   if (exists(agents)) return agents;
-  const claude = join29(root, "CLAUDE.md");
+  const claude = join31(root, "CLAUDE.md");
   if (exists(claude)) return claude;
   return agents;
 }
@@ -15621,14 +17408,14 @@ function chromeCandidates(platform, env) {
     return ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"];
   if (platform === "win32")
     return [
-      join29(
+      join31(
         env["PROGRAMFILES"] ?? "C:\\Program Files",
         "Google",
         "Chrome",
         "Application",
         "chrome.exe"
       ),
-      join29(
+      join31(
         env["LOCALAPPDATA"] ?? "",
         "Google",
         "Chrome",
@@ -15714,7 +17501,7 @@ function doctorReport(facts) {
 }
 function bundledSkillsVersion(dir) {
   try {
-    const v = readFileSync10(join29(dir, "VERSION"), "utf8").trim();
+    const v = readFileSync10(join31(dir, "VERSION"), "utf8").trim();
     return /^\d+\.\d+\.\d+$/.test(v) ? v : null;
   } catch {
     return null;
@@ -15723,13 +17510,13 @@ function bundledSkillsVersion(dir) {
 function bundledSkillsDir(from) {
   let dir = dirname10(from);
   for (let i = 0; i < 6; i++) {
-    const pkg = join29(dir, "package.json");
-    if (existsSync26(pkg)) {
+    const pkg = join31(dir, "package.json");
+    if (existsSync27(pkg)) {
       try {
         const name = JSON.parse(readFileSync10(pkg, "utf8")).name;
         if (name === "@vosjs/cli") {
-          const skills = join29(dir, "skills");
-          return existsSync26(skills) && statSync8(skills).isDirectory() ? skills : null;
+          const skills = join31(dir, "skills");
+          return existsSync27(skills) && statSync8(skills).isDirectory() ? skills : null;
         }
       } catch {
       }
@@ -15765,7 +17552,7 @@ function npx() {
 function bundledChromium() {
   try {
     const p = chromium2.executablePath();
-    return p && existsSync27(p) ? p : null;
+    return p && existsSync28(p) ? p : null;
   } catch {
     return null;
   }
@@ -15774,7 +17561,7 @@ function probe2() {
   return probeBrowser({
     platform: process.platform,
     env: process.env,
-    exists: existsSync27,
+    exists: existsSync28,
     bundled: bundledChromium
   });
 }
@@ -15859,7 +17646,7 @@ async function cmdSetup(argv) {
         const dest = skillsDirFor(home);
         mkdirSync6(dest, { recursive: true });
         for (const name of installedSkills(dir)) {
-          cpSync(join30(dir, name), join30(dest, name), { recursive: true });
+          cpSync(join32(dir, name), join32(dest, name), { recursive: true });
         }
       }
     };
@@ -15927,7 +17714,7 @@ async function cmdSetup(argv) {
   let rules = null;
   if (!noRules) {
     const file = rulesFileFor(root);
-    const existing = existsSync27(file) ? readFileSync11(file, "utf8") : null;
+    const existing = existsSync28(file) ? readFileSync11(file, "utf8") : null;
     const { text, changed } = applyRulesBlock(existing);
     if (changed) writeFileSync6(file, text);
     rules = { file, changed };
@@ -16041,7 +17828,7 @@ async function cmdWhoami(argv) {
 function cmdLogout(argv) {
   const { flags } = parseArgs(argv, BOOLEAN_FLAGS14);
   const r = reporterFor(flags);
-  const had = existsSync27(CREDENTIALS_PATH);
+  const had = existsSync28(CREDENTIALS_PATH);
   rmSync3(CREDENTIALS_PATH, { force: true });
   const envKey = Boolean(process.env.VOS_API_KEY?.trim());
   r.done(
@@ -16099,7 +17886,8 @@ Take pipeline
   vos record --actions actions.json [--url <url>] [--out take] [--strict] [--dry-run] [--allow-wall] [--keep-frames] [--max-duration <s>] [--ready dom|networkidle] [--storage-state <file>|--session <name>] [--header name=value]... [--confirm <id>]... [--browser-arg=<switch>]... [--background <slug|url|none>] [--verbose] [--json]
   vos record --hosted --actions actions.json [--url <url>] [--out take] [--title "\u2026"] [--folder <id>] [--header name=value]... [--json]
             the take recorded on vos.so's fleet (no browser here): lands as a private vos with its doc and digest, then fetched into --out with its media
-  vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--with <doc.json|vosId>[@end|@start|@step:<id>|@<s>]]... [--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|fade|slide|none] [--transitions slide|fade|scale|none] [--end-card on|none|<doc.json|vosId>] [--captions|--captions none] [--clicks none] [--still <t>] [--release v2.1] [--json]
+  vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--with <doc.json|vosId>[@end|@start|@step:<id>|@<s>]]... [--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|fade|slide|none] [--transitions slide|fade|scale|none] [--end-card on|none|<doc.json|vosId>] [--captions|--captions none] [--clicks none] [--still <t>] [--release v2.1] [--zooms per-beat] [--json]
+            --zooms per-beat keeps at most one zoom per beat: the beats are the captioned steps of actions.json (each runs until the next one starts, plus the opening before the first); a step marked "zoom": true in actions.json is its beat's payoff, and the beat keeps the proposal that overlaps it most (one per marked step, never two overlapping), promoted to manual; a beat with no marked step keeps no zoom; when no step of the take is marked, each beat's last click, drag, type or paste stands in (the opening keeps none) and the done line says so; a step marked "zoom": false is never zoomed on; the rest go into doc.rejected like a person deleting them, and a beat with a manual zoom keeps only its manual ones. A media with no captioned step keeps its zooms as planned, and the done line says so
   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] [--at-still] [--size WxH] [--out dir] [--background <url|slug>] [--set <path=value>]... [--strict] [--json]
             --at-zooms stills every zoom span's apex on every media of the take and renders it again with the zooms off: a zoom whose frame matches its zoom-off twin did not render, and says so (exit 2 under --strict)
@@ -16107,6 +17895,8 @@ Take pipeline
             the rendered file itself, no ffmpeg: duration, size, codecs, resolution, frame rate; full-frame scene changes (a warning when a 5 s window holds more than one); loudness (short-term every 3 s, integrated, sample peak; a warning below -23 or above -9 LUFS); the first and last frames as PNGs (a warning when either is near-uniform). Exit 2 on any warning under --strict
   vos deliver <take> --to youtube,x,shorts,github (or all) [--look plate|gradient|dark|none] [--brand BRAND.md] [--set path=value] [--release v2.1] [--out dir] [--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 info <take> [--json]
+            the take's two clocks, read-only: per media, every step with its id, what it did, its source seconds (meta.json tStart..tEnd), its caption and where it plays; then the output timeline after trims, speed and freezes: each segment, speed span, freeze, zoom and tilt span (or "(cut)"), every layer with its anchor resolved, each sound clip, the still and the film's end
   vos brand <url> [--out BRAND.md] [--json]
   vos open <take> [--studio <url>] [--print]
   vos callout <take> <note|tag|code> --step <id> [--title "\u2026"] [--body "\u2026"] [--kicker "\u2026"] [--code "\u2026"|--code-file f] [--seconds 3] [--side auto|right|left|below|above] [--mark ring|underline|none] [--leader] [--color #hex (the mark and leader; the kicker is --accent)] [--brand BRAND.md] [--ground #hex] [--accent #hex] [--font "\u2026"] [--body-px <n> (the body size on the delivered frame)] [--id x] [--print] [--json]
@@ -16114,8 +17904,9 @@ Take pipeline
   vos actions from-agent-browser <steps.jsonl> [--out actions.json] [--url <url>] [--viewport WxH] [--json]
   vos ingest <video.webm|mp4> [--cursor <trace.zip|steps.jsonl|cursor.csv>] [--as footage|take] [--out take] [--offset <ms>] [--viewport WxH] [--background <slug|url|none>] [--json]
             a take from a recording someone else made (a cloud agent's PR video, a Playwright run's video, a Loom export): the file becomes recording.<container>, meta.json from its own dimensions and duration, and a trace beside it becomes cursor.json so the planner has clicks to zoom on; without one, nothing is planned and the done event says so. Without a trace the file opens as FINISHED footage (a render from HyperFrames or Remotion, a film): no card, no browser bar, no drawn cursor, its own frame rate; --as take gives a screen demo the card
-  vos join <take> <take|file.mp4>... --out <dir> [--force] [--captions] [--mute <file>]... [--json]
-            several takes (and plain video files) as ONE take, cut in argument order: the first is the primary (its frame, cursor, export and sound), each next one a media m1, m2, \u2026 with its footage copied, its spans tagged and renamed, its layers moved to where it now starts; a file opens full-bleed and its own sound plays as an audio clip (--mute <file> leaves it out). --captions lands every step's caption anchored to its step, each ending with its clip. The result must pass vos validate before anything is written
+  vos join <take> <take|file.mp4>... --out <dir> [--keep-edits|--force] [--captions] [--zooms per-beat] [--mute <file>]... [--json]
+            several takes (and plain video files) as ONE take, cut in argument order: the first is the primary (its frame, cursor, export and sound), each next one a media m1, m2, \u2026 with its footage copied, its spans tagged and renamed, its layers moved to where it now starts; a file opens full-bleed and its own sound plays as an audio clip (--mute <file> leaves it out). --captions lands every step's caption anchored to its step, starting as the step begins (anchor.at "start"), each ending with its clip. --zooms per-beat keeps a beat's zoom on its steps marked "zoom": true (as vos plan --zooms per-beat). The result must pass vos validate before anything is written
+            --keep-edits joins again over an edited joined take and keeps its edits: inputs are matched to their media by source file (join.json records each input's path and footage hash), a kept input keeps its id and everything on it (segments in their edited order, spans, rejections, anchored layers, its sound), the frame, export, styles and still stay, a new input is joined fresh under a new id (and only it is captioned or re-planned), a re-recorded input (changed footage at its path, or the same script at a new one) keeps its edits re-timed by its steps as vos plan --reuse does, and an input that is gone takes its edits with it, each named. A new input's segments go before the next kept input's; reordering the kept inputs regroups the segments in argument order. The first input must stay the primary. --force replaces the take instead
   vos score <take> --track <slug|file> [--at <step id|output seconds>] [--gain 0..1] [--normalize <lufs|off>] [--fade-in <s>] [--fade-out <s>] [--dry-run] [--json]
             the film's music as one audio clip (id score): reads the track's loudness, finds its strongest swell and offsets the track so the swell lands at --at (a step, resolved through the cut, or output seconds); without --at it starts where the track first rises above its median level. The clip carries its measured loudness and a target, --normalize (default -16 LUFS), with --gain (default 0.5) a trim on it; --normalize off plays it at --gain alone
   vos audio measure <take> [--json]
@@ -16162,7 +17953,8 @@ Platform (vos.so) \u2014 fetch, edit, push, pull, repeat
             signed-in person's line carries for a key, once, no click
   vos fetch <vosId|watch-url> [--out dir] [--media] [--json]
             writes config.json + vos.json (no auth needed for public programs);
-            a take vos also gets its doc.json, and --media its footage
+            a take vos also gets its doc.json, and --media its footage, its
+            actions.json and every file that script pastes, beside it
   vos push  <config.json|take> [--vos id] [--title t] [--slug s] [--remix-of id]
             [--desc d] [--tags a,b] [--folder <folderId|slug>]
             [--note n] [--label l] [--base versionId] [--override <id>]... [--yes] [--json]
@@ -16184,7 +17976,9 @@ Platform (vos.so) \u2014 fetch, edit, push, pull, repeat
             Without --folder a new vos lands unfiled, at the root of your
             shelf. A document's local files (doc.json: picture and video
             overlays, 3D props, sound; a take's mic and cam too) upload
-            with the push, each once. --wait stays until the version's still has
+            with the push, each once, and so does every file a take's
+            actions.json pastes (a picture through the upload door, a text
+            file inside the document; one outside the take is refused). --wait stays until the version's still has
             rendered and prints absolute still and preview links.
             --still <seconds> sets a PROGRAM's cover (doc.json "still", kept
             by every later push); without it the platform picks an early
@@ -16298,9 +18092,11 @@ networkidle was asked for and never came; neither is a strict failure. --max-dur
 the hosted recording cap, read live from GET /api/limits (30 min when the
 origin is unreachable): the capture stops there and says so in one line.
 Three steps beyond the gestures: expect checks the page on camera
-(selector, text or gone; enabled; timeout 5 s); await waits OFF camera
-(until {selector|text|gone}, timeout 600 s, poll 2 s, reload, onTimeout
-fail|continue), so the footage has no gap and the cut lands in
+(selector, text or gone; enabled; or js, an expression evaluated in the
+page, truthy or with equals a value, for state an app keeps in script,
+said with the value it got and kept on meta.steps[].value; timeout 5 s);
+await waits OFF camera (until {selector|text|gone|js}, timeout 600 s,
+poll 2 s, reload, onTimeout fail|continue), so the footage has no gap and the cut lands in
 meta.skips[] and becomes a segment boundary; download keeps a file the page
 makes in the take's outputs/ (selector: the download a click starts; src:
 the currentSrc of a video, audio or img; as: the file name), listed in
@@ -16314,7 +18110,14 @@ name) and a list of its recent items, with the mask that hides it;
 notices are information, never a --strict failure. A click, press or type with "guard": "spend" costs
 something real: --dry-run hovers it and never presses, and record presses
 it only with --confirm <id> (repeatable), refusing before any capture
-otherwise. --hosted refuses guarded and download steps.
+otherwise. --hosted refuses guarded, download, paste and js steps.
+peers in actions.json add other people OFF camera: each its own browser
+context (storageState, by a path from the actions file) on the same url,
+its steps started with a take step or after one (by id); only the take's
+page is filmed and only its steps make the cursor track, so a peer's work
+reaches the footage through the app's own sync. A peer takes wait, move,
+hover, click, type, press, scroll, drag and expect; its misses are skips
+(--strict fails on them); meta.peers[] places its steps; --hosted refuses it.
 Every step is bounded: a call into a page that stopped answering gives up
 at the step's own timeout (an expect's or an await's, or a gesture's plan
 plus 30 s), the step is a skip with the real time it took, and --strict
@@ -16437,8 +18240,9 @@ 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 readFile16(file, "utf8"));
+  const raw = JSON.parse(await readFile18(file, "utf8"));
   const errors = validateActions(raw);
+  if (!errors.length) errors.push(...jsSyntaxProblems(raw));
   if (errors.length)
     throw new UsageError(`invalid actions file:
   ${errors.join("\n  ")}`);
@@ -16579,7 +18383,7 @@ function stepReportNote(rec) {
   ${l}`).join("");
 }
 function skippedLine(s) {
-  return `#${s.step}${s.id ? ` ${s.id}` : ""} ${s.do}${s.reason ? `: ${s.reason}` : ` ${s.selector}`}`;
+  return `${s.peer ? `peer ${s.peer} ` : ""}#${s.step}${s.id ? ` ${s.id}` : ""} ${s.do}${s.reason ? `: ${s.reason}` : ` ${s.selector}`}`;
 }
 function takeHeaders(multi) {
   try {
@@ -16595,8 +18399,8 @@ function takeBrowserArgs(multi) {
 function takeStorageState(flags) {
   const raw = strFlag(flags, "storage-state");
   if (!raw) return void 0;
-  const path = resolve19(raw);
-  if (!existsSync28(path))
+  const path = resolve20(raw);
+  if (!existsSync29(path))
     throw new UsageError(`--storage-state: no such file: ${path}`);
   return path;
 }
@@ -16609,7 +18413,7 @@ function takeSessionName(flags, storageState) {
     throw new UsageError(
       "--session and --storage-state are two doors to one take: a persistent profile cannot take a storage state. Pass one"
     );
-  if (!existsSync28(sessionDir(name)))
+  if (!existsSync29(sessionDir(name)))
     throw new UsageError(
       `no session "${name}". Make one: vos session open <url> --name ${name} (a Chrome window opens; sign in and close it)`
     );
@@ -16681,7 +18485,7 @@ async function cmdRecord(argv) {
   const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve19(strFlag(flags, "out") ?? "take");
+  const outDir = resolve20(strFlag(flags, "out") ?? "take");
   const storageState = takeStorageState(flags);
   const sessionName = takeSessionName(flags, storageState);
   const browserArgs = takeBrowserArgs(multi);
@@ -16701,7 +18505,7 @@ async function cmdRecord(argv) {
       );
     const hostedActions = await scriptForHost(
       actions,
-      dirname11(resolve19(actionsPath))
+      dirname11(resolve20(actionsPath))
     ).catch((e) => {
       throw new UsageError(e instanceof Error ? e.message : String(e));
     });
@@ -16809,7 +18613,7 @@ async function cmdRecord(argv) {
         sessionName,
         actions,
         (context2) => recordTake(browser2, url, actions, takePaths(outDir), r.log, {
-          actionsDir: dirname11(resolve19(actionsPath)),
+          actionsDir: dirname11(resolve20(actionsPath)),
           storageState,
           headers,
           context: context2,
@@ -16836,7 +18640,8 @@ async function cmdRecord(argv) {
           ...s.offCameraMs !== void 0 ? [
             `${s.timedOut ? "timed out after" : "held after"} ${(s.offCameraMs / 1e3).toFixed(1)} s off camera`
           ] : [],
-          ...out ? [`\u2192 ${out.name} (${out.bytes} bytes, not kept in a rehearsal)`] : []
+          ...out ? [`\u2192 ${out.name} (${out.bytes} bytes, not kept in a rehearsal)`] : [],
+          ...s.value !== void 0 && !s.skipped ? [`= ${sayValue(s.value)}`] : []
         ].map((n) => `  ${n}`);
         return `  ${s.skipped ? "\u2717" : "\u2713"} #${s.step}${s.id ? ` (${s.id})` : ""} ${s.do}${what}${s.skipped ? `  ${s.reason ?? "NOT FOUND"}` : rect}${s.navigated ? "  \u2192 navigated" : ""}${notes.join("")}`;
       });
@@ -16845,6 +18650,16 @@ async function cmdRecord(argv) {
           lines.push(
             `  \u2013 #${i}${step.id ? ` (${step.id})` : ""} ${step.do}  not run`
           );
+      for (const pr of rec.peers) {
+        const peer = actions.peers?.find((p) => p.id === pr.id);
+        lines.push(`  peer ${pr.id} (off camera):`);
+        for (const ps of pr.steps)
+          lines.push(
+            `    ${ps.skipped ? "\u2717" : "\u2713"} #${ps.step}${ps.id ? ` (${ps.id})` : ""} ${ps.do}${ps.selector ? ` ${ps.selector}` : ""}${ps.with ? `  with ${ps.with}` : ps.after ? `  after ${ps.after}` : ""}${ps.skipped ? `  ${ps.reason ?? "NOT FOUND"}` : ""}${ps.late ? "  (late)" : ""}`
+          );
+        for (const i of pr.notRun)
+          lines.push(`    \u2013 #${i} ${peer?.steps[i]?.do ?? "step"}  not run`);
+      }
       const resolved = steps.filter((s) => !s.skipped).length;
       const failed = strictFails(rec) || rec.stopped !== null;
       const unconfirmed = guardVerdict(actions, confirm);
@@ -16882,7 +18697,8 @@ async function cmdRecord(argv) {
           ready: rec.ready,
           exposures: rec.exposures,
           notices: rec.notices,
-          masks: rec.masks
+          masks: rec.masks,
+          ...rec.peers.length ? { peers: rec.peers } : {}
         },
         `${failed ? "REHEARSAL FAILED" : "Rehearsal passed"}: ${resolved}/${actions.steps.length} steps resolved in ${((Date.now() - started) / 1e3).toFixed(1)}s${rec.navTimeout ? " (the first load never reached networkidle)" : rec.ready.capped ? " (the first page never stopped changing)" : ""}
 ${lines.join("\n")}
@@ -16895,7 +18711,7 @@ ${lines.join("\n")}
   }
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync28(join31(outDir, "meta.json"))) {
+    if (existsSync29(join33(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" : "")
@@ -16912,7 +18728,7 @@ ${lines.join("\n")}
       sessionName,
       actions,
       (context2) => recordTake(browser, url, actions, paths, r.log, {
-        actionsDir: dirname11(resolve19(actionsPath)),
+        actionsDir: dirname11(resolve20(actionsPath)),
         maxDurationSeconds,
         storageState,
         headers,
@@ -16990,11 +18806,12 @@ ${lines.join("\n")}
         ...rec.media.length ? { media: rec.media } : {},
         overruns: rec.overruns,
         pageErrors: rec.pageErrors,
+        ...rec.peers.length ? { peers: rec.peers } : {},
         ...strictFail ? { strictFailed: true } : {}
       },
       strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}${stepNote}${navTimeoutNote(rec)}${exposureNote(rec)}${noticeNote(rec)}` : `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 \xB7 ${rec.dead.pct}% dead${deadWarns(rec.dead) ? " \u26A0 " + deadLine(rec.dead) : ""}${skippedNote}${stepNote}${navTimeoutNote(rec)}${pageSoundNote(rec)}
-  Next: edit ${join31(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}${noticeNote(rec)}`
+  Next: edit ${join33(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}${noticeNote(rec)}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -17021,9 +18838,9 @@ async function cmdCreate2(argv) {
   const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve19(strFlag(flags, "out") ?? "take");
+  const outDir = resolve20(strFlag(flags, "out") ?? "take");
   const format = videoFormat(strFlag(flags, "format"), positionals[0]);
-  const out = positionals[0] ?? join31(outDir, `out.${format}`);
+  const out = positionals[0] ?? join33(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");
@@ -17037,7 +18854,7 @@ async function cmdCreate2(argv) {
   const confirm = takeConfirm(multi, actions, { dryRun: false, r });
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync28(join31(outDir, "meta.json"))) {
+    if (existsSync29(join33(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" : "")
@@ -17054,7 +18871,7 @@ async function cmdCreate2(argv) {
       sessionName,
       actions,
       (context2) => recordTake(browser, url, actions, paths, r.log, {
-        actionsDir: dirname11(resolve19(actionsPath)),
+        actionsDir: dirname11(resolve20(actionsPath)),
         maxDurationSeconds,
         storageState,
         headers,
@@ -17170,31 +18987,34 @@ async function cmdPlan(argvIn) {
   const dir = positionals[0];
   if (!dir)
     throw new UsageError(
-      'vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--with <doc.json|vosId>[@end|@start|@step:<id>|@<seconds>]]... [--motion] [--headline "\u2026"] [--launch LAUNCH.md] [--brand BRAND.md]'
+      'vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--with <doc.json|vosId>[@end|@start|@step:<id>|@<seconds>]]... [--motion] [--headline "\u2026"] [--launch LAUNCH.md] [--brand BRAND.md] [--zooms per-beat]'
     );
   const r = createReporter(flags.json === true);
   if (flags.fresh === true) {
-    await rm6(join31(dir, "doc.json"), { force: true });
+    await rm6(join33(dir, "doc.json"), { force: true });
     r.log("note: --fresh discarded the existing doc.json");
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve19(strFlag(flags, "from") ?? join31(dir, PREV_DOC_NAME));
-    if (!existsSync28(from)) {
+    const from = resolve20(strFlag(flags, "from") ?? join33(dir, PREV_DOC_NAME));
+    if (!existsSync29(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 readFile16(from, "utf8"))
+      doc: JSON.parse(await readFile18(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const hasDoc = existsSync28(join31(dir, "doc.json"));
+  const hasDoc = existsSync29(join33(dir, "doc.json"));
   const backdrop = hasDoc ? null : await takeBackdrop(flags, r);
   const release = await releaseInputs(dir, flags, r, multi.with ?? []);
   const stepCaptions = strFlag(flags, "captions") === "steps";
+  const zoomMode = zoomModeOf(strFlag(flags, "zooms"));
+  if (zoomMode && typeof zoomMode === "object")
+    throw new UsageError(zoomMode.error);
   if (stepCaptions) release.launchRoles.captions = "none";
   const motionWanted = !hasDoc || flags.motion === true || flags.fresh === true;
   const stillRaw = strFlag(flags, "still") ?? release.launchRoles.still;
@@ -17229,6 +19049,23 @@ async function cmdPlan(argvIn) {
     captions = landStepCaptions(s.doc, /* @__PURE__ */ new Map([["", take.actions]]));
     await writeJson(take.paths.doc, s.doc, true);
   }
+  const marksTake = await loadTake(dir);
+  const drift = scriptDrift(
+    marksTake.meta.steps ?? [],
+    marksTake.actions?.steps
+  );
+  if (drift) r.warn(scriptDriftLine(drift));
+  const marks = applyZoomMarks(s.doc, /* @__PURE__ */ new Map([["", marksTake.actions]]));
+  if (marks.rejected.length) await writeJson(marksTake.paths.doc, s.doc, true);
+  const marksLine = zoomMarkLine(marks);
+  let perBeat = null;
+  if (zoomMode === "per-beat") {
+    const take = await loadTake(dir);
+    perBeat = oneZoomPerBeat(s.doc, /* @__PURE__ */ new Map([["", take.actions]]));
+    await writeJson(take.paths.doc, s.doc, true);
+  }
+  const zoomAuto = s.doc.zoom.filter((z) => z.source !== "manual").length;
+  const zoomManual = s.doc.zoom.length - zoomAuto;
   const captionLines = captions ? `
   ${captions.landed.length} step caption${captions.landed.length === 1 ? "" : "s"} anchored to their steps` + (captions.skipped.length ? `
   not landed: ${captions.skipped.join("; ")}` : "") + (captions.uncaptioned.length ? `
@@ -17249,20 +19086,23 @@ async function cmdPlan(argvIn) {
     ${s.reuse.flagged.join("\n    ")}` : "") : "";
   r.done(
     {
-      take: resolve19(dir),
+      take: resolve20(dir),
       fresh: s.fresh,
       cursorKept: s.cursorKept,
-      zoomAuto: s.zoomAuto,
-      zoomManual: s.zoomManual,
+      zoomAuto,
+      zoomManual,
       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 } : {},
-      ...captions ? { captions } : {}
+      ...captions ? { captions } : {},
+      ...perBeat ? { perBeat } : {}
     },
-    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join31(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}${captionLines}`
+    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join33(dir, "doc.json")}: ${zoomAuto} auto + ${zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}${captionLines}${marksLine ? `
+  ${marksLine}` : ""}${perBeat ? `
+  ${perBeatLine(perBeat)}` : ""}`
   );
   return EXIT_OK;
 }
@@ -17385,12 +19225,12 @@ async function cmdRender(argv) {
     );
   const r = createReporter(flags.json === true);
   const format = videoFormat(strFlag(flags, "format"), positionals[1]);
-  const out = positionals[1] ?? join31(dir, `out.${format}`);
+  const out = positionals[1] ?? join33(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");
   }
-  let range;
+  let range2;
   const rangeRaw = strFlag(flags, "range");
   if (rangeRaw !== void 0) {
     const m = /^(\d+(?:\.\d+)?)\.\.(\d+(?:\.\d+)?)$/.exec(rangeRaw);
@@ -17398,8 +19238,8 @@ async function cmdRender(argv) {
       throw new UsageError(
         "--range expects a..b in OUTPUT seconds (e.g. --range 4..8)"
       );
-    range = [Number(m[1]), Number(m[2])];
-    if (range[1] <= range[0])
+    range2 = [Number(m[1]), Number(m[2])];
+    if (range2[1] <= range2[0])
       throw new UsageError("--range end must be > start");
   }
   const browser = await launchBrowser();
@@ -17410,7 +19250,7 @@ async function cmdRender(argv) {
       fps: hasFlag(flags, "fps") ? numFlag(flags, "fps", 30) : void 0,
       format,
       parallel,
-      range,
+      range: range2,
       draft: flags.draft === true,
       overrides: {
         set: multi.set,
@@ -17430,10 +19270,10 @@ async function cmdRender(argv) {
     r.done(
       {
         ...result,
-        ...range ? { range } : {},
+        ...range2 ? { range: range2 } : {},
         ...flags.draft === true ? { draft: true } : {}
       },
-      `Wrote ${result.out} (${(result.bytes / 1024).toFixed(0)} KB, ${result.width}x${result.height}@${result.fps}, ${result.duration.toFixed(1)}s, ${result.zoomSpans} zoom spans, ${result.clicks} click effects${result.audio ? ", audio" : ""}${result.chunks > 1 ? `, ${result.chunks} parallel chunks` : ""}${range ? `, range ${range[0]}..${range[1]}s` : ""}${flags.draft === true ? ", DRAFT" : ""})`
+      `Wrote ${result.out} (${(result.bytes / 1024).toFixed(0)} KB, ${result.width}x${result.height}@${result.fps}, ${result.duration.toFixed(1)}s, ${result.zoomSpans} zoom spans, ${result.clicks} click effects${result.audio ? ", audio" : ""}${result.chunks > 1 ? `, ${result.chunks} parallel chunks` : ""}${range2 ? `, range ${range2[0]}..${range2[1]}s` : ""}${flags.draft === true ? ", DRAFT" : ""})`
     );
     return EXIT_OK;
   } finally {
@@ -17461,7 +19301,7 @@ async function cmdFrames(argv) {
     if (!m) throw new UsageError("--size expects WxH (e.g. --size 1280x800)");
     size = { width: Number(m[1]), height: Number(m[2]) };
   }
-  const duration = docOutputDuration4(take.doc);
+  const duration = docOutputDuration5(take.doc);
   const frameRaw = strFlag(flags, "frame");
   const timesRaw = strFlag(flags, "times");
   const atZooms = flags["at-zooms"] === true;
@@ -17546,7 +19386,7 @@ async function cmdDeliver(argv) {
   } catch (e) {
     throw new UsageError(e instanceof Error ? e.message : String(e));
   }
-  let range;
+  let range2;
   const rangeRaw = strFlag(flags, "range");
   if (rangeRaw !== void 0) {
     const m = /^(\d+(?:\.\d+)?)\.\.(\d+(?:\.\d+)?)$/.exec(rangeRaw);
@@ -17554,8 +19394,8 @@ async function cmdDeliver(argv) {
       throw new UsageError(
         "--range expects a..b in OUTPUT seconds (e.g. --range 4..24)"
       );
-    range = [Number(m[1]), Number(m[2])];
-    if (range[1] <= range[0])
+    range2 = [Number(m[1]), Number(m[2])];
+    if (range2[1] <= range2[0])
       throw new UsageError("--range end must be > start");
   }
   const take = await loadTake(dir);
@@ -17581,7 +19421,7 @@ async function cmdDeliver(argv) {
       channels,
       outDir: strFlag(flags, "out"),
       release: strFlag(flags, "release"),
-      range,
+      range: range2,
       parallel,
       overrides: {
         set: multi.set,
@@ -17626,15 +19466,15 @@ async function resolveStyleRef(flags) {
 }
 async function resolveDocRef(ref, flags, what) {
   const styleRef = ref;
-  const file = existsSync28(styleRef) ? resolve19(
+  const file = existsSync29(styleRef) ? resolve20(
     styleRef,
-    existsSync28(join31(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync29(join33(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync28(file)) {
+  if (file && existsSync29(file)) {
     return {
       from: file,
       doc: migrateHostedDoc4(
-        JSON.parse(await readFile16(file, "utf8"))
+        JSON.parse(await readFile18(file, "utf8"))
       )
     };
   }
@@ -17686,7 +19526,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 readFile16(transcriptPath, "utf8"))) : null;
+  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile18(transcriptPath, "utf8"))) : null;
   const style = await resolveStyleRef(flags);
   const noFrames = flags["no-frames"] === true;
   let browser = null;
@@ -17717,7 +19557,7 @@ async function cmdDigest(argv) {
         kinds,
         frames: d.images.full,
         crops: d.images.crop,
-        sheet: d.images.sheet ? join31(result.outDir, d.images.sheet) : null,
+        sheet: d.images.sheet ? join33(result.outDir, d.images.sheet) : null,
         scenes: kinds.scene ?? 0,
         sourceDuration: d.take.sourceDuration,
         outputDuration: d.take.outputDuration,
@@ -17745,14 +19585,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 (!existsSync28(take.paths.recording)) {
+  if (!existsSync29(take.paths.recording)) {
     throw new UsageError(`${dir} has no recording \u2014 re-run record`);
   }
   const studio = (strFlag(flags, "studio") ?? platformOrigin()).replace(
     /\/+$/,
     ""
   );
-  const server = await startTakeServer(resolve19(dir), {});
+  const server = await startTakeServer(resolve20(dir), {});
   const url = `${studio}/studio?take=${encodeURIComponent(server.base)}`;
   r.event({ event: "open", server: server.base, url });
   r.log(`take served at ${server.base}`);
@@ -17799,7 +19639,7 @@ async function cmdCallout(argv) {
       `no register: put a BRAND.md beside the take (vos brand <url> --out BRAND.md; its bgA and accent are the ground and the accent), or pass --ground #hex --accent #hex`
     );
   const codeFile = strFlag(flags, "code-file");
-  const code = codeFile ? await readFile16(codeFile, "utf8") : strFlag(flags, "code");
+  const code = codeFile ? await readFile18(codeFile, "utf8") : strFlag(flags, "code");
   const words2 = {
     kicker: strFlag(flags, "kicker"),
     title: strFlag(flags, "title"),
@@ -17878,7 +19718,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 : existsSync28(join31(target, "kit.json")) && !isTakeDir(target) ? join31(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync29(join33(target, "kit.json")) && !isTakeDir(target) ? join33(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -17910,9 +19750,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync28(join31(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync29(join33(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile16(join31(target, "config.json"), "utf8")
+      await readFile18(join33(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -17954,7 +19794,7 @@ async function cmdValidate(argv) {
   const problems = [];
   const warnings = [];
   const notes = [];
-  if (!existsSync28(take.paths.recording)) {
+  if (!existsSync29(take.paths.recording)) {
     problems.push("missing recording (re-run record)");
   } else {
     const mismatch = containerMismatch(
@@ -17995,16 +19835,12 @@ async function cmdValidate(argv) {
       const found = localFile(rel, target);
       if (!("refused" in found)) continue;
       problems.push(
-        existsSync28(resolve19(target, rel)) ? `doc.json: ${ref.where}: ${ref.key} ${found.refused}` : `doc.json: ${ref.where}: ${ref.key} is not a file in the take, so a render plays the film without it (put the file there, or fix the key)`
+        existsSync29(resolve20(target, rel)) ? `doc.json: ${ref.where}: ${ref.key} ${found.refused}` : `doc.json: ${ref.where}: ${ref.key} is not a file in the take, so a render plays the film without it (put the file there, or fix the key)`
       );
     }
     if (flags.picture === true && (take.doc.overlays ?? []).some((o) => o.kind === "html")) {
       const doc = take.doc;
-      const times = [
-        ...new Set(
-          (doc.overlays ?? []).filter((o) => o.kind === "html").map((o) => +(o.start + Math.min(0.35, o.duration / 2)).toFixed(3))
-        )
-      ];
+      const times = groundCheckTimes(doc);
       const browser = await launchBrowser();
       try {
         const frames = await footageFrames(
@@ -18078,7 +19914,7 @@ async function cmdPush3(argv) {
     );
   const refusal = takePushRefusal({
     vos: strFlag(flags, "vos"),
-    trackedVosId: readSyncState(resolve19(dir))?.vosId ?? null,
+    trackedVosId: readSyncState(resolve20(dir))?.vosId ?? null,
     programOnly: ["slug", "desc", "tags", "base", "remix-of", "still"].filter(
       (name) => hasFlag(flags, name)
     )
@@ -18094,7 +19930,7 @@ async function cmdPush3(argv) {
         `--claimable creates a NEW claimable vos; ${iterating.map((f) => `--${f}`).join(", ")} ${iterating.length > 1 ? "apply" : "applies"} to a keyed push`
       );
     const claim = await pushTakeClaimable(
-      resolve19(dir),
+      resolve20(dir),
       {
         api: strFlag(flags, "api"),
         origin: strFlag(flags, "origin"),
@@ -18117,7 +19953,7 @@ reference and the only credential.`
   }
   const overrides = multi.override;
   const result = await pushTake(
-    resolve19(dir),
+    resolve20(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -18172,7 +20008,7 @@ async function cmdPull2(argv) {
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
-    resolve19(dir),
+    resolve20(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -18301,6 +20137,8 @@ async function run(argv) {
         return await cmdCheckVideo(rest);
       case "join":
         return await cmdJoin(rest);
+      case "info":
+        return await cmdTakeInfo(rest);
       case "score":
         return await cmdScore(rest);
       case "audio":
@@ -18316,7 +20154,7 @@ async function run(argv) {
 `);
       return EXIT_USAGE;
     }
-    if (e instanceof SetupError || e instanceof SetupEnvError || e instanceof RecordRefusedError || e instanceof PlatformBehindError || e instanceof PushRefusedError) {
+    if (e instanceof SetupError || e instanceof SetupEnvError || e instanceof RecordRefusedError || e instanceof PlatformBehindError || e instanceof PushRefusedError || e instanceof PasteFileRefusal) {
       process.stderr.write(`${e.message}
 `);
       return EXIT_USAGE;
@@ -18389,7 +20227,7 @@ async function cmdSession(argv) {
       if (!arg) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync28(sessionDir(arg)))
+      if (!existsSync29(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const summary3 = await summarizeSession(arg);
       const url = strFlag(flags, "url");
@@ -18466,4 +20304,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-TWAP4BKR.js.map
+//# sourceMappingURL=chunk-SP5OHTVB.js.map