@kienmatu/inkos-core 0.1.0

package/dist/utils/hook-health.js

@@ -0,0 +1,131 @@
+import { classifyHookDisposition, collectStaleHookDebt } from "./hook-governance.js";
+import { describeHookLifecycle, localizeHookPayoffTiming, normalizeStoredHookStatus } from "./hook-lifecycle.js";
+import { HOOK_HEALTH_DEFAULTS } from "./hook-policy.js";
+export function analyzeHookHealth(params) {
+    const maxActiveHooks = params.maxActiveHooks ?? HOOK_HEALTH_DEFAULTS.maxActiveHooks;
+    const staleAfterChapters = params.staleAfterChapters ?? HOOK_HEALTH_DEFAULTS.staleAfterChapters;
+    const noAdvanceWindow = params.noAdvanceWindow ?? HOOK_HEALTH_DEFAULTS.noAdvanceWindow;
+    const newHookBurstThreshold = params.newHookBurstThreshold ?? HOOK_HEALTH_DEFAULTS.newHookBurstThreshold;
+    const issues = [];
+    const activeHooks = params.hooks.filter((hook) => {
+        const status = normalizeStoredHookStatus(hook.status);
+        return status !== "resolved" && status !== "deferred";
+    });
+    const lifecycleEntries = activeHooks.map((hook) => ({
+        hook,
+        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 (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 staleHookIds = new Set(collectStaleHookDebt({
+        hooks: activeHooks,
+        chapterNumber: params.chapterNumber,
+        targetChapters: params.targetChapters,
+        staleAfterChapters,
+    }).map((hook) => hook.hookId));
+    const pressuredHooks = lifecycleEntries.filter(({ hook, lifecycle }) => staleHookIds.has(hook.hookId)
+        || lifecycle.readyToResolve
+        || lifecycle.overdue);
+    const unresolvedPressure = pressuredHooks.filter(({ hook }) => {
+        if (!params.delta) {
+            return true;
+        }
+        const disposition = classifyHookDisposition({
+            hookId: hook.hookId,
+            delta: params.delta,
+        });
+        return disposition === "none" || disposition === "mention";
+    });
+    if (unresolvedPressure.length > 0) {
+        issues.push(warning(params.language, buildPressureDescription({
+            language: params.language,
+            entries: unresolvedPressure,
+            mentionsCurrentChapter: Boolean(params.delta),
+        }), params.language === "en"
+            ? "Move one pressured hook with a real payoff, escalation, or explicit defer before opening adjacent debt."
+            : "先让一个已进入压力区的伏笔发生真实推进、回收或明确延后，再继续扩展同类债务。"));
+    }
+    else {
+        const latestRealAdvance = activeHooks.reduce((max, hook) => Math.max(max, hook.lastAdvancedChapter), 0);
+        if (params.noAdvanceWindow !== undefined
+            && 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."
+                : "下一章优先让一个旧伏笔发生真实推进，而不是继续平行重述。"));
+        }
+    }
+    if (params.delta) {
+        const existingHookIds = new Set(params.existingHookIds ?? []);
+        const resultingHookIds = new Set(params.hooks.map((hook) => hook.hookId));
+        const newHookIds = params.delta.hookOps.upsert
+            .map((hook) => hook.hookId)
+            .filter((hookId) => !existingHookIds.has(hookId) && resultingHookIds.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 buildPressureDescription(params) {
+    const summarized = params.entries
+        .slice(0, 3)
+        .map(({ hook, lifecycle }) => {
+        const timing = localizeHookPayoffTiming(lifecycle.timing, params.language);
+        const pressure = localizePressureLabel(lifecycle, params.language);
+        return params.language === "en"
+            ? `${hook.hookId} (${timing}, ${pressure})`
+            : `${hook.hookId}（${timing}，${pressure}）`;
+    });
+    const suffix = params.entries.length > summarized.length
+        ? params.language === "en"
+            ? `, +${params.entries.length - summarized.length} more`
+            : `，另有 ${params.entries.length - summarized.length} 条`
+        : "";
+    if (params.language === "en") {
+        return params.mentionsCurrentChapter
+            ? `Hooks are already under payoff pressure but this chapter left them untouched: ${summarized.join(", ")}${suffix}.`
+            : `Hooks are already under payoff pressure without recent movement: ${summarized.join(", ")}${suffix}.`;
+    }
+    return params.mentionsCurrentChapter
+        ? `这些伏笔已经进入回收/推进压力，但本章没有真正处理：${summarized.join("、")}${suffix}。`
+        : `这些伏笔已经进入回收/推进压力，但近期没有真实推进：${summarized.join("、")}${suffix}。`;
+}
+function localizePressureLabel(lifecycle, language) {
+    if (lifecycle.overdue) {
+        return language === "en" ? "overdue" : "已逾期";
+    }
+    if (lifecycle.readyToResolve) {
+        return language === "en" ? "ready to pay off" : "可回收";
+    }
+    return language === "en" ? "stale" : "陈旧";
+}
+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/hook-ledger-validator.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Phase 9-3: hard gate that a chapter draft actually acts on the hook ledger
+ * the planner declared in the memo's "## 本章 hook 账" / "## Hook ledger for
+ * this chapter" section.
+ *
+ * The planner commits, per chapter, to:
+ *   - advance: <hook_id> "name" → state-change
+ *   - resolve: <hook_id> "name" → action
+ *
+ * The validator parses those two lists and checks that every committed hook
+ * has observable evidence in the draft. "Evidence" means the draft mentions
+ * at least one keyword from the ledger line's descriptor (hook name, key
+ * noun, etc.). We deliberately do NOT require the draft to repeat the raw
+ * hook_id like "H007" — writers don't embed IDs in prose.
+ */
+export interface HookLedgerViolation {
+    readonly severity: "critical" | "warning";
+    readonly category: string;
+    readonly description: string;
+    readonly suggestion: string;
+}
+export interface HookLedgerEntry {
+    readonly id: string;
+    /** Raw text of the ledger line after the hook_id. */
+    readonly descriptor: string;
+    /** 2+ char CJK sequences and 3+ letter ASCII words extracted from descriptor. */
+    readonly keywords: ReadonlyArray<string>;
+}
+export interface HookLedger {
+    readonly open: ReadonlyArray<HookLedgerEntry>;
+    readonly advance: ReadonlyArray<HookLedgerEntry>;
+    readonly resolve: ReadonlyArray<HookLedgerEntry>;
+    readonly defer: ReadonlyArray<HookLedgerEntry>;
+    /**
+     * Count of `[new] ...` placeholder lines in the `open:` subsection. These
+     * are brand-new hooks declared by the planner that have no pre-existing
+     * hook_id (extractLedgerEntry rejects them because they carry no id to
+     * match downstream), but they still count as "a new hook opened" for the
+     * 揭 1 埋 1 floor check.
+     */
+    readonly newOpenCount: number;
+}
+export declare function parseHookLedger(memoBody: string): HookLedger;
+/**
+ * Enforce: every hook declared under advance / resolve must have observable
+ * evidence in the draft text. We do NOT validate `open` (new hooks don't have
+ * a pre-existing id/descriptor to echo) or `defer` (deferred = deliberately
+ * not touched).
+ *
+ * Additionally enforces the "揭 1 埋 1" hard floor (Xu Er Jia De Mao, 番茄文章
+ * 10): whenever a chapter resolves one or more hooks, it must open at least
+ * as many new hooks in the same memo. "Resolve without opening" leaves the
+ * reader feeling "解完即索然无味" — the story loses forward pull. The softer
+ * "揭 1 埋 2" rule is a planner-prompt recommendation, not a hard gate here,
+ * because enforcing ×2 would conflict with the "≤ 2 new hooks per chapter"
+ * cap on the planner side when resolve=2.
+ */
+export declare function validateHookLedger(memoBody: string, draftContent: string): ReadonlyArray<HookLedgerViolation>;
+declare function extractLedgerSection(memoBody: string): string | undefined;
+declare function extractLedgerEntry(line: string): HookLedgerEntry | undefined;
+/**
+ * Extract content-matching tokens from a ledger line's descriptor.
+ *
+ * Priority 1: quoted hook name — `H007 "胖虎借条" → ...` — this is the most
+ * informative token the planner attached, and it's what the writer should
+ * echo. We split compound CJK names into leading/trailing 2-grams so
+ * partial echoes still count.
+ *
+ * Priority 2: if no quoted name, fall back to the descriptor text UP TO the
+ * first state-transition arrow (→ or ->), same CJK/ASCII splitting. Anything
+ * AFTER the arrow describes new state, not the hook itself, and risks
+ * character-name false positives.
+ */
+declare function extractKeywords(descriptor: string): ReadonlyArray<string>;
+export declare const INTERNAL: {
+    SUBSECTION_KEYS: readonly (keyof HookLedger)[];
+    extractLedgerSection: typeof extractLedgerSection;
+    extractLedgerEntry: typeof extractLedgerEntry;
+    extractKeywords: typeof extractKeywords;
+};
+export {};
+//# sourceMappingURL=hook-ledger-validator.d.ts.map

package/dist/utils/hook-ledger-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-ledger-validator.d.ts","sourceRoot":"","sources":["../../src/utils/hook-ledger-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAmBD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CA2C5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,aAAa,CAAC,mBAAmB,CAAC,CAkCpC;AAED,iBAAS,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWlE;AAED,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAiBrE;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAuBlE;AA0CD,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAC"}

package/dist/utils/hook-ledger-validator.js

@@ -0,0 +1,225 @@
+/**
+ * Phase 9-3: hard gate that a chapter draft actually acts on the hook ledger
+ * the planner declared in the memo's "## 本章 hook 账" / "## Hook ledger for
+ * this chapter" section.
+ *
+ * The planner commits, per chapter, to:
+ *   - advance: <hook_id> "name" → state-change
+ *   - resolve: <hook_id> "name" → action
+ *
+ * The validator parses those two lists and checks that every committed hook
+ * has observable evidence in the draft. "Evidence" means the draft mentions
+ * at least one keyword from the ledger line's descriptor (hook name, key
+ * noun, etc.). We deliberately do NOT require the draft to repeat the raw
+ * hook_id like "H007" — writers don't embed IDs in prose.
+ */
+const LEDGER_HEADING_PATTERNS = [
+    /^#{2,3}\s*本章\s*hook\s*账\s*$/im,
+    /^#{2,3}\s*Hook\s+ledger\s+for\s+this\s+chapter\s*$/im,
+];
+const SUBSECTION_KEYS = ["open", "advance", "resolve", "defer"];
+/**
+ * Tokens that look like hook_ids but are placeholders meaning "no hooks in
+ * this slot". Writers sometimes emit "- 无" or "- none" under an empty slot
+ * instead of leaving it blank.
+ */
+const PLACEHOLDER_TOKENS = /^(无|空|none|nil|null|暂无|n\/a|na|n-a|tbd|todo|待定)$/i;
+/** Subsection heading words that must not be parsed as hook_ids. */
+const SUBSECTION_WORDS = /^(open|advance|resolve|defer|new)$/i;
+export function parseHookLedger(memoBody) {
+    const section = extractLedgerSection(memoBody);
+    if (!section) {
+        return { open: [], advance: [], resolve: [], defer: [], newOpenCount: 0 };
+    }
+    const result = {
+        open: [],
+        advance: [],
+        resolve: [],
+        defer: [],
+    };
+    let newOpenCount = 0;
+    let current = null;
+    for (const rawLine of section.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line.length === 0)
+            continue;
+        const subHeadingMatch = line.match(/^(open|advance|resolve|defer)\s*[:：]?\s*$/i);
+        if (subHeadingMatch) {
+            current = subHeadingMatch[1].toLowerCase();
+            continue;
+        }
+        if (!current)
+            continue;
+        if (!line.startsWith("-"))
+            continue;
+        // `[new]` placeholder lines have no hook_id but still count as a new hook
+        // opened (揭 1 埋 1 floor check). extractLedgerEntry filters them out for
+        // advance/resolve evidence matching; we tally them separately here.
+        const cleaned = line.replace(/^-+\s*/, "").trim();
+        if (current === "open" && /^\[new\]/i.test(cleaned)) {
+            newOpenCount += 1;
+            continue;
+        }
+        const entry = extractLedgerEntry(line);
+        if (entry)
+            result[current].push(entry);
+    }
+    return { ...result, newOpenCount };
+}
+/**
+ * Enforce: every hook declared under advance / resolve must have observable
+ * evidence in the draft text. We do NOT validate `open` (new hooks don't have
+ * a pre-existing id/descriptor to echo) or `defer` (deferred = deliberately
+ * not touched).
+ *
+ * Additionally enforces the "揭 1 埋 1" hard floor (Xu Er Jia De Mao, 番茄文章
+ * 10): whenever a chapter resolves one or more hooks, it must open at least
+ * as many new hooks in the same memo. "Resolve without opening" leaves the
+ * reader feeling "解完即索然无味" — the story loses forward pull. The softer
+ * "揭 1 埋 2" rule is a planner-prompt recommendation, not a hard gate here,
+ * because enforcing ×2 would conflict with the "≤ 2 new hooks per chapter"
+ * cap on the planner side when resolve=2.
+ */
+export function validateHookLedger(memoBody, draftContent) {
+    const ledger = parseHookLedger(memoBody);
+    const violations = [];
+    // Evidence check for everything the memo committed to land in prose.
+    const committed = dedupeById([...ledger.advance, ...ledger.resolve]);
+    for (const entry of committed) {
+        if (!draftEchoesEntry(draftContent, entry)) {
+            violations.push({
+                severity: "warning",
+                category: "hook 账需语义复核",
+                description: `memo 在 advance/resolve 里声明要处理 ${entry.id}，但确定性关键词检查没有找到对应落点`,
+                suggestion: `复核正文是否已经用动作、对话、物件或信息变化推进了 ${entry.id}；若没有，请补具体场景，若已推进，可忽略这条确定性提示`,
+            });
+        }
+    }
+    // "揭 1 埋 1" hard floor: when anything was resolved, at least the same
+    // number of new hooks must have been opened. We count both `[new]`
+    // placeholder lines (newOpenCount — the normal way planners declare fresh
+    // hooks without an id) and any id-bearing lines under `open:` (rare, but
+    // legal if a planner re-opens a previously paused hook).
+    const resolvedCount = ledger.resolve.length;
+    const openedCount = ledger.open.length + ledger.newOpenCount;
+    if (resolvedCount > 0 && openedCount < resolvedCount) {
+        violations.push({
+            severity: "critical",
+            category: "hook 账揭 1 埋 1 违规",
+            description: `本章 resolve 了 ${resolvedCount} 个钩子，但 open 只有 ${openedCount} 个新钩子。只揭不埋会让读者豁然开朗后索然无味，本书的前进拉力被削弱。`,
+            suggestion: `在 memo 的 open 段下至少再埋 ${resolvedCount - openedCount} 个与本章已揭钩子相关的新钩子。新钩子最好与已揭钩子彼此关联，不要凭空冒出来。`,
+        });
+    }
+    return violations;
+}
+function extractLedgerSection(memoBody) {
+    for (const pattern of LEDGER_HEADING_PATTERNS) {
+        const match = memoBody.match(pattern);
+        if (!match || match.index === undefined)
+            continue;
+        const start = match.index + match[0].length;
+        const rest = memoBody.slice(start);
+        const nextHeading = rest.match(/\n#{2,3}\s/);
+        const end = nextHeading ? nextHeading.index ?? rest.length : rest.length;
+        return rest.slice(0, end);
+    }
+    return undefined;
+}
+function extractLedgerEntry(line) {
+    const cleaned = line.replace(/^-+\s*/, "").trim();
+    if (cleaned.startsWith("[new]") || cleaned.startsWith("[NEW]"))
+        return undefined;
+    // Reject whole-line placeholders first — "- 无", "- n/a", "- none" etc.
+    const firstWord = cleaned.split(/\s+/)[0] ?? "";
+    if (PLACEHOLDER_TOKENS.test(firstWord))
+        return undefined;
+    const idMatch = cleaned.match(/^([A-Za-z\u4e00-\u9fff][A-Za-z0-9_\-\u4e00-\u9fff]{0,19})/);
+    if (!idMatch)
+        return undefined;
+    const candidate = idMatch[1];
+    if (SUBSECTION_WORDS.test(candidate))
+        return undefined;
+    if (PLACEHOLDER_TOKENS.test(candidate))
+        return undefined;
+    const descriptor = cleaned.slice(candidate.length).trim();
+    return { id: candidate, descriptor, keywords: extractKeywords(descriptor) };
+}
+/**
+ * Extract content-matching tokens from a ledger line's descriptor.
+ *
+ * Priority 1: quoted hook name — `H007 "胖虎借条" → ...` — this is the most
+ * informative token the planner attached, and it's what the writer should
+ * echo. We split compound CJK names into leading/trailing 2-grams so
+ * partial echoes still count.
+ *
+ * Priority 2: if no quoted name, fall back to the descriptor text UP TO the
+ * first state-transition arrow (→ or ->), same CJK/ASCII splitting. Anything
+ * AFTER the arrow describes new state, not the hook itself, and risks
+ * character-name false positives.
+ */
+function extractKeywords(descriptor) {
+    if (!descriptor)
+        return [];
+    // Try the quoted-name anchor first — matches "..." or "..." quotes.
+    const quotedMatch = descriptor.match(/[""]([^""\n]+)[""]/);
+    const source = quotedMatch ? quotedMatch[1] : descriptor.split(/[→]|->/, 1)[0];
+    const cjkRuns = source.match(/[\u4e00-\u9fff]{2,}/g) ?? [];
+    const cjkTokens = [];
+    for (const run of cjkRuns) {
+        cjkTokens.push(run);
+        if (run.length >= 3) {
+            for (let index = 0; index <= run.length - 2; index++) {
+                cjkTokens.push(run.slice(index, index + 2));
+            }
+        }
+        if (run.length >= 4) {
+            cjkTokens.push(run.slice(0, 3));
+            cjkTokens.push(run.slice(-3));
+        }
+    }
+    const ascii = (source.match(/[A-Za-z]{3,}/g) ?? []).map((w) => w.toLowerCase());
+    return dedupeStrings([...cjkTokens, ...ascii].filter((tok) => !ASCII_STOPWORDS.has(tok)));
+}
+const ASCII_STOPWORDS = new Set([
+    "and", "the", "for", "with", "from", "that", "into", "then",
+    "open", "close", "advance", "resolve", "defer", "new",
+    "planted", "pressured", "near", "payoff", "ready", "stale",
+]);
+function draftEchoesEntry(draft, entry) {
+    if (entry.keywords.length > 0) {
+        const draftLower = draft.toLowerCase();
+        return entry.keywords.some((kw) => {
+            // ASCII keywords are already lowercased; CJK keywords case doesn't matter.
+            return /^[a-z]/.test(kw) ? draftLower.includes(kw) : draft.includes(kw);
+        });
+    }
+    // Bare-id ledger line with no descriptor — fall back to ID match.
+    if (/^[A-Za-z0-9_-]+$/.test(entry.id)) {
+        return new RegExp(`\\b${escapeRegex(entry.id)}\\b`).test(draft);
+    }
+    return draft.includes(entry.id);
+}
+function dedupeById(entries) {
+    const seen = new Set();
+    const result = [];
+    for (const entry of entries) {
+        if (seen.has(entry.id))
+            continue;
+        seen.add(entry.id);
+        result.push(entry);
+    }
+    return result;
+}
+function dedupeStrings(values) {
+    return [...new Set(values)];
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export const INTERNAL = {
+    SUBSECTION_KEYS,
+    extractLedgerSection,
+    extractLedgerEntry,
+    extractKeywords,
+};
+//# sourceMappingURL=hook-ledger-validator.js.map

package/dist/utils/hook-ledger-validator.js.map

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

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

@@ -0,0 +1,41 @@
+import type { HookPayoffTiming, HookStatus } from "../models/runtime-state.js";
+import type { StoredHook } from "../state/memory-db.js";
+import { type HookPhase } from "./hook-policy.js";
+export declare const DEFAULT_HOOK_LOOKAHEAD_CHAPTERS = 3;
+export declare function resolveHookStatusAlias(status: string | undefined | null): HookStatus | undefined;
+export declare function normalizeStoredHookStatus(status: string): HookStatus;
+export declare function filterActiveHooks(hooks: ReadonlyArray<StoredHook>): StoredHook[];
+export declare function isFuturePlannedHook(hook: StoredHook, chapterNumber: number, lookahead?: number): boolean;
+export declare function isHookWithinChapterWindow(hook: StoredHook, chapterNumber: number, recentWindow?: number, lookahead?: number): boolean;
+export declare function normalizeHookPayoffTiming(value: string | undefined | null): HookPayoffTiming | undefined;
+export declare function inferHookPayoffTiming(params: {
+    readonly expectedPayoff?: string;
+    readonly notes?: string;
+}): HookPayoffTiming;
+export declare function resolveHookPayoffTiming(params: {
+    readonly payoffTiming?: string | null;
+    readonly expectedPayoff?: string;
+    readonly notes?: string;
+}): HookPayoffTiming;
+export declare function localizeHookPayoffTiming(timing: HookPayoffTiming, language: "zh" | "en"): string;
+export declare function describeHookLifecycle(params: {
+    readonly payoffTiming?: string | null;
+    readonly expectedPayoff?: string;
+    readonly notes?: string;
+    readonly startChapter: number;
+    readonly lastAdvancedChapter: number;
+    readonly status: string;
+    readonly chapterNumber: number;
+    readonly targetChapters?: number;
+}): {
+    readonly timing: HookPayoffTiming;
+    readonly phase: HookPhase;
+    readonly age: number;
+    readonly dormancy: number;
+    readonly readyToResolve: boolean;
+    readonly stale: boolean;
+    readonly overdue: boolean;
+    readonly advancePressure: number;
+    readonly resolvePressure: number;
+};
+//# sourceMappingURL=hook-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-lifecycle.d.ts","sourceRoot":"","sources":["../../src/utils/hook-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAML,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAwBjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,UAAU,GAAG,SAAS,CAGhG;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAEpE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,UAAU,EAAE,CAQhF;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAwC,GAClD,OAAO,CAET;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,MAAM,EACrB,YAAY,GAAE,MAAU,EACxB,SAAS,GAAE,MAAwC,GAClD,OAAO,CAoBT;AAmCD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,gBAAgB,GAAG,SAAS,CAWxG;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,gBAAgB,CAcnB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,gBAAgB,CAMnB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,IAAI,GAAG,IAAI,GACpB,MAAM,CAER;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,GAAG;IACF,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,CAgDA"}