build(agent): molt-d#cb502d iteration

src/cosmosmesh_privacy_preserving_federated_/__init__.py

@@ -1,18 +1,10 @@
-"""CosmosMesh MVP: minimal Python package scaffold.
+"""Public API for the CatOpt bridge MVP within the CosmosMesh core package."""
 
-This file provides a tiny API surface to satisfy the existing unit tests.
+from .catopt_bridge import CatOptBridge
-The full CosmosMesh MVP will progressively replace this with a richer API
+from .contract_registry import REGISTRY, register_contract, get_contract
-covering LocalProblem / SharedVariables / PlanDelta contracts and a tiny
-ADMM-lite solver, but for now we expose a single utility used by tests.
-"""
 
 def add(a, b):
-    """Return the sum of two numbers.
+    """Tiny compatibility helper used by tests."""
-
-    This is a placeholder utility to bootstrap the package API surface for
-    the MVP. It is deliberately simple and well-documented.
-    """
     return a + b
 
-
+__all__ = ["CatOptBridge", "REGISTRY", "register_contract", "get_contract", "add"]
-__all__ = ["add"]

src/cosmosmesh_privacy_preserving_federated_/catopt_bridge.py

@@ -1,71 +1,49 @@
-"""CatOpt Bridge (lightweight interoperability layer).
+"""Minimal CatOpt bridge scaffold for CosmosMesh.
 
-This module provides a tiny, protocol-agnostic bridge that maps CosmosMesh MVP
+This module provides a tiny translator layer that maps CosmosMesh primitives
-primitives into a minimal CatOpt-like representation. It is intentionally small
+into a canonical CatOpt-like representation. It is intentionally lightweight
-and dependency-free to keep the MVP scaffold lightweight and safe for rapid
+and designed for MVP bootstrapping and testing.
-iteration.
 """
+
 from __future__ import annotations
 
-from dataclasses import dataclass
+from typing import Any, Dict
-from typing import Dict
 
-try:
+from .contract_registry import REGISTRY, register_contract, get_contract
-    # Local protocol primitives from the MVP scaffold
-    from .protocol import LocalProblem, SharedVariables, DualVariables
-except Exception:  # pragma: no cover - fallback for environments without protocol
-    LocalProblem = object  # type: ignore
-    SharedVariables = object  # type: ignore
-    DualVariables = object  # type: ignore
-
-
-@dataclass
-class CatOptObject:
-    """Lightweight CatOpt Object representation for MVP bridging."""
-    id: str
-    payload: Dict[str, float]
-
-
-@dataclass
-class CatOptMorphism:
-    """Lightweight CatOpt Morphism representation for MVP bridging."""
-    name: str
-    mapping: Dict[str, float]
 
 
 class CatOptBridge:
-    """Bridge that translates CosmosMesh primitives to a simple CatOpt-style map.
-
-    This is deliberately minimal: it focuses on a stable, serializable mapping
-    suitable for prototyping adapters and does not implement a full formal
-    category-theory bridge.
-    """
-
     def __init__(self) -> None:
-        self._counter = 0
+        # Public API surface is backed by the in-memory registry.
+        self._registry = REGISTRY
 
-    def map_local_problem(self, lp: LocalProblem) -> CatOptObject:
+    def register_contract(self, name: str, version: str, schema: Any) -> None:
-        self._counter += 1
+        # Lightweight pass-through to the registry
-        # Use a simple, deterministic payload representation
+        register_contract(name, version, schema)
-        payload = {k: float(v) if isinstance(v, (int, float)) else 0.0 for k, v in getattr(lp, 'variables', {}).items()}
-        return CatOptObject(id=f"lp-{self._counter}", payload=payload)
 
-    def map_shared_variables(self, sv: SharedVariables) -> CatOptObject:
+    def get_contract(self, name: str) -> Any:
-        self._counter += 1
+        return get_contract(name)
-        payload = {k: float(v) for k, v in getattr(sv, 'signals', {}).items()}
-        return CatOptObject(id=f"sv-{self._counter}", payload=payload)
 
-    def map_dual_variables(self, dv: DualVariables) -> CatOptObject:
+    # Translation helpers (toy implementations for MVP)
-        self._counter += 1
+    def translate_local_problem(self, local_problem: Dict[str, Any]) -> Dict[str, Any]:
-        payload = {k: float(v) for k, v in getattr(dv, 'multipliers', {}).items()}
+        # Expect a dict describing a LocalProblem; return a canonical representation
-        return CatOptObject(id=f"dv-{self._counter}", payload=payload)
-
-    def to_catopt(self, lp: LocalProblem, sv: SharedVariables, dv: DualVariables) -> Dict[str, CatOptObject]:
         return {
-            'LocalProblem': self.map_local_problem(lp),
+            "type": "LocalProblem",
-            'SharedVariables': self.map_shared_variables(sv),
+            "name": local_problem.get("name", "<unnamed>"),
-            'DualVariables': self.map_dual_variables(dv),
+            "version": local_problem.get("version", "0.0.1"),
+            "variables": local_problem.get("variables", []),
+            "objective": local_problem.get("objective", None),
+            "constraints": local_problem.get("constraints", []),
         }
 
+    def translate_shared_variables(self, shared_vars: Dict[str, Any]) -> Dict[str, Any]:
+        return {"type": "SharedVariables", "vars": shared_vars}
 
-__all__ = ["CatOptBridge", "CatOptObject", "CatOptMorphism"]
+    def translate_dual_variables(self, dual_vars: Dict[str, Any]) -> Dict[str, Any]:
+        return {"type": "DualVariables", "duals": dual_vars}
+
+    def translate_plan_delta(self, plan_delta: Dict[str, Any]) -> Dict[str, Any]:
+        return {"type": "PlanDelta", "delta": plan_delta}
+
+
+__all__ = ["CatOptBridge"]

src/cosmosmesh_privacy_preserving_federated_/contract_registry.py

@@ -0,0 +1,34 @@
+"""Lightweight in-memory contract registry for CatOpt bridge.
+
+This module exposes a simple Registry API to store versioned contracts
+used by the CatOpt bridge for interoperability.
+"""
+
+from typing import Any, Dict, Optional
+
+
+class ContractRegistry:
+    def __init__(self) -> None:
+        # Map contract name -> {"version": str, "schema": Any}
+        self._contracts: Dict[str, Dict[str, Any]] = {}
+
+    def register(self, name: str, version: str, schema: Any) -> None:
+        self._contracts[name] = {"version": version, "schema": schema}
+
+    def get(self, name: str) -> Optional[Dict[str, Any]]:
+        return self._contracts.get(name)
+
+    def all(self) -> Dict[str, Dict[str, Any]]:
+        return dict(self._contracts)
+
+
+# Public singleton registry instance used by the bridge
+REGISTRY = ContractRegistry()
+
+
+def register_contract(name: str, version: str, schema: Any) -> None:
+    REGISTRY.register(name, version, schema)
+
+
+def get_contract(name: str) -> Optional[Dict[str, Any]]:
+    return REGISTRY.get(name)

tests/test_catopt_bridge.py

@@ -0,0 +1,21 @@
+import pytest
+
+from cosmosmesh_privacy_preserving_federated_.catopt_bridge import CatOptBridge
+from cosmosmesh_privacy_preserving_federated_.contract_registry import REGISTRY
+
+
+def test_registry_and_translation():
+    bridge = CatOptBridge()
+    # Register a simple contract and verify registry exposure
+    bridge.register_contract("LocalProblem", "0.1.0", {"schema": {"type": "object"}})
+    assert REGISTRY.get("LocalProblem")["version"] == "0.1.0"
+
+    # Translate a minimal local problem description
+    local_problem = {
+        "name": "TestProblem",
+        "variables": [{"name": "x", "domain": "R"}],
+        "objective": {"type": "quadratic"},
+    }
+    translated = bridge.translate_local_problem(local_problem)
+    assert translated["type"] == "LocalProblem"
+    assert translated["name"] == "TestProblem"