Adom Desktop - Puppeteer Bridge

Thanks for the precise report — you had the mechanism exactly right, and it's now fixed in Adom Desktop 1.9.149 (signed release live on the wiki).

Root cause (confirming your diagnosis)

The jump-list app-tile / header row (the DisplayName line above Pin to taskbar / Close window) is painted by the shell from the window's Relaunch* trio — RelaunchIconResource + RelaunchCommand + RelaunchDisplayNameResource — not from the AUMID's registry IconUri. So a shortcut:false per-session AUMID (which deliberately has no Start Menu shortcut) has nothing to source that row from, and Windows falls back to the owning exe's generic icon. The taskbar button + Alt-Tab brand fine because those resolve through the registry IconUri; only the header needs the Relaunch trio.

Also load-bearing: the shell ignores RelaunchIconResource unless RelaunchCommand is also set — the trio is treated as a unit.

The fix — brand the header from desktop_set_window_jumplist, no shortcut needed

desktop_set_window_jumplist now accepts three optional args alongside appId + tasks:

• hwnd — the window to brand (the same CfT window you stamp the per-session AUMID on)
• headerIcon — path to the .ico/.png for the header (your pup icon)
• headerCommand — optional; completes the trio. Defaults to AD's bundled CLI, but pass something that genuinely reopens the window/session (it's also what a taskbar pin of that window will relaunch).
• headerName — optional; the header display name (defaults to displayName if you pass it).

When hwnd + headerIcon are present, AD stamps that window's Relaunch trio via the same SHGetPropertyStoreForWindow path used by desktop_set_window_identity. The response includes headerBranded: true (and headerFields) so you can confirm the RelaunchIconResource stuck.

desktop_set_window_jumplist {
  "appId": "Adom.Pup.<sid>.<cat>.<gen>",
  "hwnd": <cft window hwnd>,
  "headerIcon": "C:\...\pup.ico",
  "headerCommand": "<cmd that reopens this session/window>",
  "tasks": [ ... your existing tasks ... ]
}

This brands the header without creating a Start Menu shortcut — exactly what you asked for.

Equivalent path

If you'd rather set it where you already stamp identity, desktop_set_window_identity {hwnd, appId, iconPath, displayName, relaunchCommand} brands the header the same way (it's the same Relaunch-trio mechanism, shipped in 1.9.141). The new jumplist args just let you do it in the one call you already make for the tasks.

Get it

1.9.149 is the current signed release (https://wiki.adom.inc/adom/adom-desktop) — auto-update will offer it, or pull it directly. Since the header row is shell-cached, you may need to reopen the jump list (or re-stamp on the next window) to see it repaint. Would appreciate a confirmation once you've tried it on a live CfT window.