python-voiceio 1.9.3__tar.gz → 1.11.0__tar.gz

{python_voiceio-1.9.3/python_voiceio.egg-info → python_voiceio-1.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 1.9.3
+Version: 1.11.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -87,7 +87,16 @@ pipx install 'python-voiceio[desktop]'
 voiceio setup        # model, hotkey, autostart
 ```
 
-Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works and `voiceio doctor --fix` repairs what it can. NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
+**Or as a Debian/Ubuntu package** (new; bundles everything, nothing to compile):
+
+```bash
+# Debian / Ubuntu: download voiceio_*.deb from the latest release, then
+sudo apt install ./voiceio_*.deb
+
+voiceio setup
+```
+
+Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works, `voiceio doctor --fix` repairs what it can, and `voiceio doctor --report` shares an anonymous install report on the [feedback board](https://voiceio.dev/#feedback) (it shows you the text and asks first). NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
 
 ## Make it yours
 
@@ -121,7 +130,7 @@ Everything lives in `~/.config/voiceio/config.toml`; [config.example.toml](confi
 - **Unbounded vocabulary**: a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
 - **GPU on AMD and Intel**: let setup run a Vulkan whisper.cpp server for you.
 - **Typing without IBus on GNOME and KDE**: a libei backend.
-- **Distro packages**: AUR, .deb and .rpm.
+- **Distro packages**: AUR (packaged, not yet published) and .rpm.
 - **One model everywhere**: sync your fine-tune across your machines.
 
 ## Contributing

{python_voiceio-1.9.3 → python_voiceio-1.11.0}/README.md

@@ -34,7 +34,16 @@ pipx install 'python-voiceio[desktop]'
 voiceio setup        # model, hotkey, autostart
 ```
 
-Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works and `voiceio doctor --fix` repairs what it can. NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
+**Or as a Debian/Ubuntu package** (new; bundles everything, nothing to compile):
+
+```bash
+# Debian / Ubuntu: download voiceio_*.deb from the latest release, then
+sudo apt install ./voiceio_*.deb
+
+voiceio setup
+```
+
+Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works, `voiceio doctor --fix` repairs what it can, and `voiceio doctor --report` shares an anonymous install report on the [feedback board](https://voiceio.dev/#feedback) (it shows you the text and asks first). NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
 
 ## Make it yours
 
@@ -68,7 +77,7 @@ Everything lives in `~/.config/voiceio/config.toml`; [config.example.toml](confi
 - **Unbounded vocabulary**: a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
 - **GPU on AMD and Intel**: let setup run a Vulkan whisper.cpp server for you.
 - **Typing without IBus on GNOME and KDE**: a libei backend.
-- **Distro packages**: AUR, .deb and .rpm.
+- **Distro packages**: AUR (packaged, not yet published) and .rpm.
 - **One model everywhere**: sync your fine-tune across your machines.
 
 ## Contributing

{python_voiceio-1.9.3 → python_voiceio-1.11.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-voiceio"
-version = "1.9.3"
+version = "1.11.0"
 description = "Voice dictation for Linux. Speak → text, locally, instantly."
 readme = "README.md"
 license = "MIT"

{python_voiceio-1.9.3 → python_voiceio-1.11.0/python_voiceio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 1.9.3
+Version: 1.11.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -87,7 +87,16 @@ pipx install 'python-voiceio[desktop]'
 voiceio setup        # model, hotkey, autostart
 ```
 
-Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works and `voiceio doctor --fix` repairs what it can. NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
+**Or as a Debian/Ubuntu package** (new; bundles everything, nothing to compile):
+
+```bash
+# Debian / Ubuntu: download voiceio_*.deb from the latest release, then
+sudo apt install ./voiceio_*.deb
+
+voiceio setup
+```
+
+Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works, `voiceio doctor --fix` repairs what it can, and `voiceio doctor --report` shares an anonymous install report on the [feedback board](https://voiceio.dev/#feedback) (it shows you the text and asks first). NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
 
 ## Make it yours
 
@@ -121,7 +130,7 @@ Everything lives in `~/.config/voiceio/config.toml`; [config.example.toml](confi
 - **Unbounded vocabulary**: a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
 - **GPU on AMD and Intel**: let setup run a Vulkan whisper.cpp server for you.
 - **Typing without IBus on GNOME and KDE**: a libei backend.
-- **Distro packages**: AUR, .deb and .rpm.
+- **Distro packages**: AUR (packaged, not yet published) and .rpm.
 - **One model everywhere**: sync your fine-tune across your machines.
 
 ## Contributing

{python_voiceio-1.9.3 → python_voiceio-1.11.0}/python_voiceio.egg-info/SOURCES.txt

@@ -52,6 +52,7 @@ tests/test_learn_review.py
 tests/test_learn_targets.py
 tests/test_llm.py
 tests/test_llm_api.py
+tests/test_mic_gain.py
 tests/test_modifier_guard.py
 tests/test_numbers.py
 tests/test_paste_last.py
@@ -64,6 +65,7 @@ tests/test_presence.py
 tests/test_prompt.py
 tests/test_quiet_audio.py
 tests/test_recorder_integration.py
+tests/test_report.py
 tests/test_retention.py
 tests/test_robustness.py
 tests/test_security_hardening.py
@@ -101,6 +103,7 @@ voiceio/history.py
 voiceio/idle_audio.py
 voiceio/llm.py
 voiceio/llm_api.py
+voiceio/mic_gain.py
 voiceio/numbers.py
 voiceio/pidlock.py
 voiceio/platform.py
@@ -112,6 +115,7 @@ voiceio/privacy.py
 voiceio/prompt.py
 voiceio/quiet_audio.py
 voiceio/recorder.py
+voiceio/report.py
 voiceio/retention.py
 voiceio/service.py
 voiceio/streaming.py
@@ -187,6 +191,7 @@ voiceio/setup/steps.py
 voiceio/setup/system.py
 voiceio/setup/ui.py
 voiceio/sounds/__init__.py
+voiceio/sounds/alert.wav
 voiceio/sounds/commit.wav
 voiceio/sounds/start.wav
 voiceio/sounds/stop.wav

python_voiceio-1.11.0/tests/test_mic_gain.py

@@ -0,0 +1,85 @@
+"""Input gain follows the recordings: down on clipping, up when very quiet,
+never back to a level that clipped."""
+from __future__ import annotations
+
+from voiceio import mic_gain
+from voiceio.mic_gain import MicGain
+
+
+class FakeSource:
+    def __init__(self, volume):
+        self.volume = volume
+        self.sets = []
+
+    def get(self):
+        return self.volume
+
+    def set(self, v):
+        self.sets.append(v)
+        self.volume = v
+        return True
+
+
+def _gain(volume=0.5):
+    g = MicGain(enabled=False)
+    g._source = FakeSource(volume)
+    return g
+
+
+def test_clipping_lowers_by_a_fifth():
+    g = _gain(0.5)
+    change = g.after_recording(peak=1.0, clip_ratio=0.02, secs=10)
+    assert change.reason == "clipping" and g._source.volume == 0.4
+
+
+def test_never_below_the_floor():
+    g = _gain(0.11)
+    g.after_recording(1.0, 0.02, 10)
+    assert g._source.volume == mic_gain.FLOOR
+
+
+def test_three_quiet_recordings_raise_but_not_to_a_level_that_clipped():
+    g = _gain(0.5)
+    g.after_recording(1.0, 0.02, 10)                 # 0.5 clipped -> 0.4
+    for _ in range(2):
+        assert g.after_recording(0.05, 0.0, 10) is None
+    assert g.after_recording(0.05, 0.0, 10) is None  # third quiet one: would reach 0.5
+    assert g._source.volume == 0.4                  # capped at 0.5 * 0.8: no oscillation
+
+
+def test_quiet_without_any_clipping_history_raises():
+    g = _gain(0.3)
+    for _ in range(3):
+        change = g.after_recording(0.05, 0.0, 10)
+    assert change.new == round(0.3 / mic_gain.STEP, 2)
+
+
+def test_short_or_dead_recordings_dont_count():
+    g = _gain(0.3)
+    for _ in range(5):
+        assert g.after_recording(0.05, 0.0, 1.0) is None   # too short
+        assert g.after_recording(0.0, 0.0, 10) is None     # muted mic: not a gain problem
+    assert g._source.sets == []
+
+
+def test_normal_level_resets_the_quiet_streak():
+    g = _gain(0.3)
+    g.after_recording(0.05, 0.0, 10)
+    g.after_recording(0.05, 0.0, 10)
+    g.after_recording(0.5, 0.0, 10)
+    assert g.after_recording(0.05, 0.0, 10) is None
+
+
+def test_a_chosen_device_is_left_alone():
+    assert not MicGain(enabled=True, device="hw:1").active
+
+
+def test_off_without_volume_tools(monkeypatch):
+    # conftest: quiet_audio._which finds nothing in tests
+    assert not MicGain(enabled=True).active
+
+
+def test_failures_never_raise():
+    g = _gain(0.5)
+    g._source.get = lambda: (_ for _ in ()).throw(RuntimeError("boom"))
+    assert g.after_recording(1.0, 0.02, 10) is None

python_voiceio-1.11.0/tests/test_report.py

@@ -0,0 +1,314 @@
+"""`voiceio doctor --report` and the post-setup feedback line: what goes public."""
+from __future__ import annotations
+
+import io
+import json
+import sys
+
+import pytest
+
+from voiceio import report
+from voiceio.config import Config
+from voiceio.health import BackendStatus, HealthReport
+from voiceio.platform import Platform
+
+FAKE_HOME = "/home/zelda-tester"
+FAKE_USER = "zelda-tester"
+FAKE_HOST = "zeldas-thinkpad"
+
+
+@pytest.fixture
+def identity(monkeypatch):
+    """A fake user, home and hostname that must never reach a report."""
+    monkeypatch.setenv("HOME", FAKE_HOME)
+    monkeypatch.setenv("USER", FAKE_USER)
+    monkeypatch.setattr(report.getpass, "getuser", lambda: FAKE_USER)
+    monkeypatch.setattr(report.socket, "gethostname", lambda: FAKE_HOST)
+    monkeypatch.setattr(report._py_platform, "node", lambda: FAKE_HOST)
+    monkeypatch.setattr(report, "_homes", lambda: [FAKE_HOME])
+
+
+def _health(**kw) -> HealthReport:
+    defaults = dict(
+        platform=Platform(os="linux", display_server="wayland", desktop="gnome"),
+        hotkey_backends=[BackendStatus("evdev", True)],
+        typer_backends=[BackendStatus("ibus", True), BackendStatus("ydotool", False, "not installed")],
+        audio_ok=True, cli_in_path=True, tray_ok=True,
+    )
+    defaults.update(kw)
+    return HealthReport(**defaults)
+
+
+def _assert_private(text: str) -> None:
+    for secret in (FAKE_HOME, FAKE_USER, FAKE_HOST, "zelda"):
+        assert secret not in text.lower(), (secret, text)
+
+
+# ── scrubbing ──
+
+def test_scrub_removes_home_user_host_and_addresses(identity):
+    raw = (f"cannot open {FAKE_HOME}/.config/voiceio/x.toml as {FAKE_USER}@{FAKE_HOST}; "
+           "also /home/someoneelse/.cache, 192.168.1.40, fe80:0:0:0:1:2:3:4, "
+           "aa:bb:cc:dd:ee:ff, /dev/input/by-id/usb-Logitech_K120_SN12345-event-kbd, "
+           "ZELDA-TESTER shouted")
+    out = report.scrub(raw)
+    _assert_private(out)
+    for leaked in ("someoneelse", "192.168", "fe80", "aa:bb", "SN12345", "Logitech"):
+        assert leaked not in out
+    assert "~/.config/voiceio/x.toml" in out
+
+
+def test_scrub_keeps_versions_and_backend_names(identity):
+    out = report.scrub("voiceio 1.10.0.2 · ibus · python 3.12.3")
+    assert out == "voiceio 1.10.0.2 · ibus · python 3.12.3"
+
+
+def test_report_scrubs_check_messages_and_comment(identity):
+    health = _health(
+        hotkey_backends=[BackendStatus("evdev", False, f"{FAKE_HOME}/dev denied for {FAKE_USER}")],
+        audio_ok=False, audio_reason=f"device on {FAKE_HOST} busy",
+        warnings=[f"see {FAKE_HOME}/.local/state/voiceio/voiceio.log"],
+    )
+    text = report.build_report(health, comment=f"broke in {FAKE_HOME}/src, I'm {FAKE_USER}",
+                               cfg=Config())
+    _assert_private(text)
+    assert "failed: hotkey evdev: ~/dev denied" in text
+    assert "audio: device on <host> busy" in text
+    assert "comment: broke in ~/src" in text
+
+
+def test_report_contains_only_backend_and_model_names(identity):
+    cfg = Config()
+    cfg.model.name = f"{FAKE_HOME}/models/my-tune"
+    cfg.model.vocabulary_file = f"{FAKE_HOME}/vocab.txt"
+    cfg.cloud.api_key = "sk-secret"
+    cfg.hotkey.key = "ctrl+alt+zelda"
+    text = report.build_report(_health(), cfg=cfg)
+    _assert_private(text)
+    assert "sk-secret" not in text and "vocab" not in text and "ctrl+alt" not in text
+    assert "model: custom (local path)" in text
+    assert "hotkey evdev" in text and "typer ibus" in text
+    assert "fallbacks unavailable: ydotool" in text
+    assert "failed: none" in text
+    assert text.splitlines()[0].startswith("voiceio ")
+
+
+def test_report_lists_failures_and_warnings():
+    health = _health(typer_backends=[BackendStatus("ibus", False, "daemon down")],
+                     cli_in_path=False, tray_ok=False, tray_reason="no AppIndicator")
+    text = report.build_report(health, missing_deps=["portaudio"], perm_issues=2, cfg=Config())
+    assert "typer none" in text
+    assert "typer ibus: daemon down" in text
+    assert "missing system deps" in text
+    assert "cli not in PATH" in text and "tray: no AppIndicator" in text
+    assert "insecure permissions on 2 file(s)" in text
+
+
+def test_comment_is_one_bounded_line():
+    text = report.build_report(_health(), comment="a\nb\tc " + "x" * 1000, cfg=Config())
+    line = next(ln for ln in text.splitlines() if ln.startswith("comment:"))
+    assert line.startswith("comment: a b c x")
+    assert len(line) <= len("comment: ") + report.MAX_COMMENT
+
+
+# ── posting ──
+
+class _Resp(io.BytesIO):
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *a):
+        return False
+
+
+def test_post_success_reads_receipt(monkeypatch):
+    seen = []
+
+    def fake(url, timeout):
+        seen.append((url, timeout))
+        return _Resp(json.dumps({"ok": True, "receipt": {"id": "r123"}}).encode())
+
+    monkeypatch.setattr(report, "_urlopen", fake)
+    assert report.post("hello world") == (True, "r123")
+    url, timeout = seen[0]
+    assert url.startswith(report.POST_URL + "?")
+    assert "text=hello+world" in url and "format=json" in url and "request_id=voiceio-" in url
+    assert timeout <= 10
+
+
+@pytest.mark.parametrize("body", [b'{"ok": false, "error": "rate limited"}', b"[]", b"not json",
+                                  b'{"ok": true}'])
+def test_post_bad_response_is_failure(monkeypatch, body):
+    monkeypatch.setattr(report, "_urlopen", lambda url, timeout: _Resp(body))
+    ok, why = report.post("x")
+    assert not ok and why
+
+
+def test_post_network_error_never_raises():
+    # conftest refuses every connection: this is the offline path.
+    ok, why = report.post("x")
+    assert not ok and "ConnectionRefused" in why
+
+
+# ── confirm / --yes / no TTY ──
+
+@pytest.fixture
+def posted(monkeypatch):
+    calls: list[str] = []
+    monkeypatch.setattr(report, "post", lambda text: (calls.append(text), (True, "r1"))[1])
+    return calls
+
+
+def _tty(monkeypatch, tty: bool):
+    monkeypatch.setattr(report, "_interactive", lambda: tty)
+
+
+def test_share_asks_and_posts_on_yes(monkeypatch, capsys, posted):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda prompt: "y")
+    assert report.share("the report") is True
+    out = capsys.readouterr().out
+    assert "PUBLICLY" in out and "the report" in out and report.BOARD_URL in out
+    assert posted == ["the report"]
+
+
+@pytest.mark.parametrize("answer", ["", "n", "no", "whatever"])
+def test_share_defaults_to_no(monkeypatch, capsys, posted, answer):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda prompt: answer)
+    assert report.share("r") is False
+    assert posted == []
+
+
+def test_share_eof_is_no(monkeypatch, posted):
+    _tty(monkeypatch, True)
+
+    def eof(prompt):
+        raise EOFError
+
+    monkeypatch.setattr("builtins.input", eof)
+    assert report.share("r") is False and posted == []
+
+
+def test_share_without_tty_prints_but_never_posts(monkeypatch, capsys, posted):
+    _tty(monkeypatch, False)
+    monkeypatch.setattr("builtins.input", lambda p: pytest.fail("must not prompt"))
+    assert report.share("the report") is False
+    out = capsys.readouterr().out
+    assert "the report" in out and "--yes" in out
+    assert posted == []
+
+
+def test_share_yes_skips_prompt(monkeypatch, posted):
+    _tty(monkeypatch, False)
+    monkeypatch.setattr("builtins.input", lambda p: pytest.fail("must not prompt"))
+    assert report.share("r", yes=True) is True and posted == ["r"]
+
+
+def test_share_failure_is_reported_not_raised(monkeypatch, capsys):
+    assert report.share("r", yes=True) is False
+    assert "Could not confirm the post" in capsys.readouterr().out
+
+
+# ── CLI wiring ──
+
+@pytest.fixture
+def doctor_env(monkeypatch, identity):
+    from voiceio import config, health
+    from voiceio import platform as plat
+    monkeypatch.setattr(health, "check_health", lambda: _health(
+        warnings=[f"something at {FAKE_HOME}/.config"]))
+    monkeypatch.setattr(health, "format_report", lambda r: "DOCTOR OUTPUT")
+    monkeypatch.setattr(health, "usage_findings", lambda: [])
+    monkeypatch.setattr(plat, "check_system_deps", lambda: [])
+    monkeypatch.setattr(config, "check_permissions", lambda: [])
+    monkeypatch.setattr("voiceio.hints.hint", lambda *a, **k: None)
+
+
+def _doctor(monkeypatch, capsys, *argv):
+    from voiceio.cli import main
+    monkeypatch.setattr(sys, "argv", ["voiceio", "doctor", *argv])
+    with pytest.raises(SystemExit):
+        main()
+    return capsys.readouterr().out
+
+
+def test_doctor_report_yes_posts_scrubbed_comment(monkeypatch, capsys, doctor_env, posted):
+    out = _doctor(monkeypatch, capsys, "--report", "--yes",
+                  "--comment", f"worked, {FAKE_USER} here")
+    assert len(posted) == 1
+    _assert_private(posted[0])
+    _assert_private(out)
+    assert "comment: worked, <user> here" in posted[0]
+    assert report.BOARD_URL in out
+
+
+def test_doctor_report_without_tty_or_yes_does_not_post(monkeypatch, capsys, doctor_env, posted):
+    _tty(monkeypatch, False)
+    out = _doctor(monkeypatch, capsys, "--report")
+    assert posted == []
+    assert "voiceio " in out and "Not posted" in out
+
+
+def test_doctor_without_report_never_posts(monkeypatch, capsys, doctor_env, posted):
+    out = _doctor(monkeypatch, capsys)
+    assert posted == [] and "PUBLICLY" not in out
+
+
+# ── after setup ──
+
+def test_after_setup_enter_skips_silently(monkeypatch, capsys, posted):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda p: "")
+    monkeypatch.setattr(report, "gather", lambda c: pytest.fail("no checks on skip"))
+    report.offer_after_setup()
+    assert posted == [] and "PUBLICLY" not in capsys.readouterr().out
+
+
+def test_after_setup_comment_is_shown_confirmed_and_posted(monkeypatch, capsys, posted):
+    _tty(monkeypatch, True)
+    answers = iter(["went fine", "y"])
+    monkeypatch.setattr("builtins.input", lambda p: next(answers))
+    monkeypatch.setattr(report, "gather", lambda c: (None, f"voiceio x report\ncomment: {c}"))
+    report.offer_after_setup()
+    assert posted == ["voiceio x report\ncomment: went fine"]
+
+
+def test_after_setup_never_raises(monkeypatch, capsys):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda p: "it broke")
+
+    def boom(c):
+        raise RuntimeError("probe exploded")
+
+    monkeypatch.setattr(report, "gather", boom)
+    report.offer_after_setup()  # must not raise
+    assert "Skipped" in capsys.readouterr().out
+
+
+def test_after_setup_needs_a_terminal(monkeypatch, posted):
+    _tty(monkeypatch, False)
+    monkeypatch.setattr("builtins.input", lambda p: pytest.fail("must not prompt"))
+    report.offer_after_setup()
+    assert posted == []
+
+
+def test_setup_wizard_offers_the_report(monkeypatch):
+    from voiceio.cli import main
+    calls = []
+    monkeypatch.setattr("voiceio.setup.run_wizard", lambda: calls.append("wizard"))
+    monkeypatch.setattr(report, "offer_after_setup", lambda: calls.append("offer"))
+    monkeypatch.setattr("voiceio.hints.hint", lambda *a, **k: None)
+    monkeypatch.setattr(sys, "argv", ["voiceio", "setup"])
+    main()
+    assert calls == ["wizard", "offer"]
+
+
+def test_network_guard_blocks_real_hosts():
+    import socket
+    s = socket.socket()
+    try:
+        with pytest.raises(ConnectionRefusedError):
+            s.connect(("93.184.216.34", 443))
+    finally:
+        s.close()

{python_voiceio-1.9.3 → python_voiceio-1.11.0}/tests/test_service.py

@@ -25,6 +25,28 @@ def test_install_symlinks_relinks_and_drops_legacy(monkeypatch, tmp_path):
     assert not (local_bin / "voiceio-doctor").is_symlink()
 
 
+def test_packaged_install_links_nothing_and_serves_its_own_bin(monkeypatch, tmp_path):
+    prefix = tmp_path / "usr-lib-voiceio"
+    (prefix / "bin").mkdir(parents=True)
+    (prefix / "bin" / "voiceio").write_text("#!/bin/sh\n")
+    (prefix / service.PACKAGED_MARKER).write_text("deb\n")
+    local_bin = tmp_path / "local-bin"
+    monkeypatch.setattr(service, "LOCAL_BIN", local_bin)
+    monkeypatch.setattr(sys, "prefix", str(prefix))
+
+    assert service.packaged_by() == "deb"
+    assert service.package_remove_cmd() == "sudo apt remove voiceio"
+    service.install_symlinks()
+    assert not local_bin.exists()
+    # The unit's ExecStart is the package's own path, stable across upgrades.
+    assert service._find_voiceio_bin() == str((prefix / "bin" / "voiceio").resolve())
+
+
+def test_unpackaged_install_has_no_package(monkeypatch, tmp_path):
+    monkeypatch.setattr(sys, "prefix", str(tmp_path))
+    assert service.packaged_by() is None and service.package_remove_cmd() is None
+
+
 def test_learn_timer_runs_maintain_at_idle_priority(monkeypatch, tmp_path):
     calls = []
     monkeypatch.setattr(service, "has_systemd", lambda: True)
@@ -44,7 +66,7 @@ def test_learn_timer_runs_maintain_at_idle_priority(monkeypatch, tmp_path):
                  "MemoryHigh=25%", "OOMScoreAdjust=500"):
         assert f"\n{line}\n" in unit, line
     timer = service.LEARN_TIMER_PATH.read_text()
-    assert "Persistent=true" in timer and "OnCalendar=*-*-* 03:30" in timer
+    assert "Persistent=true" in timer and "OnCalendar=Sun *-*-* 03:30" in timer
     assert ("enable", "--now", service.LEARN_TIMER_NAME) in calls
 
     service.uninstall_learn_timer()
@@ -109,7 +131,7 @@ def test_learn_schedule_comes_from_config(monkeypatch, tmp_path):
     monkeypatch.setattr(service, "LEARN_SERVICE_PATH", tmp_path / "s.service")
     monkeypatch.setattr(service, "LEARN_TIMER_PATH", tmp_path / "s.timer")
     service.install_learn_timer()
-    assert "OnCalendar=*-*-* 03:30" in service.LEARN_TIMER_PATH.read_text()
+    assert "OnCalendar=Sun *-*-* 03:30" in service.LEARN_TIMER_PATH.read_text()   # weekly by default
 
     config.set_value("learn", "at", "2:05")
     config.set_value("learn", "every", "week")

python_voiceio-1.11.0/voiceio/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.11.0"