schema_version: factor_conflict_matrix.v1
contract_id: H002_FACTOR_CONFLICT_MATRIX
harness_file: tools/validate_factor_conflict_matrix_v1.py
authority: spec/53_factor_conflict_matrix.yaml
created_at: '2026-06-10T23:29:00+09:00'
purpose: >
  스마트머니/펀더멘털/모멘텀/리스크 팩터 충돌 시 우선순위를 자동으로 판정한다.
  미해결 충돌이 있으면 릴리즈를 차단한다.

conflict_precedence_rules:
  - rank: 1
    family: portfolio_risk_budget
    rationale: 현금방어선·MDD 상한은 어떤 alpha 신호보다 우선한다
  - rank: 2
    family: execution_quality
    rationale: 주문 불가 상태(틱 오류·현금 부족)는 매수/매도 모두 차단한다
  - rank: 3
    family: entry_timing
    rationale: 추격매수 방지 gate는 smart money 신호보다 우선한다
  - rank: 4
    family: smart_money_liquidity
    rationale: 외국인/기관 신호가 fundamental 신호보다 선행성이 높다
  - rank: 5
    family: fundamental_quality
    rationale: 장기 생존력 신호
  - rank: 6
    family: market_regime
    rationale: 거시 위험 판단으로 포지션 스케일 조정
  - rank: 7
    family: exit_value_preservation
    rationale: 수익금 보전 신호

inputs:
  - field: factor_lifecycle_registry.yaml
    source: spec/factor_lifecycle_registry.yaml
    required: true
  - field: final_decision_packet_active.json
    source: Temp/final_decision_packet_active.json
    required: true

output_fields:
  - name: conflict_matrix
    type: list[dict]
    description: 충돌 팩터 쌍과 우선순위 결과
  - name: unresolved_conflict_count
    type: int
    description: 우선순위 미정의 충돌 수
  - name: gate
    type: str
    enum: [PASS, FAIL]

acceptance_criteria:
  - conflict_precedence_defined_for_every_active_factor: true
  - unresolved_conflict_count: 0

hard_gates:
  - gate_id: CONFLICT_RESOLVED
    condition: unresolved_conflict_count == 0
    on_fail: BLOCK_RELEASE
  - gate_id: PRECEDENCE_COMPLETE
    condition: every active factor has conflict_precedence rank
    on_fail: BLOCK_RELEASE

owner: quant_architect
lifecycle_state: active
retirement_condition: >
  팩터 충돌 해소 체계를 전면 재설계하는 계약이 등장할 때까지 유효하다.