@hasna/skills 0.1.71 → 0.1.72

package/bin/server.js

@@ -22940,7 +22940,7 @@ var init_dist_es9 = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.71",
+  version: "0.1.72",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -23032,6 +23032,7 @@ var package_default = {
     "@aws-sdk/client-ecs": "^3.1079.0",
     "@aws-sdk/client-s3": "^3.1079.0",
     "@hasna/events": "0.1.16",
+    "@hasna/paths": "0.1.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     chalk: "^5.3.0",
     commander: "^12.1.0",
@@ -33109,13 +33110,12 @@ import { mkdirSync as mkdirSync3 } from "fs";
 import { dirname as dirname5 } from "path";
 
 // src/server/database-url.ts
-import { isAbsolute, join as join3 } from "path";
+import { isAbsolute, join as join5 } from "path";
 import { fileURLToPath } from "url";
 
 // src/lib/config.ts
-import { existsSync, readFileSync as readFileSync2, writeFileSync, mkdirSync, copyFileSync, readdirSync, statSync } from "fs";
-import { join as join2, dirname as dirname2 } from "path";
-import { homedir as homedir2 } from "os";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync, mkdirSync, copyFileSync, readdirSync, statSync } from "fs";
+import { join as join4, dirname as dirname2 } from "path";
 
 // src/lib/retired-settings.ts
 var RETIRED_ENV_SUFFIXES = ["_STORAGE_MODE", "_DEPLOYMENT_MODE", "_CLOUD_MODE"];
@@ -33163,6 +33163,119 @@ function assertNoRetiredConfigKeys(config, source) {
   }
 }
 
+// src/lib/app-home.ts
+import { existsSync } from "fs";
+import { homedir as homedir3 } from "os";
+import { join as join3, resolve } from "path";
+
+// ../../node_modules/.bun/@hasna+paths@0.1.0/node_modules/@hasna/paths/dist/index.js
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+var KIND_ENV = {
+  config: "HASNA_CONFIG_HOME",
+  data: "HASNA_DATA_HOME",
+  state: "HASNA_STATE_HOME",
+  cache: "HASNA_CACHE_HOME"
+};
+var APP_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function assertApp(app) {
+  if (typeof app !== "string" || app.length === 0) {
+    throw new TypeError("paths: app must be a non-empty string");
+  }
+  if (!APP_SLUG_RE.test(app)) {
+    throw new TypeError(`paths: invalid app slug "${app}" \u2014 expected lowercase kebab-case ([a-z0-9]+(-[a-z0-9]+)*)`);
+  }
+}
+function envOf(options) {
+  return options.env ?? process.env;
+}
+function envValue(options, kind) {
+  const value = envOf(options)[KIND_ENV[kind]];
+  return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function isMacOS(platform) {
+  return platform === "darwin";
+}
+function baseDir(kind, options) {
+  const override = envValue(options, kind);
+  if (override)
+    return override;
+  const home = options.home ?? homedir2();
+  const platform = options.platform ?? process.platform;
+  if (isMacOS(platform)) {
+    switch (kind) {
+      case "config":
+      case "data":
+        return join2(home, "Library", "Application Support", "Hasna");
+      case "cache":
+        return join2(home, "Library", "Caches", "Hasna");
+      case "state":
+        return join2(home, "Library", "Logs", "Hasna");
+    }
+  }
+  switch (kind) {
+    case "config":
+      return join2(home, ".config", "hasna");
+    case "data":
+      return join2(home, ".local", "share", "hasna");
+    case "state":
+      return join2(home, ".local", "state", "hasna");
+    case "cache":
+      return join2(home, ".cache", "hasna");
+  }
+}
+function resolvePath(kind, options) {
+  assertApp(options.app);
+  const appSegment = options.internal === true ? join2("internal", options.app) : options.app;
+  return join2(baseDir(kind, options), appSegment);
+}
+function dataDir(options) {
+  return resolvePath("data", options);
+}
+
+// src/lib/app-home.ts
+var DATA_DIR_ENV = "HASNA_SKILLS_DIR";
+var HASNA_SKILLS_HOME_ENV = "HASNA_SKILLS_HOME";
+var SKILLS_HOME_ENV = "SKILLS_HOME";
+var DEFAULT_SQLITE_FILENAME = "server.db";
+var GLOBAL_CONFIG_FILENAME = "config.json";
+function effectiveHome() {
+  return process.env["HOME"] || process.env["USERPROFILE"] || homedir3() || "/tmp";
+}
+function legacyDataRoot() {
+  return join3(effectiveHome(), ".hasna", "skills");
+}
+function resolverDataRoot(home = effectiveHome()) {
+  return dataDir({ app: "skills", home });
+}
+function adoptResolverDataRoot(resolved, env = process.env) {
+  const dataOverride = env.HASNA_DATA_HOME;
+  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
+    return true;
+  return existsSync(join3(resolved, DEFAULT_SQLITE_FILENAME)) || existsSync(join3(resolved, GLOBAL_CONFIG_FILENAME));
+}
+function exactDataRoot() {
+  for (const key of [DATA_DIR_ENV, HASNA_SKILLS_HOME_ENV, SKILLS_HOME_ENV]) {
+    const dir = process.env[key]?.trim();
+    if (dir)
+      return resolve(dir);
+  }
+  return;
+}
+function hasExactOverride(env = process.env) {
+  return Boolean(env[DATA_DIR_ENV]?.trim()) || Boolean(env[HASNA_SKILLS_HOME_ENV]?.trim()) || Boolean(env[SKILLS_HOME_ENV]?.trim());
+}
+function hasOperatorOverride(env = process.env) {
+  return hasExactOverride(env) || Boolean(env.HASNA_DATA_HOME?.trim());
+}
+function getDataRoot() {
+  const exact = exactDataRoot();
+  if (exact)
+    return exact;
+  const resolved = resolverDataRoot();
+  return adoptResolverDataRoot(resolved) ? resolve(resolved) : resolve(legacyDataRoot());
+}
+
 // src/lib/config.ts
 var ENUM_KEYS = {
   defaultAgent: ["claude", "codex", "gemini", "pi", "opencode", "all"],
@@ -33177,19 +33290,19 @@ function allowedValues(key) {
   return ENUM_KEYS[key];
 }
 function mergeDirectoryContents(sourceDir, targetDir) {
-  if (!existsSync(sourceDir))
+  if (!existsSync2(sourceDir))
     return;
   mkdirSync(targetDir, { recursive: true });
   for (const entry of readdirSync(sourceDir)) {
-    const sourcePath = join2(sourceDir, entry);
-    const targetPath = join2(targetDir, entry);
+    const sourcePath = join4(sourceDir, entry);
+    const targetPath = join4(targetDir, entry);
     try {
       const sourceStat = statSync(sourcePath);
       if (sourceStat.isDirectory()) {
         mergeDirectoryContents(sourcePath, targetPath);
         continue;
       }
-      if (!existsSync(targetPath))
+      if (!existsSync2(targetPath))
         copyFileSync(sourcePath, targetPath);
     } catch {}
   }
@@ -33214,44 +33327,40 @@ function normalizeConfigValue(key, value) {
     return value.trim() ? value : undefined;
   return;
 }
-var DATA_DIR_ENV = "HASNA_SKILLS_DIR";
 var INSTALLED_SKILLS_DIRNAME = "installed";
 var SKILLS_CACHE_DIRNAME = "skills";
 var LAYOUT_MIGRATION_RECORD = ".layout-migration.json";
 function isOwnerLayoutMigrated(appDir) {
-  return existsSync(join2(appDir, SKILLS_CACHE_DIRNAME, LAYOUT_MIGRATION_RECORD));
+  return existsSync2(join4(appDir, SKILLS_CACHE_DIRNAME, LAYOUT_MIGRATION_RECORD));
 }
 function getDataDir() {
-  const override = process.env[DATA_DIR_ENV];
-  if (override) {
-    try {
-      mkdirSync(override, { recursive: true });
-    } catch {}
-    return override;
-  }
-  const home = process.env["HOME"] || process.env["USERPROFILE"] || homedir2();
-  const newDir = join2(home, ".hasna", "skills");
-  const oldDir = join2(home, ".skills");
-  const oldConfigFile = join2(home, ".skillsrc");
-  mkdirSync(newDir, { recursive: true });
+  const root3 = getDataRoot();
   try {
-    mergeDirectoryContents(oldDir, newDir);
+    mkdirSync(root3, { recursive: true });
   } catch {}
-  if (existsSync(oldConfigFile) && !existsSync(join2(newDir, "config.json"))) {
+  if (hasOperatorOverride())
+    return root3;
+  const home = effectiveHome();
+  const oldDir = join4(home, ".skills");
+  const oldConfigFile = join4(home, ".skillsrc");
+  try {
+    mergeDirectoryContents(oldDir, root3);
+  } catch {}
+  if (existsSync2(oldConfigFile) && !existsSync2(join4(root3, "config.json"))) {
     try {
-      copyFileSync(oldConfigFile, join2(newDir, "config.json"));
+      copyFileSync(oldConfigFile, join4(root3, "config.json"));
     } catch {}
   }
-  return newDir;
+  return root3;
 }
 function getConfigPath(scope) {
   if (scope === "global") {
-    return join2(getDataDir(), "config.json");
+    return join4(getDataDir(), "config.json");
   }
-  return join2(process.cwd(), "skills.config.json");
+  return join4(process.cwd(), "skills.config.json");
 }
 function readConfigFile(path) {
-  if (!existsSync(path))
+  if (!existsSync2(path))
     return {};
   let parsed;
   try {
@@ -33277,14 +33386,14 @@ function loadConfig4() {
 }
 
 // src/server/database-url.ts
-var DEFAULT_SQLITE_FILENAME = "server.db";
+var DEFAULT_SQLITE_FILENAME2 = "server.db";
 var SQLITE_MEMORY_PATH = ":memory:";
 var POSTGRES_SCHEMES = new Set(["postgres", "postgresql"]);
 var SQLITE_SCHEMES = new Set(["sqlite", "sqlite3", "file"]);
 var MEMORY_SCHEMES = new Set(["memory"]);
 var SQLITE_EXTENSIONS = [".db", ".sqlite", ".sqlite3", ".db3"];
 function defaultSqlitePath() {
-  return join3(getDataDir(), DEFAULT_SQLITE_FILENAME);
+  return join5(getDataDir(), DEFAULT_SQLITE_FILENAME2);
 }
 function resolveDatabaseTarget(raw) {
   const value = raw?.trim();
@@ -33311,7 +33420,7 @@ function resolveDatabaseTarget(raw) {
     throw new Error(`unsupported database scheme "${scheme}:". Supported: postgres://, postgresql://, sqlite:, file:, ` + `an absolute or relative path to a .db/.sqlite file, ":memory:", or "memory:" (non-durable, tests only). ` + `Leave the setting empty to use the default SQLite database at ${defaultSqlitePath()}.`);
   }
   if (looksLikeSqlitePath(value)) {
-    const path = isAbsolute(value) ? value : join3(process.cwd(), value);
+    const path = isAbsolute(value) ? value : join5(process.cwd(), value);
     return { kind: "sqlite", path, durable: true, label: `sqlite (${path})` };
   }
   throw new Error(`could not resolve a database backend from "${value}". Use postgres://\u2026, sqlite:\u2026, an absolute or ` + `relative path ending in ${SQLITE_EXTENSIONS.join("/")}, ":memory:", or leave it empty for the ` + `default SQLite database at ${defaultSqlitePath()}.`);
@@ -33335,7 +33444,7 @@ function sqlitePathFromUrl(value, scheme) {
     }
     return rest.slice(2).replace(/^\/\/+/, "/");
   }
-  return isAbsolute(rest) ? rest : join3(process.cwd(), rest);
+  return isAbsolute(rest) ? rest : join5(process.cwd(), rest);
 }
 function looksLikeSqlitePath(value) {
   if (value.includes("/"))
@@ -33347,7 +33456,7 @@ function looksLikeSqlitePath(value) {
 import { Database } from "bun:sqlite";
 import { randomUUID as randomUUID2 } from "crypto";
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync3, readdirSync as readdirSync2 } from "fs";
-import { dirname as dirname4, join as join5 } from "path";
+import { dirname as dirname4, join as join7 } from "path";
 
 // src/server/auth.ts
 import { createHash as createHash3 } from "crypto";
@@ -33380,16 +33489,16 @@ function publicPrincipal(partial = {}) {
 }
 
 // src/server/migrations-dir.ts
-import { existsSync as existsSync2 } from "fs";
-import { dirname as dirname3, join as join4 } from "path";
+import { existsSync as existsSync3 } from "fs";
+import { dirname as dirname3, join as join6 } from "path";
 var MIGRATION_DIALECTS = ["postgres", "sqlite"];
 var MAX_WALK_UP = 6;
 function findMigrationsRoot(startDirs = defaultStartDirs()) {
   for (const start of startDirs) {
     let dir = start;
     for (let level = 0;level < MAX_WALK_UP; level += 1) {
-      const candidate = join4(dir, "migrations");
-      if (MIGRATION_DIALECTS.some((dialect) => existsSync2(join4(candidate, dialect))))
+      const candidate = join6(dir, "migrations");
+      if (MIGRATION_DIALECTS.some((dialect) => existsSync3(join6(candidate, dialect))))
         return candidate;
       const parent = dirname3(dir);
       if (parent === dir)
@@ -33403,8 +33512,8 @@ function resolveMigrationsDir(dialect, root3 = findMigrationsRoot()) {
   if (!root3) {
     throw new Error(`could not locate the migrations directory for dialect "${dialect}". ` + `Expected a migrations/${dialect}/ folder alongside the package root.`);
   }
-  const dir = join4(root3, dialect);
-  if (!existsSync2(dir)) {
+  const dir = join6(root3, dialect);
+  if (!existsSync3(dir)) {
     throw new Error(`migrations directory not found: ${dir}`);
   }
   return dir;
@@ -34149,7 +34258,7 @@ function applySqliteMigrations(db, migrationsDir = resolveMigrationsDir("sqlite"
   const appliedNow = [];
   for (const file of files) {
     const version2 = file.replace(/\.sql$/, "");
-    const text = readFileSync3(join5(migrationsDir, file), "utf8");
+    const text = readFileSync3(join7(migrationsDir, file), "utf8");
     const apply = db.transaction(() => {
       const already = db.query("SELECT 1 AS present FROM schema_migrations WHERE version = ? LIMIT 1").get(version2);
       if (already)
@@ -35553,17 +35662,17 @@ function mergeSkillRegistryLists(...groups) {
 }
 
 // src/server/registry.ts
-import { existsSync as existsSync9, readFileSync as readFileSync9 } from "fs";
-import { resolve, sep } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
+import { resolve as resolve2, sep } from "path";
 
 // src/lib/registry.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6, readdirSync as readdirSync5 } from "fs";
-import { join as join9 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync6, readdirSync as readdirSync5 } from "fs";
+import { join as join11 } from "path";
 
 // src/lib/portable-skills.ts
 import {
   cpSync as cpSync2,
-  existsSync as existsSync5,
+  existsSync as existsSync6,
   mkdirSync as mkdirSync5,
   mkdtempSync,
   readdirSync as readdirSync4,
@@ -35572,7 +35681,7 @@ import {
   statSync as statSync4,
   writeFileSync as writeFileSync3
 } from "fs";
-import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute2, join as join8, normalize } from "path";
+import { basename as basename2, dirname as dirname7, isAbsolute as isAbsolute2, join as join10, normalize } from "path";
 
 // src/lib/registry-data/development-tools.ts
 var DEVELOPMENT_TOOLS_SKILLS = [
@@ -36292,8 +36401,8 @@ var SKILLS = [
 ];
 
 // src/lib/hosted-skill-set.ts
-import { existsSync as existsSync3, readFileSync as readFileSync4, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync4, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
+import { join as join8 } from "path";
 var HOSTED_RUNTIMES = new Set(["hosted"]);
 var HOSTED_SOURCES = new Set(["remote", "private-hosted"]);
 function normalizeMarker(value) {
@@ -36306,8 +36415,8 @@ function isHostedMetadataPackage(pkg) {
   return HOSTED_RUNTIMES.has(normalizeMarker(skills.runtime)) || HOSTED_SOURCES.has(normalizeMarker(skills.source));
 }
 function isHostedMetadataSkillDir(skillDir) {
-  const pkgPath = join6(skillDir, "package.json");
-  if (!existsSync3(pkgPath))
+  const pkgPath = join8(skillDir, "package.json");
+  if (!existsSync4(pkgPath))
     return false;
   try {
     return isHostedMetadataPackage(JSON.parse(readFileSync4(pkgPath, "utf8")));
@@ -36436,14 +36545,14 @@ var PORTABLE_SKILL_DEFAULT_VERSION = "0.1.0";
 // src/lib/portable-skills-files.ts
 import {
   cpSync,
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   lstatSync,
   mkdirSync as mkdirSync4,
   readFileSync as readFileSync5,
   realpathSync,
   writeFileSync as writeFileSync2
 } from "fs";
-import { basename, dirname as dirname6, join as join7, relative } from "path";
+import { basename, dirname as dirname6, join as join9, relative } from "path";
 var ANY_SEGMENT_COPY_EXCLUDES = new Set([
   ".git",
   ".DS_Store",
@@ -36471,12 +36580,12 @@ function normalizePortableSkillName(name) {
   return normalized;
 }
 function readPortableSkillManifest(skillPath, fallbackName = basename(skillPath)) {
-  const skillJsonPath = join7(skillPath, "skill.json");
-  const skillMdPath = join7(skillPath, "SKILL.md");
-  const pkgPath = join7(skillPath, "package.json");
-  const jsonManifest = existsSync4(skillJsonPath) ? readJsonObject(skillJsonPath) : undefined;
-  const frontmatter = existsSync4(skillMdPath) ? parseSkillFrontmatter(readFileSync5(skillMdPath, "utf-8")) ?? undefined : undefined;
-  const pkg = existsSync4(pkgPath) ? readJsonObject(pkgPath) : undefined;
+  const skillJsonPath = join9(skillPath, "skill.json");
+  const skillMdPath = join9(skillPath, "SKILL.md");
+  const pkgPath = join9(skillPath, "package.json");
+  const jsonManifest = existsSync5(skillJsonPath) ? readJsonObject(skillJsonPath) : undefined;
+  const frontmatter = existsSync5(skillMdPath) ? parseSkillFrontmatter(readFileSync5(skillMdPath, "utf-8")) ?? undefined : undefined;
+  const pkg = existsSync5(pkgPath) ? readJsonObject(pkgPath) : undefined;
   const name = normalizePortableSkillName(stringField(jsonManifest, "name") ?? frontmatter?.name ?? stringValue(pkg?.name) ?? fallbackName);
   const description = stringField(jsonManifest, "description") ?? frontmatter?.description ?? stringValue(pkg?.description) ?? `${name} skill`;
   const version2 = stringField(jsonManifest, "version") ?? frontmatter?.version ?? stringValue(pkg?.version) ?? PORTABLE_SKILL_DEFAULT_VERSION;
@@ -36632,18 +36741,18 @@ var LEGACY_CUSTOM_DIRNAME = "custom";
 function getPortableSkillsRoot(options = {}) {
   if (options.rootDir)
     return options.rootDir;
-  const appDir = options.homeDir ? join8(options.homeDir, ".hasna", "skills") : getDataDir();
-  const cache3 = join8(appDir, SKILLS_CACHE_DIRNAME);
+  const appDir = options.homeDir ? join10(options.homeDir, ".hasna", "skills") : getDataDir();
+  const cache3 = join10(appDir, SKILLS_CACHE_DIRNAME);
   if (isOwnerLayoutMigrated(appDir) && safeIsDirectory(cache3))
     return cache3;
-  const installed = join8(appDir, INSTALLED_SKILLS_DIRNAME);
+  const installed = join10(appDir, INSTALLED_SKILLS_DIRNAME);
   migrateLegacySkillLayout(appDir, installed);
   return installed;
 }
 function looksLikeSkillDirectory(path) {
   if (!safeIsDirectory(path))
     return false;
-  return existsSync5(join8(path, "SKILL.md")) || existsSync5(join8(path, "skill.json")) || existsSync5(join8(path, "package.json"));
+  return existsSync6(join10(path, "SKILL.md")) || existsSync6(join10(path, "skill.json")) || existsSync6(join10(path, "package.json"));
 }
 function migrateLegacySkillLayout(appDir, installed) {
   if (!safeIsDirectory(appDir))
@@ -36653,7 +36762,7 @@ function migrateLegacySkillLayout(appDir, installed) {
     for (const entry of readdirSync4(appDir)) {
       if (entry.startsWith(".") || entry === INSTALLED_SKILLS_DIRNAME)
         continue;
-      const path = join8(appDir, entry);
+      const path = join10(appDir, entry);
       if (entry === LEGACY_CUSTOM_DIRNAME) {
         if (!safeIsDirectory(path))
           continue;
@@ -36661,7 +36770,7 @@ function migrateLegacySkillLayout(appDir, installed) {
           for (const nested of readdirSync4(path)) {
             if (nested.startsWith("."))
               continue;
-            const nestedPath = join8(path, nested);
+            const nestedPath = join10(path, nested);
             if (looksLikeSkillDirectory(nestedPath))
               candidates.push({ from: nestedPath, name: nested });
           }
@@ -36675,10 +36784,10 @@ function migrateLegacySkillLayout(appDir, installed) {
     return;
   }
   for (const { from, name } of candidates) {
-    const target = join8(installed, name);
-    if (existsSync5(target))
+    const target = join10(installed, name);
+    if (existsSync6(target))
       continue;
-    const staging = join8(installed, `.migrating-${name}-${process.pid}`);
+    const staging = join10(installed, `.migrating-${name}-${process.pid}`);
     try {
       rmSync(staging, { recursive: true, force: true });
       cpSync2(from, staging, { recursive: true, errorOnExist: false });
@@ -36691,7 +36800,7 @@ function migrateLegacySkillLayout(appDir, installed) {
   }
 }
 function getPortableSkillPath(name, options = {}) {
-  return join8(getPortableSkillsRoot(options), normalizePortableSkillName(name));
+  return join10(getPortableSkillsRoot(options), normalizePortableSkillName(name));
 }
 function findPortableSkill(name, options = {}) {
   let normalized;
@@ -36701,7 +36810,7 @@ function findPortableSkill(name, options = {}) {
     return null;
   }
   const path = getPortableSkillPath(normalized, options);
-  if (!existsSync5(path) || !statSync4(path).isDirectory())
+  if (!existsSync6(path) || !statSync4(path).isDirectory())
     return null;
   try {
     return summarizePortableSkill(path, normalized);
@@ -36717,7 +36826,7 @@ function listPortableSkills(options = {}) {
   for (const entry of readdirSync4(root3).sort()) {
     if (entry.startsWith("."))
       continue;
-    const path = join8(root3, entry);
+    const path = join10(root3, entry);
     if (!safeIsDirectory(path))
       continue;
     try {
@@ -36810,7 +36919,7 @@ function parseSkillMdFrontmatter(content) {
   return Object.keys(result).length > 0 ? result : null;
 }
 function discoverSkillsInDir(dir, source = "custom") {
-  if (!existsSync6(dir))
+  if (!existsSync7(dir))
     return [];
   const result = [];
   try {
@@ -36818,8 +36927,8 @@ function discoverSkillsInDir(dir, source = "custom") {
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
-      const skillMdPath = join9(dir, entry.name, "SKILL.md");
-      if (!existsSync6(skillMdPath))
+      const skillMdPath = join11(dir, entry.name, "SKILL.md");
+      if (!existsSync7(skillMdPath))
         continue;
       let content;
       try {
@@ -36838,7 +36947,7 @@ function discoverSkillsInDir(dir, source = "custom") {
         category: fm.category || "Development Tools",
         tags: fm.tags || [],
         ...fm.kind ? { kind: fm.kind } : {},
-        ...isHostedMetadataSkillDir(join9(dir, entry.name)) ? { serverOwned: true } : {},
+        ...isHostedMetadataSkillDir(join11(dir, entry.name)) ? { serverOwned: true } : {},
         source
       });
     }
@@ -36847,16 +36956,16 @@ function discoverSkillsInDir(dir, source = "custom") {
 }
 function findExtensionSkillPath(name) {
   const config = loadConfig4();
-  if (!config.extensionsDir || !existsSync6(config.extensionsDir))
+  if (!config.extensionsDir || !existsSync7(config.extensionsDir))
     return null;
   try {
     const entries = readdirSync5(config.extensionsDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory())
         continue;
-      const skillDir = join9(config.extensionsDir, entry.name);
-      const skillMdPath = join9(skillDir, "SKILL.md");
-      if (!existsSync6(skillMdPath))
+      const skillDir = join11(config.extensionsDir, entry.name);
+      const skillMdPath = join11(skillDir, "SKILL.md");
+      if (!existsSync7(skillMdPath))
         continue;
       let content;
       try {
@@ -36888,12 +36997,12 @@ function loadRegistry(cwd) {
   if (registryCache && registryCacheKey === rootKey && now - registryCacheTime < REGISTRY_CACHE_TTL) {
     return registryCache;
   }
-  const dataDir = getDataDir();
+  const dataDir2 = getDataDir();
   const config = loadConfig4();
   const official = SKILLS.map((s2) => ({ ...s2, source: "official" }));
   const extensions = config.extensionsDir ? discoverSkillsInDir(config.extensionsDir, "extension") : [];
   const portableCustom = listPortableSkillMetas();
-  const legacyCustom = discoverSkillsInDir(join9(dataDir, "custom"));
+  const legacyCustom = discoverSkillsInDir(join11(dataDir2, "custom"));
   const globalCustom = mergeCustomSkills([...legacyCustom, ...portableCustom]);
   registryCache = mergeSkillRegistryLists(official, extensions, globalCustom);
   registryCacheTime = now;
@@ -36913,12 +37022,12 @@ function mergeCustomSkills(skills) {
 }
 
 // src/lib/skillinfo.ts
-import { existsSync as existsSync8, readFileSync as readFileSync8 } from "fs";
-import { join as join11 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync8 } from "fs";
+import { join as join13 } from "path";
 
 // src/lib/installer.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7, rmSync as rmSync2 } from "fs";
-import { dirname as dirname8, join as join10 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync7, rmSync as rmSync2 } from "fs";
+import { dirname as dirname8, join as join12 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 // src/lib/utils.ts
 function normalizeSkillName(name) {
@@ -36930,12 +37039,12 @@ var __dirname2 = dirname8(fileURLToPath2(import.meta.url));
 function findSkillsDir() {
   let dir = __dirname2;
   for (let i3 = 0;i3 < 5; i3++) {
-    const candidate = join10(dir, "skills");
-    if (existsSync7(candidate) && !dir.includes(".skills"))
+    const candidate = join12(dir, "skills");
+    if (existsSync8(candidate) && !dir.includes(".skills"))
       return candidate;
     dir = dirname8(dir);
   }
-  return join10(__dirname2, "..", "skills");
+  return join12(__dirname2, "..", "skills");
 }
 var SKILLS_DIR = findSkillsDir();
 function getSkillPath(name) {
@@ -36943,13 +37052,13 @@ function getSkillPath(name) {
   const portable = findPortableSkill(skillName);
   if (portable)
     return portable.path;
-  const legacyCustomPath = join10(getDataDir(), "custom", skillName);
-  if (existsSync7(legacyCustomPath))
+  const legacyCustomPath = join12(getDataDir(), "custom", skillName);
+  if (existsSync8(legacyCustomPath))
     return legacyCustomPath;
   const extensionPath = findExtensionSkillPath(skillName);
   if (extensionPath)
     return extensionPath;
-  return join10(SKILLS_DIR, skillName);
+  return join12(SKILLS_DIR, skillName);
 }
 function getCanonicalSkillName(name) {
   return getSkill(name)?.name ?? resolveSkillAlias(normalizeSkillSlug(name));
@@ -36958,17 +37067,17 @@ function getCanonicalSkillName(name) {
 // src/lib/skillinfo.ts
 function getSkillDocs(name) {
   const skillPath = getSkillPath(name);
-  if (!existsSync8(skillPath))
+  if (!existsSync9(skillPath))
     return null;
   return {
-    skillMd: readIfExists(join11(skillPath, "SKILL.md")),
-    readme: readIfExists(join11(skillPath, "README.md")),
-    claudeMd: readIfExists(join11(skillPath, "CLAUDE.md"))
+    skillMd: readIfExists(join13(skillPath, "SKILL.md")),
+    readme: readIfExists(join13(skillPath, "README.md")),
+    claudeMd: readIfExists(join13(skillPath, "CLAUDE.md"))
   };
 }
 function readIfExists(path) {
   try {
-    if (existsSync8(path)) {
+    if (existsSync9(path)) {
       return readFileSync8(path, "utf-8");
     }
   } catch {}
@@ -37006,11 +37115,11 @@ function getServerSkillMd(slug) {
   const docs = getSkillDocs(name);
   if (docs?.skillMd)
     return docs.skillMd;
-  const skillsDir = resolve(process.cwd(), "skills");
-  const path = resolve(skillsDir, name, "SKILL.md");
+  const skillsDir = resolve2(process.cwd(), "skills");
+  const path = resolve2(skillsDir, name, "SKILL.md");
   if (!isInsideDir(skillsDir, path))
     return null;
-  return existsSync9(path) ? readFileSync9(path, "utf8") : null;
+  return existsSync10(path) ? readFileSync9(path, "utf8") : null;
 }
 
 // src/server/skills-api.ts
@@ -37420,6 +37529,9 @@ async function createSkillsFetchHandler(options = {}) {
       if (request.method === "GET" && url.pathname === "/ready") {
         return json({ ok: true, service: "skills" });
       }
+      if (request.method === "GET" && url.pathname === "/version") {
+        return json({ ok: true, service: "skills", version: package_default.version });
+      }
       if (url.pathname.startsWith("/api/")) {
         const principal = await authenticateRequest(store, request);
         if (!principal)