inkos-n-core 1.2.0

package/dist/utils/chapter-cadence.js

@@ -0,0 +1,142 @@
+import { CADENCE_PRESSURE_THRESHOLDS, CADENCE_WINDOW_DEFAULTS, resolveCadencePressure, } from "./cadence-policy.js";
+export const DEFAULT_CHAPTER_CADENCE_WINDOW = CADENCE_WINDOW_DEFAULTS.summaryLookback;
+const HIGH_TENSION_KEYWORDS = [
+    "紧张", "冷硬", "压抑", "逼仄", "肃杀", "沉重", "凝重",
+    "冷峻", "压迫", "阴沉", "焦灼", "窒息", "凛冽", "锋利",
+    "克制", "危机", "对峙", "绷紧", "僵持", "杀意",
+    "tense", "cold", "oppressive", "grim", "ominous", "dark",
+    "bleak", "hostile", "threatening", "heavy", "suffocating",
+];
+const ENGLISH_STOP_WORDS = new Set([
+    "the", "and", "with", "from", "into", "after", "before",
+    "over", "under", "this", "that", "your", "their",
+]);
+export function analyzeChapterCadence(params) {
+    const recentRows = [...params.rows]
+        .sort((left, right) => left.chapter - right.chapter)
+        .slice(-CADENCE_WINDOW_DEFAULTS.summaryLookback);
+    return {
+        scenePressure: analyzeScenePressure(recentRows),
+        moodPressure: analyzeMoodPressure(recentRows),
+        titlePressure: analyzeTitlePressure(recentRows, params.language),
+    };
+}
+export function isHighTensionMood(mood) {
+    const lowerMood = mood.toLowerCase();
+    return HIGH_TENSION_KEYWORDS.some((keyword) => lowerMood.includes(keyword));
+}
+function analyzeScenePressure(rows) {
+    const types = rows
+        .map((row) => row.chapterType.trim())
+        .filter((value) => isMeaningfulValue(value));
+    if (types.length < 2) {
+        return undefined;
+    }
+    const repeatedType = types.at(-1);
+    if (!repeatedType) {
+        return undefined;
+    }
+    let streak = 0;
+    for (const type of [...types].reverse()) {
+        if (type.toLowerCase() !== repeatedType.toLowerCase()) {
+            break;
+        }
+        streak += 1;
+    }
+    const pressure = resolveCadencePressure({
+        count: streak,
+        total: types.length,
+        highThreshold: CADENCE_PRESSURE_THRESHOLDS.scene.highCount,
+        mediumThreshold: CADENCE_PRESSURE_THRESHOLDS.scene.mediumCount,
+        mediumWindowFloor: CADENCE_PRESSURE_THRESHOLDS.scene.mediumWindowFloor,
+    });
+    if (pressure) {
+        return { pressure, repeatedType, streak };
+    }
+    return undefined;
+}
+function analyzeMoodPressure(rows) {
+    const moods = rows
+        .map((row) => row.mood.trim())
+        .filter((value) => isMeaningfulValue(value));
+    if (moods.length < 2) {
+        return undefined;
+    }
+    const recentMoods = [];
+    let highTensionStreak = 0;
+    for (const mood of [...moods].reverse()) {
+        if (!isHighTensionMood(mood)) {
+            break;
+        }
+        recentMoods.unshift(mood);
+        highTensionStreak += 1;
+    }
+    const pressure = resolveCadencePressure({
+        count: highTensionStreak,
+        total: moods.length,
+        highThreshold: CADENCE_PRESSURE_THRESHOLDS.mood.highCount,
+        mediumThreshold: CADENCE_PRESSURE_THRESHOLDS.mood.mediumCount,
+        mediumWindowFloor: CADENCE_PRESSURE_THRESHOLDS.mood.mediumWindowFloor,
+    });
+    if (pressure) {
+        return { pressure, highTensionStreak, recentMoods };
+    }
+    return undefined;
+}
+function analyzeTitlePressure(rows, language) {
+    const titles = rows
+        .map((row) => row.title.trim())
+        .filter((value) => isMeaningfulValue(value));
+    if (titles.length < 2) {
+        return undefined;
+    }
+    const counts = new Map();
+    for (const title of titles) {
+        for (const token of extractTitleTokens(title, language)) {
+            counts.set(token, (counts.get(token) ?? 0) + 1);
+        }
+    }
+    const repeated = [...counts.entries()]
+        .sort((left, right) => right[1] - left[1] || right[0].length - left[0].length || left[0].localeCompare(right[0]))
+        .find((entry) => entry[1] >= CADENCE_PRESSURE_THRESHOLDS.title.minimumRepeatedCount);
+    if (!repeated) {
+        return undefined;
+    }
+    const [repeatedToken, count] = repeated;
+    const pressure = resolveCadencePressure({
+        count,
+        total: titles.length,
+        highThreshold: CADENCE_PRESSURE_THRESHOLDS.title.highCount,
+        mediumThreshold: CADENCE_PRESSURE_THRESHOLDS.title.mediumCount,
+        mediumWindowFloor: CADENCE_PRESSURE_THRESHOLDS.title.mediumWindowFloor,
+    });
+    if (pressure) {
+        return { pressure, repeatedToken, count, recentTitles: titles };
+    }
+    return undefined;
+}
+function extractTitleTokens(title, language) {
+    if (language === "en") {
+        const words = title.match(/[a-z]{4,}/gi) ?? [];
+        return [...new Set(words
+                .map((word) => word.toLowerCase())
+                .filter((word) => !ENGLISH_STOP_WORDS.has(word)))];
+    }
+    const segments = title.match(/[\u4e00-\u9fff]{2,}/g) ?? [];
+    const tokens = new Set();
+    for (const segment of segments) {
+        for (let size = 2; size <= Math.min(4, segment.length); size += 1) {
+            for (let index = 0; index <= segment.length - size; index += 1) {
+                tokens.add(segment.slice(index, index + size));
+            }
+        }
+    }
+    return [...tokens];
+}
+function isMeaningfulValue(value) {
+    const normalized = value.trim().toLowerCase();
+    if (!normalized)
+        return false;
+    return normalized !== "none" && normalized !== "(none)" && normalized !== "无";
+}
+//# sourceMappingURL=chapter-cadence.js.map

package/dist/utils/chapter-cadence.js.map

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

package/dist/utils/chapter-splitter.d.ts

@@ -0,0 +1,18 @@
+export interface SplitChapter {
+    readonly title: string;
+    readonly content: string;
+}
+/**
+ * Split a single text file into chapters by matching title lines.
+ *
+ * Default pattern matches:
+ * - "第一章 xxxx" / "第1章 xxxx"
+ * - "第一回 xxxx" / "第1回 xxxx"
+ * - "# 第1章 xxxx" / "## 第23章 xxxx"
+ * - "CHAPTER I." / "CHAPTER II."
+ *
+ * Each match marks the start of a new chapter. Content between matches
+ * belongs to the preceding chapter.
+ */
+export declare function splitChapters(text: string, pattern?: string): ReadonlyArray<SplitChapter>;
+//# sourceMappingURL=chapter-splitter.d.ts.map

package/dist/utils/chapter-splitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chapter-splitter.d.ts","sourceRoot":"","sources":["../../src/utils/chapter-splitter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAAC,YAAY,CAAC,CAsC7B"}

package/dist/utils/chapter-splitter.js

@@ -0,0 +1,60 @@
+/**
+ * Split a single text file into chapters by matching title lines.
+ *
+ * Default pattern matches:
+ * - "第一章 xxxx" / "第1章 xxxx"
+ * - "第一回 xxxx" / "第1回 xxxx"
+ * - "# 第1章 xxxx" / "## 第23章 xxxx"
+ * - "CHAPTER I." / "CHAPTER II."
+ *
+ * Each match marks the start of a new chapter. Content between matches
+ * belongs to the preceding chapter.
+ */
+export function splitChapters(text, pattern) {
+    const defaultPattern = /^#{0,2}\s*(?:第[零〇○Ｏ０一二三四五六七八九十百千万\d]+(?:章|回)(?:[:：]|\s+)?\s*(.*)|Chapter\s+(?:\d+|[IVXLCDM]+)(?:\.|:|\s+)?\s*(.*))/i;
+    const regex = pattern ? new RegExp(pattern, "m") : defaultPattern;
+    const lines = text.split("\n");
+    const chapters = [];
+    for (let i = 0; i < lines.length; i++) {
+        const match = lines[i].match(regex);
+        if (match) {
+            chapters.push({
+                title: (match[1] ?? match[2] ?? "").trim(),
+                startLine: i,
+            });
+        }
+    }
+    if (chapters.length === 0) {
+        return [];
+    }
+    const result = [];
+    for (let i = 0; i < chapters.length; i++) {
+        const chapter = chapters[i];
+        const nextStart = i + 1 < chapters.length ? chapters[i + 1].startLine : lines.length;
+        // Content starts after the title line
+        const contentLines = lines.slice(chapter.startLine + 1, nextStart);
+        const content = stripTrailingLicense(contentLines.join("\n")).trim();
+        result.push({
+            title: chapter.title || inferFallbackTitle(lines[chapter.startLine] ?? "", i + 1),
+            content,
+        });
+    }
+    return result;
+}
+function stripTrailingLicense(content) {
+    const trailerMatch = content.match(/^\s*Project Gutenberg(?:™|\(TM\))?.*$/im);
+    if (!trailerMatch || trailerMatch.index === undefined) {
+        return content;
+    }
+    return content.slice(0, trailerMatch.index).trimEnd();
+}
+function inferFallbackTitle(headingLine, chapterNumber) {
+    if (/chapter\s+(?:\d+|[ivxlcdm]+)/i.test(headingLine)) {
+        return `Chapter ${chapterNumber}`;
+    }
+    if (/第[零一二三四五六七八九十百千万\d]+回/.test(headingLine)) {
+        return `第${chapterNumber}回`;
+    }
+    return `第${chapterNumber}章`;
+}
+//# sourceMappingURL=chapter-splitter.js.map

package/dist/utils/chapter-splitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chapter-splitter.js","sourceRoot":"","sources":["../../src/utils/chapter-splitter.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,OAAgB;IAEhB,MAAM,cAAc,GAAG,qHAAqH,CAAC;IAC7I,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;IAElE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAgD,EAAE,CAAC;IAEjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;gBAC1C,SAAS,EAAE,CAAC;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;QAEtF,sCAAsC;QACtC,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,oBAAoB,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAErE,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;YACjF,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC9E,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAmB,EAAE,aAAqB;IACpE,IAAI,+BAA+B,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,OAAO,WAAW,aAAa,EAAE,CAAC;IACpC,CAAC;IAED,IAAI,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,aAAa,GAAG,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,aAAa,GAAG,CAAC;AAC9B,CAAC"}

package/dist/utils/config-loader.d.ts

@@ -0,0 +1,15 @@
+import { type ProjectConfig } from "../models/project.js";
+export declare const GLOBAL_CONFIG_DIR: string;
+export declare const GLOBAL_ENV_PATH: string;
+export declare function isApiKeyOptionalForEndpoint(params: {
+    readonly provider?: string | undefined;
+    readonly baseUrl?: string | undefined;
+}): boolean;
+/**
+ * Load project config from inkos.json with .env overrides.
+ * Shared by CLI and Studio — single source of truth for config loading.
+ */
+export declare function loadProjectConfig(root: string, options?: {
+    readonly requireApiKey?: boolean;
+}): Promise<ProjectConfig>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE/E,eAAO,MAAM,iBAAiB,QAA4B,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAkC,CAAC;AAE/D,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,GAAG,OAAO,CAwBV;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,OAAO,CAAC,aAAa,CAAC,CAmFxB"}

package/dist/utils/config-loader.js

@@ -0,0 +1,136 @@
+import { readFile, access } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { ProjectConfigSchema } from "../models/project.js";
+export const GLOBAL_CONFIG_DIR = join(homedir(), ".inkos");
+export const GLOBAL_ENV_PATH = join(GLOBAL_CONFIG_DIR, ".env");
+export function isApiKeyOptionalForEndpoint(params) {
+    if (params.provider === "anthropic") {
+        return false;
+    }
+    if (!params.baseUrl) {
+        return false;
+    }
+    try {
+        const url = new URL(params.baseUrl);
+        const hostname = url.hostname.toLowerCase();
+        return (hostname === "localhost"
+            || hostname === "127.0.0.1"
+            || hostname === "::1"
+            || hostname === "0.0.0.0"
+            || hostname === "host.docker.internal"
+            || hostname.endsWith(".local")
+            || isPrivateIpv4(hostname));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Load project config from inkos.json with .env overrides.
+ * Shared by CLI and Studio — single source of truth for config loading.
+ */
+export async function loadProjectConfig(root, options) {
+    // Load global ~/.inkos/.env first, then project .env overrides
+    const { config: loadEnv } = await import("dotenv");
+    loadEnv({ path: GLOBAL_ENV_PATH });
+    loadEnv({ path: join(root, ".env"), override: true });
+    const configPath = join(root, "inkos.json");
+    try {
+        await access(configPath);
+    }
+    catch {
+        throw new Error(`inkos.json not found in ${root}.\nMake sure you are inside an InkOS project directory (cd into the project created by 'inkos init').`);
+    }
+    const raw = await readFile(configPath, "utf-8");
+    let config;
+    try {
+        config = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`inkos.json in ${root} is not valid JSON. Check the file for syntax errors.`);
+    }
+    // .env overrides inkos.json for LLM settings
+    const env = process.env;
+    const llm = (config.llm ?? {});
+    if (env.INKOS_LLM_PROVIDER)
+        llm.provider = env.INKOS_LLM_PROVIDER;
+    if (env.INKOS_LLM_BASE_URL)
+        llm.baseUrl = env.INKOS_LLM_BASE_URL;
+    if (env.INKOS_LLM_MODEL)
+        llm.model = env.INKOS_LLM_MODEL;
+    if (env.INKOS_LLM_TEMPERATURE)
+        llm.temperature = parseFloat(env.INKOS_LLM_TEMPERATURE);
+    if (env.INKOS_LLM_MAX_TOKENS)
+        llm.maxTokens = parseInt(env.INKOS_LLM_MAX_TOKENS, 10);
+    if (env.INKOS_LLM_THINKING_BUDGET)
+        llm.thinkingBudget = parseInt(env.INKOS_LLM_THINKING_BUDGET, 10);
+    // Extra params from env: INKOS_LLM_EXTRA_<key>=<value>
+    const extraFromEnv = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith("INKOS_LLM_EXTRA_") && value) {
+            const paramName = key.slice("INKOS_LLM_EXTRA_".length);
+            // Auto-coerce: numbers, booleans, JSON objects
+            if (/^\d+(\.\d+)?$/.test(value))
+                extraFromEnv[paramName] = parseFloat(value);
+            else if (value === "true")
+                extraFromEnv[paramName] = true;
+            else if (value === "false")
+                extraFromEnv[paramName] = false;
+            else if (value.startsWith("{") || value.startsWith("[")) {
+                try {
+                    extraFromEnv[paramName] = JSON.parse(value);
+                }
+                catch {
+                    extraFromEnv[paramName] = value;
+                }
+            }
+            else
+                extraFromEnv[paramName] = value;
+        }
+    }
+    if (Object.keys(extraFromEnv).length > 0) {
+        llm.extra = { ...(llm.extra ?? {}), ...extraFromEnv };
+    }
+    if (env.INKOS_LLM_API_FORMAT)
+        llm.apiFormat = env.INKOS_LLM_API_FORMAT;
+    config.llm = llm;
+    // Global language override
+    if (env.INKOS_DEFAULT_LANGUAGE)
+        config.language = env.INKOS_DEFAULT_LANGUAGE;
+    // API key ONLY from env — never stored in inkos.json
+    const apiKey = env.INKOS_LLM_API_KEY;
+    const provider = typeof llm.provider === "string" ? llm.provider : undefined;
+    const baseUrl = typeof llm.baseUrl === "string" ? llm.baseUrl : undefined;
+    const apiKeyOptional = isApiKeyOptionalForEndpoint({ provider, baseUrl });
+    if (!apiKey && options?.requireApiKey !== false && !apiKeyOptional) {
+        throw new Error("INKOS_LLM_API_KEY not set. Run 'inkos config set-global' or add it to project .env file.");
+    }
+    if (options?.requireApiKey === false) {
+        llm.provider = typeof llm.provider === "string" && llm.provider.length > 0
+            ? llm.provider
+            : "openai";
+        llm.baseUrl = typeof llm.baseUrl === "string" && llm.baseUrl.length > 0
+            ? llm.baseUrl
+            : "https://example.invalid/v1";
+        llm.model = typeof llm.model === "string" && llm.model.length > 0
+            ? llm.model
+            : "noop-model";
+    }
+    llm.apiKey = apiKey ?? "";
+    return ProjectConfigSchema.parse(config);
+}
+function isPrivateIpv4(hostname) {
+    const parts = hostname.split(".").map((segment) => Number.parseInt(segment, 10));
+    if (parts.length !== 4 || parts.some((part) => Number.isNaN(part) || part < 0 || part > 255)) {
+        return false;
+    }
+    if (parts[0] === 10)
+        return true;
+    if (parts[0] === 192 && parts[1] === 168)
+        return true;
+    if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
+        return true;
+    return false;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/utils/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAE/D,MAAM,UAAU,2BAA2B,CAAC,MAG3C;IACC,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE5C,OAAO,CACL,QAAQ,KAAK,WAAW;eACrB,QAAQ,KAAK,WAAW;eACxB,QAAQ,KAAK,KAAK;eAClB,QAAQ,KAAK,SAAS;eACtB,QAAQ,KAAK,sBAAsB;eACnC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;eAC3B,aAAa,CAAC,QAAQ,CAAC,CAC3B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAA8C;IAE9C,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,uGAAuG,CACvI,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAEhD,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,uDAAuD,CAAC,CAAC;IAChG,CAAC;IAED,6CAA6C;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAC;IAC1D,IAAI,GAAG,CAAC,kBAAkB;QAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,kBAAkB,CAAC;IAClE,IAAI,GAAG,CAAC,kBAAkB;QAAE,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,kBAAkB,CAAC;IACjE,IAAI,GAAG,CAAC,eAAe;QAAE,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,eAAe,CAAC;IACzD,IAAI,GAAG,CAAC,qBAAqB;QAAE,GAAG,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACvF,IAAI,GAAG,CAAC,oBAAoB;QAAE,GAAG,CAAC,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IACrF,IAAI,GAAG,CAAC,yBAAyB;QAAE,GAAG,CAAC,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACpG,uDAAuD;IACvD,MAAM,YAAY,GAA4B,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,KAAK,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACvD,+CAA+C;YAC/C,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,YAAY,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;iBACxE,IAAI,KAAK,KAAK,MAAM;gBAAE,YAAY,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;iBACrD,IAAI,KAAK,KAAK,OAAO;gBAAE,YAAY,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;iBACvD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC;oBAAC,YAAY,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,YAAY,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;gBAAC,CAAC;YACjG,CAAC;;gBACI,YAAY,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;QACvC,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,KAAgC,IAAI,EAAE,CAAC,EAAE,GAAG,YAAY,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,GAAG,CAAC,oBAAoB;QAAE,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,oBAAoB,CAAC;IACvE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;IAEjB,2BAA2B;IAC3B,IAAI,GAAG,CAAC,sBAAsB;QAAE,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,sBAAsB,CAAC;IAE7E,qDAAqD;IACrD,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,cAAc,GAAG,2BAA2B,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAE1E,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE,aAAa,KAAK,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;QACrC,GAAG,CAAC,QAAQ,GAAG,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACxE,CAAC,CAAC,GAAG,CAAC,QAAQ;YACd,CAAC,CAAC,QAAQ,CAAC;QACb,GAAG,CAAC,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACrE,CAAC,CAAC,GAAG,CAAC,OAAO;YACb,CAAC,CAAC,4BAA4B,CAAC;QACjC,GAAG,CAAC,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAC/D,CAAC,CAAC,GAAG,CAAC,KAAK;YACX,CAAC,CAAC,YAAY,CAAC;IACnB,CAAC;IACD,GAAG,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IAE1B,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Smart context filtering for Writer and Auditor prompts.
+ *
+ * Reduces noise by injecting only relevant parts of truth files.
+ * Every filter falls back to the full input if filtering would empty it.
+ */
+/** Filter pending_hooks: remove resolved/closed hooks. */
+export declare function filterHooks(hooks: string): string;
+/** Filter chapter_summaries: keep only the most recent N chapters. */
+export declare function filterSummaries(summaries: string, currentChapter: number, keepRecent?: 4): string;
+/** Filter subplot_board: remove closed/resolved subplots. */
+export declare function filterSubplots(board: string): string;
+/** Filter emotional_arcs: keep only the most recent N chapters. */
+export declare function filterEmotionalArcs(arcs: string, currentChapter: number, keepRecent?: 4): string;
+/**
+ * Filter character_matrix: keep only characters mentioned in the volume outline
+ * current section + protagonist.
+ */
+export declare function filterCharacterMatrix(matrix: string, volumeOutline: string, protagonistName?: string): string;
+//# sourceMappingURL=context-filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-filter.d.ts","sourceRoot":"","sources":["../../src/utils/context-filter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjD;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,UAAU,IAAiC,GAC1C,MAAM,CAOR;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,UAAU,IAAiC,GAC1C,MAAM,CAOR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAyBR"}

package/dist/utils/context-filter.js

@@ -0,0 +1,134 @@
+/**
+ * Smart context filtering for Writer and Auditor prompts.
+ *
+ * Reduces noise by injecting only relevant parts of truth files.
+ * Every filter falls back to the full input if filtering would empty it.
+ */
+import { DEFAULT_CHAPTER_CADENCE_WINDOW } from "./chapter-cadence.js";
+/** Filter pending_hooks: remove resolved/closed hooks. */
+export function filterHooks(hooks) {
+    if (!hooks || hooks === "(文件尚未创建)")
+        return hooks;
+    return filterTableRows(hooks, (row) => {
+        const lower = row.toLowerCase();
+        return !lower.includes("已回收") && !lower.includes("resolved") && !lower.includes("closed");
+    });
+}
+/** Filter chapter_summaries: keep only the most recent N chapters. */
+export function filterSummaries(summaries, currentChapter, keepRecent = DEFAULT_CHAPTER_CADENCE_WINDOW) {
+    if (!summaries || summaries === "(文件尚未创建)")
+        return summaries;
+    return filterTableRows(summaries, (row) => {
+        const match = row.match(/\|\s*(\d+)\s*\|/);
+        if (!match)
+            return true;
+        return parseInt(match[1], 10) > currentChapter - keepRecent;
+    });
+}
+/** Filter subplot_board: remove closed/resolved subplots. */
+export function filterSubplots(board) {
+    if (!board || board === "(文件尚未创建)")
+        return board;
+    return filterTableRows(board, (row) => {
+        const lower = row.toLowerCase();
+        return !lower.includes("已回收") && !lower.includes("closed") && !lower.includes("resolved") && !lower.includes("已完结");
+    });
+}
+/** Filter emotional_arcs: keep only the most recent N chapters. */
+export function filterEmotionalArcs(arcs, currentChapter, keepRecent = DEFAULT_CHAPTER_CADENCE_WINDOW) {
+    if (!arcs || arcs === "(文件尚未创建)")
+        return arcs;
+    return filterTableRows(arcs, (row) => {
+        const match = row.match(/\|\s*(\d+)\s*\|/);
+        if (!match)
+            return true;
+        return parseInt(match[1], 10) > currentChapter - keepRecent;
+    });
+}
+/**
+ * Filter character_matrix: keep only characters mentioned in the volume outline
+ * current section + protagonist.
+ */
+export function filterCharacterMatrix(matrix, volumeOutline, protagonistName) {
+    if (!matrix || matrix === "(文件尚未创建)")
+        return matrix;
+    // Extract names from outline
+    const names = extractNames(volumeOutline);
+    if (protagonistName)
+        names.add(protagonistName);
+    if (names.size === 0)
+        return matrix;
+    // Split into sections (### 角色档案, ### 相遇记录, ### 信息边界)
+    const sections = matrix.split(/(?=^###)/m);
+    const filtered = sections.map((section) => {
+        const result = filterTableRows(section, (row) => {
+            for (const name of names) {
+                if (row.includes(name))
+                    return true;
+            }
+            return false;
+        });
+        // Keep section even if no matching rows (preserve headers for structure)
+        return result;
+    });
+    const result = filtered.join("\n");
+    // Fallback: if filtering removed all data rows, return original
+    const dataRowCount = result.split("\n").filter((l) => l.startsWith("|") && !l.includes("---") && !isHeaderRow(l)).length;
+    return dataRowCount > 0 ? result : matrix;
+}
+/**
+ * Extract character names from text.
+ * Chinese: 2-4 char sequences before punctuation.
+ * English: Capitalized words 3+ chars.
+ */
+function extractNames(text) {
+    const names = new Set();
+    // Chinese names
+    const cnRegex = /[\u4e00-\u9fff]{2,4}(?=[，、。：\s]|$)/g;
+    let match;
+    while ((match = cnRegex.exec(text)) !== null) {
+        names.add(match[0]);
+    }
+    // English names
+    const enRegex = /\b[A-Z][a-z]{2,}\b/g;
+    while ((match = enRegex.exec(text)) !== null) {
+        names.add(match[0]);
+    }
+    return names;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function isHeaderRow(line) {
+    // First data-like row in a table (contains column names)
+    return /^\|\s*(章节|角色|支线|hook_id|Chapter|Character|Subplot)/i.test(line);
+}
+/**
+ * Generic markdown table row filter.
+ * Keeps header rows + separator rows + rows passing the predicate.
+ * Falls back to original if filtering empties all data rows.
+ */
+function filterTableRows(content, predicate) {
+    const lines = content.split("\n");
+    const nonTableLines = [];
+    const headerLines = [];
+    const dataLines = [];
+    for (const line of lines) {
+        if (!line.startsWith("|")) {
+            nonTableLines.push(line);
+        }
+        else if (line.includes("---") || isHeaderRow(line)) {
+            headerLines.push(line);
+        }
+        else {
+            dataLines.push(line);
+        }
+    }
+    const filtered = dataLines.filter(predicate);
+    // Fallback: if no rows pass, return original
+    if (filtered.length === 0 && dataLines.length > 0) {
+        return content;
+    }
+    return [...nonTableLines, ...headerLines, ...filtered].join("\n");
+}
+//# sourceMappingURL=context-filter.js.map

package/dist/utils/context-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-filter.js","sourceRoot":"","sources":["../../src/utils/context-filter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACjD,OAAO,eAAe,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,cAAsB,EACtB,UAAU,GAAG,8BAA8B;IAE3C,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC7D,OAAO,eAAe,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,cAAc,GAAG,UAAU,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IACjD,OAAO,eAAe,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,cAAsB,EACtB,UAAU,GAAG,8BAA8B;IAE3C,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC9C,OAAO,eAAe,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,GAAG,cAAc,GAAG,UAAU,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,aAAqB,EACrB,eAAwB;IAExB,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAEpD,6BAA6B;IAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,eAAe;QAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAEpC,qDAAqD;IACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACxC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,OAAO,IAAI,CAAC;YACtC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;QACH,yEAAyE;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,gEAAgE;IAChE,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACzH,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,gBAAgB;IAChB,MAAM,OAAO,GAAG,qCAAqC,CAAC;IACtD,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GAAG,qBAAqB,CAAC;IACtC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,SAAS,WAAW,CAAC,IAAY;IAC/B,yDAAyD;IACzD,OAAO,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,OAAe,EAAE,SAAmC;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE7C,6CAA6C;IAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,GAAG,aAAa,EAAE,GAAG,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/utils/governed-context.d.ts

@@ -0,0 +1,11 @@
+import type { ContextPackage } from "../models/input-governance.js";
+export declare function buildGovernedMemoryEvidenceBlocks(contextPackage: ContextPackage, language?: "zh" | "en"): {
+    readonly hookDebtBlock?: string;
+    readonly hooksBlock?: string;
+    readonly summariesBlock?: string;
+    readonly volumeSummariesBlock?: string;
+    readonly titleHistoryBlock?: string;
+    readonly moodTrailBlock?: string;
+    readonly canonBlock?: string;
+};
+//# sourceMappingURL=governed-context.d.ts.map

package/dist/utils/governed-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governed-context.d.ts","sourceRoot":"","sources":["../../src/utils/governed-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE,cAAc,EAC9B,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GACrB;IACD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAqEA"}

package/dist/utils/governed-context.js

@@ -0,0 +1,42 @@
+export function buildGovernedMemoryEvidenceBlocks(contextPackage, language) {
+    const resolvedLanguage = language ?? "zh";
+    const hookEntries = contextPackage.selectedContext.filter((entry) => entry.source.startsWith("story/pending_hooks.md#"));
+    const hookDebtEntries = contextPackage.selectedContext.filter((entry) => entry.source.startsWith("runtime/hook_debt#"));
+    const summaryEntries = contextPackage.selectedContext.filter((entry) => entry.source.startsWith("story/chapter_summaries.md#"));
+    const volumeSummaryEntries = contextPackage.selectedContext.filter((entry) => entry.source.startsWith("story/volume_summaries.md#"));
+    const titleHistoryEntries = contextPackage.selectedContext.filter((entry) => entry.source === "story/chapter_summaries.md#recent_titles");
+    const moodTrailEntries = contextPackage.selectedContext.filter((entry) => entry.source === "story/chapter_summaries.md#recent_mood_type_trail");
+    const canonEntries = contextPackage.selectedContext.filter((entry) => entry.source === "story/parent_canon.md"
+        || entry.source === "story/fanfic_canon.md");
+    return {
+        hookDebtBlock: hookDebtEntries.length > 0
+            ? renderHookDebtBlock(resolvedLanguage === "en" ? "Hook Debt Briefs" : "Hook Debt Briefs", hookDebtEntries)
+            : undefined,
+        hooksBlock: hookEntries.length > 0
+            ? renderEvidenceBlock(resolvedLanguage === "en" ? "Selected Hook Evidence" : "已选伏笔证据", hookEntries)
+            : undefined,
+        summariesBlock: summaryEntries.length > 0
+            ? renderEvidenceBlock(resolvedLanguage === "en" ? "Selected Chapter Summary Evidence" : "已选章节摘要证据", summaryEntries)
+            : undefined,
+        volumeSummariesBlock: volumeSummaryEntries.length > 0
+            ? renderEvidenceBlock(resolvedLanguage === "en" ? "Selected Volume Summary Evidence" : "已选卷级摘要证据", volumeSummaryEntries)
+            : undefined,
+        titleHistoryBlock: titleHistoryEntries.length > 0
+            ? renderEvidenceBlock(resolvedLanguage === "en" ? "Recent Title History" : "近期标题历史", titleHistoryEntries)
+            : undefined,
+        moodTrailBlock: moodTrailEntries.length > 0
+            ? renderEvidenceBlock(resolvedLanguage === "en" ? "Recent Mood / Chapter Type Trail" : "近期情绪/章节类型轨迹", moodTrailEntries)
+            : undefined,
+        canonBlock: canonEntries.length > 0
+            ? renderEvidenceBlock(resolvedLanguage === "en" ? "Canon Evidence" : "正典约束证据", canonEntries)
+            : undefined,
+    };
+}
+function renderHookDebtBlock(heading, entries) {
+    return `\n## ${heading}\n${entries.map((entry) => `- ${entry.excerpt ?? entry.reason}`).join("\n")}\n`;
+}
+function renderEvidenceBlock(heading, entries) {
+    const lines = entries.map((entry) => `- ${entry.source}: ${entry.excerpt ?? entry.reason}`);
+    return `\n## ${heading}\n${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=governed-context.js.map