@actalk/inkos-core 1.3.6 → 1.3.7

package/dist/utils/hook-promotion.js

@@ -0,0 +1,241 @@
+/**
+ * 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.
+ */
+export function shouldPromoteHook(hook, context) {
+    const reasons = [];
+    if (hook.coreHook === true) {
+        reasons.push("core_hook");
+    }
+    if ((hook.dependsOn?.length ?? 0) > 0) {
+        reasons.push("depends_on");
+    }
+    const advancedCount = hook.advancedCount
+        ?? context.advancedCounts.get(hook.hookId)
+        ?? 0;
+    if (advancedCount >= 2) {
+        reasons.push("advanced_count");
+    }
+    if (isCrossVolume(hook, context)) {
+        reasons.push("cross_volume");
+    }
+    return {
+        promote: reasons.length > 0,
+        reasons,
+    };
+}
+function isCrossVolume(hook, context) {
+    const { volumeBoundaries, allSeedStartChapters } = context;
+    if (volumeBoundaries.length < 2)
+        return false;
+    const seedVolumeIndex = findVolumeIndex(volumeBoundaries, hook.startChapter);
+    if (seedVolumeIndex < 0)
+        return false;
+    // Case A: upstream hook is declared in a later volume than this seed.
+    for (const upstreamId of hook.dependsOn ?? []) {
+        const upstreamStart = allSeedStartChapters.get(upstreamId);
+        if (upstreamStart === undefined)
+            continue;
+        const upstreamVolumeIndex = findVolumeIndex(volumeBoundaries, upstreamStart);
+        if (upstreamVolumeIndex > seedVolumeIndex)
+            return true;
+    }
+    // Case B: pays_off_in_arc mentions a different volume. We stay prose-friendly
+    // and only detect obvious "第 N 卷" / "volume N" tokens. When parsing fails
+    // we fall back to payoff timing heuristics.
+    const arcVolumeIndex = extractVolumeIndexFromArc(hook.paysOffInArc ?? "");
+    if (arcVolumeIndex !== null && arcVolumeIndex !== seedVolumeIndex) {
+        return true;
+    }
+    // Case C: payoff timing marks it as endgame / slow-burn while the hook is
+    // planted in an early volume — that alone qualifies as cross-volume.
+    if ((hook.payoffTiming === "endgame" || hook.payoffTiming === "slow-burn")
+        && seedVolumeIndex < volumeBoundaries.length - 1) {
+        return true;
+    }
+    return false;
+}
+function findVolumeIndex(boundaries, chapter) {
+    for (let i = 0; i < boundaries.length; i++) {
+        const vol = boundaries[i];
+        if (chapter >= vol.startCh && chapter <= vol.endCh)
+            return i;
+    }
+    // Chapter 0 (seed time) counts as volume 0 if volumes start at 1.
+    if (chapter <= 0 && boundaries.length > 0)
+        return 0;
+    return -1;
+}
+const VOLUME_PATTERNS = [
+    /第\s*([一二三四五六七八九十百千\d]+)\s*卷/u,
+    /volume\s+(\d+)/i,
+    /vol\.?\s*(\d+)/i,
+];
+function extractVolumeIndexFromArc(arc) {
+    const trimmed = arc.trim();
+    if (!trimmed)
+        return null;
+    for (const pattern of VOLUME_PATTERNS) {
+        const match = trimmed.match(pattern);
+        if (!match)
+            continue;
+        const token = match[1] ?? "";
+        const n = parseVolumeNumber(token);
+        if (n !== null)
+            return n - 1; // 1-indexed in prose, 0-indexed here.
+    }
+    return null;
+}
+const CHINESE_NUMERALS = {
+    一: 1, 二: 2, 三: 3, 四: 4, 五: 5,
+    六: 6, 七: 7, 八: 8, 九: 9, 十: 10,
+};
+function parseVolumeNumber(token) {
+    if (/^\d+$/.test(token))
+        return parseInt(token, 10);
+    if (token.length === 1 && CHINESE_NUMERALS[token])
+        return CHINESE_NUMERALS[token];
+    if (token === "十")
+        return 10;
+    return null;
+}
+/**
+ * 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 function defaultHalfLifeChapters(payoffTiming) {
+    switch (payoffTiming) {
+        case "immediate":
+        case "near-term":
+            return 10;
+        case "slow-burn":
+        case "endgame":
+            return 80;
+        case "mid-arc":
+        default:
+            return 30;
+    }
+}
+export function resolveHalfLifeChapters(hook) {
+    return hook.halfLifeChapters ?? defaultHalfLifeChapters(hook.payoffTiming);
+}
+// ---------------------------------------------------------------------------
+// Shared advanced_count promotion pass (used by both consolidator and runner)
+// ---------------------------------------------------------------------------
+/**
+ * Escape special regex characters in a string so it can be used as a
+ * literal pattern inside `new RegExp(...)`.
+ */
+export function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * 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 function deriveAdvancedCountsFromSummaries(summariesRaw, hookIds) {
+    const counts = new Map();
+    if (!summariesRaw.trim() || hookIds.length === 0)
+        return counts;
+    const lines = summariesRaw.split("\n");
+    // Detect hookActivity column index from the header row.
+    const hookActivityIndex = detectHookActivityColumnIndex(lines);
+    for (const hookId of hookIds) {
+        const escaped = escapeRegex(hookId);
+        const pattern = new RegExp(`\\b${escaped}\\b`, "i");
+        let count = 0;
+        for (const line of lines) {
+            if (!line.startsWith("|"))
+                continue;
+            // Skip header / separator rows.
+            if (line.includes("---") || /\|\s*(章节|Chapter)\s*\|/i.test(line))
+                continue;
+            // Only match in the hookActivity column, not the full row.
+            const cell = extractColumn(line, hookActivityIndex);
+            if (cell !== null && pattern.test(cell))
+                count += 1;
+        }
+        if (count > 0)
+            counts.set(hookId, count);
+    }
+    return counts;
+}
+/**
+ * Find the 0-based column index of the hookActivity / 伏笔动态 header.
+ * Falls back to 5 (the standard position in our schema).
+ */
+function detectHookActivityColumnIndex(lines) {
+    const DEFAULT_INDEX = 5;
+    for (const line of lines) {
+        if (!line.startsWith("|"))
+            continue;
+        if (/\|\s*(章节|Chapter)\s*\|/i.test(line)) {
+            const cols = line.split("|").map((c) => c.trim());
+            const idx = cols.findIndex((c) => /^(伏笔动态|hookActivity)$/i.test(c));
+            return idx >= 0 ? idx : DEFAULT_INDEX;
+        }
+    }
+    return DEFAULT_INDEX;
+}
+/**
+ * Extract a single column value from a pipe-delimited table row.
+ * Returns null when the column index is out of range.
+ */
+function extractColumn(row, index) {
+    const cols = row.split("|");
+    if (index >= 0 && index < cols.length) {
+        return cols[index].trim();
+    }
+    return null;
+}
+/**
+ * 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 function rerunPromotionPass(hooks, summariesRaw) {
+    if (hooks.length === 0) {
+        return { updated: false, hooks, flippedCount: 0 };
+    }
+    const derivedCounts = deriveAdvancedCountsFromSummaries(summariesRaw, hooks.map((h) => h.hookId));
+    let flipped = 0;
+    const nextHooks = hooks.map((hook) => {
+        if (hook.promoted === true)
+            return hook;
+        const advanced = hook.advancedCount ?? derivedCounts.get(hook.hookId) ?? 0;
+        if (advanced >= 2) {
+            flipped += 1;
+            return { ...hook, promoted: true };
+        }
+        return hook;
+    });
+    return {
+        updated: flipped > 0,
+        hooks: nextHooks,
+        flippedCount: flipped,
+    };
+}
+//# sourceMappingURL=hook-promotion.js.map

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

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

package/dist/utils/hook-stale-detection.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Phase 7 — stale / blocked hook detection.
+ *
+ * Runs per-chapter (called from the writer's runtime-state projection
+ * pipeline when it emits pending_hooks.md). Tags hooks the reviewer and
+ * writer-planner should pay attention to:
+ *
+ *   stale   — planted long ago (distance > half_life) and still not
+ *             marked paid-off / resolved.
+ *   blocked — depends_on references upstream hooks that are still
+ *             unplanted or unresolved.
+ *
+ * The detection is pure: given the current hook list + current chapter
+ * number, it returns a map of hook id -> diagnostic flags. Nothing is
+ * persisted outside the rendered markdown.
+ */
+import type { StoredHook } from "../state/memory-db.js";
+import type { HookRecord } from "../models/runtime-state.js";
+export interface HookDiagnostics {
+    readonly stale: boolean;
+    readonly blocked: boolean;
+    readonly missingUpstream: ReadonlyArray<string>;
+    readonly distance: number;
+    readonly halfLife: number;
+    /**
+     * Phase 7 hotfix 3 — number of chapters this hook has been blocked.
+     *
+     * When blocked=false this is 0. When blocked=true it is computed as:
+     *   max over unresolved upstream of (currentChapter - referenceChapter)
+     * where referenceChapter is:
+     *   - upstream.startChapter, if upstream is planted (startChapter > 0)
+     *   - hook.startChapter, if upstream is missing or not yet planted
+     *     (blocked since this hook's own planting)
+     *
+     * Reviewer reads this as the "blocked Y chapters" token for threshold
+     * evaluation (5/6+ chapters → warning).
+     */
+    readonly blockedDistance: number;
+}
+type HookLike = StoredHook | HookRecord;
+export declare function computeHookDiagnostics(params: {
+    readonly hooks: ReadonlyArray<HookLike>;
+    readonly currentChapter: number;
+}): Map<string, HookDiagnostics>;
+/**
+ * Render the diagnostic flags as a compact marker string suitable for
+ * appending to an existing table cell. Empty when nothing is flagged.
+ */
+export declare function renderHookDiagnosticMarker(diagnostics: HookDiagnostics, language: "zh" | "en"): string;
+export {};
+//# sourceMappingURL=hook-stale-detection.d.ts.map

package/dist/utils/hook-stale-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-stale-detection.d.ts","sourceRoot":"","sources":["../../src/utils/hook-stale-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAG7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,KAAK,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAexC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CA2E/B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,eAAe,EAC5B,QAAQ,EAAE,IAAI,GAAG,IAAI,GACpB,MAAM,CAsBR"}

package/dist/utils/hook-stale-detection.js

@@ -0,0 +1,125 @@
+/**
+ * Phase 7 — stale / blocked hook detection.
+ *
+ * Runs per-chapter (called from the writer's runtime-state projection
+ * pipeline when it emits pending_hooks.md). Tags hooks the reviewer and
+ * writer-planner should pay attention to:
+ *
+ *   stale   — planted long ago (distance > half_life) and still not
+ *             marked paid-off / resolved.
+ *   blocked — depends_on references upstream hooks that are still
+ *             unplanted or unresolved.
+ *
+ * The detection is pure: given the current hook list + current chapter
+ * number, it returns a map of hook id -> diagnostic flags. Nothing is
+ * persisted outside the rendered markdown.
+ */
+import { resolveHalfLifeChapters } from "./hook-promotion.js";
+const RESOLVED_STATUSES = [
+    /^resolved$/i,
+    /^closed$/i,
+    /^done$/i,
+    /^已回收$/,
+    /^已解决$/,
+];
+function isResolved(hook) {
+    const status = (hook.status ?? "").trim();
+    return RESOLVED_STATUSES.some((pattern) => pattern.test(status));
+}
+export function computeHookDiagnostics(params) {
+    const { hooks, currentChapter } = params;
+    const byId = new Map();
+    for (const hook of hooks) {
+        byId.set(hook.hookId, hook);
+    }
+    const result = new Map();
+    for (const hook of hooks) {
+        const halfLife = resolveHalfLifeChapters(hook);
+        const plantedChapter = Math.max(0, hook.startChapter);
+        const distance = Math.max(0, currentChapter - plantedChapter);
+        // Stale: past half-life AND not resolved AND actually planted
+        // (startChapter > 0 — a seed with startChapter 0 is a pre-planting seed).
+        const stale = !isResolved(hook)
+            && plantedChapter > 0
+            && distance > halfLife;
+        // Blocked: depends_on references a hook that is unplanted or unresolved.
+        // Hotfix 3: also track per-upstream reference chapter so we can compute
+        // how long this hook has been blocked (for reviewer threshold eval).
+        const missingUpstream = [];
+        const upstreamReferenceChapters = [];
+        for (const upstreamId of hook.dependsOn ?? []) {
+            const upstream = byId.get(upstreamId);
+            if (!upstream) {
+                missingUpstream.push(upstreamId);
+                // Upstream missing from ledger entirely — we've been blocked since
+                // our own planting (or since chapter 0 if we're a pre-planting seed).
+                upstreamReferenceChapters.push(plantedChapter);
+                continue;
+            }
+            // Upstream is "planted but not delivered" if startChapter is non-zero
+            // AND it's not resolved. An upstream that is still a seed (startChapter
+            // 0) counts as unplanted.
+            const upstreamResolved = isResolved(upstream);
+            const upstreamPlanted = upstream.startChapter > 0
+                && upstream.startChapter <= currentChapter;
+            if (!upstreamPlanted || !upstreamResolved) {
+                // We only block when the upstream genuinely has not cleared its gate.
+                // For a pure "must be planted first" relationship, "planted but not
+                // resolved" still counts as blocking the downstream from firing.
+                missingUpstream.push(upstreamId);
+                // Blocked since upstream planting (if planted) or since our own
+                // planting (if upstream still unplanted).
+                const referenceChapter = upstreamPlanted
+                    ? upstream.startChapter
+                    : plantedChapter;
+                upstreamReferenceChapters.push(referenceChapter);
+            }
+        }
+        const blocked = missingUpstream.length > 0 && !isResolved(hook);
+        // Blocked distance = chapters elapsed since the *earliest* reference
+        // chapter among unresolved upstream. Picking the min reference yields the
+        // max distance — the longest any of these gates has held us up.
+        let blockedDistance = 0;
+        if (blocked && upstreamReferenceChapters.length > 0) {
+            const earliestReference = Math.min(...upstreamReferenceChapters);
+            blockedDistance = Math.max(0, currentChapter - earliestReference);
+        }
+        result.set(hook.hookId, {
+            stale,
+            blocked,
+            missingUpstream,
+            distance,
+            halfLife,
+            blockedDistance,
+        });
+    }
+    return result;
+}
+/**
+ * Render the diagnostic flags as a compact marker string suitable for
+ * appending to an existing table cell. Empty when nothing is flagged.
+ */
+export function renderHookDiagnosticMarker(diagnostics, language) {
+    const tokens = [];
+    if (diagnostics.stale) {
+        tokens.push(language === "en"
+            ? `stale (d=${diagnostics.distance}/half=${diagnostics.halfLife})`
+            : `过期 (距=${diagnostics.distance}/半衰=${diagnostics.halfLife})`);
+    }
+    if (diagnostics.blocked) {
+        const missing = diagnostics.missingUpstream.join(", ");
+        // Hotfix 3: embed the blocked distance so reviewer can apply its 5/6-chapter
+        // threshold without guessing. Token format is load-bearing — it's read by
+        // the reviewer prompt verbatim.
+        const distanceToken = diagnostics.blockedDistance > 0
+            ? (language === "en"
+                ? ` (blocked ${diagnostics.blockedDistance} chapters)`
+                : ` (已阻 ${diagnostics.blockedDistance} 章)`)
+            : "";
+        tokens.push(language === "en"
+            ? `blocked on ${missing}${distanceToken}`
+            : `受阻于 ${missing}${distanceToken}`);
+    }
+    return tokens.join("; ");
+}
+//# sourceMappingURL=hook-stale-detection.js.map

package/dist/utils/hook-stale-detection.js.map

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

package/dist/utils/llm-endpoint-auth.d.ts

@@ -0,0 +1,5 @@
+export declare function isApiKeyOptionalForEndpoint(params: {
+    readonly provider?: string | undefined;
+    readonly baseUrl?: string | undefined;
+}): boolean;
+//# sourceMappingURL=llm-endpoint-auth.d.ts.map

package/dist/utils/llm-endpoint-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-endpoint-auth.d.ts","sourceRoot":"","sources":["../../src/utils/llm-endpoint-auth.ts"],"names":[],"mappings":"AAAA,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,GAAG,OAAO,CAwBV"}

package/dist/utils/llm-endpoint-auth.js

@@ -0,0 +1,36 @@
+export function isApiKeyOptionalForEndpoint(params) {
+    if (params.provider === "anthropic") {
+        return false;
+    }
+    if (!params.baseUrl) {
+        return false;
+    }
+    try {
+        const url = new URL(params.baseUrl);
+        const hostname = url.hostname.toLowerCase();
+        return (hostname === "localhost"
+            || hostname === "127.0.0.1"
+            || hostname === "::1"
+            || hostname === "0.0.0.0"
+            || hostname === "host.docker.internal"
+            || hostname.endsWith(".local")
+            || isPrivateIpv4(hostname));
+    }
+    catch {
+        return false;
+    }
+}
+function isPrivateIpv4(hostname) {
+    const parts = hostname.split(".").map((segment) => Number.parseInt(segment, 10));
+    if (parts.length !== 4 || parts.some((part) => Number.isNaN(part) || part < 0 || part > 255)) {
+        return false;
+    }
+    if (parts[0] === 10)
+        return true;
+    if (parts[0] === 192 && parts[1] === 168)
+        return true;
+    if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
+        return true;
+    return false;
+}
+//# sourceMappingURL=llm-endpoint-auth.js.map

package/dist/utils/llm-endpoint-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-endpoint-auth.js","sourceRoot":"","sources":["../../src/utils/llm-endpoint-auth.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CAAC,MAG3C;IACC,IAAI,MAAM,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE5C,OAAO,CACL,QAAQ,KAAK,WAAW;eACrB,QAAQ,KAAK,WAAW;eACxB,QAAQ,KAAK,KAAK;eAClB,QAAQ,KAAK,SAAS;eACtB,QAAQ,KAAK,sBAAsB;eACnC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;eAC3B,aAAa,CAAC,QAAQ,CAAC,CAC3B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/llm-env.d.ts

@@ -0,0 +1,14 @@
+export declare const GLOBAL_CONFIG_DIR: string;
+export declare const GLOBAL_ENV_PATH: string;
+export type LLMEnvMap = Record<string, string | undefined>;
+export interface LLMEnvLayers {
+    readonly global: LLMEnvMap;
+    readonly project: LLMEnvMap;
+    readonly process: LLMEnvMap;
+}
+export declare function loadLLMEnvLayers(root: string, processEnv?: NodeJS.ProcessEnv): Promise<LLMEnvLayers>;
+export declare function mergeEnvMaps(...layers: readonly LLMEnvMap[]): LLMEnvMap;
+export declare function studioIgnoredEnv(layers: LLMEnvLayers): LLMEnvMap;
+export declare function cliOverlayEnv(layers: LLMEnvLayers): LLMEnvMap;
+export declare function legacyEnv(layers: LLMEnvLayers): LLMEnvMap;
+//# sourceMappingURL=llm-env.d.ts.map

package/dist/utils/llm-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-env.d.ts","sourceRoot":"","sources":["../../src/utils/llm-env.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB,QAA4B,CAAC;AAC3D,eAAO,MAAM,eAAe,QAAkC,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,CAAC,UAAwB,GAC1C,OAAO,CAAC,YAAY,CAAC,CAWvB;AAED,wBAAgB,YAAY,CAAC,GAAG,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAQvE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAEhE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAE7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAEzD"}

package/dist/utils/llm-env.js

@@ -0,0 +1,53 @@
+import { readFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parse } from "dotenv";
+export const GLOBAL_CONFIG_DIR = join(homedir(), ".inkos");
+export const GLOBAL_ENV_PATH = join(GLOBAL_CONFIG_DIR, ".env");
+export async function loadLLMEnvLayers(root, processEnv = process.env) {
+    const global = await parseEnvFile(GLOBAL_ENV_PATH);
+    const project = await parseEnvFile(join(root, ".env"));
+    // Compatibility: modelOverrides.apiKeyEnv and detector config still read process.env directly.
+    hydrateProcessEnvFromEnvFiles(processEnv, global, project);
+    return {
+        global,
+        project,
+        process: { ...processEnv },
+    };
+}
+export function mergeEnvMaps(...layers) {
+    const merged = {};
+    for (const layer of layers) {
+        for (const [key, value] of Object.entries(layer)) {
+            if (value !== undefined)
+                merged[key] = value;
+        }
+    }
+    return merged;
+}
+export function studioIgnoredEnv(layers) {
+    return mergeEnvMaps(layers.global, layers.project, layers.process);
+}
+export function cliOverlayEnv(layers) {
+    return mergeEnvMaps(layers.global, layers.project, layers.process);
+}
+export function legacyEnv(layers) {
+    return mergeEnvMaps(layers.global, layers.project, layers.process);
+}
+async function parseEnvFile(path) {
+    try {
+        return parse(await readFile(path, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function hydrateProcessEnvFromEnvFiles(processEnv, global, project) {
+    const fileEnv = mergeEnvMaps(global, project);
+    for (const [key, value] of Object.entries(fileEnv)) {
+        if (value !== undefined && processEnv[key] === undefined) {
+            processEnv[key] = value;
+        }
+    }
+}
+//# sourceMappingURL=llm-env.js.map

package/dist/utils/llm-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-env.js","sourceRoot":"","sources":["../../src/utils/llm-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAU/D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,aAAgC,OAAO,CAAC,GAAG;IAE3C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,+FAA+F;IAC/F,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3D,OAAO;QACL,MAAM;QACN,OAAO;QACP,OAAO,EAAE,EAAE,GAAG,UAAU,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAG,MAA4B;IAC1D,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAoB;IAC5C,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,6BAA6B,CACpC,UAA6B,EAC7B,MAAiB,EACjB,OAAkB;IAElB,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACzD,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/memory-retrieval.d.ts

@@ -1,10 +1,16 @@
 import { type Fact, type StoredHook, type StoredSummary } from "../state/memory-db.js";
-export { buildPlannerHookAgenda, isFuturePlannedHook, isHookWithinChapterWindow, } from "./hook-agenda.js";
+export { isFuturePlannedHook, isHookWithinChapterWindow, } from "./hook-lifecycle.js";
 export { parseChapterSummariesMarkdown, parseCurrentStateFacts, parsePendingHooksMarkdown, renderHookSnapshot, renderSummarySnapshot, } from "./story-markdown.js";
 export interface MemorySelection {
     readonly summaries: ReadonlyArray<StoredSummary>;
     readonly hooks: ReadonlyArray<StoredHook>;
     readonly activeHooks: ReadonlyArray<StoredHook>;
+    /**
+     * Hooks with recycling pressure — stale hooks that the planner must
+     * advance/resolve/defer (and if deferred, justify). Sorted by staleness DESC
+     * (most overdue first). See computeRecyclableHooks for the selection rule.
+     */
+    readonly recyclableHooks: ReadonlyArray<StoredHook>;
     readonly facts: ReadonlyArray<Fact>;
     readonly volumeSummaries: ReadonlyArray<VolumeSummarySelection>;
     readonly dbPath?: string;
@@ -21,5 +27,21 @@ export declare function retrieveMemorySelection(params: {
     readonly outlineNode?: string;
     readonly mustKeep?: ReadonlyArray<string>;
 }): Promise<MemorySelection>;
+/**
+ * Phase 9-2: Hooks that the planner MUST address this chapter.
+ *
+ * An active hook is "recyclable" (i.e., stale enough to force an
+ * advance/resolve/defer decision) when any of the following holds:
+ *
+ *   - pressured / near_payoff / progressing: silent for ≥ 5 chapters
+ *   - planted / open: silent for ≥ 10 chapters
+ *   - coreHook === true:                      silent for ≥ 8 chapters
+ *
+ * "Silent" = (chapterNumber − max(startChapter, lastAdvancedChapter)).
+ * Future-planted hooks are excluded (they aren't overdue yet).
+ * Sorted by silence DESC — most overdue first — so the planner sees the
+ * worst debt at the top of its prompt slice.
+ */
+export declare function computeRecyclableHooks(hooks: ReadonlyArray<StoredHook>, chapterNumber: number): StoredHook[];
 export declare function extractQueryTerms(goal: string, outlineNode: string | undefined, mustKeep: ReadonlyArray<string>): string[];
 //# sourceMappingURL=memory-retrieval.d.ts.map

package/dist/utils/memory-retrieval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-retrieval.d.ts","sourceRoot":"","sources":["../../src/utils/memory-retrieval.ts"],"names":[],"mappings":"AAQA,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAejG,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C,GAAG,OAAO,CAAC,eAAe,CAAC,CAmG3B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAc1H"}
+{"version":3,"file":"memory-retrieval.d.ts","sourceRoot":"","sources":["../../src/utils/memory-retrieval.ts"],"names":[],"mappings":"AAQA,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAcjG,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C,GAAG,OAAO,CAAC,eAAe,CAAC,CAqG3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,EAChC,aAAa,EAAE,MAAM,GACpB,UAAU,EAAE,CAQd;AAmBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAc1H"}