kjh2064 aedabdd37b feat(quant-engine): v8.9 제안서 P0-P3 로드맵 채택 — 15개 의사결정 엔진 신규 구현
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>
2026-06-18 00:06:52 +09:00

Core/Satellite Collector v4

은퇴자산용 코어/위성 후보 데이터 수집기입니다.

v4 기본 정책

  • 파라미터 없이 실행
  • 1차 유니버스: KOSPI 160개 + KOSDAQ 40개
  • 최종 후보: 100개
  • 최종 후보 내 KOSDAQ: 최대 20개
  • 1차 탐색 총량은 v3와 동일한 200개로 유지하여 호출 수 증가를 막습니다.

설치

npm install
node core_satellite_collector.js

OpenDART 공시까지 확인하려면:

$env:DART_API_KEY="발급받은키"
node core_satellite_collector.js

운영 표준

하네스/보고서/동기화까지 포함한 최종 게이트는 아래 순서를 사용합니다.

npm run full-gate

이 스크립트는 아래를 직렬로 수행합니다.

  • convert-data-json
  • validate-gas-call-arity
  • validate-proposal-reference
  • validate-harness-context
  • validate-operational-report-contract
  • audit-coverage
  • validate-harness-coverage-auditor
  • validate-strategy-tests-contract
  • validate-breakout-gate
  • validate-anti-whipsaw
  • validate-cash-raise-route
  • validate-brt-harness
  • validate-determinism
  • validate-alpha-execution-harness:strict
  • render-report-json
  • validate-report-json
  • validate-report-quality
  • validate-report-sync

spec와 데이터 샘플 검증까지 포함한 전체 엄격 검증은 아래를 사용합니다.

npm run validate-engine-strict

proposal 평가 이력까지 갱신하는 일일 실행은 아래를 사용합니다.

npm run daily-feedback-report

백필 누적 원장(backdata_feature_bank) 상태를 즉시 검증하려면 아래를 사용합니다.

npm run validate-backdata-migration-state

Outcome/Evaluation 복구 파이프라인(YOLO)을 한 번에 실행하려면 아래를 사용합니다.

npm run yolo-outcome-recovery

GAS 함수 정의/호출 인자 수 불일치만 단독 점검하려면 아래를 사용합니다.

npm run validate-gas-call-arity

사용자 판단용 제안표 하네스 출력이 실제로 존재하는지 점검하려면 아래를 사용합니다.

npm run validate-proposal-reference

GAS runHarnessRefresh_() 반영 후에는 아래 강제 검증으로 올릴 수 있습니다.

npm run validate-proposal-reference:strict

GAS 반영 후 proposal_reference_json까지 포함한 최종 엄격 게이트는 아래를 사용합니다.

npm run full-gate:proposal-strict

spec/데이터 샘플까지 포함한 전체 엄격 검증은 아래를 사용합니다.

npm run validate-engine-proposal-strict

GAS 반영 체크리스트

proposal_reference_json을 실제 하네스 출력으로 승격하려면 아래 순서를 따릅니다.

  1. Apps Script에 최신 gas_harness_rows.gs 반영
  2. Apps Script에서 runHarnessRefresh_() 실행
  3. Google Sheets harness_context 시트에 아래 키 생성 확인
    • proposal_reference_json
    • proposal_reference_lock
  4. 로컬에서 npm run convert-data-json 실행
  5. npm run validate-proposal-reference:strict 실행
  6. npm run full-gate:proposal-strict 실행
  7. 최종 운영 전환 시 npm run validate-engine-proposal-strict 기준으로 사용

운영 리포트 계약

운영 리포트는 사람이 읽는 Temp/operational_report.md와 기계 검증용 Temp/operational_report.json을 함께 생성합니다.

  • operational_report.json이 canonical 계약입니다.
  • operational_report.md는 표시용 렌더입니다.
  • JSON 스키마는 schemas/operational_report.schema.json을 사용합니다.
  • 계약 드리프트 검사는 npm run validate-operational-report-contract로 수행합니다.
  • 전체 게이트에는 render-report-json -> validate-report-json -> validate-report-quality -> validate-report-sync 순서가 포함됩니다.

전환 기준:

  • validate-proposal-referenceSKIP이면 아직 GAS 산출물 미반영 상태
  • validate-proposal-reference:strictPASS여야 proposal 하네스 strict 전환 완료
S
Description
퀀트 투자 엔진
Readme 28 MiB
Languages
Python 63.5%
JavaScript 31.8%
C# 3.7%
HTML 0.4%
PowerShell 0.2%
Other 0.4%