name: aibast-staging-ring-test version: 1.1.0 description: Test the AIBAST staging one-liner on this Windows device exactly as a user would, then report evidence. For GitHub Copilot on Windows. homepage: https://microsoft.github.io/aibast-agents-library/ metadata: {"category":"release-engineering","repo":"https://github.com/microsoft/aibast-agents-library","ring":"staging"}

AIBAST staging ring test (Windows)

You are testing the staging build of the AIBAST Agents Library Brainstem before it is promoted to production. The caller selects a maintainer's fork with AIBAST_STAGING_REPOSITORY=OWNER/REPOSITORY. Its Pages site serves the staging one-liner, which must install that fork's staging branch. Never assume a personal fork or use the Microsoft production one-liner for this test.

The deliverable is an evidence report, not an opinion. Every step below produces something to paste into the report. If a step fails, capture the exact error text and continue with the steps that do not depend on it.

Instructions for Copilot

Execute these steps autonomously in PowerShell. Pause only where marked ⏸.

1. Prerequisites

$PSVersionTable.PSVersion
git --version
python --version

Python 3.11 or newer and Git must be present. If Python is missing, the installer will try to help; note whatever it prints.

Confirm the caller's selected fork before installing anything:

$stagingRepository = $env:AIBAST_STAGING_REPOSITORY
if ($stagingRepository -notmatch '^[A-Za-z0-9][A-Za-z0-9-]*/[A-Za-z0-9_.-]+$') {
    throw 'Set AIBAST_STAGING_REPOSITORY to the maintainer fork as OWNER/REPOSITORY.'
}
$repoInfo = Invoke-RestMethod "https://api.github.com/repos/$stagingRepository"
if (-not $repoInfo.fork -or $repoInfo.source.full_name -ne 'microsoft/aibast-agents-library') {
    throw 'The selected repository is not a verified fork of the Microsoft library.'
}
$stagingRepository = $repoInfo.full_name
$stagingOwner, $stagingName = $stagingRepository -split '/', 2
$stagingSite = "https://$stagingOwner.github.io/$stagingName/"

2. Choose the profile (⏸ ask the user)

Default to an isolated profile so the user's existing Brainstem, if any, is untouched:

$env:USERPROFILE = Join-Path $env:TEMP 'aibast-ring-test'
New-Item -ItemType Directory -Force -Path $env:USERPROFILE | Out-Null

Ask the user only if they want the real install over their current profile instead. The real install repoints %USERPROFILE%\.brainstem\src to the staging branch and keeps their soul, agents, and token.

3. Fetch the staging installer and confirm its identity

$installer = Invoke-WebRequest -Uri "${stagingSite}install.ps1" -UseBasicParsing
$content = $installer.Content
$content | Select-String -Pattern '^\$REPO_URL|^\$REPO_REF|^\$REMOTE_VERSION_URL'

Expected: the defaults name https://github.com/$stagingRepository.git and staging. If they name the production repository or main, stop and report: the staging Pages are serving the wrong identity.

4. Install without launching

& ([scriptblock]::Create($content)) --no-launch *>&1 | Tee-Object -FilePath (Join-Path $env:USERPROFILE 'install.log')

Record the total time and the final lines of install.log.

5. Verify what was installed

$src = Join-Path $env:USERPROFILE '.brainstem\src'
git -C $src remote get-url origin
git -C $src rev-parse --abbrev-ref HEAD
git -C $src rev-parse HEAD
Get-Content (Join-Path $src 'rapp_brainstem\VERSION')
Test-Path (Join-Path $env:USERPROFILE '.brainstem\venv\Scripts\python.exe')
Test-Path (Join-Path $env:USERPROFILE '.local\bin\brainstem.cmd')

Expected: origin is the selected $stagingRepository, branch staging, all Test-Path lines True. Compare the commit to the current staging head:

(Invoke-RestMethod "https://api.github.com/repos/$stagingRepository/commits/staging").sha

6. Start the server on a spare port

$runtime = Join-Path $src 'rapp_brainstem'
$env:PORT = '7091'
$server = Start-Process -FilePath (Join-Path $env:USERPROFILE '.brainstem\venv\Scripts\python.exe') -ArgumentList 'brainstem.py' -WorkingDirectory $runtime -PassThru -RedirectStandardOutput (Join-Path $env:USERPROFILE 'server.log') -RedirectStandardError (Join-Path $env:USERPROFILE 'server.err')
Start-Sleep -Seconds 8
Invoke-RestMethod 'http://127.0.0.1:7091/health/public'
Invoke-RestMethod 'http://127.0.0.1:7091/health' | ConvertTo-Json -Depth 3

Expected: /health/public returns status: ok and a version matching the installed VERSION file; /health lists loaded agents.

7. Sign in if needed, then chat

If /health shows no auth, open http://localhost:7091/login in a browser and complete the GitHub device-code sign-in (⏸ the user must do this), or set $env:GITHUB_TOKEN from gh auth token before starting the server.

$body = @{ user_input = 'In one sentence, confirm you are running and name one tool you have available. Answer in under 40 words.'; conversation_history = @() } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri 'http://127.0.0.1:7091/chat' -ContentType 'application/json' -Body $body | Select-Object response, model

Expected: a one-sentence answer in the response field.

8. Stop the server and clean up

Stop-Process -Id $server.Id -Force

Leave the test profile in place for inspection. Never delete USERPROFILE. Removing the specific temporary test directory requires separate user approval; the real user profile must remain untouched.

9. Report

Produce this table, then the raw error text for anything that failed:

⏸ Ask the user before filing. If anything failed, file it at https://github.com/$stagingRepository/issues/new with the table above. Use only labels and milestones that actually exist on that fork. Do not file on the Microsoft repository; staging issues stay on the selected fork.