dsh-novel-write-engine 0.2.8 → 0.2.10

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

@@ -95,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';
@@ -137,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;
@@ -156,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;
@@ -188,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[];
@@ -119,7 +121,7 @@ export interface PanelView {
     };
     quality: {
         averageScore: number;
-        lastTenAverage: number;
+        lastTenAverage: number | null;
         bookMedian: number;
         bookMin: number;
         bookMax: number;
@@ -127,6 +129,7 @@ export interface PanelView {
             id: string;
             average: number;
             samples: number;
+            max?: number;
         }>;
         scores: number[];
         trend: number | null;
@@ -171,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;
@@ -183,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.10";
 /** 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 {
@@ -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). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-novel-write-engine",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "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 说明属于哪类。
 - 门控失败会一次列出**全部**阻塞项；一次改完再交，不要逐条试。