docs: Add rustdoc comments for functions, structs, and traits

Co-authored-by: aider (openai/andrew/openrouter/sonoma-sky-alpha) <aider@aider.chat>

src/meta_plugin/env.rs

@@ -8,6 +8,16 @@ pub struct EnvMetaPlugin {
 }
 
 impl EnvMetaPlugin {
+    /// Creates a new `EnvMetaPlugin` instance.
+    ///
+    /// # Arguments
+    ///
+    /// * `_options` - Optional configuration options for the plugin (unused in this implementation).
+    /// * `outputs` - Optional output mappings for metadata.
+    ///
+    /// # Returns
+    ///
+    /// A new instance of `EnvMetaPlugin`.
     pub fn new(
         _options: Option<std::collections::HashMap<String, serde_yaml::Value>>,
         outputs: Option<std::collections::HashMap<String, serde_yaml::Value>>,
@@ -44,18 +54,38 @@ impl EnvMetaPlugin {
 }
 
 impl MetaPlugin for EnvMetaPlugin {
+    /// Returns the type of this meta plugin.
+    ///
+    /// # Returns
+    ///
+    /// `MetaPluginType::Env`.
     fn meta_type(&self) -> MetaPluginType {
         MetaPluginType::Env
     }
     
+    /// Checks if the plugin has been finalized.
+    ///
+    /// # Returns
+    ///
+    /// `true` if finalized, `false` otherwise.
     fn is_finalized(&self) -> bool {
         self.is_finalized
     }
     
+    /// Sets the finalized state of the plugin.
+    ///
+    /// # Arguments
+    ///
+    /// * `finalized` - The new finalized state.
     fn set_finalized(&mut self, finalized: bool) {
         self.is_finalized = finalized;
     }
     
+    /// Initializes the plugin, processing environment variables.
+    ///
+    /// # Returns
+    ///
+    /// A `MetaPluginResponse` with environment metadata and finalized state set to `true`.
     fn initialize(&mut self) -> crate::meta_plugin::MetaPluginResponse {
         // If already finalized, don't process again
         if self.is_finalized {
@@ -86,6 +116,15 @@ impl MetaPlugin for EnvMetaPlugin {
         }
     }
     
+    /// Updates the plugin with new data (unused in this implementation).
+    ///
+    /// # Arguments
+    ///
+    /// * `_data` - The data chunk (unused).
+    ///
+    /// # Returns
+    ///
+    /// A `MetaPluginResponse` with empty metadata and finalized state.
     fn update(&mut self, _data: &[u8]) -> crate::meta_plugin::MetaPluginResponse {
         // If already finalized, don't process more data
         if self.is_finalized {
@@ -101,6 +140,11 @@ impl MetaPlugin for EnvMetaPlugin {
         }
     }
 
+    /// Finalizes the plugin, calling initialize if not already done.
+    ///
+    /// # Returns
+    ///
+    /// A `MetaPluginResponse` with environment metadata if not finalized, or empty if already done.
     fn finalize(&mut self) -> crate::meta_plugin::MetaPluginResponse {
         // If not already finalized, we can call initialize
         if !self.is_finalized {
@@ -113,20 +157,40 @@ impl MetaPlugin for EnvMetaPlugin {
         }
     }
     
+    /// Returns a reference to the outputs mapping.
+    ///
+    /// # Returns
+    ///
+    /// A reference to the `HashMap` of outputs.
     fn outputs(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
         &self.outputs
     }
     
+    /// Returns a mutable reference to the outputs mapping.
+    ///
+    /// # Returns
+    ///
+    /// A mutable reference to the `HashMap` of outputs.
     fn outputs_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
         &mut self.outputs
     }
     
+    /// Returns the default output names based on collected env vars.
+    ///
+    /// # Returns
+    ///
+    /// A vector of environment variable names.
     fn default_outputs(&self) -> Vec<String> {
         self.env_vars.iter()
             .map(|(name, _)| name.clone())
             .collect()
     }
     
+    /// Returns a reference to the options mapping (empty for this plugin).
+    ///
+    /// # Returns
+    ///
+    /// An empty `HashMap`.
     fn options(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
         use once_cell::sync::Lazy;
         static EMPTY: Lazy<std::collections::HashMap<String, serde_yaml::Value>> = 
@@ -134,16 +198,9 @@ impl MetaPlugin for EnvMetaPlugin {
         &EMPTY
     }
     
-    fn options_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
-        panic!("options_mut() not implemented for EnvMetaPlugin")
-    }
-}
-use crate::meta_plugin::register_meta_plugin;
-
-// Register the plugin at module initialization time
-#[ctor::ctor]
-fn register_env_plugin() {
-    register_meta_plugin(MetaPluginType::Env, |options, outputs| {
-        Box::new(EnvMetaPlugin::new(options, outputs))
-    });
-}
+    /// Returns a mutable reference to the options mapping.
+    ///
+    /// # Panics
+    ///
+    /// Panics with "options_mut() not implemented for EnvMetaPlugin".
+    fn options_mut(&mut self) -> &mut std::collections::HashMap<String, serde