DeltaX-Forge SWARM Agent Guide

Overview
- DeltaX-Forge is a cross-venue delta-driven execution planner with a canonical DSL and a two-tier solver architecture.
- Core stack uses Python for production-grade components: a lightweight DSL, local venue solvers, a central curator, adapters for data feeds and execution, and a governance/logging layer.

Project Architecture (high level)
- deltax_forge_cross/
  - __init__.py
  - dsl.py           # Canonical StrategyDelta DSL (Assets, Legs, MarketSignal, PlanDelta, AuditLog) (see tests for usage)
- deltax_forge_cross/core/
  - local_venue_solver.py  # Local solver implementation
  - central_curator.py       # Central coordination/consensus surrogate
- deltax_forge_cross/adapters/
  - price_feed_adapter.py    # Translates MarketSignal to a feed dict
  - venue_execution_adapter.py  # Translates PlanDelta to an execution map
- deltax_forge_cross/logging.py     # Deterministic replay logging
- deltax_forge_cross/ledger.py      # Lightweight cryptographic signing (HMAC-based)
- tests/                         # pytest suite (tests/test_deltax.py)

Testing and CI
- Test command: bash test.sh
- test.sh builds, installs, and runs pytest
- The tests exercise DSL, local/central solvers, adapters, and governance signing

How to contribute
- Run tests locally with: bash test.sh
- Ensure new features have unit tests; keep changes minimal and well-scoped
- Maintain backward compatibility unless explicitly required by a breaking change

Notes
- The repository is intentionally self-contained; it provides a minimal MVP for the DeltaX-Forge concept.