Memory Page API v1

Memory Page API v1 gives the Flutter memories tab a page-level read contract while preserving the existing memory create/get/delete endpoints.

Endpoints

• GET /api/families/:familyId/memories/overview

  • Query: limit, today=YYYY-MM-DD
  • Response: { recent, onThisDay, summary, generatedAt }
  • recent is newest-first by memory date.
  • onThisDay ignores year and matches the month/day of today.
  • summary includes total, thisWeek, withPhoto, and fromChat.

• GET /api/families/:familyId/memories/search

  • Query: q, limit
  • Response: { items }
  • Searches title, description, and location. Empty q returns an empty list.

Existing Endpoints Kept

• GET /api/families/:familyId/memories
• POST /api/families/:familyId/memories
• GET /api/families/:familyId/memories/:memoryId
• POST /api/families/:familyId/memories/from-chat
• DELETE /api/families/:familyId/memories/:memoryId

Flutter Bridge

EngineMemoryRepository.memoriesStream reads memories/overview and uses its recent array. onThisDayStream reads the same page API and uses onThisDay, replacing the older client-side filter.