@brainbase-labs/cli 0.3.0 → 0.4.1

package/dist/index.js

@@ -49586,6 +49586,77 @@ import path35 from "node:path";
 import os7 from "node:os";
 import fs32 from "node:fs";
 import { execFileSync } from "node:child_process";
+var SKIP_DIRS = new Set(["node_modules"]);
+function skillMdPath(dir) {
+  try {
+    const hit = fs32.readdirSync(dir, { withFileTypes: true }).find((e2) => e2.isFile() && e2.name.toLowerCase() === "skill.md");
+    return hit ? path35.join(dir, hit.name) : null;
+  } catch {
+    return null;
+  }
+}
+function hasSkillMd(dir) {
+  return skillMdPath(dir) !== null;
+}
+function declaredSkillName(dir) {
+  const md = skillMdPath(dir);
+  if (!md)
+    return null;
+  let text;
+  try {
+    text = fs32.readFileSync(md, "utf8");
+  } catch {
+    return null;
+  }
+  const fm = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
+  if (!fm)
+    return null;
+  const m3 = /^name:[ \t]*(.+?)[ \t]*$/m.exec(fm[1]);
+  if (!m3)
+    return null;
+  return m3[1].replace(/^['"]|['"]$/g, "").trim().toLowerCase() || null;
+}
+function findSkillDirs(root) {
+  const found = [];
+  const walk = (dir, depth) => {
+    if (hasSkillMd(dir))
+      found.push({ dir, depth });
+    let entries;
+    try {
+      entries = fs32.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const e2 of entries) {
+      if (!e2.isDirectory())
+        continue;
+      if (e2.name.startsWith(".") || SKIP_DIRS.has(e2.name))
+        continue;
+      walk(path35.join(dir, e2.name), depth + 1);
+    }
+  };
+  walk(root, 0);
+  return found.sort((a3, b4) => a3.depth - b4.depth).map((x3) => x3.dir);
+}
+function resolveSkillRoot(tmp, subpath) {
+  if (!subpath) {
+    if (hasSkillMd(tmp))
+      return tmp;
+    const skillDirs = findSkillDirs(tmp);
+    return skillDirs.length === 1 ? skillDirs[0] : tmp;
+  }
+  const literal = path35.join(tmp, subpath);
+  const literalIsDir = fs32.existsSync(literal) && fs32.statSync(literal).isDirectory();
+  if (literalIsDir && hasSkillMd(literal))
+    return literal;
+  const wanted = path35.basename(subpath).toLowerCase();
+  const byName = findSkillDirs(tmp).find((d3) => path35.basename(d3).toLowerCase() === wanted || declaredSkillName(d3) === wanted);
+  if (byName)
+    return byName;
+  if (literalIsDir)
+    return literal;
+  throw new Error(`Could not locate skill '${path35.basename(subpath)}' in repo: no ` + `'${subpath}' directory, and no skill (SKILL.md folder) whose name ` + `is '${path35.basename(subpath)}' was found anywhere in it.`);
+}
 function gitCloneSubpath(opts) {
   const tmp = fs32.mkdtempSync(path35.join(os7.tmpdir(), "bb-skill-"));
   try {
@@ -49600,14 +49671,7 @@ function gitCloneSubpath(opts) {
       const stderr = e2.stderr?.toString() ?? "";
       throw new Error(`git clone failed: ${stderr.trim() || e2.message}`.trim());
     }
-    const sourceRoot = opts.subpath ? path35.join(tmp, opts.subpath) : tmp;
-    if (!fs32.existsSync(sourceRoot)) {
-      throw new Error(`Path not found in repo: ${opts.subpath ?? "/"}`);
-    }
-    const stat = fs32.statSync(sourceRoot);
-    if (!stat.isDirectory()) {
-      throw new Error(`Source path is not a directory: ${opts.subpath}`);
-    }
+    const sourceRoot = resolveSkillRoot(tmp, opts.subpath);
     ensureDir(opts.destDir);
     copyDir(sourceRoot, opts.destDir);
   } finally {
@@ -49874,59 +49938,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",
@@ -49979,7 +50036,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 {
@@ -49991,20 +50048,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)) {
@@ -50012,12 +50069,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…");
@@ -50028,7 +50086,7 @@ async function runSkillPublish(cwd2, args) {
         bundlePath: tar,
         bundleSha256: sha,
         version,
-        sourceHarness: chosen.harness
+        sourceHarness
       });
       upSp.stop("Uploaded.");
     } catch (err) {
@@ -50041,7 +50099,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 {
@@ -50050,30 +50108,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) {
@@ -50225,7 +50259,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 };
@@ -50233,7 +50267,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.");
@@ -50331,8 +50365,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;
@@ -50360,7 +50397,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")}`);
@@ -50376,6 +50413,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(`
 `));
@@ -54969,7 +55008,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("");
@@ -55090,6 +55129,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");
@@ -55133,7 +55173,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.3.0",
+  "version": "0.4.1",
   "description": "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   "type": "module",
   "bin": {