feat(orchestrator): refresh telemetry integration on current main

crates/terraphim_orchestrator/Cargo.toml

@@ -63,6 +63,7 @@ terraphim_persistence = { path = "../terraphim_persistence", version = "1.4.10",
 
 # Quickwit integration (optional)
 reqwest = { workspace = true, optional = true }
+ulid = "1.2.1"
 
 [dev-dependencies]
 tokio-test = "0.4"

crates/terraphim_orchestrator/orchestrator.example.toml

@@ -22,6 +22,21 @@ max_duration_secs = 1800
 repo_path = "/opt/ai-dark-factory/workspace"
 create_prs = false
 
+# =============================================================================
+# ROUTING (telemetry-aware model selection)
+# =============================================================================
+# Uncomment to enable KG-driven and telemetry-aware model routing.
+# Requires taxonomy markdown files in the taxonomy_path directory.
+# When use_routing_engine is true, the control-plane routing engine
+# combines KG routing, keyword routing, provider health, budget pressure,
+# and live telemetry signals for model selection.
+#
+# [routing]
+# taxonomy_path = "/opt/ai-dark-factory/kg/routing"
+# probe_ttl_secs = 300
+# probe_on_startup = true
+# use_routing_engine = false
+
 # =============================================================================
 # SAFETY LAYER (always running)
 # =============================================================================

crates/terraphim_orchestrator/src/config.rs

@@ -111,7 +111,16 @@ pub struct RoutingConfig {
     /// Run provider probes on startup (default: true).
     #[serde(default = "default_true_routing")]
     pub probe_on_startup: bool,
-    /// Use RoutingDecisionEngine instead of inline model selection (default: false).
+    /// Use RoutingDecisionEngine instead of inline model selection.
+    ///
+    /// When enabled, `spawn_agent()` delegates model selection to the
+    /// control-plane routing engine which combines KG routing, keyword
+    /// routing, provider health, budget pressure, and live telemetry
+    /// signals (throughput, latency, subscription limits).
+    ///
+    /// Telemetry data is persisted across restarts and restored on startup.
+    ///
+    /// Default: `false` (uses inline model selection logic).
     #[serde(default)]
     pub use_routing_engine: bool,
 }