@kienmatu/inkos-core 0.1.0

package/dist/utils/hook-lifecycle.js

@@ -0,0 +1,183 @@
+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;
+const HOOK_STATUS_ALIASES = new Map([
+    ...[
+        "resolved", "closed", "done", "paid_off", "paid-off", "paid off",
+        "已回收", "回收", "完成", "已解决", "已兑现", "兑现",
+    ].map((value) => [value, "resolved"]),
+    ...[
+        "deferred", "paused", "hold", "dormant", "sleeping", "inactive",
+        "unplanted", "unseeded", "not_started", "not-started", "not started",
+        "not_active", "not-active", "not active", "搁置", "延后", "延期", "暂缓",
+        "休眠", "未激活", "未开启", "待开启", "未启动", "待启动", "未推进",
+        "尚未推进", "待推进",
+    ].map((value) => [value, "deferred"]),
+    ...[
+        "progressing", "advanced", "progress", "active", "pressured", "confirmed",
+        "confirmed_hit", "confirmed-hit", "confirmed hit", "命中", "已确认命中", "已推进",
+        "推进", "进行中", "持续推进", "重大推进",
+    ].map((value) => [value, "progressing"]),
+    ...[
+        "open", "pending", "seeded", "planted", "待定", "未回收", "已埋", "已种下", "已铺垫",
+    ].map((value) => [value, "open"]),
+]);
+export function resolveHookStatusAlias(status) {
+    const normalized = status?.trim().toLowerCase();
+    return normalized ? HOOK_STATUS_ALIASES.get(normalized) : undefined;
+}
+export function normalizeStoredHookStatus(status) {
+    return resolveHookStatusAlias(status) ?? "open";
+}
+export function filterActiveHooks(hooks) {
+    return hooks.filter((hook) => {
+        const status = normalizeStoredHookStatus(hook.status);
+        if (status === "resolved" || status === "deferred")
+            return false;
+        // promoted=false means this is still an architect seed, not live hook debt.
+        // Legacy rows without the promoted column keep the old behavior.
+        return hook.promoted !== false;
+    });
+}
+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",
+        "near-term": "near-term",
+        "mid-arc": "mid-arc",
+        "slow-burn": "slow-burn",
+        endgame: "endgame",
+    },
+    zh: {
+        immediate: "立即",
+        "near-term": "近期",
+        "mid-arc": "中程",
+        "slow-burn": "慢烧",
+        endgame: "终局",
+    },
+};
+const TIMING_ALIASES = [
+    ["immediate", /^(?:立即|马上|当章|本章|下一章|immediate|instant|next(?:\s+chapter|\s+beat)?|right\s+away)$/i],
+    ["near-term", /^(?:近期|近几章|短线|soon|short(?:\s+run)?|near(?:\s*-\s*|\s+)term|current\s+sequence)$/i],
+    ["mid-arc", /^(?:中程|中期|卷中|mid(?:\s*-\s*|\s+)arc|mid(?:\s*-\s*|\s+)book|middle)$/i],
+    ["slow-burn", /^(?:慢烧|长线|后续|later|late(?:r)?|long(?:\s*-\s*|\s+)arc|slow(?:\s*-\s*|\s+)burn)$/i],
+    ["endgame", /^(?:终局|终章|大结局|最终|climax|finale|endgame|late\s+book)$/i],
+];
+const SIGNAL_PATTERNS = [
+    ["endgame", /(终局|终章|大结局|最终揭晓|最终摊牌|climax|finale|endgame|final reveal|last act)/i],
+    ["immediate", /(当章|本章|下一章|马上|立刻|即刻|immediate|next chapter|right away|at once)/i],
+    ["near-term", /(近期|近几章|很快|短线|soon|near-term|short run|current sequence)/i],
+    ["mid-arc", /(中期|卷中|本卷中段|mid-book|mid arc|middle of the arc)/i],
+    ["slow-burn", /(长线|慢烧|后续发酵|慢慢揭开|later|slow burn|long arc|long tail)/i],
+];
+export function normalizeHookPayoffTiming(value) {
+    const normalized = value?.trim();
+    if (!normalized)
+        return undefined;
+    for (const [timing, pattern] of TIMING_ALIASES) {
+        if (pattern.test(normalized)) {
+            return timing;
+        }
+    }
+    return undefined;
+}
+export function inferHookPayoffTiming(params) {
+    const combined = [params.expectedPayoff, params.notes]
+        .filter((value) => Boolean(value && value.trim()))
+        .join(" ")
+        .trim();
+    if (!combined)
+        return "mid-arc";
+    for (const [timing, pattern] of SIGNAL_PATTERNS) {
+        if (pattern.test(combined)) {
+            return timing;
+        }
+    }
+    return "mid-arc";
+}
+export function resolveHookPayoffTiming(params) {
+    return normalizeHookPayoffTiming(params.payoffTiming)
+        ?? inferHookPayoffTiming({
+            expectedPayoff: params.expectedPayoff,
+            notes: params.notes,
+        });
+}
+export function localizeHookPayoffTiming(timing, language) {
+    return LABELS[language][timing];
+}
+export function describeHookLifecycle(params) {
+    const timing = resolveHookPayoffTiming(params);
+    const profile = HOOK_TIMING_PROFILES[timing];
+    const phase = resolveHookPhase(params.chapterNumber, params.targetChapters);
+    const age = Math.max(0, params.chapterNumber - Math.max(1, params.startChapter));
+    const lastTouchChapter = Math.max(params.startChapter, params.lastAdvancedChapter);
+    const dormancy = Math.max(0, params.chapterNumber - Math.max(1, lastTouchChapter));
+    const explicitProgressing = /^(progressing|advanced|重大推进|持续推进)$/i.test(params.status.trim());
+    const phaseReady = HOOK_PHASE_WEIGHT[phase] >= HOOK_PHASE_WEIGHT[profile.minimumPhase];
+    const recentlyTouched = dormancy <= HOOK_ACTIVITY_THRESHOLDS.recentlyTouchedDormancy;
+    const overdue = phaseReady && age >= profile.overdueAge;
+    const cadenceReady = timing === "slow-burn"
+        ? phase === "late" || overdue
+        : timing === "endgame"
+            ? phase === "late"
+            : true;
+    const momentum = explicitProgressing || recentlyTouched;
+    const stale = phaseReady && (dormancy >= profile.staleDormancy
+        || (overdue && !momentum));
+    const readyToResolve = phaseReady
+        && cadenceReady
+        && age >= profile.earliestResolveAge
+        && (momentum || (overdue && explicitProgressing));
+    return {
+        timing,
+        phase,
+        age,
+        dormancy,
+        readyToResolve,
+        stale,
+        overdue,
+        advancePressure: age
+            + dormancy
+            + (stale ? HOOK_PRESSURE_WEIGHTS.staleAdvanceBonus : 0)
+            + (overdue ? HOOK_PRESSURE_WEIGHTS.overdueAdvanceBonus : 0),
+        resolvePressure: readyToResolve
+            ? profile.resolveBias * HOOK_PRESSURE_WEIGHTS.resolveBiasMultiplier
+                + (explicitProgressing ? HOOK_PRESSURE_WEIGHTS.progressingResolveBonus : 0)
+                + Math.min(HOOK_PRESSURE_WEIGHTS.maxDormancyResolveBonus, dormancy * HOOK_PRESSURE_WEIGHTS.dormancyResolveMultiplier)
+                + (overdue ? HOOK_PRESSURE_WEIGHTS.overdueResolveBonus : 0)
+            : 0,
+    };
+}
+function resolveHookPhase(chapterNumber, targetChapters) {
+    if (targetChapters && targetChapters > 0) {
+        const progress = chapterNumber / targetChapters;
+        if (progress >= HOOK_PHASE_THRESHOLDS.lateProgress)
+            return "late";
+        if (progress >= HOOK_PHASE_THRESHOLDS.middleProgress)
+            return "middle";
+        return "opening";
+    }
+    if (chapterNumber >= HOOK_PHASE_THRESHOLDS.lateChapter)
+        return "late";
+    if (chapterNumber >= HOOK_PHASE_THRESHOLDS.middleChapter)
+        return "middle";
+    return "opening";
+}
+//# sourceMappingURL=hook-lifecycle.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,57 @@
+import type { HookPayoffTiming } from "../models/runtime-state.js";
+export type HookPhase = "opening" | "middle" | "late";
+export interface HookLifecycleProfile {
+    readonly earliestResolveAge: number;
+    readonly staleDormancy: number;
+    readonly overdueAge: number;
+    readonly minimumPhase: HookPhase;
+    readonly resolveBias: number;
+}
+export declare const HOOK_TIMING_PROFILES: Record<HookPayoffTiming, HookLifecycleProfile>;
+export declare const HOOK_PHASE_WEIGHT: Record<HookPhase, number>;
+export declare const HOOK_PHASE_THRESHOLDS: {
+    readonly middleProgress: 0.33;
+    readonly lateProgress: 0.72;
+    readonly middleChapter: 8;
+    readonly lateChapter: 24;
+};
+export declare const HOOK_PRESSURE_WEIGHTS: {
+    readonly staleAdvanceBonus: 8;
+    readonly overdueAdvanceBonus: 6;
+    readonly resolveBiasMultiplier: 10;
+    readonly progressingResolveBonus: 5;
+    readonly dormancyResolveMultiplier: 2;
+    readonly maxDormancyResolveBonus: 12;
+    readonly overdueResolveBonus: 10;
+    readonly mustAdvancePressureFloor: 8;
+    readonly criticalResolvePressure: 40;
+};
+export declare const HOOK_ACTIVITY_THRESHOLDS: {
+    readonly recentlyTouchedDormancy: 1;
+    readonly longArcQuietHoldMaxAge: 2;
+    readonly longArcQuietHoldMaxDormancy: 1;
+    readonly refreshDormancy: 2;
+    readonly freshPromiseAge: 1;
+};
+export declare const HOOK_VISIBILITY_WINDOWS: Record<HookPayoffTiming, number>;
+export declare const HOOK_RELEVANT_SELECTION_DEFAULTS: {
+    readonly primary: {
+        readonly baseLimit: 3;
+        readonly pressuredExpansionLimit: 4;
+        readonly pressuredThreshold: 4;
+    };
+    readonly stale: {
+        readonly defaultLimit: 1;
+        readonly expandedLimit: 2;
+        readonly overdueThreshold: 2;
+        readonly familySpreadThreshold: 2;
+    };
+};
+export declare const HOOK_HEALTH_DEFAULTS: {
+    readonly maxActiveHooks: 12;
+    readonly staleAfterChapters: 10;
+    readonly noAdvanceWindow: 5;
+    readonly newHookBurstThreshold: 2;
+};
+export declare function resolveHookVisibilityWindow(timing: HookPayoffTiming): number;
+//# sourceMappingURL=hook-policy.d.ts.map

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

@@ -0,0 +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;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

@@ -0,0 +1,96 @@
+export const HOOK_TIMING_PROFILES = {
+    immediate: {
+        earliestResolveAge: 1,
+        staleDormancy: 1,
+        overdueAge: 3,
+        minimumPhase: "opening",
+        resolveBias: 5,
+    },
+    "near-term": {
+        earliestResolveAge: 1,
+        staleDormancy: 2,
+        overdueAge: 5,
+        minimumPhase: "opening",
+        resolveBias: 4,
+    },
+    "mid-arc": {
+        earliestResolveAge: 2,
+        staleDormancy: 4,
+        overdueAge: 8,
+        minimumPhase: "opening",
+        resolveBias: 3,
+    },
+    "slow-burn": {
+        earliestResolveAge: 4,
+        staleDormancy: 5,
+        overdueAge: 12,
+        minimumPhase: "middle",
+        resolveBias: 2,
+    },
+    endgame: {
+        earliestResolveAge: 6,
+        staleDormancy: 6,
+        overdueAge: 16,
+        minimumPhase: "late",
+        resolveBias: 1,
+    },
+};
+export const HOOK_PHASE_WEIGHT = {
+    opening: 0,
+    middle: 1,
+    late: 2,
+};
+export const HOOK_PHASE_THRESHOLDS = {
+    middleProgress: 0.33,
+    lateProgress: 0.72,
+    middleChapter: 8,
+    lateChapter: 24,
+};
+export const HOOK_PRESSURE_WEIGHTS = {
+    staleAdvanceBonus: 8,
+    overdueAdvanceBonus: 6,
+    resolveBiasMultiplier: 10,
+    progressingResolveBonus: 5,
+    dormancyResolveMultiplier: 2,
+    maxDormancyResolveBonus: 12,
+    overdueResolveBonus: 10,
+    mustAdvancePressureFloor: 8,
+    criticalResolvePressure: 40,
+};
+export const HOOK_ACTIVITY_THRESHOLDS = {
+    recentlyTouchedDormancy: 1,
+    longArcQuietHoldMaxAge: 2,
+    longArcQuietHoldMaxDormancy: 1,
+    refreshDormancy: 2,
+    freshPromiseAge: 1,
+};
+export const HOOK_VISIBILITY_WINDOWS = {
+    immediate: 5,
+    "near-term": 5,
+    "mid-arc": 6,
+    "slow-burn": 8,
+    endgame: 10,
+};
+export const HOOK_RELEVANT_SELECTION_DEFAULTS = {
+    primary: {
+        baseLimit: 3,
+        pressuredExpansionLimit: 4,
+        pressuredThreshold: 4,
+    },
+    stale: {
+        defaultLimit: 1,
+        expandedLimit: 2,
+        overdueThreshold: 2,
+        familySpreadThreshold: 2,
+    },
+};
+export const HOOK_HEALTH_DEFAULTS = {
+    maxActiveHooks: 12,
+    staleAfterChapters: 10,
+    noAdvanceWindow: 5,
+    newHookBurstThreshold: 2,
+};
+export function resolveHookVisibilityWindow(timing) {
+    return HOOK_VISIBILITY_WINDOWS[timing];
+}
+//# sourceMappingURL=hook-policy.js.map

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

@@ -0,0 +1 @@
+{"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"}