|
|
||
|---|---|---|
| examples | ||
| src | ||
| tests | ||
| .gitignore | ||
| AGENTS.md | ||
| README.md | ||
| pyproject.toml | ||
| test.sh | ||
README.md
CosmosMesh Privacy-Preserving Federated (CatOpt bridge MVP)
This repository contains a production-oriented MVP scaffold for CosmosMesh, focused on privacy-preserving federated mission planning in deep-space constellations. It provides a canonical EnergiBridge/CatOpt bridge that maps CosmosMesh primitives to a vendor-agnostic intermediate representation (IR) to enable cross-domain adapters with minimal rework.
Key concepts
- LocalProblem: per-asset planning task with objective, variables, and constraints.
- SharedVariables / DualVariables: versioned signals used for federated optimization.
- PlanDelta: incremental plan updates with cryptographic tags.
- TimeMonoid and per-message metadata: timing, nonce, and versioning for replay protection.
- Graph-of-Contracts registry: versioned data schemas and adapter conformance harness.
MVP highlights
- A 2–3 asset testbed with a simple quadratic objective (e.g., task allocation + energy budgeting) and an ADMM-lite solver.
- Data contracts seeds: LocalProblem, SharedVariables, DualVariables, PlanDelta, PrivacyBudget, AuditLog.
- Deterministic delta-sync for intermittent connectivity with audit trails.
- DID/short-lived certs baseline for identity and security.
- Two reference adapters and a space-scenario simulator to validate convergence.
Usage
- The core bridge lives under
src/cosmosmesh_privacy_preserving_federated/. - CatOptBridge provides to_catopt/from_catopt helpers for LocalProblem objects.
- EnergiBridge is a minimal stub for cross-domain interoperability.
Build and tests
- The project uses a pyproject.toml build configuration. Run:
- python3 -m build
- Tests (if present) use pytest. Run:
- pytest -q
See CONTRIBUTING guidelines in AGENTS.md for how to contribute and extend the MVP.