@actalk/inkos-core 1.3.6 → 1.3.7

package/dist/pipeline/runner.js

@@ -2,7 +2,7 @@ import { chatCompletion, createLLMClient } from "../llm/provider.js";
 import { ArchitectAgent } from "../agents/architect.js";
 import { FoundationReviewerAgent } from "../agents/foundation-reviewer.js";
 import { PlannerAgent } from "../agents/planner.js";
-import { ComposerAgent } from "../agents/composer.js";
+import { composeGovernedChapter } from "../agents/composer.js";
 import { WriterAgent } from "../agents/writer.js";
 import { LengthNormalizerAgent } from "../agents/length-normalizer.js";
 import { ChapterAnalyzerAgent } from "../agents/chapter-analyzer.js";
@@ -18,16 +18,17 @@ import { MemoryDB } from "../state/memory-db.js";
 import { dispatchNotification, dispatchWebhookEvent } from "../notify/dispatcher.js";
 import { buildLengthSpec, countChapterLength, formatLengthCount, isOutsideHardRange, isOutsideSoftRange, resolveLengthCountingMode } from "../utils/length-metrics.js";
 import { analyzeLongSpanFatigue } from "../utils/long-span-fatigue.js";
+import { buildWritingMethodologySection } from "../utils/writing-methodology.js";
+import { isNewLayoutBook, readCharacterContext, readStoryFrame, readVolumeMap, } from "../utils/outline-paths.js";
 import { loadNarrativeMemorySeed, loadSnapshotCurrentStateFacts } from "../state/runtime-state-store.js";
 import { rewriteStructuredStateFromMarkdown } from "../state/state-bootstrap.js";
 import { readFile, readdir, writeFile, mkdir, rename, rm, stat } from "node:fs/promises";
 import { join } from "node:path";
-import { readStoryFrame, readVolumeMap, readCharacterContext, readCurrentStateWithFallback, isNewLayoutBook } from "../utils/outline-paths.js";
 import { parseStateDegradedReviewNote, resolveStateDegradedBaseStatus, retrySettlementAfterValidationFailure, } from "./chapter-state-recovery.js";
 import { persistChapterArtifacts } from "./chapter-persistence.js";
 import { runChapterReviewCycle } from "./chapter-review-cycle.js";
 import { validateChapterTruthPersistence } from "./chapter-truth-validation.js";
-import { loadPersistedPlan, relativeToBookDir } from "./persisted-governed-plan.js";
+import { loadPersistedPlan, relativeToBookDir, savePersistedPlan } from "./persisted-governed-plan.js";
 const SEQUENCE_LEVEL_CATEGORIES = new Set([
     "Pacing Monotony", "节奏单调",
     "Mood Monotony", "情绪单调",
@@ -39,6 +40,118 @@ const SEQUENCE_LEVEL_CATEGORIES = new Set([
 function isSequenceLevelCategory(category) {
     return SEQUENCE_LEVEL_CATEGORIES.has(category);
 }
+const DEFAULT_IMPORT_FOUNDATION_MAX_FULL_TEXT_CHARS = 80_000;
+const DEFAULT_IMPORT_CHAPTER_EXCERPT_CHARS = 6_000;
+const DEFAULT_IMPORT_TITLE_CATALOG_CHARS = 24_000;
+const DEFAULT_IMPORT_EDGE_CHAPTER_COUNT = 4;
+const DEFAULT_IMPORT_MIDDLE_ANCHOR_COUNT = 8;
+function formatImportedChapter(chapter, index, language, content = chapter.content) {
+    return language === "en"
+        ? `Chapter ${index + 1}: ${chapter.title}\n\n${content}`
+        : `第${index + 1}章 ${chapter.title}\n\n${content}`;
+}
+function estimateImportFullTextLength(chapters) {
+    return chapters.reduce((total, chapter) => total + chapter.title.length + chapter.content.length + 24, 0);
+}
+function excerptHeadTail(text, maxChars, language) {
+    const clean = text.trim();
+    if (clean.length <= maxChars)
+        return clean;
+    const headChars = Math.max(200, Math.floor(maxChars * 0.6));
+    const tailChars = Math.max(200, maxChars - headChars);
+    const omitted = clean.length - headChars - tailChars;
+    const marker = language === "en"
+        ? `\n\n[... ${omitted} chars omitted for import-context budget ...]\n\n`
+        : `\n\n【中间省略 ${omitted} 字，用于控制导入上下文预算】\n\n`;
+    return `${clean.slice(0, headChars).trimEnd()}${marker}${clean.slice(-tailChars).trimStart()}`;
+}
+function pickImportAnchorIndexes(chapterCount, edgeChapterCount, middleAnchorCount) {
+    const selected = new Set();
+    for (let i = 0; i < Math.min(edgeChapterCount, chapterCount); i++)
+        selected.add(i);
+    for (let i = Math.max(0, chapterCount - edgeChapterCount); i < chapterCount; i++)
+        selected.add(i);
+    const middleStart = Math.min(edgeChapterCount, chapterCount);
+    const middleEnd = Math.max(middleStart, chapterCount - edgeChapterCount);
+    const middleSize = middleEnd - middleStart;
+    const anchors = Math.min(middleAnchorCount, middleSize);
+    for (let i = 0; i < anchors; i++) {
+        const offset = Math.floor(((i + 1) * middleSize) / (anchors + 1));
+        selected.add(Math.min(chapterCount - 1, middleStart + offset));
+    }
+    return [...selected].sort((a, b) => a - b);
+}
+function buildTitleCatalog(chapters, language, maxChars) {
+    const lines = chapters.map((chapter, index) => language === "en"
+        ? `- Chapter ${index + 1}: ${chapter.title} (${chapter.content.length} chars)`
+        : `- 第${index + 1}章：${chapter.title}（${chapter.content.length}字）`);
+    const joined = lines.join("\n");
+    if (joined.length <= maxChars)
+        return joined;
+    const headBudget = Math.floor(maxChars * 0.55);
+    const tailBudget = maxChars - headBudget;
+    const head = [];
+    const tail = [];
+    let headChars = 0;
+    let tailChars = 0;
+    for (const line of lines) {
+        if (headChars + line.length + 1 > headBudget)
+            break;
+        head.push(line);
+        headChars += line.length + 1;
+    }
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        if (tailChars + line.length + 1 > tailBudget)
+            break;
+        tail.unshift(line);
+        tailChars += line.length + 1;
+    }
+    const omitted = lines.length - head.length - tail.length;
+    const marker = language === "en"
+        ? `- ... ${omitted} chapter titles omitted ...`
+        : `- ……中间 ${omitted} 个章节标题省略……`;
+    return [...head, marker, ...tail].join("\n");
+}
+export function buildImportFoundationSource(chapters, language, options = {}) {
+    const maxFullTextChars = options.maxFullTextChars ?? DEFAULT_IMPORT_FOUNDATION_MAX_FULL_TEXT_CHARS;
+    const chapterExcerptChars = options.chapterExcerptChars ?? DEFAULT_IMPORT_CHAPTER_EXCERPT_CHARS;
+    const titleCatalogChars = options.titleCatalogChars ?? DEFAULT_IMPORT_TITLE_CATALOG_CHARS;
+    const edgeChapterCount = options.edgeChapterCount ?? DEFAULT_IMPORT_EDGE_CHAPTER_COUNT;
+    const middleAnchorCount = options.middleAnchorCount ?? DEFAULT_IMPORT_MIDDLE_ANCHOR_COUNT;
+    if (estimateImportFullTextLength(chapters) <= maxFullTextChars) {
+        return chapters.map((chapter, index) => formatImportedChapter(chapter, index, language)).join("\n\n---\n\n");
+    }
+    const anchorIndexes = pickImportAnchorIndexes(chapters.length, edgeChapterCount, middleAnchorCount);
+    const header = language === "en"
+        ? [
+            "## Import foundation source package",
+            "",
+            `The imported book has ${chapters.length} chapters. To avoid overflowing the LLM context, this package keeps the opening chapters, ending/continuation point, selected middle anchors, and a capped title catalog. Full chapters will still be replayed sequentially after foundation generation to rebuild truth files.`,
+        ].join("\n")
+        : [
+            "## 导入基础设定压缩资料包",
+            "",
+            `本次导入共 ${chapters.length} 章。为避免超出 LLM 上下文，这里保留开篇、结尾续写点、少量中段锚点和标题目录；完整章节将在后续顺序回放中逐章分析并沉淀 truth files。`,
+        ].join("\n");
+    const catalogTitle = language === "en" ? "## Capped chapter title catalog" : "## 章节标题目录（截断）";
+    const anchorsTitle = language === "en" ? "## Source excerpts for architecture" : "## 用于反推基础设定的正文摘录";
+    const anchorText = anchorIndexes
+        .map((index) => {
+        const chapter = chapters[index];
+        return formatImportedChapter(chapter, index, language, excerptHeadTail(chapter.content, chapterExcerptChars, language));
+    })
+        .join("\n\n---\n\n");
+    return [
+        header,
+        "",
+        catalogTitle,
+        buildTitleCatalog(chapters, language, titleCatalogChars),
+        "",
+        anchorsTitle,
+        anchorText,
+    ].join("\n");
+}
 export class PipelineRunner {
     state;
     config;
@@ -98,7 +211,7 @@ export class PipelineRunner {
         }
     }
     async generateAndReviewFoundation(params) {
-        const maxRetries = params.maxRetries ?? 2;
+        const maxRetries = params.maxRetries ?? this.config.foundationReviewRetries ?? 2;
         let foundation = await params.generate();
         for (let attempt = 0; attempt < maxRetries; attempt++) {
             this.logStage(params.stageLanguage, {
@@ -207,7 +320,6 @@ export class PipelineRunner {
                 apiKey,
                 model: override.model,
                 temperature: base?.temperature ?? 0.7,
-                maxTokens: base?.maxTokens ?? 8192,
                 thinkingBudget: base?.thinkingBudget ?? 0,
                 apiFormat,
                 stream,
@@ -252,12 +364,13 @@ export class PipelineRunner {
         const bookDir = this.state.bookDir(book.id);
         const stagingBookDir = join(this.state.booksDir, `.tmp-book-create-${book.id}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`);
         const stageLanguage = await this.resolveBookLanguage(book);
+        const effectiveExternalContext = options.externalContext ?? this.config.externalContext;
         this.logStage(stageLanguage, { zh: "生成基础设定", en: "generating foundation" });
         const { profile: gp } = await this.loadGenreProfile(book.genre);
         const reviewer = new FoundationReviewerAgent(this.agentCtxFor("foundation-reviewer", book.id));
         const resolvedLanguage = (book.language ?? gp.language) === "en" ? "en" : "zh";
         const foundation = await this.generateAndReviewFoundation({
-            generate: (reviewFeedback) => architect.generateFoundation(book, options.externalContext ?? this.config.externalContext, reviewFeedback),
+            generate: (reviewFeedback) => architect.generateFoundation(book, effectiveExternalContext, reviewFeedback),
             reviewer,
             mode: "original",
             language: resolvedLanguage,
@@ -268,8 +381,13 @@ export class PipelineRunner {
             await this.state.saveBookConfigAt(stagingBookDir, book);
             this.logStage(stageLanguage, { zh: "写入基础设定文件", en: "writing foundation files" });
             await architect.writeFoundationFiles(stagingBookDir, foundation, gp.numericalSystem, book.language ?? gp.language);
+            if (effectiveExternalContext && effectiveExternalContext.trim().length > 0) {
+                const storyDir = join(stagingBookDir, "story");
+                await mkdir(storyDir, { recursive: true });
+                await writeFile(join(storyDir, "brief.md"), effectiveExternalContext, "utf-8");
+            }
             this.logStage(stageLanguage, { zh: "初始化控制文档", en: "initializing control documents" });
-            await this.state.ensureControlDocumentsAt(stagingBookDir, book.language ?? gp.language, options.authorIntent ?? this.config.externalContext);
+            await this.state.ensureControlDocumentsAt(stagingBookDir, book.language ?? gp.language, options.authorIntent ?? effectiveExternalContext);
             if (options.currentFocus?.trim()) {
                 await writeFile(join(stagingBookDir, "story", "current_focus.md"), options.currentFocus.trimEnd() + "\n", "utf-8");
             }
@@ -290,32 +408,20 @@ export class PipelineRunner {
         }
     }
     /**
-     * Revise an existing book's foundation — 把已有书的架构稿重写（legacy 条目式升级
-     * 到段落式 / Phase 5 书按 feedback 再次调整细节），把架构稿相关文件备份到
-     * story/.backup-<phase4|phase5>-<timestamp>/。
+     * Revise an existing book foundation without touching runtime chapter state.
      *
-     * 关键约束：**只改架构稿文件**（outline/ + roles/ + 4 个 legacy shim），
-     * 不动任何运行时状态文件（current_state / pending_hooks / particle_ledger /
-     * subplot_board / emotional_arcs）—— 跟 context-transform 里给 LLM 的 upgrade
-     * hint 承诺"升级只改架构稿，不动已写的章节"保持一致。
-     *
-     * 两种来源：
-     *   - legacy 书（没有 outline/story_frame.md）：读 story_bible.md 等 4 个
-     *     flat 文件作为原内容
-     *   - Phase 5 书（outline/story_frame.md 已存在）：读 outline/ + roles/ 的
-     *     权威内容作为原内容——**不能读 flat 文件**，那些是 shim（只有指针 + 2000
-     *     字摘录）会丢信息
+     * Legacy books read the flat foundation files as source. Phase 5+ books read
+     * the authoritative outline/ and roles/ files instead of the compatibility
+     * shims, otherwise large role/story details can be lost during rewrite.
      */
     async reviseFoundation(bookId, feedback) {
         const bookDir = this.state.bookDir(bookId);
         const storyDir = join(bookDir, "story");
         const isPhase5 = await isNewLayoutBook(bookDir);
-        // 1. 备份架构稿相关文件（不包含运行时状态文件，那些不会被动）
         const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
         const backupTag = isPhase5 ? "phase5" : "phase4";
         const backupDir = join(storyDir, `.backup-${backupTag}-${timestamp}`);
         await mkdir(backupDir, { recursive: true });
-        // 备份 legacy flat 文件（两种书都有这几个——legacy 是权威，Phase 5 是 shim）
         const flatFiles = ["story_bible.md", "volume_outline.md", "book_rules.md", "character_matrix.md"];
         for (const fileName of flatFiles) {
             try {
@@ -323,33 +429,27 @@ export class PipelineRunner {
                 await writeFile(join(backupDir, fileName), content, "utf-8");
             }
             catch {
-                /* 文件不存在就跳过 */
+                // Missing legacy shim files are fine for partially migrated books.
             }
         }
-        // Phase 5 书还要备份权威来源：outline/ 和 roles/ 两个目录
         if (isPhase5) {
             await this.copyDirShallow(join(storyDir, "outline"), join(backupDir, "outline"));
             await this.copyDirRecursive(join(storyDir, "roles"), join(backupDir, "roles"));
         }
-        // 2. 读原内容作为 reviseFrom 输入 —— 必须从权威源读
         const book = await this.state.loadBookConfig(bookId);
-        let oldStoryBible, oldVolumeOutline, oldBookRules, oldCharacterMatrix;
+        let oldStoryBible;
+        let oldVolumeOutline;
+        let oldBookRules;
+        let oldCharacterMatrix;
         if (isPhase5) {
-            // Phase 5 书的 story_bible.md / volume_outline.md / character_matrix.md
-            // 都是 shim（只有指针 + 摘录），信息不完整。从 outline-paths helper 读
-            // 权威文件：outline/story_frame.md / outline/volume_map.md / roles/**/*.md
             [oldStoryBible, oldVolumeOutline, oldCharacterMatrix] = await Promise.all([
                 readStoryFrame(bookDir),
                 readVolumeMap(bookDir),
                 readCharacterContext(bookDir),
             ]);
-            // book_rules.md 在 Phase 5 下虽然是 shim，但 YAML frontmatter 已经搬到
-            // story_frame.md 顶部了（writeFoundationFiles 做的合并），这里读 shim
-            // 文件 OK——里面的"叙事指引摘录"部分是唯一遗留信息。
             oldBookRules = await readFile(join(storyDir, "book_rules.md"), "utf-8").catch(() => "");
         }
         else {
-            // legacy 书：4 个 flat 文件就是权威
             [oldStoryBible, oldVolumeOutline, oldBookRules, oldCharacterMatrix] = await Promise.all([
                 readFile(join(storyDir, "story_bible.md"), "utf-8").catch(() => ""),
                 readFile(join(storyDir, "volume_outline.md"), "utf-8").catch(() => ""),
@@ -357,7 +457,6 @@ export class PipelineRunner {
                 readFile(join(storyDir, "character_matrix.md"), "utf-8").catch(() => ""),
             ]);
         }
-        // 3. 架构师按 reviseFrom + feedback 重写
         const architect = new ArchitectAgent(this.agentCtxFor("architect", bookId));
         const foundation = await architect.generateFoundation(book, undefined, undefined, {
             reviseFrom: {
@@ -368,7 +467,6 @@ export class PipelineRunner {
                 userFeedback: feedback,
             },
         });
-        // 4. 可选 foundation-reviewer 审核——挂了只 warn 不阻断
         const reviewer = new FoundationReviewerAgent(this.agentCtxFor("foundation-reviewer", bookId));
         const resolvedLanguage = (book.language ?? "zh") === "en" ? "en" : "zh";
         try {
@@ -378,13 +476,12 @@ export class PipelineRunner {
                 language: resolvedLanguage,
             });
             if (!review.passed) {
-                this.config.logger?.warn?.(`[reviseFoundation] 审核未通过，仍接受转换结果。反馈：${review.overallFeedback ?? ""}`);
+                this.config.logger?.warn?.(`[reviseFoundation] Foundation review did not pass; accepting rewrite. Feedback: ${review.overallFeedback ?? ""}`);
             }
         }
         catch (error) {
-            this.config.logger?.warn?.(`[reviseFoundation] 审核调用失败，跳过：${error instanceof Error ? error.message : String(error)}`);
+            this.config.logger?.warn?.(`[reviseFoundation] Foundation review failed and was skipped: ${error instanceof Error ? error.message : String(error)}`);
         }
-        // 5. 目录补全 → 写新文件（mode="revise" 不动运行时状态 + 清空旧 role 文件）
         const outlineDir = join(storyDir, "outline");
         await mkdir(outlineDir, { recursive: true });
         await mkdir(join(storyDir, "roles", "主要角色"), { recursive: true });
@@ -392,7 +489,6 @@ export class PipelineRunner {
         const { profile: gp } = await this.loadGenreProfile(book.genre);
         await architect.writeFoundationFiles(bookDir, foundation, gp.numericalSystem, book.language ?? gp.language, "revise");
     }
-    /** Shallow copy (non-recursive) — used to back up outline/ which has no subdirs. */
     async copyDirShallow(src, dest) {
         try {
             await mkdir(dest, { recursive: true });
@@ -403,15 +499,14 @@ export class PipelineRunner {
                     await writeFile(join(dest, entry), content, "utf-8");
                 }
                 catch {
-                    /* skip files we can't read */
+                    // Skip unreadable files.
                 }
             }));
         }
         catch {
-            /* src doesn't exist → nothing to back up */
+            // Source directory does not exist.
         }
     }
-    /** Recursive copy — used to back up roles/ which has 主要角色/ + 次要角色/. */
     async copyDirRecursive(src, dest) {
         try {
             await mkdir(dest, { recursive: true });
@@ -428,13 +523,13 @@ export class PipelineRunner {
                         await writeFile(destPath, content, "utf-8");
                     }
                     catch {
-                        /* skip */
+                        // Skip unreadable files.
                     }
                 }
             }
         }
         catch {
-            /* src doesn't exist */
+            // Source directory does not exist.
         }
     }
     /** Import external source material and generate fanfic_canon.md */
@@ -613,7 +708,7 @@ export class PipelineRunner {
             chapterNumber,
             intentPath: relativeToBookDir(bookDir, plan.runtimePath),
             goal: plan.intent.goal,
-            conflicts: plan.intent.conflicts.map((conflict) => `${conflict.type}: ${conflict.resolution}`),
+            conflicts: [],
         };
     }
     async composeChapter(bookId, context) {
@@ -629,7 +724,7 @@ export class PipelineRunner {
             chapterNumber,
             intentPath: relativeToBookDir(bookDir, plan.runtimePath),
             goal: plan.intent.goal,
-            conflicts: plan.intent.conflicts.map((conflict) => `${conflict.type}: ${conflict.resolution}`),
+            conflicts: [],
             contextPath: relativeToBookDir(bookDir, composed.contextPath),
             ruleStackPath: relativeToBookDir(bookDir, composed.ruleStackPath),
             tracePath: relativeToBookDir(bookDir, composed.tracePath),
@@ -723,6 +818,7 @@ export class PipelineRunner {
                 auditOptions: reviseControlInput
                     ? {
                         chapterIntent: reviseControlInput.plan.intentMarkdown,
+                        chapterMemo: reviseControlInput.plan.memo,
                         contextPackage: reviseControlInput.composed.contextPackage,
                         ruleStack: reviseControlInput.composed.ruleStack,
                     }
@@ -751,6 +847,8 @@ export class PipelineRunner {
             const reviseOutput = await reviser.reviseChapter(bookDir, content, targetChapter, preRevision.auditResult.issues, mode, book.genre, reviseControlInput
                 ? {
                     chapterIntent: reviseControlInput.plan.intentMarkdown,
+                    chapterMemo: reviseControlInput.plan.memo,
+                    chapterIntentData: reviseControlInput.plan.intent,
                     contextPackage: reviseControlInput.composed.contextPackage,
                     ruleStack: reviseControlInput.composed.ruleStack,
                     lengthSpec,
@@ -776,6 +874,7 @@ export class PipelineRunner {
                     ? {
                         temperature: 0,
                         chapterIntent: reviseControlInput.plan.intentMarkdown,
+                        chapterMemo: reviseControlInput.plan.memo,
                         contextPackage: reviseControlInput.composed.contextPackage,
                         ruleStack: reviseControlInput.composed.ruleStack,
                         truthFileOverrides: {
@@ -914,12 +1013,19 @@ export class PipelineRunner {
                 return "(文件不存在)";
             }
         };
+        // Phase 5: prefer the new prose outline files; fall back to legacy paths.
+        const readOutline = async (newRel, legacyRel) => {
+            const preferred = await readSafe(join(storyDir, newRel));
+            if (preferred.trim() && preferred !== "(文件不存在)")
+                return preferred;
+            return readSafe(join(storyDir, legacyRel));
+        };
         const [currentState, particleLedger, pendingHooks, storyBible, volumeOutline, bookRules] = await Promise.all([
             readSafe(join(storyDir, "current_state.md")),
             readSafe(join(storyDir, "particle_ledger.md")),
             readSafe(join(storyDir, "pending_hooks.md")),
-            readStoryFrame(bookDir, "(文件不存在)"),
-            readVolumeMap(bookDir, "(文件不存在)"),
+            readOutline("outline/story_frame.md", "story_bible.md"),
+            readOutline("outline/volume_map.md", "volume_outline.md"),
             readSafe(join(storyDir, "book_rules.md")),
         ]);
         return { currentState, particleLedger, pendingHooks, storyBible, volumeOutline, bookRules };
@@ -984,6 +1090,8 @@ export class PipelineRunner {
         const reducedControlInput = writeInput.chapterIntent && writeInput.contextPackage && writeInput.ruleStack
             ? {
                 chapterIntent: writeInput.chapterIntent,
+                chapterMemo: writeInput.chapterMemo,
+                chapterIntentData: writeInput.chapterIntentData,
                 contextPackage: writeInput.contextPackage,
                 ruleStack: writeInput.ruleStack,
             }
@@ -991,6 +1099,10 @@ export class PipelineRunner {
         const { profile: gp } = await this.loadGenreProfile(book.genre);
         const pipelineLang = book.language ?? gp.language;
         const lengthSpec = buildLengthSpec(wordCount ?? book.chapterWordCount, pipelineLang);
+        const { normalizePostWriteSurface, validatePostWrite: postWriteValidate, } = await import("../agents/post-write-validator.js");
+        const { validateHookLedger } = await import("../utils/hook-ledger-validator.js");
+        const { readBookRules } = await import("../agents/rules-reader.js");
+        const parsedBookRules = (await readBookRules(bookDir))?.rules ?? null;
         // 1. Write chapter
         const writer = new WriterAgent(this.agentCtxFor("writer", bookId));
         this.logStage(stageLanguage, { zh: "撰写章节草稿", en: "writing chapter draft" });
@@ -1024,11 +1136,27 @@ export class PipelineRunner {
                 lengthSpec,
                 chapterIntent: writeInput.chapterIntent,
             }),
+            normalizePostWriteSurface: (chapterContent) => normalizePostWriteSurface(chapterContent, pipelineLang),
             assertChapterContentNotEmpty: (content, stage) => this.assertChapterContentNotEmpty(content, chapterNumber, stage),
             addUsage: PipelineRunner.addUsage,
-            restoreLostAuditIssues: (previous, next) => this.restoreLostAuditIssues(previous, next),
-            analyzeAITells,
-            analyzeSensitiveWords,
+            analyzeAITells: (content) => analyzeAITells(content, pipelineLang),
+            analyzeSensitiveWords: (content) => analyzeSensitiveWords(content, undefined, pipelineLang),
+            runPostWriteChecks: (content) => {
+                const baseIssues = postWriteValidate(content, gp, parsedBookRules, pipelineLang)
+                    .filter((v) => v.severity === "error")
+                    .map((v) => ({
+                    severity: "critical",
+                    category: v.rule,
+                    description: v.description,
+                    suggestion: v.suggestion,
+                }));
+                // Phase 9-3: verify the draft acts on every hook the memo committed to.
+                const memoBody = writeInput.chapterMemo?.body ?? "";
+                const ledgerIssues = memoBody
+                    ? validateHookLedger(memoBody, content)
+                    : [];
+                return [...baseIssues, ...ledgerIssues];
+            },
             logWarn: (message) => this.logWarn(pipelineLang, message),
             logStage: (message) => this.logStage(stageLanguage, message),
         });
@@ -1039,6 +1167,59 @@ export class PipelineRunner {
         let auditResult = reviewResult.auditResult;
         const postReviseCount = reviewResult.postReviseCount;
         const normalizeApplied = reviewResult.normalizeApplied;
+        // 3b. File-layer polish pass — runs AFTER structural audit accepts the
+        // chapter. Polisher only touches sentence craft / paragraph shape /
+        // wording / sensory detail / dialogue naturalness. Plot / character /
+        // mainline stay frozen. Skipped when audit did not produce a passing
+        // chapter (leave the failing draft visible for the next cycle) or when
+        // length is dangerously off-range (normalize should handle it, not polish).
+        if (auditResult.passed) {
+            try {
+                const { PolisherAgent } = await import("../agents/polisher.js");
+                const polisher = new PolisherAgent(this.agentCtxFor("polisher", bookId));
+                this.logStage(stageLanguage, { zh: "文字层润色", en: "polishing prose" });
+                const polishOutput = await polisher.polishChapter({
+                    chapterContent: finalContent,
+                    chapterNumber,
+                    chapterMemo: reducedControlInput?.chapterMemo,
+                    language: pipelineLang === "en" ? "en" : "zh",
+                });
+                totalUsage = PipelineRunner.addUsage(totalUsage, polishOutput.tokenUsage);
+                if (polishOutput.changed && polishOutput.polishedContent.trim().length > 0) {
+                    finalContent = normalizePostWriteSurface(polishOutput.polishedContent, pipelineLang);
+                    finalWordCount = countChapterLength(finalContent, lengthSpec.countingMode);
+                }
+            }
+            catch (error) {
+                this.logWarn(pipelineLang, {
+                    zh: `润色阶段失败：${error instanceof Error ? error.message : String(error)}`,
+                    en: `polish stage failed: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+        // 3c. Lightweight per-chapter promotion pass — check if any hooks should
+        // be promoted based on advanced_count derived from chapter_summaries.
+        // Runs BEFORE persistence so the reviewer of the NEXT chapter sees the
+        // updated ledger. No LLM calls — pure ledger parse + threshold check.
+        {
+            const { rerunPromotionPass } = await import("../utils/hook-promotion.js");
+            const { parsePendingHooksMarkdown, renderHookSnapshot } = await import("../utils/story-markdown.js");
+            const promotionStoryDir = join(bookDir, "story");
+            const ledgerPath = join(promotionStoryDir, "pending_hooks.md");
+            const ledgerRaw = await readFile(ledgerPath, "utf-8").catch(() => "");
+            if (ledgerRaw.trim()) {
+                const hooks = parsePendingHooksMarkdown(ledgerRaw);
+                if (hooks.length > 0) {
+                    const summariesRaw = await readFile(join(promotionStoryDir, "chapter_summaries.md"), "utf-8").catch(() => "");
+                    const promotionResult = rerunPromotionPass(hooks, summariesRaw);
+                    if (promotionResult.updated) {
+                        const ledgerLang = /[\u4e00-\u9fff]/.test(ledgerRaw) ? "zh" : "en";
+                        await writeFile(ledgerPath, renderHookSnapshot([...promotionResult.hooks], ledgerLang), "utf-8");
+                        this.config.logger?.info(`[promotion] ${promotionResult.flippedCount} hook(s) promoted after chapter ${chapterNumber}`);
+                    }
+                }
+            }
+        }
         // 4. Save the final chapter and truth files from a single persistence source
         this.logStage(stageLanguage, { zh: "落盘最终章节", en: "persisting final chapter" });
         this.logStage(stageLanguage, { zh: "生成最终真相文件", en: "rebuilding final truth files" });
@@ -1102,10 +1283,13 @@ export class PipelineRunner {
         // 4.1 Validate settler output before writing
         this.logStage(stageLanguage, { zh: "校验真相文件变更", en: "validating truth file updates" });
         const storyDir = join(bookDir, "story");
-        const [oldState, oldHooks, oldLedger] = await Promise.all([
+        const [oldState, oldHooks, oldLedger, authorityStoryFrame, authorityBookRules, authorityChapterSummaries] = await Promise.all([
             readFile(join(storyDir, "current_state.md"), "utf-8").catch(() => ""),
             readFile(join(storyDir, "pending_hooks.md"), "utf-8").catch(() => ""),
             readFile(join(storyDir, "particle_ledger.md"), "utf-8").catch(() => ""),
+            readStoryFrame(bookDir).catch(() => ""),
+            readFile(join(storyDir, "book_rules.md"), "utf-8").catch(() => ""),
+            readFile(join(storyDir, "chapter_summaries.md"), "utf-8").catch(() => ""),
         ]);
         const validator = new StateValidatorAgent(this.agentCtxFor("state-validator", bookId));
         const truthValidation = await validateChapterTruthPersistence({
@@ -1123,6 +1307,11 @@ export class PipelineRunner {
                 oldHooks,
                 oldLedger,
             },
+            authorityContext: {
+                storyFrame: authorityStoryFrame,
+                bookRules: authorityBookRules,
+                chapterSummaries: authorityChapterSummaries,
+            },
             reducedControlInput,
             language: pipelineLang,
             logWarn: (message) => this.logWarn(pipelineLang, message),
@@ -1464,21 +1653,36 @@ export class PipelineRunner {
      * Also saves the statistical style_profile.json.
      */
     async generateStyleGuide(bookId, referenceText, sourceName) {
-        if (referenceText.length < 500) {
-            throw new Error(`Reference text too short (${referenceText.length} chars, minimum 500). Provide at least 2000 chars for reliable style extraction.`);
+        const sample = referenceText.trim();
+        if (!sample) {
+            throw new Error("Reference text is required for style extraction.");
         }
         const { analyzeStyle } = await import("../agents/style-analyzer.js");
         const bookDir = this.state.bookDir(bookId);
         const storyDir = join(bookDir, "story");
         await mkdir(storyDir, { recursive: true });
         // Statistical fingerprint
-        const profile = analyzeStyle(referenceText, sourceName);
+        const profile = analyzeStyle(sample, sourceName);
         await writeFile(join(storyDir, "style_profile.json"), JSON.stringify(profile, null, 2), "utf-8");
-        // LLM qualitative extraction
-        const response = await chatCompletion(this.config.client, this.config.model, [
-            {
-                role: "system",
-                content: `你是一位文学风格分析专家。分析参考文本的写作风格，提取可供模仿的定性特征。
+        const book = await this.state.loadBookConfig(bookId);
+        const { profile: gp } = await this.loadGenreProfile(book.genre);
+        const lang = (book.language ?? gp.language) === "en" ? "en" : "zh";
+        let qualitativeGuide;
+        if (sample.length < 500) {
+            qualitativeGuide = this.buildDeterministicStyleGuide(profile, {
+                language: lang,
+                reason: lang === "en"
+                    ? `The sample is short (${sample.length} chars), so this guide uses the statistical fingerprint instead of LLM qualitative extraction.`
+                    : `样本文本较短（${sample.length}字），本次先使用统计指纹生成文风指南，不强行调用 LLM 做定性拆解。`,
+            });
+        }
+        else {
+            try {
+                // LLM qualitative extraction
+                const response = await chatCompletion(this.config.client, this.config.model, [
+                    {
+                        role: "system",
+                        content: `你是一位文学风格分析专家。分析参考文本的写作风格，提取可供模仿的定性特征。
 
 输出格式（Markdown）：
 ## 叙事声音与语气
@@ -1506,14 +1710,76 @@ export class PipelineRunner {
 （任何值得模仿的个人写作习惯）
 
 分析必须基于原文实际特征，不要泛泛而谈。每个部分用1-2个原文例句佐证。`,
-            },
-            {
-                role: "user",
-                content: `分析以下参考文本的写作风格：\n\n${referenceText.slice(0, 20000)}`,
-            },
-        ], { temperature: 0.3 });
-        await writeFile(join(storyDir, "style_guide.md"), response.content, "utf-8");
-        return response.content;
+                    },
+                    {
+                        role: "user",
+                        content: `分析以下参考文本的写作风格：\n\n${sample.slice(0, 20000)}`,
+                    },
+                ], { temperature: 0.3 });
+                qualitativeGuide = response.content.trim()
+                    ? response.content
+                    : this.buildDeterministicStyleGuide(profile, {
+                        language: lang,
+                        reason: lang === "en"
+                            ? "The LLM returned empty style analysis; using the statistical fingerprint fallback."
+                            : "LLM 未返回有效文风分析，本次使用统计指纹兜底生成文风指南。",
+                    });
+            }
+            catch (error) {
+                qualitativeGuide = this.buildDeterministicStyleGuide(profile, {
+                    language: lang,
+                    reason: lang === "en"
+                        ? `LLM qualitative extraction failed: ${error instanceof Error ? error.message : String(error)}. Using the statistical fingerprint fallback.`
+                        : `LLM 定性拆解失败：${error instanceof Error ? error.message : String(error)}。本次使用统计指纹兜底生成文风指南。`,
+                });
+            }
+        }
+        const craftMethodology = buildWritingMethodologySection(lang);
+        const fullStyleGuide = `${qualitativeGuide}\n\n${craftMethodology}`;
+        await writeFile(join(storyDir, "style_guide.md"), fullStyleGuide, "utf-8");
+        return fullStyleGuide;
+    }
+    buildDeterministicStyleGuide(profile, options) {
+        if (options.language === "en") {
+            return [
+                "# Style Guide",
+                "",
+                `> ${options.reason}`,
+                "",
+                "## Statistical Fingerprint",
+                `- Source: ${profile.sourceName ?? "unknown"}`,
+                `- Average sentence length: ${profile.avgSentenceLength}`,
+                `- Sentence length variance: ${profile.sentenceLengthStdDev}`,
+                `- Average paragraph length: ${profile.avgParagraphLength}`,
+                `- Vocabulary diversity: ${Math.round(profile.vocabularyDiversity * 100)}%`,
+                profile.topPatterns.length > 0 ? `- Repeated openings: ${profile.topPatterns.join(", ")}` : "- Repeated openings: none obvious in this sample",
+                profile.rhetoricalFeatures.length > 0 ? `- Rhetorical features: ${profile.rhetoricalFeatures.join(", ")}` : "- Rhetorical features: none obvious in this sample",
+                "",
+                "## How To Use",
+                "- Treat this as a lightweight style fingerprint, not a full imitation bible.",
+                "- Keep sentence and paragraph rhythm close to the sample when drafting.",
+                "- If this guide feels too thin, import a longer excerpt later; the file will be replaced.",
+            ].join("\n");
+        }
+        return [
+            "# 文风指南",
+            "",
+            `> ${options.reason}`,
+            "",
+            "## 统计风格指纹",
+            `- 来源：${profile.sourceName ?? "unknown"}`,
+            `- 平均句长：${profile.avgSentenceLength}`,
+            `- 句长波动：${profile.sentenceLengthStdDev}`,
+            `- 平均段落长度：${profile.avgParagraphLength}`,
+            `- 词汇多样性：${Math.round(profile.vocabularyDiversity * 100)}%`,
+            profile.topPatterns.length > 0 ? `- 高频句首/模式：${profile.topPatterns.join("、")}` : "- 高频句首/模式：样本内不明显",
+            profile.rhetoricalFeatures.length > 0 ? `- 修辞特征：${profile.rhetoricalFeatures.join("、")}` : "- 修辞特征：样本内不明显",
+            "",
+            "## 使用方式",
+            "- 这是一份轻量文风指纹，不是完整仿写圣经。",
+            "- 后续写作优先参考句长、段落长度、节奏波动和可见修辞。",
+            "- 如果想得到更稳定的定性拆解，后续可以导入更长片段覆盖本文件。",
+        ].join("\n");
     }
     /**
      * Import canon from parent book for spinoff writing.
@@ -1541,15 +1807,22 @@ export class PipelineRunner {
             }
         };
         const parentBook = await this.state.loadBookConfig(parentBookId);
+        // Phase 5: parent book may be on the new prose layout; prefer outline/.
+        const readParentOutline = async (newRel, legacyRel) => {
+            const preferred = await readSafe(join(parentDir, "story", newRel));
+            if (preferred.trim() && preferred !== "(无)")
+                return preferred;
+            return readSafe(join(parentDir, "story", legacyRel));
+        };
         const [storyBible, currentState, ledger, hooks, summaries, subplots, emotions, matrix] = await Promise.all([
-            readStoryFrame(parentDir, "(无)"),
-            readCurrentStateWithFallback(parentDir, "(无)"),
+            readParentOutline("outline/story_frame.md", "story_bible.md"),
+            readSafe(join(parentDir, "story/current_state.md")),
             readSafe(join(parentDir, "story/particle_ledger.md")),
             readSafe(join(parentDir, "story/pending_hooks.md")),
             readSafe(join(parentDir, "story/chapter_summaries.md")),
             readSafe(join(parentDir, "story/subplot_board.md")),
             readSafe(join(parentDir, "story/emotional_arcs.md")),
-            readCharacterContext(parentDir, "(无)"),
+            readSafe(join(parentDir, "story/character_matrix.md")),
         ]);
         const response = await chatCompletion(this.config.client, this.config.model, [
             {
@@ -1679,7 +1952,7 @@ ${matrix}`,
      * Import existing chapters into a book. Reverse-engineers all truth files
      * via sequential replay so the Writer and Auditor can continue naturally.
      *
-     * Step 1: Generate foundation (story_bible, volume_outline, book_rules) from all chapters.
+     * Step 1: Generate foundation (story_frame, volume_map, book_rules) from all chapters.
      * Step 2: Sequentially replay each chapter through ChapterAnalyzer to build truth files.
      */
     async importChapters(input) {
@@ -1697,31 +1970,29 @@ ${matrix}`,
                     zh: `步骤 1：从 ${input.chapters.length} 章生成基础设定...`,
                     en: `Step 1: Generating foundation from ${input.chapters.length} chapters...`,
                 }));
-                const allText = input.chapters.map((c, i) => resolvedLanguage === "en"
-                    ? `Chapter ${i + 1}: ${c.title}\n\n${c.content}`
-                    : `第${i + 1}章 ${c.title}\n\n${c.content}`).join("\n\n---\n\n");
+                const foundationSource = buildImportFoundationSource(input.chapters, resolvedLanguage);
                 const architect = new ArchitectAgent(this.agentCtxFor("architect", input.bookId));
                 const isSeries = input.importMode === "series";
                 const foundation = isSeries
                     ? await this.generateAndReviewFoundation({
-                        generate: (reviewFeedback) => architect.generateFoundationFromImport(book, allText, undefined, reviewFeedback, { importMode: "series" }),
+                        generate: (reviewFeedback) => architect.generateFoundationFromImport(book, foundationSource, undefined, reviewFeedback, { importMode: "series" }),
                         reviewer: new FoundationReviewerAgent(this.agentCtxFor("foundation-reviewer", input.bookId)),
                         mode: "series",
                         language: resolvedLanguage === "en" ? "en" : "zh",
                         stageLanguage: resolvedLanguage,
                     })
-                    : await architect.generateFoundationFromImport(book, allText);
+                    : await architect.generateFoundationFromImport(book, foundationSource);
                 await architect.writeFoundationFiles(bookDir, foundation, gp.numericalSystem, resolvedLanguage);
                 await this.resetImportReplayTruthFiles(bookDir, resolvedLanguage);
                 await this.state.saveChapterIndex(input.bookId, []);
                 await this.state.snapshotState(input.bookId, 0);
                 // Generate style guide from imported chapters
-                if (allText.length >= 500) {
+                if (foundationSource.length >= 500) {
                     log?.info(this.localize(resolvedLanguage, {
                         zh: "提取原文风格指纹...",
                         en: "Extracting source style fingerprint...",
                     }));
-                    await this.tryGenerateStyleGuide(input.bookId, allText, book.title, resolvedLanguage);
+                    await this.tryGenerateStyleGuide(input.bookId, foundationSource, book.title, resolvedLanguage);
                 }
                 log?.info(this.localize(resolvedLanguage, {
                     zh: "基础设定已生成。",
@@ -1868,9 +2139,10 @@ ${matrix}`,
         const { plan, composed } = await this.createGovernedArtifacts(book, bookDir, chapterNumber, externalContext, { reuseExistingIntentWhenContextMissing: true });
         return {
             chapterIntent: plan.intentMarkdown,
+            chapterMemo: plan.memo,
+            chapterIntentData: plan.intent,
             contextPackage: composed.contextPackage,
             ruleStack: composed.ruleStack,
-            trace: composed.trace,
         };
     }
     async resetImportReplayTruthFiles(bookDir, language) {
@@ -2367,8 +2639,7 @@ ${matrix}`,
     }
     async createGovernedArtifacts(book, bookDir, chapterNumber, externalContext, options) {
         const plan = await this.resolveGovernedPlan(book, bookDir, chapterNumber, externalContext, options);
-        const composer = new ComposerAgent(this.agentCtxFor("composer", book.id));
-        const composed = await composer.composeChapter({
+        const composed = await composeGovernedChapter({
             book,
             bookDir,
             chapterNumber,
@@ -2384,12 +2655,16 @@ ${matrix}`,
                 return persisted;
         }
         const planner = new PlannerAgent(this.agentCtxFor("planner", book.id));
-        return planner.planChapter({
+        const plan = await planner.planChapter({
             book,
             bookDir,
             chapterNumber,
             externalContext,
         });
+        // Persist in the new memo format so subsequent compose/write phases can
+        // skip the planner LLM call when no new context is supplied.
+        await savePersistedPlan(bookDir, plan);
+        return plan;
     }
     async emitWebhook(event, bookId, chapterNumber, data) {
         if (!this.config.notifyChannels || this.config.notifyChannels.length === 0)