@rayul/kordis 0.9.2 → 0.9.3

package/assets/kordis-using/SKILL.md

@@ -111,6 +111,7 @@ Supported forms:
 | `user/foo@1.0.0-beta.1`            | exact prerelease (only matches if the literal exists)            |
 | `user/foo@^1.2`                    | caret — highest 1.x.y (x≥2). For 0.x.y, caret pins the minor   |
 | `user/foo@~1.2`                    | tilde — highest 1.2.y                                            |
+| `user/foo@0.1.x`                   | x-range — alias for `~0.1` (0.9.3+; semver-native)               |
 | `user/foo@*`                       | alias for `current_version`                                      |
 
 Comparator strings (`>=1 <2`, `||`) are NOT supported in 0.9.x —

package/dist/index.js

@@ -1101,6 +1101,8 @@ var init_client = __esm({
         if (opts.body !== void 0) init.body = JSON.stringify(opts.body);
         const method = (init.method ?? "GET").toUpperCase();
         const retryable = method === "GET";
+        const debug = typeof process !== "undefined" && process.env && (process.env["KORDIS_DEBUG"] === "1" || process.env["KORDIS_DEBUG"]?.toLowerCase() === "true");
+        const debugStart = debug ? Date.now() : 0;
         let lastErr;
         for (let attempt = 0; attempt < (retryable ? 2 : 1); attempt++) {
           try {
@@ -1110,12 +1112,22 @@ var init_client = __esm({
           } catch (err) {
             lastErr = err;
             if (attempt === 0 && retryable) {
+              if (debug) {
+                console.error(
+                  `[kordis] api: ${method} ${url.pathname}${url.search} \u2192 fetch failed, retrying in 150ms (${err.message})`
+                );
+              }
               await new Promise((resolve2) => setTimeout(resolve2, 150));
               continue;
             }
           }
         }
         if (lastErr !== void 0) {
+          if (debug) {
+            console.error(
+              `[kordis] api: ${method} ${url.pathname}${url.search} \u2192 ${lastErr.message} (${Date.now() - debugStart}ms)`
+            );
+          }
           throw new KordisNetworkError(
             `cannot reach ${url.hostname}: ${lastErr.message}`,
             lastErr
@@ -1123,6 +1135,11 @@ var init_client = __esm({
         }
         res = res;
         const requestId = res.headers.get("x-request-id") ?? void 0;
+        if (debug) {
+          console.error(
+            `[kordis] api: ${method} ${url.pathname}${url.search} \u2192 ${res.status} (${Date.now() - debugStart}ms${requestId ? `, req-id=${requestId}` : ""})`
+          );
+        }
         if (res.status === 204) return void 0;
         const text = await res.text();
         const parsed = text ? JSON.parse(text) : void 0;
@@ -3856,10 +3873,10 @@ function pullCommand() {
   ).option(
     "--no-with-required",
     "skip transitive required dependencies (advanced; default is to install)"
-  ).action(
+  ).option("--pin <semver>", "pin to an exact version or range (overrides @suffix)").action(
     async (fullSlugArg, opts) => {
       const parsed = parseSlugAtVersion(fullSlugArg);
-      const pin = parsed.version ?? parsed.range;
+      const pin = opts.pin ?? parsed.version ?? parsed.range;
       const userCwd = process.env["INIT_CWD"] ?? process.cwd();
       const installRoot = opts.target ?? userCwd;
       const detected = opts.tool ?? await detectTool(installRoot);

package/package.json

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