dsh-novel-write-engine 0.2.5 → 0.2.7

package/lib/index.d.ts

@@ -192,7 +192,7 @@ interface CheckDocument {
   verdict: 'pass' | 'fail';
 }
 /** Every persisted document whose damage status/panel can report. */
-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';
+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. */
 interface StateError {
   path: string;
@@ -263,6 +263,12 @@ 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;
@@ -431,6 +437,8 @@ 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;
@@ -793,6 +801,12 @@ 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;
@@ -1137,6 +1151,23 @@ interface DiffReport {
 /** Export capabilities; the last three are book-planning deliverables. */
 type ExportKind = 'md' | 'txt' | 'epub' | 'outline' | 'worldbook' | 'proposal';
 type SemanticItemState = 'pass' | 'fail' | 'missing' | 'invalid' | 'not_found' | 'too_short' | 'duplicate' | 'overlap' | 'same_sentence' | 'boundary';
+type SemanticConflictKind = 'duplicate' | 'same_sentence' | 'interval_overlap';
+interface SemanticConflict {
+  kind: SemanticConflictKind;
+  other_id: string;
+  /** Only for interval_overlap; a verbatim excerpt, capped at 120 characters. */
+  overlap_text?: string;
+  overlap_chars?: number;
+  /** overlap_chars / min(quoteA, quoteB), 0..1. */
+  overlap_ratio?: number;
+  paragraphs?: number[];
+  /** Only for same_sentence. */
+  sentence?: {
+    id: number;
+    text: string;
+    paragraph: number;
+  };
+}
 interface SemanticNearest {
   paragraph: number;
   quote: string;
@@ -1148,7 +1179,9 @@ interface SemanticItemResult {
   quote?: string;
   detail?: string;
   nearest?: SemanticNearest;
+  /** Kept for older adapters; the full pair is in `conflicts`. */
   conflict_with?: string;
+  conflicts?: SemanticConflict[];
 }
 /** One blacklisted word. */
 interface TermEntry {
@@ -1404,6 +1437,130 @@ declare function applicableGates(input: GateInput): GateId[];
 declare function gateName(id: GateId): string;
 /** Which brief stage an operation requires; `null` means no brief gate. */
 declare function briefStageFor(operation: GateInput['operation'], stage: Stage): GateInput['briefStage'];
+/** v6 read-only book data. All windows are explicit in the field names. */
+interface PanelCardData {
+  num: number;
+  title: string;
+  scene_type: string;
+  goal: string;
+  conflict: string;
+  hook: string;
+  cast: string[];
+  target_words: [number, number];
+  status: 'planned' | 'archived';
+}
+interface PanelWorldEntry {
+  name: string;
+  description: string;
+  anchors?: string[];
+}
+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;
+  };
+}
 /** The shared read model: everything the panel, status and commands render. */
 interface PanelDraft {
   num: number;
@@ -1462,6 +1619,7 @@ interface PanelSnapshot {
     ok: boolean;
     blocking: number;
     stateErrors: number;
+    pending?: boolean;
   };
   activity?: Array<{
     at: string;
@@ -1488,6 +1646,8 @@ interface PanelSnapshot {
     txid: string;
     detail: string;
   };
+  /** v6 read-only book data; v5 payloads omit it. */
+  bookData?: PanelBookData;
 }
 interface PanelBook {
   premise: string;
@@ -1569,6 +1729,7 @@ interface PanelSummaryDto {
     ok: boolean;
     blocking: number;
     stateErrors: number;
+    pending?: boolean;
   };
   activity?: Array<{
     at: string;
@@ -1595,6 +1756,8 @@ interface PanelSummaryDto {
     txid: string;
     detail: string;
   };
+  /** v6 read-only book data; v5 payloads omit it. */
+  bookData?: PanelBookData;
 }
 interface PanelChapterRow {
   num: number;
@@ -1605,6 +1768,15 @@ interface PanelChapterRow {
   status: 'passed' | 'blocked' | 'draft';
   /** One-line summary shown when the row is expanded. */
   details: string;
+  sceneType?: string;
+  dialogueRatio?: number;
+  hookStrength?: number;
+  finalCheck?: 'pass' | 'fail' | null;
+  reviews?: number;
+  revisions?: number;
+  checks?: number;
+  rollbacks?: number;
+  archivedAt?: string | null;
 }
 interface PanelChaptersDto {
   schemaVersion: number;
@@ -1977,6 +2149,8 @@ declare class EngineService {
   private readonly exportArtifactEpoch;
   /** Status, panel and gates ask for the same stage context repeatedly. */
   private readonly briefContextCache;
+  /** The 15s panel poll reuses the heavy book projection until revision/damage changes. */
+  private readonly panelCache;
   private readonly briefs;
   private readonly now;
   private readonly metadataMutex;
@@ -2498,7 +2672,7 @@ declare const PLUGIN_NAME = "dsh-novel-write-engine";
 declare const PANEL_ID = "novel-workshop";
 declare const PANEL_ROUTE = "/api/novel-write-engine/panel";
 declare const SKILL_NAME = "novel-write-engine";
-declare const REMOTE_VERSION = 5;
+declare const REMOTE_VERSION = 6;
 /** The panel is a recent-history view; the wire payload and UI use one cap. */
 declare const PANEL_CHAPTER_LIMIT = 30;
 /** Project-relative locations. Every write goes through these constants. */