fix: address PR review findings for optional Actions tab

- Add enableActions to GET_CONFIG relay response
- Handle disabled sentinel in WebSocketDataSource.getFailingActions
- Add enableActions prop to PersonalSummaryStrip
- Set hasPRActivity for PushEvent in parseRepoEvents
- Extract isActionsBasedTab to shared schemas.ts
- Remove unused actionsMonitoringDisabled from DashboardSummary
- Add enableActions gating tests for MCP data-source and tools
- Add custom tab reset and dropdown filtering tests
- Update USER_GUIDE.md with Actions toggle documentation

Author: wgordon17

docs/USER_GUIDE.md

@@ -240,6 +240,8 @@ Sort by: Repo, Title, Author, Checks, Review, Size, Created, Updated (default: U
 
 ## Actions Tab
 
+The Actions tab is enabled by default. You can disable it in **Settings > GitHub Actions > Show Actions tab**. Disabling it hides the tab, skips all workflow run API calls (saving REST API rate limit budget), suppresses workflow run notifications, and hides the "actions running" count from the summary strip. Custom tabs based on Actions are also hidden when disabled. Re-enabling restores the tab immediately; workflow run data refreshes on the next poll cycle.
+
 ### Workflow Grouping
 
 Workflow runs are grouped first by repository, then by workflow name. Each workflow group shows its most recent runs up to the configured limit (default: 3 runs per workflow, up to 5 workflows per repo).
@@ -575,12 +577,13 @@ Settings are saved automatically to `localStorage` and persist across sessions.
 |---------|---------|-------------|
 | Refresh interval | 5 minutes | How often to poll GitHub for new data. Options: 1, 2, 5, 10, 15, 30 minutes, or Off. |
 | CI status refresh (hot poll interval) | 30 seconds | How often to re-check in-flight CI checks and workflow runs. Range: 10–120 seconds. |
-| Max workflows per repo | 5 | Number of active workflows to track per repository. Range: 1–20. |
-| Max runs per workflow | 3 | Number of recent runs to show per workflow. Range: 1–10. |
+| Show Actions tab | On | Show the Actions tab and track workflow runs. Disable to skip all workflow run API calls and simplify the dashboard. |
+| Max workflows per repo | 5 | Number of active workflows to track per repository. Range: 1–20. Disabled when Actions is off. |
+| Max runs per workflow | 3 | Number of recent runs to show per workflow. Range: 1–10. Disabled when Actions is off. |
 | Notifications enabled | Off | Master toggle for browser push notifications. |
 | Notify: Issues | On | Notify when new issues open (requires notifications enabled). |
 | Notify: Pull Requests | On | Notify when PRs are opened or updated (requires notifications enabled). |
-| Notify: Workflow Runs | On | Notify when workflow runs complete (requires notifications enabled). |
+| Notify: Workflow Runs | On | Notify when workflow runs complete (requires notifications enabled). Disabled when Actions is off. |
 | Theme | Auto | UI color theme. Auto follows system dark/light preference (Corporate for light, Dim for dark). |
 | View density | Comfortable | Spacing between list items. Options: Comfortable, Compact. |
 | Items per page | 25 | Number of items per page in each tab. Options: 10, 25, 50, 100. |

mcp/src/data-source.ts

@@ -455,7 +455,7 @@ export class OctokitDataSource implements DataSource {
 
     const actionsEnabled = _cachedConfig?.enableActions !== false;
     if (repos.length === 0) {
-      return { openPRCount: 0, openIssueCount: 0, failingRunCount: actionsEnabled ? 0 : null, needsReviewCount: 0, approvedUnmergedCount: 0, actionsMonitoringDisabled: !actionsEnabled };
+      return { openPRCount: 0, openIssueCount: 0, failingRunCount: actionsEnabled ? 0 : null, needsReviewCount: 0, approvedUnmergedCount: 0 };
     }
 
     const repoFilter = repos.map((r) => `repo:${r.owner}/${r.name}`).join("+");
@@ -507,7 +507,7 @@ export class OctokitDataSource implements DataSource {
       }
     }
 
-    return { openPRCount, openIssueCount, failingRunCount: finalFailingRunCount, needsReviewCount, approvedUnmergedCount, actionsMonitoringDisabled: !actionsEnabled };
+    return { openPRCount, openIssueCount, failingRunCount: finalFailingRunCount, needsReviewCount, approvedUnmergedCount };
   }
 
   async getConfig(): Promise<CachedConfig | null> {
@@ -536,7 +536,11 @@ export class WebSocketDataSource implements DataSource {
   }
 
   async getFailingActions(repo?: string): Promise<WorkflowRun[]> {
-    return sendRelayRequest(METHODS.GET_FAILING_ACTIONS, { repo }) as Promise<WorkflowRun[]>;
+    const result = await sendRelayRequest(METHODS.GET_FAILING_ACTIONS, { repo });
+    if (result !== null && typeof result === "object" && !Array.isArray(result) && "disabled" in (result as Record<string, unknown>)) {
+      return [];
+    }
+    return result as WorkflowRun[];
   }
 
   async getPRDetails(repo: string, number: number): Promise<PullRequest | null> {

mcp/tests/data-source.test.ts

@@ -117,13 +117,14 @@ describe("OctokitDataSource", () => {
       trackedUsers: [],
       upstreamRepos: [],
       monitoredRepos: [],
+      enableActions: true,
     });
   });
 
   afterEach(() => {
     vi.restoreAllMocks();
     // Clear cached config
-    setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [] });
+    setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [], enableActions: true });
   });
 
   describe("getOpenPRs", () => {
@@ -189,7 +190,7 @@ describe("OctokitDataSource", () => {
 
     it("accepts explicit repo parameter and skips cached config", async () => {
       // Clear cached config to verify explicit param works without it
-      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [] });
+      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [], enableActions: true });
 
       const responses = new Map([
         ["GET /user", makeUserResponse()],
@@ -208,7 +209,7 @@ describe("OctokitDataSource", () => {
 
     it("returns empty array when config has no repos and no explicit repo", async () => {
       // setCachedConfig with empty selectedRepos → resolveRepos returns []
-      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [] });
+      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [], enableActions: true });
       const responses = new Map([["GET /user", makeUserResponse()]]);
       const octokit = makeMockOctokit(responses);
       const ds = new OctokitDataSource(octokit);
@@ -433,11 +434,26 @@ describe("OctokitDataSource", () => {
     });
 
     it("returns empty array when config has no repos and no explicit repo", async () => {
-      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [] });
+      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [], enableActions: true });
       const ds = new OctokitDataSource({ request: vi.fn() });
       const runs = await ds.getFailingActions();
       expect(runs).toEqual([]);
     });
+
+    it("returns empty array when enableActions is false", async () => {
+      setCachedConfig({
+        selectedRepos: [{ owner: "owner", name: "repo", fullName: "owner/repo" }],
+        trackedUsers: [],
+        upstreamRepos: [],
+        monitoredRepos: [],
+        enableActions: false,
+      });
+      const requestMock = vi.fn();
+      const ds = new OctokitDataSource({ request: requestMock });
+      const runs = await ds.getFailingActions();
+      expect(runs).toEqual([]);
+      expect(requestMock).not.toHaveBeenCalled();
+    });
   });
 
   describe("getPRDetails", () => {
@@ -502,7 +518,7 @@ describe("OctokitDataSource", () => {
 
   describe("getDashboardSummary", () => {
     it("returns zero counts when no repos are configured", async () => {
-      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [] });
+      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [], enableActions: true });
       const octokit = makeMockOctokit(new Map([["GET /user", makeUserResponse()]]));
       const ds = new OctokitDataSource(octokit);
       const summary = await ds.getDashboardSummary("involves_me");
@@ -514,6 +530,16 @@ describe("OctokitDataSource", () => {
       expect(summary.approvedUnmergedCount).toBe(0);
     });
 
+    it("returns failingRunCount=null in early return when no repos and enableActions is false", async () => {
+      setCachedConfig({ selectedRepos: [], trackedUsers: [], upstreamRepos: [], monitoredRepos: [], enableActions: false });
+      const octokit = makeMockOctokit(new Map([["GET /user", makeUserResponse()]]));
+      const ds = new OctokitDataSource(octokit);
+      const summary = await ds.getDashboardSummary("involves_me");
+
+      expect(summary.failingRunCount).toBeNull();
+      expect(summary.openPRCount).toBe(0);
+    });
+
     it("constructs involves_me query with user login", async () => {
       const requestMock = vi.fn().mockImplementation(async (route: string) => {
         if (route === "GET /user") return { data: { login: "testuser" }, headers: {} };
@@ -556,6 +582,30 @@ describe("OctokitDataSource", () => {
       expect(prCall).toBeDefined();
       expect(prCall![1].q).not.toContain("involves:");
     });
+
+    it("returns failingRunCount=null and skips actions API when enableActions is false", async () => {
+      setCachedConfig({
+        selectedRepos: [{ owner: "owner", name: "repo", fullName: "owner/repo" }],
+        trackedUsers: [],
+        upstreamRepos: [],
+        monitoredRepos: [],
+        enableActions: false,
+      });
+      const requestMock = vi.fn().mockImplementation(async (route: string) => {
+        if (route === "GET /user") return { data: { login: "testuser" }, headers: {} };
+        if (route === "GET /search/issues") return { data: { items: [], total_count: 0 }, headers: {} };
+        throw new Error(`Unexpected: ${route}`);
+      });
+
+      const ds = new OctokitDataSource({ request: requestMock });
+      const summary = await ds.getDashboardSummary("involves_me");
+
+      expect(summary.failingRunCount).toBeNull();
+      const actionsCalls = requestMock.mock.calls.filter(
+        ([route]: [string]) => route === "GET /repos/{owner}/{repo}/actions/runs"
+      );
+      expect(actionsCalls).toHaveLength(0);
+    });
   });
 
   describe("getConfig", () => {
@@ -565,6 +615,7 @@ describe("OctokitDataSource", () => {
         trackedUsers: [],
         upstreamRepos: [],
         monitoredRepos: [],
+        enableActions: true,
       };
       setCachedConfig(config);
       const ds = new OctokitDataSource({ request: vi.fn() });
@@ -641,6 +692,7 @@ describe("CompositeDataSource", () => {
       trackedUsers: [],
       upstreamRepos: [],
       monitoredRepos: [],
+      enableActions: true,
     });
   });
 
@@ -755,4 +807,13 @@ describe("CompositeDataSource", () => {
     expect(octokitDs.getRateLimit).toHaveBeenCalled();
     expect(_mockSendRequest).not.toHaveBeenCalled();
   });
+
+  it("WebSocketDataSource.getFailingActions returns empty array for disabled sentinel", async () => {
+    _mockIsConnected = true;
+    _mockSendRequest = vi.fn().mockResolvedValue({ disabled: true, message: "Actions monitoring is disabled" });
+
+    const wsDs = new WebSocketDataSource();
+    const result = await wsDs.getFailingActions();
+    expect(result).toEqual([]);
+  });
 });

mcp/tests/integration.test.ts

@@ -439,6 +439,7 @@ describe("Integration: Edge cases (with server)", () => {
       trackedUsers: [],
       upstreamRepos: [],
       monitoredRepos: [],
+      enableActions: true,
     });
 
     if (!wss) throw new Error("Server not started");
@@ -461,7 +462,7 @@ describe("Integration: Edge cases (with server)", () => {
       getRateLimit: vi.fn(),
       getConfig: vi.fn().mockResolvedValue({
         selectedRepos: [{ owner: "acme", name: "app", fullName: "acme/app" }],
-        trackedUsers: [], upstreamRepos: [], monitoredRepos: [],
+        trackedUsers: [], upstreamRepos: [], monitoredRepos: [], enableActions: true,
       }),
       getRepos: vi.fn().mockResolvedValue([{ owner: "acme", name: "app", fullName: "acme/app" }]),
     };

mcp/tests/resources.test.ts

@@ -58,6 +58,7 @@ function makeConfig(overrides: Partial<CachedConfig> = {}): CachedConfig {
     trackedUsers: [],
     upstreamRepos: [],
     monitoredRepos: [],
+    enableActions: true,
     ...overrides,
   };
 }

mcp/tests/tools.test.ts

@@ -125,6 +125,22 @@ describe("get_dashboard_summary", () => {
     // isRelayConnected is mocked to return false, so staleness note should be present
     expect(result.content[0].text).toContain("data via GitHub API");
   });
+
+  it("shows actions disabled indicator when failingRunCount is null", async () => {
+    const disabledSummary: DashboardSummary = {
+      openPRCount: 2,
+      openIssueCount: 1,
+      failingRunCount: null,
+      needsReviewCount: 0,
+      approvedUnmergedCount: 0,
+    };
+    vi.mocked(ds.getDashboardSummary).mockResolvedValueOnce(disabledSummary);
+    const result = await callTool(server, "get_dashboard_summary");
+    expect(result.isError).toBeFalsy();
+    const text = result.content[0].text;
+    expect(text).toContain("Actions monitoring disabled");
+    expect(text).not.toMatch(/Failing CI Runs:\s+\d/);
+  });
 });
 
 describe("get_open_prs", () => {
@@ -315,6 +331,41 @@ describe("get_failing_actions", () => {
     expect(result.isError).toBe(true);
     expect(result.content[0].text).toContain("Error fetching workflow runs");
   });
+
+  it("returns disabled message when enableActions is false", async () => {
+    vi.mocked(ds.getConfig).mockResolvedValueOnce({
+      selectedRepos: [{ owner: "owner", name: "repo", fullName: "owner/repo" }],
+      trackedUsers: [],
+      upstreamRepos: [],
+      monitoredRepos: [],
+      enableActions: false,
+    });
+    const result = await callTool(server, "get_failing_actions");
+    expect(result.isError).toBeFalsy();
+    expect(result.content[0].text).toContain("Actions monitoring is disabled");
+    expect(ds.getFailingActions).not.toHaveBeenCalled();
+  });
+
+  it("proceeds normally when enableActions is true", async () => {
+    vi.mocked(ds.getConfig).mockResolvedValueOnce({
+      selectedRepos: [{ owner: "owner", name: "repo", fullName: "owner/repo" }],
+      trackedUsers: [],
+      upstreamRepos: [],
+      monitoredRepos: [],
+      enableActions: true,
+    });
+    const result = await callTool(server, "get_failing_actions");
+    expect(result.isError).toBeFalsy();
+    expect(result.content[0].text).toContain("No failing or in-progress workflow runs found");
+    expect(ds.getFailingActions).toHaveBeenCalled();
+  });
+
+  it("proceeds normally when getConfig returns null", async () => {
+    vi.mocked(ds.getConfig).mockResolvedValueOnce(null);
+    const result = await callTool(server, "get_failing_actions");
+    expect(result.isError).toBeFalsy();
+    expect(ds.getFailingActions).toHaveBeenCalled();
+  });
 });
 
 describe("get_pr_details", () => {

src/app/components/dashboard/DashboardPage.tsx

@@ -8,7 +8,7 @@ import IssuesTab from "./IssuesTab";
 import PullRequestsTab from "./PullRequestsTab";
 import TrackedTab from "./TrackedTab";
 import PersonalSummaryStrip from "./PersonalSummaryStrip";
-import { config, setConfig, getCustomTab, isBuiltinTab, updateJiraConfig, type TrackedUser } from "../../stores/config";
+import { config, setConfig, getCustomTab, isBuiltinTab, isActionsBasedTab, updateJiraConfig, type TrackedUser } from "../../stores/config";
 import { viewState, updateViewState, setSortPreference, pruneClosedTrackedItems, removeCustomTabState, untrackJiraItem, setTabFilter, IssueFiltersSchema, PullRequestFiltersSchema, ActionsFiltersSchema } from "../../stores/view";
 import type { SortOption } from "../shared/SortDropdown";
 import type { Issue, PullRequest, WorkflowRun } from "../../services/api";
@@ -530,15 +530,11 @@ export default function DashboardPage() {
     };
   }
 
-  function isActionsBasedTab(tab: TabId): boolean {
-    return tab === "actions" || (!isBuiltinTab(tab) && config.customTabs.some((t) => t.id === tab && t.baseType === "actions"));
-  }
-
   function resolveInitialTab(): TabId {
     const tab = config.rememberLastTab ? viewState.lastActiveTab : config.defaultTab;
     if (tab === "tracked" && !config.enableTracking) return "issues";
     if (tab === "jiraAssigned" && !config.jira?.enabled) return "issues";
-    if (!config.enableActions && isActionsBasedTab(tab)) return "issues";
+    if (!config.enableActions && isActionsBasedTab(tab, config.customTabs)) return "issues";
     // Validate custom tab still exists; fall back to "issues" if stale
     if (!isBuiltinTab(tab) && !config.customTabs.some((t) => t.id === tab)) return "issues";
     return tab;
@@ -549,7 +545,7 @@ export default function DashboardPage() {
   function handleTabChange(tab: TabId) {
     // Reject invalid tab IDs to prevent persisting stale state
     if (!isBuiltinTab(tab) && !config.customTabs.some((t) => t.id === tab)) return;
-    if (!config.enableActions && isActionsBasedTab(tab)) return;
+    if (!config.enableActions && isActionsBasedTab(tab, config.customTabs)) return;
     setActiveTab(tab);
     updateViewState({ lastActiveTab: tab });
   }
@@ -579,7 +575,7 @@ export default function DashboardPage() {
 
   // Redirect away from Actions tab (or actions-based custom tab) when Actions is disabled
   createEffect(() => {
-    if (!config.enableActions && isActionsBasedTab(activeTab())) {
+    if (!config.enableActions && isActionsBasedTab(activeTab(), config.customTabs)) {
       handleTabChange("issues");
     }
   });
@@ -1110,6 +1106,7 @@ export default function DashboardPage() {
               pullRequests={visiblePullRequests()}
               workflowRuns={visibleWorkflowRuns()}
               userLogin={userLogin()}
+              enableActions={config.enableActions}
               onTabChange={handleTabChange}
             />
             <TabBar

src/app/components/dashboard/PersonalSummaryStrip.tsx

@@ -17,6 +17,7 @@ interface PersonalSummaryStripProps {
   pullRequests: PullRequest[];
   workflowRuns: WorkflowRun[];
   userLogin: string;
+  enableActions?: boolean;
   onTabChange: (tab: TabId) => void;
 }
 
@@ -142,7 +143,7 @@ export default function PersonalSummaryStrip(props: PersonalSummaryStripProps) {
         }));
       },
     });
-    if (running > 0) items.push({
+    if (running > 0 && props.enableActions !== false) items.push({
       label: running === 1 ? "action running" : "actions running",
       count: running,
       tab: "actions",

src/app/components/settings/SettingsPage.tsx

@@ -2,7 +2,7 @@ import { createSignal, createMemo, Show, For, onCleanup, onMount } from "solid-j
 import * as Sentry from "@sentry/solid";
 import { getRelayStatus } from "../../lib/mcp-relay";
 import { useNavigate } from "@solidjs/router";
-import { config, updateConfig, updateJiraConfig, updateJiraCustomFields, updateJiraCustomScopes, setMonitoredRepo } from "../../stores/config";
+import { config, updateConfig, updateJiraConfig, updateJiraCustomFields, updateJiraCustomScopes, setMonitoredRepo, isActionsBasedTab } from "../../stores/config";
 import type { Config } from "../../stores/config";
 import { viewState, updateViewState } from "../../stores/view";
 import { clearAuth, jiraAuth, setJiraAuth, clearJiraConfigFull, isJiraAuthenticated } from "../../stores/auth";
@@ -620,10 +620,8 @@ export default function SettingsPage() {
               checked={config.enableActions}
               onChange={(e) => {
                 const val = e.currentTarget.checked;
-                const isActionsCustomTab = (id: string) =>
-                  config.customTabs.some((t) => t.id === id && t.baseType === "actions");
-                const needsDefaultReset = !val && (config.defaultTab === "actions" || isActionsCustomTab(config.defaultTab));
-                const needsLastTabReset = !val && (viewState.lastActiveTab === "actions" || isActionsCustomTab(viewState.lastActiveTab));
+                const needsDefaultReset = !val && isActionsBasedTab(config.defaultTab, config.customTabs);
+                const needsLastTabReset = !val && isActionsBasedTab(viewState.lastActiveTab, config.customTabs);
                 saveWithFeedback({
                   enableActions: val,
                   ...(needsDefaultReset ? { defaultTab: "issues" as const } : {}),