The Quail Almanac

\n \n\n\n",[18,94],"6d3e8c68-f7ed-11f0-8a0d-42dde27851f2",["D",1769125956055],[18,138],"31309302-f5bc-11f0-a7c1-42dde27851f2",["D",1768884907625],[18,78],"pulls","branches","forks","envVars",{"_315":290,"_317":26},"connections",{"_315":26,"_316":26},"count","unfilledCount","emptyCount",{"_47":654,"_13":653,"_76":646,"_57":-5,"_49":50,"_278":373,"_288":24,"_51":655,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":656,"_17":657},{"_47":643,"_13":644,"_76":645,"_57":646,"_49":50,"_278":647,"_288":24,"_51":648,"_53":649,"_79":21,"_276":650,"_81":30,"_280":-5,"_365":651,"_17":652},{"_47":639,"_13":545,"_76":537,"_57":-5,"_49":50,"_278":492,"_288":24,"_51":640,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":641,"_17":642},{"_47":634,"_13":625,"_76":619,"_57":537,"_49":50,"_278":635,"_288":24,"_51":636,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":637,"_17":638},{"_47":626,"_13":627,"_76":628,"_57":619,"_49":50,"_278":629,"_288":24,"_51":630,"_53":279,"_79":105,"_276":631,"_81":30,"_280":-5,"_365":632,"_17":633},{"_47":616,"_13":617,"_76":618,"_57":619,"_49":50,"_278":620,"_288":24,"_51":621,"_53":54,"_79":105,"_276":622,"_81":30,"_280":-5,"_365":623,"_17":624},{"_47":611,"_13":601,"_76":595,"_57":537,"_49":50,"_278":612,"_288":24,"_51":613,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":614,"_17":615},{"_47":602,"_13":603,"_76":604,"_57":595,"_49":50,"_278":605,"_288":24,"_51":606,"_53":607,"_79":105,"_276":608,"_81":30,"_280":-5,"_365":609,"_17":610},{"_47":592,"_13":593,"_76":594,"_57":595,"_49":50,"_278":596,"_288":24,"_51":597,"_53":517,"_79":105,"_276":598,"_81":30,"_280":-5,"_365":599,"_17":600},{"_47":588,"_13":555,"_76":549,"_57":537,"_49":50,"_278":299,"_288":24,"_51":589,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":590,"_17":591},{"_47":580,"_13":581,"_76":582,"_57":549,"_49":50,"_278":583,"_288":24,"_51":584,"_53":279,"_79":105,"_276":585,"_81":30,"_280":-5,"_365":586,"_17":587},{"_47":572,"_13":573,"_76":574,"_57":549,"_49":50,"_278":575,"_288":24,"_51":576,"_53":290,"_79":105,"_276":577,"_81":30,"_280":-5,"_365":578,"_17":579},{"_47":564,"_13":565,"_76":566,"_57":549,"_49":50,"_278":567,"_288":24,"_51":568,"_53":299,"_79":105,"_276":569,"_81":30,"_280":-5,"_365":570,"_17":571},{"_47":556,"_13":557,"_76":558,"_57":549,"_49":50,"_278":559,"_288":24,"_51":560,"_53":373,"_79":105,"_276":561,"_81":30,"_280":-5,"_365":562,"_17":563},{"_47":546,"_13":547,"_76":548,"_57":549,"_49":50,"_278":550,"_288":24,"_51":551,"_53":26,"_79":105,"_276":552,"_81":30,"_280":-5,"_365":553,"_17":554},{"_47":535,"_13":536,"_76":213,"_57":537,"_49":50,"_278":538,"_288":24,"_51":539,"_53":399,"_79":540,"_276":541,"_81":30,"_280":542,"_365":543,"_17":544},{"_47":275,"_13":18,"_76":201,"_57":-5,"_49":50,"_278":279,"_288":24,"_51":532,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":533,"_17":534},{"_47":305,"_13":78,"_76":77,"_57":201,"_49":50,"_278":54,"_288":24,"_51":529,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":530,"_17":531},{"_47":521,"_13":522,"_76":523,"_57":77,"_49":50,"_278":524,"_288":24,"_51":525,"_53":54,"_79":105,"_276":526,"_81":30,"_280":-5,"_365":527,"_17":528},{"_47":512,"_13":513,"_76":514,"_57":77,"_49":50,"_278":515,"_288":24,"_51":516,"_53":517,"_79":105,"_276":518,"_81":30,"_280":-5,"_365":519,"_17":520},{"_47":504,"_13":505,"_76":506,"_57":77,"_49":50,"_278":507,"_288":24,"_51":508,"_53":290,"_79":105,"_276":509,"_81":30,"_280":-5,"_365":510,"_17":511},{"_47":496,"_13":497,"_76":498,"_57":77,"_49":50,"_278":499,"_288":24,"_51":500,"_53":362,"_79":105,"_276":501,"_81":30,"_280":-5,"_365":502,"_17":503},{"_47":487,"_13":488,"_76":489,"_57":77,"_49":50,"_278":490,"_288":24,"_51":491,"_53":492,"_79":105,"_276":493,"_81":30,"_280":-5,"_365":494,"_17":495},{"_47":479,"_13":480,"_76":481,"_57":77,"_49":50,"_278":482,"_288":24,"_51":483,"_53":54,"_79":105,"_276":484,"_81":30,"_280":-5,"_365":485,"_17":486},{"_47":470,"_13":471,"_76":472,"_57":77,"_49":50,"_278":473,"_288":24,"_51":474,"_53":475,"_79":105,"_276":476,"_81":30,"_280":-5,"_365":477,"_17":478},{"_47":461,"_13":462,"_76":463,"_57":77,"_49":50,"_278":464,"_288":24,"_51":465,"_53":466,"_79":105,"_276":467,"_81":30,"_280":-5,"_365":468,"_17":469},{"_47":302,"_13":138,"_76":137,"_57":201,"_49":50,"_278":131,"_288":24,"_51":458,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":459,"_17":460},{"_47":450,"_13":451,"_76":452,"_57":137,"_49":50,"_278":453,"_288":24,"_51":454,"_53":26,"_79":21,"_276":455,"_81":30,"_280":-5,"_365":456,"_17":457},{"_47":442,"_13":443,"_76":444,"_57":137,"_49":50,"_278":445,"_288":24,"_51":446,"_53":26,"_79":21,"_276":447,"_81":30,"_280":-5,"_365":448,"_17":449},{"_47":434,"_13":435,"_76":436,"_57":137,"_49":50,"_278":437,"_288":24,"_51":438,"_53":26,"_79":21,"_276":439,"_81":30,"_280":-5,"_365":440,"_17":441},{"_47":297,"_13":94,"_76":93,"_57":201,"_49":50,"_278":187,"_288":24,"_51":431,"_53":299,"_79":21,"_276":300,"_81":30,"_280":-5,"_365":432,"_17":433},{"_47":293,"_13":104,"_76":103,"_57":201,"_49":50,"_278":97,"_288":24,"_51":428,"_53":26,"_79":105,"_276":295,"_81":30,"_280":-5,"_365":429,"_17":430},{"_47":287,"_13":147,"_76":146,"_57":201,"_49":50,"_278":195,"_288":24,"_51":425,"_53":290,"_79":21,"_276":291,"_81":30,"_280":-5,"_365":426,"_17":427},{"_47":420,"_13":403,"_76":396,"_57":-5,"_49":50,"_278":421,"_288":24,"_51":422,"_53":26,"_79":80,"_276":-5,"_81":30,"_280":-5,"_365":423,"_17":424},{"_47":412,"_13":413,"_76":414,"_57":396,"_49":50,"_278":240,"_288":24,"_51":415,"_53":416,"_79":105,"_276":417,"_81":30,"_280":-5,"_365":418,"_17":419},{"_47":404,"_13":405,"_76":406,"_57":396,"_49":50,"_278":407,"_288":24,"_51":408,"_53":26,"_79":105,"_276":409,"_81":30,"_280":-5,"_365":410,"_17":411},{"_47":393,"_13":394,"_76":395,"_57":396,"_49":50,"_278":397,"_288":24,"_51":398,"_53":399,"_79":105,"_276":400,"_81":30,"_280":-5,"_365":401,"_17":402},{"_47":385,"_13":386,"_76":387,"_57":-5,"_49":50,"_278":388,"_288":24,"_51":389,"_53":26,"_79":21,"_276":390,"_81":30,"_280":-5,"_365":391,"_17":392},{"_47":377,"_13":378,"_76":379,"_57":-5,"_49":50,"_278":380,"_288":24,"_51":381,"_53":26,"_79":21,"_276":382,"_81":30,"_280":-5,"_365":383,"_17":384},{"_47":368,"_13":369,"_76":370,"_57":-5,"_49":50,"_278":371,"_288":24,"_51":372,"_53":373,"_79":21,"_276":374,"_81":30,"_280":-5,"_365":375,"_17":376},{"_47":359,"_13":360,"_76":361,"_57":-5,"_49":50,"_278":362,"_288":24,"_51":363,"_53":26,"_79":21,"_276":364,"_81":30,"_280":-5,"_365":366,"_17":367},"31cfa0dc-f5bc-11f0-920d-42dde27851f2","deno.json","31cfa1ae-f5bc-11f0-920d-42dde27851f2",19,["D",1768884908674],"{\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",[],[360],"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` (`

History · frontend