Viper_VSCode/architecture/generated/subsystems/src.md

Subsystem: src

Source files under src/. Grouped by the functional area each file was assigned to during semantic lifting.

• Files: 18
• Symbols (leaves): 296

CLI and VS Code Extension

• src/nodeMain.ts — Entrypoint that starts the Pyright Node server and its background analysis runner
• src/nodeServer.ts — Starts and configures the Pyright language server in Node, initializing deps and handling main vs worker threads
• src/pyright.ts — Command-line entry point for the Pyright type checker, handling CLI args, diagnostics, and running analysis
• src/pyrightFileSystem.ts — FileSystem wrapper that remaps URIs and delegates mutable file operations to an underlying real filesystem
• src/server.ts — Implements the Pyright language server, handling workspace settings, background analysis, commands, and code actions
• src/workspaceFactory.ts — Manages creation, initialization, and lifecycle of language server workspaces for the Pyright analyzer
• src/langserver.ts — Starts the Pyright command-line entrypoint with zero worker threads
• src/pyright.ts — Starts the Pyright CLI
• src/cancellationUtils.ts — Provides a file-based cancellation strategy for the language server protocol
• src/extension.ts — Registers and manages the Pyright language server client and related VS Code commands and configuration
• src/server.ts — Starts the Pyright VS Code language server with one background worker

Import Resolution and Packaging

• src/partialStubService.ts — Maps partially typed stub packages into corresponding installed library directories and provides a no-op alternative

Language Service Providers

• src/languageServerBase.ts — Provides core language server functionality and LSP handlers for Pyright

Shared Runtime Infrastructure

• src/backgroundAnalysis.ts — Provides classes to spawn and coordinate Pyright background analysis workers and runners
• src/backgroundAnalysisBase.ts — Runs the analyzer in a background worker and manages program views, diagnostics, and result serialization
• src/backgroundThreadBase.ts — Provides background thread classes and helpers for message serialization, logging, and cancellation
• src/readonlyAugmentedFileSystem.ts — Provides a read-only augmented FileSystem that overlays mapped directories onto a backing FileSystem
• src/types.ts — Exports types describing language server client capabilities and initialization options

Cross-subsystem dependencies

Imported by (external):

• analyzer/backgroundAnalysisProgram.ts
• analyzer/service.ts
• commands/createTypeStub.ts
• commands/dumpFileDebugInfoCommand.ts
• common/envVarUtils.ts
• common/languageServerInterface.ts
• common/serviceKeys.ts
• common/serviceProviderExtensions.ts
• languageService/analyzerServiceExecutor.ts
• languageService/codeActionProvider.ts
• languageService/fileWatcherDynamicFeature.ts
• languageService/workspaceSymbolProvider.ts

Imports (external):

• analyzer/analysis.ts
• analyzer/backgroundAnalysisProgram.ts
• analyzer/cacheManager.ts
• analyzer/importResolver.ts
• analyzer/packageTypeReport.ts
• analyzer/packageTypeVerifier.ts
• analyzer/program.ts
• analyzer/pyTypedUtils.ts
• analyzer/pythonPathUtils.ts
• analyzer/service.ts
• analyzer/sourceFile.ts
• analyzer/sourceFileInfo.ts
• analyzer/typeStubWriter.ts
• commands/commandController.ts
• commands/commandResult.ts
• common/asyncInitialization.ts
• common/cancellationUtils.ts
• common/caseSensitivityDetector.ts
• common/chokidarFileWatcherProvider.ts
• common/collectionUtils.ts
• common/commandLineOptions.ts
• common/configOptions.ts
• common/console.ts
• common/core.ts
• common/debug.ts
• common/deferred.ts
• common/diagnostic.ts
• common/diagnosticRules.ts
• common/diagnosticSink.ts
• common/docRange.ts
• common/envVarUtils.ts
• common/extensibility.ts
• common/extensions.ts
• common/fileBasedCancellationUtils.ts
• common/fileSystem.ts
• common/fileWatcher.ts
• common/fullAccessHost.ts
• common/host.ts
• common/languageServerInterface.ts
• common/logTracker.ts
• common/lspUtils.ts
• common/pathConsts.ts
• common/pathUtils.ts
• common/progressReporter.ts
• common/pythonVersion.ts
• common/realFileSystem.ts
• common/serviceKeys.ts
• common/serviceProvider.ts
• common/serviceProviderExtensions.ts
• common/streamUtils.ts
• common/textRange.ts
• common/timing.ts
• uri/uri.ts
• uri/uriMap.ts
• uri/uriUtils.ts
• common/workspaceEditUtils.ts
• languageService/analyzerServiceExecutor.ts
• languageService/callHierarchyProvider.ts
• languageService/codeActionProvider.ts
• languageService/completionProvider.ts
• languageService/definitionProvider.ts
• languageService/documentHighlightProvider.ts
• languageService/documentSymbolCollector.ts
• languageService/documentSymbolProvider.ts
• languageService/dynamicFeature.ts
• languageService/fileWatcherDynamicFeature.ts
• languageService/hoverProvider.ts
• languageService/navigationUtils.ts
• languageService/pullDiagnosticsDynamicFeature.ts
• languageService/referencesProvider.ts
• languageService/renameProvider.ts
• languageService/signatureHelpProvider.ts
• languageService/workspaceSymbolProvider.ts
• localization/localize.ts
• parser/parser.ts