fix: 바스켓 트랙 동결·현금 누수 해소 + 주문 안전장치 강화

[easygap]

배경

6/10에 페이퍼 운영을 시작한 뒤 두 달 넘게 트랙이 설계대로 굴러가지 않았다. 크래시는 한 번도 없었다. 오류 0건, 주문 실패 0건, 스냅샷 정상, 헬스 계속 OK. 그런데 실제로는 이랬다.

• 6/10 ~ 8/07: 58거래일 동안 거래 0건. 1일차 체결 상태 그대로 동결.
• 8/07 ~ 8/26: 배치율 61.0% → 54.9%로 단조 감소. 19거래일 재투자 0건. 그 사이 KOSPI가 +8.17% 반등해서 유휴 현금이 반등분의 45%를 깎아먹었다.

둘 다 감시망에 안 걸렸다. 이 PR은 그 두 결함과 같은 성격의 관측 사각을 정리한다.

1. 자기상관 자기거부로 인한 영구 동결 (1f0e6ea)

check_correlation_risk가 대상 종목을 자기 자신과 비교했다. corr(x, x) = 1.0이니 항상 임계값을 넘고, 고정수량 어댑터는 scale < 1.0이면 주문을 하드 거부한다. 바스켓이 만드는 주문은 대부분 보유분 추가매수라, 1일차 체결 이후 모든 매수가 영구 거부됐다.

• 상관 비교에서 자기 자신 제외. 동일 종목 추가 노출은 max_position_ratio 관할이다.
• 사전 승인된 목표 비중표로 집행하는 주문(weight_policy_managed)은 쌍별 상관 거부권을 적용하지 않는다. 비중표가 곧 분산 정책이라 이중 계산이고, 하락장에서 대형주 상관이 일제히 1에 수렴하면 설계대로 채우는 주문이 전부 막힌다. 집중도는 비중·업종·노출 상한이 그대로 강제한다.

같이 정리한 것:

• 주식 노출을 target_stock_weight: 0.60으로 명시. 종전엔 설계가 80%인데 실효 59%였다.
• 000660 제외. 1주 148만원이 주식 슬리브의 26%라 단일 종목 상한 20%를 넘는다. 현재 자본에서 편입 자체가 불가능한 슬롯이 2개월간 목표표에 상주해 있었다.
• 트랙별 리스크 정책(core/basket_risk.py). 전역 단타 기준(-3% 손절, +8% 익절)이 buy&hold 포지션에 기록만 되고 일일 사이클은 평가하지 않아, 손절선을 뚫은 포지션 6개가 방치돼 있었다.
• 손절 종목 재진입 차단. 없으면 비워진 슬롯을 같은 사이클의 비중 교정이 곧바로 되사서 손실만 확정하는 왕복매매가 된다. 8/07에 실제로 발생했다.
• daily_return이 스냅샷 61행 전부 0.0이었다. save_daily_snapshot이 값을 아예 안 넘겼다. 변동성·샤프·일일 손실 한도가 전부 조용히 죽어 있었다.

2. 현금 래칫 (841f1e2)

리밸런싱이 한쪽 방향으로만 돌았다. 비중 초과 매도는 min_trade를 넘겨 집행되는데, 그 현금을 되돌리는 매수는 9종목에 얇게 퍼져 개별로는 전부 미달이라 집행되지 않는다. 종목별 드리프트 트리거는 이 상태를 구조적으로 볼 수 없다. 어느 종목도 임계값을 안 넘으니까.

• 집계 배치율을 리밸런싱 트리거로 승격(deployment_band, 기본 3%p).
• 얇게 퍼진 미달분을 min_trade 단위로 모아 보충 매수한다. 집행 규칙은 하나다. 그 매수가 집계 격차를 실제로 줄일 때만 산다. 1주 절사 때문에 딱 맞게 살 수 없으니 상한을 따로 두는 대신 매수 후 잔여 격차로 판정한다.
• 집계를 맞추자고 구성이 무너지지 않게, 매수 후 종목 비중이 목표 + 드리프트 임계값을 넘으면 보류한다. 어느 종목도 통과 못 하면 주문 없이 두고 미달을 경보로 남긴다. 자본이 부족하다는 신호다.
• deployment_tolerance 1.0 → 0.05. 1.0은 사실상 감시 해제였고, 그래서 위 누수를 헬스가 3주간 한 번도 못 봤다.
• 8/18 결측 하나가 3주간 warning 16건을 만들었다. 결측일 기준 1회만 알린다.
• 적립 이행 점검 추가. kr_pocket 입금이 47일간 0건인데 헬스는 계속 OK였다.

3. 국면 분해와 리스크 지표 (5a6b3f4)

수익률을 한 숫자로 보고하는 동안 방어의 대가가 통째로 숨어 있었다.

구간	KOSPI	NAV	격차
6/10 ~ 8/26	-12.43%	-4.61%	+7.81%p
8/07 ~ 8/26	+8.17%	-0.80%	-8.97%p

같은 포트폴리오의 같은 3개월이다. 방어적 포지션은 하락장에서 항상 좋아 보이니까, 전체 구간 숫자 하나만 보면 상승장 미스를 영영 못 본다.

core/performance_lens.py를 추가하고 주간 리포트에 두 줄을 붙였다.

상승 31일 포착 4% (지수 +149.4% 중 +6.0%만 따라감)
하락 20일 포착 15% (지수 -64.9% 중 -10.0%만 맞음)
연변동성 26.3% · 샤프 -0.76 · 하락일 51% · 최악일 -3.02% (표본 51일)

산식에서 걸러낸 것:

• 일간 수익률을 단순 합산하면 안 된다. 변동성 큰 구간에서 31일을 더하면 +149% 같은 숫자가 나오고 전체와 아귀가 안 맞는다. 복리로 집계하니 상승 × 하락이 전체와 정확히 일치한다.
• 스냅샷이 빠진 날이 있으면 NAV 수익률은 여러 날 구간이 된다. 벤치마크를 하루치로 짝지으면 기간이 어긋나므로, 일간 수익률이 아니라 종가 레벨을 받아 같은 구간으로 다시 계산한다.
• 수익률은 스냅샷의 daily_return 열이 아니라 NAV 시계열에서 뽑는다. 그 열은 8/10 이전이 전부 0.0이라 그대로 쓰면 변동성이 0으로 깔린다.

docs/OPERATING_PRINCIPLES.md도 같이 넣었다. 이 저장소에서 터진 중대 결함은 한 번도 크래시가 아니었다. 전부 "오류 0건, 헬스 OK인데 설계대로 안 굴러감"이라는 같은 서명이다. 그 패턴에서 뽑은 원칙 10개와 각각을 만든 실제 사고를 붙여 뒀다.

4. 실전 주문 안전장치 (fe17d61, 9be12d1)

• 실전 주문과 검증 경계를 fail-closed로 강화
• 긴급 매도 전 미체결 매수 주문 취소 검증

5. 대시보드와 문서 (c163f4f, d853290)

• 장기 투자 중심 대시보드와 눈금 BI 개편
• 주요 화면 중심으로 사용 안내 정리

검증

• 전체 스위트 1946개 통과
• 운영 DB 사본(QUANT_DB_PATH)에 실제 실행 경로를 태워 확인
  • 보유 종목 추가매수: 거부 → 성공
  • 배치율 54.9% → 60.0%, 현금 4,280,927 → 3,798,355
  • kr_pocket은 주문 0건. 1주 단가가 총자산 대비 커서 어떤 매수도 종목 상한을 못 지킨다. 자본이 더 필요하다는 정직한 신호다.
• --mode health, --mode weekly_report 실제 실행 확인

남은 것

• kr_pocket 첫 적립 입금 미실행(47일). 이게 없으면 배치율이 수렴하지 않는다.
• 1회 손실 예산이 아직 전역 -3% 손절로 계산된다. 트랙 정책(-25%)을 넣으면 10% 슬롯이 예산을 초과해 재동결되므로 목표비중 주문에는 별도 기준이 필요하다.
• 리스크 정책 소급 적용 방지(effective_from). 8/07에 -25% 손절을 도입한 사이클이 이미 -34.8%였던 종목을 청산했다. 손절은 앞으로만 구속력이 있어야 한다.