dsh-novel-write-engine 0.2.4 → 0.2.6

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. */
@@ -245,6 +245,9 @@ const ERROR_CODES = {
 	/** The exact same keyed submission already failed in the same context. */
 	RETRY_UNCHANGED: "ENGINE_RETRY_UNCHANGED",
 	GATE_BLOCKED: "ENGINE_GATE_BLOCKED",
+	CHECK_SUBMISSION_INVALID: "ENGINE_CHECK_SUBMISSION_INVALID",
+	PENDING_PARTIAL: "ENGINE_PENDING_PARTIAL",
+	IO_PERMISSION: "ENGINE_IO_PERMISSION",
 	READING_PROOF_INVALID: "ENGINE_READING_PROOF_INVALID",
 	SCORE_MISMATCH: "ENGINE_SCORE_MISMATCH",
 	/** A revision tried to rewrite reviewer-owned issue fields. */
@@ -520,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) {
@@ -624,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
@@ -1393,7 +1472,7 @@ const duplicateParagraph = (ctx) => {
 	}
 	const blocker = ctx.rulepack.crosschapter.duplicate_similarity;
 	const severity = best.score >= blocker ? "blocker" : "advisory";
-	return [v(CROSS_RULES.DUPLICATE_PARAGRAPH, severity, currentParagraph + 1, `paragraph ${currentParagraph + 1} reuses ${Math.round(best.score * 100)}% of paragraph ${previousParagraph - matched.start + 1} from previous source ${matched.source} (advisory ≥${Math.round(advisory * 100)}%, blocker ≥${Math.round(blocker * 100)}%)`)];
+	return [v(CROSS_RULES.DUPLICATE_PARAGRAPH, severity, currentParagraph + 1, `paragraph ${currentParagraph + 1} reuses ${Math.round(best.score * 100)}% of paragraph ${previousParagraph + 1} from previous source ${matched.source} (advisory ≥${Math.round(advisory * 100)}%, blocker ≥${Math.round(blocker * 100)}%)`)];
 };
 const foreshadowDormant = (ctx) => {
 	const ledger = ctx.evidence.foreshadows;
@@ -1508,11 +1587,12 @@ const timeRegression = (ctx) => {
 	const ordered = [...ledger.items].sort((left, right) => left.chapter - right.chapter);
 	const last = ordered[ordered.length - 1];
 	const previous = ordered.length >= 2 ? ordered[ordered.length - 2] : null;
-	const currentFromText = dayOf(ctx.text);
+	const currentMatch = /(?:Day\s*(\d+)|第\s*(\d+)\s*[天日])/i.exec(ctx.text);
+	const currentFromText = currentMatch === null ? null : Number(currentMatch[1] ?? currentMatch[2]);
 	const current = currentFromText ?? dayOf(last.story_time);
 	const before = previous === null ? null : dayOf(previous.story_time);
 	if (current === null) return [];
-	if (currentFromText !== null && dayOf(last.story_time) !== null && currentFromText < dayOf(last.story_time)) return [v(CROSS_RULES.TIME_REGRESSION, "advisory", ctx.chapter, `story time goes back from ${last.story_time} to Day ${currentFromText}`)];
+	if (currentFromText !== null && dayOf(last.story_time) !== null && currentFromText < dayOf(last.story_time)) return [v(CROSS_RULES.TIME_REGRESSION, "advisory", paragraphOfIndex(ctx.text, currentMatch.index), `story time goes back from ${last.story_time} to Day ${currentFromText}`)];
 	if (before === null || current >= before) return [];
 	return [v(CROSS_RULES.TIME_REGRESSION, "advisory", last.chapter, `story time goes back from ${previous.story_time} to ${last.story_time}`)];
 };
@@ -1922,6 +2002,8 @@ const SCHEMAS = {
 		machine: req("object"),
 		semantic: req("object"),
 		acknowledged: f("array"),
+		failure_class: f("string", { enum: ["submission", "content"] }),
+		counted: f("boolean"),
 		verdict: req("string", { enum: ["pass", "fail"] })
 	},
 	worldPlan: {
@@ -1962,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) => {
@@ -2004,6 +2086,24 @@ const nullableInteger = (kind, value, path) => {
 const validateRecords = (kind, value, path, validate) => {
 	for (const [index, raw] of listAt(kind, value, path).entries()) validate(objectAt(kind, raw, `${path}[${index}]`), `${path}[${index}]`);
 };
+const duplicateNames = (kind, rows, path, nameOf) => {
+	const seen = /* @__PURE__ */ new Set();
+	for (const row of rows) {
+		const name = nameOf(row);
+		if (typeof name !== "string" || name === "") continue;
+		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 [
@@ -2018,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`);
@@ -2032,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");
@@ -2097,6 +2209,7 @@ const validateNested = (kind, record) => {
 				listAt(kind, row.growth, `${path}.growth`);
 				integerAt(kind, row.updated_at, `${path}.updated_at`);
 			});
+			duplicateNames(kind, record.characters, "characters", (row) => row.name);
 			return;
 		case "world":
 			validateRecords(kind, record.locations, "locations", (row, path) => {
@@ -2107,13 +2220,28 @@ 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 [
+					"locations",
+					"abilities",
+					"artifacts",
+					"factions",
+					"rules"
+				]) {
+					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$2(kind, "world entities must have unique names");
+			}
 			return;
 		case "locks": {
 			integerAt(kind, record.locked_at_chapter, "locked_at_chapter");
@@ -2183,10 +2311,16 @@ 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`);
 			});
+			if (semantic.findings !== void 0) validateRecords(kind, semantic.findings, "semantic.findings", (row, path) => {
+				stringAt(kind, row.code, `${path}.code`);
+				stringAt(kind, row.detail, `${path}.detail`);
+				if (row.scope !== void 0) stringAt(kind, row.scope, `${path}.scope`);
+				if (row.hint !== void 0) stringAt(kind, row.hint, `${path}.hint`);
+			});
 			return;
 		}
 		case "outline": {
@@ -2226,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`);
@@ -2287,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",
@@ -2322,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;
@@ -2386,7 +2520,7 @@ var FsStore = class {
 				if ((await promises.lstat(current)).isSymbolicLink()) throw new EngineFaultError(ERROR_CODES.PATH_ESCAPE, `refusing path "${relativePath}": "${segment}" is a symlink`);
 			} catch (error) {
 				if (isMissing(error)) break;
-				throw error;
+				throw ioFailure(error);
 			}
 		}
 		return absolute;
@@ -2403,7 +2537,7 @@ var FsStore = class {
 			return true;
 		} catch (error) {
 			if (isMissing(error)) return false;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async stat(relativePath) {
@@ -2416,7 +2550,7 @@ var FsStore = class {
 			};
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async list(relativeDir) {
@@ -2424,7 +2558,7 @@ var FsStore = class {
 			return (await promises.readdir(await this.safePath(relativeDir))).sort();
 		} catch (error) {
 			if (isMissing(error)) return [];
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	/**
@@ -2441,7 +2575,7 @@ var FsStore = class {
 			})).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
 		} catch (error) {
 			if (isMissing(error)) return [];
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	/**
@@ -2459,7 +2593,7 @@ var FsStore = class {
 			};
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	/**
@@ -2479,7 +2613,7 @@ var FsStore = class {
 			};
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async readText(relativePath) {
@@ -2487,7 +2621,7 @@ var FsStore = class {
 			return await promises.readFile(await this.safePath(relativePath), "utf8");
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	/** Read and narrow one of the twelve engine documents. */
@@ -2521,7 +2655,7 @@ var FsStore = class {
 				await promises.mkdir(current);
 			} catch (error) {
 				if (error.code === "EEXIST") continue;
-				throw error;
+				throw ioFailure(error);
 			}
 		}
 	}
@@ -2542,7 +2676,7 @@ var FsStore = class {
 			await syncDirectory(dirname(absolute));
 		} catch (error) {
 			await promises.rm(temp, { force: true }).catch(() => void 0);
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async writeDoc(relativePath, document) {
@@ -2587,7 +2721,7 @@ var FsStore = class {
 			return await promises.readFile(await this.safePath(relativePath));
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async writeBytes(relativePath, bytes) {
@@ -2606,7 +2740,7 @@ var FsStore = class {
 			await syncDirectory(dirname(absolute));
 		} catch (error) {
 			await promises.rm(temp, { force: true }).catch(() => void 0);
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	/** Content hash of a file, or null when missing. */
@@ -2634,6 +2768,12 @@ async function syncDirectory(directory) {
 function isMissing(error) {
 	return typeof error === "object" && error !== null && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
 }
+function ioFailure(error) {
+	if (error instanceof EngineFaultError) return error;
+	const code = typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
+	if (code === "EACCES" || code === "EPERM" || code === "EROFS") return new EngineFaultError(ERROR_CODES.IO_PERMISSION, `filesystem permission denied (${code}): ${error instanceof Error ? error.message : String(error)}`, "fix the project directory permissions, or restore a readable copy before retrying", { cause: error });
+	return error;
+}
 /** Join project-relative segments with forward slashes. */
 function joinRel(...parts) {
 	return parts.filter((part) => part !== "").join("/");
@@ -2757,21 +2897,18 @@ async function reconcileJournal(store) {
 	};
 }
 /**
-* Resolve a pending transaction left by a crash. The pending row is written
-* after the pre-images are captured and before the first rename, so it is the
-* only record that can distinguish "renamed but not journaled" from "crashed
-* before touching a target". A fully matching pending transaction is promoted
-* to committed; a transaction whose targets all still match their pre-images
-* is closed as aborted; any mixture is refused as a partial commit.
+* Read-only classification of the last pending transaction. Status/doctor/
+* audit must never call recoverPending: recovery writes a terminal journal row,
+* and a read command is not allowed to mutate the project.
 */
-async function recoverPending(store) {
+async function inspectPending(store) {
 	const { records } = await readJournal(store);
 	const last = [...records].reverse().find((record) => record.op !== "lock_reclaimed");
-	if (last?.status !== "pending") return;
+	if (last?.status !== "pending") return { state: "none" };
 	const matchesExpected = async () => {
 		if (last.hashes === void 0) return false;
 		for (const [path, expected] of Object.entries(last.hashes)) if (await store.hashBytes(path) !== expected) return false;
-		return true;
+		return Object.keys(last.hashes).length > 0;
 	};
 	const matchesBefore = async () => {
 		if (last.before === void 0) return false;
@@ -2779,9 +2916,45 @@ async function recoverPending(store) {
 			const actual = await store.hashBytes(path);
 			if (expected === null ? actual !== null : actual !== expected) return false;
 		}
-		return true;
+		return Object.keys(last.before).length > 0;
 	};
-	if (await matchesExpected()) {
+	if (await matchesExpected()) return {
+		state: "complete",
+		txid: last.txid,
+		files: last.files,
+		detail: "all target files match the pending hashes; the next write can promote this transaction",
+		stagingDir: joinRel(STAGING_DIR, last.txid)
+	};
+	if (await matchesBefore()) return {
+		state: "untouched",
+		txid: last.txid,
+		files: last.files,
+		detail: "no target changed; the next write can close this transaction as aborted",
+		stagingDir: joinRel(STAGING_DIR, last.txid)
+	};
+	return {
+		state: "partial",
+		txid: last.txid,
+		files: last.files,
+		detail: "some targets changed and others did not; automatic recovery is unsafe",
+		stagingDir: joinRel(STAGING_DIR, last.txid)
+	};
+}
+/**
+* Resolve a pending transaction left by a crash. The pending row is written
+* after the pre-images are captured and before the first rename, so it is the
+* only record that can distinguish "renamed but not journaled" from "crashed
+* before touching a target". A fully matching pending transaction is promoted
+* to committed; a transaction whose targets all still match their pre-images
+* is closed as aborted; any mixture is refused as a partial commit.
+*/
+async function recoverPending(store) {
+	const inspection = await inspectPending(store);
+	if (inspection.state === "none" || inspection.txid === void 0) return;
+	const { records } = await readJournal(store);
+	const last = [...records].reverse().find((record) => record.txid === inspection.txid);
+	if (last === void 0 || last.status !== "pending") return;
+	if (inspection.state === "complete") {
 		await appendJournal(store, {
 			...last,
 			status: "committed"
@@ -2789,7 +2962,7 @@ async function recoverPending(store) {
 		await store.removeTree(joinRel(STAGING_DIR, last.txid)).catch(() => void 0);
 		return;
 	}
-	if (await matchesBefore()) {
+	if (inspection.state === "untouched") {
 		await appendJournal(store, {
 			...last,
 			status: "aborted",
@@ -2799,7 +2972,7 @@ async function recoverPending(store) {
 		await store.removeTree(joinRel(STAGING_DIR, last.txid)).catch(() => void 0);
 		return;
 	}
-	throw new EngineFaultError(ERROR_CODES.TXN_ABORTED, `pending transaction ${last.txid} partially changed the project; automatic recovery is unsafe`, `restore from backups/ or ${STAGING_DIR}/${last.txid}/before/ before retrying`);
+	throw new EngineFaultError(ERROR_CODES.PENDING_PARTIAL, `pending transaction ${last.txid} partially changed the project; automatic recovery is unsafe`, `inspect ${STAGING_DIR}/${last.txid}/before/ and state/journal.jsonl before restoring anything`);
 }
 /**
 * A crash during append can leave one JSONL fragment without a newline. Since
@@ -2991,22 +3164,43 @@ var FileLock = class {
 			if (Date.now() - mtimeMs <= this.staleMs) return false;
 		} else if (lockRecordIsLive(record)) return false;
 		const claimPath = `${this.absolutePath}.reclaim-${randomUUID()}`;
+		let claimByRename = false;
 		try {
 			await promises.link(this.absolutePath, claimPath);
 		} catch (error) {
 			const code = error.code;
 			if (code === "ENOENT") return true;
 			if (code === "EPERM" || code === "EACCES") return false;
-			throw error;
+			if ([
+				"ENOSYS",
+				"ENOTSUP",
+				"EOPNOTSUPP",
+				"EXDEV",
+				"EINVAL"
+			].includes(code ?? "")) try {
+				await promises.rename(this.absolutePath, claimPath);
+				claimByRename = true;
+			} catch (renameError) {
+				if (renameError.code === "ENOENT") return true;
+				throw renameError;
+			}
+			else throw error;
 		}
 		const moved = await this.readAt(claimPath);
 		const claimMtime = await promises.stat(claimPath).then((info) => info.mtimeMs).catch(() => Date.now());
 		if (!(record === null ? moved === null && Date.now() - claimMtime > this.staleMs : moved !== null && moved.pid === record.pid && moved.startedAt === record.startedAt && moved.nonce === record.nonce)) {
-			await promises.rm(claimPath, { force: true }).catch(() => void 0);
+			if (claimByRename) await promises.access(this.absolutePath).then(async () => {
+				await promises.rm(claimPath, { force: true }).catch(() => void 0);
+			}, async () => {
+				await promises.rename(claimPath, this.absolutePath).catch(async () => {
+					await promises.rm(claimPath, { force: true }).catch(() => void 0);
+				});
+			});
+			else await promises.rm(claimPath, { force: true }).catch(() => void 0);
 			return false;
 		}
-		const current = await this.readAt(this.absolutePath);
-		if (!(record === null ? current === null : current !== null && current.pid === record.pid && current.startedAt === record.startedAt && current.nonce === record.nonce)) {
+		const current = claimByRename ? null : await this.readAt(this.absolutePath);
+		if (!(claimByRename || (record === null ? current === null : current !== null && current.pid === record.pid && current.startedAt === record.startedAt && current.nonce === record.nonce))) {
 			await promises.rm(claimPath, { force: true }).catch(() => void 0);
 			return false;
 		}
@@ -3025,6 +3219,7 @@ const BACKUP_MANIFEST = "manifest.json";
 async function listBackups(store) {
 	const entries = [];
 	for (const name of await store.list(BACKUP_DIR)) {
+		if (name === "migrations") continue;
 		const info = await store.stat(joinRel(BACKUP_DIR, name));
 		if (info === null || !info.isDirectory) continue;
 		if (!await store.exists(joinRel("backups", name, ".engine-backup"))) continue;
@@ -3847,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();
@@ -3949,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 [
@@ -3977,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}`);
@@ -4094,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`);
@@ -4118,7 +4313,7 @@ function normalizeOutlineChapters(input, options) {
 				notes: raw.notes === void 0 || raw.notes === base.notes ? base.notes : optionalText(raw.notes, `chapter ${num} notes`, LIMITS.maxOutlineNotesChars),
 				volume: volumeForChapter(options.volumes, num, raw.volume === void 0 ? base.volume : raw.volume),
 				status: "archived",
-				archived_at: base.archived_at ?? options.now,
+				archived_at: base.archived_at ?? record.archived_at ?? null,
 				word_count: record.word_count,
 				score: record.score
 			});
@@ -4159,7 +4354,7 @@ function normalizeOutlineChapters(input, options) {
 			...base,
 			volume: volumeForChapter(options.volumes, record.num, base.volume),
 			status: "archived",
-			archived_at: base.archived_at ?? options.now,
+			archived_at: base.archived_at ?? record.archived_at ?? null,
 			word_count: record.word_count,
 			score: record.score
 		});
@@ -4168,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([
@@ -4180,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",
@@ -4204,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`);
@@ -4270,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,
@@ -4290,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;
 		});
 	};
@@ -4370,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([
@@ -4781,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([
@@ -4812,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}`);
@@ -4833,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)));
@@ -4847,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;
@@ -4867,19 +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)}`));
+	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();
@@ -4914,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;
@@ -4953,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);
@@ -5003,18 +5199,30 @@ const remapVolume = (card, oldVolumes, newVolumes) => {
 		volume: card.num >= next.start_chapter && card.num <= next.end_chapter ? nextIndex + 1 : null
 	};
 };
-const assertArchivedVolumes = (options, volumes, removedTitles) => {
-	const removed = new Set(removedTitles);
-	const oldByTitle = volumeByTitle(options.existingVolumes);
-	const newByTitle = volumeByTitle(volumes);
-	for (const record of options.archivedChapters) {
-		const card = options.existing.find((entry) => entry.num === record.num);
-		if (card === void 0 || card.volume === null) continue;
-		const previous = options.existingVolumes[card.volume - 1];
+const assertArchivedCardVolumes = (archivedChapters, cards, oldVolumes, newVolumes, operation = "outline write") => {
+	const byNum = new Map(cards.map((card) => [card.num, card]));
+	const newByTitle = volumeByTitle(newVolumes);
+	for (const record of archivedChapters) {
+		const card = byNum.get(record.num);
+		const previous = card !== void 0 && card.volume !== null && card.volume !== void 0 ? oldVolumes[card.volume - 1] : oldVolumes.find((volume) => record.num >= volume.start_chapter && record.num <= volume.end_chapter);
 		if (previous === void 0) continue;
-		if (removed.has(previous.title) || !oldByTitle.has(previous.title)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `cannot remove volume "${previous.title}": archived chapter ${record.num} belongs to it`, "archived cards are evidence; keep the volume or reopen the chapter first");
 		const next = newByTitle.get(previous.title);
-		if (next === void 0 || record.num < next.start_chapter || record.num > next.end_chapter) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volume "${previous.title}" no longer covers archived chapter ${record.num}`, "keep archived chapter ranges inside their existing volume");
+		if (next === void 0 || record.num < next.start_chapter || record.num > next.end_chapter) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${operation} would leave archived chapter ${record.num} outside its volume "${previous.title}"`, "keep the volume/range that covers archived cards, or call novel_reopen first");
+	}
+};
+/**
+* Final-document guard: every archived chapter with a volume-aware outline
+* must point at a volume that actually covers it. The old-card guard above
+* only proves the volume list did not drop the old range; an amend can still
+* write a card with `volume:null` or a stale index.
+*/
+const assertArchivedCardsInVolumes = (archivedChapters, cards, volumes, operation = "outline write") => {
+	if (volumes.length === 0) return;
+	const byNum = new Map(cards.map((card) => [card.num, card]));
+	for (const record of archivedChapters) {
+		const card = byNum.get(record.num);
+		const volume = card !== void 0 && card.volume !== null && card.volume !== void 0 ? volumes[card.volume - 1] : void 0;
+		if (volume === void 0 || record.num < volume.start_chapter || record.num > volume.end_chapter) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${operation} would leave archived chapter ${record.num} without a covering volume`, "keep a volume/range that covers every archived card, or call novel_reopen first");
 	}
 };
 /**
@@ -5026,7 +5234,7 @@ const mergeOutline = (options) => {
 	const submitted = submittedNumbers(options.chapters);
 	const removed = parseChapterNumbers(options.remove, "remove");
 	const volumeChanges = mergeVolumes(options);
-	assertArchivedVolumes(options, volumeChanges.volumes, volumeChanges.removed);
+	assertArchivedCardVolumes(options.archivedChapters, options.existing, options.existingVolumes, volumeChanges.volumes, "novel_outline");
 	const existingByNum = new Map(options.existing.map((card) => [card.num, card]));
 	const archivedByNum = new Map(options.archivedChapters.map((record) => [record.num, record]));
 	const archivedNums = new Set(archivedByNum.keys());
@@ -5036,9 +5244,10 @@ const mergeOutline = (options) => {
 		if (archivedByNum.has(num)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `cannot remove chapter ${num}: it is archived`, "archived cards are evidence; call novel_reopen first");
 		if (existingByNum.get(num)?.status !== "planned") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `cannot remove chapter ${num}: it is not a planned card`);
 	}
+	const existingForNormalize = options.existing.map((card) => archivedNums.has(card.num) ? remapVolume(card, options.existingVolumes, volumeChanges.volumes) : card);
 	const normalized = normalizeOutlineChapters(options.chapters, {
 		volumes: volumeChanges.volumes,
-		existing: options.existing,
+		existing: existingForNormalize,
 		archived: options.archivedChapters,
 		titleRule: options.titleRule,
 		totalChapters: options.totalChapters,
@@ -5048,6 +5257,7 @@ const mergeOutline = (options) => {
 	const byNum = new Map(normalized.map((card) => [card.num, card]));
 	const updated = /* @__PURE__ */ new Set();
 	const added = /* @__PURE__ */ new Set();
+	const reindexed = /* @__PURE__ */ new Set();
 	for (const card of normalized) {
 		if (!submitted.has(card.num)) continue;
 		const before = existingByNum.get(card.num);
@@ -5062,6 +5272,8 @@ const mergeOutline = (options) => {
 				...card,
 				status: "archived"
 			});
+			const current = byNum.get(card.num);
+			if (stableJson(card) !== stableJson(current)) reindexed.add(card.num);
 			continue;
 		}
 		const remapped = remapVolume(card, options.existingVolumes, volumeChanges.volumes);
@@ -5069,25 +5281,142 @@ const mergeOutline = (options) => {
 			const current = byNum.get(card.num);
 			if (stableJson(current) !== stableJson(remapped)) {
 				byNum.set(card.num, remapped);
-				if (card.status === "planned") updated.add(card.num);
+				reindexed.add(card.num);
 			}
 		} else {
 			byNum.set(card.num, remapped);
-			if (card.status === "planned" && stableJson(card) !== stableJson(remapped)) updated.add(card.num);
+			if (stableJson(card) !== stableJson(remapped)) reindexed.add(card.num);
 		}
 	}
 	for (const num of removed) byNum.delete(num);
+	const chapters = [...byNum.values()].sort((left, right) => left.num - right.num);
+	assertArchivedCardsInVolumes(options.archivedChapters, chapters, volumeChanges.volumes, "novel_outline");
 	return {
-		chapters: [...byNum.values()].sort((left, right) => left.num - right.num),
+		chapters,
 		volumes: volumeChanges.volumes,
 		added: [...added].sort((left, right) => left - right),
 		updated: [...updated].sort((left, right) => left - right),
+		reindexed: [...reindexed].sort((left, right) => left - right),
 		removed: [...removed].sort((left, right) => left - right),
 		volumes_added: volumeChanges.added,
 		volumes_updated: volumeChanges.updated,
 		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",
@@ -5111,6 +5440,28 @@ const setOwn = (record, key, value) => {
 		writable: true
 	});
 };
+/** Validate resource balances without accepting numeric strings or fractions. */
+const validateResources = (state, who) => {
+	if (state.resources === void 0) return;
+	if (!isRecord(state.resources)) fail$1(`${who}.current_state.resources must be an object`);
+	for (const [name, value] of Object.entries(state.resources)) {
+		if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value)) fail$1(`${who}.current_state.resources.${name} must be an integer`);
+		if (value < 0) throw new EngineInputError(ERROR_CODES.RESOURCE_NEGATIVE_BALANCE, `${who}'s ${name} balance is ${value}`, "state a non-negative integer balance; spend the resource before the balance reaches zero");
+	}
+};
+/** Current state is a patch; resources are a nested map, not a whole replacement. */
+const mergeCurrentState = (base, patch) => {
+	const merged = {
+		...base,
+		...patch
+	};
+	if (patch.resources !== void 0 && !isRecord(patch.resources)) fail$1("current_state.resources must be an object");
+	if (patch.resources !== void 0) merged.resources = {
+		...isRecord(base.resources) ? base.resources : {},
+		...patch.resources
+	};
+	return merged;
+};
 function fail$1(detail) {
 	throw new EngineInputError(ERROR_CODES.DELTA_UNVERIFIED, `state_delta is incomplete: ${detail}`, "declare every entity the chapter touched as created, updated, or no_change with a reason");
 }
@@ -5197,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);
@@ -5204,6 +5561,20 @@ function applyStateDelta(input) {
 	const timeline = structuredClone(input.timeline);
 	const relationships = structuredClone(input.relationships);
 	const assigned = Object.create(null);
+	const warnings = [];
+	const normalizedWorld = Object.create(null);
+	const warnReclass = (name, from, to, reason) => {
+		normalizedWorld[name] = {
+			from,
+			to,
+			reason
+		};
+		const code = reason === "existing-created-as-updated" ? "WORLD_ELEMENT_RECLASSIFIED_CREATED_TO_UPDATED" : reason === "missing-updated-as-created" ? "WORLD_ELEMENT_RECLASSIFIED_UPDATED_TO_CREATED" : "WORLD_ELEMENT_RECLASSIFIED_NO_CHANGE_TO_CREATED";
+		warnings.push({
+			code,
+			message: `world.${name}: ${from} normalized to ${to} against state/world.yaml (${reason})`
+		});
+	};
 	const appeared = [...new Set(summary.characters_appeared)];
 	const byName = new Map(characters.characters.map((character) => [character.name, character]));
 	const narrator = input.narrator ?? "";
@@ -5224,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`);
@@ -5235,12 +5606,14 @@ function applyStateDelta(input) {
 			if (!appeared.includes(name)) fail$1(`character "${name}" is created but does not appear in characters_appeared`);
 			const rawHint = input.roleHints?.[name];
 			const hinted = canonicalRole(rawHint) ?? (rawHint === void 0 && (name === narratorName || name === narrator) ? "protagonist" : "extra");
+			const currentState = declared.current_state ?? {};
+			validateResources(currentState, `characters.${name}`);
 			const created = {
 				name,
 				role: normalizeRole(declared.role, hinted),
 				first_appearance: chapter,
 				profile: declared.profile ?? {},
-				current_state: declared.current_state ?? {},
+				current_state: currentState,
 				growth: [],
 				updated_at: chapter
 			};
@@ -5261,10 +5634,11 @@ function applyStateDelta(input) {
 				...existing.profile,
 				...declared.profile
 			};
-			if (declared.current_state !== void 0) existing.current_state = {
-				...existing.current_state,
-				...declared.current_state
-			};
+			if (declared.current_state !== void 0) {
+				const merged = mergeCurrentState(existing.current_state, declared.current_state);
+				validateResources(merged, `characters.${name}`);
+				existing.current_state = merged;
+			}
 			if (declared.growth !== void 0) existing.growth.push({
 				...declared.growth,
 				chapter
@@ -5288,6 +5662,7 @@ function applyStateDelta(input) {
 			...state,
 			resources
 		};
+		validateResources(character.current_state, `characters.${change.character}`);
 	}
 	const findWorld = (name) => {
 		const location = world.locations.find((candidate) => candidate.name === name);
@@ -5315,16 +5690,30 @@ 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.action !== "created") fail$1(`world.${name} is new in this chapter; its action must be created`);
 		if (declared.kind !== void 0 && declared.kind !== kind) fail$1(`world.${name} is declared as ${declared.kind} but the summary lists it as ${kind}`);
+		if (findWorld(name) !== null) warnings.push({
+			code: "WORLD_ELEMENT_ALREADY_IN_LEDGER",
+			message: `summary.new_elements lists "${name}", but state/world.yaml already has it; ledger existence wins`
+		});
 	}
 	for (const [name, raw] of Object.entries(delta.world)) {
 		const declared = entry(raw, `world.${name}`);
@@ -5333,27 +5722,40 @@ function applyStateDelta(input) {
 		if (declared.layout !== void 0 && typeof declared.layout !== "string") fail$1(`world.${name}.layout must be a string`);
 		if (declared.capacity !== void 0 && (!Number.isInteger(declared.capacity) || declared.capacity < 0)) fail$1(`world.${name}.capacity must be a non-negative integer`);
 		if (declared.detail !== void 0 && !isRecord(declared.detail)) fail$1(`world.${name}.detail must be an object`);
-		if (declared.detail !== void 0) {
-			if (declared.action !== "created") {
-				for (const reserved of [
-					"name",
-					"first_appearance",
-					"description"
-				]) if (Object.hasOwn(declared.detail, reserved)) fail$1(`world.${name}.detail cannot rewrite the reserved field "${reserved}"`);
-			}
-		}
 		const expected = expectedKind(name);
-		if (expected !== null) {
-			if (declared.action !== "created") fail$1(`world.${name} is new in this chapter; its action must be created`);
-			if (declared.kind !== void 0 && declared.kind !== expected) fail$1(`world.${name} is declared as ${declared.kind} but the summary lists it as ${expected}`);
-		}
+		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);
-		if (declared.action === "created") {
+		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`);
+			if (expected !== null && expected !== existing.kind) fail$1(`world.${name} is listed as ${expected} but the ledger has ${existing.kind}`);
+			action = "updated";
+			warnReclass(name, "created", "updated", "existing-created-as-updated");
+		} else if (action === "updated" && existing === null) {
+			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) {
+			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");
+		}
+		if (declared.detail !== void 0 && action !== "created") {
+			for (const reserved of [
+				"name",
+				"first_appearance",
+				"description"
+			]) if (Object.hasOwn(declared.detail, reserved)) fail$1(`world.${name}.detail cannot rewrite the reserved field "${reserved}"`);
+		}
+		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",
@@ -5361,7 +5763,7 @@ function applyStateDelta(input) {
 				"faction",
 				"rule"
 			].includes(kind)) fail$1(`world.${name} has unknown kind "${String(kind)}"`);
-			if (expected === null && (kind === "location" || kind === "ability" || kind === "artifact")) fail$1(`world.${name} is created but is not listed in summary.new_elements`);
+			if (declared.action === "created" && expected === null && (kind === "location" || kind === "ability" || kind === "artifact")) fail$1(`world.${name} is created but is not listed in summary.new_elements`);
 			if (kind === "location") world.locations.push({
 				name,
 				first_appearance: chapter,
@@ -5369,23 +5771,27 @@ 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;
 		}
 		if (existing === null) fail$1(`world entity "${name}" does not exist; created must be used first`);
-		if (declared.action === "updated") {
+		if (declared.kind !== void 0 && existing.kind !== declared.kind) fail$1(`world.${name} is declared as ${declared.kind} but the ledger has ${existing.kind}; kind cannot change`);
+		if (action === "updated") {
 			if (existing.kind === "location") {
 				const location = existing.value;
 				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",
@@ -5394,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);
 			}
 		}
 	}
@@ -5523,6 +5930,7 @@ function applyStateDelta(input) {
 		const declared = entry(delta.timeline[key], `timeline.${key}`);
 		if (declared.action !== "created") fail$1(`timeline.${key} is a new event; its action must be created`);
 		if (declared.characters !== void 0 && (!Array.isArray(declared.characters) || declared.characters.some((character) => typeof character !== "string"))) fail$1(`timeline.${key}.characters must be a string array`);
+		for (const character of declared.characters ?? []) if (byName.get(character) === void 0) fail$1(`timeline.${key} names unknown character "${character}"`);
 		const allocated = allocateIds("TE", timeline.next_seq, 1);
 		const id = allocated.ids[0];
 		if (timeline.items.some((item) => item.id === id)) fail$1(`timeline.next_seq is behind the ledger; ${id} already exists`);
@@ -5589,7 +5997,9 @@ function applyStateDelta(input) {
 		foreshadows,
 		timeline,
 		relationships,
-		assigned
+		assigned,
+		warnings,
+		normalized_world: normalizedWorld
 	};
 }
 // src/engine/insight.ts
@@ -5600,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);
@@ -5715,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,
@@ -5742,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,
@@ -6144,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) => {
@@ -6925,6 +7530,44 @@ 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.
+*/
+var CheckSubmissionError = class extends EngineInputError {
+	items;
+	passed;
+	failed;
+	conflicts;
+	blocking;
+	rounds_consumed = 0;
+	failure_class = "submission";
+	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");
+		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. */
 function evidenceQuote(value) {
 	let candidate = value.trim();
@@ -6934,151 +7577,312 @@ function evidenceQuote(value) {
 	candidate = candidate.replace(/^[「『“"']/, "").replace(/[」』”"']$/, "").trim();
 	return candidate;
 }
-/** Sentence spans, including the terminating punctuation, for evidence de-duplication. */
-function sentenceSpans(text) {
-	const spans = [];
-	let start = 0;
-	for (let index = 0; index < text.length; index += 1) if ("。！？!?".includes(text[index])) {
-		spans.push({
-			start,
-			end: index + 1
-		});
-		start = index + 1;
+function nearestParagraph(text, quote) {
+	const paragraphs = splitParagraphs(text);
+	let best = null;
+	for (const [index, paragraph] of paragraphs.entries()) {
+		const score = bigramSimilarity(paragraph, quote);
+		if (best === null || score > best.score) best = {
+			index,
+			paragraph,
+			score
+		};
 	}
-	if (start < text.length) spans.push({
-		start,
-		end: text.length
-	});
-	return spans;
+	if (best === null || best.score < .5) return null;
+	return {
+		paragraph: best.index + 1,
+		quote: Array.from(best.paragraph).slice(0, 120).join(""),
+		score: Math.round(best.score * 1e3) / 1e3
+	};
 }
+const submissionState = (state) => state !== "pass" && state !== "fail";
+const codeForState = (state) => {
+	switch (state) {
+		case "not_found": return "SEMANTIC_EVIDENCE_NOT_FOUND";
+		case "too_short": return "SEMANTIC_EVIDENCE_TOO_SHORT";
+		case "duplicate": return "SEMANTIC_EVIDENCE_DUPLICATE";
+		case "overlap": return "SEMANTIC_EVIDENCE_OVERLAP";
+		case "same_sentence": return "SEMANTIC_EVIDENCE_SAME_SENTENCE";
+		case "missing": return "SEMANTIC_MISSING";
+		case "boundary": return "SEMANTIC_EVIDENCE_BOUNDARY";
+		default: return "SEMANTIC_ITEM_INVALID";
+	}
+};
+const detailFor = (result) => {
+	if (result.detail !== void 0) return result.detail;
+	switch (result.state) {
+		case "not_found": return `${result.id} cites a quote that does not appear verbatim in the manuscript`;
+		case "too_short": return `${result.id} quotes fewer than 8 characters`;
+		case "duplicate": return `${result.id} repeats ${result.conflict_with ?? "another item"}'s quote`;
+		case "overlap": return `${result.id} overlaps ${result.conflict_with ?? "another item"}'s accepted evidence interval`;
+		case "same_sentence": return `${result.id} reuses a sentence already cited by ${result.conflict_with ?? "another item"}`;
+		case "boundary": return `${result.id} cannot be mapped onto a sentence boundary`;
+		case "missing": return `${result.id} is required by the P6 task book`;
+		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 the model-supplied L2 semantic items. Evidence must be a real
-* substring of the manuscript; a failed verdict is itself a blocking finding.
-* The model cannot turn the check green by asserting it.
+* Evaluate all five L2 semantic items.
+*
+* 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, items) {
-	const blocking = [];
-	const seen = /* @__PURE__ */ new Set();
-	const seenQuotes = /* @__PURE__ */ new Set();
-	const spans = [];
-	const sentences = sentenceSpans(text);
-	const usedSentences = /* @__PURE__ */ new Set();
-	for (const [index, item] of items.entries()) {
+function evaluateSemantic(text, input) {
+	const items = [];
+	const accepted = [];
+	const sentences = splitSentenceSpans(text);
+	const usedSentences = /* @__PURE__ */ new Map();
+	const seenIds = /* @__PURE__ */ new Set();
+	const acceptedQuotes = /* @__PURE__ */ new Map();
+	const rawItems = Array.isArray(input) ? input : [];
+	if (!Array.isArray(input)) items.push({
+		id: "semantic",
+		state: "invalid",
+		detail: "semantic must be an array of five items"
+	});
+	for (const [index, raw] of rawItems.entries()) {
 		const where = `semantic[${index}]`;
-		if (typeof item !== "object" || item === null) {
-			blocking.push({
-				code: "SEMANTIC_ITEM_INVALID",
-				scope: "check",
+		if (typeof raw !== "object" || raw === null) {
+			items.push({
+				id: where,
+				state: "invalid",
 				detail: `${where} is not an object`
 			});
 			continue;
 		}
+		const item = raw;
 		if (typeof item.id !== "string" || item.id.trim() === "") {
-			blocking.push({
-				code: "SEMANTIC_ITEM_INVALID",
-				scope: "check",
+			items.push({
+				id: where,
+				state: "invalid",
 				detail: `${where} has no id`
 			});
 			continue;
 		}
-		if (seen.has(item.id)) {
-			blocking.push({
-				code: "SEMANTIC_ITEM_INVALID",
-				scope: "check",
-				detail: `${item.id} is declared twice`
+		const id = item.id.trim();
+		if (seenIds.has(id)) {
+			items.push({
+				id,
+				state: "invalid",
+				detail: `${id} is declared twice`
 			});
 			continue;
 		}
-		seen.add(item.id);
+		seenIds.add(id);
 		if (item.verdict !== "pass" && item.verdict !== "fail") {
-			blocking.push({
-				code: "SEMANTIC_ITEM_INVALID",
-				scope: "check",
-				detail: `${item.id} has verdict ${String(item.verdict)}; expected pass|fail`
+			items.push({
+				id,
+				state: "invalid",
+				detail: `${id} has verdict ${String(item.verdict)}; expected pass|fail`
 			});
 			continue;
 		}
 		if (typeof item.evidence !== "string" || item.evidence.trim() === "") {
-			blocking.push({
-				code: "SEMANTIC_EVIDENCE_INVALID",
-				scope: "check",
-				detail: `${item.id} has no evidence quote`
+			items.push({
+				id,
+				state: "invalid",
+				detail: `${id} has no evidence quote`
 			});
 			continue;
 		}
 		const quote = evidenceQuote(item.evidence);
 		if (Array.from(quote).length < 8) {
-			blocking.push({
-				code: "SEMANTIC_EVIDENCE_INVALID",
-				scope: "check",
-				detail: `${item.id} quotes fewer than 8 characters`
+			items.push({
+				id,
+				state: "too_short",
+				quote,
+				detail: `${id} quotes fewer than 8 characters`
 			});
 			continue;
 		}
-		if (!text.includes(quote)) {
-			blocking.push({
-				code: "SEMANTIC_EVIDENCE_INVALID",
-				scope: "check",
-				detail: `${item.id} cites "${quote}", which does not appear in the manuscript`
+		if (!SEMANTIC_CHECK_IDS.includes(id)) {
+			items.push({
+				id,
+				state: "invalid",
+				detail: `${id} is not one of the required P6 semantic checks`
 			});
 			continue;
 		}
-		if (seenQuotes.has(quote)) {
-			blocking.push({
-				code: "SEMANTIC_EVIDENCE_INVALID",
-				scope: "check",
-				detail: `${item.id} repeats another semantic item's quote; each check needs distinct evidence`
+		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;
 		}
-		let start = text.indexOf(quote);
-		let sentence = -1;
-		while (start !== -1) {
+		const occurrences = [];
+		let found = text.indexOf(quote);
+		while (found !== -1) {
+			occurrences.push(found);
+			found = text.indexOf(quote, found + 1);
+		}
+		if (occurrences.length === 0) {
+			const nearest = nearestParagraph(text, quote);
+			items.push({
+				id,
+				state: "not_found",
+				quote,
+				...nearest === null ? {} : { nearest },
+				detail: `${id} cites "${Array.from(quote).slice(0, 40).join("")}", which does not appear verbatim in the manuscript`
+			});
+			continue;
+		}
+		let acceptedSpan = null;
+		const conflicts = [];
+		for (const start of occurrences) {
 			const end = start + quote.length;
-			const overlaps = spans.some((span) => start < span.end && span.start < end);
-			const sentenceIndex = sentences.findIndex((candidate) => start >= candidate.start && end <= candidate.end);
-			if (!overlaps && sentenceIndex !== -1 && !usedSentences.has(sentenceIndex)) {
-				sentence = sentenceIndex;
+			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;
+				}
+			}
+			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;
+				}
+			}
+			if (!rejected) {
+				acceptedSpan = {
+					start,
+					end,
+					id,
+					quote,
+					sentenceIds
+				};
 				break;
 			}
-			start = text.indexOf(quote, start + 1);
 		}
-		if (start === -1 || sentence === -1) {
-			blocking.push({
-				code: "SEMANTIC_EVIDENCE_INVALID",
-				scope: "check",
-				detail: `${item.id} cites overlapping text or the same sentence as another check; each check needs a distinct passage`
+		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,
+				quote,
+				...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({
-			start,
-			end: start + quote.length
-		});
-		usedSentences.add(sentence);
-		seenQuotes.add(quote);
-		if (item.verdict === "fail") blocking.push({
-			code: "SEMANTIC_CHECK_FAILED",
-			scope: "check",
-			detail: `${item.id}: ${typeof item.note === "string" && item.note.trim() !== "" ? item.note : "semantic check failed"}`
+		accepted.push(acceptedSpan);
+		for (const sentenceId of acceptedSpan.sentenceIds) usedSentences.set(sentenceId, id);
+		acceptedQuotes.set(quote, id);
+		items.push({
+			id,
+			state: item.verdict === "fail" ? "fail" : "pass",
+			quote,
+			...item.verdict === "fail" ? { detail: `${id}: ${typeof item.note === "string" && item.note.trim() !== "" ? item.note : "semantic check failed"}` } : {}
 		});
 	}
-	const required = new Set(SEMANTIC_CHECK_IDS);
-	for (const id of SEMANTIC_CHECK_IDS) if (!seen.has(id)) blocking.push({
-		code: "SEMANTIC_MISSING",
-		scope: "check",
+	for (const id of SEMANTIC_CHECK_IDS) if (!seenIds.has(id)) items.push({
+		id,
+		state: "missing",
 		detail: `${id} is required by the P6 task book`
 	});
-	for (const id of seen) if (!required.has(id)) blocking.push({
-		code: "SEMANTIC_ITEM_INVALID",
+	const conflicts = items.flatMap((item) => item.conflicts ?? []);
+	const findings = items.filter((item) => item.state === "fail").map((item) => ({
+		code: "SEMANTIC_CHECK_FAILED",
 		scope: "check",
-		detail: `${id} is not one of the required P6 semantic checks`
-	});
+		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)
+		})),
+		...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,
+		content_failed: findings.length > 0,
 		failed: blocking.length > 0
 	};
 }
+/** 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, evaluation.blocking);
+	return evaluation;
+}
 // src/engine/gates.ts
 const block = (code, detail, hint, scope) => ({
 	code,
@@ -7088,6 +7892,7 @@ const block = (code, detail, hint, scope) => ({
 });
 /** PG-01: the model must have received the current brief before submitting. */
 const briefRequired = (input) => {
+	if (input.summaryOnlyRevision) return [];
 	if (input.briefStage === null) return [block("PG-01", "this operation needs a brief, but no brief stage is mapped")];
 	const record = input.pipeline.briefs[input.briefStage];
 	if (record === void 0) return [block("PG-01", `brief ${input.briefStage} has not been issued`, `call novel_brief with stage ${input.briefStage} first`)];
@@ -7180,11 +7985,42 @@ 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`);
+	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`);
+				}
+			}
+		}
+	}
+	if (textArray(summary.characters_appeared)) {
+		const narrator = input.pipeline.draft?.narrator ?? "";
+		for (const name of summary.characters_appeared) {
+			const alias = narrator.includes(name) && (narrator.includes("第一人称") || narrator.includes("「我」")) && input.text.includes("我");
+			if (!input.text.includes(name) && !alias) problems.push(`characters_appeared lists "${name}", but the manuscript never mentions it`);
+		}
+	}
 	const resources = summary.resource_changes;
 	if (!Array.isArray(resources) || !resources.every((item) => typeof item === "object" && item !== null && isText(item.character) && isText(item.resource) && Number.isInteger(item.delta) && item.delta !== 0 && isText(item.reason))) problems.push("resource_changes must contain character/resource/non-zero delta/reason");
 	if (!isText(summary.opening)) problems.push("opening must be text");
@@ -7297,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) {
@@ -7311,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. */
@@ -7383,6 +8229,7 @@ const consistency = (input, options) => {
 };
 /** PG-11: the review/revise budget is enforced by the engine, not self-reported. */
 const rounds = (input) => {
+	if (input.summaryOnly === true) return [];
 	if (!(input.operation === "submitReview" || input.operation === "submitRevision" || input.operation === "runCheck")) return [];
 	const counter = input.operation === "submitReview" ? "review" : input.operation === "submitRevision" ? "revise" : "check";
 	if (!roundsExhausted(input.rounds, counter)) return [];
@@ -7448,7 +8295,13 @@ function applicableGates(input) {
 			"PG-06",
 			"PG-13"
 		];
-		case "submitRevision": return [
+		case "submitRevision": return input.summaryOnly === true ? [
+			...always,
+			"PG-04",
+			"PG-03",
+			"PG-05",
+			"PG-06"
+		] : [
 			...always,
 			"PG-04",
 			"PG-03",
@@ -7559,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,
@@ -7586,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 },
@@ -7611,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,
@@ -8016,8 +8880,12 @@ var EngineService = class {
 	stores = /* @__PURE__ */ new Map();
 	mutex = new KeyedMutex();
 	replay = /* @__PURE__ */ new Map();
+	/** Bumped when an export artifact disappeared; makes the replay key miss. */
+	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();
@@ -8043,6 +8911,7 @@ var EngineService = class {
 		this.disposed = true;
 		this.stores.clear();
 		this.replay.clear();
+		this.exportArtifactEpoch.clear();
 		this.compiled = null;
 	}
 	get rulepack() {
@@ -8467,6 +9336,7 @@ var EngineService = class {
 				const volumes = input.volumes === void 0 ? snapshot.outline.volumes : normalizeVolumes(input.volumes, { totalChapters: snapshot.project.targets.total_chapters });
 				const removedVolumes = snapshot.outline.volumes.filter((volume) => !volumes.some((next) => next.title === volume.title)).map((volume) => volume.title);
 				if (removedVolumes.length > 0 && input.confirm_remove !== true) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `novel_blueprint would remove volumes: ${removedVolumes.join(", ")}`, "pass confirm_remove:true to replace the volume list, or omit volumes to keep them");
+				assertArchivedCardVolumes(snapshot.chapters.chapters, snapshot.outline.chapters, snapshot.outline.volumes, volumes, "novel_blueprint");
 				let chapters = snapshot.outline.chapters.map((card) => ({
 					...card,
 					volume: volumeForChapter(volumes, card.num, card.volume)
@@ -8481,6 +9351,7 @@ var EngineService = class {
 						chapters
 					}, record, now, snapshot.project.targets.words_per_chapter).chapters;
 				}
+				assertArchivedCardsInVolumes(snapshot.chapters.chapters, chapters, volumes, "novel_blueprint");
 				const outline = {
 					...snapshot.outline,
 					updated_at: now,
@@ -8564,6 +9435,7 @@ var EngineService = class {
 				volumes: merged.volumes.length,
 				added: merged.added,
 				updated: merged.updated,
+				reindexed: merged.reindexed,
 				removed: merged.removed,
 				volumes_added: merged.volumes_added,
 				volumes_updated: merged.volumes_updated,
@@ -8584,6 +9456,7 @@ var EngineService = class {
 		]);
 		for (const key of Object.keys(input)) if (!allowed.has(key)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `unknown novel_outline argument "${key}"`, `allowed: ${[...allowed].join(", ")}`);
 		const current = await this.load(input.root);
+		this.assertPublicBookHasNoStrictExplicit(input.book, "novel_outline");
 		this.assertProjectReadable(current, "novel_outline");
 		this.assertPlanningDocumentReadable(current, "outline", "novel_outline");
 		this.assertArchiveIndexReadable(current, "novel_outline");
@@ -8596,6 +9469,7 @@ var EngineService = class {
 				volumes: current.outline.volumes.length,
 				added: [],
 				updated: [],
+				reindexed: [],
 				removed: [],
 				volumes_added: [],
 				volumes_updated: [],
@@ -8612,10 +9486,12 @@ var EngineService = class {
 					...plan.data,
 					added: [],
 					updated: [],
+					reindexed: [],
 					removed: [],
 					dry_run: true,
 					would_add: plan.data.added,
 					would_update: plan.data.updated,
+					would_reindex: plan.data.reindexed,
 					would_remove: plan.data.removed
 				},
 				revision: current.pipeline.revision,
@@ -8673,6 +9549,7 @@ var EngineService = class {
 		]);
 		for (const key of Object.keys(input)) if (!allowed.has(key)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `unknown novel_outline_import argument "${key}"`, `allowed: ${[...allowed].join(", ")}`);
 		const parsed = parseOutlineInput(input.content, input.format);
+		this.assertPublicBookHasNoStrictExplicit(parsed.book, "novel_outline_import");
 		const snapshot = await this.load(input.root);
 		this.assertProjectReadable(snapshot, "novel_outline_import");
 		this.assertPlanningDocumentReadable(snapshot, "outline", "novel_outline_import");
@@ -8698,6 +9575,7 @@ var EngineService = class {
 			defaultTargetWords: snapshot.project.targets.words_per_chapter,
 			now
 		});
+		assertArchivedCardsInVolumes(snapshot.chapters.chapters, chapters, volumes, "novel_outline_import");
 		const candidate = {
 			schema_version: 1,
 			updated_at: now,
@@ -8705,6 +9583,9 @@ var EngineService = class {
 			volumes,
 			chapters
 		};
+		assertArchivedCardVolumes(snapshot.chapters.chapters, snapshot.outline.chapters, snapshot.outline.volumes, volumes, "novel_outline_import");
+		this.assertActiveCardPreserved(snapshot, chapters, "novel_outline_import");
+		this.assertOutlineWritable(snapshot, candidate, "novel_outline_import");
 		const preview = diffLines(yaml(snapshot.outline), yaml(candidate)).hunks.filter((hunk) => hunk.kind !== "same").slice(0, 80).map((hunk) => `${hunk.kind === "add" ? "+" : "-"} ${hunk.line}`).join("\n");
 		const summary = {
 			format: parsed.format,
@@ -8748,6 +9629,7 @@ var EngineService = class {
 					defaultTargetWords: fresh.project.targets.words_per_chapter,
 					now
 				});
+				assertArchivedCardVolumes(fresh.chapters.chapters, fresh.outline.chapters, fresh.outline.volumes, nextVolumes, "novel_outline_import");
 				const outline = {
 					schema_version: 1,
 					updated_at: now,
@@ -8755,7 +9637,7 @@ var EngineService = class {
 					volumes: nextVolumes,
 					chapters: nextChapters
 				};
-				this.assertActiveCardPreserved(fresh, nextBook.strict, nextChapters, "novel_outline_import");
+				this.assertActiveCardPreserved(fresh, nextChapters, "novel_outline_import");
 				this.assertOutlineWritable(fresh, outline, "novel_outline_import");
 				const appliedPreview = diffLines(yaml(fresh.outline), yaml(outline)).hunks.filter((hunk) => hunk.kind !== "same").slice(0, 80).map((hunk) => `${hunk.kind === "add" ? "+" : "-"} ${hunk.line}`).join("\n");
 				const nextPipeline = pipelineWith(fresh, context.revision, { last_action: action("novel_import_outline", this.now(), shortDigest(input.content)) });
@@ -9016,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]");
@@ -9039,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) {
@@ -9182,6 +10103,13 @@ var EngineService = class {
 	async journalBlocking(snapshot) {
 		const store = this.storeFor(snapshot.root);
 		if (await this.lockIsLive(store)) return [];
+		const pending = await inspectPending(store);
+		if (pending.state === "partial") return [{
+			code: ERROR_CODES.PENDING_PARTIAL,
+			scope: "journal",
+			detail: `pending transaction ${pending.txid ?? "unknown"} partially changed the project: ${pending.detail ?? "mixed before/after hashes"}`,
+			hint: `do not restore the whole project; inspect ${pending.stagingDir ?? "staging"}/before/ or state/journal.jsonl first`
+		}];
 		if (await store.exists("novel.yaml")) {
 			const journalPresent = await store.exists(joinRel(STATE_DIR, STATE_FILES.journal));
 			const journal = journalPresent ? await readJournal(store) : null;
@@ -9279,6 +10207,11 @@ var EngineService = class {
 	async statusFor(snapshot, chapter) {
 		const metrics = await this.metricsFor(snapshot, chapter);
 		const journal = await this.journalBlocking(snapshot);
+		const pending = await inspectPending(this.storeFor(snapshot.root));
+		const pendingWarnings = pending.state === "complete" || pending.state === "untouched" ? [{
+			code: pending.state === "complete" ? "PENDING_RECOVERABLE" : "PENDING_ABORTABLE",
+			message: `${pending.detail ?? "pending transaction detected"} (${pending.txid ?? "unknown"})`
+		}] : [];
 		const next = journal.length > 0 && this.stateErrors(snapshot).length === 0 ? {
 			tool: "novel_audit",
 			args: {},
@@ -9298,6 +10231,7 @@ var EngineService = class {
 				stage: snapshot.pipeline.stage,
 				rounds: { ...snapshot.pipeline.rounds },
 				blocking: [...this.effectiveBlocking(snapshot), ...journal],
+				...pendingWarnings.length === 0 ? {} : { warnings: pendingWarnings },
 				state_errors: this.stateErrors(snapshot),
 				selection: {
 					source: snapshot.selection.source,
@@ -9824,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",
@@ -9833,6 +10767,21 @@ var EngineService = class {
 			detail: snapshot.outlineError ?? (snapshot.outlinePresent ? `${snapshot.outline.chapters.length} 张章卡 / ${snapshot.outline.volumes.length} 卷 / strict=${String(snapshot.outline.book.strict)}` : "outline/outline.yaml is missing"),
 			...snapshot.outlineError !== null ? { hint: "repair outline/outline.yaml with novel_amend" } : snapshot.outlinePresent ? {} : { hint: "create a card with novel_outline before relying on PG-13" }
 		});
+		if (snapshot.handoff !== null && snapshot.outlineError === null && snapshot.outline.volumes.length > 0) {
+			const chapter = snapshot.pipeline.chapter;
+			const expectedIndex = snapshot.outline.volumes.findIndex((volume) => chapter >= volume.start_chapter && chapter <= volume.end_chapter);
+			if (expectedIndex >= 0) {
+				const expected = snapshot.outline.volumes[expectedIndex];
+				const position = projectHandoff(snapshot.handoff, chapter);
+				if (position.volume !== expectedIndex + 1 || position.volume_name !== expected.title) add({
+					id: "handoff-outline",
+					severity: "warning",
+					title: "交接卷与大纲不一致",
+					detail: `handoff 指向第 ${position.volume} 卷「${position.volume_name}」，当前章 ${chapter} 的大纲卷是第 ${expectedIndex + 1} 卷「${expected.title}」`,
+					hint: "用 novel_amend 修正 state/handoff.yaml，或重新归档以推进交接；归档前请确认卷/幕是作者想要的"
+				});
+			}
+		}
 		add({
 			id: "worldbook",
 			severity: snapshot.worldbookError !== null ? "error" : snapshot.worldbookPresent ? "ok" : "info",
@@ -9852,6 +10801,14 @@ var EngineService = class {
 			const journal = await readJournal(store);
 			const journalCommitted = hasCommittedJournal(journal.records);
 			const health = await reconcileJournal(store);
+			const pending = await inspectPending(store);
+			if (pending.state !== "none") add({
+				id: "pending-transaction",
+				severity: pending.state === "partial" ? "error" : "warning",
+				title: pending.state === "partial" ? "事务只完成了一部分" : pending.state === "complete" ? "事务可安全提升" : "事务可安全回滚",
+				detail: `${pending.txid ?? "unknown"}: ${pending.detail ?? pending.state}`,
+				hint: pending.state === "partial" ? `先检查 ${pending.stagingDir ?? "staging"}/before/；不要从整库备份恢复` : "下一次写操作会自动完成恢复；只读命令不会改盘"
+			});
 			add({
 				id: "journal",
 				severity: !journalPresent || !journalCommitted || journal.malformed > 0 || health.mismatches.length > 0 ? "error" : "ok",
@@ -10079,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,
@@ -10747,7 +11705,11 @@ var EngineService = class {
 	async submitRevision(input) {
 		const hasContent = input.content !== void 0;
 		const hasPatch = input.patch !== void 0;
-		if (hasContent === hasPatch) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "novel_revise requires exactly one of content or patch", "send the full revised text, or a patch with expected_hash and unique edits");
+		const summaryOnly = !hasContent && !hasPatch && input.summary !== void 0;
+		if (!hasContent && !hasPatch && !summaryOnly) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "novel_revise requires content, patch, or summary", "send revised text, a patch, or a full summary for a summary-only repair");
+		if (hasContent && hasPatch) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "novel_revise accepts only one of content or patch", "send the full revised text, or a patch with expected_hash and unique edits");
+		if (summaryOnly && (input.issues !== void 0 || input.proof !== void 0)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "summary-only repair cannot change review issues or reading proof", "send only chapter and summary; use content/patch for a prose revision that needs a new proof");
+		if (!summaryOnly && input.proof === void 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "novel_revise requires proof for a content or patch revision", "provide opening/middle/ending quotes from the revised text");
 		if (hasPatch) {
 			const patch = input.patch;
 			if (patch === null || typeof patch !== "object" || !Array.isArray(patch.edits) || patch.edits.length === 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "patch.edits must be a non-empty array");
@@ -10768,7 +11730,13 @@ var EngineService = class {
 			}))}`,
 			run: async (snapshot, context) => {
 				this.assertChapter(snapshot, input.chapter);
-				const revisedContent = input.patch === void 0 ? input.content : applyRevisionPatch(snapshot.text ?? "", input.patch);
+				if (summaryOnly && ![
+					"P5",
+					"P6",
+					"ready_to_archive"
+				].includes(snapshot.pipeline.stage)) throw new EngineInputError(ERROR_CODES.STAGE_ORDER, `summary-only repair is not available at ${snapshot.pipeline.stage}`, "use novel_revise with content/patch for an early-stage rewrite, or wait until P5/P6");
+				const revisedContent = summaryOnly ? snapshot.text ?? "" : input.patch === void 0 ? input.content : applyRevisionPatch(snapshot.text ?? "", input.patch);
+				if (summaryOnly && snapshot.text === null) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "summary-only repair requires an existing draft", "write the draft first, then repair its summary");
 				if (typeof revisedContent !== "string") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "revision content must be a string", "send the full revised text as a string, or a patch object");
 				if (revisedContent.trim() === "") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "revision content must not be empty");
 				let patchedReview = null;
@@ -10831,8 +11799,10 @@ var EngineService = class {
 					text: revisedContent,
 					summary: input.summary,
 					summaryProvided: input.summary !== void 0,
+					summaryOnly,
+					summaryOnlyRevision: summaryOnly,
 					review: patchedReview,
-					proof: input.proof
+					proof: input.proof ?? snapshot.review?.proof ?? null
 				});
 				const inheritedSummary = snapshot.pipeline.draft?.summary ?? snapshot.plan?.summary;
 				if (input.summary === void 0 && inheritedSummary !== void 0) {
@@ -10851,24 +11821,27 @@ var EngineService = class {
 					content_hash: sha256(snapshot.text ?? ""),
 					updated_at: this.now().toISOString()
 				};
-				const nextStage$1 = nextStage(snapshot.pipeline.stage, "submitRevision", 0);
+				const nextStage$1 = summaryOnly ? snapshot.pipeline.stage === "P5" ? "P6" : snapshot.pipeline.stage : nextStage(snapshot.pipeline.stage, "submitRevision", 0);
 				const nextPipeline = pipelineWith(snapshot, context.revision, {
 					stage: nextStage$1,
 					draft: {
 						...baseDraft,
 						summary: effectiveSummary,
-						content_hash: sha256(revisedContent),
+						content_hash: summaryOnly ? baseDraft.content_hash : sha256(revisedContent),
 						updated_at: this.now().toISOString()
 					},
-					rounds: {
+					rounds: summaryOnly ? { ...snapshot.pipeline.rounds } : {
 						...snapshot.pipeline.rounds,
 						revise: snapshot.pipeline.rounds.revise + 1
 					},
-					blocking: [],
+					blocking: summaryOnly ? snapshot.pipeline.blocking.filter((item) => item.code !== "PG-05") : [],
 					...patchedReview === null || !reviewChanged && snapshot.pipeline.review_digest !== void 0 ? {} : { review_digest: sha256(stableJson(patchedReview)) },
-					last_action: action("novel_revise", this.now(), sha256(revisedContent))
+					last_action: action(summaryOnly ? "novel_revise_summary" : "novel_revise", this.now(), sha256(revisedContent))
 				});
-				const files = [
+				const files = summaryOnly ? [{
+					path: joinRel(STATE_DIR, STATE_FILES.pipeline),
+					text: yaml(nextPipeline)
+				}] : [
 					...snapshot.text === null ? [] : [{
 						path: chapterHistoryFile(input.chapter, snapshot.pipeline.revision),
 						text: snapshot.text
@@ -10886,17 +11859,19 @@ var EngineService = class {
 						text: yaml(nextPipeline)
 					}
 				];
-				if (reviewChanged && patchedReview !== null) files.push({
+				if (!summaryOnly && reviewChanged && patchedReview !== null) files.push({
 					path: reviewFile(input.chapter),
 					text: yaml(patchedReview)
 				});
 				return {
 					files,
-					backup: true,
+					backup: !summaryOnly,
 					data: {
 						chapter: input.chapter,
 						stage: nextStage$1,
-						metrics: machine.metrics
+						metrics: machine.metrics,
+						summary_only: summaryOnly,
+						rounds_consumed: summaryOnly ? 0 : 1
 					},
 					warnings: machineWarnings(machine)
 				};
@@ -10917,7 +11892,9 @@ var EngineService = class {
 			run: async (snapshot, context) => {
 				this.assertChapter(snapshot, input.chapter);
 				const text = snapshot.text ?? "";
-				const semantic = Array.isArray(input.semantic) ? input.semantic : [];
+				if (input.acknowledge !== void 0 && !Array.isArray(input.acknowledge)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "acknowledge must be an array of advisory codes", "omit acknowledge or pass an array of advisory codes");
+				const semanticEvaluation = validateSemanticSubmission(text, input.semantic);
+				const semantic = input.semantic;
 				await this.assertGates(snapshot, "runCheck", {
 					briefStage: "P6",
 					text,
@@ -10938,8 +11915,8 @@ var EngineService = class {
 				if (unknownAck.length > 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `cannot acknowledge non-advisory finding(s): ${unknownAck.join(", ")}`, `advisory codes in this run: ${advisoryCodes.join(", ") || "none"}; blockers and unknown codes cannot be acknowledged`);
 				const priorAck = snapshot.check !== null && snapshot.check.content_hash === sha256(text) ? snapshot.check.acknowledged ?? [] : [];
 				const acknowledged = [.../* @__PURE__ */ new Set([...priorAck, ...requestedAck])].filter((code) => advisoryCodes.includes(code));
-				const semanticResult = evaluateSemantic(text, semantic);
-				const verdict = machineBlocking.length === 0 && !semanticResult.failed ? "pass" : "fail";
+				const semanticResult = semanticEvaluation;
+				const verdict = machineBlocking.length === 0 && !semanticResult.content_failed ? "pass" : "fail";
 				const check = {
 					schema_version: 1,
 					chapter: input.chapter,
@@ -10950,8 +11927,15 @@ var EngineService = class {
 						advisories: machineAdvisories,
 						metrics: scopedMachine.metrics
 					},
-					semantic: { items: semantic },
+					semantic: {
+						items: semantic,
+						...semanticResult.findings.length === 0 ? {} : { findings: semanticResult.findings }
+					},
 					...acknowledged.length === 0 ? {} : { acknowledged },
+					...verdict === "fail" ? {
+						failure_class: "content",
+						counted: true
+					} : {},
 					verdict
 				};
 				try {
@@ -10965,12 +11949,12 @@ var EngineService = class {
 					code: violation.code,
 					scope: "check",
 					detail: violation.detail
-				})), ...semanticResult.blocking] : [];
+				})), ...semanticResult.findings] : [];
 				const nextPipeline = pipelineWith(snapshot, context.revision, {
 					stage: nextStage$2,
 					rounds: {
 						...snapshot.pipeline.rounds,
-						check: snapshot.pipeline.rounds.check + (verdict === "fail" || fullScope ? 1 : 0)
+						check: snapshot.pipeline.rounds.check + (verdict === "fail" ? 1 : 0)
 					},
 					blocking: blockingItems,
 					last_action: action("novel_check", this.now(), sha256(text))
@@ -10999,7 +11983,13 @@ var EngineService = class {
 						advisory_codes: advisoryCodes,
 						acknowledged,
 						metrics: scopedMachine.metrics,
-						stage: nextStage$2
+						stage: nextStage$2,
+						semantic: {
+							items: semanticResult.items,
+							findings: semanticResult.findings
+						},
+						rounds: { check: nextPipeline.rounds.check },
+						counted: verdict === "fail"
 					},
 					warnings: [
 						...machineWarnings({
@@ -11047,7 +12037,9 @@ var EngineService = class {
 							chapter: input.chapter,
 							assigned_ids: already.assigned_ids ?? {},
 							metrics: countWordMetrics(archivedText),
-							score: already.score
+							score: already.score,
+							delta_warnings: [],
+							normalized_world: {}
 						},
 						warnings: [],
 						replay: true
@@ -11240,8 +12232,11 @@ var EngineService = class {
 						chapter,
 						assigned_ids: ledger.assigned,
 						metrics,
-						score
+						score,
+						delta_warnings: ledger.warnings,
+						normalized_world: ledger.normalized_world
 					},
+					warnings: ledger.warnings,
 					event: {
 						name: "novel/archived",
 						payload: {
@@ -11524,6 +12519,15 @@ var EngineService = class {
 			code: "JOURNAL_HASH_MISMATCH",
 			message: `${health.mismatches.length} file(s) changed after the last commit; first: ${health.mismatches[0].path}`
 		});
+		const pending = await inspectPending(store);
+		if (pending.state === "partial") warnings.push({
+			code: ERROR_CODES.PENDING_PARTIAL,
+			message: `pending transaction ${pending.txid ?? "unknown"} is partial: ${pending.detail ?? "mixed hashes"}; do not restore the whole project`
+		});
+		else if (pending.state === "complete" || pending.state === "untouched") warnings.push({
+			code: pending.state === "complete" ? "PENDING_RECOVERABLE" : "PENDING_ABORTABLE",
+			message: `${pending.txid ?? "unknown"}: ${pending.detail ?? pending.state}`
+		});
 		const requested = input.limit ?? 50;
 		const limit = Number.isFinite(requested) ? Math.max(0, Math.min(1e3, Math.floor(requested))) : 50;
 		if (input.chapter !== void 0) this.assertChapterParameter(input.chapter);
@@ -11566,10 +12570,22 @@ var EngineService = class {
 			const current = await this.load(input.root);
 			this.assertExportIndexReadable(current, input.kind);
 		}
+		const artifactSnapshot = await this.load(input.root);
+		const artifactStore = this.storeFor(artifactSnapshot.root);
+		const suffix = input.chapter === void 0 ? "" : `-ch${String(input.chapter).padStart(3, "0")}`;
+		const expectedArtifacts = input.kind === "outline" ? [joinRel(EXPORT_DIR, "outline.md")] : input.kind === "worldbook" ? [joinRel(EXPORT_DIR, "worldbook.md")] : input.kind === "proposal" ? [joinRel(EXPORT_DIR, "proposal.md")] : [
+			joinRel(EXPORT_DIR, `book${suffix}.${input.kind}`),
+			joinRel(EXPORT_DIR, "cover.svg"),
+			joinRel(EXPORT_DIR, "blurb.txt")
+		];
+		const artifactsPresent = (await Promise.all(expectedArtifacts.map((path) => artifactStore.exists(path)))).every(Boolean);
+		const artifactKey = `${artifactSnapshot.root}|${input.kind}|${input.chapter ?? "all"}`;
+		if (!artifactsPresent) this.exportArtifactEpoch.set(artifactKey, (this.exportArtifactEpoch.get(artifactKey) ?? 0) + 1);
+		const artifactEpoch = this.exportArtifactEpoch.get(artifactKey) ?? 0;
 		return this.mutate({
 			root: input.root,
 			op: "export",
-			key: (snapshot) => `export:${input.kind}:${input.chapter ?? "all"}:${sha256(stableJson({
+			key: (snapshot) => `export:${input.kind}:${input.chapter ?? "all"}:${artifactEpoch}:${sha256(stableJson({
 				chapter: snapshot.pipeline.chapter,
 				text: sha256(snapshot.text ?? ""),
 				plan_title: stripTitlePrefix(snapshot.plan?.title ?? ""),
@@ -11791,14 +12807,14 @@ var EngineService = class {
 			root: active,
 			source: "active"
 		};
-		else if (registry.projects.length === 1) selection = {
-			root: registry.projects[0].root,
-			source: "single"
-		};
 		else if (rows.has(configured) && !registry.projects.some((entry) => entry.root === configured)) selection = {
 			root: configured,
 			source: "config"
 		};
+		else if (registry.projects.length === 1) selection = {
+			root: registry.projects[0].root,
+			source: "single"
+		};
 		else selection = {
 			root: null,
 			source: "none"
@@ -12297,15 +13313,23 @@ var EngineService = class {
 		throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `${path} is unreadable; ${operation} would overwrite the unreadable planning document`, `read ${path} with novel_state and repair it with novel_amend before ${operation}`);
 	}
 	/**
+	* `strict_explicit` is an internal provenance bit, not an author choice.
+	* Exposing it lets a caller forge "the author chose strict:false" without
+	* going through the strict option. Stored documents may still contain it.
+	*/
+	assertPublicBookHasNoStrictExplicit(book, operation) {
+		if (typeof book !== "object" || book === null || Array.isArray(book)) return;
+		if (Object.hasOwn(book, "strict_explicit")) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${operation} cannot set book.strict_explicit`, "use the public strict boolean; strict_explicit is an internal provenance marker");
+	}
+	/**
 	* An import is a full replacement, unlike novel_outline's keyed upsert. It
 	* must not silently lose the active card while strict mode still requires it.
 	*/
-	assertActiveCardPreserved(snapshot, strict, chapters, operation) {
-		if (!strict) return;
+	assertActiveCardPreserved(snapshot, chapters, operation) {
 		const chapter = snapshot.pipeline.chapter;
 		if (!snapshot.outline.chapters.some((card) => card.num === chapter)) return;
 		if (chapters.some((card) => card.num === chapter)) return;
-		throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${operation} cannot remove the active chapter ${chapter} card while strict mode is on`, "include the active card in the imported outline; import replaces the whole plan and will not turn strict mode off for you");
+		throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${operation} cannot remove the active chapter ${chapter} card`, "include the active card in the imported outline; import replaces the whole plan and cannot remove an in-flight card");
 	}
 	/**
 	* The outline is a derived progress view and the PG-13 input. Every write
@@ -12384,6 +13408,11 @@ 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 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));
@@ -12391,7 +13420,6 @@ var EngineService = class {
 		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,
@@ -12435,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;
@@ -12470,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,
@@ -12509,17 +13593,33 @@ 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 },
 			...acknowledgedAdvisories === 0 ? {} : { acknowledgedAdvisories },
-			...legacy.length === 0 ? {} : { legacy }
+			...legacy.length === 0 ? {} : { legacy },
+			...pending.state === "none" ? {} : { pending: {
+				state: pending.state,
+				txid: pending.txid ?? "",
+				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
@@ -12814,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;
@@ -12866,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),
@@ -12901,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 {
@@ -13196,6 +14306,13 @@ var EngineService = class {
 			rounds: snapshot.pipeline.rounds,
 			min_score: this.config.quality.minScore,
 			rulepack: `${this.rulepack.name}@${this.rulepack.version}`,
+			documents: sha256(stableJson({
+				project: snapshot.project,
+				outline: snapshot.outline,
+				worldbook: snapshot.worldbook,
+				plan: snapshot.plan,
+				worldPlan: snapshot.worldPlan
+			})),
 			context
 		}));
 	}
@@ -13241,6 +14358,8 @@ var EngineService = class {
 			sceneType: extras.sceneType ?? snapshot.pipeline.draft?.scene_type ?? snapshot.plan?.scene_type ?? null,
 			summary: extras.summary ?? snapshot.pipeline.draft?.summary ?? snapshot.plan?.summary ?? null,
 			summaryProvided: extras.summaryProvided,
+			summaryOnly: extras.summaryOnly,
+			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 ?? [],
@@ -13367,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) {
@@ -13507,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);
@@ -13521,6 +14656,7 @@ var EngineService = class {
 			selection,
 			project,
 			projectError,
+			pipelineError,
 			pipeline,
 			briefs,
 			chapters,
@@ -13641,7 +14777,14 @@ var EngineService = class {
 							STATE_FILES.handoff
 						].map((file) => joinRel(STATE_DIR, file));
 						stateFiles.push(joinRel(STATE_DIR, STATE_FILES.journal), ARCHIVE_DIGESTS, BRIEF_RECEIPTS_FILE);
-						const stateCandidates = journalWasPresent ? stateFiles : stateFiles.filter((path) => path !== joinRel(STATE_DIR, STATE_FILES.journal));
+						const pending = await inspectPending(store);
+						if (pending.state === "partial") throw new EngineFaultError(ERROR_CODES.PENDING_PARTIAL, `pending transaction ${pending.txid ?? "unknown"} partially changed this directory`, `inspect ${pending.stagingDir ?? ".staging"}/ before initializing over it`);
+						if (pending.state === "complete" || pending.state === "untouched") {
+							await assertJournalConsistent(store);
+							if (await store.exists("novel.yaml")) throw new EngineInputError(ERROR_CODES.PROJECT_EXISTS, "a project already exists at this root after pending recovery", "use a different directory, or call novel_status to inspect the existing project");
+						}
+						const journalPath = joinRel(STATE_DIR, STATE_FILES.journal);
+						const stateCandidates = journalWasPresent && (await readJournal(store)).records.some((record) => record.status === "committed" && record.op !== "lock_reclaimed") ? stateFiles : stateFiles.filter((path) => path !== journalPath);
 						if ((await Promise.all(stateCandidates.map((file) => store.exists(file)))).some(Boolean) || (await store.list("chapters")).length > 0 || (await store.list("plans")).length > 0 || (await store.list("reviews")).length > 0 || (await store.list("checks")).length > 0 || await store.exists("outline/outline.yaml") || await store.exists("outline/worldbook.yaml")) throw new EngineInputError(ERROR_CODES.PROJECT_EXISTS, "state documents exist but novel.yaml is missing; refusing to overwrite the project", "restore novel.yaml, or initialize a new empty directory");
 						await assertJournalConsistent(store);
 						const created = await options.run(this.emptySnapshot(root, selection), {
@@ -13668,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
@@ -13716,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;
 				}
@@ -13783,6 +14928,7 @@ var EngineService = class {
 			selection,
 			project: { ...ENGINE_PROJECT_INITIAL },
 			projectError: null,
+			pipelineError: null,
 			pipeline: emptyPipeline({
 				revision: 1,
 				chapter: 1,
@@ -14156,7 +15302,9 @@ const amendProblems = (kind, oldDocument, nextDocument, snapshot, path, archived
 		if (kind !== "relationships") return problems;
 	}
 	if (kind === "characters") {
-		const names = new Set((Array.isArray(nextDocument.characters) ? nextDocument.characters : []).map((raw) => recordOf(raw)?.name).filter((name) => typeof name === "string"));
+		const rows = Array.isArray(nextDocument.characters) ? nextDocument.characters : [];
+		const names = new Set(rows.map((raw) => recordOf(raw)?.name).filter((name) => typeof name === "string"));
+		if (names.size !== rows.length) problems.push("characters must have unique names");
 		if (!snapshot.ledgerErrors.some((error) => error.code === "LOCKS_UNREADABLE")) {
 			for (const name of Object.keys(snapshot.locks.characters)) if (!names.has(name)) problems.push(`lock for removed character "${name}" still exists`);
 		}
@@ -14166,6 +15314,21 @@ const amendProblems = (kind, oldDocument, nextDocument, snapshot, path, archived
 		return problems;
 	}
 	if (kind === "world") {
+		const allNames = [];
+		for (const section of [
+			"locations",
+			"abilities",
+			"artifacts",
+			"factions",
+			"rules"
+		]) {
+			const rows = Array.isArray(nextDocument[section]) ? nextDocument[section] : [];
+			for (const raw of rows) {
+				const name = recordOf(raw)?.name;
+				if (typeof name === "string") allNames.push(name);
+			}
+		}
+		if (new Set(allNames).size !== allNames.length) problems.push("world entities must have unique names");
 		const locations = new Set((Array.isArray(nextDocument.locations) ? nextDocument.locations : []).map((raw) => recordOf(raw)?.name).filter((name) => typeof name === "string"));
 		if (!snapshot.ledgerErrors.some((error) => error.code === "LOCKS_UNREADABLE")) {
 			for (const name of Object.keys(snapshot.locks.locations)) if (!locations.has(name)) problems.push(`lock for removed location "${name}" still exists`);
@@ -14255,6 +15418,19 @@ const amendProblems = (kind, oldDocument, nextDocument, snapshot, path, archived
 			const row = recordOf(raw);
 			if (row === null || !Number.isInteger(row.start_chapter) || !Number.isInteger(row.end_chapter) || row.end_chapter < row.start_chapter) problems.push(`volumes[${index}] must have start_chapter <= end_chapter`);
 		}
+		if (snapshot.outlineError === null) try {
+			const nextVolumes = normalizeVolumes(volumes, {
+				totalChapters: snapshot.project.targets.total_chapters,
+				rejectDuplicateTitles: false
+			});
+			assertArchivedCardVolumes(snapshot.chapters.chapters, snapshot.outline.chapters, snapshot.outline.volumes, nextVolumes, "novel_amend");
+			assertArchivedCardsInVolumes(snapshot.chapters.chapters, [...byNum.values()].map((row) => ({
+				num: row.num,
+				volume: row.volume ?? null
+			})), nextVolumes, "novel_amend");
+		} catch (error) {
+			problems.push(error instanceof Error ? error.message : String(error));
+		}
 		for (const record of snapshot.chapters.chapters) {
 			const card = byNum.get(record.num);
 			if (card === void 0) {
@@ -14516,7 +15692,8 @@ const asJson = (value, field) => {
 const fail = (error) => {
 	if (error instanceof EngineError) {
 		const blocking = error instanceof EngineBlockedError && error.blocking.length > 0 ? `\nblocking: ${JSON.stringify(error.blocking)}` : "";
-		throw new Error(`[${error.code}] ${error.message}${error.hint === void 0 ? "" : ` — ${error.hint}`}${blocking}`);
+		const details = "items" in error && Array.isArray(error.items) ? `\nitems: ${JSON.stringify(error.items)}` : "";
+		throw new Error(`[${error.code}] ${error.message}${error.hint === void 0 ? "" : ` — ${error.hint}`}${blocking}${details}`);
 	}
 	throw error;
 };
@@ -14905,15 +16082,17 @@ function createNovelTools(engine, options = {}) {
 					type: "json",
 					description: "Patch mode: {expected_hash, edits:[{old_text,new_text,occurrence?}]}; edits must be unique unless occurrence is set."
 				},
-				summary: { type: "json" },
+				summary: {
+					type: "json",
+					description: "Full ten-field summary. Omit content+patch with a summary to repair only pipeline.draft.summary; this does not consume a revise round."
+				},
 				issues: {
 					type: "json",
 					description: arraySemanticsDescription("replace", "Updated issue statuses and evidence for PG-08.")
 				},
 				proof: {
 					type: "json",
-					required: true,
-					description: arraySemanticsDescription("replace", "Three quotes from the revised text; PG-09 verifies them.")
+					description: arraySemanticsDescription("replace", "Three quotes from the revised text; required unless this is a summary-only repair. PG-09 verifies them.")
 				},
 				project_root: root
 			},
@@ -15447,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",
@@ -15457,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
 			},
@@ -15615,7 +16794,12 @@ const bad = (text) => ({
 	kind: "error",
 	text
 });
-const failure = (error) => error instanceof EngineError ? bad(`[${error.code}] ${error.message}${error.hint === void 0 ? "" : ` — ${error.hint}`}`) : bad(String(error));
+const failure = (error) => {
+	if (!(error instanceof EngineError)) return bad(String(error));
+	const blocking = error instanceof EngineBlockedError && error.blocking.length > 0 ? `\nblocking: ${JSON.stringify(error.blocking)}` : "";
+	const items = "items" in error && Array.isArray(error.items) ? `\nitems: ${JSON.stringify(error.items)}` : "";
+	return bad(`[${error.code}] ${error.message}${error.hint === void 0 ? "" : ` — ${error.hint}`}${blocking}${items}`);
+};
 const formatPercent = (value) => value === null || value === void 0 ? "—" : `${Math.round(value * 1e3) / 10}%`;
 const statusText = async (engine) => {
 	const { data } = await engine.getStatus({});
@@ -15947,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) => {
@@ -15997,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,
@@ -16012,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,
@@ -16205,6 +17389,119 @@ function compileRulepack(raw) {
 		"exclusions",
 		"exemptions"
 	], "root");
+	const section = (name, keys) => {
+		const value = root[name];
+		if (value === void 0) return null;
+		const objectValue = object(value, name);
+		knownKeys(objectValue, keys, name);
+		return objectValue;
+	};
+	const nested = (value, key, keys) => {
+		if (value === null || value[key] === void 0) return null;
+		const objectValue = object(value[key], key);
+		knownKeys(objectValue, keys, key);
+		return objectValue;
+	};
+	nested(section("format", [
+		"paragraph_max_words",
+		"forbid_markdown",
+		"forbid_semicolon",
+		"forbid_english_ellipsis",
+		"title",
+		"system_labels",
+		"scene_separators",
+		"markdown_markers"
+	]), "title", [
+		"pattern",
+		"min_chars",
+		"max_chars"
+	]);
+	const punctuation = section("punctuation", [
+		"dash",
+		"period_density",
+		"ellipsis_run",
+		"uniform_sentence",
+		"consecutive_le",
+		"dialogue_dominant_ratio"
+	]);
+	const dash = nested(punctuation, "dash", [
+		"base",
+		"scale_words",
+		"token"
+	]);
+	if (dash !== null && dash.base !== void 0) {
+		const base = object(dash.base, "punctuation.dash.base");
+		knownKeys(base, SCENE_TYPES, "punctuation.dash.base");
+	}
+	nested(punctuation, "period_density", ["min", "max"]);
+	nested(punctuation, "ellipsis_run", ["max", "token"]);
+	nested(punctuation, "uniform_sentence", ["min_sentences", "ratio"]);
+	nested(punctuation, "consecutive_le", ["max", "char"]);
+	const semantics = section("semantics", [
+		"adjective_density",
+		"pleasure_density",
+		"sensory_density",
+		"water_words"
+	]);
+	nested(semantics, "adjective_density", ["max", "adjectives"]);
+	nested(semantics, "pleasure_density", [
+		"min",
+		"keywords",
+		"window"
+	]);
+	nested(semantics, "sensory_density", [
+		"min",
+		"senses",
+		"window"
+	]);
+	const waterWords = nested(semantics, "water_words", [
+		"window",
+		"threshold",
+		"scene_thresholds",
+		"terms"
+	]);
+	if (waterWords !== null && waterWords.scene_thresholds !== void 0) knownKeys(object(waterWords.scene_thresholds, "semantics.water_words.scene_thresholds"), SCENE_TYPES, "semantics.water_words.scene_thresholds");
+	const lexicon = section("lexicon", [
+		"zero_tolerance",
+		"soft",
+		"contextual",
+		"meta_narration",
+		"reader_intrusion",
+		"god_view",
+		"conclusion_first"
+	]);
+	nested(lexicon, "conclusion_first", ["verbs", "causals"]);
+	for (const key of ["reader_intrusion", "god_view"]) {
+		if (lexicon === null || lexicon[key] === void 0) continue;
+		for (const [index, raw] of array(lexicon[key], `lexicon.${key}`).entries()) knownKeys(object(raw, `lexicon.${key}[${index}]`), ["pattern"], `lexicon.${key}[${index}]`);
+	}
+	const platform = object(root.platform, "platform");
+	knownKeys(platform, PLATFORMS, "platform");
+	for (const name of PLATFORMS) {
+		const profile = object(platform[name], `platform.${name}`);
+		knownKeys(profile, ["words_per_chapter", "dialogue_ratio"], `platform.${name}`);
+	}
+	const genres = object(root.genres, "genres");
+	knownKeys(genres, GENRES, "genres");
+	for (const name of GENRES) knownKeys(object(genres[name], `genres.${name}`), ["note"], `genres.${name}`);
+	section("crosschapter", [
+		"duplicate_similarity",
+		"duplicate_advisory",
+		"duplicate_min_chars",
+		"foreshadow_min_dormancy",
+		"foreshadow_dormant_after",
+		"check_time",
+		"lock_similarity"
+	]);
+	const quality = section("quality", ["dimensions"]);
+	if (quality?.dimensions !== void 0) for (const [index, rawDimension] of array(quality.dimensions, "quality.dimensions").entries()) {
+		const dimension = object(rawDimension, `quality.dimensions[${index}]`);
+		knownKeys(dimension, ["id", "max"], `quality.dimensions[${index}]`);
+	}
+	if (root.exclusions !== void 0) for (const [index, rawEntry] of array(root.exclusions, "exclusions").entries()) {
+		const entry = object(rawEntry, `exclusions[${index}]`);
+		knownKeys(entry, ["pair", "family"], `exclusions[${index}]`);
+	}
 	const pack = normalize(raw);
 	const rawPlatform = object(root.platform, "platform");
 	for (const platform of PLATFORMS) if (rawPlatform[platform] === void 0) invalid(`platform.${platform} is missing`);