# microsoft/vscode-pull-request-github architecture

> Architecture diagram of the GitHub repository microsoft/vscode-pull-request-github, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/vscode-pull-request-github
- Repository: https://github.com/microsoft/vscode-pull-request-github

## Overview

This is the GitHub Pull Requests and Issues extension for VS Code. A user connects an account and opens a repository; the extension discovers GitHub remotes, presents pull requests and issues, and supports browsing, checkout, review comments, and issue work. Review management and issue features form distinct branches. The graph includes central repository/model modules and shared contracts. Edges are limited to relationships visible in excerpts or the README; unsampled capability links are documented but not asserted as source-level calls.

Main entry points: [`src/github/repositoriesManager.ts`](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/repositoriesManager.ts) (Repository coordinator), [`src/github/pullRequestModel.ts`](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/pullRequestModel.ts) (Pull request model), [`src/github/folderRepositoryManager.ts`](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/folderRepositoryManager.ts) (Folder repository manager), [`src/github/issueModel.ts`](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/issueModel.ts) (Issue model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["VS Code integration"]
  node_vscode["VS Code"]
  node_extension["Extension activation<br/>[extension.ts]"]
  node_views["Extension views<br/>[views.ts]"]
  node_webview["PR overview webview<br/>[app.tsx]"]
  node_contracts["Shared view contracts<br/>[views.ts]"]
  node_notifications["Notifications"]
end

subgraph group_repos["Repository discovery"]
  node_repoapi["Git API adapter<br/>[api1.ts]"]
  node_repoindex["Repository coordinator"]
  node_folder["Folder repository manager"]
  node_remote["Remote configuration<br/>[remote.ts]"]
end

subgraph group_github["GitHub domain"]
  node_githubrepo["GitHub repository"]
  node_graphql["GraphQL operations<br/>[graphql.ts]"]
  node_ghinterface["GitHub domain types<br/>[interface.ts]"]
  node_prmodel["Pull request model"]
  node_issuebase["Issue model<br/>[issueModel.ts]"]
end

subgraph group_review["Pull request review"]
  node_prviewmodel["Pull request overview"]
  node_reviewmgr["Review manager<br/>[reviewManager.ts]"]
  node_commentctrl["Review comment controller"]
end

subgraph group_issues["Issue workflows"]
  node_issueoverview["Issue overview<br/>[issueOverview.ts]"]
  node_issuestate["Issue state manager<br/>[stateManager.ts]"]
  node_issuefeatures["Issue editor features"]
end

node_user(("VS Code user"))
node_github["GitHub"]

node_user -->|"uses"| node_vscode
node_vscode -.->|"activates"| node_extension
node_extension -.->|"initializes"| node_repoindex
node_user -->|"browses"| node_views
node_views -.->|"renders"| node_webview
node_webview -->|"uses types"| node_contracts
node_repoapi -->|"exposes repositories"| node_repoindex
node_repoindex -->|"manages folders"| node_folder
node_repoindex -->|"resolves remotes"| node_remote
node_folder -->|"uses repositories"| node_githubrepo
node_folder -->|"fetches PRs"| node_prmodel
node_githubrepo -->|"executes queries"| node_graphql
node_githubrepo -->|"creates models"| node_prmodel
node_prmodel -->|"extends model"| node_issuebase
node_prmodel -->|"queries reviews"| node_graphql
node_prmodel -->|"uses types"| node_ghinterface
node_issuebase -->|"mutates issues"| node_graphql
node_repoindex -->|"tracks issues"| node_issuebase
node_user -->|"reviews PRs"| node_reviewmgr
node_reviewmgr -->|"uses controller"| node_commentctrl
node_user -->|"starts issue work"| node_issuestate
node_issuestate -->|"uses issue models"| node_issuebase
node_user -->|"uses editor features"| node_issuefeatures
node_repoindex -->|"provides PR context"| node_notifications
node_github -.->|"supplies remote data"| node_repoindex
node_github -.->|"authenticates accounts"| node_folder

click node_extension "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/extension.ts"
click node_views "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/views.ts"
click node_webview "https://github.com/microsoft/vscode-pull-request-github/blob/main/webviews/activityBarView/app.tsx"
click node_contracts "https://github.com/microsoft/vscode-pull-request-github/blob/main/common/views.ts"
click node_repoapi "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/api/api1.ts"
click node_repoindex "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/repositoriesManager.ts"
click node_folder "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/folderRepositoryManager.ts"
click node_remote "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/common/remote.ts"
click node_githubrepo "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/githubRepository.ts"
click node_graphql "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/graphql.ts"
click node_ghinterface "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/interface.ts"
click node_prmodel "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/pullRequestModel.ts"
click node_issuebase "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/issueModel.ts"
click node_prviewmodel "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/pullRequestOverview.ts"
click node_reviewmgr "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/view/reviewManager.ts"
click node_commentctrl "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/view/reviewCommentController.ts"
click node_issueoverview "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/issueOverview.ts"
click node_issuestate "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/issues/stateManager.ts"
click node_issuefeatures "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/issues/issueFeatureRegistrar.ts"
click node_notifications "https://github.com/microsoft/vscode-pull-request-github/blob/main/src/notifications/notificationsManager.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_vscode,node_extension,node_views,node_webview,node_contracts,node_notifications,node_user toneBlue
class node_repoapi,node_repoindex,node_folder,node_remote toneAmber
class node_githubrepo,node_graphql,node_ghinterface,node_prmodel,node_issuebase toneMint
class node_prviewmodel,node_reviewmgr,node_commentctrl toneRose
class node_issueoverview,node_issuestate,node_issuefeatures,node_github toneIndigo
```

## Components

### VS Code integration

- **VS Code**
- [Extension activation](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/extension.ts): `src/extension.ts`
- [Extension views](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/views.ts): `src/github/views.ts`
- [PR overview webview](https://github.com/microsoft/vscode-pull-request-github/blob/main/webviews/activityBarView/app.tsx): `webviews/activityBarView/app.tsx`
- [Shared view contracts](https://github.com/microsoft/vscode-pull-request-github/blob/main/common/views.ts): `common/views.ts`
- [Notifications](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/notifications/notificationsManager.ts): `src/notifications/notificationsManager.ts`

### Repository discovery

- [Git API adapter](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/api/api1.ts): `src/api/api1.ts`
- [Repository coordinator](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/repositoriesManager.ts): `src/github/repositoriesManager.ts`
- [Folder repository manager](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/folderRepositoryManager.ts): `src/github/folderRepositoryManager.ts`
- [Remote configuration](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/common/remote.ts): `src/common/remote.ts`

### GitHub domain

- [GitHub repository](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/githubRepository.ts): `src/github/githubRepository.ts`
- [GraphQL operations](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/graphql.ts): `src/github/graphql.ts`
- [GitHub domain types](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/interface.ts): `src/github/interface.ts`
- [Pull request model](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/pullRequestModel.ts): `src/github/pullRequestModel.ts`
- [Issue model](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/issueModel.ts): `src/github/issueModel.ts`

### Pull request review

- [Pull request overview](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/pullRequestOverview.ts): `src/github/pullRequestOverview.ts`
- [Review manager](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/view/reviewManager.ts): `src/view/reviewManager.ts`
- [Review comment controller](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/view/reviewCommentController.ts): `src/view/reviewCommentController.ts`

### Issue workflows

- [Issue overview](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/github/issueOverview.ts): `src/github/issueOverview.ts`
- [Issue state manager](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/issues/stateManager.ts): `src/issues/stateManager.ts`
- [Issue editor features](https://github.com/microsoft/vscode-pull-request-github/blob/main/src/issues/issueFeatureRegistrar.ts): `src/issues/issueFeatureRegistrar.ts`

### Other components

- **VS Code user**
- **GitHub**

## Connections

- VS Code user → VS Code: uses (evidence: `README.md`)
- VS Code → Extension activation: activates
- Extension activation → Repository coordinator: initializes
- VS Code user → Extension views: browses (evidence: `README.md`)
- Extension views → PR overview webview: renders (evidence: `webviews/activityBarView/app.tsx`)
- PR overview webview → Shared view contracts: uses types (evidence: `webviews/activityBarView/app.tsx`)
- Git API adapter → Repository coordinator: exposes repositories (evidence: `src/api/api1.ts`)
- Repository coordinator → Folder repository manager: manages folders (evidence: `src/github/repositoriesManager.ts`)
- Repository coordinator → Remote configuration: resolves remotes (evidence: `src/github/repositoriesManager.ts`)
- Folder repository manager → GitHub repository: uses repositories (evidence: `src/github/folderRepositoryManager.ts`)
- Folder repository manager → Pull request model: fetches PRs (evidence: `src/github/folderRepositoryManager.ts`)
- GitHub repository → GraphQL operations: executes queries (evidence: `src/github/githubRepository.ts`)
- GitHub repository → Pull request model: creates models (evidence: `src/github/githubRepository.ts`)
- Pull request model → Issue model: extends model (evidence: `src/github/pullRequestModel.ts`)
- Pull request model → GraphQL operations: queries reviews (evidence: `src/github/pullRequestModel.ts`)
- Pull request model → GitHub domain types: uses types (evidence: `src/github/pullRequestModel.ts`)
- Issue model → GraphQL operations: mutates issues (evidence: `src/github/issueModel.ts`)
- Repository coordinator → Issue model: tracks issues (evidence: `src/github/repositoriesManager.ts`)
- VS Code user → Review manager: reviews PRs (evidence: `README.md`)
- Review manager → Review comment controller: uses controller (evidence: `src/view/reviewManager.ts`)
- VS Code user → Issue state manager: starts issue work (evidence: `README.md`)
- Issue state manager → Issue model: uses issue models (evidence: `src/issues/stateManager.ts`)
- VS Code user → Issue editor features: uses editor features (evidence: `README.md`)
- Repository coordinator → Notifications: provides PR context (evidence: `src/notifications/notificationsManager.ts`)
- GitHub → Repository coordinator: supplies remote data
- GitHub → Folder repository manager: authenticates accounts
