feat: 집계 배치율 감시 — 설계 대비 미달을 헬스로 표면화

[easygap]

무엇

한 달 운영 리뷰(docs/PAPER_MONTH1_REVIEW_AND_PLAN.md P1-5)의 집계 배치율 감시를 구현합니다.

왜

종목별 드리프트 트리거(8%p)는 집계 배치율 이탈을 영영 못 봅니다. 이번 달 하이닉스 슬롯 공백 + 정수 절사로 실효 주식비중이 설계 80% 대신 59%로 굳었는데, 어떤 알림도 없었습니다. 이 이탈을 운영자 헬스로 표면화합니다.

무엇을 했나

• core/operator_health.py
  • 순수 함수 summarize_deployment(deployment_ratio, design_fraction, tolerance=0.05) — 실제가 설계보다 5%p 초과로 낮으면 ATTENTION(초과 배치는 리밸런서가 자연 교정하므로 미달만 감시).
  • summarize_basket_operation이 배치율 미달 시 verdict를 ATTENTION으로 승격 + 노트 추가(스냅샷 staleness 판정과 공존).
• main.py run_health_check
  • 최신 PortfolioSnapshot(total_value, cash)으로 배치율 계산 → 네트워크 불필요.
  • 설계 비중은 BasketRebalancer._stock_fraction과 동일 규칙으로 계산(min_cash_ratio / target_stock_weight).
  • 복수 바스켓이면 가장 크게 미달인 바스켓을 대표로 보고.

실CLI 스모크 + 적대적 리뷰

• 실데이터 --mode health: 주식 배치율 59% < 설계 80% (-21.1%p) ATTENTION 정상 출력.
• 스모크가 회귀 적발: 제가 넣은 config 미정의(NameError)가 바스켓 헬스 섹션을 통째로 조용히 죽이던 것을 실행으로 잡아 수정(모의 테스트로는 안 잡혔을 이슈).
• 다중 에이전트 적대적 리뷰(6건 제기 → 3건 확정) 반영:
  • [medium] 배치율 계산이 결측/staleness 감지와 같은 broad try를 공유 → baskets.yaml에 float 불가한 target_stock_weight 오타 하나로 핵심 결측 신호까지 삼켜지던 문제 → 배치율 계산을 자체 try로 격리(실패해도 결측/staleness 감지는 생존).
  • [low] 경계(shortfall==tolerance) 무테스트 → 엄격 > 고정 테스트 추가.

테스트

• tests/test_operator_health.py에 summarize_deployment 분기 + summarize_basket_operation 배치율 승격 + 경계 테스트.
• 전체 스위트 통과.