From 0510aafeb6c33c9de2e46628cbcce3e62b4e82a5 Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:07:44 -0700
Subject: [PATCH 01/10] Add design doc for configurable volume increment
 setting

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 ...6-04-05-volume-increment-setting-design.md | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md

diff --git a/docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md b/docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md
new file mode 100644
index 0000000..56a3a8f
--- /dev/null
+++ b/docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md
@@ -0,0 +1,48 @@
+# Volume Increment Setting — Design
+
+## Overview
+
+Expose the volume increment for the Volume Up and Volume Down actions as a configurable setting. A global default applies to all volume buttons; individual buttons can override it.
+
+## Requirements
+
+- Global default increment: `10` (min: `1`, no enforced max)
+- Per-button override: optional; absent means "use global"
+- Volume range hint displayed in UI: "Volume range: 0–100"
+- Fix manifest tooltips: "by 2" → "by 10"
+
+## Architecture
+
+### Global settings (`PiComponent.vue` + `PluginComponent.vue`)
+
+Add `adjustVolumeIncrement` to the global settings payload:
+
+- **PI (`PiComponent.vue`):** Add a number input in the Global Settings accordion, below the existing timeout/interval inputs. Label: "Volume Increment (Up/Down)". Helper text: "Volume range: 0–100". Min: 1.
+- **`saveGlobalSettings()`:** Include `adjustVolumeIncrement` in the payload saved via `streamDeckConnection.value.saveGlobalSettings()`.
+- **`PluginComponent.vue`:** On `globalsettings`, extract `inGlobalSettings.adjustVolumeIncrement` (defaulting to `10`) into a reactive ref `adjustVolumeIncrement`, mirroring the existing `deviceTimeoutDuration` pattern.
+
+### Per-button settings (`PiComponent.vue`)
+
+For `actionName === 'volume-up'` and `actionName === 'volume-down'`, show an action-specific section with a number input for `adjustVolumeIncrement`. Label: "Volume Increment". Helper: "Volume range: 0–100. Leave blank to use the global default." Min: 1. The field is optional — only written to `actionSettings` when the user provides a value; absent/null means inherit from global.
+
+The `saveSettings()` function already writes all `actionSettings` fields unconditionally. The per-button `adjustVolumeIncrement` should only be included when the user has set a value (i.e. the ref is non-null/non-empty).
+
+### Action handlers (`src/modules/actions/sonosController.js`)
+
+Add `globalAdjustVolumeIncrement` as a named parameter to `volume_up_action` and `volume_down_action`. Resolution:
+
+```js
+const increment = parseInt(inActionSettings.adjustVolumeIncrement) || globalAdjustVolumeIncrement;
+```
+
+Remove the existing `|| 10` fallback — the global value is always present.
+
+### Passing global value to actions (`PluginComponent.vue`)
+
+Where action handlers are called, pass `globalAdjustVolumeIncrement: adjustVolumeIncrement.value` alongside the existing `deviceTimeoutDuration`, mirroring that pattern exactly.
+
+## Manifest fix
+
+In `public/manifest.json`, update:
+- Volume Up `Tooltip`: `"Increase volume by 2"` → `"Increase volume by 10"`
+- Volume Down `Tooltip`: `"Decrease volume by 2"` → `"Decrease volume by 10"`

From c909e54623fcd2d07314af35549d7cb37dcce8fc Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:09:17 -0700
Subject: [PATCH 02/10] Update spec: remove hardcoded increment from manifest
 tooltips

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../specs/2026-04-05-volume-increment-setting-design.md     | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md b/docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md
index 56a3a8f..6f7125a 100644
--- a/docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md
+++ b/docs/superpowers/specs/2026-04-05-volume-increment-setting-design.md
@@ -43,6 +43,6 @@ Where action handlers are called, pass `globalAdjustVolumeIncrement: adjustVolum
 
 ## Manifest fix
 
-In `public/manifest.json`, update:
-- Volume Up `Tooltip`: `"Increase volume by 2"` → `"Increase volume by 10"`
-- Volume Down `Tooltip`: `"Decrease volume by 2"` → `"Decrease volume by 10"`
+In `public/manifest.json`, remove the hardcoded increment from both tooltips (it would become inaccurate once the setting is configurable):
+- Volume Up `Tooltip`: `"Increase volume by 2"` → `"Increase volume"`
+- Volume Down `Tooltip`: `"Decrease volume by 2"` → `"Decrease volume"`

From 210cbd4b2e79b89207385cc9d794c4229bbf620e Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:12:02 -0700
Subject: [PATCH 03/10] Add implementation plan for volume increment setting

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../2026-04-05-volume-increment-setting.md    | 438 ++++++++++++++++++
 1 file changed, 438 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-04-05-volume-increment-setting.md

diff --git a/docs/superpowers/plans/2026-04-05-volume-increment-setting.md b/docs/superpowers/plans/2026-04-05-volume-increment-setting.md
new file mode 100644
index 0000000..7bd821f
--- /dev/null
+++ b/docs/superpowers/plans/2026-04-05-volume-increment-setting.md
@@ -0,0 +1,438 @@
+# Volume Increment Setting 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:** Expose a configurable volume increment for Volume Up/Down actions, with a global default and optional per-button override.
+
+**Architecture:** Global `adjustVolumeIncrement` (default `10`) is stored in Stream Deck global settings and threaded through `PluginComponent.vue` to the action handlers. Per-button `adjustVolumeIncrement` is stored in each action's `actionSettings` and takes precedence when set. The PI for volume actions shows an optional override input; the Global Settings accordion shows the default input.
+
+**Tech Stack:** Vue 3, Vite, Stream Deck SDK (`@elgato/streamdeck`), Bootstrap 5
+
+---
+
+## File Map
+
+| File | Change |
+|------|--------|
+| `public/manifest.json` | Remove hardcoded "by 2" from Volume Up/Down tooltips |
+| `src/modules/actions/sonosController.js` | Add `globalAdjustVolumeIncrement` param to `volume_up_action` and `volume_down_action`; update increment resolution |
+| `src/components/PluginComponent.vue` | Extract `adjustVolumeIncrement` from global settings; pass to action call site |
+| `src/components/PiComponent.vue` | Add global increment setting UI + per-button override UI |
+
+---
+
+### Task 1: Fix manifest tooltips
+
+**Files:**
+- Modify: `public/manifest.json`
+
+- [ ] **Step 1: Update Volume Up tooltip**
+
+In `public/manifest.json`, find the Volume Up action (`"UUID": "com.r-teller.sonoscontroller.volume-up"`) and change its `Tooltip`:
+
+```json
+"Tooltip": "Increase volume",
+```
+
+- [ ] **Step 2: Update Volume Down tooltip**
+
+In the same file, find the Volume Down action (`"UUID": "com.r-teller.sonoscontroller.volume-down"`) and change its `Tooltip`:
+
+```json
+"Tooltip": "Decrease volume",
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add public/manifest.json
+git commit -m "fix: remove hardcoded increment value from volume action tooltips"
+```
+
+---
+
+### Task 2: Update action handlers to accept global increment
+
+**Files:**
+- Modify: `src/modules/actions/sonosController.js`
+
+There is no test suite in this project. Verify changes by building (`npm run build_dev`) and testing manually in Stream Deck.
+
+- [ ] **Step 1: Update `volume_up_action` signature and increment resolution**
+
+Find `volume_up_action` (currently starts around `export async function volume_up_action({`). Update its signature and the line that computes `updatedVolume`:
+
+Old signature:
+```js
+export async function volume_up_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1 }) {
+```
+
+New signature:
+```js
+export async function volume_up_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1, globalAdjustVolumeIncrement = 10 }) {
+```
+
+Old increment line (inside the function):
+```js
+parseInt(inSonosSpeakerState.audioEqualizer.volume) + (parseInt(inActionSettings.adjustVolumeIncrement) || 10),
+```
+
+New increment line:
+```js
+parseInt(inSonosSpeakerState.audioEqualizer.volume) + (parseInt(inActionSettings.adjustVolumeIncrement) || globalAdjustVolumeIncrement),
+```
+
+- [ ] **Step 2: Update `volume_down_action` signature and increment resolution**
+
+Find `volume_down_action`. Apply the same changes:
+
+Old signature:
+```js
+export async function volume_down_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1 }) {
+```
+
+New signature:
+```js
+export async function volume_down_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1, globalAdjustVolumeIncrement = 10 }) {
+```
+
+Old increment line:
+```js
+parseInt(inSonosSpeakerState.audioEqualizer.volume) - (parseInt(inActionSettings.adjustVolumeIncrement) || 10),
+```
+
+New increment line:
+```js
+parseInt(inSonosSpeakerState.audioEqualizer.volume) - (parseInt(inActionSettings.adjustVolumeIncrement) || globalAdjustVolumeIncrement),
+```
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add src/modules/actions/sonosController.js
+git commit -m "feat: add globalAdjustVolumeIncrement param to volume up/down actions"
+```
+
+---
+
+### Task 3: Thread global increment through PluginComponent
+
+**Files:**
+- Modify: `src/components/PluginComponent.vue`
+
+- [ ] **Step 1: Add reactive ref for global increment**
+
+Find the block of `const` refs at the top of `<script setup>` where `deviceTimeoutDuration` and `deviceCheckInterval` are declared:
+
+```js
+const deviceCheckInterval = ref(10);
+const deviceTimeoutDuration = ref(5);
+```
+
+Add `adjustVolumeIncrement` immediately after:
+
+```js
+const deviceCheckInterval = ref(10);
+const deviceTimeoutDuration = ref(5);
+const adjustVolumeIncrement = ref(10);
+```
+
+- [ ] **Step 2: Read global increment from global settings**
+
+Find the `globalsettings` handler block that reads `deviceCheckInterval` and `deviceTimeoutDuration`:
+
+```js
+deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
+deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
+```
+
+Add the new line immediately after:
+
+```js
+deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
+deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
+adjustVolumeIncrement.value = inGlobalSettings.adjustVolumeIncrement ?? 10;
+```
+
+- [ ] **Step 3: Pass global increment to the action call site**
+
+Find the `actionFunction` call inside `PluginComponent.vue` that currently passes `deviceTimeoutDuration`:
+
+```js
+const actionResult = await actionFunction({
+  inContext,
+  inActionSettings: settings,
+  inSonosSpeakerState: speaker.state,
+  inRotation,
+  deviceTimeoutDuration: deviceTimeoutDuration.value,
+});
+```
+
+Add `globalAdjustVolumeIncrement`:
+
+```js
+const actionResult = await actionFunction({
+  inContext,
+  inActionSettings: settings,
+  inSonosSpeakerState: speaker.state,
+  inRotation,
+  deviceTimeoutDuration: deviceTimeoutDuration.value,
+  globalAdjustVolumeIncrement: adjustVolumeIncrement.value,
+});
+```
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add src/components/PluginComponent.vue
+git commit -m "feat: thread globalAdjustVolumeIncrement from global settings to action handlers"
+```
+
+---
+
+### Task 4: Add global increment setting to PI
+
+**Files:**
+- Modify: `src/components/PiComponent.vue`
+
+- [ ] **Step 1: Add the `adjustVolumeIncrement` ref**
+
+Find where `deviceTimeoutDuration` and `deviceCheckInterval` refs are declared in `<script setup>`:
+
+```js
+const deviceCheckInterval = ref(10);
+const deviceTimeoutDuration = ref(5);
+```
+
+Add immediately after:
+
+```js
+const deviceCheckInterval = ref(10);
+const deviceTimeoutDuration = ref(5);
+const adjustVolumeIncrement = ref(10);
+```
+
+- [ ] **Step 2: Read the value from global settings**
+
+Find the `globalsettings` handler block that reads `deviceCheckInterval` and `deviceTimeoutDuration`:
+
+```js
+deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
+deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
+```
+
+Add immediately after:
+
+```js
+deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
+deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
+adjustVolumeIncrement.value = inGlobalSettings.adjustVolumeIncrement ?? 10;
+```
+
+- [ ] **Step 3: Include in `saveGlobalSettings()` payload**
+
+Find the `streamDeckConnection.value.saveGlobalSettings` call inside `saveGlobalSettings()`:
+
+```js
+streamDeckConnection.value.saveGlobalSettings({
+  payload: {
+    devices: getDevices.list,
+    deviceCheckInterval: deviceCheckInterval.value,
+    deviceTimeoutDuration: deviceTimeoutDuration.value,
+    favorites: getFavorites.list,
+  },
+});
+```
+
+Add `adjustVolumeIncrement`:
+
+```js
+streamDeckConnection.value.saveGlobalSettings({
+  payload: {
+    devices: getDevices.list,
+    deviceCheckInterval: deviceCheckInterval.value,
+    deviceTimeoutDuration: deviceTimeoutDuration.value,
+    adjustVolumeIncrement: adjustVolumeIncrement.value,
+    favorites: getFavorites.list,
+  },
+});
+```
+
+- [ ] **Step 4: Add the UI input in the Global Settings accordion**
+
+Find the `<div class="mb-3">` inside the Global Settings accordion, which ends after the `deviceCheckInterval` input:
+
+```html
+            <input id="deviceCheckInterval" v-model="deviceCheckInterval" class="form-control form-control-sm" type="number" />
+          </div>
+```
+
+Add the new field immediately before the closing `</div>`:
+
+```html
+            <input id="deviceCheckInterval" v-model="deviceCheckInterval" class="form-control form-control-sm" type="number" />
+            <label class="form-label" for="adjustVolumeIncrement">Volume Increment (Up/Down)</label>
+            <small class="text-muted d-block">Note: Volume range is 0–100. Used by Volume Up and Volume Down actions unless overridden per-button.</small>
+            <input
+              id="adjustVolumeIncrement"
+              v-model.number="adjustVolumeIncrement"
+              class="form-control form-control-sm"
+              type="number"
+              min="1"
+            />
+          </div>
+```
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/components/PiComponent.vue
+git commit -m "feat: add global volume increment setting to PI global settings"
+```
+
+---
+
+### Task 5: Add per-button override to PI
+
+**Files:**
+- Modify: `src/components/PiComponent.vue`
+
+- [ ] **Step 1: Add refs for the per-button override**
+
+Find the `isEncoderAudioEqualizer` ref declaration block:
+
+```js
+const isEncoderAudioEqualizer = ref(false);
+const availableEqualizerTargets = ref(["volume", "bass", "treble"]);
+const encoderAudioEqualizerTarget = ref("");
+```
+
+Add new refs immediately after:
+
+```js
+const isEncoderAudioEqualizer = ref(false);
+const availableEqualizerTargets = ref(["volume", "bass", "treble"]);
+const encoderAudioEqualizerTarget = ref("");
+
+const isVolumeAction = ref(false);
+const perButtonAdjustVolumeIncrement = ref(null);
+```
+
+- [ ] **Step 2: Handle `volume-up` and `volume-down` in the `globalsettings` switch**
+
+Find the `switch (actionName.value)` block inside the `globalsettings` handler. Add a new case after the existing `encoder-audio-equalizer` case:
+
+```js
+case "encoder-audio-equalizer":
+  isEncoderAudioEqualizer.value = true;
+  if (actionSettings.value?.encoderAudioEqualizerTarget) {
+    encoderAudioEqualizerTarget.value = actionSettings.value.encoderAudioEqualizerTarget;
+  } else {
+    encoderAudioEqualizerTarget.value = "VOLUME";
+  }
+  break;
+case "volume-up":
+case "volume-down":
+  isVolumeAction.value = true;
+  perButtonAdjustVolumeIncrement.value = actionSettings.value?.adjustVolumeIncrement ?? null;
+  break;
+```
+
+- [ ] **Step 3: Include override in `saveSettings()`**
+
+Find the `actionSettings.value = { ... }` block in `saveSettings()`. Add the per-button override field. Find the closing of the object — after the last field before `};` — and add:
+
+```js
+adjustVolumeIncrement: perButtonAdjustVolumeIncrement.value || null,
+```
+
+For example, if the last line before `};` is:
+
+```js
+    selectedSonosFavorite: selectedSonosFavorite.value
+      ? { ... }
+      : null,
+  };
+```
+
+Add the new field before the closing `};`:
+
+```js
+    selectedSonosFavorite: selectedSonosFavorite.value
+      ? { ... }
+      : null,
+    adjustVolumeIncrement: perButtonAdjustVolumeIncrement.value || null,
+  };
+```
+
+(`|| null` ensures an empty input (`""`) or `0` is saved as `null`, meaning "use global".)
+
+- [ ] **Step 4: Add per-button override UI section in template**
+
+Find the encoder equalizer target section in the template:
+
+```html
+    <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isEncoderAudioEqualizer">
+```
+
+Add a new section immediately before it:
+
+```html
+    <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isVolumeAction">
+      <h1>Volume Increment</h1>
+      <div class="d-flex flex-column gap-2 mb-3">
+        <label class="form-label" for="perButtonAdjustVolumeIncrement">Override increment (leave empty to use global default)</label>
+        <small class="text-muted d-block">Volume range: 0–100</small>
+        <input
+          id="perButtonAdjustVolumeIncrement"
+          v-model.number="perButtonAdjustVolumeIncrement"
+          class="form-control form-control-sm"
+          type="number"
+          min="1"
+          :placeholder="`Global default: ${adjustVolumeIncrement}`"
+          @change="saveSettings"
+        />
+      </div>
+    </div>
+
+    <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isEncoderAudioEqualizer">
+```
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/components/PiComponent.vue
+git commit -m "feat: add per-button volume increment override to PI"
+```
+
+---
+
+### Task 6: Build and verify
+
+**Files:** none
+
+- [ ] **Step 1: Build**
+
+```bash
+npm run build_dev
+```
+
+Expected: build completes with no errors. Warnings about unused variables are OK; errors are not.
+
+- [ ] **Step 2: Manual verification checklist**
+
+Install the plugin in Stream Deck (open the built `.sdPlugin` folder or use `npm run package`). Verify:
+
+1. Open Global Settings for any action → the "Volume Increment (Up/Down)" field appears, defaults to 10, and saves (reconnect reloads it correctly)
+2. Open a Volume Up button's PI → a "Volume Increment" override field appears with a placeholder showing the global default
+3. Leave the override empty → pressing the button increments volume by the global default
+4. Set the override to `5` → pressing the button increments by 5 regardless of global setting
+5. Set a different global default (e.g. `3`) → buttons without a per-button override now increment by 3; buttons with an override continue to use their own value
+6. Volume Down mirrors all of the above
+
+- [ ] **Step 3: Final commit if any fixups were made**
+
+```bash
+git add -p   # stage only intentional changes
+git commit -m "fix: <description of any fixups>"
+```

From cc3ba2e3ed51f0eba70ae4565d5add9fc6b694d3 Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:13:19 -0700
Subject: [PATCH 04/10] fix: remove hardcoded increment value from volume
 action tooltips

---
 public/manifest.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/public/manifest.json b/public/manifest.json
index f92c0cb..b393f50 100644
--- a/public/manifest.json
+++ b/public/manifest.json
@@ -212,7 +212,7 @@
       "Icon": "images/actions/volume_up",
       "Name": "Volume Up",
       "PropertyInspectorPath": "pi.html",
-      "Tooltip": "Increase volume by 2",
+      "Tooltip": "Increase volume",
       "UUID": "com.r-teller.sonoscontroller.volume-up",
       "Controllers": [
         "Keypad"
@@ -233,7 +233,7 @@
       "Icon": "images/actions/volume_down",
       "Name": "Volume Down",
       "PropertyInspectorPath": "pi.html",
-      "Tooltip": "Decrease volume by 2",
+      "Tooltip": "Decrease volume",
       "UUID": "com.r-teller.sonoscontroller.volume-down",
       "Controllers": [
         "Keypad"

From 6a6df47b1f94e98fe8254f5660f2145095658af2 Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:14:26 -0700
Subject: [PATCH 05/10] feat: add globalAdjustVolumeIncrement param to volume
 up/down actions

---
 src/modules/actions/sonosController.js | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/modules/actions/sonosController.js b/src/modules/actions/sonosController.js
index 1d0b634..25234f2 100644
--- a/src/modules/actions/sonosController.js
+++ b/src/modules/actions/sonosController.js
@@ -1086,7 +1086,7 @@ export async function play_previous_track_action({
  * @property {string} message - The message describing the action
  * @property {object} updatedSonosSpeakerState - The updated state of the Sonos speaker
  */
-export async function volume_up_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1 }) {
+export async function volume_up_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1, globalAdjustVolumeIncrement = 10 }) {
   const functionName = "[Volume Up Action]";
   if (!inSonosSpeakerState) {
     console.log(`${functionName} inSonosSpeakerState is undefined for context ${inContext}`);
@@ -1106,7 +1106,7 @@ export async function volume_up_action({ inContext, inActionSettings, inSonosSpe
 
     const updatedVolume = Math.min(
       100,
-      parseInt(inSonosSpeakerState.audioEqualizer.volume) + (parseInt(inActionSettings.adjustVolumeIncrement) || 10),
+      parseInt(inSonosSpeakerState.audioEqualizer.volume) + (parseInt(inActionSettings.adjustVolumeIncrement) || globalAdjustVolumeIncrement),
     );
 
     const volumeUpState = await Promise.race([sonosController.setVolume(updatedVolume), timeout]);
@@ -1153,7 +1153,7 @@ export async function volume_up_action({ inContext, inActionSettings, inSonosSpe
  * @property {string} message - The message describing the action
  * @property {object} updatedSonosSpeakerState - The updated state of the Sonos speaker
  */
-export async function volume_down_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1 }) {
+export async function volume_down_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1, globalAdjustVolumeIncrement = 10 }) {
   const functionName = "[Volume Down Action]";
   if (!inSonosSpeakerState) {
     console.log(`${functionName} inSonosSpeakerState is undefined for context ${inContext}`);
@@ -1173,7 +1173,7 @@ export async function volume_down_action({ inContext, inActionSettings, inSonosS
 
     const updatedVolume = Math.max(
       0,
-      parseInt(inSonosSpeakerState.audioEqualizer.volume) - (parseInt(inActionSettings.adjustVolumeIncrement) || 10),
+      parseInt(inSonosSpeakerState.audioEqualizer.volume) - (parseInt(inActionSettings.adjustVolumeIncrement) || globalAdjustVolumeIncrement),
     );
 
     const volumeDownState = await Promise.race([sonosController.setVolume(updatedVolume), timeout]);

From 101aa7304e76f54101fd664147849e2f9d8345a4 Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:15:32 -0700
Subject: [PATCH 06/10] feat: thread globalAdjustVolumeIncrement from global
 settings to action handlers

---
 src/components/PluginComponent.vue | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/components/PluginComponent.vue b/src/components/PluginComponent.vue
index 71022a5..9c40f58 100644
--- a/src/components/PluginComponent.vue
+++ b/src/components/PluginComponent.vue
@@ -17,6 +17,7 @@ const actionSettings = ref([]);
 
 const deviceCheckInterval = ref(10);
 const deviceTimeoutDuration = ref(5);
+const adjustVolumeIncrement = ref(10);
 
 // At some point we may want to add a speaker check interval and timeout duration
 // const speakerCheckInterval = ref(10);
@@ -150,6 +151,7 @@ onMounted(async () => {
       globalSettings.value = inGlobalSettings;
       deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
       deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
+      adjustVolumeIncrement.value = inGlobalSettings.adjustVolumeIncrement ?? 10;
     });
 
     streamDeckConnection.value.on("willDisappear", (inMessage) => {
@@ -363,6 +365,7 @@ function callAction({ inContext, inEvent, inRotation = null }) {
             inSonosSpeakerState: speaker.state,
             inRotation,
             deviceTimeoutDuration: deviceTimeoutDuration.value,
+            globalAdjustVolumeIncrement: adjustVolumeIncrement.value,
           });
           if (actionResult.status === "SUCCESS") {
             sonosSpeakers.updateSpeakerState({

From f59a8c657a7c66df888677f73b85f6a0b1dddd23 Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:16:33 -0700
Subject: [PATCH 07/10] feat: add global volume increment setting to PI global
 settings

---
 src/components/PiComponent.vue | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/components/PiComponent.vue b/src/components/PiComponent.vue
index af71f2f..40720e8 100644
--- a/src/components/PiComponent.vue
+++ b/src/components/PiComponent.vue
@@ -155,6 +155,15 @@
               >Note: This interval is used to check the status of the device selected for this action (in seconds)</small
             >
             <input id="deviceCheckInterval" v-model="deviceCheckInterval" class="form-control form-control-sm" type="number" />
+            <label class="form-label" for="adjustVolumeIncrement">Volume Increment (Up/Down)</label>
+            <small class="text-muted d-block">Note: Volume range is 0–100. Used by Volume Up and Volume Down actions unless overridden per-button.</small>
+            <input
+              id="adjustVolumeIncrement"
+              v-model.number="adjustVolumeIncrement"
+              class="form-control form-control-sm"
+              type="number"
+              min="1"
+            />
           </div>
 
           <div v-if="sonosError" class="alert alert-danger alert-dismissible" role="alert">
@@ -197,6 +206,7 @@ const sonosError = ref("");
 const primaryDeviceAddress = ref("");
 const deviceCheckInterval = ref(10);
 const deviceTimeoutDuration = ref(5);
+const adjustVolumeIncrement = ref(10);
 const sonosConnectionState = ref(OPERATIONAL_STATUS.DISCONNECTED);
 const availableSonosSpeakers = ref([]);
 const actionSettings = ref({});
@@ -275,6 +285,7 @@ onMounted(() => {
         if (inGlobalSettings.devices) {
           deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
           deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
+          adjustVolumeIncrement.value = inGlobalSettings.adjustVolumeIncrement ?? 10;
           const primaryDevice = Object.values(inGlobalSettings.devices).find((device) => device.primary === true);
           if (primaryDevice) {
             primaryDeviceAddress.value = primaryDevice.hostAddress;
@@ -420,6 +431,7 @@ async function saveGlobalSettings() {
         devices: getDevices.list,
         deviceCheckInterval: deviceCheckInterval.value,
         deviceTimeoutDuration: deviceTimeoutDuration.value,
+        adjustVolumeIncrement: adjustVolumeIncrement.value,
         favorites: getFavorites.list,
       },
     });

From 3a0c104c9dd47a8d53df3c4517678ff9b1da1d65 Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:17:56 -0700
Subject: [PATCH 08/10] feat: add per-button volume increment override to PI

---
 src/components/PiComponent.vue | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/src/components/PiComponent.vue b/src/components/PiComponent.vue
index 40720e8..0e9bd47 100644
--- a/src/components/PiComponent.vue
+++ b/src/components/PiComponent.vue
@@ -97,6 +97,23 @@
       </div>
     </div>
 
+    <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isVolumeAction">
+      <h1>Volume Increment</h1>
+      <div class="d-flex flex-column gap-2 mb-3">
+        <label class="form-label" for="perButtonAdjustVolumeIncrement">Override increment (leave empty to use global default)</label>
+        <small class="text-muted d-block">Volume range: 0–100</small>
+        <input
+          id="perButtonAdjustVolumeIncrement"
+          v-model.number="perButtonAdjustVolumeIncrement"
+          class="form-control form-control-sm"
+          type="number"
+          min="1"
+          :placeholder="`Global default: ${adjustVolumeIncrement}`"
+          @change="saveSettings"
+        />
+      </div>
+    </div>
+
     <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isEncoderAudioEqualizer">
       <h1>Equalizer Target</h1>
       <div class="d-flex flex-column gap-2 mb-3">
@@ -257,6 +274,9 @@ const isEncoderAudioEqualizer = ref(false);
 const availableEqualizerTargets = ref(["volume", "bass", "treble"]);
 const encoderAudioEqualizerTarget = ref("");
 
+const isVolumeAction = ref(false);
+const perButtonAdjustVolumeIncrement = ref(null);
+
 onMounted(() => {
   window.connectElgatoStreamDeckSocket = (exPort, exPropertyInspectorUUID, exRegisterEvent, exInfo, exActionInfo) => {
     streamDeckConnection.value = new StreamDeck(exPort, exPropertyInspectorUUID, exRegisterEvent, exInfo, exActionInfo);
@@ -325,6 +345,11 @@ onMounted(() => {
                   encoderAudioEqualizerTarget.value = "VOLUME";
                 }
                 break;
+              case "volume-up":
+              case "volume-down":
+                isVolumeAction.value = true;
+                perButtonAdjustVolumeIncrement.value = actionSettings.value?.adjustVolumeIncrement ?? null;
+                break;
               case "play-sonos-favorite":
                 isPlaySonosFavorite.value = true;
                 availableSonosFavorites.value = inGlobalSettings.favorites.map((favorite) => ({
@@ -466,6 +491,7 @@ function saveSettings() {
           albumArtURI: selectedSonosFavorite.value.albumArtURI,
         }
       : null,
+    adjustVolumeIncrement: perButtonAdjustVolumeIncrement.value || null,
   };
   streamDeckConnection.value.saveSettings({
     actionSettings: actionSettings.value,

From 811cbcf0f77cb194aac66d52e40288cdcda3af76 Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:39:07 -0700
Subject: [PATCH 09/10] Remove implementation plan (not for upstream)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 .../2026-04-05-volume-increment-setting.md    | 438 ------------------
 1 file changed, 438 deletions(-)
 delete mode 100644 docs/superpowers/plans/2026-04-05-volume-increment-setting.md

diff --git a/docs/superpowers/plans/2026-04-05-volume-increment-setting.md b/docs/superpowers/plans/2026-04-05-volume-increment-setting.md
deleted file mode 100644
index 7bd821f..0000000
--- a/docs/superpowers/plans/2026-04-05-volume-increment-setting.md
+++ /dev/null
@@ -1,438 +0,0 @@
-# Volume Increment Setting 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:** Expose a configurable volume increment for Volume Up/Down actions, with a global default and optional per-button override.
-
-**Architecture:** Global `adjustVolumeIncrement` (default `10`) is stored in Stream Deck global settings and threaded through `PluginComponent.vue` to the action handlers. Per-button `adjustVolumeIncrement` is stored in each action's `actionSettings` and takes precedence when set. The PI for volume actions shows an optional override input; the Global Settings accordion shows the default input.
-
-**Tech Stack:** Vue 3, Vite, Stream Deck SDK (`@elgato/streamdeck`), Bootstrap 5
-
----
-
-## File Map
-
-| File | Change |
-|------|--------|
-| `public/manifest.json` | Remove hardcoded "by 2" from Volume Up/Down tooltips |
-| `src/modules/actions/sonosController.js` | Add `globalAdjustVolumeIncrement` param to `volume_up_action` and `volume_down_action`; update increment resolution |
-| `src/components/PluginComponent.vue` | Extract `adjustVolumeIncrement` from global settings; pass to action call site |
-| `src/components/PiComponent.vue` | Add global increment setting UI + per-button override UI |
-
----
-
-### Task 1: Fix manifest tooltips
-
-**Files:**
-- Modify: `public/manifest.json`
-
-- [ ] **Step 1: Update Volume Up tooltip**
-
-In `public/manifest.json`, find the Volume Up action (`"UUID": "com.r-teller.sonoscontroller.volume-up"`) and change its `Tooltip`:
-
-```json
-"Tooltip": "Increase volume",
-```
-
-- [ ] **Step 2: Update Volume Down tooltip**
-
-In the same file, find the Volume Down action (`"UUID": "com.r-teller.sonoscontroller.volume-down"`) and change its `Tooltip`:
-
-```json
-"Tooltip": "Decrease volume",
-```
-
-- [ ] **Step 3: Commit**
-
-```bash
-git add public/manifest.json
-git commit -m "fix: remove hardcoded increment value from volume action tooltips"
-```
-
----
-
-### Task 2: Update action handlers to accept global increment
-
-**Files:**
-- Modify: `src/modules/actions/sonosController.js`
-
-There is no test suite in this project. Verify changes by building (`npm run build_dev`) and testing manually in Stream Deck.
-
-- [ ] **Step 1: Update `volume_up_action` signature and increment resolution**
-
-Find `volume_up_action` (currently starts around `export async function volume_up_action({`). Update its signature and the line that computes `updatedVolume`:
-
-Old signature:
-```js
-export async function volume_up_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1 }) {
-```
-
-New signature:
-```js
-export async function volume_up_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1, globalAdjustVolumeIncrement = 10 }) {
-```
-
-Old increment line (inside the function):
-```js
-parseInt(inSonosSpeakerState.audioEqualizer.volume) + (parseInt(inActionSettings.adjustVolumeIncrement) || 10),
-```
-
-New increment line:
-```js
-parseInt(inSonosSpeakerState.audioEqualizer.volume) + (parseInt(inActionSettings.adjustVolumeIncrement) || globalAdjustVolumeIncrement),
-```
-
-- [ ] **Step 2: Update `volume_down_action` signature and increment resolution**
-
-Find `volume_down_action`. Apply the same changes:
-
-Old signature:
-```js
-export async function volume_down_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1 }) {
-```
-
-New signature:
-```js
-export async function volume_down_action({ inContext, inActionSettings, inSonosSpeakerState, deviceTimeoutDuration = 1, globalAdjustVolumeIncrement = 10 }) {
-```
-
-Old increment line:
-```js
-parseInt(inSonosSpeakerState.audioEqualizer.volume) - (parseInt(inActionSettings.adjustVolumeIncrement) || 10),
-```
-
-New increment line:
-```js
-parseInt(inSonosSpeakerState.audioEqualizer.volume) - (parseInt(inActionSettings.adjustVolumeIncrement) || globalAdjustVolumeIncrement),
-```
-
-- [ ] **Step 3: Commit**
-
-```bash
-git add src/modules/actions/sonosController.js
-git commit -m "feat: add globalAdjustVolumeIncrement param to volume up/down actions"
-```
-
----
-
-### Task 3: Thread global increment through PluginComponent
-
-**Files:**
-- Modify: `src/components/PluginComponent.vue`
-
-- [ ] **Step 1: Add reactive ref for global increment**
-
-Find the block of `const` refs at the top of `<script setup>` where `deviceTimeoutDuration` and `deviceCheckInterval` are declared:
-
-```js
-const deviceCheckInterval = ref(10);
-const deviceTimeoutDuration = ref(5);
-```
-
-Add `adjustVolumeIncrement` immediately after:
-
-```js
-const deviceCheckInterval = ref(10);
-const deviceTimeoutDuration = ref(5);
-const adjustVolumeIncrement = ref(10);
-```
-
-- [ ] **Step 2: Read global increment from global settings**
-
-Find the `globalsettings` handler block that reads `deviceCheckInterval` and `deviceTimeoutDuration`:
-
-```js
-deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
-deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
-```
-
-Add the new line immediately after:
-
-```js
-deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
-deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
-adjustVolumeIncrement.value = inGlobalSettings.adjustVolumeIncrement ?? 10;
-```
-
-- [ ] **Step 3: Pass global increment to the action call site**
-
-Find the `actionFunction` call inside `PluginComponent.vue` that currently passes `deviceTimeoutDuration`:
-
-```js
-const actionResult = await actionFunction({
-  inContext,
-  inActionSettings: settings,
-  inSonosSpeakerState: speaker.state,
-  inRotation,
-  deviceTimeoutDuration: deviceTimeoutDuration.value,
-});
-```
-
-Add `globalAdjustVolumeIncrement`:
-
-```js
-const actionResult = await actionFunction({
-  inContext,
-  inActionSettings: settings,
-  inSonosSpeakerState: speaker.state,
-  inRotation,
-  deviceTimeoutDuration: deviceTimeoutDuration.value,
-  globalAdjustVolumeIncrement: adjustVolumeIncrement.value,
-});
-```
-
-- [ ] **Step 4: Commit**
-
-```bash
-git add src/components/PluginComponent.vue
-git commit -m "feat: thread globalAdjustVolumeIncrement from global settings to action handlers"
-```
-
----
-
-### Task 4: Add global increment setting to PI
-
-**Files:**
-- Modify: `src/components/PiComponent.vue`
-
-- [ ] **Step 1: Add the `adjustVolumeIncrement` ref**
-
-Find where `deviceTimeoutDuration` and `deviceCheckInterval` refs are declared in `<script setup>`:
-
-```js
-const deviceCheckInterval = ref(10);
-const deviceTimeoutDuration = ref(5);
-```
-
-Add immediately after:
-
-```js
-const deviceCheckInterval = ref(10);
-const deviceTimeoutDuration = ref(5);
-const adjustVolumeIncrement = ref(10);
-```
-
-- [ ] **Step 2: Read the value from global settings**
-
-Find the `globalsettings` handler block that reads `deviceCheckInterval` and `deviceTimeoutDuration`:
-
-```js
-deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
-deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
-```
-
-Add immediately after:
-
-```js
-deviceCheckInterval.value = inGlobalSettings.deviceCheckInterval;
-deviceTimeoutDuration.value = inGlobalSettings.deviceTimeoutDuration;
-adjustVolumeIncrement.value = inGlobalSettings.adjustVolumeIncrement ?? 10;
-```
-
-- [ ] **Step 3: Include in `saveGlobalSettings()` payload**
-
-Find the `streamDeckConnection.value.saveGlobalSettings` call inside `saveGlobalSettings()`:
-
-```js
-streamDeckConnection.value.saveGlobalSettings({
-  payload: {
-    devices: getDevices.list,
-    deviceCheckInterval: deviceCheckInterval.value,
-    deviceTimeoutDuration: deviceTimeoutDuration.value,
-    favorites: getFavorites.list,
-  },
-});
-```
-
-Add `adjustVolumeIncrement`:
-
-```js
-streamDeckConnection.value.saveGlobalSettings({
-  payload: {
-    devices: getDevices.list,
-    deviceCheckInterval: deviceCheckInterval.value,
-    deviceTimeoutDuration: deviceTimeoutDuration.value,
-    adjustVolumeIncrement: adjustVolumeIncrement.value,
-    favorites: getFavorites.list,
-  },
-});
-```
-
-- [ ] **Step 4: Add the UI input in the Global Settings accordion**
-
-Find the `<div class="mb-3">` inside the Global Settings accordion, which ends after the `deviceCheckInterval` input:
-
-```html
-            <input id="deviceCheckInterval" v-model="deviceCheckInterval" class="form-control form-control-sm" type="number" />
-          </div>
-```
-
-Add the new field immediately before the closing `</div>`:
-
-```html
-            <input id="deviceCheckInterval" v-model="deviceCheckInterval" class="form-control form-control-sm" type="number" />
-            <label class="form-label" for="adjustVolumeIncrement">Volume Increment (Up/Down)</label>
-            <small class="text-muted d-block">Note: Volume range is 0–100. Used by Volume Up and Volume Down actions unless overridden per-button.</small>
-            <input
-              id="adjustVolumeIncrement"
-              v-model.number="adjustVolumeIncrement"
-              class="form-control form-control-sm"
-              type="number"
-              min="1"
-            />
-          </div>
-```
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/components/PiComponent.vue
-git commit -m "feat: add global volume increment setting to PI global settings"
-```
-
----
-
-### Task 5: Add per-button override to PI
-
-**Files:**
-- Modify: `src/components/PiComponent.vue`
-
-- [ ] **Step 1: Add refs for the per-button override**
-
-Find the `isEncoderAudioEqualizer` ref declaration block:
-
-```js
-const isEncoderAudioEqualizer = ref(false);
-const availableEqualizerTargets = ref(["volume", "bass", "treble"]);
-const encoderAudioEqualizerTarget = ref("");
-```
-
-Add new refs immediately after:
-
-```js
-const isEncoderAudioEqualizer = ref(false);
-const availableEqualizerTargets = ref(["volume", "bass", "treble"]);
-const encoderAudioEqualizerTarget = ref("");
-
-const isVolumeAction = ref(false);
-const perButtonAdjustVolumeIncrement = ref(null);
-```
-
-- [ ] **Step 2: Handle `volume-up` and `volume-down` in the `globalsettings` switch**
-
-Find the `switch (actionName.value)` block inside the `globalsettings` handler. Add a new case after the existing `encoder-audio-equalizer` case:
-
-```js
-case "encoder-audio-equalizer":
-  isEncoderAudioEqualizer.value = true;
-  if (actionSettings.value?.encoderAudioEqualizerTarget) {
-    encoderAudioEqualizerTarget.value = actionSettings.value.encoderAudioEqualizerTarget;
-  } else {
-    encoderAudioEqualizerTarget.value = "VOLUME";
-  }
-  break;
-case "volume-up":
-case "volume-down":
-  isVolumeAction.value = true;
-  perButtonAdjustVolumeIncrement.value = actionSettings.value?.adjustVolumeIncrement ?? null;
-  break;
-```
-
-- [ ] **Step 3: Include override in `saveSettings()`**
-
-Find the `actionSettings.value = { ... }` block in `saveSettings()`. Add the per-button override field. Find the closing of the object — after the last field before `};` — and add:
-
-```js
-adjustVolumeIncrement: perButtonAdjustVolumeIncrement.value || null,
-```
-
-For example, if the last line before `};` is:
-
-```js
-    selectedSonosFavorite: selectedSonosFavorite.value
-      ? { ... }
-      : null,
-  };
-```
-
-Add the new field before the closing `};`:
-
-```js
-    selectedSonosFavorite: selectedSonosFavorite.value
-      ? { ... }
-      : null,
-    adjustVolumeIncrement: perButtonAdjustVolumeIncrement.value || null,
-  };
-```
-
-(`|| null` ensures an empty input (`""`) or `0` is saved as `null`, meaning "use global".)
-
-- [ ] **Step 4: Add per-button override UI section in template**
-
-Find the encoder equalizer target section in the template:
-
-```html
-    <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isEncoderAudioEqualizer">
-```
-
-Add a new section immediately before it:
-
-```html
-    <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isVolumeAction">
-      <h1>Volume Increment</h1>
-      <div class="d-flex flex-column gap-2 mb-3">
-        <label class="form-label" for="perButtonAdjustVolumeIncrement">Override increment (leave empty to use global default)</label>
-        <small class="text-muted d-block">Volume range: 0–100</small>
-        <input
-          id="perButtonAdjustVolumeIncrement"
-          v-model.number="perButtonAdjustVolumeIncrement"
-          class="form-control form-control-sm"
-          type="number"
-          min="1"
-          :placeholder="`Global default: ${adjustVolumeIncrement}`"
-          @change="saveSettings"
-        />
-      </div>
-    </div>
-
-    <div v-if="sonosConnectionState === OPERATIONAL_STATUS.CONNECTED && isEncoderAudioEqualizer">
-```
-
-- [ ] **Step 5: Commit**
-
-```bash
-git add src/components/PiComponent.vue
-git commit -m "feat: add per-button volume increment override to PI"
-```
-
----
-
-### Task 6: Build and verify
-
-**Files:** none
-
-- [ ] **Step 1: Build**
-
-```bash
-npm run build_dev
-```
-
-Expected: build completes with no errors. Warnings about unused variables are OK; errors are not.
-
-- [ ] **Step 2: Manual verification checklist**
-
-Install the plugin in Stream Deck (open the built `.sdPlugin` folder or use `npm run package`). Verify:
-
-1. Open Global Settings for any action → the "Volume Increment (Up/Down)" field appears, defaults to 10, and saves (reconnect reloads it correctly)
-2. Open a Volume Up button's PI → a "Volume Increment" override field appears with a placeholder showing the global default
-3. Leave the override empty → pressing the button increments volume by the global default
-4. Set the override to `5` → pressing the button increments by 5 regardless of global setting
-5. Set a different global default (e.g. `3`) → buttons without a per-button override now increment by 3; buttons with an override continue to use their own value
-6. Volume Down mirrors all of the above
-
-- [ ] **Step 3: Final commit if any fixups were made**
-
-```bash
-git add -p   # stage only intentional changes
-git commit -m "fix: <description of any fixups>"
-```

From 8691749e8789d780c1545f2f4ab8ba9fb8967e0f Mon Sep 17 00:00:00 2001
From: Rod Begbie <rod.begbie@splice.com>
Date: Sun, 5 Apr 2026 14:59:38 -0700
Subject: [PATCH 10/10] fix: volume increment edge cases from code review

- Use ?? instead of || when saving per-button override so a value of 1
  isn't treated as falsy and silently discarded
- Clamp global increment to Math.max(1, value) before persisting since
  HTML min="1" doesn't block Vue's v-model binding in Electron's webview

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/PiComponent.vue | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/components/PiComponent.vue b/src/components/PiComponent.vue
index 0e9bd47..c82743a 100644
--- a/src/components/PiComponent.vue
+++ b/src/components/PiComponent.vue
@@ -456,7 +456,7 @@ async function saveGlobalSettings() {
         devices: getDevices.list,
         deviceCheckInterval: deviceCheckInterval.value,
         deviceTimeoutDuration: deviceTimeoutDuration.value,
-        adjustVolumeIncrement: adjustVolumeIncrement.value,
+        adjustVolumeIncrement: Math.max(1, adjustVolumeIncrement.value),
         favorites: getFavorites.list,
       },
     });
@@ -491,7 +491,7 @@ function saveSettings() {
           albumArtURI: selectedSonosFavorite.value.albumArtURI,
         }
       : null,
-    adjustVolumeIncrement: perButtonAdjustVolumeIncrement.value || null,
+    adjustVolumeIncrement: perButtonAdjustVolumeIncrement.value ?? null,
   };
   streamDeckConnection.value.saveSettings({
     actionSettings: actionSettings.value,