From 1aa2d9208367a5af11a93f3b66a631d2ea6e633d Mon Sep 17 00:00:00 2001
From: znetsixe <zn375ix3@gmail.com>
Date: Mon, 11 May 2026 17:41:15 +0200
Subject: [PATCH] P11.5 + B2.1/B2.2: per-command units + description (where
 applicable)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds  to scalar setters whose payloads are
plain numbers OR {value, unit}. Skipped where payload is compound or
mode-dependent (control-%, {F, C: [...]}, etc.) — documented inline.
Every command gains a description field for wikiGen consumption.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 src/commands/index.js | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/commands/index.js b/src/commands/index.js
index c80a590..dc615d6 100644
--- a/src/commands/index.js
+++ b/src/commands/index.js
@@ -12,36 +12,44 @@ module.exports = [
     topic: 'data.clock',
     aliases: ['clock'],
     payloadSchema: { type: 'any' },
+    description: 'Push the simulation clock tick (timestamp / dt) to the ASM solver.',
     handler: handlers.dataClock,
   },
   {
     topic: 'data.fluent',
     aliases: ['Fluent'],
     payloadSchema: { type: 'object' },
+    // Compound payload `{F, C: [...]}` — registry-level units normalisation is
+    // skipped (the handler converts per-field internally).
+    description: 'Push the influent stream (payload: {F: flow m3/h, C: [concentrations mg/L]}).',
     handler: handlers.dataFluent,
   },
   {
     topic: 'data.otr',
     aliases: ['OTR'],
     payloadSchema: { type: 'any' },
+    description: 'Push the current oxygen-transfer rate into the reactor.',
     handler: handlers.dataOTR,
   },
   {
     topic: 'data.temperature',
     aliases: ['Temperature'],
     payloadSchema: { type: 'any' },
+    description: 'Push the current reactor temperature.',
     handler: handlers.dataTemperature,
   },
   {
     topic: 'data.dispersion',
     aliases: ['Dispersion'],
     payloadSchema: { type: 'any' },
+    description: 'Push a dispersion/mixing parameter update.',
     handler: handlers.dataDispersion,
   },
   {
     topic: 'child.register',
     aliases: ['registerChild'],
     payloadSchema: { type: 'any' },
+    description: 'Register a child node (settler / measurement) with this reactor.',
     handler: handlers.childRegister,
   },
 ];