trackerkeeper 0.1.1__tar.gz → 0.1.2__tar.gz

{trackerkeeper-0.1.1/trackerkeeper.egg-info → trackerkeeper-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trackerkeeper
-Version: 0.1.1
+Version: 0.1.2
 Summary: One dashboard for software & firmware updates across everything you own
 Author-email: august <augustvontrips@gmail.com>
 License: GPL-2.0-or-later

{trackerkeeper-0.1.1 → trackerkeeper-0.1.2}/docs/CHANGELOG.md

@@ -11,6 +11,79 @@ no matching section). See `docs/RELEASING.md`.
 
 ## [Unreleased]
 
+## [0.1.2] — 2026-07-26
+
+The looks pass. tracker keeper stops wearing dough's placeholder, learns to tell
+you *what* changed rather than only *that* something did, and becomes usable at
+the 300px width it always advertised.
+
+### Added
+- **A real logo, and a brand accent to match.** The first two releases shipped
+  wearing dough's placeholder blob. The mark is a refresh wheel closing on a
+  check — the ring is the update cycle, the check is "you're current" — with the
+  gap and arrowhead in the bottom-right, the one quadrant the check's diagonal
+  never crosses. One accent throughout, because a two-tone draft put a
+  near-white check on the ring that vanished on light backgrounds. The default
+  accent moves from dough's violet to the brand green `#2fbe8a` (already the
+  "Green" preset), so a fresh profile's chrome matches its own icon.
+- **Per-item detail.** Click any card to see what actually changed — the release
+  notes the checkers were already fetching and throwing away. GitHub's release
+  body, Steam's announcement, the App Store's "What's New", Flathub's release
+  description and any RSS entry's body all land here, normalised to plain text.
+  A source that structurally can't carry notes (a package index, an ISO mirror)
+  says so rather than showing an empty box.
+
+  Notes render as **plain text, never rich text**: the body is written by a
+  third party, and handing arbitrary remote HTML to a Qt rich-text widget would
+  pull in remote images and let a stranger control the markup. The changelog
+  link still goes to the fully formatted original.
+
+### Changed
+- **The fleet list has a foreground.** A card had two states — pending or not —
+  so a month-old update looked exactly like one from an hour ago, and every row
+  wore the same green. Now there are three: **fresh** (an update inside a week)
+  leads with a full-white name and the accent on the dot, the new build and the
+  changelog link; **pending but older** keeps its dot and its *mark updated*
+  button — it's still yours to install — but eases back to neutral; **current**
+  sits quietest of all.
+- **One accent, not two near-identical greens.** The "new" colour (`#56c48d`)
+  sat a few points off the accent (`#2fbe8a`) while meaning something different,
+  which read as a printing error rather than a distinction. The accent is now
+  the single colour meaning *live news*, and card tints derive from whatever
+  accent is active rather than a frozen hex — so picking another accent
+  recolours the list properly.
+- **Category sections read as sections.** A dim caps label over a flat run of
+  cards left the groups blending into one list. The header is brighter and
+  carries a hairline rule, the cards step in beneath it, and sections are
+  separated by a gap.
+- **The app name reads in full at every width.** The title steps down the type
+  ladder as the bar tightens (subhead → body → caption) instead of eliding, and
+  the update badge shortens with it — `· 3 updates available`, then `· 3 new`,
+  then just `· 3`. At 300px the app's own name is worth more of that row than
+  two extra words.
+
+### Fixed
+- **The app is legible at its minimum width.** At 300px the fleet list was
+  unusable: names chopped to `Stea` / `Game` / `Slay`, versions to `202607`, the
+  age column showing `hours ago` with the number cut off the front, and the title
+  reading `tracker keepeı`. Four causes: `QLabel` clips instead of eliding (there
+  is now a shared `ui_helpers.ElidedLabel`); the name shared one rich-text label
+  with the platform tag, so the name was what disappeared; the full-text
+  *changelog →* and *mark updated* buttons cost ~175px of a 430px row and are now
+  a `→` and a `✓` below the widest tier; and the age column gets compact forms
+  (`13h`, `4d`, `2w`, `3mo`) that fit whole, with the full phrase on hover.
+- **An empty update badge no longer reserves space.** Its width floor was
+  computed once per layout tier from whatever text happened to be there, so a
+  badge that later emptied out kept holding ~59px — and the title paid for it,
+  eliding beside an invisible label occupying a sixth of the bar.
+- The Steam checker asked for `maxlength=1`, truncating every announcement body
+  to a single character — invisible while only the title was read, and exactly
+  what the detail view needed.
+- **The visual baseline was guarding a screen users never see.** The rig grabbed
+  dough's placeholder canvas rather than the app's own first screen, so the
+  golden would have passed through any dashboard regression. Fixed upstream in
+  dough, so every app built from it gets a baseline that tracks its real UI.
+
 ## [0.1.1] — 2026-07-25
 
 The watchtower actually watches now. v0.1.0 only checked at launch, so a

{trackerkeeper-0.1.1 → trackerkeeper-0.1.2}/dough-sync.toml

@@ -4,7 +4,7 @@
 # The dough commit this loaf was last reconciled against. `--record` stamps it.
 # Seeded to dough HEAD at init; set it to the commit you actually forked from if
 # you want the first sync to surface everything dough changed since.
-synced_from = "36b09a3"
+synced_from = "f51c08b"
 
 # Files (relative to the trackerkeeper/ package dir) the fork OWNS — net-new app code or
 # modules it fully rewrote. Sync never reads or writes these.
@@ -13,6 +13,7 @@ authored = [
     "sources.py",      # the update-checker provider engine — net-new
     "dashboard.py",    # the fleet dashboard UI — net-new
     "item_dialog.py",  # the add/edit-item form — net-new
+    "detail_dialog.py",# the per-item release-notes view — net-new
     "tray.py",         # the system-tray presence (watchtower resting state) — net-new
 ]
 
@@ -22,4 +23,11 @@ manual = [
     "app.py",       # main() wires the dashboard as run_app content (not the placeholder)
     "identity.py",  # display_name "tracker keeper" — the whole-word transform would regress it
     "top_bar.py",   # hamburger + left settings + the add_action/title-slot API the dashboard folds into
+    # These three were UNCLASSIFIED while carrying local changes, which meant the
+    # next `--apply` would have silently reverted them — the drift report read
+    # +0/-79, +0/-5, +1/-11, i.e. pure loss. Classify a file the moment you
+    # customize it; the sync door assumes anything unlisted is dough's to own.
+    "settings_dialog.py",  # the TRACKING section (check interval + the tray toggles)
+    "bus.py",              # AppBus.tracking_prefs_changed — Settings re-arms the live heartbeat
+    "rig.py",              # baseline grabs the app's real content, not dough's placeholder
 ]

{trackerkeeper-0.1.1 → trackerkeeper-0.1.2}/tests/test_dashboard.py

@@ -338,3 +338,264 @@ def test_error_text_separates_the_two_failures():
     assert "check the handle" in error_text(sources.NOT_FOUND)
     assert "couldn't reach" in error_text(sources.UNREACHABLE)
     assert "couldn't reach" in error_text("")   # unknown -> the conservative read
+
+
+def test_results_store_the_release_notes(qapp):
+    dash = _dash(qapp, [catalog.Item(name="G", kind="github", installed="1.0")])
+    dash._on_results({"G": CheckResult(latest="1.1", date="2026-07-25",
+                                       notes="• Fixed a thing")})
+    assert dash._items[0].latest_notes == "• Fixed a thing"
+    assert catalog.load()[0].latest_notes == "• Fixed a thing"   # persisted
+
+
+def test_detail_dialog_builds_and_explains_an_empty_body(qapp):
+    from trackerkeeper.detail_dialog import DetailDialog
+
+    # a source that structurally cannot carry notes must SAY so, not show a blank
+    d = DetailDialog(item=catalog.Item(name="KDE", kind="arch", ref="plasma-desktop",
+                                       installed="6.7.3-1", latest="6.7.3-1"))
+    assert "package index" in d._no_notes_reason()
+    d2 = DetailDialog(item=catalog.Item(name="G", kind="github", installed="1.0",
+                                        latest="1.1", latest_notes="• Fixed"))
+    assert d2._item.latest_notes == "• Fixed"
+
+
+def test_detail_dialog_mark_updated_mutates_the_item(qapp):
+    from trackerkeeper.detail_dialog import DetailDialog
+
+    item = catalog.Item(name="G", kind="github", installed="1.0", latest="1.1")
+    d = DetailDialog(item=item)
+    d._on_mark()
+    assert item.installed == "1.1" and not item.has_update()
+    assert d._marked is True    # so prompt() reports "marked" and the caller saves
+
+
+# ── fresh vs past: the visual hierarchy ──────────────────────────────────────
+
+
+def test_is_fresh_tracks_the_release_date_not_just_pending():
+    from datetime import datetime, timedelta, timezone
+
+    from trackerkeeper.dashboard import FRESH_DAYS, is_fresh
+
+    now = datetime(2026, 7, 26, tzinfo=timezone.utc)
+
+    def at(days):
+        return (now - timedelta(days=days)).strftime("%Y-%m-%d")
+
+    pending_new = catalog.Item(name="a", installed="1", latest="2", latest_date=at(1))
+    pending_old = catalog.Item(name="b", installed="1", latest="2",
+                               latest_date=at(FRESH_DAYS + 1))
+    current = catalog.Item(name="c", installed="2", latest="2", latest_date=at(0))
+
+    assert is_fresh(pending_new, now)
+    assert not is_fresh(pending_old, now)   # still yours to install, no longer news
+    assert not is_fresh(current, now)       # nothing to do at all
+
+
+def test_an_update_with_no_date_counts_as_fresh():
+    """Greying out something actionable on a guess is the worse failure."""
+    from trackerkeeper.dashboard import is_fresh
+
+    assert is_fresh(catalog.Item(name="a", installed="1", latest="2"))
+
+
+def test_only_fresh_cards_take_the_accent_wash(qapp):
+    from trackerkeeper.dashboard import _card_qss
+
+    plain, washed = _card_qss(False), _card_qss(True)
+    assert plain != washed
+    assert "255,255,255" in plain          # neutral
+    assert "255,255,255" not in washed     # accent-tinted
+
+
+def test_card_tint_follows_the_live_accent(qapp):
+    """Hardcoding the brand green would strand anyone who picks another accent."""
+    from trackerkeeper import ui_helpers
+    from trackerkeeper.dashboard import _card_qss, _rgba
+
+    assert _rgba("#2fbe8a", 0.08) == "rgba(47,190,138,0.08)"
+    assert _rgba("", 0.5).startswith("rgba(255,255,255")   # malformed → safe neutral
+    r, g, b = (int(ui_helpers.ACCENT.lstrip("#")[i:i + 2], 16) for i in (0, 2, 4))
+    assert f"rgba({r},{g},{b}," in _card_qss(True)
+
+
+# ── legibility at the minimum width ──────────────────────────────────────────
+
+
+def test_elided_label_shortens_with_an_ellipsis_not_a_chop(qapp):
+    from trackerkeeper.ui_helpers import ElidedLabel
+
+    lab = ElidedLabel("SteamOS (Armada)")
+    lab.show()          # Qt defers resize events for hidden widgets
+    lab.resize(40, 20)
+    assert lab.text() != "SteamOS (Armada)"
+    assert lab.text().endswith("…")          # not "Stea"
+    assert lab.full_text() == "SteamOS (Armada)"
+    lab.resize(400, 20)
+    assert lab.text() == "SteamOS (Armada)"  # room again → whole string back
+
+
+def test_elided_label_sizehint_reports_the_FULL_text(qapp):
+    """The feedback loop that made a title read "trac…" on a roomy bar: eliding
+    shrinks QLabel's own sizeHint, so the layout hands it less, so it elides
+    harder. The hint has to describe the full string."""
+    from trackerkeeper.ui_helpers import ElidedLabel
+
+    lab = ElidedLabel("a very long application title indeed")
+    lab.show()
+    wide = lab.sizeHint().width()
+    lab.resize(30, 20)                       # force a hard elide
+    assert lab.text().endswith("…")
+    assert lab.sizeHint().width() == wide    # unchanged by what's painted
+
+
+def test_elided_label_minimum_does_not_grow_with_its_text(qapp):
+    """QLabel's default minimumSizeHint tracks the text and would put a floor
+    under the whole row — the reason a long name could block the resize."""
+    from trackerkeeper.ui_helpers import ElidedLabel
+
+    short, long = ElidedLabel("hi"), ElidedLabel("x" * 400)
+    assert long.minimumSizeHint().width() == short.minimumSizeHint().width()
+
+
+def test_short_age_keeps_the_number(qapp):
+    """The narrow tier rendered the full phrase into a 62px box, which cut the
+    NUMBER off and left "hours ago" — the half carrying no information."""
+    from datetime import datetime, timedelta, timezone
+
+    from trackerkeeper.dashboard import humanize_age_short
+
+    now = datetime(2026, 7, 26, 12, tzinfo=timezone.utc)
+
+    def ago(**kw):
+        return (now - timedelta(**kw)).strftime("%Y-%m-%dT%H:%M:%SZ")
+
+    assert humanize_age_short(ago(minutes=30), now) == "30m"
+    assert humanize_age_short(ago(hours=13), now) == "13h"
+    assert humanize_age_short(ago(days=4), now) == "4d"
+    assert humanize_age_short(ago(days=21), now) == "3w"
+    assert humanize_age_short(ago(days=90), now) == "3mo"
+    assert humanize_age_short(ago(days=800), now) == "2y"
+    assert humanize_age_short("", now) == ""
+    # every form stays inside the narrow column's budget
+    for v in ("30m", "13h", "4d", "3w", "3mo", "2y"):
+        assert len(v) <= 3
+
+
+# ── category sections ────────────────────────────────────────────────────────
+
+
+def test_group_header_carries_a_rule(qapp):
+    from trackerkeeper.dashboard import GROUP_RULE, _GroupHeader
+
+    h = _GroupHeader("GAMING", lambda: None)
+    assert "border-bottom" in h.styleSheet()
+    assert GROUP_RULE in h.styleSheet()
+
+
+def test_cards_are_indented_under_their_category_but_not_when_cramped(qapp):
+    from trackerkeeper.dashboard import GROUP_INDENT, TIER_NARROW, TIER_WIDE
+
+    dash = _dash(qapp, _grouped_fleet())
+    card = dash._card(dash._items[0])
+
+    dash._tier = TIER_WIDE
+    holder = dash._indent(card)
+    assert holder is not card                                  # wrapped
+    assert holder.layout().contentsMargins().left() == GROUP_INDENT
+
+    dash._tier = TIER_NARROW
+    # at the minimum width every pixel is already spoken for — no indent
+    assert dash._indent(dash._card(dash._items[1])) is not None
+    assert dash._indent(card) is card
+
+
+def test_sections_are_separated_by_a_gap(qapp):
+    from trackerkeeper.dashboard import save_collapsed
+
+    save_collapsed(set())
+    try:
+        dash = _dash(qapp, _grouped_fleet())   # two categories: Gaming, PC
+        dash._grouped = True
+        dash._render()
+        # header + cards for both groups, plus ONE spacer between them and the
+        # trailing stretch — a gap only ever appears BETWEEN sections.
+        spacers = sum(1 for i in range(dash._list.count())
+                      if dash._list.itemAt(i).spacerItem() is not None)
+        assert spacers == 2      # the inter-section gap + the trailing stretch
+    finally:
+        save_collapsed(set())
+
+
+def test_an_empty_badge_reserves_no_width(qapp):
+    """The bug that elided the title to "trac…" on a 360px bar: the count's
+    width floor was computed once per tier from whatever text was there, so a
+    badge that later emptied out kept holding ~59px of the row."""
+    dash = _dash(qapp, [catalog.Item(name="A", kind="github", installed="1", latest="1")])
+    dash._render()
+    assert dash._count.text().strip() in ("", "· all current")
+    assert dash._count.minimumWidth() == 0
+
+
+def test_the_badge_gets_shorter_as_the_bar_tightens(qapp):
+    from trackerkeeper.dashboard import TIER_MEDIUM, TIER_NARROW, TIER_WIDE
+
+    dash = _dash(qapp, [catalog.Item(name="A", kind="github", installed="1", latest="2")])
+    seen = {}
+    for tier in (TIER_NARROW, TIER_MEDIUM, TIER_WIDE):
+        dash._tier = tier
+        dash._render()
+        seen[tier] = dash._count.text()
+    assert seen[TIER_NARROW] == "· 1"                 # just the number
+    assert "new" in seen[TIER_MEDIUM]
+    assert "available" in seen[TIER_WIDE]
+    # strictly shorter as it narrows — the app's name gets the difference
+    assert (len(seen[TIER_NARROW]) < len(seen[TIER_MEDIUM])
+            < len(seen[TIER_WIDE]))
+
+
+def test_the_title_is_not_starved_by_the_bar(qapp):
+    """The bug this guards: an empty badge reserved ~59px and the title elided
+    beside it. Asserts the MECHANISM, not a pixel outcome — how many characters
+    fit at a given width depends on the system font, and hard-coding this
+    machine's metrics fails on any platform with a wider one (it did: Windows
+    rendered "tracker…" where Linux fit the lot).
+
+    At a comfortable width the title must get everything it asks for."""
+    from trackerkeeper.dashboard import Dashboard
+    from trackerkeeper.window import AppWindow
+
+    catalog.save([catalog.Item(name=f"item {n}", kind="github", installed="1",
+                               latest="1", latest_date="2026-07-01") for n in range(6)])
+    win = AppWindow(title="tracker keeper")
+    win.set_content(Dashboard(win))
+    win.resize(900, 400)
+    win.show()
+    for _ in range(8):
+        qapp.processEvents()
+    title = win.top_bar.title
+    assert title.width() >= title.sizeHint().width()   # nothing is starving it
+    assert title.text() == title.full_text()           # …so nothing is elided
+    win.close()
+
+
+def test_the_title_shrinks_its_type_as_the_bar_tightens(qapp):
+    """The other half of fitting the name: step down the type ladder rather than
+    elide. Checked via the scale API so it holds whatever the system font is."""
+    from trackerkeeper.dashboard import TIER_MEDIUM, TIER_NARROW, TIER_WIDE, Dashboard
+    from trackerkeeper.top_bar import TopBar
+    from trackerkeeper.window import AppWindow
+
+    catalog.save([catalog.Item(name="A", kind="github", installed="1", latest="1")])
+    win = AppWindow(title="tracker keeper")
+    dash = Dashboard(win)
+    win.set_content(dash)
+    steps = {}
+    for tier in (TIER_WIDE, TIER_MEDIUM, TIER_NARROW):
+        dash._tier = tier
+        dash._apply_tier()
+        steps[tier] = getattr(win.top_bar, "_title_step", 0)
+    assert steps[TIER_WIDE] < steps[TIER_MEDIUM] < steps[TIER_NARROW]
+    assert steps[TIER_NARROW] <= len(TopBar.TITLE_STEPS) - 1
+    win.close()

{trackerkeeper-0.1.1 → trackerkeeper-0.1.2}/tests/test_sources.py

@@ -591,3 +591,84 @@ def test_flatpak_survives_a_junk_timestamp():
 def test_flatpak_rejects_a_ref_that_is_not_an_app_id():
     item = catalog.Item(name="X", kind="flatpak", ref="owner/repo")
     assert sources.check(item, _fake({})) is None
+
+
+# ── release notes ────────────────────────────────────────────────────────────
+
+
+def test_plain_notes_flattens_steam_bbcode():
+    raw = ("[b]BUG FIXES:[/b][list][*]Fixed a crash[*]Fixed plurals[/list]"
+           "[url=https://x]see more[/url]")
+    out = sources.plain_notes(raw)
+    assert "[" not in out and "]" not in out
+    assert "BUG FIXES:" in out
+    assert out.count("•") == 2
+    assert "see more" in out          # link TEXT survives, the markup doesn't
+
+
+def test_plain_notes_flattens_html_and_unescapes():
+    raw = "<p>Fixed &amp; improved</p><ul><li>one</li><li>two</li></ul>"
+    out = sources.plain_notes(raw)
+    assert "<" not in out
+    assert "Fixed & improved" in out
+    assert out.count("•") == 2
+
+
+def test_plain_notes_drops_steam_image_macros():
+    raw = "{STEAM_CLAN_IMAGE}/44971832/abc123.png Real content here"
+    assert sources.plain_notes(raw).strip() == "Real content here"
+
+
+def test_plain_notes_collapses_blank_lines_and_trims():
+    assert sources.plain_notes("a\n\n\n\n\nb   \n") == "a\n\nb"
+
+
+def test_plain_notes_truncates_with_a_pointer_to_the_changelog():
+    out = sources.plain_notes("x" * 9000)
+    assert len(out) < 9000
+    assert "truncated" in out
+
+
+def test_plain_notes_of_nothing_is_empty():
+    assert sources.plain_notes("") == ""
+    assert sources.plain_notes(None) == ""
+
+
+def test_github_captures_the_release_body():
+    item = catalog.Item(name="g", kind="github", ref="a/b")
+    http = _fake({"releases/latest": {"tag_name": "v2", "body": "## Fixed\r\n- a thing"}})
+    assert "Fixed" in sources.check(item, http).notes
+
+
+def test_appstore_captures_release_notes():
+    item = catalog.Item(name="a", kind="appstore", ref="123")
+    http = _fake({"itunes.apple.com": {"results": [
+        {"version": "3.5", "releaseNotes": "• Faster startup"}]}})
+    assert sources.check(item, http).notes == "• Faster startup"
+
+
+def test_flatpak_captures_the_release_description():
+    item = catalog.Item(name="f", kind="flatpak", ref="org.x.Y")
+    http = _fake({"flathub.org": {"releases": [
+        {"version": "1.0", "timestamp": "1767225600", "type": "stable",
+         "description": "<p>A hotfix</p>"}]}})
+    assert sources.check(item, http).notes == "A hotfix"
+
+
+def test_rss_prefers_the_full_body_over_the_teaser():
+    """content:encoded is the whole post; description is usually a blurb."""
+    feed = ("<rss><channel><item><title>Release 2.0</title><link>https://x/2</link>"
+            "<description>short blurb</description>"
+            "<content:encoded>the &lt;b&gt;full&lt;/b&gt; post</content:encoded>"
+            "</item></channel></rss>")
+    res = sources.check(_item(ref="https://x/feed"),
+                        http=_no_json, http_text=lambda u: feed)
+    assert "full" in res.notes and "blurb" not in res.notes
+
+
+def test_a_source_with_no_notes_is_simply_empty():
+    item = catalog.Item(name="k", kind="arch", ref="plasma-desktop")
+    http = _fake({"archlinux.org": {"results": [
+        {"pkgname": "plasma-desktop", "pkgver": "6.7.3", "pkgrel": "1",
+         "repo": "extra", "arch": "x86_64", "last_update": "2026-07-15T00:00:00Z"}]}})
+    assert sources.check(item, http).notes == ""

{trackerkeeper-0.1.1 → trackerkeeper-0.1.2}/trackerkeeper/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.1'
-__version_tuple__ = version_tuple = (0, 1, 1)
+__version__ = version = '0.1.2'
+__version_tuple__ = version_tuple = (0, 1, 2)
 
-__commit_id__ = commit_id = 'g49c3293d8'
+__commit_id__ = commit_id = 'g2f4ba77a9'

{trackerkeeper-0.1.1 → trackerkeeper-0.1.2}/trackerkeeper/app.py

@@ -445,11 +445,23 @@ def run_app(content_factory, *, identity=None, single_instance=True) -> int:
     return app.exec()
 
 
-def main() -> None:
-    """The default entry: boot tracker keeper with the update dashboard."""
+def content_factory():
+    """The factory :func:`main` hands to :func:`run_app` — the app's REAL first
+    screen, exposed as a seam so tooling can build it without booting.
+
+    The rig's visual baseline is the caller that matters: it used to grab
+    ``_placeholder()`` directly, so a loaf's goldens guarded dough's "your app
+    starts here" screen — a surface its users never see — and would have gone on
+    passing through any dashboard regression. Reading the factory from here means
+    the goldens track whatever the app actually shows."""
     from trackerkeeper.dashboard import build_content
 
-    sys.exit(run_app(build_content))
+    return build_content
+
+
+def main() -> None:
+    """The default entry: boot tracker keeper with the update dashboard."""
+    sys.exit(run_app(content_factory()))
 
 
 if __name__ == "__main__":

trackerkeeper-0.1.2/trackerkeeper/assets/trackerkeeper.svg

@@ -0,0 +1,23 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <!-- tracker keeper — a refresh wheel closing on a check.
+       The ring is the update cycle; the check is "you're current".
+
+       The gap and arrowhead sit BOTTOM-RIGHT: the check runs lower-left to
+       upper-right, so that quadrant is the one area it never crosses, and the
+       two elements never crowd each other. Every version that grew the check
+       ran its tip into the ring stroke instead.
+
+       ONE accent, ring and check at the same weight — an earlier two-tone draft
+       put a near-white check on the ring, which vanished completely on light
+       backgrounds.
+
+       This file is the single brand source: the .deb, AppImage, MSIX, macOS
+       iconset, Windows .ico and ui_helpers.make_app_icon() all derive from it. -->
+  <g transform="rotate(90 32 32)">
+    <path d="M49.7,14.3 A25,25 0 1,0 57,32" fill="none" stroke="#2fbe8a"
+          stroke-width="7" stroke-linecap="round"/>
+    <path d="M54,6 L59,25 L40,21 Z" fill="#2fbe8a"/>
+  </g>
+  <path d="M19,33 l10,10 l19,-21" fill="none" stroke="#2fbe8a" stroke-width="7"
+        stroke-linecap="round" stroke-linejoin="round"/>
+</svg>