Files
QuantEngineByItz/spec/52_decision_trace_replay_contract.yaml
T
kjh2064 ee3e799de1 feat: 리밸런싱 엔진 V1 + GAS 버그 수정 (2026-06-13)
주요 변경:
- tools/build_rebalance_engine_v1.py: REBALANCE_ENGINE_V1 신규
  * account_snapshot 직접 합산(_build_snap_position_map) → 소수주 분리 행 병합
  * 레짐 소스 macro.REGIME_PRELIM 최우선 (GAS 와 동일)
- src/gas_adapter_parts/gdf_06_rebalance.gs: runRebalanceSheet_() 신규
  * Logger.log / getSpreadsheet_() 로 run_all 연동 수정
- src/gas_adapter_parts/gdc_01_fetch_fundamentals.gs
  * _mergePositionRecord_(): 소수주 중복 행 합산 신규
  * parseInt → parseFloat (qty, availQty)
- src/gas_adapter_parts/gdf_01_price_metrics.gs
  * 미보유 종목 SELL_READY → WATCH_EXIT_SIGNAL
- spec/41_release_dag.yaml: build_rebalance_sheet 노드 추가 (step_count 63)
- spec/51_formula_lifecycle_registry.yaml: REBALANCE_ENGINE_V1 등록

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 13:20:14 +09:00

51 lines
1.8 KiB
YAML

schema_version: decision_trace_replay_contract.v1
contract_id: H001_DECISION_TRACE_REPLAY
harness_file: tools/validate_decision_trace_replay_v1.py
authority: spec/52_decision_trace_replay_contract.yaml
created_at: '2026-06-10T23:29:00+09:00'
purpose: >
최종 매수/보유/매도 결론까지 사용된 모든 gate와 feature를 trace로 복원하여,
결정의 재현성을 보장한다. 결론이 달라지는 trace 불일치는 릴리즈를 차단한다.
inputs:
- field: final_decision_packet_active.json
source: Temp/final_decision_packet_active.json
required: true
- field: computed_harness_v1.json
source: Temp/computed_harness_v1.json
required: true
output_fields:
- name: gate_trace
type: list[str]
description: 결론까지 순서대로 통과한 gate ID 목록
- name: feature_trace
type: dict
description: 결론에 사용된 feature key → value 맵
- name: verdict_replay_match
type: bool
description: 재실행 시 최종 verdict가 동일한지 여부
acceptance_criteria:
- every_final_verdict_has_ordered_gate_trace: true
- missing_gate_trace_blocks_release: true
- verdict_replay_match_pct: 100.0
hard_gates:
- gate_id: TRACE_COMPLETE
condition: all decisions have gate_trace length >= 1
on_fail: BLOCK_RELEASE
- gate_id: VERDICT_REPLAY_MATCH
condition: verdict_replay_match_pct == 100.0
on_fail: BLOCK_RELEASE
non_negotiable:
- LLM은 gate_trace를 번복하거나 재해석하지 않는다
- replay 시 동일 packet 입력이면 동일 결론을 내야 한다
- trace가 없는 결론은 DATA_MISSING으로 표기하고 릴리즈를 차단한다
owner: quant_architect
lifecycle_state: active
retirement_condition: >
대체 결정 추적 계약이 이 계약을 명시적으로 교체 선언할 때까지 유효하다.