dsh-novel-write-engine 0.2.6 → 0.2.8

package/lib/index.js

@@ -308,6 +308,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 = [
@@ -2528,7 +2555,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) {
@@ -3218,7 +3251,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 +3414,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 +3422,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 +3437,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;
@@ -4305,12 +4345,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,
@@ -5485,9 +5551,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 +5645,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`);
@@ -5595,7 +5658,7 @@ function applyStateDelta(input) {
 			"profile",
 			"current_state",
 			"growth"
-		]) if (declared[field] !== void 0 && !isRecord(declared[field])) fail$1(`characters.${name}.${field} must be an object; expected ${field === "current_state" ? "{\"resources\":{\"港币\":3},\"status\":\"...\"}" : field === "profile" ? "{\"age\":31,\"occupation\":\"...\"}" : "{\"change\":\"...\",\"status_change\":\"...\"}"}`);
+		]) if (declared[field] !== void 0 && !isRecord(declared[field])) fail$1(`characters.${name}.${field} must be an object; expected ${field === "current_state" ? "{\"resources\":{\"资源名\":3},\"status\":\"...\"}" : field === "profile" ? "{\"age\":31,\"occupation\":\"...\"}" : "{\"change\":\"...\",\"status_change\":\"...\"}"}`);
 		if (declared.growth !== void 0) {
 			const growth = declared.growth;
 			for (const field of ["change", "status_change"]) if (typeof growth[field] !== "string" || growth[field].trim() === "") fail$1(`characters.${name}.growth.${field} must be a non-empty string`);
@@ -5605,16 +5668,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 +5693,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 +5876,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, {
@@ -6330,8 +6397,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 +6412,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: [
@@ -8015,11 +8082,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");
@@ -8363,12 +8427,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 +8553,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 },
@@ -10206,6 +10328,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 +10357,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 },
@@ -10540,6 +10669,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 +10685,7 @@ var EngineService = class {
 			data: {
 				stage: snapshot.pipeline.stage,
 				chapter: snapshot.pipeline.chapter,
+				progress,
 				tool: next.tool,
 				args: next.args,
 				reason: next.reason,
@@ -10650,7 +10786,7 @@ var EngineService = class {
 			} catch {}
 			if (oldChecks > 0) issues.push({
 				code: "LEGACY_CHECK_FORMAT",
-				detail: `${oldChecks} 章 check 是 0.2.0 旧格式（advisory 混在 violations）；重新跑 novel_check 或按 docs/0.2.3-plan.md 标记`
+				detail: `${oldChecks} 章 check 是 0.2.0 旧格式（advisory 混在 violations）；重新跑 novel_check 或按 0.2.3 迁移说明标记`
 			});
 		}
 		const hints = /* @__PURE__ */ new Map();
@@ -10751,7 +10887,12 @@ var EngineService = class {
 			id: "pipeline",
 			severity: "ok",
 			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}`,
@@ -10943,7 +11084,7 @@ var EngineService = class {
 			severity: "warning",
 			title: "旧数据升级提示",
 			detail: `${legacy.length} 类旧数据需要解释或人工补齐：${legacy.slice(0, 3).map((issue) => `${issue.code}（${issue.detail}）`).join("；")}`,
-			hint: "这是只读审计，不会自动改历史；按 docs/0.2.3-plan.md WP0 处理，补 anchor/role 前先核对原文"
+			hint: "这是只读审计，不会自动改历史；按 0.2.3 的 WP0 处理，补 anchor/role 前先核对原文"
 		});
 		const locked = await store.exists(LOCK_FILE);
 		add({
@@ -11124,7 +11265,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 +11283,7 @@ var EngineService = class {
 				projectPresent: true,
 				chapter: snapshot.pipeline.chapter,
 				stage: snapshot.pipeline.stage,
+				progress,
 				archived: snapshot.chapters.chapters.length,
 				target,
 				finished,
@@ -11235,7 +11383,7 @@ var EngineService = class {
 						reason: "no_change 必填；created/updated 建议写",
 						role: "protagonist | supporting | antagonist | extra（可选）",
 						profile: "object（可选）",
-						current_state: "object（可选，如 {\"resources\":{\"港币\":-3}}）"
+						current_state: "object（可选，如 {\"resources\":{\"资源名\":-3}}）"
 					} },
 					foreshadows: { "<summary.planted.key 或 FS-xxx>": {
 						action: "created | updated | no_change",
@@ -11265,27 +11413,27 @@ var EngineService = class {
 				},
 				examples: [{
 					summary_excerpt: {
-						characters_appeared: ["陈嘉树"],
+						characters_appeared: ["角色甲"],
 						foreshadows: {
 							planted: [],
 							advanced: ["FS-001"],
 							resolved: []
 						}
 					},
-					characters: { 陈嘉树: {
+					characters: { 角色甲: {
 						action: "updated",
-						current_state: { resources: { 港币: -3 } }
+						current_state: { resources: { 资源名: -3 } }
 					} },
 					foreshadows: { "FS-001": {
 						action: "updated",
-						note: "欠条被收回",
+						note: "债务已结清",
 						new_info: true
 					} }
 				}, {
 					summary_excerpt: {
 						events: ["收到信"],
 						new_elements: {
-							locations: ["旧码头"],
+							locations: ["地点甲"],
 							abilities: [],
 							artifacts: []
 						}
@@ -11295,31 +11443,31 @@ var EngineService = class {
 						story_time: "Day 3 清晨",
 						description: "收到信"
 					} },
-					world: { 旧码头: {
+					world: { 地点甲: {
 						action: "created",
 						kind: "location",
-						description: "退潮时露出石阶"
+						description: "地点说明"
 					} }
 				}],
 				linked_example: {
 					summary: {
-						characters_appeared: ["陈嘉树"],
+						characters_appeared: ["角色甲"],
 						new_elements: {
-							locations: ["旧码头"],
+							locations: ["地点甲"],
 							abilities: [],
 							artifacts: []
 						},
 						events: ["收到信"]
 					},
 					delta: {
-						characters: { 陈嘉树: {
+						characters: { 角色甲: {
 							action: "no_change",
 							reason: "本章无变化"
 						} },
-						world: { 旧码头: {
+						world: { 地点甲: {
 							action: "created",
 							kind: "location",
-							description: "退潮时露出石阶"
+							description: "地点说明"
 						} },
 						timeline: { "0": {
 							action: "created",
@@ -11535,6 +11683,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)
 				});
@@ -12863,12 +13012,13 @@ 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 }
 		}) };
 		return {
 			projects,
@@ -12888,12 +13038,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 +13054,17 @@ 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 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}`,
@@ -13406,15 +13562,32 @@ var EngineService = class {
 		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 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 journalTail = journal.rows[journal.rows.length - 1];
+		const journalKey = sha256(stableJson({
+			rows: journal.rows.length,
+			tail: journalTail === void 0 ? null : [
+				journalTail.seq,
+				journalTail.at,
+				journalTail.status
+			],
+			blocking: journalBlocking
+		}));
+		const panelCacheKey = `${snapshot.root}:${snapshot.pipeline.revision}:${pending.state}:${stateErrorCount}:${snapshot.outlineError ?? ""}:${snapshot.worldbookError ?? ""}:${JSON.stringify(snapshot.briefs)}:${journalKey}`;
+		const cachedPanel = this.panelCache.get(snapshot.root);
+		if (cachedPanel?.key === panelCacheKey) return cachedPanel.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);
@@ -13569,6 +13742,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 +13763,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 +13873,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 +13929,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 +14537,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,
@@ -15446,6 +15628,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 +15645,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;
 	}
@@ -15847,9 +16056,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} 条阻塞`,
@@ -16803,9 +17014,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 +17065,11 @@ 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}`);
+					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}`);
 				}
 				case "outline": {
 					const status = await engine.getStatus({});
@@ -17000,8 +17213,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 +17276,7 @@ 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}`);
+					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}`);
 				} catch (error) {
 					return failure(error);
 				}
@@ -17837,4 +18052,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, 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 };