feat(inbox): surface health check issues as inbox signals

Adds the `health_checks` / `health_issue` signal source to the Inbox so
instrumentation issues PostHog's health checks detect (missing events,
reverse-proxy gaps, outdated SDKs, ingestion warnings, broken warehouse
models) reach the Self-driving inbox.

Mirrors PostHog/posthog#61955. Not gated behind a feature flag — per-team
enablement is handled by `SignalSourceConfig` on the Cloud backend.

- Add `health_checks` to the `SourceProduct` union, `SignalSourceConfig`
  (`source_product` + `health_issue` `source_type`), and the
  `SignalSourceConnected` analytics event.
- Wire it through the source toggle surface: `signalSourceService`,
  `useSignalSourceToggles`, and a "Health checks" toggle card under
  "PostHog data" in `SignalSourceToggles`.
- Map the source to the Heartbeat icon in `SOURCE_PRODUCT_META`,
  `INBOX_SOURCE_OPTIONS`, the responder roster, and the desktop/mobile
  signal cards (matching the `IconHeartPlus` health icon used in the
  posthog repo).
- Cover the new source in `signalSourceService.test.ts`.

Generated-By: PostHog Code
Task-Id: 2b579b6c-3075-475e-8a1f-021df07cb260

Author: rafaeelaudibert

apps/mobile/src/features/inbox/components/FilterSheet.tsx

@@ -77,6 +77,7 @@ const SOURCE_PRODUCT_OPTIONS: { value: SourceProduct; label: string }[] = [
   { value: "zendesk", label: "Zendesk" },
   { value: "conversations", label: "Conversations" },
   { value: "signals_scout", label: "Scout" },
+  { value: "health_checks", label: "Health checks" },
 ];
 
 function SectionHeader({ title }: { title: string }) {

apps/mobile/src/features/inbox/components/SignalCard.tsx

@@ -9,6 +9,7 @@ import {
   Code,
   Compass,
   GithubLogo,
+  Heartbeat,
   LinkSimple,
   Question,
   Robot,
@@ -53,6 +54,8 @@ function sourceLine(signal: Signal): string {
   )
     return "Scout · Cross-source issue";
   if (source_product === "signals_scout") return "Scout";
+  if (source_product === "health_checks" && source_type === "health_issue")
+    return "Health checks · Issue";
   const product = source_product.replace(/_/g, " ");
   const type = source_type.replace(/_/g, " ");
   return `${product} · ${type}`;
@@ -82,6 +85,8 @@ function SourceIcon({
       return <LinkSimple size={size} color={color} />;
     case "signals_scout":
       return <Compass size={size} color={color} />;
+    case "health_checks":
+      return <Heartbeat size={size} color={color} />;
     default:
       return <WarningCircle size={size} color={color} />;
   }

apps/mobile/src/features/inbox/stores/inboxFilterStore.ts

@@ -22,7 +22,8 @@ export type SourceProduct =
   | "linear"
   | "zendesk"
   | "conversations"
-  | "signals_scout";
+  | "signals_scout"
+  | "health_checks";
 
 export const DEFAULT_STATUS_FILTER: SignalReportStatus[] = [
   "ready",

packages/api-client/src/posthog-client.ts

@@ -236,7 +236,8 @@ export interface SignalSourceConfig {
     | "conversations"
     | "error_tracking"
     | "pganalyze"
-    | "signals_scout";
+    | "signals_scout"
+    | "health_checks";
   source_type:
     | "session_analysis_cluster"
     | "evaluation"
@@ -245,7 +246,8 @@ export interface SignalSourceConfig {
     | "issue_created"
     | "issue_reopened"
     | "issue_spiking"
-    | "cross_source_issue";
+    | "cross_source_issue"
+    | "health_issue";
   enabled: boolean;
   config: Record<string, unknown>;
   created_at: string;

packages/core/src/inbox/signalSourceService.test.ts

@@ -60,6 +60,13 @@ describe("computeSourceValues", () => {
     const values = computeSourceValues([config("github", "issue", true)]);
     expect(values.github).toBe(true);
   });
+
+  it("enables health_checks when its config is enabled", () => {
+    const values = computeSourceValues([
+      config("health_checks", "health_issue", true),
+    ]);
+    expect(values.health_checks).toBe(true);
+  });
 });
 
 describe("deriveSourceStates", () => {
@@ -106,6 +113,17 @@ describe("SignalSourceService.toggleSource", () => {
     expect(client.createSignalSourceConfig).toHaveBeenCalledTimes(1);
   });
 
+  it("creates a health_checks config with the health_issue source type", async () => {
+    const client = fakeClient();
+    const service = new SignalSourceService();
+    await service.toggleSource(client, 1, "health_checks", true, [], []);
+    expect(client.createSignalSourceConfig).toHaveBeenCalledWith(1, {
+      source_product: "health_checks",
+      source_type: "health_issue",
+      enabled: true,
+    });
+  });
+
   it("ensures the issues table syncs with full_refresh for github before enabling", async () => {
     const client = fakeClient();
     const service = new SignalSourceService();

packages/core/src/inbox/signalSourceService.ts

@@ -15,6 +15,7 @@ export interface SignalSourceValues {
   zendesk: boolean;
   conversations: boolean;
   pganalyze: boolean;
+  health_checks: boolean;
 }
 
 export type SignalSourceProduct = keyof SignalSourceValues;
@@ -48,6 +49,7 @@ const SOURCE_TYPE_MAP: Record<
   zendesk: "ticket",
   conversations: "ticket",
   pganalyze: "issue",
+  health_checks: "health_issue",
 };
 
 const ERROR_TRACKING_SOURCE_TYPES: SourceType[] = [
@@ -74,6 +76,7 @@ const ALL_SOURCE_PRODUCTS: SignalSourceProduct[] = [
   "zendesk",
   "conversations",
   "pganalyze",
+  "health_checks",
 ];
 
 function isWarehouseSource(
@@ -109,6 +112,7 @@ export function computeSourceValues(
     zendesk: false,
     conversations: false,
     pganalyze: false,
+    health_checks: false,
   };
   if (!configs?.length) {
     return result;

packages/shared/src/analytics-events.ts

@@ -732,7 +732,8 @@ export interface SignalSourceConnectedProperties {
     | "zendesk"
     | "conversations"
     | "pganalyze"
-    | "llm_analytics";
+    | "llm_analytics"
+    | "health_checks";
   /** True when this is a brand-new createSignalSourceConfig, false for re-enable of an existing config. */
   is_first_connection: boolean;
   /** True when the connection went through the DataSourceSetup wizard (warehouse OAuth path). */

packages/shared/src/inbox-types.ts

@@ -14,4 +14,5 @@ export type SourceProduct =
   | "zendesk"
   | "conversations"
   | "pganalyze"
-  | "signals_scout";
+  | "signals_scout"
+  | "health_checks";

packages/ui/src/features/inbox/CLAUDE.md

@@ -136,6 +136,7 @@ When adding or changing UI, reuse those primitives first. Avoid encoding one-off
 - Do not put page-level Inbox title or navigation into the global app header; `InboxView` owns the Inbox page chrome.
 - Do not add a configure shortcut back into the Inbox header; Responders configuration is a sidebar destination.
 - Scout (`signals_scout`) is a real Cloud source product. Keep it covered wherever source products surface: `INBOX_SOURCE_OPTIONS`, `SOURCE_PRODUCT_META`, and the scout-name display in `SignalCard`.
+- Health checks (`health_checks` / `health_issue`) is a real Cloud source product — instrumentation issues (missing events, proxy gaps, outdated SDKs) surfaced from PostHog's health checks. Keep it covered wherever source products surface: the `SourceProduct` union, `SignalSourceConfig`, the source toggle (`SignalSourceToggles`, `useSignalSourceToggles`, `signalSourceService`), `SOURCE_PRODUCT_META`, `INBOX_SOURCE_OPTIONS`, and the source line in `SignalCard`.
 - Scout management UI (fleet configuration, run history) lives in `features/scouts/` and is backed by the PostHog Cloud scout endpoints (`/api/projects/{teamId}/signals/scout/`). Do not add scout controls that have no backing endpoint there.
 - Do not put preview shims or mock report data in `apps/code/index.html`; the app shell should stay minimal.
 - Do not call `electronTRPC` directly from Inbox code. Use the existing API client, React Query hooks, or tRPC client wrappers.

packages/ui/src/features/inbox/components/SignalSourceToggles.tsx

@@ -5,6 +5,7 @@ import {
   ChatsIcon,
   CircleNotchIcon,
   GithubLogoIcon,
+  HeartbeatIcon,
   KanbanIcon,
   TicketIcon,
   VideoIcon,
@@ -24,6 +25,7 @@ export interface SignalSourceValues {
   zendesk: boolean;
   conversations: boolean;
   pganalyze: boolean;
+  health_checks: boolean;
 }
 
 interface SignalSourceToggleCardProps {
@@ -298,6 +300,10 @@ export function SignalSourceToggles({
     (checked: boolean) => onToggle("conversations", checked),
     [onToggle],
   );
+  const toggleHealthChecks = useCallback(
+    (checked: boolean) => onToggle("health_checks", checked),
+    [onToggle],
+  );
   const togglePgAnalyze = useCallback(
     (checked: boolean) => onToggle("pganalyze", checked),
     [onToggle],
@@ -326,6 +332,17 @@ export function SignalSourceToggles({
             docsUrl="https://posthog.com/docs/error-tracking"
             docsLabel="Error Tracking"
           />
+          <SignalSourceToggleCard
+            icon={<HeartbeatIcon size={20} />}
+            label="Health checks"
+            description="Instrumentation issues — missing events, proxy gaps, outdated SDKs"
+            checked={value.health_checks}
+            onCheckedChange={toggleHealthChecks}
+            disabled={disabled}
+            syncStatus={sourceStates?.health_checks?.syncStatus}
+            docsUrl="https://posthog.com/docs/product-analytics/troubleshooting"
+            docsLabel="Health checks"
+          />
           <SignalSourceToggleCard
             icon={<ChatsIcon size={20} />}
             label="Support"