@brainbase-labs/cli 0.4.0 → 0.4.2

package/dist/index.js

@@ -33782,7 +33782,7 @@ var BrainbaseSourceSchema = exports_external.object({
   type: exports_external.literal("brainbase"),
   creator: exports_external.string().regex(/^[a-z0-9_-]+$/i),
   slug: exports_external.string().regex(/^[a-z0-9_-]+$/i),
-  version: exports_external.string().regex(/^\d+\.\d+\.\d+$/)
+  version: exports_external.string().regex(/^\d+\.\d+\.\d+$/).optional()
 });
 var InlineSourceSchema = exports_external.object({ type: exports_external.literal("inline") });
 var LocalSourceSchema = exports_external.object({ type: exports_external.literal("local") });
@@ -48541,7 +48541,7 @@ function parseSkillSource(input) {
       type: "brainbase",
       creator: bb[1],
       slug: bb[2],
-      version: bb[3] ?? "0.0.0"
+      version: bb[3]
     };
   }
   if (s3.startsWith("file://") || s3.startsWith("./") || s3.startsWith("../") || s3.startsWith("/") || s3.startsWith("~")) {
@@ -48616,7 +48616,7 @@ function describeSource(source) {
     case "git":
       return `git:${source.url}${source.ref ? "@" + source.ref : ""}${source.subpath ? " (" + source.subpath + ")" : ""}`;
     case "brainbase":
-      return `brainbase://${source.creator}/${source.slug}@${source.version}`;
+      return `brainbase://${source.creator}/${source.slug}${source.version ? "@" + source.version : " (latest)"}`;
   }
 }
 
@@ -49722,14 +49722,24 @@ var brainbaseResolver = {
     if (source.type !== "brainbase") {
       throw new Error("expected brainbase source");
     }
-    const remoteVersion = await skillsApi.getVersion(source.creator, source.slug, source.version);
+    let version = source.version;
+    if (!version) {
+      const pkg = await skillsApi.getPackage(source.creator, source.slug);
+      const latest = pkg.latest_version;
+      if (!latest) {
+        throw new Error(`${source.creator}/${source.slug} has no published versions`);
+      }
+      version = latest.version;
+      source.version = version;
+    }
+    const remoteVersion = await skillsApi.getVersion(source.creator, source.slug, version);
     if (remoteVersion.yanked) {
-      throw new Error(`${source.creator}/${source.slug}@${source.version} has been yanked${remoteVersion.yanked_reason ? ": " + remoteVersion.yanked_reason : ""}`);
+      throw new Error(`${source.creator}/${source.slug}@${version} has been yanked${remoteVersion.yanked_reason ? ": " + remoteVersion.yanked_reason : ""}`);
     }
     const tmp = fs33.mkdtempSync(path36.join(os8.tmpdir(), "bb-skill-"));
     const tarPath = path36.join(tmp, "skill.tgz");
     try {
-      await skillsApi.downloadTarball(source.creator, source.slug, source.version, tarPath);
+      await skillsApi.downloadTarball(source.creator, source.slug, version, tarPath);
       await verifyTarball(tarPath, remoteVersion.bundle_sha256);
       ensureDir(destDir);
       await extract({ tarFile: tarPath, outDir: destDir });
@@ -49938,59 +49948,52 @@ import path40 from "node:path";
 import os9 from "node:os";
 import fs37 from "node:fs";
 var import_picocolors16 = __toESM(require_picocolors(), 1);
-function parseRef3(input) {
-  const at2 = input.indexOf("@");
-  if (at2 < 0)
-    return { name: input };
-  return { name: input.slice(0, at2), version: input.slice(at2 + 1) };
+function parseName(input) {
+  if (!/^[a-z0-9_-]+\/[a-z0-9_-]+$/i.test(input))
+    return null;
+  const [creator, slug] = input.toLowerCase().split("/");
+  return { creator, slug };
 }
 async function runSkillPublish(cwd2, args) {
   banner("skill publish — send a skill to the registry");
-  const candidates = collectSkillCandidates(cwd2);
-  if (candidates.length === 0) {
-    f2.error("No skills found. Add one with `brainbase skill add <source>` or write one locally first.");
+  const skillDir = path40.resolve(cwd2, args.dir ?? ".");
+  if (!exists(skillDir) || !fs37.statSync(skillDir).isDirectory()) {
+    f2.error(`Not a directory: ${import_picocolors16.default.bold(skillDir)}`);
     return;
   }
-  let chosen;
-  let suggestedName;
-  let suggestedVersion;
-  if (args.ref) {
-    const { name: name2, version: version2 } = parseRef3(args.ref);
-    suggestedName = name2;
-    suggestedVersion = version2;
-    const slug = name2.split("/").pop();
-    const matches = candidates.filter((c2) => c2.slug === slug);
-    if (matches.length === 0) {
-      f2.error(`No local skill named ${import_picocolors16.default.bold(slug)} to publish.`);
-      return;
-    }
-    chosen = matches[0];
-  } else {
-    const pick = await ie({
-      message: "Which skill do you want to publish?",
-      options: candidates.map((c2, i) => ({
-        value: String(i),
-        label: `${import_picocolors16.default.bold(c2.slug.padEnd(24))} ${import_picocolors16.default.dim(c2.harness + "/" + c2.scope)}`
-      }))
-    });
-    chosen = candidates[Number(ensureNotCancelled(pick))];
+  if (!exists(path40.join(skillDir, "SKILL.md"))) {
+    f2.error(`No ${import_picocolors16.default.bold("SKILL.md")} in ${import_picocolors16.default.bold(skillDir)}. Point at a folder that contains one, or create the file first.`);
+    return;
   }
-  const existingMarker = readSkillMarker(chosen.dir);
+  const folderSlug = path40.basename(skillDir).toLowerCase();
+  const existingMarker = readSkillMarker(skillDir);
+  let suggestedName;
   if (existingMarker && existingMarker.source.type === "brainbase") {
-    suggestedName ??= `${existingMarker.source.creator}/${existingMarker.source.slug}`;
+    suggestedName = `${existingMarker.source.creator}/${existingMarker.source.slug}`;
+  }
+  if (existingMarker && (existingMarker.source.type === "github" || existingMarker.source.type === "git")) {
+    f2.warn(`This skill was installed from ${existingMarker.source.type}. Publishing will fork it under your name.`);
+  }
+  let name = args.name ?? suggestedName;
+  if (name && !parseName(name)) {
+    f2.error(`Invalid --name "${name}". Use creator/slug.`);
+    return;
   }
-  let name = suggestedName;
   if (!name) {
     const ans = await te({
       message: "Publish as (creator/slug)",
-      placeholder: `gokhan/${chosen.slug}`,
-      initialValue: `gokhan/${chosen.slug}`,
-      validate: (v3) => /^[a-z0-9_-]+\/[a-z0-9_-]+$/i.test(v3 ?? "") ? undefined : "Use creator/slug"
+      placeholder: `gokhan/${folderSlug}`,
+      initialValue: `gokhan/${folderSlug}`,
+      validate: (v3) => parseName(v3 ?? "") ? undefined : "Use creator/slug"
     });
     name = ensureNotCancelled(ans).toLowerCase();
   }
-  const [creator, pkgSlug] = name.toLowerCase().split("/");
-  let version = suggestedVersion;
+  const { creator, slug: pkgSlug } = parseName(name);
+  let version = args.version;
+  if (version && !/^\d+\.\d+\.\d+$/.test(version)) {
+    f2.error(`Invalid --skill-version "${version}". Use MAJOR.MINOR.PATCH.`);
+    return;
+  }
   if (!version) {
     const ans = await te({
       message: "Version",
@@ -50043,7 +50046,7 @@ async function runSkillPublish(cwd2, args) {
         owner_user_id: owner.type === "user" ? owner.userId : undefined,
         owner_team_id: owner.type === "team" ? owner.teamId : undefined,
         visibility,
-        description: readSkillDescription(chosen.dir)
+        description: readSkillDescription(skillDir)
       });
     } catch (err) {
       if (err instanceof ApiError && err.status === 409) {} else {
@@ -50055,20 +50058,20 @@ async function runSkillPublish(cwd2, args) {
   const tmp = fs37.mkdtempSync(path40.join(os9.tmpdir(), "bb-skill-pub-"));
   const tar = path40.join(tmp, "skill.tgz");
   try {
-    const files = collectSkillFiles(chosen.dir).filter((f4) => f4 !== SKILL_MARKER_FILE);
+    const files = collectSkillFiles(skillDir).filter((f4) => f4 !== SKILL_MARKER_FILE);
     if (files.length === 0) {
       f2.error("Skill folder is empty.");
       return;
     }
     const buildSp = de();
     buildSp.start("Building skill bundle…");
-    await pack({ rootDir: chosen.dir, outFile: tar, files });
+    await pack({ rootDir: skillDir, outFile: tar, files });
     const sha = await sha256OfFile(tar);
     const size = fs37.statSync(tar).size;
     buildSp.stop(`Bundle ready (${(size / 1024).toFixed(1)} KB).`);
     if (!args.yes) {
       const ok = await se({
-        message: `Publish ${import_picocolors16.default.bold(pkgSlug)}@${version} as ${import_picocolors16.default.bold(creator + "/" + pkgSlug)}?`,
+        message: `Publish ${import_picocolors16.default.bold(skillDir)} as ${import_picocolors16.default.bold(creator + "/" + pkgSlug)}@${version}?`,
         initialValue: true
       });
       if (!ensureNotCancelled(ok)) {
@@ -50076,12 +50079,13 @@ async function runSkillPublish(cwd2, args) {
         return;
       }
     }
-    const manifest = buildSkillManifest(chosen.dir, {
+    const sourceHarness = args.harness ?? "claude-code";
+    const manifest = buildSkillManifest(skillDir, {
       name: `${creator}/${pkgSlug}`,
       version,
-      description: readSkillDescription(chosen.dir),
-      sourceHarness: chosen.harness,
-      agents: [chosen.harness]
+      description: readSkillDescription(skillDir),
+      sourceHarness,
+      agents: args.harness ? [args.harness] : []
     });
     const upSp = de();
     upSp.start("Uploading…");
@@ -50092,7 +50096,7 @@ async function runSkillPublish(cwd2, args) {
         bundlePath: tar,
         bundleSha256: sha,
         version,
-        sourceHarness: chosen.harness
+        sourceHarness
       });
       upSp.stop("Uploaded.");
     } catch (err) {
@@ -50105,7 +50109,7 @@ async function runSkillPublish(cwd2, args) {
       slug: pkgSlug,
       version
     };
-    writeSkillMarker(chosen.dir, newSource);
+    writeSkillMarker(skillDir, newSource);
     $e(`${import_picocolors16.default.bold(creator + "/" + pkgSlug)}@${version} published.`);
     f2.info(import_picocolors16.default.dim(`id: ${result.id}`));
   } finally {
@@ -50114,30 +50118,6 @@ async function runSkillPublish(cwd2, args) {
     } catch {}
   }
 }
-function collectSkillCandidates(cwd2) {
-  const out = [];
-  const sources = [
-    { harness: "claude-code", scope: "global", root: scopePaths(cwd2, "global").skills },
-    { harness: "claude-code", scope: "project", root: scopePaths(cwd2, "project").skills },
-    { harness: "codex", scope: "global", root: scopePaths2(cwd2, "global").skills },
-    { harness: "codex", scope: "project", root: scopePaths2(cwd2, "project").skills }
-  ];
-  for (const s3 of sources) {
-    if (!exists(s3.root))
-      continue;
-    for (const slug of fs37.readdirSync(s3.root)) {
-      const dir = path40.join(s3.root, slug);
-      if (!exists(path40.join(dir, "SKILL.md")))
-        continue;
-      const marker = readSkillMarker(dir);
-      if (marker && (marker.source.type === "github" || marker.source.type === "git")) {
-        continue;
-      }
-      out.push({ harness: s3.harness, scope: s3.scope, slug, dir });
-    }
-  }
-  return out;
-}
 function collectSkillFiles(skillDir) {
   const out = [];
   function walk(dir, rel) {
@@ -50289,7 +50269,7 @@ async function runSkillSearch(args) {
 
 // src/cli/skill-info.ts
 var import_picocolors19 = __toESM(require_picocolors(), 1);
-function parseRef4(input) {
+function parseRef3(input) {
   const at2 = input.indexOf("@");
   if (at2 < 0)
     return { name: input };
@@ -50297,7 +50277,7 @@ function parseRef4(input) {
 }
 async function runSkillInfo(args) {
   banner(`skill info — ${import_picocolors19.default.bold(args.ref)}`);
-  const { name } = parseRef4(args.ref);
+  const { name } = parseRef3(args.ref);
   const [creator, slug] = name.split("/");
   if (!creator || !slug) {
     console.error("Invalid ref. Expected creator/slug.");
@@ -50395,8 +50375,11 @@ async function runSkill(cwd2, sub, rest, args) {
     }
     case "publish":
       await runSkillPublish(cwd2, {
-        ref: rest[0],
+        dir: rest[0],
+        name: args.name,
+        version: args.skillVersion,
         visibility: args.visibility,
+        harness: args.harness,
         yes: args.yes
       });
       return;
@@ -50424,7 +50407,7 @@ function printSkillHelp() {
   out.push(`  ${import_picocolors20.default.cyan("remove")} ${import_picocolors20.default.dim("<slug>")}              ${import_picocolors20.default.dim("uninstall a skill")}`);
   out.push(`  ${import_picocolors20.default.cyan("search")} ${import_picocolors20.default.dim("[query]")}             ${import_picocolors20.default.dim("search the brainbase skill registry")}`);
   out.push(`  ${import_picocolors20.default.cyan("info")} ${import_picocolors20.default.dim("<creator/slug>")}        ${import_picocolors20.default.dim("show registry details for a skill")}`);
-  out.push(`  ${import_picocolors20.default.cyan("publish")} ${import_picocolors20.default.dim("[creator/slug][@v]")} ${import_picocolors20.default.dim("publish a local skill to the registry")}`);
+  out.push(`  ${import_picocolors20.default.cyan("publish")} ${import_picocolors20.default.dim("[dir]")}                ${import_picocolors20.default.dim("publish the SKILL.md folder (defaults to .)")}`);
   out.push("");
   out.push(`  ${import_picocolors20.default.dim("Source forms accepted by `add`:")}`);
   out.push(`    ${import_picocolors20.default.dim("owner/repo                              github short-form")}`);
@@ -50440,6 +50423,8 @@ function printSkillHelp() {
   out.push(`  ${import_picocolors20.default.dim("--category <s>")}     for search`);
   out.push(`  ${import_picocolors20.default.dim("--agent <h>")}        for search (filter by harness)`);
   out.push(`  ${import_picocolors20.default.dim("--visibility <v>")}   for publish: public | unlisted | private`);
+  out.push(`  ${import_picocolors20.default.dim("--name <c/s>")}       for publish: creator/slug (skip prompt)`);
+  out.push(`  ${import_picocolors20.default.dim("--skill-version <v>")} for publish: MAJOR.MINOR.PATCH (skip prompt)`);
   out.push("");
   console.log(out.join(`
 `));
@@ -55033,7 +55018,7 @@ function help() {
   out.push(`  ${import_picocolors38.default.cyan("skill remove")} ${import_picocolors38.default.dim("<slug>")}                  ${import_picocolors38.default.dim("uninstall a skill")}`);
   out.push(`  ${import_picocolors38.default.cyan("skill search")} ${import_picocolors38.default.dim("[query]")}                 ${import_picocolors38.default.dim("search the brainbase skill registry")}`);
   out.push(`  ${import_picocolors38.default.cyan("skill info")} ${import_picocolors38.default.dim("<creator/slug>")}            ${import_picocolors38.default.dim("show registry details for a skill")}`);
-  out.push(`  ${import_picocolors38.default.cyan("skill publish")} ${import_picocolors38.default.dim("[creator/slug][@v]")}     ${import_picocolors38.default.dim("publish a local skill to the registry")}`);
+  out.push(`  ${import_picocolors38.default.cyan("skill publish")} ${import_picocolors38.default.dim("[dir]")}                  ${import_picocolors38.default.dim("publish a SKILL.md folder (defaults to .)")}`);
   out.push("");
   out.push(divider("CLI TOKENS"));
   out.push("");
@@ -55154,6 +55139,7 @@ async function main() {
   const noTracking = hasFlag2(argv, "--no-tracking");
   const graphOnlyFlag = hasFlag2(argv, "--graph-only");
   const nameFlag = getFlag(argv, "--name");
+  const skillVersionFlag = getFlag(argv, "--skill-version");
   const taglineFlag = getFlag(argv, "--tagline");
   const orgIdFlag = getFlag(argv, "--org");
   const teamIdFlag = getFlag(argv, "--team");
@@ -55197,7 +55183,9 @@ async function main() {
           as: asSlug,
           category,
           agent: agentFlag,
-          page
+          page,
+          name: nameFlag,
+          skillVersion: skillVersionFlag
         });
         break;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainbase-labs/cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   "type": "module",
   "bin": {