@rayul/kordis 0.9.1 → 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;
@@ -2977,9 +2994,13 @@ function pushCommand() {
               await bundle.api.getPackage(u, s2);
             } catch (err) {
               if (err && typeof err === "object" && "code" in err && err.code === "not_found") {
-                throw new Error(
-                  `--bump ${explicitBump} cannot apply to a first publish (no existing version to bump from). First publish derives version from frontmatter \`version:\` or defaults to "0.1.0". Drop --bump (or set frontmatter version explicitly), then re-run.`
-                );
+                throw new KordisApiError(400, {
+                  error: {
+                    code: "usage_error",
+                    message: `--bump ${explicitBump} cannot apply to a first publish (no existing version to bump from)`,
+                    hint: 'First publish derives version from frontmatter `version:` or defaults to "0.1.0". Drop --bump (or set frontmatter version explicitly), then re-run.'
+                  }
+                });
               }
             }
           }
@@ -3852,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);
@@ -3972,13 +3993,14 @@ function readCommand() {
     async (rawSlug, opts) => {
       const parsed = parseSlugAtVersion(rawSlug);
       const pin = opts.pin ?? parsed.version ?? parsed.range;
+      const pinIsRange = pin ? /[\^~*]/.test(pin) : false;
       const bundle = await useClient();
       let resolvedVersion;
-      if (parsed.range && !opts.pin) {
+      if (pin && pinIsRange) {
         const resolved = await bundle.api.resolveVersion(
           parsed.username,
           parsed.slug,
-          parsed.range
+          pin
         );
         resolvedVersion = resolved.resolved_version;
       }
@@ -4004,7 +4026,7 @@ function readCommand() {
 `);
         }
       }
-      const resolvedNote = parsed.range && resolvedVersion ? ` ${c.gray("(resolved")} ${c.gray("@" + parsed.range)} ${c.gray("\u2192")} ${resolvedVersion}${c.gray(")")}` : "";
+      const resolvedNote = pinIsRange && resolvedVersion ? ` ${c.gray("(resolved")} ${c.gray("@" + pin)} ${c.gray("\u2192")} ${resolvedVersion}${c.gray(")")}` : "";
       process.stderr.write(
         `${c.gray("\u2014")} ${c.bold(res.full_slug)}${c.gray("@")}${res.version}${resolvedNote} ${c.gray("\xB7")} ${res.type} (tier ${res.tier}) ${c.gray("\xB7")} ${c.cyan(res.attribution)}
 `

package/package.json

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