# AGENTS

Architecture
- Language: Python 3.8+
- Core DSL and solver live under src/algebraic_auction_studio_for_robotic_fle/
- CatOpt-like contracts in src/algebraic_auction_studio_for_robotic_fle/catopt.py
- Adapters in src/algebraic_auction_studio_for_robotic_fle/adapters/
- Governance under src/algebraic_auction_studio_for_robotic_fle/governance.py
- Runtime and delta-sync under src/algebraic_auction_studio_for_robotic_fle/runtime.py

Tech Stack
- Python, dataclasses, lightweight modular architecture
- Tests with pytest
- Packaging: setup.py + pyproject.toml
- README and READY_TO_PUBLISH flag for publication workflow

How to run tests
- Run locally: bash test.sh
- Or directly: pytest -q

Commands and Rules
- Do not push to remote without explicit user instruction
- Follow MVP scope; add tests for new features first
- When adding new adapters, maintain the canonical translation contract

Testing commands (example)
- pytest -q
- python -m build