Skip to content

Document installer startup failure handling and recovery - #38

Merged
JamieW105 merged 1 commit into
mainfrom
fix/installer-toolchain-startup
Oct 14, 2026
Merged

JamieW105 merged 1 commit into
mainfrom
fix/installer-toolchain-startup

Conversation

@JamieW105

@JamieW105 JamieW105 commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

Setup now batches selected optional toolchains in one PowerShell process and stops retrying a host that returns error 142 or 0xc0000142. Document the single failure notice, automatic Setup log, original-user toolchain transcript, and recovery through Language Toolchain Manager.

Validation: lint with zero warnings, production build (434 pages), TypeScript check, dependency audit (zero vulnerabilities), and exported links/fragments check passed.

Companion engine PR: Rustic-Game-Engine/engine#32

@JamieW105 JamieW105 added area:website Documentation website type:docs Documentation changes labels Oct 13, 2026
JamieW105 added a commit to Rustic-Game-Engine/engine that referenced this pull request Oct 14, 2026
With all optional languages selected, Setup can launch PowerShell up to
15 times for repeated checks and per-language installs. Run all
selections in one hidden, noninteractive process as the original user.
Stop the batch if WinGet returns 142 or 0xc0000142, skip installed
tools, and keep ordinary package failures aggregated.

Record host launch errors and exit codes in an automatic Setup log,
resolve the toolchain transcript in the original user's profile, and
write a clear package-and-code line for each failed install. Show one
optional-toolchain failure while leaving Rustic installed. Validate Inno
syntax and Windows PowerShell regression cases before the expensive
engine build.

Validation: fresh Windows installer build passed, producing
`RusticGameEngine-Setup-0.1.0-x64-20261013-212947.exe`. All 12 Windows
PowerShell regression scenarios and four silent packaged Setup scenarios
passed, including all selected languages sharing one host, stopping on
initialization failure, keeping the engine installed, and bundled-only
Setup skipping the manager. The engine CI jobs on Windows and Linux,
language adapter conformance, workflow syntax, secret scan, and Rust
dependency audit passed. Local manager smoke checks and all nine
installer-release tests also passed.

Tested installer artifact:
https://github.com/Rustic-Game-Engine/engine/actions/runs/38469014259/artifacts/11850569802

Build and test logs:
https://github.com/Rustic-Game-Engine/engine/actions/runs/38469014259

The original reported error was not reproducible; this change removes
repeated host launches and improves diagnosis without claiming a
confirmed root cause.

Companion documentation PR:
Rustic-Game-Engine/docs#38 (lint, production
build, TypeScript, dependency audit, and exported links passed).
@JamieW105
JamieW105 merged commit f3fe7c6 into main Oct 14, 2026
1 check passed
@JamieW105
JamieW105 deleted the fix/installer-toolchain-startup branch October 14, 2026 00:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:website Documentation website type:docs Documentation changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants