{
  "endpoint_groups": [
    {
      "aspects": [
        {
          "aspect": "continuity",
          "available_count": 137,
          "description": "Cross-entity continuity profile: threads, related sites/assets/places, and their supporting evidence."
        },
        {
          "aspect": "evidence-graph",
          "available_count": 572,
          "description": "Derived graph of how sources, facts, identifiers, and lifecycle events support this record's claims."
        },
        {
          "aspect": "graph",
          "available_count": 509,
          "description": "Direct relationship graph (nodes and edges) connecting this record to places, assets, and other entities within two steps."
        },
        {
          "aspect": "light-signature",
          "available_count": 8,
          "description": "Structured light characteristic (flash pattern, color, period) for this active light."
        },
        {
          "aspect": "map-history",
          "available_count": 606,
          "description": "Movement/location points and paths for mapping this record's history."
        },
        {
          "aspect": "spatiotemporal-profile",
          "available_count": 0,
          "description": "Reconstructed state-by-year slices combining location, structure, and light characteristic."
        },
        {
          "aspect": "state-profile",
          "available_count": 312,
          "description": "The record's state at each distinct historical phase (construction, modification, automation, etc.)."
        }
      ],
      "entity_kind": "lighthouses",
      "url_pattern": "/api/lighthouses/{lux_id}/{aspect}.json"
    },
    {
      "aspects": [
        {
          "aspect": "graph",
          "available_count": 125,
          "description": "Direct relationship graph (nodes and edges) connecting this record to places, assets, and other entities within two steps."
        },
        {
          "aspect": "graph-wider",
          "available_count": 80,
          "description": "Related-object graph reaching two steps beyond this asset's direct relationships."
        },
        {
          "aspect": "lifecycle",
          "available_count": 125,
          "description": "Dated lifecycle events for this heritage asset (installation, transfer, restoration, etc.)."
        },
        {
          "aspect": "lifecycle-wider",
          "available_count": 80,
          "description": "Lifecycle events for objects related to this asset through a shared manufacturer or place, within two graph steps."
        }
      ],
      "entity_kind": "assets",
      "url_pattern": "/api/assets/{asset_id}/{aspect}.json"
    }
  ],
  "generated_at": "2026-08-31T19:40:46+00:00",
  "note": "Review-preview per-entity JSON exports, not a stable versioned API. Structure may change between builds; see /data/ for reuse guidance.",
  "schema_version": 1,
  "version_transitions": [
    {
      "compatibility": "v2 timeline shards are the only generated public contract after parity and consumer gates passed.",
      "first_candidate": {
        "aspect": "timeline",
        "available_shards": 1,
        "entity_kind": "lighthouses",
        "shard_pattern": "/api/v2/lighthouses/timeline/{shard}.json"
      },
      "published": true,
      "registry_url": "/api/v2/lighthouses/timeline/index.json",
      "status": "active",
      "target_version": 2,
      "v1_contract": "retired in v0.24.467-review",
      "v1_sunset": "effective v0.24.467-review"
    },
    {
      "compatibility": "v1 remains supported while the additive v2 graph contract completes its compatibility period.",
      "first_candidate": {
        "aspect": "graph",
        "available_shards": 1,
        "entity_kind": "lighthouses",
        "shard_pattern": "/api/v2/lighthouses/graph/{shard}.json"
      },
      "published": true,
      "registry_url": "/api/v2/lighthouses/graph/index.json",
      "status": "active",
      "target_version": 2,
      "v1_contract": "/api/lighthouses/{lux_id}/graph.json",
      "v1_sunset": "not scheduled"
    },
    {
      "compatibility": "v1 remains supported for at least 90 days after the verified production notice and until a separately approved retirement.",
      "deprecation": {
        "announced_at": "2026-08-26T08:13:01Z",
        "minimum_compatibility_days": 90,
        "post_sunset_http_status": 404,
        "prepared_at": "2026-08-26",
        "replacement_registry_url": "/api/v2/lighthouses/map-history/index.json",
        "replacement_shard_pattern": "/api/v2/lighthouses/map-history/{shard}.json",
        "status": "announced",
        "sunset_not_before": "2026-11-24T08:13:01Z"
      },
      "first_candidate": {
        "aspect": "map-history",
        "available_shards": 1,
        "entity_kind": "lighthouses",
        "shard_pattern": "/api/v2/lighthouses/map-history/{shard}.json"
      },
      "published": true,
      "registry_url": "/api/v2/lighthouses/map-history/index.json",
      "status": "active",
      "target_version": 2,
      "v1_contract": "/api/lighthouses/{lux_id}/map-history.json",
      "v1_sunset": "not scheduled"
    }
  ]
}