# Orb farm ## What this builds A round glass world, seen from the side, with a few kinds of tiny organisms and a small chemistry model. The person can change the light, add food, or wait. Seeded ticks change documented population and chemistry numbers. The creatures, the look and the rules are original. This is a toy ecosystem, not a lab model. Read `spekkr.inputs.json` first. `title` sits under the orb. `seed` pins chance. `start` chooses the opening mix. `chemistry` and `labels` change the chrome. ## Out of scope - A scientifically calibrated aquarium or a claim of real biology. - Network, a marketplace of creatures, or a live shared orb in the checks. - A 3D fluid solver of the water in this version. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. State - State is counts of three organisms (`grazer`, `bloom`, `filter`) and four chemistry values in [0, 1]: light, food, waste, oxygen. - A tick is 1 hour of world time. Rules are in `design.md`. - Seed 5, `calm`, at tick 0, matches `fixtures/orb-calm-0.json`. After 48 ticks with no input, it matches `fixtures/orb-calm-48.json`. Accept when: both files match to the counts exactly and to 0.01 on chemistry. ### R2. Tending - A `feed` adds 0.3 food, clamped to 1. A `light` input sets light to a value in [0, 1]. - The tape `fixtures/orb-feed.json` starts from calm seed 5, feeds at tick 4, and at tick 24 matches the file. - No count goes negative. If a count would fall below 0 it is 0. Accept when: the feed tape matches, and a fixture that would go negative is clamped. ### R3. Frames and files - Goldens: calm at tick 0, after the feed tape, crowded at tick 0, and a chemistry-meters close-up of calm at 48. - One command runs the state, tape, and clamp tests, and writes the frames. No network. Chance only from the seed. Accept when: the command passes for both starting mixes, and the frames match the goldens. ### R4. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ## Verification Seeded ticks change documented populations and chemistry, compared to shipped files at tick 0 and 48, and after a feed tape. Counts never go negative. A golden aquarium frame is checked. No live biology claims and no network. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to tend the orb, how to pin a seed, and how to run the checks.