ryugi-artifacts 1.66.0 → 1.68.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.68.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);
@@ -50270,10 +50270,10 @@ function blocksOf(diff) {
 }
 function countStates(items) {
   const summary = /* @__PURE__ */ new Map();
-  for (const item2 of items) {
-    const status = item2.kind === "choose" ? item2.choice ? "chosen" : "empty" : String(item2.state ?? item2.verdict ?? item2.status ?? "unknown");
+  for (const item3 of items) {
+    const status = item3.kind === "choose" ? item3.choice ? "chosen" : "empty" : String(item3.state ?? item3.verdict ?? item3.status ?? "unknown");
     summary.set(status, (summary.get(status) ?? 0) + 1);
-    if (item2.waitingOn === "agent")
+    if (item3.waitingOn === "agent")
       summary.set("waitingOnAgent", (summary.get("waitingOnAgent") ?? 0) + 1);
   }
   return Object.fromEntries(summary);
@@ -50391,7 +50391,7 @@ function createAgentReview(stateDir, options2 = {}) {
       throw new ReviewError("E_ARGUMENT_INVALID", "limit must be between 1 and 100.");
     let values = snap.value.items ?? [];
     if (input.thread) {
-      values = values.filter((item2) => item2.id === input.thread);
+      values = values.filter((item3) => item3.id === input.thread);
       if (!values.length)
         throw new ReviewError("E_THREAD_NOT_FOUND", "Thread not found in this snapshot.", 404);
     }
@@ -50404,12 +50404,12 @@ function createAgentReview(stateDir, options2 = {}) {
     }) : null;
     let receipt;
     if (detail && !input.all && !snap.value.all && !input.fields && snap.value.kind === "threads" && selected.length) {
-      const tokens = selected.flatMap((item2) => snap.value.tokens?.[String(item2.id)] ?? []);
+      const tokens = selected.flatMap((item3) => snap.value.tokens?.[String(item3.id)] ?? []);
       if (tokens.length) receipt = lease("receipt", input, { kind: "threads", tokens });
     }
-    const materialized = selected.map((item2) => {
-      if (detail || snap.value.kind !== "threads") return item2;
-      const thread = item2;
+    const materialized = selected.map((item3) => {
+      if (detail || snap.value.kind !== "threads") return item3;
+      const thread = item3;
       const messages = thread.messages.filter((message2) => !message2.deleted);
       const last = messages.filter((message2) => message2.author === "human").at(-1) ?? messages.at(-1);
       return {
@@ -50417,10 +50417,10 @@ function createAgentReview(stateDir, options2 = {}) {
         status: thread.status,
         waitingOn: waitingOn(thread),
         anchor: thread.anchor,
-        stale: item2.stale ?? false,
-        ...item2.orphan === true ? { orphan: true } : {},
-        ...item2.draft === true ? { draft: true } : {},
-        ...typeof item2.page === "string" ? { page: item2.page } : {},
+        stale: item3.stale ?? false,
+        ...item3.orphan === true ? { orphan: true } : {},
+        ...item3.draft === true ? { draft: true } : {},
+        ...typeof item3.page === "string" ? { page: item3.page } : {},
         preview: preview(
           last?.text ?? (thread.messages.some((message2) => message2.deleted) ? "[deleted]" : "")
         ),
@@ -50430,8 +50430,8 @@ function createAgentReview(stateDir, options2 = {}) {
     });
     const required = snap.value.kind === "changes" ? ["id"] : requiredReviewFields[snap.value.kind];
     const items = input.fields ? materialized.map(
-      (item2) => Object.fromEntries(
-        Object.entries(item2).filter(
+      (item3) => Object.fromEntries(
+        Object.entries(item3).filter(
           ([key2]) => input.fields.includes(key2) || required.includes(key2)
         )
       )
@@ -50480,7 +50480,7 @@ function createAgentReview(stateDir, options2 = {}) {
       const snap = snapshot2(input, input.section, () => ({
         counts: countStates(input.items),
         items: input.items.filter(
-          (item2) => keep(item2) && (!input.filters?.status || item2.state === input.filters.status || item2.verdict === input.filters.status) && (!input.filters?.kind || item2.kind === input.filters.kind) && (!input.filters?.choiceState || (input.filters.choiceState === "chosen" ? !!item2.choice : !item2.choice))
+          (item3) => keep(item3) && (!input.filters?.status || item3.state === input.filters.status || item3.verdict === input.filters.status) && (!input.filters?.kind || item3.kind === input.filters.kind) && (!input.filters?.choiceState || (input.filters.choiceState === "chosen" ? !!item3.choice : !item3.choice))
         )
       }));
       return page(input, snap, !!input.detail);
@@ -50522,7 +50522,7 @@ function createAgentReview(stateDir, options2 = {}) {
         { ...snap, value: { ...snap.value, items: blocks.map((block) => ({ ...block })) } },
         false
       );
-      const selected = summary ? new Set(summary.items.map((item2) => item2.id)) : void 0;
+      const selected = summary ? new Set(summary.items.map((item3) => item3.id)) : void 0;
       let receipt;
       if (input.detail && !input.all && !snap.value.all && !input.fields && !snap.value.empty)
         receipt = lease("receipt", input, { kind: "changes", to: snap.value.to });
@@ -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,47 @@ 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;
+  });
+}
+function referrersOf(root, key2) {
+  const found = [];
+  for (const each of listArtifacts(root).artifacts) {
+    const extract = REFERENCES_OF[each.type];
+    const from = `${each.type}/${each.id}`;
+    if (!extract || from === key2) continue;
+    const uses = extract(each.dir).filter((target) => target === key2).length;
+    if (uses > 0) found.push({ key: from, uses });
+  }
+  return found.sort((a5, b6) => a5.key.localeCompare(b6.key));
+}
+
 // src/server/cloud.ts
 var import_node_crypto10 = __toESM(require("node:crypto"), 1);
 
@@ -51826,6 +51888,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((item3) => [item3.artifact, item3]));
+  const wanted = (item3) => ACTIONABLE.includes(item3.state) && (overrides[item3.artifact] ?? CHECKED_BY_DEFAULT.includes(item3.state));
+  const isRoot = (key2) => root ? key2 === root : !byKey.has(key2);
+  const reachable = /* @__PURE__ */ new Set();
+  const opens = (key2) => {
+    if (isRoot(key2)) return true;
+    const item3 = byKey.get(key2);
+    return !!item3 && reachable.has(key2) && (item3.open || wanted(item3));
+  };
+  for (let changed = true; changed; ) {
+    changed = false;
+    for (const item3 of items) {
+      if (reachable.has(item3.artifact) || !item3.parents.some(opens)) continue;
+      reachable.add(item3.artifact);
+      changed = true;
+    }
+  }
+  return items.map((item3) => {
+    const { reason: _reason, upstream: _upstream, ...rest } = item3;
+    const reason = item3.state === "blocked" ? item3.blocked : void 0;
+    if (!reachable.has(item3.artifact))
+      return {
+        ...rest,
+        checked: false,
+        selectable: false,
+        reason: "upstream",
+        upstream: item3.via ?? item3.parents[0]
+      };
+    return {
+      ...rest,
+      checked: wanted(item3),
+      selectable: ACTIONABLE.includes(item3.state),
+      ...reason ? { reason } : {}
+    };
+  });
+}
+
 // src/shared/cloud-error.ts
 function cloudErrorDetails(value) {
   if (!value || typeof value !== "object") return {};
@@ -51846,6 +51986,53 @@ function cloudErrorDetails(value) {
   return details;
 }
 
+// src/shared/referrers.ts
+var SELECTABLE = ["private", "unpublished", "unlinked"];
+var item = (base) => ({
+  ...base,
+  selectable: SELECTABLE.includes(base.state),
+  checked: false
+});
+function localState(status, cloudKnown) {
+  if (!status.published) {
+    if (status.withdrawn) return { state: "withdrawn" };
+    if (status.blocked) return { state: "blocked", reason: status.blocked };
+    return { state: "unpublished" };
+  }
+  const isPrivate = status.visibility === "private";
+  if (!cloudKnown) return { state: isPrivate ? "private" : "ready" };
+  return isPrivate ? { state: "private", needsUpdate: true } : { state: "unlinked" };
+}
+function mergeReferrers({
+  cloud,
+  local
+}) {
+  const byCloudId = new Map(
+    local.filter((each) => each.cloudId).map((each) => [each.cloudId, each])
+  );
+  const fromCloud = (cloud ?? []).map((each) => {
+    const match = byCloudId.get(each.cloudId);
+    return item({
+      artifact: match?.key ?? `cloud:${each.cloudId}`,
+      cloudId: each.cloudId,
+      title: match?.status.title ?? each.title,
+      uses: each.uses,
+      state: each.visibility === "private" ? "private" : "ready"
+    });
+  });
+  const known = new Set((cloud ?? []).map((each) => each.cloudId));
+  const fromLocal = local.filter((each) => !each.cloudId || !known.has(each.cloudId)).map(
+    (each) => item({
+      artifact: each.key,
+      cloudId: each.cloudId,
+      title: each.status.title,
+      uses: each.uses,
+      ...localState(each.status, cloud !== null)
+    })
+  );
+  return [...fromCloud, ...fromLocal];
+}
+
 // src/shared/brand.ts
 var RYUGI_MARK_VIEWBOX = "0 0 512 512";
 var RYUGI_MARK_BODY = '<g transform="translate(82 136.317460) scale(0.613756614)"><g transform="translate(0.000000,390.000000) scale(0.100000,-0.100000)" stroke="none"><path d="M4945 3889 c-339 -44 -682 -239 -905 -517 -139 -172 -232 -355 -365 -717 -136 -368 -285 -735 -360 -890 -219 -449 -524 -768 -849 -887 -121 -44 -215 -60 -356 -60 -162 0 -244 18 -450 97 -291 111 -420 144 -650 166 -257 24 -637 -19 -772 -87 -148 -75 -249 -247 -235 -399 19 -197 186 -344 392 -346 40 -1 127 11 205 27 115 23 160 28 300 28 242 1 372 -29 671 -155 226 -95 467 -149 662 -149 252 0 548 74 789 197 394 201 708 521 988 1008 83 144 271 529 405 830 220 493 300 632 436 759 121 112 226 162 424 201 44 9 108 29 143 45 165 77 274 285 244 467 -31 188 -168 334 -354 378 -70 16 -249 18 -363 4z M765 3139 c-202 -11 -415 -48 -497 -86 -91 -44 -151 -101 -193 -186 -123 -248 31 -525 307 -554 38 -4 99 3 204 23 137 27 167 29 384 29 205 0 249 -3 347 -23 225 -45 387 -106 658 -247 182 -94 308 -144 463 -182 138 -35 350 -39 447 -9 174 53 275 152 305 299 26 130 -40 267 -158 323 -52 25 -72 28 -227 35 -248 11 -328 37 -576 187 -232 140 -384 213 -585 281 -283 95 -541 127 -879 110z M620 2104 c-273 -32 -384 -65 -471 -143 -235 -208 -136 -589 172 -660 68 -16 129 -13 272 14 400 73 702 31 1167 -163 239 -99 350 -125 535 -125 193 0 338 51 448 157 117 113 139 261 56 375 -50 69 -99 85 -294 92 -245 10 -332 35 -563 163 -224 123 -456 211 -693 262 -111 23 -149 26 -359 29 -129 2 -251 1 -270 -1z"/></g></g>';
@@ -52093,7 +52280,7 @@ footer { display: flex; align-items: center; gap: 8px; margin-top: 28px; font-si
   h1 { margin-top: 16px; font-size: 26px; line-height: 1.22; }
 }
 `;
-var item = (lead, title, detail) => `<li>${lead}<div><b>${title}</b><span>${detail}</span></div></li>`;
+var item2 = (lead, title, detail) => `<li>${lead}<div><b>${title}</b><span>${detail}</span></div></li>`;
 var autoPublishCard = (t7, on6, ticket) => `<section class="card auto"><form method="post" action="/api/cloud/callback/auto-publish">
         <input type="hidden" name="ticket" value="${escapeHtml(ticket)}">
         <span class="text"><b>${on6 ? t7("callback.autoPublishOn") : t7("callback.autoPublishOff")}</b><span>${t7("callback.autoPublishDetail")}</span></span>
@@ -52104,13 +52291,13 @@ var signedInBody = (t7, result) => `<p class="pill">${CIRCLE_CHECK}${t7("callbac
       <p class="lead">${t7("callback.lead")}</p>
       ${autoPublishCard(t7, result.autoPublish, result.ticket)}
       <p class="label">${t7("callback.whatNext")}</p>
-      <ul class="card">${item(`<span class="icon">${PANEL}</span>`, t7("callback.fromPage"), t7("callback.fromPageDetail"))}${item(`<span class="icon">${TERMINAL}</span>`, t7("callback.fromAgent"), t7("callback.fromAgentDetail"))}</ul>
+      <ul class="card">${item2(`<span class="icon">${PANEL}</span>`, t7("callback.fromPage"), t7("callback.fromPageDetail"))}${item2(`<span class="icon">${TERMINAL}</span>`, t7("callback.fromAgent"), t7("callback.fromAgentDetail"))}</ul>
       <footer>${CHECK}<span>${t7("callback.closeOk")}</span></footer>`;
 var failedBody = (t7, result) => `<p class="pill">${CIRCLE_ALERT}${t7("callback.notConnected")}</p>
       <h1>${t7("callback.titleFailed")}</h1>
       <p class="lead">${escapeHtml(result.detail)}</p>
       <p class="label">${t7("callback.toTryAgain")}</p>
-      <ol class="card">${item('<span class="step">1</span>', t7("callback.stepBack"), t7("callback.stepBackDetail"))}${item('<span class="step">2</span>', t7("callback.stepSignIn"), t7("callback.stepSignInDetail"))}</ol>
+      <ol class="card">${item2('<span class="step">1</span>', t7("callback.stepBack"), t7("callback.stepBackDetail"))}${item2('<span class="step">2</span>', t7("callback.stepSignIn"), t7("callback.stepSignInDetail"))}</ol>
       <details><summary>${t7("callback.otherReasons")}</summary><ul><li>${t7("callback.reasonUnreachable")}</li><li>${t7("callback.reasonRefused")}</li></ul></details>
       <footer><span>${t7("callback.closeFailed")}</span></footer>`;
 function callbackPage(result, locale = "en") {
@@ -52141,8 +52328,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 +52370,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 +52385,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 +52420,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 +52449,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 +52459,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 +52472,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 +52490,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 +52504,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"]);
@@ -52373,8 +52560,8 @@ function parseScene(text5, file = "scene.excalidraw") {
   const elements = body.elements ?? [];
   if (!Array.isArray(elements)) return { error: `${file}: elements must be an array` };
   for (const [index, element] of elements.entries()) {
-    const item2 = record(element);
-    if (typeof item2.id !== "string" || typeof item2.type !== "string")
+    const item3 = record(element);
+    if (typeof item3.id !== "string" || typeof item3.type !== "string")
       return { error: `${file}: element ${index} needs a string id and type` };
   }
   return {
@@ -53737,17 +53924,17 @@ function escapeXml(text5) {
 function buildAttrs(attrs) {
   return Object.entries(attrs).filter(([, v6]) => v6 !== void 0 && v6 !== "").map(([k4, v6]) => ` ${k4}="${escapeXml(v6)}"`).join("");
 }
-function isCdata(item2) {
-  return typeof item2 === "object" && "cdata" in item2;
+function isCdata(item3) {
+  return typeof item3 === "object" && "cdata" in item3;
 }
-function renderCdata(item2) {
-  return `<![CDATA[${item2.cdata}]]>`;
+function renderCdata(item3) {
+  return `<![CDATA[${item3.cdata}]]>`;
 }
 function renderXml(content, indent = 0, options2 = {}) {
   const lines = [];
-  for (const item2 of content) if (typeof item2 === "string") lines.push(escapeXml(item2));
-  else if (isCdata(item2)) lines.push(renderCdata(item2));
-  else lines.push(renderElement(item2, indent, options2));
+  for (const item3 of content) if (typeof item3 === "string") lines.push(escapeXml(item3));
+  else if (isCdata(item3)) lines.push(renderCdata(item3));
+  else lines.push(renderElement(item3, indent, options2));
   return lines.join("");
 }
 function renderElement(el3, indent, options2) {
@@ -54016,12 +54203,12 @@ function serializeToXml(state2, registry2, options2 = {}) {
     if (!selectedBlockIds?.size) return items;
     const blockId2 = child.$?.blockId;
     if (!blockId2 || !selectedBlockIds.has(blockId2)) return items;
-    return items.map((item2) => {
-      if (typeof item2 === "string" || "cdata" in item2) return item2;
+    return items.map((item3) => {
+      if (typeof item3 === "string" || "cdata" in item3) return item3;
       return {
-        ...item2,
+        ...item3,
         attrs: {
-          ...item2.attrs,
+          ...item3.attrs,
           selected: "true"
         }
       };
@@ -57428,9 +57615,9 @@ function getAtomFeed(feedRoot) {
   const childs = feedRoot.children;
   const feed = {
     type: "atom",
-    items: getElementsByTagName("entry", childs).map((item2) => {
+    items: getElementsByTagName("entry", childs).map((item3) => {
       var _a6;
-      const { children: children2 } = item2;
+      const { children: children2 } = item3;
       const entry = { media: getMediaElements(children2) };
       addConditionally(entry, "id", "id", children2);
       addConditionally(entry, "title", "title", children2);
@@ -57469,8 +57656,8 @@ function getRssFeed(feedRoot) {
   const feed = {
     type: feedRoot.name.substr(0, 3),
     id: "",
-    items: getElementsByTagName("item", feedRoot.children).map((item2) => {
-      const { children: children2 } = item2;
+    items: getElementsByTagName("item", feedRoot.children).map((item3) => {
+      const { children: children2 } = item3;
       const entry = { media: getMediaElements(children2) };
       addConditionally(entry, "id", "guid", children2);
       addConditionally(entry, "title", "title", children2);
@@ -59677,8 +59864,8 @@ function getAtomFeed2(feedRoot) {
   const childs = feedRoot.children;
   const feed = {
     type: "atom",
-    items: getElementsByTagName2("entry", childs).map((item2) => {
-      const { children: children2 } = item2;
+    items: getElementsByTagName2("entry", childs).map((item3) => {
+      const { children: children2 } = item3;
       const entry = { media: getMediaElements2(children2) };
       addConditionally2(entry, "id", "id", children2);
       addConditionally2(entry, "title", "title", children2);
@@ -59716,8 +59903,8 @@ function getRssFeed2(feedRoot) {
   const feed = {
     type: feedRoot.name.substr(0, 3),
     id: "",
-    items: getElementsByTagName2("item", feedRoot.children).map((item2) => {
-      const { children: children2 } = item2;
+    items: getElementsByTagName2("item", feedRoot.children).map((item3) => {
+      const { children: children2 } = item3;
       const entry = { media: getMediaElements2(children2) };
       addConditionally2(entry, "id", "guid", children2);
       addConditionally2(entry, "title", "title", children2);
@@ -61810,9 +61997,9 @@ var NamedNodeMap = class extends Array {
     this.unshift(attr);
   }
   removeNamedItem(name) {
-    const item2 = this.getNamedItem(name);
+    const item3 = this.getNamedItem(name);
     this.ownerElement.removeAttribute(name);
-    this.splice(this.indexOf(item2), 1);
+    this.splice(this.indexOf(item3), 1);
   }
   item(index) {
     return index < this.length ? this[index] : null;
@@ -64872,63 +65059,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 +66406,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 +66460,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 +66498,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 +66514,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 +66523,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 +66543,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|publish-referrers|publication|refs|reserve|visibility|auto-publish|sync)(?:\/([^/]+)(?:\/([^/]+))?)?$/;
 var SignedOut = class extends Error {
 };
 var CloudRefused = class extends Error {
@@ -66479,7 +66660,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 +66674,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 +66703,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 +66795,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 +67006,182 @@ 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 cloudReferrers = async (cloudId) => {
+    try {
+      const res = await cloudFetch("GET", `/api/a/${cloudId}/refs`);
+      if (!res.ok) return null;
+      const body = await res.json();
+      return Array.isArray(body.referrers) ? body.referrers : null;
+    } catch {
+      return null;
+    }
+  };
+  const referrersOf2 = async (ref) => {
+    const local = [];
+    for (const { key: key2, uses } of options2.referrers?.(ref) ?? []) {
+      const status = await cascadeStatus(key2);
+      if (status) local.push({ key: key2, uses, status, cloudId: artifactEntry(key2).cloud?.id ?? null });
+    }
+    const root = artifactEntry(`${ref.type}/${ref.id}`).cloud;
+    const cloud = root?.publishedAt ? await cloudReferrers(root.id) : null;
+    const cloudUnavailable = !!root?.publishedAt && cloud === null;
+    return {
+      referrers: mergeReferrers({ cloud, local }),
+      ...cloudUnavailable ? { cloudUnavailable: true } : {}
+    };
+  };
+  const publishReferrers = async (ref, publishKeys, makePublic) => {
+    const rootKey = `${ref.type}/${ref.id}`;
+    const root = artifactEntry(rootKey);
+    if (!root.cloud?.publishedAt || publishState(root).visibility !== "public")
+      throw new CloudRefused(400, `${rootKey} is not public`);
+    const { referrers } = await referrersOf2(ref);
+    const known = new Map(referrers.map((item3) => [item3.artifact, item3]));
+    for (const key2 of makePublic)
+      if (known.get(key2)?.state !== "private")
+        throw new CloudRefused(400, `${key2} is not a private document that references ${rootKey}`);
+    for (const key2 of publishKeys) {
+      const state2 = known.get(key2)?.state;
+      if (state2 !== "unpublished" && state2 !== "unlinked")
+        throw new CloudRefused(400, `${key2} is not a document ${rootKey} can publish`);
+    }
+    const results = [];
+    for (const key2 of [...makePublic, ...publishKeys]) {
+      const item3 = known.get(key2);
+      const action = makePublic.includes(key2) ? "make-public" : item3.state === "unlinked" ? "update" : "publish";
+      try {
+        if (!artifactKeyOf(key2)) {
+          await expectOk(
+            await cloudFetch("PATCH", `/api/artifacts/${item3.cloudId}`, { visibility: "public" })
+          );
+        } else
+          await serialized(key2, async () => {
+            const target = artifactKeyOf(key2);
+            if (action === "make-public") {
+              await setVisibility(target, "public");
+              if (!item3.needsUpdate) return;
+            }
+            const result = await publish(target, "public");
+            if (result.status !== 200)
+              throw new CloudRefused(
+                409,
+                (result.body.reasons ?? []).join("; ") || "not ready to publish"
+              );
+            updateArtifactConfig(configFile, key2, { autoPublish: null });
+          });
+        results.push({ artifact: key2, action, status: "published" });
+      } catch (err) {
+        if (err instanceof SignedOut) throw err;
+        const httpStatus = err instanceof CloudRefused ? err.status : void 0;
+        results.push({
+          artifact: key2,
+          action,
+          status: httpStatus !== void 0 && httpStatus < 500 ? "failed" : "unknown",
+          error: {
+            error: err.message.replace(/^cloud refused \(\d+\): /, ""),
+            ...httpStatus === void 0 ? {} : { httpStatus }
+          }
+        });
+      }
+    }
+    return { results };
+  };
+  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((item3) => [item3.artifact, false])
+    );
+    for (const key2 of [...refs3, ...makePublic]) overrides[key2] = true;
+    const items = resolveSelection(listed, overrides);
+    const known = new Map(items.map((item3) => [item3.artifact, item3]));
+    for (const key2 of [...refs3, ...makePublic]) {
+      const item3 = known.get(key2);
+      if (!item3?.selectable)
+        throw new CloudRefused(400, `${key2} is not a reference ${rootKey} can publish`);
+      if (makePublic.includes(key2) !== (item3.state === "private"))
+        throw new CloudRefused(
+          400,
+          item3.state === "private" ? `${key2} is private: list it in makePublic` : `${key2} is not private: list it in refs`
+        );
+    }
+    const results = [];
+    let stopped = false;
+    for (const item3 of items.filter((each) => each.checked)) {
+      const action = item3.state === "private" ? "make-public" : item3.state === "stale" ? "update" : "publish";
+      if (stopped) {
+        results.push({ artifact: item3.artifact, action, status: "not_attempted" });
+        continue;
+      }
+      const target = artifactKeyOf(item3.artifact);
+      try {
+        await serialized(item3.artifact, async () => {
+          if (action === "make-public") {
+            await setVisibility(target, "public");
+            if (!item3.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, item3.artifact, { autoPublish: null });
+        });
+        results.push({ artifact: item3.artifact, action, status: "published" });
+      } catch (err) {
+        if (err instanceof SignedOut) throw err;
+        const httpStatus = err instanceof CloudRefused ? err.status : void 0;
+        results.push({
+          artifact: item3.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 +67219,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 +67241,38 @@ 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 query2 = new URL(req.url ?? "/", "http://hub").searchParams;
+      const requested = query2.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),
+        ...query2.get("referrers") === "0" ? {} : await referrersOf2(ref)
+      });
+      return;
+    }
+    if (action === "publish-referrers" && ref && method === "POST") {
+      const body = await readJsonBody(req);
+      const list2 = (value) => Array.isArray(value) ? value.filter((each) => typeof each === "string") : [];
+      sendJson(res, 200, await publishReferrers(ref, list2(body?.publish), list2(body?.makePublic)));
+      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 +67406,22 @@ 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), ...await referrersOf2(ref) };
+    },
+    publishRefsNow(key2, refs3, makePublic, visibility) {
+      const ref = artifactKeyOf(key2);
+      if (!ref) throw new CloudRefused(404, "artifact not found");
+      return publishRefs(ref, refs3, makePublic, visibility);
+    },
+    publishReferrersNow(key2, publishKeys, makePublic) {
+      const ref = artifactKeyOf(key2);
+      if (!ref) throw new CloudRefused(404, "artifact not found");
+      return publishReferrers(ref, publishKeys, makePublic);
+    },
     autoPublishEnabled: () => autoPublishState().enabled,
     token: () => readCredentials(credentialsFile2, origin)?.token ?? null,
     async handle(req, res, match) {
@@ -67063,7 +67445,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 +67538,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 +67618,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 +67650,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 +67663,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 +67672,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 +67704,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 +67750,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 +69112,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;
@@ -69631,8 +70013,8 @@ function rawValue() {
   );
 }
 // @__NO_SIDE_EFFECTS__
-function arrayValue(item2) {
-  undeclared("arrayValue", item2);
+function arrayValue(item3) {
+  undeclared("arrayValue", item3);
   return makeSchema(
     (value) => {
       if (!Array.isArray(value)) {
@@ -69640,12 +70022,12 @@ function arrayValue(item2) {
       }
       const result = new Array(value.length);
       for (let i7 = 0; i7 < value.length; i7++) {
-        result[i7] = item2(value[i7]);
+        result[i7] = item3(value[i7]);
       }
       return result;
     },
     {
-      item: item2,
+      item: item3,
       kind: "array"
     },
     void 0,
@@ -69661,7 +70043,7 @@ function arrayValue(item2) {
         return false;
       }
       for (let i7 = 0; i7 < a5.length; i7++) {
-        if (!isSchemaEqual(item2, a5[i7], b6[i7])) {
+        if (!isSchemaEqual(item3, a5[i7], b6[i7])) {
           return false;
         }
       }
@@ -69697,10 +70079,10 @@ function arrayValue(item2) {
   );
 }
 // @__NO_SIDE_EFFECTS__
-function arraySetValue(item2) {
-  undeclared("arraySetValue", item2);
+function arraySetValue(item3) {
+  undeclared("arraySetValue", item3);
   {
-    if (!(typeof item2.defaultValue === "string")) {
+    if (!(typeof item3.defaultValue === "string")) {
       formatDevErrorMessage(`arraySetValue: the item schema must produce strings`);
     }
   }
@@ -69708,14 +70090,14 @@ function arraySetValue(item2) {
     if (!Array.isArray(value)) {
       return Object.freeze([]);
     }
-    if (Object.isFrozen(value) && $isCanonicalSet(item2, value)) {
+    if (Object.isFrozen(value) && $isCanonicalSet(item3, value)) {
       return value;
     }
     const members = [];
     for (let i7 = 0; i7 < value.length; i7++) {
       const member = value[i7];
-      if (member !== void 0 && $acceptsValue(item2, member)) {
-        members.push(item2(member));
+      if (member !== void 0 && $acceptsValue(item3, member)) {
+        members.push(item3(member));
       }
     }
     members.sort();
@@ -69727,14 +70109,14 @@ function arraySetValue(item2) {
     }
     return Object.freeze(result);
   }, {
-    item: item2,
+    item: item3,
     kind: "set"
   }, void 0, isArraySetEqual, (value) => Array.isArray(value));
 }
-function $isCanonicalSet(item2, value) {
+function $isCanonicalSet(item3, value) {
   for (let i7 = 0; i7 < value.length; i7++) {
     const member = value[i7];
-    if (typeof member !== "string" || i7 > 0 && !(value[i7 - 1] < member) || !$acceptsValue(item2, member) || item2(member) !== member) {
+    if (typeof member !== "string" || i7 > 0 && !(value[i7 - 1] < member) || !$acceptsValue(item3, member) || item3(member) !== member) {
       return false;
     }
   }
@@ -72947,8 +73329,8 @@ function mergingChildNotInline(klass, children2) {
     if (entry === "inline") {
       continue;
     }
-    const item2 = declaredChildren(entry);
-    const ok = item2 === "inline" || Array.isArray(item2) && item2.includes("inline") && item2.every((e5) => e5 === "inline" || e5 === klass || klass.prototype instanceof e5);
+    const item3 = declaredChildren(entry);
+    const ok = item3 === "inline" || Array.isArray(item3) && item3.includes("inline") && item3.every((e5) => e5 === "inline" || e5 === klass || klass.prototype instanceof e5);
     if (!ok) {
       return entry;
     }
@@ -74016,9 +74398,9 @@ function validateNodeStructure(klass) {
         formatDevErrorMessage(`${name}: mergeAdjacent.by names the derived NodeState ${invalid.entry}`);
       }
     }
-    const item2 = mergingChildNotInline(klass, declared.children);
-    if (!(item2 === null)) {
-      formatDevErrorMessage(`${name}: a merging class that lists child classes must list classes that hold inline content (${item2 === null ? "" : item2.name} does not)`);
+    const item3 = mergingChildNotInline(klass, declared.children);
+    if (!(item3 === null)) {
+      formatDevErrorMessage(`${name}: a merging class that lists child classes must list classes that hold inline content (${item3 === null ? "" : item3.name} does not)`);
     }
   }
   if (declared.inline !== void 0 && declared.declaredBy.inline === klass) {
@@ -78102,9 +78484,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 +90780,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 +91252,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 +91497,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 +91644,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);
@@ -104911,8 +105293,8 @@ function registerRovingTabIndex(container, options2 = {}) {
   const selector = options2.itemSelector ?? DEFAULT_ROVING_SELECTOR;
   const getItems = () => Array.from(container.querySelectorAll(selector));
   const applyTabIndex = (items, activeIndex) => {
-    items.forEach((item2, i7) => {
-      item2.tabIndex = i7 === activeIndex ? 0 : -1;
+    items.forEach((item3, i7) => {
+      item3.tabIndex = i7 === activeIndex ? 0 : -1;
     });
   };
   const init = () => {
@@ -104984,8 +105366,8 @@ function registerRovingTabIndex(container, options2 = {}) {
   };
   return mergeRegister2(registerEventListener2(container, "keydown", handler5), () => {
     const items = getItems();
-    items.forEach((item2) => {
-      item2.tabIndex = 0;
+    items.forEach((item3) => {
+      item3.tabIndex = 0;
     });
   });
 }
@@ -105000,8 +105382,8 @@ function registerFocusManager(editor, toolbar, options2 = {}) {
     if (isHTMLElement2(target)) {
       const items = toolbar.querySelectorAll(selector);
       let isRovingItem = false;
-      for (const item2 of items) {
-        if (item2 === target || containsComposed(item2, target)) {
+      for (const item3 of items) {
+        if (item3 === target || containsComposed(item3, target)) {
           isRovingItem = true;
           break;
         }
@@ -120238,10 +120620,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);
@@ -126675,8 +127057,8 @@ function $pointsAround(parent, items) {
       if (offset <= first) {
         point2.set(parentKey, offset, "element");
       } else if (offset < first + items.length) {
-        const item2 = items[offset - first - 1];
-        point2.set(item2.getKey(), item2.getChildrenSize(), "element");
+        const item3 = items[offset - first - 1];
+        point2.set(item3.getKey(), item3.getChildrenSize(), "element");
       } else {
         point2.set(parentKey, offset - items.length + 1, "element");
       }
@@ -127886,20 +128268,20 @@ function $buildWordListTree(ctx, items) {
     level: items[0].level,
     list: root
   }];
-  for (const item2 of items) {
-    while (stack2.length > 1 && stack2[stack2.length - 1].level > item2.level) {
+  for (const item3 of items) {
+    while (stack2.length > 1 && stack2[stack2.length - 1].level > item3.level) {
       stack2.pop();
     }
-    if (item2.level > stack2[stack2.length - 1].level) {
-      const sub2 = $createListNode(classifyWordListType(item2.marker));
+    if (item3.level > stack2[stack2.length - 1].level) {
+      const sub2 = $createListNode(classifyWordListType(item3.marker));
       stack2[stack2.length - 1].list.append($createListItemNode().append(sub2));
       stack2.push({
-        level: item2.level,
+        level: item3.level,
         list: sub2
       });
     }
-    stripWordMarker(item2.el);
-    stack2[stack2.length - 1].list.append($createListItemNode().splice(0, 0, ctx.$importChildren(item2.el, {
+    stripWordMarker(item3.el);
+    stack2[stack2.length - 1].list.append($createListItemNode().splice(0, 0, ctx.$importChildren(item3.el, {
       schema: InlineSchema2
     })));
   }
@@ -132457,7 +132839,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 +132858,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 +132879,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 +133043,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 +153377,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 +153423,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 +153952,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 +153960,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 +157611,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 +158755,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 +159970,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 +160140,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 +160184,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 +160684,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,
@@ -162251,13 +162633,13 @@ defineFunction({
         }
         data.push(current);
         for (var _i6 = 0; _i6 < data.length; _i6++) {
-          var item2 = data[_i6];
-          var firstEquals = item2.indexOf("=");
+          var item3 = data[_i6];
+          var firstEquals = item3.indexOf("=");
           if (firstEquals < 0) {
-            throw new ParseError("\\htmlData key/value '" + item2 + "' missing equals sign");
+            throw new ParseError("\\htmlData key/value '" + item3 + "' missing equals sign");
           }
-          var key2 = item2.slice(0, firstEquals);
-          var _value = item2.slice(firstEquals + 1);
+          var key2 = item3.slice(0, firstEquals);
+          var _value = item3.slice(firstEquals + 1);
           attributes["data-" + key2.trim()] = _value;
         }
         trustContext = {
@@ -166827,7 +167209,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 +167225,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 +168531,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);
@@ -175247,9 +175629,9 @@ LoroDoc.prototype.toJsonWithReplacer = function(replacer) {
   };
   const run3 = (layer2) => {
     if (Array.isArray(layer2)) {
-      return layer2.map((item2, index) => {
-        return m11(index, item2);
-      }).filter((item2) => item2 !== void 0);
+      return layer2.map((item3, index) => {
+        return m11(index, item3);
+      }).filter((item3) => item3 !== void 0);
     }
     const result = {};
     for (const [key2, value] of Object.entries(layer2)) {
@@ -175773,16 +176155,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 }
       };
     }
@@ -176219,15 +176601,15 @@ __export(LexicalMarkdown_dev_exports, {
 });
 function indexBy(list2, callback) {
   const index = {};
-  for (const item2 of list2) {
-    const key2 = callback(item2);
+  for (const item3 of list2) {
+    const key2 = callback(item3);
     if (!key2) {
       continue;
     }
     if (index[key2]) {
-      index[key2].push(item2);
+      index[key2].push(item3);
     } else {
-      index[key2] = [item2];
+      index[key2] = [item3];
     }
   }
   return index;
@@ -180666,7 +181048,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 +181082,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 +181307,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 whiteboard="${slug}"> points at ${ref.to}, but ${slug} is now ${id3}; delete to= to point the reference at it`
+      `${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}`
+    ];
+  return [];
+}
+function whiteboardWarnings(ref, at7, lookup2) {
+  const slug = ref.whiteboard;
   const index = lookup2.framesOf(slug);
   if (!index) return [];
   if (ref.page) {
@@ -181011,10 +181399,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 +181414,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 +181422,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 +181455,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 +181536,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 +181617,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 +181631,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 +181648,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 +181673,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 +181701,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 +181715,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 +181852,24 @@ 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-referrers" && ctx.cloud) {
+    const list2 = (value) => Array.isArray(value) ? value.filter((each) => typeof each === "string") : [];
+    return ctx.cloud.publishReferrersNow(key2, list2(request.publish), list2(request.makePublic));
+  }
+  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 +181929,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;
@@ -181566,9 +181976,9 @@ function readChange(value) {
 function readAll(values, read3) {
   const out = [];
   for (const value of values) {
-    const item2 = read3(value);
-    if (!item2) return null;
-    out.push(item2);
+    const item3 = read3(value);
+    if (!item3) return null;
+    out.push(item3);
   }
   return out;
 }
@@ -181580,16 +181990,16 @@ function readSelectionMessage(value) {
     return null;
   if (!list(value.selected, SELECTION_FULL_NODES) || !list(value.tweaks, SELECTION_MAX_NODES) || !list(value.nodes, SELECTION_MAX_NODES))
     return null;
-  const selected = readAll(value.selected, (item2) => {
-    const node = readNode(item2);
-    if (!node || !object(item2) || !text2(item2.text, SELECTION_LIMITS.text) || !text2(item2.html, SELECTION_LIMITS.html) || !list(item2.tweaks, INSPECTOR_PROPERTIES.length))
+  const selected = readAll(value.selected, (item3) => {
+    const node = readNode(item3);
+    if (!node || !object(item3) || !text2(item3.text, SELECTION_LIMITS.text) || !text2(item3.html, SELECTION_LIMITS.html) || !list(item3.tweaks, INSPECTOR_PROPERTIES.length))
       return null;
-    const tweaks2 = readAll(item2.tweaks, readChange);
-    return tweaks2 && { ...node, text: item2.text, html: item2.html, tweaks: tweaks2 };
+    const tweaks2 = readAll(item3.tweaks, readChange);
+    return tweaks2 && { ...node, text: item3.text, html: item3.html, tweaks: tweaks2 };
   });
-  const tweaks = readAll(value.tweaks, (item2) => {
-    const node = readNode(item2);
-    const change = readChange(item2);
+  const tweaks = readAll(value.tweaks, (item3) => {
+    const node = readNode(item3);
+    const change = readChange(item3);
     return node && change && { ...node, ...change };
   });
   const nodes = readAll(value.nodes, readNode);
@@ -181625,17 +182035,17 @@ function readWhiteboardSelectionMessage(value) {
     return null;
   const id3 = value.artifact.slice("whiteboard/".length);
   if (!value.artifact.startsWith("whiteboard/") || !isArtifactId(id3)) return null;
-  const optional3 = (item2, max) => typeof item2 === "string" ? item2.slice(0, max) : null;
+  const optional3 = (item3, max) => typeof item3 === "string" ? item3.slice(0, max) : null;
   const selected = [];
-  for (const item2 of value.selected) {
-    if (!object(item2) || !text2(item2.id, WHITEBOARD_SELECTION_LIMITS.id) || !item2.id || !text2(item2.type, WHITEBOARD_SELECTION_LIMITS.type))
+  for (const item3 of value.selected) {
+    if (!object(item3) || !text2(item3.id, WHITEBOARD_SELECTION_LIMITS.id) || !item3.id || !text2(item3.type, WHITEBOARD_SELECTION_LIMITS.type))
       return null;
     selected.push({
-      id: item2.id,
-      type: item2.type,
-      text: optional3(item2.text, WHITEBOARD_SELECTION_LIMITS.text),
-      frameId: optional3(item2.frameId, WHITEBOARD_SELECTION_LIMITS.id),
-      author: item2.author === "human" || item2.author === "agent" ? item2.author : null
+      id: item3.id,
+      type: item3.type,
+      text: optional3(item3.text, WHITEBOARD_SELECTION_LIMITS.text),
+      frameId: optional3(item3.frameId, WHITEBOARD_SELECTION_LIMITS.id),
+      author: item3.author === "human" || item3.author === "agent" ? item3.author : null
     });
   }
   const page = isPageId(value.page) ? { page: value.page } : {};
@@ -181665,7 +182075,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 +182083,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 +182125,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 +182137,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 +182163,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 +182235,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 +182273,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 +182286,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 +182300,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 +182309,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 +182317,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 +182344,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 +182379,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 +182445,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 +182474,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 +182488,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 +182539,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 +182585,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 +182614,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 +182646,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 +182769,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 +182894,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 +182990,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 +183121,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 +183136,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 +183146,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 +183156,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 +183190,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 +183219,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 +183285,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 +183354,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 +183391,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 +183420,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 +183461,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 +183534,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 +183593,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 +183649,10 @@ 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}`),
+    referrers: (ref) => referrersOf(root, `${ref.type}/${ref.id}`),
     port: () => ctx.port,
     inspect,
     onPublication: (key2, publication) => {
@@ -183260,7 +183660,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 +183706,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 +183720,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 +183816,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 +183990,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 +184043,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 +184079,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 +184126,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";
@@ -183746,7 +184145,7 @@ function summarize(scene, opts = {}) {
     if (element.type === "text" && element.containerId && typeof element.text === "string")
       labels.set(element.containerId, element.text);
   const frameOf = new Map(live3.map((element) => [element.id, element.frameId ?? null]));
-  const item2 = (element) => ({
+  const item3 = (element) => ({
     id: element.id,
     type: element.type,
     text: labels.get(element.id) ?? (typeof element.text === "string" ? element.text : null),
@@ -183760,9 +184159,9 @@ function summarize(scene, opts = {}) {
   const frames = live3.filter((element) => element.type === "frame" && (!opts.frame || element.id === opts.frame)).map((frame) => ({
     id: frame.id,
     name: typeof frame.name === "string" ? frame.name : frame.id,
-    items: shapes.filter((element) => element.frameId === frame.id).map(item2)
+    items: shapes.filter((element) => element.frameId === frame.id).map(item3)
   }));
-  const loose = opts.frame ? [] : shapes.filter((element) => !element.frameId).map(item2);
+  const loose = opts.frame ? [] : shapes.filter((element) => !element.frameId).map(item3);
   const inFrame = (id3) => id3 !== null && frameOf.get(id3) === opts.frame;
   const arrows = live3.filter((element) => LINE_TYPES3.has(element.type)).map((arrow) => ({
     arrow,
@@ -183781,7 +184180,7 @@ function summarize(scene, opts = {}) {
 }
 var oneLine2 = (text5) => text5.replaceAll(/\s*\n\s*/g, " / ");
 var credit = ({ author, editedBy }) => author ? ` \xB7 ${author}${editedBy ? `, ${editedBy} edited` : ""}` : "";
-var itemLine = (item2) => `  ${item2.id} ${item2.sticky ? "sticky" : item2.type}${item2.text ? ` "${oneLine2(item2.text)}"` : ""}${credit(item2)}`;
+var itemLine = (item3) => `  ${item3.id} ${item3.sticky ? "sticky" : item3.type}${item3.text ? ` "${oneLine2(item3.text)}"` : ""}${credit(item3)}`;
 function formatSummary(summary) {
   const lines = [];
   for (const frame of summary.frames) {
@@ -183859,7 +184258,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 +184443,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 +184456,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 +184623,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,9 +184637,9 @@ 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] : []
+      (item3) => typeof item3.id === "string" ? [item3.id] : []
     );
   } catch {
     return [];
@@ -184289,12 +184688,12 @@ var agentEventRoute = {
 
 // src/server/review-defaults.ts
 function actionable(section, rounds) {
-  if (section === "asks") return (item2) => item2.state === "submitted";
-  if (section === "rounds") return (item2) => item2.state === "open" || item2.state === "submitted";
+  if (section === "asks") return (item3) => item3.state === "submitted";
+  if (section === "rounds") return (item3) => item3.state === "open" || item3.state === "submitted";
   const submitted = new Set(
     rounds.filter((round) => round.state === "submitted").map((round) => round.id)
   );
-  return (item2) => item2.kind === "verify" ? item2.verdict === "reject" : submitted.has(item2.round);
+  return (item3) => item3.kind === "verify" ? item3.verdict === "reject" : submitted.has(item3.round);
 }
 
 // src/server/routes/agent-review.ts
@@ -184427,7 +184826,7 @@ async function serve(req, res, ctx, type, id3, operation) {
     if (body.op === "read" && !input.thread)
       throw new ReviewError("E_ARGUMENT_INVALID", "A thread ID is required.");
     if (body.sections !== void 0) {
-      if (body.op !== "list" || !Array.isArray(body.sections) || !body.sections.every((item2) => typeof item2 === "string"))
+      if (body.op !== "list" || !Array.isArray(body.sections) || !body.sections.every((item3) => typeof item3 === "string"))
         throw new ReviewError(
           "E_ARGUMENT_INVALID",
           "sections requires a list of collection names and op=list."
@@ -184548,8 +184947,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));
@@ -184675,9 +185074,9 @@ function documentDrawing(title, payload) {
       });
       y5 += rows.length * 22 + 10;
     } else if (type === "list") {
-      children(block.children).slice(0, 4).forEach((item2, i7) => {
+      children(block.children).slice(0, 4).forEach((item3, i7) => {
         parts.push(text4(104, y5, block.listType === "number" ? `${i7 + 1}.` : "\u2022"));
-        lines(nodeText(item2), 9, 2, 13);
+        lines(nodeText(item3), 9, 2, 13);
       });
       y5 += 8;
     } else if (type === "alert-quote") {
@@ -185085,8 +185484,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 +185614,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 +185967,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 +185976,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 +185987,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 +186006,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 +186090,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 +186166,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 +186178,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 +186186,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 +186285,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 +186343,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 +186358,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 +186405,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 +186427,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 +186440,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 +186491,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 +186554,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 +186564,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 +186575,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 +186723,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 +186732,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 +186747,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 +186774,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 +186789,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 +186813,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 +186825,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 +186839,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 +186883,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 +186933,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,