@rayul/kordis 0.3.0 → 0.3.1

package/dist/index.js

@@ -175,6 +175,7 @@ var init_errors = __esm({
       error: z3.object({
         code: ErrorCodeSchema,
         message: z3.string(),
+        hint: z3.string().optional(),
         flags: z3.array(ReviewFlagSchema).optional(),
         retry_after_seconds: z3.number().int().nonnegative().optional(),
         request_id: z3.string().optional()
@@ -728,6 +729,7 @@ var init_errors2 = __esm({
     KordisApiError = class extends Error {
       code;
       status;
+      hint;
       flags;
       retryAfter;
       requestId;
@@ -736,6 +738,7 @@ var init_errors2 = __esm({
         this.name = "KordisApiError";
         this.code = envelope.error.code;
         this.status = status;
+        this.hint = envelope.error.hint;
         this.flags = envelope.error.flags ?? [];
         this.retryAfter = envelope.error.retry_after_seconds;
         this.requestId = envelope.error.request_id ?? requestId;
@@ -1953,10 +1956,13 @@ function zodFail(issues) {
         hint = "description must be 1\u20132048 chars; current is too long. Move detail into the body.";
       } else if (field === "description" && msg.includes("small")) {
         hint = "description must be 1\u20132048 chars; provide a one-paragraph summary.";
+      } else if (field) {
+        hint = `Fix the value of frontmatter field "${field}" to match the schema. See the per-type spec under packages/harness-schema/src/types/ for the exact shape.`;
+      } else {
+        hint = "Fix the frontmatter to match the schema. See the per-type spec under packages/harness-schema/src/types/ for the exact shape.";
       }
-      const extra = {};
+      const extra = { hint };
       if (field) extra.field = field;
-      if (hint) extra.hint = hint;
       return flag("invalid_frontmatter", i.message, extra);
     })
   };
@@ -3745,6 +3751,7 @@ function handleError(err) {
         error: {
           code: err.code,
           message: err.message,
+          ...err.hint ? { hint: err.hint } : {},
           flags: err.flags,
           ...err.retryAfter !== void 0 ? { retry_after_seconds: err.retryAfter } : {},
           request_id: err.requestId
@@ -3752,6 +3759,11 @@ function handleError(err) {
       });
     } else {
       printHuman(c.red(`\u2717 ${err.code}: ${err.message}`));
+      if (err.hint) {
+        for (const line of err.hint.split("\n")) {
+          printHuman(c.gray(`  \u2192 ${line}`));
+        }
+      }
       for (const f of err.flags) {
         printHuman(c.red(`  - ${f.code}${f.message ? `: ${f.message}` : ""}`));
         if (f.hint) {

package/package.json

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