vanspod 0.1.2 → 0.1.3

package/scripts/uninstall.ps1

@@ -1,133 +1,133 @@
-param([string]$Plan = (Join-Path $PSScriptRoot 'uninstall-plan.json'))
-$ErrorActionPreference = 'Stop'
-$utf8 = New-Object System.Text.UTF8Encoding($false)
-$planSource = [System.IO.File]::ReadAllText($Plan, $utf8)
-$toolSource = [System.IO.File]::ReadAllText($PSCommandPath, $utf8)
-$planData = $planSource | ConvertFrom-Json
-$localRoot = if ($env:LOCALAPPDATA) { $env:LOCALAPPDATA } else { $env:USERPROFILE }
-$expectedRoot = [System.IO.Path]::GetFullPath((Join-Path $localRoot 'VansPod'))
-$root = [System.IO.Path]::GetFullPath($planData.root)
-$dataRoot = [System.IO.Path]::GetFullPath($planData.dataRoot)
-if ($planData.version -ne 1 -or $root -ne $expectedRoot -or $dataRoot -ne [System.IO.Path]::GetFullPath((Join-Path $env:USERPROFILE '.vanspod')) -or [System.IO.Path]::GetFullPath($Plan) -ne (Join-Path $root 'uninstall-plan.json')) { throw 'Invalid removal plan' }
-[System.IO.File]::WriteAllText((Join-Path $root 'uninstall-ready'), (@{pid = $PID} | ConvertTo-Json -Compress), $utf8)
-
-function Assert-NoLinks([string]$Target, [bool]$InspectChildren = $true) {
-  # A regular leaf can still resolve through a junction in any ancestor.
-  $ancestor = [System.IO.Path]::GetFullPath($Target)
-  while ($ancestor) {
-    if ((Test-Path -LiteralPath $ancestor) -and ((Get-Item -LiteralPath $ancestor -Force).Attributes -band [System.IO.FileAttributes]::ReparsePoint)) { throw "拒絕移除連結：$ancestor" }
-    $ancestor = [System.IO.Path]::GetDirectoryName($ancestor)
-  }
-  if (Test-Path -LiteralPath $Target) {
-    $item = Get-Item -LiteralPath $Target -Force
-    if ($item.Attributes -band [System.IO.FileAttributes]::ReparsePoint) { throw "拒絕移除連結：$Target" }
-    if ($InspectChildren -and $item.PSIsContainer) { foreach ($child in Get-ChildItem -LiteralPath $Target -Force) { Assert-NoLinks $child.FullName } }
-  }
-}
-
-function Remove-Owned([string]$Name, [string]$Directory = $root) {
-  $target = [System.IO.Path]::GetFullPath((Join-Path $Directory $Name))
-  if (-not $target.StartsWith($Directory + [System.IO.Path]::DirectorySeparatorChar, [StringComparison]::OrdinalIgnoreCase)) { throw 'Removal target escaped VansPod data directory' }
-  Assert-NoLinks $target
-  if (Test-Path -LiteralPath $target) { Remove-Item -LiteralPath $target -Recurse -Force }
-}
-
-$failedTarget = $root
-try {
-  # Validate roots and ancestors now, but the worker still owns mutable runtime
-  # entries until it exits. Inspect their final tree only after that handoff.
-  Assert-NoLinks $root $false
-  Assert-NoLinks $dataRoot $false
-  foreach ($processId in @($planData.pid, $planData.waitForPid)) {
-    if ($processId) {
-      for ($attempt = 0; $attempt -lt 300 -and (Get-Process -Id $processId -ErrorAction SilentlyContinue); $attempt++) { Start-Sleep -Milliseconds 100 }
-      if (Get-Process -Id $processId -ErrorAction SilentlyContinue) { throw 'VansPod 尚未退出，請結束後重試。' }
-    }
-  }
-  Assert-NoLinks $root
-  Assert-NoLinks $dataRoot
-  $currentStateFile = Join-Path $root 'runtime/instance.json'
-  if (Test-Path -LiteralPath (Join-Path $root 'runtime')) {
-    if (-not (Test-Path -LiteralPath $currentStateFile)) { throw 'VansPod 正在啟動，請從畫面或 vanspod uninstall 重試完整移除。' }
-    $currentState = [System.IO.File]::ReadAllText($currentStateFile, $utf8) | ConvertFrom-Json
-    if ($currentState.id -ne $planData.instanceId) { throw 'VansPod 已有新的執行紀錄，請從畫面或 vanspod uninstall 重試完整移除，以先恢復客戶端設定。' }
-    if (Get-Process -Id $currentState.pid -ErrorAction SilentlyContinue) { throw 'VansPod 已重新啟動，請從畫面或 vanspod uninstall 重試完整移除。' }
-  }
-  foreach ($name in @('connection.json', 'settings.json', 'vscode-route-journal.json')) { $failedTarget = Join-Path $dataRoot $name; Remove-Owned $name $dataRoot }
-  $legacyRoot = [System.IO.Path]::GetFullPath((Join-Path $localRoot 'classroom-app'))
-  $failedTarget = Join-Path $legacyRoot 'connection.json'
-  if (Test-Path -LiteralPath $legacyRoot) {
-    if ((Get-Item -LiteralPath $legacyRoot -Force).Attributes -band [System.IO.FileAttributes]::ReparsePoint) { throw '拒絕清理舊憑證資料夾連結。' }
-    Remove-Owned 'connection.json' $legacyRoot
-    if (-not @(Get-ChildItem -LiteralPath $legacyRoot -Force).Count) { Remove-Item -LiteralPath $legacyRoot -Force }
-  }
-  if (Test-Path -LiteralPath $dataRoot) {
-    foreach ($file in Get-ChildItem -LiteralPath $dataRoot -File -Force) {
-      if ($file.Name -match '^(connection\.json|settings\.json|vscode-route-journal\.json)\..*tmp$') { $failedTarget = $file.FullName; Remove-Owned $file.Name $dataRoot }
-    }
-    if (-not @(Get-ChildItem -LiteralPath $dataRoot -Force).Count) { Remove-Item -LiteralPath $dataRoot -Force }
-  }
-  foreach ($name in @('runtime', 'desktop-assets', 'logs', 'installations.lock', 'installations.json.tmp', 'removal-result.json', 'startup-error.json')) {
-    $failedTarget = Join-Path $root $name
-    Remove-Owned $name
-  }
-  foreach ($installation in $planData.installations) {
-    if ($installation.kind -eq 'exe') {
-      $failedTarget = $installation.file
-      $target = [System.IO.Path]::GetFullPath($installation.file)
-      if ([System.IO.Path]::GetExtension($target) -ne '.exe' -or $installation.sha256 -notmatch '^[a-f0-9]{64}$') { throw 'Invalid executable registration' }
-      Assert-NoLinks $target
-      if (Test-Path -LiteralPath $target) {
-        $sha = [System.Security.Cryptography.SHA256]::Create()
-        try { $actualHash = [BitConverter]::ToString($sha.ComputeHash([System.IO.File]::ReadAllBytes($target))).Replace('-', '').ToLowerInvariant() }
-        finally { $sha.Dispose() }
-        if ($actualHash -ne $installation.sha256) { throw '檔案內容已改變，請重新開啟該 VansPod 後重試移除。' }
-        Remove-Item -LiteralPath $target -Force
-      }
-    } elseif ($installation.kind -eq 'npm') {
-      $failedTarget = $installation.root
-      $prefix = [System.IO.Path]::GetFullPath($installation.prefix)
-      $packageRoot = [System.IO.Path]::GetFullPath($installation.root)
-      if ($packageRoot -ne (Join-Path $prefix 'node_modules/vanspod')) { throw 'Invalid npm registration' }
-      Assert-NoLinks $packageRoot
-      if (Test-Path -LiteralPath $packageRoot) {
-        $package = [System.IO.File]::ReadAllText((Join-Path $packageRoot 'package.json'), $utf8) | ConvertFrom-Json
-        if ($package.name -ne 'vanspod' -or $package.bin.vanspod -ne 'bin/vanspod.cjs') { throw 'Registered package is not VansPod' }
-        & $installation.node $installation.npmCli uninstall --global --prefix $prefix vanspod --ignore-scripts 2>&1 | Out-Null
-        if ($LASTEXITCODE -ne 0 -or (Test-Path -LiteralPath $packageRoot)) { throw 'npm 移除失敗。' }
-      }
-    } else { throw 'Unknown installation kind' }
-  }
-  foreach ($name in @('installations.json', 'uninstall-plan.json', 'uninstall-ready')) { $failedTarget = Join-Path $root $name; Remove-Owned $name }
-  $failedTarget = $PSCommandPath
-  Remove-Owned 'uninstall-tool.ps1'
-  if (-not @(Get-ChildItem -LiteralPath $root -Force).Count) { Remove-Item -LiteralPath $root -Force }
-  if (-not $planData.headless) { Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('VansPod 已完整移除。學生專案與獨立工具已保留；未登記的其他 exe 副本請自行刪除。', 'VansPod') | Out-Null }
-} catch {
-  # A late cleanup error may have already removed a control file. Re-create
-  # the exact plan and tool so partial removal always remains retryable.
-  if (-not (Test-Path -LiteralPath $root)) { New-Item -ItemType Directory -Path $root | Out-Null }
-  Assert-NoLinks $root
-  [System.IO.File]::WriteAllText((Join-Path $root 'uninstall-plan.json'), $planSource, $utf8)
-  [System.IO.File]::WriteAllText((Join-Path $root 'uninstall-tool.ps1'), $toolSource, (New-Object System.Text.UTF8Encoding($true)))
-  $reason = $_.Exception.Message
-  $remaining = @($failedTarget)
-  foreach ($installation in $planData.installations) {
-    $location = if ($installation.kind -eq 'exe') { $installation.file } else { $installation.root }
-    if (Test-Path -LiteralPath $location) { $remaining += $location }
-  }
-  foreach ($name in @('runtime', 'desktop-assets', 'logs', 'installations.json', 'installations.lock', 'installations.json.tmp', 'uninstall-plan.json', 'uninstall-tool.ps1', 'uninstall-ready', 'startup-error.json', 'removal-result.json')) {
-    $location = Join-Path $root $name
-    if (Test-Path -LiteralPath $location) { $remaining += $location }
-  }
-  $legacyFile = Join-Path $localRoot 'classroom-app/connection.json'
-  if (Test-Path -LiteralPath $legacyFile) { $remaining += $legacyFile }
-  if (Test-Path -LiteralPath $dataRoot) {
-    foreach ($file in Get-ChildItem -LiteralPath $dataRoot -File -Force) { if ($file.Name -match '^(connection\.json|settings\.json|vscode-route-journal\.json)(\..*tmp)?$') { $remaining += $file.FullName } }
-  }
-  $remaining = @($remaining | Select-Object -Unique)
-  $message = "移除未完成：$reason`n剩餘項目：`n$($remaining -join "`n")`n請重試完整移除；若 VansPod 已重新啟動，請從畫面或 vanspod uninstall 重試。保留的 uninstall-tool.ps1 僅在服務已結束時可直接執行。"
-  [System.IO.File]::WriteAllText((Join-Path $root 'removal-result.json'), (@{ok = $false; message = $message; remaining = $remaining} | ConvertTo-Json), $utf8)
-  if (-not $planData.headless) { Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show($message, 'VansPod') | Out-Null }
-  exit 1
-}
+param([string]$Plan = (Join-Path $PSScriptRoot 'uninstall-plan.json'))
+$ErrorActionPreference = 'Stop'
+$utf8 = New-Object System.Text.UTF8Encoding($false)
+$planSource = [System.IO.File]::ReadAllText($Plan, $utf8)
+$toolSource = [System.IO.File]::ReadAllText($PSCommandPath, $utf8)
+$planData = $planSource | ConvertFrom-Json
+$localRoot = if ($env:LOCALAPPDATA) { $env:LOCALAPPDATA } else { $env:USERPROFILE }
+$expectedRoot = [System.IO.Path]::GetFullPath((Join-Path $localRoot 'VansPod'))
+$root = [System.IO.Path]::GetFullPath($planData.root)
+$dataRoot = [System.IO.Path]::GetFullPath($planData.dataRoot)
+if ($planData.version -ne 1 -or $root -ne $expectedRoot -or $dataRoot -ne [System.IO.Path]::GetFullPath((Join-Path $env:USERPROFILE '.vanspod')) -or [System.IO.Path]::GetFullPath($Plan) -ne (Join-Path $root 'uninstall-plan.json')) { throw 'Invalid removal plan' }
+[System.IO.File]::WriteAllText((Join-Path $root 'uninstall-ready'), (@{pid = $PID} | ConvertTo-Json -Compress), $utf8)
+
+function Assert-NoLinks([string]$Target, [bool]$InspectChildren = $true) {
+  # A regular leaf can still resolve through a junction in any ancestor.
+  $ancestor = [System.IO.Path]::GetFullPath($Target)
+  while ($ancestor) {
+    if ((Test-Path -LiteralPath $ancestor) -and ((Get-Item -LiteralPath $ancestor -Force).Attributes -band [System.IO.FileAttributes]::ReparsePoint)) { throw "拒絕移除連結：$ancestor" }
+    $ancestor = [System.IO.Path]::GetDirectoryName($ancestor)
+  }
+  if (Test-Path -LiteralPath $Target) {
+    $item = Get-Item -LiteralPath $Target -Force
+    if ($item.Attributes -band [System.IO.FileAttributes]::ReparsePoint) { throw "拒絕移除連結：$Target" }
+    if ($InspectChildren -and $item.PSIsContainer) { foreach ($child in Get-ChildItem -LiteralPath $Target -Force) { Assert-NoLinks $child.FullName } }
+  }
+}
+
+function Remove-Owned([string]$Name, [string]$Directory = $root) {
+  $target = [System.IO.Path]::GetFullPath((Join-Path $Directory $Name))
+  if (-not $target.StartsWith($Directory + [System.IO.Path]::DirectorySeparatorChar, [StringComparison]::OrdinalIgnoreCase)) { throw 'Removal target escaped VansPod data directory' }
+  Assert-NoLinks $target
+  if (Test-Path -LiteralPath $target) { Remove-Item -LiteralPath $target -Recurse -Force }
+}
+
+$failedTarget = $root
+try {
+  # Validate roots and ancestors now, but the worker still owns mutable runtime
+  # entries until it exits. Inspect their final tree only after that handoff.
+  Assert-NoLinks $root $false
+  Assert-NoLinks $dataRoot $false
+  foreach ($processId in @($planData.pid, $planData.waitForPid)) {
+    if ($processId) {
+      for ($attempt = 0; $attempt -lt 300 -and (Get-Process -Id $processId -ErrorAction SilentlyContinue); $attempt++) { Start-Sleep -Milliseconds 100 }
+      if (Get-Process -Id $processId -ErrorAction SilentlyContinue) { throw 'VansPod 尚未退出，請結束後重試。' }
+    }
+  }
+  Assert-NoLinks $root
+  Assert-NoLinks $dataRoot
+  $currentStateFile = Join-Path $root 'runtime/instance.json'
+  if (Test-Path -LiteralPath (Join-Path $root 'runtime')) {
+    if (-not (Test-Path -LiteralPath $currentStateFile)) { throw 'VansPod 正在啟動，請從畫面或 vanspod uninstall 重試完整移除。' }
+    $currentState = [System.IO.File]::ReadAllText($currentStateFile, $utf8) | ConvertFrom-Json
+    if ($currentState.id -ne $planData.instanceId) { throw 'VansPod 已有新的執行紀錄，請從畫面或 vanspod uninstall 重試完整移除，以先恢復客戶端設定。' }
+    if (Get-Process -Id $currentState.pid -ErrorAction SilentlyContinue) { throw 'VansPod 已重新啟動，請從畫面或 vanspod uninstall 重試完整移除。' }
+  }
+  foreach ($name in @('connection.json', 'settings.json', 'vscode-route-journal.json')) { $failedTarget = Join-Path $dataRoot $name; Remove-Owned $name $dataRoot }
+  $legacyRoot = [System.IO.Path]::GetFullPath((Join-Path $localRoot 'classroom-app'))
+  $failedTarget = Join-Path $legacyRoot 'connection.json'
+  if (Test-Path -LiteralPath $legacyRoot) {
+    if ((Get-Item -LiteralPath $legacyRoot -Force).Attributes -band [System.IO.FileAttributes]::ReparsePoint) { throw '拒絕清理舊憑證資料夾連結。' }
+    Remove-Owned 'connection.json' $legacyRoot
+    if (-not @(Get-ChildItem -LiteralPath $legacyRoot -Force).Count) { Remove-Item -LiteralPath $legacyRoot -Force }
+  }
+  if (Test-Path -LiteralPath $dataRoot) {
+    foreach ($file in Get-ChildItem -LiteralPath $dataRoot -File -Force) {
+      if ($file.Name -match '^(connection\.json|settings\.json|vscode-route-journal\.json)\..*tmp$') { $failedTarget = $file.FullName; Remove-Owned $file.Name $dataRoot }
+    }
+    if (-not @(Get-ChildItem -LiteralPath $dataRoot -Force).Count) { Remove-Item -LiteralPath $dataRoot -Force }
+  }
+  foreach ($name in @('runtime', 'desktop-assets', 'logs', 'installations.lock', 'installations.json.tmp', 'removal-result.json', 'startup-error.json')) {
+    $failedTarget = Join-Path $root $name
+    Remove-Owned $name
+  }
+  foreach ($installation in $planData.installations) {
+    if ($installation.kind -eq 'exe') {
+      $failedTarget = $installation.file
+      $target = [System.IO.Path]::GetFullPath($installation.file)
+      if ([System.IO.Path]::GetExtension($target) -ne '.exe' -or $installation.sha256 -notmatch '^[a-f0-9]{64}$') { throw 'Invalid executable registration' }
+      Assert-NoLinks $target
+      if (Test-Path -LiteralPath $target) {
+        $sha = [System.Security.Cryptography.SHA256]::Create()
+        try { $actualHash = [BitConverter]::ToString($sha.ComputeHash([System.IO.File]::ReadAllBytes($target))).Replace('-', '').ToLowerInvariant() }
+        finally { $sha.Dispose() }
+        if ($actualHash -ne $installation.sha256) { throw '檔案內容已改變，請重新開啟該 VansPod 後重試移除。' }
+        Remove-Item -LiteralPath $target -Force
+      }
+    } elseif ($installation.kind -eq 'npm') {
+      $failedTarget = $installation.root
+      $prefix = [System.IO.Path]::GetFullPath($installation.prefix)
+      $packageRoot = [System.IO.Path]::GetFullPath($installation.root)
+      if ($packageRoot -ne (Join-Path $prefix 'node_modules/vanspod')) { throw 'Invalid npm registration' }
+      Assert-NoLinks $packageRoot
+      if (Test-Path -LiteralPath $packageRoot) {
+        $package = [System.IO.File]::ReadAllText((Join-Path $packageRoot 'package.json'), $utf8) | ConvertFrom-Json
+        if ($package.name -ne 'vanspod' -or $package.bin.vanspod -ne 'bin/vanspod.cjs') { throw 'Registered package is not VansPod' }
+        & $installation.node $installation.npmCli uninstall --global --prefix $prefix vanspod --ignore-scripts 2>&1 | Out-Null
+        if ($LASTEXITCODE -ne 0 -or (Test-Path -LiteralPath $packageRoot)) { throw 'npm 移除失敗。' }
+      }
+    } else { throw 'Unknown installation kind' }
+  }
+  foreach ($name in @('installations.json', 'uninstall-plan.json', 'uninstall-ready')) { $failedTarget = Join-Path $root $name; Remove-Owned $name }
+  $failedTarget = $PSCommandPath
+  Remove-Owned 'uninstall-tool.ps1'
+  if (-not @(Get-ChildItem -LiteralPath $root -Force).Count) { Remove-Item -LiteralPath $root -Force }
+  if (-not $planData.headless) { Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('VansPod 已完整移除。學生專案與獨立工具已保留；未登記的其他 exe 副本請自行刪除。', 'VansPod') | Out-Null }
+} catch {
+  # A late cleanup error may have already removed a control file. Re-create
+  # the exact plan and tool so partial removal always remains retryable.
+  if (-not (Test-Path -LiteralPath $root)) { New-Item -ItemType Directory -Path $root | Out-Null }
+  Assert-NoLinks $root
+  [System.IO.File]::WriteAllText((Join-Path $root 'uninstall-plan.json'), $planSource, $utf8)
+  [System.IO.File]::WriteAllText((Join-Path $root 'uninstall-tool.ps1'), $toolSource, (New-Object System.Text.UTF8Encoding($true)))
+  $reason = $_.Exception.Message
+  $remaining = @($failedTarget)
+  foreach ($installation in $planData.installations) {
+    $location = if ($installation.kind -eq 'exe') { $installation.file } else { $installation.root }
+    if (Test-Path -LiteralPath $location) { $remaining += $location }
+  }
+  foreach ($name in @('runtime', 'desktop-assets', 'logs', 'installations.json', 'installations.lock', 'installations.json.tmp', 'uninstall-plan.json', 'uninstall-tool.ps1', 'uninstall-ready', 'startup-error.json', 'removal-result.json')) {
+    $location = Join-Path $root $name
+    if (Test-Path -LiteralPath $location) { $remaining += $location }
+  }
+  $legacyFile = Join-Path $localRoot 'classroom-app/connection.json'
+  if (Test-Path -LiteralPath $legacyFile) { $remaining += $legacyFile }
+  if (Test-Path -LiteralPath $dataRoot) {
+    foreach ($file in Get-ChildItem -LiteralPath $dataRoot -File -Force) { if ($file.Name -match '^(connection\.json|settings\.json|vscode-route-journal\.json)(\..*tmp)?$') { $remaining += $file.FullName } }
+  }
+  $remaining = @($remaining | Select-Object -Unique)
+  $message = "移除未完成：$reason`n剩餘項目：`n$($remaining -join "`n")`n請重試完整移除；若 VansPod 已重新啟動，請從畫面或 vanspod uninstall 重試。保留的 uninstall-tool.ps1 僅在服務已結束時可直接執行。"
+  [System.IO.File]::WriteAllText((Join-Path $root 'removal-result.json'), (@{ok = $false; message = $message; remaining = $remaining} | ConvertTo-Json), $utf8)
+  if (-not $planData.headless) { Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show($message, 'VansPod') | Out-Null }
+  exit 1
+}