cosmosmesh-privacy-preserving-federated-/AGENTS.md

CosmosMesh Privacy-Preserving Federated Mission Planning

Architecture overview

• Language: Python for MVP scaffolding (scaffold only)
• Core package: cosmosmesh_privacy_preserving_federated_
• Tests: pytest-driven in tests/ directory
• Build: Python packaging with pyproject.toml using setuptools

How to contribute

• Run tests with ./test.sh
• Package name and version are defined in pyproject.toml
• README describes how to extend the MVP and plug in adapters

Testing commands

• Build the project: python3 -m build
• Run tests: pytest -q
• Run the complete test script: bash test.sh

Rules

• Do not modify public API semantics for MVP scaffolding unless asked
• Focus on small, correct changes and clear documentation

CosmosMesh CatOpt bridge (MVP)

• We are prototyping a lightweight interoperability bridge that maps CosmosMesh MVP primitives to a CatOpt-style representation (Objects/ Morphisms/ Functors) to enable cross-domain experimentation without heavy dependencies.
• Starter adapters: rover and habitat module adapters exposing simple interfaces for readState, exposeLocalProblemData, and applyCommand.
• Transport: TLS-based, e.g., MQTT/REST for prototyping.
• Deliverables: a minimal CatOpt bridge module (src/cosmosmesh_privacy_preserving_federated/catopt_bridge.py), a small registry graph for contracts, and a DSL sketch to describe LocalProblem/SharedVariables/DualVariables/PlanDelta.