@happyvertical/smrt-users 0.30.0

package/dist/smrt-knowledge.json

@@ -0,0 +1,2744 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-06-23T01:11:47.353Z",
+  "packageName": "@happyvertical/smrt-users",
+  "packageVersion": "0.30.0",
+  "sourceManifestPath": "dist/manifest.json",
+  "agentDocPath": "AGENTS.md",
+  "sourceHashes": {
+    "manifest": "130d1f4d978daf5b7a2f08fdbd4d82fccb65038058222e4ac0080dc18ff183cc",
+    "packageJson": "5b562b335e5f29d1b872d563007e428309255b43aba65c01140251f53d6af89e",
+    "agents": "7265a29482d4a39a46d84a489ee09b49eb5ecc4e71a52c94909dbd20a51f619c"
+  },
+  "exports": [
+    ".",
+    "./manifest",
+    "./manifest.json",
+    "./playground",
+    "./svelte",
+    "./sveltekit"
+  ],
+  "dependencies": {
+    "@happyvertical/logger": "catalog:",
+    "@happyvertical/smrt-config": "workspace:*",
+    "@happyvertical/smrt-core": "workspace:*",
+    "@happyvertical/smrt-profiles": "workspace:*",
+    "@happyvertical/smrt-tenancy": "workspace:*",
+    "@happyvertical/smrt-types": "workspace:*",
+    "@happyvertical/smrt-ui": "workspace:*",
+    "jose": "^6.1.3",
+    "@happyvertical/smrt-vitest": "workspace:*",
+    "@happyvertical/sql": "catalog:",
+    "@sveltejs/package": "^2.5.7",
+    "@sveltejs/vite-plugin-svelte": "^6.2.4",
+    "@types/node": "25.0.9",
+    "fast-glob": "^3.3.3",
+    "svelte": "^5.46.4",
+    "svelte-check": "^4.3.5",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17"
+  },
+  "smrtDependencies": [
+    "@happyvertical/smrt-config",
+    "@happyvertical/smrt-core",
+    "@happyvertical/smrt-profiles",
+    "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-types",
+    "@happyvertical/smrt-ui",
+    "@happyvertical/smrt-vitest"
+  ],
+  "sdkDependencies": [
+    "@happyvertical/logger",
+    "@happyvertical/sql"
+  ],
+  "tags": [],
+  "risks": [],
+  "objects": [
+    {
+      "name": "UsersCliAuthRequestCollection",
+      "qualifiedName": "@happyvertical/smrt-users:UsersCliAuthRequestCollection",
+      "collection": "userscliauthrequests",
+      "tableName": "users_cli_auth_requests",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "deleteExpired",
+        "findByDeviceCodeHash",
+        "findByUserCode"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "GroupCollection",
+      "qualifiedName": "@happyvertical/smrt-users:GroupCollection",
+      "collection": "groups",
+      "tableName": "group_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findBySlug",
+        "findByTenant"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "GroupMemberCollection",
+      "qualifiedName": "@happyvertical/smrt-users:GroupMemberCollection",
+      "collection": "groupmembers",
+      "tableName": "group_member_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "addMember",
+        "findByGroup",
+        "findByUser",
+        "getGroupIds",
+        "getGroupIdsForTenant",
+        "getUserIds",
+        "isMember",
+        "removeMember"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "GroupRoleCollection",
+      "qualifiedName": "@happyvertical/smrt-users:GroupRoleCollection",
+      "collection": "grouproles",
+      "tableName": "group_role_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "addRole",
+        "findByGroup",
+        "findByRole",
+        "getRoleIds",
+        "hasRole",
+        "removeRole"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "UsersMagicLinkTokenCollection",
+      "qualifiedName": "@happyvertical/smrt-users:UsersMagicLinkTokenCollection",
+      "collection": "usersmagiclinktokens",
+      "tableName": "users_magic_link_tokens",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "deleteExpired",
+        "findByNonce",
+        "markUsed"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "MembershipCollection",
+      "qualifiedName": "@happyvertical/smrt-users:MembershipCollection",
+      "collection": "memberships",
+      "tableName": "membership_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findActiveByTenant",
+        "findActiveByUser",
+        "findByRole",
+        "findByStatus",
+        "findByTenant",
+        "findByUser",
+        "findByUserAndTenant"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "MembershipOverrideCollection",
+      "qualifiedName": "@happyvertical/smrt-users:MembershipOverrideCollection",
+      "collection": "membershipoverrides",
+      "tableName": "membership_override_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "denyPermission",
+        "findByMembership",
+        "findDenies",
+        "findGrants",
+        "getDeniedPermissionIds",
+        "getGrantedPermissionIds",
+        "grantPermission",
+        "removeOverride",
+        "setOverride"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "PermissionCollection",
+      "qualifiedName": "@happyvertical/smrt-users:PermissionCollection",
+      "collection": "permissions",
+      "tableName": "permission_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findByCategory",
+        "findByIds",
+        "findBySlug",
+        "findOrCreate",
+        "getCategories"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "RoleCollection",
+      "qualifiedName": "@happyvertical/smrt-users:RoleCollection",
+      "collection": "roles",
+      "tableName": "role_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findBySlug",
+        "findByTenant",
+        "findSystemRoles",
+        "findTenantRoles",
+        "seedSystemRoles"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "RolePermissionCollection",
+      "qualifiedName": "@happyvertical/smrt-users:RolePermissionCollection",
+      "collection": "rolepermissions",
+      "tableName": "role_permission_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "addPermission",
+        "findByPermission",
+        "findByRole",
+        "getPermissionIds",
+        "hasPermission",
+        "removePermission"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SessionCollection",
+      "qualifiedName": "@happyvertical/smrt-users:SessionCollection",
+      "collection": "sessions",
+      "tableName": "session_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "countUserSessions",
+        "createSession",
+        "deleteExpired",
+        "deleteUserSessions",
+        "findByUser",
+        "findValidSession",
+        "getSessionData",
+        "revokeSession",
+        "revokeUserSessions",
+        "setSessionData",
+        "setSessionTenant",
+        "touch"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "TenantCollection",
+      "qualifiedName": "@happyvertical/smrt-users:TenantCollection",
+      "collection": "tenants",
+      "tableName": "tenant_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "create",
+        "createChild",
+        "findActive",
+        "findBySlug",
+        "findByStatus",
+        "findChildren",
+        "findParent",
+        "findRoots",
+        "getAncestors",
+        "getAncestorsFromRoot",
+        "getDescendants",
+        "getSiblings",
+        "getTree",
+        "isAncestorOf",
+        "isDescendantOf",
+        "makeRoot",
+        "moveToParent",
+        "validateHierarchy"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "TenantPermissionOverrideCollection",
+      "qualifiedName": "@happyvertical/smrt-users:TenantPermissionOverrideCollection",
+      "collection": "tenantpermissionoverrides",
+      "tableName": "tenant_permission_override_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "bulkSetOverrides",
+        "copyOverrides",
+        "denyPermission",
+        "findByTenant",
+        "findDenies",
+        "findGrants",
+        "findInherits",
+        "getDeniedPermissionIds",
+        "getGrantedPermissionIds",
+        "getOverridesByEffect",
+        "getOverridesByEffectBatch",
+        "grantPermission",
+        "inheritPermission",
+        "removeAllOverrides",
+        "removeOverride",
+        "setOverride"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "UserCollection",
+      "qualifiedName": "@happyvertical/smrt-users:UserCollection",
+      "collection": "users",
+      "tableName": "user_collections",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findActive",
+        "findByEmail",
+        "findByProfile",
+        "findByStatus",
+        "findPending",
+        "getOrCreateForProfile",
+        "getOrCreateFromOidc"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "UsersCliAuthRequest",
+      "qualifiedName": "@happyvertical/smrt-users:UsersCliAuthRequest",
+      "collection": "userscliauthrequests",
+      "tableName": "users_cli_auth_requests",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "userCode",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "deviceCodeHash",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "userId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sessionId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "expiresAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "approvedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Group",
+      "qualifiedName": "@happyvertical/smrt-users:Group",
+      "collection": "groups",
+      "tableName": "groups",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Tenant",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "groups.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Group",
+          "path": "/groups",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "groups.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Group",
+          "path": "/groups/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "group_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Group"
+        },
+        {
+          "kind": "cli",
+          "name": "group_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Group"
+        },
+        {
+          "kind": "cli",
+          "name": "group_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:Group"
+        },
+        {
+          "kind": "cli",
+          "name": "group_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:Group"
+        },
+        {
+          "kind": "cli",
+          "name": "group_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:Group"
+        },
+        {
+          "kind": "mcp",
+          "name": "group_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Group"
+        },
+        {
+          "kind": "mcp",
+          "name": "group_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Group"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "GroupMember",
+      "qualifiedName": "@happyvertical/smrt-users:GroupMember",
+      "collection": "groupmembers",
+      "tableName": "group_members",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "groupId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Group",
+          "columnType": "UUID"
+        },
+        {
+          "name": "userId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "User",
+          "columnType": "UUID"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "groupId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Group",
+          "columnType": "UUID"
+        },
+        {
+          "name": "userId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "User",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "groupmembers.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:GroupMember",
+          "path": "/groupmembers",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "groupmembers.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:GroupMember",
+          "path": "/groupmembers/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "groupmember_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:GroupMember"
+        },
+        {
+          "kind": "cli",
+          "name": "groupmember_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:GroupMember"
+        },
+        {
+          "kind": "cli",
+          "name": "groupmember_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:GroupMember"
+        },
+        {
+          "kind": "cli",
+          "name": "groupmember_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:GroupMember"
+        },
+        {
+          "kind": "cli",
+          "name": "groupmember_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:GroupMember"
+        },
+        {
+          "kind": "mcp",
+          "name": "groupmember_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:GroupMember"
+        },
+        {
+          "kind": "mcp",
+          "name": "groupmember_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:GroupMember"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "GroupRole",
+      "qualifiedName": "@happyvertical/smrt-users:GroupRole",
+      "collection": "grouproles",
+      "tableName": "group_roles",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "groupId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Group",
+          "columnType": "UUID"
+        },
+        {
+          "name": "roleId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Role",
+          "columnType": "UUID"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "groupId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Group",
+          "columnType": "UUID"
+        },
+        {
+          "name": "roleId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Role",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "grouproles.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:GroupRole",
+          "path": "/grouproles",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "grouproles.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:GroupRole",
+          "path": "/grouproles/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "grouprole_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:GroupRole"
+        },
+        {
+          "kind": "cli",
+          "name": "grouprole_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:GroupRole"
+        },
+        {
+          "kind": "cli",
+          "name": "grouprole_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:GroupRole"
+        },
+        {
+          "kind": "cli",
+          "name": "grouprole_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:GroupRole"
+        },
+        {
+          "kind": "cli",
+          "name": "grouprole_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:GroupRole"
+        },
+        {
+          "kind": "mcp",
+          "name": "grouprole_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:GroupRole"
+        },
+        {
+          "kind": "mcp",
+          "name": "grouprole_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:GroupRole"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "UsersMagicLinkToken",
+      "qualifiedName": "@happyvertical/smrt-users:UsersMagicLinkToken",
+      "collection": "usersmagiclinktokens",
+      "tableName": "users_magic_link_tokens",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "nonce",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "email",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "used",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "expiresAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "isExpired",
+        "isValid"
+      ],
+      "surfaces": [
+        {
+          "kind": "cli",
+          "name": "usersmagiclinktoken_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+        },
+        {
+          "kind": "cli",
+          "name": "usersmagiclinktoken_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+        },
+        {
+          "kind": "cli",
+          "name": "usersmagiclinktoken_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+        },
+        {
+          "kind": "cli",
+          "name": "usersmagiclinktoken_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+        },
+        {
+          "kind": "cli",
+          "name": "usersmagiclinktoken_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Membership",
+      "qualifiedName": "@happyvertical/smrt-users:Membership",
+      "collection": "memberships",
+      "tableName": "memberships",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "userId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "User",
+          "columnType": "UUID"
+        },
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "roleId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Role",
+          "columnType": "UUID"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "userId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "User",
+          "columnType": "UUID"
+        },
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "roleId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Role",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "isActive",
+        "isPending"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "memberships.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Membership",
+          "path": "/memberships",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "memberships.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Membership",
+          "path": "/memberships/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "membership_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Membership"
+        },
+        {
+          "kind": "cli",
+          "name": "membership_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Membership"
+        },
+        {
+          "kind": "cli",
+          "name": "membership_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:Membership"
+        },
+        {
+          "kind": "cli",
+          "name": "membership_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:Membership"
+        },
+        {
+          "kind": "cli",
+          "name": "membership_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:Membership"
+        },
+        {
+          "kind": "mcp",
+          "name": "membership_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Membership"
+        },
+        {
+          "kind": "mcp",
+          "name": "membership_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Membership"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "MembershipOverride",
+      "qualifiedName": "@happyvertical/smrt-users:MembershipOverride",
+      "collection": "membershipoverrides",
+      "tableName": "membership_overrides",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "membershipId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Membership",
+          "columnType": "UUID"
+        },
+        {
+          "name": "permissionId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Permission",
+          "columnType": "UUID"
+        },
+        {
+          "name": "effect",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "membershipId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Membership",
+          "columnType": "UUID"
+        },
+        {
+          "name": "permissionId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Permission",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "isDeny",
+        "isGrant"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "membershipoverrides.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride",
+          "path": "/membershipoverrides",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "membershipoverrides.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride",
+          "path": "/membershipoverrides/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "membershipoverride_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "membershipoverride_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "membershipoverride_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "membershipoverride_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "membershipoverride_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride"
+        },
+        {
+          "kind": "mcp",
+          "name": "membershipoverride_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride"
+        },
+        {
+          "kind": "mcp",
+          "name": "membershipoverride_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:MembershipOverride"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Permission",
+      "qualifiedName": "@happyvertical/smrt-users:Permission",
+      "collection": "permissions",
+      "tableName": "permissions",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "category",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "getAction",
+        "getResource",
+        "isValidSlug",
+        "parseSlug"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "permissions.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Permission",
+          "path": "/permissions",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "permissions.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Permission",
+          "path": "/permissions/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "permission_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Permission"
+        },
+        {
+          "kind": "cli",
+          "name": "permission_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Permission"
+        },
+        {
+          "kind": "cli",
+          "name": "permission_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:Permission"
+        },
+        {
+          "kind": "cli",
+          "name": "permission_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:Permission"
+        },
+        {
+          "kind": "cli",
+          "name": "permission_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:Permission"
+        },
+        {
+          "kind": "mcp",
+          "name": "permission_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Permission"
+        },
+        {
+          "kind": "mcp",
+          "name": "permission_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Permission"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Role",
+      "qualifiedName": "@happyvertical/smrt-users:Role",
+      "collection": "roles",
+      "tableName": "roles",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "isSystem",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Tenant",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "canDelete",
+        "delete",
+        "isSystemRole",
+        "isTenantRole"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "roles.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Role",
+          "path": "/roles",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "roles.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Role",
+          "path": "/roles/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "role_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Role"
+        },
+        {
+          "kind": "cli",
+          "name": "role_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Role"
+        },
+        {
+          "kind": "cli",
+          "name": "role_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:Role"
+        },
+        {
+          "kind": "cli",
+          "name": "role_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:Role"
+        },
+        {
+          "kind": "cli",
+          "name": "role_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:Role"
+        },
+        {
+          "kind": "mcp",
+          "name": "role_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Role"
+        },
+        {
+          "kind": "mcp",
+          "name": "role_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Role"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "RolePermission",
+      "qualifiedName": "@happyvertical/smrt-users:RolePermission",
+      "collection": "rolepermissions",
+      "tableName": "role_permissions",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "roleId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Role",
+          "columnType": "UUID"
+        },
+        {
+          "name": "permissionId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Permission",
+          "columnType": "UUID"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "roleId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Role",
+          "columnType": "UUID"
+        },
+        {
+          "name": "permissionId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Permission",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "rolepermissions.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:RolePermission",
+          "path": "/rolepermissions",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "rolepermissions.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:RolePermission",
+          "path": "/rolepermissions/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "rolepermission_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:RolePermission"
+        },
+        {
+          "kind": "cli",
+          "name": "rolepermission_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:RolePermission"
+        },
+        {
+          "kind": "cli",
+          "name": "rolepermission_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:RolePermission"
+        },
+        {
+          "kind": "cli",
+          "name": "rolepermission_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:RolePermission"
+        },
+        {
+          "kind": "cli",
+          "name": "rolepermission_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:RolePermission"
+        },
+        {
+          "kind": "mcp",
+          "name": "rolepermission_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:RolePermission"
+        },
+        {
+          "kind": "mcp",
+          "name": "rolepermission_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:RolePermission"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Session",
+      "qualifiedName": "@happyvertical/smrt-users:Session",
+      "collection": "sessions",
+      "tableName": "sessions",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "userId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "User",
+          "columnType": "UUID"
+        },
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "expiresAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "userAgent",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "ipAddress",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "lastAccessedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "data",
+          "type": "json",
+          "required": false,
+          "columnType": "JSON"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "userId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "User",
+          "columnType": "UUID"
+        },
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Tenant",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "extend",
+        "getData",
+        "isExpired",
+        "isRevoked",
+        "isValid",
+        "removeData",
+        "revoke",
+        "setData",
+        "setTenant",
+        "touch"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "sessions.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Session",
+          "path": "/sessions/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "sessions.delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:Session",
+          "path": "/sessions/[id]",
+          "method": "DELETE"
+        },
+        {
+          "kind": "cli",
+          "name": "session_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Session"
+        },
+        {
+          "kind": "cli",
+          "name": "session_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Session"
+        },
+        {
+          "kind": "cli",
+          "name": "session_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:Session"
+        },
+        {
+          "kind": "cli",
+          "name": "session_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:Session"
+        },
+        {
+          "kind": "cli",
+          "name": "session_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:Session"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Tenant",
+      "qualifiedName": "@happyvertical/smrt-users:Tenant",
+      "collection": "tenants",
+      "tableName": "tenants",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "created_at",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "updated_at",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "parentTenantId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "hierarchyLevel",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "hierarchyPath",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "cascadePermissions",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "inheritPermissions",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "parentTenantId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Tenant",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "acceptsInheritance",
+        "canCascadeToChildren",
+        "classifyConstraintError",
+        "clearEmbeddings",
+        "delete",
+        "describe",
+        "destroy",
+        "do",
+        "executeToolCall",
+        "forget",
+        "forgetScope",
+        "generateEmbeddings",
+        "getAiUsageSnapshot",
+        "getAncestorIds",
+        "getAvailableTools",
+        "getEmbedding",
+        "getFields",
+        "getId",
+        "getRelated",
+        "getSavedId",
+        "getSlug",
+        "hasStaleEmbeddings",
+        "initialize",
+        "is",
+        "isActive",
+        "isRelatedLoaded",
+        "isRoot",
+        "isSaved",
+        "isSuspended",
+        "listAiUsage",
+        "loadDataFromDb",
+        "loadFromId",
+        "loadFromSlug",
+        "loadRelated",
+        "loadRelatedMany",
+        "markAsPersisted",
+        "recall",
+        "recallAll",
+        "remember",
+        "resetAiUsage",
+        "save",
+        "summarizeAiUsage",
+        "toJSON",
+        "toPlainObject",
+        "toPublicJSON"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "tenants.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Tenant",
+          "path": "/tenants",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "tenants.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Tenant",
+          "path": "/tenants/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "tenant_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Tenant"
+        },
+        {
+          "kind": "cli",
+          "name": "tenant_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Tenant"
+        },
+        {
+          "kind": "cli",
+          "name": "tenant_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:Tenant"
+        },
+        {
+          "kind": "cli",
+          "name": "tenant_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:Tenant"
+        },
+        {
+          "kind": "cli",
+          "name": "tenant_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:Tenant"
+        },
+        {
+          "kind": "mcp",
+          "name": "tenant_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:Tenant"
+        },
+        {
+          "kind": "mcp",
+          "name": "tenant_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:Tenant"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "TenantPermissionOverride",
+      "qualifiedName": "@happyvertical/smrt-users:TenantPermissionOverride",
+      "collection": "tenantpermissionoverrides",
+      "tableName": "tenant_permission_overrides",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "permissionId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Permission",
+          "columnType": "UUID"
+        },
+        {
+          "name": "effect",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "tenantId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Tenant",
+          "columnType": "UUID"
+        },
+        {
+          "name": "permissionId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Permission",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "hasExplicitEffect",
+        "isDeny",
+        "isGrant",
+        "isInherit"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "tenantpermissionoverrides.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride",
+          "path": "/tenantpermissionoverrides",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "tenantpermissionoverrides.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride",
+          "path": "/tenantpermissionoverrides/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "tenantpermissionoverride_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "tenantpermissionoverride_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "tenantpermissionoverride_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "tenantpermissionoverride_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+        },
+        {
+          "kind": "cli",
+          "name": "tenantpermissionoverride_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+        },
+        {
+          "kind": "mcp",
+          "name": "tenantpermissionoverride_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+        },
+        {
+          "kind": "mcp",
+          "name": "tenantpermissionoverride_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "User",
+      "qualifiedName": "@happyvertical/smrt-users:User",
+      "collection": "users",
+      "tableName": "users",
+      "packageName": "@happyvertical/smrt-users",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        },
+        {
+          "name": "email",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "lastLoginAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "profileId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-profiles:Profile",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "hasValidEmail",
+        "isActive",
+        "isPending",
+        "isSuspended",
+        "recordLogin"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "users.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:User",
+          "path": "/users",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "users.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:User",
+          "path": "/users/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "user_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:User"
+        },
+        {
+          "kind": "cli",
+          "name": "user_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:User"
+        },
+        {
+          "kind": "cli",
+          "name": "user_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-users:User"
+        },
+        {
+          "kind": "cli",
+          "name": "user_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-users:User"
+        },
+        {
+          "kind": "cli",
+          "name": "user_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-users:User"
+        },
+        {
+          "kind": "mcp",
+          "name": "user_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-users:User"
+        },
+        {
+          "kind": "mcp",
+          "name": "user_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-users:User"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    }
+  ],
+  "surfaces": [
+    {
+      "kind": "api",
+      "name": "groups.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Group",
+      "path": "/groups",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "groups.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Group",
+      "path": "/groups/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "group_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Group"
+    },
+    {
+      "kind": "cli",
+      "name": "group_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Group"
+    },
+    {
+      "kind": "cli",
+      "name": "group_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:Group"
+    },
+    {
+      "kind": "cli",
+      "name": "group_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:Group"
+    },
+    {
+      "kind": "cli",
+      "name": "group_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:Group"
+    },
+    {
+      "kind": "mcp",
+      "name": "group_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Group"
+    },
+    {
+      "kind": "mcp",
+      "name": "group_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Group"
+    },
+    {
+      "kind": "api",
+      "name": "groupmembers.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:GroupMember",
+      "path": "/groupmembers",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "groupmembers.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:GroupMember",
+      "path": "/groupmembers/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "groupmember_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:GroupMember"
+    },
+    {
+      "kind": "cli",
+      "name": "groupmember_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:GroupMember"
+    },
+    {
+      "kind": "cli",
+      "name": "groupmember_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:GroupMember"
+    },
+    {
+      "kind": "cli",
+      "name": "groupmember_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:GroupMember"
+    },
+    {
+      "kind": "cli",
+      "name": "groupmember_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:GroupMember"
+    },
+    {
+      "kind": "mcp",
+      "name": "groupmember_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:GroupMember"
+    },
+    {
+      "kind": "mcp",
+      "name": "groupmember_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:GroupMember"
+    },
+    {
+      "kind": "api",
+      "name": "grouproles.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:GroupRole",
+      "path": "/grouproles",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "grouproles.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:GroupRole",
+      "path": "/grouproles/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "grouprole_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:GroupRole"
+    },
+    {
+      "kind": "cli",
+      "name": "grouprole_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:GroupRole"
+    },
+    {
+      "kind": "cli",
+      "name": "grouprole_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:GroupRole"
+    },
+    {
+      "kind": "cli",
+      "name": "grouprole_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:GroupRole"
+    },
+    {
+      "kind": "cli",
+      "name": "grouprole_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:GroupRole"
+    },
+    {
+      "kind": "mcp",
+      "name": "grouprole_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:GroupRole"
+    },
+    {
+      "kind": "mcp",
+      "name": "grouprole_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:GroupRole"
+    },
+    {
+      "kind": "cli",
+      "name": "usersmagiclinktoken_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+    },
+    {
+      "kind": "cli",
+      "name": "usersmagiclinktoken_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+    },
+    {
+      "kind": "cli",
+      "name": "usersmagiclinktoken_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+    },
+    {
+      "kind": "cli",
+      "name": "usersmagiclinktoken_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+    },
+    {
+      "kind": "cli",
+      "name": "usersmagiclinktoken_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:UsersMagicLinkToken"
+    },
+    {
+      "kind": "api",
+      "name": "memberships.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Membership",
+      "path": "/memberships",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "memberships.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Membership",
+      "path": "/memberships/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "membership_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Membership"
+    },
+    {
+      "kind": "cli",
+      "name": "membership_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Membership"
+    },
+    {
+      "kind": "cli",
+      "name": "membership_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:Membership"
+    },
+    {
+      "kind": "cli",
+      "name": "membership_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:Membership"
+    },
+    {
+      "kind": "cli",
+      "name": "membership_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:Membership"
+    },
+    {
+      "kind": "mcp",
+      "name": "membership_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Membership"
+    },
+    {
+      "kind": "mcp",
+      "name": "membership_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Membership"
+    },
+    {
+      "kind": "api",
+      "name": "membershipoverrides.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride",
+      "path": "/membershipoverrides",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "membershipoverrides.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride",
+      "path": "/membershipoverrides/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "membershipoverride_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "membershipoverride_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "membershipoverride_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "membershipoverride_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "membershipoverride_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride"
+    },
+    {
+      "kind": "mcp",
+      "name": "membershipoverride_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride"
+    },
+    {
+      "kind": "mcp",
+      "name": "membershipoverride_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:MembershipOverride"
+    },
+    {
+      "kind": "api",
+      "name": "permissions.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Permission",
+      "path": "/permissions",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "permissions.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Permission",
+      "path": "/permissions/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "permission_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Permission"
+    },
+    {
+      "kind": "cli",
+      "name": "permission_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Permission"
+    },
+    {
+      "kind": "cli",
+      "name": "permission_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:Permission"
+    },
+    {
+      "kind": "cli",
+      "name": "permission_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:Permission"
+    },
+    {
+      "kind": "cli",
+      "name": "permission_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:Permission"
+    },
+    {
+      "kind": "mcp",
+      "name": "permission_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Permission"
+    },
+    {
+      "kind": "mcp",
+      "name": "permission_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Permission"
+    },
+    {
+      "kind": "api",
+      "name": "roles.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Role",
+      "path": "/roles",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "roles.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Role",
+      "path": "/roles/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "role_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Role"
+    },
+    {
+      "kind": "cli",
+      "name": "role_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Role"
+    },
+    {
+      "kind": "cli",
+      "name": "role_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:Role"
+    },
+    {
+      "kind": "cli",
+      "name": "role_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:Role"
+    },
+    {
+      "kind": "cli",
+      "name": "role_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:Role"
+    },
+    {
+      "kind": "mcp",
+      "name": "role_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Role"
+    },
+    {
+      "kind": "mcp",
+      "name": "role_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Role"
+    },
+    {
+      "kind": "api",
+      "name": "rolepermissions.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:RolePermission",
+      "path": "/rolepermissions",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "rolepermissions.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:RolePermission",
+      "path": "/rolepermissions/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "rolepermission_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:RolePermission"
+    },
+    {
+      "kind": "cli",
+      "name": "rolepermission_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:RolePermission"
+    },
+    {
+      "kind": "cli",
+      "name": "rolepermission_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:RolePermission"
+    },
+    {
+      "kind": "cli",
+      "name": "rolepermission_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:RolePermission"
+    },
+    {
+      "kind": "cli",
+      "name": "rolepermission_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:RolePermission"
+    },
+    {
+      "kind": "mcp",
+      "name": "rolepermission_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:RolePermission"
+    },
+    {
+      "kind": "mcp",
+      "name": "rolepermission_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:RolePermission"
+    },
+    {
+      "kind": "api",
+      "name": "sessions.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Session",
+      "path": "/sessions/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "sessions.delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:Session",
+      "path": "/sessions/[id]",
+      "method": "DELETE"
+    },
+    {
+      "kind": "cli",
+      "name": "session_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Session"
+    },
+    {
+      "kind": "cli",
+      "name": "session_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Session"
+    },
+    {
+      "kind": "cli",
+      "name": "session_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:Session"
+    },
+    {
+      "kind": "cli",
+      "name": "session_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:Session"
+    },
+    {
+      "kind": "cli",
+      "name": "session_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:Session"
+    },
+    {
+      "kind": "api",
+      "name": "tenants.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Tenant",
+      "path": "/tenants",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "tenants.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Tenant",
+      "path": "/tenants/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "tenant_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Tenant"
+    },
+    {
+      "kind": "cli",
+      "name": "tenant_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Tenant"
+    },
+    {
+      "kind": "cli",
+      "name": "tenant_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:Tenant"
+    },
+    {
+      "kind": "cli",
+      "name": "tenant_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:Tenant"
+    },
+    {
+      "kind": "cli",
+      "name": "tenant_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:Tenant"
+    },
+    {
+      "kind": "mcp",
+      "name": "tenant_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:Tenant"
+    },
+    {
+      "kind": "mcp",
+      "name": "tenant_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:Tenant"
+    },
+    {
+      "kind": "api",
+      "name": "tenantpermissionoverrides.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride",
+      "path": "/tenantpermissionoverrides",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "tenantpermissionoverrides.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride",
+      "path": "/tenantpermissionoverrides/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "tenantpermissionoverride_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "tenantpermissionoverride_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "tenantpermissionoverride_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "tenantpermissionoverride_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+    },
+    {
+      "kind": "cli",
+      "name": "tenantpermissionoverride_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+    },
+    {
+      "kind": "mcp",
+      "name": "tenantpermissionoverride_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+    },
+    {
+      "kind": "mcp",
+      "name": "tenantpermissionoverride_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:TenantPermissionOverride"
+    },
+    {
+      "kind": "api",
+      "name": "users.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:User",
+      "path": "/users",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "users.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:User",
+      "path": "/users/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "user_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:User"
+    },
+    {
+      "kind": "cli",
+      "name": "user_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:User"
+    },
+    {
+      "kind": "cli",
+      "name": "user_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-users:User"
+    },
+    {
+      "kind": "cli",
+      "name": "user_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-users:User"
+    },
+    {
+      "kind": "cli",
+      "name": "user_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-users:User"
+    },
+    {
+      "kind": "mcp",
+      "name": "user_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-users:User"
+    },
+    {
+      "kind": "mcp",
+      "name": "user_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-users:User"
+    }
+  ],
+  "prompts": [],
+  "relationshipsV2": {
+    "foreignKeyFields": 18,
+    "crossPackageRefFields": 1,
+    "junctionCollections": 0,
+    "hierarchicalObjects": 0,
+    "polymorphicAssociations": 0,
+    "uuidColumns": 47
+  },
+  "agentDoc": "# @happyvertical/smrt-users\n\nMulti-tenant user management with RBAC, hierarchical tenants, session handling, and SvelteKit integration.\n\n## Models (13)\n\n| Model | Key Pattern |\n|-------|-------------|\n| User | Auth identity. `profileId` is plain string (not FK) to smrt-profiles. Email auto-lowercased. |\n| Tenant | **STI** + hierarchical parent-child. `hierarchyPath` (materialized path), `hierarchyLevel`. Max depth 10. |\n| Session | Server-side. Secure UUID. TTL in **seconds** (not ms). Status auto-updates to EXPIRED on access. |\n| MagicLinkToken | Single-use email login token. Backed by `MagicLinkService`. |\n| Role | `tenantId = null` → system role (available to all tenants). `isSystem: true` blocks deletion. |\n| Permission | Slug format: `resource.action`. Parsed by PermissionResolver. |\n| Membership | User + Tenant + Role junction. UNIQUE(userId, tenantId). |\n| Group | Team within a tenant. Multiple roles via GroupRole. |\n| GroupMember, GroupRole, RolePermission | Join tables. |\n| MembershipOverride | Per-user permission grant/deny. **DENY always wins.** |\n| TenantPermissionOverride | Tenant-level cascade overrides. Effect: INHERIT/GRANT/DENY. |\n\n## Permission Resolution — 4-Level Cascade\n\nPermissionResolver evaluates in order (each level can add/remove permissions):\n\n1. **Tenant hierarchy** — walk ancestors, apply TenantPermissionOverride at each level\n2. **Membership role** — base permissions from user's role in tenant\n3. **Group roles** — permissions from all groups user belongs to **in that tenant**\n4. **Membership overrides** — final GRANT/DENY per-user (DENY takes absolute precedence)\n\n**Critical**: `getGroupIdsForTenant(userId, tenantId)` (joins with groups table to scope by tenant). Never use `getGroupIds()` — it's cross-tenant.\n\n## Hierarchical Tenants\n\n- `TenantCollection.createChild()` auto-calculates hierarchy fields, enforces depth limit\n- `moveToParent()` updates tenant + ALL descendants' paths/levels\n- `cascadePermissions` (parent pushes down) + `inheritPermissions` (child accepts) — both must be true\n- `getTree(rootId?)` returns nested structure for UI\n\n## SvelteKit Integration\n\n```typescript\n// hooks.server.ts\nexport const handle = createSessionHandler({ db, ttl: 604800, skipPaths: ['/api/public'] });\n// Populates event.locals: { user, membership, permissions: string[], tenantId, sessionId }\n\n// +page.server.ts\nawait createSessionCookie(event, userId, tenantId, { db });\nawait destroySessionCookie(event, { db });\nawait switchSessionTenant(event, tenantId, { db });\n```\n\n## Security (S5 #1400)\n\n- **Generated REST/MCP surface is READ-ONLY for every RBAC/identity model.**\n  User, Tenant, Group, Membership, MembershipOverride, Role, Permission,\n  RolePermission, GroupRole, GroupMember, and TenantPermissionOverride generate\n  `list`/`get` only — `create`/`update`/`delete` are intentionally NOT\n  generated. The merged `requireRouteAuth` gate (#1540) enforces *authentication*,\n  not *authorization*, and these models are not `@TenantScoped`, so an\n  auto-generated mutating route would let any authenticated user self-grant a\n  role/permission, flip a tenant's cascade flags, or change another user's auth\n  identity. Mutate them through the permission-gated services (`TenantService`,\n  collection helpers) or consumer-owned, permission-checked handlers. A\n  structural regression test (`security-audit-1400.test.ts`) enumerates the\n  registry to assert no authority model exposes a mutating op. (`cli` stays\n  enabled — local-operator surface, outside the network/agent threat model.)\n- **`switchTenant` is fail-closed.** `SessionService.switchTenant` /\n  `switchSessionTenant` verify the session's user has an ACTIVE membership in the\n  target tenant before writing `session.tenantId` (the tenant-isolation key for\n  every `@TenantScoped` query). A non-member switch returns `false` without\n  mutating the session; `null` clears the context and is always allowed. The\n  low-level `SessionCollection.setSessionTenant` is the UNGUARDED primitive —\n  never call it with an untrusted tenant id.\n- **OIDC `email_verified` is enforced.** `UserCollection.getOrCreateFromOidc`\n  refuses to provision a user when the IdP explicitly returns\n  `email_verified: false` (opt out with `{ allowUnverifiedEmail: true }`). An\n  absent claim makes no assertion and is not enforced.\n\n## Gotchas\n\n- **seedSystemRoles() required**: call `RoleCollection.seedSystemRoles()` at app init (creates owner/admin/member/viewer)\n- **PermissionResolver casts `as any`**: collections have protected constructors — known framework limitation\n- **Session TTL in seconds**: `DEFAULT_SESSION_TTL = 7 * 24 * 60 * 60` (not milliseconds)\n- **Users are cross-tenant**: one user, many tenants via Membership. Email globally unique.\n- **Batch permission queries**: resolver fetches all permission IDs in one query, then maps to slugs (avoids N+1)\n"
+}