214 lines
5.9 KiB
JSON
214 lines
5.9 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://docforge.local/schema/manual-render-plan-v1.json",
|
|
"title": "DocForge immutable manual render plan",
|
|
"$comment": "plan_id is the SHA-256 of canonical JSON without plan_id and is verified by the runtime contract validator.",
|
|
"$defs": {
|
|
"sha256": {
|
|
"type": "string",
|
|
"pattern": "^[0-9a-f]{64}$"
|
|
},
|
|
"project": {
|
|
"type": "object",
|
|
"required": [
|
|
"project_id",
|
|
"project_root_fingerprint",
|
|
"adapter",
|
|
"revision",
|
|
"source_hash"
|
|
],
|
|
"properties": {
|
|
"project_id": { "type": "string", "minLength": 1 },
|
|
"project_root_fingerprint": {
|
|
"type": "string",
|
|
"pattern": "^[0-9a-f]{16}$"
|
|
},
|
|
"adapter": { "type": "string", "minLength": 1 },
|
|
"revision": { "type": "string", "minLength": 1 },
|
|
"source_hash": { "$ref": "#/$defs/sha256" }
|
|
},
|
|
"additionalProperties": false
|
|
},
|
|
"edge": {
|
|
"type": "object",
|
|
"required": ["source_id", "relation", "target_id"],
|
|
"properties": {
|
|
"source_id": { "type": "string", "minLength": 1 },
|
|
"relation": { "type": "string", "minLength": 1 },
|
|
"target_id": { "type": "string", "minLength": 1 }
|
|
},
|
|
"additionalProperties": false
|
|
},
|
|
"page": {
|
|
"type": "object",
|
|
"required": [
|
|
"node_id",
|
|
"title",
|
|
"family",
|
|
"authority",
|
|
"status",
|
|
"tags",
|
|
"summary",
|
|
"content",
|
|
"content_hash",
|
|
"components",
|
|
"breadcrumbs",
|
|
"cross_references",
|
|
"backlinks"
|
|
],
|
|
"properties": {
|
|
"node_id": { "type": "string", "minLength": 1 },
|
|
"title": { "type": "string", "minLength": 1 },
|
|
"family": { "type": "string", "minLength": 1 },
|
|
"authority": { "type": "string", "minLength": 1 },
|
|
"status": { "type": "string", "minLength": 1 },
|
|
"tags": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "type": "string", "minLength": 1 },
|
|
"uniqueItems": true
|
|
},
|
|
"summary": { "type": "string" },
|
|
"content": { "type": "string" },
|
|
"content_hash": { "$ref": "#/$defs/sha256" },
|
|
"components": {
|
|
"type": "array",
|
|
"maxItems": 32,
|
|
"items": { "type": "string", "minLength": 1 },
|
|
"uniqueItems": true
|
|
},
|
|
"breadcrumbs": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "type": "string", "minLength": 1 }
|
|
},
|
|
"cross_references": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "$ref": "#/$defs/edge" }
|
|
},
|
|
"backlinks": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "$ref": "#/$defs/edge" }
|
|
}
|
|
},
|
|
"additionalProperties": false
|
|
},
|
|
"navigation_item": {
|
|
"type": "object",
|
|
"required": ["node_id", "title"],
|
|
"properties": {
|
|
"node_id": { "type": "string", "minLength": 1 },
|
|
"title": { "type": "string", "minLength": 1 }
|
|
},
|
|
"additionalProperties": false
|
|
},
|
|
"search_document": {
|
|
"type": "object",
|
|
"required": [
|
|
"node_id",
|
|
"title",
|
|
"summary",
|
|
"family",
|
|
"status",
|
|
"tags"
|
|
],
|
|
"properties": {
|
|
"node_id": { "type": "string", "minLength": 1 },
|
|
"title": { "type": "string", "minLength": 1 },
|
|
"summary": { "type": "string" },
|
|
"family": { "type": "string", "minLength": 1 },
|
|
"status": { "type": "string", "minLength": 1 },
|
|
"tags": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "type": "string", "minLength": 1 },
|
|
"uniqueItems": true
|
|
}
|
|
},
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"type": "object",
|
|
"required": [
|
|
"schema_version",
|
|
"contract",
|
|
"plan_id",
|
|
"project",
|
|
"view",
|
|
"changeset_hash",
|
|
"pages",
|
|
"navigation",
|
|
"search_documents",
|
|
"diagnostics"
|
|
],
|
|
"properties": {
|
|
"schema_version": { "const": 1 },
|
|
"contract": { "const": "docforge.manual-render-plan" },
|
|
"plan_id": { "$ref": "#/$defs/sha256" },
|
|
"project": { "$ref": "#/$defs/project" },
|
|
"view": {
|
|
"type": "object",
|
|
"required": ["view_id", "title", "families", "renderer"],
|
|
"properties": {
|
|
"view_id": { "type": "string", "minLength": 1 },
|
|
"title": { "type": "string", "minLength": 1 },
|
|
"families": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "type": "string", "minLength": 1 },
|
|
"uniqueItems": true
|
|
},
|
|
"renderer": { "type": "string", "minLength": 1 }
|
|
},
|
|
"additionalProperties": false
|
|
},
|
|
"changeset_hash": {
|
|
"oneOf": [
|
|
{ "$ref": "#/$defs/sha256" },
|
|
{ "type": "null" }
|
|
]
|
|
},
|
|
"pages": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "$ref": "#/$defs/page" }
|
|
},
|
|
"navigation": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "$ref": "#/$defs/navigation_item" }
|
|
},
|
|
"search_documents": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "$ref": "#/$defs/search_document" }
|
|
},
|
|
"diagnostics": {
|
|
"type": "object",
|
|
"required": ["orphans", "cycles"],
|
|
"properties": {
|
|
"orphans": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": { "type": "string", "minLength": 1 },
|
|
"uniqueItems": true
|
|
},
|
|
"cycles": {
|
|
"type": "array",
|
|
"maxItems": 10000,
|
|
"items": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"maxItems": 10000,
|
|
"items": { "type": "string", "minLength": 1 },
|
|
"uniqueItems": true
|
|
}
|
|
}
|
|
},
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"additionalProperties": false
|
|
}
|