huskies: merge 542_refactor_add_doc_comments_to_all_undocumented_source_files_and_generate_source_map_in_readme

server/src/agents/pool/mod.rs

@@ -1,3 +1,4 @@
+//! Agent pool — manages the set of active agents across all pipeline stages.
 mod auto_assign;
 mod pipeline;
 mod start;

server/src/agents/pool/pipeline/advance.rs

@@ -1,3 +1,4 @@
+//! Pipeline advance — moves stories forward through pipeline stages after agent completion.
 use crate::config::ProjectConfig;
 use crate::slog;
 use crate::slog_error;

server/src/agents/pool/pipeline/completion.rs

@@ -1,3 +1,4 @@
+//! Agent completion handling — processes exit results and triggers pipeline advancement.
 use crate::slog;
 use crate::io::watcher::WatcherEvent;
 use std::collections::HashMap;

server/src/agents/pool/pipeline/merge.rs

@@ -1,3 +1,4 @@
+//! Pipeline merge step — orchestrates the merge-to-master flow for completed stories.
 use crate::slog;
 use crate::slog_error;
 use crate::slog_warn;

server/src/agents/pool/pipeline/mod.rs

@@ -1,3 +1,4 @@
+//! Pipeline operations — stage advancement, completion handling, and merge orchestration.
 mod advance;
 mod completion;
 mod merge;

server/src/agents/pool/process.rs

@@ -1,3 +1,4 @@
+//! Process management — kills orphaned PTY child processes on server shutdown.
 use crate::slog;
 
 use super::AgentPool;

server/src/agents/pool/query.rs

@@ -1,3 +1,4 @@
+//! Pool queries — lists available agents, active agents, and agent info lookups.
 use crate::config::ProjectConfig;
 use std::path::PathBuf;
 use tokio::sync::broadcast;

server/src/agents/pool/start.rs

@@ -1,3 +1,4 @@
+//! Agent start — spawns a new agent process in a worktree for a given story.
 use crate::agent_log::AgentLogWriter;
 use crate::config::ProjectConfig;
 use crate::slog_error;

server/src/agents/pool/stop.rs

@@ -1,3 +1,4 @@
+//! Agent stop — terminates a running agent while preserving its worktree.
 use crate::slog;
 use crate::slog_error;
 use std::path::Path;

server/src/agents/pool/test_helpers.rs

@@ -1,3 +1,4 @@
+//! Test helpers for the agent pool — in-memory pool construction and assertions.
 use crate::worktree::WorktreeInfo;
 use std::path::PathBuf;
 use std::sync::{Arc, Mutex};

server/src/agents/pool/types.rs

@@ -1,3 +1,4 @@
+//! Agent pool types — `AgentPool`, `StoryAgent`, and related data structures.
 use crate::slog;
 use crate::worktree::WorktreeInfo;
 use std::collections::HashMap;

server/src/agents/pool/wait.rs

@@ -1,3 +1,4 @@
+//! Agent wait — blocks until an agent reaches a terminal state with optional timeout.
 use super::super::{AgentEvent, AgentInfo, AgentStatus};
 use super::types::{agent_info_from_entry, composite_key};
 use super::AgentPool;

server/src/agents/pool/worktree.rs

@@ -1,3 +1,4 @@
+//! Agent worktree management — creates and configures git worktrees for agents.
 use crate::config::ProjectConfig;
 use std::path::{Path, PathBuf};