dsh-novel-write-engine 0.2.7 → 0.2.9

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;
@@ -75,6 +95,7 @@ export interface SummaryDto {
     };
     quality?: {
         averageScore: number;
+        last_ten_average?: number | null;
         scores: number[];
         trend: number | null;
         trend_basis?: 'last_five_vs_previous_five' | 'insufficient_samples' | 'insufficient_history';
@@ -117,7 +138,7 @@ export interface ChapterRowDto {
     num: number;
     title: string;
     wordCount: number;
-    score: number;
+    score: number | null;
     stage: string;
     status: 'passed' | 'blocked' | 'draft';
     details?: string;
@@ -136,13 +157,6 @@ export interface ChaptersDto {
     panelId: string;
     rows: ChapterRowDto[];
 }
-export interface GatesDto {
-    schemaVersion: number;
-    panelId: string;
-    stage: string;
-    blocking: BlockingDto[];
-    explanations: string[];
-}
 export interface ProjectOptionDto {
     root: string;
     title: string;
@@ -168,11 +182,20 @@ export interface PanelPayloadDto {
     selection: PanelSelectionDto;
     summary?: SummaryDto;
     chapters?: ChaptersDto;
-    gates?: GatesDto;
     resume?: {
         text: string;
     };
     missing?: PanelMissingDto;
     error?: string;
     empty?: true;
+    /** Additive v7 section payload. */
+    payload_version?: 7;
+    section?: string;
+    items?: unknown;
+    total?: number;
+    returned?: number;
+    truncated?: boolean;
+    next_cursor?: string | null;
+    updated_at?: string;
+    etag?: string;
 }

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

@@ -1,10 +1,28 @@
 import { type ReactElement } from 'react';
 import { buildView, type PanelView } from './viewmodel.js';
+import type { PanelPayloadDto } from './dto.js';
+export type PanelTab = 'overview' | 'chapters' | 'characters' | 'foreshadows' | 'worldbook' | 'quality' | 'health';
+export interface PanelSectionState {
+    loading: boolean;
+    error: string | null;
+    payload: PanelPayloadDto | null;
+}
+export interface ChapterQuery {
+    search: string;
+    status: 'all' | 'archived' | 'draft';
+    scene: string;
+    sort: 'num_asc' | 'num_desc';
+    cursor: string;
+}
+export interface ChapterDetailState {
+    chapter: number;
+    section: PanelSectionState;
+}
 /**
  * Pure view: given a view model, return the element tree. Keeping the hooks in
  * `NovelPanel` makes every visual state renderable without a browser.
  */
-export declare function panelElement(view: PanelView, loading: boolean, onRefresh: () => void, onSelectProject?: (root: string | null) => void): ReactElement;
+export declare function panelElement(view: PanelView, loading: boolean, onRefresh: () => void, onSelectProject?: (root: string | null) => void, tab?: PanelTab, onTab?: (tab: PanelTab) => void, section?: PanelSectionState | null, chapterQuery?: ChapterQuery, onChapterQuery?: (patch: Partial<ChapterQuery>) => void, sectionSearch?: string, onSectionSearch?: (value: string) => void, chapterDetail?: ChapterDetailState | null, onChapterDetail?: (chapter: number | null) => void, qualityDetail?: ChapterDetailState | null, onQualityDetail?: (chapter: number | null) => void): ReactElement;
 /** Stateful wrapper: fetch once, refresh on demand and after returning to the tab. */
 export declare function NovelPanel(): ReactElement;
 /** Sidebar icon: a small book mark, inheriting the current text colour. */

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

@@ -14,8 +14,8 @@ export interface PanelChapter {
     words: string;
     wordCount: number;
     score: string;
-    scoreValue: number;
-    scorePercent: number;
+    scoreValue: number | null;
+    scorePercent: number | null;
     badge: string;
     tone: 'ok' | 'bad' | 'muted';
     details: string;
@@ -69,6 +69,8 @@ export interface PanelView {
     stageLabel: string;
     /** The whole book reached its configured target; stage `done` alone is only one chapter. */
     finished: boolean;
+    /** Active chapter number for lazy quality detail. */
+    chapter: number;
     revisionLabel: string;
     phases: PanelPhase[];
     rows: PanelChapter[];
@@ -82,6 +84,8 @@ export interface PanelView {
     stats: {
         chapters: number;
         words: number;
+        archivedWords?: number;
+        draftWords?: number;
         averageScore: number;
         blocking: number;
     };
@@ -117,7 +121,7 @@ export interface PanelView {
     };
     quality: {
         averageScore: number;
-        lastTenAverage: number;
+        lastTenAverage: number | null;
         bookMedian: number;
         bookMin: number;
         bookMax: number;
@@ -125,6 +129,7 @@ export interface PanelView {
             id: string;
             average: number;
             samples: number;
+            max?: number;
         }>;
         scores: number[];
         trend: number | null;
@@ -169,6 +174,9 @@ export interface PanelView {
     nextDetail: string;
     nextTool: string;
     emptyCommand: string;
+    /** Last successful sync / last background failure; filled by NovelPanel. */
+    lastSync?: string | null;
+    syncError?: string | null;
     /** Compatibility fields used by older cards and tests. */
     revision: string;
     next: string;
@@ -181,7 +189,8 @@ export declare const PANEL_SCHEMA_VERSION = 6;
  */
 export declare function buildView(payload: PanelPayloadDto | null, error?: string | null): PanelView;
 /** Fetch the panel payload; failures become a plain message, never a throw. */
-export declare function fetchPanel(fetcher: typeof fetch, path: string, signal?: AbortSignal): Promise<{
+export declare function fetchPanel(fetcher: typeof fetch, path: string, signal?: AbortSignal, etag?: string): Promise<{
     payload: PanelPayloadDto | null;
     error: string | null;
+    notModified?: boolean;
 }>;

package/lib/types/constants.d.ts

@@ -5,6 +5,8 @@ export declare const PANEL_ID = "novel-workshop";
 export declare const PANEL_ROUTE = "/api/novel-write-engine/panel";
 export declare const SKILL_NAME = "novel-write-engine";
 export declare const REMOTE_VERSION = 6;
+/** User-visible panel/tutorial version; keep in sync with package.json. */
+export declare const PANEL_VERSION = "0.2.9";
 /** The panel is a recent-history view; the wire payload and UI use one cap. */
 export declare const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */

package/lib/types/panel-contract.d.ts

@@ -45,7 +45,7 @@ export interface PanelBookData {
         average_words: number;
         remaining_words: number | null;
         remaining_words_basis: 'actual_average' | 'minimum_target' | 'none';
-        percent: number;
+        percent: number | null;
     };
     current: {
         card: PanelCardData | null;
@@ -93,7 +93,7 @@ export interface PanelBookData {
         median: number;
         min: number;
         max: number;
-        last_ten_average: number;
+        last_ten_average: number | null;
         trend: number | null;
         trend_basis: BookReport['quality']['trend_basis'];
         samples: number;

package/lib/types/types.d.ts

@@ -217,6 +217,18 @@ export interface WordMetrics {
     paragraph_count: number;
     paragraph_max_words: number;
 }
+/** Protected evidence copied from the archived outline card at archive time. */
+export interface ArchivedCardSnapshot {
+    title: string;
+    scene_type: SceneType;
+    target_words: [number, number];
+    cast: string[];
+    goal: string;
+    conflict: string;
+    hook: string;
+    notes: string;
+    archived_at: string | null;
+}
 /** Derived chapter row kept in `state/chapters.yaml`. */
 export interface ChapterRecord {
     num: number;
@@ -239,6 +251,10 @@ export interface ChapterRecord {
     assigned_ids?: Record<string, string>;
     /** Digest of the archive request that produced this row. */
     archive_digest?: string;
+    /** Immutable card fields written by the archive transaction, not by amend. */
+    archive_card?: ArchivedCardSnapshot;
+    /** Canonical digest of archive_card; v1-prefixed like archive_digest. */
+    archive_card_digest?: string;
 }
 /** Summary block the model supplies with a draft and the engine persists. */
 export interface ChapterSummary {
@@ -301,8 +317,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;
     };
@@ -760,7 +776,7 @@ export interface BookReport {
         target: number | null;
         words: number;
         average_words: number;
-        percent: number;
+        percent: number | null;
         remaining_words: number | null;
         remaining_words_min: number | null;
         remaining_words_average: number | null;
@@ -825,6 +841,7 @@ export interface BookReport {
             id: string;
             average: number;
             samples: number;
+            max: number;
         }>;
     };
     /** Per-chapter effort survives archive (pipeline rounds are reset). */
@@ -972,6 +989,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 +1053,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 +1103,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 +1157,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.9",
   "description": "Novel writing engine for DeepSeek Harness: state machine, gates, rulepacks and ledgers moved from prompts into code.",
   "keywords": [
     "dsh-plugin",
@@ -63,7 +63,8 @@
       ],
       "external": [
         "react",
-        "react/jsx-runtime"
+        "react/jsx-runtime",
+        "react-dom"
       ]
     }
   },
@@ -98,7 +99,8 @@
     "@deepseek-ai/dsh-skill": "^0.2.0-rc.1 || ^0.2.1-rc.1",
     "@deepseek-ai/schemastery": "^3.18.5",
     "@deepseek-ai/dsh-tools": "^0.2.0-rc.1 || ^0.2.1-rc.1",
-    "react": "^18.0.0 || ^19.0.0"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-client-ui-layout": {
@@ -112,6 +114,9 @@
     },
     "react": {
       "optional": true
+    },
+    "react-dom": {
+      "optional": true
     }
   },
   "devDependencies": {

package/presets/novel-write-engine.patch.yml

@@ -17,6 +17,10 @@
                 - 正文只经 novel_write_draft，改稿只经 novel_revise；归档只走 novel_archive，且必须带 state_delta。没有别的写入口。
                 - 字数、引号、格式、门控结论一律以引擎返回为准，不要自己估算，也不要复述旧数字。
                 - 评审每一分都要指到具体扣分项；指不出来就不要扣。
+                - 参数是严格 JSON：只用英文双引号，不写注释、尾逗号和 Markdown 围栏；不要把对象再包成 JSON 字符串，不要重复编码。
+                - 写工具一次只提交一个：novel_write_draft、novel_review、novel_check、novel_archive 读完结果再走下一步。
+                - 参数解析失败时不要原样重发大对象；先 novel_brief 重取当前阶段字段，缩小对象并逐字段核对。
+                - 归档只带 state_delta，不带 summary；归档后下一章从 novel_brief P1 重新开始。
                 - 设定、前章细节、伏笔状态拿不准就查 novel_state，不许编。
           - { id: time-context, name: '@deepseek-ai/dsh-time-context' }
           - { id: tool-skill, name: '@deepseek-ai/dsh-tool-skill' }

package/rulepacks/default.yaml

@@ -1,6 +1,6 @@
 schema_version: 1
 name: default
-version: "1.0.1"
+version: "1.1.0"
 
 lexicon:
   zero_tolerance:
@@ -182,10 +182,16 @@ platform:
   jinjiang: { words_per_chapter: [2500, 4000], dialogue_ratio: [0.35, 0.55] }
 
 genres:
-  玄幻修仙: { note: "力量体系必须自洽；升级要有代价，境界不能靠形容词抬升。" }
-  都市现代: { note: "现实都市，冲突来自资源、关系与规则；爽点要落在可验证的行动上。" }
+  玄幻修仙:
+    note: "力量体系必须自洽；升级要有代价，境界不能靠形容词抬升。"
+    profile: { water_words: 0.30, pleasure_density: 2 }
+  都市现代:
+    note: "现实都市，冲突来自资源、关系与规则；爽点要落在可验证的行动上。"
+    profile: { water_words: 0.32, pleasure_density: 1 }
   西方奇幻: { note: "种族、语言与力量来源要建条目；奇观不能替代人物选择。" }
-  悬疑推理: { note: "线索先于解答出现；每个伏笔都要在归档台账中可核销。" }
+  悬疑推理:
+    note: "线索先于解答出现；每个伏笔都要在归档台账中可核销。"
+    profile: { period_density: { min: 1.5, max: 12 }, water_words: 0.30 }
   科幻: { note: "技术设定只写对情节有用的部分；禁止用术语代替冲突。" }
   游戏系统: { note: "系统提示是世界观内文本；奖励与惩罚必须可追踪。" }
   历史架空: { note: "礼制、称谓与器物要经得起基本推敲；不写现代口号。" }
@@ -193,7 +199,9 @@ genres:
   轻小说: { note: "关系推进靠具体互动，不靠内心独白宣布；对话要能区分说话人。" }
   军事: { note: "战术细节服务于人物选择；不写武器参数清单。" }
   末世流: { note: "生存资源必须记账；恐惧来自规则崩塌，不靠突然的音效式形容词。" }
-  言情: { note: "亲密关系按阶梯推进；单次独白要短，情绪落在动作上。" }
+  言情:
+    note: "亲密关系按阶梯推进；单次独白要短，情绪落在动作上。"
+    profile: { period_density: { min: 1.5, max: 12 }, pleasure_density: 2 }
 
 crosschapter:
   duplicate_similarity: 0.9

package/skills/entry.md

@@ -77,7 +77,8 @@ description: 引擎版小说创作流程——状态、门控、字数与写盘
 
 ## 工具怎么用
 
-- 参数是 JSON 对象；`summary`、`dimensions`、`issues`、`proof` 是结构化对象，按任务书字段填。
+- 参数是严格 JSON 对象：英文双引号、无注释/尾逗号/围栏；`summary`、`dimensions`、`issues`、`proof` 是结构化对象/数组，按任务书字段填，不要再包成 JSON 字符串。
+- 写工具一次只提交一个；参数解析失败时先重取 `novel_brief`，缩小对象再试，不要原样重发。
 - `novel_check` 必须带五个语义项（`L2-SCENE-ANCHOR` / `L2-CHARACTER-STATE` / `L2-CAUSALITY` / `L2-VOICE` / `L2-POV`），每项都要有正文逐字引用，且来自不同句子；缺一项即校验不过。
 - 失败分三类：参数错（改参数）、门控没过（改正文）、系统故障（查目录/稍后重试）。错误消息里的 code 说明属于哪类。
 - 门控失败会一次列出**全部**阻塞项；一次改完再交，不要逐条试。