# AGENTS

- This repository contains a lightweight, test-driven Python prototype for ArbSphere's federated cross-arbitrage primitives.
- Core concepts provided: LocalArbProblem, SharedSignals, and a deterministic admm_step that outputs a PlanDelta.
- Tests verify deterministic plan generation and basic structure.
- How to run:
  - bash test.sh
- Important: This document is a stub for onboarding agents and does not describe a full production architecture.

What to expect in this sprint
- MVP mapping: canonical ArbSphere primitives (LocalArbProblem, SharedSignals, PlanDelta) and a minimal EnergiBridge translator to a vendor-agnostic IR.
- A Graph-of-Contracts registry (GoC) to describe adapters and data schemas with per-message metadata for replay protection.
- Deterministic replay: a CRDT-inspired delta structure to enable replay across reconnects.
- A two-venue toy MVP to bootstrap interoperability, including data-feed and broker adapters.
- Phase-wise rollout: protocol skeleton, governance ledger scaffolding, cross-domain demo, and latency/auditability dashboards.
- Compliance and audit: tamper-evident governance logs and optional cross-firm attestations.

Implementation guidance
- Prefer to implement small, correct changes that improve interoperability and testability.
- Extend EnergiBridge with additional IR fields and versioning as new adapters are added.
- Keep the GoC registry lightweight; avoid coupling adapters to internal Python types.
- Ensure tests remain deterministic and fast.

If you want me to push a concrete two-venue toy MVP spec or add toy adapters, I can draft and implement those next.