docs: update human and LLM docs and enhance tool/list schemas with actionable next steps

server/src/handlers/meta.rs

@@ -545,7 +545,7 @@ impl McpTool for DecisionsHandler {
         match req.action {
             DecisionAction::Log => {
                 let title = req.title.ok_or_else(|| {
-                    crate::error::AppError::Internal("title is required for 'log' action".to_string())
+                    crate::error::AppError::Internal("Missing required parameter 'title' for action 'log'. Next step: Provide ADR 'title' string in request and retry.".to_string())
                 })?;
                 let status = req.status.unwrap_or_else(|| "accepted".to_string());
                 let context = req.context.unwrap_or_default();
@@ -568,7 +568,7 @@ impl McpTool for DecisionsHandler {
             }
             DecisionAction::Delete => {
                 let id = req.id.ok_or_else(|| {
-                    crate::error::AppError::Internal("id is required for 'delete' action".to_string())
+                    crate::error::AppError::Internal("Missing required parameter 'id' for action 'delete'. Next step: Provide ADR 'id' string in request and retry.".to_string())
                 })?;
                 DeleteDecisionHandler.execute(serde_json::json!({"id": id}), state).await
             }
@@ -597,7 +597,7 @@ impl McpTool for TechDebtHandler {
         match req.action {
             TechDebtAction::Log => {
                 let desc = req.description.ok_or_else(|| {
-                    crate::error::AppError::Internal("description is required for 'log' action".to_string())
+                    crate::error::AppError::Internal("Missing required parameter 'description' for action 'log'. Next step: Provide tech debt 'description' in request and retry.".to_string())
                 })?;
                 let ideal = req.ideal_solution.unwrap_or_default();
                 LogTechDebtHandler.execute(
@@ -615,7 +615,7 @@ impl McpTool for TechDebtHandler {
             }
             TechDebtAction::Resolve => {
                 let id = req.id.ok_or_else(|| {
-                    crate::error::AppError::Internal("id is required for 'resolve' action".to_string())
+                    crate::error::AppError::Internal("Missing required parameter 'id' for action 'resolve'. Next step: Provide tech debt 'id' string in request and retry.".to_string())
                 })?;
                 ResolveTechDebtHandler.execute(serde_json::json!({"id": id}), state).await
             }