@happyvertical/smrt-fields 0.40.61 → 0.40.62

package/dist/manifest.json

@@ -2,8 +2,108 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-fields",
-  "packageVersion": "0.40.61",
+  "packageVersion": "0.40.62",
   "objects": {
+    "@happyvertical/smrt-fields:FieldUsageLearningAgent": {
+      "name": "fieldusagelearningagent",
+      "className": "FieldUsageLearningAgent",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldUsageLearningAgent",
+      "collection": "fieldusagelearningagents",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/usage-learning.ts",
+      "packageName": "@happyvertical/smrt-fields",
+      "fields": {},
+      "methods": {
+        "runUsageMaintenance": {
+          "name": "runUsageMaintenance",
+          "async": true,
+          "parameters": [
+            {
+              "name": "args",
+              "type": "Record<string>",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<FieldUsageMaintenanceSummary>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "runSuggestionGeneration": {
+          "name": "runSuggestionGeneration",
+          "async": true,
+          "parameters": [
+            {
+              "name": "args",
+              "type": "Record<string>",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<FieldUsageSuggestionRunSummary>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "_smrt_field_usage_learning_agents",
+        "api": {
+          "include": []
+        },
+        "cli": false,
+        "mcp": {
+          "include": []
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "FieldUsageLearningAgent",
+      "collectionExportName": "FieldUsageLearningAgentCollection",
+      "schema": {
+        "tableName": "_smrt_field_usage_learning_agents",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_usage_learning_agents\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_field_usage_learning_agents_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "_smrt_field_usage_learning_agents_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "183ee1d8"
+      }
+    },
     "@happyvertical/smrt-fields:FieldPolicyCollection": {
       "name": "fieldpolicycollection",
       "className": "FieldPolicyCollection",
@@ -202,184 +302,539 @@
         "version": "13aa748c"
       }
     },
-    "@happyvertical/smrt-fields:FieldPolicy": {
-      "name": "fieldpolicy",
-      "className": "FieldPolicy",
-      "qualifiedName": "@happyvertical/smrt-fields:FieldPolicy",
-      "collection": "fieldpolicies",
-      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/models/FieldPolicy.ts",
+    "@happyvertical/smrt-fields:FieldPolicySuggestionCollection": {
+      "name": "fieldpolicysuggestioncollection",
+      "className": "FieldPolicySuggestionCollection",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldPolicySuggestionCollection",
+      "collection": "fieldpolicysuggestions",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/collections/FieldPolicySuggestionCollection.ts",
       "packageName": "@happyvertical/smrt-fields",
-      "fields": {
-        "objectRef": {
-          "type": "text",
-          "required": true,
-          "default": "",
-          "_meta": {
-            "required": true
-          }
-        },
-        "fieldName": {
-          "type": "text",
-          "required": true,
-          "default": "",
-          "_meta": {
-            "required": true
-          }
-        },
-        "scopeType": {
-          "type": "text",
-          "required": true,
-          "default": "app",
-          "_meta": {
-            "required": true
-          }
-        },
-        "tenantId": {
-          "type": "text",
-          "required": false,
-          "_meta": {
-            "sqlType": "UUID",
-            "nullable": true,
-            "__tenancy": {
-              "isTenantIdField": true,
-              "autoFilter": true,
-              "required": false,
-              "autoPopulate": true,
-              "nullable": true
-            }
-          }
-        },
-        "userId": {
-          "type": "crossPackageRef",
-          "required": false,
-          "related": "@happyvertical/smrt-users:User",
-          "_meta": {
-            "nullable": true
-          }
-        },
-        "scopeKey": {
-          "type": "text",
-          "required": true,
-          "_meta": {
-            "required": true
-          }
-        },
-        "defaultValue": {
-          "type": "text",
-          "required": false,
-          "_meta": {
-            "nullable": true
-          }
-        },
-        "visibility": {
-          "type": "text",
-          "required": false,
-          "_meta": {
-            "nullable": true
-          }
-        },
-        "help": {
-          "type": "text",
-          "required": false,
-          "_meta": {
-            "nullable": true
-          }
-        },
-        "label": {
-          "type": "text",
-          "required": false,
-          "_meta": {
-            "nullable": true
-          }
-        },
-        "displayOrder": {
-          "type": "integer",
-          "required": false,
-          "_meta": {
-            "nullable": true
-          }
-        },
-        "locked": {
-          "type": "boolean",
-          "required": false,
-          "_meta": {
-            "nullable": true
-          }
-        },
-        "updatedBy": {
-          "type": "crossPackageRef",
-          "required": false,
-          "related": "@happyvertical/smrt-users:User",
-          "_meta": {
-            "nullable": true
-          }
-        }
-      },
+      "fields": {},
       "methods": {
-        "getDefaultValue": {
-          "name": "getDefaultValue",
-          "async": false,
-          "parameters": [],
-          "returnType": "any",
-          "isStatic": false,
-          "isPublic": true
-        },
-        "setDefaultValue": {
-          "name": "setDefaultValue",
-          "async": false,
+        "pendingSuggestions": {
+          "name": "pendingSuggestions",
+          "async": true,
           "parameters": [
             {
-              "name": "value",
-              "type": "any",
-              "optional": false
+              "name": "options",
+              "type": "object",
+              "optional": true
             }
           ],
-          "returnType": "void",
+          "returnType": "Promise<PendingFieldPolicySuggestionsResult>",
           "isStatic": false,
           "isPublic": true
         },
-        "save": {
-          "name": "save",
+        "acceptSuggestion": {
+          "name": "acceptSuggestion",
           "async": true,
-          "parameters": [],
-          "returnType": "Promise",
+          "parameters": [
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<AcceptFieldPolicySuggestionResult>",
           "isStatic": false,
           "isPublic": true
         },
-        "delete": {
-          "name": "delete",
+        "dismissSuggestion": {
+          "name": "dismissSuggestion",
           "async": true,
-          "parameters": [],
-          "returnType": "Promise<void>",
+          "parameters": [
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<DismissFieldPolicySuggestionResult>",
           "isStatic": false,
           "isPublic": true
         }
       },
       "decoratorConfig": {
-        "tableName": "_smrt_field_policies",
         "conflictColumns": [
           "object_ref",
           "field_name",
-          "scope_type",
-          "scope_key"
+          "tenant_id",
+          "kind",
+          "active_key"
         ],
         "api": {
           "include": [
-            "create",
-            "update",
-            "delete"
+            "pendingSuggestions",
+            "acceptSuggestion",
+            "dismissSuggestion"
           ],
-          "principalContext": true
+          "principalContext": true,
+          "routes": {
+            "pendingSuggestions": {
+              "scope": "collection",
+              "method": "POST",
+              "path": "pending"
+            },
+            "acceptSuggestion": {
+              "scope": "collection",
+              "method": "POST",
+              "path": "accept"
+            },
+            "dismissSuggestion": {
+              "scope": "collection",
+              "method": "POST",
+              "path": "dismiss"
+            }
+          }
         },
-        "cli": {
-          "include": [
-            "create",
-            "update",
-            "delete"
-          ],
-          "exclude": [
-            "getDefaultValue",
-            "setDefaultValue"
+        "cli": false,
+        "mcp": false,
+        "tableName": "_smrt_field_policy_suggestions"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "FieldPolicySuggestion",
+      "exportName": "FieldPolicySuggestionCollection",
+      "collectionExportName": "FieldPolicySuggestionCollectionCollection",
+      "schema": {
+        "tableName": "_smrt_field_policy_suggestions",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_policy_suggestions\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_field_policy_suggestions_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "_smrt_field_policy_suggestions_object_ref_field_name_idx",
+            "columns": [
+              "object_ref",
+              "field_name",
+              "tenant_id",
+              "kind",
+              "active_key"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "853df86d"
+      }
+    },
+    "@happyvertical/smrt-fields:FieldUsageCounterCollection": {
+      "name": "fieldusagecountercollection",
+      "className": "FieldUsageCounterCollection",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldUsageCounterCollection",
+      "collection": "fieldusagecounters",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/collections/FieldUsageCounterCollection.ts",
+      "packageName": "@happyvertical/smrt-fields",
+      "fields": {},
+      "methods": {
+        "reportUsage": {
+          "name": "reportUsage",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<FieldUsageReportResult>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "listWindow": {
+          "name": "listWindow",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "object",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<FieldUsageCounter[]>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "conflictColumns": [
+          "object_ref",
+          "field_name",
+          "tenant_id",
+          "period"
+        ],
+        "api": {
+          "include": [
+            "reportUsage"
+          ],
+          "principalContext": true,
+          "routes": {
+            "reportUsage": {
+              "scope": "collection",
+              "method": "POST",
+              "path": "report"
+            }
+          }
+        },
+        "cli": false,
+        "mcp": false,
+        "tableName": "_smrt_field_usage_counters"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "FieldUsageCounter",
+      "exportName": "FieldUsageCounterCollection",
+      "collectionExportName": "FieldUsageCounterCollectionCollection",
+      "schema": {
+        "tableName": "_smrt_field_usage_counters",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_usage_counters\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_field_usage_counters_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "_smrt_field_usage_counters_object_ref_field_name_idx",
+            "columns": [
+              "object_ref",
+              "field_name",
+              "tenant_id",
+              "period"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "8bd9beae"
+      }
+    },
+    "@happyvertical/smrt-fields:FieldUsageReportReceiptCollection": {
+      "name": "fieldusagereportreceiptcollection",
+      "className": "FieldUsageReportReceiptCollection",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldUsageReportReceiptCollection",
+      "collection": "fieldusagereportreceipts",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/collections/FieldUsageCounterCollection.ts",
+      "packageName": "@happyvertical/smrt-fields",
+      "fields": {},
+      "methods": {
+        "claim": {
+          "name": "claim",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "object",
+              "optional": false
+            }
+          ],
+          "returnType": "Promise<boolean>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "conflictColumns": [
+          "tenant_id",
+          "user_id",
+          "object_ref",
+          "field_name",
+          "period"
+        ],
+        "api": false,
+        "cli": false,
+        "mcp": false,
+        "tableName": "_smrt_field_usage_report_receipts"
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "FieldUsageReportReceipt",
+      "exportName": "FieldUsageReportReceiptCollection",
+      "collectionExportName": "FieldUsageReportReceiptCollectionCollection",
+      "schema": {
+        "tableName": "_smrt_field_usage_report_receipts",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_usage_report_receipts\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_field_usage_report_receipts_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "_smrt_field_usage_report_receipts_tenant_id_user_id_idx",
+            "columns": [
+              "tenant_id",
+              "user_id",
+              "object_ref",
+              "field_name",
+              "period"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "2e77b775"
+      }
+    },
+    "@happyvertical/smrt-fields:FieldPolicy": {
+      "name": "fieldpolicy",
+      "className": "FieldPolicy",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldPolicy",
+      "collection": "fieldpolicies",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/models/FieldPolicy.ts",
+      "packageName": "@happyvertical/smrt-fields",
+      "fields": {
+        "objectRef": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "fieldName": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "scopeType": {
+          "type": "text",
+          "required": true,
+          "default": "app",
+          "_meta": {
+            "required": true
+          }
+        },
+        "tenantId": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "sqlType": "UUID",
+            "nullable": true,
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": false,
+              "autoPopulate": true,
+              "nullable": true
+            }
+          }
+        },
+        "userId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:User",
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "scopeKey": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "required": true
+          }
+        },
+        "defaultValue": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "visibility": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "help": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "label": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "displayOrder": {
+          "type": "integer",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "locked": {
+          "type": "boolean",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "updatedBy": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:User",
+          "_meta": {
+            "nullable": true
+          }
+        }
+      },
+      "methods": {
+        "getDefaultValue": {
+          "name": "getDefaultValue",
+          "async": false,
+          "parameters": [],
+          "returnType": "any",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setDefaultValue": {
+          "name": "setDefaultValue",
+          "async": false,
+          "parameters": [
+            {
+              "name": "value",
+              "type": "any",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "_smrt_field_policies",
+        "conflictColumns": [
+          "object_ref",
+          "field_name",
+          "scope_type",
+          "scope_key"
+        ],
+        "api": {
+          "include": [
+            "create",
+            "update",
+            "delete"
+          ],
+          "principalContext": true
+        },
+        "cli": {
+          "include": [
+            "create",
+            "update",
+            "delete"
+          ],
+          "exclude": [
+            "getDefaultValue",
+            "setDefaultValue"
           ]
         },
         "mcp": {
@@ -387,8 +842,642 @@
         }
       },
       "extends": "SmrtObject",
-      "exportName": "FieldPolicy",
-      "collectionExportName": "FieldPolicyCollection",
+      "exportName": "FieldPolicy",
+      "collectionExportName": "FieldPolicyCollection",
+      "validationRules": [
+        {
+          "field": "objectRef",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "fieldName",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "scopeType",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "scopeKey",
+          "rule": "required",
+          "fieldType": "text"
+        }
+      ],
+      "schema": {
+        "tableName": "_smrt_field_policies",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"object_ref\" TEXT NOT NULL DEFAULT '',\n  \"field_name\" TEXT NOT NULL DEFAULT '',\n  \"scope_type\" TEXT NOT NULL DEFAULT 'app',\n  \"tenant_id\" UUID,\n  \"user_id\" UUID,\n  \"scope_key\" TEXT NOT NULL,\n  \"default_value\" TEXT,\n  \"visibility\" TEXT,\n  \"help\" TEXT,\n  \"label\" TEXT,\n  \"display_order\" INTEGER,\n  \"locked\" BOOLEAN,\n  \"updated_by\" UUID\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "object_ref": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "field_name": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "scope_type": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": "app"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": false,
+            "unique": false
+          },
+          "user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "scope_key": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false
+          },
+          "default_value": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "visibility": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "help": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "label": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "display_order": {
+            "type": "INTEGER",
+            "notNull": false,
+            "unique": false
+          },
+          "locked": {
+            "type": "BOOLEAN",
+            "notNull": false,
+            "unique": false
+          },
+          "updated_by": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_field_policies_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "_smrt_field_policies_object_ref_field_name_idx",
+            "columns": [
+              "object_ref",
+              "field_name",
+              "scope_type",
+              "scope_key"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "34b355cc"
+      }
+    },
+    "@happyvertical/smrt-fields:FieldPolicySuggestion": {
+      "name": "fieldpolicysuggestion",
+      "className": "FieldPolicySuggestion",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldPolicySuggestion",
+      "collection": "fieldpolicysuggestions",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/models/FieldPolicySuggestion.ts",
+      "packageName": "@happyvertical/smrt-fields",
+      "fields": {
+        "objectRef": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "fieldName": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false
+            }
+          }
+        },
+        "kind": {
+          "type": "text",
+          "required": true,
+          "default": "promote",
+          "_meta": {
+            "required": true
+          }
+        },
+        "proposedValue": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "evidence": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
+        },
+        "status": {
+          "type": "text",
+          "required": true,
+          "default": "pending",
+          "_meta": {
+            "required": true
+          }
+        },
+        "activeKey": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "required": true
+          }
+        },
+        "cooldownUntil": {
+          "type": "datetime",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "decidedBy": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:User",
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "decidedAt": {
+          "type": "datetime",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        }
+      },
+      "methods": {
+        "getEvidence": {
+          "name": "getEvidence",
+          "async": false,
+          "parameters": [],
+          "returnType": "Record<string>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setEvidence": {
+          "name": "setEvidence",
+          "async": false,
+          "parameters": [
+            {
+              "name": "evidence",
+              "type": "Record<string>",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getProposedValue": {
+          "name": "getProposedValue",
+          "async": false,
+          "parameters": [],
+          "returnType": "any",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "toSuggestionData": {
+          "name": "toSuggestionData",
+          "async": false,
+          "parameters": [],
+          "returnType": "FieldPolicySuggestionData",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "_smrt_field_policy_suggestions",
+        "conflictColumns": [
+          "object_ref",
+          "field_name",
+          "tenant_id",
+          "kind",
+          "active_key"
+        ],
+        "api": {
+          "include": []
+        },
+        "cli": false,
+        "mcp": {
+          "include": []
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "FieldPolicySuggestion",
+      "collectionExportName": "FieldPolicySuggestionCollection",
+      "validationRules": [
+        {
+          "field": "objectRef",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "fieldName",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "tenantId",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "kind",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "status",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "activeKey",
+          "rule": "required",
+          "fieldType": "text"
+        }
+      ],
+      "schema": {
+        "tableName": "_smrt_field_policy_suggestions",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_policy_suggestions\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"object_ref\" TEXT NOT NULL DEFAULT '',\n  \"field_name\" TEXT NOT NULL DEFAULT '',\n  \"tenant_id\" UUID NOT NULL,\n  \"kind\" TEXT NOT NULL DEFAULT 'promote',\n  \"proposed_value\" TEXT,\n  \"evidence\" TEXT,\n  \"status\" TEXT NOT NULL DEFAULT 'pending',\n  \"active_key\" TEXT NOT NULL,\n  \"cooldown_until\" TIMESTAMP,\n  \"decided_by\" UUID,\n  \"decided_at\" TIMESTAMP\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "object_ref": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "field_name": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "kind": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": "promote"
+          },
+          "proposed_value": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "evidence": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "status": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": "pending"
+          },
+          "active_key": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false
+          },
+          "cooldown_until": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "decided_by": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "decided_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_field_policy_suggestions_id_idx",
+            "columns": [
+              "id"
+            ]
+          },
+          {
+            "name": "_smrt_field_policy_suggestions_object_ref_field_name_idx",
+            "columns": [
+              "object_ref",
+              "field_name",
+              "tenant_id",
+              "kind",
+              "active_key"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "1bc8c6e5"
+      }
+    },
+    "@happyvertical/smrt-fields:FieldUsageCounter": {
+      "name": "fieldusagecounter",
+      "className": "FieldUsageCounter",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldUsageCounter",
+      "collection": "fieldusagecounters",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/models/FieldUsageCounter.ts",
+      "packageName": "@happyvertical/smrt-fields",
+      "fields": {
+        "objectRef": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "fieldName": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false
+            }
+          }
+        },
+        "period": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "submissionCount": {
+          "type": "integer",
+          "required": false,
+          "_meta": {}
+        },
+        "setCount": {
+          "type": "integer",
+          "required": false,
+          "_meta": {}
+        },
+        "distinctUserCount": {
+          "type": "integer",
+          "required": false,
+          "_meta": {}
+        },
+        "distinctUserIds": {
+          "type": "text",
+          "required": false,
+          "_meta": {}
+        },
+        "distinctUsersOverflowed": {
+          "type": "boolean",
+          "required": false,
+          "_meta": {}
+        },
+        "valueHistogram": {
+          "type": "text",
+          "required": false,
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "valueHistogramOverflowed": {
+          "type": "boolean",
+          "required": false,
+          "_meta": {}
+        }
+      },
+      "methods": {
+        "getDistinctUserIds": {
+          "name": "getDistinctUserIds",
+          "async": false,
+          "parameters": [],
+          "returnType": "string[]",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "addDistinctUser": {
+          "name": "addDistinctUser",
+          "async": false,
+          "parameters": [
+            {
+              "name": "userId",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "getValueHistogram": {
+          "name": "getValueHistogram",
+          "async": false,
+          "parameters": [],
+          "returnType": "Record<string, number>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "recordHistogramSample": {
+          "name": "recordHistogramSample",
+          "async": false,
+          "parameters": [
+            {
+              "name": "key",
+              "type": "string",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "isLegacyBucket": {
+          "name": "isLegacyBucket",
+          "async": false,
+          "parameters": [],
+          "returnType": "boolean",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "_smrt_field_usage_counters",
+        "conflictColumns": [
+          "object_ref",
+          "field_name",
+          "tenant_id",
+          "period"
+        ],
+        "api": {
+          "include": []
+        },
+        "cli": false,
+        "mcp": {
+          "include": []
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "FieldUsageCounter",
+      "collectionExportName": "FieldUsageCounterCollection",
       "validationRules": [
         {
           "field": "objectRef",
@@ -401,19 +1490,19 @@
           "fieldType": "text"
         },
         {
-          "field": "scopeType",
+          "field": "tenantId",
           "rule": "required",
           "fieldType": "text"
         },
         {
-          "field": "scopeKey",
+          "field": "period",
           "rule": "required",
           "fieldType": "text"
         }
       ],
       "schema": {
-        "tableName": "_smrt_field_policies",
-        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_policies\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"object_ref\" TEXT NOT NULL DEFAULT '',\n  \"field_name\" TEXT NOT NULL DEFAULT '',\n  \"scope_type\" TEXT NOT NULL DEFAULT 'app',\n  \"tenant_id\" UUID,\n  \"user_id\" UUID,\n  \"scope_key\" TEXT NOT NULL,\n  \"default_value\" TEXT,\n  \"visibility\" TEXT,\n  \"help\" TEXT,\n  \"label\" TEXT,\n  \"display_order\" INTEGER,\n  \"locked\" BOOLEAN,\n  \"updated_by\" UUID\n);",
+        "tableName": "_smrt_field_usage_counters",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_usage_counters\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"object_ref\" TEXT NOT NULL DEFAULT '',\n  \"field_name\" TEXT NOT NULL DEFAULT '',\n  \"tenant_id\" UUID NOT NULL,\n  \"period\" TEXT NOT NULL DEFAULT '',\n  \"submission_count\" INTEGER,\n  \"set_count\" INTEGER,\n  \"distinct_user_count\" INTEGER,\n  \"distinct_user_ids\" TEXT,\n  \"distinct_users_overflowed\" BOOLEAN,\n  \"value_histogram\" TEXT,\n  \"value_histogram_overflowed\" BOOLEAN\n);",
         "columns": {
           "id": {
             "type": "UUID",
@@ -452,85 +1541,250 @@
             "unique": false,
             "default": ""
           },
-          "scope_type": {
-            "type": "TEXT",
-            "notNull": true,
-            "unique": false,
-            "default": "app"
-          },
           "tenant_id": {
             "type": "UUID",
             "referenceKind": "tenantId",
-            "notNull": false,
-            "unique": false
-          },
-          "user_id": {
-            "type": "UUID",
-            "referenceKind": "crossPackageRef",
-            "notNull": false,
+            "notNull": true,
             "unique": false
           },
-          "scope_key": {
+          "period": {
             "type": "TEXT",
             "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "submission_count": {
+            "type": "INTEGER",
+            "notNull": false,
             "unique": false
           },
-          "default_value": {
-            "type": "TEXT",
+          "set_count": {
+            "type": "INTEGER",
             "notNull": false,
             "unique": false
           },
-          "visibility": {
-            "type": "TEXT",
+          "distinct_user_count": {
+            "type": "INTEGER",
             "notNull": false,
             "unique": false
           },
-          "help": {
+          "distinct_user_ids": {
             "type": "TEXT",
             "notNull": false,
             "unique": false
           },
-          "label": {
-            "type": "TEXT",
+          "distinct_users_overflowed": {
+            "type": "BOOLEAN",
             "notNull": false,
             "unique": false
           },
-          "display_order": {
-            "type": "INTEGER",
+          "value_histogram": {
+            "type": "TEXT",
             "notNull": false,
             "unique": false
           },
-          "locked": {
+          "value_histogram_overflowed": {
             "type": "BOOLEAN",
             "notNull": false,
             "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "_smrt_field_usage_counters_id_idx",
+            "columns": [
+              "id"
+            ]
           },
-          "updated_by": {
+          {
+            "name": "_smrt_field_usage_counters_object_ref_field_name_idx",
+            "columns": [
+              "object_ref",
+              "field_name",
+              "tenant_id",
+              "period"
+            ],
+            "unique": true
+          }
+        ],
+        "version": "46fcebc6"
+      }
+    },
+    "@happyvertical/smrt-fields:FieldUsageReportReceipt": {
+      "name": "fieldusagereportreceipt",
+      "className": "FieldUsageReportReceipt",
+      "qualifiedName": "@happyvertical/smrt-fields:FieldUsageReportReceipt",
+      "collection": "fieldusagereportreceipts",
+      "filePath": "/home/runner/_work/smrt/smrt/packages/fields/src/models/FieldUsageReportReceipt.ts",
+      "packageName": "@happyvertical/smrt-fields",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false
+            }
+          }
+        },
+        "userId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:User"
+        },
+        "objectRef": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "fieldName": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        },
+        "period": {
+          "type": "text",
+          "required": true,
+          "default": "",
+          "_meta": {
+            "required": true
+          }
+        }
+      },
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "_smrt_field_usage_report_receipts",
+        "conflictColumns": [
+          "tenant_id",
+          "user_id",
+          "object_ref",
+          "field_name",
+          "period"
+        ],
+        "api": {
+          "include": []
+        },
+        "cli": false,
+        "mcp": {
+          "include": []
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "FieldUsageReportReceipt",
+      "collectionExportName": "FieldUsageReportReceiptCollection",
+      "validationRules": [
+        {
+          "field": "tenantId",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "objectRef",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "fieldName",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "period",
+          "rule": "required",
+          "fieldType": "text"
+        }
+      ],
+      "schema": {
+        "tableName": "_smrt_field_usage_report_receipts",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"_smrt_field_usage_report_receipts\" (\n  \"id\" UUID PRIMARY KEY NOT NULL,\n  \"slug\" TEXT NOT NULL,\n  \"context\" TEXT NOT NULL DEFAULT '',\n  \"created_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"updated_at\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\n  \"tenant_id\" UUID NOT NULL,\n  \"user_id\" UUID,\n  \"object_ref\" TEXT NOT NULL DEFAULT '',\n  \"field_name\" TEXT NOT NULL DEFAULT '',\n  \"period\" TEXT NOT NULL DEFAULT ''\n);",
+        "columns": {
+          "id": {
+            "type": "UUID",
+            "primaryKey": true,
+            "referenceKind": "id",
+            "notNull": true
+          },
+          "slug": {
+            "type": "TEXT",
+            "notNull": true
+          },
+          "context": {
+            "type": "TEXT",
+            "notNull": true,
+            "default": ""
+          },
+          "created_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "updated_at": {
+            "type": "TIMESTAMP",
+            "notNull": true,
+            "default": "current_timestamp"
+          },
+          "tenant_id": {
+            "type": "UUID",
+            "referenceKind": "tenantId",
+            "notNull": true,
+            "unique": false
+          },
+          "user_id": {
             "type": "UUID",
             "referenceKind": "crossPackageRef",
             "notNull": false,
             "unique": false
+          },
+          "object_ref": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "field_name": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
+          },
+          "period": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false,
+            "default": ""
           }
         },
         "indexes": [
           {
-            "name": "_smrt_field_policies_id_idx",
+            "name": "_smrt_field_usage_report_receipts_id_idx",
             "columns": [
               "id"
             ]
           },
           {
-            "name": "_smrt_field_policies_object_ref_field_name_idx",
+            "name": "_smrt_field_usage_report_receipts_tenant_id_user_id_idx",
             "columns": [
+              "tenant_id",
+              "user_id",
               "object_ref",
               "field_name",
-              "scope_type",
-              "scope_key"
+              "period"
             ],
             "unique": true
           }
         ],
-        "version": "34b355cc"
+        "version": "c3119047"
       }
     }
   },