@crustjs/skills 0.0.5 → 0.0.6

package/dist/index.js

@@ -1,844 +1,11 @@
 // @bun
-// src/agents.ts
-import { access } from "fs/promises";
-import { homedir } from "os";
-import { join } from "path";
-var ALL_AGENTS = ["claude-code", "opencode"];
-var AGENT_LABELS = {
-  "claude-code": "Claude Code",
-  opencode: "OpenCode"
-};
-function resolveAgentPath(agent, scope, name) {
-  const base = scope === "global" ? homedir() : process.cwd();
-  switch (agent) {
-    case "claude-code":
-      return join(base, ".claude", "skills", name);
-    case "opencode":
-      if (scope === "global") {
-        return join(base, ".config", "opencode", "skills", name);
-      }
-      return join(base, ".opencode", "skills", name);
-  }
-}
-async function detectInstalledAgents(home) {
-  const resolvedHome = home ?? homedir();
-  const detected = [];
-  for (const agent of ALL_AGENTS) {
-    const configDir = resolveAgentConfigDir(resolvedHome, agent);
-    const exists = await access(configDir).then(() => true).catch(() => false);
-    if (exists) {
-      detected.push(agent);
-    }
-  }
-  return detected;
-}
-function resolveAgentConfigDir(home, agent) {
-  switch (agent) {
-    case "claude-code":
-      return join(home, ".claude");
-    case "opencode":
-      return join(home, ".config", "opencode");
-  }
-}
-// src/errors.ts
-class SkillConflictError extends Error {
-  name = "SkillConflictError";
-  details;
-  constructor(details) {
-    const message = `Skill conflict for agent "${details.agent}": ` + `directory "${details.outputDir}" already exists but was not created by Crust ` + `(no crust.json found). Delete or rename the conflicting skill to resolve.`;
-    super(message);
-    this.details = details;
-  }
-}
-// src/generate.ts
-import { access as access2, mkdir, rm, writeFile } from "fs/promises";
-import { dirname, join as join3 } from "path";
-
-// src/manifest.ts
-function buildManifest(command) {
-  return buildNode(command, []);
-}
-function buildNode(command, parentPath) {
-  const name = normalizeName(command.meta.name);
-  const path = [...parentPath, name];
-  const args = normalizeArgs(command.args);
-  const flags = normalizeFlags(command.flags);
-  const children = normalizeChildren(command.subCommands, path);
-  return {
-    name,
-    path,
-    description: command.meta.description,
-    usage: command.meta.usage,
-    runnable: typeof command.run === "function",
-    args,
-    flags,
-    children
-  };
-}
-function normalizeName(raw) {
-  return raw.trim().toLowerCase();
-}
-function normalizeArgs(argsDef) {
-  if (!argsDef || argsDef.length === 0)
-    return [];
-  return argsDef.map(normalizeArg);
-}
-function normalizeArg(arg) {
-  const result = {
-    name: arg.name,
-    type: arg.type,
-    required: arg.required === true,
-    variadic: arg.variadic === true
-  };
-  if (arg.description !== undefined) {
-    result.description = arg.description;
-  }
-  if (arg.default !== undefined) {
-    result.default = serializeDefault(arg.default);
-  }
-  return result;
-}
-function normalizeFlags(flagsDef) {
-  if (!flagsDef)
-    return [];
-  const keys = Object.keys(flagsDef).sort();
-  return keys.map((key) => {
-    return normalizeFlag(key, flagsDef[key]);
-  });
-}
-function normalizeFlag(name, flag) {
-  const result = {
-    name,
-    type: flag.type,
-    required: flag.required === true,
-    multiple: flag.multiple === true,
-    aliases: normalizeAliases(flag.alias)
-  };
-  if (flag.description !== undefined) {
-    result.description = flag.description;
-  }
-  if (flag.default !== undefined) {
-    result.default = serializeDefault(flag.default);
-  }
-  return result;
-}
-function normalizeAliases(alias) {
-  if (alias === undefined)
-    return [];
-  if (typeof alias === "string")
-    return [alias];
-  return [...alias].sort();
-}
-function normalizeChildren(subCommands, parentPath) {
-  const keys = Object.keys(subCommands).sort();
-  return keys.map((key) => {
-    return buildNode(subCommands[key], parentPath);
-  });
-}
-function serializeDefault(value) {
-  if (Array.isArray(value)) {
-    return JSON.stringify(value);
-  }
-  return String(value);
-}
-
-// src/render.ts
-function escapeYaml(value) {
-  if (/[:#[\]{}&*!|>'"`,@?\\]|^\s|\s$|^---|[\n\r]/.test(value)) {
-    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\r/g, "\\r")}"`;
-  }
-  return value;
-}
-function escapeTableCell(value) {
-  return value.replace(/(?<!\\)\|/g, "\\|");
-}
-function renderSkill(manifest, meta) {
-  const files = [];
-  const allNodes = collectNodes(manifest);
-  files.push({
-    path: "SKILL.md",
-    content: renderSkillMd(manifest, meta)
-  });
-  files.push({
-    path: "command-index.md",
-    content: renderCommandIndex(manifest, allNodes)
-  });
-  for (const node of allNodes) {
-    const filePath = commandFilePath(node);
-    const content = node.children.length > 0 ? renderGroupCommand(node, manifest) : renderLeafCommand(node, manifest);
-    files.push({ path: filePath, content });
-  }
-  return files;
-}
-function collectNodes(root) {
-  const nodes = [root];
-  for (const child of root.children) {
-    nodes.push(...collectNodes(child));
-  }
-  return nodes;
-}
-function commandFilePath(node) {
-  if (node.path.length <= 1) {
-    return `commands/${node.name}.md`;
-  }
-  const segments = node.path.slice(1);
-  return `commands/${segments.join("/")}.md`;
-}
-function commandInvocation(node) {
-  return node.path.join(" ");
-}
-function relativePath(from, to) {
-  const fromParts = from.split("/").slice(0, -1);
-  const toParts = to.split("/");
-  let common = 0;
-  while (common < fromParts.length && common < toParts.length && fromParts[common] === toParts[common]) {
-    common++;
-  }
-  const ups = fromParts.length - common;
-  const remaining = toParts.slice(common);
-  if (ups === 0) {
-    return remaining.join("/");
-  }
-  const upSegments = Array.from({ length: ups }, () => "..");
-  return [...upSegments, ...remaining].join("/");
-}
-function renderSkillMd(manifest, meta) {
-  const lines = [];
-  lines.push("---");
-  lines.push(`name: ${escapeYaml(meta.name)}`);
-  lines.push(`description: ${escapeYaml(meta.description)}`);
-  if (meta.license) {
-    lines.push(`license: ${escapeYaml(meta.license)}`);
-  }
-  if (meta.compatibility) {
-    lines.push(`compatibility: ${escapeYaml(meta.compatibility)}`);
-  }
-  if (meta.disableModelInvocation) {
-    lines.push("disable-model-invocation: true");
-  }
-  if (meta.allowedTools) {
-    lines.push(`allowed-tools: ${escapeYaml(meta.allowedTools)}`);
-  }
-  lines.push("metadata:");
-  lines.push(`  version: "${meta.version}"`);
-  lines.push("---");
-  lines.push("");
-  lines.push(`# ${meta.name}`);
-  lines.push("");
-  if (manifest.description) {
-    lines.push(manifest.description);
-    lines.push("");
-  }
-  const cliName = meta.name.startsWith("use-") ? meta.name.slice(4) : meta.name;
-  lines.push(`Use this skill when working with \`${cliName}\` commands, or when you need help with \`${cliName}\` syntax, flags, or subcommands.`);
-  lines.push("");
-  lines.push("## Command Reference");
-  lines.push("");
-  lines.push(`For the full list of commands and their documentation paths, see [command-index.md](command-index.md). ` + "**Do not read all command files at once.** Instead:");
-  lines.push("");
-  lines.push("1. Check [command-index.md](command-index.md) to find the relevant command");
-  lines.push("2. Read only the specific file from the `commands/` directory that you need");
-  lines.push("");
-  if (manifest.children.length > 0) {
-    lines.push("## Available Commands");
-    lines.push("");
-    for (const child of manifest.children) {
-      const filePath = commandFilePath(child);
-      const desc = child.description ? ` - ${child.description}` : "";
-      lines.push(`- [\`${child.name}\`](${filePath})${desc}`);
-    }
-    lines.push("");
-  }
-  if (manifest.runnable) {
-    lines.push("## Usage");
-    lines.push("");
-    const rootFile = commandFilePath(manifest);
-    lines.push(`The root command is directly executable. See [${manifest.name}](${rootFile}) for usage details.`);
-    lines.push("");
-  }
-  return lines.join(`
-`);
-}
-function renderCommandIndex(_manifest, allNodes) {
-  const lines = [];
-  lines.push("# Command Index");
-  lines.push("");
-  lines.push("| Command | Type | Documentation |");
-  lines.push("| ------- | ---- | ------------- |");
-  for (const node of allNodes) {
-    const invocation = commandInvocation(node);
-    const filePath = commandFilePath(node);
-    const type = commandType(node);
-    lines.push(`| \`${invocation}\` | ${type} | [${filePath}](${filePath}) |`);
-  }
-  lines.push("");
-  return lines.join(`
-`);
-}
-function commandType(node) {
-  if (node.runnable && node.children.length > 0) {
-    return "runnable, group";
-  }
-  if (node.runnable) {
-    return "runnable";
-  }
-  return "group";
-}
-function renderLeafCommand(node, root) {
-  const lines = [];
-  const invocation = commandInvocation(node);
-  lines.push(`# \`${invocation}\``);
-  lines.push("");
-  if (node.description) {
-    lines.push(node.description);
-    lines.push("");
-  }
-  lines.push("## Usage");
-  lines.push("");
-  if (node.usage) {
-    lines.push("```");
-    lines.push(node.usage);
-    lines.push("```");
-  } else {
-    lines.push("```");
-    lines.push(buildUsageLine(node));
-    lines.push("```");
-  }
-  lines.push("");
-  if (node.args.length > 0) {
-    lines.push("## Arguments");
-    lines.push("");
-    lines.push(...renderArgsTable(node.args));
-    lines.push("");
-  }
-  if (node.flags.length > 0) {
-    lines.push("## Flags");
-    lines.push("");
-    lines.push(...renderFlagsTable(node.flags));
-    lines.push("");
-  }
-  lines.push(...renderNavigation(node, root));
-  return lines.join(`
-`);
-}
-function renderGroupCommand(node, root) {
-  const lines = [];
-  const invocation = commandInvocation(node);
-  const filePath = commandFilePath(node);
-  lines.push(`# \`${invocation}\``);
-  lines.push("");
-  if (node.description) {
-    lines.push(node.description);
-    lines.push("");
-  }
-  if (node.runnable) {
-    lines.push("## Usage");
-    lines.push("");
-    if (node.usage) {
-      lines.push("```");
-      lines.push(node.usage);
-      lines.push("```");
-    } else {
-      lines.push("```");
-      lines.push(buildUsageLine(node));
-      lines.push("```");
-    }
-    lines.push("");
-    if (node.args.length > 0) {
-      lines.push("## Arguments");
-      lines.push("");
-      lines.push(...renderArgsTable(node.args));
-      lines.push("");
-    }
-    if (node.flags.length > 0) {
-      lines.push("## Flags");
-      lines.push("");
-      lines.push(...renderFlagsTable(node.flags));
-      lines.push("");
-    }
-  }
-  lines.push("## Subcommands");
-  lines.push("");
-  for (const child of node.children) {
-    const childPath = commandFilePath(child);
-    const childRelative = relativePath(filePath, childPath);
-    const desc = child.description ? ` - ${child.description}` : "";
-    lines.push(`- [\`${child.name}\`](${childRelative})${desc}`);
-  }
-  lines.push("");
-  lines.push(...renderNavigation(node, root));
-  return lines.join(`
-`);
-}
-function buildUsageLine(node) {
-  const parts = [...node.path];
-  for (const arg of node.args) {
-    if (arg.variadic) {
-      parts.push(arg.required ? `<${arg.name}...>` : `[${arg.name}...]`);
-    } else {
-      parts.push(arg.required ? `<${arg.name}>` : `[${arg.name}]`);
-    }
-  }
-  if (node.flags.length > 0) {
-    parts.push("[options]");
-  }
-  return parts.join(" ");
-}
-function renderArgsTable(args) {
-  const lines = [];
-  lines.push("| Argument | Type | Required | Description |");
-  lines.push("| -------- | ---- | -------- | ----------- |");
-  for (const arg of args) {
-    const name = arg.variadic ? `${arg.name}...` : arg.name;
-    const required = arg.required ? "Yes" : "No";
-    const desc = escapeTableCell(formatArgDescription(arg));
-    lines.push(`| \`${name}\` | ${arg.type} | ${required} | ${desc} |`);
-  }
-  return lines;
-}
-function formatArgDescription(arg) {
-  const parts = [];
-  if (arg.description) {
-    parts.push(arg.description);
-  }
-  if (arg.default !== undefined) {
-    parts.push(`Default: \`${arg.default}\``);
-  }
-  return parts.join(". ") || "-";
-}
-function renderFlagsTable(flags) {
-  const lines = [];
-  lines.push("| Flag | Type | Required | Description |");
-  lines.push("| ---- | ---- | -------- | ----------- |");
-  for (const flag of flags) {
-    const name = formatFlagName(flag);
-    const required = flag.required ? "Yes" : "No";
-    const desc = escapeTableCell(formatFlagDescription(flag));
-    lines.push(`| ${name} | ${flag.type} | ${required} | ${desc} |`);
-  }
-  return lines;
-}
-function formatFlagName(flag) {
-  const parts = [`\`--${flag.name}\``];
-  for (const alias of flag.aliases) {
-    parts.push(`\`-${alias}\``);
-  }
-  return parts.join(", ");
-}
-function formatFlagDescription(flag) {
-  const parts = [];
-  if (flag.description) {
-    parts.push(flag.description);
-  }
-  if (flag.multiple) {
-    parts.push("Can be specified multiple times");
-  }
-  if (flag.default !== undefined) {
-    parts.push(`Default: \`${flag.default}\``);
-  }
-  return parts.join(". ") || "-";
-}
-function renderNavigation(node, root) {
-  const lines = [];
-  const filePath = commandFilePath(node);
-  lines.push("---");
-  lines.push("");
-  if (node.path.length > 1) {
-    const parentPath = node.path.slice(0, -1);
-    const parentNode = findNode(root, parentPath);
-    if (parentNode) {
-      const parentFile = commandFilePath(parentNode);
-      const parentRelative = relativePath(filePath, parentFile);
-      const parentInvocation = commandInvocation(parentNode);
-      lines.push(`Parent: [\`${parentInvocation}\`](${parentRelative})`);
-      lines.push("");
-    }
-  }
-  const indexRelative = relativePath(filePath, "command-index.md");
-  lines.push(`[Command Index](${indexRelative})`);
-  lines.push("");
-  return lines;
-}
-function findNode(root, path) {
-  if (arraysEqual(root.path, path)) {
-    return root;
-  }
-  for (const child of root.children) {
-    const found = findNode(child, path);
-    if (found)
-      return found;
-  }
-  return;
-}
-function arraysEqual(a, b) {
-  if (a.length !== b.length)
-    return false;
-  for (let i = 0;i < a.length; i++) {
-    if (a[i] !== b[i])
-      return false;
-  }
-  return true;
-}
-
-// src/version.ts
-import { readFile } from "fs/promises";
-import { join as join2 } from "path";
-var CRUST_MANIFEST = "crust.json";
-async function readInstalledVersion(dir) {
-  try {
-    const raw = await readFile(join2(dir, CRUST_MANIFEST), "utf-8");
-    const parsed = JSON.parse(raw);
-    if (typeof parsed === "object" && parsed !== null && "version" in parsed && typeof parsed.version === "string") {
-      return parsed.version;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-
-// src/generate.ts
-var SKILL_NAME_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
-function isValidSkillName(name) {
-  return name.length >= 1 && name.length <= 64 && SKILL_NAME_PATTERN.test(name);
-}
-function resolveSkillName(name) {
-  return name.startsWith("use-") ? name : `use-${name}`;
-}
-async function generateSkill(options) {
-  const {
-    command,
-    meta,
-    agents,
-    scope = "global",
-    clean = true,
-    force = false
-  } = options;
-  const resolvedName = resolveSkillName(meta.name);
-  if (!isValidSkillName(resolvedName)) {
-    throw new Error(`Invalid skill name "${resolvedName}": must be 1\u201364 lowercase ` + `alphanumeric characters and hyphens, no leading/trailing/consecutive ` + `hyphens. Pattern: ${SKILL_NAME_PATTERN.source}`);
-  }
-  const resolvedMeta = {
-    ...meta,
-    name: resolvedName
-  };
-  const manifest = buildManifest(command);
-  const renderedFiles = renderSkill(manifest, resolvedMeta);
-  const metadataFiles = renderDistributionMetadata(manifest, resolvedMeta);
-  const allFiles = [...renderedFiles, ...metadataFiles].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
-  const results = [];
-  for (const agent of agents) {
-    const outputDir = resolveAgentPath(agent, scope, resolvedMeta.name);
-    const installedVersion = await readInstalledVersion(outputDir);
-    if (installedVersion === null) {
-      const dirExists = await access2(outputDir).then(() => true).catch(() => false);
-      if (dirExists && !force) {
-        throw new SkillConflictError({ agent, outputDir });
-      }
-    }
-    const status = installedVersion === null ? "installed" : installedVersion === resolvedMeta.version ? "up-to-date" : "updated";
-    if (status === "up-to-date") {
-      results.push({
-        agent,
-        outputDir,
-        files: [],
-        status: "up-to-date"
-      });
-      continue;
-    }
-    const previousVersion = status === "updated" ? installedVersion ?? undefined : undefined;
-    if (clean) {
-      await cleanDirectory(outputDir);
-    }
-    await writeFiles(outputDir, allFiles);
-    results.push({
-      agent,
-      outputDir,
-      files: allFiles.map((f) => f.path),
-      status,
-      previousVersion
-    });
-  }
-  return { agents: results };
-}
-async function uninstallSkill(options) {
-  const { name, agents, scope = "global" } = options;
-  const resolvedName = resolveSkillName(name);
-  const results = [];
-  for (const agent of agents) {
-    const outputDir = resolveAgentPath(agent, scope, resolvedName);
-    const exists = await access2(outputDir).then(() => true).catch(() => false);
-    if (exists) {
-      await rm(outputDir, { recursive: true, force: true });
-      results.push({ agent, outputDir, status: "removed" });
-    } else {
-      results.push({ agent, outputDir, status: "not-found" });
-    }
-  }
-  return { agents: results };
-}
-async function skillStatus(options) {
-  const { name, agents, scope = "global" } = options;
-  const resolvedName = resolveSkillName(name);
-  const results = [];
-  for (const agent of agents) {
-    const outputDir = resolveAgentPath(agent, scope, resolvedName);
-    const version = await readInstalledVersion(outputDir);
-    results.push({
-      agent,
-      outputDir,
-      installed: version !== null,
-      version: version ?? undefined
-    });
-  }
-  return { agents: results };
-}
-function renderDistributionMetadata(manifest, meta) {
-  return [
-    {
-      path: CRUST_MANIFEST,
-      content: renderCrustJson(manifest, meta)
-    }
-  ];
-}
-function renderCrustJson(manifest, meta) {
-  const commands = collectCommandPaths(manifest);
-  const obj = {
-    name: meta.name,
-    description: meta.description,
-    version: meta.version,
-    entrypoint: "SKILL.md",
-    commands
-  };
-  return `${JSON.stringify(obj, null, "\t")}
-`;
-}
-function collectCommandPaths(node) {
-  const paths = [node.path.join(" ")];
-  for (const child of node.children) {
-    paths.push(...collectCommandPaths(child));
-  }
-  return paths;
-}
-async function cleanDirectory(dir) {
-  await rm(dir, { recursive: true, force: true });
-}
-async function writeFiles(baseDir, files) {
-  const dirs = new Set;
-  for (const file of files) {
-    const filePath = join3(baseDir, file.path);
-    const dir = dirname(filePath);
-    dirs.add(dir);
-  }
-  const sortedDirs = [...dirs].sort();
-  for (const dir of sortedDirs) {
-    await mkdir(dir, { recursive: true });
-  }
-  for (const file of files) {
-    const filePath = join3(baseDir, file.path);
-    await writeFile(filePath, file.content, "utf-8");
-  }
-}
-// src/plugin.ts
-import { defineCommand } from "@crustjs/core";
-import { confirm, multiselect, spinner } from "@crustjs/prompts";
-function deriveSkillMeta(command, version) {
-  return {
-    name: command.meta.name,
-    description: command.meta.description ?? "",
-    version
-  };
-}
-function skillPlugin(options) {
-  let rootCmd;
-  let skillCmd = null;
-  return {
-    name: "skills",
-    setup(context, actions) {
-      rootCmd = context.rootCommand;
-      if (options.command !== false) {
-        const name = typeof options.command === "string" ? options.command : "skill";
-        skillCmd = buildSkillCommand(rootCmd, options);
-        actions.addSubCommand(rootCmd, name, skillCmd);
-      }
-    },
-    async middleware(_context, next) {
-      if (skillCmd && _context.route?.command === skillCmd) {
-        await next();
-        return;
-      }
-      const agents = await detectInstalledAgents();
-      if (agents.length === 0) {
-        await next();
-        return;
-      }
-      const autoInstall = options.autoInstall ?? false;
-      const autoUpdate = options.autoUpdate ?? true;
-      const meta = deriveSkillMeta(rootCmd, options.version);
-      const status = await skillStatus({
-        name: meta.name,
-        agents,
-        scope: options.scope ?? "global"
-      });
-      const needsUpdate = status.agents.filter((a) => {
-        if (!a.installed)
-          return autoInstall;
-        if (a.version !== meta.version)
-          return autoUpdate;
-        return false;
-      });
-      if (needsUpdate.length > 0) {
-        try {
-          const result = await generateSkill({
-            command: rootCmd,
-            meta,
-            agents: needsUpdate.map((a) => a.agent),
-            scope: options.scope
-          });
-          const installedAgents = result.agents.filter((a) => a.status === "installed").map((a) => AGENT_LABELS[a.agent]);
-          const updatedAgents = result.agents.filter((a) => a.status === "updated").map((a) => AGENT_LABELS[a.agent]);
-          if (installedAgents.length > 0) {
-            if (options.command !== false) {
-              const manageCommand = `${rootCmd.meta.name} skill`;
-              console.log(`Auto-installed skill "${meta.name}" v${meta.version} for ${installedAgents.join(", ")}. Manage with \`${manageCommand}\`.`);
-            } else {
-              console.log(`Auto-installed skill "${meta.name}" v${meta.version} for ${installedAgents.join(", ")}.`);
-            }
-          }
-          if (updatedAgents.length > 0) {
-            console.log(`Updated skill "${meta.name}" to v${meta.version} for ${updatedAgents.join(", ")}.`);
-          }
-        } catch (err) {
-          if (err instanceof SkillConflictError) {
-            console.warn(`Skill conflict: "${err.details.outputDir}" already exists ` + `but was not created by ${meta.name}. Skipping auto-update. ` + `Delete or rename the conflicting skill to resolve.`);
-          } else {
-            throw err;
-          }
-        }
-      }
-      await next();
-    }
-  };
-}
-function buildSkillCommand(rootCmd, options) {
-  return defineCommand({
-    meta: {
-      name: "skill",
-      description: "Manage agent skill installations"
-    },
-    async run() {
-      const meta = deriveSkillMeta(rootCmd, options.version);
-      const scope = options.scope ?? "global";
-      const detectedAgents = await detectInstalledAgents();
-      if (detectedAgents.length === 0) {
-        console.log("No supported agents detected. Install Claude Code or OpenCode first.");
-        return;
-      }
-      const status = await skillStatus({
-        name: meta.name,
-        agents: detectedAgents,
-        scope
-      });
-      const installedAgents = [];
-      const choices = status.agents.map((entry) => {
-        const hint = entry.installed ? `v${entry.version} installed` : "not installed";
-        if (entry.installed) {
-          installedAgents.push(entry.agent);
-        }
-        return {
-          label: AGENT_LABELS[entry.agent],
-          value: entry.agent,
-          hint
-        };
-      });
-      const selected = await multiselect({
-        message: "Select agents to install skills for",
-        choices,
-        default: installedAgents,
-        required: false
-      });
-      const toInstall = selected.filter((agent) => !installedAgents.includes(agent));
-      const toUpdate = selected.filter((agent) => {
-        const entry = status.agents.find((a) => a.agent === agent);
-        return entry?.installed === true && entry.version !== meta.version;
-      });
-      const toUninstall = installedAgents.filter((agent) => !selected.includes(agent));
-      const agentsToGenerate = [...toInstall, ...toUpdate];
-      if (agentsToGenerate.length > 0) {
-        try {
-          const result = await spinner({
-            message: "Installing skills...",
-            task: async () => generateSkill({
-              command: rootCmd,
-              meta,
-              agents: agentsToGenerate,
-              scope
-            })
-          });
-          console.log(`
-Installed "${meta.name}" v${meta.version}`);
-          for (const r of result.agents) {
-            console.log(`  ${AGENT_LABELS[r.agent]} \u2192 ${r.outputDir}`);
-          }
-        } catch (err) {
-          if (err instanceof SkillConflictError) {
-            const overwrite = await confirm({
-              message: `"${err.details.outputDir}" already exists but was not ` + `created by Crust. Overwrite?`,
-              default: false
-            });
-            if (overwrite) {
-              const result = await spinner({
-                message: "Overwriting skill...",
-                task: async () => generateSkill({
-                  command: rootCmd,
-                  meta,
-                  agents: [err.details.agent],
-                  scope,
-                  force: true
-                })
-              });
-              console.log(`
-Installed "${meta.name}" v${meta.version}`);
-              for (const r of result.agents) {
-                console.log(`  ${AGENT_LABELS[r.agent]} \u2192 ${r.outputDir}`);
-              }
-            } else {
-              console.log(`
-Skipped ${AGENT_LABELS[err.details.agent]}`);
-            }
-          } else {
-            throw err;
-          }
-        }
-      }
-      if (toUninstall.length > 0) {
-        const result = await spinner({
-          message: "Removing skills...",
-          task: async () => uninstallSkill({
-            name: meta.name,
-            agents: toUninstall,
-            scope
-          })
-        });
-        const removed = result.agents.filter((a) => a.status === "removed").map((a) => AGENT_LABELS[a.agent]);
-        if (removed.length > 0) {
-          console.log(`
-Removed from ${removed.join(", ")}`);
-        }
-      }
-      if (agentsToGenerate.length === 0 && toUninstall.length === 0) {
-        console.log("No changes.");
-      }
-    }
-  });
-}
-export {
-  uninstallSkill,
-  skillStatus,
-  skillPlugin,
-  resolveSkillName,
-  isValidSkillName,
-  generateSkill,
-  detectInstalledAgents,
-  SkillConflictError
-};
+import{access as QO}from"fs/promises";import{homedir as y}from"os";import{join as I}from"path";var XO=["claude-code","opencode"],x={"claude-code":"Claude Code",opencode:"OpenCode"};function L(O,X,Q){let Z=X==="global"?y():process.cwd();switch(O){case"claude-code":return I(Z,".claude","skills",Q);case"opencode":if(X==="global")return I(Z,".config","opencode","skills",Q);return I(Z,".opencode","skills",Q)}}async function F(O){let X=O??y(),Q=[];for(let Z of XO){let H=ZO(X,Z);if(await QO(H).then(()=>!0).catch(()=>!1))Q.push(Z)}return Q}function ZO(O,X){switch(X){case"claude-code":return I(O,".claude");case"opencode":return I(O,".config","opencode")}}class j extends Error{name="SkillConflictError";details;constructor(O){let X=`Skill conflict for agent "${O.agent}": directory "${O.outputDir}" already exists but was not created by Crust (no crust.json found). Delete or rename the conflicting skill to resolve.`;super(X);this.details=O}}import{access as o,mkdir as wO,rm as s,writeFile as LO}from"fs/promises";import{dirname as FO,join as i}from"path";function v(O){return h(O,[])}function h(O,X){let Q=HO(O.meta.name),Z=[...X,Q],H=WO(O.args),W=JO(O.flags),$=qO(O.subCommands,Z);return{name:Q,path:Z,description:O.meta.description,usage:O.meta.usage,runnable:typeof O.run==="function",args:H,flags:W,children:$}}function HO(O){return O.trim().toLowerCase()}function WO(O){if(!O||O.length===0)return[];return O.map($O)}function $O(O){let X={name:O.name,type:O.type,required:O.required===!0,variadic:O.variadic===!0};if(O.description!==void 0)X.description=O.description;if(O.default!==void 0)X.default=u(O.default);return X}function JO(O){if(!O)return[];return Object.keys(O).sort().map((Q)=>{return KO(Q,O[Q])})}function KO(O,X){let Q={name:O,type:X.type,required:X.required===!0,multiple:X.multiple===!0,aliases:RO(X.alias)};if(X.description!==void 0)Q.description=X.description;if(X.default!==void 0)Q.default=u(X.default);return Q}function RO(O){if(O===void 0)return[];if(typeof O==="string")return[O];return[...O].sort()}function qO(O,X){return Object.keys(O).sort().map((Z)=>{return h(O[Z],X)})}function u(O){if(Array.isArray(O))return JSON.stringify(O);return String(O)}function _(O){if(/[:#[\]{}&*!|>'"`,@?\\]|^\s|\s$|^---|[\n\r]/.test(O))return`"${O.replace(/\\/g,"\\\\").replace(/"/g,"\\\"").replace(/\n/g,"\\n").replace(/\r/g,"\\r")}"`;return O}function p(O){return O.replace(/(?<!\\)\|/g,"\\|")}function f(O,X){let Q=[],Z=c(O);Q.push({path:"SKILL.md",content:YO(O,X)}),Q.push({path:"command-index.md",content:BO(O,Z)});for(let H of Z){let W=G(H),$=H.children.length>0?GO(H,O):xO(H,O);Q.push({path:W,content:$})}return Q}function c(O){let X=[O];for(let Q of O.children)X.push(...c(Q));return X}function G(O){if(O.path.length<=1)return`commands/${O.name}.md`;return`commands/${O.path.slice(1).join("/")}.md`}function E(O){return O.path.join(" ")}function D(O,X){let Q=O.split("/").slice(0,-1),Z=X.split("/"),H=0;while(H<Q.length&&H<Z.length&&Q[H]===Z[H])H++;let W=Q.length-H,$=Z.slice(H);if(W===0)return $.join("/");return[...Array.from({length:W},()=>".."),...$].join("/")}function YO(O,X){let Q=[];if(Q.push("---"),Q.push(`name: ${_(X.name)}`),Q.push(`description: ${_(X.description)}`),X.license)Q.push(`license: ${_(X.license)}`);if(X.compatibility)Q.push(`compatibility: ${_(X.compatibility)}`);if(X.disableModelInvocation)Q.push("disable-model-invocation: true");if(X.allowedTools)Q.push(`allowed-tools: ${_(X.allowedTools)}`);if(Q.push("metadata:"),Q.push(`  version: "${X.version}"`),Q.push("---"),Q.push(""),Q.push(`# ${X.name}`),Q.push(""),O.description)Q.push(O.description),Q.push("");let Z=X.name.startsWith("use-")?X.name.slice(4):X.name;if(Q.push(`Use this skill when working with \`${Z}\` commands, or when you need help with \`${Z}\` syntax, flags, or subcommands.`),Q.push(""),Q.push("## Command Reference"),Q.push(""),Q.push("For the full list of commands and their documentation paths, see [command-index.md](command-index.md). **Do not read all command files at once.** Instead:"),Q.push(""),Q.push("1. Check [command-index.md](command-index.md) to find the relevant command"),Q.push("2. Read only the specific file from the `commands/` directory that you need"),Q.push(""),O.children.length>0){Q.push("## Available Commands"),Q.push("");for(let H of O.children){let W=G(H),$=H.description?` - ${H.description}`:"";Q.push(`- [\`${H.name}\`](${W})${$}`)}Q.push("")}if(O.runnable){Q.push("## Usage"),Q.push("");let H=G(O);Q.push(`The root command is directly executable. See [${O.name}](${H}) for usage details.`),Q.push("")}return Q.join(`
+`)}function BO(O,X){let Q=[];Q.push("# Command Index"),Q.push(""),Q.push("| Command | Type | Documentation |"),Q.push("| ------- | ---- | ------------- |");for(let Z of X){let H=E(Z),W=G(Z),$=UO(Z);Q.push(`| \`${H}\` | ${$} | [${W}](${W}) |`)}return Q.push(""),Q.join(`
+`)}function UO(O){if(O.runnable&&O.children.length>0)return"runnable, group";if(O.runnable)return"runnable";return"group"}function xO(O,X){let Q=[],Z=E(O);if(Q.push(`# \`${Z}\``),Q.push(""),O.description)Q.push(O.description),Q.push("");if(Q.push("## Usage"),Q.push(""),O.usage)Q.push("```"),Q.push(O.usage),Q.push("```");else Q.push("```"),Q.push(g(O)),Q.push("```");if(Q.push(""),O.args.length>0)Q.push("## Arguments"),Q.push(""),Q.push(...m(O.args)),Q.push("");if(O.flags.length>0)Q.push("## Flags"),Q.push(""),Q.push(...d(O.flags)),Q.push("");return Q.push(...r(O,X)),Q.join(`
+`)}function GO(O,X){let Q=[],Z=E(O),H=G(O);if(Q.push(`# \`${Z}\``),Q.push(""),O.description)Q.push(O.description),Q.push("");if(O.runnable){if(Q.push("## Usage"),Q.push(""),O.usage)Q.push("```"),Q.push(O.usage),Q.push("```");else Q.push("```"),Q.push(g(O)),Q.push("```");if(Q.push(""),O.args.length>0)Q.push("## Arguments"),Q.push(""),Q.push(...m(O.args)),Q.push("");if(O.flags.length>0)Q.push("## Flags"),Q.push(""),Q.push(...d(O.flags)),Q.push("")}Q.push("## Subcommands"),Q.push("");for(let W of O.children){let $=G(W),q=D(H,$),R=W.description?` - ${W.description}`:"";Q.push(`- [\`${W.name}\`](${q})${R}`)}return Q.push(""),Q.push(...r(O,X)),Q.join(`
+`)}function g(O){let X=[...O.path];for(let Q of O.args)if(Q.variadic)X.push(Q.required?`<${Q.name}...>`:`[${Q.name}...]`);else X.push(Q.required?`<${Q.name}>`:`[${Q.name}]`);if(O.flags.length>0)X.push("[options]");return X.join(" ")}function m(O){let X=[];X.push("| Argument | Type | Required | Description |"),X.push("| -------- | ---- | -------- | ----------- |");for(let Q of O){let Z=Q.variadic?`${Q.name}...`:Q.name,H=Q.required?"Yes":"No",W=p(zO(Q));X.push(`| \`${Z}\` | ${Q.type} | ${H} | ${W} |`)}return X}function zO(O){let X=[];if(O.description)X.push(O.description);if(O.default!==void 0)X.push(`Default: \`${O.default}\``);return X.join(". ")||"-"}function d(O){let X=[];X.push("| Flag | Type | Required | Description |"),X.push("| ---- | ---- | -------- | ----------- |");for(let Q of O){let Z=VO(Q),H=Q.required?"Yes":"No",W=p(jO(Q));X.push(`| ${Z} | ${Q.type} | ${H} | ${W} |`)}return X}function VO(O){let X=[`\`--${O.name}\``];for(let Q of O.aliases)X.push(`\`-${Q}\``);return X.join(", ")}function jO(O){let X=[];if(O.description)X.push(O.description);if(O.multiple)X.push("Can be specified multiple times");if(O.default!==void 0)X.push(`Default: \`${O.default}\``);return X.join(". ")||"-"}function r(O,X){let Q=[],Z=G(O);if(Q.push("---"),Q.push(""),O.path.length>1){let W=O.path.slice(0,-1),$=l(X,W);if($){let q=G($),R=D(Z,q),z=E($);Q.push(`Parent: [\`${z}\`](${R})`),Q.push("")}}let H=D(Z,"command-index.md");return Q.push(`[Command Index](${H})`),Q.push(""),Q}function l(O,X){if(MO(O.path,X))return O;for(let Q of O.children){let Z=l(Q,X);if(Z)return Z}return}function MO(O,X){if(O.length!==X.length)return!1;for(let Q=0;Q<O.length;Q++)if(O[Q]!==X[Q])return!1;return!0}import{readFile as IO}from"fs/promises";import{join as _O}from"path";var P="crust.json";async function b(O){try{let X=await IO(_O(O,P),"utf-8"),Q=JSON.parse(X);if(typeof Q==="object"&&Q!==null&&"version"in Q&&typeof Q.version==="string")return Q.version;return null}catch{return null}}var t=/^[a-z0-9]+(-[a-z0-9]+)*$/;function n(O){return O.length>=1&&O.length<=64&&t.test(O)}function S(O){return O.startsWith("use-")?O:`use-${O}`}async function w(O){let{command:X,meta:Q,agents:Z,scope:H="global",clean:W=!0,force:$=!1}=O,q=S(Q.name);if(!n(q))throw Error(`Invalid skill name "${q}": must be 1\u201364 lowercase `+`alphanumeric characters and hyphens, no leading/trailing/consecutive hyphens. Pattern: ${t.source}`);let R={...Q,name:q},z=v(X),M=f(z,R),B=EO(z,R),U=[...M,...B].sort((J,Y)=>J.path<Y.path?-1:J.path>Y.path?1:0),K=[];for(let J of Z){let Y=L(J,H,R.name),V=await b(Y);if(V===null){if(await o(Y).then(()=>!0).catch(()=>!1)&&!$)throw new j({agent:J,outputDir:Y})}let T=V===null?"installed":V===R.version?"up-to-date":"updated";if(T==="up-to-date"){K.push({agent:J,outputDir:Y,files:[],status:"up-to-date"});continue}let OO=T==="updated"?V??void 0:void 0;if(W)await kO(Y);await TO(Y,U),K.push({agent:J,outputDir:Y,files:U.map((C)=>C.path),status:T,previousVersion:OO})}return{agents:K}}async function A(O){let{name:X,agents:Q,scope:Z="global"}=O,H=S(X),W=[];for(let $ of Q){let q=L($,Z,H);if(await o(q).then(()=>!0).catch(()=>!1))await s(q,{recursive:!0,force:!0}),W.push({agent:$,outputDir:q,status:"removed"});else W.push({agent:$,outputDir:q,status:"not-found"})}return{agents:W}}async function k(O){let{name:X,agents:Q,scope:Z="global"}=O,H=S(X),W=[];for(let $ of Q){let q=L($,Z,H),R=await b(q);W.push({agent:$,outputDir:q,installed:R!==null,version:R??void 0})}return{agents:W}}function EO(O,X){return[{path:P,content:SO(O,X)}]}function SO(O,X){let Q=a(O),Z={name:X.name,description:X.description,version:X.version,entrypoint:"SKILL.md",commands:Q};return`${JSON.stringify(Z,null,"\t")}
+`}function a(O){let X=[O.path.join(" ")];for(let Q of O.children)X.push(...a(Q));return X}async function kO(O){await s(O,{recursive:!0,force:!0})}async function TO(O,X){let Q=new Set;for(let H of X){let W=i(O,H.path),$=FO(W);Q.add($)}let Z=[...Q].sort();for(let H of Z)await wO(H,{recursive:!0});for(let H of X){let W=i(O,H.path);await LO(W,H.content,"utf-8")}}import{defineCommand as DO}from"@crustjs/core";import{confirm as PO,multiselect as bO,spinner as N}from"@crustjs/prompts";function e(O,X){return{name:O.meta.name,description:O.meta.description??"",version:X}}function AO(O){let X,Q=null;return{name:"skills",setup(Z,H){if(X=Z.rootCommand,O.command!==!1){let W=typeof O.command==="string"?O.command:"skill";Q=NO(X,O),H.addSubCommand(X,W,Q)}},async middleware(Z,H){if(Q&&Z.route?.command===Q){await H();return}let W=await F();if(W.length===0){await H();return}let $=O.autoInstall??!1,q=O.autoUpdate??!0,R=e(X,O.version),M=(await k({name:R.name,agents:W,scope:O.scope??"global"})).agents.filter((B)=>{if(!B.installed)return $;if(B.version!==R.version)return q;return!1});if(M.length>0)try{let B=await w({command:X,meta:R,agents:M.map((J)=>J.agent),scope:O.scope}),U=B.agents.filter((J)=>J.status==="installed").map((J)=>x[J.agent]),K=B.agents.filter((J)=>J.status==="updated").map((J)=>x[J.agent]);if(U.length>0)if(O.command!==!1){let J=`${X.meta.name} skill`;console.log(`Auto-installed skill "${R.name}" v${R.version} for ${U.join(", ")}. Manage with \`${J}\`.`)}else console.log(`Auto-installed skill "${R.name}" v${R.version} for ${U.join(", ")}.`);if(K.length>0)console.log(`Updated skill "${R.name}" to v${R.version} for ${K.join(", ")}.`)}catch(B){if(B instanceof j)console.warn(`Skill conflict: "${B.details.outputDir}" already exists but was not created by ${R.name}. Skipping auto-update. Delete or rename the conflicting skill to resolve.`);else throw B}await H()}}}function NO(O,X){return DO({meta:{name:"skill",description:"Manage agent skill installations"},async run(){let Q=e(O,X.version),Z=X.scope??"global",H=await F();if(H.length===0){console.log("No supported agents detected. Install Claude Code or OpenCode first.");return}let W=await k({name:Q.name,agents:H,scope:Z}),$=[],q=W.agents.map((K)=>{let J=K.installed?`v${K.version} installed`:"not installed";if(K.installed)$.push(K.agent);return{label:x[K.agent],value:K.agent,hint:J}}),R=await bO({message:"Select agents to install skills for",choices:q,default:$,required:!1}),z=R.filter((K)=>!$.includes(K)),M=R.filter((K)=>{let J=W.agents.find((Y)=>Y.agent===K);return J?.installed===!0&&J.version!==Q.version}),B=$.filter((K)=>!R.includes(K)),U=[...z,...M];if(U.length>0)try{let K=await N({message:"Installing skills...",task:async()=>w({command:O,meta:Q,agents:U,scope:Z})});console.log(`
+Installed "${Q.name}" v${Q.version}`);for(let J of K.agents)console.log(`  ${x[J.agent]} \u2192 ${J.outputDir}`)}catch(K){if(K instanceof j)if(await PO({message:`"${K.details.outputDir}" already exists but was not created by Crust. Overwrite?`,default:!1})){let Y=await N({message:"Overwriting skill...",task:async()=>w({command:O,meta:Q,agents:[K.details.agent],scope:Z,force:!0})});console.log(`
+Installed "${Q.name}" v${Q.version}`);for(let V of Y.agents)console.log(`  ${x[V.agent]} \u2192 ${V.outputDir}`)}else console.log(`
+Skipped ${x[K.details.agent]}`);else throw K}if(B.length>0){let J=(await N({message:"Removing skills...",task:async()=>A({name:Q.name,agents:B,scope:Z})})).agents.filter((Y)=>Y.status==="removed").map((Y)=>x[Y.agent]);if(J.length>0)console.log(`
+Removed from ${J.join(", ")}`)}if(U.length===0&&B.length===0)console.log("No changes.")}})}export{A as uninstallSkill,k as skillStatus,AO as skillPlugin,S as resolveSkillName,n as isValidSkillName,w as generateSkill,F as detectInstalledAgents,j as SkillConflictError};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crustjs/skills",
-	"version": "0.0.5",
+	"version": "0.0.6",
 	"description": "Agent skill generation from Crust command definitions",
 	"type": "module",
 	"license": "MIT",
@@ -43,13 +43,13 @@
 	},
 	"devDependencies": {
 		"@crustjs/config": "0.0.0",
-		"@crustjs/core": "0.0.8",
-		"@crustjs/prompts": "0.0.5",
+		"@crustjs/core": "0.0.9",
+		"@crustjs/prompts": "0.0.6",
 		"bunup": "^0.16.29"
 	},
 	"peerDependencies": {
-		"@crustjs/core": "0.0.8",
-		"@crustjs/prompts": "0.0.5",
+		"@crustjs/core": "0.0.9",
+		"@crustjs/prompts": "0.0.6",
 		"typescript": "^5"
 	}
 }