drafter-mcp 0.25.0 → 0.26.0

package/drafter-mcp.js

@@ -23233,7 +23233,7 @@ function toError(value) {
 	return value instanceof Error ? value : new Error(String(value));
 }
 // package.json
-var version = "0.25.0";
+var version = "0.26.0";
 // ../fountain/src/inline.ts
 const MARKERS$1 = /[*_\\]/;
 const isSpace$10 = (code) => code === void 0 || /\s/.test(String.fromCharCode(code));
@@ -25892,7 +25892,7 @@ function columns(s) {
 	return n;
 }
 const joined = (runs) => runs.map((run) => run.text).join("");
-const isBlank$1 = (line) => joined(line.runs).trim() === "" && (!line.right || joined(line.right.runs).trim() === "");
+const isBlank$2 = (line) => joined(line.runs).trim() === "" && (!line.right || joined(line.right.runs).trim() === "");
 function colFor(frame, length) {
 	if (frame.align === "center") return frame.indent + Math.floor((frame.width - length) / 2);
 	if (frame.align === "right") return frame.indent + frame.width - length;
@@ -26072,7 +26072,7 @@ function titlePage(tp, template, height, diagnostics) {
 		page: {
 			number: 0,
 			lines: rows.map((row, k) => {
-				if (row && !isBlank$1(row)) last = k;
+				if (row && !isBlank$2(row)) last = k;
 				return row ?? blankLine(tp.span.from);
 			}),
 			sceneNumbersLeft: [],
@@ -26293,7 +26293,7 @@ var Items = class {
 			lines,
 			spaceBefore: p.style.spaceBefore,
 			spaceAfter: p.style.spaceAfter ?? 0,
-			keepWithNext: p.style.keepWithNext === true || lines.every(isBlank$1),
+			keepWithNext: p.style.keepWithNext === true || lines.every(isBlank$2),
 			keepTogether: p.style.keepTogether === true
 		};
 	}
@@ -26324,7 +26324,7 @@ var Items = class {
 			if (!p) continue;
 			const kind = this.#blocks[m].kind;
 			for (const line of this.#lines(m, p)) {
-				const tag = isBlank$1(line) ? "gap" : kind === "parenthetical" ? "paren" : "text";
+				const tag = isBlank$2(line) ? "gap" : kind === "parenthetical" ? "paren" : "text";
 				body.push(line);
 				tags.push(tag);
 				spoken.push(spoken.at(-1) + (tag === "text" ? 1 : 0));
@@ -26453,7 +26453,7 @@ var Filler = class {
 	*/
 	#canStart(item, room, space) {
 		if (item.type === "block") {
-			const lead = Math.max(0, item.lines.findIndex((line) => !isBlank$1(line)));
+			const lead = Math.max(0, item.lines.findIndex((line) => !isBlank$2(line)));
 			return space + (item.keepTogether ? item.lines.length : Math.min(item.lines.length, lead + this.template.keepWithNextLines)) <= room;
 		}
 		if (item.type === "dual") return space + item.rows.length <= room;
@@ -26593,7 +26593,7 @@ var Pager = class {
 	/** Adds a line, starting a new page when this one is full. A page never starts blank. */
 	put(line) {
 		if (this.#lines.length >= this.height) this.newPage();
-		const blank = isBlank$1(line);
+		const blank = isBlank$2(line);
 		if (blank && this.#lines.length === 0) return;
 		const at = {
 			page: this.pages.length + 1,
@@ -30174,12 +30174,44 @@ async function imported(run) {
 	return got;
 }
 /**
+* The most paragraphs (text between blank lines) a file may have to be read: a long feature
+* script has a few thousand. Past this, a file's parse can outgrow a reader's heap
+* (READER_HEAP_MB), and in list_scripts or search_scripts the reader stopping would fail the whole
+* folder; so the file is refused alone, as too long (red/blue audit, 2026-11-03: a 3 MB file of
+* 540,000 one-line scenes and actions stopped every listing, where 360,000 still listed).
+*/
+const MAX_PARAGRAPHS = 3e5;
+/** Whether `text` has more than `max` paragraphs (lines ending in LF, CR, or CRLF), in one pass. */
+function moreParagraphsThan(text, max) {
+	let paragraphs = 0;
+	let blank = true;
+	let lineBlank = true;
+	for (let i = 0; i < text.length; i++) {
+		const code = text.charCodeAt(i);
+		if (code === 10 || code === 13) {
+			if (code === 13 && text.charCodeAt(i + 1) === 10) i++;
+			blank = lineBlank;
+			lineBlank = true;
+		} else if (code !== 32 && code !== 9 && lineBlank) {
+			lineBlank = false;
+			if (blank && ++paragraphs > max) return true;
+			blank = false;
+		}
+	}
+	return false;
+}
+/**
 * The script inside `file`, named `name` (its shown name, which is all a refusal says), judged in
 * Open's order. Throws NotRead when its bytes couldn't be read, NotOpened in Open's words for a
 * file Open turns away, and Refused (the reader's own phrase) for text Open won't read: over 5 MB,
-* not UTF-8, more than text.
+* not UTF-8, more than text, or more than MAX_PARAGRAPHS paragraphs.
 */
 async function readInside(file, name) {
+	const inside = await readWhole(file, name);
+	if (moreParagraphsThan(inside.text, 3e5)) throw new Refused(`it has more than ${MAX_PARAGRAPHS.toLocaleString("en-US")} paragraphs`);
+	return inside;
+}
+async function readWhole(file, name) {
 	const kind = importKindOf(name);
 	const read = {
 		noFollow: true,
@@ -30894,12 +30926,13 @@ function signatureLines(candidates, used = () => false) {
 }
 // ../story-map/src/mailto.ts
 /** What a contact may never hold: spaces, controls, and anything that ends or reshapes a URL. */
-const REFUSED = /[\s?&"<>:\\/\u0000-\u001f\u007f]/;
+const REFUSED = /[\s?&"<>:\\/,;%\u0000-\u001f\u007f]/;
 /**
 * A `mailto:` link for a contact the page may link (design §10.8): one `@`, neither first nor
 * last; a dot in the part after it, with something on both sides of it; and no space, control
-* character, `?` or `&` (which would add headers or a body to the mail), quote, angle bracket,
-* colon, or slash (which could end the attribute or make it another kind of link). Else null, and
+* character, `?` or `&` (which would add headers or a body to the mail), comma, semicolon, or
+* `%` (which would add another address, plainly or encoded: red/blue audit, 2026-11-03), quote,
+* angle bracket, colon, or slash (which could end the attribute or make it another kind of link). Else null, and
 * the page shows the contact as text.
 */
 function mailtoOf(contact) {
@@ -30916,18 +30949,18 @@ const MOST_HOOK = 200;
 /** The planned length's bounds, in pages. */
 const FEWEST_PAGES = 1;
 const MOST_PAGES = 999;
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /** The `storyMap` part of a parsed metadata block (`doc.meta`), read strictly. */
 function storyMapMeta(meta) {
 	const hooks = Object.create(null);
-	const part = isRecord(meta) ? meta.storyMap : void 0;
-	if (!isRecord(part)) return {
+	const part = isRecord$1(meta) ? meta.storyMap : void 0;
+	if (!isRecord$1(part)) return {
 		plannedPages: null,
 		hooks
 	};
 	const pages = part.plannedPages;
 	const plannedPages = typeof pages === "number" && Number.isInteger(pages) && pages >= FEWEST_PAGES && pages <= MOST_PAGES ? pages : null;
-	if (isRecord(part.hooks)) {
+	if (isRecord$1(part.hooks)) {
 		for (const [key, hook] of Object.entries(part.hooks)) if (typeof hook === "string" && hook.length <= MOST_HOOK) hooks[key] = hook;
 	}
 	return {
@@ -31492,6 +31525,66 @@ function shares(amounts) {
 	}
 	return whole;
 }
+// ../markdown/src/meta.ts
+const OPENER = "<!-- drafter ";
+const CLOSER = " -->";
+function isSpace$6(code) {
+	return code === 32 || code === 9 || code === 10 || code === 13;
+}
+/**
+* The document's metadata block: its last line (trailing spaces and blank lines aside), starting
+* at the line's start (so not indented code) as `<!-- drafter `, ending ` -->`, and holding a JSON
+* object. Anything else, a comment with words after it, or one whose JSON doesn't read as an
+* object, is the writer's own text. One backwards scan, then one JSON parse: linear.
+*/
+function findMarkdownMeta(text) {
+	let end = text.length;
+	while (end > 0 && isSpace$6(text.charCodeAt(end - 1))) end--;
+	const from = text.lastIndexOf("\n", end - 1) + 1;
+	if (end - from < 17) return null;
+	if (!text.startsWith(OPENER, from) || !text.startsWith(CLOSER, end - 4)) return null;
+	let meta;
+	try {
+		meta = JSON.parse(text.slice(from + 13, end - 4));
+	} catch {
+		return null;
+	}
+	if (meta === null || typeof meta !== "object" || Array.isArray(meta)) return null;
+	return {
+		from,
+		to: end,
+		meta
+	};
+}
+/**
+* The document's text and its metadata. The body is the text without the block, the line break
+* after it, and the one blank line before it that `setMarkdownMeta` wrote, so a body written with
+* `setMarkdownMeta` comes back exactly. No block: the whole text, and `meta: null`.
+*/
+function readMarkdownMeta(text) {
+	const block = findMarkdownMeta(text);
+	if (!block) return {
+		body: text,
+		meta: null
+	};
+	const before = text.slice(0, block.from);
+	const nl = text.startsWith("\r\n", block.to) ? "\r\n" : text.startsWith("\n", block.to) ? "\n" : before.endsWith("\r\n\r\n") ? "\r\n" : "\n";
+	const gap = nl + nl;
+	return {
+		body: before.endsWith(gap) ? before.slice(0, -gap.length) : before,
+		meta: block.meta
+	};
+}
+/**
+* The document as prose: its body (`readMarkdownMeta`), the text without its trailing metadata
+* block, the line breaks after it, and the blank line `setMarkdownMeta` wrote before it. The block
+* is Drafter's, not the writer's: the Preview, Print, and every export draw the prose, the word
+* counts count it, and the cut finder and Compare compare it. The prose is the text's start, so an
+* offset into it is the same offset into the text. No block: the whole text.
+*/
+function markdownProse(text) {
+	return readMarkdownMeta(text).body;
+}
 // ../markdown/src/words.ts
 /**
 * Whether a UTF-16 code unit is one that `/\s/` matches: the ASCII spaces (tab, line feed,
@@ -31500,7 +31593,7 @@ function shares(amounts) {
 * medium mathematical space, the ideographic space, and the byte-order mark. A comparison per
 * character, where a regular expression per character cost more than the reparse on a long script.
 */
-function isSpace$6(code) {
+function isSpace$5(code) {
 	if (code <= 32) return code === 32 || code >= 9 && code <= 13;
 	if (code < 160) return false;
 	return code === 160 || code === 5760 || code >= 8192 && code <= 8202 || code === 8232 || code === 8233 || code === 8239 || code === 8287 || code === 12288 || code === 65279;
@@ -31510,7 +31603,7 @@ function wordsIn(text) {
 	let count = 0;
 	let inWord = false;
 	for (let i = 0; i < text.length; i++) {
-		const space = isSpace$6(text.charCodeAt(i));
+		const space = isSpace$5(text.charCodeAt(i));
 		if (!space && !inWord) count++;
 		inWord = !space;
 	}
@@ -31547,7 +31640,7 @@ const SMALL = /* @__PURE__ */ new Set([
 const cased = (c) => c.toLowerCase() !== c.toUpperCase();
 const isUpper$1 = (c) => cased(c) && c === c.toUpperCase();
 const isLower = (c) => cased(c) && c === c.toLowerCase();
-const isSpace$5 = (c) => c !== void 0 && c !== "" && c.trim() === "";
+const isSpace$4 = (c) => c !== void 0 && c !== "" && c.trim() === "";
 /** One word in title case: its first letter, and the first after a hyphen, in capitals. */
 function titleWord(word, first) {
 	const chars = Array.from(word);
@@ -31570,7 +31663,7 @@ function titleWord(word, first) {
 function titleCase(text) {
 	let first = true;
 	return text.split(/(\s+)/).map((part) => {
-		if (part === "" || isSpace$5(part[0])) return part;
+		if (part === "" || isSpace$4(part[0])) return part;
 		const word = titleWord(part, first);
 		first = false;
 		return word;
@@ -31598,7 +31691,7 @@ function withoutNumber(text) {
 function slashParts(part) {
 	const out = [];
 	let from = 0;
-	for (let i = 0; i < part.length; i++) if (part[i] === "/" && (isSpace$5(part[i - 1]) || isSpace$5(part[i + 1]))) {
+	for (let i = 0; i < part.length; i++) if (part[i] === "/" && (isSpace$4(part[i - 1]) || isSpace$4(part[i + 1]))) {
 		out.push(part.slice(from, i));
 		from = i + 1;
 	}
@@ -31614,7 +31707,7 @@ function placeWords(location) {
 	const text = withoutNumber(location);
 	const parts = [];
 	let from = 0;
-	for (let i = 1; i < text.length - 1; i++) if (DASHES$1.has(text[i]) && isSpace$5(text[i - 1]) && isSpace$5(text[i + 1])) {
+	for (let i = 1; i < text.length - 1; i++) if (DASHES$1.has(text[i]) && isSpace$4(text[i - 1]) && isSpace$4(text[i + 1])) {
 		parts.push(text.slice(from, i));
 		from = i + 1;
 	}
@@ -31629,7 +31722,7 @@ const followsOn = (key) => key.startsWith("LATER ") || key.endsWith(" LATER");
 */
 function followOn(location) {
 	const text = location.trimEnd();
-	for (let i = text.length - 2; i > 0; i--) if (DASHES$1.has(text[i]) && isSpace$5(text[i - 1]) && isSpace$5(text[i + 1])) {
+	for (let i = text.length - 2; i > 0; i--) if (DASHES$1.has(text[i]) && isSpace$4(text[i - 1]) && isSpace$4(text[i + 1])) {
 		const part = text.slice(i + 1).trim();
 		if (!followsOn(part.toUpperCase().split(/\s+/).join(" "))) break;
 		return {
@@ -31795,7 +31888,7 @@ const TRAILING = /* @__PURE__ */ new Set([
 ]);
 /** A comma or dashes just after a name (or its age), and the spaces after them: anchored, linear. */
 const LEAD = /^[,\-–—―][\s,\-–—―]*/u;
-const isSpace$4 = (c) => c !== void 0 && c.trim() === "";
+const isSpace$3 = (c) => c !== void 0 && c.trim() === "";
 const isLetter = (c) => c !== void 0 && /\p{L}/u.test(c);
 const isStop = (c) => c === "." || c === "!" || c === "?";
 /** Whether the period at `i` closes an abbreviation or an initial (`Dr.`, `J.`). */
@@ -31818,7 +31911,7 @@ function sentenceEnd(text, from = 0, limit = text.length) {
 		let j = i + 1;
 		while (j < text.length && isStop(text[j])) j++;
 		while (j < text.length && CLOSERS.has(text[j])) j++;
-		if (j < text.length && !isSpace$4(text[j])) {
+		if (j < text.length && !isSpace$3(text[j])) {
 			i = j - 1;
 			continue;
 		}
@@ -31943,7 +32036,7 @@ function nameCase(text, map, names, ages = true) {
 			at += 2;
 		}
 		if (!ages) {
-			const age = ageAt(text, isSpace$4(text[at]) ? at + 1 : at);
+			const age = ageAt(text, isSpace$3(text[at]) ? at + 1 : at);
 			if (age) at = age.end;
 		}
 	}
@@ -31964,7 +32057,7 @@ function withoutMarks(text) {
 	return text.replace(SCREEN_MARKS, (mark, at) => {
 		if (mark.startsWith("(") || !mark.endsWith(".")) return GONE;
 		let next = at + mark.length;
-		while (isSpace$4(text[next])) next++;
+		while (isSpace$3(text[next])) next++;
 		const c = text[next];
 		return c === void 0 || c !== c.toLowerCase() && c === c.toUpperCase() ? STOP_KEPT : GONE;
 	}).replace(/\s+/g, " ").replace(/ ?\uE001(?=[,.;:!?])/g, "").replace(/\uE001/g, "").replace(/ ?\uE000/g, ".").replace(/\s+/g, " ").trim();
@@ -32022,7 +32115,7 @@ function pastCapitals(text, at) {
 	let i = at;
 	for (let n = 0; n < NAME_WORDS; n++) {
 		let j = i;
-		while (isSpace$4(text[j])) j++;
+		while (isSpace$3(text[j])) j++;
 		let k = j;
 		while (k < text.length && /[\p{L}\p{M}'’.-]/u.test(text[k])) k++;
 		const word = text.slice(j, k).replace(/\.$/, "");
@@ -32039,11 +32132,11 @@ function pastCapitals(text, at) {
 */
 function introducedAt(text, at) {
 	let j = pastCapitals(text, at);
-	while (isSpace$4(text[j])) j++;
+	while (isSpace$3(text[j])) j++;
 	if (ageAt(text, j)) return true;
 	const aside = asideEnd(text, j);
 	if (aside >= 0) j = aside;
-	while (isSpace$4(text[j])) j++;
+	while (isSpace$3(text[j])) j++;
 	const c = text[j];
 	return c === "," || c === "-" || c !== void 0 && DASHES.has(c);
 }
@@ -32054,7 +32147,7 @@ function introducedAt(text, at) {
 function hookFrom(text, at, map, names) {
 	let i = pastCapitals(text, at);
 	let j = i;
-	while (isSpace$4(text[j])) j++;
+	while (isSpace$3(text[j])) j++;
 	const aged = ageAt(text, j);
 	const aside = aged ? aged.end : asideEnd(text, j);
 	if (aside >= 0) i = aside;
@@ -32065,7 +32158,7 @@ function hookFrom(text, at, map, names) {
 	rest = rest.slice(lead.length);
 	if (lead !== "") for (let k = 0; k < rest.length; k++) {
 		const c = rest[k];
-		const hyphen = c === "-" && (rest[k + 1] === "-" || isSpace$4(rest[k - 1]) && isSpace$4(rest[k + 1]));
+		const hyphen = c === "-" && (rest[k + 1] === "-" || isSpace$3(rest[k - 1]) && isSpace$3(rest[k + 1]));
 		if (c === "," || DASHES.has(c) || hyphen) {
 			rest = rest.slice(0, k);
 			break;
@@ -33388,7 +33481,7 @@ function groupRows(rows, oldAnchors, newAnchors) {
 	});
 	return groups;
 }
-const FENCE$1 = /^ {0,3}(`{3,}|~{3,})/;
+const FENCE$2 = /^ {0,3}(`{3,}|~{3,})/;
 const HEADING = /^ {0,3}(#{1,3})(?:[ \t]+(.*?))?(?:[ \t]+#+)?[ \t]*$/;
 /**
 * The lines of a Markdown text that start a heading of level 1 to 3, with its text, skipping fenced
@@ -33398,7 +33491,7 @@ function markdownAnchors(text) {
 	const anchors = [];
 	let fence = null;
 	splitLines(text).lines.forEach((line, i) => {
-		const open = FENCE$1.exec(line);
+		const open = FENCE$2.exec(line);
 		if (fence !== null) {
 			if (open && open[1][0] === fence[0] && open[1].length >= fence.length && !line.slice(open[0].length).trim()) fence = null;
 			return;
@@ -33417,39 +33510,8 @@ function markdownAnchors(text) {
 	});
 	return anchors;
 }
-// ../markdown/src/meta.ts
-const OPENER = "<!-- drafter ";
-const CLOSER = " -->";
-function isSpace$3(code) {
-	return code === 32 || code === 9 || code === 10 || code === 13;
-}
-/**
-* The document's metadata block: its last line (trailing spaces and blank lines aside), starting
-* at the line's start (so not indented code) as `<!-- drafter `, ending ` -->`, and holding a JSON
-* object. Anything else, a comment with words after it, or one whose JSON doesn't read as an
-* object, is the writer's own text. One backwards scan, then one JSON parse: linear.
-*/
-function findMarkdownMeta(text) {
-	let end = text.length;
-	while (end > 0 && isSpace$3(text.charCodeAt(end - 1))) end--;
-	const from = text.lastIndexOf("\n", end - 1) + 1;
-	if (end - from < 17) return null;
-	if (!text.startsWith(OPENER, from) || !text.startsWith(CLOSER, end - 4)) return null;
-	let meta;
-	try {
-		meta = JSON.parse(text.slice(from + 13, end - 4));
-	} catch {
-		return null;
-	}
-	if (meta === null || typeof meta !== "object" || Array.isArray(meta)) return null;
-	return {
-		from,
-		to: end,
-		meta
-	};
-}
 // ../markdown/src/title.ts
-const isBlank = (c) => c === " " || c === "	";
+const isBlank$1 = (c) => c === " " || c === "	";
 /**
 * An ATX heading's parts, read by hand: up to three spaces, 1 to 6 `#` (`prefix`), then a space or
 * a tab or the line's end, and the text, without the blanks around it or a closing run of `#`s (one
@@ -33463,23 +33525,23 @@ function atx(line) {
 	if (hashes < 1 || hashes > 6) return void 0;
 	const prefix = line.slice(0, i + hashes);
 	i += hashes;
-	if (i < line.length && !isBlank(line[i])) return void 0;
+	if (i < line.length && !isBlank$1(line[i])) return void 0;
 	let start = i;
-	while (start < line.length && isBlank(line[start])) start++;
+	while (start < line.length && isBlank$1(line[start])) start++;
 	let end = line.length;
-	while (end > start && isBlank(line[end - 1])) end--;
+	while (end > start && isBlank$1(line[end - 1])) end--;
 	let close = end;
 	while (close > start && line[close - 1] === "#") close--;
-	if (close < end && (close === start || isBlank(line[close - 1]))) {
+	if (close < end && (close === start || isBlank$1(line[close - 1]))) {
 		end = close;
-		while (end > start && isBlank(line[end - 1])) end--;
+		while (end > start && isBlank$1(line[end - 1])) end--;
 	}
 	return {
 		prefix,
 		text: line.slice(start, end)
 	};
 }
-const FENCE = /^ {0,3}(`{3,}|~{3,})/;
+const FENCE$1 = /^ {0,3}(`{3,}|~{3,})/;
 const SETEXT = /^ {0,3}(?:=+|-+)[ \t]*$/;
 /**
 * The label of a footnote definition at a line's start, after any indentation, quote marks, and
@@ -33488,15 +33550,15 @@ const SETEXT = /^ {0,3}(?:=+|-+)[ \t]*$/;
 function definitionLabel(line) {
 	let i = 0;
 	for (;;) {
-		while (isBlank(line[i]) || line[i] === ">") i++;
+		while (isBlank$1(line[i]) || line[i] === ">") i++;
 		const c = line[i];
-		if ((c === "-" || c === "*" || c === "+") && isBlank(line[i + 1])) {
+		if ((c === "-" || c === "*" || c === "+") && isBlank$1(line[i + 1])) {
 			i++;
 			continue;
 		}
 		let j = i;
 		while (j - i < 9 && (line[j] ?? "") >= "0" && (line[j] ?? "") <= "9") j++;
-		if (j > i && (line[j] === "." || line[j] === ")") && isBlank(line[j + 1])) {
+		if (j > i && (line[j] === "." || line[j] === ")") && isBlank$1(line[j + 1])) {
 			i = j + 1;
 			continue;
 		}
@@ -33519,7 +33581,7 @@ function definedLabels(source) {
 		if (end < 0) end = source.length;
 		const line = source.slice(start, end);
 		start = end + 1;
-		const opens = FENCE.exec(line);
+		const opens = FENCE$1.exec(line);
 		if (fence !== void 0) {
 			if (opens?.[1]?.startsWith(fence.charAt(0)) && opens[1].length >= fence.length) fence = void 0;
 			continue;
@@ -33636,7 +33698,7 @@ function squeeze(text) {
 	for (let i = 0; i <= text.length; i++) {
 		const c = text[i];
 		const mark = c === "*" || c === "_" || c === "`";
-		const blank = c !== void 0 && !mark && isSpace$6(text.charCodeAt(i));
+		const blank = c !== void 0 && !mark && isSpace$5(text.charCodeAt(i));
 		if (c !== void 0 && !mark && !blank) {
 			if (from < 0) {
 				if (space && parts.length > 0) parts.push(" ");
@@ -33675,7 +33737,7 @@ function markdownTitle(source) {
 		if (end < 0) end = source.length;
 		const line = source.slice(start, end);
 		start = end + 1;
-		const opens = FENCE.exec(line);
+		const opens = FENCE$1.exec(line);
 		if (fence !== void 0) {
 			if (opens?.[1]?.startsWith(fence.charAt(0)) && opens[1].length >= fence.length) fence = void 0;
 			before = "";
@@ -33697,6 +33759,212 @@ function markdownTitle(source) {
 		before = line.trim() === "" || /^ {4}/.test(line) ? "" : line;
 	}
 }
+// ../novel/src/structure.ts
+const RANK = {
+	part: 0,
+	chapter: 1,
+	section: 2
+};
+const FENCE = /^ {0,3}(`{3,}|~{3,})/;
+const ATX = /^ {0,3}(#{1,6})(?:[ \t]([^\n]*))?$/;
+const BREAK = /^ {0,3}([-*_])(?:[ \t]*\1){2,}[ \t]*$/;
+const SETEXT_1 = /^ {0,3}=+[ \t]*$/;
+const SETEXT_2 = /^ {0,3}-+[ \t]*$/;
+const NOT_PARAGRAPH_START = /^(?: {4}|\t|<!--)/;
+const CONTAINER_START = /^ {0,3}(?:>|[-*+](?:[ \t]|$)|\d{1,9}[.)](?:[ \t]|$))/;
+const PART = /^part(?:\s|$)/i;
+function isBlank(char) {
+	return char === " " || char === "	" || char === "\r";
+}
+/** An ATX heading's text: trimmed, without a closing run of `#` (which a space or tab must precede). */
+function atxTitle(rest) {
+	let a = 0;
+	let b = rest.length;
+	while (a < b && isBlank(rest[a])) a++;
+	while (b > a && isBlank(rest[b - 1])) b--;
+	let c = b;
+	while (c > a && rest[c - 1] === "#") c--;
+	if (c < b && (c === a || isBlank(rest[c - 1]))) {
+		b = c;
+		while (b > a && isBlank(rest[b - 1])) b--;
+	}
+	return rest.slice(a, b);
+}
+function slug(title) {
+	return title.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "");
+}
+/** Reads a novel's structure in one pass. The metadata comment, and what it holds, is not read. */
+function novelStructure(text) {
+	const end = findMarkdownMeta(text)?.from ?? text.length;
+	const roots = [];
+	const seen = /* @__PURE__ */ new Map();
+	const stack = [];
+	let firstHeading = -1;
+	let fence = null;
+	let paraStart = -1;
+	let paraText = "";
+	let container = false;
+	const open = (wanted, title, from, to) => {
+		if (firstHeading < 0) firstHeading = from;
+		const top = stack.length > 0 ? stack[stack.length - 1].node.kind : null;
+		const kind = wanted === "section" && (top === null || top === "part") ? "chapter" : wanted;
+		while (stack.length > 0 && RANK[stack[stack.length - 1].node.kind] >= RANK[kind]) {
+			const done = stack.pop();
+			done.node.span.to = from;
+		}
+		const siblings = stack.length > 0 ? stack[stack.length - 1].node.children : roots;
+		const key = `${kind}:${slug(title)}`;
+		const n = seen.get(key) ?? 0;
+		seen.set(key, n + 1);
+		const node = {
+			id: `${key}:${n}`,
+			kind,
+			title,
+			heading: {
+				from,
+				to
+			},
+			span: {
+				from,
+				to: end
+			},
+			words: 0,
+			ownWords: 0,
+			children: []
+		};
+		siblings.push(node);
+		stack.push({ node });
+	};
+	let pos = 0;
+	while (pos < end) {
+		let eol = text.indexOf("\n", pos);
+		if (eol < 0 || eol > end) eol = end;
+		const next = eol < end ? eol + 1 : end;
+		let lineEnd = eol;
+		if (lineEnd > pos && text.charCodeAt(lineEnd - 1) === 13) lineEnd--;
+		const line = text.slice(pos, lineEnd);
+		const fenceMatch = FENCE.exec(line);
+		if (fence) {
+			if (fenceMatch && fenceMatch[1][0] === fence.char && fenceMatch[1].length >= fence.size && line.trim() === fenceMatch[1]) fence = null;
+			paraStart = -1;
+		} else if (fenceMatch && !(fenceMatch[1][0] === "`" && line.includes("`", fenceMatch[0].length))) {
+			fence = {
+				char: fenceMatch[1][0],
+				size: fenceMatch[1].length
+			};
+			paraStart = -1;
+		} else if (line.trim() === "") {
+			paraStart = -1;
+			container = false;
+		} else {
+			const atx = ATX.exec(line);
+			if (atx) {
+				paraStart = -1;
+				const level = atx[1].length;
+				if (level <= 2) {
+					const title = atxTitle(atx[2] ?? "");
+					open(level === 2 ? "section" : PART.test(title) ? "part" : "chapter", title, pos, lineEnd);
+				}
+			} else if (paraStart >= 0 && SETEXT_1.test(line)) {
+				open(PART.test(paraText) ? "part" : "chapter", paraText, paraStart, lineEnd);
+				paraStart = -1;
+			} else if (paraStart >= 0 && SETEXT_2.test(line)) {
+				open("section", paraText, paraStart, lineEnd);
+				paraStart = -1;
+			} else if (BREAK.test(line)) {
+				paraStart = -1;
+				if (stack.length > 0) open("section", "", pos, lineEnd);
+			} else if (CONTAINER_START.test(line)) {
+				paraStart = -1;
+				container = true;
+			} else if (container) {} else if (paraStart >= 0) paraText += ` ${line.trim()}`;
+			else if (!NOT_PARAGRAPH_START.test(line)) {
+				paraStart = pos;
+				paraText = line.trim();
+			}
+		}
+		pos = next;
+	}
+	const count = (node) => {
+		const own = node.children.length > 0 ? node.children[0].heading.from : node.span.to;
+		node.ownWords = wordsIn(node.title) + wordsIn(text.slice(node.heading.to, own));
+		let words = node.ownWords;
+		for (const child of node.children) {
+			count(child);
+			words += child.words;
+		}
+		node.words = words;
+	};
+	let words = 0;
+	for (const node of roots) {
+		count(node);
+		words += node.words;
+	}
+	const stop = firstHeading < 0 ? end : firstHeading;
+	const preamble = stop > 0 ? {
+		from: 0,
+		to: stop
+	} : null;
+	if (preamble) words += wordsIn(text.slice(0, stop));
+	return {
+		preamble,
+		parts: roots.some((n) => n.kind === "part"),
+		nodes: roots,
+		words
+	};
+}
+// ../novel/src/facts.ts
+const STATUSES = [
+	"todo",
+	"draft",
+	"revised",
+	"done"
+];
+/** The longest synopsis kept, in UTF-16 code units: a longer one is cut there when read or written. */
+const MAX_SYNOPSIS = 2e3;
+const MAX_TARGET = 1e7;
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function target(value) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= MAX_TARGET ? value : void 0;
+}
+function newNodes() {
+	return Object.create(null);
+}
+function readOne(raw) {
+	if (!isRecord(raw)) return null;
+	const facts = {};
+	const status = raw.status;
+	if (typeof status === "string" && STATUSES.includes(status)) facts.status = status;
+	if (typeof raw.synopsis === "string" && raw.synopsis !== "") {
+		let s = raw.synopsis.slice(0, MAX_SYNOPSIS);
+		const last = s.charCodeAt(s.length - 1);
+		if (last >= 55296 && last <= 56319) s = s.slice(0, -1);
+		facts.synopsis = s;
+	}
+	const t = target(raw.target);
+	if (t !== void 0) facts.target = t;
+	return Object.keys(facts).length > 0 ? facts : null;
+}
+/** The facts kept in a document's metadata comment; empty when there are none or they are unreadable. */
+function readFacts(text) {
+	const out = { nodes: newNodes() };
+	let novel;
+	try {
+		novel = readMarkdownMeta(text).meta?.novel;
+	} catch {
+		return out;
+	}
+	if (!isRecord(novel)) return out;
+	const bookTarget = target(novel.bookTarget);
+	if (bookTarget !== void 0) out.bookTarget = bookTarget;
+	if (isRecord(novel.nodes)) for (const id of Object.keys(novel.nodes)) {
+		const facts = readOne(novel.nodes[id]);
+		if (facts) out.nodes[id] = facts;
+	}
+	return out;
+}
 // src/formats.ts
 const NO_BYTES = /* @__PURE__ */ new Uint8Array();
 /**
@@ -33713,6 +33981,45 @@ function formatOf(name) {
 	return importKindOf(name) ?? reopenFormatOf(name, NO_BYTES);
 }
 // src/load.ts
+/** Whether the text's metadata comment names the novel template (Drafter's own file kind). */
+function isNovelText(text) {
+	try {
+		return readMarkdownMeta(text).meta?.template === "novel";
+	} catch {
+		return false;
+	}
+}
+/**
+* The title of a unit with none of its own. An untitled section is the one a scene break starts,
+* which the app calls "Scene break"; a part or chapter with an empty heading is named by its kind.
+*/
+const untitled = (kind) => kind === "section" ? "Scene break" : `(untitled ${kind})`;
+function flatten(nodes, into) {
+	for (const node of nodes) {
+		into.push(node);
+		flatten(node.children, into);
+	}
+	return into;
+}
+/**
+* A novel's units as comparison anchors (their heading lines from 0, as `markdownAnchors` gives
+* for plain Markdown), so drafts and compares number them as `read_scene` does.
+*/
+function novelAnchors(text) {
+	const { starts } = splitLines(text);
+	let line = 0;
+	return novelNodes(text).map((node) => {
+		while (line + 1 < starts.length && starts[line + 1] <= node.heading.from) line++;
+		return {
+			line,
+			title: node.title === "" ? untitled(node.kind) : node.title
+		};
+	});
+}
+/** A novel's parts, chapters, and sections in document order: the units every tool numbers. */
+function novelNodes(text) {
+	return flatten(novelStructure(text).nodes, []);
+}
 const NOT_READ = "Drafter for Claude doesn’t read that kind of file. It reads Fountain, plain text, Markdown, Final Draft, Highland, and Fade In files, and Drafter’s HTML and EPUB exports.";
 const SCREENPLAY$2 = builtins["us-screenplay"];
 let parses = 0;
@@ -33807,9 +34114,33 @@ function loadScript(file, format, content, text, importNotes, wordsPerMinute) {
 		importNotes
 	};
 }
+function loadNovel(file, format, content, text, end) {
+	const nodes = novelNodes(text);
+	const facts = readFacts(text).nodes;
+	return {
+		kind: "markdown",
+		file,
+		format,
+		content,
+		text,
+		title: markdownTitle(text) ?? null,
+		sections: nodes.map((node, i) => ({
+			title: node.title === "" ? untitled(node.kind) : node.title,
+			from: node.heading.from,
+			to: Math.min(end, nodes[i + 1]?.heading.from ?? end)
+		})),
+		novel: nodes.map((node) => ({
+			kind: node.kind,
+			words: node.words,
+			ownWords: node.ownWords,
+			...facts[node.id]
+		}))
+	};
+}
 function loadMarkdown(file, format, content, text) {
 	const meta = findMarkdownMeta(text);
 	const end = meta ? meta.from : text.length;
+	if (isNovelText(text)) return loadNovel(file, format, content, text, end);
 	const { starts } = splitLines(text);
 	const anchors = markdownAnchors(text).filter((anchor) => (starts[anchor.line] ?? 0) < end);
 	const sections = anchors.map((anchor, i) => {
@@ -33827,7 +34158,8 @@ function loadMarkdown(file, format, content, text) {
 		content,
 		text,
 		title: markdownTitle(text) ?? null,
-		sections
+		sections,
+		novel: null
 	};
 }
 /** The file a tool's path names, read and parsed (or the cached parse, while it is unchanged). */
@@ -34199,10 +34531,14 @@ function visibleMarkdownIn(text) {
 }
 // ../history/src/print.ts
 const SCREENPLAY$1 = builtins["us-screenplay"];
-/** The template `doc` names in its settings, else the screenplay. */
+/**
+* The template `doc` names in its settings, else the screenplay. Only a built-in's own name: a
+* script naming `constructor` or `__proto__` got the object's prototype, and Cuts and History
+* stopped reading it (red/blue audit, 2026-11-03).
+*/
 function templateOf(doc) {
 	const id = doc.meta?.template;
-	return (typeof id === "string" ? builtins[id] : void 0) ?? SCREENPLAY$1;
+	return typeof id === "string" && Object.hasOwn(builtins, id) ? builtins[id] : SCREENPLAY$1;
 }
 /**
 * A heading folded for matching: upper case, the locked number (`#12A#`) dropped, every dash
@@ -35942,7 +36278,24 @@ const overviewOutput = object({
 	sections: array(object({
 		n: number$1().int(),
 		title: string(),
-		words: number$1().int()
+		/** A novel's: the whole passage, its sections and chapters included. */
+		words: number$1().int(),
+		/** A novel's: the words before its first section or chapter. */
+		own_words: number$1().int().optional(),
+		kind: _enum([
+			"part",
+			"chapter",
+			"section"
+		]).optional(),
+		status: _enum([
+			"todo",
+			"draft",
+			"revised",
+			"done"
+		]).optional(),
+		synopsis: string().optional(),
+		synopsis_cut: literal(true).optional(),
+		target: number$1().int().optional()
 	})).optional(),
 	words: number$1().int().optional(),
 	left_out: leftOut,
@@ -36004,12 +36357,26 @@ function bounded(items, share, more) {
 const sectionWords = (text) => wordsIn(text.replace(/^ {0,3}#{1,3}(?=[ \t]|$)/, "").replace(/[ \t]+#+[ \t]*(?=\n|$)/, ""));
 function markdownOverview(loaded, args, ctx, include) {
 	const { text, sections } = loaded;
-	const items = sections.map((section, i) => ({
-		n: i + 1,
-		title: clipText(section.title, TEXT_LIMITS.heading).text,
-		words: sectionWords(visibleMarkdown(text, section.from, section.to))
-	}));
-	const words = wordsIn(visibleMarkdown(text, 0, sections[0]?.from ?? text.length)) + items.reduce((sum, s) => sum + s.words, 0);
+	const shown = visibleMarkdownIn(text);
+	const own = sections.map((section) => sectionWords(shown(section.from, section.to)));
+	const items = sections.map((section, i) => {
+		const unit = loaded.novel?.[i];
+		const synopsis = unit?.synopsis === void 0 ? void 0 : clipText(unit.synopsis, TEXT_LIMITS.synopsis);
+		return {
+			n: i + 1,
+			title: clipText(section.title, TEXT_LIMITS.heading).text,
+			words: unit ? unit.words : own[i],
+			...unit ? {
+				kind: unit.kind,
+				own_words: unit.ownWords,
+				...unit.status === void 0 ? {} : { status: unit.status },
+				...synopsis ? { synopsis: synopsis.text } : {},
+				...synopsis?.cut ? { synopsis_cut: true } : {},
+				...unit.target === void 0 ? {} : { target: unit.target }
+			} : {}
+		};
+	});
+	const words = wordsIn(shown(0, sections[0]?.from ?? text.length)) + items.reduce((sum, _s, i) => sum + own[i], 0);
 	const now = cursorBase("script_overview", loaded, {
 		script: args.script,
 		include
@@ -36173,7 +36540,7 @@ async function overview(args, ctx) {
 const scriptOverview = {
 	name: "script_overview",
 	title: "Script overview",
-	description: "The shape of one script: its title page (never the contact), template, pages, and running time; its acts with their synopses; every scene with its heading, place, time of day, act, page, length, synopsis, and who is in it; every character’s speeches, words, share of the talking, scenes, long absences, and who they are most often with; its places; what is still to be written; and a count of problems. For a Markdown document, its title and sections. Notes and the boneyard are left out unless include asks for them. Pass `next` back as `cursor` for more scenes. A field ending `_cut` means its text was too long and only its start is shown; one ending `_more` counts what didn’t fit.",
+	description: "The shape of one script: its title page (never the contact), template, pages, and running time; its acts with their synopses; every scene with its heading, place, time of day, act, page, length, synopsis, and who is in it; every character’s speeches, words, share of the talking, scenes, long absences, and who they are most often with; its places; what is still to be written; and a count of problems. For a Markdown document, its title and sections; for a novel, its parts, chapters, and sections, each with its words and the status, synopsis, and word target the writer keeps for it. Notes and the boneyard are left out unless include asks for them. Pass `next` back as `cursor` for more scenes. A field ending `_cut` means its text was too long and only its start is shown; one ending `_more` counts what didn’t fit.",
 	input: overviewInput,
 	output: overviewOutput,
 	run: overview
@@ -36609,7 +36976,8 @@ const listed = object({
 	kind: _enum([
 		"screenplay",
 		"stage play",
-		"markdown"
+		"markdown",
+		"novel"
 	]).nullable(),
 	title: string().nullable(),
 	/** The title was longer than TEXT_LIMITS.heading, and is its start. */
@@ -36667,11 +37035,12 @@ function scriptSummary(content, text) {
 	};
 }
 function markdownSummary(content, text) {
+	const novel = isNovelText(text);
 	return {
 		content,
-		kind: "markdown",
+		kind: novel ? "novel" : "markdown",
 		title: markdownTitle(text) ?? null,
-		scenes: markdownAnchors(text).length
+		scenes: novel ? novelNodes(text).length : markdownAnchors(text).length
 	};
 }
 const tooBig$1 = () => new Refused("it is too big");
@@ -36875,7 +37244,7 @@ async function describe(file, ctx, spend) {
 const listScripts = {
 	name: "list_scripts",
 	title: "List scripts",
-	description: "Lists the scripts, plays, and documents in the writer’s folders (or one folder, given as a path that starts with a folder’s name): each file’s path, kind, title, scene count, date, size, and how many drafts and cuts Drafter keeps beside it, with a manifest: what Drafter found inside each file (`content`), whether that matches its name (`matches_name`), and why Drafter won’t read it (`refused`). Pass `next` back as `cursor` for the rest.",
+	description: "Lists the scripts, plays, and documents in the writer’s folders (or one folder, given as a path that starts with a folder’s name): each file’s path, kind (screenplay, stage play, novel, or markdown), title, scene count, date, size, and how many drafts and cuts Drafter keeps beside it, with a manifest: what Drafter found inside each file (`content`), whether that matches its name (`matches_name`), and why Drafter won’t read it (`refused`). Pass `next` back as `cursor` for the rest.",
 	input,
 	output,
 	run
@@ -37955,11 +38324,11 @@ const draftsOutput = object({
 });
 const draftSummaries = new LoadCache(999);
 /** A draft's pages, scenes, and words: from its text, never returned. */
-function figures(text, kind) {
+function figures(text, kind, novel = false) {
 	if (kind === "markdown") return {
 		pages: null,
-		scenes: markdownAnchors(text).length,
-		words: wordsIn(text)
+		scenes: (novel ? novelAnchors(text) : markdownAnchors(text)).length,
+		words: wordsIn(markdownProse(text))
 	};
 	const doc = parse(text);
 	const template = templateFor(doc);
@@ -37972,7 +38341,7 @@ function figures(text, kind) {
 }
 /** Whether a draft's summary is kept already (so reading it again costs nothing). */
 const summarised = (file) => draftSummaries.get(file.real, file.size, file.mtimeMs) !== void 0;
-async function summaryOf(file, kind) {
+async function summaryOf(file, kind, novel = false) {
 	const cached = draftSummaries.get(file.real, file.size, file.mtimeMs);
 	if (cached !== void 0) return cached;
 	const read = await readDraft(file, kind);
@@ -37993,7 +38362,7 @@ async function summaryOf(file, kind) {
 				scenes: null,
 				words: null,
 				figures: false
-			} : figures(read.text, kind),
+			} : figures(read.text, kind, novel),
 			matches: read.matches
 		} };
 	}
@@ -38003,6 +38372,7 @@ async function summaryOf(file, kind) {
 async function listDrafts(args, ctx) {
 	const loaded = await load(args.script, ctx);
 	const kind = kindOf(loaded);
+	const isNovel = loaded.kind === "markdown" && loaded.novel !== null;
 	const files = await draftFiles(loaded, ctx);
 	const now = cursorBase("list_drafts", loaded, {
 		script: args.script,
@@ -38033,7 +38403,7 @@ async function listDrafts(args, ctx) {
 		const size = fresh ? checked.size : 0;
 		const parse = fresh && checked.size <= 5242880 ? checked.size : 0;
 		if (examined > 0 && (read + size > PAGE_READ_BYTES || parsed > 0 && parsed + parse > PAGE_PARSE_BYTES)) break;
-		const summary = checked ? await summaryOf(checked, kind) : null;
+		const summary = checked ? await summaryOf(checked, kind, isNovel) : null;
 		read += size;
 		parsed += parse;
 		if (!summary) {
@@ -38231,7 +38601,7 @@ async function compareDrafts(args, ctx) {
 		left.notes += shown.leftOut.notes;
 		left.boneyard += shown.leftOut.boneyard;
 	}
-	const anchorsOf = kind === "markdown" ? markdownAnchors : sceneAnchors;
+	const anchorsOf = kind !== "markdown" ? sceneAnchors : loaded.kind === "markdown" && loaded.novel !== null ? novelAnchors : markdownAnchors;
 	const oldAnchors = anchorsOf(shownOld.text);
 	const newAnchors = anchorsOf(shownNew.text);
 	const { rows } = diffRows(shownOld.text, shownNew.text, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafter-mcp",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Drafter for Claude: a local, read-only MCP server that lets an AI app read the scripts in the folders the writer names.",
   "license": "MIT",
   "type": "module",