dsh-novel-write-engine 0.2.5 → 0.2.7

package/lib/index.js

@@ -14,7 +14,7 @@ const PLUGIN_NAME = "dsh-novel-write-engine";
 const PANEL_ID = "novel-workshop";
 const PANEL_ROUTE = "/api/novel-write-engine/panel";
 const SKILL_NAME = "novel-write-engine";
-const REMOTE_VERSION = 5;
+const REMOTE_VERSION = 6;
 /** The panel is a recent-history view; the wire payload and UI use one cap. */
 const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */
@@ -523,9 +523,61 @@ function applyExclusions(dimensions, exclusions) {
 function splitParagraphs(text) {
 	return text.split(/\n+/).map((line) => line.trim()).filter((line) => line !== "");
 }
+const SENTENCE_TERMINATOR = /[。！？!?]+|…+|\.(?=\s|$)/g;
+const SENTENCE_CLOSERS = /* @__PURE__ */ new Set([
+	"」",
+	"』",
+	"”",
+	"\"",
+	"’",
+	"'",
+	"）",
+	")",
+	"】",
+	"]"
+]);
+/**
+* Sentence boundaries have one owner. This offset-preserving variant is used
+* by semantic evidence and any caller that must map a quote back to a
+* paragraph; `splitSentences` is the string-only convenience view of it.
+*/
+function splitSentenceSpans(text) {
+	const spans = [];
+	let paragraph = 1;
+	let lineStart = 0;
+	while (lineStart <= text.length) {
+		const newline = text.indexOf("\n", lineStart);
+		const lineEnd = newline === -1 ? text.length : newline;
+		const line = text.slice(lineStart, lineEnd);
+		if (line.trim() !== "") {
+			let cursor = 0;
+			while (cursor < line.length) {
+				SENTENCE_TERMINATOR.lastIndex = cursor;
+				const match = SENTENCE_TERMINATOR.exec(line);
+				let rawEnd = match === null ? line.length : match.index + match[0].length;
+				while (rawEnd < line.length && SENTENCE_CLOSERS.has(line[rawEnd])) rawEnd += 1;
+				let start = cursor;
+				while (start < rawEnd && /\s/.test(line[start])) start += 1;
+				const body = line.slice(start, rawEnd).trimEnd();
+				const end = start + body.length;
+				if (body !== "") spans.push({
+					start: lineStart + start,
+					end: lineStart + end,
+					paragraph,
+					text: body
+				});
+				cursor = rawEnd;
+			}
+			paragraph += 1;
+		}
+		if (newline === -1) break;
+		lineStart = newline + 1;
+	}
+	return spans;
+}
 /** Sentence splitting uses Chinese and English terminators; empty runs collapse. */
 function splitSentences(text) {
-	return text.split(/[。！？!?]+|…+|\.(?=\s|$)/).map((sentence) => sentence.trim()).filter((sentence) => sentence !== "");
+	return splitSentenceSpans(text).map((span) => span.text.replace(/([。！？!?]+|…+|\.)$/u, "").replace(/[」』”"'’）)】\]]+$/u, "").trim()).filter((sentence) => sentence !== "");
 }
 /** Character length of each sentence, in document order. */
 function sentenceLengths(sentences) {
@@ -627,6 +679,30 @@ function similarity(a, b) {
 function textSimilarity(a, b) {
 	return similarity(simhash(a), simhash(b));
 }
+/** Character-bigram Dice similarity; unlike SimHash this has a ~0 baseline for unrelated short text. */
+function bigramSimilarity(a, b) {
+	const grams = (text) => {
+		const chars = Array.from(text.replace(/\s+/g, ""));
+		if (chars.length < 2) return chars.length === 0 ? [] : [chars[0]];
+		const result = [];
+		for (let index = 0; index + 1 < chars.length; index += 1) result.push(chars[index] + chars[index + 1]);
+		return result;
+	};
+	const left = grams(a);
+	const right = grams(b);
+	if (left.length === 0 || right.length === 0) return 0;
+	const counts = /* @__PURE__ */ new Map();
+	for (const gram of left) counts.set(gram, (counts.get(gram) ?? 0) + 1);
+	let intersection = 0;
+	for (const gram of right) {
+		const count = counts.get(gram) ?? 0;
+		if (count > 0) {
+			counts.set(gram, count - 1);
+			intersection += 1;
+		}
+	}
+	return 2 * intersection / (left.length + right.length);
+}
 // src/domain/transitions.ts
 /**
 * The single definition of allowed progress. The engine queries this table
@@ -1968,31 +2044,31 @@ const SCHEMAS = {
 		themes: req("array")
 	}
 };
-const invalid$1 = (kind, detail) => {
+const invalid$2 = (kind, detail) => {
 	throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `invalid ${kind} document: ${detail}`);
 };
 const objectAt = (kind, value, path) => {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) return invalid$1(kind, `${path} must be an object`);
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return invalid$2(kind, `${path} must be an object`);
 	return value;
 };
 const listAt = (kind, value, path) => {
-	if (!Array.isArray(value)) return invalid$1(kind, `${path} must be an array`);
+	if (!Array.isArray(value)) return invalid$2(kind, `${path} must be an array`);
 	return value;
 };
 const stringAt = (kind, value, path) => {
-	if (typeof value !== "string") return invalid$1(kind, `${path} must be a string`);
+	if (typeof value !== "string") return invalid$2(kind, `${path} must be a string`);
 	return value;
 };
 const numberAt = (kind, value, path) => {
-	if (typeof value !== "number" || !Number.isFinite(value)) return invalid$1(kind, `${path} must be a number`);
+	if (typeof value !== "number" || !Number.isFinite(value)) return invalid$2(kind, `${path} must be a number`);
 	return value;
 };
 const integerAt = (kind, value, path) => {
-	if (typeof value !== "number" || !Number.isInteger(value)) return invalid$1(kind, `${path} must be an integer`);
+	if (typeof value !== "number" || !Number.isInteger(value)) return invalid$2(kind, `${path} must be an integer`);
 	return value;
 };
 const booleanAt = (kind, value, path) => {
-	if (typeof value !== "boolean") return invalid$1(kind, `${path} must be a boolean`);
+	if (typeof value !== "boolean") return invalid$2(kind, `${path} must be a boolean`);
 	return value;
 };
 const optionalString = (kind, value, path) => {
@@ -2015,10 +2091,19 @@ const duplicateNames = (kind, rows, path, nameOf) => {
 	for (const row of rows) {
 		const name = nameOf(row);
 		if (typeof name !== "string" || name === "") continue;
-		if (seen.has(name)) invalid$1(kind, `${path} contains duplicate name "${name}"`);
+		if (seen.has(name)) invalid$2(kind, `${path} contains duplicate name "${name}"`);
 		seen.add(name);
 	}
 };
+const validateAnchorList = (kind, value, path) => {
+	if (value === void 0) return;
+	const anchors = listAt(kind, value, path);
+	if (anchors.length > 8) invalid$2(kind, `${path} may contain at most 8 anchors`);
+	for (const [index, anchor] of anchors.entries()) {
+		const text = stringAt(kind, anchor, `${path}[${index}]`).trim();
+		if (text.length < 2 || Array.from(text).length > 120) invalid$2(kind, `${path}[${index}] must contain 2..120 characters`);
+	}
+};
 const validateSummary = (kind, value, path) => {
 	const summary = objectAt(kind, value, path);
 	for (const key of [
@@ -2033,6 +2118,18 @@ const validateSummary = (kind, value, path) => {
 		"resolved"
 	]) listAt(kind, foreshadows[key], `${path}.foreshadows.${key}`);
 	objectAt(kind, summary.new_elements, `${path}.new_elements`);
+	if (summary.new_element_anchors !== void 0) {
+		const anchorMap = objectAt(kind, summary.new_element_anchors, `${path}.new_element_anchors`);
+		for (const group of Object.keys(anchorMap)) {
+			if (![
+				"locations",
+				"abilities",
+				"artifacts"
+			].includes(group)) invalid$2(kind, `${path}.new_element_anchors has unknown group "${group}"`);
+			const entries = objectAt(kind, anchorMap[group], `${path}.new_element_anchors.${group}`);
+			for (const [name, anchors] of Object.entries(entries)) validateAnchorList(kind, anchors, `${path}.new_element_anchors.${group}.${name}`);
+		}
+	}
 	listAt(kind, summary.resource_changes, `${path}.resource_changes`);
 	stringAt(kind, summary.opening, `${path}.opening`);
 	const continuity = objectAt(kind, summary.continuity, `${path}.continuity`);
@@ -2047,7 +2144,7 @@ const validateNested = (kind, record) => {
 			const targets = objectAt(kind, record.targets, "targets");
 			for (const key of ["words_per_chapter", "dialogue_ratio"]) {
 				const pair = listAt(kind, targets[key], `targets.${key}`);
-				if (pair.length !== 2) invalid$1(kind, `targets.${key} must contain two numbers`);
+				if (pair.length !== 2) invalid$2(kind, `targets.${key} must contain two numbers`);
 				for (const [index, item] of pair.entries()) numberAt(kind, item, `targets.${key}[${index}]`);
 			}
 			if (targets.total_chapters !== null) integerAt(kind, targets.total_chapters, "targets.total_chapters");
@@ -2123,13 +2220,14 @@ const validateNested = (kind, record) => {
 				stringAt(kind, row.layout, `${path}.layout`);
 				numberAt(kind, row.capacity, `${path}.capacity`);
 				listAt(kind, row.changes, `${path}.changes`);
+				validateAnchorList(kind, row.anchors, `${path}.anchors`);
 			});
 			for (const key of [
 				"abilities",
 				"artifacts",
 				"factions",
 				"rules"
-			]) listAt(kind, record[key], key);
+			]) for (const [index, row] of listAt(kind, record[key], key).entries()) if (typeof row === "object" && row !== null && !Array.isArray(row)) validateAnchorList(kind, row.anchors, `${key}[${index}].anchors`);
 			{
 				const names = [];
 				for (const key of [
@@ -2142,7 +2240,7 @@ const validateNested = (kind, record) => {
 					const rows = Array.isArray(record[key]) ? record[key] : [];
 					for (const row of rows) if (typeof row.name === "string") names.push(row.name);
 				}
-				if (new Set(names).size !== names.length) invalid$1(kind, "world entities must have unique names");
+				if (new Set(names).size !== names.length) invalid$2(kind, "world entities must have unique names");
 			}
 			return;
 		case "locks": {
@@ -2213,7 +2311,7 @@ const validateNested = (kind, record) => {
 			validateRecords(kind, semantic.items, "semantic.items", (row, path) => {
 				stringAt(kind, row.id, `${path}.id`);
 				const verdict = stringAt(kind, row.verdict, `${path}.verdict`);
-				if (verdict !== "pass" && verdict !== "fail") invalid$1(kind, `${path}.verdict must be pass|fail`);
+				if (verdict !== "pass" && verdict !== "fail") invalid$2(kind, `${path}.verdict must be pass|fail`);
 				stringAt(kind, row.evidence, `${path}.evidence`);
 				if (row.note !== void 0) stringAt(kind, row.note, `${path}.note`);
 			});
@@ -2262,11 +2360,11 @@ const validateNested = (kind, record) => {
 					"notes",
 					"status"
 				]) stringAt(kind, row[key], `${path}.${key}`);
-				if (!SCENE_TYPES.includes(row.scene_type)) invalid$1(kind, `${path}.scene_type must be one of ${SCENE_TYPES.join(", ")}`);
-				if (row.status !== "planned" && row.status !== "archived") invalid$1(kind, `${path}.status must be planned|archived`);
+				if (!SCENE_TYPES.includes(row.scene_type)) invalid$2(kind, `${path}.scene_type must be one of ${SCENE_TYPES.join(", ")}`);
+				if (row.status !== "planned" && row.status !== "archived") invalid$2(kind, `${path}.status must be planned|archived`);
 				for (const [index, name] of listAt(kind, row.cast, `${path}.cast`).entries()) stringAt(kind, name, `${path}.cast[${index}]`);
 				const target = listAt(kind, row.target_words, `${path}.target_words`);
-				if (target.length !== 2) invalid$1(kind, `${path}.target_words must contain two integers`);
+				if (target.length !== 2) invalid$2(kind, `${path}.target_words must contain two integers`);
 				for (const [index, item] of target.entries()) integerAt(kind, item, `${path}.target_words[${index}]`);
 				nullableString(kind, row.archived_at, `${path}.archived_at`);
 				nullableNumber(kind, row.word_count, `${path}.word_count`);
@@ -2323,9 +2421,9 @@ const validateNested = (kind, record) => {
 			validateRecords(kind, record.issues, "issues", (row, path) => {
 				stringAt(kind, row.id, `${path}.id`);
 				const severity = stringAt(kind, row.severity, `${path}.severity`);
-				if (severity !== "blocker" && severity !== "advisory") invalid$1(kind, `${path}.severity must be blocker|advisory`);
+				if (severity !== "blocker" && severity !== "advisory") invalid$2(kind, `${path}.severity must be blocker|advisory`);
 				const status = stringAt(kind, row.status, `${path}.status`);
-				if (status !== "open" && status !== "fixed" && status !== "waived") invalid$1(kind, `${path}.status must be open|fixed|waived`);
+				if (status !== "open" && status !== "fixed" && status !== "waived") invalid$2(kind, `${path}.status must be open|fixed|waived`);
 				for (const field of [
 					"dimension",
 					"location",
@@ -2358,26 +2456,26 @@ const matchesType = (value, field) => {
 * user upgrades instead of the engine rewriting their data.
 */
 function narrow(kind, value) {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) invalid$1(kind, "not an object");
+	if (typeof value !== "object" || value === null || Array.isArray(value)) invalid$2(kind, "not an object");
 	const record = value;
 	const version = record.schema_version;
-	if (typeof version !== "number" || !Number.isInteger(version)) return invalid$1(kind, "missing schema_version");
+	if (typeof version !== "number" || !Number.isInteger(version)) return invalid$2(kind, "missing schema_version");
 	if (version > 1) throw new EngineFaultError(ERROR_CODES.SCHEMA_TOO_NEW, `refusing ${kind}: schema_version ${version} is newer than supported 1`, "upgrade the plugin; the file was left untouched");
-	if (version !== 1) invalid$1(kind, `unsupported schema_version ${version}`);
-	if (!Object.hasOwn(SCHEMAS, kind)) invalid$1(kind, `unknown document kind "${String(kind)}"`);
+	if (version !== 1) invalid$2(kind, `unsupported schema_version ${version}`);
+	if (!Object.hasOwn(SCHEMAS, kind)) invalid$2(kind, `unknown document kind "${String(kind)}"`);
 	const schema = SCHEMAS[kind];
 	for (const key of Object.keys(record)) {
 		if (key === "schema_version") continue;
-		if (!Object.hasOwn(schema, key)) invalid$1(kind, `unknown key "${key}"`);
+		if (!Object.hasOwn(schema, key)) invalid$2(kind, `unknown key "${key}"`);
 	}
 	for (const [key, field] of Object.entries(schema)) {
 		const fieldValue = record[key];
 		if (fieldValue === void 0) {
-			if (field.required === true) invalid$1(kind, `missing required key "${key}"`);
+			if (field.required === true) invalid$2(kind, `missing required key "${key}"`);
 			continue;
 		}
-		if (!matchesType(fieldValue, field)) invalid$1(kind, `"${key}" must be ${field.type}`);
-		if (field.enum !== void 0 && !field.enum.includes(fieldValue)) invalid$1(kind, `"${key}" must be one of ${field.enum.join(", ")}`);
+		if (!matchesType(fieldValue, field)) invalid$2(kind, `"${key}" must be ${field.type}`);
+		if (field.enum !== void 0 && !field.enum.includes(fieldValue)) invalid$2(kind, `"${key}" must be one of ${field.enum.join(", ")}`);
 	}
 	validateNested(kind, record);
 	return record;
@@ -3944,7 +4042,7 @@ const wordPair = (value, where) => {
 	if (!Number.isInteger(min) || !Number.isInteger(max) || min <= 0 || max < min) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} must be [min, max] positive integers with min <= max`);
 	return [min, max];
 };
-const isRecord$2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /** Remove a leading 第N章 prefix; stored titles are bodies. */
 function stripChapterPrefix(title) {
 	return title.replace(LENIENT_TITLE_PREFIX$1, "").trim();
@@ -4046,7 +4144,7 @@ const BOOK_PATCH_KEYS = /* @__PURE__ */ new Set([
 /** Apply a partial book patch; omitted fields keep their existing value. */
 function mergeBookPlan(existing, patch) {
 	if (patch === void 0) return { ...existing };
-	if (!isRecord$2(patch)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "book must be an object");
+	if (!isRecord$3(patch)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "book must be an object");
 	for (const key of Object.keys(patch)) if (!BOOK_PATCH_KEYS.has(key)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `book has unknown field "${key}"`, `allowed: ${[...BOOK_PATCH_KEYS].join(", ")}`);
 	const result = { ...existing };
 	for (const key of [
@@ -4074,7 +4172,7 @@ function normalizeVolumes(input, options = { totalChapters: null }) {
 	if (!Array.isArray(input)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "volumes must be an array");
 	if (input.length > LIMITS.maxOutlineVolumes) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes contains ${input.length} items; limit is ${LIMITS.maxOutlineVolumes}`);
 	const volumes = input.map((raw, index) => {
-		if (!isRecord$2(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}] must be an object`);
+		if (!isRecord$3(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}] must be an object`);
 		const start = positiveInteger$1(raw.start_chapter, `volumes[${index}].start_chapter`);
 		const end = positiveInteger$1(raw.end_chapter, `volumes[${index}].end_chapter`);
 		if (end < start) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}] end_chapter ${end} is before start_chapter ${start}`);
@@ -4191,7 +4289,7 @@ function normalizeOutlineChapters(input, options) {
 	const archived = new Map(options.archived.map((record) => [record.num, record]));
 	const normalized = /* @__PURE__ */ new Map();
 	for (const [index, raw] of input.entries()) {
-		if (!isRecord$2(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters[${index}] must be an object`);
+		if (!isRecord$3(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters[${index}] must be an object`);
 		const num = positiveInteger$1(raw.num, `chapters[${index}].num`);
 		if (options.totalChapters !== null && num > options.totalChapters) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} exceeds total_chapters ${options.totalChapters}`, "raise total_chapters with novel_blueprint before planning a longer book");
 		if (normalized.has(num)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} appears more than once`);
@@ -4265,7 +4363,7 @@ function normalizeOutlineChapters(input, options) {
 }
 /** Validate a document loaded from disk. Throws a fault, not an input error. */
 function validateOutlineDocument(value, options) {
-	if (!isRecord$2(value)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml must be a mapping");
+	if (!isRecord$3(value)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml must be a mapping");
 	try {
 		if (value.schema_version !== 1) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline/outline.yaml schema_version must be 1, got ${String(value.schema_version)}`);
 		const allowedTopLevel = /* @__PURE__ */ new Set([
@@ -4277,7 +4375,7 @@ function validateOutlineDocument(value, options) {
 		]);
 		for (const key of Object.keys(value)) if (!allowedTopLevel.has(key)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline/outline.yaml has unknown key "${key}"`);
 		if (typeof value.updated_at !== "string" || value.updated_at.trim() === "") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml updated_at must be a string");
-		if (!isRecord$2(value.book)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml book must be a mapping");
+		if (!isRecord$3(value.book)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml book must be a mapping");
 		const allowedBook = /* @__PURE__ */ new Set([
 			"premise",
 			"logline",
@@ -4301,7 +4399,7 @@ function validateOutlineDocument(value, options) {
 		const chapters = [];
 		const seen = /* @__PURE__ */ new Set();
 		for (const [index, raw] of value.chapters.entries()) {
-			if (!isRecord$2(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters[${index}] must be an object`);
+			if (!isRecord$3(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters[${index}] must be an object`);
 			const num = positiveInteger$1(raw.num, `chapters[${index}].num`);
 			if (options.totalChapters !== null && num > options.totalChapters) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} exceeds total_chapters ${options.totalChapters}`);
 			if (seen.has(num)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} appears more than once`);
@@ -4367,7 +4465,7 @@ function mergeWorldbook(existing, patch, now) {
 		...existing,
 		updated_at: now
 	};
-	if (!isRecord$2(patch)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "worldbook must be an object");
+	if (!isRecord$3(patch)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "worldbook must be an object");
 	const result = {
 		...existing,
 		updated_at: now,
@@ -4387,7 +4485,7 @@ function mergeWorldbook(existing, patch, now) {
 		if (!Array.isArray(value)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${key} must be an array`);
 		if (value.length > LIMITS.maxWorldbookEntries) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${key} contains ${value.length} items; limit is ${LIMITS.maxWorldbookEntries}`);
 		return value.map((raw, index) => {
-			if (!isRecord$2(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${key}[${index}] must be an object`);
+			if (!isRecord$3(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${key}[${index}] must be an object`);
 			return raw;
 		});
 	};
@@ -4467,7 +4565,7 @@ function mergeWorldbook(existing, patch, now) {
 }
 /** Validate a worldbook loaded from disk. */
 function validateWorldbookDocument(value, now) {
-	if (!isRecord$2(value)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "outline/worldbook.yaml must be a mapping");
+	if (!isRecord$3(value)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "outline/worldbook.yaml must be a mapping");
 	try {
 		if (value.schema_version !== 1) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline/worldbook.yaml schema_version must be 1, got ${String(value.schema_version)}`);
 		const allowedTopLevel = /* @__PURE__ */ new Set([
@@ -4878,7 +4976,7 @@ function parseOutlineData(content, format) {
 	} catch (error) {
 		throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline ${format} is invalid: ${error instanceof Error ? error.message : String(error)}`);
 	}
-	if (!isRecord$2(parsed)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline ${format} must be a mapping`);
+	if (!isRecord$3(parsed)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline ${format} must be a mapping`);
 	if (parsed.schema_version !== void 0 && parsed.schema_version !== 1) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline ${format} schema_version must be 1, got ${String(parsed.schema_version)}`);
 	const warnings = [];
 	const allowed = /* @__PURE__ */ new Set([
@@ -4909,19 +5007,19 @@ function parseOutlineInput(content, format) {
 	};
 }
 /** One-line Markdown field; a newline would turn into an unknown import line. */
-const oneLine = (value) => value.replace(/\s+/g, " ").trim();
+const oneLine$1 = (value) => value.replace(/\s+/g, " ").trim();
 /** Export helper: a human-readable outline in the import template's shape. */
 function renderOutlineMarkdown(project, document, chapters) {
-	const parts = [`# ${oneLine(project.title)}`, ""];
-	if (document.book.logline !== "") parts.push(`> ${oneLine(document.book.logline)}`, "");
+	const parts = [`# ${oneLine$1(project.title)}`, ""];
+	if (document.book.logline !== "") parts.push(`> ${oneLine$1(document.book.logline)}`, "");
 	const fields = [
-		["前提", oneLine(document.book.premise)],
-		["主题", document.book.themes.map(oneLine).join("、")],
-		["基调", oneLine(document.book.tone)],
-		["视角", oneLine(document.book.pov)],
-		["读者", oneLine(document.book.audience)],
-		["卖点", document.book.selling_points.map(oneLine).join("、")],
-		["结局", oneLine(document.book.ending)],
+		["前提", oneLine$1(document.book.premise)],
+		["主题", document.book.themes.map(oneLine$1).join("、")],
+		["基调", oneLine$1(document.book.tone)],
+		["视角", oneLine$1(document.book.pov)],
+		["读者", oneLine$1(document.book.audience)],
+		["卖点", document.book.selling_points.map(oneLine$1).join("、")],
+		["结局", oneLine$1(document.book.ending)],
 		["严格", document.book.strict ? "true" : "false"]
 	];
 	for (const [key, value] of fields) if (value !== "") parts.push(`${key}：${value}`);
@@ -4930,12 +5028,12 @@ function renderOutlineMarkdown(project, document, chapters) {
 	const outside = document.chapters.filter((card) => !document.volumes.some((volume) => card.num >= volume.start_chapter && card.num <= volume.end_chapter));
 	for (const card of outside) parts.push(...renderCard(card, archived.get(card.num)));
 	for (const volume of document.volumes) {
-		parts.push(`## ${oneLine(volume.title)}（第${volume.start_chapter}-${volume.end_chapter}章）`);
-		parts.push(`编号：${oneLine(volume.id)}`);
+		parts.push(`## ${oneLine$1(volume.title)}（第${volume.start_chapter}-${volume.end_chapter}章）`);
+		parts.push(`编号：${oneLine$1(volume.id)}`);
 		parts.push(`状态：${volume.status}`);
-		if (volume.goal !== "") parts.push(`目标：${oneLine(volume.goal)}`);
-		if (volume.arc !== "") parts.push(`弧线：${oneLine(volume.arc)}`);
-		if (volume.climax !== "") parts.push(`高潮：${oneLine(volume.climax)}`);
+		if (volume.goal !== "") parts.push(`目标：${oneLine$1(volume.goal)}`);
+		if (volume.arc !== "") parts.push(`弧线：${oneLine$1(volume.arc)}`);
+		if (volume.climax !== "") parts.push(`高潮：${oneLine$1(volume.climax)}`);
 		parts.push("");
 		const cards = document.chapters.filter((card) => card.num >= volume.start_chapter && card.num <= volume.end_chapter);
 		for (const card of cards) parts.push(...renderCard(card, archived.get(card.num)));
@@ -4944,15 +5042,15 @@ function renderOutlineMarkdown(project, document, chapters) {
 }
 const renderCard = (card, record) => {
 	const lines = [
-		`### 第${card.num}章 ${oneLine(card.title)}`,
+		`### 第${card.num}章 ${oneLine$1(card.title)}`,
 		`场景：${card.scene_type}`,
 		`字数：${card.target_words[0]}-${card.target_words[1]}`,
-		`角色：${card.cast.map(oneLine).join("、")}`,
-		`目标：${oneLine(card.goal)}`,
-		`冲突：${oneLine(card.conflict)}`,
-		`钩子：${oneLine(card.hook)}`
+		`角色：${card.cast.map(oneLine$1).join("、")}`,
+		`目标：${oneLine$1(card.goal)}`,
+		`冲突：${oneLine$1(card.conflict)}`,
+		`钩子：${oneLine$1(card.hook)}`
 	];
-	if (card.notes !== "") lines.push(`备注：${oneLine(card.notes)}`);
+	if (card.notes !== "") lines.push(`备注：${oneLine$1(card.notes)}`);
 	if (card.status === "archived" && record !== void 0) lines.push(`归档：${record.word_count} 字 / ${record.score} 分`);
 	lines.push("");
 	return lines;
@@ -4964,20 +5062,20 @@ function renderWorldbookMarkdown(project, document) {
 		if (lines.length === 0) return;
 		parts.push(`## ${title}`, "", ...lines, "");
 	};
-	if (document.premise !== "") section("一句话", [oneLine(document.premise)]);
-	if (document.setting !== "") section("世界设定", [oneLine(document.setting)]);
-	if (document.themes.length > 0) section("主题", [document.themes.map(oneLine).join("、")]);
-	section("规则", document.rules.map((entry) => `- **${oneLine(entry.name)}**：${oneLine(entry.description)}`));
-	section("势力", document.factions.map((entry) => entry.goal === "" ? `- **${oneLine(entry.name)}**：${oneLine(entry.description)}` : `- **${oneLine(entry.name)}**：${oneLine(entry.description)}（目标：${oneLine(entry.goal)}）`));
-	section("地点", document.locations.map((entry) => `- **${oneLine(entry.name)}**：${oneLine(entry.description)}${entry.layout === "" ? "" : `；布局：${oneLine(entry.layout)}`}${entry.capacity === 0 ? "" : `；容量：${entry.capacity}`}`));
-	section("角色", document.characters.map((entry) => `- **${oneLine(entry.name)}**（${oneLine(entry.role)}）：${oneLine(entry.description)}${entry.arc === "" ? "" : `；弧线：${oneLine(entry.arc)}`}`));
-	section("术语", document.glossary.map((entry) => `- **${oneLine(entry.term)}**：${oneLine(entry.definition)}`));
-	section("前史", document.backstory.map((entry) => `- ${oneLine(entry.time)}：${oneLine(entry.event)}`));
-	section("数值事实", (document.facts ?? []).map((fact) => `- **${oneLine(fact.alias)}**：${fact.value}${oneLine(fact.unit)}${fact.tolerance === void 0 ? "" : `（容差 ${fact.tolerance}）`}${fact.note === void 0 || fact.note === "" ? "" : `；${oneLine(fact.note)}`}`));
+	if (document.premise !== "") section("一句话", [oneLine$1(document.premise)]);
+	if (document.setting !== "") section("世界设定", [oneLine$1(document.setting)]);
+	if (document.themes.length > 0) section("主题", [document.themes.map(oneLine$1).join("、")]);
+	section("规则", document.rules.map((entry) => `- **${oneLine$1(entry.name)}**：${oneLine$1(entry.description)}`));
+	section("势力", document.factions.map((entry) => entry.goal === "" ? `- **${oneLine$1(entry.name)}**：${oneLine$1(entry.description)}` : `- **${oneLine$1(entry.name)}**：${oneLine$1(entry.description)}（目标：${oneLine$1(entry.goal)}）`));
+	section("地点", document.locations.map((entry) => `- **${oneLine$1(entry.name)}**：${oneLine$1(entry.description)}${entry.layout === "" ? "" : `；布局：${oneLine$1(entry.layout)}`}${entry.capacity === 0 ? "" : `；容量：${entry.capacity}`}`));
+	section("角色", document.characters.map((entry) => `- **${oneLine$1(entry.name)}**（${oneLine$1(entry.role)}）：${oneLine$1(entry.description)}${entry.arc === "" ? "" : `；弧线：${oneLine$1(entry.arc)}`}`));
+	section("术语", document.glossary.map((entry) => `- **${oneLine$1(entry.term)}**：${oneLine$1(entry.definition)}`));
+	section("前史", document.backstory.map((entry) => `- ${oneLine$1(entry.time)}：${oneLine$1(entry.event)}`));
+	section("数值事实", (document.facts ?? []).map((fact) => `- **${oneLine$1(fact.alias)}**：${fact.value}${oneLine$1(fact.unit)}${fact.tolerance === void 0 ? "" : `（容差 ${fact.tolerance}）`}${fact.note === void 0 || fact.note === "" ? "" : `；${oneLine$1(fact.note)}`}`));
 	return parts.join("\n");
 }
 // src/engine/outline-merge.ts
-const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const text$1 = (value, where) => {
 	if (typeof value !== "string" || value.trim() === "") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} must be a non-empty string`);
 	return value.trim();
@@ -5012,7 +5110,7 @@ const submittedNumbers = (input) => {
 	const result = /* @__PURE__ */ new Set();
 	if (!Array.isArray(input)) return result;
 	for (const raw of input) {
-		if (!isRecord$1(raw) || !Number.isInteger(raw.num) || raw.num < 1) continue;
+		if (!isRecord$2(raw) || !Number.isInteger(raw.num) || raw.num < 1) continue;
 		result.add(raw.num);
 	}
 	return result;
@@ -5051,7 +5149,7 @@ const mergeVolumes = (options) => {
 	};
 	const submitted = /* @__PURE__ */ new Set();
 	for (const [index, raw] of (options.volumes ?? []).entries()) {
-		if (!isRecord$1(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}] must be an object`);
+		if (!isRecord$2(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}] must be an object`);
 		const title = text$1(raw.title, `volumes[${index}].title`);
 		if (submitted.has(title)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes contains duplicate title "${title}"`);
 		submitted.add(title);
@@ -5205,6 +5303,120 @@ const mergeOutline = (options) => {
 		volumes_removed: volumeChanges.removed
 	};
 };
+// src/engine/entity-anchors.ts
+/** The three `summary.new_elements` groups that may carry anchors. */
+const NEW_ELEMENT_GROUPS = [
+	"locations",
+	"abilities",
+	"artifacts"
+];
+const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const invalid$1 = (detail) => {
+	throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, detail, "new_element_anchors maps each new entity name to 1..8 verbatim anchors of 2..120 characters");
+};
+const emptyAnchorMap = () => ({
+	locations: {},
+	abilities: {},
+	artifacts: {}
+});
+/** Trim, de-duplicate and validate one explicit anchor list. */
+function normalizeAnchors(value, where) {
+	if (!Array.isArray(value)) invalid$1(`${where} must be an array of strings`);
+	const list = value;
+	const result = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const [index, raw] of list.entries()) {
+		if (typeof raw !== "string") invalid$1(`${where}[${index}] must be a string`);
+		const anchor = raw.trim();
+		const length = Array.from(anchor).length;
+		if (length < 2 || length > 120) invalid$1(`${where}[${index}] must contain 2..120 characters`);
+		if (seen.has(anchor)) continue;
+		seen.add(anchor);
+		result.push(anchor);
+	}
+	if (result.length > 8) invalid$1(`${where} contains ${result.length} unique anchors; limit is 8`);
+	return result;
+}
+/**
+* Parse the optional chapter-level anchor map. Keys must name an entity in the
+* matching `new_elements` group; an unknown key is a schema error, not a
+* silently ignored instruction.
+*/
+function normalizeNewElementAnchors(value, namesByGroup) {
+	const result = emptyAnchorMap();
+	if (value === void 0) return result;
+	if (!isRecord$1(value)) invalid$1("new_element_anchors must be an object");
+	const record = value;
+	for (const key of Object.keys(record)) if (!NEW_ELEMENT_GROUPS.includes(key)) invalid$1(`new_element_anchors has unknown group "${key}"`);
+	for (const group of NEW_ELEMENT_GROUPS) {
+		const rawGroup = record[group];
+		if (rawGroup === void 0) continue;
+		if (!isRecord$1(rawGroup)) invalid$1(`new_element_anchors.${group} must be an object`);
+		const groupRecord = rawGroup;
+		for (const [name, rawAnchors] of Object.entries(groupRecord)) {
+			if (!namesByGroup[group].includes(name)) invalid$1(`new_element_anchors.${group} names "${name}", but new_elements.${group} has no such entity`);
+			const anchors = normalizeAnchors(rawAnchors, `new_element_anchors.${group}.${name}`);
+			if (anchors.length > 0) result[group][name] = anchors;
+		}
+	}
+	return result;
+}
+/** Read the declared new-element names from a summary without trusting its shape. */
+const newElementNames = (summary) => {
+	const record = isRecord$1(summary) ? summary : {};
+	const elements = isRecord$1(record.new_elements) ? record.new_elements : {};
+	const names = (group) => Array.isArray(elements[group]) ? elements[group].filter((name) => typeof name === "string") : [];
+	return {
+		locations: names("locations"),
+		abilities: names("abilities"),
+		artifacts: names("artifacts")
+	};
+};
+/** Normalize anchors for one summary; returns an empty map when omitted. */
+function anchorsFromSummary(summary) {
+	if (!isRecord$1(summary)) return emptyAnchorMap();
+	return normalizeNewElementAnchors(summary.new_element_anchors, newElementNames(summary));
+}
+function anchorsForGroup(anchors, group, name) {
+	return anchors[group][name] ?? [];
+}
+/**
+* The single name/anchor matcher used by PG-05 and state-delta. Explicit
+* anchors win; only an entity with no anchors falls back to its readable name.
+*/
+function matchEntityText(text, name, anchors = []) {
+	const attempted = anchors.length > 0 ? [...anchors] : [name];
+	const matched = attempted.find((anchor) => anchor !== "" && text.includes(anchor)) ?? null;
+	return {
+		ok: matched !== null,
+		matched,
+		attempted,
+		usedFallback: anchors.length === 0
+	};
+}
+function entityMatchHint(name, anchors) {
+	if (anchors.length === 0) return `provide summary.new_element_anchors for "${name}", or write the name verbatim in the manuscript`;
+	return `none of the anchors for "${name}" appears verbatim (${anchors.join(" / ")}); add a matching anchor or use a scene name that is actually in the manuscript`;
+}
+/** Persist anchors on a world row without overwriting old anchors that are not repeated. */
+function mergeEntityAnchors(existing, incoming) {
+	const old = Array.isArray(existing) ? existing.filter((anchor) => typeof anchor === "string") : [];
+	const merged = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const anchor of [...old, ...incoming]) {
+		const value = anchor.trim();
+		if (value === "" || seen.has(value)) continue;
+		seen.add(value);
+		merged.push(value);
+		if (merged.length === 8) break;
+	}
+	return merged;
+}
+/** A shape-safe name reader for world rows; `[null]` must never crash a gate. */
+function worldEntityName(row) {
+	if (!isRecord$1(row) || typeof row.name !== "string" || row.name.trim() === "") return null;
+	return row.name.trim();
+}
 // src/engine/state-delta.ts
 const SECTIONS = [
 	"characters",
@@ -5336,6 +5548,12 @@ function applyStateDelta(input) {
 		"advanced",
 		"resolved"
 	]) if (!Array.isArray(summary.foreshadows[key])) fail$1(`summary.foreshadows.${key} must be an array`);
+	let anchors;
+	try {
+		anchors = anchorsFromSummary(summary);
+	} catch (error) {
+		fail$1(error instanceof Error ? error.message : "summary.new_element_anchors is invalid");
+	}
 	const characters = structuredClone(input.characters);
 	const world = structuredClone(input.world);
 	const locks = structuredClone(input.locks);
@@ -5377,7 +5595,7 @@ function applyStateDelta(input) {
 			"profile",
 			"current_state",
 			"growth"
-		]) if (declared[field] !== void 0 && !isRecord(declared[field])) fail$1(`characters.${name}.${field} must be an object; expected ${field === "current_state" ? "{\"resources\":{\"港币\":3},\"status\":\"...\"}" : field === "profile" ? "{\"age\":31,\"occupation\":\"...\"}" : "{\"change\":\"...\",\"status_change\":\"...\"}"}`);
+		]) if (declared[field] !== void 0 && !isRecord(declared[field])) fail$1(`characters.${name}.${field} must be an object; expected ${field === "current_state" ? "{\"resources\":{\"资源名\":3},\"status\":\"...\"}" : field === "profile" ? "{\"age\":31,\"occupation\":\"...\"}" : "{\"change\":\"...\",\"status_change\":\"...\"}"}`);
 		if (declared.growth !== void 0) {
 			const growth = declared.growth;
 			for (const field of ["change", "status_change"]) if (typeof growth[field] !== "string" || growth[field].trim() === "") fail$1(`characters.${name}.growth.${field} must be a non-empty string`);
@@ -5472,12 +5690,23 @@ function applyStateDelta(input) {
 		if (summary.new_elements.artifacts.includes(name)) return "artifact";
 		return null;
 	};
+	const anchorsForKind = (kind, name) => {
+		if (kind === "location") return anchorsForGroup(anchors, "locations", name);
+		if (kind === "ability") return anchorsForGroup(anchors, "abilities", name);
+		if (kind === "artifact") return anchorsForGroup(anchors, "artifacts", name);
+		return [];
+	};
+	const requireText = (name, kind, context) => {
+		const candidates = anchorsForKind(kind, name);
+		if (!matchEntityText(input.text, name, candidates).ok) fail$1(`${context} ${entityMatchHint(name, candidates)}`);
+		return candidates;
+	};
 	for (const [kind, names] of [
 		["location", summary.new_elements.locations],
 		["ability", summary.new_elements.abilities],
 		["artifact", summary.new_elements.artifacts]
 	]) for (const name of names) {
-		if (!input.text.includes(name)) fail$1(`summary lists new ${kind} "${name}" but the manuscript never mentions it`);
+		requireText(name, kind, `summary lists new ${kind} "${name}" but the manuscript never mentions it;`);
 		if (!Object.hasOwn(delta.world, name)) fail$1(`summary lists new ${kind} "${name}" but world.${name} is not declared`);
 		const declared = delta.world[name];
 		if (declared.kind !== void 0 && declared.kind !== kind) fail$1(`world.${name} is declared as ${declared.kind} but the summary lists it as ${kind}`);
@@ -5496,6 +5725,7 @@ function applyStateDelta(input) {
 		const expected = expectedKind(name);
 		if (expected !== null && declared.kind !== void 0 && declared.kind !== expected) fail$1(`world.${name} is declared as ${declared.kind} but the summary lists it as ${expected}`);
 		const existing = findWorld(name);
+		let entityAnchors = anchorsForKind(declared.kind ?? expected, name);
 		let action = declared.action;
 		if (action === "created" && existing !== null) {
 			if (declared.kind !== void 0 && declared.kind !== existing.kind) fail$1(`world.${name} is declared as ${declared.kind} but the ledger has ${existing.kind}; kind cannot change`);
@@ -5503,12 +5733,13 @@ function applyStateDelta(input) {
 			action = "updated";
 			warnReclass(name, "created", "updated", "existing-created-as-updated");
 		} else if (action === "updated" && existing === null) {
-			if ((declared.kind ?? expected) === null) fail$1(`world.${name} does not exist; declare kind (location|ability|artifact|faction|rule) or list it in summary.new_elements`);
-			if (!input.text.includes(name)) fail$1(`world entity "${name}" is new but does not appear in the manuscript`);
+			const kind = declared.kind ?? expected;
+			if (kind === null) fail$1(`world.${name} does not exist; declare kind (location|ability|artifact|faction|rule) or list it in summary.new_elements`);
+			entityAnchors = requireText(name, kind, `world entity "${name}" is new but does not appear in the manuscript;`);
 			action = "created";
 			warnReclass(name, "updated", "created", "missing-updated-as-created");
 		} else if (action === "no_change" && existing === null && expected !== null) {
-			if (!input.text.includes(name)) fail$1(`world entity "${name}" is new but does not appear in the manuscript`);
+			entityAnchors = requireText(name, expected, `world entity "${name}" is new but does not appear in the manuscript;`);
 			action = "created";
 			warnReclass(name, "no_change", "created", "missing-no-change-as-created");
 		}
@@ -5522,9 +5753,9 @@ function applyStateDelta(input) {
 		if (action === "created") {
 			if (name.trim() === "") fail$1("a created world entity has an empty name");
 			if (existing !== null) fail$1(`world entity "${name}" already exists; use updated or no_change`);
-			if (!input.text.includes(name)) fail$1(`world entity "${name}" is created but does not appear in the manuscript`);
 			const kind = declared.kind ?? expected;
 			if (kind === null) fail$1(`world.${name} must declare kind (location|ability|artifact|faction|rule)`);
+			entityAnchors = requireText(name, kind, `world entity "${name}" is created but does not appear in the manuscript;`);
 			if (![
 				"location",
 				"ability",
@@ -5540,13 +5771,15 @@ function applyStateDelta(input) {
 				description: declared.description ?? "",
 				layout: declared.layout ?? "",
 				capacity: declared.capacity ?? 0,
+				...entityAnchors.length === 0 ? {} : { anchors: entityAnchors },
 				changes: []
 			});
 			else world[kind === "ability" ? "abilities" : kind === "artifact" ? "artifacts" : kind === "faction" ? "factions" : "rules"].push({
 				...declared.detail ?? {},
 				name,
 				first_appearance: chapter,
-				description: declared.description ?? ""
+				description: declared.description ?? "",
+				...entityAnchors.length === 0 ? {} : { anchors: entityAnchors }
 			});
 			continue;
 		}
@@ -5558,6 +5791,7 @@ function applyStateDelta(input) {
 				if (declared.description !== void 0) location.description = declared.description;
 				if (declared.layout !== void 0) location.layout = declared.layout;
 				if (declared.capacity !== void 0) location.capacity = declared.capacity;
+				if (entityAnchors.length > 0) location.anchors = mergeEntityAnchors(location.anchors, entityAnchors);
 				location.changes.push({
 					chapter,
 					change: declared.reason ?? declared.description ?? "updated",
@@ -5566,6 +5800,7 @@ function applyStateDelta(input) {
 			} else if (isRecord(existing.value)) {
 				if (declared.description !== void 0 && "description" in existing.value) existing.value.description = declared.description;
 				if (declared.detail !== void 0) Object.assign(existing.value, declared.detail);
+				if (entityAnchors.length > 0) existing.value.anchors = mergeEntityAnchors(existing.value.anchors, entityAnchors);
 			}
 		}
 	}
@@ -5775,6 +6010,30 @@ const median = (values) => {
 	const middle = Math.floor(sorted.length / 2);
 	return sorted.length % 2 === 0 ? (sorted[middle - 1] + sorted[middle]) / 2 : sorted[middle];
 };
+/** Persisted anchors exposed by the report; top-level caps keep the JSON small. */
+const worldAnchors = (world) => {
+	if (world === void 0) return [];
+	const groups = [
+		["location", world.locations],
+		["ability", world.abilities],
+		["artifact", world.artifacts],
+		["faction", world.factions],
+		["rule", world.rules]
+	];
+	const out = [];
+	for (const [kind, entries] of groups) for (const entry of entries) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const record = entry;
+		if (typeof record.name !== "string" || !Array.isArray(record.anchors)) continue;
+		const anchors = record.anchors.filter((anchor) => typeof anchor === "string").slice(0, 8);
+		if (anchors.length > 0) out.push({
+			name: record.name,
+			kind,
+			anchors
+		});
+	}
+	return out.slice(0, 10);
+};
 /** Build the whole-book report from one committed snapshot. No IO. */
 function buildBookReport(input) {
 	const records = [...input.chapters].sort((left, right) => left.num - right.num);
@@ -5890,6 +6149,7 @@ function buildBookReport(input) {
 		};
 	});
 	if (records.some((record) => record.rounds === void 0 || record.archived_at === void 0)) warnings.push("部分旧章缺少归档 effort 元数据；报告已按事务日志回填");
+	const persistedAnchors = worldAnchors(input.world);
 	return {
 		progress: {
 			archived: records.length,
@@ -5917,7 +6177,10 @@ function buildBookReport(input) {
 			volumes: volumeCounts,
 			drift
 		},
-		worldbook: worldbookCounts(input.worldbook),
+		worldbook: {
+			...worldbookCounts(input.worldbook),
+			...persistedAnchors.length === 0 ? {} : { anchors: persistedAnchors }
+		},
 		quality: {
 			average: Math.round(qualityAverage * 10) / 10,
 			median: Math.round(median(scores) * 10) / 10,
@@ -6319,6 +6582,173 @@ function searchSnapshot(input) {
 		results
 	};
 }
+const oneLine = (value) => value.replace(/\s+/g, " ").trim();
+const ledgerWorldEntries = (world, kind) => {
+	const rows = kind === "location" ? world.locations : kind === "faction" ? world.factions : world.rules;
+	const entries = [];
+	for (const row of rows) {
+		if (typeof row !== "object" || row === null) continue;
+		const record = row;
+		if (typeof record.name !== "string" || record.name.trim() === "") continue;
+		const anchors = Array.isArray(record.anchors) ? record.anchors.filter((anchor) => typeof anchor === "string") : [];
+		entries.push({
+			name: record.name,
+			description: typeof record.description === "string" ? record.description : "",
+			...anchors.length === 0 ? {} : { anchors }
+		});
+	}
+	return entries;
+};
+const nameDescription = (entries, world, kind = "location") => {
+	const merged = /* @__PURE__ */ new Map();
+	for (const entry of [...entries, ...ledgerWorldEntries(world, kind)]) {
+		const name = oneLine(entry.name);
+		if (name === "") continue;
+		const existing = merged.get(name);
+		if (existing === void 0) {
+			merged.set(name, {
+				name,
+				description: oneLine(entry.description),
+				...entry.anchors === void 0 || entry.anchors.length === 0 ? {} : { anchors: [...entry.anchors] }
+			});
+			continue;
+		}
+		if (existing.anchors === void 0 && entry.anchors !== void 0 && entry.anchors.length > 0) existing.anchors = [...entry.anchors];
+	}
+	return [...merged.values()].slice(0, 5);
+};
+/**
+* Build the v6 panel book view from the canonical `BookReport`. This function
+* only truncates and renames; it never recomputes a quality/pacing aggregate.
+*/
+function buildPanelBookData(input) {
+	const report = input.report;
+	const remainingBasis = report.progress.target === null ? "none" : report.progress.archived === 0 ? "minimum_target" : "actual_average";
+	const remaining = remainingBasis === "actual_average" ? report.progress.remaining_words_average : remainingBasis === "minimum_target" ? report.progress.remaining_words_min : null;
+	const card = input.outline.chapters.find((candidate) => candidate.num === input.currentChapter);
+	const currentCard = card === void 0 ? null : {
+		num: card.num,
+		title: card.title,
+		scene_type: card.scene_type,
+		goal: card.goal,
+		conflict: card.conflict,
+		hook: card.hook,
+		cast: [...card.cast],
+		target_words: [card.target_words[0], card.target_words[1]],
+		status: card.status
+	};
+	const quality = report.quality;
+	const counts = {
+		present: report.worldbook.present,
+		characters: report.worldbook.characters,
+		locations: report.worldbook.locations,
+		factions: report.worldbook.factions,
+		rules: report.worldbook.rules,
+		glossary: report.worldbook.glossary,
+		backstory: report.worldbook.backstory,
+		...report.worldbook.facts === void 0 ? {} : { facts: report.worldbook.facts }
+	};
+	return {
+		identity: {
+			author: input.project.author,
+			description: input.project.description,
+			created_at: input.project.created_at,
+			targets: {
+				words_per_chapter: [input.project.targets.words_per_chapter[0], input.project.targets.words_per_chapter[1]],
+				total_chapters: input.project.targets.total_chapters,
+				dialogue_ratio: [input.project.targets.dialogue_ratio[0], input.project.targets.dialogue_ratio[1]]
+			}
+		},
+		blueprint: {
+			premise: input.outline.book.premise,
+			logline: input.outline.book.logline,
+			themes: [...input.outline.book.themes],
+			tone: input.outline.book.tone,
+			pov: input.outline.book.pov,
+			audience: input.outline.book.audience,
+			selling_points: [...input.outline.book.selling_points],
+			ending: input.outline.book.ending
+		},
+		progress: {
+			archived: report.progress.archived,
+			target: report.progress.target,
+			words_archived: report.progress.words,
+			words_with_draft: report.progress.words + input.draftWords,
+			average_words: report.progress.average_words,
+			remaining_words: remaining,
+			remaining_words_basis: remainingBasis,
+			percent: report.progress.percent
+		},
+		current: {
+			card: currentCard,
+			chapter: input.currentChapter,
+			stage: input.stage,
+			rounds: { ...input.rounds },
+			manuscript_hash: input.manuscriptHash,
+			metrics: input.metrics
+		},
+		worldbook: {
+			counts,
+			locations: nameDescription(input.worldbook.locations, input.world),
+			factions: nameDescription(input.worldbook.factions, input.world, "faction"),
+			rules: nameDescription(input.worldbook.rules, input.world, "rule"),
+			facts: (input.worldbook.facts ?? []).slice(0, 5).map((fact) => ({
+				alias: fact.alias,
+				value: fact.value,
+				unit: fact.unit
+			}))
+		},
+		cast: {
+			total: report.cast.total,
+			top: report.cast.top.slice(0, 5).map((entry) => ({ ...entry }))
+		},
+		relationships: {
+			total: report.relationships.total,
+			types: { ...report.relationships.types }
+		},
+		foreshadows: {
+			...report.foreshadows,
+			oldest: report.foreshadows.oldest.slice(0, 5).map((entry) => ({ ...entry }))
+		},
+		timeline: { ...report.timeline },
+		outline: { drift: report.outline.drift.slice(0, 10).map((entry) => ({ ...entry })) },
+		quality: {
+			average: quality.average,
+			median: quality.median,
+			min: quality.min,
+			max: quality.max,
+			last_ten_average: input.lastTenAverage,
+			trend: quality.trend,
+			trend_basis: quality.trend_basis,
+			samples: quality.samples,
+			attempts: quality.attempts,
+			dimensions: quality.dimensions.slice(0, 15).map((entry) => ({ ...entry }))
+		},
+		pacing: {
+			scene_types: { ...report.pacing.scene_types },
+			hook_strength: { ...report.pacing.hook_strength },
+			plot_advancement: { ...report.pacing.plot_advancement },
+			longest: report.pacing.longest === null ? null : { ...report.pacing.longest },
+			shortest: report.pacing.shortest === null ? null : { ...report.pacing.shortest }
+		},
+		effort: {
+			...report.effort,
+			chapters: report.effort.chapters.slice(-30).map((entry) => ({ ...entry }))
+		},
+		health: {
+			state_errors: input.stateErrors.slice(0, 10).map((entry) => ({ ...entry })),
+			outline: {
+				present: input.outlinePresent,
+				error: input.outlineError
+			},
+			worldbook: {
+				present: input.worldbookPresent,
+				error: input.worldbookError
+			},
+			pending: input.pending === null ? null : { ...input.pending }
+		}
+	};
+}
 // src/engine/history.ts
 const PATTERN = /^ch(?<chapter>\d{3,})\.r(?<revision>\d+)\.(?<suffix>review\.yaml|check\.yaml|chapter\.yaml|md)$/;
 const kindOf = (directory, suffix) => {
@@ -7100,6 +7530,14 @@ const SEMANTIC_CHECK_IDS = [
 	"L2-VOICE",
 	"L2-POV"
 ];
+/** A longer evidence interval must share at least this share of the shorter quote. */
+const SEMANTIC_OVERLAP_RATIO = .5;
+const conflictSummary = (itemId, conflict) => {
+	const pair = `${itemId}↔${conflict.other_id}`;
+	if (conflict.kind === "same_sentence") return `${pair} same sentence${conflict.sentence === void 0 ? "" : ` at paragraph ${conflict.sentence.paragraph} sentence ${conflict.sentence.id}`}`;
+	if (conflict.kind === "duplicate") return `${pair} exact duplicate`;
+	return `${pair} overlaps ${conflict.overlap_chars ?? 0} chars${conflict.overlap_ratio === void 0 ? "" : ` (${Math.round(conflict.overlap_ratio * 100)}%)`}${conflict.paragraphs === void 0 || conflict.paragraphs.length === 0 ? "" : ` at paragraph ${conflict.paragraphs.join("/")}`}`;
+};
 /**
 * A caller supplied evidence that cannot be evaluated as a content judgement.
 * It must never be persisted as a failed check or consume a content round.
@@ -7108,16 +7546,26 @@ var CheckSubmissionError = class extends EngineInputError {
 	items;
 	passed;
 	failed;
+	conflicts;
+	blocking;
 	rounds_consumed = 0;
 	failure_class = "submission";
-	constructor(items) {
+	constructor(items, blocking) {
 		const passed = items.filter((item) => item.state === "pass").length;
 		const failed = items.filter((item) => item.state !== "pass" && item.state !== "fail").length;
 		const first = items.find((item) => item.state !== "pass" && item.state !== "fail");
-		super(ERROR_CODES.CHECK_SUBMISSION_INVALID, `semantic submission is invalid: ${first?.id ?? "semantic"} ${first?.state ?? "invalid"}${first?.detail === void 0 ? "" : ` (${first.detail})`}; ${passed} passed, ${failed} failed; no check was written and no round was consumed`, "resubmit novel_check with all five semantic items; each needs a distinct verbatim quote of at least 8 characters");
+		const conflicts = items.flatMap((item) => item.conflicts ?? []);
+		const summaries = items.flatMap((item) => (item.conflicts ?? []).map((conflict) => conflictSummary(item.id, conflict))).slice(0, 5);
+		super(ERROR_CODES.CHECK_SUBMISSION_INVALID, `semantic submission is invalid: ${first?.id ?? "semantic"} ${first?.state ?? "invalid"}${first?.detail === void 0 ? "" : ` (${first.detail})`}${summaries.length === 0 ? "" : `; conflicts: ${summaries.join("; ")}`}; ${passed} passed, ${failed} failed; no check was written and no round was consumed`, "resubmit novel_check with all five semantic items; use distinct quotes from different sentences and paragraphs, and never reuse a sentence for two dimensions");
 		this.items = items;
 		this.passed = passed;
 		this.failed = failed;
+		this.conflicts = conflicts;
+		this.blocking = blocking ?? items.filter((item) => submissionState(item.state)).map((item) => ({
+			code: codeForState(item.state),
+			scope: "check",
+			detail: detailFor(item)
+		}));
 	}
 };
 /** Extract the quoted part of an evidence string, tolerating "第 N 段：" labels. */
@@ -7129,75 +7577,18 @@ function evidenceQuote(value) {
 	candidate = candidate.replace(/^[「『“"']/, "").replace(/[」』”"']$/, "").trim();
 	return candidate;
 }
-const CLOSING_PUNCTUATION = /* @__PURE__ */ new Set([
-	"」",
-	"』",
-	"”",
-	"\"",
-	"’",
-	"'",
-	"）",
-	")",
-	"】",
-	"]"
-]);
-/**
-* Split text into sentence spans while treating every non-empty line as a
-* paragraph boundary. A quote may cover multiple sentences or paragraphs; the
-* spans are only used to prove that no two evidence items reuse the same
-* passage. Trailing closing quotes belong to the sentence they terminate.
-*/
-function sentenceSpans(text) {
-	const spans = [];
-	let paragraph = 1;
-	let lineStart = 0;
-	let sentenceStart = 0;
-	for (let index = 0; index < text.length; index += 1) {
-		const char = text[index];
-		if (char === "\n") {
-			if (text.slice(lineStart, index).trim() !== "") {
-				if (index > sentenceStart) spans.push({
-					start: sentenceStart,
-					end: index,
-					paragraph
-				});
-				paragraph += 1;
-			}
-			lineStart = index + 1;
-			sentenceStart = index + 1;
-			continue;
-		}
-		if ("。！？!?".includes(char)) {
-			let end = index + 1;
-			while (end < text.length && CLOSING_PUNCTUATION.has(text[end])) end += 1;
-			spans.push({
-				start: sentenceStart,
-				end,
-				paragraph
-			});
-			sentenceStart = end;
-			index = end - 1;
-		}
-	}
-	if (sentenceStart < text.length) spans.push({
-		start: sentenceStart,
-		end: text.length,
-		paragraph
-	});
-	return spans;
-}
 function nearestParagraph(text, quote) {
 	const paragraphs = splitParagraphs(text);
 	let best = null;
 	for (const [index, paragraph] of paragraphs.entries()) {
-		const score = textSimilarity(paragraph, quote);
+		const score = bigramSimilarity(paragraph, quote);
 		if (best === null || score > best.score) best = {
 			index,
 			paragraph,
 			score
 		};
 	}
-	if (best === null) return null;
+	if (best === null || best.score < .5) return null;
 	return {
 		paragraph: best.index + 1,
 		quote: Array.from(best.paragraph).slice(0, 120).join(""),
@@ -7230,18 +7621,41 @@ const detailFor = (result) => {
 		default: return `${result.id} is invalid`;
 	}
 };
+const sentenceIdsFor = (sentences, start, end) => sentences.map((sentence, index) => ({
+	sentence,
+	index
+})).filter(({ sentence }) => start < sentence.end && sentence.start < end).map(({ index }) => index);
+const paragraphsFor = (sentences, start, end) => {
+	const values = /* @__PURE__ */ new Set();
+	for (const sentence of sentences) if (start < sentence.end && sentence.start < end) values.add(sentence.paragraph);
+	return [...values].sort((left, right) => left - right);
+};
+const intervalOverlap = (start, end, other) => {
+	const overlapStart = Math.max(start, other.start);
+	const overlapEnd = Math.min(end, other.end);
+	const overlapChars = Math.max(0, overlapEnd - overlapStart);
+	const minLength = Math.min(end - start, other.end - other.start);
+	return {
+		start: overlapStart,
+		end: overlapEnd,
+		chars: overlapChars,
+		ratio: minLength === 0 ? 0 : overlapChars / minLength,
+		contains: start <= other.start && end >= other.end || other.start <= start && other.end >= end
+	};
+};
 /**
-* Validate and evaluate all five L2 semantic items.
+* Evaluate all five L2 semantic items.
 *
-* Evidence is located by character range, not by requiring one sentence. Two
-* items may not overlap or reuse a sentence; a quote that exists but fails
-* those rules is reported as OVERLAP/SAME_SENTENCE instead of the old generic
-* "overlapping text or the same sentence" message.
+* Sentence boundaries come from the domain owner. A failure never consumes an
+* interval or a sentence, so one bad quote cannot cascade into the next item.
+* Exact duplicate, same-sentence reuse and meaningful interval overlap are
+* distinct, pair-level conflicts; merely sharing a few words in different
+* sentences is not a conflict.
 */
 function evaluateSemantic(text, input) {
 	const items = [];
-	const spans = [];
-	const sentences = sentenceSpans(text);
+	const accepted = [];
+	const sentences = splitSentenceSpans(text);
 	const usedSentences = /* @__PURE__ */ new Map();
 	const seenIds = /* @__PURE__ */ new Set();
 	const acceptedQuotes = /* @__PURE__ */ new Map();
@@ -7306,13 +7720,26 @@ function evaluateSemantic(text, input) {
 			});
 			continue;
 		}
+		if (!SEMANTIC_CHECK_IDS.includes(id)) {
+			items.push({
+				id,
+				state: "invalid",
+				detail: `${id} is not one of the required P6 semantic checks`
+			});
+			continue;
+		}
 		const duplicate = acceptedQuotes.get(quote);
 		if (duplicate !== void 0) {
+			const conflict = {
+				kind: "duplicate",
+				other_id: duplicate
+			};
 			items.push({
 				id,
 				state: "duplicate",
 				quote,
 				conflict_with: duplicate,
+				conflicts: [conflict],
 				detail: `${id} repeats ${duplicate}'s quote exactly`
 			});
 			continue;
@@ -7334,63 +7761,79 @@ function evaluateSemantic(text, input) {
 			});
 			continue;
 		}
-		let accepted = null;
-		let overlapWith;
-		let sameSentenceWith;
-		let boundary = false;
+		let acceptedSpan = null;
+		const conflicts = [];
 		for (const start of occurrences) {
 			const end = start + quote.length;
-			const conflict = spans.find((span) => start < span.end && span.start < end);
-			if (conflict !== void 0) {
-				overlapWith ??= conflict.id;
-				continue;
+			const sentenceIds = sentenceIdsFor(sentences, start, end);
+			if (sentenceIds.length === 0) continue;
+			let rejected = false;
+			for (const other of accepted) {
+				const overlap = intervalOverlap(start, end, other);
+				const minLength = Math.min(quote.length, other.quote.length);
+				const threshold = Math.max(8, Math.ceil(SEMANTIC_OVERLAP_RATIO * minLength));
+				if (overlap.chars > 0 && (overlap.contains || overlap.chars >= threshold)) {
+					conflicts.push({
+						kind: "interval_overlap",
+						other_id: other.id,
+						overlap_text: Array.from(text.slice(overlap.start, overlap.end)).slice(0, 120).join(""),
+						overlap_chars: overlap.chars,
+						overlap_ratio: Math.round(overlap.ratio * 1e3) / 1e3,
+						paragraphs: paragraphsFor(sentences, overlap.start, overlap.end)
+					});
+					rejected = true;
+				}
 			}
-			const covered = sentences.map((sentence, sentenceIndex) => ({
-				sentence,
-				sentenceIndex
-			})).filter(({ sentence }) => start < sentence.end && sentence.start < end);
-			if (covered.length === 0) {
-				boundary = true;
-				continue;
+			if (!rejected) for (const sentenceId of sentenceIds) {
+				const owner = usedSentences.get(sentenceId);
+				if (owner !== void 0) {
+					const sentence = sentences[sentenceId];
+					conflicts.push({
+						kind: "same_sentence",
+						other_id: owner,
+						sentence: {
+							id: sentenceId + 1,
+							text: sentence.text,
+							paragraph: sentence.paragraph
+						}
+					});
+					rejected = true;
+				}
 			}
-			const used = covered.find(({ sentenceIndex }) => usedSentences.has(sentenceIndex));
-			if (used !== void 0) {
-				sameSentenceWith ??= usedSentences.get(used.sentenceIndex);
-				continue;
+			if (!rejected) {
+				acceptedSpan = {
+					start,
+					end,
+					id,
+					quote,
+					sentenceIds
+				};
+				break;
 			}
-			accepted = {
-				start,
-				end,
-				id
-			};
-			for (const { sentenceIndex } of covered) usedSentences.set(sentenceIndex, id);
-			break;
 		}
-		if (accepted === null) {
-			if (overlapWith !== void 0) items.push({
-				id,
-				state: "overlap",
-				quote,
-				conflict_with: overlapWith,
-				detail: `${id} overlaps ${overlapWith}'s accepted evidence interval`
-			});
-			else if (sameSentenceWith !== void 0) items.push({
-				id,
-				state: "same_sentence",
-				quote,
-				conflict_with: sameSentenceWith,
-				detail: `${id} reuses a sentence already cited by ${sameSentenceWith}`
-			});
-			else items.push({
+		if (acceptedSpan === null) {
+			const unique = /* @__PURE__ */ new Map();
+			for (const conflict of conflicts) {
+				const key = `${conflict.kind}:${conflict.other_id}:${conflict.overlap_chars ?? ""}:${conflict.sentence?.id ?? ""}`;
+				unique.set(key, conflict);
+			}
+			const all = [...unique.values()];
+			const overlap = all.find((conflict) => conflict.kind === "interval_overlap");
+			const same = all.find((conflict) => conflict.kind === "same_sentence");
+			const chosen = overlap ?? same;
+			const state = overlap !== void 0 ? "overlap" : same !== void 0 ? "same_sentence" : "boundary";
+			items.push({
 				id,
-				state: boundary ? "boundary" : "same_sentence",
+				state,
 				quote,
-				...boundary ? {} : { conflict_with: id },
-				detail: boundary ? `${id} cannot be mapped onto a sentence boundary` : `${id} reuses a sentence already cited by another item`
+				...chosen === void 0 ? {} : { conflict_with: chosen.other_id },
+				...all.length === 0 ? {} : { conflicts: all },
+				detail: chosen === void 0 ? `${id} cannot be mapped onto a sentence boundary` : `${id} ${chosen.kind} with ${chosen.other_id}`
 			});
 			continue;
 		}
-		spans.push(accepted);
+		accepted.push(acceptedSpan);
+		for (const sentenceId of acceptedSpan.sentenceIds) usedSentences.set(sentenceId, id);
 		acceptedQuotes.set(quote, id);
 		items.push({
 			id,
@@ -7404,24 +7847,29 @@ function evaluateSemantic(text, input) {
 		state: "missing",
 		detail: `${id} is required by the P6 task book`
 	});
-	for (const id of seenIds) if (!SEMANTIC_CHECK_IDS.includes(id)) items.push({
-		id,
-		state: "invalid",
-		detail: `${id} is not one of the required P6 semantic checks`
-	});
+	const conflicts = items.flatMap((item) => item.conflicts ?? []);
 	const findings = items.filter((item) => item.state === "fail").map((item) => ({
 		code: "SEMANTIC_CHECK_FAILED",
 		scope: "check",
 		detail: item.detail ?? `${item.id}: semantic check failed`
 	}));
 	const submissionItems = items.filter((item) => submissionState(item.state));
-	const blocking = [...submissionItems.map((item) => ({
-		code: codeForState(item.state),
-		scope: "check",
-		detail: detailFor(item)
-	})), ...findings];
+	const blocking = [
+		...submissionItems.map((item) => ({
+			code: codeForState(item.state),
+			scope: "check",
+			detail: detailFor(item)
+		})),
+		...submissionItems.flatMap((item) => (item.conflicts ?? []).slice(0, 5).map((conflict) => ({
+			code: codeForState(item.state),
+			scope: "check",
+			detail: `${item.id}: ${conflictSummary(item.id, conflict)}`
+		}))),
+		...findings
+	];
 	return {
 		items,
+		conflicts,
 		findings,
 		blocking,
 		submission_failed: submissionItems.length > 0,
@@ -7432,7 +7880,7 @@ function evaluateSemantic(text, input) {
 /** Throw a typed submission error when shape/evidence errors exist. */
 function validateSemanticSubmission(text, input) {
 	const evaluation = evaluateSemantic(text, input);
-	if (evaluation.submission_failed) throw new CheckSubmissionError(evaluation.items);
+	if (evaluation.submission_failed) throw new CheckSubmissionError(evaluation.items, evaluation.blocking);
 	return evaluation;
 }
 // src/engine/gates.ts
@@ -7537,23 +7985,32 @@ const summarySchema = (input) => {
 	}
 	const newElements = summary.new_elements;
 	if (typeof newElements !== "object" || newElements === null) problems.push("new_elements must be an object");
-	else for (const key of [
-		"locations",
-		"abilities",
-		"artifacts"
-	]) {
-		if (!textArray(newElements[key])) problems.push(`new_elements.${key} must be a string array`);
-		for (const name of textArray(newElements[key]) ? newElements[key] : []) {
-			if (!input.text.includes(name)) problems.push(`new_elements.${key} lists "${name}", but the manuscript never mentions it`);
-			if (input.operation !== "archiveChapter") {
-				const ledger = input.evidence.world;
-				if (ledger !== null && [
-					ledger.locations,
-					ledger.abilities,
-					ledger.artifacts,
-					ledger.factions,
-					ledger.rules
-				].some((rows) => rows.some((row) => row.name === name))) problems.push(`new_elements.${key} lists "${name}", but state/world.yaml already has it; remove it or use updated/no_change`);
+	else {
+		let anchorMap = null;
+		try {
+			anchorMap = anchorsFromSummary(summary);
+		} catch (error) {
+			problems.push(error instanceof Error ? error.message : "new_element_anchors is invalid");
+		}
+		for (const key of [
+			"locations",
+			"abilities",
+			"artifacts"
+		]) {
+			if (!textArray(newElements[key])) problems.push(`new_elements.${key} must be a string array`);
+			for (const name of textArray(newElements[key]) ? newElements[key] : []) {
+				const anchors = anchorMap === null ? [] : anchorsForGroup(anchorMap, key, name);
+				if (!matchEntityText(input.text, name, anchors).ok) problems.push(`new_elements.${key} lists "${name}", but ${entityMatchHint(name, anchors)}`);
+				if (input.operation !== "archiveChapter") {
+					const ledger = input.evidence.world;
+					if (ledger !== null && [
+						ledger.locations,
+						ledger.abilities,
+						ledger.artifacts,
+						ledger.factions,
+						ledger.rules
+					].some((rows) => rows.some((row) => worldEntityName(row) === name))) problems.push(`new_elements.${key} lists "${name}", but state/world.yaml already has it; remove it or use updated/no_change`);
+				}
 			}
 		}
 	}
@@ -7676,12 +8133,18 @@ const issuesCleared = (input) => {
 	}
 	return problems.length === 0 ? [] : [block("PG-08", problems.join("; "), "mark every blocker fixed and quote the revised text as evidence")];
 };
-/** Paragraph index (1-based) that contains the quote, or -1. */
+/** Paragraph index (1-based) nearest the reference when the quote repeats, or -1. */
 function actualParagraph(text, reference) {
 	if (typeof reference !== "object" || reference === null || typeof reference.quote !== "string") return -1;
 	const quote = reference.quote.trim();
 	if (Array.from(quote).length < LIMITS.minQuoteChars) return -1;
-	return splitParagraphs(text).findIndex((paragraph) => paragraph.includes(quote)) + 1;
+	const matches = splitParagraphs(text).map((paragraph, index) => ({
+		paragraph,
+		index
+	})).filter(({ paragraph }) => paragraph.includes(quote));
+	if (matches.length === 0) return -1;
+	const target = Number.isInteger(reference.paragraph) && reference.paragraph > 0 ? reference.paragraph : 1;
+	return matches.reduce((best, match) => Math.abs(match.index + 1 - target) < Math.abs(best.index + 1 - target) ? match : best).index + 1;
 }
 /** Verify one reading-proof reference against the manuscript. */
 function verifyReference(text, reference) {
@@ -7690,9 +8153,13 @@ function verifyReference(text, reference) {
 	if (!Number.isInteger(reference.paragraph) || reference.paragraph < 1) return "reading proof paragraph must be a positive integer";
 	const quote = reference.quote.trim();
 	if (Array.from(quote).length < LIMITS.minQuoteChars) return `quote "${reference.quote}" is shorter than ${LIMITS.minQuoteChars} characters`;
-	const actual = splitParagraphs(text).findIndex((paragraph) => paragraph.includes(quote));
-	if (actual === -1) return `quote "${quote}" does not appear in the text`;
-	if (Math.abs(actual + 1 - reference.paragraph) > 1) return `quote "${quote}" is at paragraph ${actual + 1}, not ${reference.paragraph}`;
+	const matches = splitParagraphs(text).map((paragraph, index) => ({
+		paragraph,
+		index
+	})).filter(({ paragraph }) => paragraph.includes(quote));
+	if (matches.length === 0) return `quote "${quote}" does not appear in the text`;
+	const nearest = matches.reduce((best, match) => Math.abs(match.index + 1 - reference.paragraph) < Math.abs(best.index + 1 - reference.paragraph) ? match : best);
+	if (Math.abs(nearest.index + 1 - reference.paragraph) > 1) return `quote "${quote}" is at paragraph ${nearest.index + 1}, not ${reference.paragraph}`;
 	return null;
 }
 /** PG-09: three verifiable quotes from three distinct paragraphs. */
@@ -7945,12 +8412,21 @@ function projectChapter(record) {
 		score: record.score,
 		stage: record.status === "reviewed" ? "done" : "P3",
 		status: record.status === "reviewed" ? "passed" : "draft",
-		details: record.summary.events.join("；").slice(0, 240)
+		details: record.summary.events.join("；").slice(0, 240),
+		sceneType: record.scene_type,
+		dialogueRatio: record.dialogue_ratio,
+		hookStrength: record.summary.hook_strength,
+		finalCheck: record.final_check ?? null,
+		reviews: record.rounds?.review ?? 0,
+		revisions: record.rounds?.revise ?? 0,
+		checks: record.rounds?.check ?? 0,
+		rollbacks: record.rounds?.rollbacks ?? 0,
+		archivedAt: record.archived_at ?? null
 	};
 }
 function projectSummary(snapshot) {
 	return {
-		schemaVersion: 5,
+		schemaVersion: 6,
 		panelId: PANEL_ID,
 		root: snapshot.root,
 		title: snapshot.title,
@@ -7972,6 +8448,8 @@ function projectSummary(snapshot) {
 		...snapshot.book === void 0 ? {} : { book: snapshot.book },
 		...snapshot.quality === void 0 ? {} : { quality: snapshot.quality },
 		...snapshot.health === void 0 ? {} : { health: snapshot.health },
+		...snapshot.bookData === void 0 ? {} : { bookData: snapshot.bookData },
+		...snapshot.pending === void 0 ? {} : { pending: snapshot.pending },
 		...snapshot.activity === void 0 ? {} : { activity: snapshot.activity },
 		...snapshot.advisories === void 0 ? {} : { advisories: snapshot.advisories },
 		...snapshot.acknowledgedAdvisories === void 0 ? {} : { acknowledgedAdvisories: snapshot.acknowledgedAdvisories },
@@ -7997,14 +8475,14 @@ function projectChapters(snapshot) {
 		details: draft.details
 	});
 	return {
-		schemaVersion: 5,
+		schemaVersion: 6,
 		panelId: PANEL_ID,
 		rows
 	};
 }
 function projectGates(snapshot) {
 	return {
-		schemaVersion: 5,
+		schemaVersion: 6,
 		panelId: PANEL_ID,
 		stage: snapshot.stage,
 		blocking: snapshot.blocking,
@@ -8406,6 +8884,8 @@ var EngineService = class {
 	exportArtifactEpoch = /* @__PURE__ */ new Map();
 	/** Status, panel and gates ask for the same stage context repeatedly. */
 	briefContextCache = /* @__PURE__ */ new WeakMap();
+	/** The 15s panel poll reuses the heavy book projection until revision/damage changes. */
+	panelCache = /* @__PURE__ */ new Map();
 	briefs;
 	now;
 	metadataMutex = new KeyedMutex();
@@ -9418,14 +9898,51 @@ var EngineService = class {
 		if (typeof input.txid !== "string" || !/^[0-9a-f-]{36}$/i.test(input.txid)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "restore txid must be a transaction UUID");
 		if (input.chapter !== void 0) this.assertChapterParameter(input.chapter);
 		if (input.paths !== void 0 && (!Array.isArray(input.paths) || input.paths.length === 0)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "restore paths must be a non-empty array");
+		const pipelinePath = joinRel(STATE_DIR, STATE_FILES.pipeline);
+		const pipelineOnly = input.paths?.length === 1 && input.paths[0] === pipelinePath;
 		return this.mutate({
 			root: input.root,
 			op: "restoreBackup",
 			chapter: input.chapter,
 			reason: `restore backup ${input.txid}`,
+			...pipelineOnly ? {
+				allowPipelineRecovery: true,
+				repairPaths: [pipelinePath]
+			} : {},
 			run: async (snapshot, context) => {
 				const manifest = await readBackupManifest(context.store, input.txid);
 				if (manifest === null) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} has no readable manifest`, "list backups with novel_state {kind:\"backups\"}; only marked engine backups can be restored");
+				if (pipelineOnly) {
+					if (input.chapter !== void 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "restoring state/pipeline.yaml does not accept a chapter", "omit chapter when paths is exactly [state/pipeline.yaml]");
+					if (!manifest.files.includes(pipelinePath)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} does not contain ${pipelinePath}`, "choose a backup created by a stage operation or amend that contains the pipeline");
+					if (snapshot.pipelineError === null) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "state/pipeline.yaml is readable; refusing a blind pipeline restore", "use the normal stage operation, or repair a genuinely unreadable pipeline");
+					const text = await context.store.readText(`backups/${input.txid}/${pipelinePath}`);
+					if (text === null) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} does not contain ${pipelinePath}`, "choose another backup with a pipeline pre-image");
+					let backupPipeline;
+					try {
+						backupPipeline = narrow("pipeline", parse(text));
+					} catch (error) {
+						throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} contains an invalid pipeline: ${errorMessage(error)}`, "choose a different backup or repair the file manually");
+					}
+					const nextPipeline = {
+						...backupPipeline,
+						revision: context.revision,
+						last_action: action("novel_restore", this.now(), shortDigest(input.txid))
+					};
+					return {
+						files: [{
+							path: pipelinePath,
+							text: yaml(nextPipeline)
+						}],
+						backup: true,
+						data: {
+							txid: input.txid,
+							chapter: nextPipeline.chapter,
+							restored: [pipelinePath]
+						},
+						warnings: []
+					};
+				}
 				if (input.paths?.length === 1 && input.paths[0] === "outline/outline.yaml") {
 					this.assertArchiveIndexReadable(snapshot, "novel_restore");
 					if (input.chapter !== void 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "restoring outline/outline.yaml does not accept a chapter", "omit chapter when paths is exactly [outline/outline.yaml]");
@@ -9441,6 +9958,8 @@ var EngineService = class {
 					} catch (error) {
 						throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} contains an invalid outline: ${errorMessage(error)}`, "restore a different backup or repair the file manually");
 					}
+					assertArchivedCardVolumes(snapshot.chapters.chapters, snapshot.outline.chapters, snapshot.outline.volumes, document.volumes, "novel_restore");
+					assertArchivedCardsInVolumes(snapshot.chapters.chapters, document.chapters, document.volumes, "novel_restore");
 					const restoredCards = new Map(document.chapters.map((card) => [card.num, card]));
 					const archivedNums = new Set(snapshot.chapters.chapters.map((record) => record.num));
 					for (const record of snapshot.chapters.chapters) {
@@ -10131,7 +10650,7 @@ var EngineService = class {
 			} catch {}
 			if (oldChecks > 0) issues.push({
 				code: "LEGACY_CHECK_FORMAT",
-				detail: `${oldChecks} 章 check 是 0.2.0 旧格式（advisory 混在 violations）；重新跑 novel_check 或按 docs/0.2.3-plan.md 标记`
+				detail: `${oldChecks} 章 check 是 0.2.0 旧格式（advisory 混在 violations）；重新跑 novel_check 或按 0.2.3 迁移说明标记`
 			});
 		}
 		const hints = /* @__PURE__ */ new Map();
@@ -10239,7 +10758,7 @@ var EngineService = class {
 			severity: "error",
 			title: "状态文档不可读",
 			detail: `${error.code}: ${error.message}`,
-			hint: `repair ${error.path} with novel_amend`
+			hint: error.code === "PIPELINE_UNREADABLE" ? "restore a valid pipeline backup with novel_restore { paths: [\"state/pipeline.yaml\"], txid }" : `repair ${error.path} with novel_amend`
 		});
 		add({
 			id: "outline",
@@ -10424,7 +10943,7 @@ var EngineService = class {
 			severity: "warning",
 			title: "旧数据升级提示",
 			detail: `${legacy.length} 类旧数据需要解释或人工补齐：${legacy.slice(0, 3).map((issue) => `${issue.code}（${issue.detail}）`).join("；")}`,
-			hint: "这是只读审计，不会自动改历史；按 docs/0.2.3-plan.md WP0 处理，补 anchor/role 前先核对原文"
+			hint: "这是只读审计，不会自动改历史；按 0.2.3 的 WP0 处理，补 anchor/role 前先核对原文"
 		});
 		const locked = await store.exists(LOCK_FILE);
 		add({
@@ -10517,6 +11036,7 @@ var EngineService = class {
 			worldbook: snapshot.worldbook,
 			worldbookPresent: snapshot.worldbookPresent,
 			worldbookError: snapshot.worldbookError,
+			world: snapshot.world,
 			chapters: snapshot.chapters.chapters,
 			characters: snapshot.characters,
 			timeline: snapshot.timeline,
@@ -10715,7 +11235,7 @@ var EngineService = class {
 						reason: "no_change 必填；created/updated 建议写",
 						role: "protagonist | supporting | antagonist | extra（可选）",
 						profile: "object（可选）",
-						current_state: "object（可选，如 {\"resources\":{\"港币\":-3}}）"
+						current_state: "object（可选，如 {\"resources\":{\"资源名\":-3}}）"
 					} },
 					foreshadows: { "<summary.planted.key 或 FS-xxx>": {
 						action: "created | updated | no_change",
@@ -10745,27 +11265,27 @@ var EngineService = class {
 				},
 				examples: [{
 					summary_excerpt: {
-						characters_appeared: ["陈嘉树"],
+						characters_appeared: ["角色甲"],
 						foreshadows: {
 							planted: [],
 							advanced: ["FS-001"],
 							resolved: []
 						}
 					},
-					characters: { 陈嘉树: {
+					characters: { 角色甲: {
 						action: "updated",
-						current_state: { resources: { 港币: -3 } }
+						current_state: { resources: { 资源名: -3 } }
 					} },
 					foreshadows: { "FS-001": {
 						action: "updated",
-						note: "欠条被收回",
+						note: "债务已结清",
 						new_info: true
 					} }
 				}, {
 					summary_excerpt: {
 						events: ["收到信"],
 						new_elements: {
-							locations: ["旧码头"],
+							locations: ["地点甲"],
 							abilities: [],
 							artifacts: []
 						}
@@ -10775,31 +11295,31 @@ var EngineService = class {
 						story_time: "Day 3 清晨",
 						description: "收到信"
 					} },
-					world: { 旧码头: {
+					world: { 地点甲: {
 						action: "created",
 						kind: "location",
-						description: "退潮时露出石阶"
+						description: "地点说明"
 					} }
 				}],
 				linked_example: {
 					summary: {
-						characters_appeared: ["陈嘉树"],
+						characters_appeared: ["角色甲"],
 						new_elements: {
-							locations: ["旧码头"],
+							locations: ["地点甲"],
 							abilities: [],
 							artifacts: []
 						},
 						events: ["收到信"]
 					},
 					delta: {
-						characters: { 陈嘉树: {
+						characters: { 角色甲: {
 							action: "no_change",
 							reason: "本章无变化"
 						} },
-						world: { 旧码头: {
+						world: { 地点甲: {
 							action: "created",
 							kind: "location",
-							description: "退潮时露出石阶"
+							description: "地点说明"
 						} },
 						timeline: { "0": {
 							action: "created",
@@ -12888,15 +13408,18 @@ var EngineService = class {
 		const target = snapshot.project.targets.total_chapters;
 		const finished = snapshot.pipeline.stage === "done" && target !== null && archived.length >= target;
 		const draftWords = snapshot.text === null ? 0 : countWordMetrics(snapshot.text).total_word_count;
-		const journal = await readJournal(this.storeFor(snapshot.root));
 		const pending = await inspectPending(this.storeFor(snapshot.root));
+		const stateErrorCount = this.stateErrors(snapshot).length;
+		const panelCacheKey = `${snapshot.root}:${snapshot.pipeline.revision}:${pending.state}:${stateErrorCount}:${snapshot.outlineError ?? ""}:${snapshot.worldbookError ?? ""}:${JSON.stringify(snapshot.briefs)}`;
+		const cachedPanel = this.panelCache.get(snapshot.root);
+		if (cachedPanel?.key === panelCacheKey) return cachedPanel.snapshot;
+		const journal = await readJournal(this.storeFor(snapshot.root));
 		const journalBlocking = await this.journalBlocking(snapshot);
 		const outline = outlineSummary(snapshot.outline, archived.length, target, archived.map((record) => record.num));
 		const counts = worldbookCounts(snapshot.worldbook);
 		const scores = archived.slice(-10).map((chapter) => chapter.score);
 		const blocking = [...this.effectiveBlocking(snapshot), ...journalBlocking];
 		const healthBlocking = blocking.length;
-		const stateErrorCount = this.stateErrors(snapshot).length;
 		const book = {
 			premise: snapshot.outline.book.premise,
 			logline: snapshot.outline.book.logline,
@@ -12940,11 +13463,16 @@ var EngineService = class {
 		const store = this.storeFor(snapshot.root);
 		const reviewNames = new Set(await store.list(REVIEW_DIR));
 		const sampleChapters = /* @__PURE__ */ new Set();
+		const currentReviews = [];
 		for (const record of archived) {
 			const name = reviewFile(record.num).slice(`${REVIEW_DIR}/`.length);
 			if (!reviewNames.has(name)) continue;
 			try {
-				if (await store.readDoc(reviewFile(record.num), "review") !== null) sampleChapters.add(record.num);
+				const review = await store.readDoc(reviewFile(record.num), "review");
+				if (review !== null) {
+					sampleChapters.add(record.num);
+					currentReviews.push(review);
+				}
 			} catch {}
 		}
 		const samples = sampleChapters.size;
@@ -12975,15 +13503,66 @@ var EngineService = class {
 			chapter: row.chapter,
 			status: row.status
 		}));
+		const draftMetrics = snapshot.text === null ? null : countWordMetrics(snapshot.text);
+		const bookData = buildPanelBookData({
+			report: buildBookReport({
+				project: snapshot.project,
+				outline: snapshot.outline,
+				outlinePresent: snapshot.outlinePresent,
+				outlineError: snapshot.outlineError,
+				worldbook: snapshot.worldbook,
+				worldbookPresent: snapshot.worldbookPresent,
+				worldbookError: snapshot.worldbookError,
+				world: snapshot.world,
+				chapters: archived,
+				characters: snapshot.characters,
+				timeline: snapshot.timeline,
+				foreshadows: snapshot.foreshadows,
+				relationships: snapshot.relationships,
+				reviews: currentReviews,
+				activity: journal.rows.slice(-8),
+				journal: journal.rows,
+				reviewAttempts: attempts,
+				finalChecks: Object.fromEntries(archived.filter((record) => record.final_check === "pass" || record.final_check === "fail").map((record) => [record.num, record.final_check])),
+				targetChapters: target,
+				minScore: this.config.quality.minScore,
+				foreshadowDormantAfter: this.rulepack.crosschapter.foreshadow_dormant_after
+			}),
+			project: snapshot.project,
+			worldbook: snapshot.worldbook,
+			world: snapshot.world,
+			outline: snapshot.outline,
+			outlinePresent: snapshot.outlinePresent,
+			worldbookPresent: snapshot.worldbookPresent,
+			currentChapter: snapshot.pipeline.chapter,
+			stage: snapshot.pipeline.stage,
+			rounds: snapshot.pipeline.rounds,
+			draftWords,
+			lastTenAverage: scores.length === 0 ? 0 : scores.reduce((total, score) => total + score, 0) / scores.length,
+			manuscriptHash: snapshot.pipeline.draft?.content_hash ?? (snapshot.text === null ? null : sha256(snapshot.text)),
+			metrics: draftMetrics,
+			stateErrors: this.stateErrors(snapshot).map((error) => ({
+				path: error.path,
+				code: error.code,
+				message: error.message
+			})),
+			pending: pending.state === "none" ? null : {
+				state: pending.state,
+				txid: pending.txid ?? "",
+				detail: pending.detail ?? ""
+			},
+			outlineError: snapshot.outlineError,
+			worldbookError: snapshot.worldbookError
+		});
 		const draft = archivedCurrent || snapshot.pipeline.stage === "done" ? null : {
 			num: snapshot.pipeline.chapter,
 			title: stripTitlePrefix(snapshot.plan?.title ?? "") || `第${snapshot.pipeline.chapter}章`,
 			wordCount: draftWords,
 			score: snapshot.review?.total ?? 0,
 			status: blocking.length > 0 ? "blocked" : "draft",
-			details: (snapshot.plan?.summary?.events ?? []).join("；").slice(0, 240)
+			details: (snapshot.pipeline.draft?.summary?.events ?? []).join("；").slice(0, 240)
 		};
-		return {
+		const result = {
 			root: snapshot.root,
 			title: snapshot.project.title,
 			genre: snapshot.project.genre,
@@ -13014,11 +13593,13 @@ var EngineService = class {
 			averageScore: archived.length === 0 ? 0 : archived.reduce((total, chapter) => total + chapter.score, 0) / archived.length,
 			phases: phaseStrip(snapshot.pipeline.stage, finished),
 			book,
+			bookData,
 			quality,
 			health: {
-				ok: healthBlocking === 0 && stateErrorCount === 0,
+				ok: healthBlocking === 0 && stateErrorCount === 0 && pending.state === "none",
 				blocking: healthBlocking,
-				stateErrors: stateErrorCount
+				stateErrors: stateErrorCount,
+				pending: pending.state !== "none"
 			},
 			activity,
 			...advisories.length === 0 ? {} : { advisories },
@@ -13030,6 +13611,15 @@ var EngineService = class {
 				detail: pending.detail ?? ""
 			} }
 		};
+		this.panelCache.set(snapshot.root, {
+			key: panelCacheKey,
+			snapshot: result
+		});
+		if (this.panelCache.size > 16) {
+			const oldest = this.panelCache.keys().next().value;
+			if (oldest !== void 0) this.panelCache.delete(oldest);
+		}
+		return result;
 	}
 	/**
 	* The archive stage can be left by a direct revision (the 0.2.3 workflow) or
@@ -13324,7 +13914,7 @@ var EngineService = class {
 				code: "PG-13",
 				scope: "outline",
 				detail: `chapter ${snapshot.pipeline.chapter} has no outline card while strict mode is on`,
-				hint: "call novel_outline to add the card, or novel_blueprint {\"strict\":false} to turn strict mode off"
+				hint: "call novel_outline to add the missing card; do not turn strict mode off just to pass this gate"
 			};
 		}
 		const plan = snapshot.plan;
@@ -13376,6 +13966,11 @@ var EngineService = class {
 			code: "PROJECT_UNREADABLE",
 			message: snapshot.projectError
 		});
+		if (snapshot.pipelineError !== null) errors.push({
+			path: joinRel(STATE_DIR, STATE_FILES.pipeline),
+			code: "PIPELINE_UNREADABLE",
+			message: snapshot.pipelineError
+		});
 		const chapter = snapshot.pipeline.chapter;
 		if (snapshot.worldPlanError !== null) errors.push({
 			path: planWorldFile(chapter),
@@ -13411,6 +14006,11 @@ var EngineService = class {
 	}
 	/** The earliest rebuild point for the current state damage. */
 	recoveryFor(snapshot) {
+		if (snapshot.pipelineError !== null) return {
+			tool: "novel_restore",
+			args: { paths: [joinRel(STATE_DIR, STATE_FILES.pipeline)] },
+			reason: `PIPELINE_UNREADABLE: ${snapshot.pipelineError}; choose a backup with a pipeline pre-image and pass its txid`
+		};
 		const chapter = snapshot.pipeline.chapter;
 		const errors = this.stateErrors(snapshot);
 		if (snapshot.projectError !== null) return {
@@ -13759,7 +14359,7 @@ var EngineService = class {
 			summary: extras.summary ?? snapshot.pipeline.draft?.summary ?? snapshot.plan?.summary ?? null,
 			summaryProvided: extras.summaryProvided,
 			summaryOnly: extras.summaryOnly,
-			summaryOnlyRevision: extras.summaryOnlyRevision ?? snapshot.pipeline.last_action?.op === "novel_revise_summary",
+			summaryOnlyRevision: extras.summaryOnlyRevision ?? (operation === "runCheck" && snapshot.pipeline.stage === "P6" && snapshot.pipeline.last_action?.op === "novel_revise_summary"),
 			review: extras.review ?? snapshot.review,
 			check: extras.check ?? snapshot.check,
 			semantic: extras.semantic ?? [],
@@ -13886,8 +14486,22 @@ var EngineService = class {
 				actualTitle: project.title
 			});
 		}
-		const pipeline = await store.readDoc(joinRel(STATE_DIR, STATE_FILES.pipeline), "pipeline");
-		if (pipeline === null) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "state/pipeline.yaml is missing");
+		const pipelinePath = joinRel(STATE_DIR, STATE_FILES.pipeline);
+		let pipeline = null;
+		let pipelineError = null;
+		try {
+			pipeline = await store.readDoc(pipelinePath, "pipeline");
+			if (pipeline === null) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "state/pipeline.yaml is missing");
+		} catch (error) {
+			pipelineError = errorMessage(error);
+			const backup = await this.latestBackup(store, pipelinePath);
+			if (backup === null) throw error;
+			try {
+				pipeline = narrow("pipeline", parse(backup));
+			} catch {
+				throw error;
+			}
+		}
 		let briefs = pipeline.briefs;
 		const briefsRaw = await store.readText(BRIEF_RECEIPTS_FILE);
 		if (briefsRaw !== null) {
@@ -14026,10 +14640,12 @@ var EngineService = class {
 		if (planRaw === null && planError === null && cycleRank >= STAGE_RANK.P3) planError = `${planChapterFile(chapter)} is missing`;
 		if (review === null && reviewError === null && cycleRank >= STAGE_RANK.P5) reviewError = `${reviewFile(chapter)} is missing`;
 		if (check === null && checkError === null && pipeline.stage === "ready_to_archive") checkError = `${checkFile(chapter)} is missing`;
-		const latest = await store.readDoc(joinRel(STATE_DIR, STATE_FILES.pipeline), "pipeline");
-		if (latest === null || latest.revision !== pipeline.revision) {
-			if (retries > 0) return this.loadAt(selection, retries - 1, allowLock);
-			throw new EngineFaultError(ERROR_CODES.TXN_ABORTED, "the project changed while its snapshot was being read", "retry the read; if it keeps moving, wait for the writer to finish");
+		if (pipelineError === null) {
+			const latest = await store.readDoc(joinRel(STATE_DIR, STATE_FILES.pipeline), "pipeline");
+			if (latest === null || latest.revision !== pipeline.revision) {
+				if (retries > 0) return this.loadAt(selection, retries - 1, allowLock);
+				throw new EngineFaultError(ERROR_CODES.TXN_ABORTED, "the project changed while its snapshot was being read", "retry the read; if it keeps moving, wait for the writer to finish");
+			}
 		}
 		if (!allowLock && await this.lockIsLive(store)) {
 			if (retries > 0) return this.loadAt(selection, retries - 1, false);
@@ -14040,6 +14656,7 @@ var EngineService = class {
 			selection,
 			project,
 			projectError,
+			pipelineError,
 			pipeline,
 			briefs,
 			chapters,
@@ -14194,6 +14811,7 @@ var EngineService = class {
 				}
 				await assertJournalConsistent(store, options.repairPaths ?? []);
 				const snapshot = await this.loadAt(selection, 1, true);
+				if (snapshot.pipelineError !== null && options.allowPipelineRecovery !== true) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `state/pipeline.yaml is unreadable: ${snapshot.pipelineError}`, "restore a valid pipeline backup with novel_restore { paths: [\"state/pipeline.yaml\"], txid: ... }; other writes are blocked until then");
 				if (selection.source === "session" && selection.created_at !== void 0 && selection.created_at !== "" && snapshot.projectError !== null) throw identityMismatchError({
 					selection,
 					actualTitle: snapshot.project.title
@@ -14242,7 +14860,8 @@ var EngineService = class {
 						},
 						...error instanceof EngineError ? { code: error.code } : {},
 						...error instanceof EngineError && error.hint !== void 0 ? { hint: error.hint } : {},
-						...error instanceof EngineBlockedError ? { blocking: error.blocking } : {}
+						...error instanceof EngineBlockedError ? { blocking: error.blocking } : {},
+						...error instanceof CheckSubmissionError ? { blocking: error.blocking.slice(0, 20) } : {}
 					}).catch(() => void 0);
 					throw error;
 				}
@@ -14309,6 +14928,7 @@ var EngineService = class {
 			selection,
 			project: { ...ENGINE_PROJECT_INITIAL },
 			projectError: null,
+			pipelineError: null,
 			pipeline: emptyPipeline({
 				revision: 1,
 				chapter: 1,
@@ -16006,7 +16626,7 @@ function createNovelTools(engine, options = {}) {
 		}),
 		defineTool({
 			name: "novel_restore",
-			description: "Restore an active chapter file, or outline/outline.yaml, from a marked backup transaction. Archived chapters are refused; use novel_reopen first. Every restore is itself journaled and backed up.",
+			description: "Restore an active chapter file, outline/outline.yaml, or a damaged state/pipeline.yaml from a marked backup transaction. Archived chapters are refused; use novel_reopen first. Every restore is itself journaled and backed up.",
 			parameters: {
 				txid: {
 					type: "string",
@@ -16016,7 +16636,7 @@ function createNovelTools(engine, options = {}) {
 				paths: {
 					type: "array",
 					items: { type: "string" },
-					description: arraySemanticsDescription("replace", "Project-relative chapter files, or exactly [outline/outline.yaml]; omitted restores every restorable chapter file the manifest records.")
+					description: arraySemanticsDescription("replace", "Project-relative chapter files, exactly [outline/outline.yaml], or exactly [state/pipeline.yaml] when the pipeline is unreadable; omitted restores every restorable chapter file the manifest records.")
 				},
 				project_root: root
 			},
@@ -16511,7 +17131,7 @@ function createSkill() {
 async function panelPayload(engine, root) {
 	return {
 		...await engine.panelBundle(root === void 0 ? {} : { root }),
-		schemaVersion: 5
+		schemaVersion: 6
 	};
 }
 const queryRoot = (url) => {
@@ -16561,7 +17181,7 @@ function panelHandler(engine, guard = denyAll) {
 				response.setHeader("content-type", "application/json; charset=utf-8");
 				response.setHeader("cache-control", "no-store");
 				response.end(JSON.stringify({
-					schemaVersion: 5,
+					schemaVersion: 6,
 					projects: [],
 					selection: {
 						root: null,
@@ -16576,7 +17196,7 @@ function panelHandler(engine, guard = denyAll) {
 			response.setHeader("content-type", "application/json; charset=utf-8");
 			response.setHeader("cache-control", "no-store");
 			response.end(JSON.stringify({
-				schemaVersion: 5,
+				schemaVersion: 6,
 				projects: [],
 				selection: {
 					root: null,