feat: expand Delivery and managed PR dev

docs/architecture/frontend-feature-map.md

@@ -20,7 +20,7 @@ cannot infer.
 | `/jobs`          | `Jobs.tsx`              | scheduled jobs and run history              |
 | `/reports`       | `Reports.tsx`           | reports list/detail APIs                    |
 | `/notifications` | notification bell/modal | notification APIs                           |
-| `/pull-requests` | `PullRequests.tsx`      | GitHub, PR dev, release/deploy services     |
+| `/delivery`      | `Delivery.tsx`          | GitHub, PR dev, release/deploy services     |
 | `/docker`        | `Docker.tsx`            | Docker inventory/updater APIs               |
 | `/files`         | `Files.tsx`             | workspace file APIs                         |
 | `/logs`          | `Logs.tsx`              | log file APIs                               |

docs/architecture/overview.md

@@ -38,23 +38,23 @@ Mira Dashboard worker                         |
 
 Primary pages:
 
-| Path             | Purpose                                                    |
-| ---------------- | ---------------------------------------------------------- |
-| `/`              | Operations dashboard overview.                             |
-| `/tasks`         | Local task board and task updates.                         |
-| `/agents`        | Agent status and task history.                             |
-| `/sessions`      | OpenClaw session table and actions.                        |
-| `/chat`          | Gateway-backed chat UI.                                    |
-| `/logs`          | Log file browsing/tailing.                                 |
-| `/jobs`          | Dashboard scheduled jobs.                                  |
-| `/reports`       | Daily briefs, summaries, heartbeats, and custom reports.   |
-| `/pull-requests` | PR review, trusted PR dev, releases, deploy, and rollback. |
-| `/files`         | Workspace file browser/editor.                             |
-| `/docker`        | Docker state and managed updater.                          |
-| `/database`      | Postgres/PgBouncer and Dashboard SQLite overview.          |
-| `/moltbook`      | Moltbook dashboard.                                        |
-| `/settings`      | OpenClaw/Dashboard settings.                               |
-| `/terminal`      | Terminal helper/completion UI.                             |
+| Path        | Purpose                                                    |
+| ----------- | ---------------------------------------------------------- |
+| `/`         | Operations dashboard overview.                             |
+| `/tasks`    | Local task board and task updates.                         |
+| `/agents`   | Agent status and task history.                             |
+| `/sessions` | OpenClaw session table and actions.                        |
+| `/chat`     | Gateway-backed chat UI.                                    |
+| `/logs`     | Log file browsing/tailing.                                 |
+| `/jobs`     | Dashboard scheduled jobs.                                  |
+| `/reports`  | Daily briefs, summaries, heartbeats, and custom reports.   |
+| `/delivery` | PR review, trusted PR dev, releases, deploy, and rollback. |
+| `/files`    | Workspace file browser/editor.                             |
+| `/docker`   | Docker state and managed updater.                          |
+| `/database` | Postgres/PgBouncer and Dashboard SQLite overview.          |
+| `/moltbook` | Moltbook dashboard.                                        |
+| `/settings` | OpenClaw/Dashboard settings.                               |
+| `/terminal` | Terminal helper/completion UI.                             |
 
 ## Backend
 

docs/development/local-dev.md

@@ -133,7 +133,7 @@ the frontend proxy strips non-dev Dashboard cookies before forwarding requests.
 
 ## Managed PR Dev
 
-The Pull requests page exposes one shared **PR dev** slot:
+The Delivery page exposes one shared **PR dev** slot:
 
 - Only PRs targeting `main` from the configured trusted-author allowlist can
   start.

docs/setup/production-deploy.md

@@ -107,7 +107,7 @@ must still return `401`.
 ## Rollback
 
 Normal activation automatically rolls back on restart or commit-bound readiness
-failure. The preferred manual path is **Pull requests → Production releases →
+failure. The preferred manual path is **Delivery → Production releases →
 Roll back**, which uses the same exclusive release lock, persistent job,
 detached guardian, web/worker restart, commit-bound readiness, and automatic
 restoration of the original release if the rollback target fails.

src/components/features/pullRequests/PullRequestPreviewCard.tsx → src/components/features/delivery/PullRequestDevelopmentCard.tsx

@@ -45,7 +45,7 @@ function previewLabel(status: PullRequestPreviewStatus["status"]): string {
 }
 
 /** Renders the global single-slot trusted PR development status. */
-export function PullRequestPreviewCard({
+export function PullRequestDevelopmentCard({
     error,
     isStopPending = false,
     onStop,

src/components/layout/Layout.tsx

@@ -6,10 +6,10 @@ import {
     Database,
     FileText,
     FolderOpen,
-    GitPullRequest,
     Home,
     MessageSquare,
     Newspaper,
+    Rocket,
     Settings,
     Terminal,
     Users,
@@ -24,7 +24,7 @@ import {
     useState,
 } from "react";
 
-import { PULL_REQUEST_NAV_REFRESH_MS, useCacheEntry, usePullRequests } from "../../hooks";
+import { DELIVERY_NAV_REFRESH_MS, useCacheEntry, usePullRequests } from "../../hooks";
 import { cn } from "../../utils/cn";
 import { AppHeader } from "./AppHeader";
 
@@ -37,7 +37,7 @@ const navItems = [
     { to: "/logs", icon: FileText, label: "Logs" },
     { to: "/jobs", icon: Clock3, label: "Jobs" },
     { to: "/reports", icon: Newspaper, label: "Reports" },
-    { to: "/pull-requests", icon: GitPullRequest, label: "PRs" },
+    { to: "/delivery", icon: Rocket, label: "Delivery" },
     { to: "/files", icon: FolderOpen, label: "Files" },
     { to: "/docker", icon: Boxes, label: "Docker" },
     { to: "/database", icon: Database, label: "Database" },
@@ -65,7 +65,7 @@ export function Layout({ children }: LayoutProperties) {
     const sidebarId = useId();
     const [isSidebarOpen, setIsSidebarOpen] = useState(false);
     const { data: systemHost } = useCacheEntry<SystemHostCache>("system.host", 60_000);
-    const { data: pullRequests = [] } = usePullRequests(PULL_REQUEST_NAV_REFRESH_MS);
+    const { data: pullRequests = [] } = usePullRequests(DELIVERY_NAV_REFRESH_MS);
     const openClawVersion = systemHost?.data.version?.current;
     const openPullRequestCount = pullRequests.length;
 
@@ -120,7 +120,7 @@ export function Layout({ children }: LayoutProperties) {
                         >
                             <item.icon size={20} aria-hidden="true" />
                             <span>{item.label}</span>
-                            {item.to === "/pull-requests" && openPullRequestCount > 0 ? (
+                            {item.to === "/delivery" && openPullRequestCount > 0 ? (
                                 <span
                                     className={cn(
                                         "ml-auto min-w-5 rounded-full px-1.5 py-0.5 text-center text-xs font-semibold",

src/hooks/index.ts

@@ -117,25 +117,25 @@ export type {
     PullRequestPreviewStatus,
     PullRequestSummary,
     WorktreeCleanupResult,
-} from "./usePullRequests";
+} from "./useDelivery";
 export {
-    PULL_REQUEST_NAV_REFRESH_MS,
-    PULL_REQUEST_PAGE_REFRESH_MS,
-    pullRequestKeys,
+    DELIVERY_NAV_REFRESH_MS,
+    DELIVERY_PAGE_REFRESH_MS,
+    deliveryKeys,
     useApprovePullRequest,
     useApprovePullRequestReview,
+    useDashboardDeployments,
     useDashboardReleaseStatus,
     useDeployDashboard,
     useProductionCheckout,
-    usePullRequestDeployments,
     usePullRequestPreview,
     usePullRequests,
     useRejectPullRequest,
     useRollbackDashboard,
     useStartPullRequestPreview,
     useStopPullRequestPreview,
     useUpdatePullRequestBranch,
-} from "./usePullRequests";
+} from "./useDelivery";
 export { hasQuotaStatus, useQuotas } from "./useQuotas";
 export type { ReportItem, ReportStatus, ReportType } from "./useReports";
 export {

src/hooks/usePullRequests.ts → src/hooks/useDelivery.ts

@@ -148,18 +148,18 @@ interface PullRequestActionResponse {
     pullRequest?: PullRequestSummary;
 }
 
-/** Defines pull request keys. */
-export const pullRequestKeys = {
-    all: ["pull-requests"] as const,
-    list: () => [...pullRequestKeys.all, "list"] as const,
-    deployments: () => [...pullRequestKeys.all, "deployments"] as const,
-    preview: () => [...pullRequestKeys.all, "preview"] as const,
-    productionCheckout: () => [...pullRequestKeys.all, "production-checkout"] as const,
-    releaseStatus: () => [...pullRequestKeys.all, "releases"] as const,
+/** Defines delivery page query keys. */
+export const deliveryKeys = {
+    all: ["delivery"] as const,
+    list: () => [...deliveryKeys.all, "pull-requests"] as const,
+    deployments: () => [...deliveryKeys.all, "deployments"] as const,
+    preview: () => [...deliveryKeys.all, "preview"] as const,
+    productionCheckout: () => [...deliveryKeys.all, "production-checkout"] as const,
+    releaseStatus: () => [...deliveryKeys.all, "releases"] as const,
 };
 
-export const PULL_REQUEST_NAV_REFRESH_MS = 60_000;
-export const PULL_REQUEST_PAGE_REFRESH_MS = AUTO_REFRESH_MS;
+export const DELIVERY_NAV_REFRESH_MS = 60_000;
+export const DELIVERY_PAGE_REFRESH_MS = AUTO_REFRESH_MS;
 
 /** Fetches pull requests. */
 async function fetchPullRequests(): Promise<PullRequestSummary[]> {
@@ -280,19 +280,19 @@ async function stopPullRequestPreview(number: number): Promise<PullRequestPrevie
 }
 
 /** Provides pull requests. */
-export function usePullRequests(refreshInterval = PULL_REQUEST_PAGE_REFRESH_MS) {
+export function usePullRequests(refreshInterval = DELIVERY_PAGE_REFRESH_MS) {
     return useQuery({
-        queryKey: pullRequestKeys.list(),
+        queryKey: deliveryKeys.list(),
         queryFn: fetchPullRequests,
         staleTime: 10_000,
         refetchInterval: refreshInterval,
     });
 }
 
-/** Provides pull request deployments. */
-export function usePullRequestDeployments() {
+/** Provides Dashboard deployment and rollback jobs. */
+export function useDashboardDeployments() {
     return useQuery({
-        queryKey: pullRequestKeys.deployments(),
+        queryKey: deliveryKeys.deployments(),
         queryFn: fetchDeployments,
         staleTime: 5000,
         refetchInterval: AUTO_REFRESH_MS,
@@ -302,7 +302,7 @@ export function usePullRequestDeployments() {
 /** Provides production checkout. */
 export function useProductionCheckout() {
     return useQuery({
-        queryKey: pullRequestKeys.productionCheckout(),
+        queryKey: deliveryKeys.productionCheckout(),
         queryFn: fetchProductionCheckout,
         staleTime: 5000,
         refetchInterval: AUTO_REFRESH_MS,
@@ -312,7 +312,7 @@ export function useProductionCheckout() {
 /** Provides active and previous managed release status. */
 export function useDashboardReleaseStatus() {
     return useQuery({
-        queryKey: pullRequestKeys.releaseStatus(),
+        queryKey: deliveryKeys.releaseStatus(),
         queryFn: fetchDashboardReleaseStatus,
         staleTime: 5000,
         refetchInterval: AUTO_REFRESH_MS,
@@ -322,7 +322,7 @@ export function useDashboardReleaseStatus() {
 /** Provides the managed single-slot PR preview status. */
 export function usePullRequestPreview() {
     return useQuery({
-        queryKey: pullRequestKeys.preview(),
+        queryKey: deliveryKeys.preview(),
         queryFn: fetchPullRequestPreview,
         staleTime: 2000,
         refetchInterval: 5000,
@@ -337,15 +337,15 @@ export function useApprovePullRequest() {
         mutationFn: ({ number, willDeploy }: { number: number; willDeploy: boolean }) =>
             approvePullRequest(number, willDeploy),
         onSuccess: () => {
-            void queryClient.invalidateQueries({ queryKey: pullRequestKeys.list() });
+            void queryClient.invalidateQueries({ queryKey: deliveryKeys.list() });
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.deployments(),
+                queryKey: deliveryKeys.deployments(),
             });
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.productionCheckout(),
+                queryKey: deliveryKeys.productionCheckout(),
             });
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.releaseStatus(),
+                queryKey: deliveryKeys.releaseStatus(),
             });
         },
     });
@@ -361,7 +361,7 @@ export function useApprovePullRequestReview() {
             const updatedPullRequest = response.pullRequest;
             if (updatedPullRequest) {
                 queryClient.setQueryData<PullRequestSummary[]>(
-                    pullRequestKeys.list(),
+                    deliveryKeys.list(),
                     (current = []) =>
                         current.map((pullRequest) =>
                             pullRequest.number === updatedPullRequest.number
@@ -370,7 +370,7 @@ export function useApprovePullRequestReview() {
                         )
                 );
             }
-            void queryClient.invalidateQueries({ queryKey: pullRequestKeys.list() });
+            void queryClient.invalidateQueries({ queryKey: deliveryKeys.list() });
         },
     });
 }
@@ -385,7 +385,7 @@ export function useUpdatePullRequestBranch() {
             const updatedPullRequest = response.pullRequest;
             if (updatedPullRequest) {
                 queryClient.setQueryData<PullRequestSummary[]>(
-                    pullRequestKeys.list(),
+                    deliveryKeys.list(),
                     (current = []) =>
                         current.map((pullRequest) =>
                             pullRequest.number === updatedPullRequest.number
@@ -394,7 +394,7 @@ export function useUpdatePullRequestBranch() {
                         )
                 );
             }
-            void queryClient.invalidateQueries({ queryKey: pullRequestKeys.list() });
+            void queryClient.invalidateQueries({ queryKey: deliveryKeys.list() });
         },
     });
 }
@@ -407,7 +407,7 @@ export function useRejectPullRequest() {
         mutationFn: ({ number, comment }: { number: number; comment?: string }) =>
             rejectPullRequest(number, comment),
         onSuccess: () => {
-            void queryClient.invalidateQueries({ queryKey: pullRequestKeys.list() });
+            void queryClient.invalidateQueries({ queryKey: deliveryKeys.list() });
         },
     });
 }
@@ -420,13 +420,13 @@ export function useDeployDashboard() {
         mutationFn: deployDashboard,
         onSuccess: () => {
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.deployments(),
+                queryKey: deliveryKeys.deployments(),
             });
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.productionCheckout(),
+                queryKey: deliveryKeys.productionCheckout(),
             });
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.releaseStatus(),
+                queryKey: deliveryKeys.releaseStatus(),
             });
         },
     });
@@ -441,13 +441,13 @@ export function useRollbackDashboard() {
             rollbackDashboard(targetCommit),
         onSuccess: () => {
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.deployments(),
+                queryKey: deliveryKeys.deployments(),
             });
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.productionCheckout(),
+                queryKey: deliveryKeys.productionCheckout(),
             });
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.releaseStatus(),
+                queryKey: deliveryKeys.releaseStatus(),
             });
         },
     });
@@ -460,9 +460,9 @@ export function useStartPullRequestPreview() {
     return useMutation({
         mutationFn: ({ number }: { number: number }) => startPullRequestPreview(number),
         onSuccess: (preview) => {
-            queryClient.setQueryData(pullRequestKeys.preview(), preview);
+            queryClient.setQueryData(deliveryKeys.preview(), preview);
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.preview(),
+                queryKey: deliveryKeys.preview(),
             });
         },
     });
@@ -475,9 +475,9 @@ export function useStopPullRequestPreview() {
     return useMutation({
         mutationFn: ({ number }: { number: number }) => stopPullRequestPreview(number),
         onSuccess: (preview) => {
-            queryClient.setQueryData(pullRequestKeys.preview(), preview);
+            queryClient.setQueryData(deliveryKeys.preview(), preview);
             void queryClient.invalidateQueries({
-                queryKey: pullRequestKeys.preview(),
+                queryKey: deliveryKeys.preview(),
             });
         },
     });