feat: add topology-aware adaptive controls

.pre-commit-config.yaml

@@ -52,7 +52,7 @@ repos:
     hooks:
       - id: ty
         name: ty (type check)
-        entry: uv run ty check . --exclude docs/** --exclude fern/** --exclude third_party/** --exclude ./examples/** --exclude .cache/** --exclude .claude/**
+        entry: uv run ty check . --force-exclude --exclude docs/ --exclude fern/ --exclude third_party/ --exclude examples/ --exclude .cache/ --exclude .claude/
         language: system
         types: [python]
         pass_filenames: false

crates/adaptive/Cargo.toml

@@ -34,6 +34,11 @@ redis-backend = ["redis"]
 [dev-dependencies]
 tokio = { version = "1", default-features = false, features = ["rt", "macros", "sync", "time", "test-util", "rt-multi-thread"] }
 tokio-stream = { version = "0.1", default-features = false }
+criterion = { version = "0.5", features = ["html_reports"] }
+
+[[bench]]
+name = "convergence_bench"
+harness = false
 
 [[test]]
 name = "redis_integration"
@@ -46,3 +51,11 @@ path = "tests/integration/runtime_integration_tests.rs"
 [[test]]
 name = "acg_module_surface"
 path = "tests/integration/acg_module_surface_tests.rs"
+
+[[test]]
+name = "topology_convergence"
+path = "tests/integration/topology_convergence_tests.rs"
+
+[[test]]
+name = "tool_parallelism_plan"
+path = "tests/integration/tool_parallelism_plan_tests.rs"

crates/adaptive/README.md

@@ -42,14 +42,18 @@ framework.
 - ✅ **`AdaptiveConfig`**: A canonical config contract for the top-level
   `adaptive` plugin component.
 - ✅ **Built-in component settings**: Typed config helpers for telemetry,
-  adaptive hints, tool parallelism, and the Adaptive Cache Governor.
+  adaptive hints, tool parallelism, the Adaptive Cache Governor, and
+  topology-aware convergence, drift, and hint-governor controls.
 - ✅ **State backends**: In-memory state by default and Redis-backed state behind
   the `redis-backend` feature.
 - ✅ **Learning primitives**: Runtime helpers and learners built on NeMo Relay
   events.
 - ✅ **Adaptive Cache Governor (ACG) module surface**: The canonical
   `nemo_relay_adaptive::acg` module for PromptIR, provider plugins, stability
   analysis, and cache telemetry normalization.
+- ✅ **Topology-aware adaptive controls**: Optional deterministic signals for
+  ACG convergence, stale tool-plan invalidation, and learned hint load
+  shedding.
 
 ## Installation