Main Documentation Handoff

SexOS SASOS Handoff: Silk Desktop Environment — Phase 19

ℹ IMPORTANT: Working Directory

All work is strictly constrained to the directory: /home/xirtus_arch/Documents/microkernel.

🛑 CRITICAL TOOLCHAIN MANDATE: The rust-src Requirement

Architecture Context: SexOS targets a custom bare-metal environment (x86_64-sex.json). Building the microkernel and native PDX servers requires the compiler to rebuild the Rust core and alloc libraries from scratch using the unstable -Z build-std=core,alloc flag.

The Rule: You CANNOT build SexOS without the rust-src component installed for your specific nightly toolchain.

rustup component add rust-src --toolchain nightly-x86_64-unknown-linux-gnu

🛑 THE MANDATE: LEGACY IS DEAD

SexCompositor now replaces PdxCompositor. We are building a pure-PDX zero-copy path SexCompositor as a Pdx system that will solve issues from Orbital, Wayland, Smithay, or Cosmic. Those are legacy compositors that speak their own protocols (DRM-like messages, wl_* over Unix sockets) and cause allocator loops and std leakage. The entire point of the pure-PDX zero-copy path (Phase 18) is to permanently excise every trace of them.

🏗️ THE NEW ARCHITECTURE: SexCompositor & Silk Shell

Minimal, no_std, zero-copy PDX-native object.
Lives entirely inside the SEX microkernel's display server (sexdisplay).
Does not wrap or inherit from any external compositor — it is the compositor.
Mechanism: Zero-copy frame commit via direct PDX syscalls (pdx_call) handing PFN lists to kernel MMIO/scanout.
Constraints: No protocol translation. No shared-memory shims. No allocator loops. No legacy crates.

Key File Locations

sexdisplay Crate: servers/sexdisplay/
SexCompositor Definition: servers/sexdisplay/src/lib.rs
sex-pdx Crate: crates/sex-pdx/

COMPLETED

1. KERNEL & PDX IPC

Memory/Syscalls: PdxMapMemory, PdxAllocateMemory, PDX_SEX_WINDOW_CREATE, PDX_GET_TIME, PDX_SWITCH_VIEW, PDX_GET_ALL_VIEWS, PDX_SILKBAR_*. Structs/Fixes: SexWindowCreateParams, SilkbarRegisterParams. Fixed pdx_commit_window_frame 5-arg ABI.

2. SEXCOMPOSITOR & GRAPHICS

Core: WindowState, dynamic advanced tiling (Master/Stack/V/H, ratios, gaps), window decorations/borders. sex-graphics: no_std shared crate, WindowBuffer, draw primitives, 8x8 CP437 font engine. Input Pipeline: sexdisplay forwards sexinput HID events to focused PD.

3. SILK SHELL (BARE-METAL PDX CLIENT)

Capabilities: Real HIDEvent PDX dequeuing, dynamic FB layout queries, workspace switching, window move/resize, app launching (via sex-ld).

4. USERLAND FLEET (APPS & DAEMONS)

silkbar: 40px Catppuccin panel. 3-zone layout (launcher, task, tray). HID clicks & applet registration.
silknet: Tray applet + 360x480 GUI. WireGuard/WiFi toggles via sexnet PDX calls.
tatami: 900x640 Settings daemon (Display, Network, Sound, Input, Capabilities).
toys: Desktop widget framework (Clock, CPU sparkline, RAM, Calendar).
sexsh v2: GPU-accelerated terminal.
linen: Dual-pane file manager.

5. INFRASTRUCTURE

Restored .cargo/config.toml. Re-established workspace build rules. Planned gesture & modern UI (blur/animations) architecture. Wired PDX_GET_TIME / PDX_GET_CPU_USAGE / PDX_GET_MEM_USAGE in kernel. Added sexnet PDX server. silkbar workspace switching. Real HID event routing from sexinput → silkbar.

TODO

Phase	Project	Goal
Phase 20	kaleidoscope	Browser (servo port)
Phase 21	qupid	Media player (rust-media fork)
Phase 22	Media & Automation	rasta, celluloid, rosebud, snowseed
Phase 23	sex-hub + sexshop	App store + backend

Important Apps (Make It Actually Usable)

kaleidoscope — HTML5/JS/Node Capable Browser

Native Rust browser (servo + custom WebRender fork). Full adblock (uBlock Origin rules baked in + AI classifier), YouTube 4K/60 HDR, Google Docs/Sheets real-time collab, X.com full feature parity, hardware video decode via SexOS DRM. No Electron. Multi-process sandbox using microkernel capabilities.

qupid — Pure-Rust VLC Clone

Best foundations ranked for SexOS:

rust-media (pcwalton) — Closest to "libvlc for Rust". Designed for Servo embedding. Zero-copy friendly.
rust-av + oxideav — Pure-Rust multimedia toolkit. Active 2026 crates for AV1/VP9/HEVC parsing.
Symphonia — Pure-Rust audio decoders + container support.

Media & Automation Kickoff

rasta: Photoshop/GIMP pure-Rust clone (stub)
celluloid: Kdenlive pure-Rust clone (stub)
rosebud: Auto translation / i18n pipeline
snowseed: Proton-style Linux ELF / Steam compatibility layer

sex-hub & sexshop

sex-hub: The client (GUI app store front-end). Native Silk app for browsing, one-click install, "native Rust" badge system.
sexshop: The server (backend service). Dedicated PDX service running package index, metadata, signing, mirror sync, and secure download daemon.

First Wave of Redox + COSMIC Ports

Files, Editor, Calculator live in sex-hub. Full dogfooding of Silk as daily driver.