dsh-novel-write-engine 0.2.7 → 0.2.9

package/lib/index.js

@@ -15,6 +15,8 @@ const PANEL_ID = "novel-workshop";
 const PANEL_ROUTE = "/api/novel-write-engine/panel";
 const SKILL_NAME = "novel-write-engine";
 const REMOTE_VERSION = 6;
+/** User-visible panel/tutorial version; keep in sync with package.json. */
+const PANEL_VERSION = "0.2.9";
 /** The panel is a recent-history view; the wire payload and UI use one cap. */
 const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */
@@ -308,6 +310,33 @@ function allocateIds(prefix, nextSeq, count) {
 		nextSeq: nextSeq + count
 	};
 }
+// src/domain/narrator.ts
+/**
+* One narrator-alias contract shared by PG-05, state_delta and lock capture.
+*
+* The plan format is `角色名（第一人称）` or `角色名（第一人称「我」）`. A
+* first-person manuscript says 「我」 instead of repeating the character name;
+* every consumer must accept that alias, and none may infer it from a bare
+* substring such as "林" inside "林砚".
+*/
+const narratorName = (narrator) => narrator.split(/[（(]/, 1)[0].trim();
+/** The only documented first-person alias is the pronoun itself. */
+const narratorAliases = (narrator) => isFirstPersonNarrator(narrator) ? ["我"] : [];
+/** Whether the plan declares first-person narration. */
+const isFirstPersonNarrator = (narrator) => narrator.includes("第一人称") && !narrator.includes("第三人称");
+/**
+* True when `name` is the declared narrator and the manuscript uses the
+* declared first-person alias. A name that merely contains the narrator name
+* is not an alias.
+*/
+const isNarratorAlias = (name, narrator, text) => {
+	if (text.includes(name)) return true;
+	if (narratorName(narrator) !== name) return false;
+	if (!isFirstPersonNarrator(narrator)) return false;
+	return narratorAliases(narrator).some((alias) => text.includes(alias));
+};
+/** Paragraph used for a newly locked character; prefers the named/aliased one. */
+const narratorAliasesFor = (name, narrator) => name === narratorName(narrator) ? narratorAliases(narrator) : [];
 // src/domain/scoring.ts
 /** The fifteen dimensions, grouped as the commercial weights demand. */
 const SCORE_DIMENSIONS = [
@@ -1122,7 +1151,7 @@ const dashBudget = (ctx) => {
 	return [v(PUNCTUATION_RULES.DASH_BUDGET, "advisory", firstParagraphContaining(ctx.text, token), `dash weight ${weighted} (dialogue ${inDialogue}x double), budget is ${scaled} for ${ctx.sceneType}`)];
 };
 const periodDensity = (ctx) => {
-	const { min, max } = ctx.rulepack.punctuation.period_density;
+	const { min, max } = ctx.rulepack.genres[ctx.genre]?.profile?.period_density ?? ctx.rulepack.punctuation.period_density;
 	const dominant = ctx.rulepack.punctuation.dialogue_dominant_ratio;
 	const results = [];
 	splitParagraphs(ctx.text).forEach((paragraph, index) => {
@@ -1355,10 +1384,11 @@ const numericFactMismatch = (ctx) => {
 	for (const fact of ctx.facts) {
 		if (fact.alias.trim() === "" || !Number.isFinite(fact.value)) continue;
 		const tolerance = fact.tolerance ?? 0;
-		const pattern = new RegExp(`${escapePattern(fact.alias)}\\s*(?:是|为|约|有|：|:)?\\s*(${NUMBER_TOKEN})\\s*${escapePattern(fact.unit)}`, "g");
+		const pattern = new RegExp(`${escapePattern(fact.alias)}\\s*(?:是|为|约|有|：|:)?\\s*(${NUMBER_TOKEN})\\s*${escapePattern(fact.unit)}(?:\\s*([零一二两三四五六七八九]))?(?![零一二两三四五六七八九十百千万\\d])`, "g");
 		for (const match of ctx.text.matchAll(pattern)) {
-			const value = parseSmallNumber(match[1] ?? "");
-			if (value === null) continue;
+			const base = parseSmallNumber(match[1] ?? "");
+			if (base === null) continue;
+			const value = base + (match[2] === void 0 ? 0 : (CN_DIGITS[match[2]] ?? 0) / 10);
 			if (Math.abs(value - fact.value) <= tolerance) continue;
 			const paragraph = paragraphs.findIndex((candidate) => candidate.includes(match[0]));
 			results.push(v(SEMANTIC_RULES.NUMERIC_FACT_MISMATCH, "advisory", Math.max(1, paragraph + 1), `"${fact.alias}" declares ${fact.value}${fact.unit}, text shows ${value}${fact.unit}`));
@@ -1368,7 +1398,8 @@ const numericFactMismatch = (ctx) => {
 	return results;
 };
 const pleasureDensity = (ctx) => {
-	const { min, keywords, window } = ctx.rulepack.semantics.pleasure_density;
+	const { keywords, window } = ctx.rulepack.semantics.pleasure_density;
+	const min = ctx.rulepack.genres[ctx.genre]?.profile?.pleasure_density ?? ctx.rulepack.semantics.pleasure_density.min;
 	if (keywords.length === 0) return [];
 	const results = [];
 	if (slidingWindows(ctx.text, window).findIndex((slice) => {
@@ -1385,8 +1416,9 @@ const sensoryDensity = (ctx) => {
 };
 const waterWords = (ctx) => {
 	const { window, threshold, terms, scene_thresholds } = ctx.rulepack.semantics.water_words;
+	const genreThreshold = ctx.rulepack.genres[ctx.genre]?.profile?.water_words;
 	if (terms.length === 0) return [];
-	const sceneThreshold = scene_thresholds?.[ctx.sceneType] ?? threshold;
+	const sceneThreshold = genreThreshold ?? scene_thresholds?.[ctx.sceneType] ?? threshold;
 	const results = [];
 	for (const slice of slidingWindows(ctx.text, window)) {
 		const density = terms.reduce((total, term) => total + countOccurrences(slice, term), 0) / window;
@@ -1554,25 +1586,24 @@ const resourceMismatch = (ctx) => {
 				resourceVisible = !(previousHasNumber && previousHasSign) && previousClauseText.includes(change.resource);
 			}
 			if (!resourceVisible) continue;
-			const names = ctx.summary?.characters_appeared ?? [];
-			const otherCharacter = names.some((name) => name !== "" && name !== change.character && clauseText.includes(name));
-			let characterVisible = clauseText.includes(change.character);
-			if (!characterVisible && !otherCharacter) characterVisible = previousClauseText.includes(change.character);
+			const names = [...ctx.summary?.characters_appeared ?? [], ...ctx.evidence.characters?.characters.map((character) => character.name) ?? []];
+			const otherCharacter = mentionedNames$1(clauseText, names.filter((name) => name !== "" && name !== change.character)).length > 0;
+			let characterVisible = mentionedNames$1(clauseText, [change.character]).length > 0 || !otherCharacter && mentionedNames$1(ctx.text.slice(sentence.start, sentence.end), [change.character]).length > 0;
+			if (!characterVisible && !otherCharacter) characterVisible = mentionedNames$1(previousClauseText, [change.character]).length > 0;
 			if (!characterVisible && !otherCharacter && sentence.start > 0) {
 				const previous = sentenceBounds(ctx.text, sentence.start - 1, sentence.start - 1);
 				const previousText = ctx.text.slice(previous.start, previous.end);
-				const named = names.filter((name) => previousText.includes(name));
+				const named = mentionedNames$1(previousText, names);
 				characterVisible = /(?:他|她|它|我|他们|她们)/.test(clauseText) && named.length === 1 && named[0] === change.character;
 			}
 			if (!characterVisible) continue;
 			conflict = {
 				index,
-				amount: match[1] ?? "",
-				sign: sign[0]
+				trigger: sign[0]
 			};
 			break;
 		}
-		return conflict === null ? [] : [v(CROSS_RULES.RESOURCE_MISMATCH, "advisory", paragraphOfIndex(ctx.text, conflict.index), `${change.character}'s ${change.resource} change is ${change.delta >= 0 ? "+" : ""}${change.delta}, but the text states the opposite sign "${conflict.sign}" near amount ${conflict.amount}`)];
+		return conflict === null ? [] : [v(CROSS_RULES.RESOURCE_MISMATCH, "advisory", paragraphOfIndex(ctx.text, conflict.index), `${change.character}'s ${change.resource} change is ${change.delta >= 0 ? "+" : ""}${change.delta}, but the text states the opposite-sign trigger "${conflict.trigger}"`)];
 	});
 };
 const timeRegression = (ctx) => {
@@ -1596,6 +1627,31 @@ const timeRegression = (ctx) => {
 	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}`)];
 };
+const mentionedNames$1 = (text, names) => {
+	const found = [];
+	for (const name of names) {
+		if (name === "") continue;
+		let index = text.indexOf(name);
+		let present = false;
+		while (index >= 0) {
+			if (!names.some((other) => {
+				if (other.length <= name.length || !other.includes(name)) return false;
+				let otherIndex = text.indexOf(other);
+				while (otherIndex >= 0) {
+					if (index >= otherIndex && index + name.length <= otherIndex + other.length) return true;
+					otherIndex = text.indexOf(other, otherIndex + 1);
+				}
+				return false;
+			})) {
+				present = true;
+				break;
+			}
+			index = text.indexOf(name, index + name.length);
+		}
+		if (present) found.push(name);
+	}
+	return found;
+};
 const relationUnknown = (ctx) => {
 	const characters = ctx.evidence.characters;
 	const known = characters === null ? [] : characters.characters.map((character) => character.name);
@@ -1607,7 +1663,7 @@ const relationUnknown = (ctx) => {
 	if (names.size < 2) return [];
 	const results = [];
 	for (const [index, paragraph] of splitParagraphs(ctx.text).entries()) {
-		const present = [...names].filter((name) => paragraph.includes(name));
+		const present = mentionedNames$1(paragraph, [...names]);
 		for (let first = 0; first < present.length; first += 1) for (let second = first + 1; second < present.length; second += 1) {
 			const a = present[first];
 			const b = present[second];
@@ -1616,7 +1672,7 @@ const relationUnknown = (ctx) => {
 	}
 	return results;
 };
-const lastDescribedMention = (name, locked, text, order) => {
+const describedMentions = (name, locked, text) => {
 	const candidates = [];
 	const strippedLock = locked.split(name).join("");
 	for (const [index, paragraph] of splitParagraphs(text).entries()) {
@@ -1632,9 +1688,9 @@ const lastDescribedMention = (name, locked, text, order) => {
 			coverage
 		});
 	}
-	if (candidates.length === 0) return null;
-	return order === "first" ? candidates[0] : candidates[candidates.length - 1];
+	return candidates;
 };
+const bestMention = (mentions) => mentions.reduce((best, mention) => best === null || mention.coverage > best.coverage ? mention : best, null);
 const lockedDetailDrift = (ctx) => {
 	if (ctx.evidence.locks === null) return [];
 	const locks = ctx.evidence.locks;
@@ -1642,16 +1698,16 @@ const lockedDetailDrift = (ctx) => {
 	for (const [name, lock] of Object.entries(locks.locations)) {
 		if (!ctx.text.includes(name)) continue;
 		if (lock.layout.trim() === "") continue;
-		const mention = lastDescribedMention(name, lock.layout, ctx.text, "last");
+		const mention = bestMention(describedMentions(name, lock.layout, ctx.text));
 		if (mention === null) continue;
 		if (mention.coverage < ctx.rulepack.crosschapter.lock_similarity) results.push(v(CROSS_RULES.LOCKED_DETAIL_DRIFT, "advisory", mention.index + 1, `${name} is described differently from its locked layout; expected "${lock.layout.slice(0, 40)}", actual "${mention.text.slice(0, 60)}"`));
 	}
 	for (const [name, lock] of Object.entries(locks.characters)) {
 		if (!ctx.text.includes(name)) continue;
 		if (lock.appearance.trim() === "") continue;
-		const mention = lastDescribedMention(name, lock.appearance, ctx.text, "first");
+		const mention = bestMention(describedMentions(name, lock.appearance, ctx.text));
 		if (mention === null) continue;
-		if (mention.coverage < ctx.rulepack.crosschapter.lock_similarity) results.push(v(CROSS_RULES.LOCKED_DETAIL_DRIFT, "advisory", mention.index + 1, `${name} is described differently from the locked first appearance; expected "${lock.appearance.slice(0, 40)}", actual "${mention.text.slice(0, 60)}"`));
+		if (mention.coverage < ctx.rulepack.crosschapter.lock_similarity) results.push(v(CROSS_RULES.LOCKED_DETAIL_DRIFT, "advisory", mention.index + 1, `${name} is described differently from its locked appearance; expected "${lock.appearance.slice(0, 40)}", actual "${mention.text.slice(0, 60)}"`));
 	}
 	return results;
 };
@@ -2138,6 +2194,23 @@ const validateSummary = (kind, value, path) => {
 	numberAt(kind, summary.hook_strength, `${path}.hook_strength`);
 	stringAt(kind, summary.plot_advancement, `${path}.plot_advancement`);
 };
+const validateArchivedCard = (kind, value, path) => {
+	if (value === void 0) return;
+	const card = objectAt(kind, value, path);
+	stringAt(kind, card.title, `${path}.title`);
+	stringAt(kind, card.scene_type, `${path}.scene_type`);
+	const target = listAt(kind, card.target_words, `${path}.target_words`);
+	if (target.length !== 2) invalid$2(kind, `${path}.target_words must contain two numbers`);
+	for (const [index, item] of target.entries()) numberAt(kind, item, `${path}.target_words[${index}]`);
+	for (const [index, item] of listAt(kind, card.cast, `${path}.cast`).entries()) stringAt(kind, item, `${path}.cast[${index}]`);
+	for (const key of [
+		"goal",
+		"conflict",
+		"hook",
+		"notes"
+	]) stringAt(kind, card[key], `${path}.${key}`);
+	nullableString(kind, card.archived_at, `${path}.archived_at`);
+};
 const validateNested = (kind, record) => {
 	switch (kind) {
 		case "project": {
@@ -2186,6 +2259,8 @@ const validateNested = (kind, record) => {
 				validateSummary(kind, row.summary, `${path}.summary`);
 				if (row.assigned_ids !== void 0) objectAt(kind, row.assigned_ids, `${path}.assigned_ids`);
 				optionalString(kind, row.archive_digest, `${path}.archive_digest`);
+				optionalString(kind, row.archive_card_digest, `${path}.archive_card_digest`);
+				validateArchivedCard(kind, row.archive_card, `${path}.archive_card`);
 				optionalString(kind, row.final_check, `${path}.final_check`);
 				optionalString(kind, row.archived_at, `${path}.archived_at`);
 				if (row.rounds !== void 0) {
@@ -2528,7 +2603,13 @@ var FsStore = class {
 	/** Absolute path of an internal file outside the project root (locks live at root). */
 	async ensureDir(relativePath) {
 		const absolute = await this.safePath(relativePath);
-		await promises.mkdir(absolute, { recursive: true });
+		await this.ensureParent(absolute);
+		try {
+			await promises.mkdir(absolute);
+		} catch (error) {
+			if (error.code !== "EEXIST") throw ioFailure(error);
+			if (!(await promises.lstat(absolute)).isDirectory()) throw new EngineFaultError(ERROR_CODES.IO_PERMISSION, `refusing to use "${relativePath}": it exists but is not a directory`, "remove or rename the conflicting file, then retry");
+		}
 		return absolute;
 	}
 	async exists(relativePath) {
@@ -3163,13 +3244,23 @@ var FileLock = class {
 		if (record === null) {
 			if (Date.now() - mtimeMs <= this.staleMs) return false;
 		} else if (lockRecordIsLive(record)) return false;
-		const claimPath = `${this.absolutePath}.reclaim-${randomUUID()}`;
+		const claimPath = `${this.absolutePath}.reclaim`;
 		let claimByRename = false;
 		try {
 			await promises.link(this.absolutePath, claimPath);
 		} catch (error) {
 			const code = error.code;
 			if (code === "ENOENT") return true;
+			if (code === "EEXIST") {
+				const claimMtime = await promises.stat(claimPath).then((info) => {
+					return info.nlink > 1 ? info.ctimeMs : info.mtimeMs;
+				}).catch(() => Date.now());
+				if (Date.now() - claimMtime > this.staleMs) {
+					await promises.rm(claimPath, { force: true }).catch(() => void 0);
+					return true;
+				}
+				return false;
+			}
 			if (code === "EPERM" || code === "EACCES") return false;
 			if ([
 				"ENOSYS",
@@ -3218,7 +3309,9 @@ const BACKUP_MANIFEST = "manifest.json";
 /** Backup transaction directories, newest first by filesystem mtime. */
 async function listBackups(store) {
 	const entries = [];
-	for (const name of await store.list(BACKUP_DIR)) {
+	for (const entry of await store.entries(BACKUP_DIR)) {
+		if (!entry.directory || entry.symbolicLink) continue;
+		const name = entry.name;
 		if (name === "migrations") continue;
 		const info = await store.stat(joinRel(BACKUP_DIR, name));
 		if (info === null || !info.isDirectory) continue;
@@ -3379,6 +3472,7 @@ async function runTransaction(store, input) {
 		for (const file of input.files) {
 			const existing = before.get(file.path);
 			if (existing === null || existing === void 0) continue;
+			await assertRootPresent();
 			await store.writeBytes(joinRel(staging, "before", file.path), existing);
 		}
 		if (input.backup) {
@@ -3386,8 +3480,10 @@ async function runTransaction(store, input) {
 			for (const file of input.files) {
 				const existing = before.get(file.path);
 				if (existing === null || existing === void 0) continue;
+				await assertRootPresent();
 				await store.writeBytes(joinRel(stagingBackup, file.path), existing);
 			}
+			await assertRootPresent();
 			await store.writeText(joinRel(stagingBackup, BACKUP_MARKER), "1");
 			await store.writeText(joinRel(stagingBackup, BACKUP_MANIFEST), `${JSON.stringify({
 				schema_version: 1,
@@ -3399,9 +3495,11 @@ async function runTransaction(store, input) {
 				...input.reason === void 0 ? {} : { reason: input.reason },
 				files: input.files.filter((file) => before.get(file.path) !== null && before.get(file.path) !== void 0).map((file) => file.path)
 			}, null, 2)}\n`);
-			const targetBackup = store.path(backupDir(input.txid));
-			await promises.mkdir(dirname(targetBackup), { recursive: true });
-			await promises.rename(store.path(stagingBackup), targetBackup);
+			await assertRootPresent();
+			await store.ensureDir(BACKUP_DIR);
+			await assertRootPresent();
+			const targetBackup = await store.safePath(backupDir(input.txid));
+			await promises.rename(await store.safePath(stagingBackup), targetBackup);
 			await syncDirectory(dirname(targetBackup));
 			backupMarked = true;
 			backupComplete = true;
@@ -4124,7 +4222,7 @@ function outlineSummary(document, archivedCount, target = null, archivedNumbers)
 		missingCards,
 		plannedCoverage,
 		archivedCoverage,
-		coverage: plannedCoverage ?? (archivedDenominator === 0 ? 0 : cardCoverage),
+		coverage: plannedCoverage ?? cardCoverage,
 		cardCoverage,
 		volumes: document.volumes.length
 	};
@@ -4305,12 +4403,38 @@ function normalizeOutlineChapters(input, options) {
 			if (target[0] !== base.target_words[0] || target[1] !== base.target_words[1]) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} is archived; its target_words cannot change`, "call novel_reopen first if the manuscript must be revised");
 			const cast = raw.cast === void 0 ? base.cast : stringArray$1(raw.cast, `chapters[${index}].cast`, 8);
 			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");
+			const goal = raw.goal === void 0 || raw.goal === base.goal ? base.goal : text$2(raw.goal, `chapter ${num} goal`);
+			const conflict = raw.conflict === void 0 || raw.conflict === base.conflict ? base.conflict : text$2(raw.conflict, `chapter ${num} conflict`);
+			const hook = raw.hook === void 0 || raw.hook === base.hook ? base.hook : text$2(raw.hook, `chapter ${num} hook`);
+			const notes = raw.notes === void 0 || raw.notes === base.notes ? base.notes : optionalText(raw.notes, `chapter ${num} notes`, LIMITS.maxOutlineNotesChars);
+			for (const [field, value, previous] of [
+				[
+					"goal",
+					goal,
+					base.goal
+				],
+				[
+					"conflict",
+					conflict,
+					base.conflict
+				],
+				[
+					"hook",
+					hook,
+					base.hook
+				],
+				[
+					"notes",
+					notes,
+					base.notes
+				]
+			]) if (value !== previous) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `chapter ${num} is archived; its ${field} 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$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),
+				goal,
+				conflict,
+				hook,
+				notes,
 				volume: volumeForChapter(options.volumes, num, raw.volume === void 0 ? base.volume : raw.volume),
 				status: "archived",
 				archived_at: base.archived_at ?? record.archived_at ?? null,
@@ -4718,7 +4842,7 @@ const pick = (values, mentioned, key, limit) => {
 	return [...matched, ...rest].slice(0, limit);
 };
 /** Protect the brief budget from a legal-but-huge planning document. */
-const clip = (value, limit) => {
+const clip$1 = (value, limit) => {
 	const chars = Array.from(value);
 	return chars.length <= limit ? value : `${chars.slice(0, limit).join("")}…`;
 };
@@ -4727,44 +4851,44 @@ function worldbookBrief(document, mentioned, names) {
 	const named = names.join("\n");
 	const characters = pick(document.characters, named === "" ? mentioned : named, (entry) => entry.name, 8);
 	return {
-		premise: clip(document.premise, 600),
-		setting: clip(document.setting, 600),
-		themes: document.themes.slice(0, 12).map((theme) => clip(theme, 80)),
+		premise: clip$1(document.premise, 600),
+		setting: clip$1(document.setting, 600),
+		themes: document.themes.slice(0, 12).map((theme) => clip$1(theme, 80)),
 		characters: characters.map((entry) => ({
 			name: entry.name,
 			role: entry.role,
-			description: clip(entry.description, 240),
-			arc: clip(entry.arc, 160)
+			description: clip$1(entry.description, 240),
+			arc: clip$1(entry.arc, 160)
 		})),
 		locations: pick(document.locations, mentioned, (entry) => entry.name, 6).map((entry) => ({
 			name: entry.name,
-			description: clip(entry.description, 240),
-			layout: clip(entry.layout, 120),
+			description: clip$1(entry.description, 240),
+			layout: clip$1(entry.layout, 120),
 			capacity: entry.capacity
 		})),
 		factions: pick(document.factions, mentioned, (entry) => entry.name, 6).map((entry) => ({
 			name: entry.name,
-			description: clip(entry.description, 240),
-			goal: clip(entry.goal, 120)
+			description: clip$1(entry.description, 240),
+			goal: clip$1(entry.goal, 120)
 		})),
 		rules: pick(document.rules, mentioned, (entry) => entry.name, 6).map((entry) => ({
 			name: entry.name,
-			description: clip(entry.description, 240)
+			description: clip$1(entry.description, 240)
 		})),
 		glossary: pick(document.glossary, mentioned, (entry) => entry.term, 6).map((entry) => ({
 			term: entry.term,
-			definition: clip(entry.definition, 160)
+			definition: clip$1(entry.definition, 160)
 		})),
 		backstory: document.backstory.slice(0, 3).map((entry) => ({
 			time: entry.time,
-			event: clip(entry.event, 160)
+			event: clip$1(entry.event, 160)
 		})),
 		facts: (document.facts ?? []).slice(0, 20).map((fact) => ({
-			alias: clip(fact.alias, 120),
+			alias: clip$1(fact.alias, 120),
 			value: fact.value,
-			unit: clip(fact.unit, 40),
+			unit: clip$1(fact.unit, 40),
 			tolerance: fact.tolerance ?? 0,
-			...fact.note === void 0 ? {} : { note: clip(fact.note, 160) }
+			...fact.note === void 0 ? {} : { note: clip$1(fact.note, 160) }
 		}))
 	};
 }
@@ -4772,14 +4896,14 @@ function worldbookBrief(document, mentioned, names) {
 function bookBrief(document, chapter) {
 	const volume = document.volumes.find((candidate) => chapter >= candidate.start_chapter && chapter <= candidate.end_chapter) ?? null;
 	return {
-		premise: clip(document.book.premise, 600),
-		logline: clip(document.book.logline, 600),
-		themes: document.book.themes.slice(0, 12).map((theme) => clip(theme, 80)),
-		tone: clip(document.book.tone, 200),
-		pov: clip(document.book.pov, 200),
-		audience: clip(document.book.audience, 200),
-		selling_points: document.book.selling_points.slice(0, 12).map((point) => clip(point, 120)),
-		ending: clip(document.book.ending, 400),
+		premise: clip$1(document.book.premise, 600),
+		logline: clip$1(document.book.logline, 600),
+		themes: document.book.themes.slice(0, 12).map((theme) => clip$1(theme, 80)),
+		tone: clip$1(document.book.tone, 200),
+		pov: clip$1(document.book.pov, 200),
+		audience: clip$1(document.book.audience, 200),
+		selling_points: document.book.selling_points.slice(0, 12).map((point) => clip$1(point, 120)),
+		ending: clip$1(document.book.ending, 400),
 		strict: document.book.strict,
 		volume,
 		card: outlineCard(document, chapter)
@@ -4853,9 +4977,11 @@ function parseOutlineMarkdown(content) {
 		if (currentVolume === null) return;
 		const volume = currentVolume;
 		const chapters = chapterInputs.filter((card) => card.volume === volume.order);
-		if (chapters.length > 0) {
+		if (chapters.length > 0 && !volume.explicitRange) {
 			volume.start_chapter = Math.min(volume.start_chapter, ...chapters.map((card) => card.num));
 			volume.end_chapter = Math.max(volume.end_chapter, ...chapters.map((card) => card.num));
+		} else if (chapters.length > 0) {
+			for (const card of chapters) if (card.num < volume.start_chapter || card.num > volume.end_chapter) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `Markdown volume "${volume.title}" declares 第${volume.start_chapter}-${volume.end_chapter}章 but contains chapter ${card.num}`, "fix the declared range or move the card into the right volume");
 		} else if (!volume.explicitRange) {
 			warnings.push(`volume "${volume.title}" has neither a chapter range nor chapter cards; it was ignored`);
 			volumeInputs.pop();
@@ -5138,6 +5264,7 @@ const mergeVolumes = (options) => {
 		}
 	}
 	const byTitle = volumeByTitle(options.existingVolumes);
+	const byId = new Map(options.existingVolumes.map((volume) => [volume.id, volume]));
 	const usedIds = new Set(options.existingVolumes.map((volume) => volume.id));
 	let nextGeneratedId = 1;
 	const generatedId = () => {
@@ -5148,21 +5275,39 @@ const mergeVolumes = (options) => {
 		return id;
 	};
 	const submitted = /* @__PURE__ */ new Set();
+	const submittedIds = /* @__PURE__ */ new Set();
+	const generatedIds = /* @__PURE__ */ new Set();
 	for (const [index, raw] of (options.volumes ?? []).entries()) {
 		if (!isRecord$2(raw)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes[${index}] must be an object`);
 		const title = text$1(raw.title, `volumes[${index}].title`);
 		if (submitted.has(title)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes contains duplicate title "${title}"`);
 		submitted.add(title);
-		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 (explicitId !== void 0 && (submittedIds.has(explicitId) || generatedIds.has(explicitId))) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volumes contains duplicate id "${explicitId}"`);
+		if (explicitId !== void 0) submittedIds.add(explicitId);
+		const byIdBase = explicitId === void 0 ? void 0 : byId.get(explicitId);
+		const titleBase = byTitle.get(title);
+		if (explicitId !== void 0 && byIdBase === void 0 && usedIds.has(explicitId)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volume id "${explicitId}" already belongs to another volume`);
+		if (explicitId !== void 0 && titleBase !== void 0 && titleBase.id !== explicitId) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volume "${title}" cannot change its stable id from "${titleBase.id}" to "${explicitId}"`);
+		const base = byIdBase ?? titleBase;
+		let id;
+		if (base !== void 0) id = base.id;
+		else if (explicitId !== void 0) id = explicitId;
+		else {
+			id = generatedId();
+			generatedIds.add(id);
+		}
+		if (base !== void 0 && explicitId !== void 0 && base.id !== explicitId) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volume "${base.title}" cannot change its stable id from "${base.id}" to "${explicitId}"`);
+		if (base !== void 0 && base.title !== title) byTitle.delete(base.title);
 		if (!usedIds.has(id)) usedIds.add(id);
-		byTitle.set(title, {
+		const next = {
 			...base ?? {},
 			...raw,
 			id,
 			title
-		});
+		};
+		byTitle.set(title, next);
+		byId.set(id, next);
 	}
 	for (const title of removed) {
 		if (submitted.has(title)) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `volume "${title}" cannot be both submitted and removed`);
@@ -5170,6 +5315,7 @@ const mergeVolumes = (options) => {
 		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);
+		byId.delete(existing.id);
 	}
 	const volumes = normalizeVolumes([...byTitle.values()], { totalChapters: options.totalChapters });
 	const before = volumeByTitle(options.existingVolumes);
@@ -5485,9 +5631,10 @@ const requireForeshadowFields = (value, where) => {
 	if (value.note !== void 0 && typeof value.note !== "string") fail$1(`${where}.note must be a string`);
 	if (value.new_info !== void 0 && typeof value.new_info !== "boolean") fail$1(`${where}.new_info must be a boolean`);
 };
+const withoutQuotedSpeech = (text) => text.replace(/"[^"]*"|“[^”]*”|「[^」]*」|『[^』]*』/g, "");
 const appearanceOf = (text, name, aliases = []) => {
 	const paragraphs = splitParagraphs(text);
-	const source = paragraphs.find((paragraph) => paragraph.includes(name) || aliases.some((alias) => alias !== "" && paragraph.includes(alias))) ?? paragraphs[0] ?? "";
+	const source = paragraphs.find((paragraph) => withoutQuotedSpeech(paragraph).includes(name)) ?? paragraphs.find((paragraph) => paragraph.includes(name)) ?? paragraphs.find((paragraph) => aliases.some((alias) => alias !== "" && withoutQuotedSpeech(paragraph).includes(alias))) ?? paragraphs[0] ?? "";
 	return Array.from(source).slice(0, 120).join("");
 };
 const named = (value) => isRecord(value) && typeof value.name === "string";
@@ -5578,12 +5725,8 @@ function applyStateDelta(input) {
 	const appeared = [...new Set(summary.characters_appeared)];
 	const byName = new Map(characters.characters.map((character) => [character.name, character]));
 	const narrator = input.narrator ?? "";
-	const narratorName = narrator.split(/[（(]/, 1)[0].trim();
-	const narratorAliases = [...narrator.matchAll(/[「『"]([^」』"]+)[」』"]/g)].map((match) => match[1].trim());
-	const appearsInManuscript = (name) => {
-		if (input.text.includes(name)) return true;
-		return name === narratorName && narratorAliases.some((alias) => alias !== "" && input.text.includes(alias));
-	};
+	const narratorName$1 = narratorName(narrator);
+	const appearsInManuscript = (name) => isNarratorAlias(name, narrator, input.text);
 	for (const name of appeared) {
 		if (!appearsInManuscript(name)) fail$1(`character "${name}" is listed in characters_appeared but does not appear in the manuscript`);
 		if (!Object.hasOwn(delta.characters, name)) fail$1(`character "${name}" appeared in the chapter but is not declared in characters`);
@@ -5605,16 +5748,20 @@ function applyStateDelta(input) {
 			if (existing !== void 0) fail$1(`character "${name}" already exists; use updated or no_change`);
 			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 hinted = canonicalRole(rawHint) ?? (rawHint === void 0 && (name === narratorName$1 || name === narrator) ? "protagonist" : "extra");
 			const currentState = declared.current_state ?? {};
 			validateResources(currentState, `characters.${name}`);
+			const growth = declared.growth === void 0 ? [] : [{
+				...declared.growth,
+				chapter
+			}];
 			const created = {
 				name,
 				role: normalizeRole(declared.role, hinted),
 				first_appearance: chapter,
 				profile: declared.profile ?? {},
 				current_state: currentState,
-				growth: [],
+				growth,
 				updated_at: chapter
 			};
 			characters.characters.push(created);
@@ -5626,7 +5773,7 @@ function applyStateDelta(input) {
 			const rawHint = input.roleHints?.[name];
 			const hinted = canonicalRole(rawHint);
 			if (hinted !== null && hinted !== "extra") existing.role = hinted;
-			else if (rawHint === void 0 && (name === narratorName || name === narrator)) existing.role = "protagonist";
+			else if (rawHint === void 0 && (name === narratorName$1 || name === narrator)) existing.role = "protagonist";
 		}
 		if (declared.role !== void 0) existing.role = normalizeRole(declared.role, existing.role);
 		if (declared.action === "updated") {
@@ -5809,7 +5956,7 @@ function applyStateDelta(input) {
 		setOwn(locks.characters, name, {
 			first_appearance: character.first_appearance,
 			locked_at: chapter,
-			appearance: appearanceOf(input.text, name, name === narratorName ? narratorAliases : [])
+			appearance: appearanceOf(input.text, name, narratorAliasesFor(name, narrator))
 		});
 	}
 	for (const location of world.locations) if (!Object.hasOwn(locks.locations, location.name)) setOwn(locks.locations, location.name, {
@@ -6004,6 +6151,11 @@ function applyStateDelta(input) {
 }
 // src/engine/insight.ts
 const average = (values) => values.length === 0 ? 0 : values.reduce((total, value) => total + value, 0) / values.length;
+const clip = (value, max) => {
+	const chars = Array.from(value);
+	return chars.length <= max ? value : `${chars.slice(0, Math.max(0, max - 1)).join("")}…`;
+};
+const clipList = (values, max) => values.map((value) => clip(value, max));
 const median = (values) => {
 	if (values.length === 0) return 0;
 	const sorted = [...values].sort((left, right) => left - right);
@@ -6051,7 +6203,7 @@ function buildBookReport(input) {
 	}
 	const chapterReviews = [...finalReviews.values()];
 	const qualitySamples = chapterReviews.length;
-	const qualityAttempts = Math.max(input.reviewAttempts ?? input.reviews.length, qualitySamples);
+	const qualityAttempts = input.reviewAttempts ?? input.reviews.length;
 	const trendBasis = qualitySamples < 3 ? "insufficient_samples" : previous.length < 5 ? "insufficient_history" : "last_five_vs_previous_five";
 	const trend = trendBasis === "last_five_vs_previous_five" ? Math.round((average(lastFive) - average(previous)) * 10) / 10 : null;
 	const dimensions = /* @__PURE__ */ new Map();
@@ -6156,7 +6308,7 @@ function buildBookReport(input) {
 			target: input.targetChapters,
 			words,
 			average_words: averageWords,
-			percent: input.targetChapters === null || input.targetChapters === 0 ? 0 : Math.min(100, Math.round(records.length / input.targetChapters * 1e3) / 10),
+			percent: input.targetChapters === null || input.targetChapters === 0 ? null : Math.min(100, Math.round(records.length / input.targetChapters * 1e3) / 10),
 			remaining_words: averageRemaining,
 			remaining_words_min: minimumRemaining,
 			remaining_words_average: averageRemaining,
@@ -6194,7 +6346,8 @@ function buildBookReport(input) {
 			dimensions: [...dimensions.entries()].map(([id, value]) => ({
 				id,
 				average: Math.round(value.total / value.samples * 10) / 10,
-				samples: value.samples
+				samples: value.samples,
+				max: input.dimensionMax?.[id] ?? 0
 			})).sort((left, right) => compareText(left.id, right.id))
 		},
 		effort: {
@@ -6330,8 +6483,8 @@ function buildGuide(input) {
 		},
 		{
 			id: "write",
-			title: input.finished ? "全书章节已写完" : `写第 ${input.chapter} 章`,
-			detail: input.finished ? `已完成 ${input.archived} 章；下一步是导出成书。` : `当前阶段 ${input.stage}；${input.blocking === 0 ? "没有阻塞" : `${input.blocking} 条阻塞`}。`,
+			title: input.finished ? "全书章节已写完" : input.progress?.current !== null && input.progress?.current !== void 0 ? `写第 ${input.progress.current.chapter} 章` : input.progress?.next !== null && input.progress?.next !== void 0 ? `准备第 ${input.progress.next.chapter} 章（P1）` : `写第 ${input.chapter} 章`,
+			detail: input.finished ? `已完成 ${input.archived} 章；下一步是导出成书。` : `${input.progress?.label ?? `当前阶段 ${input.stage}`}；${input.blocking === 0 ? "没有阻塞" : `${input.blocking} 条阻塞`}。`,
 			done: input.finished,
 			tool: input.next.tool
 		},
@@ -6345,7 +6498,7 @@ function buildGuide(input) {
 	];
 	return {
 		state: input.finished ? "finished" : input.stateErrors > 0 || input.blocking > 0 ? "blocked" : input.stage === "idle" && input.archived === 0 && !outlineDone && !blueprintDone && !worldbookDone ? "new" : input.stage === "idle" && input.archived === 0 ? "planning" : "writing",
-		title: input.finished ? "全书已完成" : `第 ${input.chapter} 章 · ${input.stage}`,
+		title: input.finished ? "全书已完成" : input.progress?.label ?? `第 ${input.chapter} 章 · ${input.stage}`,
 		steps,
 		next: input.next,
 		commands: [
@@ -6602,13 +6755,13 @@ const ledgerWorldEntries = (world, kind) => {
 const nameDescription = (entries, world, kind = "location") => {
 	const merged = /* @__PURE__ */ new Map();
 	for (const entry of [...entries, ...ledgerWorldEntries(world, kind)]) {
-		const name = oneLine(entry.name);
+		const name = clip(oneLine(entry.name), 80);
 		if (name === "") continue;
 		const existing = merged.get(name);
 		if (existing === void 0) {
 			merged.set(name, {
 				name,
-				description: oneLine(entry.description),
+				description: clip(oneLine(entry.description), 240),
 				...entry.anchors === void 0 || entry.anchors.length === 0 ? {} : { anchors: [...entry.anchors] }
 			});
 			continue;
@@ -6628,12 +6781,12 @@ function buildPanelBookData(input) {
 	const card = input.outline.chapters.find((candidate) => candidate.num === input.currentChapter);
 	const currentCard = card === void 0 ? null : {
 		num: card.num,
-		title: card.title,
+		title: clip(card.title, 120),
 		scene_type: card.scene_type,
-		goal: card.goal,
-		conflict: card.conflict,
-		hook: card.hook,
-		cast: [...card.cast],
+		goal: clip(card.goal, 400),
+		conflict: clip(card.conflict, 400),
+		hook: clip(card.hook, 400),
+		cast: [...card.cast].slice(0, 8).map((name) => clip(name, 80)),
 		target_words: [card.target_words[0], card.target_words[1]],
 		status: card.status
 	};
@@ -6650,8 +6803,8 @@ function buildPanelBookData(input) {
 	};
 	return {
 		identity: {
-			author: input.project.author,
-			description: input.project.description,
+			author: clip(input.project.author, 80),
+			description: clip(input.project.description, 400),
 			created_at: input.project.created_at,
 			targets: {
 				words_per_chapter: [input.project.targets.words_per_chapter[0], input.project.targets.words_per_chapter[1]],
@@ -6660,14 +6813,14 @@ function buildPanelBookData(input) {
 			}
 		},
 		blueprint: {
-			premise: input.outline.book.premise,
-			logline: input.outline.book.logline,
-			themes: [...input.outline.book.themes],
-			tone: input.outline.book.tone,
-			pov: input.outline.book.pov,
-			audience: input.outline.book.audience,
-			selling_points: [...input.outline.book.selling_points],
-			ending: input.outline.book.ending
+			premise: clip(input.outline.book.premise, 400),
+			logline: clip(input.outline.book.logline, 400),
+			themes: clipList(input.outline.book.themes, 120).slice(0, 20),
+			tone: clip(input.outline.book.tone, 400),
+			pov: clip(input.outline.book.pov, 400),
+			audience: clip(input.outline.book.audience, 400),
+			selling_points: clipList(input.outline.book.selling_points, 200).slice(0, 20),
+			ending: clip(input.outline.book.ending, 400)
 		},
 		progress: {
 			archived: report.progress.archived,
@@ -6693,9 +6846,9 @@ function buildPanelBookData(input) {
 			factions: nameDescription(input.worldbook.factions, input.world, "faction"),
 			rules: nameDescription(input.worldbook.rules, input.world, "rule"),
 			facts: (input.worldbook.facts ?? []).slice(0, 5).map((fact) => ({
-				alias: fact.alias,
+				alias: clip(fact.alias, 80),
 				value: fact.value,
-				unit: fact.unit
+				unit: clip(fact.unit, 40)
 			}))
 		},
 		cast: {
@@ -6738,11 +6891,11 @@ function buildPanelBookData(input) {
 		health: {
 			state_errors: input.stateErrors.slice(0, 10).map((entry) => ({ ...entry })),
 			outline: {
-				present: input.outlinePresent,
+				present: input.outlinePresent && input.outlineError === null,
 				error: input.outlineError
 			},
 			worldbook: {
-				present: input.worldbookPresent,
+				present: input.worldbookPresent && input.worldbookError === null,
 				error: input.worldbookError
 			},
 			pending: input.pending === null ? null : { ...input.pending }
@@ -6762,7 +6915,7 @@ const kindOf = (directory, suffix) => {
 * still on disk: history is evidence, not a cache, and this function never
 * deletes it.
 */
-async function listHistory(store, chapter) {
+async function listHistory(store, chapter, options = {}) {
 	const entries = [];
 	for (const kind of HISTORY_KINDS) {
 		const names = await store.list(joinRel(HISTORY_DIR, kind));
@@ -6775,14 +6928,14 @@ async function listHistory(store, chapter) {
 			const revision = Number(match.groups.revision);
 			if (chapter !== void 0 && num !== chapter) continue;
 			const path = joinRel(HISTORY_DIR, kind, name);
-			const text = await store.readText(path);
-			entries.push({
+			const entry = {
 				kind,
 				chapter: num,
 				revision,
-				path,
-				chars: text?.length ?? 0
-			});
+				path
+			};
+			if (options.withChars === true) entry.chars = (await store.readText(path))?.length ?? 0;
+			entries.push(entry);
 		}
 	}
 	return entries.sort((left, right) => left.chapter - right.chapter || right.revision - left.revision || compareText(left.kind, right.kind));
@@ -7957,7 +8110,7 @@ const SUMMARY_FIELDS = [
 	"plot_advancement"
 ];
 /** PG-05: the ten summary fields exist and have the right shape. */
-const summarySchema = (input) => {
+const summarySchema$1 = (input) => {
 	if (input.operation === "submitRevision" && input.summaryProvided !== true) return [];
 	if (input.summary === null) return [block("PG-05", "no chapter summary supplied")];
 	const summary = input.summary;
@@ -8015,11 +8168,8 @@ const summarySchema = (input) => {
 		}
 	}
 	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 narrator = input.narrator ?? input.pipeline.draft?.narrator ?? "";
+		for (const name of summary.characters_appeared) if (!isNarratorAlias(name, narrator, input.text)) 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");
@@ -8252,7 +8402,7 @@ const GATE_FUNCTIONS = {
 	"PG-02": stageOrder,
 	"PG-03": wordCount,
 	"PG-04": format,
-	"PG-05": summarySchema,
+	"PG-05": summarySchema$1,
 	"PG-06": sceneType,
 	"PG-07": score,
 	"PG-08": issuesCleared,
@@ -8363,12 +8513,67 @@ function briefStageFor(operation, stage) {
 	}
 }
 // src/engine/projections.ts
+/**
+* Turn the protocol pair (`chapter` + `stage`) into the only human-readable
+* chapter boundary. After archiving chapter N the protocol intentionally keeps
+* `stage: 'done'` and advances `chapter` to N+1; `done` describes chapter N,
+* not the chapter the pipeline now points at.
+*/
+function projectChapterProgress(input) {
+	const archived = [...new Set(input.archived)].filter((num) => Number.isInteger(num) && num > 0).sort((left, right) => left - right);
+	const lastArchived = archived.length === 0 ? null : archived[archived.length - 1];
+	const finished = input.stage === "done" && input.target !== null && archived.length >= input.target;
+	const base = {
+		active_chapter: input.activeChapter,
+		stage: input.stage,
+		last_archived: lastArchived,
+		finished
+	};
+	if (finished) return {
+		...base,
+		current: null,
+		next: null,
+		label: `全书完成：已归档 ${archived.length} 章`,
+		resume: `全书已完成（已归档 ${archived.length} 章）；如需续写，先用 novel_amend 提高 targets.total_chapters。`
+	};
+	if (input.stage === "done") {
+		if (lastArchived === null) return {
+			...base,
+			current: null,
+			next: null,
+			label: `当前第 ${input.activeChapter} 章 · 阶段 done（尚无归档章）`,
+			resume: `引擎处于 done，但章节索引里还没有已归档章；先核对项目状态。`
+		};
+		const nextChapter = input.activeChapter > lastArchived ? input.activeChapter : lastArchived + 1;
+		return {
+			...base,
+			current: null,
+			next: {
+				chapter: nextChapter,
+				stage: "P1"
+			},
+			label: `第 ${lastArchived} 章已归档 · 下一章第 ${nextChapter} 章待开始（P1）`,
+			resume: `第 ${lastArchived} 章已归档；当前不处于写作阶段，下一章第 ${nextChapter} 章从 P1 开始。`
+		};
+	}
+	return {
+		...base,
+		current: {
+			chapter: input.activeChapter,
+			stage: input.stage
+		},
+		next: null,
+		label: `第 ${input.activeChapter} 章 · 阶段 ${input.stage}`,
+		resume: `当前第 ${input.activeChapter} 章，阶段 ${input.stage}。`
+	};
+}
 /** One shared prompt template for `/novel resume` and the panel copy button. */
 function formatResumePrompt(input) {
+	if (input.progress?.finished === true) return "";
 	return [
 		`请继续《${input.title}》。`,
 		`项目根：${input.root}（第一次工具调用必须显式传 project_root=${input.root}）。`,
-		`当前第 ${input.chapter} 章，阶段 ${input.stage}。`,
+		input.progress?.resume ?? `当前第 ${input.chapter} 章，阶段 ${input.stage}。`,
 		`下一步：${input.nextTool}。`,
 		"先调用 novel_status 核对项目根与书名，再按 novel_pipeline 的下一步执行；",
 		"只操作这个项目，不要读取或写入其他书。"
@@ -8434,8 +8639,11 @@ function projectSummary(snapshot) {
 		platform: snapshot.platform,
 		chapter: snapshot.chapter,
 		stage: snapshot.stage,
+		...snapshot.progress === void 0 ? {} : { progress: snapshot.progress },
 		revision: snapshot.revision,
 		totalWords: snapshot.totalWords,
+		...snapshot.archivedWords === void 0 ? {} : { archivedWords: snapshot.archivedWords },
+		...snapshot.draftWords === void 0 ? {} : { draftWords: snapshot.draftWords },
 		totalChapters: snapshot.chapters.length,
 		averageScore: snapshot.averageScore ?? (snapshot.chapters.length === 0 ? 0 : snapshot.chapters.reduce((sum, chapter) => sum + chapter.score, 0) / snapshot.chapters.length),
 		...snapshot.volume === void 0 ? {} : { volume: snapshot.volume },
@@ -8886,6 +9094,10 @@ var EngineService = class {
 	briefContextCache = /* @__PURE__ */ new WeakMap();
 	/** The 15s panel poll reuses the heavy book projection until revision/damage changes. */
 	panelCache = /* @__PURE__ */ new Map();
+	/** Section-level cache; writes bump revision, so a stale entry cannot survive a commit. */
+	sectionCache = /* @__PURE__ */ new Map();
+	journalCache = /* @__PURE__ */ new WeakMap();
+	reviewKeyCache = /* @__PURE__ */ new WeakMap();
 	briefs;
 	now;
 	metadataMutex = new KeyedMutex();
@@ -10206,6 +10418,12 @@ var EngineService = class {
 	*/
 	async statusFor(snapshot, chapter) {
 		const metrics = await this.metricsFor(snapshot, chapter);
+		const progress = projectChapterProgress({
+			activeChapter: snapshot.pipeline.chapter,
+			stage: snapshot.pipeline.stage,
+			archived: snapshot.chapters.chapters.map((record) => record.num),
+			target: snapshot.project.targets.total_chapters
+		});
 		const journal = await this.journalBlocking(snapshot);
 		const pending = await inspectPending(this.storeFor(snapshot.root));
 		const pendingWarnings = pending.state === "complete" || pending.state === "untouched" ? [{
@@ -10229,6 +10447,7 @@ var EngineService = class {
 				active_chapter: snapshot.pipeline.chapter,
 				manuscript_hash: snapshot.pipeline.draft !== void 0 && snapshot.text !== null ? sha256(snapshot.text) : null,
 				stage: snapshot.pipeline.stage,
+				progress,
 				rounds: { ...snapshot.pipeline.rounds },
 				blocking: [...this.effectiveBlocking(snapshot), ...journal],
 				...pendingWarnings.length === 0 ? {} : { warnings: pendingWarnings },
@@ -10410,7 +10629,7 @@ var EngineService = class {
 				};
 			}
 			case "history": {
-				const entries = await listHistory(store, input.chapter);
+				const entries = await listHistory(store, input.chapter, { withChars: true });
 				if (input.revision !== void 0) {
 					if (!Number.isInteger(input.revision) || input.revision < 1) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "history revision must be a positive integer");
 					const matching = entries.filter((entry) => entry.chapter === chapter && entry.revision === input.revision);
@@ -10540,6 +10759,12 @@ var EngineService = class {
 	}
 	async advise(input = {}) {
 		const snapshot = await this.load(input.root);
+		const progress = projectChapterProgress({
+			activeChapter: snapshot.pipeline.chapter,
+			stage: snapshot.pipeline.stage,
+			archived: snapshot.chapters.chapters.map((record) => record.num),
+			target: snapshot.project.targets.total_chapters
+		});
 		const journal = await this.journalBlocking(snapshot);
 		const next = journal.length > 0 && this.stateErrors(snapshot).length === 0 ? {
 			tool: "novel_audit",
@@ -10550,6 +10775,7 @@ var EngineService = class {
 			data: {
 				stage: snapshot.pipeline.stage,
 				chapter: snapshot.pipeline.chapter,
+				progress,
 				tool: next.tool,
 				args: next.args,
 				reason: next.reason,
@@ -10747,11 +10973,23 @@ var EngineService = class {
 			detail: snapshot.projectError ?? `novel.yaml is readable`,
 			...snapshot.projectError === null ? {} : { hint: "read novel_state {kind:\"novel\"} and repair it with novel_amend" }
 		});
+		const profileCount = Object.values(this.rulepack.genres).filter((genre) => genre.profile !== void 0).length;
 		add({
-			id: "pipeline",
+			id: "rulepack",
 			severity: "ok",
+			title: "规则包",
+			detail: `${this.rulepack.name}@${this.rulepack.version} · ${Object.keys(this.rulepack.genres).length} 个题材 · ${profileCount} 个题材 profile`
+		});
+		add({
+			id: "pipeline",
+			severity: snapshot.pipelineError === null ? "ok" : "error",
 			title: "流水线",
-			detail: `revision ${snapshot.pipeline.revision} · 第 ${snapshot.pipeline.chapter} 章 · ${snapshot.pipeline.stage}`
+			detail: `revision ${snapshot.pipeline.revision} · ${projectChapterProgress({
+				activeChapter: snapshot.pipeline.chapter,
+				stage: snapshot.pipeline.stage,
+				archived: snapshot.chapters.chapters.map((record) => record.num),
+				target: snapshot.project.targets.total_chapters
+			}).label}`
 		});
 		for (const error of this.stateErrors(snapshot)) add({
 			id: `state:${error.path}`,
@@ -11043,12 +11281,13 @@ var EngineService = class {
 			foreshadows: snapshot.foreshadows,
 			relationships: snapshot.relationships,
 			reviews: currentReviews,
-			activity: journal.rows.slice(-8),
+			activity: journal.rows.filter((row) => row.op !== "lock_reclaimed").slice(-8),
 			journal: journal.rows,
 			reviewAttempts,
 			finalChecks,
 			targetChapters: snapshot.project.targets.total_chapters,
 			minScore: this.config.quality.minScore,
+			dimensionMax: Object.fromEntries(this.rulepack.quality.dimensions.map((dimension) => [dimension.id, dimension.max])),
 			foreshadowDormantAfter: this.rulepack.crosschapter.foreshadow_dormant_after
 		});
 		if (snapshot.projectError !== null) report.warnings.push(`项目定义不可读：${snapshot.projectError}`);
@@ -11124,7 +11363,13 @@ var EngineService = class {
 		const snapshot = await this.loadAt(selection);
 		await this.recordSelectionBestEffort(selection, snapshot);
 		const target = snapshot.project.targets.total_chapters;
-		const finished = snapshot.pipeline.stage === "done" && target !== null && snapshot.chapters.chapters.length >= target;
+		const progress = projectChapterProgress({
+			activeChapter: snapshot.pipeline.chapter,
+			stage: snapshot.pipeline.stage,
+			archived: snapshot.chapters.chapters.map((record) => record.num),
+			target
+		});
+		const finished = progress.finished;
 		const journalBlocking = await this.journalBlocking(snapshot);
 		const next = journalBlocking.length > 0 && this.stateErrors(snapshot).length === 0 ? {
 			tool: "novel_audit",
@@ -11136,6 +11381,7 @@ var EngineService = class {
 				projectPresent: true,
 				chapter: snapshot.pipeline.chapter,
 				stage: snapshot.pipeline.stage,
+				progress,
 				archived: snapshot.chapters.chapters.length,
 				target,
 				finished,
@@ -11535,6 +11781,7 @@ var EngineService = class {
 					summary: input.summary,
 					draftTitle: input.chapter_title,
 					sceneType: input.scene_type,
+					narrator: input.narrator,
 					planTargetWords: snapshot.plan?.target_words ?? null,
 					planCast: snapshot.plan?.cast === void 0 ? null : snapshot.plan.cast.map((member) => member.name)
 				});
@@ -12119,6 +12366,10 @@ var EngineService = class {
 				record.archived_at = archivedAt;
 				const outline = markOutlineArchived(snapshot.outline, record, archivedAt, snapshot.project.targets.words_per_chapter);
 				this.assertOutlineWritable(snapshot, outline, "novel_archive");
+				const archivedCard = outline.chapters.find((card) => card.num === chapter);
+				if (archivedCard === void 0) throw new EngineFaultError(ERROR_CODES.TXN_ABORTED, `archive did not produce an outline card for chapter ${chapter}`, "restore the outline from backups/ and retry the archive");
+				record.archive_card = archivedCardSnapshot(archivedCard);
+				record.archive_card_digest = archivedCardDigest(record.archive_card);
 				const foreshadows = ledger.foreshadows;
 				const timeline = ledger.timeline;
 				for (const item of foreshadows.items) if (item.status !== "resolved" && chapter - item.last_touched >= this.rulepack.crosschapter.foreshadow_dormant_after) item.status = "dormant";
@@ -12319,32 +12570,24 @@ var EngineService = class {
 						oldDocument = narrow(kind, parse(backup));
 					} catch {}
 				}
-				if (kind === "outline" && (snapshot.outlineError !== null || !snapshot.outlinePresent)) {
+				if (kind === "outline") {
 					const old = recordOf(oldDocument);
 					const oldChapters = Array.isArray(old?.chapters) ? [...old.chapters] : [];
-					const known = new Set(oldChapters.map((raw) => recordOf(raw)).filter((row) => row !== null).map((row) => row.num).filter((num) => Number.isInteger(num)));
-					const candidates = new Map((Array.isArray(document.chapters) ? document.chapters : []).map((raw) => recordOf(raw)).filter((row) => row !== null && Number.isInteger(row.num)).map((row) => [row.num, row]));
+					const indexOf = /* @__PURE__ */ new Map();
+					for (const [index, raw] of oldChapters.entries()) {
+						const row = recordOf(raw);
+						if (row !== null && Number.isInteger(row.num)) indexOf.set(row.num, index);
+					}
 					for (const record of snapshot.chapters.chapters) {
-						if (known.has(record.num)) continue;
-						const candidate = candidates.get(record.num);
-						if (candidate === void 0 || candidate.status !== "archived") continue;
-						let plan = null;
-						const planRaw = await context.store.readText(planChapterFile(record.num));
-						if (planRaw !== null) try {
-							const parsed = parsePlanYaml(planRaw, planChapterFile(record.num));
-							validateStoredChapterPlan(parsed, planChapterFile(record.num));
-							plan = parsed;
-						} catch {
-							plan = null;
-						}
-						const planCast = Array.isArray(plan?.cast) ? plan.cast.map((member) => recordOf(member)?.name ?? "").filter((name) => name !== "") : [];
-						const allowedTargets = [snapshot.project.targets.words_per_chapter, ...Array.isArray(plan?.target_words) ? [plan.target_words] : []];
-						const allowedCasts = [planCast, autoCardCast(record)];
-						const targetMatches = allowedTargets.some((target) => JSON.stringify(target) === JSON.stringify(candidate.target_words));
-						const castMatches = allowedCasts.some((cast) => JSON.stringify(cast) === JSON.stringify(candidate.cast));
-						if (!targetMatches || !castMatches) continue;
-						oldChapters.push({ ...candidate });
-						known.add(record.num);
+						if (record.archive_card === void 0) continue;
+						if (record.archive_card_digest === void 0 || record.archive_card_digest !== archivedCardDigest(record.archive_card)) throw new EngineFaultError(ERROR_CODES.SCHEMA_INVALID, `archived chapter ${record.num} has an archive_card whose digest does not match`, "restore state/chapters.yaml from backups/ or repair the card evidence manually");
+						const archiveCardRow = archivedCardRecord(record);
+						const index = indexOf.get(record.num);
+						if (index === void 0) oldChapters.push(archiveCardRow);
+						else oldChapters[index] = {
+							...recordOf(oldChapters[index]) ?? {},
+							...archiveCardRow
+						};
 					}
 					oldDocument = {
 						...old ?? {},
@@ -12744,6 +12987,436 @@ var EngineService = class {
 		return projectGates(await this.panelSnapshot(input.root));
 	}
 	/**
+	* Additive v7 section read model. Catalog sections reuse the Snapshot; only
+	* the quality section reads archived reviews, and only chapter/quality
+	* detail reads manuscripts or check files. Every section is byte-capped.
+	*/
+	async panelSection(input = { section: "overview" }) {
+		const selection = await this.resolveRoot(input.root);
+		if (input.root !== void 0 && selection.root !== null) {
+			const selected = resolve(selection.root);
+			const registry = await this.registry().read();
+			const configured = this.defaultRoot();
+			if (!(registry.active !== null && resolve(registry.active) === selected ? true : registry.projects.some((entry) => resolve(entry.root) === selected) || selected === resolve(configured))) throw new EngineInputError(ERROR_CODES.PROJECT_NOT_FOUND, `panel section root is not registered: ${selected}`, "用 /novel scan --register 或 /novel admin novel_registry_register 登记后刷新；面板不读取任意路径");
+		}
+		const snapshot = await this.loadAt(selection);
+		const section = input.section;
+		const query = input.query ?? {};
+		const cacheable = section !== "chapter_detail" && section !== "quality_detail";
+		let sectionKey = null;
+		if (cacheable) {
+			const journalIdentity = await this.panelJournalIdentity(snapshot);
+			const reviewKey = section === "quality" ? await this.panelReviewKey(snapshot) : "";
+			sectionKey = sha256(stableJson({
+				root: snapshot.root,
+				revision: snapshot.pipeline.revision,
+				journalKey: journalIdentity.key,
+				reviewKey,
+				section,
+				query,
+				stage: snapshot.pipeline.stage,
+				errors: [
+					snapshot.projectError,
+					snapshot.pipelineError,
+					snapshot.planError,
+					snapshot.reviewError,
+					snapshot.checkError,
+					snapshot.outlineError,
+					snapshot.worldbookError,
+					...snapshot.ledgerErrors.map((error) => error.code)
+				]
+			}));
+			const cachedSection = this.sectionCache.get(sectionKey);
+			if (cachedSection !== void 0) return cachedSection.value;
+		}
+		let items = null;
+		let total = 0;
+		let truncated = false;
+		let nextCursor = null;
+		if (section === "overview") {
+			const panel = await this.panelSnapshot(void 0, {
+				snapshot,
+				includeQuality: false
+			});
+			items = {
+				...panel,
+				chapters: panel.chapters.slice(-5),
+				bookData: panel.bookData === void 0 ? void 0 : {
+					...panel.bookData,
+					quality: {
+						...panel.bookData.quality,
+						dimensions: [],
+						samples: 0,
+						attempts: 0
+					},
+					effort: {
+						...panel.bookData.effort,
+						chapters: []
+					}
+				}
+			};
+			total = 1;
+		} else if (section === "chapter_detail" || section === "quality_detail") {
+			const chapter = query.chapter ?? snapshot.pipeline.chapter;
+			if (!Number.isInteger(chapter) || chapter < 1) throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, "chapter detail requires a positive chapter");
+			const row = snapshot.chapters.chapters.find((record) => record.num === chapter) ?? null;
+			const active = chapter === snapshot.pipeline.chapter;
+			const store = this.storeFor(snapshot.root);
+			if (section === "quality_detail") {
+				items = {
+					chapter,
+					review: await store.readText(reviewFile(chapter)),
+					check: await store.readText(checkFile(chapter))
+				};
+				total = row === null && !active ? 0 : 1;
+			} else {
+				items = {
+					chapter,
+					row,
+					manuscript: row === null || row.file === "" ? active ? snapshot.text : null : await store.readText(row.file),
+					plan: await store.readText(planChapterFile(chapter)),
+					world_plan: await store.readText(planWorldFile(chapter)),
+					summary_events: (row?.summary.events ?? snapshot.pipeline.draft?.summary?.events ?? []).slice(0, 4)
+				};
+				total = row === null && !active ? 0 : 1;
+			}
+		} else if (section === "chapters") {
+			const archivedCurrent = snapshot.chapters.chapters.some((record) => record.num === snapshot.pipeline.chapter);
+			const draftWords = snapshot.text === null || archivedCurrent || snapshot.pipeline.stage === "done" ? 0 : countWordMetrics(snapshot.text).total_word_count;
+			const rows = snapshot.chapters.chapters.map((record) => ({
+				num: record.num,
+				title: record.title,
+				file: record.file,
+				word_count: record.word_count,
+				score: record.score,
+				status: "archived",
+				scene_type: record.scene_type,
+				dialogue_ratio: record.dialogue_ratio,
+				final_check: record.final_check ?? null,
+				archived_at: record.archived_at ?? null,
+				summary_events: record.summary.events.slice(0, 4),
+				rounds: record.rounds ?? null
+			}));
+			if (!archivedCurrent && snapshot.pipeline.stage !== "done") rows.push({
+				num: snapshot.pipeline.chapter,
+				title: stripTitlePrefix(snapshot.plan?.title ?? "") || `第${snapshot.pipeline.chapter}章`,
+				file: null,
+				word_count: draftWords,
+				score: snapshot.review?.total ?? null,
+				status: "draft",
+				scene_type: snapshot.plan?.scene_type ?? null,
+				dialogue_ratio: null,
+				final_check: null,
+				archived_at: null,
+				summary_events: (snapshot.pipeline.draft?.summary?.events ?? []).slice(0, 4),
+				rounds: snapshot.pipeline.rounds
+			});
+			const sorted = rows.filter((row) => {
+				if (query.status !== void 0 && query.status !== "" && row.status !== query.status) return false;
+				if (query.scene !== void 0 && query.scene !== "" && row.scene_type !== query.scene) return false;
+				if (query.search !== void 0 && query.search !== "") {
+					if (!String(row.title ?? "").includes(query.search)) return false;
+				}
+				return true;
+			}).sort((left, right) => {
+				const byNum = Number(left.num) - Number(right.num);
+				return query.sort === "num_asc" ? byNum : -byNum;
+			});
+			total = sorted.length;
+			const page = this.panelSectionPage(sorted, query);
+			items = page.items;
+			truncated = page.truncated;
+			nextCursor = page.nextCursor;
+		} else if (section === "characters") {
+			const seen = /* @__PURE__ */ new Map();
+			for (const record of snapshot.chapters.chapters) for (const name of record.summary.characters_appeared) {
+				const current = seen.get(name) ?? {
+					first: record.num,
+					last: record.num,
+					appearances: 0
+				};
+				current.first = Math.min(current.first, record.num);
+				current.last = Math.max(current.last, record.num);
+				current.appearances += 1;
+				seen.set(name, current);
+			}
+			const filtered = snapshot.characters.characters.map((character) => ({
+				...character,
+				...seen.get(character.name) ?? {
+					first: character.first_appearance,
+					last: null,
+					appearances: 0
+				}
+			})).filter((row) => query.search === void 0 || query.search === "" ? true : row.name.includes(query.search) || row.role.includes(query.search));
+			total = filtered.length;
+			const page = this.panelSectionPage(filtered, query, 200);
+			items = page.items;
+			truncated = page.truncated;
+			nextCursor = page.nextCursor;
+		} else if (section === "foreshadows") {
+			const filtered = snapshot.foreshadows.items.filter((row) => {
+				if (query.status !== void 0 && query.status !== "" && row.status !== query.status) return false;
+				return query.search === void 0 || query.search === "" ? true : row.title.includes(query.search);
+			});
+			const page = this.panelSectionPage(filtered, query, 200);
+			total = filtered.length + snapshot.timeline.items.length + snapshot.relationships.items.length;
+			truncated = page.truncated || snapshot.timeline.items.length > 200 || snapshot.relationships.items.length > 200;
+			items = {
+				foreshadows: page.items,
+				timeline: snapshot.timeline.items.slice(0, 200),
+				relationships: snapshot.relationships.items.slice(0, 200)
+			};
+			nextCursor = page.nextCursor;
+		} else if (section === "timeline") {
+			const filtered = snapshot.timeline.items.filter((row) => query.search === void 0 || query.search === "" ? true : row.description.includes(query.search) || (row.location ?? "").includes(query.search));
+			total = filtered.length;
+			const page = this.panelSectionPage(filtered, query, 200);
+			items = page.items;
+			truncated = page.truncated;
+			nextCursor = page.nextCursor;
+		} else if (section === "relationships") {
+			const filtered = snapshot.relationships.items.filter((row) => query.search === void 0 || query.search === "" ? true : row.a.includes(query.search) || row.b.includes(query.search) || row.type.includes(query.search));
+			total = filtered.length;
+			const page = this.panelSectionPage(filtered, query, 200);
+			items = page.items;
+			truncated = page.truncated;
+			nextCursor = page.nextCursor;
+		} else if (section === "worldbook") {
+			const world = snapshot.world;
+			const book = snapshot.worldbook;
+			const search = query.search?.trim() ?? "";
+			const matches = (value) => {
+				if (search === "") return true;
+				if (typeof value === "string") return value.includes(search);
+				if (typeof value === "number" || typeof value === "boolean") return String(value).includes(search);
+				if (Array.isArray(value)) return value.some((item) => matches(item));
+				if (typeof value === "object" && value !== null) return Object.values(value).some((item) => matches(item));
+				return false;
+			};
+			const filterRows = (rows) => rows.filter((row) => matches(row));
+			const capRows = (rows) => rows.slice(0, 200);
+			const groups = {
+				rules: filterRows(book.rules),
+				factions: filterRows(book.factions),
+				locations: filterRows(book.locations),
+				characters: filterRows(book.characters),
+				glossary: filterRows(book.glossary),
+				backstory: filterRows(book.backstory),
+				facts: filterRows(book.facts ?? []),
+				themes: filterRows(book.themes)
+			};
+			const ledger = {
+				locations: filterRows(world.locations),
+				abilities: filterRows(world.abilities),
+				artifacts: filterRows(world.artifacts),
+				factions: filterRows(world.factions),
+				rules: filterRows(world.rules)
+			};
+			const outlineCards = filterRows(snapshot.outline.chapters);
+			const all = [
+				...Object.values(groups),
+				...Object.values(ledger),
+				outlineCards
+			];
+			total = all.reduce((count, rows) => count + rows.length, 0);
+			truncated = all.some((rows) => rows.length > 200);
+			items = {
+				premise: book.premise,
+				setting: book.setting,
+				blueprint: snapshot.outline.book,
+				volumes: snapshot.outline.volumes,
+				rules: capRows(groups.rules),
+				factions: capRows(groups.factions),
+				locations: capRows(groups.locations),
+				characters: capRows(groups.characters),
+				glossary: capRows(groups.glossary),
+				backstory: capRows(groups.backstory),
+				facts: capRows(groups.facts),
+				themes: capRows(groups.themes),
+				ledger: {
+					locations: capRows(ledger.locations),
+					abilities: capRows(ledger.abilities),
+					artifacts: capRows(ledger.artifacts),
+					factions: capRows(ledger.factions),
+					rules: capRows(ledger.rules)
+				},
+				outline_cards: capRows(outlineCards),
+				drift: outlineDrift(snapshot.outline, snapshot.chapters.chapters)
+			};
+		} else if (section === "quality") {
+			const panel = await this.panelSnapshot(void 0, {
+				snapshot,
+				includeQuality: true
+			});
+			const maxById = new Map(this.rulepack.quality.dimensions.map((dimension) => [dimension.id, dimension.max]));
+			items = {
+				quality: panel.bookData?.quality ?? null,
+				dimensions: (panel.bookData?.quality.dimensions ?? []).map((dimension) => ({
+					...dimension,
+					max: maxById.get(dimension.id) ?? null
+				})),
+				pacing: panel.bookData?.pacing ?? null,
+				effort: panel.bookData?.effort ?? null
+			};
+			total = items === null ? 0 : 1;
+		} else {
+			const panel = await this.panelSnapshot(void 0, {
+				snapshot,
+				includeQuality: false
+			});
+			items = {
+				health: panel.health ?? null,
+				blocking: panel.blocking,
+				state_errors: this.stateErrors(snapshot),
+				outline: {
+					present: snapshot.outlinePresent && snapshot.outlineError === null,
+					file_existed: snapshot.outlinePresent,
+					error: snapshot.outlineError
+				},
+				worldbook: {
+					present: snapshot.worldbookPresent && snapshot.worldbookError === null,
+					file_existed: snapshot.worldbookPresent,
+					error: snapshot.worldbookError
+				},
+				drift: outlineDrift(snapshot.outline, snapshot.chapters.chapters),
+				pending: panel.pending ?? null
+			};
+			total = 1;
+		}
+		const clipped = section === "chapter_detail" || section === "quality_detail" ? {
+			items,
+			truncated: false
+		} : this.panelSectionClip(items, section);
+		items = clipped.items;
+		truncated = truncated || clipped.truncated;
+		const budgeted = this.panelSectionBudget(items, 65536);
+		items = budgeted.items;
+		truncated = truncated || budgeted.truncated;
+		if (budgeted.truncated) nextCursor = null;
+		const updatedAt = this.now().toISOString();
+		const etag = sha256(stableJson({
+			root: snapshot.root,
+			revision: snapshot.pipeline.revision,
+			section,
+			query,
+			items,
+			total,
+			truncated
+		}));
+		const result = {
+			payload_version: 7,
+			section,
+			items,
+			total,
+			returned: this.panelSectionReturned(items),
+			truncated,
+			next_cursor: nextCursor,
+			updated_at: updatedAt,
+			etag
+		};
+		if (sectionKey !== null) {
+			this.sectionCache.set(sectionKey, {
+				key: sectionKey,
+				value: result
+			});
+			if (this.sectionCache.size > 64) {
+				const oldest = this.sectionCache.keys().next().value;
+				if (oldest !== void 0) this.sectionCache.delete(oldest);
+			}
+		}
+		return result;
+	}
+	panelSectionPage(rows, query, defaultLimit = 50) {
+		const requested = query.limit ?? defaultLimit;
+		const limit = Number.isInteger(requested) ? Math.min(200, Math.max(1, requested)) : defaultLimit;
+		const cursor = Number.parseInt(query.cursor ?? "0", 10);
+		const start = Number.isInteger(cursor) && cursor >= 0 ? cursor : 0;
+		const items = rows.slice(start, start + limit);
+		const truncated = start + items.length < rows.length;
+		return {
+			items,
+			truncated,
+			nextCursor: truncated ? String(start + items.length) : null
+		};
+	}
+	panelSectionReturned(items) {
+		if (Array.isArray(items)) return items.length;
+		if (typeof items === "object" && items !== null) return Object.values(items).reduce((total, value) => total + (Array.isArray(value) ? value.length : 1), 0);
+		return items === null ? 0 : 1;
+	}
+	/** WP3.7 free-text caps before the byte budget; both report truncation. */
+	panelSectionClip(value, section) {
+		let truncated = false;
+		const walk = (input, path) => {
+			if (typeof input === "string") {
+				const keys = path.filter((part) => !/^\d+$/.test(part));
+				const key = keys[keys.length - 1] ?? "";
+				const worldbookText = section === "worldbook" || keys.some((part) => part === "ledger" || part === "worldbook");
+				const max = key === "description" && worldbookText ? 240 : 400;
+				const chars = Array.from(input);
+				if (chars.length > max) {
+					truncated = true;
+					return chars.slice(0, max).join("");
+				}
+				return input;
+			}
+			if (Array.isArray(input)) return input.map((item, index) => walk(item, [...path, String(index)]));
+			if (typeof input === "object" && input !== null) return Object.fromEntries(Object.entries(input).map(([key, item]) => [key, walk(item, [...path, key])]));
+			return input;
+		};
+		return {
+			items: walk(value, []),
+			truncated
+		};
+	}
+	panelSectionBudget(value, limit) {
+		const bytes = (input) => Buffer.byteLength(JSON.stringify(input) ?? "null");
+		if (bytes(value) <= limit) return {
+			items: value,
+			truncated: false
+		};
+		const clipStrings = (input, maxChars) => {
+			if (typeof input === "string") {
+				const chars = Array.from(input);
+				return chars.length <= maxChars ? input : chars.slice(0, maxChars).join("");
+			}
+			if (Array.isArray(input)) return input.map((item) => clipStrings(item, maxChars));
+			if (typeof input === "object" && input !== null) return Object.fromEntries(Object.entries(input).map(([key, item]) => [key, clipStrings(item, maxChars)]));
+			return input;
+		};
+		const popOne = (input) => {
+			if (Array.isArray(input)) {
+				if (input.length > 1) {
+					input.pop();
+					return true;
+				}
+				return input.some((item) => popOne(item));
+			}
+			if (typeof input === "object" && input !== null) return Object.values(input).some((item) => popOne(item));
+			return false;
+		};
+		for (const maxChars of [
+			2e3,
+			1e3,
+			500,
+			200,
+			80,
+			20,
+			0
+		]) {
+			const candidate = clipStrings(value, maxChars);
+			while (bytes(candidate) > limit) if (!popOne(candidate)) break;
+			if (bytes(candidate) <= limit) return {
+				items: candidate,
+				truncated: true
+			};
+		}
+		return {
+			items: Array.isArray(value) ? [] : typeof value === "object" && value !== null ? {} : typeof value === "string" ? "" : null,
+			truncated: true
+		};
+	}
+	/**
 	* Build the read-only panel payload. The query root is accepted only when it
 	* is registered, active or the configured root; arbitrary paths never reach
 	* the filesystem from the panel route.
@@ -12776,9 +13449,10 @@ var EngineService = class {
 			add(await optionFor(active, known !== void 0, known?.title, known?.created_at));
 		}
 		const configured = this.defaultRoot();
+		const explicitConfigured = this.config.projectRoot !== "./novel" && configured !== resolve("./novel");
 		if (!rows.has(configured)) {
 			const option = await optionFor(configured, false);
-			if (option.state !== "missing" || active === configured) add(option);
+			if (option.state !== "missing" || active === configured || explicitConfigured) add(option);
 		}
 		const selectedRoot = input.root === void 0 ? void 0 : resolve(input.root);
 		if (selectedRoot !== void 0 && !rows.has(selectedRoot) && selectedRoot === configured) add(await optionFor(configured, false));
@@ -12842,7 +13516,7 @@ var EngineService = class {
 		};
 		let snapshot;
 		try {
-			snapshot = await this.panelSnapshot(selection.root);
+			snapshot = await this.panelSnapshot(selection.root, { includeQuality: input.lean !== true });
 		} catch (error) {
 			if (error instanceof EngineError) {
 				const busy = error.code === ERROR_CODES.TXN_IN_PROGRESS;
@@ -12863,19 +13537,29 @@ var EngineService = class {
 		}
 		const summary = projectSummary(snapshot);
 		if (option.state !== "ok" && option.title !== "") summary.title = option.title;
-		const resume = summary.next === void 0 ? void 0 : { text: formatResumePrompt({
+		const resume = summary.next === void 0 || summary.progress?.finished === true ? void 0 : { text: formatResumePrompt({
 			title: summary.title,
 			root: summary.root,
 			chapter: summary.chapter,
 			stage: summary.stage,
-			nextTool: summary.next.tool
+			nextTool: summary.next.tool,
+			...summary.progress === void 0 ? {} : { progress: summary.progress }
 		}) };
+		const chapters = projectChapters(snapshot);
+		const etag = sha256(stableJson({
+			root: snapshot.root,
+			projects,
+			selection,
+			summary,
+			chapters,
+			...resume === void 0 ? {} : { resume }
+		}));
 		return {
 			projects,
 			selection,
 			summary,
-			chapters: projectChapters(snapshot),
-			gates: projectGates(snapshot),
+			chapters,
+			etag,
 			...resume === void 0 ? {} : { resume }
 		};
 	}
@@ -12888,12 +13572,13 @@ var EngineService = class {
 		const nextTool = status.data.next?.tool;
 		return {
 			data: {
-				text: nextTool === void 0 ? null : formatResumePrompt({
+				text: nextTool === void 0 || status.data.progress?.finished === true ? null : formatResumePrompt({
 					title: status.data.project.title,
 					root: status.data.project.root,
 					chapter: status.data.chapter,
 					stage: status.data.stage,
-					nextTool
+					nextTool,
+					...status.data.progress === void 0 ? {} : { progress: status.data.progress }
 				}),
 				selection: status.data.selection
 			},
@@ -12903,12 +13588,18 @@ var EngineService = class {
 	}
 	async stats(input = {}) {
 		const snapshot = await this.load(input.root);
-		const totalWords = snapshot.chapters.chapters.reduce((total, chapter) => total + chapter.word_count, 0);
+		const stateErrors = this.stateErrors(snapshot);
+		const archivedWords = snapshot.chapters.chapters.reduce((total, chapter) => total + chapter.word_count, 0);
+		const activeIndexed = snapshot.chapters.chapters.some((chapter) => chapter.num === snapshot.pipeline.chapter);
+		const draftWords = snapshot.text === null || activeIndexed || snapshot.pipeline.stage === "done" ? 0 : countWordMetrics(snapshot.text).total_word_count;
+		const totalWords = archivedWords + draftWords;
 		const scores = snapshot.chapters.chapters.map((chapter) => chapter.score);
 		const outline = outlineSummary(snapshot.outline, snapshot.chapters.chapters.length, snapshot.project.targets.total_chapters, snapshot.chapters.chapters.map((record) => record.num));
 		const counts = worldbookCounts(snapshot.worldbook);
 		return {
 			totalWords,
+			archivedWords,
+			draftWords,
 			chapters: snapshot.chapters.chapters.length,
 			revision: snapshot.pipeline.revision,
 			rulepack: `${this.rulepack.name}@${this.rulepack.version}`,
@@ -12923,7 +13614,9 @@ var EngineService = class {
 			blueprintReady: bookPlanPresent(snapshot.outline.book),
 			worldbookEntries: counts.characters + counts.locations + counts.factions + counts.rules + counts.glossary + counts.backstory + counts.facts,
 			strictOutline: snapshot.outline.book.strict,
-			targetChapters: snapshot.project.targets.total_chapters
+			targetChapters: snapshot.project.targets.total_chapters,
+			state_errors: stateErrors,
+			partial: stateErrors.length > 0
 		};
 	}
 	registry() {
@@ -12942,6 +13635,17 @@ var EngineService = class {
 				...inspection.state === "ok" && !sameIdentity ? { identity_changed: true } : {}
 			};
 		}));
+		const configured = this.defaultRoot();
+		if (configured !== "" && !document.projects.some((entry) => resolve(entry.root) === resolve(configured))) {
+			const inspection = await inspectProject(configured);
+			if (inspection.state === "missing") projects.push({
+				root: configured,
+				title: "配置项目根",
+				created_at: "",
+				updated_at: "",
+				state: inspection.state
+			});
+		}
 		return {
 			active: document.active,
 			projects
@@ -13400,21 +14104,70 @@ var EngineService = class {
 			}
 		};
 	}
-	async panelSnapshot(root) {
-		const selection = await this.resolveRoot(root);
-		const snapshot = await this.loadAt(selection);
+	panelReviewKey(snapshot) {
+		const cached = this.reviewKeyCache.get(snapshot);
+		if (cached !== void 0) return cached;
+		const pending = (async () => {
+			const store = this.storeFor(snapshot.root);
+			const names = await store.list("reviews");
+			const files = await Promise.all(names.map(async (name) => {
+				const stat = await store.stat(`reviews/${name}`);
+				return [name, stat === null ? null : [stat.size, Math.round(stat.mtimeMs)]];
+			}));
+			return sha256(stableJson(files));
+		})();
+		this.reviewKeyCache.set(snapshot, pending);
+		return pending;
+	}
+	panelJournalIdentity(snapshot) {
+		const cached = this.journalCache.get(snapshot);
+		if (cached !== void 0) return cached;
+		const pending = (async () => {
+			const journal = await readJournal(this.storeFor(snapshot.root));
+			const journalBlocking = await this.journalBlocking(snapshot);
+			const tail = journal.rows[journal.rows.length - 1];
+			return {
+				key: sha256(stableJson({
+					rows: journal.rows.length,
+					tail: tail === void 0 ? null : [
+						tail.seq,
+						tail.at,
+						tail.status
+					],
+					blocking: journalBlocking
+				})),
+				journal,
+				blocking: journalBlocking
+			};
+		})();
+		this.journalCache.set(snapshot, pending);
+		return pending;
+	}
+	async panelSnapshot(root, options = {}) {
+		const snapshot = options.snapshot ?? await this.loadAt(await this.resolveRoot(root));
+		const includeQuality = options.includeQuality !== false;
 		const archived = snapshot.chapters.chapters;
 		const archivedCurrent = archived.some((chapter) => chapter.num === snapshot.pipeline.chapter);
 		const target = snapshot.project.targets.total_chapters;
-		const finished = snapshot.pipeline.stage === "done" && target !== null && archived.length >= target;
-		const draftWords = snapshot.text === null ? 0 : countWordMetrics(snapshot.text).total_word_count;
+		const progress = projectChapterProgress({
+			activeChapter: snapshot.pipeline.chapter,
+			stage: snapshot.pipeline.stage,
+			archived: archived.map((record) => record.num),
+			target
+		});
+		const finished = progress.finished;
+		const draftWords = snapshot.text === null || archivedCurrent || snapshot.pipeline.stage === "done" ? 0 : countWordMetrics(snapshot.text).total_word_count;
+		const archivedWords = archived.reduce((total, chapter) => total + chapter.word_count, 0);
 		const pending = await inspectPending(this.storeFor(snapshot.root));
 		const stateErrorCount = this.stateErrors(snapshot).length;
-		const panelCacheKey = `${snapshot.root}:${snapshot.pipeline.revision}:${pending.state}:${stateErrorCount}:${snapshot.outlineError ?? ""}:${snapshot.worldbookError ?? ""}:${JSON.stringify(snapshot.briefs)}`;
+		const journalIdentity = await this.panelJournalIdentity(snapshot);
+		const journalKey = journalIdentity.key;
+		const journal = journalIdentity.journal;
+		const journalBlocking = journalIdentity.blocking;
+		const reviewKey = includeQuality ? await this.panelReviewKey(snapshot) : "";
+		const panelCacheKey = `${snapshot.root}:${snapshot.pipeline.revision}:${pending.state}:${stateErrorCount}:${snapshot.outlineError ?? ""}:${snapshot.worldbookError ?? ""}:${JSON.stringify(snapshot.briefs)}:${journalKey}:${reviewKey}:${includeQuality ? "full" : "base"}`;
 		const cachedPanel = this.panelCache.get(snapshot.root);
 		if (cachedPanel?.key === panelCacheKey) return cachedPanel.snapshot;
-		const journal = await readJournal(this.storeFor(snapshot.root));
-		const journalBlocking = await this.journalBlocking(snapshot);
 		const outline = outlineSummary(snapshot.outline, archived.length, target, archived.map((record) => record.num));
 		const counts = worldbookCounts(snapshot.worldbook);
 		const scores = archived.slice(-10).map((chapter) => chapter.score);
@@ -13461,26 +14214,31 @@ var EngineService = class {
 		const qualityScores = scores.slice(-5);
 		const previousScores = scores.slice(-10, -5);
 		const store = this.storeFor(snapshot.root);
-		const reviewNames = new Set(await store.list(REVIEW_DIR));
-		const sampleChapters = /* @__PURE__ */ new Set();
 		const currentReviews = [];
-		for (const record of archived) {
-			const name = reviewFile(record.num).slice(`${REVIEW_DIR}/`.length);
-			if (!reviewNames.has(name)) continue;
-			try {
-				const review = await store.readDoc(reviewFile(record.num), "review");
-				if (review !== null) {
-					sampleChapters.add(record.num);
-					currentReviews.push(review);
-				}
-			} catch {}
+		let samples = 0;
+		let attempts = 0;
+		if (includeQuality) {
+			const reviewNames = new Set(await store.list(REVIEW_DIR));
+			const sampleChapters = /* @__PURE__ */ new Set();
+			for (const record of archived) {
+				const name = reviewFile(record.num).slice(`${REVIEW_DIR}/`.length);
+				if (!reviewNames.has(name)) continue;
+				try {
+					const review = await store.readDoc(reviewFile(record.num), "review");
+					if (review !== null) {
+						sampleChapters.add(record.num);
+						currentReviews.push(review);
+					}
+				} catch {}
+			}
+			samples = sampleChapters.size;
+			const archivedChapterNums = new Set(archived.map((record) => record.num));
+			attempts = [...(await this.reviewAttemptsByChapter(store, journal.rows, [...archivedChapterNums], sampleChapters)).values()].reduce((total, count) => total + count, 0);
 		}
-		const samples = sampleChapters.size;
-		const archivedChapterNums = new Set(archived.map((record) => record.num));
-		const attempts = [...(await this.reviewAttemptsByChapter(store, journal.rows, [...archivedChapterNums], sampleChapters)).values()].reduce((total, count) => total + count, 0);
 		const qualityTrendBasis = samples < 3 ? "insufficient_samples" : previousScores.length < 5 ? "insufficient_history" : "last_five_vs_previous_five";
 		const quality = {
-			averageScore: scores.length === 0 ? 0 : scores.reduce((total, score) => total + score, 0) / scores.length,
+			averageScore: archived.length === 0 ? 0 : archived.reduce((total, chapter) => total + chapter.score, 0) / archived.length,
+			last_ten_average: scores.length === 0 ? null : scores.reduce((total, score) => total + score, 0) / scores.length,
 			scores,
 			trend: qualityTrendBasis === "last_five_vs_previous_five" ? Math.round((qualityScores.reduce((total, score) => total + score, 0) / qualityScores.length - previousScores.reduce((total, score) => total + score, 0) / previousScores.length) * 10) / 10 : null,
 			trend_basis: qualityTrendBasis,
@@ -13497,37 +14255,58 @@ var EngineService = class {
 			hint: `第 ${violation.location.paragraph} 段`
 		}));
 		const legacy = await this.legacyIssues(snapshot, false);
-		const activity = journal.rows.slice(-5).map((row) => ({
+		const activity = journal.rows.filter((row) => row.op !== "lock_reclaimed").slice(-5).map((row) => ({
 			at: row.at,
 			op: row.op,
 			chapter: row.chapter,
 			status: row.status
 		}));
 		const draftMetrics = snapshot.text === null ? null : countWordMetrics(snapshot.text);
+		const panelReport = buildBookReport({
+			project: snapshot.project,
+			outline: snapshot.outline,
+			outlinePresent: snapshot.outlinePresent,
+			outlineError: snapshot.outlineError,
+			worldbook: snapshot.worldbook,
+			worldbookPresent: snapshot.worldbookPresent,
+			worldbookError: snapshot.worldbookError,
+			world: snapshot.world,
+			chapters: archived,
+			characters: snapshot.characters,
+			timeline: snapshot.timeline,
+			foreshadows: snapshot.foreshadows,
+			relationships: snapshot.relationships,
+			reviews: currentReviews,
+			activity: journal.rows.filter((row) => row.op !== "lock_reclaimed").slice(-8),
+			journal: journal.rows,
+			reviewAttempts: attempts,
+			finalChecks: Object.fromEntries(archived.filter((record) => record.final_check === "pass" || record.final_check === "fail").map((record) => [record.num, record.final_check])),
+			targetChapters: target,
+			minScore: this.config.quality.minScore,
+			dimensionMax: Object.fromEntries(this.rulepack.quality.dimensions.map((dimension) => [dimension.id, dimension.max])),
+			foreshadowDormantAfter: this.rulepack.crosschapter.foreshadow_dormant_after
+		});
+		if (!includeQuality) {
+			const baseScores = archived.map((chapter) => chapter.score);
+			const sorted = [...baseScores].sort((left, right) => left - right);
+			const middle = Math.floor(sorted.length / 2);
+			const median = sorted.length === 0 ? 0 : sorted.length % 2 === 0 ? (sorted[middle - 1] + sorted[middle]) / 2 : sorted[middle];
+			panelReport.quality = {
+				...panelReport.quality,
+				average: baseScores.length === 0 ? 0 : baseScores.reduce((total, score) => total + score, 0) / baseScores.length,
+				median,
+				min: baseScores.length === 0 ? 0 : Math.min(...baseScores),
+				max: baseScores.length === 0 ? 0 : Math.max(...baseScores),
+				last_five: baseScores.slice(-5),
+				trend: null,
+				trend_basis: "insufficient_samples",
+				samples: 0,
+				attempts: 0,
+				dimensions: []
+			};
+		}
 		const bookData = buildPanelBookData({
-			report: buildBookReport({
-				project: snapshot.project,
-				outline: snapshot.outline,
-				outlinePresent: snapshot.outlinePresent,
-				outlineError: snapshot.outlineError,
-				worldbook: snapshot.worldbook,
-				worldbookPresent: snapshot.worldbookPresent,
-				worldbookError: snapshot.worldbookError,
-				world: snapshot.world,
-				chapters: archived,
-				characters: snapshot.characters,
-				timeline: snapshot.timeline,
-				foreshadows: snapshot.foreshadows,
-				relationships: snapshot.relationships,
-				reviews: currentReviews,
-				activity: journal.rows.slice(-8),
-				journal: journal.rows,
-				reviewAttempts: attempts,
-				finalChecks: Object.fromEntries(archived.filter((record) => record.final_check === "pass" || record.final_check === "fail").map((record) => [record.num, record.final_check])),
-				targetChapters: target,
-				minScore: this.config.quality.minScore,
-				foreshadowDormantAfter: this.rulepack.crosschapter.foreshadow_dormant_after
-			}),
+			report: panelReport,
 			project: snapshot.project,
 			worldbook: snapshot.worldbook,
 			world: snapshot.world,
@@ -13538,7 +14317,7 @@ var EngineService = class {
 			stage: snapshot.pipeline.stage,
 			rounds: snapshot.pipeline.rounds,
 			draftWords,
-			lastTenAverage: scores.length === 0 ? 0 : scores.reduce((total, score) => total + score, 0) / scores.length,
+			lastTenAverage: scores.length === 0 ? null : scores.reduce((total, score) => total + score, 0) / scores.length,
 			manuscriptHash: snapshot.pipeline.draft?.content_hash ?? (snapshot.text === null ? null : sha256(snapshot.text)),
 			metrics: draftMetrics,
 			stateErrors: this.stateErrors(snapshot).map((error) => ({
@@ -13558,7 +14337,7 @@ var EngineService = class {
 			num: snapshot.pipeline.chapter,
 			title: stripTitlePrefix(snapshot.plan?.title ?? "") || `第${snapshot.pipeline.chapter}章`,
 			wordCount: draftWords,
-			score: snapshot.review?.total ?? 0,
+			score: snapshot.review?.total ?? null,
 			status: blocking.length > 0 ? "blocked" : "draft",
 			details: (snapshot.pipeline.draft?.summary?.events ?? []).join("；").slice(0, 240)
 		};
@@ -13569,6 +14348,7 @@ var EngineService = class {
 			platform: snapshot.project.platform,
 			chapter: snapshot.pipeline.chapter,
 			stage: snapshot.pipeline.stage,
+			progress,
 			revision: snapshot.pipeline.revision,
 			rounds: snapshot.pipeline.rounds,
 			blocking,
@@ -13589,7 +14369,9 @@ var EngineService = class {
 			finished,
 			chapters: archived,
 			draft,
-			totalWords: archived.reduce((total, chapter) => total + chapter.word_count, 0) + (draft === null ? 0 : draft.wordCount),
+			totalWords: archivedWords + draftWords,
+			archivedWords,
+			draftWords,
 			averageScore: archived.length === 0 ? 0 : archived.reduce((total, chapter) => total + chapter.score, 0) / archived.length,
 			phases: phaseStrip(snapshot.pipeline.stage, finished),
 			book,
@@ -13697,6 +14479,12 @@ var EngineService = class {
 	nextStep(snapshot) {
 		const stage = snapshot.pipeline.stage;
 		const chapter = snapshot.pipeline.chapter;
+		const progress = projectChapterProgress({
+			activeChapter: chapter,
+			stage,
+			archived: snapshot.chapters.chapters.map((record) => record.num),
+			target: snapshot.project.targets.total_chapters
+		});
 		if (snapshot.chapters.chapters.some((record) => record.num === chapter)) return {
 			tool: "novel_amend",
 			args: { path: joinRel(STATE_DIR, STATE_FILES.chapters) },
@@ -13747,8 +14535,7 @@ var EngineService = class {
 			};
 		}
 		const step = STAGE_NEXT[stage];
-		const target = snapshot.project.targets.total_chapters;
-		if (stage === "done" && target !== null && snapshot.chapters.chapters.length >= target) return {
+		if (progress.finished) return {
 			tool: "novel_export",
 			args: { kind: "epub" },
 			reason: "全书已完成；可导出成书，或结束本书"
@@ -14356,6 +15143,7 @@ var EngineService = class {
 			briefStage: extras.briefStage ?? briefStageFor(operation, snapshot.pipeline.stage),
 			draftTitle: composeTitle(snapshot.pipeline.chapter, extras.draftTitle ?? snapshot.pipeline.draft?.title ?? snapshot.plan?.title ?? null, this.rulepack.format.title.pattern),
 			sceneType: extras.sceneType ?? snapshot.pipeline.draft?.scene_type ?? snapshot.plan?.scene_type ?? null,
+			narrator: extras.narrator ?? snapshot.pipeline.draft?.narrator ?? snapshot.plan?.narrator ?? null,
 			summary: extras.summary ?? snapshot.pipeline.draft?.summary ?? snapshot.plan?.summary ?? null,
 			summaryProvided: extras.summaryProvided,
 			summaryOnly: extras.summaryOnly,
@@ -15087,6 +15875,29 @@ const machineWarnings = (machine, acknowledged = []) => machine.violations.filte
 	message: `${violation.detail} (paragraph ${violation.location.paragraph})`
 }));
 /** 0.1.2 archive digests used localeCompare; keep that comparison only for upgrades. */
+const archivedCardSnapshot = (card) => ({
+	title: card.title,
+	scene_type: card.scene_type,
+	target_words: [card.target_words[0], card.target_words[1]],
+	cast: [...card.cast],
+	goal: card.goal,
+	conflict: card.conflict,
+	hook: card.hook,
+	notes: card.notes,
+	archived_at: card.archived_at
+});
+const archivedCardDigest = (card) => `v1:${sha256(stableJson(card))}`;
+const archivedCardRecord = (record) => {
+	const card = record.archive_card;
+	if (card === void 0) return {};
+	return {
+		num: record.num,
+		...card,
+		status: "archived",
+		word_count: record.word_count,
+		score: record.score
+	};
+};
 const legacyStableJson = (value) => {
 	const normalize = (input) => {
 		if (Array.isArray(input)) return input.map(normalize);
@@ -15236,6 +16047,9 @@ const amendProblems = (kind, oldDocument, nextDocument, snapshot, path, archived
 			}
 			if (before.content_hash !== after.content_hash) problems.push(`archived chapter ${String(before.num)} cannot change its content_hash`);
 			if (before.archive_digest !== after.archive_digest) problems.push(`archived chapter ${String(before.num)} cannot change its archive_digest`);
+			if (before.archive_card === void 0 && after.archive_card !== void 0) problems.push(`archived chapter ${String(before.num)} cannot add archive_card through amend`);
+			else if (before.archive_card !== void 0 && (after.archive_card === void 0 || stableJson(before.archive_card) !== stableJson(after.archive_card))) problems.push(`archived chapter ${String(before.num)} cannot change its archive_card`);
+			if (before.archive_card_digest !== after.archive_card_digest) problems.push(`archived chapter ${String(before.num)} cannot change its archive_card_digest`);
 			if (stableJson(before.assigned_ids ?? {}) !== stableJson(after.assigned_ids ?? {})) problems.push(`archived chapter ${String(before.num)} cannot change its assigned_ids`);
 			for (const field of [
 				"title",
@@ -15410,6 +16224,10 @@ const amendProblems = (kind, oldDocument, nextDocument, snapshot, path, archived
 		}
 		const indexed = new Set(snapshot.chapters.chapters.map((record) => record.num));
 		const chaptersUnreadable = snapshot.ledgerErrors.some((error) => error.code === "CHAPTERS_UNREADABLE");
+		if (chaptersUnreadable) {
+			for (const [num, card] of byNum) if (card.status === "archived" && !oldCards.has(num)) problems.push(`cannot verify archived chapter ${num} while chapters.yaml is unreadable; restore the chapter index from backups/ first`);
+			for (const num of archivedChapterNumbers ?? []) if (byNum.get(num)?.status !== "archived") problems.push(`cannot verify archived chapter ${num} while chapters.yaml is unreadable; keep its archived card`);
+		}
 		if (!chaptersUnreadable) {
 			for (const [num, card] of byNum) if (card.status === "archived" && !indexed.has(num)) problems.push(`archived chapter ${num} has a card but is not in the chapter index`);
 		}
@@ -15446,6 +16264,12 @@ const amendProblems = (kind, oldDocument, nextDocument, snapshot, path, archived
 				problems.push(`archived chapter ${record.num} has no previous outline card; restore its archive backup before repairing target_words/cast/archived_at`);
 				continue;
 			}
+			for (const field of [
+				"goal",
+				"conflict",
+				"hook",
+				"notes"
+			]) if (stableJson(before[field]) !== stableJson(card[field])) problems.push(`archived chapter ${record.num} cannot change its ${field}`);
 			if (JSON.stringify(before.target_words) !== JSON.stringify(card.target_words)) problems.push(`archived chapter ${record.num} cannot change its target_words`);
 			const beforeCast = Array.isArray(before.cast) ? before.cast : [];
 			const afterCast = Array.isArray(card.cast) ? card.cast : [];
@@ -15457,6 +16281,27 @@ const amendProblems = (kind, oldDocument, nextDocument, snapshot, path, archived
 			for (const [num, card] of oldCards) if (card.status === "archived") expected.add(num);
 			const missing = [...expected].filter((num) => byNum.get(num)?.status !== "archived");
 			if (missing.length > 0) problems.push(`cannot verify archived cards while chapters.yaml is unreadable; keep archived cards for ${missing.join(", ")}`);
+			for (const [num, before] of oldCards) {
+				if (before.status !== "archived") continue;
+				const card = byNum.get(num);
+				if (card === void 0) continue;
+				if (card.status !== "archived") problems.push(`archived chapter ${num} cannot be changed back to planned`);
+				for (const field of [
+					"title",
+					"scene_type",
+					"word_count",
+					"score",
+					"goal",
+					"conflict",
+					"hook",
+					"notes"
+				]) if (stableJson(before[field]) !== stableJson(card[field])) problems.push(`archived chapter ${num} cannot change its ${field}`);
+				if (JSON.stringify(before.target_words) !== JSON.stringify(card.target_words)) problems.push(`archived chapter ${num} cannot change its target_words`);
+				const beforeCast = Array.isArray(before.cast) ? before.cast : [];
+				const afterCast = Array.isArray(card.cast) ? card.cast : [];
+				if (beforeCast.length !== afterCast.length || afterCast.some((name) => !beforeCast.includes(name))) problems.push(`archived chapter ${num} cannot change its cast`);
+				if (before.archived_at !== card.archived_at && !(before.archived_at === null && typeof card.archived_at === "string")) problems.push(`archived chapter ${num} cannot change archived_at`);
+			}
 		}
 		return problems;
 	}
@@ -15676,16 +16521,17 @@ function diffLines(before, after) {
 const arraySemanticsDescription = (semantics, description) => `[x-semantics: ${semantics}] ${description}`;
 // src/tools/index.ts
 /**
-* Providers sometimes serialize a free-form `json` parameter as a JSON string
-* even when the model intended an object. Accept both wire shapes; an invalid
-* string becomes a machine-code error instead of a raw TypeError.
+* Compatibility helper for already-serialized legacy payloads and dynamic
+* maps. Model-facing schemas are typed and reject strings before this runs;
+* the string branch is kept only for old callers that invoke the adapter
+* directly.
 */
 const asJson = (value, field) => {
 	if (typeof value !== "string") return value;
 	try {
 		return JSON.parse(value);
 	} catch {
-		throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${field} must be a JSON object or a valid JSON string`, `send ${field} as an object, not a malformed string`);
+		throw new EngineInputError(ERROR_CODES.SCHEMA_INVALID, `${field} must be a JSON object`, `send ${field} as an object, not a serialized string`);
 	}
 };
 /** Turn an engine failure into the message shape tools surface. */
@@ -15755,17 +16601,255 @@ const stringArray = (semantics, description) => ({
 	items: { type: "string" },
 	description: arraySemanticsDescription(semantics, description)
 });
+const str = { type: "string" };
+const int = { type: "integer" };
+const num$1 = { type: "number" };
+const bool$1 = { type: "boolean" };
+const nullableInt = { oneOf: [{ type: "integer" }, { type: "null" }] };
+const nullableStr = { oneOf: [{ type: "string" }, { type: "null" }] };
+const required = (value) => ({
+	...value,
+	required: true
+});
+const optional = (value) => {
+	const copy = { ...value };
+	delete copy.required;
+	return copy;
+};
+const arrayOf = (items) => ({
+	type: "array",
+	items
+});
+const objectOf = (properties) => ({
+	type: "object",
+	additionalProperties: false,
+	properties
+});
+const openObject = (description) => ({
+	type: "object",
+	additionalProperties: true,
+	...description === void 0 ? {} : { description }
+});
+const openObjectWith = (properties, description) => ({
+	type: "object",
+	additionalProperties: true,
+	properties,
+	...description === void 0 ? {} : { description }
+});
+const readingProofRef = objectOf({
+	chapter: int,
+	paragraph: required(int),
+	quote: required(str)
+});
+const proofSchema = required(objectOf({
+	opening: required(readingProofRef),
+	middle: required(readingProofRef),
+	ending: required(readingProofRef)
+}));
+const issueSchema = objectOf({
+	id: required(str),
+	severity: required({
+		type: "string",
+		enum: ["blocker", "advisory"]
+	}),
+	dimension: required(str),
+	location: required(str),
+	problem: required(str),
+	fix: required(str),
+	status: required({
+		type: "string",
+		enum: [
+			"open",
+			"fixed",
+			"waived"
+		]
+	}),
+	evidence: str
+});
+const issueUpdateSchema = objectOf({
+	id: required(str),
+	status: required({
+		type: "string",
+		enum: [
+			"open",
+			"fixed",
+			"waived"
+		]
+	}),
+	evidence: str,
+	severity: {
+		type: "string",
+		enum: ["blocker", "advisory"]
+	},
+	dimension: str,
+	location: str,
+	problem: str,
+	fix: str
+});
+const dimensionSchema = objectOf({
+	id: required(str),
+	max: required(int),
+	deductions: required(arrayOf(objectOf({
+		rule: required(str),
+		location: required(str),
+		delta: required(int),
+		note: required(str)
+	})))
+});
+const summarySchema = required(objectOf({
+	events: required(arrayOf(str)),
+	characters_appeared: required(arrayOf(str)),
+	foreshadows: required(objectOf({
+		planted: required(arrayOf(objectOf({
+			key: required(str),
+			title: required(str),
+			description: required(str),
+			anchor: str
+		}))),
+		advanced: required(arrayOf(objectOf({
+			key: required(str),
+			note: required(str),
+			new_info: required(bool$1)
+		}))),
+		resolved: required(arrayOf(str))
+	})),
+	new_elements: required(objectOf({
+		locations: required(arrayOf(str)),
+		abilities: required(arrayOf(str)),
+		artifacts: required(arrayOf(str))
+	})),
+	new_element_anchors: openObject("实体名到正文锚点数组的动态映射；值形状由引擎校验"),
+	resource_changes: required(arrayOf(objectOf({
+		character: required(str),
+		resource: required(str),
+		delta: required(int),
+		reason: required(str)
+	}))),
+	opening: required(str),
+	continuity: required(objectOf({
+		opens_from: required(str),
+		ends_with: required(str)
+	})),
+	hook_strength: required({
+		type: "integer",
+		enum: [
+			1,
+			2,
+			3,
+			4,
+			5
+		]
+	}),
+	pleasure_points: required(arrayOf(str)),
+	plot_advancement: required({
+		type: "string",
+		enum: [
+			"high",
+			"mid",
+			"low"
+		]
+	})
+}));
+const volumeSchema = objectOf({
+	id: str,
+	title: required(str),
+	start_chapter: required(int),
+	end_chapter: required(int),
+	goal: str,
+	arc: str,
+	climax: str,
+	status: {
+		type: "string",
+		enum: [
+			"planned",
+			"writing",
+			"done"
+		]
+	}
+});
+const chapterCardSchema = openObjectWith({
+	num: required(int),
+	volume: nullableInt,
+	title: required(str),
+	scene_type: required({
+		type: "string",
+		enum: SCENE_TYPES
+	}),
+	goal: required(str),
+	conflict: required(str),
+	hook: required(str),
+	cast: arrayOf(str),
+	target_words: required(arrayOf(int)),
+	notes: str,
+	status: {
+		type: "string",
+		enum: ["planned", "archived"]
+	},
+	archived_at: nullableStr,
+	word_count: nullableInt,
+	score: nullableInt
+});
+const dynamicSection = (description) => openObject(description);
+const stateDeltaSchema = required(objectOf({
+	characters: required(dynamicSection("人物名到 {action,reason?,role?,profile?,current_state?,growth?} 的映射")),
+	foreshadows: required(dynamicSection("key 到 {action,title?,anchor?,description?,note?,new_info?} 的映射")),
+	timeline: required(dynamicSection("summary.events 下标到 {action,story_time?,description?,location?,characters?} 的映射")),
+	world: required(dynamicSection("名称到 {action,kind?,description?,layout?,capacity?} 的映射")),
+	relationships: required(dynamicSection("\"甲|乙\" 到 {action,type?,description?,note?} 的映射"))
+}));
+const handoffSchema = objectOf({
+	volume: int,
+	volume_name: str,
+	act: str,
+	act_progress: str
+});
+const worldbookRule = objectOf({
+	name: required(str),
+	description: required(str)
+});
+const worldbookFaction = objectOf({
+	name: required(str),
+	description: required(str),
+	goal: str
+});
+const worldbookLocation = objectOf({
+	name: required(str),
+	description: required(str),
+	layout: str,
+	capacity: int
+});
+const worldbookCharacter = objectOf({
+	name: required(str),
+	role: required(str),
+	description: required(str),
+	arc: str
+});
+const worldbookGlossary = objectOf({
+	term: required(str),
+	definition: required(str)
+});
+const worldbookBackstory = objectOf({
+	time: required(str),
+	event: required(str)
+});
+const worldbookFact = objectOf({
+	alias: required(str),
+	value: required(num$1),
+	unit: required(str),
+	tolerance: num$1,
+	note: str
+});
 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."
+	description: "Project root; omit to use the session binding or the only project."
 };
 const initRoot = {
 	type: "string",
-	description: "Project root for the new project. Passing it creates the project there. When omitted, only the configured projectRoot is used; novel_init does not follow the session binding, workspace discovery or registry active. The created project is bound to the current session on success."
+	description: "New project root; omit to use the configured projectRoot."
 };
 const utilityRoot = {
 	type: "string",
-	description: "Project root for the project-backed mode of this tool. Text-only word_count/diff calls ignore it and do not create a session binding; use a project-backed call when you want to select a book."
+	description: "Project root for project-backed mode; text-only calls ignore it."
 };
 /**
 * The twenty-eight tools are thin adapters: narrow parameters, call one service
@@ -15847,9 +16931,11 @@ function createNovelTools(engine, options = {}) {
 				render: (_args, raw) => {
 					const value = payload(raw);
 					const active = value.active_chapter ?? value.chapter;
-					const where = active === value.chapter ? `第 ${value.chapter} 章` : `当前第 ${active} 章 · 查询第 ${value.chapter} 章字数`;
+					const progressLabel = value.progress?.label ?? `第 ${value.chapter} 章 · 阶段 ${value.stage}`;
 					return text([
-						`《${value.project.title}》 ${where} · ${value.stage}`,
+						`《${value.project.title}》`,
+						`进度：${progressLabel}`,
+						...active === value.chapter ? [] : [`字数查询：第 ${value.chapter} 章（活动章第 ${active} 章）`],
 						...value.selection === void 0 ? [] : [`项目根 ${value.selection.root} · 选择来源 ${value.selection.source}`],
 						...value.rounds === void 0 ? [] : [`轮次：评审 ${value.rounds.review} / 修订 ${value.rounds.revise} / 校验 ${value.rounds.check}`],
 						value.blocking.length === 0 ? "门控：全部通过" : `门控：${value.blocking.length} 条阻塞`,
@@ -15908,11 +16994,19 @@ function createNovelTools(engine, options = {}) {
 				},
 				constraints: stringArray("replace", "P1 constraints; supplied list replaces the plan list."),
 				characters: {
-					type: "json",
+					...arrayOf(objectOf({
+						name: required(str),
+						role: required(str),
+						current_state: required(str)
+					})),
 					description: arraySemanticsDescription("replace", "P1 cast; supplied list replaces the cast.")
 				},
 				locations: {
-					type: "json",
+					...arrayOf(objectOf({
+						name: required(str),
+						layout: required(str),
+						capacity: required(num$1)
+					})),
 					description: arraySemanticsDescription("replace", "P1 locations; supplied list replaces them.")
 				},
 				continuity_notes: stringArray("replace", "P1 continuity notes; supplied list replaces them."),
@@ -15965,8 +17059,14 @@ function createNovelTools(engine, options = {}) {
 					description: arraySemanticsDescription("replace", "Plan [min,max] word target.")
 				},
 				cast: {
-					type: "json",
-					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.")
+					...arrayOf(objectOf({
+						name: required(str),
+						entry_state: str,
+						goal: str,
+						knowledge: arrayOf(str),
+						exit_change: str
+					})),
+					description: arraySemanticsDescription("replace", "Optional 1–8 characters on stage this chapter; names must exist in the P1 world plan or the character ledger.")
 				},
 				project_root: root
 			},
@@ -16010,9 +17110,8 @@ function createNovelTools(engine, options = {}) {
 					required: true
 				},
 				summary: {
-					type: "json",
-					required: true,
-					description: "The ten-field chapter summary required by PG-05. Pass an object (events, characters_appeared, foreshadows, new_elements, resource_changes, opening, continuity, hook_strength, pleasure_points, plot_advancement); a JSON string is accepted too."
+					...summarySchema,
+					description: "The ten-field chapter summary required by PG-05; send a JSON object, not a JSON string."
 				},
 				project_root: root
 			},
@@ -16036,12 +17135,12 @@ function createNovelTools(engine, options = {}) {
 					required: true
 				},
 				dimensions: {
-					type: "json",
+					...arrayOf(dimensionSchema),
 					required: true,
 					description: arraySemanticsDescription("replace", "Fifteen scored dimensions.")
 				},
 				issues: {
-					type: "json",
+					...arrayOf(issueSchema),
 					description: arraySemanticsDescription("replace", "Review issue list.")
 				},
 				total: {
@@ -16050,8 +17149,7 @@ function createNovelTools(engine, options = {}) {
 					description: "150 - Σdelta, the same number the review reports."
 				},
 				proof: {
-					type: "json",
-					required: true,
+					...proofSchema,
 					description: arraySemanticsDescription("replace", "Three reading-proof quotes.")
 				},
 				project_root: root
@@ -16078,20 +17176,24 @@ function createNovelTools(engine, options = {}) {
 					type: "string",
 					description: "Full revised text; mutually exclusive with patch."
 				},
-				patch: {
-					type: "json",
-					description: "Patch mode: {expected_hash, edits:[{old_text,new_text,occurrence?}]}; edits must be unique unless occurrence is set."
-				},
+				patch: objectOf({
+					expected_hash: required(str),
+					edits: required(arrayOf(objectOf({
+						old_text: required(str),
+						new_text: required(str),
+						occurrence: int
+					})))
+				}),
 				summary: {
-					type: "json",
+					...optional(summarySchema),
 					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",
+					...arrayOf(issueUpdateSchema),
 					description: arraySemanticsDescription("replace", "Updated issue statuses and evidence for PG-08.")
 				},
 				proof: {
-					type: "json",
+					...optional(proofSchema),
 					description: arraySemanticsDescription("replace", "Three quotes from the revised text; required unless this is a summary-only repair. PG-09 verifies them.")
 				},
 				project_root: root
@@ -16117,7 +17219,24 @@ function createNovelTools(engine, options = {}) {
 				},
 				scope: stringArray("replace", "Requested check scopes; supplied list replaces the request."),
 				semantic: {
-					type: "json",
+					...arrayOf(objectOf({
+						id: required({
+							type: "string",
+							enum: [
+								"L2-SCENE-ANCHOR",
+								"L2-CHARACTER-STATE",
+								"L2-CAUSALITY",
+								"L2-VOICE",
+								"L2-POV"
+							]
+						}),
+						verdict: required({
+							type: "string",
+							enum: ["pass", "fail"]
+						}),
+						evidence: required(str),
+						note: required(str)
+					})),
 					required: true,
 					description: arraySemanticsDescription("replace", "Exactly the five P6 semantic items, each with a verbatim evidence quote.")
 				},
@@ -16146,10 +17265,10 @@ function createNovelTools(engine, options = {}) {
 					required: true
 				},
 				state_delta: {
-					type: "json",
-					required: true
+					...stateDeltaSchema,
+					description: "Five ledger sections; entry values are dynamic maps validated by the engine."
 				},
-				handoff: { type: "json" },
+				handoff: handoffSchema,
 				project_root: root
 			},
 			output: {
@@ -16259,7 +17378,7 @@ function createNovelTools(engine, options = {}) {
 					]
 				},
 				content: {
-					type: "json",
+					...openObject("按 path 的完整替换文档；根必须是映射。"),
 					required: true
 				},
 				reason: {
@@ -16402,7 +17521,7 @@ function createNovelTools(engine, options = {}) {
 					description: "Require a chapter card before P2/P3."
 				},
 				volumes: {
-					type: "json",
+					...arrayOf(volumeSchema),
 					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: {
@@ -16432,15 +17551,25 @@ function createNovelTools(engine, options = {}) {
 			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",
+					...objectOf({
+						premise: str,
+						logline: str,
+						themes: stringArray("replace", "Book themes; supplied list replaces the theme list."),
+						tone: str,
+						pov: str,
+						audience: str,
+						selling_points: stringArray("replace", "Selling points; supplied list replaces the list."),
+						ending: str,
+						strict: bool$1
+					}),
 					description: "Optional partial book blueprint patch."
 				},
 				volumes: {
-					type: "json",
+					...arrayOf(volumeSchema),
 					description: arraySemanticsDescription("upsert", "Volume list: [{title,start_chapter,end_chapter,goal?,arc?,climax?,status?}]. Upserts by title; omitted volumes are kept.")
 				},
 				chapters: {
-					type: "json",
+					...arrayOf(chapterCardSchema),
 					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: {
@@ -16507,31 +17636,31 @@ function createNovelTools(engine, options = {}) {
 				premise: { type: "string" },
 				setting: { type: "string" },
 				rules: {
-					type: "json",
+					...arrayOf(worldbookRule),
 					description: arraySemanticsDescription("replace", "Rules section list.")
 				},
 				factions: {
-					type: "json",
+					...arrayOf(worldbookFaction),
 					description: arraySemanticsDescription("replace", "Factions section list.")
 				},
 				locations: {
-					type: "json",
+					...arrayOf(worldbookLocation),
 					description: arraySemanticsDescription("replace", "Locations section list.")
 				},
 				characters: {
-					type: "json",
+					...arrayOf(worldbookCharacter),
 					description: arraySemanticsDescription("replace", "Characters section list.")
 				},
 				glossary: {
-					type: "json",
+					...arrayOf(worldbookGlossary),
 					description: arraySemanticsDescription("replace", "Glossary section list.")
 				},
 				backstory: {
-					type: "json",
+					...arrayOf(worldbookBackstory),
 					description: arraySemanticsDescription("replace", "Backstory section list.")
 				},
 				facts: {
-					type: "json",
+					...arrayOf(worldbookFact),
 					description: arraySemanticsDescription("replace", "Declared numeric canon: [{alias,value,unit,tolerance?,note?}].")
 				},
 				themes: stringArray("replace", "Worldbook themes; supplied list replaces the list."),
@@ -16679,6 +17808,9 @@ const NEXT_DETAILS = {
 	novel_rollback: "回退到更早阶段重建当前章。",
 	novel_amend: "按明确的修复理由修正一份状态文档。",
 	novel_audit: "先查看事务日志，确认并恢复损坏的历史。",
+	novel_restore: "按备份清单恢复损坏的状态文档或当前章。",
+	novel_state: "查看状态文档、大纲、世界观或历史原文。",
+	novel_pipeline: "按当前阶段领取下一步工具与参数。",
 	novel_export: "导出成书或书级提案。",
 	novel_diff: "对比当前正文与上一版或给定文本。",
 	novel_word_count: "按引擎字数口径核对正文长度。"
@@ -16803,9 +17935,11 @@ const failure = (error) => {
 const formatPercent = (value) => value === null || value === void 0 ? "—" : `${Math.round(value * 1e3) / 10}%`;
 const statusText = async (engine) => {
 	const { data } = await engine.getStatus({});
+	const progressLabel = data.progress?.label ?? `第 ${data.chapter} 章 · 阶段 ${data.stage}`;
 	return [
 		`《${data.project.title}》 ${data.project.genre} · ${data.project.platform}`,
-		`第 ${data.chapter} 章 · 阶段 ${data.stage}`,
+		`进度：${progressLabel}`,
+		...data.chapter === data.active_chapter ? [] : [`字数查询：第 ${data.chapter} 章（活动章第 ${data.active_chapter} 章）`],
 		...data.selection === void 0 ? [] : [`项目根 ${data.selection.root} · 选择来源 ${data.selection.source}`],
 		`轮次 评审 ${data.rounds.review} / 修订 ${data.rounds.revise} / 校验 ${data.rounds.check}`,
 		data.metrics === null ? "字数 —" : `字数 ${data.metrics.total_word_count}（汉字 ${data.metrics.cjk_chars} + 标点 ${data.metrics.punctuation_chars}，含标点）`,
@@ -16852,11 +17986,13 @@ function createCommands(engine, host = {}) {
 				case "next": {
 					const { data } = await engine.advise({});
 					const reason = NEXT_DETAILS[data.tool] ?? data.reason;
-					return ok(`下一步：${data.tool}\n理由：${reason}${data.blocking.length === 0 ? "" : `\n阻塞 ${data.blocking.length} 条`}`);
+					return ok(`进度：${data.progress?.label ?? `第 ${data.chapter} 章 · 阶段 ${data.stage}`}\n下一步：${data.tool}\n理由：${reason}${data.blocking.length === 0 ? "" : `\n阻塞 ${data.blocking.length} 条`}`);
 				}
 				case "stats": {
 					const stats = await engine.stats({});
-					return ok(`章节 ${stats.chapters} 章 · 总字数 ${stats.totalWords} · 平均分 ${stats.averageScore} · 未回收伏笔 ${stats.openForeshadows} · 大纲 ${stats.totalCards} 卡（规划覆盖 ${formatPercent(stats.outlineCoverage)} · 归档覆盖 ${formatPercent(stats.archivedCoverage)}${stats.missingCards > 0 ? ` · 缺卡 ${stats.missingCards}` : ""}）· 蓝图 ${stats.blueprintReady ? "就绪" : "未就绪"} · 严格 ${stats.strictOutline ? "开" : "关"} · 目标 ${stats.targetChapters ?? "未设"} 章 · 世界观 ${stats.worldbookEntries} 条 · revision ${stats.revision} · 规则包 ${stats.rulepack}`);
+					const chapterError = (stats.state_errors ?? []).find((error) => error.path === "state/chapters.yaml");
+					if (chapterError !== void 0) return bad(`章节索引不可读（${chapterError.code}）：${chapterError.message}\n修复前不提供 0 值统计；先 novel_amend state/chapters.yaml 或从 backups/ 恢复。`);
+					return ok(`章节 ${stats.chapters} 章 · 总字数 ${stats.totalWords}（已归档 ${stats.archivedWords} + 草稿 ${stats.draftWords}） · 平均分 ${stats.averageScore} · 未回收伏笔 ${stats.openForeshadows} · 大纲 ${stats.totalCards} 卡（规划覆盖 ${formatPercent(stats.outlineCoverage)} · 归档覆盖 ${formatPercent(stats.archivedCoverage)}${stats.missingCards > 0 ? ` · 缺卡 ${stats.missingCards}` : ""}）· 蓝图 ${stats.blueprintReady ? "就绪" : "未就绪"} · 严格 ${stats.strictOutline ? "开" : "关"} · 目标 ${stats.targetChapters ?? "未设"} 章 · 世界观 ${stats.worldbookEntries} 条 · revision ${stats.revision} · 规则包 ${stats.rulepack}${stats.partial ?? false ? " · 部分状态不可读" : ""}`);
 				}
 				case "outline": {
 					const status = await engine.getStatus({});
@@ -16886,7 +18022,7 @@ function createCommands(engine, host = {}) {
 				case "report": {
 					const { data } = await engine.report({});
 					return ok([
-						`进度：${data.progress.archived}/${data.progress.target ?? "—"} 章 · ${data.progress.words} 字 · ${data.progress.percent}%`,
+						`进度：${data.progress.archived}/${data.progress.target ?? "—"} 章 · ${data.progress.words} 字 · ${data.progress.percent === null ? "—" : `${data.progress.percent}%`}`,
 						`大纲：${data.outline.planned} 计划 / ${data.outline.archived} 归档 · 漂移 ${data.outline.drift.length} 项`,
 						`质量：均分 ${data.quality.average} · 中位 ${data.quality.median} · 趋势 ${data.quality.trend === null ? "—" : `${data.quality.trend >= 0 ? "+" : ""}${data.quality.trend}`} · ${data.quality.samples} 章样本 / ${data.quality.attempts} 次评审`,
 						`伏笔：未回收 ${data.foreshadows.open} · 逾期 ${data.foreshadows.overdue}`,
@@ -17000,8 +18136,10 @@ function createCommands(engine, host = {}) {
 				}
 				case "resume": {
 					const { data } = await engine.resumePrompt({});
-					if (data.text === null) return bad("当前项目没有可续写的下一步；先用 /novel status 查看项目状态。");
-					return ok(data.text);
+					if (data.text !== null) return ok(data.text);
+					const status = await engine.getStatus({});
+					if (status.data.progress?.finished === true) return ok(status.data.progress.resume);
+					return bad("当前项目没有可续写的下一步；先用 /novel status 查看项目状态。");
 				}
 				case "admin": {
 					if (rest.length === 0) return ok(adminHelp());
@@ -17061,7 +18199,9 @@ function createCommands(engine, host = {}) {
 				if (invocation.signal.aborted) return bad("已取消");
 				try {
 					const stats = await engine.stats({});
-					return ok(`章节 ${stats.chapters} 章 · 总字数 ${stats.totalWords} · 平均分 ${stats.averageScore} · 未回收伏笔 ${stats.openForeshadows} · 大纲 ${stats.totalCards} 卡（规划覆盖 ${formatPercent(stats.outlineCoverage)} · 归档覆盖 ${formatPercent(stats.archivedCoverage)}${stats.missingCards > 0 ? ` · 缺卡 ${stats.missingCards}` : ""}）· 蓝图 ${stats.blueprintReady ? "就绪" : "未就绪"} · 严格 ${stats.strictOutline ? "开" : "关"} · 目标 ${stats.targetChapters ?? "未设"} 章 · 世界观 ${stats.worldbookEntries} 条 · revision ${stats.revision} · 规则包 ${stats.rulepack}`);
+					const chapterError = (stats.state_errors ?? []).find((error) => error.path === "state/chapters.yaml");
+					if (chapterError !== void 0) return bad(`章节索引不可读（${chapterError.code}）：${chapterError.message}\n修复前不提供 0 值统计；先 novel_amend state/chapters.yaml 或从 backups/ 恢复。`);
+					return ok(`章节 ${stats.chapters} 章 · 总字数 ${stats.totalWords}（已归档 ${stats.archivedWords} + 草稿 ${stats.draftWords}） · 平均分 ${stats.averageScore} · 未回收伏笔 ${stats.openForeshadows} · 大纲 ${stats.totalCards} 卡（规划覆盖 ${formatPercent(stats.outlineCoverage)} · 归档覆盖 ${formatPercent(stats.archivedCoverage)}${stats.missingCards > 0 ? ` · 缺卡 ${stats.missingCards}` : ""}）· 蓝图 ${stats.blueprintReady ? "就绪" : "未就绪"} · 严格 ${stats.strictOutline ? "开" : "关"} · 目标 ${stats.targetChapters ?? "未设"} 章 · 世界观 ${stats.worldbookEntries} 条 · revision ${stats.revision} · 规则包 ${stats.rulepack}${stats.partial ?? false ? " · 部分状态不可读" : ""}`);
 				} catch (error) {
 					return failure(error);
 				}
@@ -17127,10 +18267,34 @@ function createSkill() {
 	};
 }
 // src/remote/index.ts
-/** Build the payload for one optional panel query root. */
-async function panelPayload(engine, root) {
+const SECTION_NAMES = /* @__PURE__ */ new Set([
+	"overview",
+	"chapters",
+	"characters",
+	"foreshadows",
+	"timeline",
+	"relationships",
+	"worldbook",
+	"quality",
+	"quality_detail",
+	"health",
+	"chapter_detail"
+]);
+/** Build the payload for one optional panel query root; section is additive. */
+async function panelPayload(engine, root, section, query = {}, lean = false) {
+	if (section !== void 0 && SECTION_NAMES.has(section)) return {
+		...await engine.panelSection({
+			...root === void 0 ? {} : { root },
+			section,
+			query
+		}),
+		schemaVersion: 6
+	};
 	return {
-		...await engine.panelBundle(root === void 0 ? {} : { root }),
+		...await engine.panelBundle({
+			...root === void 0 ? {} : { root },
+			lean
+		}),
 		schemaVersion: 6
 	};
 }
@@ -17143,6 +18307,34 @@ const queryRoot = (url) => {
 		return;
 	}
 };
+const queryPanel = (url) => {
+	if (url === void 0 || url === "") return { query: {} };
+	try {
+		const parsed = new URL(url, "http://panel.local");
+		const section = parsed.searchParams.get("section") ?? void 0;
+		const query = {};
+		for (const key of [
+			"search",
+			"status",
+			"scene",
+			"sort",
+			"cursor"
+		]) {
+			const value = parsed.searchParams.get(key);
+			if (value !== null && value !== "") query[key] = value;
+		}
+		const limit = parsed.searchParams.get("limit");
+		if (limit !== null && /^\d+$/.test(limit)) query.limit = Number(limit);
+		const chapter = parsed.searchParams.get("chapter");
+		if (chapter !== null && /^\d+$/.test(chapter)) query.chapter = Number(chapter);
+		return section === void 0 ? { query } : {
+			section,
+			query
+		};
+	} catch {
+		return { query: {} };
+	}
+};
 const denyAll = () => 503;
 const rejectionText = {
 	401: "unauthorized",
@@ -17169,7 +18361,24 @@ function panelHandler(engine, guard = denyAll) {
 			return;
 		}
 		try {
-			const payload = await panelPayload(engine, queryRoot(request.url));
+			const { section, query } = queryPanel(request.url);
+			let lean = false;
+			try {
+				lean = new URL(request.url ?? "", "http://panel.local").searchParams.get("lean") === "1";
+			} catch {}
+			const payload = await panelPayload(engine, queryRoot(request.url), section, query, lean);
+			const etag = typeof payload.etag === "string" ? payload.etag : null;
+			if (etag !== null) {
+				response.setHeader("etag", `"${etag}"`);
+				const ifNoneMatch = request.headers?.["if-none-match"];
+				const candidate = Array.isArray(ifNoneMatch) ? ifNoneMatch[0] : ifNoneMatch;
+				if (candidate === `"${etag}"` || candidate === etag) {
+					response.statusCode = 304;
+					response.setHeader("cache-control", "no-store");
+					response.end("");
+					return;
+				}
+			}
 			const body = method === "HEAD" ? "" : JSON.stringify(payload);
 			response.statusCode = 200;
 			response.setHeader("content-type", "application/json; charset=utf-8");
@@ -17274,7 +18483,7 @@ const DEFAULT_RULEPACK = {
 		},
 		period_density: {
 			min: 1.5,
-			max: 8
+			max: 10
 		},
 		ellipsis_run: {
 			max: 1,
@@ -17483,7 +18692,34 @@ function compileRulepack(raw) {
 	}
 	const genres = object(root.genres, "genres");
 	knownKeys(genres, GENRES, "genres");
-	for (const name of GENRES) knownKeys(object(genres[name], `genres.${name}`), ["note"], `genres.${name}`);
+	for (const name of GENRES) {
+		const entry = object(genres[name], `genres.${name}`);
+		knownKeys(entry, ["note", "profile"], `genres.${name}`);
+		if (entry.profile !== void 0) {
+			const profile = object(entry.profile, `genres.${name}.profile`);
+			knownKeys(profile, [
+				"period_density",
+				"water_words",
+				"pleasure_density"
+			], `genres.${name}.profile`);
+			if (profile.period_density !== void 0) {
+				const density = object(profile.period_density, `genres.${name}.profile.period_density`);
+				knownKeys(density, ["min", "max"], `genres.${name}.profile.period_density`);
+				const min = num(density.min, `genres.${name}.profile.period_density.min`);
+				const max = num(density.max, `genres.${name}.profile.period_density.max`);
+				if (min < 0 || max < 0) invalid(`genres.${name}.profile.period_density must be non-negative`);
+				if (max > 100) invalid(`genres.${name}.profile.period_density.max must not exceed 100 per 100 chars`);
+				if (min > max) invalid(`genres.${name}.profile.period_density.min must not exceed max`);
+			}
+			if (profile.water_words !== void 0) {
+				const value = num(profile.water_words, `genres.${name}.profile.water_words`);
+				if (value < 0 || value > 1) invalid(`genres.${name}.profile.water_words must be 0..1`);
+			}
+			if (profile.pleasure_density !== void 0) {
+				if (num(profile.pleasure_density, `genres.${name}.profile.pleasure_density`) <= 0) invalid(`genres.${name}.profile.pleasure_density must be > 0`);
+			}
+		}
+	}
 	section("crosschapter", [
 		"duplicate_similarity",
 		"duplicate_advisory",
@@ -17567,7 +18803,7 @@ function compileRulepack(raw) {
 	textList(array(conclusionFirst.causals, "lexicon.conclusion_first.causals"), "lexicon.conclusion_first.causals");
 	for (const genre of GENRES) {
 		const guide = object(pack.genres[genre], `genres.${genre}`);
-		knownKeys(guide, ["note"], `genres.${genre}`);
+		knownKeys(guide, ["note", "profile"], `genres.${genre}`);
 		if (typeof guide.note !== "string") invalid(`genres.${genre}.note must be a string`);
 	}
 	const nonNegative = (value, path) => {
@@ -17837,4 +19073,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_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 };
+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, PANEL_VERSION, 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, projectChapterProgress, projectChapters, projectGates, projectSummary, renderBlurb, renderCover, renderEpubChapter, renderMarkdown, renderPlainText, renderProposal, reviewFile, reviewHistoryFile, verifyReference };