skill-tree 0.1.2 → 0.1.4

package/dist/cli/index.mjs

@@ -1,22 +1,21 @@
 #!/usr/bin/env node
 import {
-  FilesystemStorageAdapter,
+  CachedStorageAdapter,
   GitSyncAdapter,
   SkillBank,
   SkillGraphServer,
-  SkillTreeMcpServer,
   VERSION,
   createDefaultSyncConfig
-} from "../chunk-INKVOZXK.mjs";
+} from "../chunk-OYHYXKXO.mjs";
+import "../chunk-PDPN7FW7.mjs";
 
 // src/cli/index.ts
-import { Command as Command24 } from "commander";
+import { Command as Command36 } from "commander";
 
 // src/config/types.ts
 var DEFAULT_CONFIG = {
   storage: {
-    type: "sqlite",
-    path: "~/.skill-tree/skills.db"
+    path: "~/.skill-tree"
   },
   indexer: {
     sources: [],
@@ -46,7 +45,6 @@ import * as os from "os";
 var ENV_MAPPINGS = {
   GITHUB_TOKEN: "indexer.github_token",
   ANTHROPIC_API_KEY: "indexer.anthropic_key",
-  SKILL_TREE_STORAGE_TYPE: "storage.type",
   SKILL_TREE_STORAGE_PATH: "storage.path",
   SKILL_TREE_OUTPUT_FORMAT: "cli.output_format",
   SKILL_TREE_QUIET: "cli.quiet",
@@ -92,8 +90,8 @@ function substituteEnvVarsInObject(obj) {
   }
   return obj;
 }
-function setNestedProperty(obj, path6, value) {
-  const parts = path6.split(".");
+function setNestedProperty(obj, path7, value) {
+  const parts = path7.split(".");
   let current = obj;
   for (let i = 0; i < parts.length - 1; i++) {
     const part = parts[i];
@@ -252,8 +250,8 @@ var ConfigLoader = class {
   /**
    * Get a specific config value by path
    */
-  get(path6) {
-    const parts = path6.split(".");
+  get(path7) {
+    const parts = path7.split(".");
     let current = this.getConfig();
     for (const part of parts) {
       if (current === null || typeof current !== "object") {
@@ -281,8 +279,8 @@ var ConfigLoader = class {
 # Generated by skill-tree
 
 storage:
-  type: sqlite
-  path: ~/.skill-tree/skills.db
+  # Path to .skilltree directory (skills stored as files, SQLite cache auto-generated)
+  path: ~/.skill-tree
 
 indexer:
   # GitHub token for API access (or use GITHUB_TOKEN env var)
@@ -380,7 +378,6 @@ async function createSkillBankFromOptions(options) {
   ensureDir(skillPath);
   const skillBank = new SkillBank({
     storage: {
-      type: "filesystem",
       basePath: skillPath,
       openSkillsCompatible: true
     }
@@ -1889,7 +1886,7 @@ var IndexerService = class {
         if (skill.status !== "indexed" && !options?.force) continue;
         try {
           const converted = convertIndexerSkill(skill);
-          await this.skillBank.addSkill(converted.skill);
+          await this.skillBank.saveSkill(converted.skill);
           skillsAdded.push(converted.skill.id);
         } catch (err) {
           indexed.errors.push(`Failed to import ${skill.slug}: ${err.message}`);
@@ -1934,7 +1931,7 @@ var IndexerService = class {
       for (const skill of skills) {
         try {
           const converted = convertIndexerSkill(skill);
-          await this.skillBank.addSkill(converted.skill);
+          await this.skillBank.saveSkill(converted.skill);
           result.imported++;
           result.skills.push(converted.skill);
         } catch (err) {
@@ -2972,7 +2969,7 @@ var indexerCommand = new Command20("index").description("Skill indexer - discove
 import { Command as Command21 } from "commander";
 import * as fs7 from "fs";
 var configCommand = new Command21("config").description("View and manage configuration");
-configCommand.command("show").description("Show current configuration").option("--path <path>", "Path to specific config value (e.g., storage.type)").action((options) => {
+configCommand.command("show").description("Show current configuration").option("--path <path>", "Path to specific config value (e.g., storage.path)").action((options) => {
   const globalOpts = configCommand.parent?.opts() || {};
   const configPath = globalOpts.config;
   const loader = new ConfigLoader(configPath);
@@ -3061,15 +3058,9 @@ configCommand.command("validate").description("Validate configuration file").act
     const loader = new ConfigLoader(configPath);
     const config2 = loader.load();
     const errors = [];
-    if (!config2.storage.type) {
-      errors.push("storage.type is required");
-    }
     if (!config2.storage.path) {
       errors.push("storage.path is required");
     }
-    if (!["sqlite", "filesystem", "memory"].includes(config2.storage.type)) {
-      errors.push(`storage.type must be one of: sqlite, filesystem, memory`);
-    }
     if (config2.indexer.min_confidence < 0 || config2.indexer.min_confidence > 1) {
       errors.push("indexer.min_confidence must be between 0 and 1");
     }
@@ -3448,105 +3439,395 @@ function resolveCommand() {
   });
 }
 
-// src/cli/commands/mcp.ts
+// src/cli/commands/loadout/index.ts
+import { Command as Command35 } from "commander";
+
+// src/cli/commands/loadout/list.ts
 import { Command as Command23 } from "commander";
-import * as readline from "readline";
-var mcpCommand = new Command23("mcp").description("Start MCP server over stdio (JSON-RPC 2.0)").option("--agent-can-set-loadout", "Allow agent to set loadout via criteria", false).option("--max-expanded <n>", "Maximum number of expanded skills", "5").action(async (options, command) => {
-  const globalOpts = command.optsWithGlobals();
-  const skillPath = resolveSkillPath(globalOpts.path);
+
+// src/serving/state-persistence.ts
+import * as fs9 from "fs";
+import * as path6 from "path";
+var STATE_FILENAME = ".loadout-state.json";
+function loadState(skillPath) {
+  const filePath = path6.join(skillPath, STATE_FILENAME);
+  try {
+    const raw = fs9.readFileSync(filePath, "utf-8");
+    const data = JSON.parse(raw);
+    return {
+      available: new Map(data.available),
+      expanded: new Set(data.expanded),
+      pending: new Set(data.pending),
+      source: data.source,
+      updatedAt: new Date(data.updatedAt)
+    };
+  } catch {
+    return null;
+  }
+}
+function saveState(skillPath, state) {
+  const filePath = path6.join(skillPath, STATE_FILENAME);
+  const data = {
+    available: Array.from(state.available.entries()),
+    expanded: Array.from(state.expanded),
+    pending: Array.from(state.pending),
+    source: state.source,
+    updatedAt: state.updatedAt.toISOString()
+  };
+  fs9.writeFileSync(filePath, JSON.stringify(data, null, 2));
+}
+function clearState(skillPath) {
+  const filePath = path6.join(skillPath, STATE_FILENAME);
+  try {
+    fs9.unlinkSync(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/cli/utils/loadout-server.ts
+async function createLoadoutServer(options) {
+  const skillPath = resolveSkillPath(options.path);
   ensureDir(skillPath);
-  const storage = new FilesystemStorageAdapter({ basePath: skillPath });
+  const storage = new CachedStorageAdapter({ basePath: skillPath });
   await storage.initialize();
-  const graphServer = new SkillGraphServer(storage, {
-    agentCanModify: true,
-    agentCanSetLoadout: globalOpts.agentCanSetLoadout ?? false,
-    agentCanSwitchProfile: true,
-    requireApproval: false,
-    autoExpandOnUse: true,
+  const server = new SkillGraphServer(storage, {
     autoExpandRelated: false,
-    maxExpanded: parseInt(globalOpts.maxExpanded || "5", 10)
-  });
-  await graphServer.initialize();
-  const mcpServer = new SkillTreeMcpServer(graphServer, {
-    dynamicTools: false
+    maxExpanded: 10
   });
-  const rl = readline.createInterface({ input: process.stdin, terminal: false });
-  let buffer = "";
-  rl.on("line", async (line) => {
-    buffer += line;
-    let msg;
-    try {
-      msg = JSON.parse(buffer);
-      buffer = "";
-    } catch {
+  await server.initialize();
+  const persisted = loadState(skillPath);
+  if (persisted) {
+    server.restoreState(persisted);
+  }
+  return {
+    server,
+    skillPath,
+    save: () => saveState(skillPath, server.getState())
+  };
+}
+
+// src/cli/commands/loadout/list.ts
+var listSubcommand = new Command23("list").description("List skills in the current loadout").option("-f, --filter <filter>", "Filter: all, expanded, available, pending", "all").action(async (options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server } = await createLoadoutServer(globalOpts);
+    const view = server.agentListLoadout();
+    const filter = options.filter || "all";
+    if (globalOpts.json) {
+      const output = filter === "pending" ? { pending: view.pending } : filter === "expanded" ? { available: view.available.filter((s) => s.expanded), profiles: view.profiles } : filter === "available" ? { available: view.available.filter((s) => !s.expanded), profiles: view.profiles } : view;
+      console.log(JSON.stringify(output, null, 2));
       return;
     }
-    const { id, method, params } = msg;
-    try {
-      let result;
-      switch (method) {
-        case "initialize":
-          result = {
-            protocolVersion: "2024-11-05",
-            capabilities: { tools: {} },
-            serverInfo: mcpServer.getServerInfo()
-          };
-          break;
-        case "notifications/initialized":
-          return;
-        case "tools/list":
-          result = {
-            tools: mcpServer.getTools().map((t) => ({
-              name: t.name,
-              description: t.description,
-              inputSchema: t.inputSchema
-            }))
-          };
-          break;
-        case "tools/call": {
-          const { name, arguments: args } = params;
-          const toolResult = await mcpServer.executeTool(name, args || {});
-          result = {
-            content: [
-              {
-                type: "text",
-                text: JSON.stringify(toolResult, null, 2)
-              }
-            ],
-            isError: !toolResult.success
-          };
-          break;
+    let skills = view.available;
+    if (filter === "expanded") skills = skills.filter((s) => s.expanded);
+    if (filter === "available") skills = skills.filter((s) => !s.expanded);
+    if (filter === "pending") {
+      if (view.pending.length === 0) {
+        printInfo("No pending skill requests");
+      } else {
+        for (const id of view.pending) {
+          console.log(`  \u25CB ${id}`);
         }
-        case "ping":
-          result = {};
-          break;
-        default:
-          respond(id, null, { code: -32601, message: `Method not found: ${method}` });
-          return;
       }
-      respond(id, result);
-    } catch (err) {
-      respond(id, null, { code: -32603, message: String(err) });
+      return;
     }
-  });
-  function respond(id, result, error) {
-    if (id === void 0) return;
-    const response = { jsonrpc: "2.0", id };
-    if (error) {
-      response.error = error;
+    if (skills.length === 0) {
+      printInfo('Loadout is empty. Use "skill-tree loadout add" or "skill-tree loadout profile" to add skills.');
+      return;
+    }
+    for (const skill of skills) {
+      const state = skill.expanded ? "\u25B8" : "\xB7";
+      const tags = skill.tags.length > 0 ? ` [${skill.tags.join(", ")}]` : "";
+      console.log(`  ${state} ${skill.id} - ${skill.name}${tags}`);
+    }
+    if (!globalOpts.quiet) {
+      console.log();
+      printInfo(`${skills.length} skill(s) in loadout`);
+    }
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/search.ts
+import { Command as Command24 } from "commander";
+var searchSubcommand = new Command24("search").description("Search for skills to add to the loadout").argument("<query>", "Search query").option("-l, --limit <n>", "Maximum results", "10").action(async (query, options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server } = await createLoadoutServer(globalOpts);
+    const limit = parseInt(options.limit || "10", 10);
+    const results = await server.agentSearchSkills(query, limit);
+    if (globalOpts.json) {
+      console.log(JSON.stringify(results, null, 2));
+      return;
+    }
+    if (results.length === 0) {
+      printInfo(`No skills found matching "${query}"`);
+      return;
+    }
+    for (const skill of results) {
+      const tags = skill.tags.length > 0 ? ` [${skill.tags.join(", ")}]` : "";
+      console.log(`  ${skill.id} - ${skill.name}${tags}`);
+      console.log(`    ${skill.description}`);
+    }
+    if (!globalOpts.quiet) {
+      console.log();
+      printInfo(`${results.length} result(s)`);
+    }
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/add.ts
+import { Command as Command25 } from "commander";
+var addSubcommand = new Command25("add").description("Add skills to the loadout").argument("<ids...>", "Skill IDs to add").action(async (ids, _options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server, save } = await createLoadoutServer(globalOpts);
+    await server.addSkills(ids);
+    save();
+    if (globalOpts.json) {
+      console.log(JSON.stringify({ added: ids }));
+      return;
+    }
+    printSuccess(`Added ${ids.length} skill(s) to loadout`);
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/remove.ts
+import { Command as Command26 } from "commander";
+var removeSubcommand = new Command26("remove").description("Remove skills from the loadout").argument("<ids...>", "Skill IDs to remove").action(async (ids, _options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server, save } = await createLoadoutServer(globalOpts);
+    server.removeSkills(ids);
+    save();
+    if (globalOpts.json) {
+      console.log(JSON.stringify({ removed: ids }));
+      return;
+    }
+    printSuccess(`Removed ${ids.length} skill(s) from loadout`);
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/profile.ts
+import { Command as Command27 } from "commander";
+var profileSubcommand = new Command27("profile").description("Switch to a named skill profile").argument("[name]", "Profile name (e.g. debugging, security, code-review)").option("--list", "List available profiles").action(async (name, options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server, save } = await createLoadoutServer(globalOpts);
+    if (options.list || !name) {
+      const profiles = server.getProfiles();
+      if (globalOpts.json) {
+        console.log(JSON.stringify({ profiles }));
+        return;
+      }
+      printInfo("Available profiles:");
+      for (const p of profiles) {
+        console.log(`  ${p}`);
+      }
+      return;
+    }
+    await server.setLoadoutFromProfile(name);
+    save();
+    if (globalOpts.json) {
+      console.log(JSON.stringify(server.agentListLoadout()));
+      return;
+    }
+    const state = server.getState();
+    printSuccess(`Switched to "${name}" profile (${state.available.size} skills)`);
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/set.ts
+import { Command as Command28 } from "commander";
+var setSubcommand = new Command28("set").description("Set loadout from criteria (tags, task description, etc.)").option("--tags <tags>", "Comma-separated tags to match").option("--task <description>", "Task description for semantic matching").option("--max-skills <n>", "Maximum number of skills").action(async (options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server, save } = await createLoadoutServer(globalOpts);
+    const criteria = {};
+    if (options.tags) {
+      criteria.tags = options.tags.split(",").map((t) => t.trim());
+    }
+    if (options.task) {
+      criteria.taskDescription = options.task;
+    }
+    if (options.maxSkills) {
+      criteria.maxSkills = parseInt(options.maxSkills, 10);
+    }
+    await server.setLoadout(criteria);
+    save();
+    const state = server.getState();
+    if (globalOpts.json) {
+      console.log(JSON.stringify(server.agentListLoadout()));
+      return;
+    }
+    printSuccess(`Loadout set (${state.available.size} skills)`);
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/expand.ts
+import { Command as Command29 } from "commander";
+var expandSubcommand = new Command29("expand").description("Expand a skill to see its full content").argument("<id>", "Skill ID to expand").action(async (id, _options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server, save } = await createLoadoutServer(globalOpts);
+    const expanded = server.expandSkill(id);
+    if (!expanded) {
+      printError(`Skill "${id}" not found in loadout`);
+      process.exit(1);
+    }
+    save();
+    const skill = server.getState().available.get(id);
+    if (globalOpts.json) {
+      console.log(JSON.stringify(skill, null, 2));
+      return;
+    }
+    printSuccess(`Expanded "${id}"`);
+    console.log();
+    console.log(formatSkillDetail(skill));
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/collapse.ts
+import { Command as Command30 } from "commander";
+var collapseSubcommand = new Command30("collapse").description("Collapse an expanded skill back to summary").argument("<id>", "Skill ID to collapse").action(async (id, _options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server, save } = await createLoadoutServer(globalOpts);
+    const collapsed = server.collapseSkill(id);
+    if (!collapsed) {
+      printError(`Skill "${id}" is not expanded`);
+      process.exit(1);
+    }
+    save();
+    if (globalOpts.json) {
+      console.log(JSON.stringify({ collapsed: true }));
+      return;
+    }
+    printSuccess(`Collapsed "${id}"`);
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/use.ts
+import { Command as Command31 } from "commander";
+var useSubcommand = new Command31("use").description("Mark a skill as being used (auto-expands and records usage)").argument("<id>", "Skill ID to use").action(async (id, _options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server, save } = await createLoadoutServer(globalOpts);
+    server.recordUsage(id);
+    const expanded = server.expandSkill(id);
+    if (!expanded) {
+      printError(`Skill "${id}" not found in loadout`);
+      process.exit(1);
+    }
+    save();
+    const skill = server.getState().available.get(id);
+    if (globalOpts.json) {
+      console.log(JSON.stringify(skill, null, 2));
+      return;
+    }
+    printSuccess(`Using "${id}"`);
+    console.log();
+    console.log(formatSkillDetail(skill));
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/get.ts
+import { Command as Command32 } from "commander";
+var getSubcommand = new Command32("get").description("Get details about a skill in the loadout").argument("<id>", "Skill ID").action(async (id, _options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server } = await createLoadoutServer(globalOpts);
+    const state = server.getState();
+    const skill = state.available.get(id);
+    if (!skill) {
+      printError(`Skill "${id}" not found in loadout`);
+      process.exit(1);
+    }
+    if (globalOpts.json) {
+      console.log(JSON.stringify(skill, null, 2));
+      return;
+    }
+    console.log(formatSkillDetail(skill));
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/render.ts
+import { Command as Command33 } from "commander";
+var renderSubcommand = new Command33("render").description("Render the current loadout as a system prompt (XML or Markdown)").option("--format <format>", "Output format: xml or markdown", "xml").action(async (options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const { server } = await createLoadoutServer(globalOpts);
+    const state = server.getState();
+    if (state.available.size === 0) {
+      printInfo("Loadout is empty. Nothing to render.");
+      return;
+    }
+    const output = server.renderSystemPrompt();
+    console.log(output);
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/loadout/clear.ts
+import { Command as Command34 } from "commander";
+var clearSubcommand = new Command34("clear").description("Clear the current loadout state").action(async (_options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const skillPath = resolveSkillPath(globalOpts.path);
+    const cleared = clearState(skillPath);
+    if (globalOpts.json) {
+      console.log(JSON.stringify({ cleared }));
+      return;
+    }
+    if (cleared) {
+      printSuccess("Loadout state cleared");
     } else {
-      response.result = result;
+      printInfo("No loadout state to clear");
     }
-    process.stdout.write(JSON.stringify(response) + "\n");
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
   }
-  process.on("SIGTERM", () => {
-    mcpServer.dispose();
-    process.exit(0);
-  });
 });
 
+// src/cli/commands/loadout/index.ts
+var loadoutCommand = new Command35("loadout").description("Manage skill loadouts for agent sessions").addCommand(listSubcommand).addCommand(searchSubcommand).addCommand(addSubcommand).addCommand(removeSubcommand).addCommand(profileSubcommand).addCommand(setSubcommand).addCommand(expandSubcommand).addCommand(collapseSubcommand).addCommand(useSubcommand).addCommand(getSubcommand).addCommand(renderSubcommand).addCommand(clearSubcommand);
+
 // src/cli/index.ts
-var program = new Command24();
+var program = new Command36();
 var config = loadConfig();
 program.name("skill-tree").description("Management CLI for agent skills").version(VERSION).option("-p, --path <dir>", "Skills directory path", config.storage.path).option("-c, --config <file>", "Config file path", getConfigPath()).option("--json", "Output as JSON", config.cli.output_format === "json").option("-q, --quiet", "Suppress non-essential output", config.cli.quiet).option("--no-color", "Disable colored output", !config.cli.color);
 program.addCommand(listCommand);
@@ -3565,5 +3846,5 @@ program.addCommand(importCommand);
 program.addCommand(indexerCommand);
 program.addCommand(configCommand);
 program.addCommand(syncCommand2);
-program.addCommand(mcpCommand);
+program.addCommand(loadoutCommand);
 program.parse();