How microsoft/vscode-bisect works
vscode-bisect is a command-line tool for testing released VS Code builds and narrowing down which build introduced an issue. Users select a runtime, quality, and build range; the tool retrieves candidate builds, launches them for manual good/bad feedback, and reports the narrowed result. It also supports individual-build and sanity testing, plus performance-oriented options. The graph follows documented behavior and sampled imports/calls; some wiring is supported only by the source index, so uncertain relationships are omitted.
Main entry points: builds.ts Build selection and metadata · index.ts CLI options · launcher.ts Build launcher · files.ts Build files and cache
Components 15
CLI and orchestration
- CLI options
src/index.ts - Bisect workflow
src/bisect.ts - Sanity workflow
src/sanity.ts - VS Code checkout
src/git.ts
Build retrieval
- Build selection and metadata
src/builds.ts - HTTP download
src/fetch.ts
Testing and execution
- Build launcher
src/launcher.ts - VS Code build
- Good/bad feedback
- Performance testing
Shared runtime support
- Build files and cache
src/files.ts - Runtime configuration
src/constants.ts - Local build storage
src/files.ts
Other components
- CLI user
- Build update service
Connections 24
- CLI user → CLI options: provides options
README.md - CLI options → Bisect workflow: starts bisect
src/index.ts - CLI options → Sanity workflow: starts sanity
src/index.ts - CLI options → Build selection and metadata: selects build
src/index.ts - CLI options → VS Code checkout: uses checkout
src/index.ts - Bisect workflow → Build selection and metadata: resolves range
src/bisect.ts - Bisect workflow → Build launcher: launches candidate
src/bisect.ts - Bisect workflow → Good/bad feedback: requests verdict
src/bisect.ts - Sanity workflow → Build launcher: tests build
src/sanity.ts - Sanity workflow → Good/bad feedback: requests status
src/sanity.ts - Build selection and metadata → Build update service: fetches metadata
- Build selection and metadata → HTTP download: downloads archive
src/builds.ts - Build selection and metadata → Build files and cache: checks and hashes
src/builds.ts - HTTP download → Build update service: requests archive
- Build selection and metadata → Local build storage: caches archives
src/builds.ts - Build launcher → Build selection and metadata: gets executable
src/launcher.ts - Build launcher → Build files and cache: checks executable
src/launcher.ts - Build launcher → VS Code build: starts process
src/launcher.ts - Build launcher → Performance testing: runs measurements
- Bisect workflow → Build files and cache: cleans user data
src/bisect.ts - Sanity workflow → Build files and cache: cleans user data
src/sanity.ts - CLI options → Runtime configuration: sets options
src/index.ts - Build files and cache → Runtime configuration: uses paths
src/files.ts - VS Code checkout → Build files and cache: checks checkout
src/git.ts