{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://gsp.local/schema/gsp.schema.json",
  "title": "GSP",
  "description": "Game Specification Protocol core unit schema.",
  "type": "object",
  "additionalProperties": true,
  "required": ["id"],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Unique GSP id in the current project."
    },
    "context": {
      "type": "string",
      "description": "Core design context. Optional. Empty or missing context means the GSP can be treated as a placeholder."
    },
    "resolution": {
      "type": "string",
      "enum": ["L0", "L1", "L2", "L3", "L4", "L5"],
      "description": "Soft clarity level. Used by tools and agents for stage checks, not as proof of design quality."
    },
    "with": {
      "type": "array",
      "description": "General design-context relation. Items are GSP ids or local relation objects.",
      "items": {
        "oneOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "object",
            "additionalProperties": true,
            "required": ["id"],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1
              },
              "context": {
                "type": "string"
              }
            }
          }
        ]
      }
    },
    "refines": {
      "type": "string",
      "minLength": 1,
      "description": "Single GSP id refined by this GSP."
    },
    "type": {
      "type": "string",
      "description": "Optional helper category for search, display, compiler hints and context pruning."
    }
  }
}