dsh-novel-write-engine 0.2.0 → 0.2.1

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

@@ -45,7 +45,12 @@ export interface SummaryDto {
             total: number;
             planned: number;
             archived: number;
+            target?: number | null;
+            missing_cards?: number;
+            planned_coverage?: number | null;
+            archived_coverage?: number | null;
             coverage: number;
+            card_coverage?: number;
             volumes: Array<{
                 title: string;
                 start: number;
@@ -62,6 +67,7 @@ export interface SummaryDto {
             rules: number;
             glossary: number;
             backstory: number;
+            facts?: number;
         };
     };
     quality?: {

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

@@ -53,6 +53,10 @@ export interface PanelView {
         outlineTotal: number;
         archivedCards: number;
         coverage: number;
+        missingCards: number;
+        plannedCoverage: number | null;
+        archivedCoverage: number | null;
+        cardCoverage: number;
         volumes: Array<{
             title: string;
             range: string;
@@ -66,6 +70,7 @@ export interface PanelView {
             rules: number;
             glossary: number;
             backstory: number;
+            facts?: number;
         };
     };
     quality: {
@@ -92,7 +97,7 @@ export interface PanelView {
     revision: string;
     next: string;
 }
-export declare const PANEL_SCHEMA_VERSION = 2;
+export declare const PANEL_SCHEMA_VERSION = 3;
 /**
  * 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 = 2;
+export declare const REMOTE_VERSION = 3;
 /** 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. */
@@ -18,6 +18,9 @@ export declare const REVIEW_DIR = "reviews";
 export declare const CHECK_DIR = "checks";
 export declare const EXPORT_DIR = "exports";
 export declare const BACKUP_DIR = "backups";
+export declare const HISTORY_DIR = "history";
+/** Brief receipts are append-only evidence, separate from content transactions. */
+export declare const BRIEF_RECEIPTS_FILE = "state/briefs.yaml";
 export declare const OUTLINE_DIR = "outline";
 export declare const LOCK_FILE = ".engine.lock";
 export declare const STAGING_DIR = ".staging";
@@ -43,6 +46,13 @@ export declare const planWorldFile: (chapter: number) => string;
 export declare const planChapterFile: (chapter: number) => string;
 export declare const reviewFile: (chapter: number) => string;
 export declare const checkFile: (chapter: number) => string;
+export declare const reviewHistoryFile: (chapter: number, revision: number) => string;
+export declare const checkHistoryFile: (chapter: number, revision: number) => string;
+export declare const chapterHistoryFile: (chapter: number, revision: number) => string;
+export declare const deprecatedHistoryFile: (chapter: number, revision: number) => string;
+export declare const planHistoryFile: (chapter: number, revision: number) => string;
+export declare const HISTORY_KINDS: readonly ["reviews", "checks", "chapters", "deprecated", "plans"];
+export type HistoryKind = (typeof HISTORY_KINDS)[number];
 /** Limits that are structural, not taste. */
 export declare const LIMITS: {
     /** P4 <-> P5/P6 retries before a forced rollback. */
@@ -76,7 +86,7 @@ export declare const INITIAL_STAGE: Stage;
 /** The order used to render the nine-phase progress strip. */
 export declare const PHASE_STRIP: readonly ["P1", "P2", "P3", "P4", "P5", "P6", "P7", "P8", "P9"];
 /** Tool names, kept here so the arch test can assert one namespace. */
-export declare const TOOL_NAMES: readonly ["novel_init", "novel_status", "novel_brief", "novel_plan_world", "novel_plan_chapter", "novel_write_draft", "novel_review", "novel_revise", "novel_check", "novel_archive", "novel_word_count", "novel_state", "novel_amend", "novel_rollback", "novel_diff", "novel_export", "novel_audit", "novel_pipeline", "novel_blueprint", "novel_outline", "novel_outline_import", "novel_worldbook", "novel_search", "novel_doctor", "novel_report", "novel_guide", "novel_reopen"];
+export declare const TOOL_NAMES: readonly ["novel_init", "novel_status", "novel_brief", "novel_plan_world", "novel_plan_chapter", "novel_write_draft", "novel_review", "novel_revise", "novel_check", "novel_archive", "novel_word_count", "novel_state", "novel_amend", "novel_rollback", "novel_diff", "novel_export", "novel_audit", "novel_pipeline", "novel_blueprint", "novel_outline", "novel_outline_import", "novel_worldbook", "novel_search", "novel_doctor", "novel_report", "novel_guide", "novel_reopen", "novel_restore"];
 export type ToolName = (typeof TOOL_NAMES)[number];
 /** The ten high-frequency tools kept when `tools.mode = core`. */
 export declare const CORE_TOOLS: readonly ToolName[];

package/lib/types/types.d.ts

@@ -21,7 +21,7 @@ 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). */
-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"];
+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. */
 export interface Warning {
@@ -161,6 +161,7 @@ export interface CheckDocument {
     content_hash: string;
     machine: {
         violations: Violation[];
+        advisories?: Violation[];
         metrics: WordMetrics;
     };
     semantic: {
@@ -171,6 +172,8 @@ export interface CheckDocument {
             note: string;
         }>;
     };
+    /** Advisory codes the author has explicitly acknowledged for this content. */
+    acknowledged?: string[];
     verdict: 'pass' | 'fail';
 }
 /** Every persisted document whose damage status/panel can report. */
@@ -189,6 +192,8 @@ export interface WordMetrics {
     numbers: number;
     chinese_punct: number;
     english_punct: number;
+    /** All punctuation counted by the engine; total = cjk + words + numbers + punctuation. */
+    punctuation_chars: number;
     non_ws_chars: number;
     total_lines: number;
     non_empty_lines: number;
@@ -211,6 +216,10 @@ export interface ChapterRecord {
     status: 'draft' | 'reviewed';
     content_hash: string;
     summary: ChapterSummary;
+    /** How hard this chapter was before it was archived. */
+    rounds?: RoundCounters;
+    final_check?: 'pass' | 'fail';
+    archived_at?: string;
     /** Keys allocated by the archive transaction; lets a cross-process retry replay. */
     assigned_ids?: Record<string, string>;
     /** Digest of the archive request that produced this row. */
@@ -225,6 +234,7 @@ export interface ChapterSummary {
             key: string;
             title: string;
             description: string;
+            anchor?: string;
         }>;
         advanced: Array<{
             key: string;
@@ -258,6 +268,8 @@ export interface RoundCounters {
     review: number;
     revise: number;
     check: number;
+    /** Lifetime rollback count on a chapter record; never stored in the live pipeline. */
+    rollbacks?: number;
 }
 /** How one ledger entity changed in this chapter. */
 export type DeltaAction = 'created' | 'updated' | 'no_change';
@@ -289,6 +301,8 @@ export interface ForeshadowDelta {
     action: DeltaAction;
     reason?: string;
     title?: string;
+    /** Verbatim manuscript quote used for verification; title stays a readable label. */
+    anchor?: string;
     description?: string;
     note?: string;
     new_info?: boolean;
@@ -331,6 +345,28 @@ export interface ArchiveHandoff {
     act?: string;
     act_progress?: string;
 }
+/** One issued task-book receipt; the brief itself is rendered on demand. */
+export interface BriefReceipt {
+    chapter: number;
+    stage: BriefStage;
+    digest: string;
+    issued_at: string;
+}
+/** `state/briefs.yaml`: append-only task-book evidence outside content transactions. */
+export interface BriefReceiptsDocument {
+    schema_version: 1;
+    receipts: BriefReceipt[];
+}
+/** The active draft's own metadata; P2 plan stays immutable after submission. */
+export interface DraftState {
+    chapter: number;
+    title: string;
+    scene_type: SceneType;
+    narrator: string;
+    summary: ChapterSummary;
+    content_hash: string;
+    updated_at: string;
+}
 /** Pipeline document (`state/pipeline.yaml`). */
 export interface PipelineState {
     schema_version: 1;
@@ -343,6 +379,8 @@ export interface PipelineState {
         digest: string;
     }>;
     blocking: BlockingItem[];
+    /** Current draft summary/title; never written into the P2 plan file. */
+    draft?: DraftState;
     /** Hash of the review document last written by submitReview/submitRevision. */
     review_digest?: string;
     last_action: {
@@ -422,6 +460,7 @@ export interface ForeshadowsDocument {
         status: 'planted' | 'dormant' | 'advanced' | 'resolved';
         resolved_at: number | null;
         description: string;
+        anchor?: string;
         advance_log: Array<{
             chapter: number;
             note: string;
@@ -614,6 +653,14 @@ export interface WorldbookBackstory {
     time: string;
     event: string;
 }
+/** One declared numeric canon, checked against the manuscript on request. */
+export interface WorldbookFact {
+    alias: string;
+    value: number;
+    unit: string;
+    tolerance?: number;
+    note?: string;
+}
 /** Worldbuilding plan, persisted in `outline/worldbook.yaml`. */
 export interface WorldbookDocument {
     schema_version: 1;
@@ -626,6 +673,8 @@ export interface WorldbookDocument {
     characters: WorldbookCharacter[];
     glossary: WorldbookGlossary[];
     backstory: WorldbookBackstory[];
+    /** Optional numeric canon; old documents omit it. */
+    facts?: WorldbookFact[];
     themes: string[];
 }
 /** One hit from `novel_search`; the scope names the source family. */
@@ -663,6 +712,22 @@ export interface DoctorReport {
         infos: number;
     };
 }
+/** One canonical outline-progress calculation shared by every adapter. */
+export interface OutlineProgress {
+    present: boolean;
+    target: number | null;
+    total: number;
+    planned: number;
+    archived: number;
+    missingCards: number;
+    plannedCoverage: number | null;
+    archivedCoverage: number | null;
+    /** Compatibility alias: planned coverage when a target exists, otherwise card coverage. */
+    coverage: number;
+    /** Fraction of archived chapters that have a matching archived card. */
+    cardCoverage: number;
+    volumes: number;
+}
 /** Book-wide quality, outline, cast and pacing aggregates. */
 export interface BookReport {
     progress: {
@@ -672,13 +737,22 @@ export interface BookReport {
         average_words: number;
         percent: number;
         remaining_words: number | null;
+        remaining_words_min: number | null;
+        remaining_words_average: number | null;
+        remaining_words_basis: 'actual_average' | 'minimum_target' | 'none';
     };
     outline: {
         present: boolean;
         strict: boolean;
+        target: number | null;
+        total: number;
         planned: number;
         archived: number;
+        missing_cards: number;
+        planned_coverage: number | null;
+        archived_coverage: number | null;
         coverage: number;
+        card_coverage: number;
         volumes: Array<{
             title: string;
             start: number;
@@ -701,6 +775,7 @@ export interface BookReport {
         rules: number;
         glossary: number;
         backstory: number;
+        facts?: number;
     };
     quality: {
         average: number;
@@ -715,6 +790,22 @@ export interface BookReport {
             samples: number;
         }>;
     };
+    /** Per-chapter effort survives archive (pipeline rounds are reset). */
+    effort: {
+        reviews: number;
+        revisions: number;
+        checks: number;
+        rollbacks: number;
+        chapters: Array<{
+            num: number;
+            reviews: number;
+            revisions: number;
+            checks: number;
+            rollbacks: number;
+            final_check: 'pass' | 'fail' | null;
+            archived_at: string | null;
+        }>;
+    };
     pacing: {
         scene_types: Record<string, number>;
         hook_strength: Record<string, number>;
@@ -805,10 +896,23 @@ export interface ReviewInput {
     total: number;
     proof: ReadingProof;
 }
+/** One exact, unique replacement used by patch-mode revisions. */
+export interface RevisionEdit {
+    old_text: string;
+    new_text: string;
+    /** 1-based occurrence; defaults to requiring exactly one match. */
+    occurrence?: number;
+}
+/** Patch-mode revision; content and patch are mutually exclusive. */
+export interface RevisionPatch {
+    expected_hash: string;
+    edits: RevisionEdit[];
+}
 /** Revision submission payload. */
 export interface RevisionInput {
     chapter: number;
-    content: string;
+    content?: string;
+    patch?: RevisionPatch;
     summary: ChapterSummary;
 }
 /** Semantic check items supplied by the model. */
@@ -910,10 +1014,15 @@ export interface StatusReport {
         strict: boolean;
         outline: {
             present: boolean;
+            target: number | null;
             total: number;
             planned: number;
             archived: number;
+            missing_cards: number;
+            planned_coverage: number | null;
+            archived_coverage: number | null;
             coverage: number;
+            card_coverage: number;
             volumes: number;
             current: OutlineChapter | null;
         };
@@ -925,6 +1034,7 @@ export interface StatusReport {
             rules: number;
             glossary: number;
             backstory: number;
+            facts?: number;
         };
     };
     next: {
@@ -945,6 +1055,8 @@ export interface AdviceReport {
 }
 /** One history row derived from the journal. */
 export interface AuditRow {
+    /** Stable chronological cursor; absent only on hand-built test rows. */
+    seq?: number;
     at: string;
     op: string;
     chapter: number;
@@ -952,6 +1064,14 @@ export interface AuditRow {
     txid: string;
     status: 'committed' | 'aborted';
     files: string[];
+    /** Machine code and human reason for a refused attempt. */
+    code?: string;
+    reason?: string;
+    hint?: string;
+    stage?: string;
+    /** True when no transaction started: the gate/input refused the call. */
+    attempt?: boolean;
+    blocking?: BlockingItem[];
 }
 /** 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.0",
+  "version": "0.2.1",
   "description": "Novel writing engine for DeepSeek Harness: state machine, gates, rulepacks and ledgers moved from prompts into code.",
   "keywords": [
     "dsh-plugin",

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

@@ -4,7 +4,7 @@
       config:
         id: novel-write-engine
         name: 网文工坊
-        description: 网文创作专用会话：27 个小说工具全开，无文件写权限，门控与字数由引擎裁决。
+        description: 网文创作专用会话：28 个小说工具全开，无文件写权限，门控与字数由引擎裁决。
         order: 20
         plugins:
           - id: persona

package/skills/entry.md

@@ -50,21 +50,22 @@ description: 引擎版小说创作流程——状态、门控、字数与写盘
 | `novel_report` | 全书报告 |
 | `novel_guide` | 上手引导与下一步 |
 | `novel_reopen` | 从归档备份重开紧邻的上一章 |
+| `novel_restore` | 从标记备份恢复活动章 |
 | `novel_brief` | 取阶段任务书与上下文 |
 | `novel_plan_world` | P1 世界观计划 |
 | `novel_plan_chapter` | P2 章节计划 |
 | `novel_write_draft` | P3 初稿 |
 | `novel_review` | P4 十五维评分 |
-| `novel_revise` | P5 修订 |
-| `novel_check` | P6 一致性校验 |
+| `novel_revise` | P5 修订（支持 exact patch） |
+| `novel_check` | P6 一致性校验（advisory 可 acknowledge） |
 | `novel_archive` | 归档事务 |
 | `novel_word_count` | 字数口径 |
-| `novel_state` | 只读台账/计划/评审 |
+| `novel_state` | 只读台账/计划/评审/history/backups/briefs |
 | `novel_amend` | 受控改状态文档 |
 | `novel_rollback` | 回退阶段 |
 | `novel_diff` | 与备份/文本对比 |
 | `novel_export` | md/txt/epub/outline/worldbook/proposal |
-| `novel_audit` | 事务审计 |
+| `novel_audit` | 事务与失败 attempt 审计 |
 | `novel_pipeline` | 推荐下一步与参数 |
 
 ## 工具怎么用