{
    "oat_control_contract": "1.0",
    "generated_at": "2026-06-19T12:32:57+00:00",
    "recipe": {
        "slug": "oat-ks-lettuce-bundle",
        "name": "Lettuce — master grow recipe (keystone draft)",
        "cultivar": "Lettuce",
        "weeks": 5
    },
    "time_model": {
        "step_unit": "week",
        "steps": 5
    },
    "executor": "edge",
    "semantics": "Per control point, per step: hold `setpoint`; warn_low/warn_high is the deadband (advisory); alarm_low/alarm_high are trip thresholds. Steps are 0-based weeks; `stages` give the timeline. Same four-band thresholds the human SOP renders as aim/OK/act-if. measurable_via/controllable_via (when present) hint sensors/actuators.",
    "stages": [
        {
            "label": "Growth",
            "start_step": 0,
            "end_step": 4,
            "params": {
                "trigger": "calendar",
                "detail": null,
                "duration_days": 35
            }
        }
    ],
    "control_points": [
        {
            "key": "dli_canopy",
            "zone": "aerial",
            "engine": "light",
            "label": "Daily light (DLI)",
            "unit": "mol/m2/d",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 14.5,
                    "warn_low": 10.2,
                    "warn_high": 19.55,
                    "alarm_low": 8.4,
                    "alarm_high": 22.1
                },
                {
                    "step": 1,
                    "setpoint": 14.5,
                    "warn_low": 10.2,
                    "warn_high": 19.55,
                    "alarm_low": 8.4,
                    "alarm_high": 22.1
                },
                {
                    "step": 2,
                    "setpoint": 14.5,
                    "warn_low": 10.2,
                    "warn_high": 19.55,
                    "alarm_low": 8.4,
                    "alarm_high": 22.1
                },
                {
                    "step": 3,
                    "setpoint": 14.5,
                    "warn_low": 10.2,
                    "warn_high": 19.55,
                    "alarm_low": 8.4,
                    "alarm_high": 22.1
                },
                {
                    "step": 4,
                    "setpoint": 14.5,
                    "warn_low": 10.2,
                    "warn_high": 19.55,
                    "alarm_low": 8.4,
                    "alarm_high": 22.1
                }
            ]
        },
        {
            "key": "photoperiod_hours",
            "zone": "aerial",
            "engine": "light",
            "label": "Photoperiod",
            "unit": "h",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 16,
                    "warn_low": null,
                    "warn_high": null,
                    "alarm_low": null,
                    "alarm_high": null
                },
                {
                    "step": 1,
                    "setpoint": 16,
                    "warn_low": null,
                    "warn_high": null,
                    "alarm_low": null,
                    "alarm_high": null
                },
                {
                    "step": 2,
                    "setpoint": 16,
                    "warn_low": null,
                    "warn_high": null,
                    "alarm_low": null,
                    "alarm_high": null
                },
                {
                    "step": 3,
                    "setpoint": 16,
                    "warn_low": null,
                    "warn_high": null,
                    "alarm_low": null,
                    "alarm_high": null
                },
                {
                    "step": 4,
                    "setpoint": 16,
                    "warn_low": null,
                    "warn_high": null,
                    "alarm_low": null,
                    "alarm_high": null
                }
            ]
        },
        {
            "key": "air_temperature_day",
            "zone": "aerial",
            "engine": "environment",
            "label": "Air temp — day",
            "unit": "°C",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 21,
                    "warn_low": 15.3,
                    "warn_high": 27.6,
                    "alarm_low": 12.6,
                    "alarm_high": 31.2
                },
                {
                    "step": 1,
                    "setpoint": 21,
                    "warn_low": 15.3,
                    "warn_high": 27.6,
                    "alarm_low": 12.6,
                    "alarm_high": 31.2
                },
                {
                    "step": 2,
                    "setpoint": 21,
                    "warn_low": 15.3,
                    "warn_high": 27.6,
                    "alarm_low": 12.6,
                    "alarm_high": 31.2
                },
                {
                    "step": 3,
                    "setpoint": 21,
                    "warn_low": 15.3,
                    "warn_high": 27.6,
                    "alarm_low": 12.6,
                    "alarm_high": 31.2
                },
                {
                    "step": 4,
                    "setpoint": 21,
                    "warn_low": 15.3,
                    "warn_high": 27.6,
                    "alarm_low": 12.6,
                    "alarm_high": 31.2
                }
            ]
        },
        {
            "key": "air_temperature_night",
            "zone": "aerial",
            "engine": "environment",
            "label": "Air temp — night",
            "unit": "°C",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 16.5,
                    "warn_low": 12.75,
                    "warn_high": 20.7,
                    "alarm_low": 10.5,
                    "alarm_high": 23.4
                },
                {
                    "step": 1,
                    "setpoint": 16.5,
                    "warn_low": 12.75,
                    "warn_high": 20.7,
                    "alarm_low": 10.5,
                    "alarm_high": 23.4
                },
                {
                    "step": 2,
                    "setpoint": 16.5,
                    "warn_low": 12.75,
                    "warn_high": 20.7,
                    "alarm_low": 10.5,
                    "alarm_high": 23.4
                },
                {
                    "step": 3,
                    "setpoint": 16.5,
                    "warn_low": 12.75,
                    "warn_high": 20.7,
                    "alarm_low": 10.5,
                    "alarm_high": 23.4
                },
                {
                    "step": 4,
                    "setpoint": 16.5,
                    "warn_low": 12.75,
                    "warn_high": 20.7,
                    "alarm_low": 10.5,
                    "alarm_high": 23.4
                }
            ]
        },
        {
            "key": "relative_humidity",
            "zone": "aerial",
            "engine": "environment",
            "label": "Humidity",
            "unit": "%",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 1,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 2,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 3,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 4,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                }
            ]
        },
        {
            "key": "vpd_air",
            "zone": "aerial",
            "engine": "environment",
            "label": "VPD",
            "unit": "kPa",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 0.8,
                    "warn_low": 0.51,
                    "warn_high": 1.15,
                    "alarm_low": 0.42,
                    "alarm_high": 1.3
                },
                {
                    "step": 1,
                    "setpoint": 0.8,
                    "warn_low": 0.51,
                    "warn_high": 1.15,
                    "alarm_low": 0.42,
                    "alarm_high": 1.3
                },
                {
                    "step": 2,
                    "setpoint": 0.8,
                    "warn_low": 0.51,
                    "warn_high": 1.15,
                    "alarm_low": 0.42,
                    "alarm_high": 1.3
                },
                {
                    "step": 3,
                    "setpoint": 0.8,
                    "warn_low": 0.51,
                    "warn_high": 1.15,
                    "alarm_low": 0.42,
                    "alarm_high": 1.3
                },
                {
                    "step": 4,
                    "setpoint": 0.8,
                    "warn_low": 0.51,
                    "warn_high": 1.15,
                    "alarm_low": 0.42,
                    "alarm_high": 1.3
                }
            ]
        },
        {
            "key": "co2_air",
            "zone": "aerial",
            "engine": "environment",
            "label": "CO₂",
            "unit": "ppm",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 850,
                    "warn_low": 595,
                    "warn_high": 1150,
                    "alarm_low": 490,
                    "alarm_high": 1300
                },
                {
                    "step": 1,
                    "setpoint": 850,
                    "warn_low": 595,
                    "warn_high": 1150,
                    "alarm_low": 490,
                    "alarm_high": 1300
                },
                {
                    "step": 2,
                    "setpoint": 850,
                    "warn_low": 595,
                    "warn_high": 1150,
                    "alarm_low": 490,
                    "alarm_high": 1300
                },
                {
                    "step": 3,
                    "setpoint": 850,
                    "warn_low": 595,
                    "warn_high": 1150,
                    "alarm_low": 490,
                    "alarm_high": 1300
                },
                {
                    "step": 4,
                    "setpoint": 850,
                    "warn_low": 595,
                    "warn_high": 1150,
                    "alarm_low": 490,
                    "alarm_high": 1300
                }
            ]
        },
        {
            "key": "air_circulation",
            "zone": "aerial",
            "engine": "environment",
            "label": "Air changes",
            "unit": "ACH",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 22.5,
                    "warn_low": 12.75,
                    "warn_high": 34.5,
                    "alarm_low": 10.5,
                    "alarm_high": 39
                },
                {
                    "step": 1,
                    "setpoint": 22.5,
                    "warn_low": 12.75,
                    "warn_high": 34.5,
                    "alarm_low": 10.5,
                    "alarm_high": 39
                },
                {
                    "step": 2,
                    "setpoint": 22.5,
                    "warn_low": 12.75,
                    "warn_high": 34.5,
                    "alarm_low": 10.5,
                    "alarm_high": 39
                },
                {
                    "step": 3,
                    "setpoint": 22.5,
                    "warn_low": 12.75,
                    "warn_high": 34.5,
                    "alarm_low": 10.5,
                    "alarm_high": 39
                },
                {
                    "step": 4,
                    "setpoint": 22.5,
                    "warn_low": 12.75,
                    "warn_high": 34.5,
                    "alarm_low": 10.5,
                    "alarm_high": 39
                }
            ]
        },
        {
            "key": "element_n_total",
            "zone": "root",
            "engine": "chemistry",
            "label": "Nitrogen (N)",
            "unit": "ppm",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 125,
                    "warn_low": 85,
                    "warn_high": 172.5,
                    "alarm_low": 70,
                    "alarm_high": 195
                },
                {
                    "step": 1,
                    "setpoint": 125,
                    "warn_low": 85,
                    "warn_high": 172.5,
                    "alarm_low": 70,
                    "alarm_high": 195
                },
                {
                    "step": 2,
                    "setpoint": 125,
                    "warn_low": 85,
                    "warn_high": 172.5,
                    "alarm_low": 70,
                    "alarm_high": 195
                },
                {
                    "step": 3,
                    "setpoint": 125,
                    "warn_low": 85,
                    "warn_high": 172.5,
                    "alarm_low": 70,
                    "alarm_high": 195
                },
                {
                    "step": 4,
                    "setpoint": 125,
                    "warn_low": 85,
                    "warn_high": 172.5,
                    "alarm_low": 70,
                    "alarm_high": 195
                }
            ]
        },
        {
            "key": "element_p",
            "zone": "root",
            "engine": "chemistry",
            "label": "Phosphorus (P)",
            "unit": "ppm",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 1,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 2,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 3,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 4,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                }
            ]
        },
        {
            "key": "element_k",
            "zone": "root",
            "engine": "chemistry",
            "label": "Potassium (K)",
            "unit": "ppm",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 185,
                    "warn_low": 127.5,
                    "warn_high": 253,
                    "alarm_low": 105,
                    "alarm_high": 286
                },
                {
                    "step": 1,
                    "setpoint": 185,
                    "warn_low": 127.5,
                    "warn_high": 253,
                    "alarm_low": 105,
                    "alarm_high": 286
                },
                {
                    "step": 2,
                    "setpoint": 185,
                    "warn_low": 127.5,
                    "warn_high": 253,
                    "alarm_low": 105,
                    "alarm_high": 286
                },
                {
                    "step": 3,
                    "setpoint": 185,
                    "warn_low": 127.5,
                    "warn_high": 253,
                    "alarm_low": 105,
                    "alarm_high": 286
                },
                {
                    "step": 4,
                    "setpoint": 185,
                    "warn_low": 127.5,
                    "warn_high": 253,
                    "alarm_low": 105,
                    "alarm_high": 286
                }
            ]
        },
        {
            "key": "element_ca",
            "zone": "root",
            "engine": "chemistry",
            "label": "Calcium (Ca)",
            "unit": "ppm",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 150,
                    "warn_low": 102,
                    "warn_high": 207,
                    "alarm_low": 84,
                    "alarm_high": 234
                },
                {
                    "step": 1,
                    "setpoint": 150,
                    "warn_low": 102,
                    "warn_high": 207,
                    "alarm_low": 84,
                    "alarm_high": 234
                },
                {
                    "step": 2,
                    "setpoint": 150,
                    "warn_low": 102,
                    "warn_high": 207,
                    "alarm_low": 84,
                    "alarm_high": 234
                },
                {
                    "step": 3,
                    "setpoint": 150,
                    "warn_low": 102,
                    "warn_high": 207,
                    "alarm_low": 84,
                    "alarm_high": 234
                },
                {
                    "step": 4,
                    "setpoint": 150,
                    "warn_low": 102,
                    "warn_high": 207,
                    "alarm_low": 84,
                    "alarm_high": 234
                }
            ]
        },
        {
            "key": "element_mg",
            "zone": "root",
            "engine": "chemistry",
            "label": "Magnesium (Mg)",
            "unit": "ppm",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 1,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 2,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 3,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                },
                {
                    "step": 4,
                    "setpoint": 40,
                    "warn_low": 25.5,
                    "warn_high": 57.5,
                    "alarm_low": 21,
                    "alarm_high": 65
                }
            ]
        },
        {
            "key": "element_s",
            "zone": "root",
            "engine": "chemistry",
            "label": "Sulfur (S)",
            "unit": "ppm",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 60,
                    "warn_low": 34,
                    "warn_high": 92,
                    "alarm_low": 28,
                    "alarm_high": 104
                },
                {
                    "step": 1,
                    "setpoint": 60,
                    "warn_low": 34,
                    "warn_high": 92,
                    "alarm_low": 28,
                    "alarm_high": 104
                },
                {
                    "step": 2,
                    "setpoint": 60,
                    "warn_low": 34,
                    "warn_high": 92,
                    "alarm_low": 28,
                    "alarm_high": 104
                },
                {
                    "step": 3,
                    "setpoint": 60,
                    "warn_low": 34,
                    "warn_high": 92,
                    "alarm_low": 28,
                    "alarm_high": 104
                },
                {
                    "step": 4,
                    "setpoint": 60,
                    "warn_low": 34,
                    "warn_high": 92,
                    "alarm_low": 28,
                    "alarm_high": 104
                }
            ]
        },
        {
            "key": "root_zone_temp",
            "zone": "root",
            "engine": "substrate",
            "label": "Root-zone temp",
            "unit": "°C",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 20,
                    "warn_low": 15.3,
                    "warn_high": 25.3,
                    "alarm_low": 12.6,
                    "alarm_high": 28.6
                },
                {
                    "step": 1,
                    "setpoint": 20,
                    "warn_low": 15.3,
                    "warn_high": 25.3,
                    "alarm_low": 12.6,
                    "alarm_high": 28.6
                },
                {
                    "step": 2,
                    "setpoint": 20,
                    "warn_low": 15.3,
                    "warn_high": 25.3,
                    "alarm_low": 12.6,
                    "alarm_high": 28.6
                },
                {
                    "step": 3,
                    "setpoint": 20,
                    "warn_low": 15.3,
                    "warn_high": 25.3,
                    "alarm_low": 12.6,
                    "alarm_high": 28.6
                },
                {
                    "step": 4,
                    "setpoint": 20,
                    "warn_low": 15.3,
                    "warn_high": 25.3,
                    "alarm_low": 12.6,
                    "alarm_high": 28.6
                }
            ]
        },
        {
            "key": "dissolved_oxygen_root",
            "zone": "root",
            "engine": "substrate",
            "label": "Dissolved O₂",
            "unit": "mg/L",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 7,
                    "warn_low": 5.1,
                    "warn_high": 9.2,
                    "alarm_low": 4.2,
                    "alarm_high": 10.4
                },
                {
                    "step": 1,
                    "setpoint": 7,
                    "warn_low": 5.1,
                    "warn_high": 9.2,
                    "alarm_low": 4.2,
                    "alarm_high": 10.4
                },
                {
                    "step": 2,
                    "setpoint": 7,
                    "warn_low": 5.1,
                    "warn_high": 9.2,
                    "alarm_low": 4.2,
                    "alarm_high": 10.4
                },
                {
                    "step": 3,
                    "setpoint": 7,
                    "warn_low": 5.1,
                    "warn_high": 9.2,
                    "alarm_low": 4.2,
                    "alarm_high": 10.4
                },
                {
                    "step": 4,
                    "setpoint": 7,
                    "warn_low": 5.1,
                    "warn_high": 9.2,
                    "alarm_low": 4.2,
                    "alarm_high": 10.4
                }
            ]
        },
        {
            "key": "substrate_moisture",
            "zone": "root",
            "engine": "substrate",
            "label": "Substrate moisture",
            "unit": "%",
            "schedule": [
                {
                    "step": 0,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 1,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 2,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 3,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                },
                {
                    "step": 4,
                    "setpoint": 60,
                    "warn_low": 42.5,
                    "warn_high": 80.5,
                    "alarm_low": 35,
                    "alarm_high": 91
                }
            ]
        }
    ]
}