[TimeToBuildBob]

Summary

Carries #64 (@michaeljelly) onto current master. #64 diagnosed a real bug: the JXA script performs unguarded window lookups, so when the frontmost app has no window we can inspect, the script throws, the poll is dropped, and no heartbeat is sent.

That still matters: jxa is the only macOS strategy that can apply privacy_filter (the swift helper cannot and the watcher refuses to start), so the JXA path is now load-bearing for privacy-conscious users rather than just a legacy option.

What changed

• Guard the Safari document lookup, the Chrome-family tab lookup, and the Firefox window lookup.
• Read the frontmost process's AXTitle as a fallback (works for apps that don't support JXA scripting, and for windows not flagged AXMain).
• Always emit a title. The Python side indexes current_window["title"], so a missing key raised KeyError and skipped the heartbeat anyway.
• Apply the review feedback from Fixes "unknown" being returned when some apps open #64: 2-space indentation, no trailing whitespace, a single documented NO_WINDOW_TITLE constant, and a fallback that calls windows() instead of indexing the method (oProcess.windows[0] was undefined).

Verification

• node --check on the script body: syntax OK.
• Local mock harness (not committed; JXA is macOS-only) exercising 10 cases against the real script text: normal Safari/Chrome, Safari with no document, Chrome/Firefox with no window, non-scriptable app whose windows() throws, windows whose attribute access throws, AXMain title, first-window fallback. All 10 pass; every failure path yields a title instead of throwing.
• poetry run pytest -q: 158 passed.
• Not verified on macOS hardware — no access to a Mac here. A quick osascript -l JavaScript printAppStatus.jxa on a Mac with an unscriptable app frontmost would close that gap.

Attribution

Diagnosis and original approach by @michaeljelly in #64; review notes by @ErikBjare. This PR is the cleaned-up carry.

Ref #64

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; both previous findings are fixed and no new actionable issue was found.

Summary

Keeps macOS JXA polling alive when the frontmost app has no readable window.

• macOS window polls keep a title when a browser has no readable window.

Both previous findings are addressed. The harness passed locally; native macOS behavior remains unverified.

_{Reviews (2) · Last reviewed commit: "fix(macos): discard partial browser meta..." · Reviewed by Greptile}

[TimeToBuildBob]

@greptileai review

[TimeToBuildBob]

CI-green and mergeable (Greptile 5/5) — waiting only on a maintainer click.

This PR is ready to merge, but the bot has pull-only access to this repo and can't self-merge — surfacing it here so it isn't lost. The monitoring loop will stop re-flagging it now that this note is posted.