huskies: merge 858

server/src/pipeline_state/subscribers.rs

@@ -10,6 +10,7 @@ use super::{event_label, stage_dir_name, stage_label};
 // These are ready to wire into the event bus but not yet connected to the
 // actual subsystems. Suppress dead_code until consumers are migrated.
 
+/// Subscriber that logs pipeline transitions to the Matrix bot channel.
 #[allow(dead_code)]
 pub struct MatrixBotSubscriber;
 #[allow(dead_code)]
@@ -27,6 +28,7 @@ impl TransitionSubscriber for MatrixBotSubscriber {
     }
 }
 
+/// Subscriber that re-renders the filesystem `work/` directory on stage transitions.
 #[allow(dead_code)]
 pub struct FileRendererSubscriber;
 #[allow(dead_code)]
@@ -43,6 +45,7 @@ impl TransitionSubscriber for FileRendererSubscriber {
     }
 }
 
+/// Subscriber that writes stage updates to the pipeline-items data store.
 #[allow(dead_code)]
 pub struct PipelineItemsSubscriber;
 #[allow(dead_code)]
@@ -59,6 +62,7 @@ impl TransitionSubscriber for PipelineItemsSubscriber {
     }
 }
 
+/// Subscriber that promotes eligible backlog items when a story completes or is archived.
 #[allow(dead_code)]
 pub struct AutoAssignSubscriber;
 #[allow(dead_code)]
@@ -77,6 +81,7 @@ impl TransitionSubscriber for AutoAssignSubscriber {
     }
 }
 
+/// Subscriber that broadcasts stage transitions to all connected WebSocket clients.
 #[allow(dead_code)]
 pub struct WebUiBroadcastSubscriber;
 #[allow(dead_code)]