@lix-js/sdk 0.6.0-preview.2 → 0.6.0-preview.3

package/dist-engine-src/src/live_state/mod.rs

@@ -5,11 +5,11 @@ mod types;
 mod visibility;
 
 #[allow(unused_imports)]
-pub(crate) use context::{LiveStateContext, LiveStateStoreReader, LiveStateWriter};
+pub(crate) use context::{LiveStateContext, LiveStateStoreReader};
 #[allow(unused_imports)]
 pub(crate) use reader::LiveStateReader;
 #[allow(unused_imports)]
 pub(crate) use types::{
-    Bound, LiveStateFilter, LiveStateProjection, LiveStateRow, LiveStateRowIdentity,
-    LiveStateRowRequest, LiveStateScanRequest, ScanConstraint, ScanField, ScanOperator,
+    Bound, LiveStateFilter, LiveStateProjection, LiveStateRowIdentity, LiveStateRowRequest,
+    LiveStateScanRequest, MaterializedLiveStateRow, ScanConstraint, ScanField, ScanOperator,
 };

package/dist-engine-src/src/live_state/overlay.rs

@@ -1,6 +1,6 @@
 use std::collections::BTreeMap;
 
-use crate::live_state::{LiveStateRow, LiveStateRowIdentity};
+use crate::live_state::{LiveStateRowIdentity, MaterializedLiveStateRow};
 
 /// Applies the local untracked overlay to tracked live-state rows.
 ///
@@ -9,9 +9,9 @@ use crate::live_state::{LiveStateRow, LiveStateRowIdentity};
 /// knowing whether a visible row came from tracked changelog projection or from
 /// local untracked state.
 pub(crate) fn overlay_untracked_rows(
-    tracked_rows: Vec<LiveStateRow>,
-    untracked_rows: Vec<LiveStateRow>,
-) -> Vec<LiveStateRow> {
+    tracked_rows: Vec<MaterializedLiveStateRow>,
+    untracked_rows: Vec<MaterializedLiveStateRow>,
+) -> Vec<MaterializedLiveStateRow> {
     let mut rows_by_identity = BTreeMap::new();
 
     for row in tracked_rows {
@@ -55,14 +55,14 @@ mod tests {
         assert_eq!(rows.len(), 2);
     }
 
-    fn live_row(value: &str, untracked: bool, change_id: Option<&str>) -> LiveStateRow {
-        LiveStateRow {
+    fn live_row(value: &str, untracked: bool, change_id: Option<&str>) -> MaterializedLiveStateRow {
+        MaterializedLiveStateRow {
             entity_id: crate::entity_identity::EntityIdentity::single("entity"),
             schema_key: "schema".to_string(),
             file_id: None,
             snapshot_content: Some(format!("{{\"value\":\"{value}\"}}")),
             metadata: None,
-            schema_version: "1".to_string(),
+            deleted: false,
             created_at: "2026-01-01T00:00:00Z".to_string(),
             updated_at: "2026-01-01T00:00:00Z".to_string(),
             global: true,

package/dist-engine-src/src/live_state/reader.rs

@@ -1,12 +1,12 @@
 use async_trait::async_trait;
 
-use crate::live_state::LiveStateRow;
+use crate::live_state::MaterializedLiveStateRow;
 use crate::live_state::{LiveStateRowRequest, LiveStateScanRequest};
 use crate::LixError;
 
-/// Minimal engine2 read model for transaction planning and SQL providers.
+/// Minimal engine read model for transaction planning and SQL providers.
 ///
-/// Engine2 only needs visible state-row reads here. Changelog freshness/catch-up
+/// Engine only needs visible state-row reads here. Changelog freshness/catch-up
 /// should be added at this boundary later instead of leaking projection internals
 /// into sessions or SQL providers.
 #[async_trait]
@@ -14,10 +14,10 @@ pub(crate) trait LiveStateReader: Send + Sync {
     async fn scan_rows(
         &self,
         request: &LiveStateScanRequest,
-    ) -> Result<Vec<LiveStateRow>, LixError>;
+    ) -> Result<Vec<MaterializedLiveStateRow>, LixError>;
 
     async fn load_row(
         &self,
         request: &LiveStateRowRequest,
-    ) -> Result<Option<LiveStateRow>, LixError>;
+    ) -> Result<Option<MaterializedLiveStateRow>, LixError>;
 }

package/dist-engine-src/src/live_state/types.rs

@@ -1,23 +1,22 @@
-use crate::changelog::MaterializedCanonicalChange;
 use crate::entity_identity::EntityIdentity;
-use crate::tracked_state::TrackedStateRow;
+use crate::tracked_state::MaterializedTrackedStateRow;
 use crate::untracked_state::{
     MaterializedUntrackedStateRow, UntrackedStateFilter, UntrackedStateRowRequest,
 };
-use crate::{NullableKeyFilter, RowMetadata, Value};
+use crate::{NullableKeyFilter, Value};
 
 /// Durable row visible through live_state reads.
 ///
 /// Unlike provider write rows, live-state rows are fully hydrated facts. Missing
 /// generated fields should be caught before this type is constructed.
 #[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
-pub(crate) struct LiveStateRow {
+pub(crate) struct MaterializedLiveStateRow {
     pub(crate) entity_id: EntityIdentity,
     pub(crate) schema_key: String,
     pub(crate) file_id: Option<String>,
     pub(crate) snapshot_content: Option<String>,
-    pub(crate) metadata: Option<RowMetadata>,
-    pub(crate) schema_version: String,
+    pub(crate) metadata: Option<String>,
+    pub(crate) deleted: bool,
     pub(crate) created_at: String,
     pub(crate) updated_at: String,
     pub(crate) global: bool,
@@ -27,32 +26,15 @@ pub(crate) struct LiveStateRow {
     pub(crate) version_id: String,
 }
 
-impl From<LiveStateRow> for MaterializedCanonicalChange {
-    fn from(row: LiveStateRow) -> Self {
-        MaterializedCanonicalChange {
-            id: row
-                .change_id
-                .expect("tracked live-state rows must carry change_id"),
-            entity_id: row.entity_id,
-            schema_key: row.schema_key,
-            schema_version: row.schema_version,
-            file_id: row.file_id,
-            snapshot_content: row.snapshot_content,
-            metadata: row.metadata,
-            created_at: row.created_at,
-        }
-    }
-}
-
-impl From<MaterializedUntrackedStateRow> for LiveStateRow {
+impl From<MaterializedUntrackedStateRow> for MaterializedLiveStateRow {
     fn from(row: MaterializedUntrackedStateRow) -> Self {
-        LiveStateRow {
+        MaterializedLiveStateRow {
             entity_id: row.entity_id,
             schema_key: row.schema_key,
             file_id: row.file_id,
             snapshot_content: row.snapshot_content,
             metadata: row.metadata,
-            schema_version: row.schema_version,
+            deleted: row.deleted,
             created_at: row.created_at,
             updated_at: row.updated_at,
             global: row.global,
@@ -64,10 +46,10 @@ impl From<MaterializedUntrackedStateRow> for LiveStateRow {
     }
 }
 
-impl TryFrom<&LiveStateRow> for TrackedStateRow {
+impl TryFrom<&MaterializedLiveStateRow> for MaterializedTrackedStateRow {
     type Error = crate::LixError;
 
-    fn try_from(row: &LiveStateRow) -> Result<Self, Self::Error> {
+    fn try_from(row: &MaterializedLiveStateRow) -> Result<Self, Self::Error> {
         if row.untracked {
             return Err(crate::LixError::new(
                 "LIX_ERROR_UNKNOWN",
@@ -87,13 +69,13 @@ impl TryFrom<&LiveStateRow> for TrackedStateRow {
             ));
         };
 
-        Ok(TrackedStateRow {
+        Ok(MaterializedTrackedStateRow {
             entity_id: row.entity_id.clone(),
             schema_key: row.schema_key.clone(),
             file_id: row.file_id.clone(),
             snapshot_content: row.snapshot_content.clone(),
             metadata: row.metadata.clone(),
-            schema_version: row.schema_version.clone(),
+            deleted: row.deleted,
             created_at: row.created_at.clone(),
             updated_at: row.updated_at.clone(),
             change_id,
@@ -102,15 +84,15 @@ impl TryFrom<&LiveStateRow> for TrackedStateRow {
     }
 }
 
-impl From<&LiveStateRow> for MaterializedUntrackedStateRow {
-    fn from(row: &LiveStateRow) -> Self {
+impl From<&MaterializedLiveStateRow> for MaterializedUntrackedStateRow {
+    fn from(row: &MaterializedLiveStateRow) -> Self {
         MaterializedUntrackedStateRow {
             entity_id: row.entity_id.clone(),
             schema_key: row.schema_key.clone(),
             file_id: row.file_id.clone(),
             snapshot_content: row.snapshot_content.clone(),
             metadata: row.metadata.clone(),
-            schema_version: row.schema_version.clone(),
+            deleted: row.deleted,
             created_at: row.created_at.clone(),
             updated_at: row.updated_at.clone(),
             global: row.global,
@@ -124,7 +106,6 @@ impl From<&LiveStateRow> for MaterializedUntrackedStateRow {
 pub(crate) enum ScanField {
     EntityId,
     FileId,
-    SchemaVersion,
 }
 
 /// Inclusive or exclusive range bound.
@@ -164,6 +145,8 @@ pub(crate) struct LiveStateFilter {
     #[serde(default)]
     pub(crate) file_ids: Vec<NullableKeyFilter<String>>,
     #[serde(default)]
+    pub(crate) untracked: Option<bool>,
+    #[serde(default)]
     pub(crate) constraints: Vec<ScanConstraint>,
     #[serde(default)]
     pub(crate) include_tombstones: bool,
@@ -187,7 +170,7 @@ pub(crate) struct LiveStateProjection {
     pub(crate) columns: Vec<String>,
 }
 
-/// First-principles scan request for engine2-owned reads.
+/// First-principles scan request for engine-owned reads.
 #[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize, Default)]
 pub(crate) struct LiveStateScanRequest {
     #[serde(default)]
@@ -228,7 +211,7 @@ pub(crate) struct LiveStateRowIdentity {
 }
 
 impl LiveStateRowIdentity {
-    pub(crate) fn from_row(row: &LiveStateRow) -> Self {
+    pub(crate) fn from_row(row: &MaterializedLiveStateRow) -> Self {
         Self {
             version_id: row.version_id.clone(),
             schema_key: row.schema_key.clone(),

package/dist-engine-src/src/live_state/visibility.rs

@@ -1,6 +1,6 @@
 use std::collections::BTreeMap;
 
-use crate::live_state::{LiveStateRow, LiveStateRowIdentity};
+use crate::live_state::{LiveStateRowIdentity, MaterializedLiveStateRow};
 use crate::GLOBAL_VERSION_ID;
 
 /// Expands a version-scoped storage read so global candidates are available for
@@ -32,13 +32,13 @@ pub(crate) fn expanded_version_ids(version_ids: &[String]) -> Vec<String> {
 /// validation remains exact storage-scope local unless a validator explicitly
 /// opts into overlay semantics.
 pub(crate) fn resolve_scan_rows(
-    rows: Vec<LiveStateRow>,
+    rows: Vec<MaterializedLiveStateRow>,
     requested_version_ids: &[String],
     include_tombstones: bool,
-) -> Vec<LiveStateRow> {
+) -> Vec<MaterializedLiveStateRow> {
     let mut rows = project_global_rows_into_requested_versions(rows, requested_version_ids);
     if !include_tombstones {
-        rows.retain(|row| row.snapshot_content.is_some());
+        rows.retain(|row| !row.deleted);
     }
     rows
 }
@@ -46,10 +46,10 @@ pub(crate) fn resolve_scan_rows(
 /// Resolves a row loaded through a concrete storage version into the row visible
 /// to the requested version scope.
 pub(crate) fn project_loaded_row(
-    mut row: LiveStateRow,
+    mut row: MaterializedLiveStateRow,
     requested_version_id: &str,
     matched_version_id: &str,
-) -> LiveStateRow {
+) -> MaterializedLiveStateRow {
     if row.global && requested_version_id != GLOBAL_VERSION_ID {
         row.version_id = requested_version_id.to_string();
     } else if matched_version_id == GLOBAL_VERSION_ID && requested_version_id != GLOBAL_VERSION_ID {
@@ -59,14 +59,14 @@ pub(crate) fn project_loaded_row(
 }
 
 fn project_global_rows_into_requested_versions(
-    rows: Vec<LiveStateRow>,
+    rows: Vec<MaterializedLiveStateRow>,
     requested_version_ids: &[String],
-) -> Vec<LiveStateRow> {
+) -> Vec<MaterializedLiveStateRow> {
     if requested_version_ids.is_empty() {
         return rows;
     }
 
-    let mut rows_by_identity = BTreeMap::<LiveStateRowIdentity, LiveStateRow>::new();
+    let mut rows_by_identity = BTreeMap::<LiveStateRowIdentity, MaterializedLiveStateRow>::new();
     for requested_version_id in requested_version_ids {
         for row in &rows {
             if row.version_id == GLOBAL_VERSION_ID {
@@ -191,14 +191,14 @@ mod tests {
         value: &str,
         global: bool,
         change_id: Option<&str>,
-    ) -> LiveStateRow {
-        LiveStateRow {
+    ) -> MaterializedLiveStateRow {
+        MaterializedLiveStateRow {
             entity_id: crate::entity_identity::EntityIdentity::single("entity"),
             schema_key: "schema".to_string(),
             file_id: None,
             snapshot_content: Some(format!("{{\"value\":\"{value}\"}}")),
             metadata: None,
-            schema_version: "1".to_string(),
+            deleted: false,
             created_at: "2026-01-01T00:00:00Z".to_string(),
             updated_at: "2026-01-01T00:00:00Z".to_string(),
             global,
@@ -209,9 +209,14 @@ mod tests {
         }
     }
 
-    fn tombstone_at(version_id: &str, global: bool, change_id: Option<&str>) -> LiveStateRow {
-        LiveStateRow {
+    fn tombstone_at(
+        version_id: &str,
+        global: bool,
+        change_id: Option<&str>,
+    ) -> MaterializedLiveStateRow {
+        MaterializedLiveStateRow {
             snapshot_content: None,
+            deleted: true,
             ..row_at(version_id, "ignored", global, change_id)
         }
     }

package/dist-engine-src/src/plugin/archive.rs

@@ -71,15 +71,12 @@ pub(crate) fn parse_plugin_archive_for_install(
             })?;
         validate_lix_schema_definition(&schema_json)?;
         let schema_key = schema_key_from_definition(&schema_json)?;
-        if !seen_schema_keys.insert((
-            schema_key.schema_key.clone(),
-            schema_key.schema_version.clone(),
-        )) {
+        if !seen_schema_keys.insert(schema_key.schema_key.clone()) {
             return Err(LixError {
                 code: "LIX_ERROR_UNKNOWN".to_string(),
                 message: format!(
-                    "Plugin archive declares duplicate schema '{}~{}'",
-                    schema_key.schema_key, schema_key.schema_version
+                    "Plugin archive declares duplicate schema '{}'",
+                    schema_key.schema_key
                 ),
                 hint: None,
             details: None,

package/dist-engine-src/src/plugin/install.rs

@@ -37,11 +37,8 @@ use crate::{LixError, Value};
 
 use crate::transaction::WriteCommand;
 const REGISTERED_SCHEMA_STORAGE_SCHEMA_KEY: &str = "lix_registered_schema";
-const REGISTERED_SCHEMA_STORAGE_SCHEMA_VERSION: &str = "1";
 const FILESYSTEM_DESCRIPTOR_SCHEMA_KEY: &str = "lix_file_descriptor";
-const FILESYSTEM_DESCRIPTOR_SCHEMA_VERSION: &str = "1";
 const FILESYSTEM_BINARY_BLOB_REF_SCHEMA_KEY: &str = "lix_binary_blob_ref";
-const FILESYSTEM_BINARY_BLOB_REF_SCHEMA_VERSION: &str = "1";
 
 #[derive(Clone)]
 pub(crate) struct PluginInstallWriteContext {
@@ -170,7 +167,6 @@ fn prepare_registered_schema_write_statement_from_schemas(
         .map(|row| PublicChange {
             entity_id: row.entity_id.clone(),
             schema_key: REGISTERED_SCHEMA_STORAGE_SCHEMA_KEY.to_string(),
-            schema_version: Some(REGISTERED_SCHEMA_STORAGE_SCHEMA_VERSION.to_string()),
             file_id: None,
             plugin_key: None,
             snapshot_content: Some(row.snapshot.to_string()),
@@ -289,10 +285,6 @@ fn registered_schema_planned_row(
     );
     values.insert("file_id".to_string(), Value::Null);
     values.insert("plugin_key".to_string(), Value::Null);
-    values.insert(
-        "schema_version".to_string(),
-        Value::Text(REGISTERED_SCHEMA_STORAGE_SCHEMA_VERSION.to_string()),
-    );
     values.insert(
         "snapshot_content".to_string(),
         Value::Json(row.snapshot.clone()),
@@ -331,10 +323,6 @@ fn plugin_archive_file_descriptor_row(
     );
     values.insert("file_id".to_string(), Value::Null);
     values.insert("plugin_key".to_string(), Value::Null);
-    values.insert(
-        "schema_version".to_string(),
-        Value::Text(FILESYSTEM_DESCRIPTOR_SCHEMA_VERSION.to_string()),
-    );
     values.insert(
         "snapshot_content".to_string(),
         Value::Text(snapshot_content),
@@ -381,10 +369,6 @@ fn plugin_archive_binary_blob_ref_row(
     );
     values.insert("file_id".to_string(), Value::Text(archive_id.to_string()));
     values.insert("plugin_key".to_string(), Value::Null);
-    values.insert(
-        "schema_version".to_string(),
-        Value::Text(FILESYSTEM_BINARY_BLOB_REF_SCHEMA_VERSION.to_string()),
-    );
     values.insert(
         "snapshot_content".to_string(),
         Value::Text(snapshot_content),
@@ -506,7 +490,6 @@ fn planned_row_to_public_change(row: &PlannedStateRow) -> Result<PublicChange, L
     Ok(PublicChange {
         entity_id: row.entity_id.clone(),
         schema_key: row.schema_key.clone(),
-        schema_version: planned_row_text_value(row, "schema_version"),
         file_id: planned_row_text_value(row, "file_id"),
         plugin_key: planned_row_text_value(row, "plugin_key"),
         snapshot_content: if row.tombstone {
@@ -569,7 +552,6 @@ fn summarize_change(change: &PublicChange) -> JsonValue {
     json!({
         "entity_id": change.entity_id,
         "schema_key": change.schema_key,
-        "schema_version": change.schema_version,
         "file_id": change.file_id,
         "plugin_key": change.plugin_key,
         "version_id": change.version_id,

package/dist-engine-src/src/plugin/plugin_manifest.json

@@ -62,7 +62,6 @@
                 "enum": [
                   "entity_id",
                   "schema_key",
-                  "schema_version",
                   "snapshot_content",
                   "file_id",
                   "plugin_key",

package/dist-engine-src/src/schema/annotations/defaults.rs

@@ -9,7 +9,6 @@ pub(crate) fn apply_schema_defaults<P>(
     evaluator: &CelEvaluator,
     functions: P,
     schema_key: &str,
-    schema_version: &str,
 ) -> Result<bool, LixError>
 where
     P: CelFunctionProvider,
@@ -21,7 +20,6 @@ where
         evaluator,
         functions,
         schema_key,
-        schema_version,
     )
 }
 
@@ -30,7 +28,6 @@ pub(crate) fn apply_schema_defaults_with_shared_runtime<P>(
     schema: &JsonValue,
     functions: P,
     schema_key: &str,
-    schema_version: &str,
 ) -> Result<bool, LixError>
 where
     P: CelFunctionProvider,
@@ -41,7 +38,6 @@ where
         crate::cel::shared_runtime(),
         functions,
         schema_key,
-        schema_version,
     )
 }
 
@@ -52,7 +48,6 @@ pub(crate) fn apply_schema_defaults_with_context<P>(
     evaluator: &CelEvaluator,
     functions: P,
     schema_key: &str,
-    schema_version: &str,
 ) -> Result<bool, LixError>
 where
     P: CelFunctionProvider,
@@ -78,8 +73,8 @@ where
                 .map_err(|err| LixError {
                     code: "LIX_ERROR_UNKNOWN".to_string(),
                     message: format!(
-                        "failed to evaluate x-lix-default for '{}.{}' ({}): {}",
-                        schema_key, field_name, schema_version, err.message
+                        "failed to evaluate x-lix-default for '{}.{}': {}",
+                        schema_key, field_name, err.message
                     ),
                     hint: None,
                     details: None,

package/dist-engine-src/src/schema/builtin/lix_account.json

@@ -1,6 +1,5 @@
 {
   "x-lix-key": "lix_account",
-  "x-lix-version": "1",
   "x-lix-primary-key": [
     "/id"
   ],

package/dist-engine-src/src/schema/builtin/lix_active_account.json

@@ -1,6 +1,5 @@
 {
   "x-lix-key": "lix_active_account",
-  "x-lix-version": "1",
   "x-lix-primary-key": [
     "/account_id"
   ],

package/dist-engine-src/src/schema/builtin/lix_binary_blob_ref.json

@@ -1,6 +1,5 @@
 {
   "x-lix-key": "lix_binary_blob_ref",
-  "x-lix-version": "1",
   "description": "Metadata pointer from a file version to its binary payload in internal CAS storage.",
   "x-lix-primary-key": [
     "/id"

package/dist-engine-src/src/schema/builtin/lix_change.json

@@ -1,7 +1,6 @@
 {
   "x-lix-key": "lix_change",
-  "x-lix-version": "1",
-  "description": "Canonical immutable change fact. This surface represents the authoritative stream of journaled change facts. Commit lineage and non-commit scope are modeled separately around these facts.",
+  "description": "A change records one edit to a Lix entity, including what changed, when it changed, and which entity was affected.",
   "x-lix-primary-key": [
     "/id"
   ],
@@ -10,20 +9,20 @@
     "id": {
       "type": "string",
       "x-lix-default": "lix_uuid_v7()",
-      "description": "Stable change identifier (UUIDv7). Referenced from `lix_commit.change_ids` and `lix_change_set_element.change_id`."
+      "description": "Stable identifier for this change."
     },
     "entity_id": {
-      "type": "string",
-      "description": "The entity this change applies to, scoped by (`schema_key`, `file_id`)."
+      "type": "array",
+      "description": "Canonical JSON primary-key tuple for the entity this change applies to, scoped by (`schema_key`, `file_id`). Values are ordered according to the target schema's `x-lix-primary-key`.",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
     },
     "schema_key": {
       "type": "string",
       "description": "Schema identifier of the entity (e.g. `lix_file_descriptor`, `lix_commit`, or a user-registered key)."
     },
-    "schema_version": {
-      "type": "string",
-      "description": "Schema version the snapshot_content was written against (matches `x-lix-version` on the schema at write time)."
-    },
     "file_id": {
       "type": [
         "string",
@@ -40,6 +39,9 @@
     },
     "created_at": {
       "type": "string",
+      "examples": [
+        "2026-05-08T17:42:31.123Z"
+      ],
       "description": "ISO-8601 timestamp at which the change was recorded (set via `lix_timestamp()` at write time)."
     },
     "snapshot_content": {
@@ -54,7 +56,6 @@
     "id",
     "entity_id",
     "schema_key",
-    "schema_version",
     "file_id",
     "created_at"
   ],

package/dist-engine-src/src/schema/builtin/lix_change_author.json

@@ -1,6 +1,5 @@
 {
   "x-lix-key": "lix_change_author",
-  "x-lix-version": "1",
   "x-lix-primary-key": [
     "/change_id",
     "/account_id"

package/dist-engine-src/src/schema/builtin/lix_commit.json

@@ -1,62 +1,24 @@
 {
   "x-lix-key": "lix_commit",
-  "x-lix-version": "1",
-  "description": "Commit header change. Canonical commit membership is stored in change_ids as the ordered list of canonical changes whose effects this commit introduces relative to its first parent. A merge commit may reference canonical changes originally authored in another parent instead of copying them. Derived projections such as lix_change_set_element must be rebuildable from this header plus the referenced change rows. Version head pointers such as lix_version_ref are maintained separately and are not commit members.",
-  "x-lix-primary-key": [
-    "/id"
-  ],
-  "x-lix-foreign-keys": [
+  "description": "A commit is a stable point in project history. Versions point to commits. Use lix_commit_edge to inspect parent commits.",
+  "examples": [
     {
-      "properties": [
-        "/change_set_id"
-      ],
-      "references": {
-        "schemaKey": "lix_change_set",
-        "properties": [
-          "/id"
-        ]
-      }
+      "id": "commit_01jexample"
     }
   ],
+  "x-lix-primary-key": [
+    "/id"
+  ],
   "type": "object",
   "properties": {
     "id": {
       "type": "string",
       "x-lix-default": "lix_uuid_v7()",
-      "description": "Stable commit identifier."
-    },
-    "change_set_id": {
-      "type": "string",
-      "description": "Commit-local grouping identifier used by derived relational indexes and projections such as lix_change_set_element."
-    },
-    "change_ids": {
-      "type": "array",
-      "default": [],
-      "items": {
-        "type": "string"
-      },
-      "description": "Canonical ordered membership list of non-header change IDs whose effects this commit introduces relative to its first parent. Merge commits may reference existing changes from another parent instead of minting equivalent copies. Derived indexes such as lix_change_set_element must be rebuildable from this list. This does not include lix_version_ref pointer rows."
-    },
-    "author_account_ids": {
-      "type": "array",
-      "default": [],
-      "items": {
-        "type": "string"
-      },
-      "description": "Ordered set of author account IDs associated with this commit."
-    },
-    "parent_commit_ids": {
-      "type": "array",
-      "default": [],
-      "items": {
-        "type": "string"
-      },
-      "description": "Parent commit IDs for commit graph topology."
+      "description": "Stable identifier of this commit."
     }
   },
   "required": [
-    "id",
-    "change_set_id"
+    "id"
   ],
   "additionalProperties": false
 }