chore: update schemas from constructive-db

.agents/skills/cli-public/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: cli-public
-description: CLI tool (csdk) for the public API — provides CRUD commands for 149 tables and 70 custom operations
+description: CLI tool (csdk) for the public API — provides CRUD commands for 149 tables and 71 custom operations
 ---
 
 # cli-public
 
 <!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
 
-CLI tool (csdk) for the public API — provides CRUD commands for 149 tables and 70 custom operations
+CLI tool (csdk) for the public API — provides CRUD commands for 149 tables and 71 custom operations
 
 ## Usage
 
@@ -253,6 +253,7 @@ See the `references/` directory for detailed per-entity API documentation:
 - [provision-spatial-relation](references/provision-spatial-relation.md)
 - [bootstrap-user](references/bootstrap-user.md)
 - [set-field-order](references/set-field-order.md)
+- [provision-check-constraint](references/provision-check-constraint.md)
 - [provision-unique-constraint](references/provision-unique-constraint.md)
 - [provision-full-text-search](references/provision-full-text-search.md)
 - [provision-index](references/provision-index.md)

.agents/skills/cli-public/references/api-setting.md

@@ -12,8 +12,8 @@ csdk api-setting list --where.<field>.<op> <value> --orderBy <values>
 csdk api-setting list --limit 10 --after <cursor>
 csdk api-setting find-first --where.<field>.<op> <value>
 csdk api-setting get --id <UUID>
-csdk api-setting create --databaseId <UUID> --apiId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--options <JSON>]
-csdk api-setting update --id <UUID> [--databaseId <UUID>] [--apiId <UUID>] [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--options <JSON>]
+csdk api-setting create --databaseId <UUID> --apiId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--enableRealtime <Boolean>] [--options <JSON>]
+csdk api-setting update --id <UUID> [--databaseId <UUID>] [--apiId <UUID>] [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--enableRealtime <Boolean>] [--options <JSON>]
 csdk api-setting delete --id <UUID>
 ```
 
@@ -58,7 +58,7 @@ csdk api-setting list --where.id.equalTo <value> --orderBy ID_ASC
 ### Create a apiSetting
 
 ```bash
-csdk api-setting create --databaseId <UUID> --apiId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--options <JSON>]
+csdk api-setting create --databaseId <UUID> --apiId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--enableRealtime <Boolean>] [--options <JSON>]
 ```
 
 ### Get a apiSetting by id

.agents/skills/cli-public/references/construct-blueprint.md

@@ -2,7 +2,7 @@
 
 <!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
 
-Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Six phases: (0) entity_type_provision for each membership_type entry — provisions entity tables, membership modules, and security, (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints are deferred), (2) provision_relation() for each relation, (3) provision_index() for top-level + deferred indexes, (4) provision_full_text_search() for top-level + deferred FTS, (5) provision_unique_constraint() for top-level + deferred unique constraints. Phase 0 entity tables are added to the table_map so subsequent phases can reference them by name. Table-level indexes/fts/unique_constraints are deferred to phases 3-5 so they can reference columns created by relations in phase 2. Returns the construction record ID on success, NULL on failure.
+Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Seven phases: (0) entity_type_provision for each membership_type entry — provisions entity tables, membership modules, and security, (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred), (2) provision_relation() for each relation, (3) provision_index() for top-level + deferred indexes, (4) provision_full_text_search() for top-level + deferred FTS, (5) provision_unique_constraint() for top-level + deferred unique constraints, (6) provision_check_constraint() for top-level + deferred check constraints. Phase 0 entity tables are added to the table_map so subsequent phases can reference them by name. Table-level entries are deferred to phases 3-6 so they can reference columns created by relations in phase 2. Returns the construction record ID on success, NULL on failure.
 
 ## Usage
 

.agents/skills/cli-public/references/database-setting.md

@@ -12,8 +12,8 @@ csdk database-setting list --where.<field>.<op> <value> --orderBy <values>
 csdk database-setting list --limit 10 --after <cursor>
 csdk database-setting find-first --where.<field>.<op> <value>
 csdk database-setting get --id <UUID>
-csdk database-setting create --databaseId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--options <JSON>]
-csdk database-setting update --id <UUID> [--databaseId <UUID>] [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--options <JSON>]
+csdk database-setting create --databaseId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--enableRealtime <Boolean>] [--options <JSON>]
+csdk database-setting update --id <UUID> [--databaseId <UUID>] [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--enableRealtime <Boolean>] [--options <JSON>]
 csdk database-setting delete --id <UUID>
 ```
 
@@ -58,7 +58,7 @@ csdk database-setting list --where.id.equalTo <value> --orderBy ID_ASC
 ### Create a databaseSetting
 
 ```bash
-csdk database-setting create --databaseId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--options <JSON>]
+csdk database-setting create --databaseId <UUID> [--enableAggregates <Boolean>] [--enablePostgis <Boolean>] [--enableSearch <Boolean>] [--enableDirectUploads <Boolean>] [--enablePresignedUploads <Boolean>] [--enableManyToMany <Boolean>] [--enableConnectionFilter <Boolean>] [--enableLtree <Boolean>] [--enableLlm <Boolean>] [--enableRealtime <Boolean>] [--options <JSON>]
 ```
 
 ### Get a databaseSetting by id

.agents/skills/cli-public/references/provision-check-constraint.md

@@ -0,0 +1,19 @@
+# provisionCheckConstraint
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+Creates a check constraint on a table from a $type + data blueprint definition. Supports: CheckOneOf (enum validation via = ANY(ARRAY[...])), CheckGreaterThan (single-column > value or cross-column), CheckLessThan (single-column < value or cross-column), CheckNotEqual (cross-column inequality). Builds AST expressions via ast_helpers and inserts into metaschema_public.check_constraint. Graceful: skips if a constraint with the same name already exists.
+
+## Usage
+
+```bash
+csdk provision-check-constraint --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```
+
+## Examples
+
+### Run provisionCheckConstraint
+
+```bash
+csdk provision-check-constraint --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```

.agents/skills/hooks-public/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: hooks-public
-description: React Query hooks for the public API — provides typed query and mutation hooks for 149 tables and 70 custom operations
+description: React Query hooks for the public API — provides typed query and mutation hooks for 149 tables and 71 custom operations
 ---
 
 # hooks-public
 
 <!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
 
-React Query hooks for the public API — provides typed query and mutation hooks for 149 tables and 70 custom operations
+React Query hooks for the public API — provides typed query and mutation hooks for 149 tables and 71 custom operations
 
 ## Usage
 
@@ -234,6 +234,7 @@ See the `references/` directory for detailed per-entity API documentation:
 - [provision-spatial-relation](references/provision-spatial-relation.md)
 - [bootstrap-user](references/bootstrap-user.md)
 - [set-field-order](references/set-field-order.md)
+- [provision-check-constraint](references/provision-check-constraint.md)
 - [provision-unique-constraint](references/provision-unique-constraint.md)
 - [provision-full-text-search](references/provision-full-text-search.md)
 - [provision-index](references/provision-index.md)

.agents/skills/hooks-public/references/api-setting.md

@@ -7,8 +7,8 @@ Per-API feature flag overrides; NULL columns inherit from database_settings, exp
 ## Usage
 
 ```typescript
-useApiSettingsQuery({ selection: { fields: { id: true, databaseId: true, apiId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, options: true } } })
-useApiSettingQuery({ id: '<UUID>', selection: { fields: { id: true, databaseId: true, apiId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, options: true } } })
+useApiSettingsQuery({ selection: { fields: { id: true, databaseId: true, apiId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, enableRealtime: true, options: true } } })
+useApiSettingQuery({ id: '<UUID>', selection: { fields: { id: true, databaseId: true, apiId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, enableRealtime: true, options: true } } })
 useCreateApiSettingMutation({ selection: { fields: { id: true } } })
 useUpdateApiSettingMutation({ selection: { fields: { id: true } } })
 useDeleteApiSettingMutation({})
@@ -20,7 +20,7 @@ useDeleteApiSettingMutation({})
 
 ```typescript
 const { data, isLoading } = useApiSettingsQuery({
-  selection: { fields: { id: true, databaseId: true, apiId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, options: true } },
+  selection: { fields: { id: true, databaseId: true, apiId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, enableRealtime: true, options: true } },
 });
 ```
 
@@ -30,5 +30,5 @@ const { data, isLoading } = useApiSettingsQuery({
 const { mutate } = useCreateApiSettingMutation({
   selection: { fields: { id: true } },
 });
-mutate({ databaseId: '<UUID>', apiId: '<UUID>', enableAggregates: '<Boolean>', enablePostgis: '<Boolean>', enableSearch: '<Boolean>', enableDirectUploads: '<Boolean>', enablePresignedUploads: '<Boolean>', enableManyToMany: '<Boolean>', enableConnectionFilter: '<Boolean>', enableLtree: '<Boolean>', enableLlm: '<Boolean>', options: '<JSON>' });
+mutate({ databaseId: '<UUID>', apiId: '<UUID>', enableAggregates: '<Boolean>', enablePostgis: '<Boolean>', enableSearch: '<Boolean>', enableDirectUploads: '<Boolean>', enablePresignedUploads: '<Boolean>', enableManyToMany: '<Boolean>', enableConnectionFilter: '<Boolean>', enableLtree: '<Boolean>', enableLlm: '<Boolean>', enableRealtime: '<Boolean>', options: '<JSON>' });
 ```

.agents/skills/hooks-public/references/construct-blueprint.md

@@ -2,7 +2,7 @@
 
 <!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
 
-Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Six phases: (0) entity_type_provision for each membership_type entry — provisions entity tables, membership modules, and security, (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints are deferred), (2) provision_relation() for each relation, (3) provision_index() for top-level + deferred indexes, (4) provision_full_text_search() for top-level + deferred FTS, (5) provision_unique_constraint() for top-level + deferred unique constraints. Phase 0 entity tables are added to the table_map so subsequent phases can reference them by name. Table-level indexes/fts/unique_constraints are deferred to phases 3-5 so they can reference columns created by relations in phase 2. Returns the construction record ID on success, NULL on failure.
+Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Seven phases: (0) entity_type_provision for each membership_type entry — provisions entity tables, membership modules, and security, (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred), (2) provision_relation() for each relation, (3) provision_index() for top-level + deferred indexes, (4) provision_full_text_search() for top-level + deferred FTS, (5) provision_unique_constraint() for top-level + deferred unique constraints, (6) provision_check_constraint() for top-level + deferred check constraints. Phase 0 entity tables are added to the table_map so subsequent phases can reference them by name. Table-level entries are deferred to phases 3-6 so they can reference columns created by relations in phase 2. Returns the construction record ID on success, NULL on failure.
 
 ## Usage
 

.agents/skills/hooks-public/references/database-setting.md

@@ -7,8 +7,8 @@ Database-wide feature flags and settings; controls which platform features are a
 ## Usage
 
 ```typescript
-useDatabaseSettingsQuery({ selection: { fields: { id: true, databaseId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, options: true } } })
-useDatabaseSettingQuery({ id: '<UUID>', selection: { fields: { id: true, databaseId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, options: true } } })
+useDatabaseSettingsQuery({ selection: { fields: { id: true, databaseId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, enableRealtime: true, options: true } } })
+useDatabaseSettingQuery({ id: '<UUID>', selection: { fields: { id: true, databaseId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, enableRealtime: true, options: true } } })
 useCreateDatabaseSettingMutation({ selection: { fields: { id: true } } })
 useUpdateDatabaseSettingMutation({ selection: { fields: { id: true } } })
 useDeleteDatabaseSettingMutation({})
@@ -20,7 +20,7 @@ useDeleteDatabaseSettingMutation({})
 
 ```typescript
 const { data, isLoading } = useDatabaseSettingsQuery({
-  selection: { fields: { id: true, databaseId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, options: true } },
+  selection: { fields: { id: true, databaseId: true, enableAggregates: true, enablePostgis: true, enableSearch: true, enableDirectUploads: true, enablePresignedUploads: true, enableManyToMany: true, enableConnectionFilter: true, enableLtree: true, enableLlm: true, enableRealtime: true, options: true } },
 });
 ```
 
@@ -30,5 +30,5 @@ const { data, isLoading } = useDatabaseSettingsQuery({
 const { mutate } = useCreateDatabaseSettingMutation({
   selection: { fields: { id: true } },
 });
-mutate({ databaseId: '<UUID>', enableAggregates: '<Boolean>', enablePostgis: '<Boolean>', enableSearch: '<Boolean>', enableDirectUploads: '<Boolean>', enablePresignedUploads: '<Boolean>', enableManyToMany: '<Boolean>', enableConnectionFilter: '<Boolean>', enableLtree: '<Boolean>', enableLlm: '<Boolean>', options: '<JSON>' });
+mutate({ databaseId: '<UUID>', enableAggregates: '<Boolean>', enablePostgis: '<Boolean>', enableSearch: '<Boolean>', enableDirectUploads: '<Boolean>', enablePresignedUploads: '<Boolean>', enableManyToMany: '<Boolean>', enableConnectionFilter: '<Boolean>', enableLtree: '<Boolean>', enableLlm: '<Boolean>', enableRealtime: '<Boolean>', options: '<JSON>' });
 ```

.agents/skills/hooks-public/references/provision-check-constraint.md

@@ -0,0 +1,20 @@
+# provisionCheckConstraint
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+Creates a check constraint on a table from a $type + data blueprint definition. Supports: CheckOneOf (enum validation via = ANY(ARRAY[...])), CheckGreaterThan (single-column > value or cross-column), CheckLessThan (single-column < value or cross-column), CheckNotEqual (cross-column inequality). Builds AST expressions via ast_helpers and inserts into metaschema_public.check_constraint. Graceful: skips if a constraint with the same name already exists.
+
+## Usage
+
+```typescript
+const { mutate } = useProvisionCheckConstraintMutation(); mutate({ input: { databaseId: '<UUID>', tableId: '<UUID>', definition: '<JSON>' } });
+```
+
+## Examples
+
+### Use useProvisionCheckConstraintMutation
+
+```typescript
+const { mutate, isLoading } = useProvisionCheckConstraintMutation();
+mutate({ input: { databaseId: '<UUID>', tableId: '<UUID>', definition: '<JSON>' } });
+```