railmux 0.3.2.dev2__tar.gz → 0.3.2.dev5__tar.gz

{railmux-0.3.2.dev2/src/railmux.egg-info → railmux-0.3.2.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: railmux
-Version: 0.3.2.dev2
+Version: 0.3.2.dev5
 Summary: Terminal UI to navigate, resume, and start Claude Code and Codex sessions
 Author-email: Rightglow <zhang.taian@foxmail.com>
 License-Expression: MIT

railmux-0.3.2.dev5/src/railmux/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.2.dev5"

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/diagnostics.py

@@ -151,6 +151,8 @@ def _tool_diagnostic(
             env=environ,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=3,
             check=False,
         )
@@ -300,6 +302,8 @@ def collect_doctor_snapshot(
                 env=effective_env,
                 capture_output=True,
                 text=True,
+                encoding="utf-8",
+                errors="replace",
                 timeout=2,
                 check=False,
             )

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/discovery.py

@@ -43,9 +43,9 @@ def _path_cache_file() -> Path:
 
 def _load_path_cache() -> dict[str, str]:
     try:
-        data = json.loads(_path_cache_file().read_text())
+        data = json.loads(_path_cache_file().read_text(encoding="utf-8"))
         return data if isinstance(data, dict) else {}
-    except (OSError, json.JSONDecodeError):
+    except (OSError, UnicodeError, json.JSONDecodeError):
         return {}
 
 

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/fast_display_client.py

@@ -45,6 +45,7 @@ from railmux.fast_display_input import (
     SelectionSegment,
     SgrMouseEvent,
     TermuxTouchKeyboard,
+    TouchKeyboardAction,
     TerminalInputDecoder,
     is_termux_environment,
     page_key_direction,
@@ -223,6 +224,33 @@ def compact_status_row(screen: AppliedScreen) -> int | None:
     return None
 
 
+def termux_prompt_touch_action(
+    touch_keyboard: TermuxTouchKeyboard,
+    event: SgrMouseEvent,
+    history: LocalHistoryView,
+    screen: AppliedScreen | None,
+    *,
+    now: float | None = None,
+) -> TouchKeyboardAction:
+    """Classify one translated Termux tap against live screen route authority."""
+    if screen is None:
+        return TouchKeyboardAction()
+    clicked_pane_id = history.pane_id_at_position(event.x - 1, event.y - 1)
+    cursor_pane_id = history.pane_id_at_position(
+        screen.cursor_x,
+        screen.cursor_y,
+    )
+    return touch_keyboard.pointer_event(
+        event,
+        clicked_pane_id=clicked_pane_id,
+        cursor_pane_id=cursor_pane_id,
+        cursor_y=screen.cursor_y,
+        pane_frozen=history.pane_is_frozen(clicked_pane_id),
+        navigation_row=compact_status_row(screen),
+        now=now,
+    )
+
+
 class ProbeError(RuntimeError):
     """A bounded, user-facing SSH display failure."""
 
@@ -2723,34 +2751,16 @@ def run(args: argparse.Namespace) -> int:
                     latest_screen.cursor_x, latest_screen.cursor_y
                 )
             )
-            clicked_pane_id = (
-                None
-                if latest_screen is None
-                else history.pane_id_at_position(part.x - 1, part.y - 1)
-            )
-            cursor_pane_id = (
-                None
-                if latest_screen is None
-                else history.pane_id_at_position(
-                    latest_screen.cursor_x,
-                    latest_screen.cursor_y,
-                )
-            )
             status_row = (
                 compact_status_row(latest_screen)
                 if latest_screen is not None
                 else None
             )
-            touch_action = touch_keyboard.pointer_event(
+            touch_action = termux_prompt_touch_action(
+                touch_keyboard,
                 part,
-                clicked_pane_id=clicked_pane_id,
-                cursor_pane_id=cursor_pane_id,
-                cursor_y=0 if latest_screen is None else latest_screen.cursor_y,
-                cursor_visible=(
-                    False if latest_screen is None else latest_screen.cursor_visible
-                ),
-                pane_frozen=history.pane_is_frozen(clicked_pane_id),
-                navigation_row=status_row,
+                history,
+                latest_screen,
                 now=time.monotonic(),
             )
             if touch_action.suspend_mouse:

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/fast_display_input.py

@@ -129,7 +129,6 @@ class TermuxTouchKeyboard:
         clicked_pane_id: str | None,
         cursor_pane_id: str | None,
         cursor_y: int,
-        cursor_visible: bool,
         pane_frozen: bool,
         navigation_row: int | None = None,
         now: float | None = None,
@@ -150,7 +149,6 @@ class TermuxTouchKeyboard:
             or self._active
             or self._close_reassert_pending
             or pane_frozen
-            or not cursor_visible
             or clicked_pane_id is None
             or clicked_pane_id != cursor_pane_id
             or (navigation_row is not None and event.y == navigation_row)
@@ -158,6 +156,11 @@ class TermuxTouchKeyboard:
             or not self._is_plain_left_press(event)
         ):
             return TouchKeyboardAction()
+        # DEC cursor visibility is presentation state, not prompt authority.
+        # Providers may hide the hardware cursor while retaining its exact
+        # input coordinates. The verified live-agent route, matching cursor
+        # route, unfrozen viewport, and bounded row distance remain the
+        # fail-closed authority for yielding one Termux tap.
         requested_at = time.monotonic() if now is None else now
         # A rapid reopen supersedes the delayed ownership reassertion queued by
         # the previous close; Termux must receive this new native prompt tap.

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/favorites.py

@@ -29,10 +29,10 @@ class Favorites:
         if not self._path.is_file():
             return
         try:
-            data = json.loads(self._path.read_text())
+            data = json.loads(self._path.read_text(encoding="utf-8"))
             if isinstance(data, list):
                 self._ids = set(data)
-        except (json.JSONDecodeError, OSError):
+        except (json.JSONDecodeError, OSError, UnicodeError):
             self._ids = set()
 
     def _save(self) -> None:

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/legacy_sessions.py

@@ -59,6 +59,8 @@ def discover(
             tmux_server.target_argv(target, "list-sessions", "-F", fmt),
             stderr=subprocess.DEVNULL,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=timeout,
             env=None if env is None else dict(env),
         )

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/mux/tmux_backend.py

@@ -79,6 +79,8 @@ class TmuxBackend:
                 stdout=subprocess.PIPE,
                 stderr=subprocess.DEVNULL,
                 text=True,
+                encoding="utf-8",
+                errors="replace",
             )
         except OSError:
             return None

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/renames.py

@@ -32,8 +32,8 @@ class Renames:
         if not self._path.is_file():
             return
         try:
-            data = json.loads(self._path.read_text())
-        except (json.JSONDecodeError, OSError):
+            data = json.loads(self._path.read_text(encoding="utf-8"))
+        except (json.JSONDecodeError, OSError, UnicodeError):
             return
         if isinstance(data, dict):
             self._titles = {

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/runtime_config.py

@@ -125,6 +125,8 @@ def check_executable(
             env=None if environ is None else dict(environ),
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=timeout,
             check=False,
         )
@@ -168,6 +170,8 @@ def check_utf8_locale(
             env=env,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=timeout,
             check=False,
         )

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/self_update.py

@@ -88,6 +88,8 @@ def fresh_process_version(*, timeout: float = 10.0) -> str | None:
             ],
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=timeout,
             check=False,
         )

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/session_index.py

@@ -92,7 +92,7 @@ def _scan_session(project: Project, jsonl_path: Path) -> SessionMeta | None:
     last_stop_reason: str = ""  # only set for assistant records
 
     try:
-        with jsonl_path.open("r") as f:
+        with jsonl_path.open("r", encoding="utf-8", errors="replace") as f:
             for line in f:
                 line = line.strip()
                 if not line:

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/settings.py

@@ -110,7 +110,7 @@ class Settings:
 
     def _read_document(self):
         try:
-            text = self._path.read_text()
+            text = self._path.read_text(encoding="utf-8")
         except FileNotFoundError:
             return tomlkit.document()
         except (OSError, UnicodeError):

{railmux-0.3.2.dev2 → railmux-0.3.2.dev5}/src/railmux/tmux_binding_manager.py

@@ -14,7 +14,7 @@ from railmux.atomic_file import atomic_write_text
 from railmux.platform.filelock import try_lock, unlock
 
 
-_VERSION = 7
+_VERSION = 8
 _KEYS = ("F8", "F9")
 _MAX_STATE_BYTES = 64 * 1024
 
@@ -34,6 +34,7 @@ class SharedTmuxBindingManager:
         self._prefix_tab_managed = False
         self._right_click_managed = False
         self._status_click_managed = False
+        self._termux_tap_managed = False
         self._selection_hook_managed = False
         self._selection_hook_index: int | None = None
 
@@ -52,6 +53,11 @@ class SharedTmuxBindingManager:
         """Whether pane ranges in this instance's status bar are clickable."""
         return self._registered and self._status_click_managed
 
+    @property
+    def termux_tap_available(self) -> bool:
+        """Whether direct local Termux prompt taps are safely wrapped."""
+        return self._registered and self._termux_tap_managed
+
     @contextmanager
     def _locked(self) -> Iterator[None]:
         root = restart_state.runtime_state_dir()
@@ -84,7 +90,7 @@ class SharedTmuxBindingManager:
         except (OSError, ValueError, json.JSONDecodeError):
             return None
         if (not isinstance(raw, dict)
-                or raw.get("version") not in {1, 2, 3, 4, 5, 6, _VERSION}):
+                or raw.get("version") not in {1, 2, 3, 4, 5, 6, 7, _VERSION}):
             return None
         token = raw.get("token")
         phase = raw.get("phase")
@@ -96,6 +102,8 @@ class SharedTmuxBindingManager:
         right_click_managed = raw.get("right_click_managed")
         status_click_backup = raw.get("status_click_backup")
         status_click_managed = raw.get("status_click_managed")
+        termux_tap_backup = raw.get("termux_tap_backup")
+        termux_tap_managed = raw.get("termux_tap_managed")
         selection_hook_managed = raw.get("selection_hook_managed")
         selection_hook_index = raw.get("selection_hook_index")
         prefix_valid = (
@@ -116,6 +124,12 @@ class SharedTmuxBindingManager:
             and all(value is None or isinstance(value, str)
                     for value in status_click_backup.values())
         )
+        termux_tap_valid = (
+            isinstance(termux_tap_backup, dict)
+            and set(termux_tap_backup) == {"MouseDown1Pane"}
+            and all(value is None or isinstance(value, str)
+                    for value in termux_tap_backup.values())
+        )
         if (not isinstance(token, str) or not token or len(token) > 64
                 or phase not in {"installing", "active"}
                 or not isinstance(owners, dict) or len(owners) > 1024
@@ -140,7 +154,10 @@ class SharedTmuxBindingManager:
                              and selection_hook_index is not None)))
                 or (raw["version"] >= 5
                     and (not status_click_valid
-                         or not isinstance(status_click_managed, bool)))):
+                         or not isinstance(status_click_managed, bool)))
+                or (raw["version"] >= 8
+                    and (not termux_tap_valid
+                         or not isinstance(termux_tap_managed, bool)))):
             return None
         return raw
 
@@ -265,6 +282,21 @@ class SharedTmuxBindingManager:
                         # v7 replaces Mode/Layout's ordinary m/F8 keystrokes
                         # with edit- and modal-safe internal function keys.
                         upgraded = True
+                    if state["version"] < 8:
+                        termux_tap_backup = (
+                            tmux_ctl.prepare_root_termux_tap_binding()
+                        )
+                        # v8 adds a stock-left-click-only Termux prompt
+                        # handoff. Persist its exact original before the
+                        # server-global root-table binding is replaced.
+                        state["termux_tap_managed"] = (
+                            termux_tap_backup is not None
+                        )
+                        state["termux_tap_backup"] = (
+                            termux_tap_backup
+                            or {"MouseDown1Pane": None}
+                        )
+                        upgraded = True
                     if upgraded:
                         state["version"] = _VERSION
                         state["phase"] = "installing"
@@ -325,6 +357,21 @@ class SharedTmuxBindingManager:
                                     token,
                                 )
                             )
+                        if state["termux_tap_managed"]:
+                            current_tap = (
+                                tmux_ctl.read_root_termux_tap_binding()
+                                ["MouseDown1Pane"]
+                            )
+                            safe = (
+                                safe
+                                and tmux_ctl.root_termux_tap_binding_is_original_or_owned(
+                                    current_tap,
+                                    state["termux_tap_backup"].get(
+                                        "MouseDown1Pane"
+                                    ),
+                                    token,
+                                )
+                            )
                         if not safe:
                             if state["owners"]:
                                 return False
@@ -342,6 +389,9 @@ class SharedTmuxBindingManager:
                             if state["status_click_managed"]:
                                 tmux_ctl.restore_root_status_click_binding(
                                     state["status_click_backup"], token=token)
+                            if state["termux_tap_managed"]:
+                                tmux_ctl.restore_root_termux_tap_binding(
+                                    state["termux_tap_backup"], token=token)
                             self._remove_state()
                             state = None
                         else:
@@ -381,6 +431,14 @@ class SharedTmuxBindingManager:
                                 state["status_click_managed"] = False
                                 if not self._save(state):
                                     return False
+                            if (state["termux_tap_managed"]
+                                    and not tmux_ctl.set_root_termux_tap_forwarding(
+                                        state["termux_tap_backup"], token)):
+                                tmux_ctl.restore_root_termux_tap_binding(
+                                    state["termux_tap_backup"], token=token)
+                                state["termux_tap_managed"] = False
+                                if not self._save(state):
+                                    return False
                             state["phase"] = "active"
                     elif not (
                         tmux_ctl.root_function_bindings_owned_by(token)
@@ -402,6 +460,10 @@ class SharedTmuxBindingManager:
                             or tmux_ctl.root_status_click_binding_owned_by(
                                 token)
                         )
+                        and (
+                            not state["termux_tap_managed"]
+                            or tmux_ctl.root_termux_tap_binding_owned_by(token)
+                        )
                     ):
                         if state["owners"]:
                             return False
@@ -419,6 +481,9 @@ class SharedTmuxBindingManager:
                         if state["status_click_managed"]:
                             tmux_ctl.restore_root_status_click_binding(
                                 state["status_click_backup"], token=token)
+                        if state["termux_tap_managed"]:
+                            tmux_ctl.restore_root_termux_tap_binding(
+                                state["termux_tap_backup"], token=token)
                         self._remove_state()
                         state = None
                     if state is not None:
@@ -451,6 +516,8 @@ class SharedTmuxBindingManager:
                             state["selection_hook_index"])
                         self._status_click_managed = (
                             state["status_click_managed"])
+                        self._termux_tap_managed = (
+                            state["termux_tap_managed"])
                         return True
 
                 backup = tmux_ctl.prepare_root_function_bindings()
@@ -460,6 +527,8 @@ class SharedTmuxBindingManager:
                 selection_hook_index = tmux_ctl.prepare_selection_mode_hook()
                 status_click_backup = (
                     tmux_ctl.prepare_root_status_click_binding())
+                termux_tap_backup = (
+                    tmux_ctl.prepare_root_termux_tap_binding())
                 if backup is None:
                     return False
                 token = secrets.token_hex(8)
@@ -479,6 +548,9 @@ class SharedTmuxBindingManager:
                     "status_click_managed": status_click_backup is not None,
                     "status_click_backup": (
                         status_click_backup or {"MouseDown1Status": None}),
+                    "termux_tap_managed": termux_tap_backup is not None,
+                    "termux_tap_backup": (
+                        termux_tap_backup or {"MouseDown1Pane": None}),
                 }
                 if not self._save(state):
                     return False
@@ -550,6 +622,29 @@ class SharedTmuxBindingManager:
                                 state["selection_hook_index"], token)
                         self._remove_state()
                         return False
+                if (state["termux_tap_managed"]
+                        and not tmux_ctl.set_root_termux_tap_forwarding(
+                            state["termux_tap_backup"], token)):
+                    tmux_ctl.restore_root_termux_tap_binding(
+                        state["termux_tap_backup"], token=token)
+                    state["termux_tap_managed"] = False
+                    if not self._save(state):
+                        tmux_ctl.restore_root_function_bindings(
+                            backup, token=token)
+                        if state["prefix_tab_managed"]:
+                            tmux_ctl.restore_prefix_target_binding(
+                                state["prefix_tab_backup"], token=token)
+                        if state["right_click_managed"]:
+                            tmux_ctl.restore_root_right_click_binding(
+                                state["right_click_backup"], token=token)
+                        if state["selection_hook_managed"]:
+                            tmux_ctl.restore_selection_mode_hook(
+                                state["selection_hook_index"], token)
+                        if state["status_click_managed"]:
+                            tmux_ctl.restore_root_status_click_binding(
+                                state["status_click_backup"], token=token)
+                        self._remove_state()
+                        return False
                 state["phase"] = "active"
                 if not self._save(state) or not self._set_controller():
                     tmux_ctl.restore_root_function_bindings(
@@ -566,6 +661,9 @@ class SharedTmuxBindingManager:
                     if state["status_click_managed"]:
                         tmux_ctl.restore_root_status_click_binding(
                             state["status_click_backup"], token=token)
+                    if state["termux_tap_managed"]:
+                        tmux_ctl.restore_root_termux_tap_binding(
+                            state["termux_tap_backup"], token=token)
                     self._remove_state()
                     return False
                 self._registered = True
@@ -574,6 +672,7 @@ class SharedTmuxBindingManager:
                 self._selection_hook_managed = state["selection_hook_managed"]
                 self._selection_hook_index = state["selection_hook_index"]
                 self._status_click_managed = state["status_click_managed"]
+                self._termux_tap_managed = state["termux_tap_managed"]
                 return True
         except OSError:
             return False
@@ -627,6 +726,9 @@ class SharedTmuxBindingManager:
                     if state["status_click_managed"]:
                         tmux_ctl.restore_root_status_click_binding(
                             state["status_click_backup"], token=state["token"])
+                    if state["termux_tap_managed"]:
+                        tmux_ctl.restore_root_termux_tap_binding(
+                            state["termux_tap_backup"], token=state["token"])
                     self._remove_state()
             except OSError:
                 pass
@@ -641,5 +743,6 @@ class SharedTmuxBindingManager:
             self._prefix_tab_managed = False
             self._right_click_managed = False
             self._status_click_managed = False
+            self._termux_tap_managed = False
             self._selection_hook_managed = False
             self._selection_hook_index = None