docs: initialize project wiki from production hardening session
12 pages covering architecture, findings, and metrics from the
rotatingMachine + machineGroupControl hardening work:
- Overview: node inventory, what works/doesn't, current scale
- Architecture: 3D pump curves, group optimization algorithm
- Findings: BEP-Gravitation proof (0.1% of optimum), NCog behavior,
curve non-convexity, pump switching stability
- Metrics: test counts, power comparison table, performance numbers
- Knowledge graph: structured YAML with all data points and provenance
- Session log: 2026-04-07 production hardening
- Tools: query.py, search.sh, lint.sh
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 16:36:08 +02:00
|
|
|
---
|
|
|
|
|
title: Wiki Index
|
|
|
|
|
updated: 2026-04-07
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# EVOLV Project Wiki Index
|
|
|
|
|
|
|
|
|
|
## Overview
|
|
|
|
|
- [Project Overview](overview.md) — what works, what doesn't, node inventory
|
|
|
|
|
- [Metrics Dashboard](metrics.md) — test counts, power comparison, performance
|
|
|
|
|
- [Knowledge Graph](knowledge-graph.yaml) — structured data, machine-queryable
|
|
|
|
|
|
|
|
|
|
## Architecture
|
2026-04-07 17:08:35 +02:00
|
|
|
- [Node Architecture](architecture/node-architecture.md) — three-layer pattern, ports, mermaid diagrams
|
docs: initialize project wiki from production hardening session
12 pages covering architecture, findings, and metrics from the
rotatingMachine + machineGroupControl hardening work:
- Overview: node inventory, what works/doesn't, current scale
- Architecture: 3D pump curves, group optimization algorithm
- Findings: BEP-Gravitation proof (0.1% of optimum), NCog behavior,
curve non-convexity, pump switching stability
- Metrics: test counts, power comparison table, performance numbers
- Knowledge graph: structured YAML with all data points and provenance
- Session log: 2026-04-07 production hardening
- Tools: query.py, search.sh, lint.sh
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 16:36:08 +02:00
|
|
|
- [3D Pump Curves](architecture/3d-pump-curves.md) — predict class, spline interpolation, unit chain
|
|
|
|
|
- [Group Optimization](architecture/group-optimization.md) — BEP-Gravitation, combination selection, marginal-cost refinement
|
2026-04-07 17:08:35 +02:00
|
|
|
- [Platform Overview](architecture/platform-overview.md) — edge/site/central layering, telemetry model
|
|
|
|
|
- [Deployment Blueprint](architecture/deployment-blueprint.md) — Docker topology, rollout order
|
|
|
|
|
- [Stack Review](architecture/stack-review.md) — full stack architecture assessment
|
|
|
|
|
|
|
|
|
|
## Core Concepts
|
|
|
|
|
- [generalFunctions API](concepts/generalfunctions-api.md) — logger, MeasurementContainer, configManager, etc.
|
docs: initialize project wiki from production hardening session
12 pages covering architecture, findings, and metrics from the
rotatingMachine + machineGroupControl hardening work:
- Overview: node inventory, what works/doesn't, current scale
- Architecture: 3D pump curves, group optimization algorithm
- Findings: BEP-Gravitation proof (0.1% of optimum), NCog behavior,
curve non-convexity, pump switching stability
- Metrics: test counts, power comparison table, performance numbers
- Knowledge graph: structured YAML with all data points and provenance
- Session log: 2026-04-07 production hardening
- Tools: query.py, search.sh, lint.sh
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 16:36:08 +02:00
|
|
|
|
|
|
|
|
## Findings
|
|
|
|
|
- [BEP-Gravitation Proof](findings/bep-gravitation-proof.md) — within 0.1% of brute-force optimum (proven)
|
|
|
|
|
- [NCog Behavior](findings/ncog-behavior.md) — when NCog works, when it's zero, how it's used (evolving)
|
|
|
|
|
- [Curve Non-Convexity](findings/curve-non-convexity.md) — C5 sparse data artifacts (proven)
|
|
|
|
|
- [Pump Switching Stability](findings/pump-switching-stability.md) — 1-2 transitions, no hysteresis (proven)
|
2026-04-07 17:08:35 +02:00
|
|
|
- [Open Issues (2026-03)](findings/open-issues-2026-03.md) — diffuser, monster refactor, ML relocation, etc.
|
docs: initialize project wiki from production hardening session
12 pages covering architecture, findings, and metrics from the
rotatingMachine + machineGroupControl hardening work:
- Overview: node inventory, what works/doesn't, current scale
- Architecture: 3D pump curves, group optimization algorithm
- Findings: BEP-Gravitation proof (0.1% of optimum), NCog behavior,
curve non-convexity, pump switching stability
- Metrics: test counts, power comparison table, performance numbers
- Knowledge graph: structured YAML with all data points and provenance
- Session log: 2026-04-07 production hardening
- Tools: query.py, search.sh, lint.sh
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 16:36:08 +02:00
|
|
|
|
|
|
|
|
## Sessions
|
|
|
|
|
- [2026-04-07: Production Hardening](sessions/2026-04-07-production-hardening.md) — rotatingMachine + machineGroupControl
|
|
|
|
|
|
2026-04-07 17:08:35 +02:00
|
|
|
## Other Documentation (outside wiki)
|
|
|
|
|
- `CLAUDE.md` — Claude Code project guide (root)
|
|
|
|
|
- `AGENTS.md` — agent routing table, orchestrator policy (root, used by `.claude/agents/`)
|
|
|
|
|
- `.agents/` — skills, decisions, function-anchors, improvements
|
|
|
|
|
- `.claude/` — Claude Code agents and rules
|
|
|
|
|
- `manuals/node-red/` — FlowFuse dashboard and Node-RED reference docs
|
|
|
|
|
|
docs: initialize project wiki from production hardening session
12 pages covering architecture, findings, and metrics from the
rotatingMachine + machineGroupControl hardening work:
- Overview: node inventory, what works/doesn't, current scale
- Architecture: 3D pump curves, group optimization algorithm
- Findings: BEP-Gravitation proof (0.1% of optimum), NCog behavior,
curve non-convexity, pump switching stability
- Metrics: test counts, power comparison table, performance numbers
- Knowledge graph: structured YAML with all data points and provenance
- Session log: 2026-04-07 production hardening
- Tools: query.py, search.sh, lint.sh
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 16:36:08 +02:00
|
|
|
## Not Yet Documented
|
|
|
|
|
- Parent-child registration protocol (Port 2 handshake)
|
|
|
|
|
- Prediction health scoring algorithm (confidence 0-1)
|
|
|
|
|
- MeasurementContainer internals (chainable API, delta compression)
|
|
|
|
|
- PID controller implementation
|
2026-04-07 17:08:35 +02:00
|
|
|
- reactor / settler / monster / measurement / valve nodes
|
docs: initialize project wiki from production hardening session
12 pages covering architecture, findings, and metrics from the
rotatingMachine + machineGroupControl hardening work:
- Overview: node inventory, what works/doesn't, current scale
- Architecture: 3D pump curves, group optimization algorithm
- Findings: BEP-Gravitation proof (0.1% of optimum), NCog behavior,
curve non-convexity, pump switching stability
- Metrics: test counts, power comparison table, performance numbers
- Knowledge graph: structured YAML with all data points and provenance
- Session log: 2026-04-07 production hardening
- Tools: query.py, search.sh, lint.sh
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 16:36:08 +02:00
|
|
|
- pumpingStation node (uses rotatingMachine children)
|
|
|
|
|
- InfluxDB telemetry format (Port 1)
|
