Apply @andyleejordan Review Suggestions

Author: JustinGrote

docs/development.md

@@ -59,9 +59,9 @@ Explore the `vscode-powershell.build.ps1` file for other build targets.
 First, ensure you have completed a build as instructed above, as the launch templates do not check some prerequisites for performance reasons.
 
 To debug the extension use one of the provided `Launch Extension` debug configurations.
-1. `Launch Extension`: Launches the debugger using your personal profile settings
-1. `Temp Profile`: Launches VSCode with an ephemeral temp profile that resets on every launch. Useful for "out of the box" environment testing.
-1. `Isolated Profile`: Launches the debugger with a persistent debug profile specific to the extension, so you can preserve some settings or test certain prerequisites.
+1. `Launch Extension`: Launches the debugger using your personal profile settings.
+2. `Temp Profile`: Launches VS Code with a temp profile that resets on every launch. Useful for "out of the box" environment testing.
+3. `Isolated Profile`: Launches the debugger with a persistent debug profile specific to the extension, so you can preserve some settings or test certain prerequisites.
 
 All three templates use pre-launch tasks to build the code, and support automatic restart of the extension host on changes to the Extension source code. [Hot Reload](https://devblogs.microsoft.com/dotnet/introducing-net-hot-reload/) is also enabled for PowerShell Editor Services.
 

package.json

@@ -302,12 +302,12 @@
         "icon": "$(layout-panel-right)"
       },
       {
-        "title": "[PowerShell Debug Input Task] Wait for and return PSES startup process ID",
+        "title": "[PowerShell Debug Input Task] Wait for and return PSES startup PID",
         "command": "PowerShell.WaitForPsesActivationAndReturnProcessId",
         "enablement": "false"
       },
       {
-        "title": "[PowerShell Debug Input Task] Get the VSCode Session ID for writing the PID file",
+        "title": "[PowerShell Debug Input Task] Get the VS Code Session ID for writing the PID file",
         "command": "GetVsCodeSessionId",
         "enablement": "false"
       }

pwsh-extension-dev.code-workspace

@@ -15,7 +15,6 @@
       "davidanson.vscode-markdownlint",
       "dbaeumer.vscode-eslint",
       "editorconfig.editorconfig",
-      "ms-azure-devops.azure-pipelines",
       "ms-dotnettools.csharp",
       "ms-vscode.powershell",
       "hbenl.vscode-mocha-test-adapter",
@@ -31,7 +30,6 @@
     "files.insertFinalNewline": true,
     "files.associations": {
       "**/snippets/*.json": "jsonc", // Use JSONC instead of JSON because that's how VS Code interprets snippet files, and it enables better source documentation.
-      "**/.vsts-ci/**/*.yml": "azure-pipelines",
     },
     // Ignore the Markdown rule:
     "markdownlint.config": {
@@ -307,20 +305,6 @@
           "group": "Test",
           "order": 3
         }
-      },
-      {
-        "name": "Interactively Test Rename",
-        "configurations": [
-          "Launch Extension - Rename Test Cases",
-          "Attach to Editor Services"
-        ],
-        "preLaunchTask": "Build",
-        "stopAll": true,
-        "presentation": {
-          "hidden": false,
-          "group": "Test",
-          "order": 4
-        }
       }
     ],
     "configurations": [
@@ -379,7 +363,7 @@
           "<node_internals>/**",
           "**/node_modules/**",
           "**/.vscode-test/**",
-          "**/app/out/vs/**" //Skips Extension Host internals
+          "**/app/out/vs/**", // Skips Extension Host internals
         ],
         "presentation": {
           "hidden": true
@@ -422,7 +406,6 @@
         "name": "Attach to Editor Services",
         "type": "coreclr",
         "request": "attach",
-        // Waits for the extension terminal to become available and gets the PID, saves having to enter it manually.
         "processId": "${command:PowerShell.PickPSHostProcess}",
         "justMyCode": true,
         "suppressJITOptimizations": true,
@@ -483,10 +466,11 @@
         "skipFiles": [
           "<node_internals>/**",
           "**/node_modules/**",
-          "**/.vscode-test/**"
+          "**/.vscode-test/**" // Skips Extension Host internals
         ],
         "presentation": {
-          "hidden": true,        }
+          "hidden": true,
+        }
       },
     ]
   }

src/extension.ts

@@ -158,7 +158,7 @@ export async function activate(context: vscode.ExtensionContext): Promise<IPower
             "GetVsCodeSessionId",
             () => vscode.env.sessionId
         ),
-        // Register a command that waits for the Externsion Terminal to be active. Can be used by .NET Attach Tasks
+        // Register a command that waits for the Extension Terminal to be active. Can be used by .NET Attach Tasks.
         registerWaitForPsesActivationCommand(context)
     ];
 
@@ -193,7 +193,7 @@ export async function activate(context: vscode.ExtensionContext): Promise<IPower
 }
 
 /** Registers a command that waits for PSES Activation and returns the PID, used to auto-attach the PSES debugger */
-function registerWaitForPsesActivationCommand(context: vscode.ExtensionContext) {
+function registerWaitForPsesActivationCommand(context: vscode.ExtensionContext): vscode.Disposable {
     return vscode.commands.registerCommand(
         "PowerShell.WaitForPsesActivationAndReturnProcessId",
         async () => {
@@ -208,11 +208,15 @@ function registerWaitForPsesActivationCommand(context: vscode.ExtensionContext)
                     const pid = parseInt(pidContent.toString(), 10);
                     try {
                         // Check if the process is still alive, delete the PID file if not and continue waiting.
-                        process.kill(pid, 0);
+                        // https://nodejs.org/api/process.html#process_process_kill_pid_signal
+                        // "As a special case, a signal of 0 can be used to test for the existence of a process. "
+                        const NODE_TEST_PROCESS_EXISTENCE = 0
+                        process.kill(pid, NODE_TEST_PROCESS_EXISTENCE);
                     } catch {
                         await fs.delete(pidFile);
                         continue;
                     }
+                    // VSCode command returns for launch configurations *must* be string type explicitly, will error on number or otherwise.
                     return pidContent.toString();
                 } catch {
                     // File doesn't exist yet, wait and try again
@@ -223,7 +227,7 @@ function registerWaitForPsesActivationCommand(context: vscode.ExtensionContext)
     );
 }
 
-/** Restarts the extension host when extension file changes are detected. Useful for development.. */
+/** Restarts the extension host when extension file changes are detected. Useful for development. */
 function restartOnExtensionFileChanges(context: vscode.ExtensionContext): void {
     const watcher = vscode.workspace.createFileSystemWatcher(
         new vscode.RelativePattern(context.extensionPath, "dist/*.js")