npm - @happyvertical/smrt-education - Versions diffs - 0.57.41 → 0.57.43 - Mend

@happyvertical/smrt-education 0.57.41 → 0.57.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/AGENTS.md +8 -0
package/README.md +10 -0
package/agents/group-sharing.md +278 -0
package/agents/submission-service.md +10 -0
package/dist/chunks/{workbook-photo-service-D5DUgh-C.js → workbook-photo-service-C6mbUUp6.js} +196 -65
package/dist/chunks/workbook-photo-service-C6mbUUp6.js.map +1 -0
package/dist/group-sharing-authorization.d.ts +67 -0
package/dist/group-sharing-authorization.d.ts.map +1 -0
package/dist/group-sharing-comments.d.ts +30 -0
package/dist/group-sharing-comments.d.ts.map +1 -0
package/dist/group-sharing-contracts.d.ts +201 -0
package/dist/group-sharing-contracts.d.ts.map +1 -0
package/dist/group-sharing-hash.d.ts +3 -0
package/dist/group-sharing-hash.d.ts.map +1 -0
package/dist/group-sharing-models.d.ts +106 -0
package/dist/group-sharing-models.d.ts.map +1 -0
package/dist/group-sharing-policy.d.ts +19 -0
package/dist/group-sharing-policy.d.ts.map +1 -0
package/dist/group-sharing-reader.d.ts +45 -0
package/dist/group-sharing-reader.d.ts.map +1 -0
package/dist/group-sharing-service.d.ts +108 -0
package/dist/group-sharing-service.d.ts.map +1 -0
package/dist/group-sharing-workspace.d.ts +10 -0
package/dist/group-sharing-workspace.d.ts.map +1 -0
package/dist/index.d.ts +8 -1
package/dist/index.d.ts.map +1 -1
package/dist/index.js +2032 -69
package/dist/index.js.map +1 -1
package/dist/ingestion.js +1 -1
package/dist/manifest.json +2728 -1
package/dist/recipes.d.ts +24 -0
package/dist/recipes.d.ts.map +1 -1
package/dist/smrt-knowledge.json +1073 -12
package/dist/submission-service.d.ts +2 -0
package/dist/submission-service.d.ts.map +1 -1
package/dist/workbook-service.d.ts.map +1 -1
package/package.json +9 -9
package/dist/chunks/workbook-photo-service-D5DUgh-C.js.map +0 -1

package/dist/manifest.json CHANGED Viewed

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-education",
-  "packageVersion": "0.57.41",
+  "packageVersion": "0.57.43",
   "objects": {
     "@happyvertical/smrt-education:CatalogProviderCollection": {
       "name": "catalogprovidercollection",
@@ -9785,6 +9785,2688 @@
       },
       "importPath": "@happyvertical/smrt-education"
     },
+    "@happyvertical/smrt-education:EducationGroup": {
+      "name": "educationgroup",
+      "className": "EducationGroup",
+      "qualifiedName": "@happyvertical/smrt-education:EducationGroup",
+      "collection": "educationgroups",
+      "description": "Independent group tenant metadata; no family authority is implied.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "name": {
+          "type": "text",
+          "required": false
+        },
+        "active": {
+          "type": "boolean",
+          "required": true,
+          "default": true
+        },
+        "creatorUserId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:User"
+        },
+        "creatorProfileId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile"
+        }
+      },
+      "methods": {
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "education_groups",
+        "conflictColumns": [
+          "tenant_id"
+        ],
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "ai": {
+          "callable": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "EducationGroup",
+      "collectionExportName": "EducationGroupCollection",
+      "displayLabelField": "name",
+      "validationRules": [
+        {
+          "field": "active",
+          "rule": "required",
+          "fieldType": "boolean"
+        },
+        {
+          "field": "creatorUserId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        },
+        {
+          "field": "creatorProfileId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        }
+      ],
+      "schema": {
+        "tableName": "education_groups",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"education_groups\" (\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  \"name\" TEXT,\n  \"active\" BOOLEAN NOT NULL DEFAULT TRUE,\n  \"creator_user_id\" UUID NOT NULL,\n  \"creator_profile_id\" UUID NOT NULL\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
+          },
+          "name": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "active": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": true
+          },
+          "creator_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "creator_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "education_groups_tenant_id_idx",
+            "columns": [
+              "tenant_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "education_groups_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "education_groups_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "education_groups_creator_user_id_idx",
+            "columns": [
+              "creator_user_id"
+            ]
+          },
+          {
+            "name": "education_groups_creator_profile_id_idx",
+            "columns": [
+              "creator_profile_id"
+            ]
+          }
+        ],
+        "version": "6e17e39b"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:EducationGroupCollection": {
+      "name": "educationgroupcollection",
+      "className": "EducationGroupCollection",
+      "qualifiedName": "@happyvertical/smrt-education:EducationGroupCollection",
+      "collection": "educationgroups",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "education_groups",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "EducationGroup",
+      "exportName": "EducationGroupCollection",
+      "collectionExportName": "EducationGroupCollectionCollection",
+      "schema": {
+        "tableName": "education_groups",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"education_groups\" (\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  \"name\" TEXT,\n  \"active\" BOOLEAN NOT NULL DEFAULT TRUE,\n  \"creator_user_id\" UUID NOT NULL,\n  \"creator_profile_id\" UUID NOT NULL\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
+          },
+          "name": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "active": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": true
+          },
+          "creator_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "creator_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "education_groups_tenant_id_idx",
+            "columns": [
+              "tenant_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "education_groups_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "education_groups_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "education_groups_creator_user_id_idx",
+            "columns": [
+              "creator_user_id"
+            ]
+          },
+          {
+            "name": "education_groups_creator_profile_id_idx",
+            "columns": [
+              "creator_profile_id"
+            ]
+          }
+        ],
+        "version": "6e17e39b"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupLearnerInvitation": {
+      "name": "grouplearnerinvitation",
+      "className": "GroupLearnerInvitation",
+      "qualifiedName": "@happyvertical/smrt-education:GroupLearnerInvitation",
+      "collection": "grouplearnerinvitations",
+      "description": "Group-owned target selectors are opaque until the exact parent accepts.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "groupId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "EducationGroup",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "familyTenantId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:Tenant"
+        },
+        "learnerId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "required": true
+          }
+        },
+        "invitedParentUserId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:User"
+        },
+        "creatorUserId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:User"
+        },
+        "expiresAt": {
+          "type": "text",
+          "required": false
+        },
+        "status": {
+          "type": "text",
+          "required": false,
+          "default": "pending",
+          "enum": [
+            "pending",
+            "accepted",
+            "revoked",
+            "declined"
+          ]
+        },
+        "acceptedMembershipId": {
+          "type": "foreignKey",
+          "required": false,
+          "related": "GroupLearnerMembership",
+          "_meta": {
+            "nullable": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "acceptedPolicyDigest": {
+          "type": "text",
+          "required": false
+        }
+      },
+      "methods": {
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "group_learner_invitations",
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "ai": {
+          "callable": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
+      },
+      "extends": "SmrtObject",
+      "exportName": "GroupLearnerInvitation",
+      "collectionExportName": "GroupLearnerInvitationCollection",
+      "validationRules": [
+        {
+          "field": "groupId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "familyTenantId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        },
+        {
+          "field": "learnerId",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "invitedParentUserId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        },
+        {
+          "field": "creatorUserId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        }
+      ],
+      "schema": {
+        "tableName": "group_learner_invitations",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_learner_invitations\" (\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  \"group_id\" UUID NOT NULL,\n  \"family_tenant_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"invited_parent_user_id\" UUID NOT NULL,\n  \"creator_user_id\" UUID NOT NULL,\n  \"expires_at\" TEXT,\n  \"status\" TEXT DEFAULT 'pending',\n  \"accepted_membership_id\" UUID,\n  \"accepted_policy_digest\" TEXT\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
+          },
+          "group_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "education_groups",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "family_tenant_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "learner_id": {
+            "type": "UUID",
+            "notNull": true,
+            "unique": false
+          },
+          "invited_parent_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "creator_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "expires_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "status": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": "pending"
+          },
+          "accepted_membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "accepted_policy_digest": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_learner_invitations_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_learner_invitations_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_group_id_idx",
+            "columns": [
+              "group_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_family_tenant_id_idx",
+            "columns": [
+              "family_tenant_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_invited_parent_user_id_idx",
+            "columns": [
+              "invited_parent_user_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_creator_user_id_idx",
+            "columns": [
+              "creator_user_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_accepted_membership_id_idx",
+            "columns": [
+              "accepted_membership_id"
+            ]
+          }
+        ],
+        "version": "fd61d2dd"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupLearnerInvitationCollection": {
+      "name": "grouplearnerinvitationcollection",
+      "className": "GroupLearnerInvitationCollection",
+      "qualifiedName": "@happyvertical/smrt-education:GroupLearnerInvitationCollection",
+      "collection": "grouplearnerinvitations",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "group_learner_invitations",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "GroupLearnerInvitation",
+      "exportName": "GroupLearnerInvitationCollection",
+      "collectionExportName": "GroupLearnerInvitationCollectionCollection",
+      "schema": {
+        "tableName": "group_learner_invitations",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_learner_invitations\" (\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  \"group_id\" UUID NOT NULL,\n  \"family_tenant_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"invited_parent_user_id\" UUID NOT NULL,\n  \"creator_user_id\" UUID NOT NULL,\n  \"expires_at\" TEXT,\n  \"status\" TEXT DEFAULT 'pending',\n  \"accepted_membership_id\" UUID,\n  \"accepted_policy_digest\" TEXT\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
+          },
+          "group_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "education_groups",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "family_tenant_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "learner_id": {
+            "type": "UUID",
+            "notNull": true,
+            "unique": false
+          },
+          "invited_parent_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "creator_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "expires_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "status": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": "pending"
+          },
+          "accepted_membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": false,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "accepted_policy_digest": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_learner_invitations_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_learner_invitations_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_group_id_idx",
+            "columns": [
+              "group_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_family_tenant_id_idx",
+            "columns": [
+              "family_tenant_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_invited_parent_user_id_idx",
+            "columns": [
+              "invited_parent_user_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_creator_user_id_idx",
+            "columns": [
+              "creator_user_id"
+            ]
+          },
+          {
+            "name": "group_learner_invitations_accepted_membership_id_idx",
+            "columns": [
+              "accepted_membership_id"
+            ]
+          }
+        ],
+        "version": "fd61d2dd"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupLearnerMembership": {
+      "name": "grouplearnermembership",
+      "className": "GroupLearnerMembership",
+      "qualifiedName": "@happyvertical/smrt-education:GroupLearnerMembership",
+      "collection": "grouplearnermemberships",
+      "description": "Family-owned per-child consent edge, never a users membership.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "groupId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "EducationGroup",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "learnerId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "Learner",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "consentParentUserId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:User"
+        },
+        "status": {
+          "type": "text",
+          "required": false,
+          "default": "active",
+          "enum": [
+            "active",
+            "revoked"
+          ]
+        },
+        "policyVersion": {
+          "type": "integer",
+          "required": true,
+          "default": 1,
+          "min": 1,
+          "_meta": {
+            "min": 1,
+            "required": true
+          }
+        }
+      },
+      "methods": {
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "group_learner_memberships",
+        "conflictColumns": [
+          "tenant_id",
+          "learner_id",
+          "group_id"
+        ],
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "ai": {
+          "callable": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "GroupLearnerMembership",
+      "collectionExportName": "GroupLearnerMembershipCollection",
+      "validationRules": [
+        {
+          "field": "groupId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "learnerId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "consentParentUserId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        },
+        {
+          "field": "policyVersion",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "policyVersion",
+          "rule": "min",
+          "value": 1,
+          "fieldType": "integer"
+        }
+      ],
+      "schema": {
+        "tableName": "group_learner_memberships",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_learner_memberships\" (\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  \"group_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"consent_parent_user_id\" UUID NOT NULL,\n  \"status\" TEXT DEFAULT 'active',\n  \"policy_version\" INTEGER NOT NULL DEFAULT 1\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
+          },
+          "group_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "education_groups",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "learner_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "learners",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "consent_parent_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "status": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": "active"
+          },
+          "policy_version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 1
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_learner_memberships_tenant_id_learner_id_idx",
+            "columns": [
+              "tenant_id",
+              "learner_id",
+              "group_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_learner_memberships_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_group_id_idx",
+            "columns": [
+              "group_id"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_learner_id_idx",
+            "columns": [
+              "learner_id"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_consent_parent_user_id_idx",
+            "columns": [
+              "consent_parent_user_id"
+            ]
+          }
+        ],
+        "version": "86b9feeb"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupLearnerMembershipCollection": {
+      "name": "grouplearnermembershipcollection",
+      "className": "GroupLearnerMembershipCollection",
+      "qualifiedName": "@happyvertical/smrt-education:GroupLearnerMembershipCollection",
+      "collection": "grouplearnermemberships",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "group_learner_memberships",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "GroupLearnerMembership",
+      "exportName": "GroupLearnerMembershipCollection",
+      "collectionExportName": "GroupLearnerMembershipCollectionCollection",
+      "schema": {
+        "tableName": "group_learner_memberships",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_learner_memberships\" (\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  \"group_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"consent_parent_user_id\" UUID NOT NULL,\n  \"status\" TEXT DEFAULT 'active',\n  \"policy_version\" INTEGER NOT NULL DEFAULT 1\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
+          },
+          "group_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "education_groups",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "learner_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "learners",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "consent_parent_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "status": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false,
+            "default": "active"
+          },
+          "policy_version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 1
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_learner_memberships_tenant_id_learner_id_idx",
+            "columns": [
+              "tenant_id",
+              "learner_id",
+              "group_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_learner_memberships_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_group_id_idx",
+            "columns": [
+              "group_id"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_learner_id_idx",
+            "columns": [
+              "learner_id"
+            ]
+          },
+          {
+            "name": "group_learner_memberships_consent_parent_user_id_idx",
+            "columns": [
+              "consent_parent_user_id"
+            ]
+          }
+        ],
+        "version": "86b9feeb"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupSharingPolicy": {
+      "name": "groupsharingpolicy",
+      "className": "GroupSharingPolicy",
+      "qualifiedName": "@happyvertical/smrt-education:GroupSharingPolicy",
+      "collection": "groupsharingpolicies",
+      "description": "Immutable explicit policy snapshot.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "membershipId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "GroupLearnerMembership",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "version": {
+          "type": "integer",
+          "required": true,
+          "default": 1,
+          "min": 1,
+          "_meta": {
+            "min": 1,
+            "required": true
+          }
+        },
+        "schemaVersion": {
+          "type": "integer",
+          "required": true,
+          "default": 1,
+          "min": 1,
+          "max": 1,
+          "_meta": {
+            "min": 1,
+            "max": 1,
+            "required": true
+          }
+        },
+        "policyJson": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "required": true
+          }
+        },
+        "actorUserId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:User"
+        },
+        "recordedAt": {
+          "type": "text",
+          "required": false
+        }
+      },
+      "methods": {
+        "getPolicy": {
+          "name": "getPolicy",
+          "async": false,
+          "parameters": [],
+          "returnType": "GroupSharingPolicyV1",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "setPolicy": {
+          "name": "setPolicy",
+          "async": false,
+          "parameters": [
+            {
+              "name": "value",
+              "type": "unknown",
+              "optional": false
+            }
+          ],
+          "returnType": "void",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "group_sharing_policies",
+        "conflictColumns": [
+          "tenant_id",
+          "membership_id",
+          "version"
+        ],
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "ai": {
+          "callable": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "GroupSharingPolicy",
+      "collectionExportName": "GroupSharingPolicyCollection",
+      "validationRules": [
+        {
+          "field": "membershipId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "version",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "version",
+          "rule": "min",
+          "value": 1,
+          "fieldType": "integer"
+        },
+        {
+          "field": "schemaVersion",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "schemaVersion",
+          "rule": "min",
+          "value": 1,
+          "fieldType": "integer"
+        },
+        {
+          "field": "schemaVersion",
+          "rule": "max",
+          "value": 1,
+          "fieldType": "integer"
+        },
+        {
+          "field": "policyJson",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "actorUserId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        }
+      ],
+      "schema": {
+        "tableName": "group_sharing_policies",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_sharing_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  \"tenant_id\" UUID NOT NULL,\n  \"membership_id\" UUID NOT NULL,\n  \"version\" INTEGER NOT NULL DEFAULT 1,\n  \"schema_version\" INTEGER NOT NULL DEFAULT 1,\n  \"policy_json\" TEXT NOT NULL,\n  \"actor_user_id\" UUID NOT NULL,\n  \"recorded_at\" TEXT\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
+          },
+          "membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 1
+          },
+          "schema_version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 1
+          },
+          "policy_json": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false
+          },
+          "actor_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "recorded_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_sharing_policies_tenant_id_membership_id_idx",
+            "columns": [
+              "tenant_id",
+              "membership_id",
+              "version"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_sharing_policies_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "group_sharing_policies_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_sharing_policies_membership_id_idx",
+            "columns": [
+              "membership_id"
+            ]
+          },
+          {
+            "name": "group_sharing_policies_actor_user_id_idx",
+            "columns": [
+              "actor_user_id"
+            ]
+          }
+        ],
+        "version": "40a8f170"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupSharingPolicyCollection": {
+      "name": "groupsharingpolicycollection",
+      "className": "GroupSharingPolicyCollection",
+      "qualifiedName": "@happyvertical/smrt-education:GroupSharingPolicyCollection",
+      "collection": "groupsharingpolicies",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "group_sharing_policies",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "GroupSharingPolicy",
+      "exportName": "GroupSharingPolicyCollection",
+      "collectionExportName": "GroupSharingPolicyCollectionCollection",
+      "schema": {
+        "tableName": "group_sharing_policies",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_sharing_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  \"tenant_id\" UUID NOT NULL,\n  \"membership_id\" UUID NOT NULL,\n  \"version\" INTEGER NOT NULL DEFAULT 1,\n  \"schema_version\" INTEGER NOT NULL DEFAULT 1,\n  \"policy_json\" TEXT NOT NULL,\n  \"actor_user_id\" UUID NOT NULL,\n  \"recorded_at\" TEXT\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
+          },
+          "membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 1
+          },
+          "schema_version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 1
+          },
+          "policy_json": {
+            "type": "TEXT",
+            "notNull": true,
+            "unique": false
+          },
+          "actor_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "recorded_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_sharing_policies_tenant_id_membership_id_idx",
+            "columns": [
+              "tenant_id",
+              "membership_id",
+              "version"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_sharing_policies_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "group_sharing_policies_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_sharing_policies_membership_id_idx",
+            "columns": [
+              "membership_id"
+            ]
+          },
+          {
+            "name": "group_sharing_policies_actor_user_id_idx",
+            "columns": [
+              "actor_user_id"
+            ]
+          }
+        ],
+        "version": "40a8f170"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupRevisionComment": {
+      "name": "grouprevisioncomment",
+      "className": "GroupRevisionComment",
+      "qualifiedName": "@happyvertical/smrt-education:GroupRevisionComment",
+      "collection": "grouprevisioncomments",
+      "description": "Attributed revision comment, separate from grading and evidence.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "membershipId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "GroupLearnerMembership",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "learnerId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "Learner",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "activityId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "WorkbookActivity",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "attemptId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "WorkbookAttempt",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "revisionId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "WorkbookAssessmentRevision",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "authorUserId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:User"
+        },
+        "authorProfileId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-profiles:Profile"
+        },
+        "body": {
+          "type": "text",
+          "required": false
+        },
+        "recordedAt": {
+          "type": "text",
+          "required": false
+        },
+        "childVisible": {
+          "type": "boolean",
+          "required": true,
+          "default": false
+        },
+        "visibilityActorUserId": {
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-users:User",
+          "_meta": {
+            "nullable": true
+          }
+        },
+        "visibilityChangedAt": {
+          "type": "datetime",
+          "required": false
+        },
+        "visibilityVersion": {
+          "type": "integer",
+          "required": true,
+          "default": 0,
+          "min": 0,
+          "_meta": {
+            "min": 0,
+            "required": true
+          }
+        }
+      },
+      "methods": {
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "group_revision_comments",
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "ai": {
+          "callable": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        },
+        "conflictColumns": [
+          "tenant_id",
+          "slug",
+          "context"
+        ]
+      },
+      "extends": "SmrtObject",
+      "exportName": "GroupRevisionComment",
+      "collectionExportName": "GroupRevisionCommentCollection",
+      "validationRules": [
+        {
+          "field": "membershipId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "learnerId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "activityId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "attemptId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "revisionId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "authorUserId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        },
+        {
+          "field": "authorProfileId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        },
+        {
+          "field": "childVisible",
+          "rule": "required",
+          "fieldType": "boolean"
+        },
+        {
+          "field": "visibilityVersion",
+          "rule": "required",
+          "fieldType": "integer"
+        },
+        {
+          "field": "visibilityVersion",
+          "rule": "min",
+          "value": 0,
+          "fieldType": "integer"
+        }
+      ],
+      "schema": {
+        "tableName": "group_revision_comments",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_revision_comments\" (\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  \"membership_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"activity_id\" UUID NOT NULL,\n  \"attempt_id\" UUID NOT NULL,\n  \"revision_id\" UUID NOT NULL,\n  \"author_user_id\" UUID NOT NULL,\n  \"author_profile_id\" UUID NOT NULL,\n  \"body\" TEXT,\n  \"recorded_at\" TEXT,\n  \"child_visible\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"visibility_actor_user_id\" UUID,\n  \"visibility_changed_at\" TIMESTAMP,\n  \"visibility_version\" INTEGER NOT NULL DEFAULT 0\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
+          },
+          "membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "learner_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "learners",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "activity_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "workbook_activities",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "attempt_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "workbook_attempts",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "revision_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "workbook_assessment_revisions",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "author_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "author_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "body": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "recorded_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "child_visible": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": false
+          },
+          "visibility_actor_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "visibility_changed_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "visibility_version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_revision_comments_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_revision_comments_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_revision_comments_membership_id_idx",
+            "columns": [
+              "membership_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_learner_id_idx",
+            "columns": [
+              "learner_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_activity_id_idx",
+            "columns": [
+              "activity_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_attempt_id_idx",
+            "columns": [
+              "attempt_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_revision_id_idx",
+            "columns": [
+              "revision_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_author_user_id_idx",
+            "columns": [
+              "author_user_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_author_profile_id_idx",
+            "columns": [
+              "author_profile_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_visibility_actor_user_id_idx",
+            "columns": [
+              "visibility_actor_user_id"
+            ]
+          }
+        ],
+        "version": "720fccdb"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupRevisionCommentCollection": {
+      "name": "grouprevisioncommentcollection",
+      "className": "GroupRevisionCommentCollection",
+      "qualifiedName": "@happyvertical/smrt-education:GroupRevisionCommentCollection",
+      "collection": "grouprevisioncomments",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "group_revision_comments",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "GroupRevisionComment",
+      "exportName": "GroupRevisionCommentCollection",
+      "collectionExportName": "GroupRevisionCommentCollectionCollection",
+      "schema": {
+        "tableName": "group_revision_comments",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_revision_comments\" (\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  \"membership_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"activity_id\" UUID NOT NULL,\n  \"attempt_id\" UUID NOT NULL,\n  \"revision_id\" UUID NOT NULL,\n  \"author_user_id\" UUID NOT NULL,\n  \"author_profile_id\" UUID NOT NULL,\n  \"body\" TEXT,\n  \"recorded_at\" TEXT,\n  \"child_visible\" BOOLEAN NOT NULL DEFAULT FALSE,\n  \"visibility_actor_user_id\" UUID,\n  \"visibility_changed_at\" TIMESTAMP,\n  \"visibility_version\" INTEGER NOT NULL DEFAULT 0\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
+          },
+          "membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "learner_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "learners",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "activity_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "workbook_activities",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "attempt_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "workbook_attempts",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "revision_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "workbook_assessment_revisions",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "author_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "author_profile_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "body": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "recorded_at": {
+            "type": "TEXT",
+            "notNull": false,
+            "unique": false
+          },
+          "child_visible": {
+            "type": "BOOLEAN",
+            "notNull": true,
+            "unique": false,
+            "default": false
+          },
+          "visibility_actor_user_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": false,
+            "unique": false
+          },
+          "visibility_changed_at": {
+            "type": "TIMESTAMP",
+            "notNull": false,
+            "unique": false
+          },
+          "visibility_version": {
+            "type": "INTEGER",
+            "notNull": true,
+            "unique": false,
+            "default": 0
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_revision_comments_slug_context_idx",
+            "columns": [
+              "tenant_id",
+              "slug",
+              "context"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_revision_comments_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_revision_comments_membership_id_idx",
+            "columns": [
+              "membership_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_learner_id_idx",
+            "columns": [
+              "learner_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_activity_id_idx",
+            "columns": [
+              "activity_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_attempt_id_idx",
+            "columns": [
+              "attempt_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_revision_id_idx",
+            "columns": [
+              "revision_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_author_user_id_idx",
+            "columns": [
+              "author_user_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_author_profile_id_idx",
+            "columns": [
+              "author_profile_id"
+            ]
+          },
+          {
+            "name": "group_revision_comments_visibility_actor_user_id_idx",
+            "columns": [
+              "visibility_actor_user_id"
+            ]
+          }
+        ],
+        "version": "720fccdb"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupLearnerRosterEntry": {
+      "name": "grouplearnerrosterentry",
+      "className": "GroupLearnerRosterEntry",
+      "qualifiedName": "@happyvertical/smrt-education:GroupLearnerRosterEntry",
+      "collection": "grouplearnerrosterentries",
+      "description": "Group-owned opaque roster index; authoritative consent remains family-owned.",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {
+        "tenantId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "__tenancy": {
+              "isTenantIdField": true,
+              "autoFilter": true,
+              "required": true,
+              "autoPopulate": true,
+              "nullable": false,
+              "mode": "required",
+              "field": "tenantId",
+              "allowSuperAdminBypass": false
+            }
+          }
+        },
+        "groupId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "EducationGroup",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        },
+        "familyTenantId": {
+          "type": "crossPackageRef",
+          "required": true,
+          "related": "@happyvertical/smrt-users:Tenant"
+        },
+        "learnerId": {
+          "type": "text",
+          "required": true,
+          "_meta": {
+            "sqlType": "UUID",
+            "required": true
+          }
+        },
+        "membershipId": {
+          "type": "foreignKey",
+          "required": true,
+          "related": "GroupLearnerMembership",
+          "_meta": {
+            "required": true,
+            "onDelete": "RESTRICT"
+          }
+        }
+      },
+      "methods": {
+        "save": {
+          "name": "save",
+          "async": true,
+          "parameters": [
+            {
+              "name": "options",
+              "type": "SmrtSaveOptions",
+              "optional": true
+            }
+          ],
+          "returnType": "Promise<this>",
+          "isStatic": false,
+          "isPublic": true
+        },
+        "delete": {
+          "name": "delete",
+          "async": true,
+          "parameters": [],
+          "returnType": "Promise<void>",
+          "isStatic": false,
+          "isPublic": true
+        }
+      },
+      "decoratorConfig": {
+        "tableName": "group_learner_roster_entries",
+        "conflictColumns": [
+          "tenant_id",
+          "group_id",
+          "membership_id"
+        ],
+        "api": false,
+        "mcp": false,
+        "cli": false,
+        "ai": {
+          "callable": []
+        },
+        "tenantScoped": {
+          "mode": "required"
+        }
+      },
+      "extends": "SmrtObject",
+      "exportName": "GroupLearnerRosterEntry",
+      "collectionExportName": "GroupLearnerRosterEntryCollection",
+      "validationRules": [
+        {
+          "field": "groupId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        },
+        {
+          "field": "familyTenantId",
+          "rule": "required",
+          "fieldType": "crossPackageRef"
+        },
+        {
+          "field": "learnerId",
+          "rule": "required",
+          "fieldType": "text"
+        },
+        {
+          "field": "membershipId",
+          "rule": "required",
+          "fieldType": "foreignKey"
+        }
+      ],
+      "schema": {
+        "tableName": "group_learner_roster_entries",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_learner_roster_entries\" (\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  \"group_id\" UUID NOT NULL,\n  \"family_tenant_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"membership_id\" UUID NOT NULL\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
+          },
+          "group_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "education_groups",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "family_tenant_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "learner_id": {
+            "type": "UUID",
+            "notNull": true,
+            "unique": false
+          },
+          "membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_learner_roster_entries_tenant_id_group_id_idx",
+            "columns": [
+              "tenant_id",
+              "group_id",
+              "membership_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_learner_roster_entries_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_group_id_idx",
+            "columns": [
+              "group_id"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_family_tenant_id_idx",
+            "columns": [
+              "family_tenant_id"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_membership_id_idx",
+            "columns": [
+              "membership_id"
+            ]
+          }
+        ],
+        "version": "c6ebaeb2"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
+    "@happyvertical/smrt-education:GroupLearnerRosterEntryCollection": {
+      "name": "grouplearnerrosterentrycollection",
+      "className": "GroupLearnerRosterEntryCollection",
+      "qualifiedName": "@happyvertical/smrt-education:GroupLearnerRosterEntryCollection",
+      "collection": "grouplearnerrosterentries",
+      "filePath": "/home/runner/work/smrt/smrt/packages/education/src/group-sharing-models.ts",
+      "packageName": "@happyvertical/smrt-education",
+      "fields": {},
+      "methods": {},
+      "decoratorConfig": {
+        "tableName": "group_learner_roster_entries",
+        "api": false,
+        "mcp": false,
+        "cli": false
+      },
+      "extends": "SmrtCollection",
+      "extendsTypeArg": "GroupLearnerRosterEntry",
+      "exportName": "GroupLearnerRosterEntryCollection",
+      "collectionExportName": "GroupLearnerRosterEntryCollectionCollection",
+      "schema": {
+        "tableName": "group_learner_roster_entries",
+        "ddl": "CREATE TABLE IF NOT EXISTS \"group_learner_roster_entries\" (\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  \"group_id\" UUID NOT NULL,\n  \"family_tenant_id\" UUID NOT NULL,\n  \"learner_id\" UUID NOT NULL,\n  \"membership_id\" UUID NOT NULL\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
+          },
+          "group_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "education_groups",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          },
+          "family_tenant_id": {
+            "type": "UUID",
+            "referenceKind": "crossPackageRef",
+            "notNull": true,
+            "unique": false
+          },
+          "learner_id": {
+            "type": "UUID",
+            "notNull": true,
+            "unique": false
+          },
+          "membership_id": {
+            "type": "UUID",
+            "referenceKind": "foreignKey",
+            "notNull": true,
+            "unique": false,
+            "foreignKey": {
+              "table": "group_learner_memberships",
+              "column": "id",
+              "onDelete": "RESTRICT",
+              "onUpdate": "CASCADE"
+            }
+          }
+        },
+        "indexes": [
+          {
+            "name": "group_learner_roster_entries_tenant_id_group_id_idx",
+            "columns": [
+              "tenant_id",
+              "group_id",
+              "membership_id"
+            ],
+            "unique": true
+          },
+          {
+            "name": "group_learner_roster_entries_slug_context_idx",
+            "columns": [
+              "slug",
+              "context"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_tenant_id_created_at_idx",
+            "columns": [
+              "tenant_id",
+              "created_at"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_group_id_idx",
+            "columns": [
+              "group_id"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_family_tenant_id_idx",
+            "columns": [
+              "family_tenant_id"
+            ]
+          },
+          {
+            "name": "group_learner_roster_entries_membership_id_idx",
+            "columns": [
+              "membership_id"
+            ]
+          }
+        ],
+        "version": "c6ebaeb2"
+      },
+      "importPath": "@happyvertical/smrt-education"
+    },
     "@happyvertical/smrt-education:Learner": {
       "name": "learner",
       "className": "Learner",
@@ -18630,6 +21312,51 @@
           "Needs a server because its package depends on @happyvertical/smrt-agents, @happyvertical/smrt-jobs, @happyvertical/smrt-profiles, @happyvertical/smrt-reports, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3615, #3617, #3624, #3625, #3626, #3627)."
         ]
       }
+    },
+    {
+      "id": "education.supervisor",
+      "className": "EducationSupervisorRecipe",
+      "label": "Homeschool groups",
+      "summary": "Review parent-authorized learning work and retain revision-bound comments.",
+      "synonyms": [
+        "homeschool groups",
+        "supervisor review"
+      ],
+      "models": [
+        "@happyvertical/smrt-education:EducationGroup",
+        "@happyvertical/smrt-education:GroupLearnerInvitation",
+        "@happyvertical/smrt-education:GroupLearnerMembership",
+        "@happyvertical/smrt-education:GroupLearnerRosterEntry",
+        "@happyvertical/smrt-education:GroupSharingPolicy",
+        "@happyvertical/smrt-education:GroupRevisionComment"
+      ],
+      "nav": [
+        {
+          "label": "Groups",
+          "model": "@happyvertical/smrt-education:EducationGroup",
+          "icon": "users",
+          "description": "Groups and currently authorized shared learning work.",
+          "noun": "group"
+        }
+      ],
+      "requires": [],
+      "section": {
+        "id": "education",
+        "label": "Education",
+        "icon": "users",
+        "description": "Courses and lessons for learning."
+      },
+      "help": {
+        "markdown": "# Homeschool groups\n\nCompose `education.supervisor` with the education learner workflow to manage\nindependent group tenants and parent-approved links to existing family learners.\nRecipe discovery supplies models and navigation metadata; it grants no generated\nCRUD or family access.\n\nHosts use the closed group sharing services with a live session authorizer on\nthe supplied database executor. Supervisors remain group members, never family\nguardians. A parent must choose an explicit sharing policy when accepting a\ntargeted invitation. Work, revisions, source bytes and comment attribution remain\nfamily-owned after leaving a group.\n\nEvery roster, work, revision, media, comment and progress request must check\ncurrent authority and policy. Serve media through the authorized reader and a\nprivate, non-cacheable host response; never publish storage URLs. Saved parent\ncomment visibility defaults to parent-only. Supervisor comments cannot grade or\nchange learning evidence.\n\nSee the shipped `agents/group-sharing.md` contract for selectors, facet semantics,\ntransaction requirements and migration expectations.\n",
+        "fieldRefs": []
+      },
+      "runtime": "both",
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package depends on @happyvertical/smrt-agents, @happyvertical/smrt-jobs, @happyvertical/smrt-profiles, @happyvertical/smrt-reports, @happyvertical/smrt-secrets, @happyvertical/smrt-tenancy, @happyvertical/smrt-users, which do not build for a browser (#3615, #3617, #3624, #3625, #3626, #3627)."
+        ]
+      }
     }
   ],
   "smrtDependencies": [