yams/docs/spec/schemas/provenance_v1.schema.json
2025-09-25 16:40:56 -04:00

33 lines
1.2 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "schema://yams/provenance_v1",
"title": "Provenance v1 — Evidence & sourcing metadata for graph entities",
"type": "object",
"properties": {
"source": { "type": "string", "description": "e.g., ingestion, agent, user" },
"method": { "type": "string", "description": "brief method or tool name" },
"timestamp": { "type": "string", "format": "date-time" },
"agent": { "type": "string", "description": "agent name/id" },
"confidence": { "type": "number", "minimum": 0, "maximum": 1 },
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": { "type": "string" },
"media_type": { "type": "string" },
"sha256": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" },
"size": { "type": "integer", "minimum": 0 },
"url": { "type": "string", "format": "uri" },
"description": { "type": "string" }
},
"required": ["sha256"],
"additionalProperties": true
},
"default": []
}
},
"required": ["timestamp"],
"additionalProperties": true
}