ods-specification/examples/complete_decision.json at main · ODS-Foundation/ods-specification · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
{
  "_schema_version": "1.1.0",
  "record_type": "DECISION",
  "record_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp_utc": "2026-04-28T14:23:45.123456+00:00",
  "identity": {
    "model_version": "v2.1.0",
    "policy_hash": "6b329a98be88b1f2e645de6c1de55f4911cd6925438195284df217a0770d8c5a"
  },
  "context": {
    "regime_state": "TRANSITION",
    "regime_confidence": 0.72,
    "volatility_state": "ELEVATED",
    "macro_state_vector": [0.12, -0.23, 0.45]
  },
  "action": {
    "action_type": "REDUCE",
    "action_size": 0.30,
    "risk_posture": 0.45,
    "expected_value": 0.08
  },
  "cognition": {
    "confidence": 0.72,
    "uncertainty_score": 0.28,
    "decision_latency_ms": 847,
    "rationale": "Regime transition detected with 72% confidence. Volatility elevated above historical norms. Reducing exposure by 30% to preserve capital during uncertainty period. Risk-adjusted expected value remains positive."
  },
  "counterfactuals": [
    {
      "alternative_action": "HOLD",
      "expected_outcome": 0.05,
      "regret": -0.06
    },
    {
      "alternative_action": "SELL_FULL",
      "expected_outcome": 0.02,
      "regret": -0.09
    },
    {
      "alternative_action": "INCREASE_25",
      "expected_outcome": 0.14,
      "regret": 0.03
    }
  ],
  "governance": {
    "audit_trail": [
      {
        "timestamp_utc": "2026-04-28T14:23:45.123456+00:00",
        "event": "DECISION_CREATED",
        "actor": "DECISION_SYSTEM_v2.1",
        "metadata": {
          "trigger": "scheduled_review",
          "input_signals": ["regime_change", "volatility_spike"]
        }
      }
    ],
    "explainability": {
      "feature_importance": {
        "volatility": 0.45,
        "regime_confidence": 0.30,
        "momentum": 0.15,
        "sentiment": 0.10
      },
      "decision_factors": [
        "Volatility above 95th percentile",
        "Regime transition confirmed by 3 indicators",
        "Risk capacity at 60% threshold"
      ]
    },
    "compliance": {
      "risk_limit_checks": ["MAX_DRAWDOWN_PASSED", "EXPOSURE_LIMIT_PASSED"],
      "policy_violations": [],
      "approvals": ["RISK_COMMITTEE_AUTO_APPROVED"]
    }
  }
}