docs: update README with projected whelping calendar identifier (v0.5.1)

README.md

@@ -14,7 +14,7 @@ A reactive, interactive dog breeding genealogy mapping system for professional k
 - **✅ Search & Filter** - Find dogs by name, breed, sex, and more
 - **✅ Branded Navigation** - Custom logo (br-logo.png) with gold-to-rusty-red gradient title
 - **✅ Trial Pairing Simulator** - COI calculator with common ancestors table and risk badge
-- **✅ Heat Cycle Calendar** - Month grid calendar with cycle windows and breeding date suggestions
+- **✅ Heat Cycle Calendar** - Month grid calendar with cycle windows, breeding date suggestions, and **projected whelping identifiers**
 
 ### Database Architecture
 - **✅ Clean Schema** - No migrations, fresh installs create correct structure
@@ -24,7 +24,18 @@ A reactive, interactive dog breeding genealogy mapping system for professional k
 - **✅ Heat Cycles** - Breeding cycle tracking
 - **✅ Genetic Traits** - Inherited trait mapping
 
-### Recently Added (March 9, 2026)
+### Recently Added (March 9, 2026 — v0.5.1)
+- **✅ Projected Whelp Window on Calendar** - Indigo/purple day cells (days 58–65 from breeding date) visible directly on the month grid
+- **✅ Expected Whelp Day Marker** - Indigo dot on the exact expected whelp day (day 63) alongside the green breeding dot
+- **✅ "[Name] due" Cell Label** - Baby 🍼 icon + dog name label inside the whelp day cell
+- **✅ Active Cycle Card — Whelp Range** - "Whelp est. [date]" row with earliest–latest range shown on each active cycle card
+- **✅ Jump-to-Whelp-Month Button** - One-click navigation to the whelp month when it differs from current view
+- **✅ Live Whelp Preview in Modal** - Instant client-side earliest/expected/latest preview as soon as a breeding date is entered (no save required)
+- **✅ Whelping Banner** - Full-width indigo banner listing dogs with projected whelps when no active heat cycles are visible
+- **✅ Legend Entry** - "Projected Whelp" added to calendar legend
+- **✅ Updated Page Subtitle** - Now reads: *"Track heat cycles, optimal breeding windows, and projected whelping dates"*
+
+### Previously Added (March 9, 2026 — v0.5.0)
 - **✅ Heat Cycle Calendar** - Full month grid with color-coded cycle windows (Proestrus / Optimal / Late Estrus / Diestrus)
 - **✅ Start Cycle Modal** - Click any day or the header button to log a new heat cycle for a female
 - **✅ Breeding Date Suggestions** - Phase windows with date ranges loaded from `GET /api/breeding/heat-cycles/:id/suggestions`
@@ -33,7 +44,7 @@ A reactive, interactive dog breeding genealogy mapping system for professional k
 - **✅ Pairing Nav Link** - `FlaskConical` icon added to navbar
 - **✅ New API Endpoints** - `GET /api/breeding/heat-cycles`, `GET /api/breeding/heat-cycles/:id/suggestions`
 
-### Previously Added (March 9, 2026)
+### Previously Added (March 9, 2026 — v0.4.x)
 - **✅ Brand Logo** - Custom `br-logo.png` in navbar replacing generic icon
 - **✅ Gradient Title** - Gold-to-rusty-red gradient on "BREEDR" brand text
 - **✅ Static Asset Serving** - `/static` directory served by Express for branding assets
@@ -141,7 +152,7 @@ breedr/
 ├── client/             # React frontend
 │   ├── src/
 │   │   ├── pages/
-│   │   │   ├── BreedingCalendar.jsx  # Heat cycle calendar (month grid)
+│   │   │   ├── BreedingCalendar.jsx  # Heat cycle calendar + whelping identifiers
 │   │   │   ├── PairingSimulator.jsx  # Trial pairing + COI
 │   │   │   ├── Dashboard.jsx
 │   │   │   ├── DogList.jsx
@@ -248,6 +259,10 @@ Ensure `br-logo.png` is placed in the `static/` directory at the project root. T
 
 Ensure dogs are registered with `sex: 'female'` before creating heat cycles. The API validates this and will return a 400 error for male dogs.
 
+### Whelping window not appearing on calendar
+
+A breeding date must be logged on the cycle for whelp window cells to appear. Use the Cycle Detail modal → "Log Breeding Date" field. The whelp preview appears client-side instantly; the calendar cells populate after save.
+
 ## Roadmap
 
 ### ✅ Completed
@@ -264,6 +279,7 @@ Ensure dogs are registered with `sex: 'female'` before creating heat cycles. The
 - [x] Static asset serving
 - [x] Trial Pairing Simulator (COI + common ancestors + risk badge)
 - [x] Heat Cycle Calendar (month grid + windows + breeding suggestions + whelping estimate)
+- [x] **Projected Whelping Calendar Identifier** (whelp window cells, due label, active card range, live modal preview, whelping banner)
 
 ### 🔧 In Progress / Up Next
 - [ ] Health Records System
@@ -279,6 +295,17 @@ Ensure dogs are registered with `sex: 'female'` before creating heat cycles. The
 
 ## Recent Updates
 
+### March 9, 2026 - Projected Whelping Calendar Identifier (v0.5.1)
+- **Added:** Indigo whelp window (days 58–65) on calendar grid cells when a breeding date is logged
+- **Added:** Indigo dot marker on exact expected whelp day (day 63)
+- **Added:** `Baby` icon + "[Name] due" label inside whelp day cells
+- **Added:** "Whelp est. [date]" row with earliest–latest range on active cycle cards
+- **Added:** Jump-to-whelp-month button on active cycle cards
+- **Added:** Live whelp preview in Cycle Detail modal (client-side, instant, no save required)
+- **Added:** Full-width whelping banner when projected whelps exist but no active heat cycles are visible
+- **Added:** "Projected Whelp" legend entry with Baby icon
+- **Updated:** Page subtitle to include projected whelping dates
+
 ### March 9, 2026 - Heat Cycle Calendar & Trial Pairing Simulator (v0.5.0)
 - **Added:** Full month grid heat cycle calendar with color-coded phase windows
 - **Added:** Start Heat Cycle modal (click any day or header button)