[codex] Fix PR worktree checkout materialization

apps/desktop/src/renderer/stores/workspace-creates/useWorkspaceCreates.ts

@@ -1,4 +1,5 @@
 import type { WorkspaceState } from "@superset/panes";
+import { toast } from "@superset/ui/sonner";
 import { useCallback } from "react";
 import { resolveHostUrl } from "renderer/hooks/host-service/useHostTargetUrl";
 import { useRelayUrl } from "renderer/hooks/useRelayUrl";
@@ -139,6 +140,9 @@ export function useWorkspaceCreates(): UseWorkspaceCreatesApi {
 				if (result.alreadyExists && result.workspace.id !== workspaceId) {
 					useWorkspaceCreatesStore.getState().remove(workspaceId);
 				}
+				for (const warning of result.warnings ?? []) {
+					toast.warning(warning);
+				}
 				return {
 					ok: true,
 					workspaceId: result.workspace.id,

apps/docs/content/docs/cli/cli-reference.mdx

@@ -536,7 +536,7 @@ List workspaces accessible to the active organization. With neither
 		{ flag: "--project <projectId>", required: true, description: "Project ID." },
 		{ flag: "--name <name>", required: true, description: "Workspace name." },
 		{ flag: "--branch <branch>", description: "Workspace branch. Required unless `--pr` is set." },
-		{ flag: "--pr <number>", description: "Pull request number. Derives the branch via `gh pr checkout`." },
+		{ flag: "--pr <number>", description: "Pull request number. Checks out the verified PR head." },
 		{ flag: "--base-branch <branch>", description: "Branch to fork from when `--branch` does not exist. Defaults to the project default branch." },
 		{ flag: "--host <id>", description: "Target host machineId. Mutually exclusive with `--local`; one is required." },
 		{ flag: "--local", description: "Target this machine. Mutually exclusive with `--host`; one is required." },

packages/cli/src/commands/workspaces/create/command.ts

@@ -11,7 +11,7 @@ export default command({
 		project: string().required().desc("Project ID"),
 		name: string().required().desc("Workspace name"),
 		branch: string().desc("Git branch (required unless --pr is set)"),
-		pr: number().desc("PR number — derives branch via gh pr checkout"),
+		pr: number().desc("PR number — checks out the verified PR head"),
 		baseBranch: string().desc(
 			"Branch to fork from when `branch` does not exist (defaults to project default)",
 		),