Files
QuantEngineByItz/spec/58_llm_determinism_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

81 lines
3.0 KiB
YAML

schema_version: llm_determinism_contract.v1
contract_id: H008_LLM_DETERMINISM_AUDIT
harness_file: tools/validate_llm_determinism_pack_v1.py
authority: spec/58_llm_determinism_contract.yaml
created_at: '2026-06-10T23:29:00+09:00'
purpose: >
저성능 LLM도 packet copy-only로 같은 결과를 렌더링할 만큼
final_context_for_llm이 충분히 사전 계산되어 있는지 검증한다.
LLM에게 산술 연산을 요구하는 항목이 있으면 릴리즈를 차단한다.
required_precomputed_sections:
- section: 01_metadata_and_manifest_alias
must_contain: [document_id, generated_at_kst, active_artifact_alias]
- section: 02_portfolio_health
must_contain: [total_asset_krw, cash_ratio_pct, goal_achievement_pct]
- section: 03_hard_blockers
must_contain: [blocked_tickers, blocker_reasons]
- section: 04_sell_priority_table
must_contain: [rank, ticker, sell_action, sell_reason_code]
note: 이미 정렬된 순서로 제공. LLM은 재정렬하지 않는다.
- section: 05_buy_hold_sell_action_table
must_contain: [ticker, final_action, entry_price, stop_price, quantity]
- section: 06_cash_and_risk_budget
must_contain: [available_cash_krw, d2_cash_krw, max_allowed_mdd_pct]
- section: 07_shadow_ledger_visible_items
must_contain: [formula_id, lifecycle_state, sample_n, promotion_allowed]
- section: 08_data_missing_items
must_contain: [missing_field, reason]
- section: 09_market_regime_summary_precomputed
must_contain: [regime_label, regime_score, position_scale_factor]
- section: 10_education_notes_preapproved
note: 사전 승인된 교육 노트만 포함. LLM이 신규 작성 금지.
- section: 11_forbidden_phrases_and_no_math_rules
must_contain: [forbidden_phrases, no_math_rule]
validation_rules:
- all_numeric_fields_precomputed: true
- all_tables_pre_sorted: true
- no_arithmetic_instruction_in_prompt: true
- llm_numeric_generation_count: 0
inputs:
- field: final_context_for_llm_v5.yaml
source: Temp/final_context_for_llm_v5.yaml
required: true
output_fields:
- name: missing_sections
type: list[str]
description: 누락된 required section 목록
- name: arithmetic_instruction_count
type: int
description: LLM에게 계산을 요구하는 지시 건수
- name: precomputed_field_coverage_pct
type: float
description: 사전 계산된 필드 비율
- name: gate
type: str
enum: [PASS, FAIL]
acceptance_criteria:
- all_decision_fields_precomputed: true
- all_tables_sorted_in_packet: true
- no_instruction_requires_arithmetic: true
hard_gates:
- gate_id: NO_ARITHMETIC_INSTRUCTION
condition: arithmetic_instruction_count == 0
on_fail: BLOCK_RELEASE
- gate_id: ALL_SECTIONS_PRESENT
condition: missing_sections == []
on_fail: BLOCK_RELEASE
- gate_id: PRECOMPUTED_COVERAGE
condition: precomputed_field_coverage_pct == 100.0
on_fail: BLOCK_RELEASE
owner: pm
lifecycle_state: active
retirement_condition: >
LLM 파이프라인이 완전 결정론적 서버 사이드 렌더링으로 교체될 때까지 유효하다.