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;