{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://visuals.thegr0ve.com/schemas/public-traversal-graph.schema.json",
  "title": "Visual Commons Public Traversal Graph",
  "description": "Machine-readable atom, totem, collection, asset, and Voronoi traversal graph for the public Visual Commons.",
  "type": "object",
  "required": [
    "schema_version",
    "public_data_version",
    "generated_surface",
    "canonical_base_url",
    "llm_access_policy",
    "nodes",
    "edges",
    "voronoi_projection"
  ],
  "properties": {
    "$schema": {
      "type": "string"
    },
    "schema_version": {
      "type": "string"
    },
    "public_data_version": {
      "type": "string"
    },
    "generated_surface": {
      "const": "visuals_public_traversal_graph"
    },
    "commons_name": {
      "type": "string"
    },
    "canonical_base_url": {
      "type": "string",
      "format": "uri"
    },
    "robots_policy": {
      "type": "string"
    },
    "llm_access_policy": {
      "type": "string"
    },
    "commons_access_statement": {
      "type": "string"
    },
    "rights_boundary": {
      "type": "string"
    },
    "node_count": {
      "type": "integer"
    },
    "edge_count": {
      "type": "integer"
    },
    "voronoi_cell_count": {
      "type": "integer"
    },
    "metrics_snapshot": {
      "type": "object"
    },
    "public_data_endpoints": {
      "type": "object"
    },
    "traversal_notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "nodes": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "edges": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "voronoi_projection": {
      "type": "object"
    }
  },
  "additionalProperties": false
}
