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

frontend/public/.well-known/agent-card.json

@@ -0,0 +1,102 @@
+{
+  "name": "Diligence Fitness Rewards",
+  "description": "Self-hosted fitness rewards platform with points-based behavioral economy. Your fitness data stays on your hardware. AI agents can log activities, query progress, manage meal plans, and configure device integrations via MCP.",
+  "url": "{BASE_URL}/mcp",
+  "provider": {
+    "organization": "DiligenceWorks Pte. Ltd.",
+    "url": "https://diligenceworks.online"
+  },
+  "version": "1.0.0",
+  "documentationUrl": "https://github.com/diligenceworks/diligence",
+  "capabilities": {
+    "streaming": true,
+    "pushNotifications": false,
+    "stateTransitionHistory": false
+  },
+  "authentication": {
+    "schemes": ["apiKey"],
+    "credentials": null
+  },
+  "defaultInputModes": ["text/plain", "application/json"],
+  "defaultOutputModes": ["application/json"],
+  "skills": [
+    {
+      "id": "context-status",
+      "name": "Context & Status",
+      "description": "Get full user profile with motivation type (BREQ-2), active program, points status, rewards, and integration connections. Includes get_context (full brief), get_today (daily points/gate), and get_week (weekly summary).",
+      "tags": ["fitness", "status", "profile", "motivation"],
+      "examples": [
+        "How am I doing today?",
+        "What's my weekly progress?",
+        "Show me my fitness dashboard"
+      ]
+    },
+    {
+      "id": "activity-logging",
+      "name": "Activity Logging",
+      "description": "Record workouts, runs, walks, cycling, yoga, or any physical activity. Awards points based on activity type and duration. Supports structured program workouts via program_day parameter.",
+      "tags": ["fitness", "tracking", "points", "workout"],
+      "examples": [
+        "I just did a 30-minute run",
+        "Log my StrongLifts Workout B today",
+        "I did 45 minutes of yoga this morning"
+      ]
+    },
+    {
+      "id": "nutrition-tracking",
+      "name": "Food & Nutrition",
+      "description": "Log food intake with calorie and macro tracking. Search Open Food Facts (4M+ products) and USDA FoodData Central (400K+ research-grade items). Awards points for consistent food logging.",
+      "tags": ["nutrition", "food", "tracking", "barcode", "search"],
+      "examples": [
+        "I had 2 eggs and toast for breakfast",
+        "Search for chicken breast nutrition",
+        "Log a salad for lunch, about 400 calories"
+      ]
+    },
+    {
+      "id": "program-schedule",
+      "name": "Program Schedule",
+      "description": "View today's scheduled workout from the active program including exercises, sets, reps, and weight progression. Shows upcoming workouts and overall program completion percentage.",
+      "tags": ["program", "schedule", "workout", "planning"],
+      "examples": [
+        "What's my workout today?",
+        "Show me this week's program schedule",
+        "How far through my program am I?"
+      ]
+    },
+    {
+      "id": "rewards",
+      "name": "Rewards",
+      "description": "View available rewards with point costs and spend earned points. Rewards are user-configurable (gaming time, screen time, treats, etc.). Points gate must be passed before redemption.",
+      "tags": ["rewards", "points", "spending", "gamification"],
+      "examples": [
+        "What rewards can I unlock?",
+        "Spend points on 30 minutes of gaming",
+        "Do I have enough points for a movie?"
+      ]
+    },
+    {
+      "id": "meal-planning",
+      "name": "Meal Planning",
+      "description": "Create, view, and track AI-generated meal plans. The agent generates plan content; the app stores and tracks compliance. Includes load_meal_plan, get_meal_plan, update_meal_compliance, and get_plan_progress.",
+      "tags": ["nutrition", "meal-plan", "diet", "compliance"],
+      "examples": [
+        "Create a 7-day keto meal plan",
+        "What am I supposed to eat today?",
+        "I followed my breakfast plan",
+        "How's my meal plan compliance?"
+      ]
+    },
+    {
+      "id": "device-integration",
+      "name": "Device Integration",
+      "description": "Configure connections to fitness devices and services (Strava, Polar, Garmin, Fitbit, WHOOP, Oura, Withings). Write-only credential storage — agent can set but never read credentials back.",
+      "tags": ["integration", "strava", "garmin", "fitbit", "sync"],
+      "examples": [
+        "Connect my Strava account",
+        "What integrations are available?",
+        "I want to set up my Garmin"
+      ]
+    }
+  ]
+}

frontend/public/.well-known/skills/diligence-fitness/SKILL.md

@@ -0,0 +1,50 @@
+# Diligence — Agent Skill Definition
+
+## What Is Diligence?
+
+Diligence is a self-hosted fitness rewards platform. Users earn points through fitness activities (workouts, food logging, step goals) and spend them on configurable rewards (gaming time, screen time, etc.). A daily gate keeps rewards locked until enough points are earned. Points reset weekly.
+
+## Architecture
+
+- **Backend:** FastAPI (Python 3.12) + PostgreSQL 16
+- **Frontend:** React 18 + Vite, served by nginx
+- **MCP Connector:** FastMCP (Streamable HTTP/SSE) on port 3001, proxied via nginx at `/mcp`
+- **Deployment:** Docker Compose (4 services: frontend, backend, mcp-connector, fitness-db)
+
+## Connecting
+
+Point your MCP client to:
+- **Development:** `http://localhost:3001/sse`
+- **Production:** `https://your-domain/mcp`
+
+## Available Tools (14)
+
+| Tool | Category | Description |
+|------|----------|-------------|
+| `get_context()` | Status | Full profile, motivation, program, rules, rewards |
+| `get_today(date?)` | Status | Daily points, gate status, activities |
+| `get_week(start_date?)` | Status | Weekly summary, active days |
+| `log_activity(category, title, duration_minutes, ...)` | Activity | Log workout, earn points |
+| `log_food(meal_type, food_name, ...)` | Food | Log food with macros |
+| `search_food(query)` | Food | Search Open Food Facts + USDA |
+| `get_program_schedule(date?)` | Programs | Today's workout from active program |
+| `redeem_reward(reward_name)` | Rewards | Spend points on a reward |
+| `load_meal_plan(name, duration_days, meals, ...)` | Meal Plans | Create a full meal plan |
+| `get_meal_plan(date?)` | Meal Plans | View today's planned meals |
+| `update_meal_compliance(plan_item_id, status, ...)` | Meal Plans | Mark meal followed/skipped |
+| `get_plan_progress(plan_id?)` | Meal Plans | Compliance statistics |
+| `configure_integration(provider, credentials)` | Integrations | Store encrypted credentials (write-only) |
+| `get_integration_status()` | Integrations | Check provider connection status |
+
+## Key Design Decisions
+
+- The **agent generates meal plans** — the app only stores and tracks them. Zero AI API cost.
+- Integration credentials are **write-only through MCP** — agents can set but never read them back.
+- The app collects **BREQ-2 motivation data** during onboarding. Use `get_context()` to read the user's motivation profile and calibrate tone accordingly.
+- Points reset weekly. Each week is a fresh start. No guilt carry-over.
+
+## Source
+
+- **Repository:** https://github.com/diligenceworks/diligence
+- **License:** MIT
+- **Built by:** DiligenceWorks Pte. Ltd. (https://diligenceworks.online)

frontend/src/App.jsx

@@ -10,6 +10,9 @@ import Rewards from './pages/Rewards'
 import Settings from './pages/Settings'
 import Onboarding from './pages/Onboarding'
 import WeekView from './pages/WeekView'
+import Welcome from './pages/Welcome'
+import SettingsIntegrations from './pages/SettingsIntegrations'
+import MealPlan from './pages/MealPlan' 
 import ProgramSearch from './pages/ProgramSearch'
 import ProgramDetail from './pages/ProgramDetail'
 import CatalogDetail from './pages/CatalogDetail'

frontend/src/api.js

@@ -122,6 +122,23 @@ export const api = {
   polarSync: () => request('/integrations/polar/sync', { method: 'POST' }),
   disconnect: (provider) => request(`/integrations/${provider}`, { method: 'DELETE' }),
 
+
+  // Meal Plans (v3)
+  listMealPlans: () => request('/meal-plans'),
+  createMealPlan: (data) => request('/meal-plans', { method: 'POST', body: JSON.stringify(data) }),
+  getMealPlanToday: () => request('/meal-plans/today'),
+  getMealPlan: (id) => request('/meal-plans/' + id),
+  updateMealPlanStatus: (id, status) =>
+    request('/meal-plans/' + id, { method: 'PATCH', body: JSON.stringify({ status }) }),
+  logMealCompliance: (data) =>
+    request('/meal-plans/compliance', { method: 'POST', body: JSON.stringify(data) }),
+  getMealPlanProgress: (id) => request('/meal-plans/' + id + '/progress'),
+
+  // Dynamic Integrations (v3)
+  fullIntegrationStatus: () => request('/integrations/status'),
+  listProviders: () => request('/integrations/providers'),
+  configureIntegration: (provider, credentials) =>
+    request('/integrations/configure', { method: 'POST', body: JSON.stringify({ provider, credentials }) }),
   // Resources
   getResourceRecommendations: () => request('/onboarding/recommendations'),
 };

frontend/src/pages/MealPlan.jsx

@@ -0,0 +1,156 @@
+import { useState, useEffect } from 'react'
+import { api } from '../api'
+
+const MEAL_ICONS = { breakfast: '🌅', lunch: '🌞', dinner: '🌙', snack: '🍎' }
+
+export default function MealPlan() {
+  const [plan, setPlan] = useState(null)
+  const [plans, setPlans] = useState([])
+  const [loading, setLoading] = useState(true)
+  const [compliance, setCompliance] = useState({})  // plan_item_id → status
+
+  useEffect(() => { loadAll() }, [])
+
+  async function loadAll() {
+    try {
+      const [today, all] = await Promise.all([api.getMealPlanToday(), api.listMealPlans()])
+      setPlan(today)
+      setPlans(all)
+    } catch (err) { console.error(err) }
+    finally { setLoading(false) }
+  }
+
+  async function markCompliance(itemId, status) {
+    try {
+      await api.logMealCompliance({ plan_item_id: itemId, status })
+      setCompliance(prev => ({ ...prev, [itemId]: status }))
+    } catch (err) { alert(`Failed: ${err.message}`) }
+  }
+
+  if (loading) return <div className="page"><div className="loading">Loading...</div></div>
+
+  return (
+    <div className="page" style={{ maxWidth: 600, margin: '0 auto' }}>
+      <h1 style={{ fontSize: '1.4rem', fontWeight: 700, marginBottom: 8 }}>Meal Plan</h1>
+
+      {!plan?.active_plan ? (
+        <div style={{
+          background: 'var(--surface-2)', borderRadius: 'var(--r-md)', padding: 32,
+          textAlign: 'center', color: 'var(--text-2)',
+        }}>
+          <div style={{ fontSize: '2rem', marginBottom: 12 }}>🍽️</div>
+          <p style={{ marginBottom: 8 }}>No active meal plan.</p>
+          <p style={{ fontSize: '0.85rem' }}>
+            Ask your AI agent to create one: "Generate a 7-day keto meal plan for me"
+          </p>
+        </div>
+      ) : (
+        <>
+          <div style={{
+            display: 'flex', justifyContent: 'space-between', alignItems: 'center',
+            marginBottom: 20, color: 'var(--text-2)', fontSize: '0.9rem',
+          }}>
+            <span>{plan.active_plan}</span>
+            <span style={{
+              background: 'var(--accent)', color: '#fff', padding: '3px 10px',
+              borderRadius: 20, fontSize: '0.75rem', fontWeight: 600,
+            }}>
+              Day {plan.day} / {plan.duration_days}
+            </span>
+          </div>
+
+          {plan.daily_calories && (
+            <div style={{
+              background: 'var(--surface-2)', borderRadius: 'var(--r-sm)', padding: 12,
+              marginBottom: 16, textAlign: 'center', fontSize: '0.85rem', color: 'var(--text-2)',
+            }}>
+              Target: {plan.daily_calories} cal · {plan.diet_type || 'balanced'}
+            </div>
+          )}
+
+          {plan.meals?.length > 0 ? (
+            plan.meals.map(meal => {
+              const itemStatus = compliance[meal.id]
+              return (
+                <div key={meal.id} style={{
+                  background: 'var(--surface-2)', borderRadius: 'var(--r-md)', padding: 16,
+                  marginBottom: 10,
+                  borderLeft: itemStatus === 'followed' ? '4px solid #4CAF50' :
+                    itemStatus === 'skipped' ? '4px solid #F44336' :
+                    itemStatus === 'substituted' ? '4px solid #FF9800' : '4px solid transparent',
+                }}>
+                  <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start' }}>
+                    <div>
+                      <div style={{ fontSize: '0.75rem', color: 'var(--text-3)', textTransform: 'uppercase', marginBottom: 4 }}>
+                        {MEAL_ICONS[meal.meal_type] || '🍽️'} {meal.meal_type}
+                      </div>
+                      <div style={{ fontWeight: 600, marginBottom: 4 }}>{meal.food_name}</div>
+                      {meal.description && (
+                        <div style={{ fontSize: '0.85rem', color: 'var(--text-2)' }}>{meal.description}</div>
+                      )}
+                    </div>
+                    {meal.calories && (
+                      <div style={{ fontSize: '0.85rem', fontWeight: 600, color: 'var(--text-2)', flexShrink: 0, marginLeft: 12 }}>
+                        {meal.calories} cal
+                      </div>
+                    )}
+                  </div>
+
+                  {meal.protein_g && (
+                    <div style={{ fontSize: '0.75rem', color: 'var(--text-3)', marginTop: 6 }}>
+                      P: {meal.protein_g}g · C: {meal.carbs_g}g · F: {meal.fat_g}g
+                    </div>
+                  )}
+
+                  {!itemStatus && (
+                    <div style={{ display: 'flex', gap: 6, marginTop: 10 }}>
+                      {['followed', 'substituted', 'skipped'].map(s => (
+                        <button key={s} onClick={() => markCompliance(meal.id, s)}
+                          style={{
+                            background: 'transparent', border: '1px solid var(--border)',
+                            padding: '4px 12px', borderRadius: 'var(--r-sm)', fontSize: '0.75rem',
+                            cursor: 'pointer', color: 'var(--text-2)', textTransform: 'capitalize',
+                          }}>
+                          {s === 'followed' ? '✅' : s === 'skipped' ? '⏭️' : '🔄'} {s}
+                        </button>
+                      ))}
+                    </div>
+                  )}
+                </div>
+              )
+            })
+          ) : (
+            <p style={{ color: 'var(--text-2)', textAlign: 'center' }}>{plan.message || 'No meals for today.'}</p>
+          )}
+        </>
+      )}
+
+      {plans.length > 0 && (
+        <div style={{ marginTop: 32 }}>
+          <h2 style={{ fontSize: '1.1rem', fontWeight: 600, marginBottom: 12 }}>All Plans</h2>
+          {plans.map(p => (
+            <div key={p.id} style={{
+              display: 'flex', justifyContent: 'space-between', alignItems: 'center',
+              padding: '10px 0', borderBottom: '1px solid var(--border)',
+            }}>
+              <div>
+                <div style={{ fontWeight: 500 }}>{p.name}</div>
+                <div style={{ fontSize: '0.8rem', color: 'var(--text-3)' }}>
+                  {p.diet_type} · {p.duration_days} days · started {p.start_date}
+                </div>
+              </div>
+              <span style={{
+                fontSize: '0.75rem', padding: '2px 8px', borderRadius: 12,
+                background: p.status === 'active' ? '#4CAF5022' : '#9E9E9E22',
+                color: p.status === 'active' ? '#4CAF50' : '#9E9E9E',
+                fontWeight: 600,
+              }}>
+                {p.status}
+              </span>
+            </div>
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}

frontend/src/pages/SettingsIntegrations.jsx

@@ -0,0 +1,137 @@
+import { useState, useEffect } from 'react'
+import { api } from '../api'
+
+const STATUS_COLORS = {
+  connected: '#4CAF50',
+  configured: '#FF9800',
+  not_configured: '#9E9E9E',
+}
+
+const STATUS_LABELS = {
+  connected: 'Connected',
+  configured: 'Configured',
+  not_configured: 'Not configured',
+}
+
+export default function SettingsIntegrations() {
+  const [providers, setProviders] = useState({})
+  const [status, setStatus] = useState({})
+  const [loading, setLoading] = useState(true)
+  const [configuring, setConfiguring] = useState(null)  // provider key being configured
+  const [formData, setFormData] = useState({})
+  const [saving, setSaving] = useState(false)
+
+  useEffect(() => { loadAll() }, [])
+
+  async function loadAll() {
+    try {
+      const [p, s] = await Promise.all([api.listProviders(), api.fullIntegrationStatus()])
+      setProviders(p)
+      setStatus(s)
+    } catch (err) { console.error(err) }
+    finally { setLoading(false) }
+  }
+
+  function startConfigure(key) {
+    setConfiguring(key)
+    const fields = providers[key]?.fields || []
+    setFormData(Object.fromEntries(fields.map(f => [f, ''])))
+  }
+
+  async function handleSave(key) {
+    setSaving(true)
+    try {
+      await api.configureIntegration(key, formData)
+      setConfiguring(null)
+      await loadAll()
+    } catch (err) { alert(`Failed: ${err.message}`) }
+    finally { setSaving(false) }
+  }
+
+  if (loading) return <div className="page"><div className="loading">Loading...</div></div>
+
+  return (
+    <div className="page" style={{ maxWidth: 700, margin: '0 auto' }}>
+      <h1 style={{ fontSize: '1.4rem', fontWeight: 700, marginBottom: 24 }}>Integrations</h1>
+      <p style={{ color: 'var(--text-2)', marginBottom: 24, fontSize: '0.9rem' }}>
+        Configure your fitness devices and services. Credentials are encrypted and stored locally — never sent to any external server.
+      </p>
+
+      {Object.entries(providers).map(([key, info]) => (
+        <div key={key} style={{
+          background: 'var(--surface-2)', borderRadius: 'var(--r-md)', padding: 20, marginBottom: 12,
+          border: status[key] === 'connected' ? '2px solid var(--accent)' : '1px solid var(--border)',
+        }}>
+          <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 8 }}>
+            <strong style={{ fontSize: '1rem' }}>{info.name}</strong>
+            <span style={{
+              fontSize: '0.75rem', padding: '3px 10px', borderRadius: 20, fontWeight: 600,
+              background: STATUS_COLORS[status[key] || 'not_configured'] + '22',
+              color: STATUS_COLORS[status[key] || 'not_configured'],
+            }}>
+              {STATUS_LABELS[status[key] || 'not_configured']}
+            </span>
+          </div>
+
+          <p style={{ color: 'var(--text-2)', fontSize: '0.85rem', margin: '0 0 12px' }}>
+            {info.help_text}
+          </p>
+
+          {info.help_url && (
+            <a href={info.help_url} target="_blank" rel="noopener noreferrer"
+              style={{ fontSize: '0.8rem', color: 'var(--accent)' }}>
+              Developer portal →
+            </a>
+          )}
+
+          {configuring === key ? (
+            <div style={{ marginTop: 12, padding: 16, background: 'var(--surface)', borderRadius: 'var(--r-sm)' }}>
+              {info.fields.map(field => (
+                <div key={field} style={{ marginBottom: 10 }}>
+                  <label style={{ fontSize: '0.8rem', fontWeight: 600, display: 'block', marginBottom: 4 }}>
+                    {field.replace(/_/g, ' ')}
+                  </label>
+                  <input
+                    type={field.includes('secret') || field.includes('token') || field.includes('key') ? 'password' : 'text'}
+                    value={formData[field] || ''}
+                    onChange={e => setFormData({ ...formData, [field]: e.target.value })}
+                    style={{
+                      width: '100%', padding: '8px 12px', borderRadius: 'var(--r-sm)',
+                      border: '1px solid var(--border)', fontSize: '0.9rem', boxSizing: 'border-box',
+                    }}
+                    placeholder={`Enter ${field.replace(/_/g, ' ')}`}
+                  />
+                </div>
+              ))}
+              <div style={{ display: 'flex', gap: 8, marginTop: 8 }}>
+                <button onClick={() => handleSave(key)} disabled={saving}
+                  style={{
+                    background: 'var(--accent)', color: '#fff', border: 'none',
+                    padding: '8px 20px', borderRadius: 'var(--r-sm)', cursor: 'pointer', fontWeight: 600,
+                  }}>
+                  {saving ? 'Saving...' : 'Save'}
+                </button>
+                <button onClick={() => setConfiguring(null)}
+                  style={{
+                    background: 'transparent', color: 'var(--text-2)', border: '1px solid var(--border)',
+                    padding: '8px 20px', borderRadius: 'var(--r-sm)', cursor: 'pointer',
+                  }}>
+                  Cancel
+                </button>
+              </div>
+            </div>
+          ) : (
+            <button onClick={() => startConfigure(key)}
+              style={{
+                marginTop: 8, background: 'transparent', color: 'var(--accent)',
+                border: '1px solid var(--accent)', padding: '6px 16px', borderRadius: 'var(--r-sm)',
+                cursor: 'pointer', fontSize: '0.85rem', fontWeight: 600,
+              }}>
+              {status[key] === 'not_configured' ? 'Configure' : 'Reconfigure'}
+            </button>
+          )}
+        </div>
+      ))}
+    </div>
+  )
+}

frontend/src/pages/Welcome.jsx

@@ -0,0 +1,61 @@
+import { useNavigate } from 'react-router-dom'
+
+export default function Welcome() {
+  const navigate = useNavigate()
+
+  return (
+    <div className="page" style={{ maxWidth: 600, margin: '0 auto', padding: '40px 20px', textAlign: 'center' }}>
+      <div style={{ fontSize: '3rem', marginBottom: 16 }}>💪</div>
+      <h1 style={{ fontSize: '1.8rem', fontWeight: 700, marginBottom: 8 }}>Earn Before You Spend</h1>
+      <p style={{ color: 'var(--text-2)', fontSize: '1rem', lineHeight: 1.6, marginBottom: 32 }}>
+        This app runs on a simple idea: you earn points by doing healthy things
+        (workouts, logging meals, hitting step goals), and you spend points on
+        guilty pleasures you configure yourself.
+      </p>
+
+      <div style={{ background: 'var(--surface-2)', borderRadius: 'var(--r-md)', padding: 24, marginBottom: 24, textAlign: 'left' }}>
+        <div style={{ display: 'flex', gap: 16, marginBottom: 16 }}>
+          <span style={{ fontSize: '1.5rem' }}>🔒</span>
+          <div>
+            <strong>Daily Gate</strong>
+            <p style={{ color: 'var(--text-2)', margin: '4px 0 0', fontSize: '0.9rem' }}>
+              Until you earn enough points today, your rewards stay locked. Hit your target, and the gate opens.
+            </p>
+          </div>
+        </div>
+        <div style={{ display: 'flex', gap: 16, marginBottom: 16 }}>
+          <span style={{ fontSize: '1.5rem' }}>🎮</span>
+          <div>
+            <strong>Your Rules</strong>
+            <p style={{ color: 'var(--text-2)', margin: '4px 0 0', fontSize: '0.9rem' }}>
+              You set the rewards — gaming time, takeout, screen time, whatever you want. You hold yourself accountable.
+            </p>
+          </div>
+        </div>
+        <div style={{ display: 'flex', gap: 16 }}>
+          <span style={{ fontSize: '1.5rem' }}>🤖</span>
+          <div>
+            <strong>AI Agent (Optional)</strong>
+            <p style={{ color: 'var(--text-2)', margin: '4px 0 0', fontSize: '0.9rem' }}>
+              Connect an AI agent to log activities by voice, get nudged when you're behind, and have a fitness companion that knows your goals.
+            </p>
+          </div>
+        </div>
+      </div>
+
+      <button
+        onClick={() => navigate('/register')}
+        style={{
+          background: 'var(--accent)', color: '#fff', border: 'none', borderRadius: 'var(--r-sm)',
+          padding: '14px 32px', fontSize: '1rem', fontWeight: 600, cursor: 'pointer', width: '100%',
+        }}
+      >
+        Get Started
+      </button>
+
+      <p style={{ color: 'var(--text-3)', fontSize: '0.8rem', marginTop: 16 }}>
+        Points reset weekly. Each week is a fresh start.
+      </p>
+    </div>
+  )
+}