skilldb 0.5.0 → 0.6.0

package/README.md

@@ -12,13 +12,16 @@ Connect SkillDB directly to your AI coding tool via the Model Context Protocol:
 # Step 1: Install globally (one time)
 npm install -g skilldb
 
-# Step 2: Add to Claude Code
-claude mcp add skilldb -- skilldb-mcp
+# Step 2: Get your free API key at https://skilldb.dev/api-access
 
-# With API key (for full skill content)
-claude mcp add skilldb -- skilldb-mcp --api-key sk_live_xxx
+# Step 3: Add to Claude Code (with API key for full content)
+claude mcp add skilldb -- skilldb-mcp --api-key sk_live_YOUR_KEY
 ```
 
+> **⚠️ Without an API key**, you can search and browse skills (metadata only).
+> **With a free API key**, you get full skill content — the actual markdown instructions your agent uses.
+> Get your key in 30 seconds at [skilldb.dev/api-access](https://skilldb.dev/api-access).
+
 **Cursor** — add to `.cursor/mcp.json`:
 ```json
 {

package/dist/cli.js

@@ -57,7 +57,13 @@ var SkillDBClient = class {
     }
     return h;
   }
-  async request(endpoint, params) {
+  /** Make an authenticated request to any endpoint (used by MCP tools for private skills). */
+  async rawRequest(endpoint, init) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const headers = { ...this.headers(), ...init?.headers || {} };
+    return fetch(url, { ...init, headers });
+  }
+  async typedRequest(endpoint, params) {
     const url = new URL(`${this.baseUrl}${endpoint}`);
     if (params) {
       for (const [k, v] of Object.entries(params)) {
@@ -74,7 +80,7 @@ var SkillDBClient = class {
   }
   /** Search skills by keyword. */
   async search(query, options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       search: query,
       category: options?.category ?? "",
       pack: options?.pack ?? "",
@@ -86,7 +92,7 @@ var SkillDBClient = class {
   }
   /** List skills with optional filters and sorting. */
   async list(options) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       category: options?.category ?? "",
       pack: options?.pack ?? "",
       search: options?.search ?? "",
@@ -99,21 +105,21 @@ var SkillDBClient = class {
   /** Get a single skill by ID (e.g. "software-skills/code-review.md"). */
   async get(id) {
     const encoded = encodeURIComponent(id);
-    const res = await this.request(`/skills/${encoded}`, {
+    const res = await this.typedRequest(`/skills/${encoded}`, {
       include_content: "true"
     });
     return "skill" in res ? res.skill : res;
   }
   /** Batch retrieve multiple skills by IDs (max 50). */
   async batch(ids) {
-    return this.request("/skills", {
+    return this.typedRequest("/skills", {
       ids: ids.slice(0, 50).join(","),
       include_content: "true"
     });
   }
   /** Get search autocomplete suggestions. */
   async suggest(query) {
-    return this.request("/skills/suggest", { q: query });
+    return this.typedRequest("/skills/suggest", { q: query });
   }
   /** Validate that the configured API key works. */
   async validate() {
@@ -1760,6 +1766,178 @@ ${pc17.green(`${upToDate} up to date`)}` + (changed > 0 ? pc17.yellow(`, ${chang
   }
 }
 
+// src/commands/purge.ts
+import fs15 from "fs";
+import path15 from "path";
+import pc18 from "picocolors";
+import readline3 from "readline";
+var SKILLDB_DIR11 = ".skilldb";
+var SKILLS_DIR8 = "skills";
+var ACTIVE_DIR8 = "active";
+var SLIM_DIR2 = "slim";
+function prompt3(question) {
+  const rl = readline3.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+function getDirectorySize(dir) {
+  if (!fs15.existsSync(dir)) return 0;
+  let size = 0;
+  for (const entry of fs15.readdirSync(dir, { withFileTypes: true })) {
+    const full = path15.join(dir, entry.name);
+    if (entry.isDirectory()) size += getDirectorySize(full);
+    else size += fs15.statSync(full).size;
+  }
+  return size;
+}
+function collectAllSkills(dir) {
+  const skills = [];
+  if (!fs15.existsSync(dir)) return skills;
+  for (const pack of fs15.readdirSync(dir, { withFileTypes: true })) {
+    if (!pack.isDirectory()) continue;
+    for (const file of fs15.readdirSync(path15.join(dir, pack.name))) {
+      if (file.endsWith(".md")) skills.push(`${pack.name}/${file}`);
+    }
+  }
+  return skills;
+}
+function collectActivePacks(cwd) {
+  const activeDir = path15.join(cwd, SKILLDB_DIR11, ACTIVE_DIR8);
+  const packs = /* @__PURE__ */ new Set();
+  if (!fs15.existsSync(activeDir)) return packs;
+  for (const entry of fs15.readdirSync(activeDir, { withFileTypes: true })) {
+    if (entry.isDirectory()) packs.add(entry.name);
+  }
+  return packs;
+}
+async function purgeCommand(options) {
+  const cwd = process.cwd();
+  const skillsDir = path15.join(cwd, SKILLDB_DIR11, SKILLS_DIR8);
+  const activeDir = path15.join(cwd, SKILLDB_DIR11, ACTIVE_DIR8);
+  const slimDir = path15.join(cwd, SKILLDB_DIR11, SLIM_DIR2);
+  if (!fs15.existsSync(path15.join(cwd, SKILLDB_DIR11))) {
+    console.log(pc18.red('No .skilldb/ directory found. Run "skilldb init" first.'));
+    process.exit(1);
+  }
+  const allSkills = collectAllSkills(skillsDir);
+  const activePacks = collectActivePacks(cwd);
+  const activeSkills = /* @__PURE__ */ new Set();
+  if (fs15.existsSync(activeDir)) {
+    for (const pack of fs15.readdirSync(activeDir, { withFileTypes: true })) {
+      if (!pack.isDirectory()) continue;
+      for (const file of fs15.readdirSync(path15.join(activeDir, pack.name))) {
+        if (file.endsWith(".md")) activeSkills.add(`${pack.name}/${file}`);
+      }
+    }
+  }
+  const inactiveSkills = allSkills.filter((s) => !activeSkills.has(s));
+  const slimSkills = collectAllSkills(slimDir);
+  const totalSize = getDirectorySize(path15.join(cwd, SKILLDB_DIR11));
+  const skillsSize = getDirectorySize(skillsDir);
+  const slimSize = getDirectorySize(slimDir);
+  console.log(pc18.bold("\nSkillDB Purge\n"));
+  console.log(`  Total skills cached:  ${pc18.cyan(String(allSkills.length))}`);
+  console.log(`  Active skills:        ${pc18.green(String(activeSkills.size))}`);
+  console.log(`  Inactive skills:      ${pc18.yellow(String(inactiveSkills.length))}`);
+  console.log(`  Slim summaries:       ${pc18.dim(String(slimSkills.length))}`);
+  console.log(`  Total disk usage:     ${pc18.cyan((totalSize / 1024).toFixed(0) + " KB")}`);
+  console.log();
+  if (allSkills.length === 0 && slimSkills.length === 0) {
+    console.log(pc18.dim("Nothing to purge."));
+    return;
+  }
+  const stats = { skillsRemoved: 0, packsRemoved: 0, slimRemoved: 0, bytesFreed: 0, activeKept: activeSkills.size };
+  let toPurge = [];
+  let purgeSlim = options?.slim || options?.all || false;
+  if (options?.all) {
+    toPurge = [...allSkills];
+    purgeSlim = true;
+    console.log(pc18.red(`Will remove ALL ${allSkills.length} cached skills + ${slimSkills.length} slim summaries`));
+  } else if (options?.inactive) {
+    toPurge = inactiveSkills;
+    console.log(pc18.yellow(`Will remove ${inactiveSkills.length} inactive skills (keeping ${activeSkills.size} active)`));
+  } else {
+    toPurge = inactiveSkills;
+    purgeSlim = true;
+    console.log(pc18.yellow(`Will remove ${inactiveSkills.length} inactive skills + ${slimSkills.length} slim summaries`));
+    console.log(pc18.green(`  Keeping ${activeSkills.size} active skills`));
+  }
+  if (toPurge.length === 0 && !purgeSlim) {
+    console.log(pc18.dim("\nNothing to purge \u2014 all skills are active."));
+    return;
+  }
+  if (!options?.force && !options?.dryRun) {
+    const answer = await prompt3(`
+  Continue? (y/N) `);
+    if (answer.toLowerCase() !== "y") {
+      console.log(pc18.dim("Cancelled."));
+      return;
+    }
+  }
+  if (options?.dryRun) {
+    console.log(pc18.dim("\n  (Dry run \u2014 no files will be deleted)\n"));
+    for (const skill of toPurge.slice(0, 20)) {
+      console.log(pc18.dim(`  would remove: ${skill}`));
+    }
+    if (toPurge.length > 20) console.log(pc18.dim(`  ... and ${toPurge.length - 20} more`));
+    return;
+  }
+  const manifest = readManifest(cwd);
+  for (const skillId of toPurge) {
+    const [pack, file] = skillId.split("/");
+    const filePath = path15.join(skillsDir, pack, file);
+    if (fs15.existsSync(filePath)) {
+      stats.bytesFreed += fs15.statSync(filePath).size;
+      fs15.unlinkSync(filePath);
+      stats.skillsRemoved++;
+    }
+    if (manifest.installed[skillId]) {
+      delete manifest.installed[skillId];
+    }
+    const packDir = path15.join(skillsDir, pack);
+    if (fs15.existsSync(packDir) && fs15.readdirSync(packDir).length === 0) {
+      fs15.rmdirSync(packDir);
+      stats.packsRemoved++;
+    }
+  }
+  if (purgeSlim && fs15.existsSync(slimDir)) {
+    for (const pack of fs15.readdirSync(slimDir, { withFileTypes: true })) {
+      if (!pack.isDirectory()) continue;
+      const packPath = path15.join(slimDir, pack.name);
+      for (const file of fs15.readdirSync(packPath)) {
+        const filePath = path15.join(packPath, file);
+        stats.bytesFreed += fs15.statSync(filePath).size;
+        fs15.unlinkSync(filePath);
+        stats.slimRemoved++;
+      }
+      if (fs15.readdirSync(packPath).length === 0) fs15.rmdirSync(packPath);
+    }
+  }
+  if (options?.all && fs15.existsSync(activeDir)) {
+    for (const pack of fs15.readdirSync(activeDir, { withFileTypes: true })) {
+      if (!pack.isDirectory()) continue;
+      const packPath = path15.join(activeDir, pack.name);
+      for (const file of fs15.readdirSync(packPath)) {
+        fs15.unlinkSync(path15.join(packPath, file));
+      }
+      fs15.rmdirSync(packPath);
+    }
+    stats.activeKept = 0;
+  }
+  writeManifest(manifest, cwd);
+  console.log(pc18.green(`
+  \u2713 Purge complete`));
+  console.log(`    Skills removed:  ${stats.skillsRemoved}`);
+  console.log(`    Slim removed:    ${stats.slimRemoved}`);
+  console.log(`    Packs cleaned:   ${stats.packsRemoved}`);
+  console.log(`    Space freed:     ${(stats.bytesFreed / 1024).toFixed(0)} KB`);
+  console.log(`    Active kept:     ${stats.activeKept}`);
+}
+
 // src/cli.ts
 var program = new Command();
 program.name("skilldb").description("SkillDB CLI \u2014 discover, install, and manage AI agent skills").version("0.3.0");
@@ -1799,5 +1977,8 @@ program.command("stats").description("Show local statistics and coverage").actio
 program.command("diff [target]").description("Compare local skills with latest remote versions").action((target) => {
   diffCommand(target);
 });
+program.command("purge").description("Remove cached skills to free disk space").option("-a, --all", "Remove ALL cached skills (including active)").option("-i, --inactive", "Remove only inactive skills").option("-s, --slim", "Also remove slim summaries").option("-n, --dry-run", "Show what would be removed without deleting").option("-f, --force", "Skip confirmation prompt").action((opts) => {
+  purgeCommand(opts);
+});
 program.parse();
 //# sourceMappingURL=cli.js.map