Add idiomatic documentation to Go, Java, Python, and Rust clients

clients/rust/src/generated.rs

@@ -1,4 +1,17 @@
+//! Generated tonic/prost bindings for the gateway, worker, and Galaxy
+//! Repository protobuf contracts.
+//!
+//! Modules under this namespace are produced by `tonic-build` from the shared
+//! `.proto` files in the contracts project. Treat them as build output: do not
+//! hand-edit, and prefer the wrappers in [`crate::client`], [`crate::session`],
+//! [`crate::galaxy`], and [`crate::value`] for application code.
+
+#![allow(missing_docs)]
+
+/// Generated bindings for the public `mxaccess_gateway` gRPC service.
 pub mod mxaccess_gateway {
+    /// `mxaccess_gateway.v1` package — the v1 wire contract surfaced by the
+    /// gateway to language clients.
     pub mod v1 {
         #![allow(clippy::large_enum_variant)]
 
@@ -6,7 +19,10 @@ pub mod mxaccess_gateway {
     }
 }
 
+/// Generated bindings for the internal gateway↔worker IPC protocol.
 pub mod mxaccess_worker {
+    /// `mxaccess_worker.v1` package — frame and envelope types used inside
+    /// the named-pipe transport between gateway and worker.
     pub mod v1 {
         #![allow(clippy::large_enum_variant)]
 
@@ -14,7 +30,10 @@ pub mod mxaccess_worker {
     }
 }
 
+/// Generated bindings for the Galaxy Repository read-only browse service.
 pub mod galaxy_repository {
+    /// `galaxy_repository.v1` package — types for the Galaxy hierarchy
+    /// discovery and deploy-event watch RPCs.
     pub mod v1 {
         #![allow(clippy::large_enum_variant)]