skild 0.2.6 → 0.2.8

package/dist/index.js

@@ -6,8 +6,10 @@ import chalk15 from "chalk";
 import { createRequire } from "module";
 
 // src/commands/install.ts
+import fs from "fs";
+import path from "path";
 import chalk2 from "chalk";
-import { fetchWithTimeout, installRegistrySkill, installSkill, loadRegistryAuth, resolveRegistryUrl, SkildError } from "@skild/core";
+import { fetchWithTimeout, installRegistrySkill, installSkill, loadRegistryAuth, resolveRegistryAlias, resolveRegistryUrl, SkildError } from "@skild/core";
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -70,17 +72,43 @@ var logger = {
 };
 
 // src/commands/install.ts
+function looksLikeAlias(input) {
+  const s = input.trim();
+  if (!s) return false;
+  if (s.startsWith("@")) return false;
+  if (s.includes("/") || s.includes("\\")) return false;
+  if (/^https?:\/\//i.test(s) || s.includes("github.com")) return false;
+  if (fs.existsSync(path.resolve(s))) return false;
+  if (s.length < 3 || s.length > 64) return false;
+  if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(s)) return false;
+  if (s.includes("--")) return false;
+  return true;
+}
 async function install(source, options = {}) {
   const platform = options.target || "claude";
   const scope = options.local ? "project" : "global";
   const auth = loadRegistryAuth();
   const registryUrlForDeps = options.registry || auth?.registryUrl;
+  let resolvedSource = source.trim();
+  try {
+    if (looksLikeAlias(resolvedSource)) {
+      const registryUrl = resolveRegistryUrl(registryUrlForDeps);
+      const resolved = await resolveRegistryAlias(registryUrl, resolvedSource);
+      if (!options.json) logger.info(`Resolved ${chalk2.cyan(resolvedSource)} \u2192 ${chalk2.cyan(resolved.spec)} (${resolved.type})`);
+      resolvedSource = resolved.spec;
+    }
+  } catch (error) {
+    const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk2.red(message));
+    process.exitCode = 1;
+    return;
+  }
   const spinner = createSpinner(`Installing ${chalk2.cyan(source)} to ${chalk2.dim(platform)} (${scope})...`);
   try {
-    const record = source.trim().startsWith("@") && source.includes("/") ? await installRegistrySkill(
-      { spec: source, registryUrl: registryUrlForDeps },
+    const record = resolvedSource.startsWith("@") && resolvedSource.includes("/") ? await installRegistrySkill(
+      { spec: resolvedSource, registryUrl: registryUrlForDeps },
       { platform, scope, force: Boolean(options.force) }
-    ) : await installSkill({ source }, { platform, scope, force: Boolean(options.force), registryUrl: registryUrlForDeps });
+    ) : await installSkill({ source: resolvedSource }, { platform, scope, force: Boolean(options.force), registryUrl: registryUrlForDeps });
     const displayName = record.canonicalName || record.name;
     spinner.succeed(`Installed ${chalk2.green(displayName)} to ${chalk2.dim(record.installDir)}`);
     if (options.json) {
@@ -138,54 +166,122 @@ async function reportDownload(record, registryOverride) {
 
 // src/commands/list.ts
 import chalk3 from "chalk";
-import fs from "fs";
-import path from "path";
 import { PLATFORMS, listAllSkills, listSkills } from "@skild/core";
-function toDisplayName(name, mapping) {
-  return mapping.get(name) || name;
+function isSkillset(skill) {
+  return Boolean(skill.record?.skillset || skill.record?.skill?.frontmatter?.skillset);
 }
-function buildDisplayEntries(skills) {
-  const nameToDisplay = /* @__PURE__ */ new Map();
-  for (const skill of skills) {
-    const displayName = skill.record?.canonicalName || skill.name;
-    nameToDisplay.set(skill.name, displayName);
-  }
-  const entries = skills.map((skill) => {
-    const displayName = toDisplayName(skill.name, nameToDisplay);
-    const flags = [];
-    if (skill.record?.skillset || skill.record?.skill?.frontmatter?.skillset) {
-      flags.push("skillset");
-    }
-    if (skill.record?.dependedBy?.length) {
-      const dependedBy = skill.record.dependedBy.map((name) => toDisplayName(name, nameToDisplay));
-      flags.push(`dep of: ${dependedBy.join(", ")}`);
-    }
-    return {
-      name: displayName,
-      installDir: skill.installDir,
-      status: skill.hasSkillMd ? "ok" : "warn",
-      flags
-    };
-  });
+function getDisplayName(skill) {
+  return skill.record?.canonicalName || skill.record?.skill?.frontmatter?.name || skill.name;
+}
+function buildNameToDisplay(skills) {
+  const mapping = /* @__PURE__ */ new Map();
   for (const skill of skills) {
-    const inlineDeps = skill.record?.installedDependencies?.filter((dep) => dep.sourceType === "inline") || [];
-    if (!inlineDeps.length) continue;
-    const ownerName = toDisplayName(skill.name, nameToDisplay);
-    for (const dep of inlineDeps) {
-      const inlineDir = dep.inlinePath ? path.join(skill.installDir, dep.inlinePath) : path.join(skill.installDir, dep.name);
-      const hasSkillMd = fs.existsSync(path.join(inlineDir, "SKILL.md"));
-      entries.push({
-        name: dep.name,
-        installDir: inlineDir,
-        status: hasSkillMd ? "ok" : "warn",
-        flags: [`dep of: ${ownerName}`]
-      });
+    mapping.set(skill.name, getDisplayName(skill));
+  }
+  return mapping;
+}
+function statusIcon(skill) {
+  return skill.hasSkillMd ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
+}
+function missingSkillMdLabel(skill) {
+  return skill.hasSkillMd ? "" : chalk3.yellow(" (missing SKILL.md)");
+}
+function formatDepName(dep, nameToDisplay) {
+  return dep.canonicalName || nameToDisplay.get(dep.name) || dep.name;
+}
+function summarizeDeps(record) {
+  const deps = record?.installedDependencies || [];
+  if (deps.length === 0) return null;
+  const byType = deps.reduce(
+    (acc, d) => {
+      acc.total += 1;
+      if (d.sourceType === "inline") acc.inline += 1;
+      else acc.external += 1;
+      acc.bySourceType[d.sourceType] = (acc.bySourceType[d.sourceType] || 0) + 1;
+      return acc;
+    },
+    { total: 0, inline: 0, external: 0, bySourceType: {} }
+  );
+  const parts = [];
+  if (byType.inline) parts.push(`${byType.inline} inline`);
+  const externalParts = Object.entries(byType.bySourceType).filter(([t]) => t !== "inline").sort(([a], [b]) => a.localeCompare(b)).map(([t, c2]) => `${c2} ${t}`);
+  if (externalParts.length) parts.push(...externalParts);
+  return `deps: ${byType.total}${parts.length ? ` (${parts.join(", ")})` : ""}`;
+}
+function printSkillsetSection(skills, nameToDisplay, options) {
+  console.log(chalk3.bold(`  Skillsets (${skills.length})`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("    (none)"));
+    return;
+  }
+  for (const s of skills) {
+    const label = `${chalk3.cyan(getDisplayName(s))}${chalk3.dim(" (skillset)")}${missingSkillMdLabel(s)}`;
+    console.log(`    ${statusIcon(s)} ${label}`);
+    const summary = summarizeDeps(s.record);
+    if (summary) console.log(chalk3.dim(`      ${summary}`));
+    if (options.verbose) {
+      const deps = (s.record?.installedDependencies || []).slice().sort((a, b) => a.name.localeCompare(b.name));
+      if (deps.length) {
+        console.log(chalk3.dim(`      includes (${deps.length}):`));
+        for (const dep of deps) {
+          const depName = formatDepName(dep, nameToDisplay);
+          console.log(chalk3.dim(`        - ${depName} [${dep.sourceType}]`));
+        }
+      }
     }
+    if (options.paths || !s.hasSkillMd) console.log(chalk3.dim(`      path: ${s.installDir}`));
+  }
+}
+function printSkillsSection(skills, options) {
+  console.log(chalk3.bold(`  Skills (${skills.length})`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("    (none)"));
+    return;
+  }
+  for (const s of skills) {
+    const label = `${chalk3.cyan(getDisplayName(s))}${missingSkillMdLabel(s)}`;
+    console.log(`    ${statusIcon(s)} ${label}`);
+    if (options.paths || !s.hasSkillMd) console.log(chalk3.dim(`      path: ${s.installDir}`));
+  }
+}
+function printDependenciesSection(skills, nameToDisplay, options) {
+  console.log(chalk3.bold(`  Dependencies (${skills.length})`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("    (none)"));
+    return;
+  }
+  for (const s of skills) {
+    const dependedBy = (s.record?.dependedBy || []).map((name) => nameToDisplay.get(name) || name).sort((a, b) => a.localeCompare(b));
+    const requiredBy = dependedBy.length ? chalk3.dim(`  \u2190 required by: ${dependedBy.join(", ")}`) : "";
+    const label = `${chalk3.cyan(getDisplayName(s))}${missingSkillMdLabel(s)}${requiredBy}`;
+    console.log(`    ${statusIcon(s)} ${label}`);
+    if (options.paths || !s.hasSkillMd) console.log(chalk3.dim(`      path: ${s.installDir}`));
   }
-  return entries;
+}
+function printPlatform(skills, platform, scope, options) {
+  console.log(chalk3.bold(`
+\u{1F4E6} Installed Skills \u2014 ${platform} (${scope})
+`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("  No skills installed."));
+    console.log(chalk3.dim(`  Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
+    return;
+  }
+  const nameToDisplay = buildNameToDisplay(skills);
+  const skillsets = skills.filter(isSkillset).sort((a, b) => getDisplayName(a).localeCompare(getDisplayName(b)));
+  const dependencies = skills.filter((s) => !isSkillset(s) && Boolean(s.record?.dependedBy?.length)).sort((a, b) => getDisplayName(a).localeCompare(getDisplayName(b)));
+  const regular = skills.filter((s) => !isSkillset(s) && !Boolean(s.record?.dependedBy?.length)).sort((a, b) => getDisplayName(a).localeCompare(getDisplayName(b)));
+  printSkillsetSection(skillsets, nameToDisplay, options);
+  console.log("");
+  printSkillsSection(regular, options);
+  console.log("");
+  printDependenciesSection(dependencies, nameToDisplay, options);
+  console.log("");
 }
 async function list(options = {}) {
   const scope = options.local ? "project" : "global";
+  const paths = Boolean(options.paths);
+  const verbose = Boolean(options.verbose);
   const platform = options.target;
   if (platform) {
     const skills = listSkills({ platform, scope });
@@ -193,22 +289,7 @@ async function list(options = {}) {
       console.log(JSON.stringify(skills, null, 2));
       return;
     }
-    if (skills.length === 0) {
-      console.log(chalk3.dim("No skills installed."));
-      console.log(chalk3.dim(`Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
-      return;
-    }
-    const entries = buildDisplayEntries(skills);
-    console.log(chalk3.bold(`
-\u{1F4E6} Installed Skills (${entries.length}) \u2014 ${platform} (${scope}):
-`));
-    for (const entry of entries) {
-      const status = entry.status === "ok" ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
-      const label = entry.flags.length ? `${entry.name} (${entry.flags.join("; ")})` : entry.name;
-      console.log(`  ${status} ${chalk3.cyan(label)}`);
-      console.log(chalk3.dim(`    \u2514\u2500 ${entry.installDir}`));
-    }
-    console.log("");
+    printPlatform(skills, platform, scope, { paths, verbose });
     return;
   }
   const allSkills = listAllSkills({ scope });
@@ -221,26 +302,11 @@ async function list(options = {}) {
     console.log(chalk3.dim(`Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
     return;
   }
-  console.log(chalk3.bold(`
-\u{1F4E6} Installed Skills \u2014 all platforms (${scope}):
-`));
   for (const p of PLATFORMS) {
     const platformSkills = allSkills.filter((s) => s.platform === p).sort((a, b) => a.name.localeCompare(b.name));
-    const entries = buildDisplayEntries(platformSkills);
-    const header = `${p} (${entries.length})`;
-    console.log(chalk3.bold(`  ${header}`));
-    if (entries.length === 0) {
-      console.log(chalk3.dim("    (none)"));
-      continue;
-    }
-    for (const entry of entries) {
-      const status = entry.status === "ok" ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
-      const label = entry.flags.length ? `${entry.name} (${entry.flags.join("; ")})` : entry.name;
-      console.log(`    ${status} ${chalk3.cyan(label)}`);
-      console.log(chalk3.dim(`      \u2514\u2500 ${entry.installDir}`));
-    }
+    if (platformSkills.length === 0) continue;
+    printPlatform(platformSkills, p, scope, { paths, verbose });
   }
-  console.log("");
 }
 
 // src/commands/info.ts
@@ -822,7 +888,7 @@ program.name("skild").description("The npm for Agent Skills \u2014 Discover, ins
 program.command("install <source>").alias("i").description("Install a Skill from a Git URL, degit shorthand, or local directory").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")}`, "claude").option("-l, --local", "Install to project-level directory instead of global").option("-f, --force", "Overwrite existing installation").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--json", "Output JSON").action(async (source, options) => {
   await install(source, options);
 });
-program.command("list").alias("ls").description("List installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")} (optional; omit to list all)`).option("-l, --local", "List project-level directory instead of global").option("--json", "Output JSON").action(async (options) => list(options));
+program.command("list").alias("ls").description("List installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")} (optional; omit to list all)`).option("-l, --local", "List project-level directory instead of global").option("--paths", "Show install paths").option("--verbose", "Show skillset dependency details").option("--json", "Output JSON").action(async (options) => list(options));
 program.command("info <skill>").description("Show installed Skill details").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (skill, options) => info(skill, options));
 program.command("uninstall <skill>").alias("rm").description("Uninstall a Skill").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("-f, --force", "Uninstall even if metadata is missing").option("--with-deps", "Uninstall dependencies that are only required by this skill").action(async (skill, options) => uninstall(skill, options));
 program.command("update [skill]").alias("up").description("Update one or all installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (skill, options) => update(skill, options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skild",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease.",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "commander": "^12.1.0",
     "ora": "^8.0.1",
     "tar": "^7.4.3",
-    "@skild/core": "^0.2.6"
+    "@skild/core": "^0.2.8"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",