@vosjs/cli 0.39.0 → 0.40.0

package/README.md

@@ -217,8 +217,9 @@ Everything that runs on your machine is open source; [vos.so](https://vos.so) is
 vos login [--key <k>] [--label <name>] [--no-browser]   # browser sign-in: a code and a vos.so/cli/auth URL, a human approves, the key stores itself
 vos fetch <vosId|url> [--out <slug>] [--media]         # a program writes config.json + vos.json; a take writes doc.json (+ the recording with --media)
 vos check bright-loop/config.json                      # full local validation
-vos push bright-loop/config.json                       # create a PRIVATE vos (lineage from vos.json or --remix-of)
-vos push bright-loop/config.json --vos <id>            # add a version against your tracked base
+vos push bright-loop/config.json                       # untracked: create a PRIVATE vos. Tracked (vos.json): add a version to it
+vos push bright-loop/config.json --vos <id>            # add a version to a vos this directory does not track
+vos push bright-loop/config.json --remix-of <id>       # create a SEPARATE vos from this config, with that lineage
 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 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
@@ -229,7 +230,7 @@ vos asset push <file…> [--folder <slug>] | rename <id> <name.ext>
 vos recipe push <FILE.md> --folder <slug> | --asset <id>   # the one recipe write: create, or replace in place
 ```
 
-`push` is polymorphic by a deterministic sniff, never a flag: a take directory (a `doc.json` carrying `source`) pushes recording and document through the take pipeline; a `config.json` (or a directory holding one) pushes the program, and a `doc.json` beside it that carries `program` (a program document: overlays, objects, audio, speed, tween edits, its own length; `program.config` omitted on disk) rides along, lint-gated. `fetch` and `pull` write a program document back the same way. `pull` takes `--since <versionId>` (walk the changelog from that base instead of the tracked one) and `--check` (print what changed and stop: nothing on disk moves) on both paths. Program pushes take `--vos`, `--title`, `--slug`, `--desc`, `--tags`, `--folder`, `--remix-of`, `--base`, `--label`, `--note`, `--override <id>` (repeatable) and `--claimable`; take pushes take `--title`, `--label`, `--note`, `--folder`, `--override` and `--yes`.
+`push` is polymorphic by a deterministic sniff, never a flag: a take directory (a `doc.json` carrying `source`) pushes recording and document through the take pipeline; a `config.json` (or a directory holding one) pushes the program, and a `doc.json` beside it that carries `program` (a program document: overlays, objects, audio, speed, tween edits, its own length; `program.config` omitted on disk) rides along, lint-gated. `fetch` and `pull` write a program document back the same way. `pull` takes `--since <versionId>` (walk the changelog from that base instead of the tracked one) and `--check` (print what changed and stop: nothing on disk moves) on both paths. A program push LANDS where `vos.json` says: a directory that tracks a vos iterates it, so the fetch, edit, check, push, pull loop needs no flags, and making something separate from the same config is the explicit `--remix-of` door. Program pushes take `--vos`, `--title`, `--slug`, `--desc`, `--tags`, `--folder`, `--remix-of`, `--base`, `--label`, `--note`, `--override <id>` (repeatable) and `--claimable`; take pushes take `--title`, `--label`, `--note`, `--folder`, `--override` and `--yes`.
 
 Both paths share the same base tracking and the same two 409 shapes. `stale_base` replays the platform's typed changelog: run `vos pull`, re-apply, push again. `protected_conflict` lists nodes a human edited in the studio: keep their values, or re-push with `--override <id>` only when the user asked for that exact change. The first push of a take asks before uploading (`--yes` for headless); agents never upload unprompted. The take's duration rides the upload, and the platform refuses a take over the hosted recording cap. Every push should carry `--label` (what changed, one line) and `--note` (why: the user's ask); the version history reads as a conversation, and an unlabelled push is a turn the human cannot read.
 

package/dist/{chunk-RECQEBXN.js → chunk-7TDL3N24.js}

@@ -7971,6 +7971,21 @@ function takePushRefusal(ask) {
     return `this take tracks vos ${ask.trackedVosId} (its vos.json), not ${ask.vos}. Drop --vos to push there, or remove vos.json to adopt ${ask.vos} instead`;
   return null;
 }
+function programPushTarget(ask) {
+  if (ask.vos) return { kind: "version", vosId: ask.vos, tracked: false };
+  if (ask.remixOf) return { kind: "create", remixOfId: ask.remixOf };
+  const tracked = ask.trackedVosId;
+  if (!tracked) return { kind: "create" };
+  const extra = ask.createOnly ?? [];
+  if (extra.length) {
+    const list = extra.map((f) => `--${f}`).join(", ");
+    return {
+      kind: "refuse",
+      why: `this directory tracks vos ${tracked} (vos.json), so a bare push adds a VERSION to it, and ${list} ${extra.length > 1 ? "apply" : "applies"} only when creating. To make a separate vos from this config: vos push <config.json> --remix-of ${tracked} ${list}. To change the tracked vos's title or slug, edit it on vos.so`
+    };
+  }
+  return { kind: "version", vosId: tracked, tracked: true };
+}
 async function pushTake(dir, flags, r) {
   const take = await loadTake(dir);
   if (!take.doc) {
@@ -8659,7 +8674,7 @@ async function cmdPushProgram(argv) {
   const config = pre.config;
   const state = readSyncState(dir);
   const vosFlag = strFlag(flags, "vos");
-  const vosId = vosFlag ? parseVosId(vosFlag) : null;
+  const explicitVosId = vosFlag ? parseVosId(vosFlag) : null;
   const programDoc = await readProgramDoc(dir, config);
   if (programDoc) {
     const lint = lintDoc(programDoc);
@@ -8670,7 +8685,7 @@ async function cmdPushProgram(argv) {
     for (const w of lint.warnings) r.log(`warning doc.json: ${w}`);
   }
   if (flags.claimable === true) {
-    if (vosId) {
+    if (explicitVosId) {
       throw new UsageError(
         "--claimable creates a NEW claimable vos and cannot iterate (--vos). After the human claims it, iterate with their key: vos push --vos <id>"
       );
@@ -8704,6 +8719,15 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
   const desc = strFlag(flags, "desc");
   const tagsFlag = strFlag(flags, "tags");
   const folderRef = strFlag(flags, "folder");
+  const remixOfFlag = strFlag(flags, "remix-of");
+  const pushTarget = programPushTarget({
+    vos: explicitVosId,
+    remixOf: remixOfFlag,
+    trackedVosId: state?.vosId ?? null,
+    createOnly: ["title", "slug"].filter((f) => strFlag(flags, f))
+  });
+  if (pushTarget.kind === "refuse") throw new UsageError(pushTarget.why);
+  const vosId = pushTarget.kind === "version" ? pushTarget.vosId : null;
   if (vosId && (desc || tagsFlag || folderRef)) {
     throw new UsageError(
       "--desc/--tags/--folder apply when CREATING a vos. On an existing one: vos folder move <id> --to <folder> for filing; edit title/description/tags on vos.so"
@@ -8772,7 +8796,7 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
     );
     return EXIT_OK;
   }
-  const remixOfId = strFlag(flags, "remix-of") ?? state?.vosId;
+  const remixOfId = pushTarget.kind === "create" ? pushTarget.remixOfId : void 0;
   const fallbackTitle = state?.title ? `${state.title} remix` : basename4(source).replace(/\.json$/i, "") || "vos remix";
   const title = (strFlag(flags, "title") ?? fallbackTitle).slice(0, 100);
   const folderId = folderRef ? resolveFolder(await listFolders(origin, key), folderRef).id : void 0;
@@ -11740,4 +11764,4 @@ export {
   takeBrowserArgs,
   run
 };
-//# sourceMappingURL=chunk-RECQEBXN.js.map
+//# sourceMappingURL=chunk-7TDL3N24.js.map