@kienmatu/inkos-core 0.1.0

package/dist/utils/outline-paths.js

@@ -0,0 +1,311 @@
+/**
+ * Phase 5 (v13) path resolution — prefer the new prose outline files, fall
+ * back to legacy paths so older books keep working during transition.
+ *
+ * Maps:
+ *   story/outline/story_frame.md  →  preferred replacement for story_bible.md
+ *   story/outline/volume_map.md   →  preferred replacement for volume_outline.md
+ *   story/roles/主要角色/*.md +
+ *   story/roles/次要角色/*.md    →  preferred replacement for character_matrix.md
+ *
+ * All helpers accept a bookDir (path to a book root, containing `story/`)
+ * and return a string — either the new-file content when it exists, or the
+ * legacy file content, or an empty default placeholder.
+ */
+import { readFile, readdir, access } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Detect whether a book uses the Phase 5 new layout (outline/story_frame.md
+ * exists on disk). If yes, story_bible.md / book_rules.md are compat shims.
+ * If no, those files ARE the authoritative source.
+ */
+export async function isNewLayoutBook(bookDir) {
+    try {
+        await access(join(bookDir, "story", "outline", "story_frame.md"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether a book's architect foundation is fully written on disk. A long
+ * architect run (especially on a stronger model) can outlive the in-memory
+ * create-status tracking — or the server can restart mid-run — leaving the
+ * status endpoint with no entry. Checking disk lets create-status answer
+ * "ready" truthfully instead of an ambiguous 404 that reads as "failed".
+ *
+ * "Complete" mirrors the five sections the architect must emit
+ * (story_frame / volume_map / book_rules / pending_hooks / roles); a half-built
+ * book that is missing any of these is NOT ready.
+ */
+export async function isBookFoundationComplete(bookDir) {
+    const required = [
+        join(bookDir, "book.json"),
+        join(bookDir, "story", "outline", "story_frame.md"),
+        join(bookDir, "story", "outline", "volume_map.md"),
+        join(bookDir, "story", "book_rules.md"),
+        join(bookDir, "story", "pending_hooks.md"),
+    ];
+    for (const path of required) {
+        try {
+            await access(path);
+        }
+        catch {
+            return false;
+        }
+    }
+    // Roles must exist via EITHER source the runtime actually reads: a character
+    // sheet under the new roles/<tier>/ dir, OR the legacy character_matrix.md
+    // (readCharacterContext falls back to it). The architect routinely persists
+    // roles to character_matrix.md, so requiring the roles/ dir alone falsely
+    // reported a complete book as "missing".
+    for (const tier of ["主要角色", "major", "次要角色", "minor"]) {
+        try {
+            const entries = await readdir(join(bookDir, "story", "roles", tier));
+            if (entries.some((file) => file.endsWith(".md")))
+                return true;
+        }
+        catch {
+            // Try the next locale/tier directory.
+        }
+    }
+    try {
+        const matrix = await readFile(join(bookDir, "story", "character_matrix.md"), "utf-8");
+        if (hasLegacyCharacterMatrixRoles(matrix))
+            return true;
+    }
+    catch {
+        // No legacy matrix either.
+    }
+    return false;
+}
+function hasLegacyCharacterMatrixRoles(content) {
+    const normalized = content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .filter((line) => !line.includes("兼容提示"))
+        .filter((line) => !line.includes("story/roles/"))
+        .filter((line) => !/^\(?(?:none|无|暂无)\)?$/i.test(line));
+    return normalized.some((line) => {
+        const match = /^#{2,}\s+(.+)$/.exec(line);
+        if (!match)
+            return false;
+        const title = match[1].trim().replace(/[*`#]/g, "");
+        return !/^(主要角色|次要角色|major roles?|minor roles?|characters?|角色矩阵)$/i.test(title);
+    });
+}
+async function readOr(path, fallback) {
+    try {
+        return await readFile(path, "utf-8");
+    }
+    catch {
+        return fallback;
+    }
+}
+/** Read story_frame.md, falling back to legacy story_bible.md. */
+export async function readStoryFrame(bookDir, fallbackPlaceholder = "") {
+    const newPath = join(bookDir, "story", "outline", "story_frame.md");
+    const legacyPath = join(bookDir, "story", "story_bible.md");
+    const newContent = await readOr(newPath, "");
+    if (newContent.trim())
+        return newContent;
+    return readOr(legacyPath, fallbackPlaceholder);
+}
+/** Read volume_map.md, falling back to legacy volume_outline.md. */
+export async function readVolumeMap(bookDir, fallbackPlaceholder = "") {
+    const newPath = join(bookDir, "story", "outline", "volume_map.md");
+    const legacyPath = join(bookDir, "story", "volume_outline.md");
+    const newContent = await readOr(newPath, "");
+    if (newContent.trim())
+        return newContent;
+    return readOr(legacyPath, fallbackPlaceholder);
+}
+/** Read the rhythm principles file (zh or en variant). */
+export async function readRhythmPrinciples(bookDir) {
+    const zhPath = join(bookDir, "story", "outline", "节奏原则.md");
+    const enPath = join(bookDir, "story", "outline", "rhythm_principles.md");
+    const zh = await readOr(zhPath, "");
+    if (zh.trim())
+        return zh;
+    return readOr(enPath, "");
+}
+/**
+ * Read the roles/ directory. Returns [] when no roles are present (e.g. old
+ * books still on character_matrix.md).
+ */
+export async function readRoleCards(bookDir) {
+    const rolesRoot = join(bookDir, "story", "roles");
+    const majorDirZh = join(rolesRoot, "主要角色");
+    const minorDirZh = join(rolesRoot, "次要角色");
+    const majorDirEn = join(rolesRoot, "major");
+    const minorDirEn = join(rolesRoot, "minor");
+    const cards = [];
+    await Promise.all([
+        collectRoleDir(majorDirZh, "major", cards),
+        collectRoleDir(minorDirZh, "minor", cards),
+        collectRoleDir(majorDirEn, "major", cards),
+        collectRoleDir(minorDirEn, "minor", cards),
+    ]);
+    return cards;
+}
+async function collectRoleDir(dir, tier, out) {
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return;
+    }
+    const reads = entries
+        .filter((entry) => entry.endsWith(".md"))
+        .map(async (entry) => {
+        const content = await readOr(join(dir, entry), "");
+        if (!content.trim())
+            return;
+        out.push({
+            tier,
+            name: entry.replace(/\.md$/, ""),
+            content,
+        });
+    });
+    await Promise.all(reads);
+}
+/**
+ * Render role cards in a format compatible with downstream consumers that
+ * previously expected character_matrix.md prose. When no role cards exist,
+ * returns the legacy character_matrix.md content or the placeholder.
+ */
+export async function readCharacterContext(bookDir, fallbackPlaceholder = "") {
+    const cards = await readRoleCards(bookDir);
+    if (cards.length > 0) {
+        const groups = { major: [], minor: [] };
+        for (const card of cards)
+            groups[card.tier].push(card);
+        const render = (tierCards, heading) => {
+            if (tierCards.length === 0)
+                return "";
+            const sections = tierCards.map((card) => `### ${card.name}\n\n${card.content.trim()}`);
+            return `## ${heading}\n\n${sections.join("\n\n")}`;
+        };
+        const blocks = [
+            render(groups.major, "主要角色 / Major characters"),
+            render(groups.minor, "次要角色 / Minor characters"),
+        ].filter(Boolean);
+        return blocks.join("\n\n");
+    }
+    // Fallback: legacy character_matrix.md (may itself be a shim pointer).
+    const legacyPath = join(bookDir, "story", "character_matrix.md");
+    return readOr(legacyPath, fallbackPlaceholder);
+}
+// ---------------------------------------------------------------------------
+// Phase 5 consolidation: current_state.md initial fallback
+//
+// After architect consolidation (7→5 sections), current_state.md is seeded
+// with a tiny placeholder at book creation. Real content only arrives once
+// the consolidator has appended output from chapter 1 onward. Readers that
+// previously relied on architect-provided initial state (writer phase-1
+// creative prompt, continuity, chapter-analyzer, reviser, composer) should
+// substitute a derived initial-state block when the seed placeholder is all
+// that's on disk — otherwise the "## 当前状态卡" block in prompts degenerates
+// into a meta note about runtime append behaviour.
+// ---------------------------------------------------------------------------
+/**
+ * Marker substring emitted by architect.writeFoundationFiles when seeding
+ * current_state.md. Its presence is how readers detect "nothing real yet".
+ */
+const CURRENT_STATE_SEED_MARKERS = [
+    "建书时占位",
+    "Seeded at book creation",
+];
+export function isCurrentStateSeedPlaceholder(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return true;
+    // Heuristic: short file AND contains one of the seed markers.
+    if (trimmed.length > 600)
+        return false;
+    return CURRENT_STATE_SEED_MARKERS.some((marker) => trimmed.includes(marker));
+}
+function extractCurrentStateFromRole(content) {
+    // Accept both zh (`## 当前现状`) and en (`## Current_State` / `## Current State`).
+    const pattern = /^##\s*(?:当前现状|Current[_\s]?State)[^\n]*$/im;
+    const match = content.match(pattern);
+    if (!match || match.index === undefined)
+        return null;
+    const after = content.slice(match.index + match[0].length);
+    // Cut at next `## ` heading (same or higher level).
+    const nextHeading = after.search(/^##\s/m);
+    const raw = nextHeading >= 0 ? after.slice(0, nextHeading) : after;
+    const text = raw.trim();
+    return text.length > 0 ? text : null;
+}
+function extractSeedHooksFromPendingHooks(raw) {
+    if (!raw.trim())
+        return [];
+    const lines = raw.split("\n").map((line) => line.trim()).filter(Boolean);
+    const seedRows = [];
+    for (const line of lines) {
+        if (!line.startsWith("|"))
+            continue;
+        if (/^\|\s*-/.test(line))
+            continue;
+        const cells = line.split("|").slice(1, -1).map((cell) => cell.trim());
+        if (cells.length < 2)
+            continue;
+        if (cells[0]?.toLowerCase() === "hook_id" || cells[0] === "hookId")
+            continue;
+        const startCh = Number.parseInt(cells[1] ?? "", 10);
+        if (!Number.isFinite(startCh) || startCh !== 0)
+            continue;
+        // cells[2] type, cells[5] expected payoff, last cell notes
+        const notes = cells[cells.length - 1] ?? "";
+        const summary = [cells[0], cells[2], notes].filter(Boolean).join(" · ");
+        if (summary)
+            seedRows.push(summary);
+    }
+    return seedRows;
+}
+/**
+ * Read current_state.md; when the file is only a seed placeholder (chapter 0,
+ * before consolidator has appended anything), derive an initial-state block
+ * from roles/*.Current_State + pending_hooks startChapter=0 rows so callers
+ * still have substantive content to feed into writer / analyzer prompts.
+ */
+export async function readCurrentStateWithFallback(bookDir, fallbackPlaceholder = "") {
+    const storyDir = join(bookDir, "story");
+    const currentStatePath = join(storyDir, "current_state.md");
+    const raw = await readOr(currentStatePath, "");
+    if (!isCurrentStateSeedPlaceholder(raw)) {
+        return raw;
+    }
+    const [cards, pendingHooks] = await Promise.all([
+        readRoleCards(bookDir),
+        readOr(join(storyDir, "pending_hooks.md"), ""),
+    ]);
+    const roleLines = cards
+        .map((card) => {
+        const state = extractCurrentStateFromRole(card.content);
+        if (!state)
+            return null;
+        const tierLabel = card.tier === "major" ? "主要" : "次要";
+        return `- ${card.name}（${tierLabel}）：${state.replace(/\s+/g, " ")}`;
+    })
+        .filter((line) => line !== null);
+    const hookLines = extractSeedHooksFromPendingHooks(pendingHooks);
+    if (roleLines.length === 0 && hookLines.length === 0) {
+        return raw.trim() ? raw : fallbackPlaceholder;
+    }
+    const parts = ["# 初始状态（第 0 章，由 roles + 种子伏笔派生）"];
+    if (roleLines.length > 0) {
+        parts.push("\n## 角色初始位置 / 处境");
+        parts.push(...roleLines);
+    }
+    if (hookLines.length > 0) {
+        parts.push("\n## 种子伏笔（startChapter = 0）");
+        parts.push(...hookLines.map((line) => `- ${line}`));
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=outline-paths.js.map

package/dist/utils/outline-paths.js.map

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

package/dist/utils/path-safety.d.ts

@@ -0,0 +1,2 @@
+export declare function safeChildPath(root: string, requestedPath: string): string;
+//# sourceMappingURL=path-safety.d.ts.map

package/dist/utils/path-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../src/utils/path-safety.ts"],"names":[],"mappings":"AAEA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAQzE"}

package/dist/utils/path-safety.js

@@ -0,0 +1,11 @@
+import { isAbsolute, relative, resolve } from "node:path";
+export function safeChildPath(root, requestedPath) {
+    const resolvedRoot = resolve(root);
+    const resolvedPath = resolve(resolvedRoot, requestedPath);
+    const rel = relative(resolvedRoot, resolvedPath);
+    if (rel === "" || (!rel.startsWith("..") && !isAbsolute(rel))) {
+        return resolvedPath;
+    }
+    throw new Error(`Path traversal blocked: ${requestedPath}`);
+}
+//# sourceMappingURL=path-safety.js.map

package/dist/utils/path-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.js","sourceRoot":"","sources":["../../src/utils/path-safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,aAAqB;IAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,aAAa,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/utils/planning-materials.d.ts

@@ -0,0 +1,35 @@
+import type { StoredHook, StoredSummary } from "../state/memory-db.js";
+import { type MemorySelection } from "./memory-retrieval.js";
+export interface PlanningSeedMaterials {
+    readonly storyDir: string;
+    readonly authorIntent: string;
+    readonly currentFocus: string;
+    readonly storyBible: string;
+    readonly volumeOutline: string;
+    readonly bookRulesRaw: string;
+    readonly currentState: string;
+    readonly chapterSummariesRaw: string;
+    readonly brief: string;
+    readonly outlineNode?: string;
+    readonly recentSummaries: ReadonlyArray<StoredSummary>;
+    readonly previousEndingHook?: string;
+    readonly previousEndingExcerpt?: string;
+}
+export interface PlanningMaterials extends PlanningSeedMaterials {
+    readonly activeHooks: ReadonlyArray<StoredHook>;
+    readonly memorySelection: MemorySelection;
+    readonly plannerInputs: ReadonlyArray<string>;
+}
+export declare function loadPlanningSeedMaterials(params: {
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+}): Promise<PlanningSeedMaterials>;
+export declare function gatherPlanningMaterials(params: {
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly goal: string;
+    readonly outlineNode?: string;
+    readonly mustKeep?: ReadonlyArray<string>;
+    readonly seed?: PlanningSeedMaterials;
+}): Promise<PlanningMaterials>;
+//# sourceMappingURL=planning-materials.d.ts.map

package/dist/utils/planning-materials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-materials.d.ts","sourceRoot":"","sources":["../../src/utils/planning-materials.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAO/B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACvD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC/C;AAkDD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAyDjC;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC;CACvC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+B7B"}

package/dist/utils/planning-materials.js

@@ -0,0 +1,123 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { parseChapterSummariesMarkdown, retrieveMemorySelection, } from "./memory-retrieval.js";
+import { readStoryFrame, readVolumeMap, readCurrentStateWithFallback, } from "./outline-paths.js";
+async function readFileOrDefault(path) {
+    try {
+        return await readFile(path, "utf-8");
+    }
+    catch {
+        return "(文件尚未创建)";
+    }
+}
+async function readBriefFile(path) {
+    try {
+        return await readFile(path, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+async function readPreviousEndingExcerpt(bookDir, chapterNumber) {
+    const previousChapter = chapterNumber - 1;
+    if (previousChapter < 1) {
+        return undefined;
+    }
+    const chaptersDir = join(bookDir, "chapters");
+    const padded = String(previousChapter).padStart(4, "0");
+    try {
+        const files = await readdir(chaptersDir);
+        const match = files.find((file) => file.startsWith(padded) && file.endsWith(".md"));
+        if (!match) {
+            return undefined;
+        }
+        const markdown = await readFile(join(chaptersDir, match), "utf-8");
+        const body = markdown
+            .split("\n")
+            .slice(1)
+            .join("\n")
+            .trim();
+        if (!body) {
+            return undefined;
+        }
+        return body.slice(-320).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function loadPlanningSeedMaterials(params) {
+    const storyDir = join(params.bookDir, "story");
+    const sourcePaths = {
+        authorIntent: join(storyDir, "author_intent.md"),
+        currentFocus: join(storyDir, "current_focus.md"),
+        chapterSummaries: join(storyDir, "chapter_summaries.md"),
+        bookRules: join(storyDir, "book_rules.md"),
+        currentState: join(storyDir, "current_state.md"),
+        brief: join(storyDir, "brief.md"),
+    };
+    // Phase 5: prefer the new prose outline files (outline/story_frame.md +
+    // outline/volume_map.md). Fall back to the legacy files transparently.
+    const placeholder = "(文件尚未创建)";
+    const [authorIntent, currentFocus, storyBible, volumeOutline, chapterSummariesRaw, bookRulesRaw, currentState, previousEndingExcerpt, brief,] = await Promise.all([
+        readFileOrDefault(sourcePaths.authorIntent),
+        readFileOrDefault(sourcePaths.currentFocus),
+        readStoryFrame(params.bookDir, placeholder),
+        readVolumeMap(params.bookDir, placeholder),
+        readFileOrDefault(sourcePaths.chapterSummaries),
+        readFileOrDefault(sourcePaths.bookRules),
+        // Phase 5 consolidation: derive initial state from roles + pending_hooks
+        // seed rows when current_state.md is still just the architect's placeholder.
+        readCurrentStateWithFallback(params.bookDir, placeholder),
+        readPreviousEndingExcerpt(params.bookDir, params.chapterNumber),
+        readBriefFile(sourcePaths.brief),
+    ]);
+    const chapterSummaries = parseChapterSummariesMarkdown(chapterSummariesRaw)
+        .filter((summary) => summary.chapter < params.chapterNumber)
+        .sort((left, right) => right.chapter - left.chapter);
+    return {
+        storyDir,
+        authorIntent,
+        currentFocus,
+        storyBible,
+        volumeOutline,
+        bookRulesRaw,
+        currentState,
+        chapterSummariesRaw,
+        brief,
+        recentSummaries: chapterSummaries.slice(0, 4).sort((left, right) => left.chapter - right.chapter),
+        previousEndingHook: chapterSummaries[0]?.hookActivity || undefined,
+        previousEndingExcerpt,
+    };
+}
+export async function gatherPlanningMaterials(params) {
+    const seed = params.seed ?? await loadPlanningSeedMaterials({
+        bookDir: params.bookDir,
+        chapterNumber: params.chapterNumber,
+    });
+    const memorySelection = await retrieveMemorySelection({
+        bookDir: params.bookDir,
+        chapterNumber: params.chapterNumber,
+        goal: params.goal,
+        outlineNode: params.outlineNode,
+        mustKeep: params.mustKeep,
+    });
+    return {
+        ...seed,
+        outlineNode: params.outlineNode,
+        activeHooks: memorySelection.activeHooks,
+        memorySelection,
+        plannerInputs: [
+            join(seed.storyDir, "author_intent.md"),
+            join(seed.storyDir, "current_focus.md"),
+            join(seed.storyDir, "outline", "story_frame.md"),
+            join(seed.storyDir, "outline", "volume_map.md"),
+            join(seed.storyDir, "chapter_summaries.md"),
+            join(seed.storyDir, "book_rules.md"),
+            join(seed.storyDir, "current_state.md"),
+            join(seed.storyDir, "pending_hooks.md"),
+            ...(memorySelection.dbPath ? [memorySelection.dbPath] : []),
+        ],
+    };
+}
+//# sourceMappingURL=planning-materials.js.map

package/dist/utils/planning-materials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning-materials.js","sourceRoot":"","sources":["../../src/utils/planning-materials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,GAExB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,aAAa,EACb,4BAA4B,GAC7B,MAAM,oBAAoB,CAAC;AAwB5B,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,OAAe,EACf,aAAqB;IAErB,MAAM,eAAe,GAAG,aAAa,GAAG,CAAC,CAAC;IAC1C,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,QAAQ;aAClB,KAAK,CAAC,IAAI,CAAC;aACX,KAAK,CAAC,CAAC,CAAC;aACR,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,EAAE,CAAC;QACV,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,MAG/C;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG;QAClB,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC;QAChD,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC;QAChD,gBAAgB,EAAE,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC;QACxD,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC;QAC1C,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC;QAChD,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;KACzB,CAAC;IAEX,wEAAwE;IACxE,uEAAuE;IACvE,MAAM,WAAW,GAAG,UAAU,CAAC;IAE/B,MAAM,CACJ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,KAAK,EACN,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC;QAC3C,iBAAiB,CAAC,WAAW,CAAC,YAAY,CAAC;QAC3C,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC;QAC3C,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC;QAC1C,iBAAiB,CAAC,WAAW,CAAC,gBAAgB,CAAC;QAC/C,iBAAiB,CAAC,WAAW,CAAC,SAAS,CAAC;QACxC,yEAAyE;QACzE,6EAA6E;QAC7E,4BAA4B,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC;QACzD,yBAAyB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC;QAC/D,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC;KACjC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,6BAA6B,CAAC,mBAAmB,CAAC;SACxE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;SAC3D,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,OAAO;QACL,QAAQ;QACR,YAAY;QACZ,YAAY;QACZ,UAAU;QACV,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,mBAAmB;QACnB,KAAK;QACL,eAAe,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACjG,kBAAkB,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,YAAY,IAAI,SAAS;QAClE,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAO7C;IACC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,yBAAyB,CAAC;QAC1D,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,MAAM,uBAAuB,CAAC;QACpD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,eAAe,CAAC,WAAW;QACxC,eAAe;QACf,aAAa,EAAE;YACb,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC;YAChD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,eAAe,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC;YACvC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/posix-path.d.ts

@@ -0,0 +1,2 @@
+export declare function toPosixPath(value: string): string;
+//# sourceMappingURL=posix-path.d.ts.map

package/dist/utils/posix-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix-path.d.ts","sourceRoot":"","sources":["../../src/utils/posix-path.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/utils/posix-path.js

@@ -0,0 +1,7 @@
+// Normalizes a project-relative path to "/" separators before it is persisted
+// into manifests, returned in pipeline results, or used as a URL — on Windows,
+// node:path join()/relative() produce "\" which those consumers must not see.
+export function toPosixPath(value) {
+    return value.replace(/\\/gu, "/");
+}
+//# sourceMappingURL=posix-path.js.map

package/dist/utils/posix-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posix-path.js","sourceRoot":"","sources":["../../src/utils/posix-path.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/pov-filter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * POV-aware context filtering.
+ *
+ * Filters truth file content based on the current POV character's
+ * information boundaries. Characters should only "see" information
+ * they've actually witnessed or been told about.
+ *
+ * Works with markdown-based truth files (no DB dependency).
+ * When MemoryDB is available, can do more precise queries.
+ */
+/**
+ * Extract the POV character from the volume outline for a given chapter.
+ * Looks for patterns like "POV: 角色名" or "视角: 角色名" or "POV: CharacterName"
+ * in the chapter's section of the outline.
+ */
+export declare function extractPOVFromOutline(volumeOutline: string, chapterNumber: number): string | null;
+/**
+ * Filter character_matrix information boundaries for the POV character.
+ * Returns only what the POV character knows — strips other characters' "known info".
+ */
+export declare function filterMatrixByPOV(characterMatrix: string, povCharacter: string): string;
+/**
+ * Filter pending_hooks by POV character's knowledge.
+ * Hooks planted in scenes where the POV character was NOT present are hidden.
+ *
+ * This is a heuristic: if the hook's chapter summary mentions the POV character,
+ * they likely know about it.
+ */
+export declare function filterHooksByPOV(hooks: string, povCharacter: string, chapterSummaries: string): string;
+//# sourceMappingURL=pov-filter.d.ts.map

package/dist/utils/pov-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pov-filter.d.ts","sourceRoot":"","sources":["../../src/utils/pov-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BjG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAoCvF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAgDR"}