{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://crank.local/schemas/capability-inventory.schema.json", "title": "Crank Community Capability Inventory", "type": "object", "additionalProperties": false, "required": [ "schema_version", "product", "flows", "protocol" ], "properties": { "schema_version": { "const": 2 }, "product": { "const": "crank-community" }, "flows": { "type": "array", "minItems": 1, "maxItems": 10000, "items": { "$ref": "#/$defs/flow" } }, "protocol": { "$ref": "#/$defs/protocol" } }, "$defs": { "flow": { "type": "object", "additionalProperties": false, "required": [ "id", "type", "requirements", "user_outcome", "owner", "status", "capabilities", "evidence" ], "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "type": { "enum": [ "ui", "api", "mcp" ] }, "requirements": { "type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^FR-[1-9][0-9]*$" } }, "user_outcome": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "[\\s\\S]*\\S[\\s\\S]*" }, "owner": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "[\\s\\S]*\\S[\\s\\S]*" }, "status": { "enum": [ "implemented", "planned", "gap", "blocked" ] }, "capabilities": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "enum": [ "tools", "resources", "prompts", "tasks", "load_runs" ] } }, "evidence": { "$ref": "#/$defs/evidence" }, "notes": { "type": "string", "maxLength": 4096 } } }, "evidence": { "type": "object", "additionalProperties": false, "required": [ "automated", "manual" ], "properties": { "automated": { "$ref": "#/$defs/evidencePaths" }, "manual": { "$ref": "#/$defs/evidencePaths" } } }, "evidencePaths": { "type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^(?!/)(?!.*//)(?!.*(?:^|/)\\.\\.?($|/))(?!.*\\\\).+$" } }, "protocol": { "type": "object", "additionalProperties": false, "required": [ "selected_on", "source_basis", "revisions", "withdrawn", "capabilities" ], "properties": { "selected_on": { "type": "string", "minLength": 1, "maxLength": 32, "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "source_basis": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "[\\s\\S]*\\S[\\s\\S]*" }, "revisions": { "type": "array", "minItems": 2, "maxItems": 2, "items": { "$ref": "#/$defs/revision" } }, "withdrawn": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 32 } }, "capabilities": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "$ref": "#/$defs/protocolCapability" } } } }, "revision": { "type": "object", "additionalProperties": false, "required": [ "revision", "role", "lifecycle", "session", "required_methods", "provenance" ], "properties": { "revision": { "type": "string", "minLength": 1, "maxLength": 32, "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "role": { "type": "string", "minLength": 1, "maxLength": 64 }, "lifecycle": { "type": "string", "minLength": 1, "maxLength": 64 }, "session": { "type": "boolean" }, "required_methods": { "type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } }, "provenance": { "$ref": "#/$defs/revisionProvenance" } } }, "revisionProvenance": { "type": "object", "additionalProperties": false, "required": [ "locator", "sha256", "captured_on" ], "properties": { "locator": { "type": "string", "minLength": 1, "maxLength": 2048 }, "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "captured_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } } }, "protocolCapability": { "type": "object", "additionalProperties": false, "required": [ "surface", "kind", "role", "status", "applicability", "revisions", "subfeatures", "open_subfeatures", "advertised", "owner", "fallback", "evidence_target", "requirement" ], "properties": { "surface": { "type": "string", "minLength": 1, "maxLength": 256 }, "kind": { "enum": [ "capability", "method", "notification", "extension" ] }, "role": { "enum": [ "server", "client", "both" ] }, "status": { "enum": [ "supported", "not_applicable", "experimental", "deferred" ] }, "applicability": { "enum": [ "stable", "deprecated", "extension" ] }, "revisions": { "type": "array", "minItems": 1, "maxItems": 8, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 32 } }, "subfeatures": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 256 } }, "open_subfeatures": { "type": "boolean" }, "advertised": { "type": [ "object", "null" ] }, "owner": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "[\\s\\S]*\\S[\\s\\S]*" }, "fallback": { "type": "string", "minLength": 1, "maxLength": 2048 }, "evidence_target": { "type": "string", "minLength": 1, "maxLength": 256 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2048 }, "requirement": { "type": "string", "pattern": "^FR-[1-9][0-9]*$" }, "per_revision": { "type": "object" } } } } }