@happyvertical/smrt-planner 0.57.34 → 0.57.36

package/dist/catalog/catalog.json

@@ -5,7 +5,7 @@
     {
       "id": "ads",
       "packageName": "@happyvertical/smrt-ads",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Advertising delivery and tracking models for SMRT framework",
       "models": [
         {
@@ -1511,7 +1511,7 @@
     {
       "id": "analytics",
       "packageName": "@happyvertical/smrt-analytics",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Analytics integration models for SMRT framework",
       "models": [
         {
@@ -3420,7 +3420,7 @@
     {
       "id": "approvals",
       "packageName": "@happyvertical/smrt-approvals",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Approval decision gate for the SMRT framework: revision-bound, single-use approvals with quorum, expiry, and an append-only event ledger",
       "models": [
         {
@@ -3807,7 +3807,7 @@
     {
       "id": "assets",
       "packageName": "@happyvertical/smrt-assets",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Asset management system with versioning, metadata, and AI-powered operations for SMRT framework",
       "models": [
         {
@@ -5607,7 +5607,7 @@
     {
       "id": "chat",
       "packageName": "@happyvertical/smrt-chat",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Chat rooms, DMs, threads, and agent conversations for the SMRT framework",
       "models": [
         {
@@ -7974,7 +7974,7 @@
     {
       "id": "comments",
       "packageName": "@happyvertical/smrt-comments",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Record comments and mention hooks for SMRT applications",
       "models": [
         {
@@ -8390,7 +8390,7 @@
     {
       "id": "commerce",
       "packageName": "@happyvertical/smrt-commerce",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Commerce models for the SMRT framework - contracts, fulfillments, payments",
       "models": [
         {
@@ -20387,6 +20387,93 @@
           "references": [],
           "exposed": true
         },
+        {
+          "id": "@happyvertical/smrt-commerce:TenantPaymentDispute",
+          "name": "TenantPaymentDispute",
+          "collection": "tenantpaymentdisputes",
+          "description": "One authoritative dispute snapshot and its immutable balance evidence.",
+          "fields": [
+            {
+              "name": "tenantId",
+              "type": "text",
+              "required": true,
+              "system": true
+            },
+            {
+              "name": "backendId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "environment",
+              "type": "text",
+              "required": false,
+              "default": "test",
+              "enum": [
+                "test",
+                "live"
+              ]
+            },
+            {
+              "name": "providerAccountId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "disputeId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
+            {
+              "name": "paymentId",
+              "type": "foreignKey",
+              "required": false,
+              "related": "@happyvertical/smrt-commerce:Payment"
+            },
+            {
+              "name": "status",
+              "type": "text",
+              "required": false,
+              "default": "unknown"
+            },
+            {
+              "name": "snapshotJson",
+              "type": "text",
+              "required": false,
+              "system": true
+            }
+          ],
+          "rest": [],
+          "mcp": [],
+          "cli": [],
+          "methods": [
+            {
+              "name": "delete",
+              "async": true,
+              "parameters": [
+                "_options?: SmrtDeleteOptions"
+              ],
+              "returnType": "Promise<void>",
+              "aiCallable": false
+            },
+            {
+              "name": "save",
+              "async": true,
+              "parameters": [
+                "options?: SmrtSaveOptions"
+              ],
+              "returnType": "Promise<this>",
+              "aiCallable": false
+            }
+          ],
+          "references": [
+            "@happyvertical/smrt-commerce:Payment"
+          ],
+          "exposed": false
+        },
         {
           "id": "@happyvertical/smrt-commerce:TenantPaymentWebhookEvent",
           "name": "TenantPaymentWebhookEvent",
@@ -20450,6 +20537,8 @@
                 "application_fee",
                 "refund_reported",
                 "refund_updated",
+                "dispute_updated",
+                "dispute_reported",
                 "late_payment",
                 "ignored"
               ]
@@ -20460,6 +20549,12 @@
               "required": false,
               "default": ""
             },
+            {
+              "name": "paymentId",
+              "type": "text",
+              "required": false,
+              "default": ""
+            },
             {
               "name": "applicationFeeJson",
               "type": "text",
@@ -22467,7 +22562,7 @@
     {
       "id": "content",
       "packageName": "@happyvertical/smrt-content",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Content processing module for SMRT framework - handles documents, web content, and media",
       "models": [
         {
@@ -29397,7 +29492,7 @@
     {
       "id": "events",
       "packageName": "@happyvertical/smrt-events",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Hierarchical event management with participant tracking and SMRT framework support",
       "models": [
         {
@@ -31401,7 +31496,7 @@
     {
       "id": "expenses",
       "packageName": "@happyvertical/smrt-expenses",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Expense records for the SMRT framework - reviewed costs against a cost object, deduplicated receipts, and commitment drawdown",
       "models": [
         {
@@ -32213,7 +32308,7 @@
     {
       "id": "facts",
       "packageName": "@happyvertical/smrt-facts",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Distributed memory and knowledge management with provenance tracking for SMRT framework",
       "models": [
         {
@@ -34237,7 +34332,7 @@
     {
       "id": "fields",
       "packageName": "@happyvertical/smrt-fields",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Layered field policy store and resolver (defaults, visibility tiers, help text) for SMRT objects",
       "models": [
         {
@@ -34950,7 +35045,7 @@
     {
       "id": "human-resources",
       "packageName": "@happyvertical/smrt-human-resources",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "HR records for the SMRT framework: who works for an organization, as what, and with what standing — employment with dated terms, and qualifications with expiry",
       "models": [
         {
@@ -34969,7 +35064,8 @@
               "name": "profileId",
               "type": "crossPackageRef",
               "required": false,
-              "related": "@happyvertical/smrt-profiles:Profile"
+              "related": "@happyvertical/smrt-profiles:Profile",
+              "description": "The person who works for you."
             },
             {
               "name": "userId",
@@ -34986,17 +35082,20 @@
             {
               "name": "employeeNumber",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "Your own reference for this person, such as a staff number."
             },
             {
               "name": "workerType",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "Whether they are an employee, contractor or another kind of worker."
             },
             {
               "name": "position",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "Their role or trade."
             },
             {
               "name": "status",
@@ -35006,7 +35105,8 @@
                 "active",
                 "on-leave",
                 "ended"
-              ]
+              ],
+              "description": "Whether they currently work for you."
             }
           ],
           "rest": [],
@@ -35136,22 +35236,26 @@
               "name": "employmentId",
               "type": "foreignKey",
               "required": false,
-              "related": "@happyvertical/smrt-human-resources:Employment"
+              "related": "@happyvertical/smrt-human-resources:Employment",
+              "description": "The person this period of work belongs to."
             },
             {
               "name": "startedOn",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "The first day of this period of work."
             },
             {
               "name": "endedOn",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "The last day of this period of work. Empty while it continues."
             },
             {
               "name": "endReason",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "Why the period of work ended."
             }
           ],
           "rest": [],
@@ -35194,13 +35298,15 @@
               "name": "qualificationId",
               "type": "foreignKey",
               "required": false,
-              "related": "@happyvertical/smrt-human-resources:Qualification"
+              "related": "@happyvertical/smrt-human-resources:Qualification",
+              "description": "The qualification this person holds."
             },
             {
               "name": "profileId",
               "type": "crossPackageRef",
               "required": false,
-              "related": "@happyvertical/smrt-profiles:Profile"
+              "related": "@happyvertical/smrt-profiles:Profile",
+              "description": "The person who holds it."
             },
             {
               "name": "employmentId",
@@ -35211,17 +35317,20 @@
             {
               "name": "issuedOn",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "The day it was given."
             },
             {
               "name": "expiresOn",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "The day it runs out. Empty if it does not."
             },
             {
               "name": "certificateNumber",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "The number printed on the certificate."
             },
             {
               "name": "status",
@@ -35232,7 +35341,8 @@
                 "expired",
                 "suspended",
                 "revoked"
-              ]
+              ],
+              "description": "Whether it is valid, expired, suspended or revoked."
             },
             {
               "name": "verifiedByProfileId",
@@ -35382,7 +35492,8 @@
             {
               "name": "name",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "What the qualification is called, such as First aid."
             },
             {
               "name": "kind",
@@ -35394,23 +35505,27 @@
                 "authorization",
                 "training",
                 "restriction"
-              ]
+              ],
+              "description": "The sort of qualification, such as a certificate or a licence."
             },
             {
               "name": "issuingBody",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "Who gives it out."
             },
             {
               "name": "expires",
               "type": "boolean",
               "required": true,
-              "default": false
+              "default": false,
+              "description": "Whether it has to be renewed."
             },
             {
               "name": "validityMonths",
               "type": "integer",
-              "required": false
+              "required": false,
+              "description": "How many months it lasts once given."
             },
             {
               "name": "scope",
@@ -35465,12 +35580,264 @@
         "via": [
           "@happyvertical/smrt-tenancy"
         ]
-      }
+      },
+      "recipes": [
+        {
+          "id": "human-resources.people",
+          "label": "Employees",
+          "summary": "Keep a record of who works for you and in what role. Only people can see it; agents cannot read it.",
+          "synonyms": [
+            "hr",
+            "human resources",
+            "staff",
+            "people",
+            "team",
+            "workers"
+          ],
+          "models": [
+            "@happyvertical/smrt-human-resources:Employment",
+            "@happyvertical/smrt-human-resources:EmploymentTerm"
+          ],
+          "nav": [
+            {
+              "label": "Employees",
+              "model": "@happyvertical/smrt-human-resources:Employment",
+              "icon": "users",
+              "description": "Everyone who works for you, with their role and status.",
+              "noun": "employee"
+            }
+          ],
+          "requires": [],
+          "section": {
+            "id": "staff",
+            "label": "Staff",
+            "icon": "users",
+            "description": "The people who work for you."
+          },
+          "options": {
+            "@happyvertical/smrt-human-resources:Employment": {
+              "fields": {
+                "profileId": {
+                  "label": "Person",
+                  "order": 1
+                },
+                "employeeNumber": {
+                  "order": 2
+                },
+                "position": {
+                  "order": 3
+                },
+                "workerType": {
+                  "order": 4
+                },
+                "status": {
+                  "order": 5
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "userId": {
+                  "visibility": "advanced"
+                },
+                "employerProfileId": {
+                  "visibility": "advanced"
+                }
+              }
+            },
+            "@happyvertical/smrt-human-resources:EmploymentTerm": {
+              "fields": {
+                "employmentId": {
+                  "label": "Person",
+                  "order": 1
+                },
+                "startedOn": {
+                  "label": "First day",
+                  "order": 2
+                },
+                "endedOn": {
+                  "label": "Last day",
+                  "order": 3
+                },
+                "endReason": {
+                  "order": 4
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                }
+              }
+            }
+          },
+          "help": {
+            "markdown": "## Overview\n\nEmployees is where you keep a record of who works for you. Each person has an\nemployment record with their role, their worker type and whether they are\ncurrently active, plus the dates they started and, if they left, finished.\n\nOnly people using the app can see these records. They are kept closed to\nassistants and other automated tools on purpose, so an agent cannot read them.\n\n## Tasks\n\n### Add an employee\n\n1. Open the list of employees and choose **New**.\n2. Pick the **{field:Employment.profileId}**.\n3. Give them an **{field:Employment.employeeNumber}**, your own reference for them.\n4. Fill in their **{field:Employment.position}** and **{field:Employment.workerType}**.\n5. Save. They now show in your list of employees.\n\n### Record that someone has left\n\n1. Open the person from the list.\n2. Set the **{field:Employment.status}** to show they no longer work for you.\n3. Record their **{field:EmploymentTerm.endedOn}** and the **{field:EmploymentTerm.endReason}**.\n4. Save. Their history stays on file.\n",
+            "fieldRefs": [
+              "Employment.employeeNumber",
+              "Employment.position",
+              "Employment.profileId",
+              "Employment.status",
+              "Employment.workerType",
+              "EmploymentTerm.endReason",
+              "EmploymentTerm.endedOn"
+            ]
+          },
+          "exposure": "ui-only",
+          "demo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package depends on @happyvertical/smrt-tenancy, which do not build for a browser (#3624)."
+            ]
+          }
+        },
+        {
+          "id": "human-resources.qualifications",
+          "label": "Qualifications",
+          "summary": "Track the certificates and training your people hold, and when they run out. Only people can see it; agents cannot read it.",
+          "synonyms": [
+            "certifications",
+            "certificates",
+            "licences",
+            "training",
+            "first aid"
+          ],
+          "models": [
+            "@happyvertical/smrt-human-resources:Qualification",
+            "@happyvertical/smrt-human-resources:HeldQualification"
+          ],
+          "nav": [
+            {
+              "label": "Qualifications",
+              "model": "@happyvertical/smrt-human-resources:Qualification",
+              "icon": "book",
+              "description": "The certificates, licences and training your people can hold.",
+              "noun": "qualification"
+            },
+            {
+              "label": "Held qualifications",
+              "model": "@happyvertical/smrt-human-resources:HeldQualification",
+              "icon": "fileText",
+              "description": "Who holds which qualification, and when it runs out.",
+              "noun": "held qualification"
+            }
+          ],
+          "requires": [
+            "human-resources.people"
+          ],
+          "section": {
+            "id": "staff",
+            "label": "Staff",
+            "icon": "users",
+            "description": "The people who work for you."
+          },
+          "options": {
+            "@happyvertical/smrt-human-resources:Qualification": {
+              "fields": {
+                "name": {
+                  "order": 1
+                },
+                "kind": {
+                  "order": 2
+                },
+                "issuingBody": {
+                  "order": 3
+                },
+                "expires": {
+                  "order": 4
+                },
+                "validityMonths": {
+                  "order": 5
+                },
+                "key": {
+                  "visibility": "advanced"
+                },
+                "scope": {
+                  "visibility": "advanced"
+                },
+                "isActive": {
+                  "visibility": "advanced"
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-human-resources:HeldQualification": {
+              "fields": {
+                "qualificationId": {
+                  "label": "Qualification",
+                  "order": 1
+                },
+                "profileId": {
+                  "label": "Person",
+                  "order": 2
+                },
+                "issuedOn": {
+                  "order": 3
+                },
+                "expiresOn": {
+                  "order": 4
+                },
+                "certificateNumber": {
+                  "order": 5
+                },
+                "status": {
+                  "order": 6
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "employmentId": {
+                  "visibility": "advanced"
+                },
+                "verifiedByProfileId": {
+                  "visibility": "advanced"
+                },
+                "verifiedAt": {
+                  "visibility": "advanced"
+                },
+                "documentAssetId": {
+                  "visibility": "advanced"
+                },
+                "renewalOfId": {
+                  "visibility": "hidden"
+                }
+              }
+            }
+          },
+          "help": {
+            "markdown": "## Overview\n\nQualifications is where you list the certificates, licences and training your\nwork needs, such as first aid, and record who holds each one and when it runs\nout. It builds on Employees, so switch that on first.\n\nOnly people using the app can see these records. They are kept closed to\nassistants and other automated tools on purpose, so an agent cannot read them.\n\n## Tasks\n\n### Set up a qualification\n\n1. Open the list of qualifications and choose **New**.\n2. Type the **{field:Qualification.name}**, for example \"First aid\".\n3. Say who gives it out in **{field:Qualification.issuingBody}**.\n4. Tick **{field:Qualification.expires}** if it has to be renewed, and set **{field:Qualification.validityMonths}** to how long it lasts.\n5. Save.\n\n### Record who holds a qualification\n\n1. Open the held qualifications and choose **New**.\n2. Pick the **{field:HeldQualification.qualificationId}** and the **{field:HeldQualification.profileId}** who holds it.\n3. Enter the date it was **{field:HeldQualification.issuedOn}** and when it **{field:HeldQualification.expiresOn}**.\n4. Add the **{field:HeldQualification.certificateNumber}** from the certificate.\n5. Set the **{field:HeldQualification.status}** to show whether it is still valid.\n6. Save. You can now see who needs to renew before the date.\n",
+            "fieldRefs": [
+              "HeldQualification.certificateNumber",
+              "HeldQualification.expiresOn",
+              "HeldQualification.issuedOn",
+              "HeldQualification.profileId",
+              "HeldQualification.qualificationId",
+              "HeldQualification.status",
+              "Qualification.expires",
+              "Qualification.issuingBody",
+              "Qualification.name",
+              "Qualification.validityMonths"
+            ]
+          },
+          "exposure": "ui-only",
+          "demo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package depends on @happyvertical/smrt-tenancy, which do not build for a browser (#3624)."
+            ]
+          },
+          "effectiveDemo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package depends on @happyvertical/smrt-tenancy, which do not build for a browser (#3624).",
+              "Needs human-resources.people, which is server."
+            ]
+          }
+        }
+      ]
     },
     {
       "id": "images",
       "packageName": "@happyvertical/smrt-images",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Image asset management with AI-powered categorization, search, editing, and metadata extraction for SMRT framework",
       "models": [
         {
@@ -36080,7 +36447,7 @@
     {
       "id": "ingestion",
       "packageName": "@happyvertical/smrt-ingestion",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Durable tenant-scoped intake and evidence foundations",
       "models": [
         {
@@ -37226,7 +37593,7 @@
     {
       "id": "inventory",
       "packageName": "@happyvertical/smrt-inventory",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Multi-location stock tracking for the SMRT framework — Sku, InventoryLocation, StockLevel, StockMovement, lot and serial tracking, and stock-mutation and lot services",
       "models": [
         {
@@ -38481,7 +38848,7 @@
     {
       "id": "ledgers",
       "packageName": "@happyvertical/smrt-ledgers",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Double-entry accounting ledger for the SMRT framework",
       "models": [
         {
@@ -40030,7 +40397,7 @@
     {
       "id": "manufacturing",
       "packageName": "@happyvertical/smrt-manufacturing",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Bills of materials, cost rollup, and production-order operations for the SMRT framework — strictly industry-neutral",
       "models": [
         {
@@ -40137,19 +40504,22 @@
               "name": "estimatedLabourMinutes",
               "type": "integer",
               "required": false,
-              "default": 0
+              "default": 0,
+              "description": "About how many minutes it takes to make one."
             },
             {
               "name": "defaultOperationId",
               "type": "foreignKey",
               "required": false,
-              "related": "@happyvertical/smrt-manufacturing:Operation"
+              "related": "@happyvertical/smrt-manufacturing:Operation",
+              "description": "The kind of work usually booked to this assembly."
             },
             {
               "name": "partReference",
               "type": "text",
               "required": false,
-              "default": ""
+              "default": "",
+              "description": "Your own drawing or part number for this assembly."
             }
           ],
           "rest": [
@@ -40294,18 +40664,21 @@
               "name": "productId",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "The assembly this list of parts is for."
             },
             {
               "name": "version",
               "type": "integer",
               "required": true,
-              "default": 1
+              "default": 1,
+              "description": "The revision number, so you can change a list and keep the old one."
             },
             {
               "name": "effectiveDate",
               "type": "datetime",
-              "required": false
+              "required": false,
+              "description": "The day this list starts to be used."
             },
             {
               "name": "status",
@@ -40316,13 +40689,15 @@
                 "draft",
                 "active",
                 "superseded"
-              ]
+              ],
+              "description": "Whether this list is a draft, in use or retired."
             },
             {
               "name": "notes",
               "type": "text",
               "required": false,
-              "default": ""
+              "default": "",
+              "description": "Anything people making it should know."
             },
             {
               "name": "currency",
@@ -40440,24 +40815,28 @@
               "name": "bomId",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "The list of parts this line belongs to."
             },
             {
               "name": "componentSkuId",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "The part that goes into the assembly."
             },
             {
               "name": "qtyPerUnit",
               "type": "decimal",
-              "required": false
+              "required": false,
+              "description": "How much of this part goes into one unit."
             },
             {
               "name": "uom",
               "type": "text",
               "required": false,
-              "default": "each"
+              "default": "each",
+              "description": "What the amount is counted in, such as each or kilograms."
             },
             {
               "name": "wastePercent",
@@ -40581,19 +40960,22 @@
               "name": "code",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "A short code for this kind of work."
             },
             {
               "name": "name",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "What this kind of work is called, such as cutting."
             },
             {
               "name": "category",
               "type": "text",
               "required": false,
-              "default": ""
+              "default": "",
+              "description": "A group to sort similar work together."
             },
             {
               "name": "isActive",
@@ -40685,17 +41067,20 @@
               "name": "bomId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-manufacturing:BillOfMaterials"
+              "related": "@happyvertical/smrt-manufacturing:BillOfMaterials",
+              "description": "The list of parts this run makes from."
             },
             {
               "name": "targetQty",
               "type": "decimal",
-              "required": false
+              "required": false,
+              "description": "How many you plan to make."
             },
             {
               "name": "completedQty",
               "type": "decimal",
-              "required": false
+              "required": false,
+              "description": "How many have been finished so far."
             },
             {
               "name": "status",
@@ -40707,7 +41092,8 @@
                 "in_progress",
                 "done",
                 "cancelled"
-              ]
+              ],
+              "description": "Whether the run is planned, under way, done or cancelled."
             }
           ],
           "rest": [
@@ -40787,17 +41173,20 @@
               "name": "runId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-manufacturing:ProductionRun"
+              "related": "@happyvertical/smrt-manufacturing:ProductionRun",
+              "description": "The production run this batch belongs to."
             },
             {
               "name": "qty",
               "type": "decimal",
-              "required": false
+              "required": false,
+              "description": "How many were finished in this batch."
             },
             {
               "name": "completedAt",
               "type": "datetime",
-              "required": false
+              "required": false,
+              "description": "When this batch was finished."
             }
           ],
           "rest": [
@@ -40861,24 +41250,28 @@
               "name": "bomId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-manufacturing:BillOfMaterials"
+              "related": "@happyvertical/smrt-manufacturing:BillOfMaterials",
+              "description": "The list of parts this step is part of."
             },
             {
               "name": "operationId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-manufacturing:Operation"
+              "related": "@happyvertical/smrt-manufacturing:Operation",
+              "description": "The kind of work done in this step."
             },
             {
               "name": "sequence",
               "type": "integer",
               "required": true,
-              "default": 1
+              "default": 1,
+              "description": "The order of this step, starting at 1."
             },
             {
               "name": "estimatedMinutes",
               "type": "decimal",
-              "required": false
+              "required": false,
+              "description": "About how many minutes this step takes."
             },
             {
               "name": "notes",
@@ -40982,12 +41375,360 @@
           "@happyvertical/smrt-products",
           "@happyvertical/smrt-tenancy"
         ]
-      }
+      },
+      "recipes": [
+        {
+          "id": "manufacturing.assemblies",
+          "label": "Assemblies",
+          "summary": "Define what you make, what goes into it and the steps to make it.",
+          "synonyms": [
+            "bill of materials",
+            "bills of materials",
+            "bom",
+            "recipes",
+            "products you make",
+            "routing"
+          ],
+          "models": [
+            "@happyvertical/smrt-manufacturing:Assembly",
+            "@happyvertical/smrt-manufacturing:BillOfMaterials",
+            "@happyvertical/smrt-manufacturing:BomLine",
+            "@happyvertical/smrt-manufacturing:Operation",
+            "@happyvertical/smrt-manufacturing:RoutingStep"
+          ],
+          "nav": [
+            {
+              "label": "Assemblies",
+              "model": "@happyvertical/smrt-manufacturing:Assembly",
+              "icon": "package",
+              "description": "The things you make, each built from parts.",
+              "noun": "assembly"
+            },
+            {
+              "label": "Bills of materials",
+              "model": "@happyvertical/smrt-manufacturing:BillOfMaterials",
+              "icon": "fileText",
+              "description": "The list of parts and amounts that go into each assembly.",
+              "noun": "bill of materials"
+            },
+            {
+              "label": "Operations",
+              "model": "@happyvertical/smrt-manufacturing:Operation",
+              "icon": "wrench",
+              "description": "The kinds of work done to make something, like cutting."
+            }
+          ],
+          "requires": [],
+          "requiresAny": [
+            [
+              "products.simple",
+              "products.clothing"
+            ]
+          ],
+          "section": {
+            "id": "make",
+            "label": "Make",
+            "icon": "wrench",
+            "description": "Make what you sell from the parts you hold."
+          },
+          "options": {
+            "@happyvertical/smrt-manufacturing:Assembly": {
+              "fields": {
+                "name": {
+                  "order": 1
+                },
+                "partReference": {
+                  "order": 2
+                },
+                "description": {
+                  "order": 3
+                },
+                "price": {
+                  "order": 4
+                },
+                "estimatedLabourMinutes": {
+                  "label": "Minutes to make one",
+                  "order": 5
+                },
+                "defaultOperationId": {
+                  "label": "Usual operation",
+                  "order": 6
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "productType": {
+                  "visibility": "hidden"
+                },
+                "category": {
+                  "visibility": "advanced"
+                },
+                "manufacturer": {
+                  "visibility": "hidden"
+                },
+                "model": {
+                  "visibility": "hidden"
+                },
+                "inStock": {
+                  "visibility": "hidden",
+                  "default": true
+                },
+                "specifications": {
+                  "visibility": "hidden"
+                },
+                "tags": {
+                  "visibility": "advanced"
+                },
+                "defaultSalesTaxCodeId": {
+                  "visibility": "hidden"
+                },
+                "defaultPurchaseTaxCodeId": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-manufacturing:BillOfMaterials": {
+              "fields": {
+                "productId": {
+                  "label": "Assembly",
+                  "order": 1
+                },
+                "version": {
+                  "order": 2
+                },
+                "status": {
+                  "order": 3
+                },
+                "effectiveDate": {
+                  "order": 4
+                },
+                "notes": {
+                  "order": 5
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "currency": {
+                  "visibility": "advanced"
+                }
+              }
+            },
+            "@happyvertical/smrt-manufacturing:BomLine": {
+              "fields": {
+                "bomId": {
+                  "label": "Bill of materials",
+                  "order": 1
+                },
+                "componentSkuId": {
+                  "label": "Part",
+                  "order": 2
+                },
+                "qtyPerUnit": {
+                  "label": "Amount per unit",
+                  "order": 3
+                },
+                "uom": {
+                  "label": "Unit of measure",
+                  "order": 4
+                },
+                "wastePercent": {
+                  "visibility": "advanced"
+                },
+                "notes": {
+                  "visibility": "advanced"
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-manufacturing:Operation": {
+              "fields": {
+                "name": {
+                  "order": 1
+                },
+                "code": {
+                  "order": 2
+                },
+                "category": {
+                  "order": 3
+                },
+                "isActive": {
+                  "visibility": "advanced"
+                },
+                "requiredQualificationId": {
+                  "visibility": "advanced"
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-manufacturing:RoutingStep": {
+              "fields": {
+                "bomId": {
+                  "label": "Bill of materials",
+                  "order": 1
+                },
+                "operationId": {
+                  "label": "Operation",
+                  "order": 2
+                },
+                "sequence": {
+                  "label": "Step number",
+                  "order": 3
+                },
+                "estimatedMinutes": {
+                  "order": 4
+                },
+                "notes": {
+                  "visibility": "advanced"
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                }
+              }
+            }
+          },
+          "help": {
+            "markdown": "## Overview\n\nAssemblies is where you describe what you make. An assembly is a product built\nfrom parts. Its bill of materials lists those parts and how much of each goes\ninto one unit, and its steps say which operations, such as cutting or painting,\nit passes through and how long each takes.\n\n## Tasks\n\n### Add something you make\n\n1. Open the list of assemblies and choose **New**.\n2. Give it a **{field:Assembly.name}** and your own **{field:Assembly.partReference}**, such as a drawing or part number.\n3. Note roughly how long one takes in **{field:Assembly.estimatedLabourMinutes}**.\n4. Save.\n\n### List what goes into it\n\n1. Open the bills of materials and choose **New**.\n2. Pick the **{field:BillOfMaterials.productId}** the list is for.\n3. Save, then add a line for each part.\n4. For each line pick the **{field:BomLine.componentSkuId}** and set the **{field:BomLine.qtyPerUnit}** that goes into one unit.\n\n### Change how something is made\n\n1. Create a new bill of materials with a higher **{field:BillOfMaterials.version}**.\n2. Set its **{field:BillOfMaterials.status}** to active when it is ready to use.\n3. Set the old version's **{field:BillOfMaterials.status}** to superseded so only one version is in use.\n4. The old version stays on file, so past runs still make sense.\n\n### See the kinds of work\n\nOperations are set up by the manufacturing service, not by hand in the app.\n\n1. Open the operations.\n2. Read each **{field:Operation.name}** and its short **{field:Operation.code}**.\n3. The steps of a bill of materials use these, each with its **{field:RoutingStep.estimatedMinutes}**.\n",
+            "fieldRefs": [
+              "Assembly.estimatedLabourMinutes",
+              "Assembly.name",
+              "Assembly.partReference",
+              "BillOfMaterials.productId",
+              "BillOfMaterials.status",
+              "BillOfMaterials.version",
+              "BomLine.componentSkuId",
+              "BomLine.qtyPerUnit",
+              "Operation.code",
+              "Operation.name",
+              "RoutingStep.estimatedMinutes"
+            ]
+          },
+          "demo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package depends on @happyvertical/smrt-products, @happyvertical/smrt-tenancy, which do not build for a browser (#3616, #3624, #3626)."
+            ]
+          },
+          "effectiveDemo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package depends on @happyvertical/smrt-products, @happyvertical/smrt-tenancy, which do not build for a browser (#3616, #3624, #3626).",
+              "Needs products.simple, which is server."
+            ]
+          }
+        },
+        {
+          "id": "manufacturing.production",
+          "label": "Production",
+          "summary": "Plan how many to make, record what came out and see each run through to done.",
+          "synonyms": [
+            "production runs",
+            "work orders",
+            "manufacturing",
+            "batches",
+            "build orders"
+          ],
+          "models": [
+            "@happyvertical/smrt-manufacturing:ProductionRun",
+            "@happyvertical/smrt-manufacturing:ProductionRunCompletion"
+          ],
+          "nav": [
+            {
+              "label": "Production runs",
+              "model": "@happyvertical/smrt-manufacturing:ProductionRun",
+              "icon": "layers",
+              "description": "Each batch you plan to make, and how far along it is.",
+              "noun": "production run"
+            }
+          ],
+          "requires": [
+            "manufacturing.assemblies"
+          ],
+          "section": {
+            "id": "make",
+            "label": "Make",
+            "icon": "wrench",
+            "description": "Make what you sell from the parts you hold."
+          },
+          "options": {
+            "@happyvertical/smrt-manufacturing:ProductionRun": {
+              "fields": {
+                "bomId": {
+                  "label": "Bill of materials",
+                  "order": 1
+                },
+                "targetQty": {
+                  "label": "How many to make",
+                  "order": 2
+                },
+                "completedQty": {
+                  "label": "How many made so far",
+                  "locked": true,
+                  "order": 3
+                },
+                "status": {
+                  "locked": true,
+                  "order": 4
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-manufacturing:ProductionRunCompletion": {
+              "fields": {
+                "runId": {
+                  "label": "Production run",
+                  "order": 1
+                },
+                "qty": {
+                  "label": "How many finished",
+                  "order": 2
+                },
+                "completedAt": {
+                  "label": "Finished on",
+                  "order": 3
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                }
+              }
+            }
+          },
+          "help": {
+            "markdown": "## Overview\n\nProduction is where you plan and follow what you make. A production run says\nhow many of an assembly you intend to make, using one of its bills of\nmaterials. As batches come off the line they are recorded against it, and the run\nkeeps count until it is done.\n\n## Tasks\n\nProduction runs and their finished batches are created and updated by the\nproduction service, not by hand in the app. Here you follow them.\n\n### Find a run\n\n1. Open the production runs.\n2. Check the **{field:ProductionRun.bomId}** it makes from and the **{field:ProductionRun.targetQty}** you want.\n\n### See how a run is going\n\nOpen the run and compare **{field:ProductionRun.completedQty}** with\n**{field:ProductionRun.targetQty}**. Its **{field:ProductionRun.status}** shows\nwhether it is planned, under way, finished or cancelled.\n\n### See what was finished\n\n1. Open the run's finished batches.\n2. Each one shows the **{field:ProductionRunCompletion.runId}** it belongs to and **{field:ProductionRunCompletion.qty}**, how many came out.\n",
+            "fieldRefs": [
+              "ProductionRun.bomId",
+              "ProductionRun.completedQty",
+              "ProductionRun.status",
+              "ProductionRun.targetQty",
+              "ProductionRunCompletion.qty",
+              "ProductionRunCompletion.runId"
+            ]
+          },
+          "demo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package depends on @happyvertical/smrt-products, @happyvertical/smrt-tenancy, which do not build for a browser (#3616, #3624, #3626)."
+            ]
+          },
+          "effectiveDemo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package depends on @happyvertical/smrt-products, @happyvertical/smrt-tenancy, which do not build for a browser (#3616, #3624, #3626).",
+              "Needs manufacturing.assemblies, which is server."
+            ]
+          }
+        }
+      ]
     },
     {
       "id": "marketing",
       "packageName": "@happyvertical/smrt-marketing",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Cross-channel campaign coordination, immutable performance evidence, budget pacing, and reusable Svelte marketing surfaces for SMRT",
       "models": [
         {
@@ -41593,7 +42334,7 @@
     {
       "id": "messages",
       "packageName": "@happyvertical/smrt-messages",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Unified multi-channel messaging with STI-based hierarchies",
       "models": [
         {
@@ -48048,7 +48789,7 @@
     {
       "id": "places",
       "packageName": "@happyvertical/smrt-places",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Hierarchical place management with geo integration and SMRT framework support",
       "models": [
         {
@@ -48892,7 +49633,7 @@
     {
       "id": "preferences",
       "packageName": "@happyvertical/smrt-preferences",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Tenant defaults and per-user overrides for user-interface preferences (overview layouts, shell layout), validated per registered kind",
       "models": [
         {
@@ -49046,7 +49787,7 @@
     {
       "id": "products",
       "packageName": "@happyvertical/smrt-products",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "SMRT products module: triple-purpose microservice template for standalone apps, federated modules, and NPM libraries",
       "models": [
         {
@@ -50529,7 +51270,7 @@
     {
       "id": "profiles",
       "packageName": "@happyvertical/smrt-profiles",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Profile management system with relationships, metadata, and reciprocal associations for SMRT framework",
       "models": [
         {
@@ -55118,7 +55859,7 @@
     {
       "id": "projects",
       "packageName": "@happyvertical/smrt-projects",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Provider-agnostic project management models (Issues, PRs, Repositories, Projects) for SMRT framework",
       "models": [
         {
@@ -58747,7 +59488,7 @@
     {
       "id": "properties",
       "packageName": "@happyvertical/smrt-properties",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Digital property and zone management models for SMRT framework",
       "models": [
         {
@@ -59610,7 +60351,7 @@
     {
       "id": "reactions",
       "packageName": "@happyvertical/smrt-reactions",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Tenant-scoped reactions and lightweight polls with shared participation enforcement",
       "models": [
         {
@@ -59865,7 +60606,7 @@
     {
       "id": "reports",
       "packageName": "@happyvertical/smrt-reports",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Materialized aggregate report models for SMRT",
       "models": [
         {
@@ -60728,7 +61469,7 @@
     {
       "id": "sales",
       "packageName": "@happyvertical/smrt-sales",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Modular sales for the SMRT framework: agreement execution, CRM, referral intake, neutral commissions, and reusable Svelte surfaces",
       "models": [
         {
@@ -62221,7 +62962,8 @@
               "name": "earnerId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-sales:Earner"
+              "related": "@happyvertical/smrt-sales:Earner",
+              "description": "The affiliate who earned this commission."
             },
             {
               "name": "earningEventId",
@@ -62293,19 +63035,22 @@
               "name": "amountCents",
               "type": "integer",
               "required": false,
-              "default": 0
+              "default": 0,
+              "description": "How much was earned, in the smallest unit of the currency."
             },
             {
               "name": "currency",
               "type": "text",
               "required": false,
-              "default": "USD"
+              "default": "USD",
+              "description": "The currency the commission is paid in."
             },
             {
               "name": "status",
               "type": "text",
               "required": false,
-              "default": "pending"
+              "default": "pending",
+              "description": "Where the commission stands, from pending to paid."
             },
             {
               "name": "clearingEndsAt",
@@ -62360,7 +63105,8 @@
               "name": "dedupeKey",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "A reference that stops the same commission being recorded twice."
             },
             {
               "name": "metadata",
@@ -62866,7 +63612,8 @@
               "name": "earnerId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-sales:Earner"
+              "related": "@happyvertical/smrt-sales:Earner",
+              "description": "The affiliate being paid."
             },
             {
               "name": "periodStart",
@@ -62894,13 +63641,15 @@
               "name": "totalAmountCents",
               "type": "integer",
               "required": false,
-              "default": 0
+              "default": 0,
+              "description": "The total being paid, in the smallest unit of the currency."
             },
             {
               "name": "currency",
               "type": "text",
               "required": false,
-              "default": "USD"
+              "default": "USD",
+              "description": "The currency of the payment."
             },
             {
               "name": "payoutMethod",
@@ -62918,7 +63667,8 @@
               "name": "status",
               "type": "text",
               "required": false,
-              "default": "pending"
+              "default": "pending",
+              "description": "Whether the payment is waiting, being sent, completed or failed."
             },
             {
               "name": "paymentReference",
@@ -62935,7 +63685,8 @@
             {
               "name": "paidAt",
               "type": "datetime",
-              "required": false
+              "required": false,
+              "description": "When the payment went out."
             },
             {
               "name": "invoiceId",
@@ -62953,7 +63704,8 @@
               "name": "idempotencyKey",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "A reference that stops the same payout being made twice."
             },
             {
               "name": "sourceKind",
@@ -63614,13 +64366,15 @@
               "name": "displayName",
               "type": "text",
               "required": false,
-              "default": ""
+              "default": "",
+              "description": "The name this payee is paid under."
             },
             {
               "name": "status",
               "type": "text",
               "required": false,
-              "default": "pending"
+              "default": "pending",
+              "description": "Whether this payee can be paid."
             },
             {
               "name": "payoutMethod",
@@ -65538,13 +66292,15 @@
               "name": "referrerId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-sales:Referrer"
+              "related": "@happyvertical/smrt-sales:Referrer",
+              "description": "The affiliate who sent this person."
             },
             {
               "name": "programId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-sales:ReferralProgram"
+              "related": "@happyvertical/smrt-sales:ReferralProgram",
+              "description": "The program this referral counts towards."
             },
             {
               "name": "policyKey",
@@ -65562,7 +66318,8 @@
               "name": "status",
               "type": "text",
               "required": false,
-              "default": "pending"
+              "default": "pending",
+              "description": "Whether the referral is waiting, has led to a sale or has lapsed."
             },
             {
               "name": "targetKind",
@@ -66496,19 +67253,22 @@
               "name": "key",
               "type": "text",
               "required": true,
-              "default": ""
+              "default": "",
+              "description": "A short name for the program, used in links and reports."
             },
             {
               "name": "name",
               "type": "text",
               "required": false,
-              "default": ""
+              "default": "",
+              "description": "What you call this program."
             },
             {
               "name": "status",
               "type": "text",
               "required": false,
-              "default": "draft"
+              "default": "draft",
+              "description": "Whether the program is in draft, running or finished."
             },
             {
               "name": "defaultCommissionPlanKey",
@@ -67008,13 +67768,15 @@
               "name": "displayName",
               "type": "text",
               "required": false,
-              "default": ""
+              "default": "",
+              "description": "The name you know this affiliate by."
             },
             {
               "name": "status",
               "type": "text",
               "required": false,
-              "default": "pending"
+              "default": "pending",
+              "description": "Whether this affiliate is approved to send you referrals."
             },
             {
               "name": "metadata",
@@ -67637,6 +68399,388 @@
         ]
       },
       "recipes": [
+        {
+          "id": "affiliates.referrals",
+          "label": "Affiliates",
+          "summary": "Reward partners for the customers they send you, and pay them what they earn.",
+          "synonyms": [
+            "referrals",
+            "referral program",
+            "partners",
+            "commissions",
+            "payouts",
+            "refer a friend"
+          ],
+          "models": [
+            "@happyvertical/smrt-sales:Referrer",
+            "@happyvertical/smrt-sales:ReferralProgram",
+            "@happyvertical/smrt-sales:Referral",
+            "@happyvertical/smrt-sales:Earner",
+            "@happyvertical/smrt-sales:Commission",
+            "@happyvertical/smrt-sales:CommissionPayout"
+          ],
+          "nav": [
+            {
+              "label": "Affiliates",
+              "model": "@happyvertical/smrt-sales:Referrer",
+              "icon": "users",
+              "description": "The partners and customers who send people your way.",
+              "noun": "affiliate"
+            },
+            {
+              "label": "Programs",
+              "model": "@happyvertical/smrt-sales:ReferralProgram",
+              "icon": "layers",
+              "description": "The offers that decide what a referral earns.",
+              "noun": "program"
+            },
+            {
+              "label": "Referrals",
+              "model": "@happyvertical/smrt-sales:Referral",
+              "icon": "repeat",
+              "description": "Each person sent to you, and whether it led to a sale."
+            },
+            {
+              "label": "Commissions",
+              "model": "@happyvertical/smrt-sales:Commission",
+              "icon": "receipt",
+              "description": "What each affiliate has earned and where it stands."
+            },
+            {
+              "label": "Payouts",
+              "model": "@happyvertical/smrt-sales:CommissionPayout",
+              "icon": "bank",
+              "description": "Payments made to affiliates for what they earned."
+            }
+          ],
+          "requires": [],
+          "section": {
+            "id": "grow",
+            "label": "Grow",
+            "icon": "tag",
+            "description": "Bring in new customers and reward the people who help."
+          },
+          "options": {
+            "@happyvertical/smrt-sales:Referrer": {
+              "fields": {
+                "displayName": {
+                  "label": "Name",
+                  "order": 1
+                },
+                "status": {
+                  "order": 2
+                },
+                "profileId": {
+                  "label": "Person",
+                  "visibility": "advanced"
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "earnerId": {
+                  "label": "Payee",
+                  "visibility": "advanced"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-sales:ReferralProgram": {
+              "fields": {
+                "name": {
+                  "order": 1
+                },
+                "key": {
+                  "label": "Short name",
+                  "order": 2
+                },
+                "status": {
+                  "order": 3
+                },
+                "defaultCommissionPlanKey": {
+                  "visibility": "advanced"
+                },
+                "defaultAttributionPolicyKey": {
+                  "visibility": "advanced"
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-sales:Referral": {
+              "fields": {
+                "referrerId": {
+                  "label": "Affiliate",
+                  "order": 1
+                },
+                "programId": {
+                  "label": "Program",
+                  "order": 2
+                },
+                "status": {
+                  "order": 3
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "policyKey": {
+                  "visibility": "hidden"
+                },
+                "policyVersion": {
+                  "visibility": "hidden"
+                },
+                "targetKind": {
+                  "visibility": "advanced"
+                },
+                "targetId": {
+                  "visibility": "advanced"
+                },
+                "creditFraction": {
+                  "visibility": "advanced"
+                },
+                "splitGroupId": {
+                  "visibility": "hidden"
+                },
+                "primaryTouchId": {
+                  "visibility": "hidden"
+                },
+                "attributedAt": {
+                  "visibility": "advanced"
+                },
+                "qualifiedAt": {
+                  "visibility": "advanced"
+                },
+                "expiresAt": {
+                  "visibility": "advanced"
+                },
+                "snapshotId": {
+                  "visibility": "hidden"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-sales:Earner": {
+              "fields": {
+                "displayName": {
+                  "label": "Name",
+                  "order": 1
+                },
+                "status": {
+                  "order": 2
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "kind": {
+                  "visibility": "advanced"
+                },
+                "profileId": {
+                  "visibility": "advanced"
+                },
+                "payoutMethod": {
+                  "visibility": "advanced"
+                },
+                "payoutDestination": {
+                  "visibility": "advanced"
+                },
+                "payoutThresholdCents": {
+                  "visibility": "advanced"
+                },
+                "payoutScheduleKey": {
+                  "visibility": "advanced"
+                },
+                "currency": {
+                  "visibility": "advanced"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-sales:Commission": {
+              "fields": {
+                "earnerId": {
+                  "label": "Affiliate",
+                  "order": 1
+                },
+                "amountCents": {
+                  "label": "Amount",
+                  "order": 2
+                },
+                "currency": {
+                  "order": 3
+                },
+                "status": {
+                  "order": 4
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "earningEventId": {
+                  "visibility": "hidden"
+                },
+                "planKey": {
+                  "visibility": "advanced"
+                },
+                "planVersion": {
+                  "visibility": "hidden"
+                },
+                "componentKey": {
+                  "visibility": "hidden"
+                },
+                "termsSnapshotKind": {
+                  "visibility": "hidden"
+                },
+                "termsSnapshotId": {
+                  "visibility": "hidden"
+                },
+                "basis": {
+                  "visibility": "advanced"
+                },
+                "baseAmountCents": {
+                  "visibility": "advanced"
+                },
+                "rate": {
+                  "visibility": "advanced"
+                },
+                "shareFraction": {
+                  "visibility": "hidden"
+                },
+                "splitGroupId": {
+                  "visibility": "hidden"
+                },
+                "clearingEndsAt": {
+                  "visibility": "advanced"
+                },
+                "earnedAt": {
+                  "visibility": "advanced"
+                },
+                "approvedAt": {
+                  "visibility": "advanced"
+                },
+                "payableAt": {
+                  "visibility": "advanced"
+                },
+                "paidAt": {
+                  "visibility": "advanced"
+                },
+                "payoutId": {
+                  "visibility": "advanced"
+                },
+                "sourceKind": {
+                  "visibility": "hidden"
+                },
+                "sourceId": {
+                  "visibility": "hidden"
+                },
+                "calculationTrace": {
+                  "visibility": "hidden"
+                },
+                "dedupeKey": {
+                  "visibility": "hidden"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-sales:CommissionPayout": {
+              "fields": {
+                "earnerId": {
+                  "label": "Affiliate",
+                  "order": 1
+                },
+                "totalAmountCents": {
+                  "label": "Total",
+                  "order": 2
+                },
+                "currency": {
+                  "order": 3
+                },
+                "status": {
+                  "order": 4
+                },
+                "paidAt": {
+                  "order": 5
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "periodStart": {
+                  "visibility": "advanced"
+                },
+                "periodEnd": {
+                  "visibility": "advanced"
+                },
+                "commissionTotalCents": {
+                  "visibility": "advanced"
+                },
+                "adjustmentTotalCents": {
+                  "visibility": "advanced"
+                },
+                "payoutMethod": {
+                  "visibility": "advanced"
+                },
+                "payoutDestination": {
+                  "visibility": "advanced"
+                },
+                "paymentReference": {
+                  "visibility": "advanced"
+                },
+                "providerRef": {
+                  "visibility": "hidden"
+                },
+                "invoiceId": {
+                  "visibility": "hidden"
+                },
+                "notes": {
+                  "visibility": "advanced"
+                },
+                "idempotencyKey": {
+                  "visibility": "hidden"
+                },
+                "sourceKind": {
+                  "visibility": "hidden"
+                },
+                "sourceId": {
+                  "visibility": "hidden"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            }
+          },
+          "help": {
+            "markdown": "## Overview\n\nAffiliates lets partners and customers send people your way and earn a reward\nwhen it leads to a sale. You set up a program that says what a referral earns,\nsign up the people who will refer, record each person they send, and see what\neach affiliate has earned and what has been paid out.\n\n## Tasks\n\n### Sign up an affiliate\n\n1. Open the list of affiliates and choose **New**.\n2. Type their **{field:Referrer.displayName}**.\n3. Save. They stay pending until you approve them by setting the **{field:Referrer.status}**.\n\n### Set up a program\n\n1. Open the programs and choose **New**.\n2. Give the program a **{field:ReferralProgram.name}** your affiliates will understand.\n3. Set the **{field:ReferralProgram.status}** to active when you are ready to start.\n4. Save.\n\n### Record a referral\n\n1. Open the referrals and choose **New**.\n2. Pick the **{field:Referral.referrerId}** who sent the person and the **{field:Referral.programId}** it belongs to.\n3. Save. The referral stays pending until it leads to a sale.\n\n### Check what an affiliate has earned\n\n1. Open the commissions and find the affiliate.\n2. Read the **{field:Commission.amountCents}** and the **{field:Commission.status}** of each one.\n3. A commission moves from pending to approved, then payable, then paid as it is worked through.\n\n### Check a payout\n\nPayouts are made by the commission payout service, not by hand in the app. You\ncan see what has been paid.\n\n1. Open the payouts.\n2. Read the **{field:CommissionPayout.earnerId}**, the **{field:CommissionPayout.totalAmountCents}** and the **{field:CommissionPayout.status}**.\n3. A payout is waiting, approved, being sent, then completed. It shows failed or rejected if the money did not go out.\n",
+            "fieldRefs": [
+              "Commission.amountCents",
+              "Commission.status",
+              "CommissionPayout.earnerId",
+              "CommissionPayout.status",
+              "CommissionPayout.totalAmountCents",
+              "Referral.programId",
+              "Referral.referrerId",
+              "ReferralProgram.name",
+              "ReferralProgram.status",
+              "Referrer.displayName",
+              "Referrer.status"
+            ]
+          },
+          "demo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package does not build for a browser: node:crypto; and its package depends on @happyvertical/smrt-tenancy, which do not build for a browser (#3624)."
+            ]
+          }
+        },
         {
           "id": "sales.pipeline",
           "label": "Leads & pipeline",
@@ -67777,7 +68921,7 @@
     {
       "id": "sites",
       "packageName": "@happyvertical/smrt-sites",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Site lifecycle management for multi-tenant SMRT networks",
       "models": [
         {
@@ -68245,7 +69389,7 @@
     {
       "id": "social",
       "packageName": "@happyvertical/smrt-social",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Social media account management for multi-platform publishing in the SMRT ecosystem",
       "models": [
         {
@@ -69232,7 +70376,7 @@
     {
       "id": "subscriptions",
       "packageName": "@happyvertical/smrt-subscriptions",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Tenant subscriptions, entitlement resolution, usage thresholds, and subscription UI for SMRT",
       "models": [
         {
@@ -71425,7 +72569,7 @@
     {
       "id": "support",
       "packageName": "@happyvertical/smrt-support",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "AI-first Support Cases: channel-neutral intake, lifecycle, routing, service targets, and service time for the SMRT framework",
       "models": [
         {
@@ -72030,17 +73174,20 @@
             {
               "name": "caseNumber",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "The reference number for this ticket."
             },
             {
               "name": "subject",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "A short summary of what the customer needs."
             },
             {
               "name": "description",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "What the customer asked for, in their words."
             },
             {
               "name": "status",
@@ -72055,12 +73202,14 @@
                 "escalated",
                 "resolved",
                 "closed"
-              ]
+              ],
+              "description": "Where the ticket stands, from new to resolved."
             },
             {
               "name": "priority",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "How soon it needs attention: low, normal, high or urgent."
             },
             {
               "name": "severity",
@@ -72086,7 +73235,8 @@
               "name": "clientProfileId",
               "type": "crossPackageRef",
               "required": false,
-              "related": "@happyvertical/smrt-profiles:Profile"
+              "related": "@happyvertical/smrt-profiles:Profile",
+              "description": "The customer who asked for help."
             },
             {
               "name": "openedByProfileId",
@@ -72125,7 +73275,8 @@
               "name": "assignedSpecialistId",
               "type": "foreignKey",
               "required": false,
-              "related": "@happyvertical/smrt-support:SupportSpecialist"
+              "related": "@happyvertical/smrt-support:SupportSpecialist",
+              "description": "The team member handling this ticket."
             },
             {
               "name": "assignedAt",
@@ -73244,7 +74395,8 @@
               "name": "caseId",
               "type": "foreignKey",
               "required": true,
-              "related": "@happyvertical/smrt-support:SupportCase"
+              "related": "@happyvertical/smrt-support:SupportCase",
+              "description": "The ticket this message belongs to."
             },
             {
               "name": "direction",
@@ -73254,7 +74406,8 @@
                 "inbound",
                 "outbound",
                 "internal"
-              ]
+              ],
+              "description": "Whether the customer sent it or your team did."
             },
             {
               "name": "channelKind",
@@ -73289,12 +74442,14 @@
             {
               "name": "occurredAt",
               "type": "datetime",
-              "required": false
+              "required": false,
+              "description": "When the message was sent."
             },
             {
               "name": "body",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "What the message says."
             },
             {
               "name": "sourceType",
@@ -74299,12 +75454,14 @@
               "name": "profileId",
               "type": "crossPackageRef",
               "required": true,
-              "related": "@happyvertical/smrt-profiles:Profile"
+              "related": "@happyvertical/smrt-profiles:Profile",
+              "description": "The profile of the person on your team."
             },
             {
               "name": "displayName",
               "type": "text",
-              "required": false
+              "required": false,
+              "description": "The name your team and customers see."
             },
             {
               "name": "status",
@@ -74313,7 +75470,8 @@
               "enum": [
                 "active",
                 "inactive"
-              ]
+              ],
+              "description": "Whether this person is taking tickets right now."
             },
             {
               "name": "languages",
@@ -74612,12 +75770,270 @@
           "@happyvertical/smrt-timesheets",
           "@happyvertical/smrt-users"
         ]
-      }
+      },
+      "recipes": [
+        {
+          "id": "support.tickets",
+          "label": "Support",
+          "summary": "Keep every customer request for help in one place until it is solved.",
+          "synonyms": [
+            "support tickets",
+            "tickets",
+            "helpdesk",
+            "help desk",
+            "customer support",
+            "cases"
+          ],
+          "models": [
+            "@happyvertical/smrt-support:SupportCase",
+            "@happyvertical/smrt-support:SupportInteraction",
+            "@happyvertical/smrt-support:SupportSpecialist"
+          ],
+          "nav": [
+            {
+              "label": "Tickets",
+              "model": "@happyvertical/smrt-support:SupportCase",
+              "icon": "fileText",
+              "description": "Every request for help, who is handling it and where it stands.",
+              "noun": "ticket"
+            },
+            {
+              "label": "Messages",
+              "model": "@happyvertical/smrt-support:SupportInteraction",
+              "icon": "book",
+              "description": "What was said on each ticket, by the customer or your team.",
+              "noun": "message"
+            },
+            {
+              "label": "Support team",
+              "model": "@happyvertical/smrt-support:SupportSpecialist",
+              "icon": "users",
+              "description": "The people who answer tickets and when they are available.",
+              "noun": "team member"
+            }
+          ],
+          "requires": [],
+          "section": {
+            "id": "support",
+            "label": "Support",
+            "icon": "users",
+            "description": "Help your customers and keep track of every request."
+          },
+          "options": {
+            "@happyvertical/smrt-support:SupportCase": {
+              "fields": {
+                "caseNumber": {
+                  "label": "Ticket number",
+                  "order": 1
+                },
+                "subject": {
+                  "order": 2
+                },
+                "description": {
+                  "order": 3
+                },
+                "status": {
+                  "order": 4
+                },
+                "priority": {
+                  "order": 5
+                },
+                "clientProfileId": {
+                  "label": "Customer",
+                  "order": 6
+                },
+                "assignedSpecialistId": {
+                  "label": "Assigned to",
+                  "order": 7
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "assignedAt": {
+                  "visibility": "hidden"
+                },
+                "escalatedAt": {
+                  "visibility": "hidden"
+                },
+                "acknowledgedAt": {
+                  "visibility": "hidden"
+                },
+                "firstRespondedAt": {
+                  "visibility": "hidden"
+                },
+                "humanRequestedAt": {
+                  "visibility": "hidden"
+                },
+                "resolvedAt": {
+                  "visibility": "hidden"
+                },
+                "closedAt": {
+                  "visibility": "hidden"
+                },
+                "lastReopenedAt": {
+                  "visibility": "hidden"
+                },
+                "severity": {
+                  "visibility": "advanced"
+                },
+                "category": {
+                  "visibility": "advanced"
+                },
+                "sensitive": {
+                  "visibility": "advanced"
+                },
+                "channelKind": {
+                  "visibility": "advanced"
+                },
+                "openedByProfileId": {
+                  "visibility": "advanced"
+                },
+                "resolutionSummary": {
+                  "visibility": "advanced"
+                },
+                "projectId": {
+                  "visibility": "hidden"
+                },
+                "bindingId": {
+                  "visibility": "hidden"
+                },
+                "threadKey": {
+                  "visibility": "hidden"
+                },
+                "planId": {
+                  "visibility": "hidden"
+                },
+                "planSnapshot": {
+                  "visibility": "hidden"
+                },
+                "preferredSpecialistId": {
+                  "visibility": "hidden"
+                },
+                "escalationLevel": {
+                  "visibility": "hidden"
+                },
+                "resolvedByProfileId": {
+                  "visibility": "hidden"
+                },
+                "resolutionKind": {
+                  "visibility": "hidden"
+                },
+                "reopenCount": {
+                  "visibility": "hidden"
+                },
+                "aiEnabled": {
+                  "visibility": "hidden"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-support:SupportInteraction": {
+              "fields": {
+                "body": {
+                  "label": "Message",
+                  "order": 1
+                },
+                "caseId": {
+                  "label": "Ticket",
+                  "order": 2
+                },
+                "direction": {
+                  "order": 3
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "channelKind": {
+                  "visibility": "advanced"
+                },
+                "actorKind": {
+                  "visibility": "advanced"
+                },
+                "authorProfileId": {
+                  "visibility": "advanced"
+                },
+                "sourceType": {
+                  "visibility": "hidden"
+                },
+                "sourceId": {
+                  "visibility": "hidden"
+                },
+                "sourceKey": {
+                  "visibility": "hidden"
+                },
+                "rfcMessageId": {
+                  "visibility": "hidden"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            },
+            "@happyvertical/smrt-support:SupportSpecialist": {
+              "fields": {
+                "displayName": {
+                  "label": "Name",
+                  "order": 1
+                },
+                "status": {
+                  "order": 2
+                },
+                "tenantId": {
+                  "visibility": "hidden"
+                },
+                "profileId": {
+                  "visibility": "advanced"
+                },
+                "languages": {
+                  "visibility": "advanced"
+                },
+                "timezone": {
+                  "visibility": "advanced"
+                },
+                "maxConcurrentCases": {
+                  "label": "Most tickets at once",
+                  "visibility": "advanced"
+                },
+                "onCallPriority": {
+                  "visibility": "hidden"
+                },
+                "notes": {
+                  "visibility": "advanced"
+                },
+                "metadata": {
+                  "visibility": "hidden"
+                }
+              }
+            }
+          },
+          "help": {
+            "markdown": "## Overview\n\nSupport keeps every request for help from a customer in one place. Each request\nis a ticket with a number, a subject, who asked, who is handling it and where\nit stands, from new to resolved. Messages back and forth stay on the ticket, so\nanyone on the team can pick it up and see what was said.\n\n## Tasks\n\nTickets and their messages are created by your support channels (email, chat\nand the like) and by the support service, not by hand in the app. Here you\nread them and see where each one stands.\n\n### Find a ticket\n\n1. Open the list of tickets.\n2. Look at the **{field:SupportCase.subject}**, the **{field:SupportCase.status}** and the **{field:SupportCase.priority}** to see what needs attention.\n3. Open a ticket to see who it is **{field:SupportCase.assignedSpecialistId}** and the **{field:SupportCase.description}**.\n\n### Read the history of a ticket\n\n1. Open the list of messages.\n2. Find the **{field:SupportInteraction.caseId}** you are interested in.\n3. Read the **{field:SupportInteraction.body}** of each message, oldest first.\n\n### Add someone to the support team\n\n1. Open the support team and choose **New**.\n2. Type the person's **{field:SupportSpecialist.displayName}**.\n3. Save. They can now be given tickets by the support service.\n",
+            "fieldRefs": [
+              "SupportCase.assignedSpecialistId",
+              "SupportCase.description",
+              "SupportCase.priority",
+              "SupportCase.status",
+              "SupportCase.subject",
+              "SupportInteraction.body",
+              "SupportInteraction.caseId",
+              "SupportSpecialist.displayName"
+            ]
+          },
+          "demo": {
+            "mode": "server",
+            "reasons": [
+              "Needs a server because its package does not build for a browser: core migrations (node:os); and its package depends on @happyvertical/smrt-agents, @happyvertical/smrt-chat, @happyvertical/smrt-images, @happyvertical/smrt-jobs, @happyvertical/smrt-profiles, @happyvertical/smrt-projects, @happyvertical/smrt-reports, @happyvertical/smrt-secrets, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, @happyvertical/smrt-timesheets, @happyvertical/smrt-users, which do not build for a browser (#3615, #3617, #3624, #3625, #3626, #3627, #3628)."
+            ]
+          }
+        }
+      ]
     },
     {
       "id": "tags",
       "packageName": "@happyvertical/smrt-tags",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Reusable tagging system with hierarchies, contexts, and multi-language support for SMRT framework",
       "models": [
         {
@@ -75396,7 +76812,7 @@
     {
       "id": "timesheets",
       "packageName": "@happyvertical/smrt-timesheets",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Shared time entries for the SMRT framework: who worked how long on what, approval and correction, with immutable charge and compensation snapshots",
       "models": [
         {
@@ -76928,7 +78344,7 @@
     {
       "id": "users",
       "packageName": "@happyvertical/smrt-users",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Multi-tenant user management for the SMRT framework - users, tenants, roles, permissions, groups",
       "models": [
         {
@@ -81484,7 +82900,7 @@
     {
       "id": "video",
       "packageName": "@happyvertical/smrt-video",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Video content management for AI-powered video production in the SMRT ecosystem",
       "models": [
         {
@@ -88861,7 +90277,7 @@
     {
       "id": "voice",
       "packageName": "@happyvertical/smrt-voice",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Voice profile management for AI-powered voice synthesis and cloning in the SMRT ecosystem",
       "models": [
         {
@@ -90321,7 +91737,7 @@
     {
       "id": "webhooks",
       "packageName": "@happyvertical/smrt-webhooks",
-      "version": "0.57.34",
+      "version": "0.57.36",
       "description": "Outbound webhook subscriptions, signed delivery, and durable retries",
       "models": [
         {