From 8af3aa17e346ed504740733ef02275d3fd5e2ad1 Mon Sep 17 00:00:00 2001
From: Taylor Ho <taylorkmho@gmail.com>
Date: Fri, 5 Jun 2026 10:37:14 -1000
Subject: [PATCH] feat: gate pulse behind experimental feature flag

Signed-off-by: Taylor Ho <taylorkmho@gmail.com>
---
 desktop/src/app/routes/pulse.tsx              | 15 ++++++-----
 .../src/features/sidebar/ui/AppSidebar.tsx    | 26 ++++++++++---------
 features.json                                 |  7 +++++
 3 files changed, 30 insertions(+), 18 deletions(-)

diff --git a/desktop/src/app/routes/pulse.tsx b/desktop/src/app/routes/pulse.tsx
index 25cbaf377..5bab0672e 100644
--- a/desktop/src/app/routes/pulse.tsx
+++ b/desktop/src/app/routes/pulse.tsx
@@ -1,6 +1,7 @@
 import * as React from "react";
-import { createFileRoute } from "@tanstack/react-router";
+import { createFileRoute, Navigate } from "@tanstack/react-router";
 
+import { FeatureGate } from "@/shared/features";
 import { ViewLoadingFallback } from "@/shared/ui/ViewLoadingFallback";
 
 const PulseScreen = React.lazy(async () => {
@@ -14,10 +15,12 @@ export const Route = createFileRoute("/pulse")({
 
 function PulseRouteComponent() {
   return (
-    <React.Suspense
-      fallback={<ViewLoadingFallback includeHeader kind="pulse" />}
-    >
-      <PulseScreen />
-    </React.Suspense>
+    <FeatureGate feature="pulse" fallback={<Navigate to="/" />}>
+      <React.Suspense
+        fallback={<ViewLoadingFallback includeHeader kind="pulse" />}
+      >
+        <PulseScreen />
+      </React.Suspense>
+    </FeatureGate>
   );
 }
diff --git a/desktop/src/features/sidebar/ui/AppSidebar.tsx b/desktop/src/features/sidebar/ui/AppSidebar.tsx
index 48b6900c0..8ce462c23 100644
--- a/desktop/src/features/sidebar/ui/AppSidebar.tsx
+++ b/desktop/src/features/sidebar/ui/AppSidebar.tsx
@@ -444,18 +444,20 @@ export function AppSidebar({
               </SidebarMenuBadge>
             ) : null}
           </SidebarMenuItem>
-          <SidebarMenuItem>
-            <SidebarMenuButton
-              data-testid="open-pulse-view"
-              isActive={selectedView === "pulse"}
-              onClick={onSelectPulse}
-              tooltip="Pulse"
-              type="button"
-            >
-              <Activity className="h-4 w-4" />
-              <span>Pulse</span>
-            </SidebarMenuButton>
-          </SidebarMenuItem>
+          <FeatureGate feature="pulse">
+            <SidebarMenuItem>
+              <SidebarMenuButton
+                data-testid="open-pulse-view"
+                isActive={selectedView === "pulse"}
+                onClick={onSelectPulse}
+                tooltip="Pulse"
+                type="button"
+              >
+                <Activity className="h-4 w-4" />
+                <span>Pulse</span>
+              </SidebarMenuButton>
+            </SidebarMenuItem>
+          </FeatureGate>
           <FeatureGate feature="projects">
             <SidebarMenuItem>
               <SidebarMenuButton
diff --git a/features.json b/features.json
index 06adf2e43..295f7ba34 100644
--- a/features.json
+++ b/features.json
@@ -64,6 +64,13 @@
       "tier": "dev",
       "platforms": ["desktop"]
     },
+    {
+      "id": "pulse",
+      "name": "Pulse",
+      "description": "Activity feed with notes, social posts, and agent activity",
+      "tier": "experimental",
+      "platforms": ["desktop"]
+    },
     {
       "id": "forum",
       "name": "Forum Channels",