austere-axi 0.6.0 → 0.7.0

package/dist/cli.mjs

@@ -618,7 +618,7 @@ var init_paths = __esm({
     HERE = path.dirname(fileURLToPath(import.meta.url));
     BUNDLED = true;
     ASSET_DIR = BUNDLED ? HERE : path.resolve(HERE, "../../dist");
-    VERSION = true ? "0.6.0" : packageVersion();
+    VERSION = true ? "0.7.0" : packageVersion();
     CLI_ENTRY = BUNDLED ? fileURLToPath(import.meta.url) : path.resolve(HERE, "main.ts");
     securedDir = null;
   }
@@ -1953,8 +1953,8 @@ __export(install_exports, {
   removePack: () => removePack,
   untar: () => untar
 });
-import fs10 from "node:fs";
-import path9 from "node:path";
+import fs11 from "node:fs";
+import path10 from "node:path";
 import zlib from "node:zlib";
 import crypto4 from "node:crypto";
 function registryUrl() {
@@ -2091,15 +2091,15 @@ function readTarball(tgz, label) {
   return { packJs, catalog, packageJson: files.get("package.json") || null };
 }
 function fromTarball(file3) {
-  const abs = path9.resolve(file3.replace(/^~(?=[\\/])/, process.env.HOME || ""));
-  if (!fs10.existsSync(abs)) throw new Error(`no such file: ${abs}`);
-  return { ...readTarball(fs10.readFileSync(abs), path9.basename(abs)), source: "tarball", resolved: abs };
+  const abs = path10.resolve(file3.replace(/^~(?=[\\/])/, process.env.HOME || ""));
+  if (!fs11.existsSync(abs)) throw new Error(`no such file: ${abs}`);
+  return { ...readTarball(fs11.readFileSync(abs), path10.basename(abs)), source: "tarball", resolved: abs };
 }
 function fromFolder(dir) {
-  const abs = path9.resolve(dir.replace(/^~(?=[\\/])/, process.env.HOME || ""));
-  if (!fs10.existsSync(abs)) throw new Error(`no such folder: ${abs}`);
-  if (fs10.statSync(abs).isFile()) return fromTarball(abs);
-  const read = (rel) => fs10.existsSync(path9.join(abs, rel)) ? fs10.readFileSync(path9.join(abs, rel)) : null;
+  const abs = path10.resolve(dir.replace(/^~(?=[\\/])/, process.env.HOME || ""));
+  if (!fs11.existsSync(abs)) throw new Error(`no such folder: ${abs}`);
+  if (fs11.statSync(abs).isFile()) return fromTarball(abs);
+  const read = (rel) => fs11.existsSync(path10.join(abs, rel)) ? fs11.readFileSync(path10.join(abs, rel)) : null;
   const packJs = read("dist/pack.js");
   const catalog = read("dist/catalog.json");
   if (!packJs || !catalog) throw new Error(`${abs} has no dist/pack.js and dist/catalog.json: run \`austere-axi components build ${dir}\` first`);
@@ -2139,10 +2139,10 @@ async function addPack(spec, { trust = false } = {}) {
   }
   const got = local ? fromFolder(spec) : await fromRegistry(spec);
   if (got.source === "tarball" && !trust) {
-    const peek = parseCatalog(got.catalog, path9.basename(got.resolved));
+    const peek = parseCatalog(got.catalog, path10.basename(got.resolved));
     throw Object.assign(
       new Error(
-        `${path9.basename(got.resolved)} (${peek.pack}) comes from a file, not the registry: its code would run inside your review pages. Rerun with --trust once you have looked at it.`
+        `${path10.basename(got.resolved)} (${peek.pack}) comes from a file, not the registry: its code would run inside your review pages. Rerun with --trust once you have looked at it.`
       ),
       { code: "untrusted" }
     );
@@ -2167,14 +2167,14 @@ async function addPack(spec, { trust = false } = {}) {
   }
   const lock = readLock();
   const previous = lock.packs[cat.pack];
-  const dir = path9.join(packsDir(), packDirName(cat.pack, cat.version));
-  fs10.rmSync(dir, { recursive: true, force: true });
-  fs10.mkdirSync(dir, { recursive: true });
-  fs10.writeFileSync(path9.join(dir, "pack.js"), got.packJs);
-  fs10.writeFileSync(path9.join(dir, "catalog.json"), got.catalog);
-  if (got.packageJson) fs10.writeFileSync(path9.join(dir, "package.json"), got.packageJson);
+  const dir = path10.join(packsDir(), packDirName(cat.pack, cat.version));
+  fs11.rmSync(dir, { recursive: true, force: true });
+  fs11.mkdirSync(dir, { recursive: true });
+  fs11.writeFileSync(path10.join(dir, "pack.js"), got.packJs);
+  fs11.writeFileSync(path10.join(dir, "catalog.json"), got.catalog);
+  if (got.packageJson) fs11.writeFileSync(path10.join(dir, "package.json"), got.packageJson);
   if (previous && previous.version !== cat.version) {
-    fs10.rmSync(path9.join(packsDir(), packDirName(cat.pack, previous.version)), { recursive: true, force: true });
+    fs11.rmSync(path10.join(packsDir(), packDirName(cat.pack, previous.version)), { recursive: true, force: true });
   }
   lock.packs[cat.pack] = {
     version: cat.version,
@@ -2194,7 +2194,7 @@ function removePack(name) {
   if (!entry) return null;
   delete lock.packs[name];
   writeLock(lock);
-  fs10.rmSync(path9.join(packsDir(), packDirName(name, entry.version)), { recursive: true, force: true });
+  fs11.rmSync(path10.join(packsDir(), packDirName(name, entry.version)), { recursive: true, force: true });
   return { name, version: entry.version };
 }
 var MAX_TARBALL, MAX_PACK_JS;
@@ -2215,8 +2215,8 @@ __export(pack_dev_exports, {
   buildPackDir: () => buildPackDir,
   newPack: () => newPack
 });
-import fs11 from "node:fs";
-import path10 from "node:path";
+import fs12 from "node:fs";
+import path11 from "node:path";
 import { createRequire } from "node:module";
 import { pathToFileURL } from "node:url";
 function packageJson(name) {
@@ -2253,9 +2253,9 @@ Publish with \`npm publish\` after \`npm run build\`. Others install it with
 }
 function newPack(dir, { name } = {}) {
   if (!dir) throw new Error("new needs a folder: austere-axi components new austere-pack-milestones");
-  const abs = path10.resolve(dir);
-  if (fs11.existsSync(abs) && fs11.readdirSync(abs).length) throw new Error(`${abs} is not empty`);
-  const pkgName = name || path10.basename(abs).toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
+  const abs = path11.resolve(dir);
+  if (fs12.existsSync(abs) && fs12.readdirSync(abs).length) throw new Error(`${abs} is not empty`);
+  const pkgName = name || path11.basename(abs).toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
   if (!isValidPackName(pkgName)) throw new Error(`${JSON.stringify(pkgName)} is not an npm package name; pass --name`);
   const files = {
     "package.json": JSON.stringify(packageJson(pkgName), null, 2) + "\n",
@@ -2264,13 +2264,13 @@ function newPack(dir, { name } = {}) {
     ...TEMPLATE
   };
   for (const [rel, text] of Object.entries(files)) {
-    fs11.mkdirSync(path10.dirname(path10.join(abs, rel)), { recursive: true });
-    fs11.writeFileSync(path10.join(abs, rel), text);
+    fs12.mkdirSync(path11.dirname(path11.join(abs, rel)), { recursive: true });
+    fs12.writeFileSync(path11.join(abs, rel), text);
   }
   return { dir: abs, name: pkgName, files: Object.keys(files) };
 }
 async function findEsbuild(dir) {
-  for (const base of [path10.join(dir, "package.json"), path10.join(process.cwd(), "package.json"), import.meta.url]) {
+  for (const base of [path11.join(dir, "package.json"), path11.join(process.cwd(), "package.json"), import.meta.url]) {
     try {
       const resolved = createRequire(base).resolve("esbuild");
       const esbuild = await import(pathToFileURL(resolved).href);
@@ -2281,8 +2281,8 @@ async function findEsbuild(dir) {
   return null;
 }
 async function buildPackDir(dir = ".") {
-  const abs = path10.resolve(dir);
-  if (!fs11.existsSync(path10.join(abs, "package.json"))) throw new Error(`${abs} has no package.json (\`austere-axi components new <dir>\` makes a pack)`);
+  const abs = path11.resolve(dir);
+  if (!fs12.existsSync(path11.join(abs, "package.json"))) throw new Error(`${abs} has no package.json (\`austere-axi components new <dir>\` makes a pack)`);
   const esbuild = await findEsbuild(abs);
   if (!esbuild) throw new Error(`components build needs esbuild: run \`npm install -D esbuild\` in ${abs}`);
   process.env.OPENUI_TELEMETRY_DISABLED ||= "1";
@@ -2406,7 +2406,7 @@ export default austereComponent({
 
 // src/cli/net.ts
 import { execFile } from "node:child_process";
-import fs12 from "node:fs";
+import fs13 from "node:fs";
 function run(bin, args) {
   return new Promise((resolve) => {
     execFile(bin, args, { timeout: 2500, windowsHide: true }, (err, stdout) => resolve(err ? null : stdout));
@@ -2417,7 +2417,7 @@ async function detectTailscale({ fresh = false } = {}) {
   if (!fresh && Date.now() - cache.at < 3e4) return cache.value;
   let value = null;
   for (const bin of CANDIDATES) {
-    if (bin.startsWith("/") && !fs12.existsSync(bin)) continue;
+    if (bin.startsWith("/") && !fs13.existsSync(bin)) continue;
     const out = await run(bin, ["status", "--json"]);
     if (!out) continue;
     try {
@@ -2514,8 +2514,8 @@ var init_items = __esm({
 });
 
 // src/cli/hub-page.ts
-import os2 from "node:os";
-import path11 from "node:path";
+import os3 from "node:os";
+import path12 from "node:path";
 function day(ms) {
   const d = new Date(ms);
   const today = /* @__PURE__ */ new Date();
@@ -2529,8 +2529,8 @@ function time3(ms) {
   return new Date(ms).toLocaleTimeString("en", { hour: "2-digit", minute: "2-digit", hour12: false });
 }
 function tilde(p) {
-  const home = os2.homedir();
-  return p === home || p.startsWith(home + path11.sep) ? "~" + p.slice(home.length) : p;
+  const home = os3.homedir();
+  return p === home || p.startsWith(home + path12.sep) ? "~" + p.slice(home.length) : p;
 }
 function counts(a) {
   const waiting = a.open + a.received;
@@ -2566,13 +2566,13 @@ function hubPage(rows, { version: version2, q: q2, project, stats }) {
     const body = [...days.entries()].map(
       ([d, items]) => `<h3>${escapeHtml(d)}</h3><ul>${items.map(
         (a) => `<li><a href="/hub/open/${a.id}" title="${escapeHtml(a.file)}">
-  <strong>${escapeHtml(a.title || path11.basename(a.file))}</strong>
-  <span class="meta">${escapeHtml(path11.relative(proj, a.file) || path11.basename(a.file))} \xB7 ${time3(a.updated_at)} \xB7 ${state(a)}${counts(a) ? ` \xB7 ${counts(a)}` : ""}</span>
+  <strong>${escapeHtml(a.title || path12.basename(a.file))}</strong>
+  <span class="meta">${escapeHtml(path12.relative(proj, a.file) || path12.basename(a.file))} \xB7 ${time3(a.updated_at)} \xB7 ${state(a)}${counts(a) ? ` \xB7 ${counts(a)}` : ""}</span>
 </a></li>`
       ).join("")}</ul>`
     ).join("");
     const unanswered = list.reduce((n, a) => n + a.open + a.received, 0);
-    return `<section><h2><a href="/?project=${encodeURIComponent(proj)}">${escapeHtml(path11.basename(proj) || proj)}</a> <small title="${escapeHtml(proj)}">${escapeHtml(
+    return `<section><h2><a href="/?project=${encodeURIComponent(proj)}">${escapeHtml(path12.basename(proj) || proj)}</a> <small title="${escapeHtml(proj)}">${escapeHtml(
       shortPath(proj)
     )}</small>${unanswered ? ` <b class="open">${unanswered} unanswered</b>` : ""}</h2>${body}</section>`;
   }).join("");
@@ -2595,7 +2595,7 @@ function notesPage(rows, { version: version2, q: q2, project, status, author = "
     const when = `${day(n.at)} ${time3(n.at)}`;
     return `<li class="n"><a href="/hub/open/${escapeHtml(n.artifact_id)}" title="${escapeHtml(n.file)}">
   <p class="note">${escapeHtml(n.text || "(no text)")}</p>
-  <span class="note-t">${n.author ? `<b class="by">${escapeHtml(n.author)}</b> \xB7 ` : ""}${n.target ? `on ${escapeHtml(n.target)} \xB7 ` : ""}<strong>${escapeHtml(n.title || path11.basename(n.file))}</strong> \xB7 ${escapeHtml(path11.basename(n.project) || n.project)} \xB7 ${escapeHtml(when)} \xB7 <span class="st ${waiting ? "waiting" : "done"}">${STATUS_LABEL[n.status] || escapeHtml(n.status)}</span></span>
+  <span class="note-t">${n.author ? `<b class="by">${escapeHtml(n.author)}</b> \xB7 ` : ""}${n.target ? `on ${escapeHtml(n.target)} \xB7 ` : ""}<strong>${escapeHtml(n.title || path12.basename(n.file))}</strong> \xB7 ${escapeHtml(path12.basename(n.project) || n.project)} \xB7 ${escapeHtml(when)} \xB7 <span class="st ${waiting ? "waiting" : "done"}">${STATUS_LABEL[n.status] || escapeHtml(n.status)}</span></span>
 </a></li>`;
   }).join("");
   const opt = (v, label) => `<option value="${v}"${status === v ? " selected" : ""}>${label}</option>`;
@@ -2650,9 +2650,9 @@ __export(server_exports, {
   persistEnv: () => persistEnv,
   runServer: () => runServer
 });
-import fs13 from "node:fs";
-import http2 from "node:http";
-import path12 from "node:path";
+import fs14 from "node:fs";
+import http3 from "node:http";
+import path13 from "node:path";
 import crypto5 from "node:crypto";
 function persistEnv() {
   return /^(1|true|yes)$/i.test(process.env.AUSTERE_AXI_PERSIST || "");
@@ -2667,7 +2667,7 @@ async function runServer({
     const line = `${(/* @__PURE__ */ new Date()).toISOString()} ${a.join(" ")}`;
     if (verbose) process.stderr.write(line + "\n");
     try {
-      fs13.appendFileSync(path12.join(stateDir(), "server.log"), line + "\n", { mode: 384 });
+      fs14.appendFileSync(path13.join(stateDir(), "server.log"), line + "\n", { mode: 384 });
     } catch {
     }
   };
@@ -2692,6 +2692,7 @@ async function runServer({
   const graceTimers = /* @__PURE__ */ new Map();
   const byeAt = /* @__PURE__ */ new Map();
   const browserSeen = /* @__PURE__ */ new Set();
+  const renderReported = /* @__PURE__ */ new Map();
   let tailnet = null;
   const linkBase = linkUrl();
   let lastActivity = Date.now();
@@ -2848,7 +2849,7 @@ data: ${JSON.stringify({ state: "revoked" })}
   }
   function readFileSafe(file3) {
     try {
-      return fs13.readFileSync(file3, "utf8");
+      return fs14.readFileSync(file3, "utf8");
     } catch {
       return null;
     }
@@ -2860,14 +2861,14 @@ data: ${JSON.stringify({ state: "revoked" })}
     const w = { html, program: art?.program ?? null, shell: art?.shell ?? null, timer: void 0 };
     watchers.set(s.id, w);
     if (art?.title) s.title = art.title;
-    fs13.watchFile(s.file, { interval: 300 }, () => {
+    fs14.watchFile(s.file, { interval: 300 }, () => {
       clearTimeout(w.timer);
       w.timer = setTimeout(() => onFileChange(s, w), 120);
     });
   }
   function unwatch(id) {
     const s = store.get(id);
-    if (s) fs13.unwatchFile(s.file);
+    if (s) fs14.unwatchFile(s.file);
     watchers.delete(id);
   }
   function onFileChange(s, w) {
@@ -3044,7 +3045,7 @@ data: ${JSON.stringify({ state: "revoked" })}
     const file3 = typeof body.file === "string" ? body.file : "";
     if (!file3) return send(res, 400, { error: "file is required" });
     if (route === "share") {
-      if (!fs13.existsSync(file3)) return send(res, 404, { error: `no such file: ${file3}` });
+      if (!fs14.existsSync(file3)) return send(res, 404, { error: `no such file: ${file3}` });
       await ensureTailnetListener();
       if (!remoteBase()) {
         return send(res, 409, {
@@ -3064,7 +3065,7 @@ data: ${JSON.stringify({ state: "revoked" })}
       return send(res, 200, { id: inviteId(inv), name: inv.name, auto: inv.auto, link: inviteLink(inv), file: inv.file });
     }
     if (route === "open") {
-      if (!fs13.existsSync(file3)) return send(res, 404, { error: `no such file: ${file3}` });
+      if (!fs14.existsSync(file3)) return send(res, 404, { error: `no such file: ${file3}` });
       await ensureTailnetListener();
       const s2 = store.ensure(file3);
       if (s2.closedAt && !body.reopen) {
@@ -3197,7 +3198,7 @@ data: ${JSON.stringify({ state: "revoked" })}
     }
     const file3 = installedPackFile(spec.name, spec.version);
     if (!file3) return send(res, 404, `pack ${spec.name}@${spec.version} is not installed (austere-axi components add ${spec.name}@${spec.version})`);
-    fs13.readFile(file3, (err, buf) => {
+    fs14.readFile(file3, (err, buf) => {
       if (err) return send(res, 404, "not found");
       const actual = `sha384-${crypto5.createHash("sha384").update(buf).digest("base64")}`;
       const locked = readLock().packs[spec.name]?.integrity;
@@ -3221,13 +3222,13 @@ data: ${JSON.stringify({ state: "revoked" })}
   }
   function serveAsset(res, rel, url2) {
     if (rel.startsWith("installed-packs/")) return serveInstalledPack(res, rel, url2);
-    const clean = path12.normalize(rel).replace(/^(\.\.[/\\])+/, "");
-    const file3 = path12.join(ASSET_DIR, clean);
-    if (!file3.startsWith(ASSET_DIR + path12.sep)) return send(res, 404, "not found");
-    fs13.stat(file3, (err, st2) => {
+    const clean = path13.normalize(rel).replace(/^(\.\.[/\\])+/, "");
+    const file3 = path13.join(ASSET_DIR, clean);
+    if (!file3.startsWith(ASSET_DIR + path13.sep)) return send(res, 404, "not found");
+    fs14.stat(file3, (err, st2) => {
       if (err || !st2.isFile()) return send(res, 404, "not found");
       streamFile(res, file3, {
-        "content-type": MIME[path12.extname(file3)] || "application/octet-stream",
+        "content-type": MIME[path13.extname(file3)] || "application/octet-stream",
         "content-length": st2.size,
         "cache-control": "no-cache",
         "x-content-type-options": "nosniff"
@@ -3236,7 +3237,7 @@ data: ${JSON.stringify({ state: "revoked" })}
   }
   const ARTIFACT_CSP = "sandbox allow-scripts allow-popups allow-popups-to-escape-sandbox allow-forms";
   function streamFile(res, file3, headers) {
-    const rs = fs13.createReadStream(file3);
+    const rs = fs14.createReadStream(file3);
     rs.once("open", () => {
       res.writeHead(200, headers);
       rs.pipe(res);
@@ -3249,8 +3250,8 @@ data: ${JSON.stringify({ state: "revoked" })}
     res.once("close", () => rs.destroy());
   }
   function serveArtifact(req, res, s, rest) {
-    const dir = path12.dirname(s.file);
-    const base = path12.basename(s.file);
+    const dir = path13.dirname(s.file);
+    const base = path13.basename(s.file);
     if (rest === base || rest === "") {
       const html = readFileSafe(s.file);
       if (html == null) return send(res, 404, "artifact file is missing");
@@ -3264,19 +3265,19 @@ data: ${JSON.stringify({ state: "revoked" })}
       return send(res, 400, "bad path");
     }
     if (decoded.includes("\0")) return send(res, 404, "not found");
-    const file3 = path12.resolve(dir, decoded);
-    if (!file3.startsWith(dir + path12.sep) || decoded.split(/[/\\]/).some((p) => p.startsWith("."))) {
+    const file3 = path13.resolve(dir, decoded);
+    if (!file3.startsWith(dir + path13.sep) || decoded.split(/[/\\]/).some((p) => p.startsWith("."))) {
       return send(res, 404, "not found");
     }
-    fs13.realpath(dir, (e1, realDir) => {
+    fs14.realpath(dir, (e1, realDir) => {
       if (e1) return send(res, 404, "not found");
-      fs13.realpath(file3, (e2, real) => {
-        if (e2 || !real.startsWith(realDir + path12.sep)) return send(res, 404, "not found");
-        if (path12.relative(realDir, real).split(path12.sep).some((p) => p.startsWith("."))) return send(res, 404, "not found");
-        fs13.stat(real, (err, st2) => {
+      fs14.realpath(file3, (e2, real) => {
+        if (e2 || !real.startsWith(realDir + path13.sep)) return send(res, 404, "not found");
+        if (path13.relative(realDir, real).split(path13.sep).some((p) => p.startsWith("."))) return send(res, 404, "not found");
+        fs14.stat(real, (err, st2) => {
           if (err || !st2.isFile() || st2.size > 64 * 1024 * 1024) return send(res, 404, "not found");
           streamFile(res, real, {
-            "content-type": MIME[path12.extname(real).toLowerCase()] || "application/octet-stream",
+            "content-type": MIME[path13.extname(real).toLowerCase()] || "application/octet-stream",
             "content-length": st2.size,
             "cache-control": "no-cache",
             "x-content-type-options": "nosniff",
@@ -3292,8 +3293,8 @@ data: ${JSON.stringify({ state: "revoked" })}
       title: s.title,
       file: viewer.role === "owner" ? s.file : "",
       viewer: { role: viewer.role, name: viewer.name, auto: viewer.role === "reviewer" ? viewer.auto : void 0 },
-      name: path12.basename(s.file),
-      artifactUrl: `/s/${s.id}/a/${encodeURIComponent(path12.basename(s.file))}`,
+      name: path13.basename(s.file),
+      artifactUrl: `/s/${s.id}/a/${encodeURIComponent(path13.basename(s.file))}`,
       version: VERSION
     };
     return `<!doctype html>
@@ -3327,7 +3328,7 @@ data: ${JSON.stringify({ state: "revoked" })}
   function hubOpen(res, id) {
     const a = /^[a-f0-9]{12}$/.test(id) ? hub.artifact(id) : null;
     if (!a) return send(res, 404, "not in the hub");
-    if (!fs13.existsSync(a.file)) return send(res, 410, `${a.file} no longer exists`);
+    if (!fs14.existsSync(a.file)) return send(res, 410, `${a.file} no longer exists`);
     const existed = store.byFile(a.file);
     const s = store.ensure(a.file);
     if (!existed) store.touch(s);
@@ -3503,6 +3504,30 @@ data: ${JSON.stringify(snapshot)}
       broadcastPresence(s);
       return send(res, 200, { ok: true, entry });
     }
+    if (sub === "/render-errors" && req.method === "POST") {
+      const body = await readBody(req);
+      if (s.closedAt || body.revision !== s.revision) return send(res, 200, { ok: true, count: 0, stale: true });
+      if (thirdPartyPacks(watchers.get(s.id)?.html).length) return send(res, 409, { error: "this page uses third-party packs; queue render errors by hand" });
+      let seen = renderReported.get(s.id);
+      if (!seen || seen.revision !== s.revision) renderReported.set(s.id, seen = { revision: s.revision, keys: /* @__PURE__ */ new Set() });
+      const items = [];
+      for (const e of Array.isArray(body.errors) ? body.errors.slice(0, MAX_RENDER_ERRORS) : []) {
+        if (!e || typeof e !== "object" || typeof e.message !== "string" || !e.message) continue;
+        const statement = typeof e.statement === "string" ? e.statement.slice(0, 200) : "";
+        const message = e.message.slice(0, 1e3);
+        const key3 = `${statement}
+${message}`;
+        if (seen.keys.has(key3)) continue;
+        seen.keys.add(key3);
+        items.push({ kind: "render-error", statement: statement || void 0, target: statement || void 0, message, note: "Reported when the page rendered." });
+      }
+      if (!items.length) return send(res, 200, { ok: true, count: 0 });
+      const entry = store.addUserBatch(s, items, { author: RENDER_CHECK_AUTHOR });
+      broadcastTranscript(s, [entry]);
+      wake(s);
+      broadcastPresence(s);
+      return send(res, 200, { ok: true, count: items.length });
+    }
     if ((sub === "/release" || sub === "/discard") && req.method === "POST") {
       const body = await readBody(req);
       const ids = Array.isArray(body.ids) ? body.ids.map(String) : sub === "/discard" && body.all ? null : [];
@@ -3543,7 +3568,7 @@ data: ${JSON.stringify(snapshot)}
       if (html == null) return send(res, 404, "artifact file is missing");
       try {
         const out = exportHtml(html);
-        const name = path12.basename(s.file).replace(/\.html?$/i, "") + ".export.html";
+        const name = path13.basename(s.file).replace(/\.html?$/i, "") + ".export.html";
         return send(res, 200, out.html, {
           "content-type": "text/html; charset=utf-8",
           "content-disposition": `attachment; filename="${name.replace(/"/g, "")}"`,
@@ -3558,7 +3583,7 @@ data: ${JSON.stringify(snapshot)}
   function listen(host) {
     return new Promise((resolve) => {
       if (listeners.has(host)) return resolve(true);
-      const server = http2.createServer((req, res) => {
+      const server = http3.createServer((req, res) => {
         handle(req, res).catch((err) => {
           log("error", req.method, String(req.url).split("?")[0], String(err?.stack || err));
           if (!res.headersSent) send(res, err.status || 500, { error: err.status ? String(err.message) : "internal error" });
@@ -3635,7 +3660,7 @@ data: ${JSON.stringify({ state: "stopped", reason })}
   log("started", `v${VERSION}`, `pid=${process.pid}`);
   return { port: port2, shutdown };
 }
-var MIME, SHORT_GRACE_MS, LOGIN_TTL_MS, OWNER, REVIEWER_KINDS, PAGE, SSE_MAX_BUFFER, SSE_STALL_MS, SSE_HARD_MAX, SSE_MAX_PER_REVIEWER, MAX_HELD_PER_REVIEWER, SSE_MAX_PER_SESSION;
+var MIME, SHORT_GRACE_MS, LOGIN_TTL_MS, OWNER, REVIEWER_KINDS, RENDER_CHECK_AUTHOR, MAX_RENDER_ERRORS, PAGE, SSE_MAX_BUFFER, SSE_STALL_MS, SSE_HARD_MAX, SSE_MAX_PER_REVIEWER, MAX_HELD_PER_REVIEWER, SSE_MAX_PER_SESSION;
 var init_server = __esm({
   "src/cli/server.ts"() {
     "use strict";
@@ -3681,6 +3706,8 @@ var init_server = __esm({
     LOGIN_TTL_MS = 6e4;
     OWNER = Object.freeze({ role: "owner", name: "" });
     REVIEWER_KINDS = /* @__PURE__ */ new Set(["annotation", "message"]);
+    RENDER_CHECK_AUTHOR = "Render check";
+    MAX_RENDER_ERRORS = 20;
     PAGE = 200;
     SSE_MAX_BUFFER = 1 << 20;
     SSE_STALL_MS = 5e3;
@@ -3696,12 +3723,12 @@ var mcp_exports = {};
 __export(mcp_exports, {
   runMcp: () => runMcp
 });
-import { spawn as spawn2 } from "node:child_process";
-import path13 from "node:path";
+import { spawn as spawn3 } from "node:child_process";
+import path14 from "node:path";
 import readline from "node:readline";
 function runCli({ args, stdin }, signal) {
   return new Promise((resolve) => {
-    const child = spawn2(process.execPath, [CLI_ENTRY, ...args], {
+    const child = spawn3(process.execPath, [CLI_ENTRY, ...args], {
       env: process.env,
       stdio: ["pipe", "pipe", "ignore"],
       windowsHide: true
@@ -3740,7 +3767,7 @@ async function callTool(name, a, signal) {
   const bad = validate2(tool, a);
   if (bad) return { content: [{ type: "text", text: `status: error
 error: ${bad}` }], isError: true };
-  if (typeof a.file === "string") a = { ...a, file: path13.resolve(a.file) };
+  if (typeof a.file === "string") a = { ...a, file: path14.resolve(a.file) };
   const args = a;
   let text = "";
   let isError = false;
@@ -3842,7 +3869,7 @@ var init_mcp = __esm({
     isRecord2 = (v) => !!v && typeof v === "object";
     PROTOCOLS = ["2025-11-25", "2025-06-18", "2024-11-05"];
     POLL_TIMEOUT_MS = 5e4;
-    INSTRUCTIONS = `austere-axi turns plans, comparisons, decisions, code reviews and reports into review pages the user annotates in the browser. Call \`spec\` once per session for the workflow, the file skeleton and the component reference. Results are the CLI's output: where a \`next:\` hint names an \`austere-axi <command>\`, call the tool of that name instead. Pass absolute file paths.`;
+    INSTRUCTIONS = `austere-axi turns plans, comparisons, decisions, code reviews and reports into review pages the user annotates in the browser. Call \`spec\` once per session for the workflow, the file skeleton and the component reference. Results are the CLI's output: where a \`next:\` hint names an \`austere-axi <command>\`, call the tool of that name instead. Pass absolute file paths. The reviewer judges how a page looks: do not open, screenshot or inspect it yourself unless the user asks.`;
     file2 = { type: "string", description: "Path of the .html page. Use an absolute path; a relative one resolves against the server's working directory." };
     TOOLS = {
       spec: {
@@ -3857,9 +3884,13 @@ var init_mcp = __esm({
       check: {
         title: "Validate a page",
         description: "Validate the page's OpenUI Lang program without a browser: syntax, component names, required props, unresolved references, unreachable statements.",
-        properties: { file: file2, fix: { type: "boolean", description: 'Write the <meta name="austere-packs"> tag for the packs the page uses.' } },
+        properties: {
+          file: file2,
+          fix: { type: "boolean", description: 'Write the <meta name="austere-packs"> tag for the packs the page uses.' },
+          render: { type: "boolean", description: "Also render the page in headless Chrome and report render errors and sideways scrolling as text. Only when the user asks to verify the page." }
+        },
         required: ["file"],
-        run: (a) => [{ args: ["check", ...a.fix ? ["--fix"] : [], "--", a.file] }]
+        run: (a) => [{ args: ["check", ...a.fix ? ["--fix"] : [], ...a.render ? ["--render"] : [], "--", a.file] }]
       },
       open: {
         title: "Validate and open the review",
@@ -3921,8 +3952,8 @@ var init_mcp = __esm({
 });
 
 // src/cli/main.ts
-import fs14 from "node:fs";
-import path14 from "node:path";
+import fs15 from "node:fs";
+import path15 from "node:path";
 
 // node_modules/@openuidev/lang-core/dist/shared-Dzgc28Wo.mjs
 var TELEMETRY_REQUEST_TIMEOUT_MS = 2e3;
@@ -4783,10 +4814,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path15) {
-  if (!path15)
+function getElementAtPath(obj, path16) {
+  if (!path16)
     return obj;
-  return path15.reduce((acc, key2) => acc?.[key2], obj);
+  return path16.reduce((acc, key2) => acc?.[key2], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -5126,11 +5157,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path15, issues) {
+function prefixIssues(path16, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path15);
+    iss.path.unshift(path16);
     return iss;
   });
 }
@@ -5592,16 +5623,16 @@ function flattenError(error62, mapper = (issue2) => issue2.message) {
 }
 function formatError(error62, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error63, path15 = []) => {
+  const processError = (error63, path16 = []) => {
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path15, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path16, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else {
-        const fullpath = [...path15, ...issue2.path];
+        const fullpath = [...path16, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -5640,17 +5671,17 @@ function formatError(error62, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error62, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error63, path15 = []) => {
+  const processError = (error63, path16 = []) => {
     var _a3;
     for (const issue2 of error63.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path15, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path16, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path15, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path16, ...issue2.path]);
       } else {
-        const fullpath = [...path15, ...issue2.path];
+        const fullpath = [...path16, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -5689,8 +5720,8 @@ function treeifyError(error62, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path15 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path15) {
+  const path16 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path16) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -22828,13 +22859,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path15 = ref.slice(1).split("/").filter(Boolean);
-  if (path15.length === 0) {
+  const path16 = ref.slice(1).split("/").filter(Boolean);
+  if (path16.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path15[0] === defsKey) {
-    const key2 = path15[1] === void 0 ? void 0 : decodeJSONPointerSegment(path15[1]);
+  if (path16[0] === defsKey) {
+    const key2 = path16[1] === void 0 ? void 0 : decodeJSONPointerSegment(path16[1]);
     if (!key2 || !ctx.defs[key2]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -23716,11 +23747,11 @@ function defineAction(config2) {
     ref: actionRef(config2.name, data)
   };
 }
-function resolveField(obj, path15) {
-  if (!path15 || obj == null) return void 0;
-  if (!path15.includes(".")) return obj[path15];
+function resolveField(obj, path16) {
+  if (!path16 || obj == null) return void 0;
+  if (!path16.includes(".")) return obj[path16];
   let cur = obj;
-  for (const p of path15.split(".")) {
+  for (const p of path16.split(".")) {
     if (cur == null) return void 0;
     cur = cur[p];
   }
@@ -25096,14 +25127,14 @@ function checkTypeMismatch(value, info) {
   };
   return null;
 }
-function validationMessage(component, path15, issue2) {
+function validationMessage(component, path16, issue2) {
   switch (issue2.code) {
     case "type-mismatch":
-      return `field "${path15}" expects ${issue2.expected} but got ${issue2.actual}`;
+      return `field "${path16}" expects ${issue2.expected} but got ${issue2.actual}`;
     case "missing-required":
-      return `missing required field "${path15}"${issue2.signature ? ` \u2014 signature: ${issue2.signature}` : ""}`;
+      return `missing required field "${path16}"${issue2.signature ? ` \u2014 signature: ${issue2.signature}` : ""}`;
     case "null-required":
-      return `required field "${path15}" cannot be null${issue2.signature ? ` \u2014 signature: ${issue2.signature}` : ""}`;
+      return `required field "${path16}" cannot be null${issue2.signature ? ` \u2014 signature: ${issue2.signature}` : ""}`;
     case "unknown-component":
       return `Unknown component "${component}" \u2014 not found in catalog or builtins${issue2.available?.length ? `. Available components: ${issue2.available.join(", ")}` : ""}`;
     case "inline-reserved":
@@ -25118,12 +25149,12 @@ function validationMessage(component, path15, issue2) {
       return component ? `No root statement, and no statement calls the root component ${component}` : "No root statement";
   }
 }
-function pushValidationIssue(ctx, component, path15, issue2) {
+function pushValidationIssue(ctx, component, path16, issue2) {
   ctx.errors.push({
     code: issue2.code,
     component,
-    path: path15,
-    message: validationMessage(component, path15, issue2),
+    path: path16,
+    message: validationMessage(component, path16, issue2),
     statementId: ctx.currentStatementId,
     ...issue2.code === "no-root" && issue2.reason === "fallback" && { severity: "warning" }
   });
@@ -25133,10 +25164,10 @@ function resolveInvalidValue(required2, defaultValue) {
   if (defaultValue !== void 0) return defaultValue;
   return required2 ? INVALID2 : void 0;
 }
-function validateElementPosition(element, s, component, path15, ctx) {
+function validateElementPosition(element, s, component, path16, ctx) {
   if (isCompositeSchema(s)) return false;
   if (typeof s["type"] === "string" || Array.isArray(s["enum"]) || "const" in s) {
-    pushValidationIssue(ctx, component, path15, {
+    pushValidationIssue(ctx, component, path16, {
       code: "type-mismatch",
       expected: typeof s["type"] === "string" ? s["type"] : "a literal value",
       actual: `component "${element.typeName}"`
@@ -25152,9 +25183,9 @@ function isOnlyComponentSlot(s, ctx) {
   const names = slotRefNames(s);
   return names.length > 0 && names.every((n) => n !== void 0 && ctx.cat?.has(n));
 }
-function validateObjectValue(value, s, component, path15, ctx) {
+function validateObjectValue(value, s, component, path16, ctx) {
   if (typeof value !== "object" || Array.isArray(value)) {
-    pushValidationIssue(ctx, component, path15, {
+    pushValidationIssue(ctx, component, path16, {
       code: "type-mismatch",
       expected: "object",
       actual: jsType(value)
@@ -25174,14 +25205,14 @@ function validateObjectValue(value, s, component, path15, ctx) {
         (out ??= { ...obj })[key2] = fallback;
         continue;
       }
-      pushValidationIssue(ctx, component, `${path15}/${key2}`, { code: present ? "null-required" : "missing-required" });
+      pushValidationIssue(ctx, component, `${path16}/${key2}`, { code: present ? "null-required" : "missing-required" });
       invalid = true;
     }
   }
   for (const key2 of Object.keys(props)) {
     if (!(key2 in obj)) continue;
     const sub = props[key2];
-    let next = validateSchemaValue(obj[key2], sub, component, `${path15}/${key2}`, ctx);
+    let next = validateSchemaValue(obj[key2], sub, component, `${path16}/${key2}`, ctx);
     if (next === INVALID2) {
       next = resolveInvalidValue(required2.includes(key2), getSchemaDefaultValue(sub));
       if (next === INVALID2) {
@@ -25196,9 +25227,9 @@ function validateObjectValue(value, s, component, path15, ctx) {
   }
   return invalid ? INVALID2 : out ?? obj;
 }
-function validateArrayValue(value, s, component, path15, ctx) {
+function validateArrayValue(value, s, component, path16, ctx) {
   if (!Array.isArray(value)) {
-    pushValidationIssue(ctx, component, path15, {
+    pushValidationIssue(ctx, component, path16, {
       code: "type-mismatch",
       expected: "array",
       actual: jsType(value)
@@ -25209,19 +25240,19 @@ function validateArrayValue(value, s, component, path15, ctx) {
   if (!items || typeof items !== "object" || Array.isArray(items)) return value;
   let out;
   for (let i = 0; i < value.length; i++) {
-    const next = validateSchemaValue(value[i], items, component, `${path15}/${i}`, ctx);
+    const next = validateSchemaValue(value[i], items, component, `${path16}/${i}`, ctx);
     if (next !== value[i] && !out) out = value.slice(0, i);
     if (out && next !== INVALID2) out.push(next);
   }
   return out ?? value;
 }
-function validateLeafValue(value, s, component, path15, ctx) {
+function validateLeafValue(value, s, component, path16, ctx) {
   const leaf = getScalarTypeInfo(s);
   if (leaf.expectedType == null && leaf.enumValues == null) return false;
   if (leaf.enumValues && ctx.partial) return false;
   const mismatch = checkTypeMismatch(value, leaf);
   if (mismatch) {
-    pushValidationIssue(ctx, component, path15, {
+    pushValidationIssue(ctx, component, path16, {
       code: "type-mismatch",
       ...mismatch
     });
@@ -25229,15 +25260,15 @@ function validateLeafValue(value, s, component, path15, ctx) {
   }
   return false;
 }
-function validateSchemaValue(value, schema, component, path15, ctx) {
+function validateSchemaValue(value, schema, component, path16, ctx) {
   if (!schema || typeof schema !== "object" || Array.isArray(schema)) return value;
   const s = schema;
   if (value == null) return value;
   if (isASTNode(value)) return value;
-  if (isElementNode(value)) return validateElementPosition(value, s, component, path15, ctx) ? INVALID2 : value;
+  if (isElementNode(value)) return validateElementPosition(value, s, component, path16, ctx) ? INVALID2 : value;
   if (isCompositeSchema(s)) {
     if (!isOnlyComponentSlot(s, ctx)) return value;
-    pushValidationIssue(ctx, component, path15, {
+    pushValidationIssue(ctx, component, path16, {
       code: "type-mismatch",
       expected: slotRefNames(s).join(" | "),
       actual: Array.isArray(value) ? "array" : typeof value === "object" ? "plain object" : typeof value
@@ -25245,9 +25276,9 @@ function validateSchemaValue(value, schema, component, path15, ctx) {
     return INVALID2;
   }
   const type = s["type"];
-  if (type === "object") return validateObjectValue(value, s, component, path15, ctx);
-  if (type === "array") return validateArrayValue(value, s, component, path15, ctx);
-  return validateLeafValue(value, s, component, path15, ctx) ? INVALID2 : value;
+  if (type === "object") return validateObjectValue(value, s, component, path16, ctx);
+  if (type === "array") return validateArrayValue(value, s, component, path16, ctx);
+  return validateLeafValue(value, s, component, path16, ctx) ? INVALID2 : value;
 }
 function containsDynamicValue(v) {
   if (v == null || typeof v !== "object") return false;
@@ -28873,11 +28904,11 @@ function routeOrthogonal({ boxes, edges: input2, xLines = [], yLines = [], avoid
       const blocked = solid.some(([id, r]) => id !== e.from && id !== e.to && seg.x0 < r.x + r.width && r.x < seg.x1 && seg.y0 < r.y + r.height && r.y < seg.y1);
       if (!blocked) {
         routes.set(e.id, [a, b]);
-        const path16 = [];
+        const path17 = [];
         const [i0, j0, i1, j1] = [ix(a.x), iy(a.y), ix(b.x), iy(b.y)];
-        if (j0 === j1) for (let i = Math.min(i0, i1); i <= Math.max(i0, i1); i++) path16.push([i, j0]);
-        else for (let j = Math.min(j0, j1); j <= Math.max(j0, j1); j++) path16.push([i0, j]);
-        if (path16.every((pt2) => pt2[0] !== void 0 && pt2[1] !== void 0)) mark(path16);
+        if (j0 === j1) for (let i = Math.min(i0, i1); i <= Math.max(i0, i1); i++) path17.push([i, j0]);
+        else for (let j = Math.min(j0, j1); j <= Math.max(j0, j1); j++) path17.push([i0, j]);
+        if (path17.every((pt2) => pt2[0] !== void 0 && pt2[1] !== void 0)) mark(path17);
         continue;
       }
     }
@@ -28887,12 +28918,12 @@ function routeOrthogonal({ boxes, edges: input2, xLines = [], yLines = [], avoid
     const sj = iy(st2.y);
     const ti = ix(tt2.x);
     const tj = iy(tt2.y);
-    let path15 = null;
+    let path16 = null;
     if (si !== void 0 && sj !== void 0 && ti !== void 0 && tj !== void 0) {
-      path15 = search(si, sj, dirOf(e.fromSide), ti, tj, reverse[dirOf(e.toSide)]);
+      path16 = search(si, sj, dirOf(e.fromSide), ti, tj, reverse[dirOf(e.toSide)]);
     }
-    const pts = path15 ? path15.map(([i, j]) => ({ x: xs[i], y: ys[j] })) : elbow(st2, tt2, e.fromSide);
-    if (path15) mark(path15);
+    const pts = path16 ? path16.map(([i, j]) => ({ x: xs[i], y: ys[j] })) : elbow(st2, tt2, e.fromSide);
+    if (path16) mark(path16);
     routes.set(e.id, simplify([e.fromPort, ...pts, e.toPort]));
   }
   return routes;
@@ -28961,10 +28992,10 @@ function routeOrthogonal({ boxes, edges: input2, xLines = [], yLines = [], avoid
     }
     return out.reverse();
   }
-  function mark(path15) {
-    for (let k = 1; k < path15.length; k++) {
-      const [i0, j0] = path15[k - 1];
-      const [i1, j1] = path15[k];
+  function mark(path16) {
+    for (let k = 1; k < path16.length; k++) {
+      const [i0, j0] = path16[k - 1];
+      const [i1, j1] = path16[k];
       if (j0 === j1) {
         hUse[j0 * nx + Math.min(i0, i1)]++;
         hPass[j0 * nx + i0]++;
@@ -29669,6 +29700,280 @@ init_lock();
 init_sessions();
 init_export();
 
+// src/cli/render-check.ts
+init_export();
+import { spawn as spawn2 } from "node:child_process";
+import fs10 from "node:fs";
+import http2 from "node:http";
+import os2 from "node:os";
+import path9 from "node:path";
+var WIDTHS = [1280, 390];
+var LAUNCH_TIMEOUT_MS = 15e3;
+var RENDER_TIMEOUT_MS = 3e4;
+var FRAME_SANDBOX = "allow-scripts";
+function findChrome() {
+  const fromEnv = process.env.CHROME_PATH;
+  if (fromEnv) return fs10.existsSync(fromEnv) ? fromEnv : null;
+  const candidates = [];
+  if (process.platform === "darwin") {
+    for (const p of ["Google Chrome.app/Contents/MacOS/Google Chrome", "Chromium.app/Contents/MacOS/Chromium", "Microsoft Edge.app/Contents/MacOS/Microsoft Edge"]) {
+      candidates.push(path9.join("/Applications", p));
+    }
+  } else if (process.platform === "win32") {
+    const roots = [process.env.PROGRAMFILES, process.env["PROGRAMFILES(X86)"], process.env.LOCALAPPDATA].filter((x) => typeof x === "string");
+    for (const r of roots) candidates.push(path9.join(r, "Google/Chrome/Application/chrome.exe"), path9.join(r, "Microsoft/Edge/Application/msedge.exe"));
+  } else {
+    const dirs = (process.env.PATH || "").split(path9.delimiter).filter(Boolean);
+    for (const name of ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser", "microsoft-edge"]) {
+      for (const d of dirs) candidates.push(path9.join(d, name));
+    }
+  }
+  return candidates.find((c) => fs10.existsSync(c)) ?? null;
+}
+var MEASURE = `<script>(() => {
+  const exceptions = [];
+  addEventListener("error", (e) => exceptions.push(String((e.error && e.error.message) || e.message || "error")));
+  addEventListener("unhandledrejection", (e) => exceptions.push(String((e.reason && e.reason.message) || e.reason)));
+  const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+  addEventListener("message", async (e) => {
+    const d = e.data;
+    if (e.source !== parent || !d || d.austereMeasure !== 1) return;
+    for (let i = 0; i < 100; i++) {
+      const pending = [...document.querySelectorAll(".austere-mermaid")].filter((m) => !m.querySelector("svg, .austere-render-error"));
+      if (!pending.length) break;
+      await sleep(100);
+    }
+    await sleep(200);
+    const shown = [...document.querySelectorAll(".austere-render-error")].map((el) => ({
+      statement: (el.closest("[data-oui-id]") && el.closest("[data-oui-id]").getAttribute("data-oui-id")) || "",
+      error: el.textContent.trim().slice(0, 300),
+    }));
+    const se = document.scrollingElement;
+    let past = null;
+    if (se.scrollWidth > se.clientWidth + 1) {
+      const vw = se.clientWidth;
+      // Past the right edge and not inside a box that clips or scrolls it (a wide table in its own scroller is fine).
+      const sticksOut = (el) => {
+        if (el.getBoundingClientRect().right <= vw + 1) return false;
+        for (let a = el.parentElement; a && a !== document.body; a = a.parentElement) {
+          if (getComputedStyle(a).overflowX !== "visible" && a.getBoundingClientRect().right <= vw + 1) return false;
+        }
+        return true;
+      };
+      // Statement wrappers have no box of their own (display: contents), so find the innermost
+      // elements that stick out and name the statement around each.
+      const out = [...document.body.querySelectorAll("*")].slice(0, 20000).filter(sticksOut);
+      const outSet = new Set(out);
+      const leaves = out.filter((el) => ![...el.children].some((c) => outSet.has(c)));
+      const ids = leaves.map((el) => el.closest("[data-oui-id]") && el.closest("[data-oui-id]").getAttribute("data-oui-id")).filter(Boolean);
+      past = [...new Set(ids)].slice(0, 8);
+    }
+    const statements = new Set([...document.querySelectorAll("[data-oui-id]")].map((el) => el.getAttribute("data-oui-id"))).size;
+    parent.postMessage({ austereMeasured: 1, id: d.id, shown, exceptions: exceptions.slice(0, 20), past, statements }, "*");
+  });
+})();</script>`;
+var HARNESS = `<!doctype html><html><head><meta charset="utf-8"></head><body style="margin:0">
+<iframe id="f" sandbox="${FRAME_SANDBOX}" src="/page.html" style="border:0;width:${WIDTHS[0]}px;height:900px"></iframe>
+<script>
+const f = document.getElementById("f");
+const errors = [];
+const answers = new Map();
+let ready = false;
+addEventListener("message", (e) => {
+  const d = e.data;
+  if (e.source !== f.contentWindow || !d) return;
+  if (d.austereMeasured === 1) return answers.get(d.id)?.(d);
+  if (d.austere !== 1) return;
+  if (d.type === "hello") f.contentWindow.postMessage({ austere: 1, type: "init", mode: "explore", scrollY: 0 }, "*");
+  else if (d.type === "ready") ready = true;
+  else if (d.type === "errors") for (const x of d.errors || []) errors.push({ statement: String(x.statementId || ""), error: String(x.message || "") });
+  else if (d.type === "runtime-error" && d.error) errors.push({ statement: String(d.error.statementId || ""), error: String(d.error.message || "") });
+});
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+let next = 0;
+const measure = () => new Promise((resolve) => {
+  const id = ++next;
+  answers.set(id, resolve);
+  f.contentWindow.postMessage({ austereMeasure: 1, id }, "*");
+});
+window.__austereReport = async (widths) => {
+  for (let i = 0; i < 150 && !ready; i++) await sleep(100);
+  const overflow = [];
+  let last = null;
+  for (const w of widths) {
+    f.style.width = w + "px";
+    await sleep(300);
+    last = await measure();
+    if (last.past) overflow.push({ width: w, statements: last.past });
+  }
+  const all = [...errors];
+  for (const s of last.shown) if (!all.some((x) => x.statement === s.statement)) all.push(s);
+  for (const x of last.exceptions) if (!all.some((y) => y.error === x)) all.push({ statement: "", error: x.slice(0, 300) });
+  return { rendered: ready, statements: last.statements, errors: all, overflow };
+};
+</script></body></html>`;
+function connect(url2) {
+  const ws = new WebSocket(url2);
+  let next = 0;
+  const pending = /* @__PURE__ */ new Map();
+  const listeners = [];
+  ws.onmessage = (ev) => {
+    const m = JSON.parse(String(ev.data));
+    const p = m.id != null ? pending.get(m.id) : void 0;
+    if (p && m.id != null) {
+      pending.delete(m.id);
+      if (m.error) p.reject(new Error(m.error.message));
+      else p.resolve(m.result);
+    } else for (const fn2 of listeners) fn2(m);
+  };
+  const opened = new Promise((resolve, reject) => {
+    ws.onopen = () => resolve();
+    ws.onerror = () => reject(new Error("could not connect to Chrome's DevTools endpoint"));
+  });
+  return {
+    opened,
+    send(method, params = {}, sessionId2) {
+      const id = ++next;
+      ws.send(JSON.stringify({ id, method, params, sessionId: sessionId2 }));
+      return new Promise((resolve, reject) => pending.set(id, { resolve: (v) => resolve(v), reject }));
+    },
+    on(fn2) {
+      listeners.push(fn2);
+    },
+    close() {
+      ws.close();
+    }
+  };
+}
+function launch(bin, profile) {
+  const args = [
+    "--headless=new",
+    "--remote-debugging-port=0",
+    `--user-data-dir=${profile}`,
+    "--no-first-run",
+    "--no-default-browser-check",
+    "--disable-gpu",
+    "--disable-extensions",
+    "--disable-background-networking",
+    "--disable-component-update",
+    "--disable-breakpad",
+    "--disable-sync",
+    "--disable-dev-shm-usage",
+    // Without these, Chrome waits about 25 s for a desktop keyring (Linux) or keychain (macOS) that may never answer.
+    "--password-store=basic",
+    "--use-mock-keychain",
+    "--mute-audio",
+    "--window-size=1400,1000"
+  ];
+  if (process.getuid?.() === 0) args.push("--no-sandbox");
+  args.push("about:blank");
+  const child = spawn2(bin, args, { stdio: ["ignore", "ignore", "pipe"], windowsHide: true });
+  const exited = new Promise((resolve) => {
+    child.once("exit", () => resolve());
+    child.once("error", () => resolve());
+  });
+  const endpoint = new Promise((resolve, reject) => {
+    let err = "";
+    const timer = setTimeout(() => reject(new Error(`Chrome did not start within ${LAUNCH_TIMEOUT_MS / 1e3} s`)), LAUNCH_TIMEOUT_MS);
+    child.stderr?.on("data", (c) => {
+      err += c;
+      const m = /DevTools listening on (ws:\/\/\S+)/.exec(err);
+      if (m?.[1]) {
+        clearTimeout(timer);
+        resolve(m[1]);
+      }
+    });
+    child.once("error", (e) => {
+      clearTimeout(timer);
+      reject(e);
+    });
+    child.once("exit", (code) => {
+      clearTimeout(timer);
+      reject(new Error(`Chrome exited (${code}): ${err.trim().split("\n").pop() || "no output"}`));
+    });
+  });
+  return { child, endpoint, exited };
+}
+function serve(page) {
+  const server = http2.createServer((req, res) => {
+    if (req.url === "/") {
+      res.writeHead(200, { "content-type": "text/html; charset=utf-8", "cache-control": "no-store" }).end(HARNESS);
+    } else if (req.url === "/page.html") {
+      res.writeHead(200, { "content-type": "text/html; charset=utf-8", "cache-control": "no-store", "content-security-policy": `sandbox ${FRAME_SANDBOX}` }).end(page);
+    } else res.writeHead(404).end();
+  });
+  return new Promise((resolve, reject) => {
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const addr = server.address();
+      resolve({ url: `http://127.0.0.1:${addr.port}/`, close: () => server.close() });
+    });
+  });
+}
+function withMeasure(html) {
+  const at2 = html.toLowerCase().lastIndexOf("</body>");
+  return at2 < 0 ? html + MEASURE : html.slice(0, at2) + MEASURE + html.slice(at2);
+}
+async function renderCheck(html) {
+  const bin = findChrome();
+  if (!bin) {
+    const reason = process.env.CHROME_PATH ? `CHROME_PATH does not exist: ${process.env.CHROME_PATH}` : "no Chrome, Chromium or Edge found; install one or set CHROME_PATH";
+    return { status: "unavailable", reason };
+  }
+  const { html: page, notices } = exportHtml(html);
+  const profile = fs10.mkdtempSync(path9.join(os2.tmpdir(), "austere-render-"));
+  const site = await serve(withMeasure(page));
+  const { child, endpoint, exited } = launch(bin, profile);
+  let cdp = null;
+  let timer;
+  try {
+    const run2 = (async () => {
+      const conn = connect(await endpoint);
+      cdp = conn;
+      await conn.opened;
+      const { targetId } = await conn.send("Target.createTarget", { url: "about:blank" });
+      const { sessionId: sessionId2 } = await conn.send("Target.attachToTarget", { targetId, flatten: true });
+      await conn.send("Page.enable", {}, sessionId2);
+      const loaded = new Promise((resolve) => conn.on((m) => m.method === "Page.loadEventFired" && m.sessionId === sessionId2 && resolve()));
+      await conn.send("Page.navigate", { url: site.url }, sessionId2);
+      await loaded;
+      const r = await conn.send(
+        "Runtime.evaluate",
+        { expression: `window.__austereReport(${JSON.stringify(WIDTHS)})`, awaitPromise: true, returnByValue: true },
+        sessionId2
+      );
+      if (r.exceptionDetails) throw new Error(`render report failed: ${r.exceptionDetails.text}`);
+      const report = r.result.value;
+      if (!report.rendered && !report.errors.length) report.errors.push({ statement: "", error: "the page did not finish rendering" });
+      return { status: "ok", statements: report.statements, errors: report.errors, overflow: report.overflow, notices };
+    })();
+    const timeout = new Promise((_, reject) => {
+      timer = setTimeout(() => reject(new Error(`rendering took longer than ${RENDER_TIMEOUT_MS / 1e3} s`)), RENDER_TIMEOUT_MS);
+    });
+    return await Promise.race([run2, timeout]);
+  } catch (err) {
+    return { status: "unavailable", reason: err instanceof Error ? err.message : String(err) };
+  } finally {
+    clearTimeout(timer);
+    const conn = cdp;
+    conn?.send("Browser.close").catch(() => {
+    });
+    let grace;
+    await Promise.race([exited, new Promise((r) => grace = setTimeout(r, 3e3))]);
+    clearTimeout(grace);
+    conn?.close();
+    if (child.exitCode == null && child.pid != null) child.kill();
+    site.close();
+    let killGrace;
+    await Promise.race([exited, new Promise((r) => killGrace = setTimeout(r, 3e3))]);
+    clearTimeout(killGrace);
+    try {
+      fs10.rmSync(profile, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
+    } catch {
+    }
+  }
+}
+
 // src/cli/output.ts
 var PLAIN = /^[A-Za-z0-9_./@:+-][A-Za-z0-9 _./@:+(),=<>*#%?!'-]*$/;
 var json2 = (v) => JSON.stringify(v).replace(/[\u0085\u2028\u2029]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, "0")}`);
@@ -29902,85 +30207,69 @@ WORKFLOW
        intro = Card([CardHeader("Title", "Subtitle"), introText])
        introText = MarkDownRenderer("...")
        </script></body></html>
-     The CDN tag lets the file open on its own (needs network); review and \`export\` work offline.
-  3. ${BIN2} <file.html>          validate + open for review (fix any errors it lists).
-                                   With --no-open the session still exists; it prints the url
-                                   (and a phone url when Tailscale is up) for the user. A browser
-                                   the CLI did not open signs in once with a link from \`${BIN2} login\`.
-  4. ${BIN2} poll <file.html>     wait for feedback. Leave it running in the foreground;
-                                   it returns when the reviewer presses Send. If your tool call
-                                   times out first, run the same poll again: nothing is lost.
-  5. Apply feedback by editing ONLY the named statements (keep names stable). The page
-     live-updates and highlights what changed. Then reply, passing the poll's cursor:
+     Arguments are positional and typed: follow each signature in spec exactly (order and
+     type; an array stays an array). Pass null to skip an optional one.
+  3. ${BIN2} <file.html>          validate + open for review; fix any errors it lists.
+                                   --no-open: print the url for the user instead.
+  4. ${BIN2} poll <file.html>     wait for feedback (foreground; if the call times out, poll again).
+  5. Revise with patch only: send just the changed statements; do not rewrite or re-read
+     the file (each note carries its statement's line and source):
+       ${BIN2} patch <file.html> <<'EOF'
+       risks = Table([...])        same name replaces, new name adds, \`name = null\` deletes
+       EOF
+     If a changed value appears in several statements, patch each of them.
+     Then acknowledge and reply in one step:
        ${BIN2} poll <file.html> --cursor <n> --agent-reply "one line: what changed"
-     Feedback stays unread until you acknowledge it (--cursor, or any reply); a poll
-     without either returns it again, so feedback lost on the way is not lost.
-  6. On status: ended, stop polling and continue in chat. Never reopen uninvited. Notes
-     the reviewer adds later are kept, and the next poll returns them.
+  6. On status: ended, stop polling and continue in chat. Never reopen uninvited.
 
-FEEDBACK (what poll returns)
-  status: feedback | ended | browser_disconnected | interrupted | replaced, plus a next: hint.
-  cursor: the number to acknowledge this feedback with.
-  items, each one of:
-    annotation: <statement> (<Component>)   line + source of that statement in the file,
-        within (parent statements), selection | excerpt, detail (table row/column, or
-        part: the exact piece clicked, e.g. a diff file:+line or a diagram node), note
-    action: <@ToAssistant message>           form: {<formName>: {<field>: value}}, context
-    message: <free text from the composer>
-    render_error: <statement>                a render failure the reviewer asked you to fix
+FEEDBACK (poll)
+  status: feedback | ended | browser_disconnected | interrupted | replaced, plus next:
+  cursor: pass it back to acknowledge; unacknowledged feedback is returned again.
+  items: annotation: <statement> (<Component>) with line, source, note
+         action: <@ToAssistant message> with form values | message: <free text>
+         render_error: <statement>  sent by the open review page on its own
 
 CHECK verifies syntax, component names, required props, unresolved references and
-statements unreachable from root. Mermaid syntax is only checked when it renders; failures
-show in the reviewer's panel and can come back as render_error. CHECK does not judge how
-a page looks: open it for that. It does warn when an Architecture diagram will not fit the
+statements unreachable from root. It warns when an Architecture diagram will not fit the
 page (it would scroll sideways).
 
-WHEN TO USE
-  Plans, comparisons, decisions, reviews, reports: anything easier to grasp as a page.
-  Not for a few sentences of prose.
+LOOKS
+  The reviewer judges how the page looks. Do not open, screenshot or inspect the page
+  yourself (browser tools, curl, headless runs) unless the user asks: check ok + open is
+  done. Render failures come back through poll. When the user asks you to verify the
+  page, run \`${BIN2} check --render <file>\` (headless Chrome, text report, no image).
 
-COMMANDS (\`${BIN2} <command> --help\` for one command's flags and an example)
-  ${BIN2}                         sessions + command list
-  ${BIN2} <file>                  open/resume a review   [--no-open] [--reopen]
-  ${BIN2} poll <file>             long-poll for feedback  [--cursor n] [--agent-reply "..."] [--agent-reply-file f|-]
-                                   --cursor n acknowledges feedback up to n; --after n returns
-                                   everything after n again. One poll per session; --takeover
-                                   replaces a stuck one
-  ${BIN2} reply <file>            post a reply without polling  --agent-reply "..." | --agent-reply-file f|-  [--cursor n]
-  ${BIN2} end <file>              stop as the agent; the reviewer can still add notes for later
-  ${BIN2} close <file>            close the review for the owner: no more notes until reopen
-  ${BIN2} reopen <file>           reopen an ended or closed review
-  ${BIN2} login [file]            single-use link that signs a browser in as you (SSH, --no-open,
-                                   another browser), to the file's review or the session list
-  ${BIN2} feedback <file>         feedback no agent has answered yet (sent after polling stopped,
-                                   or in an earlier session)   [--all] [--peek]; answer with reply
-  ${BIN2} check <file>            validate the program (no browser)   [--fix: declare the packs it uses]
-  ${BIN2} patch <file>            merge statements from stdin into the program: same name
-                                   replaces, new name adds, \`name = null\` deletes;
-                                   reports added statements dropped as unreferenced
-  ${BIN2} spec [group|pack...]    component reference (groups: Layout Content Data Charts Forms Buttons)
-  ${BIN2} components [group]      every component, including ones spec leaves out
-  ${BIN2} components search <words> | show <Name...>
-  ${BIN2} components add <npm-package|folder|file.tgz> [--trust] | remove <package>
-                                   packs add components; a page that uses one declares it
-                                   (check --fix writes the <meta name="austere-packs"> tag)
-  ${BIN2} components new <dir> | build [dir]    write your own pack
-  ${BIN2} export <file>           single self-contained HTML   [--out path]
-  ${BIN2} hub on|off|status|list|notes|open   the owner's home page: every artifact by project/date, every note
-  ${BIN2} share <file> --as "<name>" [--auto]   invite link for a teammate on your tailnet. Their notes
-                                   wait for the owner to send them on; --auto skips the wait
-  ${BIN2} share list [--links] | revoke <name|id>
-  ${BIN2} stop                    stop the background server
-  ${BIN2} server [--persist]      run the server in the foreground; --persist: never idle out
-                                   (behind a reverse proxy, under systemd)
-  ${BIN2} mcp                     MCP server on stdio: spec check open poll reply patch end as tools
+COMMANDS
+  ${BIN2} check <file>            validate without a browser: syntax, components, props,
+                                   references   [--fix: declare packs] [--render]
+  ${BIN2} reply <file>            reply without polling  --agent-reply "..."  [--cursor n]
+  ${BIN2} end <file>              stop as the agent; later notes wait for the next poll
+  ${BIN2} feedback <file>         notes no agent has answered yet   [--all] [--peek]
+  ${BIN2} login [file]            single-use sign-in link for a browser the CLI did not open
+  ${BIN2} components search <words> | show <Name...>   components spec leaves out
+  ${BIN2} <command> --help        one command's flags and an example
+  ${BIN2} help all                every command, notes and environment
+`;
+function helpAll() {
+  const rows = Object.entries(COMMANDS).map(([, c]) => `  ${BIN2} ${c.usage}
+      ${c.summary}`);
+  return `
+ALL COMMANDS
+${rows.join("\n")}
+
+NOTES
+  The CDN script tag lets the file open on its own (needs network); review and export work
+  offline. A browser the CLI did not open gets 403 until it signs in with \`${BIN2} login\`.
+  Mermaid syntax is only checked when it renders. check warns when an Architecture diagram
+  will not fit the page. check --render needs Chrome, Chromium or Edge (or CHROME_PATH).
 
 ENV
   AUSTERE_AXI_PORT (4388)  AUSTERE_AXI_STATE_DIR (~/.austere-axi)  AUSTERE_AXI_NO_OPEN=1
   AUSTERE_AXI_HOST  AUSTERE_AXI_NO_TAILSCALE=1  AUSTERE_AXI_DISCONNECT_GRACE_MS (300000)
   AUSTERE_AXI_IDLE_TIMEOUT_MS (1800000)  AUSTERE_AXI_PERSIST=1  AUSTERE_AXI_ALLOWED_HOSTS  AUSTERE_AXI_LINK_URL
-  AUSTERE_AXI_NPM_REGISTRY
+  AUSTERE_AXI_NPM_REGISTRY  CHROME_PATH (check --render)
 `;
+}
 var COMMANDS = {
   open: {
     usage: "<file> [--no-open] [--reopen]",
@@ -30028,9 +30317,12 @@ var COMMANDS = {
     example: "feedback plan.html"
   },
   check: {
-    usage: "check <file> [--fix]",
+    usage: "check <file> [--fix] [--render]",
     summary: "validate the program without a browser: syntax, components, props, references, reachability",
-    flags: { fix: 'declare the packs the page uses (writes the <meta name="austere-packs"> tag)' },
+    flags: {
+      fix: 'declare the packs the page uses (writes the <meta name="austere-packs"> tag)',
+      render: "also render it in headless Chrome and report render errors and sideways scrolling as text (needs Chrome or CHROME_PATH); only when the user asks"
+    },
     example: "check plan.html"
   },
   patch: {
@@ -30135,7 +30427,7 @@ function needFile(file3, cmd) {
     return null;
   }
   const abs = canonicalFile(file3);
-  if (!fs14.existsSync(abs)) {
+  if (!fs15.existsSync(abs)) {
     fail(`no such file: ${abs}`);
     return null;
   }
@@ -30152,7 +30444,7 @@ function readStdin() {
 async function replyText(flags) {
   if (typeof flags["agent-reply-file"] === "string") {
     const f = flags["agent-reply-file"];
-    return (f === "-" ? await readStdin() : fs14.readFileSync(f, "utf8")).trim();
+    return (f === "-" ? await readStdin() : fs15.readFileSync(f, "utf8")).trim();
   }
   if (typeof flags["agent-reply"] === "string") return flags["agent-reply"].trim();
   return "";
@@ -30191,7 +30483,7 @@ async function cmdHome() {
 async function cmdOpen(file3, flags) {
   const abs = needFile(file3, "open");
   if (!abs || file3 === void 0) return;
-  const html = fs14.readFileSync(abs, "utf8");
+  const html = fs15.readFileSync(abs, "utf8");
   const check2 = checkHtml(html, { file: quote(file3) });
   await ensureServer();
   const r = await request("POST", "/api/open", { file: abs, reopen: !!flags.reopen });
@@ -30230,7 +30522,7 @@ function quote(file3) {
 function describeItems(abs, items) {
   let lines = /* @__PURE__ */ new Map();
   try {
-    lines = statementLines(fs14.readFileSync(abs, "utf8"));
+    lines = statementLines(fs15.readFileSync(abs, "utf8"));
   } catch {
   }
   const at2 = locator(lines);
@@ -30247,14 +30539,14 @@ function describeItems(abs, items) {
 }
 function thirdPartyOf(abs) {
   try {
-    return pagePacks(fs14.readFileSync(abs, "utf8")).thirdParty.map((p) => `${p.name}@${p.version}`);
+    return pagePacks(fs15.readFileSync(abs, "utf8")).thirdParty.map((p) => `${p.name}@${p.version}`);
   } catch {
     return [];
   }
 }
 var NEXT = {
-  feedback: (f, cursor) => `Apply it by editing the named statements in place (keep names stable; the page live-updates and highlights changes). Run \`${BIN2} check ${f}\` if you restructured, then \`${BIN2} poll ${f} --cursor ${cursor} --agent-reply "<one line: what changed>"\`.`,
-  feedbackEnded: (f, cursor) => `The reviewer sent this and ended the review. Apply it, then \`${BIN2} reply ${f} --cursor ${cursor} --agent-reply "<what changed>"\` and summarize in chat. Do not poll or reopen.`,
+  feedback: (f, cursor) => `Revise with \`${BIN2} patch ${f}\`: send only the changed statements on stdin (same name replaces, new name adds); do not rewrite or re-read the file. Then \`${BIN2} poll ${f} --cursor ${cursor} --agent-reply "<one line: what changed>"\`.`,
+  feedbackEnded: (f, cursor) => `The reviewer sent this and ended the review. Apply it with \`${BIN2} patch ${f}\` (changed statements only), then \`${BIN2} reply ${f} --cursor ${cursor} --agent-reply "<what changed>"\` and summarize in chat. Do not poll or reopen.`,
   ended: (f) => `The review ended. Stop polling and continue in chat. Notes the reviewer adds later are kept for the next poll. Reopen only if the user asks (\`${BIN2} ${f} --reopen\`).`,
   browser_disconnected: (f) => `Every review tab has been closed for a while. Stop polling and continue in chat; do not end the review. Notes the reviewer adds later are kept, and \`${BIN2} poll ${f}\` returns them.`,
   replaced: () => "Another poll took over this session. Stop polling here.",
@@ -30273,7 +30565,7 @@ async function cmdPoll(file3, flags) {
   if (!reply && (flags["agent-reply"] !== void 0 || flags["agent-reply-file"] !== void 0)) {
     return fail("the agent reply is empty");
   }
-  process.stderr.write(`[${BIN2}] waiting for feedback on ${path14.basename(abs)} (interrupting is safe: feedback stays queued)
+  process.stderr.write(`[${BIN2}] waiting for feedback on ${path15.basename(abs)} (interrupting is safe: feedback stays queued)
 `);
   const ticker = process.stderr.isTTY ? setInterval(() => process.stderr.write(`[${BIN2}] still waiting\u2026
 `), 6e4) : null;
@@ -30370,13 +30662,13 @@ function fixPacks(abs, html) {
     return { html, changes };
   }
   const out = setPacksMeta(html, next);
-  if (out !== html) fs14.writeFileSync(abs, out);
+  if (out !== html) fs15.writeFileSync(abs, out);
   return { html: out, changes: changes.length ? changes : ["updated integrity hashes"] };
 }
 async function cmdCheck(file3, flags = {}) {
   const abs = needFile(file3, "check");
   if (!abs || file3 === void 0) return;
-  let html = fs14.readFileSync(abs, "utf8");
+  let html = fs15.readFileSync(abs, "utf8");
   let fixed = [];
   if (flags.fix) ({ html, changes: fixed } = fixPacks(abs, html));
   const result = checkHtml(html, { file: quote(file3) });
@@ -30385,9 +30677,30 @@ async function cmdCheck(file3, flags = {}) {
   if (fixed.length) out.fixed = fixed;
   if (result.errors.length) out.errors = result.errors;
   if (result.warnings.length) out.warnings = result.warnings;
-  if (result.ok && result.hasMermaid) out.note = "Mermaid sources are checked only when they render in the review page.";
+  if (flags.render) {
+    if (!result.ok) out.render = "skipped: fix the errors above first";
+    else {
+      const render = await renderOut(html);
+      out.render = render;
+      if (render.errors) out.status = "errors";
+      else if (render.status === "unavailable") out.status = "render_unavailable";
+    }
+  } else if (result.ok && result.hasMermaid) {
+    out.note = "Mermaid sources are checked when the review page renders them; failures come back through poll.";
+  }
   print(out);
-  if (!result.ok) process.exitCode = 1;
+  if (out.status !== "ok") process.exitCode = 1;
+}
+async function renderOut(html) {
+  const r = await renderCheck(html);
+  if (r.status === "unavailable") return { status: "unavailable", reason: r.reason };
+  const out = { status: r.errors.length ? "errors" : "clean", widths: "1280, 390", statements: r.statements };
+  if (r.errors.length) out.errors = r.errors.map((e) => ({ statement: e.statement || "(page)", message: e.error }));
+  if (r.overflow.length) {
+    out.scrolls_sideways = r.overflow.map((o) => ({ width: o.width, statements: o.statements.length ? o.statements.join(", ") : "(not one statement)" }));
+  }
+  if (r.notices.length) out.notices = r.notices;
+  return out;
 }
 async function cmdPatch(file3) {
   const abs = needFile(file3, "patch");
@@ -30395,7 +30708,7 @@ async function cmdPatch(file3) {
   if (process.stdin.isTTY) return usage(`pipe the changed statements on stdin: ${BIN2} patch ${quote(file3)} <<'EOF' ... EOF`, "patch");
   const patch = await readStdin();
   if (!patch.trim()) return fail("stdin was empty");
-  const html = fs14.readFileSync(abs, "utf8");
+  const html = fs15.readFileSync(abs, "utf8");
   const art = readArtifact(html);
   if (art.program == null) return fail('no <script type="text/openui"> block to patch');
   const merged = mergeStatements(art.program.trim(), patch.trim(), "root");
@@ -30403,7 +30716,7 @@ async function cmdPatch(file3) {
   const patched = new Set(splitStatements(patch).filter((s) => !/=\s*null\s*;?$/.test(s.text)).map((s) => s.id));
   const dropped = [...patched].filter((id) => !kept.has(id));
   const next = replaceProgram(html, merged);
-  fs14.writeFileSync(abs, next);
+  fs15.writeFileSync(abs, next);
   const result = checkHtml(next, { file: quote(file3) });
   await registerWithHub(abs, result.title, sessionId(abs));
   const out = { status: "patched", file: abs };
@@ -30418,7 +30731,7 @@ function packSpec(p) {
   return lines.join("\n") + "\n";
 }
 function cmdSpec(groups) {
-  let text = fs14.readFileSync(assetPath("prompt.md"), "utf8");
+  let text = fs15.readFileSync(assetPath("prompt.md"), "utf8");
   const packs = installedPacks();
   const packArgs = groups.filter((g) => packs.some((p) => p.name === g));
   if (packArgs.length) {
@@ -30452,9 +30765,9 @@ ${trimmed.join("\n")}
 function cmdExport(file3, flags) {
   const abs = needFile(file3, "export");
   if (!abs) return;
-  const out = typeof flags.out === "string" ? path14.resolve(flags.out) : abs.replace(/\.html?$/i, "") + ".export.html";
-  const { html, notices } = exportHtml(fs14.readFileSync(abs, "utf8"));
-  fs14.writeFileSync(out, html);
+  const out = typeof flags.out === "string" ? path15.resolve(flags.out) : abs.replace(/\.html?$/i, "") + ".export.html";
+  const { html, notices } = exportHtml(fs15.readFileSync(abs, "utf8"));
+  fs15.writeFileSync(out, html);
   print({ status: "exported", file: out, bytes: html.length, notices: notices.length ? notices : void 0 });
 }
 function printResult(out) {
@@ -30514,7 +30827,7 @@ async function cmdComponents(sub, args, flags) {
           pack: r.name,
           dir: r.dir,
           files: r.files,
-          next: `cd ${quote(path14.relative(process.cwd(), r.dir) || ".")} && npm install && npm run build, then \`${BIN2} components add .\``
+          next: `cd ${quote(path15.relative(process.cwd(), r.dir) || ".")} && npm install && npm run build, then \`${BIN2} components add .\``
         });
       } catch (err) {
         return fail(messageOf(err));
@@ -30596,7 +30909,7 @@ async function cmdFeedback(file3, flags) {
     file: abs,
     review: status,
     items,
-    next: `Apply what still applies (edit the named statements; names are stable), then \`${BIN2} reply ${f} --agent-reply "<what changed>"\`, which marks it addressed. To continue live with the reviewer: \`${BIN2} ${f}\`${status === "ended" ? " --reopen, if the user asks" : ""}, then poll.`
+    next: `Apply what still applies with \`${BIN2} patch ${f}\` (changed statements only; names are stable), then \`${BIN2} reply ${f} --agent-reply "<what changed>"\`, which marks it addressed. To continue live with the reviewer: \`${BIN2} ${f}\`${status === "ended" ? " --reopen, if the user asks" : ""}, then poll.`
   });
 }
 async function cmdHub(sub, args, flags) {
@@ -30625,7 +30938,7 @@ async function cmdHub(sub, args, flags) {
         server: h ? `running on ${port()}${h.persist ? " (persist)" : ""}` : "not running"
       };
       if (hubEnabled() && h) out.url = url2;
-      if (fs14.existsSync(hubDbFile())) {
+      if (fs15.existsSync(hubDbFile())) {
         try {
           const hub = await Hub.open();
           try {
@@ -30641,8 +30954,8 @@ async function cmdHub(sub, args, flags) {
       return print(out);
     }
     case "list": {
-      if (!fs14.existsSync(hubDbFile())) return print({ artifacts: "none", next: `\`${BIN2} hub on\` starts indexing.` });
-      const project = typeof flags.project === "string" ? path14.resolve(flags.project) : "";
+      if (!fs15.existsSync(hubDbFile())) return print({ artifacts: "none", next: `\`${BIN2} hub on\` starts indexing.` });
+      const project = typeof flags.project === "string" ? path15.resolve(flags.project) : "";
       let hub;
       try {
         hub = await Hub.open();
@@ -30667,8 +30980,8 @@ async function cmdHub(sub, args, flags) {
       });
     }
     case "notes": {
-      if (!fs14.existsSync(hubDbFile())) return print({ notes: "none", next: `\`${BIN2} hub on\` starts indexing.` });
-      const project = typeof flags.project === "string" ? path14.resolve(flags.project) : "";
+      if (!fs15.existsSync(hubDbFile())) return print({ notes: "none", next: `\`${BIN2} hub on\` starts indexing.` });
+      const project = typeof flags.project === "string" ? path15.resolve(flags.project) : "";
       let hub;
       try {
         hub = await Hub.open();
@@ -30688,7 +31001,7 @@ async function cmdHub(sub, args, flags) {
           text: r.text || void 0,
           target: r.target || void 0,
           status: r.status === "addressed" ? "answered" : r.status === "held" ? "held" : "unanswered",
-          page: r.title || path14.basename(r.file),
+          page: r.title || path15.basename(r.file),
           file: r.file,
           sent: shortDate(r.at)
         })),
@@ -30812,7 +31125,7 @@ async function main() {
   let name = null;
   if (cmd !== void 0) {
     if (Object.hasOwn(COMMANDS, cmd)) name = cmd;
-    else if (/\.html?$/i.test(cmd) || fs14.existsSync(cmd)) name = "open";
+    else if (/\.html?$/i.test(cmd) || fs15.existsSync(cmd)) name = "open";
     else if (flags.help) return process.stdout.write(HELP);
     else return usage(`unknown command: ${cmd}. One of: ${Object.keys(COMMANDS).join(" ")}, or a page file`);
   }
@@ -30868,7 +31181,8 @@ async function main() {
       return cmdOpen(rest[0], flags);
     case "help":
       if (!rest[0]) return process.stdout.write(HELP);
-      if (!Object.hasOwn(COMMANDS, rest[0])) return usage(`no command named ${rest[0]}. One of: ${Object.keys(COMMANDS).join(" ")}`, "help");
+      if (rest[0] === "all") return process.stdout.write(HELP + helpAll());
+      if (!Object.hasOwn(COMMANDS, rest[0])) return usage(`no command named ${rest[0]}. One of: all ${Object.keys(COMMANDS).join(" ")}`, "help");
       return commandHelp(rest[0]);
     default:
       return cmdOpen(cmd, flags);