27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
# AGENTS
|
|
|
|
This repository hosts a production-oriented skeleton for ML-CV Hedge Studio MVP.
|
|
|
|
- Core DSL: Asset, MarketSignal, RiskState, HedgePlanDelta, GraphOfContracts
|
|
- Engine: HedgeSynthesisEngine (budget-aware hedging planner)
|
|
- Adapters: PriceFeedAdapter, OptionsVenueAdapter (toy builders)
|
|
- DeltaSync: deterministic replay log (delta_sync.py)
|
|
- Tests: tests/test_core.py validates core data structures and flow
|
|
|
|
How to contribute
|
|
- Install: python3 -m pip install -r requirements.txt (if present)
|
|
- Run tests: pytest
|
|
- Build: python3 -m build
|
|
|
|
Commands to run in this repo (for agents):
|
|
- Run unit tests: pytest
|
|
- Build package: python3 -m build
|
|
- Replay deltas: python -m idea91_ml_cv_hedge.delta_sync
|
|
|
|
Architecture overview
|
|
- DSL primitives map to a canonical Graph-of-Contracts approach (Asset, MarketSignal, RiskState, HedgePlanDelta)
|
|
- A lightweight hedge synthesis engine computes cross-venue hedge deltas under budgets
|
|
- Adapters connect to real venues/simulators; Sandbox adapters are provided as MVP
|
|
- DeltaSync ensures deterministic replay across partitions and reconnects
|
|
- Optional privacy-friendly signal sharing via aggregation (stubbed in MVP)
|