PPT TypeSpec

docs/api/typespec/ is the contract source-of-truth.

Pipeline (two steps):

1. cd docs/api/typespec && npx tsp compile . — compiles the TypeSpec into the OpenAPI spec at docs/api/generated/openapi.yaml (per tspconfig.yaml's emitter-output-dir: {project-root}/../generated). This step is what regenerates the spec; the justfile recipe doesn't run it.
2. just generate-api — wraps pnpm generate-api + pnpm generate-reality-api inside frontend/, which consumes docs/api/generated/openapi.yaml to regenerate the two TS API clients (@ppt/api-client, @ppt/reality-api-client).

Run both. Step 1 alone leaves the TS clients stale; step 2 alone leaves the OpenAPI YAML stale. Backend handlers consume the spec via utoipa annotations.

When to invoke