This directory contains all project documentation organized by category.
- Planning - Active feature plans and strategies
- Features - Implemented feature documentation
- Implementation - Setup and configuration guides
- Security - Authentication and security architecture
- Testing - Test strategies and plans
- Reviews - Code review reports
- Archive - Historical documentation (completed work)
Active feature planning and architectural strategy documents.
| Document | Description | Status |
|---|---|---|
| TypeScript Migration Plan | Step-by-step plan for mobile app TS migration | ✅ Active |
| OpenAI Proxy Migration Plan | Migrate client-side OpenAI calls to Edge Function | 🔄 In Progress (Phase 0) |
| Canonical Foods Strategy | Parent-child food hierarchy with vector search | ✅ Active (6,368 canonicals created) |
| Fitness Tracker Strategy | Fitbit, Whoop, Oura integration architecture | ✅ Active |
| CGM Integration | Continuous glucose monitoring (Dexcom, Libre) | 📋 Planning |
| Barcode SKU Architecture | Product vs SKU separation design | ✅ Implemented |
| Meal Template Learning | AI-powered meal template system | 🔄 In Progress |
| Vision Camera Migration | Migration from expo-camera to react-native-vision-camera | ✅ Implemented |
| Food Search Improvement | Overall food search vision (large doc) | ✅ Active |
| Food Quantity Units | Unit extraction and normalization | 🔄 In Progress |
| Sync Functions Technical Debt | Edge function refactoring and improvements | ✅ Complete |
| Blood Panels Strategy | Blood panels & medical test results feature plan | 📋 Draft |
| Experiment Pivot Plan | Experiment-centric app pivot — full implementation plan | 📋 Planning |
| Rate Limit Gaps | Rate limiting analysis and gap identification | ✅ Active |
| Integration Test Plan | Mobile integration test strategy (Phases 1-4) | 🔄 Phase 4 In Progress |
| Phase 4 E2E Test Spec | E2E test implementation details | 🔄 In Progress (3/13 passing) |
| Unit Test Coverage Plan | Comprehensive unit test coverage roadmap | ✅ Active |
| Insight Engine v3 | Dynamic metric discovery, auto-blacklisting, intraday analyzers | 📋 Planning |
| Timezone Strategy | Cross-system timezone normalization for all data sources | 📋 Planning (prerequisite for Insight v3) |
| Unified Experiment Analysis | Single analysis engine, diagnostics, admin dashboard | ✅ Complete |
| Personalized Health Snapshot | Replace population ranges with personal baselines, cycle-aware scoring, trend direction | ✅ Complete |
| Integration Tests: Health Snapshot | Integration test plan for personalized health snapshot wiring | ✅ Complete |
Documentation for implemented features.
| Document | Description |
|---|---|
| Product Search Fix | Registry priority fix for product search |
Setup and configuration documentation.
| Document | Description |
|---|---|
| OpenAI Proxy Setup Guide | Supabase secrets and migration setup for OpenAI proxy |
| Webhook Setup | Comprehensive webhook configuration guide |
| Sync All Devices Guide | Multi-device orchestration implementation |
| Phase 2 Implementation | Edge function improvements summary |
| Monitoring System Analysis | System monitoring architecture |
| Task 5 Completion Report | Task 5 implementation summary |
Authentication and security architecture.
| Document | Description |
|---|---|
| Auth Guard Strategy | Authentication flow and RLS protection |
Test strategies and plans.
| Document | Description | Status |
|---|---|---|
| Test Plan | Voice/photo/text logging test strategy | ✅ Active |
| Comprehensive Testing Strategy | Overall testing approach for mobile and edge functions | ✅ Active |
| Edge Functions Testing Plan | Edge function test implementation phases | ✅ Complete (86 tests) |
| Jest Performance Optimization | Jest open handles fix and 96% performance improvement | ✅ Complete |
| Pre-commit Performance Analysis | Pre-commit hook optimization analysis | ✅ Complete |
| Phase 1: Transformers Complete | Unit tests for WHOOP/Fitbit transformers | ✅ Complete (44 tests) |
| Phase 2: Tests Fixed | API client integration tests | ✅ Complete (11 tests) |
| Phase 4: Contract Tests | Schema contract validation tests | ✅ Complete (19 tests) |
Comprehensive reports and analyses of codebase health and specific areas.
| Document | Scope | Date |
|---|---|---|
| Initial Codebase Review | Overall project architecture and health | 2026-02-05 |
Historical documentation for completed work, migrations, and fixes.
- Expo Audio Migration - Completed Jan 2026
- Voice Events Rename - Table rename migration
- Home JSX RLS Fix - RLS error prevention
- Session Sync Fix - Session synchronization
- Whoop OAuth Scope - Token refresh fix (Feb 2026)
- Gemini Zero Loop - Schema type fix
- Auth Guard Implementation - Auth implementation
- RLS Test Results - RLS fix validation
- Audit Record Error - Error diagnosis and resolution
- Logging Test Plan - Logging system tests
- Logging Test Summary - Test results
- Coverage Summary - Test coverage snapshot
- Logging Infrastructure - Logging setup
- Canonical Pipeline SQL - Pipeline setup SQL
- Canonical Alternative Approach - Alternative implementation
- Canonical Connection Help - DB connection guide
- CLAUDE.md - Main project guide for AI assistants (root level)
- Mobile README - Mobile app specific documentation
- Canonical Pipeline - Canonical food pipeline scripts
- USDA Import - USDA data import scripts
Yes! Here's how:
- Planning Docs - Provide architectural context and design decisions
- Feature Docs - Explain implemented features and their rationale
- Implementation Guides - Detailed setup instructions prevent mistakes
- Security Docs - Critical for understanding auth flow and RLS policies
- Archive/Fixes - Useful for understanding past issues and solutions
- Testing Docs - Help understand test coverage and strategy
- Point-in-time snapshots (test coverage summaries)
- Completed migrations (only needed for historical reference)
- ✅ Keep: All planning, features, implementation, security, testing docs
⚠️ Archive: Completed fixes and migrations (keep for reference, not active use)- ❌ Remove: Duplicate information or outdated snapshots (consider consolidating)
The current structure makes it easy for AI assistants to find relevant context without being overwhelmed by historical/completed work.
When adding new documentation:
- Active plans →
/docs/planning/ - Implemented features →
/docs/features/ - Setup guides →
/docs/implementation/ - Completed fixes/migrations →
/docs/archive/ - Keep
CLAUDE.mdin root as the main AI assistant guide
Update this README when adding new documentation.