Merge branch 'main' into obliged-tarantula

Author: eleanorjboyd

.github/instructions/testing-workflow.instructions.md

@@ -574,3 +574,6 @@ envConfig.inspect
 -   Untestable Node.js APIs → Create proxy abstraction functions (use function overloads to preserve intelligent typing while making functions mockable)
 
 ## 🧠 Agent Learnings
+-   Avoid testing exact error messages or log output - assert only that errors are thrown or rejection occurs to prevent brittle tests (1)
+-   Create shared mock helpers (e.g., `createMockLogOutputChannel()`) instead of duplicating mock setup across multiple test files (1)
+

.github/workflows/pr-check.yml

@@ -8,7 +8,7 @@ on:
       - release*
 
 env:
-  NODE_VERSION: '20.18.1'
+  NODE_VERSION: '22.21.1'
 
 jobs:
   build-vsix:

.github/workflows/push-check.yml

@@ -9,7 +9,7 @@ on:
       - 'release-*'
 
 env:
-  NODE_VERSION: '20.18.1'
+  NODE_VERSION: '22.21.1'
 
 jobs:
   build-vsix:

.nvmrc

@@ -1 +1 @@
-20.18.1
+22.21.1

CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to Python Environments Extension
+
+Thank you for your interest in contributing to the Python Environments extension! This guide will help you get started.
+
+## Prerequisites
+
+- Node.js (LTS version recommended)
+- npm
+- VS Code Insiders (recommended for development)
+- Git
+- Python
+
+## Getting Started
+
+1. **Clone the repository**
+   ```bash
+   cd vscode-python-environments
+   ```
+
+2. **Create a Python virtual environment** 
+
+3. **Install dependencies**
+   ```bash
+   npm install
+   ```
+
+4. **Build and watch**
+   ```bash
+   npm run watch
+   ```
+
+5. **Run tests**
+   ```bash
+   npm run unittest
+   ```
+
+## Development Workflow
+
+### Running the Extension
+
+1. Open the project in VS Code
+2. Press `F5` to launch the Extension Development Host
+3. The extension will be loaded in the new VS Code window
+
+### Making Changes
+
+- **Localization**: Use VS Code's `l10n` API for all user-facing messages
+- **Logging**: Use `traceLog` or `traceVerbose` instead of `console.log`
+- **Error Handling**: Track error state to avoid duplicate notifications
+- **Documentation**: Add clear docstrings to public functions
+
+### Testing
+Run unit tests with the different configurations in the "Run and Debug" panel
+
+## Contributor License Agreement (CLA)
+
+This project requires contributors to sign a Contributor License Agreement (CLA). When you submit a pull request, a CLA bot will automatically check if you need to provide a CLA and guide you through the process. You only need to do this once across all Microsoft repositories.
+
+## Code of Conduct
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information, see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions.
+
+## Questions or Issues?
+
+- **Questions**: Start a [discussion](https://github.com/microsoft/vscode-python/discussions/categories/q-a)
+- **Bugs**: File an [issue](https://github.com/microsoft/vscode-python-environments/issues)
+- **Feature Requests**: Start a [discussion](https://github.com/microsoft/vscode-python/discussions/categories/ideas)
+
+## Additional Resources
+
+- [Development Process](https://github.com/Microsoft/vscode-python/blob/main/CONTRIBUTING.md#development-process)
+- [API Documentation](./src/api.ts)
+- [Project Documentation](./docs/projects-api-reference.md)
+
+Thank you for contributing! 🎉

build/azure-pipeline.pre-release.yml

@@ -66,7 +66,7 @@ extends:
     buildSteps:
       - task: NodeTool@0
         inputs:
-          versionSpec: '20.18.1'
+          versionSpec: '22.21.1'
         displayName: Select Node version
 
       - task: UsePythonVersion@0

build/azure-pipeline.stable.yml

@@ -56,12 +56,12 @@ extends:
     buildSteps:
       - task: NodeTool@0
         inputs:
-          versionSpec: '20.18.1'
+          versionSpec: '22.21.1'
         displayName: Select Node version
 
       - task: UsePythonVersion@0
         inputs:
-          versionSpec: '3.8'
+          versionSpec: '3.9'
           addToPath: true
           architecture: 'x64'
         displayName: Select Python version
@@ -112,7 +112,7 @@ extends:
           project: 'Monaco'
           definition: 593
           buildVersionToDownload: 'latestFromBranch'
-          branchName: 'refs/heads/release/2025.10'
+          branchName: 'refs/heads/release/2025.16'
           targetPath: '$(Build.SourcesDirectory)/python-env-tools/bin'
           artifactName: 'bin-$(buildTarget)'
           itemPattern: |

examples/README.md

@@ -1,6 +1,6 @@
 ## Requirements
 
-1. `node` >= 20.18.1
+1. `node` >= 22.21.1
 2. `npm` >= 10.9.0
 3. `yo` >= 5.0.0 (installed via `npm install -g yo`)
 4. `generator-code` >= 1.11.4 (installed via `npm install -g generator-code`)

package-lock.json

@@ -2,7 +2,7 @@
     "name": "vscode-python-envs",
     "displayName": "Python Environments",
     "description": "Provides a unified python environment experience",
-    "version": "1.13.0",
+    "version": "1.15.0",
     "publisher": "ms-python",
     "preview": true,
     "engines": {
@@ -652,7 +652,7 @@
         "@types/fs-extra": "^11.0.4",
         "@types/glob": "^8.1.0",
         "@types/mocha": "^10.0.1",
-        "@types/node": "20.2.5",
+        "@types/node": "^22.15.1",
         "@types/sinon": "^17.0.3",
         "@types/stack-trace": "0.0.29",
         "@types/vscode": "^1.99.0",