valveGroupControl/CLAUDE.md

valveGroupControl — Claude Code context

Coordinates multiple valve children. Part of the EVOLV wastewater-automation platform.

S88 classification

Level	Colour	Placement lane
Unit	#50a8d9	L4

Flow layout rules

When wiring this node into a multi-node demo or production flow, follow the placement rule set in the EVOLV superproject:

.claude/rules/node-red-flow-layout.md (in the EVOLV repo root)

Key points for this node:

• Place on lane L4 (x-position per the lane table in the rule).
• Stack same-level siblings vertically.
• Parent/children sit on adjacent lanes (children one lane left, parent one lane right).
• Wrap in a Node-RED group box coloured #50a8d9 (Unit).

Folder & File Layout

Every per-node file MUST use the folder name (valveGroupControl) exactly, case-sensitive. Full rule: .claude/rules/node-architecture.md in the EVOLV superproject.

Path	Required name
Entry file	valveGroupControl.js
Editor HTML	valveGroupControl.html
Node adapter	src/nodeClass.js
Domain logic	src/specificClass.js
Editor JS modules	src/editor/*.js (extract when inline editor JS exceeds ~50 lines)
Tests	test/{basic,integration,edge}/*.test.js
Example flows	examples/*.flow.json

⚠️ Legacy naming drift in this repo — to be renamed when the file is next touched:

Path	Currently	Should be
Entry file	vgc.js	valveGroupControl.js
Editor HTML	vgc.html	valveGroupControl.html

Renames require updating: the file itself, package.json#node-red.nodes, any require() / import paths, and superproject submodule references in one commit.

When adding new files, read the rule above first to avoid drift.