@rayul/kordis 0.10.3 → 0.11.0

package/assets/kordis-using/SKILL.md

@@ -125,12 +125,19 @@ two parents requiring incompatible ranges = hard fail** (exit code
 can pin the offending one explicitly. Recommended deps are only
 walked at depth 0 when `--with-recommends` is passed.
 
+**Per-version deps (0.11.0+)** — pinning an older version walks the
+dependencies THAT version declared, not the package's current ones:
+`kordis pull user/foo@0.1.0` resolves 0.1.0's graph even if newer
+releases changed or dropped deps.
+
 `kordis read @range` resolves to a concrete version (the stderr footer
 shows it: `… @1.4.2 (resolved @^1 → 1.4.2)`) but does NOT walk
 transitive deps — read is a one-shot context inject, no install plan.
 
 `kordis info user/foo@^1` shows a `Requested: 1.4.2 (current: 2.0.0)`
-line above `Type` when the pin differs from the registry default.
+line above `Type` when the pin differs from the registry default. Its
+`Depends`/`Recommends` lists reflect the resolved version (0.11.0+), so
+inspecting an old pin shows that version's declared deps.
 
 ## When a version is yanked (0.10.0+)
 

package/dist/index.js

@@ -2379,30 +2379,13 @@ function searchCommand() {
       });
     }
     const queryProvided = query.length > 0;
+    const emptyHint = opts.type ? `no packages of type "${opts.type}" match. Try without --type, or list everything: kordis search --type ${opts.type} --sort recent --limit 25` : queryProvided ? "try `--type skill` (or mcp-server / project-rules / custom-agent / hook) to narrow, or broader keywords" : 'try keywords (e.g. `kordis search "topic"`) or `kordis search --trending`';
     printDual({
-      json: res,
+      json: res.results.length === 0 ? { ...res, hint: emptyHint } : res,
       human: () => {
         if (res.results.length === 0) {
           printHuman(c.yellow("(no results)"));
-          if (opts.type) {
-            printHuman(
-              c.gray(
-                `  \u2192 no packages of type "${opts.type}" match. Try without --type, or list everything: kordis search --type ${opts.type} --sort recent --limit 25`
-              )
-            );
-          } else if (queryProvided) {
-            printHuman(
-              c.gray(
-                "  \u2192 try `--type skill` (or mcp-server / project-rules / custom-agent / hook) to narrow, or broader keywords"
-              )
-            );
-          } else {
-            printHuman(
-              c.gray(
-                '  \u2192 try keywords (e.g. `kordis search "topic"`) or `kordis search --trending`'
-              )
-            );
-          }
+          printHuman(c.gray(`  \u2192 ${emptyHint}`));
           return;
         }
         if (typeof res.total === "number") {
@@ -2523,7 +2506,7 @@ function normaliseDep(entry, idx) {
     }
     return {
       full_slug: m[1],
-      version_range: (m[3] ?? "*").trim()
+      version_range: (m[4] ?? "*").trim()
     };
   }
   if (typeof entry === "object" && entry !== null) {
@@ -3798,28 +3781,44 @@ function parseUsername(raw) {
 
 // src/lib/parse-slug-version.ts
 var SUFFIX_CHARS = /[\^~*]/;
+function slugError(message, hint) {
+  const e = new Error(message);
+  e.hint = hint;
+  return e;
+}
 function parseSlugAtVersion(raw) {
   if (!raw.includes("/")) {
+    let username2;
     try {
-      const username2 = parseUsername(raw);
-      throw new Error(
-        `"${raw}" looks like a username, not a package \u2014 try \`kordis profile ${username2}\` for user details, or pass a full slug like "{username}/{slug}".`
+      username2 = parseUsername(raw);
+    } catch {
+      username2 = void 0;
+    }
+    if (username2) {
+      throw slugError(
+        `"${raw}" looks like a username, not a package`,
+        `Try \`kordis profile ${username2}\` for user details, or pass a full slug like "{username}/{slug}".`
       );
-    } catch (err) {
-      if (err instanceof Error) throw err;
-      throw new Error(`"${raw}" is missing the "{username}/{slug}" form`);
     }
+    throw slugError(
+      `"${raw}" is missing the "{username}/{slug}" form`,
+      'Use the form "{username}/{slug}", e.g. "alice/json-pretty".'
+    );
   }
   const atIdx = raw.indexOf("@");
   const slugPart = atIdx === -1 ? raw : raw.slice(0, atIdx);
   const versionPart = atIdx === -1 ? "" : raw.slice(atIdx + 1);
   const [username, slug] = slugPart.split("/");
   if (!username || !slug) {
-    throw new Error('full_slug must be "{username}/{slug}"');
+    throw slugError(
+      'full_slug must be "{username}/{slug}"',
+      'Pass both parts, e.g. "alice/json-pretty". Browse with `kordis search` if unsure.'
+    );
   }
   if (atIdx !== -1 && versionPart.length === 0) {
-    throw new Error(
-      `"${raw}" has a trailing "@" with no version \u2014 drop the "@" or pass a version/range after it`
+    throw slugError(
+      `"${raw}" has a trailing "@" with no version`,
+      `Drop the "@" or append a version/range, e.g. "${slugPart}@1.0.0" or "${slugPart}@^1".`
     );
   }
   const out = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rayul/kordis",
-  "version": "0.10.3",
+  "version": "0.11.0",
   "private": false,
   "description": "Command-line client for the Kordis registry — discover, install, and publish agentic-coding packages.",
   "license": "MIT",