dsh-novel-write-engine 0.1.3 → 0.2.1

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

@@ -35,6 +35,57 @@ export interface SummaryDto {
     };
     /** True only when the book target is reached; done alone means the chapter is archived. */
     finished?: boolean;
+    book?: {
+        premise: string;
+        logline: string;
+        strict: boolean;
+        target: number | null;
+        outline: {
+            present: boolean;
+            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;
+                end: number;
+                planned: number;
+                archived: number;
+            }>;
+        };
+        worldbook: {
+            present: boolean;
+            characters: number;
+            locations: number;
+            factions: number;
+            rules: number;
+            glossary: number;
+            backstory: number;
+            facts?: number;
+        };
+    };
+    quality?: {
+        averageScore: number;
+        scores: number[];
+        trend: number;
+    };
+    health?: {
+        ok: boolean;
+        blocking: number;
+        stateErrors: number;
+    };
+    activity?: Array<{
+        at: string;
+        op: string;
+        chapter: number;
+        status: string;
+    }>;
 }
 export interface ChapterRowDto {
     num: number;

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

@@ -44,6 +44,51 @@ export interface PanelView {
         averageScore: number;
         blocking: number;
     };
+    book: {
+        present: boolean;
+        strict: boolean;
+        premise: string;
+        target: number | null;
+        planned: number;
+        outlineTotal: number;
+        archivedCards: number;
+        coverage: number;
+        missingCards: number;
+        plannedCoverage: number | null;
+        archivedCoverage: number | null;
+        cardCoverage: number;
+        volumes: Array<{
+            title: string;
+            range: string;
+            planned: number;
+            archived: number;
+        }>;
+        worldbook: {
+            characters: number;
+            locations: number;
+            factions: number;
+            rules: number;
+            glossary: number;
+            backstory: number;
+            facts?: number;
+        };
+    };
+    quality: {
+        averageScore: number;
+        scores: number[];
+        trend: number;
+    };
+    health: {
+        ok: boolean;
+        blocking: number;
+        stateErrors: number;
+    };
+    activity: Array<{
+        at: string;
+        op: string;
+        chapter: number;
+        status: string;
+    }>;
     nextTitle: string;
     nextDetail: string;
     nextTool: string;
@@ -52,7 +97,7 @@ export interface PanelView {
     revision: string;
     next: string;
 }
-export declare const PANEL_SCHEMA_VERSION = 1;
+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,11 +4,13 @@ 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 = 1;
+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. */
 export declare const PROJECT_FILE = "novel.yaml";
+export declare const OUTLINE_FILE = "outline/outline.yaml";
+export declare const WORLDBOOK_FILE = "outline/worldbook.yaml";
 export declare const STATE_DIR = "state";
 export declare const CHAPTERS_DIR = "chapters";
 export declare const PLAN_DIR = "plans";
@@ -16,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";
@@ -41,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. */
@@ -57,6 +69,14 @@ export declare const LIMITS: {
     maxWorldPlanObjectiveChars: number;
     /** Cast plus summary may exceed eight, but not without a bound. */
     maxActiveCast: number;
+    /** Outline and worldbook are protected context, so they need hard bounds. */
+    maxOutlineChapters: number;
+    maxOutlineVolumes: number;
+    maxOutlineTextFieldChars: number;
+    maxOutlineNotesChars: number;
+    maxWorldbookEntries: number;
+    maxWorldbookTextChars: number;
+    maxSearchQueryChars: number;
 };
 /** Re-exported enums make adapter code readable without importing types twice. */
 export declare const SCENE_TYPE_DEFAULT: SceneType;
@@ -66,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"];
+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 eight high-frequency tools kept when `tools.mode = core`. */
+/** The ten high-frequency tools kept when `tools.mode = core`. */
 export declare const CORE_TOOLS: readonly ToolName[];

package/lib/types/next-reasons.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Chinese one-line explanation for the tool each engine state recommends.
+ * Shared by the panel and slash commands so both surfaces speak the same
+ * language; unknown tools fall back to the engine's own reason.
+ */
+export declare const NEXT_DETAILS: Record<string, string>;