import { scopeProjectRef, scopedThreadKey, scopeThreadRef, } from "@t3tools/client-runtime/environment"; import { pullRequestDetailToVcsStatus } from "@t3tools/client-runtime/state/pull-requests"; import type { EnvironmentId, ThreadLinkedPullRequest, VcsStatusResult } from "@t3tools/contracts"; import { Atom } from "effect/unstable/reactivity"; import { CloudIcon, FolderGit2Icon, GitPullRequestIcon, TerminalIcon } from "lucide-react"; import { useMemo } from "react"; import { appAtomRegistry } from "../rpc/atomRegistry"; import { useEnvironment, usePrimaryEnvironmentId } from "../state/environments"; import { useProject } from "../state/entities"; import { useEnvironmentQuery } from "../state/query"; import { linkedPullRequestDetailAtom } from "../state/pullRequests"; import { useThreadRunningTerminalIds } from "../state/terminalSessions"; import { vcsEnvironment } from "../state/vcs"; import { useUiStateStore } from "../uiStateStore"; import { resolveChangeRequestPresentation } from "../sourceControlPresentation"; import { resolveThreadStatusPill, type ThreadStatusPill } from "./Sidebar.logic"; import type { SidebarThreadSummary } from "../types"; import { formatWorktreePathForDisplay } from "../worktreeCleanup"; import { Tooltip, TooltipPopup, TooltipTrigger } from "./ui/tooltip"; export interface PrStatusIndicator { label: string; colorClass: string; tooltip: string; tooltipLead: string; tooltipTitle: string; url: string; } export interface TerminalStatusIndicator { label: "Terminal process running"; colorClass: string; pulse: boolean; } export type ThreadPr = VcsStatusResult["pr"]; export interface LinkedThreadPullRequestStatus { readonly pr: NonNullable; readonly sourceControlProvider: NonNullable; } export function useLinkedThreadPullRequest( environmentId: EnvironmentId | null, linkedPullRequest: ThreadLinkedPullRequest | null | undefined, ): LinkedThreadPullRequestStatus | null { const detail = useEnvironmentQuery( environmentId === null || linkedPullRequest == null ? null : linkedPullRequestDetailAtom({ environmentId, input: { projectId: linkedPullRequest.projectId, repository: linkedPullRequest.repository, number: linkedPullRequest.number, }, }), ).data; return useMemo( () => detail === null ? null : { pr: pullRequestDetailToVcsStatus(detail), sourceControlProvider: { kind: detail.provider, name: detail.provider, baseUrl: "", }, }, [detail], ); } export function settledPrHoverColorClass(state: NonNullable["state"]): string { switch (state) { case "open": return "group-hover/v2-row:text-emerald-600 dark:group-hover/v2-row:text-emerald-300/90"; case "merged": return "group-hover/v2-row:text-violet-600 dark:group-hover/v2-row:text-violet-300/90"; case "closed": return "group-hover/v2-row:text-red-600 dark:group-hover/v2-row:text-red-300/90"; } } export function prStatusIndicator( pr: ThreadPr, provider: VcsStatusResult["sourceControlProvider"] | null | undefined, ): PrStatusIndicator | null { function formatPrState(state: NonNullable["state"]): string { return state.charAt(0).toUpperCase() + state.slice(1); } function formatPrStatusLead(pr: NonNullable, changeRequestShortName: string): string { return `${changeRequestShortName} #${pr.number} - ${formatPrState(pr.state)}`; } if (!pr) return null; const presentation = resolveChangeRequestPresentation(provider); const tooltipLead = formatPrStatusLead(pr, presentation.shortName); const tooltip = `${tooltipLead}: ${pr.title}`; if (pr.state === "open") { return { label: `${presentation.shortName} open`, colorClass: "text-emerald-600 dark:text-emerald-300/90", tooltip, tooltipLead, tooltipTitle: pr.title, url: pr.url, }; } if (pr.state === "closed") { return { label: `${presentation.shortName} closed`, colorClass: "text-red-600 dark:text-red-300/90", tooltip, tooltipLead, tooltipTitle: pr.title, url: pr.url, }; } if (pr.state === "merged") { return { label: `${presentation.shortName} merged`, colorClass: "text-violet-600 dark:text-violet-300/90", tooltip, tooltipLead, tooltipTitle: pr.title, url: pr.url, }; } return null; } export function ChangeRequestStatusIcon({ className }: { className?: string }) { return ; } export function PrStatusTooltipContent({ status }: { status: PrStatusIndicator }) { return ( {status.tooltipLead} ); } export function resolveThreadPr(input: { threadBranch: string | null; gitStatus: VcsStatusResult | null; }): ThreadPr | null { const { threadBranch, gitStatus } = input; if (gitStatus === null) { return null; } if (threadBranch === null || gitStatus.refName !== threadBranch) { return null; } return gitStatus.pr ?? null; } /** * Parent-held PR snapshot for Sidebar V2. Rows remount when settlement * partitions move them, so terminal PR metadata must live above the row. */ export interface ThreadChangeRequestSnapshot { readonly branch: string; readonly pr: NonNullable; readonly sourceControlProvider: VcsStatusResult["sourceControlProvider"] | undefined; readonly linkedPullRequest?: ThreadLinkedPullRequest; } export const threadChangeRequestSnapshotsAtom = Atom.make< ReadonlyMap >(new Map()).pipe(Atom.keepAlive, Atom.withLabel("sidebar:thread-change-request-snapshots")); function isTerminalChangeRequestState( state: NonNullable["state"], ): state is "merged" | "closed" { return state === "merged" || state === "closed"; } function sourceControlProvidersEqual( left: VcsStatusResult["sourceControlProvider"] | undefined, right: VcsStatusResult["sourceControlProvider"] | undefined, ): boolean { if (left === right) return true; if (left == null || right == null) return left == null && right == null; return left.kind === right.kind && left.name === right.name && left.baseUrl === right.baseUrl; } function linkedPullRequestsEqual( left: ThreadLinkedPullRequest | null | undefined, right: ThreadLinkedPullRequest | null | undefined, ): boolean { if (left == null || right == null) return left == null && right == null; return ( left.projectId === right.projectId && left.repository === right.repository && left.number === right.number && left.url === right.url ); } export function threadChangeRequestSnapshotsEqual( left: ThreadChangeRequestSnapshot, right: ThreadChangeRequestSnapshot, ): boolean { return ( left.branch === right.branch && left.pr.number === right.pr.number && left.pr.title === right.pr.title && left.pr.url === right.pr.url && left.pr.baseRef === right.pr.baseRef && left.pr.headRef === right.pr.headRef && left.pr.state === right.pr.state && (left.pr.updatedAt ?? null) === (right.pr.updatedAt ?? null) && sourceControlProvidersEqual(left.sourceControlProvider, right.sourceControlProvider) && linkedPullRequestsEqual(left.linkedPullRequest, right.linkedPullRequest) ); } export function setThreadChangeRequestSnapshot( threadKey: string, snapshot: ThreadChangeRequestSnapshot | null, ): void { appAtomRegistry.modify(threadChangeRequestSnapshotsAtom, (current) => { const existing = current.get(threadKey); if (snapshot === null) { if (existing === undefined) return [false, current]; const next = new Map(current); next.delete(threadKey); return [true, next]; } if (existing !== undefined && threadChangeRequestSnapshotsEqual(existing, snapshot)) { return [false, current]; } const next = new Map(current); next.set(threadKey, snapshot); return [true, next]; }); } /** * Authoritative snapshot update from live VCS status. * - `undefined`: missing status, or a local checkout retaining a terminal PR — leave the map alone * - `null`: no PR (without a retained terminal snapshot), a cleared branch, or a mismatch without a terminal PR — clear * - snapshot: matching branch reports a PR — store/replace */ export function nextThreadChangeRequestSnapshot(input: { threadBranch: string | null; gitStatus: VcsStatusResult | null; snapshot: ThreadChangeRequestSnapshot | null | undefined; retainTerminalOnBranchMismatch: boolean; linkedPullRequest?: ThreadLinkedPullRequest | null | undefined; linkedPullRequestStatus?: LinkedThreadPullRequestStatus | null | undefined; }): ThreadChangeRequestSnapshot | null | undefined { const { threadBranch, gitStatus, snapshot, retainTerminalOnBranchMismatch, linkedPullRequest, linkedPullRequestStatus, } = input; if (linkedPullRequest != null) { if (linkedPullRequestStatus === null || linkedPullRequestStatus === undefined) { return linkedPullRequestsEqual(snapshot?.linkedPullRequest, linkedPullRequest) ? undefined : null; } return { branch: threadBranch ?? linkedPullRequestStatus.pr.headRef, pr: linkedPullRequestStatus.pr, sourceControlProvider: linkedPullRequestStatus.sourceControlProvider, linkedPullRequest, }; } if (gitStatus === null) { return snapshot?.linkedPullRequest === undefined ? undefined : null; } if (threadBranch === null) { return null; } if (gitStatus.refName !== threadBranch) { return retainTerminalOnBranchMismatch && snapshot != null && snapshot.linkedPullRequest === undefined && isTerminalChangeRequestState(snapshot.pr.state) ? undefined : null; } if (gitStatus.pr == null) { if ( retainTerminalOnBranchMismatch && snapshot != null && snapshot.linkedPullRequest === undefined && isTerminalChangeRequestState(snapshot.pr.state) ) { return undefined; } return null; } return { branch: threadBranch, pr: gitStatus.pr, sourceControlProvider: gitStatus.sourceControlProvider, }; } /** * Live PR when the checkout matches the thread branch; otherwise, for local * checkouts only, a cached merged/closed PR for the thread. Local thread * metadata follows the shared checkout, so the cached branch intentionally * survives that metadata changing to the newly checked-out branch. Open PRs * are never retained — their state can still change. */ export function resolveDisplayedThreadPr(input: { threadBranch: string | null; gitStatus: VcsStatusResult | null; snapshot: ThreadChangeRequestSnapshot | null | undefined; retainTerminalOnBranchMismatch: boolean; linkedPullRequest?: ThreadLinkedPullRequest | null | undefined; linkedPullRequestStatus?: LinkedThreadPullRequestStatus | null | undefined; }): ThreadPr | null { const { threadBranch, gitStatus, snapshot, retainTerminalOnBranchMismatch, linkedPullRequest, linkedPullRequestStatus, } = input; if (linkedPullRequest != null) { return ( linkedPullRequestStatus?.pr ?? (linkedPullRequestsEqual(snapshot?.linkedPullRequest, linkedPullRequest) ? (snapshot?.pr ?? null) : null) ); } if ( threadBranch !== null && gitStatus !== null && gitStatus.refName === threadBranch && gitStatus.pr != null ) { return gitStatus.pr; } if ( threadBranch !== null && retainTerminalOnBranchMismatch && snapshot != null && snapshot.linkedPullRequest === undefined && isTerminalChangeRequestState(snapshot.pr.state) ) { return snapshot.pr; } return null; } export function resolveDisplayedThreadPrProvider(input: { threadBranch: string | null; gitStatus: VcsStatusResult | null; snapshot: ThreadChangeRequestSnapshot | null | undefined; retainTerminalOnBranchMismatch: boolean; linkedPullRequest?: ThreadLinkedPullRequest | null | undefined; linkedPullRequestStatus?: LinkedThreadPullRequestStatus | null | undefined; }): VcsStatusResult["sourceControlProvider"] | undefined { const { threadBranch, gitStatus, snapshot, retainTerminalOnBranchMismatch, linkedPullRequest, linkedPullRequestStatus, } = input; if (linkedPullRequest != null) { return ( linkedPullRequestStatus?.sourceControlProvider ?? (linkedPullRequestsEqual(snapshot?.linkedPullRequest, linkedPullRequest) ? snapshot?.sourceControlProvider : undefined) ); } if ( threadBranch !== null && gitStatus !== null && gitStatus.refName === threadBranch && gitStatus.pr != null ) { return gitStatus.sourceControlProvider; } if ( threadBranch !== null && retainTerminalOnBranchMismatch && snapshot != null && snapshot.linkedPullRequest === undefined && isTerminalChangeRequestState(snapshot.pr.state) ) { return snapshot.sourceControlProvider; } return undefined; } export function terminalStatusFromRunningIds( runningTerminalIds: ReadonlyArray, ): TerminalStatusIndicator | null { if (runningTerminalIds.length === 0) { return null; } return { label: "Terminal process running", colorClass: "text-teal-600 dark:text-teal-300/90", pulse: true, }; } export function ThreadWorktreeIndicator({ thread, }: { thread: Pick; }) { const worktreePath = thread.worktreePath?.trim(); if (!worktreePath) { return null; } const displayPath = formatWorktreePathForDisplay(worktreePath); const tooltip = thread.branch ? `Worktree: ${displayPath} (${thread.branch})` : `Worktree: ${displayPath}`; return ( } > {tooltip} ); } export function ThreadStatusLabel({ status, compact = false, }: { status: ThreadStatusPill; compact?: boolean; }) { if (compact) { return ( } > {status.label} ); } return ( } > {status.label} {status.label} ); } /** * Non-interactive leading status icons for a thread row in compact contexts * like the command palette. Shows the change request state icon (if present) and the * thread status dot, matching the sidebar's leading indicators. */ export function ThreadRowLeadingStatus({ thread }: { thread: SidebarThreadSummary }) { const threadRef = scopeThreadRef(thread.environmentId, thread.id); const lastVisitedAt = useUiStateStore( (state) => state.threadLastVisitedAtById[scopedThreadKey(threadRef)], ); const threadProject = useProject( useMemo( () => scopeProjectRef(thread.environmentId, thread.projectId), [thread.environmentId, thread.projectId], ), ); const threadProjectCwd = threadProject?.workspaceRoot ?? null; const gitCwd = thread.worktreePath ?? threadProjectCwd; const linkedPullRequest = useLinkedThreadPullRequest( thread.environmentId, thread.linkedPullRequest, ); const gitStatus = useEnvironmentQuery( thread.linkedPullRequest == null && (thread.branch != null || thread.worktreePath !== null) && gitCwd !== null ? vcsEnvironment.status({ environmentId: thread.environmentId, input: { cwd: gitCwd }, }) : null, ); const pr = thread.linkedPullRequest == null ? resolveThreadPr({ threadBranch: thread.branch, gitStatus: gitStatus.data }) : (linkedPullRequest?.pr ?? null); const prStatus = prStatusIndicator( pr, linkedPullRequest?.sourceControlProvider ?? gitStatus.data?.sourceControlProvider, ); const threadStatus = resolveThreadStatusPill({ thread: { ...thread, lastVisitedAt, }, }); if (!prStatus && !threadStatus) { return null; } return ( {prStatus ? ( } > ) : null} {threadStatus ? : null} ); } /** * Non-interactive trailing status icons for a thread row in compact contexts * like the command palette. Shows a terminal-running indicator and a remote * environment indicator, matching the sidebar's trailing indicators. */ export function ThreadRowTrailingStatus({ thread }: { thread: SidebarThreadSummary }) { const runningTerminalIds = useThreadRunningTerminalIds({ environmentId: thread.environmentId, threadId: thread.id, }); const environment = useEnvironment(thread.environmentId); const primaryEnvironmentId = usePrimaryEnvironmentId(); const isRemoteThread = primaryEnvironmentId !== null && thread.environmentId !== primaryEnvironmentId; const remoteEnvLabel = environment?.label ?? null; const threadEnvironmentLabel = isRemoteThread ? (remoteEnvLabel ?? "Remote") : null; const terminalStatus = terminalStatusFromRunningIds(runningTerminalIds); if (!terminalStatus && !isRemoteThread) { return null; } return ( {terminalStatus ? ( } > {terminalStatus.label} ) : null} {isRemoteThread ? ( } > {threadEnvironmentLabel} ) : null} ); }