Commit Graph

210 Commits

Author SHA1 Message Date
52bf827e9d chore: bump dashboardAPI for slice #37 emittedFields metadata
Refs #37
2026-05-26 17:59:43 +02:00
f867929634 chore: bump dashboardAPI submodule for slice #36 diff-skip regen
Refs #36
2026-05-26 17:57:39 +02:00
042a5cc4ba chore: bump dashboardAPI submodule for slice #35 perf + uid tests
Refs #35
2026-05-26 17:55:45 +02:00
a65cdc3562 chore: ship slice #34 — dashboardAPI walking skeleton + Grafana pin
- Bumps nodes/dashboardAPI submodule to slice/34-walking-skeleton@7fdab73
  (credentials block for bearer token, folderUid config field, basic tests).
- Pins grafana/grafana to 11.3.0 — legacy /api/dashboards/db is the
  generator target; G12 K8s-style API is out of scope (PRD constraint).

Refs #34
2026-05-26 17:53:58 +02:00
14140725bc chore: workflow artifacts — research brief + dashboardAPI v2 PRD + submodule bumps
Bumps machineGroupControl (e1e1977) and pumpingStation (ef07f2a) — example
dashboard JSON tweaks committed on each submodule's development branch.

Adds docs/research/ and docs/prd/ for the dashboardAPI v2 graph-aware Grafana
generator workflow (Gitea issues #32-#43). Ignores .prototypes/ — throwaway
spike code lives there per the /prototype skill.
2026-05-26 17:32:20 +02:00
znetsixe
3f84b91afb chore(submodules): bump 5 nodes — UnitPolicy rollout + buffered fixes
Bumps:
- rotatingMachine    455f15d  refactor: route unit conversions through UnitPolicy.convert
- pumpingStation     2d68a4f  refactor + fix(level): UnitPolicy adoption, level-rate timestamp fix, integration test rewire
- machineGroupControl ddf2b07  refactor: _canonicalToOutputFlow + setDemand via UnitPolicy.convert, structure test rewire
- generalFunctions   bc79de1  fix(influx): accept tagCode camelCase + emit positionVsParent tag
- measurement        36eaa2f  test(edge): align with object-payload accept behaviour

The UnitPolicy bump finishes the §6 contract migration the refactor
plan named (drop _convertUnitValue / hardcoded m3/h<->m3/s scalars in
favour of policy.convert at every site).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-23 15:30:45 +02:00
znetsixe
8c3d3ac69a feat(dashboard): verifiable CoreSync FROST demo + bump coresync submodule
Replaces the old 3-panel coresync-frost-demo.json with a 13-panel dashboard
designed for at-a-glance verification of CoreSync's compression behaviour.

Dashboard rebuild (docker/grafana/provisioning/dashboards/coresync-frost-demo.json):
- Header "How to read" text panel: definitions table + sanity checks so
  every metric is line-of-sight to its Flux source.
- Scoreboard row (4 stats): raw samples / CoreSync knots / reduction % /
  approx. bytes saved over the selected time range.
- Per-stream verification table: one row per CoreSync stream with raw,
  knots, and reductionPct (gradient-coloured). Each line's math is
  mentally checkable: raw × (1 − reductionPct/100) = knots.
- Signal-reconstruction overlays: flow (m³/h) and pressure (mbar)
  rendered as a thin raw line plus fat red knot points so you can see
  knots snap to the raw signal at direction changes. Fixes the previous
  panels which mislabelled both as `flowm3h` regardless of units.
- Diagnostics row: per-stream knot-interarrival timeseries and a
  full-math compression-health table (raw, knots, kept fraction with
  gradient bar, savedPct with colour background).

Bumps coresync submodule to 21d77a8 which lands the FROST demo flow plus
the burst-window reducer fix that was driving cog/efficiency/SEC to ~0%
compression. Verified end-to-end on the live stack: headline reduction
went from 33% to 83%, broken streams from 0.6%-14% to 78%-93%.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-22 20:27:59 +02:00
znetsixe
025bdb4c7e release: palette redesign + CoreSync scaffolding + dashboardAPI MODULE_NOT_FOUND fix
PALETTE REDESIGN (2026-05-21)
  Sidebar swatches switched from S88 level (all blue) to domain-hue per node.
  Family hue = function (rotating=orange, valves=teal, biology=green/olive,
  sampling=violet, sensor=amber, aeration=sky-blue, infrastructure=slate);
  within a family, darker = higher S88 / "more controller-ish."
  Editor-group rectangles in flow.json still follow S88 — only the
  registerType colour changed.

  Submodule bumps for palette: rotatingMachine, machineGroupControl,
  pumpingStation, valve, valveGroupControl, reactor, settler, monster,
  measurement, diffuser, dashboardAPI.

  Docs touched:
    - CLAUDE.md: palette swatch vs. editor-group bullets split out.
    - .claude/rules/node-red-flow-layout.md: new §10.0 introduces the two
      color systems, full 12-row palette table, and explicit warning not to
      mix the two hexes.
    - .claude/refactor/MODULE_SPLIT.md: per-node headers annotated with
      both `group #XXX` and `palette #XXX`.
    - .claude/refactor/WIKI_HOME_TEMPLATE.md + WIKI_TEMPLATE.md: clarify
      Mermaid classDefs visualize hierarchy, not palette swatches.
    - .claude/refactor/OPEN_QUESTIONS.md: dated decision entry with
      rationale, file list, and follow-ups.

CORESYNC SUBMODULE (new)
  nodes/coresync added pointing at https://gitea.wbd-rd.nl/RnD/coresync.
  FROST/SensorThings handoff path — first version forwards FROST-ready HTTP
  request messages on the dbase output; a downstream http-request node
  performs the POST and feeds responses back on msg.topic = "frost.response".
  Lazy stream resolver, latest-wins queue (keep first + latest, drop middle),
  knot-emit on slope change, provenance preserved in Observation parameters.

    - .gitmodules: add nodes/coresync entry.
    - package.json: register coresync as a Node-RED node.
    - generalFunctions bump: new frostFormatter + 4 node config schemas
      expose the dbase format option.
    - measurement bump: "frost" option added to dbaseOutputFormat dropdown
      (plus the in-flight data.measurement unit-handling work).
    - machineGroupControl bump: small editor compact-fields tweak alongside
      the palette change.
    - CORESYNC_FROST_INTERVIEW_HANDOFF.md added at root with interview state
      (Q20 open: slope angle vs. relative delta comparison).

DASHBOARDAPI MODULE_NOT_FOUND FIX
  package.json: dashboardapi entry path corrected to
  nodes/dashboardAPI/dashboardAPI.js. Commit e04c4a1 renamed the files to
  camelCase but missed package.json; on case-sensitive filesystems
  (Linux/Docker, where the tarball lands) the require resolved to nothing
  and the node showed MODULE_NOT_FOUND in the Node-RED palette.

MISC CLEANUP
  - examples/README.md + examples/pumpingstation-complete-example/ removal
    (build_flow.py, flow.json, README.md superseded by per-node examples).
  - jest.config.js: in-progress tweak.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-21 15:09:33 +02:00
znetsixe
1a9d0477bf chore: bump rotatingMachine submodule + gitignore local Claude artifacts
Submodule pointer:
- rotatingMachine @ 8c5822c
    style(editor): drop fixed max-width on rotor SVG — let it fill the panel

Repo hygiene:
- Add .repo-mem/, .codex, CLAUDE.local.md to .gitignore. These are
  per-developer Claude Code state (memory store, IDE marker, per-machine
  conventions) that shouldn't ever land in the repo. .repo-mem alone is
  hundreds of MB on disk.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 22:32:13 +02:00
znetsixe
056f4a8d3e fix: bump 3 submodules — levelBased hold-zone bug, MGC unit math, schema + slim npm packs
Submodule pointer updates:
- generalFunctions @ ae30cef
    feat(pumpingStation schema): add holdLevel + deadZoneKeepAlivePercent;
    slim npm pack
- machineGroupControl @ aeb938c
    feat(setDemand): surface specificClass.setDemand(value, unit='%')
    + slim npm pack
- pumpingStation @ 2e4ad8d
    fix(levelBased): drop hold zone, route through MGC.setDemand, add
    holdLevel + integrator variant pick; slim npm pack

Cross-submodule summary:
- pumpingStation level-based control now sends percent demand to MGC via
  the new MGC.setDemand entry point — was calling handleInput with a raw
  percent, which the dispatcher interpreted as canonical m³/s and pegged
  the group at 100 %.
- Ramp foot is no longer pinned at inflowLevel. Default is startLevel
  (0 % at startLevel = MGC flow.min, matching operator mental model). New
  optional holdLevel raises the 0 %-foot for an explicit hold band.
- Predicted-volume integrator now picks the best-available variant per
  side (measured first, then predicted) so a real upstream sensor +
  predicted pump outflow both feed the basin balance.
- Each submodule grew a .npmignore mirroring its .gitignore plus the
  dev-only trees (test/, wiki/, .claude/, …). Per-submodule pack sizes
  dropped — pumpingStation went 1.5 MB → 57 kB.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 22:22:52 +02:00
znetsixe
cdf517cba3 chore: stage forgotten .mcp.json deletion + bump pumpingStation pin
Two trailing items the prior commits missed:

- .mcp.json was rm'd from the working tree in commit d4e72f2 (repo-mem
  cleanup) but never staged for deletion; git status kept showing
  ' D .mcp.json' as a result. Properly removed now.
- nodes/pumpingStation pin bumps to pull in the wiki-gen regen commit
  that kept Reference-Contracts.md in sync with the tool's canonical
  output.

User WIP intentionally not touched: examples/README.md zeroed-out,
examples/pumpingstation-complete-example/* removed, and
nodes/rotatingMachine working-tree change to rotatingMachine.html.
Those belong to the user; the harness only re-flagged them.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 17:12:40 +02:00
znetsixe
5e2c01ece3 docs + submodules: final backlog clearance — valve/reactor/dashboardAPI
Superproject:
- CLAUDE.md: legacy-drift table loses the dashboardAPI row (migrated);
  drift section notes the type-id-preservation strategy for the
  remaining mgc / vgc renames.
- CONTRACTS.md: canonical-unit rule explicitly carves out reactor as
  an approved ASM-textbook exception with the conversion boundary.

Submodules:
- nodes/valve @ 167b102: CONTRACT documents valve's lack of an FSM
  maintenance state (schema mode enum accepts `maintenance` but no
  enter/exit sequences exist). Limits made explicit instead of being
  hidden as a wiki TODO.
- nodes/reactor @ 75d0413: CONTRACT now declares the approved ASM-unit
  divergence (mg/L, m³/d, °C, 1/h) with the conversion boundary spelled
  out. Closes the canonical-unit drift surfaced by the wiki audit.
- nodes/dashboardAPI @ ......: file rename (preserves type id).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 16:37:05 +02:00
znetsixe
424ad1e293 fix: bump 6 submodules — dead config purged, set.mode descriptions truthful
- nodes/generalFunctions @ 8252a5f: schemas drop dead `calculationMode`
  (RM/valve/VGC — never read) and dead `allowedActions` (valve/VGC —
  flowController only checks isValidSourceForMode, never the action
  allow-list). Kept allowedActions in RM/MGC where it IS enforced.

- nodes/{rotatingMachine,machineGroupControl,valve,valveGroupControl}:
  set.mode descriptions in commands/index.js were generic "auto /
  manual" but each node's schema declares 3–4 specific modes. Now
  enumerate the actual allowed values and point at the schema.

- nodes/machineGroupControl CONTRACT.md additionally fixed: old
  `prioritycontrol`, `optimalcontrol`, `dynamiccontrol` list was wrong
  (lowercase + nonexistent dynamiccontrol); now matches the schema.

- nodes/monster: reframed from "multi-parameter biological process
  monitor" to "sampling-cabinet pulse counter" — the code only emits
  volumetric pulse + bucket state, no constituent analysis. Old
  framing was misleading. examples/README also cleaned of references
  to 4 flow files that don't exist on disk.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 16:06:07 +02:00
znetsixe
cc8e68a023 fix: bump 6 submodules — backlog of safe drifts cleared
- machineGroupControl: CONTRACT.md drops stale set.scaling row
- monster: CONTRACT.md adds child.register row (was in registry only)
- settler: CONTRACT.md adds child.register row; node colour
  #e4a363 → #50a8d9 (S88 Unit blue per flow-layout rule §16)
- pumpingStation: CONTRACT.md adds set.outflow row (was in registry only)
- diffuser: test/README stops claiming "no runtime files" (it has them)
- dashboardAPI: logging.enabled default true (HTML + _buildConfig)
  now matches the dashboardapiConfig.json schema; coercion bug fixed

contract-verify now reports OK across all 11 nodes (was 4 drifts).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 15:59:37 +02:00
znetsixe
429d4b01ed fix(reactor): bump submodules — timeStep unit + X_A_init operational default
Two cross-submodule fixes for the reactor unit-confusion drift the wiki
uplift surfaced:

- nodes/generalFunctions @ 4f715e8: reactor schema timeStep.unit now "s"
  (was "h"), default 1 (was 0.001). Matches reactor.html label [s] and
  baseEngine.js's seconds→days conversion. Description warns future
  readers off changing the unit without updating the engine.

- nodes/reactor @ 346a3ce: HTML X_A_init default 0.001 → 200 (operational
  nitrifying biomass; 0.001 disabled nitrification per the memory note).
  Factory updated to match. New regression test
  test/basic/timestep-units.basic.test.js locks in the seconds contract
  and schema agreement. 49/49 reactor tests pass.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 13:01:21 +02:00
znetsixe
ecd466f7a3 docs: bump 8 submodules — wiki-gen regenerated topic-contract tables
Replaces the placeholder topic tables in Reference-Contracts.md (left by
the wiki uplift agents) with authoritative content generated from each
node's src/commands/index.js. CI gate: `node tools/wiki-gen/bin/wiki-gen.js --check`.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 10:12:00 +02:00
znetsixe
e15f402d47 docs: bump 9 submodules with new 5-page wiki structure
Each node's wiki now matches the rotatingMachine reference: Home +
Reference-{Architecture,Contracts,Examples,Limitations} + _Sidebar.
Total ≈ 9 000 lines of wiki content. Topic-contract and data-model
sections wrapped in <!-- BEGIN AUTOGEN --> markers for the future
wiki-gen tool.

Each agent surfaced real source-vs-spec drift rather than inventing
content:

- measurement: digital-mode notifyOutputChanged path uncertain;
  buildDomainConfig drops several editor fields; position case
  preserved by child.register payload
- valve: flowController gates by source only (action allow-list dead);
  no enter/exit maintenance sequences; sequence-abort token status TBD
- reactor: timeStep unit confusion (HTML s, schema h, engine /86400);
  X_A default disagreement (0.001 vs 200 mg/L); doesn't honour the
  canonical-unit rule (m³/d not m³/s, °C not K)
- valveGroupControl: 4 CONTRACT/source drifts incl. set.mode covers
  4 modes not 2, calculationMode + mode.allowedActions dead config,
  maintenance source allow-list undefined
- settler: icon colour #e4a363 conflicts S88 Unit #50a8d9; Port 2
  emits null in _emitOutputs (init-only registration)
- diffuser: stale test/README claiming "no runtime" — runtime exists
  (284-line specificClass with full OTR/ΔP model); update README
- monster: superproject docs frame as multi-parameter biological
  monitor (NH4/NO3/COD/TSS), but source emits only volumetric pulse +
  bucket state; 4 example flows referenced but missing on disk
- dashboardAPI: dashboardapi.{js,html} lowercase entry vs folder
  convention; logging.enabled default mismatch (false vs true)
- generalFunctions: full library API restructure preserved; module
  map + consumer graph + extension examples retained

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 09:43:25 +02:00
znetsixe
d4e72f280e docs: retire repo-mem MCP, migrate skills to .claude/skills, audit fixes
- Delete .mcp.json + .claude/rules/repo-mem.md; drop .repo-mem from .gitignore
- Remove repo-mem / substrate_score / repo_search references from all .md
- Move 15 EVOLV skills from .agents/skills/ to .claude/skills/ so they are
  auto-discovered by the Claude Code harness and invokable via the Skill tool
- Retire .agents/skills/evolv-orchestrator (duplicate of the subagent at
  .claude/agents/evolv-orchestrator.md); orchestrator lives as a subagent only
- Drop OpenAI-format agent yaml metadata from each skill (not needed for CC)
- Update CLAUDE.md, CONTRACTS.md, AGENTS.md to point at the new locations and
  disambiguate skills (.claude/skills/) vs subagents (.claude/agents/)
- Fix CLAUDE.md tick-loop wording (opt-in per-node, not a fixed 1000ms)
- Widen .claude/rules/ paths frontmatter so node-architecture and telemetry
  rules trigger on more relevant files; add frontmatter to flow-layout rule
- Bump CONTRACTS.md review date to 2026-05-19; add step 7 to the contract-
  change workflow (review example flows when topic usage changes)
- Bump nodes/generalFunctions pin (Home.md substrate_score reference removed)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 09:30:49 +02:00
znetsixe
b1e0736e8e docs: propagate folder-naming convention + bump submodules for editor refresh
Convention:
* CLAUDE.md (root): new "Folder & File Layout (READ BEFORE CREATING NEW FILES)"
  section with required-name table and explicit legacy-drift list (mgc, vgc,
  dashboardapi).
* .claude/rules/node-architecture.md: file-naming convention + src/editor/
  module layout sections; serving recipe for /<nodeName>/editor/:file.

Submodule bumps:
* generalFunctions: shared output-format picker, redesigned position SVGs,
  tighter asset wizard, restored curve preview size.
* rotatingMachine: pump banner, circular state diagram, mode icon cards,
  picker integration, CLAUDE.md update.
* 10 others: per-node CLAUDE.md "Folder & File Layout" sections — 3 of
  them (machineGroupControl, valveGroupControl, dashboardAPI) carry inline
  warnings about their entry-filename drift.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 21:31:50 +02:00
Rene De Ren
253ac93896 docs: standards cleanup — single front-door CONTRACTS.md + archive stale plan artifacts
Establish CONTRACTS.md at the EVOLV root as the canonical map of where every
contract, rule, and standard lives. Surface it from CLAUDE.md so every fresh
agent or colleague lands there first.

Reshape .claude/refactor/ to reflect that the platform refactor is done:
live standards stay at the top level; the plan artifacts (CONTINUE_HERE.md,
TASKS.md) move into Archive/ with WARNING banners.

Drop content that drifted out of date or duplicated the new standards stack:
- docs/DEVELOPER_GUIDE.md (pre-refactor walkthrough; superseded by
  wiki/Architecture, wiki/Getting-Started, .claude/rules/node-architecture,
  .claude/refactor/MODULE_SPLIT + per-node CONTRACT.md + src/commands/).
- .agents/decisions/ (15 DECISION files): load-bearing decisions belong in
  commit messages and PR descriptions; live open items in OPEN_QUESTIONS.md.
- .agents/improvements/TOP10_*.md: moved to Archive/.

Bump generalFunctions to 49c77f2 — adds CONTRACT.md inside the library:
different shape from per-node CONTRACT.md files (library API, not msg.topic),
with stability tags and pointers to .claude/refactor/CONTRACTS.md §N.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 15:48:46 +02:00
znetsixe
560cc2f39a bump submodules: shared icon-picker visuals + asset wizard
* generalFunctions @ 34a4ef0 — new iconHelpers module + initVisuals
  step on logger/position menus; asset selector rebuilt as a chip
  wizard with per-stage type-to-filter combobox and node-aware curve
  mini-chart (rotatingMachine Q-H, valve Cv, diffuser SOTE).
* machineGroupControl @ 6833e9f — consumes the shared visuals;
  strategy/rendezvous cards keep their MGC-local SVGs; maintenance
  switched to FA fa-wrench. Output-format pickers now use the shared
  .evolv-icon-picker classes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 11:11:07 +02:00
znetsixe
4b6579a820 bump submodules: MGC rendezvous planner (same-time landing across modes)
- machineGroupControl @ 472402c — rendezvous planner extracted into
  src/movement/. Every dispatch (both optimalControl and priorityControl)
  routes through a shared _dispatchFlowDistribution helper so all pumps
  reach their setpoint at t* = max(eta_i) regardless of per-pump speed.
  New "Same-time landing" toggle in the editor (planner.useRendezvous,
  default true) for operators who want the legacy fire-and-forget.
- generalFunctions @ af02d36 — new planner.useRendezvous schema field
  and stateManager.getRemainingTransitionS() that the planner reads to
  compute exact eta for children mid-ladder.
- rotatingMachine @ 5ea0b0b — sequenceController honors the new
  sequenceAbortToken so a pre-empted sequence (e.g. shutdown caught
  mid-ramp by a fresh demand) cleanly breaks out instead of barging
  through to its terminal state.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-17 19:45:07 +02:00
znetsixe
1ab913b699 bump submodules: generalFunctions + pumpingStation + rotatingMachine
- generalFunctions f8f71a4: schema additions (output.process/dbase,
  functionality.distance, drop prioritypercentagecontrol), measurement
  position.x nullable, asset-data file renamed machine.json ->
  rotatingmachine.json so AssetMenu lookup matches, menu re-derives
  supplier/assetType from saved model id on reopen.
- pumpingStation 2c7fe17: setDemand reads unit-normalised payload from
  commandRegistry (mirrors today's MGC change to unit-self-describing
  demand commands). Pre-existing test failure (stale path to
  basic-dashboard.flow.json, renamed to 02-Dashboard.json in fe5fa35) is
  unrelated to this commit.
- rotatingMachine 394a972: η = (Q·ΔP)/P_shaft replaces the legacy Q/P
  formula — gives a real BEP peak so NCog stops collapsing to 0 and the
  MGC dashboard's BEP-position metric actually moves. Asset-registry
  lookup renamed machine -> rotatingmachine (matches generalFunctions
  rename). Constructor stateConfig pass-through fixed (default-param was
  clobbering BaseNodeAdapter's pre-set extras). + 2 new tests.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 22:52:53 +02:00
znetsixe
18f68aa5da bump machineGroupControl: governance + unit-self-describing demand (26e92b5)
MGC submodule lands the 2026-05-14 governance review fixes plus rolled-up
session work: _output-manifest.md per the new output-coverage rule,
computeEqualFlowDistribution extracted as a pure function (testable without
MGC), groupEfficiency degenerate-case fix, unit-self-describing set.demand,
eta = (Q*dP)/P formula correction, and dashboard fan-out hardening
(auto-init, NCog normalization, Q-H trim, null-trap closure). Suite 108/108.

Superproject adds:
- .claude/rules/output-coverage.md: every-output-every-state testing rule
  prompted by the eta-null crash earlier in the session.
- CLAUDE.md: pointer to the new rule under Conventions.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 22:32:39 +02:00
znetsixe
9924e66249 bump diffuser + generalFunctions: canonical Nm³/(h·m² membrane) axis
Follow-up to the AssetResolver landing. All five diffuser supplier
curves now share one X-axis convention; diffuser specificClass
computes specific flux from total flow + membrane area and queries the
curves at that flux. Each curve file carries its own
_meta.membraneArea_m2_per_element so the node defaults are correct
without any per-node overrides.

Supplier naming fixed: Sulzer (PIK300/PRK300), Aquaconsult-Entec
(Aerostrip Phoenix).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 18:17:08 +02:00
znetsixe
edc91dd988 bump submodules: AssetResolver landing + diffuser supplier curves
Coordinated cutover across five submodules to the generalFunctions
asset registry. Highlights:

- generalFunctions: AssetResolver namespace + FileBackend, with new
  diffuser supplier curves (GVA migrated, Jäger JetFlex EPDM-1000,
  Aerostrip Phoenix multi-coverage, PIK300/PRK300 multi-coverage).
  Diffuser config schema corrected: density was always meant to be
  bottom-coverage %, not elements/m².
- diffuser: _loadSpecs reads from the registry; editor wired with the
  shared asset cascade (supplier → type → model → unit).
- rotatingMachine + valve: derive supplier/type/units from the model
  id via resolveAssetMetadata; reject saved legacy fields with a clear
  re-save prompt.
- machineGroupControl: integration fixtures use the trimmed asset
  shape.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 17:13:37 +02:00
znetsixe
3b192bec63 bump machineGroupControl: editor defaults + mode-case fix + new example flows (4cb9c50)
Surfaces mode/scaling in the editor, fixes the camelCase-vs-lowercase
mismatch that silently disabled dispatch on default config, compacts the
status badge, extends getOutput with capacity / machine-count fields, and
replaces the pre-refactor example stubs with 01-Basic.json (MGC + 3
pumps + setup) and 02-Dashboard.json (FlowFuse dashboard with charts).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 15:24:16 +02:00
znetsixe
5eafd83443 bump generalFunctions: deep-merge in buildConfig (84a4430)
Fixes MGC child-registration id collision and rotatingMachine
curve-lookup failure caused by the shallow Object.assign in
ConfigManager.buildConfig wiping general.id and asset.model.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 15:06:50 +02:00
znetsixe
29c0cdc37c bump pumpingStation submodule to 6e89e49
Includes 285fd01 (drop 52 MB 01-basic-demo.gif) and 6e89e49 (restore GIF
"needed" placeholders in Home and Reference-Examples so the dropped media
is tracked instead of leaving a broken image link).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 15:02:08 +02:00
znetsixe
123ef6fca3 wiki + submodules: Functional Overview page + bump pumpingStation / generalFunctions / monster
Submodule pointers
- pumpingStation: realistic basin defaults, ramp-foot visual fix, manual-mode
  observability, new 02-Dashboard.json (charts + raw-output table), wiki
  Home/Reference-Examples with screenshots + demo GIF.
- generalFunctions: pumpingStation config schema defaults aligned with the
  new editor drag-in values; startLevel description corrected (ramp foot is
  inflowLevel, not startLevel).
- monster: examples cleanup — drop pre-refactor flows, ship single
  02-integrated-e2e.json.

Wiki
- New wiki/Functional-Overview.md: companion to Architecture covering the
  process side — what each node physically represents and which control
  objective it serves.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 14:52:36 +02:00
znetsixe
f7ada0fd9d P11.8: bump pumpingStation submodule — Zone A / Reference-* wiki split
Pilot pass for the per-node Home redesign. pumpingStation's wiki/
now has a short, intuitive Home.md plus four Reference-* sibling
pages (Contracts / Architecture / Examples / Limitations). Asset
placeholders created under wiki/_partial-{screenshots,gifs,flows}/
with explicit "screenshot needed" / "GIF needed" callouts where
the user will record assets.

Abandoned content: wiki/functional-description.md and wiki/modes/*
were removed from source per user direction (example-driven over
prose).

Once this pattern is validated on the live pumpingStation wiki,
the same split will be applied to the other 10 nodes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-12 09:20:44 +02:00
znetsixe
9ab9f6b3e3 P11.7: bump submodule pointers for 2026-05-11 wiki wave
13-agent parallel rewrite of per-node wiki/Home.md per the visual-first
14-section template (.claude/refactor/WIKI_TEMPLATE.md). Three pointer
bumps (diffuser, valve, dashboardAPI) were committed early by their
agents (ff804af, e2aa6e6, 14f9104); this commit covers the remaining
nine submodules:

- generalFunctions  → c7e561e  (new wiki/Home.md; library API surface)
- machineGroupControl → 05de4ee
- measurement       → ffc0358
- monster           → 53c25f2
- pumpingStation    → b825ac1
- reactor           → d735f94
- rotatingMachine   → b373727
- settler           → 98052a1
- valveGroupControl → 618ad27

Parent wiki audit (b8cb889) is already committed: 18 stale pages moved
to wiki/Archive/, evergreen domain/manual content kept, Home.md
refactor-status corrections (Tier 6 + Tier 9).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 21:08:51 +02:00
znetsixe
14f9104722 P11.7: bump dashboardAPI submodule pointer (wiki Home.md rewrite)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 21:06:56 +02:00
znetsixe
e2aa6e6937 docs: bump valve submodule pointer — wiki Home.md FSM + config rewrite
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 21:06:37 +02:00
znetsixe
ff804af11c bump nodes/diffuser submodule pointer: P11.6 wiki regen
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 21:05:10 +02:00
znetsixe
44ffae12f7 P11.6 wiki regen + Phase 10 private-test rewrites — bump pointers
All 11 nodes' wiki/Home.md regenerated with the Unit column +
per-topic descriptions. rotatingMachine + reactor private-method
test files rewritten to the public BaseNodeAdapter surface.

OPEN_QUESTIONS: rotatingMachine + reactor private-test entries
marked RESOLVED.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:44:19 +02:00
znetsixe
4f970eaa0d Wave B3 + C: bump submodule pointers for P11.5 + B2.1 + B2.2
pumpingStation   ef81013 → 5f1c9ae  P11.5 units + B2.1 declareChildGetter
  machineGroupControl 31324ae → 3ee1939  P11.5 units (set.demand)
  rotatingMachine  84126e9 → 1d5e040  P11.5 units (set.flow-setpoint)
  valve            8aa5b5e → 63b5f94  P11.5 units + descriptions
  monster          0038a8c → 133d442  P11.5 descriptions
  diffuser         9122b14 → e18b6a0  P11.5 units (data.flow)
  reactor          297c671 → 1aa2d92  P11.5 descriptions
  settler          2af30c0 → 43a5bf5  P11.5 descriptions
  valveGroupControl c44d595 → 778b2e0  P11.5 + B2.2 ChildRouter adoption
  measurement      497f05d → 15b7414  P11.5 descriptions

Platform: 810 / 0 across all 12 submodules. Phase 11 ready for the
last step (P11.6 regenerate docs).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:31:52 +02:00
znetsixe
6bf94f4c8a Wave B1: bump submodule pointers + 5 OPEN_QUESTIONS resolved
generalFunctions f117546 → <new>  B2.3 fireAndWait + P11.1 possibilities
                                    + P11.2 commandRegistry.units + monster schema
  measurement      e6e212a → <new>  B1.3 isStable threshold
  monster          2aa7f88 → <new>  B1.4 cooldown-guard root-cause fix
  machineGroupControl 0e8cab5 → <new>  B2.3 fireAndWait migration

OPEN_QUESTIONS marked RESOLVED in the decisions table:
  isStable tautology, monster cooldown-guard, LatestWinsGate fireAndWait

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 17:29:23 +02:00
znetsixe
30928ce378 Wave A: bump submodule pointers + mark 4 OPEN_QUESTIONS resolved
generalFunctions ff9aec8 → f117546  B3.1+B3.2+B3.3 infra
  measurement      2aa8021 → e6e212a  B2.4 drop 'mAbs' event
  machineGroupControl 045a941 → 0e8cab5  B3.3 drop _unitView
  rotatingMachine  9e8463b → 84126e9  B3.3 drop _unitView
  pumpingStation   e991ea6 → ef81013  B1.2 drop 'overfillLevel'

OPEN_QUESTIONS.md: 4 entries marked RESOLVED (ChildRouter monkey-patch,
commandRegistry 'none' type, measurement 'mAbs' event, MGC unitPolicy
shape).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 17:14:00 +02:00
znetsixe
351e889918 Bump submodule pointers: A1/A2/A3 fixes + basin-docs-update merge
monster          2a82b7d → 2aa7f88  A1: restore child.register input handler
  settler          6953d64 → 2af30c0  A2: restore child.register input handler
  reactor          d931bea → 297c671  A3: expose tick(dt) on BaseDomain wrapper
  pumpingStation   ed22f01 → e991ea6  A4+B4: merge basin-docs-update (per-mode SVG,
                                       stopLevel hysteresis, shifted ramp, manual
                                       q_out, log/linear curve, overflow clamp + spill,
                                       7-file editor module set)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 16:20:17 +02:00
znetsixe
23dc23328d Bump generalFunctions for P10.5 test fixes 2026-05-11 15:21:16 +02:00
znetsixe
3bfb9833c0 P9.3: parent EVOLV wiki Home + Archive + bump submodule pointers
wiki/Home.md (new) — platform landing page per WIKI_HOME_TEMPLATE.md.
Mermaid block of 11 active EVOLV nodes coloured by S88 level, navigation
grouped by level, standards-pointer table, live refactor-status table.

wiki/Archive.md (new) — empty archive table for retired wiki pages.

Submodule pointer bumps (all wiki/Home.md + wiki:* npm scripts):
  measurement          42a0333 → 2aa8021
  machineGroupControl  bb2f3be → 045a941
  rotatingMachine      e058fe9 → 9e8463b
  valve                e27135b → 8aa5b5e
  valveGroupControl    e02cd1a → c44d595
  diffuser             15cfb22 → 9122b14
  monster              2a6a0bc → 2a82b7d
  settler              b8247fc → 6953d64
  reactor              7bf464b → d931bea
  dashboardAPI         92d7eba → 67a374f

Every node now has a visual-first wiki Home page with auto-generated
topic contract + data model. Per-node `npm run wiki:all` re-generates
the AUTOGEN blocks from src/commands/ + src/specificClass.js.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 15:18:05 +02:00
znetsixe
afc304b424 Bump pumpingStation + generalFunctions for P9.2 + P9.3 + examples
generalFunctions  95c5e68 → 30c5dc8  P9.2 wikiGen.js shared script
  pumpingStation    d2384b1 → ed22f01  P9.3 wiki Home.md pilot +
                                       3-tier example flows + tools/
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 14:50:57 +02:00
znetsixe
3b7acdaa88 P10.7: top-level test:platform runner + bump submodule pointers
scripts/test-platform.js iterates each submodule, runs npm test, shows
a per-node pass/fail summary, exits non-zero if any node fails.

Wired as `npm run test:platform` in the parent package.json.

Submodule pointer bumps:
  dashboardAPI     2874608 → 92d7eba  (Mocha → node:test conversion for edge+integration)
  diffuser         0ec9dd1 → 15cfb22  (P10.7a test script fix)
  generalFunctions 8ebf31d → 95c5e68  (P10.7a test script fix + remove 5 broken Mocha dupes)
  pumpingStation   52d3889 → d2384b1  (P10.7a test script fix)

Current platform-wide gate: 729 pass / 5 fail across 12 submodules
(5 failures are all pre-existing AssertionErrors logged in
OPEN_QUESTIONS.md for Phase 10.5).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 14:45:06 +02:00
znetsixe
0a890fd0d7 Bump generalFunctions to 7c..-ish (P8.5 cleanup + P6.4 schema fix)
92eb8d2  P8.5: remove src/menu/asset_DEPRECATED.js (243 lines, 0 consumers)
  HEAD     P6.4 follow-up: add diffuser config schema fields

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 07:47:39 +02:00
znetsixe
1d0dd45d9a P8 prep: bump submodule pointers to development tips after Phase 1-6
All 12 submodules + parent EVOLV are now on the `development` branch
with the platform refactor complete:

  generalFunctions     7372d12  Phase 1 platform infra (additive)
                                BaseNodeAdapter / BaseDomain / UnitPolicy
                                ChildRouter / LatestWinsGate / HealthStatus
                                commandRegistry / statusBadge / statusUpdater
                                stats — 113 unit tests
  pumpingStation       52d3889  Phase 2 — concern split + integration
                                basin/measurement/control/safety/io/commands
                                specificClass 1039→245 lines, 102 tests
  measurement          42a0333  Phase 3 — Channel-based analog + BaseDomain
                                simulator/calibration/commands extracted
                                specificClass 716→244 lines, 96 tests
  machineGroupControl  bb2f3be  Phase 4 — concern split + integration
                                groupOps/totals/combinatorics/optimizer/
                                efficiency/dispatch/commands
                                specificClass 1808→336 lines, 77 tests
  rotatingMachine      e058fe9  Phase 5 — concern split + integration
                                curves/prediction/drift/pressure/state/
                                measurement/flow/display/commands
                                specificClass 1760→400 lines, 196 tests
  valve                e27135b  Phase 6 platform refactor + concern split
  valveGroupControl    e02cd1a  Phase 6 platform refactor + concern split
  diffuser             0ec9dd1  Phase 6 platform refactor (port 4→3)
  monster              2a6a0bc  Phase 6 platform refactor + concern split
  settler              b8247fc  Phase 6 platform refactor (reactor link kept)
  reactor              7bf464b  Phase 6 platform refactor + kinetics/ split
  dashboardAPI         2874608  Phase 6 — commandRegistry only (no BaseDomain;
                                passive HTTP server — see OPEN_QUESTIONS.md)

493 basic tests pass platform-wide (12/12 nodes green).

All canonical input topics (set.* / cmd.* / data.* / child.* / query.* /
evt.*) live alongside legacy aliases with one-time deprecation warnings.
Topic-rename cycle (P7) elapses across one release before alias removal.

Decisions taken during the refactor are recorded in
.claude/refactor/OPEN_QUESTIONS.md (resolved entries + carryovers for
Phase 8.5 cleanup, Phase 9 wiki, and Phase 10 test rewrite).

Ready for review on a per-submodule basis. Promotion to main is gated
on Docker E2E (per-node trial-ready criteria) — not part of this commit.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 22:25:16 +02:00
Rene De Ren
aec90cc8e7 fix: stopLevel hysteresis works — bump rotatingMachine + MGC
Some checks failed
CI / lint-and-test (push) Has been cancelled
Pump-shutdown deadlock fix split across two submodules:

- rotatingMachine@8f9150e: shutdown sequence clears state.delayedMove
  so the abort-and-return-to-operational path doesn't auto-pickup the
  queued setpoint and re-engage the pump.
- machineGroupControl@ea2857f: turnOffAllMachines clears MGC's
  _delayedCall and serializes per-pump shutdown so PS's 2 s tick loop
  can't interrupt an in-flight shutdown.

Live verification on pumpingstation-complete-example demo: basin now
shuts pumps off at stopLevel cleanly, reverses to fill, completes the
hysteresis cycle.

Also disable the trends page in the demo flow (build_flow.py + regen
flow.json). FlowFuse ui-chart's per-series server-side history buffer
(7 charts × ~20 series × 3600-point retention) was saturating the
Node-RED event loop at 129% CPU, making the dashboard freeze on every
click. Trends remain available — just disabled by default; flip the
ui_page_trends "d" key to false to re-enable.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 18:18:11 +02:00
Rene De Ren
6fef002da1 Bump machineGroupControl@2651aaf — quiet abortActiveMovements normal path
Some checks failed
CI / lint-and-test (push) Has been cancelled
WARN now fires only when force-aborting an actually in-flight pump
movement (gate-bypass safety net), not on every no-op tick.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 09:43:17 +02:00
Rene De Ren
c4d75809cd Bump machineGroupControl@df74ea0 — serialize handleInput dispatches
Some checks failed
CI / lint-and-test (push) Has been cancelled
Adds the _dispatchInFlight gate that mirrors rotatingMachine
state.delayedMove. Before this, PS at 1 Hz overran in-flight pump
ramps via concurrent handleInput entries, producing the live thrash:
120 aborts / 2 min, pump_b clamped at minFlow.

Includes regression test:
test/mgc-overactive-demand-serialization.integration.test.js
covering concurrent-burst serialization (30 calls → ≤ 5 aborts) and
latest-wins semantic.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 09:15:23 +02:00
Rene De Ren
a4617d850a Bump MGC@96b84d3 — revert unchanged-demand short-circuit (broke live demo)
Some checks failed
CI / lint-and-test (push) Has been cancelled
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-08 20:55:47 +02:00