@omercnet/paseo-pr-radar 1.1.0 → 1.2.0-next.223.1

package/README.md

@@ -32,6 +32,10 @@ DevTools before capture. Both PNGs come from an isolated Paseo test daemon at 2
 
 Paseo supplies normalized workspace pull request status. A daemon-side plugin handler uses the authenticated `gh` CLI to distinguish authored pull requests from review requests. If viewer lookup fails, PR Radar falls back conservatively and does not claim that a row needs the user.
 
+## Paseo 0.11
+
+On 0.11 the sidebar row shows a "needs you" count; pressing the count opens a popover of those pull requests. Pressing one opens PR Radar focused on it (`param.pr`), and the needs-you link filters the queue (`param.filter`), so both survive reload and can be linked. A trailing `+` marks a count that may be incomplete: viewer lookup failed, a pagination or inbox cap was hit, or workspace status was unavailable. Paseo 0.9 and 0.10 keep the static surface and sidebar row.
+
 ## Install
 
 ### Paseo 0.9 and 0.10
@@ -66,7 +70,7 @@ bun run typecheck
 Release Please maintains the version, changelog, component tag, and GitHub release from
 Conventional Commits in the monorepo.
 
-The manifest supports Paseo `^0.9.0 || ^0.10.0`. Development uses the stable 0.9 CLI, client, plugin SDK,
+The manifest supports Paseo `^0.9.0 || ^0.10.0 || ^0.11.0`. Development uses the stable 0.9 CLI, client, plugin SDK,
 and protocol packages together. Host-owned navigation opens linked agents and workspaces without private routes or
 page reloads on web, desktop, iOS, and Android. React `19.1` and React Native `0.81` match the versions supplied by
 the plugin host.

package/client/pr-radar.tsx

@@ -1,38 +1,30 @@
-import {
-  openExternalUrl,
-  type PluginSurfaceProps,
-  usePaseo,
-  useRpc,
-} from "@getpaseo/plugin/client";
-import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { openExternalUrl, type PluginSurfaceProps, useRpc } from "@getpaseo/plugin/client";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { ActivityIndicator, FlatList, Pressable, Text, TextInput, View } from "react-native";
-import { acknowledgeViewerScope, viewerScope } from "../shared/viewer-scope";
-import { observeDirectoryInvalidation } from "./directory-observation";
+import { acknowledgeViewerScope } from "../shared/viewer-scope";
 import {
-  type AgentEntry,
   agentActionFor,
-  applyViewerScope,
   BUCKET_TITLES,
   BUCKETS,
   buildAgentPrompt,
-  buildRadarSnapshot,
   checkSummary,
   formatAge,
   hasActiveAgent,
   matchesRow,
-  mergeInboxRows,
   openPullRequestUrl,
-  type PaseoApi,
-  type PaseoWorkspace,
   type RadarBucket,
   type RadarRow,
 } from "./radar";
+import {
+  DIRECTORY_PARTIAL,
+  LOOKUP_CAPPED,
+  parseRadarParams,
+  type RadarFilter,
+  VIEWER_URL_LIMIT,
+} from "./screen-state";
+import { useRadar } from "./use-radar";
 
-const PAGE_LIMIT = 200;
-const MAX_PAGES = 10;
-const BACKSTOP_REFRESH_MS = 60_000;
-const EVENT_DEBOUNCE_MS = 500;
 const CLOCK_TICK_MS = 30_000;
 
 type SavedView = "security" | "updated" | "stale" | "automation";
@@ -46,35 +38,6 @@ const SAVED_VIEW_TITLES: Record<SavedView, string> = {
 
 const STALE_AFTER_MS = 3 * 24 * 60 * 60 * 1_000;
 
-async function loadAgents(paseo: PaseoApi): Promise<AgentEntry[]> {
-  const entries: AgentEntry[] = [];
-  let cursor: string | undefined;
-  for (let page = 0; page < MAX_PAGES; page += 1) {
-    const result = await paseo.agents.list({
-      sort: [{ key: "updated_at", direction: "desc" }],
-      page: { limit: PAGE_LIMIT, ...(cursor ? { cursor } : {}) },
-    });
-    entries.push(...result.entries);
-    cursor = result.pageInfo.hasMore ? (result.pageInfo.nextCursor ?? undefined) : undefined;
-    if (!cursor) break;
-  }
-  return entries;
-}
-
-async function loadWorkspaces(paseo: PaseoApi): Promise<PaseoWorkspace[]> {
-  const workspaces: PaseoWorkspace[] = [];
-  let cursor: string | undefined;
-  for (let page = 0; page < MAX_PAGES; page += 1) {
-    const result = await paseo.workspaces.list({
-      page: { limit: PAGE_LIMIT, ...(cursor ? { cursor } : {}) },
-    });
-    workspaces.push(...result.entries);
-    cursor = result.pageInfo.hasMore ? (result.pageInfo.nextCursor ?? undefined) : undefined;
-    if (!cursor) break;
-  }
-  return workspaces;
-}
-
 function bucketColor(bucket: RadarBucket, colors: PluginSurfaceProps["theme"]["colors"]): string {
   if (bucket === "needs-you") return colors.statusDanger;
   if (bucket === "ready") return colors.statusSuccess;
@@ -93,15 +56,29 @@ function agentState(row: RadarRow): string {
   return `${agent.title} · ${agent.status}${extra}`;
 }
 
-export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps) {
-  const paseo = usePaseo();
+export function PrRadar({
+  theme,
+  layout,
+  host,
+  navigation,
+  params = {},
+}: PluginSurfaceProps & { params?: Record<string, string> }) {
   const queryClient = useQueryClient();
-  const queryKey = useMemo(() => ["pr-radar", host.id], [host.id]);
-  const resolveViewerScope = useRpc(viewerScope);
   const acknowledgeUpdates = useRpc(acknowledgeViewerScope);
-  const [selected, setSelected] = useState<RadarBucket | null>(null);
-  const [activeOnly, setActiveOnly] = useState(false);
-  const [savedView, setSavedView] = useState<SavedView | null>(null);
+  const parsed = parseRadarParams(params);
+  const [filter, setFilterState] = useState<RadarFilter | null>(parsed.filter);
+  const [focusedPr, setFocusedPr] = useState<string | null>(parsed.pr);
+  // Chips are local state: openScreen would push a new screen per tap. A chip press also ends PR focus.
+  const setFilter = (value: RadarFilter | null) => {
+    setFilterState(value);
+    setFocusedPr(null);
+  };
+  const selected = BUCKETS.includes(filter as RadarBucket) ? (filter as RadarBucket) : null;
+  const activeOnly = filter === "active";
+  const savedView =
+    filter && ["security", "updated", "stale", "automation"].includes(filter)
+      ? (filter as SavedView)
+      : null;
   const [windowDays, setWindowDays] = useState(30);
   const [search, setSearch] = useState("");
   const [now, setNow] = useState(() => Date.now());
@@ -109,64 +86,25 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
   const [actionNotice, setActionNotice] = useState<string | null>(null);
 
   const {
+    paseo,
+    queryKey,
     data,
     error,
     isPending,
-    isFetching: isDirectoryFetching,
     refetch,
-  } = useQuery({
-    queryKey,
-    queryFn: async () => {
-      const [workspaces, agents] = await Promise.all([loadWorkspaces(paseo), loadAgents(paseo)]);
-      return buildRadarSnapshot(workspaces, agents);
-    },
-    refetchInterval: BACKSTOP_REFRESH_MS,
-  });
+    rawRows,
+    rows,
+    viewerData,
+    viewerError,
+    isFetching,
+    refetchViewer,
+  } = useRadar(host.id, windowDays);
 
   useEffect(() => {
     const clock = setInterval(() => setNow(Date.now()), CLOCK_TICK_MS);
     return () => clearInterval(clock);
   }, []);
 
-  useEffect(
-    () =>
-      observeDirectoryInvalidation(
-        paseo,
-        () => void queryClient.invalidateQueries({ queryKey }),
-        EVENT_DEBOUNCE_MS,
-      ),
-    [paseo, queryClient, queryKey],
-  );
-
-  const rawRows = data?.rows ?? [];
-  const scopeUrls = useMemo(() => rawRows.map((row) => row.url), [rawRows]);
-  const {
-    data: viewerData,
-    error: viewerQueryError,
-    isFetching: isViewerFetching,
-    refetch: refetchViewer,
-  } = useQuery({
-    queryKey: ["pr-radar-viewer-scope", host.id, scopeUrls, windowDays],
-    queryFn: () => resolveViewerScope({ urls: scopeUrls, windowDays }),
-    staleTime: 5 * 60_000,
-    refetchInterval: 5 * 60_000,
-  });
-  const mergedRows = useMemo(
-    () => (data ? mergeInboxRows(data, viewerData?.inboxItems ?? []) : []),
-    [data, viewerData],
-  );
-  const rows = useMemo(
-    () => applyViewerScope(mergedRows, viewerData ?? null),
-    [mergedRows, viewerData],
-  );
-  const isFetching = isDirectoryFetching || isViewerFetching;
-  const viewerError =
-    viewerData?.error ??
-    (viewerQueryError instanceof Error
-      ? viewerQueryError.message
-      : viewerQueryError
-        ? "error"
-        : null);
   const acknowledgeMutation = useMutation({
     mutationFn: () => acknowledgeUpdates({ windowDays }),
     onSuccess: async () => {
@@ -282,13 +220,14 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
             Boolean(row.activityAt && now - Date.parse(row.activityAt) >= STALE_AFTER_MS)) ||
           (savedView === "automation" && row.authorKind === "bot");
         return (
+          (!focusedPr || row.id === focusedPr) &&
           (!selected || row.bucket === selected) &&
           (!activeOnly || hasActiveAgent(row.agents)) &&
           matchesSavedView &&
           matchesRow(row, search)
         );
       }),
-    [activeOnly, now, rows, savedView, search, selected],
+    [activeOnly, now, rows, savedView, search, selected, focusedPr],
   );
 
   const styles = useMemo(() => {
@@ -642,15 +581,17 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
   };
 
   const totalCopy = `${rows.length} open ${rows.length === 1 ? "pull request" : "pull requests"}; ${rawRows.length} linked to ${data?.workspaceCount ?? 0} workspaces`;
-  const emptyCopy = search
-    ? "No pull requests match this search."
-    : activeOnly
-      ? "No pull requests have a running or initializing agent."
-      : savedView
-        ? `No pull requests match the ${SAVED_VIEW_TITLES[savedView].toLowerCase()} view.`
-        : selected
-          ? `No pull requests are ${BUCKET_TITLES[selected].toLowerCase()}.`
-          : "No open pull requests are visible to GitHub or linked to a Paseo workspace.";
+  const emptyCopy = focusedPr
+    ? "This pull request is not in the current queue."
+    : search
+      ? "No pull requests match this search."
+      : activeOnly
+        ? "No pull requests have a running or initializing agent."
+        : savedView
+          ? `No pull requests match the ${SAVED_VIEW_TITLES[savedView].toLowerCase()} view.`
+          : selected
+            ? "No pull requests are in this queue."
+            : "No open pull requests are visible to GitHub or linked to a Paseo workspace.";
   const summaryMetrics = [
     { label: "Action now", value: counts["needs-you"] },
     { label: "Ready", value: counts.ready },
@@ -680,6 +621,11 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
       </View>
       <Text style={styles.heroTitle}>Know what moves next.</Text>
       <Text style={styles.heroDetail}>{totalCopy}</Text>
+      {focusedPr ? <Text style={styles.heroDetail}>Focused PR: {focusedPr}</Text> : null}
+      {data?.truncated ? <Text style={styles.warningText}>{DIRECTORY_PARTIAL}</Text> : null}
+      {rawRows.length > VIEWER_URL_LIMIT ? (
+        <Text style={styles.warningText}>{LOOKUP_CAPPED}</Text>
+      ) : null}
       <View accessibilityRole="summary" style={styles.summary}>
         {summaryMetrics.map(({ label, value }) => (
           <View key={label} style={styles.metric}>
@@ -691,18 +637,19 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
       <View accessibilityRole="tablist" style={styles.chips}>
         <Pressable
           accessibilityRole="tab"
-          accessibilityState={{ selected: selected === null && !activeOnly && !savedView }}
-          onPress={() => {
-            setSelected(null);
-            setActiveOnly(false);
-            setSavedView(null);
+          accessibilityState={{
+            selected: selected === null && !activeOnly && !savedView && !focusedPr,
           }}
-          style={[styles.chip, selected === null && !activeOnly && !savedView && styles.chipActive]}
+          onPress={() => setFilter(null)}
+          style={[
+            styles.chip,
+            selected === null && !activeOnly && !savedView && !focusedPr && styles.chipActive,
+          ]}
         >
           <Text
             style={[
               styles.chipText,
-              selected === null && !activeOnly && !savedView && styles.chipTextActive,
+              selected === null && !activeOnly && !savedView && !focusedPr && styles.chipTextActive,
             ]}
           >
             All {rows.length}
@@ -713,11 +660,7 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
             accessibilityRole="tab"
             accessibilityState={{ selected: selected === bucket }}
             key={bucket}
-            onPress={() => {
-              setSelected(bucket);
-              setActiveOnly(false);
-              setSavedView(null);
-            }}
+            onPress={() => setFilter(bucket)}
             style={[styles.chip, selected === bucket && styles.chipActive]}
           >
             <Text style={[styles.chipText, selected === bucket && styles.chipTextActive]}>
@@ -728,11 +671,7 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
         <Pressable
           accessibilityRole="tab"
           accessibilityState={{ selected: activeOnly }}
-          onPress={() => {
-            setSelected(null);
-            setActiveOnly(true);
-            setSavedView(null);
-          }}
+          onPress={() => setFilter("active")}
           style={[styles.chip, activeOnly && styles.chipActive]}
         >
           <Text style={[styles.chipText, activeOnly && styles.chipTextActive]}>
@@ -744,11 +683,7 @@ export function PrRadar({ theme, layout, host, navigation }: PluginSurfaceProps)
             accessibilityRole="tab"
             accessibilityState={{ selected: savedView === view }}
             key={view}
-            onPress={() => {
-              setSelected(null);
-              setActiveOnly(false);
-              setSavedView(view);
-            }}
+            onPress={() => setFilter(view)}
             style={[styles.chip, savedView === view && styles.chipActive]}
           >
             <Text style={[styles.chipText, savedView === view && styles.chipTextActive]}>

package/client/screen-state.ts

@@ -0,0 +1,64 @@
+import { BUCKETS, type RadarBucket, type RadarRow } from "./radar";
+
+export type RadarFilter = RadarBucket | "active" | "security" | "updated" | "stale" | "automation";
+const FILTERS: readonly string[] = [
+  ...BUCKETS,
+  "active",
+  "security",
+  "updated",
+  "stale",
+  "automation",
+];
+
+export function parseRadarParams(params: Record<string, string>) {
+  return {
+    filter: FILTERS.includes(params.filter) ? (params.filter as RadarFilter) : null,
+    pr: params.pr?.toLowerCase() || null,
+  };
+}
+
+export const VIEWER_URL_LIMIT = 200;
+export const DIRECTORY_PARTIAL = "Directory pagination limit reached; results are partial.";
+export const LOOKUP_CAPPED = "Viewer lookup is limited to 200 linked pull requests.";
+
+/** Reasons the queue may be incomplete. Any entry makes the sidebar count a lower bound ("N+"). */
+export function radarWarnings(input: {
+  directoryError: boolean;
+  directoryTruncated: boolean;
+  workspaceWarnings: number;
+  viewerKnown: boolean;
+  viewerTruncated: boolean;
+  urlCount: number;
+}) {
+  const warnings: string[] = [];
+  if (input.directoryError) warnings.push("Could not load the delivery queue.");
+  if (input.directoryTruncated) warnings.push(DIRECTORY_PARTIAL);
+  if (input.workspaceWarnings > 0)
+    warnings.push("Some workspaces have unavailable pull request status.");
+  if (!input.viewerKnown)
+    warnings.push("GitHub viewer identity is unavailable. Action buckets are conservative.");
+  if (input.urlCount > VIEWER_URL_LIMIT) warnings.push(LOOKUP_CAPPED);
+  if (input.viewerTruncated) warnings.push("Results reached the 100-item inbox cap.");
+  return warnings;
+}
+
+export function needsYouSummary(
+  rows: readonly RadarRow[],
+  loading: boolean,
+  warnings: readonly string[],
+) {
+  const items = rows.filter((row) => row.bucket === "needs-you");
+  return { items, label: loading ? "…" : `${items.length}${warnings.length ? "+" : ""}` };
+}
+
+export function supportsRadarScreen(
+  client: { addScreen?: unknown; addSidebarHeaderItem?: unknown; openScreen?: unknown },
+  sidebarRow: unknown,
+) {
+  return (
+    typeof client.addScreen === "function" &&
+    typeof client.addSidebarHeaderItem === "function" &&
+    typeof client.openScreen === "function" &&
+    typeof sidebarRow === "function"
+  );
+}

package/client/sidebar.tsx

@@ -0,0 +1,99 @@
+import type { PluginPopoverProps, PluginSidebarItemProps } from "@getpaseo/plugin/client";
+import { SidebarRow } from "@getpaseo/plugin/client/ui";
+import { Pressable, ScrollView, Text } from "react-native";
+import { needsYouSummary } from "./screen-state";
+import { useRadar } from "./use-radar";
+
+function NeedsYouPopover({ theme, layout, host, openScreen }: PluginPopoverProps) {
+  const queue = useRadar(host.id, 30, false);
+  const { items } = needsYouSummary(queue.rows, queue.loading, queue.warnings);
+  return (
+    <ScrollView
+      style={{ maxHeight: layout.compact ? 460 : 400 }}
+      contentContainerStyle={{ padding: 16, gap: 12 }}
+    >
+      <Text style={{ color: theme.colors.foreground, fontSize: 18, fontWeight: "700" }}>
+        Needs you
+      </Text>
+      {queue.viewerData ? (
+        <Text style={{ color: theme.colors.foregroundMuted }}>{queue.viewerData.coverageNote}</Text>
+      ) : null}
+      {queue.warnings.map((warning) => (
+        <Text key={warning} style={{ color: theme.colors.statusWarning }}>
+          {warning}
+        </Text>
+      ))}
+      {queue.loading ? (
+        <Text style={{ color: theme.colors.foregroundMuted }}>Scanning pull requests…</Text>
+      ) : null}
+      {!queue.loading && !items.length ? (
+        <Text style={{ color: theme.colors.foregroundMuted }}>
+          {queue.warnings.length
+            ? "No known items need you in the available results."
+            : "No pull requests need you in this scope."}
+        </Text>
+      ) : null}
+      {!queue.loading &&
+        items.map((row) => (
+          <Pressable
+            key={row.id}
+            accessibilityRole="button"
+            onPress={() => openScreen({ screenId: "radar", params: { pr: row.id } })}
+            style={{
+              paddingVertical: 10,
+              borderTopWidth: 1,
+              borderColor: theme.colors.border,
+              gap: 4,
+            }}
+          >
+            <Text style={{ color: theme.colors.foreground, fontWeight: "600" }}>
+              {row.repository}#{row.number} · {row.title}
+            </Text>
+            <Text style={{ color: theme.colors.foregroundMuted }}>{row.reason}</Text>
+          </Pressable>
+        ))}
+      <Pressable
+        accessibilityRole="button"
+        onPress={() => openScreen({ screenId: "radar", params: { filter: "needs-you" } })}
+        style={{ paddingVertical: 10 }}
+      >
+        <Text style={{ color: theme.colors.accent }}>Open needs-you queue</Text>
+      </Pressable>
+    </ScrollView>
+  );
+}
+
+export function RadarSidebar({
+  theme,
+  host,
+  currentScreen,
+  openScreen,
+  openPopover,
+}: PluginSidebarItemProps) {
+  const queue = useRadar(host.id, 30, currentScreen?.screenId !== "radar");
+  const summary = needsYouSummary(queue.rows, queue.loading, queue.warnings);
+  return (
+    <SidebarRow
+      icon="GitPullRequest"
+      active={currentScreen?.screenId === "radar"}
+      onPress={() => openScreen({ screenId: "radar" })}
+      trailing={
+        <Pressable
+          accessibilityRole="button"
+          accessibilityLabel={`Needs you: ${summary.label}${queue.warnings.length ? "; incomplete results" : ""}`}
+          onPress={() => openPopover(NeedsYouPopover)}
+          style={{ paddingHorizontal: 8, paddingVertical: 6 }}
+        >
+          <Text
+            style={{
+              color: queue.warnings.length ? theme.colors.statusWarning : theme.colors.foreground,
+              fontSize: 12,
+            }}
+          >
+            {summary.label} needs you
+          </Text>
+        </Pressable>
+      }
+    />
+  );
+}

package/client/use-radar.ts

@@ -0,0 +1,130 @@
+import { usePaseo, useRpc } from "@getpaseo/plugin/client";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useEffect, useMemo } from "react";
+import { viewerScope } from "../shared/viewer-scope";
+import { observeDirectoryInvalidation } from "./directory-observation";
+import {
+  type AgentEntry,
+  applyViewerScope,
+  buildRadarSnapshot,
+  mergeInboxRows,
+  type PaseoApi,
+  type PaseoWorkspace,
+} from "./radar";
+import { radarWarnings, VIEWER_URL_LIMIT } from "./screen-state";
+
+const PAGE_LIMIT = 200;
+const MAX_PAGES = 10;
+
+async function loadAgents(paseo: PaseoApi) {
+  const entries: AgentEntry[] = [];
+  let cursor: string | undefined;
+  let truncated = false;
+  for (let page = 0; page < MAX_PAGES; page += 1) {
+    const result = await paseo.agents.list({
+      sort: [{ key: "updated_at", direction: "desc" }],
+      page: { limit: PAGE_LIMIT, ...(cursor ? { cursor } : {}) },
+    });
+    entries.push(...result.entries);
+    truncated = result.pageInfo.hasMore;
+    cursor = result.pageInfo.nextCursor ?? undefined;
+    if (!truncated || !cursor) break;
+  }
+  return { entries, truncated };
+}
+
+async function loadWorkspaces(paseo: PaseoApi) {
+  const entries: PaseoWorkspace[] = [];
+  let cursor: string | undefined;
+  let truncated = false;
+  for (let page = 0; page < MAX_PAGES; page += 1) {
+    const result = await paseo.workspaces.list({
+      page: { limit: PAGE_LIMIT, ...(cursor ? { cursor } : {}) },
+    });
+    entries.push(...result.entries);
+    truncated = result.pageInfo.hasMore;
+    cursor = result.pageInfo.nextCursor ?? undefined;
+    if (!truncated || !cursor) break;
+  }
+  return { entries, truncated };
+}
+
+// `live` owns the refresh timers. The sidebar is live unless the screen is open (the screen is
+// then live); popovers only observe the cache.
+export function useRadar(hostId: string, windowDays = 30, live = true) {
+  const paseo = usePaseo();
+  const queryClient = useQueryClient();
+  const resolveViewerScope = useRpc(viewerScope);
+  const queryKey = useMemo(() => ["pr-radar", hostId], [hostId]);
+  const directory = useQuery({
+    queryKey,
+    queryFn: async () => {
+      const [workspaces, agents] = await Promise.all([loadWorkspaces(paseo), loadAgents(paseo)]);
+      return {
+        ...buildRadarSnapshot(workspaces.entries, agents.entries),
+        truncated: workspaces.truncated || agents.truncated,
+      };
+    },
+    staleTime: 60_000,
+    refetchInterval: live ? 60_000 : false,
+  });
+  useEffect(() => {
+    if (!live) return;
+    return observeDirectoryInvalidation(
+      paseo,
+      () => void queryClient.invalidateQueries({ queryKey }),
+      500,
+    );
+  }, [live, paseo, queryClient, queryKey]);
+  const rawRows = directory.data?.rows ?? [];
+  // One deduped, ordered, capped list feeds both the query key and the request.
+  const scopeUrls = useMemo(
+    () => [...new Set(rawRows.map((row) => row.url))].sort().slice(0, VIEWER_URL_LIMIT),
+    [rawRows],
+  );
+  const viewer = useQuery({
+    queryKey: ["pr-radar-viewer-scope", hostId, scopeUrls, windowDays],
+    queryFn: () => resolveViewerScope({ urls: scopeUrls, windowDays }),
+    enabled: Boolean(directory.data),
+    staleTime: 5 * 60_000,
+    refetchInterval: live ? 5 * 60_000 : false,
+  });
+  useEffect(() => {
+    if (!live) return;
+    // Timers pause while not live; catch up on resume instead of waiting out the interval.
+    void queryClient.refetchQueries({ queryKey, stale: true });
+    void queryClient.refetchQueries({ queryKey: ["pr-radar-viewer-scope", hostId], stale: true });
+  }, [live, queryClient, queryKey, hostId]);
+  const rows = useMemo(
+    () =>
+      applyViewerScope(
+        directory.data ? mergeInboxRows(directory.data, viewer.data?.inboxItems ?? []) : [],
+        viewer.data ?? null,
+      ),
+    [directory.data, viewer.data],
+  );
+  const warnings = radarWarnings({
+    directoryError: Boolean(directory.error),
+    directoryTruncated: Boolean(directory.data?.truncated),
+    workspaceWarnings: directory.data?.warnings.length ?? 0,
+    viewerKnown: Boolean(viewer.data?.viewer) && !viewer.data?.error && !viewer.error,
+    viewerTruncated: Boolean(viewer.data?.truncated),
+    urlCount: new Set(rawRows.map((row) => row.url)).size,
+  });
+  return {
+    paseo,
+    queryKey,
+    rows,
+    rawRows,
+    warnings,
+    data: directory.data,
+    error: directory.error,
+    isPending: directory.isPending,
+    isFetching: directory.isFetching || viewer.isFetching,
+    refetch: directory.refetch,
+    viewerData: viewer.data,
+    viewerError: viewer.data?.error ?? viewer.error,
+    refetchViewer: viewer.refetch,
+    loading: directory.isPending || (Boolean(directory.data) && viewer.isPending),
+  };
+}

package/index.client.tsx

@@ -1,22 +1,37 @@
 import type { PluginClientContext } from "@getpaseo/plugin/client";
+import { SidebarRow } from "@getpaseo/plugin/client/ui";
 import { PrRadar } from "./client/pr-radar";
+import { supportsRadarScreen } from "./client/screen-state";
+import { RadarSidebar } from "./client/sidebar";
 
 export default function contribute(client: PluginClientContext) {
-  client.addSurface("radar", PrRadar);
-  client.addSidebarItem({
-    id: "radar",
-    title: "PR Radar",
-    icon: "GitPullRequest",
-    surface: "radar",
-  });
+  const screens = supportsRadarScreen(client, SidebarRow);
+  if (screens) {
+    client.addScreen({
+      id: "radar",
+      title: "PR Radar",
+      Component: PrRadar,
+    });
+    client.addSidebarHeaderItem({ id: "radar", title: "PR Radar", Component: RadarSidebar });
+  } else {
+    client.addSurface("radar", PrRadar);
+    client.addSidebarItem({
+      id: "radar",
+      title: "PR Radar",
+      icon: "GitPullRequest",
+      surface: "radar",
+    });
+  }
   client.addCommandCenterItem({
     id: "open-radar",
     title: "Open PR Radar",
     icon: "GitPullRequest",
     keywords: ["pull requests", "delivery", "merge", "agents"],
     context: "global",
-    onSelect({ openSurface }) {
-      openSurface("radar");
+    onSelect(capabilities) {
+      if (screens && typeof capabilities.openScreen === "function")
+        capabilities.openScreen({ screenId: "radar" });
+      else capabilities.openSurface("radar");
     },
   });
   return () => {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omercnet/paseo-pr-radar",
-  "version": "1.1.0",
+  "version": "1.2.0-next.223.1",
   "type": "module",
   "description": "A viewer-aware delivery queue for pull requests linked to Paseo workspaces.",
   "license": "MIT",
@@ -46,10 +46,10 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.5.10",
-    "@getpaseo/cli": "0.10.1",
-    "@getpaseo/client": "0.10.1",
-    "@getpaseo/plugin": "0.10.1",
-    "@getpaseo/protocol": "0.10.1",
+    "@getpaseo/cli": "0.11.0-beta.5",
+    "@getpaseo/client": "0.11.0-beta.5",
+    "@getpaseo/plugin": "0.11.0-beta.5",
+    "@getpaseo/protocol": "0.11.0-beta.5",
     "@tanstack/react-query": "^5.102.3",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.18",

package/paseo-plugin.json

@@ -1,5 +1,5 @@
 {
   "id": "pr-radar",
   "description": "A viewer-aware delivery queue for pull requests linked to Paseo workspaces.",
-  "requirements": { "paseo": "^0.9.0 || ^0.10.0" }
+  "requirements": { "paseo": "^0.9.0 || ^0.10.0 || ^0.11.0" }
 }

package/server/viewer-scope.ts

@@ -11,9 +11,13 @@ const SEARCH_LIMIT = 100;
 const ENRICHMENT_BATCH_SIZE = 20;
 const COMMAND_TIMEOUT_MS = 15_000;
 const MAX_BUFFER_BYTES = 16 * 1024 * 1024;
-const statePath = join(homedir(), ".paseo", "plugin-data", "pr-radar", "inbox-state.json");
 const SCOPE_SEARCH_LIMIT = 1000;
 
+function statePath(): string {
+  const home = process.env.PASEO_HOME ?? join(homedir(), ".paseo");
+  return join(home, "plugin-data", "pr-radar", "inbox-state.json");
+}
+
 interface SearchRecord {
   id: string;
   number: number;
@@ -254,7 +258,7 @@ function toInboxItem(
 
 async function readState(): Promise<StoredState> {
   try {
-    const state = JSON.parse(await readFile(statePath, "utf8")) as StoredState;
+    const state = JSON.parse(await readFile(statePath(), "utf8")) as StoredState;
     if (state.version === 2 && state.windows && typeof state.windows === "object") return state;
   } catch (error) {
     if ((error as NodeJS.ErrnoException).code !== "ENOENT") {
@@ -265,10 +269,11 @@ async function readState(): Promise<StoredState> {
 }
 
 async function writeState(state: StoredState): Promise<void> {
-  await mkdir(dirname(statePath), { recursive: true });
-  const temporaryPath = `${statePath}.${process.pid}.tmp`;
+  const path = statePath();
+  await mkdir(dirname(path), { recursive: true });
+  const temporaryPath = `${path}.${process.pid}.tmp`;
   await writeFile(temporaryPath, `${JSON.stringify(state)}\n`, { mode: 0o600 });
-  await rename(temporaryPath, statePath);
+  await rename(temporaryPath, path);
 }
 
 function storedItem(item: GitHubInboxItem): StoredItem {