PR #3226 — raw_block incremental base+delta checkpoint

[!tldr] 업무 관점 takeaway Daejun이 checkpoint 전체 직렬화(O(N) write)를 base+delta 구조로 개선. APPROVED (DongDongJu, 2026-05-26). 단, base overflow(S2)는 이 PR과 직교 — _write_full_base의 payload cap은 그대로. #3226 머지 후 S2 fix(단계 1)를 위에 얹는 계획.

---

기본 정보

항목	내용
PR 번호	#3226
작성자	Daejun (박대준)
상태	APPROVED (DongDongJu, 2026-05-26), 머지 대기

---

무엇을 바꾸나

기존: checkpoint마다 _index 전체를 JSON 직렬화 → O(N) write
변경: [header][payload aligned][delta tail] 구조

• base: 첫 커밋 + compaction 시점에만 전체 직렬화
• delta: 이후 checkpoint는 변경된 key만 delta record로 append
• compaction 트리거: delta 수, region watermark, 시간, oversize record, first-write

mirror layout:
  [ header (32B) ][ base payload (aligned) ][ delta tail → ]

기존 디바이스 호환: delta tail에 LMCD magic 없으면 replay 중단 → old disk는 base만 읽음.

---

S2(checkpoint overflow)와의 관계

항목	Before	After #3226
base 직렬화	JSON 전체	(동일)
overflow 체크	if len(payload) > payload_cap	(동일)
overflow 시	warning + return False	(동일, silent)
base 가용 공간	~64MB	delta tail 공유로 약간 감소

→ S2는 직교. #3226 머지 후에도 동일 경로로 살아있음.
→ S2 단계 1 fix(128MB→512MB)는 #3226 위에 얹을 계획.

---

주요 리뷰 포인트

• DongDongJu (2026-05-08): "v2 base layout 너무 복잡. 기존 layout 위에 delta tail만 붙이자."
• Daejun (2026-05-11): 설계 간소화, force-push. [ header ][ payload ][ delta tail ] 단일 구조.
• 2026-05-26: DongDongJu APPROVED

---

우리 액션

• #3226 머지 확인 후 → S2 단계 1 PR (meta_total_bytes 128MB → 512MB + meta_version bump) 진행
• Daejun에게 S2 base overflow 범위 질문 예정 (raw/daejun_question_draft.md 참고)

---

관련 페이지

• [[S2-checkpoint-overflow]] — S2 상세 분석
• [[Samsung-LMCache-팀]] — Daejun 기여 영역