← Commit history

Document jump-list title truncation, category task icons, and retiring adom-pup-browser3 with a family-matched default plus the ICO build method

John Lauer ·819ec689c6 · ·parent d932021
1 file changed +21
dev-skills/pup-bridge-debug/SKILL.md+21
@@ -403,3 +403,24 @@ Fix (v1.9.52): To purge historical orphans on a machine, delete pup-task `*.customDestinations-ms` files (they carry `browser_close` / `browser_wiki_set_view` in plaintext) older than a few minutes; live windows re-commit theirs within seconds.++## Jump-list task rows: short titles + the retired default icon (v1.9.53–55)++- **Title truncation.** Windows truncates a custom jump-list task label at ~30 chars at default DPI.+  "Adom wiki: switch to logged-in view" (35) clipped the important word ("...logged-in vi…"). Lead the+  TITLE with the action ("Switch to logged-in view" / "Switch to public view", ≤24 chars) and let the+  DESCRIPTION carry the "Adom wiki page" context — the description renders on its own line as the+  hover tooltip, untruncated. AD maps title→visible label, description→tooltip.+- **Task icon was the retired brand.** `updateWikiJumplist` set each task's iconPath from+  `pupIconPath()` (no arg) → PUP_ICON_DEFAULT → adom-pup-browser3.ico (the retired "P + card" pup+  mark). Use `pupIconPath(sessionId)` so the rows wear the window's own category icon (pup-cat-*9.ico).+- **Retiring adom-pup-browser3.ico everywhere.** It was also the fallback default (category-less+  windows + the base Adom Pup identity/Start Menu pin). Replaced PUP_ICON_DEFAULT with a new+  pup-cat-default9.ico that matches the teal-tile family (teal tile + dark-teal window body + neutral+  browser-chrome glyph, distinct from the 5 categories).+- **Building a taskbar ICO** (PIL is NOT enough — its ICO writer emitted a single 16px frame). The+  working category ICOs are 7 BMP frames (16/24/32/48/64/128/256, all 32bpp, ~360KB). Render each size+  with cairosvg and hand-pack the ICO (ICONDIR + ICONDIRENTRY + per-frame BITMAPINFOHEADER with+  height=2H for the XOR bitmap + 1bpp AND mask, BGRA bottom-up). `icotool`/`convert` are also present.+- Verify a task's committed icon+description by reading the CustomDestinations file (both are+  plaintext UTF-16); the TITLE lives in a serialized property-store blob and is not plainly greppable.