@vosjs/cli 0.77.0 → 0.78.0

package/dist/{chunk-SB622PZM.js → chunk-INRUYQ6J.js}

@@ -9,12 +9,14 @@ import {
   reencodeStill,
   renderStill,
   videoFormat
-} from "./chunk-KDIRW72G.js";
+} from "./chunk-JYCW4EOA.js";
 import {
   PREV_DOC_NAME,
   RECORDING_NAME,
   docLayerRefs,
   docMediaRefs,
+  docObjectRefs,
+  docOverlayRefs,
   dropScreencastFrames,
   ensureTakeDir,
   fileSha256,
@@ -37,7 +39,7 @@ import {
   uploadDocRefs,
   uploadManifest,
   writeJson
-} from "./chunk-UY2N42P2.js";
+} from "./chunk-ZSJEISKL.js";
 import {
   CREDENTIALS_PATH,
   MEDIA_HEAD_BYTES,
@@ -62,6 +64,7 @@ import {
   programAssets,
   promptHint,
   readSyncState,
+  refuseSymlink,
   requireCredential,
   resolveCredential,
   resolveMediaType,
@@ -133,12 +136,12 @@ function landedLines(l) {
 }
 
 // src/plugin/run.ts
-import { mkdir as mkdir8, readFile as readFile13, rm as rm2 } from "fs/promises";
-import { existsSync as existsSync23 } from "fs";
-import { join as join25, resolve as resolve14 } from "path";
+import { mkdir as mkdir13, readFile as readFile15, rm as rm5 } from "fs/promises";
+import { existsSync as existsSync27 } from "fs";
+import { join as join29, resolve as resolve18 } from "path";
 import {
   END_CARD_FROM as END_CARD_FROM2,
-  docOutputDuration as docOutputDuration3,
+  docOutputDuration as docOutputDuration4,
   migrateHostedDoc as migrateHostedDoc4
 } from "@vosjs/studio-core";
 
@@ -215,7 +218,10 @@ import {
   docCardLayout,
   docZoomTrack,
   findStep,
+  formatElapsed,
+  hasElapsed,
   outputEnd,
+  resolveAnchor,
   pinBox,
   pinCandidates,
   pinRectOnScreen,
@@ -451,6 +457,7 @@ function lintDoc(docIn) {
   const doc = docIn;
   const problems = [];
   const warnings = [];
+  const notes = [];
   const recording = isObj(doc.source);
   const source = isObj(doc.source) ? doc.source : {};
   const meta = isObj(source.meta) ? source.meta : {};
@@ -1047,6 +1054,15 @@ function lintDoc(docIn) {
       footageEnd = null;
     }
   }
+  let anchorPieces = null;
+  if (recording) {
+    try {
+      anchorPieces = ratedSegments(doc);
+    } catch {
+      anchorPieces = null;
+    }
+  }
+  const captionTimes = [];
   for (let i = 0; i < (overlays?.length ?? 0); i++) {
     const o = overlays[i];
     const name = `overlays[${i}]`;
@@ -1054,6 +1070,24 @@ function lintDoc(docIn) {
       problems.push(`${name} must be an object`);
       continue;
     }
+    const playsAt = checkOverlayAnchor(
+      o,
+      name,
+      docIn,
+      recording,
+      anchorPieces,
+      problems,
+      warnings,
+      notes
+    );
+    if (o.kind === "text" && o.preset === "caption" && o.pin === void 0 && isNum(playsAt) && isNum(o.duration) && o.duration > 0) {
+      const label = typeof o.id === "string" ? `${name} (${o.id})` : name;
+      captionTimes.push({
+        name: label,
+        start: playsAt,
+        end: playsAt + o.duration
+      });
+    }
     if (o.kind !== "text" && o.kind !== "image" && o.kind !== "video" && o.kind !== "html") {
       problems.push(
         `${name}.kind must be "text" | "image" | "video" | "html" (got ${String(o.kind)})`
@@ -1064,14 +1098,14 @@ function lintDoc(docIn) {
     if (!isNum(o.duration) || o.duration <= 0) {
       problems.push(`${name}.duration must be > 0 (seconds)`);
     }
-    if (footageEnd !== null && footageEnd > 0 && isNum(o.start) && isNum(o.duration)) {
-      const over = o.start + o.duration - footageEnd;
+    if (footageEnd !== null && footageEnd > 0 && isNum(playsAt) && isNum(o.duration)) {
+      const over = playsAt + o.duration - footageEnd;
       const frameAnim = isObj(docIn) && isObj(docIn.frame) && isObj(docIn.frame.anim) ? docIn.frame.anim : null;
       const exit = frameAnim ? isObj(frameAnim.exit) ? frameAnim.exit.kind : frameAnim.exit : void 0;
       const cardLeaves = exit !== void 0 && exit !== "none";
       if (over > 0.05 && !cardLeaves) {
         warnings.push(
-          o.start >= footageEnd ? `${name} starts at ${o.start.toFixed(2)}s, after the footage ends (${footageEnd.toFixed(2)}s): it plays over the card's held last frame and lengthens the output by ${over.toFixed(2)}s. A trim moves the footage, never an OUTPUT-anchored layer: re-place it (vos callout with the same --id), put a freeze under it, or, for a closing card on the ground, let the card leave (frame.anim.exit: 'fade')` : `${name} ends ${over.toFixed(2)}s after the footage (${footageEnd.toFixed(2)}s): the card holds its last frame under it. Shorten it, put a freeze under it, or, for a closing card on the ground, let the card leave (frame.anim.exit: 'fade')`
+          playsAt >= footageEnd ? `${name} starts at ${playsAt.toFixed(2)}s, after the footage ends (${footageEnd.toFixed(2)}s): it plays over the card's held last frame and lengthens the output by ${over.toFixed(2)}s. A trim moves the footage, never an OUTPUT-anchored layer: re-place it (vos callout with the same --id), put a freeze under it, or, for a closing card on the ground, let the card leave (frame.anim.exit: 'fade')` : `${name} ends ${over.toFixed(2)}s after the footage (${footageEnd.toFixed(2)}s): the card holds its last frame under it. Shorten it, put a freeze under it, or, for a closing card on the ground, let the card leave (frame.anim.exit: 'fade')`
         );
       }
     }
@@ -1616,6 +1650,17 @@ function lintDoc(docIn) {
       }
     }
   }
+  captionTimes.sort((a, b) => a.start - b.start || a.end - b.end);
+  for (let i = 0; i < captionTimes.length; i++) {
+    for (let j = i + 1; j < captionTimes.length; j++) {
+      const a = captionTimes[i];
+      const b = captionTimes[j];
+      if (b.start >= a.end - EPS) break;
+      warnings.push(
+        `${a.name} (${a.start.toFixed(2)}\u2013${a.end.toFixed(2)}s) and ${b.name} (${b.start.toFixed(2)}\u2013${b.end.toFixed(2)}s) are captions on screen at the same time; shorten the first, move one (an anchor's offset), or drop one`
+      );
+    }
+  }
   if (isObj(doc.export)) {
     const resolution = doc.export.resolution;
     const validResolution = EXPORT_RESOLUTION_OPTIONS.includes(resolution);
@@ -1643,7 +1688,66 @@ function lintDoc(docIn) {
   }
   if (recording)
     framingWarnings(docIn, doc, zoom, overlays ?? [], warnings);
-  return { problems, warnings };
+  return { problems, warnings, ...notes.length ? { notes } : {} };
+}
+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;
+  const elapsed = o.kind === "text" && hasElapsed(words2);
+  if (o.anchor === void 0) {
+    if (elapsed)
+      warnings.push(
+        `${name}: its words carry {elapsed}, which fills only from an anchored step's off-camera wait; anchor it (anchor: { step }) or write the duration`
+      );
+    return fallback;
+  }
+  const a = o.anchor;
+  if (!isObj(a)) {
+    problems.push(`${name}.anchor must be { step, media?, at?, offset? }`);
+    return fallback;
+  }
+  let shaped = true;
+  if (typeof a.step !== "string" && !(isNum(a.step) && Number.isInteger(a.step) && a.step >= 0)) {
+    problems.push(
+      `${name}.anchor.step must be a step id (string) or its index (integer \u2265 0)`
+    );
+    shaped = false;
+  }
+  if (a.media !== void 0 && typeof a.media !== "string") {
+    problems.push(`${name}.anchor.media must be a media[].id (string)`);
+    shaped = false;
+  }
+  if (a.at !== void 0 && a.at !== "start" && a.at !== "end") {
+    problems.push(`${name}.anchor.at must be "start" or "end"`);
+    shaped = false;
+  }
+  if (a.offset !== void 0 && !isNum(a.offset)) {
+    problems.push(`${name}.anchor.offset must be a number (OUTPUT seconds)`);
+    shaped = false;
+  }
+  if (!shaped || !recording || !pieces) return fallback;
+  const r = resolveAnchor(
+    docIn,
+    a,
+    pieces
+  );
+  const step = `step ${JSON.stringify(a.step)}${typeof a.media === "string" ? ` of media ${a.media}` : ""}`;
+  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 (elapsed && r.elapsedFrom && r.elapsedMs !== void 0)
+    notes.push(
+      `${name}: {elapsed} reads the off-camera wait of step ${JSON.stringify(r.elapsedFrom.id ?? r.elapsedFrom.step)} (${formatElapsed(r.elapsedMs)}), the nearest one before ${step}, which waited for nothing itself`
+    );
+  if (elapsed && r.elapsedMs === void 0 && r.miss !== "media" && r.miss !== "step")
+    warnings.push(
+      `${name}: {elapsed} stays as written, because neither ${step} nor any step before it recorded an off-camera wait (no meta.skips entry names one, and none has an offCameraMs)`
+    );
+  return r.start ?? fallback;
 }
 function clicksWithRects(source) {
   const cursor = Array.isArray(source.cursor) ? source.cursor : [];
@@ -1759,15 +1863,33 @@ function checkPin(o, name, docIn, recording, problems, warnings) {
 }
 function framingWarnings(docIn, doc, zoom, overlays, warnings) {
   try {
-    const source = isObj(doc.source) ? doc.source : {};
-    const meta = isObj(source.meta) ? source.meta : {};
-    const w = isNum(meta.width) ? meta.width : 0;
-    const h = isNum(meta.height) ? meta.height : 0;
-    if (!(w > 0) || !(h > 0)) return;
-    const clicks = clicksWithRects(source);
-    if (!clicks.length) return;
+    const evidence = /* @__PURE__ */ new Map();
+    const others = Array.isArray(doc.media) ? doc.media : [];
+    for (const [key, src] of [
+      ["", doc.source],
+      ...others.map((m) => [isObj(m) ? m.id : void 0, m])
+    ]) {
+      if (typeof key !== "string" || !isObj(src)) continue;
+      const meta = isObj(src.meta) ? src.meta : {};
+      const w = isNum(meta.width) ? meta.width : 0;
+      const h = isNum(meta.height) ? meta.height : 0;
+      if (!(w > 0) || !(h > 0)) continue;
+      const clicks = clicksWithRects(src);
+      if (!clicks.length) continue;
+      let layout2;
+      try {
+        layout2 = docCardLayout(docIn, key || null);
+      } catch {
+        continue;
+      }
+      evidence.set(key, { w, h, clicks, layout: layout2 });
+    }
+    if (!evidence.size) return;
     const layout = docCardLayout(docIn);
     for (const z of zoom) {
+      const ev = evidence.get(typeof z.media === "string" ? z.media : "");
+      if (!ev) continue;
+      const { w, h, clicks } = ev;
       if (!isNum(z.in) || !isNum(z.out) || !isNum(z.level) || !isNum(z.cx) || !isNum(z.cy) || z.level <= 1.001)
         continue;
       const zin = z.in;
@@ -1794,7 +1916,7 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
           focusMode: z.focusMode
         },
         rect,
-        layout,
+        ev.layout,
         0.02,
         cameraModel(docIn.frame)
       )) {
@@ -1897,19 +2019,22 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
       } catch {
         return;
       }
-      for (const c of clicks) {
-        const out = spanOutputExtent(rated, c.t, c.t + 1e-3);
+      const presses = [...evidence.entries()].flatMap(
+        ([key, ev]) => ev.clicks.map((c) => ({ c, key, ev }))
+      );
+      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)
           continue;
         const target = pinRectOnScreen(
           {
-            x: c.rect.x / w,
-            y: c.rect.y / h,
-            w: c.rect.w / w,
-            h: c.rect.h / h
+            x: c.rect.x / ev.w,
+            y: c.rect.y / ev.h,
+            w: c.rect.w / ev.w,
+            h: c.rect.h / ev.h
           },
           out.start,
-          layout,
+          ev.layout,
           camera,
           zoomTrack
         );
@@ -2017,7 +2142,7 @@ function mediaProbeLints(results) {
 }
 
 // src/plugin/framesTake.ts
-import { mkdir as mkdir2, readFile as readFile3, rename as rename2, writeFile as writeFile3 } from "fs/promises";
+import { mkdir as mkdir2, readFile as readFile3, rename as rename2, rm as rm2, writeFile as writeFile3 } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
 import { join as join3, resolve as resolve3 } from "path";
 import { compileVosConfig } from "@vosjs/core";
@@ -2204,9 +2329,11 @@ import { readFile, rm } from "fs/promises";
 import { tweenRuntimeCode } from "@vosjs/tween/bundle";
 import { elementsBundleCode } from "@vosjs/elements/bundle";
 import { concatEncodedVideo, planChunks } from "@vosjs/render-core";
-var MEDIABUNNY_URL = "https://esm.sh/mediabunny@1.55.7?target=es2022";
-var THREE_URL = "https://esm.sh/three@0.183.0?target=es2022";
-var THREE_ADDONS = "https://esm.sh/three@0.183.0&target=es2022/examples/jsm/";
+import { esmShModules } from "@vosjs/core/addons";
+var MODULES = esmShModules();
+var MEDIABUNNY_URL = MODULES.mediabunny;
+var THREE_URL = MODULES.three;
+var THREE_ADDONS = MODULES.threeAddons;
 function renderPageHtml() {
   const importmap = JSON.stringify({
     imports: { three: THREE_URL, "three/addons/": THREE_ADDONS }
@@ -3277,6 +3404,55 @@ var VIDEO_TOKEN = "__VOS_CLI_VIDEO__";
 function stillSupersample(w, h) {
   return Math.min(3, Math.max(1, Math.ceil(1800 / Math.max(1, w, h))));
 }
+function zoomApexes(doc) {
+  const rated = ratedSegments2(doc);
+  const media = new Set((doc.media ?? []).map((m) => m.id));
+  const apexes = [];
+  const skipped = [];
+  for (const z of doc.zoom) {
+    const of = z.media ? { media: z.media } : {};
+    if (z.media && !media.has(z.media)) {
+      skipped.push({
+        id: z.id,
+        ...of,
+        in: z.in,
+        out: z.out,
+        reason: `names media "${z.media}", which the take does not carry`
+      });
+      continue;
+    }
+    const ext = spanOutputExtent2(rated, z.in, z.out, z.media);
+    if (!ext) {
+      skipped.push({
+        id: z.id,
+        ...of,
+        in: z.in,
+        out: z.out,
+        reason: "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
+    });
+  }
+  return { apexes, skipped };
+}
+var ZOOM_UNRENDERED_BELOW = 4e-3;
+var SIGNATURE_LONG_SIDE = 96;
+function signatureDifference(a, b) {
+  if (a.length !== b.length || a.length === 0) return 1;
+  let sum = 0;
+  for (let i = 0; i < a.length; i++) sum += Math.abs(a[i] - b[i]);
+  return sum / a.length / 255;
+}
+function unrenderedZoomLine(f) {
+  return `zoom ${f.zoomId ?? "?"} at ${f.time.toFixed(2)}s did not render (its frame matches the zoom-off frame${f.twin ? `: ${f.twin}` : ""})`;
+}
 async function stillsInPage(opts) {
   const w = window;
   const RW = opts.W * opts.ss;
@@ -3285,11 +3461,9 @@ async function stillsInPage(opts) {
     const vblob = await (await fetch(opts.videoUrl)).blob();
     const vurl = URL.createObjectURL(vblob);
     const code = opts.animationCode.split(opts.token).join(vurl);
-    const mod = await import(
-      /* @vite-ignore */
-      URL.createObjectURL(
-        new Blob([code], { type: "text/javascript" })
-      )
+    const load = new Function("u", "return import(u)");
+    const mod = await load(
+      URL.createObjectURL(new Blob([code], { type: "text/javascript" }))
     );
     w.__vos__ = w.__vos__ || {};
     w.__vos__.isPaused = true;
@@ -3365,6 +3539,25 @@ async function stillsInPage(opts) {
         }
       }
     };
+    const sigCanvas = document.createElement("canvas");
+    sigCanvas.width = opts.sigW;
+    sigCanvas.height = opts.sigH;
+    const signature = () => {
+      const g = sigCanvas.getContext("2d", { willReadFrequently: true });
+      g.imageSmoothingEnabled = true;
+      g.imageSmoothingQuality = "high";
+      g.clearRect(0, 0, opts.sigW, opts.sigH);
+      g.drawImage(canvas, 0, 0, opts.sigW, opts.sigH);
+      const px = g.getImageData(0, 0, opts.sigW, opts.sigH).data;
+      const out2 = new Array(opts.sigW * opts.sigH);
+      for (let p = 0, q = 0; p < px.length; p += 4, q++)
+        out2[q] = Math.round(
+          0.299 * px[p] + 0.587 * px[p + 1] + 0.114 * px[p + 2]
+        );
+      return out2;
+    };
+    const sigWanted = new Set(opts.sigNames);
+    const sigs = {};
     for (let i = 0; i < opts.shots.length; i++) {
       const shot = opts.shots[i];
       timeline.seek(shot.time, false);
@@ -3376,14 +3569,56 @@ async function stillsInPage(opts) {
       }
       await waitVideosSettled(8e3);
       const png = await toPng();
+      if (sigWanted.has(shot.name)) sigs[shot.name] = signature();
       await fetch("/save?name=" + shot.name, { method: "POST", body: png });
       w.__progress = (i + 1) / opts.shots.length;
     }
-    w.__done = { ok: true, count: opts.shots.length };
+    w.__done = { ok: true, count: opts.shots.length, sigs };
   } catch (e) {
     w.__error = String(e instanceof Error && e.stack || e);
   }
 }
+async function captureShots(context2, base, opts) {
+  const long = Math.max(opts.width, opts.height);
+  const side = (n) => Math.max(1, Math.round(n / long * SIGNATURE_LONG_SIDE));
+  const page = await context2.newPage();
+  try {
+    page.on("console", (m) => {
+      if (m.type() === "error")
+        process.stderr.write(`   [stills page] ${m.text()}
+`);
+    });
+    await page.addInitScript(() => {
+      ;
+      globalThis.__name = (f) => f;
+    });
+    await page.goto(`${base}/render.html`);
+    await page.waitForFunction("window.__pageReady__ === true");
+    void page.evaluate(stillsInPage, {
+      animationCode: opts.animationCode,
+      token: VIDEO_TOKEN,
+      videoUrl: opts.videoUrl,
+      W: opts.width,
+      H: opts.height,
+      ss: opts.ss,
+      shots: opts.shots,
+      sigNames: opts.sigNames,
+      sigW: side(opts.width),
+      sigH: side(opts.height)
+    }).catch(() => {
+    });
+    const done = await waitForPageDone(
+      page,
+      "stills",
+      () => {
+      },
+      12e4 + opts.shots.length * 4e3
+    );
+    return done.sigs ?? {};
+  } finally {
+    await page.close();
+  }
+}
 async function framesTake(browser, dir, opts) {
   const take = await loadTake(dir);
   const doc = opts.doc ? structuredClone(opts.doc) : take.doc;
@@ -3406,13 +3641,17 @@ async function framesTake(browser, dir, opts) {
     time: clamp(t),
     kind: "time"
   }));
+  let skippedZooms;
   if (opts.atZooms) {
-    const rated = ratedSegments2(doc);
-    for (const z of doc.zoom) {
-      const ext = spanOutputExtent2(rated, z.in, z.out);
-      if (ext)
-        shots.push({ time: clamp((ext.start + ext.end) / 2), kind: "zoom" });
-    }
+    const { apexes, skipped } = zoomApexes(doc);
+    for (const a of apexes)
+      shots.push({
+        time: clamp(a.time),
+        kind: "zoom",
+        zoomId: a.id,
+        ...a.media ? { media: a.media } : {}
+      });
+    skippedZooms = skipped;
   }
   if (opts.atMoments) {
     for (const m of await momentsFor(dir, doc)) {
@@ -3423,16 +3662,19 @@ async function framesTake(browser, dir, opts) {
   if (opts.atStill)
     shots.push({ time: clamp(docStillTime(doc)), kind: "still" });
   shots.sort((a, b) => a.time - b.time);
-  if (!shots.length)
+  if (!shots.length && !skippedZooms?.length)
     throw new Error(
       "no frame times \u2014 pass --times/--frame, --at-zooms, --at-moments or --at-still"
     );
   const outDir = resolve3(opts.outDir ?? join3(dir, "stills"));
   await mkdir2(outDir, { recursive: true });
+  const stamp = (i, t) => `${String(i).padStart(2, "0")}-${t.toFixed(2)}s.png`;
   const named = shots.map((s, i) => ({
     ...s,
-    name: s.kind === "moment" ? `moment-${s.momentId}-${s.time.toFixed(2)}s.png` : `${s.kind === "zoom" ? "zoom" : "frame"}-${String(i).padStart(2, "0")}-${s.time.toFixed(2)}s.png`
+    name: s.kind === "moment" ? `moment-${s.momentId}-${s.time.toFixed(2)}s.png` : `${s.kind === "zoom" ? "zoom" : "frame"}-${stamp(i, s.time)}`,
+    twinName: s.kind === "zoom" ? `zoomoff-${stamp(i, s.time)}` : void 0
   }));
+  const zoomShots = named.filter((n) => n.kind === "zoom");
   const server = await startTakeServer(dir, {
     "/render.html": renderPageHtml()
   });
@@ -3440,49 +3682,73 @@ async function framesTake(browser, dir, opts) {
   const context2 = await browser.newContext({
     viewport: { width: width * ss, height: height * ss }
   });
+  const videoUrl = `/${take.paths.recordingName}`;
   try {
-    const page = await context2.newPage();
-    page.on("console", (m) => {
-      if (m.type() === "error")
-        process.stderr.write(`   [stills page] ${m.text()}
-`);
-    });
-    await page.addInitScript(() => {
-      ;
-      globalThis.__name = (f) => f;
-    });
-    await page.goto(`${server.base}/render.html`);
-    await page.waitForFunction("window.__pageReady__ === true");
-    void page.evaluate(stillsInPage, {
+    const sigs = named.length ? await captureShots(context2, server.base, {
       animationCode,
-      token: VIDEO_TOKEN,
-      videoUrl: `/${take.paths.recordingName}`,
-      W: width,
-      H: height,
+      videoUrl,
+      width,
+      height,
       ss,
-      shots: named.map(({ time, name }) => ({ time, name }))
-    }).catch(() => {
-    });
-    await waitForPageDone(
-      page,
-      "stills",
-      () => {
-      },
-      12e4 + named.length * 4e3
-    );
+      shots: named.map(({ time, name }) => ({ time, name })),
+      sigNames: zoomShots.map((n) => n.name)
+    }) : {};
+    let twinSigs = {};
+    if (zoomShots.length) {
+      const twinDoc = structuredClone(doc);
+      applyDocOverrides(twinDoc, { set: ["zoom=[]"] });
+      const twinLowered = lowerToComposition(twinDoc);
+      twinSigs = await captureShots(context2, server.base, {
+        animationCode: compileVosConfig(twinLowered.config, {
+          tweenEngine: "vos"
+        }),
+        videoUrl,
+        width,
+        height,
+        ss,
+        shots: zoomShots.map((n) => ({ time: n.time, name: n.twinName })),
+        sigNames: zoomShots.map((n) => n.twinName)
+      });
+    }
     const frames = [];
     for (const n of named) {
       const from = join3(dir, n.name);
       const to = join3(outDir, n.name);
       if (from !== to) await rename2(from, to);
-      frames.push({
+      const frame = {
         file: to,
         time: n.time,
         kind: n.kind,
-        ...n.momentId ? { momentId: n.momentId } : {}
-      });
+        ...n.momentId ? { momentId: n.momentId } : {},
+        ...n.zoomId ? { zoomId: n.zoomId } : {},
+        ...n.media ? { media: n.media } : {}
+      };
+      if (n.twinName) {
+        const a = sigs[n.name];
+        const b = twinSigs[n.twinName];
+        const twinFrom = join3(dir, n.twinName);
+        if (a && b) {
+          const difference = signatureDifference(a, b);
+          frame.rendered = difference >= ZOOM_UNRENDERED_BELOW;
+          frame.difference = Math.round(difference * 1e5) / 1e5;
+          if (!frame.rendered) {
+            const twinTo = join3(outDir, n.twinName);
+            if (twinFrom !== twinTo) await rename2(twinFrom, twinTo);
+            frame.twin = twinTo;
+          }
+        }
+        if (!frame.twin) await rm2(twinFrom, { force: true });
+      }
+      frames.push(frame);
     }
-    return { frames, width, height, duration, outDir };
+    return {
+      frames,
+      width,
+      height,
+      duration,
+      outDir,
+      ...skippedZooms ? { skippedZooms } : {}
+    };
   } finally {
     await context2.close();
     server.close();
@@ -3520,7 +3786,8 @@ async function writeIndexJson(result) {
         width: result.width,
         height: result.height,
         duration: result.duration,
-        frames: result.frames
+        frames: result.frames,
+        ...result.skippedZooms?.length ? { skippedZooms: result.skippedZooms } : {}
       },
       null,
       2
@@ -3668,8 +3935,8 @@ import {
 // src/plugin/moments.ts
 import { spanOutputExtent as spanOutputExtent3 } from "@vosjs/studio-core";
 var STEP_SETTLE_SECONDS = 0.4;
-function stepOutputTime(rated, step, settle) {
-  const src = step.tEnd + settle;
+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;
@@ -3685,6 +3952,20 @@ var LOOP_DESTINATIONS = /* @__PURE__ */ new Set(["github-readme-loop"]);
 var BED_ID = "bed";
 var CLICK_ID_PREFIX = "click-";
 var CAPTION_ID_PREFIX = "caption-";
+function houseCaption(id, text, start, duration) {
+  return {
+    id,
+    kind: "text",
+    text,
+    preset: "caption",
+    start,
+    duration,
+    transform: { x: 0.5, y: 0.86, scale: 1, rotation: 0 },
+    anim: { enter: "rise", exit: "fade" },
+    align: "center",
+    box: { color: "rgba(17,17,17,0.72)" }
+  };
+}
 var off = (v) => v !== void 0 && /^(none|off|false|no)$/i.test(v.trim());
 var round3 = (v) => Math.round(v * 1e3) / 1e3;
 var TRANSITION_CLIP_MIN = 1;
@@ -3765,7 +4046,7 @@ function templateWords(words2) {
   if (sub && sub !== headline) out["endcard-sub"] = sub;
   return out;
 }
-function resolveAnchor(doc, at2) {
+function resolveAnchor2(doc, at2) {
   if (typeof at2 !== "object") return at2;
   const steps = doc.source.meta.steps ?? [];
   const step = steps.find((s) => s.id === at2.step || String(s.step) === at2.step);
@@ -3810,7 +4091,7 @@ function proposeMotion(input, opts) {
   const tWords = templateWords(words2);
   const keys = opts.mark ? { "stage-mark": opts.mark.key, "endcard-markimg": opts.mark.key } : void 0;
   for (const t of templates) {
-    const at2 = resolveAnchor(doc, t.at);
+    const at2 = resolveAnchor2(doc, t.at);
     if (at2 === null) {
       skipped.push(`${t.from}: ${anchorWord(t.at)} was not recorded`);
       continue;
@@ -3891,18 +4172,14 @@ function proposeMotion(input, opts) {
       if (!step || step.skipped) continue;
       const t = stepOutputTime(rated, step, 0.2);
       if (t === null || t < 0 || t > footage - 1) continue;
-      captionClips.push({
-        id: `${CAPTION_ID_PREFIX}${c.step}`,
-        kind: "text",
-        text: c.caption,
-        preset: "caption",
-        start: +t.toFixed(3),
-        duration: Math.min(3.5, Math.max(2.5, footage - t - 0.2)),
-        transform: { x: 0.5, y: 0.86, scale: 1, rotation: 0 },
-        anim: { enter: "rise", exit: "fade" },
-        align: "center",
-        box: { color: "rgba(17,17,17,0.72)" }
-      });
+      captionClips.push(
+        houseCaption(
+          `${CAPTION_ID_PREFIX}${c.step}`,
+          c.caption,
+          +t.toFixed(3),
+          Math.min(3.5, Math.max(2.5, footage - t - 0.2))
+        )
+      );
     }
     if (captionClips.length) notes.push(`${captionClips.length} caption(s)`);
   }
@@ -5330,8 +5607,24 @@ async function validateKit(kitPath, opts = {}) {
 
 // src/plugin/recorder.ts
 import { writeFileSync } from "fs";
+import { mkdir as mkdir5 } from "fs/promises";
 import { join as join8 } from "path";
-import { recordTake as recordTakeCore } from "@vosjs/render-core/record";
+import {
+  fileNameProblem,
+  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);
+    }
+  };
+}
 async function recordTake(browser, url, actions, paths, log, opts = {}) {
   const dry = opts.dryRun === true;
   const result = await recordTakeCore(
@@ -5346,6 +5639,7 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
     log,
     {
       ...opts,
+      outputs: outputsSink(paths.dir),
       env: process.env,
       platform: process.platform === "darwin" ? "mac" : process.platform === "win32" ? "windows" : "linux"
     }
@@ -5359,6 +5653,14 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
   return result;
 }
 
+// src/plugin/run.ts
+import {
+  RecordRefusedError,
+  guardVerdict,
+  guardedSteps,
+  hostedRefusals
+} from "@vosjs/render-core/record";
+
 // src/plugin/wall.ts
 import {
   WALL_PROBE,
@@ -5453,10 +5755,10 @@ async function openSession(name, url, opts = { log: () => {
   opts.log(
     `a Chrome window opened on session "${name}": sign in to ${new URL(url).host}, ${leave}`
   );
-  return new Promise((resolve15, reject) => {
+  return new Promise((resolve19, reject) => {
     const child = spawn(exe, args, { stdio: "ignore" });
     child.on("error", reject);
-    child.on("exit", (code) => resolve15({ code }));
+    child.on("exit", (code) => resolve19({ code }));
   });
 }
 async function withSession(name, fn, opts = {}) {
@@ -5605,9 +5907,14 @@ import {
   withBackdrop,
   migrateMotion as migrateMotion2
 } from "@vosjs/studio-core";
+import { splitSegmentsAtSkips } from "@vosjs/render-core/record";
 
 // src/plugin/reuse.ts
-import { docFreezes, ratedSegments as ratedSegments6 } from "@vosjs/studio-core";
+import {
+  docFreezes,
+  ratedSegments as ratedSegments6,
+  resolveAnchor as resolveLayerAnchor
+} from "@vosjs/studio-core";
 var MIN_SPAN = 0.15;
 var AFTER_STEP = 1;
 var LAYER_AFTER_STEP = 5;
@@ -5683,7 +5990,7 @@ function buildStepMap(oldSteps, newSteps, oldDuration, newDuration) {
   };
   return { map, unmatched, matched };
 }
-function resolveAnchor2(anchor, newSteps) {
+function resolveAnchor3(anchor, newSteps) {
   const step = stepByRef(newSteps, anchor.step);
   if (!step || step.skipped) return null;
   const base = anchor.at === "end" ? step.tEnd : step.tStart;
@@ -5703,7 +6010,7 @@ function framed(span) {
 }
 function placeMoment(t, anchor, ctx) {
   if (anchor) {
-    const at2 = resolveAnchor2(anchor, ctx.newSteps);
+    const at2 = resolveAnchor3(anchor, ctx.newSteps);
     if (at2 === null) return { gone: String(anchor.step) };
     ctx.report.anchored++;
     return { at: at2, via: "anchor" };
@@ -5871,6 +6178,17 @@ function retimeOverlays(prev, next, report) {
     return { ...o, start: +start.toFixed(3) };
   };
   return overlays.map((o) => {
+    if (o.anchor && typeof o.anchor === "object") {
+      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`
+        );
+        return o;
+      }
+      report.anchored++;
+      return { ...o, start: r.start };
+    }
     const pin = o.pin;
     if (pin?.step !== void 0) {
       const was = stepByRef(oldSteps, pin.step);
@@ -6001,7 +6319,7 @@ async function planTake(dir, opts = {}) {
     doc = projectFromArtifact(artifact, take.paths.recordingName, ingest).doc;
     doc = copyStyle(prev, doc);
     const rt = retimeCut(prev, meta.steps ?? [], meta.durationMs);
-    doc.segments = rt.segments;
+    doc.segments = splitSegmentsAtSkips(rt.segments, meta.skips);
     if (rt.freeze.length) doc.freeze = rt.freeze;
     if (rt.rejected.length) doc.rejected = rt.rejected;
     const manualZoom = rt.zoom;
@@ -6099,6 +6417,7 @@ async function planTake(dir, opts = {}) {
       meta
     };
     doc = projectFromArtifact(artifact, take.paths.recordingName, ingest).doc;
+    doc.segments = splitSegmentsAtSkips(doc.segments, meta.skips);
     if (opts.style) {
       const applied = applyStyle(opts.style.doc, doc, opts);
       doc = applied.doc;
@@ -6210,7 +6529,7 @@ async function writeScriptBeside(dir, doc) {
 }
 
 // src/plugin/folder.ts
-import { mkdir as mkdir5 } from "fs/promises";
+import { mkdir as mkdir6 } from "fs/promises";
 import { join as join12 } from "path";
 import { recipeHints } from "@vosjs/shared/frontmatter";
 import { migrateHostedDoc } from "@vosjs/studio-core";
@@ -6419,7 +6738,7 @@ async function cmdPull(argv) {
   const payload = res.body;
   const safeName = (v, id) => safePathName((v ?? "").toLowerCase(), id);
   const out = strFlag(flags, "out") ?? safeName(folder.slug, folder.id);
-  await mkdir5(join12(out, "recipes"), { recursive: true });
+  await mkdir6(join12(out, "recipes"), { recursive: true });
   const lines = [];
   const recipes = [];
   for (const rec of payload.recipes) {
@@ -6429,7 +6748,7 @@ async function cmdPull(argv) {
   }
   for (const rec of payload.inheritedRecipes) {
     const from = safeName(rec.folderSlug ?? "inherited", "inherited");
-    await mkdir5(join12(out, "recipes", "_inherited", from), { recursive: true });
+    await mkdir6(join12(out, "recipes", "_inherited", from), { recursive: true });
     const path = join12(
       out,
       "recipes",
@@ -6446,7 +6765,7 @@ async function cmdPull(argv) {
   const members = [];
   for (const v of payload.voses) {
     const dir = join12(out, "members", safeName(v.slug || v.title, v.id));
-    await mkdir5(dir, { recursive: true });
+    await mkdir6(dir, { recursive: true });
     const cfg = await apiJson(origin, `/api/vos/${v.id}/config`, { key });
     if (cfg.status !== 200) {
       lines.push(`skipped ${v.title}: ${apiError("fetch config", cfg)}`);
@@ -6996,7 +7315,7 @@ async function pushTakeClaimable(dir, flags, r) {
 
 // src/plugin/program.ts
 import { existsSync as existsSync13 } from "fs";
-import { mkdir as mkdir6, readFile as readFile11 } from "fs/promises";
+import { mkdir as mkdir7, readFile as readFile11 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
 import { basename as basename3, dirname as dirname2, join as join14 } from "path";
 import {
@@ -7215,7 +7534,7 @@ async function cmdFetch(argv) {
     throw new Error(apiError(`fetch config for ${vosId}`, cfg));
   const slug = typeof vosMeta.slug === "string" && vosMeta.slug ? vosMeta.slug : vosId;
   const out = strFlag(flags, "out") ?? safePathName(slug, vosId);
-  await mkdir6(out, { recursive: true });
+  await mkdir7(out, { recursive: true });
   await writeFileSafe(
     join14(out, "config.json"),
     JSON.stringify(cfg.body.config, null, 2)
@@ -10869,13 +11188,13 @@ function parseLlmsTxt(text) {
   const h1 = /^#\s+(.+)$/m.exec(text)?.[1]?.trim() ?? null;
   const block = /^>\s*.+(?:\n>\s*.*)*/m.exec(text)?.[0];
   const joined = block ? block.split("\n").map((line) => line.replace(/^>\s*/, "").trim()).filter(Boolean).join(" ") : "";
-  const quote = joined ? /^(.*?[.!?])(?:\s|$)/.exec(joined)?.[1] ?? joined : null;
+  const quote2 = joined ? /^(.*?[.!?])(?:\s|$)/.exec(joined)?.[1] ?? joined : null;
   let name = h1;
   if (h1) {
     const split = /^(.+?)\s+[—–-]\s+(.+)$/.exec(h1);
     if (split) name = split[1].trim();
   }
-  return { name, claim: quote ?? (h1 && h1 !== name ? h1 : null) };
+  return { name, claim: quote2 ?? (h1 && h1 !== name ? h1 : null) };
 }
 var WITNESS_IN_PAGE = `(() => {
   const cs = (el) => el ? getComputedStyle(el) : null
@@ -11236,7 +11555,7 @@ async function recordHosted(input) {
 }
 
 // src/plugin/run.ts
-import { urlSchemeProblem } from "@vosjs/render-core/record";
+import { urlSchemeProblem as urlSchemeProblem2 } from "@vosjs/render-core/record";
 
 // src/plugin/agentBrowser.ts
 import { writeFile as writeFile9 } from "fs/promises";
@@ -11286,18 +11605,18 @@ function parseAgentBrowserLog(text) {
 function splitCommand(command) {
   const out = [];
   let cur = "";
-  let quote = null;
+  let quote2 = null;
   let has = false;
   for (let i = 0; i < command.length; i++) {
     const c = command[i];
-    if (quote) {
-      if (c === quote) quote = null;
+    if (quote2) {
+      if (c === quote2) quote2 = null;
       else if (c === "\\" && i + 1 < command.length) cur += command[++i];
       else cur += c;
       continue;
     }
     if (c === '"' || c === "'") {
-      quote = c;
+      quote2 = c;
       has = true;
       continue;
     }
@@ -11341,8 +11660,8 @@ var quoteAttr = (s) => `"${s.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
 function hrefSelector(href) {
   try {
     const u = new URL(href);
-    const relative4 = `${u.pathname}${u.search}${u.hash}`;
-    return `a[href=${quoteAttr(relative4)}], a[href=${quoteAttr(href)}]`;
+    const relative6 = `${u.pathname}${u.search}${u.hash}`;
+    return `a[href=${quoteAttr(relative6)}], a[href=${quoteAttr(href)}]`;
   } catch {
     return `a[href=${quoteAttr(href)}]`;
   }
@@ -11719,8 +12038,8 @@ async function cmdActions(argv) {
     if (!m) throw new UsageError("--viewport expects WxH, e.g. 1280x720");
     viewport = { width: Number(m[1]), height: Number(m[2]) };
   }
-  const { readFile: readFile14 } = await import("fs/promises");
-  const text = await readFile14(resolve12(input), "utf8");
+  const { readFile: readFile16 } = await import("fs/promises");
+  const text = await readFile16(resolve12(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -11757,9 +12076,9 @@ function summary2(result) {
 }
 async function cmdActionsScript(input, flags) {
   const r = createReporter(flags.json === true);
-  const { readFile: readFile14 } = await import("fs/promises");
-  const { shotList, formatShotList } = await import("./shotList-MAQVLZBY.js");
-  const raw = JSON.parse(await readFile14(resolve12(input), "utf8"));
+  const { readFile: readFile16 } = await import("fs/promises");
+  const { shotList, formatShotList } = await import("./shotList-SCA234OS.js");
+  const raw = JSON.parse(await readFile16(resolve12(input), "utf8"));
   const errors = validateActions(raw);
   if (errors.length) throw new UsageError(`${input}:
   ${errors.join("\n  ")}`);
@@ -11770,7 +12089,7 @@ async function cmdActionsScript(input, flags) {
 
 // src/plugin/ingest.ts
 import { existsSync as existsSync20 } from "fs";
-import { copyFile, mkdir as mkdir7, readFile as readFile12, stat as stat2 } from "fs/promises";
+import { copyFile, mkdir as mkdir8, readFile as readFile12, stat as stat2 } from "fs/promises";
 import { basename as basename9, join as join22, resolve as resolve13 } from "path";
 
 // src/plugin/traceInflate.ts
@@ -11872,7 +12191,11 @@ async function copyRecording(src, dest, ext) {
     target
   });
   try {
-    const conversion = await Conversion.init({ input, output });
+    const conversion = await Conversion.init({
+      input,
+      output,
+      showWarnings: false
+    });
     if (!conversion.isValid || conversion.discardedTracks.length > 0) {
       await conversion.cancel?.();
       await copyFile(src, dest);
@@ -11958,7 +12281,7 @@ async function cmdIngest(argv) {
       `note: re-ingesting into ${outDir}; kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? `; apply the previous cut with: vos plan ${outDir} --reuse` : "")
     );
   }
-  await mkdir7(outDir, { recursive: true });
+  await mkdir8(outDir, { recursive: true });
   const paths = await ensureTakeDir(outDir);
   const recording = join22(outDir, `recording.${probed.ext}`);
   r.log("copying the recording\u2026");
@@ -12024,115 +12347,2465 @@ async function cmdIngest(argv) {
   return EXIT_OK;
 }
 
-// src/plugin/machineCmd.ts
-import { spawnSync as spawnSync4 } from "child_process";
-import {
-  cpSync,
-  existsSync as existsSync22,
-  mkdirSync as mkdirSync6,
-  readFileSync as readFileSync11,
-  rmSync as rmSync3,
-  writeFileSync as writeFileSync6
-} from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join24 } from "path";
-import { chromium as chromium2 } from "playwright";
+// src/plugin/checkVideo.ts
+import { createRequire as createRequire2 } from "module";
+import { existsSync as existsSync21 } from "fs";
+import { mkdir as mkdir9, readFile as readFile13, stat as stat3, writeFile as writeFile10 } from "fs/promises";
+import { basename as basename10, dirname as dirname8, extname as extname4, join as join23, resolve as resolve14 } from "path";
+import { ALL_FORMATS as ALL_FORMATS2, FilePathSource as FilePathSource2, Input as Input2 } from "mediabunny";
 
-// src/plugin/machine.ts
-import { existsSync as existsSync21, readFileSync as readFileSync10, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
-import { dirname as dirname8, join as join23 } from "path";
-var AGENT_NAMES = [
-  "claude",
-  "cursor",
-  "codex",
-  "copilot"
-];
-var PROJECT_DIRS = {
-  claude: [".claude"],
-  cursor: [".cursor"],
-  codex: [".codex", ".agents"],
-  copilot: [".github/copilot"]
-};
-var HOME_DIRS = {
-  claude: [".claude"],
-  cursor: [".cursor"],
-  codex: [".codex", ".agents"],
-  copilot: [".copilot"]
-};
-function detectAgents(root, opts = {}) {
-  const exists = opts.exists ?? existsSync21;
+// src/plugin/videoChecks.ts
+var SCENE_CHANGE_AT = 0.12;
+var CELL_CHANGED_AT = 0.03;
+var SCENE_WINDOW = 5;
+var UNIFORM_BELOW = 2;
+var QUIET_BELOW_LUFS = -23;
+var LOUD_ABOVE_LUFS = -9;
+var SUB_BLOCK_SECONDS = 0.1;
+var SHORT_TERM_SECONDS = 3;
+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) {
   const out = [];
-  for (const agent of AGENT_NAMES) {
-    for (const rel of PROJECT_DIRS[agent]) {
-      const dir = join23(root, rel);
-      if (exists(dir)) out.push({ agent, dir, scope: "project" });
-    }
-    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join23(root, ".github", "copilot-instructions.md"))) {
-      out.push({
-        agent,
-        dir: join23(root, ".github", "copilot"),
-        scope: "project"
-      });
-    }
+  for (let i = 1; i < changes.length; i++) {
+    const c = changes[i];
+    if (c < Math.min(SCENE_CHANGE_AT, ISOLATED_CHANGE_AT)) continue;
+    if (i > 1 && changes[i - 1] > c) continue;
+    if (i + 1 < changes.length && changes[i + 1] >= c) continue;
+    const around = [i - 2, i - 1, i + 1, i + 2].filter((k) => k >= 1 && k < changes.length).map((k) => changes[k]).sort((a, b) => a - b);
+    const mid = around.length ? around.length % 2 ? around[(around.length - 1) / 2] : (around[around.length / 2 - 1] + around[around.length / 2]) / 2 : 0;
+    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;
+    if (!standsOut && !standsAlone) continue;
+    out.push({
+      time: times[i],
+      change: Math.round(c * 1e4) / 1e4,
+      ...coverage ? { coverage: Math.round(share * 1e3) / 1e3 } : {}
+    });
   }
-  if (opts.global && opts.home) {
-    for (const agent of AGENT_NAMES) {
-      for (const rel of HOME_DIRS[agent]) {
-        const dir = join23(opts.home, rel);
-        if (exists(dir)) out.push({ agent, dir, scope: "global" });
-      }
-    }
+  return out;
+}
+function windowCounts(cuts, duration, window2 = SCENE_WINDOW) {
+  const n = Math.max(1, Math.ceil(duration / window2 - 1e-9));
+  const out = Array.from({ length: n }, (_, k) => ({
+    start: k * window2,
+    count: 0
+  }));
+  for (const c of cuts) {
+    const k = Math.min(n - 1, Math.max(0, Math.floor(c.time / window2)));
+    out[k].count++;
   }
   return out;
 }
-function agentsFromFlag(value, root) {
-  const wanted = value.trim() === "all" ? [...AGENT_NAMES] : value.split(",").map((s) => s.trim()).filter(Boolean);
-  const bad = wanted.filter((w) => !AGENT_NAMES.includes(w));
-  if (bad.length)
+function crowdedRuns(cuts, window2 = SCENE_WINDOW) {
+  const runs = [];
+  let run2 = [];
+  for (const c of cuts) {
+    if (run2.length && c.time - run2[run2.length - 1].time < window2) run2.push(c);
+    else {
+      if (run2.length > 1) runs.push(run2);
+      run2 = [c];
+    }
+  }
+  if (run2.length > 1) runs.push(run2);
+  return runs;
+}
+function createLoudnessMeter(sampleRate, channelCount, subBlockSeconds) {
+  const shelf = (() => {
+    const f0 = 1681.974450955533;
+    const G = 3.999843853973347;
+    const Q = 0.7071752369554196;
+    const K = Math.tan(Math.PI * f0 / sampleRate);
+    const Vh = Math.pow(10, G / 20);
+    const Vb = Math.pow(Vh, 0.4996667741545416);
+    const a0 = 1 + K / Q + K * K;
     return {
-      error: `--agent takes ${AGENT_NAMES.join(", ")} or all, not "${bad.join(", ")}"`
+      b0: (Vh + Vb * K / Q + K * K) / a0,
+      b1: 2 * (K * K - Vh) / a0,
+      b2: (Vh - Vb * K / Q + K * K) / a0,
+      a1: 2 * (K * K - 1) / a0,
+      a2: (1 - K / Q + K * K) / a0
     };
-  if (!wanted.length) return { error: "--agent expects a name" };
+  })();
+  const highpass = (() => {
+    const f0 = 38.13547087602444;
+    const Q = 0.5003270373238773;
+    const K = Math.tan(Math.PI * f0 / sampleRate);
+    const a0 = 1 + K / Q + K * K;
+    return {
+      b0: 1,
+      b1: -2,
+      b2: 1,
+      a1: 2 * (K * K - 1) / a0,
+      a2: (1 - K / Q + K * K) / a0
+    };
+  })();
+  const per = Math.max(1, Math.round(sampleRate * subBlockSeconds));
+  const state = Array.from({ length: channelCount }, () => ({
+    // Direct form I history for each stage.
+    x1: 0,
+    x2: 0,
+    y1: 0,
+    y2: 0,
+    u1: 0,
+    u2: 0,
+    w1: 0,
+    w2: 0,
+    sum: 0,
+    count: 0,
+    energies: []
+  }));
+  let peak = 0;
+  let samples = 0;
   return {
-    homes: wanted.map((agent) => ({
-      agent,
-      dir: join23(root, PROJECT_DIRS[agent][0]),
-      scope: "project"
-    }))
+    push(channels) {
+      for (let c = 0; c < channelCount; c++) {
+        const data = channels[c];
+        const s = state[c];
+        if (!data) continue;
+        for (let i = 0; i < data.length; i++) {
+          const x = data[i];
+          const ax = x < 0 ? -x : x;
+          if (ax > peak) peak = ax;
+          const y = shelf.b0 * x + shelf.b1 * s.x1 + shelf.b2 * s.x2 - shelf.a1 * s.y1 - shelf.a2 * s.y2;
+          s.x2 = s.x1;
+          s.x1 = x;
+          s.y2 = s.y1;
+          s.y1 = y;
+          const w = highpass.b0 * y + highpass.b1 * s.u1 + highpass.b2 * s.u2 - highpass.a1 * s.w1 - highpass.a2 * s.w2;
+          s.u2 = s.u1;
+          s.u1 = y;
+          s.w2 = s.w1;
+          s.w1 = w;
+          s.sum += w * w;
+          s.count++;
+          if (s.count === per) {
+            s.energies.push(s.sum / per);
+            s.sum = 0;
+            s.count = 0;
+          }
+        }
+        if (c === 0) samples += data.length;
+      }
+    },
+    finish() {
+      return {
+        energies: state.map(
+          (s) => s.count > 0 ? [...s.energies, s.sum / s.count] : s.energies
+        ),
+        peak,
+        samples
+      };
+    }
   };
 }
-function skillsDirFor(home) {
-  return join23(home.dir, "skills");
-}
-function fallbackSkillsHome(root) {
-  return { agent: "codex", dir: join23(root, ".agents"), scope: "project" };
+function channelWeights(count) {
+  if (count === 6) return [1, 1, 1, 0, 1.41, 1.41];
+  return Array.from({ length: count }, (_, i) => i < 3 ? 1 : 1.41);
 }
-function installedSkills(dir, exists = existsSync21, list = (p) => {
-  try {
-    return readdirSync5(p);
-  } catch {
-    return [];
+var LOUDNESS_OFFSET = -0.691;
+var toLufs = (power) => power > 0 ? LOUDNESS_OFFSET + 10 * Math.log10(power) : null;
+function windowPower(energies, weights, from, count) {
+  let total = 0;
+  for (let c = 0; c < energies.length; c++) {
+    const e = energies[c];
+    let sum = 0;
+    let n = 0;
+    for (let k = from; k < from + count && k < e.length; k++) {
+      sum += e[k];
+      n++;
+    }
+    if (n) total += (weights[c] ?? 1) * (sum / n);
+  }
+  return total;
+}
+var round1 = (n) => n === null ? null : Math.round(n * 10) / 10;
+function loudnessFromEnergies(energies, peak, subBlock = SUB_BLOCK_SECONDS) {
+  const weights = channelWeights(energies.length);
+  const pieces = Math.max(0, ...energies.map((e) => e.length));
+  const blockLen = Math.max(1, Math.round(0.4 / subBlock));
+  const blocks = [];
+  for (let k = 0; k + blockLen <= pieces; k++)
+    blocks.push(windowPower(energies, weights, k, blockLen));
+  if (!blocks.length && pieces > 0)
+    blocks.push(windowPower(energies, weights, 0, pieces));
+  const mean = (xs) => xs.length ? xs.reduce((a, b) => a + b, 0) / xs.length : 0;
+  const loud = (p) => toLufs(p) ?? -Infinity;
+  const absolute2 = blocks.filter((p) => loud(p) > -70);
+  let integrated = null;
+  if (absolute2.length) {
+    const gate = loud(mean(absolute2)) - 10;
+    const relative6 = absolute2.filter((p) => loud(p) > gate);
+    integrated = toLufs(mean(relative6));
+  }
+  const stLen = Math.max(1, Math.round(SHORT_TERM_SECONDS / subBlock));
+  const shortTerm = [];
+  for (let k = 0; k < pieces; k += stLen) {
+    if (pieces - k < blockLen && k > 0) break;
+    shortTerm.push({
+      time: Math.round(k * subBlock * 100) / 100,
+      loudness: round1(toLufs(windowPower(energies, weights, k, stLen)))
+    });
   }
-}) {
-  if (!exists(dir)) return [];
-  return list(dir).filter((name) => exists(join23(dir, name, "SKILL.md"))).sort();
+  const st = shortTerm.map((s) => s.loudness).filter((l) => l !== null);
+  return {
+    unit: "LUFS",
+    integrated: round1(integrated),
+    shortTerm,
+    maxShortTerm: st.length ? Math.max(...st) : null,
+    samplePeakDb: peak > 0 ? round1(20 * Math.log10(peak)) : null
+  };
 }
-var RULES_BEGIN = "<!-- vos:begin (written by vos setup; the block is replaced on the next run) -->";
-var RULES_END = "<!-- vos:end -->";
-var RULES_BODY = `## Product videos (vosso)
-- Skill: product-video (npx skills add vosjs/skills) records the real product from actions.json
-- Look before you cut: vos frames take --at-zooms; edit take/doc.json and re-render, never re-record
-- Hand back: vos open take serves the take into the studio at vos.so, doc.json intact
-- Local by default: vos push only when asked for a link, the shelf or a cloud render
-- Deleting: vos delete moves a vos to Trash and vos restore brings it back; if you deleted by mistake, restore it and say so. Only the person can delete forever, at vos.so/app/trash
-- Credentials: VOS_API_KEY, then ~/.config/vos/credentials, then vos login; never print one
-- Reference: https://vos.so/llms-full.txt`;
-var RULES_BLOCK = `${RULES_BEGIN}
-${RULES_BODY}
-${RULES_END}`;
-function applyRulesBlock(existing) {
-  const current = existing ?? "";
-  const begin = current.indexOf(RULES_BEGIN);
+function loudnessWarnings(l) {
+  if (l.integrated === null)
+    return [
+      "the sound is silent: no 400 ms block reaches -70 LUFS, the floor loudness is measured from"
+    ];
+  if (l.integrated < QUIET_BELOW_LUFS)
+    return [
+      `integrated loudness ${l.integrated} LUFS is below ${QUIET_BELOW_LUFS}: too quiet for a social feed, where a viewer turns sound up once and keeps it`
+    ];
+  if (l.integrated > LOUD_ABOVE_LUFS)
+    return [
+      `integrated loudness ${l.integrated} LUFS is above ${LOUD_ABOVE_LUFS}: too loud, a platform turns it down and a peak may clip`
+    ];
+  return [];
+}
+function sceneWarnings(cuts) {
+  return crowdedRuns(cuts).map(
+    (run2) => `${run2.length} full-frame changes within ${SCENE_WINDOW} s (at ${run2.map((c) => `${c.time.toFixed(2)}s`).join(", ")}): more than one cut in ${SCENE_WINDOW} s is hard to follow`
+  );
+}
+function posterWarning(which, deviation) {
+  if (deviation >= UNIFORM_BELOW) return null;
+  return which === "first" ? `the first frame is near-uniform (deviation ${deviation.toFixed(2)} of 255): the video opens on an empty or faded frame, which is what a feed shows before it plays` : `the last frame is near-uniform (deviation ${deviation.toFixed(2)} of 255): the video ends on an empty or faded frame, which is what a player rests on`;
+}
+
+// src/plugin/checkVideo.ts
+var BOOLEAN_FLAGS11 = /* @__PURE__ */ new Set(["json", "help", "strict"]);
+var THUMB_LONG_SIDE = 64;
+async function probeVideoFacts(file) {
+  const input = new Input2({
+    source: new FilePathSource2(file),
+    formats: ALL_FORMATS2
+  });
+  try {
+    const video = await input.getPrimaryVideoTrack();
+    if (!video) throw new UsageError(`${file} has no video track`);
+    const [format, duration, stats, audio, bytes] = await Promise.all([
+      input.getFormat(),
+      input.computeDuration(),
+      video.computePacketStats(240),
+      input.getPrimaryAudioTrack(),
+      stat3(file).then((s) => s.size)
+    ]);
+    return {
+      file,
+      bytes,
+      duration: Math.round(duration * 1e3) / 1e3,
+      width: video.displayWidth,
+      height: video.displayHeight,
+      fps: Math.round(stats.averagePacketRate * 100) / 100,
+      container: format.mimeType,
+      video: {
+        codec: video.codec,
+        codecString: await video.getCodecParameterString()
+      },
+      audio: audio ? {
+        codec: audio.codec,
+        codecString: await audio.getCodecParameterString(),
+        sampleRate: audio.sampleRate,
+        channels: audio.numberOfChannels
+      } : null
+    };
+  } finally {
+    input.dispose();
+  }
+}
+async function mediabunnyBundle() {
+  const entry = createRequire2(import.meta.url).resolve("mediabunny");
+  const bundle = join23(dirname8(entry), "mediabunny.min.mjs");
+  if (existsSync21(bundle)) return readFile13(bundle, "utf8");
+  return readFile13(
+    join23(entry.split("/dist/")[0], "dist/bundles/mediabunny.min.mjs"),
+    "utf8"
+  );
+}
+async function decodeInPage(opts) {
+  const w = window;
+  try {
+    const load = new Function("u", "return import(u)");
+    const MB = await load(
+      URL.createObjectURL(new Blob([opts.mbCode], { type: "text/javascript" }))
+    );
+    const input = new MB.Input({
+      source: new MB.UrlSource(opts.videoUrl),
+      formats: MB.ALL_FORMATS
+    });
+    const track = await input.getPrimaryVideoTrack();
+    if (!track) throw new Error("no video track");
+    if (!await track.canDecode())
+      throw new Error(`this browser cannot decode ${String(track.codec)}`);
+    const pixels = (canvas) => {
+      const g = canvas.getContext("2d", {
+        willReadFrequently: true
+      });
+      const px = g.getImageData(0, 0, canvas.width, canvas.height).data;
+      const out = new Array(px.length / 4 * 3);
+      for (let p = 0, q = 0; p < px.length; p += 4, q += 3) {
+        out[q] = px[p];
+        out[q + 1] = px[p + 1];
+        out[q + 2] = px[p + 2];
+      }
+      return out;
+    };
+    const deviation = (a) => {
+      let total = 0;
+      for (let c = 0; c < 3; c++) {
+        let s = 0;
+        let n = 0;
+        for (let i = c; i < a.length; i += 3) {
+          s += a[i];
+          n++;
+        }
+        const m = s / Math.max(1, n);
+        let q = 0;
+        for (let i = c; i < a.length; i += 3) q += (a[i] - m) * (a[i] - m);
+        total += Math.sqrt(q / Math.max(1, n));
+      }
+      return total / 3;
+    };
+    const difference = (a, b) => {
+      let s = 0;
+      for (let i = 0; i < a.length; i++) s += Math.abs(a[i] - b[i]);
+      return s / Math.max(1, a.length) / 255;
+    };
+    const coverageOf = (a, b) => {
+      const W = opts.thumbW;
+      const H = opts.thumbH;
+      let cells = 0;
+      let changed = 0;
+      for (let cy = 0; cy < H; cy += 4)
+        for (let cx = 0; cx < W; cx += 4) {
+          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++) {
+              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;
+            }
+          cells++;
+          if (s / Math.max(1, n) / 255 >= opts.cellChanged) changed++;
+        }
+      return changed / Math.max(1, cells);
+    };
+    const small = document.createElement("canvas");
+    small.width = opts.thumbW;
+    small.height = opts.thumbH;
+    const sctx = small.getContext("2d", { willReadFrequently: true });
+    sctx.imageSmoothingEnabled = true;
+    sctx.imageSmoothingQuality = "high";
+    const samples = new MB.VideoSampleSink(track);
+    const step = 1 / opts.sampleFps;
+    const times = [];
+    const changes = [];
+    const coverage = [];
+    let next = -Infinity;
+    let prev = null;
+    let first = null;
+    let firstTime = 0;
+    let lastTime = 0;
+    let lastKept = -1;
+    let lastGray = null;
+    let tail = null;
+    const duration = await input.computeDuration();
+    for await (const sample2 of samples.samples()) {
+      const t = sample2.timestamp;
+      sctx.clearRect(0, 0, opts.thumbW, opts.thumbH);
+      sample2.draw(sctx, 0, 0, opts.thumbW, opts.thumbH);
+      sample2.close();
+      lastTime = t;
+      if (t + step / 2 < next) {
+        tail = pixels(small);
+        continue;
+      }
+      tail = null;
+      const g = pixels(small);
+      if (!first) {
+        first = g;
+        firstTime = t;
+      }
+      times.push(t);
+      changes.push(prev ? difference(prev, g) : 0);
+      coverage.push(prev ? coverageOf(prev, g) : 0);
+      prev = g;
+      lastKept = t;
+      lastGray = g;
+      next = next === -Infinity ? t + step : next + step;
+      if (next <= t) next = t + step;
+      w.__progress = duration > 0 ? Math.min(0.9, t / duration * 0.9) : 0;
+    }
+    if (!first || !lastGray) throw new Error("no video frame decoded");
+    if (tail && lastTime > lastKept) {
+      times.push(lastTime);
+      changes.push(prev ? difference(prev, tail) : 0);
+      coverage.push(prev ? coverageOf(prev, tail) : 0);
+      lastGray = tail;
+    }
+    const toBase64 = (bytes) => {
+      let s = "";
+      for (let i = 0; i < bytes.length; i += 32768)
+        s += String.fromCharCode(...bytes.subarray(i, i + 32768));
+      return btoa(s);
+    };
+    const full = new MB.CanvasSink(track);
+    const png = async (t) => {
+      const wc = await full.getCanvas(t);
+      if (!wc) return "";
+      const c = wc.canvas;
+      const blob = "convertToBlob" in c ? await c.convertToBlob({ type: "image/png" }) : await new Promise(
+        (res, rej) => c.toBlob(
+          (b) => b ? res(b) : rej(new Error("toBlob failed")),
+          "image/png"
+        )
+      );
+      return toBase64(new Uint8Array(await blob.arrayBuffer()));
+    };
+    const firstPng = await png(firstTime);
+    const lastPng = await png(lastTime);
+    let audio = null;
+    const at2 = await input.getPrimaryAudioTrack();
+    if (at2 && await at2.canDecode()) {
+      const make = new Function(`return (${opts.meterSrc})`)();
+      const meter = make(at2.sampleRate, at2.numberOfChannels, opts.subBlock);
+      const sink = new MB.AudioBufferSink(at2);
+      for await (const wb of sink.buffers()) {
+        const b = wb.buffer;
+        const chans = [];
+        for (let c = 0; c < at2.numberOfChannels; c++)
+          chans.push(
+            c < b.numberOfChannels ? b.getChannelData(c) : new Float32Array(0)
+          );
+        meter.push(chans);
+      }
+      audio = {
+        sampleRate: at2.sampleRate,
+        channels: at2.numberOfChannels,
+        ...meter.finish()
+      };
+    }
+    input.dispose();
+    w.__done = {
+      times,
+      changes,
+      coverage,
+      firstDeviation: deviation(first),
+      lastDeviation: deviation(lastGray),
+      firstTime,
+      lastTime,
+      firstPng,
+      lastPng,
+      audio
+    };
+  } catch (e) {
+    w.__error = String(e instanceof Error && e.stack || e);
+  }
+}
+async function checkVideo(browser, file, outDir) {
+  const facts = await probeVideoFacts(file);
+  const ceiling = facts.duration > 120 ? 10 : 30;
+  const sampleFps = Math.max(
+    Math.min(10, facts.fps || 10),
+    Math.min(facts.fps || 30, ceiling)
+  );
+  const long = Math.max(facts.width, facts.height, 1);
+  const side = (n) => Math.max(1, Math.round(n / long * THUMB_LONG_SIDE));
+  const server = await startTakeServer(dirname8(resolve14(file)), {
+    "/check.html": '<!doctype html><html><head><meta charset="utf-8"><link rel="icon" href="data:,"></head><body></body></html>'
+  });
+  const page = await browser.newPage();
+  let done;
+  try {
+    await page.addInitScript(() => {
+      ;
+      globalThis.__name = (f) => f;
+    });
+    await page.goto(`${server.base}/check.html`);
+    void page.evaluate(decodeInPage, {
+      mbCode: await mediabunnyBundle(),
+      meterSrc: String(createLoudnessMeter),
+      videoUrl: `/${encodeURIComponent(basename10(file))}`,
+      sampleFps,
+      thumbW: side(facts.width),
+      thumbH: side(facts.height),
+      subBlock: SUB_BLOCK_SECONDS,
+      cellChanged: CELL_CHANGED_AT
+    }).catch(() => {
+    });
+    done = await waitForPageDone(
+      page,
+      "check-video",
+      () => {
+      },
+      12e4 + facts.duration * 4e3
+    );
+  } finally {
+    await page.close();
+    server.close();
+  }
+  await mkdir9(outDir, { recursive: true });
+  const firstFile = join23(outDir, "first.png");
+  const lastFile = join23(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 loudness = done.audio ? loudnessFromEnergies(done.audio.energies, done.audio.peak) : null;
+  const round2 = (n) => Math.round(n * 100) / 100;
+  const posters = {
+    first: {
+      file: firstFile,
+      time: round2(done.firstTime),
+      deviation: round2(done.firstDeviation),
+      uniform: posterWarning("first", done.firstDeviation) !== null
+    },
+    last: {
+      file: lastFile,
+      time: round2(done.lastTime),
+      deviation: round2(done.lastDeviation),
+      uniform: posterWarning("last", done.lastDeviation) !== null
+    }
+  };
+  const warnings = [
+    ...sceneWarnings(changes),
+    ...loudness ? loudnessWarnings(loudness) : [],
+    ...[
+      posterWarning("first", done.firstDeviation),
+      posterWarning("last", done.lastDeviation)
+    ].filter((w) => w !== null)
+  ];
+  const result = {
+    ...facts,
+    scenes: {
+      sampleFps: round2(sampleFps),
+      threshold: SCENE_CHANGE_AT,
+      isolatedThreshold: ISOLATED_CHANGE_AT,
+      window: SCENE_WINDOW,
+      changes: changes.map((c) => ({ ...c, time: round2(c.time) })),
+      perWindow: windowCounts(changes, facts.duration)
+    },
+    loudness,
+    posters,
+    warnings,
+    outDir
+  };
+  await writeFile10(
+    join23(outDir, "check.json"),
+    `${JSON.stringify(result, null, 2)}
+`
+  );
+  return result;
+}
+var mb = (n) => n >= 1024 * 1024 ? `${(n / 1024 / 1024).toFixed(1)} MB` : `${Math.max(1, Math.round(n / 1024))} KB`;
+function checkVideoLines(r) {
+  const codecs = [
+    r.video.codecString ?? r.video.codec ?? "unknown",
+    ...r.audio ? [r.audio.codecString ?? r.audio.codec ?? "unknown"] : []
+  ].join(" + ");
+  const cuts = r.scenes.changes;
+  const l = r.loudness;
+  const st = l?.shortTerm.map(
+    (s) => s.loudness === null ? "-" : String(s.loudness)
+  );
+  return [
+    `Checked ${r.file}: ${r.duration.toFixed(2)}s, ${r.width}x${r.height} @ ${r.fps} fps, ${mb(r.bytes)}, ${codecs}`,
+    `  scene changes: ${cuts.length}${cuts.length ? ` (${cuts.map((c) => `${c.time.toFixed(2)}s`).join(", ")})` : ""}; per ${r.scenes.window} s: ${r.scenes.perWindow.map((w) => w.count).join(", ")}`,
+    r.audio ? `  loudness: ${l?.integrated ?? "silent"}${l?.integrated !== null ? " LUFS" : ""} integrated; short-term every 3 s: ${st?.join(", ")}; sample peak ${l?.samplePeakDb ?? "-inf"} dBFS` : "  loudness: no audio track",
+    `  posters: ${r.posters.first.file} (deviation ${r.posters.first.deviation}), ${r.posters.last.file} (deviation ${r.posters.last.deviation})`,
+    `  ${r.warnings.length ? `${r.warnings.length} warning${r.warnings.length === 1 ? "" : "s"}` : "no warnings"}; ${join23(r.outDir, "check.json")}`
+  ].join("\n");
+}
+async function cmdCheckVideo(argv) {
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS11);
+  const file = positionals[0];
+  if (!file)
+    throw new UsageError(
+      "vos check-video <file.mp4|webm> [--out dir] [--strict] [--json]"
+    );
+  if (!existsSync21(file)) throw new UsageError(`${file} does not exist`);
+  const r = createReporter(flags.json === true);
+  const strict = flags.strict === true;
+  const outDir = resolve14(
+    strFlag(flags, "out") ?? join23(dirname8(file), `${basename10(file, extname4(file))}-check`)
+  );
+  const browser = await launchBrowser();
+  try {
+    r.event({ event: "phase", phase: "check-video" });
+    const result = await checkVideo(browser, file, outDir);
+    for (const w of result.warnings) r.warn(w);
+    r.done({ ...result }, checkVideoLines(result));
+    return result.warnings.length && strict ? EXIT_USAGE : EXIT_OK;
+  } finally {
+    await browser.close();
+  }
+}
+
+// src/plugin/join.ts
+import { existsSync as existsSync22, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
+import { copyFile as copyFile2, mkdir as mkdir10, rm as rm3 } from "fs/promises";
+import {
+  basename as basename11,
+  dirname as dirname9,
+  isAbsolute as isAbsolute3,
+  join as join24,
+  relative as relative4,
+  resolve as resolve15,
+  sep as sep2
+} from "path";
+import {
+  mediaKey as mediaKey2,
+  mediaRefId,
+  migrateMotion as migrateMotion3,
+  projectFromArtifact as projectFromArtifact2,
+  ratedSegments as ratedSegments8,
+  resolveAnchor as resolveAnchor5,
+  segmentOutputExtents as segmentOutputExtents3
+} from "@vosjs/studio-core";
+import { totalDuration as totalDuration2 } from "@vosjs/timeline";
+
+// src/plugin/stepCaptions.ts
+import {
+  docMediaList,
+  findStep as findStep2,
+  mediaKey,
+  ratedSegments as ratedSegments7,
+  resolveAnchor as resolveAnchor4,
+  segmentOutputExtents as segmentOutputExtents2
+} from "@vosjs/studio-core";
+import { totalDuration } from "@vosjs/timeline";
+var STEP_CAPTIONS_FROM = "steps";
+var STEP_CAPTION_OFFSET = 0.2;
+var CAPTION_MAX = 3;
+var CAPTION_MIN = 1.2;
+var CAPTION_GAP = 0.1;
+function captionOf(step, actions, script) {
+  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];
+    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) {
+  const report = { landed: [], skipped: [], uncaptioned: [] };
+  const kept = (doc.overlays ?? []).filter((o) => o.from !== STEP_CAPTIONS_FROM);
+  const rated = ratedSegments7(doc);
+  const footageEnd = totalDuration(rated);
+  const docSegments = doc.segments.length ? doc.segments : [{ in: 0, out: doc.source.meta.durationMs / 1e3 }];
+  const extents = segmentOutputExtents2(doc);
+  const clipEnd = (start, media) => {
+    for (let i = 0; i < extents.length; i++) {
+      const e = extents[i];
+      if (mediaKey(docSegments[i]?.media) === media && start >= e.start - 1e-6 && start < e.end - 1e-6)
+        return e.end;
+    }
+    return footageEnd;
+  };
+  const ends = /* @__PURE__ */ new Map();
+  const spoken = (media, step, steps) => kept.some((o) => {
+    if (o.kind !== "text" || o.preset !== "caption") return false;
+    if (o.anchor && mediaKey(o.anchor.media) === media)
+      return findStep2(steps, o.anchor.step) === step;
+    return media === "" && o.id === `${CAPTION_ID_PREFIX}${step.step}`;
+  });
+  const fresh = [];
+  const taken = new Set(kept.map((o) => o.id));
+  for (const { id: media, source } of docMediaList(doc)) {
+    const steps = source.meta.steps ?? [];
+    let captioned = 0;
+    for (const step of steps) {
+      const caption = captionOf(step, actions.get(media), source.script);
+      if (!caption) continue;
+      captioned++;
+      const ref = step.id ?? step.step;
+      const label = `step ${JSON.stringify(ref)}${media ? ` of ${media}` : ""}`;
+      if (step.skipped) {
+        report.skipped.push(`${label}: the recorder skipped it`);
+        continue;
+      }
+      if (spoken(media, step, steps)) {
+        report.skipped.push(`${label}: a caption is already anchored to it`);
+        continue;
+      }
+      const anchor = {
+        step: ref,
+        ...media ? { media } : {},
+        at: "end",
+        offset: STEP_CAPTION_OFFSET
+      };
+      const placed = resolveAnchor4(doc, anchor, rated);
+      if (placed.start === null) {
+        report.skipped.push(`${label}: the cut leaves it out`);
+        continue;
+      }
+      const end = clipEnd(placed.start, media);
+      if (placed.start >= end - CAPTION_MIN) {
+        report.skipped.push(`${label}: it plays in the last second of its clip`);
+        continue;
+      }
+      const base = `step-${media ? `${media}-` : ""}${safeId(ref)}`;
+      let id = base;
+      for (let n = 2; taken.has(id); n++) id = `${base}-${n}`;
+      taken.add(id);
+      const clip = {
+        ...houseCaption(id, caption, placed.start, CAPTION_MAX),
+        anchor,
+        from: STEP_CAPTIONS_FROM
+      };
+      ends.set(clip, end);
+      fresh.push(clip);
+      report.landed.push({
+        id,
+        step: ref,
+        ...media ? { media } : {},
+        start: placed.start
+      });
+    }
+    if (steps.length && !captioned) report.uncaptioned.push(media);
+  }
+  fresh.sort((a, b) => a.start - b.start);
+  fresh.forEach((c, i) => {
+    const next = fresh[i + 1];
+    const clipRoom = (ends.get(c) ?? footageEnd) - c.start;
+    const nextRoom = next ? next.start - CAPTION_GAP - c.start : Infinity;
+    c.duration = +Math.min(
+      CAPTION_MAX,
+      clipRoom,
+      Math.max(CAPTION_MIN, nextRoom)
+    ).toFixed(3);
+  });
+  const overlays = [...kept, ...fresh];
+  if (overlays.length) doc.overlays = overlays;
+  else delete doc.overlays;
+  return report;
+}
+function bareCaptionsFlag(argv) {
+  return argv.map(
+    (a, i) => a === "--captions" && (i + 1 >= argv.length || argv[i + 1].startsWith("--")) ? "--captions=steps" : a
+  );
+}
+
+// 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"
+  };
+  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 = ratedSegments8(doc);
+  const end = totalDuration2(pieces);
+  if (!(end > 0)) return [];
+  return (doc.overlays ?? []).filter((o) => {
+    const start = o.anchor ? resolveAnchor5(doc, o.anchor, pieces).start ?? o.start : o.start;
+    return 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"] : []
+  ].join(", ");
+  notes.push(
+    `${label}: dropped ${named}, which played after its footage and would land over the next input (only the last input's ending stays, at the end of the film)`
+  );
+}
+function segs0(d) {
+  return d.segments.length ? d.segments[0] : { in: 0, out: round32(d.source.meta.durationMs / 1e3) };
+}
+function joinDocs(parts) {
+  if (parts.length < 2)
+    throw new UsageError("vos join needs two inputs or more");
+  const [first, ...rest] = parts;
+  const doc = structuredClone(first.doc);
+  const notes = [];
+  dropEnding(doc, first.label, notes);
+  const copies = /* @__PURE__ */ new Map();
+  const copy = (c) => {
+    if (!copies.has(c.to)) copies.set(c.to, c);
+  };
+  const actions = /* @__PURE__ */ new Map([["", first.actions]]);
+  if (first.file) {
+    copy({
+      from: first.file.path,
+      to: takeRelativeFile(doc.source.videoKey),
+      remux: first.file.ext
+    });
+  } else {
+    const refs = [
+      ...isTakeRelativeKey(doc.source.videoKey) ? [{ where: "recording", key: doc.source.videoKey, set: () => {
+      } }] : [],
+      ...sourceSidecarRefs(doc),
+      ...docMediaRefs(doc)
+    ];
+    for (const ref of refs)
+      copy({
+        from: join24(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));
+  const allocate = () => {
+    let n = 1;
+    while (taken.has(`m${n}`)) n++;
+    taken.add(`m${n}`);
+    return `m${n}`;
+  };
+  const media = [...doc.media ?? []];
+  const joined = [];
+  const placed = [];
+  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 idMap = /* @__PURE__ */ new Map([["", pid]]);
+    for (const m of d.media ?? []) idMap.set(m.id, allocate());
+    const mapMedia = (k) => idMap.get(mediaKey2(k)) ?? pid;
+    joined.push({ label: part.label, id: pid });
+    actions.set(pid, part.actions);
+    if (part.file) {
+      const to = `${pid}/recording.${part.file.ext}`;
+      copy({ from: part.file.path, to, remux: part.file.ext });
+      d.source.videoKey = to;
+    } else {
+      const refs = [
+        ...isTakeRelativeKey(d.source.videoKey) ? [
+          {
+            where: "recording",
+            key: d.source.videoKey,
+            set: (next) => {
+              d.source.videoKey = next;
+            }
+          }
+        ] : [],
+        ...sourceSidecarRefs(d),
+        ...(d.media ?? []).flatMap(
+          (m) => [
+            ["videoKey", m.videoKey],
+            ["micKey", m.micKey],
+            ["camKey", m.camKey]
+          ].filter(([, k]) => isTakeRelativeKey(k)).map(([field, k]) => ({
+            where: `media ${m.id}`,
+            key: k,
+            set: (next) => {
+              ;
+              m[field] = next;
+            }
+          }))
+        ),
+        ...docOverlayRefs(d),
+        ...docObjectRefs(d)
+      ];
+      for (const ref of refs) {
+        const to = prefixed(pid, ref.key);
+        copy({
+          from: join24(part.dir, takeRelativeFile(ref.key)),
+          to,
+          base: part.dir
+        });
+        ref.set(to);
+      }
+    }
+    media.push({
+      ...d.source,
+      id: pid,
+      ...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 at2 = doc.segments.length;
+    doc.segments.push(...segs.map((s) => ({ ...s, media: mapMedia(s.media) })));
+    const ns = (id) => `${pid}-${id}`;
+    const tag = (s) => ({
+      ...s,
+      id: ns(s.id),
+      media: mapMedia(s.media)
+    });
+    doc.zoom = [...doc.zoom, ...d.zoom.map(tag)];
+    if (d.speed?.length) doc.speed = [...doc.speed ?? [], ...d.speed.map(tag)];
+    if (d.tilt?.length) doc.tilt = [...doc.tilt ?? [], ...d.tilt.map(tag)];
+    if (d.camMotion?.length)
+      doc.camMotion = [...doc.camMotion ?? [], ...d.camMotion.map(tag)];
+    if (d.freeze?.length)
+      doc.freeze = [...doc.freeze ?? [], ...d.freeze.map(tag)];
+    if (d.rejected?.length)
+      doc.rejected = [...doc.rejected ?? [], ...d.rejected.map(tag)];
+    if (d.audio.length)
+      notes.push(
+        `${part.label}: its ${d.audio.length} sound clip${d.audio.length === 1 ? "" : "s"} stay behind (the film's sound is the first input's; add a score with vos score)`
+      );
+    placed.push({ part, d, pid, firstSegment: at2, mapMedia });
+  }
+  if (media.length) doc.media = media;
+  const extents = segmentOutputExtents3(doc);
+  for (const { part, d, pid, firstSegment, mapMedia } of placed) {
+    const offset = extents[firstSegment]?.start ?? 0;
+    const ownPieces = ratedSegments8(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);
+        if (ref !== null) next.key = `media:${mapMedia(ref)}`;
+      }
+      if (o.anchor) {
+        next.anchor = { ...o.anchor, media: mapMedia(o.anchor.media) };
+      } else if (o.pin?.step !== void 0) {
+        const r = resolveAnchor5(d, { step: o.pin.step }, ownPieces);
+        if (r.start !== null) {
+          next.anchor = {
+            step: o.pin.step,
+            media: pid,
+            offset: round32(o.start - r.start)
+          };
+        } else {
+          next.start = round32(o.start + offset);
+        }
+        delete next.pin;
+        dropped++;
+      } else {
+        if (o.pin) {
+          delete next.pin;
+          dropped++;
+        }
+        next.start = round32(o.start + offset);
+      }
+      ;
+      (doc.overlays ??= []).push(next);
+    }
+    if (dropped)
+      notes.push(
+        `${part.label}: ${dropped} pinned layer${dropped === 1 ? "" : "s"} kept ${dropped === 1 ? "its" : "their"} time and lost the pin (a pin places a layer on the first input's footage only)`
+      );
+    if (part.file?.hasAudio) {
+      const seg = segs0(d);
+      const at2 = extents[firstSegment];
+      if (part.mute) {
+        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 id = `${pid}-sound`;
+        doc.audio = [
+          ...doc.audio,
+          {
+            id,
+            key: d.source.videoKey,
+            name: basename11(part.file.path),
+            start: round32(at2.start),
+            in: round32(seg.in),
+            out: round32(seg.out),
+            duration: round32(d.source.meta.durationMs / 1e3),
+            gain: 1,
+            fadeIn: fade,
+            fadeOut: fade
+          }
+        ];
+        notes.push(
+          `${part.label}: its own sound plays as audio clip ${id}, ${at2.start.toFixed(2)}..${(at2.start + len).toFixed(2)}s (--mute ${part.label} to leave it out)`
+        );
+      }
+    }
+    for (const ob of d.objects ?? []) {
+      ;
+      (doc.objects ??= []).push({
+        ...ob,
+        id: ns(ob.id),
+        ...ob.span ? { span: { ...ob.span, start: round32(ob.span.start + offset) } } : {}
+      });
+    }
+  }
+  for (const part of rest)
+    if (part.mute && !part.file?.hasAudio)
+      notes.push(
+        `${part.label}: --mute leaves nothing out (${part.file ? "the file carries no sound" : "a take's own footage sound is its recording's; its added sound stays behind anyway"})`
+      );
+  if (first.mute)
+    notes.push(
+      `${first.label}: --mute leaves nothing out (the first input's sound is the film's own)`
+    );
+  const pieces = ratedSegments8(doc);
+  for (const o of doc.overlays ?? []) {
+    if (!o.anchor) continue;
+    const r = resolveAnchor5(doc, o.anchor, pieces);
+    if (r.start !== null) o.start = r.start;
+  }
+  return { doc, copies: [...copies.values()], media: joined, actions, notes };
+}
+var BOOLEAN_FLAGS12 = /* @__PURE__ */ new Set(["json", "help", "force", "captions"]);
+var MULTI = /* @__PURE__ */ new Set(["mute"]);
+var USAGE2 = "vos join <take> <take|file.mp4>\u2026 --out <dir> [--force] [--captions] [--mute <file>]... [--json]";
+var within = (inner, outer) => {
+  const rel = relative4(outer, inner);
+  return rel === "" || !rel.startsWith(`..${sep2}`) && rel !== ".." && !isAbsolute3(rel);
+};
+async function readPart(arg) {
+  const path = resolve15(arg);
+  if (!existsSync22(path)) throw new UsageError(`${arg}: no such take or file`);
+  if (statSync7(path).isDirectory()) {
+    if (!existsSync22(join24(path, "meta.json")))
+      throw new UsageError(
+        `${arg}: not a take directory (no meta.json); a video file is joined by its path`
+      );
+    const take = await loadTake(path);
+    const doc2 = take.doc ?? projectFromArtifact2(
+      {
+        videoKey: take.paths.recordingName,
+        cursor: take.cursor,
+        meta: take.meta
+      },
+      take.paths.recordingName
+    ).doc;
+    return { label: arg, kind: "take", doc: doc2, dir: path, actions: take.actions };
+  }
+  const probed = await probeVideoFile(path);
+  if (!(probed.durationMs > 0))
+    throw new UsageError(`${arg}: the file reports no duration`);
+  const doc = fileDoc(
+    `recording.${probed.ext}`,
+    probed,
+    Math.round(statSync7(path).mtimeMs)
+  );
+  return {
+    label: arg,
+    kind: "file",
+    doc,
+    dir: dirname9(path),
+    actions: null,
+    file: { path, ext: probed.ext, hasAudio: probed.hasAudio }
+  };
+}
+async function cmdJoin(argv) {
+  const { positionals, flags, multi } = parseArgs(argv, BOOLEAN_FLAGS12, MULTI);
+  const r = createReporter(flags.json === true);
+  const outArg = strFlag(flags, "out");
+  const force = flags.force === true;
+  const withCaptions = flags.captions === true;
+  if (positionals.length < 2 || !outArg) throw new UsageError(USAGE2);
+  const out = resolve15(outArg);
+  const inputs = positionals.map((p) => resolve15(p));
+  const muted = /* @__PURE__ */ new Set();
+  for (const m of multi.mute ?? []) {
+    const i = inputs.indexOf(resolve15(m));
+    if (i < 0)
+      throw new UsageError(
+        `--mute ${m}: not one of the inputs; name a file as it is given to vos join`
+      );
+    muted.add(i);
+  }
+  for (const [i, input] of inputs.entries()) {
+    if (within(out, input) || within(input, out))
+      throw new UsageError(
+        `--out ${outArg} overlaps the input ${positionals[i]}; write the joined take somewhere of its own`
+      );
+  }
+  if (existsSync22(out)) {
+    if (!force)
+      throw new UsageError(
+        `--out ${outArg} exists; pass --force to replace it, or name a new directory`
+      );
+    const isTake = existsSync22(join24(out, "doc.json")) || existsSync22(join24(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 = [];
+  for (const [i, p] of positionals.entries()) {
+    r.log(`reading ${p}\u2026`);
+    parts.push({
+      ...await readPart(p),
+      ...muted.has(i) ? { mute: true } : {}
+    });
+  }
+  const plan = joinDocs(parts);
+  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])
+    ]);
+    for (const k of captions.uncaptioned)
+      plan.notes.push(
+        `no step in ${labelOf.get(k) ?? `media ${k}`} carries a caption`
+      );
+  }
+  const lint = lintDoc(plan.doc);
+  if (lint.problems.length) {
+    r.log(
+      `the joined document does not validate:
+  ${lint.problems.join("\n  ")}`
+    );
+    return EXIT_ERROR;
+  }
+  for (const c of plan.copies) {
+    if (!c.base) continue;
+    const found = localFile(relative4(c.base, c.from), c.base);
+    if ("refused" in found)
+      throw new Error(
+        `${relative4(process.cwd(), c.from) || c.from}, which an input's doc.json names, ${found.refused}; bring its media home first (vos fetch --media) or fix the key`
+      );
+    c.from = found.file;
+  }
+  if (existsSync22(out)) await rm3(out, { recursive: true, force: true });
+  await mkdir10(out, { recursive: true });
+  for (const c of plan.copies) {
+    const to = join24(out, c.to);
+    await mkdir10(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 ${basename11(c.from)}'s audio in Node, so it was copied as it is; its length comes from the container`
+        );
+    } else await copyFile2(c.from, to);
+  }
+  const doc = plan.doc;
+  await writeJson(join24(out, "meta.json"), doc.source.meta, true);
+  if (doc.source.cursor.length)
+    await writeJson(join24(out, "cursor.json"), doc.source.cursor);
+  if (parts[0].actions)
+    await writeJson(join24(out, "actions.json"), parts[0].actions, true);
+  await writeJson(join24(out, "doc.json"), doc, true);
+  const extents = segmentOutputExtents3(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("; ")}` : "") : "";
+  r.done(
+    {
+      out,
+      primary: positionals[0],
+      media: plan.media,
+      segments: doc.segments.length,
+      seconds: round32(length),
+      files: plan.copies.map((c) => c.to),
+      notes: plan.notes,
+      warnings: lint.warnings,
+      ...captions ? { captions } : {}
+    },
+    `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}`
+  );
+  return EXIT_OK;
+}
+
+// src/plugin/score.ts
+import { existsSync as existsSync23 } from "fs";
+import {
+  copyFile as copyFile3,
+  mkdir as mkdir11,
+  mkdtemp,
+  readFile as readFile14,
+  rm as rm4,
+  writeFile as writeFile11
+} from "fs/promises";
+import { tmpdir } from "os";
+import { basename as basename12, isAbsolute as isAbsolute4, join as join25, relative as relative5, resolve as resolve16, sep as sep3 } from "path";
+import {
+  docMediaList as docMediaList2,
+  docOutputDuration as docOutputDuration3,
+  findStep as findStep3,
+  ratedSegments as ratedSegments9,
+  resolveAnchor as resolveAnchor6
+} from "@vosjs/studio-core";
+var SCORE_ID = "score";
+var MID_SONG_FADE_IN = 0.8;
+var BLOCK_SECONDS = 0.1;
+var WINDOW_SECONDS = 1;
+var HOP_SECONDS = 0.5;
+var FLOOR_DB = -70;
+function kWeighting(sampleRate) {
+  const shelf = (() => {
+    const f0 = 1681.974450955533;
+    const G = 3.999843853973347;
+    const Q = 0.7071752369554196;
+    const K = Math.tan(Math.PI * f0 / sampleRate);
+    const Vh = Math.pow(10, G / 20);
+    const Vb = Math.pow(Vh, 0.4996667741545416);
+    const a0 = 1 + K / Q + K * K;
+    return {
+      b0: (Vh + Vb * K / Q + K * K) / a0,
+      b1: 2 * (K * K - Vh) / a0,
+      b2: (Vh - Vb * K / Q + K * K) / a0,
+      a1: 2 * (K * K - 1) / a0,
+      a2: (1 - K / Q + K * K) / a0
+    };
+  })();
+  const highPass = (() => {
+    const f0 = 38.13547087602444;
+    const Q = 0.5003270373238773;
+    const K = Math.tan(Math.PI * f0 / sampleRate);
+    const a0 = 1 + K / Q + K * K;
+    return {
+      b0: 1,
+      b1: -2,
+      b2: 1,
+      a1: 2 * (K * K - 1) / a0,
+      a2: (1 - K / Q + K * K) / a0
+    };
+  })();
+  return [shelf, highPass];
+}
+var LoudnessMeter = class {
+  constructor(sampleRate, channels) {
+    this.sampleRate = sampleRate;
+    this.channels = channels;
+    this.blockLen = Math.max(1, Math.round(sampleRate * BLOCK_SECONDS));
+    const weighted = channels >= 1 && channels <= 2 && sampleRate >= 8e3;
+    this.unit = weighted ? "LUFS" : "dBFS";
+    this.filters = weighted ? kWeighting(sampleRate) : null;
+    this.state = Array.from({ length: channels }, () => [
+      [0, 0, 0, 0],
+      [0, 0, 0, 0]
+    ]);
+    this.acc = new Array(channels).fill(0);
+  }
+  sampleRate;
+  channels;
+  unit;
+  blockLen;
+  filters;
+  /** Per channel, per stage: [x1, x2, y1, y2]. */
+  state;
+  acc;
+  filled = 0;
+  blocks = [];
+  /** One chunk: a Float32Array per channel, all the same length. */
+  push(planes) {
+    const n = planes[0]?.length ?? 0;
+    for (let i = 0; i < n; i++) {
+      for (let c = 0; c < this.channels; c++) {
+        let v = planes[c]?.[i] ?? 0;
+        if (this.filters) {
+          for (let k = 0; k < 2; k++) {
+            const f = this.filters[k];
+            const s = this.state[c][k];
+            const y = f.b0 * v + f.b1 * s[0] + f.b2 * s[1] - f.a1 * s[2] - f.a2 * s[3];
+            s[1] = s[0];
+            s[0] = v;
+            s[3] = s[2];
+            s[2] = y;
+            v = y;
+          }
+        }
+        this.acc[c] += v * v;
+      }
+      if (++this.filled === this.blockLen) this.flush();
+    }
+  }
+  flush() {
+    let power = 0;
+    for (let c = 0; c < this.channels; c++) {
+      power += this.acc[c] / this.filled;
+      this.acc[c] = 0;
+    }
+    if (this.unit === "dBFS") power /= Math.max(1, this.channels);
+    this.blocks.push(power);
+    this.filled = 0;
+  }
+  /** The blocks, the last partial one included. */
+  finish() {
+    if (this.filled > this.blockLen / 2) this.flush();
+    return this.blocks;
+  }
+};
+function levelCurve(blocks, unit) {
+  const per = Math.round(WINDOW_SECONDS / BLOCK_SECONDS);
+  const hop = Math.round(HOP_SECONDS / BLOCK_SECONDS);
+  const out = [];
+  for (let i = 0; i + per <= blocks.length; i += hop) {
+    let sum = 0;
+    for (let j = i; j < i + per; j++) sum += blocks[j];
+    const mean = sum / per;
+    const db = mean > 0 ? (unit === "LUFS" ? -0.691 : 0) + 10 * Math.log10(mean) : -Infinity;
+    out.push({
+      t: +((i + per / 2) * BLOCK_SECONDS).toFixed(3),
+      level: +Math.max(FLOOR_DB, db).toFixed(2)
+    });
+  }
+  return out;
+}
+var SWELL_LOOKBACK = 15;
+var SWELL_SUSTAIN = 1.5;
+var SWELL_HOLD_DB = 3;
+var SWELL_ARRIVE_DB = 1;
+var SWELL_MIN_RISE = 3;
+var SWELL_FLOOR_DB = 12;
+var SWELL_SETTLE = 5;
+function findSwell(curve) {
+  const step = HOP_SECONDS;
+  const back = Math.round(SWELL_LOOKBACK / step);
+  const hold = Math.round(SWELL_SUSTAIN / step);
+  const floor = median2(curve.map((p) => p.level)) - SWELL_FLOOR_DB;
+  const begun = curve.findIndex((p) => p.level >= floor);
+  if (begun < 0) return null;
+  const settled = begun + Math.round(SWELL_SETTLE / step);
+  const levelAt = (j) => Math.max(curve[j].level, floor);
+  let best = null;
+  for (let i = settled + 1; i < curve.length; i++) {
+    const p = curve[i];
+    let held = true;
+    for (let k = i + 1; k <= i + hold; k++) {
+      if (k >= curve.length || curve[k].level < p.level - SWELL_HOLD_DB) {
+        held = false;
+        break;
+      }
+    }
+    if (!held) continue;
+    let lo = i;
+    for (let j = Math.max(settled, i - back); j < i; j++)
+      if (levelAt(j) < levelAt(lo)) lo = j;
+    const rise = p.level - levelAt(lo);
+    if (rise < SWELL_MIN_RISE) continue;
+    if (i + 1 < curve.length && curve[i + 1].level > p.level) continue;
+    if (best && rise <= best.rise + 1e-9) continue;
+    let arrive = i;
+    for (let k = lo; k <= i; k++) {
+      if (curve[k].level >= p.level - SWELL_ARRIVE_DB) {
+        arrive = k;
+        break;
+      }
+    }
+    best = {
+      at: curve[arrive].t,
+      from: curve[lo].t,
+      peak: p.t,
+      rise: +rise.toFixed(2),
+      peakLevel: p.level
+    };
+  }
+  return best;
+}
+var median2 = (xs) => {
+  if (!xs.length) return FLOOR_DB;
+  const s = [...xs].sort((a, b) => a - b);
+  const m = Math.floor(s.length / 2);
+  return s.length % 2 ? s[m] : (s[m - 1] + s[m]) / 2;
+};
+function firstAboveMedian(curve) {
+  const m = median2(curve.map((p) => p.level));
+  const hit = curve.find((p) => p.level > m);
+  return hit ? Math.max(0, +(hit.t - WINDOW_SECONDS / 2).toFixed(3)) : 0;
+}
+var r3 = (v) => Math.round(v * 1e3) / 1e3;
+function planScore(input) {
+  const { trackDuration, film, swell } = input;
+  const notes = [];
+  let start;
+  if (input.at !== null) {
+    if (!swell) {
+      notes.push(
+        "the track has no swell (no sustained rise of 3 dB or more); it starts at its first rise instead"
+      );
+      start = firstAboveMedian(input.curve);
+    } else {
+      start = swell.at - input.at;
+      if (start < 0) {
+        notes.push(
+          `the swell (${swell.at.toFixed(1)}s into the track) comes before ${input.at.toFixed(1)}s of film can play ahead of it; the track starts at its top and the swell lands at ${swell.at.toFixed(1)}s`
+        );
+        start = 0;
+      }
+    }
+  } else {
+    start = firstAboveMedian(input.curve);
+  }
+  if (trackDuration < film) {
+    notes.push(
+      `the track (${trackDuration.toFixed(1)}s) is shorter than the film (${film.toFixed(1)}s); it cannot cover it, so it starts at its top and ends early`
+    );
+    start = 0;
+  } else if (start + film > trackDuration) {
+    const fit = Math.max(0, trackDuration - film);
+    notes.push(
+      `from ${start.toFixed(1)}s the track ends before the film does; it starts at ${fit.toFixed(1)}s instead, so the film is covered${swell && input.at !== null ? ` and the swell lands at ${(swell.at - fit).toFixed(1)}s` : ""}`
+    );
+    start = fit;
+  }
+  const out = Math.min(trackDuration, start + film);
+  const swellAt = swell && swell.at >= start && swell.at <= out ? r3(swell.at - start) : null;
+  return { in: r3(start), out: r3(out), swellAt, notes };
+}
+function sparkline(curve, width = 64) {
+  if (!curve.length) return "";
+  const glyphs = "\u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
+  const step = Math.max(1, Math.ceil(curve.length / width));
+  const pts = [];
+  for (let i = 0; i < curve.length; i += step) {
+    let m = -Infinity;
+    for (let j = i; j < Math.min(curve.length, i + step); j++)
+      m = Math.max(m, curve[j].level);
+    pts.push(m);
+  }
+  const hi = Math.max(...pts);
+  const lo = Math.max(Math.min(...pts), hi - 24);
+  return pts.map(
+    (v) => glyphs[hi > lo ? Math.max(
+      0,
+      Math.min(
+        glyphs.length - 1,
+        Math.floor((v - lo) / (hi - lo) * glyphs.length)
+      )
+    ) : 0]
+  ).join("");
+}
+async function measureInNode(path) {
+  const MB = await import("mediabunny");
+  const input = new MB.Input({
+    formats: MB.ALL_FORMATS,
+    source: new MB.FilePathSource(path)
+  });
+  try {
+    const track = await input.getPrimaryAudioTrack();
+    if (!track) throw new UsageError(`${path} has no audio track`);
+    if (!await track.canDecode()) return null;
+    const meter = new LoudnessMeter(track.sampleRate, track.numberOfChannels);
+    const sink = new MB.AudioSampleSink(track);
+    let frames = 0;
+    for await (const sample2 of sink.samples()) {
+      const planes = [];
+      for (let c = 0; c < track.numberOfChannels; c++) {
+        const a = new Float32Array(sample2.numberOfFrames);
+        sample2.copyTo(a, { planeIndex: c, format: "f32-planar" });
+        planes.push(a);
+      }
+      frames += sample2.numberOfFrames;
+      sample2.close();
+      meter.push(planes);
+    }
+    return {
+      sampleRate: track.sampleRate,
+      channels: track.numberOfChannels,
+      duration: frames / track.sampleRate,
+      unit: meter.unit,
+      blocks: meter.finish(),
+      via: "node"
+    };
+  } finally {
+    input.dispose();
+  }
+}
+var PAGE_CHUNK_SECONDS = 10;
+async function measureInBrowser(path) {
+  const bytes = await readFile14(path);
+  const browser = await launchBrowser();
+  try {
+    const page = await browser.newPage();
+    const info = await page.evaluate(`(async () => {
+      const b64 = ${JSON.stringify(bytes.toString("base64"))}
+      const bin = atob(b64)
+      const u8 = new Uint8Array(bin.length)
+      for (let i = 0; i < bin.length; i++) u8[i] = bin.charCodeAt(i)
+      const ctx = new OfflineAudioContext(1, 1, 48000)
+      const buf = await ctx.decodeAudioData(u8.buffer)
+      window.__vosScore = buf
+      return { sampleRate: buf.sampleRate, channels: buf.numberOfChannels, length: buf.length }
+    })()`);
+    const meter = new LoudnessMeter(info.sampleRate, info.channels);
+    const chunk = Math.round(info.sampleRate * PAGE_CHUNK_SECONDS);
+    for (let from = 0; from < info.length; from += chunk) {
+      const parts = await page.evaluate(`(() => {
+        const buf = window.__vosScore
+        const out = []
+        for (let c = 0; c < buf.numberOfChannels; c++) {
+          const a = buf.getChannelData(c).subarray(${from}, ${from + chunk})
+          const u8 = new Uint8Array(a.buffer, a.byteOffset, a.byteLength)
+          let s = ''
+          for (let i = 0; i < u8.length; i += 0x8000)
+            s += String.fromCharCode.apply(null, u8.subarray(i, i + 0x8000))
+          out.push(btoa(s))
+        }
+        return out
+      })()`);
+      meter.push(
+        parts.map((p) => {
+          const b = Buffer.from(p, "base64");
+          return new Float32Array(b.buffer, b.byteOffset, b.byteLength / 4);
+        })
+      );
+    }
+    return {
+      sampleRate: info.sampleRate,
+      channels: info.channels,
+      duration: info.length / info.sampleRate,
+      unit: meter.unit,
+      blocks: meter.finish(),
+      via: "browser"
+    };
+  } finally {
+    await browser.close();
+  }
+}
+async function measureTrack(path) {
+  return await measureInNode(path) ?? await measureInBrowser(path);
+}
+function resolveAt(doc, raw) {
+  const trimmed = raw.trim();
+  if (/^\d+(\.\d+)?s?$/.test(trimmed)) {
+    const at2 = parseFloat(trimmed);
+    return { at: at2, via: `${at2}s` };
+  }
+  const v = trimmed.startsWith("step:") ? trimmed.slice(5) : trimmed;
+  const pieces = ratedSegments9(doc);
+  const colon = v.indexOf(":");
+  const named = colon > 0 ? { media: v.slice(0, colon), step: v.slice(colon + 1) } : null;
+  const candidates = named ? [named] : docMediaList2(doc).filter(({ source }) => findStep3(source.meta.steps ?? [], v)).map(({ id }) => ({ media: id, step: v }));
+  if (!candidates.length)
+    throw new UsageError(
+      `--at ${raw}: no step by that id or index in this take (and not a number of seconds)`
+    );
+  if (candidates.length > 1)
+    throw new UsageError(
+      `--at ${raw}: steps of several media carry it; say which, as <media>:<step> (${candidates.map((c2) => `${c2.media || "primary"}`).join(", ")})`
+    );
+  const c = candidates[0];
+  const r = resolveAnchor6(
+    doc,
+    { step: c.step, ...c.media ? { media: c.media } : {} },
+    pieces
+  );
+  if (r.start === null)
+    throw new UsageError(
+      `--at ${raw}: that step ${r.miss === "cut" ? "is cut out of the film" : r.miss === "skipped" ? "was skipped by the recorder" : "is not in the take"}`
+    );
+  return { at: r.start, via: `step ${v} (${r.start.toFixed(2)}s)` };
+}
+async function resolveTrack(dir, ref, flags, dryRun) {
+  const local = resolve16(ref);
+  if (existsSync23(local)) {
+    const rel = relative5(resolve16(dir), local);
+    const inside = !!rel && !rel.startsWith(`..${sep3}`) && rel !== ".." && !isAbsolute4(rel);
+    const key = inside ? rel.split(sep3).join("/") : `music/${basename12(local)}`;
+    if (!inside && !dryRun) {
+      await mkdir11(join25(dir, "music"), { recursive: true });
+      await copyFile3(local, join25(dir, key));
+    }
+    return { path: local, key, name: basename12(local) };
+  }
+  const origin = platformOrigin({
+    origin: strFlag(flags, "origin"),
+    api: strFlag(flags, "api")
+  });
+  const catalog = await fetchMusicCatalog(origin);
+  const track = catalog.tracks.find((t) => t.slug === ref);
+  if (!track)
+    throw new UsageError(
+      `--track ${ref}: no such file, and no catalog track by that slug (some: ${catalog.tracks.slice(0, 6).map((t) => t.slug).join(", ")}; the list is GET ${origin}/api/music)`
+    );
+  const res = await fetch(track.url);
+  if (!res.ok) throw new Error(`GET ${track.url} answered ${res.status}`);
+  const tmp = await mkdtemp(join25(tmpdir(), "vos-score-"));
+  const path = join25(tmp, basename12(new URL(track.url).pathname) || "track");
+  await writeFile11(path, new Uint8Array(await res.arrayBuffer()));
+  return {
+    path,
+    key: track.url,
+    name: track.title,
+    cleanup: () => rm4(tmp, { recursive: true, force: true })
+  };
+}
+var BOOLEAN_FLAGS13 = /* @__PURE__ */ new Set(["json", "help", "dry-run"]);
+var USAGE3 = "vos score <take> --track <slug|file> [--at <step id|output seconds>] [--gain 0..1] [--fade-in <s>] [--fade-out <s>] [--dry-run] [--json]";
+async function cmdScore(argv) {
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS13);
+  const dir = positionals[0];
+  const trackRef = strFlag(flags, "track");
+  if (!dir || !trackRef) throw new UsageError(USAGE3);
+  const r = createReporter(flags.json === true);
+  const dryRun = flags["dry-run"] === true;
+  const gain = numFlag(flags, "gain", 0.5);
+  if (!(gain >= 0 && gain <= 1))
+    throw new UsageError("--gain expects a number from 0 to 1");
+  const fadeOut = numFlag(flags, "fade-out", 1.5);
+  if (!(fadeOut >= 0)) throw new UsageError("--fade-out expects seconds \u2265 0");
+  const fadeInFlag = strFlag(flags, "fade-in");
+  const fadeInAsked = numFlag(flags, "fade-in", MID_SONG_FADE_IN);
+  if (!(fadeInAsked >= 0)) throw new UsageError("--fade-in expects seconds \u2265 0");
+  const take = await loadTake(dir);
+  if (!take.doc)
+    throw new UsageError(`${dir} has no doc.json; run vos plan first`);
+  const doc = take.doc;
+  const atRaw = strFlag(flags, "at");
+  const at2 = atRaw !== void 0 ? resolveAt(doc, atRaw) : null;
+  const track = await resolveTrack(dir, trackRef, flags, dryRun);
+  let measured;
+  try {
+    r.log(`measuring ${track.name}\u2026`);
+    measured = await measureTrack(track.path);
+  } finally {
+    await track.cleanup?.();
+  }
+  const curve = levelCurve(measured.blocks, measured.unit);
+  const swell = findSwell(curve);
+  const film = docOutputDuration3(doc);
+  const plan = planScore({
+    trackDuration: measured.duration,
+    film,
+    curve,
+    swell,
+    at: at2 ? at2.at : null
+  });
+  const clip = {
+    id: SCORE_ID,
+    key: track.key,
+    name: track.name,
+    start: 0,
+    in: plan.in,
+    out: plan.out,
+    duration: r3(measured.duration),
+    gain,
+    // A track entered mid-song opens on a fade, never a cut into the bar;
+    // one that starts at its own top needs none unless asked.
+    fadeIn: Math.min(
+      fadeInFlag !== void 0 || plan.in > 0 ? fadeInAsked : 0,
+      Math.max(0, plan.out - plan.in)
+    ),
+    fadeOut: Math.min(fadeOut, Math.max(0, plan.out - plan.in)),
+    ...doc.source.micKey ? { duck: true } : {}
+  };
+  const levels = curve.map((p) => p.level);
+  const envelope = {
+    unit: measured.unit,
+    weighted: measured.unit === "LUFS",
+    decoder: measured.via,
+    sampleRate: measured.sampleRate,
+    channels: measured.channels,
+    min: levels.length ? Math.min(...levels) : null,
+    median: levels.length ? median2(levels) : null,
+    max: levels.length ? Math.max(...levels) : null,
+    points: curve
+  };
+  const others = doc.audio.filter((a) => a.id !== SCORE_ID && a.start < 0.05);
+  if (others.length)
+    plan.notes.push(
+      `${others.map((a) => a.id).join(", ")} also play${others.length === 1 ? "s" : ""} from the top; two tracks under one film rarely mean to`
+    );
+  if (!dryRun) {
+    doc.audio = [...doc.audio.filter((a) => a.id !== SCORE_ID), clip];
+    await writeJson(take.paths.doc, doc, true);
+  }
+  const label = measured.unit === "LUFS" ? "LUFS, K-weighted" : "dBFS RMS";
+  const swellLine = swell ? `swell: +${swell.rise.toFixed(1)} dB from ${swell.from.toFixed(1)}s, arriving ${swell.at.toFixed(1)}s into the track (peak ${swell.peakLevel.toFixed(1)} ${measured.unit} at ${swell.peak.toFixed(1)}s)` : "swell: none (no sustained rise of 3 dB or more)";
+  const placeLine = at2 && plan.swellAt !== null ? `the track starts at ${plan.in.toFixed(2)}s, so the swell lands at ${plan.swellAt.toFixed(2)}s of film (asked: ${at2.via})` : `the track starts at ${plan.in.toFixed(2)}s${at2 ? ` (asked: ${at2.via})` : ", its first rise above its median level"}`;
+  r.done(
+    {
+      take: resolve16(dir),
+      dryRun,
+      track: { key: track.key, name: track.name, duration: clip.duration },
+      film: r3(film),
+      swell,
+      at: at2?.at ?? null,
+      clip,
+      notes: plan.notes,
+      envelope
+    },
+    `${dryRun ? "Would score" : "Scored"} ${dir} with ${track.name} (${measured.duration.toFixed(1)}s, ${label})
+  ${sparkline(curve)}
+  ${swellLine}
+  ${placeLine}; it plays ${plan.in.toFixed(2)}..${plan.out.toFixed(2)} under the ${film.toFixed(1)}s film at gain ${gain}${plan.notes.length ? `
+  note: ${plan.notes.join("\n  note: ")}` : ""}${dryRun ? "\n  (dry run: doc.json untouched)" : `
+  audio clip "${SCORE_ID}" ${doc.audio.length > 1 ? "written beside the others" : "written"} in doc.json`}`
+  );
+  return EXIT_OK;
+}
+
+// src/plugin/look.ts
+import { mkdir as mkdir12 } from "fs/promises";
+import { existsSync as existsSync24 } from "fs";
+import { join as join26, resolve as resolve17 } from "path";
+import { headersFor, urlSchemeProblem } from "@vosjs/render-core/record";
+function quote(value) {
+  return `"${value.replace(/\s+/g, " ").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+var NAME_MAX = 80;
+function scopeSelector(s, kind) {
+  if (s.testId) return `[${s.testId.attr}=${quote(s.testId.value)}]`;
+  let base;
+  if (s.role) base = `[role=${quote(s.role)}]`;
+  else if (kind === "dialog" && s.tag === "dialog") base = "dialog[open]";
+  else if (kind === "dialog") base = '[aria-modal="true"]';
+  else base = s.tag;
+  return s.label ? `${base}[aria-label=${quote(s.label)}]` : base;
+}
+function stableId(id) {
+  if (!id || !/^[A-Za-z][\w-]*$/.test(id)) return false;
+  if (/^(radix|headlessui|mui|react|ember|ext|rc|el|v)-/i.test(id)) return false;
+  return !/\d{2,}/.test(id);
+}
+function selectorCandidates(c) {
+  const out = [];
+  const add = (selector, basis) => {
+    if (!out.some((x) => x.selector === selector)) out.push({ selector, basis });
+  };
+  const dialog = c.dialog ? scopeSelector(c.dialog, "dialog") : null;
+  const landmark = c.landmark ? scopeSelector(c.landmark, "landmark") : null;
+  const css = (sel) => dialog ? `${dialog} ${sel}` : sel;
+  const chain = (sel) => dialog ? `${dialog} >> ${sel}` : sel;
+  if (c.testId) {
+    const sel = `[${c.testId.attr}=${quote(c.testId.value)}]`;
+    add(sel, "testid");
+    if (dialog) add(`${dialog} ${sel}`, "testid");
+  }
+  if (c.ariaLabel && c.ariaLabel.length <= NAME_MAX)
+    add(css(`[aria-label=${quote(c.ariaLabel)}]`), "aria-label");
+  if (c.tag === "a" && c.hrefAttr && c.hrefAttr.length <= 200 && !/^\s*javascript:/i.test(c.hrefAttr) && c.hrefAttr.trim() !== "#")
+    add(css(`a[href=${quote(c.hrefAttr)}]`), "href");
+  if (c.role && c.name && c.name.length <= NAME_MAX) {
+    const sel = `role=${c.role}[name=${quote(c.name)}]`;
+    add(chain(sel), "role");
+    if (!dialog && landmark) add(`${landmark} >> ${sel}`, "role");
+  }
+  const form = /^(input|textarea|select)$/.test(c.tag);
+  if (form && c.nameAttr)
+    add(css(`${c.tag}[name=${quote(c.nameAttr)}]`), "form");
+  if (form && c.placeholder && c.placeholder.length <= NAME_MAX)
+    add(css(`${c.tag}[placeholder=${quote(c.placeholder)}]`), "form");
+  if (stableId(c.id)) add(`#${c.id}`, "id");
+  if (!form && c.text && c.text.length <= 60) {
+    const sel = `text=${quote(c.text)}`;
+    if (dialog) add(`${dialog} >> ${sel}`, "text");
+    else if (landmark) add(`${landmark} >> ${sel}`, "text");
+    else add(sel, "text");
+  }
+  return out;
+}
+function judgeMatch(index, reached) {
+  if (!reached.includes(String(index))) return "miss";
+  return reached.length === 1 ? "unique" : "ambiguous";
+}
+function chooseProposal(index, candidates, reached) {
+  let fallback = null;
+  for (let i = 0; i < candidates.length; i++) {
+    const verdict = judgeMatch(index, reached[i] ?? []);
+    if (verdict === "unique")
+      return {
+        selector: candidates[i].selector,
+        basis: candidates[i].basis,
+        match: "unique",
+        matches: 1
+      };
+    if (verdict === "ambiguous" && !fallback)
+      fallback = { c: candidates[i], n: reached[i].length };
+  }
+  if (fallback)
+    return {
+      selector: fallback.c.selector,
+      basis: fallback.c.basis,
+      match: "ambiguous",
+      matches: fallback.n
+    };
+  return { selector: null, basis: null, match: "none", matches: 0 };
+}
+var SPEND_STEMS = [
+  "delet",
+  "remov",
+  "revok",
+  "eras",
+  "discard",
+  "publish",
+  "deploy",
+  "purchas",
+  "subscri",
+  "unsubscri",
+  "pay",
+  "buy",
+  "generat",
+  "submit",
+  "send",
+  "transfer",
+  "upgrad",
+  "confirm",
+  "leav",
+  "destroy"
+];
+var SPEND_PHRASES = [
+  "move to trash",
+  "empty trash",
+  "cancel subscription",
+  "cancel plan",
+  "close account"
+];
+var SPEND = new RegExp(
+  `\\b(?:${SPEND_PHRASES.map((p) => p.replace(/ /g, "\\s+")).join("|")}|(?:${SPEND_STEMS.join("|")})[a-z]*)`,
+  "i"
+);
+function spendWord(words2) {
+  for (const w of words2) {
+    const m = w ? SPEND.exec(w.replace(/\s+/g, " ")) : null;
+    if (m) return m[0].toLowerCase();
+  }
+  return null;
+}
+function refusalLine(selector, label, word) {
+  return `refused: --click ${selector} reaches "${label}": "${word}" spends, sends or destroys, and vos look never presses one. Look at the page before it; a flow that needs the press has it as a step in actions.json, for vos record`;
+}
+var ENGINES = /^(css|xpath|text|role|id|nth|visible|data-testid|data-test-id|data-test|internal:[a-z-]+)$/;
+function splitTypeFlag(value) {
+  let depth = 0;
+  let inQuote = null;
+  let segment = 0;
+  for (let i = 0; i < value.length; i++) {
+    const ch = value[i];
+    if (inQuote) {
+      if (ch === "\\") i++;
+      else if (ch === inQuote) inQuote = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'") inQuote = ch;
+    else if (ch === "[" || ch === "(") depth++;
+    else if ((ch === "]" || ch === ")") && depth > 0) depth--;
+    else if (ch === ">" && value[i + 1] === ">") {
+      segment = i + 2;
+      i++;
+    } else if (ch === "=" && depth === 0) {
+      if (ENGINES.test(value.slice(segment, i).trim())) continue;
+      const selector = value.slice(0, i).trim();
+      if (!selector) break;
+      return { selector, text: value.slice(i + 1) };
+    }
+  }
+  throw new UsageError(
+    `--type expects <selector>=<text>, got "${value}" (the text follows the first = outside the selector's brackets and quotes)`
+  );
+}
+function lookSteps(argv) {
+  const steps = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--") break;
+    const m = /^--(click|type)(?:=(.*))?$/s.exec(arg);
+    if (!m) continue;
+    let value = m[2];
+    if (value === void 0) {
+      value = argv[i + 1];
+      if (value === void 0 || value.startsWith("--"))
+        throw new UsageError(`--${m[1]} expects a value`);
+      i++;
+    }
+    if (m[1] === "click") {
+      if (!value.trim()) throw new UsageError("--click expects a selector");
+      steps.push({ do: "click", selector: value });
+    } else steps.push({ do: "type", ...splitTypeFlag(value) });
+  }
+  return steps;
+}
+function parseViewport2(value) {
+  if (!value) return { width: 1280, height: 720 };
+  const m = /^(\d+)x(\d+)$/i.exec(value);
+  if (!m) throw new UsageError("--viewport expects WxH, like 1280x720");
+  const width = Number(m[1]);
+  const height = Number(m[2]);
+  if (width < 200 || height < 200 || width > 3840 || height > 2160)
+    throw new UsageError("--viewport wants a size from 200x200 to 3840x2160");
+  return { width, height };
+}
+function displayName(c) {
+  const words2 = c.name || c.text || c.placeholder || "";
+  return words2.length > 60 ? `${words2.slice(0, 59).trimEnd()}\u2026` : words2;
+}
+function controlLine(c) {
+  const what = c.role && c.role !== c.tag ? `${c.tag} (${c.role})` : c.tag;
+  const name = c.redacted?.length ? ` [${c.redacted.join(", ")} withheld]` : c.name ? ` ${JSON.stringify(c.name)}` : "";
+  const flags = [
+    c.inDialog ? "in dialog" : "",
+    c.disabled ? "disabled" : "",
+    c.covered ? "covered" : ""
+  ].filter(Boolean);
+  const proposal = c.selector ? `${c.selector}  ${c.match === "unique" ? "UNIQUE" : `AMBIGUOUS (${c.matches})`}` : "no stable selector (use its rect)";
+  const r = c.rect;
+  return `  ${what}${name}${flags.length ? `  [${flags.join(", ")}]` : ""}
+      ${proposal}  @ ${r.x},${r.y} ${r.w}\xD7${r.h}`;
+}
+var CONTROL_LIMIT = 150;
+var LOOK_PROBE = `(() => {
+  const { kindsIn } = ${EXPOSURE_MATCHERS_SRC}
+  const vw = innerWidth, vh = innerHeight
+  const CONTROLS = 'button, a, [role=button], [role=tab], [role=menuitem], [role=menuitemcheckbox], [role=menuitemradio], [role=checkbox], [role=switch], [role=option], [role=radio], [role=link], input, textarea, select, [contenteditable], [data-testid], [data-test-id], [data-test], [data-cy]'
+  const TEST_IDS = ['data-testid', 'data-test-id', 'data-test', 'data-cy']
+  const DIALOGS = 'dialog[open], [role=dialog], [role=alertdialog], [aria-modal=true]'
+  const LANDMARKS = 'nav, header, main, aside, footer, [role=navigation], [role=banner], [role=main], [role=complementary], [role=contentinfo], [role=search]'
+  const squash = (s) => (s || '').replace(/\\s+/g, ' ').trim()
+  const textOf = (el) => squash(typeof el.innerText === 'string' ? el.innerText : el.textContent)
+  const shown = (el) => {
+    const r = el.getBoundingClientRect()
+    if (r.width < 2 || r.height < 2) return null
+    if (el.checkVisibility && !el.checkVisibility({ opacityProperty: true, visibilityProperty: true })) return null
+    const s = getComputedStyle(el)
+    if (s.visibility === 'hidden' || s.display === 'none' || +s.opacity === 0) return null
+    return r
+  }
+  const testIdOf = (el) => {
+    for (const attr of TEST_IDS) { const value = el.getAttribute(attr); if (value) return { attr, value } }
+    return null
+  }
+  const implicitRole = (el) => {
+    const t = el.tagName
+    if (t === 'BUTTON') return 'button'
+    if (t === 'A') return el.hasAttribute('href') ? 'link' : ''
+    if (t === 'TEXTAREA') return 'textbox'
+    if (t === 'SELECT') return el.multiple || el.size > 1 ? 'listbox' : 'combobox'
+    if (t === 'INPUT') {
+      const type = (el.getAttribute('type') || 'text').toLowerCase()
+      if (type === 'checkbox' || type === 'radio') return type
+      if (type === 'range') return 'slider'
+      if (type === 'number') return 'spinbutton'
+      if (/^(button|submit|reset|image)$/.test(type)) return 'button'
+      if (/^(text|email|tel|url|search)$/.test(type)) return el.hasAttribute('list') ? 'combobox' : type === 'search' ? 'searchbox' : 'textbox'
+      return ''
+    }
+    if (el.isContentEditable && el.hasAttribute('contenteditable')) return 'textbox'
+    return ''
+  }
+  const roleOf = (el) => (el.getAttribute('role') || '').trim().split(/\\s+/)[0] || implicitRole(el)
+  const nameOf = (el) => {
+    const aria = squash(el.getAttribute('aria-label'))
+    if (aria) return aria
+    const by = el.getAttribute('aria-labelledby')
+    if (by) {
+      const t = squash(by.split(/\\s+/).map((id) => document.getElementById(id)).filter(Boolean).map(textOf).join(' '))
+      if (t) return t
+    }
+    if (/^(INPUT|TEXTAREA|SELECT)$/.test(el.tagName)) {
+      const type = (el.getAttribute('type') || '').toLowerCase()
+      if (/^(button|submit|reset)$/.test(type)) return squash(el.value) || (type === 'submit' ? 'Submit' : type === 'reset' ? 'Reset' : '')
+      if (type === 'image') return squash(el.getAttribute('alt'))
+      const label = el.labels ? squash([...el.labels].map(textOf).join(' ')) : ''
+      return label || squash(el.getAttribute('title')) || squash(el.getAttribute('placeholder'))
+    }
+    const text = textOf(el)
+    if (text) return text
+    const img = el.querySelector('img[alt]')
+    return squash(img && img.getAttribute('alt')) || squash(el.getAttribute('title'))
+  }
+  const scopeOf = (el) => el ? {
+    tag: el.tagName.toLowerCase(),
+    role: (el.getAttribute('role') || '').trim().split(/\\s+/)[0] || '',
+    label: squash(el.getAttribute('aria-label')) || null,
+    testId: testIdOf(el),
+  } : null
+  const hrefOf = (el) => {
+    if (el.tagName !== 'A' || !el.hasAttribute('href')) return null
+    try { const u = new URL(el.href, location.href); const at = u.pathname + u.search; return u.origin === location.origin ? at : u.origin + at } catch { return null }
+  }
+  const out = []
+  let offscreen = 0, more = 0
+  for (const el of document.querySelectorAll(CONTROLS)) {
+    if (el.tagName === 'INPUT' && (el.getAttribute('type') || '').toLowerCase() === 'hidden') continue
+    if (el.getAttribute('contenteditable') === 'false') continue
+    if (el.tagName === 'A' && !el.hasAttribute('href') && !el.getAttribute('role') && !testIdOf(el)) continue
+    const r = shown(el)
+    if (!r) continue
+    if (r.bottom <= 0 || r.right <= 0 || r.top >= vh || r.left >= vw) { offscreen++; continue }
+    if (out.length >= ${CONTROL_LIMIT}) { more++; continue }
+    const dlg = el.closest(DIALOGS)
+    const lm = el.closest(LANDMARKS)
+    let name = nameOf(el), text = /^(INPUT|TEXTAREA|SELECT)$/.test(el.tagName) ? '' : textOf(el)
+    let ariaLabel = squash(el.getAttribute('aria-label')) || null
+    let placeholder = squash(el.getAttribute('placeholder')) || null
+    let hrefAttr = el.tagName === 'A' ? el.getAttribute('href') : null, href = hrefOf(el)
+    const kinds = [...new Set([...kindsIn(name), ...kindsIn(text), ...kindsIn(ariaLabel || ''), ...kindsIn(placeholder || ''), ...kindsIn(hrefAttr || '')])]
+    if (kinds.length) { name = ''; text = ''; ariaLabel = null; placeholder = null; hrefAttr = null; href = null }
+    const cx = Math.min(vw - 1, Math.max(0, r.left + r.width / 2)), cy = Math.min(vh - 1, Math.max(0, r.top + r.height / 2))
+    const hit = document.elementFromPoint(cx, cy)
+    const covered = !!hit && !(hit === el || el.contains(hit) || (el.labels && [...el.labels].some((l) => l.contains(hit))))
+    const index = out.length
+    out.push({
+      index,
+      tag: el.tagName.toLowerCase(),
+      role: roleOf(el),
+      name,
+      text,
+      ariaLabel,
+      testId: testIdOf(el),
+      id: el.id || null,
+      nameAttr: /^(INPUT|TEXTAREA|SELECT)$/.test(el.tagName) ? el.getAttribute('name') || null : null,
+      placeholder,
+      href,
+      hrefAttr,
+      rect: { x: Math.round(r.left), y: Math.round(r.top), w: Math.round(r.width), h: Math.round(r.height) },
+      disabled: el.matches(':disabled') || el.getAttribute('aria-disabled') === 'true',
+      covered,
+      dialog: dlg && shown(dlg) ? scopeOf(dlg) : null,
+      landmark: lm ? scopeOf(lm) : null,
+      ...(kinds.length ? { redacted: kinds } : {}),
+    })
+    el.setAttribute('data-vos-look', String(index))
+  }
+  return { controls: out, offscreen, more }
+})()`;
+var UNSTAMP = `(() => { for (const el of document.querySelectorAll('[data-vos-look]')) el.removeAttribute('data-vos-look') })()`;
+function settleScript(quietMs, capMs) {
+  return `new Promise((resolve) => {
+  let last = performance.now()
+  const start = last
+  const mo = new MutationObserver(() => { last = performance.now() })
+  mo.observe(document, { subtree: true, childList: true, attributes: true, characterData: true })
+  const tick = () => {
+    const now = performance.now()
+    if (now - last >= ${quietMs} || now - start >= ${capMs}) {
+      mo.disconnect()
+      resolve(now - last >= ${quietMs})
+    } else setTimeout(tick, 50)
+  }
+  tick()
+})`;
+}
+var QUIET_MS = 800;
+var SETTLE_CAP_MS = 6e3;
+var STEP_TIMEOUT_MS = 8e3;
+async function settle(page) {
+  const started = Date.now();
+  for (let tries = 0; tries < 3; tries++) {
+    await page.waitForLoadState("load", { timeout: 15e3 }).catch(() => {
+    });
+    const left = Math.max(QUIET_MS, SETTLE_CAP_MS - (Date.now() - started));
+    try {
+      return await page.evaluate(settleScript(QUIET_MS, left));
+    } catch {
+    }
+  }
+  return false;
+}
+var LookRefusal = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "LookRefusal";
+  }
+};
+var place = (u) => {
+  try {
+    const x = new URL(u);
+    return `${x.origin}${x.pathname}`;
+  } catch {
+    return u;
+  }
+};
+function shownUrl(u) {
+  try {
+    const x = new URL(u);
+    if (!x.username && !x.password) return u;
+    x.username = "";
+    x.password = "";
+    return x.href;
+  } catch {
+    return u;
+  }
+}
+async function lookAt(page, url, opts) {
+  const log = opts.log ?? (() => {
+  });
+  log(`goto ${shownUrl(url)}`);
+  const response = await page.goto(url, { waitUntil: "load", timeout: 45e3 }).catch((e) => {
+    if (e instanceof Error && /net::ERR_/.test(e.message))
+      throw new Error(
+        `could not open ${shownUrl(url)}: ${(e.message.split("\n")[0] ?? "").split(url).join(shownUrl(url))}`
+      );
+    log("   (the load event never fired; looking anyway)");
+    return null;
+  });
+  let settled = await settle(page);
+  const seen = await page.evaluate(WALL_PROBE).catch(() => null);
+  const wall = wallVerdict({
+    askedUrl: url,
+    landedUrl: page.url(),
+    ...response ? { status: response.status() } : {},
+    passwordFields: seen?.passwordFields ?? 0,
+    newPasswordField: seen?.newPasswordField ?? false,
+    oneTimeCodeField: seen?.oneTimeCodeField ?? false
+  });
+  const ran = [];
+  if (!wall || wall.level === "soft") {
+    for (const step2 of opts.steps ?? []) {
+      const all = page.locator(step2.selector);
+      const target = all.first();
+      try {
+        await target.waitFor({ state: "visible", timeout: STEP_TIMEOUT_MS });
+      } catch {
+        throw new UsageError(
+          `--${step2.do} ${step2.selector}: no visible element matches it after ${STEP_TIMEOUT_MS / 1e3} s. Look without the step and take a selector from the list`
+        );
+      }
+      const count = await all.count();
+      const note = count > 1 ? `the first of ${count} matches` : void 0;
+      if (step2.do === "click") {
+        const words2 = await target.evaluate(
+          (el) => [
+            el.getAttribute("aria-label"),
+            el.innerText || el.textContent,
+            el.value,
+            el.getAttribute("title"),
+            el.getAttribute("alt")
+          ].map(
+            (s) => typeof s === "string" ? s.replace(/\s+/g, " ").trim() : ""
+          )
+        ).catch(() => []);
+        const word = spendWord(words2);
+        if (word) {
+          const label = words2.find((w) => spendWord([w])) ?? word;
+          throw new LookRefusal(
+            refusalLine(step2.selector, label.slice(0, 60), word)
+          );
+        }
+        log(`click ${step2.selector}${note ? ` (${note})` : ""}`);
+        await target.click({ timeout: STEP_TIMEOUT_MS });
+      } else {
+        log(
+          `type ${step2.text.length} chars into ${step2.selector}${note ? ` (${note})` : ""}`
+        );
+        await target.fill(step2.text, { timeout: STEP_TIMEOUT_MS });
+      }
+      ran.push({
+        do: step2.do,
+        selector: step2.selector,
+        ...note ? { note } : {}
+      });
+      settled = await settle(page);
+    }
+  }
+  if (opts.waitMs && opts.waitMs > 0) await page.waitForTimeout(opts.waitMs);
+  await mkdir12(opts.outDir, { recursive: true });
+  const screenshot = join26(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;
+  const exposures = (scan?.exposures ?? []).map((e) => ({
+    step,
+    ...e,
+    seen: 1
+  }));
+  const probe3 = await page.evaluate(LOOK_PROBE);
+  const controls = [];
+  try {
+    for (const raw of probe3.controls) {
+      const candidates = selectorCandidates(raw);
+      const reached = [];
+      for (const c of candidates) {
+        const stamps = await page.locator(c.selector).evaluateAll(
+          (els) => els.map((el) => el.getAttribute("data-vos-look"))
+        ).catch(() => []);
+        reached.push(stamps);
+        if (judgeMatch(raw.index, stamps) === "unique") break;
+      }
+      const proposal = chooseProposal(raw.index, candidates, reached);
+      controls.push({
+        tag: raw.tag,
+        role: raw.role,
+        name: displayName(raw),
+        testId: raw.testId?.value ?? null,
+        href: raw.href,
+        rect: raw.rect,
+        disabled: raw.disabled,
+        inDialog: raw.dialog !== null,
+        covered: raw.covered,
+        ...proposal,
+        ...raw.redacted ? { redacted: raw.redacted } : {}
+      });
+    }
+  } finally {
+    await page.evaluate(UNSTAMP).catch(() => {
+    });
+  }
+  return {
+    url: shownUrl(url),
+    landed: place(page.url()),
+    screenshot,
+    viewport: page.viewportSize() ?? { width: 0, height: 0 },
+    controls,
+    offscreen: probe3.offscreen,
+    more: probe3.more,
+    exposures,
+    wall,
+    steps: ran,
+    settled
+  };
+}
+var USAGE4 = "vos look <url> [--session <name> | --storage-state <file>] [--viewport WxH] [--headed] [--click <selector>]... [--type <selector>=<text>]... [--wait <ms>] [--out <dir>] [--json]";
+function lookReport(r) {
+  const inDialog = r.controls.filter((c) => c.inDialog).length;
+  const head = `Looked at ${r.landed} (${r.viewport.width}\xD7${r.viewport.height}): ${r.screenshot}${r.settled ? "" : "\n  note: the page never held still for 0.8 s; looked at it as it was"}`;
+  const steps = r.steps.length ? `
+  after ${r.steps.map((s) => `${s.do} ${s.selector}${s.note ? ` (${s.note})` : ""}`).join(", then ")}` : "";
+  const wall = r.wall ? `
+  ${r.wall.level === "hard" ? "WALL" : "WARNING"}: ${r.wall.message}${r.wall.level === "hard" ? "\n  The steps did not run; this is the page in front of the one asked for." : ""}` : "";
+  const count = `
+  ${r.controls.length} control${r.controls.length === 1 ? "" : "s"} in view${inDialog ? ` (${inDialog} in an open dialog)` : ""}${r.offscreen ? `, ${r.offscreen} more outside it (scroll, or a taller --viewport)` : ""}${r.more ? `, ${r.more} past the listing's limit` : ""}:`;
+  const list = r.controls.map(controlLine).join("\n");
+  const exposed = r.exposures.length ? `
+  EXPOSED in the frame (${r.exposures.length}):
+${r.exposures.map((e) => `    - ${exposureLine(e)}`).join("\n")}
+  ${EXPOSURE_ADVICE}` : "";
+  const next = `
+  Take a UNIQUE selector into actions.json as it is; an AMBIGUOUS one reaches several and the recorder takes the first. Then rehearse: vos record --actions actions.json --dry-run`;
+  return `${head}${steps}${wall}${count}
+${list}${exposed}${next}`;
+}
+async function cmdLook(argv) {
+  const steps = lookSteps(argv);
+  const { positionals, flags, multi } = parseArgs(
+    argv,
+    /* @__PURE__ */ new Set(["json", "headed"]),
+    /* @__PURE__ */ new Set(["click", "type", "header", "browser-arg"])
+  );
+  void multi.click;
+  void multi.type;
+  const url = positionals[0];
+  if (!url) throw new UsageError(USAGE4);
+  const scheme = urlSchemeProblem(url);
+  if (scheme) throw new UsageError(scheme);
+  const r = createReporter(flags.json === true);
+  const viewport = parseViewport2(strFlag(flags, "viewport"));
+  const outDir = resolve17(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 ? resolve17(storageRaw) : void 0;
+  if (storageState && !existsSync24(storageState))
+    throw new UsageError(`--storage-state: no such file: ${storageState}`);
+  const sessionName = strFlag(flags, "session");
+  if (sessionName) {
+    const bad = sessionNameVerdict(sessionName);
+    if (bad) throw new UsageError(bad);
+    if (storageState)
+      throw new UsageError(
+        "--session and --storage-state are two doors to one page: a persistent profile cannot take a storage state. Pass one"
+      );
+    if (!existsSync24(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)`
+      );
+  }
+  let headers;
+  try {
+    headers = parseHeaders(multi.header);
+  } catch (e) {
+    throw new UsageError(e instanceof Error ? e.message : String(e));
+  }
+  const browserArgs = (multi["browser-arg"] ?? []).filter(Boolean);
+  const inContext = async (ctx) => {
+    if (Object.keys(headers).length)
+      await ctx.route("**/*", async (route) => {
+        const req = route.request();
+        const scoped = headersFor(req.url(), url, headers);
+        await route.continue(
+          scoped ? { headers: { ...req.headers(), ...scoped } } : void 0
+        );
+      });
+    const page = ctx.pages()[0] ?? await ctx.newPage();
+    await page.setViewportSize(viewport);
+    return lookAt(page, url, { steps, waitMs, outDir, log: r.log });
+  };
+  let result;
+  try {
+    if (sessionName) {
+      result = await withSession(sessionName, inContext, {
+        headless: !headed,
+        viewport
+      });
+    } else {
+      const browser = await launchBrowser(browserArgs, { headless: !headed });
+      try {
+        const ctx = await browser.newContext({
+          viewport,
+          deviceScaleFactor: 1,
+          ...storageState ? { storageState } : {}
+        });
+        result = await inContext(ctx);
+      } finally {
+        await browser.close();
+      }
+    }
+  } catch (e) {
+    if (e instanceof LookRefusal) {
+      r.done({ ok: false, refused: true, error: e.message }, e.message);
+      return EXIT_USAGE;
+    }
+    throw e;
+  }
+  r.done(
+    { ok: !result.wall || result.wall.level === "soft", ...result },
+    lookReport(result)
+  );
+  return result.wall?.level === "hard" ? EXIT_WALL : EXIT_OK;
+}
+
+// src/plugin/machineCmd.ts
+import { spawnSync as spawnSync4 } from "child_process";
+import {
+  cpSync,
+  existsSync as existsSync26,
+  mkdirSync as mkdirSync6,
+  readFileSync as readFileSync11,
+  rmSync as rmSync3,
+  writeFileSync as writeFileSync6
+} from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join28 } from "path";
+import { chromium as chromium2 } from "playwright";
+
+// src/plugin/machine.ts
+import { existsSync as existsSync25, readFileSync as readFileSync10, readdirSync as readdirSync6, statSync as statSync8 } from "fs";
+import { dirname as dirname10, join as join27 } from "path";
+var AGENT_NAMES = [
+  "claude",
+  "cursor",
+  "codex",
+  "copilot"
+];
+var PROJECT_DIRS = {
+  claude: [".claude"],
+  cursor: [".cursor"],
+  codex: [".codex", ".agents"],
+  copilot: [".github/copilot"]
+};
+var HOME_DIRS = {
+  claude: [".claude"],
+  cursor: [".cursor"],
+  codex: [".codex", ".agents"],
+  copilot: [".copilot"]
+};
+function detectAgents(root, opts = {}) {
+  const exists = opts.exists ?? existsSync25;
+  const out = [];
+  for (const agent of AGENT_NAMES) {
+    for (const rel of PROJECT_DIRS[agent]) {
+      const dir = join27(root, rel);
+      if (exists(dir)) out.push({ agent, dir, scope: "project" });
+    }
+    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join27(root, ".github", "copilot-instructions.md"))) {
+      out.push({
+        agent,
+        dir: join27(root, ".github", "copilot"),
+        scope: "project"
+      });
+    }
+  }
+  if (opts.global && opts.home) {
+    for (const agent of AGENT_NAMES) {
+      for (const rel of HOME_DIRS[agent]) {
+        const dir = join27(opts.home, rel);
+        if (exists(dir)) out.push({ agent, dir, scope: "global" });
+      }
+    }
+  }
+  return out;
+}
+function agentsFromFlag(value, root) {
+  const wanted = value.trim() === "all" ? [...AGENT_NAMES] : value.split(",").map((s) => s.trim()).filter(Boolean);
+  const bad = wanted.filter((w) => !AGENT_NAMES.includes(w));
+  if (bad.length)
+    return {
+      error: `--agent takes ${AGENT_NAMES.join(", ")} or all, not "${bad.join(", ")}"`
+    };
+  if (!wanted.length) return { error: "--agent expects a name" };
+  return {
+    homes: wanted.map((agent) => ({
+      agent,
+      dir: join27(root, PROJECT_DIRS[agent][0]),
+      scope: "project"
+    }))
+  };
+}
+function skillsDirFor(home) {
+  return join27(home.dir, "skills");
+}
+function fallbackSkillsHome(root) {
+  return { agent: "codex", dir: join27(root, ".agents"), scope: "project" };
+}
+function installedSkills(dir, exists = existsSync25, list = (p) => {
+  try {
+    return readdirSync6(p);
+  } catch {
+    return [];
+  }
+}) {
+  if (!exists(dir)) return [];
+  return list(dir).filter((name) => exists(join27(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 -->";
+var RULES_BODY = `## Product videos (vosso)
+- Skill: product-video (npx skills add vosjs/skills) records the real product from actions.json
+- Look before you cut: vos frames take --at-zooms; edit take/doc.json and re-render, never re-record
+- Hand back: vos open take serves the take into the studio at vos.so, doc.json intact
+- Local by default: vos push only when asked for a link, the shelf or a cloud render
+- Deleting: vos delete moves a vos to Trash and vos restore brings it back; if you deleted by mistake, restore it and say so. Only the person can delete forever, at vos.so/app/trash
+- Credentials: VOS_API_KEY, then ~/.config/vos/credentials, then vos login; never print one
+- Reference: https://vos.so/llms-full.txt`;
+var RULES_BLOCK = `${RULES_BEGIN}
+${RULES_BODY}
+${RULES_END}`;
+function applyRulesBlock(existing) {
+  const current = existing ?? "";
+  const begin = current.indexOf(RULES_BEGIN);
   const end = current.indexOf(RULES_END);
   let text;
   if (begin !== -1 && end !== -1 && end > begin) {
@@ -12148,10 +14821,10 @@ ${RULES_BLOCK}
   }
   return { text, changed: text !== current };
 }
-function rulesFileFor(root, exists = existsSync21) {
-  const agents = join23(root, "AGENTS.md");
+function rulesFileFor(root, exists = existsSync25) {
+  const agents = join27(root, "AGENTS.md");
   if (exists(agents)) return agents;
-  const claude = join23(root, "CLAUDE.md");
+  const claude = join27(root, "CLAUDE.md");
   if (exists(claude)) return claude;
   return agents;
 }
@@ -12160,14 +14833,14 @@ function chromeCandidates(platform, env) {
     return ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"];
   if (platform === "win32")
     return [
-      join23(
+      join27(
         env["PROGRAMFILES"] ?? "C:\\Program Files",
         "Google",
         "Chrome",
         "Application",
         "chrome.exe"
       ),
-      join23(
+      join27(
         env["LOCALAPPDATA"] ?? "",
         "Google",
         "Chrome",
@@ -12253,27 +14926,27 @@ function doctorReport(facts) {
 }
 function bundledSkillsVersion(dir) {
   try {
-    const v = readFileSync10(join23(dir, "VERSION"), "utf8").trim();
+    const v = readFileSync10(join27(dir, "VERSION"), "utf8").trim();
     return /^\d+\.\d+\.\d+$/.test(v) ? v : null;
   } catch {
     return null;
   }
 }
 function bundledSkillsDir(from) {
-  let dir = dirname8(from);
+  let dir = dirname10(from);
   for (let i = 0; i < 6; i++) {
-    const pkg = join23(dir, "package.json");
-    if (existsSync21(pkg)) {
+    const pkg = join27(dir, "package.json");
+    if (existsSync25(pkg)) {
       try {
         const name = JSON.parse(readFileSync10(pkg, "utf8")).name;
         if (name === "@vosjs/cli") {
-          const skills = join23(dir, "skills");
-          return existsSync21(skills) && statSync7(skills).isDirectory() ? skills : null;
+          const skills = join27(dir, "skills");
+          return existsSync25(skills) && statSync8(skills).isDirectory() ? skills : null;
         }
       } catch {
       }
     }
-    const up = dirname8(dir);
+    const up = dirname10(dir);
     if (up === dir) break;
     dir = up;
   }
@@ -12281,7 +14954,7 @@ function bundledSkillsDir(from) {
 }
 
 // src/plugin/machineCmd.ts
-var BOOLEAN_FLAGS11 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS14 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "global",
@@ -12304,7 +14977,7 @@ function npx() {
 function bundledChromium() {
   try {
     const p = chromium2.executablePath();
-    return p && existsSync22(p) ? p : null;
+    return p && existsSync26(p) ? p : null;
   } catch {
     return null;
   }
@@ -12313,7 +14986,7 @@ function probe2() {
   return probeBrowser({
     platform: process.platform,
     env: process.env,
-    exists: existsSync22,
+    exists: existsSync26,
     bundled: bundledChromium
   });
 }
@@ -12364,7 +15037,7 @@ async function doctorFacts(opts) {
   };
 }
 async function cmdSetup(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS11);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS14);
   const r = reporterFor(flags);
   const root = process.cwd();
   const global = flags.global === true;
@@ -12398,7 +15071,7 @@ async function cmdSetup(argv) {
         const dest = skillsDirFor(home);
         mkdirSync6(dest, { recursive: true });
         for (const name of installedSkills(dir)) {
-          cpSync(join24(dir, name), join24(dest, name), { recursive: true });
+          cpSync(join28(dir, name), join28(dest, name), { recursive: true });
         }
       }
     };
@@ -12466,7 +15139,7 @@ async function cmdSetup(argv) {
   let rules = null;
   if (!noRules) {
     const file = rulesFileFor(root);
-    const existing = existsSync22(file) ? readFileSync11(file, "utf8") : null;
+    const existing = existsSync26(file) ? readFileSync11(file, "utf8") : null;
     const { text, changed } = applyRulesBlock(existing);
     if (changed) writeFileSync6(file, text);
     rules = { file, changed };
@@ -12497,7 +15170,7 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdDoctor(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS11);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS14);
   const r = reporterFor(flags);
   const root = process.cwd();
   const homes = detectAgents(root, { home: homedir2(), global: true });
@@ -12516,7 +15189,7 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdWhoami(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS11);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS14);
   const r = reporterFor(flags);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -12578,9 +15251,9 @@ async function cmdWhoami(argv) {
   return EXIT_OK;
 }
 function cmdLogout(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS11);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS14);
   const r = reporterFor(flags);
-  const had = existsSync22(CREDENTIALS_PATH);
+  const had = existsSync26(CREDENTIALS_PATH);
   rmSync3(CREDENTIALS_PATH, { force: true });
   const envKey = Boolean(process.env.VOS_API_KEY?.trim());
   r.done(
@@ -12596,7 +15269,7 @@ function cmdLogout(argv) {
 }
 
 // src/plugin/run.ts
-var BOOLEAN_FLAGS12 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS15 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "wait",
@@ -12620,19 +15293,29 @@ var BOOLEAN_FLAGS12 = /* @__PURE__ */ new Set([
   "allow-wall",
   "hosted",
   "claimable",
-  "share"
+  "share",
+  "verbose"
+]);
+var MULTI_FLAGS2 = /* @__PURE__ */ new Set([
+  "set",
+  "override",
+  "browser-arg",
+  "header",
+  "confirm"
 ]);
-var MULTI_FLAGS2 = /* @__PURE__ */ new Set(["set", "override", "browser-arg", "header"]);
 var HELP = `vos \u2014 record a browser flow, plan effects, render a product video; sync with vos.so
 
 Take pipeline
-  vos create --actions actions.json [--url <url>] [--out take] [out.webm] [--strict] [--allow-wall] [--keep-frames] [--max-duration <s>] [--storage-state <file>|--session <name>] [--header name=value]... [--browser-arg=<switch>]... [--background <slug|url|none>] [render flags] [--json]
-  vos record --actions actions.json [--url <url>] [--out take] [--strict] [--dry-run] [--allow-wall] [--keep-frames] [--max-duration <s>] [--storage-state <file>|--session <name>] [--header name=value]... [--browser-arg=<switch>]... [--background <slug|url|none>] [--json]
+  vos create --actions actions.json [--url <url>] [--out take] [out.webm] [--strict] [--allow-wall] [--keep-frames] [--max-duration <s>] [--storage-state <file>|--session <name>] [--header name=value]... [--confirm <id>]... [--browser-arg=<switch>]... [--background <slug|url|none>] [render flags] [--json]
+  vos record --actions actions.json [--url <url>] [--out take] [--strict] [--dry-run] [--allow-wall] [--keep-frames] [--max-duration <s>] [--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 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] [--json]
   vos render <take> [out.webm] [--width] [--height] [--fps] [--format webm|mp4] [--parallel N] [--range a..b] [--draft] [--frame <kind>] [--background <url|slug>] [--set <path=value>]... [--json]
-  vos frames <take> [--times 0,25%,50%,75%,100%] [--frame <t>] [--at-zooms] [--at-moments] [--at-still] [--size WxH] [--out dir] [--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)
+  vos check-video <file.mp4|webm> [--out dir] [--strict] [--json]
+            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 brand <url> [--out BRAND.md] [--json]
@@ -12642,6 +15325,10 @@ 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 score <take> --track <slug|file> [--at <step id|output seconds>] [--gain 0..1] [--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
   vos port inventory <page.html|project dir> [--render <their render.mp4>] [--out port] [--json]
             a finished piece (a HyperFrames composition, a Remotion project bundled with its own bundler, a hand-rolled page) read as a browser renders it: words, palette, faces (catalog or missing), media, scenes, gaps \u2192 port/inventory.json, with stills from its render
   vos port scaffold [--from port/inventory.json] [--out port/program] [--json]
@@ -12650,6 +15337,8 @@ Take pipeline
             real functions \u2192 config.json, refusing a module-scope read, syntax the page cannot run and non-JSON data; config.sources.json maps each function to its line
   vos compare <program dir|config.json> --against <their render.mp4> [--times a,b,50%] [--every 1] [--threshold 0.95] [--out compare] [--json]
             per-frame SSIM and source | vos | difference sheets; exit 1 when ANY frame is under the threshold (needs ffmpeg)
+  vos look <url> [--session <name>|--storage-state <file>] [--viewport WxH] [--headed] [--click <selector>]... [--type <selector>=<text>]... [--wait <ms>] [--header name=value]... [--browser-arg=<switch>]... [--out look] [--json]
+            see a page before scripting it, signed in the way vos record would be: <out>/look.png and every control in view with ONE proposed selector (test id, aria-label, role + name, then words in its dialog or landmark), UNIQUE or AMBIGUOUS as the recorder's own engine counts it, plus what the frame exposes. --click/--type run first, in order; a click on a spend or delete word is refused. Exit 4 at a sign-in wall
   vos session open <url> --name <app>   a plain Chrome window on a vos-owned profile; sign in, close it
   vos session check <name> [--url <url>]   headless: does the session still open the page? exit 0/4
   vos session list | rm <name>          what exists and how old; delete one
@@ -12798,11 +15487,25 @@ reuse block NAMES whatever could not follow \u2014 fix by exception, never
 re-cut from scratch. Give steps ids in actions.json so re-timing survives
 script edits.
 
-record --strict exits 2 when any selector was skipped, the page never
-reached networkidle, or the take hit --max-duration (the done event lists
-skipped[] and capped either way). --max-duration defaults to 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.
+record --strict exits 2 when any selector was skipped, an expect never
+held, a click landed on a disabled control, an await timed out, or the
+take hit --max-duration (the done event lists skipped[], disabled[] and
+capped either way). A first load that never reaches networkidle (a page
+holding a socket open) is a warning, navTimeout in the done event, never
+a strict failure. --max-duration defaults to
+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
+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
+meta.outputs[]. 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.
 frames captures PNG stills at OUTPUT times (seconds or % of duration);
 --at-zooms adds every zoom span's apex, --at-moments every digest moment \u2014
 the agent's eyes (--size WxH for an exact size). render
@@ -12920,7 +15623,7 @@ lint-gated, so a bad override fails like a bad doc.json):
                        first ready loop (the house backdrop the studio opens on), or a flat ground offline
 `;
 async function loadActions(file) {
-  const raw = JSON.parse(await readFile13(file, "utf8"));
+  const raw = JSON.parse(await readFile15(file, "utf8"));
   const errors = validateActions(raw);
   if (errors.length)
     throw new UsageError(`invalid actions file:
@@ -12949,7 +15652,10 @@ async function maxDuration(flags, r) {
 }
 function strictReason(rec) {
   const parts = [`${rec.skipped.length} skipped step(s)`];
-  if (rec.navTimeout) parts.push("networkidle timeout");
+  if (rec.disabled?.length)
+    parts.push(`${rec.disabled.length} click(s) on a disabled control`);
+  const timedOut = timedOutAwaits(rec);
+  if (timedOut) parts.push(`${timedOut} await(s) that timed out`);
   if (rec.capped) parts.push("stopped at --max-duration");
   const missed = maskMisses(rec);
   if (missed.length)
@@ -12958,6 +15664,15 @@ function strictReason(rec) {
     );
   return parts.join(" + ");
 }
+function timedOutAwaits(rec) {
+  return (rec.meta?.steps ?? []).filter((s) => s.do === "await" && s.timedOut).length;
+}
+function strictFails(rec) {
+  return rec.skipped.length > 0 || rec.disabled.length > 0 || timedOutAwaits(rec) > 0 || rec.capped || maskMisses(rec).length > 0;
+}
+function navTimeoutNote(rec) {
+  return rec.navTimeout ? "\n  note: the first load never reached networkidle (a page holding a socket open never does); recorded anyway" : "";
+}
 function maskMisses(rec) {
   return (rec.masks ?? []).filter((m) => m.hits === 0).map((m) => m.selector);
 }
@@ -12968,6 +15683,53 @@ function exposureNote(rec) {
 ${rec.exposures.map((e) => `    - ${exposureLine(e)}`).join("\n")}
   ${EXPOSURE_ADVICE}`;
 }
+function takeConfirm(multi, actions, opts) {
+  const given = (multi.confirm ?? []).filter(Boolean);
+  if (opts.dryRun) return given;
+  const verdict = guardVerdict(actions, given);
+  if (!verdict.ok) {
+    const guarded = guardedSteps(actions);
+    for (const id of verdict.unconfirmed)
+      opts.r.event({
+        event: "refused",
+        reason: verdict.message,
+        step: guarded.find((g) => g.id === id)?.step ?? null,
+        id
+      });
+    for (const id of verdict.unknown)
+      opts.r.event({
+        event: "refused",
+        reason: verdict.message,
+        step: null,
+        id
+      });
+    throw new UsageError(verdict.message);
+  }
+  return given;
+}
+function stepReportNote(rec) {
+  const lines = [];
+  if (rec.disabled.length)
+    lines.push(
+      `DISABLED when clicked: ${rec.disabled.map((d) => `#${d.step}${d.id ? ` ${d.id}` : ""} ${d.selector}`).join(", ")} (the press likely did nothing; an expect with enabled: true before it waits for the control)`
+    );
+  if (rec.skips.length)
+    lines.push(
+      `off camera: ${rec.skips.map((s) => `#${s.step}${s.id ? ` ${s.id}` : ""} ${(s.ms / 1e3).toFixed(1)} s, cut at ${s.at.toFixed(2)}s${s.timedOut ? " (timed out)" : ""}`).join(", ")}`
+    );
+  if (rec.outputs.length)
+    lines.push(
+      `outputs/: ${rec.outputs.map((o) => `${o.name} (${o.bytes} bytes)`).join(", ")}`
+    );
+  if (rec.confirmed.length)
+    lines.push(`pressed, as --confirm said: ${rec.confirmed.join(", ")}`);
+  if (rec.stopped) lines.push(`STOPPED: ${rec.stopped.reason}`);
+  return lines.map((l) => `
+  ${l}`).join("");
+}
+function skippedLine(s) {
+  return `#${s.step}${s.id ? ` ${s.id}` : ""} ${s.do}${s.reason ? `: ${s.reason}` : ` ${s.selector}`}`;
+}
 function takeHeaders(multi) {
   try {
     return parseHeaders(multi.header);
@@ -12982,8 +15744,8 @@ function takeBrowserArgs(multi) {
 function takeStorageState(flags) {
   const raw = strFlag(flags, "storage-state");
   if (!raw) return void 0;
-  const path = resolve14(raw);
-  if (!existsSync23(path))
+  const path = resolve18(raw);
+  if (!existsSync27(path))
     throw new UsageError(`--storage-state: no such file: ${path}`);
   return path;
 }
@@ -12996,7 +15758,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 (!existsSync23(sessionDir(name)))
+  if (!existsSync27(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)`
     );
@@ -13052,7 +15814,7 @@ function wallGate(flags, r, opts) {
 async function cmdRecord(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS12,
+    BOOLEAN_FLAGS15,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions") ?? positionals[0];
@@ -13065,14 +15827,18 @@ async function cmdRecord(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const scheme = urlSchemeProblem(url);
+  const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve14(strFlag(flags, "out") ?? "take");
+  const outDir = resolve18(strFlag(flags, "out") ?? "take");
   const storageState = takeStorageState(flags);
   const sessionName = takeSessionName(flags, storageState);
   const browserArgs = takeBrowserArgs(multi);
   const headers = takeHeaders(multi);
+  const confirm = flags.hosted === true ? [] : takeConfirm(multi, actions, {
+    dryRun: flags["dry-run"] === true,
+    r
+  });
   if (flags.hosted === true) {
     if (flags["dry-run"] === true)
       throw new UsageError(
@@ -13082,6 +15848,15 @@ async function cmdRecord(argv) {
       throw new UsageError(
         'a session never reaches vos.so: --hosted takes no --session or --storage-state. Put the sign-in in the setup steps with { "env": "NAME" }, or record here with vos record.'
       );
+    const refusals = hostedRefusals(actions);
+    if (refusals.length)
+      throw new UsageError(
+        `a hosted take cannot run this script: ${refusals.join("; ")}`
+      );
+    if (multi.confirm?.length)
+      throw new UsageError(
+        "--confirm presses a guarded step on this machine; a hosted take runs no guarded step, so drop --hosted to record it here"
+      );
     const origin = platformOrigin({
       origin: strFlag(flags, "origin"),
       api: strFlag(flags, "api")
@@ -13181,6 +15956,8 @@ async function cmdRecord(argv) {
           headers,
           context: context2,
           dryRun: true,
+          verbose: flags.verbose === true,
+          onEvent: (e) => r.event(e),
           // A rehearsal is always strict, and it touches no directory.
           onArrival: wallGate(flags, r, { strict: true })
         })
@@ -13189,9 +15966,28 @@ async function cmdRecord(argv) {
       const lines = steps.map((s) => {
         const rect = s.rect ? `  rect ${s.rect.x},${s.rect.y} ${s.rect.w}\xD7${s.rect.h}` : "";
         const what = s.selector ? ` ${s.selector}` : "";
-        return `  ${s.skipped ? "\u2717" : "\u2713"} #${s.step}${s.id ? ` (${s.id})` : ""} ${s.do}${what}${s.skipped ? "  NOT FOUND" : rect}${s.navigated ? "  \u2192 navigated" : ""}`;
+        const out = rec.outputs.find((o) => o.step === s.step);
+        const notes = [
+          ...rec.disabled.some((d) => d.step === s.step) ? ["DISABLED, pressed anyway"] : [],
+          ...s.guard && !s.skipped ? [`guarded (${s.guard}), hovered, not pressed`] : [],
+          ...s.followsGuard !== void 0 ? [
+            `not waited: it follows #${s.followsGuard} (guarded, not pressed)`
+          ] : [],
+          ...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)`] : []
+        ].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("")}`;
       });
-      const failed = rec.skipped.length > 0 || rec.navTimeout || maskMisses(rec).length > 0;
+      for (const [i, step] of actions.steps.entries())
+        if (!steps.some((s) => s.step === i))
+          lines.push(
+            `  \u2013 #${i}${step.id ? ` (${step.id})` : ""} ${step.do}  not run`
+          );
+      const resolved = steps.filter((s) => !s.skipped).length;
+      const failed = strictFails(rec) || rec.stopped !== null;
+      const unconfirmed = guardVerdict(actions, confirm);
       const carried = [
         ...strFlag(flags, "storage-state") ? [`--storage-state ${strFlag(flags, "storage-state")}`] : [],
         ...browserArgs.map((a) => `--browser-arg=${a}`),
@@ -13199,9 +15995,11 @@ async function cmdRecord(argv) {
         // printed.
         ...Object.keys(headers).map((k) => `--header ${k}=\u2026`),
         ...sessionName ? [`--session ${sessionName}`] : [],
-        ...flags["allow-wall"] === true ? ["--allow-wall"] : []
+        ...flags["allow-wall"] === true ? ["--allow-wall"] : [],
+        ...confirm.map((c) => `--confirm ${c}`)
       ].join(" ");
       const nextOut = strFlag(flags, "out") ?? "take";
+      const guardNote = !unconfirmed.ok ? unconfirmed.unconfirmed.length ? ` (it refuses until you add ${unconfirmed.unconfirmed.map((id) => `--confirm ${id}`).join(" ")}: ${unconfirmed.unconfirmed.length === 1 ? "that step spends" : "those steps spend"} something real)` : ` (${unconfirmed.unknown.map((c) => `--confirm ${c}`).join(", ")} names no guarded step)` : "";
       r.done(
         {
           dryRun: true,
@@ -13209,28 +16007,33 @@ async function cmdRecord(argv) {
           seconds: +((Date.now() - started) / 1e3).toFixed(1),
           steps,
           skipped: rec.skipped,
+          disabled: rec.disabled,
+          skips: rec.skips,
+          outputs: rec.outputs,
+          pageErrors: rec.pageErrors,
+          ...rec.stopped ? { stopped: rec.stopped } : {},
           navTimeout: rec.navTimeout,
           exposures: rec.exposures,
           masks: rec.masks
         },
-        `${failed ? "REHEARSAL FAILED" : "Rehearsal passed"}: ${steps.length - rec.skipped.length}/${steps.length} steps resolved in ${((Date.now() - started) / 1e3).toFixed(1)}s${rec.navTimeout ? " (the first load never reached networkidle)" : ""}
+        `${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)" : ""}
 ${lines.join("\n")}
-  ${maskMisses(rec).length ? `MASK hid nothing: ${maskMisses(rec).join(", ")} (the selector reached no element). ` : ""}${failed ? "Fix the script, rehearse again, then record." : `Rects are capture px (the step rects a pin or a callout reads). Next: vos record --actions ${actionsPath} --out ${nextOut}${carried ? ` ${carried}` : ""} --strict`}${exposureNote(rec)}`
+  ${maskMisses(rec).length ? `MASK hid nothing: ${maskMisses(rec).join(", ")} (the selector reached no element). ` : ""}${rec.stopped ? `STOPPED: ${rec.stopped.reason}. ` : ""}${failed ? "Fix the script, rehearse again, then record." : `Rects are capture px (the step rects a pin or a callout reads). Next: vos record --actions ${actionsPath} --out ${nextOut}${carried ? ` ${carried}` : ""} --strict${guardNote}`}${exposureNote(rec)}`
       );
-      return failed ? EXIT_USAGE : EXIT_OK;
+      return rec.stopped ? EXIT_ERROR : failed ? EXIT_USAGE : EXIT_OK;
     } finally {
       await browser2.close();
     }
   }
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync23(join25(outDir, "meta.json"))) {
+    if (existsSync27(join29(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" : "")
       );
     }
-    await mkdir8(outDir, { recursive: true });
+    await mkdir13(outDir, { recursive: true });
     await ensureTakeDir(outDir);
   };
   const browser = await launchBrowser(browserArgs);
@@ -13245,6 +16048,9 @@ ${lines.join("\n")}
         storageState,
         headers,
         context: context2,
+        confirm,
+        verbose: flags.verbose === true,
+        onEvent: (e) => r.event(e),
         onArrival: wallGate(flags, r, {
           strict: flags.strict === true,
           prepare
@@ -13263,9 +16069,29 @@ ${lines.join("\n")}
     const plan = await planTake(outDir, { backdrop });
     const clicks = rec.events.filter((e) => e.type === "down").length;
     const strict = flags.strict === true;
-    const strictFail = strict && (rec.skipped.length > 0 || rec.navTimeout || rec.capped || maskMisses(rec).length > 0);
+    const strictFail = strict && strictFails(rec);
     const skippedNote = rec.skipped.length ? `
-  SKIPPED ${rec.skipped.length} step(s): ${rec.skipped.map((s) => `#${s.step} ${s.do} ${s.selector}`).join(", ")}` : "";
+  SKIPPED ${rec.skipped.length} step(s): ${rec.skipped.map(skippedLine).join(", ")}` : "";
+    const stepNote = stepReportNote(rec);
+    if (rec.stopped) {
+      r.done(
+        {
+          take: outDir,
+          ok: false,
+          stopped: rec.stopped,
+          durationMs: rec.meta.durationMs,
+          skipped: rec.skipped,
+          disabled: rec.disabled,
+          confirmed: rec.confirmed,
+          skips: rec.skips,
+          outputs: rec.outputs,
+          pageErrors: rec.pageErrors
+        },
+        `FAILED: ${rec.stopped.reason}.
+  The footage up to it is in ${outDir}.${skippedNote}${stepNote}${navTimeoutNote(rec)}`
+      );
+      return EXIT_ERROR;
+    }
     r.done(
       {
         take: outDir,
@@ -13285,11 +16111,16 @@ ${lines.join("\n")}
         ...rec.wall ? { wall: rec.wall } : {},
         exposures: rec.exposures,
         ...rec.masks.length ? { masks: rec.masks } : {},
+        disabled: rec.disabled,
+        confirmed: rec.confirmed,
+        skips: rec.skips,
+        outputs: rec.outputs,
+        pageErrors: rec.pageErrors,
         ...strictFail ? { strictFailed: true } : {}
       },
-      strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}${exposureNote(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}
-  Next: edit ${join25(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}`
+      strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}${stepNote}${navTimeoutNote(rec)}${exposureNote(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)}
+  Next: edit ${join29(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -13299,7 +16130,7 @@ ${lines.join("\n")}
 async function cmdCreate2(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS12,
+    BOOLEAN_FLAGS15,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions");
@@ -13313,12 +16144,12 @@ async function cmdCreate2(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const scheme = urlSchemeProblem(url);
+  const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve14(strFlag(flags, "out") ?? "take");
+  const outDir = resolve18(strFlag(flags, "out") ?? "take");
   const format = videoFormat(strFlag(flags, "format"), positionals[0]);
-  const out = positionals[0] ?? join25(outDir, `out.${format}`);
+  const out = positionals[0] ?? join29(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");
@@ -13329,15 +16160,16 @@ async function cmdCreate2(argv) {
   const sessionName = takeSessionName(flags, storageState);
   const browserArgs = takeBrowserArgs(multi);
   const headers = takeHeaders(multi);
+  const confirm = takeConfirm(multi, actions, { dryRun: false, r });
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync23(join25(outDir, "meta.json"))) {
+    if (existsSync27(join29(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" : "")
       );
     }
-    await mkdir8(outDir, { recursive: true });
+    await mkdir13(outDir, { recursive: true });
     await ensureTakeDir(outDir);
   };
   const browser = await launchBrowser(browserArgs);
@@ -13352,6 +16184,9 @@ async function cmdCreate2(argv) {
         storageState,
         headers,
         context: context2,
+        confirm,
+        verbose: flags.verbose === true,
+        onEvent: (e) => r.event(e),
         onArrival: wallGate(flags, r, {
           strict: flags.strict === true,
           prepare
@@ -13368,11 +16203,25 @@ async function cmdCreate2(argv) {
     await releaseFrames(paths, flags, r.log);
     r.event({ event: "phase", phase: "plan" });
     await planTake(outDir, { backdrop });
-    if (flags.strict === true && (rec.skipped.length > 0 || rec.navTimeout || rec.capped || maskMisses(rec).length > 0)) {
+    if (rec.stopped) {
+      r.done(
+        {
+          take: outDir,
+          ok: false,
+          stopped: rec.stopped,
+          skipped: rec.skipped,
+          rendered: false
+        },
+        `FAILED: ${rec.stopped.reason}. NOT rendering; the footage up to it is in ${outDir}.`
+      );
+      return EXIT_ERROR;
+    }
+    if (flags.strict === true && strictFails(rec)) {
       r.done(
         {
           take: outDir,
           skipped: rec.skipped,
+          disabled: rec.disabled,
           navTimeout: rec.navTimeout,
           capped: rec.capped,
           strictFailed: true,
@@ -13415,20 +16264,26 @@ async function cmdCreate2(argv) {
         dead: rec.dead,
         exposures: rec.exposures,
         ...rec.masks.length ? { masks: rec.masks } : {},
+        disabled: rec.disabled,
+        confirmed: rec.confirmed,
+        skips: rec.skips,
+        outputs: rec.outputs,
+        pageErrors: rec.pageErrors,
         ...flags.draft === true ? { draft: true } : {}
       },
       `Created ${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" : ""}${flags.draft === true ? ", DRAFT" : ""})
-  take: ${outDir} \u2014 inspect with: vos frames ${outDir} --at-zooms; edit doc.json and re-render with: vos render ${outDir}${exposureNote(rec)}`
+  take: ${outDir} \u2014 inspect with: vos frames ${outDir} --at-zooms; edit doc.json and re-render with: vos render ${outDir}${stepReportNote(rec)}${navTimeoutNote(rec)}${exposureNote(rec)}`
     );
     return EXIT_OK;
   } finally {
     await browser.close();
   }
 }
-async function cmdPlan(argv) {
+async function cmdPlan(argvIn) {
+  const argv = bareCaptionsFlag(argvIn);
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS12,
+    BOOLEAN_FLAGS15,
     /* @__PURE__ */ new Set(["with"])
   );
   const dir = positionals[0];
@@ -13438,26 +16293,28 @@ async function cmdPlan(argv) {
     );
   const r = createReporter(flags.json === true);
   if (flags.fresh === true) {
-    await rm2(join25(dir, "doc.json"), { force: true });
+    await rm5(join29(dir, "doc.json"), { force: true });
     r.log("note: --fresh discarded the existing doc.json");
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve14(strFlag(flags, "from") ?? join25(dir, PREV_DOC_NAME));
-    if (!existsSync23(from)) {
+    const from = resolve18(strFlag(flags, "from") ?? join29(dir, PREV_DOC_NAME));
+    if (!existsSync27(from)) {
       throw new UsageError(
         `--reuse: ${from} does not exist \u2014 a re-record into this take writes doc.prev.json, or pass --from <doc.json>`
       );
     }
     reuse = {
       from,
-      doc: JSON.parse(await readFile13(from, "utf8"))
+      doc: JSON.parse(await readFile15(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const hasDoc = existsSync23(join25(dir, "doc.json"));
+  const hasDoc = existsSync27(join29(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";
+  if (stepCaptions) release.launchRoles.captions = "none";
   const motionWanted = !hasDoc || flags.motion === true || flags.fresh === true;
   const stillRaw = strFlag(flags, "still") ?? release.launchRoles.still;
   const still = stillRaw === void 0 ? null : Number(stillRaw);
@@ -13485,6 +16342,16 @@ async function cmdPlan(argv) {
       }
     } : {}
   });
+  let captions = null;
+  if (stepCaptions) {
+    const take = await loadTake(dir);
+    captions = landStepCaptions(s.doc, /* @__PURE__ */ new Map([["", take.actions]]));
+    await writeJson(take.paths.doc, s.doc, true);
+  }
+  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 ? `
+  no step in ${captions.uncaptioned.length === 1 && captions.uncaptioned[0] === "" ? "this take" : captions.uncaptioned.map((m) => m ? `media ${m}` : "the primary").join(", ")} carries a caption` : "") : "";
   const layoutLines = s.layout ? `
   layout from ${s.styleFrom}: ${[
     s.layout.clips.length ? `${s.layout.clips.length} stage clip(s)` : "",
@@ -13501,7 +16368,7 @@ async function cmdPlan(argv) {
     ${s.reuse.flagged.join("\n    ")}` : "") : "";
   r.done(
     {
-      take: resolve14(dir),
+      take: resolve18(dir),
       fresh: s.fresh,
       cursorKept: s.cursorKept,
       zoomAuto: s.zoomAuto,
@@ -13511,9 +16378,10 @@ async function cmdPlan(argv) {
       ...s.styleFrom ? { styleFrom: s.styleFrom, styleFields: s.styleFields } : {},
       ...s.layout ? { layout: s.layout } : {},
       ...s.motion ? { motion: s.motion } : {},
-      ...s.reuse ? { reuse: s.reuse } : {}
+      ...s.reuse ? { reuse: s.reuse } : {},
+      ...captions ? { captions } : {}
     },
-    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join25(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}`
+    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join29(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}${captionLines}`
   );
   return EXIT_OK;
 }
@@ -13626,7 +16494,7 @@ async function releaseInputs(dir, flags, r, withRefs = []) {
 async function cmdRender(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS12,
+    BOOLEAN_FLAGS15,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -13636,7 +16504,7 @@ async function cmdRender(argv) {
     );
   const r = createReporter(flags.json === true);
   const format = videoFormat(strFlag(flags, "format"), positionals[1]);
-  const out = positionals[1] ?? join25(dir, `out.${format}`);
+  const out = positionals[1] ?? join29(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");
@@ -13694,7 +16562,7 @@ async function cmdRender(argv) {
 async function cmdFrames(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS12,
+    BOOLEAN_FLAGS15,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -13712,12 +16580,13 @@ 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 = docOutputDuration3(take.doc);
+  const duration = docOutputDuration4(take.doc);
   const frameRaw = strFlag(flags, "frame");
   const timesRaw = strFlag(flags, "times");
   const atZooms = flags["at-zooms"] === true;
   const atMoments = flags["at-moments"] === true;
   const atStill = flags["at-still"] === true;
+  const strict = flags.strict === true;
   let times;
   try {
     times = frameRaw !== void 0 ? parseTimes2(frameRaw, duration) : timesRaw !== void 0 ? parseTimes2(timesRaw, duration) : atZooms || atMoments ? [] : parseTimes2("0,25%,50%,75%,100%", duration);
@@ -13747,6 +16616,13 @@ async function cmdFrames(argv) {
       }
     });
     const index = await writeIndexJson(result);
+    for (const z of result.skippedZooms ?? [])
+      r.warn(
+        `zoom ${z.id}${z.media ? ` (media ${z.media})` : ""} has no apex to still: ${z.reason}`
+      );
+    const unrendered = result.frames.filter((f) => f.rendered === false);
+    for (const f of unrendered) r.warn(unrenderedZoomLine(f));
+    const zoomTag = (f) => `${f.zoomId ? ` ${f.zoomId}` : ""}${f.media ? ` on ${f.media}` : ""}${f.rendered === false ? ", DID NOT RENDER" : ""}`;
     r.done(
       {
         outDir: result.outDir,
@@ -13754,12 +16630,14 @@ async function cmdFrames(argv) {
         width: result.width,
         height: result.height,
         duration: result.duration,
-        frames: result.frames
+        frames: result.frames,
+        ...result.skippedZooms ? { skippedZooms: result.skippedZooms } : {},
+        ...atZooms ? { unrenderedZooms: unrendered.length } : {}
       },
       `Wrote ${result.frames.length} still(s) to ${result.outDir} (${result.width}x${result.height})
-  ${result.frames.map((f) => `${f.time.toFixed(2)}s${f.kind === "zoom" ? " [zoom apex]" : f.kind === "moment" ? ` [${f.momentId}]` : ""} \u2192 ${f.file}`).join("\n  ")}`
+  ${result.frames.map((f) => `${f.time.toFixed(2)}s${f.kind === "zoom" ? ` [zoom apex${zoomTag(f)}]` : f.kind === "moment" ? ` [${f.momentId}]` : ""} \u2192 ${f.file}`).join("\n  ")}`
     );
-    return EXIT_OK;
+    return unrendered.length && strict ? EXIT_USAGE : EXIT_OK;
   } finally {
     await browser.close();
   }
@@ -13767,7 +16645,7 @@ async function cmdFrames(argv) {
 async function cmdDeliver(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS12,
+    BOOLEAN_FLAGS15,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -13867,15 +16745,15 @@ async function resolveStyleRef(flags) {
 }
 async function resolveDocRef(ref, flags, what) {
   const styleRef = ref;
-  const file = existsSync23(styleRef) ? resolve14(
+  const file = existsSync27(styleRef) ? resolve18(
     styleRef,
-    existsSync23(join25(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync27(join29(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync23(file)) {
+  if (file && existsSync27(file)) {
     return {
       from: file,
       doc: migrateHostedDoc4(
-        JSON.parse(await readFile13(file, "utf8"))
+        JSON.parse(await readFile15(file, "utf8"))
       )
     };
   }
@@ -13917,7 +16795,7 @@ async function officialTemplate(origin, ref) {
   }
 }
 async function cmdDigest(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS15);
   const dir = positionals[0];
   if (!dir)
     throw new UsageError(
@@ -13927,7 +16805,7 @@ async function cmdDigest(argv) {
   const take = await loadTake(dir);
   if (!take.doc) throw new UsageError(`${dir} has no doc.json \u2014 run plan first`);
   const transcriptPath = strFlag(flags, "transcript");
-  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile13(transcriptPath, "utf8"))) : null;
+  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile15(transcriptPath, "utf8"))) : null;
   const style = await resolveStyleRef(flags);
   const noFrames = flags["no-frames"] === true;
   let browser = null;
@@ -13958,7 +16836,7 @@ async function cmdDigest(argv) {
         kinds,
         frames: d.images.full,
         crops: d.images.crop,
-        sheet: d.images.sheet ? join25(result.outDir, d.images.sheet) : null,
+        sheet: d.images.sheet ? join29(result.outDir, d.images.sheet) : null,
         scenes: kinds.scene ?? 0,
         sourceDuration: d.take.sourceDuration,
         outputDuration: d.take.outputDuration,
@@ -13981,19 +16859,19 @@ async function cmdDigest(argv) {
   }
 }
 async function cmdOpen(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS15);
   const dir = positionals[0];
   if (!dir) throw new UsageError("vos open <take> [--studio <url>]");
   const r = createReporter(flags.json === true);
   const take = await loadTake(dir);
-  if (!existsSync23(take.paths.recording)) {
+  if (!existsSync27(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(resolve14(dir), {});
+  const server = await startTakeServer(resolve18(dir), {});
   const url = `${studio}/studio?take=${encodeURIComponent(server.base)}`;
   r.event({ event: "open", server: server.base, url });
   r.log(`take served at ${server.base}`);
@@ -14016,7 +16894,7 @@ async function cmdOpen(argv) {
   return EXIT_OK;
 }
 async function cmdCallout(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS15);
   const dir = positionals[0];
   const shape = positionals[1];
   if (!dir || !shape || !isCalloutShape(shape))
@@ -14040,7 +16918,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 readFile13(codeFile, "utf8") : strFlag(flags, "code");
+  const code = codeFile ? await readFile15(codeFile, "utf8") : strFlag(flags, "code");
   const words2 = {
     kicker: strFlag(flags, "kicker"),
     title: strFlag(flags, "title"),
@@ -14115,11 +16993,11 @@ async function cmdCallout(argv) {
   return EXIT_OK;
 }
 async function cmdValidate(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS15);
   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 : existsSync23(join25(target, "kit.json")) && !isTakeDir(target) ? join25(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync27(join29(target, "kit.json")) && !isTakeDir(target) ? join29(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -14151,9 +17029,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync23(join25(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync27(join29(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile13(join25(target, "config.json"), "utf8")
+      await readFile15(join29(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -14194,7 +17072,8 @@ async function cmdValidate(argv) {
   const take = await loadTake(target);
   const problems = [];
   const warnings = [];
-  if (!existsSync23(take.paths.recording)) {
+  const notes = [];
+  if (!existsSync27(take.paths.recording)) {
     problems.push("missing recording (re-run record)");
   } else {
     const mismatch = containerMismatch(
@@ -14220,6 +17099,7 @@ async function cmdValidate(argv) {
     const lint = lintDoc(take.doc);
     problems.push(...lint.problems.map((p) => `doc.json: ${p}`));
     warnings.push(...lint.warnings.map((w) => `doc.json: ${w}`));
+    notes.push(...(lint.notes ?? []).map((n) => `doc.json: ${n}`));
     const probe3 = mediaProbeLints(
       await probeMediaUrls(collectDocMediaUrls(take.doc))
     );
@@ -14258,26 +17138,37 @@ async function cmdValidate(argv) {
   }
   if (problems.length) {
     r.done(
-      { valid: false, target, problems, warnings },
+      {
+        valid: false,
+        target,
+        problems,
+        warnings,
+        ...notes.length ? { notes } : {}
+      },
       `${target}:
   ${problems.join("\n  ")}${warnings.length ? `
   warnings:
-  ${warnings.join("\n  ")}` : ""}`
+  ${warnings.join("\n  ")}` : ""}${notes.length ? `
+  notes:
+  ${notes.join("\n  ")}` : ""}`
     );
     return EXIT_ERROR;
   }
+  const noteLines = notes.length ? `
+  notes:
+  ${notes.join("\n  ")}` : "";
   r.done(
-    { valid: true, target, warnings },
+    { valid: true, target, warnings, ...notes.length ? { notes } : {} },
     `${target}: take is complete and renderable${warnings.length ? `
   warnings:
-  ${warnings.join("\n  ")}` : ""}`
+  ${warnings.join("\n  ")}` : ""}${noteLines}`
   );
   return EXIT_OK;
 }
 async function cmdPush3(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS12,
+    BOOLEAN_FLAGS15,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -14287,7 +17178,7 @@ async function cmdPush3(argv) {
     );
   const refusal = takePushRefusal({
     vos: strFlag(flags, "vos"),
-    trackedVosId: readSyncState(resolve14(dir))?.vosId ?? null,
+    trackedVosId: readSyncState(resolve18(dir))?.vosId ?? null,
     programOnly: ["slug", "desc", "tags", "base", "remix-of", "still"].filter(
       (name) => hasFlag(flags, name)
     )
@@ -14303,7 +17194,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(
-      resolve14(dir),
+      resolve18(dir),
       {
         api: strFlag(flags, "api"),
         origin: strFlag(flags, "origin"),
@@ -14325,7 +17216,7 @@ reference and the only credential.`
   }
   const overrides = multi.override;
   const result = await pushTake(
-    resolve14(dir),
+    resolve18(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -14375,11 +17266,11 @@ ${landedLines(landed)}` : "")
   return EXIT_OK;
 }
 async function cmdPull2(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12, MULTI_FLAGS2);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS15, MULTI_FLAGS2);
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
-    resolve14(dir),
+    resolve18(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -14511,6 +17402,14 @@ async function run(argv) {
         return await cmdActions(rest);
       case "ingest":
         return await cmdIngest(rest);
+      case "check-video":
+        return await cmdCheckVideo(rest);
+      case "join":
+        return await cmdJoin(rest);
+      case "score":
+        return await cmdScore(rest);
+      case "look":
+        return await cmdLook(rest);
       default:
         throw new UsageError(`unknown command "${cmd}" \u2014 run: vos help`);
     }
@@ -14520,7 +17419,7 @@ async function run(argv) {
 `);
       return EXIT_USAGE;
     }
-    if (e instanceof SetupError || e instanceof SetupEnvError) {
+    if (e instanceof SetupError || e instanceof SetupEnvError || e instanceof RecordRefusedError) {
       process.stderr.write(`${e.message}
 `);
       return EXIT_USAGE;
@@ -14543,7 +17442,7 @@ async function run(argv) {
   }
 }
 async function cmdSession(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS15);
   const [sub, arg] = positionals;
   const r = createReporter(flags.json === true);
   const usage = "vos session open <url> --name <app> | check <name> [--url <url>] | list | rm <name>";
@@ -14579,7 +17478,7 @@ async function cmdSession(argv) {
       if (!arg) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync23(sessionDir(arg)))
+      if (!existsSync27(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const summary3 = await summarizeSession(arg);
       const url = strFlag(flags, "url");
@@ -14674,9 +17573,10 @@ export {
   convertAgentBrowser,
   MULTI_FLAGS2 as MULTI_FLAGS,
   HELP,
+  strictFails,
   takeBrowserArgs,
   takeBackdrop,
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-SB622PZM.js.map
+//# sourceMappingURL=chunk-INRUYQ6J.js.map