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.