//! 命令面：help 文案、用法错误、错误码——不碰数据或者只碰「拒绝」那条路。
//!
//! 从 `tests/adopt_test.rs` 拆出来只为守 400 行硬线；搬动是纯搬，断言未变。

use crate::support::{parse_json, run_cli, TempDir};

use crate::fixture::foreign_data_root;

/// 运行目录选项的用法错误：一律退出码 1 + `code=usage`（不是内部错误）。
///
/// 抓得住：`--isolation custom` 少 `--game-dir` 被默默当成缺省、`shared` 同时给 `--game-dir`
/// 被静默忽略、未知词被当缺省。
/// 抓不住：提示文案的措辞（只断言 code 与关键字）。
#[test]
fn isolation_option_misuse_is_a_usage_error() {
    let dir = TempDir::new("adopt-usage");
    foreign_data_root(dir.path());
    let cases: Vec<Vec<&str>> = vec![
        vec!["--isolation", "custom"],
        vec!["--isolation", "shared", "--game-dir", "C:/tmp/x"],
        vec!["--isolation", "nope"],
        vec!["--game-dir", "relative/dir"],
    ];
    for extra in cases {
        let mut args = vec!["instances", "adopt", "1.20.1", "--json", "--data-dir"];
        let dir_arg = dir.arg();
        args.push(&dir_arg);
        args.extend(extra.iter().copied());
        let (code, stdout, stderr) = run_cli(&args);
        assert_eq!(code, 1, "args={args:?}\nstdout={stdout}\nstderr={stderr}");
        let value = parse_json(&stdout);
        assert_eq!(
            value["error"]["code"], "usage",
            "args={args:?} 应是用法错误：{stdout}"
        );
    }
}

/// 不存在的版本 ⇒ `adopt_version_not_found`（不联网、不偷偷装一个）。
///
/// 抓得住：不存在的 id 被登记成功。
/// 抓不住：`versions/` 整个不存在时 `scan` 的空结果（core 侧用例覆盖）。
#[test]
fn unknown_version_reports_not_found() {
    let dir = TempDir::new("adopt-unknown");
    foreign_data_root(dir.path());
    let (code, stdout, _) = run_cli(&[
        "instances",
        "adopt",
        "9.9.9",
        "--json",
        "--data-dir",
        &dir.arg(),
    ]);
    assert_eq!(code, 1, "{stdout}");
    assert_eq!(
        parse_json(&stdout)["error"]["code"],
        "adopt_version_not_found"
    );
}

/// help 里必须有这两条命令（新命令不留「有实现没文档」的状态），且旧命令仍在。
///
/// 抓得住：help 漏列 `instances scan` / `instances adopt`（子串断言），或把旧的
/// `instances launch-args` / `pack import` 弄丢。
/// 抓不住：帮助文案与真实行为是否一致（那要靠上面的行为用例 + 人读）。
#[test]
fn help_lists_the_new_subcommands_next_to_the_old_ones() {
    let general = unlucky_cli::cli::help::general();
    for needle in [
        "instances scan",
        "instances adopt",
        "instances list",
        "install <version>",
    ] {
        assert!(general.contains(needle), "总帮助缺 `{needle}`：\n{general}");
    }
    let topic = unlucky_cli::cli::help::topic("instances").expect("help instances 存在");
    for needle in [
        "instances scan",
        "instances adopt",
        "缺省不沿用全局 isolated",
        "一个字节都不写",
    ] {
        assert!(topic.contains(needle), "help instances 缺 `{needle}`");
    }
    // 旧的 `per_version` 字面量只在 core 的 `Isolation::parse` 里被兼容，CLI 词表不接受它。
    let bogus = std::env::temp_dir().join("ull-adopt-help-nonexistent");
    let bogus = bogus.display().to_string();
    let args = [
        "instances",
        "adopt",
        "1.20.1",
        "--isolation",
        "per_version",
        "--json",
        "--data-dir",
        bogus.as_str(),
    ];
    let (code, stdout, _) = run_cli(&args);
    assert_eq!(code, 1, "`per_version` 不是 CLI 词表：{stdout}");
}