inkos/packages/core/src/utils/hook-policy.ts

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 const HOOK_TIMING_PROFILES: Record<HookPayoffTiming, HookLifecycleProfile> = {
  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: Record<HookPhase, number> = {
  opening: 0,
  middle: 1,
  late: 2,
};

export const HOOK_PHASE_THRESHOLDS = {
  middleProgress: 0.33,
  lateProgress: 0.72,
  middleChapter: 8,
  lateChapter: 24,
} as const;

export const HOOK_PRESSURE_WEIGHTS = {
  staleAdvanceBonus: 8,
  overdueAdvanceBonus: 6,
  resolveBiasMultiplier: 10,
  progressingResolveBonus: 5,
  dormancyResolveMultiplier: 2,
  maxDormancyResolveBonus: 12,
  overdueResolveBonus: 10,
  mustAdvancePressureFloor: 8,
  criticalResolvePressure: 40,
} as const;

export const HOOK_ACTIVITY_THRESHOLDS = {
  recentlyTouchedDormancy: 1,
  longArcQuietHoldMaxAge: 2,
  longArcQuietHoldMaxDormancy: 1,
  refreshDormancy: 2,
  freshPromiseAge: 1,
} as const;

export const HOOK_AGENDA_LIMITS: Record<HookAgendaLoad, {
  readonly staleDebt: number;
  readonly mustAdvance: number;
  readonly eligibleResolve: number;
  readonly avoidFamilies: number;
}> = {
  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,
} as const;

export const HOOK_VISIBILITY_WINDOWS: Record<HookPayoffTiming, number> = {
  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,
  },
} as const;

export const HOOK_HEALTH_DEFAULTS = {
  maxActiveHooks: 12,
  staleAfterChapters: 10,
  noAdvanceWindow: 5,
  newHookBurstThreshold: 2,
} as const;

export function resolveHookVisibilityWindow(timing: HookPayoffTiming): number {
  return HOOK_VISIBILITY_WINDOWS[timing];
}