Codebase Reference

Who is this page for?

Contributors. This is the auto-generated API reference, pulled straight from the source docstrings by Sphinx autodoc. It is the ground truth for signatures and types; the prose pages (Architecture, The DSL Strategy Engine) explain why.

How to read it

The tree below mirrors the package layout described in Architecture. The fastest entry points by intent:

You want…

Start at

The HTTP surface

app.api.v1.endpoints - one module per resource group.

Business logic

app.services - the orchestration layer.

Persistence

app.repository - async CRUD over SQLAlchemy.

The schema

app.model (tables) and app.schema (wire contracts).

The scoring engine

app.engine - built-ins, registry, and the DSL pipeline.

Wiring & config

app.core (config, container, database) and app.middlewares.

Tip

Docstrings here follow the Google style (parsed by napoleon). [source] links next to each entry jump to the code. When you add or change a public function, update its docstring - this page regenerates from it on every deploy.

Full module index