use mcp_host::prelude::*;
use mcp_host::registry::router::McpToolRouter;
use serde_json::{Value, json};
use super::super::McpState;
use super::json_output;
use super::manifest_inspect::ManifestPathParams;
const STAGES: [&str; 3] = ["read", "parse", "validate"];
impl McpState {
#[mcp_tool(
name = "manifest_validate",
description = "Validate a blackship.toml by stage (read, parse, validate); returns the failed stage and diagnostics.",
read_only = true,
idempotent = true
)]
async fn manifest_validate(
&self,
_ctx: Ctx<'_>,
params: Parameters<ManifestPathParams>,
) -> ToolResult {
let path = self.manifest_path(params.0.path.as_deref());
let outcome = validate_stages(&path);
json_output(&outcome)
}
}
fn validate_stages(path: &std::path::Path) -> Value {
let base = json!({
"path": path.display().to_string(),
"stages": STAGES,
});
let content = match crate::manifest::read_config_file(path) {
Ok(content) => content,
Err(e) => return failure(base, "read", &e.to_string()),
};
validate_text(base, &content)
}
pub(in crate::mcp) fn validate_text(base: Value, content: &str) -> Value {
let config: crate::manifest::BlackshipConfig = match toml::from_str(content) {
Ok(config) => config,
Err(e) => return parse_failure(base, content, &e),
};
if let Err(e) = config.validate() {
return failure(base, "validate", &e.to_string());
}
merge(
base,
json!({
"valid": true,
"failed_stage": Value::Null,
"jails": config.jails.iter().map(|jail| jail.name.clone()).collect::<Vec<_>>(),
"warnings": crate::provision::unbootstrapped_releases(&config),
}),
)
}
fn parse_failure(base: Value, content: &str, error: &toml::de::Error) -> Value {
let (line, column) = error.span().map_or((Value::Null, Value::Null), |span| {
let (line, column) = byte_to_line_col(content, span.start);
(json!(line), json!(column))
});
merge(
base,
json!({
"valid": false,
"failed_stage": "parse",
"diagnostics": [{
"line": line,
"column": column,
"message": error.message(),
}],
}),
)
}
fn failure(base: Value, stage: &str, message: &str) -> Value {
merge(
base,
json!({
"valid": false,
"failed_stage": stage,
"diagnostics": [{ "line": Value::Null, "column": Value::Null, "message": message }],
}),
)
}
fn merge(mut base: Value, extra: Value) -> Value {
if let (Some(target), Value::Object(source)) = (base.as_object_mut(), extra) {
target.extend(source);
}
base
}
pub fn mount(router: McpToolRouter<McpState>) -> McpToolRouter<McpState> {
router.with_tool(
McpState::manifest_validate_tool_info(),
McpState::manifest_validate_handler,
None,
)
}
#[cfg(test)]
#[path = "manifest_validate/tests.rs"]
mod tests;