use rmcp::ErrorData;
use rmcp::model::Tool;
use serde_json::{Map, Value, json};
use crate::server::tool_trait::{McpTool, ToolContext, ToolOutput, get_str};
use crate::tool_defs::tool_def;
pub struct CtxArchitectureTool;
impl McpTool for CtxArchitectureTool {
fn name(&self) -> &'static str {
"ctx_architecture"
}
fn tool_def(&self) -> Tool {
tool_def(
"ctx_architecture",
"Architecture analysis — understand module structure without reading every file.\n\
WORKFLOW: use ctx_compose FIRST for code understanding; ctx_architecture for high-level structure.\n\
action=overview→high-level; clusters|communities→groupings;\n\
layers|cycles→dependency violations; entrypoints|hotspots→risk areas;\n\
health→quality; module path='src/' to zoom into a specific module.\n\
ANTIPATTERN: does NOT show source code — only structural relationships.",
json!({
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": ["overview", "clusters", "communities", "layers", "cycles", "entrypoints", "hotspots", "health", "module"],
"description": "overview|clusters|communities|layers|cycles|entrypoints|hotspots|health|module"
},
"path": {
"type": "string",
"description": "Module/file path"
},
"root": {
"type": "string",
"description": "Project root"
},
"format": {
"type": "string",
"description": "Output format: text|json (default text)"
}
},
"allOf": [
{
"if": { "properties": { "action": { "const": "module" } }, "required": ["action"] },
"then": { "required": ["action", "path"] }
}
]
}),
)
}
fn handle(
&self,
args: &Map<String, Value>,
ctx: &ToolContext,
) -> Result<ToolOutput, ErrorData> {
let action = get_str(args, "action").unwrap_or_else(|| "overview".to_string());
let path = get_str(args, "path");
let format = get_str(args, "format");
let root = if let Some(p) = ctx
.resolved_path("root")
.or(ctx.resolved_path("project_root"))
{
p
} else if let Some(err) = ctx.path_error("root").or(ctx.path_error("project_root")) {
return Err(ErrorData::invalid_params(format!("root: {err}"), None));
} else {
&ctx.project_root
};
let result = crate::tools::ctx_architecture::handle(
&action,
path.as_deref(),
root,
format.as_deref(),
);
Ok(ToolOutput::simple(result))
}
}