update docs + agents

src/engine/mod.rs

@@ -47,6 +47,8 @@ pub struct OptimizationResult {
     pub is_partial: bool,
     /// A map of configuration files that were written to.
     pub config_paths: HashMap<String, PathBuf>,
+    /// The comprehensive optimization matrix (Silent, Balanced, Performance).
+    pub optimization_matrix: Option<crate::agent_analyst::OptimizationMatrix>,
 }
 
 /// Pure mathematics engine for thermal optimization.