From 2439d5e24d8f41811a233c0d7b12b9cf16942c78 Mon Sep 17 00:00:00 2001 From: kjh2064 Date: Thu, 30 Jul 2026 14:12:42 +0900 Subject: [PATCH] docs: record the Temp/ evidence-cache incident in the handoff notes Entropy cleanup earlier today deleted all of Temp/, which turned out to include WBS verification evidence (Temp/evidence/*/verdict.json), not just build cache. Documents what broke, what got recovered, and what remains genuinely blocked on missing trading data - so this doesn't get rediscovered from scratch next time. Co-Authored-By: Claude Sonnet 5 --- docs/SESSION_HANDOFF_2026-07-30.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/SESSION_HANDOFF_2026-07-30.md b/docs/SESSION_HANDOFF_2026-07-30.md index 936c588b..f5b6ee6e 100644 --- a/docs/SESSION_HANDOFF_2026-07-30.md +++ b/docs/SESSION_HANDOFF_2026-07-30.md @@ -26,6 +26,26 @@ Gitea Secrets 이름과 일치)만 예약해뒀다. 호출 한도 등은 사용자가 알려주지 않아 기록하지 않았다 — 추측해서 채우지 말 것. +## 추가 발견 (같은 날, entropy 정리 이후) + +- **`Temp/*` 전체 삭제가 WBS 검증 캐시를 깼다.** `tools/verify_wbs_task_v1.py`가 만드는 + `Temp/evidence//verdict.json`과 각종 `Temp/*.json`(golden_coverage_100, + market_time_series_schema 등)은 git에 추적되지 않지만 "완료된 검증의 증적"이라 순수 + 빌드 캐시가 아니었다. `spec/60_quant_engine_wbs.yaml`의 13개 태스크가 FAIL로 나타났었음. + - 3개(QE-M0-06, QE-M2-06, QE-M2-01)는 해당 generator 재실행 + DB 재접속으로 복구 완료. + - QE-M3-03은 무관 — `engine_history.factor_output_history`에 최근 24시간 내 데이터가 + 있어야 하는 라이브 신선도 게이트. 오늘 세션과 상관없이 운영 파이프라인이 최근 안 + 돌았으면 원래도 FAIL이다. + - 나머지 7개(QE-M4-01~04, QE-M5-01~03)는 `Temp/prediction_accuracy_harness_v2.json` + 등 실거래 데이터 파생 체인이 필요 — 이 저장소 스냅샷엔 `GatherTradingData.xlsx`가 + 없어서(이미 위에서 언급한 그 문제) 복구 불가. 실거래 데이터가 있는 환경에서 전체 + 파이프라인을 한 번 돌리면 자동 복구된다. + - QE-M4-05/QE-M5-04(Playwright evidence)도 같은 체인에 의존해 사실상 같이 막혀있음. + - **교훈**: `Temp/`가 git 미추적이라고 전부 "순수 빌드 산출물"은 아니다 — `Temp/evidence/`처럼 + "재실행하면 되지만 재실행에 실제 데이터/DB가 필요한 캐시"가 섞여 있다. 다음에 비슷한 + 정리를 할 때는 삭제 전에 `rg -l "Temp/" spec/ tools/` 정도로 어떤 하위 경로가 검증 + 체인에 물려있는지 먼저 확인할 것. + ## 이번 세션에서 걸린 함정 — 재발 방지 - **문서를 "오래됐다"고 archive하기 전에 `tools/*.py`, `spec/*.yaml`, `tests/*.py`,