@kienmatu/inkos-core 0.1.0

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,11 @@
+import type { ProjectConfig } from "../models/project.js";
+import { type LLMConfigCliOverrides, type LLMConsumer } from "./effective-llm-config.js";
+import { GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH } from "./llm-env.js";
+import { isApiKeyOptionalForEndpoint } from "./llm-endpoint-auth.js";
+export { GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH, isApiKeyOptionalForEndpoint };
+export declare function loadProjectConfig(root: string, options?: {
+    readonly requireApiKey?: boolean;
+    readonly cli?: LLMConfigCliOverrides;
+    readonly consumer?: LLMConsumer;
+}): 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":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAoB,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,2BAA2B,EAAE,CAAC;AAE3E,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC,GACA,OAAO,CAAC,aAAa,CAAC,CAUxB"}

package/dist/utils/config-loader.js

@@ -0,0 +1,16 @@
+import { resolveEffectiveLLMConfig, } from "./effective-llm-config.js";
+import { loadLLMEnvLayers, GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH } from "./llm-env.js";
+import { isApiKeyOptionalForEndpoint } from "./llm-endpoint-auth.js";
+export { GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH, isApiKeyOptionalForEndpoint };
+export async function loadProjectConfig(root, options) {
+    const envLayers = await loadLLMEnvLayers(root);
+    const result = await resolveEffectiveLLMConfig({
+        consumer: options?.consumer ?? "cli",
+        projectRoot: root,
+        envLayers,
+        cli: options?.cli,
+        requireApiKey: options?.requireApiKey,
+    });
+    return result.config;
+}
+//# 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":"AACA,OAAO,EACL,yBAAyB,GAG1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,2BAA2B,EAAE,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAIC;IAED,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;QAC7C,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,KAAK;QACpC,WAAW,EAAE,IAAI;QACjB,SAAS;QACT,GAAG,EAAE,OAAO,EAAE,GAAG;QACjB,aAAa,EAAE,OAAO,EAAE,aAAa;KACtC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { ChapterTrace, ContextPackage, RuleStack } from "../models/input-governance.js";
+import type { PlanChapterOutput } from "../agents/planner.js";
+/**
+ * Compose the per-chapter rule stack used by writer / continuity / reviser
+ * prompts. Source names follow the Phase 5 layout (story_frame, volume_map,
+ * roles/) and activeOverrides are derived from the planner's intent so the
+ * "Governed Control Stack" block surfaces the actual gating in effect for
+ * the current chapter — it used to be a static stub that ignored both
+ * `plan` and `chapterNumber`.
+ *
+ * Phase hotfix 6 (Option A): make this honestly dynamic instead of deleting
+ * it, because writer.ts (~L820/L900), continuity.ts (~L590), and
+ * reviser.ts (~L600) all render ruleStack.sections / activeOverrides into
+ * the model prompt. Removing the function would require a much larger
+ * prompt refactor; making it real fixes the lie at the source.
+ */
+export declare function buildGovernedRuleStack(plan: PlanChapterOutput, chapterNumber: number): RuleStack;
+export declare function buildGovernedTrace(params: {
+    readonly chapterNumber: number;
+    readonly plan: PlanChapterOutput;
+    readonly contextPackage: ContextPackage;
+    readonly composerInputs: ReadonlyArray<string>;
+    readonly notes?: ReadonlyArray<string>;
+    readonly promptPacks?: ReadonlyArray<string>;
+    readonly compression?: ChapterTrace["compression"];
+    readonly retrieval?: ChapterTrace["retrieval"];
+}): ChapterTrace;
+export declare function isProtectedContextSource(source: string): boolean;
+//# sourceMappingURL=context-assembly.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembly.d.ts","sourceRoot":"","sources":["../../src/utils/context-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,cAAc,EACd,SAAS,EACV,MAAM,+BAA+B,CAAC;AAMvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAW9D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,CA+ChG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;CAChD,GAAG,YAAY,CA6Bf;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAgBhE"}

package/dist/utils/context-assembly.js

@@ -0,0 +1,117 @@
+import { estimateTextTokens } from "../llm/provider.js";
+import { ChapterTraceSchema, RuleStackSchema, } from "../models/input-governance.js";
+const MAX_OVERRIDE_REASON_CHARS = 80;
+function truncateForOverrideReason(value) {
+    const collapsed = value.replace(/\s+/g, " ").trim();
+    return collapsed.length > MAX_OVERRIDE_REASON_CHARS
+        ? `${collapsed.slice(0, MAX_OVERRIDE_REASON_CHARS - 1)}…`
+        : collapsed;
+}
+/**
+ * Compose the per-chapter rule stack used by writer / continuity / reviser
+ * prompts. Source names follow the Phase 5 layout (story_frame, volume_map,
+ * roles/) and activeOverrides are derived from the planner's intent so the
+ * "Governed Control Stack" block surfaces the actual gating in effect for
+ * the current chapter — it used to be a static stub that ignored both
+ * `plan` and `chapterNumber`.
+ *
+ * Phase hotfix 6 (Option A): make this honestly dynamic instead of deleting
+ * it, because writer.ts (~L820/L900), continuity.ts (~L590), and
+ * reviser.ts (~L600) all render ruleStack.sections / activeOverrides into
+ * the model prompt. Removing the function would require a much larger
+ * prompt refactor; making it real fixes the lie at the source.
+ */
+export function buildGovernedRuleStack(plan, chapterNumber) {
+    const activeOverrides = [];
+    // L4 → L3: per-chapter prohibitions narrow the planning layer for this
+    // chapter only. mustAvoid items come from rules-reader prohibitions +
+    // current_focus avoid section (planner.collectMustAvoid).
+    for (const item of plan.intent.mustAvoid) {
+        activeOverrides.push({
+            from: "L4",
+            to: "L3",
+            target: `chapter:${chapterNumber}/mustAvoid`,
+            reason: truncateForOverrideReason(item),
+        });
+    }
+    // L4 → L3: planner-issued style emphasis is also a per-chapter override
+    // on the planning layer. Style emphasis surfaces things like POV tightness
+    // or character-conflict focus that the writer must honor this chapter.
+    for (const item of plan.intent.styleEmphasis) {
+        activeOverrides.push({
+            from: "L4",
+            to: "L3",
+            target: `chapter:${chapterNumber}/styleEmphasis`,
+            reason: truncateForOverrideReason(item),
+        });
+    }
+    return RuleStackSchema.parse({
+        layers: [
+            { id: "L1", name: "hard_facts", precedence: 100, scope: "global" },
+            { id: "L2", name: "author_intent", precedence: 80, scope: "book" },
+            { id: "L3", name: "planning", precedence: 60, scope: "arc" },
+            { id: "L4", name: "current_task", precedence: 70, scope: "local" },
+        ],
+        sections: {
+            // Phase 5 authoritative source names (was: story_bible, volume_outline).
+            hard: ["story_frame", "current_state", "book_rules", "roles"],
+            soft: ["author_intent", "current_focus", "volume_map"],
+            diagnostic: ["anti_ai_checks", "continuity_audit", "style_regression_checks"],
+        },
+        overrideEdges: [
+            { from: "L4", to: "L3", allowed: true, scope: "current_chapter" },
+            { from: "L4", to: "L2", allowed: false, scope: "current_chapter" },
+            { from: "L4", to: "L1", allowed: false, scope: "current_chapter" },
+        ],
+        activeOverrides,
+    });
+}
+export function buildGovernedTrace(params) {
+    const protectedEntries = params.contextPackage.selectedContext.filter((entry) => isProtectedContextSource(entry.source));
+    const compressibleEntries = params.contextPackage.selectedContext.filter((entry) => !isProtectedContextSource(entry.source));
+    const protectedTokens = sumContextTokens(protectedEntries);
+    const compressibleTokens = sumContextTokens(compressibleEntries);
+    return ChapterTraceSchema.parse({
+        chapter: params.chapterNumber,
+        plannerInputs: params.plan.plannerInputs,
+        composerInputs: params.composerInputs,
+        selectedSources: params.contextPackage.selectedContext.map((entry) => entry.source),
+        promptPacks: params.promptPacks ?? [],
+        contextTiers: {
+            protectedSources: protectedEntries.map((entry) => entry.source),
+            compressibleSources: compressibleEntries.map((entry) => entry.source),
+        },
+        tokenBudget: {
+            protectedTokens,
+            compressibleTokens,
+            totalSelectedTokens: protectedTokens + compressibleTokens,
+        },
+        ...(params.compression ? { compression: params.compression } : {}),
+        ...(params.retrieval ? { retrieval: params.retrieval } : {}),
+        notes: params.notes ?? [],
+    });
+}
+export function isProtectedContextSource(source) {
+    return source === "runtime/chapter_memo"
+        || source === "story/current_focus.md"
+        || source === "story/author_intent.md"
+        || source === "story/audit_drift.md"
+        || source === "story/outline/story_frame.md"
+        || source.startsWith("story/outline/story_frame.md#")
+        || source === "story/story_bible.md"
+        || source === "story/outline/volume_map.md"
+        || source.startsWith("story/outline/volume_map.md#")
+        || source === "story/volume_outline.md"
+        || source === "story/parent_canon.md"
+        || source === "story/fanfic_canon.md"
+        || source.startsWith("story/current_state.md")
+        || source.startsWith("story/pending_hooks.md#")
+        || source.startsWith("runtime/hook_debt#");
+}
+function sumContextTokens(entries) {
+    return entries.reduce((total, entry) => total + estimateContextSourceTokens(entry), 0);
+}
+function estimateContextSourceTokens(entry) {
+    return estimateTextTokens([entry.source, entry.reason, entry.excerpt].filter(Boolean).join("\n"));
+}
+//# sourceMappingURL=context-assembly.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+export interface ContextCapOptions {
+    readonly label: string;
+    readonly maxChars: number;
+    readonly headRatio?: number;
+}
+/**
+ * Cap a large context block while keeping the durable setup at the beginning
+ * and the latest tail. This prevents long-running books from sending full truth
+ * files every chapter while still making the omission visible to the model.
+ */
+export declare function capContextBlock(content: string, options: ContextCapOptions): string;
+/** 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,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAmBnF;AAED,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,163 @@
+/**
+ * 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";
+/**
+ * Cap a large context block while keeping the durable setup at the beginning
+ * and the latest tail. This prevents long-running books from sending full truth
+ * files every chapter while still making the omission visible to the model.
+ */
+export function capContextBlock(content, options) {
+    if (!content || content === "(文件尚未创建)")
+        return content;
+    const maxChars = Math.floor(options.maxChars);
+    if (maxChars <= 0)
+        return "";
+    if (content.length <= maxChars)
+        return content;
+    const omitted = content.length - maxChars;
+    const note = `\n\n[InkOS context budget: omitted about ${omitted} chars from ${options.label}; kept beginning and latest tail.]\n\n`;
+    if (maxChars <= note.length + 2) {
+        return content.slice(0, maxChars);
+    }
+    const keepChars = maxChars - note.length;
+    const headRatio = clampRatio(options.headRatio ?? 0.45);
+    const headChars = Math.max(1, Math.floor(keepChars * headRatio));
+    const tailChars = Math.max(1, keepChars - headChars);
+    return `${content.slice(0, headChars)}${note}${content.slice(-tailChars)}`;
+}
+/** 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;
+}
+function clampRatio(value) {
+    if (!Number.isFinite(value))
+        return 0.45;
+    return Math.min(0.8, Math.max(0.2, value));
+}
+// ---------------------------------------------------------------------------
+// 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":"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"}

package/dist/utils/effective-llm-config.d.ts

@@ -0,0 +1,34 @@
+import { type LLMConfig, type ProjectConfig } from "../models/project.js";
+import { type LLMEnvLayers } from "./llm-env.js";
+export type LLMConsumer = "studio" | "cli" | "daemon" | "deploy";
+export type LLMConfigMode = "studio-project" | "cli-project" | "legacy-env";
+export type LLMValueSource = "project" | "studio-secret" | "env" | "cli" | "default";
+export interface LLMConfigCliOverrides {
+    readonly service?: string;
+    readonly model?: string;
+    readonly apiKeyEnv?: string;
+    readonly baseUrl?: string;
+    readonly apiFormat?: "chat" | "responses";
+    readonly stream?: boolean;
+}
+export interface ResolveEffectiveLLMConfigInput {
+    readonly consumer: LLMConsumer;
+    readonly projectRoot: string;
+    readonly envLayers: LLMEnvLayers;
+    readonly cli?: LLMConfigCliOverrides;
+    readonly requireApiKey?: boolean;
+}
+export interface EffectiveLLMDiagnostics {
+    readonly configMode: LLMConfigMode;
+    readonly serviceSource: LLMValueSource;
+    readonly modelSource: LLMValueSource;
+    readonly apiKeySource: LLMValueSource;
+    readonly warnings: readonly string[];
+}
+export interface EffectiveLLMConfigResult {
+    readonly config: ProjectConfig;
+    readonly llm: LLMConfig;
+    readonly diagnostics: EffectiveLLMDiagnostics;
+}
+export declare function resolveEffectiveLLMConfig(input: ResolveEffectiveLLMConfigInput): Promise<EffectiveLLMConfigResult>;
+//# sourceMappingURL=effective-llm-config.d.ts.map

package/dist/utils/effective-llm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-llm-config.d.ts","sourceRoot":"","sources":["../../src/utils/effective-llm-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK/F,OAAO,EAA8C,KAAK,YAAY,EAAkB,MAAM,cAAc,CAAC;AAE7G,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAErF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;CAC/C;AAqBD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CAsDnC"}