paseo-follow-up 0.0.0-stage → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tom Gringauz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/OVERVIEW.md

@@ -0,0 +1,15 @@
+# Follow-up
+
+Follow-up keeps PR stacks, remaining tasks and explicit agent completion attached to a Paseo workspace. It groups workspaces by whether you or an agent can act next and retains settled PR history.
+
+Requires Paseo 0.11+, Node 22+ and authenticated gh on the daemon host. Graphite CLI authentication is used for readiness and explicit Merge. The optional Send to Paseo browser companion enables Graphite's Merge when ready setting; it is not needed for tracking, recovery or follow-up.
+
+Open the sidebar or Command-K, then Track this workspace. Project settings can enroll existing and new workspaces with original main-agent ownership; Auto always starts off. The retained development default enables canonical Git repositories named hero-poc, while other projects require opt-in. Disable that project default to stop further enrollment without losing records.
+
+Every main view links to the overview, project settings and display settings. You can hide the workspace button and sidebar independently and still use Command-K. The installation id and local state directory remain follow-through for compatibility.
+
+Repair batches go to the original main agent after a click, or after explicit per-workspace Auto consent and fresh delivery checks. Recovery is a separate manual action. Done requires the main agent's declaration and settled requirements; merging and archiving remain your actions. Tasks are manual unless you explicitly schedule Now, After merge or After deploy, optionally with a delay. Deployment gates require serving-revision evidence; merges alone never prove deployment.
+
+This trusted unsandboxed plugin reads selected workspace metadata, saved agent history/configuration, GitHub status and existing CLI authentication. State and private recovery evidence remain in plugin-data/follow-through. Scoped MCP registration and reversible provider hooks support tracked main agents; Codex's trust review remains in force. Prompts and repair context are sent to your configured agent/provider. Site-specific reviewer and Cloud Run adapters only apply to the configured repository; unsupported deployments remain unknown.
+
+Merge, Merge when ready and reviewer requests require explicit developer controls. Auto and agent tools cannot authorize them. Follow-up has no Slack posting identity or background channel scanner. Stakeholder replies require the developer's authorization, original destination and a verified sent-message receipt from the agent.

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# Paseo Follow-up
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version](https://img.shields.io/npm/v/paseo-follow-up?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/paseo-follow-up)
+[![npm downloads](https://img.shields.io/npm/dm/paseo-follow-up?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/paseo-follow-up)
+[![Paseo](https://img.shields.io/badge/Paseo-%E2%89%A5%200.11.0-8A63D2?style=for-the-badge)](https://paseo.sh)
+[![License](https://img.shields.io/github/license/tomgrin10/paseo-follow-up?style=for-the-badge&color=2563eb)](LICENSE)
+
+Keep long-lived Paseo workspaces moving through review, deployment, and completion. Follow-up retains PR stacks and remaining tasks, batches repairs for the existing main agent, and records the agent's explicit Done declaration.
+
+![Follow-up workspace panel with sample pull requests and remaining tasks](docs/screenshots/follow-up-workspace.png)
+
+Screenshots use synthetic workspaces and PRs.
+
+## Requirements
+
+- Paseo 0.11.0 or newer and Node 22 or newer.
+- Authenticated GitHub CLI (`gh`) on the daemon host.
+- Saved Graphite CLI authentication for Graphite readiness and explicit Merge controls.
+- Optional Send to Paseo browser companion for Graphite's actual Merge when ready switch. Core tracking and follow-up work without it.
+
+## Install
+
+```sh
+paseo plugin install paseo-follow-up
+```
+
+The installation ID remains `follow-through` to preserve existing development installations, saved settings and tracked work. The public name is **Follow-up**.
+
+## Use
+
+Open **Follow-up** from the sidebar or Command-K. In a workspace, use the header button or the Follow-up panel and click **Track this workspace**. The original main agent owns PRs, tasks and completion; optional history recovery runs in a separate agent only after your click.
+
+Use **Overview**, **Project settings** and **Display settings** to move between views. Settings are also available directly from Command-K. Display settings can hide the workspace header button or sidebar entry independently; Command-K remains available.
+
+Project settings control existing and future eligible workspaces by stable project ID. The retained development default enables canonical Git projects named `hero-poc`; other projects start off. Turning a project off stops enrollment while preserving tracked records. New enrollments always have Auto off.
+
+With **Auto** off, review and send each repair batch yourself. Auto authorizes follow-up messages only for that workspace after fresh idle, permission and Session Guard checks. It never merges PRs, enables merge when ready, requests reviewers, starts recovery or archives workspaces.
+
+Tasks default to manual. Explicit Now, After merge or After deploy triggers can include a delay; deployment tasks wait for verified serving-revision evidence. Merged PRs alone do not mean the work is Done. Agents retain evidence and record sent reply URLs for developer-authorized stakeholder updates.
+
+![Follow-up overview with sample workspaces](docs/screenshots/follow-up-overview.png)
+
+## Data and permissions
+
+This is a trusted, unsandboxed plugin. It reads selected workspace metadata, agent history/configuration and GitHub PR status using your existing host credentials. Local state and private recovery evidence live under `$PASEO_HOME/plugin-data/follow-through`; credentials and provider configuration are not published or transferred.
+
+It registers scoped Claude/Codex MCP tools and reversible provider hooks for tracked main agents. Codex keeps its normal hook trust review. Repair and recovery prompts reach your configured agent provider. Follow-up itself has no Slack posting identity and never scans channels or authorizes replies from historical mentions.
+
+Human-operated Merge and reviewer controls perform GitHub/Graphite writes only after an explicit click and fresh eligibility checks. Unknown or uncertain results require checking before retrying. Site-specific reviewer and Cloud Run deployment adapters remain limited to their configured repository; other deployment status remains unknown rather than being inferred from a merge.
+
+## Develop
+
+```sh
+npm ci
+npm run verify
+npm run test:install
+npm pack --dry-run
+```
+
+Integration checks use a separate Paseo home, synthetic agents and fixtures. Never restart your main daemon for verification. Reload only this plugin with `paseo plugin reload follow-through`.
+
+## Releases
+
+Release tags (`vX.Y.Z`) run `.github/workflows/publish-npm.yml`. GitHub Actions verifies the plugin and packed installation, publishes through npm Trusted Publishing, verifies registry integrity, then creates the GitHub release. No npm token is stored in repository secrets.
+
+## Other plugins
+
+Also available from [Tom Gringauz](https://github.com/tomgrin10):
+
+- [Defer](https://github.com/tomgrin10/paseo-defer) — Schedule messages to agents for later delivery.
+- [Graphite](https://github.com/tomgrin10/paseo-graphite) — Workspace stack status and PR action radar.
+- [Send to Paseo](https://github.com/tomgrin10/send-to-paseo) — Send GitHub and Graphite PRs to Paseo from Chrome.
+- [Smart Session](https://github.com/tomgrin10/paseo-smart-session) — Context-aware compaction and plan usage insights.
+- [Vitals](https://github.com/tomgrin10/paseo-vitals) — Host, Paseo, agent and Docker health.
+- [Session Guard](https://github.com/tomgrin10/paseo-session-guard) — Pause at usage limits and resume after reset.
+- [Transfer](https://github.com/tomgrin10/paseo-transfer) — Copy or move workspaces and agent conversations between hosts.
+- [Transcript Search](https://github.com/tomgrin10/paseo-transcript-search) — Search active and archived conversations across hosts.

package/client/button-visibility.ts

@@ -0,0 +1,32 @@
+import type { PluginClientContext, PluginButtonRegistration } from "@getpaseo/plugin/client";
+import { subscribeDisplay } from "./display";
+
+export function withButtonVisibility(client: PluginClientContext) {
+  const entries = new Set<{ reconcile(): void; remove(): void }>();
+  let enableHeader = true;
+  let enableComposer = true;
+  function gated<K extends "addHeaderButton" | "addComposerPill">(method: K, input: Parameters<PluginClientContext[K]>[0]): PluginButtonRegistration {
+    let descriptor = input.button;
+    let registration: PluginButtonRegistration | undefined;
+    const entry = {
+      reconcile() {
+        const enabled = method === "addHeaderButton" ? enableHeader : enableComposer;
+        if (enabled && !registration) registration = (client[method] as (value: typeof input) => PluginButtonRegistration)({ ...input, button: descriptor });
+        if (!enabled && registration) { registration.remove(); registration = undefined; }
+      },
+      remove() { registration?.remove(); registration = undefined; entries.delete(entry); },
+    };
+    entries.add(entry);
+    entry.reconcile();
+    return { remove: entry.remove, update(patch) { descriptor = { ...descriptor, ...patch }; registration?.update(patch); } };
+  }
+  const buttons = Object.create(client) as PluginClientContext;
+  buttons.addHeaderButton = input => gated("addHeaderButton", input);
+  buttons.addComposerPill = input => gated("addComposerPill", input);
+  const unsubscribe = subscribeDisplay(values => {
+    enableHeader = values.enable_header_button;
+    
+    for (const entry of entries) entry.reconcile();
+  });
+  return { client: buttons, dispose() { unsubscribe(); for (const entry of [...entries]) entry.remove(); } };
+}

package/client/components.tsx

@@ -0,0 +1,58 @@
+import { useState, type ReactNode } from "react";
+import { Pressable, Text, View } from "react-native";
+import { Icon } from "@getpaseo/plugin/client/react-native";
+import type { PluginHostProps } from "@getpaseo/plugin/client";
+import { graphitePrUrl, compactPrStatus, settledForDisplay } from "../shared/presentation";
+import { summary, type Workspace, type Pr, type Status } from "../shared/model";
+import { PrControls } from "./pr-controls";
+export type Theme = PluginHostProps["theme"];
+export const colorFor = (theme: Theme, state: Status) => state === "done" ? theme.colors.statusSuccess : state === "needs-you" ? theme.colors.statusDanger : state === "waiting" ? theme.colors.statusWarning : theme.colors.accent;
+export function mergedColor(theme: Theme): string {
+  const provided = (theme.colors as Theme["colors"] & { statusMerged?: string }).statusMerged;
+  if (provided) return provided;
+  // The plugin SDK omits Paseo's merged token; use the host's light/dark tones.
+  const raw = theme.colors.surface0.replace(/^#/, "");
+  const hex = raw.length === 3 ? raw.split("").map(c => c + c).join("") : raw;
+  const brightness = [0, 2, 4].reduce((sum, offset) => sum + parseInt(hex.slice(offset, offset + 2), 16), 0) / 3;
+  return brightness < 128 ? "#a890d5" : "#7347af";
+}
+export function Button({ title, onPress, theme, primary = false, disabled = false, icon, compact = false, accessibilityLabel }: { title: string; onPress: () => void; theme: Theme; primary?: boolean; disabled?: boolean; icon?: string; compact?: boolean; accessibilityLabel?: string }) {
+  return <Pressable accessibilityRole="button" accessibilityLabel={accessibilityLabel ?? title} disabled={disabled} onPress={onPress} style={({ pressed }) => ({ minHeight: compact ? 44 : 36, paddingHorizontal: 10, paddingVertical: 8, borderRadius: 6, flexDirection: "row", alignItems: "center", justifyContent: "center", gap: 6, backgroundColor: primary ? theme.colors.accent : pressed ? theme.colors.surface2 : theme.colors.surface1, borderWidth: primary ? 0 : 1, borderColor: theme.colors.border, opacity: disabled ? 0.5 : pressed ? 0.8 : 1 })}>
+    {icon && <Icon name={icon} size={14} color={primary ? theme.colors.accentForeground : theme.colors.foreground} />}
+    <Text style={{ fontSize: 12, fontWeight: "600", color: primary ? theme.colors.accentForeground : theme.colors.foreground }}>{title}</Text>
+  </Pressable>;
+}
+export function Section({ title, count, theme, children, compact = false, initiallyExpanded = true }: { title: string; count?: number; theme: Theme; children: ReactNode; compact?: boolean; initiallyExpanded?: boolean }) {
+  const [expanded, setExpanded] = useState(initiallyExpanded);
+  return <View style={{ gap: expanded ? 8 : 0, marginTop: 16 }}><Pressable accessibilityRole="button" accessibilityLabel={`${expanded ? "Collapse" : "Expand"} ${title}`} accessibilityState={{ expanded }} aria-expanded={expanded} onPress={() => setExpanded(!expanded)} style={{ minHeight: compact ? 44 : 36, flexDirection: "row", gap: 6, alignItems: "center" }}><Icon name={expanded ? "ChevronDown" : "ChevronRight"} size={14} color={theme.colors.foregroundMuted} /><Text style={{ fontSize: 13, fontWeight: "600", color: theme.colors.foreground, flex: 1 }}>{title}</Text>{count !== undefined && <Text style={{ fontSize: 12, color: theme.colors.foregroundMuted }}>{count}</Text>}</Pressable><View accessibilityElementsHidden={!expanded} importantForAccessibility={expanded ? "auto" : "no-hide-descendants"} style={{ display: expanded ? "flex" : "none", gap: 8 }}>{children}</View></View>;
+}
+export function StatusLabel({ workspace, theme }: { workspace: Workspace; theme: Theme }) {
+  const state = summary(workspace);
+  return <View style={{ flexDirection: "row", alignItems: "center", gap: 5 }}><Icon name={state.status === "done" ? "CircleCheck" : state.status === "needs-you" ? "CircleAlert" : state.status === "waiting" ? "Clock" : "Activity"} size={14} color={colorFor(theme, state.status)} /><Text style={{ color: colorFor(theme, state.status), fontSize: 12, fontWeight: "600" }}>{state.label}</Text></View>;
+}
+export function PrRow({ pr, theme, onOpen, compact, workspace, browserReady }: { browserReady: boolean; pr: Pr; theme: Theme; onOpen: (url: string) => void; compact: boolean; workspace: Workspace }) {
+  const s = pr.snapshot;
+  const [details, setDetails] = useState(false);
+  const { label: status, tone } = compactPrStatus(pr);
+  const color = tone === "merged" ? mergedColor(theme) : tone === "approved" ? theme.colors.statusSuccess : tone === "warning" ? theme.colors.statusWarning : theme.colors.foregroundMuted;
+  return <View style={{ paddingVertical: compact ? 6 : 5, gap: 3, borderTopWidth: 1, borderColor: theme.colors.border }}><View style={{ flexDirection: "row", alignItems: "center" }}><Pressable accessibilityRole="link" accessibilityLabel={`Open ${pr.repo} pull request ${pr.number} in Graphite: ${s?.title ?? pr.stack}, ${status}`} onPress={() => onOpen(graphitePrUrl(pr))} style={({ pressed }) => ({ flex: 1, backgroundColor: pressed ? theme.colors.surface1 : "transparent", minHeight: compact ? 44 : 36, justifyContent: "center" })}>
+    <View style={{ flexDirection: "row", alignItems: "flex-start", gap: 8 }}><View style={{ width: 88, gap: 2 }}><View style={{ flexDirection: "row", alignItems: "center", gap: 5 }}><Icon name={s?.state === "MERGED" ? "GitMerge" : "GitPullRequest"} size={14} color={color} /><Text style={{ color: theme.colors.foregroundMuted, fontSize: 12, lineHeight: 16 }}>#{pr.number}</Text></View><Text style={{ fontSize: 11, lineHeight: 16, color }}>{status}</Text></View><Text numberOfLines={details ? undefined : 2} style={{ color: theme.colors.foreground, fontSize: 13, lineHeight: 18, flex: 1 }}>{s?.title ?? `${pr.repo} pull request`}</Text></View>
+    </Pressable><Pressable accessibilityRole="button" accessibilityLabel={`${details ? "Hide" : "Show"} details for PR ${pr.number}`} aria-expanded={details} accessibilityState={{ expanded: details }} onPress={() => setDetails(!details)} style={{ minHeight: compact ? 44 : 36, width: compact ? 44 : 36, justifyContent: "center", alignItems: "center" }}><Icon name={details ? "ChevronUp" : "ChevronDown"} size={12} color={theme.colors.foregroundMuted} /></Pressable></View>
+    {details && <View style={{ gap: 4 }}><Text style={{ fontSize: 12, color: theme.colors.foregroundMuted }}>{pr.repo} · {s?.state === "MERGED" ? "Merged" : status}</Text>{pr.error && <Text style={{ fontSize: 12, color: theme.colors.statusWarning }}>{pr.error}</Text>}{s?.reviewers?.complete && [...s.reviewers.requested, ...s.reviewers.teams, ...s.reviewers.reviewed].length > 0 && <Text style={{ fontSize: 12, lineHeight: 18, color: theme.colors.foregroundMuted }}>Reviewers: {[...new Set([...s.reviewers.requested, ...s.reviewers.teams.map(team => `team/${team}`), ...s.reviewers.reviewed])].join(", ")}</Text>}{s?.deployment && <Text style={{ fontSize: 12, lineHeight: 18, color: theme.colors.foregroundMuted }}>{s.deployment.evidence}</Text>}</View>}
+    {s?.state === "OPEN" && <PrControls browserReady={browserReady} pr={pr} workspace={workspace} theme={theme} compact={compact} />}
+  </View>;
+}
+export function StackGroup({ name, prs, theme, onOpen, compact, workspace, browserReady }: { browserReady: boolean; name: string; prs: Pr[]; theme: Theme; onOpen: (url: string) => void; compact: boolean; workspace: Workspace }) {
+  const [expanded, setExpanded] = useState(true);
+  const [history, setHistory] = useState(false);
+  const open = prs.filter(p => !settledForDisplay(p));
+  const past = prs.filter(settledForDisplay);
+  const fullySettled = open.length === 0;
+  const sort = (rows: Pr[]) => {
+    const depth = (p: Pr, seen = new Set<string>()): number => { if (seen.has(p.key)) return 0; seen.add(p.key); const parent = prs.find(x => x.key === p.parent); return parent ? depth(parent, seen) + 1 : 0; };
+    return [...rows].sort((a, b) => depth(a) - depth(b) || a.number - b.number);
+  };
+  return <View style={{ marginTop: 3 }}><Pressable accessibilityRole="button" accessibilityLabel={`${expanded ? "Collapse" : "Expand"} ${name} stack`} accessibilityState={{ expanded }} aria-expanded={expanded} onPress={() => setExpanded(!expanded)} style={{ minHeight: compact ? 44 : 36, flexDirection: "row", alignItems: "center", gap: 6 }}><Icon name={expanded ? "ChevronDown" : "ChevronRight"} size={14} color={theme.colors.foregroundMuted} /><Text style={{ color: theme.colors.foreground, fontSize: 13, fontWeight: "600", flex: 1 }}>{name}</Text><Text style={{ fontSize: 12, color: theme.colors.foregroundMuted }}>{fullySettled ? past.length : open.length}</Text></Pressable>
+    {expanded && <View>{sort(open).map(pr => <PrRow browserReady={browserReady} key={pr.key} pr={pr} workspace={workspace} theme={theme} onOpen={onOpen} compact={compact} />)}{past.length > 0 && !fullySettled && <Pressable accessibilityRole="button" accessibilityState={{ expanded: history }} aria-expanded={history} accessibilityLabel={`${history ? "Hide" : "Show"} settled PRs in ${name}`} onPress={() => setHistory(!history)} style={{ paddingVertical: 10, minHeight: compact ? 44 : 36, flexDirection: "row", alignItems: "center", gap: 6 }}><Icon name={history ? "ChevronDown" : "ChevronRight"} size={12} color={theme.colors.foregroundMuted} /><Text style={{ fontSize: 12, color: theme.colors.foregroundMuted }}>{history ? "Hide" : "Show"} {past.length} settled PR{past.length === 1 ? "" : "s"}</Text></Pressable>}{(fullySettled || history) && sort(past).map(pr => <PrRow browserReady={browserReady} key={pr.key} pr={pr} workspace={workspace} theme={theme} onOpen={onOpen} compact={compact} />)}</View>}
+  </View>;
+}

package/client/display.tsx

@@ -0,0 +1,102 @@
+import type { PluginClientContext, PluginSidebarContribution, PluginSurfaceProps } from "@getpaseo/plugin/client";
+import { useSettings } from "@getpaseo/plugin/client";
+import { SettingsAction, SettingsCard, SettingsSection, SettingsSwitch } from "@getpaseo/plugin/client/ui";
+import { useEffect } from "react";
+import { ActivityIndicator, ScrollView, Text, View } from "react-native";
+import { displayPreferences, displayRpc } from "../shared/display";
+import { withNavigation } from "./navigation";
+import { sidebarVisibility } from "./sidebar-visibility";
+
+type Display = import("zod").infer<typeof displayPreferences.schema>;
+const listeners = new Set<(values: Display) => void>();
+export function subscribeDisplay(listener: (values: Display) => void) { listeners.add(listener); return () => { listeners.delete(listener); }; }
+
+function DisplaySettings({ theme }: PluginSurfaceProps) {
+  const settings = useSettings(displayPreferences);
+  const values = settings.status === "ready" ? settings.values : undefined;
+  useEffect(() => {
+    if (values !== undefined) for (const listener of listeners) listener(values);
+  }, [values]);
+
+  if (settings.status === "loading") return <ActivityIndicator accessibilityLabel="Loading display settings" color={theme.colors.foregroundMuted} />;
+  if (settings.status !== "ready") return (
+    <View style={{ gap: 12 }}>
+      <Text style={{ color: theme.colors.statusDanger }}>{settings.error}</Text>
+      <SettingsCard>
+        <SettingsAction label="Try loading the saved settings again" actionLabel="Retry" onPress={() => void settings.reload()} />
+        {settings.status === "invalid" && <SettingsAction label="Replace invalid display settings with defaults" actionLabel="Reset" disabled={settings.saving} onPress={() => void settings.reset()} />}
+
+      </SettingsCard>
+      {settings.saveError && <Text style={{ color: theme.colors.statusDanger }}>{settings.saveError}</Text>}
+    </View>
+  );
+
+  return (
+    <ScrollView style={{ flex: 1 }} contentContainerStyle={{ padding: 16, gap: 16 }}>
+    <SettingsSection title="Navigation">
+      <SettingsCard>
+        <SettingsSwitch
+          label="Show in sidebar"
+          hint="Open this plugin from Command-K (Ctrl-K on Windows and Linux) while viewing a workspace or plugin on this host."
+          value={settings.values.showSidebar}
+          disabled={settings.saving}
+          onValueChange={(showSidebar) => void settings.save({ ...settings.values, showSidebar }, settings.revision)}
+        />
+
+        <SettingsSwitch label="Show workspace header button" hint="Command-K and the sidebar remain available when this button is hidden." value={settings.values.enable_header_button} disabled={settings.saving} onValueChange={(enable_header_button) => void settings.save({ ...settings.values, enable_header_button }, settings.revision)} />
+      </SettingsCard>
+      {settings.saveError && <Text accessibilityRole="alert" style={{ color: theme.colors.statusDanger }}>{settings.saveError}</Text>}
+    </SettingsSection>
+    </ScrollView>
+  );
+}
+
+/** Settings notifications reach mounted screens; poll for changes made on other clients. */
+export function contributeDisplay(client: PluginClientContext, item: PluginSidebarContribution) {
+  const sidebar = sidebarVisibility(() => client.addSidebarItem(item));
+  // Paseo 0.10.1 memoizes sidebar route resolution when an installation mounts.
+  // Register synchronously, then reconcile the saved preference, so that an
+  // already-open sidebar route can resolve its surface during that first render.
+  sidebar.set(true);
+  const Settings = withNavigation(DisplaySettings, client, item.surface, "display");
+  const removeSurface = client.addSurface("display-settings", Settings);
+  const removeSettings = client.addSettingsScreen({ id: "display", title: "Display", icon: "PanelLeft", Component: Settings });
+  const removeCommand = client.addCommandCenterItem({
+    id: "display-settings",
+    title: `${item.title}: display settings`,
+    icon: "PanelLeft",
+    keywords: [item.title, "sidebar", "show", "hide", "display", "settings"],
+    context: "global",
+    onSelect({ openSurface }) { openSurface("display-settings"); },
+  });
+  let disposed = false;
+  let pending = false;
+  let generation = 0;
+  const update = (values: Display) => { generation += 1; sidebar.set(values.showSidebar); };
+  listeners.add(update);
+  const refresh = async () => {
+    if (disposed || pending) return;
+    pending = true;
+    const currentGeneration = generation;
+    try {
+      const result = await client.rpc(displayRpc.read, {});
+      if (!disposed && generation === currentGeneration && result.status === "ready") {
+        const parsed = displayPreferences.schema.safeParse(result.values);
+        if (parsed.success) { sidebar.set(parsed.data.showSidebar); for (const listener of listeners) listener(parsed.data); }
+      }
+    } catch {
+      // Retain the last valid preference through temporary disconnects.
+    } finally { pending = false; }
+  };
+  void refresh();
+  const timer = setInterval(() => void refresh(), 5000);
+  return () => {
+    disposed = true;
+    clearInterval(timer);
+    listeners.delete(update);
+    sidebar.dispose();
+    removeSurface();
+    removeSettings();
+    removeCommand();
+  };
+}

package/client/navigation.tsx

@@ -0,0 +1,14 @@
+import type { ComponentType } from "react";
+import type { PluginClientContext, PluginSurfaceProps } from "@getpaseo/plugin/client";
+import { Pressable, Text, View } from "react-native";
+
+export function withNavigation<P extends PluginSurfaceProps>(Component: ComponentType<P>, client: PluginClientContext, home: string, active = "overview") {
+  return function PluginView(props: P) {
+    return <View style={{ flex: 1, backgroundColor: props.theme.colors.surface0 }}>
+      <View accessibilityRole="toolbar" style={{ flexDirection: "row", flexWrap: "wrap", gap: 4, padding: 8, borderBottomWidth: 1, borderColor: props.theme.colors.border }}>
+        {[{ id: "overview", title: "Overview", target: home }, { id: "display", title: "Display settings", target: "display-settings" }, { id: "projects", title: "Project settings", target: "project-settings" }].map(item => <Pressable key={item.id} accessibilityRole="button" accessibilityState={{ selected: active === item.id }} onPress={() => client.openSurface(item.target)} style={({ pressed }) => ({ minHeight: 44, paddingHorizontal: 12, justifyContent: "center", borderRadius: 6, backgroundColor: pressed || active === item.id ? props.theme.colors.surface2 : "transparent" })}><Text style={{ color: active === item.id ? props.theme.colors.foreground : props.theme.colors.foregroundMuted, fontSize: 13, fontWeight: active === item.id ? "600" : "400" }}>{item.title}</Text></Pressable>)}
+      </View>
+      <Component {...props} />
+    </View>;
+  };
+}

package/client/overview.tsx

@@ -0,0 +1,28 @@
+import { useState } from "react";
+import { ActivityIndicator, Pressable, ScrollView, Text, View } from "react-native";
+import { useRpc, type PluginSurfaceProps } from "@getpaseo/plugin/client";
+import { useQuery } from "@tanstack/react-query";
+import { Icon } from "@getpaseo/plugin/client/react-native";
+import { listRpc } from "../shared/contracts";
+import { summary, type Status } from "../shared/model";
+import { Button, colorFor } from "./components";
+import { overviewKey } from "./panel";
+
+export function FollowOverview({ theme, layout, navigation }: PluginSurfaceProps) {
+  const list = useRpc(listRpc);
+  const [showArchived, setShowArchived] = useState(false);
+  const query = useQuery({ queryKey: overviewKey, queryFn: () => list({}), refetchInterval: 5000 });
+  const groups: { status: Status; title: string }[] = [{ status: "needs-you", title: "Needs you" }, { status: "handling", title: "Agent handling" }, { status: "waiting", title: "Waiting" }, { status: "active", title: "Active" }, { status: "done", title: "Done · ready to archive" }];
+  const workspaces = (query.data?.workspaces ?? []).filter(w => !w.archived || showArchived);
+  return <ScrollView style={{ flex: 1, backgroundColor: theme.colors.surface0 }} contentContainerStyle={{ padding: layout.compact ? 16 : 24, gap: 8, maxWidth: 960, width: "100%", alignSelf: "center", paddingBottom: 40 }}>
+    <View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}><View style={{ flex: 1, gap: 7 }}><Text style={{ color: theme.colors.foreground, fontSize: 22, fontWeight: "600" }}>Workspace follow-up</Text><Text style={{ color: theme.colors.foregroundMuted, fontSize: 13 }}>What needs you, what the agents are handling, and what is finished.</Text></View><Button title="Refresh" icon="RefreshCw" theme={theme} compact={layout.compact} onPress={() => void query.refetch()} /></View>
+    {query.isPending && <ActivityIndicator color={theme.colors.accent} />}{(query.error || query.data?.error) && <Text accessibilityRole="alert" style={{ color: theme.colors.statusDanger }}>Could not refresh all workspace state. Try Refresh.</Text>}
+    {!query.isPending && !query.error && !workspaces.length && <View style={{ marginTop: 28, gap: 9 }}><Text style={{ color: theme.colors.foreground, fontSize: 16 }}>No workspaces tracked yet</Text><Text style={{ color: theme.colors.foregroundMuted, fontSize: 13, lineHeight: 20 }}>Open Follow-up in a workspace and click Track this workspace. Tracking and messages stay scoped to workspaces you choose.</Text></View>}
+    {groups.map(group => {
+      const rows = workspaces.filter(w => summary(w).status === group.status);
+      if (!rows.length) return null;
+      return <View key={group.status} style={{ marginTop: 24, gap: 9 }}><View style={{ flexDirection: "row", gap: 8, alignItems: "center" }}><Text style={{ color: colorFor(theme, group.status), fontSize: 14, fontWeight: "600" }}>{group.title}</Text><Text style={{ color: theme.colors.foregroundMuted, fontSize: 12 }}>{rows.length}</Text></View>{rows.map(w => <Pressable key={w.id} accessibilityRole="button" accessibilityLabel={`Open ${w.title}`} disabled={!navigation} onPress={() => navigation?.openWorkspace({ workspaceId: w.id })} style={({ pressed }) => ({ paddingVertical: 14, borderTopWidth: 1, borderColor: theme.colors.border, backgroundColor: pressed ? theme.colors.surface1 : "transparent", flexDirection: "row", alignItems: "flex-start", gap: 12 })}><Icon name={group.status === "done" ? "CircleCheck" : group.status === "needs-you" ? "CircleAlert" : "GitPullRequest"} size={17} color={colorFor(theme, group.status)} /><View style={{ flex: 1, gap: 6 }}><Text style={{ color: theme.colors.foreground, fontSize: 14, fontWeight: "600" }}>{w.title}{w.archived ? " · archived" : ""}</Text><Text style={{ color: theme.colors.foregroundMuted, fontSize: 13, lineHeight: 19 }}>{summary(w).reason}</Text><Text style={{ color: theme.colors.foregroundMuted, fontSize: 12 }}>{new Set(w.prs.map(p => p.stack)).size} stacks · {w.prs.length} PRs · {w.obligations.filter(o => !["done", "waived"].includes(o.status)).length} remaining tasks</Text></View>{navigation && <Icon name="ArrowUpRight" size={14} color={theme.colors.foregroundMuted} />}</Pressable>)}</View>;
+    })}
+    {query.data?.workspaces.some(w => w.archived) && <Button title={showArchived ? "Hide archived workspaces" : "Show archived history"} theme={theme} compact={layout.compact} onPress={() => setShowArchived(!showArchived)} />}
+  </ScrollView>;
+}

package/client/panel.tsx

@@ -0,0 +1,82 @@
+import { ActivityIndicator, Pressable, ScrollView, Text, View } from "react-native";
+import { Icon } from "@getpaseo/plugin/client/react-native";
+import { useRpc, openExternalUrl, type PluginWorkspacePanelProps } from "@getpaseo/plugin/client";
+import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
+import { getRpc, controlRpc, refreshRpc, activateRpc, sendRpc, browserStatusRpc, checkPrActionRpc, recoverRpc } from "../shared/contracts";
+import { orderedStacks, settledForDisplay } from "../shared/presentation";
+import { summary, type Workspace } from "../shared/model";
+import { followUpObligations, recoveryBatch } from "../shared/follow-up";
+import { FollowTask } from "./tasks";
+import { Button, Section, StackGroup, StatusLabel, colorFor } from "./components";
+
+export const workspaceKey = (id: string) => ["follow-through", "workspace", id];
+export const overviewKey = ["follow-through", "overview"];
+export function FollowPanel(props: PluginWorkspacePanelProps) {
+  const read = useRpc(getRpc);
+  const query = useQuery({ queryKey: workspaceKey(props.workspaceId), queryFn: () => read({ workspaceId: props.workspaceId }), refetchInterval: 5000 });
+  const base = { flex: 1, backgroundColor: props.theme.colors.surface0 };
+  if (query.isPending) return <View style={[base, { padding: 16, gap: 10 }]}><ActivityIndicator color={props.theme.colors.accent} /><Text style={{ color: props.theme.colors.foregroundMuted }}>Loading…</Text></View>;
+  if (query.error && !query.data?.workspace) return <View style={[base, { padding: 16, gap: 12 }]}><Text accessibilityRole="alert" style={{ color: props.theme.colors.statusDanger }}>Could not read workspace state. Refresh to retry.</Text><Button title="Retry" onPress={() => void query.refetch()} theme={props.theme} /></View>;
+  if (!query.data?.workspace) return <StartTracking {...props} loadError={query.data?.error} />;
+  return <WorkspaceView {...props} workspace={query.data.workspace} loadError={query.error ? "Refresh failed. Showing saved data." : query.data.error} />;
+}
+
+function StartTracking({ theme, workspaceId, layout, loadError }: PluginWorkspacePanelProps & { loadError?: string | null }) {
+  const activate = useRpc(activateRpc); const cache = useQueryClient();
+  const start = useMutation({ mutationFn: () => activate({ workspaceId }), onSuccess: () => { void cache.invalidateQueries({ queryKey: workspaceKey(workspaceId) }); void cache.invalidateQueries({ queryKey: overviewKey }); } });
+  return <View style={{ flex: 1, backgroundColor: theme.colors.surface0, padding: 16, gap: 12 }}><Icon name="GitPullRequest" size={24} color={theme.colors.accent} /><Text style={{ color: theme.colors.foreground, fontSize: 18, fontWeight: "600" }}>Follow this workspace</Text><Text style={{ color: theme.colors.foregroundMuted, fontSize: 13, lineHeight: 20 }}>Track PRs and follow-through. Auto starts off.</Text>{(loadError || start.error) && <Text accessibilityRole="alert" style={{ color: theme.colors.statusDanger }}>{loadError ?? start.error?.message}</Text>}<Button title={start.isPending ? "Starting…" : "Track this workspace"} primary theme={theme} compact={layout.compact} disabled={start.isPending} onPress={() => start.mutate()} /></View>;
+}
+
+export function WorkspaceView({ theme, layout, workspace, navigation, loadError }: PluginWorkspacePanelProps & { workspace: Workspace; loadError?: string | null }) {
+  const control = useRpc(controlRpc); const refresh = useRpc(refreshRpc); const send = useRpc(sendRpc); const cache = useQueryClient();
+  const runRecovery = useRpc(recoverRpc);
+  const browserRead = useRpc(browserStatusRpc); const checkAction = useRpc(checkPrActionRpc);
+  const browser = useQuery({ queryKey: ["follow-through", "browser"], queryFn: () => browserRead({}), refetchInterval: 5000 });
+  const invalidated = () => { void cache.invalidateQueries({ queryKey: workspaceKey(workspace.id) }); void cache.invalidateQueries({ queryKey: overviewKey }); };
+  const change = useMutation({ mutationFn: (input: Parameters<typeof control>[0]) => control(input), onSuccess: invalidated });
+  const update = useMutation({ mutationFn: () => refresh({ workspaceId: workspace.id }), onSuccess: invalidated });
+  const deliver = useMutation({ mutationFn: (batchId: string) => send({ workspaceId: workspace.id, batchId }), onSuccess: invalidated });
+  const recovery = useMutation({ mutationFn: () => runRecovery({ workspaceId: workspace.id }), onSuccess: invalidated });
+  const inspectAction = useMutation({ mutationFn: (actionId: string) => checkAction({ workspaceId: workspace.id, actionId }), onSuccess: invalidated });
+  const state = summary(workspace);
+  const outstanding = followUpObligations(workspace).filter(o => !["done", "waived"].includes(o.status));
+  const completed = followUpObligations(workspace).filter(o => ["done", "waived"].includes(o.status));
+  const batches = workspace.batches.filter(b => !recoveryBatch(b) && !["completed", "cancelled"].includes(b.state));
+  const lastRecovery = workspace.batches.filter(b => recoveryBatch(b) && b.state !== "cancelled").at(-1);
+  const latest = workspace.prs.map(p => p.snapshot?.observedAt).filter(Boolean).sort().at(-1);
+  const error = loadError ?? change.error?.message ?? update.error?.message ?? deliver.error?.message ?? null;
+  const compact = layout.compact;
+  const stacks = orderedStacks(workspace.prs);
+  const activeStacks = stacks.filter(stack => !stack.prs.every(settledForDisplay));
+  const settledStacks = stacks.filter(stack => stack.prs.every(settledForDisplay));
+  const labelStyle = { color: theme.colors.foregroundMuted, fontSize: 12 };
+  const open = (link: string) => { void openExternalUrl(link).catch(() => undefined); };
+  return <ScrollView style={{ flex: 1, backgroundColor: theme.colors.surface0 }} contentContainerStyle={{ padding: compact ? 16 : 12, paddingBottom: 28 }}>
+    <View style={{ flexDirection: "row", alignItems: "center", gap: 8 }}><Text style={{ color: theme.colors.foreground, fontSize: 18, fontWeight: "600", flex: 1 }}>Follow-up</Text><Pressable accessibilityRole="switch" aria-checked={workspace.enable_auto_sends} accessibilityLabel="Auto" accessibilityHint="Allow automatic sends in this workspace" accessibilityState={{ checked: workspace.enable_auto_sends, disabled: change.isPending }} disabled={change.isPending} onPress={() => change.mutate({ workspaceId: workspace.id, enable_auto_sends: !workspace.enable_auto_sends })} style={{ minHeight: compact ? 44 : 36, paddingHorizontal: 10, borderRadius: 6, borderWidth: 1, borderColor: workspace.enable_auto_sends ? theme.colors.accent : theme.colors.border, backgroundColor: workspace.enable_auto_sends ? theme.colors.accent : theme.colors.surface0, flexDirection: "row", alignItems: "center", gap: 5, opacity: change.isPending ? 0.5 : 1 }}><Icon name={workspace.enable_auto_sends ? "Check" : "Circle"} size={13} color={workspace.enable_auto_sends ? theme.colors.accentForeground : theme.colors.foregroundMuted} /><Text style={{ fontSize: 13, color: workspace.enable_auto_sends ? theme.colors.accentForeground : theme.colors.foreground }}>Auto</Text></Pressable><Button title={update.isPending ? "Refreshing…" : "Refresh"} icon="RefreshCw" theme={theme} compact={compact} disabled={update.isPending} onPress={() => update.mutate()} /></View>
+    <View style={{ marginTop: 8, gap: 6 }}><StatusLabel workspace={workspace} theme={theme} />{(state.status === "needs-you" || state.status === "done") && <Text style={{ color: theme.colors.foregroundMuted, fontSize: 12, lineHeight: 18 }}>{state.reason}</Text>}{workspace.hold && <Button title="Resume follow-up" theme={theme} compact={compact} onPress={() => change.mutate({ workspaceId: workspace.id, clearHold: true })} disabled={change.isPending} />}</View>
+    {error && <Text accessibilityRole="alert" style={{ color: theme.colors.statusDanger, fontSize: 12, marginTop: 8 }}>{error}</Text>}
+    <Section title="Pull requests" count={workspace.prs.length} theme={theme} compact={compact}>{workspace.prs.length === 0 && <Text style={labelStyle}>No PRs recorded.</Text>}{workspace.prActions.filter(a => ["sending", "uncertain"].includes(a.state)).map(a => <View key={a.id} style={{ gap: 7 }}><Text style={{ ...labelStyle, color: theme.colors.statusWarning, lineHeight: 18 }}>{a.result}</Text>{a.state === "uncertain" && <Button title={inspectAction.isPending ? "Checking…" : "Check state"} theme={theme} compact={compact} disabled={inspectAction.isPending} onPress={() => inspectAction.mutate(a.id)} />}</View>)}{inspectAction.error && <Text accessibilityRole="alert" style={{ ...labelStyle, color: theme.colors.statusDanger }}>{inspectAction.error.message}</Text>}{activeStacks.map(stack => <StackGroup browserReady={browser.data?.ready ?? false} key={stack.name} name={stack.name} prs={stack.prs} workspace={workspace} theme={theme} onOpen={open} compact={compact} />)}{settledStacks.length > 0 && <Section title="Settled" count={settledStacks.reduce((count, stack) => count + stack.prs.length, 0)} theme={theme} compact={compact} initiallyExpanded={false}>{settledStacks.map(stack => <StackGroup browserReady={browser.data?.ready ?? false} key={stack.name} name={stack.name} prs={stack.prs} workspace={workspace} theme={theme} onOpen={open} compact={compact} />)}</Section>}{activeStacks.length > 0 && browser.data && !browser.data.ready && <Section title="Optional merge when ready" theme={theme} compact={compact} initiallyExpanded={false}><Text style={[labelStyle, { lineHeight: 18 }]}>Connect Chrome for Graphite’s When ready toggle.</Text><Text style={[labelStyle, { lineHeight: 18 }]}>Requires the paired Send to Paseo extension and an open Graphite tab.</Text><Button title="Connect Graphite" theme={theme} compact={compact} onPress={() => open("https://app.graphite.com")} /></Section>}</Section>
+    <Section title="Tasks" count={outstanding.length} theme={theme} compact={compact}>
+      {!outstanding.length && <Text style={labelStyle}>No follow-through tasks.</Text>}
+      {outstanding.map(o => <FollowTask key={o.id} obligation={o} workspace={workspace} theme={theme} compact={compact} />)}
+      {completed.length > 0 && <Section title="Completed" count={completed.length} theme={theme} compact={compact} initiallyExpanded={false}>{completed.map(o => <FollowTask key={o.id} obligation={o} workspace={workspace} theme={theme} compact={compact} />)}</Section>}
+    </Section>
+    <Section title="Activity" count={batches.length} theme={theme} compact={compact} initiallyExpanded={batches.length > 0}>{batches.map(b => <View key={b.id} style={{ gap: 6, paddingVertical: 9, borderTopWidth: 1, borderColor: theme.colors.border }}><View style={{ flexDirection: "row", gap: 8, alignItems: "center" }}><Icon name={b.state === "sent" ? "Activity" : b.state === "pending" ? "Clock" : "CircleAlert"} size={14} color={b.state === "sent" ? theme.colors.accent : theme.colors.statusWarning} /><Text style={{ color: theme.colors.foreground, fontSize: 13, fontWeight: "600" }}>{b.state === "sent" ? b.recipientAgentId && b.recipientAgentId !== workspace.mainAgentId ? "Recovering" : "Agent working" : b.state === "pending" ? workspace.enable_auto_sends ? `Auto queued · ${b.tasks.length}` : `Ready · ${b.tasks.length}` : b.state === "uncertain" ? "Check delivery" : "Blocked"}</Text></View><Section title="Batch details" count={b.tasks.length} theme={theme} compact={compact} initiallyExpanded={false}>{b.tasks.map(t => <Text key={t.key} style={[labelStyle, { lineHeight: 18 }]}>{t.title}</Text>)}{b.result && <Text style={labelStyle}>{b.result}</Text>}</Section>{b.result && <Text numberOfLines={2} style={{ color: theme.colors.statusWarning, fontSize: 12, lineHeight: 18 }}>{b.result}</Text>}{b.state === "pending" && <><Button title={deliver.isPending ? "Sending…" : b.tasks.every(t => t.kind === "inventory") ? "Run recovery" : "Send batch"} theme={theme} compact={compact} disabled={deliver.isPending || workspace.runtimeBusy || !!workspace.runtimeReason || !!workspace.hold || batches.some(other => other.id !== b.id && ["sending", "sent", "blocked", "uncertain"].includes(other.state))} onPress={() => deliver.mutate(b.id)} />{workspace.runtimeBusy && <Text style={labelStyle}>Wait for active agent work to finish.</Text>}</>}{["blocked", "uncertain"].includes(b.state) && <Button title="Retry" theme={theme} compact={compact} disabled={change.isPending} onPress={() => change.mutate({ workspaceId: workspace.id, retryBatchId: b.id })} />}</View>)}{!batches.length && <Text style={labelStyle}>No pending follow-up.</Text>}</Section>
+    <Section title="Workspace" theme={theme} compact={compact} initiallyExpanded={false}>
+    <Text style={[labelStyle, { lineHeight: 18 }]}>{workspace.goal}</Text>
+    {navigation && <View><Button title="Open main agent" theme={theme} compact={compact} onPress={() => navigation.openAgent({ agentId: workspace.mainAgentId })} /></View>}
+    <Text style={[labelStyle, { marginTop: 18 }]}>{latest ? `PR status checked ${new Date(latest).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}` : "Status refresh runs even when the app is closed"}</Text>
+    <Section title="Recovery" theme={theme} compact={compact} initiallyExpanded={false}>
+      {recovery.error && <Text accessibilityRole="alert" style={{ ...labelStyle, color: theme.colors.statusWarning }}>{recovery.error.message}</Text>}
+      <Button title={recovery.isPending || lastRecovery?.state === "sending" ? "Starting recovery…" : "Run recovery"} theme={theme} compact={compact} disabled={recovery.isPending || workspace.archived || !!lastRecovery && (["pending", "sending", "sent", "uncertain"].includes(lastRecovery.state) || lastRecovery.state === "blocked" && !lastRecovery.settledAt)} onPress={() => recovery.mutate()} />
+      {lastRecovery && <View style={{ gap: 6 }}><Text style={labelStyle}>{lastRecovery.state === "sent" ? "Recovery running" : lastRecovery.state === "completed" ? "Recovery complete" : lastRecovery.state === "pending" ? "Recovery ready" : lastRecovery.state === "sending" ? "Starting recovery" : "Check recovery"}</Text>
+      {lastRecovery.result && <Section title="Result" theme={theme} compact={compact} initiallyExpanded={false}><Text style={labelStyle}>{lastRecovery.result}</Text></Section>}
+      {lastRecovery.recipientAgentId && navigation && <Button title="Open recovery agent" theme={theme} compact={compact} onPress={() => navigation.openAgent({ agentId: lastRecovery.recipientAgentId! })} />}
+      {lastRecovery.state === "pending" && <Button title="Run queued recovery" theme={theme} compact={compact} disabled={deliver.isPending} onPress={() => deliver.mutate(lastRecovery.id)} />}
+      {["blocked", "uncertain"].includes(lastRecovery.state) && <Button title="Retry recovery" theme={theme} compact={compact} disabled={change.isPending} onPress={() => change.mutate({ workspaceId: workspace.id, retryBatchId: lastRecovery.id })} />}
+      </View>}
+    </Section>
+    {workspace.completion && <Text style={{ fontSize: 12, color: colorFor(theme, state.status), marginTop: 8 }}>Ready to archive.</Text>}
+    </Section>
+  </ScrollView>;
+}

package/client/pr-controls.tsx

@@ -0,0 +1,67 @@
+import { useState } from "react";
+import { Pressable, Text, View } from "react-native";
+import { useRpc } from "@getpaseo/plugin/client";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { confirmPrActionRpc, preparePrActionRpc, prControlStatusRpc, requestReviewersRpc } from "../shared/contracts";
+import type { ActionPlan, PrActionKind } from "../shared/pr-actions";
+import type { Pr, Workspace } from "../shared/model";
+import { Button, type Theme } from "./components";
+import { defaultReviewers, noReviewers } from "../shared/reviewers";
+
+export function PrControls({ pr, workspace, theme, compact, browserReady }: { browserReady: boolean; pr: Pr; workspace: Workspace; theme: Theme; compact: boolean }) {
+  const read = useRpc(prControlStatusRpc); const prepare = useRpc(preparePrActionRpc); const confirm = useRpc(confirmPrActionRpc); const cache = useQueryClient();
+  const requestReviewers = useRpc(requestReviewersRpc);
+  const [plan, setPlan] = useState<ActionPlan | null>(null); const [notice, setNotice] = useState<string | null>(null);
+  const statusKey = ["follow-through", "pr-controls", workspace.id, pr.key, pr.snapshot?.head];
+  const status = useQuery({ queryKey: statusKey, queryFn: () => read({ workspaceId: workspace.id, prKey: pr.key }), refetchInterval: 5000, enabled: browserReady });
+  const invalidate = () => { void cache.invalidateQueries({ queryKey: ["follow-through", "workspace", workspace.id] }); void cache.invalidateQueries({ queryKey: ["follow-through", "pr-controls", workspace.id] }); void cache.invalidateQueries({ queryKey: ["follow-through", "overview"] }); };
+  const reviewRequest = useMutation({ mutationFn: () => requestReviewers({ workspaceId: workspace.id, prKey: pr.key }), onSuccess: reply => { setNotice(reply.result); invalidate(); }, onError: invalidate });
+  const submit = useMutation({ mutationFn: (input: { planId: string; scope: "target" | "downstack" }) => confirm(input), onSuccess: reply => { setPlan(null); setNotice(reply.result); invalidate(); }, onError: invalidate });
+  const checking = useMutation({ mutationFn: (kind: PrActionKind) => prepare({ workspaceId: workspace.id, prKey: pr.key, kind }), onSuccess: result => {
+    if (result.kind !== "merge" && result.prs.length === 1 && !result.blockers.length && !result.prs[0].blockers.length) submit.mutate({ planId: result.id, scope: "target" });
+    else setPlan(result);
+  } });
+  const pendingAction = workspace.prActions.some(a => ["sending", "uncertain"].includes(a.state));
+  const busy = checking.isPending || submit.isPending;
+  const actual = browserReady ? status.data?.pr : null;
+  const known = !!actual && !status.error && !status.data?.error;
+  const enabled = known && actual.mergeWhenReady;
+  const queued = actual?.merging || ["QUEUED_TO_MERGE", "WAITING_TO_MERGE", "REBASING", "HANDED_OFF_TO_EXTERNAL_MERGE_QUEUE"].includes(pr.snapshot?.graphiteMergeStatus ?? "");
+  const recentlySubmitted = workspace.prActions.some(a => a.kind === "merge" && a.state === "submitted" && a.heads[pr.key] === pr.snapshot?.head && Date.now() - Date.parse(a.createdAt) < 30_000);
+  const canMerge = !pr.error && pr.snapshot?.complete && pr.snapshot.state === "OPEN" && pr.snapshot.reviewDecision === "APPROVED" && !pr.snapshot.draft && !pr.snapshot.conflict && !pr.snapshot.failedChecks.length && !pr.snapshot.checksPending && !queued && !recentlySubmitted;
+  const disabled = busy || reviewRequest.isPending || pendingAction || workspace.archived;
+  const missingReviewers = noReviewers(pr);
+  const reviewers = defaultReviewers(pr.repo).filter(r => r.login.toLowerCase() !== pr.snapshot?.reviewers?.author?.toLowerCase());
+  const begin = (kind: PrActionKind) => { setPlan(null); setNotice(null); submit.reset(); checking.reset(); checking.mutate(kind); };
+  const muted = { color: theme.colors.foregroundMuted, fontSize: 12, lineHeight: 18 };
+  const error = checking.error?.message ?? submit.error?.message ?? reviewRequest.error?.message ?? (browserReady ? status.data?.error : null) ?? null;
+  const scopeBlocked = (scope: "target" | "downstack") => !!plan && (plan.blockers.length > 0 || (scope === "target" ? plan.prs.slice(-1) : plan.prs).some(p => p.blockers.length > 0));
+  const act = (scope: "target" | "downstack") => { if (plan) submit.mutate({ planId: plan.id, scope }); };
+  if (!browserReady && !canMerge && !queued && !recentlySubmitted && !busy && !error && !notice && !plan && !missingReviewers) return null;
+  return <View style={{ gap: 5, paddingLeft: 0 }}>
+    {missingReviewers && <View style={{ flexDirection: "row", alignItems: "center", justifyContent: "space-between", gap: 8 }}>
+      <Text style={{ ...muted, color: theme.colors.statusWarning }}>No reviewers</Text>
+      {!pr.snapshot?.draft && reviewers.length > 0 && <Button title={reviewRequest.isPending ? "Requesting…" : "Add reviewers"} accessibilityLabel={`Add reviewers: ${reviewers.map(r => r.name).join(" and ")} for ${pr.repo} pull request ${pr.number}`} icon="UserPlus" theme={theme} compact={compact} disabled={disabled} onPress={() => { setNotice(null); reviewRequest.mutate(); }} />}
+    </View>}
+    <View style={{ flexDirection: "row", alignItems: "center", justifyContent: "flex-end", gap: 8 }}>
+      {browserReady && <Pressable accessibilityRole="switch" aria-checked={known ? !!enabled : "mixed"} aria-valuetext={known ? enabled ? "On" : "Off" : "Unknown"} accessibilityLabel={`Merge when ready for ${pr.repo} pull request ${pr.number}`} accessibilityValue={{ text: known ? enabled ? "On" : "Off" : "Unknown" }} accessibilityState={{ checked: !!enabled, disabled: disabled || !known }} disabled={disabled || !known} onPress={() => begin(enabled ? "disable_mwr" : "enable_mwr")} style={{ minHeight: compact ? 44 : 36, flex: 1, flexDirection: "row", gap: 7, alignItems: "center", opacity: disabled ? 0.5 : 1 }}>
+        <View style={{ width: 30, height: 18, borderRadius: 9, backgroundColor: enabled ? theme.colors.accent : theme.colors.surface2, borderWidth: 1, borderColor: enabled ? theme.colors.accent : theme.colors.border }}><View style={{ width: 12, height: 12, borderRadius: 6, position: "absolute", top: 2, left: enabled ? 14 : 2, backgroundColor: known ? enabled ? theme.colors.accentForeground : theme.colors.foregroundMuted : theme.colors.border }} /></View>
+        <Text style={{ ...muted, flexShrink: 1 }}>When ready{!known ? " · unknown" : ""}</Text>
+      </Pressable>}
+      {(canMerge || queued || recentlySubmitted || busy) && <Button title={busy ? checking.isPending ? "Checking…" : "Saving…" : queued ? "Queued" : recentlySubmitted ? "Submitted" : "Merge"} icon={queued ? "Clock" : "GitMerge"} theme={theme} compact={compact} primary={!!canMerge} disabled={disabled || !canMerge} onPress={() => begin("merge")} />}
+    </View>
+    {error && <Text accessibilityRole="alert" style={{ ...muted, color: theme.colors.statusDanger }}>{error}</Text>}
+    {notice && <Text accessibilityLiveRegion="polite" style={muted}>{notice}</Text>}
+    {plan && (plan.kind === "merge" || browserReady) && <View style={{ gap: 8, backgroundColor: theme.colors.surface1, borderRadius: 6, padding: 10 }}>
+      <Text style={{ color: theme.colors.foreground, fontSize: 13, fontWeight: "600", lineHeight: 19 }}>{plan.kind === "merge" ? plan.prs.length > 1 ? "Merge the PRs underneath too?" : "Merge this PR?" : `${plan.kind === "enable_mwr" ? "Enable" : "Disable"} for downstack too?`}</Text>
+      <Text style={muted}>{plan.kind === "merge" ? plan.prs.length > 1 ? `#${pr.number} depends on ${plan.prs.length - 1} unmerged PR${plan.prs.length === 2 ? "" : "s"}. Merge these ${plan.prs.length} PRs in order:` : "Graphite will merge using this repository’s settings and required protections." : `Change merge when ready for #${pr.number} only, or for all ${plan.prs.length} listed PRs.`}</Text>
+      {plan.prs.map(p => <View key={p.key} style={{ gap: 2 }}><Text style={{ color: theme.colors.foreground, fontSize: 12, lineHeight: 18 }}>#{p.number} · {p.title}</Text>{p.blockers.length > 0 && <Text style={{ ...muted, color: theme.colors.statusWarning }}>{p.blockers.join(" · ")}</Text>}</View>)}
+      {plan.blockers.map(blocker => <Text key={blocker} style={{ ...muted, color: theme.colors.statusWarning }}>{blocker}</Text>)}
+      <View style={{ gap: 6 }}>
+        <Button title={submit.isPending ? "Submitting…" : plan.kind === "merge" ? plan.prs.length > 1 ? `Merge all ${plan.prs.length} PRs` : `Merge #${pr.number}` : `${plan.kind === "enable_mwr" ? "Enable" : "Disable"} for all ${plan.prs.length} PRs`} primary theme={theme} compact={compact} disabled={submit.isPending || scopeBlocked("downstack")} onPress={() => act("downstack")} />
+        {plan.kind !== "merge" && plan.prs.length > 1 && <Button title="Just this PR" theme={theme} compact={compact} disabled={submit.isPending || scopeBlocked("target")} onPress={() => act("target")} />}
+        <Button title="Cancel" theme={theme} compact={compact} disabled={submit.isPending} onPress={() => { setPlan(null); checking.reset(); submit.reset(); }} />
+      </View>
+    </View>}
+  </View>;
+}

package/client/settings.tsx

@@ -0,0 +1,27 @@
+import { ActivityIndicator, Pressable, ScrollView, Text, View } from "react-native";
+import type { PluginSurfaceProps } from "@getpaseo/plugin/client";
+import { useRpc } from "@getpaseo/plugin/client";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { projectSettingsRpc, setProjectTrackingRpc } from "../shared/contracts";
+import { Button } from "./components";
+
+export function FollowSettings({ theme, layout }: PluginSurfaceProps) {
+  const read = useRpc(projectSettingsRpc); const write = useRpc(setProjectTrackingRpc); const cache = useQueryClient();
+  const query = useQuery({ queryKey: ["follow-through", "project-settings"], queryFn: () => read({}), refetchInterval: 15000 });
+  const change = useMutation({ mutationFn: (input: Parameters<typeof write>[0]) => write(input), onSuccess: value => { cache.setQueryData(["follow-through", "project-settings"], value); void cache.invalidateQueries({ queryKey: ["follow-through", "overview"] }); void cache.invalidateQueries({ queryKey: ["follow-through", "workspace"] }); } });
+  const muted = { color: theme.colors.foregroundMuted, fontSize: 13, lineHeight: 20 };
+  return <ScrollView style={{ flex: 1, backgroundColor: theme.colors.surface0 }} contentContainerStyle={{ padding: layout.compact ? 16 : 24, gap: 14, maxWidth: 820, width: "100%", alignSelf: "center", paddingBottom: 40 }}>
+    <View style={{ flexDirection: "row", alignItems: "center", gap: 12 }}><Text style={{ color: theme.colors.foreground, fontSize: 22, fontWeight: "600", flex: 1 }}>Follow-up settings</Text><Button title="Refresh" icon="RefreshCw" theme={theme} compact={layout.compact} onPress={() => void query.refetch()} /></View>
+    <Text style={muted}>Choose which projects track workspaces by default. Turning a project on adds its existing and new workspaces when a main agent is available. Turning it off keeps workspaces already tracked.</Text>
+    <Text style={muted}>Auto sends stay off for newly tracked workspaces. Recovery and follow-up wait for your click unless you turn on Auto in that workspace.</Text>
+    <Text style={{ color: theme.colors.foreground, fontSize: 15, fontWeight: "600", marginTop: 12 }}>Default tracking by project</Text>
+    {query.isPending && <ActivityIndicator color={theme.colors.accent} />}
+    {(query.error || change.error) && <Text accessibilityRole="alert" style={{ ...muted, color: theme.colors.statusDanger }}>{change.error?.message ?? query.error?.message}</Text>}
+    {query.data?.projects.length === 0 && <Text style={muted}>Projects appear here after you add them to Paseo.</Text>}
+    {query.data?.projects.map(project => <Pressable key={project.id} accessibilityRole="switch" accessibilityLabel={`Default tracking for ${project.name}, ${project.key}`} aria-checked={project.enable_default_tracking} accessibilityState={{ checked: project.enable_default_tracking, disabled: change.isPending }} disabled={change.isPending} onPress={() => change.mutate({ projectId: project.id, enable_default_tracking: !project.enable_default_tracking })} style={({ pressed }) => ({ minHeight: layout.compact ? 64 : 58, paddingVertical: 12, borderTopWidth: 1, borderColor: theme.colors.border, flexDirection: "row", alignItems: "center", gap: 16, backgroundColor: pressed ? theme.colors.surface1 : "transparent", opacity: change.isPending && change.variables?.projectId === project.id ? 0.5 : 1 })}>
+      <View style={{ flex: 1, gap: 4 }}><Text style={{ color: theme.colors.foreground, fontSize: 14, fontWeight: "600" }}>{project.name}</Text><Text style={{ ...muted, fontSize: 12 }}>{project.key.startsWith("remote:") ? project.key.slice(7) : project.path}</Text></View>
+      <View style={{ flexDirection: "row", alignItems: "center", gap: 8 }}><Text style={muted}>{project.enable_default_tracking ? "On" : "Off"}</Text><View style={{ width: 30, height: 18, borderRadius: 9, backgroundColor: project.enable_default_tracking ? theme.colors.accent : theme.colors.surface2, borderWidth: 1, borderColor: project.enable_default_tracking ? theme.colors.accent : theme.colors.border }}><View style={{ width: 12, height: 12, borderRadius: 6, position: "absolute", top: 2, left: project.enable_default_tracking ? 14 : 2, backgroundColor: project.enable_default_tracking ? theme.colors.accentForeground : theme.colors.foregroundMuted }} /></View></View>
+    </Pressable>)}
+    {change.isSuccess && <Text accessibilityLiveRegion="polite" style={muted}>Project default saved.</Text>}
+  </ScrollView>;
+}