33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
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.
|