@omniharmonic/openspace-cli 0.1.1 → 0.1.2

package/dist/bin.js

@@ -3,7 +3,7 @@ import { createRequire as __osCreateRequire } from "node:module"; const require
 import {
   processIo,
   run
-} from "./chunk-LTJEM3DN.js";
+} from "./chunk-R3SYHQ5J.js";
 import "./chunk-3F6TAUAT.js";
 
 // src/bin.ts

package/dist/{chunk-LTJEM3DN.js → chunk-R3SYHQ5J.js}

@@ -7435,6 +7435,223 @@ var CliError = class extends Error {
 import { readdir as readdir2, readFile as readFile2, stat } from "fs/promises";
 import { join as join2 } from "path";
 
+// ../schema/src/links.ts
+var COLLECTION_SUBPATHS = /* @__PURE__ */ new Set(["page", "category", "categories", "tag", "tags"]);
+var MARKDOWN_LINK_RE = /\]\((\/[^)\s]*)\)|href="(\/[^"\s]*)"/g;
+var trimSlashes = (s) => s.replace(/^\/+|\/+$/g, "");
+var LinkTargets = class {
+  constructor(doc) {
+    this.doc = doc;
+    this.slugs = new Set(Object.values(doc.pages).map((p) => p.slug));
+    this.redirectFroms = new Set((doc.site.redirects ?? []).map((r) => trimSlashes(r.from)));
+  }
+  doc;
+  slugs;
+  redirectFroms;
+  hasCollection(name) {
+    return name in this.doc.collections || name in (this.doc.collectionConfigs ?? {});
+  }
+  /** Does a site-internal path (`/about/`, `/journal/hello`) lead somewhere? */
+  pathResolves(raw) {
+    const path = raw.split(/[?#]/)[0] ?? "";
+    const slug = trimSlashes(path);
+    const last = slug.split("/").pop() ?? "";
+    if (/\.[A-Za-z0-9]+$/.test(last)) return true;
+    if (slug === "404" || slug.startsWith("_os/")) return true;
+    if (this.slugs.has(slug) || this.redirectFroms.has(slug)) return true;
+    const [head, second, ...rest] = slug.split("/");
+    if (head && this.hasCollection(head)) {
+      if (second === void 0) return true;
+      if (this.doc.collections[head]?.[second]) return rest.length === 0;
+      return COLLECTION_SUBPATHS.has(second);
+    }
+    return false;
+  }
+};
+var isInternalPath = (s) => /^\/(?!\/)/.test(s);
+var isObject = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+function findBrokenLinks(doc) {
+  const targets = new LinkTargets(doc);
+  const out = [];
+  const walk5 = (value, scope, path, where) => {
+    const add = (kind, target, message, severity = "error") => out.push({ scope, path, ...where, kind, target, severity, message });
+    if (typeof value === "string") {
+      if (path[path.length - 1] === "body")
+        for (const m of value.matchAll(MARKDOWN_LINK_RE)) {
+          const target = m[1] ?? m[2];
+          if (target && !targets.pathResolves(target))
+            add("markdown", target, `Link to ${target} does not lead to any page`);
+        }
+      return;
+    }
+    if (Array.isArray(value)) {
+      for (const [i, v] of value.entries()) walk5(v, scope, [...path, i], where);
+      return;
+    }
+    if (!isObject(value)) return;
+    const o = value;
+    if (o.type === "page" && typeof o.page === "string") {
+      if (!(o.page in doc.pages))
+        add("page", o.page, `Link to page ${o.page} but no such page exists`);
+    } else if (o.type === "item" && typeof o.collection === "string" && typeof o.slug === "string") {
+      if (!doc.collections[o.collection]?.[o.slug])
+        add(
+          "item",
+          `${o.collection}/${o.slug}`,
+          `Link to ${o.collection}/${o.slug} but no such item exists`
+        );
+    } else if (o.type === "collection" && typeof o.collection === "string") {
+      if (!targets.hasCollection(o.collection))
+        add(
+          "collection",
+          o.collection,
+          `Navigation points at collection "${o.collection}" which does not exist`
+        );
+    } else if (o.type === "url" && typeof o.url === "string" && isInternalPath(o.url)) {
+      if (!targets.pathResolves(o.url))
+        add("url", o.url, `Link to ${o.url} does not lead to any page`);
+    } else if (o.type === "link" && isObject(o.attrs) && typeof o.attrs.href === "string") {
+      const href = o.attrs.href;
+      if (isInternalPath(href) && !targets.pathResolves(href))
+        add("richtext", href, `Text link to ${href} does not lead to any page`, "warning");
+    }
+    for (const [k, v] of Object.entries(o)) walk5(v, scope, [...path, k], where);
+  };
+  const walkSection = (section, scope, base, container2) => {
+    for (const [k, v] of Object.entries(section))
+      if (k !== "blocks") walk5(v, scope, [...base, k], { container: container2, section: section.id });
+    section.blocks.forEach((b, j) => {
+      const at = { container: container2, section: section.id, block: b.id };
+      for (const [k, v] of Object.entries(b)) {
+        if (k !== "fields") walk5(v, scope, [...base, "blocks", j, k], at);
+        else if (isObject(v))
+          for (const [field, fv] of Object.entries(v))
+            walk5(fv, scope, [...base, "blocks", j, "fields", field], { ...at, field });
+      }
+    });
+  };
+  const site2 = { kind: "site" };
+  for (const [k, v] of Object.entries(doc.site))
+    if (k === "footer") walkSection(doc.site.footer, site2, ["footer"], "footer");
+    else walk5(v, site2, [k], {});
+  for (const page of Object.values(doc.pages)) {
+    const scope = { kind: "page", page: page.id };
+    for (const [k, v] of Object.entries(page)) if (k !== "sections") walk5(v, scope, [k], {});
+    for (const [i, s] of page.sections.entries()) walkSection(s, scope, ["sections", i], page.id);
+  }
+  for (const [collection, items] of Object.entries(doc.collections))
+    for (const item of Object.values(items))
+      walk5(item, { kind: "item", collection, slug: item.slug }, [], {});
+  return out;
+}
+var CONTACT_WORDS = [
+  "contact",
+  "book",
+  "booking",
+  "bookings",
+  "reserve",
+  "reservations",
+  "enquire",
+  "enquiry",
+  "enquiries",
+  "inquire",
+  "inquiry",
+  "get-in-touch",
+  "hello",
+  "appointments",
+  "visit"
+];
+var words = (s) => s.toLowerCase().split(/[^a-z0-9]+/).filter((w) => w.length > 2);
+var related = (a, b) => {
+  if (a === b) return true;
+  const [s, l] = a.length < b.length ? [a, b] : [b, a];
+  return s.length >= 4 && l.startsWith(s) && l.length - s.length <= 3;
+};
+var publicPages = (doc) => Object.values(doc.pages).filter(
+  (p) => !p.access?.password && !p.access?.members && p.slug !== "404"
+);
+var pagePath = (p) => p.slug ? `/${p.slug}` : "/";
+function suggestLinkTarget(doc, target) {
+  const wanted = words(trimSlashes(target.split(/[?#]/)[0] ?? ""));
+  const pages = publicPages(doc);
+  const matches = (p, list3) => {
+    const own = [...words(p.slug), ...words(p.title)];
+    return own.some((w) => list3.some((x) => related(w, x)));
+  };
+  const bySlugWord = pages.find((p) => p.slug && wanted.some((w) => words(p.slug).includes(w)));
+  if (bySlugWord) return { page: bySlugWord, path: pagePath(bySlugWord) };
+  const byWord = pages.find((p) => p.slug && matches(p, wanted));
+  if (byWord) return { page: byWord, path: pagePath(byWord) };
+  const collection = Object.keys(doc.collections).find(
+    (c) => wanted.some((w) => related(w, c.toLowerCase()))
+  );
+  if (collection) return { path: `/${collection}/` };
+  const contact = CONTACT_WORDS.map(
+    (w) => pages.find((p) => p.slug && (words(p.slug).includes(w) || words(p.title).includes(w)))
+  ).find(Boolean);
+  if (contact) return { page: contact, path: pagePath(contact) };
+  const home = pages.find((p) => p.slug === "") ?? pages[0];
+  return home ? { page: home, path: pagePath(home) } : void 0;
+}
+function suggestionLink(s, newTab) {
+  if (s.page) return { type: "page", page: s.page.id };
+  return { type: "url", url: s.path, ...newTab ? { newTab } : {} };
+}
+function resolveInternalLinks(value, doc) {
+  const targets = new LinkTargets(doc);
+  const changes = [];
+  const cache = /* @__PURE__ */ new Map();
+  const suggest = (target) => {
+    if (!cache.has(target)) cache.set(target, suggestLinkTarget(doc, target));
+    return cache.get(target);
+  };
+  const fix = (v, path) => {
+    if (typeof v === "string") {
+      if (path[path.length - 1] !== "body") return v;
+      return v.replace(MARKDOWN_LINK_RE, (m, md, html) => {
+        const target = md ?? html;
+        if (!target || targets.pathResolves(target)) return m;
+        const s = suggest(target);
+        if (!s) return m;
+        changes.push({ path, from: target, to: s.path });
+        return md ? `](${s.path})` : `href="${s.path}"`;
+      });
+    }
+    if (Array.isArray(v)) return v.map((x, i) => fix(x, [...path, i]));
+    if (!isObject(v)) return v;
+    if (v.type === "url" && typeof v.url === "string" && isInternalPath(v.url)) {
+      if (targets.pathResolves(v.url)) return v;
+      const s = suggest(v.url);
+      if (!s) return v;
+      changes.push({ path, from: v.url, to: s.path });
+      return suggestionLink(s, v.newTab === true ? true : void 0);
+    }
+    if (v.type === "page" && typeof v.page === "string" && !(v.page in doc.pages)) {
+      const home = suggest("/");
+      if (!home?.page) return v;
+      changes.push({ path, from: v.page, to: home.path });
+      return { ...v, page: home.page.id };
+    }
+    if (v.type === "link" && isObject(v.attrs) && typeof v.attrs.href === "string") {
+      const href = v.attrs.href;
+      if (!isInternalPath(href) || targets.pathResolves(href)) return v;
+      const s = suggest(href);
+      if (!s) return v;
+      changes.push({ path, from: href, to: s.path });
+      return { ...v, attrs: { ...v.attrs, href: s.path } };
+    }
+    const out = {};
+    for (const [k, x] of Object.entries(v)) out[k] = fix(x, [...path, k]);
+    return out;
+  };
+  return { value: fix(value, []), changes };
+}
+function withPages(doc, pages) {
+  const all = { ...doc.pages };
+  for (const p of pages) all[p.id] = p;
+  return { ...doc, pages: all };
+}
+
 // ../schema/src/secrets.ts
 function shannonEntropy(value) {
   if (!value) return 0;
@@ -8151,39 +8368,6 @@ function fileDepth2(path) {
 }
 var IMAGE_EXT_RE = /\.(?:jpe?g|png|gif|webp|avif|svg)$/i;
 var MEDIA_REF_RE = /(?<![\w/.:-])media\/[A-Za-z0-9_\-./]+\.[A-Za-z0-9]+/g;
-var MD_LINK_RE = /\]\((\/[^)\s]*)\)|href="(\/[^"\s]*)"/g;
-var COLLECTION_SUBPATHS = /* @__PURE__ */ new Set(["page", "category", "categories", "tag", "tags"]);
-var Resolver = class {
-  constructor(doc) {
-    this.doc = doc;
-    this.slugs = new Set(Object.values(doc.pages).map((p) => p.slug));
-    this.redirectFroms = new Set(
-      (doc.site.redirects ?? []).map((r) => r.from.replace(/^\/+|\/+$/g, ""))
-    );
-  }
-  doc;
-  slugs;
-  redirectFroms;
-  hasCollection(name) {
-    return name in this.doc.collections || name in (this.doc.collectionConfigs ?? {});
-  }
-  /** Does a site-internal path (`/about/`, `/journal/hello`) lead somewhere? */
-  pathResolves(raw) {
-    const path = raw.split(/[?#]/)[0] ?? "";
-    const slug = path.replace(/^\/+|\/+$/g, "");
-    const last = slug.split("/").pop() ?? "";
-    if (/\.[A-Za-z0-9]+$/.test(last)) return true;
-    if (slug === "404" || slug.startsWith("_os/")) return true;
-    if (this.slugs.has(slug) || this.redirectFroms.has(slug)) return true;
-    const [head, second, ...rest] = slug.split("/");
-    if (head && this.hasCollection(head)) {
-      if (second === void 0) return true;
-      if (this.doc.collections[head]?.[second]) return rest.length === 0;
-      return COLLECTION_SUBPATHS.has(second);
-    }
-    return false;
-  }
-};
 async function runCheck(root, options = {}) {
   const budgets = { ...DEFAULT_BUDGETS, ...options.budgets };
   const findings = [];
@@ -8321,7 +8505,7 @@ async function runCheck(root, options = {}) {
   return { ok: errors2 === 0, errors: errors2, warnings, findings, stats: stats2 };
 }
 function checkReferences(doc, pageFiles2, mediaOnDisk, budgets, add) {
-  const resolver = new Resolver(doc);
+  const resolver = new LinkTargets(doc);
   const reportedImages = /* @__PURE__ */ new Set();
   const checkImage = (ref, file, path) => {
     if (!isMediaPath(ref)) return;
@@ -8349,67 +8533,23 @@ function checkReferences(doc, pageFiles2, mediaOnDisk, budgets, add) {
     if (typeof value === "string") {
       const here = dotPath(path);
       for (const m of value.matchAll(MEDIA_REF_RE)) checkImage(m[0], file, here);
-      if (path[path.length - 1] === "body") {
-        for (const m of value.matchAll(MD_LINK_RE)) {
-          const target = m[1] ?? m[2];
-          if (target && !resolver.pathResolves(target))
-            add({
-              severity: "error",
-              rule: "link",
-              file,
-              path: here,
-              message: `Link to ${target} does not lead to any page`
-            });
-        }
-      }
       return;
     }
     if (Array.isArray(value)) {
       for (const [i, v] of value.entries()) walk5(v, file, [...path, i]);
       return;
     }
-    if (value && typeof value === "object") {
-      const o = value;
-      const here = dotPath(path);
-      if (o.type === "page" && typeof o.page === "string" && !(o.page in doc.pages))
-        add({
-          severity: "error",
-          rule: "link",
-          file,
-          path: here || void 0,
-          message: `Link to page ${o.page} but no such page exists`
-        });
-      else if (o.type === "item" && typeof o.collection === "string" && typeof o.slug === "string") {
-        if (!doc.collections[o.collection]?.[o.slug])
-          add({
-            severity: "error",
-            rule: "link",
-            file,
-            path: here || void 0,
-            message: `Link to ${o.collection}/${o.slug} but no such item exists`
-          });
-      } else if (o.type === "collection" && typeof o.collection === "string") {
-        if (!resolver.hasCollection(o.collection))
-          add({
-            severity: "error",
-            rule: "link",
-            file,
-            path: here || void 0,
-            message: `Navigation points at collection "${o.collection}" which does not exist`
-          });
-      } else if (o.type === "url" && typeof o.url === "string" && o.url.startsWith("/")) {
-        if (!resolver.pathResolves(o.url))
-          add({
-            severity: "error",
-            rule: "link",
-            file,
-            path: here || void 0,
-            message: `Link to ${o.url} does not lead to any page`
-          });
-      }
-      for (const [k, v] of Object.entries(o)) walk5(v, file, [...path, k]);
-    }
+    if (value && typeof value === "object")
+      for (const [k, v] of Object.entries(value)) walk5(v, file, [...path, k]);
   };
+  for (const l of findBrokenLinks(doc))
+    add({
+      severity: l.severity,
+      rule: "link",
+      file: l.scope.kind === "site" ? SITE_FILE : l.scope.kind === "page" ? pageFiles2[l.scope.page] ?? PAGES_DIR : `${COLLECTIONS_DIR}/${l.scope.collection}/${l.scope.slug}${ITEM_EXT}`,
+      path: dotPath(l.path) || void 0,
+      message: l.message
+    });
   walk5(doc.site, SITE_FILE, []);
   for (const page of Object.values(doc.pages)) walk5(page, pageFiles2[page.id] ?? PAGES_DIR, []);
   for (const [name, items] of Object.entries(doc.collections))
@@ -12472,6 +12612,104 @@ function sortIssues(issues) {
   return issues.map((i, n) => [i, n]).sort(([a, na], [b, nb]) => rank[a.severity] - rank[b.severity] || na - nb).map(([i]) => i);
 }
 
+// ../lint/src/links.ts
+var titleOf = (p) => p.title || (p.slug === "" ? "Home" : p.slug);
+function linkPlace(doc, link) {
+  const s = link.scope;
+  if (link.block) {
+    const container2 = link.container === "footer" ? doc.site.footer : doc.pages[link.container]?.sections.find((x) => x.id === link.section);
+    const block = container2?.blocks.find((b) => b.id === link.block);
+    const label = block && blocksRegistry().get(block.type)?.meta.label || "block";
+    const what = `A ${label.toLowerCase()}`;
+    if (link.container === "footer") return `${what} in the footer`;
+    const page = doc.pages[link.container];
+    return page ? `${what} on ${titleOf(page)}` : what;
+  }
+  if (s.kind === "site") {
+    const head = link.path[0];
+    if (head === "nav") return "Your menu";
+    if (head === "header") return "The header";
+    if (head === "announcement") return "The announcement bar";
+    if (head === "popup") return "The pop-up";
+    return "Your site settings";
+  }
+  if (s.kind === "page") {
+    const page = doc.pages[s.page];
+    return page ? `The page ${titleOf(page)}` : "A page";
+  }
+  const item = doc.collections[s.collection]?.[s.slug];
+  const title = item?.frontmatter?.title ?? s.slug;
+  return `\u201C${title}\u201D in ${s.collection}`;
+}
+function describeBrokenLink(doc, link) {
+  const where = linkPlace(doc, link);
+  switch (link.kind) {
+    case "page":
+      return `${where} links to a page that no longer exists.`;
+    case "item":
+      return `${where} links to ${link.target}, which isn't on your site any more.`;
+    case "collection":
+      return `${where} points at the \u201C${link.target}\u201D collection, which doesn't exist.`;
+    default:
+      return `${where} links to ${link.target}, which isn't a page on your site.`;
+  }
+}
+function linkFix(doc, link, meta) {
+  const target = link.kind === "page" ? "/" : link.target;
+  const s = suggestLinkTarget(doc, target);
+  if (!s) return void 0;
+  const label = `Link to ${s.page ? titleOf(s.page) : s.path} instead`;
+  if (link.block && link.field) {
+    const container2 = link.container === "footer" ? doc.site.footer : doc.pages[link.container]?.sections.find((x) => x.id === link.section);
+    const block = container2?.blocks.find((b) => b.id === link.block);
+    if (!block) return void 0;
+    const { value, changes } = resolveInternalLinks(block.fields[link.field], doc);
+    if (!changes.length) return void 0;
+    return {
+      label,
+      ops: [
+        {
+          op: "block.update",
+          ...meta(),
+          page: link.container,
+          block: block.id,
+          set: { [link.field]: value }
+        }
+      ]
+    };
+  }
+  if (link.scope.kind === "site" && link.path[0] === "nav") {
+    const { value, changes } = resolveInternalLinks(doc.site.nav, doc);
+    if (!changes.length) return void 0;
+    return { label, ops: [{ op: "site.update", ...meta(), set: { nav: value } }] };
+  }
+  return void 0;
+}
+function linkIssues(doc, pageId, options = {}, meta = opMeta(options)) {
+  const out = [];
+  for (const link of findBrokenLinks(doc)) {
+    const s = link.scope;
+    if (pageId && s.kind === "page" && s.page !== pageId) continue;
+    if (pageId && s.kind === "item") continue;
+    const page = link.container ?? (s.kind === "page" ? s.page : void 0);
+    const autofix = linkFix(doc, link, meta);
+    out.push(
+      issue({
+        rule: "broken-link",
+        severity: link.severity,
+        ...page ? { page } : {},
+        ...link.section ? { section: link.section } : {},
+        ...link.block ? { block: link.block } : {},
+        key: `${s.kind === "item" ? `${s.collection}/${s.slug}:` : ""}${link.path.join(".")}`,
+        message: describeBrokenLink(doc, link),
+        fix: link.severity === "error" ? "Point the link at a page that exists, or add the missing page. The site can't be published until then." : "Point the link at a page that exists, or add the missing page.",
+        ...autofix ? { autofix } : {}
+      })
+    );
+  }
+  return out;
+}
+
 // ../lint/src/mobile.ts
 var ROW_UNIT = { d: 24, m: 20 };
 var MOBILE_WIDTH = 350;
@@ -12733,6 +12971,7 @@ function designCheck(doc, pageId, options = {}) {
   if (pageId && pages.length === 0) throw new Error(`Page ${pageId} not found`);
   for (const page of pages) ctx.page(page);
   ctx.container(FOOTER, [doc.site.footer], { footer: true });
+  ctx.issues.push(...linkIssues(doc, pageId, options, ctx.meta));
   return sortIssues(ctx.issues);
 }
 var LIGHT = /* @__PURE__ */ new Set(["light", "light-accent"]);
@@ -13530,12 +13769,12 @@ function seoCheck(page, doc, options = {}) {
       } : {}
     });
   }
-  const words = blocks.map(blockText).join(" ").split(/\s+/).filter(Boolean).length;
-  if (!page.seo?.noindex && words < 80) {
+  const words2 = blocks.map(blockText).join(" ").split(/\s+/).filter(Boolean).length;
+  if (!page.seo?.noindex && words2 < 80) {
     add({
       rule: "seo-thin-content",
       severity: "info",
-      message: `The page has about ${words} words of text; search engines have little to go on.`,
+      message: `The page has about ${words2} words of text; search engines have little to go on.`,
       fix: "Add a short paragraph that explains what's on the page in your own words."
     });
   }
@@ -14237,10 +14476,10 @@ var listSectionPresets = defineTool({
     let list3 = presetCatalog.slice();
     if (input.category) list3 = list3.filter((p) => p.category === input.category);
     if (input.query) {
-      const words = input.query.toLowerCase().split(/\s+/).filter(Boolean);
+      const words2 = input.query.toLowerCase().split(/\s+/).filter(Boolean);
       list3 = list3.filter((p) => {
         const hay = `${p.id} ${p.label} ${p.description} ${p.tags.join(" ")} ${p.ai.whenToUse}`.toLowerCase();
-        return words.every((w) => hay.includes(w));
+        return words2.every((w) => hay.includes(w));
       });
     }
     const full = input.detail === "full";
@@ -14882,14 +15121,23 @@ var insertSection = defineTool({
     if (input.preset) {
       const preset = findPreset(input.preset);
       const opts = { colorTheme: input.colorTheme, collection: input.collection, ...links };
+      const linkNote = (changes2) => changes2.length ? {
+        linksChanged: changes2.map((c) => ({ from: c.from, to: c.to })),
+        linkNote: "Example links that lead nowhere on this site were pointed at existing pages; change them with update_block."
+      } : {};
       if (preset.target === "header") {
-        const header = preset.build(opts);
+        const { value: header, changes: changes2 } = resolveInternalLinks(preset.build(opts), doc);
         await ctx.apply(siteId, [{ op: "site.update", set: { header } }]);
         return {
-          data: { applied: preset.id, header, note: "The site header now uses this preset." }
+          data: {
+            applied: preset.id,
+            header,
+            note: "The site header now uses this preset.",
+            ...linkNote(changes2)
+          }
         };
       }
-      const section2 = preset.build(opts);
+      const { value: section2, changes } = resolveInternalLinks(preset.build(opts), doc);
       if (input.label) section2.label = input.label;
       if (preset.target === "footer") {
         await ctx.apply(siteId, [{ op: "site.update", set: { footer: section2 } }]);
@@ -14897,7 +15145,8 @@ var insertSection = defineTool({
           data: {
             replaced: "footer",
             section: sectionSummary(ctx.registry, section2),
-            note: 'Edit footer blocks with page "footer".'
+            note: 'Edit footer blocks with page "footer".',
+            ...linkNote(changes)
           }
         };
       }
@@ -14912,7 +15161,8 @@ var insertSection = defineTool({
           page: page2,
           section: sectionSummary(ctx.registry, section2),
           copyGuidance: preset.copy.map((c) => `${c.label}: ${c.words[0]}\u2013${c.words[1]} words`),
-          next: "Replace the demo copy with the owner's content (update_block), then run design_check."
+          next: "Replace the demo copy with the owner's content (update_block), then run design_check.",
+          ...linkNote(changes)
         }
       };
     }
@@ -15017,7 +15267,10 @@ var insertBlock = defineTool({
     const doc = await ctx.doc(siteId);
     const page = container(doc, input.page);
     requireSection2(doc, page, input.section);
-    const block = makeBlock(ctx.registry, input.block);
+    const made = makeBlock(ctx.registry, input.block);
+    const block = resolveInternalLinks(made, doc).value;
+    for (const k of Object.keys(input.block.fields ?? {}))
+      if (k in made.fields) block.fields[k] = made.fields[k];
     const body = {
       op: "block.insert",
       page,
@@ -15263,7 +15516,6 @@ var createPage = defineTool({
       const colorTheme = input.themes?.[i];
       sections.push(preset.build(colorTheme ? { colorTheme } : {}));
     });
-    for (const raw of input.sections ?? []) sections.push(makeSection(ctx.registry, raw));
     const page = {
       id: newId("pg"),
       title: input.title,
@@ -15271,6 +15523,9 @@ var createPage = defineTool({
       seo: input.description ? { description: input.description } : {},
       sections
     };
+    const linked = resolveInternalLinks(sections, withPages(doc, [page]));
+    page.sections = linked.value;
+    for (const raw of input.sections ?? []) page.sections.push(makeSection(ctx.registry, raw));
     if (input.hidden) page.hidden = true;
     const body = { op: "page.create", page };
     if (input.addToNav !== false && !input.hidden)
@@ -15279,8 +15534,12 @@ var createPage = defineTool({
     return {
       data: {
         page: { id: page.id, title: page.title, slug: page.slug, path: pagePathOf(page) },
-        sections: sections.map((s) => sectionSummary(ctx.registry, s)),
-        inNav: Boolean(body.nav)
+        sections: page.sections.map((s) => sectionSummary(ctx.registry, s)),
+        inNav: Boolean(body.nav),
+        ...linked.changes.length ? {
+          linksChanged: linked.changes.map((c) => ({ from: c.from, to: c.to })),
+          linkNote: "Example links that lead nowhere on this site were pointed at existing pages; change them with update_block."
+        } : {}
       }
     };
   }
@@ -16589,10 +16848,10 @@ Unpublished work saved as ${tag}`,
     });
     return this.preview;
   }
-  async previewUrl(siteId, pagePath = "/") {
+  async previewUrl(siteId, pagePath2 = "/") {
     this.check(siteId);
     const { url } = await this.previewServer();
-    return `${url}${pagePath.startsWith("/") ? pagePath : `/${pagePath}`}`;
+    return `${url}${pagePath2.startsWith("/") ? pagePath2 : `/${pagePath2}`}`;
   }
   async uploadImage(siteId, input, ctx) {
     this.check(siteId);
@@ -17158,4 +17417,4 @@ export {
   createProgram,
   run
 };
-//# sourceMappingURL=chunk-LTJEM3DN.js.map
+//# sourceMappingURL=chunk-R3SYHQ5J.js.map