@minnovate/shadow-publisher 0.14.0 → 0.15.0

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

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

@@ -29,7 +29,7 @@ publisher --version
 ```
 
 If the command is not found, or the version is older than 0.11.0, install it:
-`npm install -g @minnovate/shadow-publisher@latest` (it needs Node.js 22). In a Claude Cowork task
+`npm install -g @minnovate/shadow-publisher@latest` (it needs Node.js 22.12 or a later 22). In a Claude Cowork task
 this is normal: the sandbox starts empty every time, so install it without asking. On the person's
 own computer, say in one line that you are installing the publisher. If `npm` itself is missing,
 tell them Node.js 22 must be installed first, and stop.
@@ -142,6 +142,13 @@ in its folder. The checks refuse an app that does not (see "When the checks find
 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.
 
+An app is one folder in one of three shapes: static files with `index.html` at the root, a
+standard-library Python `app.py`, or a Node.js `server.mjs` beside a `package.json` of exactly
+`{"type":"module","scripts":{"start":"node server.mjs"}}`. It has no build step and no npm or pip
+dependencies. Only .html .js .mjs .py .css .csv .json .svg .txt files are part of the app: any
+other file, such as an image, an icon or a font, is left out, so draw images as SVG and use system
+font stacks.
+
 ## 4. Telling them how it goes, step by step
 
 After a publish, the app goes through four steps: **received**, **checked**, **going live**,
@@ -214,8 +221,8 @@ sentence, and `progress.next.action` is `"fix"`. Then:
 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
-     folder and point to it with a relative path — only if it is at most 4 MB; a charting
-     library usually is not (Chart.js is 201 KB). Otherwise replace it with code of your own: a
+     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.
    - `console-error` / `application-error`: fix the code that logs or throws `message`.

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 };
@@ -7153,7 +7162,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.";
       }

package/package.json

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