32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
# Real server coverage parity probe
|
|
|
|
Run with PowerShell7 on Windows against a built/staged server. The script launches
|
|
its own hidden server on a free loopback port, creates synthetic data under a fresh
|
|
timestamped `.local/rest-coverage-*` directory, captures 25 requests/responses and
|
|
asserts diagnostic parity, invalid-write rejection, source preservation and restart.
|
|
It stops only its own process, including on failure. It never attaches to an
|
|
existing server and does not use user credentials. The token it creates is fixed
|
|
synthetic probe data, not suitable for a deployed server.
|
|
|
|
From the repository root, replace the executable path with the artifact under test:
|
|
|
|
```powershell
|
|
$env:PATH = "$env:SystemRoot\System32;$env:SystemRoot;$env:SystemRoot\System32\Wbem"
|
|
& harness/fixtures/rest-coverage/run-coverage-probe.ps1 -ServerExe 'C:\path\to\staged\arcadia-server.exe'
|
|
```
|
|
|
|
For gnullvm builds, stage the required runtime DLL beside the executable. Clean
|
|
PATH is deliberate: success should not depend on a developer compiler directory.
|
|
The first launch and restart use the same isolated store; restart is a forced
|
|
process stop after an acknowledged saved revision. This tests local persistence,
|
|
not graceful-drain handling. Output directories and evidence are retained.
|
|
|
|
`coverage-probe.json` has incomplete, repaired and invalid source bundles with
|
|
explicit synthetic UUIDs and current source-version7 headers, plus five exact expected warning tuples. Legacy version5 headers are upgraded on admission and therefore cannot serve as an unchanged-byte current-source oracle. The repair
|
|
deliberately leaves an independent `sequence_gap` warning. The final reintroduction
|
|
of the incomplete bundle is an explicit replacement, not service Undo. No new API
|
|
or production code is required by the probe.
|
|
|
|
Observed Windows execution and limitations are recorded in
|
|
`harness/release-rest-coverage-verification-20260906.md`. The PowerShell7 wrapper now omits Windows-only launch options on other platforms; [the portability review](../../release-rest-probe-portability-ytr83r-20260911.md) scopes that source change. Linux execution remains separately unverified and user-paused.
|