diff --git a/docs/BUILDER-INSTRUCTIONS.md b/docs/BUILDER-INSTRUCTIONS.md index 6b7c8aa2..86498afd 100644 --- a/docs/BUILDER-INSTRUCTIONS.md +++ b/docs/BUILDER-INSTRUCTIONS.md @@ -82,8 +82,8 @@ Inside ``, after the existing ``` **CRITICAL:** Ensure all wallpaper property values are **scalars**, not arrays. -xfdesktop silently ignores array-typed values. The symptom is a monitor -falling back to the default XFCE background. In the XML this means: +xfdesktop silently ignores array-typed values. The symptom is a monitor +falling back to the default XFCE background. In the XML this means: GOOD: BAD: ← use type="string" instead @@ -137,6 +137,7 @@ falling back to the default XFCE background. In the XML this means: ``` Layout summary: + - HDMI-A-0: 1920×1080, rotated 270° (vertical), position (0,0), NOT primary - eDP (laptop): 1920×1080, rotation 0°, PRIMARY, position (1080,840) - The laptop sits to the right of the rotated HDMI, centered vertically. @@ -163,6 +164,7 @@ xfce4-power-manager.xml. Add `displays.xml` to that list: ``` Also update the grep check on the next line: + ```diff - if ! grep -Eq '^hostname="clawdie-live"' "${MOUNT_POINT}/etc/rc.conf"; then + if ! grep -Eq '^hostname="usb.clawdie.home.arpa"' "${MOUNT_POINT}/etc/rc.conf"; then @@ -228,20 +230,20 @@ pkill xfce4-panel; DISPLAY=:0 xfce4-panel & ## Verification checklist (post-build boot) -| # | Test | Expected | -|---|---|---| -| 1 | `dmesg \| grep -c AE_AML_BUFFER_LIMIT` | 0 | -| 2 | `kldstat \| grep asus` | (empty) | -| 3 | `hostname` | `usb.clawdie.home.arpa` | -| 4 | Panel on laptop display | taskbar on eDP, not HDMI | -| 5 | Wallpaper on both monitors | clawdie-operator-bg.png on laptop + TV | -| 6 | HDMI rotation | 270° (vertical) | -| 7 | Clawdie-start icon | clearly rendered, not fuzzy/misplaced | -| 8 | xkb plugin | shows flag icon, not "si" text | -| 9 | Clock format | shows 2-digit year (e.g., `06:23 04.Jun.26`) | -| 10 | Visuals guard | absent (`/usr/local/bin/clawdie-xfce-visuals-guard.sh` → no such file) | -| 11 | No-blank guard | runs (check `~/.clawdie-noblank-guard.log`) | -| 12 | `xfconf-query -c xfce4-desktop -p /backdrop/screen0 -lv` | All `image-path`/`last-image` values are **scalars** (no `[...]` brackets) | +| # | Test | Expected | +| --- | -------------------------------------------------------- | -------------------------------------------------------------------------- | +| 1 | `dmesg \| grep -c AE_AML_BUFFER_LIMIT` | 0 | +| 2 | `kldstat \| grep asus` | (empty) | +| 3 | `hostname` | `usb.clawdie.home.arpa` | +| 4 | Panel on laptop display | taskbar on eDP, not HDMI | +| 5 | Wallpaper on both monitors | clawdie-operator-bg.png on laptop + TV | +| 6 | HDMI rotation | 270° (vertical) | +| 7 | Clawdie-start icon | clearly rendered, not fuzzy/misplaced | +| 8 | xkb plugin | shows flag icon, not "si" text | +| 9 | Clock format | shows 2-digit year (e.g., `06:23 04.Jun.26`) | +| 10 | Visuals guard | absent (`/usr/local/bin/clawdie-xfce-visuals-guard.sh` → no such file) | +| 11 | No-blank guard | runs (check `~/.clawdie-noblank-guard.log`) | +| 12 | `xfconf-query -c xfce4-desktop -p /backdrop/screen0 -lv` | All `image-path`/`last-image` values are **scalars** (no `[...]` brackets) | --- diff --git a/docs/COLIBRI-XFCE-HANDOFF-04.JUN.2026.md b/docs/COLIBRI-XFCE-HANDOFF-04.JUN.2026.md index fab674c1..92e2d0eb 100644 --- a/docs/COLIBRI-XFCE-HANDOFF-04.JUN.2026.md +++ b/docs/COLIBRI-XFCE-HANDOFF-04.JUN.2026.md @@ -9,10 +9,10 @@ All changes baked into ISO build. Three branches merged via PR #11: -| Branch | What | -|---|---| -| `fix/xfce-start-icon-48` | Proper 48px PNG (was duplicate 64px) | -| `fix/remove-xfce-visuals-guard` | Removed runtime XFCE visuals guard | +| Branch | What | +| --------------------------------- | ------------------------------------------- | +| `fix/xfce-start-icon-48` | Proper 48px PNG (was duplicate 64px) | +| `fix/remove-xfce-visuals-guard` | Removed runtime XFCE visuals guard | | `fix/desktop-layout-and-hostname` | Displays, hostname, ACPI, panel, clock, xkb | ### What ships now @@ -97,6 +97,7 @@ Matches ANY `daemon(8)` instance on the system (tailscaled uses one too). always reports "not running" even when colibri-daemon is up. **Fix:** Use a unique procname: + ```ini procname="colibri-daemon" ``` @@ -107,6 +108,7 @@ The `-P` flag should write the supervisor PID, but no file appears. Combined with Bug 1, `service status` has no way to find the process. **Fix options:** + - **A (recommended):** Drop daemon(8) wrapper, let rc.subr's built-in supervision handle forking. Run `colibri-daemon` directly as the `command`, with `command_args` containing just the daemon's own flags. @@ -123,6 +125,7 @@ when `procname` matches a generic daemon. This confirms Bug 1 cascades. ### Access permission `clawdie` user cannot use `colibri` CLI out of the box: + - `/var/run/colibri` is 0750, owned `colibri:colibri` - Fix (already applied live): `pw groupmod colibri -m clawdie` @@ -132,6 +135,7 @@ Current: `colibri_daemon_enable="NO"` — intentional, documented as "so Colibri cannot block SDDM/XFCE startup". To enable out-of-box: + ```sh sysrc colibri_daemon_enable="YES" ``` @@ -153,15 +157,15 @@ service colibri_daemon stop ## Files touched on live USB -| Path | Change | -|---|---| -| `/etc/rc.conf` | hostname, kld_list (no asus), colibri enabled | -| `/usr/local/bin/clawdie-xfce-visuals-guard.sh` | removed | -| `/usr/local/etc/xdg/autostart/clawdie-xfce-visuals-guard.desktop` | removed | -| `/usr/local/bin/hw-report` | visuals guard log line removed | -| `/usr/local/share/icons/hicolor/48x48/apps/clawdie-start.png` | replaced with proper 48px | -| `~/etc/group` | clawdie added to colibri group | -| `~/.config/xfce4/` | reset from skel, then displays/panel/desktop restored from backup | +| Path | Change | +| ----------------------------------------------------------------- | ----------------------------------------------------------------- | +| `/etc/rc.conf` | hostname, kld_list (no asus), colibri enabled | +| `/usr/local/bin/clawdie-xfce-visuals-guard.sh` | removed | +| `/usr/local/etc/xdg/autostart/clawdie-xfce-visuals-guard.desktop` | removed | +| `/usr/local/bin/hw-report` | visuals guard log line removed | +| `/usr/local/share/icons/hicolor/48x48/apps/clawdie-start.png` | replaced with proper 48px | +| `~/etc/group` | clawdie added to colibri group | +| `~/.config/xfce4/` | reset from skel, then displays/panel/desktop restored from backup | ---