Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.1.0] - 2026-08-16

변동성 타게팅 (backtest/timing.py) — 실현변동성에 반비례하는 연속 익스포저 (Moreira & Muir 2017). 기존 오버레이는 켜짐/꺼짐 이진이라 서서히 오르는 변동성에 점진적으로 대응하지 못했다.
파라미터 앙상블 (--ensemble k) — 폴드마다 최적값 하나에 검증 구간 전체를 걸던 것을, 상위 k개 파라미터의 검증 수익률 평균으로 바꾼다. n_stocks 가 폴드에 따라 15↔47 로 널뛴 것이 동기다.
섹터 비중 상한 (max_sector_weight) — 팩터는 섹터 중립화하는데 최종 포트폴리오의 섹터 비중은 아무도 보지 않았다. 실제 보유 19종목 중 6종목이 Technology 였다 — 팩터 베팅이 아니라 의도하지 않은 매크로 베팅이다.
scripts/update_readme_performance.py — README 성과 표·그래프를 저장된 OOS 수익률에서 생성한다. 종목명은 쓰지 않는다.
scripts/run_backtests.sh — 풀 히스토리 walk-forward 순차 실행

분기→일별 승격 캐시에 크기 제한이 없었다. 승격 프레임 하나가 362MB (9,000 거래일 × 6,895종목)라 팩터를 늘릴수록 선형으로 쌓였다. 팩터 20개짜리 조합 탐색이 OOM 으로 두 번 죽은 원인이며, 팩터 수가 곧 메모리 한계였다. LRU 4개로 제한 — 폴드 1 기준 RSS 10.4GB → 5.29GB, 이후 폴드에서 증가 없음.
close.pct_change() 를 평가 호출마다(폴드 19 × 시도 3) 다시 만들던 것을 evaluator 에서 한 번만 계산 — 파라미터와 무관한 500MB 프레임이었다.
walk-forward 폴드 로그에 RSS 를 남긴다. 진행률만 있어서 메모리가 자라는 것인지 원래 높은 것인지 사후에 구분할 수 없었다.

미국 주식 팩터 엔진 추가. 기존 VAA 시스템과 완전히 격리된 서브시스템이며, 공유하는 것은 config.RISK_FREE_RATE 하나뿐이다.

DSR 단위 오류 — 연율화 Sharpe 분산을 기간 단위 자리에 넘겨 DSR 이 성과와 무관하게 0 에 붙었다. 같은 수익률에서 0.000 vs 0.910.
메모리 — 팩터 패널을 일별로 캐시하던 것을 신호일 그리드로 (21배 절감), 일별 필드를 SQL 단계에서 선택 (OOM 3회의 원인)
벤더 함정 — 요청당 티커 30개 상한, DAILY 백만 달러 단위, TICKERS 10,000행 절단, isdelisted 미정규화, PIT 위반 행, ticker 결측 행
벤치마크(SPY)가 유니버스 필터에 잘려 마켓타이밍이 죽던 문제

data_cache.py (루트) — core/cache.py 와 중복이며 참조되지 않았다
requirements.txt — CI·Makefile 어디서도 쓰이지 않으면서 dependabot 만 물고 있었다 (제거한 streamlit 의 버전 상향 PR 이 계속 올라온 원인). 의존성 원천은 pyproject.toml + uv.lock 하나다.

Full modularization into core/, strategies/, analysis/, ui/, utils/
UI translated to Korean
CORE_WEIGHT replaced with individual asset weights (SPY_WEIGHT, TLT_WEIGHT, GLD_WEIGHT, BIL_WEIGHT)