docs: draft changelog for next release

3 files changed, 16 insertions, 6 deletions

diff --git a/.pi/docs/CONFIGURATION.md b/.pi/docs/CONFIGURATION.md
index 4336185e..61e316d1 100644
--- a/.pi/docs/CONFIGURATION.md
+++ b/.pi/docs/CONFIGURATION.md
@@ -190,7 +190,7 @@ command = "notify-send herdr 'custom command ran'"
 
 ## theme
 
-herdr ships with 10 built-in color themes. set one in config:
+herdr ships with 17 built-in color themes. set one in config:
 
 ```toml
 [theme]
@@ -202,14 +202,21 @@ name = "tokyo-night"
 | name | description |
 |------|-------------|
 | `catppuccin` | soft pastel mocha palette (default) |
+| `catppuccin-latte` | light catppuccin palette |
 | `tokyo-night` | blue-purple aesthetic |
+| `tokyo-night-day` | light tokyo night palette |
 | `dracula` | purple/pink/green classic |
 | `nord` | frosty scandinavian blues |
 | `gruvbox` | warm retro browns/oranges |
-| `one-dark` | atom's beloved palette |
-| `solarized` | ethan schoonover's classic |
+| `gruvbox-light` | light gruvbox palette |
+| `one-dark` | atom's beloved dark palette |
+| `one-light` | atom's light palette |
+| `solarized` | ethan schoonover's classic dark palette |
+| `solarized-light` | ethan schoonover's classic light palette |
 | `kanagawa` | hokusai-inspired |
+| `kanagawa-lotus` | light kanagawa palette |
 | `rose-pine` | muted, elegant |
+| `rose-pine-dawn` | light rosé pine palette |
 | `vesper` | high-contrast monochrome with peach and mint accents |
 
 theme names are flexible: `tokyo-night`, `tokyonight`, and `tokyo_night` all work.
@@ -261,6 +268,7 @@ for `panel_bg`, you can also use `reset`, `default`, `none`, or `transparent` to
 ```toml
 [ui]
 sidebar_width = 26
+mouse_capture = true
 confirm_close = true
 show_agent_labels_on_pane_borders = false
 agent_panel_scope = "all"
@@ -272,6 +280,7 @@ accent = "cyan"
 | option | default | description |
 |--------|---------|-------------|
 | `sidebar_width` | `26` | base sidebar width before auto-scaling |
+| `mouse_capture` | `true` | capture mouse input for Herdr's mouse UI; set false to let the terminal handle normal clicks while still forwarding mouse to pane apps that request it |
 | `confirm_close` | `true` | ask before closing a workspace |
 | `show_agent_labels_on_pane_borders` | `false` | show detected/reported agent labels in split pane borders when no manual pane name is set |
 | `agent_panel_scope` | `all` | sidebar agent list scope: `current` or `all` |
diff --git a/.pi/docs/INTEGRATIONS.md b/.pi/docs/INTEGRATIONS.md
index 2489f619..ec4e4884 100644
--- a/.pi/docs/INTEGRATIONS.md
+++ b/.pi/docs/INTEGRATIONS.md
@@ -126,7 +126,8 @@ this:
 
 - writes the hook script to `~/.codex/herdr-agent-state.sh`
 - updates `~/.codex/hooks.json`
-- ensures `codex_hooks = true` in `~/.codex/config.toml`
+- ensures `hooks = true` under `[features]` in `~/.codex/config.toml`
+- migrates the deprecated top-level `[features] codex_hooks = true` setting to `hooks = true`
 
 bundled source: [`src/integration/assets/codex/herdr-agent-state.sh`](./src/integration/assets/codex/herdr-agent-state.sh)
 
@@ -156,7 +157,7 @@ this:
 - removes herdr-owned hook entries from `~/.codex/hooks.json`
 - intentionally leaves `~/.codex/config.toml` alone
 
-that last point is deliberate: herdr does **not** try to guess whether `codex_hooks = true` is still needed for some other codex hook setup.
+that last point is deliberate: herdr does **not** try to guess whether `hooks = true` is still needed for some other codex hook setup.
 
 ## opencode
 
diff --git a/.pi/docs/README.md b/.pi/docs/README.md
index 05346b81..1b5ed7fa 100644
--- a/.pi/docs/README.md
+++ b/.pi/docs/README.md
@@ -131,7 +131,7 @@ not a gui window, not a web dashboard, not electron. herdr runs inside whatever
 - **tabs** — first-class in the socket api and cli
 - **mouse-native** — click panes/tabs/workspaces/agents, drag borders, select text to copy, right-click menus; not keyboard-only
 - **notifications** — sounds and toasts for background events; tab-aware suppression
-- **10 built-in themes** — catppuccin (default), tokyo night, dracula, nord, gruvbox, one dark, solarized, kanagawa, rosé pine, vesper
+- **17 built-in themes** — catppuccin, tokyo night, gruvbox, one, solarized, kanagawa, rosé pine, vesper, and light variants for the main palettes
 - **session persistence** — pane processes survive client detach; sessions restore after full restart
 
 ## agents can use herdr too