huskies: merge 542_refactor_add_doc_comments_to_all_undocumented_source_files_and_generate_source_map_in_readme

server/src/http/mcp/agent_tools.rs

@@ -1,3 +1,4 @@
+//! MCP agent tools — start, stop, wait, list, and inspect agents via MCP.
 use crate::agents::PipelineStage;
 use crate::config::ProjectConfig;
 use crate::http::context::AppContext;

server/src/http/mcp/diagnostics.rs

@@ -1,3 +1,4 @@
+//! MCP diagnostic tools — server logs, CRDT dump, and story movement helpers.
 use crate::agents::move_story_to_stage;
 use crate::http::context::AppContext;
 use crate::log_buffer;

server/src/http/mcp/git_tools.rs

@@ -1,3 +1,4 @@
+//! MCP git tools — status, diff, add, commit, and log operations on agent worktrees.
 use crate::http::context::AppContext;
 use serde_json::{json, Value};
 use std::path::PathBuf;

server/src/http/mcp/merge_tools.rs

@@ -1,3 +1,4 @@
+//! MCP merge tools — merge agent work to master and report merge failures.
 use crate::agents::move_story_to_merge;
 use crate::http::context::AppContext;
 use crate::io::story_metadata::write_merge_failure;

server/src/http/mcp/mod.rs

@@ -1,3 +1,4 @@
+//! MCP server — Model Context Protocol endpoint dispatching tool calls to handlers.
 use crate::slog_warn;
 use crate::http::context::AppContext;
 use poem::handler;

server/src/http/mcp/qa_tools.rs

@@ -1,3 +1,4 @@
+//! MCP QA tools — request, approve, and reject QA reviews for stories.
 use crate::agents::{move_story_to_merge, move_story_to_qa, reject_story_from_qa};
 use crate::http::context::AppContext;
 use crate::slog;

server/src/http/mcp/shell_tools.rs

@@ -1,3 +1,4 @@
+//! MCP shell tools — run commands, execute tests, and stream output via MCP.
 use crate::http::context::AppContext;
 use bytes::Bytes;
 use futures::StreamExt;

server/src/http/mcp/status_tools.rs

@@ -1,3 +1,4 @@
+//! MCP status tools — pipeline status, story triage, and acceptance criteria inspection.
 use crate::http::context::AppContext;
 use serde_json::{Value, json};
 use std::fs;

server/src/http/mcp/story_tools.rs

@@ -1,3 +1,4 @@
+//! MCP story tools — create, update, move, and manage stories, bugs, and refactors via MCP.
 use crate::agents::{
     close_bug_to_archive, feature_branch_has_unmerged_changes, move_story_to_done,
 };