dsh-novel-write-engine 0.2.3 → 0.2.5

package/lib/index.js

@@ -20,6 +20,8 @@ const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */
 const PROJECT_FILE = "novel.yaml";
 const OUTLINE_FILE = "outline/outline.yaml";
+/** Last outline replaced by a normal planning write; one level is enough for repair. */
+const OUTLINE_DEPRECATED_FILE = "outline/outline.deprecated.yaml";
 const WORLDBOOK_FILE = "outline/worldbook.yaml";
 const STATE_DIR = "state";
 const CHAPTERS_DIR = "chapters";
@@ -243,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. */
@@ -1391,7 +1396,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;
@@ -1506,11 +1511,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}`)];
 };
@@ -1920,6 +1926,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: {
@@ -2002,6 +2010,15 @@ 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$1(kind, `${path} contains duplicate name "${name}"`);
+		seen.add(name);
+	}
+};
 const validateSummary = (kind, value, path) => {
 	const summary = objectAt(kind, value, path);
 	for (const key of [
@@ -2095,6 +2112,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) => {
@@ -2112,6 +2130,20 @@ const validateNested = (kind, record) => {
 				"factions",
 				"rules"
 			]) listAt(kind, record[key], key);
+			{
+				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$1(kind, "world entities must have unique names");
+			}
 			return;
 		case "locks": {
 			integerAt(kind, record.locked_at_chapter, "locked_at_chapter");
@@ -2185,6 +2217,12 @@ const validateNested = (kind, record) => {
 				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": {
@@ -2384,7 +2422,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;
@@ -2401,7 +2439,7 @@ var FsStore = class {
 			return true;
 		} catch (error) {
 			if (isMissing(error)) return false;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async stat(relativePath) {
@@ -2414,7 +2452,7 @@ var FsStore = class {
 			};
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async list(relativeDir) {
@@ -2422,7 +2460,7 @@ var FsStore = class {
 			return (await promises.readdir(await this.safePath(relativeDir))).sort();
 		} catch (error) {
 			if (isMissing(error)) return [];
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	/**
@@ -2439,7 +2477,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);
 		}
 	}
 	/**
@@ -2457,7 +2495,7 @@ var FsStore = class {
 			};
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	/**
@@ -2477,7 +2515,7 @@ var FsStore = class {
 			};
 		} catch (error) {
 			if (isMissing(error)) return null;
-			throw error;
+			throw ioFailure(error);
 		}
 	}
 	async readText(relativePath) {
@@ -2485,7 +2523,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. */
@@ -2519,7 +2557,7 @@ var FsStore = class {
 				await promises.mkdir(current);
 			} catch (error) {
 				if (error.code === "EEXIST") continue;
-				throw error;
+				throw ioFailure(error);
 			}
 		}
 	}
@@ -2540,7 +2578,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) {
@@ -2585,7 +2623,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) {
@@ -2604,7 +2642,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. */
@@ -2632,6 +2670,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("/");
@@ -2755,21 +2799,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;
@@ -2777,9 +2818,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()) 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)
 	};
-	if (await matchesExpected()) {
+	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"
@@ -2787,7 +2864,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",
@@ -2797,7 +2874,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
@@ -2989,22 +3066,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;
 		}
@@ -3023,6 +3121,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;
@@ -3810,7 +3909,7 @@ function buildEpub(project, chapters) {
 const escapeXml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 // src/engine/book.ts
 const LENIENT_TITLE_PREFIX$1 = /^第\s*\d+\s*章\s*/;
-const text$1 = (value, where, max = LIMITS.maxOutlineTextFieldChars) => {
+const text$2 = (value, where, max = LIMITS.maxOutlineTextFieldChars) => {
 	if (typeof value !== "string" || value.trim() === "") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} must be a non-empty string`);
 	const trimmed = value.trim();
 	if (Array.from(trimmed).length > max) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} is ${Array.from(trimmed).length} characters; limit is ${max}`);
@@ -3829,13 +3928,13 @@ const stringArray$1 = (value, where, maxItems = 20) => {
 	if (value.length > maxItems) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} contains ${value.length} items; limit is ${maxItems}`);
 	const seen = /* @__PURE__ */ new Set();
 	return value.map((item, index) => {
-		const entry = text$1(item, `${where}[${index}]`, 200);
+		const entry = text$2(item, `${where}[${index}]`, 200);
 		if (seen.has(entry)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} contains duplicate "${entry}"`);
 		seen.add(entry);
 		return entry;
 	});
 };
-const positiveInteger = (value, where) => {
+const positiveInteger$1 = (value, where) => {
 	if (!Number.isInteger(value) || value < 1) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} must be a positive integer`);
 	return value;
 };
@@ -3845,7 +3944,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$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$2 = (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();
@@ -3947,7 +4046,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$1(patch)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "book must be an object");
+	if (!isRecord$2(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 [
@@ -3975,15 +4074,15 @@ 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$1(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}] must be an object`);
-		const start = positiveInteger(raw.start_chapter, `volumes[${index}].start_chapter`);
-		const end = positiveInteger(raw.end_chapter, `volumes[${index}].end_chapter`);
+		if (!isRecord$2(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}`);
 		const status = raw.status ?? "planned";
 		if (status !== "planned" && status !== "writing" && status !== "done") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}].status must be planned|writing|done`);
 		return {
-			id: typeof raw.id === "string" && raw.id.trim() !== "" ? raw.id.trim() : `V${index + 1}`,
-			title: text$1(raw.title, `volumes[${index}].title`, 120),
+			id: typeof raw.id === "string" && raw.id.trim() !== "" ? raw.id.trim() : "",
+			title: text$2(raw.title, `volumes[${index}].title`, 120),
 			start_chapter: start,
 			end_chapter: end,
 			goal: optionalText(raw.goal, `volumes[${index}].goal`),
@@ -3992,6 +4091,23 @@ function normalizeVolumes(input, options = { totalChapters: null }) {
 			status
 		};
 	});
+	const usedIds = /* @__PURE__ */ new Set();
+	const usedTitles = /* @__PURE__ */ new Set();
+	for (const volume of volumes) {
+		if (usedTitles.has(volume.title) && options.rejectDuplicateTitles !== false) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `duplicate volume title "${volume.title}"`);
+		usedTitles.add(volume.title);
+		if (volume.id === "") continue;
+		if (usedIds.has(volume.id)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `duplicate volume id "${volume.id}"`);
+		usedIds.add(volume.id);
+	}
+	let nextId = 1;
+	for (const volume of volumes) {
+		if (volume.id !== "") continue;
+		while (usedIds.has(`V${nextId}`)) nextId += 1;
+		volume.id = `V${nextId}`;
+		usedIds.add(volume.id);
+		nextId += 1;
+	}
 	volumes.sort((left, right) => left.start_chapter - right.start_chapter || left.end_chapter - right.end_chapter);
 	const ids = /* @__PURE__ */ new Set();
 	for (const [index, volume] of volumes.entries()) {
@@ -4075,8 +4191,8 @@ 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$1(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters[${index}] must be an object`);
-		const num = positiveInteger(raw.num, `chapters[${index}].num`);
+		if (!isRecord$2(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`);
 		const record = archived.get(num);
@@ -4093,13 +4209,13 @@ function normalizeOutlineChapters(input, options) {
 			if (cast.length !== base.cast.length || cast.some((name) => !base.cast.includes(name))) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} is archived; its cast cannot change`, "call novel_reopen first if the manuscript must be revised");
 			normalized.set(num, {
 				...base,
-				goal: raw.goal === void 0 || raw.goal === base.goal ? base.goal : text$1(raw.goal, `chapter ${num} goal`),
-				conflict: raw.conflict === void 0 || raw.conflict === base.conflict ? base.conflict : text$1(raw.conflict, `chapter ${num} conflict`),
-				hook: raw.hook === void 0 || raw.hook === base.hook ? base.hook : text$1(raw.hook, `chapter ${num} hook`),
+				goal: raw.goal === void 0 || raw.goal === base.goal ? base.goal : text$2(raw.goal, `chapter ${num} goal`),
+				conflict: raw.conflict === void 0 || raw.conflict === base.conflict ? base.conflict : text$2(raw.conflict, `chapter ${num} conflict`),
+				hook: raw.hook === void 0 || raw.hook === base.hook ? base.hook : text$2(raw.hook, `chapter ${num} hook`),
 				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
 			});
@@ -4114,18 +4230,19 @@ function normalizeOutlineChapters(input, options) {
 			"情感爆发章",
 			"纯叙事章"
 		].includes(raw.scene_type)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters[${index}].scene_type is invalid`);
-		const cast = stringArray$1(raw.cast, `chapters[${index}].cast`, 8);
+		const previousCard = existing.get(num);
+		const cast = raw.cast == null && previousCard?.status === "planned" ? previousCard.cast : stringArray$1(raw.cast, `chapters[${index}].cast`, 8);
 		normalized.set(num, {
 			num,
-			volume: volumeNumberFor(options.volumes, num, raw.volume),
+			volume: raw.volume !== void 0 ? volumeNumberFor(options.volumes, num, raw.volume) : previousCard?.status === "planned" ? volumeForChapter(options.volumes, num, previousCard.volume) : volumeNumberFor(options.volumes, num, void 0),
 			title,
 			scene_type: raw.scene_type,
-			goal: text$1(raw.goal, `chapters[${index}].goal`),
-			conflict: text$1(raw.conflict, `chapters[${index}].conflict`),
-			hook: text$1(raw.hook, `chapters[${index}].hook`),
+			goal: text$2(raw.goal, `chapters[${index}].goal`),
+			conflict: text$2(raw.conflict, `chapters[${index}].conflict`),
+			hook: text$2(raw.hook, `chapters[${index}].hook`),
 			cast,
 			target_words: wordPair(raw.target_words, `chapters[${index}].target_words`),
-			notes: optionalText(raw.notes, `chapters[${index}].notes`, LIMITS.maxOutlineNotesChars),
+			notes: raw.notes == null && previousCard?.status === "planned" ? previousCard.notes : optionalText(raw.notes, `chapters[${index}].notes`, LIMITS.maxOutlineNotesChars),
 			status: "planned",
 			archived_at: null,
 			word_count: null,
@@ -4139,7 +4256,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
 		});
@@ -4148,7 +4265,7 @@ function normalizeOutlineChapters(input, options) {
 }
 /** Validate a document loaded from disk. Throws a fault, not an input error. */
 function validateOutlineDocument(value, options) {
-	if (!isRecord$1(value)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml must be a mapping");
+	if (!isRecord$2(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([
@@ -4160,7 +4277,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$1(value.book)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml book must be a mapping");
+		if (!isRecord$2(value.book)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "outline/outline.yaml book must be a mapping");
 		const allowedBook = /* @__PURE__ */ new Set([
 			"premise",
 			"logline",
@@ -4175,14 +4292,17 @@ function validateOutlineDocument(value, options) {
 		]);
 		for (const key of Object.keys(value.book)) if (!allowedBook.has(key)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline/outline.yaml book has unknown key "${key}"`);
 		const book = mergeBookPlan(emptyBookPlan(), value.book);
-		const volumes = normalizeVolumes(value.volumes, { totalChapters: options.totalChapters });
+		const volumes = normalizeVolumes(value.volumes, {
+			totalChapters: options.totalChapters,
+			rejectDuplicateTitles: false
+		});
 		if (!Array.isArray(value.chapters)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "chapters must be an array");
 		if (value.chapters.length > LIMITS.maxOutlineChapters) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters contains ${value.chapters.length} items; limit is ${LIMITS.maxOutlineChapters}`);
 		const chapters = [];
 		const seen = /* @__PURE__ */ new Set();
 		for (const [index, raw] of value.chapters.entries()) {
-			if (!isRecord$1(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapters[${index}] must be an object`);
-			const num = positiveInteger(raw.num, `chapters[${index}].num`);
+			if (!isRecord$2(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`);
 			seen.add(num);
@@ -4208,9 +4328,9 @@ function validateOutlineDocument(value, options) {
 				volume: volumeNumberFor(volumes, num, raw.volume),
 				title: chapterTitleBody(raw.title, options.titleRule, `chapters[${index}].title`),
 				scene_type: scene,
-				goal: planned ? text$1(raw.goal, `chapters[${index}].goal`) : optionalText(raw.goal, `chapters[${index}].goal`),
-				conflict: planned ? text$1(raw.conflict, `chapters[${index}].conflict`) : optionalText(raw.conflict, `chapters[${index}].conflict`),
-				hook: planned ? text$1(raw.hook, `chapters[${index}].hook`) : optionalText(raw.hook, `chapters[${index}].hook`),
+				goal: planned ? text$2(raw.goal, `chapters[${index}].goal`) : optionalText(raw.goal, `chapters[${index}].goal`),
+				conflict: planned ? text$2(raw.conflict, `chapters[${index}].conflict`) : optionalText(raw.conflict, `chapters[${index}].conflict`),
+				hook: planned ? text$2(raw.hook, `chapters[${index}].hook`) : optionalText(raw.hook, `chapters[${index}].hook`),
 				cast: stringArray$1(raw.cast, `chapters[${index}].cast`, 8),
 				target_words: wordPair(raw.target_words, `chapters[${index}].target_words`),
 				notes: optionalText(raw.notes, `chapters[${index}].notes`, LIMITS.maxOutlineNotesChars),
@@ -4247,7 +4367,7 @@ function mergeWorldbook(existing, patch, now) {
 		...existing,
 		updated_at: now
 	};
-	if (!isRecord$1(patch)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "worldbook must be an object");
+	if (!isRecord$2(patch)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "worldbook must be an object");
 	const result = {
 		...existing,
 		updated_at: now,
@@ -4267,21 +4387,21 @@ 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$1(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${key}[${index}] must be an object`);
+			if (!isRecord$2(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${key}[${index}] must be an object`);
 			return raw;
 		});
 	};
 	if (patch.rules !== void 0) {
 		result.rules = records(patch.rules, "rules").map((raw, index) => ({
-			name: text$1(raw.name, `rules[${index}].name`, 120),
-			description: text$1(raw.description, `rules[${index}].description`, LIMITS.maxWorldbookTextChars)
+			name: text$2(raw.name, `rules[${index}].name`, 120),
+			description: text$2(raw.description, `rules[${index}].description`, LIMITS.maxWorldbookTextChars)
 		}));
 		uniqueNames(result.rules, "rules");
 	}
 	if (patch.factions !== void 0) {
 		result.factions = records(patch.factions, "factions").map((raw, index) => ({
-			name: text$1(raw.name, `factions[${index}].name`, 120),
-			description: text$1(raw.description, `factions[${index}].description`, LIMITS.maxWorldbookTextChars),
+			name: text$2(raw.name, `factions[${index}].name`, 120),
+			description: text$2(raw.description, `factions[${index}].description`, LIMITS.maxWorldbookTextChars),
 			goal: optionalText(raw.goal, `factions[${index}].goal`)
 		}));
 		uniqueNames(result.factions, "factions");
@@ -4291,8 +4411,8 @@ function mergeWorldbook(existing, patch, now) {
 			const capacity = raw.capacity ?? 0;
 			if (!Number.isInteger(capacity) || capacity < 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `locations[${index}].capacity must be a non-negative integer`);
 			return {
-				name: text$1(raw.name, `locations[${index}].name`, 120),
-				description: text$1(raw.description, `locations[${index}].description`, LIMITS.maxWorldbookTextChars),
+				name: text$2(raw.name, `locations[${index}].name`, 120),
+				description: text$2(raw.description, `locations[${index}].description`, LIMITS.maxWorldbookTextChars),
 				layout: optionalText(raw.layout, `locations[${index}].layout`),
 				capacity
 			};
@@ -4301,17 +4421,17 @@ function mergeWorldbook(existing, patch, now) {
 	}
 	if (patch.characters !== void 0) {
 		result.characters = records(patch.characters, "characters").map((raw, index) => ({
-			name: text$1(raw.name, `characters[${index}].name`, 120),
-			role: text$1(raw.role, `characters[${index}].role`, 60),
-			description: text$1(raw.description, `characters[${index}].description`, LIMITS.maxWorldbookTextChars),
+			name: text$2(raw.name, `characters[${index}].name`, 120),
+			role: text$2(raw.role, `characters[${index}].role`, 60),
+			description: text$2(raw.description, `characters[${index}].description`, LIMITS.maxWorldbookTextChars),
 			arc: optionalText(raw.arc, `characters[${index}].arc`)
 		}));
 		uniqueNames(result.characters, "characters");
 	}
 	if (patch.glossary !== void 0) {
 		result.glossary = records(patch.glossary, "glossary").map((raw, index) => ({
-			term: text$1(raw.term, `glossary[${index}].term`, 120),
-			definition: text$1(raw.definition, `glossary[${index}].definition`, LIMITS.maxWorldbookTextChars)
+			term: text$2(raw.term, `glossary[${index}].term`, 120),
+			definition: text$2(raw.definition, `glossary[${index}].definition`, LIMITS.maxWorldbookTextChars)
 		}));
 		const seen = /* @__PURE__ */ new Set();
 		for (const entry of result.glossary) {
@@ -4320,8 +4440,8 @@ function mergeWorldbook(existing, patch, now) {
 		}
 	}
 	if (patch.backstory !== void 0) result.backstory = records(patch.backstory, "backstory").map((raw, index) => ({
-		time: text$1(raw.time, `backstory[${index}].time`, 120),
-		event: text$1(raw.event, `backstory[${index}].event`, LIMITS.maxWorldbookTextChars)
+		time: text$2(raw.time, `backstory[${index}].time`, 120),
+		event: text$2(raw.event, `backstory[${index}].event`, LIMITS.maxWorldbookTextChars)
 	}));
 	if (patch.facts !== void 0) {
 		result.facts = records(patch.facts, "facts").map((raw, index) => {
@@ -4330,9 +4450,9 @@ function mergeWorldbook(existing, patch, now) {
 			const tolerance = raw.tolerance ?? 0;
 			if (typeof tolerance !== "number" || !Number.isFinite(tolerance) || tolerance < 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `facts[${index}].tolerance must be a non-negative number`);
 			return {
-				alias: text$1(raw.alias, `facts[${index}].alias`, 120),
+				alias: text$2(raw.alias, `facts[${index}].alias`, 120),
 				value,
-				unit: text$1(raw.unit, `facts[${index}].unit`, 40),
+				unit: text$2(raw.unit, `facts[${index}].unit`, 40),
 				tolerance,
 				...raw.note === void 0 ? {} : { note: optionalText(raw.note, `facts[${index}].note`) }
 			};
@@ -4347,7 +4467,7 @@ function mergeWorldbook(existing, patch, now) {
 }
 /** Validate a worldbook loaded from disk. */
 function validateWorldbookDocument(value, now) {
-	if (!isRecord$1(value)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, "outline/worldbook.yaml must be a mapping");
+	if (!isRecord$2(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([
@@ -4758,7 +4878,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$1(parsed)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline ${format} must be a mapping`);
+	if (!isRecord$2(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([
@@ -4853,8 +4973,238 @@ function renderWorldbookMarkdown(project, document) {
 	section("角色", document.characters.map((entry) => `- **${oneLine(entry.name)}**（${oneLine(entry.role)}）：${oneLine(entry.description)}${entry.arc === "" ? "" : `；弧线：${oneLine(entry.arc)}`}`));
 	section("术语", document.glossary.map((entry) => `- **${oneLine(entry.term)}**：${oneLine(entry.definition)}`));
 	section("前史", document.backstory.map((entry) => `- ${oneLine(entry.time)}：${oneLine(entry.event)}`));
+	section("数值事实", (document.facts ?? []).map((fact) => `- **${oneLine(fact.alias)}**：${fact.value}${oneLine(fact.unit)}${fact.tolerance === void 0 ? "" : `（容差 ${fact.tolerance}）`}${fact.note === void 0 || fact.note === "" ? "" : `；${oneLine(fact.note)}`}`));
 	return parts.join("\n");
 }
+// src/engine/outline-merge.ts
+const isRecord$1 = (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();
+};
+const positiveInteger = (value, where) => {
+	if (!Number.isInteger(value) || value < 1) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${where} must be a positive integer`);
+	return value;
+};
+const parseChapterNumbers = (value, field) => {
+	if (value === void 0) return /* @__PURE__ */ new Set();
+	if (!Array.isArray(value)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${field} must be an array of chapter numbers`);
+	const result = /* @__PURE__ */ new Set();
+	for (const [index, raw] of value.entries()) {
+		const num = positiveInteger(raw, `${field}[${index}]`);
+		if (result.has(num)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${field} contains duplicate chapter ${num}`);
+		result.add(num);
+	}
+	return result;
+};
+const parseVolumeTitles = (value, field) => {
+	if (value === void 0) return /* @__PURE__ */ new Set();
+	if (!Array.isArray(value)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${field} must be an array of volume titles`);
+	const result = /* @__PURE__ */ new Set();
+	for (const [index, raw] of value.entries()) {
+		const title = text$1(raw, `${field}[${index}]`);
+		if (result.has(title)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${field} contains duplicate "${title}"`);
+		result.add(title);
+	}
+	return result;
+};
+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;
+		result.add(raw.num);
+	}
+	return result;
+};
+const volumeByTitle = (volumes) => new Map(volumes.map((volume) => [volume.title, volume]));
+/**
+* `volumes` is an upsert keyed by title: omitted volumes survive, and removal
+* requires naming the volume in `remove_volumes`. This deliberately does not
+* accept a positional or full-list replacement.
+*/
+const mergeVolumes = (options) => {
+	const removed = parseVolumeTitles(options.remove_volumes, "remove_volumes");
+	if (options.volumes === void 0 && removed.size === 0) return {
+		volumes: [...options.existingVolumes],
+		added: [],
+		updated: [],
+		removed: []
+	};
+	if (options.volumes !== void 0 && !Array.isArray(options.volumes)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "volumes must be an array");
+	if (options.volumes !== void 0 || removed.size > 0) {
+		const existingTitles = /* @__PURE__ */ new Set();
+		for (const volume of options.existingVolumes) {
+			if (existingTitles.has(volume.title)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `outline has duplicate volume title "${volume.title}"`, "repair the volume titles with novel_amend before submitting volumes");
+			existingTitles.add(volume.title);
+		}
+	}
+	const byTitle = volumeByTitle(options.existingVolumes);
+	const usedIds = new Set(options.existingVolumes.map((volume) => volume.id));
+	let nextGeneratedId = 1;
+	const generatedId = () => {
+		while (usedIds.has(`V${nextGeneratedId}`)) nextGeneratedId += 1;
+		const id = `V${nextGeneratedId}`;
+		usedIds.add(id);
+		nextGeneratedId += 1;
+		return id;
+	};
+	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`);
+		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);
+		const base = byTitle.get(title);
+		const explicitId = typeof raw.id === "string" && raw.id.trim() !== "" ? raw.id.trim() : void 0;
+		const id = base?.id ?? explicitId ?? generatedId();
+		if (!usedIds.has(id)) usedIds.add(id);
+		byTitle.set(title, {
+			...base ?? {},
+			...raw,
+			id,
+			title
+		});
+	}
+	for (const title of removed) {
+		if (submitted.has(title)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volume "${title}" cannot be both submitted and removed`);
+		const existing = byTitle.get(title);
+		if (existing === void 0) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `cannot remove volume "${title}": it is not in the plan`);
+		if (existing.status === "done") throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `cannot remove volume "${title}": its status is done`, "a completed volume is archive evidence; remove only planned/writing volumes");
+		byTitle.delete(title);
+	}
+	const volumes = normalizeVolumes([...byTitle.values()], { totalChapters: options.totalChapters });
+	const before = volumeByTitle(options.existingVolumes);
+	const after = volumeByTitle(volumes);
+	return {
+		volumes,
+		added: [...after.keys()].filter((title) => !before.has(title)),
+		updated: [...after.keys()].filter((title) => before.has(title) && stableJson(before.get(title)) !== stableJson(after.get(title))),
+		removed: [...removed]
+	};
+};
+const remapVolume = (card, oldVolumes, newVolumes) => {
+	if (card.volume === null || card.volume === void 0) return card;
+	const previous = oldVolumes[card.volume - 1];
+	if (previous === void 0) return {
+		...card,
+		volume: null
+	};
+	const nextIndex = newVolumes.findIndex((volume) => volume.title === previous.title);
+	if (nextIndex < 0) return {
+		...card,
+		volume: null
+	};
+	const next = newVolumes[nextIndex];
+	return {
+		...card,
+		volume: card.num >= next.start_chapter && card.num <= next.end_chapter ? nextIndex + 1 : null
+	};
+};
+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;
+		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, `${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");
+	}
+};
+/**
+* Merge chapter cards by num. Existing planned cards are appended back when
+* omitted; removal is name-only (`remove`), and archived cards are always
+* backfilled from the chapter index.
+*/
+const mergeOutline = (options) => {
+	const submitted = submittedNumbers(options.chapters);
+	const removed = parseChapterNumbers(options.remove, "remove");
+	const volumeChanges = mergeVolumes(options);
+	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());
+	for (const num of removed) {
+		if (submitted.has(num)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} cannot be both submitted and removed`);
+		if (num === options.activeChapter) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `cannot remove the active chapter ${num} card`, "archive or move the active chapter first; the card is required while the chapter is in flight");
+		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: existingForNormalize,
+		archived: options.archivedChapters,
+		titleRule: options.titleRule,
+		totalChapters: options.totalChapters,
+		defaultTargetWords: options.defaultTargetWords,
+		now: options.now
+	});
+	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);
+		if (before === void 0) added.add(card.num);
+		else if (stableJson(before) !== stableJson(card)) updated.add(card.num);
+	}
+	for (const card of options.existing) {
+		if (submitted.has(card.num) || removed.has(card.num)) continue;
+		if (card.status === "archived" && !archivedNums.has(card.num)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${card.num} has an archived outline card but is not in the chapter index`, "repair the outline or reopen/archive the chapter so the card status matches the index");
+		if (archivedNums.has(card.num)) {
+			if (!byNum.has(card.num)) byNum.set(card.num, {
+				...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);
+		if (byNum.has(card.num)) {
+			const current = byNum.get(card.num);
+			if (stableJson(current) !== stableJson(remapped)) {
+				byNum.set(card.num, remapped);
+				reindexed.add(card.num);
+			}
+		} else {
+			byNum.set(card.num, remapped);
+			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,
+		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/state-delta.ts
 const SECTIONS = [
 	"characters",
@@ -4878,6 +5228,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");
 }
@@ -4971,6 +5343,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 ?? "";
@@ -4991,7 +5377,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`);
@@ -5002,12 +5388,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
 			};
@@ -5028,10 +5416,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
@@ -5055,6 +5444,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);
@@ -5090,8 +5480,11 @@ function applyStateDelta(input) {
 		if (!input.text.includes(name)) fail$1(`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}`);
@@ -5100,22 +5493,33 @@ 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 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) {
+			if ((declared.kind ?? expected) === null) fail$1(`world.${name} does not exist; declare kind (location|ability|artifact|faction|rule) or list it in summary.new_elements`);
+			if (!input.text.includes(name)) fail$1(`world entity "${name}" is new but does not appear in the manuscript`);
+			action = "created";
+			warnReclass(name, "updated", "created", "missing-updated-as-created");
+		} else if (action === "no_change" && existing === null && expected !== null) {
+			if (!input.text.includes(name)) fail$1(`world entity "${name}" is new but does not appear in the manuscript`);
+			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`);
@@ -5128,7 +5532,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,
@@ -5147,7 +5551,8 @@ function applyStateDelta(input) {
 			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;
@@ -5290,6 +5695,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`);
@@ -5356,7 +5762,9 @@ function applyStateDelta(input) {
 		foreshadows,
 		timeline,
 		relationships,
-		assigned
+		assigned,
+		warnings,
+		normalized_world: normalizedWorld
 	};
 }
 // src/engine/insight.ts
@@ -6692,6 +7100,26 @@ const SEMANTIC_CHECK_IDS = [
 	"L2-VOICE",
 	"L2-POV"
 ];
+/**
+* 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;
+	rounds_consumed = 0;
+	failure_class = "submission";
+	constructor(items) {
+		const passed = items.filter((item) => item.state === "pass").length;
+		const failed = items.filter((item) => item.state !== "pass" && item.state !== "fail").length;
+		const first = items.find((item) => item.state !== "pass" && item.state !== "fail");
+		super(ERROR_CODES.CHECK_SUBMISSION_INVALID, `semantic submission is invalid: ${first?.id ?? "semantic"} ${first?.state ?? "invalid"}${first?.detail === void 0 ? "" : ` (${first.detail})`}; ${passed} passed, ${failed} failed; no check was written and no round was consumed`, "resubmit novel_check with all five semantic items; each needs a distinct verbatim quote of at least 8 characters");
+		this.items = items;
+		this.passed = passed;
+		this.failed = failed;
+	}
+};
 /** Extract the quoted part of an evidence string, tolerating "第 N 段：" labels. */
 function evidenceQuote(value) {
 	let candidate = value.trim();
@@ -6701,151 +7129,312 @@ function evidenceQuote(value) {
 	candidate = candidate.replace(/^[「『“"']/, "").replace(/[」』”"']$/, "").trim();
 	return candidate;
 }
-/** Sentence spans, including the terminating punctuation, for evidence de-duplication. */
+const CLOSING_PUNCTUATION = /* @__PURE__ */ new Set([
+	"」",
+	"』",
+	"”",
+	"\"",
+	"’",
+	"'",
+	"）",
+	")",
+	"】",
+	"]"
+]);
+/**
+* Split text into sentence spans while treating every non-empty line as a
+* paragraph boundary. A quote may cover multiple sentences or paragraphs; the
+* spans are only used to prove that no two evidence items reuse the same
+* passage. Trailing closing quotes belong to the sentence they terminate.
+*/
 function sentenceSpans(text) {
 	const spans = [];
-	let start = 0;
-	for (let index = 0; index < text.length; index += 1) if ("。！？!?".includes(text[index])) {
-		spans.push({
-			start,
-			end: index + 1
-		});
-		start = index + 1;
+	let paragraph = 1;
+	let lineStart = 0;
+	let sentenceStart = 0;
+	for (let index = 0; index < text.length; index += 1) {
+		const char = text[index];
+		if (char === "\n") {
+			if (text.slice(lineStart, index).trim() !== "") {
+				if (index > sentenceStart) spans.push({
+					start: sentenceStart,
+					end: index,
+					paragraph
+				});
+				paragraph += 1;
+			}
+			lineStart = index + 1;
+			sentenceStart = index + 1;
+			continue;
+		}
+		if ("。！？!?".includes(char)) {
+			let end = index + 1;
+			while (end < text.length && CLOSING_PUNCTUATION.has(text[end])) end += 1;
+			spans.push({
+				start: sentenceStart,
+				end,
+				paragraph
+			});
+			sentenceStart = end;
+			index = end - 1;
+		}
 	}
-	if (start < text.length) spans.push({
-		start,
-		end: text.length
+	if (sentenceStart < text.length) spans.push({
+		start: sentenceStart,
+		end: text.length,
+		paragraph
 	});
 	return spans;
 }
+function nearestParagraph(text, quote) {
+	const paragraphs = splitParagraphs(text);
+	let best = null;
+	for (const [index, paragraph] of paragraphs.entries()) {
+		const score = textSimilarity(paragraph, quote);
+		if (best === null || score > best.score) best = {
+			index,
+			paragraph,
+			score
+		};
+	}
+	if (best === null) 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`;
+	}
+};
 /**
-* 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.
+* Validate and evaluate all five L2 semantic items.
+*
+* Evidence is located by character range, not by requiring one sentence. Two
+* items may not overlap or reuse a sentence; a quote that exists but fails
+* those rules is reported as OVERLAP/SAME_SENTENCE instead of the old generic
+* "overlapping text or the same sentence" message.
 */
-function evaluateSemantic(text, items) {
-	const blocking = [];
-	const seen = /* @__PURE__ */ new Set();
-	const seenQuotes = /* @__PURE__ */ new Set();
+function evaluateSemantic(text, input) {
+	const items = [];
 	const spans = [];
 	const sentences = sentenceSpans(text);
-	const usedSentences = /* @__PURE__ */ new Set();
-	for (const [index, item] of items.entries()) {
+	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`
+		const duplicate = acceptedQuotes.get(quote);
+		if (duplicate !== void 0) {
+			items.push({
+				id,
+				state: "duplicate",
+				quote,
+				conflict_with: duplicate,
+				detail: `${id} repeats ${duplicate}'s quote exactly`
 			});
 			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 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 start = text.indexOf(quote);
-		let sentence = -1;
-		while (start !== -1) {
+		let accepted = null;
+		let overlapWith;
+		let sameSentenceWith;
+		let boundary = false;
+		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;
-				break;
+			const conflict = spans.find((span) => start < span.end && span.start < end);
+			if (conflict !== void 0) {
+				overlapWith ??= conflict.id;
+				continue;
+			}
+			const covered = sentences.map((sentence, sentenceIndex) => ({
+				sentence,
+				sentenceIndex
+			})).filter(({ sentence }) => start < sentence.end && sentence.start < end);
+			if (covered.length === 0) {
+				boundary = true;
+				continue;
 			}
-			start = text.indexOf(quote, start + 1);
+			const used = covered.find(({ sentenceIndex }) => usedSentences.has(sentenceIndex));
+			if (used !== void 0) {
+				sameSentenceWith ??= usedSentences.get(used.sentenceIndex);
+				continue;
+			}
+			accepted = {
+				start,
+				end,
+				id
+			};
+			for (const { sentenceIndex } of covered) usedSentences.set(sentenceIndex, id);
+			break;
 		}
-		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 (accepted === null) {
+			if (overlapWith !== void 0) items.push({
+				id,
+				state: "overlap",
+				quote,
+				conflict_with: overlapWith,
+				detail: `${id} overlaps ${overlapWith}'s accepted evidence interval`
+			});
+			else if (sameSentenceWith !== void 0) items.push({
+				id,
+				state: "same_sentence",
+				quote,
+				conflict_with: sameSentenceWith,
+				detail: `${id} reuses a sentence already cited by ${sameSentenceWith}`
+			});
+			else items.push({
+				id,
+				state: boundary ? "boundary" : "same_sentence",
+				quote,
+				...boundary ? {} : { conflict_with: id },
+				detail: boundary ? `${id} cannot be mapped onto a sentence boundary` : `${id} reuses a sentence already cited by another item`
 			});
 			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"}`
+		spans.push(accepted);
+		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",
-		scope: "check",
+	for (const id of seenIds) if (!SEMANTIC_CHECK_IDS.includes(id)) items.push({
+		id,
+		state: "invalid",
 		detail: `${id} is not one of the required P6 semantic checks`
 	});
+	const findings = items.filter((item) => item.state === "fail").map((item) => ({
+		code: "SEMANTIC_CHECK_FAILED",
+		scope: "check",
+		detail: item.detail ?? `${item.id}: semantic check failed`
+	}));
+	const submissionItems = items.filter((item) => submissionState(item.state));
+	const blocking = [...submissionItems.map((item) => ({
+		code: codeForState(item.state),
+		scope: "check",
+		detail: detailFor(item)
+	})), ...findings];
 	return {
+		items,
+		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);
+	return evaluation;
+}
 // src/engine/gates.ts
 const block = (code, detail, hint, scope) => ({
 	code,
@@ -6855,6 +7444,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`)];
@@ -6951,7 +7541,29 @@ const summarySchema = (input) => {
 		"locations",
 		"abilities",
 		"artifacts"
-	]) if (!textArray(newElements[key])) problems.push(`new_elements.${key} must be a string array`);
+	]) {
+		if (!textArray(newElements[key])) problems.push(`new_elements.${key} must be a string array`);
+		for (const name of textArray(newElements[key]) ? newElements[key] : []) {
+			if (!input.text.includes(name)) problems.push(`new_elements.${key} lists "${name}", but the manuscript never mentions it`);
+			if (input.operation !== "archiveChapter") {
+				const ledger = input.evidence.world;
+				if (ledger !== null && [
+					ledger.locations,
+					ledger.abilities,
+					ledger.artifacts,
+					ledger.factions,
+					ledger.rules
+				].some((rows) => rows.some((row) => row.name === name))) problems.push(`new_elements.${key} lists "${name}", but state/world.yaml already has it; remove it or use updated/no_change`);
+			}
+		}
+	}
+	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");
@@ -6994,7 +7606,7 @@ const outlineAlignment = (input) => {
 	const card = outline.chapters.find((candidate) => candidate.num === input.chapter);
 	if (card === void 0) {
 		if (!outline.book.strict) return [];
-		return [block("PG-13", `chapter ${input.chapter} has no outline card while strict mode is on`, "read novel_state {kind:\"outline\"}, then submit every existing card plus this one with novel_outline (full replacement); or turn strict off with novel_blueprint")];
+		return [block("PG-13", `chapter ${input.chapter} has no outline card while strict mode is on`, "read novel_state {kind:\"outline\"}, then submit only the missing card with novel_outline (upsert by num; omitted cards are kept); do not turn strict off")];
 	}
 	const problems = [];
 	if (card.status === "archived") problems.push(`chapter ${input.chapter} is already archived but is still the active chapter; call novel_reopen first`);
@@ -7150,6 +7762,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 [];
@@ -7215,7 +7828,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",
@@ -7783,6 +8402,8 @@ 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();
 	briefs;
@@ -7810,6 +8431,7 @@ var EngineService = class {
 		this.disposed = true;
 		this.stores.clear();
 		this.replay.clear();
+		this.exportArtifactEpoch.clear();
 		this.compiled = null;
 	}
 	get rulepack() {
@@ -8212,6 +8834,7 @@ var EngineService = class {
 			"ending",
 			"strict",
 			"volumes",
+			"confirm_remove",
 			"root"
 		]);
 		for (const key of Object.keys(input)) if (!allowed.has(key)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `unknown novel_blueprint argument "${key}"`, `allowed: ${[...allowed].join(", ")}`);
@@ -8228,9 +8851,12 @@ var EngineService = class {
 				this.assertPlanningDocumentReadable(snapshot, "outline", "novel_blueprint");
 				this.assertArchiveIndexReadable(snapshot, "novel_blueprint");
 				const now = this.now().toISOString();
-				const bookPatch = Object.fromEntries(Object.entries(input).filter(([key]) => key !== "volumes" && key !== "root"));
+				const bookPatch = Object.fromEntries(Object.entries(input).filter(([key]) => key !== "volumes" && key !== "confirm_remove" && key !== "root"));
 				const book = mergeBookPlan(snapshot.outline.book, bookPatch);
 				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)
@@ -8245,6 +8871,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,
@@ -8284,19 +8911,113 @@ var EngineService = class {
 			}
 		});
 	}
+	outlinePlanChange(snapshot, input, now) {
+		const book = mergeBookPlan(snapshot.outline.book, input.book === void 0 ? void 0 : {
+			...input.book,
+			...input.strict === void 0 ? {} : { strict: input.strict }
+		});
+		if (input.strict !== void 0) {
+			book.strict = input.strict;
+			book.strict_explicit = true;
+		} else if (input.book?.strict === void 0) {
+			if ((input.chapters?.length ?? 0) > 0 && snapshot.outline.chapters.length === 0 && snapshot.outline.book.strict_explicit !== true) {
+				book.strict = true;
+				book.strict_explicit = true;
+			}
+		}
+		const merged = mergeOutline({
+			chapters: input.chapters ?? [],
+			remove: input.remove,
+			volumes: input.volumes,
+			remove_volumes: input.remove_volumes,
+			existing: snapshot.outline.chapters,
+			archivedChapters: snapshot.chapters.chapters,
+			existingVolumes: snapshot.outline.volumes,
+			titleRule: this.rulepack.format.title,
+			totalChapters: snapshot.project.targets.total_chapters,
+			defaultTargetWords: snapshot.project.targets.words_per_chapter,
+			now,
+			activeChapter: snapshot.pipeline.chapter
+		});
+		return {
+			outline: {
+				schema_version: 1,
+				updated_at: now,
+				book,
+				volumes: merged.volumes,
+				chapters: merged.chapters
+			},
+			data: {
+				planned: merged.chapters.filter((card) => card.status === "planned").length,
+				archived: merged.chapters.filter((card) => card.status === "archived").length,
+				total: merged.chapters.length,
+				strict: book.strict,
+				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,
+				volumes_removed: merged.volumes_removed
+			}
+		};
+	}
 	async submitOutline(input) {
 		const allowed = /* @__PURE__ */ new Set([
 			"book",
 			"volumes",
 			"chapters",
 			"strict",
+			"remove",
+			"remove_volumes",
+			"dry_run",
 			"root"
 		]);
 		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");
+		if ((input.chapters === void 0 || Array.isArray(input.chapters) && input.chapters.length === 0) && (input.remove === void 0 || input.remove.length === 0) && (input.remove_volumes === void 0 || input.remove_volumes.length === 0) && (input.volumes === void 0 || Array.isArray(input.volumes) && input.volumes.length === 0) && (input.book === void 0 || typeof input.book === "object" && input.book !== null && Object.keys(input.book).length === 0) && input.strict === void 0 && input.dry_run !== true) return {
+			data: {
+				planned: current.outline.chapters.filter((card) => card.status === "planned").length,
+				archived: current.outline.chapters.filter((card) => card.status === "archived").length,
+				total: current.outline.chapters.length,
+				strict: current.outline.book.strict,
+				volumes: current.outline.volumes.length,
+				added: [],
+				updated: [],
+				reindexed: [],
+				removed: [],
+				volumes_added: [],
+				volumes_updated: [],
+				volumes_removed: []
+			},
+			revision: current.pipeline.revision,
+			warnings: []
+		};
+		if (input.dry_run === true) {
+			const plan = this.outlinePlanChange(current, input, this.now().toISOString());
+			this.assertOutlineWritable(current, plan.outline, "novel_outline");
+			return {
+				data: {
+					...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,
+				warnings: []
+			};
+		}
 		return this.mutate({
 			root: input.root,
 			op: "submitOutline",
@@ -8305,72 +9026,34 @@ var EngineService = class {
 				this.assertProjectReadable(snapshot, "novel_outline");
 				this.assertPlanningDocumentReadable(snapshot, "outline", "novel_outline");
 				this.assertArchiveIndexReadable(snapshot, "novel_outline");
-				const now = this.now().toISOString();
-				const book = mergeBookPlan(snapshot.outline.book, input.book === void 0 ? void 0 : {
-					...input.book,
-					...input.strict === void 0 ? {} : { strict: input.strict }
-				});
-				if (input.strict !== void 0) {
-					book.strict = input.strict;
-					book.strict_explicit = true;
-				} else if (input.book?.strict === void 0) {
-					if (snapshot.outline.chapters.length === 0 && snapshot.outline.book.strict_explicit !== true) {
-						book.strict = true;
-						book.strict_explicit = true;
-					}
-				}
-				const volumes = input.volumes === void 0 ? snapshot.outline.volumes : normalizeVolumes(input.volumes, { totalChapters: snapshot.project.targets.total_chapters });
-				const chapters = normalizeOutlineChapters(input.chapters, {
-					volumes,
-					existing: snapshot.outline.chapters,
-					archived: snapshot.chapters.chapters,
-					titleRule: this.rulepack.format.title,
-					totalChapters: snapshot.project.targets.total_chapters,
-					defaultTargetWords: snapshot.project.targets.words_per_chapter,
-					now
-				});
-				const outline = {
-					schema_version: 1,
-					updated_at: now,
-					book,
-					volumes,
-					chapters
-				};
-				this.assertActiveCardPreserved(snapshot, book.strict, chapters, "novel_outline");
-				this.assertOutlineWritable(snapshot, outline, "novel_outline");
-				const planned = chapters.filter((card) => card.status === "planned").length;
-				const archived = chapters.filter((card) => card.status === "archived").length;
-				const kept = new Set(chapters.filter((card) => card.status === "planned").map((card) => card.num));
-				const dropped = snapshot.outline.chapters.filter((card) => card.status === "planned" && !kept.has(card.num)).map((card) => card.num);
+				const plan = this.outlinePlanChange(snapshot, input, this.now().toISOString());
+				this.assertOutlineWritable(snapshot, plan.outline, "novel_outline");
 				const nextPipeline = pipelineWith(snapshot, context.revision, { last_action: action("novel_outline", this.now(), shortDigest(stableJson(input))) });
+				const files = [{
+					path: OUTLINE_FILE,
+					text: yaml(plan.outline)
+				}, {
+					path: joinRel(STATE_DIR, STATE_FILES.pipeline),
+					text: yaml(nextPipeline)
+				}];
+				const prior = await context.store.readText(OUTLINE_FILE);
+				if (prior !== null) files.push({
+					path: OUTLINE_DEPRECATED_FILE,
+					text: prior
+				});
 				return {
-					files: [{
-						path: OUTLINE_FILE,
-						text: yaml(outline)
-					}, {
-						path: joinRel(STATE_DIR, STATE_FILES.pipeline),
-						text: yaml(nextPipeline)
-					}],
+					files,
 					backup: true,
-					data: {
-						planned,
-						archived,
-						total: chapters.length,
-						strict: book.strict,
-						volumes: volumes.length
-					},
-					warnings: dropped.length === 0 ? [] : [{
-						code: "OUTLINE_PLANNED_DROPPED",
-						message: `this replacement dropped planned cards: ${dropped.join(", ")}; resubmit every existing card when adding one`
-					}],
+					data: plan.data,
+					warnings: [],
 					event: {
 						name: "novel/planned",
 						payload: {
 							schemaVersion: 1,
 							projectRoot: snapshot.root,
 							kind: "outline",
-							chapters: chapters.length,
-							volumes: volumes.length
+							chapters: plan.data.total,
+							volumes: plan.data.volumes
 						}
 					}
 				};
@@ -8386,6 +9069,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");
@@ -8411,6 +9095,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,
@@ -8418,6 +9103,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,
@@ -8461,6 +9149,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,
@@ -8468,7 +9157,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)) });
@@ -8737,6 +9426,53 @@ var EngineService = class {
 			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 (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]");
+					if (!manifest.files.includes("outline/outline.yaml")) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} does not contain ${OUTLINE_FILE}`, "choose a backup created by novel_outline, novel_blueprint or a planning amendment");
+					const text = await context.store.readText(`backups/${input.txid}/${OUTLINE_FILE}`);
+					if (text === null) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} does not contain ${OUTLINE_FILE}`, "the file was created by that transaction, so it has no pre-image to restore");
+					let document;
+					try {
+						document = validateOutlineDocument(parse(text), {
+							titleRule: this.rulepack.format.title,
+							totalChapters: snapshot.project.targets.total_chapters
+						});
+					} 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");
+					}
+					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) {
+						const restoredCard = restoredCards.get(record.num);
+						if (restoredCard?.status !== "archived") throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} would make archived chapter ${record.num} ${restoredCard === void 0 ? "missing its card" : "a planned card"}`, "call novel_reopen before restoring a pre-archive outline, or choose an outline backup that already contains the archived card");
+					}
+					for (const card of document.chapters) if (card.status === "archived" && !archivedNums.has(card.num)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `backup ${input.txid} would restore an archived card for chapter ${card.num}, but that chapter is not archived`, "choose an outline backup that matches the current chapter index, or reopen/archive the chapter first");
+					const files = [{
+						path: OUTLINE_FILE,
+						text
+					}];
+					const prior = await context.store.readText(OUTLINE_FILE);
+					if (prior !== null) files.push({
+						path: OUTLINE_DEPRECATED_FILE,
+						text: prior
+					});
+					const nextPipeline = pipelineWith(snapshot, context.revision, { last_action: action("novel_restore", this.now(), shortDigest(input.txid)) });
+					files.push({
+						path: joinRel(STATE_DIR, STATE_FILES.pipeline),
+						text: yaml(nextPipeline)
+					});
+					return {
+						files,
+						backup: true,
+						data: {
+							txid: input.txid,
+							chapter: snapshot.pipeline.chapter,
+							restored: [OUTLINE_FILE]
+						},
+						warnings: []
+					};
+				}
 				const chapter = input.chapter ?? snapshot.pipeline.chapter;
 				if (snapshot.chapters.chapters.some((record) => record.num === chapter)) throw new EngineInputError(ERROR_CODES.STAGE_ORDER, `chapter ${chapter} is archived; restoring it behind the index would break its content hash`, "call novel_reopen for the chapter, then restore the backup");
 				if (chapter !== snapshot.pipeline.chapter) throw new EngineInputError(ERROR_CODES.STAGE_ORDER, `chapter ${chapter} is not the active chapter ${snapshot.pipeline.chapter}; restore only the active chapter`, "switch the active chapter first, or restore files from the active chapter");
@@ -8848,6 +9584,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;
@@ -8945,6 +9688,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: {},
@@ -8964,6 +9712,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,
@@ -9499,6 +10248,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",
@@ -9518,6 +10282,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",
@@ -10413,7 +11185,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");
@@ -10434,7 +11210,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;
@@ -10497,8 +11279,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) {
@@ -10517,24 +11301,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
@@ -10552,17 +11339,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)
 				};
@@ -10583,7 +11372,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,
@@ -10604,8 +11395,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,
@@ -10616,8 +11407,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 {
@@ -10631,12 +11429,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))
@@ -10665,7 +11463,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({
@@ -10713,7 +11517,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
@@ -10906,8 +11712,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: {
@@ -11190,6 +11999,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);
@@ -11232,10 +12050,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 ?? ""),
@@ -11457,14 +12287,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"
@@ -11963,17 +12793,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}`);
 	}
 	/**
-	* A strict outline cannot silently lose the active chapter's card while the
-	* chapter is still being written. Otherwise a late replacement turns a
-	* strict project non-strict in effect and archive would auto-create the card
-	* the author was required to provide.
+	* `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 replacement, or turn strict mode off with novel_blueprint {\"strict\":false}");
+		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
@@ -12053,6 +12889,7 @@ var EngineService = class {
 		const finished = snapshot.pipeline.stage === "done" && target !== null && archived.length >= target;
 		const draftWords = snapshot.text === null ? 0 : countWordMetrics(snapshot.text).total_word_count;
 		const journal = await readJournal(this.storeFor(snapshot.root));
+		const pending = await inspectPending(this.storeFor(snapshot.root));
 		const journalBlocking = await this.journalBlocking(snapshot);
 		const outline = outlineSummary(snapshot.outline, archived.length, target, archived.map((record) => record.num));
 		const counts = worldbookCounts(snapshot.worldbook);
@@ -12186,7 +13023,12 @@ var EngineService = class {
 			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 ?? ""
+			} }
 		};
 	}
 	/**
@@ -12864,6 +13706,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
 		}));
 	}
@@ -12909,6 +13758,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 ?? snapshot.pipeline.last_action?.op === "novel_revise_summary",
 			review: extras.review ?? snapshot.review,
 			check: extras.check ?? snapshot.check,
 			semantic: extras.semantic ?? [],
@@ -13309,7 +14160,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), {
@@ -13824,7 +14682,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`);
 		}
@@ -13834,6 +14694,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`);
@@ -13923,6 +14798,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) {
@@ -14164,6 +15052,8 @@ function diffLines(before, after) {
 		hunks
 	};
 }
+// src/tools/semantics.ts
+const arraySemanticsDescription = (semantics, description) => `[x-semantics: ${semantics}] ${description}`;
 // src/tools/index.ts
 /**
 * Providers sometimes serialize a free-form `json` parameter as a JSON string
@@ -14182,7 +15072,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;
 };
@@ -14239,10 +15130,11 @@ const jsonOutput = {
 	schema: { type: "json" },
 	render: (_args, raw) => withReplay(text(payload(raw)), raw)
 };
-const stringArray = {
+const stringArray = (semantics, description) => ({
 	type: "array",
-	items: { type: "string" }
-};
+	items: { type: "string" },
+	description: arraySemanticsDescription(semantics, description)
+});
 const root = {
 	type: "string",
 	description: "Project root. Passing it selects this project for the current session and persists the choice. When omitted: session binding -> unique project in the workspace -> single registered project -> configured projectRoot -> error. Multiple projects require an explicit choice."
@@ -14284,7 +15176,8 @@ function createNovelTools(engine, options = {}) {
 				description: { type: "string" },
 				words_per_chapter: {
 					type: "array",
-					items: { type: "integer" }
+					items: { type: "integer" },
+					description: arraySemanticsDescription("replace", "Fixed [min,max] word target for chapters.")
 				},
 				total_chapters: { type: "integer" },
 				premise: {
@@ -14292,11 +15185,11 @@ function createNovelTools(engine, options = {}) {
 					description: "Optional one-sentence premise for the book plan."
 				},
 				logline: { type: "string" },
-				themes: stringArray,
+				themes: stringArray("replace", "Book themes; supplied list replaces the theme list."),
 				tone: { type: "string" },
 				pov: { type: "string" },
 				audience: { type: "string" },
-				selling_points: stringArray,
+				selling_points: stringArray("replace", "Selling points; supplied list replaces the list."),
 				ending: { type: "string" },
 				strict_outline: { type: "boolean" },
 				project_root: initRoot
@@ -14393,10 +15286,16 @@ function createNovelTools(engine, options = {}) {
 					type: "string",
 					required: true
 				},
-				constraints: stringArray,
-				characters: { type: "json" },
-				locations: { type: "json" },
-				continuity_notes: stringArray,
+				constraints: stringArray("replace", "P1 constraints; supplied list replaces the plan list."),
+				characters: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "P1 cast; supplied list replaces the cast.")
+				},
+				locations: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "P1 locations; supplied list replaces them.")
+				},
+				continuity_notes: stringArray("replace", "P1 continuity notes; supplied list replaces them."),
 				project_root: root
 			},
 			output: jsonOutput,
@@ -14428,7 +15327,7 @@ function createNovelTools(engine, options = {}) {
 					required: true
 				},
 				beats: {
-					...stringArray,
+					...stringArray("replace", "Ordered plan beats; supplied list replaces the beats."),
 					required: true
 				},
 				opening: {
@@ -14442,11 +15341,12 @@ function createNovelTools(engine, options = {}) {
 				target_words: {
 					type: "array",
 					items: { type: "integer" },
-					required: true
+					required: true,
+					description: arraySemanticsDescription("replace", "Plan [min,max] word target.")
 				},
 				cast: {
 					type: "json",
-					description: "Optional 1–8 characters on stage this chapter. Each: name, entry_state, goal, knowledge, exit_change. Names must exist in the P1 world plan or the character ledger."
+					description: arraySemanticsDescription("replace", "Optional 1–8 characters on stage this chapter. Each: name, entry_state, goal, knowledge, exit_change. Names must exist in the P1 world plan or the character ledger.")
 				},
 				project_root: root
 			},
@@ -14517,9 +15417,13 @@ function createNovelTools(engine, options = {}) {
 				},
 				dimensions: {
 					type: "json",
-					required: true
+					required: true,
+					description: arraySemanticsDescription("replace", "Fifteen scored dimensions.")
+				},
+				issues: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "Review issue list.")
 				},
-				issues: { type: "json" },
 				total: {
 					type: "integer",
 					required: true,
@@ -14527,7 +15431,8 @@ function createNovelTools(engine, options = {}) {
 				},
 				proof: {
 					type: "json",
-					required: true
+					required: true,
+					description: arraySemanticsDescription("replace", "Three reading-proof quotes.")
 				},
 				project_root: root
 			},
@@ -14557,15 +15462,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: "Updated issue statuses and evidence for PG-08."
+					description: arraySemanticsDescription("replace", "Updated issue statuses and evidence for PG-08.")
 				},
 				proof: {
 					type: "json",
-					required: true,
-					description: "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
 			},
@@ -14588,16 +15495,16 @@ function createNovelTools(engine, options = {}) {
 					type: "integer",
 					required: true
 				},
-				scope: stringArray,
+				scope: stringArray("replace", "Requested check scopes; supplied list replaces the request."),
 				semantic: {
 					type: "json",
 					required: true,
-					description: "Exactly the five P6 semantic items, each with a verbatim evidence quote."
+					description: arraySemanticsDescription("replace", "Exactly the five P6 semantic items, each with a verbatim evidence quote.")
 				},
 				acknowledge: {
 					type: "array",
 					items: { type: "string" },
-					description: "Advisory codes read and accepted; blockers cannot be acknowledged."
+					description: arraySemanticsDescription("replace", "Advisory codes read and accepted; blockers cannot be acknowledged.")
 				},
 				project_root: root
 			},
@@ -14696,7 +15603,7 @@ function createNovelTools(engine, options = {}) {
 				chapter_range: {
 					type: "array",
 					items: { type: "integer" },
-					description: "For kind=chapters: inclusive [start, end] range."
+					description: arraySemanticsDescription("replace", "For kind=chapters: inclusive [start, end] range.")
 				},
 				project_root: root
 			},
@@ -14864,11 +15771,11 @@ function createNovelTools(engine, options = {}) {
 			parameters: {
 				premise: { type: "string" },
 				logline: { type: "string" },
-				themes: stringArray,
+				themes: stringArray("replace", "Book themes; supplied list replaces the theme list."),
 				tone: { type: "string" },
 				pov: { type: "string" },
 				audience: { type: "string" },
-				selling_points: stringArray,
+				selling_points: stringArray("replace", "Selling points; supplied list replaces the list."),
 				ending: { type: "string" },
 				strict: {
 					type: "boolean",
@@ -14876,7 +15783,11 @@ function createNovelTools(engine, options = {}) {
 				},
 				volumes: {
 					type: "json",
-					description: "Volume list: [{title,start_chapter,end_chapter,goal?,arc?,climax?,status?}]. Replaces the current volumes."
+					description: arraySemanticsDescription("replace", "Volume list: [{title,start_chapter,end_chapter,goal?,arc?,climax?,status?}]. Replaces the current volumes; dropping any volume requires confirm_remove:true.")
+				},
+				confirm_remove: {
+					type: "boolean",
+					description: "Explicitly confirm a volume-list replacement that drops existing volumes."
 				},
 				project_root: root
 			},
@@ -14892,12 +15803,13 @@ function createNovelTools(engine, options = {}) {
 				ending: args.ending,
 				strict: args.strict,
 				volumes: asJson(args.volumes, "volumes"),
+				confirm_remove: args.confirm_remove,
 				root: args.project_root
 			}))
 		}),
 		defineTool({
 			name: "novel_outline",
-			description: "Write volume/chapter cards. Archived cards are preserved and cannot be rewritten. On the first submission strict mode defaults on; with an existing card, PG-13 checks title, scene, target words and cast even in non-strict mode.",
+			description: "Upsert volume/chapter cards by key: chapters by num, volumes by title. Omitted cards are preserved; deletion requires remove/remove_volumes. Archived cards are preserved and cannot be rewritten. Use dry_run to preview. On the first submission strict mode defaults on; with an existing card, PG-13 checks title, scene, target words and cast even in non-strict mode.",
 			parameters: {
 				book: {
 					type: "json",
@@ -14905,12 +15817,25 @@ function createNovelTools(engine, options = {}) {
 				},
 				volumes: {
 					type: "json",
-					description: "Optional full volume list; omitted keeps current volumes."
+					description: arraySemanticsDescription("upsert", "Volume list: [{title,start_chapter,end_chapter,goal?,arc?,climax?,status?}]. Upserts by title; omitted volumes are kept.")
 				},
 				chapters: {
 					type: "json",
-					required: true,
-					description: "Chapter cards: [{num,title,scene_type,goal,conflict,hook,cast?,target_words:[min,max],volume?,notes?}]."
+					description: arraySemanticsDescription("upsert", "Chapter cards: [{num,title,scene_type,goal,conflict,hook,cast?,target_words:[min,max],volume?,notes?}]. Upserts by num; omitted cards are kept.")
+				},
+				remove: {
+					type: "array",
+					items: { type: "integer" },
+					description: arraySemanticsDescription("remove", "Explicit chapter numbers to delete.")
+				},
+				remove_volumes: {
+					type: "array",
+					items: { type: "string" },
+					description: arraySemanticsDescription("remove", "Explicit volume titles to delete.")
+				},
+				dry_run: {
+					type: "boolean",
+					description: "Preview changes without writing or journaling."
 				},
 				strict: { type: "boolean" },
 				project_root: root
@@ -14920,6 +15845,9 @@ function createNovelTools(engine, options = {}) {
 				book: asJson(args.book, "book"),
 				volumes: asJson(args.volumes, "volumes"),
 				chapters: asJson(args.chapters, "chapters"),
+				remove: args.remove,
+				remove_volumes: args.remove_volumes,
+				dry_run: args.dry_run,
 				strict: args.strict,
 				root: args.project_root
 			}))
@@ -14958,17 +15886,35 @@ function createNovelTools(engine, options = {}) {
 			parameters: {
 				premise: { type: "string" },
 				setting: { type: "string" },
-				rules: { type: "json" },
-				factions: { type: "json" },
-				locations: { type: "json" },
-				characters: { type: "json" },
-				glossary: { type: "json" },
-				backstory: { type: "json" },
+				rules: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "Rules section list.")
+				},
+				factions: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "Factions section list.")
+				},
+				locations: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "Locations section list.")
+				},
+				characters: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "Characters section list.")
+				},
+				glossary: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "Glossary section list.")
+				},
+				backstory: {
+					type: "json",
+					description: arraySemanticsDescription("replace", "Backstory section list.")
+				},
 				facts: {
 					type: "json",
-					description: "Declared numeric canon: [{alias,value,unit,tolerance?,note?}]."
+					description: arraySemanticsDescription("replace", "Declared numeric canon: [{alias,value,unit,tolerance?,note?}].")
 				},
-				themes: stringArray,
+				themes: stringArray("replace", "Worldbook themes; supplied list replaces the list."),
 				project_root: root
 			},
 			output: jsonOutput,
@@ -15060,7 +16006,7 @@ function createNovelTools(engine, options = {}) {
 		}),
 		defineTool({
 			name: "novel_restore",
-			description: "Restore an active chapter file 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, 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.",
 			parameters: {
 				txid: {
 					type: "string",
@@ -15070,7 +16016,7 @@ function createNovelTools(engine, options = {}) {
 				paths: {
 					type: "array",
 					items: { type: "string" },
-					description: "Project-relative chapter files; omitted restores every restorable chapter file that the backup manifest records."
+					description: arraySemanticsDescription("replace", "Project-relative chapter files, or exactly [outline/outline.yaml]; omitted restores every restorable chapter file the manifest records.")
 				},
 				project_root: root
 			},
@@ -15228,7 +16174,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({});
@@ -15818,6 +16769,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`);
@@ -16153,4 +17217,4 @@ function connectionFence(scope) {
 	}
 	if (Object.prototype.hasOwnProperty.call(candidate, "connection")) return candidate.connection;
 }
-export { ARCHIVE_DIGESTS_FILE, BACKUP_DIR, BRIEF_RECEIPTS_FILE, BriefLibrary, CHAPTERS_DIR, CHECK_DIR, CORE_TOOLS, Config, DEFAULT_GENRE, DEFAULT_PLATFORM, ERROR_CODES, EXPORT_DIR, EngineBlockedError, EngineError, EngineFaultError, EngineInputError, EngineService, GENRES, HISTORY_DIR, HISTORY_KINDS, INITIAL_STAGE, LIMITS, LOCK_FILE, METADATA_LOCK_FILE, OPERATIONS, OUTLINE_DIR, OUTLINE_FILE, PANEL_CHAPTER_LIMIT, PANEL_ID, PANEL_ROUTE, PHASE_STRIP, PLAN_DIR, PLATFORMS, PLUGIN_NAME, PROJECT_FILE, REGISTRY_FILE, REMOTE_VERSION, REVIEW_DIR, SCENE_TYPES, SCENE_TYPE_DEFAULT, SCHEMA_VERSION, SESSION_BINDINGS_FILE, SKILL_NAME, STAGING_DIR, STATE_DIR, STATE_FILES, TOOL_NAMES, WORLDBOOK_FILE, applicableGates, apply, blockedError, briefStageFor, chapterFile, chapterHeading, chapterHistoryFile, checkFile, checkHistoryFile, deprecatedChapterFile, deprecatedHistoryFile, evaluateGates, faultError, formatResumePrompt, gateName, inject, inputError, loadRulepack, name, parseParagraphLocation, phaseStrip, planChapterFile, planHistoryFile, planWorldFile, projectChapter, projectChapters, projectGates, projectSummary, renderBlurb, renderCover, renderEpubChapter, renderMarkdown, renderPlainText, renderProposal, reviewFile, reviewHistoryFile, verifyReference };
+export { ARCHIVE_DIGESTS_FILE, BACKUP_DIR, BRIEF_RECEIPTS_FILE, BriefLibrary, CHAPTERS_DIR, CHECK_DIR, CORE_TOOLS, Config, DEFAULT_GENRE, DEFAULT_PLATFORM, ERROR_CODES, EXPORT_DIR, EngineBlockedError, EngineError, EngineFaultError, EngineInputError, EngineService, GENRES, HISTORY_DIR, HISTORY_KINDS, INITIAL_STAGE, LIMITS, LOCK_FILE, METADATA_LOCK_FILE, OPERATIONS, OUTLINE_DEPRECATED_FILE, OUTLINE_DIR, OUTLINE_FILE, PANEL_CHAPTER_LIMIT, PANEL_ID, PANEL_ROUTE, PHASE_STRIP, PLAN_DIR, PLATFORMS, PLUGIN_NAME, PROJECT_FILE, REGISTRY_FILE, REMOTE_VERSION, REVIEW_DIR, SCENE_TYPES, SCENE_TYPE_DEFAULT, SCHEMA_VERSION, SESSION_BINDINGS_FILE, SKILL_NAME, STAGING_DIR, STATE_DIR, STATE_FILES, TOOL_NAMES, WORLDBOOK_FILE, applicableGates, apply, blockedError, briefStageFor, chapterFile, chapterHeading, chapterHistoryFile, checkFile, checkHistoryFile, deprecatedChapterFile, deprecatedHistoryFile, evaluateGates, faultError, formatResumePrompt, gateName, inject, inputError, loadRulepack, name, parseParagraphLocation, phaseStrip, planChapterFile, planHistoryFile, planWorldFile, projectChapter, projectChapters, projectGates, projectSummary, renderBlurb, renderCover, renderEpubChapter, renderMarkdown, renderPlainText, renderProposal, reviewFile, reviewHistoryFile, verifyReference };