catopt-graph-graph-calculus-driven-compo/README.md

CatOpt-Graph MVP

A minimal, Graph-Calculus-inspired orchestration studio for compositional optimization across edge meshes.

• Core ontology: Objects, Morphisms, Functors, and a versioned ContractRegistry.
• Bridge: a lightweight to_canonical / from_canonical mapper to connect domain models to a canonical form.
• ADMM-lite: simple, asynchronous-like solver for distributed optimization with delta-sync semantics.
• Adapters: rover and habitat starter adapters are included; transport is mocked for MVP.
• Governance: lightweight audit trail scaffolding.

How to run tests

• Ensure Python 3.10+ is installed
• Run: bash test.sh

Notes

• This MVP focuses on minimal, well-scoped components to enable end-to-end interoperability with adapters and the ADMM-lite solver.
• See core/bridge.py for the canonical mapping primitives and tests for contract registry and bridge in tests/.

MVP Enhancements

• Added a lightweight Graph-of-Contracts in core/graph_of_contracts.py to map adapters to versioned contracts.
• Added a minimal thread-safe enhancement to ContractRegistry (core/contracts.py) for concurrency safety.
• Added a minimal DSL sketch documenting the LocalProblem/SharedVariables/PlanDelta data contracts (docs/dsl_sketch.md).
• Added a minimal in-repo DSL documentation and a sample Graph-of-Contracts scaffold to accelerate adapter onboarding.
• Documentation and a ready-to-publish readiness baton in READY_TO_PUBLISH (to signal MVP stability when publishing).