edf/.agents/references/known-issues.md

Known Issues — 과거 실패 기록

이 파일은 에이전트가 같은 실수를 반복하지 않도록 실패를 기록합니다. 세션 종료 시 자동으로 새 이슈를 추가합니다.

---

2026-03-11 pykrx — get_market_ticker_list 항상 0 반환

• 증상: stock.get_market_ticker_list(date, market="KOSPI")가 모든 날짜에 0 반환
• 원인: pykrx 1.2.4 버전에서 ticker_list API가 정상 동작하지 않음 (2026년 환경)
• 해결: DART corp_codes로 종목 목록 확보 + per-ticker get_market_ohlcv는 정상 동작
• 주의: get_market_ticker_list 의존하지 말 것. DART corp_codes를 종목 마스터로 사용

2026-03-11 pykrx — get_market_cap 단일일자 조회 시 시총=0

• 증상: stock.get_market_cap(date, date, ticker) 호출 시 시가총액이 0 반환
• 원인: 단일일자 조회 문법 이슈 (pykrx 내부 처리 문제)
• 해결: stock.get_market_cap_by_date(start, end, ticker)로 15일 범위 조회 후 마지막 값 사용
• 주의: 단일일자 get_market_cap 사용 금지. 반드시 date range + _by_date 변형 사용

2026-03-11 DART — corp_codes 순서에 소형/비활성 종목 우선

• 증상: DART corp_codes 순서대로 수집 시 처음 10~20개가 전부 에러 (비활성/상폐 종목)
• 원인: corp_codes 정렬이 코드 순이라 소형/비활성사가 앞에 위치
• 해결: KRX에서 주가 확인된 종목(volatility 테이블)만 DART 수집 대상으로 필터링
• 주의: DART 수집 시 반드시 KRX 활성 필터 적용. finstate(stock_code, year) 형태로 직접 조회 가능

2026-03-11 PowerShell — 인라인 Python f-string 이스케이핑 불가

• 증상: python -c "...f'{var}'..." 형태 인라인 코드가 PowerShell에서 파싱 오류
• 원인: 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% 미만으로 낮추면 역전 재발