Unlucky-Launcher/crates/core/tests/adopt/surface_cases.rs

//! 写盘面与入口可用性：**配置目录被链出去**必须拒绝（R2）、**versions 入口断链**必须具名报错（R3）。
//!
//! 两类都属于「本 mission 承诺的东西被链接绕过」：前者是「只写自己的配置」被
//! `config/instances` 的目录联接打穿（会替别人的启动器在 `.minecraft/config` 里造 UUID 文件），
//! 后者是「坏东西不能当空列表」被 `read_dir` 的 NotFound 打穿（断链 junction 与「真没有」同态）。
//!
//! 两条都用**真链接夹具**；建不出链接时走 `fixture::link_guard`（强制模式下必红，见 R4）。

use unlucky_core::game::adopt::{self, AdoptTarget};

use crate::fixture::{
    assert_unchanged, foreign_minecraft, link_guard, request, snapshot, try_link_dir, TempRoot,
};

/// `config/instances` 被目录联接指到游戏根的 `config/`：adopt 必须先拒绝，且游戏根零写入。
///
/// 抓得住：
/// - 只核运行目录、不核配置写面（那样这次登记会 exit0，并在 `.minecraft/config/<uuid>.json`
///   多出一个文件——`before/after` 全节点快照与「外部 config 目录为空」两条都会红）；
/// - `plan`（dry-run）也放行（第四条断言红：预检说「可以」，真写才失败）；
/// - 拒绝时先写了目录/配置（快照与目录列举都会红）。
///
/// 抓不住：检查与写入之间的 TOCTOU（本模块不是并发/对抗入口）。
#[cfg(windows)]
#[test]
fn a_junction_on_the_instances_dir_must_not_write_into_the_game_root() {
    use crate::fixture::try_junction;

    let root = TempRoot::new("cfg-instances-junction");
    foreign_minecraft(&root.game_root());
    let game_config = root.game_root().join("config");
    std::fs::create_dir_all(&game_config).expect("建别人的 config 目录");
    let instances_dir = root.path().join(".ULL").join("config").join("instances");
    std::fs::create_dir_all(instances_dir.parent().expect("config 目录")).expect("建 .ULL/config");
    if !link_guard(
        try_junction(&game_config, &instances_dir),
        "config/instances 目录联接",
    ) {
        return;
    }
    let before = snapshot(&root.game_root());
    // 别人的 `config/` 里本来就有文件（`example.toml` 是玩家配置）：判据是**没有新增条目**。
    let config_before = listing(&game_config);

    let plan_error = adopt::plan(
        &root.game(),
        &root.launcher(),
        &request("1.20.1", AdoptTarget::InstanceDir),
    )
    .expect_err("配置写面被链走时，dry-run 也必须报错");
    assert_eq!(plan_error.code(), "adopt_config_surface_unsafe");

    let error = adopt::adopt(
        &root.game(),
        &root.launcher(),
        &request("1.20.1", AdoptTarget::InstanceDir),
    )
    .expect_err("配置写面被链走时必须拒绝登记");
    assert_eq!(error.code(), "adopt_config_surface_unsafe");

    let after = snapshot(&root.game_root());
    assert_unchanged(&before, &after, "拒绝之后（游戏根零写入）");
    assert_eq!(
        config_before,
        listing(&game_config),
        "绝不许在别人的 .minecraft/config 里新增文件（尤其 UUID 配置）"
    );
    assert!(
        !listing(&game_config)
            .iter()
            .any(|name| name.ends_with(".json") && name.len() == 41),
        "不该出现 UUID 形状的 json：{:?}",
        listing(&game_config)
    );
}

/// `config/` 整层被链到游戏根：同样拒绝（判定粒度到**每一个**写盘目标，不只看 `instances`）。
///
/// 抓得住：只检查 `config/instances` 而不检查 `config/` 与 `profiles.json`（那样这条会 exit0）。
/// 抓不住：跨卷/跨盘的整体迁移（`<.ULL>` 自己是联接）——那是允许的，见 `run_dir` 模块文档。
#[test]
fn a_linked_config_dir_must_not_write_into_the_game_root() {
    let root = TempRoot::new("cfg-dir-link");
    foreign_minecraft(&root.game_root());
    let game_config = root.game_root().join("config");
    std::fs::create_dir_all(&game_config).expect("建别人的 config 目录");
    let ull = root.path().join(".ULL");
    std::fs::create_dir_all(&ull).expect("建 .ULL");
    let config_dir = ull.join("config");
    if !link_guard(try_link_dir(&game_config, &config_dir), "config 目录链接") {
        return;
    }
    let before = snapshot(&root.game_root());

    let error = adopt::adopt(
        &root.game(),
        &root.launcher(),
        &request("1.20.1", AdoptTarget::InstanceDir),
    )
    .expect_err("config/ 被链走时必须拒绝登记");
    assert_eq!(error.code(), "adopt_config_surface_unsafe");

    let after = snapshot(&root.game_root());
    assert_unchanged(&before, &after, "拒绝之后（游戏根零写入）");
}

/// `versions/` 入口**存在但断链**（目标被移走）⇒ 具名报错，而不是「这个数据根还没有版本」。
///
/// 抓得住：`read_dir` 的 `NotFound` 一律当空列表（旧实现；Windows 断链 junction 正是这个形状）
/// ——第一条断言会红成「成功空列表」。
/// 抓不住：`versions/` 是普通文件的情形（走 `GameError::io`，错误码不同，靠人读）。
#[test]
fn a_dangling_versions_entry_is_an_error_not_an_empty_scan() {
    let root = TempRoot::new("dangling-versions");
    std::fs::create_dir_all(root.game_root()).expect("建游戏根");
    let moved = root.path().join("moved-versions");
    std::fs::create_dir_all(moved.join("1.20.1")).expect("建将被移走的 versions");
    let versions = root.game_root().join("versions");
    if !link_guard(try_link_dir(&moved, &versions), "versions 入口链接") {
        return;
    }
    // 目标被移走 ⇒ 入口成为断链；lstat 仍然看得见它。
    std::fs::remove_dir_all(&moved).expect("移走目标");
    assert!(
        std::fs::symlink_metadata(&versions).is_ok(),
        "夹具有问题：断链入口应当仍能被 lstat 看到"
    );

    let error = adopt::scan(&root.game(), &root.launcher())
        .expect_err("断链的 versions 入口必须报错，不能当空列表");
    assert_eq!(error.code(), "adopt_versions_unreadable", "{error}");
}

/// `versions` 真不存在 ⇒ 仍然是空结果（别把「新数据根」误报成故障）。
///
/// 抓得住：为了修 R3 把所有 NotFound 都当错误（这条会红）。
/// 抓不住：真正不可读（EACCES）那一支——Windows 上造不可读目录不可靠。
#[test]
fn a_truly_missing_versions_dir_stays_empty() {
    let root = TempRoot::new("no-versions");
    std::fs::create_dir_all(root.game_root()).expect("建空游戏根");
    let scan = adopt::scan(&root.game(), &root.launcher()).expect("真不存在 ⇒ 空结果");
    assert!(scan.candidates.is_empty());
}

/// 目录里直接子项的名字（排序后，用于「有没有新增」的判据）。
fn listing(dir: &std::path::Path) -> Vec<String> {
    let mut names: Vec<String> = std::fs::read_dir(dir)
        .expect("读目录")
        .filter_map(|entry| Some(entry.ok()?.file_name().to_string_lossy().into_owned()))
        .collect();
    names.sort();
    names
}