diff --git a/wiki/Reference-Contracts.md b/wiki/Reference-Contracts.md index e47d74f..5bb66a0 100644 --- a/wiki/Reference-Contracts.md +++ b/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. - + | 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 ≥ 0 and recomputes OTR. | -| `set.density` | `density` | `number` | bottom-coverage % | Update the diffuser bottom-coverage % used as the OTR curve family key. | -| `set.water-height` | `height_water` | `number` | m | Update the water column height above the diffusers. Clamps to ≥ 0 and recomputes static head + total pressure. | -| `set.header-pressure` | `header_pressure` | `number` | mbar (gauge) | Update the header (supply) pressure above atmospheric. Feeds air-density correction. | -| `set.elements` | `elements` | `number` | integer > 0 | Update the count of active diffuser elements. Drives per-element flow and total membrane area. | -| `set.alfa-factor` | `alfaFactor` | `number` | dimensionless (typically 0–1) | Update the alpha correction used in the kg O₂/h calculation. | +|---|---|---|---|---| +| `data.flow` | `air_flow` | `number` | `volumeFlowRate` (default `m3/h`) | Push the measured air flow into the diffuser model. | +| `set.density` | `density` | `number` | — | Update the air density used in OTR / SOTR calculations. | +| `set.water-height` | `height_water` | `number` | — | Update the water column height above the diffusers (m). | +| `set.header-pressure` | `header_pressure` | `number` | — | Update the header (supply) pressure feeding the diffusers (mbar). | +| `set.elements` | `elements` | `number` | — | Update the count of active diffuser elements. | +| `set.alfa-factor` | `alfaFactor` | `number` | — | Update the alfa factor used in oxygen-transfer correction. |