docs/BUILDER-INSTRUCTIONS.md

@@ -82,8 +82,8 @@ Inside `<property name="screen0" type="empty">`, 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:  <property … type="string" value="/path/to/wallpaper"/>
     BAD:   <property … type="array">  ← 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) |
 
 ---
 

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 |
 
 ---