validate

name	validate
description	Run the repository quality gate and smoke-test the API. Use after Python changes or for "validate changes", "run checks", or "test the API".

Validate Changes

From the repository root run the authoritative quality gate:

uv run poe check

It runs static checks, package installation smoke testing, and all test suites. New files must be staged before prek --all-files can inspect them; stage only files belonging to the current task.

After Python application changes, start a fresh API process on 127.0.0.1:8000 and request:

• /health (200)
• /ready (200 once dependencies are ready)
• /openapi.json (200 and valid JSON)

Track the exact process ID and always terminate that process during cleanup. Do not kill unrelated listeners. Report startup logs if any endpoint fails.

For workflow changes that add a Python command, also run that exact command with only the environment variables supplied by the workflow. Do not assume the devcontainer's environment is available in CI.

Fix root causes and rerun the failed gate. Do not suppress lint or type errors.