Function sandbox_sync_down_file

crates/openshell-cli/src/ssh.rs:1219–1254

(
    session: &SshSessionConfig,
    sandbox_path: &str,
    dest: &str,
)

}

async fn sandbox_sync_down_file(
    session: &SshSessionConfig,
    sandbox_path: &str,
    dest: &str,
) -> Result<()> {
    let (parent, basename) = split_sandbox_path(sandbox_path);
    let dest_exists_as_dir = fs::symlink_metadata(Path::new(dest)).is_ok_and(|m| m.is_dir());
    let final_path = resolve_file_download_target(dest, basename, dest_exists_as_dir);

    let staging_parent = final_path
        .parent()
        .ok_or_else(|| miette::miette!("destination '{}' has no parent directory", dest))?;
    fs::create_dir_all(staging_parent)
        .into_diagnostic()
        .wrap_err_with(|| {
            format!(
                "failed to create local destination directory '{}'",
                staging_parent.display()
            )
        })?;

    let staging = tempfile::TempDir::new_in(staging_parent)
        .into_diagnostic()
        .wrap_err("failed to create download staging directory")?;

    let tar_cmd = build_single_file_tar_cmd(parent, basename);
    stream_sandbox_tar(session, tar_cmd, staging.path()).await?;

    place_downloaded_file(staging.path(), basename, &final_path).wrap_err_with(|| {
        format!(
            "failed to place downloaded file at '{}'",
            final_path.display()
        )
    })?;
    Ok(())
}

/// Move a single file extracted by `stream_sandbox_tar` into its final
/// position on the host.