dsh-novel-write-engine 0.2.1 → 0.2.3

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

@@ -13,6 +13,8 @@ export interface BlockingDto {
 export interface SummaryDto {
     schemaVersion: number;
     panelId: string;
+    /** Absolute project root, so a stale title cannot hide a wrong book. */
+    root: string;
     title: string;
     genre: string;
     platform: string;
@@ -73,7 +75,10 @@ export interface SummaryDto {
     quality?: {
         averageScore: number;
         scores: number[];
-        trend: number;
+        trend: number | null;
+        trend_basis?: 'last_five_vs_previous_five' | 'insufficient_samples' | 'insufficient_history';
+        samples?: number;
+        attempts?: number;
     };
     health?: {
         ok: boolean;
@@ -86,6 +91,17 @@ export interface SummaryDto {
         chapter: number;
         status: string;
     }>;
+    advisories?: Array<{
+        code: string;
+        detail: string;
+        hint?: string;
+    }>;
+    /** Advisory codes the author has already acknowledged in the current check. */
+    acknowledgedAdvisories?: number;
+    legacy?: Array<{
+        code: string;
+        detail: string;
+    }>;
 }
 export interface ChapterRowDto {
     num: number;
@@ -108,11 +124,36 @@ export interface GatesDto {
     blocking: BlockingDto[];
     explanations: string[];
 }
+export interface ProjectOptionDto {
+    root: string;
+    title: string;
+    active: boolean;
+    registered: boolean;
+    state: 'ok' | 'damaged' | 'missing' | 'not-project' | 'unreadable';
+    identity_changed?: boolean;
+}
+export interface PanelSelectionDto {
+    root: string | null;
+    source: 'query' | 'active' | 'single' | 'config' | 'none';
+}
+export interface PanelMissingDto {
+    root: string;
+    title: string;
+    code: 'ENGINE_PROJECT_MISSING' | 'ENGINE_PROJECT_NOT_FOUND' | 'ENGINE_TXN_IN_PROGRESS';
+    reason: 'missing' | 'not-project' | 'damaged' | 'not_registered' | 'unreadable' | 'busy';
+    hint: string;
+}
 export interface PanelPayloadDto {
     schemaVersion: number;
-    summary: SummaryDto;
-    chapters: ChaptersDto;
-    gates: GatesDto;
+    projects: ProjectOptionDto[];
+    selection: PanelSelectionDto;
+    summary?: SummaryDto;
+    chapters?: ChaptersDto;
+    gates?: GatesDto;
+    resume?: {
+        text: string;
+    };
+    missing?: PanelMissingDto;
     error?: string;
     empty?: true;
 }

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

@@ -4,7 +4,7 @@ import { buildView, type PanelView } from './viewmodel.js';
  * 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): ReactElement;
+export declare function panelElement(view: PanelView, loading: boolean, onRefresh: () => void, onSelectProject?: (root: string | 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

@@ -20,11 +20,42 @@ export interface PanelChapter {
     details: string;
     stageLabel: string;
 }
+export interface PanelProject {
+    root: string;
+    title: string;
+    label: string;
+    active: boolean;
+    registered: boolean;
+    state: 'ok' | 'damaged' | 'missing' | 'not-project' | 'unreadable';
+    identity_changed?: boolean;
+    group: 'writing' | 'damaged' | 'missing';
+    selected: boolean;
+}
+export interface PanelMissing {
+    root: string;
+    title: string;
+    code: string;
+    reason: string;
+    hint: string;
+}
 /** Everything the panel renders, derived from the wire payload alone. */
 export interface PanelView {
-    state: 'ready' | 'loading' | 'empty' | 'error' | 'outdated';
+    state: 'ready' | 'loading' | 'empty' | 'error' | 'outdated' | 'choose' | 'missing';
     title: string;
     subtitle: string;
+    /** Absolute root of the selected project, when there is one. */
+    root: string;
+    projects: PanelProject[];
+    selectedRoot: string | null;
+    selection: {
+        root: string | null;
+        source: string;
+    };
+    missing?: PanelMissing;
+    resumeText: string;
+    /** True when the selected project exists but its definition is damaged. */
+    damaged: boolean;
+    volumeNumber?: number;
     stageLabel: string;
     /** The whole book reached its configured target; stage `done` alone is only one chapter. */
     finished: boolean;
@@ -76,7 +107,10 @@ export interface PanelView {
     quality: {
         averageScore: number;
         scores: number[];
-        trend: number;
+        trend: number | null;
+        trendText: string;
+        samples: number;
+        attempts: number;
     };
     health: {
         ok: boolean;
@@ -89,6 +123,19 @@ export interface PanelView {
         chapter: number;
         status: string;
     }>;
+    /** Machine advisories, shown separately from blocking gates. */
+    advisories: Array<{
+        code: string;
+        detail: string;
+        hint: string;
+    }>;
+    /** How many advisory codes the author already acknowledged. */
+    acknowledgedAdvisories: number;
+    /** Read-only upgrade findings, shown separately from live errors. */
+    legacy: Array<{
+        code: string;
+        detail: string;
+    }>;
     nextTitle: string;
     nextDetail: string;
     nextTool: string;
@@ -97,7 +144,7 @@ export interface PanelView {
     revision: string;
     next: string;
 }
-export declare const PANEL_SCHEMA_VERSION = 3;
+export declare const PANEL_SCHEMA_VERSION = 5;
 /**
  * Project the wire payload into strings. Version mismatch wins over everything
  * else: a stale panel must never render data from another schema as if it were

package/lib/types/constants.d.ts

@@ -4,7 +4,7 @@ export declare const PLUGIN_NAME = "dsh-novel-write-engine";
 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 = 3;
+export declare const REMOTE_VERSION = 5;
 /** 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. */
@@ -25,6 +25,9 @@ export declare const OUTLINE_DIR = "outline";
 export declare const LOCK_FILE = ".engine.lock";
 export declare const STAGING_DIR = ".staging";
 export declare const REGISTRY_FILE = "projects.yaml";
+export declare const SESSION_BINDINGS_FILE = "session-bindings.yaml";
+export declare const METADATA_LOCK_FILE = ".metadata.lock";
+export declare const ARCHIVE_DIGESTS_FILE = "state/archive-digests.json";
 /** Files owned by the engine under `state/`. */
 export declare const STATE_FILES: {
     readonly pipeline: "pipeline.yaml";

package/lib/types/types.d.ts

@@ -20,7 +20,7 @@ export declare const SCENE_TYPES: readonly ["战斗/动作章", "日常过渡章
 export type SceneType = (typeof SCENE_TYPES)[number];
 /** A violation is blocking unless the rule pack declares it advisory. */
 export type Severity = 'blocker' | 'advisory';
-/** All thirty-one service operations (22 inherited from 0.1.x, 9 book-level). */
+/** All thirty-two service operations (22 inherited + 9 book-level + restoreBackup). */
 export declare const OPERATIONS: readonly ["initProject", "archiveChapter", "amend", "rollback", "reopenChapter", "submitWorldPlan", "submitChapterPlan", "submitDraft", "submitReview", "submitRevision", "runCheck", "submitBookPlan", "submitOutline", "importOutline", "submitWorldbook", "getStatus", "getBrief", "countWords", "queryState", "diff", "auditHistory", "advise", "search", "doctor", "report", "guide", "export", "panelSummary", "panelChapters", "panelGates", "stats", "restoreBackup"];
 export type Operation = (typeof OPERATIONS)[number];
 /** Structured, non-fatal note attached to a successful result. */
@@ -58,11 +58,18 @@ export interface ReadingProof {
 /** Error families map one-to-one to the three repair actions a caller can take. */
 export declare const ERROR_CODES: {
     readonly PROJECT_NOT_FOUND: "ENGINE_PROJECT_NOT_FOUND";
+    readonly PROJECT_AMBIGUOUS: "ENGINE_PROJECT_AMBIGUOUS";
+    readonly PROJECT_MISSING: "ENGINE_PROJECT_MISSING";
+    readonly PROJECT_IDENTITY_MISMATCH: "ENGINE_PROJECT_IDENTITY_MISMATCH";
     readonly PROJECT_EXISTS: "ENGINE_PROJECT_EXISTS";
     readonly STAGE_ORDER: "ENGINE_STAGE_ORDER";
+    /** The exact same keyed submission already failed in the same context. */
+    readonly RETRY_UNCHANGED: "ENGINE_RETRY_UNCHANGED";
     readonly GATE_BLOCKED: "ENGINE_GATE_BLOCKED";
     readonly READING_PROOF_INVALID: "ENGINE_READING_PROOF_INVALID";
     readonly SCORE_MISMATCH: "ENGINE_SCORE_MISMATCH";
+    /** A revision tried to rewrite reviewer-owned issue fields. */
+    readonly ISSUE_IMMUTABLE: "ENGINE_ISSUE_IMMUTABLE";
     readonly DELTA_UNVERIFIED: "ENGINE_DELTA_UNVERIFIED";
     readonly RESOURCE_NEGATIVE_BALANCE: "ENGINE_RESOURCE_NEGATIVE_BALANCE";
     readonly SCHEMA_TOO_NEW: "ENGINE_SCHEMA_TOO_NEW";
@@ -461,6 +468,8 @@ export interface ForeshadowsDocument {
         resolved_at: number | null;
         description: string;
         anchor?: string;
+        /** New 0.2.3 writes are distinguishable from pre-0.2.3 rows by this marker. */
+        format_version?: 1;
         advance_log: Array<{
             chapter: number;
             note: string;
@@ -783,7 +792,13 @@ export interface BookReport {
         min: number;
         max: number;
         last_five: number[];
-        trend: number;
+        /** Null when there are not enough distinct chapter reviews to compare. */
+        trend: number | null;
+        trend_basis: 'last_five_vs_previous_five' | 'insufficient_samples' | 'insufficient_history';
+        /** Number of chapters represented by a final review. */
+        samples: number;
+        /** Committed review rounds for this report, including history. */
+        attempts: number;
         dimensions: Array<{
             id: string;
             average: number;
@@ -984,6 +999,15 @@ export interface ChapterStatusRow {
     stage: Stage;
     passed: boolean;
 }
+/** Where an omitted project root came from. */
+export type SelectionSource = 'explicit' | 'session' | 'workspace' | 'active' | 'config' | 'single';
+/** One resolved project choice, before the project is loaded. */
+export interface Selection {
+    root: string;
+    source: SelectionSource;
+    title?: string;
+    created_at?: string;
+}
 /** The `getStatus` payload. */
 export interface StatusReport {
     project: {
@@ -992,10 +1016,17 @@ export interface StatusReport {
         platform: Platform;
         root: string;
     };
+    /** Why this project was chosen; lets the model notice a wrong book. */
+    selection?: {
+        source: SelectionSource;
+        root: string;
+    };
     /** The chapter requested for metrics; may be historical. */
     chapter: number;
     /** The chapter the pipeline is currently working on. */
     active_chapter: number;
+    /** SHA-256 of the active manuscript, or null when the stage has no draft. */
+    manuscript_hash: string | null;
     stage: Stage;
     rounds: RoundCounters;
     blocking: BlockingItem[];
@@ -1072,6 +1103,10 @@ export interface AuditRow {
     /** True when no transaction started: the gate/input refused the call. */
     attempt?: boolean;
     blocking?: BlockingItem[];
+    /** Keyed operation fingerprint; lets an identical failed retry be refused. */
+    retry_key?: string;
+    /** Brief/stage/revision context for `retry_key`. */
+    retry_context?: string;
 }
 /** One diff hunk between two revisions of a chapter. */
 export interface DiffReport {

package/package.json

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

package/rulepacks/default.yaml

@@ -1,6 +1,6 @@
 schema_version: 1
 name: default
-version: "1.0.0"
+version: "1.0.1"
 
 lexicon:
   zero_tolerance:
@@ -145,7 +145,9 @@ punctuation:
     base: { 战斗/动作章: 3, 日常过渡章: 4, 情感爆发章: 6, 纯叙事章: 3 }
     scale_words: 3000
     token: "——"
-  period_density: { min: 1.5, max: 8 }
+  # Chinese web fiction often uses short sentences; 8/100 flagged ordinary
+  # narrative (e.g. 9.52/100). Keep a ceiling, but calibrate it for Chinese.
+  period_density: { min: 1.5, max: 10 }
   ellipsis_run: { max: 1, token: "……" }
   uniform_sentence: { min_sentences: 8, ratio: 0.6 }
   consecutive_le: { max: 3, char: "了" }

package/skills/entry.md

@@ -16,6 +16,13 @@ description: 引擎版小说创作流程——状态、门控、字数与写盘
 5. **不编设定。** 人物、地点、伏笔、资源状态拿不准就 `novel_state` 查。
 6. **归档是一次事务，且必须核销。** `novel_archive` 必须带 `state_delta`：本章每个角色/伏笔/事件/新设定/关系逐条声明 `created|updated|no_change`；不要手工拼章节索引或交接文件。
 
+## 项目选择（0.2.2）
+
+- 第一次调用先 `novel_status`，看 `selection.root` 与 `selection.source`；不要凭记忆猜项目。
+- 没有绑定且工作区/注册表有多本书时，引擎返回 `ENGINE_PROJECT_AMBIGUOUS` 并列出候选；这时显式传一次绝对 `project_root`，成功后它会成为当前会话的持久绑定，后续省略即沿用。不要用全局 `active` 猜。
+- 用户要切换时，用 `/novel use <路径|书名|.>`；`/novel current` 查绑定，`/novel unbind` 只清会话绑定，`/novel scan` 只发现/登记、不选择。
+- `novel_word_count` 的纯文本模式与 `novel_diff` 的 `before`+`after` 文本模式不读项目、不绑定；项目模式才传 `project_root`。
+
 ## 书级规划（0.2.0）
 
 新项目先 `novel_guide`；推荐但不强制：`novel_blueprint`（蓝图/卷）→ `novel_outline`（章卡）→ `novel_worldbook`（设定集）。已有大纲可用 `novel_outline_import` 导入 Markdown/YAML/JSON。只要存在章卡，P2/P3 就按章卡校验标题、场景、字数与 cast；严格模式还要求章卡必须存在。要改已归档章先 `novel_reopen`（必须带 reason）。