@vosjs/cli 0.59.0 → 0.60.0

package/dist/{chunk-67L7FPJR.js → chunk-NE5MHC3D.js}

@@ -1,42 +1,70 @@
 #!/usr/bin/env node
 import {
   BrowserUnavailableError,
+  configDuration,
+  directoryKind,
+  launchBrowser,
+  loadVosConfig,
+  parseTimes,
+  reencodeStill,
+  renderStill,
+  videoFormat
+} from "./chunk-OMDRILG7.js";
+import {
+  PREV_DOC_NAME,
+  RECORDING_NAME,
+  docAudioRefs,
+  docLayerRefs,
+  docMediaRefs,
+  dropScreencastFrames,
+  ensureTakeDir,
+  hostedLiteralWarnings,
+  isTakeRelativeKey,
+  loadTake,
+  localManifestRefs,
+  prepareReRecord,
+  pullManifest,
+  pullMedia,
+  readJson,
+  readMediaHead,
+  sourceSidecarRefs,
+  takeMediaFile,
+  takePaths,
+  uploadAsset,
+  uploadDocRefs,
+  uploadManifest,
+  writeJson
+} from "./chunk-PUXY32AP.js";
+import {
   CREDENTIALS_PATH,
   MEDIA_HEAD_BYTES,
   SYNC_STATE_NAME,
-  TAKE_MEDIA_EXTENSIONS,
   UsageError,
   apiError,
   apiJson,
   clientId,
-  configDuration,
   containerMismatch,
   deriveSlug,
-  directoryKind,
-  extensionFor,
   formatChanges,
   hasFlag,
-  launchBrowser,
-  loadVosConfig,
+  hostedAssetId,
+  manifestRefs,
   nameForType,
   numFlag2 as numFlag,
   parseArgs2 as parseArgs,
-  parseTimes,
   parseVosId,
   platformOrigin,
+  programAssets,
   readSyncState,
-  reencodeStill,
-  renderStill,
   requireCredential,
   resolveCredential,
   resolveMediaType,
   serverWarnings,
   sniffMediaType,
   strFlag,
-  videoFormat,
   writeCredential,
   writeSyncState
-} from "./chunk-YC3LY4LW.js";
+} from "./chunk-36P5RREC.js";
 import {
   deadLine,
   deadWarns
@@ -98,9 +126,9 @@ function landedLines(l) {
 }
 
 // src/plugin/run.ts
-import { mkdir as mkdir11, readFile as readFile17, rm as rm5 } from "fs/promises";
-import { existsSync as existsSync24 } from "fs";
-import { join as join28, resolve as resolve15 } from "path";
+import { mkdir as mkdir9, readFile as readFile15, rm as rm3 } from "fs/promises";
+import { existsSync as existsSync23 } from "fs";
+import { join as join26, resolve as resolve15 } from "path";
 import {
   END_CARD_FROM as END_CARD_FROM2,
   docOutputDuration as docOutputDuration3,
@@ -176,6 +204,7 @@ import {
   pinCandidates,
   pinRectOnScreen,
   pinReferent,
+  parseEmphasis,
   ratedSegments,
   recommendedExportResolution,
   resolvePins,
@@ -479,6 +508,23 @@ function lintDoc(docIn) {
       if (z.focusMode !== void 0 && z.focusMode !== "manual" && z.focusMode !== "auto") {
         problems.push(`${name}: focusMode must be 'manual' or 'auto'`);
       }
+      if (z.screen !== void 0) {
+        const sp = z.screen;
+        const ok = !!sp && typeof sp === "object" && isNum(sp.x) && isNum(sp.y) && sp.x >= 0 && sp.x <= 1 && sp.y >= 0 && sp.y <= 1;
+        if (!ok) {
+          problems.push(
+            `${name}: screen must be { x, y } in 0..1 \u2014 where the target lands as FRACTIONS of the frame (0.35, 0.5 = a third across, centred), not pixels`
+          );
+        } else if (z.focusMode === "auto") {
+          warnings.push(
+            `${name}: screen is ignored on a span that follows the cursor (focusMode 'auto'); drop one or the other`
+          );
+        } else if (cameraModel(doc.frame) !== "stage") {
+          warnings.push(
+            `${name}: screen places the target under the stage camera only (frame.camera: 'stage'); the magnifier keeps the target where it is`
+          );
+        }
+      }
       if (z.source !== void 0 && z.source !== "manual" && z.source !== "auto") {
         problems.push(`${name}: source must be 'manual' or 'auto'`);
       }
@@ -1000,6 +1046,23 @@ function lintDoc(docIn) {
           `${name}.preset "${String(o.preset)}" is not a known preset (${PRESETS.join("|")}) \u2014 falls back to "title"`
         );
       }
+      if (o.emphasis !== void 0) {
+        const em = o.emphasis;
+        if (!em || typeof em !== "object" || Array.isArray(em)) {
+          problems.push(
+            `${name}.emphasis must be { weight?, color? } ({} turns *markers* on)`
+          );
+        } else {
+          if (em.weight !== void 0 && (!isNum(em.weight) || em.weight < 100 || em.weight > 900))
+            problems.push(`${name}.emphasis.weight must be 100..900`);
+          if (em.color !== void 0 && typeof em.color !== "string")
+            problems.push(`${name}.emphasis.color must be a CSS colour`);
+        }
+      } else if (typeof o.text === "string" && parseEmphasis(o.text) !== null) {
+        warnings.push(
+          `${name}.text has *marked* words but no emphasis, so the asterisks show as typed; add emphasis: {} to set them bold (\\* keeps one literal)`
+        );
+      }
       if (o.size !== void 0 && (!isNum(o.size) || o.size < 12 || o.size > 200)) {
         problems.push(`${name}.size must be design px in 12..200`);
       }
@@ -1632,7 +1695,13 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
       }
       const rect = { x: x0, y: y0, w: x1 - x0, h: y1 - y0 };
       if (!zoomCoversRect(
-        { level: z.level, cx: z.cx, cy: z.cy },
+        {
+          level: z.level,
+          cx: z.cx,
+          cy: z.cy,
+          screen: z.screen,
+          focusMode: z.focusMode
+        },
         rect,
         layout,
         0.02,
@@ -1772,535 +1841,6 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
   }
 }
 
-// src/plugin/media.ts
-import { isKeyedOverlay } from "@vosjs/studio-core";
-import { createHash } from "crypto";
-import { createWriteStream, existsSync as existsSync2 } from "fs";
-import {
-  mkdir as mkdir2,
-  open,
-  readFile as readFile2,
-  readdir,
-  rename as rename2,
-  rm as rm2,
-  stat,
-  writeFile as writeFile2
-} from "fs/promises";
-import { basename as basename2, dirname, join as join2 } from "path";
-import { Readable } from "stream";
-import { pipeline } from "stream/promises";
-
-// src/plugin/take.ts
-import { mkdir, readFile, rename, rm, writeFile } from "fs/promises";
-import { existsSync, readdirSync, statSync } from "fs";
-import { basename, join } from "path";
-var RECORDING_NAME = "recording.webm";
-function takeMediaFiles(dir, stem) {
-  return TAKE_MEDIA_EXTENSIONS.map((ext) => join(dir, `${stem}${ext}`)).filter(
-    (file) => existsSync(file)
-  );
-}
-function takeMediaFile(dir, stem, fallback) {
-  return takeMediaFiles(dir, stem)[0] ?? join(dir, fallback);
-}
-var PREV_DOC_NAME = "doc.prev.json";
-function takePaths(dir) {
-  const recording = takeMediaFile(dir, "recording", RECORDING_NAME);
-  return {
-    dir,
-    recording,
-    recordingName: basename(recording),
-    framesDir: join(dir, "frames"),
-    framesIndex: join(dir, "frames.json"),
-    cursor: join(dir, "cursor.json"),
-    meta: join(dir, "meta.json"),
-    actions: join(dir, "actions.json"),
-    doc: join(dir, "doc.json")
-  };
-}
-async function ensureTakeDir(dir) {
-  const p = takePaths(dir);
-  await mkdir(p.framesDir, { recursive: true });
-  return p;
-}
-async function dropScreencastFrames(p) {
-  if (!existsSync(p.recording) || statSync(p.recording).size === 0) return 0;
-  if (!existsSync(p.framesDir)) return 0;
-  let freed = 0;
-  for (const name of readdirSync(p.framesDir)) {
-    try {
-      freed += statSync(join(p.framesDir, name)).size;
-    } catch {
-    }
-  }
-  await rm(p.framesDir, { recursive: true, force: true });
-  await rm(p.framesIndex, { force: true });
-  return freed;
-}
-async function prepareReRecord(dir) {
-  const p = takePaths(dir);
-  const kept = [];
-  let prevDoc = false;
-  if (existsSync(p.doc)) {
-    await rename(p.doc, join(dir, PREV_DOC_NAME));
-    prevDoc = true;
-    kept.push(PREV_DOC_NAME);
-  }
-  if (existsSync(p.actions)) kept.push("actions.json");
-  if (existsSync(join(dir, "vos.json"))) kept.push("vos.json");
-  for (const stale of [
-    // Every container, not just the one `record` writes: a pulled take's
-    // footage may be mp4, and a survivor would outrank the new recording.
-    ...takeMediaFiles(dir, "recording"),
-    ...takeMediaFiles(dir, "mic"),
-    ...takeMediaFiles(dir, "cam"),
-    p.cursor,
-    p.meta,
-    p.framesIndex,
-    p.framesDir,
-    join(dir, "stills"),
-    join(dir, "digest")
-  ]) {
-    await rm(stale, { recursive: true, force: true });
-  }
-  return { prevDoc, kept };
-}
-async function readJson(file) {
-  return JSON.parse(await readFile(file, "utf8"));
-}
-async function writeJson(file, value, pretty = false) {
-  await writeFile(
-    file,
-    pretty ? JSON.stringify(value, null, 2) : JSON.stringify(value)
-  );
-}
-async function loadTake(dir) {
-  const paths = takePaths(dir);
-  if (!existsSync(paths.meta)) {
-    throw new Error(
-      `${dir} is not a take directory (missing meta.json) \u2014 run record first`
-    );
-  }
-  const meta = await readJson(paths.meta);
-  const cursor = existsSync(paths.cursor) ? await readJson(paths.cursor) : [];
-  const actions = existsSync(paths.actions) ? await readJson(paths.actions) : null;
-  const doc = existsSync(paths.doc) ? await readJson(paths.doc) : null;
-  return { paths, cursor, meta, actions, doc };
-}
-
-// src/plugin/uploadAsset.ts
-var SINGLE_SHOT_MAX_BYTES = 32 * 1024 * 1024;
-var PART_ATTEMPTS = 3;
-function planParts(totalBytes, partBytes) {
-  if (totalBytes <= 0 || partBytes <= 0) return [];
-  const parts = [];
-  for (let start = 0; start < totalBytes; start += partBytes) {
-    parts.push({
-      partNumber: parts.length + 1,
-      start,
-      end: Math.min(start + partBytes, totalBytes)
-    });
-  }
-  return parts;
-}
-function failed(what, r) {
-  const detail = typeof r.body.error === "string" ? r.body.error : "";
-  return new Error(`${what} (${r.status})${detail ? `: ${detail}` : ""}`);
-}
-function asAsset(body) {
-  return {
-    id: String(body.id),
-    url: String(body.url),
-    size: typeof body.size === "number" ? body.size : 0,
-    reused: body.reused === true
-  };
-}
-function transient(status) {
-  return status >= 500 || status === 429;
-}
-var wait = (ms) => new Promise((r) => setTimeout(r, ms));
-async function uploadAsset(target, bytes, opts) {
-  if (bytes.length > SINGLE_SHOT_MAX_BYTES && opts.folderId) {
-    throw new Error(
-      `${opts.filename} is over ${SINGLE_SHOT_MAX_BYTES / 1024 / 1024} MB, and a file that large cannot be filed into a project on upload yet. Push it without --folder and reference it from a document, which keeps it`
-    );
-  }
-  return bytes.length > SINGLE_SHOT_MAX_BYTES ? uploadInParts(target, bytes, opts) : uploadWhole(target, bytes, opts);
-}
-async function uploadWhole(target, bytes, opts) {
-  const res = await apiJson(target.origin, "/api/assets/recording", {
-    method: "POST",
-    key: target.key,
-    headers: {
-      "Content-Type": opts.contentType,
-      "Content-Length": String(bytes.length),
-      "X-Filename": opts.filename,
-      "X-Content-Hash": opts.contentHash,
-      ...opts.durationSeconds && opts.durationSeconds > 0 ? { "X-Content-Duration": opts.durationSeconds.toFixed(3) } : {},
-      ...opts.folderId ? { "X-Folder-Id": opts.folderId } : {}
-    },
-    raw: bytes
-  });
-  if (res.status !== 201 && res.status !== 200)
-    throw failed("upload failed", res);
-  return asAsset(res.body);
-}
-async function uploadInParts(target, bytes, opts) {
-  const begun = await apiJson(
-    target.origin,
-    "/api/assets/recording/multipart",
-    {
-      method: "POST",
-      key: target.key,
-      body: {
-        filename: opts.filename,
-        contentType: opts.contentType,
-        size: bytes.length,
-        contentHash: opts.contentHash,
-        ...opts.durationSeconds && opts.durationSeconds > 0 ? { durationSeconds: opts.durationSeconds } : {}
-      }
-    }
-  );
-  if (begun.status !== 201 && begun.status !== 200) {
-    throw failed("upload failed", begun);
-  }
-  if (begun.body.reused === true || typeof begun.body.url === "string") {
-    return asAsset(begun.body);
-  }
-  const uploadId = String(begun.body.id);
-  const partBytes = Number(begun.body.partBytes);
-  if (!Number.isFinite(partBytes) || partBytes <= 0) {
-    throw new Error("upload failed: the platform returned no part size");
-  }
-  const parts = planParts(bytes.length, partBytes);
-  const etags = [];
-  try {
-    for (const part of parts) {
-      const chunk2 = bytes.subarray(part.start, part.end);
-      let sent = null;
-      for (let attempt = 1; attempt <= PART_ATTEMPTS; attempt++) {
-        try {
-          sent = await apiJson(
-            target.origin,
-            `/api/assets/recording/multipart/${uploadId}/parts/${part.partNumber}`,
-            {
-              method: "PUT",
-              key: target.key,
-              headers: {
-                "Content-Type": "application/octet-stream",
-                "Content-Length": String(chunk2.length)
-              },
-              raw: chunk2
-            }
-          );
-        } catch (networkError) {
-          if (attempt === PART_ATTEMPTS) throw networkError;
-          await wait(500 * 2 ** (attempt - 1));
-          continue;
-        }
-        if (sent.status === 200) break;
-        if (!transient(sent.status) || attempt === PART_ATTEMPTS) {
-          throw failed(`part ${part.partNumber} failed`, sent);
-        }
-        await wait(500 * 2 ** (attempt - 1));
-      }
-      if (!sent || sent.status !== 200) {
-        throw new Error(`part ${part.partNumber} failed`);
-      }
-      etags.push({
-        partNumber: Number(sent.body.partNumber),
-        etag: String(sent.body.etag)
-      });
-      opts.onPart?.(etags.length, parts.length);
-    }
-    const sealed = await apiJson(
-      target.origin,
-      `/api/assets/recording/multipart/${uploadId}/complete`,
-      { method: "POST", key: target.key, body: { parts: etags } }
-    );
-    if (sealed.status !== 201 && sealed.status !== 200) {
-      throw failed("upload failed", sealed);
-    }
-    return asAsset(sealed.body);
-  } catch (err) {
-    await apiJson(
-      target.origin,
-      `/api/assets/recording/multipart/${uploadId}`,
-      { method: "DELETE", key: target.key }
-    ).catch(() => void 0);
-    throw err;
-  }
-}
-
-// src/plugin/media.ts
-var SOURCE_MEDIA = [
-  { key: "videoKey", stem: "recording", fallbackExt: ".webm" },
-  { key: "micKey", stem: "mic", fallbackExt: ".webm" },
-  { key: "camKey", stem: "cam", fallbackExt: ".webm" }
-];
-function isTakeRelativeKey(key) {
-  return !!key && !/^(https?:|blob:|data:|media:|\/\/)/.test(key) && !key.startsWith("/api/");
-}
-var takeRelativeFile = (key) => key.replace(/^\/+/, "");
-function sourceSidecarRefs(doc, keep = isTakeRelativeKey) {
-  const out = [];
-  for (const [field, where] of [
-    ["micKey", "mic track"],
-    ["camKey", "cam track"]
-  ]) {
-    const key = doc.source[field];
-    if (!key || !keep(key)) continue;
-    out.push({
-      where,
-      key,
-      set: (next) => {
-        doc.source[field] = next;
-      }
-    });
-  }
-  return out;
-}
-function docObjectRefs(doc, keep = isTakeRelativeKey) {
-  const out = [];
-  for (const clip of doc.objects ?? []) {
-    const asset = clip.asset;
-    if (asset.kind !== "gltf" || !keep(asset.key)) continue;
-    out.push({
-      where: `object ${clip.id}`,
-      key: asset.key,
-      set: (next) => {
-        asset.key = next;
-      }
-    });
-  }
-  return out;
-}
-function docOverlayRefs(doc, keep = isTakeRelativeKey) {
-  const out = [];
-  for (const clip of doc.overlays ?? []) {
-    if (!isKeyedOverlay(clip) || !keep(clip.key)) continue;
-    out.push({
-      where: `overlay ${clip.id}`,
-      key: clip.key,
-      set: (next) => {
-        clip.key = next;
-      }
-    });
-  }
-  return out;
-}
-function docLayerRefs(doc, keep = isTakeRelativeKey) {
-  return [
-    ...docOverlayRefs(doc, keep),
-    ...docObjectRefs(doc, keep),
-    ...docAudioRefs(doc, keep)
-  ];
-}
-function docMediaRefs(doc, keep = isTakeRelativeKey) {
-  const out = [];
-  for (const m of doc.media ?? []) {
-    if (keep(m.videoKey))
-      out.push({
-        where: `media ${m.id}`,
-        key: m.videoKey,
-        set: (next) => {
-          m.videoKey = next;
-        }
-      });
-    const mic = m.micKey;
-    if (mic && keep(mic))
-      out.push({
-        where: `media ${m.id} mic`,
-        key: mic,
-        set: (next) => {
-          m.micKey = next;
-        }
-      });
-    const cam = m.camKey;
-    if (cam && keep(cam))
-      out.push({
-        where: `media ${m.id} cam`,
-        key: cam,
-        set: (next) => {
-          m.camKey = next;
-        }
-      });
-  }
-  out.push(...docOverlayRefs(doc, keep));
-  out.push(...docObjectRefs(doc, keep));
-  const mark = doc.endCard?.mark;
-  if (mark && keep(mark.key))
-    out.push({
-      where: "end card mark",
-      key: mark.key,
-      set: (next) => {
-        mark.key = next;
-      }
-    });
-  const bg = doc.frame.backgroundMedia;
-  if (bg && keep(bg.key))
-    out.push({
-      where: "background",
-      key: bg.key,
-      set: (next) => {
-        bg.key = next;
-      }
-    });
-  out.push(...docAudioRefs(doc, keep));
-  return out;
-}
-function docAudioRefs(doc, keep = isTakeRelativeKey) {
-  const out = [];
-  for (const clip of doc.audio ?? []) {
-    if (!keep(clip.key)) continue;
-    out.push({
-      where: `audio ${clip.id}`,
-      key: clip.key,
-      set: (next) => {
-        clip.key = next;
-      }
-    });
-  }
-  return out;
-}
-async function uploadDocRefs(refs, dir, target, log) {
-  for (const ref of refs) {
-    const file = join2(dir, takeRelativeFile(ref.key));
-    if (!existsSync2(file)) {
-      log(`  ${ref.where}: ${ref.key} is not beside the document \u2014 left as is`);
-      continue;
-    }
-    const media = await readFile2(file);
-    const mediaHash = createHash("sha256").update(media).digest("hex");
-    const { type } = resolveMediaType({
-      head: media.subarray(0, MEDIA_HEAD_BYTES),
-      filename: file
-    });
-    const name = nameForType(basename2(file), type);
-    if (name !== basename2(file)) {
-      log(`  ${ref.where}: ${basename2(file)} holds ${type} \u2014 sent as ${name}`);
-    }
-    let put;
-    try {
-      put = await uploadAsset(target, new Uint8Array(media), {
-        filename: name,
-        contentType: type,
-        contentHash: mediaHash
-      });
-    } catch (e) {
-      throw new Error(
-        `${ref.where} upload failed: ${e instanceof Error ? e.message : String(e)}`
-      );
-    }
-    ref.set(put.url);
-    log(
-      `  ${ref.where}: ${ref.key} \u2192 asset ${put.id}${put.reused ? " (reused)" : ""}`
-    );
-  }
-}
-function assetIdOf(url) {
-  if (!url) return null;
-  const m = /\/api\/assets\/([A-Za-z0-9_-]+)\/file/.exec(url);
-  return m ? m[1] : null;
-}
-async function readMediaHead(file) {
-  const handle = await open(file, "r");
-  try {
-    const buf = Buffer.alloc(MEDIA_HEAD_BYTES);
-    const { bytesRead } = await handle.read(buf, 0, MEDIA_HEAD_BYTES, 0);
-    return new Uint8Array(buf.subarray(0, bytesRead));
-  } finally {
-    await handle.close();
-  }
-}
-async function downloadMedia(ctx, url, target) {
-  const abs = /^https?:/.test(url) ? url : `${ctx.origin}${url}`;
-  const res = await fetch(abs, {
-    headers: ctx.key ? { authorization: `Bearer ${ctx.key}` } : {}
-  });
-  if (!res.ok || !res.body) {
-    throw new Error(
-      `download of ${target.describe} failed (${res.status})${res.status === 404 && target.notFoundHint ? ` \u2014 ${target.notFoundHint}` : ""}`
-    );
-  }
-  const into = target.subdir ? join2(target.dir, target.subdir) : target.dir;
-  const partial = join2(into, `${target.stem}.part`);
-  await mkdir2(dirname(partial), { recursive: true });
-  try {
-    await pipeline(
-      Readable.fromWeb(res.body),
-      createWriteStream(partial)
-    );
-    const { type } = resolveMediaType({
-      head: await readMediaHead(partial),
-      declared: res.headers.get("content-type"),
-      filename: `${target.stem}${target.fallbackExt}`
-    });
-    const name = `${target.stem}${extensionFor(type) || target.fallbackExt}`;
-    await rename2(partial, join2(into, name));
-    const file = target.subdir ? `${target.subdir}/${name}` : name;
-    return { file, bytes: (await stat(join2(target.dir, file))).size };
-  } finally {
-    await rm2(partial, { force: true });
-  }
-}
-async function pullMedia(ctx, dir, doc, log) {
-  const result = { downloaded: [], kept: [] };
-  for (const { key, stem, fallbackExt } of SOURCE_MEDIA) {
-    const url = doc.source[key];
-    const assetId = assetIdOf(url);
-    if (!assetId) continue;
-    const present = takeMediaFiles(dir, stem)[0];
-    if (present) {
-      result.kept.push(basename2(present));
-      doc.source[key] = basename2(present);
-      continue;
-    }
-    const got = await downloadMedia(ctx, url, {
-      dir,
-      stem,
-      fallbackExt,
-      describe: stem,
-      notFoundHint: "a private recording needs a content key of its owner"
-    });
-    result.downloaded.push({ file: got.file, assetId, bytes: got.bytes });
-    log(`  ${got.file} \u2190 asset ${assetId} (${Math.round(got.bytes / 1024)} kB)`);
-    doc.source[key] = got.file;
-  }
-  for (const ref of docMediaRefs(doc, (k) => assetIdOf(k) !== null)) {
-    const assetId = assetIdOf(ref.key);
-    const existing = existsSync2(join2(dir, "media")) ? (await readdir(join2(dir, "media"))).find(
-      (f) => f === assetId || f.startsWith(`${assetId}.`)
-    ) : void 0;
-    if (existing) {
-      const file = `media/${existing}`;
-      result.kept.push(file);
-      ref.set(file);
-      continue;
-    }
-    const got = await downloadMedia(ctx, ref.key, {
-      dir,
-      subdir: "media",
-      stem: assetId,
-      // A type with no extension here (an svg served as such) keeps the bare
-      // asset id, exactly as before.
-      fallbackExt: "",
-      describe: `${ref.where} (${ref.key})`
-    });
-    result.downloaded.push({ file: got.file, assetId, bytes: got.bytes });
-    log(
-      `  ${got.file} \u2190 ${ref.where}, asset ${assetId} (${Math.round(got.bytes / 1024)} kB)`
-    );
-    ref.set(got.file);
-  }
-  const metaPath = join2(dir, "meta.json");
-  if (!existsSync2(metaPath)) await writeJson(metaPath, doc.source.meta, true);
-  const cursorPath = join2(dir, "cursor.json");
-  if (!existsSync2(cursorPath)) await writeJson(cursorPath, doc.source.cursor);
-  await writeFile2(join2(dir, "doc.json"), JSON.stringify(doc, null, 2));
-  return result;
-}
-
 // src/plugin/mediaProbe.ts
 var MEDIA_EXT = /\.(png|jpe?g|webp|gif|webm|mp4|mov|mp3|wav|m4a|ogg|glb|gltf|hdr|exr|woff2?)($|\?)/i;
 var isRemote = (v) => typeof v === "string" && /^https?:\/\//i.test(v);
@@ -2386,9 +1926,9 @@ function mediaProbeLints(results) {
 }
 
 // src/plugin/framesTake.ts
-import { mkdir as mkdir4, readFile as readFile5, rename as rename4, writeFile as writeFile5 } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
-import { join as join5, resolve as resolve2 } from "path";
+import { mkdir as mkdir2, readFile as readFile3, rename as rename2, writeFile as writeFile3 } from "fs/promises";
+import { existsSync as existsSync3 } from "fs";
+import { join as join3, resolve as resolve2 } from "path";
 import { compileVosConfig } from "@vosjs/core";
 import {
   docStillTime,
@@ -2402,9 +1942,9 @@ import {
 
 // src/plugin/server.ts
 import { createServer } from "http";
-import { existsSync as existsSync3, readFileSync, statSync as statSync2 } from "fs";
-import { writeFile as writeFile3 } from "fs/promises";
-import { extname, join as join3 } from "path";
+import { existsSync, readFileSync, statSync } from "fs";
+import { writeFile } from "fs/promises";
+import { extname, join } from "path";
 var MIME = {
   ".html": "text/html",
   ".js": "text/javascript",
@@ -2448,7 +1988,7 @@ function startTakeServer(rootDir, pages) {
       const chunks = [];
       req.on("data", (c) => chunks.push(c));
       req.on("end", () => {
-        void writeFile3(join3(rootDir, name), Buffer.concat(chunks)).then(
+        void writeFile(join(rootDir, name), Buffer.concat(chunks)).then(
           () => res.writeHead(200).end("ok"),
           (e) => res.writeHead(500).end(String(e))
         );
@@ -2460,9 +2000,9 @@ function startTakeServer(rootDir, pages) {
       res.end(pages[url.pathname]);
       return;
     }
-    const file = join3(rootDir, decodeURIComponent(url.pathname));
-    if (existsSync3(file) && statSync2(file).isFile()) {
-      const size = statSync2(file).size;
+    const file = join(rootDir, decodeURIComponent(url.pathname));
+    if (existsSync(file) && statSync(file).isFile()) {
+      const size = statSync(file).size;
       const buf = readFileSync(file);
       const type = sniffMediaType(buf.subarray(0, MEDIA_HEAD_BYTES)) ?? MIME[extname(file)] ?? "application/octet-stream";
       const range = req.headers.range;
@@ -2527,7 +2067,7 @@ async function waitForPageDone(page, label, onProgress, timeoutMs) {
 }
 
 // src/plugin/renderAnimation.ts
-import { readFile as readFile3, rm as rm3 } from "fs/promises";
+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";
@@ -2822,10 +2362,10 @@ async function renderAnimation(browser, opts) {
       )
     );
     const files = await Promise.all(
-      outNames.map((name) => readFile3(`${opts.workDir}/${name}`))
+      outNames.map((name) => readFile(`${opts.workDir}/${name}`))
     );
     await Promise.all(
-      outNames.map((name) => rm3(`${opts.workDir}/${name}`, { force: true }))
+      outNames.map((name) => rm(`${opts.workDir}/${name}`, { force: true }))
     );
     if (chunks.length === 1) {
       return { bytes: new Uint8Array(files[0]), totalFrames, chunks: 1 };
@@ -3080,9 +2620,9 @@ function applyAndValidate(doc, o) {
 }
 
 // src/plugin/digestTake.ts
-import { mkdir as mkdir3, readFile as readFile4, rename as rename3, writeFile as writeFile4 } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
-import { join as join4, resolve } from "path";
+import { mkdir, readFile as readFile2, rename, writeFile as writeFile2 } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
+import { join as join2, resolve } from "path";
 import {
   DIGEST_CROP_MAX,
   DIGEST_FULL_MAX,
@@ -3304,8 +2844,8 @@ async function digestTake(browser, dir, opts = {}) {
   const meta = doc.source.meta;
   let plan = planForDigest(doc);
   const transcript = opts.transcript ?? await discoverTranscript(dir);
-  const outDir = resolve(opts.outDir ?? join4(dir, DIGEST_DIR));
-  await mkdir3(outDir, { recursive: true });
+  const outDir = resolve(opts.outDir ?? join2(dir, DIGEST_DIR));
+  await mkdir(outDir, { recursive: true });
   const fullMax = opts.full ?? DIGEST_FULL_MAX;
   const cropMax = opts.crop ?? DIGEST_CROP_MAX;
   const wantFrames = opts.frames !== false && browser !== null;
@@ -3321,7 +2861,7 @@ async function digestTake(browser, dir, opts = {}) {
     kind: "video",
     url: `/${take.paths.recordingName}`
   };
-  if (existsSync4(take.paths.framesIndex) && existsSync4(take.paths.framesDir)) {
+  if (existsSync2(take.paths.framesIndex) && existsSync2(take.paths.framesDir)) {
     const index = await readJson(
       take.paths.framesIndex
     );
@@ -3336,7 +2876,7 @@ async function digestTake(browser, dir, opts = {}) {
     }
   }
   if (wantFrames) {
-    if (source.kind === "video" && !existsSync4(take.paths.recording))
+    if (source.kind === "video" && !existsSync2(take.paths.recording))
       throw new Error(
         `${dir} has no recording \u2014 pull it with \`vos pull --media\` first`
       );
@@ -3409,9 +2949,9 @@ async function digestTake(browser, dir, opts = {}) {
       );
       sizes = f.sizes;
       for (const name of Object.keys(sizes)) {
-        const from = join4(dir, name);
-        const to = join4(outDir, name);
-        if (from !== to && existsSync4(from)) await rename3(from, to);
+        const from = join2(dir, name);
+        const to = join2(outDir, name);
+        if (from !== to && existsSync2(from)) await rename(from, to);
       }
       if (sizes["sheet.png"]) sheet = "sheet.png";
     } finally {
@@ -3437,12 +2977,12 @@ async function digestTake(browser, dir, opts = {}) {
         if (!p) continue;
         for (const f of [p.full, p.crop]) {
           if (!f) continue;
-          const size = await pngSize(join4(outDir, f));
+          const size = await pngSize(join2(outDir, f));
           if (size) sizes[f] = size;
         }
         if (p.box) boxes.set(m.id, p.box);
       }
-      if (prior.images.sheet && existsSync4(join4(outDir, prior.images.sheet)))
+      if (prior.images.sheet && existsSync2(join2(outDir, prior.images.sheet)))
         sheet = prior.images.sheet;
     }
   }
@@ -3471,16 +3011,16 @@ async function digestTake(browser, dir, opts = {}) {
     style: opts.style ?? null,
     transcript
   });
-  const file = join4(outDir, "digest.json");
+  const file = join2(outDir, "digest.json");
   const body = JSON.stringify(digest, null, 2);
-  await writeFile4(file, body);
+  await writeFile2(file, body);
   return { file, outDir, digest, bytes: Buffer.byteLength(body) };
 }
 async function discoverTranscript(dir) {
-  const file = join4(dir, "transcript.json");
-  if (!existsSync4(file)) return null;
+  const file = join2(dir, "transcript.json");
+  if (!existsSync2(file)) return null;
   try {
-    return parseTranscript(JSON.parse(await readFile4(file, "utf8")));
+    return parseTranscript(JSON.parse(await readFile2(file, "utf8")));
   } catch {
     return null;
   }
@@ -3488,7 +3028,7 @@ async function discoverTranscript(dir) {
 async function readPriorDigest(outDir) {
   try {
     const raw = JSON.parse(
-      await readFile4(join4(outDir, "digest.json"), "utf8")
+      await readFile2(join2(outDir, "digest.json"), "utf8")
     );
     return raw.digestVersion === DIGEST_VERSION && Array.isArray(raw.moments) ? raw : null;
   } catch {
@@ -3497,7 +3037,7 @@ async function readPriorDigest(outDir) {
 }
 async function pngSize(file) {
   try {
-    const buf = await readFile4(file);
+    const buf = await readFile2(file);
     if (buf.length < 24 || buf.readUInt32BE(0) !== 2303741511) return null;
     return { width: buf.readUInt32BE(16), height: buf.readUInt32BE(20) };
   } catch {
@@ -3672,8 +3212,8 @@ async function framesTake(browser, dir, opts) {
     throw new Error(
       "no frame times \u2014 pass --times/--frame, --at-zooms, --at-moments or --at-still"
     );
-  const outDir = resolve2(opts.outDir ?? join5(dir, "stills"));
-  await mkdir4(outDir, { recursive: true });
+  const outDir = resolve2(opts.outDir ?? join3(dir, "stills"));
+  await mkdir2(outDir, { recursive: true });
   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`
@@ -3717,9 +3257,9 @@ async function framesTake(browser, dir, opts) {
     );
     const frames = [];
     for (const n of named) {
-      const from = join5(dir, n.name);
-      const to = join5(outDir, n.name);
-      if (from !== to) await rename4(from, to);
+      const from = join3(dir, n.name);
+      const to = join3(outDir, n.name);
+      if (from !== to) await rename2(from, to);
       frames.push({
         file: to,
         time: n.time,
@@ -3734,10 +3274,10 @@ async function framesTake(browser, dir, opts) {
   }
 }
 async function momentsFor(dir, doc) {
-  const file = join5(dir, DIGEST_DIR, "digest.json");
-  if (existsSync5(file)) {
+  const file = join3(dir, DIGEST_DIR, "digest.json");
+  if (existsSync3(file)) {
     try {
-      const d = JSON.parse(await readFile5(file, "utf8"));
+      const d = JSON.parse(await readFile3(file, "utf8"));
       if (Array.isArray(d.moments)) return d.moments;
     } catch {
     }
@@ -3757,8 +3297,8 @@ function parseTimes2(spec, duration) {
   });
 }
 async function writeIndexJson(result) {
-  const index = join5(result.outDir, "stills.json");
-  await writeFile5(
+  const index = join3(result.outDir, "stills.json");
+  await writeFile3(
     index,
     JSON.stringify(
       {
@@ -3775,11 +3315,11 @@ async function writeIndexJson(result) {
 }
 
 // src/plugin/deliver.ts
-import { mkdir as mkdir5, mkdtemp, rename as rename5, rm as rm4, stat as stat2, writeFile as writeFile7 } from "fs/promises";
+import { mkdir as mkdir3, mkdtemp, rename as rename3, rm as rm2, stat, writeFile as writeFile5 } from "fs/promises";
 import { tmpdir } from "os";
-import { join as join7, relative, resolve as resolve4 } from "path";
-import { existsSync as existsSync7 } from "fs";
-import { readFile as readFile7 } from "fs/promises";
+import { join as join5, relative, resolve as resolve4 } from "path";
+import { existsSync as existsSync5 } from "fs";
+import { readFile as readFile5 } from "fs/promises";
 import { parseFrontmatter } from "@vosjs/shared/frontmatter";
 import {
   CHANNEL_SPECS_VERIFIED,
@@ -3793,7 +3333,7 @@ import {
 } from "@vosjs/studio-core";
 
 // src/plugin/renderTake.ts
-import { writeFile as writeFile6 } from "fs/promises";
+import { writeFile as writeFile4 } from "fs/promises";
 import { compileVosConfig as compileVosConfig2 } from "@vosjs/core";
 import {
   audioProducerCode,
@@ -3882,7 +3422,7 @@ async function renderTake(browser, dir, outFile, opts) {
     } : void 0,
     onProgress: opts.onProgress
   });
-  await writeFile6(outFile, result.bytes);
+  await writeFile4(outFile, result.bytes);
   return {
     out: outFile,
     bytes: result.bytes.length,
@@ -4437,9 +3977,9 @@ function proposeTransitions(input, kind) {
   for (const step of steps) {
     if (!step.navigated || step.skipped) continue;
     const name = step.id ?? String(step.step);
-    const wait2 = step.do === "wait";
-    const outEnd = round3(wait2 ? step.tStart : step.tEnd);
-    const inStart = round3(wait2 ? step.tEnd : step.tEnd + STEP_SETTLE_SECONDS);
+    const wait = step.do === "wait";
+    const outEnd = round3(wait ? step.tStart : step.tEnd);
+    const inStart = round3(wait ? step.tEnd : step.tEnd + STEP_SETTLE_SECONDS);
     const segs = doc.segments;
     if (segs.some(
       (s) => !s.media && Math.abs(s.out - outEnd) < 0.05 && s !== segs.at(-1)
@@ -4758,9 +4298,9 @@ function isLightHexGround(hex2) {
 }
 
 // src/plugin/posterDoc.ts
-import { existsSync as existsSync6 } from "fs";
-import { readFile as readFile6 } from "fs/promises";
-import { isAbsolute, join as join6, resolve as resolve3 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { readFile as readFile4 } from "fs/promises";
+import { isAbsolute, join as join4, resolve as resolve3 } from "path";
 import {
   computeCardLayout,
   docStillTime as docStillTime2,
@@ -4787,16 +4327,16 @@ var roleFor = (cls) => `poster-${cls}`;
 async function readPosterAt(cls, path, takeDir, from) {
   let file = path;
   let docDir = path;
-  if (existsSync6(join6(path, "doc.json"))) {
-    file = join6(path, "doc.json");
-  } else if (!/\.json$/i.test(path) || !existsSync6(path)) {
+  if (existsSync4(join4(path, "doc.json"))) {
+    file = join4(path, "doc.json");
+  } else if (!/\.json$/i.test(path) || !existsSync4(path)) {
     return null;
   } else {
     docDir = resolve3(path, "..");
   }
   let raw;
   try {
-    raw = JSON.parse(await readFile6(file, "utf8"));
+    raw = JSON.parse(await readFile4(file, "utf8"));
   } catch {
     return null;
   }
@@ -4806,7 +4346,7 @@ async function readPosterAt(cls, path, takeDir, from) {
   const doc = migrateHostedDoc(
     raw
   );
-  const ownFootage = existsSync6(join6(docDir, "meta.json")) && existsSync6(join6(docDir, source.videoKey));
+  const ownFootage = existsSync4(join4(docDir, "meta.json")) && existsSync4(join4(docDir, source.videoKey));
   const sync = readSyncState(docDir);
   return {
     cls,
@@ -4829,10 +4369,10 @@ async function findPosterDocs(takeDir, launchRoles) {
       candidates.push({ path: at2(named.trim()), from: `LAUNCH.md ${role}` });
     }
     candidates.push({
-      path: join6(takeDir, "poster", cls),
+      path: join4(takeDir, "poster", cls),
       from: `poster/${cls}`
     });
-    candidates.push({ path: join6(takeDir, "poster"), from: "poster" });
+    candidates.push({ path: join4(takeDir, "poster"), from: "poster" });
     for (const c of candidates) {
       const ref = await readPosterAt(cls, c.path, takeDir, c.from);
       if (ref) {
@@ -4928,19 +4468,19 @@ function resolveChannels(raw) {
   return out;
 }
 async function readBrandBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join7(dir, "BRAND.md"), join7(dir, "..", "BRAND.md")];
+  const candidates = explicit ? [explicit] : [join5(dir, "BRAND.md"), join5(dir, "..", "BRAND.md")];
   for (const file of candidates) {
-    if (!existsSync7(file)) continue;
-    const roles = parseFrontmatter(await readFile7(file, "utf8"));
+    if (!existsSync5(file)) continue;
+    const roles = parseFrontmatter(await readFile5(file, "utf8"));
     return { file, roles };
   }
   return null;
 }
 async function readLaunchBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join7(dir, "LAUNCH.md"), join7(dir, "..", "LAUNCH.md")];
+  const candidates = explicit ? [explicit] : [join5(dir, "LAUNCH.md"), join5(dir, "..", "LAUNCH.md")];
   for (const file of candidates) {
-    if (!existsSync7(file)) continue;
-    return { file, roles: parseFrontmatter(await readFile7(file, "utf8")) };
+    if (!existsSync5(file)) continue;
+    return { file, roles: parseFrontmatter(await readFile5(file, "utf8")) };
   }
   return null;
 }
@@ -5004,7 +4544,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
   const meta = doc.source.meta;
   const vw = meta.captureWidth ?? meta.width;
   const vh = meta.captureHeight ?? meta.height;
-  const probeDir = await mkdtemp(join7(tmpdir(), "vos-moments-"));
+  const probeDir = await mkdtemp(join5(tmpdir(), "vos-moments-"));
   try {
     const probe3 = await framesTake(browser, dir, {
       times: candidates.map((c) => c.time),
@@ -5018,7 +4558,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
     });
     const byTime = /* @__PURE__ */ new Map();
     for (const frame of probe3.frames) {
-      const img = decodePng(new Uint8Array(await readFile7(frame.file)));
+      const img = decodePng(new Uint8Array(await readFile5(frame.file)));
       if (!img) continue;
       const whole = { x: 0, y: 0, w: img.w, h: img.h };
       byTime.set(+frame.time.toFixed(3), {
@@ -5043,7 +4583,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
       notes: [...notes, ...pick.dropped.map((d) => `moment: ${d}`)]
     };
   } finally {
-    await rm4(probeDir, { recursive: true, force: true });
+    await rm2(probeDir, { recursive: true, force: true });
   }
 }
 var overCeiling = (bytes, maxBytes) => `${Math.ceil(bytes / 1024)} KB exceeds the ${Math.floor(maxBytes / 1024)} KB ceiling`;
@@ -5091,8 +4631,8 @@ async function deliverTake(browser, dir, opts) {
   const doc = take.doc;
   const duration = docOutputDuration2(doc);
   const videoSeconds = opts.range ? Math.min(opts.range[1], duration) - Math.min(opts.range[0], duration) : duration;
-  const outDir = resolve4(opts.outDir ?? join7(dir, "kit"));
-  await mkdir5(outDir, { recursive: true });
+  const outDir = resolve4(opts.outDir ?? join5(dir, "kit"));
+  await mkdir3(outDir, { recursive: true });
   const destinations = opts.channels.flatMap((c) => destinationsForChannel(c));
   const assets = [];
   const skipped = [];
@@ -5152,7 +4692,7 @@ async function deliverTake(browser, dir, opts) {
     opts.onPhase?.(
       `${label} (${specWords(d)}) from ${ref.from}${ref.vosId ? ` ${ref.vosId}` : ""}, the rest at ${time.toFixed(2)}s`
     );
-    const shotDir = await mkdtemp(join7(tmpdir(), "vos-poster-"));
+    const shotDir = await mkdtemp(join5(tmpdir(), "vos-poster-"));
     try {
       const captured = await framesTake(browser, ref.takeDir, {
         times: [time],
@@ -5162,9 +4702,9 @@ async function deliverTake(browser, dir, opts) {
         doc: ref.doc,
         overrides: opts.overrides
       });
-      const to = join7(outDir, `${d.id}.png`);
-      await rename5(captured.frames[0].file, to);
-      const bytes = (await stat2(to)).size;
+      const to = join5(outDir, `${d.id}.png`);
+      await rename3(captured.frames[0].file, to);
+      const bytes = (await stat(to)).size;
       if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
         skipped.push(
           `${label}: ${overCeiling(bytes, d.maxBytes)} (kept at ${to})`
@@ -5193,7 +4733,7 @@ async function deliverTake(browser, dir, opts) {
         ...shot.x < 0 && shot.x + shot.w > 1 ? { crop: true } : {}
       });
     } finally {
-      await rm4(shotDir, { recursive: true, force: true });
+      await rm2(shotDir, { recursive: true, force: true });
     }
   }
   if (missing.size) {
@@ -5234,7 +4774,7 @@ async function deliverTake(browser, dir, opts) {
         }
       }
       opts.onPhase?.(`${label} (${specWords(d)})`);
-      const outFile = join7(outDir, `${d.id}.${d.format}`);
+      const outFile = join5(outDir, `${d.id}.${d.format}`);
       const bitrate = d.maxBytes !== void 0 ? Math.min(
         1e7,
         Math.floor(d.maxBytes * 8 / seconds * 0.85)
@@ -5281,9 +4821,9 @@ async function deliverTake(browser, dir, opts) {
     for (let i = 0; i < captured.frames.length; i++) {
       const frame = captured.frames[i];
       const name = captured.frames.length > 1 ? `${d.id}-${i + 1}.png` : `${d.id}.png`;
-      const to = join7(outDir, name);
-      await rename5(frame.file, to);
-      const bytes = (await stat2(to)).size;
+      const to = join5(outDir, name);
+      await rename3(frame.file, to);
+      const bytes = (await stat(to)).size;
       if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
         skipped.push(
           `${label}: ${overCeiling(bytes, d.maxBytes)} (kept at ${to})`
@@ -5319,15 +4859,15 @@ async function deliverTake(browser, dir, opts) {
     skipped,
     assets
   };
-  const kitFile = join7(outDir, "kit.json");
-  await writeFile7(kitFile, JSON.stringify(kit, null, 2));
+  const kitFile = join5(outDir, "kit.json");
+  await writeFile5(kitFile, JSON.stringify(kit, null, 2));
   return { kit, kitFile, outDir };
 }
 
 // src/plugin/markAsset.ts
-import { mkdir as mkdir6, readFile as readFile8, writeFile as writeFile8 } from "fs/promises";
-import { existsSync as existsSync8 } from "fs";
-import { isAbsolute as isAbsolute2, join as join8, resolve as resolve5 } from "path";
+import { mkdir as mkdir4, readFile as readFile6, writeFile as writeFile6 } from "fs/promises";
+import { existsSync as existsSync6 } from "fs";
+import { isAbsolute as isAbsolute2, join as join6, resolve as resolve5 } from "path";
 function markExtension(url) {
   const m = /\.(svg|png|webp|jpe?g)(?:[?#]|$)/i.exec(url);
   if (!m) return null;
@@ -5409,8 +4949,8 @@ async function fetchBrandMarks(takeDir, roles) {
         bytes = new Uint8Array(await res.arrayBuffer());
       } else {
         const file = isAbsolute2(src) ? src : resolve5(takeDir, src);
-        if (!existsSync8(file)) throw new Error("no such file");
-        bytes = new Uint8Array(await readFile8(file));
+        if (!existsSync6(file)) throw new Error("no such file");
+        bytes = new Uint8Array(await readFile6(file));
       }
     } catch (e) {
       out.notes.push(
@@ -5425,8 +4965,8 @@ async function fetchBrandMarks(takeDir, roles) {
       );
       return null;
     }
-    await mkdir6(join8(takeDir, "brand"), { recursive: true });
-    await writeFile8(join8(takeDir, "brand", `${name}.${ext}`), bytes);
+    await mkdir4(join6(takeDir, "brand"), { recursive: true });
+    await writeFile6(join6(takeDir, "brand", `${name}.${ext}`), bytes);
     return { key: `/brand/${name}.${ext}`, aspect };
   };
   out.light = await one("logoUrl", "mark");
@@ -5462,9 +5002,9 @@ async function fetchMusicCatalog(origin) {
 }
 
 // src/plugin/judge.ts
-import { existsSync as existsSync9 } from "fs";
-import { mkdir as mkdir7, readFile as readFile9, writeFile as writeFile9 } from "fs/promises";
-import { dirname as dirname2, isAbsolute as isAbsolute3, join as join9, resolve as resolve6 } from "path";
+import { existsSync as existsSync7 } from "fs";
+import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile7 } from "fs/promises";
+import { dirname, isAbsolute as isAbsolute3, join as join7, resolve as resolve6 } from "path";
 import { DESTINATIONS as DESTINATIONS2 } from "@vosjs/studio-core";
 
 // src/plugin/shotBake.ts
@@ -5635,28 +5175,28 @@ function composeSheet(left, right, height = 540, gutter = 32) {
   return { w, h, data: out };
 }
 async function judgeKit(kitPath, manifestPath, outDir) {
-  const kit = JSON.parse(await readFile9(kitPath, "utf8"));
+  const kit = JSON.parse(await readFile7(kitPath, "utf8"));
   const manifest = JSON.parse(
-    await readFile9(manifestPath, "utf8")
+    await readFile7(manifestPath, "utf8")
   );
-  const manifestDir = dirname2(resolve6(manifestPath));
-  const kitDir = dirname2(resolve6(kitPath));
-  const out = resolve6(outDir ?? join9(kitDir, "judge"));
-  await mkdir7(out, { recursive: true });
+  const manifestDir = dirname(resolve6(manifestPath));
+  const kitDir = dirname(resolve6(kitPath));
+  const out = resolve6(outDir ?? join7(kitDir, "judge"));
+  await mkdir5(out, { recursive: true });
   const sheets = [];
   const skipped = [];
   const refCache = /* @__PURE__ */ new Map();
   const loadRef = async (file) => {
     if (refCache.has(file)) return refCache.get(file) ?? null;
-    const p = join9(manifestDir, file);
-    const img = existsSync9(p) ? decodePng(new Uint8Array(await readFile9(p))) : null;
+    const p = join7(manifestDir, file);
+    const img = existsSync7(p) ? decodePng(new Uint8Array(await readFile7(p))) : null;
     refCache.set(file, img);
     return img;
   };
   for (const a of kit.assets) {
     if (!/\.png$/i.test(a.path)) continue;
-    const file = isAbsolute3(a.path) && existsSync9(a.path) ? a.path : join9(kitDir, a.path.split("/").pop() ?? a.path);
-    const img = existsSync9(file) ? decodePng(new Uint8Array(await readFile9(file))) : null;
+    const file = isAbsolute3(a.path) && existsSync7(a.path) ? a.path : join7(kitDir, a.path.split("/").pop() ?? a.path);
+    const img = existsSync7(file) ? decodePng(new Uint8Array(await readFile7(file))) : null;
     if (!img) {
       skipped.push(`${a.destination ?? a.path}: unreadable`);
       continue;
@@ -5687,8 +5227,8 @@ async function judgeKit(kitPath, manifestPath, outDir) {
     const id = stem.replace(/[^A-Za-z0-9_-]+/g, "-") || a.destination || "asset";
     const nameA = `${id}--A.png`;
     const nameB = `${id}--B.png`;
-    await writeFile9(join9(out, nameA), encodePng(composeSheet(img, refImg)));
-    await writeFile9(join9(out, nameB), encodePng(composeSheet(refImg, img)));
+    await writeFile7(join7(out, nameA), encodePng(composeSheet(img, refImg)));
+    await writeFile7(join7(out, nameB), encodePng(composeSheet(refImg, img)));
     const rubric = [
       `# ${id} against ${ref.id} (${ref.file})`,
       "",
@@ -5708,7 +5248,7 @@ async function judgeKit(kitPath, manifestPath, outDir) {
       "In judge.json: `win` true when the kit asset is at least as good as the reference on the rules that apply to its genre, false when it is worse, null for a tie; `reasons` names the rules by number.",
       ""
     ].join("\n");
-    await writeFile9(join9(out, `${id}.md`), rubric);
+    await writeFile7(join7(out, `${id}.md`), rubric);
     sheets.push({
       asset: id,
       reference: ref.id,
@@ -5717,9 +5257,9 @@ async function judgeKit(kitPath, manifestPath, outDir) {
       rubric: `${id}.md`
     });
   }
-  const verdictFile = join9(out, "judge.json");
-  if (!existsSync9(verdictFile)) {
-    await writeFile9(
+  const verdictFile = join7(out, "judge.json");
+  if (!existsSync7(verdictFile)) {
+    await writeFile7(
       verdictFile,
       JSON.stringify(
         {
@@ -5770,9 +5310,9 @@ function catalogFamily(family) {
 }
 
 // src/plugin/callout.ts
-import { existsSync as existsSync10 } from "fs";
-import { readFile as readFile10 } from "fs/promises";
-import { join as join10 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { readFile as readFile8 } from "fs/promises";
+import { join as join8 } from "path";
 import { lerpArray, sample } from "@vosjs/timeline";
 import {
   CALLOUT_DEFAULT_BODY_PX,
@@ -5969,13 +5509,13 @@ async function footageFrames(browser, dir, doc, times, framesTake2) {
   const out = /* @__PURE__ */ new Map();
   if (!times.length) return out;
   const bare = { ...doc, overlays: [] };
-  const outDir = join10(dir, ".ground-check");
+  const outDir = join8(dir, ".ground-check");
   const res = await framesTake2(browser, dir, { times, outDir, doc: bare });
   for (const f of res.frames) {
-    if (!existsSync10(f.file)) continue;
+    if (!existsSync8(f.file)) continue;
     out.set(
       +f.time.toFixed(3),
-      decodePng(new Uint8Array(await readFile10(f.file)))
+      decodePng(new Uint8Array(await readFile8(f.file)))
     );
   }
   return out;
@@ -5984,7 +5524,7 @@ async function footageFrames(browser, dir, doc, times, framesTake2) {
 // src/plugin/kitPicture.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { readFile as readFile11 } from "fs/promises";
+import { readFile as readFile9 } from "fs/promises";
 var execFileP = promisify(execFile);
 var SUBJECT_BAND = { min: 0.6, max: 0.92 };
 var BLANK_INK = 0.12;
@@ -6260,7 +5800,7 @@ async function pictureChecks(assets) {
   let ffmpeg2 = null;
   for (const a of assets) {
     if (/\.png$/i.test(a.file)) {
-      const img = decodePng(new Uint8Array(await readFile11(a.file)));
+      const img = decodePng(new Uint8Array(await readFile9(a.file)));
       if (!img) {
         findings.push({
           code: "unreadable",
@@ -6353,9 +5893,9 @@ function formatFinding(f) {
 }
 
 // src/plugin/validateKit.ts
-import { existsSync as existsSync11 } from "fs";
-import { readFile as readFile12, stat as stat3 } from "fs/promises";
-import { dirname as dirname3, isAbsolute as isAbsolute4, join as join11 } from "path";
+import { existsSync as existsSync9 } from "fs";
+import { readFile as readFile10, stat as stat2 } from "fs/promises";
+import { dirname as dirname2, isAbsolute as isAbsolute4, join as join9 } from "path";
 import { DESTINATIONS as DESTINATIONS3 } from "@vosjs/studio-core";
 var PNG_SIG2 = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
 function pngDimensions(bytes) {
@@ -6374,7 +5914,7 @@ async function probeVideo(path) {
   const MB = await import("mediabunny");
   const input = new MB.Input({
     formats: MB.ALL_FORMATS,
-    source: new MB.BufferSource(new Uint8Array(await readFile12(path)))
+    source: new MB.BufferSource(new Uint8Array(await readFile10(path)))
   });
   try {
     const track = await input.getPrimaryVideoTrack();
@@ -6395,7 +5935,7 @@ async function validateKit(kitPath, opts = {}) {
   const measured = [];
   let kit;
   try {
-    kit = JSON.parse(await readFile12(kitPath, "utf8"));
+    kit = JSON.parse(await readFile10(kitPath, "utf8"));
   } catch (e) {
     return {
       valid: false,
@@ -6412,10 +5952,10 @@ async function validateKit(kitPath, opts = {}) {
       measured
     };
   }
-  const base = dirname3(kitPath);
+  const base = dirname2(kitPath);
   const resolvePath = (p) => {
-    if (isAbsolute4(p) && existsSync11(p)) return p;
-    const beside = join11(base, p.split("/").pop() ?? p);
+    if (isAbsolute4(p) && existsSync9(p)) return p;
+    const beside = join9(base, p.split("/").pop() ?? p);
     return beside;
   };
   const perDestination = /* @__PURE__ */ new Map();
@@ -6426,7 +5966,7 @@ async function validateKit(kitPath, opts = {}) {
     const file = resolvePath(a.path);
     let bytes;
     try {
-      bytes = (await stat3(file)).size;
+      bytes = (await stat2(file)).size;
     } catch {
       problems.push(`${label}: ${a.path} is missing`);
       continue;
@@ -6441,7 +5981,7 @@ async function validateKit(kitPath, opts = {}) {
     let h = null;
     let seconds = null;
     if (/\.(png|jpe?g|webp)$/i.test(file)) {
-      const head = Buffer.from(await readFile12(file));
+      const head = Buffer.from(await readFile10(file));
       const kind = sniffImage(head);
       if (file.toLowerCase().endsWith(".png") && kind !== "png")
         problems.push(
@@ -6551,7 +6091,7 @@ async function validateKit(kitPath, opts = {}) {
 
 // src/plugin/recorder.ts
 import { writeFileSync } from "fs";
-import { join as join12 } from "path";
+import { join as join10 } from "path";
 import { recordTake as recordTakeCore } from "@vosjs/render-core/record";
 async function recordTake(browser, url, actions, paths, log, opts = {}) {
   const dry = opts.dryRun === true;
@@ -6561,7 +6101,7 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
     actions,
     {
       frame: (file, bytes) => {
-        writeFileSync(join12(paths.framesDir, file), bytes);
+        writeFileSync(join10(paths.framesDir, file), bytes);
       }
     },
     log,
@@ -6613,11 +6153,11 @@ import {
 
 // src/plugin/session.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync12, mkdirSync, readdirSync as readdirSync2, rmSync, statSync as statSync3 } from "fs";
+import { existsSync as existsSync10, mkdirSync, readdirSync, rmSync, statSync as statSync2 } from "fs";
 import { homedir } from "os";
-import { join as join13 } from "path";
+import { join as join11 } from "path";
 import { chromium } from "playwright";
-var SESSIONS_DIR = join13(homedir(), ".config", "vos", "sessions");
+var SESSIONS_DIR = join11(homedir(), ".config", "vos", "sessions");
 var NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/i;
 function sessionNameVerdict(name) {
   if (!name) return "a session needs a name: --name <app>";
@@ -6626,20 +6166,20 @@ function sessionNameVerdict(name) {
   return null;
 }
 function sessionDir(name) {
-  return join13(SESSIONS_DIR, name);
+  return join11(SESSIONS_DIR, name);
 }
 function systemChromePath() {
   const explicit = process.env.VOS_BROWSER_PATH;
   if (explicit) return explicit;
   const candidates = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : process.platform === "win32" ? [
-    join13(
+    join11(
       process.env["PROGRAMFILES"] ?? "C:\\Program Files",
       "Google",
       "Chrome",
       "Application",
       "chrome.exe"
     ),
-    join13(
+    join11(
       process.env["LOCALAPPDATA"] ?? "",
       "Google",
       "Chrome",
@@ -6651,7 +6191,7 @@ function systemChromePath() {
     "/usr/bin/google-chrome-stable",
     "/opt/google/chrome/chrome"
   ];
-  const found = candidates.find((c) => existsSync12(c));
+  const found = candidates.find((c) => existsSync10(c));
   if (!found)
     throw new Error(
       "no Google Chrome found: a session needs the system Chrome (the bundled Chromium cannot read a profile Chrome wrote). Install Chrome, or set VOS_BROWSER_PATH"
@@ -6682,7 +6222,7 @@ async function openSession(name, url, opts = { log: () => {
 }
 async function withSession(name, fn, opts = {}) {
   const dir = sessionDir(name);
-  if (!existsSync12(dir))
+  if (!existsSync10(dir))
     throw new Error(`no session "${name}" (vos session list)`);
   const explicit = process.env.VOS_BROWSER_PATH;
   const ctx = await chromium.launchPersistentContext(dir, {
@@ -6701,7 +6241,7 @@ async function withSession(name, fn, opts = {}) {
 }
 async function summarizeSession(name) {
   const dir = sessionDir(name);
-  const created = statSync3(dir).birthtimeMs || statSync3(dir).mtimeMs;
+  const created = statSync2(dir).birthtimeMs || statSync2(dir).mtimeMs;
   return withSession(name, async (ctx) => {
     const cookies = await ctx.cookies();
     const byHost = /* @__PURE__ */ new Map();
@@ -6731,9 +6271,9 @@ function summaryLine(s) {
   return `session "${s.name}" holds cookies for ${hosts}${more}; ${exp}`;
 }
 function listSessions() {
-  if (!existsSync12(SESSIONS_DIR)) return [];
-  return readdirSync2(SESSIONS_DIR, { withFileTypes: true }).filter((d) => d.isDirectory() && NAME.test(d.name)).map((d) => {
-    const st = statSync3(join13(SESSIONS_DIR, d.name));
+  if (!existsSync10(SESSIONS_DIR)) return [];
+  return readdirSync(SESSIONS_DIR, { withFileTypes: true }).filter((d) => d.isDirectory() && NAME.test(d.name)).map((d) => {
+    const st = statSync2(join11(SESSIONS_DIR, d.name));
     return {
       name: d.name,
       ageDays: Math.floor(
@@ -6744,7 +6284,7 @@ function listSessions() {
 }
 function removeSession(name) {
   const dir = sessionDir(name);
-  if (!existsSync12(dir)) return false;
+  if (!existsSync10(dir)) return false;
   rmSync(dir, { recursive: true, force: true });
   return true;
 }
@@ -6809,9 +6349,9 @@ async function encodeRecording(browser, takeDir, onProgress) {
 }
 
 // src/plugin/plan.ts
-import { existsSync as existsSync13 } from "fs";
-import { readFile as readFile13 } from "fs/promises";
-import { join as join14 } from "path";
+import { existsSync as existsSync11 } from "fs";
+import { readFile as readFile11 } from "fs/promises";
+import { join as join12 } from "path";
 import {
   DEFAULT_FRAME_STYLE,
   STYLE_FIELDS,
@@ -7033,10 +6573,10 @@ function retimeCut(prev, newSteps, newDurationMs) {
 // src/plugin/plan.ts
 var overlaps = (a, b) => a.in < b.out && b.in < a.out;
 async function readDigestActivity(dir) {
-  const file = join14(dir, "digest", "digest.json");
-  if (!existsSync13(file)) return null;
+  const file = join12(dir, "digest", "digest.json");
+  if (!existsSync11(file)) return null;
   try {
-    const d = JSON.parse(await readFile13(file, "utf8"));
+    const d = JSON.parse(await readFile11(file, "utf8"));
     return Array.isArray(d.activity) && d.activity.every((v) => typeof v === "number") ? d.activity : null;
   } catch {
     return null;
@@ -7249,16 +6789,16 @@ async function planTake(dir, opts = {}) {
 }
 
 // src/plugin/sync.ts
-import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync14, readFileSync as readFileSync2, readdirSync as readdirSync3 } from "fs";
-import { readFile as readFile14 } from "fs/promises";
+import { createHash } from "crypto";
+import { existsSync as existsSync12, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
+import { readFile as readFile12 } from "fs/promises";
 import { createInterface } from "readline/promises";
-import { basename as basename3, join as join16 } from "path";
+import { basename, join as join14 } from "path";
 import { lowerToComposition as lowerToComposition3, migrateHostedDoc as migrateHostedDoc3 } from "@vosjs/studio-core";
 
 // src/plugin/folder.ts
-import { mkdir as mkdir8, writeFile as writeFile10 } from "fs/promises";
-import { join as join15 } from "path";
+import { mkdir as mkdir6, writeFile as writeFile8 } from "fs/promises";
+import { join as join13 } from "path";
 import { recipeHints } from "@vosjs/shared/frontmatter";
 import { migrateHostedDoc as migrateHostedDoc2 } from "@vosjs/studio-core";
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["json", "help", "media"]);
@@ -7368,7 +6908,7 @@ async function cmdMove(argv) {
   });
   const key = requireCredential(strFlag(flags, "key"));
   const folderId = toRef === "none" ? null : resolveFolder(await listFolders(origin, key), toRef).id;
-  let failed2 = 0;
+  let failed = 0;
   const moved = [];
   for (const raw of positionals) {
     const id = parseVosId(raw);
@@ -7383,28 +6923,28 @@ async function cmdMove(argv) {
       continue;
     }
     if (asVos.status === 404) {
-      const asAsset2 = await apiJson(origin, `/api/assets/${id}`, {
+      const asAsset = await apiJson(origin, `/api/assets/${id}`, {
         method: "PATCH",
         key,
         body: { folderId }
       });
-      if (asAsset2.status === 200) {
+      if (asAsset.status === 200) {
         moved.push({ id, kind: "asset" });
         r.log(`moved asset ${id}`);
         continue;
       }
-      failed2++;
-      r.log(apiError(`move ${id}`, asAsset2));
+      failed++;
+      r.log(apiError(`move ${id}`, asAsset));
       continue;
     }
-    failed2++;
+    failed++;
     r.log(apiError(`move ${id}`, asVos));
   }
   r.done(
-    { moved, failed: failed2, folderId },
-    `moved ${moved.length}/${positionals.length} into ${toRef === "none" ? "the top level" : toRef}${failed2 ? ` \u2014 ${failed2} failed` : ""}`
+    { moved, failed, folderId },
+    `moved ${moved.length}/${positionals.length} into ${toRef === "none" ? "the top level" : toRef}${failed ? ` \u2014 ${failed} failed` : ""}`
   );
-  return failed2 ? EXIT_ERROR : EXIT_OK;
+  return failed ? EXIT_ERROR : EXIT_OK;
 }
 function recipeLine(filename, body) {
   const h = recipeHints(body);
@@ -7434,25 +6974,25 @@ async function cmdPull(argv) {
     throw new Error(apiError(`pull folder ${folder.slug}`, res));
   const payload = res.body;
   const out = strFlag(flags, "out") ?? folder.slug;
-  await mkdir8(join15(out, "recipes"), { recursive: true });
+  await mkdir6(join13(out, "recipes"), { recursive: true });
   const lines = [];
   const recipes = [];
   for (const rec of payload.recipes) {
-    const path = join15(out, "recipes", safeName(rec.filename));
-    await writeFile10(path, rec.body ?? "");
+    const path = join13(out, "recipes", safeName(rec.filename));
+    await writeFile8(path, rec.body ?? "");
     recipes.push({ path, line: recipeLine(rec.filename, rec.body ?? "") });
   }
   for (const rec of payload.inheritedRecipes) {
     const from = safeName(rec.folderSlug ?? "inherited");
-    await mkdir8(join15(out, "recipes", "_inherited", from), { recursive: true });
-    const path = join15(
+    await mkdir6(join13(out, "recipes", "_inherited", from), { recursive: true });
+    const path = join13(
       out,
       "recipes",
       "_inherited",
       from,
       safeName(rec.filename)
     );
-    await writeFile10(path, rec.body ?? "");
+    await writeFile8(path, rec.body ?? "");
     recipes.push({
       path,
       line: `${recipeLine(rec.filename, rec.body ?? "")}  [inherited from ${rec.folderName ?? from}]`
@@ -7460,15 +7000,15 @@ async function cmdPull(argv) {
   }
   const members = [];
   for (const v of payload.voses) {
-    const dir = join15(out, "members", safeName(v.slug || v.title || v.id));
-    await mkdir8(dir, { recursive: true });
+    const dir = join13(out, "members", safeName(v.slug || v.title || v.id));
+    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)}`);
       continue;
     }
-    await writeFile10(
-      join15(dir, "config.json"),
+    await writeFile8(
+      join13(dir, "config.json"),
       JSON.stringify(cfg.body.config, null, 2)
     );
     let take = false;
@@ -7479,8 +7019,8 @@ async function cmdPull(argv) {
         { key }
       );
       if (doc.status === 200) {
-        await writeFile10(
-          join15(dir, "doc.json"),
+        await writeFile8(
+          join13(dir, "doc.json"),
           JSON.stringify(doc.body, null, 2)
         );
         take = true;
@@ -7612,12 +7152,12 @@ function programPushTarget(ask) {
   return { kind: "version", vosId: tracked, tracked: true };
 }
 function storageStateInDir(dir) {
-  for (const f of readdirSync3(dir)) {
+  for (const f of readdirSync2(dir)) {
     if (!f.endsWith(".json") || f === "doc.json" || f === "meta.json" || f === "actions.json" || f === "cursor.json" || f === "vos.json" || f === "doc.prev.json")
       continue;
     try {
-      const v = JSON.parse(readFileSync2(join16(dir, f), "utf8"));
-      if (looksLikeStorageState(v)) return join16(dir, f);
+      const v = JSON.parse(readFileSync2(join14(dir, f), "utf8"));
+      if (looksLikeStorageState(v)) return join14(dir, f);
     } catch {
     }
   }
@@ -7638,7 +7178,7 @@ async function pushTake(dir, flags, r) {
     throw new Error(`doc.json fails lint:
   ${lint.problems.join("\n  ")}`);
   }
-  if (!existsSync14(take.paths.recording)) {
+  if (!existsSync12(take.paths.recording)) {
     throw new Error(
       "no recording in this take \u2014 record it, or `vos pull --media` to bring it home"
     );
@@ -7687,8 +7227,8 @@ async function pushTake(dir, flags, r) {
       throw new Error("push cancelled");
     }
   }
-  const bytes = await readFile14(take.paths.recording);
-  const hash = createHash2("sha256").update(bytes).digest("hex");
+  const bytes = await readFile12(take.paths.recording);
+  const hash = createHash("sha256").update(bytes).digest("hex");
   const { type: contentType } = resolveMediaType({
     head: bytes.subarray(0, MEDIA_HEAD_BYTES),
     filename: take.paths.recordingName
@@ -7735,7 +7275,7 @@ async function pushTake(dir, flags, r) {
   const lowered = lowerToComposition3(docForPush);
   const config = { ...lowered.config, data: lowered.data };
   if (!state) {
-    const title = flags.title ?? `Take ${basename3(dir)} ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`;
+    const title = flags.title ?? `Take ${basename(dir)} ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`;
     const slug = `${title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40) || "take"}-${Date.now().toString(36)}`;
     const created = await api(ctx, "/vos", {
       method: "POST",
@@ -7847,9 +7387,9 @@ async function pullTake(dir, flags, r) {
       };
     }
     let media2;
-    if (flags.media && existsSync14(join16(dir, "doc.json"))) {
+    if (flags.media && existsSync12(join14(dir, "doc.json"))) {
       const local = JSON.parse(
-        await readFile14(join16(dir, "doc.json"), "utf8")
+        await readFile12(join14(dir, "doc.json"), "utf8")
       );
       media2 = await pullMedia(ctx, dir, local, r.log);
     }
@@ -7910,10 +7450,10 @@ async function pullTake(dir, flags, r) {
   const hostedDoc = migrateHostedDoc3(docRes.json);
   const doc = hostedDoc;
   const localRecording = takeMediaFile(dir, "recording", RECORDING_NAME);
-  if (existsSync14(localRecording)) {
-    doc.source.videoKey = basename3(localRecording);
+  if (existsSync12(localRecording)) {
+    doc.source.videoKey = basename(localRecording);
   }
-  await writeJson(join16(dir, "doc.json"), doc, true);
+  await writeJson(join14(dir, "doc.json"), doc, true);
   const media = flags.media ? await pullMedia(ctx, dir, doc, r.log) : void 0;
   const versions = await api(ctx, `/vos/${vosId}/versions`);
   const headRow = (versions.json.versions ?? []).find((v) => v.id === head);
@@ -7932,10 +7472,10 @@ async function pullTake(dir, flags, r) {
 }
 
 // src/plugin/program.ts
-import { existsSync as existsSync15 } from "fs";
-import { mkdir as mkdir9, readFile as readFile15, writeFile as writeFile11 } from "fs/promises";
+import { existsSync as existsSync13 } from "fs";
+import { mkdir as mkdir7, readFile as readFile13, writeFile as writeFile9 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
-import { basename as basename4, dirname as dirname4, join as join17 } from "path";
+import { basename as basename2, dirname as dirname3, join as join15 } from "path";
 import {
   CURRENT_CONFIG_VERSION,
   migrateConfig,
@@ -8141,8 +7681,8 @@ function preflightConfig(parsed) {
 }
 function resolveConfigPath(target) {
   if (target.endsWith(".json")) return target;
-  const inDir = join17(target, "config.json");
-  if (existsSync15(inDir)) return inDir;
+  const inDir = join15(target, "config.json");
+  if (existsSync13(inDir)) return inDir;
   throw new UsageError(
     `${target} has no config.json (and is not a take \u2014 no doc.json)`
   );
@@ -8168,9 +7708,9 @@ 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") ?? slug;
-  await mkdir9(out, { recursive: true });
-  await writeFile11(
-    join17(out, "config.json"),
+  await mkdir7(out, { recursive: true });
+  await writeFile9(
+    join15(out, "config.json"),
     JSON.stringify(cfg.body.config, null, 2)
   );
   const title = typeof vosMeta.title === "string" ? vosMeta.title : "";
@@ -8195,18 +7735,40 @@ async function cmdFetch(argv) {
       const hosted = migrateHostedDoc4(doc.body);
       const { config: own } = await writeProgramDoc(out, hosted);
       if (own) {
-        await writeFile11(join17(out, "config.json"), JSON.stringify(own, null, 2));
+        await writeFile9(join15(out, "config.json"), JSON.stringify(own, null, 2));
       }
     } else if (doc.status === 200) {
       take = true;
       const hosted = migrateHostedDoc4(doc.body);
-      await writeFile11(join17(out, "doc.json"), JSON.stringify(hosted, null, 2));
+      await writeFile9(join15(out, "doc.json"), JSON.stringify(hosted, null, 2));
       if (flags.media === true) {
         const media = await pullMedia({ origin, key }, out, hosted, r.log);
         mediaLine = media.downloaded.length ? ` + ${media.downloaded.map((m) => m.file).join(", ")}` : "";
       }
     }
   }
+  let assetsLine = "";
+  if (!take) {
+    const configPath = join15(out, "config.json");
+    const written = JSON.parse(await readFile13(configPath, "utf8"));
+    const hostedCount = manifestRefs(written).filter(
+      ({ ref }) => hostedAssetId(ref)
+    ).length;
+    if (hostedCount && flags.media === true) {
+      const pulled = await pullManifest({ origin, key }, out, written, r.log);
+      if (pulled) {
+        await writeFile9(
+          configPath,
+          JSON.stringify({ ...written, assets: pulled.assets }, null, 2)
+        );
+        assetsLine = `
+${pulled.files.length} declared file${pulled.files.length === 1 ? "" : "s"} in ${out}/assets`;
+      }
+    } else if (hostedCount) {
+      assetsLine = `
+${hostedCount} declared file${hostedCount === 1 ? " is" : "s are"} hosted (a render reads ${hostedCount === 1 ? "it" : "them"} with your key). Add --media to bring ${hostedCount === 1 ? "it" : "them"} home`;
+    }
+  }
   r.done(
     {
       out,
@@ -8217,7 +7779,7 @@ async function cmdFetch(argv) {
       take
     },
     take ? `Wrote ${out}/doc.json + config.json + vos.json${mediaLine} (${title || id}, a take)
-` + (flags.media === true ? `Then: vos digest ${out} \u2014 look before you cut; edit doc.json; vos validate ${out}; vos push ${out}` : `Add --media to bring the recording home (digest/frames/render need it); then edit doc.json and vos push ${out}`) : `Wrote ${out}/config.json + vos.json (${title || id})
+` + (flags.media === true ? `Then: vos digest ${out} \u2014 look before you cut; edit doc.json; vos validate ${out}; vos push ${out}` : `Add --media to bring the recording home (digest/frames/render need it); then edit doc.json and vos push ${out}`) : `Wrote ${out}/config.json + vos.json (${title || id})${assetsLine}
 Edit config.json, then: vos check ${out}/config.json && vos push ${out}/config.json`
   );
   return EXIT_OK;
@@ -8313,8 +7875,8 @@ async function cmdPushProgram(argv) {
     origin: strFlag(flags, "origin"),
     api: strFlag(flags, "api")
   });
-  const dir = dirname4(source);
-  const parsed = JSON.parse(await readFile15(source, "utf8"));
+  const dir = dirname3(source);
+  const parsed = JSON.parse(await readFile13(source, "utf8"));
   const pre = preflightConfig(parsed);
   if (!pre.ok || !pre.config) {
     for (const issue of pre.issues) r.log(`error ${issue}`);
@@ -8334,6 +7896,7 @@ async function cmdPushProgram(argv) {
     await setProgramStill(dir, t);
     r.log(`cover: ${t}s (doc.json "still")`);
   }
+  for (const w of hostedLiteralWarnings(config)) r.log(`warning ${w}`);
   const programDoc = await readProgramDoc(dir, config);
   if (programDoc) {
     const lint = lintDoc(programDoc);
@@ -8349,7 +7912,7 @@ async function cmdPushProgram(argv) {
         "--claimable creates a NEW claimable vos and cannot iterate (--vos). After the human claims it, iterate with their key: vos push --vos <id>"
       );
     }
-    const fallback = state?.title ? `${state.title} remix` : basename4(source).replace(/\.json$/i, "") || "vos program";
+    const fallback = state?.title ? `${state.title} remix` : basename2(source).replace(/\.json$/i, "") || "vos program";
     const title2 = (strFlag(flags, "title") ?? fallback).slice(0, 100);
     let claimDoc = programDoc;
     if (programDoc) {
@@ -8366,6 +7929,12 @@ async function cmdPushProgram(argv) {
         );
       }
     }
+    const stay = localManifestRefs(config);
+    if (stay.length) {
+      throw new UsageError(
+        `a claimable push carries no files, and this program declares ${stay.length} local file${stay.length === 1 ? "" : "s"} (${stay.join(", ")}). Push with a key instead (vos login, then vos push ${source}), which uploads ${stay.length === 1 ? "it" : "them"}`
+      );
+    }
     const body = {
       title: title2,
       config: storedProgramConfig(config, claimDoc)
@@ -8399,6 +7968,7 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
       (l) => r.log(l)
     );
   }
+  await uploadManifest(config, dir, { origin, key }, (l) => r.log(l));
   const overrides = [
     ...multi.override ?? [],
     ...strFlag(flags, "overrides")?.split(",") ?? []
@@ -8498,7 +8068,7 @@ ${landedLines(landed2)}` : "")
     return EXIT_OK;
   }
   const remixOfId = pushTarget.kind === "create" ? pushTarget.remixOfId : void 0;
-  const fallbackTitle = state?.title ? `${state.title} remix` : basename4(source).replace(/\.json$/i, "") || "vos remix";
+  const fallbackTitle = state?.title ? `${state.title} remix` : basename2(source).replace(/\.json$/i, "") || "vos remix";
   const title = (strFlag(flags, "title") ?? fallbackTitle).slice(0, 100);
   const folderId = folderRef ? resolveFolder(await listFolders(origin, key), folderRef).id : void 0;
   const created = await createProgramVos({
@@ -8566,7 +8136,7 @@ Iterate with: vos push ${source} --vos ${created.id}`
 async function cmdPullProgram(argv) {
   const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS2);
   const target = positionals[0] ?? ".";
-  const dir = target.endsWith(".json") ? dirname4(target) : target;
+  const dir = target.endsWith(".json") ? dirname3(target) : target;
   const r = createReporter(flags.json === true);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -8630,10 +8200,10 @@ async function cmdPullProgram(argv) {
   const cfg = await apiJson(origin, `/api/vos/${vosId}/config`, { key });
   if (cfg.status !== 200)
     throw new Error(apiError(`fetch head config for ${vosId}`, cfg));
-  const configPath = join17(dir, "config.json");
+  const configPath = join15(dir, "config.json");
   let backedUp = false;
-  if (existsSync15(configPath)) {
-    await writeFile11(join17(dir, "config.backup.json"), await readFile15(configPath));
+  if (existsSync13(configPath)) {
+    await writeFile9(join15(dir, "config.backup.json"), await readFile13(configPath));
     backedUp = true;
   }
   let headConfig = cfg.body.config;
@@ -8652,7 +8222,7 @@ async function cmdPullProgram(argv) {
       if (own) headConfig = own;
     }
   }
-  await writeFile11(configPath, JSON.stringify(headConfig, null, 2));
+  await writeFile9(configPath, JSON.stringify(headConfig, null, 2));
   writeSyncState(dir, {
     vosId,
     versionId: typeof head.id === "string" ? head.id : since
@@ -8666,7 +8236,7 @@ async function cmdPullProgram(argv) {
       protected: protectedIds,
       changes,
       out: configPath,
-      backup: backedUp ? join17(dir, "config.backup.json") : null
+      backup: backedUp ? join15(dir, "config.backup.json") : null
     },
     `Pulled ${changes.length} version${changes.length === 1 ? "" : "s"} \u2192 ${configPath}` + (backedUp ? ` (previous copy: config.backup.json)` : "") + `
 Re-apply your edit on the new head, then: vos push ${configPath} --vos ${vosId}`
@@ -8753,9 +8323,9 @@ function storedProgramConfig(config, programDoc) {
   return lowerProgramDoc(doc).config;
 }
 async function readProgramDoc(dir, config) {
-  const docPath = join17(dir, "doc.json");
-  if (!existsSync15(docPath)) return null;
-  const parsed = JSON.parse(await readFile15(docPath, "utf8"));
+  const docPath = join15(dir, "doc.json");
+  if (!existsSync13(docPath)) return null;
+  const parsed = JSON.parse(await readFile13(docPath, "utf8"));
   if (typeof parsed !== "object" || parsed === null || "source" in parsed)
     return null;
   const raw = parsed;
@@ -8763,32 +8333,32 @@ async function readProgramDoc(dir, config) {
   return { ...raw, program: { ...program, config } };
 }
 async function setProgramStill(dir, t) {
-  const docPath = join17(dir, "doc.json");
+  const docPath = join15(dir, "doc.json");
   let doc = { program: {}, audio: [] };
-  if (existsSync15(docPath)) {
-    const parsed = JSON.parse(await readFile15(docPath, "utf8"));
+  if (existsSync13(docPath)) {
+    const parsed = JSON.parse(await readFile13(docPath, "utf8"));
     if (!parsed || typeof parsed !== "object" || "source" in parsed)
       throw new UsageError(
         `${docPath} is a take's document; a take's cover is its own "still" field`
       );
     doc = parsed;
   }
-  await writeFile11(docPath, JSON.stringify({ ...doc, still: t }, null, 2) + "\n");
+  await writeFile9(docPath, JSON.stringify({ ...doc, still: t }, null, 2) + "\n");
 }
 async function writeProgramDoc(dir, hosted) {
   const program = hosted.program && typeof hosted.program === "object" ? hosted.program : {};
   const { config, ...rest } = program;
   const onDisk = { ...hosted, program: rest };
-  await writeFile11(join17(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
+  await writeFile9(join15(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
   return {
     config: config && typeof config === "object" ? config : null
   };
 }
 
 // src/plugin/asset.ts
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash2 } from "crypto";
 import { readFileSync as readFileSync3 } from "fs";
-import { basename as basename5, extname as extname2 } from "path";
+import { basename as basename3, extname as extname2 } from "path";
 var BOOLEAN_FLAGS3 = /* @__PURE__ */ new Set(["json", "help"]);
 var MIME_BY_EXT = {
   ".png": "image/png",
@@ -8840,7 +8410,7 @@ async function cmdPush(argv) {
   const uploaded = [];
   let unfiledMedia = 0;
   for (const file of positionals) {
-    const name = basename5(file);
+    const name = basename3(file);
     const body = readFileSync3(file);
     const media = resolveMediaType({
       head: body.subarray(0, MEDIA_HEAD_BYTES),
@@ -8853,7 +8423,7 @@ async function cmdPush(argv) {
         put = await uploadAsset({ origin, key }, new Uint8Array(body), {
           filename: sent,
           contentType: media.type,
-          contentHash: createHash3("sha256").update(body).digest("hex"),
+          contentHash: createHash2("sha256").update(body).digest("hex"),
           ...folder ? { folderId: folder.id } : {}
         });
       } catch (e) {
@@ -8924,8 +8494,8 @@ async function cmdAsset(argv) {
 }
 
 // src/plugin/remove.ts
-import { existsSync as existsSync16, rmSync as rmSync2, statSync as statSync4 } from "fs";
-import { join as join18 } from "path";
+import { existsSync as existsSync14, rmSync as rmSync2, statSync as statSync3 } from "fs";
+import { join as join16 } from "path";
 import { createInterface as createInterface3 } from "readline/promises";
 
 // src/plugin/trash.ts
@@ -9104,7 +8674,7 @@ async function cmdDelete(argv) {
     api: strFlag(flags, "api")
   }).replace(/\/+$/, "");
   const key = requireCredential(strFlag(flags, "key"));
-  const dir = existsSync16(target) && statSync4(target).isDirectory() ? target : null;
+  const dir = existsSync14(target) && statSync3(target).isDirectory() ? target : null;
   const vosId = dir ? readSyncState(dir)?.vosId : parseVosId(target);
   if (!vosId)
     throw new UsageError(
@@ -9146,7 +8716,7 @@ async function cmdDelete(argv) {
     throw new Error(apiError(`delete ${vosId}`, res));
   let unlinked = false;
   if (dir) {
-    rmSync2(join18(dir, SYNC_STATE_NAME), { force: true });
+    rmSync2(join16(dir, SYNC_STATE_NAME), { force: true });
     unlinked = true;
   }
   const trashed = res.body.trashed === true;
@@ -9172,7 +8742,7 @@ async function cmdDelete(argv) {
 
 // src/plugin/buildProgram.ts
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
-import { basename as basename6, dirname as dirname5, join as join19, resolve as resolve7 } from "path";
+import { basename as basename4, dirname as dirname4, join as join17, resolve as resolve7 } from "path";
 import { pathToFileURL } from "url";
 import { parse } from "acorn";
 import { fullAncestor } from "acorn-walk";
@@ -9380,7 +8950,7 @@ async function cmdBuild(argv) {
     throw new UsageError(
       `${source} exports no program: \`export default { version: 2, duration, camera, createContent, createTimeline, \u2026 }\``
     );
-  const built = buildProgram(program, basename6(file), text);
+  const built = buildProgram(program, basename4(file), text);
   for (const p of built.problems) r.log(`error ${p.fn}: ${p.message}`);
   if (built.problems.length) {
     r.done(
@@ -9390,7 +8960,7 @@ async function cmdBuild(argv) {
     return EXIT_ERROR;
   }
   const out = resolve7(
-    strFlag(flags, "out") ?? join19(dirname5(file), "config.json")
+    strFlag(flags, "out") ?? join17(dirname4(file), "config.json")
   );
   writeFileSync2(out, JSON.stringify(built.config, null, 2) + "\n");
   const sidecar = out.replace(/\.json$/, "") + ".sources.json";
@@ -9407,8 +8977,8 @@ async function cmdBuild(argv) {
 
 // src/plugin/compare.ts
 import { spawnSync } from "child_process";
-import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
-import { join as join20, resolve as resolve8 } from "path";
+import { existsSync as existsSync15, mkdirSync as mkdirSync2, statSync as statSync4, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname5, join as join18, resolve as resolve8 } from "path";
 var BOOLEAN_FLAGS7 = /* @__PURE__ */ new Set(["json", "help"]);
 function sampleTimes(duration, every) {
   const step = every > 0 ? every : 1;
@@ -9474,6 +9044,12 @@ async function cmdCompare(argv) {
   for (const w of loaded.warnings) r.log(`note: ${w}`);
   const config = loaded.config;
   const duration = configDuration(config) ?? 5;
+  const assets = await programAssets(config, {
+    baseDir: existsSync15(source) && statSync4(source).isDirectory() ? source : dirname5(source),
+    origin: platformOrigin({}),
+    key: resolveCredential(),
+    log: (line) => r.log(line)
+  });
   const probed = probeSize(ref);
   const half = probed && probed.width > 1280 ? 2 : 1;
   const width = Number(
@@ -9492,9 +9068,9 @@ async function cmdCompare(argv) {
   try {
     for (const t of times) {
       const tag = t.toFixed(2);
-      const refPng = join20(outDir, `src-${tag}.png`);
-      const vosPng = join20(outDir, `vos-${tag}.png`);
-      const sheet = join20(outDir, `sheet-${tag}.png`);
+      const refPng = join18(outDir, `src-${tag}.png`);
+      const vosPng = join18(outDir, `vos-${tag}.png`);
+      const sheet = join18(outDir, `sheet-${tag}.png`);
       const grab = ffmpeg([
         "-v",
         "error",
@@ -9515,6 +9091,7 @@ async function cmdCompare(argv) {
         );
       const still = await renderStill(browser, {
         config,
+        assets,
         width,
         height,
         time: t
@@ -9550,7 +9127,7 @@ async function cmdCompare(argv) {
   } finally {
     await browser.close();
   }
-  const overview = join20(outDir, "overview.png");
+  const overview = join18(outDir, "overview.png");
   if (scores.length) {
     const inputs = scores.flatMap((s) => ["-i", s.sheet]);
     const scaled = scores.map((_, i) => `[${i}:v]scale=iw/3:-2[s${i}]`).join(";");
@@ -9576,7 +9153,7 @@ async function cmdCompare(argv) {
     overview
   };
   writeFileSync3(
-    join20(outDir, "report.json"),
+    join18(outDir, "report.json"),
     JSON.stringify(report, null, 2) + "\n"
   );
   r.done(
@@ -9587,28 +9164,28 @@ async function cmdCompare(argv) {
 }
 
 // src/plugin/port.ts
-import { existsSync as existsSync20, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
-import { dirname as dirname8, join as join24, resolve as resolve11 } from "path";
+import { existsSync as existsSync19, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
+import { dirname as dirname8, join as join22, resolve as resolve11 } from "path";
 import { pathToFileURL as pathToFileURL3 } from "url";
 
 // src/plugin/portInventory.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import {
-  existsSync as existsSync18,
+  existsSync as existsSync17,
   mkdirSync as mkdirSync3,
   readFileSync as readFileSync6,
-  readdirSync as readdirSync5,
+  readdirSync as readdirSync4,
   statSync as statSync6
 } from "fs";
-import { dirname as dirname6, join as join22, relative as relative2, resolve as resolve9 } from "path";
+import { dirname as dirname6, join as join20, relative as relative2, resolve as resolve9 } from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
 import { findFontFamily as findFontFamily3 } from "@vosjs/shared";
 
 // src/plugin/portRemotion.ts
-import { existsSync as existsSync17, readFileSync as readFileSync5, readdirSync as readdirSync4, statSync as statSync5 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync5, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
 import { createServer as createServer2 } from "http";
 import { createRequire } from "module";
-import { basename as basename7, extname as extname3, join as join21 } from "path";
+import { basename as basename5, extname as extname3, join as join19 } from "path";
 function themeColors(sources) {
   const out = {};
   const re = /\bconst\s+([A-Za-z_$][\w$]*)\s*(?::\s*string\s*)?=\s*['"](#[0-9a-fA-F]{3,8})['"]/g;
@@ -9672,16 +9249,16 @@ function sourceTexts(dir) {
   const out = [];
   const walk = (d, depth) => {
     if (depth > 4 || out.length > 200) return;
-    for (const name of readdirSync4(d)) {
+    for (const name of readdirSync3(d)) {
       if (name === "node_modules" || name.startsWith(".")) continue;
-      const p = join21(d, name);
+      const p = join19(d, name);
       if (statSync5(p).isDirectory()) walk(p, depth + 1);
       else if (/\.(tsx?|jsx?|mjs)$/.test(name))
         out.push(readFileSync5(p, "utf8"));
     }
   };
-  const src = join21(dir, "src");
-  walk(existsSync17(src) ? src : dir, 0);
+  const src = join19(dir, "src");
+  walk(existsSync16(src) ? src : dir, 0);
   return out;
 }
 function entryPoint(dir) {
@@ -9693,7 +9270,7 @@ function entryPoint(dir) {
     "remotion/index.ts",
     "remotion/index.tsx"
   ])
-    if (existsSync17(join21(dir, p))) return join21(dir, p);
+    if (existsSync16(join19(dir, p))) return join19(dir, p);
   return null;
 }
 var TYPES = {
@@ -9768,7 +9345,7 @@ async function readRemotion(dir, log) {
   const entry = entryPoint(dir);
   let bundler;
   try {
-    bundler = createRequire(join21(dir, "package.json"))("@remotion/bundler");
+    bundler = createRequire(join19(dir, "package.json"))("@remotion/bundler");
   } catch {
     log?.(
       "a Remotion project whose dependencies are not installed: run `npm install` in it so vos can read its compositions (words, scenes, faces); reading only the render"
@@ -9785,9 +9362,9 @@ async function readRemotion(dir, log) {
   } });
   const server = createServer2((rq, rs) => {
     const path = decodeURIComponent(new URL(rq.url ?? "/", "http://x").pathname);
-    let f = join21(out, path);
-    if (!f.startsWith(out) || !existsSync17(f) || statSync5(f).isDirectory())
-      f = join21(out, "index.html");
+    let f = join19(out, path);
+    if (!f.startsWith(out) || !existsSync16(f) || statSync5(f).isDirectory())
+      f = join19(out, "index.html");
     rs.writeHead(200, {
       "content-type": TYPES[extname3(f)] ?? "application/octet-stream"
     });
@@ -9886,10 +9463,10 @@ async function readRemotion(dir, log) {
       perScene.push({ scene: s.name, texts: read.texts ?? [] });
     }
     const sources = sourceTexts(dir);
-    const publicDir = join21(dir, "public");
+    const publicDir = join19(dir, "public");
     const media = tree.audio.map((a) => {
-      const name = basename7(a.src.split("?")[0]);
-      const local = existsSync17(join21(publicDir, name)) ? `public/${name}` : a.src;
+      const name = basename5(a.src.split("?")[0]);
+      const local = existsSync16(join19(publicDir, name)) ? `public/${name}` : a.src;
       return {
         kind: "audio",
         src: local,
@@ -9930,9 +9507,9 @@ async function readRemotion(dir, log) {
 
 // src/plugin/portInventory.ts
 function detectEngine(dir) {
-  if (existsSync18(join22(dir, "hyperframes.json"))) return "hyperframes";
-  const pkg = join22(dir, "package.json");
-  if (existsSync18(pkg)) {
+  if (existsSync17(join20(dir, "hyperframes.json"))) return "hyperframes";
+  const pkg = join20(dir, "package.json");
+  if (existsSync17(pkg)) {
     try {
       const p = JSON.parse(readFileSync6(pkg, "utf8"));
       const deps = { ...p.dependencies ?? {}, ...p.devDependencies ?? {} };
@@ -9946,14 +9523,14 @@ function detectEngine(dir) {
   return "page";
 }
 function sourcePage(source) {
-  if (!existsSync18(source)) return null;
+  if (!existsSync17(source)) return null;
   if (statSync6(source).isFile()) return /\.html?$/i.test(source) ? source : null;
-  const index = join22(source, "index.html");
-  return existsSync18(index) ? index : null;
+  const index = join20(source, "index.html");
+  return existsSync17(index) ? index : null;
 }
 function findRender(dir) {
-  const videos = (d) => existsSync18(d) ? readdirSync5(d).filter((f) => /\.(mp4|webm|mov)$/i.test(f)).map((f) => join22(d, f)) : [];
-  for (const d of [join22(dir, "renders"), join22(dir, "out"), dir]) {
+  const videos = (d) => existsSync17(d) ? readdirSync4(d).filter((f) => /\.(mp4|webm|mov)$/i.test(f)).map((f) => join20(d, f)) : [];
+  for (const d of [join20(dir, "renders"), join20(dir, "out"), dir]) {
     const found = videos(d);
     if (found.length) return found[0];
   }
@@ -10224,7 +9801,7 @@ var SEEK_AND_READ = `((args) => {
 })`;
 async function readInventory(source, opts) {
   const abs = resolve9(source);
-  const dir = existsSync18(abs) && statSync6(abs).isDirectory() ? abs : dirname6(abs);
+  const dir = existsSync17(abs) && statSync6(abs).isDirectory() ? abs : dirname6(abs);
   const engine = detectEngine(dir);
   const page = sourcePage(abs);
   const render = opts.render === void 0 ? findRender(dir) : opts.render;
@@ -10327,7 +9904,7 @@ async function readInventory(source, opts) {
   if (render && duration) {
     const has = spawnSync2("ffmpeg", ["-version"]).status === 0;
     if (has) {
-      const refDir = join22(opts.outDir, "ref");
+      const refDir = join20(opts.outDir, "ref");
       mkdirSync3(refDir, { recursive: true });
       const times = read.scenes.length >= 3 ? read.scenes.map(
         (s) => s.start + (s.duration ?? 1) / 2
@@ -10336,7 +9913,7 @@ async function readInventory(source, opts) {
         (_, i) => i + 0.5
       );
       for (const t of times.filter((t2) => t2 < duration)) {
-        const file = join22(refDir, `src-${t.toFixed(2)}.png`);
+        const file = join20(refDir, `src-${t.toFixed(2)}.png`);
         const ok = spawnSync2("ffmpeg", [
           "-v",
           "error",
@@ -10390,8 +9967,8 @@ async function readInventory(source, opts) {
 
 // src/plugin/portScaffold.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { copyFileSync, existsSync as existsSync19, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
-import { basename as basename8, dirname as dirname7, join as join23, resolve as resolve10 } from "path";
+import { copyFileSync, existsSync as existsSync18, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
+import { basename as basename6, dirname as dirname7, join as join21, resolve as resolve10 } from "path";
 import { findFontFamily as findFontFamily4, fontFaceUrl, nearestFontWeight } from "@vosjs/shared";
 
 // src/plugin/painterLib.ts
@@ -10801,8 +10378,8 @@ function planScaffold(inv, opts) {
   const copies = [];
   inv.media.filter((m) => m.kind === "audio" && m.src).forEach((m, i) => {
     const from = resolve10(opts.sourceDir, m.src);
-    const name = basename8(from);
-    if (!existsSync19(from)) {
+    const name = basename6(from);
+    if (!existsSync18(from)) {
       report.push(
         `- the audio ${m.src} is not in the source folder; add it to doc.json by hand`
       );
@@ -10945,7 +10522,7 @@ ${sceneTodos}${springHint}
 }
 function reportText(inv, r) {
   const lines = [
-    `# Port report: ${inv.source === "." && inv.root ? basename8(inv.root) : inv.source}`,
+    `# Port report: ${inv.source === "." && inv.root ? basename6(inv.root) : inv.source}`,
     "",
     `${inv.engine} piece, ${inv.width}\xD7${inv.height}${inv.fps ? ` at ${inv.fps} fps` : ""}, ${inv.duration ?? "?"} s. A program has no size of its own: render it with \`--width ${inv.width} --height ${inv.height}\`.`,
     "",
@@ -11000,13 +10577,13 @@ function reportText(inv, r) {
 }
 function writeScaffold(plan, outDir) {
   mkdirSync4(outDir, { recursive: true });
-  writeFileSync4(join23(outDir, "program.mjs"), plan.program);
+  writeFileSync4(join21(outDir, "program.mjs"), plan.program);
   writeFileSync4(
-    join23(outDir, "doc.json"),
+    join21(outDir, "doc.json"),
     JSON.stringify(plan.doc, null, 2) + "\n"
   );
-  writeFileSync4(join23(dirname7(outDir), "REPORT.md"), plan.report);
-  for (const [from, name] of plan.copies) copyFileSync(from, join23(outDir, name));
+  writeFileSync4(join21(dirname7(outDir), "REPORT.md"), plan.report);
+  for (const [from, name] of plan.copies) copyFileSync(from, join21(outDir, name));
 }
 function probeAudioDuration(file) {
   const res = spawnSync3(
@@ -11040,7 +10617,7 @@ async function inventory(argv) {
     outDir,
     log: (l) => r.log(`note: ${l}`)
   });
-  const file = join24(outDir, "inventory.json");
+  const file = join22(outDir, "inventory.json");
   writeFileSync5(file, JSON.stringify(inv, null, 2) + "\n");
   const missing = inv.fonts.filter((f) => !f.catalog).map((f) => f.family);
   r.log(
@@ -11072,32 +10649,32 @@ function summary(inv) {
 async function scaffold(argv) {
   const { flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   const r = createReporter(flags.json === true);
-  const from = resolve11(strFlag(flags, "from") ?? join24("port", "inventory.json"));
-  if (!existsSync20(from))
+  const from = resolve11(strFlag(flags, "from") ?? join22("port", "inventory.json"));
+  if (!existsSync19(from))
     throw new UsageError(
       `no inventory at ${from}: run npx vos port inventory <source> first`
     );
   const inv = JSON.parse(readFileSync7(from, "utf8"));
   const outDir = resolve11(
-    strFlag(flags, "out") ?? join24(dirname8(from), "program")
+    strFlag(flags, "out") ?? join22(dirname8(from), "program")
   );
   const plan = planScaffold(inv, {
     sourceDir: scaffoldSourceDir(inv),
     probeDuration: probeAudioDuration
   });
   writeScaffold(plan, outDir);
-  const programFile = join24(outDir, "program.mjs");
+  const programFile = join22(outDir, "program.mjs");
   const mod = await import(`${pathToFileURL3(programFile).href}?t=${Date.now()}`);
   const built = buildProgram(mod.default, "program.mjs", plan.program);
   for (const p of built.problems) r.log(`error ${p.fn}: ${p.message}`);
   if (built.problems.length) return EXIT_ERROR;
   writeFileSync5(
-    join24(outDir, "config.json"),
+    join22(outDir, "config.json"),
     JSON.stringify(built.config, null, 2) + "\n"
   );
   r.done(
-    { program: outDir, report: join24(dirname8(outDir), "REPORT.md") },
-    `Wrote ${outDir}/program.mjs, config.json and doc.json, and ${join24(dirname8(outDir), "REPORT.md")}. Translate the motion where it says TODO, then: npx vos build program.mjs && npx vos compare . --against <their render>`
+    { program: outDir, report: join22(dirname8(outDir), "REPORT.md") },
+    `Wrote ${outDir}/program.mjs, config.json and doc.json, and ${join22(dirname8(outDir), "REPORT.md")}. Translate the motion where it says TODO, then: npx vos build program.mjs && npx vos compare . --against <their render>`
   );
   return EXIT_OK;
 }
@@ -11108,11 +10685,11 @@ function scaffoldSourceDir(inv) {
 
 // src/plugin/recipe.ts
 import { readFileSync as readFileSync8 } from "fs";
-import { basename as basename9 } from "path";
+import { basename as basename7 } from "path";
 var BOOLEAN_FLAGS9 = /* @__PURE__ */ new Set(["json", "help"]);
 var USAGE = "vos recipe push <file.md> (--folder <folderId|slug> | --asset <assetId>)";
 function recipeFilename(file) {
-  const name = basename9(file);
+  const name = basename7(file);
   if (!/\.md$/i.test(name)) {
     throw new UsageError(`a recipe is a markdown file \u2014 ${name} is not .md`);
   }
@@ -11199,7 +10776,7 @@ async function cmdRecipe(argv) {
 }
 
 // src/plugin/brand.ts
-import { writeFile as writeFile12 } from "fs/promises";
+import { writeFile as writeFile10 } from "fs/promises";
 import { resolve as resolve12 } from "path";
 import { parseFrontmatter as parseFrontmatter2 } from "@vosjs/shared/frontmatter";
 import { lookKindForGround } from "@vosjs/studio-core";
@@ -11553,7 +11130,7 @@ async function cmdBrand(argv) {
     composition,
     llms?.claim ?? design?.description ?? null
   );
-  await writeFile12(out, md);
+  await writeFile10(out, md);
   const k = composition.kit;
   r.done(
     {
@@ -11668,7 +11245,7 @@ async function recordHosted(input) {
 }
 
 // src/plugin/agentBrowser.ts
-import { writeFile as writeFile13 } from "fs/promises";
+import { writeFile as writeFile11 } from "fs/promises";
 import { resolve as resolve13 } from "path";
 function parseAgentBrowserLog(text) {
   const records = [];
@@ -12148,8 +11725,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: readFile18 } = await import("fs/promises");
-  const text = await readFile18(resolve13(input), "utf8");
+  const { readFile: readFile16 } = await import("fs/promises");
+  const text = await readFile16(resolve13(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -12166,7 +11743,7 @@ async function cmdActions(argv) {
     );
     return EXIT_ERROR;
   }
-  await writeFile13(out, `${JSON.stringify(result.actions, null, 2)}
+  await writeFile11(out, `${JSON.stringify(result.actions, null, 2)}
 `);
   r.done(
     { ok: true, out, url: result.actions.url ?? null, ...summary2(result) },
@@ -12186,9 +11763,9 @@ function summary2(result) {
 }
 async function cmdActionsScript(input, flags) {
   const r = createReporter(flags.json === true);
-  const { readFile: readFile18 } = await import("fs/promises");
+  const { readFile: readFile16 } = await import("fs/promises");
   const { shotList, formatShotList } = await import("./shotList-KH6FTX4L.js");
-  const raw = JSON.parse(await readFile18(resolve13(input), "utf8"));
+  const raw = JSON.parse(await readFile16(resolve13(input), "utf8"));
   const errors = validateActions(raw);
   if (errors.length) throw new UsageError(`${input}:
   ${errors.join("\n  ")}`);
@@ -12198,9 +11775,9 @@ async function cmdActionsScript(input, flags) {
 }
 
 // src/plugin/ingest.ts
-import { existsSync as existsSync21 } from "fs";
-import { copyFile, mkdir as mkdir10, readFile as readFile16, stat as stat4 } from "fs/promises";
-import { basename as basename10, join as join25, resolve as resolve14 } from "path";
+import { existsSync as existsSync20 } from "fs";
+import { copyFile, mkdir as mkdir8, readFile as readFile14, stat as stat3 } from "fs/promises";
+import { basename as basename8, join as join23, resolve as resolve14 } from "path";
 import { inflateRawSync } from "zlib";
 import {
   cursorFromPlaywrightTrace,
@@ -12281,14 +11858,14 @@ async function copyRecording(src, dest, ext) {
   }
 }
 async function readTraceFile(path, offsetMs) {
-  const kind = traceKindOf(basename10(path));
+  const kind = traceKindOf(basename8(path));
   if (!kind) {
     throw new UsageError(
       `${path}: not a trace the recorder reads (trace.zip, .trace, .jsonl, .json or .csv)`
     );
   }
   if (kind === "zip") {
-    const bytes = new Uint8Array(await readFile16(path));
+    const bytes = new Uint8Array(await readFile14(path));
     const entry = playwrightTraceEntry(zipEntries(bytes));
     if (!entry) {
       throw new UsageError(
@@ -12301,8 +11878,8 @@ async function readTraceFile(path, offsetMs) {
     );
     return cursorFromPlaywrightTrace(text2, { offsetMs });
   }
-  const text = await readFile16(path, "utf8");
-  return cursorFromTrace(basename10(path), text, { offsetMs });
+  const text = await readFile14(path, "utf8");
+  return cursorFromTrace(basename8(path), text, { offsetMs });
 }
 function parseViewport(v) {
   if (!v) return null;
@@ -12318,7 +11895,7 @@ async function cmdIngest(argv) {
       "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]"
     );
   const videoPath = resolve14(source);
-  if (!existsSync21(videoPath)) throw new UsageError(`${source}: no such file`);
+  if (!existsSync20(videoPath)) throw new UsageError(`${source}: no such file`);
   const r = createReporter(flags.json === true);
   const outDir = resolve14(strFlag(flags, "out") ?? "take");
   const offsetMs = numFlag(flags, "offset", 0);
@@ -12333,7 +11910,7 @@ async function cmdIngest(argv) {
       "note: finished footage opens bare, so --background is not used (pass --as take for the screen-recording card and its ground)"
     );
   const backdrop = footage ? null : await takeBackdrop(flags, r);
-  r.log(`probing ${basename10(videoPath)}\u2026`);
+  r.log(`probing ${basename8(videoPath)}\u2026`);
   const probed = await probeVideoFile(videoPath);
   if (!(probed.durationMs > 0)) {
     throw new UsageError(
@@ -12345,15 +11922,15 @@ async function cmdIngest(argv) {
     trace = await readTraceFile(resolve14(cursorPath), offsetMs);
     for (const n of trace.notes) r.log(`note: ${n}`);
   }
-  if (existsSync21(join25(outDir, "meta.json"))) {
+  if (existsSync20(join23(outDir, "meta.json"))) {
     const { prevDoc, kept } = await prepareReRecord(outDir);
     r.log(
       `note: re-ingesting into ${outDir}; kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? `; apply the previous cut with: vos plan ${outDir} --reuse` : "")
     );
   }
-  await mkdir10(outDir, { recursive: true });
+  await mkdir8(outDir, { recursive: true });
   const paths = await ensureTakeDir(outDir);
-  const recording = join25(outDir, `recording.${probed.ext}`);
+  const recording = join23(outDir, `recording.${probed.ext}`);
   r.log("copying the recording\u2026");
   const remuxed = await copyRecording(videoPath, recording, probed.ext);
   const viewport = viewportFlag ?? trace?.viewport ?? {
@@ -12361,7 +11938,7 @@ async function cmdIngest(argv) {
     height: probed.height
   };
   const events = trace?.events ?? [];
-  const fileStat = await stat4(videoPath);
+  const fileStat = await stat3(videoPath);
   const meta = {
     dpr: 1,
     zoom: 1,
@@ -12382,13 +11959,13 @@ async function cmdIngest(argv) {
   const clicks = events.filter((e) => e.type === "down").length;
   const seconds = (probed.durationMs / 1e3).toFixed(1);
   const facts = `${seconds}s, ${probed.width}\xD7${probed.height} @ ${meta.fps} fps${probed.hasAudio ? ", audio" : ", no audio"}${remuxed ? "" : ", copied as is"}`;
-  const cursorLine = trace ? `${events.length} cursor events (${clicks} clicks) from ${basename10(cursorPath)}${trace.dropped ? `, ${trace.dropped} not placed` : ""}; ${plan.zoomAuto} zoom${plan.zoomAuto === 1 ? "" : "s"} planned` : "no cursor track, so nothing was planned";
+  const cursorLine = trace ? `${events.length} cursor events (${clicks} clicks) from ${basename8(cursorPath)}${trace.dropped ? `, ${trace.dropped} not placed` : ""}; ${plan.zoomAuto} zoom${plan.zoomAuto === 1 ? "" : "s"} planned` : "no cursor track, so nothing was planned";
   const opened = footage ? `opened as finished footage: no card, no browser bar, no drawn cursor, ${meta.fps > 30 ? 60 : 30} fps export (--as take for a screen recording's card)` : `opened as a screen recording: the card, its ground and the drawn cursor (--as footage to open it bare)`;
   const next = footage && !trace ? `Next: vos push ${outDir} --wait \u2014 it lands as it is; trim or add to it in the studio` : trace ? `Next: vos digest ${outDir} \u2014 look before you cut; edit doc.json; vos push ${outDir}` : `Add --cursor <trace> recorded beside the video (a Playwright trace.zip, stamped JSON records, or a t,x,y,type CSV) to plan zooms from its clicks; else place them by eye: vos frames ${outDir} --times 0,25%,50%,75%,100%, then edit doc.json`;
   r.done(
     {
       out: outDir,
-      recording: basename10(recording),
+      recording: basename8(recording),
       durationMs: probed.durationMs,
       width: probed.width,
       height: probed.height,
@@ -12397,7 +11974,7 @@ async function cmdIngest(argv) {
       hasAudio: probed.hasAudio,
       remuxed,
       cursor: trace ? {
-        file: basename10(cursorPath),
+        file: basename8(cursorPath),
         kind: trace.kind,
         events: events.length,
         clicks,
@@ -12409,7 +11986,7 @@ async function cmdIngest(argv) {
       backdrop: plan.backdrop ?? null,
       as: footage ? "footage" : "take"
     },
-    `Ingested ${basename10(videoPath)} \u2192 ${outDir}/${basename10(recording)} (${facts})
+    `Ingested ${basename8(videoPath)} \u2192 ${outDir}/${basename8(recording)} (${facts})
   ${opened}
   ${cursorLine}
   ${next}`
@@ -12421,19 +11998,19 @@ async function cmdIngest(argv) {
 import { spawnSync as spawnSync4 } from "child_process";
 import {
   cpSync,
-  existsSync as existsSync23,
+  existsSync as existsSync22,
   mkdirSync as mkdirSync6,
   readFileSync as readFileSync10,
   rmSync as rmSync3,
   writeFileSync as writeFileSync6
 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join27 } from "path";
+import { join as join25 } from "path";
 import { chromium as chromium2 } from "playwright";
 
 // src/plugin/machine.ts
-import { existsSync as existsSync22, readFileSync as readFileSync9, readdirSync as readdirSync6, statSync as statSync7 } from "fs";
-import { dirname as dirname9, join as join26 } from "path";
+import { existsSync as existsSync21, readFileSync as readFileSync9, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
+import { dirname as dirname9, join as join24 } from "path";
 var AGENT_NAMES = [
   "claude",
   "cursor",
@@ -12453,17 +12030,17 @@ var HOME_DIRS = {
   copilot: [".copilot"]
 };
 function detectAgents(root, opts = {}) {
-  const exists = opts.exists ?? existsSync22;
+  const exists = opts.exists ?? existsSync21;
   const out = [];
   for (const agent of AGENT_NAMES) {
     for (const rel of PROJECT_DIRS[agent]) {
-      const dir = join26(root, rel);
+      const dir = join24(root, rel);
       if (exists(dir)) out.push({ agent, dir, scope: "project" });
     }
-    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join26(root, ".github", "copilot-instructions.md"))) {
+    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join24(root, ".github", "copilot-instructions.md"))) {
       out.push({
         agent,
-        dir: join26(root, ".github", "copilot"),
+        dir: join24(root, ".github", "copilot"),
         scope: "project"
       });
     }
@@ -12471,7 +12048,7 @@ function detectAgents(root, opts = {}) {
   if (opts.global && opts.home) {
     for (const agent of AGENT_NAMES) {
       for (const rel of HOME_DIRS[agent]) {
-        const dir = join26(opts.home, rel);
+        const dir = join24(opts.home, rel);
         if (exists(dir)) out.push({ agent, dir, scope: "global" });
       }
     }
@@ -12489,26 +12066,26 @@ function agentsFromFlag(value, root) {
   return {
     homes: wanted.map((agent) => ({
       agent,
-      dir: join26(root, PROJECT_DIRS[agent][0]),
+      dir: join24(root, PROJECT_DIRS[agent][0]),
       scope: "project"
     }))
   };
 }
 function skillsDirFor(home) {
-  return join26(home.dir, "skills");
+  return join24(home.dir, "skills");
 }
 function fallbackSkillsHome(root) {
-  return { agent: "codex", dir: join26(root, ".agents"), scope: "project" };
+  return { agent: "codex", dir: join24(root, ".agents"), scope: "project" };
 }
-function installedSkills(dir, exists = existsSync22, list = (p) => {
+function installedSkills(dir, exists = existsSync21, list = (p) => {
   try {
-    return readdirSync6(p);
+    return readdirSync5(p);
   } catch {
     return [];
   }
 }) {
   if (!exists(dir)) return [];
-  return list(dir).filter((name) => exists(join26(dir, name, "SKILL.md"))).sort();
+  return list(dir).filter((name) => exists(join24(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 -->";
@@ -12541,10 +12118,10 @@ ${RULES_BLOCK}
   }
   return { text, changed: text !== current };
 }
-function rulesFileFor(root, exists = existsSync22) {
-  const agents = join26(root, "AGENTS.md");
+function rulesFileFor(root, exists = existsSync21) {
+  const agents = join24(root, "AGENTS.md");
   if (exists(agents)) return agents;
-  const claude = join26(root, "CLAUDE.md");
+  const claude = join24(root, "CLAUDE.md");
   if (exists(claude)) return claude;
   return agents;
 }
@@ -12553,14 +12130,14 @@ function chromeCandidates(platform, env) {
     return ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"];
   if (platform === "win32")
     return [
-      join26(
+      join24(
         env["PROGRAMFILES"] ?? "C:\\Program Files",
         "Google",
         "Chrome",
         "Application",
         "chrome.exe"
       ),
-      join26(
+      join24(
         env["LOCALAPPDATA"] ?? "",
         "Google",
         "Chrome",
@@ -12647,13 +12224,13 @@ function doctorReport(facts) {
 function bundledSkillsDir(from) {
   let dir = dirname9(from);
   for (let i = 0; i < 6; i++) {
-    const pkg = join26(dir, "package.json");
-    if (existsSync22(pkg)) {
+    const pkg = join24(dir, "package.json");
+    if (existsSync21(pkg)) {
       try {
         const name = JSON.parse(readFileSync9(pkg, "utf8")).name;
         if (name === "@vosjs/cli") {
-          const skills = join26(dir, "skills");
-          return existsSync22(skills) && statSync7(skills).isDirectory() ? skills : null;
+          const skills = join24(dir, "skills");
+          return existsSync21(skills) && statSync7(skills).isDirectory() ? skills : null;
         }
       } catch {
       }
@@ -12684,7 +12261,7 @@ function npx() {
 function bundledChromium() {
   try {
     const p = chromium2.executablePath();
-    return p && existsSync23(p) ? p : null;
+    return p && existsSync22(p) ? p : null;
   } catch {
     return null;
   }
@@ -12693,7 +12270,7 @@ function probe2() {
   return probeBrowser({
     platform: process.platform,
     env: process.env,
-    exists: existsSync23,
+    exists: existsSync22,
     bundled: bundledChromium
   });
 }
@@ -12797,7 +12374,7 @@ async function cmdSetup(argv) {
         const dest = skillsDirFor(home);
         mkdirSync6(dest, { recursive: true });
         for (const name of installedSkills(bundled)) {
-          cpSync(join27(bundled, name), join27(dest, name), { recursive: true });
+          cpSync(join25(bundled, name), join25(dest, name), { recursive: true });
         }
       }
       skillsVia = "bundled";
@@ -12832,7 +12409,7 @@ async function cmdSetup(argv) {
   let rules = null;
   if (!noRules) {
     const file = rulesFileFor(root);
-    const existing = existsSync23(file) ? readFileSync10(file, "utf8") : null;
+    const existing = existsSync22(file) ? readFileSync10(file, "utf8") : null;
     const { text, changed } = applyRulesBlock(existing);
     if (changed) writeFileSync6(file, text);
     rules = { file, changed };
@@ -12946,7 +12523,7 @@ async function cmdWhoami(argv) {
 function cmdLogout(argv) {
   const { flags } = parseArgs(argv, BOOLEAN_FLAGS11);
   const r = reporterFor(flags);
-  const had = existsSync23(CREDENTIALS_PATH);
+  const had = existsSync22(CREDENTIALS_PATH);
   rmSync3(CREDENTIALS_PATH, { force: true });
   const envKey = Boolean(process.env.VOS_API_KEY?.trim());
   r.done(
@@ -13300,7 +12877,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 readFile17(file, "utf8"));
+  const raw = JSON.parse(await readFile15(file, "utf8"));
   const errors = validateActions(raw);
   if (errors.length)
     throw new UsageError(`invalid actions file:
@@ -13363,7 +12940,7 @@ function takeStorageState(flags) {
   const raw = strFlag(flags, "storage-state");
   if (!raw) return void 0;
   const path = resolve15(raw);
-  if (!existsSync24(path))
+  if (!existsSync23(path))
     throw new UsageError(`--storage-state: no such file: ${path}`);
   return path;
 }
@@ -13376,7 +12953,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 (!existsSync24(sessionDir(name)))
+  if (!existsSync23(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)`
     );
@@ -13568,7 +13145,7 @@ async function cmdRecord(argv) {
         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 failed2 = rec.skipped.length > 0 || rec.navTimeout || maskMisses(rec).length > 0;
+      const failed = rec.skipped.length > 0 || rec.navTimeout || maskMisses(rec).length > 0;
       const carried = [
         ...strFlag(flags, "storage-state") ? [`--storage-state ${strFlag(flags, "storage-state")}`] : [],
         ...browserArgs.map((a) => `--browser-arg=${a}`),
@@ -13580,7 +13157,7 @@ async function cmdRecord(argv) {
       r.done(
         {
           dryRun: true,
-          ok: !failed2,
+          ok: !failed,
           seconds: +((Date.now() - started) / 1e3).toFixed(1),
           steps,
           skipped: rec.skipped,
@@ -13588,24 +13165,24 @@ async function cmdRecord(argv) {
           exposures: rec.exposures,
           masks: rec.masks
         },
-        `${failed2 ? "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"}: ${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)" : ""}
 ${lines.join("\n")}
-  ${maskMisses(rec).length ? `MASK hid nothing: ${maskMisses(rec).join(", ")} (the selector reached no element). ` : ""}${failed2 ? "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). ` : ""}${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)}`
       );
-      return failed2 ? EXIT_USAGE : EXIT_OK;
+      return failed ? EXIT_USAGE : EXIT_OK;
     } finally {
       await browser2.close();
     }
   }
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync24(join28(outDir, "meta.json"))) {
+    if (existsSync23(join26(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 mkdir11(outDir, { recursive: true });
+    await mkdir9(outDir, { recursive: true });
     await ensureTakeDir(outDir);
   };
   const browser = await launchBrowser(browserArgs);
@@ -13664,7 +13241,7 @@ ${lines.join("\n")}
       },
       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 ${join28(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}`
+  Next: edit ${join26(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -13690,7 +13267,7 @@ async function cmdCreate2(argv) {
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
   const outDir = resolve15(strFlag(flags, "out") ?? "take");
   const format = videoFormat(strFlag(flags, "format"), positionals[0]);
-  const out = positionals[0] ?? join28(outDir, `out.${format}`);
+  const out = positionals[0] ?? join26(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");
@@ -13703,13 +13280,13 @@ async function cmdCreate2(argv) {
   const headers = takeHeaders(multi);
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync24(join28(outDir, "meta.json"))) {
+    if (existsSync23(join26(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 mkdir11(outDir, { recursive: true });
+    await mkdir9(outDir, { recursive: true });
     await ensureTakeDir(outDir);
   };
   const browser = await launchBrowser(browserArgs);
@@ -13810,24 +13387,24 @@ async function cmdPlan(argv) {
     );
   const r = createReporter(flags.json === true);
   if (flags.fresh === true) {
-    await rm5(join28(dir, "doc.json"), { force: true });
+    await rm3(join26(dir, "doc.json"), { force: true });
     r.log("note: --fresh discarded the existing doc.json");
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve15(strFlag(flags, "from") ?? join28(dir, PREV_DOC_NAME));
-    if (!existsSync24(from)) {
+    const from = resolve15(strFlag(flags, "from") ?? join26(dir, PREV_DOC_NAME));
+    if (!existsSync23(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 readFile17(from, "utf8"))
+      doc: JSON.parse(await readFile15(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const hasDoc = existsSync24(join28(dir, "doc.json"));
+  const hasDoc = existsSync23(join26(dir, "doc.json"));
   const backdrop = hasDoc ? null : await takeBackdrop(flags, r);
   const release = await releaseInputs(dir, flags, r, multi.with ?? []);
   const motionWanted = !hasDoc || flags.motion === true || flags.fresh === true;
@@ -13885,7 +13462,7 @@ async function cmdPlan(argv) {
       ...s.motion ? { motion: s.motion } : {},
       ...s.reuse ? { reuse: s.reuse } : {}
     },
-    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join28(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"} ${join26(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}`
   );
   return EXIT_OK;
 }
@@ -14008,7 +13585,7 @@ async function cmdRender(argv) {
     );
   const r = createReporter(flags.json === true);
   const format = videoFormat(strFlag(flags, "format"), positionals[1]);
-  const out = positionals[1] ?? join28(dir, `out.${format}`);
+  const out = positionals[1] ?? join26(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");
@@ -14255,15 +13832,15 @@ async function resolveStyleRef(flags) {
 }
 async function resolveDocRef(ref, flags, what) {
   const styleRef = ref;
-  const file = existsSync24(styleRef) ? resolve15(
+  const file = existsSync23(styleRef) ? resolve15(
     styleRef,
-    existsSync24(join28(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync23(join26(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync24(file)) {
+  if (file && existsSync23(file)) {
     return {
       from: file,
       doc: migrateHostedDoc5(
-        JSON.parse(await readFile17(file, "utf8"))
+        JSON.parse(await readFile15(file, "utf8"))
       )
     };
   }
@@ -14315,7 +13892,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 readFile17(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;
@@ -14346,7 +13923,7 @@ async function cmdDigest(argv) {
         kinds,
         frames: d.images.full,
         crops: d.images.crop,
-        sheet: d.images.sheet ? join28(result.outDir, d.images.sheet) : null,
+        sheet: d.images.sheet ? join26(result.outDir, d.images.sheet) : null,
         scenes: kinds.scene ?? 0,
         sourceDuration: d.take.sourceDuration,
         outputDuration: d.take.outputDuration,
@@ -14374,7 +13951,7 @@ async function cmdOpen(argv) {
   if (!dir) throw new UsageError("vos open <take> [--studio <url>]");
   const r = createReporter(flags.json === true);
   const take = await loadTake(dir);
-  if (!existsSync24(take.paths.recording)) {
+  if (!existsSync23(take.paths.recording)) {
     throw new UsageError(`${dir} has no recording \u2014 re-run record`);
   }
   const studio = (strFlag(flags, "studio") ?? platformOrigin()).replace(
@@ -14415,12 +13992,12 @@ async function cmdJudge(argv) {
       "vos judge <kit.json> --against <MANIFEST.json> [--out dir] [--json]\n(the manifest names the reference set: id, file, role, layout, facts, rule per asset)"
     );
   const r = createReporter(flags.json === true);
-  const kitFile = target.endsWith("kit.json") ? target : join28(target, "kit.json");
-  if (!existsSync24(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
-  if (!existsSync24(against))
+  const kitFile = target.endsWith("kit.json") ? target : join26(target, "kit.json");
+  if (!existsSync23(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
+  if (!existsSync23(against))
     throw new UsageError(`${against}: no reference manifest`);
   const result = await judgeKit(kitFile, against, strFlag(flags, "out"));
-  const verdicts = JSON.parse(await readFile17(result.verdictFile, "utf8")).verdicts;
+  const verdicts = JSON.parse(await readFile15(result.verdictFile, "utf8")).verdicts;
   const rate = winRate(verdicts);
   const lines = result.sheets.map(
     (s) => `${s.asset} vs ${s.reference}: ${s.sheetA}, ${s.sheetB}, ${s.rubric}`
@@ -14460,7 +14037,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 readFile17(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"),
@@ -14539,7 +14116,7 @@ async function cmdValidate(argv) {
   const target = positionals[0];
   if (!target) throw new UsageError("vos validate <actions.json|take>");
   const r = createReporter(flags.json === true);
-  const kitTarget = target.endsWith("kit.json") ? target : existsSync24(join28(target, "kit.json")) && !isTakeDir(target) ? join28(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync23(join26(target, "kit.json")) && !isTakeDir(target) ? join26(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -14571,9 +14148,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync24(join28(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync23(join26(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile17(join28(target, "config.json"), "utf8")
+      await readFile15(join26(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -14614,7 +14191,7 @@ async function cmdValidate(argv) {
   const take = await loadTake(target);
   const problems = [];
   const warnings = [];
-  if (!existsSync24(take.paths.recording)) {
+  if (!existsSync23(take.paths.recording)) {
     problems.push("missing recording (re-run record)");
   } else {
     const mismatch = containerMismatch(
@@ -14966,7 +14543,7 @@ async function cmdSession(argv) {
       if (!arg) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync24(sessionDir(arg)))
+      if (!existsSync23(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const summary3 = await summarizeSession(arg);
       const url = strFlag(flags, "url");
@@ -15047,10 +14624,6 @@ async function cmdSession(argv) {
 
 export {
   validateActions,
-  RECORDING_NAME,
-  takePaths,
-  loadTake,
-  pullMedia,
   startTakeServer,
   waitForPageDone,
   renderAnimation,
@@ -15070,4 +14643,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-67L7FPJR.js.map
+//# sourceMappingURL=chunk-NE5MHC3D.js.map