# CatOpt-Grid

CatOpt-Grid is a modular, open-source framework that expresses distributed optimization problems across heterogeneous edge devices in a category-theory-inspired formalism. This repository contains a minimal, production-ready skeleton to bootstrap a Cross-Domain, Privacy-Preserving Distributed Edge Mesh MVP.

What you’ll find here
- Core primitives: LocalProblem (Objects), SharedVariables/DualVariables (Morphisms), adapters (Functors)
- Lightweight ADMM-like solver (ADMM-lite) designed for delta-sync and offline-first operation
- A tiny DSL scaffold for cross-domain adapters and a registry for future GoC (Graph of Contracts)
- Minimal, testable story with two toy adapters and a couple of unit tests
- Packaging scaffolding to ensure python packaging via pyproject.toml

Contributing
- This is a stepwise MVP: start with the core solver and add adapters and governance in future iterations.
- Tests live under tests/. Run with ./test.sh after dependencies are in place.

See the tests for usage examples and expected behavior.