From 0a0ab659086db4015452b5a2d3f42151816fb498 Mon Sep 17 00:00:00 2001
From: Timmy <timmy@storkit>
Date: Mon, 29 Jun 2026 17:02:17 +0100
Subject: [PATCH] Adding doc comments.

---
 server/src/http/mcp/agent_tools/inspection.rs   | 1 +
 server/src/http/mcp/agent_tools/lifecycle.rs    | 1 +
 server/src/http/mcp/merge_tools.rs              | 1 +
 server/src/http/mcp/story_tools/bug.rs          | 1 +
 server/src/http/mcp/story_tools/story/delete.rs | 1 +
 5 files changed, 5 insertions(+)

diff --git a/server/src/http/mcp/agent_tools/inspection.rs b/server/src/http/mcp/agent_tools/inspection.rs
index 2089e4e0..54b2121f 100644
--- a/server/src/http/mcp/agent_tools/inspection.rs
+++ b/server/src/http/mcp/agent_tools/inspection.rs
@@ -99,6 +99,7 @@ pub(crate) async fn tool_get_agent_output(
     Ok(output)
 }
 
+/// Return the agent configuration with availability info for each stage.
 pub(crate) async fn tool_get_agent_config(ctx: &AppContext) -> Result<String, String> {
     let project_root = ctx.services.agents.get_project_root(&ctx.state)?;
     let config = ProjectConfig::load(&project_root)?;
diff --git a/server/src/http/mcp/agent_tools/lifecycle.rs b/server/src/http/mcp/agent_tools/lifecycle.rs
index adae5a03..365146b9 100644
--- a/server/src/http/mcp/agent_tools/lifecycle.rs
+++ b/server/src/http/mcp/agent_tools/lifecycle.rs
@@ -67,6 +67,7 @@ pub(crate) async fn tool_stop_agent(args: &Value, ctx: &AppContext) -> Result<St
     ))
 }
 
+/// List all agents with their current status, filtered to non-archived stories.
 pub(crate) async fn tool_list_agents(ctx: &AppContext) -> Result<String, String> {
     let project_root = ctx.services.agents.get_project_root(&ctx.state).ok();
     let agents = ctx.services.agents.list_agents().await?;
diff --git a/server/src/http/mcp/merge_tools.rs b/server/src/http/mcp/merge_tools.rs
index 9850f02d..50ff602f 100644
--- a/server/src/http/mcp/merge_tools.rs
+++ b/server/src/http/mcp/merge_tools.rs
@@ -171,6 +171,7 @@ pub(super) async fn tool_move_story_to_merge(
     .map_err(|e| format!("Serialization error: {e}"))
 }
 
+/// Record a merge failure reported by the mergemaster agent.
 pub(super) async fn tool_report_merge_failure(
     args: &Value,
     ctx: &AppContext,
diff --git a/server/src/http/mcp/story_tools/bug.rs b/server/src/http/mcp/story_tools/bug.rs
index 32474e26..6cd18874 100644
--- a/server/src/http/mcp/story_tools/bug.rs
+++ b/server/src/http/mcp/story_tools/bug.rs
@@ -66,6 +66,7 @@ pub(crate) fn tool_list_bugs(ctx: &AppContext) -> Result<String, String> {
     .map_err(|e| format!("Serialization error: {e}"))
 }
 
+/// Close a bug: archive it and remove its agent pool entries.
 pub(crate) async fn tool_close_bug(args: &Value, ctx: &AppContext) -> Result<String, String> {
     let bug_id = args
         .get("bug_id")
diff --git a/server/src/http/mcp/story_tools/story/delete.rs b/server/src/http/mcp/story_tools/story/delete.rs
index 3541b364..5c80c926 100644
--- a/server/src/http/mcp/story_tools/story/delete.rs
+++ b/server/src/http/mcp/story_tools/story/delete.rs
@@ -5,6 +5,7 @@ use crate::http::context::AppContext;
 use crate::pipeline_state::{Stage, read_typed};
 use serde_json::Value;
 
+/// Accept a story: move it to Done and clean up its agent pool entries.
 pub(crate) async fn tool_accept_story(args: &Value, ctx: &AppContext) -> Result<String, String> {
     let story_id = args
         .get("story_id")