d3cb6e9045
Schemas, examples and a flag registry for the twelve HUX cards, a dependency-free validator, the governance rules (memory ledger, autonomy matrix, friendly modes mapped to real Switchyard routes, privacy defaults, suggestion gating, release state machine) and the contract doc UI work codes against. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RNPhwu2bsaRNg3DETSAZoM
70 lines
3.0 KiB
JSON
70 lines
3.0 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://hermes.bstein.dev/contracts/hux/v1/artifact.schema.json",
|
|
"title": "HUX artifact",
|
|
"description": "Typed, versioned output (HUX-04). Content lives behind content_ref; versions are immutable and diffable; lineage records what an artifact was derived from; promotion copies a version into a project.",
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["schema", "id", "owner", "type", "title", "current_version", "versions", "sensitivity", "created_at", "updated_at"],
|
|
"properties": {
|
|
"schema": {"const": "hux.artifact.v1"},
|
|
"id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"owner": {"$ref": "common.schema.json#/$defs/user_ref"},
|
|
"conversation_id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"project_id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"type": {"type": "string", "enum": ["markdown", "code", "html", "svg", "image", "json", "csv", "document", "audio"]},
|
|
"language": {"type": "string", "maxLength": 40},
|
|
"title": {"type": "string", "minLength": 1, "maxLength": 200},
|
|
"current_version": {"type": "integer", "minimum": 1},
|
|
"versions": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"items": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["version", "created_at", "created_by", "content_ref"],
|
|
"properties": {
|
|
"version": {"type": "integer", "minimum": 1},
|
|
"created_at": {"$ref": "common.schema.json#/$defs/timestamp"},
|
|
"created_by": {"$ref": "common.schema.json#/$defs/actor"},
|
|
"message_id": {"type": "string", "maxLength": 120},
|
|
"content_ref": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["hash", "bytes", "mime"],
|
|
"properties": {
|
|
"hash": {"$ref": "common.schema.json#/$defs/sha256"},
|
|
"bytes": {"type": "integer", "minimum": 0},
|
|
"mime": {"type": "string", "maxLength": 120}
|
|
}
|
|
},
|
|
"diff_from": {"type": "integer", "minimum": 1},
|
|
"lineage": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["artifact_id", "version"],
|
|
"properties": {
|
|
"artifact_id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"version": {"type": "integer", "minimum": 1}
|
|
}
|
|
},
|
|
"note": {"type": "string", "maxLength": 200}
|
|
}
|
|
}
|
|
},
|
|
"promotion": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["project_id", "version", "at"],
|
|
"properties": {
|
|
"project_id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"version": {"type": "integer", "minimum": 1},
|
|
"at": {"$ref": "common.schema.json#/$defs/timestamp"}
|
|
}
|
|
},
|
|
"sensitivity": {"$ref": "common.schema.json#/$defs/sensitivity"},
|
|
"created_at": {"$ref": "common.schema.json#/$defs/timestamp"},
|
|
"updated_at": {"$ref": "common.schema.json#/$defs/timestamp"}
|
|
}
|
|
}
|