@vosjs/cli 0.52.2 → 0.53.0

package/README.md

@@ -303,6 +303,7 @@ vos push bright-loop/config.json --remix-of <id>       # create a SEPARATE vos f
 vos push bright-loop/config.json --claimable           # no credential: a 72 h claim link instead (programs only)
 vos push take --yes --label "first pass" --note "…"    # host a take: private vos + version history (the recording uploads once)
 vos push … --wait                                      # stay until the version's still renders; print absolute still and preview links
+vos push config.json --still 2.5                        # a program's cover: doc.json "still", kept by every later push
 vos delete <vosId|url|dir> [--yes]                     # take a vos off vos.so, every version; asks, or --yes headless
 vos pull bright-loop [--since <versionId>] [--check]   # what changed on vos.so since your base; syncs config.json (backup kept), or doc.json for a take
                                                        # --check reports without writing; --since walks from a base you name

package/dist/{chunk-4Z6GQCXQ.js → chunk-WGBRKQPB.js}

@@ -8159,6 +8159,14 @@ async function cmdPushProgram(argv) {
   const state = readSyncState(dir);
   const vosFlag = strFlag(flags, "vos");
   const explicitVosId = vosFlag ? parseVosId(vosFlag) : null;
+  const stillFlag = strFlag(flags, "still");
+  if (stillFlag !== void 0) {
+    const t = Number(stillFlag);
+    if (!Number.isFinite(t) || t < 0)
+      throw new UsageError("--still expects seconds, like --still 2.5");
+    await setProgramStill(dir, t);
+    r.log(`cover: ${t}s (doc.json "still")`);
+  }
   const programDoc = await readProgramDoc(dir, config);
   if (programDoc) {
     const lint = lintDoc(programDoc);
@@ -8383,6 +8391,7 @@ ${landedLines(landed2)}` : "")
   studio: ${studioUrl}
 ` + (landed ? `${landedLines(landed)}
 ` : "") + `  shelf:  ${folderRef ? `in ${folderRef}` : `unfiled, at the root of your shelf (file it: vos folder move ${created.id} --to <slug>)`}
+  cover:  ${typeof programDoc?.still === "number" ? `${String(programDoc.still)}s` : "the platform picks an early frame; choose one with --still <seconds>"}
 Iterate with: vos push ${source} --vos ${created.id}`
   );
   return EXIT_OK;
@@ -8579,6 +8588,19 @@ async function readProgramDoc(dir, config) {
   const program = raw.program && typeof raw.program === "object" ? raw.program : {};
   return { ...raw, program: { ...program, config } };
 }
+async function setProgramStill(dir, t) {
+  const docPath = join17(dir, "doc.json");
+  let doc = { program: {}, audio: [] };
+  if (existsSync15(docPath)) {
+    const parsed = JSON.parse(await readFile15(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");
+}
 async function writeProgramDoc(dir, hosted) {
   const program = hosted.program && typeof hosted.program === "object" ? hosted.program : {};
   const { config, ...rest } = program;
@@ -10722,7 +10744,7 @@ Platform (vos.so) \u2014 fetch, edit, push, pull, repeat
   vos push  <config.json|take> [--vos id] [--title t] [--slug s] [--remix-of id]
             [--desc d] [--tags a,b] [--folder <folderId|slug>]
             [--note n] [--label l] [--base versionId] [--override <id>]... [--yes] [--json]
-            [--claimable] [--wait]
+            [--claimable] [--wait] [--still <seconds>]
             a take DIRECTORY (doc.json) pushes recording + doc; a config.json
             pushes the program. No --vos: create a PRIVATE vos; with --vos:
             add a version against the tracked base \u2014 a stale push 409s WITH
@@ -10738,6 +10760,9 @@ Platform (vos.so) \u2014 fetch, edit, push, pull, repeat
             shelf. A document's local sound (doc.json audio keys) uploads
             with the push. --wait stays until the version's still has
             rendered and prints absolute still and preview links.
+            --still <seconds> sets a PROGRAM's cover (doc.json "still", kept
+            by every later push); without it the platform picks an early
+            frame. A take's cover is its doc.json "still".
   vos delete <vosId|watch-url|dir> [--yes] [--json]
             take a vos off vos.so, every version of it, for good. Asks on a
             terminal; headless it needs --yes. A dir that tracked it is
@@ -12363,7 +12388,7 @@ async function cmdPush3(argv) {
   const refusal = takePushRefusal({
     vos: strFlag(flags, "vos"),
     trackedVosId: readSyncState(resolve10(dir))?.vosId ?? null,
-    programOnly: ["slug", "desc", "tags", "base", "remix-of"].filter(
+    programOnly: ["slug", "desc", "tags", "base", "remix-of", "still"].filter(
       (name) => hasFlag(flags, name)
     )
   });
@@ -12715,4 +12740,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-4Z6GQCXQ.js.map
+//# sourceMappingURL=chunk-WGBRKQPB.js.map