# Phase 54: Memory-Lean Mode（RSS <10MB を狙う opt-in）

背景（Phase 53）:
- hakmem FAST の peak RSS ≈ **33MB** は主に **SuperSlab backend の常駐**（speed-first 設計）由来
- drift は 0% で安定（リークではない）
- syscall budget は優秀（Phase 48: 9e-8/op）

目的:
- “速度優先 (FAST)” を崩さずに、**別プロファイル**として Memory-Lean を追加する（opt-in）
- 目標: Mixed/WS=400 で **peak RSS <10MB**
- 許容: throughput **-5〜-10%**、syscalls は増えて良い（ただし暴れない）

Box Theory 方針:
- 新モードは **ENV gate** で戻せる（A/B 可能）
- 変換点は 1 箇所（Superslab OS Box / release policy に集約）
- 可視化は最小（SS_OS_STATS と RSS/soak で十分）
- Fail-fast（DSO/madvise guard のルールは維持）

---

## 設計の芯（どこを変えるか）

“RSS 33MB” の主体は **常駐 superslab** なので、ここを減らす必要がある。

やること（最小）:
1. **prewarm / persistent keep を弱める**（必要になるまで割り当てない）
2. **idle superslab の decommit**（MADV_FREE/MADV_DONTNEED、環境依存で切替）
3. **budget**（各 class の resident 上限）を設ける（上限超過は decommit/retire）

---

## API / Box（提案）

L0: `ss_mem_lean_env_box.h/c`
- `HAKMEM_SS_MEM_LEAN=0/1`（default 0）
- `HAKMEM_SS_MEM_LEAN_TARGET_MB=10`（目標RSS）
- `HAKMEM_SS_MEM_LEAN_DECOMMIT=FREE|DONTNEED|OFF`（OS依存の挙動切替）

L1: `ss_release_policy_box.h/c`
- `ss_should_keep_superslab(class_idx) -> bool`
- `ss_maybe_decommit_superslab(ss)`（DSO guard / madvise guard を通す）

境界:
- Superslab OS Box（既存の `ss_os_madvise_guarded()`）に decommit を集約

---

## 実装手順（小パッチ）

### Patch 1: ENV gate + stats
- `ss_mem_lean_env_box.*` 追加（default OFF）
- `ss_os_stats` に “lean_decommit / lean_retire” のカウンタ追加（ワンショット可）

### Patch 2: prewarm 抑制（lean のときだけ）
- 既存の prewarm/persistent ルートを **lean時にスキップ**
- まずは “C0–C7 の初期 superslab 予約” を弱める

### Patch 3: retire/decommit（安全に）
- “完全に空になった superslab” のみ対象
- DSO guard / fail-fast ルールは維持（DSO 触ったら即 disable）

### Patch 4: A/B（性能と RSS）
- **FAST**: `HAKMEM_SS_MEM_LEAN=0`（baseline）
- **LEAN**: `HAKMEM_SS_MEM_LEAN=1`（treatment）

測定:
- Phase 51 single-process soak（5分→30分）で RSS/ops/s drift を確認
- Phase 48 rebase の ops/s も確認（速度劣化が許容範囲か）
- `HAKMEM_SS_OS_STATS=1` で syscall budget が暴れていないか確認

判定:
- GO: peak RSS <10MB かつ drift=0%、throughput -10% 以内
- NO-GO: RSS が下がらない / syscalls が暴れる / クラッシュ
- NEUTRAL: RSS は下がるが throughput 劣化が大きい → 研究箱として保持

---

## 注意（落とし穴）

- “削除して速い” は禁止（link-out/物理削除は layout tax 事故）
- decommit は kernel/CPU 依存で variance を増やしやすい → soak で CV を必ず見る
- まずは **opt-in**（標準プロファイルを汚さない）