refactor: use terminal-native notifications

.agents/skills/elliot-dotfiles/references/repository-map.md

@@ -31,7 +31,7 @@ Environment selector restored to `~/.miserc.toml`. It detects Arch, Fedora, RHEL
 - `config/conf.d/packages.dnf.toml`: DNF-family packages/settings, including Fcitx5 packages.
 - `config/conf.d/packages.pacman.toml`: Pacman/Arch packages/settings, including Fcitx5 packages.
 - `config/conf.d/platform.omarchy.toml`: Omarchy-specific tracked theme files and theme bootstrap behavior.
-- `config/conf.d/platform.wsl.toml`: WSL behavior and Windows font bootstrap override.
+- `config/conf.d/platform.wsl.toml`: WSL behavior and Windows font/bootstrap integration override.
 - `config/conf.d/platform.wslg.toml`: WSLg-specific configuration.
 - `config/config.flatpak.toml`: Flatpak-specific bootstrap/update behavior.
 
@@ -44,13 +44,14 @@ These files are restored directly to their application paths and use `mode = "tr
 - `home/.config/yazi/`;
 - `home/.config/topgrade.toml` and `home/.config/topgrade.systemd.toml`;
 - `home/.config/ghostty/config`;
+- `home/.config/herdr/config.toml`;
 - `home/.config/omarchy/themed/gomi.yaml.tpl`, `home/.config/omarchy/themed-links.toml`, and `home/.config/omarchy/hooks/theme-set.d/50-themed-links`;
 - `home/.config/xdg-terminals.list`;
 - `home/.config/fcitx5/profile`;
 - `home/.config/environment.d/90-fcitx5.conf`;
 - `home/.local/share/mise-completions-sync/registry.toml`.
 
-Fcitx5 user configuration is shared across APT, DNF, and Pacman systems; only package installation stays package-manager-specific. `~/.gitconfig` is managed only through a block edit so machine-local identity is not synchronized.
+Herdr's tracked config routes agent completion/input notifications through the outer terminal with `[ui.toast] delivery = "terminal"`. Fcitx5 user configuration is shared across APT, DNF, and Pacman systems; only package installation stays package-manager-specific. `~/.gitconfig` is managed only through a block edit so machine-local identity is not synchronized.
 
 ## Bundled assets and scripts
 
@@ -59,8 +60,9 @@ Fcitx5 user configuration is shared across APT, DNF, and Pacman systems; only pa
 - `config/scripts/bootstrap-ghostty-fedora.sh`: Fedora Ghostty helper.
 - `config/scripts/bootstrap-windows.sh`: WSL-side wrapper that installs the Windows JetBrainsMono Nerd Font only.
 - `config/scripts/bootstrap-windows.ps1`: Windows-native WinGet font installer.
+- `config/scripts/bootstrap-windows-terminal.sh`: WSL-side Windows Terminal integration for keybindings and terminal-native notifications.
 - `config/scripts/tinty-windows-terminal.sh`: Tinty-side Windows Terminal integration; writes `tinty.json`, registers its JSONC import, and removes legacy `palette.json` state.
-- `config/scripts/ensure-windows-terminal-import.cjs`: JSONC editor used by the Tinty Windows Terminal helper.
+- `config/scripts/ensure-windows-terminal-import.cjs`: JSONC editor used by Windows Terminal integration helpers.
 - `config/scripts/tinty-theme-picker.sh`: platform-independent Gum-based Tinty scheme picker with apply/restore preview flow.
 - `config/scripts/login-github.sh`: GitHub login/configuration workflow.
 

.mise-history/manifest.json

@@ -67,6 +67,12 @@
       "encrypt": false,
       "variants": []
     },
+    {
+      "path": "home/.config/herdr/config.toml",
+      "autosave": true,
+      "encrypt": false,
+      "variants": []
+    },
     {
       "path": "home/.config/omarchy/hooks/theme-set.d/50-themed-links",
       "autosave": true,

README.md

@@ -37,12 +37,14 @@ Omarchy 環境則直接使用 Omarchy 的主題系統，不需要另外使用 Ti
 
 ## Windows / WSL
 
-在 WSL bootstrap 時會一併安裝 Windows 端的 JetBrainsMono Nerd Font，並套用 Windows Terminal 快捷鍵；`Ctrl+Shift+Z` 會送出 Zsh redo 所需的 escape sequence。需要再次執行 Windows 整合 bootstrap 時可使用：
+在 WSL bootstrap 時會一併安裝 Windows 端的 JetBrainsMono Nerd Font，並套用 Windows Terminal 整合：`Ctrl+Shift+Z` 會送出 Zsh redo 所需的 escape sequence，也會啟用長時間 command 的原生桌面通知。需要再次執行 Windows 整合 bootstrap 時可使用：
 
 ```bash
 mise run bootstrap:windows
 ```
 
+Ghostty 與 Windows Terminal 會在長時間 command 完成後顯示通知，包含成功或失敗狀態、執行時間與原始 command；Windows Terminal 的 command-completion 通知不支援 tmux session，其他 terminal 也不額外啟用此通知。Herdr 會在 agent 完成或等待輸入時使用 terminal notification。
+
 ## 常用指令
 
 | 用途 | 指令 |

config/conf.d/platform.wsl.toml

@@ -1,11 +1,8 @@
 # WSL-specific mise configuration.
 # This fragment is loaded only when the `wsl` environment is active.
 
-[env]
-SHELDON_PROFILE = "wsl"
-
 [tasks."bootstrap:windows"]
-description = "Configure Windows font and Terminal keybinds"
+description = "Configure Windows font and Terminal integration"
 hide = false
 run = [
   "sh \"${MISE_CONFIG_DIR:-$HOME/.config/mise}/scripts/bootstrap-windows.sh\"",

config/config.toml

@@ -120,6 +120,7 @@ fc-cache -f "$font_dir"
 "~/.config/topgrade.toml" = { mode = "track" }
 "~/.config/topgrade.systemd.toml" = { mode = "track" }
 "~/.config/ghostty/config" = { mode = "track" }
+"~/.config/herdr/config.toml" = { mode = "track" }
 "~/.config/xdg-terminals.list" = { mode = "track" }
 "~/.config/fcitx5/profile" = { mode = "track" }
 "~/.config/environment.d/90-fcitx5.conf" = { mode = "track" }

config/hk.pkl

@@ -70,13 +70,19 @@ local checks = new Mapping<String, Step> {
     )
     check = "zsh -n {{files}}"
   }
-  ["wsl-notify"] {
+  ["terminal-notify"] {
     glob = List(
-      "../home/.config/sheldon/plugins/wsl-notify.plugin.zsh",
-      "scripts/wsl-notify.ps1",
-      "tests/wsl-notify.zsh"
+      "../home/.config/herdr/config.toml",
+      "../home/.config/sheldon/plugins/terminal-notify.plugin.zsh",
+      "tests/terminal-notify.zsh",
+      "windows-terminal/notification.json"
     )
-    check = "zsh tests/wsl-notify.zsh"
+    check = """
+      set -e
+      zsh tests/terminal-notify.zsh
+      jq -e '.profiles.defaults["compatibility.allowOSC777"] == true' windows-terminal/notification.json >/dev/null
+      grep -Fxq 'delivery = "terminal"' ../home/.config/herdr/config.toml
+    """
   }
 }
 

config/scripts/bootstrap-windows-terminal.sh

@@ -3,14 +3,15 @@ set -eu
 
 jsonc_parser_version=3.3.1
 config_dir=${MISE_CONFIG_DIR:-$HOME/.config/mise}
-fragment="$config_dir/windows-terminal/keybind.json"
 editor_script="$config_dir/scripts/ensure-windows-terminal-import.cjs"
-import_name=keybind.json
 
-if [ ! -f "$fragment" ]; then
-  printf 'windows terminal bootstrap: keybind fragment was not found: %s\n' "$fragment" >&2
-  exit 1
-fi
+for import_name in keybind.json notification.json; do
+  fragment="$config_dir/windows-terminal/$import_name"
+  if [ ! -f "$fragment" ]; then
+    printf 'windows terminal bootstrap: fragment was not found: %s\n' "$fragment" >&2
+    exit 1
+  fi
+done
 
 if [ ! -f "$editor_script" ]; then
   printf 'windows terminal bootstrap: JSONC editor was not found: %s\n' "$editor_script" >&2
@@ -85,14 +86,17 @@ do
 
   if [ "$found" = false ]; then
     if ! command -v node >/dev/null 2>&1 || ! command -v npm >/dev/null 2>&1; then
-      printf 'windows terminal bootstrap: node and npm are required to register %s\n' "$import_name" >&2
+      printf 'windows terminal bootstrap: node and npm are required to register terminal fragments\n' >&2
       exit 1
     fi
     ensure_jsonc_parser
     found=true
   fi
 
-  cp -f -- "$fragment" "$state_directory/$import_name"
-  NODE_PATH="$jsonc_node_path${NODE_PATH:+:$NODE_PATH}" \
-    node "$editor_script" "$settings_path" "$import_name"
+  for import_name in keybind.json notification.json; do
+    fragment="$config_dir/windows-terminal/$import_name"
+    cp -f -- "$fragment" "$state_directory/$import_name"
+    NODE_PATH="$jsonc_node_path${NODE_PATH:+:$NODE_PATH}" \
+      node "$editor_script" "$settings_path" "$import_name"
+  done
 done