1.3 KiB
1.3 KiB
CatOpt-Query: MVP scaffolding for a category-theoretic distributed query planning framework.
Overview
- A minimal, production-oriented Python MVP that models local shard plans (Objects), inter-shard signals (Morphisms), and vendor adapters (Functors).
- Includes a canonical representation, two starter adapters (PostgreSQL and MongoDB), and a simple coordinator to fuse local plans.
- Designed as a stepping stone toward the 8–12 week MVP plan described in the project proposal.
What you’ll find here
- Core data models for LocalProblem, SharedVariables, DualVariables, PlanDelta, DataContract, and AuditLog.
- A CanonicalPlan representation and a naive joint-planning coordinator.
- Adapters for PostgreSQL and MongoDB that map local plans to the canonical representation.
- Tests validating protocol serialization, adapter mappings, and basic joint planning behavior.
- A lightweight protocol registry (Graph-of-Contracts concept) skeleton and a small DSL skeleton (data classes-only).
Getting started
- Install: python3 -m build && pip install dist/catopt_query-0.1.0-py3-none-any.whl
- Run tests: pytest -q
Notes
- This is an MVP scaffold. It focuses on correctness, testability, and incremental extensibility for the larger CatOpt-Query project.
- No external DB calls are required for the MVP tests; adapters simulate plan mapping.
License: MIT