Files
RedBear-OS/local/recipes/AGENTS.md
T
vasilito 2b1e1788de libdrm + Rule 2 migration: recipe upgrade, doc updates, manifest entry (v6.0 2026)
This is the final cleanup batch for the Rule 2 big-project migration
work (pipewire, wireplumber, mesa, libdrm all migrated to upstream git
+ external patches in local/patches/<component>/).

Changes:

  * local/recipes/libs/libdrm/recipe.toml: upgrade from
    template = 'meson' + mesonflags to template = 'custom' +
    DYNAMIC_INIT + cookbook_apply_patches + cookbook_meson. This
    matches the structural pattern used by the other 3 Rule 2
    migration recipes (mesa, pipewire, wireplumber) and gives libdrm
    the same flexible shell-script build context for future
    cross-compilation tweaks. Adds build dependencies expat,
    libpciaccess, meson, ninja-build, pkgconf (the meson template
    had these implicit; the custom template requires them explicit).
    Patch application still goes through cookbook_apply_patches
    (4 dots from local/recipes/libs/libdrm/ to project root).

  * local/recipes/AGENTS.md: catalog update reflecting the libdrm
    template change (now 'custom' instead of 'meson') and adding
    catalog entries for 4 recipes that were created during this
    migration round but were missing from the catalog: libxkbcommon,
    pam-redbear, pipewire, wireplumber.

  * sources/redbear-0.1.0/manifest.json: add a new manifest entry
    for 'libs/libdrm' (the historical 0.1.0 archive entry for libdrm,
    which uses the patched tarball). This mirrors the existing
    'lib/libdrm' entry and gives 'repo restore' a consistent way to
    recover the libdrm source from the 0.1.0 release archive.

  * Doc updates: AGENTS.md, README.md, local/AGENTS.md,
    local/docs/CONSOLE-TO-KDE-DESKTOP-PLAN.md, local/docs/GPU-MESA-
    KDE-CHAIN-ASSESSMENT.md, local/recipes/AGENTS.md: bring the
    docs in line with the Rule 2 policy and the 4-migration set
    (pipewire, wireplumber, mesa, libdrm). Most are catalog or
    cross-reference updates.

  * local/docs/STUBS-FIX-PROGRESS.md: heavily trimmed (-303 net).
    The old document was tracking 346+ stub fixes from earlier
    sessions; most of those are now closed and the document has
    been condensed to the current state.

  * local/docs/SOURCE-OWNERSHIP-MODEL.md: deleted (-89 lines).
    This old doc described a 'source ownership' concept that has
    been superseded by the amended AGENTS.md Rule 2 (NO OVERLAY-
    STYLE PATCHES — SCOPED POLICY) section, which is the canonical
    source-ownership model going forward.
2026-06-10 08:24:02 +03:00

17 KiB

Red Bear OS Custom Recipes — Catalog

All recipes under local/recipes/ are Red Bear OS originals or patched forks of upstream Redox recipes. They are symlinked into recipes/<category>/ at build time via local/scripts/apply-patches.sh.

Convention: recipe directories contain recipe.toml (build instructions) and optionally source/ (source code for Rust cargo or custom templates). Patches for upstream sources live in local/patches/<component>/, never here.

archives

Recipe Template Language Description
uutils-tar cargo Rust GNU tar compatible archiver from uutils, for creating and extracting tar archives

branding

Recipe Template Language Description
redbear-release custom Shell OS release metadata: /etc/os-release, hostname, and branding assets

core

Recipe Template Language Description
ext4d custom Rust ext4 filesystem driver daemon (userspace, scheme-based)
fatd custom Rust FAT32 filesystem driver daemon (userspace, scheme-based)
grub custom Scripts GRUB boot manager integration for live ISO and bare-metal installs
pcid-spawner cargo Rust PCI device spawner — launches driver daemons on PCI device discovery

dev

Recipe Template Language Description
binutils-native custom C GNU binutils (ld, objdump, etc.) built for native Red Bear target
bison custom C GNU bison parser generator
cub custom Rust Red Bear build utility — build orchestration helper
flex custom C Fast lexical analyzer generator
gcc-native custom C GCC cross-compiler for native Red Bear target
gnu-make custom C GNU Make build tool
libtool custom C GNU libtool — generic library support script
llvm-native custom C++ LLVM/Clang toolchain built for native Red Bear target
m4 custom C GNU m4 macro processor
meson custom Python Meson build system
ninja-build custom C Ninja build system (small, fast build runner)
rust-native custom Rust Rust toolchain for native Red Bear builds

drivers

Recipe Template Language Description
ehcid cargo Rust EHCI (USB 2.0) host controller driver daemon
linux-kpi custom C headers Linux Kernel Programming Interface — C header shim translating Linux kernel APIs to redox-driver-sys. GPU and Wi-Fi only — no USB support
ohcid cargo Rust OHCI (USB 1.1) host controller driver daemon
redbear-btusb custom Rust Bluetooth USB transport driver — sends/receives HCI packets over USB
redbear-input-headers custom C headers Linux-compatible input event headers (input.h, evdev constants) for driver and compositor use
redbear-iwlwifi cargo Rust Intel Wi-Fi driver (iwlwifi port) — mac80211-based wireless networking
redox-driver-acpi cargo Rust ACPI driver — parses RSDP/SDT/MADT/FADT tables, exposes scheme:acpi
redox-driver-core cargo Rust Core driver traits and types shared across all redox-driver-* crates
redox-driver-pci cargo Rust PCI bus driver — enumerates PCI devices, exposes scheme:pci, provides config space access
redox-driver-sys custom Rust Safe Rust FFI wrappers for scheme:memory, scheme:irq, scheme:pci + hardware quirks system
uhcid cargo Rust UHCI (USB 1.1) host controller driver daemon
usb-core cargo Rust USB core stack — hub driver, device enumeration, transfer scheduling

gpu

Recipe Template Language Description
amdgpu custom C AMD GPU display core (DC) port with linux-kpi compat shim
redox-drm cargo Rust DRM/KMS scheme daemon — GPU driver manager, supports virtio-gpu, Intel, AMD. Auto-detects hardware and loads correct driver

groups

Recipe Template Language Description
build-essential-native custom Meta Meta-package group: compiler, linker, make, and core build tools for native development

kde

Recipe Template Language Description
breeze custom C++ KDE Breeze widget style and window decoration theme
kde-cli-tools custom C++ KDE command-line utilities (kde-open, kioclient, etc.)
kdecoration custom C++ KDE window decoration library — decoration plugin API for KWin
kf6-attica custom C++ KDE Frameworks 6 — Open Collaboration Services API (GHNS)
kf6-extra-cmake-modules custom CMake KDE Frameworks 6 — Extra CMake Modules (build system extensions)
kf6-karchive custom C++ KDE Frameworks 6 — archive handling (tar, zip, etc.)
kf6-kauth custom C++ KDE Frameworks 6 — authorization framework (PolicyKit integration)
kf6-kbookmarks custom C++ KDE Frameworks 6 — bookmark management (XBEL format)
kf6-kcmutils custom C++ KDE Frameworks 6 — KCModule utilities for System Settings
kf6-kcodecs custom C++ KDE Frameworks 6 — string encoding/decoding (base64, uuencode, etc.)
kf6-kcolorscheme custom C++ KDE Frameworks 6 — color scheme management
kf6-kcompletion custom C++ KDE Frameworks 6 — text completion widgets and utilities
kf6-kconfig custom C++ KDE Frameworks 6 — configuration file framework (INI, JSON)
kf6-kconfigwidgets custom C++ KDE Frameworks 6 — configuration-aware widgets
kf6-kcoreaddons custom C++ KDE Frameworks 6 — core utilities (KAboutData, KJob, KProcess)
kf6-kcrash custom C++ KDE Frameworks 6 — crash handler with DrKonqi integration
kf6-kdbusaddons custom C++ KDE Frameworks 6 — D-Bus convenience classes
kf6-kdeclarative custom C++ KDE Frameworks 6 — KDE QtQuick integration plugins
kf6-kded6 custom C++ KDE Frameworks 6 — background service daemon (kded6)
kf6-kglobalaccel custom C++ KDE Frameworks 6 — global keyboard shortcut registration
kf6-kguiaddons custom C++ KDE Frameworks 6 — GUI utilities (color picker, key sequence)
kf6-ki18n custom C++ KDE Frameworks 6 — internationalization (gettext integration)
kf6-kiconthemes custom C++ KDE Frameworks 6 — icon theme management and rendering
kf6-kidletime custom C++ KDE Frameworks 6 — idle time detection for screensaver/power
kf6-kio custom C++ KDE Frameworks 6 — I/O framework (KIO slaves for network/FS access)
kf6-kitemmodels custom C++ KDE Frameworks 6 — Qt model extensions (KRearrangeColumns, KSortFilter)
kf6-kitemviews custom C++ KDE Frameworks 6 — item view widgets (KFilterProxy, KCategoryDrawer)
kf6-kjobwidgets custom C++ KDE Frameworks 6 — async job tracking widgets
kf6-knewstuff custom C++ KDE Frameworks 6 — Get Hot New Stuff (GHNS) download framework
kf6-knotifications custom C++ KDE Frameworks 6 — system notification framework
kf6-kpackage custom C++ KDE Frameworks 6 — package/installation framework
kf6-kservice custom C++ KDE Frameworks 6 — service/plugin framework (mime type, .desktop parsing)
kf6-ksvg custom C++ KDE Frameworks 6 — SVG rendering with theme support
kf6-ktextwidgets custom C++ KDE Frameworks 6 — text editing widgets (KTextEdit, find/replace)
kf6-kwallet custom C++ KDE Frameworks 6 — secure credential storage
kf6-kwayland custom C++ KDE Frameworks 6 — Wayland protocol bindings for Qt/KDE
kf6-kwidgetsaddons custom C++ KDE Frameworks 6 — extra Qt widgets (KComboBox, KPageWidget)
kf6-kwindowsystem custom C++ KDE Frameworks 6 — window system integration (window info, stacking)
kf6-kxmlgui custom C++ KDE Frameworks 6 — XML-defined GUI (menus, toolbars, actions)
kf6-notifyconfig custom C++ KDE Frameworks 6 — notification configuration widgets
kf6-parts custom C++ KDE Frameworks 6 — embeddable document/viewer parts (KParts)
kf6-prison custom C++ KDE Frameworks 6 — barcode/QR code generation (QRencode wrapper)
kf6-pty custom C++ KDE Frameworks 6 — pseudoterminal (PTY) management
kf6-solid custom C++ KDE Frameworks 6 — hardware abstraction (storage, power, network)
kf6-sonnet custom C++ KDE Frameworks 6 — spell checking framework
kf6-syntaxhighlighting custom C++ KDE Frameworks 6 — syntax highlighting engine (Kate definitions)
kglobalacceld custom C++ KDE global shortcut daemon — handles keyboard shortcut registration
kirigami custom C++ KDE Kirigami — responsive QtQuick UI framework (convergent apps)
konsole custom C++ KDE Konsole — terminal emulator
kwin custom C++ KDE KWin — Wayland compositor and window manager
plasma-desktop custom C++ KDE Plasma Desktop — panels, desktop containment, applets
plasma-framework custom C++ KDE Plasma Framework — libplasma for Plasma shell and applets
plasma-wayland-protocols custom C++ KDE Plasma Wayland protocol extensions
plasma-workspace custom C++ KDE Plasma Workspace — plasma-shell, data engines, runners

libs

Recipe Template Language Description
freetype2 custom C FreeType 2 font rendering library
glib custom C GLib — core event loop, type system, utility functions
icu custom C++ ICU — Unicode and internationalization support
lcms2 custom C Little CMS 2 — color management library (v6.0 2026)
libdisplay-info custom C EDID and display descriptor parsing library (v6.0 2026)
libdrm custom C libdrm — DRM/KMS user-space library; Rule 2 (upstream git + local/patches/libdrm/*.patch via cookbook_apply_patches); Mesa + redox-drm dependency
libepoxy custom C Epoxy — OpenGL function pointer manager (cross-platform GL loader, v6.0 2026)
libevdev meson C libevdev — evdev device wrapper library for input handling
libinput meson C libinput — input device management (keyboard, pointer, touch)
libqrencode cmake C libqrencode — QR code encoding library
libudev custom C libudev — scheme:udev-backed device enumeration library (v6.0 2026)
libxcvt custom C libxcvt — VESA CVT mode timing calculation (v6.0 2026)
libxkbcommon custom C xkbcommon — keyboard description and keymap handling (KWin, Wayland)
pam-redbear custom C pam-redbear — Redox PAM module (delegates to redbear-authd)
pipewire custom C PipeWire — audio/video server; Rule 2 (upstream git + local/patches/pipewire/*.patch)
wireplumber custom C WirePlumber — PipeWire session/policy manager; Rule 2 (upstream git + local/patches/wireplumber/*.patch)
zbus custom Rust zbus crate — Rust D-Bus message bus library (library-only, custom build)

qt

Recipe Template Language Description
qt6-sensors custom C++ Qt 6 Sensors module — hardware sensor access (accel, gyro, etc.)
qtbase custom C++ Qt 6 Base — core, gui, widgets, network modules
qtdeclarative custom C++ Qt 6 QML/QtQuick — declarative UI framework
qtsvg custom C++ Qt 6 SVG — SVG rendering support for Qt
qtwayland custom C++ Qt 6 Wayland — Wayland compositor/client integration

system

Recipe Template Language Description
coretempd cargo Rust CPU core temperature monitoring daemon
cpufreqd cargo Rust CPU frequency scaling daemon
cub custom Rust Red Bear build utility (same as dev/cub, system-installed copy)
dbus meson C D-Bus reference implementation — system and session message bus
driver-manager custom Rust Driver lifecycle manager — loads/unloads drivers based on hardware
driver-params cargo Rust Driver parameter service — exposes driver configuration via scheme
evdevd custom Rust evdev event daemon — translates input events to evdev protocol
firmware-loader cargo Rust Firmware loading daemon — serves GPU/device firmware blobs via scheme:firmware
hwrngd cargo Rust Hardware RNG daemon — exposes entropy from hardware random number generator
iommu cargo Rust IOMMU daemon — manages I/O memory mapping for device DMA
numad cargo Rust NUMA topology daemon — exposes NUMA node information
redbear-accessibility custom Rust Accessibility service — screen reader and input assistance bridge
redbear-acmd cargo Rust Red Bear admin CLI — system administration commands
redbear-authd cargo Rust Authentication daemon — PAM-like auth with scheme:auth
redbear-btctl custom Rust Bluetooth control utility — scan, pair, connect Bluetooth devices
redbear-dbus-services custom Config D-Bus service activation files and XML policy files for system/session buses
redbear-ecmd cargo Rust Extended command-line tool — system diagnostics and info
redbear-firmware custom Scripts Firmware management utility — list, extract, verify firmware blobs
redbear-greeter custom Rust Login greeter daemon — displays graphical login prompt
redbear-hwutils cargo Rust Hardware utility library and CLI — PCI, USB, sensor information
redbear-ime custom Rust Input method engine — multilingual text input framework
redbear-info cargo Rust System information daemon — hardware and OS state queries
redbear-keymapd custom Rust Keyboard layout daemon — manages keymaps and input layouts
redbear-login-protocol cargo Rust Login protocol crate — shared types for auth session management
redbear-meta custom Meta Meta-package — ensures core Red Bear system packages are installed
redbear-mtr cargo Rust MTR network diagnostic tool — traceroute + ping combined
redbear-netctl cargo Rust Network control daemon — manages network interfaces and connections
redbear-netctl-console cargo Rust Network control console UI — TUI for redbear-netctl
redbear-netstat cargo Rust Network statistics tool — socket, interface, and routing info
redbear-nmap cargo Rust Network mapper — port scanning and host discovery
redbear-notifications cargo Rust Notification daemon — freedesktop.org notification spec implementation
redbear-passwd cargo Rust Password management utility — change passwords, manage shadow
redbear-polkit cargo Rust PolicyKit daemon — authorization framework for privileged operations
redbear-quirks custom Config Hardware quirks database — TOML quirk definitions for known issues
redbear-sessiond cargo Rust Session manager daemon — D-Bus login1 subset for KWin/Wayland
redbear-session-launch cargo Rust Session launcher — starts desktop session compositor and services
redbear-statusnotifierwatcher cargo Rust Status Notifier Watcher — freedesktop.org system tray spec
redbear-traceroute cargo Rust Traceroute utility — network path discovery
redbear-udisks cargo Rust UDisks2 daemon — storage device management via D-Bus
redbear-upower cargo Rust UPower daemon — power management and battery status via D-Bus
redbear-usbaudiod cargo Rust USB audio daemon — USB audio class device driver
redbear-wayland-guard custom Rust Wayland security guard — validates compositor/client permissions
redbear-wifictl cargo Rust Wi-Fi control utility — scan, connect, manage wireless networks
seatd meson C seatd — seat management daemon for DRM master access
thermald cargo Rust Thermal management daemon — monitors and controls CPU temperature
udev-shim cargo Rust udev compatibility shim — translates libudev calls to Red Bear schemes

tests

Recipe Template Language Description
redox-drm-prime-test custom Rust DRM PRIME buffer sharing test — validates GPU buffer import/export
relibc-phase1-tests custom C relibc POSIX compliance tests — validates syscall wrappers and C library functions

tools

Recipe Template Language Description
diffutils custom C GNU diffutils — diff, diff3, sdiff, cmp

tui

Recipe Template Language Description
mc custom C GNU Midnight Commander — file manager with TUI

wayland

Recipe Template Language Description
libwayland custom C libwayland — Wayland protocol client/server library
qt6-wayland-smoke custom C++ Qt 6 Wayland smoke test — minimal QML window on Wayland
redbear-compositor cargo Rust Red Bear Wayland compositor — compositor shell for DRM/KMS output
seatd-redox meson C seatd Redox backend — seat management for Red Bear's scheme system
smallvil cargo C Smallvil — minimal wlroots-based Wayland compositor for testing
wayland-protocols custom C Wayland protocol extensions — stable and staging protocol XML files