dsh-novel-write-engine 0.2.6 → 0.2.8

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

@@ -11,6 +11,23 @@ export interface BlockingDto {
     detail: string;
     hint?: string;
 }
+/** Chapter-boundary projection; absent on older payloads. */
+export interface ProgressDto {
+    active_chapter: number;
+    stage: string;
+    current: {
+        chapter: number;
+        stage: string;
+    } | null;
+    last_archived: number | null;
+    next: {
+        chapter: number;
+        stage: 'P1';
+    } | null;
+    finished: boolean;
+    label: string;
+    resume: string;
+}
 export interface SummaryDto {
     schemaVersion: number;
     panelId: string;
@@ -21,8 +38,11 @@ export interface SummaryDto {
     platform: string;
     chapter: number;
     stage: string;
+    progress?: ProgressDto;
     revision: number;
     totalWords: number;
+    archivedWords?: number;
+    draftWords?: number;
     totalChapters: number;
     /** Book-wide archived average; absent on older payloads. */
     averageScore?: number;

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

@@ -82,6 +82,8 @@ export interface PanelView {
     stats: {
         chapters: number;
         words: number;
+        archivedWords?: number;
+        draftWords?: number;
         averageScore: number;
         blocking: number;
     };

package/lib/types/types.d.ts

@@ -301,8 +301,8 @@ export interface CharacterDelta {
     role?: string;
     profile?: Record<string, unknown>;
     current_state?: Record<string, unknown>;
+    /** Chapter is engine-assigned from the archive transaction, not caller-supplied. */
     growth?: {
-        chapter: number;
         change: string;
         status_change: string;
     };
@@ -972,6 +972,8 @@ export interface GateInput {
     briefStage: BriefStage | null;
     draftTitle: string | null;
     sceneType: SceneType | null;
+    /** The submitted/active plan narrator; PG-05 uses it before a draft exists. */
+    narrator?: string | null;
     summary: ChapterSummary | null;
     /** P5 may omit `summary`; when omitted, the previous plan summary is reused. */
     summaryProvided?: boolean;
@@ -1034,6 +1036,36 @@ export interface Selection {
     title?: string;
     created_at?: string;
 }
+/**
+ * One human-readable projection of the pipeline's chapter boundary.
+ *
+ * `pipeline.chapter`/`stage` are protocol values: after archiving chapter N the
+ * pipeline points at N+1 and still says `done` because `done` describes the
+ * chapter that was just archived. This projection is the only place that turns
+ * those values into "chapter N archived; chapter N+1 starts at P1".
+ */
+export interface ChapterProgress {
+    active_chapter: number;
+    stage: Stage;
+    /** The chapter currently being written; null while `stage === 'done'`. */
+    current: {
+        chapter: number;
+        stage: Stage;
+    } | null;
+    /** Highest archived chapter, or null before the first archive. */
+    last_archived: number | null;
+    /** Next chapter to start at P1; null while writing or after the book is finished. */
+    next: {
+        chapter: number;
+        stage: 'P1';
+    } | null;
+    /** True only when the configured target has been reached at `stage === 'done'`. */
+    finished: boolean;
+    /** One line for status cards, commands and the panel. */
+    label: string;
+    /** Sentence used by the resume prompt instead of "当前第 N 章，阶段 done". */
+    resume: string;
+}
 /** The `getStatus` payload. */
 export interface StatusReport {
     project: {
@@ -1054,6 +1086,8 @@ export interface StatusReport {
     /** SHA-256 of the active manuscript, or null when the stage has no draft. */
     manuscript_hash: string | null;
     stage: Stage;
+    /** Chapter-boundary projection shared by every human-readable surface. */
+    progress?: ChapterProgress;
     rounds: RoundCounters;
     blocking: BlockingItem[];
     /** Non-blocking recovery notes, e.g. a recoverable pending transaction. */
@@ -1106,6 +1140,8 @@ export interface StatusReport {
 export interface AdviceReport {
     stage: Stage;
     chapter: number;
+    /** Same chapter-boundary projection as getStatus. */
+    progress?: ChapterProgress;
     tool: string;
     args: Record<string, unknown>;
     reason: string;

package/package.json

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