// tiny_ultra_page_arena.h - UltraHeap backend (heap→page) telemetry box
//
// 目的:
//   - UltraFront Heap (L0) から見た「page 層」の顔を 1 箇所に集約する。
//   - 現段階では Superslab refill 回数などの観察用カウンタのみを提供し、
//     既存の shared pool / superslab 実装には手を入れない。
//   - 将来的に PageArena / LRU / prewarm のポリシーをここに集約する足場。

#ifndef HAK_ULTRA_TINY_ULTRA_PAGE_ARENA_H
#define HAK_ULTRA_TINY_ULTRA_PAGE_ARENA_H

#include "../hakmem_tiny.h"           // TINY_NUM_CLASSES
#include "../hakmem_tiny_superslab.h" // SuperSlab

// Ultra backend stats (per-thread, Tiny classes only)
typedef struct TinyUltraPageStats {
    // Superslab refills per class (heap→page 境界が何回発火したか)
    uint64_t superslab_refills[TINY_NUM_CLASSES];
} TinyUltraPageStats;

// Per-thread stats instance
extern __thread TinyUltraPageStats g_tiny_ultra_page_stats;

// heap→page 境界通知:
//  - superslab_refill() が成功して TLS slab が新しい Superslab を掴んだタイミングで呼ぶ。
//  - 現状は統計を増やすだけで挙動は変えない（Fail-Fast／ポリシーは今後追加）。
void tiny_ultra_page_on_refill(int class_idx, SuperSlab* ss);

// 統計スナップショット取得（TinyUltraHeap からも参照可能）
//  - reset!=0 のとき、読み取り後に 0 クリア。
void tiny_ultra_page_stats_snapshot(uint64_t refills[TINY_NUM_CLASSES],
                                    int reset);

// Global Superslab refill stats (all threads aggregated)
//  - 学習スレッドなど、TinyUltraHeap を直接触らないスレッドから利用するための箱。
//  - per-thread カウンタとは別に、軽量な _Atomic 集計を持つ。
//    reset!=0 のとき、読み取り後に 0 クリア。
void tiny_ultra_page_global_stats_snapshot(uint64_t refills[TINY_NUM_CLASSES],
                                           int reset);

#endif // HAK_ULTRA_TINY_ULTRA_PAGE_ARENA_H