docs: record phase 1 migration of rofi call sites

Twelve call sites repointed, backups in /data/udt-backup.

Also records three things found during the migration: rofipass was passing a
-width flag that rofi 2.0.0 no longer has, the type-4 power menu reuses one
directory variable for two different themes, and ddgr_search.py is a rofi
script-mode plugin rather than a call site.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G6aeE37K4GHBsaM51yLTTq

2 files changed, 68 insertions, 0 deletions

diff --git a/docs/MIGRATION.md b/docs/MIGRATION.md
new file mode 100644
index 0000000..9f1c48d
--- /dev/null
+++ b/docs/MIGRATION.md
@@ -0,0 +1,63 @@
+# Migration record, phase 1 (rofi)
+
+Files edited outside this repository, on 2026-09-11. Backups of every file
+listed here, taken immediately before the edits, are in `/data/udt-backup/`.
+
+## Call sites repointed
+
+| File | Was | Now |
+| --- | --- | --- |
+| `~/bin/blackpearl-sshmenu.sh` | `launchers/type-2/style-1` | `udt/list.rasi` |
+| `~/bin/github-repos.sh` | `launchers/type-2/style-1` | `udt/list.rasi` |
+| `~/bin/hypr-windows.sh` | `launchers/type-2/style-1` | `udt/list.rasi` |
+| `~/bin/blackpearl-emoji.sh` | `darknix/runner.rasi` | `udt/list.rasi` |
+| `~/bin/rofi-qemu.sh` | `darknix/runner.rasi` | `udt/list.rasi` |
+| `~/bin/rofipass` | `elegantVagrant/elegantvagrant-dark` | `udt/list.rasi` |
+| `~/.config/hypr/sections/keybindings.lua` | `launchers/type-2/style-1` | `udt/list.rasi` |
+| `~/bin/qar-scrotmenu.sh` | `darknix/scrotmenu.rasi` | `udt/menu.rasi` |
+| `~/bin/blackpearl-notes.sh` | `darknix/notes.rasi` | `udt/menu.rasi` |
+| `~/.config/rofi/powermenu/type-4/powermenu.sh` | `powermenu/type-4/style-5` | `udt/menu.rasi` |
+| `~/bin/blackpearl-appsmenu.sh` | `darknix/appmenu.rasi` | `udt/launcher.rasi` |
+| `~/.config/rofi/launchers/type-1/launcher.sh` | `launchers/type-1/style-5` | `udt/launcher.rasi` |
+
+## Other edits
+
+- `~/bin/wallp`: `finalize()` now calls `udt-accent` with
+  `~/.cache/wal/wpaper`, guarded so a failure cannot stop the wallpaper being
+  set.
+
+- `~/bin/rofipass`: dropped a `-width 1000` flag. It is not a rofi 2.0.0
+  option (width moved into the theme), so it was silently doing nothing. The
+  `-theme-str` width override further down the same script is the modern form
+  and was left alone.
+
+- `~/.config/rofi/powermenu/type-4/powermenu.sh`: this script uses `$dir` for
+  two different themes, its main menu and its confirmation dialog. Repointing
+  `$dir` at `udt/` would have broken the confirm dialog, so that one line now
+  carries the absolute path to the theme it always used.
+
+## Not a call site
+
+`~/bin/ddgr_search.py` was listed in the original plan but is not a call site.
+It is a rofi script-mode plugin, invoked *by* rofi rather than invoking it, so
+its appearance comes from whatever command runs it. No keybinding or waybar
+button currently does.
+
+## Not removed
+
+The old theme directories are still on disk and untouched:
+`~/.config/rofi/darknix/`, `elegantVagrant/`, `launchers/`, `applets/`,
+`powermenu/`. Deleting them is a separate decision, deferred until the new
+themes have been lived with.
+
+Two of those directories are still genuinely in use and are not candidates for
+deletion yet:
+
+- `~/.config/rofi/applets/` is referenced from waybar (`applets/bin/mpd.sh`).
+- `~/.config/rofi/powermenu/type-4/shared/confirm.rasi` is still the power
+  menu's confirmation dialog.
+
+## Out of scope
+
+`ronema` (rofi NetworkManager applet) was excluded: no longer used, pending
+archival.
diff --git a/docs/superpowers/plans/2026-09-11-rofi-unified-theme.md b/docs/superpowers/plans/2026-09-11-rofi-unified-theme.md
index 6ae386c..4b5ed8c 100644
--- a/docs/superpowers/plans/2026-09-11-rofi-unified-theme.md
+++ b/docs/superpowers/plans/2026-09-11-rofi-unified-theme.md
@@ -895,6 +895,11 @@ diff ~/.cache/wal/colors.json /tmp/udt-check/before-wallp.json && echo "ISOLATIO
 
 Expected: the accent file reflects the restored wallpaper, and `ISOLATION OK` confirms the terminal palette did not move. **If the diff is non-empty, stop and investigate before continuing.**
 
+Note: `wallp` starts `swaybg` in the background, and it inherits the shell's
+stdout. A command substitution or a pipe will therefore appear to hang after
+`wallp` itself has finished. Redirect its output (`wallp --restore >/dev/null
+2>&1`) when calling it from a script or a captured shell.
+
 - [ ] **Step 6: Commit**
 
 ```bash