feat: Meal Planner UI with Calendar View and Multi-Planning Support

[Nightbr]

Summary

This PR implements the Meal Planner UI feature, including a new calendar view to visualize all meal planning periods and weekly plan navigation between multiple meal plannings.

MealPlanner.webm

Changes

Backend (API)

• Added new endpoints for meal planning data:
  • GET /api/family/:id/planning - Get current meal planning
  • GET /api/family/:id/plannings - Get all meal plannings for a family
  • GET /api/family/:id/events - Get meal events for a family
• Improved chat streaming with better error handling and logging
• Added agent validation with proper 404 response when agent not found

Frontend (Web App)

• Router: Added TanStack Router for client-side routing with /family and /planner routes
• Header: Updated with tab navigation (Family / Meal Planner) and contextual CTAs
• Planner Panel: New component with two tabs:
  • Weekly Plan View: Displays current week's meal events with navigation between plannings
  • Calendar View: Monthly calendar showing all meal planning periods with visual status indicators
• Planning Details: Component to display selected planning info and associated events
• Suggested Actions: Context-aware suggestions for family vs planner routes
• Hooks: New usePlannerData hook for fetching planning data with polling support

Core Package

• Exported getAllMealPlanningsByFamilyId and getMealEventsByFamilyId functions

CI/CD

• Added knip check for unused files and dependencies in CI workflow

Documentation

• Added implementation specs for:
  • Calendar view with meal planning widget (specs/meal-planner/calendar-view.md)
  • Non-overlapping meal planning dates (specs/meal-planner/non-overlapping-dates.md)
• Added full implementation plan for planner route (specs/planner-route-implementation.md)
• Updated AGENTS.md with guidance on implementation plans and business logic placement

Key Features

• 📅 Calendar Overview: Visual calendar showing all meal planning periods
• 🎨 Status Indicators: Color-coded planning bars (Draft: Gray, Active: Green, Completed: Blue)
• ⬅️➡️ Navigation: Navigate between months and meal plannings
• 🔗 Planning Selection: Click on a planning to view its details and events
• 🍽️ Weekly View: Day-by-day meal events with meal type icons
• 🔄 Real-time Updates: Polling support for live data updates

Screenshots

Add screenshots here

Testing

• Manual testing of navigation between Family and Planner routes
• Manual testing of calendar view with multiple plannings
• Manual testing of weekly plan navigation
• Manual testing of chat integration with meal-planner-agent

Related Specs

• specs/meal-planner/calendar-view.md
• specs/meal-planner/non-overlapping-dates.md
• specs/planner-route-implementation.md

---

Pull Request opened by Augment Code with guidance from the PR author