inkos-n-core 1.2.0

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

@@ -0,0 +1,34 @@
+import type { HookPayoffTiming } from "../models/runtime-state.js";
+import { type HookPhase } from "./hook-policy.js";
+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,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"}

package/dist/utils/hook-lifecycle.js

@@ -0,0 +1,125 @@
+import { HOOK_ACTIVITY_THRESHOLDS, HOOK_PHASE_THRESHOLDS, HOOK_PHASE_WEIGHT, HOOK_PRESSURE_WEIGHTS, HOOK_TIMING_PROFILES, } from "./hook-policy.js";
+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,74 @@
+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;
+    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_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: {
+        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;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"}

package/dist/utils/hook-policy.js

@@ -0,0 +1,126 @@
+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_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,
+    "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":"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"}

package/dist/utils/length-metrics.d.ts

@@ -0,0 +1,10 @@
+import type { LengthCountingMode, LengthNormalizeMode, LengthSpec } from "../models/length-governance.js";
+export type LengthLanguage = "zh" | "en";
+export declare function countChapterLength(content: string, countingMode: LengthCountingMode): number;
+export declare function resolveLengthCountingMode(language?: LengthLanguage): LengthCountingMode;
+export declare function formatLengthCount(count: number, countingMode: LengthCountingMode): string;
+export declare function buildLengthSpec(target: number, language?: LengthLanguage): LengthSpec;
+export declare function isOutsideSoftRange(count: number, spec: Pick<LengthSpec, "softMin" | "softMax">): boolean;
+export declare function isOutsideHardRange(count: number, spec: Pick<LengthSpec, "hardMin" | "hardMax">): boolean;
+export declare function chooseNormalizeMode(count: number, spec: Pick<LengthSpec, "softMin" | "softMax">): LengthNormalizeMode;
+//# sourceMappingURL=length-metrics.d.ts.map

package/dist/utils/length-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length-metrics.d.ts","sourceRoot":"","sources":["../../src/utils/length-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE1G,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AAMzC,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,kBAAkB,GAC/B,MAAM,CASR;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,GAAE,cAAqB,GAC9B,kBAAkB,CAEpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,kBAAkB,GAC/B,MAAM,CAER;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,cAAqB,GAC9B,UAAU,CAiBZ;AAMD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC,GAC5C,OAAO,CAET;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC,GAC5C,OAAO,CAET;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC,GAC5C,mBAAmB,CAIrB"}

package/dist/utils/length-metrics.js

@@ -0,0 +1,85 @@
+const REFERENCE_TARGET = 2200;
+const SOFT_RANGE_DELTA = 300;
+const HARD_RANGE_DELTA = 600;
+export function countChapterLength(content, countingMode) {
+    const normalized = stripMarkdownMetadata(content);
+    if (countingMode === "en_words") {
+        const words = normalized.match(/[A-Za-z0-9]+(?:'[A-Za-z0-9]+)?/g);
+        return words?.length ?? 0;
+    }
+    return normalized.replace(/\s+/g, "").length;
+}
+export function resolveLengthCountingMode(language = "zh") {
+    return language === "en" ? "en_words" : "zh_chars";
+}
+export function formatLengthCount(count, countingMode) {
+    return countingMode === "en_words" ? `${count} words` : `${count}字`;
+}
+export function buildLengthSpec(target, language = "zh") {
+    const softDelta = scaleRangeDelta(target, SOFT_RANGE_DELTA);
+    const hardDelta = Math.max(softDelta, scaleRangeDelta(target, HARD_RANGE_DELTA));
+    const softMin = Math.max(1, target - softDelta);
+    const softMax = target + softDelta;
+    const hardMin = Math.max(1, target - hardDelta);
+    const hardMax = target + hardDelta;
+    return {
+        target,
+        softMin,
+        softMax,
+        hardMin,
+        hardMax,
+        countingMode: resolveLengthCountingMode(language),
+        normalizeMode: "none",
+    };
+}
+function scaleRangeDelta(target, referenceDelta) {
+    return Math.max(1, Math.floor((target * referenceDelta) / REFERENCE_TARGET));
+}
+export function isOutsideSoftRange(count, spec) {
+    return count < spec.softMin || count > spec.softMax;
+}
+export function isOutsideHardRange(count, spec) {
+    return count < spec.hardMin || count > spec.hardMax;
+}
+export function chooseNormalizeMode(count, spec) {
+    if (count < spec.softMin)
+        return "expand";
+    if (count > spec.softMax)
+        return "compress";
+    return "none";
+}
+function stripMarkdownMetadata(content) {
+    const lines = content.replace(/\r\n/g, "\n").replace(/^\uFEFF/, "").split("\n");
+    const proseLines = [];
+    let index = 0;
+    if (lines[index]?.trim() === "---") {
+        index += 1;
+        while (index < lines.length && lines[index]?.trim() !== "---") {
+            index += 1;
+        }
+        if (index < lines.length) {
+            index += 1;
+        }
+    }
+    let inFence = false;
+    for (; index < lines.length; index += 1) {
+        const line = lines[index] ?? "";
+        const trimmed = line.trim();
+        if (/^(```|~~~)/.test(trimmed)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence) {
+            continue;
+        }
+        if (/^#{1,6}\s+/.test(trimmed)) {
+            continue;
+        }
+        if (trimmed === "---" || trimmed === "...") {
+            continue;
+        }
+        proseLines.push(line);
+    }
+    return proseLines.join("\n");
+}
+//# sourceMappingURL=length-metrics.js.map

package/dist/utils/length-metrics.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,31 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogEntry {
+    readonly level: LogLevel;
+    readonly tag: string;
+    readonly message: string;
+    readonly timestamp: string;
+    readonly ctx?: Record<string, unknown>;
+}
+export interface LogSink {
+    readonly write: (entry: LogEntry) => void;
+}
+export interface Logger {
+    readonly debug: (msg: string, ctx?: Record<string, unknown>) => void;
+    readonly info: (msg: string, ctx?: Record<string, unknown>) => void;
+    readonly warn: (msg: string, ctx?: Record<string, unknown>) => void;
+    readonly error: (msg: string, ctx?: Record<string, unknown>) => void;
+    readonly child: (tag: string, extraCtx?: Record<string, unknown>) => Logger;
+}
+export declare function createStderrSink(options: {
+    readonly minLevel?: LogLevel;
+    readonly enableColors?: boolean;
+}): LogSink;
+export declare function createJsonLineSink(writable: NodeJS.WritableStream): LogSink;
+export declare const nullSink: LogSink;
+export declare function createLogger(options: {
+    readonly tag: string;
+    readonly sinks: ReadonlyArray<LogSink>;
+    readonly minLevel?: LogLevel;
+    readonly baseCtx?: Record<string, unknown>;
+}): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;CAC7E;AAuBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CAsBV;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,cAAc,GAAG,OAAO,CAM3E;AAED,eAAO,MAAM,QAAQ,EAAE,OAEtB,CAAC;AAIF,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C,GAAG,MAAM,CA+BT"}

package/dist/utils/logger.js

@@ -0,0 +1,79 @@
+// === Types ===
+// === Level Ordering ===
+const LEVEL_ORDER = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+// === ANSI Colors ===
+const COLORS = {
+    debug: "\x1b[90m", // gray
+    info: "\x1b[36m", // cyan
+    warn: "\x1b[33m", // yellow
+    error: "\x1b[31m", // red
+};
+const RESET = "\x1b[0m";
+// === Built-in Sinks ===
+export function createStderrSink(options) {
+    const minLevel = options.minLevel ?? "info";
+    const enableColors = options.enableColors ?? (process.stderr.isTTY ?? false);
+    const minOrder = LEVEL_ORDER[minLevel];
+    return {
+        write(entry) {
+            if (LEVEL_ORDER[entry.level] < minOrder)
+                return;
+            const levelTag = entry.level.toUpperCase().padEnd(5);
+            const prefix = `[${entry.tag}]`;
+            if (enableColors) {
+                const color = COLORS[entry.level];
+                process.stderr.write(`${color}${levelTag}${RESET} ${prefix} ${entry.message}\n`);
+            }
+            else {
+                process.stderr.write(`${levelTag} ${prefix} ${entry.message}\n`);
+            }
+        },
+    };
+}
+export function createJsonLineSink(writable) {
+    return {
+        write(entry) {
+            writable.write(JSON.stringify(entry) + "\n");
+        },
+    };
+}
+export const nullSink = {
+    write() { },
+};
+// === Factory ===
+export function createLogger(options) {
+    const { tag, sinks, baseCtx } = options;
+    function emit(level, msg, ctx) {
+        const entry = {
+            level,
+            tag,
+            message: msg,
+            timestamp: new Date().toISOString(),
+            ...(ctx || baseCtx
+                ? { ctx: { ...baseCtx, ...ctx } }
+                : {}),
+        };
+        for (const sink of sinks) {
+            sink.write(entry);
+        }
+    }
+    return {
+        debug: (msg, ctx) => emit("debug", msg, ctx),
+        info: (msg, ctx) => emit("info", msg, ctx),
+        warn: (msg, ctx) => emit("warn", msg, ctx),
+        error: (msg, ctx) => emit("error", msg, ctx),
+        child(childTag, extraCtx) {
+            return createLogger({
+                tag: childTag,
+                sinks,
+                baseCtx: { ...baseCtx, ...extraCtx },
+            });
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/long-span-fatigue.d.ts

@@ -0,0 +1,28 @@
+export interface LongSpanFatigueIssue {
+    readonly severity: "warning";
+    readonly category: string;
+    readonly description: string;
+    readonly suggestion: string;
+}
+export interface AnalyzeLongSpanFatigueInput {
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+    readonly chapterContent: string;
+    readonly chapterSummary?: string;
+    readonly language?: "zh" | "en";
+}
+export interface EnglishVarianceBrief {
+    readonly highFrequencyPhrases: ReadonlyArray<string>;
+    readonly repeatedOpeningPatterns: ReadonlyArray<string>;
+    readonly repeatedEndingShapes: ReadonlyArray<string>;
+    readonly sceneObligation: string;
+    readonly text: string;
+}
+export declare function buildEnglishVarianceBrief(params: {
+    readonly bookDir: string;
+    readonly chapterNumber: number;
+}): Promise<EnglishVarianceBrief | null>;
+export declare function analyzeLongSpanFatigue(input: AnalyzeLongSpanFatigueInput): Promise<{
+    readonly issues: ReadonlyArray<LongSpanFatigueIssue>;
+}>;
+//# sourceMappingURL=long-span-fatigue.d.ts.map

package/dist/utils/long-span-fatigue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-span-fatigue.d.ts","sourceRoot":"","sources":["../../src/utils/long-span-fatigue.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,uBAAuB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAYD,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyCvC;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;CAAE,CAAC,CA+CnE"}