ryugi-artifacts 1.66.0 → 1.67.0

package/dist/server.cjs

@@ -48378,12 +48378,12 @@ var require_websocket_server = __commonJS({
 // src/server/main.ts
 var import_node_child_process5 = require("node:child_process");
 var import_node_crypto13 = __toESM(require("node:crypto"), 1);
-var import_node_fs45 = __toESM(require("node:fs"), 1);
+var import_node_fs46 = __toESM(require("node:fs"), 1);
 var import_node_os2 = __toESM(require("node:os"), 1);
-var import_node_path41 = __toESM(require("node:path"), 1);
+var import_node_path42 = __toESM(require("node:path"), 1);
 
 // package.json
-var version = "1.66.0";
+var version = "1.67.0";
 
 // src/server/browser-focus.ts
 var import_node_child_process = require("node:child_process");
@@ -49189,9 +49189,9 @@ function clearCredentials(file) {
 }
 
 // src/server/hub.ts
-var import_node_fs42 = __toESM(require("node:fs"), 1);
+var import_node_fs43 = __toESM(require("node:fs"), 1);
 var import_node_http2 = __toESM(require("node:http"), 1);
-var import_node_path39 = __toESM(require("node:path"), 1);
+var import_node_path40 = __toESM(require("node:path"), 1);
 
 // src/server/access.ts
 var LOOPBACK = /* @__PURE__ */ new Set(["localhost", "::1", "[::1]"]);
@@ -49218,9 +49218,9 @@ var originAllowed = (policy, origin, { cloud = false } = {}) => origin === void
 var navigationAllowed = (secFetchSite) => secFetchSite === void 0 || secFetchSite === "none" || secFetchSite === "same-origin";
 
 // src/server/app.ts
-var import_node_fs39 = __toESM(require("node:fs"), 1);
+var import_node_fs40 = __toESM(require("node:fs"), 1);
 var import_node_http = __toESM(require("node:http"), 1);
-var import_node_path36 = __toESM(require("node:path"), 1);
+var import_node_path37 = __toESM(require("node:path"), 1);
 
 // src/shared/cloud.ts
 var MAX_ARTIFACT_BYTES = 20 * 1024 * 1024;
@@ -49626,9 +49626,9 @@ function watchArtifacts(ctx) {
 var PAGE_CSP = "sandbox allow-scripts allow-modals allow-forms allow-popups allow-downloads";
 var DOCUMENT_ASSET_CSP = "sandbox; default-src 'none'";
 var ISOLATED_BOARD_CSP = "worker-src 'none'";
-function contentCsp(type, path44, ownOrigin) {
+function contentCsp(type, path45, ownOrigin) {
   if (type === "html") return PAGE_CSP;
-  if (type === "document") return path44.endsWith(".html") ? PAGE_CSP : DOCUMENT_ASSET_CSP;
+  if (type === "document") return path45.endsWith(".html") ? PAGE_CSP : DOCUMENT_ASSET_CSP;
   return ownOrigin ? ISOLATED_BOARD_CSP : "sandbox allow-scripts";
 }
 
@@ -49656,8 +49656,8 @@ function routeBoardRequest(req, pathname) {
 }
 
 // src/server/context.ts
-var import_node_fs35 = __toESM(require("node:fs"), 1);
-var import_node_path32 = __toESM(require("node:path"), 1);
+var import_node_fs36 = __toESM(require("node:fs"), 1);
+var import_node_path33 = __toESM(require("node:path"), 1);
 
 // src/server/agent-review.ts
 var import_node_crypto5 = __toESM(require("node:crypto"), 1);
@@ -50855,20 +50855,41 @@ function createAvatars(fetchImpl = fetch) {
   };
 }
 
+// src/shared/artifact-kinds.ts
+var ARTIFACT_KINDS = [
+  { type: "document", refAttribute: "document", subTargets: [], splitPane: true },
+  { type: "artboard", refAttribute: "artboard", subTargets: ["group", "board"], splitPane: true },
+  {
+    type: "whiteboard",
+    refAttribute: "whiteboard",
+    subTargets: ["page", "frame"],
+    splitPane: true
+  },
+  { type: "html", refAttribute: "html", subTargets: [], splitPane: true }
+];
+var REF_KIND_NAMES = ARTIFACT_KINDS.map(
+  (kind) => kind.refAttribute
+);
+var REF_SUB_TARGETS = [
+  ...new Set(ARTIFACT_KINDS.flatMap((kind) => kind.subTargets))
+];
+function artifactKind(type) {
+  return ARTIFACT_KINDS.find((kind) => kind.type === type) ?? null;
+}
+
 // src/shared/ref.ts
 var isRefNode = (node) => node.type === "ref";
-var refTarget = (node) => ({
-  ...node.artboard !== void 0 ? { artboard: node.artboard } : {},
-  ...node.whiteboard ? { whiteboard: node.whiteboard } : {},
-  ...node.to ? { to: node.to } : {},
-  ...node.group ? { group: node.group } : {},
-  ...node.board ? { board: node.board } : {},
-  ...node.frame ? { frame: node.frame } : {},
-  ...node.page ? { page: node.page } : {},
-  ...node.label ? { label: node.label } : {}
-});
-var refKind = (ref) => ref.whiteboard ? "whiteboard" : "artboard";
-var refSlug = (ref) => ref.whiteboard ?? ref.artboard ?? "";
+var refKinds = (ref) => REF_KIND_NAMES.filter((kind) => ref[kind] !== void 0);
+var refTarget = (node) => {
+  const target = {};
+  for (const kind of REF_KIND_NAMES) if (node[kind] !== void 0) target[kind] = node[kind];
+  if (node.to) target.to = node.to;
+  for (const sub2 of REF_SUB_TARGETS) if (node[sub2]) target[sub2] = node[sub2];
+  if (node.label) target.label = node.label;
+  return target;
+};
+var refKind = (ref) => refKinds(ref)[0] ?? "artboard";
+var refSlug = (ref) => ref[refKind(ref)] ?? "";
 var refKey = (ref) => ref.frame ?? (ref.page ? `page:${ref.page}` : void 0) ?? ref.group ?? ref.board ?? "";
 function refsIn(state2) {
   const found = [];
@@ -50888,7 +50909,7 @@ function backlinksFor(slug, artboardId, docs, kind = "artboard") {
       if (refKind(ref) !== kind || refSlug(ref) !== slug) continue;
       if (ref.to && ref.to !== artboardId) continue;
       const key2 = refKey(ref);
-      (backlinks[key2] ??= []).push({ document: document2, blockId: ref.blockId });
+      (backlinks[key2] ??= []).push({ from: document2, fromType: "document", blockId: ref.blockId });
     }
   }
   return backlinks;
@@ -50897,7 +50918,7 @@ function backlinkWarnings(backlinks, canvas) {
   if (!canvas) return [];
   return Object.entries(backlinks).flatMap(
     ([key2, entries2]) => key2 && !canvas.groups.includes(key2) && !canvas.boards.includes(key2) ? entries2.map(
-      ({ document: document2, blockId: blockId2 }) => `document ${document2} block ${blockId2} references ${key2}, which this artboard no longer has`
+      ({ from, fromType, blockId: blockId2 }) => `${fromType} ${from} block ${blockId2} references ${key2}, which this artboard no longer has`
     ) : []
   );
 }
@@ -51811,6 +51832,36 @@ function createBoardCommentRegistry(options2) {
   };
 }
 
+// src/server/cascade-deps.ts
+var import_node_fs16 = __toESM(require("node:fs"), 1);
+var import_node_path13 = __toESM(require("node:path"), 1);
+var REF_TARGET = new RegExp(
+  `<ref\\b[^>]*?\\b(${ARTIFACT_KINDS.map((kind) => kind.refAttribute).join("|")})="([^"]+)"`,
+  "g"
+);
+var typeOfAttribute = new Map(
+  ARTIFACT_KINDS.map((kind) => [kind.refAttribute, kind.type])
+);
+var REFERENCES_OF = {
+  document: (dir) => {
+    const file = import_node_path13.default.join(dir, "doc.xml");
+    const xml = import_node_fs16.default.existsSync(file) ? import_node_fs16.default.readFileSync(file, "utf8") : "";
+    return [...xml.matchAll(REF_TARGET)].map(
+      (match) => `${typeOfAttribute.get(match[1])}/${match[2]}`
+    );
+  }
+};
+function referencesOf(root, key2) {
+  const ref = artifactKeyOf(key2);
+  const dir = ref && resolveArtifactDir(root, ref.type, ref.id);
+  const extract = ref && REFERENCES_OF[ref.type];
+  if (!dir || !extract) return [];
+  return [...new Set(extract(dir))].filter((target) => {
+    const each = artifactKeyOf(target);
+    return !!each && resolveArtifactDir(root, each.type, each.id) !== null;
+  });
+}
+
 // src/server/cloud.ts
 var import_node_crypto10 = __toESM(require("node:crypto"), 1);
 
@@ -51826,6 +51877,84 @@ function formatBytes(bytes) {
   return `${unit === 0 ? value : Number(value.toFixed(1))} ${UNITS[unit]}`;
 }
 
+// src/shared/cascade.ts
+var ACTIONABLE = ["unpublished", "stale", "private", "withdrawn"];
+var CHECKED_BY_DEFAULT = ["unpublished", "stale"];
+function stateOf(status, visibility) {
+  const needed = !status.published ? status.withdrawn ? "withdrawn" : "unpublished" : visibility === "public" && status.visibility === "private" ? "private" : status.stale ? "stale" : "ready";
+  return status.blocked && needed !== "private" && needed !== "ready" ? "blocked" : needed;
+}
+var visibleNow = (status, visibility) => status.published && (visibility === "private" || status.visibility === "public");
+async function buildCascade(root, visibility, deps) {
+  const items = /* @__PURE__ */ new Map();
+  const queue = [root];
+  for (let at7 = 0; at7 < queue.length; at7++) {
+    const from = queue[at7];
+    for (const key2 of new Set(await deps.referencesOf(from))) {
+      if (key2 === root) continue;
+      const known = items.get(key2);
+      if (known) {
+        if (!known.parents.includes(from)) known.parents.push(from);
+        continue;
+      }
+      const status = await deps.statusOf(key2);
+      if (!status) continue;
+      const state2 = stateOf(status, visibility);
+      items.set(key2, {
+        artifact: key2,
+        title: status.title,
+        via: from === root ? null : from,
+        parents: [from],
+        state: state2,
+        open: visibleNow(status, visibility),
+        checked: CHECKED_BY_DEFAULT.includes(state2),
+        selectable: ACTIONABLE.includes(state2),
+        ...state2 === "blocked" && status.blocked ? { blocked: status.blocked } : {},
+        ...status.stale && !status.blocked ? { changed: true } : {}
+      });
+      queue.push(key2);
+    }
+  }
+  return resolveSelection([...items.values()], {}, root);
+}
+function resolveSelection(items, overrides, root) {
+  const byKey = new Map(items.map((item2) => [item2.artifact, item2]));
+  const wanted = (item2) => ACTIONABLE.includes(item2.state) && (overrides[item2.artifact] ?? CHECKED_BY_DEFAULT.includes(item2.state));
+  const isRoot = (key2) => root ? key2 === root : !byKey.has(key2);
+  const reachable = /* @__PURE__ */ new Set();
+  const opens = (key2) => {
+    if (isRoot(key2)) return true;
+    const item2 = byKey.get(key2);
+    return !!item2 && reachable.has(key2) && (item2.open || wanted(item2));
+  };
+  for (let changed = true; changed; ) {
+    changed = false;
+    for (const item2 of items) {
+      if (reachable.has(item2.artifact) || !item2.parents.some(opens)) continue;
+      reachable.add(item2.artifact);
+      changed = true;
+    }
+  }
+  return items.map((item2) => {
+    const { reason: _reason, upstream: _upstream, ...rest } = item2;
+    const reason = item2.state === "blocked" ? item2.blocked : void 0;
+    if (!reachable.has(item2.artifact))
+      return {
+        ...rest,
+        checked: false,
+        selectable: false,
+        reason: "upstream",
+        upstream: item2.via ?? item2.parents[0]
+      };
+    return {
+      ...rest,
+      checked: wanted(item2),
+      selectable: ACTIONABLE.includes(item2.state),
+      ...reason ? { reason } : {}
+    };
+  });
+}
+
 // src/shared/cloud-error.ts
 function cloudErrorDetails(value) {
   if (!value || typeof value !== "object") return {};
@@ -52141,8 +52270,8 @@ function callbackPage(result, locale = "en") {
 }
 
 // src/server/config.ts
-var import_node_fs16 = __toESM(require("node:fs"), 1);
-var import_node_path13 = __toESM(require("node:path"), 1);
+var import_node_fs17 = __toESM(require("node:fs"), 1);
+var import_node_path14 = __toESM(require("node:path"), 1);
 var defaults = () => ({ version: 1, artifacts: {} });
 function isCloudRecord(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -52183,7 +52312,7 @@ function normalize(raw) {
 function readConfig(file) {
   let text5;
   try {
-    text5 = import_node_fs16.default.readFileSync(file, "utf8");
+    text5 = import_node_fs17.default.readFileSync(file, "utf8");
   } catch {
     return { config: defaults() };
   }
@@ -52198,22 +52327,22 @@ function readConfig(file) {
 }
 var IGNORED = ["config.json", "artifacts/*", "!artifacts/document/", "artifacts/document/*/.artifact-id"];
 function ensureGitignore(dir) {
-  const file = import_node_path13.default.join(dir, ".gitignore");
+  const file = import_node_path14.default.join(dir, ".gitignore");
   let current = "";
   try {
-    current = import_node_fs16.default.readFileSync(file, "utf8");
+    current = import_node_fs17.default.readFileSync(file, "utf8");
   } catch {
   }
   const present = new Set(current.split(/\r?\n/).map((line2) => line2.trim()));
   const missing = IGNORED.filter((line2) => !present.has(line2));
   if (missing.length === 0) return;
-  import_node_fs16.default.writeFileSync(file, `${current}${current === "" || current.endsWith("\n") ? "" : "\n"}${missing.join("\n")}
+  import_node_fs17.default.writeFileSync(file, `${current}${current === "" || current.endsWith("\n") ? "" : "\n"}${missing.join("\n")}
 `);
 }
 function ensureConfig(file) {
-  import_node_fs16.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
-  ensureGitignore(import_node_path13.default.dirname(file));
-  if (!import_node_fs16.default.existsSync(file)) writeJsonAtomic(file, defaults());
+  import_node_fs17.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true });
+  ensureGitignore(import_node_path14.default.dirname(file));
+  if (!import_node_fs17.default.existsSync(file)) writeJsonAtomic(file, defaults());
 }
 function updateArtifactConfig(file, key2, patch) {
   const { config, warning } = readConfig(file);
@@ -52233,27 +52362,27 @@ function setProjectAutoPublish(file, value) {
   if (warning) throw new Error(warning);
   if (value === null) delete config.autoPublish;
   else config.autoPublish = value;
-  import_node_fs16.default.mkdirSync(import_node_path13.default.dirname(file), { recursive: true });
+  import_node_fs17.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true });
   writeJsonAtomic(file, config);
 }
 
 // src/server/host-id.ts
-var import_node_fs17 = __toESM(require("node:fs"), 1);
-var import_node_path14 = __toESM(require("node:path"), 1);
+var import_node_fs18 = __toESM(require("node:fs"), 1);
+var import_node_path15 = __toESM(require("node:path"), 1);
 function hostIdFor(credentialsFile2) {
-  const file = import_node_path14.default.join(import_node_path14.default.dirname(credentialsFile2), "host-id");
+  const file = import_node_path15.default.join(import_node_path15.default.dirname(credentialsFile2), "host-id");
   const saved = readPersisted(file);
   if (/^[\w-]{16,64}$/.test(saved)) return saved;
   const id3 = randomToken();
-  import_node_fs17.default.mkdirSync(import_node_path14.default.dirname(file), { recursive: true, mode: 448 });
-  import_node_fs17.default.writeFileSync(file, `${id3}
+  import_node_fs18.default.mkdirSync(import_node_path15.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs18.default.writeFileSync(file, `${id3}
 `, { mode: 384 });
   return id3;
 }
 
 // src/server/pack.ts
-var import_node_fs18 = __toESM(require("node:fs"), 1);
-var import_node_path15 = __toESM(require("node:path"), 1);
+var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_path16 = __toESM(require("node:path"), 1);
 var ArtifactTooLarge = class extends Error {
 };
 var excluded = (type, relative) => (type === "document" || type === "artboard" || type === "whiteboard") && relative === "comments.json";
@@ -52262,7 +52391,7 @@ var pageListOf = (dir, type, overrides) => {
   if (overrides?.has(PAGES_FILE))
     return parsePages(overrides.get(PAGES_FILE)?.toString("utf8") ?? null).pages;
   try {
-    return parsePages(import_node_fs18.default.readFileSync(import_node_path15.default.join(dir, PAGES_FILE), "utf8")).pages;
+    return parsePages(import_node_fs19.default.readFileSync(import_node_path16.default.join(dir, PAGES_FILE), "utf8")).pages;
   } catch {
     return [];
   }
@@ -52272,7 +52401,7 @@ function packArtifact(dir, type, {
   maxBytes = MAX_ARTIFACT_BYTES,
   overrides: given
 } = {}) {
-  const rootReal = import_node_fs18.default.realpathSync(dir);
+  const rootReal = import_node_fs19.default.realpathSync(dir);
   const pages = pageListOf(dir, type, given);
   const deletedPages = new Set(
     pages.filter((page) => isDeletedPage(page) && isPageId(page.id)).map((page) => pageFileOf(page.id))
@@ -52285,17 +52414,17 @@ function packArtifact(dir, type, {
   const visited = /* @__PURE__ */ new Set([rootReal]);
   let total = 0;
   const walk = (current) => {
-    for (const entry of import_node_fs18.default.readdirSync(current, { withFileTypes: true })) {
+    for (const entry of import_node_fs19.default.readdirSync(current, { withFileTypes: true })) {
       if (entry.name.startsWith(".")) continue;
-      const full = import_node_path15.default.join(current, entry.name);
+      const full = import_node_path16.default.join(current, entry.name);
       let real;
       try {
-        real = import_node_fs18.default.realpathSync(full);
+        real = import_node_fs19.default.realpathSync(full);
       } catch {
         continue;
       }
-      if (!real.startsWith(rootReal + import_node_path15.default.sep)) continue;
-      const stat = import_node_fs18.default.statSync(real);
+      if (!real.startsWith(rootReal + import_node_path16.default.sep)) continue;
+      const stat = import_node_fs19.default.statSync(real);
       if (stat.isDirectory()) {
         if (visited.has(real)) continue;
         visited.add(real);
@@ -52303,7 +52432,7 @@ function packArtifact(dir, type, {
         continue;
       }
       if (!stat.isFile()) continue;
-      const relative = import_node_path15.default.relative(dir, full).split(import_node_path15.default.sep).join("/");
+      const relative = import_node_path16.default.relative(dir, full).split(import_node_path16.default.sep).join("/");
       if (excluded(type, relative) || deletedPages.has(relative)) continue;
       if (!overrides?.has(relative)) total += stat.size;
       found.push({ path: relative, real });
@@ -52317,14 +52446,14 @@ function packArtifact(dir, type, {
     );
   }
   return [
-    ...found.filter((file) => !overrides?.has(file.path)).map((file) => ({ path: file.path, data: import_node_fs18.default.readFileSync(file.real) })),
+    ...found.filter((file) => !overrides?.has(file.path)).map((file) => ({ path: file.path, data: import_node_fs19.default.readFileSync(file.real) })),
     ...[...overrides ?? []].flatMap(([file, data]) => data ? [{ path: file, data }] : [])
   ];
 }
 
 // src/server/publish-payload.ts
-var import_node_fs20 = __toESM(require("node:fs"), 1);
-var import_node_path17 = __toESM(require("node:path"), 1);
+var import_node_fs21 = __toESM(require("node:fs"), 1);
+var import_node_path18 = __toESM(require("node:path"), 1);
 
 // src/shared/whiteboard/scene.ts
 var BOOKKEEPING = /* @__PURE__ */ new Set(["version", "versionNonce", "updated", "seed", "customData"]);
@@ -64872,63 +65001,57 @@ function registerRef(registry2) {
   const previous = registry2.getReader(CARRIER);
   registry2.registerReader(CARRIER, (el3, ctx) => {
     if (!el3.hasAttribute(MARK3)) return previous ? previous(el3, ctx) : false;
-    const attr = (name) => el3.getAttribute(name) ?? void 0;
-    return {
-      type: "ref",
-      version: 1,
-      ...refTarget({
-        artboard: attr("artboard"),
-        whiteboard: attr("whiteboard"),
-        to: attr("to"),
-        group: attr("group"),
-        board: attr("board"),
-        frame: attr("frame"),
-        page: attr("page"),
-        label: el3.textContent ?? void 0
-      })
-    };
+    const target = {};
+    for (const name of [...REF_KIND_NAMES, "to", ...REF_SUB_TARGETS]) {
+      const value = el3.getAttribute(name);
+      if (value !== null) target[name] = value;
+    }
+    target.label = el3.textContent ?? void 0;
+    return { type: "ref", version: 1, ...refTarget(target) };
   });
   registry2.registerWriter("ref", (node) => {
-    const ref = node;
-    const attrs = {
-      [MARK3]: "1",
-      ...ref.artboard !== void 0 ? { artboard: ref.artboard } : {},
-      ...ref.whiteboard ? { whiteboard: ref.whiteboard } : {},
-      ...ref.to ? { to: ref.to } : {},
-      ...ref.group ? { group: ref.group } : {},
-      ...ref.board ? { board: ref.board } : {},
-      ...ref.frame ? { frame: ref.frame } : {},
-      ...ref.page ? { page: ref.page } : {}
-    };
+    const ref = refTarget(node);
+    const attrs = { [MARK3]: "1" };
+    for (const name of [...REF_KIND_NAMES, "to", ...REF_SUB_TARGETS]) {
+      const value = ref[name];
+      if (value !== void 0) attrs[name] = value;
+    }
     if (!ref.label) return { tag: CARRIER, attrs, selfClosing: true };
     return { tag: CARRIER, attrs, children: [ref.label] };
   });
 }
+var NOUN = {
+  document: "a document",
+  artboard: "an artboard",
+  whiteboard: "a whiteboard",
+  html: "an html page"
+};
+var NEEDS = ["artboard", "whiteboard", "document", "html"];
+var either = (items) => items.length === 1 ? items[0] : `${items.slice(0, -1).join(", ")} or ${items.at(-1)}`;
 function refProblem(ref) {
-  if (ref.artboard && ref.whiteboard)
-    return `<ref> names either an artboard or a whiteboard, not both`;
-  if (ref.whiteboard !== void 0) {
-    if (!isArtifactId(ref.whiteboard))
-      return `<ref whiteboard="${ref.whiteboard}"> is not a whiteboard slug: lowercase letters, digits and hyphens`;
-    if (ref.group || ref.board)
-      return `<ref whiteboard="${ref.whiteboard}"> points at a frame with frame="\u2026", not a group or a board`;
-    if (ref.page && ref.frame)
-      return `<ref whiteboard="${ref.whiteboard}"> names either a page or a frame, not both`;
-    if (ref.page !== void 0 && !isPageId(ref.page))
-      return `<ref whiteboard="${ref.whiteboard}" page="${ref.page}"> is not a page id: lowercase letters, digits and hyphens`;
-    return null;
-  }
-  if (ref.page !== void 0)
-    return `<ref artboard="${ref.artboard ?? ""}" page="${ref.page}">: page belongs to whiteboard references`;
-  if (ref.frame && ref.artboard)
-    return `<ref artboard="${ref.artboard}" frame="${ref.frame}">: frame belongs to whiteboard references`;
-  if (!ref.artboard && ref.frame)
-    return "<ref> needs an artboard or a whiteboard: the slug of one in this project";
-  if (!ref.artboard) return "<ref> needs an artboard: the slug of an artboard in this project";
-  if (!isArtifactId(ref.artboard))
-    return `<ref artboard="${ref.artboard}"> is not an artboard slug: lowercase letters, digits and hyphens`;
-  if (ref.group && ref.board)
-    return `<ref artboard="${ref.artboard}"> names either a group or a board, not both`;
+  const kinds2 = refKinds(ref);
+  if (kinds2.length > 1)
+    return `<ref> names one target: either ${either(kinds2.map((kind2) => NOUN[kind2]))}, not both`;
+  const kind = kinds2[0];
+  if (!kind)
+    return `<ref> needs ${either(NEEDS.map((name) => NOUN[name]))}: the slug of one in this project`;
+  const slug = ref[kind] ?? "";
+  const at7 = `<ref ${kind}="${slug}">`;
+  if (!isArtifactId(slug))
+    return `${at7} is not ${NOUN[kind].replace(/ page$/, "")} slug: lowercase letters, digits and hyphens`;
+  const allowed = artifactKind(kind)?.subTargets ?? [];
+  const named3 = REF_SUB_TARGETS.filter((sub2) => ref[sub2] !== void 0);
+  for (const sub2 of named3) {
+    if (allowed.includes(sub2)) continue;
+    const owners = ARTIFACT_KINDS.filter(
+      (each) => each.subTargets.includes(sub2)
+    ).map((each) => each.type);
+    const takes = allowed.length ? `${NOUN[kind]} reference takes ${either(allowed)}` : `${NOUN[kind]} reference takes no sub-target`;
+    return `${at7} has no ${sub2}: ${sub2} belongs to ${either(owners)} references; ${takes}`;
+  }
+  if (named3.length > 1) return `${at7} names either a ${named3[0]} or a ${named3[1]}, not both`;
+  if (ref.page !== void 0 && !isPageId(ref.page))
+    return `<ref ${kind}="${slug}" page="${ref.page}"> is not a page id: lowercase letters, digits and hyphens`;
   return null;
 }
 function badRefs(state2) {
@@ -66225,31 +66348,31 @@ function injectRuntime(html, options2 = {}) {
 }
 
 // src/server/whiteboard-index.ts
-var import_node_fs19 = __toESM(require("node:fs"), 1);
-var import_node_path16 = __toESM(require("node:path"), 1);
+var import_node_fs20 = __toESM(require("node:fs"), 1);
+var import_node_path17 = __toESM(require("node:path"), 1);
 var readText = (file) => {
   try {
-    return import_node_fs19.default.readFileSync(file, "utf8");
+    return import_node_fs20.default.readFileSync(file, "utf8");
   } catch {
     return null;
   }
 };
 function pageFilesIn(dir) {
   try {
-    return import_node_fs19.default.readdirSync(import_node_path16.default.join(dir, PAGES_DIR)).filter((name) => name.endsWith(".excalidraw")).map((name) => name.slice(0, -".excalidraw".length)).sort();
+    return import_node_fs20.default.readdirSync(import_node_path17.default.join(dir, PAGES_DIR)).filter((name) => name.endsWith(".excalidraw")).map((name) => name.slice(0, -".excalidraw".length)).sort();
   } catch {
     return [];
   }
 }
 function readBoardIndex(dir) {
   const { pages } = normalizePages(
-    parsePages(readText(import_node_path16.default.join(dir, PAGES_FILE))).pages,
+    parsePages(readText(import_node_path17.default.join(dir, PAGES_FILE))).pages,
     pageFilesIn(dir)
   );
   const frames = {};
   const scenes = {};
   for (const page of pages) {
-    const text5 = readText(import_node_path16.default.join(dir, pageFileOf(page.id)));
+    const text5 = readText(import_node_path17.default.join(dir, pageFileOf(page.id)));
     const parsed = text5 === null ? null : parseScene(text5);
     if (!parsed || "error" in parsed) continue;
     scenes[page.id] = parsed.scene;
@@ -66279,11 +66402,11 @@ function publishPayload(ref, dir, title, payload, comments = emptyComments()) {
   if (ref.type === "document")
     return {
       title,
-      state: parseDocument2(import_node_fs20.default.readFileSync(import_node_path17.default.join(dir, "doc.xml"), "utf8")),
+      state: parseDocument2(import_node_fs21.default.readFileSync(import_node_path18.default.join(dir, "doc.xml"), "utf8")),
       comments: sharedComments(comments)
     };
   if (ref.type === "whiteboard") {
-    const parsed = parseScene(import_node_fs20.default.readFileSync(import_node_path17.default.join(dir, "scene.excalidraw"), "utf8"));
+    const parsed = parseScene(import_node_fs21.default.readFileSync(import_node_path18.default.join(dir, "scene.excalidraw"), "utf8"));
     if ("error" in parsed) throw new Error(parsed.error);
     const pages = livePages(readBoardIndex(dir).pages);
     return {
@@ -66317,12 +66440,12 @@ function withCloudRuntime(type, files) {
 }
 
 // src/server/settings.ts
-var import_node_fs21 = __toESM(require("node:fs"), 1);
-var import_node_path18 = __toESM(require("node:path"), 1);
-var settingsFileFor = (credentialsFile2) => import_node_path18.default.join(import_node_path18.default.dirname(credentialsFile2), "config.json");
+var import_node_fs22 = __toESM(require("node:fs"), 1);
+var import_node_path19 = __toESM(require("node:path"), 1);
+var settingsFileFor = (credentialsFile2) => import_node_path19.default.join(import_node_path19.default.dirname(credentialsFile2), "config.json");
 function readSettings(file) {
   try {
-    const raw = JSON.parse(import_node_fs21.default.readFileSync(file, "utf8"));
+    const raw = JSON.parse(import_node_fs22.default.readFileSync(file, "utf8"));
     return typeof raw === "object" && raw !== null && !Array.isArray(raw) ? raw : {};
   } catch {
     return {};
@@ -66333,7 +66456,7 @@ function readGlobalAutoPublish(file) {
   return typeof value === "boolean" ? value : void 0;
 }
 function writeGlobalAutoPublish(file, value) {
-  import_node_fs21.default.mkdirSync(import_node_path18.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs22.default.mkdirSync(import_node_path19.default.dirname(file), { recursive: true, mode: 448 });
   writeJsonAtomic(file, { ...readSettings(file), autoPublish: value });
 }
 function postponeGlobalAutoPublish(file) {
@@ -66342,7 +66465,7 @@ function postponeGlobalAutoPublish(file) {
     writeGlobalAutoPublish(file, false);
     return "off";
   }
-  import_node_fs21.default.mkdirSync(import_node_path18.default.dirname(file), { recursive: true, mode: 448 });
+  import_node_fs22.default.mkdirSync(import_node_path19.default.dirname(file), { recursive: true, mode: 448 });
   writeJsonAtomic(file, { ...settings, autoPublishPostponed: true });
   return "postponed";
 }
@@ -66362,7 +66485,7 @@ var CALLBACK_TICKET_TTL_MS = 30 * 60 * 1e3;
 var UPLOAD_CONCURRENCY = 6;
 var MAX_JSON_BODY = 4096;
 var CLOUD_ID = /^[\w-]{1,64}$/;
-var ROUTE = /^\/api\/cloud\/(status|login|logout|artifacts|publish|publication|reserve|visibility|auto-publish|sync)(?:\/([^/]+)(?:\/([^/]+))?)?$/;
+var ROUTE = /^\/api\/cloud\/(status|login|logout|artifacts|publish|publish-refs|publication|refs|reserve|visibility|auto-publish|sync)(?:\/([^/]+)(?:\/([^/]+))?)?$/;
 var SignedOut = class extends Error {
 };
 var CloudRefused = class extends Error {
@@ -66479,7 +66602,7 @@ function createCloudRoutes(options2) {
     const challenge = import_node_crypto10.default.createHash("sha256").update(verifier).digest("base64url");
     return `${origin}/auth/cli?port=${options2.port()}&state=${state2}&challenge=${challenge}`;
   };
-  const cloudFetch = async (method, path44, body) => {
+  const cloudFetch = async (method, path45, body) => {
     const credentials = readCredentials(credentialsFile2, origin);
     if (!credentials) throw new SignedOut();
     const headers = { Authorization: `Bearer ${credentials.token}` };
@@ -66493,7 +66616,7 @@ function createCloudRoutes(options2) {
     }
     let res;
     try {
-      res = await fetch(`${origin}${path44}`, { method, headers, body: payload });
+      res = await fetch(`${origin}${path45}`, { method, headers, body: payload });
     } catch (err) {
       throw new CloudRefused(502, `could not reach ${origin}: ${err.message}`);
     }
@@ -66522,21 +66645,6 @@ function createCloudRoutes(options2) {
     return res;
   };
   const artifactEntry = (key2) => readConfig(configFile).config.artifacts[key2] ?? {};
-  const referencedBoards = (ref, visibility) => {
-    const boards = {
-      unpublished: [],
-      private: [],
-      published: []
-    };
-    for (const slug of new Set(options2.references?.(ref) ?? [])) {
-      const entry = artifactEntry(`artboard/${slug}`);
-      const state2 = publishState(entry);
-      if (!state2.published) boards.unpublished.push(slug);
-      else if (visibility === "public" && (entry.cloud?.visibility ?? state2.visibility) === "private")
-        boards.private.push(slug);
-    }
-    return boards;
-  };
   const publications = /* @__PURE__ */ new Map();
   const changedDuringPublish = /* @__PURE__ */ new Set();
   const snapshot2 = (key2) => ({
@@ -66629,7 +66737,7 @@ function createCloudRoutes(options2) {
     const content = {
       title: inspected.title,
       payload: inspected.payload,
-      files: hashed.map(({ path: path44, hash: hash2 }) => ({ path: path44, hash: hash2 }))
+      files: hashed.map(({ path: path45, hash: hash2 }) => ({ path: path45, hash: hash2 }))
     };
     const fingerprint = sha(
       JSON.stringify({
@@ -66840,6 +66948,102 @@ function createCloudRoutes(options2) {
       return { kind: "failed", message: err.message };
     }
   };
+  const cascadeStatus = async (key2) => {
+    const ref = artifactKeyOf(key2);
+    const inspected = ref && await options2.inspect(ref);
+    if (!ref || !inspected) return null;
+    const entry = artifactEntry(key2);
+    const published = !!entry.cloud?.publishedAt;
+    let blocked = null;
+    let fingerprint = null;
+    try {
+      const prepared = await prepare(ref);
+      if (prepared.ready) fingerprint = prepared.fingerprint;
+      else blocked = prepared.reasons.join("; ");
+    } catch (err) {
+      if (err instanceof SignedOut) throw err;
+      blocked = err.message.replace(/^cloud refused \(\d+\): /, "");
+    }
+    return {
+      title: inspected.title,
+      published,
+      withdrawn: !entry.cloud && entry.autoPublish === false,
+      stale: published && fingerprint !== null && fingerprint !== entry.cloud?.fingerprint,
+      visibility: published ? entry.cloud?.visibility ?? publishState(entry).visibility : null,
+      blocked
+    };
+  };
+  const cascadeOf = (ref, visibility) => buildCascade(`${ref.type}/${ref.id}`, visibility, {
+    referencesOf: (key2) => {
+      const each = artifactKeyOf(key2);
+      return each ? options2.references?.(each) ?? [] : [];
+    },
+    statusOf: cascadeStatus
+  });
+  const publishRefs = async (ref, refs3, makePublic, requested) => {
+    const rootKey = `${ref.type}/${ref.id}`;
+    const visibility = requested ?? publishState(artifactEntry(rootKey)).visibility;
+    const listed = await cascadeOf(ref, visibility);
+    const overrides = Object.fromEntries(
+      listed.map((item2) => [item2.artifact, false])
+    );
+    for (const key2 of [...refs3, ...makePublic]) overrides[key2] = true;
+    const items = resolveSelection(listed, overrides);
+    const known = new Map(items.map((item2) => [item2.artifact, item2]));
+    for (const key2 of [...refs3, ...makePublic]) {
+      const item2 = known.get(key2);
+      if (!item2?.selectable)
+        throw new CloudRefused(400, `${key2} is not a reference ${rootKey} can publish`);
+      if (makePublic.includes(key2) !== (item2.state === "private"))
+        throw new CloudRefused(
+          400,
+          item2.state === "private" ? `${key2} is private: list it in makePublic` : `${key2} is not private: list it in refs`
+        );
+    }
+    const results = [];
+    let stopped = false;
+    for (const item2 of items.filter((each) => each.checked)) {
+      const action = item2.state === "private" ? "make-public" : item2.state === "stale" ? "update" : "publish";
+      if (stopped) {
+        results.push({ artifact: item2.artifact, action, status: "not_attempted" });
+        continue;
+      }
+      const target = artifactKeyOf(item2.artifact);
+      try {
+        await serialized(item2.artifact, async () => {
+          if (action === "make-public") {
+            await setVisibility(target, "public");
+            if (!item2.changed) return;
+          }
+          const result = await publish(target, action === "publish" ? visibility : void 0, {
+            skipUnchanged: true
+          });
+          if (result.status !== 200)
+            throw new CloudRefused(
+              409,
+              (result.body.reasons ?? []).join("; ") || "not ready to publish"
+            );
+          updateArtifactConfig(configFile, item2.artifact, { autoPublish: null });
+        });
+        results.push({ artifact: item2.artifact, action, status: "published" });
+      } catch (err) {
+        if (err instanceof SignedOut) throw err;
+        const httpStatus = err instanceof CloudRefused ? err.status : void 0;
+        results.push({
+          artifact: item2.artifact,
+          action,
+          status: httpStatus !== void 0 && httpStatus < 500 ? "failed" : "unknown",
+          error: {
+            error: err.message.replace(/^cloud refused \(\d+\): /, ""),
+            ...err instanceof CloudRefused ? err.details : {},
+            ...httpStatus === void 0 ? {} : { httpStatus }
+          }
+        });
+        stopped = true;
+      }
+    }
+    return { status: stopped ? "partial" : "published", results };
+  };
   const route = async (req, res, match) => {
     const [, action, first, second2] = match;
     const method = req.method ?? "GET";
@@ -66877,9 +67081,7 @@ function createCloudRoutes(options2) {
     if (action === "artifacts" && method === "GET" && !first) {
       const query2 = new URL(req.url ?? "/", "http://localhost").searchParams;
       query2.delete("key");
-      const listed = await (await expectOk(
-        await cloudFetch("GET", `/api/artifacts${query2.size ? `?${query2}` : ""}`)
-      )).json();
+      const listed = await (await expectOk(await cloudFetch("GET", `/api/artifacts${query2.size ? `?${query2}` : ""}`))).json();
       adoptCloudVisibility(listed.artifacts);
       sendJson(res, 200, listed);
       return;
@@ -66901,12 +67103,27 @@ function createCloudRoutes(options2) {
         if (published.status === 200) updateArtifactConfig(configFile, key2, { autoPublish: null });
         return published;
       });
-      const visibility = result.body.visibility;
-      sendJson(
-        res,
-        result.status,
-        result.status === 200 && ref.type === "document" ? { ...result.body, boards: referencedBoards(ref, visibility) } : result.body
-      );
+      sendJson(res, result.status, result.body);
+      return;
+    }
+    if (action === "refs" && ref && method === "GET") {
+      const requested = new URL(req.url ?? "/", "http://hub").searchParams.get("visibility");
+      if (requested !== null && !isVisibility(requested))
+        throw new CloudRefused(400, 'visibility must be "public" or "private"');
+      const visibility = requested ?? publishState(artifactEntry(`${ref.type}/${ref.id}`)).visibility;
+      sendJson(res, 200, { visibility, items: await cascadeOf(ref, visibility) });
+      return;
+    }
+    if (action === "publish-refs" && ref && method === "POST") {
+      const body = await readJsonBody(req);
+      if (body?.visibility !== void 0 && !isVisibility(body.visibility))
+        throw new CloudRefused(400, 'visibility must be "public" or "private"');
+      const list2 = (value) => Array.isArray(value) && value.every((each) => typeof each === "string") ? value : null;
+      const refs3 = list2(body?.refs ?? []);
+      const makePublic = list2(body?.makePublic ?? []);
+      if (!refs3 || !makePublic)
+        throw new CloudRefused(400, "refs and makePublic must be lists of <type>/<id>");
+      sendJson(res, 200, await publishRefs(ref, refs3, makePublic, body?.visibility));
       return;
     }
     if (action === "sync" && ref && method === "GET") {
@@ -67040,6 +67257,17 @@ function createCloudRoutes(options2) {
       }
       return snapshot2(key2);
     },
+    async cascade(key2, visibility) {
+      const ref = artifactKeyOf(key2);
+      if (!ref) throw new CloudRefused(404, "artifact not found");
+      const shown = visibility ?? publishState(artifactEntry(key2)).visibility;
+      return { visibility: shown, items: await cascadeOf(ref, shown) };
+    },
+    publishRefsNow(key2, refs3, makePublic, visibility) {
+      const ref = artifactKeyOf(key2);
+      if (!ref) throw new CloudRefused(404, "artifact not found");
+      return publishRefs(ref, refs3, makePublic, visibility);
+    },
     autoPublishEnabled: () => autoPublishState().enabled,
     token: () => readCredentials(credentialsFile2, origin)?.token ?? null,
     async handle(req, res, match) {
@@ -67063,7 +67291,7 @@ function createCloudRoutes(options2) {
 
 // src/server/comment-names.ts
 var import_node_child_process2 = require("node:child_process");
-var import_node_fs22 = __toESM(require("node:fs"), 1);
+var import_node_fs23 = __toESM(require("node:fs"), 1);
 
 // src/server/agent.ts
 var NAMES = {
@@ -67156,7 +67384,7 @@ function commentNames({ agentFile, projectDir, cloud }) {
     agent: () => {
       try {
         return detectAgent(
-          JSON.parse(import_node_fs22.default.readFileSync(agentFile, "utf8"))
+          JSON.parse(import_node_fs23.default.readFileSync(agentFile, "utf8"))
         );
       } catch {
         return void 0;
@@ -67236,28 +67464,28 @@ function createDirectRelay(options2) {
 }
 
 // src/server/document.ts
-var import_node_fs24 = __toESM(require("node:fs"), 1);
-var import_node_path20 = __toESM(require("node:path"), 1);
+var import_node_fs25 = __toESM(require("node:fs"), 1);
+var import_node_path21 = __toESM(require("node:path"), 1);
 
 // src/server/html.ts
-var import_node_fs23 = __toESM(require("node:fs"), 1);
-var import_node_path19 = __toESM(require("node:path"), 1);
+var import_node_fs24 = __toESM(require("node:fs"), 1);
+var import_node_path20 = __toESM(require("node:path"), 1);
 var TITLE = /<title[^>]*>([\s\S]*?)<\/title>/i;
 function latestMtime(dir) {
   let latest2 = 0;
   let entries2;
   try {
-    entries2 = import_node_fs23.default.readdirSync(dir, { withFileTypes: true });
+    entries2 = import_node_fs24.default.readdirSync(dir, { withFileTypes: true });
   } catch {
     return latest2;
   }
   for (const entry of entries2) {
     if (entry.name.startsWith(".")) continue;
-    const full = import_node_path19.default.join(dir, entry.name);
+    const full = import_node_path20.default.join(dir, entry.name);
     try {
       latest2 = Math.max(
         latest2,
-        entry.isDirectory() ? latestMtime(full) : import_node_fs23.default.statSync(full).mtimeMs
+        entry.isDirectory() ? latestMtime(full) : import_node_fs24.default.statSync(full).mtimeMs
       );
     } catch {
       continue;
@@ -67268,7 +67496,7 @@ function latestMtime(dir) {
 function readHtml(dir, id3) {
   let source;
   try {
-    source = import_node_fs23.default.readFileSync(import_node_path19.default.join(dir, ENTRY_FILE.html), "utf8");
+    source = import_node_fs24.default.readFileSync(import_node_path20.default.join(dir, ENTRY_FILE.html), "utf8");
   } catch {
     return { title: id3, warnings: ["index.html not found"], version: latestMtime(dir) };
   }
@@ -67281,7 +67509,7 @@ var FIRST_HEADING = /<h[1-6]\b[^>]*>([\s\S]*?)<\/h[1-6]>/i;
 function readDocument(dir, id3) {
   let source;
   try {
-    source = import_node_fs24.default.readFileSync(import_node_path20.default.join(dir, ENTRY_FILE.document), "utf8");
+    source = import_node_fs25.default.readFileSync(import_node_path21.default.join(dir, ENTRY_FILE.document), "utf8");
   } catch {
     return { title: id3, warnings: ["doc.xml not found"], version: latestMtime(dir) };
   }
@@ -67290,17 +67518,17 @@ function readDocument(dir, id3) {
 }
 
 // src/server/documents.ts
-var import_node_fs27 = __toESM(require("node:fs"), 1);
-var import_node_path24 = __toESM(require("node:path"), 1);
+var import_node_fs28 = __toESM(require("node:fs"), 1);
+var import_node_path25 = __toESM(require("node:path"), 1);
 
 // src/server/change-cursors.ts
-var import_node_fs25 = __toESM(require("node:fs"), 1);
-var import_node_path21 = __toESM(require("node:path"), 1);
-var cursorsFile2 = (stateDir, id3) => import_node_path21.default.join(stateDir, "document", id3, "change-cursors.json");
+var import_node_fs26 = __toESM(require("node:fs"), 1);
+var import_node_path22 = __toESM(require("node:path"), 1);
+var cursorsFile2 = (stateDir, id3) => import_node_path22.default.join(stateDir, "document", id3, "change-cursors.json");
 var isOpId = (value) => typeof value === "object" && value !== null && typeof value.peer === "string" && Number.isInteger(value.counter);
 function read2(file) {
   try {
-    const value = JSON.parse(import_node_fs25.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs26.default.readFileSync(file, "utf8"));
     if (typeof value !== "object" || value === null || Array.isArray(value)) return {};
     return Object.fromEntries(
       Object.entries(value).filter(
@@ -67322,8 +67550,8 @@ function createChangeCursors(stateDir) {
 }
 
 // src/server/document-asks.ts
-var import_node_fs26 = __toESM(require("node:fs"), 1);
-var import_node_path22 = __toESM(require("node:path"), 1);
+var import_node_fs27 = __toESM(require("node:fs"), 1);
+var import_node_path23 = __toESM(require("node:path"), 1);
 var blockOf = (asks, ask) => asks.find((a5) => a5.id === ask)?.blockId ?? "*";
 function humanAskOp(asks, threads2, op3) {
   if (op3.op !== "create") {
@@ -67368,8 +67596,8 @@ function askListing(asks, threads2) {
   };
 }
 function writeAsksFile(stateDir, id3, asks, threads2) {
-  const file = import_node_path22.default.join(stateDir, "document", id3, "asks.json");
-  if (!asks.length && !import_node_fs26.default.existsSync(file)) return;
+  const file = import_node_path23.default.join(stateDir, "document", id3, "asks.json");
+  if (!asks.length && !import_node_fs27.default.existsSync(file)) return;
   const latest2 = latestSubmission(threads2);
   writeJsonAtomic(file, {
     latest: latest2 ? { id: latest2.id, at: latest2.at, withdrawn: latest2.withdrawn } : null
@@ -68730,19 +68958,19 @@ var ElementDOMSlot = class _ElementDOMSlot extends DOMSlot {
   }
 };
 function indexPath(root, child) {
-  const path44 = [];
+  const path45 = [];
   let node = child;
   for (; node !== root && node !== null; node = node.parentNode) {
     let i7 = 0;
     for (let sibling = node.previousSibling; sibling !== null; sibling = sibling.previousSibling) {
       i7++;
     }
-    path44.push(i7);
+    path45.push(i7);
   }
   if (!(node === root)) {
     formatDevErrorMessage(`indexPath: root is not a parent of child`);
   }
-  return path44.reverse();
+  return path45.reverse();
 }
 var TEXT_MUTATION_VARIANCE = 100;
 var isProcessingMutations = false;
@@ -78102,9 +78330,9 @@ function getActiveElementDeep(root) {
 function getComposedEventTarget(event) {
   const target = event.target;
   if (target !== null && isHTMLElement(target) && target.shadowRoot !== null && typeof event.composedPath === "function") {
-    const path44 = event.composedPath();
-    if (path44.length > 0) {
-      return path44[0];
+    const path45 = event.composedPath();
+    if (path45.length > 0) {
+      return path45[0];
     }
   }
   return target;
@@ -90398,7 +90626,7 @@ var as = null;
 function us(t7) {
   as = t7;
 }
-var fs27 = /* @__PURE__ */ Symbol("INTERNAL_SKIP_AFTER_CLONE_FROM");
+var fs28 = /* @__PURE__ */ Symbol("INTERNAL_SKIP_AFTER_CLONE_FROM");
 var ds = 1;
 function hs() {
   ds = 1;
@@ -90870,7 +91098,7 @@ function Il(t7) {
   return ci(t7) || Fl(t7);
 }
 function Ll(t7, e5 = false) {
-  const n8 = t7.constructor.clone(t7, fs27);
+  const n8 = t7.constructor.clone(t7, fs28);
   return Ds(n8, null), n8.afterCloneFrom(t7), e5 || n8.resetOnCopyNodeFrom(t7), n8;
 }
 function Kl(t7) {
@@ -91115,7 +91343,7 @@ function wc(t7) {
   })(t7), Tc.set(t7, n8)), n8;
 }
 function Ec(t7) {
-  const e5 = t7.constructor.clone(t7, fs27);
+  const e5 = t7.constructor.clone(t7, fs28);
   return e5.afterCloneFrom(t7), e5;
 }
 function Ac(t7) {
@@ -91262,7 +91490,7 @@ function Bc(t7) {
           if (Kc(t9, "clone") || (t9.clone = (e7, n12) => {
             us(e7);
             const o10 = new t9();
-            return n12 !== fs27 && o10.afterCloneFrom(e7), o10;
+            return n12 !== fs28 && o10.afterCloneFrom(e7), o10;
           }), Kc(t9, "importJSON") || (t9.importJSON = o9 && o9.$importJSON || /* @__PURE__ */ (function(t10) {
             return (e7) => {
               const n12 = ga(t10);
@@ -120238,10 +120466,10 @@ function $placeBlocks(runtime, $isTarget) {
   }
   const documentKey = $documentKey();
   for (const [key2, frame] of targets) {
-    const path44 = placeOf(frame);
-    let id3 = derivePositionalId(documentKey, path44);
+    const path45 = placeOf(frame);
+    let id3 = derivePositionalId(documentKey, path45);
     for (let attempt = 1; taken.has(id3); attempt++) {
-      id3 = derivePositionalId(documentKey, `${path44}#${attempt}`);
+      id3 = derivePositionalId(documentKey, `${path45}#${attempt}`);
     }
     taken.add(id3);
     placed.set(key2, id3);
@@ -132457,7 +132685,7 @@ function Vx(e5) {
   }
   return t7;
 }
-function fs28(e5, t7, n8) {
+function fs29(e5, t7, n8) {
   for (; t7 < e5.length; ) {
     let r8 = e5[t7];
     if (r8 === " " || r8 === `
@@ -132476,20 +132704,20 @@ function Rp(e5, t7) {
 }
 function Xs2(e5, t7, n8, r8 = 0) {
   if (r8 > Tp) throw new Error("YAML: nesting is too deep");
-  t7 = fs28(e5, t7, false);
+  t7 = fs29(e5, t7, false);
   let o8 = e5[t7];
   if (o8 === "{") {
     let a5 = {};
     t7++;
     let i7 = true;
     for (; ; ) {
-      if (t7 = fs28(e5, t7, false), t7 >= e5.length) throw new Or2("YAML: unexpected end of the stream within a flow collection");
+      if (t7 = fs29(e5, t7, false), t7 >= e5.length) throw new Or2("YAML: unexpected end of the stream within a flow collection");
       if (e5[t7] === "}") return [a5, t7 + 1];
       Rp(e5[t7], i7);
       let c10;
-      [c10, t7] = Xs2(e5, t7, ":,}", r8 + 1), t7 = fs28(e5, t7, false);
+      [c10, t7] = Xs2(e5, t7, ":,}", r8 + 1), t7 = fs29(e5, t7, false);
       let l8 = null;
-      e5[t7] === ":" && ([l8, t7] = Xs2(e5, t7 + 1, ",}", r8 + 1)), Vo3(a5, String(c10), l8), t7 = fs28(e5, t7, false), i7 = e5[t7] === ",", i7 && t7++;
+      e5[t7] === ":" && ([l8, t7] = Xs2(e5, t7 + 1, ",}", r8 + 1)), Vo3(a5, String(c10), l8), t7 = fs29(e5, t7, false), i7 = e5[t7] === ",", i7 && t7++;
     }
   }
   if (o8 === "[") {
@@ -132497,11 +132725,11 @@ function Xs2(e5, t7, n8, r8 = 0) {
     t7++;
     let i7 = true;
     for (; ; ) {
-      if (t7 = fs28(e5, t7, false), t7 >= e5.length) throw new Or2("YAML: unexpected end of the stream within a flow collection");
+      if (t7 = fs29(e5, t7, false), t7 >= e5.length) throw new Or2("YAML: unexpected end of the stream within a flow collection");
       if (e5[t7] === "]") return [a5, t7 + 1];
       Rp(e5[t7], i7);
       let c10;
-      [c10, t7] = Xs2(e5, t7, ",]", r8 + 1), a5.push(c10), t7 = fs28(e5, t7, false), i7 = e5[t7] === ",", i7 && t7++;
+      [c10, t7] = Xs2(e5, t7, ",]", r8 + 1), a5.push(c10), t7 = fs29(e5, t7, false), i7 = e5[t7] === ",", i7 && t7++;
     }
   }
   if (o8 === '"') {
@@ -132661,7 +132889,7 @@ function Hn3(e5) {
   let t7 = e5.trim();
   if (t7[0] === "{" || t7[0] === "[") try {
     let [o8, s7] = Xs2(t7, 0, "");
-    if (fs28(t7, s7, false) === t7.length) return o8;
+    if (fs29(t7, s7, false) === t7.length) return o8;
   } catch (o8) {
     throw o8 instanceof Or2 ? new Error(o8.message) : o8;
   }
@@ -152995,27 +153223,27 @@ var sqrtTall = function sqrtTall2(extraVinculum, hLinePad2, viewBoxHeight) {
 };
 var sqrtPath = function sqrtPath2(size, extraVinculum, viewBoxHeight) {
   extraVinculum = 1e3 * extraVinculum;
-  var path44 = "";
+  var path45 = "";
   switch (size) {
     case "sqrtMain":
-      path44 = sqrtMain(extraVinculum, hLinePad);
+      path45 = sqrtMain(extraVinculum, hLinePad);
       break;
     case "sqrtSize1":
-      path44 = sqrtSize1(extraVinculum, hLinePad);
+      path45 = sqrtSize1(extraVinculum, hLinePad);
       break;
     case "sqrtSize2":
-      path44 = sqrtSize2(extraVinculum, hLinePad);
+      path45 = sqrtSize2(extraVinculum, hLinePad);
       break;
     case "sqrtSize3":
-      path44 = sqrtSize3(extraVinculum, hLinePad);
+      path45 = sqrtSize3(extraVinculum, hLinePad);
       break;
     case "sqrtSize4":
-      path44 = sqrtSize4(extraVinculum, hLinePad);
+      path45 = sqrtSize4(extraVinculum, hLinePad);
       break;
     case "sqrtTall":
-      path44 = sqrtTall(extraVinculum, hLinePad, viewBoxHeight);
+      path45 = sqrtTall(extraVinculum, hLinePad, viewBoxHeight);
   }
-  return path44;
+  return path45;
 };
 var innerPath = function innerPath2(name, height) {
   switch (name) {
@@ -153041,7 +153269,7 @@ var innerPath = function innerPath2(name, height) {
       return "";
   }
 };
-var path24 = {
+var path25 = {
   // The doubleleftarrow geometry is from glyph U+21D0 in the font KaTeX Main
   doubleleftarrow: "M262 157\nl10-10c34-36 62.7-77 86-123 3.3-8 5-13.3 5-16 0-5.3-6.7-8-20-8-7.3\n 0-12.2.5-14.5 1.5-2.3 1-4.8 4.5-7.5 10.5-49.3 97.3-121.7 169.3-217 216-28\n 14-57.3 25-88 33-6.7 2-11 3.8-13 5.5-2 1.7-3 4.2-3 7.5s1 5.8 3 7.5\nc2 1.7 6.3 3.5 13 5.5 68 17.3 128.2 47.8 180.5 91.5 52.3 43.7 93.8 96.2 124.5\n 157.5 9.3 8 15.3 12.3 18 13h6c12-.7 18-4 18-10 0-2-1.7-7-5-15-23.3-46-52-87\n-86-123l-10-10h399738v-40H218c328 0 0 0 0 0l-10-8c-26.7-20-65.7-43-117-69 2.7\n-2 6-3.7 10-5 36.7-16 72.3-37.3 107-64l10-8h399782v-40z\nm8 0v40h399730v-40zm0 194v40h399730v-40z",
   // doublerightarrow is from glyph U+21D2 in font KaTeX Main
@@ -153570,7 +153798,7 @@ var PathNode = class {
     if (this.alternate) {
       node.setAttribute("d", this.alternate);
     } else {
-      node.setAttribute("d", path24[this.pathName]);
+      node.setAttribute("d", path25[this.pathName]);
     }
     return node;
   }
@@ -153578,7 +153806,7 @@ var PathNode = class {
     if (this.alternate) {
       return '<path d="' + escape4(this.alternate) + '"/>';
     } else {
-      return '<path d="' + escape4(path24[this.pathName]) + '"/>';
+      return '<path d="' + escape4(path25[this.pathName]) + '"/>';
     }
   }
 };
@@ -157229,8 +157457,8 @@ var svgData = {
 };
 var staticSvg = function staticSvg2(value, options2) {
   var _svgData$value = svgData[value], pathName = _svgData$value[0], width = _svgData$value[1], height = _svgData$value[2];
-  var path44 = new PathNode(pathName);
-  var svgNode = new SvgNode([path44], {
+  var path45 = new PathNode(pathName);
+  var svgNode = new SvgNode([path45], {
     "width": makeEm(width),
     "height": makeEm(height),
     // Override CSS rule `.katex svg { width: 100% }`
@@ -158373,8 +158601,8 @@ var stretchySvg = function stretchySvg2(group, options2) {
           pathName = "tilde" + imgIndex;
         }
       }
-      var path44 = new PathNode(pathName);
-      var svgNode = new SvgNode([path44], {
+      var path45 = new PathNode(pathName);
+      var svgNode = new SvgNode([path45], {
         "width": "100%",
         "height": makeEm(_height),
         "viewBox": "0 0 " + viewBoxWidth + " " + viewBoxHeight,
@@ -159588,8 +159816,8 @@ var makeGlyphSpan = function makeGlyphSpan2(symbol, font, mode, options2) {
 };
 var makeInner = function makeInner2(ch4, height, options2) {
   var width = fontMetricsData["Size4-Regular"][ch4.charCodeAt(0)] ? fontMetricsData["Size4-Regular"][ch4.charCodeAt(0)][4] : fontMetricsData["Size1-Regular"][ch4.charCodeAt(0)][4];
-  var path44 = new PathNode("inner", innerPath(ch4, Math.round(1e3 * height)));
-  var svgNode = new SvgNode([path44], {
+  var path45 = new PathNode("inner", innerPath(ch4, Math.round(1e3 * height)));
+  var svgNode = new SvgNode([path45], {
     "width": makeEm(width),
     "height": makeEm(height),
     // Override CSS rule `.katex svg { width: 100% }`
@@ -159758,10 +159986,10 @@ var makeStackedDelim = function makeStackedDelim2(delim, heightTotal, center, op
     var midHeight = realHeightTotal - topHeightTotal - bottomHeightTotal;
     var viewBoxHeight = Math.round(realHeightTotal * 1e3);
     var pathStr = tallDelim(svgLabel, Math.round(midHeight * 1e3));
-    var path44 = new PathNode(svgLabel, pathStr);
+    var path45 = new PathNode(svgLabel, pathStr);
     var width = makeEm(viewBoxWidth / 1e3);
     var height = makeEm(viewBoxHeight / 1e3);
-    var svg = new SvgNode([path44], {
+    var svg = new SvgNode([path45], {
       "width": width,
       "height": height,
       "viewBox": "0 0 " + viewBoxWidth + " " + viewBoxHeight
@@ -159802,8 +160030,8 @@ var makeStackedDelim = function makeStackedDelim2(delim, heightTotal, center, op
 var vbPad = 80;
 var emPad = 0.08;
 var sqrtSvg = function sqrtSvg2(sqrtName, height, viewBoxHeight, extraVinculum, options2) {
-  var path44 = sqrtPath(sqrtName, extraVinculum, viewBoxHeight);
-  var pathNode = new PathNode(sqrtName, path44);
+  var path45 = sqrtPath(sqrtName, extraVinculum, viewBoxHeight);
+  var pathNode = new PathNode(sqrtName, path45);
   var svg = new SvgNode([pathNode], {
     // Note: 1000:1 ratio of viewBox to document em width.
     "width": "400em",
@@ -160302,8 +160530,8 @@ var htmlBuilder$7 = (group, options2) => {
     var angleHeight = inner2.height + inner2.depth + lineWeight + clearance;
     inner2.style.paddingLeft = makeEm(angleHeight / 2 + lineWeight);
     var viewBoxHeight = Math.floor(1e3 * angleHeight * scale);
-    var path44 = phasePath(viewBoxHeight);
-    var svgNode = new SvgNode([new PathNode("phase", path44)], {
+    var path45 = phasePath(viewBoxHeight);
+    var svgNode = new SvgNode([new PathNode("phase", path45)], {
       "width": "400em",
       "height": makeEm(viewBoxHeight / 1e3),
       "viewBox": "0 0 400000 " + viewBoxHeight,
@@ -166827,7 +167055,7 @@ function renderProblems(state2) {
 
 // src/server/document-session.ts
 var import_promises = __toESM(require("node:fs/promises"), 1);
-var import_node_path23 = __toESM(require("node:path"), 1);
+var import_node_path24 = __toESM(require("node:path"), 1);
 
 // ../../node_modules/.pnpm/loro-crdt@1.16.4/node_modules/loro-crdt/base64/index.js
 function _loadWasmModule(sync, filepath, src, imports2) {
@@ -166843,10 +167071,10 @@ function _loadWasmModule(sync, filepath, src, imports2) {
   var buf = null;
   var isNode2 = typeof process !== "undefined" && process.versions != null && process.versions.node != null;
   if (filepath && isNode2) {
-    var fs49 = null;
-    var path44 = null;
+    var fs50 = null;
+    var path45 = null;
     return new Promise((resolve, reject) => {
-      fs49.readFile(path44.resolve(__dirname, filepath), (error, buffer) => {
+      fs50.readFile(path45.resolve(__dirname, filepath), (error, buffer) => {
         if (error != null) {
           reject(error);
         } else {
@@ -168149,10 +168377,10 @@ var LoroDoc = class _LoroDoc {
    * @param {string} path
    * @returns {Value | Container | undefined}
    */
-  getByPath(path44) {
+  getByPath(path45) {
     try {
       const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-      const ptr0 = passStringToWasm0(path44, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+      const ptr0 = passStringToWasm0(path45, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
       const len0 = WASM_VECTOR_LEN;
       wasm.lorodoc_getByPath(retptr, this.__wbg_ptr, ptr0, len0);
       var r02 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
@@ -175773,16 +176001,16 @@ var Diff = class {
       }
     }
   }
-  addToPath(path44, added, removed, oldPosInc, options2) {
-    const last = path44.lastComponent;
+  addToPath(path45, added, removed, oldPosInc, options2) {
+    const last = path45.lastComponent;
     if (last && !options2.oneChangePerToken && last.added === added && last.removed === removed) {
       return {
-        oldPos: path44.oldPos + oldPosInc,
+        oldPos: path45.oldPos + oldPosInc,
         lastComponent: { count: last.count + 1, added, removed, previousComponent: last.previousComponent }
       };
     } else {
       return {
-        oldPos: path44.oldPos + oldPosInc,
+        oldPos: path45.oldPos + oldPosInc,
         lastComponent: { count: 1, added, removed, previousComponent: last }
       };
     }
@@ -180666,7 +180894,7 @@ async function readText2(file) {
   }
 }
 async function writeAtomic(file, data) {
-  await import_promises.default.mkdir(import_node_path23.default.dirname(file), { recursive: true });
+  await import_promises.default.mkdir(import_node_path24.default.dirname(file), { recursive: true });
   const tmp = `${file}.${process.pid}.tmp`;
   await import_promises.default.writeFile(tmp, data);
   await import_promises.default.rename(tmp, file);
@@ -180700,7 +180928,7 @@ async function createDocumentSession(options2) {
   let lastGoodText = null;
   let lastAgentText = null;
   let lastFileText = await readText2(file) ?? "";
-  const activityFile = import_node_path23.default.join(import_node_path23.default.dirname(snapshotFile), "agent-active");
+  const activityFile = import_node_path24.default.join(import_node_path24.default.dirname(snapshotFile), "agent-active");
   let agentActiveAt = await lastAgentWrite(activityFile, file);
   let activitySaved = Promise.resolve();
   const emitStatus = () => emit({ type: "status", outcome, streaming: streaming > 0, agentActiveAt });
@@ -180925,39 +181153,45 @@ function fillRefIds(state2, lookup2) {
   const children2 = state2.root.children.map(fill);
   return { ...state2, root: { ...state2.root, children: children2 } };
 }
+var NOUN2 = {
+  document: "a document",
+  artboard: "an artboard",
+  whiteboard: "a whiteboard",
+  html: "an html page"
+};
 function refWarnings(refs3, lookup2) {
   return refs3.flatMap((ref) => {
     const at7 = `block ${ref.blockId}: `;
-    if (refKind(ref) === "whiteboard") return whiteboardWarnings(ref, at7, lookup2);
-    const slug = ref.artboard ?? "";
-    const id3 = lookup2.idOf(slug);
-    if (!id3) return [`${at7}<ref artboard="${slug}"> names an artboard that is not in this project`];
+    const kind = refKind(ref);
+    const slug = refSlug(ref);
+    const id3 = lookup2.idOf(slug, kind);
+    if (!id3)
+      return [`${at7}<ref ${kind}="${slug}"> names ${NOUN2[kind]} that is not in this project`];
     if (ref.to && ref.to !== id3)
       return [
-        `${at7}<ref artboard="${slug}"> points at ${ref.to}, but ${slug} is now ${id3}; delete to= to point the reference at it`
-      ];
-    const canvas = lookup2.canvasOf(slug);
-    if (!canvas) return [];
-    if (ref.group && !canvas.groups.includes(ref.group))
-      return [
-        `${at7}<ref artboard="${slug}" group="${ref.group}">: the artboard has no group ${ref.group}`
-      ];
-    if (ref.board && !canvas.boards.includes(ref.board))
-      return [
-        `${at7}<ref artboard="${slug}" board="${ref.board}">: the artboard has no board ${ref.board}`
+        `${at7}<ref ${kind}="${slug}"> points at ${ref.to}, but ${slug} is now ${id3}; delete to= to point the reference at it`
       ];
+    if (kind === "whiteboard") return whiteboardWarnings(ref, at7, lookup2);
+    if (kind === "artboard") return artboardWarnings(ref, at7, lookup2);
     return [];
   });
 }
-function whiteboardWarnings(ref, at7, lookup2) {
-  const slug = ref.whiteboard;
-  const id3 = lookup2.idOf(slug, "whiteboard");
-  if (!id3)
-    return [`${at7}<ref whiteboard="${slug}"> names a whiteboard that is not in this project`];
-  if (ref.to && ref.to !== id3)
+function artboardWarnings(ref, at7, lookup2) {
+  const slug = ref.artboard;
+  const canvas = lookup2.canvasOf(slug);
+  if (!canvas) return [];
+  if (ref.group && !canvas.groups.includes(ref.group))
+    return [
+      `${at7}<ref artboard="${slug}" group="${ref.group}">: the artboard has no group ${ref.group}`
+    ];
+  if (ref.board && !canvas.boards.includes(ref.board))
     return [
-      `${at7}<ref whiteboard="${slug}"> points at ${ref.to}, but ${slug} is now ${id3}; delete to= to point the reference at it`
+      `${at7}<ref artboard="${slug}" board="${ref.board}">: the artboard has no board ${ref.board}`
     ];
+  return [];
+}
+function whiteboardWarnings(ref, at7, lookup2) {
+  const slug = ref.whiteboard;
   const index = lookup2.framesOf(slug);
   if (!index) return [];
   if (ref.page) {
@@ -181011,10 +181245,14 @@ function createDocumentRegistry(options2) {
     const before2 = JSON.parse(lastArtboards.get(id3) ?? "[]");
     lastArtboards.set(id3, key2);
     const all = [...before2, ...refs3];
-    const slugs = (kind) => [
-      ...new Set(all.filter((ref) => refKind(ref) === kind).map(refSlug))
-    ];
-    options2.onRefsChange?.(id3, slugs("artboard"), slugs("whiteboard"));
+    const keys2 = [...new Set(all.map((ref) => `${refKind(ref)}/${refSlug(ref)}`))];
+    options2.onRefsChange?.(
+      id3,
+      keys2.map((key3) => {
+        const [type, slug] = key3.split("/");
+        return { type, id: slug };
+      })
+    );
   };
   const liveRefWarnings = (id3) => {
     const session = ready.get(id3);
@@ -181022,7 +181260,7 @@ function createDocumentRegistry(options2) {
   };
   const warnings = /* @__PURE__ */ new Map();
   const rechecks = /* @__PURE__ */ new Map();
-  const docFile = (id3) => import_node_path24.default.join(options2.root, "document", id3, "doc.xml");
+  const docFile = (id3) => import_node_path25.default.join(options2.root, "document", id3, "doc.xml");
   const commentStores = /* @__PURE__ */ new Map();
   const cursors = createCommentCursors(options2.stateDir);
   const changeCursors = createChangeCursors(options2.stateDir);
@@ -181030,7 +181268,7 @@ function createDocumentRegistry(options2) {
     let store = commentStores.get(id3);
     if (!store) {
       store = createCommentStore(
-        import_node_path24.default.join(options2.root, "document", id3, "comments.json"),
+        import_node_path25.default.join(options2.root, "document", id3, "comments.json"),
         options2.names
       );
       commentStores.set(id3, store);
@@ -181063,10 +181301,10 @@ function createDocumentRegistry(options2) {
     if (JSON.stringify(store.warnings()) !== before2) options2.onWarningsChange(id3);
   };
   const create3 = async (id3) => {
-    if (!import_node_fs27.default.existsSync(docFile(id3))) return null;
+    if (!import_node_fs28.default.existsSync(docFile(id3))) return null;
     const session = await createDocumentSession({
       file: docFile(id3),
-      snapshotFile: import_node_path24.default.join(options2.stateDir, "document", id3, "doc.loro"),
+      snapshotFile: import_node_path25.default.join(options2.stateDir, "document", id3, "doc.loro"),
       fillRefs: (state2) => fillRefIds(state2, refLookup),
       ...options2.timing,
       log: options2.log
@@ -181144,7 +181382,7 @@ function createDocumentRegistry(options2) {
       const known = sessions.has(id3);
       void open2(id3).then((session) => {
         if (!session || !known) return;
-        import_node_fs27.default.readFile(docFile(id3), "utf8", (err, text5) => {
+        import_node_fs28.default.readFile(docFile(id3), "utf8", (err, text5) => {
           if (!err) session.onFileText(text5);
         });
       });
@@ -181225,8 +181463,8 @@ function createDocumentRegistry(options2) {
 }
 
 // src/server/dynamic-blocks.ts
-var import_node_fs28 = __toESM(require("node:fs"), 1);
-var import_node_path25 = __toESM(require("node:path"), 1);
+var import_node_fs29 = __toESM(require("node:fs"), 1);
+var import_node_path26 = __toESM(require("node:path"), 1);
 function dynamicUrls(xml) {
   const urls = /* @__PURE__ */ new Set();
   for (const match of stripOpaque(xml).matchAll(TAG)) {
@@ -181239,7 +181477,7 @@ function dynamicUrls(xml) {
 }
 var mtimeOf = (file) => {
   try {
-    return import_node_fs28.default.statSync(file).mtimeMs;
+    return import_node_fs29.default.statSync(file).mtimeMs;
   } catch {
     return -1;
   }
@@ -181256,7 +181494,7 @@ function createDynamicBlocks(limits) {
   };
   const entry = (id3, dir, file) => {
     const map = files(id3);
-    const mtime = mtimeOf(import_node_path25.default.join(dir, file));
+    const mtime = mtimeOf(import_node_path26.default.join(dir, file));
     let state2 = map.get(file);
     if (!state2 || state2.mtime !== mtime) {
       state2 = { mtime, errors: [], ran: false };
@@ -181281,19 +181519,19 @@ function createDynamicBlocks(limits) {
     state(id3, dir) {
       let xml;
       try {
-        xml = import_node_fs28.default.readFileSync(import_node_path25.default.join(dir, "doc.xml"), "utf8");
+        xml = import_node_fs29.default.readFileSync(import_node_path26.default.join(dir, "doc.xml"), "utf8");
       } catch {
         return { warnings: [], dynamic: {} };
       }
       const urls = dynamicUrls(xml);
       const map = files(id3);
       for (const [file, state2] of map) {
-        if (!urls.includes(file) || state2.mtime !== mtimeOf(import_node_path25.default.join(dir, file))) map.delete(file);
+        if (!urls.includes(file) || state2.mtime !== mtimeOf(import_node_path26.default.join(dir, file))) map.delete(file);
       }
       const warnings = [];
       const dynamic = {};
       for (const url of urls) {
-        if (!import_node_fs28.default.existsSync(import_node_path25.default.join(dir, url))) warnings.push(`${url} not found`);
+        if (!import_node_fs29.default.existsSync(import_node_path26.default.join(dir, url))) warnings.push(`${url} not found`);
         const state2 = map.get(url);
         for (const error of state2?.errors ?? []) warnings.push(`runtime: ${url}: ${error}`);
         dynamic[url] = { ran: state2?.ran ?? false };
@@ -181309,7 +181547,7 @@ var MAX_COMMENT_OP = 64 * 1024;
 var MAX_DOCUMENT_UPDATE = 8 * 1024 * 1024;
 
 // src/server/artifact-file.ts
-var import_node_fs29 = __toESM(require("node:fs"), 1);
+var import_node_fs30 = __toESM(require("node:fs"), 1);
 var RESOLVE = {
   artboard: resolveBoardFile,
   document: resolveDocumentAsset,
@@ -181323,8 +181561,8 @@ function readArtifactFile(dir, type, relative, uiRuntimeUrl, maxBytes = Infinity
   if (!target) return null;
   let data;
   try {
-    if (import_node_fs29.default.statSync(target).size > maxBytes) throw new RangeError("too large");
-    data = import_node_fs29.default.readFileSync(target);
+    if (import_node_fs30.default.statSync(target).size > maxBytes) throw new RangeError("too large");
+    data = import_node_fs30.default.readFileSync(target);
   } catch (err) {
     if (err instanceof RangeError) throw err;
     return null;
@@ -181460,6 +181698,20 @@ async function handleRelay(ctx, key2, body, conn, contentOrigin = "") {
   const request = typeof body === "object" && body !== null ? body : {};
   if (request.op === "publication" && ctx.cloud) return ctx.cloud.publication(key2);
   if (request.op === "publish" && ctx.cloud) return ctx.cloud.publishNow(key2);
+  if (request.op === "refs" && ctx.cloud)
+    return ctx.cloud.cascade(
+      key2,
+      request.visibility === "public" || request.visibility === "private" ? request.visibility : void 0
+    );
+  if (request.op === "publish-refs" && ctx.cloud) {
+    const list2 = (value) => Array.isArray(value) ? value.filter((each) => typeof each === "string") : [];
+    return ctx.cloud.publishRefsNow(
+      key2,
+      list2(request.refs),
+      list2(request.makePublic),
+      request.visibility === "public" || request.visibility === "private" ? request.visibility : void 0
+    );
+  }
   if (request.op === "meta") return ctx.artifactMeta(ref, dir, contentOrigin);
   if (request.op === "file") {
     const file = typeof request.path === "string" ? readArtifactFile(
@@ -181519,8 +181771,8 @@ async function handleRelay(ctx, key2, body, conn, contentOrigin = "") {
 }
 
 // src/server/selection.ts
-var import_node_fs30 = __toESM(require("node:fs"), 1);
-var import_node_path26 = __toESM(require("node:path"), 1);
+var import_node_fs31 = __toESM(require("node:fs"), 1);
+var import_node_path27 = __toESM(require("node:path"), 1);
 
 // src/shared/selection.ts
 var SELECTION_FULL_NODES = 20;
@@ -181665,7 +181917,7 @@ function readAnySelection(value) {
 function createSelectionStore(stateDir, exists) {
   const tabs = /* @__PURE__ */ new Map();
   let clock = 0;
-  const fileOf2 = (kind, id3) => import_node_path26.default.join(stateDir, kind, id3, "selection.json");
+  const fileOf2 = (kind, id3) => import_node_path27.default.join(stateDir, kind, id3, "selection.json");
   const write = (kind, id3) => {
     let winner;
     for (const tab of tabs.values()) {
@@ -181673,7 +181925,7 @@ function createSelectionStore(stateDir, exists) {
       if (!winner || tab.humanAt > winner.humanAt || tab.humanAt === winner.humanAt && tab.seenAt > winner.seenAt)
         winner = tab;
     }
-    if (!winner?.state) import_node_fs30.default.rmSync(fileOf2(kind, id3), { force: true });
+    if (!winner?.state) import_node_fs31.default.rmSync(fileOf2(kind, id3), { force: true });
     else
       writeJsonAtomic(fileOf2(kind, id3), {
         artifact: `${kind}/${id3}`,
@@ -181715,11 +181967,11 @@ function createSelectionStore(stateDir, exists) {
       for (const kind of ["artboard", "document", "whiteboard"]) {
         let ids;
         try {
-          ids = import_node_fs30.default.readdirSync(import_node_path26.default.join(stateDir, kind));
+          ids = import_node_fs31.default.readdirSync(import_node_path27.default.join(stateDir, kind));
         } catch {
           continue;
         }
-        for (const id3 of ids) import_node_fs30.default.rmSync(fileOf2(kind, id3), { force: true });
+        for (const id3 of ids) import_node_fs31.default.rmSync(fileOf2(kind, id3), { force: true });
       }
     }
   };
@@ -181727,13 +181979,13 @@ function createSelectionStore(stateDir, exists) {
 
 // src/server/verify-recordings.ts
 var import_node_crypto11 = __toESM(require("node:crypto"), 1);
-var import_node_fs32 = __toESM(require("node:fs"), 1);
-var import_node_path28 = __toESM(require("node:path"), 1);
+var import_node_fs33 = __toESM(require("node:fs"), 1);
+var import_node_path29 = __toESM(require("node:path"), 1);
 
 // src/server/recording-trim.ts
 var import_node_child_process3 = require("node:child_process");
-var import_node_fs31 = __toESM(require("node:fs"), 1);
-var import_node_path27 = __toESM(require("node:path"), 1);
+var import_node_fs32 = __toESM(require("node:fs"), 1);
+var import_node_path28 = __toESM(require("node:path"), 1);
 function run2(command, args, signal3) {
   return new Promise((resolve, reject) => {
     (0, import_node_child_process3.execFile)(
@@ -181753,7 +182005,7 @@ function run2(command, args, signal3) {
   });
 }
 async function trimRecording(input, output, signal3) {
-  if (input === output || import_node_fs31.default.existsSync(output))
+  if (input === output || import_node_fs32.default.existsSync(output))
     throw new Error("Choose a new output path; existing files are never overwritten.");
   const probe = JSON.parse(
     (await run2(
@@ -181825,9 +182077,9 @@ async function trimRecording(input, output, signal3) {
     if (start > 0 || end < duration) status = "trimmed";
   }
   if (status === "trimmed") {
-    const temporary = import_node_fs31.default.mkdtempSync(import_node_path27.default.join(import_node_path27.default.dirname(output), ".trim-"));
+    const temporary = import_node_fs32.default.mkdtempSync(import_node_path28.default.join(import_node_path28.default.dirname(output), ".trim-"));
     try {
-      const encoded = import_node_path27.default.join(temporary, "clip.mp4");
+      const encoded = import_node_path28.default.join(temporary, "clip.mp4");
       await run2(
         "ffmpeg",
         [
@@ -181863,9 +182115,9 @@ async function trimRecording(input, output, signal3) {
         ],
         signal3
       );
-      import_node_fs31.default.linkSync(encoded, output);
+      import_node_fs32.default.linkSync(encoded, output);
     } finally {
-      import_node_fs31.default.rmSync(temporary, { recursive: true, force: true });
+      import_node_fs32.default.rmSync(temporary, { recursive: true, force: true });
     }
   }
   return { duration, start, end, removed: duration - (end - start), status };
@@ -181876,7 +182128,7 @@ var POLICY = "idle-ends-v2";
 var STABLE_MS = 750;
 var digest2 = (data) => import_node_crypto11.default.createHash("sha256").update(data).digest("hex");
 var stamp2 = (file) => {
-  const stat = import_node_fs32.default.statSync(file);
+  const stat = import_node_fs33.default.statSync(file);
   return `${stat.dev}:${stat.ino}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
 };
 function createVerifyRecordings(options2) {
@@ -181890,7 +182142,7 @@ function createVerifyRecordings(options2) {
   const notify = (job) => {
     if (current(job)) options2.onChange(job.artifact);
   };
-  const cacheDir = import_node_path28.default.join(options2.stateDir, "recordings");
+  const cacheDir = import_node_path29.default.join(options2.stateDir, "recordings");
   async function process2(job) {
     let temporary;
     try {
@@ -181899,7 +182151,7 @@ function createVerifyRecordings(options2) {
         options2.onChange(job.artifact);
         return;
       }
-      const bytes = await import_node_fs32.default.promises.readFile(job.file);
+      const bytes = await import_node_fs33.default.promises.readFile(job.file);
       if (!current(job)) return;
       if (stamp2(job.file) !== job.stamp) {
         jobs.delete(job.key);
@@ -181907,22 +182159,22 @@ function createVerifyRecordings(options2) {
         return;
       }
       const key2 = digest2(`${POLICY}:${digest2(bytes)}`);
-      const dir = import_node_path28.default.join(cacheDir, key2);
-      const output = import_node_path28.default.join(dir, "clip.mp4");
-      const metadata = import_node_path28.default.join(dir, "result.json");
+      const dir = import_node_path29.default.join(cacheDir, key2);
+      const output = import_node_path29.default.join(dir, "clip.mp4");
+      const metadata = import_node_path29.default.join(dir, "result.json");
       let cached;
       try {
-        const saved = JSON.parse(import_node_fs32.default.readFileSync(metadata, "utf8"));
-        if (saved.result.status !== "trimmed" || import_node_fs32.default.existsSync(output) && saved.hash === digest2(import_node_fs32.default.readFileSync(output)))
+        const saved = JSON.parse(import_node_fs33.default.readFileSync(metadata, "utf8"));
+        if (saved.result.status !== "trimmed" || import_node_fs33.default.existsSync(output) && saved.hash === digest2(import_node_fs33.default.readFileSync(output)))
           cached = saved;
       } catch {
       }
       if (!cached) {
-        import_node_fs32.default.mkdirSync(cacheDir, { recursive: true });
-        temporary = import_node_fs32.default.mkdtempSync(import_node_path28.default.join(cacheDir, ".prepare-"));
-        const input = import_node_path28.default.join(temporary, "capture");
-        const prepared = import_node_path28.default.join(temporary, "clip.mp4");
-        import_node_fs32.default.writeFileSync(input, bytes);
+        import_node_fs33.default.mkdirSync(cacheDir, { recursive: true });
+        temporary = import_node_fs33.default.mkdtempSync(import_node_path29.default.join(cacheDir, ".prepare-"));
+        const input = import_node_path29.default.join(temporary, "capture");
+        const prepared = import_node_path29.default.join(temporary, "clip.mp4");
+        import_node_fs33.default.writeFileSync(input, bytes);
         const result = await (options2.prepare ?? trimRecording)(
           input,
           prepared,
@@ -181934,9 +182186,9 @@ function createVerifyRecordings(options2) {
           options2.onChange(job.artifact);
           return;
         }
-        import_node_fs32.default.mkdirSync(dir, { recursive: true });
-        const hash2 = result.status === "trimmed" ? digest2(import_node_fs32.default.readFileSync(prepared)) : void 0;
-        if (result.status === "trimmed") import_node_fs32.default.copyFileSync(prepared, output);
+        import_node_fs33.default.mkdirSync(dir, { recursive: true });
+        const hash2 = result.status === "trimmed" ? digest2(import_node_fs33.default.readFileSync(prepared)) : void 0;
+        if (result.status === "trimmed") import_node_fs33.default.copyFileSync(prepared, output);
         cached = { result, ...hash2 ? { hash: hash2 } : {} };
         writeJsonAtomic(metadata, cached);
       }
@@ -181969,7 +182221,7 @@ function createVerifyRecordings(options2) {
       };
       notify(job);
     } finally {
-      if (temporary) import_node_fs32.default.rmSync(temporary, { recursive: true, force: true });
+      if (temporary) import_node_fs33.default.rmSync(temporary, { recursive: true, force: true });
     }
   }
   function pump() {
@@ -182035,7 +182287,7 @@ function createVerifyRecordings(options2) {
         if (job.state.status === "processing") pending.add(boardId);
         if (job.virtual && job.output) {
           canvas.boards[boardId] = { ...board, file: job.virtual, src: job.virtual };
-          versions[job.virtual] = import_node_fs32.default.statSync(job.output).mtimeMs;
+          versions[job.virtual] = import_node_fs33.default.statSync(job.output).mtimeMs;
         }
       }
       for (const job of jobs.values()) if (job.artifact === id3 && !active.has(job.key)) stop(job);
@@ -182064,7 +182316,7 @@ function createVerifyRecordings(options2) {
           continue;
         const original = job.key.slice(id3.length + 1);
         if (!referenced.has(original)) overrides.set(original, null);
-        overrides.set(job.virtual, import_node_fs32.default.readFileSync(job.output));
+        overrides.set(job.virtual, import_node_fs33.default.readFileSync(job.output));
       }
       if (overrides.size) overrides.set("canvas.json", Buffer.from(JSON.stringify(payload.canvas)));
       return overrides;
@@ -182078,8 +182330,8 @@ function createVerifyRecordings(options2) {
 }
 
 // src/server/whiteboard.ts
-var import_node_fs33 = __toESM(require("node:fs"), 1);
-var import_node_path29 = __toESM(require("node:path"), 1);
+var import_node_fs34 = __toESM(require("node:fs"), 1);
+var import_node_path30 = __toESM(require("node:path"), 1);
 
 // src/server/whiteboard-lint.ts
 var LINE_TYPES = /* @__PURE__ */ new Set(["arrow", "line"]);
@@ -182129,16 +182381,16 @@ var segmentsCross = (a5, b6, c10, d10) => side(a5, b6, c10) * side(a5, b6, d10)
 var pathOf = (element) => {
   const { points: points2 } = element;
   if (!Array.isArray(points2) || points2.length < 2) return null;
-  const path44 = [];
+  const path45 = [];
   for (const point2 of points2) {
     if (!Array.isArray(point2) || typeof point2[0] !== "number" || typeof point2[1] !== "number")
       return null;
-    path44.push([(element.x ?? 0) + point2[0], (element.y ?? 0) + point2[1]]);
+    path45.push([(element.x ?? 0) + point2[0], (element.y ?? 0) + point2[1]]);
   }
-  return path44;
+  return path45;
 };
-var segmentsOf = (path44) => path44.slice(1).map((end, index) => [path44[index], end]);
-var lengthOf = (path44) => segmentsOf(path44).reduce((sum2, [a5, b6]) => sum2 + Math.hypot(b6[0] - a5[0], b6[1] - a5[1]), 0);
+var segmentsOf = (path45) => path45.slice(1).map((end, index) => [path45[index], end]);
+var lengthOf = (path45) => segmentsOf(path45).reduce((sum2, [a5, b6]) => sum2 + Math.hypot(b6[0] - a5[0], b6[1] - a5[1]), 0);
 var boundIds = (element) => [element.startBinding?.elementId, element.endBinding?.elementId].filter(
   (id3) => typeof id3 === "string"
 );
@@ -182175,18 +182427,18 @@ function arrowWarnings(live3, geometry) {
   );
   const arrows = live3.flatMap((element) => {
     if (!LINE_TYPES.has(element.type) || ryugi(element).author !== "agent") return [];
-    const path44 = pathOf(element);
-    return path44 ? [{ element, path: path44, bound: boundIds(element) }] : [];
+    const path45 = pathOf(element);
+    return path45 ? [{ element, path: path45, bound: boundIds(element) }] : [];
   });
   const warnings = [];
-  for (const { element, path: path44 } of arrows) {
-    const ends = [path44[0], path44.at(-1)];
+  for (const { element, path: path45 } of arrows) {
+    const ends = [path45[0], path45.at(-1)];
     const around = obstacles.filter(
       (shape2) => !ends.some((end) => holds(geometry[shape2.id], end))
     );
     for (const shape2 of around) {
       const box2 = inset(geometry[shape2.id], GRAZE);
-      if (segmentsOf(path44).some(([a5, b6]) => segmentHits(a5, b6, box2)))
+      if (segmentsOf(path45).some(([a5, b6]) => segmentHits(a5, b6, box2)))
         warnings.push(
           `arrow ${element.id} crosses ${shape2.id} \u2014 move ${shape2.id} or bend the arrow around it`
         );
@@ -182204,7 +182456,7 @@ function arrowWarnings(live3, geometry) {
     const need = Math.ceil(
       (Math.abs(dx2) * label.w + Math.abs(dy2) * label.h) / chord + LABEL_MARGIN
     );
-    const length = lengthOf(path44);
+    const length = lengthOf(path45);
     if (length < need)
       warnings.push(
         `label of arrow ${element.id} needs the arrow to be at least ${need} px long (now ${Math.round(length)}) \u2014 move its ends apart or shorten the label`
@@ -182236,7 +182488,7 @@ function readWhiteboard(dir, id3) {
   const version3 = latestMtime(dir);
   let source;
   try {
-    source = import_node_fs33.default.readFileSync(import_node_path29.default.join(dir, ENTRY_FILE.whiteboard), "utf8");
+    source = import_node_fs34.default.readFileSync(import_node_path30.default.join(dir, ENTRY_FILE.whiteboard), "utf8");
   } catch {
     return {
       title: id3,
@@ -182359,7 +182611,7 @@ function onlyPage(result, page, pages) {
 }
 
 // src/server/whiteboard-comments.ts
-var import_node_path30 = __toESM(require("node:path"), 1);
+var import_node_path31 = __toESM(require("node:path"), 1);
 
 // src/shared/whiteboard/comments.ts
 var MAX_ELEMENTS = 50;
@@ -182484,7 +182736,7 @@ function createWhiteboardComments(options2) {
     let found = stores.get(id3);
     if (!found) {
       found = createStore(
-        import_node_path30.default.join(options2.root, "whiteboard", id3, "comments.json"),
+        import_node_path31.default.join(options2.root, "whiteboard", id3, "comments.json"),
         rules,
         options2.names
       );
@@ -182580,8 +182832,8 @@ function createWhiteboardComments(options2) {
 }
 
 // src/server/whiteboards.ts
-var import_node_fs34 = __toESM(require("node:fs"), 1);
-var import_node_path31 = __toESM(require("node:path"), 1);
+var import_node_fs35 = __toESM(require("node:fs"), 1);
+var import_node_path32 = __toESM(require("node:path"), 1);
 
 // src/server/whiteboard-merge.ts
 var nonce = () => Math.floor(Math.random() * 2 ** 31);
@@ -182711,7 +182963,7 @@ var emptyScene = () => ({
 });
 var readText3 = (file) => {
   try {
-    return import_node_fs34.default.readFileSync(file, "utf8");
+    return import_node_fs35.default.readFileSync(file, "utf8");
   } catch {
     return null;
   }
@@ -182726,8 +182978,8 @@ var validGeometry = (value) => {
 };
 function writeTextAtomic(file, text5) {
   const tmp = `${file}.${process.pid}.tmp`;
-  import_node_fs34.default.writeFileSync(tmp, text5);
-  import_node_fs34.default.renameSync(tmp, file);
+  import_node_fs35.default.writeFileSync(tmp, text5);
+  import_node_fs35.default.renameSync(tmp, file);
 }
 function createWhiteboards(opts) {
   const writeDelayMs = opts.writeDelayMs ?? 500;
@@ -182736,9 +182988,9 @@ function createWhiteboards(opts) {
   const geometries = /* @__PURE__ */ new Map();
   const renders = /* @__PURE__ */ new Map();
   const legacyCleared = /* @__PURE__ */ new Set();
-  const stateDir = opts.stateDir ?? import_node_path31.default.join(opts.root, ".state");
-  const stateOf = (id3) => import_node_path31.default.join(stateDir, "whiteboard", id3);
-  const pageStateOf = (id3, page) => import_node_path31.default.join(stateOf(id3), "pages", page);
+  const stateDir = opts.stateDir ?? import_node_path32.default.join(opts.root, ".state");
+  const stateOf2 = (id3) => import_node_path32.default.join(stateDir, "whiteboard", id3);
+  const pageStateOf = (id3, page) => import_node_path32.default.join(stateOf2(id3), "pages", page);
   const keyOf = (id3, page) => `${id3}
 ${page}`;
   const list2 = (id3) => {
@@ -182746,7 +182998,7 @@ ${page}`;
     if (existing) return existing;
     const dir = resolveArtifactDir(opts.root, "whiteboard", id3);
     if (!dir) return null;
-    const file = import_node_path31.default.join(dir, PAGES_FILE);
+    const file = import_node_path32.default.join(dir, PAGES_FILE);
     const text5 = readText3(file);
     const parsed = parsePages(text5);
     const created = {
@@ -182780,7 +183032,7 @@ ${page}`;
     if (existing) return existing;
     const dir = resolveArtifactDir(opts.root, "whiteboard", id3);
     if (!dir) return null;
-    const file = import_node_path31.default.join(dir, pageFileOf(page));
+    const file = import_node_path32.default.join(dir, pageFileOf(page));
     const text5 = readText3(file);
     const parsed = text5 === null ? { scene: emptyScene() } : parseScene(text5, pageFileOf(page));
     const session = {
@@ -182809,7 +183061,7 @@ ${page}`;
     session.pending = false;
     const text5 = serializeScene(session.scene);
     if (text5 === session.written) return;
-    import_node_fs34.default.mkdirSync(import_node_path31.default.dirname(session.file), { recursive: true });
+    import_node_fs35.default.mkdirSync(import_node_path32.default.dirname(session.file), { recursive: true });
     writeTextAtomic(session.file, text5);
     session.written = text5;
   };
@@ -182875,7 +183127,7 @@ ${page}`;
     if (legacyCleared.has(id3)) return;
     legacyCleared.add(id3);
     for (const name of ["render.png", "render.json", "geometry.json"])
-      import_node_fs34.default.rmSync(import_node_path31.default.join(stateOf(id3), name), { force: true });
+      import_node_fs35.default.rmSync(import_node_path32.default.join(stateOf2(id3), name), { force: true });
   };
   const known = (id3, page) => isPageId(page) && resolveArtifactDir(opts.root, "whiteboard", id3) !== null;
   const live3 = (id3) => livePages(normalized2(id3)?.pages ?? []);
@@ -182944,19 +183196,19 @@ ${page}`;
     reportGeometry(id3, geometry, page = MAIN_PAGE) {
       if (!validGeometry(geometry) || !known(id3, page)) return false;
       geometries.set(keyOf(id3, page), geometry);
-      writeJsonAtomic(import_node_path31.default.join(pageStateOf(id3, page), "geometry.json"), geometry);
+      writeJsonAtomic(import_node_path32.default.join(pageStateOf(id3, page), "geometry.json"), geometry);
       stateWritten(id3);
       return true;
     },
     render: (id3, page = MAIN_PAGE) => renders.get(keyOf(id3, page)) ?? null,
-    renderPathOf: (id3, page = MAIN_PAGE) => import_node_path31.default.join(pageStateOf(id3, page), "render.png"),
+    renderPathOf: (id3, page = MAIN_PAGE) => import_node_path32.default.join(pageStateOf(id3, page), "render.png"),
     reportRender(id3, png, sceneVersion, page = MAIN_PAGE) {
       if (!Number.isFinite(sceneVersion) || !known(id3, page)) return false;
-      import_node_fs34.default.mkdirSync(pageStateOf(id3, page), { recursive: true });
-      writeTextAtomic(import_node_path31.default.join(pageStateOf(id3, page), "render.png"), png);
+      import_node_fs35.default.mkdirSync(pageStateOf(id3, page), { recursive: true });
+      writeTextAtomic(import_node_path32.default.join(pageStateOf(id3, page), "render.png"), png);
       const meta = { sceneVersion, at: (/* @__PURE__ */ new Date()).toISOString() };
       renders.set(keyOf(id3, page), meta);
-      writeJsonAtomic(import_node_path31.default.join(pageStateOf(id3, page), "render.json"), meta);
+      writeJsonAtomic(import_node_path32.default.join(pageStateOf(id3, page), "render.json"), meta);
       stateWritten(id3);
       return true;
     },
@@ -182981,7 +183233,6 @@ ${page}`;
 }
 
 // src/server/context.ts
-var REF_ARTBOARD = /<ref\b[^>]*?\bartboard="([^"]+)"/g;
 function readArtifactSource(dir, ref, runtime = []) {
   if (ref.type === "artboard") {
     const payload2 = readCanvas(dir);
@@ -183011,18 +183262,18 @@ function titleOf(payload) {
   return "Untitled artifact";
 }
 function createServerContext(options2) {
-  const root = import_node_path32.default.resolve(options2.root);
-  const viewerDir = import_node_path32.default.resolve(options2.viewerDir);
-  const runtimeDir = options2.runtimeDir ? import_node_path32.default.resolve(options2.runtimeDir) : null;
-  const stateDir = import_node_path32.default.join(root, ".state");
-  import_node_fs35.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
-  import_node_fs35.default.writeFileSync(import_node_path32.default.join(stateDir, ".gitignore"), "*\n");
+  const root = import_node_path33.default.resolve(options2.root);
+  const viewerDir = import_node_path33.default.resolve(options2.viewerDir);
+  const runtimeDir = options2.runtimeDir ? import_node_path33.default.resolve(options2.runtimeDir) : null;
+  const stateDir = import_node_path33.default.join(root, ".state");
+  import_node_fs36.default.mkdirSync(stateDir, { recursive: true, mode: 448 });
+  import_node_fs36.default.writeFileSync(import_node_path33.default.join(stateDir, ".gitignore"), "*\n");
   if (options2.configFile) ensureConfig(options2.configFile);
-  const portFile = import_node_path32.default.join(stateDir, ".last-port");
-  const tokenFile = import_node_path32.default.join(stateDir, ".last-token");
+  const portFile = import_node_path33.default.join(stateDir, ".last-port");
+  const tokenFile = import_node_path33.default.join(stateDir, ".last-token");
   const mount = options2.mount;
   const token = mount?.token ?? (readPersisted(tokenFile) || randomToken());
-  if (!mount) import_node_fs35.default.writeFileSync(tokenFile, `${token}
+  if (!mount) import_node_fs36.default.writeFileSync(tokenFile, `${token}
 `, { mode: 384 });
   const contentToken = randomToken();
   const loopback = isLoopbackHost(options2.host);
@@ -183052,7 +183303,7 @@ function createServerContext(options2) {
     const pages = whiteboards.livePages(id3).flatMap((page) => {
       const scene = whiteboards.scene(id3, page.id);
       if (!scene) return [];
-      const bytes = import_node_fs35.default.statSync(import_node_path32.default.join(dir, pageFileOf(page.id)), { throwIfNoEntry: false })?.size ?? 0;
+      const bytes = import_node_fs36.default.statSync(import_node_path33.default.join(dir, pageFileOf(page.id)), { throwIfNoEntry: false })?.size ?? 0;
       return [
         {
           id: page.id,
@@ -183125,8 +183376,8 @@ function createServerContext(options2) {
   });
   const avatars = createAvatars(options2.fetch);
   const names = commentNames({
-    agentFile: import_node_path32.default.join(stateDir, "agent"),
-    projectDir: import_node_path32.default.resolve(root, "../.."),
+    agentFile: import_node_path33.default.join(stateDir, "agent"),
+    projectDir: import_node_path33.default.resolve(root, "../.."),
     cloud: options2.cloud
   });
   const whiteboardComments = createWhiteboardComments({
@@ -183184,11 +183435,7 @@ function createServerContext(options2) {
       writeState({ type: "document", id: id3 }, dir);
       broadcast({ type: "change", artifact: `document/${id3}`, files: [] });
     },
-    onRefsChange: (_id, artboards, whiteboards2) => {
-      const targets = [
-        ...artboards.map((id3) => ({ type: "artboard", id: id3 })),
-        ...whiteboards2.map((id3) => ({ type: "whiteboard", id: id3 }))
-      ];
+    onRefsChange: (_id, targets) => {
       for (const ref of targets) {
         const dir = resolveArtifactDir(root, ref.type, ref.id);
         if (!dir) continue;
@@ -183244,15 +183491,9 @@ function createServerContext(options2) {
   const cloud = options2.cloud && options2.configFile ? createCloudRoutes({
     ...options2.cloud,
     configFile: options2.configFile,
-    project: import_node_path32.default.basename(import_node_path32.default.resolve(root, "../..")),
+    project: import_node_path33.default.basename(import_node_path33.default.resolve(root, "../..")),
     address: (ref) => artifactPath(root, ref.type, ref.id).split("/").pop(),
-    references: (ref) => {
-      if (ref.type !== "document") return [];
-      const dir = resolveArtifactDir(root, "document", ref.id);
-      const file = dir ? import_node_path32.default.join(dir, "doc.xml") : null;
-      const xml = file && import_node_fs35.default.existsSync(file) ? import_node_fs35.default.readFileSync(file, "utf8") : "";
-      return [...xml.matchAll(REF_ARTBOARD)].map((match) => match[1]).filter((slug) => resolveArtifactDir(root, "artboard", slug) !== null);
-    },
+    references: (ref) => referencesOf(root, `${ref.type}/${ref.id}`),
     port: () => ctx.port,
     inspect,
     onPublication: (key2, publication) => {
@@ -183260,7 +183501,7 @@ function createServerContext(options2) {
     }
   }) : null;
   const autoPublisher = cloud ? createAutoPublisher({
-    stateFile: import_node_path32.default.join(stateDir, "auto-publish.json"),
+    stateFile: import_node_path33.default.join(stateDir, "auto-publish.json"),
     enabled: cloud.autoPublishEnabled,
     token: cloud.token,
     publish: async (key2) => {
@@ -183306,7 +183547,7 @@ function createServerContext(options2) {
       staleThreads: boardComments.stale(ref.id),
       listening: boardComments.listening(ref.id),
       backlinks: backlinksOf(ref.id)
-    } : ref.type === "whiteboard" ? { backlinks: backlinksOf(ref.id, "whiteboard") } : {},
+    } : { backlinks: backlinksOf(ref.id, ref.type) },
     contentBase: `${contentOrigin}${contentPrefix}${ref.type}/${ref.id}/`
   });
   const signatures = /* @__PURE__ */ new Map();
@@ -183320,11 +183561,10 @@ function createServerContext(options2) {
         payload,
         ref.type === "artboard" ? { ...extra, ...artboardHints(ref.id) } : extra
       );
-      if (ref.type === "artboard" || ref.type === "whiteboard")
-        writeJsonAtomic(
-          import_node_path32.default.join(stateDir, ref.type, ref.id, "backlinks.json"),
-          backlinksOf(ref.id, ref.type)
-        );
+      writeJsonAtomic(
+        import_node_path33.default.join(stateDir, ref.type, ref.id, "backlinks.json"),
+        backlinksOf(ref.id, ref.type)
+      );
     } catch (err) {
       console.error(JSON.stringify({ type: "state-write-error", error: err.message }));
     }
@@ -183417,7 +183657,7 @@ function createServerContext(options2) {
   };
   return ctx;
 }
-var projectName = (ctx) => import_node_path32.default.basename(import_node_path32.default.dirname(import_node_path32.default.dirname(ctx.root)));
+var projectName = (ctx) => import_node_path33.default.basename(import_node_path33.default.dirname(import_node_path33.default.dirname(ctx.root)));
 
 // ../../node_modules/.pnpm/ws@8.18.3/node_modules/ws/wrapper.mjs
 var import_stream = __toESM(require_stream(), 1);
@@ -183591,8 +183831,8 @@ function createRelayClient(options2) {
 }
 
 // src/server/routes/content.ts
-var import_node_fs36 = __toESM(require("node:fs"), 1);
-var import_node_path33 = __toESM(require("node:path"), 1);
+var import_node_fs37 = __toESM(require("node:fs"), 1);
+var import_node_path34 = __toESM(require("node:path"), 1);
 function serveContent(ctx, res, rest, range, mode = "main") {
   const { root, runtimeDir, recordings, options: options2 } = ctx;
   if (rest.startsWith("runtime/")) {
@@ -183644,7 +183884,7 @@ function serveContent(ctx, res, rest, range, mode = "main") {
     sendFile(res, target, headers, range);
     return;
   }
-  import_node_fs36.default.readFile(target, "utf8", (err, source) => {
+  import_node_fs37.default.readFile(target, "utf8", (err, source) => {
     if (err) send(res, 404, "Not found");
     else {
       const uiRuntimeUrl = runtimeDir ? `${mode === "board" ? "/c/" : ctx.contentPrefix}runtime/ryugi-ui.js` : void 0;
@@ -183680,7 +183920,7 @@ var robotsRoute = {
   path: "/robots.txt",
   auth: "public",
   handle: (_req, res, ctx) => {
-    sendFile(res, import_node_path33.default.join(ctx.viewerDir, "robots.txt"));
+    sendFile(res, import_node_path34.default.join(ctx.viewerDir, "robots.txt"));
   }
 };
 var contentRoute = {
@@ -183727,8 +183967,8 @@ var createBoardRequestHandler = (ctx) => (req, res) => {
 };
 
 // src/server/routes/agent.ts
-var import_node_fs37 = __toESM(require("node:fs"), 1);
-var import_node_path34 = __toESM(require("node:path"), 1);
+var import_node_fs38 = __toESM(require("node:fs"), 1);
+var import_node_path35 = __toESM(require("node:path"), 1);
 
 // src/shared/whiteboard/summary.ts
 var STICKY_FILL = "#ffec99";
@@ -183859,7 +184099,7 @@ var CHECK_BROWSER_WAIT_MS = 1e4;
 var agentName = (fields) => typeof fields.agent === "string" && fields.agent.length > 0 && fields.agent.length <= 100 ? fields.agent : void 0;
 var blockIdsOf = async (ctx, id3, dir) => {
   await (await ctx.documents.open(id3))?.flush();
-  const state2 = parseDocument2(import_node_fs37.default.readFileSync(import_node_path34.default.join(dir, "doc.xml"), "utf8"));
+  const state2 = parseDocument2(import_node_fs38.default.readFileSync(import_node_path35.default.join(dir, "doc.xml"), "utf8"));
   return new Set(
     state2.root.children.flatMap(
       (block) => block.$?.blockId ? [block.$.blockId] : []
@@ -184044,7 +184284,7 @@ async function serveAgentCheck(res, ctx, type, id3, page = null) {
   let merging = false;
   if (ref.type === "document") {
     const session = await documents.open(ref.id);
-    const text5 = await import_node_fs37.default.promises.readFile(import_node_path34.default.join(dir, "doc.xml"), "utf8").catch(() => null);
+    const text5 = await import_node_fs38.default.promises.readFile(import_node_path35.default.join(dir, "doc.xml"), "utf8").catch(() => null);
     if (session && text5 !== null) {
       session.onFileText(text5);
       const timeout = new Promise(
@@ -184057,7 +184297,7 @@ async function serveAgentCheck(res, ctx, type, id3, page = null) {
   if (ref.type === "whiteboard") await whiteboardCaughtUp(ctx, ref.id, checkedPages);
   const payload = ctx.writeState(ref, dir);
   const written = JSON.parse(
-    await import_node_fs37.default.promises.readFile(import_node_path34.default.join(stateDir, ref.type, ref.id, "warnings.json"), "utf8")
+    await import_node_fs38.default.promises.readFile(import_node_path35.default.join(stateDir, ref.type, ref.id, "warnings.json"), "utf8")
   );
   const state2 = page === null ? written : {
     ...written,
@@ -184224,7 +184464,7 @@ async function serveAgentWhiteboardScene(req, res, ctx, id3) {
     sendJson(res, 404, { error: `whiteboard/${id3} not found` });
     return;
   }
-  const selection = readSelectedIds(import_node_path34.default.join(ctx.stateDir, "whiteboard", id3, "selection.json"));
+  const selection = readSelectedIds(import_node_path35.default.join(ctx.stateDir, "whiteboard", id3, "selection.json"));
   const summary = summarize(scene, { ...frame ? { frame } : {}, selected: selection });
   sendJson(res, 200, {
     artifact: `whiteboard/${id3}`,
@@ -184238,7 +184478,7 @@ async function serveAgentWhiteboardScene(req, res, ctx, id3) {
 }
 function readSelectedIds(file) {
   try {
-    const parsed = JSON.parse(import_node_fs37.default.readFileSync(file, "utf8"));
+    const parsed = JSON.parse(import_node_fs38.default.readFileSync(file, "utf8"));
     return (parsed.selected ?? []).flatMap(
       (item2) => typeof item2.id === "string" ? [item2.id] : []
     );
@@ -184548,8 +184788,8 @@ function shape(element, at7, scale) {
     case "arrow":
     case "line":
     case "freedraw": {
-      const path44 = points(element).map(([dx2, dy2]) => at7(x9 + dx2, y5 + dy2).join(",")).join(" ");
-      return path44 ? `<polyline points="${path44}" stroke="${stroke}" stroke-width="1.4" fill="none" stroke-linecap="round"/>` : "";
+      const path45 = points(element).map(([dx2, dy2]) => at7(x9 + dx2, y5 + dy2).join(",")).join(" ");
+      return path45 ? `<polyline points="${path45}" stroke="${stroke}" stroke-width="1.4" fill="none" stroke-linecap="round"/>` : "";
     }
     case "text": {
       const size = Math.max(4, Math.min(28, h9 || 12 * scale));
@@ -185085,8 +185325,8 @@ var clientSocketRoute = {
 };
 
 // src/server/routes/viewer.ts
-var import_node_fs38 = __toESM(require("node:fs"), 1);
-var import_node_path35 = __toESM(require("node:path"), 1);
+var import_node_fs39 = __toESM(require("node:fs"), 1);
+var import_node_path36 = __toESM(require("node:path"), 1);
 
 // src/shared/type-icons.ts
 var TYPE_GLYPHS = {
@@ -185215,8 +185455,8 @@ function serveShell(req, res, ctx, { pathname, key: key2 }, embedded) {
   if (ref) headers["Referrer-Policy"] = "same-origin";
   if (key2 !== null && !loopback)
     headers["Set-Cookie"] = `${ctx.cookieName}=${ctx.token}; HttpOnly; SameSite=Strict; Path=/`;
-  const entry = preview2 && import_node_fs38.default.existsSync(import_node_path35.default.join(viewerDir, "preview.html")) ? "preview.html" : "index.html";
-  void import_node_fs38.default.promises.readFile(import_node_path35.default.join(viewerDir, entry), "utf8").then((template) => {
+  const entry = preview2 && import_node_fs39.default.existsSync(import_node_path36.default.join(viewerDir, "preview.html")) ? "preview.html" : "index.html";
+  void import_node_fs39.default.promises.readFile(import_node_path36.default.join(viewerDir, entry), "utf8").then((template) => {
     const html = viewerPage(template, {
       title,
       description,
@@ -185568,7 +185808,7 @@ async function startArtifactsServer(options2) {
     } catch {
       ctx.port = await listen(server, options2.host, 0);
     }
-    import_node_fs39.default.writeFileSync(ctx.portFile, `${ctx.port}
+    import_node_fs40.default.writeFileSync(ctx.portFile, `${ctx.port}
 `, { mode: 384 });
   }
   const port = ctx.port;
@@ -185577,7 +185817,7 @@ async function startArtifactsServer(options2) {
   const boardServer = import_node_http.default.createServer(handleBoardRequest);
   if (mount) ctx.boardPort = mount.boardPort;
   else if (loopback) {
-    const boardPortFile = import_node_path36.default.join(stateDir, BOARD_PORT_FILE);
+    const boardPortFile = import_node_path37.default.join(stateDir, BOARD_PORT_FILE);
     const previousBoardPort = Number(readPersisted(boardPortFile));
     try {
       ctx.boardPort = await listen(
@@ -185588,7 +185828,7 @@ async function startArtifactsServer(options2) {
     } catch {
       ctx.boardPort = await listen(boardServer, options2.host, 0);
     }
-    import_node_fs39.default.writeFileSync(boardPortFile, `${ctx.boardPort}
+    import_node_fs40.default.writeFileSync(boardPortFile, `${ctx.boardPort}
 `, { mode: 384 });
   }
   const boardPort = ctx.boardPort;
@@ -185607,7 +185847,7 @@ async function startArtifactsServer(options2) {
     initialChanges.push({ ref: entry, payload, files: [] });
     if (entry.type === "document") void ctx.documents.open(entry.id);
   }
-  writeJsonAtomic(import_node_path36.default.join(stateDir, "server-info"), {
+  writeJsonAtomic(import_node_path37.default.join(stateDir, "server-info"), {
     type: "server-started",
     url,
     port,
@@ -185691,66 +185931,66 @@ async function startArtifactsServer(options2) {
       });
       await ctx.documents.close().catch(() => void 0);
       ctx.whiteboards.close();
-      if (mount) import_node_fs39.default.rmSync(import_node_path36.default.join(stateDir, "server-info"), { force: true });
+      if (mount) import_node_fs40.default.rmSync(import_node_path37.default.join(stateDir, "server-info"), { force: true });
     }
   };
 }
 var mountArtifactsProject = (options2) => startArtifactsServer(options2);
 
 // src/server/artifact-index.ts
-var import_node_fs41 = __toESM(require("node:fs"), 1);
-var import_node_path38 = __toESM(require("node:path"), 1);
+var import_node_fs42 = __toESM(require("node:fs"), 1);
+var import_node_path39 = __toESM(require("node:path"), 1);
 
 // src/server/machine.ts
-var import_node_fs40 = __toESM(require("node:fs"), 1);
+var import_node_fs41 = __toESM(require("node:fs"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
-var import_node_path37 = __toESM(require("node:path"), 1);
+var import_node_path38 = __toESM(require("node:path"), 1);
 var DORMANT_AFTER_MS = 7 * 24 * 60 * 60 * 1e3;
 function machinePaths(env = process.env, homedir = import_node_os.default.homedir()) {
-  const home = env.RYUGI_SERVER_HOME || import_node_path37.default.join(homedir, ".ryugi", "server");
+  const home = env.RYUGI_SERVER_HOME || import_node_path38.default.join(homedir, ".ryugi", "server");
   return {
     home,
-    pid: import_node_path37.default.join(home, "server.pid"),
-    serverId: import_node_path37.default.join(home, "server-instance-id"),
-    info: import_node_path37.default.join(home, "server-info"),
-    log: import_node_path37.default.join(home, "server.log"),
-    version: import_node_path37.default.join(home, "server-version"),
-    lock: import_node_path37.default.join(home, "start.lock"),
-    key: import_node_path37.default.join(home, "key"),
-    projects: import_node_path37.default.join(home, "projects.json"),
-    settings: import_node_path37.default.join(home, "settings.json"),
-    stopped: import_node_path37.default.join(home, "server-stopped")
+    pid: import_node_path38.default.join(home, "server.pid"),
+    serverId: import_node_path38.default.join(home, "server-instance-id"),
+    info: import_node_path38.default.join(home, "server-info"),
+    log: import_node_path38.default.join(home, "server.log"),
+    version: import_node_path38.default.join(home, "server-version"),
+    lock: import_node_path38.default.join(home, "start.lock"),
+    key: import_node_path38.default.join(home, "key"),
+    projects: import_node_path38.default.join(home, "projects.json"),
+    settings: import_node_path38.default.join(home, "settings.json"),
+    stopped: import_node_path38.default.join(home, "server-stopped")
   };
 }
 function ensureHome(home) {
-  import_node_fs40.default.mkdirSync(home, { recursive: true, mode: 448 });
-  import_node_fs40.default.chmodSync(home, 448);
+  import_node_fs41.default.mkdirSync(home, { recursive: true, mode: 448 });
+  import_node_fs41.default.chmodSync(home, 448);
 }
 var realDir = (dir) => {
   try {
-    return import_node_fs40.default.realpathSync(import_node_path37.default.resolve(dir));
+    return import_node_fs41.default.realpathSync(import_node_path38.default.resolve(dir));
   } catch {
-    return import_node_path37.default.resolve(dir);
+    return import_node_path38.default.resolve(dir);
   }
 };
 var validEntry = (value) => {
   const entry = value;
-  return !!entry && typeof entry.dir === "string" && import_node_path37.default.isAbsolute(entry.dir) && Number.isFinite(entry.registeredAt) && Number.isFinite(entry.lastUsedAt);
+  return !!entry && typeof entry.dir === "string" && import_node_path38.default.isAbsolute(entry.dir) && Number.isFinite(entry.registeredAt) && Number.isFinite(entry.lastUsedAt);
 };
 function readProjects(file) {
   try {
-    const value = JSON.parse(import_node_fs40.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs41.default.readFileSync(file, "utf8"));
     return Array.isArray(value.projects) ? value.projects.filter(validEntry) : [];
   } catch {
     return [];
   }
 }
 function writeProjects(file, projects) {
-  ensureHome(import_node_path37.default.dirname(file));
+  ensureHome(import_node_path38.default.dirname(file));
   const tmp = `${file}.${process.pid}.tmp`;
-  import_node_fs40.default.writeFileSync(tmp, `${JSON.stringify({ projects }, null, 2)}
+  import_node_fs41.default.writeFileSync(tmp, `${JSON.stringify({ projects }, null, 2)}
 `, { mode: 384 });
-  import_node_fs40.default.renameSync(tmp, file);
+  import_node_fs41.default.renameSync(tmp, file);
 }
 function registerProject(file, projectDir, now = Date.now()) {
   const dir = realDir(projectDir);
@@ -185767,10 +186007,10 @@ function removeProject(file, projectDir) {
   const kept = projects.filter((entry) => entry.dir !== dir);
   if (kept.length !== projects.length) writeProjects(file, kept);
 }
-var artifactsRootOf = (projectDir) => import_node_path37.default.join(projectDir, ".ryugi", "artifacts");
+var artifactsRootOf = (projectDir) => import_node_path38.default.join(projectDir, ".ryugi", "artifacts");
 function pruneProjects(file) {
   const projects = readProjects(file);
-  const kept = projects.filter((entry) => import_node_fs40.default.existsSync(artifactsRootOf(entry.dir)));
+  const kept = projects.filter((entry) => import_node_fs41.default.existsSync(artifactsRootOf(entry.dir)));
   if (kept.length !== projects.length) writeProjects(file, kept);
   return kept;
 }
@@ -185779,7 +186019,7 @@ var isDormant = (entry, now = Date.now()) => now - entry.lastUsedAt > DORMANT_AF
 // src/server/artifact-index.ts
 var readAddress = (dir) => {
   try {
-    const value = import_node_fs41.default.readFileSync(import_node_path38.default.join(dir, ".artifact-id"), "utf8").trim();
+    const value = import_node_fs42.default.readFileSync(import_node_path39.default.join(dir, ".artifact-id"), "utf8").trim();
     return isArtifactAddress(value) ? value : null;
   } catch {
     return null;
@@ -185787,7 +186027,7 @@ var readAddress = (dir) => {
 };
 var mtimeOf2 = (dir) => {
   try {
-    return import_node_fs41.default.statSync(dir).mtimeMs;
+    return import_node_fs42.default.statSync(dir).mtimeMs;
   } catch {
     return 0;
   }
@@ -185886,7 +186126,7 @@ var ARTIFACT_KEY = /^(?:artboard|document|html)\/[a-z0-9][a-z0-9-]*$/;
 var SEP = "\n";
 var realDir2 = (dir) => {
   try {
-    return import_node_fs42.default.realpathSync(import_node_path39.default.resolve(dir));
+    return import_node_fs43.default.realpathSync(import_node_path40.default.resolve(dir));
   } catch {
     return null;
   }
@@ -185944,7 +186184,7 @@ async function startHub(options2) {
         runtimeDir: options2.runtimeDir,
         host: options2.host,
         urlHost: options2.urlHost,
-        configFile: import_node_path39.default.join(project, ".ryugi", "config.json"),
+        configFile: import_node_path40.default.join(project, ".ryugi", "config.json"),
         cloud: options2.cloud,
         fetch: options2.fetch,
         debounceMs: options2.debounceMs,
@@ -185959,7 +186199,7 @@ async function startHub(options2) {
     }
     return pending;
   };
-  const configFileOf = (project) => import_node_path39.default.join(project, ".ryugi", "config.json");
+  const configFileOf = (project) => import_node_path40.default.join(project, ".ryugi", "config.json");
   const servedBy = (project) => {
     const mounted = ready.get(project);
     if (mounted) return mounted.served();
@@ -186006,10 +186246,10 @@ async function startHub(options2) {
   }) : null;
   const origin = `http://${urlHostForHttp(options2.urlHost)}:${port}`;
   const url = loopback ? `${origin}/` : `${origin}/?key=${options2.token}`;
-  const infoFileOf = (project) => import_node_path39.default.join(artifactsRootOf(project), ".state", "server-info");
+  const infoFileOf = (project) => import_node_path40.default.join(artifactsRootOf(project), ".state", "server-info");
   const writeCompatInfo = (project) => {
     try {
-      import_node_fs42.default.mkdirSync(import_node_path39.default.dirname(infoFileOf(project)), { recursive: true, mode: 448 });
+      import_node_fs43.default.mkdirSync(import_node_path40.default.dirname(infoFileOf(project)), { recursive: true, mode: 448 });
       writeJsonAtomic(infoFileOf(project), {
         type: "server-started",
         url,
@@ -186028,7 +186268,7 @@ async function startHub(options2) {
       counts.set(entry.project, (counts.get(entry.project) ?? 0) + 1);
     return ordered3().map((entry) => ({
       dir: entry.dir,
-      name: import_node_path39.default.basename(entry.dir),
+      name: import_node_path40.default.basename(entry.dir),
       lastUsedAt: entry.lastUsedAt,
       dormant: isDormant(entry),
       artifacts: counts.get(entry.dir) ?? 0
@@ -186041,7 +186281,7 @@ async function startHub(options2) {
       const root = artifactsRootOf(entry.dir);
       const listed = listArtifacts(root);
       for (const warning of listed.warnings)
-        warnings.push(`${import_node_path39.default.basename(entry.dir)}: ${warning}`);
+        warnings.push(`${import_node_path40.default.basename(entry.dir)}: ${warning}`);
       for (const artifact of listed.artifacts) {
         try {
           artifacts.push({
@@ -186092,7 +186332,7 @@ async function startHub(options2) {
   };
   const publishedIn = (project, cloudId) => {
     try {
-      const { artifacts } = readConfig(import_node_path39.default.join(project, ".ryugi", "config.json")).config;
+      const { artifacts } = readConfig(import_node_path40.default.join(project, ".ryugi", "config.json")).config;
       return Object.values(artifacts).some((entry) => entry.cloud?.id === cloudId);
     } catch {
       return false;
@@ -186155,7 +186395,7 @@ async function startHub(options2) {
   const register = async (dir, open2) => {
     const real = realDir2(dir);
     if (!real) throw new Error(`Project directory not found: ${dir}`);
-    import_node_fs42.default.mkdirSync(artifactsRootOf(real), { recursive: true });
+    import_node_fs43.default.mkdirSync(artifactsRootOf(real), { recursive: true });
     const entry = registerProject(projectsFile, real);
     index.rescan();
     writeCompatInfo(real);
@@ -186165,10 +186405,10 @@ async function startHub(options2) {
     return entry;
   };
   const remove2 = async (dir) => {
-    const real = realDir2(dir) ?? import_node_path39.default.resolve(dir);
+    const real = realDir2(dir) ?? import_node_path40.default.resolve(dir);
     removeProject(projectsFile, real);
     index.rescan();
-    import_node_fs42.default.rmSync(infoFileOf(real), { force: true });
+    import_node_fs43.default.rmSync(infoFileOf(real), { force: true });
     const pending = mounts.get(real);
     mounts.delete(real);
     ready.delete(real);
@@ -186176,17 +186416,17 @@ async function startHub(options2) {
   };
   const logTail = (project) => {
     try {
-      const fd3 = import_node_fs42.default.openSync(options2.paths.log, "r");
+      const fd3 = import_node_fs43.default.openSync(options2.paths.log, "r");
       try {
-        const size = import_node_fs42.default.fstatSync(fd3).size;
+        const size = import_node_fs43.default.fstatSync(fd3).size;
         const length = Math.min(size, LOG_TAIL_BYTES);
         const buffer = Buffer.alloc(length);
-        import_node_fs42.default.readSync(fd3, buffer, 0, length, size - length);
+        import_node_fs43.default.readSync(fd3, buffer, 0, length, size - length);
         const lines = buffer.toString("utf8").split("\n").filter(Boolean);
         if (length < size) lines.shift();
         return lines.filter((line2) => !project || line2.includes(project)).slice(-LOG_TAIL_LINES);
       } finally {
-        import_node_fs42.default.closeSync(fd3);
+        import_node_fs43.default.closeSync(fd3);
       }
     } catch {
       return [];
@@ -186324,7 +186564,7 @@ async function startHub(options2) {
       mounts.clear();
       ready.clear();
       await Promise.all(all.map(async (pending) => (await pending.catch(() => null))?.close()));
-      for (const entry of ordered3()) import_node_fs42.default.rmSync(infoFileOf(entry.dir), { force: true });
+      for (const entry of ordered3()) import_node_fs43.default.rmSync(infoFileOf(entry.dir), { force: true });
       for (const server of [front, board]) server.closeAllConnections();
       await Promise.all(stopped);
     }
@@ -186333,8 +186573,8 @@ async function startHub(options2) {
 
 // src/server/relaunch.ts
 var import_node_child_process4 = require("node:child_process");
-var import_node_fs43 = __toESM(require("node:fs"), 1);
-var import_node_path40 = __toESM(require("node:path"), 1);
+var import_node_fs44 = __toESM(require("node:fs"), 1);
+var import_node_path41 = __toESM(require("node:path"), 1);
 var LAUNCHER_COMMAND = /^node "(.+)"$/;
 var WAIT_THEN_RUN = `
 const [pid, file, ...args] = process.argv.slice(1);
@@ -186348,20 +186588,20 @@ tick();
 function relaunchCommand(env, serverDir) {
   const launcher = LAUNCHER_COMMAND.exec(env.RYUGI_ARTIFACTS_LAUNCHER ?? "")?.[1];
   if (launcher) return [process.execPath, launcher];
-  const cli = import_node_path40.default.join(serverDir, "cli.cjs");
-  return import_node_fs43.default.existsSync(cli) ? [process.execPath, cli] : null;
+  const cli = import_node_path41.default.join(serverDir, "cli.cjs");
+  return import_node_fs44.default.existsSync(cli) ? [process.execPath, cli] : null;
 }
 function pinLauncherRelease(env, homedir, version3, now = Date.now()) {
-  const releases = import_node_path40.default.join(
-    env.XDG_CACHE_HOME || import_node_path40.default.join(homedir, ".cache"),
+  const releases = import_node_path41.default.join(
+    env.XDG_CACHE_HOME || import_node_path41.default.join(homedir, ".cache"),
     "ryugi",
     "artifacts"
   );
-  import_node_fs43.default.mkdirSync(releases, { recursive: true });
-  const file = import_node_path40.default.join(releases, "latest.json");
+  import_node_fs44.default.mkdirSync(releases, { recursive: true });
+  const file = import_node_path41.default.join(releases, "latest.json");
   const tmp = `${file}.${process.pid}`;
-  import_node_fs43.default.writeFileSync(tmp, JSON.stringify({ version: version3, checkedAt: now }));
-  import_node_fs43.default.renameSync(tmp, file);
+  import_node_fs44.default.writeFileSync(tmp, JSON.stringify({ version: version3, checkedAt: now }));
+  import_node_fs44.default.renameSync(tmp, file);
 }
 function spawnAfterExit(pid, argv, env = process.env) {
   const [file, ...args] = argv;
@@ -186375,7 +186615,7 @@ function spawnAfterExit(pid, argv, env = process.env) {
 }
 
 // src/server/update-check.ts
-var import_node_fs44 = __toESM(require("node:fs"), 1);
+var import_node_fs45 = __toESM(require("node:fs"), 1);
 var REGISTRY_URL = "https://registry.npmjs.org/ryugi-artifacts/latest";
 var DAY_MS = 24 * 60 * 60 * 1e3;
 var TIMEOUT_MS2 = 5e3;
@@ -186390,7 +186630,7 @@ function newerVersion(candidate, current) {
 }
 function readCache(file) {
   try {
-    const value = JSON.parse(import_node_fs44.default.readFileSync(file, "utf8"));
+    const value = JSON.parse(import_node_fs45.default.readFileSync(file, "utf8"));
     return typeof value.version === "string" && Number.isFinite(value.checkedAt) ? value : null;
   } catch {
     return null;
@@ -186414,7 +186654,7 @@ function createUpdateCheck(options2) {
         const { version: version3 } = await res.json();
         if (typeof version3 !== "string") return;
         cached = { version: version3, checkedAt: now() };
-        import_node_fs44.default.writeFileSync(options2.cacheFile, `${JSON.stringify(cached)}
+        import_node_fs45.default.writeFileSync(options2.cacheFile, `${JSON.stringify(cached)}
 `, { mode: 384 });
       } catch {
       }
@@ -186426,12 +186666,12 @@ function createUpdateCheck(options2) {
 var UPDATE_POLL_MS = 60 * 60 * 1e3;
 function machineKey(file) {
   try {
-    const key3 = import_node_fs45.default.readFileSync(file, "utf8").trim();
+    const key3 = import_node_fs46.default.readFileSync(file, "utf8").trim();
     if (/^[a-f0-9]{48}$/.test(key3)) return key3;
   } catch {
   }
   const key2 = import_node_crypto13.default.randomBytes(24).toString("hex");
-  import_node_fs45.default.writeFileSync(file, `${key2}
+  import_node_fs46.default.writeFileSync(file, `${key2}
 `, { mode: 384 });
   return key2;
 }
@@ -186440,14 +186680,14 @@ async function main2() {
   const paths = machinePaths();
   ensureHome(paths.home);
   const updates = createUpdateCheck({
-    cacheFile: import_node_path41.default.join(paths.home, "latest.json"),
+    cacheFile: import_node_path42.default.join(paths.home, "latest.json"),
     current: version
   });
   const hub = await startHub({
     host: config.host,
     urlHost: config.urlHost,
-    viewerDir: import_node_path41.default.join(__dirname, "viewer"),
-    runtimeDir: import_node_path41.default.join(__dirname, "runtime"),
+    viewerDir: import_node_path42.default.join(__dirname, "viewer"),
+    runtimeDir: import_node_path42.default.join(__dirname, "runtime"),
     ports: config.ports,
     boardPorts: config.boardPorts,
     paths,
@@ -186484,14 +186724,14 @@ async function main2() {
     if (stopping) return;
     stopping = true;
     console.info(JSON.stringify({ type: "server-stopped", reason, at: (/* @__PURE__ */ new Date()).toISOString() }));
-    import_node_fs45.default.rmSync(paths.info, { force: true });
+    import_node_fs46.default.rmSync(paths.info, { force: true });
     if (intended) writeJsonAtomic(paths.stopped, { reason, timestamp: Date.now() });
     await hub.close();
     process.exit(0);
   }
   function readRunningVersion() {
     try {
-      return import_node_fs45.default.readFileSync(paths.version, "utf8").trim() || version;
+      return import_node_fs46.default.readFileSync(paths.version, "utf8").trim() || version;
     } catch {
       return version;
     }
@@ -186534,7 +186774,7 @@ async function main2() {
   process.on("SIGTERM", () => void shutdown("SIGTERM"));
   process.on("SIGINT", () => void shutdown("SIGINT"));
   process.on("SIGHUP", () => void shutdown("SIGHUP"));
-  import_node_fs45.default.rmSync(paths.stopped, { force: true });
+  import_node_fs46.default.rmSync(paths.stopped, { force: true });
   const started = {
     type: "server-started",
     url: hub.url,