@vosjs/cli 0.46.1 → 0.48.0

package/dist/{chunk-ID4OUS5L.js → chunk-AUPGJJTL.js}

@@ -21,6 +21,18 @@ function pointerTravelMs(dist) {
     Math.max(POINTER_MIN_MS, Math.round(dist * POINTER_MS_PER_PX))
   );
 }
+var RESPONSE_MS = 400;
+var QUIET_MS = 250;
+var SETTLE_CAP_MS = 1200;
+function settleVerdict(t, c = { response: RESPONSE_MS, quiet: QUIET_MS, cap: SETTLE_CAP_MS }) {
+  if (t.sincePress >= c.cap) return "settled";
+  if (t.sinceChange === null)
+    return t.sincePress >= c.response ? "settled" : "wait";
+  return t.sinceChange >= c.quiet ? "settled" : "wait";
+}
+function holdLeftMs(holdMs, sinceChange) {
+  return Math.max(0, holdMs - (sinceChange ?? 0));
+}
 function settleMs(step) {
   if (typeof step.ms === "number" && step.ms >= 0) return step.ms;
   const d = step.do;
@@ -55,6 +67,9 @@ function askedMs(step) {
   switch (step.do) {
     case "wait":
       return step.ms ?? 0;
+    // A click's ms is the read after the page settled: the author's.
+    case "click":
+      return step.ms ?? SETTLE_MS.click;
     case "hover":
       return step.ms ?? 700;
     case "drag":
@@ -154,6 +169,8 @@ export {
   SCROLL_SETTLE_MS,
   TRAILING_HOLD_MS,
   pointerTravelMs,
+  settleVerdict,
+  holdLeftMs,
   settleMs,
   clockMotion,
   clockTyping,
@@ -164,4 +181,4 @@ export {
   deadWarns,
   deadLine
 };
-//# sourceMappingURL=chunk-ID4OUS5L.js.map
+//# sourceMappingURL=chunk-AUPGJJTL.js.map

package/dist/chunk-AUPGJJTL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin/pace.ts"],"sourcesContent":["/**\n * The recorder's pace — the pure parts.\n *\n * A take of a scripted flow should run as long as the script asks, plus the\n * gestures a person makes between the asks (the pointer's travel, the press,\n * the settle after it) and no more. Measured before this module (§4.5 of\n * the utility-clip retrospective), hovers ran 2× their ask, drags 4.8× and\n * a 25 s script recorded 42 s, for two reasons the numbers here answer:\n *\n *  - The motion loops counted STEPS (one per 16 ms of the asked duration)\n *    and awaited a `mouse.move` round trip per step, so a page that\n *    re-renders per move (a slider) stretched every gesture by the round\n *    trip. A gesture is now driven by the CLOCK: its position is a function\n *    of the elapsed time, and it ends when the asked duration has elapsed,\n *    however many samples the page allowed.\n *  - The settles after a gesture were fixed sleeps (500 ms after a click,\n *    250 after every selector lookup). A settle is DATA: `ms` on the step\n *    overrides a small default, and the script's own `wait` steps carry\n *    the intended pauses.\n */\n\n/** Pointer travel: ms per CSS px, floor and ceiling — a person's hand. */\nexport const POINTER_MS_PER_PX = 0.7\nexport const POINTER_MIN_MS = 250\nexport const POINTER_MAX_MS = 800\n/** The sample cadence a motion loop aims for. */\nexport const MOTION_TICK_MS = 16\n\n/** The settle after a gesture when the step names none, by verb. */\nexport const SETTLE_MS = {\n  click: 150,\n  type: 150,\n  scroll: 200,\n  drag: 80,\n} as const\n\n/** The press: the pause before the button goes down, and the hold. */\nexport const PRESS_LEAD_MS = 80\nexport const PRESS_HOLD_MS = 70\n/** The pause between a selector lookup that scrolled the page and the move. */\nexport const SCROLL_SETTLE_MS = 120\n/** The hold after the last step, so the take does not cut on a press. */\nexport const TRAILING_HOLD_MS = 400\n\n/** How long the pointer takes to travel `dist` CSS px. */\nexport function pointerTravelMs(dist: number): number {\n  return Math.min(\n    POINTER_MAX_MS,\n    Math.max(POINTER_MIN_MS, Math.round(dist * POINTER_MS_PER_PX)),\n  )\n}\n\n/**\n * A click's `ms` is READING time, held from the page's last visual change,\n * and the recorder pays the settle itself: the same `ms` was read on one\n * run and dead on the next because the hold started at the press and the\n * page's settle varied run to run (0.3 s to 0.7 s on the same step).\n *\n * The settle is watched on the screencast, which emits only on change:\n * after the press, a change that arrives within RESPONSE_MS says the page\n * is answering, and it has settled once QUIET_MS pass with no new frame.\n * No change within RESPONSE_MS means the page did not change (a click that\n * only moves state) and the settle is over. SETTLE_CAP_MS bounds a page\n * that never stops changing (a playing preview), which is a page nothing\n * is dead on, so the hold simply starts.\n */\nexport const RESPONSE_MS = 400\nexport const QUIET_MS = 250\nexport const SETTLE_CAP_MS = 1200\n\n/**\n * Is the page settled? Pure: the recorder feeds it what it knows at each\n * tick since the press.\n */\nexport function settleVerdict(\n  t: {\n    /** ms since the press. */\n    sincePress: number\n    /** ms since the last screencast frame, or null when none arrived since the press. */\n    sinceChange: number | null\n  },\n  c = { response: RESPONSE_MS, quiet: QUIET_MS, cap: SETTLE_CAP_MS },\n): 'wait' | 'settled' {\n  if (t.sincePress >= c.cap) return 'settled'\n  if (t.sinceChange === null)\n    return t.sincePress >= c.response ? 'settled' : 'wait'\n  return t.sinceChange >= c.quiet ? 'settled' : 'wait'\n}\n\n/**\n * What is left of a hold once the settle is detected: the hold is measured\n * from the last change, so the quiet already spent counts toward it.\n */\nexport function holdLeftMs(holdMs: number, sinceChange: number | null): number {\n  return Math.max(0, holdMs - (sinceChange ?? 0))\n}\n\n/** The settle after a step: its own `ms` when it names one, else the verb's. */\nexport function settleMs(step: { do: string; ms?: number }): number {\n  if (typeof step.ms === 'number' && step.ms >= 0) return step.ms\n  const d = step.do as keyof typeof SETTLE_MS\n  return SETTLE_MS[d] ?? 0\n}\n\nexport const easeInOutCubic = (u: number): number =>\n  u < 0.5 ? 4 * u * u * u : 1 - Math.pow(-2 * u + 2, 3) / 2\n\n/**\n * Drive a motion by the clock: `at(u)` is called with the eased progress\n * for each sample, and the loop ends when `dur` ms have elapsed, with the\n * last call at u = 1 exactly. Between samples it sleeps to the next tick\n * only when the sample came back early; a slow sample (a page busy\n * re-rendering) is followed at once, so the gesture keeps its length and\n * loses samples, never the other way round.\n */\nexport async function clockMotion(\n  dur: number,\n  at: (u: number) => Promise<void>,\n  clock: { now: () => number; sleep: (ms: number) => Promise<void> },\n): Promise<number> {\n  const start = clock.now()\n  let samples = 0\n  for (;;) {\n    const elapsed = clock.now() - start\n    if (elapsed >= dur) break\n    await at(easeInOutCubic(Math.min(1, elapsed / dur)))\n    samples++\n    const next =\n      start + Math.ceil((clock.now() - start) / MOTION_TICK_MS) * MOTION_TICK_MS\n    const wait = Math.min(next, start + dur) - clock.now()\n    if (wait > 0) await clock.sleep(wait)\n  }\n  await at(1)\n  return samples + 1\n}\n\n/**\n * Typing paced by the clock: the i-th character is due at `start + i·delay`;\n * after each keystroke the loop sleeps to the next due time only if the\n * keystroke came back early. A slow field (an editor re-rendering per key)\n * types as fast as it can and says so in the pace report.\n */\nexport async function clockTyping(\n  chars: readonly string[],\n  delay: number,\n  type: (ch: string, index: number) => Promise<void>,\n  clock: { now: () => number; sleep: (ms: number) => Promise<void> },\n): Promise<void> {\n  const start = clock.now()\n  for (let i = 0; i < chars.length; i++) {\n    await type(chars[i], i)\n    const due = start + (i + 1) * delay\n    const wait = due - clock.now()\n    if (wait > 0 && i < chars.length - 1) await clock.sleep(wait)\n  }\n}\n\n/** One step's pace: what the script asked for it and what it took. */\nexport interface StepPace {\n  step: number\n  do: string\n  /** The script's own ask: a wait's ms, a hover's dwell, a drag's ms, typing's chars × delay, a click's read after the settle; 0 for a scroll. */\n  askedMs: number\n  /** The gesture the recorder adds by design: pointer travel, the press, the settle. */\n  gestureMs: number\n  wallMs: number\n}\n\nexport interface PaceReport {\n  askedMs: number\n  gestureMs: number\n  wallMs: number\n  /** Wall time neither asked nor a gesture: what the page and the round trips cost. */\n  overheadMs: number\n  overheadPct: number\n  /** The steps whose wall ran past their ask plus gesture by more than a third. */\n  slow: { step: number; do: string; askedMs: number; wallMs: number }[]\n}\n\n/** What a script asks of a step, in ms: the part of its wall time that is the author's. */\nexport function askedMs(step: {\n  do: string\n  ms?: number\n  text?: string\n  delayMs?: number\n}): number {\n  switch (step.do) {\n    case 'wait':\n      return step.ms ?? 0\n    // A click's ms is the read after the page settled: the author's.\n    case 'click':\n      return step.ms ?? SETTLE_MS.click\n    case 'hover':\n      return step.ms ?? 700\n    case 'drag':\n      return step.ms ?? 700\n    case 'type':\n      return (step.text?.length ?? 0) * (step.delayMs ?? 40)\n    default:\n      return 0\n  }\n}\n\nexport function paceReport(steps: readonly StepPace[]): PaceReport {\n  const askedMs = steps.reduce((a, s) => a + s.askedMs, 0)\n  const gestureMs = steps.reduce((a, s) => a + s.gestureMs, 0)\n  const wallMs = steps.reduce((a, s) => a + s.wallMs, 0)\n  const overheadMs = Math.max(0, wallMs - askedMs - gestureMs)\n  const slow = steps\n    .filter((s) => s.wallMs > (s.askedMs + s.gestureMs) * 1.34 + 60)\n    .map((s) => ({\n      step: s.step,\n      do: s.do,\n      askedMs: s.askedMs,\n      wallMs: s.wallMs,\n    }))\n  return {\n    askedMs,\n    gestureMs,\n    wallMs,\n    overheadMs,\n    overheadPct: wallMs > 0 ? Math.round((overheadMs / wallMs) * 100) : 0,\n    slow,\n  }\n}\n\n/** The pace in one line for the log. */\nexport function paceLine(r: PaceReport): string {\n  const s = (ms: number) => `${(ms / 1000).toFixed(1)} s`\n  const slow = r.slow.length\n    ? `; slow: ${r.slow.map((x) => `#${x.step} ${x.do} ${s(x.wallMs)} for ${s(x.askedMs)} asked`).join(', ')}`\n    : ''\n  return `pace: the script asked ${s(r.askedMs)}, the gestures added ${s(r.gestureMs)}, the take ran ${s(r.wallMs)} (${r.overheadPct} % overhead${slow})`\n}\n\n/**\n * DEAD TIME, the smoothness fact that replaces the freeze share as the\n * warning. A still frame is not a defect: a page the viewer is reading is\n * content, and a workspace tour is mostly still. What is dead is a still\n * frame under a PARKED cursor past the beat it takes to read what changed:\n * after that the picture, the pointer and the camera all hold and nothing\n * is being said. So the derivation reads, per step, when the page settled\n * after the step's act, how long the settled frame was held, and whether\n * the cursor moved in that hold; a hold past the reading beat is dead.\n *\n * The beat is longer after a page changed (a navigation shows a whole new\n * page to take in) than after a control changed (one thing to see).\n */\nexport const READ_BEAT_MS = { page: 1000, control: 600 } as const\n/** A dead stretch this long is a warning on its own, whatever the share. */\nexport const DEAD_STRETCH_WARN_MS = 1500\n/** The share of the take past which dead time is a warning. */\nexport const DEAD_SHARE_WARN_PCT = 20\n\nexport interface DeadStep {\n  step: number\n  id?: string\n  do: string\n  /** ms from the step's act (its press, else its start) to the last frame change in the step. */\n  settledMs: number\n  /** ms the settled frame was held before the step ended. */\n  heldMs: number\n  /** the hold past the reading beat, while the cursor was parked; 0 when the hold was read or the pointer moved. */\n  deadMs: number\n}\n\nexport interface DeadReport {\n  ms: number\n  pct: number\n  /** the steps that carried any dead time, in order. */\n  steps: DeadStep[]\n  /** the longest single dead hold. */\n  longestMs: number\n}\n\nexport function deadTime(\n  steps: readonly {\n    step: number\n    id?: string\n    do: string\n    tStart: number\n    tEnd: number\n    navigated?: boolean\n  }[],\n  frames: readonly { tMs: number }[],\n  events: readonly { t: number; type: string }[],\n  durationMs: number,\n): DeadReport {\n  const out: DeadStep[] = []\n  let ms = 0\n  let longestMs = 0\n  for (const s of steps) {\n    const t0 = s.tStart * 1000\n    const t1 = s.tEnd * 1000\n    if (!(t1 > t0)) continue\n    // The act: the step's first press, else its start (a wait, a move).\n    const press = events.find(\n      (e) => e.type === 'down' && e.t >= t0 && e.t <= t1,\n    )\n    const act = press ? press.t : t0\n    // The last visual change inside the step, after the act.\n    let last = act\n    for (const f of frames) {\n      if (f.tMs > act && f.tMs <= t1) last = f.tMs\n    }\n    const settledMs = Math.round(last - act)\n    const heldMs = Math.round(t1 - last)\n    // Parked: no pointer motion while the settled frame was held.\n    const moved = events.some(\n      (e) =>\n        (e.type === 'move' || e.type === 'scroll') && e.t > last && e.t <= t1,\n    )\n    // The opening step shows a page the viewer has not seen: a page beat.\n    const beat =\n      s.navigated || s.step === 0 ? READ_BEAT_MS.page : READ_BEAT_MS.control\n    const deadMs = moved ? 0 : Math.max(0, heldMs - beat)\n    if (deadMs > 0) {\n      out.push({\n        step: s.step,\n        ...(s.id ? { id: s.id } : {}),\n        do: s.do,\n        settledMs,\n        heldMs,\n        deadMs,\n      })\n      ms += deadMs\n      longestMs = Math.max(longestMs, deadMs)\n    }\n  }\n  return {\n    ms,\n    pct: durationMs > 0 ? Math.round((ms / durationMs) * 100) : 0,\n    steps: out,\n    longestMs,\n  }\n}\n\n/** Whether a dead report earns a warning: the share, or one long hold. */\nexport function deadWarns(r: DeadReport): boolean {\n  return r.pct >= DEAD_SHARE_WARN_PCT || r.longestMs >= DEAD_STRETCH_WARN_MS\n}\n\n/** The dead time in words, naming the steps and what to cut. */\nexport function deadLine(r: DeadReport): string {\n  const s = (ms: number) => `${(ms / 1000).toFixed(1)} s`\n  if (!r.steps.length) return 'dead time: none'\n  const parts = r.steps.map(\n    (d) =>\n      `#${d.step}${d.id ? ` (${d.id})` : ''} ${d.do} held ${s(d.heldMs)} after it settled, ${s(d.deadMs)} past the beat`,\n  )\n  return `dead time: ${s(r.ms)} (${r.pct} %), a still frame under a parked cursor past the reading beat: ${parts.join('; ')}. Cut those steps' ms; a hold is what it takes to read what changed.`\n}\n"],"mappings":"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","names":["askedMs"]}

package/dist/{chunk-EFI3WUQB.js → chunk-P3X5KVA6.js}

@@ -77,11 +77,24 @@ var manifest = {
     {
       name: "login",
       summary: "sign in via the browser (or --key); stores a content key"
-    }
+    },
+    {
+      name: "setup",
+      summary: "ready this machine: the vos skills into your agent, a browser, one rules block, then doctor"
+    },
+    {
+      name: "doctor",
+      summary: "what is ready, in words: node, browser, ffmpeg, skills, a credential (never printed), the dev server"
+    },
+    {
+      name: "whoami",
+      summary: "the key\u2019s name and the account it belongs to, never the key"
+    },
+    { name: "logout", summary: "remove ~/.config/vos/credentials" }
   ]
 };
 
 export {
   manifest
 };
-//# sourceMappingURL=chunk-EFI3WUQB.js.map
+//# sourceMappingURL=chunk-P3X5KVA6.js.map

package/dist/{chunk-EFI3WUQB.js.map → chunk-P3X5KVA6.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/plugin/manifest.ts"],"sourcesContent":["/**\n * The verb manifest of the take pipeline and the vos.so verbs — what\n * `vos help` lists under the engine verbs. It kept the shape a separately\n * installed plugin once handed the host (name + host range), so a script\n * reading it keeps working.\n */\nexport interface PluginVerb {\n  name: string\n  summary: string\n}\n\nexport interface PluginManifest {\n  name: string\n  /** Host versions this plugin speaks the run(argv) contract with. */\n  hostRange: string\n  verbs: PluginVerb[]\n}\n\nexport const manifest: PluginManifest = {\n  name: '@vosjs/cli',\n  hostRange: '>=0.9.0',\n  verbs: [\n    {\n      name: 'create',\n      summary: 'record + auto-plan + render, one command (--strict)',\n    },\n    {\n      name: 'record',\n      summary: 'drive actions.json into a take (screencast + cursor track)',\n    },\n    {\n      name: 'plan',\n      summary:\n        'plan zoom/cursor effects into doc.json (wand contract); --reuse re-times a previous cut onto a re-recording',\n    },\n    {\n      name: 'render',\n      summary: 'render a take directory (engine configs render in the host)',\n    },\n    {\n      name: 'frames',\n      summary:\n        'PNG stills at output times / zoom apexes / moments / exact sizes',\n    },\n    {\n      name: 'deliver',\n      summary:\n        'render a take to release destinations (CWS, Product Hunt, X, LinkedIn, OG…) + verified kit.json',\n    },\n    {\n      name: 'digest',\n      summary:\n        'see a recording before cutting it: moments (clicks, typing, scrolls, idle, scenes) + footage frames + crops, in doc units',\n    },\n    { name: 'open', summary: 'serve the take into the vos.so studio' },\n    {\n      name: 'validate',\n      summary:\n        'lint actions.json, a take dir (doc.json semantics), or re-measure a kit.json against the channel specs',\n    },\n    {\n      name: 'actions',\n      summary:\n        'from-agent-browser: turn an agent-browser walk (steps.jsonl) into actions.json; what cannot follow is named',\n    },\n    {\n      name: 'brand',\n      summary:\n        \"write a product's BRAND.md, witnessed: /design.md, /llms.txt, then the page (palette, faces, marks, the avoid list)\",\n    },\n    {\n      name: 'fetch',\n      summary: 'download a hosted program: config.json + vos.json tracking',\n    },\n    {\n      name: 'push',\n      summary: 'push a config.json or take to vos.so (private; versioned)',\n    },\n    {\n      name: 'duplicate',\n      summary:\n        'a private sibling of your OWN vos (someone else\\u2019s is remixed: fetch + push --remix-of)',\n    },\n    {\n      name: 'pull',\n      summary:\n        'sync what changed on vos.so since your base (--media brings a take’s footage home)',\n    },\n    {\n      name: 'folder',\n      summary:\n        'list/create/pull folders, move voses and assets into them (pull = the context package on disk)',\n    },\n    {\n      name: 'asset',\n      summary: 'rename one of your assets in place (recipes included)',\n    },\n    {\n      name: 'recipe',\n      summary:\n        'push a recipe .md into a folder, or replace one in place (prior body kept)',\n    },\n    {\n      name: 'login',\n      summary: 'sign in via the browser (or --key); stores a content key',\n    },\n  ],\n}\n"],"mappings":";;;AAkBO,IAAM,WAA2B;AAAA,EACtC,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA,EAAE,MAAM,QAAQ,SAAS,wCAAwC;AAAA,IACjE;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/plugin/manifest.ts"],"sourcesContent":["/**\n * The verb manifest of the take pipeline and the vos.so verbs — what\n * `vos help` lists under the engine verbs. It kept the shape a separately\n * installed plugin once handed the host (name + host range), so a script\n * reading it keeps working.\n */\nexport interface PluginVerb {\n  name: string\n  summary: string\n}\n\nexport interface PluginManifest {\n  name: string\n  /** Host versions this plugin speaks the run(argv) contract with. */\n  hostRange: string\n  verbs: PluginVerb[]\n}\n\nexport const manifest: PluginManifest = {\n  name: '@vosjs/cli',\n  hostRange: '>=0.9.0',\n  verbs: [\n    {\n      name: 'create',\n      summary: 'record + auto-plan + render, one command (--strict)',\n    },\n    {\n      name: 'record',\n      summary: 'drive actions.json into a take (screencast + cursor track)',\n    },\n    {\n      name: 'plan',\n      summary:\n        'plan zoom/cursor effects into doc.json (wand contract); --reuse re-times a previous cut onto a re-recording',\n    },\n    {\n      name: 'render',\n      summary: 'render a take directory (engine configs render in the host)',\n    },\n    {\n      name: 'frames',\n      summary:\n        'PNG stills at output times / zoom apexes / moments / exact sizes',\n    },\n    {\n      name: 'deliver',\n      summary:\n        'render a take to release destinations (CWS, Product Hunt, X, LinkedIn, OG…) + verified kit.json',\n    },\n    {\n      name: 'digest',\n      summary:\n        'see a recording before cutting it: moments (clicks, typing, scrolls, idle, scenes) + footage frames + crops, in doc units',\n    },\n    { name: 'open', summary: 'serve the take into the vos.so studio' },\n    {\n      name: 'validate',\n      summary:\n        'lint actions.json, a take dir (doc.json semantics), or re-measure a kit.json against the channel specs',\n    },\n    {\n      name: 'actions',\n      summary:\n        'from-agent-browser: turn an agent-browser walk (steps.jsonl) into actions.json; what cannot follow is named',\n    },\n    {\n      name: 'brand',\n      summary:\n        \"write a product's BRAND.md, witnessed: /design.md, /llms.txt, then the page (palette, faces, marks, the avoid list)\",\n    },\n    {\n      name: 'fetch',\n      summary: 'download a hosted program: config.json + vos.json tracking',\n    },\n    {\n      name: 'push',\n      summary: 'push a config.json or take to vos.so (private; versioned)',\n    },\n    {\n      name: 'duplicate',\n      summary:\n        'a private sibling of your OWN vos (someone else\\u2019s is remixed: fetch + push --remix-of)',\n    },\n    {\n      name: 'pull',\n      summary:\n        'sync what changed on vos.so since your base (--media brings a take’s footage home)',\n    },\n    {\n      name: 'folder',\n      summary:\n        'list/create/pull folders, move voses and assets into them (pull = the context package on disk)',\n    },\n    {\n      name: 'asset',\n      summary: 'rename one of your assets in place (recipes included)',\n    },\n    {\n      name: 'recipe',\n      summary:\n        'push a recipe .md into a folder, or replace one in place (prior body kept)',\n    },\n    {\n      name: 'login',\n      summary: 'sign in via the browser (or --key); stores a content key',\n    },\n    {\n      name: 'setup',\n      summary:\n        'ready this machine: the vos skills into your agent, a browser, one rules block, then doctor',\n    },\n    {\n      name: 'doctor',\n      summary:\n        'what is ready, in words: node, browser, ffmpeg, skills, a credential (never printed), the dev server',\n    },\n    {\n      name: 'whoami',\n      summary: 'the key’s name and the account it belongs to, never the key',\n    },\n    { name: 'logout', summary: 'remove ~/.config/vos/credentials' },\n  ],\n}\n"],"mappings":";;;AAkBO,IAAM,WAA2B;AAAA,EACtC,MAAM;AAAA,EACN,WAAW;AAAA,EACX,OAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA,EAAE,MAAM,QAAQ,SAAS,wCAAwC;AAAA,IACjE;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA,EAAE,MAAM,UAAU,SAAS,mCAAmC;AAAA,EAChE;AACF;","names":[]}

package/dist/cli.js

@@ -511,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-2OZS25ER.js");
+  const { run } = await import("./run-CYHH56KA.js");
   if (viaAlias && argv[0]) {
     process.stderr.write(
       `note: "vos voila ${argv[0]}" is now "vos ${argv[0]}".
@@ -522,7 +522,7 @@ async function delegate(argv, viaAlias = false) {
 }
 async function printHelp() {
   process.stdout.write(HELP_ENGINE);
-  const { manifest } = await import("./manifest-UCS6OVWZ.js");
+  const { manifest } = await import("./manifest-A4R367EM.js");
   process.stdout.write("\nTake pipeline + vos.so verbs\n");
   for (const v of manifest.verbs) {
     if (v.name === "render") continue;
@@ -551,7 +551,7 @@ async function main() {
     const engine = HELP_ENGINE.split("\n").filter(
       (l) => l.startsWith(`  vos ${cmd} `)
     );
-    const { verbHelp } = await import("./run-2OZS25ER.js");
+    const { verbHelp } = await import("./run-CYHH56KA.js");
     const take = verbHelp(cmd);
     process.stdout.write(
       `${engine.join("\n")}
@@ -583,7 +583,7 @@ ${take.includes("no such verb") ? "" : take}`
 main().then(async (code) => {
   if (code === EXIT_OK) {
     const verb = process.argv[2] ?? "";
-    const { HELP } = await import("./run-2OZS25ER.js");
+    const { HELP } = await import("./run-CYHH56KA.js");
     const documented = [
       ...helpFlagsFor(HELP_ENGINE, verb),
       ...helpFlagsFor(HELP, verb)

package/dist/index.js

@@ -30,17 +30,17 @@ import {
   validateActions,
   waitForPageDone,
   writeSyncState
-} from "./chunk-UE66DC2K.js";
+} from "./chunk-ANKECV7F.js";
 import {
   BrowserUnavailableError,
   configDuration,
   launchBrowser,
   loadVosConfig
 } from "./chunk-FACYY7VV.js";
-import "./chunk-ID4OUS5L.js";
+import "./chunk-AUPGJJTL.js";
 import {
   manifest
-} from "./chunk-EFI3WUQB.js";
+} from "./chunk-P3X5KVA6.js";
 export {
   BrowserUnavailableError,
   RECORDING_NAME,

package/dist/manifest-A4R367EM.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import {
+  manifest
+} from "./chunk-P3X5KVA6.js";
+export {
+  manifest
+};
+//# sourceMappingURL=manifest-A4R367EM.js.map

package/dist/{run-2OZS25ER.js → run-CYHH56KA.js}

@@ -5,9 +5,9 @@ import {
   run,
   takeBrowserArgs,
   verbHelp
-} from "./chunk-UE66DC2K.js";
+} from "./chunk-ANKECV7F.js";
 import "./chunk-FACYY7VV.js";
-import "./chunk-ID4OUS5L.js";
+import "./chunk-AUPGJJTL.js";
 export {
   HELP,
   MULTI_FLAGS,
@@ -15,4 +15,4 @@ export {
   takeBrowserArgs,
   verbHelp
 };
-//# sourceMappingURL=run-2OZS25ER.js.map
+//# sourceMappingURL=run-CYHH56KA.js.map

package/dist/{shotList-JC4A3FBT.js → shotList-7F2FE3RU.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   askedMs
-} from "./chunk-ID4OUS5L.js";
+} from "./chunk-AUPGJJTL.js";
 
 // src/plugin/shotList.ts
 function sayTarget(selector) {
@@ -108,4 +108,4 @@ export {
   sayTarget,
   shotList
 };
-//# sourceMappingURL=shotList-JC4A3FBT.js.map
+//# sourceMappingURL=shotList-7F2FE3RU.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vosjs/cli",
-  "version": "0.46.1",
+  "version": "0.48.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",
@@ -42,20 +42,21 @@
   },
   "files": [
     "dist",
-    "schema"
+    "schema",
+    "skills"
   ],
   "sideEffects": false,
   "dependencies": {
     "mediabunny": "^1.55.7",
     "playwright": "^1.49.0",
     "@vosjs/core": "^0.25.0",
+    "@vosjs/editor": "^1.3.1",
     "@vosjs/elements": "^0.8.1",
-    "@vosjs/render-core": "^0.2.8",
+    "@vosjs/render-core": "^0.2.9",
     "@vosjs/shared": "^0.4.1",
-    "@vosjs/studio-core": "^0.30.1",
-    "@vosjs/editor": "^1.3.1",
-    "@vosjs/timeline": "^0.4.1",
-    "@vosjs/tween": "^0.8.2"
+    "@vosjs/studio-core": "^0.30.3",
+    "@vosjs/tween": "^0.8.2",
+    "@vosjs/timeline": "^0.4.1"
   },
   "devDependencies": {
     "@types/node": "^22",
@@ -68,6 +69,7 @@
   },
   "scripts": {
     "build": "tsup",
+    "sync-skills": "node scripts/sync-skills.mjs",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
     "test": "vitest run",

package/schema/actions.schema.json

@@ -69,7 +69,7 @@
           },
           "ms": {
             "type": "number",
-            "description": "wait: the pause; other verbs: the settle after (default 150)"
+            "description": "wait: the pause; click: the read after the page settled, held from its last visual change (default 150); type and scroll: the settle after (defaults 150/200)"
           }
         }
       }
@@ -165,7 +165,7 @@
               "ms": {
                 "type": "number",
                 "minimum": 0,
-                "description": "the settle after the press, ms (default 150): how long the recorder holds before the next step. The script's own wait steps carry the pauses that mean something; this is only the hand lifting."
+                "description": "the read after the press, ms (default 150), held from the page's last visual change: the recorder watches the screencast and pays the settle itself (a change within 400 ms says the page is answering, 250 ms of quiet says it settled, 1.2 s bounds a page that never stops), so the same ms reads the same on every run. Size it as a reading beat, about 1000 after a navigation and 600 after a control, never padded for a slow page."
               },
               "selector": {
                 "type": "string"

package/skills/VERSION

@@ -0,0 +1 @@
+0.5.0