# CatOpt-Graph MVP

This repository hosts a minimal, testable MVP of CatOpt-Graph: a graph-calculus-inspired orchestration layer for compositional optimization across edge devices.

- Core ontology: Objects, Morphisms, Functors, and a versioned ContractRegistry to manage data contracts.
- Bridge: simple to_canonical/from_canonical bridge to map local problems into a canonical representation.
- ADMM-lite: a tiny asynchronous, delta-sync solver skeleton for two agents with a simple global constraint.
- Adapters: scaffolded rover and habitat adapters ready for extension.
- Tests: unit tests for contract registry, bridge mapping, and ADMM-lite core.

How to run
- Prerequisites: Python 3.10+, pip, and a POSIX shell.
- Run tests: bash test.sh
- Build package: python3 -m build

This MVP is intentionally small and opinionated to enable rapid iteration and interoperability testing with other ecosystems.