docs(CHANGES): add progress spinner, structured logging, and colorama removal

tony · tony · commit d0a1b5b56c76 · 2026-03-08T14:52:14.000-05:00
why: Changelog entry for the upcoming release documenting all user-visible
changes from this branch.
what:
- Document animated progress spinner feature with presets and env vars
- Document structured logging with extra context across all modules
- Document colorama removal and print()-&gt;tmuxp_echo routing
- Document bug fixes: default log level, before_script logging, get_pane,
  OutputFormatter routing for ls/debug-info
diff --git a/CHANGES b/CHANGES
@@ -35,6 +35,42 @@ $ pipx install --suffix=@next 'tmuxp' --pip-args '\--pre' --force
 _Notes on the upcoming release will go here._
 <!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
 
+### What's new
+
+#### Animated progress spinner for `tmuxp load` (#1017)
+
+The `load` command now shows an animated spinner with real-time build progress
+as windows and panes are created. Five built-in presets control the display
+format (`default`, `minimal`, `window`, `pane`, `verbose`), and custom format
+strings are supported via `--progress-format` or `TMUXP_PROGRESS_FORMAT`.
+
+- `--progress-lines N` / `TMUXP_PROGRESS_LINES`: Control how many lines of
+  `before_script` output appear in the spinner panel (default: 3). Use `0` to
+  hide the panel, `-1` for unlimited (capped to terminal height).
+- `--no-progress` / `TMUXP_PROGRESS=0`: Disable the spinner entirely.
+- During `before_script` execution, the progress bar shows a marching animation
+  and ⏸ icon.
+
+### Bug fixes
+
+- Fix default CLI log level from INFO to WARNING so normal usage is not noisy (#1017)
+- Fix `before_script` failure logging from DEBUG to ERROR (#1017)
+- Fix `get_pane()` exception catch type to match sibling methods (#1017)
+- Route `ls --json` and `debug-info --json` through `OutputFormatter` for consistent machine-readable output (#1017)
+
+### Development
+
+#### Structured logging with `extra` context across all modules (#1017)
+
+All modules now use `logging.getLogger(__name__)` with structured `extra` keys
+(`tmux_session`, `tmux_window`, `tmux_pane`, `tmux_config_path`, etc.) for
+filtering and aggregation. Library `__init__.py` adds `NullHandler` per Python
+best practices. A new `TmuxpLoggerAdapter` provides persistent context for
+objects with stable identity.
+
+- Remove `colorama` runtime and type-stub dependencies; replace with stdlib ANSI constants (#1017)
+- Route all raw `print()` calls through `tmuxp_echo()` for consistent output channels (#1017)
+
 ## tmuxp 1.65.0 (2026-03-08)
 
 ### Breaking Changes
