@kienmatu/inkos-core 0.1.0

package/dist/agents/reviser.js

@@ -0,0 +1,496 @@
+import { BaseAgent } from "./base.js";
+import { readGenreProfile, readBookLanguage, readBookRules } from "./rules-reader.js";
+import { countChapterLength } from "../utils/length-metrics.js";
+import { buildGovernedMemoryEvidenceBlocks } from "../utils/governed-context.js";
+import { filterSummaries } from "../utils/context-filter.js";
+import { buildGovernedCharacterMatrixWorkingSet, buildGovernedHookWorkingSet, } from "../utils/governed-working-set.js";
+import { applySpotFixPatches, parseSpotFixPatches } from "../utils/spot-fix-patches.js";
+import { buildNarrativeIntentBrief, renderMemoAsNarrativeBlock, renderNarrativeSelectedContext, sanitizeNarrativeEvidenceBlock, } from "../utils/narrative-control.js";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { readStoryFrame, readVolumeMap, readCharacterContext, readCurrentStateWithFallback, } from "../utils/outline-paths.js";
+export const DEFAULT_REVISE_MODE = "auto";
+function buildTieredIssueList(issues, isEnglish) {
+    const critical = [];
+    const high = [];
+    const medium = [];
+    for (const issue of issues) {
+        const line = `- ${issue.category}: ${issue.description}`;
+        if (issue.severity === "critical") {
+            critical.push(line);
+        }
+        else if (issue.severity === "warning") {
+            high.push(line);
+        }
+        else {
+            medium.push(line);
+        }
+    }
+    const parts = [];
+    if (critical.length > 0) {
+        parts.push(isEnglish
+            ? `## Critical — Must Fix\n${critical.join("\n")}`
+            : `## Critical（必须解决）\n${critical.join("\n")}`);
+    }
+    if (high.length > 0) {
+        parts.push(isEnglish
+            ? `## High — Should Improve\n${high.join("\n")}`
+            : `## High（应当改善）\n${high.join("\n")}`);
+    }
+    if (medium.length > 0) {
+        parts.push(isEnglish
+            ? `## Medium — Reference\n${medium.join("\n")}`
+            : `## Medium（参考建议）\n${medium.join("\n")}`);
+    }
+    return parts.join("\n\n");
+}
+const MODE_DESCRIPTIONS = {
+    auto: "", // auto mode uses buildAutoSystemPrompt instead
+    polish: "润色：只改表达、节奏、段落呼吸，不改事实与剧情结论。禁止：增删段落、改变人名/地名/物品名、增加新情节或新对话、改变因果关系。只允许：替换用词、调整句序、修改标点节奏",
+    rewrite: "改写：允许重组问题段落、调整画面和叙述力度，但优先保留原文的绝大部分句段。除非问题跨越整章，否则禁止整章推倒重写；只能围绕问题段落及其直接上下文改写，同时保留核心事实与人物动机",
+    rework: "重写：可重构场景推进和冲突组织，但不改主设定和大事件结果",
+    "anti-detect": `反检测改写：在保持剧情不变的前提下，降低AI生成可检测性。
+
+改写手法（附正例）：
+1. 打破句式规律：连续短句 → 长短交替，句式不可预测
+2. 口语化替代：✗"然而事情并没有那么简单" → ✓"哪有那么便宜的事"
+3. 减少"了"字密度：✗"他走了过去，拿了杯子" → ✓"他走过去，端起杯子"
+4. 转折词降频：✗"虽然…但是…" → ✓ 用角色内心吐槽或直接动作切换
+5. 情绪外化：✗"他感到愤怒" → ✓"他捏碎了茶杯，滚烫的茶水流过指缝"
+6. 删掉叙述者结论：✗"这一刻他终于明白了力量" → ✓ 只写行动，让读者自己感受
+7. 群像反应具体化：✗"全场震惊" → ✓"老陈的烟掉在裤子上，烫得他跳起来"
+8. 段落长度差异化：不再等长段落，有的段只有一句话，有的段七八行
+9. 消灭"不禁""仿佛""宛如"等AI标记词：换成具体感官描写`,
+    "spot-fix": "定点修复：只修改审稿意见指出的具体句子或段落，其余所有内容必须原封不动保留。修改范围限定在问题句子及其前后各一句。禁止改动无关段落",
+};
+export class ReviserAgent extends BaseAgent {
+    get name() {
+        return "reviser";
+    }
+    async reviseChapter(bookDir, chapterContent, chapterNumber, issues, mode = DEFAULT_REVISE_MODE, genre, options) {
+        const baselineStoryDir = options?.baselineChapter === undefined
+            ? join(bookDir, "story")
+            : join(bookDir, "story", "snapshots", String(options.baselineChapter));
+        const [currentState, ledger, hooks, styleGuideRaw, volumeOutline, storyBible, characterMatrix, chapterSummaries, parentCanon, fanficCanon] = await Promise.all([
+            options?.baselineChapter === undefined
+                ? readCurrentStateWithFallback(bookDir, "(文件不存在)")
+                : this.readFileSafe(join(baselineStoryDir, "current_state.md")),
+            this.readFileSafe(join(baselineStoryDir, "particle_ledger.md")),
+            this.readFileSafe(join(baselineStoryDir, "pending_hooks.md")),
+            this.readFileSafe(join(bookDir, "story/style_guide.md")),
+            readVolumeMap(bookDir, "(文件不存在)"),
+            readStoryFrame(bookDir, "(文件不存在)"),
+            options?.baselineChapter === undefined
+                ? readCharacterContext(bookDir, "(文件不存在)")
+                : this.readSnapshotCharacterContext(bookDir, baselineStoryDir),
+            this.readFileSafe(join(baselineStoryDir, "chapter_summaries.md")),
+            this.readFileSafe(join(bookDir, "story/parent_canon.md")),
+            this.readFileSafe(join(bookDir, "story/fanfic_canon.md")),
+        ]);
+        // Load genre profile and book rules
+        const genreId = genre ?? "other";
+        const [{ profile: gp }, bookLanguage] = await Promise.all([
+            readGenreProfile(this.ctx.projectRoot, genreId),
+            readBookLanguage(bookDir),
+        ]);
+        const parsedRules = await readBookRules(bookDir);
+        const bookRules = parsedRules?.rules ?? null;
+        // Fallback: use book_rules body when style_guide.md doesn't exist.
+        // Phase 5 hotfix 2: parsedRules.body is only populated for legacy
+        // book_rules.md sources — story_frame.md frontmatter yields an empty
+        // body, and an empty string is NOT a usable style guide. Treat
+        // missing/empty body as "no fallback available".
+        const legacyRulesBody = parsedRules?.body?.trim();
+        const styleGuide = styleGuideRaw !== "(文件不存在)"
+            ? styleGuideRaw
+            : (legacyRulesBody || "(无文风指南)");
+        const isEnglish = (bookLanguage ?? gp.language) === "en";
+        const resolvedLanguage = isEnglish ? "en" : "zh";
+        const issueList = mode === "auto"
+            ? buildTieredIssueList(issues, isEnglish)
+            : issues
+                .map((i) => `- [${i.severity}] ${i.category}: ${i.description}\n  ${isEnglish ? "Suggestion" : "建议"}: ${i.suggestion}`)
+                .join("\n");
+        const numericalRule = gp.numericalSystem
+            ? (isEnglish
+                ? "\n3. Numerical errors must be fixed precisely — cross-check before and after"
+                : "\n3. 数值错误必须精确修正，前后对账")
+            : "";
+        const protagonistBlock = bookRules?.protagonist
+            ? (isEnglish
+                ? `\n\nProtagonist lock: ${bookRules.protagonist.name} — ${bookRules.protagonist.personalityLock.join(", ")}. Revisions must not violate the protagonist profile.`
+                : `\n\n主角人设锁定：${bookRules.protagonist.name}，${bookRules.protagonist.personalityLock.join("、")}。修改不得违反人设。`)
+            : "";
+        // Length guardrail only used by legacy modes (manual CLI revise).
+        // Auto mode delegates length to normalize, not reviser.
+        const lengthGuardrail = mode !== "auto" && options?.lengthSpec
+            ? (isEnglish
+                ? "\n8. Keep the chapter word count within the target range; only allow minor deviation when fixing critical issues truly requires it"
+                : "\n8. 保持章节字数在目标区间内；只有在修复关键问题确实需要时才允许轻微偏离")
+            : "";
+        const langPrefix = isEnglish
+            ? `【LANGUAGE OVERRIDE】ALL output (FIXED_ISSUES, PATCHES, REVISED_CONTENT) MUST be in English.\n\n`
+            : "";
+        const governedMode = Boolean(options?.chapterIntent && options?.contextPackage && options?.ruleStack);
+        const hooksWorkingSet = governedMode && options?.contextPackage
+            ? buildGovernedHookWorkingSet({
+                hooksMarkdown: hooks,
+                contextPackage: options.contextPackage,
+                chapterNumber,
+                language: resolvedLanguage,
+            })
+            : hooks;
+        const chapterSummariesWorkingSet = governedMode
+            ? filterSummaries(chapterSummaries, chapterNumber)
+            : chapterSummaries;
+        const characterMatrixWorkingSet = governedMode
+            ? buildGovernedCharacterMatrixWorkingSet({
+                matrixMarkdown: characterMatrix,
+                chapterIntent: options?.chapterIntent ?? volumeOutline,
+                contextPackage: options.contextPackage,
+                protagonistName: bookRules?.protagonist?.name,
+            })
+            : characterMatrix;
+        const autoOutputMode = mode === "auto" ? resolveAutoOutputMode(issues) : "allow-full";
+        const systemPromptBase = mode === "auto"
+            ? this.buildAutoSystemPrompt({ langPrefix, gp, protagonistBlock, numericalRule, lengthGuardrail, resolvedLanguage, lengthSpec: options?.lengthSpec, autoOutputMode })
+            : this.buildLegacySystemPrompt({ langPrefix, gp, protagonistBlock, numericalRule, lengthGuardrail, mode, resolvedLanguage });
+        const systemPrompt = await this.withPromptPackGuidance(systemPromptBase, "longform.reviser");
+        const ledgerBlock = gp.numericalSystem
+            ? `\n## 资源账本\n${ledger}`
+            : "";
+        const governedMemoryBlocks = options?.contextPackage
+            ? buildGovernedMemoryEvidenceBlocks(options.contextPackage, resolvedLanguage)
+            : undefined;
+        const hookDebtBlock = governedMemoryBlocks?.hookDebtBlock ?? "";
+        const hooksBlock = governedMemoryBlocks?.hooksBlock
+            ?? `\n## 伏笔池\n${hooksWorkingSet}\n`;
+        const outlineBlock = volumeOutline !== "(文件不存在)"
+            ? `\n## 卷纲\n${volumeOutline}\n`
+            : "";
+        const bibleBlock = !governedMode && storyBible !== "(文件不存在)"
+            ? `\n## 世界观设定\n${storyBible}\n`
+            : "";
+        const matrixBlock = characterMatrixWorkingSet !== "(文件不存在)"
+            ? `\n## 角色交互矩阵\n${characterMatrixWorkingSet}\n`
+            : "";
+        const summariesBlock = governedMemoryBlocks?.summariesBlock
+            ?? (chapterSummariesWorkingSet !== "(文件不存在)"
+                ? `\n## 章节摘要\n${chapterSummariesWorkingSet}\n`
+                : "");
+        const volumeSummariesBlock = governedMemoryBlocks?.volumeSummariesBlock ?? "";
+        const hasParentCanon = parentCanon !== "(文件不存在)";
+        const hasFanficCanon = fanficCanon !== "(文件不存在)";
+        const canonBlock = hasParentCanon
+            ? `\n## 正传正典参照（修稿专用）\n本书为番外作品。修改时参照正典约束，不可改变正典事实。\n${parentCanon}\n`
+            : "";
+        const fanficCanonBlock = hasFanficCanon
+            ? `\n## 同人正典参照（修稿专用）\n本书为同人作品。修改时参照正典角色档案和世界规则，不可违反正典事实。角色对话必须保留原作语癖。\n${fanficCanon}\n`
+            : "";
+        const reducedControlBlock = options?.contextPackage && options.ruleStack
+            ? this.buildReducedControlBlock(options.chapterMemo, options.chapterIntentData, options.chapterIntent, options.contextPackage, options.ruleStack)
+            : "";
+        // Length guardrail only in legacy modes — auto mode delegates length to normalize.
+        const lengthGuidanceBlock = mode !== "auto" && options?.lengthSpec
+            ? `\n## 字数护栏\n目标字数：${options.lengthSpec.target}\n允许区间：${options.lengthSpec.softMin}-${options.lengthSpec.softMax}\n极限区间：${options.lengthSpec.hardMin}-${options.lengthSpec.hardMax}\n如果修正后超出允许区间，请优先压缩冗余解释、重复动作和弱信息句，不得新增支线或删掉核心事实。\n`
+            : "";
+        const styleGuideBlock = reducedControlBlock.length === 0
+            ? `\n## 文风指南\n${styleGuide}`
+            : "";
+        const userPrompt = `请修正第${chapterNumber}章。
+
+## 审稿问题
+${issueList}
+
+## 当前状态卡
+${currentState}
+${ledgerBlock}
+${sanitizeNarrativeEvidenceBlock(hookDebtBlock, resolvedLanguage) ?? ""}${sanitizeNarrativeEvidenceBlock(hooksBlock, resolvedLanguage) ?? ""}${sanitizeNarrativeEvidenceBlock(volumeSummariesBlock, resolvedLanguage) ?? ""}${reducedControlBlock || outlineBlock}${bibleBlock}${matrixBlock}${sanitizeNarrativeEvidenceBlock(summariesBlock, resolvedLanguage) ?? ""}${canonBlock}${fanficCanonBlock}${styleGuideBlock}${lengthGuidanceBlock}
+
+## 待修正章节
+${chapterContent}`;
+        const response = await this.chat([
+            { role: "system", content: systemPrompt },
+            { role: "user", content: userPrompt },
+        ], { temperature: 0.3 });
+        const output = this.parseOutput(response.content, mode, chapterContent, autoOutputMode);
+        const wordCount = options?.lengthSpec
+            ? countChapterLength(output.revisedContent, options.lengthSpec.countingMode)
+            : output.wordCount;
+        return { ...output, wordCount, tokenUsage: response.usage };
+    }
+    parseOutput(content, mode, originalChapter, autoOutputMode = "allow-full") {
+        const extract = (tag) => {
+            const regex = new RegExp(`=== ${tag} ===\\s*([\\s\\S]*?)(?==== [A-Z_]+ ===|$)`);
+            const match = content.match(regex);
+            return match?.[1]?.trim() ?? "";
+        };
+        const fixedRaw = extract("FIXED_ISSUES");
+        const fixedIssues = fixedRaw
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0);
+        const makeResult = (revisedContent, applied) => ({
+            revisedContent,
+            wordCount: revisedContent.length,
+            fixedIssues: applied ? fixedIssues : [],
+        });
+        // Auto mode obeys the auditor's structured repair scope. It never infers
+        // semantic intent from issue prose.
+        if (mode === "auto") {
+            if (autoOutputMode === "patch-only") {
+                const patchesRaw = extract("PATCHES");
+                if (patchesRaw) {
+                    const patches = parseSpotFixPatches(patchesRaw);
+                    if (patches.length > 0) {
+                        const patchResult = applySpotFixPatches(originalChapter, patches);
+                        if (patchResult.applied && patchResult.appliedPatchCount / patches.length >= 0.5) {
+                            return makeResult(patchResult.revisedContent, true);
+                        }
+                    }
+                }
+                return makeResult(originalChapter, false);
+            }
+            if (autoOutputMode === "rewrite-only") {
+                const revisedContent = extract("REVISED_CONTENT");
+                if (revisedContent) {
+                    return makeResult(revisedContent, true);
+                }
+                // No rewrite produced — don't fall back to patches; structural issues
+                // cannot be safely patched. Return original unchanged.
+                return makeResult(originalChapter, false);
+            }
+            const revisedContent = extract("REVISED_CONTENT");
+            if (revisedContent) {
+                return makeResult(revisedContent, true);
+            }
+            const patchesRaw = extract("PATCHES");
+            if (patchesRaw) {
+                const patches = parseSpotFixPatches(patchesRaw);
+                if (patches.length > 0) {
+                    const patchResult = applySpotFixPatches(originalChapter, patches);
+                    if (patchResult.applied && patchResult.appliedPatchCount / patches.length >= 0.5) {
+                        return makeResult(patchResult.revisedContent, true);
+                    }
+                }
+            }
+            // Both empty — no fix
+            return makeResult(originalChapter, false);
+        }
+        // Legacy spot-fix mode: patches only
+        if (mode === "spot-fix") {
+            const patches = parseSpotFixPatches(extract("PATCHES"));
+            const patchResult = applySpotFixPatches(originalChapter, patches);
+            return makeResult(patchResult.revisedContent, patchResult.applied);
+        }
+        // Legacy rewrite/polish/rework/anti-detect: full content
+        const revisedContent = extract("REVISED_CONTENT");
+        return makeResult(revisedContent || originalChapter, revisedContent.length > 0);
+    }
+    buildAutoSystemPrompt(params) {
+        const { langPrefix, gp, protagonistBlock, numericalRule, resolvedLanguage, lengthSpec, autoOutputMode } = params;
+        // lengthGuardrail intentionally not used in auto mode — length constraint is embedded in REVISED_CONTENT description
+        const en = resolvedLanguage === "en";
+        const rewriteLengthConstraint = lengthSpec
+            ? (en
+                ? `\n  HARD CONSTRAINT: The revised chapter must stay within ${lengthSpec.softMin}-${lengthSpec.softMax} characters (target: ${lengthSpec.target}, ±25%). This is non-negotiable — do not exceed this range.`
+                : `\n  硬性约束：重写后的章节必须控制在 ${lengthSpec.softMin}-${lengthSpec.softMax} 字以内（目标 ${lengthSpec.target} 字，±25%）。这是不可突破的底线。`)
+            : "";
+        const routingDirectiveEn = autoOutputMode === "rewrite-only"
+            ? "\n\nROUTING: The reviewer's blocking issues are structural / semantic (character collapse, mainline drift, missing payoff, timeline break, unpaid hook, memo drift, etc.). You MUST output REVISED_CONTENT — do not emit PATCHES, they cannot fix this class of problem. If you cannot safely rewrite, say so in FIXED_ISSUES and leave REVISED_CONTENT empty."
+            : autoOutputMode === "patch-only"
+                ? "\n\nROUTING: The reviewer's blocking issues are local (wording, paragraph shape, fatigue word, information boundary, knowledge pollution). You MUST output PATCHES only — do not rewrite the whole chapter. If patches are not possible, leave PATCHES empty."
+                : "";
+        const routingDirectiveZh = autoOutputMode === "rewrite-only"
+            ? "\n\n分流指令：reviewer 报告的阻塞问题属于结构/语义错（人设崩、主线偏、爽点缺、时间线错、伏笔未收、memo 偏离等）。你必须输出 REVISED_CONTENT——禁止输出 PATCHES，这类问题不能靠补丁修复。如果无法安全重写，在 FIXED_ISSUES 里说明并留空 REVISED_CONTENT。"
+            : autoOutputMode === "patch-only"
+                ? "\n\n分流指令：reviewer 报告的阻塞问题属于局部错（措辞、段落形状、疲劳词、信息越界、知识污染）。你必须只输出 PATCHES——不要整章改写。如果做不出补丁，留空 PATCHES。"
+                : "";
+        return en
+            ? `${langPrefix}You are a professional ${gp.name} web-fiction revision editor. Fix the chapter according to the review notes.${protagonistBlock}${routingDirectiveEn}
+
+PATCHES and REVISED_CONTENT serve different problems — choose by problem type, not preference:
+
+PATCHES — for local text issues (wording, dialogue, AI-tell phrases, small continuity errors).
+  Each PATCH quotes the passage to change (a sentence, a paragraph, or multiple paragraphs) and provides a replacement. Untouched text stays exactly as-is.
+
+REVISED_CONTENT — for whole-chapter issues (length compression, structural rewrite, pacing restructure, major plot realignment).
+  Outputs the full revised chapter. When Critical issues include length or structural problems, you must use REVISED_CONTENT — patches cannot compress or restructure a chapter.${rewriteLengthConstraint}
+
+If Critical issues include both local and whole-chapter problems, use REVISED_CONTENT (it addresses everything in one pass).
+
+Revision principles:
+1. Fix root causes — do not apply superficial polish${numericalRule}
+2. Hook status must stay in sync with the hooks board. If hook debt briefs are provided, preserve hook payoff scenes
+3. Do not alter the plot direction or core conflicts
+4. Preserve the original language style, rhythm, and pacing — do not compress transitional scenes or remove breathing room
+5. Emotion through action (never "he felt angry" — show it). Values through behavior, not slogans
+6. Different characters speak differently. No "everyone gasped in unison"
+7. Escalate: bad things stack, each worse than the last
+
+Cycle-aware revision:
+- If this chapter should be "aftermath" but is still escalating tension, rewrite the densest conflict passage into a change-showing passage — who lost what, whose attitude shifted, what the new normal is
+- If this chapter should be "climax" but has no clear payoff, find the closest scene to a reward and amplify it — make the promised release exceed reader expectations
+- Daily passages that don't serve the main line: rewrite as "bait" — add a detail pointing to the future, a hint, a character reaction that seeds curiosity
+
+Output format:
+
+=== FIXED_ISSUES ===
+(List each fix on its own line; if a safe local fix is not possible, explain here)
+
+=== PATCHES ===
+(Output local patches if applicable. Omit this section entirely if using REVISED_CONTENT)
+--- PATCH 1 ---
+TARGET_TEXT:
+(Exact quote from the original that identifies the passage to change)
+REPLACEMENT_TEXT:
+(Replacement text for this passage)
+--- END PATCH ---
+
+=== REVISED_CONTENT ===
+(Full revised chapter content — only when PATCHES cannot solve the problem. Omit this section if using PATCHES)`
+            : `${langPrefix}你是一位专业的${gp.name}网络小说修稿编辑。你的任务是根据审稿意见对章节进行修正。${protagonistBlock}${routingDirectiveZh}
+
+PATCHES 和 REVISED_CONTENT 分别处理不同类型的问题——按问题类型选择，不是按偏好：
+
+PATCHES——处理局部文字问题（措辞、对话、AI痕迹、小的连续性错误）。
+  每个 PATCH 引用要修改的原文段落（一句、一段或多段皆可），给出替换文本。未涉及的内容保持原样。
+
+REVISED_CONTENT——处理全章级问题（字数压缩、结构重组、节奏重排、重大剧情偏离）。
+  输出修正后的完整正文。当 Critical 问题包含字数或结构性问题时，必须使用 REVISED_CONTENT——PATCHES 无法压缩或重构整章。${rewriteLengthConstraint}
+
+如果 Critical 同时包含局部问题和全章问题，使用 REVISED_CONTENT（一次性解决所有问题）。
+
+修稿原则：
+1. 修根因，不做表面润色${numericalRule}
+2. 伏笔状态必须与伏笔池同步。如果提供了 Hook Debt 简报，必须保留伏笔兑现段落
+3. 不改变剧情走向和核心冲突
+4. 保持原文的语言风格、节奏和呼吸——不要压缩过渡段、不要删掉减速段
+5. 情绪用动作外化（不写"他感到愤怒"，写动作）。价值观通过行为传达
+6. 不同角色说话方式必须不同。禁止"众人齐声惊呼"
+7. 坏事叠坏事，每层比上一层过分
+
+小目标周期修稿指引：
+- 如果本章应该是"后效"阶段但仍在加压，把最密集的冲突段落改写为展示改变的段落——谁失去了什么、谁的态度变了、新的常态是什么
+- 如果本章应该是"爆发"阶段但没有明确兑现，找到最接近回报的场景并放大它——让承诺的释放超过读者预期
+- 日常段落如果不服务主线，改写为"饵"：加入一个指向未来的细节、一句暗示、一个角色反应
+
+输出格式：
+
+=== FIXED_ISSUES ===
+(逐条说明修正了什么)
+
+=== PATCHES ===
+(局部补丁——仅用于局部文字问题。有全章级问题时省略此区块)
+--- PATCH 1 ---
+TARGET_TEXT:
+(从原文中精确引用要修改的段落)
+REPLACEMENT_TEXT:
+(替换后的文本)
+--- END PATCH ---
+
+=== REVISED_CONTENT ===
+(修正后的完整正文——用于字数/结构/节奏等全章级问题。仅局部问题时省略此区块)`;
+    }
+    buildLegacySystemPrompt(params) {
+        const { langPrefix, gp, protagonistBlock, numericalRule, lengthGuardrail, mode } = params;
+        const modeDesc = MODE_DESCRIPTIONS[mode];
+        const outputFormat = mode === "spot-fix"
+            ? `=== FIXED_ISSUES ===
+(逐条说明修正了什么，一行一条；如果无法安全定点修复，也在这里说明)
+
+=== PATCHES ===
+--- PATCH 1 ---
+TARGET_TEXT:
+(必须从原文中精确复制、且能唯一命中的原句或原段)
+REPLACEMENT_TEXT:
+(替换后的局部文本)
+--- END PATCH ---`
+            : `=== FIXED_ISSUES ===
+(逐条说明修正了什么，一行一条)
+
+=== REVISED_CONTENT ===
+(修正后的完整正文)`;
+        return `${langPrefix}你是一位专业的${gp.name}网络小说修稿编辑。你的任务是根据审稿意见对章节进行修正。${protagonistBlock}
+
+修稿模式：${modeDesc}
+
+修稿原则：
+1. 按模式控制修改幅度
+2. 修根因，不做表面润色${numericalRule}
+4. 正文必须服从既有事实和伏笔约束，但不要输出或重写状态文件；宿主会根据修订正文重新结算
+5. 不改变剧情走向和核心冲突
+6. 保持原文的语言风格和节奏
+${lengthGuardrail}
+${mode === "spot-fix" ? "\n9. spot-fix 只能输出局部补丁，禁止输出整章改写；TARGET_TEXT 必须能在原文中唯一命中\n10. 如果需要大面积改写，说明无法安全 spot-fix，并让 PATCHES 留空" : ""}
+
+输出格式：
+
+${outputFormat}`;
+    }
+    async readFileSafe(path) {
+        try {
+            return await readFile(path, "utf-8");
+        }
+        catch {
+            return "(文件不存在)";
+        }
+    }
+    async readSnapshotCharacterContext(bookDir, snapshotStoryDir) {
+        const snapshotMatrix = await this.readFileSafe(join(snapshotStoryDir, "character_matrix.md"));
+        if (snapshotMatrix !== "(文件不存在)")
+            return snapshotMatrix;
+        return readCharacterContext(bookDir, "(文件不存在)");
+    }
+    buildReducedControlBlock(memo, intent, chapterIntent, contextPackage, ruleStack) {
+        const selectedContext = renderNarrativeSelectedContext(contextPackage.selectedContext, "zh")
+            .replace(/^### /gm, "- ");
+        const overrides = ruleStack.activeOverrides.length > 0
+            ? ruleStack.activeOverrides
+                .map((override) => `- ${override.from} -> ${override.to}: ${override.reason} (${override.target})`)
+                .join("\n")
+            : "- none";
+        // Prefer memo-based narrative block; fall back to legacy intent markdown
+        const narrativeBlock = memo
+            ? renderMemoAsNarrativeBlock(memo, intent, "zh")
+            : chapterIntent
+                ? buildNarrativeIntentBrief(chapterIntent, "zh")
+                : "(无)";
+        return `\n## 本章控制输入（由 Planner/Composer 编译）
+${narrativeBlock}
+
+### 已选上下文
+${selectedContext || "- none"}
+
+### 规则栈
+- 硬护栏：${ruleStack.sections.hard.join("、") || "(无)"}
+- 软约束：${ruleStack.sections.soft.join("、") || "(无)"}
+- 诊断规则：${ruleStack.sections.diagnostic.join("、") || "(无)"}
+
+### 当前覆盖
+${overrides}\n`;
+    }
+}
+function resolveAutoOutputMode(issues) {
+    if (issues.length === 0) {
+        return "allow-full";
+    }
+    const scopedBlocking = issues.filter((issue) => issue.severity !== "info" && issue.repairScope);
+    if (scopedBlocking.length > 0) {
+        if (scopedBlocking.some((issue) => issue.repairScope === "structural")) {
+            return "rewrite-only";
+        }
+        if (scopedBlocking.length === issues.filter((issue) => issue.severity !== "info").length
+            && scopedBlocking.every((issue) => issue.repairScope === "local")) {
+            return "patch-only";
+        }
+    }
+    const blocking = issues.filter((issue) => issue.severity !== "info");
+    if (blocking.length === 0) {
+        return "patch-only"; // only hints / info — at most local polish
+    }
+    // Unknown scope is intentionally not guessed from natural-language labels.
+    // The reviser may choose the safest representation from the actual issue text.
+    return "allow-full";
+}
+//# sourceMappingURL=reviser.js.map

package/dist/agents/reviser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviser.js","sourceRoot":"","sources":["../../src/agents/reviser.ts"],"names":[],"mappings":"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"}

package/dist/agents/rules-reader.d.ts

@@ -0,0 +1,32 @@
+import { type ParsedGenreProfile } from "../models/genre-profile.js";
+import { type ParsedBookRules } from "../models/book-rules.js";
+/**
+ * Load genre profile. Lookup order:
+ * 1. Project-level: {projectRoot}/genres/{genreId}.md
+ * 2. Built-in:     packages/core/genres/{genreId}.md
+ * 3. Fallback:     built-in other.md
+ */
+export declare function readGenreProfile(projectRoot: string, genreId: string): Promise<ParsedGenreProfile>;
+/**
+ * List all available genre profiles (project-level + built-in, deduped).
+ * Returns array of { id, name, source }.
+ */
+export declare function listAvailableGenres(projectRoot: string): Promise<ReadonlyArray<{
+    readonly id: string;
+    readonly name: string;
+    readonly source: "project" | "builtin";
+}>>;
+/** Return the path to the built-in genres directory. */
+export declare function getBuiltinGenresDir(): string;
+/**
+ * Load structured book rules.
+ *
+ * New books keep the authoritative rules in story/book_rules.md as ordinary
+ * Markdown; parseBookRules() extracts the small structured surface the runtime
+ * needs and preserves the Markdown as body. Older Phase 5 books may still have
+ * YAML frontmatter on outline/story_frame.md with book_rules.md as a shim; that
+ * path is legacy fallback only.
+ */
+export declare function readBookRules(bookDir: string): Promise<ParsedBookRules | null>;
+export declare function readBookLanguage(bookDir: string): Promise<"zh" | "en" | undefined>;
+//# sourceMappingURL=rules-reader.d.ts.map

package/dist/agents/rules-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-reader.d.ts","sourceRoot":"","sources":["../../src/agents/rules-reader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACxF,OAAO,EAAgD,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAa7G;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAe7B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC,CAAC,CA+BhH;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkCpF;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAUxF"}