huskies: merge 542_refactor_add_doc_comments_to_all_undocumented_source_files_and_generate_source_map_in_readme

server/src/agents/gates.rs

@@ -1,3 +1,4 @@
+//! Acceptance gates — runs test suites and validation scripts in agent worktrees.
 use std::path::Path;
 use std::process::Command;
 use std::time::Duration;

server/src/agents/lifecycle.rs

@@ -1,3 +1,4 @@
+//! Story lifecycle helpers — file creation, archival, and stage transitions for pipeline items.
 use std::path::Path;
 use std::process::Command;
 

server/src/agents/merge.rs

@@ -1,3 +1,4 @@
+//! Merge operations — rebases agent work onto master and runs post-merge validation.
 use std::path::Path;
 use std::process::Command;
 use std::sync::Mutex;

server/src/agents/mod.rs

@@ -1,3 +1,4 @@
+//! Agent subsystem — types, configuration, and orchestration for coding agents.
 pub mod gates;
 pub mod lifecycle;
 pub mod merge;

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

server/src/agents/pty.rs

@@ -1,3 +1,4 @@
+//! PTY runner — spawns agent processes in pseudo-terminals and streams their output.
 use std::collections::HashMap;
 use std::io::{BufRead, BufReader};
 use std::sync::{Arc, Mutex};

server/src/agents/runtime/claude_code.rs

@@ -1,3 +1,4 @@
+//! Claude Code runtime — launches Claude Code CLI sessions as agent backends.
 use std::collections::HashMap;
 use std::sync::{Arc, Mutex};
 

server/src/agents/runtime/gemini.rs

@@ -1,3 +1,4 @@
+//! Gemini runtime — drives Google Gemini API sessions as agent backends.
 use std::sync::atomic::{AtomicBool, Ordering};
 use std::sync::{Arc, Mutex};
 

server/src/agents/runtime/mod.rs

@@ -1,3 +1,4 @@
+//! Agent runtimes — pluggable backends (Claude Code, Gemini, OpenAI) for running agents.
 mod claude_code;
 mod gemini;
 mod openai;

server/src/agents/runtime/openai.rs

@@ -1,3 +1,4 @@
+//! OpenAI Codex runtime — drives OpenAI API sessions as agent backends.
 use std::sync::atomic::{AtomicBool, Ordering};
 use std::sync::{Arc, Mutex};
 

server/src/agents/token_usage.rs

@@ -1,3 +1,4 @@
+//! Token usage tracking — persists per-agent token consumption records to disk.
 use std::fs;
 use std::path::Path;