@minnovate/shadow-publisher 0.14.1 → 0.15.1

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

@@ -1,7 +1,7 @@
 {
   "name": "git-publisher",
   "displayName": "Git Publisher",
-  "version": "0.14.1",
+  "version": "0.15.1",
   "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

@@ -136,9 +136,9 @@ fast-forward or a clean merge — it never rewrites the user's work), and publis
 them when the person asks why it was slow. Write
 the message in the user's words ("Add a contact page"), not git's.
 
-A published app runs with no internet access: **it may not load anything from other sites** — no
-CDN scripts, web fonts or remote images. When you write or change an app, keep every file it needs
-in its folder. The checks refuse an app that does not (see "When the checks find something").
+A published app runs with no internet access: **apps can’t load anything from other sites** — no
+CDN scripts, web fonts or remote images — and can’t call other sites for data: connect the data as
+a data source instead. When you write or change an app, keep every file it needs in its folder. The checks refuse an app that does not (see "When the checks find something").
 Keep it small too: each file at most 4 MB, the whole app at most 10 MB, at most 500 files —
 a larger app is refused before it is checked, and the refusal names the file or the limit it broke.
 
@@ -220,11 +220,17 @@ sentence, and `progress.next.action` is `"fix"`. Then:
    Their original app is still what is published; nothing broke.
 2. Fix every finding in the app folder, by its `kind`:
    - `external-resource`: the app loads `url` from another site (a CDN script, Google Fonts, an
-     image). **Apps may not load anything from other sites.** Download the file into the app
+     image). **Apps can’t load anything from other sites.** Download the file into the app
      folder and point to it with a relative path, if it is at most 4 MB (a charting library
      such as Chart.js, about 200 KB, fits). Otherwise replace it with code of your own: a
      font falls back to a system font stack, a chart is drawn as inline SVG. Never keep the
      external address.
+   - `external-request`: the app CALLS `url` on another site for data (`fetch`, an API).
+     **Apps can't reach other sites.** Do not copy anything: remove the call, or bring the data
+     into the app as a data source (the `data_sources` tool, or `publisher data add`), and read
+     it from there.
+   - `server-start`: the app's server stopped before it answered `/`. `message` is the error it
+     printed and where. Fix that line, and run the server with `PORT` set to try it.
    - `console-error` / `application-error`: fix the code that logs or throws `message`.
    - `failed-request`: the app asks for `path` on its own site and gets `status`; add the file or
      stop requesting it.

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

@@ -42,6 +42,17 @@ A value that is not an option is refused before anything is sent; `error.details
 the choices. Exit 4 means this sign-in may not answer (an owner or admin can); 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
+
+When `publisher question . --json` shows a `blocked` preparation whose `message` says the fault
+was on our side, not in the app, do not change the app. Try it again once:
+
+```bash
+publisher retry . --json
+```
+
+Then follow it again. If it fails a second time, tell the person, and give them the portal page.
+
 ## After it is live
 
 These run in the app's folder and answer `say` (tell the person) and `next` (what to do now):

package/dist/publisher.cjs

@@ -5417,6 +5417,16 @@ function ending(stages) {
   return "stopped";
 }
 var POLL_INTERVAL_MS = 5e3;
+var MAX_REASON = 1e3;
+function settled(run2, stages, end) {
+  const runId = isRecord(run2) && typeof run2["runId"] === "string" ? run2["runId"] : null;
+  const failedAt = stages.find((s) => s.state === "failed")?.word ?? null;
+  return { kind: "settled", ending: end, failedAt, stages, runId, reason: reasonOf(run2, end) };
+}
+function reasonOf(run2, end) {
+  const summary = isRecord(run2) ? run2["summary"] : null;
+  return end === "failed" && typeof summary === "string" && summary.trim() !== "" ? summary.trim().slice(0, MAX_REASON) : null;
+}
 var FOLLOW_TIMEOUT_MS = 15 * 6e4;
 async function followRun(input, opts) {
   const portal = new PortalSession(opts);
@@ -5469,8 +5479,7 @@ async function followRun(input, opts) {
         }
         const end = ending(read2.stages);
         if (end !== null) {
-          const runId = isRecord(run2.run) && typeof run2.run["runId"] === "string" ? run2.run["runId"] : null;
-          return { kind: "settled", ending: end, failedAt: read2.stages.find((s) => s.state === "failed")?.word ?? null, stages: read2.stages, runId };
+          return settled(run2.run, read2.stages, end);
         }
         if (opts.untilChange === true && moved && answered) {
           return { kind: "moving", stages: read2.stages };
@@ -5540,6 +5549,9 @@ function readPreparation(input, opts) {
 function answerPreparation(input, opts) {
   return call(input, opts, { id: input.id, revision: input.revision, action: "answers", answers: input.answers });
 }
+function retryPreparation(input, opts) {
+  return call(input, opts, { id: input.id, revision: input.revision, action: "retry" });
+}
 async function call(input, opts, body) {
   const url2 = `${input.portal.replace(/\/+$/, "")}/api/v1/terminal/repositories/${encodeURIComponent(input.repoId)}/preparation`;
   const answer2 = await new PortalSession(opts).ask(url2, body);
@@ -5599,7 +5611,16 @@ function readView(body) {
   if (isRecord(publication) && typeof publication["status"] === "string" && typeof publication["message"] === "string") {
     pub = { status: publication["status"], message: publication["message"], ...typeof publication["url"] === "string" ? { url: publication["url"] } : {} };
   }
-  return { id, revision, status: status2, message, questions: read2, publication: pub, findings: readFindings(body["findings"]) };
+  return {
+    id,
+    revision,
+    status: status2,
+    message,
+    questions: read2,
+    publication: pub,
+    findings: readFindings(body["findings"]),
+    canRetry: body["canRetry"] === true
+  };
 }
 function readFindings(value) {
   if (!Array.isArray(value)) {
@@ -6445,6 +6466,10 @@ var Publisher = class {
   async answerPreparation(input) {
     return answerPreparation(input, this.portalCall());
   }
+  /** The repository's current preparation tried again, when it could not finish because of a fault on our side. */
+  async retryPreparation(input) {
+    return retryPreparation(input, this.portalCall());
+  }
   /**
    * One of the creator's tools at the portal that serves this endpoint — starters, status, history,
    * going back, suggestions, sharing — with this publisher's credential and its one refresh. The
@@ -7080,7 +7105,7 @@ async function followPublication(p, endpoint, o, opts) {
     return {
       ...outcome2,
       portal,
-      hint: `It did not pass its checks (${findings.length === 1 ? "one finding" : `${findings.length} findings`}). Fix each finding in the app folder, then run next.command to publish again.`,
+      hint: `It didn\u2019t pass its checks (${findings.length === 1 ? "one finding" : `${findings.length} findings`}). Fix each finding in the app folder, then run next.command to publish again.`,
       findings,
       next: { action: "fix", command: `publisher sync ${dir} --until-change --json` }
     };
@@ -7153,7 +7178,7 @@ function progressHint(r, portal, answerable = false) {
         case "not-deployed":
           return "Published and checked; this organisation does not deploy automatically.";
         case "failed":
-          return inPortal(portal, `It stopped at "${r.failedAt ?? "a step"}".`, "See why");
+          return inPortal(portal, `It stopped at "${r.failedAt ?? "a step"}".${r.reason === null ? "" : ` ${r.reason}`}`, r.reason === null ? "See why" : "See it");
         case "stopped":
           return "A newer publication replaced this one before it went live.";
       }
@@ -7865,6 +7890,20 @@ async function answerAt(p, endpoint, repoId, specs, opts = {}) {
   }
   return shown(at.portal, await p.answerPreparation({ portal: at.portal, repoId, id: read2.preparation.id, revision: read2.preparation.revision, answers }));
 }
+async function retryAt(p, endpoint, repoId, opts = {}) {
+  const read2 = await questionAt(p, endpoint, repoId, opts);
+  if (read2.kind !== "view") {
+    return read2;
+  }
+  if (read2.preparation.status !== "blocked") {
+    throw new PublisherError("LOCAL_STATE", `nothing to try again (the preparation is ${read2.preparation.status})`);
+  }
+  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 }));
+  return tried.kind === "view" ? { ...tried, hint: "It is being tried again. Run: publisher follow, or watch it in the portal." } : tried;
+}
 function parseSpecs(specs) {
   if (specs.length === 0) {
     throw new PublisherError("INVALID_REQUEST", "answer takes one or more question=value");
@@ -7951,6 +7990,16 @@ var question = {
     return 0;
   }
 };
+var retry = {
+  git: false,
+  async run(inv) {
+    const dir = inv.dirArg(1);
+    const { p, endpoint } = await inv.client(dir);
+    const repoId = await inv.repoId(dir);
+    inv.out({ repoId, ...await retryAt(p, endpoint, repoId) });
+    return 0;
+  }
+};
 var answer = {
   git: false,
   async run(inv) {
@@ -8441,6 +8490,8 @@ Usage:
                                                         with each option's value (answering needs owner or admin)
   publisher answer <question>=<value>... [--repo <id>]  answer it from this folder; a value that is not one of
                                                         the question's options is refused before anything is sent
+  publisher retry [dir] [--repo <id>]                   try the app's newest version again, when it did not go
+                                                        live because of a fault on our side (three tries at most)
   publisher starters [what you want to stop doing]      working apps to start from, the ones that fit first
   publisher start <starter> [--name <n>] [--replaces <what>]   a new app made from a starter, live in about a minute
   publisher history                                     this folder's app: the versions that went live, newest first
@@ -8497,6 +8548,7 @@ var COMMANDS = /* @__PURE__ */ new Map([
   ["follow", follow],
   ["question", question],
   ["answer", answer],
+  ["retry", retry],
   ["skills", skills],
   ["merge-check", mergeCheck2],
   ["info", info],

package/package.json

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