Files
crank/docs/schemas/capability-inventory.schema.json
bsodfather 54ce770682
CI / Rust Checks (pull_request) Failing after 13m41s
CI / UI Checks (pull_request) Skipped
CI / Frontend E2E (pull_request) Skipped
CI / Community Image Smoke (pull_request) Skipped
CI / Deploy (pull_request) Skipped
Community Release / release (push) Failing after 13m33s
feat(epic3): deliver the accepted Epic 3 scope through Story 3.17
Recovery delivery of the accumulated, TL-accepted Epic 3 work that had never been
committed to Git (stories 3.6-3.17, see the crank board). Story 3.18 is not accepted
yet and is deliberately excluded: its logging surface, its capability registration,
its oracle projections and its tests are not part of this tree.

Accepted scope
- 3.6 typed static Resource Drafts; 3.7 publication and exact binding of static
  Resource Versions; 3.8 MCP discovery/read and revocation of static Resources;
- 3.9 Resource import/export in API and UI plus TLS dependency maintenance;
  3.10 REST-backed Resource templates; 3.11 shared REST read runtime and the MCP
  revision/capability foundation;
- 3.12 parameterised Prompt Drafts with preview; 3.13 Prompt publication and exact
  version binding to Agents; 3.14 MCP prompts; 3.15 Prompt import/export;
- 3.16 composite Prompts with published Resources (dependency content scan plus
  dynamic read through the accepted 3.11 runtime, admin preview and MCP prompts/get);
- 3.17 bounded MCP completion suggestions from typed published schemas and the
  resources/list admission fix for bound template publications.

Accepted evidence being reused (unchanged code paths)
- 3.16 candidate: core 7, admin-api 22, registry 4, mcp-server 4, UI 6; one final
  `just verify` run 1651 passed / 0 failed / 2 ignored.
- 3.17 candidate: full run 1672 passed / 0 failed / 2 ignored, QA targeted reruns and
  a real MCP Inspector 2.12.0 client smoke.

Delivery engineering in this commit
- CI: one event per change (feature branches are gated by their pull request, push
  runs only on main), story events run the changed packages, the full workspace suite
  stays the feature/release gate; no cache/sharding without a measured runner check.
- Release: the packaged archives, checksums and SBOM are now uploaded to the Gitea
  release entry of the tag instead of dying with the runner workspace.

Not included on purpose: Story 3.18 work, build caches, runtime databases, local
credentials and scratch evidence.

Refs: crank kanban t_e39d7263; baseline 1b6db09bd1.
2026-10-25 09:08: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"
}
}
}
}
}