Provision external Source GUI/runtime evidence workstation

[dayflaree]

Goal

Provision a local external-tool evidence workstation that can run real Source GUI tools and game runtimes for the final certification issues.

This unblocks:

• Certify Hammer/Hammer++ open-save compatibility #141 Hammer/Hammer++ open-save compatibility;
• Complete successful real game-runtime map-load validation #145 real game-runtime map-load validation;
• Certify rendered HLMV/HLMV++ model preview #146 rendered HLMV/HLMV++ model preview.

Current system finding

The current Ubuntu system has Steam content, Half-Life 2, Source SDK Base 2013 Singleplayer/Multiplayer, and Proton installed. It does not currently expose Hammer/Hammer++, HLMV/HLMV++, Wine, or a graphical DISPLAY in the shell used by automation.

Tasks

• Decide supported test mode: real desktop session, Wine, Proton, Windows VM, or separate Windows workstation.
• Ensure a real graphical session exists for screenshot/window evidence.
• Install or configure Wine/Proton runner if using Windows GUI tools from this Ubuntu system.
• Download Hammer++ from the official Hammer++ download page outside the repository.
• Install or locate HLMV/HLMV++ outside the repository.
• Record exact tool versions/builds.
• Record sanitized tool paths.
• Confirm the tools can start and close without Source Weaver involvement.
• Confirm the tools can access a legal game/tool content directory.
• Create /tmp/sourceweaver-completion-workstation/ with sanitized evidence logs and SHA-256 hash manifests.

Acceptance criteria

• A real GUI session is documented.
• hammer/Hammer++ executable path and version/build are documented.
• HLMV/HLMV++ executable path and version/build are documented.
• Runtime game executable/script path and version/app context are documented.
• Test runner mode is documented: native Windows, Wine, Proton, or Linux runtime.
• A dry-run launch smoke test proves each selected external tool starts.
• No external binaries, proprietary assets, game content, private paths, screenshots with sensitive material, or Steam data are committed.

External references

• Hammer++ official download page: https://ficool2.github.io/HammerPlusPlus-Website/download.html
• HLMV++ README: https://raw.githubusercontent.com/ayaz345/HLMVPlusPlus/master/README.md

[dayflaree]

Current provisioning blocker verified on 2026-08-08.

I am leaving this issue open because the acceptance criteria require a real GUI session, real Hammer/Hammer++ and HLMV/HLMV++ executable paths/versions, and dry-run launch smoke tests. Those are not available from the current automation shell.

Probe evidence

Evidence directory:

/tmp/sourceweaver-completion-workstation/

Artifacts:

bacb27ad7546e30c3d93c2b98dc58d9be4e168e907f689fc9535776883f4c1f7  /tmp/sourceweaver-completion-workstation/probe.txt

Observed state:

DISPLAY: absent
WAYLAND_DISPLAY: absent
wine: not found
wine64: not found
steam: not found on PATH
steamcmd: not found
hammer / hammer.exe / hammerplusplus.exe: not found
hlmv / hlmv.exe / hlmvplusplus.exe: not found
vbsp / vvis / vrad: not found on PATH
osslsigncode: not found

Apt candidates visible without installing:

wine: 10.0~repack-12ubuntu1
wine64: 10.0~repack-12ubuntu1
winetricks: 20250102-1build1
steamcmd:i386: 0~20180105-5build1

Sanitized Steam-related paths found:

${HOME}/.local/share/applications/Source SDK Base 2013 Singleplayer.desktop
${HOME}/.local/share/applications/Source SDK Base 2013 Multiplayer.desktop
${HOME}/.cache/GModPatchTool/patches/linux/x86-64/garrysmod
${HOME}/.cache/tf2deathmatch_workshop/steamhome/Steam/steamapps
${HOME}/.cache/tf2deathmatch_workshop/install/steamapps
${HOME}/Steam/steamapps

Current external reference check

• Hammer++ official download page reports current build 8871, last updated April 14, 2026, and says HLMV++ is bundled with Hammer++ downloads. The page links the Garry's Mod build as hammerplusplus_gmod_build8871.zip and the Source SDK 2013 SP build as hammerplusplus_2013sp_build8871.zip.
• HLMV++ README says supported games include Team Fortress 2, Left 4 Dead 2, and Garry's Mod, and installation requires extracting the EXE/DLL files into steamapps/common/<game>/bin where hlmv.exe is stored.

References:

• https://ficool2.github.io/HammerPlusPlus-Website/download.html
• https://raw.githubusercontent.com/ayaz345/HLMVPlusPlus/master/README.md

What blocks completion

• No real GUI session is exposed to the automation shell, so screenshot/window evidence cannot be produced.
• No Wine/Proton GUI runner is configured on PATH for Windows GUI tools.
• Hammer/Hammer++ and HLMV/HLMV++ binaries are not present in discovered user paths.
• Installing Wine, steamcmd, or external GUI tooling would be a new software installation and needs explicit user approval.
• Downloading and unpacking Hammer++/HLMV++ outside the repository also needs an explicit provisioning decision: real desktop session, Wine, Proton, Windows VM, or separate Windows workstation.

Next action needed

Pick the supported test mode and authorize the required provisioning steps. The likely Ubuntu path is:

sudo dpkg --add-architecture i386
sudo apt update
sudo apt install wine wine64 wine32 winetricks steamcmd unzip

Then download Hammer++ build 8871 outside the repository, install HLMV++ from the selected package or upstream release, expose a real GUI session to automation, and record sanitized executable paths, versions, launch logs, and SHA-256 hashes under /tmp/sourceweaver-completion-workstation/.

[dayflaree]

Repo-side progress completed for this ticket without claiming external certification.

Commit:

• f05bb374b7a8bbf075ad43c78a0390bbf7cd6c3e — adds scripts/probe-completion-prerequisites.sh and documents the prerequisite probe workspace in docs/completion-certification-fixtures.md.

What changed:

• Added a repeatable prerequisite probe for Provision external Source GUI/runtime evidence workstation #156/Provision native Windows Source compiler certification host #157/Provision production signing credentials and repository secrets #158.
• The probe writes sanitized evidence under /tmp/sourceweaver-completion-prerequisites/.
• For Provision external Source GUI/runtime evidence workstation #156 it records display/session state, GUI runner/tool presence, candidate Hammer/Hammer++/HLMV/HLMV++/runtime paths with ${HOME} redaction, and hash manifests.
• SOURCEWEAVER_COMPLETION_PREREQS_REQUIRE_READY=1 turns the probe into a readiness gate that exits nonzero while prerequisites remain missing.

Validation:

• Local gate passed:
  • bash -n scripts/probe-completion-prerequisites.sh
  • SOURCEWEAVER_COMPLETION_PREREQS_OVERWRITE=1 scripts/probe-completion-prerequisites.sh /tmp/sourceweaver-completion-prerequisites-gate
  • JSON parse of prerequisite-summary.json
  • expected failure for SOURCEWEAVER_COMPLETION_PREREQS_REQUIRE_READY=1
  • cargo fmt --check
  • cargo clippy --workspace --all-targets -- -D warnings
  • cargo test --workspace
  • cargo build --workspace
  • git diff --check
  • scripts/validate-final-release-policy.sh
  • validation claim guard self-test and repo scan
  • scripts/validate-public-vmfs.sh /tmp/sourceweaver-public-validation-prereq-probe
  • cargo audit
  • scripts/cargo-audit-final-release.sh
• CI passed for f05bb374b7a8bbf075ad43c78a0390bbf7cd6c3e: https://github.com/dayflaree/sourceweaver/actions/runs/31328155007

Current #156 probe result on this host:

{
  "ready": false,
  "checks": {
    "display_or_wayland_present": false,
    "gui_runner_present_on_path": false,
    "hammer_or_hammerplusplus_present_on_path": false,
    "hlmv_or_hlmvplusplus_present_on_path": false,
    "runtime_or_steam_tool_present_on_path": false
  }
}

Evidence bundle:

/tmp/sourceweaver-completion-prerequisites-final

Relevant hashes:

3db7e7973eeb2f4ec91f17505b15e50d262a90d8a6bad98eadc771dfe19b5bb5  ./issue156-gui-runtime-workstation/probe.txt
0818b924085571c5e5d779a7b9cec1b9cc520657180ad620931b94aa66073232  ./prerequisite-summary.json
1970c3120a0b2397ec5441ea0365b31f143ba92ea8818e995db2eddda40bb791  ./require-ready-output.txt

Boundary:

• This does not close Provision external Source GUI/runtime evidence workstation #156.
• No GUI tool was launched.
• No Hammer/Hammer++, HLMV/HLMV++, runtime map load, screenshot, external binary, game content, or private asset evidence was created or committed.
• The issue remains blocked until a real GUI/runtime workstation is provisioned and the external tool launch criteria are satisfied.