// ss_stats_box.h - SuperSlab Statistics Box
// Purpose: Global statistics tracking and reporting for SuperSlab allocations
// Box Theory: Centralized metrics collection with thread-safe updates
//
// Responsibilities:
//   - Track global allocation/free counts
//   - Track bytes allocated
//   - Per-class allocation statistics
//   - Statistics reporting (print functions)
//
// Dependencies: None (pure data collection)
//
// License: MIT
// Date: 2025-11-19

#ifndef HAKMEM_SS_STATS_BOX_H
#define HAKMEM_SS_STATS_BOX_H

#include <stdint.h>
#include <stddef.h>
#include <stdatomic.h>
#include "../superslab/superslab_types.h"

// ============================================================================
// Global Statistics (external visibility for tests/debugging)
// ============================================================================

extern uint64_t g_superslabs_allocated;  // Total SuperSlabs allocated
extern uint64_t g_superslabs_freed;      // Total SuperSlabs freed
extern uint64_t g_bytes_allocated;       // Total bytes allocated

extern uint64_t g_ss_alloc_by_class[8];  // Per-class allocation counts
extern uint64_t g_ss_freed_by_class[8];  // Per-class free counts

extern uint64_t g_superslabs_reused;     // Cache hit count
extern uint64_t g_superslabs_cached;     // Cache store count

// Debug counters (free path instrumentation)
extern _Atomic uint64_t g_ss_active_dec_calls;
extern _Atomic uint64_t g_hak_tiny_free_calls;
extern _Atomic uint64_t g_ss_remote_push_calls;
extern _Atomic uint64_t g_free_ss_enter;
extern _Atomic uint64_t g_free_local_box_calls;
extern _Atomic uint64_t g_free_remote_box_calls;

// ============================================================================
// Statistics Update API
// ============================================================================

// Record OS allocation (new SuperSlab from mmap)
// Thread-safe: mutex protected
void ss_stats_os_alloc(uint8_t size_class, size_t ss_size);

// Record cache reuse (SuperSlab from LRU/prewarm cache)
// Thread-safe: mutex protected
void ss_stats_cache_reuse(void);

// Record cache store (SuperSlab stored in cache instead of munmap)
// Thread-safe: mutex protected
void ss_stats_cache_store(void);

// ============================================================================
// Statistics Reporting API
// ============================================================================

// Print per-SuperSlab statistics (for debugging)
void superslab_print_stats(SuperSlab* ss);

// Print global SuperSlab statistics
void superslab_print_global_stats(void);

#endif // HAKMEM_SS_STATS_BOX_H