The Quail Almanac

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_636":637,"_638":639},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":-7,"_18":19,"_17":-7,"_479":-5,"_20":480,"_22":481,"_482":483,"_484":485,"_26":486,"_24":487,"_488":-5,"_489":-5,"_490":53,"_491":492,"_493":45,"_494":-5,"_495":-5,"_496":497},"routes/_app.x.$handle.$name.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","jhiller","name","IncubatorTempHumidityTracker","branchName","main","version","path","frontend/index.html","project",{"_33":423,"_13":14,"_46":424,"_425":-5,"_426":53,"_427":428,"_429":428,"_430":-5,"_431":-5,"_432":433,"_434":297,"_435":45,"_436":-5,"_437":-5,"_438":70,"_439":440,"_441":442,"_443":444,"_445":446,"_447":-5,"_448":449,"_450":449,"_451":452,"_453":452,"_454":452,"_455":449,"_456":449,"_457":458,"_459":460,"_461":462,"_463":53},"tree",[57,58,59,60,61,62,63,64],"file",{"_33":34,"_13":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_17":48,"_49":24,"_50":51,"_52":53,"_54":-5,"_18":55},"contents",[],"upstream","pull","ahead","behind","envVars","id","7976f3cf-1e70-40ff-8abd-f1a855e6db20","index.html","fileId","3195b9ee-f5bc-11f0-9ddc-42dde27851f2","parentId","30c14402-f5bc-11f0-90d9-42dde27851f2","branchId","5306ba64-f5b8-11f0-aa92-42dde27851f2","branchVersion",263,"latest",true,"createdAt",["D",1783401832162],9,"fileType","content","\n\n\n \n \n The Quail Almanac\n\n \n \n \n\n \n \n \n \n \n \n \n \n \n \n 🥚\">\n \n\n\n

\n \n\n\n","deleted",false,"label",[56,35],"frontend",{"_33":407,"_13":408,"_36":409,"_38":-5,"_40":41,"_42":80,"_44":45,"_46":410,"_17":70,"_49":105,"_50":-5,"_52":53,"_54":-5,"_72":411,"_18":412},{"_33":285,"_13":286,"_36":287,"_38":-5,"_40":41,"_42":248,"_44":45,"_46":288,"_17":70,"_49":105,"_50":-5,"_52":53,"_54":-5,"_72":289,"_18":290},{"_33":138,"_13":56,"_36":39,"_38":-5,"_40":41,"_42":139,"_44":45,"_46":140,"_17":70,"_49":105,"_50":-5,"_52":53,"_54":-5,"_72":141,"_18":142},{"_33":100,"_13":101,"_36":102,"_38":-5,"_40":41,"_42":103,"_44":45,"_46":104,"_17":70,"_49":105,"_50":-5,"_52":53,"_54":-5,"_72":106,"_18":107},{"_33":92,"_13":93,"_36":94,"_38":-5,"_40":41,"_42":95,"_44":45,"_46":96,"_17":70,"_49":24,"_50":97,"_52":53,"_54":-5,"_72":98,"_18":99},{"_33":84,"_13":85,"_36":86,"_38":-5,"_40":41,"_42":87,"_44":45,"_46":88,"_17":70,"_49":24,"_50":89,"_52":53,"_54":-5,"_72":90,"_18":91},{"_33":75,"_13":76,"_36":77,"_38":-5,"_40":41,"_42":78,"_44":45,"_46":79,"_17":80,"_49":24,"_50":81,"_52":53,"_54":-5,"_72":82,"_18":83},{"_33":65,"_13":66,"_36":67,"_38":-5,"_40":41,"_42":68,"_44":45,"_46":69,"_17":70,"_49":24,"_50":71,"_52":53,"_54":-5,"_72":73,"_18":74},"31cfa0dc-f5bc-11f0-920d-42dde27851f2","deno.json","31cfa1ae-f5bc-11f0-920d-42dde27851f2",19,["D",1768884908674],0,"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}","children",[],[66],"b5fa3335-06c6-4540-b4f6-592ed25e8ca8","CLAUDE.md","81f6de80-f752-11f0-8d59-42dde27851f2",275,["D",1783402413414],3,"# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## Project Overview\n\nQuail egg incubator monitoring system built on Val Town. Receives temperature data from a single LoRaWAN sensor — a NanoThings NanoTag — via ChirpStack webhooks, stores readings in SQLite, sends temperature email alerts, and displays a React dashboard.\n\n**Live URL:** https://quail-incubator.val.run/\n\n> **Sensor history:** The system originally ran a RAK7204 (temp + humidity, Cayenne LPP) alongside the NanoTag. As of July 2026 the RAK7204 was retired and the NanoTag (temperature-only) is the sole sensor. There is no humidity sensor anymore — humidity monitoring and humidity alerts were removed.\n\n## Development Commands\n\n```bash\n# Start local development with auto-sync to Val Town\n~/.deno/bin/vt watch\n\n# The app auto-deploys on save - no build step required\n```\n\n## Architecture\n\n### Platform: Val Town\n- Runs on Deno in a serverless context (not Node.js)\n- Entry point: `backend/index.http.tsx` exports `app.fetch`\n- Database: **per-val (project-scoped) SQLite** via `https://esm.town/v/std/sqlite/main.ts`\n- Email: Val Town's email service via `https://esm.town/v/std/email`\n- File serving: `https://esm.town/v/std/utils` for `readFile` and `serveFile`\n\n### Data Flow\n1. ChirpStack sends LoRaWAN uplinks to `/webhook/chirpstack?event=up`\n2. Webhook processes only the configured NanoTag DevEUI (`shared/constants.ts` → `DEVICE_EUIS.NANOTAG`); any other device is logged and ignored\n3. NanoTag payload decoded by fPort: ports 26/27 = temperature, ports 1/13/21/31/32 = battery\n4. Temperature readings stored in `incubator_nanotag_readings_v1`\n5. Each temperature reading triggers a temperature alert check (calibrated NanoTag temp). Humidity is passed as `null` throughout, so humidity alert checks are skipped\n6. Dashboard polls `/api/status` and `/api/readings/nanotag` every 60 seconds\n\n### Sensor Calibration\nDefined in `shared/constants.ts`:\n- NanoTag: +1°F offset (`CALIBRATION.nanotagTemperatureF`)\n- Backend stores raw temperature; the dashboard and alert logic apply the offset\n\n### Incubation Logic\n- 17-day Coturnix quail incubation starting from `INCUBATION_CONFIG.startDate`\n- Lockdown phase begins day 15 (advisory only — no humidity sensor to enforce it)\n- Temperature thresholds: ideal 101-102°F, warning ±3°F, critical ±5°F\n- Alerts rate-limited: critical every 5 min, warning every 30 min\n- Mode (`incubation`/`brooder`) and `hatch_date` are stored in the `incubator_config_v1` table; brooder mode auto-activates on day 19+. To restart the clock for a new batch, update `INCUBATION_CONFIG.startDate` AND clear the `mode`/`hatch_date` config rows (or start from a fresh per-val DB).\n\n### Frontend\n- React 18.2.0. Layout utilities via twind (Tailwind CDN); the visual design lives in a hand-written CSS system in `frontend/index.html` (`