Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import type { Repo } from '../repo-types'
import type { ProjectOrderBy } from '../ui-chrome-types'
import type { WorkspaceStatusDefinition, Worktree } from '../worktree/types'
import { getWorktreeHostIdentity } from '../worktree/host-qualified-identity'
import { getWorkspaceStatus, getWorkspaceStatusGroupKey } from '../workspace-statuses'
import {
compareFolderWorkspacesForDisplay,
getFolderWorkspaceLaneKey,
type RenderableFolderWorkspace
} from './folder-workspace-lanes'
import { PR_GROUP_ORDER, getPRLaneKey } from './group-keys'
import type { OrderedGroupEntry, WorktreeGroupEntry } from './worktree-group-entry'
import { buildProjectSections, type ProjectGroupingIndex } from '../project-section-grouping'
import { orderProjectSections } from '../project-section-order'
import type {
ImportedWorktreesCardCandidate,
NewExternalWorktreesInboxCandidate,
PendingCreationRef,
SidebarPRGroupReader,
WorktreeGroupBy
} from './row-types'
export function buildOrderedGroups(args: {
groupBy: WorktreeGroupBy
naturalWorktrees: readonly Worktree[]
repoMap: Map<string, Repo>
prGroupOf: SidebarPRGroupReader
workspaceStatuses: readonly WorkspaceStatusDefinition[]
projectIndex: ProjectGroupingIndex | null
displayRootByIdentity?: ReadonlyMap<string, Worktree>
placeholderRepoIds: ReadonlySet<string>
importedWorktreesByRepo: ReadonlyMap<string, ImportedWorktreesCardCandidate>
newExternalWorktreesInboxByRepo: ReadonlyMap<string, NewExternalWorktreesInboxCandidate>
pendingByRepo: ReadonlyMap<string, PendingCreationRef[]>
repoOrder: Map<string, number> | undefined
projectOrderBy: ProjectOrderBy
folderWorkspaces?: readonly RenderableFolderWorkspace[]
}): OrderedGroupEntry[] {
const {
groupBy,
naturalWorktrees,
repoMap,
prGroupOf,
workspaceStatuses,
projectIndex,
displayRootByIdentity,
placeholderRepoIds,
importedWorktreesByRepo,
newExternalWorktreesInboxByRepo,
pendingByRepo,
repoOrder,
projectOrderBy,
folderWorkspaces = []
} = args
if (groupBy === 'repo') {
// Shared with paired-phone Project sections.
return buildProjectSections({
items: naturalWorktrees,
repoIdOf: (worktree) => worktree.repoId,
displayRepoIdOf: (worktree) =>
(displayRootByIdentity?.get(getWorktreeHostIdentity(worktree)) ?? worktree).repoId,
repoMap,
projectIndex,
placeholderRepoIds,
noticeRepos: [
...[...importedWorktreesByRepo].map(
([repoId, candidate]) => [repoId, candidate.repo] as const
),
...[...newExternalWorktreesInboxByRepo].map(
([repoId, candidate]) => [repoId, candidate.repo] as const
)
],
pendingRepoIds: pendingByRepo.keys(),
repoOrder,
projectOrderBy
})
}
// Section emitters/clients supply status and PR labels.
const grouped = new Map<string, WorktreeGroupEntry>()
for (const w of naturalWorktrees) {
const key =
groupBy === 'workspace-status'
? getWorkspaceStatusGroupKey(getWorkspaceStatus(w, workspaceStatuses))
: getPRLaneKey(prGroupOf(w))
if (!grouped.has(key)) {
grouped.set(key, { label: '', items: [], repo: undefined, repoIds: new Set() })
}
const group = grouped.get(key)!
group.items.push(w)
group.repoIds.add(w.repoId)
}
// Folder workspaces bypass the worktree loop; create their lanes even when they are the only occupants (#15362).
for (const pair of folderWorkspaces) {
const key = getFolderWorkspaceLaneKey(pair, groupBy, workspaceStatuses)
if (!grouped.has(key)) {
grouped.set(key, {
label: '',
items: [],
repo: undefined,
repoIds: new Set()
})
}
const group = grouped.get(key)!
group.folderWorkspaces ??= []
group.folderWorkspaces.push(pair)
}
for (const group of grouped.values()) {
group.folderWorkspaces?.sort((left, right) =>
compareFolderWorkspacesForDisplay(left.folderWorkspace, right.folderWorkspace)
)
}
const orderedGroups: OrderedGroupEntry[] = []
if (groupBy === 'pr-status') {
for (const prGroup of PR_GROUP_ORDER) {
const key = `pr:${prGroup}`
const group = grouped.get(key)
if (group) {
orderedGroups.push([key, group])
}
}
} else if (groupBy === 'workspace-status') {
// Status grouping is opt-in; omit empty sidebar lanes while the board keeps all drag targets.
for (const status of workspaceStatuses) {
const key = getWorkspaceStatusGroupKey(status.id)
const group = grouped.get(key)
if (group) {
orderedGroups.push([key, group])
}
}
} else {
const entries = orderProjectSections(grouped, repoMap, repoOrder, projectOrderBy)
// Imported repo counts can exceed V8’s argument limit for push(...entries).
for (const entry of entries) {
orderedGroups.push(entry)
}
}
return orderedGroups
}