soustack 0.4.5 → 0.4.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soustack",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "The logic engine for computational recipes - validation, scaling, parsing, and Schema.org conversion",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/stacks/compute.schema 3.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://soustack.spec/stacks/compute.schema.json",
-  "title": "Compute Claim Stack",
-  "type": "object",
-  "additionalProperties": false
-}

package/src/stacks/dietary.schema 3.json

@@ -1,45 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://soustack.spec/stacks/dietary.schema.json",
-  "title": "Dietary Stack",
-  "type": "object",
-  "properties": {
-    "dietary": {
-      "type": "object",
-      "properties": {
-        "basis": { "type": "string", "enum": ["perServing", "perRecipe"] },
-        "calories": { "type": "number", "minimum": 0 },
-        "macros": {
-          "type": "object",
-          "properties": {
-            "protein": { "type": "number", "minimum": 0 },
-            "fat": { "type": "number", "minimum": 0 },
-            "carbohydrates": { "type": "number", "minimum": 0 },
-            "metadata": { "type": "object", "additionalProperties": true }
-          },
-          "minProperties": 1,
-          "additionalProperties": false,
-          "patternProperties": {
-            "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-          }
-        },
-        "diets": { "type": "array", "items": { "type": "string" } },
-        "allergens": { "type": "array", "items": { "type": "string" } },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "required": ["basis"],
-      "additionalProperties": false,
-      "anyOf": [
-        { "required": ["calories"] },
-        { "required": ["macros"] },
-        { "required": ["diets"] },
-        { "required": ["allergens"] }
-      ],
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    }
-  },
-  "required": ["dietary"],
-  "additionalProperties": false
-}

package/src/stacks/dietary@1 3.md

@@ -1,24 +0,0 @@
-# dietary@1
-
-## Purpose
-The `dietary@1` stack enables recipes to declare nutritional information, dietary classifications, and allergen information.
-
-## Adds
-- Top-level `dietary` object with `basis` field (perServing or perRecipe).
-- Optional `calories`, `macros` (protein, fat, carbohydrates), `diets`, and `allergens` fields.
-- At least one of calories, macros, diets, or allergens must be present.
-
-## Requires
-- None
-
-## Semantics
-- MUST: The `dietary` object must include a `basis` field.
-- MUST: At least one of `calories`, `macros`, `diets`, or `allergens` must be present.
-- NOTE: Dietary tags and allergen lists are freeform strings in v1 (no controlled vocabulary).
-
-## Composition Notes
-- This stack is monotonic: it adds requirements or fields without removing expressiveness.
-- Interaction: No dependencies on other stacks. Can be combined with any other stack.
-
-
-

package/src/stacks/illustrated@1 3.md

@@ -1,24 +0,0 @@
-# illustrated@1
-
-## Purpose
-The `illustrated@1` stack enables recipes to include media (images and videos) at the recipe and step levels for visual guidance.
-
-## Adds
-- Top-level `images` and `videos` arrays (optional).
-- Step objects may include `images` and `videos` arrays.
-- Steps are structured objects with `id` fields.
-
-## Requires
-- None
-
-## Semantics
-- MUST: At least one media item (image or video) must be present at the recipe level or in at least one step.
-- MUST: Step objects must include `id` fields (steps are structured).
-- NOTE: Media URIs must be valid according to the URI schema definition.
-
-## Composition Notes
-- This stack is monotonic: it adds requirements or fields without removing expressiveness.
-- Interaction: Works with `structured@1` for step-level media. No dependencies on other stacks.
-
-
-

package/src/stacks/prep.schema 3.json

@@ -1,76 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://soustack.spec/stacks/prep.schema.json",
-  "title": "Prep Stack",
-  "type": "object",
-  "properties": {
-    "miseEnPlace": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "$ref": "#/$defs/miseEnPlaceTask"
-      }
-    }
-  },
-  "required": ["miseEnPlace"],
-  "$defs": {
-    "miseEnPlaceTask": {
-      "type": "object",
-      "properties": {
-        "id": {
-          "type": "string",
-          "pattern": "^[A-Za-z0-9._-]+$"
-        },
-        "text": {
-          "type": "string",
-          "minLength": 1
-        },
-        "inputs": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "uniqueItems": true,
-          "minItems": 1
-        },
-        "usesEquipment": {
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[A-Za-z0-9._-]+$"
-          },
-          "uniqueItems": true,
-          "minItems": 1
-        }
-      },
-      "required": ["text"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": {
-          "$ref": "../defs/common.schema.json#/properties/extensionLaneValue"
-        }
-      }
-    },
-    "prepItem": {
-      "type": "object",
-      "properties": {
-        "verb": {
-          "type": "string",
-          "minLength": 1
-        },
-        "detail": {
-          "type": "string"
-        }
-      },
-      "required": ["verb"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": {
-          "$ref": "../defs/common.schema.json#/properties/extensionLaneValue"
-        }
-      }
-    }
-  },
-  "additionalProperties": false
-}
-

package/src/stacks/prep@1 3.md

@@ -1,276 +0,0 @@
-#prep@1
-
----
-
-## Purpose
-
-The `prep@1` stack enables recipes to include preparation guidance at both the ingredient level and as explicit mise en place tasks. This makes recipes more operational by providing clear prep instructions and planning checklists.
-
-This stack is adoption-first: ingredient prep can be simple strings for minimal friction, or structured objects for more detailed guidance.
-
----
-
-## Requirements
-
-A document that declares `prep@1`:
-
-• MUST satisfy all structural rules enabled by this stack.
-• MUST satisfy the semantic rules described below.
-
----
-
-## Data Model
-
-When `prep@1` is declared, the document MUST include a top-level `miseEnPlace` array.
-
-### Mise En Place Array
-
-The `miseEnPlace` array contains one or more tasks. Each task is a structured object that describes a prep step.
-
-### Ingredient-Level Prep
-
-Ingredient objects MAY include an optional `prep` field that describes how the ingredient should be prepared. The `prep` field supports multiple formats:
-
-• A single string (simple prep phrase)
-• An array of strings (multiple prep notes)
-• An array of structured prep items
-
----
-
-## Ingredient Prep Formats
-
-### String Format
-
-A simple string describing the prep:
-
-```json
-{
-  "id": "onion",
-  "name": "Onion",
-  "prep": "finely diced"
-}
-```
-
-### Array of Strings
-
-Multiple prep notes:
-
-```json
-{
-  "id": "garlic",
-  "name": "Garlic",
-  "prep": ["peeled", "minced"]
-}
-```
-
-### Structured Prep Items
-
-More detailed prep instructions with verbs and details:
-
-```json
-{
-  "id": "tomato",
-  "name": "Tomato",
-  "prep": [
-    { "verb": "dice", "detail": "fine" },
-    { "verb": "reserve", "detail": "half for garnish" }
-  ]
-}
-```
-
-Each prep item object includes:
-
-• `verb` (required): string describing the action (freeform; no controlled vocabulary in v1)
-• `detail` (optional): string providing additional context
-
----
-
-## Mise En Place Tasks
-
-### Minimal Task
-
-A task with only required text:
-
-```json
-{
-  "miseEnPlace": [
-    { "text": "Finely dice the onion" },
-    { "text": "Mince the garlic" }
-  ]
-}
-```
-
-### Task with ID
-
-Tasks may include an optional `id` for cross-referencing:
-
-```json
-{
-  "miseEnPlace": [
-    { "id": "dice-onion", "text": "Finely dice the onion" },
-    { "id": "mince-garlic", "text": "Mince the garlic" }
-  ]
-}
-```
-
-Task IDs MUST be unique within the `miseEnPlace` array (semantic validation).
-
-### Task with Ingredient References
-
-When `referenced@1` is present, tasks may reference ingredient IDs:
-
-```json
-{
-  "miseEnPlace": [
-    {
-      "text": "Prepare the vegetables",
-      "inputs": ["onion", "garlic"]
-    }
-  ]
-}
-```
-
-Each id in `inputs` MUST exist in the ingredients array (semantic validation when both stacks are present).
-
-### Task with Equipment References
-
-When `equipment@1` is present, tasks may reference equipment IDs:
-
-```json
-{
-  "miseEnPlace": [
-    {
-      "text": "Sharpen the knife",
-      "usesEquipment": ["knife"]
-    }
-  ]
-}
-```
-
-Each id in `usesEquipment` MUST exist in the equipment array (semantic validation when both stacks are present).
-
-### Combined References
-
-Tasks may include both `inputs` and `usesEquipment`:
-
-```json
-{
-  "miseEnPlace": [
-    {
-      "text": "Dice the onion with a sharp knife",
-      "inputs": ["onion"],
-      "usesEquipment": ["knife"]
-    }
-  ]
-}
-```
-
----
-
-## Semantics
-
-### Prep Field
-
-The ingredient `prep` field is descriptive and freeform. In v1, there is no controlled vocabulary for prep verbs or details. Tools may interpret these as hints for display or planning, but validation does not enforce specific values.
-
-### Mise En Place
-
-The `miseEnPlace` array is an explicit checklist of prep tasks. Tools may render this as a prep plan, separate from the main cooking instructions. Tasks are ordered and may be presented as a sequential checklist.
-
----
-
-## Composition
-
-The prep stack is composable with other stacks:
-
-• No hard dependency on `referenced@1` or `equipment@1` (references are optional and only validated when those stacks are present)
-• Works with `structured@1` to enable ingredient object definitions
-• Remains monotonic: does not close objects needed by other stacks
-• Ingredient `prep` is optional even when the stack is present
-
----
-
-## Semantic Validation Rules (Normative)
-
-Validators MUST enforce the following rules:
-
-1. Mise en place task ID uniqueness
-   If tasks include `id` values, all task IDs MUST be unique within the `miseEnPlace` array.
-
-2. Ingredient reference resolution
-   If both `prep@1` and `referenced@1` are present, and a task includes `inputs`, all referenced ingredient IDs MUST exist in the ingredients array.
-
-3. Equipment reference resolution
-   If both `prep@1` and `equipment@1` are present, and a task includes `usesEquipment`, all referenced equipment IDs MUST exist in the equipment array (as object ids, not string items).
-
----
-
-## Examples
-
-Minimal mise en place
-
-```json
-{
-  "miseEnPlace": [
-    { "text": "Finely dice the onion" },
-    { "text": "Mince the garlic" }
-  ]
-}
-```
-
-Ingredient prep with strings
-
-```json
-{
-  "ingredients": [
-    {
-      "id": "onion",
-      "name": "Onion",
-      "prep": "finely diced"
-    },
-    {
-      "id": "garlic",
-      "name": "Garlic",
-      "prep": ["peeled", "minced"]
-    }
-  ]
-}
-```
-
-Structured prep items
-
-```json
-{
-  "ingredients": [
-    {
-      "id": "tomato",
-      "name": "Tomato",
-      "prep": [
-        { "verb": "dice", "detail": "fine" },
-        { "verb": "reserve", "detail": "half for garnish" }
-      ]
-    }
-  ]
-}
-```
-
-Mise en place with references
-
-```json
-{
-  "equipment": [
-    { "id": "knife", "name": "Chef's knife" }
-  ],
-  "ingredients": [
-    { "id": "onion", "name": "Onion" }
-  ],
-  "miseEnPlace": [
-    {
-      "text": "Dice the onion with a sharp knife",
-      "inputs": ["onion"],
-      "usesEquipment": ["knife"]
-    }
-  ]
-}
-```
-

package/src/stacks/referenced.schema 3.json

@@ -1,96 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://soustack.spec/stacks/referenced.schema.json",
-  "title": "Referenced Stack",
-  "type": "object",
-  "properties": {
-    "ingredients": {
-      "type": "array",
-      "items": {
-        "anyOf": [
-          { "$ref": "#/$defs/ingredient" },
-          { "$ref": "#/$defs/ingredientSection" }
-        ]
-      }
-    },
-    "instructions": {
-      "type": "array",
-      "items": {
-        "anyOf": [
-          { "$ref": "#/$defs/referencedStep" },
-          { "$ref": "#/$defs/referencedSection" }
-        ]
-      }
-    }
-  },
-  "required": ["ingredients", "instructions"],
-  "allOf": [
-    { "$ref": "./structured.schema.json" }
-  ],
-  "$defs": {
-    "ingredient": {
-      "allOf": [
-        { "$ref": "../defs/entities.schema.json#/$defs/IngredientBase" },
-        { "required": ["id"] }
-      ]
-    },
-    "ingredientSection": {
-      "type": "object",
-      "properties": {
-        "section": { "type": "string" },
-        "ingredients": {
-          "type": "array",
-          "items": {
-            "anyOf": [
-              { "$ref": "#/$defs/ingredient" },
-              { "$ref": "#/$defs/ingredientSection" }
-            ]
-          }
-        },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "required": ["section", "ingredients"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    },
-    "referencedStep": {
-      "allOf": [
-        { "$ref": "../defs/entities.schema.json#/$defs/StepBase" },
-        {
-          "properties": {
-            "inputs": {
-              "allOf": [
-                { "$ref": "../defs/entities.schema.json#/$defs/StepBase/properties/inputs" },
-                { "minItems": 1 }
-              ]
-            }
-          },
-          "required": ["id", "inputs"]
-        }
-      ]
-    },
-    "referencedSection": {
-      "type": "object",
-      "properties": {
-        "section": { "type": "string" },
-        "steps": {
-          "type": "array",
-          "items": {
-            "anyOf": [
-              { "$ref": "#/$defs/referencedStep" },
-              { "$ref": "#/$defs/referencedSection" }
-            ]
-          }
-        },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "required": ["section", "steps"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    }
-  }
-}

package/src/stacks/scaling.schema 3.json

@@ -1,99 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://soustack.spec/stacks/scaling.schema.json",
-  "title": "Scaling Stack",
-  "type": "object",
-  "properties": {
-    "ingredients": {
-      "type": "array",
-      "items": {
-        "anyOf": [
-          { "$ref": "#/$defs/ingredient" },
-          { "$ref": "#/$defs/ingredientSection" }
-        ]
-      }
-    },
-    "scaling": {
-      "type": "object",
-      "properties": {
-        "discrete": {
-          "type": "object",
-          "properties": {
-            "min": { "type": "integer", "minimum": 1 },
-            "max": { "type": "integer", "minimum": 1 },
-            "step": { "type": "integer", "minimum": 1 },
-            "metadata": { "type": "object", "additionalProperties": true }
-          },
-          "required": ["min", "max"],
-          "additionalProperties": false,
-          "patternProperties": {
-            "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-          }
-        },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "required": ["discrete"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    }
-  },
-  "required": ["ingredients", "scaling"],
-  "$defs": {
-    "ingredient": {
-      "type": "object",
-      "properties": {
-        "id": { "type": "string" },
-        "name": { "type": "string" },
-        "quantity": { "$ref": "../defs/quantity.schema.json" },
-        "temperature": { "$ref": "../defs/temperature.schema.json" },
-        "notes": { "type": "string" },
-        "prep": {
-          "oneOf": [
-            { "type": "string", "minLength": 1 },
-            {
-              "type": "array",
-              "minItems": 1,
-              "items": {
-                "anyOf": [
-                  { "type": "string", "minLength": 1 },
-                  { "$ref": "../stacks/prep.schema.json#/$defs/prepItem" }
-                ]
-              }
-            }
-          ]
-        },
-        "metadata": { "type": "object", "additionalProperties": true },
-        "scaling": { "$ref": "../defs/scalingRule.schema.json" }
-      },
-      "required": ["id", "name", "quantity"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    },
-    "ingredientSection": {
-      "type": "object",
-      "properties": {
-        "section": { "type": "string" },
-        "ingredients": {
-          "type": "array",
-          "items": {
-            "anyOf": [
-              { "$ref": "#/$defs/ingredient" },
-              { "$ref": "#/$defs/ingredientSection" }
-            ]
-          }
-        },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "required": ["section", "ingredients"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/src/stacks/scaling@1 3.md

@@ -1,238 +0,0 @@
-#scaling@1
-
----
-
-## Purpose
-
-The `scaling@1` stack standardizes how ingredient quantities change when a recipe is scaled, so independent implementations produce consistent results.
-
-This stack is intended to support the **Scalable** profile.
-
----
-
-## Requirements
-
-A document that declares `scaling@1`:
-
-• MUST declare `quantified@1`.
-• SHOULD declare `structured@1` (recommended for stable ingredient IDs).
-• MUST satisfy all structural rules enabled by this stack.
-• MUST satisfy the semantic rules described below.
-
----
-
-## Data Model
-
-When `scaling@1` is declared, quantified ingredients MAY include an optional `scaling` field.
-
-Field
-ingredient.scaling : ScalingRule
-
-ScalingRule is defined in `defs/scalingRule.schema.json` and is a closed object with a required `mode`.
-
----
-
-## Scaling Modes
-
-### linear
-
-Multiply the ingredient quantity by the scale factor.
-
-mode = "linear"
-
-If `scaling` is omitted, implementations MUST treat the ingredient as linear by default.
-
----
-
-### fixed
-
-Do not scale this ingredient quantity.
-
-Examples:
-• 1 bay leaf
-• 1 cinnamon stick
-• 1 pan
-
-mode = "fixed"
-
----
-
-### discrete
-
-Scale using discrete increments (for example, whole eggs), with optional rounding and bounds.
-
-Fields
-• mode = "discrete"
-• step (optional, > 0): discrete increment size
-• rounding (optional): nearest | ceil | floor
-• min (optional): minimum allowed result
-• max (optional): maximum allowed result
-
-Semantic defaults
-• If step is not present, default is 1
-• If rounding is not present, default is nearest
-
----
-
-### toTaste
-
-Quantity is informational and MUST NOT be mechanically scaled.
-
-Examples:
-• salt to taste
-• pepper to taste
-
-mode = "toTaste"
-
----
-
-### bakersPercent
-
-Represents the ingredient quantity as a baker’s percentage of a base ingredient (typically flour).
-
-Fields
-• mode = "bakersPercent"
-• percent (> 0): percentage value (for example, 70 for 70%)
-• of (string): ingredient id of the base ingredient
-
----
-
-## Scale Factor
-
-Scaling is applied using a scale factor F.
-
-How F is selected depends on the consumer implementation:
-
-• Some consumers may accept an explicit factor (for example, “2x”).
-• Some consumers may compute F from yield changes (for example, “scale from 4 servings to 6 servings”).
-
-This stack standardizes how ingredient rules respond to F, not how F is chosen.
-
----
-
-## Semantic Validation Rules (Normative)
-
-Validators MUST enforce the following rules:
-
-1. Prerequisite
-   If `scaling@1` is declared, `quantified@1` MUST also be declared.
-
-2. Baker’s percent reference
-   For mode = "bakersPercent", the `of` field MUST resolve to an existing ingredient id.
-
-3. Discrete sanity
-   For mode = "discrete", if both `min` and `max` are present, min MUST be less than or equal to max.
-
-4. Closed rule objects
-   ScalingRule MUST NOT contain unspecified fields. This is enforced by schema.
-
-Consumers MUST apply the following semantic defaults:
-
-• Missing `scaling` ⇒ treat as linear
-• discrete.step default = 1
-• discrete.rounding default = nearest
-
----
-
-## Scaling Behavior (Normative)
-
-Given an ingredient with base quantity amount A and scale factor F:
-
-• linear
-scaled amount = A × F
-
-• fixed
-scaled amount = A
-
-• toTaste
-scaled amount = A (informational only)
-Consumers MAY hide numeric scaling UI for this item.
-
-• discrete
-
-1. raw = A × F
-2. if step is present, units = raw ÷ step
-3. apply rounding to units
-4. scaled = units × step
-5. clamp to min / max if present
-
-• bakersPercent
-
-1. let B be the amount of the ingredient referenced by `of`
-2. scaled amount = B × (percent ÷ 100)
-
----
-
-## Examples
-
-Linear (default)
-
-Ingredient
-id: i_sugar
-name: Sugar
-quantity: 100 g
-(no scaling field → treated as linear)
-
----
-
-Fixed
-
-Ingredient
-id: i_bayleaf
-name: Bay leaf
-quantity: 1 leaf
-scaling: mode = fixed
-
----
-
-Discrete (eggs)
-
-Ingredient
-id: i_eggs
-name: Eggs
-quantity: 2 egg
-scaling: mode = discrete, rounding = ceil
-
----
-
-To taste
-
-Ingredient
-id: i_salt
-name: Salt
-quantity: 1 tsp
-scaling: mode = toTaste
-
----
-
-Baker’s percent
-
-Ingredient A
-id: i_flour
-name: Flour
-quantity: 500 g
-
-Ingredient B
-id: i_water
-name: Water
-quantity: 350 g
-scaling: mode = bakersPercent, percent = 70, of = i_flour
-
----
-
-## Fixtures
-
-Implementations SHOULD include fixtures covering:
-
-Valid cases
-• linear default (no scaling rule)
-• discrete with rounding
-• fixed
-• toTaste
-• bakersPercent with resolvable `of`
-
-Invalid cases
-• scaling declared without quantified
-• bakersPercent with missing or invalid `of`
-• invalid rounding value
-• discrete with min greater than max

package/src/stacks/storage.schema 3.json

@@ -1,132 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://soustack.spec/stacks/storage.schema.json",
-  "title": "Storage Stack",
-  "type": "object",
-  "properties": {
-    "storage": {
-      "type": "object",
-      "properties": {
-        "roomTemp": { "$ref": "#/$defs/storageMethod" },
-        "refrigerated": { "$ref": "#/$defs/storageMethod" },
-        "frozen": { "$ref": "#/$defs/storageMethod" },
-        "leftovers": { "$ref": "#/$defs/leftovers" },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "anyOf": [
-        { "required": ["roomTemp"] },
-        { "required": ["refrigerated"] },
-        { "required": ["frozen"] }
-      ],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    }
-  },
-  "required": ["storage"],
-  "$defs": {
-    "storageMethod": {
-      "type": "object",
-      "properties": {
-        "duration": { "$ref": "../defs/duration.schema.json#/properties/StorageDuration" },
-        "notes": { "type": "string" },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "required": ["duration"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    },
-    "reheatDuration": {
-      "type": "object",
-      "properties": {
-        "minMinutes": { "type": "integer", "minimum": 0 },
-        "maxMinutes": { "type": "integer", "minimum": 0 }
-      },
-      "anyOf": [
-        { "required": ["minMinutes"] },
-        { "required": ["maxMinutes"] }
-      ],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    },
-    "reheatInstruction": {
-      "type": "object",
-      "properties": {
-        "method": { "type": "string", "minLength": 1 },
-        "temp": {
-          "type": "object",
-          "properties": {
-            "value": { "type": "number" },
-            "unit": { "type": "string", "enum": ["F", "C"] }
-          },
-          "required": ["value", "unit"],
-          "additionalProperties": false,
-          "patternProperties": {
-            "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-          }
-        },
-        "duration": { "$ref": "#/$defs/reheatDuration" },
-        "notes": { "type": "string" }
-      },
-      "required": ["method"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    },
-    "portioning": {
-      "type": "object",
-      "properties": {
-        "notes": { "type": "string" },
-        "recommendedPortion": {
-          "type": "object",
-          "properties": {
-            "quantity": { "type": "number" },
-            "unit": { "type": "string" }
-          },
-          "required": ["quantity", "unit"],
-          "additionalProperties": false,
-          "patternProperties": {
-            "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-          }
-        }
-      },
-      "required": ["notes"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    },
-    "leftovers": {
-      "type": "object",
-      "properties": {
-        "notes": { "type": "string" },
-        "reheat": {
-          "oneOf": [
-            {
-              "type": "array",
-              "items": { "type": "string" },
-              "minItems": 1
-            },
-            {
-              "type": "array",
-              "items": { "$ref": "#/$defs/reheatInstruction" },
-              "minItems": 1
-            }
-          ]
-        },
-        "portioning": { "$ref": "#/$defs/portioning" }
-      },
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/src/stacks/structured.schema 3.json

@@ -1,48 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://soustack.spec/stacks/structured.schema.json",
-  "title": "Structured Stack",
-  "type": "object",
-  "properties": {
-    "instructions": {
-      "type": "array",
-      "items": {
-        "anyOf": [
-          { "$ref": "#/$defs/step" },
-          { "$ref": "#/$defs/stepSection" }
-        ]
-      }
-    }
-  },
-  "required": ["instructions"],
-  "$defs": {
-    "step": {
-      "allOf": [
-        { "$ref": "../defs/entities.schema.json#/$defs/StepBase" },
-        { "required": ["id"] }
-      ]
-    },
-    "stepSection": {
-      "type": "object",
-      "properties": {
-        "section": { "type": "string" },
-        "steps": {
-          "type": "array",
-          "items": {
-            "anyOf": [
-              { "$ref": "#/$defs/step" },
-              { "$ref": "#/$defs/stepSection" }
-            ]
-          }
-        },
-        "metadata": { "type": "object", "additionalProperties": true }
-      },
-      "required": ["section", "steps"],
-      "additionalProperties": false,
-      "patternProperties": {
-        "^x-": { "$ref": "../defs/common.schema.json#/properties/extensionLaneValue" }
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/src/stacks/substitutions@1 3.md

@@ -1,24 +0,0 @@
-# substitutions@1
-
-## Purpose
-The `substitutions@1` stack enables recipes to declare ingredient substitutions with alternatives and ratios.
-
-## Adds
-- Top-level `substitutions` array with substitution objects.
-- Each substitution includes `for` (ingredient ID) and `alternatives` array.
-- Each alternative includes `name` and `ratio` fields.
-
-## Requires
-- `referenced@1`
-
-## Semantics
-- MUST: The `for` field must reference an ingredient ID that exists in the ingredients array.
-- MUST: Each substitution must include at least one alternative.
-- NOTE: This stack requires `referenced@1` to ensure ingredient IDs are available for reference.
-
-## Composition Notes
-- This stack is monotonic: it adds requirements or fields without removing expressiveness.
-- Interaction: Requires `referenced@1` for ingredient ID resolution. Substitutions are informational and do not affect recipe structure.
-
-
-

package/src/stacks/timed@1 3.md

@@ -1,23 +0,0 @@
-# timed@1
-
-## Purpose
-The `timed@1` stack enables recipes to include timing information for steps, supporting scheduling and time-based planning.
-
-## Adds
-- Step objects must include a `timing` field with `activity` (active/passive) and either `duration` or `completionCue`.
-- Timing may include duration ranges (minMinutes/maxMinutes) or completion cues.
-
-## Requires
-- `structured@1`
-
-## Semantics
-- MUST: Each step must include a `timing` object with `activity` field.
-- MUST: Each timing object must include either `duration` or `completionCue`.
-- NOTE: This stack implies `structured@1` (steps are objects with IDs).
-
-## Composition Notes
-- This stack is monotonic: it adds requirements or fields without removing expressiveness.
-- Interaction: Required by `compute@1` for deterministic scheduling. Works with `quantified@1` for computational recipe planning.
-
-
-