# 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:
```bash
# 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*