From f9a6bc57bc600e19912e3874beeebbd683f30cab Mon Sep 17 00:00:00 2001 From: Clawdie AI Date: Thu, 26 Mar 2026 08:59:39 +0000 Subject: [PATCH] docs: update all XFCE/KDE/MATE references to Lumina MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CLAWDIE-ISO.md: add deprecation notice, update all DE references to Lumina only - docs/HOST-OPERATOR-MODEL.md: .7 VM is FreeBSD + Lumina (instead of XFCE) Lumina is the sole supported FreeBSD-native desktop environment as per LUMINA-INTEGRATION.md and CLAWDIE-ISO-REFACTORED.md specifications. Co-Authored-By: Claude Haiku 4.5 --- Build: pass | Tests: FAIL — Tests 2 failed | 487 passed | 10 skipped (499) --- CLAWDIE-ISO.md | 33 +++++++++++++++------------------ docs/HOST-OPERATOR-MODEL.md | 2 +- 2 files changed, 16 insertions(+), 19 deletions(-) diff --git a/CLAWDIE-ISO.md b/CLAWDIE-ISO.md index b08b180..d68512f 100644 --- a/CLAWDIE-ISO.md +++ b/CLAWDIE-ISO.md @@ -1,5 +1,7 @@ # CLAWDIE-ISO — USB Installer Plan +⚠️ **DEPRECATED — See [CLAWDIE-ISO-REFACTORED.md](CLAWDIE-ISO-REFACTORED.md) and [LUMINA-INTEGRATION.md](LUMINA-INTEGRATION.md) for current architecture.** + **Status:** Draft brainstorm — 2026-03-17 **Target repo:** `codeberg.org/Clawdie/clawdie-iso` (to be created) @@ -38,8 +40,8 @@ post-install desktop configuration step: - Detects GPU via `pciconf -lv` - Installs the right kld modules (i915kms, nvidia-modeset, drm, vboxguest, etc.) - Writes `kld_list` to `/etc/rc.conf` for persistent driver loading -- Installs the chosen DE (KDE Plasma, XFCE, MATE, GNOME, Lumina, etc.) -- Configures dbus, CUPS, sound (OSS/PulseAudio), login manager (SDDM/lightdm/slim) +- Installs the chosen DE (Lumina — FreeBSD-native) +- Configures dbus, CUPS, sound (OSS/PulseAudio), login manager (lightdm) - Handles VirtualBox, VMware, Parallels, bhyve guest additions automatically - Does NOT typically require a reboot — kld can be loaded live or on next boot - Respects quarterly vs latest pkg repository configured on the system @@ -135,7 +137,7 @@ edits this file before booting: ```sh PKG_BRANCH=latest -DESKTOP=xfce +DESKTOP=lumina AGENT_NAME=clawdie ASSISTANT_NAME="Clawdie" TZ=Europe/Ljubljana @@ -158,7 +160,7 @@ After bsdinstall's base install completes but before the system reboots, `installerconfig` runs a bsddialog wizard. The wizard covers: 1. Pkg branch (latest / quarterly) -2. Desktop environment (XFCE / KDE Plasma / MATE / Headless) +2. Desktop: Lumina (fixed, no choice) 3. Agent name + assistant name 4. Telegram bot token (optional, can be skipped) 5. Summary screen → confirm → install @@ -258,7 +260,6 @@ USB boot First boot from HDD (reboot 1) └─ rc.firstboot (clawdie-firstboot service) ├─ bsddialog: pkg branch (latest [default] / quarterly) - ├─ bsddialog: desktop environment (XFCE / KDE / MATE / Headless) ├─ bsddialog: agent name + assistant name ├─ bsddialog: Telegram bot token (optional) ├─ bsddialog: summary + confirm @@ -331,26 +332,22 @@ Derived from `setup/environment.ts` host baseline + desktop-installer + DE packa `node24`, `npm`, `bsddialog`, `bastille`, `git`, `tmux`, `python311`, `uv`, `ripgrep`, `fd-find`, `rsync`, `postgresql17-client`, `py311-pillow`, `dejavu` -**Desktop-installer and Xorg baseline:** -`desktop-installer`, `xorg-minimal`, `xf86-video-intel`, `drm-kmod`, +**Xorg baseline:** +`xorg-minimal`, `xf86-video-intel`, `drm-kmod`, `xf86-input-libinput`, `dbus`, `hal` Note: `xf86-video-vboxvideo` and VirtualBox guest additions are **excluded**. Target hardware is real machines and bhyve only. VirtualBox is out of scope. -**XFCE (default DE):** -`xfce`, `xfce4-goodies`, `lightdm`, `lightdm-gtk-greeter` - -**KDE Plasma (optional, large):** -`plasma5-plasma`, `kde-baseapps`, `sddm` - -**MATE (optional, lightweight alt):** -`mate`, `mate-extra`, `lightdm`, `lightdm-gtk-greeter` +**Lumina (sole supported DE):** +`lumina-core`, `lumina-themes`, `lumina-calculator`, `lumina-archiver`, +`lumina-filemanager`, `lumina-screenshot`, `lumina-open`, `openbox`, +`libxcb`, `libxdg-basedir`, `lightdm`, `lightdm-gtk-greeter` **NVIDIA support (optional):** `nvidia-driver`, `nvidia-settings` -Total estimated size (XFCE path, latest): ~2–3 GB packages + ~600 MB FreeBSD base +Total estimated size (Lumina path, latest): ~1.5 GB packages + ~600 MB FreeBSD base --- @@ -536,7 +533,7 @@ ASSISTANT_NAME=Clawdie TZ=Europe/Ljubljana AGENT_DOMAIN=clawdie.local PKG_BRANCH=latest # latest or quarterly -DESKTOP=xfce # xfce, kde, mate, headless +DESKTOP=lumina # lumina only TELEGRAM_BOT_TOKEN= # optional, leave blank to skip ANTHROPIC_API_KEY= # optional ``` @@ -586,7 +583,7 @@ partition is accessible but requires extra step). Blank fields still need wizard 1. Create `codeberg.org/Clawdie/clawdie-iso` repo (empty, README only) 2. Copy this document as the repo's `CLAWDIE-ISO.md` -3. Write `build.cfg` with FreeBSD 15.0-RELEASE-p4, amd64, XFCE default +3. Write `build.cfg` with FreeBSD 15.0-RELEASE-p4, amd64, Lumina default 4. Write `gpu-detect.sh` (vendor from desktop-installer, simplify) 5. Write `firstboot.sh` (bsddialog wizard + exec setup.sh) 6. Write `installerconfig` (minimal, just copies firstboot/ tree) diff --git a/docs/HOST-OPERATOR-MODEL.md b/docs/HOST-OPERATOR-MODEL.md index b6650b0..fd95398 100644 --- a/docs/HOST-OPERATOR-MODEL.md +++ b/docs/HOST-OPERATOR-MODEL.md @@ -46,7 +46,7 @@ All addresses relative to `AGENT_SUBNET_BASE` (default `10.0.0`): | `.4` | Code Service | jail | local git mirror | | `.5` | Web Service | jail | nginx, Astro, Strapi | | `.6` | Local Inference | jail | ollama — optional, `FEATURE_OLLAMA=YES` | -| `.7` | FreeBSD Desktop | bhyve VM | FreeBSD + XFCE, VNC, Chromium | +| `.7` | FreeBSD Desktop | bhyve VM | FreeBSD + Lumina, VNC, Chromium | | `.8` | Debian | bhyve VM | Linux guest | | `.9` | Windows | bhyve VM | UEFI + VirtIO — optional | | `.10` | CnC | jail | command & control — design TBD |