Files
hakmem/docs
Moe Charm (CI) a948332f6c Update REFACTOR_PLAN_GEMINI_ENHANCED.md with Gemini final findings
Status Updates (2025-12-03):
- Phase 0.1-0.2:  Already implemented (ptr_type_box.h, ptr_conversion_box.h)
- Phase 0.3:  VERIFIED - Gemini mathematically proved sh8bench adds +1 to odd returns
- Phase 2: 🔄 RECONSIDERED - Headerless layout is legitimate long-term goal
- Phase 3.1: Current NORMALIZE + log is correct fail-safe behavior

Root Cause Analysis:
- Issue A (Fixed): Header restoration gaps at Box boundaries (4 commits)
- Issue B (Root): hakmem returns odd addresses, violating C standard alignment

Gemini's Proof:
- Log analysis: node=0xe1 → user_ptr=0xe2 = +1 delta
- ASan doesn't reproduce because Redzone ensures alignment
- Conclusion: sh8bench expects alignof(max_align_t), hakmem violates it

Recommendations:
- Short-term: Current defensive measures (Atomic Fence + Header Write) sufficient
- Long-term: Phase 2 (Headerless Layout) for C standard compliance

🤖 Generated with Claude Code

Co-Authored-By: Gemini <gemini@example.com>
Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-03 11:20:18 +09:00
..

Docs Overview

このフォルダは hakmem の設計・計測・運用メモを体系化して管理する場所です。

  • INDEX.md: 目次(各ドキュメントへのリンク)
  • benchmarks/: ベンチマーク手順とスイープ結果の保存先
  • specs/: 現在の仕様SACS3/HW/ENVを集約
  • roadmap/: これからの実装計画・優先度・タスク

運用ルール(提案)

  • 1つの変更/計測のまとまりにつき1ファイルor 1フォルダ
  • 再現コマンド・環境変数・ハード構成は必ず記載
  • 大きな連続出力はファイルへ保存し、本文からは抜粋/要約を記載