DEVELOPER_GUIDE.md

Developer Guide

This guide covers local development, testing, and extension building.

Setup

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run

cd systemzero
python run.py

Tests

pytest tests/ -v --cov

Export OpenAPI

python -m systemzero.scripts.export_openapi --out openapi.yaml

Benchmark Endpoints

python -m systemzero.scripts.bench_api

Coding Standards

• See CONVENTIONS.md for naming and structure
• Use type hints everywhere
• Keep functions small and focused

Building Extensions

• Add under extensions/<your_module>
• Provide init.py re-exports and README
• Include tests under tests/ to validate behavior