dotfiles/docs/superpowers/plans/2026-05-11-power-profile-fan-trigger.md

Power-Profile → Fan-Profile Sync Trigger Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Make scripts/power-profile.sh --menu instantly trigger scripts/fan-profile.sh to re-evaluate (so fan auto mode applies the new mapping in under a second instead of waiting for the next 5 s waybar poll).

Architecture: One-line change. Chain pkill -RTMIN+9 waybar (the fan widget's signal) onto the existing pkill -RTMIN+8 waybar after powerprofilesctl set succeeds. Reuses the existing single-source-of-truth mapping in fan-profile.sh::map_profile_to_strategy — no new logic, no new files.

Tech Stack: bash, waybar (signal: mechanism), powerprofilesctl, pkill -RTMIN+N.

Spec: docs/superpowers/specs/2026-05-11-power-profile-fan-trigger-design.md

Verification model: Bash syntax check covers static correctness; end-to-end behaviour requires a live waybar + active power profile change (controller verifies after merge). One task only.

---

File Structure

File	Change
scripts/power-profile.sh	One line modified (line 13): chain && pkill -RTMIN+9 waybar onto the existing &&-chained command.

No new files. No other files touched.

---

Task 1: Add fan-widget signal to power-profile menu handler

After this task, picking a power profile from the wofi menu fires both the power-widget refresh signal (RTMIN+8) and the fan-widget refresh signal (RTMIN+9). The fan widget's existing handler (in fan-profile.sh) checks the auto-mode sentinel and applies the mapped fw-fanctrl strategy if appropriate.

Files:

• Modify: scripts/power-profile.sh (line 13)

• Step 1: Make the one-line change

Find line 13 in scripts/power-profile.sh:

    [ -n "$CHOICE" ] && powerprofilesctl set "$CHOICE" && pkill -RTMIN+8 waybar

Replace with:

    [ -n "$CHOICE" ] && powerprofilesctl set "$CHOICE" && pkill -RTMIN+8 waybar && pkill -RTMIN+9 waybar

The only change: append && pkill -RTMIN+9 waybar to the end of the existing chain. Indentation, surrounding lines, and the if/exit block remain untouched.

• Step 2: Syntax-check the script

bash -n scripts/power-profile.sh && echo "syntax ok"

Expected: syntax ok and exit 0.

• Step 3: Confirm both signals appear in the chain

grep -n "pkill -RTMIN" scripts/power-profile.sh

Expected output (one line, both signals present):

13:    [ -n "$CHOICE" ] && powerprofilesctl set "$CHOICE" && pkill -RTMIN+8 waybar && pkill -RTMIN+9 waybar

• Step 4: Confirm the status-emit branch is unchanged

sed -n '17,27p' scripts/power-profile.sh

Expected: shows the CURRENT=$(powerprofilesctl get) block, case "$CURRENT" in ... esac, and printf JSON line — all byte-identical to before this commit.

• Step 5: End-to-end smoke test (controller — subagent skip)

Subagents have no display; skip this step. The controller will:

# Confirm both waybar signals are wired up correctly
powerprofilesctl get                              # note current profile
~/.local/bin/power-profile --menu                 # pick a different profile in wofi
powerprofilesctl get                              # confirm it changed
fw-fanctrl print | grep '^Strategy:'              # if fan auto is on, this should match the mapped strategy within ~1 s

If fan auto is off (~/.local/state/fan-profile-auto does not exist), fw-fanctrl strategy stays unchanged — that's the correct behaviour for Option C.

• Step 6: Commit

git add scripts/power-profile.sh
git commit -m "power-profile: signal fan widget on profile change"

---

Final verification (controller, post-merge)

• With fan auto on: change power profile via the wofi menu → fan strategy follows within ~1 s (fw-fanctrl print | grep ^Strategy: shows the mapped value).
• With fan auto off: change power profile via the wofi menu → fan strategy unchanged (fw-fanctrl print | grep ^Strategy: shows the previously-set manual value).
• If powerprofilesctl set fails (simulate by stubbing powerprofilesctl in PATH to return exit 1), neither pkill fires — journalctl --user -u waybar shows no spurious refreshes.