{
"$schema": "https://lix.dev/schema-v1.json",
"key": "lix_commit",
"description": "A commit is a stable point in project history. Branches point to commits. Parent commit IDs are ordered, with the first parent representing the mainline.",
"columns": [
{
"name": "id",
"type": "uuid",
"nullable": false,
"default_expression": "uuidv7()",
"description": "Stable identifier of this commit."
},
{
"name": "parent_commit_ids",
"type": "jsonb",
"nullable": false,
"description": "Ordered parent commit IDs; position zero is the first parent and later positions are merge parents."
},
{
"name": "base_commit_id",
"type": "uuid",
"nullable": true,
"description": "Exact global commit composed underneath this commit. Null marks a base-native commit. This is state dependency, not ancestry."
},
{
"name": "is_checkpoint",
"type": "boolean",
"nullable": false,
"description": "Immutable membership in the repository checkpoint inventory."
},
{
"name": "created_at",
"type": "text",
"nullable": false,
"description": "Creation timestamp from immutable canonical commit metadata."
}
],
"primary_key": [
"id"
],
"examples": [
{
"id": "commit_01jexample",
"parent_commit_ids": [],
"base_commit_id": null,
"is_checkpoint": false,
"created_at": "2026-09-09T00:00:00Z"
}
]
}