Add kill-dotnet command for interactive and non-interactive process termination

vp · vp · commit a708def2343f · 2025-10-27T00:48:51.000+01:00
diff --git a/.vscode/tasks-misc.ps1 b/.vscode/tasks-misc.ps1
@@ -12,6 +12,9 @@
 param(
   # Command routing (added wrapper around original script logic)
   [Parameter(Position=0)] [string] $Command = 'help',
+  # Optional process id for non-interactive kill-dotnet
+  [int] $ProcessId,
+  [switch] $ForceKill,
 
   # === Original CombineSources.ps1 parameters (kept defaults) ===
   [string]$OutputDirectory = './.tmp',
@@ -42,6 +45,43 @@ $ErrorActionPreference = 'Stop'
 function Write-Section([string] $Text){ Write-Host "`n=== $Text ===" -ForegroundColor Magenta }
 function Fail([string] $Msg, [int] $Code=1){ Write-Error $Msg; exit $Code }
 
+# Reused from diagnostics script (with minor fallback enhancements):
+${script:DotNetOnly} = $false
+function Select-Pid($title){
+  try {
+    Import-Module PwshSpectreConsole -ErrorAction Stop
+    $procs = Get-Process | Where-Object { $_.Id -gt 0 }
+    if($script:DotNetOnly){ $procs = $procs | Where-Object { $_.ProcessName -match 'dotnet|Presentation.Web.Server' } }
+    $procs = $procs | Sort-Object ProcessName,Id
+    $rows = @()
+    foreach($p in $procs){
+      $label = "$($p.ProcessName) (#$($p.Id))"
+      if($rows -notcontains $label){ $rows += $label }
+    }
+    if(-not $rows){ Write-Host 'No matching processes found.' -ForegroundColor Yellow; return $null }
+    $choices = $rows + 'Cancel'
+    $sel = Read-SpectreSelection -Title $title -Choices $choices -EnableSearch -PageSize 25
+    Write-Host "Raw selection: '$sel'" -ForegroundColor DarkGray
+    if([string]::IsNullOrWhiteSpace($sel) -or $sel -eq 'Cancel'){ return $null }
+    if($sel -match '\(#(\d+)\)$'){ Write-Host "Selected PID: $($Matches[1])" -ForegroundColor DarkGray; return [int]$Matches[1] }
+    Write-Host "Could not parse PID from selection: $sel" -ForegroundColor Yellow
+    return $null
+  } catch {
+    # Fallback to manual numeric selection if Spectre unavailable
+    Write-Host ('Spectre selection unavailable; falling back to manual input. Reason: {0}' -f $_.Exception.Message) -ForegroundColor Yellow
+    $procs = Get-Process | Where-Object { $_.Id -gt 0 }
+    if($script:DotNetOnly){ $procs = $procs | Where-Object { $_.ProcessName -match 'dotnet|Presentation.Web.Server' } }
+    $procs = $procs | Sort-Object ProcessName,Id
+    if(-not $procs){ Write-Host 'No matching processes found.' -ForegroundColor Yellow; return $null }
+    Write-Host 'Index | ProcessName | PID' -ForegroundColor Cyan
+    for($i=0;$i -lt $procs.Count;$i++){ Write-Host ("{0,5} | {1,-25} | {2}" -f $i,$procs[$i].ProcessName,$procs[$i].Id) -ForegroundColor DarkGray }
+    $raw = Read-Host 'Enter index to select (or blank to cancel)'
+    if([string]::IsNullOrWhiteSpace($raw)){ return $null }
+    if(-not ([int]::TryParse($raw,[ref]$idx)) -or $idx -lt 0 -or $idx -ge $procs.Count){ Write-Host 'Invalid index.' -ForegroundColor Red; return $null }
+    return $procs[$idx].Id
+  }
+}
+
 function Run-CSharpRepl() {
   Write-Section 'Starting C# REPL'
   Write-Host 'Restoring dotnet tools...' -ForegroundColor Cyan
@@ -246,6 +286,7 @@ Commands:
   digest|combine-sources|combine|docs   Generate consolidated markdown documentation per project (.g.md).
   clean|cleanup                        Remove build/output artifact directories (bin/obj/node_modules/etc.).
   repl|shell                           Run C# REPL (dotnet tool csharprepl) after tool restore.
+  kill-dotnet                          Interactive (or non-interactive with -ProcessId) termination of a dotnet process.
   help|?                               Show this help.
 
 combine-sources Parameters (defaults shown):
@@ -271,6 +312,8 @@ Examples:
   pwsh -File .vscode/tasks-misc.ps1 digest -OutputDirectory ./.tmp/docs -StripComments true -StripEmptyLines true
   pwsh -File .vscode/tasks-misc.ps1 clean
   pwsh -File .vscode/tasks-misc.ps1 repl
+  pwsh -File .vscode/tasks-misc.ps1 kill-dotnet               # interactive selection
+  pwsh -File .vscode/tasks-misc.ps1 kill-dotnet -ProcessId 1234 -ForceKill  # non-interactive
 
 Exit Codes:
   0 success, non-zero on failure.
@@ -326,10 +369,55 @@ function Handle-MiscCommand([string]$cmd){
     'cleanup' { Clean-Workspace; return }
     'repl' { Run-CSharpRepl; return }
     'shell' { Run-CSharpRepl; return }
+    'kill-dotnet' { Kill-DotNetProcess; return }
     'help' { Help; return }
     '?' { Help; return }
     default { Write-Host "Unknown misc command '$cmd'" -ForegroundColor Red; Help; exit 10 }
   }
 }
 
+function Kill-DotNetProcess() {
+  Write-Section 'Kill .NET Process'
+  # Non-interactive direct path if provided
+  # If ProcessId provided non-interactively, skip selection & confirmation when -ForceKill used.
+  $selectedPid = $null
+  if($ProcessId -gt 0){
+    Write-Host ("Non-interactive target PID specified: {0}" -f $ProcessId) -ForegroundColor Cyan
+    $selectedPid = $ProcessId
+  }
+  if(-not $selectedPid){
+    # Use shared Select-Pid logic scoped to dotnet processes
+    $script:DotNetOnly = $true
+    $selectedPid = Select-Pid 'Select .NET process to KILL'
+    if(-not $selectedPid){ Write-Host 'Kill operation cancelled or no process selected.' -ForegroundColor Yellow; $global:LASTEXITCODE=0; return }
+  }
+  $proc = Get-Process -Id $selectedPid -ErrorAction SilentlyContinue
+  if(-not $proc){ Write-Host ("Process with PID {0} no longer exists." -f $selectedPid) -ForegroundColor Yellow; $global:LASTEXITCODE=0; return }
+  Write-Host ("Target: {0} (PID {1})" -f $proc.ProcessName,$selectedPid) -ForegroundColor Cyan
+  if(-not $ForceKill){
+    if($ProcessId -gt 0){
+      $confirmRaw = Read-Host ("Type YES to confirm kill of PID {0} ({1}) or press Enter to cancel" -f $selectedPid,$proc.ProcessName)
+      if($confirmRaw -ne 'YES'){ Write-Host 'Kill aborted.' -ForegroundColor Yellow; $global:LASTEXITCODE=0; return }
+    }
+    elseif(-not $spectreUnavailable){
+      $confirm = Read-SpectreSelection -Title ("Confirm kill of PID {0} ({1})" -f $selectedPid,$proc.ProcessName) -Choices @('No','Yes') -PageSize 5
+      if($confirm -ne 'Yes'){ Write-Host 'Kill aborted.' -ForegroundColor Yellow; $global:LASTEXITCODE=0; return }
+    } else {
+      $confirmRaw2 = Read-Host ("Type YES to confirm kill of PID {0} ({1})" -f $selectedPid,$proc.ProcessName)
+      if($confirmRaw2 -ne 'YES'){ Write-Host 'Kill aborted.' -ForegroundColor Yellow; $global:LASTEXITCODE=0; return }
+    }
+  } else {
+    Write-Host 'ForceKill specified; skipping confirmation.' -ForegroundColor DarkYellow
+  }
+  try {
+  Stop-Process -Id $selectedPid -Force -ErrorAction Stop
+  Write-Host ("Process {0} terminated." -f $selectedPid) -ForegroundColor Green
+    $global:LASTEXITCODE=0
+  } catch {
+    $errMsg = $_.Exception.Message
+  Write-Host ("Failed to terminate PID {0}: {1}" -f $selectedPid, $errMsg) -ForegroundColor Red
+    $global:LASTEXITCODE=5
+  }
+}
+
 Handle-MiscCommand $Command
diff --git a/.vscode/tasks.json b/.vscode/tasks.json
@@ -240,6 +240,14 @@
       "presentation": {"echo": true,"reveal": "always","focus": true,"panel": "dedicated"},
       "problemMatcher": []
     },
+    {
+      "label": "Misc [kill dotnet process]",
+      "type": "shell",
+      "command": "pwsh",
+      "args": ["-NoProfile","-File","${workspaceFolder}/tasks.ps1","-Task","misc-kill-dotnet"],
+      "presentation": {"echo": true,"reveal": "always","focus": true,"panel": "shared"},
+      "problemMatcher": []
+    },
     {
       "label": "Security [vulnerable packages]",
       "type": "shell",
diff --git a/tasks.ps1 b/tasks.ps1
@@ -126,6 +126,7 @@ $tasks = [ordered]@{
   'misc-clean' = @{ Label='Misc Clean Workspace'; Script={ Invoke-Misc 'clean' } }
   'misc-digest' = @{ Label='Misc Digest Sources'; Script={ Invoke-Misc 'digest' } }
   'misc-repl' = @{ Label='Misc C# REPL'; Script={ Invoke-Misc 'repl' } }
+  'misc-kill-dotnet' = @{ Label='Misc Kill .NET Process'; Script={ Invoke-Misc 'kill-dotnet' } }
   'bench' = @{ Label='Diagnostics Benchmarks'; Script={ Invoke-Diagnostics 'bench' } }
   'bench-select' = @{ Label='Diagnostics Benchmarks (Project)'; Script={ Invoke-Diagnostics 'bench-select' } }
   'trace-flame' = @{ Label='Diagnostics Trace (Flame)'; Script={ Invoke-Diagnostics 'trace-flame' } }
@@ -148,7 +149,7 @@ $categories = [ordered]@{
   'Docker & Containers' = @('docker-build-run','docker-build-debug','docker-build-release','docker-run','docker-stop','docker-remove','compose-up','compose-up-pull','compose-down','compose-down-clean')
   'Security & Compliance' = @('vulnerabilities','vulnerabilities-deep','outdated','outdated-json','licenses')
   'API & Spec' = @('openapi-lint')
-  'Utilities'  = @('misc-clean','misc-digest','misc-repl')
+  'Utilities'  = @('misc-clean','misc-digest','misc-repl','misc-kill-dotnet')
   'Performance & Diagnostics' = @('bench','bench-select','trace-flame','trace-cpu','trace-gc','dump-heap','gc-stats','aspnet-metrics','diag-quick','speedscope-view')
 }
 
