dsh-novel-write-engine 0.2.4 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.2.5
+
+### Fixed
+
+- **语义证据跨句/跨段**：`novel_check` 的引文不再要求落在同一句；支持句末收尾引号、跨段证据，逐条返回 `pass|fail|missing|invalid|not_found|too_short|duplicate|overlap|same_sentence`，并在失败时给出 `nearest`/`conflict_with`。同一段被两条证据复用、或同一句不同子串仍按 `overlap`/`same_sentence` 拒绝；真实 r0076 的四段双句引文全部通过，r0075 的编造 POV 引文只报 `not_found`。
+- **check submission/content 分流**：形状、缺项、引文不存在等提交错误改为 `ENGINE_CHECK_SUBMISSION_INVALID`，不写 check、不增加 blocking、不消耗 `rounds.check`；只有正文/机器门真正的 content failure 才写 check 并 `counted:true`。工具错误行会回传逐条 `items`。
+- **world delta 双真源仲裁**：`summary.new_elements` 只作为意图声明；`state/world.yaml` 的存在性为真源。已有实体写 `created` 归一化为 `updated`，新实体写 `updated`/`no_change` 在 kind/正文可判定时归一化为 `created`；kind/detail 冲突仍拒绝。`archiveChapter` 返回 `delta_warnings` 与 `normalized_world`，warning 不再静默。
+- **pending 只读诊断**：`inspectPending` 分类 `none|complete|untouched|partial`；status/doctor/audit/panel 对 complete/untouched 给 warning、partial 给 `ENGINE_PENDING_PARTIAL`，不再误报 hash mismatch。`novel_init` 会先恢复/拒绝崩溃 init，partial 不被 PROJECT_EXISTS 掩盖。
+- **outline 归档不变量统一**：`novel_blueprint`、`novel_outline_import`（含 dry-run）、`novel_amend(outline)` 与 `novel_outline` 共用 `assertArchivedCardVolumes`/`assertArchivedCardsInVolumes` 和 active 卡保护；即使旧卡缺失或卷重排，归档章也必须由最终卡指向覆盖它的卷。`reindexed`/`would_reindex` 显式回显，omitted 归档卡不再伪造 `archived_at`。
+- **summary-only 修复**：`novel_revise` 可只传 `summary`：正文 hash、章文件和历史不变，不消耗 revise 轮次，保持/推进到 P6；不要求 P4/P6 proof，接下来可直接 check/archive。summary-only 明确拒绝 `issues`/`proof`，避免静默吞掉评审/证明。P8 与工具文档已改为先 summary-only、只有正文需要改才走 P5。
+- **PG-05 前置**：P3/P5 即检查 `summary.new_elements` 名字在正文出现、已在 world ledger 时报“remove/use updated”，并校验 `characters_appeared` 正文/叙述者别名，避免错误留到 P8。
+- **资源余额**：`current_state.resources` 与旧余额深合并，保留兄弟资源；created/updated 都校验有限非负整数，负值/字符串/null/数组拒绝；P8 示例与错误提示改为非负。
+
+### Hardened
+
+- brief digest 绑定完整 project/outline/worldbook/plan/worldPlan，而不只是裁剪后的 context。
+- characters/world 重复实体名在 load 与 amend 均拒绝；`strict_explicit` 只允许内部 provenance，公共 outline 写入拒绝该字段。
+- FsStore 将 EACCES/EPERM/EROFS 包装为 `ENGINE_IO_PERMISSION`；rulepack 对每个 section/nested object 递归 knownKeys，包括 `reader_intrusion`/`god_view`、`genres.*` 与 `water_words.scene_thresholds`。
+- worldbook 导出补 `数值事实`；duplicate paragraph 指回原章真实段落号；time regression 指向正文段落；timeline.characters 必须是已声明角色；export 在 artifact 缺失时使 replay 失效并重写。
+- migration 备份 `backups/migrations/` 不参与 retention prune；无硬链接文件系统（FAT/SMB/WSL）用受控 rename fallback 回收 stale lock；面板选择中配置 projectRoot 优先于单行 registry；commands 错误行与 tools 一样保留 blocking/items。
+
+### Migration
+
+- check 文档 schema_version 不变；新增字段可选，旧 check 可读。旧项目已消耗的 rounds 不回滚。
+- archive 遇到旧 `summary.new_elements` 与 ledger 冲突时按新规则成功并给 warning；不会回写旧 ledger。
+- summary-only 是新增调用模式，旧 content/patch 修订语义不变。
+- `strict_explicit` 若曾被外部写入，仍可被读取；新的公共写入必须改用 `strict`。
+- 详细验收与真实项目/模型证据见 `docs/0.2.5-acceptance.md`、`docs/0.2.5-real-model-evidence.md`。
+
 ## 0.2.4
 
 ### Changed

package/README.md

@@ -12,7 +12,9 @@
 
 0.2.4 根治 `novel_outline` 的“省略即删除”：`chapters` 按 `num`、`volumes` 按 `title` 做 upsert，省略的卡保持不动；删除必须显式 `remove` / `remove_volumes`；新增 `dry_run`、`added`/`updated`/`removed` 回显、`outline.deprecated.yaml` 与 `novel_restore` 的 outline 恢复路径。这是有意的 BREAKING 语义修正：从“提交集合就是全集”变成“提交的是要改的对象”。
 
-> **当前版本：0.2.4** · 中文界面 · MIT
+0.2.5 根治“证据/账本/恢复”三条真实链路：语义引文支持跨句/跨段并逐条解释；check 的 submission 错误不再消耗轮次；world delta 以 ledger 存在性仲裁并给 warning；pending 只读诊断与 init 崩溃恢复；归档卷/active 卡在 blueprint/import/amend/outline 全入口一致；新增 summary-only 修订（不改正文、不重跑 P4/P6）；resources 深合并非负整数。P1–P3 及 S1–S8 硬化见 [0.2.5 验收](docs/0.2.5-acceptance.md)。
+
+> **当前版本：0.2.5** · 中文界面 · MIT
 >
 > **宿主范围**：DSH `>=0.2.1-rc.2 <0.3.0-0`；Node `>=24.9.0`。
 
@@ -282,7 +284,7 @@ dsh plugin --profile web add dsh-novel-write-engine
 固定版本：
 
 ```bash
-dsh plugin --profile web add dsh-novel-write-engine@0.2.4
+dsh plugin --profile web add dsh-novel-write-engine@0.2.5
 ```
 
 `dsh` 不在 PATH 时，用 `npx @deepseek-ai/dsh` 代替命令开头的 `dsh`。
@@ -337,13 +339,13 @@ corepack pnpm pack
 会得到类似：
 
 ```text
-dsh-novel-write-engine-0.2.4.tgz
+dsh-novel-write-engine-0.2.5.tgz
 ```
 
 把这个 tarball 复制到目标机器，放在一个**稳定、不会随手删除**的路径，然后：
 
 ```bash
-dsh plugin --profile web add /absolute/path/to/dsh-novel-write-engine-0.2.4.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-novel-write-engine-0.2.5.tgz
 ```
 
 tarball 安装不会运行源码构建，也不会要求 `allowBuilds`；包内已经包含 `lib/`、`rulepacks/`、`briefs/`、`skills/`、`presets/` 和两层 patch。它是最接近「发布产物」的安装方式。
@@ -358,9 +360,9 @@ tarball 安装不会运行源码构建，也不会要求 `allowBuilds`；包内
 2. 点 **添加插件**（或旁边的箭头 → **安装第三方插件**）。
 3. 在包名字段填入以下任一形式：
    - npm 包名：`dsh-novel-write-engine`
-   - 精确版本：`dsh-novel-write-engine@0.2.4`
+   - 精确版本：`dsh-novel-write-engine@0.2.5`
    - 源码目录：`/absolute/path/to/dsh-novel-write-engine`
-   - tarball：`/absolute/path/to/dsh-novel-write-engine-0.2.4.tgz`
+   - tarball：`/absolute/path/to/dsh-novel-write-engine-0.2.5.tgz`
 4. npm 包名从 npm 官方源安装；本地目录和 tarball 直接使用宿主路径。
 5. 点 **安装**，等待完成。
 6. 如果出现 **立即启用**，点它；否则安装后到「已安装插件」里把 **dsh-novel-write-engine** 打开。
@@ -432,7 +434,7 @@ dsh --profile web --dump-config | grep -A8 '# == dsh-novel-write-engine'
 先做全书蓝图、第一卷大纲和世界观设定，再写第一章的世界观约束和章节计划。
 ```
 
-模型会调用 `novel_init` 建项目，然后按 `novel_guide` 的提示做书级规划；也可以跳过蓝图直接写第一章，严格大纲是可选开关。0.2.4 推荐顺序：
+模型会调用 `novel_init` 建项目，然后按 `novel_guide` 的提示做书级规划；也可以跳过蓝图直接写第一章，严格大纲是可选开关。0.2.5 推荐顺序：
 
 ```text
 novel_init
@@ -1022,7 +1024,7 @@ dsh plugin --profile web add dsh-novel-write-engine@latest
 也可以固定版本：
 
 ```bash
-dsh plugin --profile web add dsh-novel-write-engine@0.2.4
+dsh plugin --profile web add dsh-novel-write-engine@0.2.5
 ```
 
 升级后核对：
@@ -1064,7 +1066,7 @@ corepack pnpm pack
 
 ```bash
 dsh plugin --profile web remove dsh-novel-write-engine
-dsh plugin --profile web add /absolute/path/to/dsh-novel-write-engine-0.2.4.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-novel-write-engine-0.2.5.tgz
 ```
 
 ### 11.5 在 Web / Desktop 里升级
@@ -1332,6 +1334,14 @@ tests/            # 单测、集成、falsify、e2e
 
 ### 16.5 当前验证基线
 
+0.2.5 在 Node 24.19 / DSH 0.2.1-rc.3 上完成：
+
+- `npm test` 全绿：**81 个测试文件 / 875 项**；
+- 覆盖率：**语句 93.51% / 分支 89.07% / 函数 98.05% / 行 93.51%**；`test:coverage` 与逐文件 domain/book/insight/viewmodel 门禁全过；
+- `typecheck`、`lint`、`build` 通过；`check:hygiene`（144 files，0 v8 ignore）、`test:isolated`（60 源文件）、`validate:rulepack`、`check:pack`（25 files）、`check:artifacts`、`check:install`（26 packages）、`check:preset`（13 packages）、`check:host`、`check:crash` 全绿；
+- M1–M7、S1–S8 与 P2/P3 硬化见 [0.2.5 验收](docs/0.2.5-acceptance.md)；
+- 真实模型：`agnes-2.5-flash` 与 `agnes-3.0-flash` 各输出一篇正文，经公开引擎 P3→P8/归档成功（score 145，stage done）；P1/P2/P4/P6/P8 为确定性夹具，详见 [0.2.5 真实模型证据](docs/0.2.5-real-model-evidence.md)。
+
 0.2.4 在 Node 24.19 / DSH 0.2.1-rc.3 上完成：
 
 - `npm test` 全绿：**80 个测试文件 / 848 项**；
@@ -1362,6 +1372,9 @@ tests/            # 单测、集成、falsify、e2e
 | [PLAN.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/PLAN.md) | 0.1.0 实施计划（历史） |
 | [docs/0.2.0-plan.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.0-plan.md) | 0.2.0 整书生命周期：蓝图/大纲/世界观/章卡/观测 |
 | [docs/0.2.4-plan.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.4-plan.md) | 0.2.4 outline upsert、显式删除、dry_run 与恢复路径的根治方案 |
+| [docs/0.2.5-plan.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.5-plan.md) | 0.2.5 语义证据、check 轮次、world delta、pending、outline、summary-only、资源与 P2/P3 硬化方案 |
+| [docs/0.2.5-acceptance.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.5-acceptance.md) | 0.2.5 验收矩阵、真实项目回归与门禁证据 |
+| [docs/0.2.5-real-model-evidence.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.5-real-model-evidence.md) | 0.2.5 agnes 2.5/3.0 正文经引擎 P3→P8/归档回执 |
 | [docs/0.2.4-acceptance.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.4-acceptance.md) | 0.2.4 验收矩阵、质量门与边界 |
 | [docs/0.2.4-real-model-evidence.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.4-real-model-evidence.md) | 0.2.4 两条真实模型 P1→P8 链路回执 |
 | [docs/0.2.3-plan.md](https://github.com/ThzxxArt/dsh-novel-write-engine/blob/main/docs/0.2.3-plan.md) | 0.2.3 可信账本、工作流、advisory、面板 v5 与项目卫生 |

package/briefs/P5.md

@@ -39,6 +39,8 @@
 
 `ready_to_archive` 阶段也允许直接 `novel_revise`：正文会退回 P4 重新评审，不需要先 `novel_rollback`，也不会多写一份废稿快照。
 
+**summary-only 模式**：如果正文不需要改，只传 `{chapter, summary}`（不要传 content/patch/proof）。它只更新 draft summary，正文 hash、章历史与 revise 轮次都不变；校验 PG-05 后可继续 check/archive。summary 与正文事件不符时优先用这个模式。
+
 ## 常见返工原因
 
 - 只改了措辞，没解决 issue 指出的信息缺口。

package/briefs/P6.md

@@ -22,7 +22,7 @@
 ]
 ```
 
-五个 id 必须各出现一次；`verdict` 只能是 `pass`/`fail`；`evidence` 至少 8 字、必须逐字出现在正文里，且五条引用必须互不相同、来自不同句子。五条引用同一句话不算五份证据，会被 `SEMANTIC_EVIDENCE_INVALID` 拒绝。
+五个 id 必须各出现一次；`verdict` 只能是 `pass`/`fail`；`evidence` 至少 8 字、必须逐字出现在正文里，可以跨句/跨段。五条引用必须互不相同、不得复用同一句，也不得与已接受引文的区间重叠；同一句不同子串、重复引用或区间重叠会被按 `same_sentence`/`overlap` 拒绝。引文不存在/太短/形状不合法属于 **submission error**（`ENGINE_CHECK_SUBMISSION_INVALID`）：不写 check、不消耗轮次，修正 `semantic` 后仍调用 `novel_check`。
 
 | id | 检查 |
 |---|---|
@@ -38,7 +38,8 @@
 
 - 调用时可以传 `scope`：默认 `["content","integrity"]`；只跑 `content` 或只跑 `integrity` 是合法的，空数组/未知值会被拒绝。只跑一类时另一类规则不参与本次 check，但**不会**进入 `ready_to_archive`：管线停在 P6 并返回 `CHECK_SCOPE_PARTIAL`，必须再跑一次完整 scope。
 - 完整 scope 全过 → 管线进入 `ready_to_archive`，先 `novel_brief P8` 领取终审任务书，再调用 `novel_archive`。
-- 任一项 `fail` → 校验不过，先重新领取 `novel_brief P6`（check 已改变上下文，旧 digest 会失效），再调用 `novel_revise` 修订并回到 P4 重评（轮次 +1）。
+- 任一项 `fail` 且引文有效 → content failure，写 check 并消耗一轮；先重新领取 `novel_brief P6`（check 已改变上下文，旧 digest 会失效），再调用 `novel_revise` 修订并回到 P4 重评。
+- 如果只是 summary 字段与正文不符（正文无需改），用 `novel_revise {chapter, summary}` 做 summary-only 修复：不消耗 revise、不改正文，然后可直接继续 check/archive。
 
 ## 损坏与恢复
 

package/briefs/P8.md

@@ -81,23 +81,24 @@
 }
 ```
 
-错误会带上 `expected` 形态和收到的字段值，例如 `characters.陈嘉树.current_state must be an object; expected {"resources":{"港币":-3},...}`。不要猜字段名，按报错补齐即可。
+错误会带上 `expected` 形态和收到的字段值，例如 `characters.陈嘉树.current_state must be an object; expected {"resources":{"港币":3},...}`。不要猜字段名，按报错补齐即可。`current_state.resources` 会与旧余额深合并，余额必须是有限非负整数。
 
 ## summary 与 delta 的联动（归档前必核）
 
 `novel_archive` **不接受 summary**；它校验的是 P3/P5 已经固定的 draft summary。delta 必须与这份 summary 对齐：
 
 - `characters` 里每个 `action:"created"` 的人物名，必须出现在 draft `summary.characters_appeared`。
-- `world` 里每个 `action:"created"` 的 location / ability / artifact，必须出现在 draft `summary.new_elements` 的对应数组，且 `kind` 一致；`faction` / `rule` 只需正文出现并按 kind 写入，`summary.new_elements` 没有对应数组。
+- `world` 以 `state/world.yaml` 的存在性为唯一真源：已有实体写 `created` 会按 `updated` 归一化并给 warning；新实体写 `updated` 且正文出现、kind 可确定时按 `created` 归一化；kind 冲突仍拒绝。`summary.new_elements` 只是意图声明，名字必须在正文出现，已存在实体不再强求 `created`。
 - `timeline` 的键必须是 draft `summary.events` 的下标（字符串）。
 - `relationships` 的两端必须已在 `characters` 里声明（本章 created 或台账已有），否则先声明人物。
+- `timeline.<key>.characters` 里的每个名字必须已在 `characters` 台账里声明。
 
-如果 summary 与本章事实不符，**不要直接改 delta 硬凑**：先 `novel_brief P5` → `novel_revise` 修正正文和 summary，再重走 P4/P6/P8。归档阶段没有第二次 summary 入口。
+如果 summary 与本章事实不符，先走 **summary-only** 修复：`novel_revise {chapter, summary}`（不带 content/patch/proof）只更新 draft.summary，不消耗 revise 轮次、不改正文，然后按当前阶段继续；只有正文需要改时才走 P5 全文修订。
 
 - **伏笔的 title 是可读标签，anchor 才是校验证据**：`title` 可以写「船费债」这样的短语；要归档，请把正文原句放进 `anchor`（summary 的 planted 项或 delta 项都行，至少 8 个字符）。没有 `anchor` 时，`title` 必须逐字出现在正文里，否则 `ENGINE_DELTA_UNVERIFIED`。示例：`{"action":"created","title":"船费债","anchor":"三百蚊的船费先欠着","description":"欠船费三百蚊"}`。
 - 归档失败的报错会指出字段、值和缺失的锚点；不要把 title 改成碎片来“凑命中”，补 `anchor` 即可。
 - 第一人称的叙述者若在 `narrator` 里声明为 `陈默（第一人称「我」）`，正文用「我」也视为出现，但角色键仍写 `陈默`。
-- 每个新实体至少写 `action: "created"`；已存在且没变化写 `action: "no_change", reason: "..."`。
+- 每个新实体写 `action: "created"`（正文出现、kind 可确定）；已存在实体写 `updated` 或 `no_change`，引擎会按台账归一化冲突并给 warning。
 - `world` 新实体还要写 `kind: "location"|"ability"|"artifact"|"faction"|"rule"` 和 `description`。
 - `state_delta` 可以是对象，也可以是 JSON 字符串；引擎两者都接受。
 - 未知伏笔 key、未声明角色、`no_change` 缺原因都会被 `ENGINE_DELTA_UNVERIFIED` 拒绝，引擎不会猜。

package/lib/client.js

@@ -166,6 +166,7 @@ window.__ModuleLoader__.load({
 			advisories: [],
 			acknowledgedAdvisories: 0,
 			legacy: [],
+			pending: null,
 			nextTitle: "",
 			nextDetail: "",
 			nextTool: "",
@@ -392,6 +393,7 @@ window.__ModuleLoader__.load({
 				})),
 				acknowledgedAdvisories: summary.acknowledgedAdvisories ?? 0,
 				legacy: summary.legacy ?? [],
+				pending: summary.pending ?? null,
 				nextTitle: finished ? "" : next === void 0 ? "状态已同步" : toolLabel(next.tool),
 				nextDetail: finished ? "" : next === void 0 ? "没有待执行的下一步，刷新查看最新状态。" : NEXT_DETAILS[next.tool] ?? next.reason,
 				nextTool: next?.tool ?? "",
@@ -1005,6 +1007,11 @@ window.__ModuleLoader__.load({
   color: var(--nwe-muted);
   font-size: 11px;
 }
+
+.nwe-pending-section { border-left: 3px solid #c9a227; padding-left: 10px; }
+.nwe-pending-error { border-left-color: #b3261e; }
+.nwe-pending-detail { margin: 8px 0 0; color: var(--nwe-ink); font-size: 11px; line-height: 1.6; }
+.nwe-pending-hint { margin: 4px 0 0; color: var(--nwe-muted); font-size: 10px; line-height: 1.5; }
 .nwe-legacy {
   display: flex;
   gap: 8px;
@@ -1266,6 +1273,14 @@ brief P6 → check → brief P8 → archive 的顺序推进。
 				key: `${item.code}-${item.detail}`
 			}, (0, react.createElement)("code", { className: "nwe-advisory-code" }, item.code), (0, react.createElement)("span", { className: "nwe-advisory-detail" }, item.detail), item.hint === "" ? null : (0, react.createElement)("span", { className: "nwe-advisory-hint" }, item.hint)))));
 		};
+		const pendingSection = (view) => {
+			if (view.pending === null) return null;
+			const partial = view.pending.state === "partial";
+			return (0, react.createElement)("section", {
+				className: `nwe-section nwe-pending-section${partial ? " nwe-pending-error" : ""}`,
+				"aria-label": "待恢复事务"
+			}, (0, react.createElement)("div", { className: "nwe-section-head" }, (0, react.createElement)("h2", { className: "nwe-section-title" }, partial ? "事务部分完成" : "待恢复事务"), (0, react.createElement)("span", { className: "nwe-section-note" }, view.pending.state)), (0, react.createElement)("p", { className: "nwe-pending-detail" }, view.pending.detail), (0, react.createElement)("p", { className: "nwe-pending-hint" }, partial ? `检查 backups 与 .staging/${view.pending.txid}/before/，不要整项目恢复。` : "下一次写操作会自动收尾；只读面不会改动事务。"));
+		};
 		const legacySection = (view) => {
 			if (view.legacy.length === 0) return null;
 			return (0, react.createElement)("section", {
@@ -1553,7 +1568,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, 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), legacySection(view), chaptersSection(view)), (0, react.createElement)("aside", {
+			}, 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, 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

@@ -68,6 +68,9 @@ declare const ERROR_CODES: {
   /** The exact same keyed submission already failed in the same context. */
   readonly RETRY_UNCHANGED: "ENGINE_RETRY_UNCHANGED";
   readonly GATE_BLOCKED: "ENGINE_GATE_BLOCKED";
+  readonly CHECK_SUBMISSION_INVALID: "ENGINE_CHECK_SUBMISSION_INVALID";
+  readonly PENDING_PARTIAL: "ENGINE_PENDING_PARTIAL";
+  readonly IO_PERMISSION: "ENGINE_IO_PERMISSION";
   readonly READING_PROOF_INVALID: "ENGINE_READING_PROOF_INVALID";
   readonly SCORE_MISMATCH: "ENGINE_SCORE_MISMATCH";
   /** A revision tried to rewrite reviewer-owned issue fields. */
@@ -178,9 +181,14 @@ interface CheckDocument {
       evidence: string;
       note: string;
     }>;
+    /** 0.2.5: explain a persisted content failure; historical checks omit it. */
+    findings?: BlockingItem[];
   };
   /** Advisory codes the author has explicitly acknowledged for this content. */
   acknowledged?: string[];
+  /** 0.2.5: content failures consume the check budget; submission errors never persist. */
+  failure_class?: 'submission' | 'content';
+  counted?: boolean;
   verdict: 'pass' | 'fail';
 }
 /** Every persisted document whose damage status/panel can report. */
@@ -953,6 +961,10 @@ interface GateInput {
   summary: ChapterSummary | null;
   /** P5 may omit `summary`; when omitted, the previous plan summary is reused. */
   summaryProvided?: boolean;
+  /** Summary-only repair: no manuscript change, no P4/P6 proof requirement. */
+  summaryOnly?: boolean;
+  /** The last write was a summary-only repair; P6 may continue without a new brief. */
+  summaryOnlyRevision?: boolean;
   review: ReviewDocument | null;
   check: CheckDocument | null;
   /** When set, result-bearing gates run only the named check scopes. */
@@ -1030,6 +1042,8 @@ interface StatusReport {
   stage: Stage;
   rounds: RoundCounters;
   blocking: BlockingItem[];
+  /** Non-blocking recovery notes, e.g. a recoverable pending transaction. */
+  warnings?: Warning[];
   /** plan/review/check/ledger files that exist but cannot be read safely. */
   state_errors: StateError[];
   metrics: WordMetrics | null;
@@ -1122,6 +1136,20 @@ interface DiffReport {
 }
 /** Export capabilities; the last three are book-planning deliverables. */
 type ExportKind = 'md' | 'txt' | 'epub' | 'outline' | 'worldbook' | 'proposal';
+type SemanticItemState = 'pass' | 'fail' | 'missing' | 'invalid' | 'not_found' | 'too_short' | 'duplicate' | 'overlap' | 'same_sentence' | 'boundary';
+interface SemanticNearest {
+  paragraph: number;
+  quote: string;
+  score: number;
+}
+interface SemanticItemResult {
+  id: string;
+  state: SemanticItemState;
+  quote?: string;
+  detail?: string;
+  nearest?: SemanticNearest;
+  conflict_with?: string;
+}
 /** One blacklisted word. */
 interface TermEntry {
   term: string;
@@ -1454,6 +1482,12 @@ interface PanelSnapshot {
     code: string;
     detail: string;
   }>;
+  /** Crash-left pending transaction; complete/untouched are warnings. */
+  pending?: {
+    state: string;
+    txid: string;
+    detail: string;
+  };
 }
 interface PanelBook {
   premise: string;
@@ -1555,6 +1589,12 @@ interface PanelSummaryDto {
     code: string;
     detail: string;
   }>;
+  /** Crash-left pending transaction; complete/untouched are warnings. */
+  pending?: {
+    state: string;
+    txid: string;
+    detail: string;
+  };
 }
 interface PanelChapterRow {
   num: number;
@@ -1784,8 +1824,8 @@ interface RevisionSubmission extends Omit<RevisionInput, 'summary'> {
   summary?: ChapterSummary;
   /** Updated issue statuses/evidence; the review document is patched in place. */
   issues?: ReviewDocument['issues'];
-  /** Proof that the revised text was read; PG-09 verifies it against the new text. */
-  proof: ReadingProof;
+  /** Proof that the revised text was read; required for content/patch revisions. */
+  proof?: ReadingProof;
   root?: string;
 }
 interface CheckSubmission {
@@ -1875,6 +1915,7 @@ interface OutlineMutationResult {
   volumes: number;
   added: number[];
   updated: number[];
+  reindexed: number[];
   removed: number[];
   volumes_added: string[];
   volumes_updated: string[];
@@ -1882,6 +1923,7 @@ interface OutlineMutationResult {
   dry_run?: boolean;
   would_add?: number[];
   would_update?: number[];
+  would_reindex?: number[];
   would_remove?: number[];
 }
 interface OutlineSubmission extends OutlineInput {
@@ -1931,6 +1973,8 @@ declare class EngineService {
   private readonly stores;
   private readonly mutex;
   private readonly replay;
+  /** Bumped when an export artifact disappeared; makes the replay key miss. */
+  private readonly exportArtifactEpoch;
   /** Status, panel and gates ask for the same stage context repeatedly. */
   private readonly briefContextCache;
   private readonly briefs;
@@ -2126,6 +2170,8 @@ declare class EngineService {
     chapter: number;
     stage: Stage;
     metrics: WordMetrics;
+    summary_only?: boolean;
+    rounds_consumed?: 0 | 1;
   }>>;
   runCheck(input: CheckSubmission): Promise<OpResult<{
     chapter: number;
@@ -2136,12 +2182,26 @@ declare class EngineService {
     acknowledged: string[];
     metrics: WordMetrics;
     stage: Stage;
+    semantic: {
+      items: SemanticItemResult[];
+      findings: BlockingItem[];
+    };
+    rounds: {
+      check: number;
+    };
+    counted: boolean;
   }>>;
   archiveChapter(input: ArchiveSubmission): Promise<OpResult<{
     chapter: number;
     assigned_ids: Record<string, string>;
     metrics: WordMetrics;
     score: number;
+    delta_warnings?: Warning[];
+    normalized_world?: Record<string, {
+      from: 'created' | 'updated' | 'no_change';
+      to: 'created' | 'updated' | 'no_change';
+      reason: 'existing-created-as-updated' | 'missing-updated-as-created' | 'missing-no-change-as-created';
+    }>;
   }>>;
   amend(input: AmendSubmission): Promise<OpResult<{
     path: string;
@@ -2320,6 +2380,12 @@ declare class EngineService {
    * could not read.
    */
   private assertPlanningDocumentReadable;
+  /**
+   * `strict_explicit` is an internal provenance bit, not an author choice.
+   * Exposing it lets a caller forge "the author chose strict:false" without
+   * going through the strict option. Stored documents may still contain it.
+   */
+  private assertPublicBookHasNoStrictExplicit;
   /**
    * An import is a full replacement, unlike novel_outline's keyed upsert. It
    * must not silently lose the active card while strict mode still requires it.