@team-agent/installer 0.5.112 → 0.5.113

package/crates/team-agent/src/cli/leaders.rs

@@ -124,7 +124,7 @@ fn send_hint(entry: &LeaderRegistryEntry) -> String {
     format!(
         "team-agent send {} {}",
         quote_cli_arg(&to),
-        quote_cli_arg("消息")
+        quote_cli_arg("message")
     )
 }
 
@@ -183,19 +183,19 @@ fn format_leaders_human(rows: &[LeaderRow], view: LeadersView) -> String {
     if rows.is_empty() {
         return match view {
             LeadersView::Live => {
-                "没有可用主控；运行 team-agent doctor --workspace . 检查当前队伍。\n".to_string()
+                "No live leaders. Run team-agent doctor --workspace . for the current team.\n".to_string()
             }
-            LeadersView::All => "没有已登记主控；首次协作用 team-agent pi 打开主控。\n".to_string(),
-            LeadersView::Stale => "没有已失效的主控登记。\n".to_string(),
+            LeadersView::All => "No registered leaders. Open a leader with team-agent pi for first-time collaboration.\n".to_string(),
+            LeadersView::Stale => "No stale leader registrations.\n".to_string(),
         };
     }
-    let mut out = String::from("主控\t状态\t项目\t队伍\t发送命令\n");
+    let mut out = String::from("leader\tstatus\tworkspace\tteam\tsend command\n");
     for row in rows {
         out.push_str("leader\t");
         out.push_str(match row.status {
-            "LIVE" => "可用",
-            "STALE" => "已失效",
-            "AMBIGUOUS" => "需确认归属",
+            "LIVE" => "LIVE",
+            "STALE" => "STALE",
+            "AMBIGUOUS" => "AMBIGUOUS",
             other => other,
         });
         out.push('\t');
@@ -212,7 +212,7 @@ fn format_leaders_human(rows: &[LeaderRow], view: LeadersView) -> String {
                     &row.entry.workspace,
                     Some(&row.entry.team_key),
                 )
-                .unwrap_or_else(|| "请核对项目路径".to_string()),
+                .unwrap_or_else(|| "Verify the workspace path".to_string()),
             );
         }
         out.push('\n');
@@ -240,33 +240,33 @@ fn prune_json(report: &RegistryPruneReport) -> Value {
 }
 
 fn format_prune_human(report: &RegistryPruneReport) -> String {
-    let mut out = format!("仅预览：{}\n", report.dry_run);
+    let mut out = format!("dry_run: {}\n", report.dry_run);
     for (label, items) in [
-        ("可清理登记", &report.candidates),
-        ("已清理", &report.removed),
-        ("保留", &report.kept),
-        ("跳过", &report.skipped),
-        ("错误", &report.errors),
+        ("candidates", &report.candidates),
+        ("removed", &report.removed),
+        ("kept", &report.kept),
+        ("skipped", &report.skipped),
+        ("errors", &report.errors),
     ] {
         out.push_str(&format!("{label}: {}\n", items.len()));
         for item in items {
             out.push_str("  ");
             out.push_str(&item.workspace.display().to_string());
-            out.push_str("，队伍：");
+            out.push_str(", team: ");
             out.push_str(&item.team_key);
             out.push_str(" [");
             out.push_str(match item.reason.as_str() {
-                "LIVE" => "仍可用，保留登记",
-                "team_key_not_found" => "队伍已不在项目中",
-                "team_not_alive" => "队伍已停止",
-                "registry_entry_missing" => "登记已不存在",
+                "LIVE" => "still live; registration retained",
+                "team_key_not_found" => "team no longer exists in the workspace",
+                "team_not_alive" => "team is stopped",
+                "registry_entry_missing" => "registration no longer exists",
                 "registry_entry_changed" | "canonical_state_changed" => {
-                    "登记或队伍已变化，停止清理"
+                    "registration or team changed; cleanup refused"
                 }
-                "canonical_state_unavailable" => "无法读取队伍状态，保留登记",
-                "registry_lock_unavailable" => "登记正被其他操作使用，停止清理",
-                "remove_failed" => "删除登记失败，请查看文件权限",
-                _ => "无法安全确认该登记；请体检所选项目",
+                "canonical_state_unavailable" => "team state unavailable; registration retained",
+                "registry_lock_unavailable" => "registry lock unavailable; cleanup refused",
+                "remove_failed" => "registration removal failed; inspect file permissions",
+                _ => "registration could not be verified safely; diagnose the selected workspace",
             });
             out.push_str("]\n");
         }
@@ -337,13 +337,13 @@ mod tests {
         assert_eq!(lines.len(), 3, "one header and both selected rows: {out}");
         let header = lines[0];
         assert_eq!(header.split('\t').count(), 5);
-        assert!(header.contains("状态") && header.contains("项目") && header.contains("队伍"));
+        assert!(header.contains("status") && header.contains("workspace") && header.contains("team"));
         let live: Vec<_> = lines[1].split('\t').collect();
         assert_eq!(
             &live[..4],
             &[
                 "leader",
-                "可用",
+                "LIVE",
                 "/Volumes/nvme/Projects/讨论team-agent",
                 "wiki-team"
             ]
@@ -354,7 +354,7 @@ mod tests {
                 "team-agent",
                 "send",
                 "leader",
-                "请完成任务并把答案回复给 leader。",
+                "Complete the task and reply to the leader.",
                 "--workspace",
                 "/Volumes/nvme/Projects/讨论team-agent",
                 "--team",
@@ -364,7 +364,7 @@ mod tests {
         let stale: Vec<_> = lines[2].split('\t').collect();
         assert_eq!(
             &stale[..4],
-            &["leader", "已失效", "/Users/alauda/stale", "old-team"]
+            &["leader", "STALE", "/Users/alauda/stale", "old-team"]
         );
         assert_eq!(stale[4], "-", "stale rows must never suggest a send: {out}");
     }
@@ -404,9 +404,9 @@ mod tests {
     #[test]
     fn empty_view_names_are_explicit() {
         for (view, empty, next) in [
-            (LeadersView::Live, "没有可用主控", Some("team-agent doctor")),
-            (LeadersView::Stale, "没有已失效的主控登记", None),
-            (LeadersView::All, "没有已登记主控", Some("team-agent pi")),
+            (LeadersView::Live, "No live leaders", Some("team-agent doctor")),
+            (LeadersView::Stale, "No stale leader registrations", None),
+            (LeadersView::All, "No registered leaders", Some("team-agent pi")),
         ] {
             let out = format_leaders_human(&[], view);
             assert!(out.contains(empty) && out.ends_with('\n'), "{out}");

package/crates/team-agent/src/cli/mod.rs

@@ -49,12 +49,12 @@ use crate::messaging::{self, MessageTarget, SendOptions, TrustedSender};
 use crate::model::ids::{TaskId, TeamKey};
 
 pub(crate) const COMMS_BOUNDARY_TEXT: &str =
-    "这里只检查终端连接是否一致，不实际发送消息，也不证明队友已回复。";
-pub(crate) const QUICK_START_REMINDER: &str = "下一步：向队友派发任务；用 team-agent status 看状态，用 team-agent inbox leader -n 3 看回复，不读取队友终端内容。";
+    "This checks terminal connection consistency only; it does not send a message or prove that a worker replied.";
+pub(crate) const QUICK_START_REMINDER: &str = "Next: send a task. Use team-agent status for status and team-agent inbox leader -n 3 for replies; do not inspect worker terminal content.";
 pub(crate) const SEND_REMINDER: &str =
-    "等队友真正回复，用 team-agent inbox leader -n 3 查看；不要读取队友终端内容。";
+    "Wait for an actual reply; use team-agent inbox leader -n 3. Do not inspect worker terminal content.";
 pub(crate) const STATUS_REMINDER: &str =
-    "下一步：用 team-agent inbox leader -n 3 查看回复；状态不是任务完成证明，不读取队友终端内容。";
+    "Next: use team-agent inbox leader -n 3 for replies. Status is not proof of task completion; do not inspect worker terminal content.";
 
 pub mod adapters;
 pub mod attach_app_server_leader;
@@ -4176,7 +4176,7 @@ pub mod lifecycle_port {
                     "team-agent".to_string(),
                     "send".to_string(),
                     "implementer".to_string(),
-                    "请完成任务并把答案回复给 leader。".to_string(),
+                    "Complete the task and reply to the leader.".to_string(),
                     "--workspace".to_string(),
                     team_dir.to_string_lossy().into_owned(),
                     "--team".to_string(),
@@ -4213,7 +4213,7 @@ pub mod lifecycle_port {
                     "team-agent".to_string(),
                     "send".to_string(),
                     "implementer".to_string(),
-                    "请完成任务并把答案回复给 leader。".to_string(),
+                    "Complete the task and reply to the leader.".to_string(),
                     "--workspace".to_string(),
                     team_dir.to_string_lossy().into_owned(),
                     "--team".to_string(),

package/crates/team-agent/src/cli/named_address.rs

@@ -78,16 +78,16 @@ pub(crate) struct NamedAddressError {
 
 pub(crate) fn human_address_reason(reason: &str) -> Option<&'static str> {
     Some(match reason {
-        "name_invalid" => "收信队友名不正确；请使用队友列表中的名称。",
-        "workspace_not_found" => "所选项目目录不存在；请核对项目路径。",
+        "name_invalid" => "Invalid recipient name; use a name from the agent list.",
+        "workspace_not_found" => "The selected workspace directory does not exist; verify the path.",
         "state_not_found" | "workspace_no_state" => {
-            "所选项目还没有可用队伍；首次起队用 quick-start，已有队伍恢复用 restart。"
+            "No usable team exists in the selected workspace; use quick-start for initial creation or restart for an initialized team."
         }
-        "team_key_not_found" => "所选项目没有这支队伍；请核对 --workspace 和 --team。",
-        "leader_not_attached" => "主控还没有连接到这支队伍；请先体检，按提示恢复连接。",
-        "name_not_resolvable" => "当前队伍没有这个队友；请先查看队友列表。",
-        "name_not_live" => "该队友当前未运行或连接已失效；请查看状态再恢复。",
-        "name_ambiguous" => "有多个同名对象；请明确选择项目和队伍，不猜对象。",
+        "team_key_not_found" => "The selected workspace has no such team; verify --workspace and --team.",
+        "leader_not_attached" => "No leader is attached to this team; diagnose it and follow the recovery action.",
+        "name_not_resolvable" => "This team has no such agent; check the agent list.",
+        "name_not_live" => "The agent is not running or its channel is stale; check status before recovery.",
+        "name_ambiguous" => "Multiple targets share this name; select an explicit workspace and team.",
         _ => return None,
     })
 }
@@ -121,23 +121,24 @@ impl NamedAddressError {
     pub(crate) fn human_guidance(&self, requested: &str) -> (String, String) {
         let workspace = self.human_scope.as_deref();
         let mut message = format!(
-            "{}\n你刚才填写的是 {requested:?}。",
-            human_address_reason(self.kind.as_str()).unwrap_or("未能找到可用的收信队友。")
+            "{}\nRequested recipient: {requested:?}\nReason: {}",
+            human_address_reason(self.kind.as_str()).unwrap_or("No usable recipient could be resolved."),
+            self.message
         );
         if let Some(workspace) = workspace {
-            message.push_str(&format!("\n所选项目：{:?}。", workspace.to_string_lossy()));
+            message.push_str(&format!("\nSelected workspace: {:?}", workspace.to_string_lossy()));
         }
         if let Some(team) = self.human_team.as_deref() {
-            message.push_str(&format!("\n所选队伍：{team:?}。"));
+            message.push_str(&format!("\nSelected team: {team:?}"));
         }
-        let mut action = "没有可靠的拼写建议；请先核对项目和队伍，不猜对象。".to_string();
+        let mut action = "No reliable spelling suggestion is available; verify the workspace and team before choosing a target.".to_string();
         for candidate in &self.candidates {
             if let (Some(agent), Some(team)) = (
                 candidate.get("agent_id").and_then(Value::as_str),
                 candidate.get("team_key").and_then(Value::as_str),
             ) {
                 message.push_str(&format!(
-                    "\n候选队伍 {team:?}，队友 {agent:?}；请确认是否是你要找的对象。"
+                    "\nCandidate team {team:?}, agent {agent:?}; confirm the intended target."
                 ));
             }
         }
@@ -162,7 +163,7 @@ impl NamedAddressError {
                     if let Some(command) =
                         super::adapters::send_command(agent, workspace, Some(team))
                     {
-                        action = format!("你是否想发给 {agent:?}、队伍 {team:?}？确认后将任务内容替换到这个例子；本次没有发送：\n{command}");
+                        action = format!("Did you mean agent {agent:?} in team {team:?}? After confirmation, replace the example message below. Nothing was sent:\n{command}");
                     }
                 }
             }
@@ -171,7 +172,7 @@ impl NamedAddressError {
             workspace.filter(|path| !path.to_string_lossy().chars().any(char::is_control))
         {
             action.push_str(&format!(
-                "\n也可查看可用队友列表：\nteam-agent status --workspace {}",
+                "\nList available agents with:\nteam-agent status --workspace {}",
                 super::adapters::shell_quote(&workspace.to_string_lossy())
             ));
         }

package/crates/team-agent/src/cli/route.rs

@@ -5,7 +5,7 @@ use crate::provider::argv_route::{self, Config, Mutation, Override, RouteError};
 use crate::provider::Provider;
 use serde_json::{json, Value};
 
-pub(crate) const HELP: &str = "做什么：\n设置工具启动时额外使用的命令行参数，默认关闭。\n用法：team-agent route [status|enable|disable|show [TOOL]|set TOOL -- ARG...|add TOOL -- ARG...|clear TOOL] [--json]\n\n怎么用：\nstatus 看开关；enable 开启；disable 关闭；show 看全部或指定工具的参数。\nset 替换参数；add 追加参数；clear 清除指定工具的参数；--json 给程序读取。\nTOOL 是已支持的工具名称，如 pi/codex/claude/copilot/grok/cursor_agent。\n第一个 -- 后全是工具的字面参数，包含 --help/--json 也不会被这里解析。\n配置保存在 ~/.team-agent/argv-routing.json；影响全机，不按项目或队伍隔离。\nTEAM_AGENT_CLI_ARGV_ROUTING 环境变量优先于保存的开关。\nExamples（可复制）：\nteam-agent route status\nteam-agent route set pi -- --mode text\nteam-agent route enable\n\n下一步（Next Action）：\n用 route show pi 核对参数；仅影响下一次启动，不改变正在运行的对话。\n没有开启或没有配置时，工具仍按原参数启动；不了解参数用途时保持关闭。";
+pub(crate) const HELP: &str = "Purpose:\nConfigure additional provider launch arguments. Disabled by default.\nUsage: team-agent route [status|enable|disable|show [TOOL]|set TOOL -- ARG...|add TOOL -- ARG...|clear TOOL] [--json]\n\nOptions:\nstatus reports the switch; enable/disable change it; show lists all or one provider's arguments.\nset replaces arguments; add appends; clear removes a provider's arguments. Use --json for structured output.\nTOOL is a supported provider name, such as pi/codex/claude/copilot/grok/cursor_agent.\nEverything after the first -- is a literal provider argument, including --help and --json.\nConfiguration: ~/.team-agent/argv-routing.json. This is host-global, not isolated by workspace or team.\nTEAM_AGENT_CLI_ARGV_ROUTING overrides the persisted switch.\nExamples:\nteam-agent route status\nteam-agent route set pi -- --mode text\nteam-agent route enable\n\nNext Action:\nVerify arguments with route show pi. Changes apply to the next launch, not an existing session.\nWithout an enabled configuration, providers retain their original arguments. Leave routing disabled unless the arguments are understood.";
 
 struct Request {
     operation: String,
@@ -16,9 +16,9 @@ struct Request {
 
 fn usage() -> RouteError {
     RouteError {
-        error: "参数不完整或不正确；set/add 需要工具名、-- 和至少一个工具参数".to_string(),
+        error: "Invalid or incomplete arguments; set/add require a provider name, -- and at least one provider argument".to_string(),
         reason: "argv_route_usage",
-        action: "请按 team-agent route --help 的 Examples 填写；例如 team-agent route set pi -- --mode text".to_string(),
+        action: "Follow the Examples in team-agent route --help, such as team-agent route set pi -- --mode text".to_string(),
         config_path: None,
     }
 }
@@ -118,7 +118,7 @@ fn execute(request: &Request) -> Result<Value, RouteError> {
     }
     if override_state != Override::Unset {
         value["notice"] = json!(format!(
-            "当前开关由环境变量 {} 决定（{}）",
+            "Switch overridden by environment variable {} ({})",
             argv_route::ENV_NAME,
             override_state.status()
         ));

package/crates/team-agent/src/cli/send/presentation.rs

@@ -20,7 +20,7 @@ pub(super) fn watch_notice_json(target: &MessageTarget, opts: &SendOptions) -> V
         "watcher_id": format!("watch-{agent_id}"),
         "task_id": opts.task_id.as_ref().map(|t| t.as_str().to_string()),
         "agent_id": agent_id,
-        "notice": "队友回复后会通知主控；用 team-agent inbox leader -n 3 查看。"
+        "notice": "The leader is notified when the agent replies; use team-agent inbox leader -n 3."
     })
 }
 
@@ -188,50 +188,51 @@ pub(super) fn send_human_output(value: &Value) -> String {
         let reason = value.get("reason").and_then(Value::as_str).unwrap_or("");
         let explanation =
             crate::cli::named_address::human_address_reason(reason).unwrap_or(match reason {
-                "target_not_in_team" | "unknown_recipient" => "当前队伍没有这个队友。",
+                "target_not_in_team" | "unknown_recipient" => "The selected team has no such agent.",
                 "missing_permissions" | "human_confirmation_required" => {
-                    "发送被拒绝：需要先确认交流权限。"
+                    "Send refused: communication permission or human confirmation is required."
                 }
                 "recipient_busy" | "recipient_pane_in_non_input_mode" => {
-                    "队友当前不能接收任务；请先查看其状态。"
+                    "The agent cannot receive a task now; check its status."
                 }
                 "routing_ambiguous" | "empty_target_list" | "ambiguous" => {
-                    "没有明确选定收信队友；请填写队友名和任务内容。"
+                    "No recipient was selected unambiguously; provide an agent name and task message."
                 }
                 "team_owner_mismatch" | "PaneWorkspaceMismatch" | "session_drift" => {
-                    "队伍或终端归属不匹配；已停止发送。"
+                    "Team or pane ownership mismatch; sending was refused."
                 }
                 "coordinator_unavailable" | "tmux_target_missing" => {
-                    "队伍连接暂不可用；本次没有确认送达。"
+                    "The team channel is unavailable; delivery was not confirmed."
                 }
                 "message_already_claimed" | "duplicate" => {
-                    "这条消息已由其他发送处理接收；不要重复发送。"
+                    "This message is already claimed or duplicated; do not resend."
                 }
-                "no_caller_pane" => "当前终端没有可用的队伍连接；请在主控的命令行/工具上下文发送。",
+                "no_caller_pane" => "The current terminal has no usable team channel; send from the leader's tool context.",
                 _ => value
                     .get("error")
                     .and_then(Value::as_str)
-                    .unwrap_or("发送未成功；没有确认任务已送达。"),
+                    .unwrap_or("Send was unsuccessful; task delivery was not confirmed."),
             });
-        let mut out = format!("{explanation}\n下一步：先运行 team-agent status，使用列表中的队友名；连接问题用 team-agent doctor --workspace .。不要反复重发。");
+        let details = crate::cli::triage::diagnostic_details(value);
+        let mut out = format!("{explanation}\nReport: {details}\nAdditional diagnosis: use team-agent status for agent names or team-agent doctor --workspace . for channel problems. Do not resend repeatedly.");
         if let Some(suggested) = value
             .get("suggested_name")
             .and_then(Value::as_str)
             .filter(|name| !name.is_empty() && !name.contains(['/', ':', ',', '\n', '\r']))
         {
             out.push_str(&format!(
-                "\n你是否想发给 {suggested}？确认后使用这个队友名。"
+                "\nDid you mean {suggested}? Confirm before using that agent name."
             ));
         }
         return out;
     }
     if value.get("status").and_then(Value::as_str) == Some("stored_only") {
-        return format!("已给{agent}留下消息；本次没有发送到当前对话。\n下一步：用 team-agent inbox leader -n 3 查看回复；留言不保证自动执行。");
+        return format!("Message stored for {agent}; it was not injected into the current conversation.\nNext: use team-agent inbox leader -n 3 for replies. Mailbox storage does not guarantee execution.");
     }
     if value.get("delivered").and_then(Value::as_bool) == Some(true) {
-        format!("已发给{agent}。{}", crate::cli::SEND_REMINDER)
+        format!("Delivered to {agent}. {}", crate::cli::SEND_REMINDER)
     } else {
-        "任务已收下，但还未送到队友的对话。\n下一步：查看 team-agent status 或 team-agent doctor --workspace .，等真实回复，不反复重发。".to_string()
+        "Task accepted, but delivery to the agent's conversation is still pending.\nNext: check team-agent status or team-agent doctor --workspace .; wait for an actual reply without repeated sends.".to_string()
     }
 }
 
@@ -251,7 +252,7 @@ pub(super) fn send_human_target(value: &Value) -> String {
             !name.is_empty() && *name != "*" && !name.contains(['/', ':', ',', '\n', '\r'])
         })
         .map(str::to_string)
-        .unwrap_or_else(|| "该队友".to_string())
+        .unwrap_or_else(|| "the recipient".to_string())
 }
 
 pub(super) fn send_human_status(value: &Value) -> String {
@@ -286,11 +287,11 @@ pub(super) fn send_reminder_for_value(value: &Value) -> &'static str {
     let status = value.get("status").and_then(Value::as_str);
     let delivery_status = value.get("delivery_status").and_then(Value::as_str);
     if status == Some("stored_only") {
-        "本次只留言，没有发送到当前对话；留言不保证自动执行。"
+        "Mailbox-only: not injected into the current conversation; storage does not guarantee execution."
     } else if delivered == Some(true) && delivery_status != Some("pending") {
         crate::cli::SEND_REMINDER
     } else {
-        "任务已收下，但还未确认送到队友对话。查看 team-agent status/doctor，等真实回复，不反复重发。"
+        "Task accepted, but delivery is unconfirmed. Check team-agent status/doctor; wait for an actual reply without repeated sends."
     }
 }
 

package/crates/team-agent/src/cli/send/resolve.rs

@@ -7,11 +7,11 @@ use serde_json::{json, Value};
 
 pub(super) fn warn_send_alias(flag: &str) {
     let spec = crate::cli::spec::command_spec("send");
-    let sunset = spec.and_then(|spec| spec.sunset).unwrap_or("后续兼容版本");
+    let sunset = spec.and_then(|spec| spec.sunset).unwrap_or("a future compatibility release");
     let action = spec.and_then(|spec| spec.action).unwrap_or(
-        "使用 team-agent send <agent> '任务内容'，通过 --workspace/--team 选择项目和队伍",
+        "Use team-agent send <agent> 'task message'; select the workspace and team with --workspace/--team",
     );
-    eprintln!("提示：{flag} 已弃用，将在{sunset}移除。下一步：{action}");
+    eprintln!("Warning: {flag} is deprecated and will be removed in {sunset}. Next: {action}");
 }
 
 pub(super) fn logical_to_from_args(
@@ -22,7 +22,7 @@ pub(super) fn logical_to_from_args(
         && (args.target.is_some() || args.targets.is_some() || args.to_leader.is_some())
     {
         return Err(CliError::Usage(
-            "队友名与 --to-name/--pane/--to 不能同时使用；请只选一种收信方式".to_string(),
+            "An agent name cannot be combined with --to-name/--pane/--to; choose one addressing mode".to_string(),
         ));
     }
     let supplied = [
@@ -36,7 +36,7 @@ pub(super) fn logical_to_from_args(
     .count();
     if supplied > 1 {
         return Err(CliError::Usage(
-            "队友名、--targets、--to-name 和 --to-leader 不能同时使用；请只选一种收信方式"
+            "An agent name, --targets, --to-name and --to-leader are mutually exclusive; choose one addressing mode"
                 .to_string(),
         ));
     }
@@ -52,11 +52,11 @@ pub(super) fn logical_to_from_args(
     if args.target.is_none() && supplied > 0 && args.message.is_empty() {
         if args.to_name.is_some() {
             return Err(CliError::Usage(
-                "请填写任务内容；--to-name 不能发送空消息".to_string(),
+                "Provide a task message; --to-name cannot send an empty message".to_string(),
             ));
         }
         return Err(CliError::Usage(
-            "请在队友名后填写非空任务内容；例如 team-agent send worker '检查改动'".to_string(),
+            "Provide a nonempty task message after the agent name, such as team-agent send worker 'Review the changes'".to_string(),
         ));
     }
     Ok(logical_to)
@@ -182,7 +182,7 @@ pub(super) fn send_to_logical_to(
         .collect::<Vec<_>>();
     if names.is_empty() || names.len() != logical_to.split(',').count() {
         return Err(CliError::Usage(
-            "收信列表中有空的队友名；请使用 status 返回的名称".to_string(),
+            "The recipient list contains an empty agent name; use names returned by status".to_string(),
         ));
     }
 
@@ -322,7 +322,7 @@ pub(super) fn adapt_positional_bare_error(
         .and_then(|suggested| suggested.rsplit('/').next())
         .map(str::to_string);
     if let Some(suggested) = error.suggested_name.as_deref() {
-        error.action = format!("你是否想发给 {suggested}？确认后使用此队友名；通过 --workspace/--team 选择项目和队伍。");
+        error.action = format!("Did you mean {suggested}? Confirm the agent name; select the workspace and team with --workspace/--team.");
     }
 }
 
@@ -336,7 +336,7 @@ pub(super) fn logical_recipient_id(
             .ok_or_else(|| CliError::Runtime("resolved worker is missing agent id".to_string())),
         crate::cli::named_address::NamedTargetKind::Leader => Ok("leader".to_string()),
         crate::cli::named_address::NamedTargetKind::SessionWindow => Err(CliError::Usage(
-            "不再支持按终端窗口发送；请使用队友名或 leader，并通过 --workspace/--team 选择队伍"
+            "Terminal-window addressing is no longer supported; use an agent name or leader, with --workspace/--team to select scope"
                 .to_string(),
         )),
     }
@@ -350,7 +350,7 @@ pub(super) fn send_to_resolved_name(
     let recipient = logical_recipient_id(resolved)?;
     if resolved.warning.is_some() {
         eprintln!(
-            "提示：旧收信方式已弃用；请用队友名发送，通过 --workspace/--team 选择项目和队伍。"
+            "Warning: legacy addressing is deprecated; send by agent name and select scope with --workspace/--team."
         );
     }
     let target = MessageTarget::Single(recipient);

package/crates/team-agent/src/cli/send.rs

@@ -41,20 +41,20 @@ pub fn cmd_send(args: &SendArgs) -> Result<CmdResult, CliError> {
             || args.to_leader.is_some()
         {
             let message = if args.to_name.is_some() {
-                "队友名与 --to-name/--pane/--to 不能同时使用；请只选一种收信方式"
+                "An agent name cannot be combined with --to-name/--pane/--to; choose one addressing mode"
             } else {
-                "--pane 不能与队友名、--to 或 --to-leader 同时使用"
+                "--pane cannot be combined with an agent name, --to or --to-leader"
             };
             return Err(CliError::Usage(message.to_string()));
         }
         let content = args.message.join(" ");
         if content.is_empty() {
             return Err(CliError::Usage(
-                "请填写任务内容；--pane 不能发送空消息".to_string(),
+                "Provide a task message; --pane cannot send an empty message".to_string(),
             ));
         }
         return Err(CliError::Usage(format!(
-            "--pane {pane_id} 已不再支持；请用 team-agent send <agent> '任务内容'，通过 --workspace/--team 选择项目和队伍"
+            "--pane {pane_id} is no longer supported; use team-agent send <agent> 'task message' with --workspace/--team to select scope"
         )));
     }
     if args.targets.is_some() {

package/crates/team-agent/src/cli/spec.rs

@@ -106,35 +106,35 @@ pub(crate) struct CommandSpec {
 // Only human operations belong here. Compatibility commands are private in emit.rs.
 #[rustfmt::skip]
 pub(crate) const COMMAND_SPECS: &[CommandSpec] = &[
-    CommandSpec { name: "quick-start", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::QuickStart), summary: "从角色文件启动队伍，或查看已有队伍的连接方式", usage: "team-agent quick-start [TEAMDIR] [--workspace WORKSPACE] [--team TEAM] [--name NAME] [--team-id TEAM] [--yes] [--backend tmux|conpty] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "send", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Send), summary: "向指定队友派发任务", usage: "team-agent send <agent> MESSAGE... [--workspace WORKSPACE] [--team TEAM] [--mailbox] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: Some("后续兼容版本"), action: Some("使用 team-agent send <agent> '任务内容'，用 --workspace 和 --team 选择队伍"), governance: None },
-    CommandSpec { name: "status", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Status), summary: "查看队友状态，不读取队友的对话内容", usage: "team-agent status [<agent>] [--workspace WORKSPACE] [--team TEAM] [--json] [--summary|--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "models", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Models), summary: "查找工具实际支持的模型名称", usage: "team-agent models [--provider pi|cursor_agent|codex|claude|claude_code|grok] [QUERY|--search TEXT] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "inbox", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Inbox), summary: "查看队友回复", usage: "team-agent inbox <agent> [-n N|--limit N] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "restart", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Restart), summary: "恢复已有队伍，优先沿用已保存的会话", usage: "team-agent restart [WORKSPACE] [--team TEAM] [--allow-fresh] [--session-converge-deadline SECONDS] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "shutdown", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Shutdown), summary: "关闭指定队伍，并查看是否仍有残留资源", usage: "team-agent shutdown [--workspace WORKSPACE] [--team TEAM] [--keep-logs] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "add-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::AddAgent), summary: "新增并启动一位队友", usage: "team-agent add-agent <agent> [--role-file FILE] [--provider TOOL] [--model MODEL] [--effort LEVEL] [--bypass true|false] [--prompt TEXT] [--profile NAME] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "start-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::StartAgent), summary: "启动队伍中已有的队友", usage: "team-agent start-agent <agent> [--provider TOOL] [--model MODEL] [--effort LEVEL] [--bypass true|false] [--prompt TEXT] [--profile NAME] [--workspace WORKSPACE] [--team TEAM] [--allow-fresh] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "stop-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::StopAgent), summary: "暂停一位队友，保留其配置和会话记录", usage: "team-agent stop-agent <agent> [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "reset-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::ResetAgent), summary: "清除队友保存的会话关联", usage: "team-agent reset-agent <agent> --discard-session [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "clone-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::CloneAgent), summary: "复制队友配置，创建新队友", usage: "team-agent clone-agent <agent> --as NEW_AGENT [--label LABEL] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "fork-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::ForkAgent), summary: "在工具支持的条件下从队友会话分出新队友", usage: "team-agent fork-agent <agent> --as NEW_AGENT [--label LABEL] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "remove-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::RemoveAgent), summary: "确认后移除一位队友", usage: "team-agent remove-agent <agent> --confirm [--workspace WORKSPACE] [--team TEAM] [--from-spec] [--force] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "leaders", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Leaders), summary: "查看本机可用的主控及其所属队伍", usage: "team-agent leaders [QUERY|--search TEXT] [--all|--stale] [--json] | --prune [--dry-run] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "doctor", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Doctor), summary: "检查队伍并给出恢复建议，默认不修复", usage: "team-agent doctor [SPEC] [--workspace WORKSPACE] [--team TEAM] [--comms] [--gate orphans|comms] [--fix] [--fix-schema] [--cleanup-orphans] [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "approvals", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Approvals), summary: "查看队友正在等待的权限确认", usage: "team-agent approvals [<agent>] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "route", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::Route), summary: "设置工具启动时额外使用的命令行参数", usage: "team-agent route [status|enable|disable|show [TOOL]|set TOOL -- ARG...|add TOOL -- ARG...|clear TOOL] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "profile", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::Profile), summary: "管理登录方式和代理设置", usage: "team-agent profile init|doctor|show NAME [--workspace WORKSPACE] [--team TEAM] [--auth-mode MODE] [--proxy-mode direct|inherit] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "install-skill", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::InstallSkill), summary: "可选：安装已有的公开操作指南", usage: "team-agent install-skill (--source DIR|--uninstall) [--target codex|claude|copilot|all] [--dest DIR] [--dry-run] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "claim-leader", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::ClaimLeader), summary: "仅按体检提示，将当前终端登记为主控", usage: "team-agent claim-leader [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "takeover", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::Takeover), summary: "仅按体检提示，确认后接管现有队伍", usage: "team-agent takeover [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "attach-leader", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::AttachLeader), summary: "仅按体检提示，将已核验的终端连接为主控", usage: "team-agent attach-leader [--workspace WORKSPACE] [--team TEAM] --pane PANE --provider TOOL [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
-    CommandSpec { name: "pi", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "pi" }, summary: "用 Pi 打开主控对话", usage: "team-agent pi [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "codex", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "codex" }, summary: "用 Codex 打开主控对话", usage: "team-agent codex [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "claude", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "claude" }, summary: "用 Claude Code 打开主控对话", usage: "team-agent claude [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "copilot", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "copilot" }, summary: "用 Copilot 打开主控对话", usage: "team-agent copilot [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "grok", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "grok" }, summary: "用 Grok 打开主控对话", usage: "team-agent grok [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
-    CommandSpec { name: "cursor", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "cursor_agent" }, summary: "用 Cursor 的 agent 工具打开主控对话", usage: "team-agent cursor [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "quick-start", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::QuickStart), summary: "Create a team from role files; use restart for an initialized team", usage: "team-agent quick-start [TEAMDIR] [--workspace WORKSPACE] [--team TEAM] [--name NAME] [--team-id TEAM] [--yes] [--backend tmux|conpty] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "send", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Send), summary: "Send a task to a specified agent", usage: "team-agent send <agent> MESSAGE... [--workspace WORKSPACE] [--team TEAM] [--mailbox] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: Some("a future compatibility release"), action: Some("Use team-agent send <agent> 'task message'; select scope with --workspace and --team"), governance: None },
+    CommandSpec { name: "status", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Status), summary: "Check agent status without reading conversation content", usage: "team-agent status [<agent>] [--workspace WORKSPACE] [--team TEAM] [--json] [--summary|--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "models", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Models), summary: "Discover model names supported by the native provider", usage: "team-agent models [--provider pi|cursor_agent|codex|claude|claude_code|grok] [QUERY|--search TEXT] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "inbox", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Inbox), summary: "Read agent replies", usage: "team-agent inbox <agent> [-n N|--limit N] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "restart", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Restart), summary: "Restart an existing team using saved sessions when available", usage: "team-agent restart [WORKSPACE] [--team TEAM] [--allow-fresh] [--session-converge-deadline SECONDS] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "shutdown", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Shutdown), summary: "Shut down the selected team and report residual resources", usage: "team-agent shutdown [--workspace WORKSPACE] [--team TEAM] [--keep-logs] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "add-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::AddAgent), summary: "Add and start an agent", usage: "team-agent add-agent <agent> [--role-file FILE] [--provider TOOL] [--model MODEL] [--effort LEVEL] [--bypass true|false] [--prompt TEXT] [--profile NAME] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "start-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::StartAgent), summary: "Start an existing team agent", usage: "team-agent start-agent <agent> [--provider TOOL] [--model MODEL] [--effort LEVEL] [--bypass true|false] [--prompt TEXT] [--profile NAME] [--workspace WORKSPACE] [--team TEAM] [--allow-fresh] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "stop-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::StopAgent), summary: "Stop an agent while retaining configuration and session history", usage: "team-agent stop-agent <agent> [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "reset-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::ResetAgent), summary: "Discard an agent's saved session association", usage: "team-agent reset-agent <agent> --discard-session [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "clone-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::CloneAgent), summary: "Clone agent configuration into a new agent", usage: "team-agent clone-agent <agent> --as NEW_AGENT [--label LABEL] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "fork-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::ForkAgent), summary: "Fork an agent session where supported by the provider", usage: "team-agent fork-agent <agent> --as NEW_AGENT [--label LABEL] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "remove-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::RemoveAgent), summary: "Remove an agent after confirmation", usage: "team-agent remove-agent <agent> --confirm [--workspace WORKSPACE] [--team TEAM] [--from-spec] [--force] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "leaders", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Leaders), summary: "List local leaders and their team scopes", usage: "team-agent leaders [QUERY|--search TEXT] [--all|--stale] [--json] | --prune [--dry-run] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "doctor", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Doctor), summary: "Diagnose a team and suggest recovery; read-only by default", usage: "team-agent doctor [SPEC] [--workspace WORKSPACE] [--team TEAM] [--comms] [--gate orphans|comms] [--fix] [--fix-schema] [--cleanup-orphans] [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "approvals", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Approvals), summary: "List pending agent approvals", usage: "team-agent approvals [<agent>] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "route", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::Route), summary: "Configure additional provider launch arguments", usage: "team-agent route [status|enable|disable|show [TOOL]|set TOOL -- ARG...|add TOOL -- ARG...|clear TOOL] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "profile", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::Profile), summary: "Manage authentication and proxy profiles", usage: "team-agent profile init|doctor|show NAME [--workspace WORKSPACE] [--team TEAM] [--auth-mode MODE] [--proxy-mode direct|inherit] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "install-skill", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::InstallSkill), summary: "Optionally install an existing public operation skill", usage: "team-agent install-skill (--source DIR|--uninstall) [--target codex|claude|copilot|all] [--dest DIR] [--dry-run] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "claim-leader", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::ClaimLeader), summary: "Register the current terminal as leader only when diagnosis recommends it", usage: "team-agent claim-leader [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "takeover", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::Takeover), summary: "Take over an existing team only after diagnosis and confirmation", usage: "team-agent takeover [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "attach-leader", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::AttachLeader), summary: "Attach a verified leader terminal only when diagnosis recommends it", usage: "team-agent attach-leader [--workspace WORKSPACE] [--team TEAM] --pane PANE --provider TOOL [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
+    CommandSpec { name: "pi", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "pi" }, summary: "Open a leader session with Pi", usage: "team-agent pi [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "codex", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "codex" }, summary: "Open a leader session with Codex", usage: "team-agent codex [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "claude", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "claude" }, summary: "Open a leader session with Claude Code", usage: "team-agent claude [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "copilot", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "copilot" }, summary: "Open a leader session with Copilot", usage: "team-agent copilot [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "grok", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "grok" }, summary: "Open a leader session with Grok", usage: "team-agent grok [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
+    CommandSpec { name: "cursor", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "cursor_agent" }, summary: "Open a leader session with Cursor agent", usage: "team-agent cursor [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
 ];
 
 pub(crate) fn command_spec(name: &str) -> Option<&'static CommandSpec> {