retoor retoor@molodetz.nl

typosaurus-sandbox

A minimal Python calculator used to verify the Typosaurus agent system.

Conventions

  • Every source file starts with the # retoor <retoor@molodetz.nl> header.
  • Full type annotations on every function signature.
  • No comments or docstrings in source files.

Python backend

  • Package manifest: pyproject.toml
  • Entry module: src/typosaurus_sandbox/__main__.py
  • Framework: FastAPI
  • Serve frontend: no

Architecture

  • Backend serves frontend: no
  • Module root: src/typosaurus_sandbox/
  • Calculator business logic: src/typosaurus_sandbox/domain/calculator/operations.py
  • HTTP API layer: src/typosaurus_sandbox/presentation/api/v1/calculator.py

Verification

make verify

CI

  • Workflow file: .gitea/workflows/ci.yml
  • Trigger: push to main or master branches
  • Steps: checkout, Python 3.12 setup, dependency install, make verify