edgeoptionx-edge-first-latency-aware-opt/AGENTS.md

EdgeOptionX Agents Guide

This repository contains a pragmatic MVP scaffold for EdgeOptionX: an edge-first latency-aware options hedging studio.

What this repo provides:

• A lightweight Python-based core for local hedging problems (HedgeObject, LocalProblem, SharedVariables, PlanDelta, AuditLog).
• A minimal delta-sync ledger with tamper-evident logging for governance/audit trails.
• Starter adapters for broker/data feed integration (two adapters as MVP).
• A tiny DSL parser to express hedging tasks in a friendly syntax.
• A provisional testing/packaging setup to verify production readiness.

How to use:

• Implement and wire adapters for your venues; the MVP focuses on local problem declaration and a basic solver skeleton.
• Run tests and build using the provided test.sh script (see below).

Development workflow:

• Write/adjust DSL or core primitives, implement adapters, and ensure the delta-sync ledger can replay confidently.
• Validate with unit tests; extend tests for new hedging objectives.
• Ensure packaging metadata remains consistent (pyproject.toml).

Testing and packaging commands:

• Run tests: ./test.sh
• Build distribution: python3 -m build
• Check linting and type hints as needed (not enforced in this MVP).

Contributing:

• Open a PR with a clear description of the feature or bug fix.
• Add/adjust tests to reflect new behavior.
• Update AGENTS.md if workflow or architecture changes are made.

Note: This is a production-oriented scaffold. As the project evolves, components may be refined or split into more granular packages.