feat(sidebar): show worktrees under their repository

Add an optional sidebar mode that shows linked worktrees nested under their repository in the main repository list so repository switching can stay in the main sidebar instead of requiring the worktree dropdown.

Changes:
- add a secondary Appearance setting to show worktrees in the repository sidebar when worktree support is enabled
- group linked worktrees under their main repository in the sidebar
- synthesize child rows for linked worktrees discovered from `git worktree list` even when those worktrees were never added as repositories
- support linked-only setups by synthesizing sibling worktree rows even when the stored entry is itself a linked worktree instead of the main worktree
- use worktree folder names for child row labels while preserving existing alias styling for saved repository entries
- use the same displayed-title logic for sorting and disambiguation so nested rows sort and label consistently with what the user sees
- preload main-repository worktree state for the sidebar so nested rows are available on first render instead of only after opening the worktree dropdown or clicking around
- show a lightweight loading hint while linked worktrees are still being discovered for a repository
- refresh parent sidebar rows when linked worktrees are selected so nested rows stay in sync with the active repository view
- use preloaded parent worktree metadata so stored linked worktree rows show their branch pill on first render instead of waiting for a later refresh
- surface nested worktree rows from both saved worktree repositories and synthetic virtual rows without duplicating entries already stored in Desktop
- avoid duplicate `Pull all` work for linked worktrees while still including orphan linked worktrees when the main repo is absent from the stored repository list
- route virtual worktree open failures through the normal app error path instead of silently failing
- persist sidebar worktree metadata in repository state and extract the sidebar-specific state shaping into a dedicated helper to keep `app-store.ts` smaller
- throttle sidebar worktree refreshes during repository indicator updates and cap preload concurrency to reduce repeated `git worktree list` churn
- prune sidebar worktree refresh timestamps when repository lists change so stale cache entries do not accumulate
- harden the shared CI setup action by retrying the `yarn` install step to absorb transient Electron download failures in Actions
- tighten TypeScript null/undefined handling in repository and sidebar list code so production webpack builds pass across the full CI matrix
- add and extend unit coverage for grouped rows, synthetic rows, loading state, linked-only setups, and stored linked-worktree branch labels

Behavioral effect:
Users can opt into seeing and switching linked worktrees directly from the main repository sidebar, including unstored Git worktrees, with branch labels and parent-child grouping available on initial render.

Testing:
- yarn test:unit app/test/unit/repositories-list-grouping-test.ts
- yarn lint
- yarn compile:dev
- yarn compile:prod

Author: ignatremizov

.github/actions/setup-ci-environment/action.yml

@@ -33,7 +33,24 @@ runs:
 
     - name: Install and build dependencies
       shell: bash
-      run: yarn
+      run: |
+        max_attempts=3
+        attempt=1
+
+        while [ "$attempt" -le "$max_attempts" ]; do
+          if yarn; then
+            exit 0
+          fi
+
+          if [ "$attempt" -eq "$max_attempts" ]; then
+            exit 1
+          fi
+
+          sleep_seconds=$((attempt * 10))
+          echo "yarn install failed on attempt $attempt/$max_attempts, retrying in ${sleep_seconds}s..."
+          sleep "$sleep_seconds"
+          attempt=$((attempt + 1))
+        done
       env:
         npm_config_arch: ${{ inputs.arch }}
         TARGET_ARCH: ${{ inputs.arch }}

app/src/lib/app-state.ts

@@ -321,6 +321,9 @@ export interface IAppState {
   /** Whether or not the worktrees dropdown should be shown in the toolbar */
   readonly showWorktrees: boolean
 
+  /** Whether linked worktrees should be shown under their repository in the sidebar */
+  readonly showWorktreesInSidebar: boolean
+
   /** Whether or not the Compare tab should be shown in the repository view */
   readonly showCompareTab: boolean
 

app/src/lib/git/worktree.ts

@@ -5,6 +5,15 @@ import type { WorktreeEntry, WorktreeType } from '../../models/worktree'
 import { git } from './core'
 import { normalizePath } from '../helpers/path'
 
+function getDotGitPath(repositoryPath: string): string {
+  return Path.join(repositoryPath, '.git')
+}
+
+export interface IWorktreePathInfo {
+  readonly isLinkedWorktree: boolean
+  readonly mainWorktreePath: string | null
+}
+
 export function parseWorktreePorcelainOutput(
   stdout: string
 ): ReadonlyArray<WorktreeEntry> {
@@ -136,16 +145,61 @@ export async function getMainWorktreePath(
 }
 
 /**
- * Synchronously checks if a repository path is a linked worktree by examining
- * whether `.git` is a file (linked worktree) or directory (main worktree).
+ * Synchronously checks if a repository path is a linked worktree by inspecting
+ * the `.git` entry and validating linked-worktree metadata when it points at a
+ * gitdir file rather than a main worktree directory.
  */
 export function isLinkedWorktreeSync(repositoryPath: string): boolean {
+  const worktreeInfo = getWorktreePathInfoSync(repositoryPath)
+  return worktreeInfo?.isLinkedWorktree ?? false
+}
+
+export function getWorktreePathInfoSync(
+  repositoryPath: string
+): IWorktreePathInfo | null {
   try {
-    const dotGit = Path.join(repositoryPath, '.git')
+    const dotGit = getDotGitPath(repositoryPath)
     // eslint-disable-next-line no-sync
     const stats = Fs.statSync(dotGit)
-    return stats.isFile()
+
+    if (stats.isDirectory()) {
+      return { isLinkedWorktree: false, mainWorktreePath: repositoryPath }
+    }
+
+    if (!stats.isFile()) {
+      return null
+    }
+
+    // eslint-disable-next-line no-sync
+    const contents = Fs.readFileSync(dotGit, 'utf8').trim()
+    if (!contents.startsWith('gitdir: ')) {
+      return null
+    }
+
+    const gitDirPath = Path.resolve(
+      repositoryPath,
+      contents.substring('gitdir: '.length)
+    )
+
+    // eslint-disable-next-line no-sync
+    const commondir = Fs.readFileSync(
+      Path.join(gitDirPath, 'commondir'),
+      'utf8'
+    ).trim()
+    if (commondir.length === 0) {
+      return null
+    }
+
+    const commonGitDir = Path.resolve(gitDirPath, commondir)
+    return {
+      isLinkedWorktree: true,
+      mainWorktreePath: Path.dirname(commonGitDir),
+    }
   } catch {
-    return false
+    return null
   }
 }
+
+export function getMainWorktreePathSync(repositoryPath: string): string | null {
+  return getWorktreePathInfoSync(repositoryPath)?.mainWorktreePath ?? null
+}