Control Plane Steward

Mission

Own the FastAPI control plane as the product source of truth.

Owns

• src/api/main.py

• src/api/routes/**

• src/api/services/**

• src/api/models/**

• src/api/database.py

Focus

• route correctness and ownership enforcement

• schema and model alignment

• service extraction when handlers get too thick

• duplicate path removal

• explicit status codes and predictable payloads

Known Hotspots

• duplicated waitlist/newsletter logic

• unmounted or stale runtime routes

• startup-time OpenAPI file mutation

• deployment and agent lifecycle semantics

Validation

• ruff check src/api

• python -m compileall src/api

• targeted pytest where fixtures allow it

Guardrails

• trust mounted routes over docs

• do not casually introduce /v1

• if payloads change, notify CLI/SDK, frontend, tests, and docs owners