wirestudio 0.42.2__tar.gz → 0.44.0__tar.gz

{wirestudio-0.42.2/wirestudio.egg-info → wirestudio-0.44.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wirestudio
-Version: 0.42.2
+Version: 0.44.0
 Summary: Agent-driven IoT device design tool that produces ESPHome YAML.
 Author: wirestudio contributors
 License: MIT
@@ -19,6 +19,7 @@ Requires-Dist: httpx>=0.27
 Requires-Dist: slowapi>=0.1.9
 Requires-Dist: mcp<3,>=2.0
 Requires-Dist: websockets>=12
+Requires-Dist: pillow>=10
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: ruff>=0.4; extra == "dev"
@@ -151,8 +152,8 @@ Tiers, in priority order:
 | **Verified** | Subcircuits + building blocks | a component built from discrete parts (five bundled blocks, two H-bridges) expands into the schematic, PCB, BOM, CPL and inventory check; part values are parametric; each block's `verify.checks` rule runs at `validate` with the real params and rails | goldens for every subcircuit example pin YAML + BOM; `component_check` fails a block whose defaults break its own rule (`tests/test_electrical.py`); the schematic and PCB gates cover the expanded parts like any other |
 | **Verified** | Inventory check | cross-check a design's BOM against the drawer (library modules + discrete parts), propose same-package substitutes ranked by pinout, package, rating headroom and stock, accept one or all of them as `part_overrides` that every fab output honours, pick list by location, buy list priced on JLCPCB | matching, substitution and coverage tests in `tests/test_inventory.py` against the real drawer CSV; JLCPCB pricing is mocked and degrades to an unpriced list when the parts API is down |
 | **Verified** | Parametric enclosure | OpenSCAD `.scad` from board mount-hole metadata, built on [YAPP_Box](https://github.com/mrWheel/YAPP_Box): base and lid with standoffs, port cutouts, a ridge and snap joins | every enclosure-capable board renders through real OpenSCAD to a non-empty, manifold (closed, printable) solid, every PR ([gate](.github/workflows/enclosure-render.yml)) |
-| **Works (hardware-validated)** | LoRaWAN target | build RadioLib + LoRaWAN_ESP32 firmware for US915 radio boards, flash over WebSerial, provision against ChirpStack | every radio board's firmware, and designs carrying every component's LoRaWAN block, build in CI ([gate](.github/workflows/lorawan-firmware.yml)); validated end-to-end on a TTGO T-Beam and Heltec WiFi LoRa 32 V2 and V3 against live ChirpStack 4.17 — no automated live-device gate |
-| **Works (hardware-validated)** | LoRaWAN external-component path | emit ESPHome YAML referencing `lorawan-for-esphome`, provision keys into `secrets.yaml`, build through fleet | validated end-to-end on a Heltec WiFi LoRa 32 V4 (SX1262 + external PA): joined, uplinked and decoded against live ChirpStack. Payloads over 11 bytes need the data rate asserted per uplink — US915 DR0 caps at 11 and ADR drives to DR0 on a strong link. No automated live-device gate |
+| **Verified** | LoRaWAN target | build RadioLib + LoRaWAN_ESP32 firmware for US915 radio boards, flash over WebSerial, provision against ChirpStack | every radio board's firmware, and designs carrying every component's LoRaWAN block, build on every PR that touches the target and daily ([gate](.github/workflows/lorawan-firmware.yml)); nightly, the hardware gate asserts a TTGO T-Beam running this firmware is on the bench, logging and seen by ChirpStack within the hour ([gate](docs/workbench.md#the-gate)). Validated end-to-end on a T-Beam and Heltec WiFi LoRa 32 V2 and V3 against live ChirpStack 4.17. The nightly gate does not reflash: each reflash costs a rejoin and a DevNonce |
+| **Verified** | LoRaWAN external-component path | emit ESPHome YAML referencing `lorawan-for-esphome`, provision keys into `secrets.yaml`, build through fleet | the bundled examples that use it pass `esphome config` with the component fetched, every PR ([gate](.github/workflows/esphome-config.yml)); nightly, the hardware gate asserts three boards running it (Heltec WiFi LoRa 32 V4 and V2, TTGO T3) are on the bench, logging and seen by ChirpStack within the hour ([gate](docs/workbench.md#the-gate)). Validated end-to-end on the V4 (SX1262 + external PA): joined, uplinked and decoded against live ChirpStack. Payloads over 11 bytes need the data rate asserted per uplink — US915 DR0 caps at 11 and ADR drives to DR0 on a strong link |
 | **Works (hardware-validated)** | Remote workbench | flash a board on a bench slot, and run the whole LoRaWAN bring-up (flash → register → key push → verify) headlessly | wire format verified against a reference bench; flashing and LoRaWAN bring-up exercised repeatedly on a live Pi bench with an ESP32-S3. Transport tests in `tests/test_workbench.py` use wire-level fakes; no automated live-bench gate |
 | **Verified** | Tasmota target | emit a Tasmota device template (`/tasmota/template`) mapping solved pins to Tasmota GPIO function ids | function ids + per-chip layouts sourced from `tasmota_template.h`; unit tests pin the Sonoff S31 template convention for the smart-plug example |
 | **Verified** | WLED target | emit WLED's `cfg.json` (`/wled/cfg`): LED outputs, buttons, the IR receiver, the relay and the bus pins, the runtime tier a stock release image reads at boot; sensors are usermods, compiled into the pinned release through a generated `platformio_override.ini` (`/wled/compile`, streamed) with their settings in `cfg.json`'s `um` section | keys and type codes sourced from `wled00/const.h` and `cfg.cpp`; goldens pin four examples in `tests/test_wled.py`; the usermod example builds against WLED v0.15.2 on every PR that touches the target and nightly ([gate](.github/workflows/wled-firmware.yml)) |

{wirestudio-0.42.2 → wirestudio-0.44.0}/README.md

@@ -118,8 +118,8 @@ Tiers, in priority order:
 | **Verified** | Subcircuits + building blocks | a component built from discrete parts (five bundled blocks, two H-bridges) expands into the schematic, PCB, BOM, CPL and inventory check; part values are parametric; each block's `verify.checks` rule runs at `validate` with the real params and rails | goldens for every subcircuit example pin YAML + BOM; `component_check` fails a block whose defaults break its own rule (`tests/test_electrical.py`); the schematic and PCB gates cover the expanded parts like any other |
 | **Verified** | Inventory check | cross-check a design's BOM against the drawer (library modules + discrete parts), propose same-package substitutes ranked by pinout, package, rating headroom and stock, accept one or all of them as `part_overrides` that every fab output honours, pick list by location, buy list priced on JLCPCB | matching, substitution and coverage tests in `tests/test_inventory.py` against the real drawer CSV; JLCPCB pricing is mocked and degrades to an unpriced list when the parts API is down |
 | **Verified** | Parametric enclosure | OpenSCAD `.scad` from board mount-hole metadata, built on [YAPP_Box](https://github.com/mrWheel/YAPP_Box): base and lid with standoffs, port cutouts, a ridge and snap joins | every enclosure-capable board renders through real OpenSCAD to a non-empty, manifold (closed, printable) solid, every PR ([gate](.github/workflows/enclosure-render.yml)) |
-| **Works (hardware-validated)** | LoRaWAN target | build RadioLib + LoRaWAN_ESP32 firmware for US915 radio boards, flash over WebSerial, provision against ChirpStack | every radio board's firmware, and designs carrying every component's LoRaWAN block, build in CI ([gate](.github/workflows/lorawan-firmware.yml)); validated end-to-end on a TTGO T-Beam and Heltec WiFi LoRa 32 V2 and V3 against live ChirpStack 4.17 — no automated live-device gate |
-| **Works (hardware-validated)** | LoRaWAN external-component path | emit ESPHome YAML referencing `lorawan-for-esphome`, provision keys into `secrets.yaml`, build through fleet | validated end-to-end on a Heltec WiFi LoRa 32 V4 (SX1262 + external PA): joined, uplinked and decoded against live ChirpStack. Payloads over 11 bytes need the data rate asserted per uplink — US915 DR0 caps at 11 and ADR drives to DR0 on a strong link. No automated live-device gate |
+| **Verified** | LoRaWAN target | build RadioLib + LoRaWAN_ESP32 firmware for US915 radio boards, flash over WebSerial, provision against ChirpStack | every radio board's firmware, and designs carrying every component's LoRaWAN block, build on every PR that touches the target and daily ([gate](.github/workflows/lorawan-firmware.yml)); nightly, the hardware gate asserts a TTGO T-Beam running this firmware is on the bench, logging and seen by ChirpStack within the hour ([gate](docs/workbench.md#the-gate)). Validated end-to-end on a T-Beam and Heltec WiFi LoRa 32 V2 and V3 against live ChirpStack 4.17. The nightly gate does not reflash: each reflash costs a rejoin and a DevNonce |
+| **Verified** | LoRaWAN external-component path | emit ESPHome YAML referencing `lorawan-for-esphome`, provision keys into `secrets.yaml`, build through fleet | the bundled examples that use it pass `esphome config` with the component fetched, every PR ([gate](.github/workflows/esphome-config.yml)); nightly, the hardware gate asserts three boards running it (Heltec WiFi LoRa 32 V4 and V2, TTGO T3) are on the bench, logging and seen by ChirpStack within the hour ([gate](docs/workbench.md#the-gate)). Validated end-to-end on the V4 (SX1262 + external PA): joined, uplinked and decoded against live ChirpStack. Payloads over 11 bytes need the data rate asserted per uplink — US915 DR0 caps at 11 and ADR drives to DR0 on a strong link |
 | **Works (hardware-validated)** | Remote workbench | flash a board on a bench slot, and run the whole LoRaWAN bring-up (flash → register → key push → verify) headlessly | wire format verified against a reference bench; flashing and LoRaWAN bring-up exercised repeatedly on a live Pi bench with an ESP32-S3. Transport tests in `tests/test_workbench.py` use wire-level fakes; no automated live-bench gate |
 | **Verified** | Tasmota target | emit a Tasmota device template (`/tasmota/template`) mapping solved pins to Tasmota GPIO function ids | function ids + per-chip layouts sourced from `tasmota_template.h`; unit tests pin the Sonoff S31 template convention for the smart-plug example |
 | **Verified** | WLED target | emit WLED's `cfg.json` (`/wled/cfg`): LED outputs, buttons, the IR receiver, the relay and the bus pins, the runtime tier a stock release image reads at boot; sensors are usermods, compiled into the pinned release through a generated `platformio_override.ini` (`/wled/compile`, streamed) with their settings in `cfg.json`'s `um` section | keys and type codes sourced from `wled00/const.h` and `cfg.cpp`; goldens pin four examples in `tests/test_wled.py`; the usermod example builds against WLED v0.15.2 on every PR that touches the target and nightly ([gate](.github/workflows/wled-firmware.yml)) |

{wirestudio-0.42.2 → wirestudio-0.44.0}/pyproject.toml

@@ -27,6 +27,7 @@ dependencies = [
     "slowapi>=0.1.9",
     "mcp>=2.0,<3",
     "websockets>=12",
+    "pillow>=10",
 ]
 
 [project.optional-dependencies]

{wirestudio-0.42.2 → wirestudio-0.44.0}/tests/test_codec.py

@@ -1,20 +1,20 @@
 from __future__ import annotations
 
 from wirestudio.library import default_library
+from wirestudio.migrate import migrate
 from wirestudio.model import Design
 from wirestudio.targets.lorawan import codec
 
 
 def _design(board_id: str, **lorawan) -> Design:
-    return Design(
-        schema_version="0.1",
-        id="d",
-        name="D",
-        target="lorawan",
-        lorawan=lorawan,
-        board={"library_id": board_id, "mcu": "esp32"},
-        power={"supply": "usb", "rail_voltage_v": 3.3},
-    )
+    """`lorawan` may carry the retired gps / dht22 / oled blocks, which the
+    migrator turns into components."""
+    return Design.model_validate(migrate({
+        "schema_version": "0.3", "id": "d", "name": "D", "target": "lorawan",
+        "lorawan": lorawan,
+        "board": {"library_id": board_id, "mcu": "esp32"},
+        "power": {"supply": "usb", "rail_voltage_v": 3.3},
+    }).document)
 
 
 def test_builtin_only_layout():

wirestudio-0.44.0/tests/test_community.py

@@ -0,0 +1,191 @@
+"""Community designs: browse and import go through the catalogue's index
+only, and share refuses what the catalogue's CI would."""
+from __future__ import annotations
+
+import io
+import json
+import zipfile
+from pathlib import Path
+
+import pytest
+import yaml
+from fastapi.testclient import TestClient
+
+from wirestudio.api.app import create_app
+
+REPO = "moellere/wirestudio-designs"
+RAW = f"https://raw.githubusercontent.com/{REPO}"
+EXAMPLE = json.loads((Path(__file__).resolve().parent.parent / "wirestudio" / "examples"
+                      / "garage-motion.json").read_text())
+
+
+def _entry(slug, **over):
+    return {"slug": slug, "name": "Porch motion", "author": "octocat", "license": "CC-BY-4.0",
+            "design_url": f"{RAW}/main/designs/{slug}/design.json", **over}
+
+
+@pytest.fixture
+def studio(monkeypatch):
+    monkeypatch.delenv("WIRESTUDIO_DESIGNS_REPO", raising=False)
+    files: dict[str, bytes] = {}
+    fetched: list[str] = []
+
+    async def fetch(url):
+        fetched.append(url)
+        if url not in files:
+            raise RuntimeError(f"404 {url}")
+        return files[url]
+
+    def publish(*entries, designs=None):
+        files[f"{RAW}/index/index.json"] = json.dumps(
+            {"version": 1, "generated": "2026-10-23T00:00:00+00:00", "designs": list(entries)}).encode()
+        for slug, doc in (designs or {}).items():
+            files[f"{RAW}/main/designs/{slug}/design.json"] = json.dumps(doc).encode()
+
+    app = TestClient(create_app(community_fetch=fetch))
+    return app, publish, fetched
+
+
+def test_status_names_the_catalogue(studio):
+    app, _, _ = studio
+    s = app.get("/community/status").json()
+    assert s["enabled"] and s["repo"] == REPO
+    assert s["upload_url"] == f"https://github.com/{REPO}/upload/main/designs"
+
+
+def test_empty_repo_setting_turns_it_off(studio, monkeypatch):
+    app, _, _ = studio
+    monkeypatch.setenv("WIRESTUDIO_DESIGNS_REPO", "")
+    assert app.get("/community/status").json() == {"enabled": False}
+    assert app.get("/community/designs").status_code == 503
+
+
+def test_browse_lists_the_index_and_caches_it(studio):
+    app, publish, fetched = studio
+    publish(_entry("porch-motion"))
+    assert [d["slug"] for d in app.get("/community/designs").json()["designs"]] == ["porch-motion"]
+    app.get("/community/designs")
+    assert fetched.count(f"{RAW}/index/index.json") == 1
+
+
+def test_an_unreachable_index_is_a_502(studio):
+    app, _, _ = studio
+    r = app.get("/community/designs")
+    assert r.status_code == 502 and "index unavailable" in r.json()["detail"]
+
+
+def test_import_stamps_the_origin(studio):
+    app, publish, _ = studio
+    publish(_entry("porch-motion"), designs={"porch-motion": {**EXAMPLE, "id": "porch-motion"}})
+    body = app.get("/community/designs/porch-motion").json()
+    assert body["design"]["origin"] == {"catalogue": REPO, "slug": "porch-motion",
+                                        "author": "octocat", "license": "CC-BY-4.0"}
+    assert app.post("/design/validate", json=body["design"]).status_code == 200
+
+
+def test_import_only_follows_urls_inside_the_catalogue(studio):
+    app, publish, fetched = studio
+    publish(_entry("evil", design_url="http://169.254.169.254/latest/meta-data"))
+    assert app.get("/community/designs/evil").status_code == 502
+    assert not any("169.254" in u for u in fetched)
+
+
+def test_import_of_an_unknown_slug_is_a_404(studio):
+    app, publish, _ = studio
+    publish()
+    assert app.get("/community/designs/nope").status_code == 404
+
+
+def _share(app, **over):
+    body = {"design": {**EXAMPLE, "id": "Porch Motion v2"}, "author": "@octocat", "tags": ["motion"], **over}
+    return app.post("/community/share", json=body)
+
+
+def test_share_packs_the_folder_the_catalogue_expects(studio):
+    app, _, _ = studio
+    r = _share(app, notes="Built on a DevKitC.")
+    assert r.status_code == 200 and r.headers["content-type"] == "application/zip"
+    z = zipfile.ZipFile(io.BytesIO(r.content))
+    assert sorted(z.namelist()) == ["porch-motion-v2/README.md", "porch-motion-v2/design.json",
+                                    "porch-motion-v2/meta.yaml"]
+    assert json.loads(z.read("porch-motion-v2/design.json"))["id"] == "porch-motion-v2"
+    assert yaml.safe_load(z.read("porch-motion-v2/meta.yaml")) == {"author": "octocat", "tags": ["motion"]}
+
+
+def test_share_credits_the_design_it_was_imported_from(studio):
+    app, _, _ = studio
+    origin = {"catalogue": REPO, "slug": "porch-motion", "author": "someone", "license": "CC-BY-4.0"}
+    r = _share(app, design={**EXAMPLE, "id": "porch-motion-v2", "origin": origin})
+    z = zipfile.ZipFile(io.BytesIO(r.content))
+    assert yaml.safe_load(z.read("porch-motion-v2/meta.yaml"))["derived_from"] == "porch-motion"
+    assert "origin" not in json.loads(z.read("porch-motion-v2/design.json"))
+
+
+def test_resharing_your_own_design_does_not_derive_from_itself(studio):
+    app, _, _ = studio
+    origin = {"catalogue": REPO, "slug": "porch-motion", "author": "octocat", "license": "CC-BY-4.0"}
+    r = _share(app, design={**EXAMPLE, "id": "porch-motion", "origin": origin})
+    z = zipfile.ZipFile(io.BytesIO(r.content))
+    assert "derived_from" not in yaml.safe_load(z.read("porch-motion/meta.yaml"))
+
+
+def test_share_refuses_a_literal_credential(studio):
+    app, _, _ = studio
+    design = json.loads(json.dumps(EXAMPLE))
+    design["fleet"]["secrets_ref"]["wifi_password"] = "hunter22"
+    r = _share(app, design=design)
+    assert r.status_code == 422 and "fleet.secrets_ref.wifi_password" in r.json()["detail"]
+
+
+@pytest.mark.parametrize("over, match", [
+    ({"author": "not a handle"}, "GitHub handle"),
+    ({"tags": ["Has Space"]}, "tags"),
+    ({"slug": "Bad_Slug"}, "not a usable name"),
+])
+def test_share_refuses_what_the_catalogue_would(studio, over, match):
+    app, _, _ = studio
+    r = _share(app, **over)
+    assert r.status_code == 422 and match in r.json()["detail"]
+
+
+def _jpeg(size=(3000, 2000), exif=True, fmt="JPEG") -> str:
+    import base64
+
+    from PIL import Image
+
+    img = Image.new("RGB", size, (200, 80, 40))
+    kwargs = {}
+    if exif:
+        e = Image.Exif()
+        e[0x010F] = "PhoneMaker"
+        e[0x0112] = 6  # Orientation: rotate 90 CW on display
+        kwargs["exif"] = e
+    buf = io.BytesIO()
+    img.save(buf, fmt, **kwargs)
+    return base64.b64encode(buf.getvalue()).decode()
+
+
+def test_share_re_encodes_photos_without_metadata(studio):
+    from PIL import Image
+
+    app, _, _ = studio
+    r = _share(app, photos=[{"name": "IMG_0042.JPG", "data": _jpeg()},
+                            {"name": "IMG_0042.JPG", "data": _jpeg(fmt="PNG", exif=False)}])
+    assert r.status_code == 200, r.text
+    z = zipfile.ZipFile(io.BytesIO(r.content))
+    names = sorted(n for n in z.namelist() if "/photos/" in n)
+    assert names == ["porch-motion-v2/photos/img-0042-2.jpg", "porch-motion-v2/photos/img-0042.jpg"]
+    with Image.open(io.BytesIO(z.read("porch-motion-v2/photos/img-0042.jpg"))) as img:
+        assert img.format == "JPEG" and not img.getexif()
+        assert img.size == (1365, 2048), "the EXIF rotation is applied before EXIF is dropped"
+    assert all(z.getinfo(n).file_size <= 1024 * 1024 for n in names)
+
+
+def test_share_refuses_what_is_not_a_photo(studio):
+    import base64
+
+    app, _, _ = studio
+    r = _share(app, photos=[{"name": "notes.txt", "data": base64.b64encode(b"hello").decode()}])
+    assert r.status_code == 422 and "not a readable image" in r.json()["detail"]
+    r = _share(app, photos=[{"name": f"p{i}.jpg", "data": _jpeg((10, 10))} for i in range(5)])
+    assert r.status_code == 422 and "at most 4" in r.json()["detail"]

{wirestudio-0.42.2 → wirestudio-0.44.0}/tests/test_firmware_gen.py

@@ -5,28 +5,28 @@ from pathlib import Path
 import pytest
 
 from wirestudio.library import default_library
+from wirestudio.migrate import migrate
 from wirestudio.model import Design
 from wirestudio.targets.lorawan.firmware_gen import generate_firmware, write_firmware
 
 
 def _design(board_id: str, **lorawan) -> Design:
-    kw = {}
+    """A 0.3 design; `lorawan` may carry the retired gps / dht22 / oled
+    blocks, which the migrator turns into components."""
+    raw = {
+        "schema_version": "0.3", "id": "dev1", "name": "Dev 1",
+        "board": {"library_id": board_id, "mcu": "esp32"},
+        "power": {"supply": "usb", "rail_voltage_v": 3.3},
+    }
     if lorawan:
-        kw["target"] = "lorawan"
-        kw["lorawan"] = lorawan
-    return Design(
-        schema_version="0.1",
-        id="dev1",
-        name="Dev 1",
-        board={"library_id": board_id, "mcu": "esp32"},
-        power={"supply": "usb", "rail_voltage_v": 3.3},
-        **kw,
-    )
+        raw["target"] = "lorawan"
+        raw["lorawan"] = lorawan
+    return Design.model_validate(migrate(raw).document)
 
 
 def _design_with(*library_ids: str) -> Design:
     return Design.model_validate({
-        "schema_version": "0.3", "id": "dev1", "name": "Dev 1", "target": "lorawan", "lorawan": {},
+        "schema_version": "1.0", "id": "dev1", "name": "Dev 1", "target": "lorawan", "lorawan": {},
         "board": {"library_id": "ttgo-lora32-v2", "mcu": "esp32"},
         "power": {"supply": "usb", "rail_voltage_v": 3.3},
         "components": [{"id": cid, "library_id": cid, "label": cid, "params": {}} for cid in library_ids],
@@ -180,7 +180,7 @@ def test_lorawan_matches_golden(lib):
 
 
 def test_synthesized_dht_emits_its_configured_pin(lib):
-    """A DHT requested via `lorawan.dht22` has no wiring, so the render
+    """A DHT from a retired `lorawan.dht22` block has no wiring, so the render
     context sets `pin` to None. Jinja's `default()` only fires on *undefined*,
     so the old template fell through to a literal "None" in the C++."""
     src = generate_firmware(

{wirestudio-0.42.2 → wirestudio-0.44.0}/tests/test_hardware_gate.py

@@ -258,13 +258,25 @@ def test_an_off_bench_device_without_a_dev_eui_is_rejected(tmp_path):
 
 
 class FlashBench(FakeBench):
-    """Records writes; after one, the slot prints what `boot_lines` scripts
-    for the framework whose image was written last."""
+    """Records writes. Like the real bench, the boot that follows a write
+    goes unrecorded; a reset afterwards prints what `boot_lines` scripts
+    for the framework written last."""
 
     def __init__(self, slots, boot_lines, fail_write=False):
         super().__init__(slots)
         self.boot_lines, self.fail_write = boot_lines, fail_write
         self.writes: list[dict] = []
+        self.resets: list[str] = []
+        self._written: dict[str, str] = {}
+
+    async def slot(self, label):
+        return next(s for s in self._slots if s.label == label)
+
+    async def reset(self, slot):
+        self.resets.append(slot)
+        self._lines[slot] = [{"ts": time.time(), "text": t}
+                             for t in self.boot_lines.get(self._written.get(slot, ""), [])]
+        return {"ok": True}
 
     async def flash(self, slot, images, chip="esp32", erase=False, baud=921600):
         from wirestudio.workbench import WorkbenchUnavailable
@@ -272,8 +284,8 @@ class FlashBench(FakeBench):
         if self.fail_write:
             raise WorkbenchUnavailable("flash failed: A fatal error occurred: No serial data received.")
         self.writes.append({"slot": slot, "images": images, "chip": chip, "erase": erase})
-        self._lines[slot] = [{"ts": time.time(), "text": t}
-                             for t in self.boot_lines.get(images[0][1].decode(), [])]
+        self._written[slot] = images[0][1].decode()
+        self._lines[slot] = []
         yield {"type": "log", "data": "Hash of data verified."}
         yield {"type": "done", "ok": True, "slot": slot, "returncode": 0}
 
@@ -298,7 +310,6 @@ def fake_images(monkeypatch):
 
 
 FLASH_CONFIG = {
-    "boot_capture_s": 0,
     "devices": [{"slot": "SLOT2", "name": "spare S3", "board": "esp32-s3-devkitc-1",
                  "flash": ["esphome", "micropython", "circuitpython"]}],
 }
@@ -307,7 +318,7 @@ BOOTS = {
     "esphome": ["[I][app:117]: setup() finished successfully!"],
     "micropython": ["MicroPython v1.26.1 on 2025-09-11; Generic ESP32S3 module with ESP32S3"],
     "circuitpython": ["Adafruit CircuitPython 10.3.1 on 2026-09-14; Espressif ESP32 DevKitc V4 WROOM-32E with ESP32"],
-    "meshtastic": ["INFO  | ??:??:?? 0 Booting Meshtastic"],
+    "meshtastic": ["INFO  | ??:??:?? 0 Booted, wake cause 0 (boot count 1), reset_reason=reset"],
 }
 
 
@@ -331,18 +342,22 @@ async def test_a_flash_device_skips_the_serial_stage(fake_images):
     assert not [r for r in report.rows if r[0] == "serial"]
 
 
-async def test_a_framework_without_a_marker_fails_with_what_it_printed(fake_images):
-    """Passing it would claim a verdict nobody established; the captured
-    output is what establishes one."""
+async def test_boot_is_read_from_a_reset_after_each_write(fake_images):
+    """covbench, 2026-10-23: the boot esptool triggers is never recorded,
+    so without a reset ESPHome failed on a healthy board."""
     report = gate.Report()
-    bench = FlashBench([FakeSlot("SLOT3", chip="esp32s3")], BOOTS)
-    cfg = {"boot_capture_s": 0, "devices": [
-        {"slot": "SLOT3", "board": "heltec-wifi-lora32-v3", "flash": ["meshtastic"]}]}
-    await gate.run(cfg, report, client=bench)
+    bench = FlashBench([FakeSlot("SLOT2", chip="esp32s3")], BOOTS)
+    await gate.run(FLASH_CONFIG, report, client=bench)
+    assert bench.resets == ["SLOT2"] * 3
 
-    row = next(r for r in report.rows if r[:2] == ("boot", "SLOT3/meshtastic"))
-    assert row[2] is False
-    assert "Booting Meshtastic" in row[3]
+
+async def test_meshtastic_boots_on_its_marker(fake_images):
+    report = gate.Report()
+    bench = FlashBench([FakeSlot("SLOT3", chip="esp32")], BOOTS)
+    cfg = {"devices": [
+        {"slot": "SLOT3", "board": "ttgo-lora32-v2", "flash": ["meshtastic"]}]}
+    await gate.run(cfg, report, client=bench)
+    assert ("boot", "SLOT3/meshtastic", True) in [r[:3] for r in report.rows]
 
 
 async def test_circuitpython_boots_on_its_banner(fake_images):

{wirestudio-0.42.2 → wirestudio-0.44.0}/tests/test_lorawan_api.py

@@ -57,15 +57,14 @@ def client() -> TestClient:
 
 
 def _design(board_id: str, **lorawan) -> dict:
-    return Design(
-        schema_version="0.1",
-        id="d",
-        name="D",
-        target="lorawan",
-        lorawan=lorawan,
-        board={"library_id": board_id, "mcu": "esp32"},
-        power={"supply": "usb", "rail_voltage_v": 3.3},
-    ).model_dump(mode="json", exclude_none=True)
+    """A 0.3 request body; `lorawan` may carry the retired gps / dht22 / oled
+    blocks, which the endpoints migrate into components."""
+    return {
+        "schema_version": "0.3", "id": "d", "name": "D", "target": "lorawan",
+        "lorawan": lorawan,
+        "board": {"library_id": board_id, "mcu": "esp32"},
+        "power": {"supply": "usb", "rail_voltage_v": 3.3},
+    }
 
 
 def _seed_cache(tmp_path, design: dict, *, bin_bytes=b"FAKEBIN", log="cached log") -> str:
@@ -305,7 +304,7 @@ def test_provision_esphome_uses_esphome_profile_naming(client, monkeypatch):
     assert fake.provisioned["device_profile_name"] == "wirestudio-esphome-us915-sub2"
     # Codec is None on the new path -- the decoder is generated from
     # design.lorawan.payload by a follow-up endpoint, not by the standalone
-    # codec.py (which knows only gps/dht22/oled).
+    # codec.py (which packs the standalone path's components).
     assert fake.provisioned["codec"] is None
 
 

wirestudio-0.42.2/tests/test_lorawan_lower.py → wirestudio-0.44.0/tests/test_lorawan_sugar_migration.py

@@ -1,17 +1,18 @@
-"""`lorawan.gps` / `dht22` / `oled` are sugar for a component, a bus and a
-few connections. Lowering them is what every reader of a standalone design
-does first, so a design written either way produces the same firmware,
-payload and profile name."""
+"""`lorawan.gps` / `dht22` / `oled` were sugar for a component, a bus and a
+few connections. The 1.0 model drops them; the migrator rewrites a document
+that still carries them into the components they stood for, so a design
+written either way produces the same firmware, payload and profile name."""
 from __future__ import annotations
 
 import pytest
+from pydantic import ValidationError
 
 from wirestudio.library import default_library
+from wirestudio.migrate import CURRENT_SCHEMA_VERSION, _lower_lorawan_sugar, migrate
 from wirestudio.model import Design
 from wirestudio.targets import get_target
 from wirestudio.targets.lorawan.codec import fields_for, generate_codec, profile_name
 from wirestudio.targets.lorawan.firmware_gen import generate_firmware
-from wirestudio.targets.lorawan.lower import lower_lorawan_sugar, sugar_in_use
 
 
 @pytest.fixture
@@ -19,14 +20,18 @@ def lib():
     return default_library()
 
 
-def _design(board_id: str, *, lorawan: dict | None = None, **extra) -> Design:
-    return Design.model_validate({
-        "schema_version": "0.1", "id": "d", "name": "D", "target": "lorawan",
+def _raw(board_id: str, *, lorawan: dict | None = None, version: str = "0.3", **extra) -> dict:
+    return {
+        "schema_version": version, "id": "d", "name": "D", "target": "lorawan",
         "lorawan": lorawan if lorawan is not None else {},
         "board": {"library_id": board_id, "mcu": "esp32"},
         "power": {"supply": "usb", "rail_voltage_v": 3.3},
         **extra,
-    })
+    }
+
+
+def _design(board_id: str, **kw) -> Design:
+    return Design.model_validate(migrate(_raw(board_id, **kw)).document)
 
 
 SUGAR = {"gps": {"rx_pin": "GPIO23", "tx_pin": "GPIO17"}, "dht22": {"pin": "GPIO13"}, "oled": {}}
@@ -59,12 +64,13 @@ EXPLICIT = {
 }
 
 
-def test_lowering_is_the_explicit_design(lib):
-    lowered = lower_lorawan_sugar(_design("heltec-wifi-lora32-v3", lorawan=SUGAR), lib)
-    explicit = _design("heltec-wifi-lora32-v3", **EXPLICIT)
-    dump = lambda d: d.model_dump(mode="json", exclude={"lorawan"})  # noqa: E731
-    assert dump(lowered) == dump(explicit)
-    assert sugar_in_use(lowered) == []
+def test_the_blocks_become_the_explicit_design():
+    result = migrate(_raw("heltec-wifi-lora32-v3", lorawan=SUGAR))
+    assert result.applied == ["retire_lorawan_sugar"]
+    assert result.to_version == CURRENT_SCHEMA_VERSION == "1.0"
+    doc = result.document
+    assert {k: doc[k] for k in ("components", "buses", "connections")} == EXPLICIT
+    assert doc["lorawan"] == {}
 
 
 def test_sugar_and_explicit_designs_generate_the_same_artifacts(lib):
@@ -78,12 +84,22 @@ def test_sugar_and_explicit_designs_generate_the_same_artifacts(lib):
     assert {"lat", "lon", "temp_c", "humidity", "batt_mv"} <= set(names)
 
 
-def test_lowering_leaves_the_input_alone_and_is_idempotent(lib):
-    design = _design("heltec-wifi-lora32-v3", lorawan=SUGAR)
-    lowered = lower_lorawan_sugar(design, lib)
-    assert design.lorawan.gps is not None and design.components == []
-    assert lower_lorawan_sugar(lowered, lib) is lowered
-    assert lower_lorawan_sugar(_design("heltec-wifi-lora32-v3"), lib) is not lowered
+def test_migration_leaves_the_input_alone_and_is_idempotent(lib):
+    raw = _raw("heltec-wifi-lora32-v3", lorawan=SUGAR)
+    doc = migrate(raw).document
+    assert raw["lorawan"]["gps"] and "components" not in raw
+    assert _lower_lorawan_sugar(doc, lib) is doc
+    assert migrate(doc).document is doc
+
+
+def test_a_0_3_design_without_the_blocks_only_changes_its_version():
+    raw = _raw("heltec-wifi-lora32-v3", lorawan={"region": "EU868"})
+    assert migrate(raw).document == {**raw, "schema_version": "1.0"}
+
+
+def test_the_1_0_model_refuses_the_blocks():
+    with pytest.raises(ValidationError, match="gps"):
+        Design.model_validate(_raw("heltec-wifi-lora32-v3", lorawan=SUGAR, version="1.0"))
 
 
 def test_a_block_whose_component_is_already_placed_is_dropped(lib):
@@ -93,54 +109,32 @@ def test_a_block_whose_component_is_already_placed_is_dropped(lib):
         connections=[{"component_id": "env", "pin_role": "DATA",
                       "target": {"kind": "gpio", "pin": "GPIO4"}}],
     )
-    lowered = lower_lorawan_sugar(design, lib)
-    assert [c.id for c in lowered.components] == ["env"]
-    assert lowered.lorawan.dht22 is None
+    assert [c.id for c in design.components] == ["env"]
     assert "DHT dht(4, DHT22);" in generate_firmware(design, lib)["src/main.cpp"]
 
 
-def test_ids_do_not_collide_with_what_the_design_has(lib):
+def test_ids_do_not_collide_with_what_the_design_has():
     design = _design(
         "heltec-wifi-lora32-v3", lorawan={"gps": {"rx_pin": "GPIO23", "tx_pin": "GPIO17"}},
         components=[{"id": "gps", "library_id": "gpio_input", "label": "Button", "params": {}}],
         buses=[{"id": "gps_uart", "type": "uart", "rx": "GPIO3", "tx": "GPIO1"}],
     )
-    lowered = lower_lorawan_sugar(design, lib)
-    gps = next(c for c in lowered.components if c.library_id == "uart_gps")
+    gps = next(c for c in design.components if c.library_id == "uart_gps")
     assert gps.id == "gps2"
-    assert {b.id for b in lowered.buses} == {"gps_uart", "gps_uart2"}
+    assert {b.id for b in design.buses} == {"gps_uart", "gps_uart2"}
 
 
 def test_onboard_gps_stays_synthesized_without_sugar(lib):
     """The T-Beam's GPS comes from the board file, not from a block; the
     golden firmware for it does not move."""
     design = _design("ttgo-t-beam")
-    assert lower_lorawan_sugar(design, lib) is design
+    assert design.components == []
     assert "GPSSerial.begin(9600, SERIAL_8N1, 34, 12)" in generate_firmware(design, lib)["src/main.cpp"]
 
 
-def test_oled_disabled_is_no_oled(lib):
-    design = _design("heltec-wifi-lora32-v3", lorawan={"oled": {"enabled": False}})
-    assert lower_lorawan_sugar(design, lib).components == []
-
+def test_oled_disabled_is_no_oled():
+    assert _design("heltec-wifi-lora32-v3", lorawan={"oled": {"enabled": False}}).components == []
 
-def test_validate_names_each_lowered_block(lib):
-    warnings = get_target("lorawan").validate(_design("heltec-wifi-lora32-v3", lorawan=SUGAR), lib)
-    lowered = [w for w in warnings if w.code == "lorawan_sugar_lowered"]
-    assert [w.level for w in lowered] == ["info"] * 3
-    assert all(f"lorawan.{f}" in w.text for f, w in zip(("gps", "dht22", "oled"), lowered))
-    assert get_target("lorawan").validate(_design("heltec-wifi-lora32-v3", **EXPLICIT), lib) == []
 
-
-def test_console_uart_check_reads_the_bus_either_way(lib):
-    on_console = {"gps": {"rx_pin": "GPIO3", "tx_pin": "GPIO1"}}
-    codes = {w.code for w in get_target("lorawan").validate(
-        _design("heltec-wifi-lora32-v2", lorawan=on_console), lib)}
-    assert "lorawan_gps_on_console_uart" in codes
-    explicit = _design(
-        "heltec-wifi-lora32-v2",
-        components=[{"id": "gnss", "library_id": "uart_gps", "label": "GNSS", "params": {}}],
-        buses=[{"id": "u", "type": "uart", "rx": "GPIO3", "tx": "GPIO1"}],
-        connections=[{"component_id": "gnss", "pin_role": "TX", "target": {"kind": "bus", "bus_id": "u"}}],
-    )
-    assert "lorawan_gps_on_console_uart" in {w.code for w in get_target("lorawan").validate(explicit, lib)}
+def test_the_migrated_design_validates_clean(lib):
+    assert get_target("lorawan").validate(_design("heltec-wifi-lora32-v3", lorawan=SUGAR), lib) == []

{wirestudio-0.42.2 → wirestudio-0.44.0}/tests/test_mcp_client.py

@@ -20,7 +20,7 @@ pytestmark = pytest.mark.anyio
 
 TOKEN = "ci-token"
 DESIGN = {
-    "schema_version": "0.3",
+    "schema_version": "1.0",
     "id": "ci-bench",
     "name": "CI bench",
     "board": {"library_id": "esp32-devkitc-v4", "mcu": "esp32", "framework": "arduino"},