Files
GSP/specs/versions/0.1/gsp.schema.json

103 lines
2.8 KiB
JSON

{
"$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."
},
"title": {
"type": "string",
"description": "Optional human-readable display title. Tools use id when title is missing."
},
"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."
},
"links": {
"description": "External paths, folders, URLs, or addresses associated with this GSP.",
"oneOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "array",
"items": {
"oneOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "object",
"additionalProperties": true,
"required": ["path"],
"properties": {
"path": {
"type": "string",
"minLength": 1
},
"role": {
"type": "string",
"enum": ["reference", "source", "binding", "output", "evidence"]
},
"context": {
"type": "string"
}
}
}
]
}
}
]
}
}
}