pi-usereq 0.12.0 → 0.32.0

package/pi-usereq/docs/WORKFLOW.md

@@ -44,7 +44,7 @@
   - Threads: no explicit threads detected
 - ID: `PROC:gh-release-build`
   - Type: Process
-  - Role: GitHub Actions release runner that publishes the npm package, builds changelog text, and creates the GitHub Release after branch gating succeeds.
+  - Role: GitHub Actions release runner that configures Node.js `24.15.0`, publishes the npm package, builds changelog text, and creates the GitHub Release after branch gating succeeds.
   - Entrypoints:
     - `build-release(...)` [`.github/workflows/release-npm.yml`]
   - Parent Process: none
@@ -63,12 +63,18 @@
   - `main(...)`: parse argv, normalize config, dispatch selected runner, serialize result [`src/cli.ts`]
     - `parseArgs(...)`: map argv tokens into a structured command selection [`src/cli.ts`]
       - `takeUntilOption(...)`: collect positional operands until next option token [`src/cli.ts`]
-    - `applyEnableStaticCheckSpecs(...)`: merge repeatable CLI static-check enable specs, preserve existing checker lists, and force targeted language flags on before command dispatch [`src/cli.ts`]
-      - `loadMutableProjectConfig(...)`: load project config without intermediate persistence [`src/cli.ts`]
+    - `applyEnableStaticCheckSpecs(...)`: merge repeatable CLI static-check enable specs into global checker lists, preserve existing entries, and force targeted local enable flags on before command dispatch [`src/cli.ts`]
+      - `loadMutableProjectConfig(...)`: load effective config without intermediate persistence [`src/cli.ts`]
         - `resolveProjectBase(...)`: validate project base path [`src/core/tool-runner.ts`]
-        - `loadConfig(...)`: load config or defaults [`src/core/config.ts`]
-          - `getProjectConfigPath(...)`: resolve config file path [`src/core/config.ts`]
-          - `getDefaultConfig(...)`: build default config [`src/core/config.ts`]
+        - `loadConfig(...)`: load merged local/global config or defaults [`src/core/config.ts`]
+          - `loadGlobalConfig(...)`: load global config or defaults [`src/core/config.ts`]
+            - `getGlobalConfigPath(...)`: resolve global config file path [`src/core/config.ts`]
+            - `readConfigPayload(...)`: parse persisted global config JSON when present [`src/core/config.ts`]
+          - `loadLocalConfig(...)`: load local config or defaults using global static-check enable defaults [`src/core/config.ts`]
+            - `getProjectConfigPath(...)`: resolve local config file path [`src/core/config.ts`]
+            - `readConfigPayload(...)`: parse persisted local config JSON when present [`src/core/config.ts`]
+          - `mergeConfigScopes(...)`: combine local and global config into the effective runtime config [`src/core/config.ts`]
+            - `mergeStaticCheckConfig(...)`: combine local enable flags with global checker arrays [`src/core/config.ts`]
             - `normalizeEnabledPiUsereqTools(...)`: canonicalize startup tools [`src/core/pi-usereq-tools.ts`]
         - `isInsideGitRepo(...)`: probe git repository membership [`src/core/tool-runner.ts`]
           - `runCapture(...)`: run git subprocess [`src/core/tool-runner.ts`]
@@ -79,23 +85,41 @@
       - `validateStaticCheckEntry(...)`: validate command-backed entry before config write [`src/core/static-check.ts`]
         - `findExecutable(...)`: resolve executable on PATH or explicit path [`src/core/static-check.ts`]
           - `isExecutableFile(...)`: verify executable access bits [`src/core/static-check.ts`]
-      - `saveConfig(...)`: persist merged config JSON [`src/core/config.ts`]
-        - `getProjectConfigPath(...)`: resolve config file path [`src/core/config.ts`]
+      - `saveConfig(...)`: persist split local/global config JSON [`src/core/config.ts`]
+        - `saveLocalConfig(...)`: write the local config file [`src/core/config.ts`]
+          - `getProjectConfigPath(...)`: resolve local config file path [`src/core/config.ts`]
+        - `saveGlobalConfig(...)`: write the global config file [`src/core/config.ts`]
+          - `getGlobalConfigPath(...)`: resolve global config file path [`src/core/config.ts`]
     - `loadAndRepairConfig(...)`: persist normalized config when `--here` or `--base` is active and no CLI static-check mutation is requested [`src/core/tool-runner.ts`]
       - `resolveProjectBase(...)`: validate project base path [`src/core/tool-runner.ts`]
-      - `loadConfig(...)`: load config or defaults [`src/core/config.ts`]
-        - `getProjectConfigPath(...)`: resolve config file path [`src/core/config.ts`]
-        - `getDefaultConfig(...)`: build default config [`src/core/config.ts`]
+      - `loadConfig(...)`: load merged local/global config or defaults [`src/core/config.ts`]
+        - `loadGlobalConfig(...)`: load global config or defaults [`src/core/config.ts`]
+          - `getGlobalConfigPath(...)`: resolve global config file path [`src/core/config.ts`]
+          - `readConfigPayload(...)`: parse persisted global config JSON when present [`src/core/config.ts`]
+        - `loadLocalConfig(...)`: load local config or defaults using global static-check enable defaults [`src/core/config.ts`]
+          - `getProjectConfigPath(...)`: resolve local config file path [`src/core/config.ts`]
+          - `readConfigPayload(...)`: parse persisted local config JSON when present [`src/core/config.ts`]
+        - `mergeConfigScopes(...)`: combine local and global config into the effective runtime config [`src/core/config.ts`]
+          - `mergeStaticCheckConfig(...)`: combine local enable flags with global checker arrays [`src/core/config.ts`]
           - `normalizeEnabledPiUsereqTools(...)`: canonicalize startup tools [`src/core/pi-usereq-tools.ts`]
       - `isInsideGitRepo(...)`: probe git repository membership [`src/core/tool-runner.ts`]
         - `runCapture(...)`: run git subprocess [`src/core/tool-runner.ts`]
       - `resolveGitRoot(...)`: resolve repository root [`src/core/tool-runner.ts`]
         - `runCapture(...)`: run git subprocess [`src/core/tool-runner.ts`]
-      - `saveConfig(...)`: persist normalized config JSON [`src/core/config.ts`]
-        - `getProjectConfigPath(...)`: resolve config file path [`src/core/config.ts`]
-    - `loadConfig(...)`: load effective config for dispatch when no CLI static-check mutation is requested [`src/core/config.ts`]
-      - `getProjectConfigPath(...)`: resolve config file path [`src/core/config.ts`]
-      - `getDefaultConfig(...)`: build default config [`src/core/config.ts`]
+      - `saveConfig(...)`: persist split local/global config JSON [`src/core/config.ts`]
+        - `saveLocalConfig(...)`: write the local config file [`src/core/config.ts`]
+          - `getProjectConfigPath(...)`: resolve local config file path [`src/core/config.ts`]
+        - `saveGlobalConfig(...)`: write the global config file [`src/core/config.ts`]
+          - `getGlobalConfigPath(...)`: resolve global config file path [`src/core/config.ts`]
+    - `loadConfig(...)`: load effective merged local/global config for dispatch when no CLI static-check mutation is requested [`src/core/config.ts`]
+      - `loadGlobalConfig(...)`: load global config or defaults [`src/core/config.ts`]
+        - `getGlobalConfigPath(...)`: resolve global config file path [`src/core/config.ts`]
+        - `readConfigPayload(...)`: parse persisted global config JSON when present [`src/core/config.ts`]
+      - `loadLocalConfig(...)`: load local config or defaults using global static-check enable defaults [`src/core/config.ts`]
+        - `getProjectConfigPath(...)`: resolve local config file path [`src/core/config.ts`]
+        - `readConfigPayload(...)`: parse persisted local config JSON when present [`src/core/config.ts`]
+      - `mergeConfigScopes(...)`: combine local and global config into the effective runtime config [`src/core/config.ts`]
+        - `mergeStaticCheckConfig(...)`: combine local enable flags with global checker arrays [`src/core/config.ts`]
         - `normalizeEnabledPiUsereqTools(...)`: canonicalize startup tools [`src/core/pi-usereq-tools.ts`]
     - `runFilesTokens(...)`: branch `--files-tokens`; count explicit-file token, size, and structure metrics [`src/core/tool-runner.ts`]
       - `countFilesMetrics(...)`: read files and extract token, character, byte, line, heading, and optional Doxygen facts [`src/core/token-counter.ts`]
@@ -551,8 +575,9 @@
         - `deliverPromptCommand(...)`: dispatch prompt replay into the current recorded session [`src/index.ts`]
           - External boundaries: `RecordingExtensionAPI.sendUserMessage(...)` records the delivered prompt payload.
         - `configurePiUsereq(...)`: execute the interactive configuration menu [`src/index.ts`]
-          - `buildPiUsereqMenuChoices(...)`: serialize top-level settings actions including effective worktree locking and the display-only config-path row [`src/index.ts`]
-            - `formatProjectConfigPathForMenu(...)`: format the current config path with the shared `~`-relative path formatter for menu display [`src/index.ts`]
+          - `buildPiUsereqMenuChoices(...)`: serialize top-level settings actions including effective worktree locking plus display-only local and global config-path rows [`src/index.ts`]
+            - `formatLocalConfigPathForMenu(...)`: format the current local config path with the shared `~`-relative path formatter for menu display [`src/index.ts`]
+            - `formatGlobalConfigPathForMenu(...)`: format the current global config path with the shared `~`-relative path formatter for menu display [`src/index.ts`]
           - `showPiUsereqSettingsMenu(...)`: render the shared settings-menu UI for top-level and submenu actions, keeping inline toggle rows open while rebuilding dependent rows in place [`src/core/settings-menu.ts`]
             - `formatPiUsereqSettingsMenuTitle(...)`: rebuild the menu title with active-theme semantics [`src/core/settings-menu.ts`]
             - `buildPiUsereqSettingsListTheme(...)`: prefer shared CLI settings-list theming and fall back during offline replay [`src/core/settings-menu.ts`]
@@ -560,7 +585,7 @@
             - `buildSettingItems(...)`: map menu choices into settings-list rows, apply optional dim tones, disable non-selectable actions, and expose inline value cycles [`src/core/settings-menu.ts`]
             - `setSettingsListSelectedIndex(...)`: restore the focused row during in-place menu rebuilds [`src/core/settings-menu.ts`]
             - `getSettingsListSelectedIndex(...)`: expose the focused row for the offline bridge after inline toggle handling [`src/core/settings-menu.ts`]
-          - `saveProjectConfig(...)`: persist menu updates on save-and-close [`src/index.ts`]
+          - `saveProjectConfig(...)`: persist split local/global menu updates [`src/index.ts`]
           - `setPiUsereqStatusConfig(...)`: cache the saved config for footer rendering [`src/core/extension-status.ts`]
           - `renderPiUsereqStatus(...)`: refresh live context usage and render the status/branch/context/elapsed/sound footer after save-and-close with CLI-theme token overlays [`src/core/extension-status.ts`]
             - `createStatusThemeAdapter(...)`: constrain status rendering to CLI-supported `accent`, `warning`, `dim`, and `error` theme tokens [`src/core/extension-status.ts`]
@@ -576,10 +601,10 @@
               - `formatElapsedStatusValue(...)`: compose `⏱︎`, `⚑`, and `⌛︎` timer segments [`src/core/extension-status.ts`]
                 - `formatCompletedStatusDuration(...)`: render completed timers or the unset placeholder [`src/core/extension-status.ts`]
                 - `formatStatusDuration(...)`: render `M:SS` durations [`src/core/extension-status.ts`]
-          - `configureStaticCheckMenu(...)`: interactive guided static-check editor with in-place per-language enable toggles [`src/index.ts`]
-          - `configurePiUsereqToolsMenu(...)`: interactive active-tool editor whose per-tool toggle submenu keeps focus while cycling `on|off` values [`src/index.ts`]
-          - `configurePiNotifyMenu(...)`: interactive notify, sound, and Pushover editor with in-place global toggles, credential-locked enablement guidance text, persisted boot-sound edits, and dedicated event submenus [`src/index.ts`]
-            - `buildPiNotifyMenuChoices(...)`: serialize command-notify, sound, and Pushover blocks plus shared-event submenu launchers, including boot-sound rows sourced from persisted config [`src/index.ts`]
+          - `configureStaticCheckMenu(...)`: interactive editor that adds and removes global Command entries while toggling local per-language enable flags [`src/index.ts`]
+          - `configurePiUsereqToolsMenu(...)`: interactive active-tool editor whose per-tool toggle submenu keeps focus while persisting enablement in global config [`src/index.ts`]
+          - `configurePiNotifyMenu(...)`: interactive notify, sound, and Pushover editor that persists every subtree mutation in global config [`src/index.ts`]
+            - `buildPiNotifyMenuChoices(...)`: serialize command-notify, sound, and Pushover blocks plus shared-event submenu launchers, including boot-sound rows sourced from persisted global config [`src/index.ts`]
               - `buildPiNotifyEventLauncherChoice(...)`: serialize one event-submenu launcher row with a compact enabled-toggle summary [`src/index.ts`]
               - `buildPiNotifyPushoverRows(...)`: serialize direct Pushover rows with locked enablement guidance text plus the shared event-submenu launcher [`src/index.ts`]
             - `configurePiNotifyEventMenu(...)`: interactive completed/interrupted/failed event editor that keeps focus while toggling `on|off` rows for one notification transport [`src/index.ts`]
@@ -855,6 +880,15 @@
           - `cleanupPromptWorktreeCreation(...)`: remove registered worktree entries, leftover directories, and matching branches [`src/core/prompt-command-runtime.ts`]
             - `promptWorktreeRegistered(...)`: test whether the sibling worktree remains registered [`src/core/prompt-command-runtime.ts`]
             - `promptWorktreeBranchExists(...)`: test whether the matching branch remains present [`src/core/prompt-command-runtime.ts`]
+    - `getProcessCwdSafe(...)`: resolve a fallback-safe activation cwd before optional debug command registration [`src/index.ts`]
+    - `shouldRegisterDebugToolCommands(...)`: load local config and decide whether debug tool wrapper commands should register during activation [`src/index.ts`]
+      - `loadProjectConfig(...)`: load config and normalize persisted directory paths for activation-time debug command gating [`src/index.ts`]
+        - `getProjectBase(...)`: resolve project base from the activation cwd [`src/index.ts`]
+        - `loadConfig(...)`: load config or defaults [`src/core/config.ts`]
+          - `getProjectConfigPath(...)`: resolve config file path [`src/core/config.ts`]
+          - `getDefaultConfig(...)`: build default config [`src/core/config.ts`]
+            - `normalizeEnabledPiUsereqTools(...)`: canonicalize startup tools [`src/core/pi-usereq-tools.ts`]
+    - `registerDebugToolCommands(...)`: register config-gated debug slash-command wrappers for `compress`, `references`, `static-check`, and `tokens` [`src/index.ts`]
     - `registerAgentTools(...)`: register structured pi tools whose execute callbacks reuse internal runner families, the status-only references writer, token-optimized payload builders, and compact-plus-expanded custom result renderers [`src/index.ts`]
       - `ensureBundledResourcesAccessible(...)`: validate installation-owned bundled resources for tool executes that need bundled assets [`src/core/resources.ts`]
         - `getBundledResourceRoot(...)`: resolve installation-owned resource root [`src/core/resources.ts`]
@@ -1082,9 +1116,10 @@
       - `resolveGitRoot(...)`: resolve repository root [`src/core/tool-runner.ts`]
         - `runCapture(...)`: run git subprocess [`src/core/tool-runner.ts`]
     - `getProjectBase(...)`: resolve project base from command context cwd [`src/index.ts`]
-    - `buildPiUsereqMenuChoices(...)`: serialize top-level settings actions including effective worktree locking, notification and debug summaries, the display-only config-path row, and reset-only terminal rows [`src/index.ts`]
+    - `buildPiUsereqMenuChoices(...)`: serialize top-level settings actions including effective worktree locking, notification and debug summaries, display-only local and global config-path rows, and reset-only terminal rows [`src/index.ts`]
       - `formatDebugMenuSummary(...)`: summarize global debug mode plus selected tool and prompt counts [`src/index.ts`]
-      - `formatProjectConfigPathForMenu(...)`: format the current config path with the shared `~`-relative path formatter for menu display [`src/index.ts`]
+      - `formatLocalConfigPathForMenu(...)`: format the current local config path with the shared `~`-relative path formatter for menu display [`src/index.ts`]
+      - `formatGlobalConfigPathForMenu(...)`: format the current global config path with the shared `~`-relative path formatter for menu display [`src/index.ts`]
       - `buildTerminalSettingsMenuChoices(...)`: append the canonical `Reset defaults` row without `Save and close` [`src/index.ts`]
     - `showPiUsereqSettingsMenu(...)`: render the shared settings-menu UI for top-level and submenu actions, keeping inline toggle rows open while rebuilding dependent rows in place [`src/core/settings-menu.ts`]
       - `formatPiUsereqSettingsMenuTitle(...)`: rebuild the menu title with active-theme semantics [`src/core/settings-menu.ts`]
@@ -1095,11 +1130,16 @@
       - `getSettingsListSelectedIndex(...)`: expose the focused row for the offline bridge after inline toggle handling [`src/core/settings-menu.ts`]
     - `persistConfigChange(...)`: persist config immediately after every settings mutation and refresh status rendering [`src/index.ts`]
       - `getProjectBase(...)`: resolve project base from command context cwd [`src/index.ts`]
-      - `saveConfig(...)`: persist config JSON [`src/core/config.ts`]
-        - `getProjectConfigPath(...)`: resolve config file path [`src/core/config.ts`]
-    - `writePersistedProjectConfigToEditor(...)`: read the already-persisted config file and write its exact text into the editor [`src/index.ts`]
+      - `saveConfig(...)`: persist split local/global config JSON [`src/core/config.ts`]
+        - `saveLocalConfig(...)`: write the local config file [`src/core/config.ts`]
+          - `getProjectConfigPath(...)`: resolve local config file path [`src/core/config.ts`]
+        - `saveGlobalConfig(...)`: write the global config file [`src/core/config.ts`]
+          - `getGlobalConfigPath(...)`: resolve global config file path [`src/core/config.ts`]
+    - `writePersistedLocalConfigToEditor(...)`: read the already-persisted local config file and write its exact text into the editor [`src/index.ts`]
       - `getProjectBase(...)`: resolve project base from command context cwd [`src/index.ts`]
-      - `getProjectConfigPath(...)`: resolve the persisted config path [`src/core/config.ts`]
+      - `getProjectConfigPath(...)`: resolve the persisted local config path [`src/core/config.ts`]
+    - `writePersistedGlobalConfigToEditor(...)`: read the already-persisted global config file and write its exact text into the editor [`src/index.ts`]
+      - `getGlobalConfigPath(...)`: resolve the persisted global config path [`src/core/config.ts`]
     - `setPiUsereqStatusConfig(...)`: cache the just-saved docs/tests/src and pi-notify values for status rendering [`src/core/extension-status.ts`]
     - `renderPiUsereqStatus(...)`: refresh live context usage and render the status/branch/context/elapsed/sound footer after save-and-close with CLI-theme token overlays [`src/core/extension-status.ts`]
       - `createStatusThemeAdapter(...)`: constrain status rendering to CLI-supported `accent`, `warning`, `dim`, and `error` theme tokens [`src/core/extension-status.ts`]
@@ -1117,12 +1157,12 @@
         - `formatElapsedStatusValue(...)`: compose `⏱︎`, `⚑`, and `⌛︎` timer segments [`src/core/extension-status.ts`]
           - `formatCompletedStatusDuration(...)`: render completed timers or the unset placeholder [`src/core/extension-status.ts`]
           - `formatStatusDuration(...)`: render `M:SS` durations [`src/core/extension-status.ts`]
-    - `configureStaticCheckMenu(...)`: interactive guided static-check editor with in-place per-language enable toggles [`src/index.ts`]
+    - `configureStaticCheckMenu(...)`: interactive editor that adds and removes global Command entries while toggling local per-language enable flags [`src/index.ts`]
       - `getStaticCheckLanguageConfigForMenu(...)`: resolve a menu-facing per-language static-check object [`src/index.ts`]
-      - `countConfiguredStaticCheckLanguages(...)`: count languages that retain checker entries [`src/index.ts`]
-      - `countEnabledStaticCheckLanguages(...)`: count languages whose enable flag is on [`src/index.ts`]
-      - `formatStaticCheckLanguagesSummary(...)`: summarize enabled and configured checker languages [`src/index.ts`]
-      - `buildStaticCheckMenuChoices(...)`: serialize guided add/remove actions plus direct per-language toggle rows [`src/index.ts`]
+      - `countConfiguredStaticCheckLanguages(...)`: count languages that retain global checker entries [`src/index.ts`]
+      - `countEnabledStaticCheckLanguages(...)`: count languages whose local enable flag is on [`src/index.ts`]
+      - `formatStaticCheckLanguagesSummary(...)`: summarize enabled languages and configured global checker languages [`src/index.ts`]
+      - `buildStaticCheckMenuChoices(...)`: serialize guided add/remove actions plus direct per-language local toggle rows [`src/index.ts`]
         - `getSupportedStaticCheckLanguageSupport(...)`: enumerate supported languages and extensions [`src/core/static-check.ts`]
           - `getSupportedStaticCheckLanguages(...)`: enumerate canonical supported languages [`src/core/static-check.ts`]
         - `buildTerminalSettingsMenuChoices(...)`: append the canonical value-less `Reset defaults` row to the selector menu [`src/index.ts`]
@@ -1139,7 +1179,7 @@
           - `createStaticCheckLanguageConfig(...)`: clone checker entries and derive the enable flag [`src/core/config.ts`]
       - `createStaticCheckLanguageConfig(...)`: create empty per-language configs for toggle and removal flows [`src/core/config.ts`]
       - `shellSplit(...)`: parse optional parameter input [`src/core/utils.ts`]
-    - `configurePiUsereqToolsMenu(...)`: interactive active-tool editor whose per-tool toggle submenu keeps focus while cycling `on|off` values [`src/index.ts`]
+    - `configurePiUsereqToolsMenu(...)`: interactive active-tool editor whose per-tool toggle submenu keeps focus while persisting enablement in global config [`src/index.ts`]
       - `applyConfiguredPiUsereqTools(...)`: enforce configured active-tool set [`src/index.ts`]
         - `getConfiguredEnabledPiUsereqTools(...)`: canonicalize configured enabled tools [`src/index.ts`]
           - `normalizeEnabledPiUsereqTools(...)`: canonicalize configurable active tools [`src/core/pi-usereq-tools.ts`]
@@ -1152,15 +1192,16 @@
           - `getPiUsereqStartupTools(...)`: enumerate configurable tools from runtime inventory in documented menu order [`src/index.ts`]
       - `buildPiUsereqToolToggleChoices(...)`: serialize per-tool startup-toggle rows plus the value-less terminal reset action [`src/index.ts`]
         - `buildTerminalSettingsMenuChoices(...)`: append the canonical value-less `Reset defaults` row to the selector menu [`src/index.ts`]
-    - `configureDebugMenu(...)`: interactive debug editor with in-place enable or disable toggles, workflow filters, reset confirmation, and per-tool plus per-prompt selectors [`src/index.ts`]
-      - `buildDebugMenuChoices(...)`: serialize global debug controls, workflow-event toggles, canonical tool and prompt toggles, and the value-less terminal reset row [`src/index.ts`]
+    - `configureDebugMenu(...)`: interactive debug editor with in-place enable or disable toggles, tool-wrapper command registration, workflow filters, reset confirmation, and per-tool plus per-prompt selectors [`src/index.ts`]
+      - `buildDebugMenuChoices(...)`: serialize global debug controls, the `Enable debug commands for tools` row, workflow-event toggles, canonical tool and prompt toggles, and the value-less terminal reset row [`src/index.ts`]
         - `buildDebugMenuChoice(...)`: dim and disable locked debug rows while global debug is off [`src/index.ts`]
         - `getDebugToolToggleNames(...)`: enumerate debuggable tool names in canonical grouped order [`src/index.ts`]
+      - `registerDebugToolCommands(...)`: register debug slash-command wrappers immediately when the tool-wrapper row transitions to `enable` [`src/index.ts`]
       - `selectDebugLogOnStatus(...)`: select one explicit workflow-state filter or `any` [`src/index.ts`]
       - `confirmResetChanges(...)`: require explicit approval before applying reset mutations [`src/index.ts`]
       - `resetDebugConfigToDefaults(...)`: restore the debug configuration subtree to documented defaults [`src/index.ts`]
-    - `configurePiNotifyMenu(...)`: interactive notify, sound, and Pushover editor with in-place global toggles, credential-locked enablement guidance text, immediate-save persisted boot-sound mutations, reset confirmation, and dedicated event submenus [`src/index.ts`]
-      - `buildPiNotifyMenuChoices(...)`: serialize command-notify, sound, and Pushover blocks plus shared-event submenu launchers and the value-less terminal reset row, including boot-sound rows sourced from persisted config [`src/index.ts`]
+    - `configurePiNotifyMenu(...)`: interactive notify, sound, and Pushover editor that persists every subtree mutation in global config while keeping runtime sound edits in memory only [`src/index.ts`]
+      - `buildPiNotifyMenuChoices(...)`: serialize command-notify, sound, and Pushover blocks plus shared-event submenu launchers and the value-less terminal reset row, including boot-sound rows sourced from persisted global config [`src/index.ts`]
         - `buildPiNotifyEventLauncherChoice(...)`: serialize one event-submenu launcher row with a compact enabled-toggle summary [`src/index.ts`]
         - `buildPiNotifyPushoverRows(...)`: serialize direct Pushover rows with locked enablement guidance text plus the shared event-submenu launcher [`src/index.ts`]
         - `buildTerminalSettingsMenuChoices(...)`: append the canonical value-less `Reset defaults` row [`src/index.ts`]
@@ -1196,7 +1237,7 @@
   - Threads: no explicit threads detected.
 - Internal Call-Trace Tree:
   - `check-branch(...)`: fetch `origin/master`, evaluate tagged-commit containment, and export the downstream gate flag [`.github/workflows/release-npm.yml`]
-    - External boundaries: `actions/checkout@v4`, GitHub Actions runner shell, `git` CLI, `grep`, and `$GITHUB_OUTPUT`.
+    - External boundaries: `actions/checkout@v5`, GitHub Actions runner shell, `git` CLI, `grep`, and `$GITHUB_OUTPUT`.
 - External Boundaries:
   - GitHub Actions event routing, hosted-runner lifecycle, checkout action, git subprocesses, and runner output channels.
 
@@ -1209,8 +1250,8 @@
   - Looping model: single-pass job with sequential step execution.
   - Threads: no explicit threads detected.
 - Internal Call-Trace Tree:
-  - `build-release(...)`: checkout repository content, configure Node.js for npm, install dependencies, remove manifest `private`, publish the package, build changelog text, and create the GitHub Release [`.github/workflows/release-npm.yml`]
-    - External boundaries: `actions/checkout@v4`, `actions/setup-node@v4`, npm CLI, npm registry, OIDC token issuance, `mikepenz/release-changelog-builder-action@v6`, `softprops/action-gh-release@v2`, `secrets.NPM_TOKEN`, and `secrets.GITHUB_TOKEN`.
+  - `build-release(...)`: checkout repository content, configure Node.js `24.15.0` for npm publication, install dependencies, remove manifest `private`, publish the package, build changelog text, and create the GitHub Release [`.github/workflows/release-npm.yml`]
+    - External boundaries: `actions/checkout@v5`, `actions/setup-node@v5`, npm CLI, npm registry, OIDC token issuance, `mikepenz/release-changelog-builder-action@v6`, `softprops/action-gh-release@v2`, `secrets.NPM_TOKEN`, and `secrets.GITHUB_TOKEN`.
 - External Boundaries:
   - GitHub Actions event routing, hosted-runner lifecycle, checkout action, setup-node action, npm CLI, npm registry, changelog-builder action, GitHub Releases API, and repository secrets.