sched-json-types

name	sched-json-types
description	Maintains TypedDict and JSON-shaped type definitions for API and config payloads. Use when editing json_types.py or aligning wire formats with Pydantic models and OpenAPI.

JSON types (json_types.py)

Edit locations

• src/scheduler/json_types.py (primary)
• Related shape sources: src/scheduler/config.py, src/scheduler/server.py

Role

• Central place for JSON structure typing used across parsing, API, and docs.
• Keep TypedDict / aliases aligned with Pydantic models in config.py and FastAPI schemas.

Practices

• Prefer one source of truth: when possible, derive or mirror shapes from Pydantic rather than duplicating divergent definitions.
• After changes that affect the HTTP API surface, regenerate fern/openapi.json.
• Run ty and tests — JSON typing mistakes often show up as runtime validation errors in tests.

Validation

uv run ty check . --ignore unresolved-import
uv run pytest
uv run python scripts/export_openapi.py  # if API request/response shapes changed

Cross-skill references:

• sched-ruff-ty-prek
• sched-fastapi-server
• sched-fern-openapi-docs