@vosjs/cli 0.75.0 → 0.76.0

package/README.md

@@ -37,13 +37,13 @@ Until 0.9 the take pipeline and the vos.so verbs shipped separately as `@vosso/v
 Node 18 or newer and a Chromium-family browser. A system Chrome is used when present; otherwise `npx playwright install chromium` once, or set `VOS_BROWSER_PATH`. mp4 output needs Chrome (Chromium ships no AVC encoder). Render pages load `three` and mediabunny from a CDN, so rendering needs network access.
 
 ```bash
-vos setup [--agent claude,cursor,codex,copilot|all] [--global] [--no-skills] [--no-rules] [--no-browser] [--url <dev server>]
+vos setup [--agent claude,cursor,codex,copilot|all] [--global] [--no-skills] [--skills-from-catalog] [--no-rules] [--no-browser] [--url <dev server>]
 vos doctor [--url <dev server>]     # what is ready, in words; exit 3 when no browser
 vos whoami                          # the key's name and the account it belongs to, never the key
 vos logout                          # remove ~/.config/vos/credentials
 ```
 
-`vos setup` detects the agents present by their directories (`.claude/`, `.cursor/`, `.codex/` or `.agents/`, `.github/copilot`; the home forms under `--global`), installs the skills into them through skills.sh (`npx skills add vosjs/skills -y`) or, when that cannot be reached, from the copy of the catalog this package ships (`skills/`), finds a browser in the recorder's own order or installs Chromium, writes one block between `<!-- vos:begin -->` and `<!-- vos:end -->` markers into `AGENTS.md` (or `CLAUDE.md` when only that exists), so a second run replaces its own text and never yours, and ends with `doctor`. These four verbs print NDJSON whenever stdout is not a TTY, and every `done` event carries `next_step`.
+`vos setup` detects the agents present by their directories (`.claude/`, `.cursor/`, `.codex/` or `.agents/`, `.github/copilot`; the home forms under `--global`), installs the skills into them from the copy of the catalog this package ships (`skills/`, the catalog at the tag this release was cut from; `--skills-from-catalog` fetches that same tag through skills.sh instead, with the bundled copy as the fallback when it cannot be reached), finds a browser in the recorder's own order or installs Chromium, writes one block between `<!-- vos:begin -->` and `<!-- vos:end -->` markers into `AGENTS.md` (or `CLAUDE.md` when only that exists), so a second run replaces its own text and never yours, and ends with `doctor`. These four verbs print NDJSON whenever stdout is not a TTY, and every `done` event carries `next_step`.
 
 ## Engine verbs
 

package/dist/{chunk-X6NQNBDF.js → chunk-OJ3ZCPYS.js}

@@ -12053,6 +12053,14 @@ function doctorReport(facts) {
     next_step = "Record: npx vos record --actions actions.json --out take --strict (the product-video skill writes actions.json)";
   return { ok: nodeOk && browserOk, lines, next_step, facts };
 }
+function bundledSkillsVersion(dir) {
+  try {
+    const v = readFileSync10(join23(dir, "VERSION"), "utf8").trim();
+    return /^\d+\.\d+\.\d+$/.test(v) ? v : null;
+  } catch {
+    return null;
+  }
+}
 function bundledSkillsDir(from) {
   let dir = dirname8(from);
   for (let i = 0; i < 6; i++) {
@@ -12080,10 +12088,15 @@ var BOOLEAN_FLAGS11 = /* @__PURE__ */ new Set([
   "help",
   "global",
   "no-skills",
+  "skills-from-catalog",
   "no-rules",
   "no-browser"
 ]);
 var SKILLS_SOURCE = "vosjs/skills";
+var SKILLS_CLI_VERSION = "1.7.2";
+function skillsCatalogAt(version) {
+  return `https://github.com/${SKILLS_SOURCE}/tree/v${version}`;
+}
 function reporterFor(flags) {
   return createReporter(flags.json === true || process.stdout.isTTY !== true);
 }
@@ -12159,6 +12172,7 @@ async function cmdSetup(argv) {
   const global = flags.global === true;
   const url = strFlag(flags, "url");
   const noSkills = flags["no-skills"] === true;
+  const fromCatalog = flags["skills-from-catalog"] === true;
   const noRules = flags["no-rules"] === true;
   const noBrowser = flags["no-browser"] === true;
   const wanted = strFlag(flags, "agent");
@@ -12178,48 +12192,61 @@ async function cmdSetup(argv) {
   let skillsVia = "skipped";
   let skillNames = [];
   if (!noSkills) {
-    const args = [
-      "skills",
-      "add",
-      SKILLS_SOURCE,
-      "-y",
-      ...global ? ["-g"] : []
-    ];
-    r.log(`installing the vos skills: npx ${args.join(" ")}`);
-    const res = spawnSync4(npx(), args, {
-      cwd: root,
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "pipe"],
-      shell: process.platform === "win32",
-      timeout: 12e4
-    });
-    if (res.status === 0) {
-      skillsVia = "skills.sh";
-    } else {
-      const bundled = bundledSkillsDir(import.meta.url.replace("file://", ""));
-      if (!bundled)
-        throw new Error(
-          `could not install the skills: npx skills add ${SKILLS_SOURCE} failed (${(res.stderr ?? "").trim().split("\n").at(-1) ?? res.error?.message ?? "no output"}) and this build carries no bundled copy`
-        );
-      const targets = homes.length ? homes : [fallbackSkillsHome(root)];
+    const bundled = bundledSkillsDir(import.meta.url.replace("file://", ""));
+    const version = bundled ? bundledSkillsVersion(bundled) : null;
+    const targets = homes.length ? homes : [fallbackSkillsHome(root)];
+    const copyBundled = (dir) => {
       for (const home of targets) {
         const dest = skillsDirFor(home);
         mkdirSync6(dest, { recursive: true });
-        for (const name of installedSkills(bundled)) {
-          cpSync(join24(bundled, name), join24(dest, name), { recursive: true });
+        for (const name of installedSkills(dir)) {
+          cpSync(join24(dir, name), join24(dest, name), { recursive: true });
         }
       }
+    };
+    if (fromCatalog) {
+      const source = version ? skillsCatalogAt(version) : SKILLS_SOURCE;
+      const args = [
+        `skills@${SKILLS_CLI_VERSION}`,
+        "add",
+        source,
+        "-y",
+        ...global ? ["-g"] : []
+      ];
+      r.log(`installing the vos skills: npx ${args.join(" ")}`);
+      const res = spawnSync4(npx(), args, {
+        cwd: root,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+        shell: process.platform === "win32",
+        timeout: 12e4
+      });
+      if (res.status === 0) {
+        skillsVia = "skills.sh";
+      } else {
+        if (!bundled)
+          throw new Error(
+            `could not install the skills: npx ${args.join(" ")} failed (${(res.stderr ?? "").trim().split("\n").at(-1) ?? res.error?.message ?? "no output"}) and this build carries no bundled copy`
+          );
+        copyBundled(bundled);
+        skillsVia = "bundled";
+        r.log(
+          `skills.sh did not answer; copied the bundled skills into ${targets.map((t) => skillsDirFor(t)).join(", ")}`
+        );
+      }
+    } else {
+      if (!bundled)
+        throw new Error(
+          "this build carries no bundled skills; run with --skills-from-catalog"
+        );
+      copyBundled(bundled);
       skillsVia = "bundled";
       r.log(
-        `skills.sh did not answer; copied the bundled skills into ${targets.map((t) => skillsDirFor(t)).join(", ")}`
+        `installed the bundled vos skills${version ? ` (catalog ${version})` : ""} into ${targets.map((t) => skillsDirFor(t)).join(", ")}`
       );
     }
     skillNames = [
-      ...new Set(
-        (homes.length ? homes : [fallbackSkillsHome(root)]).flatMap(
-          (h) => installedSkills(skillsDirFor(h))
-        )
-      )
+      ...new Set(targets.flatMap((h) => installedSkills(skillsDirFor(h))))
     ].sort();
   }
   r.event({ event: "skills", via: skillsVia, names: skillNames });
@@ -12432,11 +12459,12 @@ Take pipeline
             the flow as numbered beats in words, for a person recording it by hand
 
 This machine (no account)
-  vos setup [--agent claude,cursor,codex,copilot|all] [--global] [--no-skills] [--no-rules] [--no-browser] [--url <dev server>] [--json]
+  vos setup [--agent claude,cursor,codex,copilot|all] [--global] [--no-skills] [--skills-from-catalog] [--no-rules] [--no-browser] [--url <dev server>] [--json]
             ready this computer for the loop: the vos skills into your
-            agent's directories (npx skills add vosjs/skills, else the copy
-            bundled in this package), a browser found or installed, one
-            idempotent block in AGENTS.md (or CLAUDE.md), then doctor.
+            agent's directories (the copy bundled in this package, or with
+            --skills-from-catalog the same tag through skills.sh), a
+            browser found or installed, one idempotent block in AGENTS.md
+            (or CLAUDE.md), then doctor.
             NDJSON whenever stdout is not a TTY; done carries next_step
   vos doctor [--url <dev server>] [--json]
             what is ready, in words: node, browser, ffmpeg, the skills per
@@ -14447,4 +14475,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-X6NQNBDF.js.map
+//# sourceMappingURL=chunk-OJ3ZCPYS.js.map