community
/
idea91-ml-cv-hedge
17
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
idea91-ml-cv-hedge/AGENTS.md

1.1 KiB
Raw Blame History

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)