fix: pace inter-tier polling; fix stale package-rename references in docs

mqtt_demo/logger.py

@@ -1,7 +1,7 @@
 """Stdout logging — works correctly under Docker's PYTHONUNBUFFERED=1.
 
 Two logger families share the root handler:
-  * `samsung_appliance` (and its children) for module-level lines —
+  * `mqtt_demo` (and its children) for module-level lines —
     DTLS warnings, generic startup chatter, MQTT plumbing.
   * `<class>.<serial>` for per-appliance bridge lines — e.g.
     `dryer.<serial>`. Each PushBridge gets its own such logger
@@ -58,7 +58,7 @@ _handler.setFormatter(_LevelColourFormatter(
 
 logging.basicConfig(level=logging.INFO, handlers=[_handler], force=True)
 
-logger = logging.getLogger("samsung_appliance")
+logger = logging.getLogger("mqtt_demo")
 
 
 def bridge_logger(klass: str, serial: str | None = None) -> logging.Logger:

mqtt_demo/samples/__init__.py

@@ -1,13 +1,13 @@
 """Appliance descriptors registry.
 
 Adding a new appliance class:
-  1. Write `appliances/<class>.py` with an ApplianceDescriptor named
-     after the class (uppercase, e.g. OVEN).
+  1. Write `mqtt_demo/samples/<class>.py` with an ApplianceDescriptor
+     named after the class (uppercase, e.g. OVEN).
   2. Add it to DESCRIPTORS below.
   3. Set DEVICE_CLASS=<class> in the per-device .env.
 
-main.py imports get_descriptor(name) to look up the descriptor at
-startup; the bridge itself stays class-agnostic.
+mqtt_demo/__main__.py imports get_descriptor(name) to look up the
+descriptor at startup; the bridge itself stays class-agnostic.
 """
 from ..descriptor import ApplianceDescriptor
 from .dryer import DRYER