1.6 KiB
1.6 KiB
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.