Function run_tool 

pub async fn run_tool(
    spec: &ToolSpec,
    root: &Path,
    files: &[String],
) -> ToolOutcome

Run one deterministic tool over some files.

Never returns an error and never panics for an absent or failing tool; that is reported as ToolStatus::Unavailable so the caller can surface it rather than mistake it for a clean result.