Merge branch 'tool-windows'

Add tool windows: tool registry, styled aux tmux windows
(TmuxRunner.new_aux_window / TmuxManager.open_aux_window),
SessionService tool-window + clone-for-window methods, and
hqt tool / hqt palette CLI subcommands (fzf tool launcher).

# Conflicts:
#	src/hqt/cli.py
#	src/hqt/tmux/manager.py
#	tests/test_cli.py
#	tests/test_sessions.py

tests/test_tmux.py

@@ -1208,3 +1208,90 @@ async def test_poll_info_empty_names(runner):
     result = await mgr.poll_info([])
     assert result == {}
     assert runner._exec.call_count == 1
+
+
+# ---------------------------------------------------------------------------
+# Task 2: new_aux_window — styled tool windows (never tracked)
+# ---------------------------------------------------------------------------
+
+
+@pytest.mark.asyncio
+async def test_new_aux_window_spawns_styles_and_selects(runner):
+    runner._exec.side_effect = [
+        (0, "0\n", ""),   # _next_window_index: indices [0] -> next index 1
+        (0, "@7\n", ""),  # new-window -P -F '#{window_id}'
+        (0, "", ""),      # set-option (automatic-rename + allow-rename + @hqt_label + theme)
+        (0, "", ""),      # select-window
+    ]
+    wid = await runner.new_aux_window("lazygit", "/proj", ["lazygit"], "lazygit · proj")
+    assert wid == "@7"
+
+    calls = runner._exec.call_args_list
+    # new-window: next free index, name, cwd, print window_id, then the command.
+    assert calls[1].args == (
+        "new-window", "-t", "hqt-main:1", "-n", "lazygit",
+        "-c", "/proj", "-P", "-F", "#{window_id}", "lazygit",
+    )
+    # post-creation options target the window_id and NEVER set remain-on-exit.
+    assert calls[2].args[:6] == (
+        "set-option", "-w", "-t", "@7", "automatic-rename", "off",
+    )
+    # allow-rename off too, so nvim/lazygit OSC titles can't scramble the label.
+    assert "allow-rename" in calls[2].args
+    assert "@hqt_label" in calls[2].args
+    assert "lazygit · proj" in calls[2].args
+    assert "remain-on-exit" not in calls[2].args
+    # switch to it.
+    assert calls[3].args == ("select-window", "-t", "@7")
+
+
+@pytest.mark.asyncio
+async def test_new_aux_window_shell_omits_command_arg(runner):
+    runner._exec.side_effect = [
+        (0, "2\n", ""),   # indices [2] -> next index 3
+        (0, "@9\n", ""),
+        (0, "", ""),
+        (0, "", ""),
+    ]
+    wid = await runner.new_aux_window("shell", "/proj", [], "shell · proj")
+    assert wid == "@9"
+    calls = runner._exec.call_args_list
+    assert calls[1].args == (
+        "new-window", "-t", "hqt-main:3", "-n", "shell",
+        "-c", "/proj", "-P", "-F", "#{window_id}",
+    )
+
+
+@pytest.mark.asyncio
+async def test_new_aux_window_returns_none_when_new_window_fails(runner):
+    runner._exec.side_effect = [
+        (0, "0\n", ""),    # next index
+        (1, "", "boom"),   # new-window fails
+    ]
+    wid = await runner.new_aux_window("nvim", "/p", ["nvim"], "nvim · p")
+    assert wid is None
+
+
+@pytest.mark.asyncio
+async def test_new_aux_window_kills_window_when_set_option_fails(runner):
+    runner._exec.side_effect = [
+        (0, "0\n", ""),    # _next_window_index
+        (0, "@7\n", ""),   # new-window -> window_id @7
+        (1, "", "nope"),   # set-option fails
+        (0, "", ""),       # kill-window cleanup
+    ]
+    wid = await runner.new_aux_window("nvim", "/p", ["nvim"], "nvim · p")
+    assert wid is None
+    # the half-built window must be cleaned up by id.
+    assert runner._exec.call_args_list[-1].args == ("kill-window", "-t", "@7")
+
+
+@pytest.mark.asyncio
+async def test_manager_open_aux_window_delegates(runner):
+    from unittest.mock import AsyncMock
+
+    runner.new_aux_window = AsyncMock(return_value="@4")
+    mgr = TmuxManager(runner)
+    wid = await mgr.open_aux_window("nvim", "/p", ["nvim"], "nvim · p")
+    assert wid == "@4"
+    runner.new_aux_window.assert_awaited_once_with("nvim", "/p", ["nvim"], "nvim · p")