docs(control-mode): Note env requirements and capture normalization in CHANGES

Author: tony

CHANGES

@@ -32,7 +32,47 @@ $ uvx --from 'libtmux' --prerelease allow python
 
 <!-- To maintainers and contributors: Please add notes for the forthcoming version below -->
 
-- _Future release notes will be placed here_
+_Future release notes will be placed here_
+
+### Features
+
+- Control-mode–first engine protocol (experimental): adds structured command results,
+  notification parsing (layout changes, unlinked windows, client detach/session change,
+  session rename, paste-buffer events), and stats while keeping existing
+  `Server/Session/Window/Pane.cmd` return type (`tmux_cmd`) stable. (#605)
+- Control mode engine's internal connection session is now automatically filtered from
+  `Server.sessions` and `Server.has_session()`, making engine choice transparent to
+  users. Advanced users can access all sessions via `Server._sessions_all()`. (#605)
+- `ControlModeEngine` accepts optional `internal_session_name` and `attach_to`
+  parameters for advanced session management scenarios. (#605)
+- `Server.connect()`: New convenience method for session management. Returns an
+  existing session if found, otherwise creates a new detached session. Simplifies
+  common session reuse patterns and works transparently with both subprocess and
+  control-mode engines.
+- Control-mode diagnostics: bounded notification queue with drop counting,
+  richer exceptions (`ControlModeTimeout`, `ControlModeProtocolError`,
+  `ControlModeConnectionError`, `SubprocessTimeout`), and documented retry/timeout
+  behaviour. Control sandbox pytest fixture provides a hermetic control-mode server
+  for integration tests.
+
+### Compatibility
+
+- Control mode's internal session is now automatically filtered from user-facing APIs.
+  Code that previously filtered `libtmux_control_mode` manually can be simplified.
+  APIs remain unchanged for tmux command return objects; new metadata is attached for
+  advanced users. (#605)
+- `-e KEY=VAL` environment propagation for `new-session`, `new-window`, and
+  `split-window` requires tmux 3.2 or newer. Older tmux versions ignore `-e`; libtmux
+  logs a warning and skips env-specific tests in that configuration.
+- Control-mode `capture-pane` trims trailing whitespace-only lines to align with
+  subprocess behaviour; explicit range flags (`-S/-E`) remain exact.
+
+### Testing
+
+- `uv run ruff check . --fix --show-fixes`
+- `uv run ruff format .`
+- `uv run mypy`
+- `uv run py.test`
 
 ## libtmux 0.47.0 (2025-11-01)