@rayul/kordis 0.4.0 → 0.5.0

package/assets/kordis-recommend/SKILL.md

@@ -95,6 +95,12 @@ Filter mentally by `confidence`. If everything is `low` and `personalized`
 is `false`, tell the user personalization is off and they can enable it
 via `kordis setup` (re-asks the prompt on next interactive run).
 
+If the response carries `capped_by_author > 0`, ALSO surface a one-line
+note to the user — e.g. "N more candidates from the same publisher were
+skipped by the diversity cap" — so they understand why the list is
+shorter than the requested `--limit`. Without this hint users frequently
+mistake a short menu for a sparse or broken registry.
+
 ### 3. Present
 Surface 3-5 picks max. For each, show: full_slug, one-line `why_recommended`,
 confidence wording per the table above, and the next-step

package/dist/index.js

@@ -802,7 +802,21 @@ var init_recommend = __esm({
        * the server returned popularity-only results — useful for agents to
        * disclose "context off → less personalised" to the user.
        */
-      personalized: z11.boolean()
+      personalized: z11.boolean(),
+      /**
+       * 0.5.0 — number of additional candidates the server had before applying
+       * the per-author cap. When `capped_by_author > 0`, the agent can explain
+       * "menu is shorter than --limit because diversity cap fired" instead of
+       * the user inferring the registry is sparse. Absent on responses from
+       * pre-0.5.0 servers.
+       */
+      capped_by_author: z11.number().int().nonnegative().optional(),
+      /**
+       * 0.5.0 — total number of candidates the server scored before any
+       * trimming/capping. Helps the agent surface "we picked N of M" honesty
+       * when the menu is short. Absent on pre-0.5.0 servers.
+       */
+      total_candidates: z11.number().int().nonnegative().optional()
     });
   }
 });
@@ -4179,7 +4193,7 @@ function recommendCommand() {
       if (!enable) {
         printHuman(
           c.gray(
-            "\u2192 recommendations will use popularity only. Re-enable later: `kordis context --enable`."
+            "\u2192 recommendations will use popularity only. Re-enable later: `kordis setup` (re-asks the opt-in)."
           )
         );
       }
@@ -4216,10 +4230,18 @@ function recommendCommand() {
             "\u2192 install any with `kordis pull <full_slug>` or peek with `kordis read <full_slug>`"
           )
         );
+        if (typeof res.capped_by_author === "number" && res.capped_by_author > 0) {
+          const extras = res.capped_by_author;
+          printHuman(
+            c.gray(
+              `\u2192 ${extras} more candidate${extras === 1 ? "" : "s"} from the same publisher${extras === 1 ? " was" : "s were"} skipped by the diversity cap`
+            )
+          );
+        }
         if (!res.personalized) {
           printHuman(
             c.gray(
-              "\u2192 enable personalization for better matches: `kordis context --enable`"
+              "\u2192 enable personalization for tailored picks: `kordis setup` (re-asks the opt-in)"
             )
           );
         }
@@ -4322,8 +4344,15 @@ function handleError(err) {
     process.exit(err.exitCode());
   }
   if (err instanceof KordisNetworkError) {
-    if (isJsonMode()) printJson({ error: { code: "network_unreachable", message: err.message } });
-    else printHuman(c.red(`\u2717 ${err.message}`));
+    const hint = "Check your network connection, or override the API endpoint with `KORDIS_API_URL=https://api.kordis.store` (or your self-hosted instance). If kordis.store itself is down, see https://kordis.store for status.";
+    if (isJsonMode()) {
+      printJson({
+        error: { code: "network_unreachable", message: err.message, hint }
+      });
+    } else {
+      printHuman(c.red(`\u2717 ${err.message}`));
+      for (const line of hint.split("\n")) printHuman(c.gray(`      \u2192 ${line}`));
+    }
     process.exit(err.exitCode());
   }
   if (err instanceof Error) {

package/package.json

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