skild 0.2.7 → 0.2.9

package/dist/index.js

@@ -9,7 +9,7 @@ import { createRequire } from "module";
 import fs from "fs";
 import path from "path";
 import chalk2 from "chalk";
-import { fetchWithTimeout, installRegistrySkill, installSkill, loadRegistryAuth, resolveRegistryAlias, resolveRegistryUrl, SkildError } from "@skild/core";
+import { fetchWithTimeout, installRegistrySkill, installSkill, isValidAlias, loadRegistryAuth, resolveRegistryAlias, resolveRegistryUrl, SkildError } from "@skild/core";
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -57,10 +57,10 @@ var logger = {
   /**
    * Log a skill entry with status indicator.
    */
-  skillEntry: (name, path4, hasSkillMd) => {
+  skillEntry: (name, path3, hasSkillMd) => {
     const status = hasSkillMd ? chalk.green("\u2713") : chalk.yellow("\u26A0");
     console.log(`  ${status} ${chalk.cyan(name)}`);
-    console.log(chalk.dim(`    \u2514\u2500 ${path4}`));
+    console.log(chalk.dim(`    \u2514\u2500 ${path3}`));
   },
   /**
    * Log installation result details.
@@ -79,9 +79,7 @@ function looksLikeAlias(input) {
   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;
+  if (!isValidAlias(s)) return false;
   return true;
 }
 async function install(source, options = {}) {
@@ -166,54 +164,122 @@ async function reportDownload(record, registryOverride) {
 
 // src/commands/list.ts
 import chalk3 from "chalk";
-import fs2 from "fs";
-import path2 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 ? path2.join(skill.installDir, dep.inlinePath) : path2.join(skill.installDir, dep.name);
-      const hasSkillMd = fs2.existsSync(path2.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}`));
   }
-  return entries;
+}
+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}`));
+  }
+}
+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 });
@@ -221,22 +287,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 });
@@ -249,26 +300,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
@@ -664,13 +700,13 @@ async function whoami() {
 }
 
 // src/commands/publish.ts
-import fs3 from "fs";
+import fs2 from "fs";
 import os from "os";
-import path3 from "path";
+import path2 from "path";
 import crypto from "crypto";
 import * as tar from "tar";
 import chalk13 from "chalk";
-import { fetchWithTimeout as fetchWithTimeout5, loadRegistryAuth as loadRegistryAuth3, resolveRegistryUrl as resolveRegistryUrl5, SkildError as SkildError9, splitCanonicalName, validateSkillDir } from "@skild/core";
+import { assertValidAlias, fetchWithTimeout as fetchWithTimeout5, loadRegistryAuth as loadRegistryAuth3, normalizeAlias, resolveRegistryUrl as resolveRegistryUrl5, SkildError as SkildError9, splitCanonicalName, validateSkillDir } from "@skild/core";
 function sha256Hex(buf) {
   const h = crypto.createHash("sha256");
   h.update(buf);
@@ -689,7 +725,7 @@ async function publish(options = {}) {
     process.exitCode = 1;
     return;
   }
-  const dir = path3.resolve(options.dir || process.cwd());
+  const dir = path2.resolve(options.dir || process.cwd());
   const validation = validateSkillDir(dir);
   if (!validation.ok) {
     console.error(chalk13.red("Skill validation failed:"));
@@ -700,6 +736,7 @@ async function publish(options = {}) {
   const fm = validation.frontmatter;
   let name = (options.name || fm.name || "").trim();
   const version2 = (options.skillVersion || fm.version || "").trim();
+  const alias = normalizeAlias(options.alias);
   const description = (options.description || fm.description || "").trim();
   const tag = (options.tag || "latest").trim() || "latest";
   const targets = parseTargets(options.targets);
@@ -747,9 +784,19 @@ async function publish(options = {}) {
     process.exitCode = 1;
     return;
   }
+  if (alias) {
+    try {
+      assertValidAlias(alias);
+    } catch (error) {
+      const message = error instanceof SkildError9 ? error.message : error instanceof Error ? error.message : String(error);
+      console.error(chalk13.red(message));
+      process.exitCode = 1;
+      return;
+    }
+  }
   const spinner = createSpinner(`Publishing ${chalk13.cyan(`${name}@${version2}`)} to ${chalk13.dim(registry)}...`);
-  const tempDir = fs3.mkdtempSync(path3.join(os.tmpdir(), "skild-publish-"));
-  const tarballPath = path3.join(tempDir, "skill.tgz");
+  const tempDir = fs2.mkdtempSync(path2.join(os.tmpdir(), "skild-publish-"));
+  const tarballPath = path2.join(tempDir, "skill.tgz");
   try {
     await tar.c(
       {
@@ -761,7 +808,7 @@ async function publish(options = {}) {
       },
       ["."]
     );
-    const buf = fs3.readFileSync(tarballPath);
+    const buf = fs2.readFileSync(tarballPath);
     const integrity = sha256Hex(buf);
     const form = new FormData();
     form.set("version", version2);
@@ -788,11 +835,34 @@ async function publish(options = {}) {
       process.exitCode = 1;
       return;
     }
+    if (alias) {
+      spinner.text = `Publishing ${chalk13.cyan(`${name}@${version2}`)} \u2014 setting alias ${chalk13.cyan(alias)}...`;
+      const aliasRes = await fetchWithTimeout5(
+        `${registry}/publisher/skills/${encodeURIComponent(scope)}/${encodeURIComponent(skillName)}/alias`,
+        {
+          method: "POST",
+          headers: {
+            authorization: `Bearer ${token}`,
+            "content-type": "application/json"
+          },
+          body: JSON.stringify({ alias })
+        },
+        1e4
+      );
+      const aliasText = await aliasRes.text();
+      if (!aliasRes.ok) {
+        spinner.fail(`Failed to set alias (${aliasRes.status})`);
+        console.error(chalk13.red(aliasText));
+        process.exitCode = 1;
+        return;
+      }
+    }
     if (options.json) {
       console.log(text);
       return;
     }
-    spinner.succeed(`Published ${chalk13.green(`${name}@${version2}`)} (sha256:${integrity.slice(0, 12)}\u2026)`);
+    const suffix = alias ? ` (alias: ${chalk13.cyan(alias)})` : "";
+    spinner.succeed(`Published ${chalk13.green(`${name}@${version2}`)}${suffix} (sha256:${integrity.slice(0, 12)}\u2026)`);
     try {
       const parsed = JSON.parse(text);
       const warnings = Array.isArray(parsed.warnings) ? parsed.warnings.map(String).filter(Boolean) : [];
@@ -805,7 +875,7 @@ async function publish(options = {}) {
     console.error(chalk13.red(message));
     process.exitCode = 1;
   } finally {
-    fs3.rmSync(tempDir, { recursive: true, force: true });
+    fs2.rmSync(tempDir, { recursive: true, force: true });
   }
 }
 
@@ -850,7 +920,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));
@@ -860,7 +930,7 @@ program.command("signup").description("Create a publisher account in the registr
 program.command("login").description("Login to a registry and store an access token locally").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--handle-or-email <value>", "Handle or email (optional; will prompt)").option("--password <password>", "Password (optional; will prompt)").option("--token-name <name>", "Token label").option("--json", "Output JSON").action(async (options) => login(options));
 program.command("logout").description("Remove stored registry credentials").action(async () => logout());
 program.command("whoami").description("Show current registry identity").action(async () => whoami());
-program.command("publish").description("Publish a Skill directory to the registry (hosted tarball)").option("--dir <path>", "Skill directory (defaults to cwd)").option("--name <@publisher/skill>", "Override skill name (defaults to SKILL.md frontmatter)").option("--skill-version <semver>", "Override version (defaults to SKILL.md frontmatter)").option("--description <text>", "Override description (defaults to SKILL.md frontmatter)").option("--targets <list>", "Comma-separated target platforms metadata (optional)").option("--tag <tag>", "Dist-tag (default: latest)", "latest").option("--registry <url>", "Registry base URL (defaults to saved login)").option("--json", "Output JSON").action(async (options) => publish(options));
+program.command("publish").description("Publish a Skill directory to the registry (hosted tarball)").option("--dir <path>", "Skill directory (defaults to cwd)").option("--name <@publisher/skill>", "Override skill name (defaults to SKILL.md frontmatter)").option("--skill-version <semver>", "Override version (defaults to SKILL.md frontmatter)").option("--alias <alias>", "Optional short identifier (global unique) for `skild install <alias>`").option("--description <text>", "Override description (defaults to SKILL.md frontmatter)").option("--targets <list>", "Comma-separated target platforms metadata (optional)").option("--tag <tag>", "Dist-tag (default: latest)", "latest").option("--registry <url>", "Registry base URL (defaults to saved login)").option("--json", "Output JSON").action(async (options) => publish(options));
 program.command("search <query>").description("Search Skills in the registry").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--limit <n>", "Max results (default: 50)", "50").option("--json", "Output JSON").action(async (query, options) => search(query, options));
 program.action(() => {
   console.log(chalk15.bold("\n\u{1F6E1}\uFE0F skild \u2014 Get your agents skilled.\n"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skild",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "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.7"
+    "@skild/core": "^0.2.9"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",