{
  "topic_id": "D04-F01-A05",
  "base_request": {
    "decision_time": "2026-01-05T21:05:00Z",
    "metric_variant": "raw_issue_count"
  },
  "base_record": {
    "record_id": "synthetic-r1",
    "revision": 1,
    "supersedes_record_id": null,
    "kind": "observation",
    "effective_at": "2026-01-05T21:00:00Z",
    "available_at": "2026-01-05T21:01:00Z",
    "is_final": true,
    "session_date": "2026-01-05",
    "venue_id": "SYNTH:XNAS",
    "universe_id": "SYNTH:ACTIVE-100",
    "universe_revision": "2026-01-05-r1",
    "session_id": "regular",
    "calendar_id": "SYNTH:XNAS-2026",
    "comparison_basis": "official-close-to-adjusted-comparable-prior-close",
    "corporate_action_policy": "synthetic-split-and-distribution-adjusted-v1",
    "listing_identifier_scheme": "synthetic-stable-listing-id-v1",
    "advances": 60,
    "declines": 30,
    "unchanged": 8,
    "excluded": 2,
    "missing": 0,
    "unclassified": 0,
    "universe_size": 100
  },
  "cases": [
    {
      "name": "resolved_advances",
      "record_patches": [{}],
      "expected": {
        "evaluation_state": "resolved",
        "publishable": true,
        "net_advances": 30,
        "absolute_breadth_index": 30,
        "breadth_state": "advances_imbalanced",
        "revision": 1,
        "future_records_ignored": 0
      }
    },
    {
      "name": "resolved_declines_mirror",
      "record_patches": [{"advances": 30, "declines": 60}],
      "expected": {
        "evaluation_state": "resolved",
        "publishable": true,
        "net_advances": -30,
        "absolute_breadth_index": 30,
        "breadth_state": "declines_imbalanced"
      }
    },
    {
      "name": "active_balance",
      "record_patches": [{"advances": 40, "declines": 40, "unchanged": 18}],
      "expected": {
        "evaluation_state": "resolved",
        "publishable": true,
        "net_advances": 0,
        "absolute_breadth_index": 0,
        "breadth_state": "active_balance"
      }
    },
    {
      "name": "no_movers",
      "record_patches": [{"advances": 0, "declines": 0, "unchanged": 98}],
      "expected": {
        "evaluation_state": "resolved",
        "publishable": true,
        "net_advances": 0,
        "absolute_breadth_index": 0,
        "breadth_state": "no_movers"
      }
    },
    {
      "name": "empty_universe",
      "record_patches": [{"advances": 0, "declines": 0, "unchanged": 0, "excluded": 0, "universe_size": 0}],
      "expected": {
        "evaluation_state": "resolved",
        "publishable": true,
        "net_advances": 0,
        "absolute_breadth_index": 0,
        "breadth_state": "empty_universe",
        "coverage_ratio": null
      }
    },
    {
      "name": "missing_issue",
      "record_patches": [{"excluded": 0, "missing": 2}],
      "expected": {
        "evaluation_state": "incomplete",
        "publishable": false,
        "net_advances": null,
        "absolute_breadth_index": null,
        "reason_codes": ["missing_issues_present"]
      }
    },
    {
      "name": "unclassified_issue",
      "record_patches": [{"excluded": 0, "unclassified": 2}],
      "expected": {
        "evaluation_state": "incomplete",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["unclassified_issues_present"]
      }
    },
    {
      "name": "partition_mismatch",
      "record_patches": [{"universe_size": 101}],
      "expected": {
        "evaluation_state": "incomplete",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["partition_mismatch"]
      }
    },
    {
      "name": "future_correction_ignored",
      "record_patches": [
        {},
        {
          "record_id": "synthetic-r2",
          "revision": 2,
          "supersedes_record_id": "synthetic-r1",
          "available_at": "2026-01-05T22:00:00Z",
          "advances": 55,
          "declines": 35
        }
      ],
      "expected": {
        "evaluation_state": "resolved",
        "record_id": "synthetic-r1",
        "revision": 1,
        "net_advances": 30,
        "absolute_breadth_index": 30,
        "future_records_ignored": 1
      }
    },
    {
      "name": "available_correction_applied",
      "request_patch": {"decision_time": "2026-01-05T22:05:00Z"},
      "record_patches": [
        {},
        {
          "record_id": "synthetic-r2",
          "revision": 2,
          "supersedes_record_id": "synthetic-r1",
          "available_at": "2026-01-05T22:00:00Z",
          "advances": 55,
          "declines": 35
        }
      ],
      "expected": {
        "evaluation_state": "resolved",
        "record_id": "synthetic-r2",
        "revision": 2,
        "net_advances": 20,
        "absolute_breadth_index": 20,
        "future_records_ignored": 0
      }
    },
    {
      "name": "revision_conflict",
      "request_patch": {"decision_time": "2026-01-05T22:05:00Z"},
      "record_patches": [
        {},
        {
          "record_id": "synthetic-r2-a",
          "revision": 2,
          "supersedes_record_id": "synthetic-r1",
          "available_at": "2026-01-05T21:30:00Z"
        },
        {
          "record_id": "synthetic-r2-b",
          "revision": 2,
          "supersedes_record_id": "synthetic-r1",
          "available_at": "2026-01-05T21:31:00Z",
          "advances": 58,
          "declines": 32
        }
      ],
      "expected": {
        "evaluation_state": "ambiguous",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["duplicate_revision"]
      }
    },
    {
      "name": "identity_conflict",
      "request_patch": {"decision_time": "2026-01-05T22:05:00Z"},
      "record_patches": [
        {},
        {
          "record_id": "synthetic-r2",
          "revision": 2,
          "supersedes_record_id": "synthetic-r1",
          "available_at": "2026-01-05T21:30:00Z",
          "universe_id": "SYNTH:OTHER-100"
        }
      ],
      "expected": {
        "evaluation_state": "ambiguous",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["conflicting_snapshot_identity"]
      }
    },
    {
      "name": "non_contiguous_revision",
      "request_patch": {"decision_time": "2026-01-05T22:05:00Z"},
      "record_patches": [
        {},
        {
          "record_id": "synthetic-r3",
          "revision": 3,
          "supersedes_record_id": "synthetic-r1",
          "available_at": "2026-01-05T21:30:00Z"
        }
      ],
      "expected": {
        "evaluation_state": "ambiguous",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["non_contiguous_revision_lineage"]
      }
    },
    {
      "name": "cancelled_head",
      "request_patch": {"decision_time": "2026-01-05T22:05:00Z"},
      "record_patches": [
        {},
        {
          "record_id": "synthetic-r2",
          "revision": 2,
          "supersedes_record_id": "synthetic-r1",
          "kind": "cancellation",
          "available_at": "2026-01-05T21:30:00Z"
        }
      ],
      "expected": {
        "evaluation_state": "incomplete",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["current_revision_cancelled"]
      }
    },
    {
      "name": "provisional_resolved",
      "record_patches": [{"is_final": false}],
      "expected": {
        "evaluation_state": "resolved",
        "publishable": true,
        "is_provisional": true,
        "absolute_breadth_index": 30
      }
    },
    {
      "name": "unsupported_normalized_variant",
      "request_patch": {"metric_variant": "mover_normalized"},
      "record_patches": [{}],
      "expected": {
        "evaluation_state": "unsupported",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["metric_variant_not_raw_issue_count"]
      }
    },
    {
      "name": "no_records",
      "records": [],
      "expected": {
        "evaluation_state": "incomplete",
        "publishable": false,
        "absolute_breadth_index": null,
        "reason_codes": ["no_revision_records"]
      }
    }
  ]
}