dsh-novel-write-engine 0.2.4 → 0.2.6

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

@@ -1,3 +1,4 @@
+import type { PanelBookData } from '../panel-contract.js';
 /** Wire DTOs of the panel route. Versioned so a stale tab can say "refresh". */
 export interface PhaseDto {
     id: string;
@@ -84,6 +85,7 @@ export interface SummaryDto {
         ok: boolean;
         blocking: number;
         stateErrors: number;
+        pending?: boolean;
     };
     activity?: Array<{
         at: string;
@@ -102,6 +104,14 @@ export interface SummaryDto {
         code: string;
         detail: string;
     }>;
+    /** Crash-left pending transaction; read-only diagnostics. */
+    pending?: {
+        state: string;
+        txid: string;
+        detail: string;
+    };
+    /** v6 read-only book data; v5 payloads omit it and are rejected by the client. */
+    bookData?: PanelBookData;
 }
 export interface ChapterRowDto {
     num: number;
@@ -111,6 +121,15 @@ export interface ChapterRowDto {
     stage: string;
     status: 'passed' | 'blocked' | 'draft';
     details?: string;
+    sceneType?: string;
+    dialogueRatio?: number;
+    hookStrength?: number;
+    finalCheck?: 'pass' | 'fail' | null;
+    reviews?: number;
+    revisions?: number;
+    checks?: number;
+    rollbacks?: number;
+    archivedAt?: string | null;
 }
 export interface ChaptersDto {
     schemaVersion: number;

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

@@ -1,4 +1,5 @@
 import type { PanelPayloadDto } from './dto.js';
+import type { PanelBookData } from '../panel-contract.js';
 /** One human-facing progress step. */
 export interface PanelPhase {
     id: string;
@@ -19,6 +20,15 @@ export interface PanelChapter {
     tone: 'ok' | 'bad' | 'muted';
     details: string;
     stageLabel: string;
+    sceneType: string;
+    dialogueRatio: number | null;
+    hookStrength: number | null;
+    finalCheck: 'pass' | 'fail' | null;
+    reviews: number;
+    revisions: number;
+    checks: number;
+    rollbacks: number;
+    archivedAt: string | null;
 }
 export interface PanelProject {
     root: string;
@@ -79,6 +89,7 @@ export interface PanelView {
         present: boolean;
         strict: boolean;
         premise: string;
+        logline: string;
         target: number | null;
         planned: number;
         outlineTotal: number;
@@ -106,6 +117,15 @@ export interface PanelView {
     };
     quality: {
         averageScore: number;
+        lastTenAverage: number;
+        bookMedian: number;
+        bookMin: number;
+        bookMax: number;
+        dimensions: Array<{
+            id: string;
+            average: number;
+            samples: number;
+        }>;
         scores: number[];
         trend: number | null;
         trendText: string;
@@ -116,6 +136,7 @@ export interface PanelView {
         ok: boolean;
         blocking: number;
         stateErrors: number;
+        pending: boolean;
     };
     activity: Array<{
         at: string;
@@ -136,6 +157,14 @@ export interface PanelView {
         code: string;
         detail: string;
     }>;
+    /** Crash-left pending transaction, read-only. */
+    pending: {
+        state: string;
+        txid: string;
+        detail: string;
+    } | null;
+    /** v6 book data; null on a payload that predates it. */
+    bookData: PanelBookData | null;
     nextTitle: string;
     nextDetail: string;
     nextTool: string;
@@ -144,7 +173,7 @@ export interface PanelView {
     revision: string;
     next: string;
 }
-export declare const PANEL_SCHEMA_VERSION = 5;
+export declare const PANEL_SCHEMA_VERSION = 6;
 /**
  * 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 = 5;
+export declare const REMOTE_VERSION = 6;
 /** 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

@@ -0,0 +1,125 @@
+import type { BookReport, Stage, WordMetrics } from './types.js';
+/** v6 read-only book data. All windows are explicit in the field names. */
+export interface PanelCardData {
+    num: number;
+    title: string;
+    scene_type: string;
+    goal: string;
+    conflict: string;
+    hook: string;
+    cast: string[];
+    target_words: [number, number];
+    status: 'planned' | 'archived';
+}
+export interface PanelWorldEntry {
+    name: string;
+    description: string;
+    anchors?: string[];
+}
+export interface PanelBookData {
+    identity: {
+        author: string;
+        description: string;
+        created_at: string;
+        targets: {
+            words_per_chapter: [number, number];
+            total_chapters: number | null;
+            dialogue_ratio: [number, number];
+        };
+    };
+    blueprint: {
+        premise: string;
+        logline: string;
+        themes: string[];
+        tone: string;
+        pov: string;
+        audience: string;
+        selling_points: string[];
+        ending: string;
+    };
+    progress: {
+        archived: number;
+        target: number | null;
+        words_archived: number;
+        words_with_draft: number;
+        average_words: number;
+        remaining_words: number | null;
+        remaining_words_basis: 'actual_average' | 'minimum_target' | 'none';
+        percent: number;
+    };
+    current: {
+        card: PanelCardData | null;
+        chapter: number;
+        stage: Stage;
+        rounds: {
+            review: number;
+            revise: number;
+            check: number;
+        };
+        manuscript_hash: string | null;
+        metrics: WordMetrics | null;
+    };
+    worldbook: {
+        counts: Omit<BookReport['worldbook'], 'anchors'>;
+        locations: PanelWorldEntry[];
+        factions: PanelWorldEntry[];
+        rules: PanelWorldEntry[];
+        facts: Array<{
+            alias: string;
+            value: number;
+            unit: string;
+        }>;
+    };
+    cast: {
+        total: number;
+        top: Array<{
+            name: string;
+            role: string;
+            appearances: number;
+            last_seen: number;
+        }>;
+    };
+    relationships: {
+        total: number;
+        types: Record<string, number>;
+    };
+    foreshadows: BookReport['foreshadows'];
+    timeline: BookReport['timeline'];
+    outline: {
+        drift: BookReport['outline']['drift'];
+    };
+    quality: {
+        average: number;
+        median: number;
+        min: number;
+        max: number;
+        last_ten_average: number;
+        trend: number | null;
+        trend_basis: BookReport['quality']['trend_basis'];
+        samples: number;
+        attempts: number;
+        dimensions: BookReport['quality']['dimensions'];
+    };
+    pacing: BookReport['pacing'];
+    effort: BookReport['effort'];
+    health: {
+        state_errors: Array<{
+            path: string;
+            code: string;
+            message: string;
+        }>;
+        outline: {
+            present: boolean;
+            error: string | null;
+        };
+        worldbook: {
+            present: boolean;
+            error: string | null;
+        };
+        pending: {
+            state: string;
+            txid: string;
+            detail: string;
+        } | null;
+    };
+}

package/lib/types/types.d.ts

@@ -66,6 +66,9 @@ export 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,13 +181,18 @@ export 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. */
-export type StateErrorCode = 'PROJECT_UNREADABLE' | 'PLAN_UNREADABLE' | 'WORLD_PLAN_UNREADABLE' | 'REVIEW_UNREADABLE' | 'CHECK_UNREADABLE' | 'CHAPTERS_UNREADABLE' | 'CHARACTERS_UNREADABLE' | 'WORLD_UNREADABLE' | 'LOCKS_UNREADABLE' | 'TIMELINE_UNREADABLE' | 'FORESHADOWS_UNREADABLE' | 'RELATIONSHIPS_UNREADABLE' | 'HANDOFF_UNREADABLE' | 'OUTLINE_UNREADABLE' | 'WORLDBOOK_UNREADABLE';
+export type StateErrorCode = 'PROJECT_UNREADABLE' | 'PIPELINE_UNREADABLE' | 'PLAN_UNREADABLE' | 'WORLD_PLAN_UNREADABLE' | 'REVIEW_UNREADABLE' | 'CHECK_UNREADABLE' | 'CHAPTERS_UNREADABLE' | 'CHARACTERS_UNREADABLE' | 'WORLD_UNREADABLE' | 'LOCKS_UNREADABLE' | 'TIMELINE_UNREADABLE' | 'FORESHADOWS_UNREADABLE' | 'RELATIONSHIPS_UNREADABLE' | 'HANDOFF_UNREADABLE' | 'OUTLINE_UNREADABLE' | 'WORLDBOOK_UNREADABLE';
 /** A state document that exists but cannot be read safely. */
 export interface StateError {
     path: string;
@@ -255,6 +263,12 @@ export interface ChapterSummary {
         abilities: string[];
         artifacts: string[];
     };
+    /** Optional P3/P5 verbatim manuscript anchors for readable entity names. */
+    new_element_anchors?: {
+        locations?: Record<string, string[]>;
+        abilities?: Record<string, string[]>;
+        artifacts?: Record<string, string[]>;
+    };
     resource_changes: Array<{
         character: string;
         resource: string;
@@ -423,6 +437,8 @@ export interface WorldDocument {
     schema_version: 1;
     locations: Array<{
         name: string;
+        /** 0.2.6 additive: readable-name anchors; old ledgers omit this. */
+        anchors?: string[];
         first_appearance: number;
         locked: boolean;
         description: string;
@@ -785,6 +801,12 @@ export interface BookReport {
         glossary: number;
         backstory: number;
         facts?: number;
+        /** 0.2.6 persisted world-ledger anchors, capped for report payloads. */
+        anchors?: Array<{
+            name: string;
+            kind: string;
+            anchors: string[];
+        }>;
     };
     quality: {
         average: number;
@@ -953,6 +975,10 @@ export 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 +1056,8 @@ export 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;

package/package.json

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