@team-agent/installer 0.5.65 → 0.5.68

package/crates/team-agent/src/lifecycle/tests/grok_mcp_overlay_red.rs

@@ -0,0 +1,498 @@
+//! purpose: grok 席位必须把 team-agent MCP 写进 grok 实际会读的项目配置
+//! contract: grok worker spawn 之后 `<workspace>/.grok/config.toml` 含
+//!   `[mcp_servers.team_orchestrator]`，command/args/env 已替换成这次席位的真实值
+//!   （不是 `{workspace}` 占位，也不是 `.team/runtime/mcp/*.json`）
+//! boundary: 只覆盖 grok launch 产物；不改 claude/codex/copilot 路径
+//!
+//! 修之前判红：基线只把 MCP 写到 `.team/runtime/mcp/<agent>.json`，grok CLI
+//! 不读那份文件，所以项目作用域 config.toml 不会出现已解析的 team-agent 段。
+
+#![allow(clippy::unwrap_used, clippy::expect_used, clippy::panic)]
+
+#[path = "../../../tests/support/hermetic.rs"]
+mod hermetic_guard;
+#[allow(dead_code)]
+fn _hermetic_boundary_marker(_: &hermetic_guard::HermeticTestEnv) {}
+
+use std::path::{Path, PathBuf};
+use std::sync::atomic::{AtomicU64, Ordering};
+
+use serial_test::serial;
+use team_agent::lifecycle::quick_start_with_transport_in_workspace;
+use team_agent::lifecycle::{
+    apply_grok_mcp_overlay, ensure_grok_login_and_folder_trust, LifecycleError,
+};
+use team_agent::provider::McpConfig;
+use team_agent::transport::test_support::OfflineTransport;
+
+#[test]
+fn grok_overlay_writes_canonical_team_orchestrator_server_name() {
+    let ws = tmp_dir("grok-mcp-name");
+    apply_grok_mcp_overlay(&ws, &sample_mcp_config("name-seat", "/ws-name"))
+        .expect("overlay write");
+    let text = std::fs::read_to_string(ws.join(".grok/config.toml")).unwrap();
+    assert!(
+        text.contains("[mcp_servers.team_orchestrator]"),
+        "grok overlay must use the canonical server name the runtime contract cites; text={text}"
+    );
+    assert!(
+        text.contains("[mcp_servers.team_orchestrator.env]"),
+        "env table must sit under team_orchestrator, not a second name; text={text}"
+    );
+    assert!(
+        !text.contains("mcp_servers.team-agent"),
+        "canonical name is team_orchestrator; leftover team-agent would namespace tools as team-agent__*; text={text}"
+    );
+}
+
+#[test]
+fn grok_overlay_migrates_legacy_team_agent_table_away() {
+    let ws = tmp_dir("grok-mcp-migrate");
+    let grok = ws.join(".grok");
+    std::fs::create_dir_all(&grok).unwrap();
+    std::fs::write(
+        grok.join("config.toml"),
+        r#"[mcp_servers.keep-me]
+command = "/bin/keep"
+
+[mcp_servers.team-agent]
+command = "/old/team-agent"
+args = ["stale"]
+enabled = true
+
+[mcp_servers.team-agent.env]
+TEAM_AGENT_WORKSPACE = "/stale-ws"
+"#,
+    )
+    .unwrap();
+
+    apply_grok_mcp_overlay(&ws, &sample_mcp_config("migrated-seat", "/ws-migrated"))
+        .expect("overlay migrate");
+    let text = std::fs::read_to_string(grok.join("config.toml")).unwrap();
+
+    assert!(
+        !text.contains("mcp_servers.team-agent"),
+        "legacy [mcp_servers.team-agent] must be removed or grok exposes two Team MCP servers; text={text}"
+    );
+    assert!(
+        text.contains("[mcp_servers.team_orchestrator]"),
+        "migrated file must declare the canonical server; text={text}"
+    );
+    assert!(
+        !text.contains("TEAM_AGENT_ID")
+            && !text.contains("TEAM_AGENT_OWNER_TEAM_ID")
+            && !text.contains("TEAM_AGENT_AUTH_MODE")
+            && text.contains("TEAM_AGENT_WORKSPACE = \"/ws-migrated\""),
+        "per-seat keys must not land on the shared toml; workspace env must survive rename; text={text}"
+    );
+    assert!(
+        text.contains("[mcp_servers.keep-me]"),
+        "unrelated project MCP servers must survive the rename; text={text}"
+    );
+    assert!(
+        !text.contains("stale-id") && !text.contains("/old/team-agent"),
+        "stale identity/command from the old table must not remain; text={text}"
+    );
+}
+
+#[test]
+fn grok_overlay_clears_existing_per_seat_keys_instead_of_writing_them() {
+    // 已废除的行为：旧实现把每席键迁进共享 toml（目录作用域 ⇒ 所有 grok 席互相继承），此断言证明它确实没了。
+    let ws = tmp_dir("grok-mcp-clear-per-seat");
+    let grok = ws.join(".grok");
+    std::fs::create_dir_all(&grok).unwrap();
+    std::fs::write(
+        grok.join("config.toml"),
+        r#"[mcp_servers.team-agent]
+command = "/old/team-agent"
+
+[mcp_servers.team-agent.env]
+TEAM_AGENT_ID = "stale-id"
+TEAM_AGENT_OWNER_TEAM_ID = "stale-team"
+TEAM_AGENT_AUTH_MODE = "subscription"
+"#,
+    )
+    .unwrap();
+
+    apply_grok_mcp_overlay(&ws, &sample_mcp_config("migrated-seat", "/ws-migrated"))
+        .expect("leftover per-seat keys must be cleared, not refuse the overlay");
+    let text = std::fs::read_to_string(grok.join("config.toml")).unwrap();
+    assert!(
+        !text.contains("TEAM_AGENT_ID")
+            && !text.contains("TEAM_AGENT_OWNER_TEAM_ID")
+            && !text.contains("TEAM_AGENT_AUTH_MODE")
+            && !text.contains("stale-id")
+            && text.contains("TEAM_AGENT_WORKSPACE = \"/ws-migrated\""),
+        "overlay must strip leftover per-seat keys and not write incoming ones; text={text}"
+    );
+    let events = team_agent::event_log::EventLog::new(&ws)
+        .tail(0)
+        .expect("events");
+    let cleared = events.iter().find(|event| {
+        event.get("event").and_then(serde_json::Value::as_str)
+            == Some("lifecycle.grok_toml.per_seat_keys_cleared")
+    });
+    let cleared =
+        cleared.unwrap_or_else(|| panic!("cleanup must leave an audit event; events={events:?}"));
+    let keys = cleared
+        .get("keys")
+        .and_then(serde_json::Value::as_array)
+        .cloned()
+        .unwrap_or_default();
+    assert!(
+        keys.iter().any(|key| key.as_str() == Some("TEAM_AGENT_ID"))
+            && keys
+                .iter()
+                .any(|key| key.as_str() == Some("TEAM_AGENT_OWNER_TEAM_ID"))
+            && keys
+                .iter()
+                .any(|key| key.as_str() == Some("TEAM_AGENT_AUTH_MODE")),
+        "audit must name the cleared keys; event={cleared}"
+    );
+    let serialized = cleared.to_string();
+    assert!(
+        !serialized.contains("stale-id") && !serialized.contains("stale-team"),
+        "audit must not carry key values; event={cleared}"
+    );
+    assert_eq!(
+        cleared.get("path").and_then(serde_json::Value::as_str),
+        Some(grok.join("config.toml").to_string_lossy().as_ref()),
+        "audit must name the file; event={cleared}"
+    );
+}
+
+fn sample_mcp_config(agent_id: &str, workspace: &str) -> McpConfig {
+    McpConfig {
+        raw: serde_json::json!({
+            "team_orchestrator": {
+                "command": "/bin/team-agent-test",
+                "args": ["mcp-server", "--workspace", workspace],
+                "env": {
+                    "TEAM_AGENT_ID": agent_id,
+                    "TEAM_AGENT_WORKSPACE": workspace,
+                    "TEAM_AGENT_OWNER_TEAM_ID": "t1",
+                    "TEAM_AGENT_AUTH_MODE": "subscription",
+                }
+            }
+        }),
+    }
+}
+
+#[test]
+#[serial(env)]
+fn two_grok_seats_coexist_when_toml_has_no_per_seat_keys() {
+    let ws = tmp_dir("grok-cwd-coexist");
+    let home = tmp_dir("grok-cwd-coexist-home");
+    seed_grok_home(&home, Some(&ws));
+    let _guard = HomeGuard::set(&home);
+    let team = write_grok_team_agents(&ws, "grokteam", &["g1", "g2"]);
+
+    quick_start_with_transport_in_workspace(
+        &ws,
+        &team,
+        None,
+        true,
+        Some("grokteam"),
+        &OfflineTransport::new(),
+    )
+    .expect("two grok seats must start when the shared toml has no per-seat keys");
+
+    let text = std::fs::read_to_string(ws.join(".grok/config.toml")).unwrap_or_default();
+    assert!(
+        !text.contains("TEAM_AGENT_ID")
+            && !text.contains("TEAM_AGENT_OWNER_TEAM_ID")
+            && !text.contains("TEAM_AGENT_AUTH_MODE"),
+        "overlay must not write per-seat keys; text={text}"
+    );
+}
+
+#[test]
+#[serial(env)]
+fn leftover_per_seat_key_is_cleared_before_start() {
+    let ws = tmp_dir("grok-cwd-per-seat");
+    let home = tmp_dir("grok-cwd-per-seat-home");
+    seed_grok_home(&home, Some(&ws));
+    let _guard = HomeGuard::set(&home);
+    let grok = ws.join(".grok");
+    std::fs::create_dir_all(&grok).unwrap();
+    std::fs::write(
+        grok.join("config.toml"),
+        "[mcp_servers.keep-me.env]\nTEAM_AGENT_FUTURE_SEAT_KEY = \"leaked\"\nGROK_FOLDER_TRUST = \"1\"\n",
+    )
+    .unwrap();
+    let team = write_grok_team_agents(&ws, "grokteam", &["g1", "g2"]);
+
+    quick_start_with_transport_in_workspace(
+        &ws,
+        &team,
+        None,
+        true,
+        Some("grokteam"),
+        &OfflineTransport::new(),
+    )
+    .expect("leftover per-seat keys must be cleared, not refuse start");
+
+    let text = std::fs::read_to_string(ws.join(".grok/config.toml")).unwrap_or_default();
+    assert!(
+        !text.contains("TEAM_AGENT_FUTURE_SEAT_KEY") && !text.contains("leaked"),
+        "upgrade migration must drop the leftover per-seat key; text={text}"
+    );
+    assert!(
+        text.contains("GROK_FOLDER_TRUST"),
+        "non-framework keys must stay; text={text}"
+    );
+}
+
+#[test]
+fn overlay_preserves_unknown_env_keys_on_the_shared_table() {
+    let ws = tmp_dir("grok-mcp-keep-unknown");
+    let grok = ws.join(".grok");
+    std::fs::create_dir_all(&grok).unwrap();
+    std::fs::write(
+        grok.join("config.toml"),
+        r#"[mcp_servers.team_orchestrator]
+command = "/old/team-agent"
+
+[mcp_servers.team_orchestrator.env]
+TEAM_AGENT_ID = "stale-id"
+GROK_FOLDER_TRUST = "1"
+USER_EXTRA = "keep-me"
+TEAM_AGENT_WORKSPACE = "/stale-ws"
+"#,
+    )
+    .unwrap();
+
+    apply_grok_mcp_overlay(&ws, &sample_mcp_config("keep-seat", "/ws-keep"))
+        .expect("overlay must keep unknown keys while dropping per-seat ones");
+    let text = std::fs::read_to_string(grok.join("config.toml")).unwrap();
+    assert!(
+        !text.contains("TEAM_AGENT_ID") && !text.contains("stale-id"),
+        "per-seat keys must leave; text={text}"
+    );
+    assert!(
+        text.contains("GROK_FOLDER_TRUST = \"1\"") && text.contains("USER_EXTRA = \"keep-me\""),
+        "unknown env keys must survive the stanza rewrite with the same value; text={text}"
+    );
+    assert!(
+        text.contains("TEAM_AGENT_WORKSPACE = \"/ws-keep\""),
+        "incoming workspace must win over the stale disk value; text={text}"
+    );
+}
+
+#[test]
+#[serial(env)]
+fn grok_untrusted_folder_refuses_to_start() {
+    let ws = tmp_dir("grok-untrusted");
+    let home = tmp_dir("grok-untrusted-home");
+    seed_grok_home(&home, None);
+    let _guard = HomeGuard::set(&home);
+    let team = write_grok_team(&ws, "grokteam", "grok_writer");
+    let err = quick_start_with_transport_in_workspace(
+        &ws,
+        &team,
+        None,
+        true,
+        Some("grokteam"),
+        &OfflineTransport::new(),
+    )
+    .expect_err("untrusted folder must not start a grok seat");
+    let text = err.to_string();
+    assert!(
+        text.contains("not trusted") && text.contains("action:"),
+        "untrusted-folder error must be actionable; err={text}"
+    );
+    assert!(
+        text.contains("grok --trust") || text.contains("/hooks-trust"),
+        "next step must name grok --trust or /hooks-trust; err={text}"
+    );
+}
+
+#[test]
+#[serial(env)]
+fn grok_missing_login_refuses_to_start() {
+    let ws = tmp_dir("grok-nologin");
+    let home = tmp_dir("grok-nologin-home");
+    std::fs::create_dir_all(home.join(".grok")).unwrap();
+    std::fs::write(
+        home.join(".grok").join("trusted_folders.toml"),
+        format!("[folders.\"{}\"]\ntrusted = true\n", ws.display()),
+    )
+    .unwrap();
+    let _guard = HomeGuard::set(&home);
+    let err = ensure_grok_login_and_folder_trust(&ws).expect_err("missing auth.json");
+    match err {
+        LifecycleError::RequirementUnmet(text) => {
+            assert!(
+                text.contains("grok login") && text.contains("action:"),
+                "login error must tell the operator to run grok login; err={text}"
+            );
+        }
+        other => panic!("expected RequirementUnmet, got {other:?}"),
+    }
+}
+
+#[test]
+#[serial(env)]
+fn grok_spawn_writes_resolved_team_agent_into_project_grok_config() {
+    let ws = tmp_dir("grok-mcp-overlay");
+    let home = tmp_dir("grok-mcp-overlay-home");
+    seed_grok_home(&home, Some(&ws));
+    let _guard = HomeGuard::set(&home);
+    let team = write_grok_team(&ws, "grokteam", "grok_writer");
+    let config_path = ws.join(".grok").join("config.toml");
+    assert!(
+        !config_path.exists(),
+        "precondition: project grok config must be absent before spawn; path={}",
+        config_path.display()
+    );
+
+    quick_start_with_transport_in_workspace(
+        &ws,
+        &team,
+        None,
+        true,
+        Some("grokteam"),
+        &OfflineTransport::new(),
+    )
+    .expect("grok quick-start through offline transport should spawn");
+
+    let text = std::fs::read_to_string(&config_path).unwrap_or_else(|err| {
+        panic!(
+            "grok spawn must materialize {}; grok CLI only reads this project-scope file: {err}",
+            config_path.display()
+        )
+    });
+    let expected_command = current_team_agent_command();
+    let workspace = ws.to_string_lossy();
+
+    assert!(
+        text.contains("[mcp_servers.team_orchestrator]"),
+        "grok project config must declare [mcp_servers.team_orchestrator]; path={} text={text}",
+        config_path.display()
+    );
+    assert!(
+        text.contains(&format!("command = \"{expected_command}\""))
+            || text.contains(&format!("command = '{expected_command}'")),
+        "command must be the running team-agent binary, not a PATH name; expected={expected_command} text={text}"
+    );
+    assert!(
+        text.contains("\"mcp-server\"") && text.contains("\"--workspace\""),
+        "args must launch mcp-server; text={text}"
+    );
+    assert!(
+        text.contains(&format!("\"{workspace}\""))
+            || text.contains(&format!("'{workspace}'")),
+        "args/--workspace must be the real workspace, not {{workspace}}; workspace={workspace} text={text}"
+    );
+    assert!(
+        !text.contains("{workspace}")
+            && !text.contains("{agent_id}")
+            && !text.contains("{team_id}"),
+        "placeholders must be resolved before grok reads the file; text={text}"
+    );
+    assert!(
+        text.contains("enabled = true"),
+        "grok mcp add --scope project writes enabled = true; text={text}"
+    );
+    assert!(
+        text.contains("[mcp_servers.team_orchestrator.env]"),
+        "identity env must be under [mcp_servers.team_orchestrator.env]; text={text}"
+    );
+    assert!(
+        !text.contains("mcp_servers.team-agent"),
+        "spawned overlay must not leave the misnamed team-agent table; text={text}"
+    );
+    assert!(
+        !text.contains("TEAM_AGENT_ID"),
+        "shared grok toml must not carry TEAM_AGENT_ID (pane env is the carrier); text={text}"
+    );
+    assert!(
+        text.contains(&format!("TEAM_AGENT_WORKSPACE = \"{workspace}\""))
+            || text.contains(&format!("TEAM_AGENT_WORKSPACE = '{workspace}'")),
+        "TEAM_AGENT_WORKSPACE must match spawn cwd; workspace={workspace} text={text}"
+    );
+    assert!(
+        !text.contains("TEAM_AGENT_OWNER_TEAM_ID") && !text.contains("TEAM_AGENT_AUTH_MODE"),
+        "shared grok toml must not carry per-seat OWNER/AUTH; text={text}"
+    );
+}
+
+fn current_team_agent_command() -> String {
+    let exe = std::env::current_exe().expect("current_exe");
+    match std::fs::canonicalize(&exe) {
+        Ok(canon) => canon.to_string_lossy().into_owned(),
+        Err(_) => exe.to_string_lossy().into_owned(),
+    }
+}
+
+fn write_grok_team(ws: &Path, team_key: &str, agent_id: &str) -> PathBuf {
+    write_grok_team_agents(ws, team_key, &[agent_id])
+}
+
+fn write_grok_team_agents(ws: &Path, team_key: &str, agent_ids: &[&str]) -> PathBuf {
+    let team = ws.join(team_key);
+    std::fs::create_dir_all(team.join("agents")).unwrap();
+    std::fs::write(
+        team.join("TEAM.md"),
+        format!(
+            "---\nname: {team_key}\nobjective: grok MCP overlay contract.\nprovider: grok\ndangerously_skip_permissions: false\n---\n\nTeam.\n"
+        ),
+    )
+    .unwrap();
+    for agent_id in agent_ids {
+        std::fs::write(
+            team.join("agents").join(format!("{agent_id}.md")),
+            format!(
+                "---\nname: {agent_id}\nrole: Grok Writer\nprovider: grok\nmodel: grok-4\nauth_mode: subscription\ndangerously_skip_permissions: false\ntools:\n  - mcp_team\n---\n\nWorker.\n"
+            ),
+        )
+        .unwrap();
+    }
+    team
+}
+
+fn seed_grok_home(home: &Path, trusted_cwd: Option<&Path>) {
+    let grok = home.join(".grok");
+    std::fs::create_dir_all(&grok).unwrap();
+    std::fs::write(grok.join("auth.json"), r#"{"test":"ok"}"#).unwrap();
+    if let Some(cwd) = trusted_cwd {
+        std::fs::write(
+            grok.join("trusted_folders.toml"),
+            format!("[folders.\"{}\"]\ntrusted = true\n", cwd.display()),
+        )
+        .unwrap();
+    }
+}
+
+struct HomeGuard {
+    prev: Option<String>,
+}
+
+impl HomeGuard {
+    fn set(home: &Path) -> Self {
+        let prev = std::env::var("HOME").ok();
+        std::env::set_var("HOME", home);
+        Self { prev }
+    }
+}
+
+impl Drop for HomeGuard {
+    fn drop(&mut self) {
+        match &self.prev {
+            Some(value) => std::env::set_var("HOME", value),
+            None => std::env::remove_var("HOME"),
+        }
+    }
+}
+
+fn tmp_dir(tag: &str) -> PathBuf {
+    static N: AtomicU64 = AtomicU64::new(0);
+    let dir = std::env::temp_dir().join(format!(
+        "ta-rs-grok-mcp-{tag}-{}-{}",
+        std::process::id(),
+        N.fetch_add(1, Ordering::Relaxed)
+    ));
+    let _ = std::fs::remove_dir_all(&dir);
+    std::fs::create_dir_all(&dir).unwrap();
+    std::fs::canonicalize(dir).unwrap()
+}