governance + unit-self-describing demand + dashboard fixes

Two governance items from the 2026-05-14 quality review:
- test/_output-manifest.md enumerates every Port 0/1/2 key MGC emits, its
  source, type, range, and which tests cover it in populated/degraded states
  (per .claude/rules/output-coverage.md).
- src/control/strategies.js extracts computeEqualFlowDistribution as a pure
  function so the equal-flow algorithm is testable without an MGC fixture.
  test/basic/equalFlowDistribution.basic.test.js (6 tests) covers all three
  demand branches and pins the legacy quirk where the default branch counts
  active machines but iterates priority-ordered first-N (documented in the
  test so the future cleanup is a deliberate change).

Plus rolled-up session work that landed alongside:
- set.demand is now unit-self-describing ({value, unit:'m3/h'|'l/s'|'%'|...}
  or bare number = %); setScaling/scaling.current removed from MGC, commands,
  editor (mgc.html), specificClass.
- _optimalControl + equalFlowControl now compute eta = (Q*dP)/P_shaft rather
  than Q/P, keeping the metric in the same scale as each child's cog.
- groupEfficiency.calcRelativeDistanceFromPeak returns undefined (was 1) when
  pumps are homogeneous (|max-min| < 1e-9). Dashboard treats undefined as
  '-' instead of showing a misleading 100% / 0% reading.
- examples/02-Dashboard.json: auto-init inject so the dashboard populates at
  deploy, NCog formatter normalizes the SUM emitted by MGC by
  machineCountActive, Q-H fanout trims the flat-Q tail so the H axis isn't
  stretched to 40m by curve-envelope clamp points, num/pct treat null AND
  undefined as no-data (closes the +null === 0 trap).
- new test/integration/dashboard-fanout.integration.test.js (17 tests),
  bep-distance-demand-sweep.integration.test.js (3 tests),
  group-bep-cascade.integration.test.js -- total suite now 108/108 green.
- .gitignore: wiki/test.gif (143 MB screen recording, kept locally only).

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

test/basic/commands.basic.test.js

@@ -22,23 +22,33 @@ function makeLogger() {
   };
 }
 
-function makeSource({ name = 'mgc-1', handleInputResult = undefined } = {}) {
+function makeSource({ name = 'mgc-1', handleInputResult = undefined, dt = { flow: { min: 0, max: 100 } } } = {}) {
   const calls = {
     setMode: [],
-    setScaling: [],
     handleInput: [],
     registerChild: [],
+    turnOffAllMachines: 0,
   };
   const source = {
     logger: makeLogger(),
     config: { general: { name } },
     setMode: (m) => calls.setMode.push(m),
-    setScaling: (s) => calls.setScaling.push(s),
     handleInput: async (src, demand) => {
       calls.handleInput.push({ src, demand });
       if (handleInputResult instanceof Error) throw handleInputResult;
       return handleInputResult;
     },
+    // Used by set.demand handler when unit is %: needs dt.flow + interpolation.
+    // With min=0, max=100, the linear interpolation is identity so a bare
+    // numeric demand round-trips through handleInput unchanged.
+    calcDynamicTotals: () => dt,
+    interpolation: {
+      interpolate_lin_single_point: (x, ix, iy, ox, oy) => {
+        if (iy === ix) return ox;
+        return ox + ((x - ix) * (oy - ox)) / (iy - ix);
+      },
+    },
+    turnOffAllMachines: async () => { calls.turnOffAllMachines += 1; },
     childRegistrationUtils: {
       registerChild: (childSource, position) =>
         calls.registerChild.push({ childSource, position }),
@@ -69,14 +79,31 @@ test('canonical topics dispatch to their handlers', async () => {
   await reg.dispatch({ topic: 'set.mode', payload: 'prioritycontrol' }, source, makeCtx());
   assert.deepEqual(calls.setMode, ['prioritycontrol']);
 
-  await reg.dispatch({ topic: 'set.scaling', payload: 'normalized' }, source, makeCtx());
-  assert.deepEqual(calls.setScaling, ['normalized']);
-
+  // bare-number demand → interpreted as % → interpolated against dt.flow.
+  // Default test dt is {min:0,max:100} so % is identity.
   await reg.dispatch({ topic: 'set.demand', payload: '12.5' }, source, makeCtx());
   assert.equal(calls.handleInput.length, 1);
   assert.deepEqual(calls.handleInput[0], { src: 'parent', demand: 12.5 });
 });
 
+test('set.demand with explicit flow unit converts to canonical m³/s', async () => {
+  const { source, calls } = makeSource();
+  const reg = makeRegistry(makeLogger());
+  await reg.dispatch({ topic: 'set.demand', payload: { value: 200, unit: 'm3/h' } }, source, makeCtx());
+  assert.equal(calls.handleInput.length, 1);
+  // 200 m³/h = 0.0555... m³/s
+  assert.ok(Math.abs(calls.handleInput[0].demand - 0.05555555555555556) < 1e-9,
+    `expected ~0.0556 m³/s, got ${calls.handleInput[0].demand}`);
+});
+
+test('set.demand negative value triggers turnOffAllMachines and bypasses handleInput', async () => {
+  const { source, calls } = makeSource();
+  const reg = makeRegistry(makeLogger());
+  await reg.dispatch({ topic: 'set.demand', payload: -1 }, source, makeCtx());
+  assert.equal(calls.turnOffAllMachines, 1);
+  assert.equal(calls.handleInput.length, 0);
+});
+
 test('child.register canonical resolves child via RED.nodes.getNode', async () => {
   const { source, calls } = makeSource();
   const child = { id: 'child-1', source: { tag: 'child-domain' } };
@@ -103,11 +130,6 @@ test('aliases dispatch to the same handler and log a one-time deprecation', asyn
   let warns = ctxLogger.calls.warn.filter((m) => m.includes("'setMode' is deprecated"));
   assert.equal(warns.length, 1, 'setMode deprecation warning should log exactly once');
 
-  await reg.dispatch({ topic: 'setScaling', payload: 'absolute' }, source, makeCtx({ logger: ctxLogger }));
-  warns = ctxLogger.calls.warn.filter((m) => m.includes("'setScaling' is deprecated"));
-  assert.equal(warns.length, 1);
-  assert.deepEqual(calls.setScaling, ['absolute']);
-
   await reg.dispatch({ topic: 'Qd', payload: 5 }, source, makeCtx({ logger: ctxLogger }));
   warns = ctxLogger.calls.warn.filter((m) => m.includes("'Qd' is deprecated"));
   assert.equal(warns.length, 1);