huskies: merge 542_refactor_add_doc_comments_to_all_undocumented_source_files_and_generate_source_map_in_readme

server/src/chat/transport/matrix/bot/context.rs

@@ -1,3 +1,4 @@
+//! Matrix bot context — shared state for the Matrix bot (rooms, history, permissions).
 use crate::agents::AgentPool;
 use crate::chat::timer::TimerStore;
 use crate::chat::ChatTransport;

server/src/chat/transport/matrix/bot/format.rs

@@ -1,3 +1,4 @@
+//! Matrix message formatting — Markdown-to-HTML conversion and startup announcements.
 use pulldown_cmark::{Options, Parser, html};
 
 /// Format the startup greeting the bot sends to each room when it comes online.

server/src/chat/transport/matrix/bot/history.rs

@@ -1,3 +1,4 @@
+//! Matrix conversation history — per-room message history for LLM context.
 use crate::slog;
 use matrix_sdk::ruma::OwnedRoomId;
 use serde::{Deserialize, Serialize};

server/src/chat/transport/matrix/bot/mentions.rs

@@ -1,3 +1,4 @@
+//! Matrix mention detection — checks whether a message mentions the bot.
 use matrix_sdk::ruma::events::room::message::{Relation, RoomMessageEventContentWithoutRelation};
 use matrix_sdk::ruma::{OwnedEventId, OwnedUserId};
 use std::collections::HashSet;

server/src/chat/transport/matrix/bot/messages.rs

@@ -1,3 +1,4 @@
+//! Matrix message handler — processes incoming room messages and dispatches commands.
 use crate::chat::util::{drain_complete_paragraphs, is_permission_approval};
 use crate::http::context::PermissionDecision;
 use crate::llm::providers::claude_code::{ClaudeCodeProvider, ClaudeCodeResult};

server/src/chat/transport/matrix/bot/mod.rs

@@ -1,3 +1,4 @@
+//! Matrix bot — sub-modules for the Matrix chat bot implementation.
 pub mod context;
 pub mod format;
 pub mod history;

server/src/chat/transport/matrix/bot/run.rs

@@ -1,3 +1,4 @@
+//! Matrix bot run loop — connects to the homeserver and processes sync events.
 use crate::agents::AgentPool;
 use crate::slog;
 use matrix_sdk::{Client, LoopCtrl, config::SyncSettings};

server/src/chat/transport/matrix/bot/verification.rs

@@ -1,3 +1,4 @@
+//! Matrix device verification — interactive emoji verification flow for E2EE.
 use crate::slog;
 use futures::StreamExt;
 use matrix_sdk::Client;

server/src/chat/transport/matrix/config.rs

@@ -1,3 +1,4 @@
+//! Matrix transport configuration — deserialization of `bot.toml` Matrix settings.
 use serde::Deserialize;
 use std::path::Path;
 

server/src/chat/transport/mod.rs

@@ -1,3 +1,4 @@
+//! Chat transports — pluggable backends (Matrix, Slack, WhatsApp, Discord) for bot messaging.
 pub mod discord;
 pub mod matrix;
 pub mod slack;

server/src/chat/transport/whatsapp/commands.rs

@@ -1,3 +1,4 @@
+//! WhatsApp command handling — processes incoming WhatsApp messages as bot commands.
 use std::sync::Arc;
 
 use crate::chat::transport::matrix::{ConversationEntry, ConversationRole, RoomConversation};

server/src/chat/transport/whatsapp/format.rs

@@ -1,3 +1,4 @@
+//! WhatsApp message formatting — Markdown-to-WhatsApp conversion and message chunking.
 use regex::Regex;
 use std::sync::LazyLock;
 

server/src/chat/transport/whatsapp/history.rs

@@ -1,3 +1,4 @@
+//! WhatsApp conversation history — per-number message history and messaging window tracking.
 use serde::{Deserialize, Serialize};
 use std::collections::HashMap;
 use std::sync::Arc;

server/src/chat/transport/whatsapp/meta.rs

@@ -1,3 +1,4 @@
+//! WhatsApp Meta (Cloud API) transport — sends and receives messages via the Meta Graph API.
 use async_trait::async_trait;
 use serde::{Deserialize, Serialize};
 

server/src/chat/transport/whatsapp/twilio.rs

@@ -1,3 +1,4 @@
+//! WhatsApp Twilio transport — sends and receives messages via the Twilio API.
 use async_trait::async_trait;
 use serde::Deserialize;