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 538eccd4c6 feat(appd): implement IPC server with Unix socket and MessagePack framing
Replaces the skeleton bail with a functional IPC server.

ipc.rs — transport layer:
- Request enum: LaunchApp, TerminateApp, QueryRunning, QueryAppState.
  Serialized with serde MessagePack (rmp-serde, SCREAMING_SNAKE_CASE
  type tag).
- Response enum: LaunchAck, AppReady, RunningApps, AppState, Error.
- AppStateKind: Starting, Running, Stopping, Stopped, NotFound.
- read_frame / write_frame: async 4-byte LE length-prefixed codec over
  any AsyncRead / AsyncWrite.

main.rs — server:
- SessionRegistry: in-memory HashMap<session_id, AppStateKind> with
  monotonic ID counter; launch / terminate / running_ids / state.
- run(): creates socket parent directory, removes stale socket, binds
  UnixListener, sends sd_notify READY=1, then accept-loops with
  ctrl-c / SIGTERM shutdown. Cleans up socket on exit.
- handle_connection(): splits stream into BufReader/BufWriter, reads
  request frames, calls dispatch, writes response frames.
- dispatch(): maps Request variants to SessionRegistry operations;
  returns typed Response. Wasmtime spawning and compositor client
  deferred to later implementation.

New deps: serde (derive), rmp-serde, tokio net/io-util/sync/rt-multi-thread.
2026-03-11 08:25:55 +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 IPC server with Unix socket and MessagePack framing 2026-03-11 08:25:55 +01:00
docs feat(servo-shell): add servo-shell skeleton, system UI, service unit, and Wayland input audit 2026-03-11 00:34:26 +01:00
infra feat(appd): add weft-appd skeleton crate and service unit 2026-03-11 01:13:18 +01:00
protocol feat(compositor): implement weft-shell-protocol server side 2026-03-11 07:59:56 +01:00
scripts test(compositor): add protocol unit tests and stale identifier rejection 2026-03-11 08:12:11 +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): implement IPC server with Unix socket and MessagePack framing 2026-03-11 08:25:55 +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