@shllg/emend 0.1.0 → 0.2.0

package/dist/emend.mjs

@@ -2353,6 +2353,15 @@ var init_migrations_gen = __esm({
           "CREATE INDEX `writeups_owner_source_blob_idx` ON `writeups` (`owner_id`,`source_blob`);",
           "CREATE INDEX `writeups_owner_rendered_blob_idx` ON `writeups` (`owner_id`,`rendered_blob`);"
         ]
+      },
+      {
+        "tag": "0012_curved_epoch",
+        "when": 1793838919412,
+        "hash": "ac89ed1e7d7dc8570347cc62b58843e0db605d3e30c651326aacf30007fd6d09",
+        "statements": [
+          "ALTER TABLE `files` ADD `title` text;",
+          "ALTER TABLE `files` ADD `headings` text;"
+        ]
       }
     ];
   }
@@ -2618,7 +2627,7 @@ var VERSION;
 var init_version2 = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "0.1.0";
+    VERSION = "0.2.0";
   }
 });
 
@@ -23054,6 +23063,9 @@ var init_limits = __esm({
       prefixSuffixChars: 32,
       diffContextLines: 3,
       titleChars: 200,
+      headingsPerDoc: 1024,
+      headingTextChars: 200,
+      headingIdChars: 256,
       diffSideBytes: 1048576,
       markdownDocBytes: 1048576,
       htmlDocBytes: 8388608,
@@ -23278,6 +23290,23 @@ var init_devices = __esm({
   }
 });
 
+// ../../packages/contract/src/doc.ts
+var DocTitle, DocHeading, DocHeadings;
+var init_doc2 = __esm({
+  "../../packages/contract/src/doc.ts"() {
+    "use strict";
+    init_zod();
+    init_limits();
+    DocTitle = external_exports.string().min(1).max(LIMITS.titleChars).refine((title) => /\S/.test(title), "title must not be blank");
+    DocHeading = external_exports.object({
+      level: external_exports.union([external_exports.literal(2), external_exports.literal(3)]),
+      text: external_exports.string().max(LIMITS.headingTextChars),
+      id: external_exports.string().min(1).max(LIMITS.headingIdChars).optional()
+    });
+    DocHeadings = external_exports.array(DocHeading).max(LIMITS.headingsPerDoc);
+  }
+});
+
 // ../../packages/contract/src/errors.ts
 var ERROR_STATUS, ErrorCode, ErrorBody;
 var init_errors4 = __esm({
@@ -23475,6 +23504,7 @@ var init_manifest = __esm({
     "use strict";
     init_zod();
     init_agent_note();
+    init_doc2();
     init_limits();
     init_links();
     init_review();
@@ -23513,7 +23543,11 @@ var init_manifest = __esm({
           role: external_exports.enum(["diff", "doc"]),
           topic: TopicSlug.optional(),
           source: source.optional(),
+          title: DocTitle.optional(),
           notes: AgentNotes.optional()
+        }).refine((file2) => file2.role === "doc" || file2.title === void 0, {
+          path: ["title"],
+          message: "only doc files have titles"
         }).refine((file2) => file2.role === "diff" || file2.notes === void 0, {
           path: ["notes"],
           message: "only diff files have agent notes"
@@ -23585,6 +23619,7 @@ var init_publish = __esm({
     "use strict";
     init_zod();
     init_agent_note();
+    init_doc2();
     init_limits();
     init_links();
     init_manifest();
@@ -23595,6 +23630,7 @@ var init_publish = __esm({
     Sha256 = external_exports.string().length(64).regex(/^[0-9a-f]{64}$/);
     PublishFile = external_exports.object({
       path: FilePath,
+      title: DocTitle.optional(),
       oldPath: FilePath.nullable(),
       role: FileRole,
       status: FileStatus.optional(),
@@ -23605,6 +23641,9 @@ var init_publish = __esm({
       parent: FilePath.optional(),
       assets: external_exports.array(FilePath).max(LIMITS.filesPerRevision).optional(),
       notes: AgentNotes.optional()
+    }).refine((file2) => file2.role === "doc" || file2.title === void 0, {
+      path: ["title"],
+      message: "only doc files have titles"
     }).refine((file2) => file2.role === "diff" || file2.notes === void 0, {
       path: ["notes"],
       message: "only diff files have agent notes"
@@ -23810,6 +23849,7 @@ function importPublishInput(bundle, revisionId, writeup, meta3 = {}) {
     files: files2.map((f) => ({
       ...f,
       status: f.status ?? void 0,
+      title: f.title ?? void 0,
       topic: f.topicSlug ?? void 0,
       notes: index3.notesByFile.get(f.id)?.toSorted((a, b) => a.ord - b.ord),
       parent: f.parentDocId === null ? void 0 : index3.files.get(f.parentDocId)?.path,
@@ -23823,6 +23863,7 @@ var init_import = __esm({
     "use strict";
     init_zod();
     init_agent_note();
+    init_doc2();
     init_import_index();
     init_limits();
     init_publish();
@@ -23872,6 +23913,7 @@ var init_import = __esm({
           oldBlob: Sha256.nullable(),
           newBlob: Sha256.nullable(),
           renderedBlob: Sha256.nullable(),
+          title: DocTitle.nullable().optional(),
           flag: FileFlag.nullable(),
           parentDocId: id.nullable()
         })
@@ -24077,6 +24119,7 @@ var init_views = __esm({
     "use strict";
     init_zod();
     init_agent_note();
+    init_doc2();
     init_limits();
     init_links();
     init_placement();
@@ -24225,12 +24268,20 @@ var init_views = __esm({
           external_exports.object({
             path: FilePath,
             kind: external_exports.literal("markdown"),
+            title: DocTitle.optional(),
+            headings: DocHeadings.optional(),
             blocks: external_exports.array(RenderedBlock).max(LIMITS.blocksPerRevision).refine(
               (blocks) => renderedBytes(blocks) <= LIMITS.renderedBytesPerRevision,
               "doc exceeds the rendered JSON byte budget"
             )
           }),
-          external_exports.object({ path: FilePath, kind: external_exports.literal("html"), contentUrl })
+          external_exports.object({
+            path: FilePath,
+            kind: external_exports.literal("html"),
+            contentUrl,
+            title: DocTitle.optional(),
+            headings: DocHeadings.optional()
+          })
         ])
       ).max(LIMITS.filesPerRevision),
       threads: external_exports.array(ThreadView),
@@ -24241,6 +24292,8 @@ var init_views = __esm({
     ).refine((view) => {
       let bytes = renderedBytes(view.writeup);
       for (const doc of view.docs) {
+        if (doc.title !== void 0 || doc.headings !== void 0)
+          bytes += renderedBytes({ title: doc.title, headings: doc.headings });
         if (doc.kind === "markdown" && doc.blocks.length) bytes += renderedBytes(doc.blocks);
         if (bytes > LIMITS.renderedBytesPerRevision) return false;
       }
@@ -24324,6 +24377,7 @@ var init_src = __esm({
     init_auth();
     init_browser();
     init_devices();
+    init_doc2();
     init_errors4();
     init_events();
     init_import();
@@ -24742,7 +24796,7 @@ var init_http = __esm({
         this.exitCode = exitCode;
       }
     };
-    sandboxHint = "If an agent sandbox runs emend, let emend run outside it: https://github.com/shllg/emend#use-with-sandboxed-agents";
+    sandboxHint = "If an agent sandbox runs emend, let emend run outside it: https://github.com/shllg/emend/blob/release/docs/setup/troubleshooting.md#an-agents-sandbox-blocks-emend";
     CliError = class extends Error {
       sandboxStateDir;
       constructor(message, sandboxStateDir) {
@@ -29181,6 +29235,8 @@ var init_schema = __esm({
         oldBlob: text("old_blob"),
         newBlob: text("new_blob"),
         renderedBlob: text("rendered_blob"),
+        title: text("title"),
+        headings: text("headings", { mode: "json" }).$type(),
         flag: text("flag", { enum: enumValues(FileFlag.options) }),
         parentDocId: text("parent_doc_id")
       },
@@ -30316,7 +30372,7 @@ async function snapshot(q, ownerId2, instanceId, reviewId, movedToUrl, now) {
       door: t.door ?? void 0,
       blastRadius: t.blastScope === null || t.blastNote === null ? void 0 : { scope: t.blastScope, note: t.blastNote }
     })),
-    files: fileRows,
+    files: fileRows.map(({ headings: _headings, ...file2 }) => file2),
     agentNotes: noteRows.map(({ note }) => ({ ...noteView(note), fileId: note.fileId, ord: note.ord })),
     docAssets: assetRows,
     writeups: writeupRows,
@@ -32686,11 +32742,11 @@ var init_schema2 = __esm({
        * @returns
        *   Schema.
        */
-      constructor(property, normal, space3) {
+      constructor(property, normal, space2) {
         this.normal = normal;
         this.property = property;
-        if (space3) {
-          this.space = space3;
+        if (space2) {
+          this.space = space2;
         }
       }
     };
@@ -32701,14 +32757,14 @@ var init_schema2 = __esm({
 });
 
 // ../../node_modules/.pnpm/property-information@7.2.0/node_modules/property-information/lib/util/merge.js
-function merge2(definitions, space3) {
+function merge2(definitions, space2) {
   const property = {};
   const normal = {};
   for (const definition3 of definitions) {
     Object.assign(property, definition3.property);
     Object.assign(normal, definition3.normal);
   }
-  return new Schema2(property, normal, space3);
+  return new Schema2(property, normal, space2);
 }
 var init_merge = __esm({
   "../../node_modules/.pnpm/property-information@7.2.0/node_modules/property-information/lib/util/merge.js"() {
@@ -32813,10 +32869,10 @@ var init_defined_info = __esm({
        * @returns
        *   Info.
        */
-      constructor(property, attribute, mask, space3) {
+      constructor(property, attribute, mask, space2) {
         let index3 = -1;
         super(property, attribute);
-        mark(this, "space", space3);
+        mark(this, "space", space2);
         if (typeof mask === "number") {
           while (++index3 < checks.length) {
             const check3 = checks[index3];
@@ -43750,146 +43806,6 @@ var init_assets = __esm({
   }
 });
 
-// ../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/lib/index.js
-function toString(node3) {
-  if ("children" in node3) {
-    return all2(node3);
-  }
-  return "value" in node3 ? node3.value : "";
-}
-function one2(node3) {
-  if (node3.type === "text") {
-    return node3.value;
-  }
-  return "children" in node3 ? all2(node3) : "";
-}
-function all2(node3) {
-  let index3 = -1;
-  const result = [];
-  while (++index3 < node3.children.length) {
-    result[index3] = one2(node3.children[index3]);
-  }
-  return result.join("");
-}
-var init_lib9 = __esm({
-  "../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/lib/index.js"() {
-  }
-});
-
-// ../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/index.js
-var init_hast_util_to_string = __esm({
-  "../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/index.js"() {
-    init_lib9();
-  }
-});
-
-// ../../packages/core/src/doc-title.ts
-function cleanDocTitle(value) {
-  return Array.from(value.replace(/[\s\x85]/gu, " ")).filter((char) => {
-    const code4 = char.codePointAt(0) ?? 0;
-    return !discardedRanges.some(([from, to]) => code4 >= from && code4 <= to);
-  }).join("").replace(/ +/g, " ").trim().toWellFormed().slice(0, LIMITS.titleChars).replace(/[\uD800-\uDBFF]$/, "").trim();
-}
-function htmlTitle(bytes) {
-  const tree = fromHtml(new TextDecoder().decode(bytes.subarray(0, TITLE_PREFIX_BYTES)));
-  const pending2 = [...tree.children].reverse();
-  while (pending2.length) {
-    const node3 = pending2.pop();
-    if (node3?.type !== "element") continue;
-    if (node3.tagName === "title") return cleanDocTitle(toString(node3)) || void 0;
-    for (const child of node3.children.toReversed()) pending2.push(child);
-  }
-  return void 0;
-}
-function fenceMarker(line) {
-  let start2 = 0;
-  while (start2 < 4 && line[start2] === " ") start2++;
-  const char = line[start2];
-  if (start2 === 4 || char !== "`" && char !== "~") return void 0;
-  let end = start2;
-  while (line[end] === char) end++;
-  return end - start2 >= 3 ? { char, length: end - start2, end } : void 0;
-}
-function markdownTitle(bytes) {
-  let comment5 = false;
-  let fence;
-  for (const raw4 of new TextDecoder().decode(bytes).split(/\r\n|\r|\n/)) {
-    const marker = !comment5 ? fenceMarker(raw4) : void 0;
-    if (fence) {
-      if (marker && marker.char === fence.char && marker.length >= fence.length) {
-        let end2 = marker.end;
-        while (space(raw4[end2])) end2++;
-        if (end2 === raw4.length) fence = void 0;
-      }
-      continue;
-    }
-    if (marker) {
-      fence = marker;
-      continue;
-    }
-    let line = raw4;
-    if (!fence) {
-      const parts = [];
-      let start3 = 0;
-      while (start3 < raw4.length) {
-        const mark2 = raw4.indexOf(comment5 ? "-->" : "<!--", start3);
-        if (!comment5) parts.push(raw4.slice(start3, mark2 < 0 ? raw4.length : mark2));
-        if (mark2 < 0) break;
-        start3 = mark2 + (comment5 ? 3 : 4);
-        comment5 = !comment5;
-      }
-      line = parts.join("");
-    }
-    let start2 = 0;
-    while (start2 < 4 && line[start2] === " ") start2++;
-    if (start2 === 4) continue;
-    const char = line[start2];
-    if (char !== "#" || !space(line[start2 + 1])) continue;
-    start2++;
-    while (space(line[start2])) start2++;
-    let end = line.length;
-    while (space(line[end - 1])) end--;
-    let closing3 = end;
-    while (closing3 > start2 && line[closing3 - 1] === "#") closing3--;
-    if (closing3 < end && space(line[closing3 - 1])) end = closing3;
-    const title = cleanDocTitle(line.slice(start2, Math.min(end, start2 + TITLE_CANDIDATE_CHARS)));
-    if (title) return title;
-  }
-  return void 0;
-}
-function inferDocTitle(kind, bytes) {
-  return kind === "html" ? htmlTitle(bytes) : markdownTitle(bytes);
-}
-var TITLE_PREFIX_BYTES, TITLE_CANDIDATE_CHARS, discardedRanges, space;
-var init_doc_title = __esm({
-  "../../packages/core/src/doc-title.ts"() {
-    "use strict";
-    init_src();
-    init_hast_util_from_html();
-    init_hast_util_to_string();
-    TITLE_PREFIX_BYTES = 64 * 1024;
-    TITLE_CANDIDATE_CHARS = LIMITS.titleChars * 4;
-    discardedRanges = [
-      [0, 31],
-      [127, 159],
-      [847, 847],
-      [1564, 1564],
-      [4447, 4448],
-      [8203, 8207],
-      [8234, 8238],
-      [8288, 8303],
-      [12644, 12644],
-      [65024, 65039],
-      [65279, 65279],
-      [65440, 65440],
-      [65529, 65531],
-      [917504, 917631],
-      [917760, 917999]
-    ];
-    space = (char) => char === " " || char === "	";
-  }
-});
-
 // ../../packages/core/src/render/normalize.ts
 var init_normalize2 = __esm({
   "../../packages/core/src/render/normalize.ts"() {
@@ -43924,111 +43840,6 @@ var init_html3 = __esm({
   }
 });
 
-// ../../packages/core/src/place/linemap.ts
-var init_linemap = __esm({
-  "../../packages/core/src/place/linemap.ts"() {
-    "use strict";
-  }
-});
-
-// ../../packages/core/src/place/lines.ts
-var init_lines = __esm({
-  "../../packages/core/src/place/lines.ts"() {
-    "use strict";
-    init_linemap();
-    init_search();
-  }
-});
-
-// ../../packages/core/src/place/place.ts
-var init_place = __esm({
-  "../../packages/core/src/place/place.ts"() {
-    "use strict";
-    init_html3();
-    init_lines();
-    init_span();
-  }
-});
-
-// ../../packages/core/src/place/renames.ts
-function composeRenames(steps) {
-  const composed = /* @__PURE__ */ new Map();
-  for (let index3 = steps.length - 1; index3 >= 0; index3--) {
-    const step = steps[index3];
-    if (!step) continue;
-    const pending2 = [];
-    for (const [from, to] of step) {
-      const next2 = to === null ? null : composed.get(to);
-      pending2.push([from, next2 === void 0 ? to : next2]);
-    }
-    for (const [from, to] of pending2) composed.set(from, to);
-  }
-  return composed;
-}
-var init_renames = __esm({
-  "../../packages/core/src/place/renames.ts"() {
-    "use strict";
-  }
-});
-
-// ../../packages/core/src/render/hash.ts
-var init_hash = __esm({
-  "../../packages/core/src/render/hash.ts"() {
-    "use strict";
-  }
-});
-
-// ../../packages/core/src/render/blocks.ts
-function renderData(element6) {
-  element6.data ??= { position: {} };
-  return element6.data;
-}
-function visitElements(node3, visit3) {
-  if (node3.type === "element") visit3(node3);
-  if ("children" in node3) for (const child of node3.children) visitElements(child, visit3);
-}
-function hasBlockChildren(node3) {
-  return "children" in node3 && node3.children.some((child) => child.type === "element" && (blockTags.has(child.tagName) || hasBlockChildren(child)));
-}
-var blockTags;
-var init_blocks = __esm({
-  "../../packages/core/src/render/blocks.ts"() {
-    "use strict";
-    init_hash();
-    init_normalize2();
-    blockTags = /* @__PURE__ */ new Set([
-      "blockquote",
-      "dd",
-      "details",
-      "div",
-      "dl",
-      "dt",
-      "h1",
-      "h2",
-      "h3",
-      "h4",
-      "h5",
-      "h6",
-      "hr",
-      "li",
-      "ol",
-      "p",
-      "pre",
-      "section",
-      "summary",
-      "table",
-      "ul"
-    ]);
-  }
-});
-
-// ../../packages/core/src/render/changed.ts
-var init_changed = __esm({
-  "../../packages/core/src/render/changed.ts"() {
-    "use strict";
-  }
-});
-
 // ../../node_modules/.pnpm/html-void-elements@3.0.0/node_modules/html-void-elements/index.js
 var htmlVoidElements;
 var init_html_void_elements = __esm({
@@ -44616,7 +44427,7 @@ var init_format_smart = __esm({
 function stringifyEntities(value, options) {
   return core(value, Object.assign({ format: formatSmart }, options));
 }
-var init_lib10 = __esm({
+var init_lib9 = __esm({
   "../../node_modules/.pnpm/stringify-entities@4.0.4/node_modules/stringify-entities/lib/index.js"() {
     init_core4();
     init_format_smart();
@@ -44626,7 +44437,7 @@ var init_lib10 = __esm({
 // ../../node_modules/.pnpm/stringify-entities@4.0.4/node_modules/stringify-entities/index.js
 var init_stringify_entities = __esm({
   "../../node_modules/.pnpm/stringify-entities@4.0.4/node_modules/stringify-entities/index.js"() {
-    init_lib10();
+    init_lib9();
   }
 });
 
@@ -44693,7 +44504,7 @@ function empty(value) {
   return value.replace(re, "") === "";
 }
 var re;
-var init_lib11 = __esm({
+var init_lib10 = __esm({
   "../../node_modules/.pnpm/hast-util-whitespace@3.0.0/node_modules/hast-util-whitespace/lib/index.js"() {
     re = /[ \t\n\f\r]/g;
   }
@@ -44702,7 +44513,7 @@ var init_lib11 = __esm({
 // ../../node_modules/.pnpm/hast-util-whitespace@3.0.0/node_modules/hast-util-whitespace/index.js
 var init_hast_util_whitespace = __esm({
   "../../node_modules/.pnpm/hast-util-whitespace@3.0.0/node_modules/hast-util-whitespace/index.js"() {
-    init_lib11();
+    init_lib10();
   }
 });
 
@@ -45107,8 +44918,8 @@ function toHtml(tree, options) {
     throw new Error("Invalid quote `" + quote + "`, expected `'` or `\"`");
   }
   const state = {
-    one: one3,
-    all: all3,
+    one: one2,
+    all: all2,
     settings: {
       omitOptionalTags: options_.omitOptionalTags || false,
       allowParseErrors: options_.allowParseErrors || false,
@@ -45138,10 +44949,10 @@ function toHtml(tree, options) {
     void 0
   );
 }
-function one3(node3, index3, parent) {
+function one2(node3, index3, parent) {
   return handle(node3, index3, parent, this);
 }
-function all3(parent) {
+function all2(parent) {
   const results = [];
   const children2 = parent && parent.children || emptyChildren2;
   let index3 = -1;
@@ -45151,7 +44962,7 @@ function all3(parent) {
   return results.join("");
 }
 var emptyOptions2, emptyCharacterReferences, emptyChildren2;
-var init_lib12 = __esm({
+var init_lib11 = __esm({
   "../../node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/index.js"() {
     init_html_void_elements();
     init_property_information();
@@ -45165,15 +44976,7 @@ var init_lib12 = __esm({
 // ../../node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/index.js
 var init_hast_util_to_html = __esm({
   "../../node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/index.js"() {
-    init_lib12();
-  }
-});
-
-// ../../packages/core/src/render/highlight.ts
-var init_highlight = __esm({
-  "../../packages/core/src/render/highlight.ts"() {
-    "use strict";
-    init_blocks();
+    init_lib11();
   }
 });
 
@@ -45238,7 +45041,7 @@ function looksLikeANode(value) {
   return value !== null && typeof value === "object" && "type" in value;
 }
 var convert;
-var init_lib13 = __esm({
+var init_lib12 = __esm({
   "../../node_modules/.pnpm/unist-util-is@6.0.1/node_modules/unist-util-is/lib/index.js"() {
     convert = // Note: overloads in JSDoc can’t yet use different `@template`s.
     /**
@@ -45282,7 +45085,7 @@ var init_lib13 = __esm({
 // ../../node_modules/.pnpm/unist-util-is@6.0.1/node_modules/unist-util-is/index.js
 var init_unist_util_is = __esm({
   "../../node_modules/.pnpm/unist-util-is@6.0.1/node_modules/unist-util-is/index.js"() {
-    init_lib13();
+    init_lib12();
   }
 });
 
@@ -45411,7 +45214,7 @@ function toResult(value) {
   return value === null || value === void 0 ? empty2 : [value];
 }
 var empty2, CONTINUE, EXIT, SKIP;
-var init_lib14 = __esm({
+var init_lib13 = __esm({
   "../../node_modules/.pnpm/unist-util-visit-parents@6.1.0/node_modules/unist-util-visit-parents/lib/index.js"() {
     init_unist_util_is();
     init_color_node();
@@ -45425,7 +45228,7 @@ var init_lib14 = __esm({
 // ../../node_modules/.pnpm/unist-util-visit-parents@6.1.0/node_modules/unist-util-visit-parents/index.js
 var init_unist_util_visit_parents = __esm({
   "../../node_modules/.pnpm/unist-util-visit-parents@6.1.0/node_modules/unist-util-visit-parents/index.js"() {
-    init_lib14();
+    init_lib13();
   }
 });
 
@@ -45463,7 +45266,7 @@ function wrap(visitor) {
     return visitor(node3, index3, parents[parents.length - 1]);
   }
 }
-var init_lib15 = __esm({
+var init_lib14 = __esm({
   "../../node_modules/.pnpm/unist-util-visit@5.2.0/node_modules/unist-util-visit/lib/index.js"() {
     init_unist_util_visit_parents();
     init_unist_util_visit_parents();
@@ -45473,6 +45276,39 @@ var init_lib15 = __esm({
 // ../../node_modules/.pnpm/unist-util-visit@5.2.0/node_modules/unist-util-visit/index.js
 var init_unist_util_visit = __esm({
   "../../node_modules/.pnpm/unist-util-visit@5.2.0/node_modules/unist-util-visit/index.js"() {
+    init_lib14();
+  }
+});
+
+// ../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/lib/index.js
+function toString(node3) {
+  if ("children" in node3) {
+    return all3(node3);
+  }
+  return "value" in node3 ? node3.value : "";
+}
+function one3(node3) {
+  if (node3.type === "text") {
+    return node3.value;
+  }
+  return "children" in node3 ? all3(node3) : "";
+}
+function all3(node3) {
+  let index3 = -1;
+  const result = [];
+  while (++index3 < node3.children.length) {
+    result[index3] = one3(node3.children[index3]);
+  }
+  return result.join("");
+}
+var init_lib15 = __esm({
+  "../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/lib/index.js"() {
+  }
+});
+
+// ../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/index.js
+var init_hast_util_to_string = __esm({
+  "../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/index.js"() {
     init_lib15();
   }
 });
@@ -45751,8 +45587,8 @@ var init_esm = __esm({
 // ../../node_modules/.pnpm/hast-util-to-parse5@8.0.1/node_modules/hast-util-to-parse5/lib/index.js
 function toParse5(tree, options) {
   const settings = options || emptyOptions3;
-  const space3 = settings.space;
-  return one4(tree, space3 === "svg" ? svg2 : html2);
+  const space2 = settings.space;
+  return one4(tree, space2 === "svg" ? svg2 : html2);
 }
 function root2(node3, schema) {
   const result = {
@@ -45822,14 +45658,14 @@ function element3(node3, schema) {
       }
     }
   }
-  const space3 = currentSchema.space;
-  ok(space3);
+  const space2 = currentSchema.space;
+  ok(space2);
   const result = {
     nodeName: node3.tagName,
     tagName: node3.tagName,
     attrs,
     // @ts-expect-error: `parse5` types are wrong.
-    namespaceURI: webNamespaces[space3],
+    namespaceURI: webNamespaces[space2],
     childNodes: [],
     parentNode: null
   };
@@ -58325,25 +58161,25 @@ function trimLine(value, start2, end) {
   let endIndex = value.length;
   if (start2) {
     let code4 = value.codePointAt(startIndex);
-    while (code4 === tab || code4 === space2) {
+    while (code4 === tab || code4 === space) {
       startIndex++;
       code4 = value.codePointAt(startIndex);
     }
   }
   if (end) {
     let code4 = value.codePointAt(endIndex - 1);
-    while (code4 === tab || code4 === space2) {
+    while (code4 === tab || code4 === space) {
       endIndex--;
       code4 = value.codePointAt(endIndex - 1);
     }
   }
   return endIndex > startIndex ? value.slice(startIndex, endIndex) : "";
 }
-var tab, space2;
+var tab, space;
 var init_trim_lines = __esm({
   "../../node_modules/.pnpm/trim-lines@3.0.1/node_modules/trim-lines/index.js"() {
     tab = 9;
-    space2 = 32;
+    space = 32;
   }
 });
 
@@ -59660,6 +59496,66 @@ var init_unified = __esm({
   }
 });
 
+// ../../packages/core/src/render/hash.ts
+var init_hash = __esm({
+  "../../packages/core/src/render/hash.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/core/src/render/blocks.ts
+function renderData(element6) {
+  element6.data ??= { position: {} };
+  return element6.data;
+}
+function visitElements(node3, visit3) {
+  if (node3.type === "element") visit3(node3);
+  if ("children" in node3) for (const child of node3.children) visitElements(child, visit3);
+}
+function hasBlockChildren(node3) {
+  return "children" in node3 && node3.children.some((child) => child.type === "element" && (blockTags.has(child.tagName) || hasBlockChildren(child)));
+}
+var blockTags;
+var init_blocks = __esm({
+  "../../packages/core/src/render/blocks.ts"() {
+    "use strict";
+    init_src();
+    init_hash();
+    init_normalize2();
+    blockTags = /* @__PURE__ */ new Set([
+      "blockquote",
+      "dd",
+      "details",
+      "div",
+      "dl",
+      "dt",
+      "h1",
+      "h2",
+      "h3",
+      "h4",
+      "h5",
+      "h6",
+      "hr",
+      "li",
+      "ol",
+      "p",
+      "pre",
+      "section",
+      "summary",
+      "table",
+      "ul"
+    ]);
+  }
+});
+
+// ../../packages/core/src/render/highlight.ts
+var init_highlight = __esm({
+  "../../packages/core/src/render/highlight.ts"() {
+    "use strict";
+    init_blocks();
+  }
+});
+
 // ../../packages/core/src/render/issue-refs.ts
 function link3(href, text11) {
   return { type: "element", tagName: "a", properties: { href }, children: [{ type: "text", value: text11 }] };
@@ -59711,7 +59607,7 @@ var init_issue_refs = __esm({
 });
 
 // ../../packages/core/src/render/line-breaks.ts
-function splitLines2(value) {
+function splitLines(value) {
   const parts = [];
   value.split(/\r\n|\r|\n/).forEach((line, index3) => {
     if (index3 > 0) parts.push({ type: "break" });
@@ -59724,7 +59620,7 @@ function breakText(node3) {
   const next2 = [];
   for (const child of node3.children) {
     if (child.type === "text" && child.value && /[\r\n]/.test(child.value)) {
-      next2.push(...splitLines2(child.value));
+      next2.push(...splitLines(child.value));
     } else {
       breakText(child);
       next2.push(child);
@@ -59781,6 +59677,46 @@ var init_reference_limit = __esm({
   }
 });
 
+// ../../packages/core/src/links.ts
+function resolveDocLink(base2, href, docs) {
+  const hasControl = (value) => Array.from(value).some((char) => {
+    const code4 = char.charCodeAt(0);
+    return code4 < 32 || code4 >= 127 && code4 <= 159;
+  });
+  if (!href || hasControl(href) || href.includes("\\")) return null;
+  const hash2 = href.indexOf("#");
+  const rawPath = hash2 < 0 ? href : href.slice(0, hash2);
+  if (rawPath.startsWith("/") || rawPath.includes("?") || /%2f|%5c/i.test(href)) return null;
+  let parts;
+  let fragment2;
+  try {
+    parts = rawPath.split("/").map((part) => decodeURIComponent(part));
+    fragment2 = hash2 < 0 ? void 0 : decodeURIComponent(href.slice(hash2 + 1));
+  } catch {
+    return null;
+  }
+  if (parts.some((part) => hasControl(part) || part.includes("\\") || part.includes(":")) || fragment2 !== void 0 && hasControl(fragment2))
+    return null;
+  if (rawPath !== "" && (rawPath.endsWith("/") || parts.at(-1) === "." || parts.at(-1) === "..")) return null;
+  const path2 = rawPath === "" ? base2.split("/") : base2.split("/").slice(0, -1);
+  if (rawPath !== "")
+    for (const part of parts) {
+      if (part === ".") continue;
+      if (part === "") return null;
+      if (part === "..") {
+        if (!path2.length) return null;
+        path2.pop();
+      } else path2.push(part);
+    }
+  const resolved = path2.join("/");
+  return docs.has(resolved) ? { path: resolved, ...fragment2 ? { fragment: fragment2 } : {} } : null;
+}
+var init_links2 = __esm({
+  "../../packages/core/src/links.ts"() {
+    "use strict";
+  }
+});
+
 // ../../packages/core/src/render/sanitize.ts
 function isGfmMarker(element6) {
   if (element6.tagName === "a" && Object.hasOwn(element6.properties, "dataFootnoteBackref")) {
@@ -59811,7 +59747,10 @@ function restoreFootnotes() {
       if (!("children" in parent)) continue;
       for (const [index3, child] of parent.children.entries()) {
         if (child.type === FOOTNOTE_NODE) {
-          parent.children[index3] = child.data.element;
+          const element6 = child.data.element;
+          parent.children[index3] = element6;
+          const link5 = element6.children[0];
+          if (element6.tagName === "sup" && link5?.type === "element") renderData(link5).emendFootnoteMarker = true;
         } else pending2.push(child);
       }
     }
@@ -59897,6 +59836,8 @@ function wrapMedia(node3, media) {
 function hardenLinks() {
   return (tree, file2) => {
     const media = file2.data.media;
+    const docs = file2.data.docs;
+    const base2 = typeof file2.data.docBase === "string" ? file2.data.docBase : "";
     visitElements(tree, (element6) => {
       const classes = renderData(element6).emendClasses;
       if (Array.isArray(classes) && classes.every(
@@ -59913,6 +59854,21 @@ function hardenLinks() {
         delete element6.properties.href;
         delete element6.properties.rel;
         delete element6.properties.target;
+        if (docs && element6.tagName === "a" && !renderData(element6).emendFootnoteMarker && !hasBlockChildren(element6) && typeof href === "string") {
+          const hash2 = href.indexOf("#");
+          const query = href.indexOf("?");
+          const lookup = query >= 0 && (hash2 < 0 || query < hash2) ? href.slice(0, query) + (hash2 < 0 ? "" : href.slice(hash2)) : href;
+          file2.data.docBaseUsed = true;
+          if (lookup.startsWith("#")) file2.data.docPathUsed = true;
+          const link5 = resolveDocLink(base2, lookup, docs);
+          if (link5) {
+            const params = new URLSearchParams({ tab: "docs", doc: link5.path });
+            const ids = docs.get(link5.path);
+            const id3 = link5.fragment && ids?.has(`${prefix}${link5.fragment}`) ? `${prefix}${link5.fragment}` : void 0;
+            const heading3 = id3 ? `#h-${encodeURIComponent(id3)}` : "";
+            element6.properties.href = `?${params}${heading3}`;
+          }
+        }
       }
       if (element6.tagName === "img") {
         const path2 = media ? mediaKey(src, media) : null;
@@ -59929,6 +59885,7 @@ var init_sanitize = __esm({
     "use strict";
     init_hast_util_to_string();
     init_rehype_sanitize();
+    init_links2();
     init_blocks();
     prefix = "user-content-";
     forbiddenTags = [
@@ -60025,14 +59982,28 @@ var init_tables = __esm({
 });
 
 // ../../packages/core/src/render/markdown.ts
+function isolateDiagrams() {
+  return (tree) => {
+    visitElements(tree, (element6) => {
+      if (element6.tagName !== "pre") return;
+      const code4 = element6.children[0];
+      if (code4?.type !== "element" || code4.tagName !== "code" || !Array.isArray(code4.properties.className) || !code4.properties.className.includes("language-mermaid"))
+        return;
+      const text11 = toString(code4);
+      renderData(element6).emendDiagram = text11.endsWith("\n") ? text11.slice(0, -1) : text11;
+      element6.children = [];
+    });
+  };
+}
 function sanitizedPipeline(lineBreaks = false) {
   return unified().use(remarkParse).use(remarkGfm).use(lineBreaks ? commentLineBreaks : keepLines).use(lineBreaks ? limitReferences : keepLines).use(limitTables).use(remarkRehype, { allowDangerousHtml: true, clobberPrefix: "" }).use(markFootnotes).use(rehypeRaw, { passThrough: [FOOTNOTE_NODE] }).use(restoreFootnotes).use(namespaceClasses).use(rehypeSanitize, sanitizeSchema).use(linkIssueRefs).use(hardenLinks);
 }
-var keepLines, commentProcessor;
+var keepLines, commentProcessor, metadataProcessor;
 var init_markdown = __esm({
   "../../packages/core/src/render/markdown.ts"() {
     "use strict";
     init_src();
+    init_hast_util_to_string();
     init_rehype_raw();
     init_rehype_sanitize();
     init_rehype_stringify();
@@ -60050,6 +60021,108 @@ var init_markdown = __esm({
     init_tables();
     keepLines = () => void 0;
     commentProcessor = sanitizedPipeline(true).use(rehypeStringify);
+    metadataProcessor = sanitizedPipeline().use(isolateDiagrams).use(rehypeStringify);
+  }
+});
+
+// ../../packages/core/src/doc-title.ts
+function cleanDocTitle(value) {
+  return Array.from(value.replace(/[\s\x85]/gu, " ")).filter((char) => {
+    const code4 = char.codePointAt(0) ?? 0;
+    return !discardedRanges.some(([from, to]) => code4 >= from && code4 <= to);
+  }).join("").replace(/ +/g, " ").trim().toWellFormed().slice(0, LIMITS.titleChars).replace(/[\uD800-\uDBFF]$/, "").trim();
+}
+var TITLE_PREFIX_BYTES, discardedRanges;
+var init_doc_title = __esm({
+  "../../packages/core/src/doc-title.ts"() {
+    "use strict";
+    init_src();
+    init_dist2();
+    init_html3();
+    init_markdown();
+    TITLE_PREFIX_BYTES = 64 * 1024;
+    discardedRanges = [
+      [0, 31],
+      [127, 159],
+      [847, 847],
+      [1564, 1564],
+      [4447, 4448],
+      [8203, 8207],
+      [8234, 8238],
+      [8288, 8303],
+      [12644, 12644],
+      [65024, 65039],
+      [65279, 65279],
+      [65440, 65440],
+      [65529, 65531],
+      [917504, 917631],
+      [917760, 917999]
+    ];
+  }
+});
+
+// ../../packages/core/src/doc-headings.ts
+var init_doc_headings = __esm({
+  "../../packages/core/src/doc-headings.ts"() {
+    "use strict";
+    init_src();
+    init_dist2();
+    init_doc_title();
+    init_html3();
+  }
+});
+
+// ../../packages/core/src/place/linemap.ts
+var init_linemap = __esm({
+  "../../packages/core/src/place/linemap.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/core/src/place/lines.ts
+var init_lines = __esm({
+  "../../packages/core/src/place/lines.ts"() {
+    "use strict";
+    init_linemap();
+    init_search();
+  }
+});
+
+// ../../packages/core/src/place/place.ts
+var init_place = __esm({
+  "../../packages/core/src/place/place.ts"() {
+    "use strict";
+    init_html3();
+    init_lines();
+    init_span();
+  }
+});
+
+// ../../packages/core/src/place/renames.ts
+function composeRenames(steps) {
+  const composed = /* @__PURE__ */ new Map();
+  for (let index3 = steps.length - 1; index3 >= 0; index3--) {
+    const step = steps[index3];
+    if (!step) continue;
+    const pending2 = [];
+    for (const [from, to] of step) {
+      const next2 = to === null ? null : composed.get(to);
+      pending2.push([from, next2 === void 0 ? to : next2]);
+    }
+    for (const [from, to] of pending2) composed.set(from, to);
+  }
+  return composed;
+}
+var init_renames = __esm({
+  "../../packages/core/src/place/renames.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/core/src/render/changed.ts
+var init_changed = __esm({
+  "../../packages/core/src/render/changed.ts"() {
+    "use strict";
   }
 });
 
@@ -60093,7 +60166,9 @@ var init_src2 = __esm({
   "../../packages/core/src/index.ts"() {
     "use strict";
     init_assets();
+    init_doc_headings();
     init_doc_title();
+    init_links2();
     init_html3();
     init_linemap();
     init_lines();
@@ -60229,10 +60304,12 @@ var init_changed2 = __esm({
 import { Worker as Worker2 } from "node:worker_threads";
 function workerExecutor(timeouts = { render: 1e4, place: 3e4 }) {
   let worker;
+  let workerDocs;
   let busy = false;
   const close = async () => {
     const current = worker;
     worker = void 0;
+    workerDocs = void 0;
     if (current) await current.terminate();
   };
   const execute3 = (work) => new Promise((resolve15, reject) => {
@@ -60242,9 +60319,13 @@ function workerExecutor(timeouts = { render: 1e4, place: 3e4 }) {
     }
     busy = true;
     if (!worker) {
+      workerDocs = void 0;
       worker = new Worker2(
         new URL(import.meta.url.endsWith(".ts") ? "./worker.ts" : "./publish-worker.mjs", import.meta.url),
-        { resourceLimits: { maxOldGenerationSizeMb: 256, maxYoungGenerationSizeMb: 32 } }
+        {
+          // Deep author nesting relies on Node's default 4 MB worker stack.
+          resourceLimits: { maxOldGenerationSizeMb: 256, maxYoungGenerationSizeMb: 32, stackSizeMb: 4 }
+        }
       );
       const created = worker;
       created.on("error", () => {
@@ -60288,12 +60369,19 @@ function workerExecutor(timeouts = { render: 1e4, place: 3e4 }) {
     current.once("exit", failed2);
     current.ref();
     try {
-      const buffers = work.kind === "doc" ? [work.source] : work.kind === "resection" || work.kind === "placement-doc" || work.kind === "writeup-source" || work.kind === "line-count" ? [work.bytes] : work.kind === "changed" ? [...work.previous.map((blob2) => blob2.bytes), ...work.next] : work.kind === "place" ? [
+      const buffers = work.kind === "doc" ? [work.source] : work.kind === "doc-metadata" || work.kind === "resection" || work.kind === "placement-doc" || work.kind === "writeup-source" || work.kind === "line-count" ? [work.bytes] : work.kind === "changed" ? [...work.previous.map((blob2) => blob2.bytes), ...work.next] : work.kind === "place" ? [
         ...work.texts.values(),
         ...[...work.parsedDocs?.values() ?? []].map((doc) => doc.bytes),
         ...work.parsedWriteup ? [work.parsedWriteup.bytes] : []
       ] : [];
-      current.postMessage(work, [...new Set(buffers)]);
+      if (work.kind === "doc" || work.kind === "writeup") {
+        const { docs, ...job } = work;
+        if (docs !== workerDocs) {
+          current.postMessage({ kind: "doc-context", docs });
+          workerDocs = docs;
+        }
+        current.postMessage(job, [...new Set(buffers)]);
+      } else current.postMessage(work, [...new Set(buffers)]);
     } catch {
       failed2();
     }
@@ -60353,6 +60441,49 @@ var init_media = __esm({
 // src/server/publish/render.ts
 import { setImmediate as setImmediate2 } from "node:timers/promises";
 async function renderRevision(input2, execute3, read, put, signal, onRendered) {
+  const metadata = /* @__PURE__ */ new Map();
+  const metadataCache = /* @__PURE__ */ new Map();
+  let metadataBytes = 0;
+  for (const file2 of input2.files) {
+    checkPublishSignal(signal);
+    if (file2.role !== "doc") continue;
+    const format = mediaType(file2.path) === "text/html" ? "html" : "markdown";
+    const key3 = `${format}:${file2.newBlob}`;
+    let own12 = metadataCache.get(key3);
+    if (!own12) {
+      own12 = { headings: [] };
+      if (file2.newBlob)
+        try {
+          const result = await execute3({ kind: "doc-metadata", format, bytes: await read(file2.newBlob) });
+          if (result.kind !== "doc-metadata") throw new Error("wrong result");
+          own12 = { title: result.title, headings: result.headings };
+        } catch {
+          checkPublishSignal(signal);
+        }
+      metadataCache.set(key3, own12);
+    }
+    const doc = {
+      title: cleanDocTitle(file2.title ?? "") || own12.title || cleanDocTitle(file2.path.split("/").at(-1) ?? "") || "Document",
+      headings: own12.headings
+    };
+    const size = Buffer.byteLength(JSON.stringify(doc));
+    metadataBytes += size;
+    onRendered?.(size);
+    if (metadataBytes > LIMITS.renderedBytesPerRevision) throw new ApiError("too_large");
+    metadata.set(file2.path, doc);
+    await setImmediate2();
+  }
+  const headingIds = /* @__PURE__ */ new Map();
+  const docs = new Map(
+    [...metadata].map(([path2, doc]) => {
+      let ids2 = headingIds.get(doc.headings);
+      if (!ids2) {
+        ids2 = new Set(doc.headings.flatMap((h2) => h2.id ? [h2.id] : []));
+        headingIds.set(doc.headings, ids2);
+      }
+      return [path2, ids2];
+    })
+  );
   let rendered;
   try {
     const media = [];
@@ -60364,7 +60495,8 @@ async function renderRevision(input2, execute3, read, put, signal, onRendered) {
       topics: input2.topics,
       links: input2.links,
       repoUrl: input2.repoUrl,
-      media
+      media,
+      docs
     });
     if (result.kind !== "writeup") throw new Error("wrong result");
     rendered = result;
@@ -60377,7 +60509,7 @@ async function renderRevision(input2, execute3, read, put, signal, onRendered) {
   const renderedBytes2 = Buffer.from(rendered.bytes);
   onRendered?.(renderedBytes2.length);
   let count2 = rendered.count;
-  let bytes = renderedBytes2.length;
+  let bytes = renderedBytes2.length + metadataBytes;
   if (count2 > LIMITS.blocksPerRevision || bytes > LIMITS.renderedBytesPerRevision)
     throw new ApiError("too_large", "writeup_blocks");
   await setImmediate2();
@@ -60395,39 +60527,47 @@ async function renderRevision(input2, execute3, read, put, signal, onRendered) {
     )
   );
   const cache2 = /* @__PURE__ */ new Map();
+  const folderCache = /* @__PURE__ */ new Map();
   const docBlobs = /* @__PURE__ */ new Map();
   const unrendered = [];
+  const markUnrendered = (path2) => {
+    unrendered.push(path2);
+    const doc = metadata.get(path2);
+    if (doc) doc.headings = [];
+  };
   let exhausted = false;
   for (const file2 of input2.files) {
     checkPublishSignal(signal);
     if (file2.role !== "doc" || !file2.newBlob || mediaType(file2.path) !== "text/markdown") continue;
     if (exhausted) {
-      unrendered.push(file2.path);
+      markUnrendered(file2.path);
       continue;
     }
     let result;
-    const shared2 = cache2.get(file2.newBlob);
+    const folderKey = `${file2.newBlob}:${file2.path.slice(0, file2.path.lastIndexOf("/") + 1)}`;
+    const source2 = cache2.get(file2.newBlob);
+    const shared2 = source2 === void 0 ? folderCache.get(folderKey) : source2;
     if (shared2 === null) {
-      unrendered.push(file2.path);
+      markUnrendered(file2.path);
       continue;
     }
     try {
       const rendered2 = await execute3(
-        shared2 === void 0 ? { kind: "doc", path: file2.path, source: await read(file2.newBlob), repoUrl: input2.repoUrl } : { kind: "resection", path: file2.path, bytes: await read(shared2) }
+        shared2 === void 0 ? { kind: "doc", path: file2.path, source: await read(file2.newBlob), repoUrl: input2.repoUrl, docs } : { kind: "resection", path: file2.path, bytes: await read(shared2) }
       );
       if (rendered2.kind !== "doc") throw new Error("wrong result");
       result = rendered2;
     } catch {
       checkPublishSignal(signal);
       cache2.set(file2.newBlob, null);
-      unrendered.push(file2.path);
+      markUnrendered(file2.path);
       continue;
     }
     const json3 = Buffer.from(result.bytes);
     onRendered?.(json3.length);
     if (count2 + result.count > LIMITS.blocksPerRevision || bytes + json3.length > LIMITS.renderedBytesPerRevision) {
       exhausted = true;
-      unrendered.push(file2.path);
+      markUnrendered(file2.path);
       continue;
     }
     count2 += result.count;
@@ -60436,15 +60576,19 @@ async function renderRevision(input2, execute3, read, put, signal, onRendered) {
     checkPublishSignal(signal);
     const blob2 = await put(json3);
     docBlobs.set(file2.path, blob2);
-    if (shared2 === void 0) cache2.set(file2.newBlob, blob2);
+    if (shared2 === void 0) {
+      if (!result.pathDependent) cache2.set(file2.newBlob, blob2);
+      else if (!result.selfDependent) folderCache.set(folderKey, blob2);
+    }
     ids.push(result.ids);
   }
-  return { ids, renderedBlob, sourceBlob, docBlobs, count: count2, unrendered };
+  return { ids, renderedBlob, sourceBlob, docBlobs, count: count2, unrendered, metadata };
 }
 var init_render = __esm({
   "src/server/publish/render.ts"() {
     "use strict";
     init_src();
+    init_src2();
     init_errors5();
     init_executor();
     init_lifecycle2();
@@ -60637,7 +60781,7 @@ async function computePublish(ownerId2, instanceId, input2, deps) {
       (bytes) => deps.blobs.put(ownerId2, bytes, "application/json"),
       deps.signal
     );
-    const { ids, renderedBlob, sourceBlob, docBlobs, unrendered } = prepared;
+    const { ids, renderedBlob, sourceBlob, docBlobs, unrendered, metadata } = prepared;
     const sideTexts = /* @__PURE__ */ new Map();
     const sideText = async (sha) => {
       let value = sideTexts.get(sha);
@@ -60828,6 +60972,8 @@ async function computePublish(ownerId2, instanceId, input2, deps) {
             newBlob: file2.newBlob,
             flag: file2.flag,
             parentDocId: file2.parent ? ids2.get(`doc:${file2.parent}`) : null,
+            title: file2.role === "doc" ? metadata.get(file2.path)?.title ?? null : null,
+            headings: file2.role === "doc" ? metadata.get(file2.path)?.headings ?? null : null,
             renderedBlob: file2.role === "doc" ? docBlobs.get(file2.path) ?? null : null
           });
           for (const [noteOrd, note] of (file2.notes ?? []).entries())
@@ -78510,7 +78656,8 @@ async function prepareImport(ownerId2, bundle, deps, signal) {
       rendered.set(revision.id, {
         sourceBlob: result.sourceBlob,
         renderedBlob: result.renderedBlob,
-        docBlobs: result.docBlobs
+        docBlobs: result.docBlobs,
+        metadata: result.metadata
       });
       empty3.set(
         revision.id,
@@ -78682,6 +78829,8 @@ async function importReview(principal, bundle, deps, signal) {
           [...bundle.files].sort((a, b) => Number(a.role === "asset") - Number(b.role === "asset")).map((r) => ({
             ...r,
             ownerId: ownerId2,
+            title: r.role === "doc" ? prepared.rendered.get(r.revisionId)?.metadata.get(r.path)?.title ?? null : null,
+            headings: r.role === "doc" ? prepared.rendered.get(r.revisionId)?.metadata.get(r.path)?.headings ?? null : null,
             mediaType: r.role === "diff" ? "text/plain" : mediaType(r.path),
             renderedBlob: r.role === "doc" ? prepared.rendered.get(r.revisionId)?.docBlobs.get(r.path) ?? null : null
           }))
@@ -79485,8 +79634,13 @@ async function revisionView(ownerId2, q, deps, reviewId, seq) {
   const docs = [];
   for (const file2 of fileRows) {
     if (file2.role !== "doc") continue;
+    const metadata = {
+      ...file2.title !== null ? { title: file2.title } : {},
+      ...file2.headings !== null ? { headings: file2.headings } : {}
+    };
     if (file2.mediaType === "text/html") {
       docs.push({
+        ...metadata,
         path: file2.path,
         kind: "html",
         contentUrl: `/content/${revision.contentKey}${file2.id.replaceAll("-", "")}/${file2.path.split("/").map(encodeURIComponent).join("/")}`
@@ -79495,6 +79649,7 @@ async function revisionView(ownerId2, q, deps, reviewId, seq) {
       docs.push({
         path: file2.path,
         kind: "markdown",
+        ...metadata,
         blocks: file2.renderedBlob ? await readJson(file2.renderedBlob) : []
       });
     }
@@ -82582,12 +82737,13 @@ async function resolvePublish(manifest, options, stateDir2, instanceId, cwd, war
       return readResolvedDoc(actual);
     };
     const bytes = await readResolvedDoc(source2);
-    if (file2.path === manifest.main && options.titleFromMain) title = options.titleFromMain(bytes);
+    if (file2.path === manifest.main && options.titleFromMain) title = await options.titleFromMain(bytes);
     const resolvedDoc = {
       path: file2.path,
       oldPath: null,
       role: "doc",
       topic: file2.topic,
+      title: file2.title,
       oldBlob: null,
       newBlob: addRequired(bytes, readDoc),
       flag: null,
@@ -82922,7 +83078,21 @@ async function shortcutManifest(options, stateDir2, cwd, context) {
   }
   const givenTitle = cleanDocTitle(options.title ?? "");
   const fallbackTitle = cleanDocTitle(basename6(main)) || "Document";
-  const titleFromMain = givenTitle ? void 0 : (bytes) => inferDocTitle(isHtml(main) ? "html" : "markdown", bytes) || fallbackTitle;
+  const titleFromMain = givenTitle ? void 0 : async (bytes) => {
+    const execute3 = workerExecutor();
+    try {
+      const result = await execute3({
+        kind: "doc-metadata",
+        format: isHtml(main) ? "html" : "markdown",
+        bytes: Uint8Array.from(bytes).buffer
+      });
+      return result.kind === "doc-metadata" && result.title || fallbackTitle;
+    } catch {
+      return fallbackTitle;
+    } finally {
+      await execute3.close();
+    }
+  };
   const parsed = PublishManifest.safeParse(
     {
       version: 1,
@@ -82953,6 +83123,7 @@ var init_shortcut = __esm({
     "use strict";
     init_src();
     init_src2();
+    init_executor();
     init_config();
     init_escape();
     init_http();