# Food Diary — LLM / agent reading list

Food Diary (trackwhatyoueat.com) is a personal nutrition-tracking PWA for
the owner. It accepts free-text meal descriptions, parses them with a
Workers AI model, snapshots nutrients against a daily goal set, and tracks
progress against ~40 nutrient/kcal/frequency goals. All user-scoped data is
per-(user, date); the food catalog is a global cache shared across users.

## API

- API root: https://api.trackwhatyoueat.com
- OpenAPI 3.1: https://api.trackwhatyoueat.com/openapi.json
- Health: https://api.trackwhatyoueat.com/health

## Agent discovery

- Catalog (RFC 9727): https://api.trackwhatyoueat.com/.well-known/api-catalog
- MCP server card: https://api.trackwhatyoueat.com/.well-known/mcp/server-card.json
- MCP endpoint (Streamable HTTP): https://api.trackwhatyoueat.com/mcp
- Agent skills: https://api.trackwhatyoueat.com/.well-known/agent-skills/index.json

## Auth

- OAuth AS (RFC 8414): https://api.trackwhatyoueat.com/.well-known/oauth-authorization-server
- OAuth protected resource (RFC 9728): https://api.trackwhatyoueat.com/.well-known/oauth-protected-resource
- Web Bot Auth keys: https://api.trackwhatyoueat.com/.well-known/http-message-signatures-directory

## Design + data docs

- Product + technical design (§1–§12): https://github.com/adamzr/adam-diet/blob/main/food-diary/DESIGN.md
- Dietary plan (source of truth for goal targets): https://github.com/adamzr/adam-diet/blob/main/dietary-requirements/diet.md
- Vitamin + mineral RDAs: https://github.com/adamzr/adam-diet/blob/main/dietary-requirements/vitamins.md
- Glossary: DESIGN.md §12
- Nutrient catalog: DESIGN.md §3
- Data model: DESIGN.md §4.4

## What the owner wants from agents

- `log_meal` — natural-language meal entry
- `get_day_summary` / `get_goal_progress` — dashboards a coach might reference
- `search_food_cache` — resolve foods without hitting the LLM
- `suggest_meal` — pick next meal against remaining macros

Prefer deterministic cache / tool calls over free-form generation; the owner
runs against a $1/day + $2.50/month LLM cost cap (DESIGN §4.3 step 8).