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.4 KiB
JSON
70 lines
3.4 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://hermes.bstein.dev/contracts/hux/v1/project.schema.json",
|
|
"title": "HUX projects and conversations",
|
|
"description": "Organisation model for chats (HUX-03): projects own conversations and promoted artifacts; conversations carry tags, pins and branch lineage. Search indexes the fields listed in $defs/search_index.",
|
|
"$defs": {
|
|
"project": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["schema", "id", "owner", "name", "tags", "pinned", "archived", "created_at", "updated_at"],
|
|
"properties": {
|
|
"schema": {"const": "hux.project.v1"},
|
|
"id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"owner": {"$ref": "common.schema.json#/$defs/user_ref"},
|
|
"name": {"type": "string", "minLength": 1, "maxLength": 120},
|
|
"description": {"type": "string", "maxLength": 2000},
|
|
"tags": {"$ref": "common.schema.json#/$defs/tags"},
|
|
"pinned": {"type": "boolean"},
|
|
"archived": {"type": "boolean"},
|
|
"default_mode": {"type": "string", "enum": ["fast", "thoughtful", "research", "create", "private"]},
|
|
"memory_scope_id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"created_at": {"$ref": "common.schema.json#/$defs/timestamp"},
|
|
"updated_at": {"$ref": "common.schema.json#/$defs/timestamp"}
|
|
}
|
|
},
|
|
"conversation": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["schema", "id", "owner", "title", "tags", "pinned", "archived", "artifact_ids", "created_at", "updated_at"],
|
|
"properties": {
|
|
"schema": {"const": "hux.conversation.v1"},
|
|
"id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"owner": {"$ref": "common.schema.json#/$defs/user_ref"},
|
|
"project_id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"title": {"type": "string", "minLength": 1, "maxLength": 200},
|
|
"tags": {"$ref": "common.schema.json#/$defs/tags"},
|
|
"pinned": {"type": "boolean"},
|
|
"archived": {"type": "boolean"},
|
|
"mode": {"type": "string", "enum": ["fast", "thoughtful", "research", "create", "private"]},
|
|
"branch": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": ["parent_conversation_id", "branch_point_message_id"],
|
|
"properties": {
|
|
"parent_conversation_id": {"$ref": "common.schema.json#/$defs/id"},
|
|
"branch_point_message_id": {"type": "string", "minLength": 1, "maxLength": 120}
|
|
}
|
|
},
|
|
"artifact_ids": {"type": "array", "maxItems": 500, "uniqueItems": true, "items": {"$ref": "common.schema.json#/$defs/id"}},
|
|
"last_message_at": {"$ref": "common.schema.json#/$defs/timestamp"},
|
|
"created_at": {"$ref": "common.schema.json#/$defs/timestamp"},
|
|
"updated_at": {"$ref": "common.schema.json#/$defs/timestamp"}
|
|
}
|
|
},
|
|
"search_index": {
|
|
"type": "object",
|
|
"description": "Fields the tenant indexes; the UI may not assume anything else is searchable.",
|
|
"additionalProperties": false,
|
|
"required": ["conversation"],
|
|
"properties": {
|
|
"conversation": {"type": "array", "items": {"type": "string", "enum": ["title", "tags", "message_text", "artifact_titles", "project_name"]}}
|
|
}
|
|
}
|
|
},
|
|
"oneOf": [
|
|
{"$ref": "#/$defs/project"},
|
|
{"$ref": "#/$defs/conversation"}
|
|
]
|
|
}
|