REQ 008

REQ-008: Test-ToolchainPresence.ps1 has no side effects

Requirement

Test-ToolchainPresence.ps1 shall have no side effects: it never installs, downloads, or modifies anything, only reports what is already present on PATH.

Rationale

Lets a downstream workflow safely smoke-test that this engine's scripts are consumable without any risk of mutating the runner.

Fit Criterion

Script contains no Install-*, Invoke-WebRequest, New-Item, or similar mutating calls; only Get-Command.

Verification

Code review of scripts/Test-ToolchainPresence.ps1's own docstring and body (it exists specifically to prove this), plus real CI dispatch: ci-assurance.yml's toolchain-smoke-test job now calls this engine's own toolchain-smoke-test.yml reusable workflow against itself on every push/PR (previously documented as never actually invoked anywhere in this repo).

Source

Software-Requirements-Specification

Priority

Medium

TestID

TEST-008

TestArtifact

Code review (script's own docstring) + real CI dispatch (ci-assurance.yml's toolchain-smoke-test job)

CodeRef

scripts/Test-ToolchainPresence.ps1, .github/workflows/toolchain-smoke-test.yml, .github/workflows/ci-assurance.yml

Status

Verified (live CI dispatch)