Skip to content

Project Management

What is this?

The central mission control for ChatKcal, tracking the high-level roadmap and active development tasks according to the project protocol.

Workflow Protocol

Plan-First Protocol (v2.0)

  1. Define (Work Log / Daily Log)
  2. Plan (Context & Approach)
  3. STOP (User Approval: "Shall I proceed?")
  4. Execute (Implement)
  5. Verify & Close (Test, update Architecture Docs, & Close)

Master Plan & Roadmap

Phase 1: Foundation (Stable)

Goal: Robust technical architecture and end-to-end AI logging capability.

  • [Pre-Log] Core Architecture: AppSync + DynamoDB + Cognito.
  • [Pre-Log] Basic Tracking: Add/Get meals via AI.
  • [2025-12-30] Documentation & PM Setup: Setup MkDocs, protocol, and custom PM skill. Status View Log
  • [2026-01-01] Layered Testing Strategy: Unit (Vitest) and Integration (RTL/Playwright). Status View Log
  • [2026-01-03] Data Standardisation: camelCase, Floats, and Version 4 schema. Status View Log
  • [2026-01-05] TypeScript Migration: Full type safety across the frontend. Status View Log
  • [2026-01-06] Advanced Nutrient Tracking: Support for Fiber, Sodium, and custom nutrients. Status View Log
  • [2026-01-17] Protocol v2.0: Implementation of rolling logs, STOP trigger, and state vs. transition rules. Status View Log
Completed Phase 1 History
  • [2026-01-17] Documentation Audit: Audit doc structure and establish healthcheck. View Log
  • [2026-01-10] Prompt Engineering Uplift: Refine instructions and iPhone copy-paste. View Log
  • [2026-01-05] Refactor Codebase (Post-TS): Polish types, remove any. View Log
  • [2026-01-05] Date Selector in Menu: Log for past/future dates. View Log
  • [2026-01-05] Fix Dev Env: Connect Dev App to Dev Backend. View Log
  • [2026-01-05] Fix Delete Resolver: Fix DynamoDB UpdateExpression. View Log
  • [2026-01-04] Fix API Meal Service: Dashboard TypeError fix. View Log
  • [2026-01-01] Targets Persistence: Store/retrieve calorie targets. View Log
  • [2025-12-30] Offline Capability: (Moved to Phase 2, but started here). View Log

Phase 2: Onboarding & First User Experience (Current Focus)

Goal: Make the journey from "Zero to First Logged Meal" frictionless and delightful.

  • [2026-01-17] Guest Mode Architecture: Design technical support for offline/unauthenticated logging. Status View Log
  • Guest Mode (Backend): Implement importGuestHistory Lambda & Resolver. Status View Log
  • [2026-01-18] Shared Zod Schema: Implement @chatkcal/shared workspace for validation. Status View Log
  • Guest Mode (Auth State): Implement GUEST_USER and unauthenticated dashboard access. Status View Log
  • Guest Mode (Frontend): Implement LocalMealService & Service Injection. Status View Log
  • Guest Mode (QA): Initial Layer 4 tests for Guest Mode. Status View Log
  • QA: Layer 4 Network Integration: Comprehensive Playwright integration tests with network mocking. Status View Log
  • Guest Mode (Sync): Implement Data Promotion logic (Sync Local Guest data to Cloud upon sign-up). Status View Log
  • Observability Uplift: Implement comprehensive logging and tracing for state transitions. Status View Log (Issue: 2512_genai_food_tracking-ydp)
  • [2025-12-30] Offline Capability: Initial PWA + React Query implementation. Status View Log
  • API Access & Cost Quotas: Implement Personal Access Tokens (PATs) and daily usage limits. Status View Log (Issue: 2512_genai_food_tracking-cs3; follow-up: 2512_genai_food_tracking-v3u)
  • Fix: Dev Logging Suppression: Ensure logs are visible in dev deployments. Status View Log
  • [2026-01-14] Progress Bar Contrast: Fix text readability when exceeding daily targets. Status View Log
  • [2026-01-08] UI Polish & Bug Fixes: Fix "Flash of Zero" and sticky expansion bugs. Status View Log
  • First-Log Experience Design: Optimise the flow from deep-link or manual entry to the first "Aha!" moment. Status View Log
  • [2026-02-12] Visual Hierarchy (Calorie Focus): Adjust dashboard to emphasise calories as the primary metric. Status View Log (Issue: 2512_genai_food_tracking-1kb)

Phase 3: Core Utility (The "Loop")

Goal: Close the loop between action (eating) and outcome (health).

  • Data Aggregation: Implement DaySummary logic (DynamoDB TransactWriteItems).
  • Design: Timezone-Resilient Aggregation: Define strategy for keeping Day Summaries in sync when users change timezones (re-aggregation).
  • Outcome Tracking: Weight logging and trend smoothing.
  • History: "Unique Days" calendar and detailed history browsing.

Phase 4: Friction Zero (Retention)

Goal: Make logging faster than thought.

  • [2026-02-25] Quick Add (Local Cache Recents): One-tap re-log for previously logged foods using existing local cache for maximum speed. Status View Log (Issue: 2512_genai_food_tracking-52v)
  • Recents & Favorites: One-tap logging for habitual meals.
  • Log in Advance & Calendar Experience: Support logging future meals and improve calendar navigation.
  • Smart Reminders: Context-aware notifications.
  • State Persistence: Design strategy for preserving UI state (modals, date selection) across reloads.

Phase 5: Cross-Platform & Native

Goal: Native presence and device integration.

  • Mobile Apps: Capacitor wrapper for iOS/Android.
  • Deep Integration: HealthKit/Google Fit sync, Haptics, Widgets.