Docs: bring all documentation current with v0.8.1

- README: v0.8.1 highlights, Node 18+ requirement + client install step for
  manual dev setup, health/genetics features listed, release summary updated
- API.md: paginated response shapes for dogs/litters, validation + status-code
  behavior (400/404), full breeding heat-cycle CRUD, genetics PUT/DELETE,
  pedigree COI/relations/cancer-lineage endpoints, corrected Litter object
- DEVELOPMENT.md: two-layer migration approach documented with schema-drift
  warning, heat_cycles/cancer_history tables, Toast/ConfirmDialog UI patterns
  (no alert/window.confirm), full env-var table, auth-deferred decision noted
- INSTALL.md: fixed API smoke-test (old /api/health root path doesn't exist),
  master -> main
- ROADMAP: v0.8.1 entry; Phase 4b checkboxes reconciled with what's actually
  built; Phase 6 progress; pre-deploy prod-DB check added to QA list

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

README.md

@@ -4,10 +4,11 @@ A reactive, interactive dog breeding genealogy mapping system for professional k
 
 ---
 
-## 🌟 Recent Highlights (v0.8.0)
-- **✅ Reverse Pedigree** — Toggle between ancestors and descendants view for full lineage tracking.
-- **✅ External Dog Mapping** — Assign parents to external dogs, allowing for full genealogy of outside lines.
-- **✅ Universal Parent Selection** — Select any dog (kennel or external) as a sire/dam from any profile.
+## 🌟 Recent Highlights (v0.8.1 — July 2026)
+- **✅ Fresh-install fix** — Schema definitions reconciled with the routes; a brand-new database now boots with heat cycles, litters, and puppy logs fully working.
+- **✅ Health Records overhaul** — Per-type record forms (OFA / vaccination / exam / surgery / medication), document upload (PDF/image), OFA age validation, and delete actions.
+- **✅ UX layer** — Toast notifications, proper confirmation dialogs, load-error banners with retry, a 404 page, and mobile-friendly layouts across all pages.
+- **✅ Hardened API** — Sire/dam sex validation, transactional writes, and safe photo handling.
 
 ---
 
@@ -22,11 +23,13 @@ docker-compose up -d --build
 Access at: `http://localhost:3000`
 
 ### 2. Manual Development Setup
+Requires **Node.js 18+** (better-sqlite3 v11 ships prebuilds for Node 18–24).
 ```bash
 npm install
-npm run dev
+cd client && npm install && cd ..
+npm run dev        # runs API (nodemon, :3000) + client (vite, :5173) together
 ```
-> **Note:** The database initializes automatically on first boot. No manual migrations are required.
+> **Note:** The database initializes automatically on first boot — tables and columns are created/added via safe guards. No manual migrations are required.
 
 ---
 
@@ -42,6 +45,8 @@ npm run dev
 - **Interactive Pedigree**: 5-generation trees with zoom/pan. Toggle the **Reverse Pedigree** switch to see descendant lineage.
 - **Trial Pairing Simulator**: Calculate Wright's Inbreeding Coefficient (COI) instantly. Identifies common ancestors and providing risk badges (Low/Moderate/High).
 - **Heat Cycles**: Track female cycles on the calendar. Includes **projected whelping alerts** (indigo windows) and expected due dates.
+- **Health Records**: OFA clearances (hip, elbow, patella, heart, eyes, thyroid), GRCA/CHIC clearance summaries, vaccinations, exams, surgeries, and medications — with supporting-document upload.
+- **DNA Panel**: Golden Retriever genetic markers (PRA, ICH, NCL, DM, MD) with carrier-risk checks on trial pairings.
 
 ---
 
@@ -69,8 +74,9 @@ breedr/
 
 ## 🕒 Release Summary
 
+- **v0.8.1** (Jul 2026): Fresh-install schema fix, health record overhaul, toast/dialog UX layer, API hardening, mobile responsiveness.
 - **v0.8.0** (Mar 2026): Reverse Pedigree & External dog parentage.
-- **v0.7.0** (In Progress): Health & Genetics (OFA clearances, DNA panels).
+- **v0.7.0**: Health & Genetics (OFA clearances, DNA panels, cancer history).
 - **v0.6.1**: COI calculation fix for direct parent×offspring relations.
 - **v0.6.0**: Champion status tracking & Kennel settings API.