{
"$schema": "https://lix.dev/schema-v1.json",
"key": "lix_branch_descriptor",
"description": "User-facing branch metadata (name and visibility). The stable identity of a branch; the matching `lix_branch_ref` carries the moving head pointer. The catalog's `lix_branch` surface joins this descriptor with its ref to present a single user-visible branch row.",
"columns": [
{
"name": "hidden",
"type": "boolean",
"nullable": true,
"default_value": false,
"description": "When true, the branch is filtered from default listings (CLI, catalog views); operations by explicit id still succeed."
},
{
"name": "id",
"type": "uuid",
"nullable": false,
"default_expression": "uuidv7()",
"description": "Stable branch identifier (UUIDv7). Referenced by `lix_branch_ref.id`."
},
{
"name": "name",
"type": "text",
"nullable": false,
"description": "Human-readable branch name (e.g. `main`, `feature-x`) shown in branch listings and CLI output."
}
],
"primary_key": [
"id"
],
"unique": [
[
"name"
]
]
}