bf-skills 1.2.0 → 1.3.1

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 // src/commands/install.ts
-import os2 from "os";
+import os3 from "os";
 import path4 from "path";
 import fs3 from "fs";
 import * as p from "@clack/prompts";
@@ -112,6 +112,7 @@ function discoverSkills(repoPath) {
 
 // src/lib/install.ts
 import fs2 from "fs";
+import os from "os";
 import path2 from "path";
 function copyDir(src, dest) {
   fs2.mkdirSync(dest, { recursive: true });
@@ -132,16 +133,27 @@ function removePath(p4) {
     fs2.rmSync(p4, { recursive: true, force: true });
   }
 }
-function installSkill(skillDir, skillName, agents, isGlobal) {
+function installSkill(skillDir, skillName, agents, isGlobal, mode = "symlink") {
   if (agents.length === 0) throw new Error("No install targets selected");
-  const resolvePath = (agent) => isGlobal ? path2.join(agent.globalPath, skillName) : path2.join(process.cwd(), agent.projectPath, skillName);
-  const primaryDest = resolvePath(agents[0]);
+  const resolveDest = (agent) => isGlobal ? path2.join(os.homedir(), agent.globalPath, skillName) : path2.join(process.cwd(), agent.projectPath, skillName);
+  if (mode === "copy") {
+    const installed2 = [];
+    for (const agent of agents) {
+      const dest = resolveDest(agent);
+      fs2.mkdirSync(path2.dirname(dest), { recursive: true });
+      removePath(dest);
+      copyDir(skillDir, dest);
+      installed2.push(dest);
+    }
+    return installed2;
+  }
+  const primaryDest = resolveDest(agents[0]);
   fs2.mkdirSync(path2.dirname(primaryDest), { recursive: true });
   removePath(primaryDest);
   copyDir(skillDir, primaryDest);
   const installed = [primaryDest];
   for (const agent of agents.slice(1)) {
-    const dest = resolvePath(agent);
+    const dest = resolveDest(agent);
     fs2.mkdirSync(path2.dirname(dest), { recursive: true });
     removePath(dest);
     const rel = path2.relative(path2.dirname(dest), primaryDest);
@@ -153,41 +165,41 @@ function installSkill(skillDir, skillName, agents, isGlobal) {
 function removeSkill(name, agents, isGlobal) {
   const removed = [];
   for (const agent of agents) {
-    const p4 = isGlobal ? path2.join(agent.globalPath, name) : path2.join(process.cwd(), agent.projectPath, name);
-    if (fs2.existsSync(p4)) {
-      fs2.rmSync(p4, { recursive: true, force: true });
-      removed.push(p4);
+    const dest = isGlobal ? path2.join(os.homedir(), agent.globalPath, name) : path2.join(process.cwd(), agent.projectPath, name);
+    if (fs2.existsSync(dest)) {
+      fs2.rmSync(dest, { recursive: true, force: true });
+      removed.push(dest);
     }
   }
   return removed;
 }
 function listInstalledSkills(agent, isGlobal) {
-  const basePath = isGlobal ? agent.globalPath : path2.join(process.cwd(), agent.projectPath);
+  const basePath = isGlobal ? path2.join(os.homedir(), agent.globalPath) : path2.join(process.cwd(), agent.projectPath);
   if (!fs2.existsSync(basePath)) return [];
   return fs2.readdirSync(basePath, { withFileTypes: true }).filter((e) => e.isDirectory() || e.isSymbolicLink()).map((e) => e.name);
 }
 
 // src/lib/agents.ts
-import os from "os";
+import os2 from "os";
 import path3 from "path";
 var AGENTS = [
   {
     id: "general",
     label: ".agents/skills  (general agents)",
     projectPath: ".agents/skills",
-    globalPath: path3.join(os.homedir(), ".agents", "skills")
+    globalPath: path3.join(os2.homedir(), ".agents", "skills")
   },
   {
     id: "claude-code",
     label: ".claude/skills  (Claude Code)",
     projectPath: ".claude/skills",
-    globalPath: path3.join(os.homedir(), ".claude", "skills")
+    globalPath: path3.join(os2.homedir(), ".claude", "skills")
   },
   {
     id: "root",
     label: "skills/  (root folder)",
     projectPath: "skills",
-    globalPath: path3.join(os.homedir(), "skills")
+    globalPath: path3.join(os2.homedir(), "skills")
   }
 ];
 var DEFAULT_AGENT_IDS = ["general", "claude-code"];
@@ -290,13 +302,66 @@ async function runInstall(source, opts) {
     }
     targetAgents = AGENTS.filter((a) => chosen.includes(a.id));
   }
+  let isGlobal = opts.global;
+  if (!opts.yes && !opts.agent) {
+    const scope = await p.select({
+      message: "Installation scope",
+      options: [
+        {
+          value: false,
+          label: pc.blue("Project"),
+          hint: "Install in current directory (committed with your project)"
+        },
+        {
+          value: true,
+          label: pc.blue("Global"),
+          hint: "Install in home directory (available across all projects)"
+        }
+      ],
+      initialValue: false
+    });
+    if (p.isCancel(scope)) {
+      p.cancel("Cancelled.");
+      process.exit(0);
+    }
+    isGlobal = scope;
+  }
+  let installMode = "symlink";
+  const uniqueDirs = new Set(
+    targetAgents.map(
+      (a) => isGlobal ? path4.join(os3.homedir(), a.globalPath) : path4.join(process.cwd(), a.projectPath)
+    )
+  );
+  if (!opts.yes && !opts.agent && uniqueDirs.size > 1) {
+    const modeChoice = await p.select({
+      message: "Installation method",
+      options: [
+        {
+          value: "symlink",
+          label: pc.blue("Symlink") + pc.dim(" (Recommended)"),
+          hint: "Single source of truth \u2014 secondary agents point to the primary copy"
+        },
+        {
+          value: "copy",
+          label: pc.blue("Copy to all agents"),
+          hint: "Independent copies for each agent \u2014 no shared state"
+        }
+      ],
+      initialValue: "symlink"
+    });
+    if (p.isCancel(modeChoice)) {
+      p.cancel("Cancelled.");
+      process.exit(0);
+    }
+    installMode = modeChoice;
+  }
   let repoPath;
   let tmpDir;
   const isLocal = !repoUrl.startsWith("http") && !repoUrl.startsWith("git@");
   if (isLocal) {
     repoPath = path4.resolve(repoUrl);
   } else {
-    tmpDir = fs3.mkdtempSync(path4.join(os2.tmpdir(), "bf-skills-"));
+    tmpDir = fs3.mkdtempSync(path4.join(os3.tmpdir(), "bf-skills-"));
     repoPath = tmpDir;
     const s = p.spinner();
     s.start("Fetching skills catalog...");
@@ -331,11 +396,11 @@ async function runInstall(source, opts) {
   } else if (opts.yes) {
     selectedSkills = allSkills;
   } else {
-    const selected = await p.autocompleteMultiselect({
-      message: `Pick skills to install  (${allSkills.length} available \u2014 type to search)`,
+    const selected = await p.multiselect({
+      message: `Pick skills to install  (${allSkills.length} available)`,
       options: allSkills.map((s) => ({
         value: s.name,
-        label: `${skillEmoji(s.name)}  ${pc.blue(s.name)}`,
+        label: `${skillEmoji(s.name)}  ${s.name}`,
         hint: s.description
       })),
       required: true
@@ -347,15 +412,21 @@ async function runInstall(source, opts) {
     }
     selectedSkills = allSkills.filter((s) => selected.includes(s.name));
   }
-  const targetLines = targetAgents.map((a) => {
-    const dest = opts.global ? a.globalPath : `./${a.projectPath}`;
-    return `  ${pc.dim("\u2192")} ${pc.bold(a.label)}  ${pc.dim(dest)}`;
+  const scopeLabel = isGlobal ? "Global (~/)" : "Project (./)";
+  const methodLabel = installMode === "symlink" ? "Symlink (primary copy + symlinks)" : "Copy (independent copies)";
+  const targetLines = targetAgents.map((a, i) => {
+    const dest = isGlobal ? path4.join("~", a.globalPath) : `./${a.projectPath}`;
+    const tag = installMode === "symlink" && i > 0 ? pc.dim(" \u2192 symlink") : "";
+    return `  ${pc.dim("\u2192")} ${pc.bold(a.label)}  ${pc.dim(dest)}${tag}`;
   });
   p.note(
     [
       `${pc.bold("Skills:")}`,
       ...selectedSkills.map((s) => `  ${skillEmoji(s.name)}  ${pc.blue(s.name)}  ${pc.dim(s.description)}`),
       "",
+      `${pc.bold("Scope:")}   ${scopeLabel}`,
+      `${pc.bold("Method:")}  ${methodLabel}`,
+      "",
       `${pc.bold("Install to:")}`,
       ...targetLines
     ].join("\n"),
@@ -378,10 +449,11 @@ async function runInstall(source, opts) {
   const installed = [];
   for (const skill of selectedSkills) {
     prog.advance(1, `Installing ${pc.cyan(skill.name)}...`);
-    const paths = installSkill(skill.dir, skill.name, targetAgents, opts.global);
+    const paths = installSkill(skill.dir, skill.name, targetAgents, isGlobal, installMode);
     installed.push(...paths.map((dest, i) => {
-      const rel = dest.startsWith(process.cwd()) ? "." + dest.slice(process.cwd().length) : dest.replace(os2.homedir(), "~");
-      return `${pc.cyan(skill.name)}  ${pc.dim("\u2192")}  ${rel}${i > 0 ? pc.dim(" (symlink)") : ""}`;
+      const rel = dest.startsWith(process.cwd()) ? "." + dest.slice(process.cwd().length) : dest.replace(os3.homedir(), "~");
+      const tag = installMode === "symlink" && i > 0 ? pc.dim(" (symlink)") : "";
+      return `${pc.cyan(skill.name)}  ${pc.dim("\u2192")}  ${rel}${tag}`;
     }));
   }
   prog.stop(`${selectedSkills.length} skill${selectedSkills.length === 1 ? "" : "s"} installed`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bf-skills",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "BF Skills installer — Building the Future of Business with AI",
   "type": "module",
   "engines": {