Task Item Index
아이템 이름으로 빠르게 찾는 레퍼런스. 상세 내용은 각 출처 파일에서 확인.
유지보수 룰:
private/안에 새 작업 문서를 만들거나 기존 task의 상태/근거가 바뀔 때마다 이 인덱스를 같이 갱신한다. 자세한 절차는../CLAUDE.md참고.
현행 아이템 (v3 — 독립 단위 PR)
출처: tasks/v3_standalone_items.md
| ID | 한 줄 설명 | 상태 | 비고 | 관련 문서 |
|---|---|---|---|---|
| H1 | _free_slots 멤버십 체크 O(n) → O(1) (set 병렬 추가) | 착수 가능 | 다른 PR과 충돌 없음 | • v3 §H1 |
| H2 | _free_slots LIFO → FIFO (wear leveling, FDP 전 선행) | 착수 가능 | H1과 독립 | • v3 §H2 |
| M1 | non-MP write/read 경로에 io_uring 실제 적용 | 대기 | #3274 머지 임박 (6/1 APPROVED, 6/3 doc 코멘트만) — 곧 착수 가능 | • v3 §M1 |
| M2 | io_uring setup flag 튜닝 (SINGLE_ISSUER 등) | 대기 | #3274 머지 임박, #3271 병행 확인 | • v3 §M2 |
| non-MP 자체 eviction 복구 | 🚫 착수 금지 | daegyu94 #3394 진행 중 | • v3 §S1 | |
| S2 | checkpoint overflow 수정 — HC SSD(15/30TB) 영역 (단계 2a: 512MB→2GB) | 대기 | Daejun #3449 답변 후 — Std SSD는 #3449 zlib으로 해소(2026-06-04 재평가) | • v3 §S2 • s2_todo.md • verification §10 • one-pager • Daejun 질문 초안 |
v3 외 raw_block 후보 (v3 등록 전 분석 단계)
| 후보 | 한 줄 설명 | 상태 | 관련 문서 |
|---|---|---|---|
| A1 / L3 | batched_remove 락 N→1 (raw_block / local_cpu, DAX 패턴 따라가기) | PR 리뷰 중 (#3494) | • candidate_a1 • L3 변경 노트 • cr-2a031316 리뷰 |
| L1 | put_many 락 4N→2N 축소 (allocate-lock·commit-lock에 inflight 카운터 흡수) | implemented (PR 대기) | • L1 변경 노트 • cr-5a27732f 리뷰 • cr-c7a90bfa 후속 재검토 |
| L2 | legacy batched_submit_put_task 1-key 분해 → 진짜 배치 (dedup → 단일 put_many) | implemented (PR 대기) | • L2 변경 노트 • cr-93403c0f 리뷰 |
| Cleanup | RawBlockCore 중복/도달 불가 조건 정리 (워밍업 PR) | ✅ 머지 완료 | • pending cleanup |
| V1 | _validate_loaded_entries io_uring batched_read로 header N개 병렬 읽기 | 대기 | • perf-findings §2-6 |
| V2 | _validate_loaded_entries foreground/background 검증 분리 | 🚫 착수 금지 | — |
v2 아이템 (측정·분석·연결)
출처: tasks/v2_benchmark_tracing.md
| ID | 한 줄 설명 | 상태 | 비고 | 관련 문서 |
|---|---|---|---|---|
| A | end-to-end 백엔드 비교 벤치마크 (#3183) | 보류 | 실 HW 필요. 방법론은 HW 없이 가능 | • v2 §A |
| B1 | MP 런타임 라이브 L2 레이턴시 텔레메트리 (EventBus → OTel) | 보류 | #3272(오프라인 프로파일링)와 구분되어 생존 | • v2 §B1 • task1_impl_plan.md (구현 스케치) |
| 커널 down-to-NVMe 스택 추적 | 🚫 폐기 | zhengfeihe #3272가 흡수 | • v2 §B2 | |
| C | #3262 공유 NVMe L2 백엔드 연결 (raw_block over NVMe-oF) | 보류 | A · B 데이터 후 진입. 실 HW 의존 | • v2 §C • tracking 2026-05-22 |
v1 아이템 (원래 5-task 로드맵)
출처: tasks/v1_original_roadmap.md, tasks/task1_impl_plan.md
| ID | 한 줄 설명 | 상태 | 비고 | 관련 문서 |
|---|---|---|---|---|
| Task 1 | L2 단계별 레이턴시 히스토그램 subscriber | 보류 | = v2 B1과 동일 내용으로 흡수 | • v1 §Task1 • impl plan |
| Task 2 | lmcache storage describe CLI | 보류 | #3102 · #3320 보완 관계 | • v1 §Task2 |
| Task 3 | fs_connector O_DIRECT 메타데이터 경로 | 보류 | Samsung SSD 성능 검증 직결 | • v1 §Task3 |
| Task 4 | L2 어댑터 레이턴시/용량 health check | 보류 | Task 1 완료 후 착수 가능 | • v1 §Task4 |
| Task 5 | device-aware prefetch/store policy | 보류 | Task 1 완료 후 착수 가능 | • v1 §Task5 |
분석 백그라운드
직접 task는 아니지만 위 항목들의 근거가 되는 분석 노트.
| 주제 | 설명 | 위치 |
|---|---|---|
| 코드베이스 지도 | LMCache 4-tier · storage_backend/ · distributed/l2_adapters/ 관계 | docs/lmcache_overview.md |
| L1~L4 분석 노트 | l2_adapters / plugin_pipeline / raw_block_line / mp_vs_non_mp | docs/notes/ |
| 분석 TODO | 모듈별 분석 순서 (TODO 1~4 완료, 4.5 진행) | docs/TODO.md |
| SSD I/O 분석 계획 | 분석 렌즈 정의 (L1~L4) | tasks/todo_ssd_io_analysis.md |
| 아키텍처 리뷰 | FDP / HC-SSD / io_uring 관점 핵심 인사이트 | architecture-review.md |
| 추적 문서 | 외부 PR / 멀티디바이스 / staleness 추적 | tracking/INDEX.md |
| CI 커버리지 & 실장 테스트 가이드 | PR CI 사각지대 정리 + raw_block 미커버 경로 + PR별 실장 테스트 필요 조건 | docs/notes/ci_test_coverage.md |
| raw_block PR landscape | 2026-06-05 기준 열린 PR 12개 ↔ 우선순위 항목 매핑, #3274 커버 범위, 미착수 Gap(G1~G4) | docs/notes/raw_block_pr_landscape.md |
상태 기호
| 기호 | 의미 |
|---|---|
| 착수 가능 | 선행 조건 없음, 지금 바로 시작 가능 |
| 대기 | 선행 PR 머지 또는 협의 결과 대기 |
| 보류 | HW 확보 · 설계 합의 · 선행 아이템 완료 후 재검토 |
| 🚫 착수 금지 | 타인이 동일 영역 진행 중 — 중복 금지 |
| 🚫 폐기 | 타 PR이 흡수하여 별도 작업 불필요 |
마지막 갱신: 2026-06-05