@vosjs/cli 0.41.0 → 0.42.0

package/dist/cli.js

@@ -221,7 +221,9 @@ var HELP_CONVENTIONS = `
 Conventions
   Results go to stdout; logs go to stderr. --json switches stdout to NDJSON
   events ending with {"event":"done",\u2026}. Exit codes: 0 ok, 1 error, 2 usage,
-  3 no browser available.
+  3 no browser available, 4 the recorder met a sign-in instead of the page
+  it was asked for (nothing was recorded; it needs a session, not a new
+  script). vos <verb> --help prints that verb's flags.
 `;
 function outName(source, ext) {
   const base = basename(source).replace(/\.[a-z0-9]+$/i, "") || "vos";
@@ -509,7 +511,7 @@ async function cmdCheck(argv) {
   return result.ok ? EXIT_OK : EXIT_ERROR;
 }
 async function delegate(argv, viaAlias = false) {
-  const { run } = await import("./run-5PCYT25T.js");
+  const { run } = await import("./run-WN2IO3WL.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".
@@ -545,6 +547,18 @@ async function main() {
   }
   if (cmd === "--version") return cmdVersions(["--json"]);
   if (!ENGINE_VERBS.has(cmd) && cmd !== "voila") return delegate([cmd, ...rest]);
+  if (rest.includes("--help") || rest.includes("-h")) {
+    const engine = HELP_ENGINE.split("\n").filter(
+      (l) => l.startsWith(`  vos ${cmd} `)
+    );
+    const { verbHelp } = await import("./run-WN2IO3WL.js");
+    const take = verbHelp(cmd);
+    process.stdout.write(
+      `${engine.join("\n")}
+${take.includes("no such verb") ? "" : take}`
+    );
+    return EXIT_OK;
+  }
   switch (cmd) {
     case "render":
       return cmdRender(rest);
@@ -569,7 +583,7 @@ async function main() {
 main().then(async (code) => {
   if (code === EXIT_OK) {
     const verb = process.argv[2] ?? "";
-    const { HELP } = await import("./run-5PCYT25T.js");
+    const { HELP } = await import("./run-WN2IO3WL.js");
     const documented = [
       ...helpFlagsFor(HELP_ENGINE, verb),
       ...helpFlagsFor(HELP, verb)

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/output.ts","../src/check.ts"],"sourcesContent":["import { writeFile } from 'node:fs/promises'\nimport { readFileSync } from 'node:fs'\nimport { basename, dirname, join } from 'node:path'\nimport { createServer } from 'node:http'\nimport { createRequire } from 'node:module'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs, numFlag, UsageError } from './args'\nimport { helpFlagsFor, unusedFlagsMessage } from './flagUse'\nimport {\n  createReporter,\n  EXIT_ERROR,\n  EXIT_NO_BROWSER,\n  EXIT_OK,\n  EXIT_USAGE,\n} from './output'\nimport {\n  loadVosConfig,\n  configDuration,\n  directoryKind,\n  loadProgramDirectory,\n  readSourceText,\n} from './loadConfig'\nimport { launchBrowser, BrowserUnavailableError } from './browser'\nimport { renderVideo, renderStill, previewPages } from './render'\nimport { runCheck } from './check'\n\nconst BOOLEAN_FLAGS = new Set(['json', 'help', 'version'])\n\nconst HELP_ENGINE = `vos — command line for the vos programmatic video engine (https://vos.so/engine)\n\nEngine verbs (local, no account, no network beyond the render page's CDN deps)\n  vos render <config.json|url|take> [out] [--width 1920] [--height 1080] [--fps 30]\n                               [--duration <s>] [--format webm|mp4] [--json]\n  vos still  <config.json|url> [out.webp] [--time 0] [--width] [--height] [--json]\n  vos info   <config.json|url> [--json]\n  vos check  <config.json|url> [--json]\n             migrate → schema → syntax → compile → determinism/dialect lints, all local\n  vos preview <config.json|url> [--port 0]\n  vos versions [--json]\n`\n\nconst HELP_CONVENTIONS = `\nConventions\n  Results go to stdout; logs go to stderr. --json switches stdout to NDJSON\n  events ending with {\"event\":\"done\",…}. Exit codes: 0 ok, 1 error, 2 usage,\n  3 no browser available.\n`\n\nfunction outName(source: string, ext: string): string {\n  const base = basename(source).replace(/\\.[a-z0-9]+$/i, '') || 'vos'\n  return `${base}.${ext}`\n}\n\nasync function cmdRender(argv: string[]): Promise<number> {\n  // Polymorphic render: a take DIRECTORY (its doc.json is a recording\n  // document) renders through the plugin; a program directory (config.json,\n  // composed with a program document when one sits beside it) and every\n  // other source are engine config renders. A deterministic sniff, never a\n  // flag — and the sniff reads the document, because a program directory\n  // carries a doc.json too.\n  const first = argv.find((a) => !a.startsWith('-'))\n  if (first && directoryKind(first) === 'take') {\n    return delegate(['render', ...argv])\n  }\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos render <config.json|url|take> [out]')\n  const r = createReporter(flags.json === true)\n  const format = (flags.format as string) ?? 'webm'\n  if (format !== 'webm' && format !== 'mp4')\n    throw new UsageError('--format must be webm or mp4')\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const duration = numFlag(flags, 'duration', configDuration(config) ?? 5)\n  const width = numFlag(flags, 'width', 1920)\n  const height = numFlag(flags, 'height', 1080)\n  const fps = numFlag(flags, 'fps', 30)\n  const out = positionals[1] ?? outName(source, format)\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderVideo(browser, {\n      config,\n      width,\n      height,\n      fps,\n      duration,\n      format,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      { out, bytes: result.bytes.length, width, height, fps, duration, format },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height}@${fps}, ${duration}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdStill(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos still <config.json|url> [out.webp]')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const time = numFlag(flags, 'time', 0)\n  const width = numFlag(flags, 'width', 1280)\n  const height = numFlag(flags, 'height', 720)\n  const out = positionals[1] ?? outName(source, 'webp')\n  // The capture template encodes WebP; a .png/.jpg name would ship WebP\n  // bytes under a lying extension (stores refuse a mislabelled image), so\n  // refuse in words instead of writing it.\n  if (/\\.(png|jpe?g)$/i.test(out))\n    throw new UsageError(\n      `vos still writes WebP (the engine's capture format): name the output .webp, or convert afterwards (ffmpeg -i out.webp out.png)`,\n    )\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderStill(browser, {\n      config,\n      width,\n      height,\n      time,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      {\n        out,\n        bytes: result.bytes.length,\n        width,\n        height,\n        time,\n        mimeType: result.mimeType,\n      },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height} @ t=${time}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdInfo(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos info <config.json|url>')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  const elements = Array.isArray(config.elements) ? config.elements.length : 0\n  const data =\n    typeof config.data === 'object' && config.data !== null\n      ? Object.keys(config.data)\n      : []\n  const fns = ['setup', 'createContent', 'createTimeline', 'onFrame'].filter(\n    (k) => typeof config[k] === 'string',\n  )\n  const info = {\n    version: config.version,\n    duration: configDuration(config) ?? null,\n    camera:\n      (config.camera as Record<string, unknown> | undefined)?.preset ?? null,\n    elements,\n    dataKeys: data,\n    functions: fns,\n    warnings,\n  }\n  if (r.json) r.done(info, '')\n  else {\n    for (const w of warnings) r.log(`note: ${w}`)\n    process.stdout.write(\n      `version:   v${String(info.version)}\\n` +\n        `duration:  ${info.duration === null ? '(none)' : `${info.duration}s`}\\n` +\n        `camera:    ${String(info.camera ?? '(default)')}\\n` +\n        `elements:  ${elements}\\n` +\n        `data keys: ${data.length ? data.join(', ') : '(none)'}\\n` +\n        `functions: ${fns.join(', ')}\\n`,\n    )\n  }\n  return EXIT_OK\n}\n\nfunction packageVersion(name: string): string | null {\n  const require = createRequire(import.meta.url)\n  // Fast path — packages that export ./package.json (e.g. playwright).\n  try {\n    return (require(`${name}/package.json`) as { version: string }).version\n  } catch {\n    // Strict `exports` maps (the @vosjs packages) hide package.json — resolve\n    // the entry module instead and walk up to the owning package.json.\n  }\n  let entry: string | null = null\n  try {\n    entry = fileURLToPath(import.meta.resolve(name))\n  } catch {\n    try {\n      entry = require.resolve(name)\n    } catch {\n      return null\n    }\n  }\n  let dir = dirname(entry)\n  for (let i = 0; i < 6; i++) {\n    try {\n      const pkg = JSON.parse(\n        readFileSync(join(dir, 'package.json'), 'utf8'),\n      ) as {\n        name?: string\n        version?: string\n      }\n      if (pkg.name === name && pkg.version) return pkg.version\n    } catch {\n      // keep walking\n    }\n    const parent = dirname(dir)\n    if (parent === dir) return null\n    dir = parent\n  }\n  return null\n}\n\nfunction ownVersion(): string {\n  try {\n    const own = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL('../package.json', import.meta.url)),\n        'utf8',\n      ),\n    ) as { version: string }\n    return own.version\n  } catch {\n    return '(unknown)'\n  }\n}\n\nasync function cmdVersions(argv: string[]): Promise<number> {\n  const { flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const r = createReporter(flags.json === true)\n  const versions: Record<string, string> = {}\n  versions['@vosjs/cli'] = ownVersion()\n  for (const name of [\n    '@vosjs/core',\n    '@vosjs/elements',\n    '@vosjs/tween',\n    '@vosjs/editor',\n    '@vosjs/timeline',\n    '@vosjs/studio-core',\n    '@vosjs/render-core',\n    '@vosjs/shared',\n    'mediabunny',\n    'playwright',\n  ]) {\n    versions[name] = packageVersion(name) ?? '(not found)'\n  }\n  if (r.json) r.done({ versions }, '')\n  else\n    for (const [k, v] of Object.entries(versions))\n      process.stdout.write(`${k} ${v}\\n`)\n  return EXIT_OK\n}\n\nasync function cmdPreview(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos preview <config.json|url> [--port 0]')\n  const r = createReporter(false)\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const { hostHtml, playerHtml } = previewPages(config)\n  const server = createServer((req, res) => {\n    const path = new URL(req.url ?? '/', 'http://x').pathname\n    res.writeHead(200, { 'content-type': 'text/html' })\n    res.end(path === '/player' ? playerHtml : hostHtml)\n  })\n  const port = numFlag(flags, 'port', 0)\n  await new Promise<void>((resolve) => server.listen(port, resolve))\n  const addr = server.address()\n  const url = `http://localhost:${typeof addr === 'object' && addr ? addr.port : port}/`\n  process.stdout.write(`${url}\\n`)\n  r.log('Serving playback preview — Ctrl-C to stop.')\n  await new Promise(() => {}) // keep alive until interrupted\n  return EXIT_OK\n}\n\nasync function cmdCheck(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos check <config.json>')\n  const r = createReporter(flags.json === true)\n\n  // A directory is a take (refused here: its document is `vos validate`'s\n  // job) or a program directory (config.json, composed with the program\n  // document beside it so the ladder reads the layers' strings too).\n  const kind = /^https?:\\/\\//.test(source) ? 'none' : directoryKind(source)\n  if (kind === 'take') {\n    throw new UsageError(\n      `${source} is a take (its doc.json is a recording document). vos validate ${source} lints it; vos render ${source} renders it.`,\n    )\n  }\n  let raw: string\n  let parsed: unknown\n  try {\n    if (kind === 'program') {\n      const notes: string[] = []\n      parsed = await loadProgramDirectory(source, notes)\n      for (const n of notes) r.log(`note: ${n}`)\n      raw = ''\n    } else {\n      raw = await readSourceText(source)\n      parsed = JSON.parse(raw)\n    }\n  } catch (e) {\n    if (!(e instanceof SyntaxError)) throw e\n    parsed = undefined\n    if (!r.json) process.stdout.write(`error [json] ${(e as Error).message}\\n`)\n    r.done(\n      {\n        ok: false,\n        errors: 1,\n        warnings: 0,\n        issues: [\n          { level: 'error', source: 'json', message: (e as Error).message },\n        ],\n      },\n      `${source}: 1 error`,\n    )\n    return EXIT_ERROR\n  }\n\n  const result = runCheck(parsed)\n  if (r.json) {\n    r.done(\n      {\n        ok: result.ok,\n        errors: result.errors,\n        warnings: result.warnings,\n        issues: result.issues,\n      },\n      '',\n    )\n  } else {\n    for (const i of result.issues) {\n      process.stdout.write(`${i.level} [${i.source}] ${i.message}\\n`)\n    }\n    process.stdout.write(\n      result.ok\n        ? `${source}: ok (${result.warnings} warning${result.warnings === 1 ? '' : 's'})\\n`\n        : `${source}: ${result.errors} error${result.errors === 1 ? '' : 's'}, ${result.warnings} warning${result.warnings === 1 ? '' : 's'}\\n`,\n    )\n  }\n  return result.ok ? EXIT_OK : EXIT_ERROR\n}\n\n// ---------------------------------------------------------------------------\n// Every verb this file does not own is a take-pipeline or vos.so verb from\n// `./plugin` (what used to ship separately as @vosso/vos-plugin). It loads on\n// demand, so the engine verbs never pay for the recorder's imports, and the\n// old names (`@vosso/cli`, `@vosso/voila-cli`, the `vos voila` alias) keep\n// resolving here for scripts that still use them.\n// ---------------------------------------------------------------------------\n\nasync function delegate(argv: string[], viaAlias = false): Promise<number> {\n  const { run } = await import('./plugin/run')\n  if (viaAlias && argv[0]) {\n    process.stderr.write(\n      `note: \"vos voila ${argv[0]}\" is now \"vos ${argv[0]}\".\\n`,\n    )\n  }\n  return await run(argv)\n}\n\nasync function printHelp(): Promise<void> {\n  process.stdout.write(HELP_ENGINE)\n  const { manifest } = await import('./plugin/manifest')\n  process.stdout.write('\\nTake pipeline + vos.so verbs\\n')\n  for (const v of manifest.verbs) {\n    if (v.name === 'render') continue // polymorphic — already listed above\n    process.stdout.write(`  vos ${v.name.padEnd(8)} ${v.summary}\\n`)\n  }\n  process.stdout.write(HELP_CONVENTIONS)\n}\n\nconst ENGINE_VERBS = new Set([\n  'render',\n  'still',\n  'info',\n  'versions',\n  'preview',\n  'check',\n])\n\nasync function main(): Promise<number> {\n  const [cmd, ...rest] = process.argv.slice(2)\n  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {\n    await printHelp()\n    return cmd ? EXIT_OK : EXIT_USAGE\n  }\n  if (cmd === '--version') return cmdVersions(['--json'])\n  if (!ENGINE_VERBS.has(cmd) && cmd !== 'voila') return delegate([cmd, ...rest])\n  switch (cmd) {\n    case 'render':\n      return cmdRender(rest)\n    case 'still':\n      return cmdStill(rest)\n    case 'info':\n      return cmdInfo(rest)\n    case 'versions':\n      return cmdVersions(rest)\n    case 'preview':\n      return cmdPreview(rest)\n    case 'check':\n      return cmdCheck(rest)\n    // Hidden alias for existing scripts; not in HELP. Same code path as the\n    // promoted verbs, plus a one-line pointer at the new spelling.\n    case 'voila':\n      return delegate(rest, true)\n    default:\n      throw new UsageError(`unknown command \"${cmd}\" — run vos help`)\n  }\n}\n\nmain()\n  .then(async (code) => {\n    // A run that succeeded while ignoring a flag it was given did not do\n    // what was asked (flagUse.ts): say so, and do not exit 0.\n    if (code === EXIT_OK) {\n      const verb = process.argv[2] ?? ''\n      const { HELP } = await import('./plugin/run')\n      const documented = [\n        ...helpFlagsFor(HELP_ENGINE, verb),\n        ...helpFlagsFor(HELP, verb),\n      ]\n      const message = unusedFlagsMessage(verb, [...new Set(documented)])\n      if (message) {\n        process.stderr.write(`usage error: ${message}\\n`)\n        process.exit(EXIT_USAGE)\n      }\n    }\n    process.exit(code)\n  })\n  .catch((e) => {\n    if (e instanceof UsageError) {\n      process.stderr.write(`usage error: ${e.message}\\n`)\n      process.exit(EXIT_USAGE)\n    }\n    if (e instanceof BrowserUnavailableError) {\n      process.stderr.write(`${e.message}\\n`)\n      process.exit(EXIT_NO_BROWSER)\n    }\n    process.stderr.write(\n      `error: ${e instanceof Error ? e.message : String(e)}\\n`,\n    )\n    process.exit(EXIT_ERROR)\n  })\n","/**\n * Output conventions (agent-safe by construction):\n * - logs/progress → stderr (human readable)\n * - results → stdout; with --json, NDJSON events (`{\"event\":\"phase\"...}` then\n *   `{\"event\":\"done\"...}`) so scripts and agents never parse prose\n * - exit codes: 0 ok · 1 failure · 2 usage · 3 browser unavailable\n */\nexport const EXIT_OK = 0\nexport const EXIT_ERROR = 1\nexport const EXIT_USAGE = 2\nexport const EXIT_NO_BROWSER = 3\n\nexport interface Reporter {\n  json: boolean\n  /** Human log line (stderr; suppressed in --json mode). */\n  log: (msg: string) => void\n  /** Machine event (stdout NDJSON in --json mode; no-op otherwise). */\n  event: (obj: Record<string, unknown>) => void\n  /** Final result: NDJSON `done` event in --json mode, plain line otherwise. */\n  done: (obj: Record<string, unknown>, humanLine: string) => void\n}\n\nexport function createReporter(json: boolean): Reporter {\n  return {\n    json,\n    log: (msg) => {\n      if (!json) process.stderr.write(`${msg}\\n`)\n    },\n    event: (obj) => {\n      if (json) process.stdout.write(`${JSON.stringify(obj)}\\n`)\n    },\n    done: (obj, humanLine) => {\n      if (json)\n        process.stdout.write(`${JSON.stringify({ event: 'done', ...obj })}\\n`)\n      else process.stdout.write(`${humanLine}\\n`)\n    },\n  }\n}\n","/**\n * `vos check` — the local validation pipeline, pure so it can be unit-tested:\n * envelope unwrap → migrate → schema → compile → determinism + dialect lints.\n * Everything runs locally (no network, no browser). The platform runs the\n * same compiler server-side, so a clean check is a push that will compile.\n */\nimport {\n  CURRENT_CONFIG_VERSION,\n  compileVosConfig,\n  migrateConfig,\n  vosConfigJsonSchema,\n} from '@vosjs/core'\nimport {\n  lintVosConfig,\n  lintVosDialect,\n  lintVosFonts,\n  lintVosPostprocessing,\n} from '@vosjs/core/lint'\n\nexport interface CheckIssue {\n  level: 'error' | 'warn'\n  source:\n    | 'schema'\n    | 'syntax'\n    | 'compile'\n    | 'determinism'\n    | 'dialect'\n    | 'shape'\n    | 'fonts'\n    | 'postprocessing'\n  message: string\n}\n\nexport interface CheckResult {\n  ok: boolean\n  errors: number\n  warnings: number\n  issues: CheckIssue[]\n  /** The migrated config (params/presets untouched) — what a push should send. */\n  config: Record<string, unknown> | null\n}\n\n// Top-level keys the schema does not know but the platform preserves on push.\nconst PLATFORM_EXTRA_KEYS = new Set(['params', 'presets'])\n\nexport function runCheck(parsed: unknown): CheckResult {\n  const issues: CheckIssue[] = []\n  const finish = (config: Record<string, unknown> | null): CheckResult => {\n    const errors = issues.filter((i) => i.level === 'error').length\n    return {\n      ok: errors === 0,\n      errors,\n      warnings: issues.length - errors,\n      issues,\n      config,\n    }\n  }\n\n  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: 'not a JSON object',\n    })\n    return finish(null)\n  }\n\n  // API endpoints wrap the config: { config: {...} } — accept both shapes.\n  let obj = parsed as Record<string, unknown>\n  if (\n    typeof obj.config === 'object' &&\n    obj.config !== null &&\n    !('createTimeline' in obj)\n  ) {\n    obj = obj.config as Record<string, unknown>\n  }\n\n  const version = obj.version\n  let migrated: Record<string, unknown>\n  try {\n    migrated = migrateConfig(obj) as Record<string, unknown>\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: `migration failed: ${e instanceof Error ? e.message : String(e)}`,\n    })\n    return finish(null)\n  }\n  if (version === undefined) {\n    // It compiles (the engine reads an absent version as the current one),\n    // but a push is refused: a stored config must say which schema era it was\n    // written against, and nobody can tell that from the file later.\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config declares no \"version\". It plays here, but a push is refused without one. Add \"version\": ${CURRENT_CONFIG_VERSION}.`,\n    })\n  } else if (version !== CURRENT_CONFIG_VERSION) {\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config is v${String(version)}, migrated to v${CURRENT_CONFIG_VERSION}. Save the migrated form.`,\n    })\n  }\n\n  const schema = vosConfigJsonSchema.safeParse(migrated)\n  if (!schema.success) {\n    for (const i of schema.error.issues.slice(0, 10)) {\n      issues.push({\n        level: 'error',\n        source: 'schema',\n        message: `${i.path.join('.') || '(root)'}: ${i.message}`,\n      })\n    }\n    return finish(null)\n  }\n\n  // Keys the platform's schema will silently drop on push (params/presets\n  // excepted — those are re-attached by contract).\n  const known = new Set([\n    ...Object.keys(vosConfigJsonSchema.shape),\n    ...PLATFORM_EXTRA_KEYS,\n  ])\n  for (const key of Object.keys(migrated)) {\n    if (!known.has(key)) {\n      issues.push({\n        level: 'warn',\n        source: 'shape',\n        message: `unknown top-level key \"${key}\" — the platform drops it on push`,\n      })\n    }\n  }\n\n  // Function strings are pasted into the template as text, so the compiler\n  // cannot see a syntax error — parse each one here (construction only,\n  // nothing executes).\n  let syntaxErrors = 0\n  for (const key of [\n    'setup',\n    'createContent',\n    'createTimeline',\n    'onFrame',\n  ] as const) {\n    const src = migrated[key]\n    if (typeof src !== 'string' || !src.length) continue\n    try {\n      new Function(`\"use strict\"; return (${src}\\n)`)\n    } catch (e) {\n      syntaxErrors++\n      issues.push({\n        level: 'error',\n        source: 'syntax',\n        message: `${key}: ${e instanceof Error ? e.message : String(e)}`,\n      })\n    }\n  }\n  if (syntaxErrors) return finish(migrated)\n\n  try {\n    // Same options as `vos render` — a clean check is a config the CLI's own\n    // render path will accept.\n    compileVosConfig(migrated as never, { tweenEngine: 'vos' })\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'compile',\n      message: e instanceof Error ? e.message : String(e),\n    })\n    return finish(migrated)\n  }\n\n  for (const i of lintVosConfig(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'determinism',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosDialect(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'dialect',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosFonts(migrated as never)) {\n    issues.push({\n      level: 'warn',\n      source: 'fonts',\n      message: `[${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosPostprocessing(migrated as never)) {\n    issues.push({\n      level: 'warn',\n      source: 'postprocessing',\n      message: `[${i.rule}] ${i.message}`,\n    })\n  }\n\n  return finish(migrated)\n}\n"],"mappings":"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","names":["require"]}
+{"version":3,"sources":["../src/cli.ts","../src/output.ts","../src/check.ts"],"sourcesContent":["import { writeFile } from 'node:fs/promises'\nimport { readFileSync } from 'node:fs'\nimport { basename, dirname, join } from 'node:path'\nimport { createServer } from 'node:http'\nimport { createRequire } from 'node:module'\nimport { fileURLToPath } from 'node:url'\nimport { parseArgs, numFlag, UsageError } from './args'\nimport { helpFlagsFor, unusedFlagsMessage } from './flagUse'\nimport {\n  createReporter,\n  EXIT_ERROR,\n  EXIT_NO_BROWSER,\n  EXIT_OK,\n  EXIT_USAGE,\n} from './output'\nimport {\n  loadVosConfig,\n  configDuration,\n  directoryKind,\n  loadProgramDirectory,\n  readSourceText,\n} from './loadConfig'\nimport { launchBrowser, BrowserUnavailableError } from './browser'\nimport { renderVideo, renderStill, previewPages } from './render'\nimport { runCheck } from './check'\n\nconst BOOLEAN_FLAGS = new Set(['json', 'help', 'version'])\n\nconst HELP_ENGINE = `vos — command line for the vos programmatic video engine (https://vos.so/engine)\n\nEngine verbs (local, no account, no network beyond the render page's CDN deps)\n  vos render <config.json|url|take> [out] [--width 1920] [--height 1080] [--fps 30]\n                               [--duration <s>] [--format webm|mp4] [--json]\n  vos still  <config.json|url> [out.webp] [--time 0] [--width] [--height] [--json]\n  vos info   <config.json|url> [--json]\n  vos check  <config.json|url> [--json]\n             migrate → schema → syntax → compile → determinism/dialect lints, all local\n  vos preview <config.json|url> [--port 0]\n  vos versions [--json]\n`\n\nconst HELP_CONVENTIONS = `\nConventions\n  Results go to stdout; logs go to stderr. --json switches stdout to NDJSON\n  events ending with {\"event\":\"done\",…}. Exit codes: 0 ok, 1 error, 2 usage,\n  3 no browser available, 4 the recorder met a sign-in instead of the page\n  it was asked for (nothing was recorded; it needs a session, not a new\n  script). vos <verb> --help prints that verb's flags.\n`\n\nfunction outName(source: string, ext: string): string {\n  const base = basename(source).replace(/\\.[a-z0-9]+$/i, '') || 'vos'\n  return `${base}.${ext}`\n}\n\nasync function cmdRender(argv: string[]): Promise<number> {\n  // Polymorphic render: a take DIRECTORY (its doc.json is a recording\n  // document) renders through the plugin; a program directory (config.json,\n  // composed with a program document when one sits beside it) and every\n  // other source are engine config renders. A deterministic sniff, never a\n  // flag — and the sniff reads the document, because a program directory\n  // carries a doc.json too.\n  const first = argv.find((a) => !a.startsWith('-'))\n  if (first && directoryKind(first) === 'take') {\n    return delegate(['render', ...argv])\n  }\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos render <config.json|url|take> [out]')\n  const r = createReporter(flags.json === true)\n  const format = (flags.format as string) ?? 'webm'\n  if (format !== 'webm' && format !== 'mp4')\n    throw new UsageError('--format must be webm or mp4')\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const duration = numFlag(flags, 'duration', configDuration(config) ?? 5)\n  const width = numFlag(flags, 'width', 1920)\n  const height = numFlag(flags, 'height', 1080)\n  const fps = numFlag(flags, 'fps', 30)\n  const out = positionals[1] ?? outName(source, format)\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderVideo(browser, {\n      config,\n      width,\n      height,\n      fps,\n      duration,\n      format,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      { out, bytes: result.bytes.length, width, height, fps, duration, format },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height}@${fps}, ${duration}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdStill(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos still <config.json|url> [out.webp]')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const time = numFlag(flags, 'time', 0)\n  const width = numFlag(flags, 'width', 1280)\n  const height = numFlag(flags, 'height', 720)\n  const out = positionals[1] ?? outName(source, 'webp')\n  // The capture template encodes WebP; a .png/.jpg name would ship WebP\n  // bytes under a lying extension (stores refuse a mislabelled image), so\n  // refuse in words instead of writing it.\n  if (/\\.(png|jpe?g)$/i.test(out))\n    throw new UsageError(\n      `vos still writes WebP (the engine's capture format): name the output .webp, or convert afterwards (ffmpeg -i out.webp out.png)`,\n    )\n\n  const browser = await launchBrowser()\n  try {\n    const result = await renderStill(browser, {\n      config,\n      width,\n      height,\n      time,\n      onPhase: (phase) => {\n        r.log(`${phase}…`)\n        r.event({ event: 'phase', phase })\n      },\n    })\n    await writeFile(out, result.bytes)\n    r.done(\n      {\n        out,\n        bytes: result.bytes.length,\n        width,\n        height,\n        time,\n        mimeType: result.mimeType,\n      },\n      `Wrote ${out} (${(result.bytes.length / 1024).toFixed(0)} KB, ${width}x${height} @ t=${time}s)`,\n    )\n    return EXIT_OK\n  } finally {\n    await browser.close()\n  }\n}\n\nasync function cmdInfo(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos info <config.json|url>')\n  const r = createReporter(flags.json === true)\n\n  const { config, warnings } = await loadVosConfig(source)\n  const elements = Array.isArray(config.elements) ? config.elements.length : 0\n  const data =\n    typeof config.data === 'object' && config.data !== null\n      ? Object.keys(config.data)\n      : []\n  const fns = ['setup', 'createContent', 'createTimeline', 'onFrame'].filter(\n    (k) => typeof config[k] === 'string',\n  )\n  const info = {\n    version: config.version,\n    duration: configDuration(config) ?? null,\n    camera:\n      (config.camera as Record<string, unknown> | undefined)?.preset ?? null,\n    elements,\n    dataKeys: data,\n    functions: fns,\n    warnings,\n  }\n  if (r.json) r.done(info, '')\n  else {\n    for (const w of warnings) r.log(`note: ${w}`)\n    process.stdout.write(\n      `version:   v${String(info.version)}\\n` +\n        `duration:  ${info.duration === null ? '(none)' : `${info.duration}s`}\\n` +\n        `camera:    ${String(info.camera ?? '(default)')}\\n` +\n        `elements:  ${elements}\\n` +\n        `data keys: ${data.length ? data.join(', ') : '(none)'}\\n` +\n        `functions: ${fns.join(', ')}\\n`,\n    )\n  }\n  return EXIT_OK\n}\n\nfunction packageVersion(name: string): string | null {\n  const require = createRequire(import.meta.url)\n  // Fast path — packages that export ./package.json (e.g. playwright).\n  try {\n    return (require(`${name}/package.json`) as { version: string }).version\n  } catch {\n    // Strict `exports` maps (the @vosjs packages) hide package.json — resolve\n    // the entry module instead and walk up to the owning package.json.\n  }\n  let entry: string | null = null\n  try {\n    entry = fileURLToPath(import.meta.resolve(name))\n  } catch {\n    try {\n      entry = require.resolve(name)\n    } catch {\n      return null\n    }\n  }\n  let dir = dirname(entry)\n  for (let i = 0; i < 6; i++) {\n    try {\n      const pkg = JSON.parse(\n        readFileSync(join(dir, 'package.json'), 'utf8'),\n      ) as {\n        name?: string\n        version?: string\n      }\n      if (pkg.name === name && pkg.version) return pkg.version\n    } catch {\n      // keep walking\n    }\n    const parent = dirname(dir)\n    if (parent === dir) return null\n    dir = parent\n  }\n  return null\n}\n\nfunction ownVersion(): string {\n  try {\n    const own = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL('../package.json', import.meta.url)),\n        'utf8',\n      ),\n    ) as { version: string }\n    return own.version\n  } catch {\n    return '(unknown)'\n  }\n}\n\nasync function cmdVersions(argv: string[]): Promise<number> {\n  const { flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const r = createReporter(flags.json === true)\n  const versions: Record<string, string> = {}\n  versions['@vosjs/cli'] = ownVersion()\n  for (const name of [\n    '@vosjs/core',\n    '@vosjs/elements',\n    '@vosjs/tween',\n    '@vosjs/editor',\n    '@vosjs/timeline',\n    '@vosjs/studio-core',\n    '@vosjs/render-core',\n    '@vosjs/shared',\n    'mediabunny',\n    'playwright',\n  ]) {\n    versions[name] = packageVersion(name) ?? '(not found)'\n  }\n  if (r.json) r.done({ versions }, '')\n  else\n    for (const [k, v] of Object.entries(versions))\n      process.stdout.write(`${k} ${v}\\n`)\n  return EXIT_OK\n}\n\nasync function cmdPreview(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos preview <config.json|url> [--port 0]')\n  const r = createReporter(false)\n  const { config, warnings } = await loadVosConfig(source)\n  for (const w of warnings) r.log(`note: ${w}`)\n  const { hostHtml, playerHtml } = previewPages(config)\n  const server = createServer((req, res) => {\n    const path = new URL(req.url ?? '/', 'http://x').pathname\n    res.writeHead(200, { 'content-type': 'text/html' })\n    res.end(path === '/player' ? playerHtml : hostHtml)\n  })\n  const port = numFlag(flags, 'port', 0)\n  await new Promise<void>((resolve) => server.listen(port, resolve))\n  const addr = server.address()\n  const url = `http://localhost:${typeof addr === 'object' && addr ? addr.port : port}/`\n  process.stdout.write(`${url}\\n`)\n  r.log('Serving playback preview — Ctrl-C to stop.')\n  await new Promise(() => {}) // keep alive until interrupted\n  return EXIT_OK\n}\n\nasync function cmdCheck(argv: string[]): Promise<number> {\n  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS)\n  const source = positionals[0]\n  if (!source) throw new UsageError('vos check <config.json>')\n  const r = createReporter(flags.json === true)\n\n  // A directory is a take (refused here: its document is `vos validate`'s\n  // job) or a program directory (config.json, composed with the program\n  // document beside it so the ladder reads the layers' strings too).\n  const kind = /^https?:\\/\\//.test(source) ? 'none' : directoryKind(source)\n  if (kind === 'take') {\n    throw new UsageError(\n      `${source} is a take (its doc.json is a recording document). vos validate ${source} lints it; vos render ${source} renders it.`,\n    )\n  }\n  let raw: string\n  let parsed: unknown\n  try {\n    if (kind === 'program') {\n      const notes: string[] = []\n      parsed = await loadProgramDirectory(source, notes)\n      for (const n of notes) r.log(`note: ${n}`)\n      raw = ''\n    } else {\n      raw = await readSourceText(source)\n      parsed = JSON.parse(raw)\n    }\n  } catch (e) {\n    if (!(e instanceof SyntaxError)) throw e\n    parsed = undefined\n    if (!r.json) process.stdout.write(`error [json] ${(e as Error).message}\\n`)\n    r.done(\n      {\n        ok: false,\n        errors: 1,\n        warnings: 0,\n        issues: [\n          { level: 'error', source: 'json', message: (e as Error).message },\n        ],\n      },\n      `${source}: 1 error`,\n    )\n    return EXIT_ERROR\n  }\n\n  const result = runCheck(parsed)\n  if (r.json) {\n    r.done(\n      {\n        ok: result.ok,\n        errors: result.errors,\n        warnings: result.warnings,\n        issues: result.issues,\n      },\n      '',\n    )\n  } else {\n    for (const i of result.issues) {\n      process.stdout.write(`${i.level} [${i.source}] ${i.message}\\n`)\n    }\n    process.stdout.write(\n      result.ok\n        ? `${source}: ok (${result.warnings} warning${result.warnings === 1 ? '' : 's'})\\n`\n        : `${source}: ${result.errors} error${result.errors === 1 ? '' : 's'}, ${result.warnings} warning${result.warnings === 1 ? '' : 's'}\\n`,\n    )\n  }\n  return result.ok ? EXIT_OK : EXIT_ERROR\n}\n\n// ---------------------------------------------------------------------------\n// Every verb this file does not own is a take-pipeline or vos.so verb from\n// `./plugin` (what used to ship separately as @vosso/vos-plugin). It loads on\n// demand, so the engine verbs never pay for the recorder's imports, and the\n// old names (`@vosso/cli`, `@vosso/voila-cli`, the `vos voila` alias) keep\n// resolving here for scripts that still use them.\n// ---------------------------------------------------------------------------\n\nasync function delegate(argv: string[], viaAlias = false): Promise<number> {\n  const { run } = await import('./plugin/run')\n  if (viaAlias && argv[0]) {\n    process.stderr.write(\n      `note: \"vos voila ${argv[0]}\" is now \"vos ${argv[0]}\".\\n`,\n    )\n  }\n  return await run(argv)\n}\n\nasync function printHelp(): Promise<void> {\n  process.stdout.write(HELP_ENGINE)\n  const { manifest } = await import('./plugin/manifest')\n  process.stdout.write('\\nTake pipeline + vos.so verbs\\n')\n  for (const v of manifest.verbs) {\n    if (v.name === 'render') continue // polymorphic — already listed above\n    process.stdout.write(`  vos ${v.name.padEnd(8)} ${v.summary}\\n`)\n  }\n  process.stdout.write(HELP_CONVENTIONS)\n}\n\nconst ENGINE_VERBS = new Set([\n  'render',\n  'still',\n  'info',\n  'versions',\n  'preview',\n  'check',\n])\n\nasync function main(): Promise<number> {\n  const [cmd, ...rest] = process.argv.slice(2)\n  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {\n    await printHelp()\n    return cmd ? EXIT_OK : EXIT_USAGE\n  }\n  if (cmd === '--version') return cmdVersions(['--json'])\n  if (!ENGINE_VERBS.has(cmd) && cmd !== 'voila') return delegate([cmd, ...rest])\n  // An engine verb asked for its flags: the engine's usage lines, plus the\n  // take pipeline's where the verb is shared (render takes a config OR a take).\n  if (rest.includes('--help') || rest.includes('-h')) {\n    const engine = HELP_ENGINE.split('\\n').filter((l) =>\n      l.startsWith(`  vos ${cmd} `),\n    )\n    const { verbHelp } = await import('./plugin/run')\n    const take = verbHelp(cmd)\n    process.stdout.write(\n      `${engine.join('\\n')}\\n${take.includes('no such verb') ? '' : take}`,\n    )\n    return EXIT_OK\n  }\n  switch (cmd) {\n    case 'render':\n      return cmdRender(rest)\n    case 'still':\n      return cmdStill(rest)\n    case 'info':\n      return cmdInfo(rest)\n    case 'versions':\n      return cmdVersions(rest)\n    case 'preview':\n      return cmdPreview(rest)\n    case 'check':\n      return cmdCheck(rest)\n    // Hidden alias for existing scripts; not in HELP. Same code path as the\n    // promoted verbs, plus a one-line pointer at the new spelling.\n    case 'voila':\n      return delegate(rest, true)\n    default:\n      throw new UsageError(`unknown command \"${cmd}\" — run vos help`)\n  }\n}\n\nmain()\n  .then(async (code) => {\n    // A run that succeeded while ignoring a flag it was given did not do\n    // what was asked (flagUse.ts): say so, and do not exit 0.\n    if (code === EXIT_OK) {\n      const verb = process.argv[2] ?? ''\n      const { HELP } = await import('./plugin/run')\n      const documented = [\n        ...helpFlagsFor(HELP_ENGINE, verb),\n        ...helpFlagsFor(HELP, verb),\n      ]\n      const message = unusedFlagsMessage(verb, [...new Set(documented)])\n      if (message) {\n        process.stderr.write(`usage error: ${message}\\n`)\n        process.exit(EXIT_USAGE)\n      }\n    }\n    process.exit(code)\n  })\n  .catch((e) => {\n    if (e instanceof UsageError) {\n      process.stderr.write(`usage error: ${e.message}\\n`)\n      process.exit(EXIT_USAGE)\n    }\n    if (e instanceof BrowserUnavailableError) {\n      process.stderr.write(`${e.message}\\n`)\n      process.exit(EXIT_NO_BROWSER)\n    }\n    process.stderr.write(\n      `error: ${e instanceof Error ? e.message : String(e)}\\n`,\n    )\n    process.exit(EXIT_ERROR)\n  })\n","/**\n * Output conventions (agent-safe by construction):\n * - logs/progress → stderr (human readable)\n * - results → stdout; with --json, NDJSON events (`{\"event\":\"phase\"...}` then\n *   `{\"event\":\"done\"...}`) so scripts and agents never parse prose\n * - exit codes: 0 ok · 1 failure · 2 usage · 3 browser unavailable ·\n *   4 the recorder met a sign-in (the take pipeline's wall check)\n */\nexport const EXIT_OK = 0\nexport const EXIT_ERROR = 1\nexport const EXIT_USAGE = 2\nexport const EXIT_NO_BROWSER = 3\n\nexport interface Reporter {\n  json: boolean\n  /** Human log line (stderr; suppressed in --json mode). */\n  log: (msg: string) => void\n  /** Machine event (stdout NDJSON in --json mode; no-op otherwise). */\n  event: (obj: Record<string, unknown>) => void\n  /** Final result: NDJSON `done` event in --json mode, plain line otherwise. */\n  done: (obj: Record<string, unknown>, humanLine: string) => void\n}\n\nexport function createReporter(json: boolean): Reporter {\n  return {\n    json,\n    log: (msg) => {\n      if (!json) process.stderr.write(`${msg}\\n`)\n    },\n    event: (obj) => {\n      if (json) process.stdout.write(`${JSON.stringify(obj)}\\n`)\n    },\n    done: (obj, humanLine) => {\n      if (json)\n        process.stdout.write(`${JSON.stringify({ event: 'done', ...obj })}\\n`)\n      else process.stdout.write(`${humanLine}\\n`)\n    },\n  }\n}\n","/**\n * `vos check` — the local validation pipeline, pure so it can be unit-tested:\n * envelope unwrap → migrate → schema → compile → determinism + dialect lints.\n * Everything runs locally (no network, no browser). The platform runs the\n * same compiler server-side, so a clean check is a push that will compile.\n */\nimport {\n  CURRENT_CONFIG_VERSION,\n  compileVosConfig,\n  migrateConfig,\n  vosConfigJsonSchema,\n} from '@vosjs/core'\nimport {\n  lintVosConfig,\n  lintVosDialect,\n  lintVosFonts,\n  lintVosPostprocessing,\n} from '@vosjs/core/lint'\n\nexport interface CheckIssue {\n  level: 'error' | 'warn'\n  source:\n    | 'schema'\n    | 'syntax'\n    | 'compile'\n    | 'determinism'\n    | 'dialect'\n    | 'shape'\n    | 'fonts'\n    | 'postprocessing'\n  message: string\n}\n\nexport interface CheckResult {\n  ok: boolean\n  errors: number\n  warnings: number\n  issues: CheckIssue[]\n  /** The migrated config (params/presets untouched) — what a push should send. */\n  config: Record<string, unknown> | null\n}\n\n// Top-level keys the schema does not know but the platform preserves on push.\nconst PLATFORM_EXTRA_KEYS = new Set(['params', 'presets'])\n\nexport function runCheck(parsed: unknown): CheckResult {\n  const issues: CheckIssue[] = []\n  const finish = (config: Record<string, unknown> | null): CheckResult => {\n    const errors = issues.filter((i) => i.level === 'error').length\n    return {\n      ok: errors === 0,\n      errors,\n      warnings: issues.length - errors,\n      issues,\n      config,\n    }\n  }\n\n  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: 'not a JSON object',\n    })\n    return finish(null)\n  }\n\n  // API endpoints wrap the config: { config: {...} } — accept both shapes.\n  let obj = parsed as Record<string, unknown>\n  if (\n    typeof obj.config === 'object' &&\n    obj.config !== null &&\n    !('createTimeline' in obj)\n  ) {\n    obj = obj.config as Record<string, unknown>\n  }\n\n  const version = obj.version\n  let migrated: Record<string, unknown>\n  try {\n    migrated = migrateConfig(obj) as Record<string, unknown>\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'shape',\n      message: `migration failed: ${e instanceof Error ? e.message : String(e)}`,\n    })\n    return finish(null)\n  }\n  if (version === undefined) {\n    // It compiles (the engine reads an absent version as the current one),\n    // but a push is refused: a stored config must say which schema era it was\n    // written against, and nobody can tell that from the file later.\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config declares no \"version\". It plays here, but a push is refused without one. Add \"version\": ${CURRENT_CONFIG_VERSION}.`,\n    })\n  } else if (version !== CURRENT_CONFIG_VERSION) {\n    issues.push({\n      level: 'warn',\n      source: 'shape',\n      message: `config is v${String(version)}, migrated to v${CURRENT_CONFIG_VERSION}. Save the migrated form.`,\n    })\n  }\n\n  const schema = vosConfigJsonSchema.safeParse(migrated)\n  if (!schema.success) {\n    for (const i of schema.error.issues.slice(0, 10)) {\n      issues.push({\n        level: 'error',\n        source: 'schema',\n        message: `${i.path.join('.') || '(root)'}: ${i.message}`,\n      })\n    }\n    return finish(null)\n  }\n\n  // Keys the platform's schema will silently drop on push (params/presets\n  // excepted — those are re-attached by contract).\n  const known = new Set([\n    ...Object.keys(vosConfigJsonSchema.shape),\n    ...PLATFORM_EXTRA_KEYS,\n  ])\n  for (const key of Object.keys(migrated)) {\n    if (!known.has(key)) {\n      issues.push({\n        level: 'warn',\n        source: 'shape',\n        message: `unknown top-level key \"${key}\" — the platform drops it on push`,\n      })\n    }\n  }\n\n  // Function strings are pasted into the template as text, so the compiler\n  // cannot see a syntax error — parse each one here (construction only,\n  // nothing executes).\n  let syntaxErrors = 0\n  for (const key of [\n    'setup',\n    'createContent',\n    'createTimeline',\n    'onFrame',\n  ] as const) {\n    const src = migrated[key]\n    if (typeof src !== 'string' || !src.length) continue\n    try {\n      new Function(`\"use strict\"; return (${src}\\n)`)\n    } catch (e) {\n      syntaxErrors++\n      issues.push({\n        level: 'error',\n        source: 'syntax',\n        message: `${key}: ${e instanceof Error ? e.message : String(e)}`,\n      })\n    }\n  }\n  if (syntaxErrors) return finish(migrated)\n\n  try {\n    // Same options as `vos render` — a clean check is a config the CLI's own\n    // render path will accept.\n    compileVosConfig(migrated as never, { tweenEngine: 'vos' })\n  } catch (e) {\n    issues.push({\n      level: 'error',\n      source: 'compile',\n      message: e instanceof Error ? e.message : String(e),\n    })\n    return finish(migrated)\n  }\n\n  for (const i of lintVosConfig(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'determinism',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosDialect(migrated as never)) {\n    issues.push({\n      level: i.severity === 'error' ? 'error' : 'warn',\n      source: 'dialect',\n      message: `${i.fn}:${i.line} [${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosFonts(migrated as never)) {\n    issues.push({\n      level: 'warn',\n      source: 'fonts',\n      message: `[${i.rule}] ${i.message}`,\n    })\n  }\n  for (const i of lintVosPostprocessing(migrated as never)) {\n    issues.push({\n      level: 'warn',\n      source: 'postprocessing',\n      message: `[${i.rule}] ${i.message}`,\n    })\n  }\n\n  return finish(migrated)\n}\n"],"mappings":"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","names":["require"]}

package/dist/index.d.ts

@@ -110,6 +110,37 @@ interface PaceReport {
     }[];
 }
 
+/**
+ * What a signed-in take SHOWS. Getting past the login is half the problem;
+ * the other half is that the account's own data is now in the frame: an
+ * email address in the header, a key on a settings page, a card number.
+ * Asking nicely does not hold this line (a person asked to sign in with a
+ * demo account signs in as themselves, because it is the account they have),
+ * so the recorder looks.
+ *
+ * Two pieces, both run IN the page:
+ *
+ * - the EXPOSURE scan reads the text that is visible in the viewport after
+ *   each step and reports the KIND of thing it saw and where. Never the
+ *   string itself: a report that quotes the secret is a second leak.
+ * - a MASK hides a selector before the first frame is captured and keeps it
+ *   hidden across navigations and re-renders, so the real value is never in
+ *   a frame, never in the recording, never pushed. `as: 'text'` swaps the
+ *   words (a product reads better than a redaction); `as: 'blur'` blurs.
+ *
+ * The matchers are ONE plain-JavaScript source string, evaluated in the page
+ * and, by the tests, in Node: a function serialized out of a bundle picks up
+ * the bundler's `__name` helper and dies in the page, and two copies of a
+ * regex drift.
+ */
+
+interface MaskRule {
+    selector: string;
+    /** `blur` (default) blurs the element; `text` swaps its words for `text`. */
+    as?: 'blur' | 'text';
+    text?: string;
+}
+
 /**
  * The action script — the declarative recipe an agent (or human) writes to
  * drive a take. Small on purpose: selectors + a handful of verbs. The recorder
@@ -124,6 +155,14 @@ interface ActionsFile {
         width: number;
         height: number;
     };
+    /**
+     * Hidden BEFORE the first frame is captured and kept hidden across
+     * navigations: what a signed-in account shows that must not ship. `blur`
+     * (default) blurs the element; `text` swaps its words for `text`, which is
+     * for IDENTIFIERS (an email, a name, an account id), never for product
+     * copy or numbers: the video must stay true to the product.
+     */
+    mask?: MaskRule[];
     steps: ActionStep[];
 }
 type ActionStep = ({
@@ -293,6 +332,10 @@ interface RecordResult {
     navTimeout: boolean;
     /** A wall the caller let through; null when the recorder landed where it was asked. */
     wall: WallVerdict | null;
+    /** Sensitive-looking text seen in the frame (kind + place, never the string). */
+    exposures: NonNullable<RecordingMeta['exposures']>;
+    /** The script's masks with how many elements each reached; hits 0 hid nothing. */
+    masks: NonNullable<RecordingMeta['masks']>;
     /**
      * Smoothness telemetry: stretches ≥400ms with no visual change. Frozen
      * footage is the #1 enemy of a smooth product video — either the flow should

package/dist/index.js

@@ -30,7 +30,7 @@ import {
   validateActions,
   waitForPageDone,
   writeSyncState
-} from "./chunk-BD4FXBUO.js";
+} from "./chunk-7RMULTDM.js";
 import {
   BrowserUnavailableError,
   configDuration,

package/dist/{run-5PCYT25T.js → run-WN2IO3WL.js}

@@ -3,13 +3,15 @@ import {
   HELP,
   MULTI_FLAGS,
   run,
-  takeBrowserArgs
-} from "./chunk-BD4FXBUO.js";
+  takeBrowserArgs,
+  verbHelp
+} from "./chunk-7RMULTDM.js";
 import "./chunk-FACYY7VV.js";
 export {
   HELP,
   MULTI_FLAGS,
   run,
-  takeBrowserArgs
+  takeBrowserArgs,
+  verbHelp
 };
-//# sourceMappingURL=run-5PCYT25T.js.map
+//# sourceMappingURL=run-WN2IO3WL.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "The vos CLI: record the real product from a scripted browser flow, auto-zoom from the cursor track, cut as data in doc.json, render deterministic video and stills, deliver a release's media per destination spec, and sync with vos.so. One binary, every verb, MIT.",
   "type": "module",
   "license": "MIT",
@@ -49,13 +49,13 @@
     "mediabunny": "^1.55.7",
     "playwright": "^1.49.0",
     "@vosjs/core": "^0.25.0",
-    "@vosjs/editor": "^1.3.1",
     "@vosjs/elements": "^0.8.1",
-    "@vosjs/shared": "^0.4.1",
     "@vosjs/render-core": "^0.2.8",
-    "@vosjs/studio-core": "^0.28.0",
+    "@vosjs/shared": "^0.4.1",
+    "@vosjs/editor": "^1.3.1",
+    "@vosjs/timeline": "^0.4.1",
     "@vosjs/tween": "^0.8.2",
-    "@vosjs/timeline": "^0.4.1"
+    "@vosjs/studio-core": "^0.29.0"
   },
   "devDependencies": {
     "@types/node": "^22",

package/schema/actions.schema.json

@@ -29,6 +29,28 @@
         }
       }
     },
+    "mask": {
+      "type": "array",
+      "description": "Hidden BEFORE the first frame is captured and kept hidden across navigations and re-renders: what a signed-in account shows that must not ship. The real value is never in a frame, never in the recording, never pushed. `vos record` reports what it still sees afterwards (meta.exposures), and a mask whose selector reached nothing fails --strict.",
+      "items": {
+        "type": "object",
+        "required": ["selector"],
+        "additionalProperties": false,
+        "properties": {
+          "selector": { "type": "string" },
+          "as": {
+            "type": "string",
+            "enum": ["blur", "text"],
+            "default": "blur",
+            "description": "blur the element, or swap its words for `text`. A form control is always blurred: writing into an input would change what the app submits. `text` is for IDENTIFIERS (an email, a name, an account id), never for product copy or numbers."
+          },
+          "text": {
+            "type": "string",
+            "description": "shown instead, with as: \"text\""
+          }
+        }
+      }
+    },
     "steps": {
       "type": "array",
       "minItems": 1,

package/schema/digest.schema.json

@@ -46,6 +46,28 @@
           "description": "false = browser-recorder take: moments are head/tail/scenes only"
         },
         "windowFocusedFrac": { "type": ["number", "null"] },
+        "exposures": {
+          "type": "array",
+          "description": "sensitive-looking text the recorder saw IN the frame: the KIND and the place, never the string. Listed once each, at the first step it was visible (step -1 = as the page opened). `rect` is viewport CSS px. Look at those frames before the take goes anywhere; the fix is a demo account or a `mask` in actions.json and a re-record",
+          "items": {
+            "type": "object",
+            "properties": {
+              "step": { "type": "integer" },
+              "kind": {
+                "type": "string",
+                "enum": ["email", "key", "card", "card-tail"]
+              },
+              "selector": { "type": "string" },
+              "rect": { "type": "object" },
+              "seen": { "type": "integer" }
+            }
+          }
+        },
+        "masks": {
+          "type": "array",
+          "description": "what the script hid before the camera rolled, with how many elements each selector reached; hits 0 hid nothing",
+          "items": { "type": "object" }
+        },
         "wall": {
           "type": ["object", "null"],
           "description": "the recorder did not land where it was asked (a sign-in, an identity provider, a 401/403, a redirect elsewhere) and the take was recorded anyway: the footage may be the wrong page. `asked`/`landed` are origin + path. null = it landed where it was asked, or the recorder does not check",