# AlgoGraph Agent Guide

Architecture overview
- Language: Python for the MVP. Clean separation between core algebraic graph primitives, a lightweight edge-friendly solver, and adapters.
- Core concepts:
  - Objects: Local optimization blocks (PortfolioBlock)
  - Morphisms: Signals carried between blocks (SignalMorphism)
  - PlanDelta: Incremental plan changes with version metadata
  - DualVariables: Optimization multipliers/price signals

- Adapters: TLS-enabled connectivity to brokers, feeds, and risk models.
- Central registry (conceptual): Tracks schemas, versions, and attestations for cross-venue interoperability.

What this repo contains
- A minimal, production-oriented MVP implementing the above concepts.
- A toy ADMM-like solver to demonstrate edge/offline capabilities.
- A lightweight adapter scaffold for two venues.
- Basic tests ensuring correctness of core primitives and solver behavior.

How to run tests
- bash test.sh

How to contribute
- Focus on small, testable changes. Prefer minimal, well-documented edits.
- Add or extend tests for any new feature.