docs: known-issues 3건 추가 + devlog 2026-03-12 세션 기록

.agents/references/known-issues.md

@@ -28,3 +28,21 @@
 - **원인**: PowerShell의 `'`, `"`, `{}` 이스케이핑이 Python f-string과 충돌
 - **해결**: 항상 별도 `.py` 파일로 작성하여 실행
 - **주의**: PowerShell에서 복잡한 Python 코드를 `-c` 옵션으로 실행하지 말 것
+
+### 2026-03-12 pykrx — get_market_cap 전 함수군 완전 불가
+- **증상**: `get_market_cap`, `get_market_cap_by_date`, `get_market_cap_by_ticker` 모두 0 반환 또는 columns 오류
+- **원인**: pykrx 1.2.4에서 시가총액/상장주식수 관련 API 전면 고장
+- **해결**: DART `total_equity`(자본총계)를 E(자기자본)로 대체 사용
+- **주의**: 시가총액 필요 시 유료 DB(FnGuide 등) 또는 DART 발행주식수 × 종가로 별도 산출 필요
+
+### 2026-03-12 Merton — SPAC/스팩 종목 DD 비정상 (50~124)
+- **증상**: DD가 50~124로 비정상적으로 높아 AAA 등급 오염
+- **원인**: SPAC은 자산=현금, 부채=극소 → Merton 모형에서 부도확률이 0에 수렴
+- **해결**: 종목명에 "스팩", "SPAC", "N호" 패턴 포함 시 제외 (62개)
+- **주의**: 리츠(26개)도 동일 문제. 비정상 종목 필터 항상 적용
+
+### 2026-03-12 Shadow Rating — EDF 등급역전 (composite score 기반)
+- **증상**: AA-의 EDF가 A+보다 높은 역전 현상
+- **원인**: composite score에서 DD 외 재무비율(레버리지/ROA)이 등급을 왜곡
+- **해결**: DD 가중치를 50% → 70%로 상향, isotonic 단조보정 적용
+- **주의**: composite score 산출 시 DD 가중치를 70% 미만으로 낮추면 역전 재발