WEFT OS is a Wayland compositor and application runtime where every app is a WebAssembly component rendered in an isolated Servo WebView.
Find a file
Marco Allegretti 86d0011016 feat(appd): implement runtime supervisor with process spawning and READY signal
runtime.rs — process lifecycle manager:
- supervise(session_id, app_id, registry): spawns the weft-runtime child
  process identified by WEFT_RUNTIME_BIN env var. If unset, logs debug
  and returns immediately (no-op until runtime binary is available).
- Child process invoked as: <WEFT_RUNTIME_BIN> <app_id> <session_id>
  with stdout/stderr piped, stdin closed.
- wait_for_ready(): reads stdout line-by-line; returns Ok(()) on first
  line matching 'READY'; returns Err if stdout closes without it.
- 30-second READY_TIMEOUT via tokio::time::timeout; on expiry, kills
  the child and transitions session to Stopped.
- On success: sets session state to Running, broadcasts AppReady to all
  connected WebSocket clients via registry broadcast channel.
- drain_stderr(): async task that forwards child stderr lines to tracing
  at WARN level for observability.
- On process exit: sets session state to Stopped regardless of exit code.

main.rs — wiring:
- SessionRegistry now owns broadcast::Sender<Response>; Default creates
  the channel internally. Added set_state(), subscribe(), broadcast()
  methods. Removed standalone broadcast_tx from run(); WS handlers
  subscribe via registry.lock().await.subscribe().
- dispatch::LaunchApp spawns a tokio task calling runtime::supervise
  immediately after creating the session. supervise is a no-op when
  WEFT_RUNTIME_BIN is unset, so existing tests are unaffected.

Cargo.toml: added tokio 'process' and 'time' features.
2026-03-11 09:17:20 +01:00
.github/workflows ci: add libgbm-dev and libdrm-dev to linux-only job dependencies 2026-03-10 21:33:34 +01:00
crates feat(appd): implement runtime supervisor with process spawning and READY signal 2026-03-11 09:17:20 +01:00
docs docs: specify WEFT application package format 2026-03-11 09:04:19 +01:00
infra feat(appd): add WebSocket UI endpoint for Servo shell integration 2026-03-11 09:01:54 +01:00
protocol feat(compositor): implement weft-shell-protocol server side 2026-03-11 07:59:56 +01:00
scripts test(appd): add unit tests for IPC message codec and session registry 2026-03-11 08:32:02 +01:00
.gitattributes Initialize Rust workspace and repository metadata 2026-03-10 18:47:06 +01:00
.gitignore Initialize Rust workspace and repository metadata 2026-03-10 18:47:06 +01:00
Cargo.lock feat(appd): add WebSocket UI endpoint for Servo shell integration 2026-03-11 09:01:54 +01:00
Cargo.toml feat(appd): add weft-appd skeleton crate and service unit 2026-03-11 01:13:18 +01:00
justfile Add repository validation and CI checks 2026-03-10 18:47:16 +01:00
README.md Initialize Rust workspace and repository metadata 2026-03-10 18:47:06 +01:00
rust-toolchain.toml Initialize Rust workspace and repository metadata 2026-03-10 18:47:06 +01:00

WEFT OS

WEFT OS is a Linux-based operating system effort built around a Smithay compositor, a Servo-rendered system shell, and a Wasmtime-based application runtime.

Current repository scope

This repository currently contains:

  • the baseline Rust workspace
  • public engineering documentation derived from the authoritative blueprint
  • initial design documents for the shell protocol boundary and the WasmServo channel
  • local and CI validation paths for repository bootstrap work

It does not yet contain a compositor, shell, or application runtime implementation.

Source of truth

The authoritative technical reference for this repository is docu_dev/WEFT-OS-COMPREHENSIVE-BLUEPRINT.md.

Historical blueprint documents exist in docu_dev/, but they are not implementation authority where they conflict with the comprehensive blueprint.

Privacy boundary

docu_dev/ is a private coordination area used during development. It is intentionally ignored by git and is not part of the tracked public repository surface.

Development model

  • Primary development host: Windows workstation
  • Primary runtime target: Linux VM or QEMU guest
  • Core system language: Rust

Validation

On Windows PowerShell:

./infra/scripts/check.ps1

On Linux:

./infra/scripts/check.sh

Repository layout

crates/      Rust workspace members
docs/        Public engineering documentation
infra/       Validation scripts and VM workflow material