Files
skillshare/scripts/windows/utm.sh
Willie 4defc80322 docs(ai-context): split e2e runbooks out of the testing topic
The testing topic was 8 bytes under its 16 KB cap, so any edit would
fail the router check. Move the E2E runbook, quality checklist and
Windows verification sections verbatim into a new e2e-runbooks topic
instead of raising the cap.

Also upgrade scripts/ai-context.py to 0.2.0, which adds link checking,
skipDirs and glob-based unrouted exceptions; the existing docs pass.
2026-10-29 21:12:09 +08:00

124 lines
6.6 KiB
Bash
Executable File

#!/usr/bin/env bash
# Drive a local UTM Windows guest for skillshare verification. Host-side only: it never runs the
# product on macOS. Builds happen in the devcontainer; the guest runs them. See the
# skillshare-windows-utm skill and wiki/e2e-runbooks.md "Windows Verification".
#
# utm.sh probe VM state, guest agent, logged-in user, arch, Developer Mode
# utm.sh build <ref> [arm64|amd64] pinned git archive -> $OUT/ss.exe, ss-ui-dist.zip, ss-version.txt
# utm.sh push-manual push the build + manual-setup.ps1 to C:\Users\Public (hands-on test)
# utm.sh push <local> <guest-path> push one file (the guest folder must exist)
# utm.sh pull <guest-path> print a guest file (exits 0 even when it is missing)
# utm.sh ps <file.ps1> [timeout-s] run a script as SYSTEM and print its output
# utm.sh task <name> <guest.ps1> [--basic] [-- script args]
# run a guest script as the desktop user (scheduled task)
# utm.sh clean unregister sstest-* tasks, remove C:\Users\Public\sstest
#
# Env: VM (default Windows), GUEST_USER (default Willie), OUT (default ${TMPDIR:-/tmp}/skillshare-utm).
set -euo pipefail
VM=${VM:-Windows}
GUEST_USER=${GUEST_USER:-Willie}
OUT=${OUT:-${TMPDIR:-/tmp}/skillshare-utm}
# The Homebrew symlink fails with "Application not found"; call the app bundle directly.
U=${UTMCTL:-$HOME/Applications/UTM.app/Contents/MacOS/utmctl}
[ -x "$U" ] || U=/Applications/UTM.app/Contents/MacOS/utmctl
ROOT=$(cd "$(dirname "$0")/../.." && pwd)
die() { echo "utm.sh: $*" >&2; exit 1; }
container() {
local c
c=$(docker compose -f "$ROOT/.devcontainer/docker-compose.yml" ps -q skillshare-devcontainer 2>/dev/null)
[ -n "$c" ] || die "devcontainer is not running; run make devc-up"
echo "$c"
}
# Run a PowerShell script on the guest as SYSTEM. utmctl exec is asynchronous and returns no
# output, so the script writes to a file ending in a marker and the host polls it.
run_ps() {
local file=$1 timeout=${2:-120} id=$RANDOM$RANDOM tmp
tmp=$(mktemp)
{
echo "\$ErrorActionPreference='Continue'"
echo "& {"; cat "$file"; echo "} *>&1 | Out-File -Encoding utf8 C:\\Windows\\Temp\\utm-$id.txt"
echo "'UTMDONE' | Out-File -Encoding utf8 -Append C:\\Windows\\Temp\\utm-$id.txt"
} > "$tmp"
"$U" file push "$VM" "C:\\Windows\\Temp\\utm-$id.ps1" < "$tmp"
rm -f "$tmp"
"$U" exec "$VM" --cmd powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\\Windows\\Temp\\utm-$id.ps1" >/dev/null 2>&1 || true
local o
for _ in $(seq 1 "$timeout"); do
o=$("$U" file pull "$VM" "C:\\Windows\\Temp\\utm-$id.txt" 2>&1 || true)
if grep -q UTMDONE <<<"$o"; then sed '$d' <<<"$o" | tr -d '\r'; return 0; fi
sleep 1
done
die "timed out waiting for $file"
}
# Inline PowerShell through run_ps; a heredoc keeps backslashes intact (zsh echo eats them).
ps_inline() { local f; f=$(mktemp); cat > "$f"; run_ps "$f" "${1:-120}"; rm -f "$f"; }
cmd=${1:-}; shift || true
case "$cmd" in
probe)
"$U" status "$VM" || die "VM $VM not found (grant Automation permission if utmctl reports OSStatus -1712)"
# -2700 or "guest agent" errors mean the guest is still booting or the agent is not up yet.
echo x | "$U" file push "$VM" 'C:\Windows\Temp\utm-probe.txt' || die "guest agent not reachable yet; wait for boot"
ps_inline 60 <<'EOF'
# The native architecture: under x64 emulation on ARM64, env and .NET both report x64.
"arch=" + (Get-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment').PROCESSOR_ARCHITECTURE
"desktopUser=" + (((Get-CimInstance Win32_Process -Filter "Name='explorer.exe'") | % { (Invoke-CimMethod -InputObject $_ -MethodName GetOwner).User }) -join ',')
"devMode=" + (Get-ItemProperty HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock -ErrorAction SilentlyContinue).AllowDevelopmentWithoutDevLicense
"edition=" + (Get-CimInstance Win32_OperatingSystem).Caption
EOF
;;
build)
ref=${1:?ref}; arch=${2:-arm64}
sha=$(git -C "$ROOT" rev-parse --short "$ref")
c=$(container); mkdir -p "$OUT"
# A pinned archive, so edits in the working tree never leak into the build.
docker exec "$c" bash -lc "set -e; credential-helper off >/dev/null 2>&1 || true
rm -rf /tmp/utm-build && mkdir -p /tmp/utm-build/src /tmp/utm-build/out
git -C /workspace archive $sha | tar -x -C /tmp/utm-build/src
cd /tmp/utm-build/src && GOOS=windows GOARCH=$arch go build -ldflags '-X main.version=head-$sha' -o /tmp/utm-build/out/ss.exe ./cmd/skillshare
# pnpm rejects a symlinked node_modules; install offline from the store the workspace UI uses.
store=\$(dirname \$(cd /workspace/ui && pnpm store path))
cd ui && pnpm install --frozen-lockfile --offline --store-dir \$store >/dev/null && pnpm run build >/dev/null
cd dist && python3 -c 'import shutil; shutil.make_archive(\"/tmp/utm-build/out/ss-ui-dist\", \"zip\", \".\")'
printf head-$sha > /tmp/utm-build/out/ss-version.txt"
for f in ss.exe ss-ui-dist.zip ss-version.txt; do docker cp "$c:/tmp/utm-build/out/$f" "$OUT/$f"; done
echo "built head-$sha ($arch) in $OUT"
;;
push-manual)
for f in ss.exe ss-ui-dist.zip ss-version.txt; do
[ -f "$OUT/$f" ] || die "missing $OUT/$f; run utm.sh build first"
"$U" file push "$VM" "C:\\Users\\Public\\$f" < "$OUT/$f"
done
"$U" file push "$VM" 'C:\Users\Public\ss-setup.ps1' < "$ROOT/scripts/windows/manual-setup.ps1"
echo 'In a normal (non-admin) PowerShell on the guest:'
echo ' powershell -ExecutionPolicy Bypass -File C:\Users\Public\ss-setup.ps1'
;;
push) "$U" file push "$VM" "${2:?guest-path}" < "${1:?local}" ;;
pull) "$U" file pull "$VM" "${1:?guest-path}" | tr -d '\r' ;;
ps) run_ps "${1:?file.ps1}" "${2:-120}" ;;
task)
name=${1:?name}; script=${2:?guest.ps1}; shift 2
basic=""; if [ "${1:-}" = --basic ]; then basic=" -Basic"; shift; fi
[ "${1:-}" = -- ] && shift
"$U" file push "$VM" 'C:\Users\Public\launch-task.ps1' < "$ROOT/scripts/windows/launch-task.ps1"
ps_inline 60 <<EOF
& C:\\Users\\Public\\launch-task.ps1 -Name '$name' -User '$GUEST_USER' -Script '$script' -ScriptArgs '$*'$basic
EOF
;;
clean)
ps_inline 120 <<'EOF'
Get-ScheduledTask -TaskName sstest-* -ErrorAction SilentlyContinue | Unregister-ScheduledTask -Confirm:$false
# rmdir does not follow junctions, so test junctions are removed without touching their targets.
if (Test-Path C:\Users\Public\sstest) { cmd /c 'rmdir /s /q C:\Users\Public\sstest' }
Remove-Item C:\Users\Public\launch-task.ps1, C:\Windows\Temp\utm-* -Force -ErrorAction SilentlyContinue
"cleaned"
EOF
;;
*) sed -n '2,17p' "$0"; exit 2 ;;
esac