dsh-novel-write-engine 0.2.7 → 0.2.8

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.2.8
+
+0.2.8 是边界与可信性版本，不改工具、阶段、门控、schema、导出或配置键。
+
+### Fixed
+
+- **章节边界读模型**：归档第 N 章后 `pipeline.chapter` 指向 N+1、`stage` 仍为 `done`，旧读面把它拼成“当前第 N+1 章，阶段 done”。新增 `ChapterProgress` 单一投影，`/novel status`、`/novel resume`、`novel_status`、`novel_pipeline`、`novel_guide`、`novel_doctor`、面板摘要与复制续写指令统一显示“第 N 章已归档；下一章第 N+1 章从 P1 开始”。全书达到目标后 `finished=true`，引擎续写文本返回 `null`；`/novel resume` 改为显示“全书已完成”，不再把它当成故障态。
+- **备份路径安全**：`backups/` 改用 `FsStore.ensureDir` + `safePath` 创建和解析，符号链接目录返回 `ENGINE_PATH_ESCAPE`，项目外零写入；备份 staging 写入前重复检查项目根，避免删除根后被 `mkdir` 重建；备份列表/retention 跳过 `backups/` 下的符号链接子项，不再因一个用户文件整体失败。
+- **叙述者别名**：新增 `src/domain/narrator.ts`，PG-05、`state_delta` 的存在性与 locks 取证共用 `isNarratorAlias`；`narrator: "林砚（第一人称）"` 不再因为正文只写“我”而卡在 PG-05 或归档；只接受第一人称“我”，排除第三人称与无关括号引号，locks 优先非对白段落。
+- **面板健康缓存**：`panelCacheKey` 纳入 journal 行数、末尾行与 `journalBlocking` 摘要，外部 ledger 改动或 journal 追加后不再返回旧 `health.ok`/旧 activity。
+- **归档卡字段**：归档卡的 `goal/conflict/hook/notes` 与 `title/scene_type/target_words/cast` 一样不可改写；省略字段仍保留原值。`novel_amend` 在 `chapters.yaml` 不可读时也以旧大纲卡为证据，不能借损坏窗口改写。
+- **created growth**：`state_delta` 的 `created` 角色不再丢弃已声明的 `growth`，按当前章写入 ledger。
+
+### Changed
+
+- `stats()` 与 `/novel stats` 的 `totalWords` 统一为“归档 + 活动草稿”，并新增 `archivedWords`/`draftWords` 拆分；面板同步新增 `archivedWords`/`draftWords`，头部总字数与命令口径一致。
+- 面板九阶段名称改为与 README/DESIGN 一致：P7 状态同步、P8 终审、P9 归档；教程注明首次章卡提交默认 strict、纯文本 `novel_word_count`/`novel_diff` 不绑定会话。
+
+### Tests
+
+- 91 个测试文件 / 923 项测试全绿；覆盖率 93.55 / 89.23 / 98.14 / 93.55，逐文件门禁通过。新增归档边界、完结续写与命令文案、P8 brief 回归、面板缓存、字数拆分、备份符号链接、第一人称归档、created growth、归档字段保护、损坏 chapters 下的 amend 保护、空 legacy 卡重交、locks 对白取证、提交叙述者优先级回归。
+
+### Migration
+
+- `progress`、`archivedWords`、`draftWords` 均为 additive 字段；`REMOTE_VERSION` 保持 6，旧标签页刷新即可。
+- 无 schema、工具、阶段、门控、导出或配置键变更；项目文件不需要迁移。
+
 ## 0.2.7
 
 0.2.7 是通用性与发布边界版本，不改工具、阶段、门控、schema 或规则阈值。

package/README.md

@@ -19,9 +19,9 @@
 </div>
 
 > [!IMPORTANT]
-> 当前版本 **0.2.7**。宿主范围：DSH `>=0.2.1-rc.2 <0.3.0-0`；Node `>=24.9.0`。
+> 当前版本 **0.2.8**。宿主范围：DSH `>=0.2.1-rc.2 <0.3.0-0`；Node `>=24.9.0`。
 >
-> 0.2.7 是通用性与发布边界版本：没有改工具、阶段、门控、schema 或规则阈值。它把产品示例、任务书和测试夹具里的具体书稿痕迹清理干净，并补上三题材归档矩阵与发布面隐私守卫。历史版本的内部方案与验收稿留在对应发布 tag，不再复制进 `main`。
+> 0.2.8 是边界与可信性版本：修正归档后“下一章被误标为 done”的读模型、备份路径符号链接逃逸、PG-05 与归档叙述者别名不一致、面板健康缓存假绿、完结书仍生成续写指令；同时保护归档章卡字段并修复 created growth 丢失。没有改工具、阶段、门控、schema 或配置键；改变的是人类读法、路径安全和少量状态契约，不迁移项目数据。历史版本的内部方案与验收稿留在对应发布 tag，不再复制进 `main`。
 
 ---
 
@@ -119,6 +119,8 @@ flowchart TB
 
 P7、P8、P9 在 `novel_archive` 一次事务里完成。单章归档后状态是 `done`；下一章仍从 P1 开始。只有项目配置的 `total_chapters` 全部归档，面板才显示“全书完成”。
 
+`pipeline.chapter` + `pipeline.stage` 是协议对，不是人类读法：归档第 N 章后，管线指向 N+1，`stage` 仍是 `done`，因为 `done` 描述的是**刚刚归档的第 N 章**。所有读面统一使用 `progress` 投影：`/novel status`、`novel_status`、`novel_pipeline`、`novel_guide`、`novel_doctor`、面板和“复制续写指令”都会显示“第 N 章已归档；下一章第 N+1 章从 P1 开始”。全书完成时 `progress.finished=true`，引擎续写文本为 `null`，`/novel resume` 显示“全书已完成”；要继续写，先用 `novel_amend` 提高 `targets.total_chapters`。
+
 ### 十三道门控
 
 门控按固定顺序求值，并且**收集全部失败项**，不是遇到第一个就返回。这样模型可以一次改完，而不是来回撞墙。
@@ -201,7 +203,7 @@ pnpm --version       # CLI 安装插件时需要
 corepack enable
 corepack prepare pnpm@11.28.9 --activate
 
-dsh plugin --profile web add dsh-novel-write-engine@0.2.7
+dsh plugin --profile web add dsh-novel-write-engine@0.2.8
 ```
 
 安装后重启 DSH，或刷新 Web 页面。
@@ -249,10 +251,10 @@ corepack pnpm build
 corepack pnpm pack
 ```
 
-得到 `dsh-novel-write-engine-0.2.7.tgz`，复制到目标机器后：
+得到 `dsh-novel-write-engine-0.2.8.tgz`，复制到目标机器后：
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/dsh-novel-write-engine-0.2.7.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-novel-write-engine-0.2.8.tgz
 ```
 
 tarball 已包含 `lib/`、`rulepacks/`、`briefs/`、`skills/`、`presets/` 和两层 patch，不需要在目标机器重新构建。
@@ -264,7 +266,7 @@ tarball 已包含 `lib/`、`rulepacks/`、`briefs/`、`skills/`、`presets/` 和
 
 1. 左侧栏进入 **插件**；
 2. 点 **添加插件**；
-3. 填 npm 包名 `dsh-novel-write-engine`（或精确版本 `dsh-novel-write-engine@0.2.7`）；
+3. 填 npm 包名 `dsh-novel-write-engine`（或精确版本 `dsh-novel-write-engine@0.2.8`）；
 4. 安装后启用，刷新页面，新开会话。
 
 插件页安装的是当前 profile 的依赖；Desktop 的插件页管理的是 `desktop` profile。
@@ -332,9 +334,9 @@ tarball 已包含 `lib/`、`rulepacks/`、`briefs/`、`skills/`、`presets/` 和
 
 归档后打开左侧 **网文工坊**：
 
-- 紧凑顶栏：书名、类型、平台、当前章、阶段；
-- 首屏“当前章 / 下一步”卡与“复制续写指令”；
-- 统计条：已归档章节、总字数、平均分、待处理门控；
+- 紧凑顶栏：书名、类型、平台、当前章边界（例如“第 1 章已归档 · 下一章第 2 章待开始”）；
+- 首屏“当前章 / 下一步”卡与“复制续写指令”；归档后显示下一章 P1，全书完成时隐藏复制按钮；
+- 统计条：已归档章节、总字数（归档 + 活动草稿）、平均分、待处理门控；
 - 双栏工作台：阶段轨、门控、提示、旧数据、全书规划、质量趋势、健康度、最近活动；
 - 底部章节卡。
 
@@ -439,9 +441,9 @@ novel_write_draft, novel_review, novel_revise, novel_check, novel_archive
 | `novel_outline` | 按 `num` upsert 章卡、按 `title` upsert 卷；省略不删，显式 `remove`；`dry_run` 预览 |
 | `novel_outline_import` | 从 Markdown / YAML / JSON 导入大纲；`dry_run` 先预览 |
 | `novel_worldbook` | 增量更新世界观设定集（设定/规则/势力/地点/角色/术语/前史） |
-| `novel_status` | 当前章、阶段、轮次、阻塞项、`state_errors`、`manuscript_hash`、下一步 |
+| `novel_status` | `progress` 章节边界、轮次、阻塞项、`state_errors`、`manuscript_hash`、下一步 |
 | `novel_guide` | 上手引导：当前状态、已完成步骤、下一步工具；无项目也能用 |
-| `novel_pipeline` | “下一步该做什么”的建议 |
+| `novel_pipeline` | “下一步该做什么”的建议，带同一份 `progress` |
 
 ### 单章流水线（8）
 
@@ -620,18 +622,18 @@ corepack pnpm test
 
 ## 升级与卸载
 
-### 升级到 0.2.7
+### 升级到 0.2.8
 
-0.2.7 没有 schema、工具、阶段、门控、导出或配置键变更，不需要迁移项目文件。
+0.2.8 没有 schema、工具、阶段、门控、导出或配置键变更，不需要迁移项目文件。
 
 ```bash
 dsh plugin --profile web remove dsh-novel-write-engine
-dsh plugin --profile web add dsh-novel-write-engine@0.2.7
+dsh plugin --profile web add dsh-novel-write-engine@0.2.8
 ```
 
-升级后刷新页面、新开会话。面板教程版本从 0.2.6 升到 0.2.7；旧标签页显示“需要刷新”时刷新即可。
+升级后刷新页面、新开会话。面板教程版本从 0.2.7 升到 0.2.8；旧标签页显示“需要刷新”时刷新即可。
 
-历史版本的升级说明见 [CHANGELOG.md](CHANGELOG.md)。0.2.7 不再在 `main` 保留旧版方案与验收稿；需要溯源时使用对应发布 tag 或 Release 快照。
+历史版本的升级说明见 [CHANGELOG.md](CHANGELOG.md)。0.2.8 不再在 `main` 保留旧版方案与验收稿；需要溯源时使用对应发布 tag 或 Release 快照。
 
 ### 从源码目录升级
 
@@ -786,14 +788,14 @@ presets/          # 内置 Agent 预设 patch
 tests/            # 单测、集成、falsify、e2e
 ```
 
-### 本次 0.2.7 验证
+### 本次 0.2.8 验证
 
 以本次发布实际跑出的结果为准：
 
-- `corepack pnpm test`：**91 个测试文件 / 910 项全部通过**；
-- 覆盖率：**语句 93.51% / 分支 89.13% / 函数 98.12% / 行 93.51%**；逐文件门禁通过；
+- `corepack pnpm test`：**91 个测试文件 / 923 项全部通过**；
+- 覆盖率：**语句 93.55% / 分支 89.23% / 函数 98.14% / 行 93.55%**；逐文件门禁通过；
 - `typecheck`、`lint`、`build`：通过；
-- `check:hygiene`（156 files，0 v8 ignore）、`test:isolated`（62 源文件）、`validate:rulepack`、`check:pack`（26 files）、`check:artifacts`、`check:install`（26 packages）、`check:preset`（13 packages）、`check:host`、`check:crash`：通过；
+- `check:hygiene`（157 files，0 v8 ignore）、`test:isolated`（63 源文件）、`validate:rulepack`、`check:pack`（26 files）、`check:artifacts`、`check:install`（26 packages）、`check:preset`（13 packages）、`check:host`、`check:crash`：通过；
 - 三题材矩阵：玄幻修仙、都市现代、西方奇幻各跑一遍 `init → archive`；
 - 隐私守卫：`src / briefs / skills / presets / rulepacks / docs` 与根文档均无具体项目身份。
 

package/lib/client.js

@@ -50,9 +50,9 @@ window.__ModuleLoader__.load({
 			P4: "评审",
 			P5: "修订",
 			P6: "一致性",
-			P7: "终审",
-			P8: "归档",
-			P9: "完成"
+			P7: "状态同步",
+			P8: "终审",
+			P9: "归档"
 		};
 		const STAGE_LABELS = {
 			idle: "待开始",
@@ -332,8 +332,10 @@ window.__ModuleLoader__.load({
 			const rowAverage = scored.length === 0 ? 0 : scored.reduce((sum, row) => sum + row.scoreValue, 0) / scored.length;
 			const average = summary.averageScore !== void 0 && Number.isFinite(summary.averageScore) ? summary.averageScore : rowAverage;
 			const next = summary.next;
-			const finished = summary.finished === true;
+			const progress = summary.progress;
+			const finished = progress?.finished ?? summary.finished === true;
 			const doneLabel = summary.stage === "done" ? finished ? "全书完成" : "本章已归档" : stageLabel(summary.stage);
+			const progressLine = progress?.label ?? (summary.stage === "done" ? finished ? `共 ${summary.totalChapters} 章` : `下一章 第 ${summary.chapter} 章` : `第 ${summary.chapter} 章`);
 			const selected = base.projects.find((project) => project.selected);
 			return {
 				...base,
@@ -343,7 +345,7 @@ window.__ModuleLoader__.load({
 				damaged: selected?.state === "damaged",
 				resumeText: payload.resume?.text ?? "",
 				volumeNumber: summary.volume,
-				subtitle: summary.stage === "done" ? `${summary.genre} · ${platformLabel(summary.platform)} · ${finished ? `共 ${summary.totalChapters} 章` : `下一章 第 ${summary.chapter} 章`}${volumeLabel(summary)}` : `${summary.genre} · ${platformLabel(summary.platform)} · 第 ${summary.chapter} 章${volumeLabel(summary)}`,
+				subtitle: `${summary.genre} · ${platformLabel(summary.platform)} · ${progressLine}${volumeLabel(summary)}`,
 				stageLabel: doneLabel,
 				finished,
 				revisionLabel: `第 ${summary.bookData?.current.rounds.revise ?? summary.revision} 次修订`,
@@ -357,6 +359,8 @@ window.__ModuleLoader__.load({
 				stats: {
 					chapters: summary.totalChapters,
 					words: summary.totalWords,
+					...summary.archivedWords === void 0 ? {} : { archivedWords: summary.archivedWords },
+					...summary.draftWords === void 0 ? {} : { draftWords: summary.draftWords },
 					averageScore: Math.round(average * 10) / 10,
 					blocking: blocking.length
 				},
@@ -1146,7 +1150,7 @@ window.__ModuleLoader__.load({
 				title: "写书级蓝图与卷结构",
 				tool: "novel_blueprint",
 				body: "让模型先定 premise（故事前提）、logline（一句话卖点）、themes（主题）、tone（基调）、pov（视角）、audience（读者）、selling_points（卖点）、ending（结局方向）和 volumes（每卷起止章、目标、弧线、高潮）。",
-				note: "蓝图不是正文，可以后补。严格大纲是可选开关：strict:true 时每章必须先有章卡；不开启也能先写，但章卡一旦存在，标题、场景、目标字数和 cast 仍会校验。"
+				note: "蓝图不是正文，可以后补。首次提交章卡时 strict 默认开启；要宽松写作可在蓝图里显式 strict:false 关闭。strict 开启后每章必须先有章卡；章卡一旦存在，标题、场景、目标字数和 cast 仍会校验。"
 			},
 			{
 				title: "排章卡，或导入现成大纲",
@@ -1219,7 +1223,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 每次提交前先领取当前阶段任务书，失败时按返回的 code 和 blocking 一次改完。`;
 		const TUTORIAL_NEXT_PROMPT = `继续写当前项目的下一章。先调用 novel_pipeline（或 novel_status）确认当前阶段、项目根目录和下一步工具，不要猜阶段。
 如果当前会话还没绑定或不确定是哪本书：先用 /novel current 看会话绑定，再调用 novel_status 看 selection；需要切换时用 /novel use <路径|书名|.>，不要靠 active 猜。
-第一次调用带 project_root 时，它会成为当前会话的持久绑定；后续无 root 调用会继续这本书。
+第一次带 project_root 的项目调用会成为当前会话的持久绑定；后续无 root 调用会继续这本书。纯文本的 novel_word_count 和 novel_diff 不读取项目，也不会建立绑定。
 
 如果下一章还没有章卡：用 novel_outline 只提交下一章的卡（按 num upsert），省略的已有卡会保持不动；不要重交全量，也不要用空数组清空。要删卡必须显式传 remove。
 如果 targets.total_chapters 已经写满：先用 novel_amend 把 total_chapters 调到至少包含下一章，不能低于已归档章数。
@@ -1515,7 +1519,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 			ref: closeRef,
 			onClick: onClose,
 			"aria-label": "关闭使用教程"
-		}, (0, react.createElement)("span", { "aria-hidden": "true" }, "×"))), (0, react.createElement)("div", { className: "nwe-modal-body" }, (0, react.createElement)("div", { className: "nwe-tutorial-intro" }, (0, react.createElement)("p", null, "网文工坊不是一个“帮你想剧情”的按钮，而是一台有状态的写作引擎：你提供内容，引擎负责阶段、字数、门控、评审、归档和文件。"), (0, react.createElement)("p", null, "每一步都先领取当前阶段的任务书，再提交；提交后看引擎返回的 blocking 与下一步。面板只读，真正的写操作都在对话里的工具调用中。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "开始前：记住三件事"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "只用引擎入口写"), (0, react.createElement)("span", null, "正文只走 novel_write_draft / novel_revise；状态只走工具。手改 chapters/、state/、outline/ 会破坏事务与校验。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "每一步先领 brief"), (0, react.createElement)("span", null, "任务书携带当前上下文和 digest；跳过它会撞 PG-01。任务书过期就重新领取，不要复用旧上下文。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "失败先读 code"), (0, react.createElement)("span", null, "参数错改参数，门控没过改正文，系统故障查目录/稍后重试。blocking 会一次列全，一次改完再交。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "用哪个会话："), " 想获得完整的引擎保证，请新开一个「网文工坊」预设会话；普通会话里模型可能还挂着文件工具，能绕过引擎直接改稿。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一本书的完整流程"), (0, react.createElement)("p", null, "前四步是开书准备，后面是每章循环。第一次先按顺序走完一章，熟悉后再批量推进整本。"), (0, react.createElement)("ol", { className: "nwe-steps" }, ...TUTORIAL_STEPS.map((step, index) => tutorialStep(step, index)))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "面板怎么看"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "顶部统计"), (0, react.createElement)("span", null, "已归档章、总字数、平均分、待处理门控。数字来自引擎，不是正文估算。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "九阶段轨与下一步"), (0, react.createElement)("span", null, "亮起的阶段是当前进度，“下一步”卡会直接给出该调用的工具名。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "章节与门控"), (0, react.createElement)("span", null, "章节卡展开可看字数、评分与状态；门控区按 code/detail/hint 列出所有阻塞。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "刷新："), " 面板每 15 秒静默同步一次，也可以点右上角刷新。它是只读投影；不会替你改稿、归档或修状态。"), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "项目状态："), "选择器里 choose 表示发现多本书、还没选；项目不在了表示目录缺失，绑定仍会保留；不是项目表示目录还在但没有 novel.yaml 或项目状态；项目不可读表示权限或 IO 错误，先修权限或换一本。面板选择只影响查看，不改变任何会话的写作绑定。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "卡住时先看这里"), (0, react.createElement)("ul", { className: "nwe-faq" }, (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "为什么一直让我先领 brief？"), (0, react.createElement)("p", null, "这是正常门控。任务书决定当前阶段可用的字段与上下文 digest；先按返回值调用 novel_brief，再继续。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "门控失败，改一条还是全改？"), (0, react.createElement)("p", null, "一次看完所有 blocking，再一起改。逐条试会反复烧掉阶段轮次；错误里的 code 会告诉你属于参数、门控还是系统故障。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "字数和评分为什么对不上？"), (0, react.createElement)("p", null, "字数以 engine 返回为准，可用 novel_word_count 核对；review 的 total 必须等于 150 减全部扣分，不能另算一套。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "P4/P6 过不去怎么办？"), (0, react.createElement)("p", null, "P4 有 blocker 就领 P5 任务书修订，再回 P4 重评；P6 失败同样回修订。不要 waive blocker，也不要只跑半个 scope 就归档。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "想改已经归档的章节？"), (0, react.createElement)("p", null, "先 novel_reopen，带非空 reason。它会从归档备份恢复，重开后重新走 P3→P8；不要直接编辑归档卡或正文文件。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "状态文档坏了能手工修吗？"), (0, react.createElement)("p", null, "先用 novel_state 看 raw 和 next；需要修复时用 novel_amend，并在 reason 写清原因。手改 YAML 会丢失事务保护。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "有多个项目，面板看的是哪本？"), (0, react.createElement)("p", null, "面板用顶部项目选择器切换查看对象；选择只改 ?root= 和浏览器 localStorage，不调用 activate、不写会话绑定。写作项目请用 /novel use 或显式 project_root。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "选错书、想清掉绑定怎么办？"), (0, react.createElement)("p", null, "先用 /novel current 看当前会话绑定；要换书用 /novel use <路径|书名|.>，要清掉只影响当前会话的绑定用 /novel unbind。不要靠 active 猜，也不要手改 state/session-bindings.yaml。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "扫描到了，为什么还没切过去？"), (0, react.createElement)("p", null, "scan 只读发现；scan --register 只登记项目，不选择、不改 active、不绑会话。真正切换写作项目要用 /novel use，或第一次调用显式传 project_root。")))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "可以直接复制给模型的起手话术"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "续写下一章时，直接复制这段给 Agent"), (0, react.createElement)("p", null, "这段会先确认状态，再处理缺章卡和目标章数已满，最后按 P1→P8 推进；归档前会要求你确认 state_delta。"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_NEXT_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一章完成检查清单"), (0, react.createElement)("ul", { className: "nwe-checklist" }, (0, react.createElement)("li", null, "本章 P1/P2 计划已提交，P3 正文已通过格式与字数门控。"), (0, react.createElement)("li", null, "P4 评审 total 对账无误，没有未修 blocker。"), (0, react.createElement)("li", null, "P6 五个语义项都有不同句子的正文引用，完整 scope 通过。"), (0, react.createElement)("li", null, "P8 任务书当前，novel_archive 带完整 state_delta 成功。"), (0, react.createElement)("li", null, "面板出现已归档章节，门控区没有新的阻塞。")))), (0, react.createElement)("div", { className: "nwe-modal-foot" }, "教程基于 0.2.7 · 具体字段以当前任务书和工具返回为准 · 面板只读")));
+		}, (0, react.createElement)("span", { "aria-hidden": "true" }, "×"))), (0, react.createElement)("div", { className: "nwe-modal-body" }, (0, react.createElement)("div", { className: "nwe-tutorial-intro" }, (0, react.createElement)("p", null, "网文工坊不是一个“帮你想剧情”的按钮，而是一台有状态的写作引擎：你提供内容，引擎负责阶段、字数、门控、评审、归档和文件。"), (0, react.createElement)("p", null, "每一步都先领取当前阶段的任务书，再提交；提交后看引擎返回的 blocking 与下一步。面板只读，真正的写操作都在对话里的工具调用中。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "开始前：记住三件事"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "只用引擎入口写"), (0, react.createElement)("span", null, "正文只走 novel_write_draft / novel_revise；状态只走工具。手改 chapters/、state/、outline/ 会破坏事务与校验。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "每一步先领 brief"), (0, react.createElement)("span", null, "任务书携带当前上下文和 digest；跳过它会撞 PG-01。任务书过期就重新领取，不要复用旧上下文。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "失败先读 code"), (0, react.createElement)("span", null, "参数错改参数，门控没过改正文，系统故障查目录/稍后重试。blocking 会一次列全，一次改完再交。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "用哪个会话："), " 想获得完整的引擎保证，请新开一个「网文工坊」预设会话；普通会话里模型可能还挂着文件工具，能绕过引擎直接改稿。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一本书的完整流程"), (0, react.createElement)("p", null, "前四步是开书准备，后面是每章循环。第一次先按顺序走完一章，熟悉后再批量推进整本。"), (0, react.createElement)("ol", { className: "nwe-steps" }, ...TUTORIAL_STEPS.map((step, index) => tutorialStep(step, index)))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "面板怎么看"), (0, react.createElement)("div", { className: "nwe-tutorial-cards" }, (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "顶部统计"), (0, react.createElement)("span", null, "已归档章、总字数、平均分、待处理门控。数字来自引擎，不是正文估算。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "九阶段轨与下一步"), (0, react.createElement)("span", null, "亮起的阶段是当前进度，“下一步”卡会直接给出该调用的工具名。")), (0, react.createElement)("div", { className: "nwe-tutorial-card" }, (0, react.createElement)("strong", null, "章节与门控"), (0, react.createElement)("span", null, "章节卡展开可看字数、评分与状态；门控区按 code/detail/hint 列出所有阻塞。"))), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "刷新："), " 面板每 15 秒静默同步一次，也可以点右上角刷新。它是只读投影；不会替你改稿、归档或修状态。"), (0, react.createElement)("p", { className: "nwe-tutorial-note" }, (0, react.createElement)("strong", null, "项目状态："), "选择器里 choose 表示发现多本书、还没选；项目不在了表示目录缺失，绑定仍会保留；不是项目表示目录还在但没有 novel.yaml 或项目状态；项目不可读表示权限或 IO 错误，先修权限或换一本。面板选择只影响查看，不改变任何会话的写作绑定。")), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "卡住时先看这里"), (0, react.createElement)("ul", { className: "nwe-faq" }, (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "为什么一直让我先领 brief？"), (0, react.createElement)("p", null, "这是正常门控。任务书决定当前阶段可用的字段与上下文 digest；先按返回值调用 novel_brief，再继续。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "门控失败，改一条还是全改？"), (0, react.createElement)("p", null, "一次看完所有 blocking，再一起改。逐条试会反复烧掉阶段轮次；错误里的 code 会告诉你属于参数、门控还是系统故障。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "字数和评分为什么对不上？"), (0, react.createElement)("p", null, "字数以 engine 返回为准，可用 novel_word_count 核对；review 的 total 必须等于 150 减全部扣分，不能另算一套。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "P4/P6 过不去怎么办？"), (0, react.createElement)("p", null, "P4 有 blocker 就领 P5 任务书修订，再回 P4 重评；P6 失败同样回修订。不要 waive blocker，也不要只跑半个 scope 就归档。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "想改已经归档的章节？"), (0, react.createElement)("p", null, "先 novel_reopen，带非空 reason。它会从归档备份恢复，重开后重新走 P3→P8；不要直接编辑归档卡或正文文件。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "状态文档坏了能手工修吗？"), (0, react.createElement)("p", null, "先用 novel_state 看 raw 和 next；需要修复时用 novel_amend，并在 reason 写清原因。手改 YAML 会丢失事务保护。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "有多个项目，面板看的是哪本？"), (0, react.createElement)("p", null, "面板用顶部项目选择器切换查看对象；选择只改 ?root= 和浏览器 localStorage，不调用 activate、不写会话绑定。写作项目请用 /novel use 或显式 project_root。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "选错书、想清掉绑定怎么办？"), (0, react.createElement)("p", null, "先用 /novel current 看当前会话绑定；要换书用 /novel use <路径|书名|.>，要清掉只影响当前会话的绑定用 /novel unbind。不要靠 active 猜，也不要手改 state/session-bindings.yaml。")), (0, react.createElement)("li", null, (0, react.createElement)("strong", null, "扫描到了，为什么还没切过去？"), (0, react.createElement)("p", null, "scan 只读发现；scan --register 只登记项目，不选择、不改 active、不绑会话。真正切换写作项目要用 /novel use，或第一次调用显式传 project_root。")))), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "可以直接复制给模型的起手话术"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "续写下一章时，直接复制这段给 Agent"), (0, react.createElement)("p", null, "这段会先确认状态，再处理缺章卡和目标章数已满，最后按 P1→P8 推进；归档前会要求你确认 state_delta。"), (0, react.createElement)("pre", { className: "nwe-prompt" }, TUTORIAL_NEXT_PROMPT)), (0, react.createElement)("section", { className: "nwe-tutorial-block" }, (0, react.createElement)("h3", null, "一章完成检查清单"), (0, react.createElement)("ul", { className: "nwe-checklist" }, (0, react.createElement)("li", null, "本章 P1/P2 计划已提交，P3 正文已通过格式与字数门控。"), (0, react.createElement)("li", null, "P4 评审 total 对账无误，没有未修 blocker。"), (0, react.createElement)("li", null, "P6 五个语义项都有不同句子的正文引用，完整 scope 通过。"), (0, react.createElement)("li", null, "P8 任务书当前，novel_archive 带完整 state_delta 成功。"), (0, react.createElement)("li", null, "面板出现已归档章节，门控区没有新的阻塞。")))), (0, react.createElement)("div", { className: "nwe-modal-foot" }, "教程基于 0.2.8 · 具体字段以当前任务书和工具返回为准 · 面板只读")));
 		const NovelHelp = () => {
 			const [open, setOpen] = (0, react.useState)(false);
 			const triggerRef = (0, react.useRef)(null);
@@ -1592,6 +1596,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 		const bookDataSection = (view) => {
 			const data = view.bookData;
 			if (data === null) return null;
+			const currentLabel = data.current.stage === "done" ? data.progress.target !== null && data.progress.archived >= data.progress.target ? "全书完成" : `下一章 ${data.current.chapter} · 未开始` : `${data.current.chapter} · ${data.current.stage}`;
 			const dims = data.quality.dimensions.map((dimension) => (0, react.createElement)("div", {
 				className: "nwe-v6-bar",
 				key: dimension.id
@@ -1613,7 +1618,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 				["已归档", `${data.progress.archived} / ${data.progress.target ?? "不限"} 章`],
 				["字数", `归档 ${data.progress.words_archived} · 含草稿 ${data.progress.words_with_draft}`],
 				["剩余", data.progress.remaining_words === null ? "—" : `${data.progress.remaining_words} 字（${data.progress.remaining_words_basis}）`],
-				["当前章", `${data.current.chapter} · ${data.current.stage} · ${data.current.card?.title ?? "无章卡"}`],
+				["当前章", `${currentLabel} · ${data.current.card?.title ?? "无章卡"}`],
 				["轮次", `评 ${data.current.rounds.review} / 修 ${data.current.rounds.revise} / 检 ${data.current.rounds.check}`],
 				["正文 hash", data.current.manuscript_hash ?? "—"],
 				["当前字数", data.current.metrics === null ? "—" : String(data.current.metrics.total_word_count)]
@@ -1685,7 +1690,7 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 				className: "nwe-stats",
 				role: "group",
 				"aria-label": "项目统计"
-			}, stat("已归档", String(view.stats.chapters), "章"), stat("总字数", view.stats.words.toLocaleString("zh-CN"), "字"), stat("全书均分", view.stats.chapters === 0 ? "—" : String(view.stats.averageScore), "/150"), stat("待处理", String(view.stats.blocking), "项")) : null, ready ? bookDataSection(view) : null, view.state === "loading" ? loadingState() : null, view.state === "choose" ? choosePanel(view, onSelectProject) : null, view.state === "missing" ? missingPanel(view) : null, view.state === "error" || view.state === "empty" || view.state === "outdated" ? statePanel(view.state, view, loading, onRefresh) : null, ready ? (0, react.createElement)("div", { className: "nwe-desk" }, (0, react.createElement)("div", { className: "nwe-desk-main" }, (0, react.createElement)("div", { className: "nwe-desk-heading" }, (0, react.createElement)("span", { className: "nwe-desk-kicker" }, "当前一章"), (0, react.createElement)("span", { className: "nwe-desk-note" }, view.stageLabel)), phases(view), blockingSection(view), advisoriesSection(view), pendingSection(view), legacySection(view), chaptersSection(view)), (0, react.createElement)("aside", {
+			}, stat("已归档", String(view.stats.chapters), "章"), stat("总字数", view.stats.words.toLocaleString("zh-CN"), (view.stats.draftWords ?? 0) > 0 ? `字（归档 ${(view.stats.archivedWords ?? 0).toLocaleString("zh-CN")} + 草稿 ${view.stats.draftWords.toLocaleString("zh-CN")}）` : "字"), stat("全书均分", view.stats.chapters === 0 ? "—" : String(view.stats.averageScore), "/150"), stat("待处理", String(view.stats.blocking), "项")) : null, ready ? bookDataSection(view) : null, view.state === "loading" ? loadingState() : null, view.state === "choose" ? choosePanel(view, onSelectProject) : null, view.state === "missing" ? missingPanel(view) : null, view.state === "error" || view.state === "empty" || view.state === "outdated" ? statePanel(view.state, view, loading, onRefresh) : null, ready ? (0, react.createElement)("div", { className: "nwe-desk" }, (0, react.createElement)("div", { className: "nwe-desk-main" }, (0, react.createElement)("div", { className: "nwe-desk-heading" }, (0, react.createElement)("span", { className: "nwe-desk-kicker" }, "当前一章"), (0, react.createElement)("span", { className: "nwe-desk-note" }, view.stageLabel)), phases(view), blockingSection(view), advisoriesSection(view), pendingSection(view), legacySection(view), chaptersSection(view)), (0, react.createElement)("aside", {
 				className: "nwe-desk-side",
 				"aria-label": "全书与活动"
 			}, bookSection(view), activitySection(view))) : null, footer());

package/lib/index.d.ts

@@ -301,8 +301,8 @@ interface CharacterDelta {
   role?: string;
   profile?: Record<string, unknown>;
   current_state?: Record<string, unknown>;
+  /** Chapter is engine-assigned from the archive transaction, not caller-supplied. */
   growth?: {
-    chapter: number;
     change: string;
     status_change: string;
   };
@@ -972,6 +972,8 @@ interface GateInput {
   briefStage: BriefStage | null;
   draftTitle: string | null;
   sceneType: SceneType | null;
+  /** The submitted/active plan narrator; PG-05 uses it before a draft exists. */
+  narrator?: string | null;
   summary: ChapterSummary | null;
   /** P5 may omit `summary`; when omitted, the previous plan summary is reused. */
   summaryProvided?: boolean;
@@ -1034,6 +1036,36 @@ interface Selection {
   title?: string;
   created_at?: string;
 }
+/**
+ * One human-readable projection of the pipeline's chapter boundary.
+ *
+ * `pipeline.chapter`/`stage` are protocol values: after archiving chapter N the
+ * pipeline points at N+1 and still says `done` because `done` describes the
+ * chapter that was just archived. This projection is the only place that turns
+ * those values into "chapter N archived; chapter N+1 starts at P1".
+ */
+interface ChapterProgress {
+  active_chapter: number;
+  stage: Stage;
+  /** The chapter currently being written; null while `stage === 'done'`. */
+  current: {
+    chapter: number;
+    stage: Stage;
+  } | null;
+  /** Highest archived chapter, or null before the first archive. */
+  last_archived: number | null;
+  /** Next chapter to start at P1; null while writing or after the book is finished. */
+  next: {
+    chapter: number;
+    stage: 'P1';
+  } | null;
+  /** True only when the configured target has been reached at `stage === 'done'`. */
+  finished: boolean;
+  /** One line for status cards, commands and the panel. */
+  label: string;
+  /** Sentence used by the resume prompt instead of "当前第 N 章，阶段 done". */
+  resume: string;
+}
 /** The `getStatus` payload. */
 interface StatusReport {
   project: {
@@ -1054,6 +1086,8 @@ interface StatusReport {
   /** SHA-256 of the active manuscript, or null when the stage has no draft. */
   manuscript_hash: string | null;
   stage: Stage;
+  /** Chapter-boundary projection shared by every human-readable surface. */
+  progress?: ChapterProgress;
   rounds: RoundCounters;
   blocking: BlockingItem[];
   /** Non-blocking recovery notes, e.g. a recoverable pending transaction. */
@@ -1106,6 +1140,8 @@ interface StatusReport {
 interface AdviceReport {
   stage: Stage;
   chapter: number;
+  /** Same chapter-boundary projection as getStatus. */
+  progress?: ChapterProgress;
   tool: string;
   args: Record<string, unknown>;
   reason: string;
@@ -1577,6 +1613,8 @@ interface PanelSnapshot {
   platform: string;
   chapter: number;
   stage: Stage;
+  /** Chapter-boundary projection; `chapter`/`stage` stay as the protocol pair. */
+  progress?: ChapterProgress;
   revision: number;
   rounds: {
     review: number;
@@ -1595,8 +1633,12 @@ interface PanelSnapshot {
   chapters: ChapterRecord[];
   /** The active, not-yet-archived chapter; archived rows come from `chapters`. */
   draft?: PanelDraft | null;
-  /** Total words across the index, for the header. */
+  /** Archived words plus the active draft; the header shows this total. */
   totalWords: number;
+  /** Words in archived chapters only. */
+  archivedWords?: number;
+  /** Active draft words, zero when no draft exists. */
+  draftWords?: number;
   /** Book-wide archived average, not just the panel's capped rows. */
   averageScore?: number;
   /** The nine-phase strip state, derived from the pipeline stage. */
@@ -1694,8 +1736,14 @@ interface PanelSummaryDto {
   platform: string;
   chapter: number;
   stage: Stage;
+  /** Chapter-boundary projection; absent on older payloads. */
+  progress?: ChapterProgress;
   revision: number;
   totalWords: number;
+  /** Words in archived chapters only; `totalWords` also counts the active draft. */
+  archivedWords?: number;
+  /** Active draft words, zero when no draft exists. */
+  draftWords?: number;
   totalChapters: number;
   /** Book-wide archived average; absent on older payloads. */
   averageScore?: number;
@@ -1825,12 +1873,27 @@ interface PanelBundle {
   empty?: true;
   error?: string;
 }
+interface ChapterProgressInput {
+  activeChapter: number;
+  stage: Stage;
+  archived: readonly number[];
+  target: number | null;
+}
+/**
+ * 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.
+ */
+declare function projectChapterProgress(input: ChapterProgressInput): ChapterProgress;
 interface ResumePromptInput {
   title: string;
   root: string;
   chapter: number | string;
   stage: string;
   nextTool: string;
+  /** When supplied, replaces the protocol pair with the chapter boundary text. */
+  progress?: ChapterProgress;
 }
 /** One shared prompt template for `/novel resume` and the panel copy button. */
 declare function formatResumePrompt(input: ResumePromptInput): string;
@@ -2298,6 +2361,7 @@ declare class EngineService {
   }): Promise<OpResult<{
     stage: Stage;
     chapter: number;
+    progress: ChapterProgress;
     tool: string;
     args: Record<string, unknown>;
     reason: string;
@@ -2419,6 +2483,8 @@ declare class EngineService {
     root?: string;
   }): Promise<{
     totalWords: number;
+    archivedWords: number;
+    draftWords: number;
     chapters: number;
     revision: number;
     rulepack: string;
@@ -2805,4 +2871,4 @@ declare const Config: Schema<Config>;
  * created lazily per project root.
  */
 declare function apply(ctx: Context, config: Config): void;
-export { ARCHIVE_DIGESTS_FILE, AdviceReport, ArchiveHandoff, AuditRow, BACKUP_DIR, BRIEF_RECEIPTS_FILE, BlockingItem, BookPlan, BookReport, BriefDocument, BriefLibrary, BriefReceipt, BriefReceiptsDocument, BriefStage, CHAPTERS_DIR, CHECK_DIR, CORE_TOOLS, ChapterCastMember, ChapterPlanInput, ChapterRecord, ChapterStatusRow, ChapterSummary, ChaptersDocument, CharacterDelta, CharactersDocument, CheckDocument, Config, DEFAULT_GENRE, DEFAULT_PLATFORM, Deduction, DeltaAction, DiffReport, DoctorCheck, DoctorReport, DraftInput, DraftState, ERROR_CODES, EXPORT_DIR, EngineBlockedError, EngineError, EngineFaultError, EngineInputError, EngineService, ErrorCode, ExportChapter, ExportKind, ForeshadowDelta, ForeshadowsDocument, GENRES, GateInput, GateOptions, GateResult, Genre, GuideReport, GuideStep, HISTORY_DIR, HISTORY_KINDS, HandoffDocument, HistoryKind, INITIAL_STAGE, LIMITS, LOCK_FILE, LocksDocument, METADATA_LOCK_FILE, MachineMetrics, NovelProject, OPERATIONS, OUTLINE_DEPRECATED_FILE, OUTLINE_DIR, OUTLINE_FILE, OpResult, Operation, OutlineChapter, OutlineDocument, OutlineProgress, OutlineVolume, PANEL_CHAPTER_LIMIT, PANEL_ID, PANEL_ROUTE, PHASE_STRIP, PLAN_DIR, PLATFORMS, PLUGIN_NAME, PROJECT_FILE, PanelBook, PanelBundle, PanelChapterRow, PanelChaptersDto, PanelDraft, PanelGatesDto, PanelMissing, PanelProjectOption, PanelSelection, PanelSnapshot, PanelSummaryDto, PipelineState, Platform, REGISTRY_FILE, REMOTE_VERSION, REVIEW_DIR, ReadingProof, ReadingProofReference, RelationshipDelta, RelationshipsDocument, ResumePromptInput, ReviewDocument, ReviewInput, ReviewIssue, RevisionEdit, RevisionInput, RevisionPatch, RoundCounters, SCENE_TYPES, SCENE_TYPE_DEFAULT, SCHEMA_VERSION, SESSION_BINDINGS_FILE, SKILL_NAME, STAGING_DIR, STATE_DIR, STATE_FILES, SceneType, ScoreDimension, SearchReport, SearchResultItem, Selection, SelectionSource, SemanticItem, Severity, Stage, StateDelta, StateError, StateErrorCode, StatusReport, TOOL_NAMES, TimelineDelta, TimelineDocument, ToolName, Violation, WORLDBOOK_FILE, Warning, WordMetrics, WorldDelta, WorldDocument, WorldPlanInput, WorldbookBackstory, WorldbookCharacter, WorldbookDocument, WorldbookFact, WorldbookFaction, WorldbookGlossary, WorldbookLocation, WorldbookRule, 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, AdviceReport, ArchiveHandoff, AuditRow, BACKUP_DIR, BRIEF_RECEIPTS_FILE, BlockingItem, BookPlan, BookReport, BriefDocument, BriefLibrary, BriefReceipt, BriefReceiptsDocument, BriefStage, CHAPTERS_DIR, CHECK_DIR, CORE_TOOLS, ChapterCastMember, ChapterPlanInput, ChapterProgress, ChapterProgressInput, ChapterRecord, ChapterStatusRow, ChapterSummary, ChaptersDocument, CharacterDelta, CharactersDocument, CheckDocument, Config, DEFAULT_GENRE, DEFAULT_PLATFORM, Deduction, DeltaAction, DiffReport, DoctorCheck, DoctorReport, DraftInput, DraftState, ERROR_CODES, EXPORT_DIR, EngineBlockedError, EngineError, EngineFaultError, EngineInputError, EngineService, ErrorCode, ExportChapter, ExportKind, ForeshadowDelta, ForeshadowsDocument, GENRES, GateInput, GateOptions, GateResult, Genre, GuideReport, GuideStep, HISTORY_DIR, HISTORY_KINDS, HandoffDocument, HistoryKind, INITIAL_STAGE, LIMITS, LOCK_FILE, LocksDocument, METADATA_LOCK_FILE, MachineMetrics, NovelProject, OPERATIONS, OUTLINE_DEPRECATED_FILE, OUTLINE_DIR, OUTLINE_FILE, OpResult, Operation, OutlineChapter, OutlineDocument, OutlineProgress, OutlineVolume, PANEL_CHAPTER_LIMIT, PANEL_ID, PANEL_ROUTE, PHASE_STRIP, PLAN_DIR, PLATFORMS, PLUGIN_NAME, PROJECT_FILE, PanelBook, PanelBundle, PanelChapterRow, PanelChaptersDto, PanelDraft, PanelGatesDto, PanelMissing, PanelProjectOption, PanelSelection, PanelSnapshot, PanelSummaryDto, PipelineState, Platform, REGISTRY_FILE, REMOTE_VERSION, REVIEW_DIR, ReadingProof, ReadingProofReference, RelationshipDelta, RelationshipsDocument, ResumePromptInput, ReviewDocument, ReviewInput, ReviewIssue, RevisionEdit, RevisionInput, RevisionPatch, RoundCounters, SCENE_TYPES, SCENE_TYPE_DEFAULT, SCHEMA_VERSION, SESSION_BINDINGS_FILE, SKILL_NAME, STAGING_DIR, STATE_DIR, STATE_FILES, SceneType, ScoreDimension, SearchReport, SearchResultItem, Selection, SelectionSource, SemanticItem, Severity, Stage, StateDelta, StateError, StateErrorCode, StatusReport, TOOL_NAMES, TimelineDelta, TimelineDocument, ToolName, Violation, WORLDBOOK_FILE, Warning, WordMetrics, WorldDelta, WorldDocument, WorldPlanInput, WorldbookBackstory, WorldbookCharacter, WorldbookDocument, WorldbookFact, WorldbookFaction, WorldbookGlossary, WorldbookLocation, WorldbookRule, 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 };

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`);
@@ -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,
@@ -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}`,
@@ -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,
@@ -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 };

package/lib/types/client/dto.d.ts

@@ -11,6 +11,23 @@ export interface BlockingDto {
     detail: string;
     hint?: string;
 }
+/** Chapter-boundary projection; absent on older payloads. */
+export interface ProgressDto {
+    active_chapter: number;
+    stage: string;
+    current: {
+        chapter: number;
+        stage: string;
+    } | null;
+    last_archived: number | null;
+    next: {
+        chapter: number;
+        stage: 'P1';
+    } | null;
+    finished: boolean;
+    label: string;
+    resume: string;
+}
 export interface SummaryDto {
     schemaVersion: number;
     panelId: string;
@@ -21,8 +38,11 @@ export interface SummaryDto {
     platform: string;
     chapter: number;
     stage: string;
+    progress?: ProgressDto;
     revision: number;
     totalWords: number;
+    archivedWords?: number;
+    draftWords?: number;
     totalChapters: number;
     /** Book-wide archived average; absent on older payloads. */
     averageScore?: number;

package/lib/types/client/viewmodel.d.ts

@@ -82,6 +82,8 @@ export interface PanelView {
     stats: {
         chapters: number;
         words: number;
+        archivedWords?: number;
+        draftWords?: number;
         averageScore: number;
         blocking: number;
     };

package/lib/types/types.d.ts

@@ -301,8 +301,8 @@ export interface CharacterDelta {
     role?: string;
     profile?: Record<string, unknown>;
     current_state?: Record<string, unknown>;
+    /** Chapter is engine-assigned from the archive transaction, not caller-supplied. */
     growth?: {
-        chapter: number;
         change: string;
         status_change: string;
     };
@@ -972,6 +972,8 @@ export interface GateInput {
     briefStage: BriefStage | null;
     draftTitle: string | null;
     sceneType: SceneType | null;
+    /** The submitted/active plan narrator; PG-05 uses it before a draft exists. */
+    narrator?: string | null;
     summary: ChapterSummary | null;
     /** P5 may omit `summary`; when omitted, the previous plan summary is reused. */
     summaryProvided?: boolean;
@@ -1034,6 +1036,36 @@ export interface Selection {
     title?: string;
     created_at?: string;
 }
+/**
+ * One human-readable projection of the pipeline's chapter boundary.
+ *
+ * `pipeline.chapter`/`stage` are protocol values: after archiving chapter N the
+ * pipeline points at N+1 and still says `done` because `done` describes the
+ * chapter that was just archived. This projection is the only place that turns
+ * those values into "chapter N archived; chapter N+1 starts at P1".
+ */
+export interface ChapterProgress {
+    active_chapter: number;
+    stage: Stage;
+    /** The chapter currently being written; null while `stage === 'done'`. */
+    current: {
+        chapter: number;
+        stage: Stage;
+    } | null;
+    /** Highest archived chapter, or null before the first archive. */
+    last_archived: number | null;
+    /** Next chapter to start at P1; null while writing or after the book is finished. */
+    next: {
+        chapter: number;
+        stage: 'P1';
+    } | null;
+    /** True only when the configured target has been reached at `stage === 'done'`. */
+    finished: boolean;
+    /** One line for status cards, commands and the panel. */
+    label: string;
+    /** Sentence used by the resume prompt instead of "当前第 N 章，阶段 done". */
+    resume: string;
+}
 /** The `getStatus` payload. */
 export interface StatusReport {
     project: {
@@ -1054,6 +1086,8 @@ export interface StatusReport {
     /** SHA-256 of the active manuscript, or null when the stage has no draft. */
     manuscript_hash: string | null;
     stage: Stage;
+    /** Chapter-boundary projection shared by every human-readable surface. */
+    progress?: ChapterProgress;
     rounds: RoundCounters;
     blocking: BlockingItem[];
     /** Non-blocking recovery notes, e.g. a recoverable pending transaction. */
@@ -1106,6 +1140,8 @@ export interface StatusReport {
 export interface AdviceReport {
     stage: Stage;
     chapter: number;
+    /** Same chapter-boundary projection as getStatus. */
+    progress?: ChapterProgress;
     tool: string;
     args: Record<string, unknown>;
     reason: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-novel-write-engine",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Novel writing engine for DeepSeek Harness: state machine, gates, rulepacks and ledgers moved from prompts into code.",
   "keywords": [
     "dsh-plugin",