dsh-novel-write-engine 0.1.1 → 0.1.3

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

@@ -21,6 +21,12 @@ export interface SummaryDto {
     revision: number;
     totalWords: number;
     totalChapters: number;
+    /** Book-wide archived average; absent on older payloads. */
+    averageScore?: number;
+    volume?: number;
+    volume_name?: string;
+    act?: string;
+    act_progress?: string;
     phases: PhaseDto[];
     blocking: BlockingDto[];
     next?: {

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 = 1;
+/** 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. */
 export declare const PROJECT_FILE = "novel.yaml";
 export declare const STATE_DIR = "state";
@@ -49,6 +51,12 @@ export declare const LIMITS: {
     lockWaitMs: number;
     /** Reading proofs shorter than this cannot be verified. */
     minQuoteChars: number;
+    /** World-plan text fields are protected context, so they need a hard bound. */
+    maxWorldPlanItems: number;
+    maxWorldPlanTextChars: number;
+    maxWorldPlanObjectiveChars: number;
+    /** Cast plus summary may exceed eight, but not without a bound. */
+    maxActiveCast: number;
 };
 /** Re-exported enums make adapter code readable without importing types twice. */
 export declare const SCENE_TYPE_DEFAULT: SceneType;

package/lib/types/types.d.ts

@@ -171,6 +171,14 @@ export interface CheckDocument {
     };
     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';
+/** A state document that exists but cannot be read safely. */
+export interface StateError {
+    path: string;
+    code: StateErrorCode;
+    message: string;
+}
 /** Word statistics with the single engine-wide counting rule. */
 export interface WordMetrics {
     total_word_count: number;
@@ -497,6 +505,14 @@ export interface WorldPlanInput {
     }>;
     continuity_notes: string[];
 }
+/** A character the chapter plan puts on stage; no new persisted schema. */
+export interface ChapterCastMember {
+    name: string;
+    entry_state?: string;
+    goal?: string;
+    knowledge?: string[];
+    exit_change?: string;
+}
 /** Chapter plan (`plans/chNNN.chapter.yaml`). */
 export interface ChapterPlanInput {
     chapter: number;
@@ -507,6 +523,8 @@ export interface ChapterPlanInput {
     opening: string;
     ending: string;
     target_words: [number, number];
+    /** Optional in 0.1.3: older plans remain readable; new plans may name 1–8 actors. */
+    cast?: ChapterCastMember[];
 }
 /** Draft submission payload. */
 export interface DraftInput {
@@ -557,6 +575,8 @@ export interface GateInput {
     summaryProvided?: boolean;
     review: ReviewDocument | null;
     check: CheckDocument | null;
+    /** When set, result-bearing gates run only the named check scopes. */
+    scope?: string[];
     semantic: SemanticItem[];
     proof: ReadingProof | null;
     rounds: RoundCounters;
@@ -608,7 +628,14 @@ export interface StatusReport {
     stage: Stage;
     rounds: RoundCounters;
     blocking: BlockingItem[];
+    /** plan/review/check/ledger files that exist but cannot be read safely. */
+    state_errors: StateError[];
     metrics: WordMetrics | null;
+    /** Inherited handoff labels; absent before the first archive. */
+    volume?: number;
+    volume_name?: string;
+    act?: string;
+    act_progress?: string;
     next: {
         tool: string;
         args: Record<string, unknown>;
@@ -623,6 +650,7 @@ export interface AdviceReport {
     args: Record<string, unknown>;
     reason: string;
     blocking: BlockingItem[];
+    state_errors: StateError[];
 }
 /** One history row derived from the journal. */
 export interface AuditRow {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-novel-write-engine",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Novel writing engine for DeepSeek Harness: state machine, gates, rulepacks and ledgers moved from prompts into code.",
   "keywords": [
     "dsh-plugin",
@@ -84,6 +84,7 @@
     "check:artifacts": "node scripts/check-artifacts.mjs",
     "check:install": "node scripts/check-install.mjs",
     "check:host": "node scripts/check-host.mjs",
+    "check:crash": "node scripts/check-crash.mjs",
     "check:hygiene": "node scripts/check-hygiene.mjs"
   },
   "dependencies": {