@happyvertical/smrt-products 0.56.0 → 0.56.2

package/dist/lib/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-products",
-  "packageVersion": "0.56.0",
+  "packageVersion": "0.56.2",
   "sourceManifestPath": "dist/lib/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "e0ef42e5fedb51f787d68f6e8d1c1a8b229ffa066964c56f0049723d19591369",
-    "packageJson": "3d13af659c15147e5ac26936107ef5b9f7af77d26bc4bd6a5b7b8572fdd35b12",
+    "manifest": "eb59c8541103b0779e6a31738c6bf432f3a4e3c45ad33c4d508e9e6b7bbd31b2",
+    "packageJson": "c6eb9b4d9ed2fe6ac7cfd7865bb575551af14f8beedb003c9626f56dee837534",
     "agents": "b5aa86a9c02bb81be5621ae3397ff2dedcef972a520c2ba2f56ee7abf5613b8c"
   },
   "exports": [
@@ -79,7 +79,7 @@
     "typescript"
   ],
   "risks": [
-    "cross-package-refs:1",
+    "cross-package-refs:5",
     "sensitive-fields-excluded",
     "sti-inheritance"
   ],
@@ -104,24 +104,19 @@
         }
       ],
       "surfaces": [
-        {
-          "kind": "api",
-          "name": "categories.getRootCategories",
-          "operation": "getRootCategories",
-          "objectName": "@happyvertical/smrt-products:CategoryCollection",
-          "path": "/categories/getRootCategories",
-          "method": "POST"
-        },
         {
           "kind": "cli",
           "name": "categorycollection_getRootCategories",
           "operation": "getRootCategories",
           "objectName": "@happyvertical/smrt-products:CategoryCollection"
-        },
+        }
+      ],
+      "withheldSurfaces": [
         {
-          "kind": "mcp",
-          "name": "categorycollection_getrootcategories",
+          "kind": "api",
           "operation": "getRootCategories",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:CategoryCollection"
         }
       ],
@@ -202,54 +197,6 @@
         }
       ],
       "surfaces": [
-        {
-          "kind": "api",
-          "name": "products.findByManufacturer",
-          "operation": "findByManufacturer",
-          "objectName": "@happyvertical/smrt-products:MaterialCollection",
-          "path": "/products/findByManufacturer",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.findInStock",
-          "operation": "findInStock",
-          "objectName": "@happyvertical/smrt-products:MaterialCollection",
-          "path": "/products/findInStock",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.getAssets",
-          "operation": "getAssets",
-          "objectName": "@happyvertical/smrt-products:MaterialCollection",
-          "path": "/products/getAssets",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.addAsset",
-          "operation": "addAsset",
-          "objectName": "@happyvertical/smrt-products:MaterialCollection",
-          "path": "/products/addAsset",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.removeAsset",
-          "operation": "removeAsset",
-          "objectName": "@happyvertical/smrt-products:MaterialCollection",
-          "path": "/products/removeAsset",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.findByKind",
-          "operation": "findByKind",
-          "objectName": "@happyvertical/smrt-products:MaterialCollection",
-          "path": "/products/findByKind",
-          "method": "POST"
-        },
         {
           "kind": "cli",
           "name": "materialcollection_findByManufacturer",
@@ -285,41 +232,49 @@
           "name": "materialcollection_findByKind",
           "operation": "findByKind",
           "objectName": "@happyvertical/smrt-products:MaterialCollection"
-        },
+        }
+      ],
+      "withheldSurfaces": [
         {
-          "kind": "mcp",
-          "name": "materialcollection_findbymanufacturer",
-          "operation": "findByManufacturer",
+          "kind": "api",
+          "operation": "addAsset",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:MaterialCollection"
         },
         {
-          "kind": "mcp",
-          "name": "materialcollection_findinstock",
-          "operation": "findInStock",
+          "kind": "api",
+          "operation": "findByKind",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:MaterialCollection"
         },
         {
-          "kind": "mcp",
-          "name": "materialcollection_getassets",
-          "operation": "getAssets",
+          "kind": "api",
+          "operation": "findByManufacturer",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:MaterialCollection"
         },
         {
-          "kind": "mcp",
-          "name": "materialcollection_addasset",
-          "operation": "addAsset",
+          "kind": "api",
+          "operation": "findInStock",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:MaterialCollection"
         },
         {
-          "kind": "mcp",
-          "name": "materialcollection_removeasset",
-          "operation": "removeAsset",
+          "kind": "api",
+          "operation": "getAssets",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:MaterialCollection"
         },
         {
-          "kind": "mcp",
-          "name": "materialcollection_findbykind",
-          "operation": "findByKind",
+          "kind": "api",
+          "operation": "removeAsset",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:MaterialCollection"
         }
       ],
@@ -556,46 +511,6 @@
         }
       ],
       "surfaces": [
-        {
-          "kind": "api",
-          "name": "products.findByManufacturer",
-          "operation": "findByManufacturer",
-          "objectName": "@happyvertical/smrt-products:ProductCollection",
-          "path": "/products/findByManufacturer",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.findInStock",
-          "operation": "findInStock",
-          "objectName": "@happyvertical/smrt-products:ProductCollection",
-          "path": "/products/findInStock",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.getAssets",
-          "operation": "getAssets",
-          "objectName": "@happyvertical/smrt-products:ProductCollection",
-          "path": "/products/getAssets",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.addAsset",
-          "operation": "addAsset",
-          "objectName": "@happyvertical/smrt-products:ProductCollection",
-          "path": "/products/addAsset",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "products.removeAsset",
-          "operation": "removeAsset",
-          "objectName": "@happyvertical/smrt-products:ProductCollection",
-          "path": "/products/removeAsset",
-          "method": "POST"
-        },
         {
           "kind": "cli",
           "name": "productcollection_findByManufacturer",
@@ -625,35 +540,42 @@
           "name": "productcollection_removeAsset",
           "operation": "removeAsset",
           "objectName": "@happyvertical/smrt-products:ProductCollection"
+        }
+      ],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "addAsset",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-products:ProductCollection"
         },
         {
-          "kind": "mcp",
-          "name": "productcollection_findbymanufacturer",
+          "kind": "api",
           "operation": "findByManufacturer",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:ProductCollection"
         },
         {
-          "kind": "mcp",
-          "name": "productcollection_findinstock",
+          "kind": "api",
           "operation": "findInStock",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:ProductCollection"
         },
         {
-          "kind": "mcp",
-          "name": "productcollection_getassets",
+          "kind": "api",
           "operation": "getAssets",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:ProductCollection"
         },
         {
-          "kind": "mcp",
-          "name": "productcollection_addasset",
-          "operation": "addAsset",
-          "objectName": "@happyvertical/smrt-products:ProductCollection"
-        },
-        {
-          "kind": "mcp",
-          "name": "productcollection_removeasset",
+          "kind": "api",
           "operation": "removeAsset",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:ProductCollection"
         }
       ],
@@ -696,22 +618,6 @@
         }
       ],
       "surfaces": [
-        {
-          "kind": "api",
-          "name": "productvariants.findForProduct",
-          "operation": "findForProduct",
-          "objectName": "@happyvertical/smrt-products:ProductVariantCollection",
-          "path": "/productvariants/findForProduct",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "productvariants.findAxis",
-          "operation": "findAxis",
-          "objectName": "@happyvertical/smrt-products:ProductVariantCollection",
-          "path": "/productvariants/findAxis",
-          "method": "POST"
-        },
         {
           "kind": "cli",
           "name": "productvariantcollection_findForProduct",
@@ -723,17 +629,21 @@
           "name": "productvariantcollection_findAxis",
           "operation": "findAxis",
           "objectName": "@happyvertical/smrt-products:ProductVariantCollection"
-        },
+        }
+      ],
+      "withheldSurfaces": [
         {
-          "kind": "mcp",
-          "name": "productvariantcollection_findforproduct",
-          "operation": "findForProduct",
+          "kind": "api",
+          "operation": "findAxis",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:ProductVariantCollection"
         },
         {
-          "kind": "mcp",
-          "name": "productvariantcollection_findaxis",
-          "operation": "findAxis",
+          "kind": "api",
+          "operation": "findForProduct",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:ProductVariantCollection"
         }
       ],
@@ -802,46 +712,6 @@
         }
       ],
       "surfaces": [
-        {
-          "kind": "api",
-          "name": "skus.findByCode",
-          "operation": "findByCode",
-          "objectName": "@happyvertical/smrt-products:SkuCollection",
-          "path": "/skus/findByCode",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "skus.findByBarcode",
-          "operation": "findByBarcode",
-          "objectName": "@happyvertical/smrt-products:SkuCollection",
-          "path": "/skus/findByBarcode",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "skus.findByProduct",
-          "operation": "findByProduct",
-          "objectName": "@happyvertical/smrt-products:SkuCollection",
-          "path": "/skus/findByProduct",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "skus.findByParent",
-          "operation": "findByParent",
-          "objectName": "@happyvertical/smrt-products:SkuCollection",
-          "path": "/skus/findByParent",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "skus.findActive",
-          "operation": "findActive",
-          "objectName": "@happyvertical/smrt-products:SkuCollection",
-          "path": "/skus/findActive",
-          "method": "POST"
-        },
         {
           "kind": "cli",
           "name": "skucollection_findByCode",
@@ -871,35 +741,42 @@
           "name": "skucollection_findActive",
           "operation": "findActive",
           "objectName": "@happyvertical/smrt-products:SkuCollection"
-        },
+        }
+      ],
+      "withheldSurfaces": [
         {
-          "kind": "mcp",
-          "name": "skucollection_findbycode",
-          "operation": "findByCode",
+          "kind": "api",
+          "operation": "findActive",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:SkuCollection"
         },
         {
-          "kind": "mcp",
-          "name": "skucollection_findbybarcode",
+          "kind": "api",
           "operation": "findByBarcode",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:SkuCollection"
         },
         {
-          "kind": "mcp",
-          "name": "skucollection_findbyproduct",
-          "operation": "findByProduct",
+          "kind": "api",
+          "operation": "findByCode",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:SkuCollection"
         },
         {
-          "kind": "mcp",
-          "name": "skucollection_findbyparent",
+          "kind": "api",
           "operation": "findByParent",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:SkuCollection"
         },
         {
-          "kind": "mcp",
-          "name": "skucollection_findactive",
-          "operation": "findActive",
+          "kind": "api",
+          "operation": "findByProduct",
+          "code": "not-included",
+          "reason": "not listed in api.include",
           "objectName": "@happyvertical/smrt-products:SkuCollection"
         }
       ],
@@ -1156,6 +1033,22 @@
           "default": 0,
           "description": "The price in minor units (cents), for example 1999 for 19.99."
         },
+        {
+          "name": "defaultSalesTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID",
+          "description": "The tax code normally used when this product is sold."
+        },
+        {
+          "name": "defaultPurchaseTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID",
+          "description": "The tax code normally used when this product is purchased."
+        },
         {
           "name": "inStock",
           "type": "boolean",
@@ -1196,7 +1089,22 @@
           "default": 0
         }
       ],
-      "relationships": [],
+      "relationships": [
+        {
+          "name": "defaultSalesTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID"
+        },
+        {
+          "name": "defaultPurchaseTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID"
+        }
+      ],
       "methods": [
         "addAsset",
         "getAssets",
@@ -1400,6 +1308,7 @@
         }
       ],
       "relationshipFeatures": [
+        "crossPackageRef",
         "uuidColumns"
       ],
       "tags": [],
@@ -1479,6 +1388,22 @@
           "default": 0,
           "description": "The price in minor units (cents), for example 1999 for 19.99."
         },
+        {
+          "name": "defaultSalesTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID",
+          "description": "The tax code normally used when this product is sold."
+        },
+        {
+          "name": "defaultPurchaseTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID",
+          "description": "The tax code normally used when this product is purchased."
+        },
         {
           "name": "inStock",
           "type": "boolean",
@@ -1501,7 +1426,22 @@
           "default": []
         }
       ],
-      "relationships": [],
+      "relationships": [
+        {
+          "name": "defaultSalesTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID"
+        },
+        {
+          "name": "defaultPurchaseTaxCodeId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-commerce:TaxCode",
+          "columnType": "UUID"
+        }
+      ],
       "methods": [
         "addAsset",
         "getAssets",
@@ -1711,6 +1651,7 @@
         }
       ],
       "relationshipFeatures": [
+        "crossPackageRef",
         "uuidColumns"
       ],
       "tags": [],
@@ -2200,74 +2141,12 @@
     }
   ],
   "surfaces": [
-    {
-      "kind": "api",
-      "name": "categories.getRootCategories",
-      "operation": "getRootCategories",
-      "objectName": "@happyvertical/smrt-products:CategoryCollection",
-      "path": "/categories/getRootCategories",
-      "method": "POST"
-    },
     {
       "kind": "cli",
       "name": "categorycollection_getRootCategories",
       "operation": "getRootCategories",
       "objectName": "@happyvertical/smrt-products:CategoryCollection"
     },
-    {
-      "kind": "mcp",
-      "name": "categorycollection_getrootcategories",
-      "operation": "getRootCategories",
-      "objectName": "@happyvertical/smrt-products:CategoryCollection"
-    },
-    {
-      "kind": "api",
-      "name": "products.findByManufacturer",
-      "operation": "findByManufacturer",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection",
-      "path": "/products/findByManufacturer",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.findInStock",
-      "operation": "findInStock",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection",
-      "path": "/products/findInStock",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.getAssets",
-      "operation": "getAssets",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection",
-      "path": "/products/getAssets",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.addAsset",
-      "operation": "addAsset",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection",
-      "path": "/products/addAsset",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.removeAsset",
-      "operation": "removeAsset",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection",
-      "path": "/products/removeAsset",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.findByKind",
-      "operation": "findByKind",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection",
-      "path": "/products/findByKind",
-      "method": "POST"
-    },
     {
       "kind": "cli",
       "name": "materialcollection_findByManufacturer",
@@ -2304,82 +2183,6 @@
       "operation": "findByKind",
       "objectName": "@happyvertical/smrt-products:MaterialCollection"
     },
-    {
-      "kind": "mcp",
-      "name": "materialcollection_findbymanufacturer",
-      "operation": "findByManufacturer",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "materialcollection_findinstock",
-      "operation": "findInStock",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "materialcollection_getassets",
-      "operation": "getAssets",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "materialcollection_addasset",
-      "operation": "addAsset",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "materialcollection_removeasset",
-      "operation": "removeAsset",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "materialcollection_findbykind",
-      "operation": "findByKind",
-      "objectName": "@happyvertical/smrt-products:MaterialCollection"
-    },
-    {
-      "kind": "api",
-      "name": "products.findByManufacturer",
-      "operation": "findByManufacturer",
-      "objectName": "@happyvertical/smrt-products:ProductCollection",
-      "path": "/products/findByManufacturer",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.findInStock",
-      "operation": "findInStock",
-      "objectName": "@happyvertical/smrt-products:ProductCollection",
-      "path": "/products/findInStock",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.getAssets",
-      "operation": "getAssets",
-      "objectName": "@happyvertical/smrt-products:ProductCollection",
-      "path": "/products/getAssets",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.addAsset",
-      "operation": "addAsset",
-      "objectName": "@happyvertical/smrt-products:ProductCollection",
-      "path": "/products/addAsset",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "products.removeAsset",
-      "operation": "removeAsset",
-      "objectName": "@happyvertical/smrt-products:ProductCollection",
-      "path": "/products/removeAsset",
-      "method": "POST"
-    },
     {
       "kind": "cli",
       "name": "productcollection_findByManufacturer",
@@ -2410,52 +2213,6 @@
       "operation": "removeAsset",
       "objectName": "@happyvertical/smrt-products:ProductCollection"
     },
-    {
-      "kind": "mcp",
-      "name": "productcollection_findbymanufacturer",
-      "operation": "findByManufacturer",
-      "objectName": "@happyvertical/smrt-products:ProductCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "productcollection_findinstock",
-      "operation": "findInStock",
-      "objectName": "@happyvertical/smrt-products:ProductCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "productcollection_getassets",
-      "operation": "getAssets",
-      "objectName": "@happyvertical/smrt-products:ProductCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "productcollection_addasset",
-      "operation": "addAsset",
-      "objectName": "@happyvertical/smrt-products:ProductCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "productcollection_removeasset",
-      "operation": "removeAsset",
-      "objectName": "@happyvertical/smrt-products:ProductCollection"
-    },
-    {
-      "kind": "api",
-      "name": "productvariants.findForProduct",
-      "operation": "findForProduct",
-      "objectName": "@happyvertical/smrt-products:ProductVariantCollection",
-      "path": "/productvariants/findForProduct",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "productvariants.findAxis",
-      "operation": "findAxis",
-      "objectName": "@happyvertical/smrt-products:ProductVariantCollection",
-      "path": "/productvariants/findAxis",
-      "method": "POST"
-    },
     {
       "kind": "cli",
       "name": "productvariantcollection_findForProduct",
@@ -2468,58 +2225,6 @@
       "operation": "findAxis",
       "objectName": "@happyvertical/smrt-products:ProductVariantCollection"
     },
-    {
-      "kind": "mcp",
-      "name": "productvariantcollection_findforproduct",
-      "operation": "findForProduct",
-      "objectName": "@happyvertical/smrt-products:ProductVariantCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "productvariantcollection_findaxis",
-      "operation": "findAxis",
-      "objectName": "@happyvertical/smrt-products:ProductVariantCollection"
-    },
-    {
-      "kind": "api",
-      "name": "skus.findByCode",
-      "operation": "findByCode",
-      "objectName": "@happyvertical/smrt-products:SkuCollection",
-      "path": "/skus/findByCode",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "skus.findByBarcode",
-      "operation": "findByBarcode",
-      "objectName": "@happyvertical/smrt-products:SkuCollection",
-      "path": "/skus/findByBarcode",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "skus.findByProduct",
-      "operation": "findByProduct",
-      "objectName": "@happyvertical/smrt-products:SkuCollection",
-      "path": "/skus/findByProduct",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "skus.findByParent",
-      "operation": "findByParent",
-      "objectName": "@happyvertical/smrt-products:SkuCollection",
-      "path": "/skus/findByParent",
-      "method": "POST"
-    },
-    {
-      "kind": "api",
-      "name": "skus.findActive",
-      "operation": "findActive",
-      "objectName": "@happyvertical/smrt-products:SkuCollection",
-      "path": "/skus/findActive",
-      "method": "POST"
-    },
     {
       "kind": "cli",
       "name": "skucollection_findByCode",
@@ -2550,36 +2255,6 @@
       "operation": "findActive",
       "objectName": "@happyvertical/smrt-products:SkuCollection"
     },
-    {
-      "kind": "mcp",
-      "name": "skucollection_findbycode",
-      "operation": "findByCode",
-      "objectName": "@happyvertical/smrt-products:SkuCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "skucollection_findbybarcode",
-      "operation": "findByBarcode",
-      "objectName": "@happyvertical/smrt-products:SkuCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "skucollection_findbyproduct",
-      "operation": "findByProduct",
-      "objectName": "@happyvertical/smrt-products:SkuCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "skucollection_findbyparent",
-      "operation": "findByParent",
-      "objectName": "@happyvertical/smrt-products:SkuCollection"
-    },
-    {
-      "kind": "mcp",
-      "name": "skucollection_findactive",
-      "operation": "findActive",
-      "objectName": "@happyvertical/smrt-products:SkuCollection"
-    },
     {
       "kind": "api",
       "name": "categories.list",
@@ -3038,11 +2713,11 @@
   "prompts": [],
   "relationshipsV2": {
     "foreignKeyFields": 2,
-    "crossPackageRefFields": 1,
+    "crossPackageRefFields": 5,
     "junctionCollections": 1,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 30
+    "uuidColumns": 38
   },
   "agentDoc": "# @happyvertical/smrt-products\n\nProduct catalog — reference template for triple-consumption: npm package library, module federation, and standalone REST API server.\n\n## Models\n\n- **Product**: STI base. Tenant-scoped (`@TenantScoped({ mode: 'optional' })`, nullable `tenantId`). Knowledge base product with specs, tags, and the `productType` discriminator. Consumers subclass this with vertical-specific subtypes (apparel `Style`, automotive `Model`, furniture `Design`, etc.).\n- **Material**: STI subtype. Raw input consumed by manufacturing (fabric, trim, thread, packaging, component). Meta fields: `materialKind`, `uom`, `costPerUnit`. Materials are first-class products in the catalog — the SAP/NetSuite pattern. Bills of materials in `@happyvertical/smrt-manufacturing` reference Materials by id.\n- **Assembly** (`ProductType.ASSEMBLY`, `'assembly'`): the made counterpart to `Material`, defined in `@happyvertical/smrt-manufacturing` as a cross-package STI subtype. Its own fields are columns on `products`; the enum value lives here so catalog code can filter by type without importing manufacturing.\n- **ProductVariant**: standalone (NOT a Product STI subtype). Declarative axis definition: `productId`, `axisName` (e.g. `'size'`, `'color'`, `'finish'`), `allowedValues` (JSON-stored array), optional `label` and `sortOrder`. Per-SKU value pins live on `Sku.attributes`. Lives in its own `product_variants` table; `conflictColumns: ['product_id', 'axis_name', 'tenant_id']`.\n- **Sku**: standalone. The smallest sellable / countable unit. `productId` points at a `Product` or any of its STI subtypes; `code` is the human-meaningful identifier; `attributes` JSON pins each axis value (`{ size: 'M', color: 'navy' }`). Lives in its own `product_skus` table; `conflictColumns: ['code', 'tenant_id']`. Stock balance and movement history for a Sku live in `@happyvertical/smrt-inventory`.\n- **ProductAsset**: dedicated owned-asset join in `product_assets` with `relationship` and `sortOrder`. Tenant-scoped to match Product.\n- **Category**: hierarchical (parentId, level, productCount). STI base, tenant-scoped.\n\n## Vertical-specific Product subtypes\n\nThis package deliberately ships ONLY the generic primitives. Domain-specific top-level item types live in the consumer's template:\n\n- Apparel: `Style extends Product`, `Makeup extends Product`\n- Furniture: `Design extends Product`, `Configuration extends Product`\n- Automotive: `Model extends Product`, `Trim extends Product`\n- CPG: `Brand extends Product`, `Recipe extends Product`\n\nEach is a small subclass: `@smrt()`, override `productType`, add `@meta()` fields. See `packages/template-apparel-erp` for a worked example.\n\n## Variants — the two concepts\n\nThe framework's variant story uses two distinct primitives that look similar but do different jobs:\n\n- **`ProductVariant`** — *axis declaration*. \"For product X, axis `size` accepts the values `[XS, S, M, L, XL]`.\" Drives form/UI choices.\n- **`Sku.attributes`** — *per-unit value pins*. `{ color: 'navy', size: 'M' }` on each concrete sellable SKU.\n\nBoth live in this package — all catalog shapes are here. Stock motion (where the SKU is, how many, history) lives in `@happyvertical/smrt-inventory`.\n\nThere is deliberately no separate \"catalog grouping above SKU\" row (a la a \"Navy colorway\" row sitting between the Product and its Skus). Group SKUs by axis value via `attributes.color = 'navy'` queries; attach per-axis-value assets via `ProductAsset` rows with relationship metadata. Matches how Shopify, Stripe Products, and most e-commerce platforms model the same shape.\n\n## Collections\n\n- **ProductCollection** — base. Polymorphic queries return the correct subclass instance per row.\n- **MaterialCollection** — STI-filtered subclass. Override `_itemClass`; framework auto-filters by `_meta_type`.\n- **ProductVariantCollection** — standalone collection over `product_variants`. Helpers: `findForProduct(productId)`, `findAxis(productId, axisName)`.\n- **SkuCollection** — standalone collection over `product_skus`. Helpers: `findByCode`, `findByBarcode`, `findByProduct`, `findByParent`, `findActive`.\n- **CategoryCollection** — standard Category CRUD with `getRootCategories()`.\n- **ProductAssetCollection** — direct access to `product_assets` rows and product asset helper wrappers.\n\n## Multi-tenancy\n\nOptional. With `withTenant(id, fn)` (from `@happyvertical/smrt-tenancy`), all queries auto-filter and inserts auto-stamp `tenantId`. Without it, models behave globally (`tenantId = null`). This lets the same package serve both shared reference catalogs and per-merchant SaaS catalogs.\n\n## Triple-Consumption Pattern\n\nSame codebase consumed three ways:\n1. **NPM library**: import classes directly\n2. **Module federation**: runtime component sharing (experimental)\n3. **Standalone API**: `startRestServer([Product, Category])`\n\n## Virtual Modules (Vite)\n\nAuto-generated via Vite plugins: `@happyvertical/smrt-client` (TypeScript client), `@happyvertical/smrt-types`, `@happyvertical/smrt-routes` (Express), `@happyvertical/smrt-mcp`, `@happyvertical/smrt-manifest`.\n\nSvelte 5 stores use runes (`$state`, `$derived`, `$effect`). `product-store.svelte.ts` is the main store (backed by the SMRT client); `product-store.client.svelte.ts` is a virtual-module-free variant for federation builds.\n\n## Client-data runtime — reference store (#1761)\n\nProducts is the reference consumer of the `@happyvertical/smrt-web` browser client-data runtime.\n\n- **Store** — `src/lib/stores/product-collection.ts` (subpath `@happyvertical/smrt-products/stores/product-collection`). `createProductCollection(definition, options)` builds a cached, reactive `SmrtWebCollection<ProductData>` over the generated `/api/v1/products` REST surface via `createSmrtCollection`. It is plugin-agnostic on purpose: the `products` definition is a PARAMETER (not a top-level import), so importing the store never eagerly resolves `@happyvertical/smrt-virt-web` (which exists only under the SMRT Vite plugin) — a unit test / npm consumer supplies its own definition. `productsCollectionDefinition()` lazily resolves the plugin definition (dynamic `import()`; resolved for `tsc` via the `@smrt/web` ambient alias). Deliberately NOT re-exported from the always-loaded `./stores` barrel — importing it is an explicit opt-in to the engine.\n- **Live surface** — `src/lib/components/LiveProductList.svelte` binds the store with `liveCollection` from `@happyvertical/smrt-svelte/web` (live rows + optimistic insert); it takes the definition as a prop. `src/app/pages/LiveProductsPage.svelte` (route `#live`) resolves the component AND the definition via `import()` and passes the definition down.\n- **Code-split (ratified condition ①)** — the ~76 kB TanStack engine must NEVER load on public / smrt-sites pages. `LiveProductsPage` reaches `LiveProductList` and the store ONLY through dynamic `import()`, so the engine lands in a lazily-loaded chunk; the app entry stays engine-free. NEVER import the store or live component statically from an app-root / public entry. `scripts/check-web-engine-code-split.mjs` (wrapped by `src/web-engine-code-split.spec.ts`, `pnpm test:code-split`) proves this against the REAL app graph: it runs the `--mode standalone` vite build and asserts, over the emitted rollup chunk graph, that the entry's static-import closure has zero `@tanstack/*` and the engine is reached only via `dynamicImports`. If the build hits the pre-existing nested-worktree `Tsconfig not found` failure locally, it falls back to a static-import-graph walk of the real `src/app/main.ts` (CI runs the real build).\n\n## Schema migrations (Phase 1 release)\n\nThis package's schema changed shape between the previous release and the Phase 1 apparel-ERP release. Consumers upgrading need to migrate two tables.\n\n### `Sku` rows moved tables\n\nPreviously `Sku` shipped in `@happyvertical/smrt-inventory` under table `inventory_skus`. It now lives here under `product_skus`. Cross-package refs (`StockLevel.skuId`, `BomLine.componentSkuId`) carry plain string ids that still resolve.\n\n**Upgrade procedure** (works on SQLite + Postgres; does NOT rely on `CREATE TABLE AS` which strips constraints):\n\n1. **Boot the new version once** so the framework's lazy `syncSchema` creates `product_skus` with the right PRIMARY KEY, NOT NULL, UNIQUE (`code`, `tenant_id`), and indexes derived from the `Sku` model.\n\n2. **Idempotently copy rows**:\n\n   ```sql\n   BEGIN;\n   INSERT INTO product_skus (\n     id, slug, context, created_at, updated_at,\n     tenant_id, product_id, code, barcode, name,\n     attributes, weight_grams, parent_sku_id, active\n   )\n   SELECT\n     id, slug, context, created_at, updated_at,\n     tenant_id, product_id, code, barcode, name,\n     attributes, weight_grams, parent_sku_id, active\n   FROM inventory_skus\n   WHERE NOT EXISTS (\n     SELECT 1 FROM product_skus p WHERE p.id = inventory_skus.id\n   );\n   COMMIT;\n   ```\n\n3. **Drop the legacy table** once row counts match:\n\n   ```sql\n   DROP TABLE IF EXISTS inventory_skus;\n   ```\n\n### `ProductVariant` changed shape entirely\n\nPreviously a Product STI subtype carrying `parentProductId` + `axisValues` JSON inside `_meta_data` on the shared `products` table (`_meta_type='@happyvertical/smrt-products:ProductVariant'`). It is now a **standalone model** on its own `product_variants` table, with columns `productId`, `axisName`, `allowedValues`, `label`, `sortOrder`.\n\n**There is no automatic data conversion.** The old \"catalog grouping above SKU\" concept doesn't map 1:1 to the new \"per-axis declaration\" concept. Recommended procedure:\n\n1. Inspect the old rows: `SELECT * FROM products WHERE _meta_type = '@happyvertical/smrt-products:ProductVariant';`. Treat them as historical reference.\n2. Re-author axis declarations against the new shape (one `ProductVariant` row per `(productId, axisName)` pair, with `allowedValues` listing the values).\n3. Once the new declarations are populated and verified, remove the legacy rows: `DELETE FROM products WHERE _meta_type = '@happyvertical/smrt-products:ProductVariant';`.\n\nIf you had per-colorway / per-variant images attached via `ProductAsset` rows pointing at old ProductVariant ids, repoint those to the parent Product id; group-by-axis-value queries on `Sku.attributes` cover the same use case at the SKU level.\n\n## Gotchas\n\n- **`ProductVariant` and `Sku` are NOT Product STI subtypes** — they each have their own table (`product_variants`, `product_skus`) because their shapes don't fit the Product schema. Don't try to query them via `ProductCollection`.\n- **`npm run build` emits the published library surface directly**: package consumers read model, collection, and helper exports from `dist/lib`. Cross-package imports from this package should target `/models` or `/collections` subpaths (not the main entry) when the consumer isn't a vite app — the main entry pulls in vite virtual modules.\n- **Use `npm run build:all` only when you need standalone or federation bundles** in addition to the library output\n- **Constructor must explicitly assign all properties**: `Object.assign` doesn't work reliably with decorators\n- **STI subtype-specific fields use `Meta<T>`** — declare them as `fieldName: Meta<FieldType> = defaultValue`. The AST scanner detects the `Meta<T>` type wrapper at build time and routes the field through `_meta_data` JSON storage instead of materializing it as a column on the parent's table. Do **NOT** use the runtime `@meta()` decorator on STI children — it never reaches the manifest, so the schema generator treats the field as an ordinary column on the parent table and the framework's hydration path can't tell it's meta. Override `productType` on each subclass.\n- **Tenant-scoped STI children must repeat `@TenantScoped`** — `@TenantScoped` registers per concrete className, so `Material extends Product` inheriting from a tenant-scoped `Product` is NOT automatically tenant-scoped itself. `MaterialCollection.list/save` passes `'Material'` to the tenant interceptor, which looks up `'Material'` (not `'Product'`) in the per-class registry. Without an explicit `@TenantScoped({ mode: 'optional' })` on `Material`, material rows skip the tenant auto-filter and auto-populate.\n- **STI children must repeat `@smrt({ api, mcp, cli })` generation config (S5 #1406)** — like `@TenantScoped`, the generation config is registered per concrete className and is NOT inherited from the STI parent. An empty `@smrt()` on a child resolves `getConfig(child).api/.mcp` to `undefined`, which the REST and MCP generators treat as \"expose EVERYTHING\" — including `delete` and write-capable MCP tools — even when the parent deliberately restricts its surface. The package's `mcp.ts` generator enumerates the whole registry, so an under-configured child ships a wide-open surface silently. Re-declare the parent's `api`/`mcp`/`cli` posture on every subtype (see `Material`). Consumer subtypes (apparel `Style`/`Makeup`, automotive `Model`/`Trim`, …) must do the same.\n- **Two tenants can share a slug on `Product`/`Category` (smrt#2360)** — a tenant-scoped STI base keys on `(tenant_id, slug, context, _meta_type)` by default, on the schema index and the runtime upsert alike, so no per-tenant slug namespacing and no `conflictColumns` override is needed. Global rows (`tenantId = null`) still dedup among themselves through the SDK's null-aware upsert. Existing databases pick the new key up through `smrt db:migrate` (same-name index swap) — deploy the code and the migration together, since neither version's create binds against the other's index.\n- **`price` is integer minor units** (cents, satoshis) — `$19.99` is `1999`. Money is exact, so `price` initializes `= 0`; writing `19.99` is the bug, and PostgreSQL rejects it with `22P02` while SQLite's affinity stores it and hides it from this package's SQLite suites. `pnpm --filter @happyvertical/smrt-products test:postgres` is the lane that holds the line (#2361). Because `Product` is the STI base, the column is shared by every consumer subtype. `Material.costPerUnit` is a `Meta<number>` in `_meta_data` rather than a column, so it is outside this rule.\n- **Module Federation marked experimental**: may change\n",
   "recipes": [