{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ODPG schema",
  "description": "This is the schema for ODPG v1.0.",
  "type": "object",
  "properties": {
    "schema": {
      "type": "string",
      "description": "Defines the URL of Schema. Used often for validation purposes.",
      "format": "uri"
    },
    "version": {
      "type": "string",
      "description": "Current ODPG version.",
      "examples": [
        "1.0",
        "dev"
      ]
    },
    "kind": {
      "type": "string",
      "description": "Type of graph specification document.",
      "const": "Graph"
    },
    "graph": {
      "type": "object",
      "description": "Root element for the Open Data Product Graph.",
      "$ref": "#/$defs/graph"
    }
  },
  "required": [
    "schema",
    "version",
    "kind",
    "graph"
  ],
  "additionalProperties": false,
  "$defs": {
    "graph": {
      "type": "object",
      "description": "Container for graph metadata, nodes, and edges.",
      "properties": {
        "metadata": {
          "type": "object",
          "description": "Metadata describing the graph, its purpose, ownership, visibility, and discovery information.",
          "$ref": "#/$defs/graphMetadata"
        },
        "nodes": {
          "type": "array",
          "description": "Array of node objects.",
          "items": {
            "$ref": "#/$defs/node"
          }
        },
        "edges": {
          "type": "array",
          "description": "Array of edge objects.",
          "items": {
            "$ref": "#/$defs/edge"
          }
        }
      },
      "required": [
        "metadata",
        "nodes",
        "edges"
      ],
      "additionalProperties": false,
      "patternProperties": {
        "^x-": {}
      }
    },
    "graphMetadata": {
      "type": "object",
      "description": "Metadata describing the graph.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier of the graph."
        },
        "name": {
          "type": "object",
          "description": "Human-readable graph name. Supports language-specific values.",
          "$ref": "#/$defs/languages"
        },
        "description": {
          "type": "object",
          "description": "Human-readable description of what the graph represents. Supports language-specific values.",
          "$ref": "#/$defs/languages"
        },
        "domain": {
          "type": "object",
          "description": "Business, industry, or subject domain covered by the graph. Supports language-specific values.",
          "$ref": "#/$defs/languages"
        },
        "purpose": {
          "type": "object",
          "description": "Explanation of why the graph exists and how it should be used. Supports language-specific values.",
          "$ref": "#/$defs/languages"
        },
        "tags": {
          "type": "array",
          "description": "Keywords used for discovery, filtering, grouping, and search.",
          "items": {
            "type": "string"
          }
        },
        "status": {
          "type": "string",
          "description": "Current status of the graph.",
          "enum": [
            "draft",
            "active",
            "deprecated",
            "archived"
          ]
        },
        "visibility": {
          "type": "string",
          "description": "Intended visibility of the graph.",
          "enum": [
            "public",
            "internal",
            "restricted",
            "private"
          ]
        },
        "owner": {
          "type": "object",
          "description": "Party responsible for the graph.",
          "$ref": "#/$defs/owner"
        }
      },
      "required": [
        "id",
        "name",
        "description"
      ],
      "additionalProperties": false,
      "patternProperties": {
        "^x-": {}
      }
    },
    "owner": {
      "type": "object",
      "description": "Party responsible for the graph.",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the owning person, team, or organization."
        },
        "email": {
          "type": "string",
          "format": "email",
          "description": "Contact email for the owning party."
        }
      },
      "required": [
        "name"
      ],
      "additionalProperties": false,
      "patternProperties": {
        "^x-": {}
      }
    },
    "node": {
      "type": "object",
      "description": "A distinct entity participating in the graph ecosystem.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Unique identifier of the node."
        },
        "type": {
          "type": "string",
          "description": "Type of graph entity represented by the node.",
          "examples": [
            "DataProduct",
            "UseCase",
            "BusinessObjective",
            "KPI",
            "Domain",
            "Dataset",
            "API",
            "Policy",
            "Workflow",
            "Agent",
            "Capability",
            "StrategicOpportunity"
          ]
        },
        "$ref": {
          "type": "string",
          "description": "Path or URI to the referenced specification or resource."
        }
      },
      "required": [
        "id",
        "type",
        "$ref"
      ],
      "additionalProperties": false,
      "patternProperties": {
        "^x-": {}
      }
    },
    "edge": {
      "type": "object",
      "description": "A directional relationship connecting two graph nodes.",
      "properties": {
        "from": {
          "type": "string",
          "description": "Source node identifier."
        },
        "to": {
          "type": "string",
          "description": "Target node identifier."
        },
        "type": {
          "type": "string",
          "description": "Relationship type.",
          "examples": [
            "uses",
            "supports",
            "contributesTo",
            "measures",
            "tracks",
            "dependsOn",
            "produces",
            "consumes",
            "governedBy",
            "ownedBy",
            "alignsWith",
            "relatedTo",
            "impacts",
            "derivedFrom",
            "exposes",
            "monitors",
            "identifies"
          ]
        },
        "confidence": {
          "type": "string",
          "description": "Confidence level of the relationship.",
          "enum": [
            "high",
            "medium",
            "low"
          ]
        }
      },
      "required": [
        "from",
        "to",
        "type",
        "confidence"
      ],
      "additionalProperties": false,
      "patternProperties": {
        "^x-": {}
      }
    },
    "languages": {
      "type": "object",
      "description": "Allows multilingual text fields where keys are ISO 639-1 language codes.",
      "patternProperties": {
        "^[a-z]{2}$": {
          "type": "string",
          "description": "Localized string value keyed by ISO 639-1 two-letter language code."
        }
      },
      "minProperties": 1,
      "additionalProperties": false
    }
  }
}