Release provider-free paced.coach v2.2.0

[leonzzz435]

paced.coach v2.2.0 — local-first coaching without a wearable prerequisite

paced.coach now turns athlete-declared context into one continuous coaching product: profile and race goals → season strategy → 28-day execution calendar → plan-aware coach chat.

A wearable is not the product and no training-data connector ships in v2.2.0. The baseline path needs one OpenAI API key plus the athlete's own goals, history, availability, constraints, and ongoing feedback.

Training cockpit	Schema-v3 execution plan

Product story	Plan-aware coach

What changed

• One durable Head Coach identity owns initial planning, clarification/resume, material replanning, and coach turns.
• Semantic run profiles select task authority, model behavior, reasoning effort, tools, and structured contracts.
• LangGraph checkpoints are persisted in PostgreSQL; canonical season/execution artifacts are committed atomically to domain tables.
• Owner-scoped advisory locks, answer-bound idempotency, durable job lifecycle, dispatch recovery, and bounded LLM self-repair protect the pipeline.
• Schema-v3 season and 28-day artifacts render through versioned React components: compact calendar first, rich rationale and decision context on demand.
• Strava, WHOOP, hosted auth, payments, provider imports, and hosted deployment assumptions are removed from this release.
• Public demo fixtures and screenshots are synthetic, provider-free, and contain no wearable-derived KPIs.
• Next.js and frontend transitive dependencies are patched; the clean install reports 0 npm vulnerabilities.
• Local services remain loopback-bound and the public tree is covered by tracked-file plus full-history secret scanning.

Source-of-ownership architecture

flowchart LR
    UI["Next.js local UI<br/>profile · calendar · coach"] --> API["FastAPI<br/>owner-scoped commands"]
    API --> DB[("PostgreSQL<br/>canonical athlete + plan state")]
    API --> Queue["Redis / Celery<br/>durable dispatch"]
    Queue --> HC["LangGraph Head Coach<br/>one identity + run profiles"]
    HC --> OpenAI["OpenAI API<br/>reasoning + structured output"]
    HC --> Checkpoints[("PostgreSQL<br/>resumable checkpoints")]
    HC --> DB
    DB --> UI

Loading

Deliberate boundaries

• No automatic activity, sleep, HRV, recovery, compliance, or readiness claims. The coach only knows what the athlete declares and what exists in the saved plan.
• Weekly recap/provider-sync automations are not part of v2.2.0. Plan-aware coach chat remains fully available.
• This is a single-owner, no-login local app. Do not expose it directly to a public network.
• OpenAI receives the context needed for model calls. LangSmith tracing is optional and is an additional intentional network path.
• Coaching is not medical diagnosis or treatment.

Verification

Release candidate: 14a831fbcf98208d5fe778e6194670e6638b84fa

• Python: Ruff clean; mypy clean; 407 passed, 6 skipped.
• Frontend: lint, type-check, contract tests, and production build clean.
• Fresh installs: locked Pixi install clean; npm ci clean; npm audit reports 0 vulnerabilities.
• PostgreSQL release tests: checkpoint restart, worker lock, plan-generation lock, atomic/idempotent commit, and 001→002 migration passed against PostgreSQL 16.
• Browser: sanitized desktop + 390×844 mobile passes for hero/dashboard/plan/coach; no console errors, no page-level horizontal overflow, no core touch target below 44 px; 200% zoom has no page-level overflow.
• Security: official Gitleaks v8.30.1 scanned the tracked release tree and isolated history with redaction; no secrets or forbidden private/generated data found.
• GitHub Actions: exact-SHA CI run 24 passed.

Migration / setup

Read the local setup guide, AI coaching limitations, and v2.2.0 release notes.

This PR remains a draft until the maintainer reviews it. Nothing here merges or publishes the release automatically.

---

🤖 Generated with GPT-5.6 via Codex