python-voiceio 0.4.0__tar.gz → 0.4.1__tar.gz

{python_voiceio-0.4.0/python_voiceio.egg-info → python_voiceio-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 0.4.0
+Version: 0.4.1
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -40,6 +40,10 @@ Requires-Dist: edge-tts>=6.1.0; extra == "tts-cloud"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
+Provides-Extra: linux
+Requires-Dist: pystray>=0.19; extra == "linux"
+Requires-Dist: Pillow>=10.0; extra == "linux"
+Requires-Dist: piper-tts>=1.2.0; extra == "linux"
 Dynamic: license-file
 
 # voiceio
@@ -74,8 +78,9 @@ Open-source, sovereign voice input/output. Your speech is transcribed on your ow
 ## Quick start
 
 ```bash
-# 1. Install system dependencies (Ubuntu/Debian)
-sudo apt install pipx ibus gir1.2-ibus-1.0 python3-gi python3-dev portaudio19-dev
+# 1. Install system dependencies (Ubuntu/Debian). build-essential + python3-dev
+#    are needed to compile evdev (no prebuilt wheel); portaudio for the mic.
+sudo apt install pipx build-essential python3-dev portaudio19-dev ibus gir1.2-ibus-1.0 python3-gi
 
 # 2. Install voiceio
 pipx install python-voiceio
@@ -86,11 +91,14 @@ voiceio setup
 
 That's it. Press **Ctrl+Alt+V** (or your chosen hotkey) to start dictating.
 
+**Installing with an AI agent?** Point it at [INSTALL.md](INSTALL.md) — a terse,
+copy-pasteable runbook (`voiceio setup --defaults` / `--answers '{json}'`, no TTY needed).
+
 <details>
 <summary><strong>Fedora</strong></summary>
 
 ```bash
-sudo dnf install pipx ibus python3-gobject python3-devel portaudio-devel
+sudo dnf install pipx gcc gcc-c++ make python3-devel portaudio-devel ibus ibus-libs python3-gobject
 pipx install python-voiceio
 voiceio setup
 ```
@@ -100,8 +108,8 @@ voiceio setup
 <summary><strong>Arch Linux</strong></summary>
 
 ```bash
-sudo pacman -S python-pipx ibus python-gobject portaudio
-# Note: Arch includes Python headers by default with the python package
+sudo pacman -S python-pipx base-devel portaudio ibus python-gobject
+# base-devel provides gcc/make; the python package ships headers.
 pipx install python-voiceio
 voiceio setup
 ```

{python_voiceio-0.4.0 → python_voiceio-0.4.1}/README.md

@@ -30,8 +30,9 @@ Open-source, sovereign voice input/output. Your speech is transcribed on your ow
 ## Quick start
 
 ```bash
-# 1. Install system dependencies (Ubuntu/Debian)
-sudo apt install pipx ibus gir1.2-ibus-1.0 python3-gi python3-dev portaudio19-dev
+# 1. Install system dependencies (Ubuntu/Debian). build-essential + python3-dev
+#    are needed to compile evdev (no prebuilt wheel); portaudio for the mic.
+sudo apt install pipx build-essential python3-dev portaudio19-dev ibus gir1.2-ibus-1.0 python3-gi
 
 # 2. Install voiceio
 pipx install python-voiceio
@@ -42,11 +43,14 @@ voiceio setup
 
 That's it. Press **Ctrl+Alt+V** (or your chosen hotkey) to start dictating.
 
+**Installing with an AI agent?** Point it at [INSTALL.md](INSTALL.md) — a terse,
+copy-pasteable runbook (`voiceio setup --defaults` / `--answers '{json}'`, no TTY needed).
+
 <details>
 <summary><strong>Fedora</strong></summary>
 
 ```bash
-sudo dnf install pipx ibus python3-gobject python3-devel portaudio-devel
+sudo dnf install pipx gcc gcc-c++ make python3-devel portaudio-devel ibus ibus-libs python3-gobject
 pipx install python-voiceio
 voiceio setup
 ```
@@ -56,8 +60,8 @@ voiceio setup
 <summary><strong>Arch Linux</strong></summary>
 
 ```bash
-sudo pacman -S python-pipx ibus python-gobject portaudio
-# Note: Arch includes Python headers by default with the python package
+sudo pacman -S python-pipx base-devel portaudio ibus python-gobject
+# base-devel provides gcc/make; the python package ships headers.
 pipx install python-voiceio
 voiceio setup
 ```

{python_voiceio-0.4.0 → python_voiceio-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-voiceio"
-version = "0.4.0"
+version = "0.4.1"
 description = "Voice dictation for Linux. Speak → text, locally, instantly."
 readme = "README.md"
 license = "MIT"
@@ -37,6 +37,10 @@ tray = ["pystray>=0.19", "Pillow>=10.0"]
 tts = ["piper-tts>=1.2.0"]
 tts-cloud = ["edge-tts>=6.1.0"]
 dev = ["pytest>=7.0", "pytest-mock"]
+# Convenience bundle for a full Linux install (tray icon + local TTS). The core
+# Linux deps (evdev, sounddevice) are already unconditional; system packages
+# (IBus, PortAudio, a C toolchain) are installed separately — see README.
+linux = ["pystray>=0.19", "Pillow>=10.0", "piper-tts>=1.2.0"]
 
 [project.urls]
 Homepage = "https://github.com/Hugo0/voiceio"

{python_voiceio-0.4.0 → python_voiceio-0.4.1/python_voiceio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 0.4.0
+Version: 0.4.1
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -40,6 +40,10 @@ Requires-Dist: edge-tts>=6.1.0; extra == "tts-cloud"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
+Provides-Extra: linux
+Requires-Dist: pystray>=0.19; extra == "linux"
+Requires-Dist: Pillow>=10.0; extra == "linux"
+Requires-Dist: piper-tts>=1.2.0; extra == "linux"
 Dynamic: license-file
 
 # voiceio
@@ -74,8 +78,9 @@ Open-source, sovereign voice input/output. Your speech is transcribed on your ow
 ## Quick start
 
 ```bash
-# 1. Install system dependencies (Ubuntu/Debian)
-sudo apt install pipx ibus gir1.2-ibus-1.0 python3-gi python3-dev portaudio19-dev
+# 1. Install system dependencies (Ubuntu/Debian). build-essential + python3-dev
+#    are needed to compile evdev (no prebuilt wheel); portaudio for the mic.
+sudo apt install pipx build-essential python3-dev portaudio19-dev ibus gir1.2-ibus-1.0 python3-gi
 
 # 2. Install voiceio
 pipx install python-voiceio
@@ -86,11 +91,14 @@ voiceio setup
 
 That's it. Press **Ctrl+Alt+V** (or your chosen hotkey) to start dictating.
 
+**Installing with an AI agent?** Point it at [INSTALL.md](INSTALL.md) — a terse,
+copy-pasteable runbook (`voiceio setup --defaults` / `--answers '{json}'`, no TTY needed).
+
 <details>
 <summary><strong>Fedora</strong></summary>
 
 ```bash
-sudo dnf install pipx ibus python3-gobject python3-devel portaudio-devel
+sudo dnf install pipx gcc gcc-c++ make python3-devel portaudio-devel ibus ibus-libs python3-gobject
 pipx install python-voiceio
 voiceio setup
 ```
@@ -100,8 +108,8 @@ voiceio setup
 <summary><strong>Arch Linux</strong></summary>
 
 ```bash
-sudo pacman -S python-pipx ibus python-gobject portaudio
-# Note: Arch includes Python headers by default with the python package
+sudo pacman -S python-pipx base-devel portaudio ibus python-gobject
+# base-devel provides gcc/make; the python package ships headers.
 pipx install python-voiceio
 voiceio setup
 ```

{python_voiceio-0.4.0 → python_voiceio-0.4.1}/python_voiceio.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ tests/test_backend_probes.py
 tests/test_cli.py
 tests/test_clipboard_read.py
 tests/test_commands.py
+tests/test_concurrency_lockdown.py
 tests/test_config.py
 tests/test_correct_batch.py
 tests/test_corrections.py
@@ -24,6 +25,7 @@ tests/test_fallback.py
 tests/test_health.py
 tests/test_hints.py
 tests/test_history.py
+tests/test_ibus_pending.py
 tests/test_ibus_typer.py
 tests/test_llm.py
 tests/test_llm_api.py
@@ -36,12 +38,14 @@ tests/test_prompt.py
 tests/test_recorder_integration.py
 tests/test_retention.py
 tests/test_robustness.py
+tests/test_security_hardening.py
 tests/test_snapshots.py
 tests/test_streaming.py
 tests/test_transcriber.py
 tests/test_tts.py
 tests/test_vad.py
 tests/test_vocabulary.py
+tests/test_wizard.py
 tests/test_wordfreq.py
 voiceio/__init__.py
 voiceio/__main__.py
@@ -54,6 +58,7 @@ voiceio/cli.py
 voiceio/clipboard_read.py
 voiceio/commands.py
 voiceio/config.py
+voiceio/consent.py
 voiceio/corrections.py
 voiceio/demo.py
 voiceio/feedback.py
@@ -87,6 +92,7 @@ voiceio/hotkeys/pynput_backend.py
 voiceio/hotkeys/socket_backend.py
 voiceio/ibus/__init__.py
 voiceio/ibus/engine.py
+voiceio/ibus/pending.py
 voiceio/models/__init__.py
 voiceio/models/silero_vad.onnx
 voiceio/sounds/__init__.py

{python_voiceio-0.4.0 → python_voiceio-0.4.1}/python_voiceio.egg-info/requires.txt

@@ -16,6 +16,11 @@ win11toast>=0.36
 pytest>=7.0
 pytest-mock
 
+[linux]
+pystray>=0.19
+Pillow>=10.0
+piper-tts>=1.2.0
+
 [tray]
 pystray>=0.19
 Pillow>=10.0

python_voiceio-0.4.1/tests/test_concurrency_lockdown.py

@@ -0,0 +1,254 @@
+"""Regression tests for the concurrency lockdown + IBus good-citizenship work.
+
+Covers:
+  #1 IBus input-source is never re-forced while IDLE; mid-record switch-away
+     falls back to clipboard instead of fighting the user.
+  #2 IBus deactivation is generation-checked and restores the user's source.
+  #3 Watchdog typer/platform mutation goes through lock-guarded, IDLE-gated
+     swap helpers.
+  #8 SIGTERM runs the same shutdown path as Ctrl-C.
+"""
+from __future__ import annotations
+
+import time
+from unittest.mock import MagicMock, patch
+
+from voiceio.config import Config
+from voiceio.typers.base import TyperBackend
+
+
+def _make_app(typer_name="clipboard"):
+    """VoiceIO with mocked backends; typer.name configurable."""
+    mock_hotkey = MagicMock()
+    mock_hotkey.name = "socket"
+    mock_typer = MagicMock(spec=TyperBackend)
+    mock_typer.name = typer_name
+
+    with patch("voiceio.app.hotkey_chain.select", return_value=mock_hotkey), \
+         patch("voiceio.app.typer_chain.select", return_value=mock_typer), \
+         patch("voiceio.app.Transcriber", return_value=MagicMock()), \
+         patch("voiceio.app.plat.detect") as mock_detect:
+        mock_detect.return_value = MagicMock(
+            display_server="wayland", desktop="gnome", is_gnome=True,
+        )
+        from voiceio.app import VoiceIO
+        vio = VoiceIO(Config())
+    mock_stream = MagicMock()
+    mock_stream.active = True
+    mock_stream.closed = False
+    mock_stream.stopped = False
+    vio.recorder._stream = mock_stream
+    vio.recorder._last_callback_time = time.monotonic()
+    return vio
+
+
+# ── Fix #3: lock-guarded, IDLE-gated swaps ──────────────────────────────
+
+class TestGuardedSwaps:
+    def test_swap_typer_only_when_idle(self):
+        from voiceio.app import _State
+        vio = _make_app()
+        new = MagicMock(spec=TyperBackend)
+        new.name = "ydotool"
+
+        vio._state = _State.RECORDING
+        assert vio._swap_typer(new, "test") is False
+        assert vio._typer is not new  # not swapped mid-recording
+
+        vio._state = _State.IDLE
+        assert vio._swap_typer(new, "test") is True
+        assert vio._typer is new
+
+    def test_swap_platform_only_when_idle(self):
+        from voiceio.app import _State
+        vio = _make_app()
+        original = vio.platform
+        new_platform = MagicMock(desktop="kde")
+
+        vio._state = _State.FINALIZING
+        assert vio._swap_platform(new_platform) is False
+        assert vio.platform is original
+
+        vio._state = _State.IDLE
+        assert vio._swap_platform(new_platform) is True
+        assert vio.platform is new_platform
+
+    def test_health_upkeep_skipped_when_not_idle(self):
+        """_check_health must not run typer upkeep during a live recording."""
+        from voiceio.app import _State
+        vio = _make_app()
+        vio._state = _State.RECORDING
+        vio.transcriber.is_worker_alive.return_value = True
+        vio.recorder.stream_health = MagicMock(return_value=(True, ""))
+        vio.cfg.tray.enabled = False
+        vio._health_typer_upkeep = MagicMock()
+        vio._check_health()
+        vio._health_typer_upkeep.assert_not_called()
+
+
+# ── Fix #2: generation-checked deactivation + source restore ─────────────
+
+class TestIBusDeactivation:
+    def test_deactivate_skipped_when_superseded(self):
+        vio = _make_app(typer_name="ibus")
+        vio._generation = 6
+        with patch("voiceio.app.threading.Thread") as MockThread:
+            vio._deactivate_ibus(gen=5)  # a newer recording already started
+            MockThread.assert_not_called()
+
+    def test_deactivate_runs_when_current(self):
+        vio = _make_app(typer_name="ibus")
+        vio._generation = 6
+        with patch("voiceio.app.threading.Thread") as MockThread:
+            vio._deactivate_ibus(gen=6)
+            MockThread.assert_called_once()
+
+    def test_deactivate_noop_for_non_ibus(self):
+        vio = _make_app(typer_name="clipboard")
+        with patch("voiceio.app.threading.Thread") as MockThread:
+            vio._deactivate_ibus(gen=1)
+            MockThread.assert_not_called()
+
+    def test_restore_uses_recorded_prev_index(self):
+        vio = _make_app(typer_name="ibus")
+        vio._prev_input_source_index = 2
+        vio._voiceio_source_index = 4
+        calls = []
+        vio._set_gnome_input_source_index = lambda i: calls.append(i)
+        vio._restore_input_source()
+        assert calls == [2]  # restores the user's source, not hardcoded 0
+        assert vio._prev_input_source_index is None
+        assert vio._voiceio_source_index is None
+
+    def test_restore_defaults_to_zero_when_unknown(self):
+        vio = _make_app(typer_name="ibus")
+        vio._prev_input_source_index = None
+        calls = []
+        vio._set_gnome_input_source_index = lambda i: calls.append(i)
+        vio._restore_input_source()
+        assert calls == [0]
+
+    def test_do_stop_does_not_deactivate_synchronously(self):
+        """Fix #2: deactivation is deferred to after the final commit, not run
+        inside _do_stop (which would race the finalizer's commit)."""
+        from voiceio.app import _State
+        vio = _make_app(typer_name="ibus")
+        vio._deactivate_ibus = MagicMock()
+        vio._state = _State.RECORDING
+        vio._record_start = time.monotonic() - 2
+        # Give the recorder something to return so a finalizer is spawned.
+        vio.recorder.stop = MagicMock(return_value=None)
+        vio._session = MagicMock()
+        with patch("voiceio.app.threading.Thread"):
+            vio._do_stop()
+        # For the streaming path the finalizer owns deactivation, so _do_stop
+        # itself must not have called it.
+        vio._deactivate_ibus.assert_not_called()
+
+
+# ── Fix #1: no re-force while IDLE; mid-record fallback ──────────────────
+
+class TestIBusGoodCitizen:
+    def _idle_healthy_ibus(self):
+        from voiceio.app import _State
+        vio = _make_app(typer_name="ibus")
+        vio._state = _State.IDLE
+        vio.transcriber.is_worker_alive.return_value = True
+        vio.recorder.stream_health = MagicMock(return_value=(True, ""))
+        vio.cfg.tray.enabled = False
+        vio._health_typer_upkeep = MagicMock()
+        vio._engine_proc = MagicMock()
+        vio._engine_proc.poll.return_value = None  # alive
+        vio._ping_ibus_engine = MagicMock(return_value=True)  # responsive
+        return vio
+
+    def test_idle_never_touches_input_source(self):
+        vio = self._idle_healthy_ibus()
+        vio._set_gnome_input_source_index = MagicMock()
+        vio._switch_gnome_input_source = MagicMock()
+        vio._detect_input_source_hijack = MagicMock()
+        vio._check_health()
+        # A responsive engine while IDLE => no source re-forcing at all.
+        vio._set_gnome_input_source_index.assert_not_called()
+        vio._switch_gnome_input_source.assert_not_called()
+        vio._detect_input_source_hijack.assert_not_called()
+
+    def test_recording_watches_for_hijack(self):
+        from voiceio.app import _State
+        vio = self._idle_healthy_ibus()
+        vio._state = _State.RECORDING
+        vio._detect_input_source_hijack = MagicMock()
+        vio._check_health()
+        vio._detect_input_source_hijack.assert_called_once()
+
+    def test_hijack_falls_back_to_clipboard(self):
+        vio = _make_app(typer_name="ibus")
+        vio._voiceio_source_index = 3
+        vio._get_current_input_source_index = lambda: 0  # user switched away
+        session = MagicMock()
+        vio._session = session
+        with patch("voiceio.typers.clipboard.ClipboardTyper", return_value=MagicMock()):
+            vio._detect_input_source_hijack()
+        assert vio._ibus_session_fallback is True
+        session.set_typer.assert_called_once()
+
+    def test_hijack_is_idempotent(self):
+        vio = _make_app(typer_name="ibus")
+        vio._voiceio_source_index = 3
+        vio._get_current_input_source_index = lambda: 0
+        session = MagicMock()
+        vio._session = session
+        with patch("voiceio.typers.clipboard.ClipboardTyper", return_value=MagicMock()):
+            vio._detect_input_source_hijack()
+            session.set_typer.reset_mock()
+            vio._detect_input_source_hijack()  # already fell back
+        session.set_typer.assert_not_called()
+
+    def test_no_hijack_when_still_on_voiceio(self):
+        vio = _make_app(typer_name="ibus")
+        vio._voiceio_source_index = 3
+        vio._get_current_input_source_index = lambda: 3  # still on voiceio
+        session = MagicMock()
+        vio._session = session
+        vio._detect_input_source_hijack()
+        assert vio._ibus_session_fallback is False
+        session.set_typer.assert_not_called()
+
+
+# ── Fix #8: SIGTERM shutdown wiring ─────────────────────────────────────
+
+class TestSigterm:
+    def test_run_registers_sigterm(self, monkeypatch, tmp_path):
+        import signal as _signal
+        vio = _make_app(typer_name="clipboard")
+
+        import voiceio.config as vcfg
+        monkeypatch.setattr(vcfg, "PID_PATH", tmp_path / "pid")
+        monkeypatch.setattr(vcfg, "LOG_DIR", tmp_path / "logs")
+        monkeypatch.setattr("voiceio.pidlock.lock_pid_file", lambda fd: None)
+        # Neutralize anything that could touch the real session/system.
+        monkeypatch.setattr("voiceio.app._import_graphical_env", lambda: None)
+        monkeypatch.setattr("voiceio.app._redetect_platform", lambda: vio.platform)
+        vio._stop_ibus_engine = MagicMock()
+        vio._set_gnome_input_source_index = MagicMock()
+        vio._try_upgrade_typer = MagicMock()
+        vio.cfg.tray.enabled = False
+        vio.cfg.feedback.sound_enabled = False
+        vio._hotkey = MagicMock()
+        vio._socket = None
+        vio._tts_hotkey = None
+
+        handlers = {}
+        monkeypatch.setattr(
+            "voiceio.app.signal.signal",
+            lambda sig, handler: handlers.__setitem__(sig, handler),
+        )
+
+        vio._shutdown.set()  # make run()'s wait return immediately
+        vio.run()
+
+        assert _signal.SIGTERM in handlers
+        # Invoking the handler must trigger the shared shutdown path.
+        vio._shutdown.clear()
+        handlers[_signal.SIGTERM]()
+        assert vio._shutdown.is_set()

python_voiceio-0.4.1/tests/test_ibus_pending.py

@@ -0,0 +1,38 @@
+"""Tests for the IBus engine's pre-ready command buffer (fix #7).
+
+The buffer must never replay commands that went stale before the engine
+instance existed, and must be cleared outright when a fresh engine is created.
+"""
+from __future__ import annotations
+
+from voiceio.ibus.pending import PendingBuffer
+
+
+def test_fresh_commands_are_replayed_in_order():
+    buf = PendingBuffer(max_age=3.0)
+    buf.add("preedit:a", now=100.0)
+    buf.add("commit:b", now=100.5)
+    assert buf.drain_fresh(now=101.0) == ["preedit:a", "commit:b"]
+    assert len(buf) == 0  # draining empties the buffer
+
+
+def test_stale_commands_are_dropped():
+    buf = PendingBuffer(max_age=3.0)
+    buf.add("commit:old", now=100.0)   # 5s before drain -> stale
+    buf.add("commit:new", now=104.0)   # 1s before drain -> fresh
+    assert buf.drain_fresh(now=105.0) == ["commit:new"]
+
+
+def test_all_stale_yields_nothing():
+    buf = PendingBuffer(max_age=3.0)
+    buf.add("commit:x", now=0.0)
+    assert buf.drain_fresh(now=100.0) == []
+
+
+def test_clear_empties_buffer():
+    buf = PendingBuffer()
+    buf.add("preedit:z")
+    assert len(buf) == 1
+    buf.clear()
+    assert len(buf) == 0
+    assert buf.drain_fresh() == []

{python_voiceio-0.4.0 → python_voiceio-0.4.1}/tests/test_ibus_typer.py

@@ -149,6 +149,63 @@ class TestIBusTyper:
             assert result.ok
 
 
+class TestProbeReadOnly:
+    """Fix #6: probe() must be side-effect-free (no install / IBus restart)
+    and must cache a successful result to avoid subprocess storms."""
+
+    def test_missing_component_does_not_install(self):
+        with patch("voiceio.typers.ibus.shutil.which", return_value="/usr/bin/ibus"), \
+             patch("voiceio.typers.ibus._has_ibus_gi", return_value=True), \
+             patch("voiceio.typers.ibus._ibus_daemon_running", return_value=True), \
+             patch("voiceio.typers.ibus._component_installed", return_value=False), \
+             patch("voiceio.typers.ibus.install_component") as mock_install:
+            typer = IBusTyper()
+            result = typer.probe()
+            assert not result.ok
+            assert "not installed" in result.reason
+            mock_install.assert_not_called()  # read-only!
+
+    def test_ok_result_is_cached(self):
+        with patch("voiceio.typers.ibus.shutil.which", return_value="/usr/bin/ibus"), \
+             patch("voiceio.typers.ibus._has_ibus_gi", return_value=True), \
+             patch("voiceio.typers.ibus._ibus_daemon_running", return_value=True) as mock_daemon, \
+             patch("voiceio.typers.ibus._component_installed", return_value=True), \
+             patch("voiceio.typers.ibus._gnome_source_configured", return_value=True):
+            typer = IBusTyper()
+            assert typer.probe().ok
+            assert typer.probe().ok
+            # Second call served from cache — no repeated subprocess probing.
+            assert mock_daemon.call_count == 1
+
+    def test_failure_is_not_cached(self):
+        with patch("voiceio.typers.ibus.shutil.which", return_value="/usr/bin/ibus"), \
+             patch("voiceio.typers.ibus._has_ibus_gi", return_value=True), \
+             patch("voiceio.typers.ibus._ibus_daemon_running", return_value=False) as mock_daemon:
+            typer = IBusTyper()
+            assert not typer.probe().ok
+            assert not typer.probe().ok
+            # Failures re-check every time (recover immediately when fixed).
+            assert mock_daemon.call_count == 2
+
+    def test_ensure_installed_installs_when_missing(self):
+        with patch("voiceio.typers.ibus._component_installed", return_value=False), \
+             patch("voiceio.typers.ibus.install_component", return_value=True) as mock_install, \
+             patch("voiceio.typers.ibus._ensure_gnome_input_source") as mock_src:
+            typer = IBusTyper()
+            assert typer.ensure_installed() is True
+            mock_install.assert_called_once()
+            mock_src.assert_called_once()
+
+    def test_ensure_installed_skips_install_when_present(self):
+        with patch("voiceio.typers.ibus._component_installed", return_value=True), \
+             patch("voiceio.typers.ibus.install_component") as mock_install, \
+             patch("voiceio.typers.ibus._ensure_gnome_input_source") as mock_src:
+            typer = IBusTyper()
+            assert typer.ensure_installed() is True
+            mock_install.assert_not_called()
+            mock_src.assert_called_once()
+
+
 class TestStreamingTyperProtocol:
     def test_ibus_is_streaming_typer(self):
         from voiceio.typers.base import StreamingTyper

{python_voiceio-0.4.0 → python_voiceio-0.4.1}/tests/test_prebuffer.py

@@ -103,3 +103,49 @@ class TestAudioRecorderPrebuffer:
         assert audio.ndim == 1
         # Should contain prebuffer + callback data
         assert len(audio) > 1024
+
+
+class TestNoCrossGenerationTruncation:
+    """Fix #5: mark_transcribed is gone; stop() returns the FULL recording and
+    the streaming pause gate uses a session-local high-water mark."""
+
+    def _recorder(self):
+        cfg = AudioConfig(sample_rate=16000, prebuffer_secs=0.0, silence_duration=0.1)
+        rec = AudioRecorder(cfg)
+        rec._stream = MagicMock()
+        return rec
+
+    def test_mark_transcribed_removed(self):
+        rec = self._recorder()
+        assert not hasattr(rec, "mark_transcribed")
+        assert not hasattr(rec, "_last_transcribed_len")
+
+    def test_stop_returns_full_audio(self):
+        rec = self._recorder()
+        rec.start()
+        # 1s of audio in 4 chunks
+        for _ in range(4):
+            rec._callback(np.ones((4000, 1), dtype=np.float32) * 0.3, 4000, None, None)
+        audio = rec.stop()
+        assert audio is not None
+        assert len(audio) == 16000  # nothing truncated
+
+    def test_pause_high_water_resets_each_recording(self):
+        rec = self._recorder()
+        fired = []
+        rec.set_on_speech_pause(lambda: fired.append(1))
+
+        # First recording: speech then silence -> fires once.
+        rec.start()
+        assert rec._pause_fired_at == 0
+        with patch.object(rec._vad, "is_speech", return_value=True):
+            rec._callback(np.ones((16000, 1), dtype=np.float32) * 0.3, 16000, None, None)
+        with patch.object(rec._vad, "is_speech", return_value=False):
+            rec._callback(np.zeros((3200, 1), dtype=np.float32), 3200, None, None)
+        assert len(fired) == 1
+        assert rec._pause_fired_at > 0
+        rec.stop()
+
+        # New recording must reset the high-water mark (no leak across gens).
+        rec.start()
+        assert rec._pause_fired_at == 0