feat(commands): unit shorthand + declare units on physical setters; wiki sync

- data.flow: units:{measure,default} -> unit:'m3/h'.
- set.water-height -> unit:'m'; set.header-pressure -> unit:'mbar' (matches the
  domain setters' expected units; no-unit input passes through unchanged).
- Regenerate wiki topic-contract (Unit column).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

diffuser.html

@@ -5,7 +5,7 @@
 <script type="text/javascript">
 RED.nodes.registerType('diffuser', {
   category: 'EVOLV',
-  color: '#86bbdd',
+  color: '#6EB5E5',
   defaults: {
     name: { value: '', required: true },
     number: { value: 1, required: true },
@@ -113,6 +113,7 @@ RED.nodes.registerType('diffuser', {
     <label for="node-input-dbaseOutputFormat"><i class="fa fa-database"></i> Database Output</label>
     <select id="node-input-dbaseOutputFormat" style="width:60%;">
       <option value="influxdb">influxdb</option>
+      <option value="frost">frost</option>
       <option value="json">json</option>
       <option value="csv">csv</option>
     </select>

src/commands/index.js

@@ -12,7 +12,7 @@ module.exports = [
     topic: 'data.flow',
     aliases: ['air_flow'],
     payloadSchema: { type: 'number' },
-    units: { measure: 'volumeFlowRate', default: 'm3/h' },
+    unit: 'm3/h',
     description: 'Push the measured air flow into the diffuser model.',
     handler: handlers.setFlow,
   },
@@ -27,6 +27,7 @@ module.exports = [
     topic: 'set.water-height',
     aliases: ['height_water'],
     payloadSchema: { type: 'number' },
+    unit: 'm',
     description: 'Update the water column height above the diffusers (m).',
     handler: handlers.setWaterHeight,
   },
@@ -34,6 +35,7 @@ module.exports = [
     topic: 'set.header-pressure',
     aliases: ['header_pressure'],
     payloadSchema: { type: 'number' },
+    unit: 'mbar',
     description: 'Update the header (supply) pressure feeding the diffusers (mbar).',
     handler: handlers.setHeaderPressure,
   },

test/README.md

@@ -1,3 +1,11 @@
 # diffuser Test Suite Layout
 
-Placeholder structure (diffuser currently has no runtime module files).
+`test/{basic,integration,edge}/` — standard EVOLV three-tier test
+structure. The diffuser runtime modules live at `src/nodeClass.js`,
+`src/specificClass.js`, and `src/commands/`; they implement the OTR /
+ΔP aeration model and the `data.airFlow` / `set.kla` topic handlers
+documented in `CONTRACT.md`.
+
+Helpers shared across tiers belong in `test/helpers/`.
+
+Run: `node --test test/basic test/integration test/edge`.

wiki/Reference-Contracts.md

@@ -13,16 +13,16 @@
 
 The registry lives in `src/commands/index.js`. Each descriptor maps a canonical `msg.topic` to its handler in `src/commands/handlers.js`; aliases emit a one-time deprecation warning the first time they fire.
 
-<!-- BEGIN AUTOGEN: topic-contract — populate via wiki-gen tool (TODO) -->
+<!-- BEGIN AUTOGEN: topic-contract -->
 
 | Canonical topic | Aliases | Payload | Unit | Effect |
-|:---|:---|:---|:---|:---|
+|---|---|---|---|---|
-| `data.flow` | `air_flow` | `number` | `volumeFlowRate` (default `m3/h`) | Push the measured air flow into the diffuser model. Clamps to &ge; 0 and recomputes OTR. |
+| `data.flow` | `air_flow` | `number` | `volumeFlowRate` (default `m3/h`) | Push the measured air flow into the diffuser model. |
-| `set.density` | `density` | `number` | bottom-coverage % | Update the diffuser bottom-coverage % used as the OTR curve family key. |
+| `set.density` | `density` | `number` | — | Update the air density used in OTR / SOTR calculations. |
-| `set.water-height` | `height_water` | `number` | m | Update the water column height above the diffusers. Clamps to &ge; 0 and recomputes static head + total pressure. |
+| `set.water-height` | `height_water` | `number` | `length` (default `m`) | Update the water column height above the diffusers (m). |
-| `set.header-pressure` | `header_pressure` | `number` | mbar (gauge) | Update the header (supply) pressure above atmospheric. Feeds air-density correction. |
+| `set.header-pressure` | `header_pressure` | `number` | `pressure` (default `mbar`) | Update the header (supply) pressure feeding the diffusers (mbar). |
-| `set.elements` | `elements` | `number` | integer > 0 | Update the count of active diffuser elements. Drives per-element flow and total membrane area. |
+| `set.elements` | `elements` | `number` | — | Update the count of active diffuser elements. |
-| `set.alfa-factor` | `alfaFactor` | `number` | dimensionless (typically 0&ndash;1) | Update the alpha correction used in the kg O₂/h calculation. |
+| `set.alfa-factor` | `alfaFactor` | `number` | — | Update the alfa factor used in oxygen-transfer correction. |
 
 <!-- END AUTOGEN: topic-contract -->