WEFT_OS/infra/vm/linux-dev-environment.md
Marco Allegretti 29a7f6f508
ci: build and test on Linux only
WEFT OS targets Linux and systemd. The Windows runner only compiled and
tested the crates without Linux system libraries, which says nothing
about a supported configuration, and was the slowest job in every run.

The job is now `portable` on Ubuntu, matching the verification profile
of the same name. The building guide, README and development
environment notes now state that builds are validated on Linux only.
2026-10-09 08:16:59 +00:00

43 lines
1.4 KiB
Markdown

# Linux Development Environment
WEFT OS is developed on a Windows workstation, but the authoritative runtime target for system work is a Linux VM or QEMU guest.
## Baseline target
Use a recent Linux distribution with:
- systemd as PID 1
- Wayland-capable graphics stack
- Mesa userspace drivers
- a recent Rust toolchain compatible with `rust-toolchain.toml`
## Purpose of the guest environment
The guest is the validation target for:
- systemd service assumptions
- Wayland compositor bring-up
- Servo Wayland client behavior
- Wasmtime runtime supervision assumptions
## Host versus target boundary
The Windows host is acceptable for editing and documentation. Builds and tests are validated on Linux only; CI does not build on Windows.
The Linux guest is authoritative for:
- graphics stack behavior
- compositor and shell startup order
- systemd unit behavior
- process supervision assumptions tied to Linux userspace
## Minimum guest setup goals for the next implementation wave
- install Rust toolchain matching `rust-toolchain.toml`
- install build essentials needed by Rust crates in this repository
- confirm `cargo fmt`, `cargo clippy`, and `cargo test` run successfully
- prepare a repeatable guest definition for future compositor and shell work
## Current status
This repository does not yet automate guest provisioning. That work should begin only after the foundational workspace and design documents are stable.