@happyvertical/smrt-manufacturing 0.53.4 → 0.53.5

package/dist/smrt-knowledge.json

@@ -3,35 +3,49 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-manufacturing",
-  "packageVersion": "0.53.4",
+  "packageVersion": "0.53.5",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "bf94ab872eb2ab071b1a43e8ee6286f63faaf3e162b71ca2421e7cb27869586a",
-    "packageJson": "b8542ff6ff2fb43bf90164c60e7c8219e76b9b0bc286ac747b934f7e665dcd58",
-    "agents": "94d10408c859743730368f932f77e5602ebefb8fe9a8ac3178fa4b211e95ad29"
+    "manifest": "c759bf5fb3f31d0d65da9b204e8d57a5b3c33210858c469d56b9835bccd551c2",
+    "packageJson": "e8b753814d42f7be3144fc1e6af8cbf038a00049e73a370dac674326e4396d24",
+    "agents": "8570930d07b32c59b20d9f4e69e5579395e6b8d2382b7303e17c36ba2e598097"
   },
   "exports": [
     ".",
     "./manifest",
-    "./manifest.json"
+    "./manifest.json",
+    "./svelte",
+    "./ui"
   ],
   "dependencies": {
     "@happyvertical/logger": "catalog:",
     "@happyvertical/smrt-core": "workspace:*",
+    "@happyvertical/smrt-fields": "workspace:*",
     "@happyvertical/smrt-inventory": "workspace:*",
+    "@happyvertical/smrt-products": "workspace:*",
     "@happyvertical/smrt-tenancy": "workspace:*",
+    "@happyvertical/smrt-types": "workspace:*",
+    "@happyvertical/smrt-ui": "workspace:*",
     "@happyvertical/sql": "catalog:",
     "@happyvertical/smrt-vitest": "workspace:*",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "24.13.6",
+    "svelte": "^5.57.0",
+    "svelte-check": "^4.7.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },
   "smrtDependencies": [
     "@happyvertical/smrt-core",
+    "@happyvertical/smrt-fields",
     "@happyvertical/smrt-inventory",
+    "@happyvertical/smrt-products",
     "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-types",
+    "@happyvertical/smrt-ui",
     "@happyvertical/smrt-vitest"
   ],
   "sdkDependencies": [
@@ -39,6 +53,7 @@
     "@happyvertical/sql"
   ],
   "tags": [
+    "assembly",
     "bill-of-materials",
     "bom",
     "cost-rollup",
@@ -48,7 +63,9 @@
     "smrt"
   ],
   "risks": [
-    "sensitive-fields-excluded"
+    "cross-package-refs:1",
+    "sensitive-fields-excluded",
+    "sti-inheritance"
   ],
   "objects": [
     {
@@ -238,6 +255,494 @@
       "tags": [],
       "risks": []
     },
+    {
+      "name": "OperationCollection",
+      "qualifiedName": "@happyvertical/smrt-manufacturing:OperationCollection",
+      "collection": "operations",
+      "tableName": "manufacturing_operations",
+      "packageName": "@happyvertical/smrt-manufacturing",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findByCode",
+        "listOperations"
+      ],
+      "methodSignatures": [
+        {
+          "name": "findByCode",
+          "async": true,
+          "params": [
+            "code: string"
+          ],
+          "returns": "Promise<Operation | null>"
+        },
+        {
+          "name": "listOperations",
+          "async": true,
+          "params": [
+            "options?: object"
+          ],
+          "returns": "Promise<Operation[]>"
+        }
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "operations.findByCode",
+          "operation": "findByCode",
+          "objectName": "@happyvertical/smrt-manufacturing:OperationCollection",
+          "path": "/operations/findByCode",
+          "method": "POST"
+        },
+        {
+          "kind": "api",
+          "name": "operations.listOperations",
+          "operation": "listOperations",
+          "objectName": "@happyvertical/smrt-manufacturing:OperationCollection",
+          "path": "/operations/listOperations",
+          "method": "POST"
+        },
+        {
+          "kind": "cli",
+          "name": "operationcollection_findByCode",
+          "operation": "findByCode",
+          "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+        },
+        {
+          "kind": "cli",
+          "name": "operationcollection_listOperations",
+          "operation": "listOperations",
+          "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+        },
+        {
+          "kind": "mcp",
+          "name": "operationcollection_findbycode",
+          "operation": "findByCode",
+          "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+        },
+        {
+          "kind": "mcp",
+          "name": "operationcollection_listoperations",
+          "operation": "listOperations",
+          "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "RoutingStepCollection",
+      "qualifiedName": "@happyvertical/smrt-manufacturing:RoutingStepCollection",
+      "collection": "routingsteps",
+      "tableName": "manufacturing_routing_steps",
+      "packageName": "@happyvertical/smrt-manufacturing",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "findByBom",
+        "findByOperation"
+      ],
+      "methodSignatures": [
+        {
+          "name": "findByBom",
+          "async": true,
+          "params": [
+            "bomId: string"
+          ],
+          "returns": "Promise<RoutingStep[]>"
+        },
+        {
+          "name": "findByOperation",
+          "async": true,
+          "params": [
+            "operationId: string"
+          ],
+          "returns": "Promise<RoutingStep[]>"
+        }
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "routingsteps.findByBom",
+          "operation": "findByBom",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection",
+          "path": "/routingsteps/findByBom",
+          "method": "POST"
+        },
+        {
+          "kind": "api",
+          "name": "routingsteps.findByOperation",
+          "operation": "findByOperation",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection",
+          "path": "/routingsteps/findByOperation",
+          "method": "POST"
+        },
+        {
+          "kind": "cli",
+          "name": "routingstepcollection_findByBom",
+          "operation": "findByBom",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+        },
+        {
+          "kind": "cli",
+          "name": "routingstepcollection_findByOperation",
+          "operation": "findByOperation",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+        },
+        {
+          "kind": "mcp",
+          "name": "routingstepcollection_findbybom",
+          "operation": "findByBom",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+        },
+        {
+          "kind": "mcp",
+          "name": "routingstepcollection_findbyoperation",
+          "operation": "findByOperation",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Assembly",
+      "qualifiedName": "@happyvertical/smrt-manufacturing:Assembly",
+      "collection": "products",
+      "tableName": "products",
+      "packageName": "@happyvertical/smrt-manufacturing",
+      "extends": "Product",
+      "fields": [
+        {
+          "name": "created_at",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "updated_at",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "productType",
+          "type": "json",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "description",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "category",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "manufacturer",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "model",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "price",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "inStock",
+          "type": "boolean",
+          "required": true,
+          "columnType": "BOOLEAN",
+          "default": true
+        },
+        {
+          "name": "specifications",
+          "type": "json",
+          "required": false,
+          "columnType": "JSON",
+          "default": {}
+        },
+        {
+          "name": "tags",
+          "type": "json",
+          "required": false,
+          "columnType": "JSON",
+          "default": []
+        },
+        {
+          "name": "estimatedLabourMinutes",
+          "type": "integer",
+          "required": false,
+          "columnType": "INTEGER",
+          "default": 0
+        },
+        {
+          "name": "defaultOperationId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Operation",
+          "columnType": "UUID"
+        },
+        {
+          "name": "partReference",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        }
+      ],
+      "relationships": [
+        {
+          "name": "defaultOperationId",
+          "type": "foreignKey",
+          "required": false,
+          "related": "Operation",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "addAsset",
+        "getAssets",
+        "getSpecification",
+        "removeAsset",
+        "updateSpecification"
+      ],
+      "methodSignatures": [
+        {
+          "name": "addAsset",
+          "async": true,
+          "params": [
+            "asset: Asset",
+            "relationship?: any",
+            "sortOrder?: any"
+          ],
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "getAssets",
+          "async": true,
+          "params": [
+            "relationship?: string"
+          ],
+          "returns": "Promise<Asset[]>"
+        },
+        {
+          "name": "getSpecification",
+          "async": true,
+          "params": [
+            "key: string"
+          ],
+          "returns": "Promise<unknown>"
+        },
+        {
+          "name": "removeAsset",
+          "async": true,
+          "params": [
+            "assetId: string",
+            "relationship?: string"
+          ],
+          "returns": "Promise<void>"
+        },
+        {
+          "name": "updateSpecification",
+          "async": true,
+          "params": [
+            "key: string",
+            "value: unknown"
+          ],
+          "returns": "Promise<void>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "tableStrategy": "sti",
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "products.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+          "path": "/products",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "products.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+          "path": "/products/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "products.create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+          "path": "/products",
+          "method": "POST"
+        },
+        {
+          "kind": "api",
+          "name": "products.update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+          "path": "/products/[id]",
+          "method": "PATCH"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_getSpecification",
+          "operation": "getSpecification",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_updateSpecification",
+          "operation": "updateSpecification",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_getAssets",
+          "operation": "getAssets",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_addAsset",
+          "operation": "addAsset",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "cli",
+          "name": "assembly_removeAsset",
+          "operation": "removeAsset",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "mcp",
+          "name": "assembly_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "mcp",
+          "name": "assembly_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        }
+      ],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "addAsset",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "api",
+          "operation": "getAssets",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "api",
+          "operation": "getSpecification",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "api",
+          "operation": "removeAsset",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        },
+        {
+          "kind": "api",
+          "operation": "updateSpecification",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+        }
+      ],
+      "relationshipFeatures": [
+        "foreignKey",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
     {
       "name": "BillOfMaterials",
       "qualifiedName": "@happyvertical/smrt-manufacturing:BillOfMaterials",
@@ -413,24 +918,317 @@
           "name": "componentSkuId",
           "type": "text",
           "required": true,
-          "columnType": "TEXT",
-          "default": ""
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "qtyPerUnit",
+          "type": "decimal",
+          "required": false,
+          "columnType": "REAL"
+        },
+        {
+          "name": "uom",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": "each"
+        },
+        {
+          "name": "wastePercent",
+          "type": "decimal",
+          "required": false,
+          "columnType": "REAL"
+        },
+        {
+          "name": "notes",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "effectiveQtyPerUnit"
+      ],
+      "methodSignatures": [
+        {
+          "name": "effectiveQtyPerUnit",
+          "returns": "number"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "bom_id",
+        "component_sku_id",
+        "tenant_id"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "bomlines.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
+          "path": "/bomlines",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "bomlines.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
+          "path": "/bomlines/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "bomlines.create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
+          "path": "/bomlines",
+          "method": "POST"
+        },
+        {
+          "kind": "api",
+          "name": "bomlines.update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
+          "path": "/bomlines/[id]",
+          "method": "PATCH"
+        },
+        {
+          "kind": "cli",
+          "name": "bomline_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        },
+        {
+          "kind": "cli",
+          "name": "bomline_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        },
+        {
+          "kind": "cli",
+          "name": "bomline_create",
+          "operation": "create",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        },
+        {
+          "kind": "cli",
+          "name": "bomline_update",
+          "operation": "update",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        },
+        {
+          "kind": "cli",
+          "name": "bomline_delete",
+          "operation": "delete",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        },
+        {
+          "kind": "cli",
+          "name": "bomline_effectiveQtyPerUnit",
+          "operation": "effectiveQtyPerUnit",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        },
+        {
+          "kind": "mcp",
+          "name": "bomline_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        },
+        {
+          "kind": "mcp",
+          "name": "bomline_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        }
+      ],
+      "withheldSurfaces": [
+        {
+          "kind": "api",
+          "operation": "effectiveQtyPerUnit",
+          "code": "not-included",
+          "reason": "not listed in api.include",
+          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+        }
+      ],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "Operation",
+      "qualifiedName": "@happyvertical/smrt-manufacturing:Operation",
+      "collection": "operations",
+      "tableName": "manufacturing_operations",
+      "packageName": "@happyvertical/smrt-manufacturing",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "code",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "name",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "category",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT",
+          "default": ""
+        },
+        {
+          "name": "isActive",
+          "type": "boolean",
+          "required": false,
+          "columnType": "BOOLEAN",
+          "default": true
+        },
+        {
+          "name": "requiredQualificationId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-human-resources:Qualification",
+          "columnType": "UUID"
+        }
+      ],
+      "relationships": [
+        {
+          "name": "requiredQualificationId",
+          "type": "crossPackageRef",
+          "required": false,
+          "related": "@happyvertical/smrt-human-resources:Qualification",
+          "columnType": "UUID"
+        }
+      ],
+      "methods": [
+        "delete"
+      ],
+      "methodSignatures": [
+        {
+          "name": "delete",
+          "async": true,
+          "returns": "Promise<void>"
+        }
+      ],
+      "tenant": {
+        "scoped": true,
+        "mode": "optional",
+        "field": "tenantId"
+      },
+      "conflictColumns": [
+        "code",
+        "tenant_id"
+      ],
+      "surfaces": [
+        {
+          "kind": "api",
+          "name": "operations.list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:Operation",
+          "path": "/operations",
+          "method": "GET"
+        },
+        {
+          "kind": "api",
+          "name": "operations.get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:Operation",
+          "path": "/operations/[id]",
+          "method": "GET"
+        },
+        {
+          "kind": "cli",
+          "name": "operation_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:Operation"
+        },
+        {
+          "kind": "cli",
+          "name": "operation_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:Operation"
+        },
+        {
+          "kind": "mcp",
+          "name": "operation_list",
+          "operation": "list",
+          "objectName": "@happyvertical/smrt-manufacturing:Operation"
+        },
+        {
+          "kind": "mcp",
+          "name": "operation_get",
+          "operation": "get",
+          "objectName": "@happyvertical/smrt-manufacturing:Operation"
+        }
+      ],
+      "relationshipFeatures": [
+        "crossPackageRef",
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "RoutingStep",
+      "qualifiedName": "@happyvertical/smrt-manufacturing:RoutingStep",
+      "collection": "routingsteps",
+      "tableName": "manufacturing_routing_steps",
+      "packageName": "@happyvertical/smrt-manufacturing",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "bomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "BillOfMaterials",
+          "columnType": "UUID"
         },
         {
-          "name": "qtyPerUnit",
-          "type": "decimal",
-          "required": false,
-          "columnType": "REAL"
+          "name": "operationId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Operation",
+          "columnType": "UUID"
         },
         {
-          "name": "uom",
-          "type": "text",
-          "required": false,
-          "columnType": "TEXT",
-          "default": "each"
+          "name": "sequence",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER",
+          "default": 1
         },
         {
-          "name": "wastePercent",
+          "name": "estimatedMinutes",
           "type": "decimal",
           "required": false,
           "columnType": "REAL"
@@ -443,16 +1241,23 @@
           "default": ""
         }
       ],
-      "relationships": [],
-      "methods": [
-        "effectiveQtyPerUnit"
-      ],
-      "methodSignatures": [
+      "relationships": [
         {
-          "name": "effectiveQtyPerUnit",
-          "returns": "number"
+          "name": "bomId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "BillOfMaterials",
+          "columnType": "UUID"
+        },
+        {
+          "name": "operationId",
+          "type": "foreignKey",
+          "required": true,
+          "related": "Operation",
+          "columnType": "UUID"
         }
       ],
+      "methods": [],
       "tenant": {
         "scoped": true,
         "mode": "optional",
@@ -460,101 +1265,71 @@
       },
       "conflictColumns": [
         "bom_id",
-        "component_sku_id",
+        "sequence",
         "tenant_id"
       ],
       "surfaces": [
         {
           "kind": "api",
-          "name": "bomlines.list",
+          "name": "routingsteps.list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
-          "path": "/bomlines",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep",
+          "path": "/routingsteps",
           "method": "GET"
         },
         {
           "kind": "api",
-          "name": "bomlines.get",
+          "name": "routingsteps.get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
-          "path": "/bomlines/[id]",
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep",
+          "path": "/routingsteps/[id]",
           "method": "GET"
         },
-        {
-          "kind": "api",
-          "name": "bomlines.create",
-          "operation": "create",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
-          "path": "/bomlines",
-          "method": "POST"
-        },
-        {
-          "kind": "api",
-          "name": "bomlines.update",
-          "operation": "update",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine",
-          "path": "/bomlines/[id]",
-          "method": "PATCH"
-        },
         {
           "kind": "cli",
-          "name": "bomline_list",
+          "name": "routingstep_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
         },
         {
           "kind": "cli",
-          "name": "bomline_get",
+          "name": "routingstep_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
         },
         {
           "kind": "cli",
-          "name": "bomline_create",
+          "name": "routingstep_create",
           "operation": "create",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
         },
         {
           "kind": "cli",
-          "name": "bomline_update",
+          "name": "routingstep_update",
           "operation": "update",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
         },
         {
           "kind": "cli",
-          "name": "bomline_delete",
+          "name": "routingstep_delete",
           "operation": "delete",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
-        },
-        {
-          "kind": "cli",
-          "name": "bomline_effectiveQtyPerUnit",
-          "operation": "effectiveQtyPerUnit",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
         },
         {
           "kind": "mcp",
-          "name": "bomline_list",
+          "name": "routingstep_list",
           "operation": "list",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
         },
         {
           "kind": "mcp",
-          "name": "bomline_get",
+          "name": "routingstep_get",
           "operation": "get",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
-        }
-      ],
-      "withheldSurfaces": [
-        {
-          "kind": "api",
-          "operation": "effectiveQtyPerUnit",
-          "code": "not-included",
-          "reason": "not listed in api.include",
-          "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+          "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
         }
       ],
       "relationshipFeatures": [
+        "foreignKey",
         "uuidColumns"
       ],
       "tags": [],
@@ -662,6 +1437,190 @@
       "operation": "findByComponent",
       "objectName": "@happyvertical/smrt-manufacturing:BomLineCollection"
     },
+    {
+      "kind": "api",
+      "name": "operations.findByCode",
+      "operation": "findByCode",
+      "objectName": "@happyvertical/smrt-manufacturing:OperationCollection",
+      "path": "/operations/findByCode",
+      "method": "POST"
+    },
+    {
+      "kind": "api",
+      "name": "operations.listOperations",
+      "operation": "listOperations",
+      "objectName": "@happyvertical/smrt-manufacturing:OperationCollection",
+      "path": "/operations/listOperations",
+      "method": "POST"
+    },
+    {
+      "kind": "cli",
+      "name": "operationcollection_findByCode",
+      "operation": "findByCode",
+      "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+    },
+    {
+      "kind": "cli",
+      "name": "operationcollection_listOperations",
+      "operation": "listOperations",
+      "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+    },
+    {
+      "kind": "mcp",
+      "name": "operationcollection_findbycode",
+      "operation": "findByCode",
+      "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+    },
+    {
+      "kind": "mcp",
+      "name": "operationcollection_listoperations",
+      "operation": "listOperations",
+      "objectName": "@happyvertical/smrt-manufacturing:OperationCollection"
+    },
+    {
+      "kind": "api",
+      "name": "routingsteps.findByBom",
+      "operation": "findByBom",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection",
+      "path": "/routingsteps/findByBom",
+      "method": "POST"
+    },
+    {
+      "kind": "api",
+      "name": "routingsteps.findByOperation",
+      "operation": "findByOperation",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection",
+      "path": "/routingsteps/findByOperation",
+      "method": "POST"
+    },
+    {
+      "kind": "cli",
+      "name": "routingstepcollection_findByBom",
+      "operation": "findByBom",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+    },
+    {
+      "kind": "cli",
+      "name": "routingstepcollection_findByOperation",
+      "operation": "findByOperation",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+    },
+    {
+      "kind": "mcp",
+      "name": "routingstepcollection_findbybom",
+      "operation": "findByBom",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+    },
+    {
+      "kind": "mcp",
+      "name": "routingstepcollection_findbyoperation",
+      "operation": "findByOperation",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStepCollection"
+    },
+    {
+      "kind": "api",
+      "name": "products.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+      "path": "/products",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "products.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+      "path": "/products/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "products.create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+      "path": "/products",
+      "method": "POST"
+    },
+    {
+      "kind": "api",
+      "name": "products.update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly",
+      "path": "/products/[id]",
+      "method": "PATCH"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_getSpecification",
+      "operation": "getSpecification",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_updateSpecification",
+      "operation": "updateSpecification",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_getAssets",
+      "operation": "getAssets",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_addAsset",
+      "operation": "addAsset",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "cli",
+      "name": "assembly_removeAsset",
+      "operation": "removeAsset",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "mcp",
+      "name": "assembly_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
+    {
+      "kind": "mcp",
+      "name": "assembly_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:Assembly"
+    },
     {
       "kind": "api",
       "name": "billofmaterialses.list",
@@ -815,16 +1774,114 @@
       "name": "bomline_get",
       "operation": "get",
       "objectName": "@happyvertical/smrt-manufacturing:BomLine"
+    },
+    {
+      "kind": "api",
+      "name": "operations.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:Operation",
+      "path": "/operations",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "operations.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:Operation",
+      "path": "/operations/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "operation_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:Operation"
+    },
+    {
+      "kind": "cli",
+      "name": "operation_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:Operation"
+    },
+    {
+      "kind": "mcp",
+      "name": "operation_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:Operation"
+    },
+    {
+      "kind": "mcp",
+      "name": "operation_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:Operation"
+    },
+    {
+      "kind": "api",
+      "name": "routingsteps.list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep",
+      "path": "/routingsteps",
+      "method": "GET"
+    },
+    {
+      "kind": "api",
+      "name": "routingsteps.get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep",
+      "path": "/routingsteps/[id]",
+      "method": "GET"
+    },
+    {
+      "kind": "cli",
+      "name": "routingstep_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
+    },
+    {
+      "kind": "cli",
+      "name": "routingstep_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
+    },
+    {
+      "kind": "cli",
+      "name": "routingstep_create",
+      "operation": "create",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
+    },
+    {
+      "kind": "cli",
+      "name": "routingstep_update",
+      "operation": "update",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
+    },
+    {
+      "kind": "cli",
+      "name": "routingstep_delete",
+      "operation": "delete",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
+    },
+    {
+      "kind": "mcp",
+      "name": "routingstep_list",
+      "operation": "list",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
+    },
+    {
+      "kind": "mcp",
+      "name": "routingstep_get",
+      "operation": "get",
+      "objectName": "@happyvertical/smrt-manufacturing:RoutingStep"
     }
   ],
   "prompts": [],
   "relationshipsV2": {
-    "foreignKeyFields": 0,
-    "crossPackageRefFields": 0,
+    "foreignKeyFields": 3,
+    "crossPackageRefFields": 1,
     "junctionCollections": 0,
     "hierarchicalObjects": 0,
     "polymorphicAssociations": 0,
-    "uuidColumns": 8
+    "uuidColumns": 25
   },
-  "agentDoc": "# @happyvertical/smrt-manufacturing\n\nBills of materials, cost rollup, and production-order operations. Strictly industry-neutral — the same primitives serve apparel, furniture, automotive, CPG, electronics, food production, custom hardware, and any vertical that builds finished goods from a recipe.\n\nSits on top of `@happyvertical/smrt-inventory` (stock) and works alongside the `ProductionOrder` Contract STI subtype already shipped in `@happyvertical/smrt-commerce`.\n\n## Models\n\n| Model | Purpose |\n|---|---|\n| `BillOfMaterials` | Recipe for a finished product. `productId` (plain string) references the upstream `Product` or any STI subtype. Multiple revisions per product via `version` + `status` (`draft` / `active` / `superseded`). `conflictColumns: ['product_id', 'version', 'tenant_id']`. |\n| `BomLine` | One component on a BOM. `bomId` (FK), `componentSkuId` (plain string ref — the `Sku` model lives in `@happyvertical/smrt-products`; inventory tracks stock motion against the id), `qtyPerUnit`, `uom` (open-ended — `yards`, `each`, `grams`, `kg`, ...), `wastePercent`, `notes`. `conflictColumns: ['bom_id', 'component_sku_id', 'tenant_id']`. |\n\nBoth models are `@TenantScoped({ mode: 'optional' })` with a nullable `tenantId` so they can be used either tenant-scoped or globally.\n\n`RoutingStep` (labor cost) is intentionally out of scope for v1 — see issue [#1245](https://github.com/happyvertical/smrt/issues/1245) for the planned follow-up.\n\n## BomService — planning helpers\n\n```typescript\nimport { BomService } from '@happyvertical/smrt-manufacturing';\n\nconst bom = await BomService.create({\n  db,\n  // Optional. Resolve unit cost for a component SKU.\n  // Without this, every line rolls up to $0 and `costUnavailable` is set.\n  costResolver: async (componentSkuId) => fetchLatestCost(componentSkuId),\n});\n\nconst rollup = await bom.computeMaterialCost(bomId);\n//   { totalCost, currency, lineBreakdown, hasMissingCosts }\n\nconst requirements = await bom.explodeRequirements(bomId, 100);\n//   [{ componentSkuId, totalQty, uom }, ...]\n\nconst check = await bom.canProduce(bomId, 100);\n//   { ok: true } | { ok: false, shortages: [...] }\n```\n\n| Method | Behavior |\n|---|---|\n| `computeMaterialCost(bomId)` | Walks every BomLine, applies waste (`qtyPerUnit * (1 + wastePercent / 100)`), resolves unit costs via the optional `costResolver`, returns per-line breakdown plus rolled-up total. Lines with no cost set `costUnavailable: true` and contribute `0`. |\n| `explodeRequirements(bomId, qty)` | Returns a \"shopping list\" of materials needed for `qty` units. Duplicates across lines are summed. Does NOT mutate stock. |\n| `canProduce(bomId, qty)` | Calls `explodeRequirements`, then sums `available` stock across every location per component, returns `{ ok: true }` if everything's covered, else `{ ok: false, shortages: [...] }`. |\n\n## ProductionService — consume / produce\n\n```typescript\nimport { ProductionService } from '@happyvertical/smrt-manufacturing';\n\nconst production = await ProductionService.create({ db });\n\n// Drain materials at the factory.\nconst consumed = await production.consumeMaterials(\n  { id: order.id, productId: order.productId, bomId: order.bomId },\n  { locationId: factory.id, qty: runQty },\n);\n\n// Receive finished goods.\nconst produced = await production.produceFinishedGoods(\n  { id: order.id, productId: order.productId },\n  { locationId: factory.id, qty: runQty, finishedSkuId: variant.id },\n);\n\n// Or run both in one transaction — see \"Joint atomicity\" below.\nconst { consumed, produced } = await production.runProduction(\n  { id: order.id, productId: order.productId, bomId: order.bomId },\n  {\n    consume: { locationId: factory.id, qty: runQty },\n    produce: { locationId: factory.id, qty: runQty, finishedSkuId: variant.id },\n  },\n);\n```\n\nAll three methods write through `StockService` and stamp every emitted `StockMovement` with `sourceType: 'ProductionOrder'` + the production order id so audit queries can roll them up later.\n\n### Joint atomicity — `runProduction` vs the two-call form\n\n`consumeMaterials` and `produceFinishedGoods` are each individually atomic, but calling them as two separate awaits is NOT jointly atomic — each opens its own `stockService.withTransaction(...)` scope. If something goes wrong between the two calls (process crash, transient adapter failure on the produce leg), you can land in a state where materials are deducted but no finished SKU receipt balances them. The audit ledger stays consistent within each call; what's missing is the cross-call invariant.\n\nWhen you need that invariant — typically make-to-stock flows where the factory step is invisible to the ledger — use `runProduction(order, { consume, produce })`. Both legs run inside one transaction; any failure (BOM shortage, adapter error, interceptor reject) rolls back both legs together.\n\nWhen NOT to use it: workflows where consume and produce represent a real wall-clock gap that downstream observers need to see (WIP dashboards, partial-run reporting, separate \"materials posted\" and \"production completed\" events on the dispatch bus). There, the two-call form is the right shape — each call is its own ledger event.\n\n### Location convention — explicit-arg design\n\nThe location where materials are consumed and finished goods are received is passed explicitly to `consumeMaterials` / `produceFinishedGoods`, not carried on the production order itself. Rationale:\n\n- The commerce `ProductionOrder` is a `Contract` STI subtype owned by `@happyvertical/smrt-commerce`. Adding an `originLocationId` field there would either need a schema change in commerce (cross-cutting) or a meta field that only manufacturing knows about (leaky).\n- Real shops often pick a location at run time (factory A is congested, route the run through factory B), so even if the order carried a default, the explicit-arg signature is the more flexible canonical form.\n- Callers that want a default can stash a `locationId` on their own production-order helper and pass it through.\n\n### Finished-SKU convention\n\nA `ProductionOrder` references a `productId`, but a `Product` typically has multiple SKUs (one per variant). The caller of `produceFinishedGoods` picks the concrete `finishedSkuId` because the multi-SKU mapping is application-specific (size run, finish mix, kit variant).\n\n## Opt-in DispatchBus hooks\n\nOff by default. Wire them up explicitly in the application's `smrt.ts`:\n\n```typescript\nimport { installManufacturingDispatchHandlers } from '@happyvertical/smrt-manufacturing';\n\nconst handlers = await installManufacturingDispatchHandlers({\n  dispatchBus: bus,\n  db,\n  // Default: subscribe to production_order:posted, call consumeMaterials.\n  installProductionPosted: true,\n  // Default: don't auto-produce. Set to true if your shop emits a\n  // separate production_order:completed event.\n  installProductionCompleted: false,\n  // Default: don't combine consume + produce on `posted`. Set to true\n  // for make-to-stock-instantly workflows where the factory step is\n  // invisible. Ignored when installProductionCompleted is true.\n  producedOnPosted: false,\n});\n```\n\nThis subscribes to:\n\n- `production_order:posted` → `production.consumeMaterials(...)`; when `producedOnPosted: true` the handler instead calls `production.runProduction(...)` so consume + produce share one transaction. Process crashes or adapter errors between the two legs can never leave materials deducted with no finished-goods receipt.\n- `production_order:completed` → `production.produceFinishedGoods(...)` (opt-in)\n\nThe companion handlers for `contract:created` (reserve) and `fulfillment:shipped` (fulfil) live in `@happyvertical/smrt-inventory` — wire both packages' installers from `smrt.ts` to get the full lifecycle.\n\n## Gotchas\n\n- **`computeMaterialCost` without a resolver returns `$0`.** That is deliberate — manufacturing does not assume any particular cost source. A real wiring will plug in `@happyvertical/smrt-products` `Material.costPerUnit`, or a rolling average from purchase-order history, or a vendor price book. The `costUnavailable` flag tells UIs to surface \"unknown cost\" rather than silently rolling up zeros.\n- **`explodeRequirements` does not call any stock APIs.** It is a planning helper. To check whether the materials are actually on hand, use `canProduce`. To actually deduct them, use `ProductionService.consumeMaterials`.\n- **`canProduce` sums available stock across every location.** The planning question is \"do we have it at all?\". The operational question of \"which warehouse do we pull from?\" is left to the caller of `consumeMaterials`, which targets a single `locationId` per call.\n- **`consumeMaterials` propagates `InsufficientStockError`.** If a line would drive `available` below zero, the underlying `StockService.adjust` throws. Pre-flight with `canProduce` before posting if you want to avoid partial-failure mid-run.\n- **`consumeMaterials` is atomic across BOM lines.** All per-line deductions and their audit rows run inside a single `stockService.withTransaction(...)` scope (powered by `@happyvertical/sql >= 0.74.0`'s native `db.transaction()`). An `InsufficientStockError` on line N+1 rolls back lines 1..N so production-order posting never leaves materials half-consumed. The recommended pre-flight (`BomService.canProduce(orderId, qty)`) is still useful when you'd rather know upfront than discover the shortfall mid-run, but a missed pre-flight no longer corrupts state.\n- **`consumeMaterials` + `produceFinishedGoods` are NOT jointly atomic.** Each opens its own transaction. A failure on the produce leg leaves materials deducted with no finished SKU receipt to balance it. Use `runProduction(order, { consume, produce })` when you need both legs to commit or roll back together.\n- **Cross-package references are plain strings.** `productId`, `componentSkuId`, `bomId` (within this package) — all plain string ids, never `@foreignKey()`. Keeps the dependency graph DAG-shaped and lets each upstream package evolve independently.\n- **`conflictColumns` include `tenant_id`** on both models. NULL-matching semantics are handled by `@happyvertical/sql >= 0.74.0`; two saves with the same `(product_id, version, NULL)` tuple merge in place.\n- **Lazy table creation.** Like everything else in SMRT, the `manufacturing_boms` and `manufacturing_bom_lines` tables are created on first DB op via `syncSchema`. Safe for SSR.\n- **Cross-industry constraint.** This package's vocabulary stays generic. Apparel-specific concepts (`Style`, `Makeup`, `Colorway`, `tech-pack`, fashion `Season`) and their analogues in furniture / automotive / CPG live in the relevant template package, never here. PRs that introduce industry vocabulary should be rejected.\n\n## Source attribution\n\nEvery emitted `StockMovement` carries `sourceType: 'ProductionOrder'` plus `sourceId: order.id` so downstream queries can reconstruct \"what caused this movement\". Reason codes used:\n\n| reasonCode | Emitter | Note |\n|---|---|---|\n| `production_consume` | `ProductionService.consumeMaterials` | One per BOM line per consume call |\n| `production_produce` | `ProductionService.produceFinishedGoods` | One per produce call |\n\nThese join cleanly with the standard inventory reason codes (`receipt`, `reservation`, `release`, `fulfillment`, `transfer_out`, `transfer_in`, `adjustment`) defined in `@happyvertical/smrt-inventory`.\n\n## Dependencies\n\n| Package | Purpose |\n|---|---|\n| `@happyvertical/smrt-core` | SmrtObject / SmrtCollection / DispatchBus |\n| `@happyvertical/smrt-inventory` | StockService, stock levels, movements (the `Sku` model itself lives in `@happyvertical/smrt-products`; inventory tracks stock motion against the id) |\n| `@happyvertical/smrt-tenancy` | Optional tenant scoping |\n| `@happyvertical/sql` | Database adapter |\n"
+  "agentDoc": "# @happyvertical/smrt-manufacturing\n\nBills of materials, operations and routing, cost and labour rollup, and production-order stock movement. Strictly industry-neutral — the same primitives serve apparel, furniture, automotive, CPG, electronics, food production, custom hardware, and any vertical that builds finished goods from a recipe.\n\nSits on top of `@happyvertical/smrt-inventory` (stock) and `@happyvertical/smrt-products` (catalog: `Product`, `Material`, `Sku`), and works alongside the `ProductionOrder` Contract STI subtype already shipped in `@happyvertical/smrt-commerce`.\n\n## Models\n\n| Model | Purpose |\n|---|---|\n| `Assembly` | The product that is **made**, counterpart to `Material`. Cross-package STI subtype of `smrt-products` `Product` (`productType: 'assembly'`, `_meta_type: '@happyvertical/smrt-manufacturing:Assembly'`) in the shared `products` table. Own columns: `estimatedLabourMinutes` (integer, per unit; a save refuses anything but a whole number of minutes of zero or more), `defaultOperationId` (`@foreignKey(Operation)`, nullable, RESTRICT like `RoutingStep.operationId`: the operation work on it is booked to by default), `partReference` (the organization's drawing/part number). Name, price, tags come from `Product`; part number and stock from its `Sku` and inventory; structure from its bill; documents from `ProductAsset`. Exposure matches `Product` (REST list/get/create/update, MCP list/get), as the issue asks: unlike `Operation`, the assembly row has no service-owned invariant that generated writes could bypass. |\n| `BillOfMaterials` | Recipe for a finished product. `productId` (plain string) references the upstream `Product` or any STI subtype. Multiple revisions per product via `version` + `status` (`draft` / `active` / `superseded`). `conflictColumns: ['product_id', 'version', 'tenant_id']`. |\n| `BomLine` | One component on a BOM. `bomId` (FK), `componentSkuId` (plain string ref — the `Sku` model lives in `@happyvertical/smrt-products`; inventory tracks stock motion against the id), `qtyPerUnit`, `uom` (open-ended — `yards`, `each`, `grams`, `kg`, ...), `wastePercent`, `notes`. `conflictColumns: ['bom_id', 'component_sku_id', 'tenant_id']`. |\n| `Operation` | A kind of work (cut, weld, inspect), a managed list per tenant. `code` (unique per tenant; `conflictColumns: ['code', 'tenant_id']`, fixed once defined), `name`, `category`, `isActive` (retire/reinstate; never deleted, `delete()` throws), `requiredQualificationId` (nullable `@crossPackageRef('@happyvertical/smrt-human-resources:Qualification')`: metadata only, no dependency, unvalidated; an application reads it to gate who may start the operation). |\n| `RoutingStep` | One operation in a BOM's optional routing. `bomId` (`@foreignKey(BillOfMaterials)`, CASCADE: a routing belongs to its bill), `operationId` (`@foreignKey(Operation)`, RESTRICT: operations are retired, never deleted), `sequence` (1..n, unique per bom), `estimatedMinutes` (decimal, per produced unit), `notes`. `conflictColumns: ['bom_id', 'sequence', 'tenant_id']`. |\n\nAll models are `@TenantScoped({ mode: 'optional' })` with a nullable `tenantId` so they can be used either tenant-scoped or globally.\n\n## Operations, routing and labour estimate\n\n- `OperationService` maintains the list (`define` rejects a duplicate code, including a retired one's; `rename`, `update`, `retire`, `reinstate`). `RoutingService.replaceRouting(bomId, steps)` swaps a bill's whole routing in one transaction and numbers it 1..n; a retired operation may stay on a routing that has it but cannot be newly added.\n- `BomService.computeLabourEstimate(bomId)` returns minutes and, only when the caller supplies `rateResolver` (hourly rate per `Operation`, mirroring `costResolver`), cost. No resolver means minutes only with `rateUnavailable` on each step. A bill with no routing returns an empty estimate; `computeMaterialCost` is unchanged.\n- `Operation` and `RoutingStep` expose generated list/get only; writes go through the services (generated create/update would upsert on a duplicate code or rename the code). `replaceRouting` saves the bill row inside its transaction (row lock) and retries on a revision conflict, so concurrent replacements serialize.\n- Deliberately absent: a default labour rate class (nothing here would use it; the resolver receives the whole `Operation` and can key on `code`/`category`), setup time, scheduling and work-centre capacity, and time recorded against an operation (that stays in `smrt-timesheets` or the application).\n- `./svelte` exports `OperationList` and `OperationForm` (props-driven; hosts persist through `OperationService`). Messages live in `src/svelte/i18n.ts`; component tests use the shared jsdom harness with axe assertions.\n- Tests: `operations-suite.ts` runs on SQLite (`operations.test.ts`) and PostgreSQL (`operations.optional.test.ts`, `pnpm test:postgres`; each test runs in its own tenant because PostgreSQL test data persists).\n\n## Assemblies — nesting lives in the bill\n\nA sub-assembly is a `BomLine` whose component SKU belongs to an `Assembly`; there is no children list on the model. `AssemblyService` is the one link from a line to what it names:\n\n| Method | Behavior |\n|---|---|\n| `resolveComponent(skuId, { tenantId? })` | `{ kind, sku, product, assembly, activeBom, buildable }`. `kind` is `assembly`, `material` (`Material`), `bought` (any other `Product`), or `missing` (unknown SKU, SKU with no product, or a non-UUID id; never throws). `activeBom` is the assembly's highest active bill, `null` when it has none; `buildable` is `assembly && activeBom`. Multi-level explosion (#3444) recurses on `activeBom` and stops at every other kind. |\n| `isAssembly(skuId)` | `resolveComponent(skuId).kind === 'assembly'`. |\n| `findActiveBom(productId, { tenantId? })` | Highest active bill. With `tenantId` (including `null`), only that tenant's bills count, and `resolveComponent` reports another tenant's SKU, product or bill line as `missing` (global rows stay visible), whatever the tenant context; the cycle walk and `getBillStructure` pass the bill's own tenant, so a shared assembly resolves to the right tenant's bill on writes made without `withTenant()`. |\n| `getBillStructure(bomId)` | One level: the bill plus each line with its resolved component. Throws `BomNotFoundError`. |\n| `findCycle(productId, componentSkuIds)` | The path by which those components would make `productId` contain itself, following sub-assemblies' **active** bills only; `null` when none. |\n| `assertLineAcyclic(line)` / `assertBillAcyclic(bom)` | Throw `BomCycleError` (a `ValidationError`, code `MANUFACTURING_BOM_CYCLE`, `path` from the product back to itself). |\n\n**Cycle refusal runs in the models.** `BomLine.validateBeforeSave` checks every line save (draft bills too, so a loop is refused when written); `BillOfMaterials.validateBeforeSave` checks every save of an `active` bill (activation), including the lines of a stored bill with the same `(productId, version, tenantId)` that the save would upsert onto. The generated REST routes go through `save()`, so they refuse cycles as well. Not covered: re-pointing a `Sku.productId` (owned by `smrt-products`) and two concurrent saves that each close half of a loop.\n\n## Svelte components (`./svelte`)\n\nProps-driven; the host loads and persists. `AssemblyList` (field policy drops hidden columns via `policyToVisibleColumnIds`), `AssemblyForm` (smrt-fields `ObjectForm` for `@happyvertical/smrt-manufacturing:Assembly`, so price and every other field follow the consumer's field policy), `BomEditor` (add/edit/remove lines through host handlers; a sub-assembly shows whether it has its own bill and expands read-only through `loadBill`), `BomStructureTree` (the read-only nested view). Adapters: `toAssemblyView`, `toBomEditorLines`. Strings are under `manufacturing.` in `src/svelte/i18n.ts`; the package is strict for raw primitives, hardcoded strings and JSDoc.\n\n\n## BomService — planning helpers\n\n```typescript\nimport { BomService } from '@happyvertical/smrt-manufacturing';\n\nconst bom = await BomService.create({\n  db,\n  // Optional. Resolve unit cost for a component SKU.\n  // Without this, every line rolls up to $0 and `costUnavailable` is set.\n  costResolver: async (componentSkuId) => fetchLatestCost(componentSkuId),\n});\n\nconst rollup = await bom.computeMaterialCost(bomId);\n//   { totalCost, currency, lineBreakdown, hasMissingCosts }\n\nconst requirements = await bom.explodeRequirements(bomId, 100);\n//   [{ componentSkuId, totalQty, uom }, ...]\n\nconst check = await bom.canProduce(bomId, 100);\n//   { ok: true } | { ok: false, shortages: [...] }\n```\n\n| Method | Behavior |\n|---|---|\n| `computeMaterialCost(bomId)` | Walks every BomLine, applies waste (`qtyPerUnit * (1 + wastePercent / 100)`), resolves unit costs via the optional `costResolver`, returns per-line breakdown plus rolled-up total. Lines with no cost set `costUnavailable: true` and contribute `0`. |\n| `explodeRequirements(bomId, qty)` | Returns a \"shopping list\" of materials needed for `qty` units. Duplicates across lines are summed. Does NOT mutate stock. |\n| `canProduce(bomId, qty)` | Calls `explodeRequirements`, then sums `available` stock across every location per component, returns `{ ok: true }` if everything's covered, else `{ ok: false, shortages: [...] }`. |\n\n## ProductionService — consume / produce\n\n```typescript\nimport { ProductionService } from '@happyvertical/smrt-manufacturing';\n\nconst production = await ProductionService.create({ db });\n\n// Drain materials at the factory.\nconst consumed = await production.consumeMaterials(\n  { id: order.id, productId: order.productId, bomId: order.bomId },\n  { locationId: factory.id, qty: runQty },\n);\n\n// Receive finished goods.\nconst produced = await production.produceFinishedGoods(\n  { id: order.id, productId: order.productId },\n  { locationId: factory.id, qty: runQty, finishedSkuId: variant.id },\n);\n\n// Or run both in one transaction — see \"Joint atomicity\" below.\nconst { consumed, produced } = await production.runProduction(\n  { id: order.id, productId: order.productId, bomId: order.bomId },\n  {\n    consume: { locationId: factory.id, qty: runQty },\n    produce: { locationId: factory.id, qty: runQty, finishedSkuId: variant.id },\n  },\n);\n```\n\nAll three methods write through `StockService` and stamp every emitted `StockMovement` with `sourceType: 'ProductionOrder'` + the production order id so audit queries can roll them up later.\n\n### Joint atomicity — `runProduction` vs the two-call form\n\n`consumeMaterials` and `produceFinishedGoods` are each individually atomic, but calling them as two separate awaits is NOT jointly atomic — each opens its own `stockService.withTransaction(...)` scope. If something goes wrong between the two calls (process crash, transient adapter failure on the produce leg), you can land in a state where materials are deducted but no finished SKU receipt balances them. The audit ledger stays consistent within each call; what's missing is the cross-call invariant.\n\nWhen you need that invariant — typically make-to-stock flows where the factory step is invisible to the ledger — use `runProduction(order, { consume, produce })`. Both legs run inside one transaction; any failure (BOM shortage, adapter error, interceptor reject) rolls back both legs together.\n\nWhen NOT to use it: workflows where consume and produce represent a real wall-clock gap that downstream observers need to see (WIP dashboards, partial-run reporting, separate \"materials posted\" and \"production completed\" events on the dispatch bus). There, the two-call form is the right shape — each call is its own ledger event.\n\n### Location convention — explicit-arg design\n\nThe location where materials are consumed and finished goods are received is passed explicitly to `consumeMaterials` / `produceFinishedGoods`, not carried on the production order itself. Rationale:\n\n- The commerce `ProductionOrder` is a `Contract` STI subtype owned by `@happyvertical/smrt-commerce`. Adding an `originLocationId` field there would either need a schema change in commerce (cross-cutting) or a meta field that only manufacturing knows about (leaky).\n- Real shops often pick a location at run time (factory A is congested, route the run through factory B), so even if the order carried a default, the explicit-arg signature is the more flexible canonical form.\n- Callers that want a default can stash a `locationId` on their own production-order helper and pass it through.\n\n### Finished-SKU convention\n\nA `ProductionOrder` references a `productId`, but a `Product` typically has multiple SKUs (one per variant). The caller of `produceFinishedGoods` picks the concrete `finishedSkuId` because the multi-SKU mapping is application-specific (size run, finish mix, kit variant).\n\n## Opt-in DispatchBus hooks\n\nOff by default. Wire them up explicitly in the application's `smrt.ts`:\n\n```typescript\nimport { installManufacturingDispatchHandlers } from '@happyvertical/smrt-manufacturing';\n\nconst handlers = await installManufacturingDispatchHandlers({\n  dispatchBus: bus,\n  db,\n  // Default: subscribe to production_order:posted, call consumeMaterials.\n  installProductionPosted: true,\n  // Default: don't auto-produce. Set to true if your shop emits a\n  // separate production_order:completed event.\n  installProductionCompleted: false,\n  // Default: don't combine consume + produce on `posted`. Set to true\n  // for make-to-stock-instantly workflows where the factory step is\n  // invisible. Ignored when installProductionCompleted is true.\n  producedOnPosted: false,\n});\n```\n\nThis subscribes to:\n\n- `production_order:posted` → `production.consumeMaterials(...)`; when `producedOnPosted: true` the handler instead calls `production.runProduction(...)` so consume + produce share one transaction. Process crashes or adapter errors between the two legs can never leave materials deducted with no finished-goods receipt.\n- `production_order:completed` → `production.produceFinishedGoods(...)` (opt-in)\n\nThe companion handlers for `contract:created` (reserve) and `fulfillment:shipped` (fulfil) live in `@happyvertical/smrt-inventory` — wire both packages' installers from `smrt.ts` to get the full lifecycle.\n\n## Tests\n\n`src/__tests__/assembly-suite.ts` runs on SQLite (`assembly.test.ts`) and on PostgreSQL (`assembly.optional.test.ts`, skipped without `DATABASE_URL`; `pnpm test:postgres` and the PostgreSQL CI lane run it on a transaction-scoped handle). Component tests under `src/svelte/__tests__` use jsdom and assert axe.\n\n## Gotchas\n\n- **`computeMaterialCost` without a resolver returns `$0`.** That is deliberate — manufacturing does not assume any particular cost source. A real wiring will plug in `@happyvertical/smrt-products` `Material.costPerUnit`, or a rolling average from purchase-order history, or a vendor price book. The `costUnavailable` flag tells UIs to surface \"unknown cost\" rather than silently rolling up zeros.\n- **`explodeRequirements` does not call any stock APIs.** It is a planning helper. To check whether the materials are actually on hand, use `canProduce`. To actually deduct them, use `ProductionService.consumeMaterials`.\n- **`canProduce` sums available stock across every location.** The planning question is \"do we have it at all?\". The operational question of \"which warehouse do we pull from?\" is left to the caller of `consumeMaterials`, which targets a single `locationId` per call.\n- **`consumeMaterials` propagates `InsufficientStockError`.** If a line would drive `available` below zero, the underlying `StockService.adjust` throws. Pre-flight with `canProduce` before posting if you want to avoid partial-failure mid-run.\n- **`consumeMaterials` is atomic across BOM lines.** All per-line deductions and their audit rows run inside a single `stockService.withTransaction(...)` scope (powered by `@happyvertical/sql >= 0.74.0`'s native `db.transaction()`). An `InsufficientStockError` on line N+1 rolls back lines 1..N so production-order posting never leaves materials half-consumed. The recommended pre-flight (`BomService.canProduce(orderId, qty)`) is still useful when you'd rather know upfront than discover the shortfall mid-run, but a missed pre-flight no longer corrupts state.\n- **`consumeMaterials` + `produceFinishedGoods` are NOT jointly atomic.** Each opens its own transaction. A failure on the produce leg leaves materials deducted with no finished SKU receipt to balance it. Use `runProduction(order, { consume, produce })` when you need both legs to commit or roll back together.\n- **Cross-package references are plain strings.** `productId`, `componentSkuId`, `bomId` (within this package) — all plain string ids, never `@foreignKey()`. The package does depend on `smrt-products` (for `Assembly` and the resolve helper), but the bill schema does not couple to the catalog's table layout.\n- **`Assembly` fields are columns, not `Meta<T>`.** Unlike `Material`, its own fields are ordinary columns this package adds to `products` (filterable over REST). The PostgreSQL suite asserts they land there.\n- **`AssemblyCollection` lists exact `Assembly` rows.** An application subtype (e.g. one adding a customer) has its own `_meta_type`; read it through its own collection or `ProductCollection` (`resolveComponent` uses `instanceof Assembly`, so subtypes resolve as assemblies).\n- **`conflictColumns` include `tenant_id`** on both models. NULL-matching semantics are handled by `@happyvertical/sql >= 0.74.0`; two saves with the same `(product_id, version, NULL)` tuple merge in place.\n- **Lazy table creation.** Like everything else in SMRT, the `manufacturing_boms` and `manufacturing_bom_lines` tables are created on first DB op via `syncSchema`. Safe for SSR. A `BomLine` save now reads `product_skus` and `products` for the cycle check.\n- **Cross-industry constraint.** This package's vocabulary stays generic. Apparel-specific concepts (`Style`, `Makeup`, `Colorway`, `tech-pack`, fashion `Season`) and their analogues in furniture / automotive / CPG live in the relevant template package, never here. PRs that introduce industry vocabulary should be rejected.\n\n## Source attribution\n\nEvery emitted `StockMovement` carries `sourceType: 'ProductionOrder'` plus `sourceId: order.id` so downstream queries can reconstruct \"what caused this movement\". Reason codes used:\n\n| reasonCode | Emitter | Note |\n|---|---|---|\n| `production_consume` | `ProductionService.consumeMaterials` | One per BOM line per consume call |\n| `production_produce` | `ProductionService.produceFinishedGoods` | One per produce call |\n\nThese join cleanly with the standard inventory reason codes (`receipt`, `reservation`, `release`, `fulfillment`, `transfer_out`, `transfer_in`, `adjustment`) defined in `@happyvertical/smrt-inventory`.\n\n## Dependencies\n\n| Package | Purpose |\n|---|---|\n| `@happyvertical/smrt-core` | SmrtObject / SmrtCollection / DispatchBus |\n| `@happyvertical/smrt-inventory` | StockService, stock levels, movements (the `Sku` model itself lives in `@happyvertical/smrt-products`; inventory tracks stock motion against the id) |\n| `@happyvertical/smrt-products` | `Product` (the `Assembly` STI base), `Material`, `Sku` for the resolve helper and cycle check |\n| `@happyvertical/smrt-fields` | `ObjectForm` and field-policy column visibility for the Svelte components |\n| `@happyvertical/smrt-ui` / `smrt-types` | Svelte controls, i18n, module UI slots |\n| `@happyvertical/smrt-tenancy` | Optional tenant scoping |\n| `@happyvertical/sql` | Database adapter |\n"
 }