@kienmatu/inkos-core 0.1.0

package/dist/agents/state-validator.js

@@ -0,0 +1,262 @@
+import { BaseAgent } from "./base.js";
+/**
+ * Validates Settler output by comparing old and new truth files via LLM.
+ * Catches contradictions, missing state changes, and temporal inconsistencies.
+ *
+ * Uses a minimal verdict protocol instead of requiring structured JSON:
+ *   Line 1: PASS, REPAIR, or FAIL
+ *   Remaining lines: free-form warnings (one per line, optional category prefix)
+ */
+export class StateValidatorAgent extends BaseAgent {
+    get name() {
+        return "state-validator";
+    }
+    async validate(chapterContent, chapterNumber, oldState, newState, oldHooks, newHooks, language = "zh", authorityContext) {
+        const stateDiff = this.computeDiff(oldState, newState, "State Card");
+        const hooksDiff = this.computeDiff(oldHooks, newHooks, "Hooks Pool");
+        // Skip validation if nothing changed
+        if (!stateDiff && !hooksDiff) {
+            return { warnings: [], passed: true, repairRequired: false };
+        }
+        const langInstruction = language === "en"
+            ? "Respond in English."
+            : "用中文回答。";
+        const systemPrompt = `You are a continuity validator for a novel writing system. ${langInstruction}
+
+Given the chapter text and the CHANGES made to truth files (state card + hooks pool), check for contradictions:
+
+1. State change without narrative support — truth file says something changed but the chapter text doesn't describe it
+2. Missing state change — chapter text describes something happening but the truth file didn't capture it
+3. Temporal impossibility — character moves locations without transition, injury heals without time passing
+4. Hook anomaly — a hook disappeared without being marked resolved, or a new hook has no basis in the chapter
+5. Retroactive edit — truth file change implies something happened in a PREVIOUS chapter, not the current one
+6. Cross-truth key-setting conflict — numbered rules, named laws, ranks, identities, locations, or relationship labels in the new truth files contradict the chapter text or the authority context
+
+Output format (simple, NOT JSON):
+- First line: exactly PASS, REPAIR, or FAIL (nothing else on this line)
+- Following lines: one warning per line, optionally prefixed with [category]
+- If no issues at all, just output: PASS
+
+Verdict semantics:
+- PASS: the truth-file projection is complete enough and consistent with the chapter.
+- REPAIR: the chapter itself is valid, but a state change or hook transition is missing, stale, or incomplete. The host will regenerate only the truth-file settlement.
+- FAIL: the proposed truth-file changes directly contradict the chapter or authority context.
+
+Example:
+PASS
+[unsupported_change] State card says character moved to the forest, but text only shows intent
+[minor] Hook H03 advanced but text mention is brief
+
+If the chapter establishes a state change that the truth files missed:
+REPAIR
+[missing_state_update] The chapter moves Lin to the harbor, but the state card still says station
+
+Or if there are hard contradictions:
+FAIL
+[contradiction] State says character is dead but chapter text shows them speaking
+[unsupported_change] New location not mentioned anywhere in chapter text
+
+IMPORTANT: Output FAIL ONLY for hard contradictions — facts that directly conflict with the chapter text. Output REPAIR for missing state updates and hook-management omissions that should be regenerated. Do NOT fail for:
+- Slightly ahead-of-text inferences
+- Reasonable extrapolations from text
+Minor details that do not affect ongoing continuity may remain warnings with PASS.`;
+        const authorityBlock = this.buildAuthorityContextBlock(authorityContext);
+        const userPrompt = `Chapter ${chapterNumber} validation:
+
+${authorityBlock}
+
+## State Card Changes
+${stateDiff || "(no changes)"}
+
+## Hooks Pool Changes
+${hooksDiff || "(no changes)"}
+
+## Chapter Text (for reference)
+${chapterContent}`;
+        try {
+            const response = await this.chat([
+                { role: "system", content: systemPrompt },
+                { role: "user", content: userPrompt },
+            ], { temperature: 0.1 });
+            return this.parseResult(response.content);
+        }
+        catch (error) {
+            this.log?.warn(`State validation failed: ${error}`);
+            throw error;
+        }
+    }
+    computeDiff(oldText, newText, label) {
+        if (oldText === newText)
+            return null;
+        const oldLines = oldText.split("\n").filter((l) => l.trim());
+        const newLines = newText.split("\n").filter((l) => l.trim());
+        const added = newLines.filter((l) => !oldLines.includes(l));
+        const removed = oldLines.filter((l) => !newLines.includes(l));
+        if (added.length === 0 && removed.length === 0)
+            return null;
+        const parts = [`### ${label}`];
+        if (removed.length > 0)
+            parts.push("Removed:\n" + removed.map((l) => `- ${l}`).join("\n"));
+        if (added.length > 0)
+            parts.push("Added:\n" + added.map((l) => `+ ${l}`).join("\n"));
+        return parts.join("\n");
+    }
+    buildAuthorityContextBlock(authorityContext) {
+        if (!authorityContext)
+            return "## Authority / Cross-Truth Context\n(no authority context provided)";
+        const storyFrame = (authorityContext.storyFrame ?? "").trim();
+        const bookRules = (authorityContext.bookRules ?? "").trim();
+        const chapterSummaries = (authorityContext.chapterSummaries ?? "").trim();
+        return [
+            "## Authority / Cross-Truth Context",
+            "Authority priority: current chapter text > runtime truth files/current summaries > story_frame/book_rules > legacy story_bible intro or marketing-style prose. If the current chapter establishes a numbered/name mapping, new truth files must follow that mapping instead of preserving an older intro-only version.",
+            "",
+            "### story_frame / legacy story_bible excerpt",
+            storyFrame || "(empty)",
+            "",
+            "### book_rules excerpt",
+            bookRules || "(empty)",
+            "",
+            "### recent chapter_summaries excerpt",
+            chapterSummaries || "(empty)",
+        ].join("\n");
+    }
+    parseResult(content) {
+        const trimmed = content.trim();
+        if (!trimmed) {
+            throw new Error("LLM returned empty response");
+        }
+        const jsonResult = this.tryParseJsonResult(trimmed);
+        if (jsonResult) {
+            return jsonResult;
+        }
+        const lines = trimmed.split("\n").map((line) => line.trim()).filter(Boolean);
+        if (lines.length === 0) {
+            throw new Error("LLM returned empty response");
+        }
+        const verdictLine = lines[0];
+        if (!/^(PASS|REPAIR|FAIL)$/i.test(verdictLine)) {
+            throw new Error("State validator returned invalid response");
+        }
+        const passed = /^PASS$/i.test(verdictLine);
+        const repairRequired = /^REPAIR$/i.test(verdictLine);
+        const warnings = [];
+        for (let i = 1; i < lines.length; i++) {
+            const line = lines[i];
+            if (/^(PASS|REPAIR|FAIL)$/i.test(line))
+                continue;
+            const categoryMatch = line.match(/^\[([^\]]+)\]\s*(.+)$/);
+            if (categoryMatch) {
+                warnings.push({
+                    category: categoryMatch[1].trim(),
+                    description: categoryMatch[2].trim(),
+                });
+            }
+            else if (line.startsWith("- ") || line.startsWith("* ")) {
+                warnings.push({
+                    category: "general",
+                    description: line.slice(2).trim(),
+                });
+            }
+            else if (line.length > 5) {
+                warnings.push({
+                    category: "general",
+                    description: line,
+                });
+            }
+        }
+        return { warnings, passed, repairRequired };
+    }
+    tryParseJsonResult(text) {
+        const direct = this.tryParseExactJsonResult(text);
+        if (direct) {
+            return direct;
+        }
+        const candidate = extractBalancedJsonObject(text);
+        if (!candidate) {
+            return null;
+        }
+        return this.tryParseExactJsonResult(candidate);
+    }
+    tryParseExactJsonResult(text) {
+        try {
+            const parsed = JSON.parse(text);
+            if (typeof parsed.passed !== "boolean")
+                return null;
+            return {
+                warnings: (parsed.warnings ?? []).map((w) => ({
+                    category: w.category ?? "unknown",
+                    description: w.description ?? "",
+                })),
+                passed: parsed.passed,
+                repairRequired: parsed.repairRequired === true,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function extractBalancedJsonObject(text) {
+    const start = text.indexOf("{");
+    if (start < 0) {
+        return null;
+    }
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    let endIndex = -1;
+    for (let index = start; index < text.length; index += 1) {
+        const char = text[index];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (char === "\\") {
+                escaped = true;
+                continue;
+            }
+            if (char === "\"") {
+                inString = false;
+            }
+            continue;
+        }
+        if (char === "\"") {
+            inString = true;
+            continue;
+        }
+        if (char === "{") {
+            depth += 1;
+            continue;
+        }
+        if (char === "}") {
+            depth -= 1;
+            if (depth === 0) {
+                endIndex = index;
+                break;
+            }
+            if (depth < 0) {
+                return null;
+            }
+        }
+    }
+    if (endIndex < 0)
+        return null;
+    // Only accept the candidate if what follows the closing brace is
+    // nothing, whitespace, or a structural JSON terminator.
+    // This rejects trailing content like "{...} more text here"
+    const followingChar = text[endIndex + 1];
+    if (followingChar !== undefined &&
+        followingChar !== "\n" &&
+        followingChar !== "\r" &&
+        followingChar !== "\t" &&
+        followingChar !== " " &&
+        followingChar !== "," &&
+        followingChar !== "]" &&
+        followingChar !== "}") {
+        return null;
+    }
+    return text.slice(start, endIndex + 1);
+}
+//# sourceMappingURL=state-validator.js.map

package/dist/agents/state-validator.js.map

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

package/dist/agents/style-analyzer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Style fingerprint analysis — pure text analysis (no LLM).
+ * Extracts statistical features from reference text to build a StyleProfile.
+ */
+import type { StyleProfile } from "../models/style-profile.js";
+/**
+ * Analyze a reference text and extract its style profile.
+ * The returned profile can be serialized to style_profile.json.
+ */
+export declare function analyzeStyle(text: string, sourceName?: string, language?: "zh" | "en"): StyleProfile;
+//# sourceMappingURL=style-analyzer.d.ts.map

package/dist/agents/style-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-analyzer.d.ts","sourceRoot":"","sources":["../../src/agents/style-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAoB/D;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,IAAI,GAAG,IAAW,GAC3B,YAAY,CAkFd"}

package/dist/agents/style-analyzer.js

@@ -0,0 +1,98 @@
+/**
+ * Style fingerprint analysis — pure text analysis (no LLM).
+ * Extracts statistical features from reference text to build a StyleProfile.
+ */
+// Common rhetorical patterns in Chinese fiction
+const RHETORICAL_PATTERNS = [
+    { name: "比喻(像/如/仿佛)", regex: /[像如仿佛似](?:是|同|一般|一样)/g },
+    { name: "排比", regex: /[，。；]([^，。；]{2,6})[，。；]\1/g },
+    { name: "反问", regex: /难道|怎么可能|岂不是|何尝不/g },
+    { name: "夸张", regex: /天崩地裂|惊天动地|翻天覆地|震耳欲聋/g },
+    { name: "拟人", regex: /[风雨雪月花树草石](?:在|像|仿佛).*?(?:笑|哭|叹|呻|吟|怒|舞)/g },
+    { name: "短句节奏", regex: /[。！？][^。！？]{1,8}[。！？]/g },
+];
+// Common rhetorical patterns in English fiction
+const EN_RHETORICAL_PATTERNS = [
+    { name: "simile (like/as if)", regex: /\b(?:like a|like an|as if|as though)\b/gi },
+    { name: "rhetorical question", regex: /\b(?:how could|why would|what if|wasn't it|isn't it|could it be)\b[^.!?]*\?/gi },
+    { name: "tricolon", regex: /\b\w+,\s+\w+,\s+and\s+\w+\b/gi },
+    { name: "short punchy rhythm", regex: /[.!?]\s+[A-Z][^.!?]{1,24}[.!?]/g },
+];
+/**
+ * Analyze a reference text and extract its style profile.
+ * The returned profile can be serialized to style_profile.json.
+ */
+export function analyzeStyle(text, sourceName, language = "zh") {
+    const isEn = language === "en";
+    const sentences = text
+        .split(isEn ? /[.!?\n]+/ : /[。！？\n]/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    const paragraphs = text
+        .split(/\n\s*\n/)
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+    // Measure length in the language's native unit: words for English, characters for Chinese.
+    const measure = (s) => isEn ? (s.match(/[A-Za-z0-9]+(?:'[A-Za-z0-9]+)?/g)?.length ?? 0) : s.replace(/\s+/g, "").length;
+    // Sentence length stats
+    const sentenceLengths = sentences.map(measure);
+    const avgSentenceLength = sentenceLengths.length > 0
+        ? sentenceLengths.reduce((a, b) => a + b, 0) / sentenceLengths.length
+        : 0;
+    const sentenceLengthStdDev = sentenceLengths.length > 1
+        ? Math.sqrt(sentenceLengths.reduce((sum, l) => sum + (l - avgSentenceLength) ** 2, 0) /
+            sentenceLengths.length)
+        : 0;
+    // Paragraph length stats
+    const paragraphLengths = paragraphs.map(measure);
+    const avgParagraphLength = paragraphLengths.length > 0
+        ? paragraphLengths.reduce((a, b) => a + b, 0) / paragraphLengths.length
+        : 0;
+    const minParagraph = paragraphLengths.length > 0 ? Math.min(...paragraphLengths) : 0;
+    const maxParagraph = paragraphLengths.length > 0 ? Math.max(...paragraphLengths) : 0;
+    // Vocabulary diversity (TTR — Type-Token Ratio): word-level for English, character-level for Chinese.
+    let vocabularyDiversity;
+    if (isEn) {
+        const words = text.toLowerCase().match(/[a-z0-9]+(?:'[a-z0-9]+)?/g) ?? [];
+        vocabularyDiversity = words.length > 0 ? new Set(words).size / words.length : 0;
+    }
+    else {
+        const chars = text.replace(/[\s\n\r，。！？、：；""''（）【】《》\d]/g, "");
+        vocabularyDiversity = chars.length > 0 ? new Set(chars).size / chars.length : 0;
+    }
+    // Top sentence opening patterns: first word for English, first 2 chars for Chinese.
+    const openingCounts = {};
+    for (const s of sentences) {
+        const key = isEn
+            ? (s.match(/[A-Za-z']+/)?.[0]?.toLowerCase() ?? "")
+            : (s.length >= 2 ? s.slice(0, 2) : "");
+        if (key)
+            openingCounts[key] = (openingCounts[key] ?? 0) + 1;
+    }
+    const topPatterns = Object.entries(openingCounts)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 5)
+        .filter(([, count]) => count >= 3)
+        .map(([pattern, count]) => (isEn ? `${pattern}… (${count})` : `${pattern}...(${count}次)`));
+    // Rhetorical features
+    const rhetoricalPatterns = isEn ? EN_RHETORICAL_PATTERNS : RHETORICAL_PATTERNS;
+    const rhetoricalFeatures = [];
+    for (const { name, regex } of rhetoricalPatterns) {
+        const matches = text.match(regex);
+        if (matches && matches.length >= 2) {
+            rhetoricalFeatures.push(isEn ? `${name} (${matches.length})` : `${name}(${matches.length}处)`);
+        }
+    }
+    return {
+        avgSentenceLength: Math.round(avgSentenceLength * 10) / 10,
+        sentenceLengthStdDev: Math.round(sentenceLengthStdDev * 10) / 10,
+        avgParagraphLength: Math.round(avgParagraphLength),
+        paragraphLengthRange: { min: minParagraph, max: maxParagraph },
+        vocabularyDiversity: Math.round(vocabularyDiversity * 1000) / 1000,
+        topPatterns,
+        rhetoricalFeatures,
+        sourceName,
+        analyzedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=style-analyzer.js.map

package/dist/agents/style-analyzer.js.map

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

package/dist/agents/writer-parser.d.ts

@@ -0,0 +1,17 @@
+import type { GenreProfile } from "../models/genre-profile.js";
+import type { LengthCountingMode } from "../models/length-governance.js";
+import type { WriteChapterOutput } from "./writer.js";
+export interface CreativeOutput {
+    readonly title: string;
+    readonly content: string;
+    readonly wordCount: number;
+    readonly preWriteCheck: string;
+}
+export declare function parseCreativeOutput(chapterNumber: number, content: string, countingMode?: LengthCountingMode): CreativeOutput;
+export type ParsedWriterOutput = Omit<WriteChapterOutput, "postWriteErrors" | "postWriteWarnings">;
+/**
+ * Parse LLM output that uses === TAG === delimiters into structured chapter data.
+ * Shared by WriterAgent (writing new chapters) and ChapterAnalyzerAgent (analyzing existing chapters).
+ */
+export declare function parseWriterOutput(chapterNumber: number, content: string, genreProfile: GenreProfile, countingMode?: LengthCountingMode): ParsedWriterOutput;
+//# sourceMappingURL=writer-parser.d.ts.map

package/dist/agents/writer-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer-parser.d.ts","sourceRoot":"","sources":["../../src/agents/writer-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,kBAA+B,GAC5C,cAAc,CA4BhB;AA2ED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,kBAAkB,EAAE,iBAAiB,GAAG,mBAAmB,CAAC,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,YAAY,GAAE,kBAA+B,GAC5C,kBAAkB,CA4BpB"}

package/dist/agents/writer-parser.js

@@ -0,0 +1,131 @@
+import { countChapterLength } from "../utils/length-metrics.js";
+export function parseCreativeOutput(chapterNumber, content, countingMode = "zh_chars") {
+    const extract = (tag) => {
+        const regex = new RegExp(`=== ${tag} ===\\s*([\\s\\S]*?)(?==== [A-Z_]+ ===|$)`);
+        const match = content.match(regex);
+        return match?.[1]?.trim() ?? "";
+    };
+    let chapterContent = extract("CHAPTER_CONTENT");
+    // Fallback: if === TAG === parsing fails (common with local/small models),
+    // try to extract usable content from the raw output
+    if (!chapterContent) {
+        chapterContent = fallbackExtractContent(content, countingMode);
+    }
+    let title = extract("CHAPTER_TITLE");
+    if (!title) {
+        title = fallbackExtractTitle(content, chapterNumber, countingMode);
+    }
+    return {
+        title,
+        content: chapterContent,
+        wordCount: countChapterLength(chapterContent, countingMode),
+        preWriteCheck: extract("PRE_WRITE_CHECK"),
+    };
+}
+/**
+ * Fallback content extraction when === CHAPTER_CONTENT === tag is missing.
+ * Tries common patterns from local/small models, then falls back to
+ * stripping metadata and returning the longest prose block.
+ */
+function fallbackExtractContent(raw, countingMode) {
+    // Try markdown heading: # 第N章 ... followed by content
+    const headingMatch = raw.match(/^#\s*第\d+章[^\n]*\n+([\s\S]+)/m);
+    if (headingMatch) {
+        return headingMatch[1].trim();
+    }
+    if (countingMode === "en_words") {
+        const englishHeadingMatch = raw.match(/^#\s*Chapter\s+\d+(?::|\s+)([^\n]*)\n+([\s\S]+)/im);
+        if (englishHeadingMatch) {
+            return englishHeadingMatch[2].trim();
+        }
+    }
+    // Try "正文" or "内容" labeled section
+    const labelMatch = raw.match(/(?:正文|内容|章节内容)[：:]\s*\n+([\s\S]+)/);
+    if (labelMatch) {
+        return labelMatch[1].trim();
+    }
+    if (countingMode === "en_words") {
+        const englishLabelMatch = raw.match(/(?:content|chapter content)[：:]\s*\n+([\s\S]+)/i);
+        if (englishLabelMatch) {
+            return englishLabelMatch[1].trim();
+        }
+    }
+    // Last resort: strip lines that look like metadata/tags, keep the rest
+    const lines = raw.split("\n");
+    const proseLines = lines.filter((line) => {
+        const trimmed = line.trim();
+        // Skip tag-like lines, empty lines at boundaries, and short key-value lines
+        if (/^===\s*[A-Z_]+\s*===/.test(trimmed))
+            return false;
+        if (/^(PRE_WRITE_CHECK|CHAPTER_TITLE|章节标题|写作自检)[：:]/.test(trimmed))
+            return false;
+        return true;
+    });
+    const result = proseLines.join("\n").trim();
+    // Only use fallback if we got meaningful content (>100 chars)
+    return result.length > 100 ? result : "";
+}
+/**
+ * Fallback title extraction when === CHAPTER_TITLE === tag is missing.
+ */
+function fallbackExtractTitle(raw, chapterNumber, countingMode) {
+    // Try: # 第N章 Title
+    const headingMatch = raw.match(/^#\s*第\d+章\s*(.+)/m);
+    if (headingMatch) {
+        return headingMatch[1].trim();
+    }
+    if (countingMode === "en_words") {
+        const englishHeadingMatch = raw.match(/^#\s*Chapter\s+\d+(?::|\s+)\s*(.+)/im);
+        if (englishHeadingMatch) {
+            return englishHeadingMatch[1].trim();
+        }
+    }
+    // Try: 章节标题：Title or CHAPTER_TITLE: Title (without === delimiters)
+    const labelMatch = raw.match(/(?:章节标题|CHAPTER_TITLE)[：:]\s*(.+)/);
+    if (labelMatch) {
+        return labelMatch[1].trim();
+    }
+    return defaultChapterTitle(chapterNumber, countingMode);
+}
+/**
+ * Parse LLM output that uses === TAG === delimiters into structured chapter data.
+ * Shared by WriterAgent (writing new chapters) and ChapterAnalyzerAgent (analyzing existing chapters).
+ */
+export function parseWriterOutput(chapterNumber, content, genreProfile, countingMode = "zh_chars") {
+    const extract = (tag) => {
+        const regex = new RegExp(`=== ${tag} ===\\s*([\\s\\S]*?)(?==== [A-Z_]+ ===|$)`);
+        const match = content.match(regex);
+        return match?.[1]?.trim() ?? "";
+    };
+    const chapterContent = extract("CHAPTER_CONTENT");
+    return {
+        chapterNumber,
+        title: extract("CHAPTER_TITLE") || defaultChapterTitle(chapterNumber, countingMode),
+        content: chapterContent,
+        wordCount: countChapterLength(chapterContent, countingMode),
+        preWriteCheck: extract("PRE_WRITE_CHECK"),
+        postSettlement: extract("POST_SETTLEMENT"),
+        updatedState: extract("UPDATED_STATE") || defaultStatePlaceholder(countingMode),
+        updatedLedger: genreProfile.numericalSystem
+            ? (extract("UPDATED_LEDGER") || defaultLedgerPlaceholder(countingMode))
+            : "",
+        updatedHooks: extract("UPDATED_HOOKS") || defaultHooksPlaceholder(countingMode),
+        chapterSummary: extract("CHAPTER_SUMMARY"),
+        updatedSubplots: extract("UPDATED_SUBPLOTS"),
+        updatedEmotionalArcs: extract("UPDATED_EMOTIONAL_ARCS"),
+        updatedCharacterMatrix: extract("UPDATED_CHARACTER_MATRIX"),
+    };
+}
+function defaultChapterTitle(chapterNumber, countingMode) {
+    return countingMode === "en_words" ? `Chapter ${chapterNumber}` : `第${chapterNumber}章`;
+}
+function defaultStatePlaceholder(countingMode) {
+    return countingMode === "en_words" ? "(state card not updated)" : "(状态卡未更新)";
+}
+function defaultLedgerPlaceholder(countingMode) {
+    return countingMode === "en_words" ? "(ledger not updated)" : "(账本未更新)";
+}
+function defaultHooksPlaceholder(countingMode) {
+    return countingMode === "en_words" ? "(hooks pool not updated)" : "(伏笔池未更新)";
+}
+//# sourceMappingURL=writer-parser.js.map

package/dist/agents/writer-parser.js.map

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

package/dist/agents/writer-prompts.d.ts

@@ -0,0 +1,12 @@
+import type { BookConfig, FanficMode } from "../models/book.js";
+import type { GenreProfile } from "../models/genre-profile.js";
+import type { BookRules } from "../models/book-rules.js";
+import type { LengthSpec } from "../models/length-governance.js";
+export interface FanficContext {
+    readonly fanficCanon: string;
+    readonly fanficMode: FanficMode;
+    readonly allowedDeviations: ReadonlyArray<string>;
+}
+export declare function buildWriterSystemPrompt(book: BookConfig, genreProfile: GenreProfile, bookRules: BookRules | null, bookRulesBody: string, genreBody: string, styleGuide: string, styleFingerprint?: string, chapterNumber?: number, mode?: "full" | "creative", fanficContext?: FanficContext, languageOverride?: "zh" | "en", inputProfile?: "legacy" | "governed", lengthSpec?: LengthSpec): string;
+export declare function buildGoldenOpeningDiscipline(chapterNumber: number | undefined, language: "zh" | "en"): string;
+//# sourceMappingURL=writer-prompts.d.ts.map

package/dist/agents/writer-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer-prompts.d.ts","sourceRoot":"","sources":["../../src/agents/writer-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAKjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnD;AAMD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,MAAM,EACzB,aAAa,CAAC,EAAE,MAAM,EACtB,IAAI,GAAE,MAAM,GAAG,UAAmB,EAClC,aAAa,CAAC,EAAE,aAAa,EAC7B,gBAAgB,CAAC,EAAE,IAAI,GAAG,IAAI,EAC9B,YAAY,GAAE,QAAQ,GAAG,UAAqB,EAC9C,UAAU,CAAC,EAAE,UAAU,GACtB,MAAM,CAqDR;AAsGD,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,IAAI,GAAG,IAAI,GACpB,MAAM,CAgBR"}