Files
QuantEngineByItz/spec/32_canonical_artifact_resolver.yaml
T
kjh2064 4b1a33ba48 WBS-7.11 2차 확장: spec-코드 동기화 태깅 12→20개 (7.5%→12.5%)
이미 harness_file:/python_tool:/validator: 필드로 1:1 코드 매핑을
스스로 명시하고 있던 H001~H008 결정론적 하네스 계약 7개(spec/52~58)와
spec/32(canonical_artifact_resolver), spec/37(evaluation_dashboard_contract)에
has_code_implementation/code_path를 추가했다. 모든 대상 파일의 code_path
실존을 사전 확인했다.

governance/rules/00~05, spec/40·45·46·gas_adapter_contract 등 다중 구현체에
걸친 계약은 단일 code_path로 환원하면 거짓 1:1 매핑이 되므로 의도적으로
제외했다(WBS-7.11 핵심 원칙 유지).
2026-06-22 01:36:55 +09:00

107 lines
4.0 KiB
YAML

schema_version: 2026-06-03-canonical-artifact-resolver-v2
formula_id: CANONICAL_ARTIFACT_RESOLVER_V2
supersedes: CANONICAL_ARTIFACT_RESOLVER_V1
has_code_implementation: true
code_path:
- "tools/build_canonical_artifact_resolver_v1.py"
- "tools/validate_canonical_artifact_resolver_v1.py"
purpose: >
산출물 단일 진실원장과 stale reference 차단.
RC5 수정: 동일 개념의 다중 버전이 상호충돌·기술부채를 만든다.
버전별 1개 canonical만 게이트 입력으로 허용.
# ── canonical 버전 맵 (개념별 최신·권위 버전 단일 지정) ─────────────────────
canonical_versions:
smart_cash_recovery:
canonical: smart_cash_recovery_v9.json
deprecated:
- smart_cash_recovery_v8.json
- smart_cash_recovery_v7.json
- smart_cash_recovery_v6.json
- smart_cash_recovery_v5.json
- smart_cash_recovery_v4.json
- smart_cash_recovery_v3.json
gate_input_allowed: smart_cash_recovery_v9.json
note: "v9부터 VALUE_PRESERVING_CASH_RAISE_V9 정책 적용 (BREACH_FULL_LIQUIDATION 금지)"
distribution_risk_score:
canonical: distribution_risk_score_v4.json
deprecated:
- distribution_risk_score_v3.json
- distribution_risk_score_v2.json
gate_input_allowed: distribution_risk_score_v4.json
final_execution_decision:
canonical: final_execution_decision_v4.json
deprecated:
- final_execution_decision_v3.json
- final_execution_decision_v2.json
- final_execution_decision_v1.json
gate_input_allowed: final_execution_decision_v4.json
alpha_lead_threshold_optimizer:
canonical: alpha_lead_threshold_optimizer_v3.json
deprecated:
- alpha_lead_threshold_optimizer_v2.json
- alpha_lead_threshold_optimizer_v1.json
gate_input_allowed: alpha_lead_threshold_optimizer_v3.json
pass_100_criteria:
canonical: pass_100_criteria_v3.json
deprecated:
- pass_100_criteria_v2.json
- pass_100_criteria_v1.json
gate_input_allowed: pass_100_criteria_v3.json
note: "v3에 RELEASE_GATE_TRUTH_V1 추가됨 (TASK-001)"
prediction_accuracy_harness:
canonical: prediction_accuracy_harness_v5.json
deprecated:
- prediction_accuracy_harness_v4.json
- prediction_accuracy_harness_v3.json
- prediction_accuracy_harness_v2.json
gate_input_allowed: prediction_accuracy_harness_v5.json
smart_money_liquidity_evidence_gate:
canonical: smart_money_liquidity_evidence_gate_v5.json
deprecated:
- smart_money_liquidity_evidence_gate_v4.json
- smart_money_liquidity_evidence_gate_v3.json
- smart_money_liquidity_evidence_gate_v2.json
gate_input_allowed: smart_money_liquidity_evidence_gate_v5.json
canonical_metrics:
canonical: canonical_metrics_v4.json
deprecated:
- canonical_metrics_v3.json
- canonical_metrics_v2.json
- canonical_metrics_v1.json
gate_input_allowed: canonical_metrics_v4.json
anti_late_entry_pullback_gate:
canonical: anti_late_entry_pullback_gate_v4.json
deprecated:
- anti_late_entry_pullback_gate_v3.json
gate_input_allowed: anti_late_entry_pullback_gate_v4.json
# ── 이전 단일 원천 우선순위 (하위호환 유지) ─────────────────────────────────
canonical_source_precedence:
- final_decision_packet_active
- final_execution_decision_v4
- smart_cash_recovery_v9
- smart_cash_recovery_v8
- engine_audit_v1
- sell_engine_audit_v1
required_outputs:
- canonical_metrics.cash_shortfall_min_krw
- distinct_cash_shortfall_values
- stale_artifact_reference_count
acceptance_criteria:
canonical_per_concept: {op: "==", target: 1, note: "개념별 canonical == 1 (다중 권위본 0건)"}
gate_input_canonical_pct: {op: "==", target: 100, note: "게이트 입력 파일 100%가 canonical map에 존재"}
python_tool: tools/build_canonical_artifact_resolver_v1.py
validator: tools/validate_canonical_artifact_resolver_v1.py