@actalk/inkos-core 0.5.1 → 0.6.0

package/dist/agents/writer.js

@@ -2,19 +2,36 @@ import { BaseAgent } from "./base.js";
 import { buildWriterSystemPrompt } from "./writer-prompts.js";
 import { buildSettlerSystemPrompt, buildSettlerUserPrompt } from "./settler-prompts.js";
 import { buildObserverSystemPrompt, buildObserverUserPrompt } from "./observer-prompts.js";
+import { parseSettlerDeltaOutput } from "./settler-delta-parser.js";
 import { parseSettlementOutput } from "./settler-parser.js";
 import { readGenreProfile, readBookRules } from "./rules-reader.js";
-import { validatePostWrite } from "./post-write-validator.js";
+import { validatePostWrite, detectCrossChapterRepetition } from "./post-write-validator.js";
 import { analyzeAITells } from "./ai-tells.js";
+import { buildLengthSpec } from "../utils/length-metrics.js";
 import { filterHooks, filterSummaries, filterSubplots, filterEmotionalArcs, filterCharacterMatrix } from "../utils/context-filter.js";
+import { buildGovernedMemoryEvidenceBlocks } from "../utils/governed-context.js";
+import { buildGovernedCharacterMatrixWorkingSet, buildGovernedHookWorkingSet, mergeCharacterMatrixMarkdown, mergeTableMarkdownByKey, } from "../utils/governed-working-set.js";
 import { extractPOVFromOutline, filterMatrixByPOV, filterHooksByPOV } from "../utils/pov-filter.js";
 import { parseCreativeOutput } from "./writer-parser.js";
+import { buildRuntimeStateArtifacts, saveRuntimeStateSnapshot } from "../state/runtime-state-store.js";
+import { parsePendingHooksMarkdown } from "../utils/memory-retrieval.js";
+import { analyzeHookHealth } from "../utils/hook-health.js";
+import { buildEnglishVarianceBrief } from "../utils/long-span-fatigue.js";
 import { readFile, writeFile, mkdir, readdir } from "node:fs/promises";
 import { join } from "node:path";
 export class WriterAgent extends BaseAgent {
     get name() {
         return "writer";
     }
+    localize(language, messages) {
+        return language === "en" ? messages.en : messages.zh;
+    }
+    logInfo(language, messages) {
+        this.ctx.logger?.info(this.localize(language, messages));
+    }
+    logWarn(language, messages) {
+        this.ctx.logger?.warn(this.localize(language, messages));
+    }
     async writeChapter(input) {
         const { book, bookDir, chapterNumber } = input;
         const [storyBible, volumeOutline, styleGuide, currentState, ledger, hooks, chapterSummaries, subplotBoard, emotionalArcs, characterMatrix, styleProfileRaw, parentCanon, fanficCanonRaw,] = await Promise.all([
@@ -45,6 +62,18 @@ export class WriterAgent extends BaseAgent {
         const relevantSummaries = this.findRelevantSummaries(chapterSummaries, volumeOutline, chapterNumber);
         const hasParentCanon = parentCanon !== "(文件尚未创建)";
         const hasFanficCanon = fanficCanonRaw !== "(文件尚未创建)";
+        const resolvedLanguage = book.language ?? genreProfile.language;
+        const targetWords = input.lengthSpec?.target ?? input.wordCountOverride ?? book.chapterWordCount;
+        const resolvedLengthSpec = input.lengthSpec ?? buildLengthSpec(targetWords, resolvedLanguage);
+        const governedMemoryBlocks = input.contextPackage
+            ? buildGovernedMemoryEvidenceBlocks(input.contextPackage)
+            : undefined;
+        const englishVarianceBrief = resolvedLanguage === "en"
+            ? await buildEnglishVarianceBrief({
+                bookDir,
+                chapterNumber,
+            })
+            : null;
         // Build fanfic context if fanfic_canon.md exists
         const fanficContext = hasFanficCanon && bookRules?.fanficMode
             ? {
@@ -54,54 +83,95 @@ export class WriterAgent extends BaseAgent {
             }
             : undefined;
         // ── Phase 1: Creative writing (temperature 0.7) ──
-        const resolvedLanguage = book.language ?? genreProfile.language;
-        const creativeSystemPrompt = buildWriterSystemPrompt(book, genreProfile, bookRules, bookRulesBody, genreBody, styleGuide, styleFingerprint, chapterNumber, "creative", fanficContext, resolvedLanguage);
-        // Smart context filtering: inject only relevant parts of truth files
-        const filteredHooks = filterHooks(hooks);
-        const filteredSummaries = filterSummaries(chapterSummaries, chapterNumber);
-        const filteredSubplots = filterSubplots(subplotBoard);
-        const filteredArcs = filterEmotionalArcs(emotionalArcs, chapterNumber);
-        const filteredMatrix = filterCharacterMatrix(characterMatrix, volumeOutline, bookRules?.protagonist?.name);
-        // POV-aware filtering: limit context to what the POV character knows
-        const povCharacter = extractPOVFromOutline(volumeOutline, chapterNumber);
-        const povFilteredMatrix = povCharacter
-            ? filterMatrixByPOV(filteredMatrix, povCharacter)
-            : filteredMatrix;
-        const povFilteredHooks = povCharacter
-            ? filterHooksByPOV(filteredHooks, povCharacter, chapterSummaries)
-            : filteredHooks;
-        const creativeUserPrompt = this.buildUserPrompt({
-            chapterNumber,
-            storyBible,
-            volumeOutline,
-            currentState,
-            ledger: genreProfile.numericalSystem ? ledger : "",
-            hooks: povFilteredHooks,
-            recentChapters,
-            wordCount: input.wordCountOverride ?? book.chapterWordCount,
-            externalContext: input.externalContext,
-            chapterSummaries: filteredSummaries,
-            subplotBoard: filteredSubplots,
-            emotionalArcs: filteredArcs,
-            characterMatrix: povFilteredMatrix,
-            dialogueFingerprints,
-            relevantSummaries,
-            parentCanon: hasParentCanon ? parentCanon : undefined,
-            language: book.language ?? genreProfile.language,
-        });
+        const creativeSystemPrompt = buildWriterSystemPrompt(book, genreProfile, bookRules, bookRulesBody, genreBody, styleGuide, styleFingerprint, chapterNumber, "creative", fanficContext, resolvedLanguage, input.chapterIntent ? "governed" : "legacy", resolvedLengthSpec);
+        const creativeUserPrompt = input.chapterIntent && input.contextPackage && input.ruleStack
+            ? this.buildGovernedUserPrompt({
+                chapterNumber,
+                chapterIntent: input.chapterIntent,
+                contextPackage: input.contextPackage,
+                ruleStack: input.ruleStack,
+                trace: input.trace,
+                lengthSpec: resolvedLengthSpec,
+                language: book.language ?? genreProfile.language,
+                varianceBrief: englishVarianceBrief?.text,
+            })
+            : (() => {
+                // Smart context filtering: inject only relevant parts of truth files
+                const filteredHooks = filterHooks(hooks);
+                const filteredSummaries = filterSummaries(chapterSummaries, chapterNumber);
+                const filteredSubplots = filterSubplots(subplotBoard);
+                const filteredArcs = filterEmotionalArcs(emotionalArcs, chapterNumber);
+                const filteredMatrix = filterCharacterMatrix(characterMatrix, volumeOutline, bookRules?.protagonist?.name);
+                // POV-aware filtering: limit context to what the POV character knows
+                const povCharacter = extractPOVFromOutline(volumeOutline, chapterNumber);
+                const povFilteredMatrix = povCharacter
+                    ? filterMatrixByPOV(filteredMatrix, povCharacter)
+                    : filteredMatrix;
+                const povFilteredHooks = povCharacter
+                    ? filterHooksByPOV(filteredHooks, povCharacter, chapterSummaries)
+                    : filteredHooks;
+                return this.buildUserPrompt({
+                    chapterNumber,
+                    storyBible,
+                    volumeOutline,
+                    currentState,
+                    ledger: genreProfile.numericalSystem ? ledger : "",
+                    hooks: povFilteredHooks,
+                    recentChapters,
+                    lengthSpec: resolvedLengthSpec,
+                    externalContext: input.externalContext,
+                    chapterSummaries: filteredSummaries,
+                    subplotBoard: filteredSubplots,
+                    emotionalArcs: filteredArcs,
+                    characterMatrix: povFilteredMatrix,
+                    dialogueFingerprints,
+                    relevantSummaries,
+                    parentCanon: hasParentCanon ? parentCanon : undefined,
+                    language: book.language ?? genreProfile.language,
+                });
+            })();
         const creativeTemperature = input.temperatureOverride ?? 0.7;
-        this.ctx.logger?.info(`Phase 1: creative writing for chapter ${chapterNumber}`);
+        this.logInfo(resolvedLanguage, {
+            zh: `阶段 1：创作正文（第${chapterNumber}章）`,
+            en: `Phase 1: creative writing for chapter ${chapterNumber}`,
+        });
         // Scale maxTokens to chapter word count (Chinese ≈ 1.5 tokens/char)
-        const targetWords = input.wordCountOverride ?? book.chapterWordCount;
         const creativeMaxTokens = Math.max(8192, Math.ceil(targetWords * 2));
         const creativeResponse = await this.chat([
             { role: "system", content: creativeSystemPrompt },
             { role: "user", content: creativeUserPrompt },
         ], { maxTokens: creativeMaxTokens, temperature: creativeTemperature });
         const creativeUsage = creativeResponse.usage;
-        const creative = parseCreativeOutput(chapterNumber, creativeResponse.content);
+        const creative = parseCreativeOutput(chapterNumber, creativeResponse.content, resolvedLengthSpec.countingMode);
         // ── Phase 2: State settlement (temperature 0.3) ──
-        this.ctx.logger?.info(`Phase 2: state settlement for chapter ${chapterNumber} (${creative.wordCount} chars)`);
+        this.logInfo(resolvedLanguage, {
+            zh: `阶段 2：状态结算（第${chapterNumber}章，${creative.wordCount}字）`,
+            en: `Phase 2: state settlement for chapter ${chapterNumber} (${creative.wordCount} words)`,
+        });
+        const isGovernedSettlement = Boolean(input.chapterIntent && input.contextPackage && input.ruleStack);
+        const filteredHooksForSettlement = isGovernedSettlement && input.contextPackage
+            ? buildGovernedHookWorkingSet({
+                hooksMarkdown: hooks,
+                contextPackage: input.contextPackage,
+                chapterIntent: input.chapterIntent,
+                chapterNumber,
+                language: resolvedLanguage,
+            })
+            : hooks;
+        const filteredSubplotsForSettlement = isGovernedSettlement
+            ? filterSubplots(subplotBoard)
+            : subplotBoard;
+        const filteredArcsForSettlement = isGovernedSettlement
+            ? filterEmotionalArcs(emotionalArcs, chapterNumber)
+            : emotionalArcs;
+        const filteredMatrixForSettlement = isGovernedSettlement
+            ? buildGovernedCharacterMatrixWorkingSet({
+                matrixMarkdown: characterMatrix,
+                chapterIntent: input.chapterIntent ?? volumeOutline,
+                contextPackage: input.contextPackage,
+                protagonistName: bookRules?.protagonist?.name,
+            })
+            : characterMatrix;
         const settleResult = await this.settle({
             book,
             genreProfile,
@@ -111,32 +181,78 @@ export class WriterAgent extends BaseAgent {
             content: creative.content,
             currentState,
             ledger: genreProfile.numericalSystem ? ledger : "",
-            hooks,
-            chapterSummaries,
-            subplotBoard,
-            emotionalArcs,
-            characterMatrix,
+            hooks: filteredHooksForSettlement,
+            chapterSummaries: input.contextPackage ? filterSummaries(chapterSummaries, chapterNumber) : chapterSummaries,
+            subplotBoard: filteredSubplotsForSettlement,
+            emotionalArcs: filteredArcsForSettlement,
+            characterMatrix: filteredMatrixForSettlement,
             volumeOutline,
+            selectedEvidenceBlock: governedMemoryBlocks
+                ? [
+                    governedMemoryBlocks.hooksBlock,
+                    governedMemoryBlocks.summariesBlock,
+                    governedMemoryBlocks.volumeSummariesBlock,
+                ]
+                    .filter(Boolean)
+                    .join("\n")
+                : undefined,
+            chapterIntent: input.chapterIntent,
+            contextPackage: input.contextPackage,
+            ruleStack: input.ruleStack,
+            originalHooks: hooks,
+            originalSubplots: subplotBoard,
+            originalEmotionalArcs: emotionalArcs,
+            originalCharacterMatrix: characterMatrix,
         });
         const settlement = settleResult.settlement;
         const settleUsage = settleResult.usage;
+        const runtimeStateArtifacts = await this.buildRuntimeStateArtifactsIfPresent(bookDir, settlement.runtimeStateDelta, resolvedLanguage);
+        const priorHookIds = new Set(parsePendingHooksMarkdown(hooks).map((hook) => hook.hookId));
+        const hookHealthIssues = settlement.runtimeStateDelta
+            && (runtimeStateArtifacts?.snapshot ?? settlement.runtimeStateSnapshot)
+            ? analyzeHookHealth({
+                language: resolvedLanguage,
+                chapterNumber,
+                hooks: (runtimeStateArtifacts?.snapshot ?? settlement.runtimeStateSnapshot).hooks.hooks,
+                delta: settlement.runtimeStateDelta,
+                existingHookIds: [...priorHookIds],
+            })
+            : [];
         // ── Post-write validation (regex + rule-based, zero LLM cost) ──
-        const ruleViolations = validatePostWrite(creative.content, genreProfile, bookRules);
+        const ruleViolations = [
+            ...validatePostWrite(creative.content, genreProfile, bookRules, resolvedLanguage),
+            ...detectCrossChapterRepetition(creative.content, fingerprintChapters, resolvedLanguage),
+        ];
         const aiTellIssues = analyzeAITells(creative.content).issues;
         const postWriteErrors = ruleViolations.filter(v => v.severity === "error");
         const postWriteWarnings = ruleViolations.filter(v => v.severity === "warning");
         if (ruleViolations.length > 0) {
-            this.ctx.logger?.warn(`Post-write: ${postWriteErrors.length} errors, ${postWriteWarnings.length} warnings in chapter ${chapterNumber}`);
+            this.logWarn(resolvedLanguage, {
+                zh: `后写校验：第${chapterNumber}章 ${postWriteErrors.length} 个错误，${postWriteWarnings.length} 个警告`,
+                en: `Post-write: ${postWriteErrors.length} errors, ${postWriteWarnings.length} warnings in chapter ${chapterNumber}`,
+            });
             for (const v of ruleViolations) {
                 this.ctx.logger?.warn(`[${v.severity}] ${v.rule}: ${v.description}`);
             }
         }
         if (aiTellIssues.length > 0) {
-            this.ctx.logger?.warn(`AI-tell check: ${aiTellIssues.length} issues in chapter ${chapterNumber}`);
+            this.logWarn(resolvedLanguage, {
+                zh: `AI 味检查：第${chapterNumber}章发现 ${aiTellIssues.length} 个问题`,
+                en: `AI-tell check: ${aiTellIssues.length} issues in chapter ${chapterNumber}`,
+            });
             for (const issue of aiTellIssues) {
                 this.ctx.logger?.warn(`[${issue.severity}] ${issue.category}: ${issue.description}`);
             }
         }
+        if (hookHealthIssues.length > 0) {
+            this.logWarn(resolvedLanguage, {
+                zh: `伏笔健康：第${chapterNumber}章发现 ${hookHealthIssues.length} 条警告`,
+                en: `Hook health: ${hookHealthIssues.length} warning(s) in chapter ${chapterNumber}`,
+            });
+            for (const issue of hookHealthIssues) {
+                this.ctx.logger?.warn(`[${issue.severity}] ${issue.category}: ${issue.description}`);
+            }
+        }
         // ── Merge into WriteChapterOutput ──
         const tokenUsage = {
             promptTokens: creativeUsage.promptTokens + settleUsage.promptTokens,
@@ -150,15 +266,21 @@ export class WriterAgent extends BaseAgent {
             wordCount: creative.wordCount,
             preWriteCheck: creative.preWriteCheck,
             postSettlement: settlement.postSettlement,
-            updatedState: settlement.updatedState,
+            runtimeStateDelta: settlement.runtimeStateDelta,
+            runtimeStateSnapshot: runtimeStateArtifacts?.snapshot ?? settlement.runtimeStateSnapshot,
+            updatedState: runtimeStateArtifacts?.currentStateMarkdown ?? settlement.updatedState,
             updatedLedger: settlement.updatedLedger,
-            updatedHooks: settlement.updatedHooks,
-            chapterSummary: settlement.chapterSummary,
+            updatedHooks: runtimeStateArtifacts?.hooksMarkdown ?? settlement.updatedHooks,
+            chapterSummary: settlement.runtimeStateDelta
+                ? this.renderDeltaSummaryRow(settlement.runtimeStateDelta)
+                : settlement.chapterSummary,
+            updatedChapterSummaries: runtimeStateArtifacts?.chapterSummariesMarkdown,
             updatedSubplots: settlement.updatedSubplots,
             updatedEmotionalArcs: settlement.updatedEmotionalArcs,
             updatedCharacterMatrix: settlement.updatedCharacterMatrix,
             postWriteErrors,
             postWriteWarnings,
+            hookHealthIssues,
             tokenUsage,
         };
     }
@@ -167,15 +289,24 @@ export class WriterAgent extends BaseAgent {
         const resolvedLang = params.book.language ?? params.genreProfile.language;
         const observerSystem = buildObserverSystemPrompt(params.book, params.genreProfile, resolvedLang);
         const observerUser = buildObserverUserPrompt(params.chapterNumber, params.title, params.content, resolvedLang);
-        this.ctx.logger?.info(`Phase 2a: observing facts for chapter ${params.chapterNumber}`);
+        this.logInfo(resolvedLang, {
+            zh: `阶段 2a：提取第${params.chapterNumber}章事实`,
+            en: `Phase 2a: observing facts for chapter ${params.chapterNumber}`,
+        });
         const observerResponse = await this.chat([
             { role: "system", content: observerSystem },
             { role: "user", content: observerUser },
         ], { maxTokens: 4096, temperature: 0.5 });
         const observations = observerResponse.content;
         // Phase 2b: Reflector — merge observations into truth files
-        this.ctx.logger?.info(`Phase 2b: reflecting observations into truth files`);
+        this.logInfo(resolvedLang, {
+            zh: "阶段 2b：把观察结果回写到真相文件",
+            en: "Phase 2b: reflecting observations into truth files",
+        });
         const settlerSystem = buildSettlerSystemPrompt(params.book, params.genreProfile, params.bookRules, resolvedLang);
+        const governedControlBlock = params.chapterIntent && params.contextPackage && params.ruleStack
+            ? this.buildSettlerGovernedControlBlock(params.chapterIntent, params.contextPackage, params.ruleStack, resolvedLang)
+            : undefined;
         const settlerUser = buildSettlerUserPrompt({
             chapterNumber: params.chapterNumber,
             title: params.title,
@@ -189,6 +320,8 @@ export class WriterAgent extends BaseAgent {
             characterMatrix: params.characterMatrix,
             volumeOutline: params.volumeOutline,
             observations,
+            selectedEvidenceBlock: params.selectedEvidenceBlock,
+            governedControlBlock,
         });
         // Settler outputs all truth files — scale with content size
         const settlerMaxTokens = Math.max(8192, Math.ceil(params.content.length * 0.8));
@@ -196,8 +329,41 @@ export class WriterAgent extends BaseAgent {
             { role: "system", content: settlerSystem },
             { role: "user", content: settlerUser },
         ], { maxTokens: settlerMaxTokens, temperature: 0.3 });
+        let mergedSettlement;
+        try {
+            const deltaOutput = parseSettlerDeltaOutput(response.content);
+            mergedSettlement = {
+                postSettlement: deltaOutput.postSettlement,
+                runtimeStateDelta: deltaOutput.runtimeStateDelta,
+                updatedState: "",
+                updatedLedger: "",
+                updatedHooks: "",
+                chapterSummary: "",
+                updatedSubplots: "",
+                updatedEmotionalArcs: "",
+                updatedCharacterMatrix: "",
+            };
+        }
+        catch {
+            const settlement = parseSettlementOutput(response.content, params.genreProfile);
+            mergedSettlement = governedControlBlock
+                ? {
+                    ...settlement,
+                    updatedHooks: mergeTableMarkdownByKey(params.originalHooks, settlement.updatedHooks, [0]),
+                    updatedSubplots: settlement.updatedSubplots
+                        ? mergeTableMarkdownByKey(params.originalSubplots, settlement.updatedSubplots, [0])
+                        : settlement.updatedSubplots,
+                    updatedEmotionalArcs: settlement.updatedEmotionalArcs
+                        ? mergeTableMarkdownByKey(params.originalEmotionalArcs, settlement.updatedEmotionalArcs, [0, 1])
+                        : settlement.updatedEmotionalArcs,
+                    updatedCharacterMatrix: settlement.updatedCharacterMatrix
+                        ? mergeCharacterMatrixMarkdown(params.originalCharacterMatrix, settlement.updatedCharacterMatrix)
+                        : settlement.updatedCharacterMatrix,
+                }
+                : settlement;
+        }
         return {
-            settlement: parseSettlementOutput(response.content, params.genreProfile),
+            settlement: mergedSettlement,
             usage: response.usage,
         };
     }
@@ -215,11 +381,18 @@ export class WriterAgent extends BaseAgent {
             "",
             output.content,
         ].join("\n");
+        const runtimeStateArtifacts = await this.resolveRuntimeStateArtifactsForOutput(bookDir, output, language);
         const writes = [
             writeFile(join(chaptersDir, filename), chapterContent, "utf-8"),
-            writeFile(join(storyDir, "current_state.md"), output.updatedState, "utf-8"),
-            writeFile(join(storyDir, "pending_hooks.md"), output.updatedHooks, "utf-8"),
+            writeFile(join(storyDir, "current_state.md"), runtimeStateArtifacts?.currentStateMarkdown ?? output.updatedState, "utf-8"),
+            writeFile(join(storyDir, "pending_hooks.md"), runtimeStateArtifacts?.hooksMarkdown ?? output.updatedHooks, "utf-8"),
         ];
+        if (runtimeStateArtifacts?.chapterSummariesMarkdown) {
+            writes.push(writeFile(join(storyDir, "chapter_summaries.md"), runtimeStateArtifacts.chapterSummariesMarkdown, "utf-8"));
+        }
+        if (runtimeStateArtifacts?.snapshot ?? output.runtimeStateSnapshot) {
+            writes.push(saveRuntimeStateSnapshot(bookDir, runtimeStateArtifacts?.snapshot ?? output.runtimeStateSnapshot));
+        }
         if (numericalSystem) {
             writes.push(writeFile(join(storyDir, "particle_ledger.md"), output.updatedLedger, "utf-8"));
         }
@@ -255,6 +428,7 @@ export class WriterAgent extends BaseAgent {
 本书是番外作品。以下正典约束不可违反，角色不得引用超出其信息边界的信息。
 ${params.parentCanon}\n`
             : "";
+        const lengthRequirementBlock = this.buildLengthRequirementBlock(params.lengthSpec, params.language ?? "zh");
         if (params.language === "en") {
             return `Write chapter ${params.chapterNumber}.
 ${contextBlock}
@@ -279,8 +453,7 @@ ${params.volumeOutline}
 - Pacing must match the outline's chapter span: if 5 chapters are planned for an arc, do not compress into 1-2.
 - PRE_WRITE_CHECK must identify which outline node this chapter covers.
 
-Requirements:
-- Chapter body must be at least ${params.wordCount} words
+${lengthRequirementBlock}
 - Output PRE_WRITE_CHECK first, then the chapter
 - Output only PRE_WRITE_CHECK, CHAPTER_TITLE, and CHAPTER_CONTENT blocks`;
         }
@@ -307,10 +480,129 @@ ${params.volumeOutline}
 - 剧情推进速度必须与卷纲规划的章节跨度匹配：如果卷纲规划某段剧情跨5章，不得在1-2章内讲完
 - PRE_WRITE_CHECK中必须明确标注本章对应的卷纲节点
 
-要求：
-- 正文不少于${params.wordCount}字
+${lengthRequirementBlock}
+- 先输出写作自检表，再写正文
+      - 只需输出 PRE_WRITE_CHECK、CHAPTER_TITLE、CHAPTER_CONTENT 三个区块`;
+    }
+    buildGovernedUserPrompt(params) {
+        const contextSections = params.contextPackage.selectedContext
+            .map((entry) => [
+            `### ${entry.source}`,
+            `- reason: ${entry.reason}`,
+            entry.excerpt ? `- excerpt: ${entry.excerpt}` : "",
+        ].filter(Boolean).join("\n"))
+            .join("\n\n");
+        const overrideLines = params.ruleStack.activeOverrides.length > 0
+            ? params.ruleStack.activeOverrides
+                .map((override) => `- ${override.from} -> ${override.to}: ${override.reason} (${override.target})`)
+                .join("\n")
+            : "- none";
+        const diagnosticLines = params.ruleStack.sections.diagnostic.length > 0
+            ? params.ruleStack.sections.diagnostic.join(", ")
+            : "none";
+        const traceNotes = params.trace && params.trace.notes.length > 0
+            ? params.trace.notes.map((note) => `- ${note}`).join("\n")
+            : "- none";
+        const lengthRequirementBlock = this.buildLengthRequirementBlock(params.lengthSpec, params.language ?? "zh");
+        const varianceBlock = params.varianceBrief
+            ? `\n${params.varianceBrief}\n`
+            : "";
+        if (params.language === "en") {
+            return `Write chapter ${params.chapterNumber}.
+
+## Chapter Intent
+${params.chapterIntent}
+
+## Selected Context
+${contextSections || "(none)"}
+
+## Rule Stack
+- Hard: ${params.ruleStack.sections.hard.join(", ") || "(none)"}
+- Soft: ${params.ruleStack.sections.soft.join(", ") || "(none)"}
+- Diagnostic: ${diagnosticLines}
+
+## Active Overrides
+${overrideLines}
+
+## Trace Notes
+${traceNotes}
+
+${varianceBlock}
+${lengthRequirementBlock}
+- Output PRE_WRITE_CHECK first, then the chapter
+- Output only PRE_WRITE_CHECK, CHAPTER_TITLE, and CHAPTER_CONTENT blocks`;
+        }
+        return `请续写第${params.chapterNumber}章。
+
+## 本章意图
+${params.chapterIntent}
+
+## 已选上下文
+${contextSections || "(无)"}
+
+## 规则栈
+- 硬护栏：${params.ruleStack.sections.hard.join("、") || "(无)"}
+- 软约束：${params.ruleStack.sections.soft.join("、") || "(无)"}
+- 诊断规则：${diagnosticLines}
+
+## 当前覆盖
+${overrideLines}
+
+## 追踪说明
+${traceNotes}
+
+${varianceBlock}
+${lengthRequirementBlock}
 - 先输出写作自检表，再写正文
 - 只需输出 PRE_WRITE_CHECK、CHAPTER_TITLE、CHAPTER_CONTENT 三个区块`;
+    }
+    buildSettlerGovernedControlBlock(chapterIntent, contextPackage, ruleStack, language) {
+        const selectedContext = contextPackage.selectedContext
+            .map((entry) => `- ${entry.source}: ${entry.reason}${entry.excerpt ? ` | ${entry.excerpt}` : ""}`)
+            .join("\n");
+        const overrides = ruleStack.activeOverrides.length > 0
+            ? ruleStack.activeOverrides
+                .map((override) => `- ${override.from} -> ${override.to}: ${override.reason} (${override.target})`)
+                .join("\n")
+            : "- none";
+        if (language === "en") {
+            return `\n## Chapter Control Inputs
+${chapterIntent}
+
+### Selected Context
+${selectedContext || "- none"}
+
+### Rule Stack
+- Hard guardrails: ${ruleStack.sections.hard.join(", ") || "(none)"}
+- Soft constraints: ${ruleStack.sections.soft.join(", ") || "(none)"}
+- Diagnostic rules: ${ruleStack.sections.diagnostic.join(", ") || "(none)"}
+
+### Active Overrides
+${overrides}\n`;
+        }
+        return `\n## 本章控制输入
+${chapterIntent}
+
+### 已选上下文
+${selectedContext || "- none"}
+
+### 规则栈
+- 硬护栏：${ruleStack.sections.hard.join("、") || "(无)"}
+- 软约束：${ruleStack.sections.soft.join("、") || "(无)"}
+- 诊断规则：${ruleStack.sections.diagnostic.join("、") || "(无)"}
+
+### 当前覆盖
+${overrides}\n`;
+    }
+    buildLengthRequirementBlock(lengthSpec, language) {
+        if (language === "en") {
+            return `Requirements:
+- Target length: ${lengthSpec.target} words
+- Acceptable range: ${lengthSpec.softMin}-${lengthSpec.softMax} words`;
+        }
+        return `要求：
+- 目标字数：${lengthSpec.target}字
+- 允许区间：${lengthSpec.softMin}-${lengthSpec.softMax}字`;
     }
     async loadRecentChapters(bookDir, currentChapter, count = 1) {
         const chaptersDir = join(bookDir, "chapters");
@@ -341,12 +633,15 @@ ${params.volumeOutline}
         }
     }
     /** Save new truth files (summaries, subplots, emotional arcs, character matrix). */
-    async saveNewTruthFiles(bookDir, output) {
+    async saveNewTruthFiles(bookDir, output, language = "zh") {
         const storyDir = join(bookDir, "story");
         const writes = [];
         // Append chapter summary to chapter_summaries.md
-        if (output.chapterSummary) {
-            writes.push(this.appendChapterSummary(storyDir, output.chapterSummary));
+        if (!output.runtimeStateDelta && output.updatedChapterSummaries) {
+            writes.push(writeFile(join(storyDir, "chapter_summaries.md"), output.updatedChapterSummaries, "utf-8"));
+        }
+        else if (!output.runtimeStateDelta && output.chapterSummary) {
+            writes.push(this.appendChapterSummary(storyDir, output.chapterSummary, language));
         }
         // Overwrite subplot board
         if (output.updatedSubplots) {
@@ -362,7 +657,52 @@ ${params.volumeOutline}
         }
         await Promise.all(writes);
     }
-    async appendChapterSummary(storyDir, summary) {
+    renderDeltaSummaryRow(delta) {
+        if (!delta.chapterSummary)
+            return "";
+        const summary = delta.chapterSummary;
+        const row = [
+            summary.chapter,
+            summary.title,
+            summary.characters,
+            summary.events,
+            summary.stateChanges,
+            summary.hookActivity,
+            summary.mood,
+            summary.chapterType,
+        ].map((value) => String(value).replace(/\|/g, "\\|").trim()).join(" | ");
+        return `| ${row} |`;
+    }
+    async buildRuntimeStateArtifactsIfPresent(bookDir, delta, language) {
+        if (!delta)
+            return null;
+        return buildRuntimeStateArtifacts({
+            bookDir,
+            delta,
+            language,
+        });
+    }
+    async resolveRuntimeStateArtifactsForOutput(bookDir, output, language) {
+        if (!output.runtimeStateDelta)
+            return null;
+        if (output.runtimeStateSnapshot
+            && output.updatedChapterSummaries
+            && output.updatedState
+            && output.updatedHooks) {
+            return {
+                snapshot: output.runtimeStateSnapshot,
+                currentStateMarkdown: output.updatedState,
+                hooksMarkdown: output.updatedHooks,
+                chapterSummariesMarkdown: output.updatedChapterSummaries,
+            };
+        }
+        return buildRuntimeStateArtifacts({
+            bookDir,
+            delta: output.runtimeStateDelta,
+            language,
+        });
+    }
+    async appendChapterSummary(storyDir, summary, language) {
         const summaryPath = join(storyDir, "chapter_summaries.md");
         let existing = "";
         try {
@@ -370,15 +710,34 @@ ${params.volumeOutline}
         }
         catch {
             // File doesn't exist yet — start with header
-            existing = "# 章节摘要\n\n| 章节 | 标题 | 出场人物 | 关键事件 | 状态变化 | 伏笔动态 | 情绪基调 | 章节类型 |\n|------|------|----------|----------|----------|----------|----------|----------|\n";
+            existing = language === "en"
+                ? "# Chapter Summaries\n\n| Chapter | Title | Characters | Key Events | State Changes | Hook Activity | Mood | Chapter Type |\n| --- | --- | --- | --- | --- | --- | --- | --- |\n"
+                : "# 章节摘要\n\n| 章节 | 标题 | 出场人物 | 关键事件 | 状态变化 | 伏笔动态 | 情绪基调 | 章节类型 |\n|------|------|----------|----------|----------|----------|----------|----------|\n";
         }
         // Extract only the data row(s) from the summary (skip header lines)
         const dataRows = summary
             .split("\n")
-            .filter((line) => line.startsWith("|") && !line.startsWith("| 章节") && !line.startsWith("|--"))
+            .filter((line) => line.startsWith("|")
+            && !line.startsWith("| 章节")
+            && !line.startsWith("| Chapter")
+            && !line.startsWith("|--")
+            && !line.startsWith("| ---"))
             .join("\n");
         if (dataRows) {
-            await writeFile(summaryPath, `${existing.trimEnd()}\n${dataRows}\n`, "utf-8");
+            // Deduplicate: remove existing rows with the same chapter number before appending
+            const newChapterNums = new Set(dataRows.split("\n")
+                .map((line) => line.split("|")[1]?.trim())
+                .filter((ch) => ch && /^\d+$/.test(ch)));
+            const deduped = existing
+                .split("\n")
+                .filter((line) => {
+                if (!line.startsWith("|"))
+                    return true;
+                const chNum = line.split("|")[1]?.trim();
+                return !chNum || !newChapterNums.has(chNum);
+            })
+                .join("\n");
+            await writeFile(summaryPath, `${deduped.trimEnd()}\n${dataRows}\n`, "utf-8");
         }
     }
     buildStyleFingerprint(styleProfileRaw) {