@actalk/inkos-core 1.3.6 → 1.3.7

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: "critical",
+                category: "hook 账未兑现",
+                description: `memo 在 advance/resolve 里声明要处理 ${entry.id}，但正文没有对应的落地动作`,
+                suggestion: `在正文中加入对 ${entry.id} 的具体情节推进（动作、对话、环境变化），或把它从 hook 账里移到 defer 并给出理由`,
+            });
+        }
+    }
+    // "揭 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

@@ -1,5 +1,10 @@
 import type { HookPayoffTiming } 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 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;

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

@@ -1 +1 @@
-{"version":3,"file":"hook-lifecycle.d.ts","sourceRoot":"","sources":["../../src/utils/hook-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAML,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAmC1B,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"}
+{"version":3,"file":"hook-lifecycle.d.ts","sourceRoot":"","sources":["../../src/utils/hook-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAML,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,+BAA+B,IAAI,CAAC;AASjD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,UAAU,EAAE,CAEhF;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"}

package/dist/utils/hook-lifecycle.js

@@ -1,4 +1,36 @@
 import { HOOK_ACTIVITY_THRESHOLDS, HOOK_PHASE_THRESHOLDS, HOOK_PHASE_WEIGHT, HOOK_PRESSURE_WEIGHTS, HOOK_TIMING_PROFILES, } from "./hook-policy.js";
+export const DEFAULT_HOOK_LOOKAHEAD_CHAPTERS = 3;
+function normalizeStoredHookStatus(status) {
+    if (/^(resolved|closed|done|已回收|已解决)$/i.test(status.trim()))
+        return "resolved";
+    if (/^(deferred|paused|hold|延后|延期|搁置|暂缓)$/i.test(status.trim()))
+        return "deferred";
+    if (/^(progressing|advanced|重大推进|持续推进)$/i.test(status.trim()))
+        return "progressing";
+    return "open";
+}
+export function filterActiveHooks(hooks) {
+    return hooks.filter((hook) => normalizeStoredHookStatus(hook.status) !== "resolved");
+}
+export function isFuturePlannedHook(hook, chapterNumber, lookahead = DEFAULT_HOOK_LOOKAHEAD_CHAPTERS) {
+    return hook.lastAdvancedChapter <= 0 && hook.startChapter > chapterNumber + lookahead;
+}
+export function isHookWithinChapterWindow(hook, chapterNumber, recentWindow = 5, lookahead = DEFAULT_HOOK_LOOKAHEAD_CHAPTERS) {
+    const recentCutoff = Math.max(0, chapterNumber - recentWindow);
+    if (hook.lastAdvancedChapter > 0 && hook.lastAdvancedChapter >= recentCutoff) {
+        return true;
+    }
+    if (hook.lastAdvancedChapter > 0) {
+        return false;
+    }
+    if (hook.startChapter <= 0) {
+        return true;
+    }
+    if (hook.startChapter >= recentCutoff && hook.startChapter <= chapterNumber) {
+        return true;
+    }
+    return hook.startChapter > chapterNumber && hook.startChapter <= chapterNumber + lookahead;
+}
 const LABELS = {
     en: {
         immediate: "immediate",

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

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

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

@@ -1,6 +1,5 @@
 import type { HookPayoffTiming } from "../models/runtime-state.js";
 export type HookPhase = "opening" | "middle" | "late";
-export type HookAgendaLoad = "light" | "medium" | "heavy";
 export interface HookLifecycleProfile {
     readonly earliestResolveAge: number;
     readonly staleDormancy: number;
@@ -34,22 +33,6 @@ export declare const HOOK_ACTIVITY_THRESHOLDS: {
     readonly refreshDormancy: 2;
     readonly freshPromiseAge: 1;
 };
-export declare const HOOK_AGENDA_LIMITS: Record<HookAgendaLoad, {
-    readonly staleDebt: number;
-    readonly mustAdvance: number;
-    readonly eligibleResolve: number;
-    readonly avoidFamilies: number;
-}>;
-export declare const HOOK_AGENDA_LOAD_THRESHOLDS: {
-    readonly heavyReadyCount: 3;
-    readonly heavyStaleCount: 4;
-    readonly heavyCriticalCount: 3;
-    readonly heavyPressuredCount: 6;
-    readonly mediumReadyCount: 2;
-    readonly mediumStaleCount: 2;
-    readonly mediumCriticalCount: 1;
-    readonly mediumPressuredFamilies: 3;
-};
 export declare const HOOK_VISIBILITY_WINDOWS: Record<HookPayoffTiming, number>;
 export declare const HOOK_RELEVANT_SELECTION_DEFAULTS: {
     readonly primary: {

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

@@ -1 +1 @@
-{"version":3,"file":"hook-policy.d.ts","sourceRoot":"","sources":["../../src/utils/hook-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,CAoC/E,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIvD,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;;CAUxB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;CAM3B,CAAC;AAEX,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAmBA,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;CAS9B,CAAC;AAEX,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAMpE,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;CAYnC,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE5E"}
+{"version":3,"file":"hook-policy.d.ts","sourceRoot":"","sources":["../../src/utils/hook-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,CAoC/E,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIvD,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;;CAUxB,CAAC;AAEX,eAAO,MAAM,wBAAwB;;;;;;CAM3B,CAAC;AAEX,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAMpE,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;CAYnC,CAAC;AAEX,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE5E"}

package/dist/utils/hook-policy.js

@@ -64,36 +64,6 @@ export const HOOK_ACTIVITY_THRESHOLDS = {
     refreshDormancy: 2,
     freshPromiseAge: 1,
 };
-export const HOOK_AGENDA_LIMITS = {
-    light: {
-        staleDebt: 1,
-        mustAdvance: 2,
-        eligibleResolve: 1,
-        avoidFamilies: 2,
-    },
-    medium: {
-        staleDebt: 2,
-        mustAdvance: 2,
-        eligibleResolve: 1,
-        avoidFamilies: 3,
-    },
-    heavy: {
-        staleDebt: 3,
-        mustAdvance: 3,
-        eligibleResolve: 2,
-        avoidFamilies: 4,
-    },
-};
-export const HOOK_AGENDA_LOAD_THRESHOLDS = {
-    heavyReadyCount: 3,
-    heavyStaleCount: 4,
-    heavyCriticalCount: 3,
-    heavyPressuredCount: 6,
-    mediumReadyCount: 2,
-    mediumStaleCount: 2,
-    mediumCriticalCount: 1,
-    mediumPressuredFamilies: 3,
-};
 export const HOOK_VISIBILITY_WINDOWS = {
     immediate: 5,
     "near-term": 5,

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

@@ -1 +1 @@
-{"version":3,"file":"hook-policy.js","sourceRoot":"","sources":["../../src/utils/hook-policy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hook-policy.js","sourceRoot":"","sources":["../../src/utils/hook-policy.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,oBAAoB,GAAmD;IAClF,SAAS,EAAE;QACT,kBAAkB,EAAE,CAAC;QACrB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,CAAC;KACf;IACD,WAAW,EAAE;QACX,kBAAkB,EAAE,CAAC;QACrB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,CAAC;KACf;IACD,SAAS,EAAE;QACT,kBAAkB,EAAE,CAAC;QACrB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,SAAS;QACvB,WAAW,EAAE,CAAC;KACf;IACD,WAAW,EAAE;QACX,kBAAkB,EAAE,CAAC;QACrB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,EAAE;QACd,YAAY,EAAE,QAAQ;QACtB,WAAW,EAAE,CAAC;KACf;IACD,OAAO,EAAE;QACP,kBAAkB,EAAE,CAAC;QACrB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,EAAE;QACd,YAAY,EAAE,MAAM;QACpB,WAAW,EAAE,CAAC;KACf;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAA8B;IAC1D,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,cAAc,EAAE,IAAI;IACpB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,EAAE;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,CAAC;IACpB,mBAAmB,EAAE,CAAC;IACtB,qBAAqB,EAAE,EAAE;IACzB,uBAAuB,EAAE,CAAC;IAC1B,yBAAyB,EAAE,CAAC;IAC5B,uBAAuB,EAAE,EAAE;IAC3B,mBAAmB,EAAE,EAAE;IACvB,wBAAwB,EAAE,CAAC;IAC3B,uBAAuB,EAAE,EAAE;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,uBAAuB,EAAE,CAAC;IAC1B,sBAAsB,EAAE,CAAC;IACzB,2BAA2B,EAAE,CAAC;IAC9B,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,uBAAuB,GAAqC;IACvE,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,WAAW,EAAE,CAAC;IACd,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,OAAO,EAAE;QACP,SAAS,EAAE,CAAC;QACZ,uBAAuB,EAAE,CAAC;QAC1B,kBAAkB,EAAE,CAAC;KACtB;IACD,KAAK,EAAE;QACL,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,CAAC;QACnB,qBAAqB,EAAE,CAAC;KACzB;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,EAAE;IAClB,kBAAkB,EAAE,EAAE;IACtB,eAAe,EAAE,CAAC;IAClB,qBAAqB,EAAE,CAAC;CAChB,CAAC;AAEX,MAAM,UAAU,2BAA2B,CAAC,MAAwB;IAClE,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,83 @@
+/**
+ * Phase 7 — hook promotion rules.
+ *
+ * Architect produces a pool of hook seeds (every row in the initial
+ * pending_hooks table is conceptually a seed). Not every seed belongs in
+ * the live `pending_hooks.md` ledger — pushing all of them there turns the
+ * ledger into noise within a few chapters.
+ *
+ * A seed is *promoted* into the ledger when any of these four conditions
+ * holds. The consolidator (maintains pending_hooks.md post-chapter) calls
+ * `shouldPromoteHook` for every tracked seed, and the ledger retains only
+ * the hooks that cross the threshold.
+ *
+ *   1. cross_volume — the hook spans volume boundaries. It either pays off
+ *      in a later volume, or depends on hooks declared in a later volume.
+ *   2. advanced_count >= 2 — the hook has been advanced/pushed in two or
+ *      more chapters since planting, proving readers already track it.
+ *   3. depends_on non-empty — the hook has upstream causal dependencies
+ *      worth tracking, even if it hasn't been touched recently.
+ *   4. core_hook === true — architect marked this hook as main-line
+ *      load-bearing; it always belongs in the ledger.
+ */
+import type { StoredHook } from "../state/memory-db.js";
+export interface VolumeBoundary {
+    readonly name: string;
+    readonly startCh: number;
+    readonly endCh: number;
+}
+export interface PromotionContext {
+    /** Volume boundaries parsed from outline/volume_map.md, ordered by startCh. */
+    readonly volumeBoundaries: ReadonlyArray<VolumeBoundary>;
+    /** Current chapter number (0 at book creation). */
+    readonly currentChapter: number;
+    /** Hook id -> advanced count (how many chapters advanced this hook since planting). */
+    readonly advancedCounts: ReadonlyMap<string, number>;
+    /**
+     * Hook id -> start chapter lookup for every seed (including unpromoted ones).
+     * Used to tell whether a `depends_on` target is declared in a later volume.
+     */
+    readonly allSeedStartChapters: ReadonlyMap<string, number>;
+}
+export interface PromotionDecision {
+    readonly promote: boolean;
+    readonly reasons: ReadonlyArray<PromotionReason>;
+}
+export type PromotionReason = "cross_volume" | "advanced_count" | "depends_on" | "core_hook";
+export declare function shouldPromoteHook(hook: StoredHook, context: PromotionContext): PromotionDecision;
+/**
+ * Derive the default half-life (in chapters) for a hook that did not set it
+ * explicitly. Mirrors the prompt defaults: immediate/near-term = 10,
+ * mid-arc = 30, slow-burn/endgame = 80. Unknown timing falls to mid-arc.
+ */
+export declare function defaultHalfLifeChapters(payoffTiming: StoredHook["payoffTiming"] | undefined): number;
+export declare function resolveHalfLifeChapters(hook: StoredHook): number;
+/**
+ * Escape special regex characters in a string so it can be used as a
+ * literal pattern inside `new RegExp(...)`.
+ */
+export declare function escapeRegex(s: string): string;
+export interface PromotionPassResult {
+    /** Whether any hook flipped to promoted=true. */
+    readonly updated: boolean;
+    /** The (possibly updated) hooks array. */
+    readonly hooks: ReadonlyArray<StoredHook>;
+    /** Number of hooks that flipped from non-promoted to promoted. */
+    readonly flippedCount: number;
+}
+/**
+ * Derive hook advancement counts from chapter_summaries.md content.
+ *
+ * Counts how many chapter-summary data rows mention each hook id in the
+ * hookActivity column (index 5, 0-based — "伏笔动态" / "hookActivity").
+ */
+export declare function deriveAdvancedCountsFromSummaries(summariesRaw: string, hookIds: ReadonlyArray<string>): Map<string, number>;
+/**
+ * Lightweight promotion pass: read hooks + chapter_summaries, check
+ * advancedCount >= 2, flip promoted flag. No LLM calls.
+ *
+ * Returns the result without doing any I/O — caller decides whether to
+ * persist.
+ */
+export declare function rerunPromotionPass(hooks: ReadonlyArray<StoredHook>, summariesRaw: string): PromotionPassResult;
+//# sourceMappingURL=hook-promotion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-promotion.d.ts","sourceRoot":"","sources":["../../src/utils/hook-promotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IACzD,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,WAAW,CAAC;AAEhB,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,gBAAgB,GACxB,iBAAiB,CA0BnB;AAkFD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,UAAU,CAAC,cAAc,CAAC,GAAG,SAAS,GACnD,MAAM,CAYR;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEhE;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBrB;AA+BD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,YAAY,EAAE,MAAM,GACnB,mBAAmB,CA0BrB"}