hakmem/docs/analysis/PHASE4_E3_ENV_CONSTRUCTOR_INIT_NEXT_INSTRUCTIONS.md

Phase 4 E3-4: ENV Constructor Init（次の指示書）

Status（2025-12-14）

• ✅ 実装済み（research box / default OFF）
• A/B（Mixed, 10-run, iter=20M, ws=400, E1=1）で +4.75% mean / +4.35% median を観測
• ENV:
  • E1: HAKMEM_ENV_SNAPSHOT=0/1（default 0）
  • E3-4: HAKMEM_ENV_SNAPSHOT_CTOR=0/1（default 0、E1=1 前提）

ゴール

1. “E3-4 の勝ち” を再確認して固定化する
2. 本線（プリセット）へ昇格するか判断する（戻せる形で）

---

Step 0: 前提（E1 を ON にして測る）

E3-4 は hakmem_env_snapshot_enabled() の gate 判定を短絡する最適化なので、E1 が ON であることが前提。

---

Step 1: Build & 健康診断（先に通す）

make bench_random_mixed_hakmem -j
scripts/verify_health_profiles.sh

---

Step 2: A/B（Mixed 10-run）

Mixed 10-run（iter=20M, ws=400）:

# Baseline: ctor=0
HAKMEM_PROFILE=MIXED_TINYV3_C7_SAFE \
HAKMEM_ENV_SNAPSHOT=1 \
HAKMEM_ENV_SNAPSHOT_CTOR=0 \
./bench_random_mixed_hakmem 20000000 400 1

# Optimized: ctor=1
HAKMEM_PROFILE=MIXED_TINYV3_C7_SAFE \
HAKMEM_ENV_SNAPSHOT=1 \
HAKMEM_ENV_SNAPSHOT_CTOR=1 \
./bench_random_mixed_hakmem 20000000 400 1

判定（10-run mean）:

• GO: +1.0% 以上
• ±1%: NEUTRAL（research box 維持）
• -1% 以下: NO-GO（freeze）

注意:

• “constructor の pre-main init” を効かせたい場合は、起動前に ENV を設定する（bench_profile putenv だけでは遅い）。

---

Step 3: perf で “消えたか” を確認（E3-4=1）

HAKMEM_PROFILE=MIXED_TINYV3_C7_SAFE \
HAKMEM_ENV_SNAPSHOT=1 \
HAKMEM_ENV_SNAPSHOT_CTOR=1 \
perf record -F 99 -- ./bench_random_mixed_hakmem 20000000 400 1

perf report --stdio --no-children

確認ポイント:

• hakmem_env_snapshot_enabled の self% が有意に下がる／Top から落ちる
• 代わりに “snapshot 参照” が 1 箇所に集約されている

---

Step 4: 昇格（GO の場合のみ）

Option A（推奨・安全）: E1 だけプリセット昇格、E3-4 は opt-in 維持

• core/bench_profile.h（MIXED_TINYV3_C7_SAFE）:
  • bench_setenv_default("HAKMEM_ENV_SNAPSHOT","1");
  • HAKMEM_ENV_SNAPSHOT_CTOR は入れない（研究箱のまま）
• docs/analysis/ENV_PROFILE_PRESETS.md に E1/E3-4 の推奨セットを追記
• CURRENT_TASK.md を更新

Option B（攻める）: E1+E3-4 をプリセット昇格

• 20-run validation（mean/median 両方）を通してから
• 注意: HAKMEM_ENV_SNAPSHOT_CTOR=1 をプリセット default にする場合、分岐 hint/期待値も合わせて見直す（baseline を汚さない）

---

Step 5: Rollback（いつでも戻せる）

HAKMEM_ENV_SNAPSHOT=0
HAKMEM_ENV_SNAPSHOT_CTOR=0

---

Next（Phase 4 Close）

• E1/E3-4 の “どこまで本線に入れるか” を決めたら、Phase 4 は CLOSE（勝ち箱はプリセットへ、研究箱は freeze）にする。