@squadbase/vantage 0.2.1 → 0.2.2

package/README.md

@@ -7,7 +7,7 @@ You write `index.tsx`. Vantage owns routing, React, TanStack Query, Tailwind v4,
 the UI kit, the dev server, the optional API server, and the build. There is no
 config file.
 
-> **Status: prototype (v0.2.1).** APIs may still change between releases.
+> **Status: prototype (v0.2.2).** APIs may still change between releases.
 
 ## Install
 
@@ -100,9 +100,13 @@ npx vantage docs                  # every guide + component page, offline
 npx vantage docs button --json    # one page, machine-readable
 npx vantage search "date range"   # find the right component by meaning
 npx vantage add agents            # drop an AGENTS.md map into your project
+npx vantage add skill             # list the bundled skills and where they sit
 npx vantage add skill --all --dir .claude/skills   # install the Claude Code skills for Vantage
 ```
 
+`add skill` scans the project first, so skills that are already placed — wherever they live — are
+skipped with their location reported instead of copied a second time.
+
 `vantage upgrade` re-syncs `AGENTS.md` when you update the package.
 
 ## Documentation

package/dist/cli.js

@@ -147,30 +147,75 @@ function resolvePackageDir(root, sub) {
 function resolveRegistryDir(root) {
   return resolvePackageDir(root, "registry");
 }
+var SKILL_FILE = "SKILL.md";
+var SKILL_SCAN_SKIP = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".vantage",
+  "dist",
+  "build",
+  "out",
+  "coverage",
+  ".next",
+  ".turbo",
+  ".cache",
+  ".vercel"
+]);
+var SKILL_SCAN_DEPTH = 4;
 function listBundledSkills(skillsDir) {
   try {
-    return fs2.readdirSync(skillsDir, { withFileTypes: true }).filter((e) => e.isDirectory() && fs2.existsSync(path2.join(skillsDir, e.name, "SKILL.md"))).map((e) => e.name).sort();
+    return fs2.readdirSync(skillsDir, { withFileTypes: true }).filter((e) => e.isDirectory() && fs2.existsSync(path2.join(skillsDir, e.name, SKILL_FILE))).map((e) => e.name).sort();
   } catch {
     return [];
   }
 }
-function copySkill(root, skillsDir, name, force, destDir) {
-  const src = path2.join(skillsDir, name);
-  if (!fs2.existsSync(path2.join(src, "SKILL.md"))) {
-    const available = listBundledSkills(skillsDir);
-    log.error(`Unknown skill "${name}". Available: ${available.join(", ") || "(none)"}`);
-    return 1;
-  }
-  const dest = path2.join(destDir, name);
-  const rel2 = path2.relative(root, dest);
-  const label = !rel2 ? name : rel2.startsWith("..") ? dest : rel2;
-  if (fs2.existsSync(dest) && !force) {
-    log.error(`${label} already exists. Use --force to overwrite.`);
-    return 1;
-  }
+function displayPath(root, target) {
+  const rel2 = path2.relative(root, target);
+  return !rel2 ? "." : rel2.startsWith("..") ? target : rel2;
+}
+function findPlacedSkills(root, names, skillsDir) {
+  const wanted = new Set(names);
+  const found = /* @__PURE__ */ new Map();
+  const isSource = (p) => !path2.relative(skillsDir, p).startsWith("..");
+  const walk = (dir, depth) => {
+    let entries;
+    try {
+      entries = fs2.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory() || SKILL_SCAN_SKIP.has(entry.name)) continue;
+      const abs = path2.join(dir, entry.name);
+      if (wanted.has(entry.name) && fs2.existsSync(path2.join(abs, SKILL_FILE))) {
+        if (!isSource(abs)) found.set(entry.name, [...found.get(entry.name) ?? [], abs]);
+        continue;
+      }
+      if (depth < SKILL_SCAN_DEPTH) walk(abs, depth + 1);
+    }
+  };
+  walk(root, 1);
+  for (const list of found.values()) list.sort();
+  return found;
+}
+function writeSkill(root, skillsDir, name, dest, verb) {
   fs2.mkdirSync(path2.dirname(dest), { recursive: true });
-  fs2.cpSync(src, dest, { recursive: true, force: true });
-  log.ok(`Added skill ${label}/`);
+  fs2.cpSync(path2.join(skillsDir, name), dest, { recursive: true, force: true });
+  log.ok(`${verb} skill ${displayPath(root, dest)}/`);
+}
+function printSkillList(root, available, placed) {
+  const width = Math.max(...available.map((n) => n.length));
+  log.info("Bundled skills:");
+  for (const name of available) {
+    const where = placed.get(name);
+    const status = where?.length ? where.map((p) => displayPath(root, p) + "/").join(", ") : "not placed";
+    log.info(`  ${name.padEnd(width)}  ${status}`);
+  }
+  const missing = available.filter((n) => !placed.get(n)?.length);
+  if (missing.length) {
+    log.info("");
+    log.info("Place the missing ones with: vantage add skill --all [--dir <path>]");
+  }
   return 0;
 }
 function addSkill(root, name, all, force, dir) {
@@ -184,15 +229,34 @@ function addSkill(root, name, all, force, dir) {
     log.error("No skills are bundled with this version of Vantage.");
     return 1;
   }
-  const targets = all ? available : name ? [name] : [];
-  if (targets.length === 0) {
-    log.error(`Usage: vantage add skill <name>|--all. Available: ${available.join(", ")}`);
-    return 1;
-  }
+  const placed = findPlacedSkills(root, available, skillsDir);
+  if (!all && !name) return printSkillList(root, available, placed);
   const destDir = path2.resolve(root, dir ?? ".");
+  const targets = all ? available : [name];
   let failed = 0;
   for (const target of targets) {
-    if (copySkill(root, skillsDir, target, force, destDir) !== 0) failed++;
+    if (!available.includes(target)) {
+      log.error(`Unknown skill "${target}". Available: ${available.join(", ")}`);
+      failed++;
+      continue;
+    }
+    const existing = placed.get(target) ?? [];
+    if (existing.length > 0 && !force) {
+      const where = existing.map((p) => displayPath(root, p) + "/").join(", ");
+      log.info(`Skill ${target} is already placed at ${where} \u2014 skipped (--force to refresh).`);
+      continue;
+    }
+    const inDestDir = existing.filter((p) => path2.dirname(p) === destDir);
+    const refresh = dir === void 0 ? existing : inDestDir;
+    if (refresh.length > 0) {
+      for (const dest of refresh) writeSkill(root, skillsDir, target, dest, "Updated");
+      continue;
+    }
+    if (existing.length > 0) {
+      const where = existing.map((p) => displayPath(root, p) + "/").join(", ");
+      log.warn(`Skill ${target} is also placed at ${where} \u2014 left untouched.`);
+    }
+    writeSkill(root, skillsDir, target, path2.join(destDir, target), "Added");
   }
   return failed === 0 ? 0 : 1;
 }
@@ -1260,6 +1324,7 @@ ${pc3.bold("Commands")}
   check               Static verification (routes, boundaries, forbidden files)
   routes              Show page and API URL map
   add <kind> <name>   Scaffold a page | api | ui | block | skill | agents
+                      (add skill with no name lists the skills and where they sit)
   docs [name]         Show the bundled guide and component reference
   search <query>      Find components and docs by meaning, or by regex
   doctor              Environment and installation health checks
@@ -1275,7 +1340,7 @@ ${pc3.bold("Options")}
   --regex             Treat the query as a regular expression (search)
   --limit <n>         Max results (search, default: 10)
   --all               Add every bundled skill (add skill --all) | show every page (docs)
-  --dir <path>        Destination for skills (add skill, default: project root)
+  --dir <path>        Where to place skills when none is found (add skill, default: project root)
   -v, --version       Print version
   -h, --help          Print this help
 `;