Files
crank/docs/schemas/capability-inventory.schema.json
T
Hermes DevOps 75fe5a123c [skip ci] wip: preserve Hermes crank development checkpoint
Owner-authorized recovery of accumulated source changes.
Includes accepted work and in-progress changes; NOT a release or acceptance.
Parent baseline 1b6db09bd1. Runtime data, build caches and local credentials excluded.
2026-10-25 10:00:22 +00:00

383 lines
8.3 KiB
JSON

{
"$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"
}
}
}
}
}