algebraic-auction-studio-for-robotic-fle/AGENTS.md

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