pi-usereq 0.4.0 → 0.5.0

package/src/index.ts

@@ -8,7 +8,7 @@
  * @brief Declares the extension version string.
  * @details The value is exported for external inspection and packaging metadata alignment. Access complexity is O(1).
  */
-export const VERSION = "0.4.0"
+export const VERSION = "0.5.0"
 
 import path from "node:path";
 import type {
@@ -53,6 +53,7 @@ import {
 } from "./core/find-payload.js";
 import {
   getDefaultConfig,
+  getProjectConfigPath,
   loadConfig,
   normalizeConfigPaths,
   saveConfig,
@@ -62,10 +63,19 @@ import {
 import {
   cyclePiNotifySoundLevel,
   formatPiNotifyBeepStatus,
+  formatPiNotifyPushoverStatus,
+  normalizePiNotifyPushoverCredential,
+  normalizePiNotifyPushoverPriority,
   runPiNotifyEffects,
+  type PiNotifyPushoverPriority,
+  type PiNotifyPushoverRequest,
   type PiNotifySoundLevel,
 } from "./core/pi-notify.js";
-import { buildRuntimePathContext, buildRuntimePathFacts } from "./core/path-context.js";
+import {
+  buildRuntimePathContext,
+  buildRuntimePathFacts,
+  formatRuntimePathForDisplay,
+} from "./core/path-context.js";
 import { resolveRuntimeGitPath } from "./core/runtime-project-paths.js";
 import { showPiUsereqSettingsMenu, type PiUsereqSettingsMenuChoice } from "./core/settings-menu.js";
 import {
@@ -193,6 +203,19 @@ function saveProjectConfig(cwd: string, config: UseReqConfig): void {
   saveConfig(projectBase, normalizeConfigPaths(projectBase, config));
 }
 
+/**
+ * @brief Formats the current project config path for top-level menu display.
+ * @details Resolves `<base-path>/.pi-usereq/config.json` from the cwd-derived
+ * project base and formats it relative to the user home when possible. Runtime
+ * is O(p) in path length. No external state is mutated.
+ * @param[in] cwd {string} Current working directory.
+ * @return {string} User-home-relative or absolute config path display value.
+ * @satisfies REQ-162
+ */
+function formatProjectConfigPathForMenu(cwd: string): string {
+  return formatRuntimePathForDisplay(getProjectConfigPath(getProjectBase(cwd)));
+}
+
 /**
  * @brief Collects the project-scoped static-check selection used by the agent tool.
  * @details Resolves configured source plus test directories, reuses the same fixture-root exclusions as `runProjectStaticCheck`, and returns canonical relative file paths for structured payload emission. Runtime is O(F) plus project file-discovery cost. Side effects are limited to filesystem reads and git subprocesses delegated through `collectSourceFiles`.
@@ -537,18 +560,20 @@ function applyConfiguredPiUsereqTools(pi: ExtensionAPI, config: UseReqConfig): v
  * @details Applies session-start-specific resource validation, project-config
  * refresh, and startup-tool enablement before forwarding the originating hook
  * name and payload into the shared `updateExtensionStatus(...)` pipeline.
- * On `agent_end`, also dispatches configured pi-notify beep and sound effects.
- * Runtime is dominated by configuration loading during `session_start`; all
- * other hooks are O(1). Side effects include resource checks, active-tool
- * mutation, status updates, live-ticker disposal on shutdown, stdout writes,
- * and optional child-process spawning.
+ * On `agent_end`, also dispatches configured pi-notify beep, sound, and
+ * prompt-specific Pushover effects when the current run originates from a
+ * bundled prompt command. Runtime is dominated by configuration loading during
+ * `session_start`; all other hooks are O(1). Side effects include resource
+ * checks, active-tool mutation, status updates, live-ticker disposal on
+ * shutdown, stdout writes, optional child-process spawning, and outbound
+ * HTTPS requests.
  * @param[in] pi {ExtensionAPI} Active extension API instance.
  * @param[in,out] statusController {PiUsereqStatusController} Mutable status controller.
  * @param[in] hookName {PiUsereqStatusHookName} Intercepted hook name.
  * @param[in] event {unknown} Hook payload forwarded by pi.
  * @param[in] ctx {ExtensionContext} Active extension context.
  * @return {Promise<void>} Promise resolved when hook processing completes.
- * @satisfies REQ-117, REQ-118, REQ-119, REQ-129, REQ-130, REQ-131, REQ-132, REQ-133
+ * @satisfies REQ-117, REQ-118, REQ-119, REQ-129, REQ-130, REQ-131, REQ-132, REQ-133, REQ-166, REQ-167, REQ-168, REQ-169, REQ-172
  */
 async function handleExtensionStatusEvent(
   pi: ExtensionAPI,
@@ -564,8 +589,24 @@ async function handleExtensionStatusEvent(
     setPiUsereqStatusConfig(statusController, config);
   }
   updateExtensionStatus(statusController, hookName, event, ctx);
-  if (hookName === "agent_end" && statusController.config) {
-    runPiNotifyEffects(statusController.config, event as { messages: AgentEndEvent["messages"] });
+  if (hookName === "agent_end") {
+    if (statusController.config) {
+      const pushoverRequest: PiNotifyPushoverRequest | undefined = statusController.state.activePromptRequest
+        && statusController.state.lastRunDurationMs !== undefined
+        ? {
+            promptName: statusController.state.activePromptRequest.promptName,
+            promptArgs: statusController.state.activePromptRequest.promptArgs,
+            basePath: path.resolve(ctx.cwd),
+            completionTimeMs: statusController.state.lastRunDurationMs,
+          }
+        : undefined;
+      runPiNotifyEffects(
+        statusController.config,
+        event as { messages: AgentEndEvent["messages"] },
+        pushoverRequest,
+      );
+    }
+    statusController.state.activePromptRequest = undefined;
   }
   if (hookName === "session_shutdown") {
     disposePiUsereqStatusController(statusController);
@@ -671,12 +712,162 @@ function togglePiNotifyBeepFlag(config: UseReqConfig, key: PiNotifyBeepConfigKey
   return config[key];
 }
 
+/**
+ * @brief Formats one persisted Pushover priority for menu display.
+ * @details Maps the canonical `0|1` priority domain to deterministic menu text reused by the Pushover configuration UI. Runtime is O(1). No external state is mutated.
+ * @param[in] priority {PiNotifyPushoverPriority} Persisted Pushover priority.
+ * @return {string} Menu-display label.
+ * @satisfies REQ-165
+ */
+function formatPiNotifyPushoverPriority(priority: PiNotifyPushoverPriority): string {
+  return priority === 1 ? "1=High Priority" : "0=Normal";
+}
+
+/**
+ * @brief Builds the shared settings-menu choices for Pushover configuration.
+ * @details Serializes the Pushover global-disable flag, successful-completion enable flag, credential strings, and priority value into right-valued menu rows consumed by the shared settings-menu renderer. Runtime is O(1). No external state is mutated.
+ * @param[in] config {UseReqConfig} Effective project configuration.
+ * @return {PiUsereqSettingsMenuChoice[]} Ordered Pushover-menu choice vector.
+ * @satisfies REQ-163, REQ-165, REQ-166, REQ-172
+ */
+function buildPiNotifyPushoverMenuChoices(config: UseReqConfig): PiUsereqSettingsMenuChoice[] {
+  return [
+    {
+      id: "pushover-global-disable",
+      label: "Global disable",
+      value: config["notify-pushover-global-disable"] ? "on" : "off",
+      description: "Suppress all Pushover delivery without changing the successful-prompt enable flag.",
+    },
+    {
+      id: "pushover-on-success",
+      label: "Notify on success",
+      value: formatPiNotifyPushoverStatus(config),
+      description: "Toggle Pushover delivery after successful prompt completion only.",
+    },
+    {
+      id: "pushover-user-key",
+      label: "User Key/Delivery Group Key",
+      value: config["notify-pushover-user-key"] || "(empty)",
+      description: "Edit the Pushover user key or delivery group key sent with successful prompt notifications.",
+    },
+    {
+      id: "pushover-api-token",
+      label: "Token/API Token Key",
+      value: config["notify-pushover-api-token"] || "(empty)",
+      description: "Edit the Pushover application token used for successful prompt notifications.",
+    },
+    {
+      id: "pushover-priority",
+      label: "Priority",
+      value: formatPiNotifyPushoverPriority(config["notify-pushover-priority"]),
+      description: "Select whether successful prompt notifications use normal or high Pushover priority.",
+    },
+    {
+      id: "back",
+      label: "Back",
+      value: "",
+      description: "Return to the notifications menu.",
+    },
+  ];
+}
+
+/**
+ * @brief Opens the shared settings-menu selector for Pushover priority.
+ * @details Reuses the pi-usereq settings-menu renderer so Pushover priority selection remains stylistically aligned with the existing notification menus and returns the chosen priority or `undefined` on cancel. Runtime depends on user interaction count. Side effects are limited to transient custom-UI rendering.
+ * @param[in] ctx {ExtensionCommandContext} Active command context.
+ * @param[in] currentPriority {PiNotifyPushoverPriority} Persisted priority value.
+ * @return {Promise<PiNotifyPushoverPriority | undefined>} Selected priority or `undefined` when cancelled.
+ * @satisfies REQ-165
+ */
+async function selectPiNotifyPushoverPriority(
+  ctx: ExtensionCommandContext,
+  currentPriority: PiNotifyPushoverPriority,
+): Promise<PiNotifyPushoverPriority | undefined> {
+  const choice = await showPiUsereqSettingsMenu(ctx, "Pushover priority", [
+    {
+      id: "0",
+      label: "0=Normal",
+      value: currentPriority === 0 ? "selected" : "",
+      description: "Send successful prompt notifications with normal Pushover priority.",
+    },
+    {
+      id: "1",
+      label: "1=High Priority",
+      value: currentPriority === 1 ? "selected" : "",
+      description: "Send successful prompt notifications with high Pushover priority.",
+    },
+  ]);
+  if (!choice) {
+    return undefined;
+  }
+  return normalizePiNotifyPushoverPriority(choice);
+}
+
+/**
+ * @brief Runs the interactive Pushover-configuration menu.
+ * @details Exposes the Pushover global-disable flag, successful-completion enable flag, user key, API token, and priority selector through the shared settings-menu renderer. Runtime depends on user interaction count. Side effects include UI updates and config mutation.
+ * @param[in] ctx {ExtensionCommandContext} Active command context.
+ * @param[in,out] config {UseReqConfig} Mutable configuration object.
+ * @return {Promise<void>} Promise resolved when the menu closes.
+ * @satisfies REQ-163, REQ-165, REQ-166, REQ-172
+ */
+async function configurePiNotifyPushoverMenu(
+  ctx: ExtensionCommandContext,
+  config: UseReqConfig,
+): Promise<void> {
+  while (true) {
+    const choice = await showPiUsereqSettingsMenu(ctx, "Pushover notifications", buildPiNotifyPushoverMenuChoices(config));
+    if (!choice || choice === "back") {
+      return;
+    }
+    if (choice === "pushover-global-disable") {
+      config["notify-pushover-global-disable"] = !config["notify-pushover-global-disable"];
+      ctx.ui.notify(`Pushover global disable ${config["notify-pushover-global-disable"] ? "enabled" : "disabled"}`, "info");
+      continue;
+    }
+    if (choice === "pushover-on-success") {
+      config["notify-pushover-on-success"] = !config["notify-pushover-on-success"];
+      ctx.ui.notify(`Pushover on success ${config["notify-pushover-on-success"] ? "enabled" : "disabled"}`, "info");
+      continue;
+    }
+    if (choice === "pushover-user-key") {
+      const value = await ctx.ui.input(
+        "User Key/Delivery Group Key",
+        config["notify-pushover-user-key"] || "gzfjjvp1xxmhibqwzh9m7i1zwvf83j",
+      );
+      if (value !== undefined) {
+        config["notify-pushover-user-key"] = normalizePiNotifyPushoverCredential(value);
+        ctx.ui.notify("Updated Pushover user key", "info");
+      }
+      continue;
+    }
+    if (choice === "pushover-api-token") {
+      const value = await ctx.ui.input(
+        "Token/API Token Key",
+        config["notify-pushover-api-token"] || "ah6bf5u2sj63mcvou6qamiabeoubbe",
+      );
+      if (value !== undefined) {
+        config["notify-pushover-api-token"] = normalizePiNotifyPushoverCredential(value);
+        ctx.ui.notify("Updated Pushover API token", "info");
+      }
+      continue;
+    }
+    if (choice === "pushover-priority") {
+      const nextPriority = await selectPiNotifyPushoverPriority(ctx, config["notify-pushover-priority"]);
+      if (nextPriority !== undefined) {
+        config["notify-pushover-priority"] = nextPriority;
+        ctx.ui.notify(`Pushover priority set to ${formatPiNotifyPushoverPriority(nextPriority)}`, "info");
+      }
+    }
+  }
+}
+
 /**
  * @brief Builds the shared settings-menu choices for notification configuration.
- * @details Serializes the current beep flags, selected notify command, hotkey bind, and per-level notify commands into right-valued menu rows consumed by the shared settings-menu renderer. Runtime is O(1) plus command-length formatting. No external state is mutated.
+ * @details Serializes the current beep flags, selected notify command, hotkey bind, per-level notify commands, and the Pushover submenu entry into right-valued menu rows consumed by the shared settings-menu renderer. Runtime is O(1) plus command-length formatting. No external state is mutated.
  * @param[in] config {UseReqConfig} Effective project configuration.
  * @return {PiUsereqSettingsMenuChoice[]} Ordered notification-menu choice vector.
- * @satisfies REQ-137, REQ-149, REQ-150, REQ-151, REQ-152
+ * @satisfies REQ-137, REQ-149, REQ-150, REQ-151, REQ-152, REQ-163, REQ-164, REQ-165, REQ-166, REQ-172
  */
 function buildPiNotifyMenuChoices(config: UseReqConfig): PiUsereqSettingsMenuChoice[] {
   return [
@@ -728,6 +919,12 @@ function buildPiNotifyMenuChoices(config: UseReqConfig): PiUsereqSettingsMenuCho
       value: config.PI_NOTIFY_SOUND_HIGH_CMD,
       description: "Edit the shell command used when the selected notify command is `high`.",
     },
+    {
+      id: "pushover-notifications",
+      label: "Pushover notifications",
+      value: formatPiNotifyPushoverStatus(config),
+      description: "Open the Pushover submenu for successful-completion delivery, credentials, priority, and global disable.",
+    },
     {
       id: "back",
       label: "Back",
@@ -780,11 +977,11 @@ async function selectPiNotifySoundLevel(
 
 /**
  * @brief Runs the interactive notification-configuration menu.
- * @details Exposes prompt-end beep toggles, selected notify-command selection, hotkey-bind editing, and per-level notify-command editors through the shared settings-menu renderer. Runtime depends on user interaction count. Side effects include UI updates and config mutation.
+ * @details Exposes prompt-end beep toggles, selected notify-command selection, hotkey-bind editing, per-level notify-command editors, and the nested Pushover submenu through the shared settings-menu renderer. Runtime depends on user interaction count. Side effects include UI updates and config mutation.
  * @param[in] ctx {ExtensionCommandContext} Active command context.
  * @param[in,out] config {UseReqConfig} Mutable configuration object.
  * @return {Promise<boolean>} `true` when the sound-toggle shortcut changed.
- * @satisfies REQ-129, REQ-131, REQ-133, REQ-134, REQ-137, REQ-149, REQ-150, REQ-151, REQ-152, REQ-153, REQ-154
+ * @satisfies REQ-129, REQ-131, REQ-133, REQ-134, REQ-137, REQ-149, REQ-150, REQ-151, REQ-152, REQ-153, REQ-154, REQ-163, REQ-164, REQ-165, REQ-166, REQ-172
  */
 async function configurePiNotifyMenu(
   ctx: ExtensionCommandContext,
@@ -849,6 +1046,10 @@ async function configurePiNotifyMenu(
         config.PI_NOTIFY_SOUND_HIGH_CMD = value.trim();
         ctx.ui.notify("Updated notify command (high vol.)", "info");
       }
+      continue;
+    }
+    if (choice === "pushover-notifications") {
+      await configurePiNotifyPushoverMenu(ctx, config);
     }
   }
 }
@@ -890,12 +1091,16 @@ function registerPiNotifyShortcut(
 
 /**
  * @brief Registers bundled prompt commands with the extension.
- * @details Creates one `req-<prompt>` command per bundled prompt name. Each handler ensures resources exist, renders the prompt, and sends it into the current active session. Runtime is O(p) for registration; handler cost depends on prompt rendering plus prompt dispatch. Side effects include command registration and user-message delivery during execution.
+ * @details Creates one `req-<prompt>` command per bundled prompt name. Each handler ensures resources exist, records the prompt metadata needed for successful completion notifications, renders the prompt, and sends it into the current active session. Runtime is O(p) for registration; handler cost depends on prompt rendering plus prompt dispatch. Side effects include command registration, status-controller mutation, and user-message delivery during execution.
  * @param[in] pi {ExtensionAPI} Active extension API instance.
+ * @param[in,out] statusController {PiUsereqStatusController} Mutable status controller.
  * @return {void} No return value.
- * @satisfies REQ-004, REQ-067, REQ-068
+ * @satisfies REQ-004, REQ-067, REQ-068, REQ-169
  */
-function registerPromptCommands(pi: ExtensionAPI): void {
+function registerPromptCommands(
+  pi: ExtensionAPI,
+  statusController: PiUsereqStatusController,
+): void {
   PROMPT_NAMES.forEach((promptName) => {
     pi.registerCommand(`req-${promptName}`, {
       description: `Run pi-usereq prompt ${promptName}`,
@@ -903,6 +1108,10 @@ function registerPromptCommands(pi: ExtensionAPI): void {
         ensureBundledResourcesAccessible();
         const projectBase = getProjectBase(ctx.cwd);
         const config = loadProjectConfig(ctx.cwd);
+        statusController.state.pendingPromptRequest = {
+          promptName,
+          promptArgs: args,
+        };
         const content = renderPrompt(promptName, args, projectBase, config);
         await deliverPromptCommand(pi, content);
       },
@@ -1721,7 +1930,7 @@ function formatStaticCheckLanguagesSummary(config: UseReqConfig): string {
 
 /**
  * @brief Renders the static-check configuration reference view.
- * @details Produces a markdown-like summary containing configured entries, supported languages, supported modules, and example specifications. Runtime is O(l log l). No side effects occur.
+ * @details Produces a markdown-like summary containing configured entries, supported languages, the Command-only user module surface, and canonical example specifications. Runtime is O(l log l). No side effects occur.
  * @param[in] config {UseReqConfig} Effective project configuration.
  * @return {string} Reference text for the editor view.
  */
@@ -1744,16 +1953,23 @@ function renderStaticCheckReference(config: UseReqConfig): string {
   for (const { language, extensions } of getSupportedStaticCheckLanguageSupport()) {
     lines.push(`- ${language}: ${extensions.join(", ")}`);
   }
-  lines.push("", `Supported modules: ${STATIC_CHECK_MODULES.join(", ")}`, "", "Examples:", "- Python=Ruff", "- Python=Command,mypy,--strict", "- TypeScript=Command,eslint,--max-warnings,0");
+  lines.push(
+    "",
+    `Supported modules: ${STATIC_CHECK_MODULES.join(", ")}`,
+    "",
+    "Examples:",
+    "- Python=Command,mypy,--strict",
+    "- TypeScript=Command,eslint,--max-warnings,0",
+  );
   return `${lines.join("\n")}\n`;
 }
 
 /**
  * @brief Builds the shared settings-menu choices for static-check management.
- * @details Serializes static-check actions into right-valued menu rows consumed by the shared settings-menu renderer. Runtime is O(1). No external state is mutated.
+ * @details Serializes Command-oriented static-check actions into right-valued menu rows consumed by the shared settings-menu renderer while omitting user-facing module selection. Runtime is O(1). No external state is mutated.
  * @param[in] config {UseReqConfig} Effective project configuration.
  * @return {PiUsereqSettingsMenuChoice[]} Ordered static-check menu choices.
- * @satisfies REQ-008, REQ-151, REQ-152, REQ-153, REQ-154
+ * @satisfies REQ-008, REQ-160, REQ-161, REQ-151, REQ-152, REQ-153, REQ-154
  */
 function buildStaticCheckMenuChoices(config: UseReqConfig): PiUsereqSettingsMenuChoice[] {
   const supportedLanguageCount = getSupportedStaticCheckLanguageSupport().length;
@@ -1763,13 +1979,13 @@ function buildStaticCheckMenuChoices(config: UseReqConfig): PiUsereqSettingsMenu
       id: "add-entry-supported-language",
       label: "Add entry for supported language",
       value: `${supportedLanguageCount} languages`,
-      description: "Select a supported language, then select one static-check module to add.",
+      description: "Select a supported language, then configure the Command static-check executable.",
     },
     {
       id: "add-entry-raw-spec",
       label: "Add entry from LANG=MODULE[,CMD[,PARAM...]]",
       value: "raw spec",
-      description: "Enter one raw static-check specification string in canonical CLI format.",
+      description: "Enter one raw Command-based static-check specification string in canonical CLI format.",
     },
     {
       id: "remove-language-entry",
@@ -1794,7 +2010,7 @@ function buildStaticCheckMenuChoices(config: UseReqConfig): PiUsereqSettingsMenu
 
 /**
  * @brief Builds the shared settings-menu choices for supported static-check languages.
- * @details Exposes every supported language as one row whose right-side value reports extensions plus the current configured checker count. Runtime is O(l log l). No external state is mutated.
+ * @details Exposes every supported language as one row whose right-side value reports extensions plus the current configured checker count for Command-oriented configuration flows. Runtime is O(l log l). No external state is mutated.
  * @param[in] config {UseReqConfig} Effective project configuration.
  * @return {PiUsereqSettingsMenuChoice[]} Ordered language-choice vector.
  */
@@ -1807,7 +2023,7 @@ function buildSupportedStaticCheckLanguageChoices(config: UseReqConfig): PiUsere
         id: language,
         label: language,
         value: `${extensions.join(", ")} • ${configuredCount} ${suffix}`,
-        description: `Configure static-check modules for ${language}. Supported extensions: ${extensions.join(", ")}.`,
+        description: `Configure the Command static-check entry for ${language}. Supported extensions: ${extensions.join(", ")}.`,
       };
     }),
     {
@@ -1819,31 +2035,6 @@ function buildSupportedStaticCheckLanguageChoices(config: UseReqConfig): PiUsere
   ];
 }
 
-/**
- * @brief Builds the shared settings-menu choices for static-check modules.
- * @details Exposes every supported static-check module as one selectable row with a concise execution description. Runtime is O(m) in module count. No external state is mutated.
- * @param[in] language {string} Canonical selected language.
- * @return {PiUsereqSettingsMenuChoice[]} Ordered module-choice vector.
- */
-function buildStaticCheckModuleChoices(language: string): PiUsereqSettingsMenuChoice[] {
-  return [
-    ...STATIC_CHECK_MODULES.map((moduleName) => ({
-      id: moduleName,
-      label: moduleName,
-      value: language,
-      description: moduleName === "Command"
-        ? `Run one explicit external command against ${language} files.`
-        : `Run the built-in ${moduleName} checker for ${language} files.`,
-    })),
-    {
-      id: "back",
-      label: "Back",
-      value: "",
-      description: "Return to language selection.",
-    },
-  ];
-}
-
 /**
  * @brief Builds the shared settings-menu choices for configured static-check languages.
  * @details Exposes only languages that currently have at least one configured checker so removal remains deterministic. Runtime is O(l log l). No external state is mutated.
@@ -1871,11 +2062,11 @@ function buildConfiguredStaticCheckLanguageChoices(config: UseReqConfig): PiUser
 
 /**
  * @brief Runs the interactive static-check configuration menu.
- * @details Lets the user inspect support, add entries by guided prompts or raw spec strings, and remove configured language entries through the shared settings-menu renderer until the user exits. Runtime depends on user interaction count. Side effects include UI updates and config mutation.
+ * @details Lets the user inspect support, add Command entries by guided prompts or raw spec strings, and remove configured language entries through the shared settings-menu renderer until the user exits. Runtime depends on user interaction count. Side effects include UI updates and config mutation.
  * @param[in] ctx {ExtensionCommandContext} Active command context.
  * @param[in,out] config {UseReqConfig} Mutable configuration object.
  * @return {Promise<void>} Promise resolved when the menu closes.
- * @satisfies REQ-008, REQ-151, REQ-152, REQ-153, REQ-154
+ * @satisfies REQ-008, REQ-160, REQ-161, REQ-151, REQ-152, REQ-153, REQ-154
  */
 async function configureStaticCheckMenu(ctx: ExtensionCommandContext, config: UseReqConfig): Promise<void> {
   while (true) {
@@ -1895,23 +2086,16 @@ async function configureStaticCheckMenu(ctx: ExtensionCommandContext, config: Us
       if (!selectedLanguage || selectedLanguage === "back") {
         continue;
       }
-      const moduleName = await showPiUsereqSettingsMenu(ctx, `static-check for ${selectedLanguage}`, buildStaticCheckModuleChoices(selectedLanguage));
-      if (!moduleName || moduleName === "back") {
-        continue;
-      }
 
-      const entry: StaticCheckEntry = { module: moduleName };
-      if (moduleName === "Command") {
-        const cmd = await ctx.ui.input(`Command executable for ${selectedLanguage}`, "");
-        if (!cmd?.trim()) {
-          ctx.ui.notify(`Command executable is required for ${selectedLanguage}`, "error");
-          continue;
-        }
-        entry.cmd = cmd.trim();
+      const cmd = await ctx.ui.input(`Command executable for ${selectedLanguage}`, "");
+      if (!cmd?.trim()) {
+        ctx.ui.notify(`Command executable is required for ${selectedLanguage}`, "error");
+        continue;
       }
 
+      const entry: StaticCheckEntry = { module: "Command", cmd: cmd.trim() };
       const paramsInput = await ctx.ui.input(
-        `Additional parameters for ${moduleName} on ${selectedLanguage} (optional, shell-style)`,
+        `Additional parameters for Command on ${selectedLanguage} (optional, shell-style)`,
         "",
       );
       const params = paramsInput?.trim() ? shellSplit(paramsInput.trim()) : [];
@@ -1926,7 +2110,7 @@ async function configureStaticCheckMenu(ctx: ExtensionCommandContext, config: Us
     }
 
     if (staticChoice === "add-entry-raw-spec") {
-      const spec = await ctx.ui.input("Static-check spec", "Python=Ruff");
+      const spec = await ctx.ui.input("Static-check spec", "Python=Command,true");
       if (!spec?.trim()) {
         continue;
       }
@@ -1954,12 +2138,16 @@ async function configureStaticCheckMenu(ctx: ExtensionCommandContext, config: Us
 
 /**
  * @brief Builds the shared settings-menu choices for the top-level pi-usereq configuration UI.
- * @details Serializes primary configuration actions into right-valued menu rows consumed by the shared settings-menu renderer. Runtime is O(s) in source-directory count. No external state is mutated.
+ * @details Serializes primary configuration actions into right-valued menu rows consumed by the shared settings-menu renderer, including the display-only config path beside `show-config`. Runtime is O(s) in source-directory count. No external state is mutated.
+ * @param[in] cwd {string} Current working directory.
  * @param[in] config {UseReqConfig} Effective project configuration.
  * @return {PiUsereqSettingsMenuChoice[]} Ordered top-level menu choices.
- * @satisfies REQ-006, REQ-031, REQ-137, REQ-150, REQ-151, REQ-152
+ * @satisfies REQ-006, REQ-031, REQ-137, REQ-150, REQ-151, REQ-152, REQ-162
  */
-function buildPiUsereqMenuChoices(config: UseReqConfig): PiUsereqSettingsMenuChoice[] {
+function buildPiUsereqMenuChoices(
+  cwd: string,
+  config: UseReqConfig,
+): PiUsereqSettingsMenuChoice[] {
   return [
     {
       id: "docs-dir",
@@ -1995,7 +2183,14 @@ function buildPiUsereqMenuChoices(config: UseReqConfig): PiUsereqSettingsMenuCho
       id: "notifications",
       label: "notifications",
       value: `beep:${formatPiNotifyBeepStatus(config)} • sound:${config["notify-sound"]}`,
-      description: "Manage terminal beep flags, selected notify command, hotkey bind, and per-level notify commands.",
+      description: "Manage terminal beep flags, selected notify command, hotkey bind, per-level notify commands, and the nested Pushover submenu.",
+    },
+    {
+      id: "show-config",
+      label: "show-config",
+      value: formatProjectConfigPathForMenu(cwd),
+      valueTone: "dim",
+      description: "Write the current project configuration JSON into the editor without saving additional changes.",
     },
     {
       id: "reset-defaults",
@@ -2003,12 +2198,6 @@ function buildPiUsereqMenuChoices(config: UseReqConfig): PiUsereqSettingsMenuCho
       value: "",
       description: "Restore the default pi-usereq configuration for the current project base.",
     },
-    {
-      id: "show-config",
-      label: "show-config",
-      value: "",
-      description: "Write the current project configuration JSON into the editor without saving additional changes.",
-    },
     {
       id: "save-and-close",
       label: "Save and close",
@@ -2074,12 +2263,12 @@ function buildSrcDirRemovalChoices(config: UseReqConfig): PiUsereqSettingsMenuCh
 
 /**
  * @brief Runs the top-level pi-usereq configuration menu.
- * @details Loads project config, exposes docs/test/source/static-check/startup-tool/notification actions through the shared settings-menu renderer, persists changes on exit, and refreshes the single-line status bar. Runtime depends on user interaction count. Side effects include UI updates, config writes, and active-tool changes.
+ * @details Loads project config, exposes docs/test/source/static-check/startup-tool/notification actions through the shared settings-menu renderer, persists changes on exit, and refreshes the single-line status bar. Runtime depends on user interaction count. Side effects include UI updates, config writes, active-tool changes, and editor text updates.
  * @param[in] pi {ExtensionAPI} Active extension API instance.
  * @param[in] ctx {ExtensionCommandContext} Active command context.
  * @param[in,out] statusController {PiUsereqStatusController} Mutable status controller.
  * @return {Promise<void>} Promise resolved when configuration is saved and the menu closes.
- * @satisfies REQ-006, REQ-031, REQ-137, REQ-150, REQ-151, REQ-152, REQ-153, REQ-154
+ * @satisfies REQ-006, REQ-031, REQ-137, REQ-150, REQ-151, REQ-152, REQ-153, REQ-154, REQ-162
  */
 async function configurePiUsereq(
   pi: ExtensionAPI,
@@ -2096,7 +2285,11 @@ async function configurePiUsereq(
   };
 
   while (true) {
-    const choice = await showPiUsereqSettingsMenu(ctx, "pi-usereq", buildPiUsereqMenuChoices(config));
+    const choice = await showPiUsereqSettingsMenu(
+      ctx,
+      "pi-usereq",
+      buildPiUsereqMenuChoices(ctx.cwd, config),
+    );
     if (!choice || choice === "save-and-close") {
       ensureSaved();
       refreshStatus();
@@ -2190,18 +2383,20 @@ function registerConfigCommands(
  * configuration commands plus agent tools, registers the configurable
  * successful-run sound shortcut when the runtime supports shortcuts, and
  * installs shared wrappers for all supported pi lifecycle hooks so status
- * telemetry, context usage, prompt timing, and pi-notify effects remain
- * synchronized with runtime events. Runtime is O(h) in hook count during
- * registration. Side effects include filesystem reads, command/tool/shortcut
- * registration, UI updates, active-tool changes, and timer scheduling.
+ * telemetry, context usage, prompt timing, cumulative runtime, prompt-specific
+ * Pushover metadata, and pi-notify effects remain synchronized with runtime
+ * events. Runtime is O(h) in hook
+ * count during registration. Side effects include filesystem reads,
+ * command/tool/shortcut registration, UI updates, active-tool changes, and
+ * timer scheduling.
  * @param[in] pi {ExtensionAPI} Active extension API instance.
  * @return {void} No return value.
- * @satisfies DES-002, REQ-004, REQ-005, REQ-009, REQ-044, REQ-045, REQ-067, REQ-068, REQ-109, REQ-110, REQ-111, REQ-112, REQ-113, REQ-114, REQ-115, REQ-116, REQ-117, REQ-118, REQ-119, REQ-120, REQ-121, REQ-122, REQ-123, REQ-124, REQ-125, REQ-126, REQ-129, REQ-130, REQ-131, REQ-132, REQ-133, REQ-134, REQ-135, REQ-136, REQ-137
+ * @satisfies DES-002, REQ-004, REQ-005, REQ-009, REQ-044, REQ-045, REQ-067, REQ-068, REQ-109, REQ-111, REQ-112, REQ-113, REQ-114, REQ-115, REQ-116, REQ-117, REQ-118, REQ-119, REQ-120, REQ-121, REQ-122, REQ-123, REQ-124, REQ-125, REQ-126, REQ-129, REQ-130, REQ-131, REQ-132, REQ-133, REQ-134, REQ-135, REQ-136, REQ-137, REQ-148, REQ-159, REQ-163, REQ-164, REQ-165, REQ-166, REQ-167, REQ-168, REQ-169, REQ-170, REQ-171, REQ-172
  */
 export default function piUsereqExtension(pi: ExtensionAPI): void {
-  const statusController = createPiUsereqStatusController(() => pi.getActiveTools());
+  const statusController = createPiUsereqStatusController();
   ensureBundledResourcesAccessible();
-  registerPromptCommands(pi);
+  registerPromptCommands(pi, statusController);
   registerAgentTools(pi);
   registerConfigCommands(pi, statusController);
   registerPiNotifyShortcut(pi, statusController);

package/tests/attended-results-scenarios.ts

@@ -357,16 +357,6 @@ function buildStandaloneScenarios(): AttendedScenario[] {
         path.posix.join("standalone", "test-static-check-dummy", `${fixtureName}.json`),
         ["--test-static-check", "dummy", relativeFixturePath],
       ),
-      createStandaloneScenario(
-        `standalone/test-static-check-pylance/${fixtureName}`,
-        path.posix.join("standalone", "test-static-check-pylance", `${fixtureName}.json`),
-        ["--test-static-check", "pylance", relativeFixturePath],
-      ),
-      createStandaloneScenario(
-        `standalone/test-static-check-ruff/${fixtureName}`,
-        path.posix.join("standalone", "test-static-check-ruff", `${fixtureName}.json`),
-        ["--test-static-check", "ruff", relativeFixturePath],
-      ),
       createStandaloneScenario(
         `standalone/test-static-check-command/${fixtureName}`,
         path.posix.join("standalone", "test-static-check-command", `${fixtureName}.json`),
@@ -470,14 +460,14 @@ function buildProjectScenarios(): AttendedScenario[] {
             "--provider",
             "claude:prompts",
             "--enable-static-check",
-            "Python=Pylance",
+            "Python=Command,git,--version",
           ],
           cwd: projectBase,
           normalize: createProjectNormalizer(projectBase),
           cleanup: () => removePath(projectBase),
           postAssert: () => {
             const payload = JSON.parse(fs.readFileSync(getProjectConfigPath(projectBase), "utf8")) as UseReqConfig;
-            assert.deepEqual(payload["static-check"].Python, [{ module: "Pylance" }]);
+            assert.deepEqual(payload["static-check"].Python, [{ module: "Command", cmd: "git", params: ["--version"] }]);
           },
         };
       },
@@ -488,7 +478,7 @@ function buildProjectScenarios(): AttendedScenario[] {
           const script = [
             "from pathlib import Path",
             "from usereq.cli import save_config",
-            `save_config(Path(${JSON.stringify(projectBase)}), 'guidelines', 'docs', 'tests', ['src'], static_check_config={'Python': [{'module': 'Pylance'}]})`,
+            `save_config(Path(${JSON.stringify(projectBase)}), 'guidelines', 'docs', 'tests', ['src'], static_check_config={'Python': [{'module': 'Command', 'cmd': 'git', 'params': ['--version']} ]})`,
           ].join("\n");
           const result = runPythonInline(script, projectBase);
           return createProjectNormalizer(projectBase)(toArchivedCliResult(result));