VX Bridge 0.3.0

VX Bridge 0.3.0

VX Bridge forwards shot data from ProTee Labs to Infinite Tees or GSPro OpenAPI
on the same Windows PC. This release adds local diagnostic reports and a
clearer way to report bugs or request features.

Changes since v0.2.0

• Save one diagnostic ZIP. Choose Save diagnostic report... from the
  bridge menu. The ZIP contains a readable summary, a source manifest, typed
  status/settings/installation observations and sanitized bridge events.
  Reporter, running-host and installed-receipt versions are kept separate.
• Report without a working host. Open VX Bridge Diagnostics from Start
  when the bridge will not start, its icon is missing or admission is refused.
  It uses the same exporter without starting or repairing the host or calling
  Windows Installer. Missing, corrupt or unavailable sources produce an
  explicitly partial report.
• Use the reporting forms. Report a bug opens the
  bug form.
  The separate
  feature form
  asks about the task, workaround and desired outcome, not a demanded implementation.
  A diagnostic ZIP and redacted screenshots are optional.
• Identify the actual build. Logs and reports now carry the release
  version separately from the retained prototype/protocol label, together
  with source revision, toolchain and architecture.
• Keep collection bounded and local. Collection has fixed source limits,
  an eight-second wait budget, a one-second status query and a 2 MiB ZIP cap.
  Existing logs are not cleared or rotated. Export creates a new local file
  and does not silently overwrite an existing one.

The distinct control client also provides
vxbridge.exe --diagnostics <new-absolute-local-file.zip> and
--diagnostics-dialog for support. See the
reporting guide
and command reference.

Shot forwarding, remembered game selection and source-first Quit are unchanged.
There is no new service, updater or runtime. The installed application still
has six payload files, and the release still has only the installer EXE and
its checksum.

Install

Use Windows x64, an activated ProTee VX with ProTee Labs already working, and
a licensed Infinite Tees or GSPro installation on the same PC. For GSPro, use
its public OpenAPI / APIv1 Connect application, not the native VX receiver.
VX Bridge supplies neither a game nor a license.

1. Download
   vx-bridge-installer-windows-amd64-v0.3.0.exe
   under Assets. The .exe.sha256 file is an optional checksum, not a
   second installer. Source code downloads are for developers.
2. In ProTee Labs, select Game Options > Disconnect. Close an existing
   receiver through its own controls. Do not run two receivers or replace the
   vendor's GSPconnect.exe. Read Existing installations below before
   changing an installed or portable copy.
3. Open the EXE as the Windows user who will use the bridge, not as
   administrator. Choose Install for a fresh installation. The EXE contains
   the matching native Setup, MSI and support files; no ZIP extraction or
   adjacent MSI is needed.
4. Leave Auto-launch on Windows Startup off unless the bridge should open
   when you sign in. It is off on a fresh install.
5. Wait for verified Setup success. Choose Start bridge to open it once,
   or Not now to open VX Bridge from Start later. Starting it once does
   not enable sign-in launch.

If Windows blocks Setup, stop and
report the warning.
Do not disable security protections or bypass the warning.

First use

1. Open the game and enter a playable practice scene. For GSPro, also open
   OpenAPI / APIv1 Connect.
2. Open VX Bridge from Start. Find its icon near the clock, including the
   hidden-icons area. Right-click it and select Use Infinite Tees or
   Use GSPro OpenAPI. The checkmark shows the applied choice.
3. Use Labs' normal Connect action if needed. The bridge does not start Labs
   or the game, or connect Labs for you.
4. Check the bridge menu and the game. Connected (transport only) is not
   proof that the game is ready. Wait for each shot's visible result before
   the next swing.

Finish with Game Options > Disconnect in ProTee Labs, then Quit in
VX Bridge. Do not force the bridge closed while Labs is attached. Missed shots
are not saved or replayed; if delivery is uncertain, check the game first.

Report a problem

Choose Save diagnostic report..., or open VX Bridge Diagnostics from
Start if the host is unavailable. Choose a new filename in a writable local
folder. Cancel saves nothing. A saved or partial report is local:
nothing was sent.

Open the ZIP and review summary.txt, manifest.json, report.json and
events.jsonl. Then choose Report a bug and attach it only if you wish.
Include steps, expected and observed behavior, approximate time/time zone,
selected game and versions you know. Labs/game versions are not scanned;
write unknown if needed.

If export fails, submit the form without a ZIP and describe the save error.
Do not attach raw vendor/MSI logs, captures, shot/player/device/license/account
details, credentials or unredacted screenshots. See
report contents and privacy.

Existing installations

This release does not establish a supported in-place upgrade from v0.2.0,
v0.1.0 or a portable/pilot build. Setup retains exact native-core/source and
ownership checks; arbitrary cross-source versions are not adopted.
Disconnect Labs and Quit normally before changing an existing installation.
Keep the old copy's files and startup registration intact until you have
reviewed migration instructions.

For damage to this installed build, use VX Bridge Setup > Repair / Reinstall.
If its saved source is missing, use the original verified installer for that
build. Normal Uninstall uses Windows Settings > Apps > Installed apps >
VX Bridge > Uninstall. Full Uninstall removes bridge-owned settings and logs,
not vendor data, independently saved reports or original downloads.

A failed operation need not restore the previous version. Do not replace
files, purge Windows Installer records or delete settings to bypass a refusal.
See the
installation and recovery guide.

Contributors

Thanks to David Justice (@devigned) for
#4: bug reporting, feature forms and privacy-safe diagnostic ZIPs,
the merged change since v0.2.0. No new human first-time contributors were
identified in this range; @devigned contributed to earlier releases.

Copilot App is credited as an automated co-author, not an additional human
contributor. Dependency and reference attributions remain in
THIRD_PARTY_NOTICES.txt
and the embedded installer notices.

Verification and limits

The exact tagged source passed routine CI: portable and Windows tests, race
tests, vet, workflow lint and static installer/package checks. The release
workflow built and verified the matching application and installer from this
tag, then published only its own run's EXE and checksum. Both public files
were independently downloaded and checked against the original immutable
build artifact, GitHub asset digests and the EXE checksum. Static inspection
verified the embedded Setup/MSI, application archive and source/version.

These are source and file-integrity checks, not interactive qualification.
The installer and product were not run for this release. Native
save/cancel/accessibility/DPI behavior, Windows extraction and servicing,
sign-in and live Labs/game behavior remain unqualified for these binaries.
Earlier observations used different builds and do not qualify v0.3.0.
Reports are best-effort observations, not proof of game readiness, complete
shot history or installation health.

The installer and application are not Authenticode-signed. Signed Git
source and tags do not sign Windows binaries. Checksums bind file contents;
they do not authenticate a publisher.

Files and source

The only uploaded assets are
the Windows x64 installer EXE
and its SHA-256 checksum.
GitHub also provides automatic source ZIP/tar.gz archives.

Source: d83d8c7e01ecb0cbb59ff33b39a23d0c77dbb7f8.
Signed annotated tag object: 182982c3664e1e4dc1fabbb373007f7c44394ddd.
The tag uses @devigned's existing signing key,
F1E46E1FE0B2BEF85D4CDE8F2B44C6BF9F416319, verified locally and by GitHub.
GitHub also verifies the source merge commit's signature.

Release build and publication.
Exact-main CI.
Changes since v0.2.0.