alef 0.82.0

use super::*;
use crate::test_support::SkipCommandsGuard;

#[test]
fn run_run_command_succeeds_for_echo() {
    let _guard = SkipCommandsGuard::set("");
    let dir = std::env::temp_dir();
    let result = run_run_command(
        "echo",
        &["alef-runcommand-ok"],
        &dir,
        "sample",
        super::RUN_COMMAND_TIMEOUT,
    );
    assert!(
        matches!(result, Ok(true)),
        "echo should run and report Ok(true): {result:?}"
    );
}

#[test]
fn run_run_command_fails_for_false() {
    let _guard = SkipCommandsGuard::set("");
    let dir = std::env::temp_dir();
    let result = run_run_command("false", &[], &dir, "sample", super::RUN_COMMAND_TIMEOUT);
    assert!(result.is_err(), "false should return Err");
    let msg = format!("{:?}", result.unwrap_err());
    assert!(
        msg.contains("exited with status"),
        "error should mention exit status: {msg}"
    );
}

#[test]
fn run_run_command_honors_skip_env_var() {
    let dir = std::env::temp_dir();
    {
        let _guard = SkipCommandsGuard::set("noop,false , another");
        let skipped = run_run_command("false", &[], &dir, "sample", super::RUN_COMMAND_TIMEOUT);
        assert!(
            matches!(skipped, Ok(false)),
            "listed command must return Ok(false) without spawning: {skipped:?}"
        );
    }

    let _guard = SkipCommandsGuard::set("something-else");
    let honored = run_run_command("false", &[], &dir, "sample", super::RUN_COMMAND_TIMEOUT);
    assert!(
        honored.is_err(),
        "unlisted command must still spawn and surface failure"
    );
}

/// The regression this fix closes: a post-build command that ran and rejected the code used to
/// report only its bare exit status, discarding whatever it actually said on the way out --
/// exactly what happened to a real `cargo build` linker failure, which surfaced as
/// `'cargo' exited with status 101` with no way to tell a linker bug from a missing crate
/// without re-running the build by hand. The failing command's own diagnostic must now reach
/// the propagated error. ~keep
#[test]
fn run_run_command_error_quotes_the_failing_commands_own_stderr() {
    let _guard = SkipCommandsGuard::set("");
    let dir = std::env::temp_dir();
    let result = run_run_command(
        "sh",
        &["-c", "echo alef-regression-marker-9f31 1>&2; exit 3"],
        &dir,
        "sample",
        super::RUN_COMMAND_TIMEOUT,
    );

    let error = result.expect_err("a script that exits 3 must fail the step");
    let message = format!("{error:#}");
    assert!(
        message.contains("alef-regression-marker-9f31"),
        "the command's own stderr must survive into the error, not just its exit code: {message}"
    );
    assert!(message.contains("exited with status 3"), "got: {message}");
}

/// A tool missing from `PATH` used to be indistinguishable from a tool that ran and
/// produced current output -- both returned `Ok(())`. `run_post_build`'s `RunCommand` arm
/// (and `PostBuildOutcome::skipped_missing_tools`) depend on `Ok(false)` here to tell the
/// two apart, so the primitive that ultimately makes the skip observable must be pinned
/// down on its own. ~keep
#[test]
fn run_run_command_reports_false_when_the_tool_is_not_on_path() {
    let _guard = SkipCommandsGuard::set("");
    let dir = std::env::temp_dir();
    let result = run_run_command(
        "alef-definitely-not-a-real-binary-xyz123",
        &[],
        &dir,
        "sample",
        super::RUN_COMMAND_TIMEOUT,
    );
    assert!(
        matches!(result, Ok(false)),
        "a missing tool must be reported as skipped, not silently equivalent to success: {result:?}"
    );
}

/// `run_run_command` used to enforce a bare module constant (`RUN_COMMAND_TIMEOUT`, 1800s) with
/// no way to shorten or lengthen it per call -- this proves the `timeout` parameter this fix
/// adds is actually honored by the kill loop, not merely accepted and ignored. A `sleep 3` run
/// under a 1-second ceiling must be killed at ~1s, not run to completion and not wait for the
/// unrelated 1800s default still in force elsewhere in this file. ~keep
#[test]
fn run_run_command_is_killed_at_a_shorter_than_default_timeout() {
    let _guard = SkipCommandsGuard::set("");
    let dir = std::env::temp_dir();
    let started = std::time::Instant::now();

    let result = run_run_command("sleep", &["3"], &dir, "sample", std::time::Duration::from_secs(1));
    let elapsed = started.elapsed();

    let error = result.expect_err("a sleep 3 under a 1s ceiling must time out");
    assert!(
        error.to_string().contains("exceeded 1s timeout"),
        "error should name the configured 1s ceiling, not the 1800s default: {error:#}"
    );
    crate::test_support::assert_elapsed_under(
        "must be killed at the configured 1s ceiling rather than running to completion",
        elapsed,
        std::time::Duration::from_secs(3),
    );
}

/// End-to-end proof that `[build_commands.<lang>].timeout_seconds` in `alef.toml` actually
/// reaches `run_run_command`'s enforcement point -- alef #364's real defect was not that the
/// timeout fired too early, it was that there was no config surface reaching it at all. Asserting
/// the config merely parses would not catch that: this drives the same `run_post_build` entry
/// point `alef generate`/`alef all` use, with a post-build `RunCommand` step that legitimately
/// runs longer than the configured ceiling, and checks the kill fires at THAT ceiling. ~keep
#[test]
fn configured_build_command_timeout_reaches_the_post_build_run_command_step() {
    let _guard = SkipCommandsGuard::set("");
    let directory = tempfile::tempdir().expect("temporary project");

    let mut config = crate::core::config::ResolvedCrateConfig::default();
    config.build_commands.insert(
        Language::Swift.to_string(),
        BuildCommandConfig {
            precondition: None,
            dependency_precondition: None,
            dependency_remediation: None,
            before: None,
            build: None,
            build_release: None,
            timeout_seconds: Some(1),
        },
    );

    let build_config = crate::core::backend::BuildConfig {
        tool: "swift",
        crate_suffix: "-swift",
        build_dep: crate::core::backend::BuildDependency::None,
        post_build: vec![crate::core::backend::PostBuildStep::RunCommand {
            cmd: "sleep",
            args: vec!["3"],
        }],
    };

    let started = std::time::Instant::now();
    let result = run_post_build(
        Language::Swift,
        &build_config,
        &config,
        directory.path(),
        StagingProfile::PreferOnDisk,
    );
    let elapsed = started.elapsed();

    let error = result.expect_err("a sleep 3 post-build step under a configured 1s ceiling must fail");
    let message = format!("{error:#}");
    assert!(message.contains("exceeded 1s timeout"), "got: {message}");
    crate::test_support::assert_elapsed_under(
        "the configured 1s ceiling must fire before the sleep completes or the 1800s default would",
        elapsed,
        std::time::Duration::from_secs(3),
    );
}

/// The ceiling is worth nothing if it kills only the direct child. `flutter_rust_bridge_codegen`
/// -- the tool this timeout exists for -- drives cargo builds of its own, and those survived it.
/// The grandchild's pid is asserted to stop existing rather than the kill branch being asserted
/// entered: the orphaned tree that prompted this was produced by code that entered its kill
/// branch. ~keep
#[test]
fn a_timed_out_run_command_kills_its_grandchild_too() {
    let _guard = SkipCommandsGuard::set("");
    let directory = tempfile::tempdir().expect("scratch directory");
    let marker = directory.path().join("grandchild.pid");
    let script = format!("sleep 300 & echo $! > {}; sleep 300", marker.display());

    let grandchild = std::thread::scope(|scope| {
        let running = scope.spawn(|| {
            run_run_command(
                "sh",
                &["-c", &script],
                directory.path(),
                "sample",
                std::time::Duration::from_secs(3),
            )
        });
        let announced = wait_for_announced_pid(&marker);
        let result = running.join().expect("the post-build step returns");
        let error = result.expect_err("a 300s script under a 3s ceiling must time out");
        assert!(error.to_string().contains("exceeded 3s timeout"), "got: {error:#}");
        announced
    });

    assert!(
        wait_until_gone(grandchild),
        "grandchild {grandchild} survived the ceiling that killed its parent"
    );
}

#[test]
fn tail_returns_the_whole_text_when_it_fits_within_the_limit() {
    assert_eq!(super::tail("short", 4096), "short");
}

/// Truncation snaps forward to the next line boundary rather than cutting mid-line, so a
/// quoted diagnostic reads as whole lines instead of a byte fragment. Cutting the last 7 bytes
/// of "aaaa\nbbbb\ncccc\n" lands on the trailing "b" of "bbbb"; the result must start at the
/// next whole line, "cccc\n", not mid-word.
#[test]
fn tail_snaps_to_a_line_boundary_when_truncating() {
    let text = "aaaa\nbbbb\ncccc\n";
    assert_eq!(super::tail(text, 7), "cccc\n");
}

/// A multi-byte UTF-8 character sitting right at the naive cut point must not panic. Compiler
/// output is decoded lossily and is not guaranteed ASCII.
#[test]
fn tail_does_not_panic_on_a_multibyte_boundary() {
    let text = "prefix-\u{1F600}\u{1F600}\u{1F600}-suffix";
    // Byte 9 sits inside the first emoji's 4-byte UTF-8 sequence (which starts at byte 7), so
    // cutting there without adjustment would slice a character in half.
    assert!(!text.is_char_boundary(9), "test setup: byte 9 must land mid-character");
    let truncated = super::tail(text, text.len() - 9);
    assert!(
        text.ends_with(truncated),
        "truncated text must be a real suffix: {truncated:?}"
    );
}

fn is_alive(pid: i32) -> bool {
    // SAFETY: signal 0 performs error checking only and sends nothing.
    unsafe { libc::kill(pid, 0) == 0 }
}

/// Liveness is deliberately not part of this wait -- see the identical helper in
/// `cli::pipeline::helpers::timeout_tests`; requiring it would race the kill under test. ~keep
fn wait_for_announced_pid(marker: &Path) -> i32 {
    let deadline = std::time::Instant::now() + std::time::Duration::from_secs(10);
    loop {
        assert!(
            std::time::Instant::now() < deadline,
            "no pid was ever announced in the marker file"
        );
        if let Ok(contents) = std::fs::read_to_string(marker)
            && let Ok(pid) = contents.trim().parse::<i32>()
            && pid > 0
        {
            return pid;
        }
        std::thread::sleep(std::time::Duration::from_millis(20));
    }
}

fn wait_until_gone(pid: i32) -> bool {
    let deadline = std::time::Instant::now() + std::time::Duration::from_secs(10);
    while std::time::Instant::now() < deadline {
        if !is_alive(pid) {
            return true;
        }
        std::thread::sleep(std::time::Duration::from_millis(20));
    }
    !is_alive(pid)
}