hakmem/archive

Archive Directory

This directory contains historical documents, old benchmark results, and experimental work from the HAKMEM memory allocator project.

Structure

phase2/ - Phase 2 Documentation

Phase 2 modularization work (completed):

• IMPLEMENTATION_ROADMAP.md - Original Phase 2 roadmap
• P0_SUCCESS_REPORT.md - P0 batch refill success report (+5.16% improvement)
• README_PHASE_2C.txt - Phase 2C module extraction notes
• PHASE2_MODULE6_*.txt - Module 6 quick reference and summary

analysis/ - Historical Analysis Reports

Research and analysis documents from various optimization phases:

• RING_SIZE_* (4 files) - Ring buffer size analysis
• 3LAYER_* (2 files) - 3-layer allocation strategy experiments
• COMPARISON files - Performance comparisons
• MT_SAFETY_FINDINGS.txt - Multi-threading safety analysis
• NEXT_STEP_ANALYSIS.md - Strategic planning
• gemini_*.txt (4 files) - AI-assisted code reviews

old_benches/ - Historical Benchmark Results

Benchmark results from earlier phases:

• bench_phase*.txt - Phase milestone benchmarks
• bench_step*.txt - Step-by-step optimization results
• bench_reserve*.txt - Reserve pool experiments
• bench_*_results.txt - Various benchmark runs

old_logs/ - Debug and Test Logs

Debug logs, test outputs, and build logs:

• debug_*.log - Debug session logs
• test_*.log - Test execution logs
• obs_*.log - Observation/profiling logs
• build_pgo*.log - PGO build logs
• phase*.log - Phase-specific logs

experimental_scripts/ - Experimental Scripts

Scripts from A/B testing and parameter sweeps:

• ab_*.sh - A/B testing scripts
• sweep_*.sh - Parameter sweep scripts
• prof_sweep.sh - Profile sweeping
• reorg_plan_a.sh - Reorganization experiments

Timeline

• Phase 1: Initial implementation
• Phase 2: Modularization (Module 1-6)
  • Module 2: Ring buffer optimization
  • Module 6: L2 pool extraction
  • P0: Batch refill (+5.16%)
• Phase 3: Mid Range MT allocator (current)
  • Goal: 100-120M ops/sec
  • Result: 110M ops/sec (achieved!)

Restoration

All files in this archive can be restored to the root directory if needed:

# Restore Phase 2 docs
cp archive/phase2/*.md .

# Restore specific analysis
cp archive/analysis/RING_SIZE_INDEX.md .

# Restore benchmark results
cp archive/old_benches/bench_phase1_results.txt .

See Also

• CLEANUP_SUMMARY_2025_11_01.md - Detailed cleanup report
• bench_results/ - Current benchmark results
• perf_data/ - Performance profiling data

---

Archived: 2025-11-01 Total: 71 files preserved