# Touch grass ## What this builds A small helper that asks you to put the phone (or the tab) down. A timer counts on an injectable clock. A lockout mode hides a documented set of time-sink paths until the timer ends; it is a client-side aid, not a device policy. A streak counts days a lockout was honoured, locally. Checks do not claim that anyone went outside. There is no network and no account. Read `spekkr.inputs.json` first. `title` is on the home card. `minutes` is the default length. `mode` is timer or lockout. `streak` and `sound` change the chrome. The clock is injectable. ## Out of scope - A real device-wide app block, or access to the person's other apps, in this version. - A camera check that someone is outdoors. - Network, accounts, or a social feed. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Timer and lockout - Starting a session at injected t = 0 with `minutes` 20 ends at t = 20 minutes. A remaining-time display matches the clock to 1 second. - In `lockout` mode, listed paths in `fixtures/lock-paths.json` render a lockout screen instead of their content until the end, then render a done screen. - Dismissing a `timer` session ends it early; dismissing a `lockout` session does not, unless a documented cancel path is used (and that cancel breaks a streak). Accept when: the 20-minute session ends at the right time, lockout hides the listed paths, and the cancel path is the only early exit from lockout. ### R2. Streak and frames - If `streak` is on, completing a lockout on two consecutive injected calendar days yields a streak of 2. Missing a day resets to 0. The rules are in `design.md`. - Goldens: home, a running timer at t = 5 minutes, a lockout screen, and a streak of 2. - One command runs the clock tests, the path lockout, the streak, and writes the frames. No network. No camera. Accept when: the streak cases match, and the four frames match the goldens. ### R3. 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. ### R4. Checks and report - One command runs every acceptance check at the defaults and at the person's inputs, including golden frames where a requirement asks for them. - Checks do not need a network, a paid API, or physical hardware. Accept when: the command passes at the defaults, and a deliberately broken fixture or a wrong price fails it. ## Verification Timer, lockout, and streak logic are tested with a fake clock. Lockout hides documented paths until the countdown ends. Checks do not try to prove that anyone went outside, and they use no camera 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 start a session, how the streak is stored, and how to run the checks.