@actalk/inkos-core 0.5.1 → 0.6.0

package/dist/utils/governed-working-set.js

@@ -0,0 +1,295 @@
+import { isHookWithinChapterWindow, parsePendingHooksMarkdown, renderHookSnapshot, } from "./memory-retrieval.js";
+export function buildGovernedHookWorkingSet(params) {
+    const { hooksMarkdown } = params;
+    if (!hooksMarkdown || hooksMarkdown === "(文件不存在)" || hooksMarkdown === "(文件尚未创建)") {
+        return hooksMarkdown;
+    }
+    const hooks = parsePendingHooksMarkdown(hooksMarkdown);
+    if (hooks.length === 0) {
+        return hooksMarkdown;
+    }
+    const selectedIds = new Set(params.contextPackage.selectedContext
+        .filter((entry) => entry.source.startsWith("story/pending_hooks.md#"))
+        .map((entry) => entry.source.slice("story/pending_hooks.md#".length))
+        .filter(Boolean));
+    const agendaIds = collectHookAgendaIds(params.chapterIntent);
+    const workingSet = hooks.filter((hook) => selectedIds.has(hook.hookId)
+        || agendaIds.has(hook.hookId)
+        || isHookWithinChapterWindow(hook, params.chapterNumber, params.keepRecent ?? 5));
+    if (workingSet.length === 0 || workingSet.length >= hooks.length) {
+        return hooksMarkdown;
+    }
+    return renderHookSnapshot(workingSet, params.language);
+}
+function collectHookAgendaIds(chapterIntent) {
+    if (!chapterIntent || chapterIntent.trim().length === 0) {
+        return new Set();
+    }
+    const ids = new Set();
+    const lines = chapterIntent.split("\n");
+    let inHookAgenda = false;
+    let captureIds = false;
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (line === "## Hook Agenda") {
+            inHookAgenda = true;
+            captureIds = false;
+            continue;
+        }
+        if (!inHookAgenda) {
+            continue;
+        }
+        if (line.startsWith("## ") && line !== "## Hook Agenda") {
+            break;
+        }
+        if (line === "### Must Advance" || line === "### Eligible Resolve" || line === "### Stale Debt") {
+            captureIds = true;
+            continue;
+        }
+        if (line.startsWith("### ")) {
+            captureIds = false;
+            continue;
+        }
+        if (!captureIds || !line.startsWith("- ")) {
+            continue;
+        }
+        const value = line.slice(2).trim();
+        if (value && value.toLowerCase() !== "none") {
+            ids.add(value);
+        }
+    }
+    return ids;
+}
+export function mergeTableMarkdownByKey(original, updated, keyColumns) {
+    const originalTable = parseSingleTable(original);
+    const updatedTable = parseSingleTable(updated);
+    if (!originalTable || !updatedTable || updatedTable.dataRows.length === 0) {
+        return updated;
+    }
+    const mergedRows = [...originalTable.dataRows];
+    const originalIndex = new Map();
+    mergedRows.forEach((row, index) => {
+        originalIndex.set(buildKey(row, keyColumns), index);
+    });
+    for (const row of updatedTable.dataRows) {
+        const key = buildKey(row, keyColumns);
+        const existing = originalIndex.get(key);
+        if (existing === undefined) {
+            originalIndex.set(key, mergedRows.length);
+            mergedRows.push(row);
+        }
+        else {
+            mergedRows[existing] = row;
+        }
+    }
+    return [
+        ...pickScaffold(originalTable.leadingLines, updatedTable.leadingLines),
+        ...mergedRows.map(renderRow),
+        ...pickScaffold(originalTable.trailingLines, updatedTable.trailingLines),
+    ].join("\n").trimEnd();
+}
+export function mergeCharacterMatrixMarkdown(original, updated) {
+    const originalSections = parseSections(original);
+    const updatedSections = parseSections(updated);
+    if (originalSections.sections.length === 0 || updatedSections.sections.length === 0) {
+        return updated;
+    }
+    const sectionKeyColumns = [
+        [0],
+        [0, 1],
+        [0, 3],
+    ];
+    const mergedSections = originalSections.sections.map((section, index) => {
+        const next = updatedSections.sections[index];
+        if (!next)
+            return section;
+        const keyColumns = sectionKeyColumns[index] ?? [0];
+        return {
+            heading: section.heading,
+            body: mergeTableMarkdownByKey(section.body, next.body, keyColumns),
+        };
+    });
+    for (let index = originalSections.sections.length; index < updatedSections.sections.length; index += 1) {
+        mergedSections.push(updatedSections.sections[index]);
+    }
+    return [
+        ...pickScaffold(originalSections.topLines, updatedSections.topLines),
+        ...mergedSections.flatMap((section) => [section.heading, section.body]),
+    ].join("\n").trimEnd();
+}
+export function buildGovernedCharacterMatrixWorkingSet(params) {
+    const { matrixMarkdown } = params;
+    if (!matrixMarkdown || matrixMarkdown === "(文件不存在)" || matrixMarkdown === "(文件尚未创建)") {
+        return matrixMarkdown;
+    }
+    const parsed = parseSections(matrixMarkdown);
+    if (parsed.sections.length === 0) {
+        return matrixMarkdown;
+    }
+    const activeNames = collectGovernedCharacterNames(params);
+    const filteredSections = parsed.sections.map((section, index) => ({
+        heading: section.heading,
+        body: filterMatrixSection(section.body, index, activeNames),
+    }));
+    return [
+        ...parsed.topLines,
+        ...filteredSections.flatMap((section) => [section.heading, section.body]),
+    ].join("\n").trimEnd();
+}
+function parseSingleTable(content) {
+    const lines = content.split("\n");
+    const tableIndexes = lines
+        .map((line, index) => ({ line, index }))
+        .filter((entry) => entry.line.trim().startsWith("|"))
+        .map((entry) => entry.index);
+    if (tableIndexes.length === 0)
+        return null;
+    const headerStart = tableIndexes[0];
+    const nextIndex = tableIndexes[1];
+    const headerEnd = nextIndex !== undefined && lines[nextIndex].includes("---")
+        ? nextIndex
+        : headerStart;
+    const dataIndexes = tableIndexes.filter((index) => index > headerEnd);
+    const lastDataIndex = dataIndexes.length > 0 ? dataIndexes[dataIndexes.length - 1] : headerEnd;
+    return {
+        leadingLines: lines.slice(0, headerEnd + 1),
+        dataRows: dataIndexes.map((index) => parseRow(lines[index])),
+        trailingLines: lines.slice(lastDataIndex + 1),
+    };
+}
+function parseSections(content) {
+    const lines = content.split("\n");
+    const topLines = [];
+    const sections = [];
+    let currentHeading = null;
+    let currentBody = [];
+    const flush = () => {
+        if (!currentHeading)
+            return;
+        sections.push({
+            heading: currentHeading,
+            body: currentBody.join("\n").trimEnd(),
+        });
+    };
+    for (const line of lines) {
+        if (line.startsWith("### ")) {
+            flush();
+            currentHeading = line;
+            currentBody = [];
+            continue;
+        }
+        if (currentHeading) {
+            currentBody.push(line);
+        }
+        else {
+            topLines.push(line);
+        }
+    }
+    flush();
+    return { topLines, sections };
+}
+function parseRow(line) {
+    return line
+        .split("|")
+        .slice(1, -1)
+        .map((cell) => cell.trim());
+}
+function renderRow(row) {
+    return `| ${row.join(" | ")} |`;
+}
+function buildKey(row, keyColumns) {
+    return keyColumns.map((index) => row[index] ?? "").join("::");
+}
+function pickScaffold(primary, fallback) {
+    return primary.length > 0 ? primary : fallback;
+}
+function collectGovernedCharacterNames(params) {
+    const candidates = extractCharacterCandidatesFromMatrix(params.matrixMarkdown);
+    const corpus = [
+        params.chapterIntent,
+        ...params.contextPackage.selectedContext.flatMap((entry) => [
+            entry.reason,
+            entry.excerpt ?? "",
+        ]),
+    ].join("\n");
+    const activeNames = new Set();
+    for (const candidate of candidates) {
+        if (params.protagonistName && matchesName(candidate, params.protagonistName)) {
+            activeNames.add(candidate);
+            continue;
+        }
+        if (isNameMentioned(candidate, corpus)) {
+            activeNames.add(candidate);
+        }
+    }
+    if (params.protagonistName) {
+        for (const candidate of candidates) {
+            if (matchesName(candidate, params.protagonistName)) {
+                activeNames.add(candidate);
+            }
+        }
+    }
+    return activeNames;
+}
+function extractCharacterCandidatesFromMatrix(matrixMarkdown) {
+    const parsed = parseSections(matrixMarkdown);
+    const names = new Set();
+    parsed.sections.forEach((section, index) => {
+        const table = parseSingleTable(section.body);
+        if (!table)
+            return;
+        for (const row of table.dataRows) {
+            const candidates = index === 1
+                ? [row[0], row[1]]
+                : [row[0]];
+            for (const candidate of candidates) {
+                const normalized = candidate?.trim();
+                if (normalized) {
+                    names.add(normalized);
+                }
+            }
+        }
+    });
+    return [...names];
+}
+function filterMatrixSection(sectionBody, sectionIndex, activeNames) {
+    const table = parseSingleTable(sectionBody);
+    if (!table) {
+        return sectionBody;
+    }
+    const filteredRows = table.dataRows.filter((row) => {
+        if (row.length === 0)
+            return false;
+        if (sectionIndex === 1) {
+            const left = row[0] ?? "";
+            const right = row[1] ?? "";
+            return activeNames.has(left) && (right.length === 0 || activeNames.has(right));
+        }
+        return activeNames.has(row[0] ?? "");
+    });
+    return [
+        ...table.leadingLines,
+        ...filteredRows.map(renderRow),
+        ...table.trailingLines,
+    ].join("\n").trimEnd();
+}
+function isNameMentioned(candidate, corpus) {
+    if (!candidate || !corpus)
+        return false;
+    if (containsCjk(candidate)) {
+        return corpus.includes(candidate);
+    }
+    return new RegExp(`\\b${escapeRegExp(candidate)}\\b`, "i").test(corpus);
+}
+function matchesName(left, right) {
+    if (!left || !right)
+        return false;
+    return left.trim().toLowerCase() === right.trim().toLowerCase();
+}
+function containsCjk(value) {
+    return /[\u4e00-\u9fff]/.test(value);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=governed-working-set.js.map

package/dist/utils/governed-working-set.js.map

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

package/dist/utils/hook-governance.d.ts

@@ -0,0 +1,26 @@
+import type { HookRecord, RuntimeStateDelta } from "../models/runtime-state.js";
+export type HookDisposition = "none" | "mention" | "advance" | "resolve" | "defer";
+export interface HookAdmissionCandidate {
+    readonly type: string;
+    readonly expectedPayoff?: string;
+    readonly notes?: string;
+}
+export interface HookAdmissionDecision {
+    readonly admit: boolean;
+    readonly reason: "admit" | "missing_type" | "missing_payoff_signal" | "duplicate_family";
+    readonly matchedHookId?: string;
+}
+export declare function collectStaleHookDebt(params: {
+    readonly hooks: ReadonlyArray<HookRecord>;
+    readonly chapterNumber: number;
+    readonly staleAfterChapters?: number;
+}): HookRecord[];
+export declare function evaluateHookAdmission(params: {
+    readonly candidate: HookAdmissionCandidate;
+    readonly activeHooks: ReadonlyArray<HookRecord>;
+}): HookAdmissionDecision;
+export declare function classifyHookDisposition(params: {
+    readonly hookId: string;
+    readonly delta: Pick<RuntimeStateDelta, "chapter" | "hookOps">;
+}): HookDisposition;
+//# sourceMappingURL=hook-governance.d.ts.map

package/dist/utils/hook-governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-governance.d.ts","sourceRoot":"","sources":["../../src/utils/hook-governance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEhF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,GAAG,uBAAuB,GAAG,kBAAkB,CAAC;IACzF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC,GAAG,UAAU,EAAE,CAaf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD,GAAG,qBAAqB,CAmExB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;CAChE,GAAG,eAAe,CAoBlB"}

package/dist/utils/hook-governance.js

@@ -0,0 +1,128 @@
+export function collectStaleHookDebt(params) {
+    const staleAfterChapters = params.staleAfterChapters ?? 10;
+    const staleCutoff = params.chapterNumber - staleAfterChapters;
+    return params.hooks
+        .filter((hook) => hook.status !== "resolved" && hook.status !== "deferred")
+        .filter((hook) => hook.startChapter <= params.chapterNumber)
+        .filter((hook) => hook.lastAdvancedChapter <= staleCutoff)
+        .sort((left, right) => (left.lastAdvancedChapter - right.lastAdvancedChapter
+        || left.startChapter - right.startChapter
+        || left.hookId.localeCompare(right.hookId)));
+}
+export function evaluateHookAdmission(params) {
+    const candidateType = normalizeText(params.candidate.type);
+    if (!candidateType) {
+        return {
+            admit: false,
+            reason: "missing_type",
+        };
+    }
+    const payoffSignal = [params.candidate.expectedPayoff, params.candidate.notes]
+        .filter((value) => Boolean(value && value.trim()))
+        .join(" ")
+        .trim();
+    if (!payoffSignal) {
+        return {
+            admit: false,
+            reason: "missing_payoff_signal",
+        };
+    }
+    const candidateNormalized = normalizeText([
+        params.candidate.type,
+        params.candidate.expectedPayoff ?? "",
+        params.candidate.notes ?? "",
+    ].join(" "));
+    const candidateTerms = extractTerms(candidateNormalized);
+    const candidateChineseBigrams = extractChineseBigrams(candidateNormalized);
+    for (const hook of params.activeHooks) {
+        const activeNormalized = normalizeText([
+            hook.type,
+            hook.expectedPayoff,
+            hook.notes,
+        ].join(" "));
+        if (candidateNormalized === activeNormalized) {
+            return {
+                admit: false,
+                reason: "duplicate_family",
+                matchedHookId: hook.hookId,
+            };
+        }
+        if (candidateType !== normalizeText(hook.type)) {
+            continue;
+        }
+        const activeTerms = extractTerms(activeNormalized);
+        const overlap = [...candidateTerms].filter((term) => activeTerms.has(term));
+        const activeChineseBigrams = extractChineseBigrams(activeNormalized);
+        const chineseOverlap = [...candidateChineseBigrams].filter((term) => activeChineseBigrams.has(term));
+        if (overlap.length >= 2 || chineseOverlap.length >= 3) {
+            return {
+                admit: false,
+                reason: "duplicate_family",
+                matchedHookId: hook.hookId,
+            };
+        }
+    }
+    return {
+        admit: true,
+        reason: "admit",
+    };
+}
+export function classifyHookDisposition(params) {
+    const { hookId, delta } = params;
+    if (delta.hookOps.defer.includes(hookId)) {
+        return "defer";
+    }
+    if (delta.hookOps.resolve.includes(hookId)) {
+        return "resolve";
+    }
+    if (delta.hookOps.upsert.some((hook) => hook.hookId === hookId && hook.lastAdvancedChapter === delta.chapter)) {
+        return "advance";
+    }
+    if (delta.hookOps.mention.includes(hookId)) {
+        return "mention";
+    }
+    return "none";
+}
+function normalizeText(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9\u4e00-\u9fff]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function extractTerms(value) {
+    const english = value
+        .split(" ")
+        .map((term) => term.trim())
+        .filter((term) => term.length >= 4)
+        .filter((term) => !STOP_WORDS.has(term));
+    const chinese = value.match(/[\u4e00-\u9fff]{2,6}/g) ?? [];
+    return new Set([...english, ...chinese]);
+}
+function extractChineseBigrams(value) {
+    const segments = value.match(/[\u4e00-\u9fff]+/g) ?? [];
+    const terms = new Set();
+    for (const segment of segments) {
+        if (segment.length < 2) {
+            continue;
+        }
+        for (let index = 0; index <= segment.length - 2; index += 1) {
+            terms.add(segment.slice(index, index + 2));
+        }
+    }
+    return terms;
+}
+const STOP_WORDS = new Set([
+    "that",
+    "this",
+    "with",
+    "from",
+    "into",
+    "still",
+    "just",
+    "have",
+    "will",
+    "reveal",
+]);
+//# sourceMappingURL=hook-governance.js.map

package/dist/utils/hook-governance.js.map

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

package/dist/utils/hook-health.d.ts

@@ -0,0 +1,14 @@
+import type { AuditIssue } from "../agents/continuity.js";
+import type { HookRecord, RuntimeStateDelta } from "../models/runtime-state.js";
+export declare function analyzeHookHealth(params: {
+    readonly language: "zh" | "en";
+    readonly chapterNumber: number;
+    readonly hooks: ReadonlyArray<HookRecord>;
+    readonly delta?: Pick<RuntimeStateDelta, "chapter" | "hookOps">;
+    readonly existingHookIds?: ReadonlyArray<string>;
+    readonly maxActiveHooks?: number;
+    readonly staleAfterChapters?: number;
+    readonly noAdvanceWindow?: number;
+    readonly newHookBurstThreshold?: number;
+}): AuditIssue[];
+//# sourceMappingURL=hook-health.d.ts.map

package/dist/utils/hook-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-health.d.ts","sourceRoot":"","sources":["../../src/utils/hook-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGhF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;IAChE,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,UAAU,EAAE,CAoFf"}

package/dist/utils/hook-health.js

@@ -0,0 +1,68 @@
+import { classifyHookDisposition, collectStaleHookDebt } from "./hook-governance.js";
+export function analyzeHookHealth(params) {
+    const maxActiveHooks = params.maxActiveHooks ?? 12;
+    const staleAfterChapters = params.staleAfterChapters ?? 10;
+    const noAdvanceWindow = params.noAdvanceWindow ?? 5;
+    const newHookBurstThreshold = params.newHookBurstThreshold ?? 2;
+    const issues = [];
+    const activeHooks = params.hooks.filter((hook) => hook.status !== "resolved");
+    if (activeHooks.length > maxActiveHooks) {
+        issues.push(warning(params.language, params.language === "en"
+            ? `There are ${activeHooks.length} active hooks, above the recommended cap of ${maxActiveHooks}.`
+            : `当前有 ${activeHooks.length} 个活跃伏笔，已经高于建议上限 ${maxActiveHooks} 个。`, params.language === "en"
+            ? "Prefer advancing, resolving, or deferring existing debt before opening more hooks."
+            : "优先推进、回收或延后已有伏笔，再继续开新伏笔。"));
+    }
+    const latestRealAdvance = activeHooks.reduce((max, hook) => Math.max(max, hook.lastAdvancedChapter), 0);
+    if (activeHooks.length > 0 && params.chapterNumber - latestRealAdvance >= noAdvanceWindow) {
+        issues.push(warning(params.language, params.language === "en"
+            ? `No real hook advancement has landed for ${params.chapterNumber - latestRealAdvance} chapters.`
+            : `已经连续 ${params.chapterNumber - latestRealAdvance} 章没有真实伏笔推进。`, params.language === "en"
+            ? "Schedule one old hook for real movement instead of opening parallel restatements."
+            : "下一章优先让一个旧伏笔发生真实推进，而不是继续平行重述。"));
+    }
+    const staleHooks = collectStaleHookDebt({
+        hooks: activeHooks,
+        chapterNumber: params.chapterNumber,
+        staleAfterChapters,
+    });
+    if (params.delta && staleHooks.length > 0) {
+        const untouchedStale = staleHooks.filter((hook) => {
+            const disposition = classifyHookDisposition({
+                hookId: hook.hookId,
+                delta: params.delta,
+            });
+            return disposition === "none" || disposition === "mention";
+        });
+        if (untouchedStale.length > 0) {
+            issues.push(warning(params.language, params.language === "en"
+                ? `Stale hooks received no real disposition this chapter: ${untouchedStale.map((hook) => hook.hookId).join(", ")}.`
+                : `本章没有真正处理这些陈旧伏笔：${untouchedStale.map((hook) => hook.hookId).join("、")}。`, params.language === "en"
+                ? "Advance, resolve, or explicitly defer at least one stale hook."
+                : "至少推进、回收或明确延后一个陈旧伏笔。"));
+        }
+    }
+    if (params.delta) {
+        const existingHookIds = new Set(params.existingHookIds ?? []);
+        const newHookIds = params.delta.hookOps.upsert
+            .map((hook) => hook.hookId)
+            .filter((hookId) => !existingHookIds.has(hookId));
+        if (newHookIds.length >= newHookBurstThreshold && params.delta.hookOps.resolve.length === 0) {
+            issues.push(warning(params.language, params.language === "en"
+                ? `Opened ${newHookIds.length} new hooks without resolving any older debt.`
+                : `本章新开了 ${newHookIds.length} 个伏笔，但没有回收任何旧债。`, params.language === "en"
+                ? "Keep the hook table from ballooning by pairing new openings with old payoffs."
+                : "控制伏笔膨胀，新开伏笔时尽量配套回收旧伏笔。"));
+        }
+    }
+    return issues;
+}
+function warning(language, description, suggestion) {
+    return {
+        severity: "warning",
+        category: language === "en" ? "Hook Debt" : "伏笔债务",
+        description,
+        suggestion,
+    };
+}
+//# sourceMappingURL=hook-health.js.map

package/dist/utils/hook-health.js.map

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

package/dist/utils/length-metrics.d.ts

@@ -0,0 +1,10 @@
+import type { LengthCountingMode, LengthNormalizeMode, LengthSpec } from "../models/length-governance.js";
+export type LengthLanguage = "zh" | "en";
+export declare function countChapterLength(content: string, countingMode: LengthCountingMode): number;
+export declare function resolveLengthCountingMode(language?: LengthLanguage): LengthCountingMode;
+export declare function formatLengthCount(count: number, countingMode: LengthCountingMode): string;
+export declare function buildLengthSpec(target: number, language?: LengthLanguage): LengthSpec;
+export declare function isOutsideSoftRange(count: number, spec: Pick<LengthSpec, "softMin" | "softMax">): boolean;
+export declare function isOutsideHardRange(count: number, spec: Pick<LengthSpec, "hardMin" | "hardMax">): boolean;
+export declare function chooseNormalizeMode(count: number, spec: Pick<LengthSpec, "softMin" | "softMax">): LengthNormalizeMode;
+//# sourceMappingURL=length-metrics.d.ts.map

package/dist/utils/length-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length-metrics.d.ts","sourceRoot":"","sources":["../../src/utils/length-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE1G,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AAMzC,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,kBAAkB,GAC/B,MAAM,CASR;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,GAAE,cAAqB,GAC9B,kBAAkB,CAEpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,kBAAkB,GAC/B,MAAM,CAER;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,cAAqB,GAC9B,UAAU,CAiBZ;AAMD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC,GAC5C,OAAO,CAET;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC,GAC5C,OAAO,CAET;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC,GAC5C,mBAAmB,CAIrB"}