// Oxygen's own pipeline (OxygenFlow, docs in the oxygenflow repository).

// Every push to a bookmark on OxygenHub runs it in Firecracker microVMs on

// Earth; the jobs appear as checks on the change.

schema-version 1

// The OxygenFlow build image: Rust with rustfmt and clippy, Node, and every

// crate of Cargo.lock vendored (oxygenflow/images/rust). Rebuild and re-pin

// it when Cargo.lock changes.

sandbox "rust" {

    runtime "microvm"

    rootfs "cas://blob/3fa57d4c1dc8aa5d4d92665bc13f332357f55042f658543dc21b1540b3aced69"

    memory-limit "8GiB"

    cpu-limit 4

    // Tests serve and connect on 127.0.0.1; nothing leaves the guest.

    network "loopback"

    // CI builds are thrown away: no incremental state and no debug info,

    // so less to compile, link and write (as in oxygenhub's pipeline).

    env {

        CARGO_INCREMENTAL "0"

        CARGO_PROFILE_DEV_DEBUG "0"

        CARGO_PROFILE_TEST_DEBUG "0"

        CARGO_PROFILE_RELEASE_DEBUG "0"

    }

}

sandbox "rust-small" {

    runtime "microvm"

    rootfs "cas://blob/3fa57d4c1dc8aa5d4d92665bc13f332357f55042f658543dc21b1540b3aced69"

    memory-limit "1GiB"

    cpu-limit 1

    network "isolated"

}

// The riscv64 build image on narvi-1 (oxygenflow#69): Ubuntu 24.04 riscv64

// with Rust 1.97.1 and the same vendored crates, in the syscall tier (the

// board has no hardware virtualisation, so no microVM). `runs-on` keeps it

// on a RISC-V runner.

sandbox "rust-riscv64" {

    runtime "syscall"

    rootfs "cas://blob/b4edba9173ddf63aa1df46222e6a59b265071b19f2815c89d0153b593835c616"

    runs-on "riscv64"

    memory-limit "4GiB"

    cpu-limit 6

    network "loopback"

    env {

        CARGO_INCREMENTAL "0"

        CARGO_PROFILE_RELEASE_DEBUG "0"

        CARGO_BUILD_JOBS "4"

    }

}

job "fmt" {

    sandbox "rust-small"

    exec "cargo" "fmt" "--all" "--check"

}

job "clippy" {

    sandbox "rust"

    depends-on "fmt"

    mount {

        source "ephemeral://disk"

        target "/src/target"

        size "24GiB"

        // Kept from this job's last passing run (oxygenflow#28): cargo

        // builds only what changed since.

        cache "target"

        key "Cargo.lock"

    }

    // One build identity for every CI state, so the cached target stays

    // fresh from one push to the next (oxygenflow#52).

    env {

        OXY_BUILD "ci"

    }

    exec "sh" ".flow/warm-target.sh" "cargo" "clippy" "--workspace" "--all-targets" "--locked" "--" "-D" "warnings"

}

// The tests, run under cargo-llvm-cov so the hub's Coverage tab

// (oxygenhub#113) gets a report: the same tests, instrumented, and an LCOV

// file kept as the job's `coverage` artifact.

job "test" {

    sandbox "rust"

    depends-on "fmt"

    mount {

        source "ephemeral://disk"

        target "/src/target"

        size "24GiB"

        // Kept from this job's last passing run (oxygenflow#28): cargo

        // builds only what changed since.

        cache "target"

        key "Cargo.lock"

    }

    // One build identity for every CI state, so the cached target stays

    // fresh from one push to the next (oxygenflow#52).

    env {

        OXY_BUILD "ci"

    }

    exec "cargo" "llvm-cov" "--workspace" "--locked" "--lcov" "--output-path" "/src/target/lcov.info"

    output {

        artifact "coverage" {

            path "/src/target/lcov.info"

        }

    }

}

job "build" {

    sandbox "rust"

    depends-on "fmt"

    mount {

        source "ephemeral://disk"

        target "/src/target"

        size "24GiB"

        // Kept from this job's last passing run (oxygenflow#28): cargo

        // builds only what changed since.

        cache "target"

        key "Cargo.lock"

    }

    exec "sh" ".flow/warm-target.sh" "cargo" "build" "--release" "--locked"

    // The binary, kept as a blob of this repository and named by the

    // job's signed receipt; the run page links it.

    output {

        artifact "oxy" {

            path "/src/target/release/oxy"

        }

    }

}

// Release files for every platform (oxygen#59): scripts/dist.sh in the

// build image's cross toolchains. A push runs it only when it touches

// these paths (a release moves Cargo.toml's version); "Run pipeline" and

// reruns always do. The files are kept as this run's artifacts, named by

// its signed receipt, and attached to the release from there, so the

// release's trust page shows each as built here.

job "dist" {

    sandbox "rust"

    depends-on "fmt"

    scope "Cargo.toml" "scripts/dist.sh" "packaging/**"

    mount {

        source "ephemeral://disk"

        target "/src/target"

        size "24GiB"

        // Kept from this job's last passing run (oxygenflow#28): cargo

        // builds only what changed since.

        cache "target"

        key "Cargo.lock"

    }

    env {

        DIST_FLAT "/src/target/dist-flat"

        ZIG_GLOBAL_CACHE_DIR "/src/target/zig-cache"

    }

    exec "bash" "scripts/dist.sh"

    output {

        artifact "oxy-linux-x86_64.tar.gz" {

            path "/src/target/dist-flat/oxy-linux-x86_64.tar.gz"

        }

        artifact "oxy-linux-arm64.tar.gz" {

            path "/src/target/dist-flat/oxy-linux-arm64.tar.gz"

        }

        artifact "oxy-linux-riscv64.tar.gz" {

            path "/src/target/dist-flat/oxy-linux-riscv64.tar.gz"

        }

        artifact "oxy-macos-x86_64.tar.gz" {

            path "/src/target/dist-flat/oxy-macos-x86_64.tar.gz"

        }

        artifact "oxy-macos-arm64.tar.gz" {

            path "/src/target/dist-flat/oxy-macos-arm64.tar.gz"

        }

        artifact "oxy-windows-x86_64.zip" {

            path "/src/target/dist-flat/oxy-windows-x86_64.zip"

        }

        artifact "oxy_amd64.deb" {

            path "/src/target/dist-flat/oxy_amd64.deb"

        }

        artifact "oxy_arm64.deb" {

            path "/src/target/dist-flat/oxy_arm64.deb"

        }

        artifact "oxy_riscv64.deb" {

            path "/src/target/dist-flat/oxy_riscv64.deb"

        }

        artifact "SHA256SUMS" {

            path "/src/target/dist-flat/SHA256SUMS"

        }

    }

}

// The native RISC-V check (oxygenflow#69): oxy built and used on narvi-1,

// a real riscv64 board, so each release is known to run there and not

// only to cross-compile (dist). Like dist, a push runs it only when it

// touches these paths; "Run pipeline" and reruns always do. Its target

// directory is cached between passing runs (oxygenflow#70).

job "riscv64" {

    sandbox "rust-riscv64"

    depends-on "fmt"

    scope "Cargo.toml" "scripts/dist.sh" "packaging/**" ".flow/riscv64-check.sh"

    timeout "3h"

    mount {

        source "ephemeral://disk"

        target "/src/target"

        size "16GiB"

        // Kept from this job's last passing run in the syscall tier too

        // (oxygenflow#70): the first build is cold (~40 min on narvi-1),

        // later ones build only what changed.

        cache "target"

        key "Cargo.lock"

    }

    exec "sh" ".flow/riscv64-check.sh"

    output {

        artifact "oxy-linux-riscv64-native" {

            path "/src/target/release/oxy"

        }

    }

}