@constructive-sdk/cli 1.21.4 → 1.21.6

package/infra/orm/input-types.d.ts

@@ -1502,19 +1502,19 @@ export type PlatformInfraSetManyAndCommitPayloadSelect = {
     };
 };
 export interface ProvisionBucketPayload {
-    /** The logical bucket row that was queued for reconciliation. */
+    /** The logical bucket row whose reconciliation was requested. */
     bucketId: string;
     bucketKey: string;
-    /** The reconciler job enqueued to provision this bucket. */
-    jobId: string;
     /** The physical bucket name already recorded, or null when reconciliation has not completed. */
     physicalName?: string | null;
+    /** When reconciliation was last requested for this bucket. */
+    provisionRequestedAt: string;
 }
 export type ProvisionBucketPayloadSelect = {
     bucketId?: boolean;
     bucketKey?: boolean;
-    jobId?: boolean;
     physicalName?: boolean;
+    provisionRequestedAt?: boolean;
 };
 export interface CreateContentPresetPayload {
     clientMutationId?: string | null;

package/infra/orm/mutation/index.d.ts

@@ -28,10 +28,11 @@ export interface PlatformInfraSetManyAndCommitVariables {
 /**
  * Variables for provisionBucket
  * Reconcile an S3 bucket for a logical bucket in the database.
-Reads the bucket config via RLS, then enqueues the same
-storage:provision_bucket job used by the INSERT trigger. This is
-idempotent for an already-reconciled bucket; enqueue failures become
-GraphQL errors.
+Records the request on the bucket row via RLS; the bucket's job
+trigger then enqueues the same storage:provision_bucket job used on
+INSERT, and repeated requests collapse into one pending job. This is
+idempotent for an already-reconciled bucket; failures become GraphQL
+errors.
  */
 export interface ProvisionBucketVariables {
     input: ProvisionBucketInput;

package/modules/cli/commands/billing-provider-module.js

@@ -12,6 +12,8 @@ const fieldSchema = {
     activatePlanSubscriptionFunction: 'string',
     apiName: 'string',
     applyProviderObservationFunction: 'string',
+    billingConnectionTableId: 'uuid',
+    billingConnectionTableName: 'string',
     billingCustomersTableId: 'uuid',
     billingCustomersTableName: 'string',
     billingDisputesTableId: 'uuid',
@@ -26,6 +28,8 @@ const fieldSchema = {
     billingPricesTableName: 'string',
     billingProductsTableId: 'uuid',
     billingProductsTableName: 'string',
+    billingProviderConnectedFunction: 'string',
+    billingProviderKeyFunction: 'string',
     billingProviderStateTableId: 'uuid',
     billingProviderStateTableName: 'string',
     billingRefundsTableId: 'uuid',
@@ -62,6 +66,7 @@ const fieldSchema = {
     processBillingEventFunction: 'string',
     productsTableId: 'uuid',
     provider: 'string',
+    recordBillingConnectionFunction: 'string',
     recordBillingHealthFunction: 'string',
     recordDisputeFunction: 'string',
     recordRefundFunction: 'string',
@@ -121,6 +126,8 @@ async function handleList(argv, _prompter) {
             activatePlanSubscriptionFunction: true,
             apiName: true,
             applyProviderObservationFunction: true,
+            billingConnectionTableId: true,
+            billingConnectionTableName: true,
             billingCustomersTableId: true,
             billingCustomersTableName: true,
             billingDisputesTableId: true,
@@ -135,6 +142,8 @@ async function handleList(argv, _prompter) {
             billingPricesTableName: true,
             billingProductsTableId: true,
             billingProductsTableName: true,
+            billingProviderConnectedFunction: true,
+            billingProviderKeyFunction: true,
             billingProviderStateTableId: true,
             billingProviderStateTableName: true,
             billingRefundsTableId: true,
@@ -171,6 +180,7 @@ async function handleList(argv, _prompter) {
             processBillingEventFunction: true,
             productsTableId: true,
             provider: true,
+            recordBillingConnectionFunction: true,
             recordBillingHealthFunction: true,
             recordDisputeFunction: true,
             recordRefundFunction: true,
@@ -204,6 +214,8 @@ async function handleFindFirst(argv, _prompter) {
             activatePlanSubscriptionFunction: true,
             apiName: true,
             applyProviderObservationFunction: true,
+            billingConnectionTableId: true,
+            billingConnectionTableName: true,
             billingCustomersTableId: true,
             billingCustomersTableName: true,
             billingDisputesTableId: true,
@@ -218,6 +230,8 @@ async function handleFindFirst(argv, _prompter) {
             billingPricesTableName: true,
             billingProductsTableId: true,
             billingProductsTableName: true,
+            billingProviderConnectedFunction: true,
+            billingProviderKeyFunction: true,
             billingProviderStateTableId: true,
             billingProviderStateTableName: true,
             billingRefundsTableId: true,
@@ -254,6 +268,7 @@ async function handleFindFirst(argv, _prompter) {
             processBillingEventFunction: true,
             productsTableId: true,
             provider: true,
+            recordBillingConnectionFunction: true,
             recordBillingHealthFunction: true,
             recordDisputeFunction: true,
             recordRefundFunction: true,
@@ -299,6 +314,8 @@ async function handleGet(argv, prompter) {
                 activatePlanSubscriptionFunction: true,
                 apiName: true,
                 applyProviderObservationFunction: true,
+                billingConnectionTableId: true,
+                billingConnectionTableName: true,
                 billingCustomersTableId: true,
                 billingCustomersTableName: true,
                 billingDisputesTableId: true,
@@ -313,6 +330,8 @@ async function handleGet(argv, prompter) {
                 billingPricesTableName: true,
                 billingProductsTableId: true,
                 billingProductsTableName: true,
+                billingProviderConnectedFunction: true,
+                billingProviderKeyFunction: true,
                 billingProviderStateTableId: true,
                 billingProviderStateTableName: true,
                 billingRefundsTableId: true,
@@ -349,6 +368,7 @@ async function handleGet(argv, prompter) {
                 processBillingEventFunction: true,
                 productsTableId: true,
                 provider: true,
+                recordBillingConnectionFunction: true,
                 recordBillingHealthFunction: true,
                 recordDisputeFunction: true,
                 recordRefundFunction: true,
@@ -399,6 +419,20 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'billingConnectionTableId',
+                message: 'billingConnectionTableId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'billingConnectionTableName',
+                message: 'billingConnectionTableName',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'billingCustomersTableId',
@@ -497,6 +531,20 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'billingProviderConnectedFunction',
+                message: 'billingProviderConnectedFunction',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'billingProviderKeyFunction',
+                message: 'billingProviderKeyFunction',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'billingProviderStateTableId',
@@ -741,6 +789,13 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'recordBillingConnectionFunction',
+                message: 'recordBillingConnectionFunction',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'recordBillingHealthFunction',
@@ -842,6 +897,8 @@ async function handleCreate(argv, prompter) {
                 activatePlanSubscriptionFunction: cleanedData.activatePlanSubscriptionFunction,
                 apiName: cleanedData.apiName,
                 applyProviderObservationFunction: cleanedData.applyProviderObservationFunction,
+                billingConnectionTableId: cleanedData.billingConnectionTableId,
+                billingConnectionTableName: cleanedData.billingConnectionTableName,
                 billingCustomersTableId: cleanedData.billingCustomersTableId,
                 billingCustomersTableName: cleanedData.billingCustomersTableName,
                 billingDisputesTableId: cleanedData.billingDisputesTableId,
@@ -856,6 +913,8 @@ async function handleCreate(argv, prompter) {
                 billingPricesTableName: cleanedData.billingPricesTableName,
                 billingProductsTableId: cleanedData.billingProductsTableId,
                 billingProductsTableName: cleanedData.billingProductsTableName,
+                billingProviderConnectedFunction: cleanedData.billingProviderConnectedFunction,
+                billingProviderKeyFunction: cleanedData.billingProviderKeyFunction,
                 billingProviderStateTableId: cleanedData.billingProviderStateTableId,
                 billingProviderStateTableName: cleanedData.billingProviderStateTableName,
                 billingRefundsTableId: cleanedData.billingRefundsTableId,
@@ -891,6 +950,7 @@ async function handleCreate(argv, prompter) {
                 processBillingEventFunction: cleanedData.processBillingEventFunction,
                 productsTableId: cleanedData.productsTableId,
                 provider: cleanedData.provider,
+                recordBillingConnectionFunction: cleanedData.recordBillingConnectionFunction,
                 recordBillingHealthFunction: cleanedData.recordBillingHealthFunction,
                 recordDisputeFunction: cleanedData.recordDisputeFunction,
                 recordRefundFunction: cleanedData.recordRefundFunction,
@@ -909,6 +969,8 @@ async function handleCreate(argv, prompter) {
                 activatePlanSubscriptionFunction: true,
                 apiName: true,
                 applyProviderObservationFunction: true,
+                billingConnectionTableId: true,
+                billingConnectionTableName: true,
                 billingCustomersTableId: true,
                 billingCustomersTableName: true,
                 billingDisputesTableId: true,
@@ -923,6 +985,8 @@ async function handleCreate(argv, prompter) {
                 billingPricesTableName: true,
                 billingProductsTableId: true,
                 billingProductsTableName: true,
+                billingProviderConnectedFunction: true,
+                billingProviderKeyFunction: true,
                 billingProviderStateTableId: true,
                 billingProviderStateTableName: true,
                 billingRefundsTableId: true,
@@ -959,6 +1023,7 @@ async function handleCreate(argv, prompter) {
                 processBillingEventFunction: true,
                 productsTableId: true,
                 provider: true,
+                recordBillingConnectionFunction: true,
                 recordBillingHealthFunction: true,
                 recordDisputeFunction: true,
                 recordRefundFunction: true,
@@ -1015,6 +1080,20 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'billingConnectionTableId',
+                message: 'billingConnectionTableId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'billingConnectionTableName',
+                message: 'billingConnectionTableName',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'billingCustomersTableId',
@@ -1113,6 +1192,20 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'billingProviderConnectedFunction',
+                message: 'billingProviderConnectedFunction',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'billingProviderKeyFunction',
+                message: 'billingProviderKeyFunction',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'billingProviderStateTableId',
@@ -1357,6 +1450,13 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'recordBillingConnectionFunction',
+                message: 'recordBillingConnectionFunction',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'recordBillingHealthFunction',
@@ -1461,6 +1561,8 @@ async function handleUpdate(argv, prompter) {
                 activatePlanSubscriptionFunction: cleanedData.activatePlanSubscriptionFunction,
                 apiName: cleanedData.apiName,
                 applyProviderObservationFunction: cleanedData.applyProviderObservationFunction,
+                billingConnectionTableId: cleanedData.billingConnectionTableId,
+                billingConnectionTableName: cleanedData.billingConnectionTableName,
                 billingCustomersTableId: cleanedData.billingCustomersTableId,
                 billingCustomersTableName: cleanedData.billingCustomersTableName,
                 billingDisputesTableId: cleanedData.billingDisputesTableId,
@@ -1475,6 +1577,8 @@ async function handleUpdate(argv, prompter) {
                 billingPricesTableName: cleanedData.billingPricesTableName,
                 billingProductsTableId: cleanedData.billingProductsTableId,
                 billingProductsTableName: cleanedData.billingProductsTableName,
+                billingProviderConnectedFunction: cleanedData.billingProviderConnectedFunction,
+                billingProviderKeyFunction: cleanedData.billingProviderKeyFunction,
                 billingProviderStateTableId: cleanedData.billingProviderStateTableId,
                 billingProviderStateTableName: cleanedData.billingProviderStateTableName,
                 billingRefundsTableId: cleanedData.billingRefundsTableId,
@@ -1510,6 +1614,7 @@ async function handleUpdate(argv, prompter) {
                 processBillingEventFunction: cleanedData.processBillingEventFunction,
                 productsTableId: cleanedData.productsTableId,
                 provider: cleanedData.provider,
+                recordBillingConnectionFunction: cleanedData.recordBillingConnectionFunction,
                 recordBillingHealthFunction: cleanedData.recordBillingHealthFunction,
                 recordDisputeFunction: cleanedData.recordDisputeFunction,
                 recordRefundFunction: cleanedData.recordRefundFunction,
@@ -1528,6 +1633,8 @@ async function handleUpdate(argv, prompter) {
                 activatePlanSubscriptionFunction: true,
                 apiName: true,
                 applyProviderObservationFunction: true,
+                billingConnectionTableId: true,
+                billingConnectionTableName: true,
                 billingCustomersTableId: true,
                 billingCustomersTableName: true,
                 billingDisputesTableId: true,
@@ -1542,6 +1649,8 @@ async function handleUpdate(argv, prompter) {
                 billingPricesTableName: true,
                 billingProductsTableId: true,
                 billingProductsTableName: true,
+                billingProviderConnectedFunction: true,
+                billingProviderKeyFunction: true,
                 billingProviderStateTableId: true,
                 billingProviderStateTableName: true,
                 billingRefundsTableId: true,
@@ -1578,6 +1687,7 @@ async function handleUpdate(argv, prompter) {
                 processBillingEventFunction: true,
                 productsTableId: true,
                 provider: true,
+                recordBillingConnectionFunction: true,
                 recordBillingHealthFunction: true,
                 recordDisputeFunction: true,
                 recordRefundFunction: true,

package/modules/cli/commands/blueprint-construction.js

@@ -14,7 +14,6 @@ const fieldSchema = {
     constructedDefinition: 'json',
     createdAt: 'string',
     databaseId: 'uuid',
-    errorDetails: 'string',
     id: 'uuid',
     schemaId: 'uuid',
     status: 'string',
@@ -68,7 +67,6 @@ async function handleList(argv, _prompter) {
             constructedDefinition: true,
             createdAt: true,
             databaseId: true,
-            errorDetails: true,
             id: true,
             schemaId: true,
             status: true,
@@ -96,7 +94,6 @@ async function handleFindFirst(argv, _prompter) {
             constructedDefinition: true,
             createdAt: true,
             databaseId: true,
-            errorDetails: true,
             id: true,
             schemaId: true,
             status: true,
@@ -136,7 +133,6 @@ async function handleGet(argv, prompter) {
                 constructedDefinition: true,
                 createdAt: true,
                 databaseId: true,
-                errorDetails: true,
                 id: true,
                 schemaId: true,
                 status: true,
@@ -184,13 +180,6 @@ async function handleCreate(argv, prompter) {
                 message: 'databaseId',
                 required: true,
             },
-            {
-                type: 'text',
-                name: 'errorDetails',
-                message: 'errorDetails',
-                required: false,
-                skipPrompt: true,
-            },
             {
                 type: 'text',
                 name: 'schemaId',
@@ -223,7 +212,6 @@ async function handleCreate(argv, prompter) {
                 constructedAt: cleanedData.constructedAt,
                 constructedDefinition: cleanedData.constructedDefinition,
                 databaseId: cleanedData.databaseId,
-                errorDetails: cleanedData.errorDetails,
                 schemaId: cleanedData.schemaId,
                 status: cleanedData.status,
                 tableMap: cleanedData.tableMap,
@@ -234,7 +222,6 @@ async function handleCreate(argv, prompter) {
                 constructedDefinition: true,
                 createdAt: true,
                 databaseId: true,
-                errorDetails: true,
                 id: true,
                 schemaId: true,
                 status: true,
@@ -288,13 +275,6 @@ async function handleUpdate(argv, prompter) {
                 message: 'databaseId',
                 required: false,
             },
-            {
-                type: 'text',
-                name: 'errorDetails',
-                message: 'errorDetails',
-                required: false,
-                skipPrompt: true,
-            },
             {
                 type: 'text',
                 name: 'schemaId',
@@ -330,7 +310,6 @@ async function handleUpdate(argv, prompter) {
                 constructedAt: cleanedData.constructedAt,
                 constructedDefinition: cleanedData.constructedDefinition,
                 databaseId: cleanedData.databaseId,
-                errorDetails: cleanedData.errorDetails,
                 schemaId: cleanedData.schemaId,
                 status: cleanedData.status,
                 tableMap: cleanedData.tableMap,
@@ -341,7 +320,6 @@ async function handleUpdate(argv, prompter) {
                 constructedDefinition: true,
                 createdAt: true,
                 databaseId: true,
-                errorDetails: true,
                 id: true,
                 schemaId: true,
                 status: true,

package/modules/cli/commands/catalog-module.js

@@ -22,6 +22,8 @@ const fieldSchema = {
     bucketsTableName: 'string',
     databaseId: 'uuid',
     defaultCapabilities: 'string',
+    domainVerificationsTableId: 'uuid',
+    domainVerificationsTableName: 'string',
     domainsTableId: 'uuid',
     domainsTableName: 'string',
     entityTableId: 'uuid',
@@ -114,6 +116,8 @@ async function handleList(argv, _prompter) {
             bucketsTableName: true,
             databaseId: true,
             defaultCapabilities: true,
+            domainVerificationsTableId: true,
+            domainVerificationsTableName: true,
             domainsTableId: true,
             domainsTableName: true,
             entityTableId: true,
@@ -180,6 +184,8 @@ async function handleFindFirst(argv, _prompter) {
             bucketsTableName: true,
             databaseId: true,
             defaultCapabilities: true,
+            domainVerificationsTableId: true,
+            domainVerificationsTableName: true,
             domainsTableId: true,
             domainsTableName: true,
             entityTableId: true,
@@ -258,6 +264,8 @@ async function handleGet(argv, prompter) {
                 bucketsTableName: true,
                 databaseId: true,
                 defaultCapabilities: true,
+                domainVerificationsTableId: true,
+                domainVerificationsTableName: true,
                 domainsTableId: true,
                 domainsTableName: true,
                 entityTableId: true,
@@ -400,6 +408,20 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'domainVerificationsTableId',
+                message: 'domainVerificationsTableId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'domainVerificationsTableName',
+                message: 'domainVerificationsTableName',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'domainsTableId',
@@ -664,6 +686,8 @@ async function handleCreate(argv, prompter) {
                 bucketsTableName: cleanedData.bucketsTableName,
                 databaseId: cleanedData.databaseId,
                 defaultCapabilities: cleanedData.defaultCapabilities,
+                domainVerificationsTableId: cleanedData.domainVerificationsTableId,
+                domainVerificationsTableName: cleanedData.domainVerificationsTableName,
                 domainsTableId: cleanedData.domainsTableId,
                 domainsTableName: cleanedData.domainsTableName,
                 entityTableId: cleanedData.entityTableId,
@@ -714,6 +738,8 @@ async function handleCreate(argv, prompter) {
                 bucketsTableName: true,
                 databaseId: true,
                 defaultCapabilities: true,
+                domainVerificationsTableId: true,
+                domainVerificationsTableName: true,
                 domainsTableId: true,
                 domainsTableName: true,
                 entityTableId: true,
@@ -862,6 +888,20 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'domainVerificationsTableId',
+                message: 'domainVerificationsTableId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'domainVerificationsTableName',
+                message: 'domainVerificationsTableName',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'text',
                 name: 'domainsTableId',
@@ -1129,6 +1169,8 @@ async function handleUpdate(argv, prompter) {
                 bucketsTableName: cleanedData.bucketsTableName,
                 databaseId: cleanedData.databaseId,
                 defaultCapabilities: cleanedData.defaultCapabilities,
+                domainVerificationsTableId: cleanedData.domainVerificationsTableId,
+                domainVerificationsTableName: cleanedData.domainVerificationsTableName,
                 domainsTableId: cleanedData.domainsTableId,
                 domainsTableName: cleanedData.domainsTableName,
                 entityTableId: cleanedData.entityTableId,
@@ -1179,6 +1221,8 @@ async function handleUpdate(argv, prompter) {
                 bucketsTableName: true,
                 databaseId: true,
                 defaultCapabilities: true,
+                domainVerificationsTableId: true,
+                domainVerificationsTableName: true,
                 domainsTableId: true,
                 domainsTableName: true,
                 entityTableId: true,

package/modules/cli/commands/construct-blueprint.js

@@ -5,7 +5,7 @@ const utils_1 = require("../utils");
 exports.default = async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('construct-blueprint - Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Eight phases: (0) entity_type_provision for each membership_type entry \u2014 provisions entity tables, membership modules, and security. When a prefix already exists (e.g., \'org\'), the entry extends the existing entity type instead of creating a new one; if a storage[] key is present, it provisions entity-scoped storage for that type. (0.5) scope-based storage: each storage[] entry has an optional scope (\'app\' or \'org\' only). App-scoped storage seeds buckets at migration time. Org-scoped storage resolves the org membership type, creates org_buckets/org_files with owner_id, and seeds buckets per-entity via an AFTER INSERT trigger on the users table. When function_module is installed, a private functions bucket is auto-injected into org-scoped or entity-scoped storage entries. (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred). A table entry either names its table (table_name plus optional schema_name) or references one an installed module generated ("module": {"type": "agent", "scope": "org", "table": "message"}), which resolves through the module row\'s recorded table ids and raises when it matches nothing instead of creating an empty table. After provisioning, optional smart_tags (jsonb object) on the table entry are applied via metaschema.append_table_smart_tags(), and optional smart_tags on individual field entries are applied via metaschema.append_field_smart_tags(). (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, (7) seed achievements from definition.achievements[] \u2014 resolves events_module by entity_prefix and creates INSERT actions for levels, level_requirements, and achievement_rewards tables. 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.\n\nUsage: construct-blueprint [OPTIONS]\n');
+            console.log('construct-blueprint - Executes a blueprint definition by delegating to provision_* procedures. Creates a blueprint_construction record to track the attempt. Eight phases: (0) entity_type_provision for each membership_type entry \u2014 provisions entity tables, membership modules, and security. When a prefix already exists (e.g., \'org\'), the entry extends the existing entity type instead of creating a new one; if a storage[] key is present, it provisions entity-scoped storage for that type. (0.5) scope-based storage: each storage[] entry has an optional scope (\'app\' or \'org\' only). App-scoped storage seeds buckets at migration time. Org-scoped storage resolves the org membership type, creates org_buckets/org_files with owner_id, and seeds buckets per-entity via an AFTER INSERT trigger on the users table. When function_module is installed, a private functions bucket is auto-injected into org-scoped or entity-scoped storage entries. (1) provision_table() for each table with nodes[], fields[], policies[], and grants (table-level indexes/fts/unique_constraints/check_constraints are deferred). A table entry either names its table (table_name plus optional schema_name) or references one an installed module generated ("module": {"type": "agent", "scope": "org", "table": "message"}), which resolves through the module row\'s recorded table ids and raises when it matches nothing instead of creating an empty table. After provisioning, optional smart_tags (jsonb object) on the table entry are applied via metaschema.append_table_smart_tags(), and optional smart_tags on individual field entries are applied via metaschema.append_field_smart_tags(). (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, (7) seed achievements from definition.achievements[] \u2014 resolves events_module by entity_prefix and creates INSERT actions for levels, level_requirements, and achievement_rewards tables. 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. A failure raises its coded error to the caller and rolls back the whole construction, including the construction record.\n\nUsage: construct-blueprint [OPTIONS]\n');
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/modules/cli/commands/provision-bucket.js

@@ -5,7 +5,7 @@ const utils_1 = require("../utils");
 exports.default = async (argv, prompter, _options) => {
     try {
         if (argv.help || argv.h) {
-            console.log('provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then enqueues the same\nstorage:provision_bucket job used by the INSERT trigger. This is\nidempotent for an already-reconciled bucket; enqueue failures become\nGraphQL errors.\n\nUsage: provision-bucket [OPTIONS]\n');
+            console.log("provision-bucket - Reconcile an S3 bucket for a logical bucket in the database.\nRecords the request on the bucket row via RLS; the bucket's job\ntrigger then enqueues the same storage:provision_bucket job used on\nINSERT, and repeated requests collapse into one pending job. This is\nidempotent for an already-reconciled bucket; failures become GraphQL\nerrors.\n\nUsage: provision-bucket [OPTIONS]\n");
             process.exit(0);
         }
         const answers = await prompter.prompt(argv, [

package/modules/cli/commands/storage-module.js

@@ -47,6 +47,7 @@ const fieldSchema = {
     provisions: 'json',
     publicSchemaName: 'string',
     publicUrlPrefix: 'string',
+    region: 'string',
     restrictReads: 'boolean',
     schemaId: 'uuid',
     scope: 'string',
@@ -132,6 +133,7 @@ async function handleList(argv, _prompter) {
             provisions: true,
             publicSchemaName: true,
             publicUrlPrefix: true,
+            region: true,
             restrictReads: true,
             schemaId: true,
             scope: true,
@@ -191,6 +193,7 @@ async function handleFindFirst(argv, _prompter) {
             provisions: true,
             publicSchemaName: true,
             publicUrlPrefix: true,
+            region: true,
             restrictReads: true,
             schemaId: true,
             scope: true,
@@ -262,6 +265,7 @@ async function handleGet(argv, prompter) {
                 provisions: true,
                 publicSchemaName: true,
                 publicUrlPrefix: true,
+                region: true,
                 restrictReads: true,
                 schemaId: true,
                 scope: true,
@@ -540,6 +544,13 @@ async function handleCreate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'region',
+                message: 'region',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'boolean',
                 name: 'restrictReads',
@@ -611,6 +622,7 @@ async function handleCreate(argv, prompter) {
                 provisions: cleanedData.provisions,
                 publicSchemaName: cleanedData.publicSchemaName,
                 publicUrlPrefix: cleanedData.publicUrlPrefix,
+                region: cleanedData.region,
                 restrictReads: cleanedData.restrictReads,
                 schemaId: cleanedData.schemaId,
                 scope: cleanedData.scope,
@@ -655,6 +667,7 @@ async function handleCreate(argv, prompter) {
                 provisions: true,
                 publicSchemaName: true,
                 publicUrlPrefix: true,
+                region: true,
                 restrictReads: true,
                 schemaId: true,
                 scope: true,
@@ -939,6 +952,13 @@ async function handleUpdate(argv, prompter) {
                 required: false,
                 skipPrompt: true,
             },
+            {
+                type: 'text',
+                name: 'region',
+                message: 'region',
+                required: false,
+                skipPrompt: true,
+            },
             {
                 type: 'boolean',
                 name: 'restrictReads',
@@ -1013,6 +1033,7 @@ async function handleUpdate(argv, prompter) {
                 provisions: cleanedData.provisions,
                 publicSchemaName: cleanedData.publicSchemaName,
                 publicUrlPrefix: cleanedData.publicUrlPrefix,
+                region: cleanedData.region,
                 restrictReads: cleanedData.restrictReads,
                 schemaId: cleanedData.schemaId,
                 scope: cleanedData.scope,
@@ -1057,6 +1078,7 @@ async function handleUpdate(argv, prompter) {
                 provisions: true,
                 publicSchemaName: true,
                 publicUrlPrefix: true,
+                region: true,
                 restrictReads: true,
                 schemaId: true,
                 scope: true,