idea36-catopt-play-category/README.md

CatOpt-Play (prototype)

This repository contains a Python prototype for CatOpt-Play — a category-theory-inspired compositional optimizer for distributed multi-agent coordination. The goal of this prototype is to provide a canonical IR for local problems and data contracts, plus a small ADMM-lite solver demonstrating distributed consensus and delta-style plan deltas.

Contents

• src/idea36_catopt_play_category: core library (contracts, solver)
• tests: basic tests for solver convergence and schema generation
• AGENTS.md: repository architecture and contribution rules
• test.sh: runs tests and builds the package

Quickstart

1. Install dev tools: pip install -U build pytest
2. Install package in editable mode: pip install -e .
3. Run tests: pytest
4. Build distribution: python3 -m build

This prototype focuses on a small, well-tested chunk: the canonical data contracts and an ADMM-lite consensus solver. It is intentionally minimal and designed to be extended with engine adapters, transports, and governance ledgers in follow-up work.