Deliver Step 9: agent-card.json, SKILL.md, USDA lookup, integrations dynamic config, Welcome/Integrations/MealPlan pages, API methods, README, routes

README.md

@@ -1,42 +1,61 @@
-# Fitness Rewards
+# Diligence — Self-Hosted Fitness Rewards with AI Agent Support
 
-Personal fitness web app with a points-based behavioral economy. Earn points through fitness activities, spend them on real-world rewards.
+Points-based fitness accountability app. Log workouts and food, earn points, unlock rewards. Connect any AI agent via MCP for logging, coaching, and meal planning. Self-hosted, open source, zero cloud dependencies.
 
-## Stack
-- **Backend**: FastAPI + PostgreSQL + SQLAlchemy (async)
-- **Frontend**: React + Vite
-- **Deployment**: Docker Compose via Coolify
+Built by [DiligenceWorks](https://diligenceworks.online).
 
-## Quick Start (Development)
+## Quick Start
 
 ```bash
-# Backend
-cd backend
-python -m venv .venv && source .venv/bin/activate
-pip install -r requirements.txt
-uvicorn app.main:app --reload
-
-# Frontend
-cd frontend
-npm install
-npm run dev
+git clone https://github.com/diligenceworks/diligence
+cd diligence
+./setup.sh
+docker compose up -d
 ```
 
-## Deploy (Production)
-
-```bash
-cp .env.example .env
-# Edit .env with real secrets
-docker compose up -d --build
-```
+Open http://localhost and create your account.
 
 ## Features
-- Science-based onboarding (PAR-Q+, TTM Stages of Change, BREQ-2)
-- Points economy with configurable earning rules and rewards
-- Daily gate: earn your daily minimum before unlocking rewards
-- Weekly targets with reset
-- Strava + Polar integration (OAuth 2.0)
-- Open Food Facts barcode scanning for food logging
-- Curated external fitness resources (Darebee, StrongLifts, YouTube)
-- 90-day program commitment tracking
-- Mobile-first PWA design
+
+- **Points economy** — earn from workouts, food logging, step goals. Daily gate locks rewards until you earn enough. Weekly reset.
+- **Science-based onboarding** — PAR-Q+ safety screening, TTM stages of change, BREQ-2 motivation profiling.
+- **AI agent integration** — 14 MCP tools for logging, coaching, meal planning, and device configuration.
+- **Meal plans** — AI-generated plans with compliance tracking and points integration.
+- **Activity sync** — Strava, Polar (OAuth 2.0). Garmin, Fitbit, Withings, WHOOP, Oura configurable in-app.
+- **Food search** — Open Food Facts (4M+ products) + USDA FoodData Central (400K+ research-grade).
+- **Program tracking** — 90-day structured programs (StrongLifts, Darebee, etc.) with day-by-day progression.
+- **Configurable rewards** — you define what's worth earning. Gaming time, screen time, treats — your rules.
+
+## Connecting an AI Agent
+
+Point your agent's MCP config to `http://localhost:3001/sse` (development) or `https://your-domain/mcp` (production behind reverse proxy).
+
+Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible agent.
+
+Copy the contents of [AGENT_GUIDE.md](AGENT_GUIDE.md) into your agent's system instructions for motivation-aware coaching.
+
+## Configuring Integrations
+
+All integrations are configured through the app UI (Settings → Integrations) or through your AI agent. No `.env` file editing or container restarts needed.
+
+## Data Sovereignty
+
+Diligence is self-hosted software. Your data never leaves your server. No cloud dependency, no vendor lock-in, no telemetry. MIT license — fork it, modify it, keep it forever.
+
+Your fitness data — heart rate, body composition, food intake, GPS traces — is biometric data that deserves sovereignty.
+
+## Stack
+
+- Python 3.12, FastAPI, SQLAlchemy
+- React 18, Vite
+- PostgreSQL 16
+- FastMCP (Streamable HTTP/SSE)
+- Docker Compose
+
+## Contributing
+
+Contributions welcome. Open an issue to discuss before submitting a PR.
+
+## License
+
+MIT — see [LICENSE](LICENSE).