Serve Board

1# serve-board.ps1 — serve a generated focus board and print the URL.
2# Usage: pwsh scripts/serve-board.ps1 [-Dir <folder>] [-File focus-board.html] [-Port 8799]
3param(
4  [string]$Dir  = (Get-Location).Path,
5  [string]$File = "focus-board.html",
6  [int]   $Port = 8799
7)
8$full = Join-Path $Dir $File
9if (-not (Test-Path $full)) { Write-Error "Board not found: $full"; exit 1 }
10try {
11  if (Get-NetTCPConnection -State Listen -LocalPort $Port -ErrorAction SilentlyContinue) {
12    Write-Error "Port $Port is already in use — choose another with -Port or stop the existing server."; exit 1
13  }
14} catch { }  # Get-NetTCPConnection may be unavailable on some platforms; skip the pre-check there.
15$proc = Start-Process -FilePath "python" -ArgumentList @("-m","http.server","$Port","--bind","127.0.0.1","--directory","`"$Dir`"") -WindowStyle Hidden -PassThru
16Start-Sleep -Seconds 2
17if ($proc.HasExited) {
18  Write-Error "The server exited on startup (code $($proc.ExitCode)) — is Python installed and the port free?"; exit 1
19}
20$url = "http://localhost:$Port/$File"
21Write-Host "Focus board: $url"
22Write-Host "Server PID $($proc.Id) — stop it with: Stop-Process -Id $($proc.Id)"
23Start-Process $url   # opens in default browser; in a Copilot-app session, open a browser canvas to this URL instead