# Anthrocybernetic Water Module

**Status:** experimental concept module  
**Parent system:** Biodynamic Water Garden  
**Related implementation:** `WaterStorage`

## The move

The garden is not only a pond with plumbing. It is a small, observable system in which **flow, storage, transformation, sensing, and return** can be made visible.

WaterStorage contributes a phase vocabulary:

| Water garden | WaterStorage analogy | Meaning in the garden |
|---|---|---|
| Rain, well inflow, or pumped intake | `VAPOR` | New input enters the system |
| Header basin or upper reservoir | `CLOUD` | Water is held ready to distribute |
| Downhill channel and spillway | `PRECIPITATION` | Stored potential becomes movement |
| Pond surface and active habitat | `SURFACE` | The system is immediately observable |
| Seepage, settling, or controlled transfer | `INFILTRATION` | Material moves into a slower layer |
| Deep pond zone or groundwater | `GROUNDWATER` | Buffered, slower storage |
| Protected long-term reserve | `AQUIFER` | Deep storage with redundancy |
| Solar or pedal lift | `SPRING` | Stored water is brought back into active circulation |

These are **design metaphors and control labels**, not claims that water stores ideas or that a biological pond behaves like a computer filesystem. The useful correspondence is operational: each phase has a location, a speed, an energy requirement, and a transition condition.

## Anthrocybernetic loop

```text
                 SENSE
       level · flow · oxygen · soil
                    │
                    ▼
INPUT ───────► STORE ───────► RELEASE
rain/well     header/pond     gravity channels
  │              │                 │
  │              ▼                 ▼
  └──────────► TRANSFORM ◄────── HABITAT
              plants · soil       pond life
                    │
                    ▼
             RETURN / LIFT
           sun · pedal · ram
                    │
                    └──────► upper reservoir
```

An anthrocybernetic module joins a physical cycle to an observing human. The person does not need to pretend to be outside the system: they can measure a water level, pedal a return pump, change a valve, notice an overflow, and feed those observations back into the next design decision.

## Control law

The module keeps five questions visible:

1. **Where is the water?** — phase and reservoir.
2. **How fast can it move?** — gravity, pump head, channel resistance, and storage capacity.
3. **What energy lifts it?** — elevation, sunlight, human work, wind, or a flowing source.
4. **What boundary protects the system?** — screen, float, overflow, drain, and backflow protection.
5. **What did the system teach us?** — measured observations, not mystical conclusions.

The governing physical rule remains simple: downhill flow follows hydraulic head; a higher return requires external energy. The WaterStorage vocabulary gives that physical truth a reusable state model.

## Today's build target

Start with a tabletop or digital loop before earthwork:

- six labeled reservoirs or phase cards;
- a slider for stored water level;
- a gravity-release action;
- a solar/pedal return action;
- an overflow boundary;
- a visible event log;
- a reset button so experiments remain reversible.

The playground in `index.html` is deliberately small. It is for asking: **what changes when storage, flow, energy, and observation are treated as one coupled system?**

## First field measurements

When the physical garden begins, record:

- elevation of pond, header, and each spillway;
- pond and header volume;
- inflow rate from the well hose;
- lift-pump flow at the actual head;
- pedal-pump flow over a five-minute interval;
- seepage loss over 24 hours;
- rainfall, shade, temperature, turbidity, and oxygen;
- overflow events and any erosion.

These measurements can later replace the playground's illustrative values. Until then, the module should stay honest about what is simulated, what is measured, and what remains a hypothesis.

## Safety boundaries

The conceptual module does not replace pond engineering, water testing, animal-care guidance, electrical protection, or flood-control design. In the physical build, use independent overflow and shutoff paths, protect pump intakes, prevent well backflow, and test source water before stocking animals.