// smallobject_policy_v7_box.h - SmallObject Policy v7 (Phase v7-4)
//
// Purpose:
//   - Centralized routing policy for ULTRA / v7 / MID_v3 / LEGACY
//   - Single source of truth for class → route_kind mapping
//   - ENV configuration managed in one place (L3 Policy layer)

#ifndef HAKMEM_SMALLOBJECT_POLICY_V7_BOX_H
#define HAKMEM_SMALLOBJECT_POLICY_V7_BOX_H

#include <stdint.h>
#include <stdbool.h>

// ============================================================================
// Route Kind Enum (L0/L1/L1' layer selection)
// ============================================================================

typedef enum {
    SMALL_ROUTE_ULTRA,      // L0: C4-C7 ULTRA (FROZEN)
    SMALL_ROUTE_V7,         // L1: SmallObject v7 (research box)
    SMALL_ROUTE_MID_V3,     // L1': MID v3 (257-768B mid/small)
    SMALL_ROUTE_LEGACY,     // L1': TinyHeap v1 / Pool v1 (fallback)
} SmallRouteKind;

// ============================================================================
// Policy Snapshot Structure
// ============================================================================

typedef struct SmallPolicyV7 {
    SmallRouteKind route_kind[8];  // C0-C7 routing decision
} SmallPolicyV7;

// ============================================================================
// Policy API
// ============================================================================

/// Get policy snapshot (read-only, TLS cached)
/// Frontend calls this to determine route_kind[class_idx]
const SmallPolicyV7* small_policy_v7_snapshot(void);

/// Initialize policy from ENV variables (called once at startup)
/// Priority: ULTRA > v7 > MID_v3 > LEGACY
/// @param policy: Policy structure to initialize
void small_policy_v7_init_from_env(SmallPolicyV7* policy);

/// Get route kind name for debugging
const char* small_route_kind_name(SmallRouteKind kind);

#endif // HAKMEM_SMALLOBJECT_POLICY_V7_BOX_H