@kienmatu/inkos-core 0.1.0

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

@@ -0,0 +1,296 @@
+import { parsePendingHooksMarkdown, renderHookSnapshot, } from "./memory-retrieval.js";
+import { isHookWithinChapterWindow, } from "./hook-lifecycle.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":"AACA,OAAO,EACL,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,2BAA2B,CAAC,MAO3C;IACC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IACjC,IAAI,CAAC,aAAa,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,UAAU,EAAE,CAAC;QAClF,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,MAAM,CAAC,cAAc,CAAC,eAAe;SAClC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;SACrE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;SACpE,MAAM,CAAC,OAAO,CAAC,CACnB,CAAC;IACF,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;WACvB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;WAC1B,yBAAyB,CACxB,IAAI,EACJ,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,UAAU,IAAI,CAAC,CACvB,CACN,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjE,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,oBAAoB,CAAC,aAAsB;IAClD,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC9B,YAAY,GAAG,IAAI,CAAC;YACpB,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACxD,MAAM;QACR,CAAC;QAED,IAAI,IAAI,KAAK,kBAAkB,IAAI,IAAI,KAAK,sBAAsB,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAChG,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,UAAU,GAAG,KAAK,CAAC;YACnB,SAAS;QACX,CAAC;QAED,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YAC5C,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,OAAe,EACf,UAAiC;IAEjC,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,aAAa,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAChC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;YAC1C,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,YAAY,CAAC,aAAa,CAAC,YAAY,EAAE,YAAY,CAAC,YAAY,CAAC;QACtE,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QAC5B,GAAG,YAAY,CAAC,aAAa,CAAC,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC;KACzE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,QAAgB,EAAE,OAAe;IAC5E,MAAM,gBAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,iBAAiB,GAAyC;QAC9D,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,CAAC;QACN,CAAC,CAAC,EAAE,CAAC,CAAC;KACP,CAAC;IAEF,MAAM,cAAc,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACtE,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC;QAE1B,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,uBAAuB,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;SACnE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,KAAK,IAAI,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvG,cAAc,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAE,CAAC,CAAC;IACxD,CAAC;IAED,OAAO;QACL,GAAG,YAAY,CAAC,gBAAgB,CAAC,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC;QACpE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;KACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,MAKtD;IACC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC,cAAc,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;QACrF,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,WAAW,GAAG,6BAA6B,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC;KAC5D,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,GAAG,MAAM,CAAC,QAAQ;QAClB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC;AAQD,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,YAAY,GAAG,KAAK;SACvB,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;SACvC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACpD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAE,CAAC;IACrC,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC5E,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,WAAW,CAAC;IAChB,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhG,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC;QAC3C,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,CAAC;QAC7D,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IAIpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAA6C,EAAE,CAAC;IAC9D,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,WAAW,GAAa,EAAE,CAAC;IAE/B,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC,cAAc;YAAE,OAAO;QAC5B,QAAQ,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,cAAc;YACvB,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE;SACvC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,KAAK,EAAE,CAAC;YACR,cAAc,GAAG,IAAI,CAAC;YACtB,WAAW,GAAG,EAAE,CAAC;YACjB,SAAS;QACX,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACnB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SACZ,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,SAAS,CAAC,GAA0B;IAC3C,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,GAA0B,EAAE,UAAiC;IAC7E,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CAAC,OAAiB,EAAE,QAAkB;IACzD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjD,CAAC;AAED,SAAS,6BAA6B,CAAC,MAKtC;IACC,MAAM,UAAU,GAAG,oCAAoC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG;QACb,MAAM,CAAC,aAAa;QACpB,GAAG,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1D,KAAK,CAAC,MAAM;YACZ,KAAK,CAAC,OAAO,IAAI,EAAE;SACpB,CAAC;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,eAAe,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7E,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,IAAI,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;YACvC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnD,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,oCAAoC,CAAC,cAAsB;IAClE,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,KAAK,KAAK,CAAC;gBAC5B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACb,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC;gBACrC,IAAI,UAAU,EAAE,CAAC;oBACf,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAmB,EACnB,YAAoB,EACpB,WAAgC;IAEhC,MAAM,KAAK,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACjD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAEnC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACjF,CAAC;QAED,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,KAAK,CAAC,YAAY;QACrB,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC;QAC9B,GAAG,KAAK,CAAC,aAAa;KACvB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB,EAAE,MAAc;IACxD,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAExC,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,16 @@
+import { type HookRecord, type NewHookCandidate, type RuntimeStateDelta } from "../models/runtime-state.js";
+export interface HookArbiterDecision {
+    readonly action: "created" | "rejected";
+    readonly reason: string;
+    readonly hookId?: string;
+    readonly candidate: NewHookCandidate;
+}
+export declare function arbitrateRuntimeStateDeltaHooks(params: {
+    readonly hooks: ReadonlyArray<HookRecord>;
+    readonly delta: RuntimeStateDelta;
+    readonly allowNewHooks?: boolean;
+}): {
+    readonly resolvedDelta: RuntimeStateDelta;
+    readonly decisions: ReadonlyArray<HookArbiterDecision>;
+};
+//# sourceMappingURL=hook-arbiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-arbiter.d.ts","sourceRoot":"","sources":["../../src/utils/hook-arbiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAKpC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAMD,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,GAAG;IACF,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;CACxD,CAuFA"}

package/dist/utils/hook-arbiter.js

@@ -0,0 +1,161 @@
+import { RuntimeStateDeltaSchema, } from "../models/runtime-state.js";
+import { normalizeHookId } from "./story-markdown.js";
+import { evaluateHookAdmission } from "./hook-governance.js";
+import { resolveHookPayoffTiming } from "./hook-lifecycle.js";
+export function arbitrateRuntimeStateDeltaHooks(params) {
+    const delta = RuntimeStateDeltaSchema.parse(params.delta);
+    const workingHooks = params.hooks.map((hook) => ({ ...hook }));
+    const knownHookIds = new Set(workingHooks.map((hook) => hook.hookId));
+    const upsertsById = new Map();
+    const mentions = new Set(delta.hookOps.mention);
+    const resolves = uniqueStrings(delta.hookOps.resolve);
+    const defers = uniqueStrings(delta.hookOps.defer);
+    const fallbackCandidates = [];
+    const decisions = [];
+    for (const hook of delta.hookOps.upsert) {
+        if (knownHookIds.has(hook.hookId)) {
+            const normalized = { ...hook };
+            upsertsById.set(normalized.hookId, normalized);
+            replaceWorkingHook(workingHooks, normalized);
+            continue;
+        }
+        fallbackCandidates.push({
+            type: hook.type,
+            expectedPayoff: hook.expectedPayoff,
+            notes: hook.notes,
+            preferredHookId: hook.hookId,
+        });
+    }
+    for (const candidate of [...fallbackCandidates, ...delta.newHookCandidates]) {
+        if (params.allowNewHooks === false) {
+            decisions.push({
+                action: "rejected",
+                reason: "new_hooks_disabled",
+                candidate,
+            });
+            continue;
+        }
+        const admission = evaluateHookAdmission({
+            candidate,
+        });
+        if (!admission.admit) {
+            decisions.push({
+                action: "rejected",
+                reason: admission.reason,
+                candidate,
+            });
+            continue;
+        }
+        const created = createCanonicalHook({
+            candidate,
+            chapter: delta.chapter,
+            existingIds: new Set([
+                ...workingHooks.map((hook) => hook.hookId),
+                ...upsertsById.keys(),
+            ]),
+        });
+        upsertsById.set(created.hookId, created);
+        workingHooks.push(created);
+        decisions.push({
+            action: "created",
+            reason: "admit",
+            hookId: created.hookId,
+            candidate,
+        });
+    }
+    const resolvedDelta = RuntimeStateDeltaSchema.parse({
+        ...delta,
+        hookOps: {
+            upsert: [...upsertsById.values()].sort(sortHooks),
+            mention: [...mentions]
+                .filter((hookId) => !upsertsById.has(hookId))
+                .filter((hookId) => !resolves.includes(hookId))
+                .filter((hookId) => !defers.includes(hookId))
+                .sort(),
+            resolve: resolves,
+            defer: defers,
+        },
+        newHookCandidates: [],
+    });
+    return {
+        resolvedDelta,
+        decisions,
+    };
+}
+function createCanonicalHook(params) {
+    return {
+        hookId: buildCanonicalHookId(params.candidate, params.existingIds),
+        startChapter: params.chapter,
+        type: params.candidate.type.trim(),
+        status: "open",
+        lastAdvancedChapter: params.chapter,
+        expectedPayoff: params.candidate.expectedPayoff.trim(),
+        payoffTiming: resolveHookPayoffTiming(params.candidate),
+        notes: params.candidate.notes.trim(),
+    };
+}
+function buildCanonicalHookId(candidate, existingIds) {
+    const preferred = normalizeHookId(candidate.preferredHookId);
+    if (preferred && !existingIds.has(preferred)) {
+        return preferred;
+    }
+    const base = slugifyHookStem([
+        candidate.type,
+        candidate.expectedPayoff,
+        candidate.notes,
+    ].join(" "));
+    let next = base;
+    let suffix = 2;
+    while (existingIds.has(next)) {
+        next = `${base}-${suffix}`;
+        suffix += 1;
+    }
+    return next;
+}
+function slugifyHookStem(value) {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9\u4e00-\u9fff]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    const englishTerms = (normalized.match(/[a-z0-9]{3,}/g) ?? [])
+        .filter((term) => !STOP_WORDS.has(term))
+        .slice(0, 5);
+    const chineseTerms = (normalized.match(/[\u4e00-\u9fff]{2,6}/g) ?? []).slice(0, 3);
+    const stem = [...englishTerms, ...chineseTerms].join("-").slice(0, 64).replace(/-+$/g, "");
+    return stem || "hook";
+}
+function replaceWorkingHook(workingHooks, hook) {
+    const index = workingHooks.findIndex((candidate) => candidate.hookId === hook.hookId);
+    if (index >= 0) {
+        workingHooks[index] = hook;
+        return;
+    }
+    workingHooks.push(hook);
+}
+function sortHooks(left, right) {
+    return left.startChapter - right.startChapter
+        || left.lastAdvancedChapter - right.lastAdvancedChapter
+        || left.hookId.localeCompare(right.hookId);
+}
+function uniqueStrings(values) {
+    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
+}
+const STOP_WORDS = new Set([
+    "that",
+    "this",
+    "with",
+    "from",
+    "into",
+    "still",
+    "just",
+    "have",
+    "will",
+    "reveal",
+    "about",
+    "already",
+    "question",
+    "chapter",
+]);
+//# sourceMappingURL=hook-arbiter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-arbiter.js","sourceRoot":"","sources":["../../src/utils/hook-arbiter.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 payoffTiming?: string;
+    readonly notes?: string;
+}
+export interface HookAdmissionDecision {
+    readonly admit: boolean;
+    readonly reason: "admit" | "missing_type" | "missing_payoff_signal";
+}
+export declare function collectStaleHookDebt(params: {
+    readonly hooks: ReadonlyArray<HookRecord>;
+    readonly chapterNumber: number;
+    readonly targetChapters?: number;
+    readonly staleAfterChapters?: number;
+}): HookRecord[];
+export declare function evaluateHookAdmission(params: {
+    readonly candidate: HookAdmissionCandidate;
+}): 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;AAGhF,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,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,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,CAAC;CACrE;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,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC,GAAG,UAAU,EAAE,CA2Bf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;CAC5C,GAAG,qBAAqB,CAyBxB;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,65 @@
+import { describeHookLifecycle } from "./hook-lifecycle.js";
+export function collectStaleHookDebt(params) {
+    return params.hooks
+        .filter((hook) => hook.status !== "resolved" && hook.status !== "deferred")
+        .filter((hook) => hook.startChapter <= params.chapterNumber)
+        .filter((hook) => {
+        const lifecycle = describeHookLifecycle({
+            payoffTiming: hook.payoffTiming,
+            expectedPayoff: hook.expectedPayoff,
+            notes: hook.notes,
+            startChapter: hook.startChapter,
+            lastAdvancedChapter: hook.lastAdvancedChapter,
+            status: hook.status,
+            chapterNumber: params.chapterNumber,
+            targetChapters: params.targetChapters,
+        });
+        if (params.staleAfterChapters !== undefined) {
+            return hook.lastAdvancedChapter <= params.chapterNumber - params.staleAfterChapters;
+        }
+        return lifecycle.stale || lifecycle.overdue;
+    })
+        .sort((left, right) => (left.lastAdvancedChapter - right.lastAdvancedChapter
+        || left.startChapter - right.startChapter
+        || left.hookId.localeCompare(right.hookId)));
+}
+export function evaluateHookAdmission(params) {
+    const candidateType = params.candidate.type.trim();
+    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",
+        };
+    }
+    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";
+}
+//# 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,15 @@
+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 targetChapters?: 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;AAKhF,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,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,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,CAkHf"}