huskies: merge 542_refactor_add_doc_comments_to_all_undocumented_source_files_and_generate_source_map_in_readme

server/src/http/agents.rs

@@ -1,3 +1,4 @@
+//! HTTP agent endpoints — REST API for listing, starting, stopping, and inspecting agents.
 use crate::config::ProjectConfig;
 use crate::http::context::{AppContext, OpenApiResult, bad_request, not_found};
 use crate::workflow::{StoryTestResults, TestCaseResult, TestStatus};

server/src/http/agents_sse.rs

@@ -1,3 +1,4 @@
+//! Agent SSE streaming — Server-Sent Events endpoint for real-time agent output.
 use crate::http::context::AppContext;
 use poem::handler;
 use poem::http::StatusCode;

server/src/http/anthropic.rs

@@ -1,3 +1,4 @@
+//! Anthropic API proxy — forwards model listing and key-validation requests to Anthropic.
 use crate::http::context::{AppContext, OpenApiResult, bad_request};
 use crate::llm::chat;
 use crate::store::StoreOps;

server/src/http/assets.rs

@@ -1,3 +1,4 @@
+//! Static asset serving — serves the embedded React frontend via `rust-embed`.
 use poem::{
     Response, handler,
     http::{StatusCode, header},

server/src/http/chat.rs

@@ -1,3 +1,4 @@
+//! HTTP chat endpoints — REST API for the LLM-powered chat interface.
 use crate::http::context::{AppContext, OpenApiResult, bad_request};
 use crate::llm::chat;
 use poem_openapi::{OpenApi, Tags, payload::Json};

server/src/http/context.rs

@@ -1,3 +1,4 @@
+//! Application context — shared state (`AppContext`) threaded through all HTTP handlers.
 use crate::agents::{AgentPool, ReconciliationEvent};
 use crate::chat::timer::TimerStore;
 use crate::io::watcher::WatcherEvent;

server/src/http/health.rs

@@ -1,3 +1,4 @@
+//! Health check endpoint — returns a static "ok" response.
 use poem::handler;
 use poem_openapi::{Object, OpenApi, Tags, payload::Json};
 use serde::Serialize;

server/src/http/io.rs

@@ -1,3 +1,4 @@
+//! HTTP I/O endpoints — REST API for file and directory operations.
 use crate::http::context::{AppContext, OpenApiResult, bad_request};
 use crate::io::fs as io_fs;
 use poem_openapi::{Object, OpenApi, Tags, payload::Json};

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,
 };

server/src/http/mod.rs

@@ -1,3 +1,4 @@
+//! HTTP server — module declarations for all REST, MCP, WebSocket, and SSE endpoints.
 pub mod agents;
 pub mod agents_sse;
 pub mod anthropic;

server/src/http/model.rs

@@ -1,3 +1,4 @@
+//! HTTP model endpoints — REST API for model selection and LLM provider management.
 use crate::http::context::{AppContext, OpenApiResult, bad_request};
 use crate::io::fs;
 use crate::llm::chat;

server/src/http/oauth.rs

@@ -1,3 +1,4 @@
+//! OAuth endpoints — Anthropic OAuth callback and token exchange flow.
 use crate::llm::oauth;
 use crate::slog;
 use poem::handler;

server/src/http/project.rs

@@ -1,3 +1,4 @@
+//! HTTP project endpoints — REST API for project initialization and context management.
 use crate::http::context::{AppContext, OpenApiResult, bad_request};
 use crate::io::fs;
 use poem_openapi::{Object, OpenApi, Tags, payload::Json};

server/src/http/settings.rs

@@ -1,3 +1,4 @@
+//! HTTP settings endpoints — REST API for user preferences and editor configuration.
 use crate::http::context::{AppContext, OpenApiResult, bad_request};
 use crate::store::StoreOps;
 use poem_openapi::{Object, OpenApi, Tags, param::Query, payload::Json};

server/src/http/wizard.rs

@@ -1,3 +1,4 @@
+//! HTTP wizard endpoints — REST API for the project setup wizard.
 use crate::http::context::{AppContext, OpenApiResult, bad_request, not_found};
 use crate::io::wizard::{StepStatus, WizardState, WizardStep};
 use poem_openapi::{Object, OpenApi, Tags, param::Path, payload::Json};

server/src/http/workflow/bug_ops.rs

@@ -1,3 +1,4 @@
+//! Bug operations — creates bug, refactor, and spike files in the pipeline.
 use crate::io::story_metadata::parse_front_matter;
 use std::path::Path;
 

server/src/http/workflow/mod.rs

@@ -1,3 +1,4 @@
+//! Workflow helpers — shared story/bug file operations used by HTTP and MCP handlers.
 mod bug_ops;
 mod story_ops;
 mod test_results;

server/src/http/workflow/story_ops.rs

@@ -1,3 +1,4 @@
+//! Story operations — creates, updates, and manages acceptance criteria in story files.
 use crate::io::story_metadata::set_front_matter_field;
 use serde_json::Value;
 use std::collections::HashMap;

server/src/http/workflow/test_results.rs

@@ -1,3 +1,4 @@
+//! Test result persistence — writes structured test results into story markdown files.
 use crate::io::story_metadata::set_front_matter_field;
 use crate::workflow::{StoryTestResults, TestCaseResult, TestStatus};
 use std::path::Path;

server/src/http/ws.rs

@@ -1,3 +1,4 @@
+//! WebSocket endpoint — real-time pipeline updates, chat, and permission prompts.
 use crate::http::context::{AppContext, PermissionDecision};
 use crate::http::workflow::{PipelineState, load_pipeline_state};
 use crate::io::onboarding;