# 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)