Add FLUID wire contract schemas

Nine JSON Schemas covering the five record types from the schema spec,
plus backend requirements, feedback, the revision descriptor, routing
policy and the telemetry envelope. These are the integration boundary:
readable without any fluid-core code, so adapters may be written in any
language.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014KmVxhJ35tCo7rE7UnLwWu

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 1116572@bnt-lap001
Assistant-Session: 8ba9bb93-a72a-4883-b189-2499cce5c400
This commit is contained in:
tegwick 2026-09-04 01:55:47 +02:00
parent 7d2fc2af5d
commit fbbf56df7a
11 changed files with 1242 additions and 0 deletions

View file

@ -0,0 +1,40 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://fluid.dev/schemas/feedback.schema.json",
"title": "FLUID explicit consumer feedback",
"description": "Structured feedback from a consumer. Treated as evidence and never as authority to change anything (FluidAPIStandards.md section 15).",
"type": "object",
"properties": {
"fluid_feedback": {
"type": "object",
"properties": {
"schema_version": { "$ref": "common.schema.json#/$defs/schemaVersion" },
"id": { "$ref": "common.schema.json#/$defs/feedbackId" },
"interface_id": { "$ref": "common.schema.json#/$defs/interfaceId" },
"received_at": { "$ref": "common.schema.json#/$defs/timestamp" },
"cohort": { "$ref": "common.schema.json#/$defs/cohortId" },
"revision": { "$ref": "common.schema.json#/$defs/revisionId" },
"goal": { "type": "string" },
"attempt": { "type": "string" },
"attempted_operations": { "type": "array", "items": { "type": "string" } },
"outcome": { "type": "string" },
"missing_capability": { "type": "string" },
"workaround": { "type": ["string", "array"], "items": { "type": "string" } },
"impact": {
"type": "object",
"properties": {
"description": { "type": "string" },
"calls": { "type": "integer", "minimum": 0 },
"latency_ms": { "type": "number", "minimum": 0 }
},
"additionalProperties": false
},
"confidence": { "$ref": "common.schema.json#/$defs/unitInterval" }
},
"required": ["schema_version", "id", "interface_id", "received_at", "goal"],
"additionalProperties": false
}
},
"required": ["fluid_feedback"],
"additionalProperties": false
}