libtmux 0.61.0

[tony]

Summary

• Bump libtmux ~=0.60.0 → ~=0.61.0 — one upstream release, no breaking changes, tmux 3.2a-3.6 unaffected.
• Improve tmuxp debug-info: report the exact tmux patch release (3.7a/3.7b) instead of the numeric-normalized 3.7, adopting libtmux 0.61.0's get_version_str().
• Inherit libtmux's Pane.break_pane() fix on tmux 3.7a/3.7b — tmuxp never calls break_pane, so this is behavior-only with no code change.

Upstream changes

libtmux 0.61.0 (2026-07-04)

Hardens support for the tmux 3.7 patch line.

• Fix: Pane.break_pane() keeps tmux's own default window name on tmux 3.7a/3.7b instead of forcing libtmux (Fix break_pane forcing 'libtmux' window name on tmux 3.7a/3.7b libtmux#699).
• New API: get_version_str() returns the raw tmux version with its point-release suffix intact ("3.7a"), where get_version() strips it for numeric comparison (Fix break_pane forcing 'libtmux' window name on tmux 3.7a/3.7b libtmux#699).
• Development: libtmux's own test suite now passes against tmux 3.7a and 3.7b (Fix window-name test for tmux 3.7a/3.7b and add them to CI libtmux#698).

Release: https://github.com/tmux-python/libtmux/releases/tag/v0.61.0
Changelog: https://libtmux.git-pull.com/history.html#libtmux-0-61-0-2026-07-04

Changes by area

• pyproject.toml / uv.lock: bump the libtmux specifier and re-lock.
• src/tmuxp/cli/debug_info.py: tmux_version now reads get_version_str() instead of str(get_version()), preserving the patch letter.
• tests/cli/test_debug_info.py: add test_debug_info_reports_raw_tmux_version, which monkeypatches the helper to a known 3.7a and asserts the raw string reaches the JSON output verbatim.
• CHANGES: 1.74.0 entry under ### Dependencies (minimum bump) and ### What's new (debug-info patch release).

Design decisions

• get_version_str() for reporting, get_version() for comparison. debug-info exists for bug reports, where the faithful patch release matters. plugin.py deliberately keeps get_version() because it feeds LooseVersion constraint checks — a LooseVersion("3.7b") would compare the letter and break version-gate ordering. libtmux 0.61.0 splits these two functions for exactly this reason, and this PR follows that split rather than migrating both call sites.

Before / After

On a tmux 3.7b host, debug-info previously normalized the version.

Before:

$ tmuxp debug-info --json | jq .tmux_version
"3.7"

After:

$ tmuxp debug-info --json | jq .tmux_version
"3.7b"

Verification

debug-info no longer normalizes the version (expect zero matches):

$ rg 'get_version\(\)' src/tmuxp/cli/debug_info.py

plugin.py intentionally keeps numeric comparison (expect a match):

$ rg 'get_version\(\)' src/tmuxp/plugin.py

Test plan

• uv run py.test — full suite and doctests pass, including test_debug_info_reports_raw_tmux_version
• uv run mypy — strict type check clean
• uv run ruff check . and uv run ruff format --check . — clean
• just build-docs — builds with no new warnings

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.56%. Comparing base (bca5998) to head (7f6f76d).

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #1074   +/-   ##
=======================================
  Coverage   82.56%   82.56%           
=======================================
  Files          31       31           
  Lines        2770     2770           
  Branches      518      518           
=======================================
  Hits         2287     2287           
  Misses        346      346           
  Partials      137      137           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.