# AlgeIoT: Algebraic Orchestration for Distributed IoT Resource Markets (Edge City Edition)

This repository implements a production-oriented MVP for AlgeIoT, a CatOpt-inspired orchestration stack for city-scale IoT coordination.

Contents
- Core primitives: LocalDevicePlan, SharedSignal, PlanDelta, DualVariables, etc.
- Lightweight ADMM-lite coordinator (asynchronous, fault-tolerant)
- Two starter adapters: StreetLightController and EVChargingAggregator
- A tiny registry to map adapters to canonical contracts
- Simulation scaffolding and a basic test suite

Architecture and design decisions are documented in AGENTS.md. This README gives a quick launch path and how to extend the MVP.

Getting Started
- Install dependencies and build: see test.sh for a quick validation loop
- Run tests: ./test.sh
- Extend adapters under idea98_algeiot_algebraic_orchestration.adapters

Note: This is a production-oriented MVP. The codebase focuses on well-scoped, robust components with clear interfaces and tests.