Merge pull request #949 from constructive-io/schema-update/20260401-090434

chore: update schemas from constructive-db

Author: pyramation

.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 107 tables and 55 custom operations
+description: CLI tool (csdk) for the public API — provides CRUD commands for 109 tables and 61 custom operations
 ---
 
 # cli-public
 
 <!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
 
-CLI tool (csdk) for the public API — provides CRUD commands for 107 tables and 55 custom operations
+CLI tool (csdk) for the public API — provides CRUD commands for 109 tables and 61 custom operations
 
 ## Usage
 
@@ -23,13 +23,13 @@ csdk auth set-token <token>
 csdk config set <key> <value>
 csdk config get <key>
 
-# CRUD for any table (e.g. get-all-record)
-csdk get-all-record list
-csdk get-all-record get --id <value>
-csdk get-all-record create --<field> <value>
+# CRUD for any table (e.g. org-get-managers-record)
+csdk org-get-managers-record list
+csdk org-get-managers-record get --id <value>
+csdk org-get-managers-record create --<field> <value>
 
 # Non-interactive mode (skip all prompts, use flags only)
-csdk --no-tty get-all-record list
+csdk --no-tty org-get-managers-record list
 ```
 
 ## Examples
@@ -40,13 +40,13 @@ csdk --no-tty get-all-record list
 csdk context create local --endpoint http://localhost:5000/graphql
 csdk context use local
 csdk auth set-token <token>
-csdk get-all-record list
+csdk org-get-managers-record list
 ```
 
 ### Non-interactive mode (for scripts and CI)
 
 ```bash
-csdk --no-tty get-all-record create --<field> <value>
+csdk --no-tty org-get-managers-record create --<field> <value>
 ```
 
 ## References
@@ -56,9 +56,9 @@ See the `references/` directory for detailed per-entity API documentation:
 - [context](references/context.md)
 - [auth](references/auth.md)
 - [config](references/config.md)
-- [get-all-record](references/get-all-record.md)
 - [org-get-managers-record](references/org-get-managers-record.md)
 - [org-get-subordinates-record](references/org-get-subordinates-record.md)
+- [get-all-record](references/get-all-record.md)
 - [object](references/object.md)
 - [app-permission](references/app-permission.md)
 - [org-permission](references/org-permission.md)
@@ -119,6 +119,8 @@ See the `references/` directory for detailed per-entity API documentation:
 - [users-module](references/users-module.md)
 - [blueprint](references/blueprint.md)
 - [blueprint-template](references/blueprint-template.md)
+- [blueprint-construction](references/blueprint-construction.md)
+- [storage-module](references/storage-module.md)
 - [database-provision-module](references/database-provision-module.md)
 - [app-admin-grant](references/app-admin-grant.md)
 - [app-owner-grant](references/app-owner-grant.md)
@@ -149,9 +151,9 @@ See the `references/` directory for detailed per-entity API documentation:
 - [store](references/store.md)
 - [app-permission-default](references/app-permission-default.md)
 - [role-type](references/role-type.md)
-- [migrate-file](references/migrate-file.md)
 - [app-limit-default](references/app-limit-default.md)
 - [org-limit-default](references/org-limit-default.md)
+- [migrate-file](references/migrate-file.md)
 - [membership-type](references/membership-type.md)
 - [commit](references/commit.md)
 - [app-membership-default](references/app-membership-default.md)
@@ -173,6 +175,7 @@ See the `references/` directory for detailed per-entity API documentation:
 - [org-is-manager-of](references/org-is-manager-of.md)
 - [app-permissions-get-mask](references/app-permissions-get-mask.md)
 - [org-permissions-get-mask](references/org-permissions-get-mask.md)
+- [resolve-blueprint-table](references/resolve-blueprint-table.md)
 - [app-permissions-get-mask-by-names](references/app-permissions-get-mask-by-names.md)
 - [org-permissions-get-mask-by-names](references/org-permissions-get-mask-by-names.md)
 - [get-all-objects-from-root](references/get-all-objects-from-root.md)
@@ -198,22 +201,27 @@ See the `references/` directory for detailed per-entity API documentation:
 - [construct-blueprint](references/construct-blueprint.md)
 - [reset-password](references/reset-password.md)
 - [remove-node-at-path](references/remove-node-at-path.md)
-- [set-data-at-path](references/set-data-at-path.md)
-- [set-props-and-commit](references/set-props-and-commit.md)
 - [copy-template-to-blueprint](references/copy-template-to-blueprint.md)
-- [provision-database-with-user](references/provision-database-with-user.md)
 - [bootstrap-user](references/bootstrap-user.md)
 - [set-field-order](references/set-field-order.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)
+- [set-data-at-path](references/set-data-at-path.md)
+- [set-props-and-commit](references/set-props-and-commit.md)
+- [provision-database-with-user](references/provision-database-with-user.md)
 - [insert-node-at-path](references/insert-node-at-path.md)
 - [update-node-at-path](references/update-node-at-path.md)
 - [set-and-commit](references/set-and-commit.md)
+- [provision-relation](references/provision-relation.md)
 - [apply-rls](references/apply-rls.md)
 - [sign-in-one-time-token](references/sign-in-one-time-token.md)
 - [create-user-database](references/create-user-database.md)
 - [extend-token-expires](references/extend-token-expires.md)
 - [sign-in](references/sign-in.md)
 - [sign-up](references/sign-up.md)
 - [one-time-token](references/one-time-token.md)
+- [provision-table](references/provision-table.md)
 - [send-verification-email](references/send-verification-email.md)
 - [forgot-password](references/forgot-password.md)
 - [verify-password](references/verify-password.md)

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

@@ -0,0 +1,68 @@
+# blueprintConstruction
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+CRUD operations for BlueprintConstruction records via csdk CLI
+
+## Usage
+
+```bash
+csdk blueprint-construction list
+csdk blueprint-construction list --where.<field>.<op> <value> --orderBy <values>
+csdk blueprint-construction list --limit 10 --after <cursor>
+csdk blueprint-construction find-first --where.<field>.<op> <value>
+csdk blueprint-construction get --id <UUID>
+csdk blueprint-construction create --blueprintId <UUID> --databaseId <UUID> [--schemaId <UUID>] [--status <String>] [--errorDetails <String>] [--tableMap <JSON>] [--constructedDefinition <JSON>] [--constructedAt <Datetime>]
+csdk blueprint-construction update --id <UUID> [--blueprintId <UUID>] [--databaseId <UUID>] [--schemaId <UUID>] [--status <String>] [--errorDetails <String>] [--tableMap <JSON>] [--constructedDefinition <JSON>] [--constructedAt <Datetime>]
+csdk blueprint-construction delete --id <UUID>
+```
+
+## Examples
+
+### List blueprintConstruction records
+
+```bash
+csdk blueprint-construction list
+```
+
+### List blueprintConstruction records with pagination
+
+```bash
+csdk blueprint-construction list --limit 10 --offset 0
+```
+
+### List blueprintConstruction records with cursor pagination
+
+```bash
+csdk blueprint-construction list --limit 10 --after <cursor>
+```
+
+### Find first matching blueprintConstruction
+
+```bash
+csdk blueprint-construction find-first --where.id.equalTo <value>
+```
+
+### List blueprintConstruction records with field selection
+
+```bash
+csdk blueprint-construction list --select id,id
+```
+
+### List blueprintConstruction records with filtering and ordering
+
+```bash
+csdk blueprint-construction list --where.id.equalTo <value> --orderBy ID_ASC
+```
+
+### Create a blueprintConstruction
+
+```bash
+csdk blueprint-construction create --blueprintId <UUID> --databaseId <UUID> [--schemaId <UUID>] [--status <String>] [--errorDetails <String>] [--tableMap <JSON>] [--constructedDefinition <JSON>] [--constructedAt <Datetime>]
+```
+
+### Get a blueprintConstruction by id
+
+```bash
+csdk blueprint-construction get --id <value>
+```

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

@@ -12,8 +12,8 @@ csdk blueprint list --where.<field>.<op> <value> --orderBy <values>
 csdk blueprint list --limit 10 --after <cursor>
 csdk blueprint find-first --where.<field>.<op> <value>
 csdk blueprint get --id <UUID>
-csdk blueprint create --ownerId <UUID> --databaseId <UUID> --name <String> --displayName <String> --definition <JSON> [--description <String>] [--templateId <UUID>] [--status <String>] [--constructedAt <Datetime>] [--errorDetails <String>] [--refMap <JSON>] [--constructedDefinition <JSON>] [--definitionHash <UUID>] [--tableHashes <JSON>]
-csdk blueprint update --id <UUID> [--ownerId <UUID>] [--databaseId <UUID>] [--name <String>] [--displayName <String>] [--description <String>] [--definition <JSON>] [--templateId <UUID>] [--status <String>] [--constructedAt <Datetime>] [--errorDetails <String>] [--refMap <JSON>] [--constructedDefinition <JSON>] [--definitionHash <UUID>] [--tableHashes <JSON>]
+csdk blueprint create --ownerId <UUID> --databaseId <UUID> --name <String> --displayName <String> --definition <JSON> [--description <String>] [--templateId <UUID>] [--definitionHash <UUID>] [--tableHashes <JSON>]
+csdk blueprint update --id <UUID> [--ownerId <UUID>] [--databaseId <UUID>] [--name <String>] [--displayName <String>] [--description <String>] [--definition <JSON>] [--templateId <UUID>] [--definitionHash <UUID>] [--tableHashes <JSON>]
 csdk blueprint delete --id <UUID>
 ```
 
@@ -58,7 +58,7 @@ csdk blueprint list --where.id.equalTo <value> --orderBy ID_ASC
 ### Create a blueprint
 
 ```bash
-csdk blueprint create --ownerId <UUID> --databaseId <UUID> --name <String> --displayName <String> --definition <JSON> [--description <String>] [--templateId <UUID>] [--status <String>] [--constructedAt <Datetime>] [--errorDetails <String>] [--refMap <JSON>] [--constructedDefinition <JSON>] [--definitionHash <UUID>] [--tableHashes <JSON>]
+csdk blueprint create --ownerId <UUID> --databaseId <UUID> --name <String> --displayName <String> --definition <JSON> [--description <String>] [--templateId <UUID>] [--definitionHash <UUID>] [--tableHashes <JSON>]
 ```
 
 ### Get a blueprint by id

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

@@ -2,7 +2,7 @@
 
 <!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
 
-Executes a draft blueprint definition. Four phases: (1) create tables with nodes[], fields, and policies[], (2) create relations between tables, (3) create indexes on table fields (supports BTREE, HNSW, GIN, GIST, BM25, etc.), (4) create full-text search configurations with weighted multi-field TSVector support. nodes[] entries can be strings or {$type, data} objects. Relations use $type for relation_type with junction config as top-level fields (node_type, policy_type, grant_roles, grant_privileges, policy_data, policy_permissive, source_field_name, target_field_name, node_data). Indexes reference table_ref + column name(s) and are resolved to field_ids. Full-text searches reference table_ref + tsvector field + source fields with weights/langs. Builds a ref_map of local ref names to created table UUIDs. Updates blueprint status to constructed (or failed with error_details). Returns the ref_map.
+Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Five phases: (1) provision_table() for each table with all nodes[], fields[], policies[], grants, and table-level indexes/fts/unique_constraints in a single call, (2) provision_relation() for each relation, (3) provision_index() for top-level indexes, (4) provision_full_text_search() for top-level FTS, (5) provision_unique_constraint() for top-level unique constraints. Tables are identified by table_name with optional per-table schema_name. Relations use $type for relation_type with source_table/target_table. Returns the construction record ID on success, NULL on failure.
 
 ## Usage
 

.agents/skills/cli-public/references/provision-full-text-search.md

@@ -0,0 +1,19 @@
+# provisionFullTextSearch
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+Creates a full-text search configuration on a table. Accepts a jsonb definition with field (tsvector column name) and sources (array of {field, weight, lang}). Graceful: skips if FTS config already exists for the same (table_id, field_id). Returns the fts_id.
+
+## Usage
+
+```bash
+csdk provision-full-text-search --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```
+
+## Examples
+
+### Run provisionFullTextSearch
+
+```bash
+csdk provision-full-text-search --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```

.agents/skills/cli-public/references/provision-index.md

@@ -0,0 +1,19 @@
+# provisionIndex
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+Creates an index on a table. Accepts a jsonb definition with columns (array of names or single column string), access_method (default BTREE), is_unique, op_classes, options, and name (auto-generated if omitted). Graceful: skips if an index with the same (table_id, field_ids, access_method) already exists. Returns the index_id.
+
+## Usage
+
+```bash
+csdk provision-index --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```
+
+## Examples
+
+### Run provisionIndex
+
+```bash
+csdk provision-index --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```

.agents/skills/cli-public/references/provision-relation.md

@@ -0,0 +1,19 @@
+# provisionRelation
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+Composable relation provisioning: creates FK fields, indexes, unique constraints, and junction tables depending on the relation_type. Supports RelationBelongsTo, RelationHasOne, RelationHasMany, and RelationManyToMany. ManyToMany uses provision_table() internally for junction table creation with full node/grant/policy support. All operations are graceful (skip existing). Returns (out_field_id, out_junction_table_id, out_source_field_id, out_target_field_id).
+
+## Usage
+
+```bash
+csdk provision-relation --input.clientMutationId <String> --input.databaseId <UUID> --input.relationType <String> --input.sourceTableId <UUID> --input.targetTableId <UUID> --input.fieldName <String> --input.deleteAction <String> --input.isRequired <Boolean> --input.apiRequired <Boolean> --input.createIndex <Boolean> --input.junctionTableId <UUID> --input.junctionTableName <String> --input.junctionSchemaId <UUID> --input.sourceFieldName <String> --input.targetFieldName <String> --input.useCompositeKey <Boolean> --input.exposeInApi <Boolean> --input.nodes <JSON> --input.grants <JSON> --input.grantRoles <String> --input.policies <JSON>
+```
+
+## Examples
+
+### Run provisionRelation
+
+```bash
+csdk provision-relation --input.clientMutationId <String> --input.databaseId <UUID> --input.relationType <String> --input.sourceTableId <UUID> --input.targetTableId <UUID> --input.fieldName <String> --input.deleteAction <String> --input.isRequired <Boolean> --input.apiRequired <Boolean> --input.createIndex <Boolean> --input.junctionTableId <UUID> --input.junctionTableName <String> --input.junctionSchemaId <UUID> --input.sourceFieldName <String> --input.targetFieldName <String> --input.useCompositeKey <Boolean> --input.exposeInApi <Boolean> --input.nodes <JSON> --input.grants <JSON> --input.grantRoles <String> --input.policies <JSON>
+```

.agents/skills/cli-public/references/provision-table.md

@@ -0,0 +1,19 @@
+# provisionTable
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+Composable table provisioning: creates or finds a table, then applies N nodes (Data* modules), creates fields, enables RLS, creates grants, creates N policies, and optionally creates table-level indexes/full_text_searches/unique_constraints. All operations are graceful (skip existing). Accepts multiple nodes and multiple policies per call, unlike secure_table_provision which is limited to one of each. Returns (out_table_id, out_fields).
+
+## Usage
+
+```bash
+csdk provision-table --input.clientMutationId <String> --input.databaseId <UUID> --input.schemaId <UUID> --input.tableName <String> --input.tableId <UUID> --input.nodes <JSON> --input.fields <JSON> --input.policies <JSON> --input.grants <JSON> --input.grantRoles <String> --input.useRls <Boolean> --input.indexes <JSON> --input.fullTextSearches <JSON> --input.uniqueConstraints <JSON>
+```
+
+## Examples
+
+### Run provisionTable
+
+```bash
+csdk provision-table --input.clientMutationId <String> --input.databaseId <UUID> --input.schemaId <UUID> --input.tableName <String> --input.tableId <UUID> --input.nodes <JSON> --input.fields <JSON> --input.policies <JSON> --input.grants <JSON> --input.grantRoles <String> --input.useRls <Boolean> --input.indexes <JSON> --input.fullTextSearches <JSON> --input.uniqueConstraints <JSON>
+```

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

@@ -0,0 +1,19 @@
+# provisionUniqueConstraint
+
+<!-- @constructive-io/graphql-codegen - DO NOT EDIT -->
+
+Creates a unique constraint on a table. Accepts a jsonb definition with columns (array of field names). Graceful: skips if the exact same unique constraint already exists.
+
+## Usage
+
+```bash
+csdk provision-unique-constraint --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```
+
+## Examples
+
+### Run provisionUniqueConstraint
+
+```bash
+csdk provision-unique-constraint --input.clientMutationId <String> --input.databaseId <UUID> --input.tableId <UUID> --input.definition <JSON>
+```