tomoaki/hakmem
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
b51b600e8d626601e1deca96d044cd10674c7cb1
hakmem/docs/analysis/ENV_CLEANUP_SUMMARY.md

44 lines
3.1 KiB
Markdown
Raw Normal View History

ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
# ENV Variable Cleanup Analysis - Executive Summary
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
## Scope
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
- **Initial sweep:** 221 unique ENV variables across the runtime (getenv()).
- **Current view:** Core features Ultra/BG/HeapV2 are active and must be preserved (A/B gated only).
- **Docs-only cleanup:** 21 documentation-only variables (zero getenv hits) are tracked separately in `SAFE_TO_DELETE_ENV_VARS.md`.
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
## Key Findings
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
- **Active, keep**: Ultra path (`core/ultra/*`), BG spill (`hakmem_batch.c`, `hakmem_tiny_bg_spill.o`), HeapV2/FrontV2 (`core/front/tiny_heap_v2.h`, `tiny_alloc_fast.inc.h`) are compiled in and runtime-gated. Removing their ENV toggles would break A/B rollback.
- **SFC is live**: `hakmem_tiny_sfc.o` is built; `HAKMEM_SFC_ENABLE/CAPACITY/REFILL_COUNT/DEBUG/STATS_DUMP/CASCADE_PCT` all drive behavior. Debug getenv duplication remains the top low-risk cleanup.
- **Doc-only set**: 21 proposal-only ENV names (adaptive presets, generic debug knobs, legacy build flags) have no getenv calls; safe to drop from docs with zero runtime impact.
- **Count drift**: Including `.inc` helpers raises the current getenv surface to ~279 names; initial 221 figure is kept as the baseline for this project’s first pass.
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
## Quick Wins (low risk, Box-friendly)
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
- **SFC_DEBUG dedup**: Move the four `HAKMEM_SFC_DEBUG` getenv calls behind one init-time flag (`hakmem_tiny_sfc.c` as the boundary). Reduces hot-path getenvs by 3.
- **Doc hygiene**: Remove the 21 docs-only names from `docs/specs/ENV_VARS*.md` to keep the supported surface visible and reversible.
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
## Items to Keep as-is (cannot delete)
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
- **Ultra toggles**: `HAKMEM_TINY_ULTRA_*`, `HAKMEM_ULTRA_SLIM_STATS` — gated experiments but compiled; keep for rollback.
- **BG system**: `HAKMEM_BATCH_BG`, `HAKMEM_L25_BG_DRAIN`, `HAKMEM_L25_BG_MS` — enabled by default; removal would change behavior.
- **HeapV2/FrontV2**: `HAKMEM_TINY_HEAP_V2_*`, `HAKMEM_TINY_FRONT_V2/SLIM/DIRECT/METRICS/DUMP` — active path for tiny frontend; keep.
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Add RELEASE guards to DEBUG ENV variables (14 vars) Added compile-time guards (#if HAKMEM_BUILD_RELEASE) to eliminate DEBUG ENV variable overhead in RELEASE builds. Variables guarded (14 total): - HAKMEM_TINY_TRACE_RING, HAKMEM_TINY_DUMP_RING_ATEXIT - HAKMEM_TINY_RF_TRACE, HAKMEM_TINY_MAILBOX_TRACE - HAKMEM_TINY_MAILBOX_TRACE_LIMIT, HAKMEM_TINY_MAILBOX_SLOWDISC - HAKMEM_TINY_MAILBOX_SLOWDISC_PERIOD - HAKMEM_SS_PREWARM_DEBUG, HAKMEM_SS_FREE_DEBUG - HAKMEM_TINY_FRONT_METRICS, HAKMEM_TINY_FRONT_DUMP - HAKMEM_TINY_COUNTERS_DUMP, HAKMEM_TINY_REFILL_DUMP - HAKMEM_PTR_TRACE_DUMP, HAKMEM_PTR_TRACE_VERBOSE Files modified (9 core files): - core/tiny_debug_ring.c (ring trace/dump) - core/box/mailbox_box.c (mailbox trace + slowdisc) - core/tiny_refill.h (refill trace) - core/hakmem_tiny_superslab.c (superslab debug) - core/box/ss_allocation_box.c (allocation debug) - core/tiny_superslab_free.inc.h (free debug) - core/box/front_metrics_box.c (frontend metrics) - core/hakmem_tiny_stats.c (stats dump) - core/ptr_trace.h (pointer trace) Bug fixes during implementation: 1. mailbox_box.c - Fixed variable scope (moved 'used' outside guard) 2. hakmem_tiny_stats.c - Fixed incomplete declarations (on1, on2) Impact: - Binary size: -85KB total - bench_random_mixed_hakmem: 319K → 305K (-14K, -4.4%) - larson_hakmem: 380K → 309K (-71K, -18.7%) - Performance: No regression (16.9-17.9M ops/s maintained) - Functional: All tests pass (Random Mixed + Larson) - Behavior: DEBUG ENV vars correctly ignored in RELEASE builds Testing: - Build: Clean compilation (warnings only, pre-existing) - 100K Random Mixed: 16.9-17.9M ops/s (PASS) - 10K Larson: 25.9M ops/s (PASS) - DEBUG ENV verification: Correctly ignored (PASS) Result: 14 DEBUG ENV variables now have zero overhead in RELEASE builds. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:41:07 +09:00
## 最新アクション（このセッション）
- `HAKMEM_SFC_DEBUG` を init 1回読みへ集約（ホットパス getenv を排除）。
- リリースビルドで以下の DEBUG/TRACE/STATS 系 ENV を無効化（getenv しない）:
- `HAKMEM_TINY_TRACE_RING`, `HAKMEM_TINY_DUMP_RING_ATEXIT`
- `HAKMEM_TINY_RF_TRACE`, `HAKMEM_TINY_MAILBOX_TRACE`, `HAKMEM_TINY_MAILBOX_TRACE_LIMIT`, `HAKMEM_TINY_MAILBOX_SLOWDISC(_PERIOD)`
- `HAKMEM_SS_PREWARM_DEBUG`, `HAKMEM_SS_FREE_DEBUG`
- `HAKMEM_TINY_FRONT_METRICS`, `HAKMEM_TINY_FRONT_DUMP`
- `HAKMEM_TINY_COUNTERS_DUMP`, `HAKMEM_TINY_REFILL_DUMP`
- `HAKMEM_PTR_TRACE_DUMP`, `HAKMEM_PTR_TRACE_VERBOSE`
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
## Next Steps
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Add RELEASE guards to DEBUG ENV variables (14 vars) Added compile-time guards (#if HAKMEM_BUILD_RELEASE) to eliminate DEBUG ENV variable overhead in RELEASE builds. Variables guarded (14 total): - HAKMEM_TINY_TRACE_RING, HAKMEM_TINY_DUMP_RING_ATEXIT - HAKMEM_TINY_RF_TRACE, HAKMEM_TINY_MAILBOX_TRACE - HAKMEM_TINY_MAILBOX_TRACE_LIMIT, HAKMEM_TINY_MAILBOX_SLOWDISC - HAKMEM_TINY_MAILBOX_SLOWDISC_PERIOD - HAKMEM_SS_PREWARM_DEBUG, HAKMEM_SS_FREE_DEBUG - HAKMEM_TINY_FRONT_METRICS, HAKMEM_TINY_FRONT_DUMP - HAKMEM_TINY_COUNTERS_DUMP, HAKMEM_TINY_REFILL_DUMP - HAKMEM_PTR_TRACE_DUMP, HAKMEM_PTR_TRACE_VERBOSE Files modified (9 core files): - core/tiny_debug_ring.c (ring trace/dump) - core/box/mailbox_box.c (mailbox trace + slowdisc) - core/tiny_refill.h (refill trace) - core/hakmem_tiny_superslab.c (superslab debug) - core/box/ss_allocation_box.c (allocation debug) - core/tiny_superslab_free.inc.h (free debug) - core/box/front_metrics_box.c (frontend metrics) - core/hakmem_tiny_stats.c (stats dump) - core/ptr_trace.h (pointer trace) Bug fixes during implementation: 1. mailbox_box.c - Fixed variable scope (moved 'used' outside guard) 2. hakmem_tiny_stats.c - Fixed incomplete declarations (on1, on2) Impact: - Binary size: -85KB total - bench_random_mixed_hakmem: 319K → 305K (-14K, -4.4%) - larson_hakmem: 380K → 309K (-71K, -18.7%) - Performance: No regression (16.9-17.9M ops/s maintained) - Functional: All tests pass (Random Mixed + Larson) - Behavior: DEBUG ENV vars correctly ignored in RELEASE builds Testing: - Build: Clean compilation (warnings only, pre-existing) - 100K Random Mixed: 16.9-17.9M ops/s (PASS) - 10K Larson: 25.9M ops/s (PASS) - DEBUG ENV verification: Correctly ignored (PASS) Result: 14 DEBUG ENV variables now have zero overhead in RELEASE builds. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:41:07 +09:00
1) 残る DEBUG/TRACE/STATS 系 ENV を同様にリリースビルドで無効化 or init 1回読みへ移動。
2) 21個のドキュメント専用変数を `docs/specs/ENV_VARS*.md` から削除。
3) Ultra/BG/HeapV2 は現役のため A/B ゲートを維持したまま、削除は別フェーズで判断。
ENV cleanup: Remove obsolete ULTRAHOT variable + organize docs Changes: 1. Removed HAKMEM_TINY_FRONT_ENABLE_ULTRAHOT variable - Deleted front_prune_ultrahot_enabled() function - UltraHot feature was removed in commit bcfb4f6b5 - Variable was dead code, no longer referenced 2. Organized ENV cleanup analysis documents - Moved 5 ENV analysis docs to docs/analysis/ - ENV_CLEANUP_PLAN.md - detailed file-by-file plan - ENV_CLEANUP_SUMMARY.md - executive summary - ENV_CLEANUP_ANALYSIS.md - categorized analysis - ENV_CONSOLIDATION_PLAN.md - consolidation proposals - ENV_QUICK_REFERENCE.md - quick reference guide Impact: - ENV variables: 221 → 220 (-1) - Build: ✅ Successful - Risk: Zero (dead code removal) Next steps (documented in ENV_CLEANUP_SUMMARY.md): - 21 variables need verification (Ultra/HeapV2/BG/HotMag) - SFC_DEBUG deduplication opportunity (7 callsites) File: core/box/front_metrics_box.h Status: SAVEPOINT - stable baseline for future ENV cleanup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 17:12:41 +09:00
ENV cleanup: Consolidate SFC_DEBUG getenv() calls (86% reduction) Optimized HAKMEM_SFC_DEBUG environment variable handling by caching the value at initialization instead of repeated getenv() calls in hot paths. Changes: 1. Added g_sfc_debug global variable (core/hakmem_tiny_sfc.c) - Initialized once in sfc_init() by reading HAKMEM_SFC_DEBUG - Single source of truth for SFC debug state 2. Declared g_sfc_debug as extern (core/hakmem_tiny_config.h) - Available to all modules that need SFC debug checks 3. Replaced getenv() with g_sfc_debug in hot paths: - core/tiny_alloc_fast_sfc.inc.h (allocation path) - core/tiny_free_fast.inc.h (free path) - core/box/hak_wrappers.inc.h (wrapper layer) Impact: - getenv() calls: 7 → 1 (86% reduction) - Hot-path calls eliminated: 6 (all moved to init-time) - Performance: 15.10M ops/s (stable, 0% CV) - Build: Clean compilation, no new warnings Testing: - 10 runs of 100K iterations: consistent performance - Symbol verification: g_sfc_debug present in hakmem_tiny_sfc.o - No regression detected Note: 3 additional getenv("HAKMEM_SFC_DEBUG") calls exist in hakmem_tiny_ultra_simple.inc but are dead code (file not compiled in current build configuration). Files modified: 5 core files Status: Production-ready, all tests passed 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-27 03:18:33 +09:00
See `ENV_CLEANUP_PLAN.md` for the full getenv map (file+line) and `ENV_CONSOLIDATION_PLAN.md` for the long-term policy reduction (149 → ~30).
Reference in New Issue Copy Permalink