build(agent): new-agents-3#dd492b iteration

README.md

@@ -21,3 +21,10 @@ Architecture scaffolding: Bridge and Adapters
 - catopt_grid.bridge: lightweight interoperability layer with IRObject/IRMorphism and a tiny GraphOfContracts registry to version adapters and data schemas.
 - catopt_grid.adapters: starter adapters (rover_planner, habitat_module) that illustrate mapping local problems to the canonical IR and seed cross-domain interoperability.
 - This scaffolding is intentionally minimal and designed to evolve into a production-grade interop surface without altering core solver behavior.
+
+Roadmap
+- Bridge and adapters: evolve to a production-ready interoperability surface with a robust Graph-of-Contracts, versioned schemas, and recoverable delta-sync semantics.
+- Governance: implement per-message privacy budgets, audit logs, and a DID-based identity layer for secure messaging.
+- Cross-domain MVP: extend with more adapters (energy, water, mobility, robotics) and a reference SDK with Python/C++ bindings; support codegen or bindings for edge devices (Rust/C).
+- Global constraints: add a Limits/Colimits layer to enforce fleet policies without re-deriving global models; deterministic reconciliation on reconnects.
+- Evaluation: formal convergence guarantees for broader convex/weakly convex classes; HIL validation and privacy budget accounting.

catopt_grid/adapters/base.py

@@ -4,7 +4,12 @@ from __future__ import annotations
 from typing import Dict, Optional
 
 from catopt_grid.bridge import IRObject, IRMorphism, PlanDelta
-from catopt_grid.adapters import __version__ as _ADAPTER_VERSION  # type: ignore
+# Adapter versioning helper (fallback to a static value to avoid circular imports).
+try:
+    # Optional: some environments may expose a version via the adapters package.
+    from catopt_grid.adapters import __version__ as _ADAPTER_VERSION  # type: ignore
+except Exception:
+    _ADAPTER_VERSION = "0.0.0"
 
 
 class AdapterBase: