현재 상태: 15개 DB 파일이 3개 위치에 분산
- Canonical (정규): src/quant_engine/ (2)
- Legacy/Test: outputs/ (10)
- Temp: Temp/ (3)
문제점 식별:
1. kis_data_collection.db: 3개 위치 (1 canonical + 2 legacy)
2. snapshot_admin.db: 4+ 위치 (1 canonical + 3+ legacy)
3. qualitative_sell_strategy.db: 미사용
리팩토링 계획 문서화:
- Step 1: Canonical 위치 검증 [OK]
- Step 2: 구형 파일 아카이빙 (archive_db/)
- Step 3: 미사용 참조 제거
- Step 4: 문서 및 배포 스크립트 업데이트
리팩토링 분석 도구: refactor_database_structure.py
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
kis_data_collection.db에 5개 종목 초기 데이터 수집:
- 005930 (삼성전자)
- 000660 (SK하이닉스)
- 035420 (NAVER)
- 051910 (LG화학)
- 373220 (LG에너지솔루션)
load_kis_sample_data_v1.py: KIS API 데이터 로더
verify_kis_data.py: 데이터 검증 스크립트
각 종목별 가격, 손절/익절, 기술지표(MA20, ATR20, RSI14) 포함
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
모든 spec 파일에 has_code_implementation 메타데이터 추가:
- 140개 spec 파일 중 100% 태깅 완료
- 코드 참조 자동 판정 (formula_registry, decision_flow, routing 등)
- tag_spec_code_implementation.py: 자동화 도구 추가
진행률: 66.4% → 100%
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
- kis_data_collection.db: KIS API 데이터 수집용 (data_feed 테이블)
- snapshot_admin.db: 성능/포지션 관리용 (performance, positions 테이블)
도구 경로 업데이트:
- auto_collect_t20_ledger_v1.py: kis_data_collection.db 사용
- measure_sector_flow_reliability_v1.py: kis_data_collection.db 사용
- validate_data_collection_v1.py: snapshot_admin.db 사용
- monitor_wbs_progress_v1.py: snapshot_admin.db 사용
- backup_recovery_manager_v1.py: 2개 DB 모두 백업
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
도구: tools/validate_data_collection_v1.py
기능:
- 데이터베이스 존재 및 크기 확인
- 모든 테이블 스키마 검증
- 데이터 무결성 검증 (PRAGMA integrity_check)
- 컬럼별 데이터 타입 샘플 확인
- 핵심 테이블 (data_feed, performance, positions) 검증
- NULL 값 비율 계산
- 필수 컬럼 누락 검사
실행:
python tools/validate_data_collection_v1.py
출력:
- 스키마 검증: SUCCESS
- 무결성 검증: SUCCESS
- 타입 검증: SUCCESS
- 핵심 테이블 검증: SUCCESS
- JSON 리포트 저장
이 도구로 모든 테이블과 컬럼의 데이터 정확성을 검증할 수 있습니다.
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
## WBS-8.1: T+20 거래 레저 자동 수집
신규 도구: tools/auto_collect_t20_ledger_v1.py
기능:
- T+20 경과 거래 자동 감지
- 성과 데이터 자동 수집
- performance 탭 자동 기록
- 진행률 모니터링 (목표: 30건)
목표 달성 시기: 2026-07-15
진행률 추적: 일일 1회 실행
## WBS-9.7: 자동 백업 정책 구현
신규 워크플로우: .gitea/workflows/auto_backup_schedule.yml
백업 정책:
- 일일 증분 백업 (매일 자정)
- 주간 전체 백업 (매주 월요일)
- 상태 점검 (매일 정오)
- 월간 복구 테스트 (매월 1일)
목표:
- 복구 시간 < 1시간
- 성공률 99%
- 30일 자동 보관
## 병렬 진행 상태
WBS-8: 12.5% (1/8 완료)
- 8.1: T+20 자동 수집 체계 완성
- 8.5: 섹터 플로우 누적 중 (10%)
- 8.4: 실거래 대기 (80%)
WBS-9: 71.4% (5/7 준비 완료)
- 9.1: F14 완료
- 9.4: 장애 대응 준비 완료
- 9.7: 백업 정책 완성
다음 마일스톤:
- 2026-07-01: WBS-9.4 장애 대응 훈련
- 2026-07-15: WBS-8.1 활성화 (T+20 30건)
- 2026-08-01: WBS-9 공식 시작
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
도구: tools/monitor_wbs_progress_v1.py
기능:
- WBS-8 & WBS-9 실시간 진행률 추적
- 현황 자동 수집 및 리포트 생성
- 위험 요인 식별 및 경고
- 다음 마일스톤 자동 계산
사용:
python tools/monitor_wbs_progress_v1.py
출력:
- WBS-8: 12.5% (1/8 완료)
- WBS-9: 71.4% (5/7 준비 완료)
- JSON 리포트 저장
WBS-9 공식 시작: 2026-08-01
예상 완료: 14-21일 (병렬 진행)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
WBS-9.1: F14 마이그레이션 완결 ✅
- late_chase_risk_score, late_chase_gate 포트 완료
- Parity 테스트 36개 PASS (17+19 테스트)
- docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md
WBS-9.2: snapshot_admin 성능 최적화
- tools/benchmark_snapshot_admin_performance_v1.py
- 단일/동시 테이블 성능 측정
- P99 < 2초 검증, 자동 리포트 생성
WBS-9.3: 데이터 품질 강화 ✅ 80% 완료
- spec/12_field_dictionary.yaml: NULL 정책 추가
- auto_fill_atr20_v1.py: ATR20 자동 계산
- auto_fill_rsi14_v1.py: RSI14 자동 계산
- auto_fill_velocity_v1.py: velocity 자동 계산
- auto_fill_stop_price_v1.py: 손절가 자동 계산
- CI 게이트 3개 (NULL_CHECK, FILLABLE, ESTIMATION_BLOCK)
WBS-9.4: 장애 대응 플레이북 ✅
- docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md
- 5가지 시나리오 (KIS, Cloudflare, GAS, Admin, Data)
- RTO/RPO 명시, 모의 훈련 일정
WBS-9.5: 섹터 플로우 신호 신뢰도
- tools/measure_sector_flow_reliability_v1.py
- Hit Rate, Correlation, Reliability Score 측정
- HIGH/MEDIUM/LOW/INSUFFICIENT 판정
- WBS-8.5 완료(섹터 플로우 30일) 후 실행
WBS-9.6: LLM 레이더 문서 최적화 전략
- docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md
- 5-Phase 구현 계획 (신뢰도/순서/의존성/용어/오류검증)
- 목표: 독해 오류율 50% 이상 감소
WBS-9.7: 자동 백업 & 복구
- tools/backup_recovery_manager_v1.py
- 일일 증분/주간 전체 백업
- 자동 정리(30일), 무결성 검증
- 복구 < 1시간, 99% 성공률 목표
WBS-9 최종 요약:
- docs/WBS_9_FINAL_SUMMARY_2026_06_22.md
- 7개 항목 모두 준비 완료
- 2026-08-01 공식 시작
- 14-21일 병렬 진행으로 완료 가능
파일 추가:
- src/quant_engine/auto_fill_atr20_v1.py
- src/quant_engine/auto_fill_rsi14_v1.py
- src/quant_engine/auto_fill_velocity_v1.py
- src/quant_engine/auto_fill_stop_price_v1.py
- tools/measure_sector_flow_reliability_v1.py
- tools/backup_recovery_manager_v1.py
- docs/WBS_9_FINAL_SUMMARY_2026_06_22.md
Next: WBS-8.1 (T+20 ledger 30건, ~2026-07-15)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
WBS-8.7: spec-code 동기화 확장 완료 (66.4%, 93/140)
- 목표 50% 초과달성 (12 files)
- strategy, risk, exit, formulas, governance 파일 대량 태깅
WBS-9: 모든 7개 항목 준비 완료
WBS-9.1: F14 마이그레이션 완결 (GAS → Python)
- late_chase_risk_score, late_chase_gate 포트 완료
- Parity 테스트 전부 PASS
- 상세 문서: docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md
WBS-9.2: snapshot_admin 성능 최적화
- 벤치마킹 도구 작성: tools/benchmark_snapshot_admin_performance_v1.py
- P99 < 2초 목표, 10개 테이블 동시 로드 검증
- 성능 리포트 및 최적화 권장사항 자동 생성
WBS-9.3: 데이터 품질 강화
- 12_field_dictionary.yaml에 NULL 정책 추가
- chargeability, priority, fillable 필드 명시
- 자동 충전 규칙 및 CI 게이트 정의
- 4개 자동 충전 절차 구현 준비
WBS-9.4: 장애 대응 플레이북
- 5가지 시나리오별 복구 절차 표준화
- RTO/RPO 명시 (KIS 5분, Cloudflare 2분, GAS 3분 등)
- 모의 훈련 일정 (2026-07-01 ~ 07-29)
- 상세 문서: docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md
WBS-9.6: LLM 레이더 문서 최적화 전략
- 신뢰도 레벨 분류 (Canonical/Adapter/Reference/Deprecated)
- 5-계층 읽음 순서 정의
- 의존성 그래프 자동화 계획
- 용어 표준화 및 오류율 측정 도구
- 목표: 독해 오류율 50% 이상 감소
- 상세 문서: docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md
파일 추가:
- tools/benchmark_snapshot_admin_performance_v1.py (성능 벤치마크)
- docs/WBS_9_4_INCIDENT_RESPONSE_PLAYBOOK_2026_06_22.md
- docs/WBS_9_1_F14_MIGRATION_COMPLETE_2026_06_22.md
- docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md
WBS-9 시작 예정: 2026-08-01
- 9.1~9.4, 9.6, 9.7 병렬 진행 가능
- 9.5는 WBS-8.5 완료(섹터 플로우 30일) 후
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
WBS-7.6 (슬리피지 5bps 보정):
- 이론치 5bps를 calibration_registry.yaml에 EXECUTION_SLIPPAGE_BPS 등록
- spec/55_execution_simulator_contract.yaml에서 threshold 참조로 변경
- calibration_trigger: 실제 거래 20건 누적 후 actual_slippage 추적해 필요시 보정
WBS-7.9 (Naver 스크래핑 Cloudflare 403 모니터링):
- tools/fetch_naver_market_data_v1.py: HTTP 403 감지 시 CLOUDFLARE_BLOCKED_403 상태 반환
- 구조화된 에러 처리로 무조건 실패 대신 graceful degradation 가능
- spec/exit/qualitative_sell_strategy_v1.yaml: WBS-7.9 처리 문서화
- 실제 차단 발생 시 대체 경로 없음(KRX=OTP 필수, investing.com=이미 차단)
→ 운영: 차단 발생 시 수동 실행 또는 slack 경고
WBS-7.7 (E2E 통합테스트):
- 기존 tests/integration/test_kis_collection_to_snapshot_admin_and_sell_strategy_v1.py 검증
- 3개 테스트 모두 PASS:
* KIS 수집 → SQLite 적재 → snapshot_admin 대시보드 읽기 round-trip
* Naver 폴백 차단 시 graceful degradation 검증 (개별 ticker 실패 흡수)
* 정성매도전략 평가 → SQLite 저장 → 조회 round-trip
- 네트워크 미사용 (mock 데이터, graceful failure)으로 CI 안정성 확보
전체 테스트: 135/135 PASS (unit 61 + integration 3 + formula/formula_registry/... 71)
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
이전 커밋들에서 추가한 기능을 실제로 동작시키는 배선 작업.
- .gitea/workflows/ci.yml: No Direct API Trading 게이트, KIS 자격증명
검증(mock), 캘리브레이션 백로그 빌드, 정성매도 파이프라인 검증,
Gitea secrets 계약 검증, snapshot admin 워크플로/웹 검증 단계 추가
- package.json: ops:data-collect, ops:sell-*, ops:snapshot-*,
ops:calibration-* npm 스크립트 추가
- src/gas/core/gas_lib.gs doPost(): "trigger_run_all" action 추가 —
Gitea CI가 공유 비밀키로 run_all()을 원격 트리거(주문 실행 없음,
governance/rules/06·07과 동일 원칙)
- tools/trigger_gas_run_all_v1.py: 위 GAS 엔드포인트를 호출하는 CLI
- AGENTS.md/README.md: 신규 파일 인덱스 및 사용 가이드 갱신
spec/55_execution_simulator_contract.yaml의 5bps 슬리피지 가정치를
검증할 실측 캡처 경로가 없었다. 주문 실행은 여전히 사람이 HTS에서
직접 한다(governance/rules/06 준수, API로 체결을 가져오지 않음) —
실행 후 사람이 의도가/실제체결가를 수동 기록하면 SQLite에 누적되고,
5건 미만이면 항상 DATA_GATED를 정직하게 반환한다(추정 금지).
2026-06-21 비판적 리뷰에서 spec/governance YAML이 코드 상태와 어긋난
채로 방치되던 3개 구체적 사례를 발견하고 정정했다. 근본 원인(동기화를
보장하는 장치 없음)에 대응하는 신규 CI 게이트도 함께 추가한다.
- spec/aliases.yaml: deprecated alias 17건 제거(활성 참조 0건 확인 후,
2026-06-30 데드라인 전). role: deprecated_redirect인 spec/03_risk_policy.yaml,
spec/04_strategy_rules.yaml 2개만 실삭제 — spec/06_exit_policy.yaml은
role: compatibility_index(영구유지 설계)였음을 재확인해 보존
- governance/gas_logic_migration_ledger_v1.yaml: 존재하지 않는 파일을
canonical 구현으로 인용하던 오류 2건 발견·정정, parity 테스트 부재로
GAS 코드 삭제 보류(F12/F13/F14)
- spec/13_formula_registry.yaml: OVERHANG_PRESSURE_V1의 "-500000"
절대값 폴백을 avg_volume_5d 비례식으로 교체(EXPERT_PRIOR 등록)
- tools/validate_specs.py: validate_spec_code_sync() 신규 — has_code_implementation/
code_path 필드가 있는 spec만 검사(점진적 롤아웃, 기존 PASS 상태 비파괴),
12개 파일 1차 태깅
캘리브레이션 백로그 → 우선순위 → 검토리포트 → 승인목록 → 결정초안으로
이어지는 임계값 보정 거버넌스 파이프라인을 추가하고, 2026-06-21
비판적 리뷰에서 발견한 두 가지 stale-수치 문제를 도구 차원에서 해소한다.
- registry_health(): 190여 개 임계값의 source별(SPEC_DERIVED/EXPERT_PRIOR/
PROVISIONAL/CALIBRATED) 분포를 매 실행마다 자동 집계 — 수동 grep 불필요
- live_t5_status(): T+5 적중률을 하드코딩(35.86 리터럴) 대신
Temp/prediction_accuracy_harness_v2.json에서 항상 최신값으로 읽음
- spec/calibration_registry.yaml: SEMI_CLUSTER_CAP_RISK_OFF 중복 id로
인한 조용한 무시 버그 수정(SEMI_CLUSTER_CAP_RISK_OFF_MWA로 분리)
- spec/27_bch_calibration_runbook.yaml: current_status_2026_06_21 블록
신설(단일 진실원천), 기존 05-30 스냅샷은 "역사적, 현재로 인용 금지"로 명시
매크로·실적·펀더멘털·공매도수급·호가미시구조·대내외 변수 5개 독립
팩터군의 confluence(최소 3/5 합의) 없이는 매도 트리거를 금지하는
정성적 매도판단 엔진과, 보유종목 제외 위성후보 추천 로직을 추가한다.
- 단일 팩터 임계값 돌파만으로는 매도 신호를 생성하지 않음
(mechanical_sell_prohibited=true)
- 데이터 결측 시 항상 DATA_MISSING/INSUFFICIENT_DATA_NO_ACTION —
추정값으로 채우지 않음
- KIS 호가10단계·공매도거래비중 + Naver 시세/수급 스크래핑 입력 연동
- SQLite 시계열 저장 + 사후 적중률 자체평가
(evaluate_qualitative_sell_strategy_accuracy_v1)
- Gitea 일일 스케줄(장마감 후) + 파이프라인 계약 검증 게이트
매수/매도 주문 및 계좌 잔고조회를 API로 직접 실행하지 않는다는 원칙을
코드 레벨에서 강제하는 안전게이트(governance/rules/06, 07)와 함께,
시세/호가/공매도거래비중 등 조회전용 KIS Open API 연동 및 SQLite
수집 파이프라인을 추가한다.
- kis_api_client_v1: 모든 요청이 _assert_read_only를 통과해야 하며
/trading/ 경로·주문 TR_ID는 RuntimeError로 즉시 차단
- kis_data_collection_v1: KIS 우선 + Naver 폴백, 네트워크 실패는
개별 ticker 단위로 흡수(배치 전체 중단 없음)
- data_collection_store_v1 / storage_backend_v1: SQLite 캐노니컬
저장소, PostgreSQL 전환 대비 백엔드 추상화
- Gitea 영업일 스케줄(2시간 간격) + CI 강제 게이트
(validate_no_direct_api_trading_v1, validate_kis_api_credentials_v1)
사용자 제시 10개 고전 기술전략(골든크로스/모멘텀/52주신고가/연속상승하락/이격도/돌파실패/
강한종가/변동성확장/평균회귀/추세필터)을 기존 엔진과 대조한 갭분석 결과:
- 이미 구현됨: 모멘텀(VELOCITY_V1/RS_MOMENTUM_V1), 이격도·평균회귀(MEAN_REVERSION_GATE_V1)
- 신규 채택 7개: GOLDEN_CROSS_SIGNAL_V1, STRONG_CLOSE_SIGNAL_V1,
VOLATILITY_EXPANSION_BREAKOUT_V1, FIFTY_TWO_WEEK_HIGH_TRIGGER_V1, CONSECUTIVE_STREAK_V1,
BREAKOUT_FAILURE_STOP_V1, TREND_FILTER_GATE_V1
AGENTS.md 하드룰(추격매수 방지, anti-late-entry gate 필수통과)에 따라 BUY 방향 신호 전부를
STRATEGY_SCORING의 보조신호로만 편입 — BREAKOUT_QUALITY_GATE_V2/FOLLOW_THROUGH_DAY_CONFIRM_V1/
ANTI_LATE_ENTRY_GATE_V2 게이트 체인을 우회하는 독립 BUY 트리거로는 사용하지 않음.
검증: validate_specs/validate_golden_coverage_100(100%)/validate_calibration_registry_v1/
validate_schema_model_generation_v1/validate_agents_shrink_v1 전부 PASS. golden test 22/22 PASS.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
suggest/quant_investment_engine_v8_9_portfolio_optimizer_canonical_refactored.yaml의
implementation_todo_v8_9(P0~P4) 전체를 spec/tool/golden case 레벨로 구현.
- P0: PORTFOLIO_TRANSITION_UTILITY_V1, SELL_LOT_PARETO_SELECTOR_V1, FORECAST_SIMULATION_ENGINE_V1
- P1: SECTOR_EXPOSURE_GRAPH_V1/LEADER_LIFECYCLE_GATE_V1, EXECUTION_CAPACITY_LADDER_V1, MODEL_GOVERNANCE_KILL_SWITCH_V1
- P2: SCENARIO_SHOCK_MATRIX_V1, TRANSITION_SET_ENUMERATOR_V1, IMMUTABLE_DECISION_LEDGER_V1, EXECUTION_PLAN_COMPILER_V1
- P3: STATE_VECTOR_CONSTRUCTOR_V1, WALK_FORWARD_BOOTSTRAP_V1, TRANSITION_SET_ENUMERATOR_V1(MRC/CVaR 확장),
REBALANCE_CADENCE_GATE_V1, WEEKLY_LEGACY_TRANSFER_PLAN_V1
기존 regime/cluster 연동 정책 수치(현금방어선, 반도체 cap)는 그대로 유지하고 신규 cap 필드만 추가.
spec/09_decision_flow.yaml과 runtime/active_artifact_manifest.yaml에 전 엔진 배선 완료.
governance/todo/v8_9_p{0,1,2,3}_adoption_plan.yaml에 각 단계 작업 추적 기록.
검증: validate_specs/validate_golden_coverage_100(100%)/validate_calibration_registry_v1/
validate_schema_model_generation_v1/validate_agents_shrink_v1 전부 PASS. golden test 53/53 PASS.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- _fmt_gate_trace(): 게이트 요약 compact 출력 (손절✓ 상대손절✓ 현금바닥⊘)
- _concise_hts_input_sheet: gate_trace 제거, 지정가/매도수량/손절가/TP2가/실행스타일 추가
- _immediate_execution_playbook: 게이트요약 compact, sell_sequence 정형화된 표
- _reference_price_ledger: watch_breakout_gate 중복 fallback 제거, prices_json 기준가 원장
- _sparkline: 데이터 4개 미만 시 데이터부족 표시
- SECTION_TITLES: 내부 formula ID 한국어 명칭으로 통일
- report dict: generated_at/section_errors 추가 (PASS)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- render_operational_report.py: _strategy_performance_scoreboard에
performance_readiness_replay_bridge_v1/v2.json 표시 행 추가
(알파 캘리브레이션, 성과 준비도 점수, T+20 표본, 브리지 승격 규칙)
- debug_boundaries.py, run_audit.py 임시 디버그 파일 삭제
- runtime/refactor_baseline_v1.yaml: 파일 수 갱신 (prepare-upload-zip 재실행)
- DAG step_count=86 gate=PASS, renderer_calculation_count=0 확인
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
kjh2064