android-watcher 1.0.0__tar.gz → 1.0.2__tar.gz

{android_watcher-1.0.0 → android_watcher-1.0.2}/.github/workflows/release.yml

@@ -1,8 +1,9 @@
 name: release
 
 # Manual, bump-driven release. Pick the semver part to bump; the job computes the
-# new version from the current one, commits it to main, publishes to PyPI, refreshes
-# the Homebrew formula, and tags the release last.
+# new version from the current one, commits it to main, publishes to PyPI, tags and
+# publishes a GitHub release, then refreshes the Homebrew formula as a best-effort,
+# non-blocking step.
 on:
   workflow_dispatch:
     inputs:
@@ -33,6 +34,11 @@ jobs:
         with:
           ref: main
           fetch-depth: 0   # full history so we can push back and tag
+          # Push to main as the repo owner (a ruleset bypass actor) rather than the
+          # ambient GITHUB_TOKEN / github-actions[bot], which the main ruleset blocks.
+          # On a user-owned repo the GitHub Actions integration cannot be added to the
+          # bypass list, so a fine-grained PAT (contents: write) is used instead.
+          token: ${{ secrets.RELEASE_TOKEN }}
 
       - name: Configure git as the release bot
         run: |
@@ -72,7 +78,33 @@ jobs:
         with:
           password: ${{ secrets.PYPI_TOKEN }}
 
+      # Tag and publish a GitHub release right after the publish succeeds, before
+      # the best-effort Homebrew step. A formula hiccup must never leave a
+      # published version untagged or unreleased. --generate-notes builds the
+      # changelog from merged PRs and commits since the previous release.
+      - name: Tag and publish GitHub release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${{ steps.bump.outputs.version }}"
+          git tag "v${VERSION}"
+          git push origin "v${VERSION}"
+          gh release create "v${VERSION}" \
+            --title "v${VERSION}" \
+            --generate-notes \
+            --verify-tag \
+            --latest
+
+      - name: Set up Homebrew
+        uses: Homebrew/actions/setup-homebrew@master
+
+      # Best-effort and non-blocking. `brew update-python-resources` refuses a loose
+      # formula file, so it is staged inside a throwaway local tap below. It can
+      # still fail to resolve a same-day PyPI upload, whose publish postdates
+      # Homebrew's reproducibility cutoff. Never let that fail the release;
+      # regenerate the resource blocks out-of-band when it does, then commit.
       - name: Update Homebrew formula
+        continue-on-error: true
         run: |
           VERSION="${{ steps.bump.outputs.version }}"
           # PyPI's JSON index lags publish by a few seconds; poll until the release shows up.
@@ -101,12 +133,16 @@ jobs:
           open(p, "w").write(s)
           PY
           # Regenerate every pinned dependency `resource` block against this release.
-          brew update-python-resources Formula/android-watcher.rb
+          # update-python-resources only operates on a formula inside a tap, so stage
+          # it in a throwaway local tap, regenerate there, then copy the result back.
+          TAP_DIR="$(brew --repository)/Library/Taps/local/homebrew-awtmp"
+          rm -rf "$TAP_DIR" && mkdir -p "$TAP_DIR/Formula"
+          git -C "$TAP_DIR" init -q
+          git -C "$TAP_DIR" -c user.email=ci@local -c user.name=ci commit -q --allow-empty -m init
+          cp Formula/android-watcher.rb "$TAP_DIR/Formula/android-watcher.rb"
+          brew update-python-resources local/awtmp/android-watcher
+          cp "$TAP_DIR/Formula/android-watcher.rb" Formula/android-watcher.rb
+          rm -rf "$TAP_DIR"
           git add Formula/android-watcher.rb
           git commit -m "chore: update homebrew formula for v${VERSION}"
           git push origin HEAD:main
-
-      - name: Tag the release
-        run: |
-          git tag "v${{ steps.bump.outputs.version }}"
-          git push origin "v${{ steps.bump.outputs.version }}"

android_watcher-1.0.2/Formula/android-watcher.rb

@@ -0,0 +1,110 @@
+class AndroidWatcher < Formula
+  include Language::Python::Virtualenv
+
+  desc "Self-hosted CLI that watches Google's Android sites and delivers AI-triaged digests"
+  homepage "https://github.com/krayong/android-watcher"
+  # url + sha256 point at the PyPI sdist for the released version. The release
+  # workflow rewrites both on every version bump, then regenerates the `resource`
+  # blocks below with `brew update-python-resources`. Do not hand-edit.
+  url "https://files.pythonhosted.org/packages/1b/60/9497af75a83ed1171ebcee223bf6ee934066765a16395ec2cf3c52311f0a/android_watcher-1.0.1.tar.gz"
+  sha256 "e7bc14ef364792caf8b88ce83b4f4934679227627a34b4423b19389c9e4346ec"
+  license "MIT"
+
+  depends_on "python@3.11"
+
+  # Dependency resource blocks, one hash-pinned sdist per transitive dependency.
+  # Regenerated by `brew update-python-resources` (or out-of-band for a same-day
+  # release, whose upload postdates Homebrew's reproducibility cutoff).
+  resource "anyio" do
+    url "https://files.pythonhosted.org/packages/1c/b5/001890774a9552aff22502b8da382593109ce0c95314abaebbb116567545/anyio-4.14.0.tar.gz"
+    sha256 "b47c1f9ccf73e67021df785332508f99379c68fa7d0684e8e3492cb1d4b23f89"
+  end
+
+  resource "certifi" do
+    url "https://files.pythonhosted.org/packages/c9/c7/424b75da314c1045981bd9777432fad05a9e0c69daa4ed7e308bbaffe405/certifi-2026.6.17.tar.gz"
+    sha256 "024c88eeec92ca068db80f02b8b07c9cef7b9fe261d1d535abfd5abd6f6af432"
+  end
+
+  resource "defusedxml" do
+    url "https://files.pythonhosted.org/packages/0f/d5/c66da9b79e5bdb124974bfe172b4daf3c984ebd9c2a06e2b8a4dc7331c72/defusedxml-0.7.1.tar.gz"
+    sha256 "1bb3032db185915b62d7c6209c5a8792be6a32ab2fedacc84e01b52c51aa3e69"
+  end
+
+  resource "h11" do
+    url "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz"
+    sha256 "4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1"
+  end
+
+  resource "httpcore" do
+    url "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz"
+    sha256 "6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8"
+  end
+
+  resource "httpx" do
+    url "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz"
+    sha256 "75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc"
+  end
+
+  resource "idna" do
+    url "https://files.pythonhosted.org/packages/cd/63/9496c57188a2ee585e0f1db071d75089a11e98aa86eb99d9d7618fc1edce/idna-3.18.tar.gz"
+    sha256 "ffb385a7e039654cef1ab9ef32c6fafe283c0c0467bba1d9029738ce4a14a848"
+  end
+
+  resource "linkify-it-py" do
+    url "https://files.pythonhosted.org/packages/2e/c9/06ea13676ef354f0af6169587ae292d3e2406e212876a413bf9eece4eb23/linkify_it_py-2.1.0.tar.gz"
+    sha256 "43360231720999c10e9328dc3691160e27a718e280673d444c38d7d3aaa3b98b"
+  end
+
+  resource "markdown-it-py" do
+    url "https://files.pythonhosted.org/packages/06/ff/7841249c247aa650a76b9ee4bbaeae59370dc8bfd2f6c01f3630c35eb134/markdown_it_py-4.2.0.tar.gz"
+    sha256 "04a21681d6fbb623de53f6f364d352309d4094dd4194040a10fd51833e418d49"
+  end
+
+  resource "mdit-py-plugins" do
+    url "https://files.pythonhosted.org/packages/59/fc/f8d0863f8862f25602c0404d75568e89fb6b4109804645e5cdfb1be5cf56/mdit_py_plugins-0.6.1.tar.gz"
+    sha256 "a2bca0f039f39dbd35fb74ae1b5f998608c437463371f0ff7f49a19a17a114d0"
+  end
+
+  resource "mdurl" do
+    url "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz"
+    sha256 "bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba"
+  end
+
+  resource "platformdirs" do
+    url "https://files.pythonhosted.org/packages/d7/47/e4501f49c178ae1d9f4a75073fda4204f52647993f075a9db4d14930e0c5/platformdirs-4.10.0.tar.gz"
+    sha256 "31e761a6a0ca04faf7353ea759bdba55652be214725111e5aac52dfa29d4bef7"
+  end
+
+  resource "pygments" do
+    url "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz"
+    sha256 "6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f"
+  end
+
+  resource "rich" do
+    url "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz"
+    sha256 "edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36"
+  end
+
+  resource "textual" do
+    url "https://files.pythonhosted.org/packages/9b/7a/c519db0aba5024f86e71e9631810bfdd6866ed2c8695bd7fa34b90e7ef59/textual-8.2.7.tar.gz"
+    sha256 "658f568ff81e30ed43890c3e07520390e5cf1b4763822006e060656b0a88f105"
+  end
+
+  resource "typing-extensions" do
+    url "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz"
+    sha256 "0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466"
+  end
+
+  resource "uc-micro-py" do
+    url "https://files.pythonhosted.org/packages/78/67/9a363818028526e2d4579334460df777115bdec1bb77c08f9db88f6389f2/uc_micro_py-2.0.0.tar.gz"
+    sha256 "c53691e495c8db60e16ffc4861a35469b0ba0821fe409a8a7a0a71864d33a811"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match "android-watcher", shell_output("#{bin}/android-watcher --help")
+  end
+end

{android_watcher-1.0.0 → android_watcher-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-watcher
-Version: 1.0.0
+Version: 1.0.2
 Summary: Self-hosted CLI that watches Google's official Android sites and delivers AI-triaged change digests.
 Project-URL: Homepage, https://github.com/krayong/android-watcher
 Project-URL: Repository, https://github.com/krayong/android-watcher

{android_watcher-1.0.0 → android_watcher-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "android-watcher"
-version = "1.0.0"
+version = "1.0.2"
 description = "Self-hosted CLI that watches Google's official Android sites and delivers AI-triaged change digests."
 readme = "README.md"
 license = { text = "MIT" }

{android_watcher-1.0.0 → android_watcher-1.0.2}/src/android_watcher/config.py

@@ -4,6 +4,8 @@ from __future__ import annotations
 
 import os
 import re
+import shutil
+import sys
 import tomllib
 from dataclasses import dataclass, field
 from typing import Any, Literal
@@ -16,6 +18,7 @@ __all__ = [
 	"AIConfig",
 	"Config",
 	"ConfigError",
+	"DesktopChannel",
 	"DigestConfig",
 	"EmailChannel",
 	"ScheduleConfig",
@@ -24,6 +27,8 @@ __all__ = [
 	"config_path",
 	"data_path",
 	"db_path",
+	"desktop_mechanism_available",
+	"digests_dir",
 	"load_config",
 	"log_path",
 ]
@@ -80,6 +85,12 @@ class TelegramChannel:
 	chat_id: str = ""
 
 
+@dataclass
+class DesktopChannel:
+	enabled: bool = False
+	sound: str = "Glass"  # macOS notification sound name
+
+
 @dataclass
 class Config:
 	schedule: ScheduleConfig
@@ -90,6 +101,9 @@ class Config:
 	slack: SlackChannel
 	telegram: TelegramChannel
 	custom_sources: list[Source]
+	# Defaulted (disabled) so existing Config(...) call sites need no change; a new
+	# optional local channel that is off until the user opts in.
+	desktop: DesktopChannel = field(default_factory=DesktopChannel)
 	enabled_source_ids: set[str] = field(default_factory=set)
 
 
@@ -105,6 +119,30 @@ def db_path() -> str:
 	return os.path.join(data_path(), "state.db")
 
 
+def digests_dir() -> str:
+	"""Directory where the desktop channel writes click-to-open HTML digests."""
+	return os.path.join(data_path(), "digests")
+
+
+def _desktop_binary() -> str | None:
+	"""The required desktop-notification binary for this platform, or None.
+
+	macOS uses terminal-notifier (the only mechanism that opens the digest on
+	click); Linux uses notify-send. Other platforms have no supported mechanism.
+	"""
+	if sys.platform == "darwin":
+		return "terminal-notifier"
+	if sys.platform.startswith("linux"):
+		return "notify-send"
+	return None
+
+
+def desktop_mechanism_available() -> bool:
+	"""True if this platform's required desktop-notification binary is installed."""
+	binary = _desktop_binary()
+	return bool(binary and shutil.which(binary))
+
+
 def log_path() -> str:
 	"""Path to the run log. ~/Library/Logs/android-watcher.log on macOS."""
 	import sys  # noqa: PLC0415 - localized; keeps module import graph lean
@@ -160,6 +198,7 @@ def load_config(path: str | None = None, *, expand: bool = True) -> Config:
 	email = _load_email(channels.get("email", {}), expand=expand)
 	slack = _load_slack(channels.get("slack", {}), expand=expand)
 	telegram = _load_telegram(channels.get("telegram", {}), expand=expand)
+	desktop = _load_desktop(channels.get("desktop", {}))
 	custom_sources = [_load_source(e) for e in raw.get("custom_source", [])]
 	enabled = set(raw.get("enabled_sources", []))
 
@@ -174,6 +213,7 @@ def load_config(path: str | None = None, *, expand: bool = True) -> Config:
 		email=email,
 		slack=slack,
 		telegram=telegram,
+		desktop=desktop,
 		custom_sources=custom_sources,
 		enabled_source_ids=enabled,
 	)
@@ -247,6 +287,14 @@ def _load_telegram(d: dict[str, Any], *, expand: bool) -> TelegramChannel:
 	)
 
 
+def _load_desktop(d: dict[str, Any]) -> DesktopChannel:
+	# No secret-bearing fields, so no ${ENV} interpolation needed.
+	return DesktopChannel(
+		enabled=bool(d.get("enabled", False)),
+		sound=d.get("sound", "Glass"),
+	)
+
+
 def _load_source(e: dict[str, Any]) -> Source:
 	return Source(
 		id=e["id"],

{android_watcher-1.0.0 → android_watcher-1.0.2}/src/android_watcher/doctor.py

@@ -34,6 +34,25 @@ def _check_ai(config: Config) -> Check:
 	return Check("ai-backend", False, "claude not found on PATH")
 
 
+def _check_desktop(config: Config) -> Check:
+	"""Verify the platform's required desktop-notification binary is installed."""
+	from android_watcher.config import (  # noqa: PLC0415 - localized to keep imports lean
+		_desktop_binary,
+		desktop_mechanism_available,
+	)
+
+	binary = _desktop_binary()
+	if binary is None:
+		return Check("desktop", False, "no supported desktop notifier for this platform")
+	if desktop_mechanism_available():
+		return Check("desktop", True, f"{binary} found")
+	return Check(
+		"desktop",
+		False,
+		f"{binary} not found on PATH; install it to enable desktop notifications",
+	)
+
+
 def _check_seed() -> Check:
 	"""Report the imported baseline seed date and snapshot count, if any."""
 	store = Store(db_path())
@@ -121,5 +140,7 @@ def run_doctor(config: Config) -> list[Check]:
 	checks.extend(_check_prefixes(config))
 	checks.append(_check_seed())
 	checks.append(_check_ai(config))
+	if config.desktop.enabled:
+		checks.append(_check_desktop(config))
 	checks.append(_check_schedule())
 	return checks

android_watcher-1.0.2/src/android_watcher/notify/__init__.py

@@ -0,0 +1 @@
+from . import desktop, email, slack, telegram  # noqa: F401

android_watcher-1.0.2/src/android_watcher/notify/desktop.py

@@ -0,0 +1,95 @@
+"""Desktop notifier: a native notification that opens a local HTML digest on click.
+
+macOS uses ``terminal-notifier`` (whose ``-execute`` runs ``open <file>`` on click);
+Linux uses ``notify-send`` (no portable click action, so the digest path is shown in
+the body). Both render the full digest to ``<data_dir>/digests`` first.
+"""
+
+from __future__ import annotations
+
+import logging
+import shlex
+import subprocess
+import sys
+from pathlib import Path
+
+from android_watcher.config import Config, desktop_mechanism_available, digests_dir
+from android_watcher.models import Digest, DigestGroup, NotifyError
+from android_watcher.notify.base import NOTIFIERS
+from android_watcher.notify.html import render_html
+
+logger = logging.getLogger(__name__)
+
+_TIMEOUT = 30.0
+
+
+def _member_ids(groups: list[DigestGroup]) -> set[int]:
+	return {m.id for g in groups for m in g.members if m.id is not None}
+
+
+def _digest_filename(digest: Digest) -> str:
+	# Local time in the human-facing filename; UTC is kept internally on the digest.
+	local = digest.generated_at.astimezone()
+	return f"android-watcher-digest-{local:%d%m%Y-%H%M%S}.html"
+
+
+def _write_html(digest: Digest) -> Path:
+	out_dir = Path(digests_dir())
+	out_dir.mkdir(parents=True, exist_ok=True)
+	path = out_dir / _digest_filename(digest)
+	path.write_text(render_html(digest), encoding="utf-8")
+	return path
+
+
+def _summary(digest: Digest) -> str:
+	"""Counts only — never raw page titles, which come from untrusted sources."""
+	n = digest.change_count()
+	g = len(digest.groups)
+	return f"{n} change{'' if n == 1 else 's'} across {g} group{'' if g == 1 else 's'}"
+
+
+def _notify(title: str, message: str, path: Path, sound: str) -> None:
+	if sys.platform == "darwin":
+		argv = [
+			"terminal-notifier",
+			"-title",
+			title,
+			"-message",
+			message,
+			"-sound",
+			sound,
+			"-group",
+			"android-watcher",
+			# The path is app-generated; quote it so a space in the data dir is safe.
+			"-execute",
+			f"open {shlex.quote(str(path))}",
+		]
+	elif sys.platform.startswith("linux"):
+		# notify-send has no portable click-to-run action; show the digest URI instead.
+		argv = ["notify-send", title, f"{message}\n{path.as_uri()}"]
+	else:  # pragma: no cover - guarded earlier by desktop_mechanism_available()
+		raise NotifyError(f"desktop notifications unsupported on {sys.platform!r}")
+	try:
+		subprocess.run(argv, check=True, capture_output=True, timeout=_TIMEOUT)
+	except FileNotFoundError as exc:
+		raise NotifyError(f"desktop notifier binary not found: {argv[0]}") from exc
+	except subprocess.CalledProcessError as exc:
+		raise NotifyError(f"{argv[0]} exited {exc.returncode}") from exc
+	except subprocess.TimeoutExpired as exc:
+		raise NotifyError(f"{argv[0]} timed out after {_TIMEOUT}s") from exc
+
+
+@NOTIFIERS.register("desktop")
+class DesktopNotifier:
+	name = "desktop"
+
+	def send(self, digest: Digest, config: Config) -> set[int]:
+		# Notify only when there is something to show; no daily empty-digest pop.
+		if not digest.groups:
+			return set()
+		if not desktop_mechanism_available():
+			raise NotifyError("no desktop notification mechanism available")
+		path = _write_html(digest)
+		logger.info("desktop: wrote digest page %s; firing notification", path)
+		_notify("Android Watcher", _summary(digest), path, config.desktop.sound)
+		return _member_ids(digest.groups)

{android_watcher-1.0.0 → android_watcher-1.0.2}/src/android_watcher/run.py

@@ -97,6 +97,8 @@ def _enabled_channels(config: Config) -> set[str]:
 		channels.add("slack")
 	if config.telegram.enabled:
 		channels.add("telegram")
+	if config.desktop.enabled:
+		channels.add("desktop")
 	return channels
 
 

{android_watcher-1.0.0 → android_watcher-1.0.2}/src/android_watcher/schedule.py

@@ -166,8 +166,18 @@ def _calendar_intervals(sched: ScheduleConfig) -> list[dict[str, int]]:
 	raise ScheduleError(f"unknown interval {sched.interval!r}")
 
 
-def render_plist(label: str, program_args: list[str], sched: ScheduleConfig) -> str:
-	"""Render a launchd plist string for the given label, args, and schedule."""
+def render_plist(
+	label: str,
+	program_args: list[str],
+	sched: ScheduleConfig,
+	path_env: str | None = None,
+) -> str:
+	"""Render a launchd plist string for the given label, args, and schedule.
+
+	A launchd job inherits a bare PATH (``/usr/bin:/bin:/usr/sbin:/sbin``), so
+	when *path_env* is given it is embedded as ``EnvironmentVariables/PATH`` —
+	without it the run cannot reach the ``claude`` CLI for triage.
+	"""
 	intervals = _calendar_intervals(sched)
 	payload: dict[str, object] = {
 		"Label": label,
@@ -175,6 +185,8 @@ def render_plist(label: str, program_args: list[str], sched: ScheduleConfig) ->
 		"RunAtLoad": False,
 		"StartCalendarInterval": intervals[0] if len(intervals) == 1 else intervals,
 	}
+	if path_env:
+		payload["EnvironmentVariables"] = {"PATH": path_env}
 	return plistlib.dumps(payload, sort_keys=True).decode("utf-8")
 
 
@@ -231,15 +243,22 @@ def _on_calendar(sched: ScheduleConfig, tz: str) -> str:
 	raise ScheduleError(f"unknown interval {sched.interval!r}")
 
 
-def render_service(exec_path: str, args: list[str]) -> str:
-	"""Render a systemd .service unit for android-watcher."""
+def render_service(exec_path: str, args: list[str], path_env: str | None = None) -> str:
+	"""Render a systemd .service unit for android-watcher.
+
+	systemd user services start from a minimal PATH, so when *path_env* is given
+	it is embedded as ``Environment=PATH=`` — without it the run cannot reach the
+	``claude`` CLI for triage.
+	"""
 	exec_start = " ".join([exec_path, *args])
+	env_line = f"Environment=PATH={path_env}\n" if path_env else ""
 	return (
 		"[Unit]\n"
 		"Description=android-watcher scheduled run\n"
 		"\n"
 		"[Service]\n"
 		"Type=oneshot\n"
+		f"{env_line}"
 		f"ExecStart={exec_start}\n"
 	)
 
@@ -281,10 +300,18 @@ def _cron_line(sched: ScheduleConfig) -> str:
 	return _cron_lines(sched)[0]
 
 
-def render_crontab(line_command: str, sched: ScheduleConfig, tz: str) -> str:
-	"""Render a marked crontab block for android-watcher (one line per scheduled time)."""
+def render_crontab(
+	line_command: str, sched: ScheduleConfig, tz: str, path_env: str | None = None
+) -> str:
+	"""Render a marked crontab block for android-watcher (one line per scheduled time).
+
+	cron runs with a minimal PATH, so when *path_env* is given a ``PATH=``
+	assignment is emitted ahead of the schedule lines — without it the run cannot
+	reach the ``claude`` CLI for triage.
+	"""
 	body = "\n".join(f"{spec} {line_command}" for spec in _cron_lines(sched))
-	return f"{CRON_BEGIN}\nCRON_TZ={tz}\n{body}\n{CRON_END}\n"
+	path_line = f"PATH={path_env}\n" if path_env else ""
+	return f"{CRON_BEGIN}\nCRON_TZ={tz}\n{path_line}{body}\n{CRON_END}\n"
 
 
 # ---------------------------------------------------------------------------
@@ -319,6 +346,17 @@ def _program_args() -> list[str]:
 	return [exe, "run"]
 
 
+def _env_path() -> str:
+	"""Snapshot the install-time PATH to embed in the scheduled unit.
+
+	Native schedulers (launchd, systemd user, cron) run with a minimal PATH that
+	omits per-user bin dirs like ``~/.local/bin``, so the ``claude`` CLI would be
+	unreachable. Capturing the PATH from the shell that ran the install preserves
+	parity with the environment where ``claude`` was found.
+	"""
+	return os.environ.get("PATH", "")
+
+
 def _launchd_plist_path() -> str:
 	return str(Path.home() / "Library" / "LaunchAgents" / f"{LAUNCHD_LABEL}.plist")
 
@@ -357,7 +395,7 @@ def _run(argv: list[str], *, input: str | None = None) -> subprocess.CompletedPr
 def _install_macos(config: Config) -> None:
 	path = Path(_launchd_plist_path())
 	path.parent.mkdir(parents=True, exist_ok=True)
-	path.write_text(render_plist(LAUNCHD_LABEL, _program_args(), config.schedule))
+	path.write_text(render_plist(LAUNCHD_LABEL, _program_args(), config.schedule, _env_path()))
 	_run(["launchctl", "unload", str(path)])
 	_run(["launchctl", "load", "-w", str(path)])
 	_warn(
@@ -370,7 +408,7 @@ def _install_systemd(config: Config) -> None:
 	d = Path(_systemd_dir())
 	d.mkdir(parents=True, exist_ok=True)
 	exe, *run_args = _program_args()
-	(d / f"{SYSTEMD_UNIT_NAME}.service").write_text(render_service(exe, run_args))
+	(d / f"{SYSTEMD_UNIT_NAME}.service").write_text(render_service(exe, run_args, _env_path()))
 	(d / f"{SYSTEMD_UNIT_NAME}.timer").write_text(render_timer(config.schedule, _local_tz()))
 	_run(["systemctl", "--user", "daemon-reload"])
 	_run(["systemctl", "--user", "enable", "--now", f"{SYSTEMD_UNIT_NAME}.timer"])
@@ -400,7 +438,7 @@ def _strip_cron_block(text: str) -> str:
 
 def _install_crontab(config: Config) -> None:
 	existing = _run(["crontab", "-l"]).stdout
-	block = render_crontab(" ".join(_program_args()), config.schedule, _local_tz())
+	block = render_crontab(" ".join(_program_args()), config.schedule, _local_tz(), _env_path())
 	cleaned = _strip_cron_block(existing)
 	new = (cleaned.rstrip("\n") + "\n" if cleaned.strip() else "") + block
 	_run(["crontab", "-"], input=new)

{android_watcher-1.0.0 → android_watcher-1.0.2}/src/android_watcher/tui/configio.py

@@ -15,12 +15,14 @@ from android_watcher.config import (
 	AIConfig,
 	Config,
 	ConfigError,
+	DesktopChannel,
 	DigestConfig,
 	EmailChannel,
 	ScheduleConfig,
 	SlackChannel,
 	TelegramChannel,
 	config_path,
+	desktop_mechanism_available,
 	load_config,
 )
 from android_watcher.models import Source
@@ -136,6 +138,12 @@ def config_to_toml(config: Config) -> str:
 	lines.append(f"chat_id = {_toml_str(tg.chat_id)}")
 	lines.append("")
 
+	ds = config.desktop
+	lines.append("[channels.desktop]")
+	lines.append(f"enabled = {'true' if ds.enabled else 'false'}")
+	lines.append(f"sound = {_toml_str(ds.sound)}")
+	lines.append("")
+
 	for s in config.custom_sources:
 		lines.append(_source_table("custom_source", s))
 
@@ -173,8 +181,16 @@ def validate_config(config: Config) -> list[str]:
 		errors.append(str(exc))
 	finally:
 		os.unlink(tmp)
-	if not (config.email.enabled or config.slack.enabled or config.telegram.enabled):
-		errors.append("enable at least one delivery channel (Slack or Telegram) to receive digests")
+	if not (
+		config.email.enabled
+		or config.slack.enabled
+		or config.telegram.enabled
+		or config.desktop.enabled
+	):
+		errors.append(
+			"enable at least one delivery channel (Email, Slack, Telegram, or Desktop) "
+			"to receive digests"
+		)
 	sl = config.slack
 	if sl.enabled and not (sl.bot_token and sl.channel):
 		errors.append("slack channel is enabled but bot_token + channel are required")
@@ -183,6 +199,11 @@ def validate_config(config: Config) -> list[str]:
 		errors.append("telegram channel is enabled but bot_token is empty")
 	if tg.enabled and not tg.chat_id:
 		errors.append("telegram channel is enabled but chat_id is empty")
+	if config.desktop.enabled and not desktop_mechanism_available():
+		errors.append(
+			"desktop channel is enabled but no notifier is available "
+			"(install terminal-notifier on macOS or notify-send on Linux)"
+		)
 	if _in_git_worktree(config_path()):
 		errors.append(
 			f"warning: config path {config_path()} is inside a git work tree; "
@@ -209,6 +230,7 @@ def load_or_default() -> tuple[Config, bool]:
 		email=EmailChannel(),
 		slack=SlackChannel(),
 		telegram=TelegramChannel(),
+		desktop=DesktopChannel(),
 		custom_sources=[],
 		enabled_source_ids=set(),
 	)