# MercuryMesh Agents

Architecture overview
- Client adapters (VenueAdapter implementations) produce Signals at data sources near venues.
- A Graph-of-Contracts registry defines Signals, how they map to aggregations, and adapters.
- Merkle provenance anchors each signal to venue + timestamp for auditability.
- Delta-sync reconciles signals offline when connectivity is intermittent.
- Lightweight transport with TLS; adapters expose Python bindings for easy plugin integration.
- Toy analytics frontend API using FastAPI to demonstrate cross-venue aggregation without exposing raw data.

Tech stack
- Python 3.9+
- FastAPI for API surface
- Pydantic for data models (via Signals)
- Lightweight Merkle provenance (SHA-256)
- Simple delta-sync algorithm for MVP

Testing and commands
- Run tests: bash test.sh
- Build package: python3 -m build
- Linting: optional (not included in MVP)

Contribution rules
- Keep interfaces stable; add adapters for venues without touching core contracts.
- Write tests for new features; ensure existing tests remain green.
- Update AGENTS.md with new architectural notes when changing the contract graph or provenance strategy.