huskies: merge 858

server/src/agents/mod.rs

@@ -1,12 +1,19 @@
 //! Agent subsystem — types, configuration, and orchestration for coding agents.
+/// Acceptance-gate checks (clippy, tests, doc coverage).
 pub mod gates;
+/// Agent start/stop and pipeline advancement on completion.
 pub mod lifecycle;
+/// Constructs the system prompt sent to coding agents.
 pub mod local_prompt;
+/// Merge-conflict resolution helpers.
 pub mod merge;
 pub(crate) mod pool;
 pub(crate) mod pty;
+/// Runtime backends (Claude Code, OpenAI, Gemini) that execute agent sessions.
 pub mod runtime;
+/// Persistent session-ID storage for agent resume support.
 pub mod session_store;
+/// Token-usage tracking and budget estimation.
 pub mod token_usage;
 
 use crate::config::AgentConfig;
@@ -74,6 +81,7 @@ pub enum AgentEvent {
 
 #[derive(Debug, Clone, Serialize, PartialEq)]
 #[serde(rename_all = "snake_case")]
+/// Lifecycle state of an agent session.
 pub enum AgentStatus {
     Pending,
     Running,
@@ -212,6 +220,7 @@ impl TokenUsage {
 }
 
 #[derive(Debug, Serialize, Clone)]
+/// Snapshot of a running or completed agent, exposed via the HTTP API.
 pub struct AgentInfo {
     pub story_id: String,
     pub agent_name: String,