← Commit history

settings consolidation (2.0.292): document taskbarActivity as the single taskbar-activity control; remove openFlash/autoFlash/agentActivity/fgWatch from pup-settings; note fgWatch folded into notMineCaption; off-screen-birth intro

John Lauer ·6719a001ea ·2mo ago ·parent b699097
2 files changed +11−10
skills/pup-settings/SKILL.md+7−8
@@ -71,18 +71,17 @@ the jump-list task, or the (off-by-default) corner pencil.  ## Foreground etiquette — pup never steals your screen -pup opens windows in the BACKGROUND and signals with a taskbar flash instead of stealing focus. When-an AI *does* raise a window, it must give a reason, shown on-screen.+pup opens windows in the BACKGROUND (off-screen birth, moved on-screen within 50ms so Chrome never+activates them) and signals it is working via the taskbar (`taskbarActivity`, default a progress bar)+instead of stealing focus. When an AI *does* raise a window, it must give a reason, shown on-screen+first, THEN it foregrounds.  | Key | Default | What it does | |---|---|---|-| `openFlash` | **on** | Flash the taskbar button (accent-colored) when a new pup window opens, so you notice it. |-| `autoFlash` | **on** | Flash a window's button when an AI changes it (navigate/click/type). One flash per burst. |-| `agentActivity` | **on** | Show a progress strip on a window's taskbar button while an AI is actively driving it. |-| `fgWatch` | **on** | For 20s after a background open/navigate, watch if something pulled the window to the front and re-park it. |+| `taskbarActivity` | **progress** | How pup signals it is WORKING on a window, on that window's taskbar button: `progress` = a determinate progress bar sized to the operation's running-average time (icon-apply on open, screenshots); `flash` = the old orange highlight (on open + on a mutating verb); `off` = nothing. This ONE control replaces the former `openFlash`, `autoFlash`, and `agentActivity` toggles. Full detail in the `pup-taskbar-progress` skill. | | `fgCaption` | **on** | When an AI brings a window to your screen, show its stated reason as an on-screen caption. |-| `fgCaptionMs` | **3500** | How long (ms) that foreground-reason caption shows. |-| `notMineCaption` | **off** | Low-importance: when a window fronts itself (JS/focus/Chrome, not pup), briefly caption that Adom did NOT do it. |+| `fgCaptionMs` | **2000** | How long (ms) that foreground-reason caption shows. |+| `notMineCaption` | **off** | The single self-foreground caption control (v2.0.292: folded in the old `fgWatch`). Off by default. When on, pup watches for ~20s after a background open/navigate and, if a window pulls ITSELF to the front (JS/focus/Chrome, not pup), briefly captions that Adom did NOT do it. The window is no longer re-parked — off-screen birth means pup no longer needs a foreground-steal watchdog; this is now purely the "not me" caption. |  ## Credential vault — pup manages your logins (no Chrome dialog) 
skills/pup-taskbar-progress/SKILL.md+4−2
@@ -47,8 +47,10 @@ Notes: - **Windows only.** macOS/Linux have no taskbar, so the setting is stored but inert. - A STOP of a leftover flash, and a human explicitly clicking "flash" in the dashboard, still work   regardless of the setting — only pup's own *automatic* flashes are gated off in `progress`/`off`.-- Independent of `agentActivity` (the broader "an AI is driving this window" indeterminate strip);-  `taskbarActivity` governs the determinate, operation-sized bar and whether the flash is used.+- **This is now the ONE taskbar-activity control.** As of v2.0.292 it absorbed the former separate+  `openFlash` (flash on open), `autoFlash` (flash on a mutating verb), and `agentActivity` ("an AI is+  driving this" strip) toggles — they are gone. `taskbarActivity: flash` gives the old open+mutate+  flashes; `progress` gives the determinate operation-sized bar; `off` gives neither.  ## Talk to pup