@hasna/skills 0.10.74 → 0.10.76

package/bin/mcp.js

@@ -23,7 +23,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.10.74",
+    version: "0.10.76",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -33567,8 +33567,13 @@ var init_kernel_lock = __esm(() => {
 });
 
 // src/lib/codex-corpus-write.ts
+import { AsyncLocalStorage } from "async_hooks";
+var enclosing, leaseHolds;
 var init_codex_corpus_write = __esm(() => {
   init_kernel_lock();
+  init_config();
+  enclosing = new AsyncLocalStorage;
+  leaseHolds = new WeakMap;
 });
 
 // src/lib/codex-hook-rpc.ts
@@ -36452,6 +36457,118 @@ var init_skillinfo = __esm(() => {
   GENERIC_ENV_PATTERN = /\b((?:OPENAI|ANTHROPIC|GEMINI|XAI|ELEVENLABS|DEEPGRAM|REPLICATE|FAL|STABILITY|EXA|FIRECRAWL|TWILIO|SENDGRID|RESEND|SLACK|DISCORD|NOTION|LINEAR|GITHUB|AWS|GOOGLE|CLOUDFLARE|VERCEL|SUPABASE|STRIPE)_[A-Z_]+)\b/g;
 });
 
+// src/lib/search.ts
+function editDistance(a, b) {
+  if (a === b)
+    return 0;
+  if (a.length === 0)
+    return b.length;
+  if (b.length === 0)
+    return a.length;
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  const curr = new Array(b.length + 1);
+  for (let i = 1;i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    prev.splice(0, prev.length, ...curr);
+  }
+  return prev[b.length];
+}
+function fuzzyMatchScore(word, target) {
+  if (target.includes(word))
+    return 1;
+  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
+  for (const token of tokens) {
+    if (token.startsWith(word))
+      return 0.6;
+  }
+  if (word.length >= 3) {
+    const maxDist = word.length <= 3 ? 1 : 2;
+    for (const token of tokens) {
+      if (Math.abs(token.length - word.length) <= maxDist) {
+        const dist = editDistance(word, token);
+        if (dist <= maxDist)
+          return 0.4;
+      }
+    }
+  }
+  return 0;
+}
+function searchSkills(query, registry2 = loadRegistry()) {
+  const words = query.toLowerCase().split(/\s+/).filter(Boolean);
+  if (words.length === 0)
+    return [];
+  const scored = [];
+  for (const skill of registry2) {
+    const nameLower = skill.name.toLowerCase();
+    const displayNameLower = skill.displayName.toLowerCase();
+    const descriptionLower = skill.description.toLowerCase();
+    const tagsLower = skill.tags.map((t2) => t2.toLowerCase());
+    const tagsCombined = tagsLower.join(" ");
+    let score = 0;
+    let allWordsMatch = true;
+    for (const word of words) {
+      let wordScore = 0;
+      const nameMatch = fuzzyMatchScore(word, nameLower);
+      if (nameMatch > 0)
+        wordScore += 10 * nameMatch;
+      const displayMatch = fuzzyMatchScore(word, displayNameLower);
+      if (displayMatch > 0)
+        wordScore += 7 * displayMatch;
+      const tagMatch = Math.max(...tagsLower.map((t2) => fuzzyMatchScore(word, t2)), fuzzyMatchScore(word, tagsCombined));
+      if (tagMatch > 0)
+        wordScore += 5 * tagMatch;
+      const descMatch = fuzzyMatchScore(word, descriptionLower);
+      if (descMatch > 0)
+        wordScore += 2 * descMatch;
+      if (wordScore === 0) {
+        allWordsMatch = false;
+        break;
+      }
+      score += wordScore;
+    }
+    if (allWordsMatch && score > 0) {
+      scored.push({ skill, score });
+    }
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.map((s) => s.skill);
+}
+function findCloseSkillNames(query, names, maxResults = 3) {
+  if (maxResults <= 0)
+    return [];
+  const q = query.trim().toLowerCase();
+  if (q.length === 0)
+    return [];
+  const tokens = q.split("-").filter(Boolean);
+  const ranked = [];
+  if (q.length >= 3) {
+    for (const name of names) {
+      const candidate = name.toLowerCase();
+      const rank = candidate === q ? 0 : candidate.endsWith(`-${q}`) || candidate.startsWith(`${q}-`) ? 1 : tokens.length > 1 && tokens.every((token) => candidate.split("-").includes(token)) ? 2 : undefined;
+      if (rank !== undefined)
+        ranked.push([name, rank]);
+    }
+  }
+  ranked.sort((a, b) => a[1] - b[1] || a[0].length - b[0].length || a[0].localeCompare(b[0]));
+  const found = ranked.slice(0, maxResults).map(([name]) => name);
+  if (found.length === maxResults)
+    return found;
+  const taken = new Set(found);
+  const threshold = Math.max(3, Math.floor(q.length / 2));
+  const byDistance = names.filter((name) => !taken.has(name)).map((name) => ({ name, distance: editDistance(q, name.toLowerCase()) })).filter((entry) => entry.distance <= threshold).sort((a, b) => a.distance - b.distance || a.name.localeCompare(b.name));
+  return [...found, ...byDistance.slice(0, maxResults - found.length).map((entry) => entry.name)];
+}
+function findSimilarSkills(query, maxResults = 3, registry2 = loadRegistry()) {
+  return findCloseSkillNames(query, registry2.map((skill) => skill.name), maxResults);
+}
+var init_search = __esm(() => {
+  init_registry();
+});
+
 // src/lib/selected-document.ts
 function readSelectedDocument(entries, file2) {
   const entry = file2 !== undefined ? entries.find((candidate) => candidate.path === file2) : DOCUMENT_PATHS.map((path) => entries.find((candidate) => candidate.path === path && candidate.bytes.length > 0)).find(Boolean);
@@ -36532,11 +36649,30 @@ function exactProfileSelection(spec, profile) {
   const at = spec.lastIndexOf("@");
   const slug = at > 0 ? spec.slice(0, at) : spec;
   const version2 = at > 0 ? spec.slice(at + 1) : undefined;
-  const selection = profile.selections.find((entry) => (entry.slug === slug || entry.aliases?.includes(slug)) && (version2 === undefined || version2 === entry.version));
-  if (!selection || version2 === "")
-    throw new SkillSelectionError("SKILL_NOT_SELECTED", "The requested exact skill version is not selected by this profile or project lock.");
+  const named = profile.selections.filter((entry) => entry.slug === slug || entry.aliases?.includes(slug));
+  if (version2 === "")
+    throw new SkillSelectionError("SKILL_NOT_SELECTED", emptyVersionRefusal(spec));
+  if (named.length === 0)
+    throw new SkillSelectionError("SKILL_NOT_SELECTED", unknownNameRefusal(slug, profile));
+  const selection = version2 === undefined ? named[0] : named.find((entry) => entry.version === version2);
+  if (!selection)
+    throw new SkillSelectionError("SKILL_NOT_SELECTED", wrongVersionRefusal(slug, version2, named));
   return selection;
 }
+function emptyVersionRefusal(spec) {
+  return `The requested name '${spec}' has an empty version. ${ACCEPTED_FORM}`;
+}
+function wrongVersionRefusal(slug, version2, named) {
+  const versions2 = [...new Set(named.map((entry) => entry.version))].sort();
+  const canonical9 = named[0].slug;
+  return `Skill '${slug}' is selected at version '${versions2.join("', '")}', but '${version2}' was requested. ` + `Accepted form: '${canonical9}@${versions2[0]}'.`;
+}
+function unknownNameRefusal(slug, profile) {
+  const names = profile.selections.flatMap((entry) => [entry.slug, ...entry.aliases ?? []]);
+  const close = findCloseSkillNames(slug, names);
+  const hint = close.length > 0 ? ` Did you mean: ${close.join(", ")}?` : "";
+  return `Skill '${slug}' is not selected by this Skills profile or project lock.${hint} ` + `Read the accepted names with 'skills search <term>' or 'skills list --all --json'; accept one with 'skills pin <name>'. ${ACCEPTED_FORM}`;
+}
 async function loadSelectedSkill(spec, profileId, options = {}) {
   const context = await resolveSelectionContext(profileId, options);
   const selection = exactProfileSelection(spec, context.receipt.profile);
@@ -36581,9 +36717,11 @@ async function selectedSkillRequirements(spec, profileId, options = {}) {
   }
   return { ...getSkillRequirementsFromContent(selection.slug, texts, dependencies), selection };
 }
+var ACCEPTED_FORM = "Accepted form: '<slug>' or '<slug>@<version>'.";
 var init_selection_resolver = __esm(() => {
   init_profile_client();
   init_skillinfo();
+  init_search();
   init_selected_document();
   init_selection_cache();
 });
@@ -38615,95 +38753,6 @@ var init_registry_types = __esm(() => {
   ];
 });
 
-// src/lib/search.ts
-function editDistance(a, b) {
-  if (a === b)
-    return 0;
-  if (a.length === 0)
-    return b.length;
-  if (b.length === 0)
-    return a.length;
-  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
-  const curr = new Array(b.length + 1);
-  for (let i = 1;i <= a.length; i++) {
-    curr[0] = i;
-    for (let j = 1;j <= b.length; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
-    }
-    prev.splice(0, prev.length, ...curr);
-  }
-  return prev[b.length];
-}
-function fuzzyMatchScore(word, target) {
-  if (target.includes(word))
-    return 1;
-  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
-  for (const token of tokens) {
-    if (token.startsWith(word))
-      return 0.6;
-  }
-  if (word.length >= 3) {
-    const maxDist = word.length <= 3 ? 1 : 2;
-    for (const token of tokens) {
-      if (Math.abs(token.length - word.length) <= maxDist) {
-        const dist = editDistance(word, token);
-        if (dist <= maxDist)
-          return 0.4;
-      }
-    }
-  }
-  return 0;
-}
-function searchSkills(query, registry2 = loadRegistry()) {
-  const words = query.toLowerCase().split(/\s+/).filter(Boolean);
-  if (words.length === 0)
-    return [];
-  const scored = [];
-  for (const skill of registry2) {
-    const nameLower = skill.name.toLowerCase();
-    const displayNameLower = skill.displayName.toLowerCase();
-    const descriptionLower = skill.description.toLowerCase();
-    const tagsLower = skill.tags.map((t2) => t2.toLowerCase());
-    const tagsCombined = tagsLower.join(" ");
-    let score = 0;
-    let allWordsMatch = true;
-    for (const word of words) {
-      let wordScore = 0;
-      const nameMatch = fuzzyMatchScore(word, nameLower);
-      if (nameMatch > 0)
-        wordScore += 10 * nameMatch;
-      const displayMatch = fuzzyMatchScore(word, displayNameLower);
-      if (displayMatch > 0)
-        wordScore += 7 * displayMatch;
-      const tagMatch = Math.max(...tagsLower.map((t2) => fuzzyMatchScore(word, t2)), fuzzyMatchScore(word, tagsCombined));
-      if (tagMatch > 0)
-        wordScore += 5 * tagMatch;
-      const descMatch = fuzzyMatchScore(word, descriptionLower);
-      if (descMatch > 0)
-        wordScore += 2 * descMatch;
-      if (wordScore === 0) {
-        allWordsMatch = false;
-        break;
-      }
-      score += wordScore;
-    }
-    if (allWordsMatch && score > 0) {
-      scored.push({ skill, score });
-    }
-  }
-  scored.sort((a, b) => b.score - a.score);
-  return scored.map((s) => s.skill);
-}
-function findSimilarSkills(query, maxResults = 3, registry2 = loadRegistry()) {
-  const q = query.toLowerCase();
-  const scored = registry2.map((s) => ({ name: s.name, dist: editDistance(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
-  return scored.slice(0, maxResults).map((s) => s.name);
-}
-var init_search = __esm(() => {
-  init_registry();
-});
-
 // src/lib/registry.ts
 import { existsSync as existsSync13, readFileSync as readFileSync18, readdirSync as readdirSync10 } from "fs";
 import { join as join33 } from "path";

package/bin/migrate.js

@@ -25,7 +25,7 @@ import { join as join5 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.74",
+  version: "0.10.76",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/bin/server.js

@@ -24140,7 +24140,7 @@ restoreLaunchCwd();
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.74",
+  version: "0.10.76",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/bin/worker.js

@@ -24143,7 +24143,7 @@ import { randomUUID as randomUUID6 } from "crypto";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.10.74",
+  version: "0.10.76",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/dist/cli/stray-arguments.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Stray positionals on a verb that declares none are a phantom verb, not a
+ * no-op. Commander's `allowExcessArguments` defaults to true (12.1.0,
+ * `lib/command.js:28`), so `skills categories typo` exited 0 with the ordinary
+ * output and `skills list typo` printed the whole catalogue: a caller reading
+ * the exit code is told the word was understood (BUG e3997558).
+ *
+ * The default command refuses by hand so it can name the verbs that exist, and
+ * `skills mcp` refuses by hand so it can name its three forms. Those two keep
+ * their own, better sentences. Every other command that declares no argument of
+ * its own is closed here in one pass, so the next command added gets the
+ * refusal without its author having to remember the hole exists.
+ */
+import type { Command } from "commander";
+/**
+ * Opt a command out of the pass because it owns a more precise refusal than
+ * commander's. Chainable, and it keeps `allowExcessArguments(true)` so the
+ * command still receives the stray word it wants to report.
+ */
+export declare function permitStrayArguments(command: Command): Command;
+/**
+ * Refuse positionals on every command that declares no argument of its own.
+ *
+ * A command that declares arguments keeps commander's own arity check, and a
+ * command with subcommands never reaches the excess check for a word that names
+ * a child (commander dispatches the subcommand first). Commands without an
+ * action handler reach it only with zero operands, so the flag is inert there.
+ */
+export declare function rejectStrayArguments(command: Command): void;