@hasna/skills 0.8.4 → 0.8.6

package/README.md

@@ -246,8 +246,11 @@ select complete skill instructions from that verified cache using explicit
 A session retains its selected versions; compaction restores loaded instructions,
 and subagents inherit the parent's selection. Instructions that exceed the
 context budget produce an explicit `skills load` command. A hook never executes
-a skill. Cached use is explicit and expires after 24 hours; authentication
-failures do not silently switch to a local catalog.
+a skill. Cached use is explicit and expires after 24 hours. When cached context
+expires or is missing, the hook makes one authenticated API attempt for the same
+pinned session. It preserves exact versions and does not extend an expired
+receipt's lifetime. Authentication, integrity and native discovery failures still
+block; they do not silently switch to a local catalog.
 
 ## Profiles, station sync and rollback
 

package/bin/index.js

@@ -36868,7 +36868,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.8.4",
+    version: "0.8.6",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -76989,28 +76989,30 @@ async function buildSkillContext(input2, options = {}) {
       explicit.add(selectionKey(exactProfileSelection(spec, profile)));
   }
   const promptWords = words2(prompt);
+  const promptNames = new Set(prompt.toLowerCase().match(/[a-z0-9]+(?:-[a-z0-9]+)*/g) ?? []);
   const loaded = new Set(resolved.session?.loaded ?? []);
   const paths = [...input2.paths ?? [], ...input2.cwd ? [input2.cwd, resolve11(input2.cwd)] : []];
   const candidates = profile.selections.map((selection) => {
     const key = selectionKey(selection);
     if (input2.restore && loaded.has(key))
-      return { selection, reason: "session-restore", score: 2000 };
+      return { selection, reason: "session-restore", priority: 6, score: 2000 };
     if (resolved.inheritedLoaded?.includes(key))
-      return { selection, reason: "subagent-inherit", score: 2000 };
+      return { selection, reason: "subagent-inherit", priority: 6, score: 2000 };
     if (explicit.has(key))
-      return { selection, reason: "explicit", score: 1000 };
+      return { selection, reason: "explicit", priority: 5, score: 1000 };
     if (selection.triggers?.always)
-      return { selection, reason: "profile-required", score: 900 };
+      return { selection, reason: "profile-required", priority: 4, score: 900 };
     const matchedPath = selection.triggers?.paths?.some((pattern) => paths.some((path) => pathMatch(pattern, path)));
     if (matchedPath)
-      return { selection, reason: "path", score: 500 };
+      return { selection, reason: "path", priority: 3, score: 500 };
     const keywords = selection.triggers?.keywords ?? selection.slug.split("-").filter((word) => word.length >= 4);
     const matches2 = keywords.filter((keyword) => {
       const tokens = [...words2(keyword)];
       return tokens.length > 0 && tokens.every((token) => promptWords.has(token));
     }).length;
-    return { selection, reason: "prompt", score: matches2 * 100 };
-  }).filter((candidate) => candidate.score > 0).sort((a, b) => b.score - a.score || a.selection.slug.localeCompare(b.selection.slug));
+    const named = promptNames.has(selection.slug) || selection.aliases?.some((alias) => promptNames.has(alias));
+    return { selection, reason: "prompt", priority: named ? 2 : 1, score: matches2 * 100 };
+  }).filter((candidate) => candidate.score > 0).sort((a, b) => b.priority - a.priority || b.score - a.score || a.selection.slug.localeCompare(b.selection.slug));
   const sections = [];
   const selections = [];
   const omitted = [];
@@ -105414,6 +105416,34 @@ __export(exports_agent_integration, {
 });
 import { readFileSync as readFileSync37 } from "fs";
 import { isAbsolute as isAbsolute17 } from "path";
+async function contextForHook(input3, profileId, cached2, deadline) {
+  const remaining = deadline - Date.now();
+  if (remaining <= 0)
+    throw new Error("Skills hook deadline exceeded");
+  const args2 = [process.execPath, process.argv[1], "context", "--stdin", "--json", "--selection-profile", profileId];
+  if (cached2)
+    args2.push("--cached");
+  const child = Bun.spawn(args2, { stdin: new Blob([JSON.stringify(input3)]), stdout: "pipe", stderr: "pipe", env: { ...process.env, NO_COLOR: "1" } });
+  const timer = setTimeout(() => child.kill("SIGKILL"), Math.min(6500, remaining));
+  let result2;
+  let status;
+  try {
+    const [stdout, , exitCode] = await Promise.all([new Response(child.stdout).text(), new Response(child.stderr).text(), child.exited]);
+    status = exitCode;
+    result2 = JSON.parse(stdout);
+  } finally {
+    clearTimeout(timer);
+  }
+  if (status !== 0) {
+    if (cached2 && RECOVERABLE_CONTEXT_CACHE_ERRORS.has(result2?.error?.code)) {
+      return contextForHook(input3, profileId, false, deadline);
+    }
+    throw new Error("Skills context could not be resolved");
+  }
+  if (typeof result2?.context !== "string")
+    throw new Error("Invalid Skills context response");
+  return result2;
+}
 function agents(value) {
   if (value === "all")
     return [...INTEGRATION_AGENTS];
@@ -105442,6 +105472,7 @@ function registerAgentIntegration(parent) {
     }
   });
   hook.command("user-prompt").requiredOption("--agent <agent>", `Native payload/output adapter: ${INTEGRATION_AGENTS.join(", ")}`).option("--event <event>", "Native lifecycle event supplied by the installed adapter").option("--selection-profile <id>", "Selection profile to load").description("Read native lifecycle JSON on stdin and return selected context").action(async (options) => {
+    const deadline = Date.now() + 12000;
     let event = options.agent === "hermes" && options.event === "pre_tool_call" ? "pre_tool_call" : "UserPromptSubmit";
     try {
       if (agents(options.agent).length !== 1)
@@ -105490,38 +105521,29 @@ function registerAgentIntegration(parent) {
       if (typeof input3.prompt === "string")
         input3.prompt = normalizeAgentHookPrompt(options.agent, nativeEvent, input3.prompt);
       if (event === "SessionStart") {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+          throw new Error("Skills hook deadline exceeded");
         const refresh = Bun.spawn([process.execPath, process.argv[1], "sync", "--selection-profile", selectionProfile, "--json"], { stdin: "ignore", stdout: "pipe", stderr: "pipe", env: { ...process.env, NO_COLOR: "1" } });
-        const timer2 = setTimeout(() => refresh.kill("SIGKILL"), 6500);
+        const timer = setTimeout(() => refresh.kill("SIGKILL"), Math.min(6500, remaining));
         try {
           const [, , status] = await Promise.all([new Response(refresh.stdout).text(), new Response(refresh.stderr).text(), refresh.exited]);
           if (status !== 0)
             throw new Error("Session profile refresh failed");
         } finally {
-          clearTimeout(timer2);
+          clearTimeout(timer);
         }
       }
-      const args2 = [process.execPath, process.argv[1], "context", "--stdin", "--json", "--cached", "--selection-profile", selectionProfile];
-      const child = Bun.spawn(args2, { stdin: new Blob([JSON.stringify(input3)]), stdout: "pipe", stderr: "pipe", env: { ...process.env, NO_COLOR: "1" } });
-      const timer = setTimeout(() => child.kill("SIGKILL"), 6500);
-      try {
-        const [stdout, , status] = await Promise.all([new Response(child.stdout).text(), new Response(child.stderr).text(), child.exited]);
-        if (status !== 0)
-          throw new Error("Skills context could not be resolved");
-        const result2 = JSON.parse(stdout);
-        if (typeof result2.context !== "string")
-          throw new Error("Invalid Skills context response");
-        const output2 = hookContextOutput(event, result2);
-        if (options.agent === "hermes") {
-          await writeCliOutput(JSON.stringify({ context: output2.hookSpecificOutput?.additionalContext ?? "" }));
-        } else if (options.agent === "cursor") {
-          await writeCliOutput(JSON.stringify(event === "SessionStart" ? { additional_context: output2.hookSpecificOutput?.additionalContext ?? "" } : { continue: true }));
-        } else {
-          if (options.agent === "gemini" && output2.hookSpecificOutput)
-            output2.hookSpecificOutput.hookEventName = nativeEvent;
-          await writeCliOutput(JSON.stringify(output2));
-        }
-      } finally {
-        clearTimeout(timer);
+      const result2 = await contextForHook(input3, selectionProfile, true, deadline);
+      const output2 = hookContextOutput(event, result2);
+      if (options.agent === "hermes") {
+        await writeCliOutput(JSON.stringify({ context: output2.hookSpecificOutput?.additionalContext ?? "" }));
+      } else if (options.agent === "cursor") {
+        await writeCliOutput(JSON.stringify(event === "SessionStart" ? { additional_context: output2.hookSpecificOutput?.additionalContext ?? "" } : { continue: true }));
+      } else {
+        if (options.agent === "gemini" && output2.hookSpecificOutput)
+          output2.hookSpecificOutput.hookEventName = nativeEvent;
+        await writeCliOutput(JSON.stringify(output2));
       }
     } catch (error61) {
       const reason = error61 instanceof Error && error61.message.startsWith("NATIVE_SKILL_DRIFT:") ? error61.message : "Skills context is unavailable. Run skills sync --selection-profile <id> and skills context --stdin --json to diagnose the selected profile.";
@@ -105557,11 +105579,13 @@ function registerAgentIntegration(parent) {
     }
   });
 }
+var RECOVERABLE_CONTEXT_CACHE_ERRORS;
 var init_agent_integration2 = __esm(() => {
   init_agent_hermes();
   init_context();
   init_agent_adapters();
   init_agent_integration();
+  RECOVERABLE_CONTEXT_CACHE_ERRORS = new Set(["CACHED_PROFILE_EXPIRED", "CACHED_PROFILE_MISSING", "CACHED_BUNDLE_MISSING"]);
 });
 
 // src/lib/profile-admin.ts

package/bin/mcp.js

@@ -20019,7 +20019,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.8.4",
+    version: "0.8.6",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {

package/bin/migrate.js

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

package/bin/server.js

@@ -83749,7 +83749,7 @@ var require_protocols9 = __commonJS((exports) => {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.8.4",
+  version: "0.8.6",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/bin/worker.js

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

package/dist/index.js

@@ -37660,7 +37660,7 @@ import { dirname as dirname14, relative as relative7 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.8.4",
+  version: "0.8.6",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -40707,28 +40707,30 @@ async function buildSkillContext(input2, options = {}) {
       explicit.add(selectionKey(exactProfileSelection(spec, profile)));
   }
   const promptWords = words(prompt);
+  const promptNames = new Set(prompt.toLowerCase().match(/[a-z0-9]+(?:-[a-z0-9]+)*/g) ?? []);
   const loaded = new Set(resolved.session?.loaded ?? []);
   const paths = [...input2.paths ?? [], ...input2.cwd ? [input2.cwd, resolve13(input2.cwd)] : []];
   const candidates = profile.selections.map((selection) => {
     const key = selectionKey(selection);
     if (input2.restore && loaded.has(key))
-      return { selection, reason: "session-restore", score: 2000 };
+      return { selection, reason: "session-restore", priority: 6, score: 2000 };
     if (resolved.inheritedLoaded?.includes(key))
-      return { selection, reason: "subagent-inherit", score: 2000 };
+      return { selection, reason: "subagent-inherit", priority: 6, score: 2000 };
     if (explicit.has(key))
-      return { selection, reason: "explicit", score: 1000 };
+      return { selection, reason: "explicit", priority: 5, score: 1000 };
     if (selection.triggers?.always)
-      return { selection, reason: "profile-required", score: 900 };
+      return { selection, reason: "profile-required", priority: 4, score: 900 };
     const matchedPath = selection.triggers?.paths?.some((pattern) => paths.some((path) => pathMatch(pattern, path)));
     if (matchedPath)
-      return { selection, reason: "path", score: 500 };
+      return { selection, reason: "path", priority: 3, score: 500 };
     const keywords = selection.triggers?.keywords ?? selection.slug.split("-").filter((word) => word.length >= 4);
     const matches = keywords.filter((keyword) => {
       const tokens = [...words(keyword)];
       return tokens.length > 0 && tokens.every((token) => promptWords.has(token));
     }).length;
-    return { selection, reason: "prompt", score: matches * 100 };
-  }).filter((candidate) => candidate.score > 0).sort((a, b) => b.score - a.score || a.selection.slug.localeCompare(b.selection.slug));
+    const named = promptNames.has(selection.slug) || selection.aliases?.some((alias) => promptNames.has(alias));
+    return { selection, reason: "prompt", priority: named ? 2 : 1, score: matches * 100 };
+  }).filter((candidate) => candidate.score > 0).sort((a, b) => b.priority - a.priority || b.score - a.score || a.selection.slug.localeCompare(b.selection.slug));
   const sections = [];
   const selections = [];
   const omitted = [];

package/dist/sdk/index.js

@@ -96141,7 +96141,7 @@ async function resolveExecutionGrant(input) {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.8.4",
+  version: "0.8.6",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {