from __future__ import annotations

REPORT_SCHEMA_VERSION = "2026-05-24-operational-report-v1"
REPORT_SOURCE_JSON = "GatherTradingData.json"

REPORT_SECTION_ORDER = [
    # [RSO-V2] Actual rendering order (verified 2026-05-30 against 84-section output)
    # PHASE-0: execution safety + judgment
    "exec_safety_declaration",
    "final_judgment_table",
    "final_execution_decision",
    "concise_hts_input_sheet",
    "watch_breakout_gate",
    "reference_price_ledger",
    # PHASE-1: single conclusion + playbook
    "single_conclusion",
    "immediate_execution_playbook",
    "market_context_learning_note",
    "portfolio_performance_summary",
    "portfolio_sector_exposure_summary",
    "sector_trend_analysis_v1",
    "etf_representative_monitor_v1",
    "performance_readiness_summary",
    "operational_eval_queue_summary",
    # PHASE-2: quality + readiness scores
    "investment_quality_headline",
    "operational_truth_score",
    "execution_readiness_matrix",
    "pass_100_criteria",
    # PHASE-3: decision summary + routing
    "today_decision_summary_card",
    "routing_serving_trace",
    "export_gate_diagnosis",
    "QEH_AUDIT_BLOCK",
    # APPENDIX order anchors
    "backdata_feature_bank_table",
    "alpha_lead_table",
    "anti_distribution_table",
    "profit_preservation_table",
    "smart_cash_raise_table",
    "execution_quality_table",
    "decision_trace_table",
    "anti_whipsaw_reentry_gate",
    "proposal_reference_sheet",
    "satellite_buy_proposal_sheet",
    "core_satellite_timing_gate_table",
    "engine_feedback_loop_report",
    "prediction_evaluation_improvement_report",
    "rule_lifecycle_governance_report",
]