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

34 lines
2.3 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: 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: 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
1) Implement `HAKMEM_SFC_DEBUG` consolidation (init boundary only).
2) Sweep docs to drop the 21 docs-only variables (no code changes).
3) Maintain A/B gates for Ultra/BG/HeapV2; any deprecation must be feature-flagged with rollback.
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