27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
# 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.
|