82 lines
2.8 KiB
Markdown
82 lines
2.8 KiB
Markdown
|
# Phase 4: Alloc Gate Specialization（D3 実装指示書）
|
|||
|
|
|
|||
|
|
Phase 3 は **D1 昇格 / D2 凍結**で完全閉鎖。次の “芯” は alloc 側の gate を削る D3。
|
|||
|
|
|
|||
|
|
## 現在地（SSOT）
|
|||
|
|
|
|||
|
|
- Active defaults（Mixed）:
|
|||
|
|
- `HAKMEM_TINY_ALLOC_ROUTE_SHAPE=1`（B3）
|
|||
|
|
- `HAKMEM_WRAP_SHAPE=1`（B4）
|
|||
|
|
- `HAKMEM_TINY_STATIC_ROUTE=1`（C3）
|
|||
|
|
- `HAKMEM_FREE_STATIC_ROUTE=1`（D1, promoted）
|
|||
|
|
- `HAKMEM_MID_V3_ENABLED=0`（Mixed 本線 SSOT）
|
|||
|
|
- Frozen / ignore:
|
|||
|
|
- `HAKMEM_WRAP_ENV_CACHE=1`（D2, NO-GO）
|
|||
|
|
|
|||
|
|
## Step 0: perf で “GO 条件” を満たしているか確認
|
|||
|
|
|
|||
|
|
判定基準: `tiny_alloc_gate_fast` が **self% ≥ 5%**。
|
|||
|
|
|
|||
|
|
推奨（Mixed, iter=20M, ws=400, 1T）:
|
|||
|
|
```bash
|
|||
|
|
HAKMEM_PROFILE=MIXED_TINYV3_C7_SAFE perf record -F 99 -- \
|
|||
|
|
./bench_random_mixed_hakmem 20000000 400 1
|
|||
|
|
perf report --stdio --no-children
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
メモ（直近の 1-run perf）:
|
|||
|
|
- `tiny_alloc_gate_fast` self% ≈ **18.8%** → **D3 GO 条件は満たす**
|
|||
|
|
|
|||
|
|
## Step 1: D3 実装（Box Theory）
|
|||
|
|
|
|||
|
|
設計メモ（SSOT）: `docs/analysis/PHASE3_D3_ALLOC_GATE_SPECIALIZATION_1_DESIGN.md`
|
|||
|
|
|
|||
|
|
### 箱割り（必須）
|
|||
|
|
|
|||
|
|
- L0: ENV（戻せる）
|
|||
|
|
- `HAKMEM_ALLOC_GATE_LEGACY_ONLY=0/1`（default 0）
|
|||
|
|
- L1: Safe-Enable 判定（境界 1 箇所）
|
|||
|
|
- Mixed 本線が “LEGACY-only” であることを 1 回だけ確認し、成立した場合のみ fast 経路へ
|
|||
|
|
- Learner ON の場合は必ず disable（route が動的更新されるため）
|
|||
|
|
- L2: Integration（境界 1 箇所）
|
|||
|
|
- `tiny_alloc_gate_fast()` の入口でのみ差し替え（既存の意味は変えない）
|
|||
|
|
|
|||
|
|
### Safe-Enable 条件（Fail-Fast ではなく “自動 disable”）
|
|||
|
|
|
|||
|
|
以下のどれかに該当したら D3 は **即 disable** して既存経路へフォールバック:
|
|||
|
|
- learner が有効（例: `HAKMEM_SMALL_LEARNER_V7_ENABLED=1`）
|
|||
|
|
- route_kind に LEGACY 以外が混入（V7/MID/ULTRA/TINY_FIRST 等）
|
|||
|
|
- そのほか Mixed 本線の固定前提が崩れている
|
|||
|
|
|
|||
|
|
## Step 2: A/B（GO/NO-GO）
|
|||
|
|
|
|||
|
|
Mixed 10-run（推奨: iter=20M, ws=400, 1T）:
|
|||
|
|
|
|||
|
|
- Baseline:
|
|||
|
|
```bash
|
|||
|
|
HAKMEM_PROFILE=MIXED_TINYV3_C7_SAFE HAKMEM_ALLOC_GATE_LEGACY_ONLY=0 \
|
|||
|
|
./bench_random_mixed_hakmem 20000000 400 1
|
|||
|
|
```
|
|||
|
|
- Optimized:
|
|||
|
|
```bash
|
|||
|
|
HAKMEM_PROFILE=MIXED_TINYV3_C7_SAFE HAKMEM_ALLOC_GATE_LEGACY_ONLY=1 \
|
|||
|
|
./bench_random_mixed_hakmem 20000000 400 1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
判定（10-run mean）:
|
|||
|
|
- GO: **+1.0% 以上**
|
|||
|
|
- NO-GO: **-1.0% 以下**
|
|||
|
|
- ±1.0%: NEUTRAL（研究箱維持、default OFF）
|
|||
|
|
|
|||
|
|
## Step 3: 昇格（GO の場合のみ）
|
|||
|
|
|
|||
|
|
- `MIXED_TINYV3_C7_SAFE` プリセットへ default 注入（`core/bench_profile.h`）
|
|||
|
|
- `docs/analysis/ENV_PROFILE_PRESETS.md` に結果・rollback 手順を追記
|
|||
|
|
- `CURRENT_TASK.md` を “Phase 4 完了” に更新
|
|||
|
|
|
|||
|
|
## Step 4: 失敗時の扱い（箱理論）
|
|||
|
|
|
|||
|
|
- NO-GO/NEUTRAL の場合:
|
|||
|
|
- D3 は research box として freeze（default OFF）
|
|||
|
|
- 本線は汚さない（プリセット昇格はしない）
|