EVOLV/.agents/function-anchors/monster/ANCHOR-monster.md

Monster Function Anchor (Baseline)

0) Connection Map (At a Glance)

• Node type: monster (nodes/monster/monster.js:1, nodes/monster/monster.html:5)
• Consumes control/input topics: input_q, i_start, monsternametijden, rain_data, registerChild (nodes/monster/src/nodeClass.js:202)
• Publishes periodic outputs:
  • Output 0: process payload (nodes/monster/src/nodeClass.js:185)
  • Output 1: influx payload (nodes/monster/src/nodeClass.js:186)
  • Output 2: parent registration (registerChild) (nodes/monster/src/nodeClass.js:158)
• Cross-node integrations:
  • Accepts measurement children of type flow (nodes/monster/src/specificClass.js:300)
  • Common external orchestration pattern around this node:
    • Open-Meteo -> rain_data
    • Aquon schedule feed -> monsternametijden
    • PLC/MQTT pulse sink fed by output.pulse
    • Z-Info/report tooling fed by m3Total + m3PerPuls
    • Dashboard API/Grafana and Influx consumers
• Admin/UI endpoints:
  • GET /monster/menu.js
  • GET /monster/configData.js (nodes/monster/monster.js:17, nodes/monster/monster.js:27)

1) Unit Table (Always First Data Section)

Signal/Field	Represents	Asset Type	Default Unit	Source of Truth	Produced By	Consumed By	Fallback/Degraded Behavior
input_q.payload.value	influent flow command	manual/control input	m3/h (normalized in wrapper)	nodes/monster/src/nodeClass.js:216	upstream control flow	sampling calculation loop	invalid/unit conversion failure is warned and ignored
flow.measured.*	measured flow from child sensors	measurement child	m3/h	nodes/monster/src/specificClass.js:300	measurement nodes	effective flow selection	if missing, manual flow or 0 is used
q	effective flow used by model	derived	m3/h	nodes/monster/src/specificClass.js:775	tick()	pulse and volume progression	defaults to 0 if no measured/manual flow
m3PerPuls	reporting conversion factor for sampler pulse	derived/report field	m3/pulse	nodes/monster/src/specificClass.js:660	sampling_program()	Z-Info/report tooling, operations	0 when not running
m3Total	accumulated volume during active run	derived/report field	m3	nodes/monster/src/specificClass.js:687	sampling_program()	Z-Info/report tooling	reset to 0 when sampling window ends
pulse	pulse command signal	control output	boolean	nodes/monster/src/specificClass.js:707	sampling_program()	PLC/MQTT pulse output paths	forced false under cooldown/capacity/end-of-run
bucketVol	sampled bucket fill volume	derived/state	L	nodes/monster/src/specificClass.js:712	pulse accumulation	dashboard/operator checks	reset to 0 after run
predictedRateM3h	rain-scaled prediction reference	derived	m3/h	nodes/monster/src/specificClass.js:367	getOutput()	dashboards/diagnostics	falls back to measured/manual effective rate

2) Class Identity

• Runtime registration + endpoints: nodes/monster/monster.js
• Node-RED wrapper/routing: nodes/monster/src/nodeClass.js
• Domain sampling logic: nodes/monster/src/specificClass.js
• Editor UI/defaults: nodes/monster/monster.html
• Default config schema: nodes/generalFunctions/src/configs/monster.json

3) Configuration Contract (Key)

UI Field	Runtime Path	Default	Behavior Impact	Source
samplingtime	constraints.samplingtime	0	sampling window hours	nodes/monster/monster.html:16, nodes/monster/src/nodeClass.js:68
minvolume	constraints.minVolume	5	min valid sample volume	nodes/monster/monster.html:17, nodes/monster/src/nodeClass.js:69
maxweight	constraints.maxWeight	22	max bucket load before invalid sample	nodes/monster/monster.html:18, nodes/monster/src/nodeClass.js:70
nominalFlowMin / flowMax	constraints.nominalFlowMin / constraints.flowMax	0 / 0	prediction bounds and start guard	nodes/monster/monster.html:19, nodes/monster/src/specificClass.js:226
minSampleIntervalSec	constraints.minSampleIntervalSec	60	pulse cooldown protection	nodes/monster/monster.html:22, nodes/monster/src/specificClass.js:693
emptyWeightBucket	asset.emptyWeightBucket	3	max bucket volume derivation	nodes/monster/monster.html:23, nodes/monster/src/specificClass.js:378
aquon_sample_name	aquonSampleName	"112100" internal default	schedule selector key	nodes/monster/monster.html:24, nodes/monster/src/nodeClass.js:96

4) I/O and Integration Notes

• Node-level output is process/influx/parent only.
• External APIs are normally handled by surrounding flows, not by the node class itself.
• Report tooling integration should read from process payload fields:
  • m3Total
  • m3PerPuls
  • running
  • pulse
• Reference examples:
  • dashboard baseline: nodes/monster/examples/monster-dashboard.flow.json
  • full API + dashboard template: nodes/monster/examples/monster-api-dashboard.flow.json

5) Current Gaps / Risks

1. Wrapper exposes topics (setMode, execSequence, execMovement, flowMovement, emergencystop) that are not implemented in Monster.handleInput contract.
2. showWorkingCurves/CoG routes in wrapper call methods that are not present in Monster.
3. Existing legacy tests were not organized in required basic/integration/edge folders before this update.
4. External API credentials/tokens must remain outside committed example flows.

6) Test Evidence Matrix (Current Baseline)

Test file	What is covered	Methods/contracts anchored
nodes/monster/test/basic/constructor.basic.test.js	constructor + output field contract	constructor, set_boundries_and_targets, getOutput
nodes/monster/test/integration/flow-and-schedule.integration.test.js	flow averaging, rain/schedule ingestion	registerChild, handleInput, tick, updateRainData, regNextDate
nodes/monster/test/edge/sampling-guards.edge.test.js	invalid-bound guard + cooldown behavior	validateFlowBounds, sampling_program, cooldown gate

7) Change Checklist

• When monster behavior changes, update:
  • nodes/monster/src/nodeClass.js
  • nodes/monster/src/specificClass.js
  • nodes/monster/monster.html
  • nodes/monster/test/basic|integration|edge/*
  • .agents/function-anchors/monster/ANCHOR-monster.md
  • .agents/function-anchors/monster/ANCHOR-monster.html
  • .agents/function-anchors/monster/EVIDENCE-monster-tests.md