@minnovate/shadow-publisher 0.17.2 → 0.17.3

package/dist/claude/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "git-publisher",
   "displayName": "Git Publisher",
-  "version": "0.17.2",
+  "version": "0.17.3",
   "description": "Publish an app folder's Git history to the serverless Git publishing backend and keep it updated (\"publish my app\", \"update my app\", \"fetch the engineered version\").",
   "author": { "name": "git-publisher project" },
   "keywords": ["git", "publish", "deploy", "serverless"]

package/dist/claude/plugin/skills/publish-app/SKILL.md

@@ -203,6 +203,8 @@ following, for when the person asks not to wait.
     moment between the merge and the publish. Run `publisher sync . --json` once more
     (`publication.next.command` says the same).
   - `REF_FORBIDDEN`: the user may not publish this branch; tell them which branch and stop.
+    When it comes as `error.code` with a `hint`, a limit of the organization refused it: tell them
+    the reason and whom to ask that the `hint` gives, and stop.
   - `MISSING_OBJECTS`: the local copy is incomplete (for example a shallow clone). Tell the user to
     publish from a complete copy: `publisher checkout <new folder> --repo <id>`.
   - `LIMIT_EXCEEDED`, `PACK_INVALID`: quote the message; suggest removing very large files from the

package/dist/claude/plugin/skills/sync-app/SKILL.md

@@ -50,7 +50,8 @@ publisher answer <question id>=<value> --json
 
 A value that is not an option is refused before anything is sent; `error.details.questions` lists
 the choices. Exit 4 means this sign-in may not answer (an owner or admin can, or the app's creator for the
-first preparation after an adoption); exit 3 means ask
+first preparation after an adoption); when it carries a `hint`, a limit refused it, so tell them the reason
+and whom to ask that the `hint` gives. Exit 3 means ask
 again. Then `publisher follow . --publication <id> --until-change --timeout 100 --json` to see it go live, telling them each step as `publish-app` step 4 says.
 
 ## When it did not go live because of a fault on our side

package/dist/publisher.cjs

@@ -226,7 +226,7 @@ var PublisherError = class _PublisherError extends Error {
   }
 };
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/util.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/util.js
 function getEnumValues(entries) {
   const numericValues = Object.values(entries).filter((v) => typeof v === "number");
   const values = Object.entries(entries).filter(([k, _]) => numericValues.indexOf(+k) === -1).map(([_, v]) => v);
@@ -461,6 +461,18 @@ function prefixIssues(path, issues) {
 function unwrapMessage(message) {
   return typeof message === "string" ? message : message?.message;
 }
+function sizeCaps(defChecks) {
+  const caps = [];
+  for (const ch of defChecks ?? []) {
+    const d = ch._zod.def;
+    if (!/_(length|size)$|_equals$/.test(d.check))
+      break;
+    const max = d.maximum ?? d.length ?? d.size;
+    if (max >= 0)
+      caps.push([max, ch]);
+  }
+  return caps;
+}
 function attachSchema(issues, start2, inst) {
   var _a2;
   for (let i = start2; i < issues.length; i++) {
@@ -636,7 +648,7 @@ function installLazyProp(inst, key, make, enumerable) {
   });
 }
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/core.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/core.js
 var _a;
 var _zodDesc = { value: void 0, enumerable: false };
 var _E = "captureStackTrace" in Error ? Error : null;
@@ -748,7 +760,7 @@ function config(newConfig) {
   return globalConfig;
 }
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/errors.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/errors.js
 function _getMessage() {
   const internals = this._zod;
   internals.message ?? (internals.message = JSON.stringify(internals.def, jsonStringifyReplacer, 2));
@@ -793,7 +805,7 @@ var $ZodRealError = $constructor("$ZodError", initializer, void 0, {
   Parent: Error
 });
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/parse.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/parse.js
 var _parse = (_Err) => {
   const fn = (schema, value, _ctx, _params) => {
     const ctx = _ctx ? { ..._ctx, async: false } : { async: false };
@@ -864,7 +876,7 @@ var _safeParseAsync = (_Err) => async (schema, value, _ctx) => {
 };
 var safeParseAsync = /* @__PURE__ */ _safeParseAsync($ZodRealError);
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/regexes.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/regexes.js
 var duration = /^P(?:(\d+W)|(?!.*W)(?=\d|T\d)(\d+Y)?(\d+M)?(\d+D)?(T(?=\d)(\d+H)?(\d+M)?(\d+([.,]\d+)?S)?)?)$/;
 var httpProtocol = /^https?$/;
 var dateSource = `(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))`;
@@ -892,7 +904,7 @@ var anyString = /^[\s\S]{0,}$/;
 var number = /^-?\d+(?:\.\d+)?$/;
 var boolean = /^(?:true|false)$/i;
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/checks.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/checks.js
 var $ZodCheck = /* @__PURE__ */ $constructor("$ZodCheck", (inst, def) => {
   var _a2;
   inst._zod ?? (inst._zod = {});
@@ -1081,14 +1093,14 @@ var $ZodCheckRegex = /* @__PURE__ */ $constructor("$ZodCheckRegex", (inst, def)
   };
 });
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/versions.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/versions.js
 var version = {
   major: 4,
   minor: 6,
-  patch: 5
+  patch: 7
 };
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/schemas.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/schemas.js
 var $ZodType = /* @__PURE__ */ $constructor("$ZodType", (inst, def) => {
   var _a2;
   inst ?? (inst = {});
@@ -1423,6 +1435,29 @@ var $ZodUnknown = /* @__PURE__ */ $constructor("$ZodUnknown", (inst, def) => {
   $ZodType.init(inst, def);
   inst._zod.parse = (payload) => payload;
 });
+function capSize(inst, size) {
+  const caps = sizeCaps(inst._zod.def.checks);
+  if (!caps.length)
+    return;
+  const cap = Math.min(...caps.map((c) => c[0]));
+  const parse3 = inst._zod.parse;
+  inst._zod.parse = (payload, ctx) => {
+    const n = size(payload.value);
+    if (n > cap && !ctx?.skipChecks && ctx?.direction !== "backward") {
+      for (const [max, ch] of sizeCaps(inst._zod.def.checks)) {
+        if (n > max && ch._zod.def.when(payload)) {
+          const start2 = payload.issues.length;
+          ch._zod.check(payload);
+          payload.issues[start2].continue = false;
+          attachSchema(payload.issues, start2, inst);
+          return payload;
+        }
+      }
+    }
+    return parse3(payload, ctx);
+  };
+}
+var arraySize = (input) => Array.isArray(input) ? input.length : -1;
 function handleArrayResult(result, final, index) {
   if (result.issues.length) {
     final.issues.push(...prefixIssues(index, result.issues));
@@ -1466,6 +1501,7 @@ var $ZodArray = /* @__PURE__ */ $constructor("$ZodArray", (inst, def) => {
     }
     return payload;
   };
+  capSize(inst, arraySize);
 });
 function handlePropertyResult(result, final, key, input, optin, optout) {
   const isPresent = key in input;
@@ -2098,7 +2134,7 @@ function handleRefineResult(result, payload, input, inst) {
   }
 }
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/locales/en.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/locales/en.js
 var error = () => {
   const Sizable = {
     string: { unit: "characters", verb: "to have" },
@@ -2223,7 +2259,7 @@ function en_default() {
   };
 }
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/api.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/core/api.js
 function snapshotChecks(def) {
   if (def.checks)
     def.checks = [...def.checks];
@@ -2369,7 +2405,7 @@ function _refine(Class, fn, _params) {
   return schema;
 }
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/mini/schemas.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/mini/schemas.js
 var ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def) => {
   if (!inst._zod)
     throw new Error("Uninitialized schema in ZodMiniType.");
@@ -2614,7 +2650,7 @@ function refine(fn, _params = {}) {
   return _refine(ZodMiniCustom, fn, _params);
 }
 
-// ../../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/mini/iso.js
+// ../../../../node_modules/.pnpm/zod@4.6.7/node_modules/zod/v4/mini/iso.js
 var iso_exports = {};
 __export(iso_exports, {
   ZodMiniISODate: () => ZodMiniISODate,
@@ -5235,6 +5271,16 @@ function portalRefusalCode(body) {
   const { code, message } = error2;
   return typeof code === "string" && code !== "" && typeof message === "string" ? code : null;
 }
+function portalRefusalLimit(body) {
+  const error2 = isRecord(body) ? body["error"] : null;
+  const details = isRecord(error2) ? error2["details"] : null;
+  if (!isRecord(details)) {
+    return null;
+  }
+  const text = (value) => typeof value === "string" && value !== "" ? value : null;
+  const limit = { permission: text(details["permission"]), reason: text(details["reason"]), contact: text(details["contact"]) };
+  return limit.permission === null && limit.reason === null && limit.contact === null ? null : limit;
+}
 
 // ../client/src/application.ts
 var APPLICATION_CREATION = "application-creation";
@@ -5258,7 +5304,12 @@ async function createApplication(input, opts) {
       throw new PublisherError("UNAUTHORIZED", 'the portal did not accept this credential; run "publisher login" again');
     }
     if (answer2.status === 403) {
-      throw new PublisherError("FORBIDDEN", answer2.merged ?? `the portal refused to make an application here (${code || "forbidden"})`);
+      const limit = portalRefusalLimit(answer2.body);
+      throw new PublisherError(
+        "FORBIDDEN",
+        answer2.merged ?? `the portal refused to make an application here (${limit?.permission ?? (code || "forbidden")})`,
+        limit === null ? {} : { details: limit }
+      );
     }
     if (answer2.status === 409 && REFUSALS[code] !== void 0) {
       throw new PublisherError(REFUSALS[code], `the portal refused the repository (${code})`, { details: { portal: code } });
@@ -5491,7 +5542,7 @@ async function followRun(input, opts) {
       return { kind: "unavailable", reason: "no-route" };
     }
     if (answer2.status === 403) {
-      return { kind: "forbidden", say: answer2.merged };
+      return { kind: "forbidden", say: answer2.merged, limit: portalRefusalLimit(answer2.body) };
     }
     if (answer2.status === 200) {
       const run2 = soleRun(answer2.body);
@@ -5601,7 +5652,7 @@ async function call(input, opts, body) {
     return { kind: "unauthorized" };
   }
   if (answer2.status === 403) {
-    return { kind: "forbidden", say: answer2.merged };
+    return { kind: "forbidden", say: answer2.merged, limit: portalRefusalLimit(answer2.body) };
   }
   if (answer2.status === 409) {
     return { kind: "moved-on" };
@@ -5706,7 +5757,7 @@ async function runCreatorTool(input, opts) {
     return { kind: "unauthorized" };
   }
   if (answer2.status === 403) {
-    return { kind: "forbidden", say: answer2.merged };
+    return { kind: "forbidden", say: answer2.merged, limit: portalRefusalLimit(answer2.body) };
   }
   if (answer2.status === 404) {
     return { kind: "unavailable", detail: "the portal does not serve this tool" };
@@ -6997,6 +7048,26 @@ async function discoverEndpoint(portal, fetchImpl = fetch) {
   return endpoint;
 }
 
+// src/limited.ts
+var REFUSED = /* @__PURE__ */ new Set(["REF_FORBIDDEN", "FORBIDDEN"]);
+var Limited = class _Limited {
+  /** The lines for a refusal with `code` and `details`, or null when it is not a permission's or names no reason and no contact. */
+  static hint(code, details) {
+    const lines = REFUSED.has(code) ? _Limited.lines(details) : [];
+    return lines.length === 0 ? null : lines.join("\n  ");
+  }
+  /** The same words in one line, for a sentence that a 403 ends, such as the one `follow` relays; '' for none. */
+  static inline(details) {
+    return _Limited.lines(details).join(" ");
+  }
+  static lines(details) {
+    const text = (value) => typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+    const reason = text(details?.["reason"]);
+    const contact = text(details?.["contact"]);
+    return [reason === null ? null : `The organization's reason: ${reason}`, contact === null ? null : `Ask ${contact}.`].filter((line) => line !== null);
+  }
+};
+
 // src/portal.ts
 var confirmed = /* @__PURE__ */ new Map();
 async function confirmedPortal(endpoint, opts = {}) {
@@ -7235,8 +7306,11 @@ function progressHint(r, portal, answerable = false) {
       return inPortal(portal, "Published. This portal cannot show progress in the terminal yet.", "Follow it");
     case "unauthorized":
       return inPortal(portal, "Published, but the portal did not accept this sign-in (run publisher login).", "Follow it");
-    case "forbidden":
-      return inPortal(portal, r.say === null ? "Published, but the portal would not show this sign-in the run." : `Published. ${r.say}`, "Follow it");
+    case "forbidden": {
+      const limited = Limited.inline(r.limit);
+      const lead = r.say === null ? "Published, but the portal would not show this sign-in the run." : `Published. ${r.say}`;
+      return inPortal(portal, limited === "" ? lead : `${lead} ${limited}`, "Follow it");
+    }
     case "malformed":
       return inPortal(portal, `Published, but the portal's answer about the run could not be read (${r.detail}).`, "Follow it");
   }
@@ -7922,7 +7996,7 @@ async function questionAt(p, endpoint, repoId, opts = {}) {
   if ("reason" in at) {
     return at;
   }
-  return shown(at.portal, await p.readPreparation({ portal: at.portal, repoId }));
+  return shown(at.portal, await p.readPreparation({ portal: at.portal, repoId }), REFUSED2.read);
 }
 async function answerAt(p, endpoint, repoId, specs, opts = {}) {
   const answers = parseSpecs(specs);
@@ -7930,7 +8004,7 @@ async function answerAt(p, endpoint, repoId, specs, opts = {}) {
   if ("reason" in at) {
     return at;
   }
-  const read2 = shown(at.portal, await p.readPreparation({ portal: at.portal, repoId }));
+  const read2 = shown(at.portal, await p.readPreparation({ portal: at.portal, repoId }), REFUSED2.read);
   if (read2.kind !== "view") {
     return read2;
   }
@@ -7949,7 +8023,7 @@ async function answerAt(p, endpoint, repoId, specs, opts = {}) {
       throw new PublisherError("INVALID_REQUEST", `"${value}" is not one of ${values.join(", ")} for "${id}"`, { details: { questions: read2.questions } });
     }
   }
-  return shown(at.portal, await p.answerPreparation({ portal: at.portal, repoId, id: read2.preparation.id, revision: read2.preparation.revision, answers }));
+  return shown(at.portal, await p.answerPreparation({ portal: at.portal, repoId, id: read2.preparation.id, revision: read2.preparation.revision, answers }), REFUSED2.answer);
 }
 async function retryAt(p, endpoint, repoId, opts = {}) {
   const read2 = await questionAt(p, endpoint, repoId, opts);
@@ -7962,7 +8036,7 @@ async function retryAt(p, endpoint, repoId, opts = {}) {
   if (!read2.preparation.canRetry) {
     throw new PublisherError("LOCAL_STATE", "this version cannot be tried again: only one that stopped because of a fault on our side can, three times at most");
   }
-  const tried = shown(read2.portal, await p.retryPreparation({ portal: read2.portal, repoId, id: read2.preparation.id, revision: read2.preparation.revision }));
+  const tried = shown(read2.portal, await p.retryPreparation({ portal: read2.portal, repoId, id: read2.preparation.id, revision: read2.preparation.revision }), REFUSED2.retry);
   return tried.kind === "view" ? { ...tried, hint: "It is being tried again. Run: publisher follow, or watch it in the portal." } : tried;
 }
 function parseSpecs(specs) {
@@ -7995,7 +8069,12 @@ async function portalAt(endpoint, opts) {
       };
   }
 }
-function shown(portal, r) {
+var REFUSED2 = {
+  read: "the portal will not show this sign-in the preparation in this organization",
+  answer: "the portal will not let this sign-in answer for this organization (an owner or admin can, or the app's creator for the first preparation after an adoption)",
+  retry: "the portal will not let this sign-in try it again in this organization (an owner or admin can, or the app's creator, except for the first preparation after an adoption)"
+};
+function shown(portal, r, refused) {
   switch (r.kind) {
     case "view": {
       const { questions, ...preparation } = r.view;
@@ -8008,10 +8087,7 @@ function shown(portal, r) {
     case "unauthorized":
       throw new PublisherError("UNAUTHORIZED", "the portal did not accept this sign-in; run publisher login");
     case "forbidden":
-      throw new PublisherError(
-        "FORBIDDEN",
-        r.say ?? "the portal will not let this sign-in answer for this organization (an owner or admin can, or the app's creator for the first preparation after an adoption)"
-      );
+      throw new PublisherError("FORBIDDEN", r.say ?? refused, r.limit === null ? {} : { details: r.limit });
     case "unavailable":
       throw new PublisherError("UNAVAILABLE", `the portal could not be asked: ${r.detail}`, { retryable: true });
     case "malformed":
@@ -8094,7 +8170,11 @@ async function creatorTool(p, endpoint, tool, args, opts = {}) {
     case "unauthorized":
       throw new PublisherError("UNAUTHORIZED", "the portal did not accept this sign-in; run publisher login");
     case "forbidden":
-      throw new PublisherError("FORBIDDEN", result.say ?? "the portal will not let this sign-in do that in this organization");
+      throw new PublisherError(
+        "FORBIDDEN",
+        result.say ?? "the portal will not let this sign-in do that in this organization",
+        result.limit === null ? {} : { details: result.limit }
+      );
     case "unavailable":
       throw new PublisherError("UNAVAILABLE", `the portal could not be asked: ${result.detail}`, { retryable: true });
     case "malformed":
@@ -8667,7 +8747,7 @@ main(process.argv.slice(2)).then(
   (e) => {
     const json = process.argv.includes("--json");
     if (e instanceof PublisherError) {
-      const moved = Moved.hint(e.code, e.details);
+      const moved = Moved.hint(e.code, e.details) ?? Limited.hint(e.code, e.details);
       const payload = { error: { code: e.code, message: e.message, retryable: e.retryable, details: e.details ?? null }, ...moved === null ? {} : { hint: moved } };
       const hint = e.code === "NETWORK" ? `
   if this folder's service moved, "publisher doctor" says where to` : moved === null ? "" : `

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minnovate/shadow-publisher",
-  "version": "0.17.2",
+  "version": "0.17.3",
   "description": "publisher: publish an app's Git history to the serverless Git backend",
   "license": "Apache-2.0",
   "type": "module",